From ef06fc9e808dc406e3ff670e4d4ef4bcf18f7921 Mon Sep 17 00:00:00 2001
From: Filipe Cavalcanti <filipe.cavalcanti@espressif.com>
Date: Thu, 6 Aug 2026 15:48:50 -0300
Subject: [PATCH] Documentation: update esp32p4-tab5 with LCD and touch info

Adds documentation entries to the tab5 board, mentioning the new
defconfigs and updates support features.

Signed-off-by: Filipe Cavalcanti <filipe.cavalcanti@espressif.com>
---
 .../esp32p4/boards/esp32p4-tab5/index.rst     | 47 +++++++++++++++++--
 .../platforms/risc-v/esp32p4/index.rst        |  4 +-
 2 files changed, 45 insertions(+), 6 deletions(-)

diff --git a/Documentation/platforms/risc-v/esp32p4/boards/esp32p4-tab5/index.rst b/Documentation/platforms/risc-v/esp32p4/boards/esp32p4-tab5/index.rst
index dc192f30661..5baf93de89e 100644
--- a/Documentation/platforms/risc-v/esp32p4/boards/esp32p4-tab5/index.rst
+++ b/Documentation/platforms/risc-v/esp32p4/boards/esp32p4-tab5/index.rst
@@ -33,7 +33,8 @@ Features
 
 * ESP32-P4 (dual RISC-V @ 360 MHz), 16 MB flash, 32 MB Octal PSRAM
 * ESP32-C6-MINI-1U companion (Wi-Fi 6 / BLE / Thread) over SDIO2
-* 5" MIPI-DSI IPS display, 1280x720 (ILI9881C), GT911 capacitive touch
+* 5" MIPI-DSI IPS display, 720x1280 (ST7121 or ST7123 on supported
+  units; older revisions use ILI9881C + GT911)
 * ES8388 audio codec + NS4150B speaker amp, ES7210 microphone array
 * SC2356 2 MP MIPI-CSI camera
 * BMI270 6-axis IMU, RX8130CE RTC, INA226 power monitor
@@ -55,10 +56,15 @@ Supported features
 +------------------------+--------------------------------------------------+
 | GPIO / BOOT button     | Yes                                              |
 +------------------------+--------------------------------------------------+
+| IO Expander (both)     | Yes                                              |
++------------------------+--------------------------------------------------+
+| MIPI-DSI host          | Yes                                              |
++------------------------+--------------------------------------------------+
+| ST7121/ST7123          | Yes                                              |
++------------------------+--------------------------------------------------+
 
 Not yet implemented (pins and I2C addresses documented below):
 
-* MIPI-DSI display (ILI9881C) and GT911 touch
 * Audio (ES8388 / ES7210), camera (SC2356)
 * INA226 power monitor — battery rail, 5 mOhm shunt (bus voltage = battery
   voltage; positive current = discharging, negative = charging)
@@ -80,7 +86,7 @@ GPIO         Function
 20           RS485 TX
 21           RS485 RX
 22           LCD backlight enable (LEDA, via ME2212 boost)
-23           Touch interrupt (TP_INT, GT911)
+23           Touch interrupt (TP_INT; ST7121/ST7123 or GT911)
 26           I2S DSDIN (audio data to ES8388)
 27           I2S SCLK (audio bit clock)
 29           I2S LRCK (audio word clock)
@@ -117,12 +123,13 @@ I2C device address map
 Address Device
 ======= ====================================================
 0x10    ES8388 audio codec
-0x14    GT911 touch controller
+0x14    GT911 touch (older ILI9881 units)
 0x32    RX8130CE RTC
 0x40    ES7210 microphone array
 0x41    INA226 power monitor
 0x43    PI4IOE5V6408-1 IO expander (LCD_EN / TOUCH_EN)
 0x44    PI4IOE5V6408-2 IO expander (USB / Wi-Fi enables)
+0x55    ST7123 touch controller
 0x68    BMI270 IMU
 ======= ====================================================
 
@@ -136,6 +143,38 @@ is printed because the upstream default targets rev >= 3.0.
 Configurations
 ==============
 
+lvgl_demo
+---------
+
+LVGL demo configuration with touch support.
+Requires the ST7123 touch controller version.
+
+.. note::
+   This configuration redirects the console to UART0 instead of the USB Serial/JTAG port
+   and sets a custom entry point to open LVGL demo on screen.
+
+.. code-block:: console
+
+   $ ./tools/configure.sh esp32p4-tab5:lvgl_demo
+   $ make -j
+
+
+lvgl_term
+---------
+
+LVGL terminal configuration with touch support.
+Requires the ST7123 touch controller version.
+
+.. note::
+   This configuration redirects the console to UART0 instead of the USB Serial/JTAG port
+   and sets a custom entry point to open LVGL terminal on screen.
+
+.. code-block:: console
+
+   $ ./tools/configure.sh esp32p4-tab5:lvgl_term
+   $ make -j
+
+
 nsh
 ---
 
diff --git a/Documentation/platforms/risc-v/esp32p4/index.rst b/Documentation/platforms/risc-v/esp32p4/index.rst
index 08764b0944d..b9da0ddbe4a 100644
--- a/Documentation/platforms/risc-v/esp32p4/index.rst
+++ b/Documentation/platforms/risc-v/esp32p4/index.rst
@@ -347,7 +347,7 @@ LED PWM            Yes
 MCPWM              Yes     Motor control and capture
 Parallel IO        No
 LCD Interface      No
-MIPI DSI           No
+MIPI DSI           Yes
 Timers             Yes
 SPIRAM / PSRAM     Yes
 Watchdog           Yes     MWDT0/1 and RWDT
@@ -966,7 +966,7 @@ ESP32-P4 Chip Revisions
 =======================
 
 .. attention:: NuttX by default supports ESP32-P4 chip revisions starting
-               from v3.0. 
+               from v3.0.
 
 Different ESP32-P4 chip revisions contain internal hardware breaking
 changes. Revisions 3.0 and higher are not compatible with 0.x and 1.x.