feat(examples): update service_console

Author: Lzw655

.build-rules.yml

@@ -31,83 +31,73 @@ products/speaker:
 
 #
 # Test Apps
+# Common enable condition: IDF_TARGET in ["esp32s3", "esp32p4"]
 #
+# Define common enable condition as anchor
+_general_test_apps_enable: &general_test_apps_enable
+  enable:
+    - if: IDF_TARGET in ["esp32s3", "esp32p4", "esp32c5"]
+
 # brookesia_lib_utils: check
 utils/brookesia_lib_utils/test_apps/check:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_lib_utils: function_guard
 utils/brookesia_lib_utils/test_apps/function_guard:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_lib_utils: describe_helpers
 utils/brookesia_lib_utils/test_apps/describe_helpers:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_lib_utils: log
 utils/brookesia_lib_utils/test_apps/log:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_lib_utils: memory_profiler
 utils/brookesia_lib_utils/test_apps/memory_profiler:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_lib_utils: plugin
 utils/brookesia_lib_utils/test_apps/plugin:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_lib_utils: state_machine
 utils/brookesia_lib_utils/test_apps/state_machine:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_lib_utils: task_scheduler
 utils/brookesia_lib_utils/test_apps/task_scheduler:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_lib_utils: thread_config
 utils/brookesia_lib_utils/test_apps/thread_config:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_lib_utils: thread_profiler
 utils/brookesia_lib_utils/test_apps/thread_profiler:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_lib_utils: time_profiler
 utils/brookesia_lib_utils/test_apps/time_profiler:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_service_manager
 service/brookesia_service_manager/test_apps:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_service_nvs
 service/brookesia_service_nvs/test_apps:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_service_sntp
 service/brookesia_service_sntp/test_apps:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # brookesia_service_wifi
 service/brookesia_service_wifi/test_apps:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable
 
 # Examples
 examples/service_console:
-  enable:
-    - if: IDF_TARGET in ["esp32s3", "esp32p4"]
+  <<: *general_test_apps_enable

.github/workflows/launchpad.yml

@@ -89,6 +89,7 @@ jobs:
           - esp_box_3
           - esp32_p4_function_ev
           - esp32_s3_korvo2_v3
+          - esp_sensair_shuttle
     steps:
       - uses: actions/checkout@v3
         with:

.gitlab/ci/build.yml

@@ -11,6 +11,38 @@
     WARNING_STR: ""
 
 .build_examples_template: &build_examples_template
+  <<: *build_template
+  artifacts:
+    when: always
+    paths:
+      - "**/build*/size.json"
+      - "**/build*/build_log.txt"
+      - "**/build*/*.bin"
+      - "**/build*/*.map"
+      - "**/build*/*.elf"
+      - "**/build*/flasher_args.json"
+      - "**/build*/flash_args"
+      - "**/build*/flash_project_args"
+      - "**/build*/config/sdkconfig.json"
+      - "**/build*/bootloader/*.bin"
+      - "**/build*/bootloader/*.elf"
+      - "**/build*/partition_table/*.bin"
+      - "**/build*/mmap_build/*.bin"
+      - "**/build*/**/*.bin"
+      - size_info.txt
+    expire_in: 1 week
+  variables:
+    IDF_CI_BUILD: "1"
+    # By configuring this macro, you can append the compiled configuration file.
+    # For example, using "sdkconf.etc=default" specifies the default sdkconfig file.
+    EXAMPLE_CONFIG: "sdkconfig.defaults=defaults;sdkconfig.ci.*=;=defaults"
+    EXAMPLE_TARGET: "all"
+  script:
+    - pip install "idf-component-manager"
+    - pip install idf_build_apps
+    - python .gitlab/tools/build_apps.py ${EXAMPLE_DIR} --config ${EXAMPLE_CONFIG} -t ${EXAMPLE_TARGET} -vv
+
+.build_examples_template_without_large_artifacts: &build_examples_template_without_large_artifacts
   <<: *build_template
   artifacts:
     when: always
@@ -192,7 +224,7 @@ build_test_apps_brookesia_service_wifi:
 # service_console
 build_examples_service_console:
   extends:
-    - .build_examples_template
+    - .build_examples_template_without_large_artifacts
     - .rules:build:examples_service_console
 # Using `-t all` directly will cause configuration failures for S3-related boards, so it is necessary to build them separately
   parallel:
@@ -203,6 +235,9 @@ build_examples_service_console:
       - IMAGE: espressif/idf:release-v5.5
         EXAMPLE_TARGET: "esp32p4"
         EXAMPLE_CONFIG: "sdkconfig.defaults=defaults;sdkconfig.ci.board.*=;=defaults"
+      - IMAGE: espressif/idf:release-v5.5
+        EXAMPLE_TARGET: "esp32c5"
+        EXAMPLE_CONFIG: "sdkconfig.defaults=defaults;sdkconfig.ci.board.*=;=defaults"
   variables:
     EXAMPLE_DIR: examples/service_console
 

.gitlab/ci/rules.yml

@@ -51,6 +51,13 @@
   - "agent/brookesia_agent_coze/CMakeLists.txt"
   - "agent/brookesia_agent_coze/idf_component.yml"
   - "agent/brookesia_agent_coze/Kconfig"
+# brookesia_agent_helper
+.patterns-component_brookesia_agent_helper: &patterns-component_brookesia_agent_helper
+  - "agent/brookesia_agent_helper/include/**/*"
+  - "agent/brookesia_agent_helper/src/**/*"
+  - "agent/brookesia_agent_helper/CMakeLists.txt"
+  - "agent/brookesia_agent_helper/idf_component.yml"
+  - "agent/brookesia_agent_helper/Kconfig"
 # brookesia_agent_manager
 .patterns-component_brookesia_agent_manager: &patterns-component_brookesia_agent_manager
   - "agent/brookesia_agent_manager/include/**/*"
@@ -65,6 +72,23 @@
   - "agent/brookesia_agent_openai/CMakeLists.txt"
   - "agent/brookesia_agent_openai/idf_component.yml"
   - "agent/brookesia_agent_openai/Kconfig"
+# brookesia_agent_xiaozhi
+.patterns-component_brookesia_agent_xiaozhi: &patterns-component_brookesia_agent_xiaozhi
+  - "agent/brookesia_agent_xiaozhi/include/**/*"
+  - "agent/brookesia_agent_xiaozhi/src/**/*"
+  - "agent/brookesia_agent_xiaozhi/CMakeLists.txt"
+  - "agent/brookesia_agent_xiaozhi/idf_component.yml"
+  - "agent/brookesia_agent_xiaozhi/Kconfig"
+#
+# Expression
+#
+# brookesia_expression_emote
+.patterns-component_brookesia_expression_emote: &patterns-component_brookesia_expression_emote
+  - "expression/brookesia_expression_emote/include/**/*"
+  - "expression/brookesia_expression_emote/src/**/*"
+  - "expression/brookesia_expression_emote/CMakeLists.txt"
+  - "expression/brookesia_expression_emote/idf_component.yml"
+  - "expression/brookesia_expression_emote/Kconfig"
 #
 # Service
 #
@@ -78,8 +102,10 @@
 # brookesia_service_helper
 .patterns-component_brookesia_service_helper: &patterns-component_brookesia_service_helper
   - "service/brookesia_service_helper/include/**/*"
+  - "service/brookesia_service_helper/src/**/*"
   - "service/brookesia_service_helper/CMakeLists.txt"
   - "service/brookesia_service_helper/idf_component.yml"
+  - "service/brookesia_service_helper/Kconfig"
 # brookesia_service_manager
 .patterns-component_brookesia_service_manager: &patterns-component_brookesia_service_manager
   - "service/brookesia_service_manager/include/**/*"
@@ -447,14 +473,18 @@
     - <<: *if-trigger-job
     - <<: *if-dev-push
       changes: *patterns-build_system
-    - <<: *if-dev-push
-      changes: *patterns-examples_service_console
     - <<: *if-dev-push
       changes: *patterns-component_brookesia_agent_coze
     - <<: *if-dev-push
       changes: *patterns-component_brookesia_agent_manager
+    - <<: *if-dev-push
+      changes: *patterns-component_brookesia_agent_helper
     - <<: *if-dev-push
       changes: *patterns-component_brookesia_agent_openai
+    - <<: *if-dev-push
+      changes: *patterns-component_brookesia_agent_xiaozhi
+    - <<: *if-dev-push
+      changes: *patterns-component_brookesia_expression_emote
     - <<: *if-dev-push
       changes: *patterns-component_brookesia_service_audio
     - <<: *if-dev-push
@@ -469,6 +499,8 @@
       changes: *patterns-component_brookesia_service_wifi
     - <<: *if-dev-push
       changes: *patterns-component_brookesia_lib_utils
+    - <<: *if-dev-push
+      changes: *patterns-examples_service_console
 
 # rules for products
 .rules:build:products_phone_m5stack_core_s3:

.gitlab/ci/target_test.yml

@@ -46,14 +46,6 @@ variables:
     IDF_VERSION: "5.5"
     ENV_TAG: "generic,eco4"
 
-.idf_target_version_matrix_p4_eco4_function_ev_board: &idf_target_version_matrix_p4_eco4_function_ev_board
-  - IDF_TARGET: esp32s3
-    IDF_VERSION: "5.5"
-    ENV_TAG: "generic"
-  - IDF_TARGET: esp32p4
-    IDF_VERSION: "5.5"
-    ENV_TAG: "generic,eco4,esp32p4_function_ev_board"
-
 #
 # Test apps: brookesia_lib_utils
 #
@@ -319,7 +311,16 @@ components_test_brookesia_service_wifi:
       artifacts: true
       optional: true
   parallel:
-    matrix: *idf_target_version_matrix_p4_eco4_function_ev_board
+    matrix:
+      - IDF_TARGET: esp32s3
+        IDF_VERSION: "5.5"
+        ENV_TAG: "generic"
+      - IDF_TARGET: esp32s3
+        IDF_VERSION: "5.5"
+        ENV_TAG: "generic,octal-psram"
+      - IDF_TARGET: esp32p4
+        IDF_VERSION: "5.5"
+        ENV_TAG: "generic,eco4,esp32p4_function_ev_board"
   tags:
     - ${IDF_TARGET}
     - ${ENV_TAG}
@@ -341,7 +342,13 @@ examples_test_service_console:
       artifacts: true
       optional: true
   parallel:
-    matrix: *idf_target_version_matrix_p4_eco4_function_ev_board
+    matrix:
+      - IDF_TARGET: esp32s3
+        IDF_VERSION: "5.5"
+        ENV_TAG: "generic"
+      - IDF_TARGET: esp32p4
+        IDF_VERSION: "5.5"
+        ENV_TAG: "generic,eco4,esp32p4_function_ev_board"
   tags:
     - ${IDF_TARGET}
     - ${ENV_TAG}

examples/service_console/README.md

@@ -1,6 +1,6 @@
-| Supported Chips | ESP32-S3 | ESP32-P4 |
-| :-------------: | :------: | :------: |
-|                 |    ✅    |    ✅    |
+| Supported Chips | ESP32-S3 | ESP32-P4 | ESP32-C5 |
+| :-------------: | :------: | :------: | :------: |
+|                 |    ✅    |    ✅    |    ✅    |
 
 # Service Console Example
 
@@ -45,7 +45,7 @@ This example demonstrates how to run and test ESP-Brookesia service framework fe
 
 ### Hardware Requirements
 
-**Basic Features**: Development boards with `ESP32-S3` or `ESP32-P4` chip and `Flash >= 8MB`
+**Basic Features**: Development boards with `ESP32-S3`, `ESP32-P4` or `ESP32-C5` chip and `Flash >= 8MB`
 
 **Full Features** (Audio, Emote, Agent): Requires `esp_board_manager` component, supporting the following boards:
 
@@ -55,6 +55,7 @@ This example demonstrates how to run and test ESP-Brookesia service framework fe
 | ESP32-S3-BOX-3 | [GitHub](https://github.com/espressif/esp-box) |
 | ESP32-S3-Korvo-2 | [Documentation](https://docs.espressif.com/projects/esp-adf/en/latest/design-guide/dev-boards/user-guide-esp32-s3-korvo-2.html) |
 | ESP32-P4-Function-EV-Board | [Documentation](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32p4/esp32-p4-function-ev-board/index.html) |
+| ESP32-C5-Sensair-Shuttle | [Documentation](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32c5/esp-sensairshuttle/index.html) |
 
 ### Development Environment
 
@@ -95,6 +96,7 @@ Available `<board>` values:
 - `esp_box_3`
 - `esp32_p4_function_ev`
 - `esp32_s3_korvo2_v3`
+- `esp_sensair_shuttle`
 
 For other boards:
 

examples/service_console/README_CN.md

@@ -1,6 +1,6 @@
-| 支持的芯片 | ESP32-S3 | ESP32-P4 |
-| :--------: | :------: | :------: |
-|            |    ✅    |    ✅    |
+| 支持的芯片 | ESP32-S3 | ESP32-P4 | ESP32-C5 |
+| :--------: | :------: | :------: | :------: |
+|            |    ✅     |    ✅     |    ✅     |
 
 # 服务控制台示例
 
@@ -45,7 +45,7 @@
 
 ### 硬件要求
 
-**基础功能**：搭载 `ESP32-S3` 或 `ESP32-P4` 芯片且 `Flash >= 8MB` 的开发板
+**基础功能**：搭载 `ESP32-S3`、`ESP32-P4` 或 `ESP32-C5` 芯片且 `Flash >= 8MB` 的开发板
 
 **完整功能**（Audio、Emote、Agent）：需配合 `esp_board_manager` 组件，支持以下开发板：
 
@@ -55,6 +55,7 @@
 | ESP32-S3-BOX-3 | [GitHub](https://github.com/espressif/esp-box) |
 | ESP32-S3-Korvo-2 | [文档](https://docs.espressif.com/projects/esp-adf/zh_CN/latest/design-guide/dev-boards/user-guide-esp32-s3-korvo-2.html) |
 | ESP32-P4-Function-EV-Board | [文档](https://docs.espressif.com/projects/esp-dev-kits/zh_CN/latest/esp32p4/esp32-p4-function-ev-board/index.html) |
+| ESP32-C5-Sensair-Shuttle | [文档](https://docs.espressif.com/projects/esp-dev-kits/zh_CN/latest/esp32c5/esp-sensairshuttle/index.html) |
 
 ### 开发环境
 
@@ -95,6 +96,7 @@ idf.py gen-bmgr-config -b <board> -c ./boards
 - `esp_box_3`
 - `esp32_p4_function_ev`
 - `esp32_s3_korvo2_v3`
+- `esp_sensair_shuttle`
 
 使用其他开发板：
 

examples/service_console/boards/esp32_s3_korvo2_v3/board_peripherals.yaml

@@ -68,7 +68,7 @@ peripherals:
         spi_port: SPI2_HOST              # 0: SPI1_HOST, 1: SPI2_HOST, 2: SPI3_HOST
         mosi_io_num: 0                   # MOSI_IO_NUM
         sclk_io_num: 1                   # SPI Clock signal
-        max_transfer_sz: 6400            # Maximum transfer size in bytes : width * 2 * 10
+        max_transfer_sz: 5680            # Maximum transfer size in bytes : width * 2 * 10
 
   # ADC for Button
   - name: adc_oneshot

examples/service_console/boards/esp_sensair_shuttle/Kconfig

@@ -0,0 +1,2 @@
+config BOARD_ESP_SENSAIR_SHUTTLE
+    bool