-
Notifications
You must be signed in to change notification settings - Fork 19
Expand file tree
/
Copy pathindex.html
More file actions
297 lines (244 loc) · 19.2 KB
/
Copy pathindex.html
File metadata and controls
297 lines (244 loc) · 19.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
<!DOCTYPE html>
<html lang="en">
<head>
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-161272930-1"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'UA-161272930-1');
</script>
<meta charset="UTF-8">
<title>Wi-ESP (CSI Tool)</title>
<link href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" rel="stylesheet"
integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T" crossorigin="anonymous">
<style>
* {
font-size: 14px;
line-height: 1.428;
}
html {
background: #f6f6f6;
margin-top: 15px;
}
body {
background: none;
margin: 0 auto;
}
h1, h2, h3 {
font-family: sans-serif;
}
h1 {
text-align: center;
font-size: 2rem;
}
h2 {
font-size: 1.7rem;
}
h3 {
font-size: 1.5rem;
}
figure {
margin-top: 0;
}
figcaption {
font-size: 0.9rem;
}
ol.menu {
padding: 0;
text-align: center;
}
ol.menu li {
display: inline;
margin: 0 20px;
}
</style>
</head>
<body>
<div class="container">
<div class="row">
<div class="col-lg-8 col-md-10 offset-lg-2 offset-md-1">
<h1> Wi-ESP (ESP based CSI Tool)</h1>
<ol class="menu">
<li><a href="https://github.com/wrlab/Wi-ESP">GitHub</a></li>
<li><a href="https://academic.oup.com/jcde/article/doi/10.1093/jcde/qwaa048/5837600">Paper</a></li>
<li><a href="https://github.com/wrlab/Wi-ESP/blob/master/README.md">Documentation</a></li>
<li><a href="https://github.com/wrlab/Wi-ESP/archive/master.zip">Download</a></li>
<li><a href="https://wrl.kist.re.kr/">KIST-WRL</a></li>
<li><a href="pages/datasets.html">Datasets</a></li>
</ol>
<figure style="float: right">
<img src="Figures/Figure11-LLTF-Amplitude-Subcarrier-1-63-Smooth.jpg" alt="CSI Captured" width="300px">
<figcaption>CSI signals Acquired by using Wi-ESP</figcaption>
</figure>
<p>
Device-Free Wi-Fi Sensing (DFWS) has garnered significant attention in research circles,
thanks to the widespread availability of Wi-Fi signals and its capability to provide relatively
precise sensing with minimal infrastructure requirements.
One of the primary advantages of DFWS lies in its ability to
harness the omnipresent Wi-Fi signals for passive detection of various human activities such as movement,
falls, gestures, and location tracking, among others. Unlike traditional sensing methods that rely on dedicated devices
like sensors or cameras, DFWS utilizes the inherent patterns within Wi-Fi signals to discern human presence and behavior.
This technology holds promise across diverse domains such as the Internet of Things (IoT), Human Activity Recognition (HAR),
and elderly care, owing to its unobtrusive nature and ability to facilitate pervasive sensing.
The inception of 'Sensorless Sensing' can be traced back to early efforts in human detection utilizing
Wireless Sensor Networks (WSN) and the Received Signal Strength Indicator (RSSI).
These pioneering endeavors laid the groundwork for subsequent advancements in localization and tracking,
paving the way for the widespread adoption of DFWS-based applications.
A notable evolution in DFWS came with the utilization of Channel State Information (CSI) in the 802.11n standard,
offering a finer-grained insight into the Physical (PHY) layer. This enhancement enabled the extraction of valuable
information at the frame level, augmenting the capabilities of DFWS beyond what was achievable with RSSI-based methods."
</p>
<p><a href="https://github.com/wrlab/Wi-ESP/archive/master.zip">Download Documentation and Toolkit</a></p>
<h2>Publications</h2>
<ol>
<li><a href="https://academic.oup.com/jcde/article/doi/10.1093/jcde/qwaa048/5837600">Wi-ESP: Wi-ESP—A tool for CSI-based Device-Free Wi-Fi Sensing (DFWS) </a></li>
<li><a href="https://academic.oup.com/jcde/article/9/3/992/6590610">COVID-Beat: a low-cost breath monitoring approach for people in quarantine during the pandemic</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10444143">HAR: Device Free Wireless Sensing based Human Activity Recognition Using Commercial Off-the-Shelf IoT Single-Board Computers</a></li>
</ol>
<h2>Public Demonstrations</h2>
<ol>
<li><a href="https://www.youtube.com/watch?v=g1OiVEzNelI&ab_channel=WRL">HAR at Living Lab </a></li>
<li><a href="https://www.youtube.com/watch?v=Gybwx-z5ARo&ab_channel=WRL">Overall concept </a></li>
<li><a href="https://www.youtube.com/watch?v=Gybwx-z5ARo&ab_channel=WRL">CES-2024 </a></li>
</ol>
<h2>Citations</h2>
Wi-ESP around the globe
<ol>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10053493">Real-Time Operating System for Multitasking Control in the Robotics and Automation Industry</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10461405">One-Class Support Vector Machine for WiFi-based Device-free Indoor Presence Detection</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10461789">WiFi Sensing Model for Intrusion Detection in Smart Home Environment</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/9697141">IoT Enabled Programmable SwitchBox with existing SwitchBoard back</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/9611887">Distance Estimation Between Wireless Sensor Nodes Using RSSI and CSI with Bounded-Error Estimation and Theory of Evidence for a Landslide Monitoring System</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/9899896">Electromagnetic Models for Device-Free Radio Localization with Antenna Arrays</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/9842802">WIP: Impulsive Noise Source Recognition with OFDM-WiFi Signals Based on Channel State Information Using Machine Learning</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10317401">STrack: Velocity Estimation Using Single Antenna WiFi Devices</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10444143">Activity Recognition: Device Free Wireless Sensing based Human Activity Recognition Using Commercial Off-the-Shelf IoT Single-Board Computers</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10297446">An EM Body Model for Device-Free Localization with Multiple Antenna Receivers: A First Study </a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10459433">Presence Detection with Wi-Fi Using ESP32</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10380607">Non-Contact Wi-Fi Sensing of Respiration Rate for Older Adults in Care: A Validity and Repeatability Study</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/9447058">A Low Cost Modular Radio Tomography System for Bicycle and Vehicle Detection and Classification</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10298626">On the Impact of the Antenna Radiation Patterns in Passive Radio Sensing</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10168865">Collecting Channel State Information in Wi-Fi Access Points for IoT Forensics</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/9729463">Contactless WiFi Sensing and Monitoring for Future Healthcare - Emerging Trends, Challenges, and Opportunities</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/9564725">Device-free Pedestrian Count Estimation Using Wi-Fi Channel State Information</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/9542947">WiFi-Based Cross-Domain Gesture Recognition via Modified Prototypical Networks</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/10198440">Deep Learning-Based Fall Detection Using WiFi Channel State Information</a></li>
<li><a href="https://ieeexplore.ieee.org/abstract/document/9712382">Decentralized ME-Centric Framework—A Futuristic Architecture for Consumer IoT</a></li>
<li><a href="https://link.springer.com/article/10.1007/s12243-021-00865-9">Wi-Sense: a passive human activity recognition system using Wi-Fi and convolutional neural network and its integration in health information systems</a></li>
<li><a href="https://link.springer.com/chapter/10.1007/978-3-031-53830-8_30">Wi-SafeHome: WiFi Sensing Based Suspicious Activity Detection for Safe Home Environment</a></li>
<li><a href="https://link.springer.com/chapter/10.1007/978-3-030-94822-1_10">WiFi-Based Multi-task Sensing </a></li>
<li><a href="https://link.springer.com/chapter/10.1007/978-3-031-20936-9_11">Wi-Monitor: Wi-Fi Channel State Information-Based Crowd Counting with Lightweight and Low-Cost IoT Devices</a></li>
<li><a href="https://link.springer.com/chapter/10.1007/978-981-16-7618-5_46">Touchless Biometric User Authentication Using ESP32 WiFi Module</a></li>
<li><a href="https://link.springer.com/chapter/10.1007/978-3-031-44137-0_4">WiFi CSI-Based Long-Range Through-Wall Human Activity Recognition with the ESP32</a></li>
<li><a href="https://link.springer.com/chapter/10.1007/978-981-19-0901-6_41">Wi-Fi Signal-Based Through-Wall Sensing for Human Presence and Fall Detection Using ESP32 Module</a></li>
<li><a href="https://link.springer.com/chapter/10.1007/978-3-642-41569-2_13">Internet of Things</a></li>
<li><a href="https://academic.oup.com/jcde/article/9/5/1995/6679564">Mode confusion of human machine interfaces for automated vehicles</a></li>
<li><a href="https://academic.oup.com/jcde/article/8/2/510/6137731">CSI-based human sensing using model-based approaches: a survey</a></li>
<li><a href="https://academic.oup.com/jcde/article/9/3/992/6590610">COVID-Beat: a low-cost breath monitoring approach for people in quarantine during the pandemic</a></li>
<li><a href="https://dl.acm.org/doi/abs/10.1145/3640912.3640949">A Channel State Information based Respiration Rate Monitoring Method </a></li>
<li><a href="https://dl.acm.org/doi/abs/10.1145/3615834.3615841">WiFi Sensing with Single-Antenna Devices for Ambient Assisted Living</a></li>
<li><a href="https://www.mdpi.com/2411-5134/7/4/116">A Platform for Inpatient Safety Management Based on IoT Technology</a></li>
<li><a href="https://www.mdpi.com/2076-3417/12/22/11809">Car-Sense: Vehicle Occupant Legacy Hazard Detection Method Based on DFWS</a></li>
<li><a href="https://www.sciencedirect.com/science/article/pii/S2542660523003372">Addressing IoT storage constraints: A hybrid architecture for decentralized data storage and centralized management</a></li>
<li><a href="https://www.sciencedirect.com/science/article/pii/S0140366422003127">A survey on vital signs monitoring based on Wi-Fi CSI data</a></li>
<li><a href="https://www.sciencedirect.com/science/article/abs/pii/S0045790624001526">Implementation of a wireless text data transmission based on the impulsive control of fractional-order chaotic systems</a></li>
<li><a href="https://arxiv.org/abs/2111.09091">Motion Detection using CSI from Raspberry Pi 4</a></li>
<li><a href="https://arxiv.org/abs/2401.01388">Directional Antenna Systems for Long-Range Through-Wall Human Activity Recognition</a></li>
<li><a href="https://www.spiedigitallibrary.org/conference-proceedings-of-spie/12814/128141C/Channel-state-information-based-fall-detection-using-IoT-devices/10.1117/12.3010434.short#_=_">Channel state information-based fall detection using IoT devices</a></li>
<li><a href="https://passer.garmian.edu.krd/article_187775.html">Development of a Non-Invasive Blood Glucose Monitoring Device Using Machine Learning Technology</a></li>
<li><a href="https://theses.gla.ac.uk/84202/">AI enabled RF sensing of Diversified Human-Centric Monitoring</a></li>
<li><a href="https://www.proquest.com/openview/ec0b7ca77364335fa77b317a8b999e70/1?pq-origsite=gscholar&cbl=2055401">A Platform for Inpatient Safety Management Based on IoT Technology</a></li>
<li><a href="https://www.frontiersin.org/articles/10.3389/fphy.2024.1357209/full">End-to-end security enabled intelligent remote IoT monitoring system</a></li>
<li><a href="https://onlinelibrary.wiley.com/doi/abs/10.1002/dac.5338">Artificial intelligence driven Wi-Fi CSI data mining: Focusing on the intrusion detection applications</a></li>
<li><a href="https://pubs.aip.org/aip/acp/article-abstract/2814/1/030004/2901919/A-comprehensive-review-of-wifi-sensing?redirectedFrom=fulltext">A comprehensive review of wifi sensing technologies: Tools, challenges and future research directions</a></li>
<li><a href="https://www.hindawi.com/journals/wcmc/2021/6636665/">Machine Learning for Wireless Networks - Recent Advances and Future Trends</a></li>
</ol>
<h2>Datasets</h2>
<ol>
<li> Coming Soon......</li>
</ol>
<h2>Other CSI Acquistion Tools</h2>
<ol>
<li> Coming Soon......</li>
</ol>
<h2>Wi-ESP is Why-ESP?</h2>
ESP32 is a low cost IoT device can also be used to acquire CSI.
This provides low cost deployment of the solution to the problem.
<ul>
<li>Provide Amplitude and Phase information of the CSI.</li>
<li>Not limited to LLTF but also HT-LLTF and other parameters.</li>
<li>Can be used an edge device for computation.</li>
<li>Can be used for application development.</li>
<li>Reconfigurable according to application.</li>
</ul>
<h2>Steps to acquire CSI by ESP32</h2>
<p>This toolkit is used with WROOM 32 and ESP32 WROVER</p>
<ul>
Steps to acquire CSI are as follows:
<li>Step-1: Setup the wireless network to acquire CSI.</li>
<li>Step-2: Make Client/Server architecture to generate traffic.</li>
<li>Step-3: Acquire CSI to configure ESP32 on the same channle on which Wireless Network is established.</li>
</ul>
<br>
<h1>Earlier Version of Espressif</h1>
<br>
<h2>ESP32 console based Configuration Settings</h2>
<p>
There are few configurations which are very necessary to acquire CSI.
We have included all these settings in the manuscript and discuused very much in detail.
These setting includes CPU clock setting, we need to set at maximum so that we can acquire CSI at maximum rate.
UART baud rate is very necessary to acquire CSI from ESP32 board.
This settings depends on the board type of ESP32 we are using to acquire CSI.
Third settings is the SSID information, which need to set before acquring the CSI.
The last but the most important setting is the Enabling to get CSI.
All these settings can be performed thorigh source code but the more easy way is by using console.
</p>
<figure style="float: center">
<img src="Figures/Figure7a-CPU_Clock.JPG" alt="CPUClock" width="600px">
<figcaption>ESP32 CPU Clock Setting</figcaption>
</figure>
<p>
There are different options are available to set the clock frequency of the processor.
The best is to select maximum which is 240MHz.
In some cases this is observed that low clock rate can also work but this is better to select the clock rate maximum.
</p>
<figure style="float: center">
<img src="Figures/Figure7b-UART Baud Rate.JPG" alt="UARTBaudRate" width="600px">
<figcaption>ESP32 UART Baud Rate Setting</figcaption>
</figure>
<p>
The baud rate settings is necessary in case you are using UART port to commuincate to the ESP32.
The Baud rate depends upon the board type you are using to acquire CSI.
There are many kinds of board are available in the market. Select that board which provides you maximum baud rate which is 2M.
</p>
<figure style="float: center">
<img src="Figures/Figure7c-SSIDConnection.JPG" alt="SSIDConnection" width="600px">
<figcaption>ESP32 SSID Connection Setting</figcaption>
</figure>
<p>
The CSI gathering can be performed without using this. But still we have done this to avoid any confusion.
The important thing to acquire CSI is the channel number which are you uisng for transmission
This is better to filter the channel number and MAC address to minimze the traffic otherwise the traffic need to be filter at later stage.
</p>
<figure style="float: center">
<img src="Figures/Figure7d-EnableCSI.JPG" alt="EnableCSI" width="600px">
<figcaption>Enable Passive CSI gathering</figcaption>
</figure>
<p>
The most important setting of the ESP32 is the enabling the CSI by using the console.
This must be enable before configuring ESP32.
</p>
<h2></h2>
<h2>Reach Us</h2>
<p id="ReachUs">
Tool developed by: <a href="mailto:muhammad.atif@wrl.onl">Dr. Muhammad Atif</a> | <a href="http://www.wrl.onl">WRL Lab @ KIST South Korea</a>
</p>
<p>
Cite this tool: <a href="docs/bibtex/Wi-ESP-JCDE.bibtex">BibTeX</a>
</p>
</div>
</div>
</div>
</body>
</html>