ruvnet--RuView/v2/crates/wifi-densepose-hardware

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

Flag	Default	Description
std	yes	Standard library support
esp32	no	ESP32 serial CSI frame parsing
intel5300	no	Intel 5300 CSI Tool log parsing
linux-wifi	no	Linux WiFi interface for commodity sensing

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

Crate	Role
wifi-densepose-core	Foundation types (CsiFrame definitions)
wifi-densepose-signal	Consumes parsed CSI data for processing
wifi-densepose-mat	Uses hardware adapters for disaster detection
wifi-densepose-vitals	Vital sign extraction from parsed frames

License

MIT OR Apache-2.0