OLED display with I2C (SSD1306) in Arduino - Mini Project: Build & Apply

OLED display with I2C (SSD1306)

📖 Scenario: You have a small OLED screen connected to your Arduino using I2C. You want to show a simple message on the screen.

🎯 Goal: Write a program that initializes the OLED display and shows the text "Hello, Arduino!" on it.

📋 What You'll Learn

Use the Wire library for I2C communication

Use the Adafruit_SSD1306 library to control the OLED

Initialize the display with the correct width and height

Clear the display before writing

Display the text "Hello, Arduino!" at the top-left corner

Update the display to show the text

💡 Why This Matters

🌍 Real World

OLED displays with I2C are common in small gadgets, wearables, and IoT devices to show information clearly and efficiently.

💼 Career

Understanding how to control OLED displays is useful for embedded systems developers, IoT engineers, and hobbyists working with microcontrollers.

1

Setup OLED display object

Include the Wire.h and Adafruit_SSD1306.h libraries. Create an Adafruit_SSD1306 object called display with width 128, height 64, and use Wire for I2C.

Arduino

# Include necessary libraries
// Your code here

Hint

Use #include to add libraries. Create the display object with the correct size and I2C interface.

2

Initialize the display in setup()

Write the setup() function. Inside it, call display.begin(SSD1306_SWITCHCAPVCC, 0x3C) to initialize the display. Then clear the display buffer with display.clearDisplay().

Arduino

#include 
#include 

#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64

Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire);

void setup() {
  // Initialize the display
  // Your code here
}

Hint

Use display.begin() with SSD1306_SWITCHCAPVCC and address 0x3C. Then clear the display buffer.

3

Write text to the display buffer

In the setup() function, after clearing the display, set the text size to 1 with display.setTextSize(1), set the text color to white with display.setTextColor(SSD1306_WHITE), and set the cursor to position (0,0) with display.setCursor(0, 0). Then write the text "Hello, Arduino!" using display.println().

Arduino

#include 
#include 

#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64

Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire);

void setup() {
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
  display.clearDisplay();

  // Set text size, color, cursor and print text
  // Your code here
}

Hint

Use setTextSize, setTextColor, and setCursor before printing the text.

4

Show the text on the OLED

In the setup() function, after printing the text, call display.display() to update the OLED screen and show the text.

Arduino

#include 
#include 

#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64

Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire);

void setup() {
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
  display.clearDisplay();

  display.setTextSize(1);
  display.setTextColor(SSD1306_WHITE);
  display.setCursor(0, 0);
  display.println("Hello, Arduino!");

  // Update the display to show the text
  // Your code here
}

void loop() {
  // Nothing here
}

Hint

Call display.display() to send the buffer to the screen.

Practice

1. What is the main advantage of using an OLED display with I2C (SSD1306) in Arduino projects?

easy

A. It uses only two wires for communication, simplifying connections.

B. It requires no power supply to operate.

C. It can display full-color images without extra hardware.

D. It automatically connects to Wi-Fi networks.

Solution

1. Step 1: Understand I2C communication basics

   I2C uses two wires (SDA and SCL) to communicate between devices, reducing wiring complexity.

2. Step 2: Relate to OLED display advantages

   OLED displays with I2C use these two wires, making connections simpler compared to parallel interfaces.

3. Final Answer:

   It uses only two wires for communication, simplifying connections. -> Option A

4. Quick Check:

   I2C = 2 wires [OK]

Hint: Remember I2C means just two wires for data and clock [OK]

Common Mistakes:

• Thinking OLED needs many wires like parallel displays
• Assuming OLED works without power
• Confusing I2C with Wi-Fi or color capabilities

2. Which of the following is the correct way to initialize the SSD1306 OLED display using the Adafruit_SSD1306 library in Arduino?

easy

A. display.init(0x3C, SSD1306_SWITCHCAPVCC);

B. display.start(SSD1306_I2C, 0x3C);

C. display.setup(0x3C);

D. display.begin(SSD1306_SWITCHCAPVCC, 0x3C);

Solution

1. Step 1: Recall Adafruit_SSD1306 initialization syntax

   The correct method is display.begin() with parameters for power mode and I2C address.

2. Step 2: Match parameters to correct order

   SSD1306_SWITCHCAPVCC is the power mode, and 0x3C is the common I2C address for the display.

3. Final Answer:

   display.begin(SSD1306_SWITCHCAPVCC, 0x3C); -> Option D

4. Quick Check:

   Use display.begin() with power and address [OK]

Hint: Use display.begin() with power mode and I2C address [OK]

Common Mistakes:

• Using wrong method names like start or init
• Swapping parameter order
• Omitting power mode parameter

3. What will be the output on the OLED display after running this Arduino code snippet?

display.clearDisplay();
display.setTextSize(1);
display.setTextColor(SSD1306_WHITE);
display.setCursor(0,0);
display.println("Hello");
display.display();

medium

A. The text 'Hello' appears at the top-left corner of the display.

B. The display remains blank because display.display() is missing.

C. The text 'Hello' appears in the middle of the display.

D. The code causes a compile error due to missing initialization.

Solution

1. Step 1: Analyze display commands

   clearDisplay() clears screen, setCursor(0,0) sets top-left position, println("Hello") writes text.

2. Step 2: Understand display() function

   display() sends buffer to screen, so text appears after calling it.

3. Final Answer:

   The text 'Hello' appears at the top-left corner of the display. -> Option A

4. Quick Check:

   setCursor(0,0) + println("Hello") + display() = 'Hello' top-left [OK]

Hint: Remember to call display() to show changes on screen [OK]

Common Mistakes:

• Forgetting display.display() to update screen
• Assuming text appears without setCursor
• Thinking text appears centered by default

4. Identify the error in this Arduino code snippet for SSD1306 OLED display:

display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
display.setTextSize(2);
display.setTextColor(SSD1306_WHITE);
display.println("Hi");
display.display();

medium

A. Incorrect I2C address used in display.begin().

B. Missing display.clearDisplay() before drawing text.

C. setTextSize() cannot be set to 2.

D. display.display() should be called before println().

Solution

1. Step 1: Check for display buffer clearing

   Without clearDisplay(), old content may remain, causing overlapping text.

2. Step 2: Verify other commands

   I2C address 0x3C is common and valid; setTextSize(2) is allowed; display() must be after drawing.

3. Final Answer:

   Missing display.clearDisplay() before drawing text. -> Option B

4. Quick Check:

   Always clearDisplay() before drawing new content [OK]

Hint: Always clear display before drawing new text [OK]

Common Mistakes:

• Skipping clearDisplay() causing messy screen
• Changing I2C address without checking hardware
• Calling display() too early

5. You want to display a scrolling message on the SSD1306 OLED using I2C. Which approach correctly combines clearing the display, setting cursor, and updating the screen inside a loop?

hard

A. Inside loop: display(); clearDisplay(); setCursor(0,0); println(message); delay(200);

B. Inside loop: setCursor(0,0); println(message); display(); clearDisplay(); delay(200);

C. Inside loop: clearDisplay(); setCursor(0,0); println(message); display(); delay(200);

D. Inside loop: println(message); setCursor(0,0); clearDisplay(); display(); delay(200);

Solution

1. Step 1: Understand display update cycle

   Each loop iteration must clear previous content, set cursor, write new text, then update display.

2. Step 2: Verify correct order of commands

   clearDisplay() first clears buffer, setCursor() positions text, println() writes, display() sends buffer to screen, delay() controls speed.

3. Final Answer:

   Inside loop: clearDisplay(); setCursor(0,0); println(message); display(); delay(200); -> Option C

4. Quick Check:

   Clear, set cursor, print, display, delay = scrolling [OK]

Hint: Clear before print, then display inside loop for scrolling [OK]

Common Mistakes:

• Calling clearDisplay() after display() causing blank screen
• Setting cursor after printing text
• Forgetting delay causing too fast updates