Zigbee 声光报警器接入标准

更新时间:2023-07-06 05:53:23下载pdf

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

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

用 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,在涂鸦IoT平台创建的每一个产品都会产生一个唯一的产品编号,关联了产品具体的功能点、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:

NA

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:

NA

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:

NA

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分钟的随机值上报状态,延迟时间没有到达期间收到单播控制,立即上报状态

开发方式

  1. 基于涂鸦 Zigbee SDK 开发:

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

    (2)涂鸦提供完整的烧录,授权,产测流程和软硬件工具

涂鸦 Zigbee SDK 使用说明

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

  1. 自行开发-非涂鸦 Zigbee 模块:

    (1) 需要完整实现上述技术细节

    (2)完成设备授权

  2. 使用涂鸦完整授权工具授权

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

串口通信协议文档

串口通信实例代码

使用涂鸦授权 SDK 授权

  1. 自行开发-涂鸦 Zigbee 模块:

    (1)只需要实现固件功能细节

    (2)购买授权过的涂鸦 Zigbee 模块即可