use core::marker; /// Raw register type (`u8`, `u16`, `u32`, ...) pub trait RawReg: Copy + Default + From + core::ops::BitOr + core::ops::BitAnd + core::ops::BitOrAssign + core::ops::BitAndAssign + core::ops::Not + core::ops::Shl { /// Mask for bits of width `WI` fn mask() -> Self; /// Mask for bits of width 1 fn one() -> Self; } macro_rules! raw_reg { ($U:ty, $size:literal, $mask:ident) => { impl RawReg for $U { #[inline(always)] fn mask() -> Self { $mask::() } #[inline(always)] fn one() -> Self { 1 } } const fn $mask() -> $U { <$U>::MAX >> ($size - WI) } impl FieldSpec for $U { type Ux = $U; } }; } raw_reg!(u8, 8, mask_u8); raw_reg!(u16, 16, mask_u16); raw_reg!(u32, 32, mask_u32); raw_reg!(u64, 64, mask_u64); /// Raw register type pub trait RegisterSpec { /// Raw register type (`u8`, `u16`, `u32`, ...). type Ux: RawReg; } /// Raw field type pub trait FieldSpec: Sized { /// Raw field type (`u8`, `u16`, `u32`, ...). type Ux: Copy + PartialEq + From; } /// Trait implemented by readable registers to enable the `read` method. /// /// Registers marked with `Writable` can be also be `modify`'ed. pub trait Readable: RegisterSpec {} /// Trait implemented by writeable registers. /// /// This enables the `write`, `write_with_zero` and `reset` methods. /// /// Registers marked with `Readable` can be also be `modify`'ed. pub trait Writable: RegisterSpec { /// Specifies the register bits that are not changed if you pass `1` and are changed if you pass `0` const ZERO_TO_MODIFY_FIELDS_BITMAP: Self::Ux; /// Specifies the register bits that are not changed if you pass `0` and are changed if you pass `1` const ONE_TO_MODIFY_FIELDS_BITMAP: Self::Ux; } /// Reset value of the register. /// /// This value is the initial value for the `write` method. It can also be directly written to the /// register by using the `reset` method. pub trait Resettable: RegisterSpec { /// Reset value of the register. const RESET_VALUE: Self::Ux; /// Reset value of the register. #[inline(always)] fn reset_value() -> Self::Ux { Self::RESET_VALUE } } /// This structure provides volatile access to registers. #[repr(transparent)] pub struct Reg { register: vcell::VolatileCell, _marker: marker::PhantomData, } unsafe impl Send for Reg where REG::Ux: Send {} impl Reg { /// Returns the underlying memory address of register. /// /// ```ignore /// let reg_ptr = periph.reg.as_ptr(); /// ``` #[inline(always)] pub fn as_ptr(&self) -> *mut REG::Ux { self.register.as_ptr() } } impl Reg { /// Reads the contents of a `Readable` register. /// /// You can read the raw contents of a register by using `bits`: /// ```ignore /// let bits = periph.reg.read().bits(); /// ``` /// or get the content of a particular field of a register: /// ```ignore /// let reader = periph.reg.read(); /// let bits = reader.field1().bits(); /// let flag = reader.field2().bit_is_set(); /// ``` #[inline(always)] pub fn read(&self) -> R { R { bits: self.register.get(), _reg: marker::PhantomData, } } } impl Reg { /// Writes the reset value to `Writable` register. /// /// Resets the register to its initial state. #[inline(always)] pub fn reset(&self) { self.register.set(REG::RESET_VALUE) } /// Writes bits to a `Writable` register. /// /// You can write raw bits into a register: /// ```ignore /// periph.reg.write(|w| unsafe { w.bits(rawbits) }); /// ``` /// or write only the fields you need: /// ```ignore /// periph.reg.write(|w| w /// .field1().bits(newfield1bits) /// .field2().set_bit() /// .field3().variant(VARIANT) /// ); /// ``` /// or an alternative way of saying the same: /// ```ignore /// periph.reg.write(|w| { /// w.field1().bits(newfield1bits); /// w.field2().set_bit(); /// w.field3().variant(VARIANT) /// }); /// ``` /// In the latter case, other fields will be set to their reset value. #[inline(always)] pub fn write(&self, f: F) where F: FnOnce(&mut W) -> &mut W, { self.register.set( f(&mut W { bits: REG::RESET_VALUE & !REG::ONE_TO_MODIFY_FIELDS_BITMAP | REG::ZERO_TO_MODIFY_FIELDS_BITMAP, _reg: marker::PhantomData, }) .bits, ); } } impl Reg { /// Writes 0 to a `Writable` register. /// /// Similar to `write`, but unused bits will contain 0. /// /// # Safety /// /// Unsafe to use with registers which don't allow to write 0. #[inline(always)] pub unsafe fn write_with_zero(&self, f: F) where F: FnOnce(&mut W) -> &mut W, { self.register.set( f(&mut W { bits: REG::Ux::default(), _reg: marker::PhantomData, }) .bits, ); } } impl Reg { /// Modifies the contents of the register by reading and then writing it. /// /// E.g. to do a read-modify-write sequence to change parts of a register: /// ```ignore /// periph.reg.modify(|r, w| unsafe { w.bits( /// r.bits() | 3 /// ) }); /// ``` /// or /// ```ignore /// periph.reg.modify(|_, w| w /// .field1().bits(newfield1bits) /// .field2().set_bit() /// .field3().variant(VARIANT) /// ); /// ``` /// or an alternative way of saying the same: /// ```ignore /// periph.reg.modify(|_, w| { /// w.field1().bits(newfield1bits); /// w.field2().set_bit(); /// w.field3().variant(VARIANT) /// }); /// ``` /// Other fields will have the value they had before the call to `modify`. #[inline(always)] pub fn modify(&self, f: F) where for<'w> F: FnOnce(&R, &'w mut W) -> &'w mut W, { let bits = self.register.get(); self.register.set( f( &R { bits, _reg: marker::PhantomData, }, &mut W { bits: bits & !REG::ONE_TO_MODIFY_FIELDS_BITMAP | REG::ZERO_TO_MODIFY_FIELDS_BITMAP, _reg: marker::PhantomData, }, ) .bits, ); } } #[doc(hidden)] pub mod raw { use super::{marker, BitM, FieldSpec, RegisterSpec, Unsafe, Writable}; pub struct R { pub(crate) bits: REG::Ux, pub(super) _reg: marker::PhantomData, } pub struct W { ///Writable bits pub(crate) bits: REG::Ux, pub(super) _reg: marker::PhantomData, } pub struct FieldReader where FI: FieldSpec, { pub(crate) bits: FI::Ux, _reg: marker::PhantomData, } impl FieldReader { /// Creates a new instance of the reader. #[allow(unused)] #[inline(always)] pub(crate) const fn new(bits: FI::Ux) -> Self { Self { bits, _reg: marker::PhantomData, } } } pub struct BitReader { pub(crate) bits: bool, _reg: marker::PhantomData, } impl BitReader { /// Creates a new instance of the reader. #[allow(unused)] #[inline(always)] pub(crate) const fn new(bits: bool) -> Self { Self { bits, _reg: marker::PhantomData, } } } pub struct FieldWriter<'a, REG, const WI: u8, FI = u8, Safety = Unsafe> where REG: Writable + RegisterSpec, FI: FieldSpec, { pub(crate) w: &'a mut W, pub(crate) o: u8, _field: marker::PhantomData<(FI, Safety)>, } impl<'a, REG, const WI: u8, FI, Safety> FieldWriter<'a, REG, WI, FI, Safety> where REG: Writable + RegisterSpec, FI: FieldSpec, { /// Creates a new instance of the writer #[allow(unused)] #[inline(always)] pub(crate) fn new(w: &'a mut W, o: u8) -> Self { Self { w, o, _field: marker::PhantomData, } } } pub struct BitWriter<'a, REG, FI = bool, M = BitM> where REG: Writable + RegisterSpec, bool: From, { pub(crate) w: &'a mut W, pub(crate) o: u8, _field: marker::PhantomData<(FI, M)>, } impl<'a, REG, FI, M> BitWriter<'a, REG, FI, M> where REG: Writable + RegisterSpec, bool: From, { /// Creates a new instance of the writer #[allow(unused)] #[inline(always)] pub(crate) fn new(w: &'a mut W, o: u8) -> Self { Self { w, o, _field: marker::PhantomData, } } } } /// Register reader. /// /// Result of the `read` methods of registers. Also used as a closure argument in the `modify` /// method. pub type R = raw::R; impl R { /// Reads raw bits from register. #[inline(always)] pub const fn bits(&self) -> REG::Ux { self.bits } } impl PartialEq for R where REG::Ux: PartialEq, FI: Copy, REG::Ux: From, { #[inline(always)] fn eq(&self, other: &FI) -> bool { self.bits.eq(®::Ux::from(*other)) } } /// Register writer. /// /// Used as an argument to the closures in the `write` and `modify` methods of the register. pub type W = raw::W; /// Field reader. /// /// Result of the `read` methods of fields. pub type FieldReader = raw::FieldReader; /// Bit-wise field reader pub type BitReader = raw::BitReader; impl FieldReader { /// Reads raw bits from field. #[inline(always)] pub const fn bits(&self) -> FI::Ux { self.bits } } impl PartialEq for FieldReader where FI: FieldSpec + Copy, { #[inline(always)] fn eq(&self, other: &FI) -> bool { self.bits.eq(&FI::Ux::from(*other)) } } impl PartialEq for BitReader where FI: Copy, bool: From, { #[inline(always)] fn eq(&self, other: &FI) -> bool { self.bits.eq(&bool::from(*other)) } } impl BitReader { /// Value of the field as raw bits. #[inline(always)] pub const fn bit(&self) -> bool { self.bits } /// Returns `true` if the bit is clear (0). #[inline(always)] pub const fn bit_is_clear(&self) -> bool { !self.bit() } /// Returns `true` if the bit is set (1). #[inline(always)] pub const fn bit_is_set(&self) -> bool { self.bit() } } #[doc(hidden)] pub struct Safe; #[doc(hidden)] pub struct Unsafe; /// Write field Proxy with unsafe `bits` pub type FieldWriter<'a, REG, const WI: u8, FI = u8> = raw::FieldWriter<'a, REG, WI, FI, Unsafe>; /// Write field Proxy with safe `bits` pub type FieldWriterSafe<'a, REG, const WI: u8, FI = u8> = raw::FieldWriter<'a, REG, WI, FI, Safe>; impl<'a, REG, const WI: u8, FI> FieldWriter<'a, REG, WI, FI> where REG: Writable + RegisterSpec, FI: FieldSpec, REG::Ux: From, { /// Field width pub const WIDTH: u8 = WI; /// Field width #[inline(always)] pub const fn width(&self) -> u8 { WI } /// Field offset #[inline(always)] pub const fn offset(&self) -> u8 { self.o } /// Writes raw bits to the field /// /// # Safety /// /// Passing incorrect value can cause undefined behaviour. See reference manual #[inline(always)] pub unsafe fn bits(self, value: FI::Ux) -> &'a mut W { self.w.bits &= !(REG::Ux::mask::() << self.o); self.w.bits |= (REG::Ux::from(value) & REG::Ux::mask::()) << self.o; self.w } /// Writes `variant` to the field #[inline(always)] pub fn variant(self, variant: FI) -> &'a mut W { unsafe { self.bits(FI::Ux::from(variant)) } } } impl<'a, REG, const WI: u8, FI> FieldWriterSafe<'a, REG, WI, FI> where REG: Writable + RegisterSpec, FI: FieldSpec, REG::Ux: From, { /// Field width pub const WIDTH: u8 = WI; /// Field width #[inline(always)] pub const fn width(&self) -> u8 { WI } /// Field offset #[inline(always)] pub const fn offset(&self) -> u8 { self.o } /// Writes raw bits to the field #[inline(always)] pub fn bits(self, value: FI::Ux) -> &'a mut W { self.w.bits &= !(REG::Ux::mask::() << self.o); self.w.bits |= (REG::Ux::from(value) & REG::Ux::mask::()) << self.o; self.w } /// Writes `variant` to the field #[inline(always)] pub fn variant(self, variant: FI) -> &'a mut W { self.bits(FI::Ux::from(variant)) } } macro_rules! bit_proxy { ($writer:ident, $mwv:ident) => { #[doc(hidden)] pub struct $mwv; /// Bit-wise write field proxy pub type $writer<'a, REG, FI = bool> = raw::BitWriter<'a, REG, FI, $mwv>; impl<'a, REG, FI> $writer<'a, REG, FI> where REG: Writable + RegisterSpec, bool: From, { /// Field width pub const WIDTH: u8 = 1; /// Field width #[inline(always)] pub const fn width(&self) -> u8 { Self::WIDTH } /// Field offset #[inline(always)] pub const fn offset(&self) -> u8 { self.o } /// Writes bit to the field #[inline(always)] pub fn bit(self, value: bool) -> &'a mut W { self.w.bits &= !(REG::Ux::one() << self.o); self.w.bits |= (REG::Ux::from(value) & REG::Ux::one()) << self.o; self.w } /// Writes `variant` to the field #[inline(always)] pub fn variant(self, variant: FI) -> &'a mut W { self.bit(bool::from(variant)) } } }; } bit_proxy!(BitWriter, BitM); bit_proxy!(BitWriter1S, Bit1S); bit_proxy!(BitWriter0C, Bit0C); bit_proxy!(BitWriter1C, Bit1C); bit_proxy!(BitWriter0S, Bit0S); bit_proxy!(BitWriter1T, Bit1T); bit_proxy!(BitWriter0T, Bit0T); impl<'a, REG, FI> BitWriter<'a, REG, FI> where REG: Writable + RegisterSpec, bool: From, { /// Sets the field bit #[inline(always)] pub fn set_bit(self) -> &'a mut W { self.w.bits |= REG::Ux::one() << self.o; self.w } /// Clears the field bit #[inline(always)] pub fn clear_bit(self) -> &'a mut W { self.w.bits &= !(REG::Ux::one() << self.o); self.w } } impl<'a, REG, FI> BitWriter1S<'a, REG, FI> where REG: Writable + RegisterSpec, bool: From, { /// Sets the field bit #[inline(always)] pub fn set_bit(self) -> &'a mut W { self.w.bits |= REG::Ux::one() << self.o; self.w } } impl<'a, REG, FI> BitWriter0C<'a, REG, FI> where REG: Writable + RegisterSpec, bool: From, { /// Clears the field bit #[inline(always)] pub fn clear_bit(self) -> &'a mut W { self.w.bits &= !(REG::Ux::one() << self.o); self.w } } impl<'a, REG, FI> BitWriter1C<'a, REG, FI> where REG: Writable + RegisterSpec, bool: From, { ///Clears the field bit by passing one #[inline(always)] pub fn clear_bit_by_one(self) -> &'a mut W { self.w.bits |= REG::Ux::one() << self.o; self.w } } impl<'a, REG, FI> BitWriter0S<'a, REG, FI> where REG: Writable + RegisterSpec, bool: From, { ///Sets the field bit by passing zero #[inline(always)] pub fn set_bit_by_zero(self) -> &'a mut W { self.w.bits &= !(REG::Ux::one() << self.o); self.w } } impl<'a, REG, FI> BitWriter1T<'a, REG, FI> where REG: Writable + RegisterSpec, bool: From, { ///Toggle the field bit by passing one #[inline(always)] pub fn toggle_bit(self) -> &'a mut W { self.w.bits |= REG::Ux::one() << self.o; self.w } } impl<'a, REG, FI> BitWriter0T<'a, REG, FI> where REG: Writable + RegisterSpec, bool: From, { ///Toggle the field bit by passing zero #[inline(always)] pub fn toggle_bit(self) -> &'a mut W { self.w.bits &= !(REG::Ux::one() << self.o); self.w } }