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.