wifi-densepose-hardware

Hardware interface abstractions for WiFi CSI sensors (ESP32, Intel 5300, Atheros).

Overview

wifi-densepose-hardware provides platform-agnostic parsers for WiFi CSI data from multiple hardware sources. All parsing operates on byte buffers with no C FFI or hardware dependencies at compile time, making the crate fully portable and deterministic -- the same bytes in always produce the same parsed output.

RTL8720F radar simulator (ADR-263/264)

Until Realtek hardware and the radar report SDK arrive, the Rust-only simulator exercises the same versioned CFR/Range-FFT wire codec used by the future device adapter. Every frame is marked SYNTHETIC.

cargo run -p wifi-densepose-hardware --bin rtl8720f-sim -- `
  --frames 100 --seed 0x8720f123456789ab `
  --output rtl8720f-synthetic.rtr

Add --udp 127.0.0.1:5005 --realtime to stream one ADR-264 frame per UDP datagram. Replay files contain a little-endian u32 frame length followed by the encoded frame.

MediaTek Filogic CSI simulator (ADR-266/267)

The Rust-only simulator models bounded MIMO CSI for MT7981/MT7976, MT7986/MT7975, and MT7988/MT7996 profiles without claiming an undocumented MediaTek firmware ABI. Every frame is marked SYNTHETIC.

cargo run -p wifi-densepose-hardware --bin mediatek-csi-sim -- `
  --profile mt7981 --frames 100 --output mediatek-synthetic.mtc

Add --udp 127.0.0.1:5005 --realtime to stream one CRC-protected ADR-267 frame per UDP datagram. Physical support remains gated on a documented mt76 or MediaTek firmware channel-estimate export.

Features

• ESP32 binary parser -- Parses ADR-018 binary CSI frames streamed over UDP from ESP32 and ESP32-S3 devices.
• UDP aggregator -- Receives and aggregates CSI frames from multiple ESP32 nodes (ADR-018 Layer 2). Provided as a standalone binary.
• Bridge -- Converts hardware CsiFrame into the CsiData format expected by the detection pipeline (ADR-018 Layer 3).
• No mock data -- Parsers either parse real bytes or return explicit ParseError values. There are no synthetic fallbacks.
• Pure byte-buffer parsing -- No FFI to ESP-IDF or kernel modules. Safe to compile and test on any platform.

Feature flags

Quick Start

use wifi_densepose_hardware::{CsiFrame, Esp32CsiParser, ParseError};

// Parse ESP32 CSI data from raw UDP bytes
let raw_bytes: &[u8] = &[/* ADR-018 binary frame */];
match Esp32CsiParser::parse_frame(raw_bytes) {
    Ok((frame, consumed)) => {
        println!("Parsed {} subcarriers ({} bytes)",
                 frame.subcarrier_count(), consumed);
        let (amplitudes, phases) = frame.to_amplitude_phase();
        // Feed into detection pipeline...
    }
    Err(ParseError::InsufficientData { needed, got }) => {
        eprintln!("Need {} bytes, got {}", needed, got);
    }
    Err(e) => eprintln!("Parse error: {}", e),
}

Architecture

wifi-densepose-hardware/src/
  lib.rs            -- Re-exports: CsiFrame, Esp32CsiParser, ParseError, CsiData
  csi_frame.rs      -- CsiFrame, CsiMetadata, SubcarrierData, Bandwidth, AntennaConfig
  esp32_parser.rs   -- Esp32CsiParser (ADR-018 binary protocol)
  error.rs          -- ParseError
  bridge.rs         -- CsiData bridge to detection pipeline
  aggregator/       -- UDP multi-node frame aggregator (binary)

Related Crates

License

MIT OR Apache-2.0