Alan-Jowett / sonde / 24408470577 / 1
82%
main: 82%

DEFAULT BRANCH: main
Ran
Files 111
Run time 7s
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
coverage: 80.306%. Remained the same
24408470577.1

push

github

web-flow 
docs: store-and-forward radio protocol specification (#706)

* docs: store-and-forward radio protocol specification

Add bidirectional store-and-forward data piggybacking on mandatory
WAKE/COMMAND traffic to halve radio transmissions per wake cycle.

Protocol changes:
- WAKE gains optional blob (key 10) for piggybacked uplink data
- NOP COMMAND gains optional blob (key 10) for deferred downlink data
- New section 6.7 documenting the store-and-forward data flow

BPF environment changes:
- sonde_context extended with data_start/data_end pointer pair
- New helper #17 send_async for deferred data queuing
- Async data queue documentation (max 10 messages, RAM-only)

Gateway API changes:
- DATA_REPLY gains delivery field (key 4) for deferred delivery
- New section 4.5 documenting deferred delivery semantics

New requirements and test cases across all spec documents.
Fully backward compatible: unknown CBOR keys are silently ignored.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: address review comments on store-and-forward spec

- Fix GW-0506 AC2/AC4 conflict: clarify delivery=1 overrides immediate
  send, zero-length data ignores delivery field.
- Fix T-P122 ambiguity: non-NOP COMMAND must ignore blob (return None).
- Fix T-N628/T-N629 ordering: install BPF program before WAKE/COMMAND.
- Define send_async max blob size: same as send() (223B - CBOR overhead).
- Add missing T-N627a test for send_async -2 error path.
- Clarify gateway-api: delivery field ignored when data is zero-length.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: fix T-P120/T-P121 key-absence assertions

Check decoded CBOR map for missing key 10, not raw bytes (0x0A can
appear inside other encoded values).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: address third round of review on store-and-forward spec

- protocol.md: CBOR key table narrows blob to COMMAND (NOP only);
  COMMAND blob field s... (continued)

23092 of 28755 relevant lines covered (80.31%)

189.27 hits per line

Source Files on job 24408470577.1