Wiring guide

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
ESP32-S3 · I2C LCDlive0.000 s 0.00x
Click to open it in the editor
The circuit itself, running on the simulator with the sketch below. Press what can be pressed; click anything else to open it in the editor.
Pin to pin

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 pinESP32-S3 pinWire colorWhy
VCC5VredThe LCD glass needs 5 V for its contrast; at 3.3 V most modules show nothing.
GNDGblueCommon ground.
SDAGPIO 8violetI2C data.
SCLGPIO 9cyanI2C clock.
Voltage

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 sketch

The working code for the ESP32-S3

Library: LiquidCrystal_I2C (LiquidCrystal_I2C.h). This is the sketch the circuit above runs.

I2C LCD on ESP32-S3
#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);
}
Output

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 ready
Pitfalls

Common 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.