Struct BasicInfoSettings 

pub struct BasicInfoSettings {
    pub node_label: StringInner<usize, VecStorageInner<[MaybeUninit<u8>; 32]>>,
    pub location: Option<StringInner<usize, VecStorageInner<[MaybeUninit<u8>; 2]>>>,
    pub location_type: Option<RegulatoryLocationTypeEnum>,
    pub local_config_disabled: bool,
    pub configuration_version: u32,
    pub device_location: Option<Maybe<DeviceLocation, AsNullable>>,
    pub recovery_identifier: Option<u64>,
}

Mutable basic information

Fields

node_label: StringInner<usize, VecStorageInner<[MaybeUninit<u8>; 32]>>

location: Option<StringInner<usize, VecStorageInner<[MaybeUninit<u8>; 2]>>>

location_type: Option<RegulatoryLocationTypeEnum>

The regulatory location type, as set via GeneralCommissioning::SetRegulatoryConfig.

local_config_disabled: bool

configuration_version: u32

BasicInformation::ConfigurationVersion (Matter Core Spec). Non-volatile, monotonically increasing, minimum 1. Bumped by application code via InteractionModel::bump_configuration_version whenever the node’s fixed-quality surface (Server/Parts list, device types, software version, …) changes — see Matter Core Spec.

device_location: Option<Maybe<DeviceLocation, AsNullable>>

BasicInformation::DeviceLocation (provisional in the Matter 1.6 IDL): where the device is installed, admin-writable.

recovery_identifier: Option<u64>

GeneralCommissioning::RecoveryIdentifier (provisional in Matter 1.6): a random 64-bit value that identifies this node during the Network Recovery flow without revealing its Node ID.

NOTE: keep this field last - the persisted-blob TLV tags are positional, and appending preserves compatibility with blobs written before the field existed.

Implementations

impl BasicInfoSettings

pub const fn new() -> BasicInfoSettings

Create a new instance of BasicInfoSettings

pub fn init() -> impl Init<BasicInfoSettings>

Return an in-place initializer for BasicInfoSettings

pub fn reset(&mut self)

Resets the basic info to initial values

Arguments

• flag_changed: whether to mark the basic info settings as changed

pub fn bump_configuration_version(&mut self) -> u32

Bump ConfigurationVersion by one and return the new value.

Saturates at u32::MAX (the spec gives no wrap semantics, so staying at the max is safer than rolling over to 0 which would violate the min 1 constraint).

This routine only mutates the in-memory value. Persistence and subscriber notification are the caller’s responsibility — use InteractionModel::bump_configuration_version for the full “bump + persist + notify + dataver-bump” pass.

pub fn set_location(&mut self, location: &str)

Set the location (country code) to the given (2-character) value.

pub fn reset_persist<S>( &mut self, store: S, buf: &mut [u8], ) -> Result<(), Error>

where S: KvBlobStore,

Remove all basic info settings from the provided BLOB store as well as from memory

Arguments

• store: the BLOB store to remove the settings from
• buf: a temporary buffer to use for removing the settings

pub fn load(&mut self, data: &[u8]) -> Result<(), Error>

Load basic info settings from the provided byte slice

pub fn store_persist<S>(&self, persist: &mut Persist<S>) -> Result<(), Error>

where S: KvBlobStoreAccess,

Store the basic info settings via the provided Persist instance

Arguments

• persist: the Persist instance to serialize the settings into

Deliberately outlined (inline(never)): the settings’ TLV serialization is sizeable, and every runtime-mutable-attribute setter ends with this call - sharing a single copy keeps it out of each attribute-dispatch path (flash size).

pub fn load_persist<S>(&mut self, store: S, buf: &mut [u8]) -> Result<(), Error>

where S: KvBlobStore,

Load all basic info settings from the provided BLOB store

Arguments

• store: the BLOB store to load the fabrics from
• buf: a temporary buffer to use for loading the fabrics

Trait Implementations

impl Clone for BasicInfoSettings

fn clone(&self) -> BasicInfoSettings

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BasicInfoSettings

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for BasicInfoSettings

fn default() -> BasicInfoSettings

Returns the “default value” for a type.

impl Eq for BasicInfoSettings

impl<'__from_tlv> FromTLV<'__from_tlv> for BasicInfoSettings

fn from_tlv( element: &TLVElement<'__from_tlv>, ) -> Result<BasicInfoSettings, Error>

Deserialize the type from a TLV-encoded element.

fn init_from_tlv( element: TLVElement<'__from_tlv>, ) -> impl Init<BasicInfoSettings, Error>

Generate an in-place initializer for the type that initializes the type from a TLV-encoded element.

fn nullable_from_tlv(element: &TLVElement<'a>) -> Result<Self, Error>

Deserialize the type from a TLV-encoded element.

fn init_nullable_from_tlv(element: TLVElement<'a>) -> impl Init<Self, Error>

Generate an in-place initializer for the type that initializes the type from a TLV-encoded element.

impl Hash for BasicInfoSettings

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BasicInfoSettings

fn eq(&self, other: &BasicInfoSettings) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BasicInfoSettings

impl ToTLV for BasicInfoSettings

fn to_tlv<W>(&self, tag: &TLVTag, tw: W) -> Result<(), Error>

where W: TLVWrite,

Serialize the type to a TLV-encoded stream.

fn tlv_iter(&self, tag: TLVTag) -> impl Iterator<Item = Result<TLV<'_>, Error>>

Serialize the type as an iterator of TLV instances by potentially borrowing data from the type.

fn nullable_to_tlv<W>(&self, tag: &TLVTag, tw: W) -> Result<(), Error>

where W: TLVWrite,

Serialize the type to a TLV-encoded stream.

fn nullable_tlv_iter( &self, tag: TLVTag, ) -> impl Iterator<Item = Result<TLV<'_>, Error>>

Serialize the type as an iterator of TLV instances by potentially borrowing data from the type.

impl<'__from_tlv> TryFrom<&TLVElement<'__from_tlv>> for BasicInfoSettings

type Error = Error

The type returned in the event of a conversion error.

fn try_from( element: &TLVElement<'__from_tlv>, ) -> Result<BasicInfoSettings, <BasicInfoSettings as TryFrom<&TLVElement<'__from_tlv>>>::Error>

Performs the conversion.