docs: withdraw degraded-observer match rate, record observer drift and IQ TX proof

This commit is contained in:
Lars Nolden
2026-09-01 09:35:05 +02:00
parent fdc31d8227
commit 9a65fa2040
2 changed files with 120 additions and 59 deletions
+26 -8
View File
@@ -52,18 +52,36 @@
## 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).
- WITHDRAWN: an earlier entry claimed "Heltec matched 124 of 127 SDR
originals (97 %)". That measurement was taken while the dongle was in its
degraded state, so the SDR decoded few originals and the Heltec matched
nearly all of them. With the observer state recorded, the honest figure is
58.5 % of SDR originals matched (600 s run, observer "degraded"), with
each receiver also decoding meters the other missed. See
docs/RF_FRONTEND_TESTS.md.
- 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.
- Real repeats are emitted as correct RF: aligning firmware TX timestamps
to bursts in the same stream's IQ confirmed 48 of 57 TX events (84 %),
with alignment error median 1.3 ms (max 3.6 ms) and burst duration within
0.5 ms (median) of the computed airtime. Firmware repeat delay measured
200.0 ms min/median/max against a 200 ms setting.
- Firmware TX reliability over 600 s: tx_attempts 58, tx_success 58,
tx_timeout 0, tx_failures 0, recoveries 0.
- The observer, not the repeater, limits repeat DECODING. In the dongle's
full-sensitivity state our TX arrives ~36 dB stronger than meter traffic
and reaches RTL-SDR full scale; rtl-wmbus then receives our repeat with
1-2 byte errors and fails CRC (observed directly: transmitted
`...78534f4c5458...` decoded as `...78514f4c5448...`, rest bit-exact).
Raising the repeat delay 50 -> 200 ms improved SDR repeat decoding from
3 % to 30 % (demodulator level-estimate recovery).
- The dongle's sensitivity drifts ~17 dB within minutes of streaming, so
captures taken at "the same gain" at different times are NOT comparable.
Meter decodes and our own TX measurements must come from one stream
(`hil/capture_both.sh`).
- `rtl_sdr -g 0` selects AUTOMATIC gain, not 0 dB; lowest real fixed gain
is 0.9 dB. Low fixed gain is not a usable workaround while degraded:
at 0.9 and 7.7 dB nothing decoded at all.
- 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