-
Notifications
You must be signed in to change notification settings - Fork 0
WiFi Scanning Analysis
Comprehensive guide to WiFi network discovery and analysis features in ESP32 WiFi Utility v4.2.0.
The ESP32 WiFi Utility provides professional-grade WiFi scanning capabilities with enhanced network analysis, signal quality assessment, channel congestion detection, and security evaluation.
Automatic periodic scanning at 5-second intervals.
Enable:
> mode station
> scan on
β WiFi scanning ENABLEDFeatures:
- Updates every 5 seconds
- Displays new networks automatically
- Runs in background
- Cache management (50 networks, 5-minute timeout)
Disable:
> scan off
β WiFi scanning DISABLEDSingle comprehensive scan with detailed analysis.
Command:
> scan nowFeatures:
- One-time detailed scan
- Enhanced network analysis
- Professional table layout
- Signal quality indicators
- Channel information
- Security assessment
Each discovered network shows:
- ID: Sequential number for reference
-
SSID: Network name (or
<Hidden Network>) - RSSI: Signal strength in dBm
- Channel: WiFi channel (1-14 for 2.4GHz)
- Encryption: Security type
- Quality: Signal quality percentage
- BSSID: Access point MAC address
RSSI Scale:
- Excellent: -30 to -50 dBm (π’ 90-100%)
- Good: -50 to -60 dBm (π’ 70-90%)
- Fair: -60 to -70 dBm (π‘ 50-70%)
- Weak: -70 to -80 dBm (π 30-50%)
- Very Weak: -80+ dBm (π΄ 0-30%)
Quality Calculation:
Quality = 2 Γ (RSSI + 100)
Clamped between 0-100%
Supported Types:
- π Open: No security (not recommended)
- π WEP: Weak Encryption Protocol (deprecated)
- π WPA: WiFi Protected Access
- π WPA2: Modern security standard
- π WPA3: Latest security (most secure)
- π’ WPA2 Enterprise: Corporate/business networks
> scan info <id>Example:
> scan info 1
π‘ === Detailed Network Information === π‘
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β π·οΈ Network Name: HomeWiFi β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β π BSSID (MAC): AA:BB:CC:DD:EE:FF β
β πΆ Signal (RSSI): -42 dBm β
β π Signal Quality: 95% (Excellent) π’π’π’π’ β
β π» Channel: 6 (2.4GHz) β
β π¦ Congestion: Light (2 networks on this channel) β
β π Security: π WPA2 Personal β
β π‘οΈ Security Level: π’ Good β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β π‘ Connection Analysis: β
β πΆ Excellent signal strength for stable connection β
β π Est. Speed: 50-150 Mbps (802.11n) β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββSignal Quality:
- 8-level quality scale (0-100%)
- Visual indicators (π’π‘π π΄)
- Textual ratings (Excellent, Good, Fair, Weak)
- Bar chart representation
Channel Congestion:
- Network count on same channel
- 5-level congestion scale:
- Clear (0-2 networks)
- Light (3-5 networks)
- Moderate (6-8 networks)
- Heavy (9-12 networks)
- Severe (13+ networks)
Security Assessment:
- Encryption type identification
- Security strength rating
- Vulnerability warnings
- Recommendations
Connection Recommendations:
- Signal strength evaluation
- Channel quality assessment
- Security analysis
- Overall connection score
After each scan, displays:
Security Distribution:
- Count by encryption type
- Open networks highlighted
- WPA3 availability noted
Signal Strength:
- Strong signals (>-60dBm)
- Weak signals (<-80dBm)
- Average signal quality
Channel Usage:
- Most congested channels
- Least used channels
- Recommended channels for AP setup
Example:
π Network Summary:
ββ π Open: 1 π WEP: 0 π WPA2: 8 π WPA3: 2
ββ πΆ Strong signals (>-60dBm): 5
ββ π± Weak signals (<-80dBm): 2
ββ π‘ Most congested channel: 6 (4 networks)
ββ π‘ Recommended channels: 1, 11, 13
Features:
- Stores up to 50 networks
- 5-minute cache timeout
- Automatic LRU eviction
- Fast detail lookups
Benefits:
- Reduced scan frequency
- Lower power consumption
- Faster information access
- Consistent ID numbering
Network Addition:
- New networks added automatically
- Duplicate SSIDs merged by BSSID
- Signal strength updated
Cache Expiration:
- Networks removed after 5 minutes
- Triggered on next scan
- Stale data prevention
Access at http://[device-ip]/scanner
Features:
- Button-triggered scanning
- Progress indicators
- Real-time results
- Clickable network rows
- Detailed popup information
- Mobile-responsive design
Advantages:
- Visual network list
- Easy comparison
- One-click details
- No terminal required
Click any network to view:
- Complete network information
- Visual signal quality indicators
- Channel congestion analysis
- Security evaluation
- Connection recommendations
- Estimated throughput
Detection:
- Shown as
<Hidden Network> - MAC address visible
- Signal strength available
- Can still connect if SSID known
Connection:
> connect "HiddenSSID" "password"2.4GHz Band:
- Channels 1-14
- Longer range
- Better wall penetration
- More congestion
5GHz Band:
- Not supported by ESP32
- ESP32 hardware limitation
- Future ESP32-C6 may add support
Each channel maps to specific frequency:
- Channel 1: 2412 MHz
- Channel 6: 2437 MHz
- Channel 11: 2462 MHz
- Channel 13: 2472 MHz
- (Channel spacing: 5 MHz)
Quick Scan:
- Duration: 3-5 seconds
- All channels (1-14)
- Basic information
Detailed Scan:
- Duration: 3-5 seconds
- Enhanced analysis
- Quality assessment
- Recommendations
RSSI Precision:
- Β±1 dBm accuracy
- Averaged over multiple samples
- Environment-dependent
Reliability:
- 99.5%+ successful completion
- Automatic retry on failure
- Error handling and recovery
Memory:
- ~8KB for scan data
- 50-network cache: ~4KB
- Efficient string management
Power:
- Active scanning: ~260mA
- Idle between scans: ~80mA
- Scan-off mode: ~80mA
Possible Causes:
- Not in station mode
- WiFi interference
- Hardware issue
- No networks in range
Solutions:
> mode station
> scan nowCauses:
- Weak signals filtered
- Hidden networks
- Scan interrupted
Solutions:
- Move closer to APs
- Retry scan
- Check interference
Causes:
- Channel congestion
- Many networks present
- Hardware limitations
Expected:
- 3-5 seconds normal
- Up to 8 seconds if 40+ networks
Factors:
- Physical obstacles
- Distance to AP
- Antenna orientation
- Interference
Mitigation:
- Multiple scans
- Average readings
- Consider environment
GitHub Repository β’ Report Issues β’ Discussions
ESP32 WiFi Utility v4.2.0 β’ MIT License β’ Β© Arunkumar Mourougappane
Version: 4.2.0
License: MIT