Struct tock_registers::fields::Field

pub struct Field<T: UIntLike, R: RegisterLongName> {
    pub mask: T,
    pub shift: usize,
    /* private fields */
}

Specific section of a register.

For the Field, the mask is unshifted, ie. the LSB should always be set.

Fields

mask: T

shift: usize

Implementations

impl<T: UIntLike, R: RegisterLongName> Field<T, R>

pub const fn new(mask: T, shift: usize) -> Field<T, R>

pub fn read(self, val: T) -> T

pub fn is_set(self, val: T) -> bool

Check if one or more bits in a field are set

pub fn read_as_enum<E: TryFromValue<T, EnumType = E>>(self, val: T) -> Option<E>

Read value of the field as an enum member

This method expects to be passed the unasked and unshifted register value, extracts the field value by calling Field::read and subsequently passes that value to the TryFromValue implementation on the passed enum type.

The register_bitfields! macro will generate an enum containing the various named field variants and implementing the required TryFromValue trait. It is accessible as $REGISTER_NAME::$FIELD_NAME::Value.

This method can be useful to symbolically represent read register field states throughout the codebase and to enforce exhaustive matches over all defined valid register field values.

Usage Example

register_bitfields![u8,
    EXAMPLEREG [
        TESTFIELD OFFSET(3) NUMBITS(3) [
            Foo = 2,
            Bar = 3,
            Baz = 6,
        ],
    ],
];

match EXAMPLEREG::TESTFIELD.read_as_enum(0x9C) {
    Some(EXAMPLEREG::TESTFIELD::Value::Bar) => "The value is 3!",
    _ => panic!("boo!"),
};

impl<R: RegisterLongName> Field<u8, R>

pub const fn val(&self, value: u8) -> FieldValue<u8, R>

impl<R: RegisterLongName> Field<u16, R>

pub const fn val(&self, value: u16) -> FieldValue<u16, R>

impl<R: RegisterLongName> Field<u32, R>

pub const fn val(&self, value: u32) -> FieldValue<u32, R>

impl<R: RegisterLongName> Field<u64, R>

pub const fn val(&self, value: u64) -> FieldValue<u64, R>

impl<R: RegisterLongName> Field<u128, R>

pub const fn val(&self, value: u128) -> FieldValue<u128, R>

impl<R: RegisterLongName> Field<usize, R>

pub const fn val(&self, value: usize) -> FieldValue<usize, R>

Trait Implementations

impl<T: UIntLike, R: RegisterLongName> Clone for Field<T, R>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: UIntLike, R: RegisterLongName> Copy for Field<T, R>