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).