fix: HackRF One support — detection, ADS-B, waterfall, and error handling

- Parse hackrf_info stderr (newer firmware) and handle non-zero exit codes
- Fix gain_max from 62 to 102 (combined LNA 40 + VGA 62)
- Apply resolved readsb binary path for all SDR types, not just RTL-SDR
- Add HackRF/SoapySDR-specific error messages in ADS-B startup
- Add HackRF waterfall support via rx_sdr IQ capture + FFT
- Add 17 tests for HackRF detection and command builder

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

utils/sdr/detection.py

@@ -356,6 +356,11 @@ def detect_hackrf_devices() -> list[SDRDevice]:
             timeout=5
         )
 
+        # Combine stdout + stderr: newer firmware may print to stderr,
+        # and hackrf_info may exit non-zero when device is briefly busy
+        # but still output valid info.
+        output = result.stdout + result.stderr
+
         # Parse hackrf_info output
         # Extract board name from "Board ID Number: X (Name)" and serial
         from .hackrf import HackRFCommandBuilder
@@ -363,8 +368,8 @@ def detect_hackrf_devices() -> list[SDRDevice]:
         serial_pattern = r'Serial number:\s*(\S+)'
         board_pattern = r'Board ID Number:\s*\d+\s*\(([^)]+)\)'
 
-        serials_found = re.findall(serial_pattern, result.stdout)
-        boards_found = re.findall(board_pattern, result.stdout)
+        serials_found = re.findall(serial_pattern, output)
+        boards_found = re.findall(board_pattern, output)
 
         for i, serial in enumerate(serials_found):
             board_name = boards_found[i] if i < len(boards_found) else 'HackRF'
@@ -378,8 +383,8 @@ def detect_hackrf_devices() -> list[SDRDevice]:
             ))
 
         # Fallback: check if any HackRF found without serial
-        if not devices and 'Found HackRF' in result.stdout:
-            board_match = re.search(board_pattern, result.stdout)
+        if not devices and 'Found HackRF' in output:
+            board_match = re.search(board_pattern, output)
             board_name = board_match.group(1) if board_match else 'HackRF'
             devices.append(SDRDevice(
                 sdr_type=SDRType.HACKRF,

utils/sdr/hackrf.py

@@ -22,7 +22,7 @@ class HackRFCommandBuilder(CommandBuilder):
         freq_min_mhz=1.0,        # 1 MHz
         freq_max_mhz=6000.0,     # 6 GHz
         gain_min=0.0,
-        gain_max=62.0,           # LNA (0-40) + VGA (0-62)
+        gain_max=102.0,          # LNA (0-40) + VGA (0-62)
         sample_rates=[2000000, 4000000, 8000000, 10000000, 20000000],
         supports_bias_t=True,
         supports_ppm=False,