Zigbee 窗帘开关接入标准

Zigbee 协议版本

参数	取值
Device ID	Profile ID
0x0202	0x0104

Endpoint 描述

Endpoint	描述
1	当前窗帘开关使用的端口号

支持的 Clusters

Input Clusters（Server）	Output Clusters（Client）
Basic（0x0000）	OTA Upgrade（0x0019）
Group（0x0004）	/
Scene（0x0005）	/
OnOff（0x0006）	/
Window Covering（0x0102）	/

支持的属性和命令

属性填写的目的是网关可以通过 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：TZ3002，8-16 bytes：PID（由产品经理在平台或者自助创建和提供）该字段决定了手机 App 界面的 UI 和功能展现，如果对 PID 没什么要求可用用默认 PID （接入涂鸦网关使用）
0x0005	ModelIdentifier	string-0x42	0-32 bytes	SM130F
0x0007	Power Source	enum8-0x30	0x00-0xff	0x01（接入涂鸦网关使用，指代强电设备）
0xFFFD	Cluster Revision	uint16-0x21	0x0000-0xffff	0x0001

Commands:

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

On/Off Cluster

Attributes:

ID	Name	Data Type	Range	Default
0x5000	背光开关（涂鸦私有属性）	enum8-0x30	value（0：Off, 1：On）	0x00
0x8001	指示灯状态设置（涂鸦私有属性）	enum8-0x30	value(0：状态指示(继电器开则亮), 1：位置指示(继电器关则亮), 2：Off)	0

Window Covering Cluster

Attributes:

ID	Name	Data Type	Range	Default
0x0008	百分比	uint8-0x20	value(0 ~ 100）	/
0xF000	窗帘开关	enum8-0x30	value 0：open 1：stop 2：close	/
0xF001	精准校准（涂鸦私有属性）	enum8-0x30	value 0：开始校准 1：校准结束	/
0xF002	电机转向切换（涂鸦私有属性）	enum8-0x30	value 0：default 1：reverse	/
0xF003	行程（涂鸦私有属性）	uint16-0x21	30~9000	unit: 0.1s

DP 与 Cluster 对应关系

DPID	DP 含义	是否为标准指令
1	窗帘开关 1	是
4	窗帘开关 2	是
2	百分比 1	是
5	百分比 2	是
3	精准校准 1	否
6	精准校准 2	否
8	电机转向 1	否
9	电机转向 2	否
10	快捷校准 1	否
11	快捷校准 2	否
7	背光开关	否
14	指示灯状态设置	否

DP1 窗帘开关 1 & DP4 窗帘开关 2

命令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0x0102：Window Covering	0x00：Open 0x01：Close 0x02：Stop 0x03: continue	/
上报	0x0102：Window Covering	0xF000（涂鸦私有属性）	value 0：open 1：stop 2：close

DP2 百分比 1 & DP5 百分比 2

命令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0x0102：Window Covering	0x05：Go to Lift Percentage	/
上报	0x0102：Window Covering	0x0008：当前百分比	value（0 ~ 100）

DP3 精准校准 1 & DP6 精准校准 2

命令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0x0102：Window Covering	0xF001：精准校准（涂鸦私有属性）	/
上报	0x0102：Window Covering	0xF001：精准校准（涂鸦私有属性）	value 0：开始校准 1：校准结束

DP8 电机转向 1 & DP9 电机转向 2

命令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0x0102：Window Covering	0xF002：电机转向（涂鸦私有属性）	/
上报	0x0102：Window Covering	0xF002：电机转向（涂鸦私有属性）	value 0：default 1：reverse

DP10 快捷校准 1 & DP11 快捷校准 2

命令方向	Cluster ID	CMD / ATTR ID	VALUE
下发	0x0102：Window Covering	0xF003：行程（涂鸦私有属性）	/
上报	0x0102：Window Covering	0xF003：行程（涂鸦私有属性）	30~9000，unit: 0.1s

DP7 背光开关

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

DP14 指示灯状态设置

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