Displaying sensor readings on OLED in Raspberry Pi - Step-by-Step Execution

Concept Flow - Displaying sensor readings on OLED

Start Program

↓

Initialize OLED Display

↓

Initialize Sensor

↓

Read Sensor Data

↓

Format Data for Display

↓

Clear OLED Screen

↓

Display Data on OLED

↓

Wait or Loop

↩Back to Read Sensor Data

The program starts by setting up the OLED and sensor, then repeatedly reads sensor data, formats it, clears the screen, and shows the data on the OLED.

Execution Sample

Raspberry Pi

import board
import adafruit_ssd1306
import time
import random

display = adafruit_ssd1306.SSD1306_I2C(128, 32, board.I2C())
while True:
    temp = random.uniform(20, 30)
    display.fill(0)
    display.text(f"Temp: {temp:.1f} C", 0, 0, 1)
    display.show()
    time.sleep(1)

This code simulates reading a temperature sensor and shows the temperature on the OLED screen every second.

Execution Table

Step	Action	Sensor Reading	Display Buffer Content	Output on OLED
1	Initialize OLED and sensor	N/A	Empty screen buffer	Blank screen
2	Read sensor data	25.3	Empty (before update)	Previous content or blank
3	Clear display buffer	25.3	All pixels off	Screen cleared
4	Write text to buffer	25.3	"Temp: 25.3 C" at (0,0)	Not yet visible
5	Show buffer on OLED	25.3	"Temp: 25.3 C" in buffer	Text displayed on screen
6	Wait 1 second	N/A	Buffer unchanged	Text visible
7	Repeat read sensor	26.1	Buffer with old text	Old text visible
8	Clear display buffer	26.1	All pixels off	Screen cleared
9	Write new text	26.1	"Temp: 26.1 C" at (0,0)	Not yet visible
10	Show buffer on OLED	26.1	"Temp: 26.1 C" in buffer	Updated text displayed
11	Wait 1 second	N/A	Buffer unchanged	Text visible
...	Loop continues	...	...	...

💡 Program runs indefinitely, updating sensor reading and OLED display every second.

Variable Tracker

Variable	Start	After 1	After 2	...final
temp	N/A	25.3	26.1	...
display buffer	Empty	"Temp: 25.3 C"	"Temp: 26.1 C"	...

Key Moments - 3 Insights

Why do we clear the display buffer before writing new text?

Clearing the buffer removes old text so the new sensor reading shows clearly without overlapping. See execution_table rows 3 and 8.

When does the text actually appear on the OLED screen?

Text appears only after calling display.show(), which sends the buffer to the OLED hardware. See execution_table rows 5 and 10.

Why does the program loop reading and displaying sensor data?

Sensors change over time, so looping updates the display with fresh readings continuously. See execution_table rows 2-11.

Visual Quiz - 3 Questions

Look at the execution_table, what is the display buffer content at step 4?

A All pixels off

B "Temp: 25.3 C" at (0,0)

C Empty screen buffer

D Old text from previous reading

💡 Hint

Check the 'Display Buffer Content' column at step 4 in the execution_table.

At which step does the OLED screen get cleared before showing new data?

A Step 2

B Step 5

C Step 3

D Step 7

💡 Hint

Look for 'Clear display buffer' action in the execution_table.

If the sensor reading was not updated in the loop, how would the variable 'temp' change in variable_tracker?

A It would stay the same after start

B It would increase each iteration

C It would be empty

D It would reset to zero

💡 Hint

Refer to the 'temp' row in variable_tracker to see how it changes over iterations.

Concept Snapshot

Displaying sensor readings on OLED:
- Initialize OLED and sensor
- Read sensor data repeatedly
- Clear OLED buffer before writing
- Write formatted text to buffer
- Call display.show() to update screen
- Loop to refresh readings continuously

Full Transcript

This program shows how to display sensor readings on an OLED screen using a Raspberry Pi. First, it sets up the OLED display and sensor. Then it reads the sensor data, clears the OLED screen buffer, writes the new sensor value as text, and updates the OLED display. This process repeats every second to keep the display current. Clearing the buffer before writing prevents overlapping text. The display.show() command sends the buffer content to the screen, making the text visible. The loop ensures the sensor readings and display update continuously.