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
41 devices in the survey implement this cluster
Eve Energy
Eve Systems
Magic Cube WS01
Energy Magic Cube
TNKE27241
tink GmbH
Eve MotionBlinds
Eve Systems
LEDVANCE MATTER COMPACT OUTD PLUG
LEDVANCE
Aqara Thermostat Hub W200
Aqara
SMART WIFI MAT DUPLO 580 IP44 TW
LEDVANCE
Yale Linus Smart Lock L2 Lite
Yale
Eve Shutter Switch
Eve Systems
Smart Wi-Fi Plug
Phaten
Eve MotionBlinds
Eve Systems
Touchscreen Switch S100
Aqara
Eve MotionBlinds
Eve Systems
Mthread
MiBoxer
Halo Select
Kwikset
Grimsholm Smart Irrigation Valve
Grimsholm Products AB
Aqara Smart Lock J200 Set
Aqara