OLED display with I2C (SSD1306) in Raspberry Pi - Practice Problems & Coding Challenges

Challenge - 5 Problems

❓ Predict Output

intermediate

What is the output on the OLED display?

Given the following Python code snippet for an SSD1306 OLED display connected via I2C on a Raspberry Pi, what text will appear on the screen?

Raspberry Pi

from PIL import Image, ImageDraw, ImageFont
import board
import busio
import adafruit_ssd1306

i2c = busio.I2C(board.SCL, board.SDA)
display = adafruit_ssd1306.SSD1306_I2C(128, 32, i2c)
display.fill(0)
display.show()

image = Image.new('1', (display.width, display.height))
draw = ImageDraw.Draw(image)

font = ImageFont.load_default()
draw.text((0, 0), 'Hello, Pi!', font=font, fill=255)
display.image(image)
display.show()

A The OLED shows the text 'Hello, Pi!' at the top-left corner

B The OLED shows the text 'Hello, Pi!' centered on the screen

C The OLED remains blank with no text displayed

D The OLED shows an error message about I2C communication

💡 Hint

Look at the coordinates used in draw.text and the display size.

The text is drawn at position (0, 0), which is the top-left corner of the display. The display size is 128x32 pixels, so the text appears there. The code clears the display first, then draws the text and updates the screen.

🧠 Conceptual

intermediate

Why is the display.fill(0) method called before drawing?

In the SSD1306 OLED display code, what is the purpose of calling display.fill(0) before drawing new content?

A It clears the display by turning all pixels off

B It sets the brightness of the display to zero

C It initializes the I2C communication bus

D It saves the current display content to memory

💡 Hint

Think about what 'fill(0)' might mean for a pixel-based screen.

Calling display.fill(0) turns off all pixels, effectively clearing the screen before drawing new content. This prevents old images or text from overlapping.

🔧 Debug

advanced

Identify the error causing the display to remain blank

This code is intended to display 'Test' on the OLED, but the screen stays blank. What is the cause?

Raspberry Pi

from PIL import Image, ImageDraw, ImageFont
import board
import busio
import adafruit_ssd1306

i2c = busio.I2C(board.SCL, board.SDA)
display = adafruit_ssd1306.SSD1306_I2C(128, 64, i2c)
display.fill(0)
display.show()

image = Image.new('1', (display.width, display.height))
draw = ImageDraw.Draw(image)

font = ImageFont.load_default()
draw.text((0, 0), 'Test', font=font, fill=255)
# Missing display.image(image) here
display.show()

A The font is not loaded correctly, causing no text to render

B The display size 128x64 is not supported by the OLED

C The I2C bus is not initialized properly

D The display.image(image) call is missing before display.show()

💡 Hint

Check if the image is sent to the display before calling show().

The image with the drawn text must be sent to the display buffer using display.image(image) before calling display.show(). Without this, the display shows the previous or blank content.

📝 Syntax

advanced

Which code snippet correctly initializes the SSD1306 display?

Choose the correct Python code to initialize a 128x32 SSD1306 OLED display over I2C on a Raspberry Pi.

A

i2c = busio.I2C(board.SCL, board.SDA)
display = adafruit_ssd1306.SSD1306_SPI(128, 32, i2c)

B

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

C

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

D

i2c = busio.I2C(board.SCL, board.SDA)
display = adafruit_ssd1306.SSD1306_I2C(128, 64, i2c)

💡 Hint

Check the order of pins and display dimensions.

Option C correctly uses board.SCL and board.SDA in the right order and specifies the correct display size 128x32 for this OLED. Option C swaps pins and dimensions incorrectly. Option C uses SPI class instead of I2C. Option C uses wrong display height.

🚀 Application

expert

How many pixels are lit after this drawing code runs?

Consider this code drawing a white rectangle on a 128x32 SSD1306 OLED display. How many pixels are lit (set to 1) after running?

Raspberry Pi

from PIL import Image, ImageDraw
import board
import busio
import adafruit_ssd1306

i2c = busio.I2C(board.SCL, board.SDA)
display = adafruit_ssd1306.SSD1306_I2C(128, 32, i2c)
display.fill(0)
display.show()

image = Image.new('1', (display.width, display.height))
draw = ImageDraw.Draw(image)

draw.rectangle((10, 5, 20, 15), outline=255, fill=255)
display.image(image)
display.show()

A 110 pixels

B 121 pixels

C 100 pixels

D 1210 pixels

💡 Hint

Calculate width and height of the rectangle and multiply.

The rectangle covers from x=10 to 20 (inclusive) and y=5 to 15 (inclusive). Width = 20 - 10 + 1 = 11 pixels, height = 15 - 5 + 1 = 11 pixels. Total pixels lit = 11 * 11 = 121.

Practice

1. What is the main purpose of the show() method when using an SSD1306 OLED display with I2C on a Raspberry Pi?

easy

A. To update the display with the current buffer content

B. To clear the display screen

C. To initialize the I2C communication

D. To set the brightness of the OLED display

Solution

1. Step 1: Understand the display buffer concept

   The OLED display uses a buffer to store what will be shown on the screen before updating.

2. Step 2: Role of show() method

   The show() method sends the buffer content to the OLED, updating the visible display.

3. Final Answer:

   To update the display with the current buffer content -> Option A

4. Quick Check:

   show() updates screen [OK]

Hint: Remember: show() sends buffer to screen [OK]

Common Mistakes:

• Confusing show() with clear()
• Thinking show() initializes I2C
• Assuming show() changes brightness

2. Which of the following is the correct way to clear the OLED display buffer before drawing new content in Python using the SSD1306 library?

easy

A. oled.reset()

B. oled.clear()

C. oled.fill(0)

D. oled.erase()

Solution

1. Step 1: Identify the method to clear the buffer

   The SSD1306 library uses fill(0) to fill the buffer with zeros, effectively clearing it.

2. Step 2: Confirm other options are incorrect

   Methods like clear(), reset(), or erase() are not standard in this library.

3. Final Answer:

   oled.fill(0) -> Option C

4. Quick Check:

   Clear buffer = fill(0) [OK]

Hint: Use fill(0) to clear screen buffer [OK]

Common Mistakes:

• Using non-existent clear() method
• Confusing fill(1) with clearing
• Trying reset() which is not in library

3. Given the following Python code snippet for an SSD1306 OLED display, what will be the visible output on the screen?

oled.fill(0)
oled.text('Hi', 0, 0)
oled.show()

medium

A. The text 'Hi' appears at the bottom-right corner

B. The screen remains blank

C. An error occurs because text() needs more arguments

D. The text 'Hi' appears at the top-left corner

Solution

1. Step 1: Analyze the code sequence

   The buffer is cleared with fill(0), then 'Hi' is drawn at coordinates (0,0).

2. Step 2: Understand coordinate system and show()

   Coordinates (0,0) place text at top-left. Calling show() updates the display.

3. Final Answer:

   The text 'Hi' appears at the top-left corner -> Option D

4. Quick Check:

   Text at (0,0) shows top-left [OK]

Hint: Text at (0,0) is top-left on OLED [OK]

Common Mistakes:

• Assuming text() needs more arguments
• Thinking (0,0) is bottom-right
• Forgetting to call show() to update

4. You wrote this code to display 'Hello' on the OLED but nothing appears:

oled.text('Hello', 10, 10)
oled.fill(0)
oled.show()

What is the problem?

medium

A. Coordinates (10,10) are outside the display range

B. Calling fill(0) after text() clears the buffer

C. Missing oled.init() before drawing

D. Text string must be uppercase

Solution

1. Step 1: Check the order of commands

   Text is drawn first, then fill(0) clears the buffer, erasing the text.

2. Step 2: Understand correct sequence

   Clear buffer first with fill(0), then draw text, then call show().

3. Final Answer:

   Calling fill(0) after text() clears the buffer -> Option B

4. Quick Check:

   Clear after draw erases text [OK]

Hint: Clear buffer before drawing, not after [OK]

Common Mistakes:

• Thinking coordinates are invalid
• Assuming init() is needed every time
• Believing text case matters

5. You want to display a scrolling message on the SSD1306 OLED using I2C on Raspberry Pi. Which approach correctly updates the display to show new text smoothly without leftover pixels?

hard

A. Clear buffer with fill(0), draw new text, then call show() each frame

B. Draw new text over old text without clearing, then call show()

C. Only call show() once after all text frames are drawn

D. Use oled.clear() after show() to erase old text

Solution

1. Step 1: Understand how to avoid leftover pixels

   Clearing the buffer before drawing new text removes old pixels that would remain otherwise.

2. Step 2: Proper update sequence for smooth scrolling

   Each frame: clear buffer with fill(0), draw new text, then call show() to update display.

3. Final Answer:

   Clear buffer with fill(0), draw new text, then call show() each frame -> Option A

4. Quick Check:

   Clear before draw + show() = smooth update [OK]

Hint: Always clear buffer before drawing new frame [OK]

Common Mistakes:

• Not clearing buffer causes ghosting
• Calling show() only once delays updates
• Using non-existent clear() method