ES3C28P&ES3N28P 2.8-inch IPS ESP-IDF Example Program Guide
1. Software and Hardware Platform Description
Module: The 2.8-inch IPS ESP32-S3 display module features a 240x320 resolution and uses the ILI9341V display driver IC.
Module Main Control: ESP32-S3 chip, with a maximum main frequency of 240MHz, supporting 2.4G WIFI and Bluetooth.
ESP-IDF Version: 5.4.1
LVGL Version: 8.4.0
2. Pin Assignment Description
The 2.8-inch ESP32-S3 display module's main controller is the ESP32-S3 chip. The GPIO assignments for the onboard peripherals are shown in the table below:
ESP32-S3 Chip Pin Assignment Description
| Onboard Device | Onboard Device Pin | ESP32-S3 Connected Pin | Description |
|---|---|---|---|
| LCD | TFT_CS | IO10 | LCD Chip Select Control Signal, active low. |
| TFT_RS | IO46 | LCD Command/Data Selection Control Signal. High level for data, low level for command. | |
| TFT_SCK | IO12 | LCD SPI Bus Clock Signal. | |
| TFT_MOSI | IO11 | LCD SPI Bus Write Data Signal. | |
| TFT_MISO | IO13 | LCD SPI Bus Read Data Signal. | |
| TFT_RST | CHIP_PU | LCD Reset Control Signal, active low reset (shared with ESP32-S3 chip reset). | |
| CTP | TFT_BL | IO45 | LCD Backlight Control Signal (high level to turn on backlight, low level to turn off backlight). |
| TP_SDA | IO16 | Capacitive Touch Screen I2C Bus Data Signal. | |
| TP_SCL | IO15 | Capacitive Touch Screen I2C Bus Clock Signal. | |
| TP_RST | IO18 | Capacitive Touch Screen Reset Control Signal, active low reset. | |
| TP_INT | IO17 | Capacitive Touch Screen Interrupt Input Signal. When a touch event occurs, it inputs a low level. | |
| LED | RGB_INT | IO42 | Single-wire RGB three-color LED light. Can light up the red, green, and blue LEDs separately according to different signals. |
| SDCARD | SD_CLK | IO38 | SD card SDIO Bus Clock Signal. |
| SD_CMD | IO40 | SD card SDIO Bus Command Signal. | |
| SD_DO | IO39 | SD card SDIO Bus Data Signal. | |
| SD_D1 | IO41 | SD card SDIO Bus Data Signals (DATA0~DATA3 four data lines). | |
| SD_D2 | IO48 | ||
| SD_D3 | IO47 | ||
| BATTERY | BAT_ADC | IO9 | Battery voltage ADC value acquisition signal. |
| Audio | Audio_EN | IO1 | Audio output enable signal. Low level enables, high level disables. |
| I2S_MCK | IO4 | Audio I2S Bus Master Clock Signal. | |
| I2S_SCK | IO5 | Audio I2S Bus Bit Clock Signal. | |
| I2S_DO | IO6 | Audio I2S Bus Bit Output Data Signal. | |
| I2S_LRC | IO7 | Audio I2S Bus Left/Right Channel Selection Signal. High level: right channel; low level: left channel. | |
| I2S_DI | IO8 | Audio I2S Bus Bit Input Data Signal. | |
| KEY | BOOT_KEY | IO0 | Download mode selection key (press and hold this key while powering on, then release to enter download mode). |
| RESET_KEY | EN | ESP32-S3 reset key, active low reset (shared with LCD reset). | |
| USB | USB_N | IO19 | USB Bus Differential Signal Data Line Negative. |
| USB_P | IO20 | USB Bus Differential Signal Data Line Positive. | |
| Serial Port | TX0 | IO43 | ESP32-S3 Serial Port 0 Transmit Signal. |
| RX0 | IO44 | ESP32-S3 Serial Port 0 Receive Signal. | |
| POWER | TYPE-C_POWER | / | Type-C Power Interface, connects to 5V power. |
3. Example Program Description
3.1. Setting up the ESP32 IDF Development Environment
For detailed instructions on setting up the ESP32 IDF development environment, please refer to the "Setting up the ESP-IDF Environment with VS Code" document in the resource package.
3.2. Using the Example Program
The example program is located in the "1-Example Programs_Demo\ESP32-IDF" directory within the resource package. See the figure below:
This example program already has LVGL ported, and the relevant program files have been modified. It can be used directly. For information on LVGL porting, please refer to the "ESP-IDF LVGL Porting Guide" document in the resource package. The steps for using the example program are as follows:
- Copy the entire example program folder "2.8inch_ESP32-S3_LVGL" to a path with an all-English name. Otherwise, the compilation will fail due to an inability to find the path.
- Open the VS Code software, click "File" -> "Open Folder", as shown in the figure below:
- Find the example program folder, select it, and then click the "Select Folder" button to open the example program, as shown in the figure below:
- Connect the ESP32 device to the computer. Select the correct COM port, chip, and download method in the VS Code bottom toolbar, then click the compile and flash button [▶️].
- After flashing is complete, you will see content displayed on the display module.
