Share AMOLED brightness control and optional Brookesia integration

.github/workflows/ci.yml

@@ -60,7 +60,7 @@ jobs:
         run: compote component pack --name waveshare_boards
 
   build:
-    name: ${{ matrix.board }} / ${{ matrix.idf }} / BMGR ${{ matrix.bmgr }}
+    name: ${{ matrix.board }} / ${{ matrix.idf }} / BMGR ${{ matrix.bmgr }} / ${{ matrix.integration }}
     needs: validate
     if: needs.validate.outputs.has_builds == 'true'
     runs-on: ubuntu-latest
@@ -82,6 +82,7 @@ jobs:
             set -eu
             python -m pip install '${{ matrix.component_manager }}' '${{ matrix.bmgr_assist }}'
             python ../scripts/board_pack.py pin '${{ matrix.bmgr }}'
+            python ../scripts/board_pack.py integration '${{ matrix.integration }}'
             idf.py bmgr -l
             idf.py bmgr -b '${{ matrix.board }}'
             idf.py build

CMakeLists.txt

@@ -1 +1 @@
-idf_component_register()
+idf_component_register(INCLUDE_DIRS "include" REQUIRES esp_lcd)

README.md

@@ -85,6 +85,8 @@ or a passing packaging check does not by itself mean that version is published.
 
 ```text
 boards/<full_model>/   Board metadata, peripherals, devices, and setup code
+include/               Framework-independent AMOLED brightness helper
+integrations/          Optional framework adapters, shared across boards
 idf_component.yml      Component metadata and managed dependencies
 CMakeLists.txt         Board-pack component registration
 ci/test_app/           Board Manager integration compile test
@@ -114,6 +116,7 @@ unique `board` value. The catalog is regenerated from the definitions.
 ## 📚 Documentation
 
 - [Board organization, hardware revisions, and migration](docs/BOARDS.md)
+- [AMOLED brightness and optional Brookesia integration](docs/INTEGRATIONS.md)
 - [CI coverage and local validation](docs/CI.md)
 - [Registry credentials and publication](docs/PUBLISHING.md)
 - [Contributing](CONTRIBUTING.md)

README_ZH.md

@@ -78,6 +78,8 @@ idf.py bmgr -l
 
 ```text
 boards/<完整型号>/      板卡信息、外设、设备与初始化代码
+include/               不依赖应用框架的 AMOLED 调光函数
+integrations/          跨板卡共用的可选框架适配
 idf_component.yml      组件元数据与托管依赖
 CMakeLists.txt         板卡包组件注册
 ci/test_app/           Board Manager 集成编译测试
@@ -105,6 +107,7 @@ python -m unittest discover -s ci/scripts -p 'test_*.py' -v
 ## 📚 文档
 
 - [板卡组织、硬件版本与迁移说明](docs/BOARDS_ZH.md)
+- [AMOLED 调光与可选 Brookesia 集成](docs/INTEGRATIONS_ZH.md)
 - [CI 覆盖范围与本地验证](docs/CI_ZH.md)
 - [组件库凭据与发布](docs/PUBLISHING_ZH.md)
 - [贡献指南](CONTRIBUTING_ZH.md)

boards/esp32_s3_touch_amoled_1_75c/board_devices.yaml

@@ -64,8 +64,6 @@ devices:
     version: default
     dependencies:
       espressif/esp_lcd_co5300: "^2"
-      brookesia_hal_custom:
-        override_path: "${BOARD_PATH}/components/brookesia_hal_custom"
     config:
       x_max: 466
       y_max: 466

boards/esp32_s3_touch_amoled_1_8/board_devices.yaml

@@ -6,8 +6,6 @@ devices:
     version: default
     dependencies:
       espressif/esp_io_expander_tca9554: "^2"
-      brookesia_hal_custom:
-        override_path: "${BOARD_PATH}/components/brookesia_hal_custom"
     config:
       max_pins: 8                      # Maximum number of GPIO pins supported
       output_io_mask: [0, 1, 2, 7]        # List of pins configured as output