How to wire an SSD1306 OLED to a Raspberry Pi Pico
To wire an SSD1306 OLED to a Raspberry Pi Pico, connect VCC to 3V3(OUT), GND to GND, SDA to GP4 (physical pin 6) and SCL to GP5 (physical pin 7). The Raspberry Pi Pico is a 3.3 V board, so power the module from 3.3 V and its I2C pull-ups pull SDA and SCL to 3.3 V too. The sketch below uses the Adafruit SSD1306 and Adafruit GFX (Adafruit_SSD1306.h) library. It draws the board name, a box and a counter of the seconds since power-up.
- 3.3 V logic
- Library: Adafruit_SSD1306.h
- 4 wires
SSD1306 OLED to Raspberry Pi Pico wiring table
Every wire in the circuit above, with the part’s pin names and the board’s own labels. The wire colors are the ones the circuit uses; on a real bench any colors work.
| SSD1306 OLED pin | Raspberry Pi Pico pin | Wire color | Why |
|---|---|---|---|
| VCC | 3V3(OUT) | red | The usual blue module runs from 3.3 V, and its I2C pull-ups then pull to 3.3 V too. |
| GND | GND | blue | Common ground. |
| SDA | GP4 (physical pin 6) | violet | Raspberry Pi Pico’s I2C data line, where Wire.begin() puts it. |
| SCL | GP5 (physical pin 7) | cyan | Raspberry Pi Pico’s I2C clock line. |
Power and logic levels for SSD1306 OLED and Raspberry Pi Pico
Logic level
The Raspberry Pi Pico’s GPIO pins are 3.3 V logic and are not 5 V tolerant. Nothing wired to a pin may go above 3.3 V.
Supply
The SSD1306 OLED takes 3.3 V from 3V3(OUT). That pin is the Raspberry Pi Pico’s own regulated 3.3 V output.
This pair
On the Pico, Wire.begin() puts SDA on GP4 and SCL on GP5, physical pins 6 and 7. The display answers at address 0x3C, the address almost every 0.96 inch module ships with.
Pins to leave alone
The numbers in the code are GP numbers, not the physical pin numbers printed beside the header: GP15 is pin 20. GP23 to GP25 are used on the board itself, and GP25 is the LED.
The working code for the Raspberry Pi Pico
Library: Adafruit SSD1306 and Adafruit GFX (Adafruit_SSD1306.h). This is the sketch the circuit above runs.
#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
// 128 x 64 pixels, on the I2C bus: SDA GP4 (physical pin 6), SCL GP5 (physical pin 7)
Adafruit_SSD1306 display(128, 64, &Wire, -1);
void setup() {
Serial.begin(115200);
if (!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) {
Serial.println("No SSD1306 at 0x3C");
for (;;) {}
}
display.clearDisplay();
display.setTextColor(SSD1306_WHITE);
display.setTextSize(2);
display.setCursor(0, 0);
display.println("HELLO");
display.setTextSize(1);
display.println("SSD1306 OLED");
display.drawRect(0, 40, 128, 24, SSD1306_WHITE);
display.display();
Serial.println("OLED ready");
}
void loop() {
// A counter in the box, redrawn twice a second.
display.fillRect(2, 42, 124, 20, SSD1306_BLACK);
display.setCursor(8, 48);
display.print("Up for ");
display.print(millis() / 1000);
display.print(" s");
display.display();
delay(500);
}
What you should see
The panel shows HELLO in large letters, SSD1306 OLED below it, and a box with Up for followed by a number of seconds that counts up. The serial monitor, at 115200 baud, prints OLED ready once.
If the monitor prints No SSD1306 at 0x3C instead, nothing answered on the bus: check SDA and SCL first. The font in the simulator has capitals only, so lower case prints as capitals.
The serial monitor prints this, recorded from the circuit above running:
OLED readyCommon mistakes wiring an SSD1306 OLED to a Raspberry Pi Pico
Forgetting display()
Every call before display() only changes the copy in RAM. A sketch that draws and never calls display() leaves the screen black, and that is the most common "my OLED does not work" there is.
Using I2C1 pins with Wire
Wire is the Pico’s I2C0 on GP4 and GP5. Tutorials for MicroPython often use GP0 and GP1 or I2C1 on GP2 and GP3; with Wire.begin() and no arguments the display has to be on GP4 and GP5.
Mixing up the 128x32 module
The 128 by 32 OLED uses the same chip and the same address, but the constructor needs 128, 32. Built for 64 rows, everything is drawn half off the panel.
Build your own SSD1306 OLED project
Open this circuit in the editor, change the wiring or the code, and keep your version in a free account.