1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
/*
*
* Copyright (c) 2023-2026 Project CHIP Authors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
//! Wall-clock constants: Matter-epoch conversion, the cert
//! `NotAfter = no-expiration` sentinel, and the firmware build-time
//! seed emitted by `build.rs`.
//!
//! Every rs-matter consumer that needs calendar time (cert path
//! validation, the TimeSync cluster's mandatory `UTCTime` /
//! `Granularity` / `TimeSource` / `SetUTCTime`, the NOC attestation
//! timestamp, …) reads / writes the Last-Known-Good UTC Time on the
//! [`crate::Matter`] object via [`crate::Matter::last_known_utc_time`]
//! / [`crate::Matter::utc_time`] / [`crate::Matter::set_utc_time`].
//! That value is persisted (per Matter Core spec), seeded
//! from [`FIRMWARE_BUILD_MATTER_US`] on a freshly-flashed device, and
//! is the single source of truth — application code that has access
//! to a real-time clock or NTP samples should feed those into
//! [`crate::Matter::set_utc_time`] directly.
/// Seconds between the UNIX epoch (1970-01-01T00:00:00Z UTC) and the
/// Matter epoch (2000-01-01T00:00:00Z UTC). Add this constant to a
/// Matter-epoch value to get a UNIX-epoch value, or subtract it from
/// a UNIX-epoch value to get a Matter-epoch value.
pub const MATTER_EPOCH_SECS: u64 = 946_684_800;
/// Matter-epoch value used in cert `NotAfter` fields to mean "no
/// expiration" — corresponds to the X.509 `99991231235959Z`
/// generalized-time sentinel translated to Matter-epoch seconds.
///
/// `MATTER_CERT_DOESNT_EXPIRE = epoch(99991231235959Z) - MATTER_EPOCH_SECS`.
pub const MATTER_CERT_DOESNT_EXPIRE: u64 = 252_455_615_999;
// Pulls in `pub const FIRMWARE_BUILD_MATTER_US: u64 = …;` written by
// `build.rs`. Used by `MatterState::LkgUtc` as the seed value for the
// Last-Known-Good UTC Time on a freshly-flashed device.
include!;