Zigbee 计量插座接入标准

更新时间:2023-04-12 06:00:05下载pdf

Zigbee 基本信息

插座分类 Device ID Profile ID
一路插座 0x010A 0x0104

Endpoint 描述

Endpoint 描述
1 第一路计量插座

支持的 Clusters

Input Clusters (server) Output Clusters (client)
Basic (0x0000) OTA Upgrade (0x0019)
Identify (0x0003) /
Group (0x0004) /
Scene (0x0005) /
OnOff (0x0006) /
Simple Metering (0x0702) /
Electrical Measurement (0x0B04) /
TUYA_COMMON_PRIVATE_CLUSTER (0xE000) /
TUYA_ELECTRICIAN_PRIVATE_CLUSTER (0xE001) /

支持的属性和命令

填写属性之后,网关可以通过 Zigbee 标准读写属性来获取设备的基本信息。

Basic cluster

Attributes:

ID Name Data type
Range
Default
0x0000 ZCL Version uint8-0x20 0x00-0xff 0x03 (接入涂鸦网关使用)
0x0001 Application Version uint8-0x20 0x00-0xff 例如,0b 01 00 0001 = 1.0.1,即 0x41 为 1.0.1。OTA 功能会用到该版本号,在 OTA 开始阶段,网关会读取 OTA 包的版本号推送给设备。在 OTA 成功重启后,网关会读取版本号来确定是否升级成功。只能往更高的版本升级。接入涂鸦网关使用。
0x0002 Stack Version uint8-0x20 0x00-0xff 0x02
0x0003 Hardware Version uint8-0x20 0x00-0xff 0x01
0x0004 Manufacturer Name string-0x42 0-32 bytes XXX…XXX。长度为 16 个字节,由 8 字节前缀和 8 字节的 PID 组成。0-7 bytes:_TZ3000_,8-16 bytes:PID(由产品经理在平台或者自助创建和提供)。该字段决定了手机 App 界面的 UI 和功能展现,如果对 PID 无特殊要求,可用默认 PID。接入涂鸦网关使用。
0x0005 Modle Identifier string-0x42 0-32 bytes TS011F。接入涂鸦网关使用。
0x0007 Power Source enum8-0x30 0x00-0xff 0x01。接入涂鸦网关使用,指代强电设备。
0xFFFD Cluster Revision uint16-0x21 0x0000-0xffff 0x0001

Commands:

ID Name Direction
0x00 Reset to Factory Defaults C->S

On/off cluster

Attributes:

ID Name Data type Range Default
0x0000 OnOff bool-0x10 0x00: off,0x01: on 0x00
0x4001 OnTime uint16-0x21 0x0000-0xffff 0x0000
0x4002 OffWaitTime uint16-0x21 0x0000-0xffff 0x0000
0x8001 LED 显示模式(涂鸦私有属性) enum8-0x30 / 0x02
0x8002 继电器状态(涂鸦私有属性) enum8-0x30 / 0x00
0x8000 童锁(涂鸦私有属性) Bool-0x10 0/1 0x00
0xFFFD Cluster Revision uint16-0x21 0x0000-0xffff 0x0001

Commands:

ID Name Direction
0x00 OFF C->S
0x01 ON C->S
0x02 Toggle C->S
0x42 On With Timed Off C->S

Simple metering cluster

Attributes:

ID Name Data type Range Default
0x0000 CurrentSummationDelivered uint48-0x25 0x000000000000–0xffffffffffff /
0x0200 Status bitmap8-0x18 / 0x00
0x0300 UintOfMeasure enum8-0x30 / 0x00
0x0303 SummationFormatting bitmap8-0x18 / 0x00
0x0306 MeteringDeviceType bitmap8-0x18 / 0x00
0xFFFD Cluster Revision uint16-0x21 0x0000-0xffff 0x0001

Electrical measurement cluster

Attributes:

ID Name Data type Range Default
0x0505 RMSVoltage uint16-0x21 0x0000–0xFFFF 0xFFFF
0x0508 RMSCurrent uint16-0x21 0x0000–0xFFFF 0xFFFF
0x050B ActivePower uint16-0x21 -32768–32767 0xFFFF
0xFFFD Cluster Revision uint16-0x21 0x0000-0xffff 0x0001

TUYA_COMMON_PRIVATE cluster

Attributes:

ID Name Data type Range Default
0xD001 循环定时(涂鸦私有属性) ARRAY / /
0xD002 随机定时(涂鸦私有属性) ARRAY / /
0xD003 点动开关(涂鸦私有属性) array-0x48 / /
0xFFFD Cluster Revision uint16-0x21 0x0000-0xffff 0x0001

Commands:

ID name Direction Description
0xF8 循环定时(涂鸦私有命令) C->S 数据格式如 DP42
0xF7 随机定时(涂鸦私有命令) C->S 数据格式如 DP43
0xFB 点动开关(涂鸦私有命令) C->S 数据格式如 DP44

TUYA_ELECTRICIAN_PRIVATEcluster

Attributes:

ID Name Data type Range Default
0xD000 产测(校准)结果(涂鸦私有属性) uint8-0x20 / 0x00
0xD001 计量故障(涂鸦私有属性) bitmap32-0x1B / 0x00000000
0xD002 电量校准系数(涂鸦私有属性) uint32-0x23 / 0x00000000
0xD003 电压校准系数(涂鸦私有属性) uint32-0x23 / 0x00000000
0xD004 电流校准系数(涂鸦私有属性) uint32-0x23 / 0x00000000
0xD005 电功率校准系数(涂鸦私有属性) uint32-0x23 / 0x00000000
0xFFFD Cluster Revision uint16-0x21 0x0000-0xffff 0x0001

Commands:

ID Name Direction Description
0xE1 历史电量(涂鸦私有命令) S->C 数据格式如 DP17

DP 与 cluster 对应关系

DP1-3 开关

DP 说明:数据下发时,直接下发开关命令即可,上报需使用标准开关属性进行上报。

指令方向 Cluster ID CMD/ATTR ID Value
下发 0x0006:on/off
  • 0x00: off
  • 0x01: on
  • 0x02: toggle
/
上报 0x0006:on/off 0x0000: on/off
  • 0: off
  • 1: on

DP9-10 开关倒计时

指令方向 Cluster ID CMD/ATTR ID
下发 0x0006: on/off 0x42: On with timed off Payload
上报 0x0006: on/off
  • 0x4001: OnTime
  • 0x4002: OffWaitTime
0-43200

Payload 格式:On/off Control:0x00,On time 和 Off Wait Time 的时间必须一样。例:下发 60s 的本地倒计时命令,payload 内容为:

  • On/off Control: 0x00
  • On time:0x003c
  • Off Wait Time:0x003c

DP17 增加电量(历史电量)

指令方向 Cluster ID CMD/ATTR ID Value
下发 0xE001: TUYA_ELECTRICIAN_PRIVATE 0xE1: 私有指令
  • uint8u total:历史电量条数
  • uint32u utc_time:当地时间
  • uint32u h_elec[total]:历史电量
上报 0x0702: Simple Metering 0x0000: CurrentSummationDelivered /

DP18 当前电流

指令方向 Cluster ID CMD/ATTR ID
上报 0x0B04: Electrical Measurement 0x0508: RMSCurrent

DP19 当前功率

指令方向 Cluster ID CMD/ATTR ID
上报 0x0B04: Electrical Measurement 0x050B: ActivePower

DP20 当前电压

指令方向 Cluster ID CMD/ATTR ID
上报 0x0B04: Electrical Measurement 0x0505: RMSVoltage

DP21 产测结果

指令方向 Cluster ID CMD/ATTR ID
上报 0xE001:TUYA_ELECTRICIAN_PRIVATE 0xD000: 私有属性

DP22 电压校准系数

指令方向 Cluster ID CMD/ATTR ID
上报 0xE001:TUYA_ELECTRICIAN_PRIVATE 0xD002: 私有属性

DP23 电流校准系数

指令方向 Cluster ID CMD/ATTR ID
上报 0xE001:TUYA_ELECTRICIAN_PRIVATE 0xD003: 私有属性

DP24 功率校准系数

指令方向 Cluster ID CMD/ATTR ID
上报 0xE001:TUYA_ELECTRICIAN_PRIVATE 0xD004: 私有属性

DP25 电量校准系数

指令方向 Cluster ID CMD/ATTR ID
上报 0xE001:TUYA_ELECTRICIAN_PRIVATE 0xD005: 私有属性

DP26 故障报警

指令方向 Cluster ID CMD/ATTR ID Value
上报 0xE001:TUYA_ELECTRICIAN_PRIVATE 0xD001: 私有属性
  • bit0:过流
  • bit1:过压
  • bit2:欠压

DP38 继电器状态设置

指令方向 Cluster ID CMD/ATTR ID Value
下发 0x0006: on/off 0x8002: 私有属性
  • 0:Off
  • 1:On
  • 2:掉电记忆
上报 0x0006: on/off 0x8002: 私有属性
  • 0:Off
  • 1:On
  • 2:掉电记忆

DP40 指示灯模式

指令方向 Cluster ID CMD/ATTR ID Value
下发 0x0006: on/off 0x8001: 私有属性
  • 0:Off
  • 1:状态指示(继电器开则亮)
  • 2:位置指示(继电器关则亮)
上报 0x0006: on/off 0x8001: 私有属性
  • 0:Off
  • 1:状态指示(继电器开则亮)
  • 2:位置指示(继电器关则亮)

DP41 童锁

指令方向 Cluster ID CMD/ATTR ID Value
下发 0x0006: on/off 0x8000: 私有属性
  • 0:不锁定
  • 1:锁定
上报 0x0006: on/off 0x8000: 私有属性
  • 0:不锁定
  • 1:锁定

DP42 循环定时

指令方向 Cluster ID CMD/ATTR ID Value
下发 0xE000:TUYA_COMMON_PRIVATE 0xF8: 私有指令 Payload
上报 0xE000:TUYA_COMMON_PRIVATE 0xD002: 私有属性 Payload

Payload 格式

Payload 格式:2+10*n,n<=6。从开关开始的部分为单个节点数据格式。

功能 长度 说明
版本号 1byte 0x00
节点长度 1byte 0x0A
开关 1byte
  • bit0:本节点开关,置 0 为关,置 1 为开。
  • bit1 到 bit7:通道号。
日期设定 1byte 00 位单次执行,周一至周日,具体见下方日期设定表格。
起始时间 2byte 以 1 min 为单位时间,最大值 1439
结束时间 2byte 以 1 min 为单位时间,最大值 1439
开启时长 2byte 以 1 min 为单位时间,最大值 1439
关闭时长 2byte 以 1 min 为单位时间,最大值 1439

日期设定对应表:

周日 周一 周二 周三 周四 周五 周六
数据 Bit0 Bit1 Bit2 Bit3 Bit4 Bit5 Bit6

DP43 随机定时

指令方向 Cluster ID CMD/ATTR ID Value
下发 0xE000:TUYA_COMMON_PRIVATE 0xF7: 私有指令 Payload
上报 0xE000:TUYA_COMMON_PRIVATE 0xD001: 私有属性 Payload

Payload 格式

Payload 格式:2+10*n,n<=6。从开关开始的部分为单个节点数据格式。

功能 长度 说明
版本号 1byte 0x00
节点长度 1byte 2+10*n,n<=6
开关 1byte
  • bit0:本节点开关,置 0 为关,置 1 为开。
  • bit1 到 bit7:通道号。
日期设定 1byte 周一至周日,具体见 DP42
起始时间 2byte 以 1 min 为单位时间,最大值 1439
结束时间 2byte 以 1 min 为单位时间,最大值 1439

DP44 点动开关

指令方向 Cluster ID CMD/ATTR ID Value
下发 0xE000:TUYA_COMMON_PRIVATE 0xFD: 私有指令 Payload
上报 0xE000:TUYA_COMMON_PRIVATE 0xD003: 私有属性 Payload

Payload 格式

Payload 格式:3*n,n<=6。从开关开始的部分为单个节点数据格式。

功能 长度 说明
通道号 1 byte /
白光渐变时长 2 bytes 单位:s
功能 长度 说明
通道号+通道使能位 1 byte
  • bit0:0 表示使能,1 表示不使能
  • bit7 到 bit1:通道号
点动延迟关闭时间 2 bytes 00 3C,即 0x003c,等于 60s

举例:

  • 单路:01 00 3C,第一路使能,开启时间为 3C(即 60s)的延时关闭。
  • 多路:00 00 3C 03 00 3C,第一路不使能,开启时间为 3C(即 60s)的延时关闭,第二路使能,开启时间为 3C(即 60s)的延时关闭。