OLED display with I2C (SSD1306) in Arduino - Step-by-Step Execution

Concept Flow - OLED display with I2C (SSD1306)

Start Setup

↓

Initialize I2C

↓

Initialize OLED Display

↓

Clear Display

↓

Write Text or Graphics

↓

Display Update

↓

Loop or End

The program sets up I2C, initializes the OLED, clears it, writes content, and updates the display repeatedly.

Execution Sample

Arduino

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

Adafruit_SSD1306 display(128, 64, &Wire);

void setup() {
  Wire.begin();
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
  display.clearDisplay();
  display.setTextSize(1);
  display.setTextColor(SSD1306_WHITE);
  display.setCursor(0,0);
  display.println("Hello, OLED!");
  display.display();
}

void loop() {}

This code initializes the OLED display over I2C and shows the text 'Hello, OLED!' once.

Execution Table

Step	Action	I2C Init	OLED Init	Display Buffer	Display Output
1	Start setup()	Not started	Not started	Empty	Blank screen
2	Initialize I2C & OLED	I2C started	OLED initialized	Empty	Blank screen
3	Clear display buffer	I2C active	OLED ready	Empty	Blank screen
4	Set text size to 1	I2C active	OLED ready	Empty	Blank screen
5	Set text color to white	I2C active	OLED ready	Empty	Blank screen
6	Set cursor to (0,0)	I2C active	OLED ready	Cursor at (0,0)	Blank screen
7	Print 'Hello, OLED!'	I2C active	OLED ready	'Hello, OLED!' in buffer	Blank screen
8	Display buffer on screen	I2C active	OLED ready	'Hello, OLED!' in buffer	'Hello, OLED!' visible
9	Enter loop()	I2C active	OLED ready	'Hello, OLED!' in buffer	'Hello, OLED!' visible

💡 Loop runs indefinitely; display shows 'Hello, OLED!'

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 7	Final
I2C Status	Not started	Started	Active	Active	Active
OLED Status	Not started	Initialized	Ready	Ready	Ready
Display Buffer	Empty	Empty	Empty	'Hello, OLED!'	'Hello, OLED!'
Display Output	Blank	Blank	Blank	Blank	'Hello, OLED!'

Key Moments - 3 Insights

Why does the display stay blank until display.display() is called?

The display buffer holds the text but does not show it until display.display() sends the buffer to the screen, as shown in step 8 of the execution_table.

What happens if we don't call display.clearDisplay() before writing?

Old content remains in the buffer, so new text overlaps or mixes with old, causing messy output. Step 3 clears the buffer to avoid this.

Why do we set cursor position before printing text?

The cursor tells where text starts on the screen. Without setting it (step 6), text might print in unexpected places.

Visual Quiz - 3 Questions

Look at the execution_table at step 7, what is in the display buffer?

A 'Hello, OLED!'

B Empty

C Cursor position only

D Display output

💡 Hint

Check the 'Display Buffer' column at step 7 in the execution_table.

At which step does the text actually appear on the OLED screen?

A Step 3

B Step 7

C Step 8

D Step 6

💡 Hint

Look at the 'Display Output' column in the execution_table to see when text becomes visible.

If we skip display.clearDisplay(), what will happen to the display buffer?

A It will be empty

B Old content remains and mixes with new

C Cursor resets to (0,0)

D Display output updates immediately

💡 Hint

Refer to key_moments explanation about clearing the display buffer before writing.

Concept Snapshot

Include Wire and Adafruit_SSD1306 libraries
Initialize display with display.begin(SSD1306_SWITCHCAPVCC, 0x3C)
Clear buffer with display.clearDisplay()
Set text size, color, and cursor
Print text to buffer with display.println()
Show buffer on screen with display.display()

Full Transcript

This example shows how to use an OLED display with I2C using the SSD1306 driver on Arduino. First, the program starts by initializing the I2C communication and the OLED display. Then it clears the display buffer to remove any old content. Next, it sets the text size and color, and positions the cursor at the top-left corner. The text 'Hello, OLED!' is printed into the display buffer but not shown yet. Finally, calling display.display() sends the buffer to the screen, making the text visible. The loop function runs empty, so the display stays showing the text. Key points include clearing the display before writing new content and understanding that printing text only changes the buffer until display.display() is called.