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

OLED display with I2C (SSD1306)

📖 Scenario: You have a Raspberry Pi connected to a small OLED screen using the I2C protocol. This screen uses the SSD1306 driver chip. You want to display simple text messages on the screen.

🎯 Goal: Build a Python program that initializes the OLED display, sets up a message, and shows it on the screen.

📋 What You'll Learn

Use the board and busio modules to set up I2C communication.

Use the adafruit_ssd1306 library to control the OLED display.

Create a message string to display.

Clear the display before showing the message.

Show the message on the OLED screen.

💡 Why This Matters

🌍 Real World

OLED displays with I2C are common in small devices like weather stations, clocks, and IoT gadgets to show information clearly and efficiently.

💼 Career

Knowing how to control hardware displays using Python and I2C is useful for embedded systems developers, IoT engineers, and hobbyists working with Raspberry Pi or similar boards.

1

Set up I2C communication and OLED display

Write code to import board, busio, and adafruit_ssd1306. Then create an I2C object called i2c using busio.I2C(board.SCL, board.SDA). Finally, create an OLED display object called oled using adafruit_ssd1306.SSD1306_I2C(128, 32, i2c).

Raspberry Pi

# Your code here

Hint

Use busio.I2C(board.SCL, board.SDA) to create the I2C bus. Then pass it to adafruit_ssd1306.SSD1306_I2C with width 128 and height 32.

2

Create the message to display

Create a variable called message and set it to the string "Hello, OLED!".

Raspberry Pi

import board
import busio
import adafruit_ssd1306

i2c = busio.I2C(board.SCL, board.SDA)
oled = adafruit_ssd1306.SSD1306_I2C(128, 32, i2c)

# Your code here

Hint

Just assign the string "Hello, OLED!" to the variable message.

3

Clear the display and write the message

Use oled.fill(0) to clear the display. Then use oled.text(message, 0, 0, 1) to write the message at the top-left corner. Finally, call oled.show() to update the screen.

Raspberry Pi

import board
import busio
import adafruit_ssd1306

i2c = busio.I2C(board.SCL, board.SDA)
oled = adafruit_ssd1306.SSD1306_I2C(128, 32, i2c)

message = "Hello, OLED!"

# Your code here

Hint

Clear the screen with oled.fill(0). Write text with oled.text(). Update the display with oled.show().

4

Print confirmation message

Write a print statement to display the text "Message shown on OLED" in the console.

Raspberry Pi

import board
import busio
import adafruit_ssd1306

i2c = busio.I2C(board.SCL, board.SDA)
oled = adafruit_ssd1306.SSD1306_I2C(128, 32, i2c)

message = "Hello, OLED!"

oled.fill(0)
oled.text(message, 0, 0, 1)
oled.show()

# Your code here

Hint

Use print("Message shown on OLED") to confirm the message was displayed.