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 通过涂鸦开发者平台创建产品时获取，能力值前缀通过开发者文档获取
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
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	2 Byte，范围：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	3	4	5	6	7	8	9
数值	0000 0000	1xxx xxxx	1222 2222	4333 3333	4444 4444	5566 7788	5555 5555	6666 6666	7777 7777	8888 8888

字段	说明
0：情景号	占 8 bit，byte[0]
1：变化模式	占 2 bit，高 bit 在 byte[1] 的 bit[7]，低 bit 在 byte[2] 的 bit[7]。Byte[1] 从左到右分别是情景 1~8 的 mode 高 bit
2：切换时间	占 7 bit， byte[2] 的低 7bit
3：变化时间	占 7 bit，byte[3] 的低 7bit
4：H	占 9 bit，byte[3] 的 bit[7] + byte[4]
5：S	占 10 bit，byte[5] 的 bit[7:6] + byte[6]
6：V	占 10 bit，byte[5] 的 bit[5:4] + byte[7]
7：B	占 10 bit，byte[5] 的 bit[3:2] + byte[8]
8：T	占 10 bit，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，从节点开关开始为单个节点数据格式，后续节点按此格式累加。

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

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

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

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

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 格式：

功能	长度	说明
版本号	1 byte	-
开渐变时间	3 byte	单位：ms，范围 0-60000ms
关渐变时间	3 byte	单位：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。从开关开始的部分为单个节点数据格式

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

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

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

DP49 彩光渐变

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

Payload 格式:

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