How To Interface OLED With ESP32

by

To interface an OLED display with an ESP32, you can use an OLED display that communicates over the I2C protocol, which is common for many small OLED displays. Below are the connection details, code example, and explanation to help you set it up.

Components Needed:

  1. ESP32 Development Board
  2. OLED Display (e.g., 0.96″ I2C OLED, SSD1306)
  3. Jumper wires
  4. Breadboard (optional)

OLED Pinout (For an I2C OLED)

Here are the common pin connections for the I2C interface on an OLED display:

  • VCC: 3.3V (Can be connected to 3.3V on the ESP32)
  • GND: GND (Connected to ESP32 GND)
  • SCL: Clock (Connected to ESP32 Pin 22, default I2C SCL pin)
  • SDA: Data (Connected to ESP32 Pin 21, default I2C SDA pin)

Wiring:

  • OLED VCC → ESP32 3.3V
  • OLED GND → ESP32 GND
  • OLED SCL → ESP32 Pin 22 (SCL)
  • OLED SDA → ESP32 Pin 21 (SDA)

Required Libraries:

For this project, you’ll need the following libraries to control the OLED display:

  • Adafruit_SSD1306: The driver for controlling the OLED display.
  • Adafruit_GFX: The graphics library required by Adafruit_SSD1306.

You can install these libraries via the Arduino IDE by navigating to Sketch > Include Library > Manage Libraries, and then searching for and installing both Adafruit SSD1306 and Adafruit GFX.

Code:

#include <Wire.h>                // Include the Wire library for I2C communication
#include <Adafruit_GFX.h>         // Include the Adafruit graphics library
#include <Adafruit_SSD1306.h>     // Include the Adafruit SSD1306 OLED library

#define SCREEN_WIDTH 128          // OLED display width, in pixels
#define SCREEN_HEIGHT 64          // OLED display height, in pixels
#define OLED_RESET -1             // Reset pin (if your OLED has a reset pin, connect it, otherwise leave it -1)

// Create the display object with I2C connection, using the correct address
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);

void setup() {
  // Start serial communication for debugging
  Serial.begin(115200);

  // Initialize the OLED display with the correct I2C address (0x3C is common)
  if (!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) {
    Serial.println(F("SSD1306 allocation failed"));
    for (;;); // Infinite loop to stop the program if initialization fails
  }

  display.display();            // Actually initialize the display
  delay(2000);                  // Pause for 2 seconds to show the blank screen
  
  // Clear the display buffer
  display.clearDisplay();

  // Set text color to white and text size to 1
  display.setTextColor(SSD1306_WHITE);
  display.setTextSize(2);
  
  // Set cursor to top-left corner
  display.setCursor(0, 0);

  // Print "Hello, ESP32!" to the screen
  display.print(F("Hello, ESP32!"));
  
  // Actually render the display
  display.display();
}

void loop() {
  // Your main code goes here
}

Explanation:

  1. Libraries:
    • Wire.h: Handles I2C communication.
    • Adafruit_GFX.h: Provides basic graphics functions such as drawing text, lines, and shapes.
    • Adafruit_SSD1306.h: This is the specific driver for SSD1306-based OLED displays.
  2. Initialization:
    • The OLED display is initialized using the begin() function. If initialization fails, it will print an error message to the Serial Monitor.
  3. Display Output:
    • The clearDisplay() function clears any previous content on the OLED screen.
    • setCursor() sets the position where the text will be printed.
    • setTextSize() adjusts the font size of the text.
    • setTextColor() sets the color of the text (in this case, white).
    • display.print() prints the text to the buffer.
    • display.display() sends the buffer contents to the actual OLED display to show it.

Notes:

  • Ensure your ESP32 is properly powered with 3.3V and the OLED display is compatible with 3.3V (most of them are).
  • If the display doesn’t work, make sure the I2C address is correct. The common I2C address for the SSD1306 is 0x3C, but it may differ (0x3D) depending on the manufacturer.

This should get your OLED up and running with the ESP32!