mirror of
https://github.com/ruvnet/RuView
synced 2026-08-11 20:41:44 +00:00
ADR-081: implement Layers 1/2/4 end-to-end + host tests + QEMU hooks
Turns the ADR-081 scaffolding into a working adaptive CSI mesh kernel:
Layer 1 radio abstraction has an ESP32 binding and a mock binding; Layer 2
adaptive controller runs on FreeRTOS timers; Layer 4 feature-state packet
is emitted at 5 Hz by default, replacing raw ADR-018 CSI as the default
upstream.
New files:
firmware/esp32-csi-node/main/adaptive_controller_decide.c (pure policy)
firmware/esp32-csi-node/main/rv_radio_ops_mock.c (QEMU binding)
firmware/esp32-csi-node/tests/host/Makefile (host tests)
firmware/esp32-csi-node/tests/host/test_adaptive_controller.c
firmware/esp32-csi-node/tests/host/test_rv_feature_state.c
firmware/esp32-csi-node/tests/host/esp_err.h (shim)
firmware/esp32-csi-node/tests/host/.gitignore
Modified:
adaptive_controller.c — includes pure decide.c; emit_feature_state()
wired into fast loop (200 ms = 5 Hz)
rv_radio_ops_esp32.c — get_health() fills pkt_yield + send_fail
csi_collector.{c,h} — pkt_yield/send_fail accessors (ADR-081 L1)
rv_feature_state.h — packed size corrected to 60 bytes
(was incorrectly 80 in initial commit)
main.c — mock binding registered under mock CSI
CMakeLists.txt — rv_radio_ops_mock.c under CSI_MOCK_ENABLED
scripts/validate_qemu_output.py — 3 new ADR-081 checks (17/18/19)
docs/adr/ADR-081-*.md — status → Accepted (partial);
implementation-status matrix; measured
benchmarks (decide 3.2 ns, CRC32 614 ns);
bandwidth 300 B/s @ 5 Hz (99.7% vs raw);
verification section
CHANGELOG.md — artifact-level entries
Tests (host, gcc -O2 -std=c11):
test_adaptive_controller: 18/18 pass, decide() = 3.2 ns/call
test_rv_feature_state: 15/15 pass, CRC32(56 B) = 614 ns/pkt, 87 MB/s
sizeof(rv_feature_state_t) == 60 asserted
IEEE CRC32 known vectors verified
Deferred (tracked in ADR-081 roadmap Phase 3/4):
Layer 3 mesh-plane message types, role-assignment FSM, Rust-side mirror
trait in crates/wifi-densepose-hardware/src/radio_ops.rs.
This commit is contained in:
@@ -308,6 +308,43 @@ uint8_t csi_collector_get_node_id(void)
|
||||
return s_node_id;
|
||||
}
|
||||
|
||||
/* ---- ADR-081: packet yield accessor for the radio abstraction layer ---- */
|
||||
|
||||
uint16_t csi_collector_get_pkt_yield_per_sec(void)
|
||||
{
|
||||
/* Simple sliding window: record the callback count at ~1 s ago, return
|
||||
* the delta. Called from adaptive_controller's fast loop (200 ms), so
|
||||
* we update the snapshot every ~5 calls. */
|
||||
static int64_t s_yield_window_start_us = 0;
|
||||
static uint32_t s_yield_window_start_cb = 0;
|
||||
static uint16_t s_last_yield = 0;
|
||||
|
||||
int64_t now = esp_timer_get_time();
|
||||
if (s_yield_window_start_us == 0) {
|
||||
s_yield_window_start_us = now;
|
||||
s_yield_window_start_cb = s_cb_count;
|
||||
return 0;
|
||||
}
|
||||
int64_t elapsed = now - s_yield_window_start_us;
|
||||
if (elapsed < 1000000LL) {
|
||||
return s_last_yield;
|
||||
}
|
||||
uint32_t delta = s_cb_count - s_yield_window_start_cb;
|
||||
/* Scale back to per-second if the window ran long (shouldn't, but be safe). */
|
||||
uint64_t per_sec = ((uint64_t)delta * 1000000ULL) / (uint64_t)elapsed;
|
||||
if (per_sec > 0xFFFFu) per_sec = 0xFFFFu;
|
||||
s_last_yield = (uint16_t)per_sec;
|
||||
s_yield_window_start_us = now;
|
||||
s_yield_window_start_cb = s_cb_count;
|
||||
return s_last_yield;
|
||||
}
|
||||
|
||||
uint16_t csi_collector_get_send_fail_count(void)
|
||||
{
|
||||
uint32_t f = s_send_fail;
|
||||
return (f > 0xFFFFu) ? 0xFFFFu : (uint16_t)f;
|
||||
}
|
||||
|
||||
/* ---- ADR-029: Channel hopping ---- */
|
||||
|
||||
void csi_collector_set_hop_table(const uint8_t *channels, uint8_t hop_count, uint32_t dwell_ms)
|
||||
|
||||
Reference in New Issue
Block a user