Alan-Jowett / sonde / 24006287891

81%

Build Type

push

github

Committed by web-flow

Commit Message

feat: add pairing-time RSSI diagnostic protocol (#512) (#644)

* feat: add pairing-time RSSI diagnostic protocol (#512)

Add DIAG_REQUEST (0x06) and DIAG_REPLY (0x85) ESP-NOW message types
and DIAG_RELAY_REQUEST / DIAG_RELAY_RESPONSE BLE envelope types for
pairing-time RF link quality diagnostics.

The pairing tool uses the node as a dumb radio relay to measure the
node-to-gateway RSSI before provisioning. The node broadcasts an opaque
ESP-NOW frame (authenticated with the phone PSK) and forwards the
gateway's reply back over BLE. The gateway measures RSSI and returns a
signal quality assessment (good/marginal/bad) with configurable
thresholds.

Specification changes (13 docs):
- protocol.md: msg_types, CBOR keys, message defs, diagnostic flow
- ble-pairing-protocol.md: BLE envelope types, relay flow (§6a)
- node-requirements.md: ND-1100–1106 (diagnostic relay)
- gateway-requirements.md: GW-1700–1706 (diagnostic handler)
- ble-pairing-tool-requirements.md: PT-1300–1308 (RSSI diagnostics)
- protocol-crate-design.md: constants, codec, message types (§12)
- node-design.md: diagnostic relay (§15.8)
- gateway-design.md: diagnostic handler (§21)
- ble-pairing-tool-design.md: RSSI diagnostic flow (§14a)
- protocol-crate-validation.md: T-P110–116
- node-validation.md: T-N1100–1110
- gateway-validation.md: T-1700–1717
- ble-pairing-tool-validation.md: T-PT-1300–1312

Implementation (sonde-protocol crate):
- \NodeMessage::DiagRequest\ and \GatewayMessage::DiagReply\ variants
- BLE relay codec: \ncode/decode_diag_relay_request/response\
- 14 new constants, 9 new tests, all passing

Gateway, node, and pairing tool implementations deferred to follow-up
PRs (require platform-specific infrastructure).

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

* feat: implement diagnostic handler across gateway, node, and pair crates

Gateway (sonde-gateway):
- \handle_diag_request()\ in engine.rs: p... (continued)

Run Details

443 of 561 new or added lines in 9 files covered. (78.97%)

1 existing line in 1 file now uncovered.

20677 of 25537 relevant lines covered (80.97%)

141.93 hits per line