Zigbee SOS 接入标准

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	Attribute ID	Value
上报	0x0501	0x0000 arm command	00

DP27 外出模式

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

DP28 在家模式

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

DP29 紧急模式

指令方向	Cluster ID	Attribute 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

默认心跳（4h，上报电量）

见 DP4 电池电量。