ci(bthome): fix docs build warnings

Author: laride

.gitlab/ci/build.yml

@@ -1066,35 +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-v4.4
-      - IMAGE: espressif/idf:release-v5.0
+    - .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
-  parallel:
-    matrix:
-      - IMAGE: espressif/idf:release-v5.0
-      - IMAGE: espressif/idf:release-v5.1
-      - IMAGE: espressif/idf:release-v5.2
+    - .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
-    - .rules:build:components_bluetooth_ble_hci_test_apps
-  parallel:
-    matrix:
-      - IMAGE: espressif/idf:release-v5.2
-  variables:
-    EXAMPLE_DIR: components/bluetooth/ble_hci/test_apps
-
 build_components_button_test_apps:
   extends:
     - .build_examples_template

components/.build-rules.yml

@@ -231,7 +231,7 @@ components/sensors/power_monitor/ina236/test_apps:
 
 components/bluetooth/ble_hci/test_apps:
   enable:
-    - if: IDF_TARGET in ["esp32","esp32c3","esp32s3"] and (IDF_VERSION_MAJOR == 5 and IDF_VERSION_MINOR == 3)
+    - if: IDF_TARGET in ["esp32","esp32c3","esp32s3"] and IDF_VERSION_MAJOR >= 5
 
 components/bluetooth/ble_adv/bthome/test_apps:
   enable:

docs/doxygen-known-warnings.txt

@@ -1,4 +1,4 @@
-bldc_control.h:line: warning: parameters of member bldc_control_config_t::@49 are not (all) documented
-bldc_control.h:line: warning: parameters of member bldc_control_config_t::@51 are not (all) documented
-sensor_type.h:line: warning: parameters of member sensor_data_t::@53 are not (all) documented
+bldc_control.h:line: warning: parameters of member bldc_control_config_t::@50 are not (all) documented
+bldc_control.h:line: warning: parameters of member bldc_control_config_t::@52 are not (all) documented
+sensor_type.h:line: warning: parameters of member sensor_data_t::@54 are not (all) documented
 

docs/en/sensors/power_measure.rst

@@ -49,7 +49,7 @@ Code Snippets
 -------------
 
 BL0937 (GPIO)
-~~~~~~~~~~~~
+^^^^^^^^^^^^^
 
 .. code-block:: c
 
@@ -85,7 +85,7 @@ BL0937 (GPIO)
    power_measure_delete(h);
 
 INA236 (I2C)
-~~~~~~~~~~~~
+^^^^^^^^^^^^
 
 .. code-block:: c
 
@@ -133,13 +133,13 @@ Troubleshooting
 ---------------
 
 BL0937 Issues:
-~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^
 
 1. **Failed Initialization** : If the initialization fails, ensure that all GPIO pins are correctly defined and connected to the **BL0937** chip.
 2. **Measurement Failures** : If the measurements fail (e.g., voltage, current), verify that the **BL0937** chip is properly powered and communicating with your ESP32 series chips.
 
 INA236 Issues:
-~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^
 
 1. **I2C Bus Initialization Failed** : Check that the I2C pins (SDA/SCL) are correctly connected and not conflicting with other peripherals.
 2. **INA236 Not Detected** : Verify the I2C address (default 0x41) and ensure the chip is properly powered.

docs/sphinx-known-warnings.txt

@@ -1,7 +1,7 @@
 lightbulb.inc:line: WARNING: Duplicate C++ declaration, also defined at electrical_lighting_solution/lightbulb_driver:line.
 Declaration is '.. cpp:member:: lightbulb_color_mapping_data_t * table'.
 lightbulb.inc:line: WARNING: Duplicate C++ declaration, also defined at electrical_lighting_solution/lightbulb_driver:line.
-Declaration is '.. cpp:member:: struct lightbulb_config_t::@40::@44 precise'.
+Declaration is '.. cpp:member:: struct lightbulb_config_t::@41::@45 precise'.
 lightbulb.inc:line: WARNING: Duplicate C++ declaration, also defined at electrical_lighting_solution/lightbulb_driver:line.
 Declaration is '.. cpp:member:: lightbulb_chip_out_pin_t red'.
 lightbulb.inc:line: WARNING: Duplicate C++ declaration, also defined at electrical_lighting_solution/lightbulb_driver:line.
@@ -52,68 +52,3 @@ If the function has a return type:
         SLIST_ENTRY (ir_learn_list_t) next
         ----------------------------^
 
-power_measure.rst:line: WARNING: Title underline too short.
-
-BL0937 (GPIO)
-~~~~~~~~~~~~
-power_measure.inc:line: CRITICAL: Title level inconsistent:
-
-Header File
-^^^^^^^^^^^
-power_measure.inc:line: CRITICAL: Title level inconsistent:
-
-Functions
-^^^^^^^^^
-power_measure.inc:line: CRITICAL: Title level inconsistent:
-
-Structures
-^^^^^^^^^^
-power_measure.inc:line: CRITICAL: Title level inconsistent:
-
-Type Definitions
-^^^^^^^^^^^^^^^^
-
-power_measure.rst:line: WARNING: Inline interpreted text or phrase reference start-string without end-string.
-power_measure.rst:line: WARNING: Inline interpreted text or phrase reference start-string without end-string.
-power_measure.rst:line: WARNING: Inline interpreted text or phrase reference start-string without end-string.
-power_measure.rst:line: WARNING: Title underline too short.
-
-BL0937（GPIO）
-~~~~~~~~~~~~
-power_measure.rst:line: WARNING: Title underline too short.
-
-INA236（I2C）
-~~~~~~~~~~~~
-power_measure.rst:line: WARNING: Title underline too short.
-
-INA236（I2C）
-~~~~~~~~~~~~
-power_measure.rst:line: WARNING: Title underline too short.
-
-BL0937 问题：
-~~~~~~~~~~~~
-power_measure.rst:line: WARNING: Title underline too short.
-
-INA236 问题：
-~~~~~~~~~~~~
-power_measure.rst:line: WARNING: Title underline too short.
-
-INA236 问题：
-~~~~~~~~~~~~
-power_measure.inc:line: CRITICAL: Title level inconsistent:
-
-Header File
-^^^^^^^^^^^
-power_measure.inc:line: CRITICAL: Title level inconsistent:
-
-Functions
-^^^^^^^^^
-power_measure.inc:line: CRITICAL: Title level inconsistent:
-
-Structures
-^^^^^^^^^^
-power_measure.inc:line: CRITICAL: Title level inconsistent:
-
-Type Definitions
-^^^^^^^^^^^^^^^^
-

docs/zh_CN/sensors/power_measure.rst

@@ -25,12 +25,12 @@
 
 1. **（可选）初始化 I2C 总线（仅 INA236）**：
 
-   - 使用 `i2c_bus_create()` 按 `I2C_MASTER_SCL_IO`/`I2C_MASTER_SDA_IO` 创建 I2C 总线。
+   - 使用 `i2c_bus_create()` 按 `I2C_MASTER_SCL_IO` / `I2C_MASTER_SDA_IO` 创建 I2C 总线。
 2. **创建功率测量设备**：
 
-   - 准备通用配置 `power_measure_config_t`（过流/过压/欠压阈值、是否启用能量检测）。
-   - 对 BL0937，准备 `power_measure_bl0937_config_t`（CF/CF1/SEL、分压/采样电阻、KI/KU/KP）。
-   - 对 INA236，准备 `power_measure_ina236_config_t`（I2C 句柄、地址、告警配置）。
+   - 准备通用配置 `power_measure_config_t` （过流/过压/欠压阈值、是否启用能量检测）。
+   - 对 BL0937，准备 `power_measure_bl0937_config_t` （CF/CF1/SEL、分压/采样电阻、KI/KU/KP）。
+   - 对 INA236，准备 `power_measure_ina236_config_t` （I2C 句柄、地址、告警配置）。
    - 使用 `power_measure_new_bl0937_device()` 或 `power_measure_new_ina236_device()` 创建设备并获得 `power_measure_handle_t` 句柄。
 3. **周期读取测量值**：
 
@@ -49,7 +49,7 @@
 --------
 
 BL0937（GPIO）
-~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^
 
 .. code-block:: c
 
@@ -85,7 +85,7 @@ BL0937（GPIO）
    power_measure_delete(h);
 
 INA236（I2C）
-~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^
 
 .. code-block:: c
 
@@ -133,13 +133,13 @@ INA236（I2C）
 --------
 
 BL0937 问题：
-~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^
 
 1. **初始化失败**：如果初始化失败，请确保所有 GPIO 引脚都已正确定义并连接到 **BL0937** 芯片。
 2. **测量失败**：如果测量失败（如电压、电流），请检查 **BL0937** 芯片是否正确供电并与 ESP32系列芯片 通信。
 
 INA236 问题：
-~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^
 
 1. **I2C 总线初始化失败**：检查 I2C 引脚（SDA/SCL）是否正确连接且未与其他外设冲突。
 2. **INA236 未检测到**：验证 I2C 地址（默认 0x41）并确保芯片正确供电。