257 lines
5.1 KiB
Markdown
257 lines
5.1 KiB
Markdown
# Console Commands Quick Reference
|
|
|
|
## 🎮 All Available Commands
|
|
|
|
```bash
|
|
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
|
|
```bash
|
|
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
|
|
```bash
|
|
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)
|
|
```bash
|
|
mode_sta # Auto select 2.4GHz or 5GHz
|
|
mode_sta auto # Same as above
|
|
```
|
|
|
|
### Force 2.4GHz
|
|
```bash
|
|
mode_sta 2.4 # Connect on 2.4GHz only
|
|
mode_sta 2 # Same as above
|
|
```
|
|
|
|
### Force 5GHz
|
|
```bash
|
|
mode_sta 5 # Connect on 5GHz only
|
|
mode_sta 5.0 # Same as above
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Status Check
|
|
|
|
```bash
|
|
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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# All devices: Force 5GHz connection
|
|
mode_sta 5
|
|
|
|
# After connection, monitor on AP's channel
|
|
mode_monitor 149/80
|
|
```
|
|
|
|
---
|
|
|
|
## ⚡ Performance Tips
|
|
|
|
### For Maximum Range
|
|
```bash
|
|
mode_sta 2.4 # Connect on 2.4GHz
|
|
mode_monitor 6/20 # Monitor with 20MHz
|
|
```
|
|
|
|
### For Maximum Speed
|
|
```bash
|
|
mode_sta 5 # Connect on 5GHz
|
|
mode_monitor 149/80 # Monitor with 80MHz
|
|
```
|
|
|
|
### For Dense Environments
|
|
```bash
|
|
mode_sta 5 # Prefer 5GHz (less congestion)
|
|
mode_monitor 149/20 # Narrow bandwidth (less interference)
|
|
```
|
|
|
|
### For WiFi 6 Testing
|
|
```bash
|
|
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!
|