Files
heltec-repeater/docs/FINDINGS.md
T

90 lines
4.8 KiB
Markdown

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