docs: fault-injection evidence for recovery ladder

This commit is contained in:
Lars Nolden
2026-09-01 11:21:04 +02:00
parent e131687264
commit 70762362a4
2 changed files with 45 additions and 0 deletions
+15
View File
@@ -109,6 +109,21 @@
rtl_sdr probes and disables direct-sampling mode); it is not a wedge
indicator. The real symptom is railed, gain-independent noise.
## CONFIRMED (failure recovery)
- The recovery ladder works and escalates correctly, verified by fault
injection rather than assumption:
`inject standby` -> heartbeat sees chip_mode 2 -> level 1 restores RX;
`inject sleep` (configuration destroyed) -> heartbeat sees chip_mode 0 and
`config_intact:false` -> level 1 reports "failed" -> level 2 (full radio
reinit) restores RX, confirmed by chip_mode 5 + config intact + plausible
RSSI on the following heartbeats.
- Checking chip mode alone is NOT sufficient to detect a broken receiver: a
radio that lost its configuration can sit in RX looking healthy while
deaf to C1. The firmware therefore reads the sync-word registers back
every heartbeat (`config_intact`), and recovery levels only report success
when both the mode and the configuration verify.
## NEEDS TESTING
- Narrower RX bandwidth (156 kHz) vs current 234.3 kHz on weak meters.