Wemos D1 Mini OLED Display Module: Wiring and First Sketch

By Kunkune | Published: 2026-11-03

Category: How-to Guides

Wire a 0.66-inch I2C OLED to your Wemos D1 Mini and run a first test sketch. Covers pin mapping, address checks, and common mistakes.

Quick answer

Wire the OLED’s VCC to 3.3V, GND to GND, SCL to D1, and SDA to D2 on the Wemos D1 Mini, then run an I2C scanner to confirm the display address before loading a graphics sketch. The 0.66-inch module is small, so plan your layout around short, direct jumper wires.

Why the 0.66-inch size changes your wiring plan

A 0.66-inch 64×48 OLED is physically smaller than the common 0.96-inch 128×64 modules. That smaller footprint is handy on compact builds, but it also means the header pins sit closer together and the display area is less forgiving of a loose breadboard connection. Keep jumper wires short and avoid stacking the display where a USB cable or power lead will tug on it.

The module’s I2C interface uses only two signal lines, so you do not need to free up a full SPI pin set. That leaves more GPIO for sensors or buttons, but it also means a single bad SDA or SCL connection will blank the whole screen.

Power and logic-level trade-off

The Wemos D1 Mini’s 3.3V rail is the safe supply for this display; do not power it from 5V unless the module explicitly states 5V tolerance. The catalog record does not list a logic-level or voltage range, so treat 3.3V as the default and check any markings on the module you receive.

If you see random pixels or the display resets when a Wi-Fi transmission starts, the cause is often a shared 3.3V rail sagging under current spikes. A short, direct wire from the board’s 3.3V pin to VCC usually helps more than adding a larger display.

Step-by-step: wire and test the OLED

Map the four pins: Connect VCC to 3.3V, GND to GND, SCL to D1 (GPIO5), and SDA to D2 (GPIO4). Double-check the module’s silkscreen before powering up. Snap a photo of the wiring before you apply power so you can compare if the screen stays dark.
Run an I2C scanner first: Upload a simple I2C scanner sketch and open the Serial Monitor at 115200 baud. A working display usually reports an address such as 0x3C or 0x3D. If no address appears, swap SDA and SCL before changing any code.
Install the display library: Add the Adafruit SSD1306 and Adafruit GFX libraries in the Arduino IDE, then open a 64×48-compatible example or set the display dimensions in your sketch. Using a 128×64 example unchanged can push content off the visible area on a 64×48 panel.
Upload a minimal test sketch: Print a short line of text and a rectangle. If the screen stays blank, confirm the I2C address in the sketch matches the scanner result and that VCC is on 3.3V. A blank screen with a valid address often means the reset or address constant is wrong, not a dead display.
Secure the module and re-test: Press the display firmly into the breadboard or solder it to a perfboard, then rerun the sketch. Wiggle each jumper gently to check for intermittent contacts. Intermittent pixels after handling usually point to a loose GND or SDA wire, not a software bug.

Product facts

Wemos D1 mini 0.66 OLED Display Module 64×48 LCD Screen IIC I2C: 0.66-inch OLED display module with 64×48 resolution and IIC/I2C interface. The small 64×48 canvas fits short labels and icons, so design your first sketch around large text rather than dense dashboards.
Wemos D1 mini 0.66 OLED Display Module 64×48 LCD Screen IIC I2C