#!/usr/bin/env python3 """Render a human-readable HIL report from correlate.py JSON. Usage: report.py report.json [--min-repeats N] [--min-rx-rate PCT] Exit code 0 = PASS, 1 = FAIL. """ import argparse import json import sys ap = argparse.ArgumentParser() ap.add_argument("report") ap.add_argument("--min-repeats", type=int, default=1, help="minimum SDR-verified repeats for PASS") ap.add_argument("--min-rx-rate", type=float, default=0, help="minimum Heltec RX match rate in %% for PASS") ap.add_argument("--duration", type=float, default=0) ap.add_argument("--tx-power", default="?") ap.add_argument("--repeat-delay", default="?") args = ap.parse_args() r = json.load(open(args.report)) d = r.get("repeat_delay_ms") or {} fw = r.get("firmware_events") or {} fail_reasons = [] if r.get("sdr_originals", 0) == 0: fail_reasons.append("SDR saw no original meter frames") if r.get("heltec_rx", 0) == 0: fail_reasons.append("Heltec received nothing") if r.get("sdr_repeats", 0) < args.min_repeats: fail_reasons.append( f"SDR-verified repeats {r.get('sdr_repeats', 0)} < {args.min_repeats}") if args.min_rx_rate and (r.get("rx_match_rate_pct") or 0) < args.min_rx_rate: fail_reasons.append("RX match rate below threshold") if fw.get("boots", 0) > 1: fail_reasons.append(f"unexpected MCU resets: {fw.get('boots', 0) - 1}") verdict = "PASS" if not fail_reasons else "FAIL" W = 50 print("=" * W) print("SOLENOS WMBUS HIL TEST") print("=" * W) print(f""" DUT: Heltec WiFi LoRa 32 V4.3 (HTIT-WB32LAF) RF: frequency: 868.950 MHz mode: C1 configured TX power: {args.tx_power} dBm repeat delay: {args.repeat_delay} ms TEST: duration: {args.duration:.0f} s SDR: frames total: {r.get('sdr_frames_total')} C1 CRC-ok: {r.get('sdr_c1_crc_ok')} originals: {r.get('sdr_originals')} unique meters: {len(r.get('per_meter') or {})} HELTEC RX: frames: {r.get('heltec_rx')} crc ok: {r.get('heltec_rx_crc_ok')} matched originals: {r.get('rx_matched')} match rate: {r.get('rx_match_rate_pct')} % HELTEC TX: attempts: {r.get('heltec_tx_attempts')} reported success: {r.get('heltec_tx_ok')} SDR VERIFIED REPEATS: matched: {r.get('sdr_repeats')} fully correlated: {r.get('fully_correlated_repeats')} success rate: {r.get('repeat_success_rate_pct')} % TIMING: median repeat delay: {d.get('median')} ms minimum: {d.get('min')} ms maximum: {d.get('max')} ms ERRORS: radio recoveries: {fw.get('recoveries')} MCU boots seen: {fw.get('boots')} """) if r.get("per_meter"): print(f"{'METER':>10} {'SDR':>6} {'HELTEC':>7} {'MATCHED':>8}") for m, v in sorted(r["per_meter"].items()): print(f"{m:>10} {v['sdr']:>6} {v['heltec']:>7} {v['matched']:>8}") print() if fail_reasons: print("FAIL REASONS:") for fr in fail_reasons: print(f" - {fr}") print() print(f"RESULT:\n {verdict}") sys.exit(0 if verdict == "PASS" else 1)