Skip to content

BLE Commands

Kieron Quinn edited this page Feb 10, 2025 · 1 revision

Commands are sent to Tags using characteristic reads and writes. Communication is encrypted, but SmartThings handles all the required encryption and decryption. Encryption & decryption of commands is out of scope for uTag for this reason.

Below are a list of commands, with request payloads and responses where applicable.

All Characteristics are on the control service (UUID 0000FD5A-0000-1000-8000-00805F9B34FB).

Get Battery Level

UUID

DEE30004-182D-5496-B1AD-14F216324184

Response

Payload Battery level
00 Very Low
01 Low
02 Medium
03 Full

Ring

UUID

DEE30001-182D-5496-B1AD-14F216324184

Request

Payload Ringing
00 Disabled
01 Enabled

Get Ring Volume

UUID

DEE30002-182D-5496-B1AD-14F216324184

Response

Payload Ring Level
01 Low
02 High

Set Ring Volume

UUID

DEE30002-182D-5496-B1AD-14F216324184

Request

Payload Ring Level
01 Low
02 High

Get E2E Flag

UUID

DEE30007-182D-5496-B1AD-14F216324184

Response

Payload State
00 Disabled
01 Enabled

Set E2E Flag

UUID

DEE30007-182D-5496-B1AD-14F216324184

Request

Payload State
00 Disabled
01 Enabled

Note: You must also set the E2E flag on the server, or location updates from other Samsung devices will fail.

Set UWB Flag

UUID

DEE30008-182D-5496-B1AD-14F216324184

Request

Payload State
00 Disabled
01 Enabled

UWB Payload

UUID

DEE30009-182D-5496-B1AD-14F216324184

Request

The payload for configuring UWB is complex and should only be generated by an app. See UwbConfig for an example.

Button Configuration

UUID

DEE30003-182D-5496-B1AD-14F216324184

Request

Payload State
0000 Press Disabled
0001 Press Enabled
0100 Hold Disabled
0101 Hold Enabled

Note: Commands for setting the press state and hold state must be sent separately

Button Volume

UUID

DEE3001F-182D-5496-B1AD-14F216324184

Request

Payload Ring Level
00 Muted
01 Low
02 High

Lost URL

UUID

DEE3001B-182D-5496-B1AD-14F216324184

Request

Hex encoded String of URL

Clone this wiki locally