ESP32 CSI Node Firmware

Quick Start

0. Pre-built binaries (v0.6.5 — skip the build step)

1. Build (Docker -- the only reliable method)

2. Flash

3. Provision WiFi credentials (no reflash needed)

4. Start the sensing server

5. Open the UI

6. (Optional) Upload a WASM sensing module

Hardware Requirements

Firmware Architecture

Tier 0 -- Raw CSI Passthrough (Stable)

Tier 1 -- Basic DSP (Stable)

Tier 2 -- Full Pipeline (Stable)

What this firmware does NOT do (Tier 2 caveats)

Tier 3 -- WASM Programmable Sensing (Alpha)

Wire Protocols

ADR-018 Binary Frame Format

Vitals Packet (32 bytes)

Building

Prerequisites

Build Command

Custom Configuration

Flashing

Serial Monitor

Runtime Configuration (NVS)

Provisioning Script

NVS Key Reference

Network Settings

Channel Hopping and TDM (ADR-029)

Edge Intelligence (ADR-039)

WASM Programmable Sensing (ADR-040)

Kconfig Menus

"CSI Node Configuration"

"Edge Intelligence (ADR-039)"

"WASM Programmable Sensing (ADR-040)"

WASM Programmable Sensing (Tier 3)

Overview

RVF (RuVector Format)

Host API

Module Lifecycle

HTTP Management Endpoints

Included WASM Modules

Safety Features

Memory Budget

Source Files

Architecture Diagram

CI/CD

QEMU Testing (ADR-061)

Prerequisites

Quick Start

Mock CSI Scenarios

NVS Provisioning Matrix

Validation Checks

GDB Debugging

Code Coverage

Fuzz Testing

QEMU CI Workflow

Troubleshooting

Windows Firewall Rule

Architecture Decision Records

License