How to wire an I2C LCD to an ESP32
To wire an I2C LCD to an ESP32, connect VCC to VIN (5 V from USB), GND to GND, SDA to GPIO 21 (D21) and SCL to GPIO 22 (D22). The backpack wants 5 V and its pull-ups then hold SDA and SCL at 5 V, which a ESP32 pin cannot take, so move those pull-ups to 3.3 V or put a level shifter in the bus. The sketch below uses the LiquidCrystal_I2C (LiquidCrystal_I2C.h) library. It writes the board name on the first line and counts the seconds on the second.
- 3.3 V logic
- Library: LiquidCrystal_I2C.h
- 4 wires
I2C LCD to ESP32 wiring table
Every wire in the circuit above, with the part’s pin names and the board’s own labels. The wire colors are the ones the circuit uses; on a real bench any colors work.
| I2C LCD pin | ESP32 pin | Wire color | Why |
|---|---|---|---|
| VCC | VIN (5 V from USB) | red | The LCD glass needs 5 V for its contrast; at 3.3 V most modules show nothing. |
| GND | GND | blue | Common ground. |
| SDA | GPIO 21 (D21) | violet | I2C data. |
| SCL | GPIO 22 (D22) | cyan | I2C clock. |
Power and logic levels for I2C LCD and ESP32
Logic level
The ESP32’s GPIO pins are 3.3 V logic and are not 5 V tolerant. Nothing wired to a pin may go above 3.3 V.
Supply
The I2C LCD takes 5 V from VIN (5 V from USB). That is the ESP32’s 5 V rail, so the part shares the current the board can supply.
This pair
On an ESP32 DevKit, Wire.begin() with no arguments puts SDA on GPIO 21 and SCL on GPIO 22, labeled D21 and D22. The backpack runs from 5 V and carries 4.7 k pull-ups on SDA and SCL, so on a real ESP32 those lines idle at 5 V. Either remove the backpack’s two pull-up resistors and add 4.7 k pull-ups to 3V3, or put a two-channel level shifter between them. The simulator does not punish it; a real ESP32 (Xtensa LX6) may.
Pins to leave alone
GPIO 34, 35, 36 (VP) and 39 (VN) are input only: they cannot drive a pin or take an internal pull-up. GPIO 0, 2, 5, 12 and 15 are strapping pins, read at power-on, and GPIO 6 to 11 are the flash chip.
The working code for the ESP32
Library: LiquidCrystal_I2C (LiquidCrystal_I2C.h). This is the sketch the circuit above runs.
#include <Wire.h>
#include <LiquidCrystal_I2C.h>
// A 16 x 2 display behind a PCF8574 backpack at 0x27.
// SDA GPIO 21 (D21), SCL GPIO 22 (D22).
LiquidCrystal_I2C lcd(0x27, 16, 2);
void setup() {
Serial.begin(115200);
lcd.init();
lcd.backlight();
lcd.setCursor(0, 0);
lcd.print("ESP32");
Serial.println("LCD ready");
}
void loop() {
lcd.setCursor(0, 1);
lcd.print("Seconds: ");
lcd.print(millis() / 1000);
lcd.print(" "); // clears the tail of a shorter number
delay(250);
}
What you should see
The first line of the display reads ESP32 and the second line reads Seconds: followed by a number that goes up once a second. The serial monitor, at 115200 baud, prints LCD ready once, after the display has been set up.
A blank screen with the backlight on means the contrast is too low or the address is wrong. This circuit answers at 0x27, the address most backpacks ship with.
The serial monitor prints this, recorded from the circuit above running:
LCD readyCommon mistakes wiring an I2C LCD to an ESP32
The wrong address
Backpacks with the PCF8574T chip answer at 0x27; those with the PCF8574AT answer at 0x3F. The screen lights but shows nothing when the address is wrong. Run an I2C scanner, or set the part’s address property in the editor to match yours.
Contrast turned all the way down
A row of solid blocks, or nothing at all with the backlight on, is usually the blue trimmer on the backpack. Turn it until the text appears. In the simulator the part has a contrast property for the same thing.
Powering it from 3V3
The backlight comes on, so it looks wired, but the liquid crystal needs about 5 V of drive for contrast and the characters stay invisible. Use VIN (5 V from USB).
Build your own I2C LCD project
Open this circuit in the editor, change the wiring or the code, and keep your version in a free account.