deCONZ项目中的Zemismart Tuya三相电能表设备支持分析

设备概述

Zemismart Tuya Zigbee三相电能表(型号SPM02-D2TZ)是一款基于Tuya平台的智能电能监测设备，能够测量三相电路中的电压、电流、功率、功率因数等电气参数。该设备通过Zigbee 3.0协议与网关通信，但在原生deCONZ支持中存在一些问题。

技术背景

该设备采用了Tuya特有的通信协议而非标准的Zigbee集群。与大多数Zigbee设备不同，它没有使用如Basic、Power Configuration等标准集群，而是通过Tuya特定的数据点(DP)来传输测量数据。这种设计使得设备无法直接被deCONZ原生支持，需要开发专门的设备描述文件(DDF)。

设备通信分析

通过抓包分析，该设备暴露了以下关键信息：

1. 节点类型：End Device
2. 主要端点：1
3. 制造商代码：0x1002
4. 设备标识符：0x0051

设备主要通过Tuya特定的集群(0xEF00)进行通信，没有使用标准的测量集群。这意味着需要解析Tuya特有的数据点结构才能获取测量数据。

数据点映射方案

根据Tuya设备的通用实现模式，该三相电能表可能使用以下数据点(DP)来传输各类测量值：

• 能耗相关：

  • DP1：总消耗电能(单位：0.01kWh)
  • DP23：总发电电能(单位：0.01kWh)
  • DP29：总有功功率(单位：W)

• 系统参数：

  • DP32：电网频率(单位：0.01Hz)
  • DP50：总功率因数(无单位)

• A相参数：

  • DP103：A相电压(单位：0.1V)
  • DP104：A相电流(单位：0.001A)
  • DP105：A相有功功率(单位：W)
  • DP108：A相功率因数
  • DP109：A相消耗电能
  • DP110：A相发电电能

• B相和C相参数采用类似的DP编号模式，分别以112-119和121-128范围定义。

DDF开发建议

针对该设备，建议采用以下DDF开发策略：

1. 创建主传感器设备，包含总能耗、总功率等聚合数据
2. 为每相电流单独定义状态变量，如state/current_P1、state/current_P2等
3. 对于需要分相显示的应用场景，可考虑创建虚拟传感器：
   • 使用不同的端点号区分各相(如0x01、0x02、0x03)
   • 在uuid中使用相序标识符

实现示例

以下是部分关键DDF配置示例：

{
  "name": "state/current_P1",
  "parse": {
    "fn": "tuya",
    "dpid": 104,
    "eval": "Item.val = Attr.val / 1000;"
  },
  "read": {
    "fn": "none"
  },
  "default": 0
}

对于需要分相显示的场景，可创建虚拟传感器定义：

{
  "type": "ZHAPower",
  "restapi": "/sensors",
  "uuid": [
    "$address.ext",
    "0x01",
    "0x0b04"
  ]
}

注意事项

1. 第三方应用(如Phoscon)可能对三相设备的支持有限，需测试确认
2. 电流和功率数据通常具有对应关系，可根据实际需求选择显示哪些参数
3. 确保使用正确的数据转换器(如divideBy100、divideBy1000等)来处理原始数据

通过以上分析和配置，应该能够使该三相电能表在deCONZ环境中正常工作，并提供完整的电气参数监测功能。