feat: add bthome test_apps

Author: loop233

.gitlab/ci/build.yml

@@ -1073,6 +1073,18 @@ build_components_bluetooth_ble_hci_test_apps:
   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
+  parallel:
+    matrix:
+      - IMAGE: espressif/idf:release-v5.0
+      - IMAGE: espressif/idf:release-v5.1
+      - IMAGE: espressif/idf:release-v5.2
+  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

.gitlab/ci/target_test.yml

@@ -940,3 +940,37 @@ tools_test_cmake_utilities:
     TEST_TARGET: ${IDF_TARGET}
     TEST_FOLDER: tools/cmake_utilities
     TEST_ENV: ${ENV_TAG}
+
+components_test_bluetooth_ble_adv_bthome:
+  extends:
+    - .pytest_template
+    - .rules:build:components_bluetooth_ble_adv_bthome_test_apps
+  needs:
+    - job: "build_components_bluetooth_ble_adv_bthome_test_apps"
+      artifacts: true
+      optional: false
+  parallel:
+    matrix:
+      - IDF_TARGET: esp32
+        IDF_VERSION: "5.0"
+        ENV_TAG: "generic"
+      - IDF_TARGET: esp32s3
+        IDF_VERSION: "5.0"
+        ENV_TAG: "generic"
+      - IDF_TARGET: esp32c3
+        IDF_VERSION: "5.0"
+        ENV_TAG: "generic"
+      - IDF_TARGET: esp32h2
+        IDF_VERSION: "5.0"
+        ENV_TAG: "generic"
+      - IDF_TARGET: esp32c6
+        IDF_VERSION: "5.0"
+        ENV_TAG: "generic"
+  tags:
+    - ${IDF_TARGET}
+    - ${ENV_TAG}
+  image: $DOCKER_TARGET_TEST_v5_1_ENV_IMAGE
+  variables:
+    TEST_TARGET: ${IDF_TARGET}
+    TEST_FOLDER: components/bluetooth/ble_adv/bthome
+    TEST_ENV: ${ENV_TAG}

components/bluetooth/ble_adv/bthome/bthome_v2.c

@@ -457,6 +457,7 @@ esp_err_t bthome_register_callbacks(bthome_handle_t handle, bthome_callbacks_t *
 
 esp_err_t bthome_load_params(bthome_handle_t handle)
 {
+    ESP_RETURN_ON_FALSE(handle, ESP_ERR_INVALID_ARG, TAG, "handle is null");
     bthome_t *bthome = (bthome_t *)handle;
     uint8_t counter[4];
     bthome->callbacks.load(handle, BTHOME_COUNTER_KEY, counter, sizeof(counter));

components/bluetooth/ble_adv/bthome/test_apps/CMakeLists.txt

@@ -0,0 +1,8 @@
+# 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)
+
+set(EXTRA_COMPONENT_DIRS "$ENV{IDF_PATH}/tools/unit-test-app/components"
+                         "../../")
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+project(bthome_test)

components/bluetooth/ble_adv/bthome/test_apps/README.md

@@ -0,0 +1,47 @@
+# BTHome Component Test Application
+
+This directory contains test applications for the BTHome component.
+
+## Test Structure
+
+- `main/bthome_test.c` - Main test file containing unit tests for BTHome functionality
+- `pytest_bthome.py` - Pytest configuration for automated testing
+- `sdkconfig.defaults` - Default configuration for the test application
+
+## Test Cases
+
+The test application includes the following test cases:
+
+1. **bthome_create_delete** - Tests basic object creation and deletion
+2. **bthome_encryption_config** - Tests encryption key and MAC address configuration
+3. **bthome_payload_creation** - Tests sensor data payload creation
+4. **bthome_binary_sensor_data** - Tests binary sensor data handling
+5. **bthome_event_data** - Tests event data handling
+6. **bthome_adv_data_creation** - Tests advertisement data creation
+7. **bthome_adv_data_parsing** - Tests advertisement data parsing
+8. **bthome_memory_management** - Tests memory management and leak detection
+9. **bthome_error_handling** - Tests error handling and edge cases
+
+## Building and Running
+
+To build the test application:
+
+```bash
+cd components/bluetooth/ble_adv/bthome/test_apps
+idf.py build
+```
+
+To run the tests:
+
+```bash
+idf.py monitor
+```
+
+## CI Integration
+
+The test application is integrated into the CI pipeline and will run automatically when:
+- BTHome component code is modified
+- The test application itself is modified
+- Manual CI trigger
+
+The tests run on multiple ESP32 variants (ESP32, ESP32-S3, ESP32-C3) and IDF versions (4.4, 5.0, 5.1, 5.2).

components/bluetooth/ble_adv/bthome/test_apps/main/CMakeLists.txt

@@ -0,0 +1,3 @@
+idf_component_register(SRCS "bthome_test.c"
+                       INCLUDE_DIRS "."
+                       REQUIRES bthome unity)