esp_lcd: ST7789V display offset issue (IDFGH-14574)

[jomoly]

Answers checklist.

• I have read the documentation ESP-IDF Programming Guide and the issue is not addressed there.
• I have updated my IDF branch (master or release) to the latest version and checked that the issue is present there.
• I have searched the issue tracker for a similar issue and not found a similar issue.

IDF version.

v5.4.0

Espressif SoC revision.

esp32-s3r8

Operating System used.

Windows

How did you build your project?

Command line with idf.py

If you are using Windows, please specify command line type.

CMD

Development Kit.

esp32-s3r8

Power Supply used.

USB

What is the expected behavior?

I am using ST7789V LCD (240x320) with esp_idf examples - i80_controller, it should show a FULL screen with esp logo and fps/cpu info, that is -

• Display content should start from the top of the screen (0,0)
• Full 240x320 resolution should be visible
• No display offset or noise

What is the actual behavior?

When using ST7789V LCD (240x320) with esp_lcd component, there's a display offset issue:

1. Top 20 pixels show noise/garbage
2. Display content is shifted down by 20 pixels
3. Bottom 20 pixels are cut off/not visible

Steps to reproduce.

1. Setup ESP32-S3 with ST7789V LCD (240x320)
2. Use esp_lcd component with default ST7789V driver
3. Run any example that displays content (e.g., lcd_i80_display example)
4. Observe the display offset issue

Debug Logs.

More Information.

No response

[suda-morris]

Hi @jomoly If you see the top 20 lines are full of noise, it might lead by the following code

esp-idf/examples/peripherals/lcd/i80_controller/main/i80_controller_example_main.c

Lines 231 to 233 in c586527

	// the gap is LCD panel specific, even panels with the same driver IC, can have different gap value
	esp_lcd_panel_invert_color(panel_handle, true);
	esp_lcd_panel_set_gap(panel_handle, 0, 20);

In your project, you can comment out the esp_lcd_panel_set_gap. Please let me know if this can help.