lcd_mipi_dsi

Supported ESP SoCs	ESP32-P4

Supported LCD Controllers	EK79007	HX8399	ILI9881C	JD9365	JD9165	ST7701	ST7703	ST7796	ST77922

MIPI-DSI LCD Example

Overview

This example demonstrates how to drive different model LCDs with MIPI-DSI interface bus and test them by displaying color bars.

How to Use

Step 1. Install SDK and dependencies

• Install the following SDK and library dependencies:

  • See SDK & Dependencies and Installing Libraries sections for more information

Step 2. Configure the libraries

• [Optional] ESP32_Display_Panel:

  • This example already has the esp_panel_drivers_conf.h configuration file in the project directory. Edit this file as needed
  • See Configuring Guide section for more information

• [Optional] esp-lib-utils :

  • This example already has the esp_utils_conf.h configuration file in the project directory. Edit this file as needed
  • See Configuring esp-lib-utils section for more information

Step 3. Configure the example

• [Mandatory] Edit the macro definitions in the lcd_mipi_dsi.ino file

Step 4. Configure Arduino IDE

• Navigate to the Tools menu
• Select the target board in the Board menu
• Change the PSRAM option to OPI PSRAM if using ESP32S3R8 + RGB LCD, or Enabled if using ESP32P4 + MIPI-DSI LCD
• Change the USB CDC On Boot option to Enabled if using USB port, or Disabled if using UART port. If this configuration differs from previous flashing, first enable Erase All Flash Before Sketch Upload, then it can be disabled after flashing.
• Change other configurations as needed
• see Configuring Arduino IDE for more information

Step 5. Compile and upload the project

• Connect the board to your computer
• Select the correct serial port
• Click the upload button

Step 6. Check the serial output

• Open the serial monitor and select the correct baud rate (like 115200)
• Check the output logs

Serial Output

The following are the logs output when using the EK79007 LCD. The logs content may vary with different LCDs or different configurations, and it is provided for reference only.

...
nitializing backlight and turn it on
Initializing "MIPI-DSI" LCD without config
[I][Panel][esp_lcd_ek79007.c:0065](esp_lcd_new_panel_ek79007): version: 1.0.1
Show MIPI-DSI color bar patterns
Draw color bar from top left to bottom right, the order is B - G - R
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
LCD draw finish callback
IDLE loop
LCD FPS: 13
IDLE loop
LCD FPS: 69
IDLE loop
LCD FPS: 69
...

Troubleshooting

Please check the FAQ first to see if the same question exists. If not, please create a Github Issue. We will get back to you as soon as possible.