Usage & Benchmarking

This library was originally designed to work only on:

• 128x64 OLED displays driven by the SSD1306 chipset
• I2C interface
• Raspberry Pi
• Debian Linux

As the library has evolved, a number of people have helped to make it work on a variety of different devices. Please refer to the below list to see the documented working cases, and add your own.

I2C

I2C devices should be tested with an I2C baudrate of 400KHz by altering /boot/config.txt to include:

dtparam=i2c_arm=on,i2c_baudrate=400000

0.96" I2C OLED

• Color: white / blue-yellow
• Dimensions: 128 X 64
• Ebay: http://www.ebay.com/itm/3-5V-0-96-White-12C-Serial-128X64-OLED-LCD-LED-Display-Module-for-Arduino-zzz-/162309650339
• Ebay: http://www.ebay.co.uk/itm/191279261331
• Datasheet: http://ssd1306.readthedocs.io/en/latest/_downloads/SSD1306.pdf

Date	Working	Tested by	Tested on	Linux / Python version	FPS	Command
2016-12-10	YES	@rm-hull	OrangePi Zero, 4-core 1.2GHz 256Mb	Armbian Jessie / Python 2	55.09	perfloop.py -d ssd1306 -i i2c --i2c-port=0
2016-12-10	YES	@rm-hull	Rasberry Pi, model B 1-core 700MHz 512Mb	Raspbian Jessie / Python 2	26.35	perfloop.py -d ssd1306 -i i2c
2016-12-07	YES	@thijstriemstra	Raspberry Pi 3B	Raspbian Jessie / Python 3.4.2	57.62	perfloop.py -d ssd1306 -i i2c
06.08.2017	YES	@BiTinerary	NanoPi Neo Air	Armbian Jessie / Python 2.7	21.58	perfloop.py -d ssd1306 -i i2c --i2c-port=0
2017-06-11	YES	@MicUurloon	Raspberry Pi Zero W	Raspbian Jessie Lite / Python 2.7.9	19.20	perfloop.py -d ssd1306 -i i2c

0.91" I2C OLED

• Color: white
• Dimensions: 128 X 32
• Ebay: http://www.ebay.com/itm/3-5V-0-96-White-12C-Serial-128X64-OLED-LCD-LED-Display-Module-for-Arduino-zzz-/162309650339

Date	Working	Tested by	Tested on	Linux / Python version	FPS	Command
2016-12-07	YES	@thijstriemstra	Raspberry Pi 3B	Raspbian Jessie / Python 3.4.2	102.77	perfloop.py -d ssd1306 -i i2c

SPI

0.96" SPI OLED - SSD1306

• Color: blue
• Dimensions: 128 X 64
• Datasheet: https://cdn-shop.adafruit.com/datasheets/UG-2864HSWEG01.pdf
• Ebay: http://www.ebay.com/itm/201688735605

Date	Working	Tested by	Tested on	Linux / Python version	FPS	Command
2016-12-07	YES	@thijstriemstra	Raspberry Pi 3B	Raspbian Jessie / Python 3.4.2	68.23	perfloop.py -d ssd1306 -i spi

0.96" SPI OLED - SH1106

• Dimensions: 128 X 64

Date	Working	Tested by	Tested on	Linux / Python version	FPS	Command
2017-01-09	YES	@bjerrep	Raspberry Pi 3B	Arch Linux / Python 3.4.2	66	perfloop.py -d sh1106 -i spi
2017-01-09	YES	@bjerrep	Raspberry Pi 3B	Arch Linux / Python 2.7.13	93	perfloop.py -d sh1106 -i spi

1.5" SPI OLED - SSD1327

• Dimensions: 128 X 128
• Color: blue
• Datasheet: https://www.waveshare.com/1.5inch-oled-module.htm

Date	Working	Tested by	Tested on	Linux / Python version	FPS	Command
2021-01-01	YES	@ntnlabs	Raspberry Pi 4B 2GB	Raspbian 10 (buster) / Python 3.7.3	1630	python3 perfloop.py --height 128 --width / 128 --interface spi --display ssd1327

1.5" SPI OLED - SSD1351

• Dimensions: 128 X 128
• Color: RGB (262,144 Colours)
• Jaycar (AU): https://www.jaycar.com.au/p/XC3726

Date	Working	Tested by	Tested on	Linux / Python version	FPS	Command
2022-04-18	MOSTLY (Red & Blue Colours have swapped)	@yuniq-neko	Raspberry Pi 4B 4GB	Raspbian 11 Bullseye / Python 3.9.2	1960?	perfloop.py -d ssd1351 -i spi --width 128 --height 128

2.42" SPI OLED - SSD1309

• Dimensions: 128 X 64
• Color: yellow on black
• Datasheet: https://joy-it.net/files/files/Produkte/COM-OLED2.42/COM-OLED2.42_Datasheet_2021-03-11.pdf

Date	Working	Tested by	Tested on	Linux / Python version	FPS	Command
2022-10-04	Yes	@fox34	Raspberry Pi 4B 4GB	Raspbian 11 Bullseye / Python 3.9.2	302	perfloop.py -d ssd1309 -i spi

2.7" SPI OLED - SSD1325

• Dimensions: 128 X 64
• Color: yellow on black
• Source: https://aliexpress.com/item/1556192743.html
• Notes: Valid contrast value range: 0...127. 128 = 0, 129 = 1, ... (int8 overflow)

Date	Working	Tested by	Tested on	Linux / Python version	FPS	Command
2022-10-13	Yes	@fox34	Raspberry Pi 4B 4GB	Raspbian 11 Bullseye / Python 3.9.2	3085	perfloop.py -d ssd1325 -i spi

3.2" SPI OLED - SSD1322

• Dimensions: 256 X 64
• Color: yellow on black
• Source: https://www.buydisplay.com/yellow-3-2-inch-arduino-raspberry-pi-oled-display-module-256x64-spi

Date	Working	Tested by	Tested on	Linux / Python version	FPS	Command
2023-04-07	Yes	@davwheat	Raspberry Pi 4B 2GB	Ubuntu Server 22.04 / Python 3.10.6	2190	perfloop.py -d ssd1322 -i spi --width 256 --height 64
2023-06-03	Yes	@maeb0r0wski	Raspberry Pi 3B v1.2 1GB	Raspbian GNU/Linux 11 / Python 3.9.2	370	perfloop.py -d ssd1322 -i spi --width 256 --height 64