blah2

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

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
./lib/sdrplay-3.14.0/SDRplay_RSP_API-Linux-3.14.0.run --tar -xvf -C ./lib/sdrplay-3.14.0
./lib/sdrplay-3.14.0/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;

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

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

Documentation

See doxygen pages hosted at http://doc.30hours.dev/blah2.

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 sudo systemctl restart sdrplay.api.

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.
A bug exists for Docker versions >= 25.0.0 using the RspDuo due to a shared memory issue, please downgrade for the time being.

License

MIT

3.1 KiB Raw Blame History