Update HIL verification for hop-marked repeats

This commit is contained in:
Lars Nolden
2026-09-21 12:31:19 +02:00
parent a11a4b3b89
commit 8c44c54131
13 changed files with 525 additions and 309 deletions
+94 -14
View File
@@ -9,10 +9,10 @@ The only trustworthy way we have found to verify DUT transmissions in IQ:
3. Report ambient meter levels alongside -- they are the in-band health
control for the observer (deaf dongle => meters compressed => run void).
Why not fit the clock on TX events (hil/verify_repeats_iq.py, single-burst
mode): repeats fire RX + delay by construction, so an offset shifted by
-delay "matches" every repeat to its own original's burst. That artifact
produced fake "7/7 at +37 dB" confirmations. See docs/FINDINGS.md.
Why not fit the clock on TX events (the removed verify_repeats_iq.py did):
repeats fire RX + delay by construction, so an offset shifted by -delay
"matches" every repeat to its own original's burst. That artifact produced
fake "7/7 at +37 dB" confirmations. See docs/FINDINGS.md.
Usage: meter_anchored.py --iq FILE --serial FILE [--json]
"""
@@ -71,6 +71,62 @@ def fit_clock(bursts, anchors_ms, span_ms):
best = (off, m, e)
return best # offset, matched, median_err
def fsk_spectral_excess(path, db, floor, event_times_ms):
"""Return event-correlated 45 kHz FSK excess over nearby control windows."""
nfft = 2048
fft_window = np.hanning(nfft)
raw = np.memmap(path, dtype=np.uint8, mode="r")
sample_count = raw.size // 2
event_times = np.asarray(event_times_ms, dtype=float)
event_psd, control_psd = [], []
def spectrum(center):
lo = center - nfft // 2
hi = lo + nfft
if lo < 0 or hi > sample_count:
return None
values = raw[2 * lo:2 * hi].astype(np.float32) - 127.5
iq = values[0::2] + 1j * values[1::2]
return np.abs(np.fft.fftshift(np.fft.fft(iq * fft_window))) ** 2
for ts_ms in event_times:
a0, a1 = int(ts_ms) - 2, int(ts_ms) + 12
if not (0 <= a0 < a1 < len(db)):
continue
peak_bin = a0 + int(np.argmax(db[a0:a1] - floor))
event = spectrum(peak_bin * WIN + WIN // 2)
if event is None:
continue
control = None
for delta_ms in (100, 200, -100, -200):
control_bin = peak_bin + delta_ms
if not (0 <= control_bin < len(db)):
continue
if np.any(np.abs(event_times - control_bin) < 25):
continue
control = spectrum(control_bin * WIN + WIN // 2)
if control is not None:
break
if control is None:
continue
event_psd.append(event)
control_psd.append(control)
if len(event_psd) < 5:
return None, len(event_psd)
event_med = np.median(np.stack(event_psd), axis=0)
control_med = np.median(np.stack(control_psd), axis=0)
freq = np.fft.fftshift(np.fft.fftfreq(nfft, 1 / FS))
signal = (np.abs(freq) >= 20000) & (np.abs(freq) < 80000)
wide = (np.abs(freq) >= 250000) & (np.abs(freq) < 700000)
signal_db = 10 * np.log10(event_med[signal].sum()
/ control_med[signal].sum())
wide_db = 10 * np.log10(event_med[wide].sum()
/ control_med[wide].sum())
return float(signal_db - wide_db), len(event_psd)
def main():
ap = argparse.ArgumentParser()
@@ -124,19 +180,35 @@ def main():
return None
return float((db[a0:a1] - floor).max())
events = []
events, mapped_tx = [], []
for t in tx:
w = winmax(t["timestamp_us"] / 1000.0 - off)
mapped = t["timestamp_us"] / 1000.0 - off
w = winmax(mapped)
if w is None:
continue
mapped_tx.append(mapped)
events.append({"event": t.get("event", "wmbus_tx"),
"result": t.get("result"),
"window_db": round(w, 1),
"rf": bool(w >= 6)})
"above_6db": bool(w >= 6)})
meter_med = float(np.median(meter_lv)) if meter_lv else 0.0
observer = "ok" if meter_med >= 15 else ("degraded" if meter_med >= 8 else "deaf")
n_rf = sum(1 for e in events if e["rf"])
n_above = sum(1 for e in events if e["above_6db"])
levels = [e["window_db"] for e in events]
tx_med = float(np.median(levels)) if levels else None
controls = [winmax(t + 100) for t in mapped_tx]
controls = [v for v in controls if v is not None]
control_med = float(np.median(controls)) if controls else None
fsk_db, fsk_windows = fsk_spectral_excess(
args.iq, db, floor, mapped_tx)
if not events:
rf_state = "no_events"
elif fsk_db is not None and fsk_db >= 3.0:
rf_state = "strong" if tx_med >= 6.0 else "weak"
else:
rf_state = "not_observed"
report = {
"clock_matched": f"{matched}/{len(strong)}",
"clock_err_ms": round(err, 1),
@@ -144,8 +216,14 @@ def main():
"meter_median_db": round(meter_med, 1),
"observer": observer,
"tx_events": len(events),
"tx_with_rf": n_rf,
"tx_levels_db": [e["window_db"] for e in events],
"tx_above_6db": n_above,
"tx_median_db": round(tx_med, 1) if tx_med is not None else None,
"control_median_db": (round(control_med, 1)
if control_med is not None else None),
"fsk_excess_db": round(fsk_db, 1) if fsk_db is not None else None,
"fsk_windows": fsk_windows,
"rf_state": rf_state,
"tx_levels_db": levels,
}
if args.json:
print(json.dumps(report))
@@ -153,14 +231,16 @@ def main():
print(f"clock: {report['clock_matched']} anchors, err {report['clock_err_ms']} ms")
print(f"observer: {observer} (meter median +{report['meter_median_db']} dB, "
f"floor {report['floor_db']})")
print(f"TX with RF: {n_rf}/{len(events)}")
print(f"TX state: {rf_state}; median +{report['tx_median_db']} dB, "
f"FSK excess {report['fsk_excess_db']} dB")
for e in events:
print(f" {e['event']:>9} {e['result'] or '':>10} "
f"+{e['window_db']:>5.1f} dB {'RF' if e['rf'] else '--'}")
# exit 3 = observer unusable, 1 = TX dead while observer ok
f"+{e['window_db']:>5.1f} dB "
f"{'>=6dB' if e['above_6db'] else 'weak'}")
# exit 3 = observer unusable, 1 = no event-correlated FSK while observer ok
if observer == "deaf":
sys.exit(3)
sys.exit(0 if (n_rf or not events) else 1)
sys.exit(0 if rf_state in ("strong", "weak", "no_events") else 1)
if __name__ == "__main__":