docs: move development notes to NOTES.md and describe the CLI in the README

This commit is contained in:
randogoth 2026-10-25 19:19:29 +02:00
parent 76fedf2852
commit 13704a809e
3 changed files with 40 additions and 42 deletions

View file

@ -6,7 +6,7 @@ The firmware serves the same commands over USB serial and over HTTP on its own W
The firmware speaks a line protocol over the board's USB serial port (115200 baud setting, ignored by native USB). Send one command per line. Every reply is a single JSON line, except `entropy`. Errors look like `{"error":"..."}`, and settings changes confirm with `{"ok":true}`.
`tools/strix.py` (`devbox run strix <command>`) wraps the USB protocol. `strix gcp [--log file.csv] [--full]` follows the per-second trials with a live cumulative Z² − 1 and its p = 0.05 envelope, reconnects after USB dropouts and fills gaps from the device's history. The log has GCP-style rows: `13,<unix time>,<UTC date-time>,<g0>,<g1>,<g2>,<g3>` (200-bit sums, empty for unhealthy generators), after a `12,gmtime,Date/Time,g0,g1,g2,g3` header.
`tools/strix.py` wraps this protocol (see the README).
## Commands