preserve transport outage validation evidence

2026-08-17 14:30:56 -04:00
parent 291c6b54e6
commit 1cf0a9ac77
9 changed files with 176 additions and 26 deletions
@@ -0,0 +1,25 @@
+# Hardware outage fixtures
+
+These captures came from the assembled XIAO ESP32-C3 prototype. A temporary
+validation build made the packet writer report failure while acquisition kept
+running; that failure injection was removed before the production firmware was
+built and flashed. The files contain only complete, CRC-valid `TRK1` frames.
+
+- `forced_outage_3s.trk` — SHA-256
+  `01482816cdaa668e4681c33c8baa1df331d733b9bbcbc4f448ece25e88185ad6`.
+  It contains 2,144 contiguous samples, sequences 0 through 2,143, with no
+  reported drops, overruns, or timestamp saturation.
+- `forced_outage_7s.trk` — SHA-256
+  `2ea8a5742944bdebc13bec2ccdbceba75f0bb71e48c856b0f86285878e190cd3`.
+  It contains 1,840 delivered samples. The sole sequence gap is 511 to 650:
+  138 samples were dropped after the 512-entry queue filled, the cumulative
+  drop count reached 138, and the corresponding timestamp delta is exactly
+  1,390,000 us.
+
+`tests/test_trikke_protocol.py` verifies the hashes, parses the captures in
+fragmented chunks, and asserts these signatures so the hardware evidence remains
+executable regression data. To inspect either file manually:
+
+```sh
+python3 tools/decode_binary.py tests/fixtures/forced_outage_3s.trk /tmp/outage.csv
+```