ESP8266 NodeMCU V3 & ESP-12E

Digital GPIO Pins (D0 - D8)

11 digital I/O pins operating at 3.3V logic (NOT 5V tolerant). All pins except D0 support PWM.

• Pins D1 (GPIO5) and D2 (GPIO4) are the standard default I2C pins (SCL and SDA)
• Pin D4 (GPIO2) connected to onboard blue LED and must be HIGH during boot
• Pin D3 (GPIO0) controls boot mode: LOW enters flash mode, HIGH runs normal code

Analog Input Channel (A0 / ADC0)

Single 10-bit analog-to-digital converter reading from 0V up to 3.3V (due to onboard voltage divider).

• Raw ESP8266 chip ADC input accepts only 0V to 1.0V max
• NodeMCU PCB includes an internal 220k/100k voltage divider expanding range to 0–3.3V
• Reads discrete integer values from 0 to 1023 (approx. 3.22 mV per step)

Power Rails & Boot Strapping Pins

Regulated 3.3V power rails, USB input, and essential boot configuration pins.

• VIN accepts 5V input from USB or external regulated power source
• 3V3 pin delivers up to 500mA from the onboard AMS1117-3.3 linear regulator
• Pin D8 (GPIO15) must be pulled LOW at boot; D4 (GPIO2) must be pulled HIGH at boot

Hardware UART 0

GPIO 3 (RXD0) & GPIO 1 (TXD0)

Primary UART connected to the USB converter for flashing firmware and Serial Monitor logging.

Transmit UART 1

GPIO 2 (TXD1)

Secondary transmit-only UART port useful for streaming debug logs while UART 0 communicates with another device.

Software I2C Bus

D2 (GPIO4 / SDA) & D1 (GPIO5 / SCL)

Bit-banged I2C bus supported natively in the Wire library up to 400 kHz for OLEDs and BME280 sensors.

Hardware SPI (HSPI)

D5 (SCK), D6 (MISO), D7 (MOSI), D8 (CS)

Hardware SPI bus running up to 40 MHz for SD card readers, RFID-RC522 modules, and SPI displays.

Software PWM

Pins D1 through D8

Software-emulated pulse-width modulation operating up to 1 kHz with 10-bit duty cycle resolution (0–1023).

Over-The-Air (OTA)

Network Wi-Fi Socket

Flash new firmware wirelessly over Wi-Fi using ArduinoOTA without physically connecting a USB cable.

Wire pin D0 (GPIO16) directly to the RST pin. When the internal deep sleep timer expires, GPIO16 pulses LOW to wake the processor from 20 µA sleep.

Pro tip: Disconnect the D0-to-RST jumper wire while uploading new code via USB, as it can interfere with automatic reset.

Communicate between ESP8266 boards in under 5 milliseconds without needing a Wi-Fi router or access point using connectionless ESP-NOW packet frames.

Pro tip: ESP-NOW consumes 90% less power than standard Wi-Fi handshakes, ideal for remote battery buttons.

Serve compressed Gzip (.gz) web assets directly from SPI flash. Browsers decompress them automatically, speeding up page load times by 70%.

Pro tip: Use the VS Code / Arduino LittleFS upload tool to sync your local HTML folder into onboard flash.

The ESP8266 relies on cooperative multitasking. If your code blocks for more than 3 seconds without yielding to the Wi-Fi background stack, WDT resets the chip.

Pro tip: Never use blocking while() loops without calling yield() or delay(1) to avoid sudden "wdt reset" crashes.

Publish sensor states and subscribe to command topics using the lightweight PubSubClient library for instantaneous Home Assistant integration.

Pro tip: Use QoS 0 for periodic temperature logs and QoS 1 with retain flags for door security sensors.

Make secure HTTPS GET and POST requests to cloud APIs and Telegram bot notifications using the lightweight BearSSL TLS client engine.

Pro tip: Synchronize system time via NTP before verifying SSL certificates to prevent expiration validation errors.

Smart Home Relays & Appliances

Powers smart plugs, Sonoff switches, and relay controllers with direct Home Assistant integration via ESPHome or Tasmota.

MQTT Weather & Environmental Telemetry

Wakes from 20 µA deep-sleep, samples temperature/humidity sensors (DHT22, BME280), publishes data via MQTT over Wi-Fi, and re-enters sleep.

Self-Hosted Embedded Web Servers

Hosts responsive HTML5/CSS control dashboards directly out of 4MB LittleFS flash without requiring any external servers.

Instant Push & Webhook Alert Nodes

Monitors reed door switches or liquid level sensors to dispatch immediate Telegram, Discord, or Pushbullet notifications.

// ESP8266 NodeMCU - Web Server to Toggle Relay / LED
#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>

const char* ssid = "Your_WiFi_SSID";
const char* password = "Your_WiFi_Password";
ESP8266WebServer server(80);

const int relayPin = D1; // GPIO5

void handleRoot() {
  String html = "<html><body style='font-family:sans-serif;text-align:center;'>";
  html += "<h2>Volt X NodeMCU Web Controller</h2>";
  html += "<p><a href='/toggle'><button style='padding:15px;font-size:18px;'>Toggle Relay</button></a></p>";
  html += "</body></html>";
  server.send(200, "text/html", html);
}

void handleToggle() {
  digitalWrite(relayPin, !digitalRead(relayPin));
  server.sendHeader("Location", "/");
  server.send(303);
}

void setup() {
  Serial.begin(115200);
  pinMode(relayPin, OUTPUT);
  digitalWrite(relayPin, LOW);

  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println("
Connected! IP: " + WiFi.localIP().toString());

  server.on("/", handleRoot);
  server.on("/toggle", handleToggle);
  server.begin();
}

void loop() {
  server.handleClient();
}

# ESP8266 NodeMCU - MicroPython Wi-Fi Scanner & Connect
import network
import time

wlan = network.WLAN(network.STA_IF)
wlan.active(True)

print("Scanning for Wi-Fi networks...")
networks = wlan.scan()
for net in networks:
    ssid = net[0].decode('utf-8')
    rssi = net[3]
    print(f"SSID: {ssid:<20} Signal: {rssi} dBm")

wlan.connect('Your_WiFi_SSID', 'Your_WiFi_Password')
while not wlan.isconnected():
    time.sleep(0.5)

print("
Connected to Wi-Fi successfully!")
print("Network Config:", wlan.ifconfig())