//! PWM driver. use core::marker::PhantomData; use embassy_hal_internal::{into_ref, PeripheralRef}; use super::timer::Timer; #[cfg(not(any(lptim_v2a, lptim_v2b)))] use super::OutputPin; #[cfg(any(lptim_v2a, lptim_v2b))] use super::{channel::Channel, timer::ChannelDirection, Channel1Pin, Channel2Pin}; use super::{BasicInstance, Instance}; use crate::gpio::{AfType, AnyPin, OutputType, Speed}; use crate::time::Hertz; use crate::Peripheral; /// Output marker type. pub enum Output {} /// Channel 1 marker type. pub enum Ch1 {} /// Channel 2 marker type. pub enum Ch2 {} /// PWM pin wrapper. /// /// This wraps a pin to make it usable with PWM. pub struct PwmPin<'d, T, C> { _pin: PeripheralRef<'d, AnyPin>, phantom: PhantomData<(T, C)>, } macro_rules! channel_impl { ($new_chx:ident, $channel:ident, $pin_trait:ident) => { impl<'d, T: BasicInstance> PwmPin<'d, T, $channel> { #[doc = concat!("Create a new ", stringify!($channel), " PWM pin instance.")] pub fn $new_chx(pin: impl Peripheral
> + 'd) -> Self { into_ref!(pin); critical_section::with(|_| { pin.set_low(); pin.set_as_af( pin.af_num(), AfType::output(OutputType::PushPull, Speed::VeryHigh), ); }); PwmPin { _pin: pin.map_into(), phantom: PhantomData, } } } }; } #[cfg(not(any(lptim_v2a, lptim_v2b)))] channel_impl!(new, Output, OutputPin); #[cfg(any(lptim_v2a, lptim_v2b))] channel_impl!(new_ch1, Ch1, Channel1Pin); #[cfg(any(lptim_v2a, lptim_v2b))] channel_impl!(new_ch2, Ch2, Channel2Pin); /// PWM driver. pub struct Pwm<'d, T: Instance> { inner: Timer<'d, T>, } #[cfg(not(any(lptim_v2a, lptim_v2b)))] impl<'d, T: Instance> Pwm<'d, T> { /// Create a new PWM driver. pub fn new(tim: impl Peripheral
+ 'd, _output_pin: PwmPin<'d, T, Output>, freq: Hertz) -> Self { Self::new_inner(tim, freq) } /// Set the duty. /// /// The value ranges from 0 for 0% duty, to [`get_max_duty`](Self::get_max_duty) for 100% duty, both included. pub fn set_duty(&mut self, duty: u16) { assert!(duty <= self.get_max_duty()); self.inner.set_compare_value(duty) } /// Get the duty. /// /// The value ranges from 0 for 0% duty, to [`get_max_duty`](Self::get_max_duty) for 100% duty, both included. pub fn get_duty(&self) -> u16 { self.inner.get_compare_value() } fn post_init(&mut self) {} } #[cfg(any(lptim_v2a, lptim_v2b))] impl<'d, T: Instance> Pwm<'d, T> { /// Create a new PWM driver. pub fn new( tim: impl Peripheral
+ 'd,
_ch1_pin: Option + 'd, freq: Hertz) -> Self {
let mut this = Self { inner: Timer::new(tim) };
this.inner.enable();
this.set_frequency(freq);
this.post_init();
this.inner.continuous_mode_start();
this
}
/// Set PWM frequency.
///
/// Note: when you call this, the max duty value changes, so you will have to
/// call `set_duty` on all channels with the duty calculated based on the new max duty.
pub fn set_frequency(&mut self, frequency: Hertz) {
self.inner.set_frequency(frequency);
}
/// Get max duty value.
///
/// This value depends on the configured frequency and the timer's clock rate from RCC.
pub fn get_max_duty(&self) -> u16 {
self.inner.get_max_compare_value() + 1
}
}