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
49 devices in the survey implement this cluster