pub struct CommissioningWindow { /* private fields */ }Expand description
The node’s commissioning window.
Implementations§
Source§impl CommissioningWindow
impl CommissioningWindow
Sourcepub fn install(&mut self, window: OpenWindow)
pub fn install(&mut self, window: OpenWindow)
Installs a window. The cluster that calls this has already checked §11.19’s preconditions; this is the state change they guard.
Sourcepub fn open(&self, now: Instant) -> Option<&OpenWindow>
pub fn open(&self, now: Instant) -> Option<&OpenWindow>
The window, if one is open as of now.
Expiry is lazy, as everywhere else in this crate: a caller that never asks never learns,
and a device drives it from CommissioningWindow::deadline.
Sourcepub fn status(&self, now: Instant) -> WindowStatus
pub fn status(&self, now: Instant) -> WindowStatus
WindowStatus (§11.19.7.1).
“This attribute SHALL revert to WindowNotOpen upon expiry of a commissioning window.”
Sourcepub fn close(&mut self)
pub fn close(&mut self)
Closes the window and destroys the ephemeral verifier with it.
§11.19.8.1: the verifier “SHALL be deleted by the Node at the end of commissioning or
expiration of the OpenCommissioningWindow command”. Dropping EphemeralVerifier is
what does it — it is ZeroizeOnDrop, so the material is wiped rather than merely
forgotten.
Sourcepub fn forget_fabric(&mut self, fabric: FabricIndex)
pub fn forget_fabric(&mut self, fabric: FabricIndex)
Clears AdminFabricIndex when the administrator’s fabric is removed (§11.19.7.2).
The vendor id stays: §11.19.7.3 is explicit that it “SHALL NOT be updated”.
Sourcepub fn ephemeral(&self, now: Instant) -> Option<&EphemeralVerifier>
pub fn ephemeral(&self, now: Instant) -> Option<&EphemeralVerifier>
The PAKE material a PASE responder should use for this window.
None means “use the device’s own factory verifier” — a Basic window, or no window at
all. A device must still check CommissioningWindow::status before accepting a PASE
session; this only says which verifier applies.