
我们已经介绍了 STM32F1 的通用定时器作为 PWM 输出的使用方法,本文来学习通用定时器作为输入捕获的使用。本章要实现的功能是:通过 TIM5 的通道 1(PA0)捕获外界输入信号的高电平脉宽,通过 printf 打印捕获的高电平时间,D1 指示灯不断闪烁表示系统正常运行。 输入捕获简介 在定时器中断实验章节中我们介绍了通用定时器具有多种功能, 输入捕获就是其中一种。STM32F1 除了基本定时器 TIM6 和 TIM7,其他定时器都具有输入捕获功能。输入捕获可以对输入的信号的上升沿,下降沿或者双边沿进行捕获,通常用于测量输入信号的脉宽、测量 PWM 输入信号的频率及占空比。 输入捕获的工作原理比较简单,在输入捕获模式下,当相应的 ICx 信号检测到跳变沿后,将使用捕获/比较寄存器(TIMx_CCRx)来锁存计数器的值。简单的说就是通过检测 TIMx_CHx 上的边沿信号,在边沿信号发生跳变(比如上升沿/下降沿)的时候,将当前定时器的值(TIMx_CNT)存放到对应的通道的捕获/比较寄存(TIMx_CCRx)里面,完成一次捕获。同时还可以配置捕获时是否触发中断/DMA 等。下面我们以输入捕获测量脉宽为例,通过一个简图来介绍输入捕获的工作原理,输入捕获脉宽测量图如下图所示。 ![]() 从图中可以看出,t1-t2 时间就是我们需要测量的高电平时间,假如定时器工作在向上计数模式,测量方法是:首先设置定时器通道 x 为上升沿捕获,这样在 t1 时刻,就会捕获到当前的 CNT 值,然后立即清零 CNT,并设置通 道 x为下降沿捕获,这样到 t2 时刻,又会发生捕获事件,得到此时的 CNT 值,记为 CCRx2。根据定时器的计数频率,我们就可以算出 t1-t2 的时间,从而得到高电平脉宽。在 t1-t2 时间内可能会出现 N 次定时器溢出,因此我们还需要对定时器溢出进行处理,防止因高电平时间过长发生溢出导致测量数据不准。CNT计数的次数等于:N*ARR+CCRx2,有了这个计数次数,再乘以 CNT 的计数周期,即可得到 t2-t1 的时间长度,即高电平持续时间。 上述涉及到的寄存器可以参考《STM32F10x 中文参考手册》-14定时器章节的寄存器部分,里面有详细寄存器功能介绍。如果看不懂的可以暂时放下,因为我们使用的是库函数开发。STM32F1 通用定时器的输入捕获功能在前面“定时器中断实验”文中也有详细的介绍,大家可以回过头看下。 输入捕获配置步骤 接下来我们介绍下如何使用库函数对通用定时器的输入捕获进行配置。这个也是在编写程序中必须要了解的。其实输入捕获和前面定时器中断一样也是通用定时器的一个功能, 因此还是要用到定时器的相关配置函数, 具体步骤如下:(定时器相关库函数在 stm32f10x_tim.c 和 stm32f10x_tim.h 文件中) (1)使能定时器及端口时钟,并设置引脚模式等 因为输入捕获也是通用定时器的一个功能,所以需要使能相应定时器时钟。由于输入捕获通道是对应着 STM32F1 芯片的IO 口,所以需要使能对应的端口时钟,并将对应 IO 口设置为输入模式功能。例如本章输入捕获实验,我们是使用TIM5的CH1 通道来测量输入信号的脉宽,因此需要使能 TIM5 时钟,调用的库函数如下:
而 TIM5 的 CH1 通道对应的管脚是 PA0,在 STM32F1 芯片数据手册引脚功能上都有介绍如下: ![]() 所以需要使能 GPIOA端口时钟。因为我们使用 PA0 来测量输入信号的高电平时间,因此需要将 PA0 配置为下拉输入模式。GPIO 初始化如下:
(2)初始化定时器参数,包含自动重装值,分频系数,计数方式等 要使用定时器功能,必须对定时器内相关参数初始化,其库函数如下:
这个在定时器中断章节就已经介绍。 (3)设置通用定时器的输入捕获参数,开启输入捕获功能 初始化定时器后,需要设置对应输入捕获通道参数,比如输入通道、滤波、分频系数、映射关系、捕获极性等。输入捕获参数初始化函数如下:
函数的第一个参数相信大家一看就清楚,是用来选择定时器的。第二个参数是一个结构体指针变量,同样我们看下这个结构体 TIM_ICInitTypeDef 成员变量:
TIM_Channel:输入捕获通道设置,通用定时器每个多达 4 个通道,假如我们使用TIM5 的通道 1,参数为TIM_Channel_1。 TIM_ICPolarity:输入信号的有效捕获极性设置,假如我们需要对输入信号上升沿开始捕获,参数为 TIM_ICPolarity_Rising,如果是下降沿捕获,参数为TIM_ICPolarity_Rising。库函数内还提供了单独设置通道捕获极性的函数,假如要修改 TIM5 的通道 1捕获极性为下降沿,函数如下:
此函数可以理解为通用函数 TIM_OCxPolarityConfig(),函数中的 x表示通道, 所以如果是对通道 2 捕获极性操作, 可以调用 TIM_OC2PolarityConfig函数。 TIM_ICSelection:映射设置,在“定时器中断实验”章节中,我们分析了 通用定时器结构框图,知道 ICx 可以映射到 2 个 TIx 上,比如 IC1 可以直接映射到 TI1上,也可以间接映射到 TI2 上,但是不能映射到 TI3 和 TI4 上。假如我们直接映射在 TI1 上,参数为TIM_ICSelection_DirectTI。 TIM_ICPrescaler:分频系数设置,分频系数可以为 TIM_ICPSC_DIV1、TIM_ICPSC_DIV2、TIM_ICPSC_DIV4、TIM_ICPSC_DIV8,假如我们不分频,参数为TIM_ICPSC_DIV1。 TIM_ICFilter:滤波长度设置,假如我们不使用滤波器,参数为0。如果我们需要配置TIM5 的通道 1 为输入捕获功能,并且为上升沿捕获、不分频、直接映射到 TI,可以如下配置:
(4)开启捕获和定时器溢出(更新)中断 假如我们需要检测输入信号的高电平脉宽, 就需要在第一次上升沿到来时捕获一次,然后设置为下降沿捕获,等到下降沿到来时又捕获一次。如果输入信号的高电平脉宽比较长, 那么定时器就可能溢出, 所以需要对定时器溢出进行处理,否则计算的高电平时间将不准。所以需要开启定时器溢出中断。 对定时器中断类型和使能设置的函数如下:
假如我们要开启 TIM5的捕获中断和定时器溢出中断,调用函数如下:
(5)设置定时器中断优先级,使能定时器中断通道 在上一步我们已经使能了定时器的捕获和更新中断,只要使用到中断,就必需对 NVIC 初始化,NVIC 初始化库函数是 NVIC_Init(),这个在前面讲解 STM32中断时就已经介绍过,不清楚的可以回过头看下。 (6)编写定时器中断服务函数 最后我们还需要编写一个定时器中断服务函数, 通过中断函数处理定时器产生的相关中断。定时器中断服务函数名在 STM32F1 启动文件内就有,TIM5 中断函数名如下:
因为定时器的中断类型有很多,所以进入中断后,我们需要在中断服务函数开头处判断是哪种类型,根据不同中断类型完成相应功能,比如我们需要在捕获中断内完成捕获成功记录,更新中断内完成溢出次数的累计。在中断结束时要清除中断标志,这些在前面定时器中断实验中都有介绍。库函数中用来读取定时器中断状态标志位的函数如下:
清除中断标志位的函数如下:
当进入第一次捕获中断,我们会先清空计数器内值,例如对 TIM5 计数器值清空,函数如下:
(7)使能定时器 前面几个步骤已经将定时器输入捕获配置好,但还不能正常使用,只有开启定时器了才能让它正常工作,开启定时器的库函数如下:
例如我们要开启 TIM5,那么调用此函数如下:
将以上几步全部配置好后,我们就可以正常使用定时器输入捕获功能了。 本实验使用到硬件资源如下: (1)D1 指示灯 (2)K_UP 按键 (3)串口 1 (4)TIM5 的通道 1 D1指示灯、K_UP 按键、串口1 电路在前面章节都介绍过,至于 TIM5的通道1 它属于 STM32F1 芯片内部的资源。D1 指示灯用来提示系统正常运行,K_UP按键是接在 PA0 管脚上的,所以可以通过此按键输入一个高电平,通过串口 1的printf函数打印捕获到的高电平时间。 所要实现的功能是:使用 TIM5 的 CH1 检测输入信号高电平脉宽,将检 测的高电平脉宽时间通过printf 函数打印出来, 同时让 D1 指示灯不断闪烁表示系统正常运行。程序框架如下: (1)初始化 PA0 管脚为 TIM5 通道 1 输入捕获功能,开启捕获和溢出中断等 (2)编写 TIM5 中断服务函数 (3)编写主函数 在前面介绍输入捕获配置步骤时,就已经讲解如何初始化相关参数。下面我们打开“输入捕获实验”工程,在 APP 工程组中可以 看 到 添 加 了 input.c 文 件 , 在 StdPeriph_Driver 工 程 组 中 添 加 了stm32f10x_tim.c 库文件。定时器操作的库函数都放在 stm32f10x_tim.c 和stm32f10x_tim.h 文件中,所以使用到定时器功能就必须加入 stm32f10x_tim.c文件,同时还要包含对应的头文件路径。 TIM5 的 CH1 初始化函数 要使用 TIM5 的 CH1 的输入捕获功能,我们必须先对它进行配置。初始化代码如下:
在TIM5_CH1_Input_Init()函数中,首先使能 GPIOA 端口时钟和 TIM5时钟,其次配置PA0管脚模式配置为下拉输入。然后配置定时器结构体TIM_TimeBaseInitTypeDef,设置重装载值域分频系数等。再然后初始化 TIM5通道 1的输入捕获相关参数,我们设置为捕获通道 1、不进行滤波、上升沿捕获、分频系数为 1、直接映射到 TI1 上。开启定时器捕获和溢出中断,配置 TIM5 的中断优先级。最后使能 TIM5。这一过程在前面步骤介绍中已经提了。 TIM5_CH1_Input_Init()函数有两个参数,用来设置定时器的自动装载值和分频系数,方便大家修改计数器频率,具体计算参考定时器中断实验章节。因为TIM5是16 位的定时器,所以arr 为 u16 类型。 其实如果你会使用 TIM5 的 CH1 作为输入捕获,那么其他通用定时器通道的使用都类似。 TIM5 中断函数 初始化 TIM5 后,中断就已经开启了,当 TIM5 的 CH1 输入通道上检测到一个上升沿就会触发捕获中断管,如果计数器计数溢出,又会产生溢出中断。具体代码如下:
程序中我们定义了一个u8类型的全局变量 TIM5_CH1_CAPTURE_STA,此变量可以看成类似一个字节的寄存器,bit7 用来表示捕获完成,bit6 用来表示捕获到高电平,bit5-0 用来表示捕获高电平后定时器溢出次数。程序中还定义了一个 u16 类型的全局变量 TIM5_CH1_CAPTURE_VAL,用来记录捕获到下降沿时TIM5_CNT 值。这两个全部变量的申明在 input.h 文件中,在 input.c 文件开始处,有它们的定义。 获取 TIM5 输入捕获通道1的值库函数如下:
获取 TIM5 计数器值库函数如下:
要计算输入信号的高电平脉宽,根据输入捕获的工作原理,需要先捕获一次上升沿,然后再捕获一次下降沿,在高电平期间还需要对定时器溢出进行判断,统计定时器溢出次数。由于输入捕获初始化函数中就已经设置为上升沿捕获,并且 TIM5_CH1_CAPTURE_STA 变量初始值为 0,所以当捕获到第一个上升沿时,将TIM5_CH1_CAPTURE_STA、TIM5_CH1_CAPTURE_VAL 和 TIM5_CNT 计数器清 0,然后将 TIM5_CH1_CAPTURE_STA的bit6 置 1,表示已经捕获到高电平,此时还需要将输入捕获极性设置为下降沿捕获,等待下降沿到来。如果等待下降沿期间,计数器 出 现 溢 出 , 就 在 TIM5_CH1_CAPTURE_STA 内 累 计 溢 出 次 数 , 如 果TIM5_CH1_CAPTURE_STA 的 bit5-0 都累计满,我们就强制标记捕获完成 (TIM5_CH1_CAPTURE_STA 的bit7 置 1,虽然此时还没有捕获到下降沿),当下降沿到来的时,首先将 TIM5_CH1_CAPTURE_STA 的 bit7 置 1,表示成功捕获一次高电平,然后读取 TIM5_CNT 计数器内值保存到 TIM5_CH1_CAPTURE_VAL 内,最后设置捕获极性为上升沿,回到初始捕获状态。 这样我们就完成了一次高电平的捕获,只要 TIM5_CH1_CAPTURE_STA 的 bit7 一直为 1,就不会进行第二次捕获,这个时候如果主函数把捕获到高电平数据处理后,将 TIM5_CH1_CAPTURE_STA 的 bit7 清零就可以进入第二次捕获了。 主函数 编写好 TIM5_CH1 输入捕获初始化和中断函数后,接下来就可以编写主函数了,代码如下:
主函数实现的功能很简单,首先调用之前编写好的硬件初始化函数,包括 SysTick 系统时钟,中断分组,LED 初始化等。然后调用我们前面编写的 TIM5_CH1_Input_Init 函数,我们将 TIM5 的重装载值设置为 0XFFFF,预分频系数设置为 72-1,此时 TIM5 计数器频率为 1MHz,即计数一次时间为1us。最后进入 while 循环,首先判断 TIM5_CH1_CAPTURE_STA 变量的 bit7 是否为 1,如果为1 表示成功捕获,然后读取 TIM5_CH1_CAPTURE_STA 变量内 bit5-0 溢出次数,每一次溢出时间是 0xffffus,最后还要加上 TIM5_CH1_CAPTURE_VAL 的值保存在indata 内,通过 printf 函数打印高电平时间,然后将 TIM5_CH1_CAPTURE_STA变量清 0 即可,等待下次捕获。同时 D1 指示灯会间隔200ms 闪烁,提示系统正常运行。 将工程程序编译后下载到开发板内,可以看到 D1 指示灯不断闪烁,表示程序正常运行。按下 K_UP 按键,串口输出高电平持续时间。如果想在串口调试助手上看到输出信息,可以打开“串口调试助手”,首先勾选下标号 1 DTR 框,然后再取消勾选。这是因为此串口助手启动时会把系统复位住,通过 DTR 状态切换下即可。然后设置好波特率等参数后,串口助手上即会收到 printf 发送过来的信息。(前提一定要连接好线路,USB 线一端连接电脑,另一端连接开发板“USB 转串口模块”上的 USB 下载口。先勾选下标号1 DTR 框,然后再取消勾选)如下图所示: ![]() |
STM32 GUI LTDC 最大像素时钟评估方法
【2025·STM32峰会】GUI解决方案实训分享1-对LVGL咖啡机例程的牛刀小试以及问题排查
OpenBLT移植到STM32F405开发板
为什么要先开启STM32外设时钟?
【STM32MP157】从ST官方例程中分析RPMsg-TTY/SDB核间通信的使用方法
【经验分享】STM32实例-RTC实时时钟实验④-获取RTC时间函数与中断服务函数
STM32 以太网 MAC Loopback 的实现
刘氓兔的64位入门挑战【1】——MP257芯片下单和硬件准备
刘氓兔的64位入门挑战【0】——MP257选型
STM32功能安全设计包,助力产品功能安全认证