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, - 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 BUSY 13, DIO1 14): SPI write/readback passes, radio enters RX
(`radio_init: spi:true, reset:true, tcxo:true, result:ok`). (`radio_init: spi:true, reset:true, tcxo:true, result:ok`).
- TCXO is DIO3-controlled at 1.8 V; without post-TCXO recalibration the - TCXO is DIO3-controlled at 1.8 V. The first Calibrate after
XOSC_START_ERR device error appears. With recalibrate: no device errors. 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. - KCT8103L FEM on GPIO7 (power), GPIO2 (CSD), GPIO5 (CTX), CPS on DIO2.
RX works with CSD high + CTX low + DIO2-as-RF-switch. RX works with CSD high + CTX low + DIO2-as-RF-switch; TX RF confirmed
- Firmware heartbeat RSSI in RX: -101..-107 dBm noise floor -> RX chain with CTX high during TX.
with boosted gain is plausibly alive. - 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 - Nooelec NESDR SMArt v5 R820T PLL wedges ("PLL not locked"), producing
gain-independent white noise on all frequencies until USB reset. gain-independent white noise on all frequencies until USB reset.
`usbreset 0bda:2838` reliably restores operation. Trigger correlated `usbreset 0bda:2838` reliably restores operation. Trigger correlated
with `rtl_test -t` direct-sampling probe. with `rtl_test -t` direct-sampling probe.
- rtl-sdr-blog and osmocom rtl_sdr builds behave identically w.r.t. the - rtl-sdr-blog and osmocom rtl_sdr builds behave identically w.r.t. the
wedge; not a driver-fork issue. wedge; not a driver-fork issue.
- Real C1 traffic exists at this site (first telegram decoded 22:23 local, - Real C1 traffic exists at this site: 8 meters in 10 min baseline
meter ID 04767752). (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 ## LIKELY
@@ -33,8 +55,7 @@
## NEEDS TESTING ## NEEDS TESTING
- Heltec C1 RX of real meter frames (SDR sees traffic; Heltec match TBD). - Heltec vs SDR RX match rate on real meters (first HIL run in progress).
- TX proof of life via SDR.
- LNA on/off comparison (KCT8103L CSD low in RX = bypass?). - 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). - 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.
+10
View File
@@ -122,6 +122,16 @@ def main():
sdr = parse_sdr(args.sdr) sdr = parse_sdr(args.sdr)
sdr_c1 = [s for s in sdr if s["mode"] == "C1" and s["crc_ok"]] sdr_c1 = [s for s in sdr if s["mode"] == "C1" and s["crc_ok"]]
# rtl_wmbus runs two demodulator algorithms concurrently; a single burst
# can be reported twice within ~1 ms. Collapse identical bytes < 5 ms apart.
deduped = []
for s in sorted(sdr_c1, key=lambda x: x["t"]):
if deduped and deduped[-1]["cooked"] == s["cooked"] \
and s["t"] - deduped[-1]["t"] < 0.005:
continue
deduped.append(s)
sdr_c1 = deduped
# --- classify SDR frames into originals vs repeats --------------------- # --- classify SDR frames into originals vs repeats ---------------------
# A repeat is an SDR frame with identical cooked bytes to an earlier SDR # A repeat is an SDR frame with identical cooked bytes to an earlier SDR
# frame within [min_delay, max_delay]. Everything else is an original. # frame within [min_delay, max_delay]. Everything else is an original.