Struct stm32_hal2::timer::Timer

pub struct Timer<TIM> {
    pub regs: TIM,
    // some fields omitted
}

Represents a timer peripheral.

Fields

regs: TIM

Implementations

impl Timer<TIM1>

pub fn new_tim1(regs: TIM1, freq: f32, clocks: &Clocks) -> Self

Configures a TIM peripheral as a periodic count down timer

pub fn enable_interrupt(&mut self, interrupt: TimerInterrupt)

Enable a specific type of ADC interrupt.

pub fn clear_interrupt(&mut self, interrupt: TimerInterrupt)

Clears interrupt associated with this timer.

If the interrupt is not cleared, it will immediately retrigger after the ISR has finished. For examlpe, place this at the top of your timer’s interrupt handler.

pub fn enable(&mut self)

Enable the timer.

pub fn disable(&mut self)

Disable the timer.

pub fn is_enabled(&self) -> bool

Check if the timer is enabled.

pub fn set_period(&mut self, time: f32) -> Result<(), ValueError>

Set the timer period, in seconds. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_freq(&mut self, freq: f32) -> Result<(), ValueError>

Set the timer frequency, in Hz. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_auto_reload(&mut self, arr: u32)

Set the auto-reload register value. Used for adjusting frequency.

pub fn set_prescaler(&mut self, psc: u16)

Set the prescaler value. Used for adjusting frequency.

pub fn reset_countdown(&mut self)

Reset the countdown; set the counter to 0.

pub fn countdown(&self) -> u32

Read the current counter value.

impl Timer<TIM2>

pub fn new_tim2(regs: TIM2, freq: f32, clocks: &Clocks) -> Self

Configures a TIM peripheral as a periodic count down timer

pub fn enable_interrupt(&mut self, interrupt: TimerInterrupt)

Enable a specific type of ADC interrupt.

pub fn clear_interrupt(&mut self, interrupt: TimerInterrupt)

Clears interrupt associated with this timer.

If the interrupt is not cleared, it will immediately retrigger after the ISR has finished. For examlpe, place this at the top of your timer’s interrupt handler.

pub fn enable(&mut self)

Enable the timer.

pub fn disable(&mut self)

Disable the timer.

pub fn is_enabled(&self) -> bool

Check if the timer is enabled.

pub fn set_period(&mut self, time: f32) -> Result<(), ValueError>

Set the timer period, in seconds. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_freq(&mut self, freq: f32) -> Result<(), ValueError>

Set the timer frequency, in Hz. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_auto_reload(&mut self, arr: u32)

Set the auto-reload register value. Used for adjusting frequency.

pub fn set_prescaler(&mut self, psc: u16)

Set the prescaler value. Used for adjusting frequency.

pub fn reset_countdown(&mut self)

Reset the countdown; set the counter to 0.

pub fn countdown(&self) -> u32

Read the current counter value.

impl Timer<TIM2>

pub fn enable_pwm_output(
    &mut self,
    channel: TimChannel,
    compare: OutputCompare,
    dir: CountDir,
    duty: f32
)

Enables basic PWM output

pub fn _enable_pwm_input(
    &mut self,
    channel: TimChannel,
    compare: OutputCompare,
    dir: CountDir,
    duty: f32
)

Enables basic PWM input. TODO: Doesn’t work yet. L4 RM, section 26.3.8

pub fn set_output_compare(&mut self, channel: TimChannel, mode: OutputCompare)

Set Output Compare Mode. See docs on the OutputCompare enum.

pub fn get_duty(&self, channel: TimChannel) -> u32

Return the set duty period for a given channel. Divide by get_max_duty() to find the portion of the duty cycle used.

pub fn set_duty(&mut self, channel: TimChannel, duty: u32)

Set the duty cycle, as a portion of ARR (get_max_duty()). Note that this needs to be re-run if you change ARR at any point.

pub fn get_max_duty(&self) -> u32

Return the integer associated with the maximum duty period. todo: Duty could be u16 for low-precision timers.

pub fn set_alignment(&mut self, alignment: Alignment)

Set timer alignment to Edge, or one of 3 center modes. STM32F303 ref man, section 21.4.1: Bits 6:5 CMS: Center-aligned mode selection 00: Edge-aligned mode. The counter counts up or down depending on the direction bit (DIR). 01: Center-aligned mode 1. The counter counts up and down alternatively. Output compare interrupt flags of channels configured in output (CCxS=00 in TIMx_CCMRx register) are set only when the counter is counting down. 10: Center-aligned mode 2. The counter counts up and down alternatively. Output compare interrupt flags of channels configured in output (CCxS=00 in TIMx_CCMRx register) are set only when the counter is counting up. 11: Center-aligned mode 3. The counter counts up and down alternatively. Output compare interrupt flags of channels configured in output (CCxS=00 in TIMx_CCMRx register) are set both when the counter is counting up or down.

pub fn set_polarity(&mut self, channel: TimChannel, polarity: Polarity)

Set output polarity. See docs on the Polarity enum.

pub fn set_complementary_polarity(
    &mut self,
    channel: TimChannel,
    polarity: Polarity
)

Set complementary output polarity. See docs on the Polarity enum.

pub fn disable_capture_compare(&mut self, channel: TimChannel)

Disables capture compare on a specific channel.

pub fn enable_capture_compare(&mut self, channel: TimChannel)

Enables capture compare on a specific channel.

pub fn set_capture_compare(&mut self, channel: TimChannel, mode: CaptureCompare)

Set Capture Compare Mode. See docs on the CaptureCompare enum.

pub fn set_auto_reload_preload(&mut self, mode: bool)

Set auto reload preloader; useful when changing period and duty mid-run.

pub fn set_preload(&mut self, channel: TimChannel, value: bool)

Set preload mode. OC1PE: Output Compare 1 preload enable 0: Preload register on TIMx_CCR1 disabled. TIMx_CCR1 can be written at anytime, the new value is taken in account immediately. 1: Preload register on TIMx_CCR1 enabled. Read/Write operations access the preload register. TIMx_CCR1 preload value is loaded in the active register at each update event. Note: 1: These bits can not be modified as long as LOCK level 3 has been programmed (LOCK bits in TIMx_BDTR register) and CC1S=’00’ (the channel is configured in output). 2: The PWM mode can be used without validating the preload register only in one pulse mode (OPM bit set in TIMx_CR1 register). Else the behavior is not guaranteed.

Setting preload is required to enable PWM.

impl Timer<TIM6>

pub fn new_tim6(regs: TIM6, freq: f32, clocks: &Clocks) -> Self

Configures a TIM peripheral as a periodic count down timer

pub fn enable_interrupt(&mut self, interrupt: TimerInterrupt)

Enable a specific type of ADC interrupt.

pub fn clear_interrupt(&mut self, interrupt: TimerInterrupt)

Clears interrupt associated with this timer.

If the interrupt is not cleared, it will immediately retrigger after the ISR has finished. For examlpe, place this at the top of your timer’s interrupt handler.

pub fn enable(&mut self)

Enable the timer.

pub fn disable(&mut self)

Disable the timer.

pub fn is_enabled(&self) -> bool

Check if the timer is enabled.

pub fn set_period(&mut self, time: f32) -> Result<(), ValueError>

Set the timer period, in seconds. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_freq(&mut self, freq: f32) -> Result<(), ValueError>

Set the timer frequency, in Hz. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_auto_reload(&mut self, arr: u32)

Set the auto-reload register value. Used for adjusting frequency.

pub fn set_prescaler(&mut self, psc: u16)

Set the prescaler value. Used for adjusting frequency.

pub fn reset_countdown(&mut self)

Reset the countdown; set the counter to 0.

pub fn countdown(&self) -> u32

Read the current counter value.

impl Timer<TIM7>

pub fn new_tim7(regs: TIM7, freq: f32, clocks: &Clocks) -> Self

Configures a TIM peripheral as a periodic count down timer

pub fn enable_interrupt(&mut self, interrupt: TimerInterrupt)

Enable a specific type of ADC interrupt.

pub fn clear_interrupt(&mut self, interrupt: TimerInterrupt)

Clears interrupt associated with this timer.

If the interrupt is not cleared, it will immediately retrigger after the ISR has finished. For examlpe, place this at the top of your timer’s interrupt handler.

pub fn enable(&mut self)

Enable the timer.

pub fn disable(&mut self)

Disable the timer.

pub fn is_enabled(&self) -> bool

Check if the timer is enabled.

pub fn set_period(&mut self, time: f32) -> Result<(), ValueError>

Set the timer period, in seconds. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_freq(&mut self, freq: f32) -> Result<(), ValueError>

Set the timer frequency, in Hz. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_auto_reload(&mut self, arr: u32)

Set the auto-reload register value. Used for adjusting frequency.

pub fn set_prescaler(&mut self, psc: u16)

Set the prescaler value. Used for adjusting frequency.

pub fn reset_countdown(&mut self)

Reset the countdown; set the counter to 0.

pub fn countdown(&self) -> u32

Read the current counter value.

impl Timer<TIM15>

pub fn new_tim15(regs: TIM15, freq: f32, clocks: &Clocks) -> Self

Configures a TIM peripheral as a periodic count down timer

pub fn enable_interrupt(&mut self, interrupt: TimerInterrupt)

Enable a specific type of ADC interrupt.

pub fn clear_interrupt(&mut self, interrupt: TimerInterrupt)

Clears interrupt associated with this timer.

If the interrupt is not cleared, it will immediately retrigger after the ISR has finished. For examlpe, place this at the top of your timer’s interrupt handler.

pub fn enable(&mut self)

Enable the timer.

pub fn disable(&mut self)

Disable the timer.

pub fn is_enabled(&self) -> bool

Check if the timer is enabled.

pub fn set_period(&mut self, time: f32) -> Result<(), ValueError>

Set the timer period, in seconds. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_freq(&mut self, freq: f32) -> Result<(), ValueError>

Set the timer frequency, in Hz. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_auto_reload(&mut self, arr: u32)

Set the auto-reload register value. Used for adjusting frequency.

pub fn set_prescaler(&mut self, psc: u16)

Set the prescaler value. Used for adjusting frequency.

pub fn reset_countdown(&mut self)

Reset the countdown; set the counter to 0.

pub fn countdown(&self) -> u32

Read the current counter value.

impl Timer<TIM16>

pub fn new_tim16(regs: TIM16, freq: f32, clocks: &Clocks) -> Self

Configures a TIM peripheral as a periodic count down timer

pub fn enable_interrupt(&mut self, interrupt: TimerInterrupt)

Enable a specific type of ADC interrupt.

pub fn clear_interrupt(&mut self, interrupt: TimerInterrupt)

Clears interrupt associated with this timer.

If the interrupt is not cleared, it will immediately retrigger after the ISR has finished. For examlpe, place this at the top of your timer’s interrupt handler.

pub fn enable(&mut self)

Enable the timer.

pub fn disable(&mut self)

Disable the timer.

pub fn is_enabled(&self) -> bool

Check if the timer is enabled.

pub fn set_period(&mut self, time: f32) -> Result<(), ValueError>

Set the timer period, in seconds. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_freq(&mut self, freq: f32) -> Result<(), ValueError>

Set the timer frequency, in Hz. Overrides the period or frequency set in the constructor. If you use center aligned PWM, make sure to enter twice the freq you normally would.

pub fn set_auto_reload(&mut self, arr: u32)

Set the auto-reload register value. Used for adjusting frequency.

pub fn set_prescaler(&mut self, psc: u16)

Set the prescaler value. Used for adjusting frequency.

pub fn reset_countdown(&mut self)

Reset the countdown; set the counter to 0.

pub fn countdown(&self) -> u32

Read the current counter value.

Trait Implementations

impl CountDown for Timer<TIM1>

type Time = f32

The unit of time used by this timer

fn start<F: Into<f32>>(&mut self, freq: F)

Starts a new count down

fn wait(&mut self) -> Result<(), Void>

Non-blockingly “waits” until the count down finishes

impl CountDown for Timer<TIM2>

type Time = f32

The unit of time used by this timer

fn start<F: Into<f32>>(&mut self, freq: F)

Starts a new count down

fn wait(&mut self) -> Result<(), Void>

Non-blockingly “waits” until the count down finishes

impl CountDown for Timer<TIM6>

type Time = f32

The unit of time used by this timer

fn start<F: Into<f32>>(&mut self, freq: F)

Starts a new count down

fn wait(&mut self) -> Result<(), Void>

Non-blockingly “waits” until the count down finishes

impl CountDown for Timer<TIM7>

type Time = f32

The unit of time used by this timer

fn start<F: Into<f32>>(&mut self, freq: F)

Starts a new count down

fn wait(&mut self) -> Result<(), Void>

Non-blockingly “waits” until the count down finishes

impl CountDown for Timer<TIM15>

type Time = f32

The unit of time used by this timer

fn start<F: Into<f32>>(&mut self, freq: F)

Starts a new count down

fn wait(&mut self) -> Result<(), Void>

Non-blockingly “waits” until the count down finishes

impl CountDown for Timer<TIM16>

type Time = f32

The unit of time used by this timer

fn start<F: Into<f32>>(&mut self, freq: F)

Starts a new count down

fn wait(&mut self) -> Result<(), Void>

Non-blockingly “waits” until the count down finishes

impl DelayMs<u16> for Timer<TIM1>

fn delay_ms(&mut self, ms: u16)

Pauses execution for ms milliseconds

impl DelayMs<u16> for Timer<TIM2>

fn delay_ms(&mut self, ms: u16)

Pauses execution for ms milliseconds

impl DelayMs<u16> for Timer<TIM6>

fn delay_ms(&mut self, ms: u16)

Pauses execution for ms milliseconds

impl DelayMs<u16> for Timer<TIM7>

fn delay_ms(&mut self, ms: u16)

Pauses execution for ms milliseconds

impl DelayMs<u16> for Timer<TIM15>

fn delay_ms(&mut self, ms: u16)

Pauses execution for ms milliseconds

impl DelayMs<u16> for Timer<TIM16>

fn delay_ms(&mut self, ms: u16)

Pauses execution for ms milliseconds

impl DelayMs<u32> for Timer<TIM1>

fn delay_ms(&mut self, ms: u32)

Pauses execution for ms milliseconds

impl DelayMs<u32> for Timer<TIM2>

fn delay_ms(&mut self, ms: u32)

Pauses execution for ms milliseconds

impl DelayMs<u32> for Timer<TIM6>

fn delay_ms(&mut self, ms: u32)

Pauses execution for ms milliseconds

impl DelayMs<u32> for Timer<TIM7>

fn delay_ms(&mut self, ms: u32)

Pauses execution for ms milliseconds

impl DelayMs<u32> for Timer<TIM15>

fn delay_ms(&mut self, ms: u32)

Pauses execution for ms milliseconds

impl DelayMs<u32> for Timer<TIM16>

fn delay_ms(&mut self, ms: u32)

Pauses execution for ms milliseconds

impl DelayMs<u8> for Timer<TIM1>

fn delay_ms(&mut self, ms: u8)

Pauses execution for ms milliseconds

impl DelayMs<u8> for Timer<TIM2>

fn delay_ms(&mut self, ms: u8)

Pauses execution for ms milliseconds

impl DelayMs<u8> for Timer<TIM6>

fn delay_ms(&mut self, ms: u8)

Pauses execution for ms milliseconds

impl DelayMs<u8> for Timer<TIM7>

fn delay_ms(&mut self, ms: u8)

Pauses execution for ms milliseconds

impl DelayMs<u8> for Timer<TIM15>

fn delay_ms(&mut self, ms: u8)

Pauses execution for ms milliseconds

impl DelayMs<u8> for Timer<TIM16>

fn delay_ms(&mut self, ms: u8)

Pauses execution for ms milliseconds

impl DelayUs<u16> for Timer<TIM1>

fn delay_us(&mut self, us: u16)

Pauses execution for us microseconds

impl DelayUs<u16> for Timer<TIM2>

fn delay_us(&mut self, us: u16)

Pauses execution for us microseconds

impl DelayUs<u16> for Timer<TIM6>

fn delay_us(&mut self, us: u16)

Pauses execution for us microseconds

impl DelayUs<u16> for Timer<TIM7>

fn delay_us(&mut self, us: u16)

Pauses execution for us microseconds

impl DelayUs<u16> for Timer<TIM15>

fn delay_us(&mut self, us: u16)

Pauses execution for us microseconds

impl DelayUs<u16> for Timer<TIM16>

fn delay_us(&mut self, us: u16)

Pauses execution for us microseconds

impl DelayUs<u32> for Timer<TIM1>

fn delay_us(&mut self, us: u32)

Pauses execution for us microseconds

impl DelayUs<u32> for Timer<TIM2>

fn delay_us(&mut self, us: u32)

Pauses execution for us microseconds

impl DelayUs<u32> for Timer<TIM6>

fn delay_us(&mut self, us: u32)

Pauses execution for us microseconds

impl DelayUs<u32> for Timer<TIM7>

fn delay_us(&mut self, us: u32)

Pauses execution for us microseconds

impl DelayUs<u32> for Timer<TIM15>

fn delay_us(&mut self, us: u32)

Pauses execution for us microseconds

impl DelayUs<u32> for Timer<TIM16>

fn delay_us(&mut self, us: u32)

Pauses execution for us microseconds

impl DelayUs<u8> for Timer<TIM1>

fn delay_us(&mut self, us: u8)

Pauses execution for us microseconds

impl DelayUs<u8> for Timer<TIM2>

fn delay_us(&mut self, us: u8)

Pauses execution for us microseconds

impl DelayUs<u8> for Timer<TIM6>

fn delay_us(&mut self, us: u8)

Pauses execution for us microseconds

impl DelayUs<u8> for Timer<TIM7>

fn delay_us(&mut self, us: u8)

Pauses execution for us microseconds

impl DelayUs<u8> for Timer<TIM15>

fn delay_us(&mut self, us: u8)

Pauses execution for us microseconds

impl DelayUs<u8> for Timer<TIM16>

fn delay_us(&mut self, us: u8)

Pauses execution for us microseconds

impl Periodic for Timer<TIM1>

impl Periodic for Timer<TIM2>

impl Periodic for Timer<TIM6>

impl Periodic for Timer<TIM7>

impl Periodic for Timer<TIM15>

impl Periodic for Timer<TIM16>