diff --git a/docs/FINDINGS.md b/docs/FINDINGS.md index 11825d4..dae817a 100644 --- a/docs/FINDINGS.md +++ b/docs/FINDINGS.md @@ -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). diff --git a/docs/SDR_BASELINE.md b/docs/SDR_BASELINE.md new file mode 100644 index 0000000..9225969 --- /dev/null +++ b/docs/SDR_BASELINE.md @@ -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. diff --git a/hil/correlate.py b/hil/correlate.py index b67f7f3..dc34fc8 100755 --- a/hil/correlate.py +++ b/hil/correlate.py @@ -122,6 +122,16 @@ def main(): sdr = parse_sdr(args.sdr) 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 --------------------- # 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.