Tuya.com
简体中文
English
注册
登录开发者平台
简体中文
English
注册
登录开发者平台
网关接入开发
search
根据文档目录筛选
网关接入开发子设备接入网关协议开发接入Zigbee 协议接入Zigbee 计量插座接入标准

Zigbee 计量插座接入标准

更新时间：2023-09-07 10:23:06下载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）的延时关闭。
上一篇Zigbee 温湿度传感器接入标准
下一篇Zigbee 强电场景开关接入标准
语言
简体中文
简体中文
English
400-881-8611
7×24小时服务热线
市场合作
marketing@tuya.com
业务合作
service@tuya.com
媒体联络
pr@tuya.com
关注“涂鸦智能”
涂鸦服务尽在掌握
关注“全球智能商业”
第一时间获取物联网资讯
联系我们加入我们Tuya ExpoApp 商城TuyaGoTuyaGo服务商查询
法律声明隐私协议加州隐私权利声明服务条款廉正合规安全应急响应中心
©2014-2024 杭州涂鸦信息技术有限公司 版权
浙ICP备14011795号
浙B2-20210233号
浙公网安备33010602004238号
简体中文
简体中文
English