mirror of
https://github.com/ruvnet/RuView.git
synced 2026-04-28 14:09:33 +00:00
d53e29506e
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.
83 lines
2.9 KiB
C
83 lines
2.9 KiB
C
/**
|
|
* @file adaptive_controller_decide.c
|
|
* @brief ADR-081 Layer 2 — pure decision policy.
|
|
*
|
|
* Extracted so host unit tests can link this without ESP-IDF / FreeRTOS.
|
|
* adaptive_controller.c includes this file; the host Makefile links it
|
|
* directly against the test harness.
|
|
*/
|
|
|
|
#include <string.h>
|
|
#include "adaptive_controller.h"
|
|
#include "rv_radio_ops.h"
|
|
|
|
void adaptive_controller_decide(const adapt_config_t *cfg,
|
|
adapt_state_t current,
|
|
const adapt_observation_t *obs,
|
|
adapt_decision_t *out)
|
|
{
|
|
if (cfg == NULL || obs == NULL || out == NULL) {
|
|
return;
|
|
}
|
|
memset(out, 0, sizeof(*out));
|
|
out->new_state = (uint8_t)current;
|
|
out->new_profile = RV_PROFILE_PASSIVE_LOW_RATE;
|
|
|
|
/* Degraded gate: pkt yield collapse or severe coherence loss → DEGRADED. */
|
|
if (obs->pkt_yield_per_sec < cfg->min_pkt_yield ||
|
|
obs->node_coherence < 0.20f) {
|
|
if (current != ADAPT_STATE_DEGRADED) {
|
|
out->change_state = true;
|
|
out->new_state = ADAPT_STATE_DEGRADED;
|
|
}
|
|
out->change_profile = (current != ADAPT_STATE_DEGRADED);
|
|
out->new_profile = RV_PROFILE_PASSIVE_LOW_RATE;
|
|
out->suggested_vital_interval_ms = 2000;
|
|
return;
|
|
}
|
|
|
|
/* Anomaly trumps motion. */
|
|
if (obs->anomaly_score >= cfg->anomaly_threshold) {
|
|
if (current != ADAPT_STATE_ALERT) {
|
|
out->change_state = true;
|
|
out->new_state = ADAPT_STATE_ALERT;
|
|
}
|
|
out->change_profile = true;
|
|
out->new_profile = RV_PROFILE_FAST_MOTION;
|
|
out->suggested_vital_interval_ms = 100;
|
|
return;
|
|
}
|
|
|
|
/* Motion → SENSE_ACTIVE with FAST_MOTION profile. */
|
|
if (obs->motion_score >= cfg->motion_threshold) {
|
|
if (current != ADAPT_STATE_SENSE_ACTIVE) {
|
|
out->change_state = true;
|
|
out->new_state = ADAPT_STATE_SENSE_ACTIVE;
|
|
}
|
|
out->change_profile = true;
|
|
out->new_profile = RV_PROFILE_FAST_MOTION;
|
|
out->suggested_vital_interval_ms = cfg->aggressive ? 100 : 200;
|
|
return;
|
|
}
|
|
|
|
/* Stable presence + quiet → high-sensitivity respiration. */
|
|
if (obs->presence_score >= 0.5f && obs->motion_score < 0.05f) {
|
|
if (current != ADAPT_STATE_SENSE_IDLE) {
|
|
out->change_state = true;
|
|
out->new_state = ADAPT_STATE_SENSE_IDLE;
|
|
}
|
|
out->change_profile = true;
|
|
out->new_profile = RV_PROFILE_RESP_HIGH_SENS;
|
|
out->suggested_vital_interval_ms = 1000;
|
|
return;
|
|
}
|
|
|
|
/* Default: passive low rate. */
|
|
if (current != ADAPT_STATE_SENSE_IDLE) {
|
|
out->change_state = true;
|
|
out->new_state = ADAPT_STATE_SENSE_IDLE;
|
|
}
|
|
out->change_profile = (current != ADAPT_STATE_SENSE_IDLE);
|
|
out->new_profile = RV_PROFILE_PASSIVE_LOW_RATE;
|
|
out->suggested_vital_interval_ms = cfg->aggressive ? 500 : 1000;
|
|
}
|