Zigbee 多路开关接入标准

Zigbee 协议版本

Device ID	Profile ID
0x0100	0x0104

Endpoint 信息

Endpoint	描述
1	第一路开关
2	第二路开关
3	第三路开关
4	第四路开关

支持的 Clusters

Input Clusters（Server）	Output Clusters（Client）
Basic（0x0000）	OTA Upgrade（0x0019）
Identify（0x0003）	/
Group （0x0004）	/
Scene （0x0005）	/
OnOff （0x0006）	/
TUYA private cluster0 （0xE000）	/
TUYA private cluster1 （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	ie：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	ModelIdentifier	string-0x42	0-32 bytes	SM000x（零火开关）/SM001x（单火开关）（接入涂鸦网关使用，x 用于指代路数，SM0003 代表 3 路零火开关，SM0013 代表 3 路单火开关）
0x0007	Power Source	enum8-0x30	0x00-0xff	0x01：接入涂鸦网关使用，指代强电设备（零火开关） 0x03：接入涂鸦网关使用，指代弱电设备（单火开关）
0xFFFD	Cluster Revision	uint16-0x21	0x0000-0xffff	0x0001

Commands:

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

3.2 On/Off Cluster

Attributes:

ID	Name	Data Type	Range	Default
0x0000	OnOff	bool-0x10	Value 0 = Off 1 = On	0x00
0x4001	OnTime	uint16-0x21	0-43200	0x0000
0x4002	OffWaitTime	uint16-0x21	0-43200	0x0000
0x8002	上电状态设置-总控（涂鸦私有属性）	enum8-0x30	value 0：Off 1：On 2：掉电记忆	0x00
0x8001	指示灯状态设置（涂鸦私有属性）	enum8-0x30	value 0：Off 1：状态指示（继电器开则亮） 2：位置指示（继电器关则亮）	0x00
0x5000	背光开关（涂鸦私有属性）	enum8-0x30	value 0 = Off 1 = On	0x00

Commands:

ID	name	Direction	Description
0x00	OFF	C->S	/
0x01	ON	C->S	/
0x02	Toggle	C->S	/
0x42	On with timed off	C->S	/

TUYA private cluster0

Attributes:

ID	Name	Data Type	Range	Default
0xD001	随机定时（涂鸦私有属性）	array-0x48	/	/
0xD002	循环定时（涂鸦私有属性）	array-0x48	/	/
0xD003	点动开关（涂鸦私有属性）	array-0x48	/	/

Commands:

ID	name	Direction	Description
0xF7	随机定时（涂鸦私有命令）	C->S	数据格式如 DP210
0xF8	循环定时（涂鸦私有命令）	C->S	数据格式如 DP209
0xFB	点动开关（涂鸦私有命令）	C->S	数据格式如 DP19

TUYA private cluster1

Attributes:

ID	Name	Data Type	Range	Default
0xD010	开关上电状态（分路）	enum8-0x30	value 0：off 1：on 2：掉电记忆	0x00

DP 与 Cluster 对应关系

DPID	DP 含义	是否为标准指令	对应 Endpoint
1	开关 1	是	1
2	开关 2	是	2
3	开关 3	是	3
4	开关 4	是	4
7	开关 1 倒计时	是	1
8	开关 2 倒计时	是	2
9	开关 3 倒计时	是	3
10	开关 4 倒计时	是	4
14	上电状态设置-总控	否	1
15	指示灯状态设置	否	1
16	背光开关	否	1
29	开关 1 上电状态设置-分控	否	1
30	开关 2 上电状态设置-分控	否	2
31	开关 3 上电状态设置-分控	否	3
32	开关 4 上电状态设置-分控	否	4
19	点动开关	否	1
209	循环定时	否	1
210	随机定时	否	1

DP1 开关 1 ~ DP4 开关 4

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

DP7 开关 1 倒计时 ~ DP10 开关 4 倒计时

命令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	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

DP14 上电状态设置-总控

指令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0x0006：on/off	0x8002(涂鸦私有属性)	value 0：off 1：on 2：掉电记忆
上报	0x0006：on/off	0x8002(涂鸦私有属性)	value 0：off 1：on 2：掉电记忆

DP15 指示灯状态设置

指令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0x0006：on/off	0x8001(涂鸦私有属性)	value 0：off 1：状态指示（继电器开则亮） 2：位置指示（继电器关则亮）
上报	0x0006：on/off	0x8001(涂鸦私有属性)	value 0：off 1：状态指示（继电器开则亮） 2：位置指示（继电器关则亮）

DP16 背光开关

指令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0x0006：on/off	0x5000(涂鸦私有属性)	value 0：off 1：on
上报	0x0006：on/off	0x5000(涂鸦私有属性)	value 0：off 1：on

DP29 开关 1 上电状态设置-分控 ~ DP32 开关 4 上电状态设置-分控

指令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0xE001 (TUYA Private Cluster1)	0xD010(涂鸦私有属性)	value 0：off 1：on 2：掉电记忆
上报	0xE001 (TUYA Private Cluster1)	0xD010(涂鸦私有属性)	value 0：off 1：on 2：掉电记忆

DP19 点动开关

命令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0xE000 （TUYA Private Cluster0）	0xFB：私有命令	Payload
上报	0xE000 （TUYA Private Cluster0）	0xD003：私有属性	Payload

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

功能	长度	说明
通道号+通道使能位	1byte	bit0 – 0：使能，1 ：不使能，bit7-bit1 – 通道号
点动延迟关闭时间	2byte	00 3C – 0x003c = 60s

例：
单路：01 00 3C，第一路使能，开启时间为 3C→60s 的延时关闭
多路：00 00 3C 03 00 3C，第一路不使能，开启时间为 3C→60s 的延时关闭，第二路使能，开启时间为 3C→60s 的延时关闭

DP209 循环定时

命令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0xE000 （TUYA Private Cluster0）	0xF8：私有命令	Payload
上报	0xE000 （TUYA Private Cluster0）	0xD002：私有属性	Payload

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

功能	长度	说明
版本号	1byte	0x00
节点长度	1byte	0x0A
开关	1byte	bit0：本节点开关，置 0 为关，置 1 为开。 bit1~bit7：通道号。
日期设定	1byte	0x00：单次执行，取当前日历。其他非零设置，周一至周日，详见下方日期设定表格
起始时间	2byte	以 1min 为单位时间，最大值 1439
结束时间	2byte	以 1min 为单位时间，最大值 1439
开启时长	2byte	以 1min 为单位时间，最大值 1439
关闭时长	2byte	以 1min 为单位时间，最大值 1439

日期设定对应表：

保留	周六	周五	周四	周三	周二	周一	周日
Bit7=0	Bit6	Bit5	Bit4	Bit3	Bit2	Bit1	Bit0

DP210 随机定时

命令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0xE000 （TUYA Private Cluster0）	0xF7：私有命令	Payload
上报	0xE000 （TUYA Private Cluster0）	0xD001：私有属性	Payload

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

功能	长度	说明
版本号	1byte	0x00
节点长度	1byte	0x06
开关	1byte	bit0：本节点开关，置 0 为关，置 1 为开。 bit1~bit7 预留。
日期设定	1byte	0x00：单次执行，取当前日历。其他非零设置，周一至周日，详见下方日期设定表格
起始时间	2byte	以 1min 为单位时间，最大值 1439
结束时间	2byte	以 1min 为单位时间，最大值 1439

日期设定对应表：

保留	周六	周五	周四	周三	周二	周一	周日
Bit7=0	Bit6	Bit5	Bit4	Bit3	Bit2	Bit1	Bit0