# Wavey

- [Wavey: WiFi CSI Sensing for Occupancy, Motion, and Presence](https://docs.heywavey.tech/index.md): Wavey is an open-source WiFi CSI sensing stack. ESP32 nodes capture Channel State Information to detect occupancy, motion, and presence without cameras or wearables.
- [Get Started with Wavey WiFi CSI Sensing](https://docs.heywavey.tech/getting-started.md): Deploy ESP32 nodes, run the Python pipeline, and understand Wavey's three-layer architecture for occupancy, motion, and presence sensing.
- [How WiFi CSI Sensing Works: Physics and Signals](https://docs.heywavey.tech/concepts/how-it-works.md): Learn how Channel State Information, OFDM subcarriers, multipath propagation, and micro-Doppler physics enable device-free WiFi sensing.
- [Wavey Sensing Pipeline: Raw CSI to Detection Events](https://docs.heywavey.tech/concepts/sensing-pipeline.md): Preprocess raw CSI, extract time-domain and spectrogram features, and apply ML from classical thresholds to domain adaptation for reliable detection.
- [Detection Ladder: What WiFi CSI Can and Cannot Do](https://docs.heywavey.tech/concepts/detection-ladder.md): A 10-rung ladder from binary occupancy to pose and identity, with the signal requirements, failure modes, and Wavey scope at each level.
- [WiFi CSI Sensing Use Cases Overview](https://docs.heywavey.tech/use-cases/index.md): Explore all Wavey use cases: occupancy detection, motion and activity recognition, presence sensing, elder care, security, smart home, and analytics.
- [Device-Free Occupancy Detection with WiFi CSI](https://docs.heywavey.tech/use-cases/occupancy-detection.md): Detect whether a room is occupied or empty using change-point detection against a learned WiFi CSI baseline. No cameras, wearables, or device counting required.
- [Motion and Activity Detection Using WiFi CSI](https://docs.heywavey.tech/use-cases/motion-activity-detection.md): Detect motion via variance thresholds and classify human activities through three generations of CSI-based HAR, from physics-linked models to dual-stream transformers.
- [Still-Person Presence Detection via WiFi Micro-Doppler](https://docs.heywavey.tech/use-cases/presence-detection.md): Detect stationary occupants through breathing micro-Doppler on WiFi CSI phase when PIR and cameras fail. Requires clean phase, sufficient SNR, and a quiet environment.
- [Ambient Elder-Care Monitoring with WiFi CSI Sensing](https://docs.heywavey.tech/use-cases/elder-care-monitoring.md): Ambient presence and fall-event awareness for aging in place using WiFi CSI. No cameras in bedrooms and no wearables that get left on the nightstand.
- [Security and Intrusion Detection via WiFi CSI](https://docs.heywavey.tech/use-cases/security-intrusion-detection.md): Detect motion through walls without cameras, wearables, or light. WiFi CSI enables device-free, darkness-invariant zone monitoring using existing radio signals.
- [Smart-Home Automation with WiFi Presence Holds](https://docs.heywavey.tech/use-cases/smart-home-automation.md): Use WiFi presence holds instead of motion pulses to keep lights on, HVAC running, and scenes active while occupants are still in a room.
- [Anonymous Occupancy Analytics with WiFi CSI](https://docs.heywavey.tech/use-cases/occupancy-analytics.md): Generate zone-level utilization metrics from WiFi CSI without tracking devices, capturing personal data, or installing cameras.
- [WiFi CSI Sensing vs Other Technologies](https://docs.heywavey.tech/comparisons/index.md): How WiFi CSI compares to cameras, mmWave radar, PIR sensors, and wearables on sensing mechanism, coverage, cost, and deployment.
- [WiFi CSI Sensing vs PIR Motion Sensors Compared](https://docs.heywavey.tech/comparisons/wifi-sensing-vs-pir.md): Compare differential IR motion pulses with radio-based presence holds to choose the right sensor for occupancy, security, and automation.
- [WiFi CSI Sensing vs Camera Systems Compared](https://docs.heywavey.tech/comparisons/wifi-sensing-vs-cameras.md): Compare radio-based anonymous occupancy with visual surveillance across coverage, latency, cost, and privacy to pick the right sensing approach.
- [WiFi CSI Sensing vs Wearables and Device Tracking](https://docs.heywavey.tech/comparisons/wifi-sensing-vs-wearables.md): Compare device-free body sensing with wearable and MAC-based tracking for occupancy, elder care, and building analytics use cases.
- [WiFi CSI Sensing vs mmWave Radar Compared](https://docs.heywavey.tech/comparisons/wifi-sensing-vs-mmwave-radar.md): Compare commodity WiFi reuse with dedicated 60 GHz radar for presence, motion, and vitals sensing across cost, scale, and precision.
- [WiFi CSI Sensing Glossary: Key Terms Defined](https://docs.heywavey.tech/reference/glossary.md): Definitions for CSI, RSSI, OFDM, multipath, HAR, and all other terms used across the Wavey documentation and WiFi sensing stack.
- [Frequently Asked Questions About Wavey and WiFi CSI](https://docs.heywavey.tech/reference/faq.md): Practical questions on hardware, detection accuracy, privacy, and getting started with Wavey WiFi CSI sensing.
- [About Wavey: Open-Source WiFi CSI Sensing](https://docs.heywavey.tech/about.md): Wavey is an open-source WiFi CSI sensing system for device-free occupancy, motion, and presence detection using low-cost ESP32 hardware.
- [Contact the Wavey Team](https://docs.heywavey.tech/contact.md): Reach the Wavey team via Discord, GitHub, or email for questions, contributions, and partnership inquiries.
- [Wavey Technical Deep Dives and Research Posts](https://docs.heywavey.tech/posts/index.md): Technical deep dives on WiFi CSI sensing, activity classifiers, baselines, and the RF privacy research series from the Wavey team.
- [Introduction to WiFi CSI: What a Channel Snapshot Contains](https://docs.heywavey.tech/posts/introduction-to-wifi-csi.md): Learn how OFDM subcarriers capture multipath superposition, why RSSI discards critical phase data, and how the CSI matrix encodes environmental change for WiFi sensing.
- [ESP32 CSI: Commodity WiFi Sensing Limits and Capabilities](https://docs.heywavey.tech/posts/esp32-csi-explained.md): Explore ESP32 subcarrier count, phase noise from CFO and SFO, sampling constraints, and which WiFi sensing tasks are achievable on single-antenna commodity hardware.
- [Building a WiFi Activity Classifier: Threshold to CNN](https://docs.heywavey.tech/posts/wifi-motion-detection-without-camera.md): Follow the engineering path from a variance threshold to a spectrogram CNN for WiFi human activity recognition, including label collection and domain shift.
- [Baselines and Generalization in Device-Free Occupancy Sensing](https://docs.heywavey.tech/posts/device-free-occupancy-sensing-explained.md): Learn how to build empty-room fingerprints, handle drift sources and cross-site domain shift, and know exactly when to trigger a re-baseline in WiFi sensing.
- [RF Privacy: The Hidden Risks of WiFi Sensing Technology](https://docs.heywavey.tech/posts/rf-privacy-the-flip-side-of-wifi-sensing.md): The same physics that powers Wavey's legitimate occupancy sensing can be exploited by attackers for passive surveillance without consent, specialized hardware, or network access.
- [WiFi Sensing Attacks: LeakyBeam, BFId, and BFI Side Channels](https://docs.heywavey.tech/posts/wifi-sensing-attacks-leakybeam-bfid.md): Two 2025 papers at NDSS and CCS demonstrate passive occupancy detection and identity inference using plaintext beamforming feedback from commodity WiFi hardware.
- [Detecting Unauthorized WiFi Sensing: Five Detection Layers](https://docs.heywavey.tech/posts/detecting-unauthorized-rf-sensing.md): Five layered detection approaches from RF emitter inventory to behavioral baselines, with honest assessment of what each catches, misses, and its feasibility on commodity hardware.
- [RF Privacy Defenses: Obfuscation, Metasurfaces, and Limits](https://docs.heywavey.tech/posts/rf-privacy-defenses-and-limits.md): Transmitter-side CSI fuzzing, relay obfuscation, metasurface shields, and BFI-specific defenses each carry practical limits that buyers and deployers should understand.
- [802.11bf Ratification: WiFi Sensing Standards and Privacy](https://docs.heywavey.tech/posts/ieee-80211bf-privacy-gap.md): What the 802.11bf standard enables for WiFi sensing, what privacy protections it omits, and what enterprise buyers evaluating sensing hardware should demand from vendors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.