Struct NVDM 

pub struct NVDM { /* private fields */ }

Represents the Non-Volatile Data Management (NVDM) system, which manages user data storage in flash memory.

NVDM supports data retention after power off and organizes data items into groups, enabling classification and orderly management of items.

Implementations

impl NVDM

pub fn from_peb_size(peb_size: u32) -> Self

Constructs a new NVDM with the specified physical erase block (PEB) size.

Other fields are initialized with default values.

Parameters

• peb_size: The size of a physical erase block in bytes.

Returns

• An NVDM instance configured with the given PEB size.

pub fn nvdm_port_get_peb_address(&self, pnum: u32, offset: u32) -> u32

Computes the flash address based on PEB number and offset within the PEB.

Parameters

• pnum: The physical erase block number.
• offset: The offset within the PEB.

Returns

• The calculated flash address as a u32.

pub fn get_item( &self, group: &str, name: &str, status: DataItemStatus, ) -> Option<&DataItem>

Retrieves a reference to a data item matching the specified group, name, and status.

Parameters

• group: The group name to match.
• name: The item name to match.
• status: The status of the data item to match.

Returns

• Some(&DataItem) if an item matching all criteria exists.
• None if no matching item is found.

pub fn get_items_by_group( &self, group: &str, status: DataItemStatus, ) -> Vec<&DataItem>

Retrieves all data items within a specified group and having a specified status.

Parameters

• group: The group name to filter by.
• status: The status of the data items to include.

Returns

• A vector of references to matching DataItems.

pub fn get_groups(&self) -> Vec<&str>

Returns a list of unique group names present in the stored data items.

Returns

• A vector of string slices representing distinct group names.

Trait Implementations

impl Default for NVDM

fn default() -> Self

Creates a new NVDM instance with default configuration.

The peb_size is set to the default port-specific PEB size, and the items vector is initialized empty.

Returns

• An NVDM instance with default parameters.

impl FromStream for NVDM

fn read_from<R>(&mut self, reader: &mut R) -> Result<(), Error>

where R: Read + Seek,

Reads the NVDM data from a binary stream, parsing all physical erase blocks (PEBs) and extracting valid data items.

Iterates through each PEB, checking if it is active, then reads data items within, adding valid items to the internal collection.

Parameters

• reader: A mutable reference to a reader implementing Read and Seek.

Returns

• Ok(()) if all data was successfully read.
• Err(Error) if an I/O or parsing error occurs.