deCONZ项目中的icasa Zigbee Dimmer Pro设备支持分析

设备概述

icasa Zigbee Dimmer Pro（型号ICZB-IW21D）是一款支持Zigbee协议的智能调光器设备，作为ICZB-IW11D的升级版本，新增了功率和能耗测量功能。该设备采用浅蓝色外壳设计，属于Sunricher OEM产品系列。

技术特性

硬件规格

• 制造商：icasa
• 型号标识符：ICZB-IW21D
• 设备类型：可调光开关
• 最大功率：400W（推测值）

通信协议

• 基于Zigbee协议
• 支持OTA固件升级
• 固件版本：2.9.2_r58

功能特性

基础功能

1. 开关控制功能
2. 亮度调节功能
3. 多种灯光效果支持

增强功能

1. 能耗测量（新增功能）
2. 功率测量（新增功能）
3. 电压/电流监测

技术实现细节

Zigbee集群支持

设备支持以下关键Zigbee集群：

1. 基础集群（Basic Cluster）
2. 开关控制集群（On/Off Cluster）
3. 亮度控制集群（Level Control Cluster）
4. 简单计量集群（Simple Metering Cluster）
5. 电力测量集群（Electrical Measurement Cluster）
6. OTA升级集群（OTAU Cluster）

特殊功能实现

1. 支持多种灯光效果命令：

   • 触发效果（Trigger Effect）
   • 带效果的关闭（Off with Effect）
   • 移动到指定亮度（带开关控制）

2. 支持多种属性配置：

   • 关闭状态下执行（Execute If Off）
   • 开关过渡时间（On/Off Transition Time）
   • 开机亮度（On Level）
   • 电源恢复行为（PowerOn OnOff/PowerOn Level）

能耗测量实现

设备提供了精确的能耗测量功能，具体实现如下：

1. 累计能耗（Current Summation Delivered）：

   • 单位：瓦秒（Ws）
   • 转换为Wh需要除以3600

2. 电压测量（RMS Voltage）：

   • 单位：0.1V
   • 转换为V需要除以10

3. 电流测量（RMS Current）：

   • 单位：毫安（mA）
   • 可直接使用

4. 有功功率（Active Power）：

   • 单位：0.1W
   • 转换为W需要除以10

已知问题与注意事项

1. 设备关闭状态下仍会报告1.3V电压和17mA电流值，这可能是设备自耗电或测量基准值。

2. 与早期版本（如ICZB-IW11D）相比，新版本在功能上有所增强，但可能存在固件差异（如r54与r58版本）。

3. 该设备与Robbshop销售的同类产品可能存在兼容性，但具体实现可能因固件版本而略有不同。

应用场景建议

1. 家庭智能照明系统
2. 商业场所灯光控制
3. 能耗监测与管理场景

开发者注意事项

1. 在实现设备控制时，应注意处理设备关闭状态下的异常测量值。

2. 对于能耗数据的处理需要考虑单位转换问题。

3. 设备支持丰富的灯光效果命令，可以为用户提供更好的交互体验。

4. 在开发兼容性功能时，应注意不同固件版本可能存在的差异。