blah2/README.md

71 lines
2.7 KiB
Markdown
Raw Normal View History

2023-05-04 11:25:37 +00:00
# blah2
2023-11-05 11:58:13 +00:00
A real-time radar which can support various SDR platforms. See a live instance at [http://radar4.30hours.dev](http://radar4.30hours.dev).
2023-05-04 11:25:37 +00:00
![blah2 example display](./example.png "blah2")
## Features
2024-01-18 13:25:32 +00:00
- Support for the [SDRplay RSPDuo](https://www.sdrplay.com/rspduo/) and [USRP](https://www.ettus.com/products/) (only tested on B210).
2023-05-04 11:25:37 +00:00
- 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.
2023-05-04 11:25:37 +00:00
- Edit the config.yml for desired processing parameters.
- Run the docker-compose command.
```bash
sudo git clone http://github.com/30hours/blah2 /opt/blah2
cd /opt/blah2
2023-05-04 11:25:37 +00:00
vim config/config.yml
./lib/sdrplay-3.12.1/SDRplay_RSP_API-Linux-3.12.1.run --tar -xvf -C ./lib/sdrplay-3.12.1
./lib/sdrplay-3.12.1/install_lib.sh
sudo docker network create blah2
sudo systemctl enable docker
sudo docker compose up -d
2023-05-04 11:25:37 +00:00
```
The radar processing output is available on [http://localhost:49152](http://localhost:49152).
2023-05-20 04:56:36 +00:00
## Documentation
- See `doxygen` pages hosted at [http://doc.30hours.dev/blah2](http://doc.30hours.dev/blah2).
2023-05-04 11:25:37 +00:00
## Future Work
2023-11-29 09:46:11 +00:00
- Add a tracker in delay-Doppler space.
- Add ADS-B overlay on the delay-Doppler map.
- Support for the HackRF and RTL-SDR using a front-end mixer to sample 2 RF channels in 1 stream.
2024-01-18 13:25:32 +00:00
- Support for using 2 HackRF boards with clock synchronisation.
- Add automated Docker image builds on GHCR.
2024-01-20 13:45:15 +00:00
- Add [SoapySDR](https://github.com/pothosware/SoapySDR) support for the [C++ API](https://github.com/pothosware/SoapySDR/wiki/Cpp_API_Example) to include a wide range of SDR platforms.
2023-05-04 11:25:37 +00:00
## FAQ
- If the SDRplay RSPduo does not capture data, restart the API service (on the host) using `sudo systemctl restart sdrplay.api`.
2023-05-04 11:25:37 +00:00
## Contributing
Pull requests are welcome - especially for adding support for a new SDR.
2024-01-18 13:25:32 +00:00
- 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 - email me for more info.
2023-05-04 11:25:37 +00:00
## License
[MIT](https://choosealicense.com/licenses/mit/)