Zigbee SOS 接入标准

更新时间:2024-06-11 08:08:43下载pdf

Zigbee 基本信息

Zigbee feature ID Value
Profile Id 0x0104
Device Id 0x0401
Endpoint 描述
1 SOS

支持的 cluster

Input clusters (sever) Output clusters (client)
Basic (0x0000) OTA (0x0019)
IAS ACE (0x0501) /
IAS Zone (0x0500) /

属性与命令

Basic cluster

Attributes:

ID Name Data type
Range
Default
0x0000 ZCLVersion uint8-0x20 0x00-0xff 0x03
0x0001 ApplicationVersion uint8-0x20 0x00-0xff 例如,0b 01 00 0001 = 1.0.1,即 0x41 为 1.0.1。OTA 功能会用到该版本号,在 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:_TZ3000_,8-16 bytes:PID(由产品经理在平台或者自助创建和提供)。SOS 默认 PID:itwolbfv。该字段决定了手机 APP 界面的 UI 和功能展现,如果对 PID 无特殊要求,可用默认值。
0x0005 ModeIdentifier string-0x42 0-32 bytes SOS 填写:TS0215A。该字段被用于网关快速识别设备类型,提升体验。
0x0007 PowerSource enum8-0x30 0x00-0xff 0x03
0xFFFD Cluster revision uint16-0x21 0x0000-0xffff 0x0001
Commands:
ID Name Direction
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

IAS ACE Cluster

Attributes:

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 0x8001
0x0002 zone status bitmap16-0x19 0x0000-0xffff 0x0000
0x0010 IAS CIE address ieee address-0xF0 8 bytes NULL
0x0011 Zone ID Int8-0x20 0x00-0xff 0x0000
0xFFFD cluster revision uint16-0x21 0x0000-0xffff 0x0001

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
0x00 ImageNotify S->C
0x01 QueryNextImageRequest C->S
0x03 ImageBlockRequest C->S
0x06 UpgradeEndRequest C->S

常用 DP 与 cluster 对应关系

DPID DP 含义 是否为标准指令
26 撤防模式
27 外出布防
28 在家布防
29 紧急模式
4 电池电量

DP26 撤防模式

指令方向 Cluster ID Command ID Value
上报 0x0501 0x0000 arm command 00

DP27 外出模式

指令方向 Cluster ID Command ID Value
上报 0x0501 0x0000 arm command 03

DP28 在家模式

指令方向 Cluster ID Command ID Value
上报 0x0501 0x0000 arm command 01

DP29 紧急模式

指令方向 Cluster ID Command ID Value
上报 0x0501 0x0002 emergency 0

DP4 电池电量

指令方向 Cluster ID Attribute ID Value
上报 0x0001 0x0020 battery voltage 0x00-0xff
上报 0x0001 0x0021 battery percentage remain 0x00-0xff

0x0020 上报数值 30 代表 3.0v 电压,0x0021上报数值 180 代表 90% 剩余电量。

默认心跳(4h,上报电量)

见 DP4 电池电量。