Zigbee 水浸传感器接入标准

Zigbee 基本信息

参数	取值
Profile ID	0x0104
Device ID	0x0402

Endpoint 描述

Endpoint	描述
1	当前水浸传感器使用的端口号

支持的 Clusters

Input clusters（Server）	Output clusters（Client）
Basic（0x0000 )	Over The Air Upgrade（0x0019）
Power Configuration（0x0001）	/
IAS Zone（0x0500）	/

支持的属性与命令

属性填写的目的是网关可以通过 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.1 OTA 功能会用到该版本号，在 OTA 开始阶段，网关会读取 OTA 包的版本号推送给设备。在 OTA 成功重启后，网关会读取版本号来确定是否升级成功。只能往更高的版本升级。
0x0002	StackVersion	uint8 - 0x20	0x00-0xff	0x02
0x0003	HWVersion	uint8 - 0x20	0x00-0xff	0x01
0x0004	ManufacturerName	string - 0x42	0-32 bytes	XXX…XXX ( 长度为 16 个字节，由 8 字节前缀和 8 字节的 PID 组成) 0-7 bytes ：_TZ3000_ ，8-16 bytes ：PID（由产品经理在平台或者自助创建和提供）。默认 PID ：mxfe4y4e。该字段决定了手机 App 界面的 UI 和功能展现。如果对 PID 没什么要求，可采用默认 PID。
0x0005	ModelIdentifier	string - 0x42	0-32 bytes	TS0207。该字段为了网关快速识别设备类型用，提升体验
0x0007	PowerSource	enum8 - 0x30	0x00-0xff	0x03
0xfffd	ClusterRevision	uint16 - 0x21	0x0000 -0xffff	0x0001

Power configuration

Attributes:

ID	Name	Data type	Range	Default
0x0000	MainsVoltage	uint16 - 0x21	0x0000 - 0xffff	0x03
0x0020	BatteryVoltage	uint8 - 0x20	24 - 30（2.4V --3.0V）	30
0x0021	BatteryPercentageRemaining	uint8 - 0x20	0 - 200（0 – 100%）	200
0xfffd	ClusterRevision	uint16 - 0x21	0x0000 - 0xffff	0x0001

IAS zone

Attributes:

ID	Name	Data type	Range	Default
0x0000	ZoneState	enum8 - 0x30	All	0
0x0001	ZoneType	enum16 - 0x31	All	0x002a
0x0002	ZoneStatus	map16 - 0x19	All	0X00 ( 状态报警位 Alarm1 报警时置 1 )
0x0010	IAS_CIE_Address	EUI64 - 0xf0	-	-
0x0011	ZoneID	uint8 - 0x20	0x00 - 0xff	0xff
0xfffd	ClusterRevision	uint16 - 0x21	0x0000 - 0xffff	0x0001

Commands:

ID	Name	Direction	Description
0x00	Zone Status Change Notification	S->C	上报报警信息
0x01	Zone Enroll Request	S->C	向网关请求 Zone ID 信息
0x00	Zone Enroll Response	C->S	网关返回给设备的 Zone ID 请求响应

Commands:

ID	Name	Direction	Description
0x00	Zone Status Change Notification	S->C	上报报警信息
0x01	Zone Enroll Request	S->C	向网关请求 Zone ID 信息
0x00	Zone Enroll Response	C->S	网关返回给设备的 Zone ID 请求响应

Over the air upgrade

Attributes:

ID	Name	Data type	Range	Default
0x0000	UpgradeServerID	EUI64 - 0xF0	/	0xffffffffffffffff
0x0001	FileOffset	uint32 - 0x23	/	0x00000000
0x0002	CurrentFileVersion	uint32 - 0x23	/	0x00000040
0x0006	ImageUpgradeStatus	enum8 - 0x30	/	0x00
0x0007	Manufacturer ID	uint16 - 0x21	/	0x1002
0x0008	Image Type ID	uint16 - 0x21	/	0x1602
0x0009	MinimumBlockPeriod	uint16 - 0x21	/	0x0000
0xfffd	ClusterRevision	uint16 - 0x21	0x0000 -0xffff	0x0001

Commands:

ID	Name	Direction
0x00	Image Notify	S->C
0x01	Query Next Image Request	C->S
0x02	Query Next Image Response	S->C
0x03	Image Block Request	C->S
0x05	Image Block Response	S->C
0x06	Upgrade End Request	C->S
0x07	Upgrade End Response	S->C

常用 DP 与 Cluster 对应关系

DPID	DP 含义	是否为标准指令
1	水浸检测状态	是
4	电池电量	是
5	防拆报警	是

DP1 水浸状态

指令方向	Cluster ID	ATTR ID	Value
上报	0x0500	0x0002 zonestatus	Bit0（alarm1）。 0：not alarmed 1：alarmed

DP4 电池电量

指令方向	Cluster ID	ATTR ID	Value
上报	0x0001	0x0020 battery voltage	24 - 30（2.4V - 3.0V）
上报	0x0001	0x0021 battery percentage remain	0 - 200（0 - 100%）

DP5 防拆报警

指令方向	Cluster ID	ATTR ID	Value
上报	0x0500	0x0002 zonestatus	Bit2（tamper）。 0：not alarmed 1：alarmed

防拆类似按键，防拆触发时上报 alarmed，解除防拆报警后上报 not alarmed。

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

请参见 电池电量。