Files
heltec-repeater/docs/FINDINGS.md
T

2.9 KiB

Findings

CONFIRMED

  • 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. 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; 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: 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

  • Fixed 255-byte RX capture adds up to ~20 ms artificial dead time per frame (by construction; to be measured).

DISPROVEN

  • "rtl_sdr pipeline works out of the box": the PLL wedge cost ~20 minutes of empty captures. Always energy-probe the SDR before trusting a null result.

NEEDS TESTING

  • 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 over many events.
  • Long-run stability (>=100, >=500 repeats).