zigbee_home传感器类型大盘点12种传感器配置快速参考指南【免费下载链接】zigbee_homeProject to provide functionality similar to ESPHome but for Zigbee instead of WiFi for nRF52, nRF53 nRF54L项目地址: https://gitcode.com/gh_mirrors/zi/zigbee_home如果你正在为 nRF52、nRF53 或 nRF54L 系列芯片寻找一套开箱即用的Zigbee 智能家居传感器解决方案那么 zigbee_home 绝对值得一看。这个开源项目提供了类似 ESPHome 的使用体验但把通信协议从 WiFi 换成了功耗更低、更稳定的 Zigbee。本文为你盘点 zigbee_home 目前支持的12 种传感器类型并附上每种传感器的快速配置参考帮助新手快速定位自己需要的传感器并完成配置。上图是一个基于 nRF52840 的 DC 电源开关与电流监测布局示例展示了传感器与开发板的实际接线方式完整说明见 examples/board_dc_power_switch/README.md。一、12种传感器类型总览一张表看懂zigbee_home 的传感器配置统一写在项目根目录的zigbee.yaml配置文件中通过type字段声明传感器类型。全部 12 种类型如下表类型名称传感器测量内容接口对应 ZCL Clusterbme280Bosch BME280温度、湿度、气压I2CTemperature / Humidity / Pressurebme680Bosch BME680温度、湿度、气压、气体I2C同上scd4xSensirion SCD41CO₂ 浓度I2CCarbon DioxidedhtAosong DHT11 / DHT22 / AM2302温度、湿度GPIOTemperature / Humidityon_off通用开关开/关控制GPIOOn/Offcontact门窗传感器开合状态GPIOIAS Zone接触型ias_zone通用入侵报警传感器状态变化GPIOIAS Zonerotary_encoder旋转编码器旋转步数GPIOLevel Controlpower_config电池电量监测电压、电量百分比ADCPower Configurationsoil_moisture_adc土壤湿度土壤湿度0-100%ADCSoil Moistureina2xxTI INA219 等电流、电压、功率I2CElectrical Measurementdevice_temperature芯片内部温度设备温度内置Device Temperature传感器类型的注册定义位于 types/sensor/known.go每个传感器的完整实现可以在 sensor/ 目录下找到对应源码。二、环境类传感器温湿度、气压与 CO₂这类传感器是智能家居中最常用的zigbee_home 一共支持 4 种。1. BME280 与 BME680温湿度气压一体传感器 BME280 是博世出品的经典环境传感器一颗芯片搞定温度、湿度和气压BME680 在此基础上增加了气体传感器可用于空气质量粗略判断。两者都走 I2C 接口默认地址为0x76。参考 examples/sensor_bme280/zigbee.yaml 的配置sensors: - type: bme280 i2c: id: i2c0 addr: 0x762. SCD4x室内 CO₂ 浓度监测 SCD4x如 SCD41来自 Sensirion是目前性价比很高的 CO₂ 传感器适合做空气质量检测设备。它同样通过 I2C 接入上报到 Zigbee 的 Carbon Dioxide clusterHome Assistant 可以直接读取。3. DHT11 / DHT22 / AM2302低成本温湿度之选如果你手头有经典的 DHT 系列传感器zigbee_home 也直接支持源码见 sensor/aosong/dht.go。它通过单根 GPIO 引脚通信适合低成本 DIY 项目不过精度和响应速度不如 BME 系列。三、输入与控制类传感器开关、门磁与旋钮4. on_off把普通按键变成 Zigbee 开关 on_off类型适合做智能插座、灯光开关等场景你可以把它理解为一个受 Home Assistant 控制的物理开关。它甚至支持control_button参数实现设备本地手动开关和云端控制双通道。参考 examples/basic/zigbee.yamlsensors: - type: on_off pin: 0.135. contact最简单的门窗传感器contact本质上是 IAS Zone 的接触型封装只需要指定一个按钮引脚即可参考 examples/contact/zigbee.yamlboard: buttons: - id: button0 sensors: - type: contact button: button06. ias_zone通用的入侵报警传感器ias_zone是 IAS Zone cluster 的通用实现目前默认作为接触传感器使用但保留了扩展为更多报警类型的可能性适合需要自定义报警场景的高级用户。7. rotary_encoder旋钮调光、调音量旋转编码器可以为灯光提供亮度调节Level Control cluster也可以用于音量等连续值的控制。它支持resolution每次上报的脉冲数和sample_time采样间隔等调参项具体实现见 sensor/base/rotary_encoder.go。四、监测类传感器电量、土壤湿度与电流8. power_config电池供电设备的电量管家 做 Zigbee 电池设备时power_config可以让你把电池电压上报给 Home Assistant配合battery_rated_voltage、battery_voltage_min_threshold等参数实现电量百分比显示非常适合温湿度传感器这类电池供电设备。9. soil_moisture_adc盆栽植物浇水提醒 通过 ADC 引脚读取土壤湿度传感器的模拟电压映射为 0-100% 湿度上报配置时只需指定adc_pin、min_moisture_mv和max_moisture_mv三个参数。10. ina2xx电流电压功率监测基于 TI INA219 等电流检测芯片通过 I2C 接入上报到 Electrical Measurement cluster适合做智能插座、功率统计类设备。开头图片中的 DC 电源开关示例就是它的典型应用。11. device_temperature零外设的设备温度利用 nRF52 芯片内置温度传感器CONFIG_NRFX_TEMP上报设备自身温度不需要任何外部硬件做设备过热告警非常方便。五、从零开始的配置流程最快上手方法在项目根目录打开zigbee.yaml参照官方示例 zigbee.yaml 或 examples/ 目录下的任一模板按上面的表格选择type补齐对应的引脚或 I2C 参数按官方文档 docs/sensors/supported_sensors.md 与 docs/using_the_cli/building_the_firmware.md 构建固件并烧录在 Home Assistant 中添加 Zigbee 设备即可自动发现。六、总结以上就是 zigbee_home 目前支持的12 种传感器类型完整盘点。从基础的温湿度、CO₂到门磁、旋钮、电量与电流监测覆盖面已经相当齐全而且全部通过一个zigbee.yaml文件集中管理配置体验与 ESPHome 一脉相承。选好传感器、对照本文的配置参考你就能快速构建属于自己的 Zigbee 智能家居设备了。【免费下载链接】zigbee_homeProject to provide functionality similar to ESPHome but for Zigbee instead of WiFi for nRF52, nRF53 nRF54L项目地址: https://gitcode.com/gh_mirrors/zi/zigbee_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考