feat: Sensing-only UI mode with Gaussian splat visualization and Rust migration ADR
- Add Python WebSocket sensing server (ws_server.py) with ESP32 UDP CSI and Windows RSSI auto-detect collectors on port 8765 - Add Three.js Gaussian splat renderer with custom GLSL shaders for real-time WiFi signal field visualization (blue→green→red gradient) - Add SensingTab component with RSSI sparkline, feature meters, and motion classification badge - Add sensing.service.js WebSocket client with reconnect and simulation fallback - Implement sensing-only mode: suppress all DensePose API calls when FastAPI backend (port 8000) is not running, clean console output - ADR-019: Document sensing-only UI architecture and data flow - ADR-020: Migrate AI/model inference to Rust with RuVector ONNX Runtime, replacing ~2.7GB Python stack with ~50MB static binary - Add ruvnet/ruvector as upstream remote for RuVector crate ecosystem Co-Authored-By: claude-flow <ruv@ruv.net>
This commit is contained in:
@@ -444,3 +444,161 @@ class SimulatedCollector:
|
||||
retry_count=max(0, index // 100),
|
||||
interface="sim0",
|
||||
)
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Windows WiFi collector (real hardware via netsh)
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
class WindowsWifiCollector:
|
||||
"""
|
||||
Collects real RSSI data from a Windows WiFi interface.
|
||||
|
||||
Data source: ``netsh wlan show interfaces`` which provides RSSI in dBm,
|
||||
signal quality percentage, channel, band, and connection state.
|
||||
|
||||
Parameters
|
||||
----------
|
||||
interface : str
|
||||
WiFi interface name (default ``"Wi-Fi"``). Must match the ``Name``
|
||||
field shown by ``netsh wlan show interfaces``.
|
||||
sample_rate_hz : float
|
||||
Target sampling rate in Hz (default 2.0). Windows ``netsh`` is slow
|
||||
(~200-400ms per call) so rates above 2 Hz may not be achievable.
|
||||
buffer_seconds : int
|
||||
Ring buffer capacity in seconds (default 120).
|
||||
"""
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
interface: str = "Wi-Fi",
|
||||
sample_rate_hz: float = 2.0,
|
||||
buffer_seconds: int = 120,
|
||||
) -> None:
|
||||
self._interface = interface
|
||||
self._rate = sample_rate_hz
|
||||
self._buffer = RingBuffer(max_size=int(sample_rate_hz * buffer_seconds))
|
||||
self._running = False
|
||||
self._thread: Optional[threading.Thread] = None
|
||||
self._cumulative_tx: int = 0
|
||||
self._cumulative_rx: int = 0
|
||||
|
||||
# -- public API ----------------------------------------------------------
|
||||
|
||||
@property
|
||||
def sample_rate_hz(self) -> float:
|
||||
return self._rate
|
||||
|
||||
def start(self) -> None:
|
||||
if self._running:
|
||||
return
|
||||
self._validate_interface()
|
||||
self._running = True
|
||||
self._thread = threading.Thread(
|
||||
target=self._sample_loop, daemon=True, name="win-rssi-collector"
|
||||
)
|
||||
self._thread.start()
|
||||
logger.info(
|
||||
"WindowsWifiCollector started on '%s' at %.1f Hz",
|
||||
self._interface,
|
||||
self._rate,
|
||||
)
|
||||
|
||||
def stop(self) -> None:
|
||||
self._running = False
|
||||
if self._thread is not None:
|
||||
self._thread.join(timeout=2.0)
|
||||
self._thread = None
|
||||
logger.info("WindowsWifiCollector stopped")
|
||||
|
||||
def get_samples(self, n: Optional[int] = None) -> List[WifiSample]:
|
||||
if n is not None:
|
||||
return self._buffer.get_last_n(n)
|
||||
return self._buffer.get_all()
|
||||
|
||||
def collect_once(self) -> WifiSample:
|
||||
return self._read_sample()
|
||||
|
||||
# -- internals -----------------------------------------------------------
|
||||
|
||||
def _validate_interface(self) -> None:
|
||||
try:
|
||||
result = subprocess.run(
|
||||
["netsh", "wlan", "show", "interfaces"],
|
||||
capture_output=True, text=True, timeout=5.0,
|
||||
)
|
||||
if self._interface not in result.stdout:
|
||||
raise RuntimeError(
|
||||
f"WiFi interface '{self._interface}' not found. "
|
||||
f"Check 'netsh wlan show interfaces' for the correct name."
|
||||
)
|
||||
if "disconnected" in result.stdout.lower().split(self._interface.lower())[1][:200]:
|
||||
raise RuntimeError(
|
||||
f"WiFi interface '{self._interface}' is disconnected. "
|
||||
f"Connect to a WiFi network first."
|
||||
)
|
||||
except FileNotFoundError:
|
||||
raise RuntimeError(
|
||||
"netsh not found. This collector requires Windows."
|
||||
)
|
||||
|
||||
def _sample_loop(self) -> None:
|
||||
interval = 1.0 / self._rate
|
||||
while self._running:
|
||||
t0 = time.monotonic()
|
||||
try:
|
||||
sample = self._read_sample()
|
||||
self._buffer.append(sample)
|
||||
except Exception:
|
||||
logger.exception("Error reading WiFi sample")
|
||||
elapsed = time.monotonic() - t0
|
||||
sleep_time = max(0.0, interval - elapsed)
|
||||
if sleep_time > 0:
|
||||
time.sleep(sleep_time)
|
||||
|
||||
def _read_sample(self) -> WifiSample:
|
||||
result = subprocess.run(
|
||||
["netsh", "wlan", "show", "interfaces"],
|
||||
capture_output=True, text=True, timeout=5.0,
|
||||
)
|
||||
rssi = -80.0
|
||||
signal_pct = 0.0
|
||||
|
||||
for line in result.stdout.splitlines():
|
||||
stripped = line.strip()
|
||||
# "Rssi" line contains the raw dBm value (available on Win10+)
|
||||
if stripped.lower().startswith("rssi"):
|
||||
try:
|
||||
rssi = float(stripped.split(":")[1].strip())
|
||||
except (IndexError, ValueError):
|
||||
pass
|
||||
# "Signal" line contains percentage (always available)
|
||||
elif stripped.lower().startswith("signal"):
|
||||
try:
|
||||
pct_str = stripped.split(":")[1].strip().rstrip("%")
|
||||
signal_pct = float(pct_str)
|
||||
# If RSSI line was missing, estimate from percentage
|
||||
# Signal% roughly maps: 100% ≈ -30 dBm, 0% ≈ -90 dBm
|
||||
except (IndexError, ValueError):
|
||||
pass
|
||||
|
||||
# Normalise link quality from signal percentage
|
||||
link_quality = signal_pct / 100.0
|
||||
|
||||
# Estimate noise floor (Windows doesn't expose it directly)
|
||||
noise_dbm = -95.0
|
||||
|
||||
# Track cumulative bytes (not available from netsh; increment synthetic counter)
|
||||
self._cumulative_tx += 1500
|
||||
self._cumulative_rx += 3000
|
||||
|
||||
return WifiSample(
|
||||
timestamp=time.time(),
|
||||
rssi_dbm=rssi,
|
||||
noise_dbm=noise_dbm,
|
||||
link_quality=link_quality,
|
||||
tx_bytes=self._cumulative_tx,
|
||||
rx_bytes=self._cumulative_rx,
|
||||
retry_count=0,
|
||||
interface=self._interface,
|
||||
)
|
||||
|
||||
Reference in New Issue
Block a user