A real-time passive radar
Find a file
2023-11-10 16:55:18 +10:30
api Fix caching issue on API 2023-10-27 16:23:42 +10:30
config Add units in km to display 2023-11-10 16:55:18 +10:30
doc/html Add doxygen comments 2023-05-20 13:10:55 +09:30
html Add units in km to display 2023-11-10 16:55:18 +10:30
lib Fixed SDRplay API on Docker (run service on host) 2023-10-25 23:48:03 +10:30
script Add timestamp checking on automatic restart script 2023-10-28 07:40:36 +10:30
src Add units in km to display 2023-11-10 16:55:18 +10:30
.gitignore Add doxygen comments 2023-05-20 13:10:55 +09:30
changelog.md Add doxygen comments 2023-05-20 13:10:55 +09:30
CMakeLists.txt Initial commit 2023-05-04 20:55:37 +09:30
docker-compose.yml Fix docker compose and add restart script 2023-10-27 10:25:12 +10:30
Dockerfile Fixed SDRplay API on Docker (run service on host) 2023-10-25 23:48:03 +10:30
Doxyfile Add doxygen comments 2023-05-20 13:10:55 +09:30
example.png Initial commit 2023-05-04 20:55:37 +09:30
LICENSE Initial commit 2023-05-04 20:53:41 +09:30
README.md Add live instance link 2023-11-05 22:28:13 +10:30

blah2

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

blah2 example display

Features

  • Currently only support for the SDRplay RSPDuo.
  • 2 channel processing for a reference and surveillance signal.
  • Designed as a passive radar, but can also work as an 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

  • 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.yml for desired processing parameters.
  • Run the docker-compose command.
sudo git clone http://github.com/30hours/blah2 /opt/blah2
cd /opt/blah2
vim config/config.yml
./lib/sdrplay-3.0.7/SDRplay_RSP_API-Linux-3.07.1.run --tar -xvf
./lib/sdrplay-3.0.7/install.sh
sudo docker network create blah2
sudo systemctl enable docker
sudo docker compose up -d

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

Documentation

Future Work

  • A CFAR detector has not yet been implemented.
  • Support for the HackRF and RTL-SDR using front-end mixer to sample 2 RF channels in 1 stream.
  • Occasional segmentation fault from a mutex issue.

FAQ

  • If the SDRplay RSPduo does not capture data, restart the API service (on the host) using sudo systemctl restart sdrplay.api.

Contributing

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

License

MIT