blah2

A real-time radar which can support various SDR platforms.

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 dependencies from Dockerfile.
Edit the config.yml for desired processing parameters.
Run the docker-compose command.

git clone http://github.com/30hours/blah2
cd blah2
vim config/config.yml
sudo mkdir /opt/blah2
sudo chmod a+rw /opt/blah2

sudo docker-compose up -d blah2_frontend blah2_api
mkdir build && cd build
cmake .. && make && cd ..
./bin/blah2 -c config/config.yml

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

Future Work

The blah2 service can be built in Docker, except for the SDRplay API due to its dependence on systemd. This service needs to be built manually with cmake at present.
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 using sudo systemctl restart sdrplay.api.

Contributing

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

License

MIT

2.1 KiB Raw Blame History