#![macro_use] use core::convert::Infallible; use core::marker::PhantomData; use embassy::util::Unborrow; use embassy_hal_common::{unborrow, unsafe_impl_unborrow}; use embedded_hal::digital::v2::{toggleable, InputPin, OutputPin, StatefulOutputPin}; use crate::pac; use crate::pac::gpio::{self, vals}; use crate::peripherals; /// Pull setting for an input. #[derive(Debug, Eq, PartialEq)] #[cfg_attr(feature = "defmt", derive(defmt::Format))] pub enum Pull { None, Up, Down, } #[cfg(gpio_v2)] impl From for vals::Pupdr { fn from(pull: Pull) -> Self { use Pull::*; match pull { None => vals::Pupdr::FLOATING, Up => vals::Pupdr::PULLUP, Down => vals::Pupdr::PULLDOWN, } } } /// Speed settings #[derive(Debug)] #[cfg_attr(feature = "defmt", derive(defmt::Format))] pub enum Speed { Low, Medium, #[cfg(not(any(syscfg_f0, gpio_v1)))] High, VeryHigh, } #[cfg(gpio_v1)] impl From for vals::Mode { fn from(speed: Speed) -> Self { use Speed::*; match speed { Low => vals::Mode::OUTPUT2, Medium => vals::Mode::OUTPUT, VeryHigh => vals::Mode::OUTPUT50, } } } #[cfg(gpio_v2)] impl From for vals::Ospeedr { fn from(speed: Speed) -> Self { use Speed::*; match speed { Low => vals::Ospeedr::LOWSPEED, Medium => vals::Ospeedr::MEDIUMSPEED, #[cfg(not(syscfg_f0))] High => vals::Ospeedr::HIGHSPEED, VeryHigh => vals::Ospeedr::VERYHIGHSPEED, } } } /// GPIO input driver. pub struct Input<'d, T: Pin> { pub(crate) pin: T, phantom: PhantomData<&'d mut T>, } impl<'d, T: Pin> Input<'d, T> { pub fn new(pin: impl Unborrow + 'd, pull: Pull) -> Self { unborrow!(pin); cortex_m::interrupt::free(|_| unsafe { let r = pin.block(); let n = pin.pin() as usize; #[cfg(gpio_v1)] { let crlh = if n < 8 { 0 } else { 1 }; match pull { Pull::Up => r.bsrr().write(|w| w.set_bs(n, true)), Pull::Down => r.bsrr().write(|w| w.set_br(n, true)), Pull::None => {} } if pull == Pull::None { r.cr(crlh) .modify(|w| w.set_cnf(n % 8, vals::Cnf::OPENDRAIN)); } else { r.cr(crlh) .modify(|w| w.set_cnf(n % 8, vals::Cnf::ALTPUSHPULL)); } r.cr(crlh).modify(|w| w.set_mode(n % 8, vals::Mode::INPUT)); } #[cfg(gpio_v2)] { r.pupdr().modify(|w| w.set_pupdr(n, pull.into())); r.otyper().modify(|w| w.set_ot(n, vals::Ot::PUSHPULL)); r.moder().modify(|w| w.set_moder(n, vals::Moder::INPUT)); } }); Self { pin, phantom: PhantomData, } } } impl<'d, T: Pin> Drop for Input<'d, T> { fn drop(&mut self) { cortex_m::interrupt::free(|_| unsafe { let r = self.pin.block(); let n = self.pin.pin() as usize; #[cfg(gpio_v1)] { let crlh = if n < 8 { 0 } else { 1 }; r.cr(crlh) .modify(|w| w.set_cnf(n % 8, vals::Cnf::OPENDRAIN)); } #[cfg(gpio_v2)] r.pupdr().modify(|w| w.set_pupdr(n, vals::Pupdr::FLOATING)); }); } } impl<'d, T: Pin> InputPin for Input<'d, T> { type Error = Infallible; fn is_high(&self) -> Result { self.is_low().map(|v| !v) } fn is_low(&self) -> Result { let state = unsafe { self.pin.block().idr().read().idr(self.pin.pin() as _) }; Ok(state == vals::Idr::LOW) } } /// Digital input or output level. #[derive(Debug, Eq, PartialEq)] #[cfg_attr(feature = "defmt", derive(defmt::Format))] pub enum Level { Low, High, } /// GPIO output driver. pub struct Output<'d, T: Pin> { pub(crate) pin: T, phantom: PhantomData<&'d mut T>, } impl<'d, T: Pin> Output<'d, T> { pub fn new(pin: impl Unborrow + 'd, initial_output: Level, speed: Speed) -> Self { unborrow!(pin); match initial_output { Level::High => pin.set_high(), Level::Low => pin.set_low(), } cortex_m::interrupt::free(|_| unsafe { let r = pin.block(); let n = pin.pin() as usize; #[cfg(gpio_v1)] { let crlh = if n < 8 { 0 } else { 1 }; r.cr(crlh).modify(|w| w.set_cnf(n % 8, vals::Cnf::PUSHPULL)); r.cr(crlh).modify(|w| w.set_mode(n % 8, speed.into())); } #[cfg(gpio_v2)] { r.pupdr().modify(|w| w.set_pupdr(n, vals::Pupdr::FLOATING)); r.otyper().modify(|w| w.set_ot(n, vals::Ot::PUSHPULL)); pin.set_speed(speed); r.moder().modify(|w| w.set_moder(n, vals::Moder::OUTPUT)); } }); Self { pin, phantom: PhantomData, } } } impl<'d, T: Pin> Drop for Output<'d, T> { fn drop(&mut self) { cortex_m::interrupt::free(|_| unsafe { let r = self.pin.block(); let n = self.pin.pin() as usize; #[cfg(gpio_v1)] { let crlh = if n < 8 { 0 } else { 1 }; r.cr(crlh) .modify(|w| w.set_cnf(n % 8, vals::Cnf::OPENDRAIN)); r.cr(crlh).modify(|w| w.set_mode(n % 8, vals::Mode::INPUT)); } #[cfg(gpio_v2)] { r.pupdr().modify(|w| w.set_pupdr(n, vals::Pupdr::FLOATING)); r.moder().modify(|w| w.set_moder(n, vals::Moder::INPUT)); } }); } } impl<'d, T: Pin> OutputPin for Output<'d, T> { type Error = Infallible; /// Set the output as high. fn set_high(&mut self) -> Result<(), Self::Error> { self.pin.set_high(); Ok(()) } /// Set the output as low. fn set_low(&mut self) -> Result<(), Self::Error> { self.pin.set_low(); Ok(()) } } impl<'d, T: Pin> StatefulOutputPin for Output<'d, T> { /// Is the output pin set as high? fn is_set_high(&self) -> Result { self.is_set_low().map(|v| !v) } /// Is the output pin set as low? fn is_set_low(&self) -> Result { let state = unsafe { self.pin.block().odr().read().odr(self.pin.pin() as _) }; Ok(state == vals::Odr::LOW) } } impl<'d, T: Pin> toggleable::Default for Output<'d, T> {} /// GPIO output open-drain driver. pub struct OutputOpenDrain<'d, T: Pin> { pub(crate) pin: T, phantom: PhantomData<&'d mut T>, } impl<'d, T: Pin> OutputOpenDrain<'d, T> { pub fn new( pin: impl Unborrow + 'd, initial_output: Level, speed: Speed, pull: Pull, ) -> Self { unborrow!(pin); match initial_output { Level::High => pin.set_high(), Level::Low => pin.set_low(), } cortex_m::interrupt::free(|_| unsafe { let r = pin.block(); let n = pin.pin() as usize; #[cfg(gpio_v1)] { let crlh = if n < 8 { 0 } else { 1 }; match pull { Pull::Up => r.bsrr().write(|w| w.set_bs(n, true)), Pull::Down => r.bsrr().write(|w| w.set_br(n, true)), Pull::None => {} } r.cr(crlh).modify(|w| w.set_mode(n % 8, speed.into())); r.cr(crlh) .modify(|w| w.set_cnf(n % 8, vals::Cnf::OPENDRAIN)); } #[cfg(gpio_v2)] { r.pupdr().modify(|w| w.set_pupdr(n, pull.into())); r.otyper().modify(|w| w.set_ot(n, vals::Ot::OPENDRAIN)); pin.set_speed(speed); r.moder().modify(|w| w.set_moder(n, vals::Moder::OUTPUT)); } }); Self { pin, phantom: PhantomData, } } } impl<'d, T: Pin> Drop for OutputOpenDrain<'d, T> { fn drop(&mut self) { cortex_m::interrupt::free(|_| unsafe { let r = self.pin.block(); let n = self.pin.pin() as usize; #[cfg(gpio_v1)] { let crlh = if n < 8 { 0 } else { 1 }; r.cr(crlh) .modify(|w| w.set_cnf(n % 8, vals::Cnf::OPENDRAIN)); r.cr(crlh).modify(|w| w.set_mode(n % 8, vals::Mode::INPUT)); } #[cfg(gpio_v2)] { r.pupdr().modify(|w| w.set_pupdr(n, vals::Pupdr::FLOATING)); r.moder().modify(|w| w.set_moder(n, vals::Moder::INPUT)); } }); } } impl<'d, T: Pin> OutputPin for OutputOpenDrain<'d, T> { type Error = Infallible; /// Set the output as high. fn set_high(&mut self) -> Result<(), Self::Error> { self.pin.set_high(); Ok(()) } /// Set the output as low. fn set_low(&mut self) -> Result<(), Self::Error> { self.pin.set_low(); Ok(()) } } impl<'d, T: Pin> InputPin for OutputOpenDrain<'d, T> { type Error = Infallible; fn is_high(&self) -> Result { self.is_low().map(|v| !v) } fn is_low(&self) -> Result { // NOTE(safety) Atomic read let state = unsafe { self.pin.block().idr().read().idr(self.pin.pin() as usize) }; Ok(state == vals::Idr::LOW) } } pub(crate) mod sealed { use super::*; /// Alternate function type settings #[derive(Debug)] #[cfg_attr(feature = "defmt", derive(defmt::Format))] pub enum AFType { // InputFloating, // InputPullUp, // InputPullDown, OutputPushPull, OutputOpenDrain, } pub trait Pin { fn pin_port(&self) -> u8; #[inline] fn _pin(&self) -> u8 { self.pin_port() % 16 } #[inline] fn _port(&self) -> u8 { self.pin_port() / 16 } #[inline] fn block(&self) -> gpio::Gpio { pac::GPIO(self._port() as _) } /// Set the output as high. #[inline] fn set_high(&self) { unsafe { let n = self._pin() as _; self.block().bsrr().write(|w| w.set_bs(n, true)); } } /// Set the output as low. #[inline] fn set_low(&self) { unsafe { let n = self._pin() as _; self.block().bsrr().write(|w| w.set_br(n, true)); } } #[cfg(gpio_v1)] unsafe fn set_as_af(&self, _af_num: u8, af_type: AFType) { // F1 uses the AFIO register for remapping. // For now, this is not implemented, so af_num is ignored // _af_num should be zero here, since it is not set by stm32-data let r = self.block(); let n = self._pin() as usize; let crlh = if n < 8 { 0 } else { 1 }; match af_type { // TODO: Do we need to configure input AF pins differently? AFType::OutputPushPull => { r.cr(crlh).modify(|w| { w.set_mode(n % 8, vals::Mode::OUTPUT50); w.set_cnf(n % 8, vals::Cnf::ALTPUSHPULL); }); } AFType::OutputOpenDrain => { r.cr(crlh).modify(|w| { w.set_mode(n % 8, vals::Mode::OUTPUT50); w.set_cnf(n % 8, vals::Cnf::ALTOPENDRAIN); }); } } } #[cfg(gpio_v2)] unsafe fn set_as_af(&self, af_num: u8, af_type: AFType) { let pin = self._pin() as usize; let block = self.block(); block .afr(pin / 8) .modify(|w| w.set_afr(pin % 8, vals::Afr(af_num))); match af_type { AFType::OutputPushPull => { block.otyper().modify(|w| w.set_ot(pin, vals::Ot::PUSHPULL)) } AFType::OutputOpenDrain => block .otyper() .modify(|w| w.set_ot(pin, vals::Ot::OPENDRAIN)), } block .pupdr() .modify(|w| w.set_pupdr(pin, vals::Pupdr::FLOATING)); block .moder() .modify(|w| w.set_moder(pin, vals::Moder::ALTERNATE)); } unsafe fn set_as_analog(&self) { let pin = self._pin() as usize; let block = self.block(); #[cfg(gpio_v1)] { let crlh = if pin < 8 { 0 } else { 1 }; block .cr(crlh) .modify(|w| w.set_cnf(pin % 8, vals::Cnf::PUSHPULL)); block .cr(crlh) .modify(|w| w.set_mode(pin % 8, vals::Mode::INPUT)); } #[cfg(gpio_v2)] block .moder() .modify(|w| w.set_moder(pin, vals::Moder::ANALOG)); } #[cfg(gpio_v2)] unsafe fn set_speed(&self, speed: Speed) { let pin = self._pin() as usize; self.block() .ospeedr() .modify(|w| w.set_ospeedr(pin, speed.into())); } } pub trait OptionalPin {} } pub trait Pin: sealed::Pin + Sized { type ExtiChannel: crate::exti::Channel; /// Number of the pin within the port (0..31) #[inline] fn pin(&self) -> u8 { self._pin() } /// Port of the pin #[inline] fn port(&self) -> u8 { self._port() } /// Convert from concrete pin type PX_XX to type erased `AnyPin`. #[inline] fn degrade(self) -> AnyPin { AnyPin { pin_port: self.pin_port(), } } } // Type-erased GPIO pin pub struct AnyPin { pin_port: u8, } impl AnyPin { #[inline] pub unsafe fn steal(pin_port: u8) -> Self { Self { pin_port } } #[inline] fn _port(&self) -> u8 { self.pin_port / 16 } #[inline] pub fn block(&self) -> gpio::Gpio { pac::GPIO(self._port() as _) } } unsafe_impl_unborrow!(AnyPin); impl Pin for AnyPin { type ExtiChannel = crate::exti::AnyChannel; } impl sealed::Pin for AnyPin { #[inline] fn pin_port(&self) -> u8 { self.pin_port } } // ==================== pub trait OptionalPin: sealed::OptionalPin + Sized { type Pin: Pin; fn pin(&self) -> Option<&Self::Pin>; fn pin_mut(&mut self) -> Option<&mut Self::Pin>; /// Convert from concrete pin type PX_XX to type erased `Option`. #[inline] fn degrade_optional(mut self) -> Option { self.pin_mut() .map(|pin| unsafe { core::ptr::read(pin) }.degrade()) } } impl sealed::OptionalPin for T {} impl OptionalPin for T { type Pin = T; #[inline] fn pin(&self) -> Option<&T> { Some(self) } #[inline] fn pin_mut(&mut self) -> Option<&mut T> { Some(self) } } #[derive(Clone, Copy, Debug)] pub struct NoPin; unsafe_impl_unborrow!(NoPin); impl sealed::OptionalPin for NoPin {} impl OptionalPin for NoPin { type Pin = AnyPin; #[inline] fn pin(&self) -> Option<&AnyPin> { None } #[inline] fn pin_mut(&mut self) -> Option<&mut AnyPin> { None } } // ==================== crate::pac::pins!( ($pin_name:ident, $port_name:ident, $port_num:expr, $pin_num:expr, $exti_ch:ident) => { impl Pin for peripherals::$pin_name { type ExtiChannel = peripherals::$exti_ch; } impl sealed::Pin for peripherals::$pin_name { #[inline] fn pin_port(&self) -> u8 { $port_num * 16 + $pin_num } } }; ); pub(crate) unsafe fn init() { crate::pac::gpio_rcc! { ($en_reg:ident) => { crate::pac::RCC.$en_reg().modify(|reg| { crate::pac::gpio_rcc! { ($name:ident, $clock:ident, $en_reg, $rst_reg:ident, $en_fn:ident, $rst_fn:ident) => { reg.$en_fn(true); }; } }); }; } }