github-mirrors/blah2
1
0
Fork 0
mirror of https://github.com/30hours/blah2.git synced 2024-11-18 12:33:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
A real-time passive radar
127 commits 4 branches 0 tags 14 MiB
Shell 71.9%
C++ 21.1%
JavaScript 4%
HTML 1.7%
Dockerfile 0.7%
Other 0.6%
Find a file
30hours 0ef2649827 Add RSPduo reset script to readme
2024-04-02 10:42:32 +00:00
.devcontainer Devcontainer slow prog 2024-02-15 11:01:11 +00:00
api Fix SIGTERM handling and tidy RspDuo 2024-03-23 15:59:16 +00:00
config Add adsb2dd config url for offline 2024-02-18 01:48:50 +00:00
doc/html Add doxygen comments 2023-05-20 13:10:55 +09:30
host Add host information for reverse proxy 2024-02-11 11:49:46 +00:00
html Fix localhost check, cleanup front end and favicon 2024-02-18 12:26:17 +00:00
lib Update SDRplay API to 3.14.0 #6 2024-02-04 08:40:15 +00:00
script Add RSPduo reset script to readme 2024-04-02 10:42:32 +00:00
src RspDuo tidy and fix debug verbose call 2024-03-29 06:34:40 +00:00
test Add constants namespace for speed of light, etc 2024-01-20 12:43:31 +00:00
.dockerignore CfarDetector1D is mostly working at /api/detection 2023-11-21 13:41:35 +00:00
.gitignore Added devcontainer and removed dependence on vendored third-party libraries 2023-12-26 08:18:14 +00:00
CMakeLists.txt Update SDRplay API to 3.14.0 #6 2024-02-04 08:40:15 +00:00
CMakePresets.json Compiles and removed unnecessary deps in Dockerfile 2024-01-02 02:52:58 +00:00
docker-compose.yml Fix SIGTERM handling and tidy RspDuo 2024-03-23 15:59:16 +00:00
Dockerfile Update Jenkins with env and Dockerfile labels 2024-02-16 02:34:52 +00:00
Doxyfile Add doxygen comments 2023-05-20 13:10:55 +09:30
example.png Initial commit 2023-05-04 20:55:37 +09:30
Jenkinsfile Only release a package for blah2, not blah2_api as well 2024-02-19 12:18:19 +00:00
LICENSE Initial commit 2023-05-04 20:53:41 +09:30
README.md Add RSPduo reset script to readme 2024-04-02 10:42:32 +00:00

README.md

blah2

A real-time radar which can support various SDR platforms. See a live instance at http://radar4.30hours.dev.

blah2 example display

Features

  • Support for the SDRplay RSPDuo and USRP (only tested on the B210).
  • 2 channel processing for a reference and surveillance signal.
  • Designed to be used with external RF source (for passive radar or active radar).
  • Outputs delay-Doppler maps to a web front-end.
  • Record raw IQ data by pressing spacebar on the web front-end.
  • Saves delay-Doppler maps in a JSON array.

Services

The build environment consists of a docker-compose.yml file running the following services;

  • The radar processor responsible for IQ capture and processing.
  • The API middleware responsible for reading TCP ports for delay-Doppler map data, and exposing this on a REST API.
  • The web front-end displaying processed radar data.

Usage

Building the code using the following instructions;

  • Install docker and docker-compose on the host machine.
  • Clone this repository to some directory.
  • Install SDRplay API to run service on host.
  • Edit the config/config.yml for desired processing parameters.
  • Run the docker-compose command.
sudo git clone http://github.com/30hours/blah2 /opt/blah2
cd /opt/blah2
sudo chown -R $USER .
sudo chmod a+x ./lib/sdrplay-3.14.0/SDRplay_RSP_API-Linux-3.14.0.run
sudo ./lib/sdrplay-3.14.0/SDRplay_RSP_API-Linux-3.14.0.run --tar -xvf -C ./lib/sdrplay-3.14.0
cd lib/sdrplay-3.14.0/ && sudo ./install_lib.sh
sudo docker network create blah2
sudo systemctl enable docker
sudo docker compose up -d --build

Alternatively avoid building and use the pre-built Docker packages;

sudo docker pull ghcr.io/30hours/blah2:latest
vim docker-compose.yml
--- build: .
+++ image: ghcr.io/30hours/blah2:latest
sudo docker compose up -d

The radar processing output is available on http://localhost:49152.

Documentation

Future Work

  • Add a tracker in delay-Doppler space.
  • Support for the HackRF and RTL-SDR using a front-end mixer to sample 2 RF channels in 1 stream.
  • Support for the Kraken SDR.
  • Support for using 2 HackRF boards with clock synchronisation.
  • Add SoapySDR support for the C++ API to include a wide range of SDR platforms.

FAQ

  • If the SDRplay RSPduo does not capture data, restart the API service (on the host) using the script sudo ./script/blah2_rspduo_restart.bash.

Contributing

Join the Discord chat for sharing results and support.

Pull requests are welcome - especially for adding support for a new SDR.

  • Currently have an issue where the USRP B210 is timing out after 5-10 mins and crashes the code. Convinced it's an issue with my usage of the API - contact me for more info.

License

MIT