use core::marker; #[doc = " Raw register type"] pub trait RegisterSpec { #[doc = " Raw register type (`u8`, `u16`, `u32`, ...)."] type Ux: Copy; } #[doc = " Trait implemented by readable registers to enable the `read` method."] #[doc = ""] #[doc = " Registers marked with `Writable` can be also `modify`'ed."] pub trait Readable: RegisterSpec { #[doc = " Result from a call to `read` and argument to `modify`."] type Reader: From> + core::ops::Deref>; } #[doc = " Trait implemented by writeable registers."] #[doc = ""] #[doc = " This enables the `write`, `write_with_zero` and `reset` methods."] #[doc = ""] #[doc = " Registers marked with `Readable` can be also `modify`'ed."] pub trait Writable: RegisterSpec { #[doc = " Writer type argument to `write`, et al."] type Writer: From> + core::ops::DerefMut>; } #[doc = " Reset value of the register."] #[doc = ""] #[doc = " This value is the initial value for the `write` method. It can also be directly written to the"] #[doc = " register by using the `reset` method."] pub trait Resettable: RegisterSpec { #[doc = " Reset value of the register."] fn reset_value() -> Self::Ux; } #[doc = " 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 { #[doc = " Returns the underlying memory address of register."] #[doc = ""] #[doc = " ```ignore"] #[doc = " let reg_ptr = periph.reg.as_ptr();"] #[doc = " ```"] #[inline(always)] pub fn as_ptr(&self) -> *mut REG::Ux { self.register.as_ptr() } } impl Reg { #[doc = " Reads the contents of a `Readable` register."] #[doc = ""] #[doc = " You can read the raw contents of a register by using `bits`:"] #[doc = " ```ignore"] #[doc = " let bits = periph.reg.read().bits();"] #[doc = " ```"] #[doc = " or get the content of a particular field of a register:"] #[doc = " ```ignore"] #[doc = " let reader = periph.reg.read();"] #[doc = " let bits = reader.field1().bits();"] #[doc = " let flag = reader.field2().bit_is_set();"] #[doc = " ```"] #[inline(always)] pub fn read(&self) -> REG::Reader { REG::Reader::from(R { bits: self.register.get(), _reg: marker::PhantomData, }) } } impl Reg { #[doc = " Writes the reset value to `Writable` register."] #[doc = ""] #[doc = " Resets the register to its initial state."] #[inline(always)] pub fn reset(&self) { self.register.set(REG::reset_value()) } #[doc = " Writes bits to a `Writable` register."] #[doc = ""] #[doc = " You can write raw bits into a register:"] #[doc = " ```ignore"] #[doc = " periph.reg.write(|w| unsafe { w.bits(rawbits) });"] #[doc = " ```"] #[doc = " or write only the fields you need:"] #[doc = " ```ignore"] #[doc = " periph.reg.write(|w| w"] #[doc = " .field1().bits(newfield1bits)"] #[doc = " .field2().set_bit()"] #[doc = " .field3().variant(VARIANT)"] #[doc = " );"] #[doc = " ```"] #[doc = " or an alternative way of saying the same:"] #[doc = " ```ignore"] #[doc = " periph.reg.write(|w| {"] #[doc = " w.field1().bits(newfield1bits);"] #[doc = " w.field2().set_bit();"] #[doc = " w.field3().variant(VARIANT)"] #[doc = " });"] #[doc = " ```"] #[doc = " 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 REG::Writer) -> &mut W, { self.register.set( f(&mut REG::Writer::from(W { bits: REG::reset_value(), _reg: marker::PhantomData, })) .bits, ); } } impl Reg where REG::Ux: Default, { #[doc = " Writes 0 to a `Writable` register."] #[doc = ""] #[doc = " Similar to `write`, but unused bits will contain 0."] #[inline(always)] pub unsafe fn write_with_zero(&self, f: F) where F: FnOnce(&mut REG::Writer) -> &mut W, { self.register.set( (*f(&mut REG::Writer::from(W { bits: REG::Ux::default(), _reg: marker::PhantomData, }))) .bits, ); } } impl Reg { #[doc = " Modifies the contents of the register by reading and then writing it."] #[doc = ""] #[doc = " E.g. to do a read-modify-write sequence to change parts of a register:"] #[doc = " ```ignore"] #[doc = " periph.reg.modify(|r, w| unsafe { w.bits("] #[doc = " r.bits() | 3"] #[doc = " ) });"] #[doc = " ```"] #[doc = " or"] #[doc = " ```ignore"] #[doc = " periph.reg.modify(|_, w| w"] #[doc = " .field1().bits(newfield1bits)"] #[doc = " .field2().set_bit()"] #[doc = " .field3().variant(VARIANT)"] #[doc = " );"] #[doc = " ```"] #[doc = " or an alternative way of saying the same:"] #[doc = " ```ignore"] #[doc = " periph.reg.modify(|_, w| {"] #[doc = " w.field1().bits(newfield1bits);"] #[doc = " w.field2().set_bit();"] #[doc = " w.field3().variant(VARIANT)"] #[doc = " });"] #[doc = " ```"] #[doc = " 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(®::Reader, &'w mut REG::Writer) -> &'w mut W, { let bits = self.register.get(); self.register.set( f( ®::Reader::from(R { bits, _reg: marker::PhantomData, }), &mut REG::Writer::from(W { bits, _reg: marker::PhantomData, }), ) .bits, ); } } #[doc = " Register reader."] #[doc = ""] #[doc = " Result of the `read` methods of registers. Also used as a closure argument in the `modify`"] #[doc = " method."] pub struct R { pub(crate) bits: REG::Ux, _reg: marker::PhantomData, } impl R { #[doc = " Reads raw bits from register."] #[inline(always)] pub fn bits(&self) -> REG::Ux { self.bits } } impl PartialEq for R where REG::Ux: PartialEq, FI: Copy + Into, { #[inline(always)] fn eq(&self, other: &FI) -> bool { self.bits.eq(&(*other).into()) } } #[doc = " Register writer."] #[doc = ""] #[doc = " Used as an argument to the closures in the `write` and `modify` methods of the register."] pub struct W { #[doc = "Writable bits"] pub(crate) bits: REG::Ux, _reg: marker::PhantomData, } impl W { #[doc = " Writes raw bits to the register."] #[inline(always)] pub unsafe fn bits(&mut self, bits: REG::Ux) -> &mut Self { self.bits = bits; self } } #[doc(hidden)] pub struct FieldReaderRaw { pub(crate) bits: U, _reg: marker::PhantomData, } impl FieldReaderRaw where U: Copy, { #[doc = " Creates a new instance of the reader."] #[allow(unused)] #[inline(always)] pub(crate) fn new(bits: U) -> Self { Self { bits, _reg: marker::PhantomData, } } } #[doc(hidden)] pub struct BitReaderRaw { pub(crate) bits: bool, _reg: marker::PhantomData, } impl BitReaderRaw { #[doc = " Creates a new instance of the reader."] #[allow(unused)] #[inline(always)] pub(crate) fn new(bits: bool) -> Self { Self { bits, _reg: marker::PhantomData, } } } #[doc = " Field reader."] #[doc = ""] #[doc = " Result of the `read` methods of fields."] pub type FieldReader = FieldReaderRaw; #[doc = " Bit-wise field reader"] pub type BitReader = BitReaderRaw; impl FieldReader where U: Copy, { #[doc = " Reads raw bits from field."] #[inline(always)] pub fn bits(&self) -> U { self.bits } } impl PartialEq for FieldReader where U: PartialEq, FI: Copy + Into, { #[inline(always)] fn eq(&self, other: &FI) -> bool { self.bits.eq(&(*other).into()) } } impl PartialEq for BitReader where FI: Copy + Into, { #[inline(always)] fn eq(&self, other: &FI) -> bool { self.bits.eq(&(*other).into()) } } impl BitReader { #[doc = " Value of the field as raw bits."] #[inline(always)] pub fn bit(&self) -> bool { self.bits } #[doc = " Returns `true` if the bit is clear (0)."] #[inline(always)] pub fn bit_is_clear(&self) -> bool { !self.bit() } #[doc = " Returns `true` if the bit is set (1)."] #[inline(always)] pub fn bit_is_set(&self) -> bool { self.bit() } } #[doc(hidden)] pub struct Safe; #[doc(hidden)] pub struct Unsafe; #[doc(hidden)] pub struct FieldWriterRaw<'a, U, REG, N, FI, Safety, const WI: u8, const O: u8> where REG: Writable + RegisterSpec, FI: Into, { pub(crate) w: &'a mut REG::Writer, _field: marker::PhantomData<(N, FI, Safety)>, } impl<'a, U, REG, N, FI, Safety, const WI: u8, const O: u8> FieldWriterRaw<'a, U, REG, N, FI, Safety, WI, O> where REG: Writable + RegisterSpec, FI: Into, { #[doc = " Creates a new instance of the writer"] #[allow(unused)] #[inline(always)] pub(crate) fn new(w: &'a mut REG::Writer) -> Self { Self { w, _field: marker::PhantomData, } } } #[doc(hidden)] pub struct BitWriterRaw<'a, U, REG, FI, M, const O: u8> where REG: Writable + RegisterSpec, FI: Into, { pub(crate) w: &'a mut REG::Writer, _field: marker::PhantomData<(FI, M)>, } impl<'a, U, REG, FI, M, const O: u8> BitWriterRaw<'a, U, REG, FI, M, O> where REG: Writable + RegisterSpec, FI: Into, { #[doc = " Creates a new instance of the writer"] #[allow(unused)] #[inline(always)] pub(crate) fn new(w: &'a mut REG::Writer) -> Self { Self { w, _field: marker::PhantomData, } } } #[doc = " Write field Proxy with unsafe `bits`"] pub type FieldWriter<'a, U, REG, N, FI, const WI: u8, const O: u8> = FieldWriterRaw<'a, U, REG, N, FI, Unsafe, WI, O>; #[doc = " Write field Proxy with safe `bits`"] pub type FieldWriterSafe<'a, U, REG, N, FI, const WI: u8, const O: u8> = FieldWriterRaw<'a, U, REG, N, FI, Safe, WI, O>; impl<'a, U, REG, N, FI, const WI: u8, const OF: u8> FieldWriter<'a, U, REG, N, FI, WI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = " Field width"] pub const WIDTH: u8 = WI; #[doc = " Field offset"] pub const OFFSET: u8 = OF; } impl<'a, U, REG, N, FI, const WI: u8, const OF: u8> FieldWriterSafe<'a, U, REG, N, FI, WI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = " Field width"] pub const WIDTH: u8 = WI; #[doc = " Field offset"] pub const OFFSET: u8 = OF; } macro_rules! bit_proxy { ($ writer : ident , $ mwv : ident) => { #[doc(hidden)] pub struct $mwv; #[doc = " Bit-wise write field proxy"] pub type $writer<'a, U, REG, FI, const O: u8> = BitWriterRaw<'a, U, REG, FI, $mwv, O>; impl<'a, U, REG, FI, const OF: u8> $writer<'a, U, REG, FI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = " Field width"] pub const WIDTH: u8 = 1; #[doc = " Field offset"] pub const OFFSET: u8 = OF; } }; } macro_rules! impl_bit_proxy { ($ writer : ident , $ U : ty) => { impl<'a, REG, FI, const OF: u8> $writer<'a, $U, REG, FI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = " Writes bit to the field"] #[inline(always)] pub fn bit(self, value: bool) -> &'a mut REG::Writer { self.w.bits = (self.w.bits & !(1 << { OF })) | ((<$U>::from(value) & 1) << { OF }); self.w } #[doc = " Writes `variant` to the field"] #[inline(always)] pub fn variant(self, variant: FI) -> &'a mut REG::Writer { self.bit(variant.into()) } } }; } 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); macro_rules! impl_proxy { ($ U : ty) => { impl<'a, REG, N, FI, const WI: u8, const OF: u8> FieldWriter<'a, $U, REG, N, FI, WI, OF> where REG: Writable + RegisterSpec, N: Into<$U>, FI: Into, { const MASK: $U = <$U>::MAX >> (<$U>::MAX.leading_ones() as u8 - { WI }); #[doc = " Writes raw bits to the field"] #[doc = ""] #[doc = " # Safety"] #[doc = ""] #[doc = " Passing incorrect value can cause undefined behaviour. See reference manual"] #[inline(always)] pub unsafe fn bits(self, value: N) -> &'a mut REG::Writer { self.w.bits = (self.w.bits & !(Self::MASK << { OF })) | ((value.into() & Self::MASK) << { OF }); self.w } #[doc = " Writes `variant` to the field"] #[inline(always)] pub fn variant(self, variant: FI) -> &'a mut REG::Writer { unsafe { self.bits(variant.into()) } } } impl<'a, REG, N, FI, const WI: u8, const OF: u8> FieldWriterSafe<'a, $U, REG, N, FI, WI, OF> where REG: Writable + RegisterSpec, N: Into<$U>, FI: Into, { const MASK: $U = <$U>::MAX >> (<$U>::MAX.leading_ones() as u8 - { WI }); #[doc = " Writes raw bits to the field"] #[inline(always)] pub fn bits(self, value: N) -> &'a mut REG::Writer { self.w.bits = (self.w.bits & !(Self::MASK << { OF })) | ((value.into() & Self::MASK) << { OF }); self.w } #[doc = " Writes `variant` to the field"] #[inline(always)] pub fn variant(self, variant: FI) -> &'a mut REG::Writer { self.bits(variant.into()) } } impl_bit_proxy!(BitWriter, $U); impl_bit_proxy!(BitWriter1S, $U); impl_bit_proxy!(BitWriter0C, $U); impl_bit_proxy!(BitWriter1C, $U); impl_bit_proxy!(BitWriter0S, $U); impl_bit_proxy!(BitWriter1T, $U); impl_bit_proxy!(BitWriter0T, $U); impl<'a, REG, FI, const OF: u8> BitWriter<'a, $U, REG, FI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = " Sets the field bit"] #[inline(always)] pub fn set_bit(self) -> &'a mut REG::Writer { self.bit(true) } #[doc = " Clears the field bit"] #[inline(always)] pub fn clear_bit(self) -> &'a mut REG::Writer { self.bit(false) } } impl<'a, REG, FI, const OF: u8> BitWriter1S<'a, $U, REG, FI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = " Sets the field bit"] #[inline(always)] pub fn set_bit(self) -> &'a mut REG::Writer { self.bit(true) } } impl<'a, REG, FI, const OF: u8> BitWriter0C<'a, $U, REG, FI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = " Clears the field bit"] #[inline(always)] pub fn clear_bit(self) -> &'a mut REG::Writer { self.bit(false) } } impl<'a, REG, FI, const OF: u8> BitWriter1C<'a, $U, REG, FI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = "Clears the field bit by passing one"] #[inline(always)] pub fn clear_bit_by_one(self) -> &'a mut REG::Writer { self.bit(true) } } impl<'a, REG, FI, const OF: u8> BitWriter0S<'a, $U, REG, FI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = "Sets the field bit by passing zero"] #[inline(always)] pub fn set_bit_by_zero(self) -> &'a mut REG::Writer { self.bit(false) } } impl<'a, REG, FI, const OF: u8> BitWriter1T<'a, $U, REG, FI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = "Toggle the field bit by passing one"] #[inline(always)] pub fn toggle_bit(self) -> &'a mut REG::Writer { self.bit(true) } } impl<'a, REG, FI, const OF: u8> BitWriter0T<'a, $U, REG, FI, OF> where REG: Writable + RegisterSpec, FI: Into, { #[doc = "Toggle the field bit by passing zero"] #[inline(always)] pub fn toggle_bit(self) -> &'a mut REG::Writer { self.bit(false) } } }; } impl_proxy!(u32);