Merge branch 'feat/add_mipi_dsi_avoid_example' into 'master'

feat(lcd): Added MIPI-DSI avoid-tear example.

See merge request ae_group/esp-iot-solution!1186

Author: Lzw655

.gitlab/ci/build.yml

@@ -375,6 +375,16 @@ build_example_check_pedestrian_flow:
   variables:
     EXAMPLE_DIR: examples/check_pedestrian_flow
 
+build_example_display_lcd_lcd_layer_blending:
+  extends:
+    - .build_examples_template
+    - .rules:build:example_display_lcd_lcd_layer_blending
+  parallel:
+    matrix:
+      - IMAGE: espressif/idf:release-v5.4
+  variables:
+    EXAMPLE_DIR: examples/display/lcd/lcd_layer_blending
+
 build_example_display_lcd_lcd_with_te:
   extends:
     - .build_examples_template
@@ -385,6 +395,16 @@ build_example_display_lcd_lcd_with_te:
   variables:
     EXAMPLE_DIR: examples/display/lcd/lcd_with_te
 
+build_example_display_lcd_mipi_dsi_avoid_tearing:
+  extends:
+    - .build_examples_template
+    - .rules:build:example_display_lcd_mipi_dsi_avoid_tearing
+  parallel:
+    matrix:
+      - IMAGE: espressif/idf:release-v5.4
+  variables:
+    EXAMPLE_DIR: examples/display/lcd/mipi_dsi_avoid_tearing
+
 build_example_display_lcd_qspi_with_ram:
   extends:
     - .build_examples_template

.gitlab/ci/rules.yml

@@ -436,9 +436,15 @@
 .patterns-example_common_components_camera: &patterns-example_common_components_camera
   - "examples/common_components/camera/**/*"
 
+.patterns-example_display_lcd_lcd_layer_blending: &patterns-example_display_lcd_lcd_layer_blending
+  - "examples/display/lcd/lcd_layer_blending/**/*"
+
 .patterns-example_display_lcd_lcd_with_te: &patterns-example_display_lcd_lcd_with_te
   - "examples/display/lcd/lcd_with_te/**/*"
 
+.patterns-example_display_lcd_mipi_dsi_avoid_tearing: &patterns-example_display_lcd_mipi_dsi_avoid_tearing
+  - "examples/display/lcd/mipi_dsi_avoid_tearing/**/*"
+
 .patterns-example_display_lcd_qspi_with_ram: &patterns-example_display_lcd_qspi_with_ram
   - "examples/display/lcd/qspi_with_ram/**/*"
 
@@ -807,6 +813,18 @@
     - <<: *if-dev-push
       changes: *patterns-example_check_pedestrian_flow
 
+.rules:build:example_display_lcd_lcd_layer_blending:
+  rules:
+    - <<: *if-protected
+    - <<: *if-label-build
+    - <<: *if-trigger-job
+    - <<: *if-dev-push
+      changes: *patterns-build_system
+    - <<: *if-dev-push
+      changes: *patterns-components_display_lcd_esp_lcd_ek79007
+    - <<: *if-dev-push
+      changes: *patterns-example_display_lcd_lcd_layer_blending
+
 .rules:build:example_display_lcd_lcd_with_te:
   rules:
     - <<: *if-protected
@@ -819,6 +837,18 @@
     - <<: *if-dev-push
       changes: *patterns-components_display_lcd_esp_lcd_axs15231b
 
+.rules:build:example_display_lcd_mipi_dsi_avoid_tearing:
+  rules:
+    - <<: *if-protected
+    - <<: *if-label-build
+    - <<: *if-trigger-job
+    - <<: *if-dev-push
+      changes: *patterns-build_system
+    - <<: *if-dev-push
+      changes: *patterns-components_display_lcd_esp_lcd_ek79007
+    - <<: *if-dev-push
+      changes: *patterns-example_display_lcd_mipi_dsi_avoid_tearing
+
 .rules:build:example_display_lcd_qspi_with_ram:
   rules:
     - <<: *if-protected

components/display/lcd/esp_lcd_st77903_rgb/idf_component.yml

@@ -1,6 +1,7 @@
 version: "1.0.0"
 targets:
   - esp32s3
+  - esp32p4
 description: ESP LCD ST77903 RGB
 url: https://github.com/espressif/esp-iot-solution/tree/master/components/display/lcd/esp_lcd_st77903_rgb
 repository: https://github.com/espressif/esp-iot-solution.git

examples/.build-rules.yml

@@ -159,6 +159,14 @@ examples/check_pedestrian_flow:
   enable:
     - if: IDF_TARGET in ["esp32","esp32s2","esp32s3","esp32c3"]
 
+examples/display/lcd/lcd_layer_blending:
+  enable:
+    - if: IDF_TARGET in ["esp32p4"]
+
+examples/display/lcd/mipi_dsi_avoid_tearing:
+  enable:
+    - if: IDF_TARGET in ["esp32p4"]
+
 examples/display/lcd/qspi_with_ram:
   enable:
     - if: IDF_TARGET in ["esp32","esp32c2","esp32c3","esp32c6","esp32h2","esp32s2", "esp32s3"] and (IDF_VERSION_MAJOR == 5 and IDF_VERSION_MINOR == 1)

examples/display/lcd/lcd_layer_blending/.gitignore

@@ -0,0 +1,3 @@
+**/squareline/backup/**
+**/squareline/autosave/**
+components/lvgl/**

examples/display/lcd/lcd_layer_blending/CMakeLists.txt

@@ -0,0 +1,9 @@
+# The following lines of boilerplate have to be in your project's
+# CMakeLists in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.5)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+
+add_compile_options(-Wno-attributes
+                    -Wno-format)
+project(lcd_layer_blending)

examples/display/lcd/lcd_layer_blending/README.md

@@ -0,0 +1,63 @@
+| Supported Targets | ESP32-P4 |
+| ----------------- | -------- |
+
+| Supported LCD Controller    | EK79007 |
+| ----------------------------|---------|
+
+| Supported Touch Controller  |  GT911 |
+| ----------------------------| -------|
+
+# LCD Layer Blending Example
+
+[esp_lcd](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/lcd.html) provides several panel drivers out-of box, e.g. ST7789, SSD1306, NT35510. However, there're a lot of other panels on the market, it's beyond `esp_lcd` component's responsibility to include them all.
+
+`esp_lcd` allows user to add their own panel drivers in the project scope (i.e. panel driver can live outside of esp-idf), so that the upper layer code like LVGL porting code can be reused without any modifications, as long as user-implemented panel driver follows the interface defined in the `esp_lcd` component.
+
+This example demonstrates how to use LVGL v9 based on PPA to implement layer blending (e.g., integration with camera data streams) and color format switching.
+
+This example uses the [esp_timer](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/system/esp_timer.html) to generate the ticks needed by LVGL and uses a dedicated task to run the `lv_timer_handler()`. Since the LVGL APIs are not thread-safe, this example uses a mutex which be invoked before the call of `lv_timer_handler()` and released after it. The same mutex needs to be used in other tasks and threads around every LVGL (lv_...) related function call and code. For more porting guides, please refer to [LVGL porting doc](https://docs.lvgl.io/master/porting/index.html).
+
+## How to use the example
+
+## ESP-IDF Required
+
+### Hardware Required
+
+* An ESP32-P4-Function-EV-Board.
+* A 7-inch 1024 x 600 LCD screen powered by the [EK79007](https://docs.espressif.com/projects/esp-dev-kits/en/latest/_static/esp32-p4-function-ev-board/camera_display_datasheet/display_driver_chip_EK79007AD_datasheet.pdf) IC, accompanied by a 32-pin FPC connection [adapter board](https://docs.espressif.com/projects/esp-dev-kits/en/latest/_static/esp32-p4-function-ev-board/schematics/esp32-p4-function-ev-board-lcd-subboard-schematics.pdf) ([LCD Specifications](https://docs.espressif.com/projects/esp-dev-kits/en/latest/_static/esp32-p4-function-ev-board/camera_display_datasheet/display_datasheet.pdf)).
+* A MIPI-CSI camera powered by the SC2336 IC, accompanied by a 32-pin FPC connection [adapter board](https://docs.espressif.com/projects/esp-dev-kits/en/latest/_static/esp32-p4-function-ev-board/schematics/esp32-p4-function-ev-board-camera-subboard-schematics.pdf) ([Camera Specifications](https://docs.espressif.com/projects/esp-dev-kits/en/latest/_static/esp32-p4-function-ev-board/camera_display_datasheet/camera_datasheet.pdf)).
+* A USB-C cable for power supply and programming.
+* Please refer to the following steps for the connection:
+    * **Step 1**. According to the table below, connect the pins on the back of the screen adapter board to the corresponding pins on the development board.
+
+        | Screen Adapter Board | ESP32-P4-Function-EV-Board |
+        | -------------------- | -------------------------- |
+        | 5V (any one)         | 5V (any one)               |
+        | GND (any one)        | GND (any one)              |
+        | PWM                  | GPIO26                     |
+        | LCD_RST              | GPIO27                     |
+
+    * **Step 2**. Connect the FPC of LCD through the `MIPI_DSI` interface.
+    * **Step 3**. Connect the FPC of Camera through the `MIPI_CSI` interface.
+    * **Step 4**. Use a USB-C cable to connect the `USB-UART` port to a PC (Used for power supply and viewing serial output).
+    * **Step 5**. Turn on the power switch of the board.
+
+### Configure the Project
+
+Run `idf.py menuconfig` and navigate to `Example Configuration` menu.
+
+### Build and Flash
+
+Run `idf.py set-target esp32p4` to select the target chip.
+
+Run `idf.py -p PORT build flash monitor` to build, flash and monitor the project. A fancy animation will show up on the LCD as expected.
+
+The first time you run `idf.py` for the example will cost extra time as the build system needs to address the component dependencies and downloads the missing components from registry into `managed_components` folder.
+
+(To exit the serial monitor, type ``Ctrl-]``.)
+
+See the [Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html) for full steps to configure and use ESP-IDF to build projects.
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-iot-solution/issues) on GitHub. We will get back to you soon.

examples/display/lcd/lcd_layer_blending/main/CMakeLists.txt

@@ -0,0 +1,22 @@
+set(LV_UI_DIR ui)
+file(GLOB_RECURSE LV_UI_SOURCES ${LV_UI_DIR}/*.c)
+set(CORE_DIR core)
+file(GLOB_RECURSE CORE_SOURCES ${CORE_DIR}/*.c)
+
+set(INCLUDE_DIRS "")
+list(APPEND INCLUDE_DIRS "include")
+
+idf_component_get_property(LVGL_LIB lvgl__lvgl COMPONENT_LIB)
+
+idf_component_register(
+    SRCS main.c app_lcd.c app_video.c camera_ppa_blend.c ${LV_UI_SOURCES} ${CORE_SOURCES}
+    INCLUDE_DIRS . ${LV_UI_DIR} ${INCLUDE_DIRS} ${CORE_DIR}
+)
+
+target_compile_options(
+    ${LVGL_LIB}
+    PRIVATE
+        -DLV_LVGL_H_INCLUDE_SIMPLE
+        -DLV_USE_DEMO_MUSIC
+        -Wno-missing-field-initializers
+)

examples/display/lcd/lcd_layer_blending/main/Kconfig.projbuild

@@ -0,0 +1,63 @@
+menu "Example Configuration"
+    menu "Camera Configuration"
+        config EXAMPLE_ENABLE_MIPI_CSI_CAM_SENSOR
+            bool "Enable MIPI CSI Camera Sensor"
+            default y
+            depends on SOC_MIPI_CSI_SUPPORTED
+
+        if EXAMPLE_ENABLE_MIPI_CSI_CAM_SENSOR
+            config EXAMPLE_MIPI_CSI_SCCB_I2C_PORT
+                int "MIPI CSI SCCB I2C Port Number"
+                default 0
+                range 0 1
+
+            config EXAMPLE_MIPI_CSI_SCCB_I2C_SCL_PIN
+                int "MIPI CSI SCCB I2C SCL Pin"
+                default 34
+                range -1 56
+
+            config EXAMPLE_MIPI_CSI_SCCB_I2C_SDA_PIN
+                int "MIPI CSI SCCB I2C SDA Pin"
+                default 31
+                range -1 56
+
+            config EXAMPLE_MIPI_CSI_SCCB_I2C_FREQ
+                int "MIPI CSI SCCB I2C Frequency"
+                default 100000
+                range 100000 400000
+                help
+                    Increasing this value can reduce the initialization time of the camera sensor.
+                    Please refer to the relevant instructions of the camera sensor to adjust the value.
+
+            config EXAMPLE_MIPI_CSI_CAM_SENSOR_RESET_PIN
+                int "MIPI CSI Camera Sensor Reset Pin"
+                default -1
+                range -1 56
+
+            config EXAMPLE_MIPI_CSI_CAM_SENSOR_PWDN_PIN
+                int "MIPI CSI Camera Sensor Power Down Pin"
+                default -1
+                range -1 56
+        endif
+
+        config EXAMPLE_CAM_BUF_COUNT
+            int "Camera Buffer Count"
+            default 2
+            range 2 3
+    endmenu
+    menu "LCD Configuration"
+        choice
+            prompt "Choose the color format of the LCD"
+            default LCD_PIXEL_FORMAT_RGB565
+                config LCD_PIXEL_FORMAT_RGB565
+                    bool "RGB565"
+
+                config LCD_PIXEL_FORMAT_RGB888
+                    bool "RGB888"
+        endchoice
+
+        config EXAMPLE_LCD_PPA_BLEND_AVOID_TEAR
+            bool "Enable LCD avoid tear feat"
+            default y
+    endmenu
+endmenu