Device Offline in Dashboard
Your OceanRemote device shows as OFFLINE in the dashboard. The device is not communicating with the server. This guide covers WiFi connection issues, power problems, token expiry, server connectivity, and hardware failures.
Last updated: April 22, 2026 | 12 min read
Symptoms
- Dashboard shows OFFLINE status for device
- Device LED is on but not responding to commands
- Serial Monitor shows no output or connection errors
- Device worked before but suddenly went offline
- Other devices work fine, only specific device offline
- Device appears in "Pending Devices" but never goes online
- Device reconnects briefly then goes offline again
Common Causes
- No Power to Device Device not powered, loose USB cable, or dead battery
- WiFi Disconnected Router issue, wrong credentials, or 5GHz network
- Registration Token Expired Token older than 24 hours, never used
- Token Already Used Same firmware flashed to multiple devices
- Server Connection Blocked Firewall or network blocking HTTPS to www.oceanremote.net
- Device ID Mismatch MAC address changed or EEPROM corrupted
- Hardware Failure Damaged ESP32/ESP8266 or voltage regulator
Device Connection Flow
1. Device powers on
2. Connects to WiFi
WiFi fails Check credentials, signal, 2.4GHz band
3. Loads permanent token from EEPROM
Token missing Go to registration flow
4. Requests session from /api/device/state/
401/410 Token invalid, re-register
200 OK Session created
5. Device appears ONLINE in dashboard
6. Polls every 3 seconds to stay online
Step-by-Step Fixes
1. Check Device Power
No power = no connection:
- Check if LED on device is lit
- Try different USB cable
- Try different USB port or power source
- If using battery, check charge level
- Measure voltage at 5V and 3.3V pins with multimeter
- For ESP8266/ESP32, 3.3V should be stable between 3.0V-3.3V
2. Open Serial Monitor
See what the device is actually doing:
- Connect device via USB
- Open Arduino IDE Serial Monitor
- Press RESET button on device
- Watch for error messages:
// GOOD - Device connecting normally:
// [WiFi] Connecting... Connected!
// [WiFi] IP Address: 192.168.1.100
// [SESSION] Got session ID: a1b2c3d4
// [INFO] Device ONLINE
// WiFi FAILURE - Check credentials, 2.4GHz:
// [WiFi] Connecting... Failed!
// [WiFi] Connection lost! Status: 0
// TOKEN FAILURE - Generate new firmware:
// [REG] HTTP Response: 401
// [REG] Token already used or expired
// NO OUTPUT - Check power, USB cable, or device may be dead
3. Check WiFi Credentials
Wrong credentials = no connection:
- Verify SSID and password in firmware
- Ensure network is 2.4GHz
- Check for spaces at beginning or end of SSID/password
- Test with mobile hotspot to isolate router issues
- If using special characters, try simpler password temporarily
4. Generate Fresh Firmware
Expired or used token is common:
- Go to OceanRemote dashboard "Your Device" page
- Click "Generate New Code"
- Copy the new firmware code
- Flash to device within 24 hours
- Device should register and appear online
5. Clear EEPROM and Re-flash
Corrupted token in EEPROM prevents connection:
// Upload this temporary code to clear EEPROM
#include <EEPROM.h>
void setup() {
Serial.begin;
EEPROM.begin;
// Clear all EEPROM
for {
EEPROM.write;
}
EEPROM.commit();
Serial.println;
}
void loop() {}
// After running:
// 1. Remove this code from Arduino IDE
// 2. Generate fresh firmware from OceanRemote
// 3. Flash normal firmware
// 4. Device should register as new device
6. Check Router and Network
Network issues can block connection:
- Restart router
- Check if other devices can connect to same WiFi
- Ensure router has available DHCP leases
- Check if router firewall is blocking outbound HTTPS
- Try connecting device to mobile hotspot to isolate router issue
7. Check Device Hardware
Hardware failure may be the cause:
- Try uploading a simple Blink sketch to verify hardware works
- If Blink fails to upload, USB-serial chip may be damaged
- Check for burnt components or swollen capacitors
- Try different ESP32/ESP8266 board if available
- If device was working and suddenly died, power surge may have damaged it
Serial Monitor Error Messages Reference
| Message | Meaning | Solution |
|---|---|---|
| [WiFi] Connecting... Failed! | WiFi credentials wrong or network not found | Check SSID/password, ensure 2.4GHz |
| [WiFi] Connection lost! Status: 0 | WiFi disconnected | Move closer to router, check power supply |
| [REG] HTTP Response: 401 | Token expired or invalid | Generate fresh firmware within 24 hours |
| [REG] HTTP Response: 410 | Token already used | Generate new firmware |
| [SESSION] Token invalid - will re-register | Permanent token corrupted or revoked | Clear EEPROM, generate fresh firmware |
| Brownout detector was triggered | Power supply voltage dropped | Add 470-1000F capacitor, upgrade power supply |
| wdt reset () | Watchdog timeout, code blocked | Add yield() in loops, reduce delay() |
Prevention Tips
- Always flash firmware within 24 hours of generation
- Use quality 5V 2A power supply with 470-1000F capacitor
- Ensure 2.4GHz WiFi network
- Keep device within range of router
- Save generated firmware code in text file for backup
- Monitor Serial Monitor after flash to verify registration
- Add WiFi auto-reconnect logic
Related Issues
Frequently Asked Questions
Q: Device was online but suddenly went offline. What happened?
A: Most likely power loss or WiFi outage. Check if device still has power. If power is OK, router may have rebooted or changed channel. Device should auto-reconnect within 30-60 seconds. If not, restart device.
Q: How long does it take for a device to reconnect after power loss?
A: Upon power-up, device boots , connects to WiFi , registers if needed . Total: 5-15 seconds to appear online.
Q: Device shows offline but I can ping its IP address. Why?
A: Device is on your local network but cannot reach OceanRemote servers. Check firewall, DNS, or if server is blocked. Try pinging www.oceanremote.net from the device .
Still having offline issues? Contact Support or return to the Troubleshooting Hub.