docs: SDR baseline, findings root causes; correlator dedup

This commit is contained in:
Lars Nolden
2026-08-31 22:45:11 +02:00
parent f7c8614a3b
commit 04c8130615
3 changed files with 81 additions and 10 deletions
+31 -10
View File
@@ -5,20 +5,42 @@
- Heltec V4.3 SX1262 pin mapping (NSS 8, SCK 9, MOSI 10, MISO 11, RST 12,
BUSY 13, DIO1 14): SPI write/readback passes, radio enters RX
(`radio_init: spi:true, reset:true, tcxo:true, result:ok`).
- TCXO is DIO3-controlled at 1.8 V; without post-TCXO recalibration the
XOSC_START_ERR device error appears. With recalibrate: no device errors.
- TCXO is DIO3-controlled at 1.8 V. The first Calibrate after
SetDIO3AsTCXOCtrl latches a benign XOSC_START_ERR (0x20). Correct
sequence: enable TCXO -> clear errors -> STDBY_XOSC (verify chip mode 3)
-> clear -> Calibrate(0x7F) -> judge remaining errors. With that
sequence: device_errors=0, TCXO verified running.
- KCT8103L FEM on GPIO7 (power), GPIO2 (CSD), GPIO5 (CTX), CPS on DIO2.
RX works with CSD high + CTX low + DIO2-as-RF-switch.
- Firmware heartbeat RSSI in RX: -101..-107 dBm noise floor -> RX chain
with boosted gain is plausibly alive.
RX works with CSD high + CTX low + DIO2-as-RF-switch; TX RF confirmed
with CTX high during TX.
- SX1262 IRQ flags latch ONLY for interrupts enabled in the
SetDioIrqParams mask. An unconfigured radio produces zero flags forever
— indistinguishable from "no traffic" without the raw probe.
- TX proof of life: SDR decoded our synthetic C1 format-A frame as valid
(crc_ok=1, mfr 0x4D8E "SLN", ID 00000001) at configured -9 dBm, and the
wM-Bus CRC blocks computed by firmware matched rtl_wmbus's checks.
- First real repeat observed: 100-byte Techem frame received, repeated
after 50.002 ms (configured 50 ms).
- Nooelec NESDR SMArt v5 R820T PLL wedges ("PLL not locked"), producing
gain-independent white noise on all frequencies until USB reset.
`usbreset 0bda:2838` reliably restores operation. Trigger correlated
with `rtl_test -t` direct-sampling probe.
- rtl-sdr-blog and osmocom rtl_sdr builds behave identically w.r.t. the
wedge; not a driver-fork issue.
- Real C1 traffic exists at this site (first telegram decoded 22:23 local,
meter ID 04767752).
- Real C1 traffic exists at this site: 8 meters in 10 min baseline
(docs/SDR_BASELINE.md); one strong plaintext meter (61471660), several
marginal encrypted Techem meters.
## ROOT-CAUSED BUGS (fixed)
1. XOSC_START_ERR treated as fatal -> init "failed" -> GFSK config was
skipped entirely -> radio sat in LoRa defaults; recovery level 1
reported "rx_restored" on an unconfigured radio. Fix: proper TCXO
verify + always apply configuration + recovery judges combined result.
2. DIO1 ISR callback was never registered (sx126x_set_irq_callback not
called) -> no notifications despite correct radio-side IRQ config.
3. `timeout bash -c "rtl_sdr | rtl_wmbus"` orphans the pipeline children
on timeout (device stays claimed). Apply timeout to rtl_sdr directly.
## LIKELY
@@ -33,8 +55,7 @@
## NEEDS TESTING
- Heltec C1 RX of real meter frames (SDR sees traffic; Heltec match TBD).
- TX proof of life via SDR.
- Heltec vs SDR RX match rate on real meters (first HIL run in progress).
- LNA on/off comparison (KCT8103L CSD low in RX = bypass?).
- Repeat delay accuracy, RX deaf time distribution.
- Repeat delay accuracy, RX deaf time distribution over many events.
- Long-run stability (>=100, >=500 repeats).
+40
View File
@@ -0,0 +1,40 @@
# SDR Baseline — Phase 0
Capture: 2026-08-31, 10 minutes, 868.95 MHz, 1.6 Msps, gain 42.1 dB,
Nooelec NESDR SMArt v5 + rtl_wmbus (`captures/2026-08-31T22-21-35-baseline/`).
Preceded by SDR recovery: the R820T PLL was wedged and produced
gain-independent white noise until `usbreset 0bda:2838` (see FINDINGS.md).
## Results
```
telegram decodes: 15 lines (12 unique bursts after dual-demod dedup)
14 C1 + 1 T1
capture duration: 600 s
unique meters: 8
```
Note: rtl_wmbus runs two demodulation algorithms; a strong burst is
reported twice within ~1 ms. Counts below are per decode line.
| Meter ID | Mode | Decodes | CRC ok | RSSI (rtl units) | Class |
|---|---|---|---|---|---|
| 61471660 | C1 | 4 (2 bursts) | 4 | 121-135 | strong, plaintext (mfr 0x4493) |
| 04766765 | C1 | 3 (2 bursts) | 3 | 11-18 | marginal, Techem (0x5068), encrypted |
| 04766767 | C1 | 2 (1 burst) | 2 | 13-15 | marginal, Techem |
| 04769585 | C1 | 2 (1 burst) | 2 | 11-13 | marginal, Techem |
| 04767752 | C1 | 1 | 0 | 7 | weak, Techem |
| 04766770 | C1 | 1 | 1 | 11 | weak, Techem |
| 04804354 | C1 | 1 | 0 | 11 | weak, Techem |
| 01681028 | T1 | 1 | 1 | 11 | T-mode, out of scope |
## Assessment
- Known strong meter: 61471660 (long interval, ~7.5 min between bursts).
- Known marginal meters: the 0476xxxx / 048xxxxx Techem population
(RSSI ~7-18, some CRC failures at the SDR itself).
- Aggregate C1 rate: ~1.4 bursts/min -> reliability milestones (100/500
repeats) require multi-hour runs at this site.
- Baseline is sufficient to proceed: the SDR reliably detects real C1
traffic, including weak meters.