物联网嵌入式驱动开发硬件开发【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址https://gitcode.com/GitHub_Trending/es/esp-iot-solution点击查看免费下载本文以 esp-iot-solution 仓库中的 Sensor Hub 官方文档 为主体结合 sensor_hub 组件源码 展开。Sensor Hub 是 Espressif IoT 方案中负责传感器硬件抽象、设备管理与数据分发的核心组件。读完本文你将掌握 Sensor Hub 的三层架构、基于链接器段的驱动自动注册机制、事件驱动的数据分发模型并能够独立完成驱动注册与应用开发两条开发路径的完整实操。引言为什么要用 Sensor Hub在 ESP32 系列嵌入式应用中接入传感器传统做法是为每个传感器编写独立的初始化、读取与调度代码。当项目中同时存在温湿度、IMU、光照等多个传感器时这种每传感器一套逻辑的方式会导致代码重复、调度混乱、总线管理各自为政。Sensor Hub 的核心价值在于集中管理它将传感器驱动以组件方式注册到统一框架中由框架统一负责传感器实例管理、采集调度与事件分发。应用开发者无需关心传感器底层寄存器操作只需做三件事——选择传感器、配置采集方式、注册事件回调。从源码结构看Sensor Hub 组件components/sensors/sensor_hub/由以下几个关键部分组成iot_sensor_hub.c/iot_sensor_hub.h核心管理逻辑与对外 APIsensor_type.h传感器类型、模式、量程、数据结构的统一定义sensor_event.h/sensors_event.c基于 esp_event 的事件循环封装hal/目录三类传感器 HAL 抽象层温湿度、IMU、光照linker.lf链接器段定义用于驱动自动注册。Sensor Hub 编程模型官方文档给出了 Sensor Hub 的编程模型示意图从图中可以看出Sensor Hub 位于应用与传感器驱动之间形成应用 → Sensor Hub → 驱动 → 硬件的分层结构。该组件支持以组件方式加载传感器驱动用户添加传感器时只需填入注册到 Sensor Hub 的传感器名称即可直接获取对应驱动。由于实现了对传感器的集中管理Sensor Hub 在简化操作的同时也提高了运行效率可作为传感器应用的基础组件应用于环境感知、运动感知、健康管理等智能化场景。驱动层的组织方式如下图所示三类传感器类型Sensor Hub 当前抽象了三种传感器类型定义于 sensor_type.h类型枚举含义覆盖的数据HUMITURE_ID温湿度传感器温度、湿度IMU_ID惯性测量单元加速度、陀螺仪、磁力计LIGHT_SENSOR_ID光照传感器环境光照度、RGBW 颜色、UV 紫外线每种类型对应一个 HAL 实现接口humiture_impl_t、imu_impl_t、light_impl_t定义于 hal/ 目录。以温湿度为例humiture_hal.h 中的humiture_impl_t包含init、deinit、test、acquire_humidity、acquire_temperature、sleep、wakeup、set_mode、set_range等函数指针——这就是驱动开发者需要实现的全部接口。统一的数据结构Sensor Hub 用sensor_data_t统一承载所有类型的采集数据sensor_type.htypedef struct { int64_t timestamp; /*! timestamp */ const char* sensor_name; /*! sensor name */ sensor_type_t sensor_type; /*! sensor type */ uint8_t sensor_addr; /*! sensor addr */ int32_t event_id; /*! reserved for future use */ uint32_t min_delay; /*! minimum delay between two events, unit: ms */ union { axis3_t acce; /*! Accelerometer. unit: G */ axis3_t gyro; /*! Gyroscope. unit: dps */ axis3_t mag; /*! Magnetometer. unit: Gauss */ float temperature; /*! Temperature. unit: dCelsius */ float humidity; /*! Relative humidity. unit: percentage */ ... float data[4]; /*! for general use */ }; } sensor_data_t;该结构体使用 union 容纳所有传感器数据类型三维数据用axis3_tx/y/z 浮点联合颜色用rgbw_t紫外线用uv_t。每个数据都带时间戳、传感器名称、类型、地址等元信息应用层可以据此追溯数据来源。驱动注册机制链接器段自动发现Sensor Hub 采用链接器脚本生成机制ESP-IDF 的 linker script generation 功能将传感器驱动注册到特定目标文件段中。对应用开发者而言无需关注驱动具体实现只需添加对应传感器组件即可自动加载驱动。链接器段定义linker.lf 定义了名为sensors_detect的段[sections:sensors_detect] entries: .sensor_hub_detect_fn [mapping:sensors_detect] archive: * entries: * (sensors_detect_default); sensors_detect - flash_rodata KEEP() ALIGN(4, pre, post) SURROUND(_sensor_hub_detect_fn_array)该段被SURROUND(_sensor_hub_detect_fn_array)包裹生成__sensor_hub_detect_fn_array_start与__sensor_hub_detect_fn_array_end两个边界符号。所有驱动通过SENSOR_HUB_DETECT_FN宏放入此段运行时即可遍历该段完成驱动发现。从源码看iot_sensor_hub.c 中的iot_sensor_scan()正是遍历这段地址区间来扫描可用驱动int iot_sensor_scan() { int sensor_count 0; // search the sensor driver from a specific segment for (sensor_hub_detect_fn_t *p __sensor_hub_detect_fn_array_start; p __sensor_hub_detect_fn_array_end; p) { sensor_info_t info; sensor_device_impl_t sensor_device_impl (*(p-fn))(info); if (sensor_device_impl ! NULL) { ESP_LOGI(TAG, Find %s driver, type: %s, info.name, SENSOR_TYPE_STRING[info.sensor_type]); sensor_count; } } return sensor_count; }注册宏 SENSOR_HUB_DETECT_FN宏定义于 iot_sensor_hub.h#define SENSOR_HUB_DETECT_FN(type_id, name_id, impl) \ static void* __sensor_hub_detect_fn_##name_id(sensor_info_t *sensor_info); \ __attribute__((used)) _SECTION_ATTR_IMPL(.sensor_hub_detect_fn, __COUNTER__) \ sensor_hub_detect_fn_t sensor_hub_detect_fn_##name_id { \ .fn __sensor_hub_detect_fn_##name_id, \ }; \ static void* __sensor_hub_detect_fn_##name_id(sensor_info_t *sensor_info) { \ sensor_info-name #name_id; \ sensor_info-sensor_type type_id; \ return impl; \ }宏将检测函数放入.sensor_hub_detect_fn段并注入sensor_info-name取name_id的字符串化与sensor_info-sensor_type。注意为防止链接器优化掉驱动驱动必须至少包含一个被显式引用的未定义符号——这正是驱动 CMakeLists 中-u symbol参数的作用。驱动开发指南注册一个新传感器第一步实现驱动接口以 SHT3X 温湿度传感器为例此例取自官方文档驱动开发者需将与传感器相关的操作填入humiture_impl_t结构体static humiture_impl_t sht3x_impl { .init humiture_sht3x_init, .deinit humiture_sht3x_deinit, .test humiture_sht3x_test, .acquire_humidity humiture_sht3x_acquire_humidity, .acquire_temperature humiture_sht3x_acquire_temperature, };第二步调用注册宏SENSOR_HUB_DETECT_FN(HUMITURE_ID, sht3x, sht3x_impl);对于 IMU 传感器注册方式完全一致例如测试代码中注册的虚拟 MPU6050test_apps 中的virtual_imu_sensor.cstatic imu_impl_t virtual_mpu6050_impl { .init virtual_imu_init, .deinit virtual_imu_deinit, .test virtual_imu_test, .acquire_acce virtual_imu_acquire_acce, .acquire_gyro virtual_imu_acquire_gyro, }; SENSOR_HUB_DETECT_FN(IMU_ID, virtual_mpu6050, virtual_mpu6050_impl);第三步在 CMakeLists.txt 中添加接口依赖为了确保驱动符号不被链接器丢弃需在组件CMakeLists.txt中加入未定义符号引用target_link_libraries(${COMPONENT_LIB} INTERFACE -u humiture_sht3x_init)-u选项强制链接器保留指定符号从而将整个驱动对象拉入最终固件。sensor_hub 的 test_apps 提供了虚拟传感器的注册范例可作为编写自有驱动的参考。底层如何调用驱动从 iot_sensor_hub.c 可以看到Sensor Hub 内部为三类传感器维护了一个实现表s_sensor_impls[]每个条目含create、remove、acquire、control四个函数指针对应 HAL 层暴露的humiture_create、humiture_acquire、humiture_control等 API。iot_sensor_create通过sensor_find_impl()按config-type查找对应实现再依次调用impl-create(bus, name, addr)创建驱动实例impl-control(driver, COMMAND_SET_MODE, mode)设置工作模式不支持时返回ESP_ERR_NOT_SUPPORTED被跳过impl-control(driver, COMMAND_SET_RANGE, range)设置量程impl-control(driver, COMMAND_SET_ODR, min_delay)设置输出频率impl-control(driver, COMMAND_SELF_TEST, NULL)自检——此步不可跳过失败则整个创建流程回滚。创建成功后传感器会被加入一个基于单向链表_iot_sensor_slist_t以互斥锁保护的管理列表中。应用开发指南七步使用 Sensor Hub第一步添加组件依赖在工程的idf_component.yml中添加sensor_hub与所需传感器组件也可以在工程目录执行组件管理器命令idf.py add-dependency espressif/sensor_hub*CMake 阶段组件会被自动下载。官方 READMEcomponents/sensors/sensor_hub/README.md给出了同样说明。第二步创建传感器实例使用iot_sensor_create创建实例参数包括传感器名称、传感器配置项和传感器句柄指针sensor_config_t sht3x_config { .bus i2c0_bus_handle, .addr 0x44, .mode MODE_POLLING, .min_delay SENSOR_PERIOD, }; iot_sensor_create(sht3x, sht3x_config, sht3x_handle)sensor_config_t各字段含义iot_sensor_hub.h字段类型说明busbus_handle_t传感器挂载的总线句柄i2c/spiaddruint8_t传感器 I2C 地址typesensor_type_t传感器类型modesensor_mode_t工作模式rangesensor_range_t测量量程min_delayuint32_t最小采集间隔msintr_pin/intr_typeint中断引脚与中断类型中断模式下使用其中bus、addr、type、mode、min_delay为关键必填项其余为非必须项。传感器名称用于查找加载注册到 Sensor Hub 中的驱动若传感器支持地址可配置则可以多次创建同名传感器每个实例内部会以sensor_name_addr格式生成独立的事件基见 iot_sensor_hub.c。支持的工作模式sensor_type.hMODE_DEFAULT默认模式MODE_POLLING轮询模式按min_delay间隔周期性采集MODE_INTERRUPT中断模式GPIO 中断到来时采集需配置intr_pin/intr_type。第三步注册事件回调传感器事件发生时回调函数将被依次调用。注册有两种方式成功后返回事件回调函数实例句柄iot_sensor_handler_register(handle, handler, instance)通过传感器句柄注册监听该传感器全部事件内部使用ESP_EVENT_ANY_ID注册到该传感器的事件基上iot_sensor_handler_register_with_type(type, event_id, handler, instance)通过传感器类型注册只关心事件类型而不关心由谁发出内部映射到SENSOR_HUMITURE_EVENTS/SENSOR_IMU_EVENTS/SENSOR_LIGHTSENSOR_EVENTS等全局事件基。事件回调函数原型为void (*sensor_event_handler_t)(void *event_handler_arg, sensor_event_base_t event_base, int32_t event_id, void *event_data);第四步启动传感器iot_sensor_start(sht3x_handle);启动之后传感器发出SENSOR_STARTED事件随后以设定周期持续采集并逐个发出SENSOR_XXXX_DATA_READY数据就绪事件。事件回调通过event_data参数sensor_data_t*类型获取每个事件的具体数据。从源码看iot_sensor_hub.ciot_sensor_start在轮询模式下调用xTimerStart启动 FreeRTOS 定时器定时器回调通过事件组EventGroup置位对应 bit默认采集任务sensor_default_task等待事件组位后调用impl-acquire()采集数据填充sensor_data_group_t并逐条 post 数据就绪事件sensor_default_task。采集任务与事件循环在创建首个传感器时自动创建。第五步停止传感器iot_sensor_stop(sht3x_handle);iot_sensor_stop可临时关闭指定传感器关闭后发出SENSOR_STOPED事件采集工作停止如果驱动支持电源管理传感器将被设置为睡眠模式内部调用COMMAND_SET_POWERPOWER_MODE_SLEEP不支持时跳过见 iot_sensor_hub.c。第六步取消注册事件回调用户程序可在任意时刻使用回调实例句柄取消事件注册之后该回调不再被调用。对应两种方式iot_sensor_handler_unregister(handle, instance)通过传感器句柄取消iot_sensor_handler_unregister_with_type(type, event_id, instance)通过传感器类型取消。第七步删除传感器iot_sensor_delete(sht3x_handle);iot_sensor_delete删除传感器并释放已分配的内存等资源。从源码看iot_sensor_hub.c删除流程包括删除定时器/移除中断 → 从链表移除节点 → 驱动进入睡眠并调用impl-remove()释放驱动 → 释放内存若系统中已无传感器还会发送事件组终止位、回收默认采集任务、删除事件组与互斥锁并注销默认事件处理器。事件体系与数据分发Sensor Hub 的事件循环基于 ESP-IDF 的 esp_event 库封装sensor_event.h提供sensors_event_loop_create/delete、sensors_event_handler_instance_register/unregister、sensors_event_post等接口并支持 ISR 上下文发布sensors_event_isr_post需使能CONFIG_ESP_EVENT_POST_FROM_ISR。事件 ID 一览通用事件sensor_type.h事件值说明SENSOR_STARTED0传感器启动SENSOR_STOPED1传感器停止数据就绪事件从值 10 开始sensor_type.h事件含义数据成员SENSOR_ACCE_DATA_READY加速度数据就绪acce单位 GSENSOR_GYRO_DATA_READY陀螺仪数据就绪gyro单位 dpsSENSOR_MAG_DATA_READY磁力计数据就绪mag单位 GaussSENSOR_TEMP_DATA_READY温度数据就绪temperature单位 0.01℃SENSOR_HUMI_DATA_READY湿度数据就绪humidity单位 %SENSOR_BARO_DATA_READY气压数据就绪baro单位 PaSENSOR_LIGHT_DATA_READY光照数据就绪light单位 luxSENSOR_RGBW_DATA_READY颜色数据就绪rgbwSENSOR_UV_DATA_READY紫外线数据就绪uvSENSOR_PROXI_DATA_READY距离数据就绪proximity单位 cmSENSOR_HR_DATA_READY心率数据就绪hrSENSOR_TVOC_DATA_READYTVOC 数据就绪tvocSENSOR_NOISE_DATA_READY噪声数据就绪noiseSENSOR_STEP_DATA_READY计步数据就绪stepSENSOR_FORCE_DATA_READY压力数据就绪forceSENSOR_CURRENT_DATA_READY电流数据就绪currentSENSOR_VOLTAGE_DATA_READY电压数据就绪voltage内置默认处理器若使能CONFIG_SENSOR_DEFAULT_HANDLER或CONFIG_SENSOR_DEFAULT_HANDLER_DATASensor Hub 会在创建传感器时自动注册一个默认事件处理器将所有传感器事件含数据打印到日志便于调试实现见 iot_sensor_hub.c。可配置项KconfigSensor Hub 通过 Kconfig.projbuild 暴露如下配置项Sensor 构建选项配置项默认值说明SENSOR_INCLUDED_IMUy是否将 IMU 驱动编入 Sensor HubSENSOR_INCLUDED_HUMITUREy是否将温湿度驱动编入SENSOR_INCLUDED_LIGHTy是否将光照驱动编入采集任务选项配置项默认值说明SENSOR_TASK_PRIORITY_INHERITy采集任务优先级继承父任务SENSOR_TASK_PRIORITY4采集任务优先级关闭继承时生效SENSOR_TASK_STACK_SIZE4096采集任务栈大小字节事件循环选项配置项默认值说明SENSORS_EVENT_TASK_PRIORITY_INHERITy事件循环任务优先级继承SENSORS_EVENT_TASK_PRIORITY5事件循环任务优先级关闭继承时生效SENSOR_EVENT_LOOP_AUTOy自动创建传感器事件循环SENSORS_EVENT_QUEUE_SIZE32事件队列长度SENSORS_EVENT_STACK_SIZE4096事件循环任务栈大小SENSOR_DEFAULT_HANDLERn使能默认事件处理器打印状态SENSOR_DEFAULT_HANDLER_DATAn默认处理器打印数据依赖上一项示例程序仓库提供了两个可直接运行的 Sensor Hub 示例温湿度传感器控制 LED 开关示例演示温湿度事件驱动 LED 开关——温度或湿度越过阈值时通过事件回调控制 LED是事件回调 业务联动的最小闭环范例。传感器监测示例演示同时管理多类传感器并统一监测、上报数据适合作为环境感知类产品的骨架。此外组件测试应用 中的virtual_humiture_sensor.c、virtual_imu_sensor.c、virtual_light_sensor.c展示了完整的虚拟传感器注册流程sensor_hub_test.c则覆盖了创建、启动、事件接收、停止、删除的完整生命周期可作为驱动开发与功能验证的参考。API 参考速查API功能iot_sensor_create按名称与配置创建传感器实例iot_sensor_start启动采集发出SENSOR_STARTED事件iot_sensor_stop停止采集发出SENSOR_STOPED事件iot_sensor_delete删除传感器并释放资源iot_sensor_scan扫描注册到 Sensor Hub 的有效驱动数量iot_sensor_handler_register按传感器句柄注册事件回调iot_sensor_handler_unregister按传感器句柄取消事件回调iot_sensor_handler_register_with_type按传感器类型注册事件回调iot_sensor_handler_unregister_with_type按传感器类型取消事件回调完整签名与返回值说明见 iot_sensor_hub.h。小结Sensor Hub 通过链接器段自动注册驱动 统一 HAL 接口 esp_event 事件分发三个设计将传感器开发从面向寄存器的驱动编写提升为面向事件的业务组装驱动开发者只需实现impl结构体并调用SENSOR_HUB_DETECT_FN注册应用开发者只需create → register → start → stop → delete五步即可完成传感器的完整生命周期管理。对于需要同时接入多类传感器、追求代码复用与运行效率的物联网产品Sensor Hub 是一个开箱即用的基础组件。赞分享物联网嵌入式驱动开发硬件开发【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址https://gitcode.com/GitHub_Trending/es/esp-iot-solution点击查看免费下载相关推荐esp-iot-solution Sensor Hub 组件实战传感器硬件抽象、设备管理与事件分发完整指南esp iot solution Sensor Hub 组件实战传感器硬件抽象、设备管理与事件分发完整指南 导读 Sensor Hub 是 esp iot s物联网嵌入式驱动开发硬件开发esp-iot-solution 温湿度传感器驱动指南HDC2010 / HTS221 / SHT3X / MVH3004D 与 Sensor Hub 集成实战esp iot solution 温湿度传感器驱动指南HDC2010 / HTS221 / SHT3X / MVH3004D 与 Sensor Hub 集成实物联网嵌入式驱动开发硬件开发ESP-IoT-Solution 传感器驱动库支持的芯片清单、HAL 架构与 Sensor Hub 用法详解ESP IoT Solution 传感器驱动库支持的芯片清单、HAL 架构与 Sensor Hub 用法详解 在 Espressif IoT 解决方案库es物联网嵌入式驱动开发硬件开发创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
ESP IoT Solution Sensor Hub 深度指南：统一传感器管理框架的架构、驱动注册与事件分发实战
物联网嵌入式驱动开发硬件开发【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址https://gitcode.com/GitHub_Trending/es/esp-iot-solution点击查看免费下载本文以 esp-iot-solution 仓库中的 Sensor Hub 官方文档 为主体结合 sensor_hub 组件源码 展开。Sensor Hub 是 Espressif IoT 方案中负责传感器硬件抽象、设备管理与数据分发的核心组件。读完本文你将掌握 Sensor Hub 的三层架构、基于链接器段的驱动自动注册机制、事件驱动的数据分发模型并能够独立完成驱动注册与应用开发两条开发路径的完整实操。引言为什么要用 Sensor Hub在 ESP32 系列嵌入式应用中接入传感器传统做法是为每个传感器编写独立的初始化、读取与调度代码。当项目中同时存在温湿度、IMU、光照等多个传感器时这种每传感器一套逻辑的方式会导致代码重复、调度混乱、总线管理各自为政。Sensor Hub 的核心价值在于集中管理它将传感器驱动以组件方式注册到统一框架中由框架统一负责传感器实例管理、采集调度与事件分发。应用开发者无需关心传感器底层寄存器操作只需做三件事——选择传感器、配置采集方式、注册事件回调。从源码结构看Sensor Hub 组件components/sensors/sensor_hub/由以下几个关键部分组成iot_sensor_hub.c/iot_sensor_hub.h核心管理逻辑与对外 APIsensor_type.h传感器类型、模式、量程、数据结构的统一定义sensor_event.h/sensors_event.c基于 esp_event 的事件循环封装hal/目录三类传感器 HAL 抽象层温湿度、IMU、光照linker.lf链接器段定义用于驱动自动注册。Sensor Hub 编程模型官方文档给出了 Sensor Hub 的编程模型示意图从图中可以看出Sensor Hub 位于应用与传感器驱动之间形成应用 → Sensor Hub → 驱动 → 硬件的分层结构。该组件支持以组件方式加载传感器驱动用户添加传感器时只需填入注册到 Sensor Hub 的传感器名称即可直接获取对应驱动。由于实现了对传感器的集中管理Sensor Hub 在简化操作的同时也提高了运行效率可作为传感器应用的基础组件应用于环境感知、运动感知、健康管理等智能化场景。驱动层的组织方式如下图所示三类传感器类型Sensor Hub 当前抽象了三种传感器类型定义于 sensor_type.h类型枚举含义覆盖的数据HUMITURE_ID温湿度传感器温度、湿度IMU_ID惯性测量单元加速度、陀螺仪、磁力计LIGHT_SENSOR_ID光照传感器环境光照度、RGBW 颜色、UV 紫外线每种类型对应一个 HAL 实现接口humiture_impl_t、imu_impl_t、light_impl_t定义于 hal/ 目录。以温湿度为例humiture_hal.h 中的humiture_impl_t包含init、deinit、test、acquire_humidity、acquire_temperature、sleep、wakeup、set_mode、set_range等函数指针——这就是驱动开发者需要实现的全部接口。统一的数据结构Sensor Hub 用sensor_data_t统一承载所有类型的采集数据sensor_type.htypedef struct { int64_t timestamp; /*! timestamp */ const char* sensor_name; /*! sensor name */ sensor_type_t sensor_type; /*! sensor type */ uint8_t sensor_addr; /*! sensor addr */ int32_t event_id; /*! reserved for future use */ uint32_t min_delay; /*! minimum delay between two events, unit: ms */ union { axis3_t acce; /*! Accelerometer. unit: G */ axis3_t gyro; /*! Gyroscope. unit: dps */ axis3_t mag; /*! Magnetometer. unit: Gauss */ float temperature; /*! Temperature. unit: dCelsius */ float humidity; /*! Relative humidity. unit: percentage */ ... float data[4]; /*! for general use */ }; } sensor_data_t;该结构体使用 union 容纳所有传感器数据类型三维数据用axis3_tx/y/z 浮点联合颜色用rgbw_t紫外线用uv_t。每个数据都带时间戳、传感器名称、类型、地址等元信息应用层可以据此追溯数据来源。驱动注册机制链接器段自动发现Sensor Hub 采用链接器脚本生成机制ESP-IDF 的 linker script generation 功能将传感器驱动注册到特定目标文件段中。对应用开发者而言无需关注驱动具体实现只需添加对应传感器组件即可自动加载驱动。链接器段定义linker.lf 定义了名为sensors_detect的段[sections:sensors_detect] entries: .sensor_hub_detect_fn [mapping:sensors_detect] archive: * entries: * (sensors_detect_default); sensors_detect - flash_rodata KEEP() ALIGN(4, pre, post) SURROUND(_sensor_hub_detect_fn_array)该段被SURROUND(_sensor_hub_detect_fn_array)包裹生成__sensor_hub_detect_fn_array_start与__sensor_hub_detect_fn_array_end两个边界符号。所有驱动通过SENSOR_HUB_DETECT_FN宏放入此段运行时即可遍历该段完成驱动发现。从源码看iot_sensor_hub.c 中的iot_sensor_scan()正是遍历这段地址区间来扫描可用驱动int iot_sensor_scan() { int sensor_count 0; // search the sensor driver from a specific segment for (sensor_hub_detect_fn_t *p __sensor_hub_detect_fn_array_start; p __sensor_hub_detect_fn_array_end; p) { sensor_info_t info; sensor_device_impl_t sensor_device_impl (*(p-fn))(info); if (sensor_device_impl ! NULL) { ESP_LOGI(TAG, Find %s driver, type: %s, info.name, SENSOR_TYPE_STRING[info.sensor_type]); sensor_count; } } return sensor_count; }注册宏 SENSOR_HUB_DETECT_FN宏定义于 iot_sensor_hub.h#define SENSOR_HUB_DETECT_FN(type_id, name_id, impl) \ static void* __sensor_hub_detect_fn_##name_id(sensor_info_t *sensor_info); \ __attribute__((used)) _SECTION_ATTR_IMPL(.sensor_hub_detect_fn, __COUNTER__) \ sensor_hub_detect_fn_t sensor_hub_detect_fn_##name_id { \ .fn __sensor_hub_detect_fn_##name_id, \ }; \ static void* __sensor_hub_detect_fn_##name_id(sensor_info_t *sensor_info) { \ sensor_info-name #name_id; \ sensor_info-sensor_type type_id; \ return impl; \ }宏将检测函数放入.sensor_hub_detect_fn段并注入sensor_info-name取name_id的字符串化与sensor_info-sensor_type。注意为防止链接器优化掉驱动驱动必须至少包含一个被显式引用的未定义符号——这正是驱动 CMakeLists 中-u symbol参数的作用。驱动开发指南注册一个新传感器第一步实现驱动接口以 SHT3X 温湿度传感器为例此例取自官方文档驱动开发者需将与传感器相关的操作填入humiture_impl_t结构体static humiture_impl_t sht3x_impl { .init humiture_sht3x_init, .deinit humiture_sht3x_deinit, .test humiture_sht3x_test, .acquire_humidity humiture_sht3x_acquire_humidity, .acquire_temperature humiture_sht3x_acquire_temperature, };第二步调用注册宏SENSOR_HUB_DETECT_FN(HUMITURE_ID, sht3x, sht3x_impl);对于 IMU 传感器注册方式完全一致例如测试代码中注册的虚拟 MPU6050test_apps 中的virtual_imu_sensor.cstatic imu_impl_t virtual_mpu6050_impl { .init virtual_imu_init, .deinit virtual_imu_deinit, .test virtual_imu_test, .acquire_acce virtual_imu_acquire_acce, .acquire_gyro virtual_imu_acquire_gyro, }; SENSOR_HUB_DETECT_FN(IMU_ID, virtual_mpu6050, virtual_mpu6050_impl);第三步在 CMakeLists.txt 中添加接口依赖为了确保驱动符号不被链接器丢弃需在组件CMakeLists.txt中加入未定义符号引用target_link_libraries(${COMPONENT_LIB} INTERFACE -u humiture_sht3x_init)-u选项强制链接器保留指定符号从而将整个驱动对象拉入最终固件。sensor_hub 的 test_apps 提供了虚拟传感器的注册范例可作为编写自有驱动的参考。底层如何调用驱动从 iot_sensor_hub.c 可以看到Sensor Hub 内部为三类传感器维护了一个实现表s_sensor_impls[]每个条目含create、remove、acquire、control四个函数指针对应 HAL 层暴露的humiture_create、humiture_acquire、humiture_control等 API。iot_sensor_create通过sensor_find_impl()按config-type查找对应实现再依次调用impl-create(bus, name, addr)创建驱动实例impl-control(driver, COMMAND_SET_MODE, mode)设置工作模式不支持时返回ESP_ERR_NOT_SUPPORTED被跳过impl-control(driver, COMMAND_SET_RANGE, range)设置量程impl-control(driver, COMMAND_SET_ODR, min_delay)设置输出频率impl-control(driver, COMMAND_SELF_TEST, NULL)自检——此步不可跳过失败则整个创建流程回滚。创建成功后传感器会被加入一个基于单向链表_iot_sensor_slist_t以互斥锁保护的管理列表中。应用开发指南七步使用 Sensor Hub第一步添加组件依赖在工程的idf_component.yml中添加sensor_hub与所需传感器组件也可以在工程目录执行组件管理器命令idf.py add-dependency espressif/sensor_hub*CMake 阶段组件会被自动下载。官方 READMEcomponents/sensors/sensor_hub/README.md给出了同样说明。第二步创建传感器实例使用iot_sensor_create创建实例参数包括传感器名称、传感器配置项和传感器句柄指针sensor_config_t sht3x_config { .bus i2c0_bus_handle, .addr 0x44, .mode MODE_POLLING, .min_delay SENSOR_PERIOD, }; iot_sensor_create(sht3x, sht3x_config, sht3x_handle)sensor_config_t各字段含义iot_sensor_hub.h字段类型说明busbus_handle_t传感器挂载的总线句柄i2c/spiaddruint8_t传感器 I2C 地址typesensor_type_t传感器类型modesensor_mode_t工作模式rangesensor_range_t测量量程min_delayuint32_t最小采集间隔msintr_pin/intr_typeint中断引脚与中断类型中断模式下使用其中bus、addr、type、mode、min_delay为关键必填项其余为非必须项。传感器名称用于查找加载注册到 Sensor Hub 中的驱动若传感器支持地址可配置则可以多次创建同名传感器每个实例内部会以sensor_name_addr格式生成独立的事件基见 iot_sensor_hub.c。支持的工作模式sensor_type.hMODE_DEFAULT默认模式MODE_POLLING轮询模式按min_delay间隔周期性采集MODE_INTERRUPT中断模式GPIO 中断到来时采集需配置intr_pin/intr_type。第三步注册事件回调传感器事件发生时回调函数将被依次调用。注册有两种方式成功后返回事件回调函数实例句柄iot_sensor_handler_register(handle, handler, instance)通过传感器句柄注册监听该传感器全部事件内部使用ESP_EVENT_ANY_ID注册到该传感器的事件基上iot_sensor_handler_register_with_type(type, event_id, handler, instance)通过传感器类型注册只关心事件类型而不关心由谁发出内部映射到SENSOR_HUMITURE_EVENTS/SENSOR_IMU_EVENTS/SENSOR_LIGHTSENSOR_EVENTS等全局事件基。事件回调函数原型为void (*sensor_event_handler_t)(void *event_handler_arg, sensor_event_base_t event_base, int32_t event_id, void *event_data);第四步启动传感器iot_sensor_start(sht3x_handle);启动之后传感器发出SENSOR_STARTED事件随后以设定周期持续采集并逐个发出SENSOR_XXXX_DATA_READY数据就绪事件。事件回调通过event_data参数sensor_data_t*类型获取每个事件的具体数据。从源码看iot_sensor_hub.ciot_sensor_start在轮询模式下调用xTimerStart启动 FreeRTOS 定时器定时器回调通过事件组EventGroup置位对应 bit默认采集任务sensor_default_task等待事件组位后调用impl-acquire()采集数据填充sensor_data_group_t并逐条 post 数据就绪事件sensor_default_task。采集任务与事件循环在创建首个传感器时自动创建。第五步停止传感器iot_sensor_stop(sht3x_handle);iot_sensor_stop可临时关闭指定传感器关闭后发出SENSOR_STOPED事件采集工作停止如果驱动支持电源管理传感器将被设置为睡眠模式内部调用COMMAND_SET_POWERPOWER_MODE_SLEEP不支持时跳过见 iot_sensor_hub.c。第六步取消注册事件回调用户程序可在任意时刻使用回调实例句柄取消事件注册之后该回调不再被调用。对应两种方式iot_sensor_handler_unregister(handle, instance)通过传感器句柄取消iot_sensor_handler_unregister_with_type(type, event_id, instance)通过传感器类型取消。第七步删除传感器iot_sensor_delete(sht3x_handle);iot_sensor_delete删除传感器并释放已分配的内存等资源。从源码看iot_sensor_hub.c删除流程包括删除定时器/移除中断 → 从链表移除节点 → 驱动进入睡眠并调用impl-remove()释放驱动 → 释放内存若系统中已无传感器还会发送事件组终止位、回收默认采集任务、删除事件组与互斥锁并注销默认事件处理器。事件体系与数据分发Sensor Hub 的事件循环基于 ESP-IDF 的 esp_event 库封装sensor_event.h提供sensors_event_loop_create/delete、sensors_event_handler_instance_register/unregister、sensors_event_post等接口并支持 ISR 上下文发布sensors_event_isr_post需使能CONFIG_ESP_EVENT_POST_FROM_ISR。事件 ID 一览通用事件sensor_type.h事件值说明SENSOR_STARTED0传感器启动SENSOR_STOPED1传感器停止数据就绪事件从值 10 开始sensor_type.h事件含义数据成员SENSOR_ACCE_DATA_READY加速度数据就绪acce单位 GSENSOR_GYRO_DATA_READY陀螺仪数据就绪gyro单位 dpsSENSOR_MAG_DATA_READY磁力计数据就绪mag单位 GaussSENSOR_TEMP_DATA_READY温度数据就绪temperature单位 0.01℃SENSOR_HUMI_DATA_READY湿度数据就绪humidity单位 %SENSOR_BARO_DATA_READY气压数据就绪baro单位 PaSENSOR_LIGHT_DATA_READY光照数据就绪light单位 luxSENSOR_RGBW_DATA_READY颜色数据就绪rgbwSENSOR_UV_DATA_READY紫外线数据就绪uvSENSOR_PROXI_DATA_READY距离数据就绪proximity单位 cmSENSOR_HR_DATA_READY心率数据就绪hrSENSOR_TVOC_DATA_READYTVOC 数据就绪tvocSENSOR_NOISE_DATA_READY噪声数据就绪noiseSENSOR_STEP_DATA_READY计步数据就绪stepSENSOR_FORCE_DATA_READY压力数据就绪forceSENSOR_CURRENT_DATA_READY电流数据就绪currentSENSOR_VOLTAGE_DATA_READY电压数据就绪voltage内置默认处理器若使能CONFIG_SENSOR_DEFAULT_HANDLER或CONFIG_SENSOR_DEFAULT_HANDLER_DATASensor Hub 会在创建传感器时自动注册一个默认事件处理器将所有传感器事件含数据打印到日志便于调试实现见 iot_sensor_hub.c。可配置项KconfigSensor Hub 通过 Kconfig.projbuild 暴露如下配置项Sensor 构建选项配置项默认值说明SENSOR_INCLUDED_IMUy是否将 IMU 驱动编入 Sensor HubSENSOR_INCLUDED_HUMITUREy是否将温湿度驱动编入SENSOR_INCLUDED_LIGHTy是否将光照驱动编入采集任务选项配置项默认值说明SENSOR_TASK_PRIORITY_INHERITy采集任务优先级继承父任务SENSOR_TASK_PRIORITY4采集任务优先级关闭继承时生效SENSOR_TASK_STACK_SIZE4096采集任务栈大小字节事件循环选项配置项默认值说明SENSORS_EVENT_TASK_PRIORITY_INHERITy事件循环任务优先级继承SENSORS_EVENT_TASK_PRIORITY5事件循环任务优先级关闭继承时生效SENSOR_EVENT_LOOP_AUTOy自动创建传感器事件循环SENSORS_EVENT_QUEUE_SIZE32事件队列长度SENSORS_EVENT_STACK_SIZE4096事件循环任务栈大小SENSOR_DEFAULT_HANDLERn使能默认事件处理器打印状态SENSOR_DEFAULT_HANDLER_DATAn默认处理器打印数据依赖上一项示例程序仓库提供了两个可直接运行的 Sensor Hub 示例温湿度传感器控制 LED 开关示例演示温湿度事件驱动 LED 开关——温度或湿度越过阈值时通过事件回调控制 LED是事件回调 业务联动的最小闭环范例。传感器监测示例演示同时管理多类传感器并统一监测、上报数据适合作为环境感知类产品的骨架。此外组件测试应用 中的virtual_humiture_sensor.c、virtual_imu_sensor.c、virtual_light_sensor.c展示了完整的虚拟传感器注册流程sensor_hub_test.c则覆盖了创建、启动、事件接收、停止、删除的完整生命周期可作为驱动开发与功能验证的参考。API 参考速查API功能iot_sensor_create按名称与配置创建传感器实例iot_sensor_start启动采集发出SENSOR_STARTED事件iot_sensor_stop停止采集发出SENSOR_STOPED事件iot_sensor_delete删除传感器并释放资源iot_sensor_scan扫描注册到 Sensor Hub 的有效驱动数量iot_sensor_handler_register按传感器句柄注册事件回调iot_sensor_handler_unregister按传感器句柄取消事件回调iot_sensor_handler_register_with_type按传感器类型注册事件回调iot_sensor_handler_unregister_with_type按传感器类型取消事件回调完整签名与返回值说明见 iot_sensor_hub.h。小结Sensor Hub 通过链接器段自动注册驱动 统一 HAL 接口 esp_event 事件分发三个设计将传感器开发从面向寄存器的驱动编写提升为面向事件的业务组装驱动开发者只需实现impl结构体并调用SENSOR_HUB_DETECT_FN注册应用开发者只需create → register → start → stop → delete五步即可完成传感器的完整生命周期管理。对于需要同时接入多类传感器、追求代码复用与运行效率的物联网产品Sensor Hub 是一个开箱即用的基础组件。赞分享物联网嵌入式驱动开发硬件开发【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址https://gitcode.com/GitHub_Trending/es/esp-iot-solution点击查看免费下载相关推荐esp-iot-solution Sensor Hub 组件实战传感器硬件抽象、设备管理与事件分发完整指南esp iot solution Sensor Hub 组件实战传感器硬件抽象、设备管理与事件分发完整指南 导读 Sensor Hub 是 esp iot s物联网嵌入式驱动开发硬件开发esp-iot-solution 温湿度传感器驱动指南HDC2010 / HTS221 / SHT3X / MVH3004D 与 Sensor Hub 集成实战esp iot solution 温湿度传感器驱动指南HDC2010 / HTS221 / SHT3X / MVH3004D 与 Sensor Hub 集成实物联网嵌入式驱动开发硬件开发ESP-IoT-Solution 传感器驱动库支持的芯片清单、HAL 架构与 Sensor Hub 用法详解ESP IoT Solution 传感器驱动库支持的芯片清单、HAL 架构与 Sensor Hub 用法详解 在 Espressif IoT 解决方案库es物联网嵌入式驱动开发硬件开发创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考