Zigbee Connection Standard for SOS Button

Last Updated on : 2024-06-11 08:13:43download

Zigbee basics

Zigbee feature ID	Value
Profile ID	0x0104
Device ID	0x0401

Endpoint	Description
1	SOS button

Supported clusters

Input cluster (server)	Output cluster (client)
Basic (0x0000)	OTA upgrade (0x0019)
IAS ACE (0x0501)	/
IAS zone (0x0500)	/

Supported attributes and commands

Basic cluster

Attributes

ID	Name	Data type (ID)	Range	Default value
0x0000	ZCLVersion	uint8 (0x20)	0x00 to 0xff	0x03
0x0001	ApplicationVersion	uint8 (0x20)	0x00 to 0xff	For example, `0b 01 00 0001` indicates `1.0.1`, that is, `0x41` represents version 1.0.1. This attribute is used for OTA updates. When an OTA update is initiated, the gateway reads the version number of the update and pushes it to the Zigbee device. After the Zigbee device is restarted after the update, the gateway reads the current version to check for the update result. The firmware can only be updated to a higher version.
0x0002	StackVersion	uint8 (0x20)	0x00 to 0xff	0x02
0x0003	HWVersion	uint8 (0x20)	0x00 to 0xff	0x01
0x0004	ManufacturerName	string (0x42)	0 to 32 bytes	The value of this attribute is 16 bytes in length, consisting of 8-byte prefix and 8-byte PID. 0 to 7 bytes: `_TZ3000_`. 8 to 16 bytes: The PID, the unique identifier of the Zigbee product you create on the Tuya IoT Development Platform, `itwolbfv` by default. This field determines the UI and feature display on the mobile app. You can use the default PID if you do not require a custom one.
0x0005	ModelIdentifier	string (0x42)	0 to 32 bytes	`TS0215A`, used for the gateway to identify the device type.
0x0007	PowerSource	enum8 (0x30)	0x00 to 0xff	0x03
0xFFFD	Cluster revision	uint16 (0x21)	0x0000 to 0xffff	0x0001

Commands

ID	Name	Direction
0x00	Reset to factory defaults	Client to Server

Power configuration cluster

Attributes

ID	Name	Data type (ID)	Range	Default value
0x0000	Mains voltage	uint16 (0x21)	0x0000 to 0xffff	0x0000
0x0020	Battery voltage	Int8 (0x20)	0x00 to 0xff	0x00
0x0021	Battery percentage remaining	Int8 (0x20)	0x00 to 0xff	0x00
0xFFFD	Cluster revision	uint16 (0x21)	0x0000 to 0xffff	0x0001

IAS ACE cluster

Attributes

ID	Name	Data type (ID)	Range	Default value
0xFFFD	Cluster revision	uint16 (0x21)	0x0000 to 0xffff	0x0001

IAS zone cluster

Attributes

ID	Name	Data type (ID)	Range	Default value
0x0000	Zone enroll state	enum8 (0x21)	0x00 to 0xff	0x00
0x0001	Zone type	uint16 (0x21)	0x0000 to 0xffff	0x8001
0x0002	Zone status	bitmap16 (0x19)	0x0000 to 0xffff	0x0000
0x0010	IAS CIE address	EUI64 (0xF0)	8 bytes	NULL
0x0011	Zone ID	Int8 (0x20)	0x00 to 0xff	0x0000
0xFFFD	Cluster revision	uint16 (0x21)	0x0000 to 0xffff	0x0001

OTA upgrade cluster

Attributes

ID	Name	Data type (ID)	Range	Default value
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	Minimum Block Request Period	uint16 (0x21)	/	0x0000
0xfffd	Cluster revision	uint16 (0x21)	0x0000 to 0xffff	0x0001

Commands

ID	Name	Direction
0x00	ImageNotify	Server to Client
0x01	QueryNextImageRequest	Client to Server
0x03	ImageBlockRequest	Client to Server
0x06	UpgradeEndRequest	Client to Server

Mapping between DPs and clusters

DP ID	DP description	Standard command
26	Disarm	Yes
27	Arm Away	Yes
28	Arm at Home	Yes
29	Emergency	Yes
4	Battery level	Yes

DP26 Disarm

Direction	Cluster ID	Command ID	Value
Report	0x0501	0x0000 (arm command)	00

DP27 Away

Direction	Cluster ID	Command ID	Value
Report	0x0501	0x0000 (arm command)	03

DP28 Home

Direction	Cluster ID	Command ID	Value
Report	0x0501	0x0000 (arm command)	01

DP29 Emergency

Direction	Cluster ID	Command ID	Value
Report	0x0501	0x0002 (emergency)	0

DP4 Battery level

Direction	Cluster ID	Attribute ID	Value
Report	0x0001	0x0020 (BatteryVoltage)	0x00 to 0xff
Report	0x0001	0x0021 (BatteryPercentageRemaining)	0x00 to 0xff

If the reported value of BatteryVoltage is 30, it indicates 3.0V voltage. If the reported value of BatteryPercentageRemaining is 180, it indicates a battery level of 90%.

Default heartbeat (4 hours, report battery level)

For more information, see DP4 Battery level.

Prev DocMains-Powered Scene Switch

Next DocDimmer Switch