hil: SDR health gate, TX decodability proof phase, richer report
This commit is contained in:
+72
-36
@@ -1,22 +1,28 @@
|
||||
#!/usr/bin/env bash
|
||||
# Full HIL loop: discover -> (build+flash) -> capture serial+SDR -> correlate -> report.
|
||||
# Full HIL loop for the Heltec V4.3 wM-Bus C1 repeater.
|
||||
#
|
||||
# discover devices -> verify SDR actually receives -> build+flash
|
||||
# -> phase A: TX decodability proof (synthetic C1 bursts)
|
||||
# -> phase B: real-meter RX/repeat correlation
|
||||
# -> report (text + JSON), nonzero exit on FAIL
|
||||
#
|
||||
# Usage: ./hil/run.sh [--duration N] [--no-flash] [--tx-power N] [--delay MS]
|
||||
# [--gain G] [--min-repeats N]
|
||||
# Exit: 0 = PASS, nonzero = FAIL (report thresholds or infrastructure error).
|
||||
# [--gain G] [--min-repeats N] [--no-proof]
|
||||
set -euo pipefail
|
||||
cd "$(dirname "$0")/.."
|
||||
|
||||
DURATION=300
|
||||
FLASH=1
|
||||
TXPOW=-9
|
||||
DELAY=50
|
||||
DELAY=200
|
||||
GAIN=42.1
|
||||
MIN_REPEATS=1
|
||||
PROOF=1
|
||||
while [ $# -gt 0 ]; do
|
||||
case "$1" in
|
||||
--duration) DURATION=$2; shift 2 ;;
|
||||
--no-flash) FLASH=0; shift ;;
|
||||
--no-proof) PROOF=0; shift ;;
|
||||
--tx-power) TXPOW=$2; shift 2 ;;
|
||||
--delay) DELAY=$2; shift 2 ;;
|
||||
--gain) GAIN=$2; shift 2 ;;
|
||||
@@ -28,69 +34,99 @@ done
|
||||
PY=./result-py/bin/python3
|
||||
[ -x "$PY" ] || { echo "run 'nix build .#hil-python -o result-py' first" >&2; exit 2; }
|
||||
|
||||
# 1-2. discover devices (abort on ambiguity)
|
||||
# --- 1/2. discover devices (abort on ambiguity) -----------------------------
|
||||
eval "$(./tools/discover_devices.sh)"
|
||||
echo "DUT: $DUT_PORT"
|
||||
echo "SDR: Nooelec NESDR SMArt v5, index $SDR_INDEX, serial $SDR_SERIAL"
|
||||
|
||||
# 3. SDR sanity: reset USB (rtl PLL can wedge; see docs/FINDINGS.md) and
|
||||
# verify the device opens.
|
||||
usbreset 0bda:2838 >/dev/null 2>&1 || true
|
||||
sleep 1
|
||||
|
||||
# 4-6. build + flash + reset
|
||||
if [ "$FLASH" = 1 ]; then
|
||||
(cd firmware && idf.py build) >/dev/null
|
||||
(cd firmware && idf.py -p "$DUT_PORT" flash) >/dev/null 2>&1 || {
|
||||
# port re-enumerates when entering download mode; rediscover once
|
||||
sleep 2
|
||||
eval "$(./tools/discover_devices.sh)"
|
||||
(cd firmware && idf.py -p "$DUT_PORT" flash) >/dev/null
|
||||
}
|
||||
sleep 2
|
||||
eval "$(./tools/discover_devices.sh)"
|
||||
fi
|
||||
|
||||
RUN_DIR="captures/$(date +%Y-%m-%dT%H-%M-%S)-hil"
|
||||
mkdir -p "$RUN_DIR"
|
||||
echo "run dir: $RUN_DIR"
|
||||
|
||||
# 7. configure DUT + start serial capture
|
||||
$PY hil/dut_cmd.py "$DUT_PORT" --listen 2 \
|
||||
# --- 3. SDR must demonstrably receive before any capture is trusted --------
|
||||
for i in 1 2 3; do
|
||||
if $PY hil/sdr_health.py > "$RUN_DIR/sdr_health.txt" 2>&1; then break; fi
|
||||
echo "SDR unhealthy (try $i) - resetting" >&2
|
||||
usbreset 0bda:2838 >/dev/null 2>&1 || true
|
||||
sleep $((i * 5))
|
||||
done
|
||||
cat "$RUN_DIR/sdr_health.txt"
|
||||
grep -q "SDR_HEALTH=ok" "$RUN_DIR/sdr_health.txt" || {
|
||||
echo "ABORT: SDR observer is deaf; captures would be unattributable" >&2
|
||||
exit 3
|
||||
}
|
||||
|
||||
# --- 4-6. build + flash + reset --------------------------------------------
|
||||
if [ "$FLASH" = 1 ]; then
|
||||
(cd firmware && idf.py build) > "$RUN_DIR/build.log" 2>&1
|
||||
if ! (cd firmware && idf.py -p "$DUT_PORT" flash) >> "$RUN_DIR/build.log" 2>&1; then
|
||||
# the port re-enumerates when entering download mode; rediscover once
|
||||
sleep 2
|
||||
eval "$(./tools/discover_devices.sh)"
|
||||
(cd firmware && idf.py -p "$DUT_PORT" flash) >> "$RUN_DIR/build.log" 2>&1
|
||||
fi
|
||||
sleep 2
|
||||
eval "$(./tools/discover_devices.sh)"
|
||||
fi
|
||||
|
||||
# --- configure DUT --------------------------------------------------------
|
||||
$PY hil/dut_cmd.py "$DUT_PORT" --listen 3 \
|
||||
"set repeat_delay_ms $DELAY" "set tx_power $TXPOW" "clear_stats" \
|
||||
> "$RUN_DIR/setup.log" 2>&1
|
||||
|
||||
# --- phase A: TX decodability proof ---------------------------------------
|
||||
# Synthetic C1 frames, each aired twice at the repeat delay. Independent of
|
||||
# meter traffic, and (unlike real repeats) not preceded by a weak frame,
|
||||
# so it isolates "can the SDR decode our C1 TX" from bench dynamic range.
|
||||
if [ "$PROOF" = 1 ]; then
|
||||
echo "phase A: TX decodability proof"
|
||||
./hil/capture_sdr.sh 70 "$RUN_DIR/proof_sdr.log" "$GAIN" &
|
||||
SDR_PID=$!
|
||||
sleep 10
|
||||
for L in 19 60 98; do
|
||||
$PY hil/dut_cmd.py "$DUT_PORT" --listen 8 \
|
||||
"set test_lfield $L" test_burst >> "$RUN_DIR/proof_serial.log" 2>&1
|
||||
done
|
||||
wait "$SDR_PID" || true
|
||||
$PY hil/verify_tx.py --serial "$RUN_DIR/proof_serial.log" \
|
||||
--sdr "$RUN_DIR/proof_sdr.log" > "$RUN_DIR/tx_proof.txt" 2>&1 || true
|
||||
$PY hil/verify_tx.py --serial "$RUN_DIR/proof_serial.log" \
|
||||
--sdr "$RUN_DIR/proof_sdr.log" --json > "$RUN_DIR/tx_proof.json" 2>&1 || true
|
||||
cat "$RUN_DIR/tx_proof.txt"
|
||||
fi
|
||||
|
||||
# --- phase B: real meter traffic ------------------------------------------
|
||||
echo "phase B: real-meter capture (${DURATION}s)"
|
||||
$PY hil/dut_cmd.py "$DUT_PORT" --listen "$DURATION" status \
|
||||
> "$RUN_DIR/serial.log" 2>&1 &
|
||||
SERIAL_PID=$!
|
||||
|
||||
# 8. SDR capture (timeout applied to rtl_sdr itself; children die with it)
|
||||
./hil/capture_sdr.sh "$DURATION" "$RUN_DIR/rtlwmbus.log" "$GAIN" &
|
||||
SDR_PID=$!
|
||||
|
||||
# 9-12. wait for both collectors
|
||||
wait "$SDR_PID" || true
|
||||
wait "$SERIAL_PID" || true
|
||||
|
||||
# final stats snapshot
|
||||
$PY hil/dut_cmd.py "$DUT_PORT" --listen 3 stats > "$RUN_DIR/final_stats.log" 2>&1 || true
|
||||
$PY hil/dut_cmd.py "$DUT_PORT" --listen 4 stats > "$RUN_DIR/final_stats.log" 2>&1 || true
|
||||
cat "$RUN_DIR/final_stats.log" >> "$RUN_DIR/serial.log"
|
||||
|
||||
# 13-14. correlate
|
||||
# --- 13-14. correlate ------------------------------------------------------
|
||||
$PY hil/correlate.py --serial "$RUN_DIR/serial.log" --sdr "$RUN_DIR/rtlwmbus.log" \
|
||||
> "$RUN_DIR/report.json"
|
||||
--min-delay 0.010 --max-delay 0.400 > "$RUN_DIR/report.json"
|
||||
|
||||
# 15. lockup detection: heartbeats should keep arriving
|
||||
# --- 15. lockup / reset detection -----------------------------------------
|
||||
HB=$(grep -c '"event":"heartbeat"' "$RUN_DIR/serial.log" || true)
|
||||
EXPECTED_HB=$((DURATION / 10 - 2))
|
||||
if [ "$HB" -lt "$EXPECTED_HB" ]; then
|
||||
echo "WARNING: only $HB heartbeats seen (expected >= $EXPECTED_HB) - possible lockup" \
|
||||
echo "WARNING: only $HB heartbeats (expected >= $EXPECTED_HB) - possible lockup" \
|
||||
| tee "$RUN_DIR/lockup_warning.txt"
|
||||
fi
|
||||
|
||||
# 16-18. report
|
||||
# --- 16-18. report ---------------------------------------------------------
|
||||
STREAMED=$(sed -n 's/^streamed_seconds=//p' "$RUN_DIR/rtlwmbus.stats" 2>/dev/null || echo "?")
|
||||
$PY hil/report.py "$RUN_DIR/report.json" \
|
||||
--min-repeats "$MIN_REPEATS" --duration "$DURATION" \
|
||||
--tx-power "$TXPOW" --repeat-delay "$DELAY" \
|
||||
--sdr-streamed "$STREAMED" \
|
||||
--tx-proof "$RUN_DIR/tx_proof.json" \
|
||||
| tee "$RUN_DIR/report.txt"
|
||||
RC=${PIPESTATUS[0]}
|
||||
echo "artifacts: $RUN_DIR"
|
||||
|
||||
Reference in New Issue
Block a user