Struct PebHeader 

pub struct PebHeader {
    pub magic: [u8; 4],
    pub erase_count: u32,
    pub status: PebStatus,
    pub peb_reserved: u8,
    pub version: u8,
    pub reserved: u8,
}

PEB header.

This struct represents the on-flash header of a Physical Erase Block (PEB). It stores metadata required for flash management, wear leveling, and recovery logic.

The layout maps directly to struct peb_header_t in the original C implementation and must not be altered.

Fields

magic: [u8; 4]

Magic value identifying a valid PEB header. (NVDM)

This field is used to validate that the flash block contains a properly initialized PEB header.

erase_count: u32

Erase count of the PEB.

This value tracks how many times the block has been erased and is typically used for wear-leveling decisions.

status: PebStatus

Current status of the PEB.

This field encodes the lifecycle state of the PEB, such as virgin, active, transferring, or reclaiming.

peb_reserved: u8

Reserved byte specific to PEB metadata.

This field is reserved for future use and should be preserved as-is to maintain binary compatibility.

version: u8

Version of the PEB header format.

This field allows future extensions of the PEB header layout.

reserved: u8

Reserved field.

This field is reserved and should be written as zero.

Trait Implementations

impl BinarySize for PebHeader

fn binary_size() -> usize

Returns the binary size of the PebHeader in bytes.

Layout:

• Fixed-size
• Total: 12 bytes

impl Debug for PebHeader

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

Formats the value using the given formatter.

impl Default for PebHeader

fn default() -> Self

Creates a default PebHeader instance with invalid / erased values.

Default semantics:

• magic: 0xFFFF_FFFF (invalid magic)
• erase_count: 0
• status: PebStatus::Virgin
• peb_reserved: 0xFF
• version: 0
• reserved: 0

impl FromStream for PebHeader

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

where R: Read,

Reads a PebHeader from a binary stream.

Parameters

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

Returns

• Ok(()) if the header was successfully parsed.
• Err(Error) if an I/O or conversion error occurs.

impl ToStream for PebHeader

fn write_to<W>(&self, writer: &mut W) -> Result<(), Error>

where W: Write,

Serializes the PebHeader to a binary stream.

Parameters

• writer: A mutable reference to a writer implementing Write.

Returns

• Ok(()) if serialization succeeds.
• Err(Error) if an I/O error occurs.