Documentation

Overview

The ESP8266 NodeMCU board with built-in 0.96-inch 128×64 OLED display is the most ready-to-go IoT development board you can buy — everything you need to build a connected display project (weather widget, IoT dashboard, MQTT subscriber, network monitor, sensor visualizer) is integrated into one board. The ESP8266 chip handles WiFi (802.11 b/g/n) and runs your code; the SSD1306 OLED gives you an instant 128×64 visual output without any extra wiring; the onboard CH340 USB-to-serial bridge makes it programmable directly from a Type-C cable.

Use it for IoT projects that need a small visual output (weather station, AQI monitor, crypto ticker, network attached display, MQTT subscriber, temperature/humidity logger, NTP clock, etc.). Programmable from the Arduino IDE with the ESP8266 board package, MicroPython, or NodeMCU's Lua firmware. The OLED shares I2C with GPIO5 (SCL) and GPIO4 (SDA) by default, leaving 9 other usable GPIO pins free for sensors, buttons, and accessories.

The board has all the standard ESP8266 features: 4 MB flash, deep-sleep capability, OTA firmware updates over WiFi, SPI / UART / I2C buses, ADC input, and onboard 3.3V regulator. Power can come from the Type-C port (5V from PC or USB charger) or directly from the VIN pin (5V) or 3V3 pin.

At a Glance

Specifications

Pinout Diagram

Pin Reference

Code Examples

Display "Hello World" on the OLED (Arduino IDE)

#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);

void setup() {
  Serial.begin(115200);
  Wire.begin(4, 5);  // SDA=GPIO4, SCL=GPIO5
  if (!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) {
    Serial.println("OLED not found");
    for (;;);
  }
  display.clearDisplay();
  display.setTextSize(2);
  display.setTextColor(SSD1306_WHITE);
  display.setCursor(0, 16);
  display.println("Hello!");
  display.display();
}

void loop() {}

WiFi-Connected OLED IP Display

#include <ESP8266WiFi.h>
#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

Adafruit_SSD1306 display(128, 64, &Wire, -1);
const char* ssid = "your-ssid";
const char* pwd  = "your-pwd";

void setup() {
  Wire.begin(4, 5);
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
  display.clearDisplay();
  display.setTextSize(1);
  display.setTextColor(SSD1306_WHITE);
  display.setCursor(0,0);
  display.println("Connecting WiFi...");
  display.display();

  WiFi.begin(ssid, pwd);
  while (WiFi.status() != WL_CONNECTED) delay(200);

  display.clearDisplay();
  display.setCursor(0,0);
  display.println("Connected!");
  display.println(WiFi.localIP());
  display.display();
}

void loop() {}

Frequently Asked Questions