A collection of examples for driving displays from microcontrollers

Display Technologies
Driver Technologies
Control Protocols
Display Libraries for Arduino
TFT LCD Examples
OLED Examples
ePaper Examples
8x8 LED Matrix examples
QR Code Examples

This project is maintained by tigoe

OLED Displays

The OLED displays mentioned here are momochrome displays. They have a fairly good pixel-per-inch ratio, making them more visually rich than older passive-matrix LCDs, and they have a fast refresh rate, making them more useful than ePaper for dynamic displays. They’re generally cheaper than TFT screens and use less energy. They’re good when you need a simple text or monochrome graphic display.

You can find the code examples at this link.


All of the OLED displays I have used as of this writing use the Solomon Systech SSD13xx family of drivers.

Pin Connections

OLED displays can have either SPI or I2C interfaces, similar to other types of displays. Most of the ones tested here tend to use I2C interfaces, however.


The Solomon Systech SSD1306 OLED driver IC is a popular and inexpensive display driver in lots of display breakouts. You can find them on most of the popular electronics sites: Adafruit, Sparkfun (including their MicroOLED breakout), DFRobot, Crystalfontz, MakerFocus, Amazon, and many others. The displays are small, inexpensive and easy to use, and useful for simple displays. There are a number of variants from Solomon Systech, which you’ll encounter in various vendors’ products.

There are a number of 128x64 pixel models on the market that have one line of yellow pixels and the rest blue. You can’t change the color of the pixels, so this can be annoying if you’re looking for a single monochrome display. For example, a QR code in yellow and blue is not readable on most mobile devices. Figures 1 and 2 show the difference.

Photo of three SSD1306 OLED displays displaying text Figure 1. Three SSD1306 OLED displays side by side. Left to right: 128x32, 128,64 monochrome, 128x64 blue and yellow.

Photo of three SSD1306 OLED displays displaying QR codes Figure 2. Three SSD1306 OLED displays side by side showing QR codes. Left to right: 128x32, 128,64 monochrome, 128x64 blue and yellow. All three displays contain the same QR code message, but the one in blue and yellow is not camera-readable. None are camera-readable from this photo because of the degradation of the image.

Sparkfun Micro OLED Display

Sparkfun’s Micro OLED is a tiny display, just 64x48 pixels. It’s based on the SSD1306, but doesn’t work with the Adafruit libraries or the u8g2 library. The Micro OLED Breakout Hookup Guide is useful if you are using this board.

This board exposes both the SPI and I2C pins, so you can use either interface. However, unlike the other SSD1306 pins, you will need to add a pin for the reset and D/C connection on the board, whether you use SPI or I2C interface.

The Micro OLED board only works with their Micro OLED library. Their library takes a slightly different approach to layout than the Adafruit_GFX library, but it is possible to adapt from one to the other. The examples listed here connect to the microOLED via I2C as well as the reset and D/C pins of the breakout board. FIgure 3 shows the board connected to a Nano 33 IoT.

photo of a microOLED breakout board attached to a Nano 33 IoT Figure 3. MicroOLED display attached to a Nano 33 IoT.

Crystalfontz Displays

Crystalfontz makes a number of displays, and I’ve just started to work with a few of them. These notes are very preliminary.

The Crystalfontz boards tend to default to the SPI interface. See the SPI connections section of the main page of this repository for a list of typical pin connections.

SSD1309 Transparent OLED Display

The SSD1309 transparent OLED Display and breakout board from Crystalfontz is a 128x56 display that you can see through. It works with the u8g2 library and the Crystalfontz OLED Breakout Board. It uses an SSD1309 driver, the same as Sparkfun’s Transparent Graphical OLED Breakout board. I have not tested the Sparkfun board with the u8g2 library, nor this board with the Sparkfun Hyperdisplay library yet, however. There are a couple of an examples for this display using the SPI interface in this repository. Figure 4 shows the display showing a QR code.

Photo of a SSD1309 transparent OLED showing a QR code. Figure 4. SSD1309 transparent OLED showing a QR code.


Despite having the same driver, not all of these displays interoprate with all libraries. Adafruit’s SSD1306 library works well with all the 128x64 and 128x32 displays that I’ve tried, but not with ones that have other resolutions, like the Sparkfun Micro OLED, which has a 64x48 resolution.

The u8g2 library by Oli Kraus, is intended as a universal monochrome display library for OLED, eInk, TFT, and other displays. It supports some SSD130x boards, but not all.