mirror of
https://github.com/ruvnet/RuView
synced 2026-07-26 18:01:48 +00:00
rUv
f49c722764
The Rust port lived two directories deep (rust-port/wifi-densepose-rs/) without any sibling under rust-port/ that warranted the extra level. Move the whole workspace up to v2/ to match v1/ (Python) at the same depth and shorten every cd / build command across the repo. git mv preserves history for all tracked files. 60 files updated for path references (CI workflows, ADRs, docs, scripts, READMEs, internal .claude-flow state). Two manual fixes for relative-cd paths in CLAUDE.md and ADR-043 that became wrong after the depth change (cd ../.. → cd ..). Validated: - cargo check --workspace --no-default-features → clean (after target/ nuke; the gitignored target/ was carried by the OS rename and had hard-coded old paths in build scripts) - cargo test --workspace --no-default-features → 1,539 passed, 0 failed, 8 ignored (same totals as pre-rename) - ESP32-S3 on COM7 → still streaming live CSI (cb #40300, RSSI -64 dBm) After-merge follow-up: contributors should `rm -rf v2/target` once and let cargo regenerate from the new path.
99 lines
3.9 KiB
Markdown
99 lines
3.9 KiB
Markdown
# wifi-densepose-wifiscan
|
|
|
|
[](https://crates.io/crates/wifi-densepose-wifiscan)
|
|
[](https://docs.rs/wifi-densepose-wifiscan)
|
|
[](LICENSE)
|
|
|
|
Multi-BSSID WiFi scanning for Windows-enhanced DensePose sensing (ADR-022).
|
|
|
|
## Overview
|
|
|
|
`wifi-densepose-wifiscan` implements the BSSID Acquisition bounded context for the WiFi-DensePose
|
|
system. It discovers and tracks nearby WiFi access points, parses platform-specific scan output,
|
|
and feeds multi-AP signal data into a sensing pipeline that performs motion detection, breathing
|
|
estimation, attention weighting, and fingerprint matching.
|
|
|
|
The crate uses `#[forbid(unsafe_code)]` and is designed as a pure-Rust domain layer with
|
|
pluggable platform adapters.
|
|
|
|
## Features
|
|
|
|
- **BSSID registry** -- Tracks observed access points with running RSSI statistics, band/radio
|
|
type classification, and metadata. Types: `BssidId`, `BssidObservation`, `BssidRegistry`,
|
|
`BssidEntry`.
|
|
- **Netsh adapter** (Tier 1) -- Parses `netsh wlan show networks mode=bssid` output into
|
|
structured `BssidObservation` records. Zero platform dependencies.
|
|
- **WLAN API scanner** (Tier 2, `wlanapi` feature) -- Async scanning via the Windows WLAN API
|
|
with `tokio` integration.
|
|
- **Multi-AP frame** -- `MultiApFrame` aggregates observations from multiple BSSIDs into a single
|
|
timestamped frame for downstream processing.
|
|
- **Sensing pipeline** (`pipeline` feature) -- `WindowsWifiPipeline` orchestrates motion
|
|
detection, breathing estimation, attention-weighted AP selection, and location fingerprint
|
|
matching.
|
|
|
|
### Feature flags
|
|
|
|
| Flag | Default | Description |
|
|
|------------|---------|------------------------------------------------------|
|
|
| `serde` | yes | Serialization for domain types |
|
|
| `pipeline` | yes | WindowsWifiPipeline sensing orchestration |
|
|
| `wlanapi` | no | Tier 2 async scanning via tokio (Windows WLAN API) |
|
|
|
|
## Quick Start
|
|
|
|
```rust
|
|
use wifi_densepose_wifiscan::{
|
|
NetshBssidScanner, BssidRegistry, WlanScanPort,
|
|
};
|
|
|
|
// Parse netsh output (works on any platform for testing)
|
|
let netsh_output = "..."; // output of `netsh wlan show networks mode=bssid`
|
|
let observations = wifi_densepose_wifiscan::parse_netsh_output(netsh_output);
|
|
|
|
// Register observations
|
|
let mut registry = BssidRegistry::new();
|
|
for obs in &observations {
|
|
registry.update(obs);
|
|
}
|
|
|
|
println!("Tracking {} access points", registry.len());
|
|
```
|
|
|
|
With the `pipeline` feature enabled:
|
|
|
|
```rust
|
|
use wifi_densepose_wifiscan::WindowsWifiPipeline;
|
|
|
|
let pipeline = WindowsWifiPipeline::new();
|
|
// Feed MultiApFrame data into the pipeline for sensing...
|
|
```
|
|
|
|
## Architecture
|
|
|
|
```text
|
|
wifi-densepose-wifiscan/src/
|
|
lib.rs -- Re-exports, feature gates
|
|
domain/
|
|
bssid.rs -- BssidId, BssidObservation, BandType, RadioType
|
|
registry.rs -- BssidRegistry, BssidEntry, BssidMeta, RunningStats
|
|
frame.rs -- MultiApFrame (multi-BSSID aggregated frame)
|
|
result.rs -- EnhancedSensingResult
|
|
port.rs -- WlanScanPort trait (platform abstraction)
|
|
adapter.rs -- NetshBssidScanner (Tier 1), WlanApiScanner (Tier 2)
|
|
pipeline.rs -- WindowsWifiPipeline (motion, breathing, attention, fingerprint)
|
|
error.rs -- WifiScanError
|
|
```
|
|
|
|
## Related Crates
|
|
|
|
| Crate | Role |
|
|
|-------|------|
|
|
| [`wifi-densepose-signal`](../wifi-densepose-signal) | Advanced CSI signal processing |
|
|
| [`wifi-densepose-vitals`](../wifi-densepose-vitals) | Vital sign extraction from CSI |
|
|
| [`wifi-densepose-hardware`](../wifi-densepose-hardware) | ESP32 and other hardware interfaces |
|
|
| [`wifi-densepose-mat`](../wifi-densepose-mat) | Disaster detection using multi-AP data |
|
|
|
|
## License
|
|
|
|
MIT OR Apache-2.0
|