Zigbee 照明灯具接入标准

Zigbee 照明基本信息

灯分类	Device ID	Profile ID
一路灯 C	0x0100	0x0104
二路灯 CW	0x010C	0x0104
三路灯 RGB	0x0102	0x0104
四路灯 RGBC	0x010D	0x0104
五路灯 RGBCW	0x010D	0x0104

Endpoint 描述

Endpoint	描述
1	当前照明使用的端口号

支持的 Clusters

Input Clusters(Server)	Output Clusters(Client)
Basic(0x0000)	OTA Upgrade(0x0019)
Identify(0x0003)	/
Group (0x0004)	/
Scene (0x0005)	/
OnOff (0x0006)	/
Level (0x0008)	/
Color control (0x0300)	/
ZLL commissioning (0x1000)	/

支持的属性和命令

属性填写的目的是网关可以通过 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	0x40（0100 0000 = 1.0.0，即 0x40 为 1.0.0）
0x0002	Stack Version	uint8-0x20	0x00-0xff	0x02
0x0003	Hardware Version	uint8-0x20	0x00-0xff	0x01
0x0004	Manufacturer Name	string-0x42	0-32 bytes	_TZ3000_l6web2ir（长度为 16 个字节，由 8 字节能力值前缀和 8 字节的 PID 组成）。PID 通过涂鸦 IoT 开发平台创建产品时获取，能力值前缀通过开发者文档获取
0x0005	ModelIdentifier	string-0x42	0-32 bytes	TS050xB（接入涂鸦网关使用，x 用于指代路数，TS0505B 代表 5 路）
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
0x0000	OnOff	bool-0x10	0x00:off，0x01:on	0x00
0xF000	CountDown	uint32-0x23	0x00000000-0x00015180	0x0000
0xFFFD	Cluster Revision	uint16-0x21	0x0000-0xffff	0x0001

Commands:

ID	name	Direction	Description
0x00	OFF	C->S	/
0x01	ON	C->S	/
0xF0	CountDown	C->S	/

Level Control Cluster

Attributes:

ID	Name	Data Type	Range	Default
0x0000	CurrentLevel	uint8-0x20	0x00-0xff	0x00
0xFFFD	Cluster Revision	uint16-0x21	0x0000-0xffff	0x0001

Commands:

ID	name	Direction	Description
0x00	MoveToLevel	C->S	range:0x00-0xff
0x01	Move	C->S	/
0x02	Step	C->S	/
0x03	Stop	C->S	/
0x04	MoveToLevel(with On/Off)	C->S	/
0x05	Move(with On/Off)	C->S	/
0x06	Step(with On/Off)	C->S	/
0x07	Stop(with On/Off)	C->S	/

Color Control Cluster

Attributes:

ID	Name	Data Type	Range	Default
0x0000	CurrentHue	uint8-0x20	0x00-0xfe	0x00
0x0001	CurrentSaturation	uint8-0x20	0x00-0xfe	0x00
0x0003	CurrentX	uint16-0x21	0x0000 - 0xfeff	0x0000
0x0004	CurrentY	uint16-0x21	0x0000 - 0xfeff	0x0000
0x0007	ColorTemperatureMireds	uint16-0x21	0x00-0xfeff	0x0000
0x0008	ColorMode	enum8-0x30	0x00 – 0x02	0x02
0x4001	EnhancedColorMode	enum8-0x30	0x00 – 0xff	0x02
0x400A	ColorCapabilities	map16-0x19	0x0000 – 0x001f	0x0019
0x400B	ColorTempPhysicalMinMireds	uint16-0x21	0x0000 – 0xfeff	0x0099
0x400C	ColorTempPhysicalMaxMireds	uint16-0x21	0x0000 – 0xfeff	0x01F4
0xF000	模式(涂鸦私有属性)	uint8-0x20	0：白光 1：彩光 2：场景 3：音乐	0x00
0xF001	彩光亮度(涂鸦私有属性)	uint8-0x20	0x00-0xff	0x00
0xF002	全量数据(涂鸦私有属性)	array-0x48	开关(1 字节)+模式（1 字节）+H（2 字节）+S（2 字节）+V（2 字节）+B（2 字节）+T（2 字节）	0x0000
0xF003	场景数据(涂鸦私有属性)	array-0x48	数据格式见下方 DP6	0x0000
0xF007	入睡(涂鸦私有属性)	array-0x48	数据格式见下方 DP31	0x0000
0xF008	唤醒(涂鸦私有属性)	array-0x48	数据格式见下方 DP32	0x0000
0xF009	生物节律(涂鸦私有属性)	array-0x48	数据格式见下方 DP30	0x0000
0xF00A	随机定时(涂鸦私有属性)	array-0x48	数据格式见下方 DP210	0x0000
0xF00B	循环定时(涂鸦私有属性)	array-0x48	数据格式见下方 DP209	0x0000
0xF00C	断电记忆(涂鸦私有属性)	array-0x48	数据格式见下方 DP33	0x0000
0xF00D	勿扰模式(涂鸦私有属性)	bool-0x10	勿扰模式：1 字节。 1：开启 0：关闭	0x0000
0xF00E	开关渐变(涂鸦私有属性)	array-0x48	数据格式见下方 DP35	0x0000
0xFFFD	Cluster Revision	uint16-0x21	0x0000-0xffff	0x0001

Commands:

ID	name	Direction	Description
0x00	Move to Hue	C->S	范围：0x00 – 0xfe
0x01	Move Hue	C->S	/
0x02	Step Hue	C->S	/
0x03	Move to Saturation	C->S	范围：0x00 – 0xfe
0x04	Move Saturation	C->S	/
0x05	Step Saturation	C->S	/
0x06	Move to Hue and Saturation	C->S	/
0x07	Move to Color	C->S	/
0x08	Move Color	C->S	/
0x09	Step Color	C->S	/
0x0A	Move to Color Temperature	C->S	/
0x47	Stop Move Step	C->S	/
0x4B	Move Color Temperature	C->S	/
0x4C	Step Color Temperature	C->S	/
0xE0	白光色温设置(涂鸦私有命令)	C->S	2Byte，范围：0x0000 - 0x03E8
0xE1	彩光设置(涂鸦私有命令)	C->S	数据格式见下发 DP5
0xF0	模式设置(涂鸦私有命令)	C->S	切换模式。 0：白光 1：彩光 2：场景 3：音乐
0xF1	场景数据(涂鸦私有命令)	C->S	数据格式见下方 DP6
0xF2	音乐/实时调节(涂鸦私有命令)	C->S	数据格式见下方 DP9
0xF4	入睡(涂鸦私有命令)	C->S	数据格式见下方 DP31
0xF5	唤醒(涂鸦私有命令)	C->S	数据格式见下方 DP32
0xF6	生物节律(涂鸦私有命令)	C->S	数据格式见下方 DP30
0xF7	随机定时(涂鸦私有命令)	C->S	数据格式见下方 DP210
0xF8	循环定时(涂鸦私有命令)	C->S	数据格式见下方 DP209
0xF9	断电记忆(涂鸦私有命令)	C->S	数据格式见下方 DP33
0xFA	勿扰模式(涂鸦私有命令)	C->S	数据格式见下方 DP34
0xFB	开关渐变(涂鸦私有命令)	C->S	数据格式见下方 DP35
0xFD	白光渐变(涂鸦私有命令)	C->S	数据格式见下方 DP48
0xFE	彩光渐变(涂鸦私有命令)	C->S	数据格式见下方 DP49

DP 与 CLUSTER 对应关系

DPID	DP 含义	是否为标准指令
1	开关	是
2	模式	否
3	白光亮度	否
4	白光色温	否
5	彩光颜色	否
6	情景	否
7	倒计时	否
8	音乐	否
9	调节	否
30	生物节律	否
31	入睡	否
32	唤醒	否
33	断电记忆	否
34	勿扰模式	否
35	开关渐变	否
209	循环定时	否
210	随机定时	否
48	白光渐变	否
49	采光渐变	否

DP1 开关

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

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0006：on/off	0x00: on/off	/
上报	0x0006：on/off	0x0000: on/off	0: off 1：on

DP2 模式

DP 说明：切换模式时，通过下发涂鸦私有命令

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xF0: 私有指令	1 字节。范围： 0：白光 1：彩光 2：场景 3：音乐
上报	0x0300: color control	0xF000: 私有属性	类型：U8。范围： 0：白光 1：彩光 2：场景 3：音乐

DP3 白光亮度

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0008: level control	0xF0: 私有指令	2 字节。范围：0x0000 ~ 0x03E8
上报	0x0008: level control	0xF000: 私有属性	类型: U16。范围: 0x0000 ~ 0x03E8

DP4 白光色温

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xE0: 私有指令	2 字节,范围：0x0000 ~ 0x03E8
上报	0x0300: color control	0xE000: 私有属性	类型: U16 范围: 0x0000 ~ 0x03E8

DP5 彩光颜色

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xE1: 私有指令	6 字节, H:2 字节 0x0000~0x0168, S: 2 字节 0x0000~0x03E8, V: 2 字节 0x0000~0x03E8
上报	0x0300: color control	0xE100: 私有属性	类型:U48, H:2 字节 0x0000~0x0168, S: 2 字节 0x0000~0x03E8, V: 2 字节 0x0000~0x03E8

DP6 场景

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xF1: 私有指令	数据长度:2+8*n,n 是场景的单元个数,n≤8
上报	0x0300: color control	0xF003: 私有属性	类型:ARRAY,长度+VALUE
情景数据压缩后格式如下（1 个单元）：
字节	0	1	2
----	----	----	----
数值	0000 0000	1xxx xxxx	1222 2222

字段	说明
0:情景号	占 8bit, byte[0]
1:变化模式	占 2bit, 高 bit 在 byte[1] bit[7], 低 bit 在 byte[2] 的 bit[7]. Byte[1] 从左到右分别是情景 1~8 的 mode 高 bit
2:切换时间	占 7bit, byte[2] 的低 7bit
3:变化时间	占 7bit, byte[3] 的低 7bit
4: H	占 9bit, byte[3]的 bit[7] + byte[4]
5: S	占 10bit, byte[5]的 bit[7:6] + byte[6]
6: V	占 10bit, byte[5]的 bit[5:4] + byte[7]
7: B	占 10bit, byte[5]的 bit[3:2] + byte[8]
8: T	占 10bit, byte[5]的 bit[1:0] + byte[9]

DP7 倒计时

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0006：on/off	0xF0: 私有指令	4 字节, 范围 0x00000000 ~ 0x00015180,单位：秒
上报	0x0006：on/off	0xF000: 私有属性	类型 U32, 倒计时剩余时间 T: 0x00000000 ~ 0x00015180

DP8 音乐

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xF2: 私有指令	变化方式+HSVBT = 11 字节
上报	/	/	/

DP9 实时调节（同音乐 DP）

DP 说明：当用户从 App 上调节颜色或者亮度等参数时, 若手不抬起则会下发实时数据, 目前单播下发间隔是 150ms,组播是 300ms. 实时数据指令只下发,不上报。

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xF2: 私有指令	变化方式+HSVBT = 11 字节
上报	/	/	/

实时数据指令格式：

字节	0	1-2	3-4	5-6	7-8	9-10
数值	0 直接，1 渐变	色相 H	饱和度 S	明度 V	白光亮度 B	白光色温 T

DP30 生物节律

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xF6: 私有指令	Payload
上报	0x0300: color control	0xF009: 私有属性	Payload

Payload 格式：5+9*n，从节点开关开始为单个节点数据格式，后续节点按此格式累加。

功能	长度	说明
版本号	1byte	/
任务开关	1byte	0x00：任务关闭，0x01：任务打开
模式选择	1byte	0x00：全程渐变，0x01：直接渐变
日期设定	1byte	周一到周日的选择，具体看下方设定表格
节点个数(最大 6 个节点)	1byte	最大 6 个节点
节点开关	1byte	节点开关优先级低于任务开关，只有任务开关开启的情况下才判断节点开关。 0x00：节点禁能，不生效 0x01：节点使能，生效
节点启动时间时	1byte	时，范围允许值 0 - 23。 例：0x10，hex 码，16 点
节点启动时间分	1byte	分，范围允许值 0 - 59。 例：0x10，hex 码，16 分
色调	2byte	色调，hex 码，大端模式，第一个字节表示百位，第二个字节表示十位和个位。范围允许值 0 - 360。 例：0x03，0x10。实际表示值为 316.
饱和度百分比	1byte	范围允许值 0 - 100
明度百分比	1byte	范围允许值 1 - 100
亮度百分比	1byte	范围允许值 1 - 100
色温百分比	1byte	范围允许值 1 - 100

日期设定对应表：

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

DP31 入睡

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xF4: 私有指令	Payload
上报	0x0300: color control	0xF007: 私有属性	Payload

Payload 格式：2+11*n，从节点开关开始的 11 个字节为一个节点的数据，后续节点按此格式累加。

功能	长度	说明
版本号	1byte	/
任务节点个数	1byte	最大 4 个节点
节点开关	1byte	0x00：节点关闭，0x01：节点打开
日期设定	1byte	周一到周日的选择，具体看下方设定表格
渐变步进	1byte	5 分钟一个步进值，范围允许值 1-72
节点启动时间时	1byte	时，范围允许值 0 - 23。 例：0x10，hex 码，16 点
节点启动时间分	1byte	分，范围允许值 0 - 59。 例：0x10，hex 码，16 分
色调	2byte	色调，hex 码，大端模式，第一个字节表示百位，第二个字节表示十位和个位。范围允许值 0 - 360。 例：0x03，0x10。实际表示值为 316.
饱和度百分比	1byte	范围允许值 0 - 100
明度百分比	1byte	范围允许值 1 - 100
亮度百分比	1byte	范围允许值 1 - 100
色温百分比	1byte	范围允许值 1 - 100

日期设定对应表：

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

DP32 唤醒

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xF5: 私有指令	Payload
上报	0x0300: color control	0xF008: 私有属性	Payload

Payload 格式：2+12*n，从节点开关开始的 12 个字节为一个节点的数据，后续节点按此格式累加。

功能	长度	说明
版本号	1byte	/
任务节点个数	1byte	最大 4 个节点
节点开关	1byte	0x00：节点关闭，0x01：节点打开
日期设定	1byte	周一到周日的选择，具体看下方设定表格
渐变步进	1byte	5 分钟一个步进值，范围允许值 1-72
节点启动时间时	1byte	时，范围允许值 0 - 23。 例：0x10，hex 码，16 点
节点启动时间分	1byte	分，范围允许值 0 - 59。 例：0x10，hex 码，16 分
色调	2byte	色调，hex 码，大端模式，第一个字节表示百位，第二个字节表示十位和个位。范围允许值 0 - 360。 例：0x03，0x10。实际表示值为 316.
饱和度百分比	1byte	范围允许值 0 - 100
明度百分比	1byte	范围允许值 1 - 100
亮度百分比	1byte	范围允许值 1 - 100
色温百分比	1byte	范围允许值 1 - 100
持续时间	1byte	渐变完成后再持续该时间后关灯。范围允许值 0-24，0 表示不关灯，24 表示 120 分钟后关灯

日期设定对应表：

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

DP33 断电记忆

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xF9: 私有指令	Payload
上报	0x0300: color control	0xF00C: 私有属性	Payload

Payload 格式：

功能	长度	说明
版本号	1byte	/
模式选择	1byte	0：默认颜色，1：恢复记忆，2：自定义颜色
色调值	1byte	色调高八位
色调值	1byte	色调低八位
饱和度	1byte	饱和度高八位
饱和度	1byte	饱和度低八位
明度	1byte	明度高八位
明度	1byte	明度低八位
亮度	1byte	亮度高八位
亮度	1byte	亮度低八位
色温	1byte	色温高八位
色温	1byte	色温低八位

DP34 勿扰模式

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xFA: 私有指令	true：开启，false：关闭
上报	0x0300: color control	0xF00D: 私有属性	true：开启，false：关闭

DP35 开关渐变

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xFB: 私有指令	Payload
上报	0x0300: color control	0xF00E: 私有属性	Payload

Payload 格式：

功能	长度	说明
版本号	1byte	/
开渐变时间	3byte	单位：ms，范围 0-60000ms
关渐变时间	3byte	单位：ms，范围 0-60000ms

DP209 循环定时

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xF8: 私有指令	Payload
上报	0x0300: color control	0xF00B: 私有属性	Payload

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

功能	长度	说明
版本号	1byte	/
节点长度	1byte	2+16*n，n<=4
开关	1byte	bit0：本节点开关，置 0 为关，置 1 为开。 bit1~bit7 预留。
日期设定	1byte	周一至周日，具体见下方日期设定表格
起始时间	2byte	以 1min 为单位时间，最大值 1439
结束时间	2byte	以 1min 为单位时间，最大值 1439
开启时长	2byte	以 1min 为单位时间，最大值 1439
关闭时长	2byte	以 1min 为单位时间，最大值 1439
H(色调)	2byte	范围允许值 0 - 360
S(饱和度%)	1byte	范围允许值 0 - 100
V(明度%)	1byte	范围允许值 1 - 100
B(亮度%)	1byte	范围允许值 1 - 100
T(色温%)	1byte	范围允许值 0 - 100

日期设定对应表：

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

DP210 随机定时

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xF7: 私有指令	Payload
上报	0x0300: color control	0xF00A: 私有属性	Payload

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

功能	长度	说明
版本号	1byte	/
节点长度	1byte	2+16*n，n<=4
开关	1byte	bit0：本节点开关，置 0 为关，置 1 为开。 bit1~bit7 预留。
日期设定	1byte	周一至周日，具体见下方日期设定表格
起始时间	2byte	以 1min 为单位时间，最大值 1439
结束时间	2byte	以 1min 为单位时间，最大值 1439
H(色调)	2byte	范围允许值 0 - 360
S(饱和度%)	1byte	范围允许值 0 - 100
V(明度%)	1byte	范围允许值 1 - 100
B(亮度%)	1byte	范围允许值 1 - 100
T(色温%)	1byte	范围允许值 0 - 100

日期设定对应表：

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

DP48 白光渐变

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xFD: 私有指令	Payload
上报	0x0300: color control	0xF013: 私有属性	Payload

Payload 格式:

功能	长度	说明
版本号	1byte	/
白光渐变时长	2byte	单位：ms，范围：0-10000ms

DP49 彩光渐变

指令方向	CLUSTER ID	CMD / ATTR ID	VALUE
下发	0x0300: color control	0xFE: 私有指令	Payload
上报	0x0300: color control	0xF014: 私有属性	Payload

Payload 格式:

功能	长度	说明
版本号	1byte	/
彩光渐变时长	2byte	单位：ms，范围：0-10000ms