Adafruit 128x64 OLED Bonnet for Raspberry Pi

Raspberry Pi bonnet with a 128x64 monochrome OLED display, 5-way joystick, and 3 buttons. Connects directly to the Pi GPIO header with no extra wiring.

Logical pinout · physical placement not verified

3V35V
Raspberry Pi power rail used through the 2x20 bonnet header
Type · Power
GND
Ground through the Raspberry Pi 2x20 bonnet header
Type · Ground
SCL
I2C clock for the SSD1306 OLED display, board.SCL in Adafruit example code
Type · I2C
SDA
I2C data for the SSD1306 OLED display, board.SDA in Adafruit example code
Type · I2C
D5
A button input
Type · GPIO
D6
B button input
Type · GPIO
D27
Joystick left input
Type · GPIO
D23
Joystick right input
Type · GPIO
D17
Joystick up input
Type · GPIO
D22
Joystick down input
Type · GPIO
D4
Joystick centre press input
Type · GPIO

Pin	Type	Function
3V35V	Power	Raspberry Pi power rail used through the 2x20 bonnet header
GND	Ground	Ground through the Raspberry Pi 2x20 bonnet header
SCL	I2C	I2C clock for the SSD1306 OLED display, board.SCL in Adafruit example code
SDA	I2C	I2C data for the SSD1306 OLED display, board.SDA in Adafruit example code
D5	GPIO	A button input
D6	GPIO	B button input
D27	GPIO	Joystick left input
D23	GPIO	Joystick right input
D17	GPIO	Joystick up input
D22	GPIO	Joystick down input
D4	GPIO	Joystick centre press input

Logical pinout · physical placement not verified

Pin details

11 connections

3V35V
Raspberry Pi power rail used through the 2x20 bonnet header
Power
GND
Ground through the Raspberry Pi 2x20 bonnet header
Ground
SCL
I2C clock for the SSD1306 OLED display, board.SCL in Adafruit example code
I2C
SDA
I2C data for the SSD1306 OLED display, board.SDA in Adafruit example code
I2C
D5
A button input
GPIO
D6
B button input
GPIO
D27
Joystick left input
GPIO
D23
Joystick right input
GPIO
D17
Joystick up input
GPIO
D22
Joystick down input
GPIO
D4
Joystick centre press input
GPIO

Start wiring

I2C · SPI · 3.3 – 5 V · Breakout

Confirm the data interface matches your host board.

Module pins: 3V3 / 5V, GND, SCL, SDA, D5, D6, D27, D23. Schematik maps them to your board in the app.

OLED

29 other options

About 30 parts: monochrome I2C modules from 0.49 to 1.3 inches, SPI/I2C grayscale and 65K-color RGB panels up to 1.5 inches, a transparent OLED, and ecosystem-specific units for Raspberry Pi, FireBeetle and M5Stack Grove.

View all 29

Related groups

4 groups

TFT & LCD

16×2 and 20×4 character LCDs (parallel, I2C backpack, Qwiic, Grove), SPI TFTs from 0.71 to 3.5 inches, and large DSI and HDMI capacitive-touch panels up to 13.3 inches.

Displays · TFT & LCD displays · 190 parts

E-paper

Waveshare makes up the large majority of parts here and often sells the same panel twice: once as a raw display needing a separate driver board, and once as a module or HAT+ with the SPI controller attached.

Displays · E-paper displays · 101 parts

LED displays

Adafruit HT16K33 backpacks, MAX7219 daisy-chains, NeoPixel and DotStar grids, HUB75 RGB matrix panels, charlieplexed arrays, bare clock displays, and two VFD character modules — almost 90 parts, none wired the same way.

Displays · LED displays · 89 parts

3D printing

DFRobot 1.75 mm PLA in 1 kg spools makes up the bulk of the group, in over 15 colors. Specialty options include PVA in both diameters, NinjaFlex flexible filament, Proto-Pasta conductive PLA, and wood-fill. OverLord printer spares and OverLord printers round out the hardware side.

Tools & prototyping · 3D printing · 53 parts

Pinout