En este tutorial te vamos a mostrar cómo usar la pantalla OLED I2C de 0,96 pulgadas SSD1306 con el ESP32. Vas a ver las funciones principales del display, cómo conectarlo a tu placa y los pasos necesarios para escribir texto de forma sencilla.
Componentes necesarios
(1) x Elegoo ESP32, (1) x Display OLED I2C, (2) x Protoboard de 400 puntos y (4) x Cables puente M-M (Macho a Macho).
Introducción al componente
El display OLED que vamos a usar es el modelo SSD1306: una pantalla monocromática de 0,96 pulgadas con 128x64 píxeles. Estos displays no necesitan retroiluminación, lo que permite un contraste bárbaro en ambientes oscuros y un consumo de energía muy bajo, ya que los píxeles solo gastan batería cuando están encendidos.
Como este modelo usa el protocolo I2C, el cableado es una pavada: solo tenés que conectarlo a los pines D21 (SDA) y D22 (SCL) del ESP32. Para controlarlo, vas a tener que instalar las librerías adafruit_SSD1306.h y adafruit_GFX.h desde el gestor de librerías del Arduino IDE.
Tips para escribir texto con estas librerías
Estas funciones te van a servir para manejar el display y dibujar gráficos simples: display.clearDisplay() apaga todos los píxeles, display.setTextSize(n) cambia el tamaño de la letra (del 1 al 8) y display.setCursor(x,y) define dónde empieza el texto. Acordate de llamar siempre a display.display() para que los cambios se vean reflejados en la pantalla.
Esquema de conexión y diagrama de cableado
Seguí las indicaciones de los pines para asegurar una conexión correcta entre el ESP32 y el display. Al usar I2C, recordá que la alimentación (VCC y GND) debe ser la adecuada para evitar problemas de funcionamiento en el módulo.
Código
Una vez que termines con los cables, probá alguno de los ejemplos de la librería en Archivo > Ejemplos > Adafruit SSD1306. Tené en cuenta que en el ESP32 los pines I2C se pueden remapear, pero en este tutorial usamos el GPIO 21 para SDA y el 22 para SCL; fijate de llamar a Wire.begin(21, 22) en tu programa para que todo ande bien.
Galería de referencia
Fuente: Adaptado al español desde el wiki oficial Elegoo (licencia CC BY-SA). Revisión técnica por equipo Breva.