Zigbee 强电场景开关接入标准

Zigbee 基本信息

Device ID	Profile ID
0x0004	0x0104

Endpoint 描述

Endpoint	描述
1	第一路场景开关/普通开关
2	第二路场景开关/普通开关
3	第三路场景开关/普通开关
4	第四路场景开关/普通开关
5	第五路场景开关
6	第六路场景开关

支持的 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	例如，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：_TZ3002_，8-16 bytes：PID（由产品经理在平台或者自助创建和提供）。该字段决定了手机 App 界面的 UI 和功能展现，如果对 PID 无特殊要求，可用默认 PID。接入涂鸦网关使用。
0x0005	Model Identifier	string-0x42	0-32 bytes	场景开关：SM002x，混合场景开关：TS0726。接入涂鸦网关使用，x 用于指代路数，SM0023 代表 3 路场景开关。
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	数值范围。 0：Off 1：On	0x00
0x4001	OnTime	uint16-0x21	0-43200	0x0000
0x4002	OffWaitTime	uint16-0x21	0-43200	0x0000
0x8002	上电状态设置-总控（涂鸦私有属性）	enum8-0x30	数值范围。 0：Off 1：On 2：掉电记忆	0x00
0x8001	指示灯状态设置（涂鸦私有属性）	enum8-0x30	数值范围。 0：Off 1：状态指示（继电器开则亮） 2：位置指示（继电器关则亮）	0x00
0x5000	背光开关（涂鸦私有属性）	enum8-0x30	数值范围。 0：Off 1：On	0x00

Commands:

ID	Name	Direction
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
0xD004	群组 ID（涂鸦私有属性）	uint16-0x21
0xD005	场景 ID（涂鸦私有属性）	uint16-0x21

TUYA private cluster1

Attributes:

ID	Name	Data Type	Range	Default
0xD010	开关上电状态（分路）	enum8-0x30	数值范围。 0：Off 1：On 2：掉电记忆	0x00
0xD020	模式	enum8-0x30	数值范围。 0：开关 1：场景开关	0x01

DP 与 Cluster 对应关系

DPID	DP 含义	是否为标准指令	对应 Endpoint
1	场景 1（必选）	否（面板相关，设备无需对接，选上即可）	1
2	场景 2（必选）	否（面板相关，设备无需对接，选上即可）	2
3	场景 3（必选）	否（面板相关，设备无需对接，选上即可）	3
4	场景 4（必选）	否（面板相关，设备无需对接，选上即可）	4
5	场景 5（必选）	否（面板相关，设备无需对接，选上即可）	5
6	场景 6（必选）	否（面板相关，设备无需对接，选上即可）	6
17	场景 ID/组 ID（必选）	否	1
18	模式 1	否	1
19	模式 2	否	2
20	模式 3	否	3
21	模式 4	否	4
24	开关 1	是	1
25	开关 2	是	2
26	开关 3	是	3
27	开关 4	是	4
30	开关 1 倒计时	是	1
31	开关 2 倒计时	是	2
32	开关 3 倒计时	是	3
33	开关 4 倒计时	是	4
38	上电状态设置-总控	否	1
37	指示灯状态设置	否	1
36	背光开关	否	1
39	开关 1 上电状态设置-分控	否	1
40	开关 2 上电状态设置-分控	否	2
41	开关 3 上电状态设置-分控	否	3
42	开关 4 上电状态设置-分控	否	4

DP17 场景 ID/组 ID

命令方向	Cluster ID	CMD/ATTR ID	Value
下发	0xE000 （TUYA Private Cluster0）	0xD004 & 0xD005（涂鸦私有属性）	Payload
上报	0xE000 （TUYA Private Cluster0）	0xD004 & 0xD005（涂鸦私有属性）	Payload

Payload：

• 网关通过写 0xD004 和 0xD0005 属性，下发组 ID 和场景 ID 给设备对应 Endpoint。
• 设备收到组 ID 和场景 ID 之后，通过属性上报，告知网关设备收到数据。

DP18 模式 1 - DP21 模式 4

命令方向	Cluster ID	CMD/ATTR ID	Value
下发	0xE000 （TUYA Private Cluster0）	0xD020（涂鸦私有属性）	value（0 = 开关，1 = 场景开关）
上报	0xE000 （TUYA Private Cluster0）	0xD020（涂鸦私有属性）	value（0 = 开关，1 = 场景开关）

DP24 开关 1 - DP27 开关 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

DP30 开关 1 倒计时 - DP33 开关 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

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：掉电记忆

DP37 指示灯状态设置

指令方向	Cluster ID	CMD/ATTR ID	Value
下发	0x0006：on/off	0x8001（涂鸦私有属性）	数值范围。 0：Off 1：状态指示（继电器开则亮） 2：位置指示（继电器关则亮）
上报	0x0006：on/off	0x8001（涂鸦私有属性）	数值范围。 0：Off 1：状态指示（继电器开则亮） 2：位置指示（继电器关则亮）

DP36 背光开关

指令方向	Cluster ID	CMD/ATTR ID	Value
下发	0x0006：on/off	0x5000（涂鸦私有属性）	数值范围。 0：Off 1：On
上报	0x0006：on/off	0x5000（涂鸦私有属性）	数值范围。 0：Off 1：On

DP39 开关 1 上电状态设置-分控 - DP42 开关 4 上电状态设置-分控

指令方向	Cluster ID	CMD/ATTR ID	Value
下发	0xE001（TUYA Private Cluster1）	0xD010（涂鸦私有属性）	数值范围。 0：Off 1：On 2：掉电记忆
上报	0xE001（TUYA Private Cluster1）	0xD010（涂鸦私有属性）	数值范围。 0：Off 1：On 2：掉电记忆