The Time Synchronization cluster (0x0038) is a Matter cluster that Synchronizes device time with trusted time sources for accurate timestamps.. It defines 6 commands and 13 attributes and is mandatory for 2 device types.
Time Synchronization 0x0038
Synchronizes device time with trusted time sources for accurate timestamps.
Spec History
This cluster's ClusterRevision across the Matter releases it has shipped in. Click a version to inspect the cluster as it existed in that release.
Attributes 13
Commands 6
Features 4
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 |
UTCTime
nullable
|
epoch_us | |
| 0x0001 |
Granularity
max 0x04 · default 0x00
|
GranularityEnum | |
| 0x0002 |
TimeSource
max 0x10 · default 0x00
|
TimeSourceEnum | Optional |
| 0x0003 |
TrustedTimeSource
nullable
|
TrustedTimeSourceStruct | Optional |
| 0x0004 |
DefaultNTP
nullable
|
char_string | Optional |
| 0x0005 | TimeZone | array | Optional |
| 0x0006 | DSTOffset | array | Optional |
| 0x0007 |
LocalTime
nullable
|
epoch_us | Optional |
| 0x0008 |
TimeZoneDatabase
max 0x02 · default 2
|
TimeZoneDatabaseEnum | Optional |
| 0x0009 |
NTPServerAvailable
default 0
|
boolean | Optional |
| 0x000A |
TimeZoneListMaxSize
1..2
|
int8u | Optional |
| 0x000B |
DSTOffsetListMaxSize
min 1
|
int8u | Optional |
| 0x000C |
SupportsDNSResolve
default 0
|
boolean | Optional |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
SetUTCTime
invoke: administer
This command is used to set the UTC time of the node.
|
client→server |
UTCTime: epoch_us, Granularity: GranularityEnum, TimeSource: TimeSourceEnum |
| 0x01 |
SetTrustedTimeSource
Optional invoke: administer
This command is used to set the TrustedTimeSource attribute.
|
client→server |
TrustedTimeSource: FabricScopedTrustedTimeSourceStruct |
| 0x02 |
SetTimeZone
Optional invoke: manage
This command is used to set the time zone of the node.
|
client→server |
TimeZone: TimeZoneStruct |
| 0x03 |
SetTimeZoneResponse
Optional THis command is used to report the result of a SetTimeZone command.
|
server→client |
DSTOffsetRequired: boolean |
| 0x04 |
SetDSTOffset
Optional invoke: manage
This command is used to set the DST offsets for a node.
|
client→server |
DSTOffset: DSTOffsetStruct |
| 0x05 |
SetDefaultNTP
Optional invoke: administer
This command is used to set the DefaultNTP attribute.
|
client→server |
DefaultNTP: char_string |
TimeZone
(TZ)
bit 0
Server supports time zone.
NTPClient
(NTPC)
bit 1
Server supports an NTP or SNTP client.
NTPServer
(NTPS)
bit 2
Server supports an NTP server role.
TimeSyncClient
(TSC)
bit 3
Time synchronization client cluster is present.
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
Devices Implementing This Cluster
72 devices in the survey implement this cluster
Yale Linus Smart Lock L2 Lite
ASSA Abloy AB
Aqara Smart Lock J200 Set
Aqara
Touchscreen Switch S100
Aqara
TNKPLU261
tink
Eve MotionBlinds
Eve Systems
SMART MAT ORBIS DL 400 TW WT
LEDVANCE
Aqara Smart Lock U600
Aqara
Smart Wi-Fi Plug
Phaten
ULTRALOQ Smart Door Lock
U-tec Group Inc.
Smart Timer Light
ThirdReality
GW60-Matter
MIUC
SMART MAT P40 RGBW 827 FR E14
LEDVANCE
Schlage Sense Pro
Schlage
Doorman L4
ASSA Abloy AB
Eve MotionBlinds
Eve Systems
Onvis Outlet T20
Onvis
TNKMSE251
tink
Eve Thermostat
Eve Systems
Halo Select
ASSA ABLOY Americas Residential
Zigbee Bridge Ultra
SONOFF
Smart Home Hub
Hama GmbH
Grimsholm Smart Irrigation Valve
Grimsholm Products AB
LEDVANCE SMART WIFI MAT PLUG EU WH
LEDVANCE
MATTER FLEX RGBTW EU
LEDVANCE