How to enable OLED display

From Geekworm Wiki
Jump to navigation Jump to search

How to enable OLED display on Raspbian: [1]

1. Update your Pi and Install the required dependencies

sudo apt-get update
sudo apt-get -y upgrade
sudo apt-get -y install i2c-tools python3-smbus python-smbus
sudo apt-get -y install python3-pip python3-pil
sudo pip3 install --upgrade setuptools
sudo pip3 install --upgrade adafruit-python-shell
sudo pip3 install adafruit-circuitpython-ssd1306
sudo pip3 install pi-ina219
sudo pip3 show pi-ina219

2. Run the following command to check the oled i2c port

sudo i2cdetect -y 1

for X729, the I2C address is 0x3c

3. Installation

3.1 Download the required scripts

cd ~
git clone
cd oled

3.2 Install the Adafruit CircuitPython library

sudo python3

3.3 Answering Y and hitting Enter when reboot prompted. Then renavigate to the oled directly by entering:

cd oled

3.4 Run the script to test the display

sudo python3 

3.5 Run the script at Raspberry Pi boot

sudo crontab -e

3.6 Add a line at the end of the file that reads like this:

PS: we must toogle to the /home/pi/oled directory because .ttf files is required to locate in current directory,you can refer to source file, or you can also remove the 'cd /home/pi/oled &&' if you use the absolute path of the ttf file in the source code.

@reboot cd /home/pi/oled && python3 /home/pi/oled/ &

Save and exit. In nano, you do that by hitting CTRL + X, answering Y and hitting Enter when prompted.


  1. Adafruit Python SSD1306 library:

Add your comment
Geekworm Wiki welcomes all comments. If you do not want to be anonymous, register or log in. It is free.

Anonymous user #1

6 months ago
Score 0++

Could you please update this page according to actual Raspberry OS release?

No python-smbus package there and couple errors coming on install adafruit-circuitpython-ssd1306


2 months ago
Score 0++
Hi, you can ignore python-smbus package.