mirror of https://github.com/30hours/blah2.git synced 2024-11-18 12:33:58 +00:00

A real-time passive radar

hackrf passive passive-radar pcl radar real-time rtl-sdr sdr sdrplay usrp

Find a file

sdn-ninja 94ec3fbe78 Update README.md		2024-09-17 19:48:29 +01: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 Rsp config notes and fix max gain reduction	2024-09-11 15:28:49 +00:00
doc/html	Add doxygen comments	2023-05-20 13:10:55 +09:30
docker	Add Dockerfile for Kraken	2024-08-31 07:40:23 +00:00
host	Add host information for reverse proxy	2024-02-11 11:49:46 +00:00
html	Change to viridis colormap	2024-05-15 14:54:44 +00:00
lib	Remove old SDRplay lib	2024-09-09 14:59:36 +00:00
script	Add RSPduo reset script to readme	2024-04-02 10:42:32 +00:00
src	Clearer setting of IF bandwidth and type	2024-09-16 10:22:32 +00:00
test	Amend code style in Ambiguity and refactor ambiguity tests	2024-05-04 02:41:33 +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	CMake add Werror Wall and tidy	2024-09-11 14:03:27 +00:00
CMakePresets.json	Compiles and removed unnecessary deps in Dockerfile	2024-01-02 02:52:58 +00:00
docker-compose.yml	Add tty true to aid in debugging	2024-09-11 14:04:50 +00:00
Dockerfile	Update SDRplay API and Dockerfile UHD dep	2024-09-09 14:57:28 +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	Update README.md	2024-09-17 19:48:29 +01:00

README.md

blah2

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

Features

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.

SDR Support

SDRplay RSPDuo.
USRP (only tested on the B210).
2x HackRF with clock synchronisation and hardware trigger.
2x RTL-SDR with clock synchronisation.
KrakenSDR with 2x channels only.

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.15.2/SDRplay_RSP_API-Linux-3.15.2.run
sudo ./lib/sdrplay-3.15.2/SDRplay_RSP_API-Linux-3.15.2.run --tar -xvf -C ./lib/sdrplay-3.15.2
cd lib/sdrplay-3.15.2/ && sudo ./install_lib.sh && cd ../../
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

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

Future Work

Add a tracker in delay-Doppler space.
Support for the HackRF/RTL-SDR using a front-end mixer, to sample 2 RF channels in 1 stream.
Support for the Kraken SDR with all 5 channels.
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

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