# RF Front-End (KCT8103L) Observations ## Important caveat about the observer The Nooelec dongle used as reference receiver is not a stable instrument on this bench. Measured with `hil/sdr_health.py`: ``` fresh after replug : mean power @42.1 dB gain ~ +22 dB, spectrum span ~51 dB, noise tracks gain by ~25 dB -> "full" after minutes of continuous streaming: mean power ~ +5 dB, span ~18-21 dB, noise tracks gain by ~8 dB -> "degraded" wedged / bypassed : railed ~ +40 dB, span < 10 dB, noise does not track gain -> "deaf" ``` The drop from "full" to "degraded" is roughly 17 dB of sensitivity and happens within minutes. Every reported comparison therefore carries the observer state, and cross-run comparisons at "the same gain" are invalid. This is why `hil/capture_both.sh` derives meter decodes and our own TX measurements from a *single* rtl_sdr stream. An earlier draft of this document claimed a 97 % Heltec-vs-SDR match rate. That number was taken while the dongle was degraded (it decoded far fewer originals, so the Heltec matched nearly all of them) and is withdrawn. ## Measured RX performance vs the SDR 600 s run, `captures/2026-09-01T09-22-28-hil`, gain 42.1 dB, observer state "degraded", CSD high (FEM enabled in RX): ``` SDR classified originals : 41 Heltec RX candidates : 122 (CRC ok: 56) matched originals : 24 -> 58.5 % of SDR originals unique meters seen : 35 (union of both receivers) ``` Neither receiver dominates. In the per-meter table of that run: - meters where both agree, e.g. 61471660 (6 SDR / 6 Heltec / 6 matched), 04774139 (3/3/3), 04769582 (2/2/2); - meters only the SDR decoded, e.g. 04766714 (3/0), 04766710 (3/0), 04769365 (2/0), 04766705 (2/0); - meters only the Heltec decoded, e.g. 20898871 (0/4), 67537334 (0/3), 04767753 (0/3). So the SX1262 + KCT8103L chain is broadly comparable to an R820T dongle with a whip antenna at this location, with per-meter differences that are most likely antenna-pattern and multipath effects rather than a systematic sensitivity gap. ## RSSI vs CRC success (Heltec, chip-referred RSSI) 15-minute run, 166 candidate frames: | RSSI bucket | CRC ok | CRC fail | success | |---|---|---|---| | >= -50 dBm | 3 | 0 | 100 % | | -60..-51 | 38 | 3 | 93 % | | -70..-61 | 24 | 86 | 22 % | | -80..-71 | 0 | 11 | 0 % | | <= -100 | 0 | 1 | 0 % | Interpretation: the usable working point with the current configuration is about -65 dBm chip-referred and better. Below that, frames are still detected (sync matches, length parses) but accumulate bit errors. Failures concentrate in long (100-118 byte) Techem frames, consistent with errors accumulating over frame length rather than a hard sensitivity floor. Firmware counters from the 600 s run corroborate the shape: `rx_candidates=178, rx_valid=58, rx_crc_fail=66, rx_not_c1=54` (`rx_not_c1` are sync matches that are not C-mode: T1 traffic and false syncs from the deliberately short 8-bit preamble detector). ## LNA / CSD experiment - MEASURED `set fem_rx_csd 0|1` controls the KCT8103L CSD level while in RX (high = FEM enabled/LNA path, low = FEM disabled). TX always forces CSD high. `hil/lna_ab.sh` runs two equal-length RX-only arms (retransmission disabled, so the receiver is measured in isolation). Result, 600 s per arm, `captures/2026-09-01T10-55-00-lna-ab`: | | CSD high (FEM enabled) | CSD low (FEM disabled) | |---|---|---| | candidate frames | 108 | 5 | | CRC-valid frames | 35 | 5 | | unique meters | 18 | 1 | | median RSSI (all) | -61 dBm | -102 dBm | | median RSSI (CRC ok) | -53 dBm | -102 dBm | | strongest RSSI | -45 dBm | -101 dBm | | firmware counters | candidates=190, valid=34, crc_fail=73, not_c1=83 | candidates=8, valid=5, crc_fail=0, not_c1=3 | **Conclusion: the KCT8103L RX path is essential.** Disabling it costs about 41 dB of chip-referred signal level and cuts the visible meter population from 18 to 1. CSD must be held high in RX. Two secondary observations: - With CSD low the few frames that still arrive decode with 100 % CRC success at -102 dBm. Signal and noise both drop with the FEM disabled, so SNR survives for the single strongest local meter; chip-referred RSSI is therefore not comparable across arms as an SNR measure. - No sign of the "too much gain hurts" failure mode at this site: the high-gain arm saw strictly more meters with no CRC collapse on strong frames. Excessive front-end gain was a plausible risk given strong 868 MHz neighbours, but it is not what limits this bench. Cost of the sensitive configuration: with CSD high, 83 of 190 sync matches (44 %) were not C-mode (`rx_not_c1`) - T1 traffic plus false syncs from the deliberately short 8-bit preamble detector. Each false sync consumes one fixed-255-byte RX window (~12 ms, docs/TIMING.md). ## Bench dynamic-range limitation Measured on a single stream (`iq_proof.json` of the 600 s run): ``` our transmissions : median +12.9 dB over noise floor (min 6.2, max 38.5) meter transmissions: median +9.8 dB over noise floor (min 6.0, max 37.2) clipped ADC samples: 0.006 % of the capture ``` In the *degraded* observer state the levels overlap and clipping is 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 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. 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. 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 Same bench, same gain (42.1 dB), only the repeat delay changed: | repeat delay | repeats decoded by SDR | |---|---| | 50 ms | 2 / 63 (3 %) | | 200 ms | 6 / 20 (30 %) | A longer gap gives the rtl-wmbus demodulator time to recover its level estimate after the weak original before the much stronger repeat arrives. The HIL default is therefore 200 ms, still inside the 20-200 ms development range. This is an artefact of the observer, not the repeater: the firmware's own repeat delay measures 200.0 ms min/median/max. ## Verification strategy that follows from all this 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 `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.