Document repeater validation and operating limits

This commit is contained in:
Lars Nolden
2026-09-21 12:31:22 +02:00
parent 8c44c54131
commit 3a0d342314
11 changed files with 890 additions and 267 deletions
+22 -10
View File
@@ -127,6 +127,11 @@ negligible. In the *full* state, however, an earlier IQ capture showed our
repeat at +44.8 dB over floor with IQ amplitude at the dongle's full scale
(rms 88.6 of 127) while the meter original sat at +8.4 dB - a ~36 dB gap.
These TX amplitudes predate PA-row telemetry. They demonstrate the
observer's compression behavior in those captures, but must not be used as
the output level of the fixed firmware: the now-removed `pa_low` diagnostic
could select an undocumented SX1261-values/SX1262-select hybrid.
Consequence: with a fully sensitive dongle, meter originals decode well at
high gain but our own transmission is driven into compression and
rtl-wmbus receives it with a few byte errors (CRC fails). Observed
@@ -134,15 +139,20 @@ directly - the decoded hex differed from the transmitted frame in 1-2
bytes, e.g. transmitted `...78534f4c5458...` received `...78514f4c5448...`,
with the rest of a 113-byte frame bit-exact.
Mitigations applied in firmware: SX1262 at its minimum configured power
(-9 dBm) and the lowest documented PA table (paDutyCycle 0x01, hpMax 0x00,
SX1262 datasheet table 13-21). Remaining mitigation is physical (antenna
separation or an inline attenuator) and is not scriptable from this host.
Firmware correction: the former “lowest documented PA table”
`(paDutyCycle=0x01, hpMax=0x00, deviceSel=0x00, paLut=0x01)` mixed the
PA-duty/hpMax values from the SX1261 +10 dBm row with SX1262 selection.
It is not a documented SX1262 row and cost about 32 dB. It has been
deleted. Current firmware uses documented SX1262
`(0x02,0x02,0x00,0x01)` with SetTxParams -9 dBm. Receiver compression must
be handled at the observer with fixed low gain, physical separation, or an
attenuator—not by misconfiguring the DUT PA.
Note: `rtl_sdr -g 0` selects *automatic* gain, not 0 dB. The lowest real
fixed gain on this tuner is 0.9 dB. At 0.9 and 7.7 dB fixed gain the
degraded dongle decoded nothing at all (neither meters nor our TX), so low
gain is not a usable workaround in that state.
fixed gain on this tuner is 0.9 dB. In the historical degraded-observer
test, 0.9 and 7.7 dB decoded neither meters nor the then-configured TX.
With fixed firmware, a 0.9 dB-gain smoke capture measured all 9 beacons at
median +27.81 dB over floor without clipping.
## Repeat-delay dependence of observer decoding
@@ -164,6 +174,8 @@ the firmware's own repeat delay measures 200.0 ms min/median/max.
1. Meter originals and Heltec RX match rate: rtl-wmbus decodes at high gain.
2. Heltec TX framing is decodable as C1: proven with synthetic bursts that
are not preceded by a weak frame (`hil/verify_tx.py`).
3. Real repeats: proven at RF level from the same stream's IQ by aligning
firmware TX timestamps to observed bursts (`hil/verify_repeats_iq.py`),
which is immune to both compression and observer sensitivity drift.
3. Real repeats: proven at RF level from the same stream's IQ by
`hil/meter_anchored.py` -- clock fitted on strong meter receptions
(never on TX events, which can borrow their original's burst), then
event-correlated FSK spectral excess against non-TX controls. Immune to
compression and observer drift; classifies strong/weak/not_observed.