Wi-Fi Provisioning and Recovery
Provision an ESP-class device without hard-coding production credentials, then test reconnect and reset behaviour.
Topology and objective
Phone or laptop → temporary setup portal → device credential store → Wi-Fi access point.
Hardware and tools
- Supported development board
- USB data cable
- Current-limited supply
- Serial monitor and logic analyser when applicable
Security and RF safety
- Use WPA2/WPA3; never log passwords.nRate-limit provisioning attempts.nRequire physical action to erase or replace credentials.
Practical procedure
- Start with a dedicated lab SSID.nOpen the temporary provisioning portal and submit test credentials.nConfirm connection, IP address and signal strength.nPower-cycle the device and verify secure reconnect.nTrigger credential reset and confirm old credentials are erased.
Telemetry / payload
{"device":"esp32-lab-01","wifi_state":"connected","rssi":-58}Starter code / config
Provision credentials through the device portal; store secrets outside source code.Expected results
| Checkpoint | Expected | Tool |
|---|---|---|
| Provisioning | Device joins lab SSID | Router / SerialnRecovery |
Troubleshooting
| Symptom | Check | Action |
|---|---|---|
| Portal does not open | Check AP mode and phone mobile-data switching | Connect directly to setup SSIDnRepeated disconnect |
Local-only sandbox
Commands & telemetry simulator
Send command
Simulator ready. No network connection is used.