Implement Matter Time Sync support for all Matter boards

Author: silabs-bozont

boards.txt

@@ -2,8 +2,7 @@
    Matter Time Synchronization example
 
    The example shows how to receive UTC time (and timezone / DST offsets) from a
-   Matter controller and read them as Unix timestamps using the Arduino Matter
-   API.
+   Matter controller and read them as Unix timestamps using the Arduino Matter API.
 
    The Time Synchronization cluster is enabled on the root endpoint. After the
    device is commissioned, a Matter hub that supports time sync (or chip-tool
@@ -12,6 +11,10 @@
 
    Compatible boards:
    - Arduino Nano Matter
+   - SparkFun Thing Plus Matter
+   - Silicon Labs xG24 Explorer Kit
+   - Silicon Labs xG24 Dev Kit
+   - Seeed Studio XIAO MG24 (Sense)
 
    Author: Tamas Jozsi (Silicon Labs)
  */

libraries/Matter/examples/matter_time_sync/matter_time_sync.ino

@@ -484,13 +484,13 @@ Class for creating and controlling a Matter Power Source appliance with battery
 
 ## class MatterTimeSynchronization
 
-Receives UTC time (and optional timezone / DST offsets) from a Matter controller via the Time Synchronization cluster on the root endpoint (not a bridged appliance). Currently enabled for Arduino Nano Matter.
+Receives UTC time (and optional timezone / DST offsets) from a Matter controller via the Time Synchronization cluster on the root endpoint (not a bridged appliance).
 
 The device does not pull time by itself. A Matter controller that supports time sync must push `SetUTCTime` (and, when the TimeZone feature is advertised, `SetTimeZone` / `SetDSTOffset`). Use `request_time()` to emit a `TimeFailure` event so a supporting controller can push time again.
 
 ### Enabling time sync in Home Assistant
 
-Requires Matter Server **1.2.0+** (Home Assistant Matter Server app **9.1.0+**).
+Requires Matter Server **1.2.0** (Home Assistant Matter Server app **9.1.0**) or later versions.
 
 #### Home Assistant OS / Supervised (Matter Server add-on)
 
@@ -540,11 +540,6 @@ docker exec matterjs-server sh -c 'echo TZ=$TZ; date; node -e "console.log(Intl.
 
 `TZ` must be non-empty and resolve to your IANA zone (not `UTC`), or timezone/DST offsets pushed to the device will be zero.
 
-#### Notes
-
-- After a device reflash/reboot, some Matter Server versions may skip re-sync for up to 24 hours (cooldown). Restarting the Matter Server clears that state. See [matter-js/matterjs-server#938](https://github.com/matter-js/matterjs-server/issues/938).
-- In Matter Server logs, a successful push looks like `timeSynchronization.setUtcTime` (and `setTimeZone` / `setDstOffset` when timezone is supported) with `status: Success`.
-
 ```bool request_time();```
 Emits a `TimeFailure` event on the root endpoint so a supporting controller can push time again. Rate-limited to once per 60 seconds. Returns `false` if skipped by the rate limit or if logging fails. Controllers may still ignore the event during their own cooldown windows.
 

libraries/Matter/readme.md

@@ -96,6 +96,8 @@ component:
     from: matter
   - id: matter_time_format_localization
     from: matter
+  - id: matter_time_synchronization
+    from: matter
   - id: matter_user_label
     from: matter
   - id: matter_switch

package/slcp/thingplusmatter/thingplusmatter_matter.slcp

@@ -98,6 +98,8 @@ component:
     from: matter
   - id: matter_time_format_localization
     from: matter
+  - id: matter_time_synchronization
+    from: matter
   - id: matter_user_label
     from: matter
   - id: matter_switch

package/slcp/xg24devkit/xg24devkit_matter.slcp

@@ -98,6 +98,8 @@ component:
     from: matter
   - id: matter_time_format_localization
     from: matter
+  - id: matter_time_synchronization
+    from: matter
   - id: matter_user_label
     from: matter
   - id: matter_switch

package/slcp/xg24explorerkit/xg24explorerkit_matter.slcp

@@ -98,6 +98,8 @@ component:
     from: matter
   - id: matter_time_format_localization
     from: matter
+  - id: matter_time_synchronization
+    from: matter
   - id: matter_user_label
     from: matter
   - id: matter_switch

package/slcp/xiao_mg24/xiao_mg24_matter.slcp

@@ -252,6 +252,7 @@
     "../../libraries/Matter/examples/matter_sensor_multiple/matter_sensor_multiple.ino":                               all_matter,
     "../../libraries/Matter/examples/matter_switch/matter_switch.ino":                                                 all_matter,
     "../../libraries/Matter/examples/matter_temp_sensor/matter_temp_sensor.ino":                                       all_matter,
+    "../../libraries/Matter/examples/matter_time_sync/matter_time_sync.ino":                                           all_matter,
     "../../libraries/Matter/examples/matter_thermostat/matter_thermostat.ino":                                         all_matter,
     "../../libraries/Matter/examples/matter_tvoc_sensor/matter_tvoc_sensor.ino":                                       all_matter,
     "../../libraries/Matter/examples/matter_window_covering/matter_window_covering.ino":                               all_matter,

test/build/test_build.py

@@ -10,7 +10,7 @@ btconf/gatt_configuration.btconf=-2125273027
 btl_interface_cfg.h=664168518
 btl_interface_cfg_s2c4.h=-733541119
 circular_queue_config.h=130466338
-common/lighting-app.zap=-1264415028
+common/lighting-app.zap=1130675426
 dmadrv_config.h=281221886
 emlib_core_debug_config.h=1524820012
 matter/tracing/build_config.h=-1562925613

variants/thingplusmatter/matter/autogen/.slc_state/.crc_config.crc

@@ -57,6 +57,7 @@
 #define SL_CATALOG_MATTER_THERMOSTAT_PRESENT
 #define SL_CATALOG_MATTER_THREAD_NETWORK_DIAGNOSTICS_PRESENT
 #define SL_CATALOG_MATTER_TIME_FORMAT_LOCALIZATION_PRESENT
+#define SL_CATALOG_MATTER_TIME_SYNCHRONIZATION_PRESENT
 #define SL_CATALOG_MATTER_USER_LABEL_PRESENT
 #define SL_CATALOG_APP_ASSERT_PRESENT
 #define SL_CATALOG_APP_LOG_PRESENT