frank/ruvnet--RuView
1
0
Fork 0
mirror of https://github.com/ruvnet/RuView synced 2026-08-01 19:01:42 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: update ADRs with ENOMEM crash fix proof (Issue #127)

Browse Source 
- ADR-018: Document rate-limiting and ENOMEM backoff safeguards in firmware
- ADR-029: Add note about rate-limiting requirement for channel hopping, mark
  lwIP pbuf exhaustion risk as resolved
- ADR-039: Add finding #5 documenting the sendto ENOMEM crash and fix
  (947 KB binary, hardware-verified 200+ callbacks with zero errors)
- CHANGELOG: Add entries for Issue #127 fix and Issue #130 provisioning fix

Co-Authored-By: claude-flow <ruv@ruv.net>
This commit is contained in:
ruv
2026-03-03 16:14:54 -05:00
parent ce171696b2
commit f995f69622
4 changed files with 14 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/adr/ADR-018-esp32-dev-implementation.md
+7
View File
@@ -96,6 +96,13 @@ static void csi_data_callback(void *ctx, wifi_csi_info_t *info) {
**No on-device FFT** (contradicting ADR-012's optional feature extraction path): The Rust aggregator will do feature extraction using the SOTA `wifi-densepose-signal` pipeline. Raw I/Q is cheaper to stream at ESP32 sampling rates (~100 Hz at 56 subcarriers = ~35 KB/s per node).
**Rate-limiting and ENOMEM backoff** (Issue #127 fix):
CSI callbacks fire 100-500+ times/sec in promiscuous mode. Two safeguards prevent lwIP pbuf exhaustion:
1. **50 Hz rate limiter** (`csi_collector.c`): `sendto()` is skipped if less than 20 ms have elapsed since the last successful send. Excess CSI callbacks are dropped silently.
2. **ENOMEM backoff** (`stream_sender.c`): When `sendto()` returns `ENOMEM` (errno 12), all sends are suppressed for 100 ms to let lwIP reclaim packet buffers. Without this, rapid-fire failed sends cause a guru meditation crash.
**`sdkconfig.defaults`** must enable:
```