You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+77-35Lines changed: 77 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -57,44 +57,86 @@ docker run -p 3000:3000 ruvnet/wifi-densepose:latest
57
57
58
58
---
59
59
60
-
<details>
61
-
<summary><strong>🏢 Use Cases & Applications</strong> — From hospital rooms to concert halls</summary>
60
+
## 🏢 Use Cases & Applications
62
61
63
62
WiFi sensing works anywhere WiFi exists. No new hardware in most cases — just software on existing access points or a $8 ESP32 add-on. Because there are no cameras, deployments avoid privacy regulations (GDPR video, HIPAA imaging) by design.
64
63
65
-
**Scaling note:** Each access point can distinguish ~3-5 people using 56 subcarriers (ESP32-S3). Multi-AP setups multiply capacity linearly — a 4-AP mesh in a retail store covers ~15-20 simultaneous occupants. There is no hard software limit; the `persons: Vec<PersonPose>` vector grows dynamically. The practical ceiling is signal physics: subcarrier count, AP placement, and room geometry.
66
-
67
-
### Everyday — Proven with commodity WiFi
68
-
69
-
| Use Case | What It Does | Hardware Needed |
70
-
|----------|-------------|-----------------|
71
-
|**Elderly care / assisted living**| Fall detection, nighttime activity monitoring, breathing rate during sleep — no wearable compliance needed | 1 ESP32-S3 per room ($8) |
72
-
|**Hospital patient monitoring**| Continuous breathing + heart rate for non-critical beds without wired sensors; nurse alert on anomaly | 1-2 APs per ward, existing WiFi |
|**Retail occupancy & flow**| Real-time foot traffic, dwell time by zone, queue length — no cameras, no opt-in, GDPR-friendly | Existing store WiFi + 1 ESP32 |
75
-
|**Office space utilization**| Which desks/rooms are actually occupied, meeting room no-shows, HVAC optimization based on real presence | Existing enterprise WiFi |
76
-
|**Hotel & hospitality**| Room occupancy without door sensors, minibar/bathroom usage patterns, energy savings on empty rooms | Existing hotel WiFi |
77
-
78
-
### Specialized — Requires CSI-capable hardware
79
-
80
-
| Use Case | What It Does | Hardware Needed |
81
-
|----------|-------------|-----------------|
82
-
|**Smart home automation**| Room-level presence triggers (lights, HVAC, music) that work through walls — no dead zones, no motion-sensor timeouts | 2-3 ESP32-S3 nodes ($24) |
83
-
|**Fitness & sports**| Rep counting, posture correction, breathing cadence during exercise — no wearable, no camera in locker rooms | 3+ ESP32-S3 mesh |
84
-
|**Childcare & schools**| Naptime breathing monitoring, playground headcount, restricted-area alerts — privacy-safe for minors | 2-4 ESP32-S3 per zone |
|**Warehouse & logistics**| Worker safety zones, forklift proximity alerts, occupancy in hazardous areas — works through shelving and pallets | Industrial AP mesh |
87
-
|**Civic infrastructure**| Public restroom occupancy (no cameras possible), subway platform crowding, shelter headcount during emergencies | Municipal WiFi + ESP32 |
88
-
89
-
### Extreme — Through-wall and disaster scenarios
90
-
91
-
| Use Case | What It Does | Hardware Needed |
92
-
|----------|-------------|-----------------|
93
-
|**Search & rescue (WiFi-Mat)**| Detect survivors through rubble/debris via breathing signature, START triage color classification, 3D localization | Portable ESP32 mesh + laptop |
94
-
|**Prison & secure facilities**| Cell occupancy verification, distress detection (abnormal vitals), perimeter sensing — no camera blind spots | Dedicated AP infrastructure |
|**Mining & underground**| Worker presence in tunnels where GPS/cameras fail, breathing detection after collapse, headcount at safety points | Ruggedized ESP32 mesh |
97
-
|**Wildlife research**| Non-invasive animal activity monitoring in enclosures or dens — no light pollution, no visual disturbance | Weatherproof ESP32 nodes |
64
+
**Scaling:** Each AP distinguishes ~3-5 people (56 subcarriers). Multi-AP multiplies linearly — a 4-AP retail mesh covers ~15-20 occupants. No hard software limit; the practical ceiling is signal physics.
65
+
66
+
|| Why WiFi sensing wins | Traditional alternative |
|**Elderly care / assisted living**| Fall detection, nighttime activity monitoring, breathing rate during sleep — no wearable compliance needed | 1 ESP32-S3 per room ($8) | Fall alert <2s |
80
+
|**Hospital patient monitoring**| Continuous breathing + heart rate for non-critical beds without wired sensors; nurse alert on anomaly | 1-2 APs per ward | Breathing: 6-30 BPM |
|**Retail occupancy & flow**| Real-time foot traffic, dwell time by zone, queue length — no cameras, no opt-in, GDPR-friendly | Existing store WiFi + 1 ESP32 | Dwell resolution ~1m |
83
+
|**Office space utilization**| Which desks/rooms are actually occupied, meeting room no-shows, HVAC optimization based on real presence | Existing enterprise WiFi | Presence latency <1s |
84
+
|**Hotel & hospitality**| Room occupancy without door sensors, minibar/bathroom usage patterns, energy savings on empty rooms | Existing hotel WiFi | 15-30% HVAC savings |
85
+
|**Restaurants & food service**| Table turnover tracking, kitchen staff presence, restroom occupancy displays — no cameras in dining areas | Existing WiFi | Queue wait ±30s |
86
+
|**Parking garages**| Pedestrian presence in stairwells and elevators where cameras have blind spots; security alert if someone lingers | Existing WiFi | Through-concrete walls |
|**Smart home automation**| Room-level presence triggers (lights, HVAC, music) that work through walls — no dead zones, no motion-sensor timeouts | 2-3 ESP32-S3 nodes ($24) | Through-wall range ~5m |
96
+
|**Fitness & sports**| Rep counting, posture correction, breathing cadence during exercise — no wearable, no camera in locker rooms | 3+ ESP32-S3 mesh | Pose: 17 keypoints |
97
+
|**Childcare & schools**| Naptime breathing monitoring, playground headcount, restricted-area alerts — privacy-safe for minors | 2-4 ESP32-S3 per zone | Breathing: ±1 BPM |
98
+
|**Event venues & concerts**| Crowd density mapping, crush-risk detection via breathing compression, emergency evacuation flow tracking | Multi-AP mesh (4-8 APs) | Density per m² |
99
+
|**Stadiums & arenas**| Section-level occupancy for dynamic pricing, concession staffing, emergency egress flow modeling | Enterprise AP grid | 15-20 per AP mesh |
|**Warehouse & logistics**| Worker safety zones, forklift proximity alerts, occupancy in hazardous areas — works through shelving and pallets | Industrial AP mesh | Alert latency <500ms |
102
+
|**Civic infrastructure**| Public restroom occupancy (no cameras possible), subway platform crowding, shelter headcount during emergencies | Municipal WiFi + ESP32 | Real-time headcount |
103
+
|**Museums & galleries**| Visitor flow heatmaps, exhibit dwell time, crowd bottleneck alerts — no cameras near artwork (flash/theft risk) | Existing WiFi | Zone dwell ±5s |
WiFi sensing gives robots and autonomous systems a spatial awareness layer that works where LIDAR and cameras fail — through dust, smoke, fog, and around corners. The CSI signal field acts as a "sixth sense" for detecting humans in the environment without requiring line-of-sight.
111
+
112
+
| Use Case | What It Does | Hardware | Key Metric |
|**Cobot safety zones**| Detect human presence near collaborative robots — auto-slow or stop before contact, even behind obstructions | 2-3 ESP32-S3 per cell | Presence latency <100ms |
115
+
|**Warehouse AMR navigation**| Autonomous mobile robots sense humans around blind corners, through shelving racks — no LIDAR occlusion | ESP32 mesh along aisles | Through-shelf detection |
116
+
|**Android / humanoid spatial awareness**| Ambient human pose sensing for social robots — detect gestures, approach direction, and personal space without cameras always on | Onboard ESP32-S3 module | 17-keypoint pose |
117
+
|**Manufacturing line monitoring**| Worker presence at each station, ergonomic posture alerts, headcount for shift compliance — works through equipment | Industrial AP per zone | Pose + breathing |
118
+
|**Construction site safety**| Exclusion zone enforcement around heavy machinery, fall detection from scaffolding, personnel headcount | Ruggedized ESP32 mesh | Alert <2s, through-dust |
119
+
|**Agricultural robotics**| Detect farm workers near autonomous harvesters in dusty/foggy field conditions where cameras are unreliable | Weatherproof ESP32 nodes | Range ~10m open field |
120
+
|**Drone landing zones**| Verify landing area is clear of humans — WiFi sensing works in rain, dust, and low light where downward cameras fail | Ground ESP32 nodes | Presence: >95% accuracy |
121
+
|**Clean room monitoring**| Personnel tracking without cameras (particle contamination risk from camera fans) — gown compliance via pose | Existing cleanroom WiFi | No particulate emission |
These scenarios exploit WiFi's ability to penetrate solid materials — concrete, rubble, earth — where no optical or infrared sensor can reach. The WiFi-Mat disaster module (ADR-001) is specifically designed for this tier.
129
+
130
+
| Use Case | What It Does | Hardware | Key Metric |
|**Search & rescue (WiFi-Mat)**| Detect survivors through rubble/debris via breathing signature, START triage color classification, 3D localization | Portable ESP32 mesh + laptop | Through 30cm concrete |
133
+
|**Firefighting**| Locate occupants through smoke and walls before entry; breathing detection confirms life signs remotely | Portable mesh on truck | Works in zero visibility |
134
+
|**Prison & secure facilities**| Cell occupancy verification, distress detection (abnormal vitals), perimeter sensing — no camera blind spots | Dedicated AP infrastructure | 24/7 vital signs |
|**Border & perimeter security**| Detect human presence in tunnels, behind fences, in vehicles — passive sensing, no active illumination to reveal position | Concealed ESP32 mesh | Passive / covert |
137
+
|**Mining & underground**| Worker presence in tunnels where GPS/cameras fail, breathing detection after collapse, headcount at safety points | Ruggedized ESP32 mesh | Through rock/earth |
|**Wildlife research**| Non-invasive animal activity monitoring in enclosures or dens — no light pollution, no visual disturbance | Weatherproof ESP32 nodes | Zero light emission |
0 commit comments