Transparent Graphical OLED Breakout Hookup Guide

Contributors: Liquid Soulder, Ell C
Favorited Favorite 4

Software Setup and Programming

Note: This example assumes you are using the latest version of the Arduino IDE on your desktop. If this is your first time using Arduino, please review our tutorial on installing the Arduino IDE. If you have not previously installed an Arduino library, please check out our installation guide.

Drivers and Board Add-Ons

Depending on your development board, you may need to install drivers and a board add-on. For the scope of this tutorial, we will be using the ESP32 Thing Plus. If you have not already, make sure that you install the drivers and ESP32 Arduino core files as explained in our ESP32 Thing Plus Hookup Guide.

Installing ESP32 Board Add on Files
Software Setup for the ESP32

Arduino Libraries

The software for the Transparent Graphical OLED Breakout is built on the HyperDisplay libraries developed by SparkFun. If you are unfamiliar with how this abstracted library works, head over to our Everything You Should Know About HyperDisplay tutorial.

Everything You Should Know About HyperDisplay

February 20, 2019

This is a tutorial to go in-depth about the SparkFun HyperDisplay Arduino Library.

HyperDisplay is an abstracted library that requires multiple layers in order to function correctly. For the Transparent Graphical OLED to work, you'll need our base HyperDisplay Library, the HyperDisplay SSD1309 Arduino Library, and the somewhat painfully but informatively named HyperDisplay UG2856KLBAG01 Arduino Library. You can obtain these libraries through the Arduino Library Manager by searching for "HyperDisplay Library", "HyperDisplay SSD1309", "HyperDisplay Transparent Graphical OLED", respectively. You can download the required libraries from their individual GitHub pages or download the following *.zip file that contains all three libraries to manually install:

If you are manually downloading the libraries, unzip them and copy all three libraries to your Arduino > Libraries folder, wherever that may be located on your machine.

Copy the HyperDisplay libraries to your Arduino Libraries folder

Having a hard time seeing? Click the image for a closer look.