Merge branch 'feat/add_bthome_components_and_example' into 'master'

feat(ble): add bthome components and example

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

Author: loop233

.gitignore

@@ -84,6 +84,9 @@ test_multi_heap_host
 # VS Code Settings
 .vscode/
 
+# Cursor Settings
+.cursor/
+
 # VIM files
 *.swp
 *.swo

.gitlab/ci/build.yml

@@ -1066,12 +1066,18 @@ build_components_bluetooth_ble_hci_test_apps:
   extends:
     - .build_examples_template
     - .rules:build:components_bluetooth_ble_hci_test_apps
-  parallel:
-    matrix:
-      - IMAGE: espressif/idf:release-v5.2
+    - .build_idf_version_greater_equal_v5_0
   variables:
     EXAMPLE_DIR: components/bluetooth/ble_hci/test_apps
 
+build_components_bluetooth_ble_adv_bthome_test_apps:
+  extends:
+    - .build_examples_template
+    - .rules:build:components_bluetooth_ble_adv_bthome_test_apps
+    - .build_idf_version_greater_equal_v5_0
+  variables:
+    EXAMPLE_DIR: components/bluetooth/ble_adv/bthome/test_apps
+
 build_components_button_test_apps:
   extends:
     - .build_examples_template

.gitlab/ci/rules.yml

@@ -52,6 +52,10 @@
   - "components/bluetooth/ble_hci/**/*"
   - "tools/cmake_utilities/package_manager.cmake"
 
+.patterns-components_bluetooth_ble_adv_bthome: &patterns-components_bluetooth_ble_adv_bthome
+  - "components/bluetooth/ble_adv/bthome/**/*"
+  - "tools/cmake_utilities/package_manager.cmake"
+
 .patterns-components_bootloader_support_plus: &patterns-components_bootloader_support_plus
   - "components/bootloader_support_plus/**/*"
   - "components/utilities/xz/**/*"
@@ -1867,6 +1871,17 @@
     - <<: *if-dev-push
       changes: *patterns-components_bluetooth_ble_hci
 
+.rules:build:components_bluetooth_ble_adv_bthome_test_apps:
+  rules:
+    - <<: *if-protected
+    - <<: *if-label-build
+    - <<: *if-label-target_test
+    - <<: *if-trigger-job
+    - <<: *if-dev-push
+      changes: *patterns-build_system
+    - <<: *if-dev-push
+      changes: *patterns-components_bluetooth_ble_adv_bthome
+
 .rules:build:component_bus_test:
   rules:
     - <<: *if-protected

components/.build-rules.yml

@@ -231,4 +231,8 @@ components/sensors/power_monitor/ina236/test_apps:
 
 components/bluetooth/ble_hci/test_apps:
   enable:
-    - if: IDF_TARGET in ["esp32","esp32c3","esp32s3"]
+    - if: IDF_TARGET in ["esp32","esp32c3","esp32s3"] and IDF_VERSION_MAJOR >= 5
+
+components/bluetooth/ble_adv/bthome/test_apps:
+  enable:
+    - if: IDF_TARGET in ["esp32","esp32c3","esp32h2","esp32s3","esp32c2","esp32c6"] and IDF_VERSION_MAJOR >= 5

components/bluetooth/ble_adv/bthome/CHANGELOG.md

@@ -0,0 +1,35 @@
+# ChangeLog
+
+## v0.1.0 - 2025/04/29
+
+This is the first version for BTHome component in Espressif Component Registry.
+
+Features:
+- Support BTHome V2 protocol
+- Support encrypted and non-encrypted modes
+- Support the following features:
+  - Sensor data reporting
+  - Binary sensor data reporting
+  - Event data reporting
+  - Button event handling
+  - Dimmer event handling
+- Support NVS storage configuration
+- Support custom callbacks
+- Provide example code:
+  - Bulb example
+  - Dimmer example
+
+Bug Fixes:
+- Fixed memory leak issues
+- Fixed bugs in encryption/decryption process
+- Fixed logical errors in event handling
+
+Optimizations:
+- Optimized code structure
+- Optimized memory usage
+- Optimized error handling
+- Added detailed comments
+- Improved log output
+
+Known Issues:
+- None

components/bluetooth/ble_adv/bthome/CMakeLists.txt

@@ -0,0 +1,3 @@
+idf_component_register(SRCS    "bthome_v2.c"
+                       INCLUDE_DIRS "include"
+                       REQUIRES mbedtls)