Umber
/
ESP32
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Rename to Wi-Fi Telemetry Capture, add SD card to README 

- README: title Wi-Fi Telemetry Capture, add SD card feature
- Doc scenarios and GPS guide: Wi-Fi telemetry capture wording

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Robert McMahon 2026-02-07 12:46:31 -08:00
parent cf7748960f
commit 8acd9ba9c0
4 changed files with 9 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
README.md
View File

@ -1,6 +1,6 @@
# ESP32 Wi-Fi Collapse Detector / iPerf Load Generator # ESP32 Wi-Fi Telemetry Capture / iPerf Load Generator
High-performance Wi-Fi monitor and iperf 2 based traffic generator firmware for ESP32 devices with interactive console interface, GPS synchronization, and WiFi collapse detection capabilities. High-performance Wi-Fi monitor and iperf 2 based traffic generator firmware for ESP32 devices with interactive console interface, GPS synchronization, and Wi-Fi telemetry capture (MCS, RSSI, frame stats, collapse detection, and more).
**Version:** 2.1.0 **Version:** 2.1.0
**ESP-IDF:** 6.0+ **ESP-IDF:** 6.0+
@ -12,6 +12,7 @@ High-performance Wi-Fi monitor and iperf 2 based traffic generator firmware for
- **WiFi Management**: Station mode with static IP support, DHCP, and monitor mode - **WiFi Management**: Station mode with static IP support, DHCP, and monitor mode
- **GPS Synchronization**: PPS signal support and NMEA parsing for timestamp synchronization - **GPS Synchronization**: PPS signal support and NMEA parsing for timestamp synchronization
- **Persistent Configuration**: NVS storage for WiFi credentials, IP settings, and iPerf parameters - **Persistent Configuration**: NVS storage for WiFi credentials, IP settings, and iPerf parameters
- **SD Card**: Telemetry storage (fiwi-telemetry), HTTP file download (port 8080), serial transfer, broadcast beacon for laptop discovery
- **Status LED**: Visual feedback for connection state and system status - **Status LED**: Visual feedback for connection state and system status
- **Mass Deployment**: Python scripts for flashing and configuring multiple devices - **Mass Deployment**: Python scripts for flashing and configuring multiple devices

2
doc/BANDWIDTH_BAND_SELECTION_GUIDE.md
View File

@ -257,7 +257,7 @@ mode_monitor 149/80
## 🔍 Real-World Scenarios ## 🔍 Real-World Scenarios
### Scenario 1: Office WiFi Collapse Detection ### Scenario 1: Office Wi-Fi Telemetry Capture
**Goal:** Monitor office WiFi on 5GHz with WiFi 6 **Goal:** Monitor office WiFi on 5GHz with WiFi 6
```bash ```bash

2
doc/CONFIG_DEVICE_MANUAL.txt
View File

@ -608,7 +608,7 @@ idf.py -p $PORT monitor | tee device_90.log
10. COMMON DEPLOYMENT SCENARIOS 10. COMMON DEPLOYMENT SCENARIOS
================================================================================ ================================================================================
SCENARIO 1: WIFI COLLAPSE DETECTION (32 devices) SCENARIO 1: WIFI TELEMETRY CAPTURE (32 devices)
------------------------------------------------- -------------------------------------------------
Goal: Detect WiFi collapse events and correlate with iperf degradation Goal: Detect WiFi collapse events and correlate with iperf degradation

8
doc/esp32-c5-gps-sync-guide.html
View File

@ -249,12 +249,12 @@
<body> <body>
<header> <header>
<h1>ESP32-C5 GPS Synchronization Guide</h1> <h1>ESP32-C5 GPS Synchronization Guide</h1>
<div class="subtitle">Precision Timing for WiFi Collapse Detection with iperf2 Correlation</div> <div class="subtitle">Precision Timing for Wi-Fi Telemetry Capture with iperf2 Correlation</div>
</header> </header>
<div class="section"> <div class="section">
<h2>Overview</h2> <h2>Overview</h2>
<p>This guide demonstrates how to synchronize an ESP32-C5-DevKitC-1-N8R4 to GPS time using a GPS module with PPS (Pulse Per Second) output. This enables precise timestamp correlation between WiFi collapse detector events and iperf2 latency measurements running on a GPS-synced Raspberry Pi 5.</p> <p>This guide demonstrates how to synchronize an ESP32-C5-DevKitC-1-N8R4 to GPS time using a GPS module with PPS (Pulse Per Second) output. This enables precise timestamp correlation between Wi-Fi telemetry capture events and iperf2 latency measurements running on a GPS-synced Raspberry Pi 5.</p>
<div class="info-box"> <div class="info-box">
<strong>Key Features:</strong> <strong>Key Features:</strong>
@ -773,7 +773,7 @@ collapse_times = merged[merged['event'] == 'COLLAPSE']['timestamp']
ax2.scatter(collapse_times, [1]*len(collapse_times), color='r', marker='x', s=100, label='Collapse') ax2.scatter(collapse_times, [1]*len(collapse_times), color='r', marker='x', s=100, label='Collapse')
ax2.set_ylabel('Collapse Events', color='r') ax2.set_ylabel('Collapse Events', color='r')
plt.title('WiFi Latency vs Collapse Detection Events') plt.title('WiFi Latency vs Telemetry Capture Events')
plt.show()</code></pre> plt.show()</code></pre>
</div> </div>
@ -923,7 +923,7 @@ echo &quot;All devices flashed!&quot;</code></pre>
<footer> <footer>
<p><strong>ESP32-C5 GPS Synchronization Guide</strong></p> <p><strong>ESP32-C5 GPS Synchronization Guide</strong></p>
<p>For WiFi Collapse Detection and iperf2 Latency Correlation</p> <p>For Wi-Fi Telemetry Capture and iperf2 Latency Correlation</p>
<p>December 2025</p> <p>December 2025</p>
</footer> </footer>
</body> </body>