Quick Diagnostics
Before diving into specific issues, try these quick checks:
🔌 Power Check
- ✓ Is the LED matrix receiving power?
- ✓ Is the ESP32 LED blinking or lit?
- ✓ Are you using a proper 5V power supply (not USB only)?
📶 Network Check
- ✓ Can you see the device's WiFi AP?
- ✓ Is your phone/computer on the same network?
- ✓ Can you access http://led-matrix.local?
🔗 Bridge Check
- ✓ Is the bridge server running?
- ✓ Does the pairing code match?
- ✓ Is the embedded app showing "Connected"?
🌐 Webex Check
- ✓ Are Webex credentials configured?
- ✓ Has the OAuth token expired?
- ✓ Is your Webex status actually changing?
WiFi Connection Issues
Device not connecting to WiFi
- Check that WiFi password is correct (case-sensitive)
- Ensure your network uses 2.4GHz (ESP32 doesn't support 5GHz)
- Move device closer to the router
- Check if MAC filtering is enabled on your router
Can't find "LED-Matrix-Setup" network
- Hold the reset button for 10 seconds to factory reset
- Ensure device is powered on (LED matrix should light up)
- Wait 30 seconds after powering on for AP to start
Display Issues Issues
Display shows wrong status
- Check Webex connection in the device web UI
- Re-authenticate with Webex if token expired
- Verify correct user account is linked
Display is blank or flickering
- Check power supply (needs 5V/3A minimum)
- Verify all HUB75 connections are secure
- See Hardware Guide for pin mapping
Colors are wrong or garbled
- Check RGB wire connections match pin mapping
- Verify FM6126A driver chip compatibility
- Re-flash firmware if display was working before
Bridge Connection Issues
Can't connect to bridge
- Verify bridge URL is correct (wss:// for cloud, ws:// for local)
- Check that bridge server is running
- Ensure pairing code matches display code
- Check firewall isn't blocking WebSocket connections
Bridge keeps disconnecting
- Check network stability
- Verify bridge server isn't overloaded
- Try reconnecting after a minute
OTA Updates Issues
Update fails to install
- Ensure device has stable power during update
- Check available flash space
- Try updating from the device web UI instead of embedded app
Device stuck after update
- Wait 2 minutes for device to complete reboot
- If still stuck, re-flash via USB (see Install page)
- Use factory reset option in recovery section
Reset Options
🔄 Soft Reset (Reboot)
Press the reset button briefly, or use the reboot option in the web UI. This preserves all settings.
📡 WiFi Reset
Hold the reset button for 5 seconds. The device will restart in AP mode, allowing you to reconfigure WiFi while keeping other settings.
🗑️ Factory Reset
Hold the reset button for 10+ seconds. This erases ALL settings including WiFi, Webex credentials, and device name. Use as last resort.
Recovery via USB
If your device is completely unresponsive, you can always re-flash the firmware using the Web Installer. This will restore the device to a working state.
Still Need Help?
If you've tried the solutions above and still have issues: