Update HIL verification for hop-marked repeats
This commit is contained in:
+94
-14
@@ -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__":
|
||||
|
||||
Reference in New Issue
Block a user