Umber
/
ESP32
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ESP32/doc/QUICK_REFERENCE.md

5.1 KiB
Raw Blame History

Console Commands Quick Reference

🎮 All Available Commands

mode_monitor [channel/bandwidth]  # Monitor mode with bandwidth control
mode_sta [band]                   # STA mode with band selection
mode_status                       # Show current configuration
csi_dump                          # Dump CSI data (STA mode only)

📡 Monitor Mode Examples

2.4GHz Band

mode_monitor 6/20      # Channel 6, 20MHz (narrow, less interference)
mode_monitor 6/40      # Channel 6, 40MHz (wide, more speed)
mode_monitor 11/20     # Channel 11, 20MHz
mode_monitor 1         # Channel 1, default 20MHz

5GHz Band

mode_monitor 36/20     # Channel 36, 20MHz (max range)
mode_monitor 36/40     # Channel 36, 40MHz (balanced)
mode_monitor 36/80     # Channel 36, 80MHz (max speed, WiFi 6)
mode_monitor 149/80    # Channel 149, 80MHz
mode_monitor 161       # Channel 161, default 40MHz

🌐 STA Mode Examples

Auto Band Selection (Default)

mode_sta               # Auto select 2.4GHz or 5GHz
mode_sta auto          # Same as above

Force 2.4GHz

mode_sta 2.4           # Connect on 2.4GHz only
mode_sta 2             # Same as above

Force 5GHz

mode_sta 5             # Connect on 5GHz only
mode_sta 5.0           # Same as above

📊 Status Check

esp32> mode_status

=== WiFi Mode Status ===
Current mode: MONITOR
LED state: Blue solid (Monitoring)
Monitor channel: 36 (5GHz)
Monitor bandwidth: 80MHz
Monitor enabled: Yes
Frames captured: 15234
GPS synced: Yes (+)

🎯 Common Workflows

Workflow 1: WiFi 6 Testing on 5GHz

# 1. Connect on 5GHz
esp32> mode_sta 5

# 2. Wait for connection (green LED)

# 3. Check AP channel
esp32> mode_status
Connected band: 5GHz (channel 36)
Bandwidth: 80MHz

# 4. Switch to monitor with same config
esp32> mode_monitor 36/80

# 5. Monitor collapse events with GPS timestamps
[Monitoring...]

Workflow 2: 2.4GHz Congestion Analysis

# Test narrow bandwidth
esp32> mode_monitor 6/20
[collect for 30 min...]

# Test wide bandwidth
esp32> mode_monitor 6/40
[collect for 30 min...]

# Compare collapse rates

Workflow 3: Force 5GHz for Performance

# Force 5GHz connection
esp32> mode_sta 5

# Verify connected on 5GHz
esp32> mode_status

# Collect CSI data on 5GHz
[wait 20 seconds for auto dump]

# Or dump manually
esp32> csi_dump

Workflow 4: Multi-Bandwidth Testing

# Test same channel at different bandwidths
esp32> mode_monitor 149/20
[5 minutes...]

esp32> mode_monitor 149/40
[5 minutes...]

esp32> mode_monitor 149/80
[5 minutes...]

# Analyze which has fewer collapses

🎨 LED Status

Color State Mode
Yellow solid No WiFi config -
Blue blink Connecting to AP STA
Green solid Connected, CSI+iperf running STA
Blue solid Monitor mode active Monitor
Red blink Connection failed -

📝 GPS Timestamp Format

Log messages:
I (*1.234) MAIN: Waiting...        (* = not synced)
I (+1733424645.234) MAIN: Ready!   (+ = GPS synced)

CSV collapse events:
COLLAPSE,MonoMS,GpsMS,Synced,NAV,RSSI,Retry
COLLAPSE,5234567,1733424645234,1,5234.50,-65,1

🔧 Configuration Matrix

Valid Bandwidth Combinations

Band Channel Examples 20MHz 40MHz 80MHz
2.4GHz 1, 6, 11 ✅ ✅ ❌
5GHz 36, 149, 161 ✅ ✅ ✅

Valid Band Preferences

Mode 2.4GHz 5GHz Auto
STA ✅ ✅ ✅ (default)
Monitor ✅ ✅ N/A

🚀 Deployment Examples

32-Device Setup: Multi-Bandwidth Testing

# Devices 1-8: 2.4GHz 20MHz
mode_monitor 6/20

# Devices 9-16: 2.4GHz 40MHz
mode_monitor 6/40

# Devices 17-24: 5GHz 40MHz
mode_monitor 149/40

# Devices 25-32: 5GHz 80MHz
mode_monitor 149/80

Production Deployment: Best Performance

# All devices: Force 5GHz connection
mode_sta 5

# After connection, monitor on AP's channel
mode_monitor 149/80

⚡ Performance Tips

For Maximum Range

mode_sta 2.4           # Connect on 2.4GHz
mode_monitor 6/20      # Monitor with 20MHz

For Maximum Speed

mode_sta 5             # Connect on 5GHz
mode_monitor 149/80    # Monitor with 80MHz

For Dense Environments

mode_sta 5             # Prefer 5GHz (less congestion)
mode_monitor 149/20    # Narrow bandwidth (less interference)

For WiFi 6 Testing

mode_sta auto          # Auto select
mode_monitor 36/80     # 80MHz WiFi 6

🎉 Feature Summary

ESP32-C5 Capabilities:

  • ✅ WiFi 6 (802.11ax) on 2.4GHz and 5GHz
  • ✅ Bandwidths: 20MHz, 40MHz (both bands); 80MHz (5GHz only)
  • ✅ Band selection: Auto, 2.4GHz only, 5GHz only
  • ✅ Runtime mode switching (no reflashing needed)
  • ✅ GPS-timestamped collapse detection
  • ✅ CSI capture + iperf server in STA mode
  • ✅ Visual LED status indicators

Console Commands:

  • 4 commands total
  • Bandwidth control in monitor mode
  • Band preference in STA mode
  • Real-time status checking
  • One firmware for all configurations!