Files
heltec-repeater/docs/FINDINGS.md
T

4.8 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; measured airtimes are consistent with it).
  • The remaining CRC failures on long Techem frames are bit errors accumulating over frame length, not a hard sensitivity floor: the same meters decode cleanly when a few dB stronger (docs/RF_FRONTEND_TESTS.md).

CONFIRMED (measurement methodology)

  • Heltec RX is competitive with the Nooelec observer on identical traffic: 124 of 127 SDR-classified originals matched byte-exactly in a 30 min run (97 % across 32 meters).
  • Repeat payloads are byte-exact: 63/63 logged tx_payload values equalled mode bytes + the received raw frame. No corruption in the RX->TX path.
  • Our repeats DO radiate. IQ capture shows burst pairs at 54-55 ms spacing with 9-10 ms duration (matches 100 kbps x ~100 bytes) - the repeat is real RF, independently observed, even when rtl-wmbus cannot decode it.
  • The observer, not the repeater, limits repeat decoding: our TX arrives ~36 dB stronger than meter traffic and sits at RTL-SDR full scale. Raising the repeat delay 50 -> 200 ms improved SDR repeat decoding from 3 % to 30 % (demodulator level-estimate recovery).
  • Synthetic C1 bursts from the Heltec (L = 19/40/60/98) are decoded by rtl-wmbus as valid C1 with correct CRCs, including two airings of the same frame 50/100/200 ms apart. TX framing is therefore correct and standards-shaped independently of meter traffic.
  • rtl_wmbus runs two demodulators, so one airing yields 1-2 output lines; and rtl_sdr delivers ~81.92 ms buffers, so decode timestamps are quantized - SDR timestamps cannot be trusted below ~100 ms resolution. Correlation must use byte identity plus occurrence counting, not timestamps alone.
  • The Nooelec intermittently enters a deaf state (R820T I2C init failure / PLL wedge). hil/sdr_health.py detects it by checking that noise tracks tuner gain and the spectrum has structure; the harness aborts rather than reporting an unattributable empty capture.
  • "[R82XX] PLL not locked!" printed during tuning is BENIGN (emitted while rtl_sdr probes and disables direct-sampling mode); it is not a wedge indicator. The real symptom is railed, gain-independent noise.

NEEDS TESTING

  • LNA on/off comparison (set fem_rx_csd 0|1 hook exists, not yet measured).
  • Narrower RX bandwidth (156 kHz) vs current 234.3 kHz on weak meters.
  • Long-run stability at >=100 and >=500 verified repeat events.
  • Early-stop RX (poll GetRxBufferStatus) to cut the ~20 ms deaf tail.