Struct TrapConfig

pub struct TrapConfig {
    pub valid: bool,
    pub level: u8,
    pub port: u8,
    pub pin: u8,
}

Represents the configuration of a hardware trap.

A TrapConfig structure holds information related to a trap configuration, including the pin, port, level, and validity of the trap. The fields are packed into a 16-bit integer with specific bitwise encoding. The layout of the 16-bit value is as follows:

Layout (16-bit integer):
0               8             15
0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|   pin   | port|l|           |v|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Where:

• v (bit 15) represents the validity of the trap configuration (1 for valid, 0 for invalid).
• l (bit 8) represents the level of the trap (0 or 1).
• port (bits 5 to 7) represents the port number (3 bits, value range from 0 to 7).
• pin (bits 0 to 4) represents the pin number (5 bits, value range from 0 to 31).

Type Implementation:

• TrapConfig can be created from a 16-bit integer using the From<u16> trait, and it can be converted back to a 16-bit integer using the Into<u16> trait.

The packing and unpacking logic allows easy conversion between the TrapConfig struct and a single 16-bit integer, which is useful for hardware register manipulation.

Fields

valid: bool

Whether the trap configuration is valid (1 bit).

level: u8

The level of the trap (1 bit, 0 or 1).

port: u8

The port number (3 bits, value range: 0-7).

pin: u8

The pin number (5 bits, value range: 0-31).

Trait Implementations

impl Clone for TrapConfig

fn clone(&self) -> TrapConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TrapConfig

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

Formats the value using the given formatter.

impl Default for TrapConfig

fn default() -> Self

Returns a default TrapConfig with all fields set to 0 or false.

impl<'de> Deserialize<'de> for TrapConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<u16> for TrapConfig

fn from(value: u16) -> Self

Converts a 16-bit integer to a TrapConfig by unpacking the respective bits according to the layout described above.

Arguments:

• value: The 16-bit integer to convert into a TrapConfig.

Returns:

A TrapConfig where each field is populated based on the respective bits in the 16-bit integer.

impl Into<u16> for TrapConfig

fn into(self) -> u16

Converts a TrapConfig back into a 16-bit integer by packing the fields into their respective bit positions.

Returns:

A 16-bit integer representing the packed values of the TrapConfig fields.

impl Serialize for TrapConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for TrapConfig