Tutorial 15: Flashing Firmware to Your Device

Prerequisites

• ✅ OceanRemote account created and activated
• ✅ Arduino IDE installed (Tutorial 04)
• ✅ Board support installed (Tutorials 05-07 for your board)
• ✅ Required libraries installed (Tutorial 08)
• ✅ Your device wired and ready (Tutorials 10-14)
• ✅ USB cable (data, not charge-only)

Step 1: Generate Firmware from Dashboard

1. Log in to your OceanRemote dashboard
2. Click "Add New Device" button (or go to /your-device/)
3. Fill in the configuration form:
   • Board Type: Select your board (ESP8266 D1 Mini, ESP32, Pico W, etc.)
   • WiFi SSID: Your WiFi network name
   • WiFi Password: Your WiFi password
   • Relay Names: Custom names (e.g., "AC", "Fan", "Light")
   • Relay Logic: Positive (HIGH=ON) or Negative (LOW=ON) - most cheap relay modules use Negative Logic
   • Sensor Type: DHT22, DS18B20, NTC, or None
   • Sensor Configuration: For NTC, enter Beta, R25, and Series Resistor values
4. Click "Generate Firmware Code"
5. A modal window will appear with the complete firmware code
6. Click "Copy to Clipboard" or select all and copy (Ctrl+C / Cmd+C)

Step 2: Prepare Arduino IDE

1. Open Arduino IDE
2. Create a new sketch: File → New
3. Delete any existing code in the editor
4. Paste the copied firmware code (Ctrl+V / Cmd+V)
5. Select your board: Tools → Board → [Your Board]
6. Select the correct port: Tools → Port → [Your Port]
7. Verify board settings (Tutorial 09 for optimal settings)

Step 3: Flashing ESP8266 (D1 Mini / D1 Large)

Upload Steps:

1. Connect your ESP8266 to your computer via USB
2. Select the correct port (COM3 on Windows, /dev/cu.usbserial-* on Mac, /dev/ttyUSB0 on Linux)
3. Click the Verify button (✓ checkmark) to compile the code
4. Wait for compilation to complete (should say "Done compiling")
5. Click the Upload button (→ right arrow)
6. Watch the progress bar
7. Wait for "Done uploading" message

Expected ESP8266 Upload Output:
Compiling sketch...
Connecting........____
Uploading...
Done uploading.

ESP8266 Upload Troubleshooting:

Step 4: Flashing ESP32

Upload Steps:

1. Connect your ESP32 to your computer via USB
2. Select the correct port
3. Click Verify to compile
4. Click Upload
5. IMPORTANT: Hold the BOOT button on your ESP32 when you see "Connecting..." in the console
6. Release BOOT button when upload starts
7. Wait for "Done uploading"

Expected ESP32 Upload Output:
Compiling sketch...
Connecting...___ (press BOOT here)
Uploading...
Done uploading.

ESP32 Upload Troubleshooting:

Step 5: Flashing Raspberry Pi Pico W

The Pico W uses a different upload method (UF2 file copy). No COM port needed!

Upload Steps:

1. Disconnect the USB cable from your Pico W
2. Press and HOLD the BOOTSEL button (white button on the board)
3. While holding BOOTSEL, connect the USB cable to your computer
4. Release the BOOTSEL button after 2 seconds
5. A drive called "RPI-RP2" should appear on your computer
6. In Arduino IDE, select Tools → Board → Raspberry Pi RP2040 Boards → Raspberry Pi Pico W
7. You don't need to select a port (Pico W uses UF2 upload)
8. Click Verify to compile
9. Click Upload - Arduino will compile and copy the UF2 file to the Pico W
10. The Pico W will automatically reset and run your code

Expected Pico W Upload Output:
Compiling sketch...
Uploading...
Writing to RPI-RP2 drive...
Done uploading.

Pico W Upload Troubleshooting:

Step 6: Monitor Serial Output

After successful upload, open the Serial Monitor to see your device connect:

1. In Arduino IDE, go to Tools → Serial Monitor
2. Set baud rate to 115200 (bottom right corner)
3. You should see output like:

########################################
# OceanicRemote v4.4 - ESP8266 D1 Mini #
########################################
[SYSTEM] Device ID: ESP_AABBCCDDEEFF
[WiFi] Connecting... Connected!
[WiFi] IP: 192.168.1.100
[REG] Registering...
[REG] ✓ Registered!
[SESSION] Got session: a1b2c3d4
[SENSOR] DHT22 - Temp: 23.5°C, Hum: 45.2%
....

Step 7: Verify Device in Dashboard

1. Go to your OceanRemote dashboard
2. Your device should appear in the "My Devices" section
3. Check the status indicator:
   • 🟢 ONLINE (Green) - Device is communicating properly
   • 🟡 AWAY (Yellow) - Device was online but missed a few polls
   • 🔴 OFFLINE (Red) - Device is not communicating
4. Try toggling a relay - the button should change state
5. If you have a sensor, temperature should appear

Troubleshooting: Device Won't Connect

Problem: Serial Monitor Shows "WiFi Connecting... Failed"

• Check WiFi SSID and password in the generated firmware
• Make sure you're using 2.4GHz WiFi (ESP8266/ESP32/Pico W don't support 5GHz)
• Check WiFi signal strength (move device closer to router)
• Verify WiFi network doesn't have special characters in SSID/password

Problem: "Registration failed" or "Invalid token"

• Registration token expires after 24 hours. Generate new firmware if too much time passed.
• Make sure you didn't modify the token in the firmware code
• Check that your account is active (email confirmed)

Problem: Device shows OFFLINE in dashboard but Serial Monitor shows polling

• Check that the device ID in Serial Monitor matches the device in dashboard
• Wait 30 seconds - first connection may take time
• Check server connectivity: can your device reach www.oceanremote.net?
• Try power cycling the device

Problem: Relays not responding

• Check relay VCC is connected to 5V (not 3.3V)
• Verify relay logic (Positive vs Negative) in dashboard device settings
• Check that IN pins are connected to correct GPIOs (D1-D5 for ESP8266, GPIO16-20 for Pico W)
• Test GPIO pin with a multimeter or LED

After Successful Flash

Once your device is online, you can:

• Control relays - Click buttons in dashboard to turn devices ON/OFF
• Monitor sensors - View temperature and humidity in real-time
• Calibrate temperature - Add offset if readings are inaccurate
• Customize relay names - Change names in device settings
• Regenerate token - If you suspect your token was compromised
• Delete device - Remove from dashboard (cannot be undone)

Flashing Multiple Devices

To add more devices to your account:

1. Repeat Step 1 (Generate Firmware) for each new device
2. Each device gets its own unique token
3. Flash each device individually (same process)
4. All devices appear in your dashboard
5. You can control them independently