From 73429d19867dd65caea1923f9dac1fc9cef66738 Mon Sep 17 00:00:00 2001 From: user Date: Wed, 4 Feb 2026 18:36:32 +0100 Subject: [PATCH] =?UTF-8?q?docs:=20Update=20CHEATSHEET=20=E2=80=94=20lower?= =?UTF-8?q?=20baud=20rate,=20new=20packet=20formats?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Use 460800 baud for USB flash (921600 fails on some boards). Document new sensor hostname prefix in all data packet formats. Add USB flash notes section. --- docs/CHEATSHEET.md | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/docs/CHEATSHEET.md b/docs/CHEATSHEET.md index d168e74..24b6b14 100644 --- a/docs/CHEATSHEET.md +++ b/docs/CHEATSHEET.md @@ -14,9 +14,9 @@ cd ~/git/esp32-hacking/get-started/csi_recv_router idf.py set-target esp32 # Set chip target idf.py menuconfig # Configure WiFi/UDP settings idf.py build # Compile firmware -idf.py -p /dev/ttyUSB0 flash # Flash to device +idf.py -p /dev/ttyUSB0 -b 460800 flash # Flash to device (460800 baud) idf.py -p /dev/ttyUSB0 monitor # Serial monitor (Ctrl+] to exit) -idf.py -p /dev/ttyUSB0 flash monitor # Flash + monitor combined +idf.py -p /dev/ttyUSB0 -b 460800 flash monitor # Flash + monitor combined idf.py fullclean # Clean build directory idf.py reconfigure # Re-fetch managed components ``` @@ -93,7 +93,7 @@ When enabled, the device automatically adjusts ping rate based on CSI wander: - **Motion detected** (wander > threshold): 100 pkt/s - **Idle** (wander < threshold for 3s): 10 pkt/s -- Rate changes send `EVENT motion=<0|1> rate= wander=` via UDP +- Rate changes send `EVENT,,motion=<0|1> rate= wander=` via UDP ```bash esp-cmd amber-maple.local ADAPTIVE ON # Enable @@ -140,12 +140,21 @@ nc -lu 5500 | wc -l # Count packets/sec (Ctrl+C) | CSI UDP Configuration → Cmd port | `5501` | | CSI UDP Configuration → Hostname | mDNS name (e.g., `amber-maple`) | -## CSI Data Format +## USB Flash Notes + +- **Use 460800 baud** (`-b 460800`) — 921600 causes connection failures on some boards +- Each device needs its own build with its hostname set in menuconfig +- First flash after enabling OTA partitions must be via USB + +## Data Packet Formats + +All data packets include sensor hostname after the type tag: ``` -CSI_DATA,seq,mac,rssi,rate,sig_mode,mcs,cwb,smoothing,not_sounding, -aggregation,stbc,fec_coding,sgi,noise_floor,ampdu_cnt,channel, -secondary_channel,timestamp,ant,sig_len,rx_state,len,first_word,"[I,Q,...]" +CSI_DATA,,seq,mac,rssi,rate,...,len,first_word,"[I,Q,...]" +BLE_DATA,,mac,rssi,pub|rnd,name +EVENT,,motion=0|1 rate= wander= +ALERT_DATA,,deauth|disassoc,sender_mac,target_mac,rssi ``` ## Source Paths