ESP8266 NodeMCU

The ESP8266 NodeMCU is a classic, cost-effective WiFi board that popularised browser-based internet control of hardware.

ESP8266 NodeMCU

At a glance

Pins and properties exactly as the circuit editor and simulator define this part. The text below explains how to use them.

Board facts

Board facts
FactValue
Operating voltage3.3 V
FamilyEspressif
Python runtimemicropython
Wi-FiYes
BluetoothNo
Native USBNo

Pinout

Pinout of the ESP8266 NodeMCU. Select a label to see that pin in the table below.

The ESP8266 NodeMCU is a classic, cost-effective WiFi board that popularised browser-based internet control of hardware.


1. Hardware Specifications

  • Processor: Single-core 32-bit Tensilica L106 processor running at 80 MHz (can be overclocked to 160 MHz).
  • Logic Level: 3.3V. All pins operate on 3.3V logic.
  • Memory Limits: 4 MB Flash, 80 KB SRAM.
  • Wireless: Integrated 802.11 b/g/n Wi-Fi. No Bluetooth.

2. Detailed Pinout & GPIO Map (Board Labels vs. GPIO IDs)

[!IMPORTANT] GPIO ID Discrepancies: On the ESP8266 NodeMCU, the labels printed on the board (D0–D10) do NOT correspond to the GPIO numbers used in code. When programming in OMS, you must reference the GPIO ID listed below, rather than the physical board label:

Pins of this board
PinKindFeaturesAlternate functionsNotes
A0AnalogADC, Input onlyADC0Analog Input Only. Board scales raw 0V–1V chip limit to 0V–3.3V.
RSVSpecialReservedRESERVED
RSVSpecialReservedRESERVED
SD3GPIOPWM, ReservedGPIO10, FLASH
SD2GPIOPWM, ReservedGPIO9, FLASH
SD1GPIOPWM, ReservedGPIO8, FLASH
CMDGPIOPWM, ReservedGPIO11, FLASH
SD0GPIOPWM, ReservedGPIO7, FLASH
CLKGPIOPWM, ReservedGPIO6, FLASH
GNDGround
3V3Power3.3V
ENSpecialENABLE
RSTSpecialRESET
GNDGround
VINPower
D0GPIOPWMGPIO16, NO_INTERRUPTConnected to onboard diagnostic LED (active low).
D1GPIOPWMGPIO5, SCL, I2CI2C Clock channel.
D2GPIOPWMGPIO4, SDA, I2CI2C Data channel.
D3GPIOPWMGPIO0Bootstrap Pin. Must be pulled low to enter bootloader.
D4GPIOPWMGPIO2Bootstrap Pin. Connected to ESP-12 status LED (active low).
3V3Power3.3V
GNDGround
D5GPIOPWMGPIO14, SCK, SPISPI Serial Clock.
D6GPIOPWMGPIO12, MISO, SPISPI Master In Slave Out.
D7GPIOPWMGPIO13, MOSI, SPISPI Master Out Slave In.
D8GPIOPWMGPIO15, CS, SPIBootstrap Pin. Must be pulled low at boot to run application.
RXGPIOPWMGPIO3, UART0Connected to USB serial bridge. Interferes with flashes.
TXGPIOPWMGPIO1, UART0Connected to USB serial bridge. Interferes with flashes.
GNDGround
3V3Power3.3V

3. Critical Pin Warnings

  • Flash Memory Pins (GPIO 6 - GPIO 11): These pins are internally connected to the onboard SPI flash memory. Connecting sensors or pulling these pins high/low will instantly crash the ESP8266 and corrupt the application binaries.
  • Logic Tolerance: Pins are strictly 3.3V logic tolerant. Applying 5V directly to any GPIO will damage the module.

4. Compiler Settings & IDE Properties

When targeting this board, the compiler utilizes the following parameters:

  • FQBN: esp8266:esp8266:generic
  • Default Flashing Baud Rate: 115200
  • Flash Mode / File Type: esp (uploaded as a consolidated binary file)
  • Flash Memory Offsets: { bootloader: 0x0000, partitions: 0x0000, app: 0x0000 } (monolithic compilation)
  • Programming Runtimes: Supports C++ (Arduino) and MicroPython.

5. Supported Blockly Board Blocks

All of the generic Board IO blocks from Section 3.2 are available: board_builtin_led (controls D4's diagnostic LED), board_digital_write/board_digital_read, board_analog_read (the single A0 pin), board_attach_interrupt, board_hw_timer, board_deep_sleep. This chip has no DAC, Hall sensor, or touch hardware, so board_analog_out always falls back to a PWM approximation and board_read_touch/board_internal_hall aren't usable.

WiFi (wifi_connect and more) requires installing the separate Wi-Fi extension first — there is no board-specific esp8266_wifi_connect block.


6. Simulator and Flashing Diagnostics

  • Simulator: Digital states and simple loops run locally. Simulated A0 input returns value 0–1023. Wireless routines are bypassed.
  • Flashing Guide: Connect the USB cable. Select the COM port corresponding to your CH340 or CP2102 serial driver. Click Flash. NodeMCU includes an auto-reset circuit (using DTR/RTS flow control lines) to enter flashing mode automatically. If flashing times out, hold the FLASH (GPIO 0 / D3) button, press RST, and release FLASH to manually trigger bootloader mode.

7. Communication Buses & Electrical Capabilities

Beyond the per-pin table above, here's the board's bus-level capability summary (from its own capabilities config):

BusDetails
UART1 hardware bus — TX on D10/GPIO1, RX on D9/GPIO3, shared with the USB programming port.
I2CDefault on D2 (SDA) / D1 (SCL).
SPIDefault on MOSI D7, MISO D6, SCK D5, CS D8.
1-WireNo dedicated 1-Wire hardware peripheral. Sensors like the DHT11 bit-bang the timing on any regular digital pin instead.
Analog (ADC)1 input-only pin (A0), 10-bit resolution. No hardware DAC, no touch, no Hall sensor.
PWM8 channels, 10-bit resolution, up to ~1 kHz — notably lower max frequency than the true ESP32 chips.

Electrical limits: max 12 mA per pin (lower than ESP32/S2/S3/C3 — this chip's I/O drivers are weaker), max 500 mA total across all pins combined.


8. Further Reading


ESP8266 NodeMCU — OMS Parts