From 52Pi Wiki
Jump to navigation Jump to search

0.91 Inch OLED Module


These displays are very tiny, you can use it as your battery status display and you can make it a mp3 lyrics display.
This display is made of 128x32 individual yellow and blue OLED pixels, each one is turned on or off by the controller chip.
Because the display makes its own light, no backlight is required.
There are little power require to run the OLED.
This breakout can be used with an I2C interface
it supports Raspberry Pi A, A+,B,B+,2B,3B.




  • Resolution: 128 x 32
  • 3.3V work voltage
  • I2C driver support
  • FP frequency: less than 1 fps
  • Wide range of operating temperature: -40°C to 85°C
  • Only use 5 pins to control OLED as showing below.


  • Dimensions: 36.56mm x 14.87mm x 11.70(include header)mm
  • Weight without package: 2.92±2g

Package included:

1 x 0.91 Inch OLED Module

how to wire it up:

Just plug into GPIO in 3.3v,SDA,SCL,GND.

How to use

First of all, you should turn on I2C function on your Pi by editing /boot/config.txt file.
sudo vim.tiny /boot/config.txt
make sure you can find this parameter:
And don't forget to reboot your Pi.

  • Login your Pi and download driver:

git clone -b ArduiPi_OLED https://github.com/yoyojacky/libssd1306

  • Compile it and run:

cd libssd1306/
sudo make
cd example/
sudo make
sudo ./oled_demo -o 2
if you need help, you can just use this command:
sudo ./oled_demo -h


  • Question: why does it not show anything that I've tried as your instruction?
    • Answer: Please make sure you have already open your i2c function and you can use this command to detect whether it has been turned on already.
    • i2cdetect -y 1

Application Senario

  • There is a maker made a funny thing called "mobile pi" with this 0.91 Inch OLED Module, you can check it by accessing following link:

[Mobile Pi | https://www.instructables.com/id/My-Fantastic-MobilePi/ ]