Tutorial 05: Adding ESP8266 Board Support

Introduction to the ESP8266

The ESP8266 is a legendary chip that democratized the Internet of Things. Before 2014, adding WiFi to a project cost $50-100. The ESP8266 changed everything by offering a complete WiFi solution for under $5.

ESP8266 Board Variants

OceanRemote supports the most popular ESP8266 development boards:

• ESP8266 D1 Mini - The most popular board for hobbyists. Compact size, 16 GPIO pins, micro-USB port. Perfect for most projects.
• ESP8266 D1 Large - Same chip, larger form factor. More GPIO pins broken out, breadboard-friendly layout.
• NodeMCU - The original ESP8266 dev board. Slightly larger than D1 Mini, very stable.
• ESP-01 - The bare-bones module (requires external programmer). Not recommended for beginners.

Step 1: Add ESP8266 to Arduino IDE

If you haven't already done this in Tutorial 04, here's a detailed walkthrough:

1. Open Arduino IDE
2. Go to File → Preferences (Windows/Linux) or Arduino IDE → Settings (Mac)
3. In the "Additional Boards Manager URLs" field, add:

4. Click OK
5. Go to Tools → Board → Boards Manager
6. Search for "esp8266"
7. Find "esp8266 by ESP8266 Community" and click Install (version 3.1.2 or newer)
8. Wait for installation to complete (2-5 minutes depending on internet speed)

Step 2: Selecting Your Board

After installation, you'll see many ESP8266 board options. Here's what to select for OceanRemote:

For ESP8266 D1 Mini (Most Common)

• Go to Tools → Board → ESP8266 Modules
• Select "LOLIN(WEMOS) D1 R2 & mini" or "NodeMCU 1.0 (ESP-12E Module)"
• Both work perfectly with the D1 Mini

For ESP8266 D1 Large

• Select "LOLIN(WEMOS) D1 R2 & mini" (same as D1 Mini)
• The D1 Large uses the same ESP-12E module

For NodeMCU

• Select "NodeMCU 1.0 (ESP-12E Module)"

Step 3: Configuring Board Settings

Once you've selected your board, configure these settings for optimal performance:

• Upload Speed: 115200 (or 921600 for faster uploads if your USB chip supports it)
• CPU Frequency: 80 MHz (more stable) or 160 MHz (faster but uses more power)
• Flash Size: 4MB (FS:2MB OTA:~1019KB) or 4MB (FS:3MB OTA:512KB)
• Debug Port: Disabled
• Debug Level: None
• lwIP Variant: v2 Lower Memory (recommended)
• VTables: Flash
• Exceptions: Enabled
• Erase Flash: Only Sketch (unless you need to clear all data)
• Port: Select your COM port (Windows) or /dev/cu.usbserial-* (Mac) or /dev/ttyUSB0 (Linux)

Step 4: Installing Required Libraries for ESP8266

OceanRemote firmware requires these libraries for ESP8266:

1. Go to Sketch → Include Library → Manage Libraries
2. Search for and install each library:

• ArduinoJson by Benoit Blanchon (version 6.x) - Required for all devices
• DHT sensor library by Adafruit - Required only if using DHT22 sensor
• Adafruit Unified Sensor - Dependency for DHT library
• OneWire by Jim Studt - Required only if using DS18B20 sensor
• DallasTemperature by Miles Burton - Required only if using DS18B20 sensor

Step 5: Testing Your ESP8266

Before flashing OceanRemote firmware, test your setup with a simple blink sketch:

// ESP8266 Blink Test
// The built-in LED is usually on GPIO2 (D4 on D1 Mini)

void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
  Serial.begin(115200);
  Serial.println("ESP8266 is alive!");
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);  // LED OFF (active low)
  delay(1000);
  digitalWrite(LED_BUILTIN, LOW);   // LED ON
  delay(1000);
}

1. Copy the code above into Arduino IDE
2. Select your board (Tools → Board → ESP8266 Modules → LOLIN(WEMOS) D1 R2 & mini)
3. Select your port (Tools → Port)
4. Click Verify (checkmark) to compile
5. Click Upload (right arrow)
6. Open Serial Monitor (Tools → Serial Monitor) at 115200 baud
7. You should see "ESP8266 is alive!" and the LED blinking

ESP8266 Pin Reference for OceanRemote

When generating firmware, OceanRemote uses these default pin mappings:

Next Steps

Now that your ESP8266 is ready, continue with:

• Tutorial 06: Adding ESP32 Board Support
• Tutorial 07: Setting Up Raspberry Pi Pico W
• Tutorial 08: Installing Required Libraries (detailed)
• Tutorial 09: Configuring Board Settings (detailed)
• Tutorial 10: ESP8266 D1 Mini Pinout and Wiring