Zigbee 声光报警器接入标准

更新时间：2024-06-24 03:23:27下载pdf

Zigbee 声光报警器是一个常供电报警设备，用于提示报警状态。

您现在正在阅览的，是一篇不完全公开的文档，这表示该文档内容的适用性有一定的限制，文档或目录所描述的内容适用于旧版本 SDK、API、工具、平台等。
如果您需要更准确的技术文档，请访问涂鸦开发者平台，然后自行搜索。

用 zigbee3.0 标准里的 IAS Warning Device 设备来实现。

名词解释

名词	解释
Zigbee SDK	基于芯科 Zigbee协议栈经过裁剪、优化后封装的涂鸦 ZigbeeSDK
Attribute	Attribute （属性）是一个反映物理数量或状态的数据值
Cluster	Cluster （群集）是包含一个或多个属性（attribute）的群集
EndPoint	EndPoint （端点）是协议栈应用层的入口，即入口地址，也可以理解应用对象存在的地方，它是为实现一个设备描述而定义的一组群集
Device Id	Zigbee中为每一种设备定义的序号
弱电设备	是指使用电池供电的设备，在 Zigbee 协议中被称为 sleep end device 的设备
强电设备	是指使用市电或者从市电稳压后的电源供电的设备，在 Zigbee 协议中被称为 router 的设备
PID	product ID，在涂鸦开发者平台创建的每一个产品都会产生一个唯一的产品编号，关联了产品具体的功能点、APP控制面板、出货信息等所有跟这个产品相关的信息
SOC	system on chip，硬件本身无MCU，控制程序写入联网模块中
SDK	Software Development Kit，软件开发工具包，辅助开发某一类软件的相关文档、范例和工具的集合。为了鼓励开发者使用其系统或者语言，许多 SDK 是免费提供的，涂鸦的也是
固件	Firmware，就是写入EROM（可擦写只读存储器）或EEPROM(电可擦可编程只读存储器)中的程序。固件是指设备内部保存的设备“驱动程序”，通过固件，操作系统才能按照标准的设备驱动实现特定机器的运行动作，比如光驱、刻录机等都有内部固件。固件是担任着一个系统最基础最底层工作的软件
OTA	是固件升级的意思，我们是支持OTA的

Zigbee 设备功能描述

Zigbee 协议版本

产品为基于标准的 Zigbee 3.0 协议

zibee feature Id	value
Profile Id	0x0104
Device Id	0x0403

Endpoint

endpoint	描述
1	声光报警器

支持的 Clusters

Input Clusters(Sever)	Output Clusters(Client)
Basic(0x0000)	OTA(0x0019)
Power Config(0x0001)
Identify(0x0003)
IAS Zone (0x0500)
IAS Zone (0x0502)

支持的 Clusters

属性填写的目的是网关可以通过 Zigbee 标准读写属性来获取设备的基本信息

Basic Cluster

Attributes:

ID	name	Data Type	Range	Default
0x0000	ZCLVersion	uint8 -0x20	0x00-0xff	0x03
0x0001	ApplicationVersion	uint8 -0x20	0x00-0xff	ie: 0b 01 00 0001 = 1.0.1 即0x41为1.0.1OTA功能会用到该版本号，在OTA开始阶段，网关会读取OTA包的版本号推送给设备。在OTA成功重启后，网关会读取版本号来确定是否升级成功。只能往更高的版本升级
0x0002	StackVersion	uint8-0x20	0x00-0xff	0x02
0x0003	HWVersion	uint8-0x20	0x00-0xff	0x01
0x0004	ManufactureName	string-0x42	0-32 bytes	XXX…XXX(长度为16个字节，由8字节前缀和8字节的PID组成)0-7 bytes：TYZB01;8-16 bytes：PID（由产品经理在平台或者自助创建和提供）声光报警器默认PID：ujpnvzum 该字段决定了手机APP界面的UI和功能展现如果对PID没什么要求可用用默认
0x0005	ModeIdentifier	string -0x42	0-32 bytes	声光报警器填写：TS0216 该字段为了网关快速识别设备类型用，提升体验
0x0007	PowerSource	enum8-0x30	0x00-0xff	0x03
0xFFFD	Cluster revision	uint16 -0x21	0x0000-0xffff	0x0001

Commands:

ID	name	Direction	Description
0x00	Reset to factory default	C->S

Power Config Cluster

Attributes:

ID	name	Data Type	Range	Default
0x0000	mains voltage	uint16-0x21	0x0000-0xffff	0x0000
0x0020	battery voltage	Int8-0x20	0x00-0xff	0x00
0x0021	battery percentage remaining	Int8-0x20	0x00-0xff	0x00
0xFFFD	cluster revision	uint16-0x21	0x0000-0xffff	0x0001

Commands:

Identify Cluster

Attributes(Server):

ID	Name	Data Type	Range	Default
0x0000	Identify Time	uint16-0x21	0x0000-0xffff	0x0000
0xFFFD	Cluster Revision	uint16-0x21	0x0000-0xffff	0x0001

Attributes(Client):

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

IAS Zone Cluster

Attributes:

ID	name	Data Type	Range	Default
0x0000	zone enroll statet	enum8-0x21	0x00-0xff	0x00
0x0001	zone type	uint16-0x21	0x0000-0xffff	0x0225
0x0002	zone status	bitmap16-0x19	0x0000-0xffff	0x0000
0x0010	IAS CIE address	ieee address-0xF0	8byte	NULL
0x0011	Zone ID	Int8-0x20	0x00-0xff	0x0000
0xFFFD	cluster revision	uint16-0x21	0x0000-0xffff	0x0001

Commands:

IAS WD Cluster

Attributes:

ID	name	Data Type	Range	Default
0x0000	Max Duration	uint16-0x21	x0000-0xffff	0~3600单位S,本地保存
0x0001	Alarm ligth	int8 -0x20	0x00-0xff	亮度值：0 灭、30 低亮、60 中亮、100 高亮
0x0002	Alarm radio	int8 -0x20	0x00-0xff	0~50% 报警器本地保存
0x0003	Desalarm	bool -0x10	true\false	存储布防撤防状态目前不启用，关闭此项
0xF000	Private attribute-自定义私属性，用于APP界面提示	int8 -0x20	true\false	0：解除报警、1：声音报警、2：光亮报警、3：声光报警

特别说明：
1、报警，目前只识别网关的 Start Waring 的 Waring Mode 域。
Stop 为停止，不是 Stop，比如 Fire 会报警，按照本地存储的参数执行。

2、收到报警和停止报警命令，报警器会发送zone status change notification命令，最低位 Alarm0 bit 位置0，或者1，随后 report 上报 zone status 属性。

Commands:

Over The Air Upgrade Cluster

Attributes:

ID	name	Data Type	Range	Default
0x0000	UpgradeServerID	EUI64-0xF0	—	0xffffffffffffffff
0x0001	FileOffset	uint32-0x23	—	0x00000000
0x0002	CurrentFileVersion	uint32-0x23	—	0x21050002
0x0006	ImageUpgradeStatus	enum8-0x30	—	0x00
0x0007	Manufature ID	uint16-0x21	—	0x1168
0x0008	Image Type ID	uint16-0x21	—	0x80f6
0x0009	Min Block Request Period	uint16-0x21	—	0x0000
0xfffd	Cluster revision	uint16-0x21	0x0000-0xffff	0x0001

Commands:

| ID | name | Direction | Description |
| ------------- | ------------- |------------- |------------- |------------- |
|0x00|ImageNotify|S->C||
|0x01|QueryNextImageRequest|C->S||
|0x03|ImageBlockRequest|C->S||
|0x06|UpgradeEndRequest|C->S||

Zigbee设备流程机制

组网流程的要求

(1)Beacon request 信道扫描间隔大于200ms，优先扫描优先信道

(2)扫描时间不超过5分钟

(3)如果需要上报数据，组网成功后采用5s到10s或者以上的随机延上报数据

设备断电启动流程的要求

(1)至少大于15s后上报数据

链路维护的要求

(1)持续4小时的间隔上报设备电压、电量百分比

(2)当有任一数据上报成功后延迟4小时间隔上报设备电压、电量百分比

数据上报的要求

(1)如果开启了 APS 层的重传建议把 Disable Default Response 设置成1，避免太多ack

(2)重传数据的 Transaction Sequence Numbe r需要保持一致

(3)重传间隔大于250ms，重传持续时间建议低于3s

(4)收到广播、组播、情景控制时，需要延迟1分钟-2分钟的随机值上报状态，延迟时间没有到达期间收到单播控制，立即上报状态

开发方式

基于涂鸦 Zigbee SDK 开发：

（1）你只需修改 demo 样例的模块型号和硬件配置即可完成上述功能，包括群组，场景均实现

（2）涂鸦提供完整的烧录，授权，产测流程和软硬件工具

涂鸦 Zigbee SDK 使用说明

烧录授权、产测工具使用说明

自行开发-非涂鸦 Zigbee 模块：

（1）需要完整实现上述技术细节

（2）完成设备授权
使用涂鸦完整授权工具授权

通过模块和上位机串口通信授权

串口通信协议文档

串口通信实例代码

使用涂鸦授权 SDK 授权

自行开发-涂鸦 Zigbee 模块：

（1）只需要实现固件功能细节

（2）购买授权过的涂鸦 Zigbee 模块即可