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.