ESP IoT Solution 蓝牙健康温度计 ProfileHTP组件与示例深度解析【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址: https://gitcode.com/GitHub_Trending/es/esp-iot-solution本指南围绕 ESP IoT Solution 仓库中的ble_htp组件展开讲解如何在 GATT Client 端通过该组件从符合蓝牙健康温度计服务Health Thermometer ServiceUUID 0x1809的体温计设备获取温度数据。读完本文你将掌握 HTP 服务的特征值构成、esp_htp组件的 API 与事件机制、底层 BLE 连接管理调用链以及基于控制台命令的完整示例实操流程。一、HTP 是什么健康温度计服务的标准特征Health Thermometer ProfileHTP健康温度计配置文件是蓝牙 SIG 定义的标准 BLE Profile用于让数据收集设备GATT Client从体温计传感器GATT Server读取体温测量值。ESP IoT Solution 的ble_htp组件提供了一套简化 API封装了 HTP 在 GATT Client 端的常用操作见 组件 README。在 esp_htp.h 中定义了该服务及其特征值的 16 位 UUID名称UUID 宏数值用途Health Thermometer ServiceBLE_HTP_UUID160x1809健康温度计服务Temperature MeasurementBLE_HTP_CHR_UUID16_TEMPERATURE_MEASUREMENT0x2A1C最终体温测量值IndicationTemperature TypeBLE_HTP_CHR_UUID16_TEMPERATURE_TYPE0x2A1D测量部位类型可读Intermediate TemperatureBLE_HTP_CHR_UUID16_INTERMEDIATE_TEMPERATURE0x2A1E测量过程中的中间温度NotificationMeasurement IntervalBLE_HTP_CHR_UUID16_MEASUREMENT_INTERVAL0x2A21周期测量间隔可读/可写其中0x2A1C与0x2A1E共享同一套数据格式温度测量值均由esp_ble_htp_data_t结构体描述。二、组件结构与依赖关系2.1 仓库中的位置ble_htp位于 BLE 标准 Profile 组件目录下组件入口components/bluetooth/ble_profiles/std/ble_htp含include/esp_htp.h、src/esp_htp.c、CMakeLists.txt、Kconfig、idf_component.yml配套示例examples/bluetooth/ble_profiles/ble_htp按 idf_component.yml 的描述该组件即 BLE standard profile support Health Thermometer。2.2 添加组件依赖与仓库内其他 Profile 组件一致可以通过 ESP-IDF 组件管理器添加依赖编译时自动下载idf.py add-dependency espressif/ble_htp*也可直接从示例模板创建工程idf.py create-project-from-example espressif/ble_htp*:ble_htp组件 README 特别提示如果执行create-project-from-example时提示CMakeLists.txt not found in project directory说明使用的是旧版组件管理器需在 ESP-IDF 环境中执行pip install -U idf-component-manager升级。2.3 对底层连接管理组件的依赖从源码看esp_htp.c直接依赖esp_ble_conn_mgr.h#include esp_ble_conn_mgr.h见 esp_htp.c所有 GATT 读写操作都通过esp_ble_conn_mgr的esp_ble_conn_read/esp_ble_conn_write完成。因此使用该组件时工程需同时具备ble_conn_mgr的初始化与连接管理逻辑示例中由 app_main.c 完成。三、核心数据结构温度测量值格式3.1 esp_ble_htp_data_t 结构体esp_ble_htp_data_t定义于 esp_htp.h以紧凑位域方式还原了蓝牙规范中 Temperature Measurement 特征的数据布局typedef struct { struct { uint8_t temperature_unit: 1; /*! 温度单位标志位 */ uint8_t time_stamp: 1; /*! 时间戳标志位 */ uint8_t temperature_type: 1; /*! 温度类型标志位 */ uint8_t reserved: 5; /*! 保留位 */ } flags; union { uint32_t celsius; /*! 摄氏温度值 */ uint32_t fahrenheit; /*! 华氏温度值 */ } temperature; struct { uint16_t year; /*! 公历年有效范围 1582~9999 */ uint8_t month; /*! 月1一月~ 12十二月 */ uint8_t day; /*! 日1~31 */ uint8_t hours; /*! 小时0~23 */ uint8_t minutes; /*! 分钟0~59 */ uint8_t seconds; /*! 秒0~59 */ } __attribute__((packed)) timestamp; /*! 测量时间 */ uint8_t location; /*! 温度测量部位 */ } __attribute__((packed)) esp_ble_htp_data_t;各标志位掩码esp_htp.h掩码宏值含义BLE_HTP_FLAGS_BM_TEMPERATURE_UNITS0x01Bit00 为摄氏度1 为华氏度BLE_HTP_FLAGS_BM_TIME_STAMP0x02Bit1数据中是否携带时间戳BLE_HTP_FLAGS_BM_TEMPERATURE_TYPE0x04Bit2数据中是否携带温度类型需要说明的是规范中温度值字段本身是 IEEE 11073 标准的 32 位浮点编码组件以uint32_t原始值原样保存示例中直接打印该原始值如日志中的62212°C实际业务如需按摄氏度/华氏度显示需要按 IEEE 11073 格式解析该 32 位字段。3.2 温度类型枚举location字段Temperature Type的取值定义在 esp_htp.h宏值测量部位BLE_HTP_CHR_TEMPERATURE_TYPE_RFU0保留BLE_HTP_CHR_TEMPERATURE_TYPE_ARMPIT1腋下BLE_HTP_CHR_TEMPERATURE_TYPE_BODY2身体体表BLE_HTP_CHR_TEMPERATURE_TYPE_EAR3耳朵BLE_HTP_CHR_TEMPERATURE_TYPE_FINGER4手指BLE_HTP_CHR_TEMPERATURE_TYPE_GAST_TRACT5胃肠道BLE_HTP_CHR_TEMPERATURE_TYPE_MOUTH6口腔BLE_HTP_CHR_TEMPERATURE_TYPE_RECTUM7直肠BLE_HTP_CHR_TEMPERATURE_TYPE_TOE8脚趾BLE_HTP_CHR_TEMPERATURE_TYPE_TYMPANUM9鼓膜BLE_HTP_CHR_TEMPERATURE_TYPE_MAX10枚举上界3.3 数据解析流程esp_htp.c 中的静态函数esp_ble_htp_get_temp_data()按规范顺序逐字段解析原始字节流先复制 1 字节 Flags 字段依据temperature_unit标志选择拷贝温度字段到temperature.celsius或temperature.fahrenheit若time_stamp标志置位拷贝 7 字节时间戳若temperature_type标志置位读取温度类型到location。函数首先检查inbuf有效性且inlen 5Flags 温度值的理论最小长度否则返回ESP_ERR_INVALID_ARG。四、API 一览初始化、读写与事件4.1 组件提供的五个接口全部声明于 esp_htp.h函数说明返回值esp_ble_htp_init(void)初始化 HTP注册底层连接管理事件回调ESP_OK/ESP_ERR_INVALID_ARG/ESP_FAILesp_ble_htp_deinit(void)反初始化注销事件回调同上esp_ble_htp_get_temp_type(uint8_t *temp_type)读取设备的温度类型特征值0x2A1DESP_OK/ESP_ERR_INVALID_ARG入参为空指针esp_ble_htp_get_measurement_interval(uint16_t *interval_val)读取测量间隔特征值0x2A21同上esp_ble_htp_set_measurement_interval(uint16_t interval_val)写入测量间隔特征值0x2A21ESP_OK/ 底层写失败错误码初始化与反初始化的实现非常轻量esp_htp.cesp_err_t esp_ble_htp_init(void) { return esp_event_handler_register(BLE_CONN_MGR_EVENTS, ESP_EVENT_ANY_ID, esp_ble_htp_event, NULL); } esp_err_t esp_ble_htp_deinit(void) { return esp_event_handler_unregister(BLE_CONN_MGR_EVENTS, ESP_EVENT_ANY_ID, esp_ble_htp_event); }即注册/注销一个针对BLE_CONN_MGR_EVENTS全部事件的回调将连接管理层的接收数据转发为 HTP 上层事件。4.2 事件机制按特征 UUID 分发组件声明了独立的事件基BLE_HTP_EVENTSESP_EVENT_DECLARE_BASE/ESP_EVENT_DEFINE_BASE。在 esp_htp.c 的回调中case ESP_BLE_CONN_EVENT_DATA_RECEIVE: esp_ble_conn_data_t *conn_data (esp_ble_conn_data_t *)event_data; esp_ble_htp_data_t ble_htp_data; memset(ble_htp_data, 0, sizeof(esp_ble_htp_data_t)); esp_ble_htp_get_temp_data(ble_htp_data, conn_data-data, conn_data-data_len); esp_event_post(BLE_HTP_EVENTS, conn_data-uuid.uuid16, ble_htp_data, sizeof(esp_ble_htp_data_t), portMAX_DELAY);关键设计是事件 ID 直接使用来源特征值的 16 位 UUID。上层应用监听BLE_HTP_EVENTS时只需把事件 ID 与BLE_HTP_CHR_UUID16_TEMPERATURE_MEASUREMENT0x2A1C最终温度Indication或BLE_HTP_CHR_UUID16_INTERMEDIATE_TEMPERATURE0x2A1E中间温度Notification比较即可区分两类温度数据收到的event_data即解析好的esp_ble_htp_data_t。从 esp_ble_conn_mgr.h 的注释可知ESP_BLE_CONN_EVENT_DATA_RECEIVE事件中的data字段由 ble_conn_mgr 堆上分配组件在解析后随即 post 到 HTP 事件上层无需关心底层缓冲生命周期。4.3 底层读写调用链三个读写接口均通过ble_conn_mgr执行 GATT 操作以 16 位 UUID 定位特征值BLE_CONN_UUID_TYPE_16读操作构造esp_ble_conn_data_t后调用esp_ble_conn_read()成功后将返回缓冲区数据拷贝给调用方温度类型取首字节测量间隔按MIN(data_len, sizeof(uint16_t))拷贝写操作将 2 字节uint16_t小端值填入esp_ble_conn_write()的入参成功时打印十六进制日志ESP_LOG_BUFFER_HEX_LEVEL。esp_ble_conn_read/esp_ble_conn_write在 esp_nimble.cNimBLE 后端与 esp_bluedroid.cBluedroid 后端中均有实现因此ble_htp组件对两种经典蓝牙主机协议栈均透明兼容。五、示例实操连接体温计并收发温度数据示例位于 examples/bluetooth/ble_profiles/ble_htp支持 ESP32 / ESP32-C3 / ESP32-C2 / ESP32-S3 目标芯片。其行为是创建 GATT Client 并被动扫描若对端广播且声明主服务 UUID 为 0x1809则发起连接连接后自动发现服务、特征与描述符同时启动交互式串口控制台用于模拟 HTP 的读写操作。5.1 构建与运行idf.py set-target chip_name # 例如 esp32c3 idf.py menuconfig # Example Configuration 菜单下可配置广播名 idf.py -p PORT flash monitor # 编译、烧录并打开监视器Example Configuration菜单见 Kconfig.projbuild默认配置为EXAMPLE_BLE_ADV_NAME广播名默认BLE_HTSEXAMPLE_BLE_SUB_ADV后续广播数据默认SUB_ADV测试对端可使用任意宣称支持健康温度计服务0x1809并在 GATT 数据库中包含该服务的 BLE GATT Server App。若对端声称支持 HTP 服务却不提供所需特征/描述符或 GATT 流程失败示例会立即断开连接。5.2 控制台命令控制台注册了htp命令参数定义见 app_htp.chtp [-t 01~03] [-i 0~65535] -t, --type01~03 01 读取温度类型特征值 02 读取测量间隔特征值 03 写入测量间隔特征值 -i, --interval0~65535 0: 不进行周期测量其他值: 测量间隔时长典型操作# 读取温度类型 htp -t 1 # 读取测量间隔 htp -t 2 # 设置测量间隔为 0关闭周期 Indication htp -t 3 -i 0 # 设置测量间隔为 10 秒 htp -t 3 -i 10app_htp_run()app_htp.c将命令类型 1/2/3 分别映射到esp_ble_htp_get_temp_type/esp_ble_htp_get_measurement_interval/esp_ble_htp_set_measurement_interval。5.3 应用层事件处理示例通过esp_event_handler_register(BLE_HTP_EVENTS, ESP_EVENT_ANY_ID, app_htp_event_handler, NULL)订阅温度数据app_htp.c。回调按事件 ID即特征 UUID分流BLE_HTP_CHR_UUID16_TEMPERATURE_MEASUREMENT打印时间戳若带、温度类型若带与Measurement Temperature按标志位输出°C或°FBLE_HTP_CHR_UUID16_INTERMEDIATE_TEMPERATURE同样解析并打印Intermediate Temperature。5.4 运行日志解读以 ESP32-C3 上成功连接后的日志为例节选自 示例 READMEesp32c3 htp -t 1 I (12397) esp_nimble: characteristic read; conn_handle1 attr_handle16 len1 I (12397) app_htp: Gets the current temperature type value 7 esp32c3 htp -t 2 I (14477) esp_nimble: characteristic read; conn_handle1 attr_handle23 len2 I (14477) app_htp: Gets the measurement interval value 2068 esp32c3 htp -t 3 -i 0 I (23707) esp_htp: Sets the measurement interval value Success! I (23717) esp_htp: ESP_BLE_CONN_EVENT_DATA_RECEIVE I (23727) app_htp: Measurement Temperature 62212°C I (23727) app_htp: Sets the measurement interval value 0 I (23797) esp_htp: ESP_BLE_CONN_EVENT_DATA_RECEIVE I (23817) app_htp: Intermediate Temperature 50762℉ esp32c3 htp -t 3 -i 10 I (27307) esp_htp: Sets the measurement interval value Success! I (27337) app_htp: Temperature Type 7 I (27337) app_htp: Measurement Temperature 7873°C I (27337) app_htp: Sets the measurement interval value 10 I (27417) app_htp: Intermediate Temperature 13545°C日志清晰展示了完整数据流写测量间隔成功后对端随即通过 Indication0x2A1C上报最终温度、通过 Notification0x2A1E上报中间温度ESP_BLE_CONN_EVENT_DATA_RECEIVE由底层连接管理触发esp_htp完成解析app_htp负责打印展示。5.5 主程序初始化顺序app_main.c 给出了标准的接入顺序可作为二次开发模板nvs_flash_init()初始化 NVS失败且为ESP_ERR_NVS_NO_FREE_PAGES/ESP_ERR_NVS_NEW_VERSION_FOUND时先擦除再初始化esp_event_loop_create_default()创建默认事件循环注册BLE_CONN_MGR_EVENTS的全局连接状态回调CONNECTED / DISCONNECTED / DISC_COMPLETE / DATA_RECEIVEapp_console_init()初始化控制台register_htp()注册htp命令并调用esp_ble_htp_init()esp_ble_conn_init(config)传入esp_ble_conn_config_t含device_name与broadcast_dataesp_ble_conn_start()启动扫描连接流程失败时依次esp_ble_conn_stop()、esp_ble_conn_deinit()并注销事件。六、小结ble_htp组件在 ESP IoT Solution 中属于“BLE 标准 Profile”组件族与ble_hrp、ble_anp、ble_otp并列于 components/bluetooth/ble_profiles/std。它并不直接管理扫描、连接与 GATT 发现而是依赖ble_conn_mgr完成这些底层工作自身专注于两件事把 HTP 特征的原始字节解析为结构化的esp_ble_htp_data_t以及以“特征 UUID 即事件 ID”的方式向应用层分发温度数据。这种分层设计使开发者只需调用 5 个 API 并订阅BLE_HTP_EVENTS即可快速接入符合蓝牙规范的体温计设备可用于健康监测、医疗数据采集等物联网应用场景。【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址: https://gitcode.com/GitHub_Trending/es/esp-iot-solution创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ESP IoT Solution 蓝牙健康温度计 Profile（HTP）组件与示例深度解析
ESP IoT Solution 蓝牙健康温度计 ProfileHTP组件与示例深度解析【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址: https://gitcode.com/GitHub_Trending/es/esp-iot-solution本指南围绕 ESP IoT Solution 仓库中的ble_htp组件展开讲解如何在 GATT Client 端通过该组件从符合蓝牙健康温度计服务Health Thermometer ServiceUUID 0x1809的体温计设备获取温度数据。读完本文你将掌握 HTP 服务的特征值构成、esp_htp组件的 API 与事件机制、底层 BLE 连接管理调用链以及基于控制台命令的完整示例实操流程。一、HTP 是什么健康温度计服务的标准特征Health Thermometer ProfileHTP健康温度计配置文件是蓝牙 SIG 定义的标准 BLE Profile用于让数据收集设备GATT Client从体温计传感器GATT Server读取体温测量值。ESP IoT Solution 的ble_htp组件提供了一套简化 API封装了 HTP 在 GATT Client 端的常用操作见 组件 README。在 esp_htp.h 中定义了该服务及其特征值的 16 位 UUID名称UUID 宏数值用途Health Thermometer ServiceBLE_HTP_UUID160x1809健康温度计服务Temperature MeasurementBLE_HTP_CHR_UUID16_TEMPERATURE_MEASUREMENT0x2A1C最终体温测量值IndicationTemperature TypeBLE_HTP_CHR_UUID16_TEMPERATURE_TYPE0x2A1D测量部位类型可读Intermediate TemperatureBLE_HTP_CHR_UUID16_INTERMEDIATE_TEMPERATURE0x2A1E测量过程中的中间温度NotificationMeasurement IntervalBLE_HTP_CHR_UUID16_MEASUREMENT_INTERVAL0x2A21周期测量间隔可读/可写其中0x2A1C与0x2A1E共享同一套数据格式温度测量值均由esp_ble_htp_data_t结构体描述。二、组件结构与依赖关系2.1 仓库中的位置ble_htp位于 BLE 标准 Profile 组件目录下组件入口components/bluetooth/ble_profiles/std/ble_htp含include/esp_htp.h、src/esp_htp.c、CMakeLists.txt、Kconfig、idf_component.yml配套示例examples/bluetooth/ble_profiles/ble_htp按 idf_component.yml 的描述该组件即 BLE standard profile support Health Thermometer。2.2 添加组件依赖与仓库内其他 Profile 组件一致可以通过 ESP-IDF 组件管理器添加依赖编译时自动下载idf.py add-dependency espressif/ble_htp*也可直接从示例模板创建工程idf.py create-project-from-example espressif/ble_htp*:ble_htp组件 README 特别提示如果执行create-project-from-example时提示CMakeLists.txt not found in project directory说明使用的是旧版组件管理器需在 ESP-IDF 环境中执行pip install -U idf-component-manager升级。2.3 对底层连接管理组件的依赖从源码看esp_htp.c直接依赖esp_ble_conn_mgr.h#include esp_ble_conn_mgr.h见 esp_htp.c所有 GATT 读写操作都通过esp_ble_conn_mgr的esp_ble_conn_read/esp_ble_conn_write完成。因此使用该组件时工程需同时具备ble_conn_mgr的初始化与连接管理逻辑示例中由 app_main.c 完成。三、核心数据结构温度测量值格式3.1 esp_ble_htp_data_t 结构体esp_ble_htp_data_t定义于 esp_htp.h以紧凑位域方式还原了蓝牙规范中 Temperature Measurement 特征的数据布局typedef struct { struct { uint8_t temperature_unit: 1; /*! 温度单位标志位 */ uint8_t time_stamp: 1; /*! 时间戳标志位 */ uint8_t temperature_type: 1; /*! 温度类型标志位 */ uint8_t reserved: 5; /*! 保留位 */ } flags; union { uint32_t celsius; /*! 摄氏温度值 */ uint32_t fahrenheit; /*! 华氏温度值 */ } temperature; struct { uint16_t year; /*! 公历年有效范围 1582~9999 */ uint8_t month; /*! 月1一月~ 12十二月 */ uint8_t day; /*! 日1~31 */ uint8_t hours; /*! 小时0~23 */ uint8_t minutes; /*! 分钟0~59 */ uint8_t seconds; /*! 秒0~59 */ } __attribute__((packed)) timestamp; /*! 测量时间 */ uint8_t location; /*! 温度测量部位 */ } __attribute__((packed)) esp_ble_htp_data_t;各标志位掩码esp_htp.h掩码宏值含义BLE_HTP_FLAGS_BM_TEMPERATURE_UNITS0x01Bit00 为摄氏度1 为华氏度BLE_HTP_FLAGS_BM_TIME_STAMP0x02Bit1数据中是否携带时间戳BLE_HTP_FLAGS_BM_TEMPERATURE_TYPE0x04Bit2数据中是否携带温度类型需要说明的是规范中温度值字段本身是 IEEE 11073 标准的 32 位浮点编码组件以uint32_t原始值原样保存示例中直接打印该原始值如日志中的62212°C实际业务如需按摄氏度/华氏度显示需要按 IEEE 11073 格式解析该 32 位字段。3.2 温度类型枚举location字段Temperature Type的取值定义在 esp_htp.h宏值测量部位BLE_HTP_CHR_TEMPERATURE_TYPE_RFU0保留BLE_HTP_CHR_TEMPERATURE_TYPE_ARMPIT1腋下BLE_HTP_CHR_TEMPERATURE_TYPE_BODY2身体体表BLE_HTP_CHR_TEMPERATURE_TYPE_EAR3耳朵BLE_HTP_CHR_TEMPERATURE_TYPE_FINGER4手指BLE_HTP_CHR_TEMPERATURE_TYPE_GAST_TRACT5胃肠道BLE_HTP_CHR_TEMPERATURE_TYPE_MOUTH6口腔BLE_HTP_CHR_TEMPERATURE_TYPE_RECTUM7直肠BLE_HTP_CHR_TEMPERATURE_TYPE_TOE8脚趾BLE_HTP_CHR_TEMPERATURE_TYPE_TYMPANUM9鼓膜BLE_HTP_CHR_TEMPERATURE_TYPE_MAX10枚举上界3.3 数据解析流程esp_htp.c 中的静态函数esp_ble_htp_get_temp_data()按规范顺序逐字段解析原始字节流先复制 1 字节 Flags 字段依据temperature_unit标志选择拷贝温度字段到temperature.celsius或temperature.fahrenheit若time_stamp标志置位拷贝 7 字节时间戳若temperature_type标志置位读取温度类型到location。函数首先检查inbuf有效性且inlen 5Flags 温度值的理论最小长度否则返回ESP_ERR_INVALID_ARG。四、API 一览初始化、读写与事件4.1 组件提供的五个接口全部声明于 esp_htp.h函数说明返回值esp_ble_htp_init(void)初始化 HTP注册底层连接管理事件回调ESP_OK/ESP_ERR_INVALID_ARG/ESP_FAILesp_ble_htp_deinit(void)反初始化注销事件回调同上esp_ble_htp_get_temp_type(uint8_t *temp_type)读取设备的温度类型特征值0x2A1DESP_OK/ESP_ERR_INVALID_ARG入参为空指针esp_ble_htp_get_measurement_interval(uint16_t *interval_val)读取测量间隔特征值0x2A21同上esp_ble_htp_set_measurement_interval(uint16_t interval_val)写入测量间隔特征值0x2A21ESP_OK/ 底层写失败错误码初始化与反初始化的实现非常轻量esp_htp.cesp_err_t esp_ble_htp_init(void) { return esp_event_handler_register(BLE_CONN_MGR_EVENTS, ESP_EVENT_ANY_ID, esp_ble_htp_event, NULL); } esp_err_t esp_ble_htp_deinit(void) { return esp_event_handler_unregister(BLE_CONN_MGR_EVENTS, ESP_EVENT_ANY_ID, esp_ble_htp_event); }即注册/注销一个针对BLE_CONN_MGR_EVENTS全部事件的回调将连接管理层的接收数据转发为 HTP 上层事件。4.2 事件机制按特征 UUID 分发组件声明了独立的事件基BLE_HTP_EVENTSESP_EVENT_DECLARE_BASE/ESP_EVENT_DEFINE_BASE。在 esp_htp.c 的回调中case ESP_BLE_CONN_EVENT_DATA_RECEIVE: esp_ble_conn_data_t *conn_data (esp_ble_conn_data_t *)event_data; esp_ble_htp_data_t ble_htp_data; memset(ble_htp_data, 0, sizeof(esp_ble_htp_data_t)); esp_ble_htp_get_temp_data(ble_htp_data, conn_data-data, conn_data-data_len); esp_event_post(BLE_HTP_EVENTS, conn_data-uuid.uuid16, ble_htp_data, sizeof(esp_ble_htp_data_t), portMAX_DELAY);关键设计是事件 ID 直接使用来源特征值的 16 位 UUID。上层应用监听BLE_HTP_EVENTS时只需把事件 ID 与BLE_HTP_CHR_UUID16_TEMPERATURE_MEASUREMENT0x2A1C最终温度Indication或BLE_HTP_CHR_UUID16_INTERMEDIATE_TEMPERATURE0x2A1E中间温度Notification比较即可区分两类温度数据收到的event_data即解析好的esp_ble_htp_data_t。从 esp_ble_conn_mgr.h 的注释可知ESP_BLE_CONN_EVENT_DATA_RECEIVE事件中的data字段由 ble_conn_mgr 堆上分配组件在解析后随即 post 到 HTP 事件上层无需关心底层缓冲生命周期。4.3 底层读写调用链三个读写接口均通过ble_conn_mgr执行 GATT 操作以 16 位 UUID 定位特征值BLE_CONN_UUID_TYPE_16读操作构造esp_ble_conn_data_t后调用esp_ble_conn_read()成功后将返回缓冲区数据拷贝给调用方温度类型取首字节测量间隔按MIN(data_len, sizeof(uint16_t))拷贝写操作将 2 字节uint16_t小端值填入esp_ble_conn_write()的入参成功时打印十六进制日志ESP_LOG_BUFFER_HEX_LEVEL。esp_ble_conn_read/esp_ble_conn_write在 esp_nimble.cNimBLE 后端与 esp_bluedroid.cBluedroid 后端中均有实现因此ble_htp组件对两种经典蓝牙主机协议栈均透明兼容。五、示例实操连接体温计并收发温度数据示例位于 examples/bluetooth/ble_profiles/ble_htp支持 ESP32 / ESP32-C3 / ESP32-C2 / ESP32-S3 目标芯片。其行为是创建 GATT Client 并被动扫描若对端广播且声明主服务 UUID 为 0x1809则发起连接连接后自动发现服务、特征与描述符同时启动交互式串口控制台用于模拟 HTP 的读写操作。5.1 构建与运行idf.py set-target chip_name # 例如 esp32c3 idf.py menuconfig # Example Configuration 菜单下可配置广播名 idf.py -p PORT flash monitor # 编译、烧录并打开监视器Example Configuration菜单见 Kconfig.projbuild默认配置为EXAMPLE_BLE_ADV_NAME广播名默认BLE_HTSEXAMPLE_BLE_SUB_ADV后续广播数据默认SUB_ADV测试对端可使用任意宣称支持健康温度计服务0x1809并在 GATT 数据库中包含该服务的 BLE GATT Server App。若对端声称支持 HTP 服务却不提供所需特征/描述符或 GATT 流程失败示例会立即断开连接。5.2 控制台命令控制台注册了htp命令参数定义见 app_htp.chtp [-t 01~03] [-i 0~65535] -t, --type01~03 01 读取温度类型特征值 02 读取测量间隔特征值 03 写入测量间隔特征值 -i, --interval0~65535 0: 不进行周期测量其他值: 测量间隔时长典型操作# 读取温度类型 htp -t 1 # 读取测量间隔 htp -t 2 # 设置测量间隔为 0关闭周期 Indication htp -t 3 -i 0 # 设置测量间隔为 10 秒 htp -t 3 -i 10app_htp_run()app_htp.c将命令类型 1/2/3 分别映射到esp_ble_htp_get_temp_type/esp_ble_htp_get_measurement_interval/esp_ble_htp_set_measurement_interval。5.3 应用层事件处理示例通过esp_event_handler_register(BLE_HTP_EVENTS, ESP_EVENT_ANY_ID, app_htp_event_handler, NULL)订阅温度数据app_htp.c。回调按事件 ID即特征 UUID分流BLE_HTP_CHR_UUID16_TEMPERATURE_MEASUREMENT打印时间戳若带、温度类型若带与Measurement Temperature按标志位输出°C或°FBLE_HTP_CHR_UUID16_INTERMEDIATE_TEMPERATURE同样解析并打印Intermediate Temperature。5.4 运行日志解读以 ESP32-C3 上成功连接后的日志为例节选自 示例 READMEesp32c3 htp -t 1 I (12397) esp_nimble: characteristic read; conn_handle1 attr_handle16 len1 I (12397) app_htp: Gets the current temperature type value 7 esp32c3 htp -t 2 I (14477) esp_nimble: characteristic read; conn_handle1 attr_handle23 len2 I (14477) app_htp: Gets the measurement interval value 2068 esp32c3 htp -t 3 -i 0 I (23707) esp_htp: Sets the measurement interval value Success! I (23717) esp_htp: ESP_BLE_CONN_EVENT_DATA_RECEIVE I (23727) app_htp: Measurement Temperature 62212°C I (23727) app_htp: Sets the measurement interval value 0 I (23797) esp_htp: ESP_BLE_CONN_EVENT_DATA_RECEIVE I (23817) app_htp: Intermediate Temperature 50762℉ esp32c3 htp -t 3 -i 10 I (27307) esp_htp: Sets the measurement interval value Success! I (27337) app_htp: Temperature Type 7 I (27337) app_htp: Measurement Temperature 7873°C I (27337) app_htp: Sets the measurement interval value 10 I (27417) app_htp: Intermediate Temperature 13545°C日志清晰展示了完整数据流写测量间隔成功后对端随即通过 Indication0x2A1C上报最终温度、通过 Notification0x2A1E上报中间温度ESP_BLE_CONN_EVENT_DATA_RECEIVE由底层连接管理触发esp_htp完成解析app_htp负责打印展示。5.5 主程序初始化顺序app_main.c 给出了标准的接入顺序可作为二次开发模板nvs_flash_init()初始化 NVS失败且为ESP_ERR_NVS_NO_FREE_PAGES/ESP_ERR_NVS_NEW_VERSION_FOUND时先擦除再初始化esp_event_loop_create_default()创建默认事件循环注册BLE_CONN_MGR_EVENTS的全局连接状态回调CONNECTED / DISCONNECTED / DISC_COMPLETE / DATA_RECEIVEapp_console_init()初始化控制台register_htp()注册htp命令并调用esp_ble_htp_init()esp_ble_conn_init(config)传入esp_ble_conn_config_t含device_name与broadcast_dataesp_ble_conn_start()启动扫描连接流程失败时依次esp_ble_conn_stop()、esp_ble_conn_deinit()并注销事件。六、小结ble_htp组件在 ESP IoT Solution 中属于“BLE 标准 Profile”组件族与ble_hrp、ble_anp、ble_otp并列于 components/bluetooth/ble_profiles/std。它并不直接管理扫描、连接与 GATT 发现而是依赖ble_conn_mgr完成这些底层工作自身专注于两件事把 HTP 特征的原始字节解析为结构化的esp_ble_htp_data_t以及以“特征 UUID 即事件 ID”的方式向应用层分发温度数据。这种分层设计使开发者只需调用 5 个 API 并订阅BLE_HTP_EVENTS即可快速接入符合蓝牙规范的体温计设备可用于健康监测、医疗数据采集等物联网应用场景。【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址: https://gitcode.com/GitHub_Trending/es/esp-iot-solution创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考