deCONZ-REST-Plugin 中 Nodon 温湿度传感器 STPH-4-1-00 的集成解析

本文将详细介绍如何在 deCONZ-REST-Plugin 项目中实现对 Nodon STPH-4-1-00 温湿度传感器的支持。该传感器是一款 Zigbee 无线设备，能够同时测量环境温度和湿度，并具备低功耗特性。

设备概述

Nodon STPH-4-1-00 是一款多功能环境传感器，主要特性包括：

• 支持 Zigbee 无线通信协议
• 同时测量温度和湿度
• 低功耗设计（Sleeper 设备）
• 采用标准 Zigbee 集群通信

技术实现细节

设备端点与集群分析

通过设备信息抓取，我们可以看到该传感器使用了以下关键集群：

• 基础集群（Basic Cluster）
• 电源配置集群（Power Configuration Cluster）
• 温度测量集群（Temperature Measurement Cluster）
• 湿度测量集群（Relative Humidity Measurement Cluster）

设备描述文件（DDF）设计

针对该设备，我们设计了一个包含两个子设备的 DDF 结构：

1. 温度传感器子设备

   • 使用标准温度传感器类型（$TYPE_TEMPERATURE_SENSOR）
   • 包含电池电量监测功能（通过电源配置集群）
   • 配置了温度值的报告机制

2. 湿度传感器子设备

   • 使用标准湿度传感器类型（$TYPE_HUMIDITY_SENSOR）
   • 同样包含电池电量监测
   • 配置了湿度值的报告机制

关键配置参数

• 电池电量计算：通过解析电源配置集群的属性值（0x0021），将原始值除以2得到百分比
• 报告间隔：配置了合理的报告间隔（60-300秒）和变化阈值（0x64）
• 唤醒机制：标记为 Sleeper 设备，仅在需要通信时唤醒

实现验证

经过实际测试验证：

• 温度和湿度数据能够正确采集并上报
• 电池电量监测功能工作正常
• 设备能够稳定保持网络连接
• 数据更新间隔符合预期

技术要点总结

1. 对于多功能传感器设备，采用多子设备的设计模式更为合理
2. 电池供电设备需要特别注意报告间隔的配置以平衡数据及时性和功耗
3. 标准 Zigbee 集群的实现使得设备集成相对简单
4. 电池电量计算可能需要特定转换公式（本例中为原始值除以2）

该设备的成功集成进一步丰富了 deCONZ 生态系统中的环境传感器选择，为用户提供了更多可靠的智能家居环境监测解决方案。