Blog.Details | MakerSpaceKanpur

Call Now ! 7905582725
Email Now Help@makerspacekanpur.com

Smart Display Interface Using SSD1306 OLED & ESP32

24-06-2025

The SSD1306 is a popular controller used in OLED (Organic Light Emitting Diode) displays, most commonly found in small monochrome displays like 128x64 or 128x32 resolution screens. These displays are perfect for small embedded projects like IoT dashboards, sensor readouts, clocks, etc.

📦 1. What is SSD1306?

SSD1306 is a display driver IC developed by Solomon Systech.
It controls monochrome OLED panels using I²C or SPI communication.
Often embedded in 0.96-inch or 1.3-inch OLED displays.

📐 2. Common Specifications

Feature	Description
Resolution	128x64 or 128x32 pixels
Display Type	Monochrome OLED (white/blue/yellow)
Interface	I²C (2-wire) or SPI (4-wire)
Voltage	3.3V to 5V (check module)
Power Consumption	Very low (great for battery use)
Color	1-bit (pixel on or off)
Size (Popular)	0.96" diagonal

🧪 3. How it Works

The SSD1306 manages display memory and drives OLED pixels directly.
It includes a built-in graphics RAM (GDDRAM).
Each pixel is controlled by setting bits in this memory.
The controller handles:
- Display refreshing
- Contrast adjustment
- Scrolling (horizontal and vertical)
- Power-saving modes

🔌 4. Wiring SSD1306 to ESP32 (I²C)

Assuming you’re using an I²C SSD1306 (4 pins):

SSD1306 Pin	ESP32 Pin	Description
VCC	3.3V or 5V	Power supply
GND	GND	Ground
SDA	GPIO 21	I²C data
SCL	GPIO 22	I²C clock

📌 Some displays use SPI (7 pins). Let me know if you're using SPI instead.

🔧 5. ESP32 Setup

✅ Required Libraries:

Install via Library Manager:

Adafruit SSD1306
Adafruit GFX Library

🧠 6. Basic Code Example (128x64 I²C)

HOW TO OPERATE

#include <Wire.h>

#include <Adafruit_GFX.h>

#include <Adafruit_SSD1306.h>

#define SCREEN_WIDTH 128 // OLED display width

#define SCREEN_HEIGHT 32 // OLED display height

Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire);

void setup() {

Wire.begin();

display.begin(SSD1306_SWITCHCAPVCC, 0x3C); // Address may vary

display.clearDisplay();

display.display();

}

void loop() {

display.clearDisplay();

display.setTextSize(1);

display.setTextColor(WHITE);

display.setCursor(5, 5);

display.println("hello");

display.setTextSize(1);

display.setTextColor(WHITE);

display.setCursor(5, 20);

display.println("AKASH ");

// Draw a rectangle

display.drawRect(0, 0, 125, 32, WHITE);

// Display the image

display.display();

delay(2000);

}