Zigbee 照明调光遥控器接入标准

Zigbee 基本信息

遥控器分类	Device ID	Profile ID
Dimmer Switch	0x0104	0x0104
Color Dimmer Switch	0x0105	0x0104

Endpoint 描述

Endpoint	描述
1	当前遥控器的端口号

支持的 Clusters

Input clusters (server)	Output clusters (client)
Basic (0x0000)	Identify (0x0003)
Power Configuration (0x0001)	Group (0x0004)
Identify (0x0003)	Scene (0x0005)
Group (0x0004)	OnOff (0x0006)
Touchlink Commissioning (0x1000)	LevelControl (0x0008)
	ColorControl (0x0300)
	Touchlink Commissioning (0x1000)
	OTA Upgrade (0x0019)

支持的属性和命令

属性填写之后，网关可以通过 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：_TZ3000_，8-16 bytes：PID（由产品经理在平台或者自助创建和提供）。该字段决定了手机 App 界面的 UI 和功能展现，如果对 PID 无特殊要求，可用默认 PID。接入涂鸦网关使用。
0x0005	ModelIdentifier	string-0x42	0-32 bytes	TS1001。该字段被用于网关快速识别设备类型。
0x0007	Power Source	enum8-0x30	0x00-0xff	0x03
0xFFFD	Cluster Revision	uint16-0x21	0x0000-0xffff	0x0001

Commands

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

Power configuration cluster

Attributes

ID	Name	Data type	Range	Default
0x0000	MainsVoltage	uint16-0x21	0x0000-0xffff	0x0000
0x0020	BatteryVoltage	uint8-0x20	0x00-0xff	0x1e
0x0021	BatteryPercentageRemaining	uint8-0x20	0x00-0xff	0xc8
0xFFFD	ClusterRevision	uint16-0x21	0x0000-0xffff	0x0001

Identify cluster

Attributes (server)

ID	Name	Data type	Range	Default
0x0000	IdentifyTime	uint16-0x21	0x0000-0xffff	0x0000
0xFFFD	ClusterRevision	uint16-0x21	0x0000-0xffff	0x0001

Attributes (client)

ID	Name	Data type	Range	Default
0xFFFD	ClusterRevision	uint16-0x21	0x0000-0xffff	0x0001

Commands (client)

ID	Name	Direction	Description
0x00	Identify	C->S	Send a command
0x00	Identify Query Response	S->C	Receive a command

Commands (server)

ID	Name	Direction	Description
0x00	Identify	C->S	Receive a command
0x01	Identify Query	C->S	Receive a command
0x00	Identify Query Response	S->C	Send a command

Groups cluster

Attributes (server)

ID	Name	Data type	Range	Default
0x0000	Name Support	bitmap8-0x18	0x00-0xff	0x00
0xFFFD	ClusterRevision	uint16-0x21	0x0000-0xffff	0x0001

Attributes (client)

ID	Name	Data type	Range	Default
0xFFFD	ClusterRevision	uint16-0x21	0x0000-0xffff	0x0001

Commands (client)

ID	Name	Direction	Description
0x00	Add group response	S->C	Receive a command
0x01	View group response	S->C	Receive a command
0x02	Get group membership response	S->C	Send a command
0x03	Remove group response	S->C	Receive a command
0x00	Add group	C->S	Send a command

Commands (server)

ID	Name	Direction	Description
0x00	Add group	C->S	Receive a command
0x01	View group	C->S	Receive a command
0x02	Get group membership	C->S	Receive a command
0x03	Remove group	C->S	Receive a command
0x04	Remove all groups	C->S	Receive a command
0x05	Add group if identifying	C->S	Receive a command
0x00	Add group response	S->C	Send a command
0x01	View group response	S->C	Send a command
0x02	Get group membership response	S->C	Send a command
0x03	Remove group response	S->C	Send a command

Scenes cluster

Attributes

ID	Name	Data Type	Range	Default
0xFFFD	ClusterRevision	uint16-0x21	0x0000-0xffff	0x0001

Commands

ID	Name	Direction	Description
0x00	Recall Scene	C->S	Send a command
0x01	Enhanced Add Scene	C->S	Send a command
0x01	Enhanced Add Scene Response	C->S	Receive a command

On/off cluster

Attributes

ID	Name	Data type	Range	Default
0xFFFD	ClusterRevision	uint16-0x21	0x0000-0xffff	0x0001

Commands

ID	Name	Direction	Description
0x00	Off	C->S	Send a command
0x01	On	C->S	Send a command

Level control cluster

Attributes

ID	Name	Data type	Range	Default
0xFFFD	ClusterRevision	uint16-0x21	0x0000-0xffff	0x0001

Commands (client)

ID	Name	Direction	Description
0x00	Move to level	C->S	Send a command
0x01	Move	C->S	Send a command
0x02	Step	C->S	Send a command
0x03	Stop	C->S	Send a command

Color control cluster

Attributes

ID	Name	Data type	Range	Default
0xFFFD	ClusterRevision	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	/
0x06	Move to Hue and Saturation	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 bytes，范围：0x0000 - 0x03E8
0xE1	彩光设置(涂鸦私有命令)	C->S	6 bytes。 H: 2 bytes，0x0000 - 0x0168。 S: 2 bytes，0x0000 - 0x03E8。 V: 2 bytes，0x0000 - 0x03E8。
0xF0	模式设置(涂鸦私有命令)	C->S	切换模式。 0：白光。 1：彩光。 2：场景。 3：音乐。

Touchlink commissioning cluster

Attributes (server)

ID	Name	Data Type	Range	Default
0xFFFD	ClusterRevision	uint16-0x21	0x0000-0xffff	0x0001

Attributes (client)

ID	Name	Data Type	Range	Default
0xFFFD	ClusterRevision	uint16-0x21	0x0000-0xffff	0x0001

Commands (server)

ID	Name	Direction	Description
0x00	Scan request	C->S	Receive a command
0x02	Device information request	C->S	Receive a command
0x06	Identify request	C->S	Receive a command
0x07	Reset to factory new request	C->S	Receive a command
0x14	Network join end device request	C->S	Receive a command
0x01	Scan response	S->C	Send a command
0x03	Device information response	S->C	Send a command
0x40	Endpoint information	S->C	Send a command
0x41	Get group identifiers response	S->C	Send a command
0x42	Get endpoint list response	S->C	Send a command

Commands (client)

ID	Name	Direction	Description
0x00	Scan request	C->S	Send a command
0x02	Device information request	C->S	Send a command
0x06	Identify request	C->S	Send a command
0x07	Reset to factory new request	C->S	Send a command
0x10	Network start request	C->S	Send a command
0x12	Network join router request	C->S	Send a command
0x14	Network join end device	C->S	Send a command
0x01	Scan response	S->C	Receive a command
0x03	Device information response	S->C	Receive a command
0x11	Network start response	S->C	Receive a command
0x13	Network join router response	S->C	Receive a command
0x15	Network join end device response	S->C	Receive a command
0x40	Endpoint information	S->C	Receive a command
0x41	Get group identifiers response	S->C	Receive a command
0x42	Get endpoint list response	S->C	Receive a command