From 58306c791251cbb6ca02a04c5b50d899da64b5ea Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 12:34:23 +0000 Subject: [PATCH 01/17] Add deployment guide for HackRF One with Raspberry Pi 5 Added detailed components list and installation instructions for deploying HackRF One with Raspberry Pi 5. --- .../HackRF One with Raspberry Pi 5.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 doc/example-deployments/HackRF One with Raspberry Pi 5.md diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md new file mode 100644 index 00000000..f7229bde --- /dev/null +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -0,0 +1,24 @@ +# Components + +- Raspberry Pi 5 with 16GB RAM +- 2x HackRF One SDR +- (Highly recommended) HackRF TCXO +- 2x antennas tuned for the chosen frequency +- (Optional for ADS-B) Omni-directional ADS-B antenna +- (Optional for ADS-B) RTL-sdr (RTL2832U & R820T2 are fine. No need for an expensive one) +- (Optional for ADS-B) Low Noise Amplifier (LNA) +- (Optional for ADS-B & Cooling fan) DC-to-DC Converter +- (Optional) Cooling fan (5v or 12v) +- USB Cables +- Soldering kit +- Patch cables + +# Software Installation + + + +# Physical build + +**Circuit Diagram** + +Circuit-Diagram From 2ff328e877a476df72ddfb6364c9ef57e66ddfab Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 12:44:08 +0000 Subject: [PATCH 02/17] Add software installation steps for HackRF One Added software installation instructions for HackRF One with Raspberry Pi 5, including Ubuntu setup and necessary packages. --- .../HackRF One with Raspberry Pi 5.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index f7229bde..398125f3 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -15,6 +15,23 @@ # Software Installation +- Install Ubuntu Server 25.10 +- Update Ubuntu +- Upgrade Ubuntu +- Install Docker by [using the apt repository](https://docs.docker.com/engine/install/ubuntu/) +- Install HackRF firmware and tools + ```bash + sudo apt install hackrf* + ``` +- Install RTLSdr tools + ```bash + sudo apt install rtl-sdr* + ``` +- Install [Blah2](https://github.com/30hours/blah2) +- Make sure to place the correct config file for HackRF One in ```/opt/blah2/config/config.yml```. Another type of SDR device could be there be default. All example config files reside in the same directory. + + + # Physical build From 1054d0e430ecc06c529206cacbaadf76b9115007 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 12:45:11 +0000 Subject: [PATCH 03/17] Update config file instructions for HackRF One Clarified the instructions regarding the config file for HackRF One. --- doc/example-deployments/HackRF One with Raspberry Pi 5.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index 398125f3..066d01dc 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -28,7 +28,7 @@ sudo apt install rtl-sdr* ``` - Install [Blah2](https://github.com/30hours/blah2) -- Make sure to place the correct config file for HackRF One in ```/opt/blah2/config/config.yml```. Another type of SDR device could be there be default. All example config files reside in the same directory. +- Make sure to place the correct config file for HackRF One in ```/opt/blah2/config/config.yml```. Another type of SDR device config could be there be default. All example config files reside in the same directory. From 43541bbeba7fc839edf332922db6fd00555cad32 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 12:59:27 +0000 Subject: [PATCH 04/17] Document physical build and circuit diagram for HackRF One Added a section on physical build and circuit diagram for HackRF One setup. --- .../HackRF One with Raspberry Pi 5.md | 27 +++++++++++++------ 1 file changed, 19 insertions(+), 8 deletions(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index 066d01dc..838cc885 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -13,6 +13,15 @@ - Soldering kit - Patch cables +# Physical build + +**Circuit Diagram** + +Circuit-Diagram + +- If you are using an original HackRF One, make sure to have an antenna plugged in all the time when operating the SDR. Otherwise, you may damage the board. (The Clifford Heath version which you can find on AliExpress has a protection circuit against this). +- Some of the ADS-B packages you'll find below may fail to install correctly if you don't have the RTL-sdr dongle plugged in. + # Software Installation - Install Ubuntu Server 25.10 @@ -27,15 +36,17 @@ ```bash sudo apt install rtl-sdr* ``` -- Install [Blah2](https://github.com/30hours/blah2) +- Install [blah2](https://github.com/30hours/blah2) +- Obtain the HackRF One serial numbers by running ```hackrf_info```. - Make sure to place the correct config file for HackRF One in ```/opt/blah2/config/config.yml```. Another type of SDR device config could be there be default. All example config files reside in the same directory. +- (Optional) As I have been testing outdoors, it may take the HackRF board a bit of time after a cold start to warm up and stabilise. Hence, I force blah2 to restart after 10mins of boot time + ```bash + sudo crontab -e + ``` + Then, add the following line to the end of the file + ```bash + @reboot sleep 600 && sudo docker compose -f /opt/blah2/docker-compose.yml down; sudo docker compose -f /opt/blah2/docker-compose.yml up + ``` - - -# Physical build - -**Circuit Diagram** - -Circuit-Diagram From fc7c968485397c9c31dcb2ec1ecccd616b07d09e Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 13:11:18 +0000 Subject: [PATCH 05/17] Enhance documentation with wiring and usage details Added wiring diagram for HackRF One devices and clarified usage notes. --- doc/example-deployments/HackRF One with Raspberry Pi 5.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index 838cc885..85abff1e 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -17,8 +17,13 @@ **Circuit Diagram** -Circuit-Diagram +Circuit-Diagram +**Wiring of the 2 HackRF One devices** + +HackRF-wiring + +- If you are using a TCXO to enhance the clock stability, put it on the Surviellance device (not shown on the above photo) - If you are using an original HackRF One, make sure to have an antenna plugged in all the time when operating the SDR. Otherwise, you may damage the board. (The Clifford Heath version which you can find on AliExpress has a protection circuit against this). - Some of the ADS-B packages you'll find below may fail to install correctly if you don't have the RTL-sdr dongle plugged in. From fad1e99999b471e3aee13e8d0c99f2c81d1e7652 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 14:55:19 +0000 Subject: [PATCH 06/17] Revise documentation for HackRF One with Raspberry Pi 5 Updated component descriptions and installation instructions for clarity and accuracy. --- .../HackRF One with Raspberry Pi 5.md | 33 +++++++++++++++---- 1 file changed, 27 insertions(+), 6 deletions(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index 85abff1e..8cef1cfe 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -1,15 +1,15 @@ # Components -- Raspberry Pi 5 with 16GB RAM +- Raspberry Pi 5 (RPI) with 16GB RAM - 2x HackRF One SDR -- (Highly recommended) HackRF TCXO +- (Optional, but highly recommended) HackRF TCXO - 2x antennas tuned for the chosen frequency - (Optional for ADS-B) Omni-directional ADS-B antenna - (Optional for ADS-B) RTL-sdr (RTL2832U & R820T2 are fine. No need for an expensive one) - (Optional for ADS-B) Low Noise Amplifier (LNA) - (Optional for ADS-B & Cooling fan) DC-to-DC Converter - (Optional) Cooling fan (5v or 12v) -- USB Cables +- USB Cables (to connect HackRf One and RTL-sdr to RPI) - Soldering kit - Patch cables @@ -17,7 +17,8 @@ **Circuit Diagram** -Circuit-Diagram +HackRF-Circuit-diagram + **Wiring of the 2 HackRF One devices** @@ -35,9 +36,9 @@ - Install Docker by [using the apt repository](https://docs.docker.com/engine/install/ubuntu/) - Install HackRF firmware and tools ```bash - sudo apt install hackrf* + sudo apt install hackrf ``` -- Install RTLSdr tools +- Install RTL-sdr tools ```bash sudo apt install rtl-sdr* ``` @@ -52,6 +53,26 @@ ```bash @reboot sleep 600 && sudo docker compose -f /opt/blah2/docker-compose.yml down; sudo docker compose -f /opt/blah2/docker-compose.yml up ``` +- Install [adsb2dd](https://github.com/30hours/adsb2dd). No additional configuration is required for adsb2dd. +- Install readsb (it helps if the rtl-sdr dongle is plugged in!). Instruction can be found [here](https://github.com/wiedehopf/adsb-scripts/wiki/Automatic-installation-for-readsb). +- Set your radar location by putting the right coordinates. (latitude, longitude) + ```bash + sudo readsb-set-location 0.00000001 0.00000001 + ``` +- Install [tar1090](https://github.com/wiedehopf/tar1090). After installation, do the following. +```bash +sudo mv /etc/lighttpd/conf-enabled/88-tar1090.conf /etc/lighttpd/conf-enabled/88-tar1090.conf_archived +``` +The service can be accessed now from ```http://ip_address:8504/``` + +**Cooling fan** + +- If you're going to install a cooling fan in your enclosure to cool it down, install "sensors" to get readings from sensors onboard the RPI. +```bash +sudo apt install lm-sensors +sudo sensors-detect +sensors +``` From ce148a3bc7d7ad80b6bc2d8a3cbddbbb0ac66bef Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 14:57:25 +0000 Subject: [PATCH 07/17] Add fan control script based on CPU temperature MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This script toggles GPIO 17 based on CPU temperature readings, activating it when the temperature exceeds 60°C. --- doc/example-deployments/fan.sh | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 doc/example-deployments/fan.sh diff --git a/doc/example-deployments/fan.sh b/doc/example-deployments/fan.sh new file mode 100644 index 00000000..b20be6a3 --- /dev/null +++ b/doc/example-deployments/fan.sh @@ -0,0 +1,34 @@ +#!/bin/bash + +# Toggle GPIO 17 based on CPU temperature (>60°C) +# Usage: ./fan.sh + +# Ensure pinctrl is available +if ! command -v pinctrl &> /dev/null; then + echo "Error: pinctrl not found. Please install or check your system." + exit 1 +fi + +# Set GPIO17 as output (optional – can be omitted if already configured) +sudo pinctrl set 17 op + +# Extract the temperature from sensors output +# Expected line: "temp1: +56.2°C" +temp_raw=$(sensors | grep -A 2 "cpu_thermal-virtual-0" | grep "temp1:" | awk '{print $2}' | tr -d '+°C') + +if [ -z "$temp_raw" ]; then + echo "Error: Could not read temperature from sensors" + exit 1 +fi + +# Convert to integer by multiplying by 10 (e.g., 56.2 → 562) +temp_int=$(echo "$temp_raw" | awk '{printf "%d", $1 * 10}') + +# Compare with threshold 60.0°C → 600 +if [ "$temp_int" -gt 600 ]; then + sudo pinctrl set 17 dh + echo "Temperature ${temp_raw}°C is above 60°C → GPIO17 set HIGH" +else + sudo pinctrl set 17 dl + echo "Temperature ${temp_raw}°C is ≤60°C → GPIO17 set LOW" +fi From a4972acf78e72e28f2d38411cbda08fded2ea12c Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 15:09:57 +0000 Subject: [PATCH 08/17] Revise HackRF One deployment instructions Updated instructions for using TCXO and added optional cooling fan setup. --- .../HackRF One with Raspberry Pi 5.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index 8cef1cfe..c22b0744 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -24,7 +24,7 @@ HackRF-wiring -- If you are using a TCXO to enhance the clock stability, put it on the Surviellance device (not shown on the above photo) +- If you are using a TCXO to enhance the clock stability, put it on the Surveillance device (not shown on the above photo) - If you are using an original HackRF One, make sure to have an antenna plugged in all the time when operating the SDR. Otherwise, you may damage the board. (The Clifford Heath version which you can find on AliExpress has a protection circuit against this). - Some of the ADS-B packages you'll find below may fail to install correctly if you don't have the RTL-sdr dongle plugged in. @@ -45,6 +45,7 @@ - Install [blah2](https://github.com/30hours/blah2) - Obtain the HackRF One serial numbers by running ```hackrf_info```. - Make sure to place the correct config file for HackRF One in ```/opt/blah2/config/config.yml```. Another type of SDR device config could be there be default. All example config files reside in the same directory. +- At this stage, you just need to put the serial numbers of the reference and surveillance HackRF One devices. Tuning other parameters will be discussed separately. - (Optional) As I have been testing outdoors, it may take the HackRF board a bit of time after a cold start to warm up and stabilise. Hence, I force blah2 to restart after 10mins of boot time ```bash sudo crontab -e @@ -65,7 +66,7 @@ sudo mv /etc/lighttpd/conf-enabled/88-tar1090.conf /etc/lighttpd/conf-enabled/88 ``` The service can be accessed now from ```http://ip_address:8504/``` -**Cooling fan** +**Cooling fan - Optional** - If you're going to install a cooling fan in your enclosure to cool it down, install "sensors" to get readings from sensors onboard the RPI. ```bash @@ -73,6 +74,19 @@ sudo apt install lm-sensors sudo sensors-detect sensors ``` +- Create the file ```create /opt/automation/fan.sh``` and copy the content of [fan.sh](./fan.sh) inside it. +- Run +```bash +chmod 755 /opt/automation/fan.sh +sudo crontab -e +``` +Insert the following line at the end of the file +```bash +* * * * * sudo /opt/automation/fan.sh +``` + +# Tuning and Troubleshooting +TBC From 65c08ea18df49e50ff37fb30009b5b1a70acdf7f Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 15:14:38 +0000 Subject: [PATCH 09/17] Update equipment list for HackRF One deployment Added additional tools and components for setup. --- doc/example-deployments/HackRF One with Raspberry Pi 5.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index c22b0744..862f39e3 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -5,13 +5,17 @@ - (Optional, but highly recommended) HackRF TCXO - 2x antennas tuned for the chosen frequency - (Optional for ADS-B) Omni-directional ADS-B antenna +- Good quality RF cables. Ideally, cables with 50ohm impedance. +- RF Cable connectors (e.g. SMA) - (Optional for ADS-B) RTL-sdr (RTL2832U & R820T2 are fine. No need for an expensive one) - (Optional for ADS-B) Low Noise Amplifier (LNA) - (Optional for ADS-B & Cooling fan) DC-to-DC Converter - (Optional) Cooling fan (5v or 12v) - USB Cables (to connect HackRf One and RTL-sdr to RPI) - Soldering kit -- Patch cables +- Cable crimping tool. +- Heatshrink sleeves +- Patch cables (to power LNA, use RPI GPIO, etc.) # Physical build From dd2bbb3a533d71d84d9fd34aa50881313c818447 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 15:15:51 +0000 Subject: [PATCH 10/17] Fix formatting and punctuation in deployment guide --- .../HackRF One with Raspberry Pi 5.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index 862f39e3..63ade29e 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -1,21 +1,21 @@ # Components -- Raspberry Pi 5 (RPI) with 16GB RAM -- 2x HackRF One SDR -- (Optional, but highly recommended) HackRF TCXO -- 2x antennas tuned for the chosen frequency -- (Optional for ADS-B) Omni-directional ADS-B antenna +- Raspberry Pi 5 (RPI) with 16GB RAM. +- 2x HackRF One SDR. +- (Optional, but highly recommended) HackRF TCXO. +- 2x antennas tuned for the chosen frequency. +- (Optional for ADS-B) Omni-directional ADS-B antenna. - Good quality RF cables. Ideally, cables with 50ohm impedance. -- RF Cable connectors (e.g. SMA) -- (Optional for ADS-B) RTL-sdr (RTL2832U & R820T2 are fine. No need for an expensive one) -- (Optional for ADS-B) Low Noise Amplifier (LNA) -- (Optional for ADS-B & Cooling fan) DC-to-DC Converter -- (Optional) Cooling fan (5v or 12v) -- USB Cables (to connect HackRf One and RTL-sdr to RPI) -- Soldering kit +- RF Cable connectors (e.g. SMA). +- (Optional for ADS-B) RTL-sdr (RTL2832U & R820T2 are fine. No need for an expensive one). +- (Optional for ADS-B) Low Noise Amplifier (LNA). +- (Optional for ADS-B & Cooling fan) DC-to-DC Converter. +- (Optional) Cooling fan (5v or 12v). +- USB Cables (to connect HackRf One and RTL-sdr to RPI). +- Soldering kit. - Cable crimping tool. -- Heatshrink sleeves -- Patch cables (to power LNA, use RPI GPIO, etc.) +- Heatshrink sleeves. +- Patch cables (to power LNA, use RPI GPIO, etc.). # Physical build @@ -28,7 +28,7 @@ HackRF-wiring -- If you are using a TCXO to enhance the clock stability, put it on the Surveillance device (not shown on the above photo) +- If you are using a TCXO to enhance the clock stability, put it on the Surveillance device (not shown on the above photo). - If you are using an original HackRF One, make sure to have an antenna plugged in all the time when operating the SDR. Otherwise, you may damage the board. (The Clifford Heath version which you can find on AliExpress has a protection circuit against this). - Some of the ADS-B packages you'll find below may fail to install correctly if you don't have the RTL-sdr dongle plugged in. From 76a1b8ffa3442be85513edbd36b5a7b6b72a6245 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 15:21:19 +0000 Subject: [PATCH 11/17] Update TCXO placement instructions in documentation Clarified TCXO placement instructions for the Surveillance device. --- doc/example-deployments/HackRF One with Raspberry Pi 5.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index 63ade29e..b995c247 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -28,7 +28,11 @@ HackRF-wiring -- If you are using a TCXO to enhance the clock stability, put it on the Surveillance device (not shown on the above photo). +- If you are using a TCXO to enhance the clock stability, put it on the Surveillance device as shown below. + + + + - If you are using an original HackRF One, make sure to have an antenna plugged in all the time when operating the SDR. Otherwise, you may damage the board. (The Clifford Heath version which you can find on AliExpress has a protection circuit against this). - Some of the ADS-B packages you'll find below may fail to install correctly if you don't have the RTL-sdr dongle plugged in. From ca86aaee422d73763f48cf0eee9e75de65306c85 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 15:23:07 +0000 Subject: [PATCH 12/17] Clarify optional components for ADS-B setup --- doc/example-deployments/HackRF One with Raspberry Pi 5.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index b995c247..26cc5410 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -4,12 +4,12 @@ - 2x HackRF One SDR. - (Optional, but highly recommended) HackRF TCXO. - 2x antennas tuned for the chosen frequency. -- (Optional for ADS-B) Omni-directional ADS-B antenna. +- (If using ADS-B) Omni-directional ADS-B antenna. - Good quality RF cables. Ideally, cables with 50ohm impedance. - RF Cable connectors (e.g. SMA). -- (Optional for ADS-B) RTL-sdr (RTL2832U & R820T2 are fine. No need for an expensive one). -- (Optional for ADS-B) Low Noise Amplifier (LNA). -- (Optional for ADS-B & Cooling fan) DC-to-DC Converter. +- (If using ADS-B) RTL-sdr (RTL2832U & R820T2 are fine. No need for an expensive one). +- (If using ADS-B) Low Noise Amplifier (LNA). +- (If using ADS-B or a cooling fan) DC-to-DC Converter. - (Optional) Cooling fan (5v or 12v). - USB Cables (to connect HackRf One and RTL-sdr to RPI). - Soldering kit. From 98b418de683d1ded6bf2bf6df0b6d65e43111620 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 15:29:39 +0000 Subject: [PATCH 13/17] Revise HackRF One deployment instructions Updated instructions for deploying HackRF One with Raspberry Pi 5, including Dockerfile changes for ARM compatibility and configuration details. --- doc/example-deployments/HackRF One with Raspberry Pi 5.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index 26cc5410..b6067eaa 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -51,6 +51,7 @@ sudo apt install rtl-sdr* ``` - Install [blah2](https://github.com/30hours/blah2) +- The above is likely to fail when you have run ```sudo docker compose up``` because the default Dockerfile was written for x64 machines. You need to replace it with [this file](/30hours/blah2/blob/main/contrib/raspberrypi/Dockerfile) that was written for ARM devices. - Obtain the HackRF One serial numbers by running ```hackrf_info```. - Make sure to place the correct config file for HackRF One in ```/opt/blah2/config/config.yml```. Another type of SDR device config could be there be default. All example config files reside in the same directory. - At this stage, you just need to put the serial numbers of the reference and surveillance HackRF One devices. Tuning other parameters will be discussed separately. From 48fae8d79e9598c358984fdeec3ae973dd5aacd0 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 15:31:06 +0000 Subject: [PATCH 14/17] Update installation instructions for blah2 on Raspberry Pi Clarified installation failure reasons for blah2 on ARM devices. --- doc/example-deployments/HackRF One with Raspberry Pi 5.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index b6067eaa..ae41c083 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -51,7 +51,7 @@ sudo apt install rtl-sdr* ``` - Install [blah2](https://github.com/30hours/blah2) -- The above is likely to fail when you have run ```sudo docker compose up``` because the default Dockerfile was written for x64 machines. You need to replace it with [this file](/30hours/blah2/blob/main/contrib/raspberrypi/Dockerfile) that was written for ARM devices. +- If the installation had failed, this is likely due to the default Dockerfile. It was written for x64 machines. You need to replace it with [this file](/30hours/blah2/blob/main/contrib/raspberrypi/Dockerfile) that was written for ARM devices. - Obtain the HackRF One serial numbers by running ```hackrf_info```. - Make sure to place the correct config file for HackRF One in ```/opt/blah2/config/config.yml```. Another type of SDR device config could be there be default. All example config files reside in the same directory. - At this stage, you just need to put the serial numbers of the reference and surveillance HackRF One devices. Tuning other parameters will be discussed separately. From 3f0de0e67ecf10d537a3633f16545e6afecdac45 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 15:31:48 +0000 Subject: [PATCH 15/17] Fix Dockerfile link for ARM compatibility Updated the Dockerfile reference for ARM devices. --- doc/example-deployments/HackRF One with Raspberry Pi 5.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF One with Raspberry Pi 5.md index ae41c083..544166cb 100644 --- a/doc/example-deployments/HackRF One with Raspberry Pi 5.md +++ b/doc/example-deployments/HackRF One with Raspberry Pi 5.md @@ -51,7 +51,7 @@ sudo apt install rtl-sdr* ``` - Install [blah2](https://github.com/30hours/blah2) -- If the installation had failed, this is likely due to the default Dockerfile. It was written for x64 machines. You need to replace it with [this file](/30hours/blah2/blob/main/contrib/raspberrypi/Dockerfile) that was written for ARM devices. +- If the installation had failed, this is likely due to the default Dockerfile. It was written for x64 machines. You need to replace it with [this Dockerfile](/30hours/blah2/blob/main/contrib/raspberrypi/Dockerfile) that was written for ARM devices. - Obtain the HackRF One serial numbers by running ```hackrf_info```. - Make sure to place the correct config file for HackRF One in ```/opt/blah2/config/config.yml```. Another type of SDR device config could be there be default. All example config files reside in the same directory. - At this stage, you just need to put the serial numbers of the reference and surveillance HackRF One devices. Tuning other parameters will be discussed separately. From d61375fd85d3bd989ded497ed2dcba2a90f2ca09 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 23:31:52 +0000 Subject: [PATCH 16/17] Rename HackRF One deployment documentation --- .../{HackRF One with Raspberry Pi 5.md => HackRF-RPI5/README.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename doc/example-deployments/{HackRF One with Raspberry Pi 5.md => HackRF-RPI5/README.md} (100%) diff --git a/doc/example-deployments/HackRF One with Raspberry Pi 5.md b/doc/example-deployments/HackRF-RPI5/README.md similarity index 100% rename from doc/example-deployments/HackRF One with Raspberry Pi 5.md rename to doc/example-deployments/HackRF-RPI5/README.md From 588d2fe6952585a847bd4429ba4bd8dc0a63a496 Mon Sep 17 00:00:00 2001 From: jomosh Date: Sun, 1 Mar 2026 23:32:16 +0000 Subject: [PATCH 17/17] Rename doc/example-deployments/fan.sh to doc/example-deployments/HackRF-RPI5/fan.sh --- doc/example-deployments/{ => HackRF-RPI5}/fan.sh | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename doc/example-deployments/{ => HackRF-RPI5}/fan.sh (100%) diff --git a/doc/example-deployments/fan.sh b/doc/example-deployments/HackRF-RPI5/fan.sh similarity index 100% rename from doc/example-deployments/fan.sh rename to doc/example-deployments/HackRF-RPI5/fan.sh