1.8 KiB
1.8 KiB
Testing
One-command HIL test
nix develop --command ./hil/run.sh --duration 300
Performs: device discovery (aborts on ambiguity) -> SDR USB reset -> firmware build + flash -> DUT configuration -> concurrent serial + SDR capture -> correlation -> report (text + report.json). Exit 0 = PASS.
Useful flags:
--no-flashreuse the already-flashed firmware--duration Ncapture window seconds--tx-power Nconfigured SX1262 dBm (-9..14; FEM adds gain!)--delay MSrepeat delay (20..200)--gain GSDR tuner gain--min-repeats NPASS threshold
Artifacts
Each run writes captures/<timestamp>-hil/:
serial.log DUT JSON-lines (wmbus_rx / wmbus_tx / heartbeats / stats)
rtlwmbus.log rtl_wmbus decodes
report.json machine-readable correlation result
report.txt human-readable report
setup.log DUT configuration acks
Manual pieces
./tools/discover_devices.sh -v # device inventory
./tools/flash.sh # build + flash
./hil/capture_sdr.sh 60 /tmp/sdr.log # SDR-only capture
./result-py/bin/python3 hil/dut_cmd.py PORT --listen 10 status stats
./result-py/bin/python3 hil/iq_energy.py iq.raw # burst energy probe
./result-py/bin/python3 hil/iq_spectrum.py iq.raw # spectrum sanity
DUT serial commands
status | stats | clear_stats | radio_status | radio_reset | test_tx
set repeat_delay_ms N | set tx_power N | set repeat_enabled 0|1
set verbose 0|1 | set whitelist ID[,ID...] | set whitelist clear | reboot
Known pitfalls
- SDR PLL wedge -> gain-independent white noise;
usbreset 0bda:2838. - Never wrap the rtl pipeline in
timeout bash -c(orphans children); apply timeout tortl_sdritself. - ESP32-S3 USB re-enumerates between app CDC and ROM bootloader; flash scripts rediscover the port on failure.