嵌入式ARM 2月7日
以下文章来源于南风过境蜻蜓飞 ，作者爱分享的南风
专注嵌入式领域开发；个人博客：https://nanfeng-iot.cn
目标实现：使用LPTIM1，在低功耗stop模式下定时1s，1s后将STM32从stop模式唤醒，并且点亮LED灯
1 LPTIM 介绍
LPTIM，顾名思义，即低功耗定时器的意思，与普通定时器的差别是LPTIM在睡眠或者停机模式下依然可以工作（待机模式除外），支持低速时钟 LSI、 LSE 或者外部输入时钟。LPTIM是低功耗产品在低功耗功耗模式下定时的不二之选
支持芯片：并不是STM32的所有芯片都有LPTIM这个外设，，从官方资料可知，支持LPTIM的芯片有：STM32F410、STM32F413/423、STM32F7系列, STM32G0系列, STM32H7系列, STM32L0系列, STM32L4系列, STM32L4+系列, STM32L5系列, STM32WB系列
STM32L431芯片手册对LPTIM的介绍
2 LPTIM 功能
LPTIM 低功耗定时器有以下 6 种模式：
- 单脉冲模式
- PWM 模式
- 单次模式：在此模式下，当满足匹配条件时，输出可以切换高低电平（如果输出极性配置为高，则为低电平至高电平变化，反之亦然）
- 编码器模式
- 超时模式：有效的边沿触发输入可复位定时器。第一个触发事件将启动计时器，任何连续触发事件将重置计 数器并重新开始。
- 计数器模式：计数器可用于计算来自 Input1 的外部事件或用于计算内部时钟周期
主要有以下三个使用场景，本文将介绍LPTIM超时唤醒的应用：
Asynchronous pulse counter in Stop mode（异步脉冲计数）
PWM generator in Stop mode（PWM输出）
Timeout wakeup mode（超时唤醒）
3 LPTIM初始化结构体
介绍下LPTIM初始化结构体各个参数的含义及配置
3.1 Clock
Clock用于设置时钟源和时钟分频
其中，时钟源参数 Source 可以选择如下两种：
#define LPTIM_CLOCKSOURCE_APBCLOCK_LPOSC ((uint32_t)0x00U) 表示 LPTIM 由内部时钟源（APB 时钟或 APB 或 LSE、 LSI 和 HSI 等）提供时钟
#define LPTIM_CLOCKSOURCE_ULPTIM LPTIM_CFGR_CKSEL 表示 LPTIM 由外部时钟源通过 LPTIM 外部 Input1 提供时钟
Prescaler 时钟分频参数则可以选择八种，有1、2、4、8、16、32、64、128分频：
3.2 UltraLowPowerClock
UltraLowPowerClock参数仅在使用超低功耗时钟源时使用，用于设置所选择的外部时钟
其中，时钟极性参数 Polarity 用于选择有效的时钟极性，如果使能了双边沿，Auxiliary Clock（一种低功耗振荡器）必须处于激活状态
SampleTime 参数用于配置时钟干扰滤波器
3.3 Trigger
Trigger 用于配置触发参数
其中，Source 参数配置触发源，可选配置如下：
ActiveEdge 参数用于设置有效的触发边沿，可以选择上升沿，下降沿或者双边沿触发
SampleTime参数配置采样时间
3.4 OutputPolarity
- OutputPolarity 用于配置输出极性，可选择高电平或者低电平输出
3.5 UpdateMode
- UpdateMode用于配置是否立即更新自动重装寄存器和比较寄存器，可以选择立即更新，或者当前周期结束后更新
3.5 CounterSource
- CounterSource用于配置定时器计数器在每个内部事件或者外部事件后递增计数，可以选择内部或者外部
3.6 Input1Source
- Input1Source用于配置 Input1 的输入源，可以选择 GPIO，比较器输出或者 SAI FSA/FSB
3.7 Input2ource
- Input2ource用于配置 Input2 的输入源，可以选择 GPIO 和比较器（注意：此参数仅用于编码器模式）
3 LPTIM 超时唤醒应用
需求：使用LPTIM1，在低功耗stop模式下定时1s，1s后将STM32从stop模式唤醒，并且点亮LED灯
3.1 LPTIM1时钟初始化
- 配置LPTIM1时钟为LSE，即外部低速时钟32768Hz，也可配置为内部低速时钟LSI，修改对应配置即可
RCC_PeriphCLKInitTypeDef RCC_PeriphCLKInitStruct = {0};
RCC_OscInitTypeDef RCC_OscInitStruct = {0};
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_LSE;
RCC_OscInitStruct.LSEState = RCC_LSE_ON;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE;
if (HAL_RCC_OscConfig(&RCC_OscInitStruct)!= HAL_OK)
{
Error_Handler(__FILE__, __LINE__);
}
RCC_PeriphCLKInitStruct.PeriphClockSelection = RCC_PERIPHCLK_LPTIM1;
RCC_PeriphCLKInitStruct.Lptim1ClockSelection = RCC_LPTIM1CLKSOURCE_LSE;
HAL_RCCEx_PeriphCLKConfig(&RCC_PeriphCLKInitStruct);
3.2 LPTIM1初始化
- 按上面概述的参数配置，对LPTIM1进行配置如下
LPTIM_HandleTypeDef hlptim1;
void MX_LPTIM1_Init(void)
{
hlptim1.Instance = LPTIM1;
hlptim1.Init.Clock.Source = LPTIM_CLOCKSOURCE_APBCLOCK_LPOSC; //选择内部时钟源
hlptim1.Init.Clock.Prescaler = LPTIM_PRESCALER_DIV64; //设置LPTIM时钟分频
hlptim1.Init.Trigger.Source = LPTIM_TRIGSOURCE_SOFTWARE; //设置软件触发
hlptim1.Init.Trigger.ActiveEdge = LPTIM_ACTIVEEDGE_RISING; //设置上升沿触发
hlptim1.Init.Trigger.SampleTime = LPTIM_TRIGSAMPLETIME_DIRECTTRANSITION; //设置时钟干扰滤波器
hlptim1.Init.OutputPolarity = LPTIM_OUTPUTPOLARITY_HIGH; //设置输出高电平
hlptim1.Init.UpdateMode = LPTIM_UPDATE_IMMEDIATE; //比较寄存器和ARR自动重载寄存器选择更改后立即更新
hlptim1.Init.CounterSource = LPTIM_COUNTERSOURCE_INTERNAL; //LPTIM计数器对内部时钟源计数
hlptim1.Init.Input1Source = LPTIM_INPUT1SOURCE_GPIO; //外部输入1，本配置未使用
hlptim1.Init.Input2Source = LPTIM_INPUT2SOURCE_GPIO; //外部输入2，本配置未使用
if (HAL_LPTIM_Init(&hlptim1) != HAL_OK)
{
while (1)
{
Error_Handler(__FILE__, __LINE__);
}
}
}
- 当 HAL_LPTIM_Init（）运行时会调用 HAL_LPTIM_MspInit（）函数，这是一个虚函数，还需要我们重新定义，开启LPTIM时钟及 LPTIM1_IRQn 初始化
void HAL_LPTIM_MspInit(LPTIM_HandleTypeDef* hlptim)
{
if(hlptim->Instance==LPTIM1)
{
/* Peripheral clock enable */
__HAL_RCC_LPTIM1_CLK_ENABLE();
/* Peripheral interrupt init */
HAL_NVIC_SetPriority(LPTIM1_IRQn, 0, 0);
HAL_NVIC_EnableIRQ(LPTIM1_IRQn);
}
}
3.3 中断函数
- 编写中断回调函数，当定时时间到，点亮LED灯
void LPTIM1_IRQHandler(void)
{
HAL_LPTIM_IRQHandler(&hlptim1);
}
void HAL_LPTIM_CompareMatchCallback(LPTIM_HandleTypeDef *hlptim)
{
/* Timeout was reached, turn on LED */
BSP_LED_On();
}
3.4 开启定时器
- 开启定时器及进入stop模式
#define PERIOD 65535
#define PULSE 32767
HAL_LPTIM_TimeOut_Start_IT(&hlptim1, PERIOD, PULSE);
HAL_PWREx_EnterSTOP2Mode(PWR_STOPENTRY_WFI);
- 第1个参数是 LPTIM_HandleTypeDef 类型结构体指针变量
- 第2个参数是低功耗定时器的周期配置，范围 0 – 0xFFFF。
- 第3个参数是低功耗定时器的超时时间配置，范围 0 -0xFFFF。
- 返回值，返回 HAL_ERROR 表示配置失败，HAL_OK 表示配置成功，HAL_BUSY 表示忙（操作中），HAL_TIMEOUT 表示时间溢出
- 超时时间由 Compare 寄存器决定，即第3个参数，超时配置用不到第2个参数
- 超时时间计算方式：timeout = (Compare + 1) / LSE_Frequency，如配置Compare = 32767，LSE = 32768Hz，则超时时间为1s
4 踩坑记录
在使用官方例程的时候，不能触发定时中断，将触发源由 LPTIM_TRIGSOURCE_0 改为 LPTIM_TRIGSOURCE_SOFTWARE
移植官方例程时，未在 stm32l4xx_hal_conf.h 文件内打开LPTIM 外设的宏定义，导致一直报错
配置定时时间时候，未注意到参数范围是 0 -0xFFFF ，导致达不到自己想要的定时时间,最大可配置为65535,在Prescaler参数配置为 LPTIM_PRESCALER_DIV1 1分频的时候，超时时间最大为（65535+1）/32768 = 2s
END
来源：南风过境蜻蜓飞，作者：爱分享的南风
版权归原作者所有，如有侵权，请联系删除。
▍推荐阅读
