How to wire an I2C LCD to an ESP32-S3
To wire an I2C LCD to an ESP32-S3, connect VCC to 5V, GND to G, SDA to GPIO 8 and SCL to GPIO 9. The backpack wants 5 V and its pull-ups then hold SDA and SCL at 5 V, which a ESP32-S3 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-S3 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-S3 pin | Wire color | Why |
|---|---|---|---|
| VCC | 5V | red | The LCD glass needs 5 V for its contrast; at 3.3 V most modules show nothing. |
| GND | G | blue | Common ground. |
| SDA | GPIO 8 | violet | I2C data. |
| SCL | GPIO 9 | cyan | I2C clock. |
Power and logic levels for I2C LCD and ESP32-S3
Logic level
The ESP32-S3’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 5V. That is the ESP32-S3’s 5 V rail, so the part shares the current the board can supply.
This pair
On the ESP32-S3, Wire.begin() uses GPIO 8 for SDA and GPIO 9 for SCL. The silkscreen names each pin by its GPIO number, so the labels match the code. The backpack runs from 5 V and carries 4.7 k pull-ups on SDA and SCL, so on a real ESP32-S3 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-S3 (Xtensa LX7) may.
Pins to leave alone
GPIO 19 and 20 are the USB port’s data lines, GPIO 35 to 37 belong to the PSRAM on octal-PSRAM boards such as the N8R8, and GPIO 0, 3, 45 and 46 are strapping pins.
The working code for the ESP32-S3
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 8, SCL GPIO 9.
LiquidCrystal_I2C lcd(0x27, 16, 2);
void setup() {
Serial.begin(115200);
lcd.init();
lcd.backlight();
lcd.setCursor(0, 0);
lcd.print("ESP32-S3");
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-S3 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-S3
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 5V.
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.