Merge pull request #425 from espressif/feature/hdmi

feat(hdmi): HDMI (LT8912B) support in ESP32-P4 EV board
espressif · Nov 18, 2024 · f6dc0a5 · f6dc0a5
2 parents 7075b95 + fa2a5f8
commit f6dc0a5
Show file tree

Hide file tree

Showing 13 changed files with 1,529 additions and 13 deletions.
diff --git a/LCD.md b/LCD.md
@@ -20,3 +20,4 @@ The list of available LCD displays and links to LCD driver component and touch d
 | <img src="docu/pics/st7796.jpg" width="150"> | Parallel/SPI | ST7796 | [Component Manager](https://components.espressif.com/component/espressif/esp_lcd_st7796) | - | - | |
 | <img src="docu/pics/esp32-s3-lcd-ev-board_480x480.png" width="150"> | [ESP32-S3-LCD-EV-Board](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/esp32-s3-lcd-ev-board/user_guide.html) | GC9503 | [Component Manager](https://components.espressif.com/component/espressif/esp_lcd_gc9503) | FT5X06 | [Component Manager](https://components.espressif.com/component/espressif/esp_lcd_touch_ft5x06) | |
 | <img src="docu/pics/esp32-s3-lcd-ev-board_800x480.png" width="150"> | [ESP32-S3-LCD-EV-Board-2](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/esp32-s3-lcd-ev-board/user_guide.html) | ST7262E43 | **N/A** | GT1151 | [Component Manager](https://components.espressif.com/component/espressif/esp_lcd_touch_gt1151) | |
+| <img src="docu/pics/Lontium.webp" width="150"> | HDMI | LT8912B | [Component Manager](https://components.espressif.com/component/espressif/esp_lcd_lt8912b) | - | - | |
diff --git a/bsp/esp32_p4_function_ev_board/Kconfig b/bsp/esp32_p4_function_ev_board/Kconfig
@@ -1,4 +1,4 @@
-menu "Board Support Package(ESP32-P4)"
+menu "Board Support Package (ESP32-P4)"
 
     config BSP_ERROR_CHECK
         bool "Enable error check in BSP"
@@ -131,7 +131,26 @@ menu "Board Support Package(ESP32-P4)"
                 bool "LCD 7-inch 1024x600 - ek79007"
             config BSP_LCD_TYPE_1280_800
                 bool "LCD 1280x800 - ili9881c"
-        endchoice           
+            config BSP_LCD_TYPE_HDMI
+                bool "HDMI - lt8912b"
+        endchoice    
+
+        choice BSP_LCD_HDMI_RESOLUTION
+            depends on BSP_LCD_TYPE_HDMI
+            prompt "Select HDMI resolution"
+            default BSP_LCD_HDMI_1280x720_60HZ
+            help
+                Select the HDMI resolution.
+
+            config BSP_LCD_HDMI_800x600_60HZ
+                bool "800x600@60HZ"
+            config BSP_LCD_HDMI_1280x720_60HZ
+                bool "1280x720@60HZ"
+            config BSP_LCD_HDMI_1280x800_60HZ
+                bool "1280x800@60HZ"
+            config BSP_LCD_HDMI_1920x1080_30HZ
+                bool "1920x1080@30HZ"
+        endchoice          
 
     endmenu
 

diff --git a/bsp/esp32_p4_function_ev_board/README.md b/bsp/esp32_p4_function_ev_board/README.md
@@ -15,13 +15,24 @@ ESP32-P4 Function EV Board is internal Espressif board for testing features on E
 Configuration in `menuconfig`.
 
 Selection LCD display `Board Support Package(ESP32-P4) --> Display --> Select LCD type`
-- LCD 7-inch 1280x800 - ili9881c (default)
+- LCD 1280x800 - ili9881c (default)
 - LCD 1024x600 - ek79007
+- HDMI - lt8912b
+    - 800x600@60HZ
+    - 1280x720@60HZ
+    - 1280x800@60HZ
+    - 1920x1080@30HZ
 
 Selection color format `Board Support Package(ESP32-P4) --> Display --> Select LCD color format`
 - RGB565 (default)
 - RGB888
 
+## HDMI Support
+
+This BSP supports HDMI converter Lontium LT8912B. Follow these rules for using it with HDMI:
+- Use ESP-IDF 5.4 or older (from commit [93fdbf2](https://github.com/espressif/esp-idf/commit/93fdbf25b3ea7e44d1f519ed61050847dcc8a076))
+- Only RGB888 is supported with HDMI
+- Use MIPI-DSI to HDMI converter Lontium LT8912B
 
 <!-- Autogenerated start: Dependencies -->
 ### Capabilities and dependencies

diff --git a/bsp/esp32_p4_function_ev_board/esp32_p4_function_ev_board.c b/bsp/esp32_p4_function_ev_board/esp32_p4_function_ev_board.c
@@ -21,6 +21,8 @@
 
 #if CONFIG_BSP_LCD_TYPE_1024_600
 #include "esp_lcd_ek79007.h"
+#elif CONFIG_BSP_LCD_TYPE_HDMI
+#include "esp_lcd_lt8912b.h"
 #else
 #include "esp_lcd_ili9881c.h"
 #endif
@@ -402,12 +404,14 @@ esp_err_t bsp_display_new(const bsp_display_config_t *config, esp_lcd_panel_hand
 esp_err_t bsp_display_new_with_handles(const bsp_display_config_t *config, bsp_lcd_handles_t *ret_handles)
 {
     esp_err_t ret = ESP_OK;
+    esp_lcd_panel_io_handle_t io = NULL;
+    esp_lcd_panel_handle_t disp_panel = NULL;
 
     ESP_RETURN_ON_ERROR(bsp_display_brightness_init(), TAG, "Brightness init failed");
     ESP_RETURN_ON_ERROR(bsp_enable_dsi_phy_power(), TAG, "DSI PHY power failed");
 
     /* create MIPI DSI bus first, it will initialize the DSI PHY as well */
-    esp_lcd_dsi_bus_handle_t mipi_dsi_bus;
+    esp_lcd_dsi_bus_handle_t mipi_dsi_bus = NULL;
     esp_lcd_dsi_bus_config_t bus_config = {
         .bus_id = 0,
         .num_data_lanes = BSP_LCD_MIPI_DSI_LANE_NUM,
@@ -416,17 +420,17 @@ esp_err_t bsp_display_new_with_handles(const bsp_display_config_t *config, bsp_l
     };
     ESP_RETURN_ON_ERROR(esp_lcd_new_dsi_bus(&bus_config, &mipi_dsi_bus), TAG, "New DSI bus init failed");
 
+#if !CONFIG_BSP_LCD_TYPE_HDMI
     ESP_LOGI(TAG, "Install MIPI DSI LCD control panel");
     // we use DBI interface to send LCD commands and parameters
-    esp_lcd_panel_io_handle_t io;
     esp_lcd_dbi_io_config_t dbi_config = {
         .virtual_channel = 0,
-        .lcd_cmd_bits = 8,   // according to the LCD ILI9881C spec
-        .lcd_param_bits = 8, // according to the LCD ILI9881C spec
+        .lcd_cmd_bits = 8,   // according to the LCD spec
+        .lcd_param_bits = 8, // according to the LCD spec
     };
     ESP_GOTO_ON_ERROR(esp_lcd_new_panel_io_dbi(mipi_dsi_bus, &dbi_config, &io), err, TAG, "New panel IO failed");
+#endif
 
-    esp_lcd_panel_handle_t disp_panel = NULL;
 #if CONFIG_BSP_LCD_TYPE_1024_600
     // create EK79007 control panel
     ESP_LOGI(TAG, "Install EK79007 LCD control panel");
@@ -453,7 +457,7 @@ esp_err_t bsp_display_new_with_handles(const bsp_display_config_t *config, bsp_l
     ESP_GOTO_ON_ERROR(esp_lcd_new_panel_ek79007(io, &lcd_dev_config, &disp_panel), err, TAG, "New LCD panel EK79007 failed");
     ESP_GOTO_ON_ERROR(esp_lcd_panel_reset(disp_panel), err, TAG, "LCD panel reset failed");
     ESP_GOTO_ON_ERROR(esp_lcd_panel_init(disp_panel), err, TAG, "LCD panel init failed");
-#else
+#elif CONFIG_BSP_LCD_TYPE_1280_800
     // create ILI9881C control panel
     ESP_LOGI(TAG, "Install ILI9881C LCD control panel");
 #if CONFIG_BSP_LCD_COLOR_FORMAT_RGB888
@@ -480,15 +484,100 @@ esp_err_t bsp_display_new_with_handles(const bsp_display_config_t *config, bsp_l
     ESP_GOTO_ON_ERROR(esp_lcd_panel_reset(disp_panel), err, TAG, "LCD panel reset failed");
     ESP_GOTO_ON_ERROR(esp_lcd_panel_init(disp_panel), err, TAG, "LCD panel init failed");
     ESP_GOTO_ON_ERROR(esp_lcd_panel_disp_on_off(disp_panel, true), err, TAG, "LCD panel ON failed");
+
+#elif CONFIG_BSP_LCD_TYPE_HDMI
+
+#if !CONFIG_BSP_LCD_COLOR_FORMAT_RGB888
+#error The color format must be RGB888 in HDMI display type!
+#endif
+    ESP_LOGI(TAG, "Install MIPI DSI HDMI control panel");
+    ESP_RETURN_ON_ERROR(bsp_i2c_init(), TAG, "I2C init failed");
+
+    /* Main IO */
+    esp_lcd_panel_io_i2c_config_t io_config = LT8912B_IO_CFG(CONFIG_BSP_I2C_CLK_SPEED_HZ, LT8912B_IO_I2C_MAIN_ADDRESS);
+    ESP_ERROR_CHECK(esp_lcd_new_panel_io_i2c(i2c_handle, &io_config, &io));
+
+    /* CEC DSI IO */
+    esp_lcd_panel_io_handle_t io_cec_dsi = NULL;
+    esp_lcd_panel_io_i2c_config_t io_config_cec = LT8912B_IO_CFG(CONFIG_BSP_I2C_CLK_SPEED_HZ, LT8912B_IO_I2C_CEC_ADDRESS);
+    ESP_ERROR_CHECK(esp_lcd_new_panel_io_i2c(i2c_handle, &io_config_cec, &io_cec_dsi));
+
+    /* AVI IO */
+    esp_lcd_panel_io_handle_t io_avi = NULL;
+    esp_lcd_panel_io_i2c_config_t io_config_avi = LT8912B_IO_CFG(CONFIG_BSP_I2C_CLK_SPEED_HZ, LT8912B_IO_I2C_AVI_ADDRESS);
+    ESP_ERROR_CHECK(esp_lcd_new_panel_io_i2c(i2c_handle, &io_config_avi, &io_avi));
+
+    /* DPI config */
+#if CONFIG_BSP_LCD_HDMI_800x600_60HZ
+    ESP_LOGI(TAG, "HDMI configuration for 800x600@60HZ");
+    esp_lcd_dpi_panel_config_t dpi_config = LT8912B_800x600_PANEL_60HZ_DPI_CONFIG();
+#elif CONFIG_BSP_LCD_HDMI_1024x768_60HZ
+    ESP_LOGI(TAG, "HDMI configuration for 1024x768@60HZ");
+    esp_lcd_dpi_panel_config_t dpi_config = LT8912B_1024x768_PANEL_60HZ_DPI_CONFIG();
+#elif CONFIG_BSP_LCD_HDMI_1280x720_60HZ
+    ESP_LOGI(TAG, "HDMI configuration for 1280x720@60HZ");
+    esp_lcd_dpi_panel_config_t dpi_config = LT8912B_1280x720_PANEL_60HZ_DPI_CONFIG();
+#elif CONFIG_BSP_LCD_HDMI_1280x800_60HZ
+    ESP_LOGI(TAG, "HDMI configuration for 1280x800@60HZ");
+    esp_lcd_dpi_panel_config_t dpi_config = LT8912B_1280x800_PANEL_60HZ_DPI_CONFIG();
+#elif CONFIG_BSP_LCD_HDMI_1920x1080_30HZ
+    ESP_LOGI(TAG, "HDMI configuration for 1920x1080@30HZ");
+    esp_lcd_dpi_panel_config_t dpi_config = LT8912B_1920x1080_PANEL_30HZ_DPI_CONFIG();
+#elif CONFIG_BSP_LCD_HDMI_1920x1080_60HZ
+    ESP_LOGI(TAG, "HDMI configuration for 1920x1080@60HZ");
+    /* This setting is not working yet, it is only for developing and testing */
+    esp_lcd_dpi_panel_config_t dpi_config = LT8912B_1920x1080_PANEL_60HZ_DPI_CONFIG();
+#else
+#error Unsupported display type
 #endif
+    dpi_config.num_fbs = CONFIG_BSP_LCD_DPI_BUFFER_NUMS;
+    lt8912b_vendor_config_t vendor_config = {
+#if CONFIG_BSP_LCD_HDMI_800x600_60HZ
+        .video_timing = ESP_LCD_LT8912B_VIDEO_TIMING_800x600_60Hz(),
+#elif CONFIG_BSP_LCD_HDMI_1024x768_60HZ
+        .video_timing = ESP_LCD_LT8912B_VIDEO_TIMING_1024x768_60Hz(),
+#elif CONFIG_BSP_LCD_HDMI_1280x720_60HZ
+        .video_timing = ESP_LCD_LT8912B_VIDEO_TIMING_1280x720_60Hz(),
+#elif CONFIG_BSP_LCD_HDMI_1280x800_60HZ
+        .video_timing = ESP_LCD_LT8912B_VIDEO_TIMING_1280x800_60Hz(),
+#elif CONFIG_BSP_LCD_HDMI_1920x1080_30HZ
+        .video_timing = ESP_LCD_LT8912B_VIDEO_TIMING_1920x1080_30Hz(),
+#elif CONFIG_BSP_LCD_HDMI_1920x1080_60HZ
+        /* This setting is not working yet, it is only for developing and testing */
+        .video_timing = ESP_LCD_LT8912B_VIDEO_TIMING_1920x1080_60Hz(),
+#else
+#error Unsupported display type
+#endif
+        .mipi_config = {
+            .dsi_bus = mipi_dsi_bus,
+            .dpi_config = &dpi_config,
+            .lane_num = BSP_LCD_MIPI_DSI_LANE_NUM,
+        },
+    };
+    const esp_lcd_panel_dev_config_t panel_config = {
+        .bits_per_pixel = 24,
+        .rgb_ele_order = BSP_LCD_COLOR_SPACE,
+        .reset_gpio_num = BSP_LCD_RST,
+        .vendor_config = &vendor_config,
+    };
+    const esp_lcd_panel_lt8912b_io_t io_all = {
+        .main = io,
+        .cec_dsi = io_cec_dsi,
+        .avi = io_avi,
+    };
+    ESP_ERROR_CHECK(esp_lcd_new_panel_lt8912b(&io_all, &panel_config, &disp_panel));
+    ESP_GOTO_ON_ERROR(esp_lcd_panel_reset(disp_panel), err, TAG, "LCD panel reset failed");
+    ESP_GOTO_ON_ERROR(esp_lcd_panel_init(disp_panel), err, TAG, "LCD panel init failed");
+
+#endif //CONFIG_BSP_LCD_TYPE_
 
     /* Return all handles */
     ret_handles->io = io;
     ret_handles->mipi_dsi_bus = mipi_dsi_bus;
     ret_handles->panel = disp_panel;
     ret_handles->control = NULL;
 
-    ESP_LOGI(TAG, "Display initialized");
+    ESP_LOGI(TAG, "Display initialized with resolution %dx%d", BSP_LCD_H_RES, BSP_LCD_V_RES);
 
     return ret;
 
@@ -499,12 +588,21 @@ esp_err_t bsp_display_new_with_handles(const bsp_display_config_t *config, bsp_l
     if (io) {
         esp_lcd_panel_io_del(io);
     }
+#if CONFIG_BSP_LCD_TYPE_HDMI
+    if (io_cec_dsi) {
+        esp_lcd_panel_io_del(io_cec_dsi);
+    }
+    if (io_avi) {
+        esp_lcd_panel_io_del(io_avi);
+    }
+#endif
     if (mipi_dsi_bus) {
         esp_lcd_del_dsi_bus(mipi_dsi_bus);
     }
     return ret;
 }
 
+#if !CONFIG_BSP_LCD_TYPE_HDMI
 esp_err_t bsp_touch_new(const bsp_touch_config_t *config, esp_lcd_touch_handle_t *ret_touch)
 {
     /* Initilize I2C */
@@ -537,6 +635,7 @@ esp_err_t bsp_touch_new(const bsp_touch_config_t *config, esp_lcd_touch_handle_t
     ESP_RETURN_ON_ERROR(esp_lcd_new_panel_io_i2c(i2c_handle, &tp_io_config, &tp_io_handle), TAG, "");
     return esp_lcd_touch_new_i2c_gt911(tp_io_handle, &tp_cfg, ret_touch);
 }
+#endif //!CONFIG_BSP_LCD_TYPE_HDMI
 
 #if (BSP_CONFIG_NO_GRAPHIC_LIB == 0)
 static lv_display_t *bsp_display_lcd_init(const bsp_display_cfg_t *cfg)
@@ -601,6 +700,7 @@ static lv_display_t *bsp_display_lcd_init(const bsp_display_cfg_t *cfg)
     return lvgl_port_add_disp_dsi(&disp_cfg, &dpi_cfg);
 }
 
+#if !CONFIG_BSP_LCD_TYPE_HDMI
 static lv_indev_t *bsp_display_indev_init(lv_display_t *disp)
 {
     esp_lcd_touch_handle_t tp;
@@ -615,6 +715,7 @@ static lv_indev_t *bsp_display_indev_init(lv_display_t *disp)
 
     return lvgl_port_add_touch(&touch_cfg);
 }
+#endif //!CONFIG_BSP_LCD_TYPE_HDMI
 
 lv_display_t *bsp_display_start(void)
 {
@@ -645,9 +746,9 @@ lv_display_t *bsp_display_start_with_config(const bsp_display_cfg_t *cfg)
     BSP_ERROR_CHECK_RETURN_NULL(bsp_display_brightness_init());
 
     BSP_NULL_CHECK(disp = bsp_display_lcd_init(cfg), NULL);
-
+#if !CONFIG_BSP_LCD_TYPE_HDMI
     BSP_NULL_CHECK(disp_indev = bsp_display_indev_init(disp), NULL);
-
+#endif
     return disp;
 }
 

diff --git a/bsp/esp32_p4_function_ev_board/idf_component.yml b/bsp/esp32_p4_function_ev_board/idf_component.yml
@@ -1,4 +1,4 @@
-version: "4.1.1"
+version: "4.2.0"
 description: Board Support Package (BSP) for ESP32-P4 Function EV Board (preview)
 url: https://github.com/espressif/esp-bsp/tree/master/bsp/esp32_p4_function_ev_board
 
@@ -23,3 +23,7 @@ dependencies:
   esp_codec_dev:
     version: "1.2.*"
     public: true
+
+  espressif/esp_lcd_lt8912b:
+    version: ">=0.1.0,<1.0.0"
+    override_path: "../../components/lcd/esp_lcd_lt8912b"
diff --git a/bsp/esp32_p4_function_ev_board/include/bsp/display.h b/bsp/esp32_p4_function_ev_board/include/bsp/display.h
@@ -47,6 +47,37 @@
 #define BSP_LCD_MIPI_DSI_LCD_VSYNC    (635)
 #define BSP_LCD_MIPI_DSI_LCD_VBP      (23)
 #define BSP_LCD_MIPI_DSI_LCD_VFP      (12)
+
+#elif CONFIG_BSP_LCD_TYPE_HDMI
+#if CONFIG_BSP_LCD_HDMI_800x600_60HZ
+/* LCD display definition 800x600 60Hz */
+#define BSP_LCD_H_RES              (800)
+#define BSP_LCD_V_RES              (600)
+#elif CONFIG_BSP_LCD_HDMI_1024x768_60HZ
+/* LCD display definition 1024x768 60Hz */
+#define BSP_LCD_H_RES              (1024)
+#define BSP_LCD_V_RES              (768)
+#elif CONFIG_BSP_LCD_HDMI_1280x720_60HZ
+/* LCD display definition 1280x720 60Hz */
+#define BSP_LCD_H_RES              (1280)
+#define BSP_LCD_V_RES              (720)
+#elif CONFIG_BSP_LCD_HDMI_1280x800_60HZ
+/* LCD display definition 1280x800 60Hz */
+#define BSP_LCD_H_RES              (1280)
+#define BSP_LCD_V_RES              (800)
+#elif CONFIG_BSP_LCD_HDMI_1920x1080_30HZ
+/* LCD display definition 1920x1080 30Hz */
+#define BSP_LCD_H_RES              (1920)
+#define BSP_LCD_V_RES              (1080)
+#elif CONFIG_BSP_LCD_HDMI_1920x1080_60HZ
+/* LCD display definition 1920x1080 60Hz */
+/* This setting is not working yet, it is only for developing and testing */
+#define BSP_LCD_H_RES              (1920)
+#define BSP_LCD_V_RES              (1080)
+#else
+#error Unsupported display type
+#endif
+
 #else
 /* LCD display definition 1280x800 */
 #define BSP_LCD_H_RES              (800)

diff --git a/components/lcd/esp_lcd_lt8912b/CMakeLists.txt b/components/lcd/esp_lcd_lt8912b/CMakeLists.txt
@@ -0,0 +1,4 @@
+idf_component_register(SRCS "esp_lcd_lt8912b.c"
+                       INCLUDE_DIRS "include"
+                       REQUIRES "esp_lcd"
+                       PRIV_REQUIRES "esp_driver_gpio")
diff --git a/components/lcd/esp_lcd_lt8912b/README.md b/components/lcd/esp_lcd_lt8912b/README.md
@@ -0,0 +1,24 @@
+# ESP LCD LT8912B
+
+[![Component Registry](https://components.espressif.com/components/espressif/esp_lcd_lt8912b/badge.svg)](https://components.espressif.com/components/espressif/esp_lcd_lt8912b)
+
+Implementation of the LT8912B MIPI-DSI to HDMI bridge with esp_lcd component.
+
+| LCD controller | Communication interface | Component name | Link to datasheet |
+| :------------: | :---------------------: | :------------: | :---------------: |
+| LT8912B        | I2C                     | esp_lcd_lt8912b | [Specification](http://www.lontiumsemi.com/UploadFiles/2022-03/LT8912B_Brief_R1.3.pdf) |
+
+> [!WARNING]
+> This controller suports only RGB888 color mode.
+
+## Add to project
+
+Packages from this repository are uploaded to [Espressif's component service](https://components.espressif.com/).
+You can add them to your project via `idf.py add-dependency`, e.g.
+
+```text
+idf.py add-dependency esp_lcd_lt8912b
+```
+
+Alternatively, you can create `idf_component.yml`. More is in [Espressif's documentation](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/tools/idf-component-manager.html).
+