DOIT NodeMCU ESP8266 and ESP8285: Arduino First Upload
Setup, programming checks, troubleshooting and documentation for DOIT NodeMCU ESP8266 and ESP8285.
On this page
Identify board and USB bridgeInstall the ESP8266 Arduino coreUpload a serial-only testTest Wi-Fi, then add peripheralsIf the first upload failsRelated boardsOfficial references
This guide covers the ESP8266 NodeMCU-compatible board and ESP8285 NodeMCU-M. NodeMCU describes both hardware formats and Lua firmware; the name does not guarantee Lua is installed.
Identify board and USB bridge
Read module and USB bridge markings and the board revision. Start with the board alone and a USB data cable. Select the newly appearing port and install only the driver for the bridge present.
Install the ESP8266 Arduino core
- Install Arduino IDE and add the official package URL below in Preferences → Additional Boards Manager URLs.
- Install esp8266 by ESP8266 Community in Boards Manager. This differs from the ESP32 package.
- Use NodeMCU 1.0 (ESP-12E Module) only for the matching ESP-12E hardware. For NodeMCU-M/ESP8285, select the matching ESP8285 profile and verify flash size/mode; do not inherit ESP-12E memory settings.
https://arduino.esp8266.com/stable/package_esp8266com_index.json
Upload a serial-only test
Select the detected port and upload. Open Serial Monitor at 115200 baud. This test does not depend on an LED pin. Uploading replaces the previous application firmware.
void setup() {
Serial.begin(115200);
delay(500);
Serial.println("DOIT board serial test");
}
void loop() {
Serial.println("running");
delay(2000);
}
Test Wi-Fi, then add peripherals
Open the ESP8266 core WiFiScan example and check for nearby 2.4 GHz networks. Before wiring sensors, translate D-labels to GPIO numbers using the exact board pinout. Similar-looking revisions can have different header labels.
If the first upload fails
- No port: identify the USB bridge, use a data cable and the matching driver. A bare module has no USB bridge unless its carrier provides one.
- Connecting timeout: check ground, crossed UART wires, enable/reset and boot straps; disconnect peripherals from strapping pins.
- Repeated resets: inspect the 3.3 V rail during startup and radio activity. An adapter output may not supply the required peak current.
- Upload succeeds but the application fails: release the download strap, reset and check target, memory configuration and the serial log.
Related boards
| Product / variant family | SKU |
|---|---|
| ESP8266 Development Board, NodeMCU ESP-12E Compatible, Lua Wi-Fi IoT Board | DB41535 |
| ESP8285 NodeMCU-M Development Board Based on ESP-M2 Wi-Fi Module, Fully Compatible with NodeMCU | DB41557 |
Official references
- 8266 INSTALL — official documentation
- 8266 BOARDS — official documentation
- 8266 BOOT — official documentation
Documentation reviewed: 17 November 2026. Hardware instructions are based on the linked manufacturer documents; no physical bench test is claimed.
Share the product link, hardware revision, software version and any error messages.
Contact ESP32S support →