Struct TimeSyncClient 

pub struct TimeSyncClient<'a, C> { /* private fields */ }

Initiator-side TimeSync client. Periodically reads UTCTime from the configured trusted source and stores it as the device’s new Last-Known-Good UTC Time (Matter Core spec).

Holds a borrow of the Matter instance for its lifetime; the run / refresh_once methods take the KV-store handle and the attribute-change notifier (typically your InteractionModel) by reference so the same client struct can be re-used across refresh cycles.

Implementations

impl<'a, C> TimeSyncClient<'a, C>

where C: Crypto,

pub const fn new(matter: &'a Matter<'a>, crypto: C) -> TimeSyncClient<'a, C>

Create a new client bound to matter.

crypto is needed because reading the trusted time source may require establishing a fresh CASE session (via Exchange::initiate) when none is cached.

pub async fn run<S, N>( &self, period: Duration, kv: S, notify: &N, ) -> Result<(), Error>

where S: KvBlobStoreAccess, N: AttrChangeNotifier,

Run the periodic refresh loop. Calls Self::refresh_once every period; logs and continues on any per-cycle error so a single bad exchange doesn’t take the task down. Never returns under normal operation.

pub async fn refresh_once<S, N>(&self, kv: S, notify: &N) -> Result<(), Error>

where S: KvBlobStoreAccess, N: AttrChangeNotifier,

Perform a single refresh cycle.

• If no Trusted Time Source is configured, returns Ok(()) with no action.
• Otherwise opens a CASE-secured initiator exchange to the configured (fab_idx, node_id), reads the UTCTime attribute on the configured endpoint, and on a non-null result calls [Matter::set_utc_time] with Granularity = SecondsGranularity and TimeSource = NodeTimeCluster (per spec — the source that this device used to sync its time was another node’s TimeSync cluster).