ESP8266 NodeMCU

What is the ESP8266 NodeMCU?

The ESP8266 is a low-cost Wi-Fi microcontroller from Espressif Systems. It has a 32-bit processor at 80 MHz (160 MHz if you ask) and a full 2.4 GHz Wi-Fi radio on one chip. The NodeMCU is the open-source development board that puts it on a breadboard-friendly PCB with USB programming.

When it appeared in 2014, the ESP8266 cut the cost of adding Wi-Fi to a project to a few dollars. It is still one of the most popular chips for smart plugs, sensor loggers, web-controlled relays and home-automation gadgets. The most common board is the NodeMCU v1.0 (ESP-12E, CP2102). The wider LoLin “v3” uses a CH340 but has the same pinout.

The NodeMCU v1.0: the ESP-12E module does the work. The USB bridge, regulator and buttons let you power and program it from a PC.

Parts of the NodeMCU board

The ESP-12E Module

The metal can on the NodeMCU is the ESP-12E, a 16 × 24 mm module with 22 castellated pads. It holds the ESP8266EX chip, a 4 MB SPI flash, a 26 MHz crystal and a meander PCB antenna.

Outside: 8 pads per side plus 6 flash pads on the bottom. Inside: the ESP8266EX, 4 MB flash and 26 MHz crystal.

• ESP-01: the tiny 8-pin module with only GPIO0 and GPIO2 broken out, often used as a Wi-Fi add-on for Arduino.
• ESP-12E / ESP-12F: the full 22-pad modules used on NodeMCU and Wemos D1 mini. The 12F has a slightly better antenna.
• ESP-07: adds a u.FL connector for an external antenna.

Inside the ESP8266EX Chip

The ESP8266EX pairs a single Tensilica L106 32-bit RISC core with a complete Wi-Fi MAC, radio and a small set of peripherals.

One core and Wi-Fi on a single chip. Flash, crystal and antenna sit beside it inside the ESP-12E.

• CPU: 80 MHz by default, 160 MHz selectable. The Wi-Fi stack shares this core, so call delay() or yield() in long loops, or the watchdog resets the chip.
• Memory: your program runs from external flash through a cache. About 80 KB of RAM is left for data, with roughly 40–50 KB free once Wi-Fi is running.
• Peripherals: one 10-bit ADC, two UARTs (one TX-only) and a hardware SPI. PWM and I2C run in software on any pin.

Full ESP8266 NodeMCU Pinout

Here is the complete 30-pin NodeMCU v1.0 pinout. Each pin shows its board label (D0, D1…), the real GPIO number and its functions: I2C, SPI, UART, boot, wake and flash.

The full NodeMCU pinout, colour-coded. Note that D1 is GPIO5, not GPIO1.

Here is the same information as a quick colour map:

NodeMCU pinout at a glance: board label on top, GPIO number below.

D-pin to GPIO mapping

Every NodeMCU Pin Explained

Now let's look at what each group of pins does. In Arduino code you can use either the board label (D1) or the GPIO number (5).

Power & control pins

GPIO pins

All D-pins work with pinMode(), digitalWrite() and digitalRead() at 3.3 V logic. GPIO0–15 have internal pull-ups (INPUT_PULLUP). GPIO16 (D0) only has a pull-down (INPUT_PULLDOWN_16). Keep each pin to about 12 mA and switch relays or motors through a transistor or MOSFET.

Which NodeMCU Pins Are Safe to Use?

The NodeMCU has fewer free pins than it seems. This chart sorts them:

Start with the green pins. Use the amber boot pins carefully and never touch the red ones.

Boot Modes & Strapping Pins

At every reset the ESP8266 reads GPIO15, GPIO0 and GPIO2 to decide how to boot. Getting this wrong is the most common reason a NodeMCU project “won't start”.

Normal boot needs D8 LOW, D3 HIGH, D4 HIGH. The board's resistors set these defaults for you.

Powering the NodeMCU

Feed the board 5 V through USB or VIN. The AMS1117 regulator makes the 3.3 V the ESP8266 needs.

USB or VIN → AMS1117 → 3.3 V. A diode protects your PC's USB port when VIN is used.

Analog Input A0

The ESP8266 has just one 10-bit ADC. On the NodeMCU it is the A0 pin, and analogRead(A0) returns 0–1023.

The on-board 220k/100k divider scales 3.3 V down to the chip's 1.0 V ADC range.

Bare ESP-12 modules and some other boards have no divider, so their ADC only accepts 0–1.0 V. Check before connecting 3.3 V. You can also read the supply voltage with ADC_MODE(ADC_VCC) and ESP.getVcc(), but then A0 can't be used for sensors.

PWM Output

The ESP8266 makes PWM in software on any GPIO except D0. Use analogWrite(pin, 0…255). The default frequency is 1 kHz (see pulse & PWM signals).

25/50/75 % duty → 0.83/1.65/2.48 V average on a 3.3 V pin.

// fade an LED on D1
void setup() { pinMode(D1, OUTPUT); }
void loop() {
  for (int d = 0; d <= 255; d++) { analogWrite(D1, d); delay(4); }
  for (int d = 255; d >= 0; d--) { analogWrite(D1, d); delay(4); }
}

ESP8266 Arduino core 3.x uses a 0–255 range like an Uno. Core 2.x used 0–1023; call analogWriteRange(1023) if an older sketch looks too bright.

Communication: UART, I2C & SPI

The NodeMCU has a full UART0 (USB), a transmit-only UART1, software I2C on any pins, and the hardware HSPI bus.

Defaults: I2C on D2/D1, SPI on D5–D8, Serial on RX/TX.

// scan the I2C bus on D2 (SDA) / D1 (SCL)
#include <Wire.h>
void setup() {
  Serial.begin(115200);
  Wire.begin(D2, D1);
  for (byte a = 1; a < 127; a++) {
    Wire.beginTransmission(a);
    if (Wire.endTransmission() == 0) Serial.printf("Found device at 0x%02X\n", a);
  }
}
void loop() {}

Wi-Fi on the ESP8266

Wi-Fi is what the ESP8266 is for. It can join your router (Station), create its own hotspot (Access Point), do both at once, or talk board-to-board with ESP-NOW. It has no Bluetooth.

STA, AP, STA+AP and ESP-NOW. For Bluetooth or BLE, use the ESP32.

// connect to Wi-Fi and print the IP address
#include <ESP8266WiFi.h>
void setup() {
  Serial.begin(115200);
  WiFi.mode(WIFI_STA);
  WiFi.begin("YOUR_SSID", "YOUR_PASSWORD");
  while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); }
  Serial.println(WiFi.localIP());
}
void loop() {}

Useful extras: mDNS (ESP8266mDNS) lets you open http://mydevice.local, ArduinoOTA uploads new code over Wi-Fi, and WiFiManager shows a setup page so users can enter their Wi-Fi password without re-flashing.

Deep Sleep

With Wi-Fi transmitting, the ESP8266 draws around 170 mA. In deep sleep it needs about 20 µA. To wake itself up, D0 (GPIO16) must be wired to RST.

At the end of the sleep time GPIO16 pulses LOW. Through the jumper, that resets the chip and setup() runs again.

Programming the NodeMCU & Uploading Code

You can program the ESP8266 with the Arduino IDE, PlatformIO, MicroPython or the original NodeMCU Lua firmware. The Arduino IDE is the most popular choice.

The USB bridge resets the chip into its ROM bootloader and esptool writes the flash.

Set up the Arduino IDE

1. Open File → Preferences and add to Additional boards manager URLs:
   https://arduino.esp8266.com/stable/package_esp8266com_index.json
2. In Boards Manager, install esp8266 by ESP8266 Community.
3. Choose Tools → Board → NodeMCU 1.0 (ESP-12E Module) and your Port. No port? Install the CP210x or CH340 driver.
4. Click Upload and open the Serial Monitor at 115200 baud.

ESP8266 NodeMCU Code Examples

Short, copy-paste sketches for the Arduino IDE.

An LED on D1 (GPIO5) through a 220 Ω resistor.

1. Blink an external LED on D1

#define LED D1            // GPIO5
void setup() { pinMode(LED, OUTPUT); }
void loop() {
  digitalWrite(LED, HIGH); delay(500);
  digitalWrite(LED, LOW);  delay(500);
}

2. Blink the built-in LED (active-LOW)

void setup() { pinMode(LED_BUILTIN, OUTPUT); }   // GPIO2 / D4
void loop() {
  digitalWrite(LED_BUILTIN, LOW);  delay(200);    // LOW = ON
  digitalWrite(LED_BUILTIN, HIGH); delay(800);
}

3. Read a button with the internal pull-up

void setup() {
  pinMode(D5, INPUT_PULLUP);          // button between D5 and GND
  pinMode(D1, OUTPUT);
}
void loop() {
  digitalWrite(D1, digitalRead(D5) == LOW);   // LED on while pressed
}

4. Deep sleep for one minute

// wire D0 to RST (remove while uploading)
void setup() {
  Serial.begin(115200);
  Serial.println("Awake! Doing work...");
  ESP.deepSleep(60e6);                // 60 s in microseconds
}
void loop() {}

Beginner NodeMCU Mini-Projects

Small, complete projects that use the NodeMCU's Wi-Fi from day one.

#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>
ESP8266WebServer server(80);
void page() {
  server.send(200, "text/html",
    "<h1>NodeMCU</h1><a href='/on'>ON</a> | <a href='/off'>OFF</a>");
}
void setup() {
  pinMode(D1, OUTPUT);
  Serial.begin(115200);
  WiFi.begin("YOUR_SSID", "YOUR_PASSWORD");
  while (WiFi.status() != WL_CONNECTED) delay(500);
  Serial.println(WiFi.localIP());
  server.on("/", page);
  server.on("/on",  [](){ digitalWrite(D1, HIGH); page(); });
  server.on("/off", [](){ digitalWrite(D1, LOW);  page(); });
  server.begin();
}
void loop() { server.handleClient(); }

void setup() { pinMode(D1, OUTPUT); }
void loop() {
  int raw = analogRead(A0);                  // 0..1023
  analogWrite(D1, map(raw, 0, 1023, 0, 255));  // 0..255 duty
  delay(10);
}

#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>
ESP8266WebServer server(80);
void setup() {
  Serial.begin(115200);
  WiFi.begin("YOUR_SSID", "YOUR_PASSWORD");
  while (WiFi.status() != WL_CONNECTED) delay(500);
  Serial.println(WiFi.localIP());
  server.on("/light", [](){
    server.send(200, "application/json", "{\"light\":" + String(analogRead(A0)) + "}");
  });
  server.begin();
}
void loop() { server.handleClient(); }

void setup() {
  Serial.begin(115200);
  Serial.printf("Light level: %d\n", analogRead(A0));
  ESP.deepSleep(5 * 60e6);            // 5 minutes
}
void loop() {}

ESP8266 vs ESP32

The ESP32 is the ESP8266's bigger brother. Here is how they compare:

The ESP8266 is simpler and cheaper; the ESP32 has more of everything.

NodeMCU vs Arduino Uno: the NodeMCU has a much faster 32-bit CPU, far more flash and built-in Wi-Fi, but uses 3.3 V logic and has only one analog pin. The Arduino Uno is 5 V, has 6 analog inputs and supports classic shields.

ESP8266 NodeMCU Specifications

Key numbers for the NodeMCU v1.0 (ESP-12E).

Key Terms — Glossary

Related Topics & Common Searches

Keep building with these Power4All guides:

People Also Search For

esp8266 · nodemcu · nodemcu pinout · esp8266 pinout · nodemcu v1.0 pinout · nodemcu v3 pinout · esp-12e pinout · nodemcu d1 pin gpio · nodemcu gpio mapping · esp8266 safe pins · esp8266 boot pins · gpio0 gpio2 gpio15 · esp8266 won't boot · nodemcu a0 pin voltage · esp8266 analogread · esp8266 analogwrite range · nodemcu i2c pins · nodemcu spi pins · esp8266 serial swap · esp8266 wifi code · esp8266 web server · esp8266 access point · esp8266 deep sleep d0 rst · esp8266 power consumption · esp8266 5v tolerant · esp8266 arduino ide setup · esp8266 board manager url · nodemcu cp2102 driver · nodemcu ch340 · esp8266 74880 baud · esp8266 wdt reset · nodemcu blink · esp8266 projects for beginners · esp8266 vs esp32 · nodemcu vs arduino · esp8266 specifications.

Frequently Asked Questions

Quick answers to the questions people ask most about the ESP8266 NodeMCU.

Conclusion & Key Takeaways

The ESP8266 NodeMCU is the cheapest, simplest way to put a project on Wi-Fi. Learn the D-pin mapping, respect the three boot pins and remember it's a 3.3 V chip, and it will serve you well.

Continue Learning