Alan-Jowett / sonde / 26653918877

82%

Build Type

push

github

Committed by web-flow

Commit Message

feat: plumb modem firmware version and commit through gateway ACTUAL_STATE (#1102)

* feat: plumb modem firmware version and commit through gateway ACTUAL_STATE

Extend the MODEM_READY serial frame from 10 to 18 bytes by adding an 8-byte
\irmware_commit\ field (first 8 bytes of the git SHA-1 hash). The modem
build script now captures the full \git rev-parse HEAD\ output and embeds
the leading 8 bytes as a compile-time constant.

On the gateway side, \UsbEspNowTransport\ now parses and stores both the
firmware version (formatted as \major.minor.patch\) and the commit hash
(16-char lowercase hex, or \None\ when all-zero). A new \ModemMetadata\
struct shared via \Arc<Mutex<>>\ feeds these values into the ACTUAL_STATE
emission path. ACTUAL_STATE is re-emitted after modem handshake completion
(GW-2003 AC-9) and after modem disconnect to clear stale metadata from the
connector cache.

Specification changes span 7 docs: modem-protocol.md (§4.3 field table,
§2.3 sync recovery, §5.1 startup, §8.2a backward compat note),
modem-requirements.md (MD-0105), modem-design.md (§14.0a),
modem-validation.md (T-0101, T-0303), gateway-requirements.md (AC-9),
gateway-design.md (struct fields, §23.14 trigger), gateway-validation.md
(T-2016, T-2016a).

Tests: 2 new transport-level tests (\modem_firmware_metadata_nonzero_commit\,
\modem_firmware_metadata_zero_commit\) plus updated \ModemReady\ construction
in 4 existing test files.

Closes #1096

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Alan Jowett <alan.jowett@microsoft.com>

* fix: move ModemMetadata above misattached doc comment

The struct was inserted between the doc comment for
\mit_gateway_actual_state_from_storage\ and the function itself,
causing rustdoc to attach the wrong documentation to each item.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Alan Jowett <alan.jowett@microsoft.com>

---------

Signed-off-by: Alan Jowett <alan.jowe... (continued)

Coverage Stats

33 of 99 new or added lines in 4 files covered. (33.33%)

2 existing lines in 1 file now uncovered.

38292 of 46703 relevant lines covered (81.99%)

248.38 hits per line