docs: sync command reference; drop iq_bursts.py superseded by verify_repeats_iq.py

This commit is contained in:
Lars Nolden
2026-09-01 11:44:51 +02:00
parent cafc9dff26
commit 916cd93315
3 changed files with 30 additions and 73 deletions
+28 -5
View File
@@ -36,16 +36,39 @@ setup.log DUT configuration acks
./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
./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
./result-py/bin/python3 hil/sdr_health.py # observer sensitivity
./firmware/test/run_tests.sh # frame-layer tests (ASan)
```
## DUT serial commands
All output is single-line JSON; every line the HIL parses starts with `{`.
```
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
status current configuration + duty-cycle usage
stats all counters (incl. tx_airtime_us, tx_duty_cycle_ppm)
clear_stats
radio_status chip mode, command status, device errors, RSSI
radio_reset queue a full radio re-init
probe low-level scripted SPI/IRQ/TX diagnostic with raw dumps
test_tx transmit one synthetic C1 frame
test_burst transmit the same frame twice, repeat_delay_ms apart
inject standby fault injection: leave the radio out of RX
inject sleep fault injection: destroy the radio configuration
reboot
set repeat_delay_ms N 20..200
set tx_power N -9..14 (configured SX1262 level; FEM adds gain)
set repeat_enabled 0|1
set verbose 0|1
set fem_rx_csd 0|1 KCT8103L CSD level while in RX (LNA experiment)
set pa_low 0|1 1 = lowest documented PA table
set preamble_bits N 0|8|16|24|32 preamble detector length
set duty_budget_ppm N rolling-hour TX airtime cap; 1000 = 0.1 %, 0 = off
set test_lfield N 19..200, length of synthetic test frames
set whitelist ID[,ID...] | set whitelist clear
```
## Known pitfalls