feat(examples): update

Author: Lzw655

.build-rules.yml

@@ -69,6 +69,6 @@ test_apps/drivers/touch/spi:
     - if: SOC_GPSPI_SUPPORTED != 1
 
 # Examples
-test_apps/gui/lvgl_port_v8:
+test_apps/gui/lvgl_v8_port:
   enable:
     - if: INCLUDE_DEFAULT == 1

.gitlab/ci/build.yml

@@ -165,10 +165,10 @@ build_test_apps_board_waveshare:
     EXAMPLE_DIR: test_apps/board/waveshare
 
 # Test apps examples
-build_test_apps_gui_lvgl_port_v8:
+build_test_apps_gui_lvgl_v8_port:
   extends:
     - .build_examples_template
     - .build_general_idf_release_image
-    - .rules:build:test_apps_gui_lvgl_port_v8
+    - .rules:build:test_apps_gui_lvgl_v8_port
   variables:
-    EXAMPLE_DIR: test_apps/gui/lvgl_port_v8
+    EXAMPLE_DIR: test_apps/gui/lvgl_v8_port

.gitlab/ci/rules.yml

@@ -312,9 +312,9 @@
   - "test_apps/board/waveshare/**/*"
 
 # test_apps gui files
-.patterns-test_apps_gui_lvgl_port_v8: &patterns-test_apps_gui_lvgl_port_v8
+.patterns-test_apps_gui_lvgl_v8_port: &patterns-test_apps_gui_lvgl_v8_port
   - .patterns-test_apps_board_general
-  - "test_apps/gui/lvgl_port_v8/**/*"
+  - "test_apps/gui/lvgl_v8_port/**/*"
 
 ##############
 # if anchors #
@@ -540,8 +540,8 @@
     - <<: *if-dev-push
       changes: *patterns-test_apps_board_waveshare
 
-# rules for test_apps examples-lvgl_port_v8
-.rules:build:test_apps_gui_lvgl_port_v8:
+# rules for test_apps examples-lvgl_v8_port
+.rules:build:test_apps_gui_lvgl_v8_port:
   rules:
     - <<: *if-protected
     - <<: *if-label-build
@@ -552,4 +552,4 @@
     - <<: *if-dev-push
       changes: *patterns-component_board_general
     - <<: *if-dev-push
-      changes: *patterns-test_apps_gui_lvgl_port_v8
+      changes: *patterns-test_apps_gui_lvgl_v8_port

.pre-commit-config.yaml

@@ -1,7 +1,7 @@
 # See https://pre-commit.com for more information
 # See https://pre-commit.com/hooks.html for more hooks
 
-exclude: 'libraries/ui/'
+exclude: '(libraries/ui/|lv_conf.h)'
 repos:
   - repo: https://github.com/igrr/astyle_py.git
     rev: v1.0.5
@@ -87,25 +87,21 @@ repos:
         language: python
         pass_filenames: false
         always_run: true
-
-  - repo: local
-    hooks:
       - id: sync-conf-files
         name: Update when configuration files change
-        entry: python3 tools/sync_conf_files.py ./
+        entry: python3 tools/sync_conf_files.py ./ ./
         language: system
         files: '.*esp_panel_(board_custom|board_supported|drivers)_conf\.h'
-
-  - repo: local
-    hooks:
+      - id: sync-template-files
+        name: Update when template files change
+        entry: python3 tools/sync_conf_files.py ./template_files ./
+        language: system
+        files: '(.*esp_utils_conf\.h|.*lv_conf\.h|.*lvgl_v8_port\.cpp|.*lvgl_v8_port\.h)'
       - id: check-file-versions
         name: Update when versions change
         entry: python3 tools/check_file_version.py ./
         language: system
         files: '(.*esp_panel_(board_custom|board_supported|drivers)_conf\.h|library.properties|.*esp_panel_versions.h)'
-
-  - repo: local
-    hooks:
       - id: check-library-versions
         name: Check library versions
         entry: ./.github/scripts/check_lib_versions.sh

CHANGELOG.md

@@ -51,7 +51,7 @@
 * feat(board): add support for Waveshare ESP32-S3-Touch-LCD-2.1 @martinroger (#117)
 * feat(board): add support for Espressif ESP32-P4-Function-EV-Board
 * feat(examples): add MIPI-DSI LCD
-* feat(examples): optimize anti-tear rotation in lvgl_port_v8
+* feat(examples): optimize anti-tear rotation in lvgl_v8_port
 * feat(ci): update for MIPI-DSI LCD
 * feat(test_apps): add MIPI-DSI LCD
 

check_copyright_config.yaml

@@ -31,12 +31,14 @@ examples_and_unit_tests:
   include:
   - 'test_apps/'
   - 'examples/'
+  - 'template_files/'
   allowed_licenses:
   - Apache-2.0
   - Unlicense
   - CC0-1.0
   license_for_new_files: CC0-1.0
 
-# ignore:  # You can also select ignoring files here
-#   perform_check: no  # Don't check files from that block
-#   include:
+ignore:  # You can also select ignoring files here
+  perform_check: no  # Don't check files from that block
+  include:
+  - 'examples/platformio/lvgl_v8_port/src/lv_conf.h'

docs/FAQ.md

@@ -48,7 +48,7 @@ When encountering screen drift issue when driving RGB LCD with ESP32-S3, you can
 
    - **Step 4**: If you are using an independent driver, refer to the example code below to set the size of the `Bounce Buffer`.
 
-   - **Step 5**: If you are developing an LVGL application, assign the task that initializes the RGB peripheral and the task that runs the LVGL `lv_timer_handler()` on the same core. Please refer to [the code](../examples/LVGL/v8/Porting/lvgl_port_v8.h#L53).
+   - **Step 5**: If you are developing an LVGL application, assign the task that initializes the RGB peripheral and the task that runs the LVGL `lv_timer_handler()` on the same core. Please refer to [the code](../examples/LVGL/v8/Porting/lvgl_v8_port.h#L53).
 
 3. **Example Code**: The following example code demonstrates how to modify the size of the `Bounce Buffer` using `ESP_Panel` driver or independent driver:
 

docs/FAQ_CN.md

@@ -47,7 +47,7 @@ arduino-esp32 v3.x.x 版本的 SDK 位于默认安装路径下的 `tools > esp32
 
    - **Step4**：如果您使用的是独立的驱动，请参考下面的示例代码来设置 `Bounce Buffer` 的大小。
 
-   - **Step5**：如果您正在开发 LVGL 应用，将执行 RGB 外设初始化的任务与执行 LVGL lv_timer_handler() 的任务分配在同一个核上，请参考 [代码](../examples/LVGL/v8/Porting/lvgl_port_v8.h#L53)。
+   - **Step5**：如果您正在开发 LVGL 应用，将执行 RGB 外设初始化的任务与执行 LVGL lv_timer_handler() 的任务分配在同一个核上，请参考 [代码](../examples/LVGL/v8/Porting/lvgl_v8_port.h#L53)。
 
 3. **示例代码**：以下示例代码展示了如何通过 `ESP_Panel` 驱动或独立的驱动来修改 `Bounce Buffer` 的大小：
 

esp_panel_board_custom_conf.h

@@ -283,10 +283,8 @@
  * will use the default initialization sequence code.
  *
  * The initialization sequence can be specified in two formats:
- *
  * 1. Raw format:
  *    {command, (uint8_t []){data0, data1, ...}, data_size, delay_ms}
- *
  * 2. Helper macros:
  *    - ESP_PANEL_LCD_CMD_WITH_8BIT_PARAM(delay_ms, command, {data0, data1, ...})
  *    - ESP_PANEL_LCD_CMD_WITH_NONE_PARAM(delay_ms, command)

examples/arduino/board/use_default_config/esp_panel_board_custom_conf.h

@@ -283,10 +283,8 @@
  * will use the default initialization sequence code.
  *
  * The initialization sequence can be specified in two formats:
- *
  * 1. Raw format:
  *    {command, (uint8_t []){data0, data1, ...}, data_size, delay_ms}
- *
  * 2. Helper macros:
  *    - ESP_PANEL_LCD_CMD_WITH_8BIT_PARAM(delay_ms, command, {data0, data1, ...})
  *    - ESP_PANEL_LCD_CMD_WITH_NONE_PARAM(delay_ms, command)