#!/usr/bin/env python3 """Summarise a KCT8103L CSD (LNA) A/B experiment directory.""" import json import sys from collections import Counter d = sys.argv[1] arms = [("csd_high_lna", "FEM enabled in RX (CSD high)"), ("csd_low_bypass", "FEM disabled in RX (CSD low)")] print("=" * 56) print("KCT8103L RX FRONT-END A/B (Heltec only, no SDR)") print("=" * 56) summary = {} for arm, desc in arms: rx, stats = [], None try: fh = open(f"{d}/{arm}.log", errors="replace") except OSError: print(f"\n{desc}: no data") continue for line in fh: line = line.strip() if not line.startswith("{"): continue try: ev = json.loads(line) except json.JSONDecodeError: continue if ev.get("event") == "wmbus_rx": rx.append(ev) elif ev.get("event") == "stats": stats = ev ok = [r for r in rx if r.get("crc_ok")] meters = Counter() for r in ok: raw = r.get("raw", "") if len(raw) >= 16: meters[raw[8:16].lower()] += 1 rssi = sorted(r["rssi_dbm"] for r in rx if "rssi_dbm" in r) rssi_ok = sorted(r["rssi_dbm"] for r in ok if "rssi_dbm" in r) summary[arm] = { "candidates": len(rx), "crc_ok": len(ok), "unique_meters": len(meters), "median_rssi": rssi[len(rssi) // 2] if rssi else None, "best_rssi": rssi[-1] if rssi else None, "median_rssi_crcok": rssi_ok[len(rssi_ok) // 2] if rssi_ok else None, "stats": stats, } print(f"\n{desc}") print(f" candidate frames: {len(rx)}" + (f" ({100*len(ok)/len(rx):.0f} % CRC ok)" if rx else "")) print(f" CRC-valid frames: {len(ok)}") print(f" unique meters: {len(meters)}") print(f" median RSSI (all): {summary[arm]['median_rssi']} dBm") print(f" median RSSI (CRC ok): {summary[arm]['median_rssi_crcok']} dBm") print(f" strongest RSSI: {summary[arm]['best_rssi']} dBm") if stats: print(f" firmware counters: rx_candidates={stats.get('rx_candidates')} " f"rx_valid={stats.get('rx_valid')} " f"rx_crc_fail={stats.get('rx_crc_fail')} " f"not_c1={stats.get('rx_not_c1')}") a, b = summary.get("csd_high_lna"), summary.get("csd_low_bypass") if a and b: print("\nCOMPARISON (CSD high vs CSD low)") print(f" CRC-valid frames: {a['crc_ok']} vs {b['crc_ok']}") print(f" unique meters: {a['unique_meters']} vs {b['unique_meters']}") if a["median_rssi"] is not None and b["median_rssi"] is not None: print(f" median RSSI delta: {a['median_rssi'] - b['median_rssi']} dB " f"(positive = CSD high stronger)") if a["crc_ok"] > max(3, b["crc_ok"] * 1.3): verdict = "FEM enabled in RX is clearly better" elif b["crc_ok"] > max(3, a["crc_ok"] * 1.3): verdict = "FEM disabled in RX is clearly better" else: verdict = "no clear difference at this sample size" print(f" verdict: {verdict}") print("\nNote: meter traffic varies between arms; treat small differences") print("as inconclusive unless both arms saw a comparable meter population.") json.dump(summary, open(f"{d}/summary.json", "w"), indent=2, default=str)