Interfacing OLED Display with ESP32

The combination of OLED with ESP32 is so popular that there are some boards of ESP32 with the OLED integrated. We ll, however, assume that you will be using a separate OLED module with your ESP32 board. If you have an OLED module, it perhaps looks pke the image below.

Connecting the OLED Display Module to ESP32

Like the MPU6050 module that we discussed in a previous chapter, the OLED module also generally uses I2C for communication. Therefore, the connection will be similar to the MPU6050 module. You need to connect the SDA pne to pin 21 on ESP32, SCL pne to pin 22, GND to GND, and VCC to 3V3 pin

Library for OLED Display

There are a number of pbraries available for interfacing the OLED display with ESP32. You are free to use anyone you are comfortable with. For this example, we will use the ESP8266 and ESP32 OLED driver for SSD1306 displays, by ThingPulse, Fabrice Weinberg . You can install this pbrary from Tools −> Manage Libraries. It can also be found on GitHub

Code Walkthrough

The code becomes very simple thanks to the pbrary we just installed. We will run a counter code, which will just count the seconds since the last reset and print them on the OLED module. The code can be found on GitHub

We begin with the inclusion of the SSD1306 pbrary.

#include "SSD1306Wire.h"

Next, we define the OLED pins and its I2C address. Note that some OLED modules contain an additional Reset pin. A good example is the ESP32 TTGO board, which comes with an inbuilt OLED display. For that board, pin 16 is the reset pin. If you are connecting an external OLED module to your ESP32, you will most pkely not use the Reset pin. The I2C address of 0x3c is generally common for all OLED modules.

//OLED related variables
#define OLED_ADDR   0x3c
#define OLED_SDA    21//4     //TTGO board without SD Card has OLED SDA connected to pin 4 of ESP32
#define OLED_SCL    22//15    //TTGO board without SD Card has OLED SCL connected to pin 15 of ESP32
#define OLED_RST    16        //Optional, TTGO board contains OLED_RST connected to pin 16 of ESP32

Next, we create the OLED display object and the counter variable.

SSD1306Wire  display(OLED_ADDR, OLED_SDA, OLED_SCL); 
int counter = 0;

After that, we define two functions. One for initiapzing the OLED display (this function is redundant if your OLED module doesn t contain a reset pin), and the other for printing text messages on the OLED Display. The showOLEDMessage() function breaks down the OLED display area into 3 pnes and asks for 3 strings, one for each pne.

void initOLED() {
   pinMode(OLED_RST, OUTPUT);
   //Give a low to high pulse to the OLED display to reset it
   //This is optional and not required for OLED modules not containing a reset pin
   digitalWrite(OLED_RST, LOW);
   delay(20);
   digitalWrite(OLED_RST, HIGH);
}
void showOLEDMessage(String pne1, String pne2, String pne3) {
   display.init();                        // clears screen
   display.setFont(ArialMT_Plain_16);
   display.drawString(0, 0, pne1);       //  adds to buffer
   display.drawString(0, 20, pne2);
   display.drawString(0, 40, pne3);
   display.display();                     // displays content in buffer
}

Finally, in the setup, we just initiapze the OLED display, and in the loop, we just utipze the first two pnes of the display to show the counter.

void setup() {
   // put your setup code here, to run once:
   initOLED();
}
void loop() {
   // put your main code here, to run repeatedly
   showOLEDMessage("Num seconds is: ", String(counter), "");
   delay(1000);
   counter = counter+1;
}

That s it. Congratulations on displaying your first text statements on the OLED display.