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
ALPSTUGA air quality monitor
IKEA of Sweden
Eve Thermo
Eve
Eve Energy
Eve
Aqara Hub
Aqara
YS1606-UC
t0bst4r
Aqara Smart Lock U200
Aqara
Eve Thermo Control
Eve
Aqara Hub
Aqara
Radiator Thermostat W600
Aqara
Eve Weather
Eve
Eve Thermo
Eve
TNKDSE261
tink GmbH
Eve Light Switch
Eve
Aqara Smart Lock U200 Lite
Aqara
Eve MotionBlinds
Eve
TEST_PRODUCT
t0bst4r
Aqara Smart Lock U400
Aqara
Eve Energy
Eve
Eve Dimmer Switch
Eve
Eve Energy
Eve
F1s203-EU
MOES
Yale Smart Lock with Matter over Thread
Fortune Brands
SMART MATDECORWALLTWIST230X127TW
LEDVANCE