31. TIM—高级定时器

本章参考资料:《STM32F10X-中文参考手册》高级定时器章节。学习本章时,配合参考资料一起阅读,效果会更佳,特别是涉及到寄存器说明的部分。

31.1. 高级控制定时器

高级控制定时器(TIM1和TIM8)和通用定时器在基本定时器的基础上引入了外部引脚,可以实现输入捕获和输出比较功能。 高级控制定时器比通用定时器增加了可编程死区互补输出、重复计数器、带刹车(断路)功能,这些功能都是针对工业电机控制方面。 这几个功能在本书不做详细的介绍,主要介绍常用的输入捕获和输出比较功能。

高级控制定时器时基单元包含一个16位自动重装载寄存器ARR,一个16位的计数器CNT,可向上/下计数,一个16位可编程预分频器PSC, 预分频器时钟源有多种可选,有内部的时钟、外部时钟。还有一个8位的重复计数器RCR,这样最高可实现40位的可编程定时。

STM32F103RCT6的高级/通用定时器的IO分配具体见表 高级控制和通用定时器通道引脚分布。配套开发板因为IO资源紧缺, 定时器的IO很多已经复用它途,故下表中的IO只有部分可用于定时器的实验。

高级控制和通用定时器通道引脚分布

31.2. 高级控制定时器功能框图

高级控制定时器功能框图包含了高级控制定时器最核心内容,掌握了功能框图,对高级控制定时器就有一个整体的把握,在编程时思路就非常清晰, 见,图中有些寄存器是带影子的,表示其有影子寄存器。

高级控制定时器功能框图

31.2.1. 时钟源

高级控制定时器有四个时钟源可选:

  • 内部时钟源CK_INT

  • 外部时钟模式1:外部输入引脚TIx(x=1,2,3,4)

  • 外部时钟模式2:外部触发输入ETR

  • 内部触发输入(ITRx)

31.2.1.1. 内部时钟源(CK_INT)

内部时钟CK_INT即来自于芯片内部,等于72M,一般情况下,我们都是使用内部时钟。当从模式控制寄存器TIMx_SMCR的SMS位等于000时,则使用内部时钟。

31.2.1.2. 外部时钟模式1

外部时钟模式1框图

①:时钟信号输入引脚

当使用外部时钟模式1的时候,时钟信号来自于定时器的输入通道,总共有4个,分别为TI1/2/3/4,即TIMx_CH1/2/3/4。具体使用哪一路信号, 由TIM_CCMRx的位CCxS[1:0]配置,其中CCMR1控制TI1/2,CCMR2控制TI3/4。

②:滤波器

如果来自外部的时钟信号的频率过高或者混杂有高频干扰信号的话,我们就需要使用滤波器对信号重新采样,来达到降频或者去除高频干扰的目的,具体的由TIMx_CCMRx的位ICxF[3:0]配置。

③:边沿检测

边沿检测的信号来自于滤波器的输出,在成为触发信号之前,需要进行边沿检测,决定是上升沿有效还是下降沿有效,具体的由TIMx_CCER的位CCxP和CCxNP配置。

④:触发选择

当使用外部时钟模式1时,触发源有两个,一个是滤波后的定时器输入1(TI1FP1)和滤波后的定时器输入2(TI2FP2),具体的由TIMxSMCR的位TS[2:0]配置。

⑤:从模式选择

选定了触发源信号后,最后我们需把信号连接到TRGI引脚,让触发信号成为外部时钟模式1的输入,最终等于CK_PSC,然后驱动计数器CNT计数。 具体的配置TIMx_SMCR的位SMS[2:0]为000即可选择外部时钟模式1。

⑥:使能计数器

经过上面的5个步骤之后,最后我们只需使能计数器开始计数,外部时钟模式1的配置就算完成。使能计数器由TIMx_CR1的位CEN配置。

31.2.1.3. 外部时钟模式2

外部时钟模式2框图

①:时钟信号输入引脚

当使用外部时钟模式2的时候,时钟信号来自于定时器的特定输入通道TIMx_ETR,只有1个。

②:外部触发极性

来自ETR引脚输入的信号可以选择为上升沿或者下降沿有效,具体的由TIMx_SMCR的位ETP配置。

③:外部触发预分频器

由于ETRP的信号的频率不能超过TIMx_CLK(72M)的1/4,当触发信号的频率很高的情况下, 就必须使用分频器来降频,具体的由 TIMx_SMCR的位ETPS[1:0]配置。

④:滤波器

如果ETRP的信号的频率过高或者混杂有高频干扰信号的话,我们就需要使用滤波器对ETRP信号重新采样, 来达到降频或者去除高频干扰的目的。具体的由TIMx_SMCR的位ETF[3:0]配置, 其中的fDTS是由内部时钟CK_INT分频得到,具体的由TIMx_CR1的位CKD[1:0]配置。

⑤:从模式选择

经过滤波器滤波的信号连接到ETRF引脚后,触发信号成为外部时钟模式2的输入,最终等于CK_PSC,然后驱动计数器CNT计数。具体的配置TIMx_SMCR的位ECE为1即可选择外部时钟模式2。

⑥:使能计数器

经过上面的5个步骤之后,最后我们只需使能计数器开始计数,外部时钟模式2的配置就算完成。使能计数器由TIMx_CR1的位CEN配置。

31.2.1.4. 内部触发输入

内部触发输入是使用一个定时器作为另一个定时器的预分频器。硬件上高级控制定时器和通用定时器在内部连接在一起, 可以实现定时器同步或级联。主模式的定时器可以对从模式定时器执行复位、启动、停止或提供时钟。

31.2.2. 控制器

高级控制定时器控制器部分包括触发控制器、从模式控制器以及编码器接口。触发控制器用来针对片内外设输出触发信号,比如为其它定时器提供时钟和触发DAC/ADC转换。

编码器接口专门针对编码器计数而设计。从模式控制器可以控制计数器复位、启动、递增/递减、计数。有关控制器部分只需熟练阅读寄存器描述即可。

31.2.3. 时基单元

高级定时器时基单元

高级控制定时器时基单元功能包括四个寄存器,分别是计数器寄存器(CNT)、预分频器寄存器(PSC)、自动重载寄存器(ARR)和重复计数器寄存器(RCR)。 其中重复计数器RCR是高级定时器独有,通用和基本定时器没有。前面三个寄存器都是16位有效,TIMx_RCR寄存器是8位有效。

31.2.3.1. 预分频器PSC

预分频器PSC,有一个输入时钟CK_PSC和一个输出时钟CK_CNT。输入时钟CK_PSC就是上面时钟源的输出,输出CK_CNT则用来驱动计数器CNT计数。 通过设置预分频器PSC的值可以得到不同的CK_CNT, 实际计算为:fCK_CNT等于f:sub:CK_PSC/(PSC[15:0]+1),可以实现1至65536分频。

31.2.3.2. 计数器CNT

高级控制定时器的计数器有三种计数模式,分别为递增计数模式、递减计数模式和递增/递减(中心对齐)计数模式。

(1) 递增计数模式下,计数器从0开始计数,每来一个CK_CNT脉冲计数器就增加1,直到计数器的值与自动重载寄存器ARR值相等, 然后计数器又从0开始计数并生成计数器上溢事件,计数器总是如此循环计数。如果禁用重复计数器,在计数器生成上溢事件就马上生成更新事件(UEV); 如果使能重复计数器,每生成一次上溢事件重复计数器内容就减1,直到重复计数器内容为0时才会生成更新事件。

(2) 递减计数模式下,计数器从自动重载寄存器ARR值开始计数,每来一个CK_CNT脉冲计数器就减1,直到计数器值为0, 然后计数器又从自动重载寄存器ARR值开始递减计数并生成计数器下溢事件,计数器总是如此循环计数。如果禁用重复计数器, 在计数器生成下溢事件就马上生成更新事件;如果使能重复计数器,每生成一次下溢事件重复计数器内容就减1,直到重复计数器内容为0时才会生成更新事件。

(3) 中心对齐模式下,计数器从0开始递增计数,直到计数值等于(ARR-1)值生成计数器上溢事件, 然后从ARR值开始递减计数直到1生成计数器下溢事件。然后又从0开始计数,如此循环。每次发生计数器上溢和下溢事件都会生成更新事件。

31.2.3.3. 自动重载寄存器ARR

自动重载寄存器ARR用来存放与计数器CNT比较的值,如果两个值相等就递减重复计数器。可以通过TIMx_CR1寄存器的ARPE位控制自动重载影子寄存器功能, 如果ARPE位置1,自动重载影子寄存器有效,只有在事件更新时才把TIMx_ARR值赋给影子寄存器。如果ARPE位为0,则修改TIMx_ARR值马上有效。

31.2.3.4. 重复计数器RCR

在基本/通用定时器发生上/下溢事件时直接就生成更新事件,但对于高级控制定时器却不是这样,高级控制定时器在硬件结构上多出了重复计数器, 在定时器发生上溢或下溢事件是递减重复计数器的值,只有当重复计数器为0时才会生成更新事件。在发生N+1个上溢或下溢事件(N为RCR的值)时产生更新事件。

31.2.4. 输入捕获

输入捕获功能框图

输入捕获可以对输入的信号的上升沿,下降沿或者双边沿进行捕获,常用的有测量输入信号的脉宽和测量PWM输入信号的频率和占空比这两种。

输入捕获的大概的原理就是,当捕获到信号的跳变沿的时候,把计数器CNT的值锁存到捕获寄存器CCR中,把前后两次捕获到的CCR寄存器中的值相减, 就可以算出脉宽或者频率。如果捕获的脉宽的时间长度超过你的捕获定时器的周期,就会发生溢出,这个我们需要做额外的处理。

31.2.4.1. 输入通道

需要被测量的信号从定时器的外部引脚TIMx_CH1/2/3/4进入,通常叫TI1/2/3/4,在后面的捕获讲解中对于要被测量的信号我们都以TIx为标准叫法。

31.2.4.2. 输入滤波器和边沿检测器

当输入的信号存在高频干扰的时候,我们需要对输入信号进行滤波,即进行重新采样,根据采样定律,采样的频率必须大于等于两倍的输入信号。 比如输入的信号为1M,又存在高频的信号干扰,那么此时就很有必要进行滤波,我们可以设置采样频率为2M, 这样可以在保证采样到有效信号的基础上把高于2M的高频干扰信号过滤掉。

滤波器的配置由CR1寄存器的位CKD[1:0]和CCMR1/2的位ICxF[3:0]控制。从ICxF位的描述可知, 采样频率fSAMPLE可以由fCK_INT和fDTS分频后的时钟提供, 其中是fCK_INT内部时钟,fDTS是fCK_INT经过分频后得到的频率, 分频因子由CKD[1:0]决定,可以是不分频,2分频或者是4分频。

边沿检测器用来设置信号在捕获的时候是什么边沿有效,可以是上升沿,下降沿,或者是双边沿,具体的由CCER寄存器的位CCxP和CCxNP决定。

31.2.4.3. 捕获通道

捕获通道就是图中的IC1/2/3/4,每个捕获通道都有相对应的捕获寄存器CCR1/2/3/4,当发生捕获的时候,计数器CNT的值就会被锁存到捕获寄存器中。

这里我们要搞清楚输入通道和捕获通道的区别,输入通道是用来输入信号的,捕获通道是用来捕获输入信号的通道, 一个输入通道的信号可以同时输入给两个捕获通道。比如输入通道TI1的信号经过滤波边沿检测器之后的TI1FP1和TI1FP2可以进入到捕获通道IC1和IC2, 其实这就是我们后面要讲的PWM输入捕获,只有一路输入信号(TI1)却占用了两个捕获通道(IC1和IC2)。当只需要测量输入信号的脉宽时候, 用一个捕获通道即可。输入通道和捕获通道的映射关系具体由寄存器CCMRx的位CCxS[1:0]配置。

31.2.4.4. 预分频器

ICx的输出信号会经过一个预分频器,用于决定发生多少个事件时进行一次捕获。具体的由寄存器CCMRx的位ICxPSC配置,如果希望捕获信号的每一个边沿,则不分频。

31.2.4.5. 捕获寄存器

经过预分频器的信号ICxPS是最终被捕获的信号,当发生捕获时(第一次),计数器CNT的值会被锁存到捕获寄存器CCR中, 还会产生CCxI中断,相应的中断位CCxIF(在SR寄存器中)会被置位,通过软件或者读取CCR中的值可以将CCxIF清0。 如果发生第二次捕获(即重复捕获:CCR寄存器中已捕获到计数器值且 CCxIF 标志已置 1), 则捕获溢出标志位CCxOF(在SR寄存器中)会被置位,CCxOF只能通过软件清零。

31.2.5. 输出比较

输出比较功能框图

输出比较就是通过定时器的外部引脚对外输出控制信号,有冻结、将通道X(x=1,2,3,4)设置为匹配时输出有效电平、 将通道X设置为匹配时输出无效电平、翻转、强制变为无效电平、强制变为有效电平、PWM1和PWM2这八种模式, 具体使用哪种模式由寄存器CCMRx的位OCxM[2:0]配置。其中PWM模式是输出比较中的特例,使用的也最多。

31.2.5.1. 比较寄存器

当计数器CNT的值跟比较寄存器CCR的值相等的时候,输出参考信号OCxREF的信号的极性就会改变,其中OCxREF=1(高电平)称之为有效电平, OCxREF=0(低电平)称之为无效电平,并且会产生比较中断CCxI,相应的标志位CCxIF(SR寄存器中)会置位。 然后OCxREF再经过一系列的控制之后就成为真正的输出信号OCx/OCxN。

31.2.5.2. 死区发生器

在生成的参考波形OCxREF的基础上,可以插入死区时间,用于生成两路互补的输出信号OCx和OCxN, 死区时间的大小具体由BDTR寄存器的位DTG[7:0]配置。死区时间的大小必须根据与输出信号相连接的器件及其特性来调整。 下面我们简单举例说明下带死区的PWM信号的应用,我们以一个板桥驱动电路为例。

半桥驱动电路

在这个半桥驱动电路中,Q1导通,Q2截止,此时我想让Q1截止Q2导通,肯定是要先让Q1截止一段时间之后,再等一段时间才让Q2导通, 那么这段等待的时间就称为死区时间,因为Q1关闭需要时间(由MOS管的工艺决定)。如果Q1关闭之后,马上打开Q2, 那么此时一段时间内相当于Q1和Q2都导通了,这样电路会短路。

带死区插入的互补输出 是针对上面的半桥驱动电路而画的带死区插入的PWM信号,图中的死区时间要根据MOS管的工艺来调节。

带死区插入的互补输出

31.2.5.3. 输出控制

输出比较

在输出比较的输出控制中,参考信号OCxREF在经过死区发生器之后会产生两路带死区的互补信号OCx_DT和OCxN_DT(通道1~3才有互补信号,通道4没有, 其余跟通道1~3一样),这两路带死区的互补信号然后就进入输出控制电路,如果没有加入死区控制,那么进入输出控制电路的信号就直接是OCxREF。

进入输出控制电路的信号会被分成两路,一路是原始信号,一路是被反向的信号,具体的由寄存器CCER的位CCxP和CCxNP控制。 经过极性选择的信号是否由OCx引脚输出到外部引脚CHx/CHxN则由寄存器CCER的位CxE/CxNE配置。

如果加入了断路(刹车)功能,则断路和死区寄存器BDTR的MOE、OSSI和OSSR这三个位会共同影响输出的信号。

31.2.5.4. 输出引脚

输出比较的输出信号最终是通过定时器的外部IO来输出的,分别为CH1/2/3/4, 其中前面三个通道还有互补的输出通道CH1/2/3N。更加详细的IO说明还请查阅相关的数据手册。

31.2.6. 断路功能

断路功能就是电机控制的刹车功能,使能断路功能时,根据相关控制位状态修改输出信号电平。在任何情况下, OCx和OCxN输出都不能同时为有效电平,这关系到电机控制常用的H桥电路结构原因。

断路源可以是时钟故障事件,由内部复位时钟控制器中的时钟安全系统(CSS)生成,也可以是外部断路输入IO,两者是或运算关系。

系统复位启动都默认关闭断路功能,将断路和死区寄存器(TIMx_BDTR)的BKE为置1,使能断路功能。 可通过TIMx_BDTR 寄存器的BKP位设置设置断路输入引脚的有效电平,设置为1时输入BRK为高电平有效,否则低电平有效。

发送断路时,将产生以下效果:

  • TIMx_BDTR 寄存器中主输出模式使能(MOE)位被清零,输出处于无效、空闲或复位状态;

  • 根据相关控制位状态控制输出通道引脚电平;当使能通道互补输出时,会根据情况自动控制输出通道电平;

  • 将TIMx_SR 寄存器中的 BIF位置 1,并可产生中断和DMA传输请求。

  • 如果 TIMx_BDTR 寄存器中的 自动输出使能(AOE)位置 1,则MOE位会在发生下一个UEV事件时自动再次置 1。

31.3. 输入捕获应用

输入捕获一般应用在两个方面,一个方面是脉冲跳变沿时间测量,另一方面是PWM输入测量。

31.3.1. 测量脉宽或者频率

脉宽_频率测量示意图

31.3.1.1. 测量频率

当捕获通道TIx上出现上升沿时,发生第一次捕获,计数器CNT的值会被锁存到捕获寄存器CCR中,而且还会进入捕获中断, 在中断服务程序中记录一次捕获(可以用一个标志变量来记录),并把捕获寄存器中的值读取到value1中。当出现第二次上升沿时, 发生第二次捕获,计数器CNT的值会再次被锁存到捕获寄存器CCR中,并再次进入捕获中断,在捕获中断中,把捕获寄存器的值读取到value3中, 并清除捕获记录标志。利用value3和value1的差值我们就可以算出信号的周期(频率)。

31.3.1.2. 测量脉宽

当捕获通道TIx上出现上升沿时,发生第一次捕获,计数器CNT的值会被锁存到捕获寄存器CCR中,而且还会进入捕获中断, 在中断服务程序中记录一次捕获(可以用一个标志变量来记录),并把捕获寄存器中的值读取到value1中。然后把捕获边沿改变为下降沿捕获, 目的是捕获后面的下降沿。当下降沿到来的时候,发生第二次捕获,计数器CNT的值会再次被锁存到捕获寄存器CCR中,并再次进入捕获中断,在捕获中断中, 把捕获寄存器的值读取到value3中,并清除捕获记录标志。然后把捕获边沿设置为上升沿捕获。

在测量脉宽过程中需要来回的切换捕获边沿的极性,如果测量的脉宽时间比较长,定时器就会发生溢出, 溢出的时候会产生更新中断,我们可以在中断里面对溢出进行记录处理。

31.3.2. PWM输入模式

测量脉宽和频率还有一个更简便的方法就是使用PWM输入模式,该模式是输入捕获的特例,只能使用通道1和通道2,通道3和通道4使用不了。 与上面那种只使用一个捕获寄存器测量脉宽和频率的方法相比,PWM输入模式需要占用两个捕获寄存器。

输入通道和捕获通道的关系映射图

当使用PWM输入模式的时候,因为一个输入通道(TIx)会占用两个捕获通道(ICx),所以一个定时器在使用PWM输入的时候最多只能使用两个输入通道(TIx)。

我们以输入通道TI1工作在PWM输入模式为例来讲解下具体的工作原理,其他通道以此类推即可。

PWM信号由输入通道TI1进入,因为是PWM输入模式的缘故,信号会被分为两路,一路是TI1FP1,另外一路是TI2FP2。其中一路是周期, 另一路是占空比,具体哪一路信号对应周期还是占空比,得从程序上设置哪一路信号作为触发输入,作为触发输入的哪一路信号对应的就是周期, 另一路就是对应占空比。作为触发输入的那一路信号还需要设置极性,是上升沿还是下降沿捕获,一旦设置好触发输入的极性, 另外一路硬件就会自动配置为相反的极性捕获,无需软件配置。一句话概括就是:选定输入通道,确定触发信号,然后设置触发信号的极性即可, 因为是PWM输入的缘故,另一路信号则由硬件配置,无需软件配置。

当使用PWM输入模式的时候必须将从模式控制器配置为复位模式(配置寄存器SMCR的位SMS[2:0]来实现), 即当我们启动触发信号开始进行捕获的时候,同时把计数器CNT复位清零。

下面我们以一个更加具体的时序图来分析下PWM输入模式。

PWM输入模式时序

PWM信号由输入通道TI1进入,配置TI1FP1为触发信号,上升沿捕获。当上升沿的时候IC1和IC2同时捕获,计数器CNT清零, 到了下降沿的时候,IC2捕获,此时计数器CNT的值被锁存到捕获寄存器CCR2中,到了下一个上升沿的时候,IC1捕获, 计数器CNT的值被锁存到捕获寄存器CCR1中。其中CCR2+1测量的是脉宽,CCR1+1测量的是周期。 这里要注意的是CCR2和CCR1的值在计算占空比和频率的时候都必须加1,因为计数器是从0开始计数的。

从软件上来说,用PWM输入模式测量脉宽和周期更容易,付出的代价是需要占用两个捕获寄存器。

31.4. 输出比较应用

输出比较模式总共有8种,具体的由寄存器CCMRx的位OCxM[2:0]配置。我们这里只讲解最常用的PWM模式,其他几种模式具体的看数据手册即可。

31.4.1. PWM输出模式

PWM输出就是对外输出脉宽(即占空比)可调的方波信号,信号频率由自动重装寄存器ARR的值决定,占空比由比较寄存器CCR的值决定。

PWM模式分为两种,PWM1和PWM2,总得来说是差不多,就看你怎么用而已, 具体的区别见表格 PWM1与PWM2模式的区别

PWM1与PWM2模式的区别

下面我们以PWM1模式来讲解,以计数器CNT计数的方向不同还分为边沿对齐模式和中心对齐模式。PWM信号主要都是用来控制电机, 一般的电机控制用的都是边沿对齐模式,FOC电机一般用中心对齐模式。我们这里只分析这两种模式在信号感官上(即信号波形)的区别, 具体在电机控制中的区别不做讨论,到了你真正需要使用的时候就会知道了。

31.4.1.1. PWM边沿对齐模式

在递增计数模式下,计数器从 0 计数到自动重载值( TIMx_ARR寄存器的内容),然后重新从 0 开始计数并生成计数器上溢事件

PWM1模式的边沿对齐波形

在边沿对齐模式下,计数器CNT只工作在一种模式,递增或者递减模式。这里我们以CNT工作在递增模式为例, 在中,ARR=8,CCR=4,CNT从0开始计数,当CNT<CCR的值时,OCxREF为有效的高电平,于此同时,比较中断寄存器CCxIF置位。 当CCR=<CNT<=ARR时,OCxREF为无效的低电平。然后CNT又从0开始计数并生成计数器上溢事件,以此循环往复。

31.4.1.2. PWM中心对齐模式

PWM1模式的中心对齐波形

在中心对齐模式下,计数器CNT是工作做递增/递减模式下。开始的时候,计数器CNT从 0 开始计数到自动重载值减1(ARR-1), 生成计数器上溢事件;然后从自动重载值开始向下计数到 1 并生成计数器下溢事件。之后从0 开始重新计数。

PWM1模式的中心对齐波形 是PWM1模式的中心对齐波形,ARR=8,CCR=4。 第一阶段计数器CNT工作在递增模式下,从0开始计数,当CNT<CCR的值时,OCxREF为有效的高电平, 当CCR=<CNT<<ARR时,OCxREF为无效的低电平。第二阶段计数器CNT工作在递减模式,从ARR的值开始递减, 当CNT>CCR时,OCxREF为无效的低电平,当CCR=>CNT>=1时,OCxREF为有效的高电平。

在波形图上我们把波形分为两个阶段,第一个阶段是计数器CNT工作在递增模式的波形,这个阶段我们又分为①和②两个阶段, 第二个阶段是计数器CNT工作在递减模式的波形,这个阶段我们又分为③和④两个阶段。要说中心对齐模式下的波形有什么特征的话, 那就是①和③阶段的时间相等,②和④阶段的时间相等。

中心对齐模式又分为中心对齐模式1/2/3 三种,具体由寄存器CR1位CMS[1:0]配置。 具体的区别就是比较中断中断标志位CCxIF在何时置1:中心模式1在CNT递减计数的时候置1, 中心对齐模式2在CNT递增计数时置1,中心模式3在CNT递增和递减计数时都置1。

31.5. 定时器初始化结构体详解

在HAL库函数头文件stm32f1xx_hal_tim.h中对定时器外设建立了四个初始化结构体,分别为时基初始化结构体TIM_TimeBaseInitTypeDef、 输出比较初始化结构体TIM_OC_InitTypeDef、输入捕获初始化结构体TIM_ICInitTypeDef和断路和死区初始化结构体TIM_BDTRInitTypeDef, 高级控制定时器可以用到所有初始化结构体,通用定时器不能使用TIM_BDTRInitTypeDef结构体, 基本定时器只能使用时基结构体。接下来我们具体讲解下这四个结构体。

31.5.1. TIM_TimeBaseInitTypeDef

时基结构体TIM_TimeBaseInitTypeDef用于定时器基础参数设置,与TIM_TimeBaseInit函数配合使用完成配置。

代码清单:高级定时器-1 定时器基本初始化结构体
1
2
3
4
5
6
7
typedef struct {
    uint32_t Prescaler;          // 预分频器
    uint32_t CounterMode;        // 计数模式
    uint32_t Period;             // 定时器周期
    uint32_t ClockDivision;      // 时钟分频
    uint32_t RepetitionCounter;   // 重复计算器
} TIM_TimeBaseInitTypeDef;

(1) Prescaler: 定时器预分频器设置,时钟源经该预分频器才是定时器计数时钟CK_CNT,它设定PSC寄存器的值。 计算公式为:计数器时钟频率 (fCK_CNT) 等于 fCK_PSC / (PSC[15:0] + 1),可实现1至65536分频。

(2) CounterMode: 定时器计数方式,可设置为向上计数、向下计数以及中心对齐。高级控制定时器允许选择任意一种。

(3) Period: 定时器周期,实际就是设定自动重载寄存器ARR的值,ARR 为要装载到实际自动重载寄存器(即影子寄存器)的值,可设置范围为0至65535。

(4) ClockDivision: 时钟分频,设置定时器时钟CK_INT频率与死区发生器以及数字滤波器采样时钟频率分频比。可以选择1、2、4分频。

(5) RepetitionCounter: 重复计数器,只有8位,只存在于高级定时器。

31.5.1.1. TIM_OC_InitTypeDef

输出比较结构体TIM_OC_InitTypeDef用于输出比较模式,与TIM_OCxInit函数配合使用完成指定定时器输出通道初始化配置。高级控制定时器有四个定时器通道,使用时都必须单独设置。

代码清单:高级定时器-2 定时器比较输出初始化结构体
1
2
3
4
5
6
7
8
9
typedef struct {
    uint32_t OCMode;                // 比较输出模式
    uint32_t Pulse;                 // 脉冲宽度
    uint32_t OCPolarity;    // 输出极性
    uint32_t OCNPolarity;      // 互补输出极性
    uint32_t OCFastMode;            // 比较输出模式快速使能
    uint32_t OCIdleState;           // 空闲状态下比较输出状态
    uint32_t OCNIdleState;          // 空闲状态下比较互补输出状态
} TIM_OCInitTypeDef;

(1) OCMode:比较输出模式选择,总共有八种,常用的为PWM1/PWM2。 它设定CCMRx寄存器OCxM[2:0]位的值。

(2) Pulse:比较输出脉冲宽度,实际设定比较寄存器CCR的值, 决定脉冲宽度。可设置范围为0至65535。

(3) OCPolarity:比较输出极性,可选OCx为高电平有效或低电平有效。 它决定着定时器通道有效电平。它设定CCER寄存器的CCxP位的值。

(4) OCNPolarity:比较互补输出极性,可选OCxN为高电平有效或低电平有效。 它设定TIMx_CCER寄存器的CCxNP位的值。

(5) OCFastMode:比较输出模式快速使能。它设定TIMx_CCMR寄存器的, OCxFE位的值可以快速使能或者禁能输出。

(6) OCIdleState:空闲状态时通道输出电平设置,可选输出1或输出0, 即在空闲状态(BDTR_MOE位为0)时,经过死区时间后定时器通道输出高电平或低电平。它设定CR2寄存器的OISx位的值。

(7) OCNIdleState:空闲状态时互补通道输出电平设置,可选输出1或输出0, 即在空闲状态(BDTR_MOE位为0)时,经过死区时间后定时器互补通道输出高电平或低电平,设定值必须与OCIdleState相反。它设定是CR2寄存器的OISxN位的值。

31.5.2. TIM_IC_InitTypeDef

输入捕获结构体TIM_IC_InitTypeDef用于输入捕获模式,与HAL_TIM_IC_ConfigChannel函数配合使用完成定时器输入通道初始化配置。 如果使用PWM输入模式需要与HAL_TIM_PWM_ConfigChannel函数配合使用完成定时器输入通道初始化配置。

代码清单:高级定时器-3 定时器输入捕获初始化结构体
1
2
3
4
5
6
typedef struct {
    uint32_t ICPolarity;   // 输入捕获触发选择
    uint32_t ICSelection;  // 输入捕获选择
    uint32_t ICPrescaler;  // 输入捕获预分频器
    uint32_t ICFilter;     // 输入捕获滤波器
} TIM_IC_InitTypeDef;

(1) ICPolarity:输入捕获边沿触发选择,可选上升沿触发、下降沿触发或边沿跳变触发。 它设定CCER寄存器CCxP位和CCxNP位的值。

(2) ICSelection:输入通道选择,捕获通道ICx的信号可来自三个输入通道, 分别为TIM_ICSELECTION_DIRECTTI、TIM_ICSELECTION_INDIRECTTI或TIM_ICSELECTION_TRC, 具体的区别见图 输入通道与捕获通道IC的映射图 。它设定CCRMx寄存器的CCxS[1:0]位的值。

输入通道与捕获通道IC的映射图

(3) ICPrescaler:输入捕获通道预分频器,可设置1、2、4、8分频,它设定CCMRx寄存器的ICxPSC[1:0]位的值。 如果需要捕获输入信号的每个有效边沿,则设置1分频即可。

(4) ICFilter:输入捕获滤波器设置,可选设置0x0至0x0F。它设定CCMRx寄存器ICxF[3:0]位的值。 一般我们不使用滤波器,即设置为0。

31.5.3. TIM_BreakDeadTimeConfigTypeDef

断路和死区结构体TIM_BreakDeadTimeConfigTypeDef用于断路和死区参数的设置,属于高级定时器专用, 用于配置断路时通道输出状态,以及死区时间。它与HAL_TIMEx_ConfigBreakDeadTime函数配置使用完成参数配置。 这个结构体的成员只对应BDTR这个寄存器,有关成员的具体使用配置请参考手册BDTR寄存器的详细描述。

代码清单:高级定时器-4 断路和死区初始化结构体
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
typedef struct {
    uint32_t OffStateRunMode;        // 运行模式下的关闭状态选择
    uint32_t OffStateIDLEMode;       // 空闲模式下的关闭状态选择
    uint32_t LockLevel;             // 锁定配置
    uint32_t DeadTime;              // 死区时间
    uint32_t BreakState;             // 断路输入使能控制
    uint32_t BreakPolarity;         // 断路输入极性
    uint32_t BreakFilter;                   // 断路输入滤波器
    uint32_t Break2State;                   // 断路2输入使能控制
    uint32_t Break2Polarity;        // 断路2输入极性
    uint32_t Break2Filter;                  // 断路2输入滤波器
    uint32_t AutomaticOutput;        // 自动输出使能
} TIM_BreakDeadTimeConfigTypeDef;

(1) OffStateRunMode: 运行模式下的关闭状态选择,它设定BDTR寄存器OSSR位的值。

(2) OffStateIDLEMode: 空闲模式下的关闭状态选择,它设定BDTR寄存器OSSI位的值。

(3) LockLevel: 锁定级别配置, BDTR寄存器LOCK[1:0]位的值。

(4) DeadTime: 配置死区发生器,定义死区持续时间,可选设置范围为0x0至0xFF。它设定BDTR寄存器DTG[7:0]位的值。

(5) BreakState: 断路输入功能选择,可选使能或禁止。它设定BDTR寄存器BKE位的值。

(6) BreakPolarity: 断路输入通道BRK极性选择,可选高电平有效或低电平有效。它设定BDTR寄存器BKP位的值。

(7) BreakFilter: 断路输入滤波器,定义BRK 输入的采样频率和适用于 BRK的数字滤波器带宽。它设定BDTR寄存器BKF[3:0]位的值。

(8) Break2State: 断路2输入功能选择,可选使能或禁止。它设定BDTR寄存器BK2E位的值。

(9) Break2Polarity: 断路2输入通道BRK2极性选择,可选高电平有效或低电平有效。它设定BDTR寄存器BK2P位的值。

(10) Break2Filter: 断路2输入滤波器,定义BRK2 输入的采样频率和适用于 BRK2的数字滤波器带宽。它设定BDTR寄存器BK2F[3:0]位的值。

(11) AutomaticOutput: 自动输出使能,可选使能或禁止,它设定BDTR寄存器AOE位的值。

31.6. PWM互补输出实验

输出比较模式比较多,这里我们以PWM输出为例讲解,并通过示波器来观察波形。实验中不仅在主输出通道输出波形,还在互补通道输出与主通道互补的的波形,并且添加了断路和死区功能。

31.6.1. 硬件设计

根据开发板引脚使用情况,并且参考表 32‑1中定时器引脚信息,使用高级定时器TIM1的通道1及其互补通道作为本实验的波形输出通道, 对应选择PA8和PB13引脚。将示波器的两个输入通道分别与PA8和PB13引脚连接,用于观察波形,还有注意共地。 在MINI开发板里面,PA8通过一个上拉电阻接到了SD卡的片选,这样会影响输出的PWM波形,但是并不影响我们学习。

为增加断路功能,需要用到TIM1_BKIN引脚,这里选择PB12引脚。程序我们设置该引脚为高电平有效, 当BKIN引脚被置低电平的时候,两路互补的PWM输出就被停止,就好像是刹车一样。

31.6.2. 软件设计

这里只讲解核心的部分代码,有些变量的设置,头文件的包含等并没有涉及到,完整的代码请参考本章配套的工程。我们创建了两个文件:bsp_AdvanceTim.c和bsp_AdvanceTim.h文件用来存定时器驱动程序及相关宏定义。

31.6.2.1. 编程要点

  1. 定时器用到的GPIO 初始化

  2. 定时器时基结构体TIM_TimeBaseInitTypeDef初始化

  3. 定时器输出比较结构体TIM_OC_InitTypeDef初始化

  4. 定时器刹车和死区结构体TIM_BDTRInitTypeDef初始化

31.6.2.2. 软件分析

宏定义

代码清单:高级定时器-5 宏定义
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
/* 定时器 */
#define ADVANCED_TIMx                        TIM1
#define ADVANCED_TIM_RCC_CLK_ENABLE()        __HAL_RCC_TIM1_CLK_ENABLE(
                                    )
#define ADVANCED_TIM_RCC_CLK_DISABLE()
                                    __HAL_RCC_TIM1_CLK_DISABLE()
#define ADVANCED_TIM_GPIO_RCC_CLK_ENABLE()   {
                                        __HAL_RCC_GPIOA_CLK_ENABLE();
                                        __HAL_RCC_GPIOB_CLK_ENABLE();}

/* TIM8通道1输出引脚 */
#define ADVANCE_OCPWM_PIN               GPIO_PIN_8
#define ADVANCE_OCPWM_GPIO_PORT         GPIOA


/* TIM8通道1互补输出引脚 */
#define ADVANCE_OCNPWM_PIN                GPIO_PIN_13
#define ADVANCE_OCNPWM_GPIO_PORT          GPIOB

使用宏定义非常方便程序升级、移植。有关每个宏的具体含义看程序注释即可。

定时器复用功能引脚初始化

代码清单:高级定时器-6 定时器复用功能引脚初始化
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
void HAL_TIM_MspPostInit(TIM_HandleTypeDef* htim)
{
    GPIO_InitTypeDef GPIO_InitStruct;

    /* 定时器通道功能引脚端口时钟使能 */
    ADVANCED_TIM_GPIO_RCC_CLK_ENABLE();

    /* 定时器通道1功能引脚IO初始化 */
    GPIO_InitStruct.Pin =  ADVANCE_OCPWM_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
    HAL_GPIO_Init(ADVANCE_OCPWM_GPIO_PORT, &GPIO_InitStruct);
    /* 定时器通道1互补通道功能引脚IO初始化 */
    GPIO_InitStruct.Pin = ADVANCE_OCNPWM_PIN;
    HAL_GPIO_Init(ADVANCE_OCNPWM_GPIO_PORT, &GPIO_InitStruct);
}

HAL_TIM_MspPostInit ()函数初始化了定时器用到的相关的GPIO,当使用不同的GPIO的时候, 只需要修改头文件里面的宏定义即可,而不需要修改这个函数。

定时器模式配置

代码清单:高级定时器-7 定时器模式配置
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
void ADVANCE_TIM_Mode_Config(void)
{
    TIM_ClockConfigTypeDef Clock_Config;
    TIM_MasterConfigTypeDef Master_Config;
    TIM_BreakDeadTimeConfigTypeDef BreakDeadTime_Config;
    TIM_OC_InitTypeDef OC_Config;

    TIM_TimeBaseStructure.Instance = ADVANCED_TIMx;
    TIM_TimeBaseStructure.Init.Prescaler = ADVANCED_TIM_PRESCALER;
    TIM_TimeBaseStructure.Init.CounterMode = TIM_COUNTERMODE_UP;
    TIM_TimeBaseStructure.Init.Period = ADVANCED_TIM_PERIOD;
    TIM_TimeBaseStructure.Init.ClockDivision=TIM_CLOCKDIVISION_DIV1;
    TIM_TimeBaseStructure.Init.RepetitionCounter = ADVANCED_TIM_REPETIT
                                                IONCOUNTER;
    HAL_TIM_Base_Init(&TIM_TimeBaseStructure);

    Clock_Config.ClockSource = TIM_CLOCKSOURCE_INTERNAL;
    HAL_TIM_ConfigClockSource(&TIM_TimeBaseStructure, &Clock_Config);

    HAL_TIM_PWM_Init(&TIM_TimeBaseStructure);

    Master_Config.MasterOutputTrigger = TIM_TRGO_RESET;
    Master_Config.MasterSlaveMode = TIM_MASTERSLAVEMODE_DISABLE;
    HAL_TIMEx_MasterConfigSynchronization(&TIM_TimeBaseStructure,
                                        &Master_Config);

    BreakDeadTime_Config.OffStateRunMode = TIM_OSSR_DISABLE;
    BreakDeadTime_Config.OffStateIDLEMode = TIM_OSSI_DISABLE;
    BreakDeadTime_Config.LockLevel = TIM_LOCKLEVEL_OFF;
    BreakDeadTime_Config.DeadTime = 0;
    BreakDeadTime_Config.BreakState = TIM_BREAK_DISABLE;
    BreakDeadTime_Config.BreakPolarity = TIM_BREAKPOLARITY_HIGH;
    BreakDeadTime_Config.AutomaticOutput = TIM_AUTOMATICOUTPUT_DISABLE;
    HAL_TIMEx_ConfigBreakDeadTime(&TIM_TimeBaseStructure,
                                &BreakDeadTime_Config);

    OC_Config.OCMode = TIM_OCMODE_PWM1;
    OC_Config.Pulse = 900;
    OC_Config.OCPolarity = TIM_OCPOLARITY_HIGH;
    OC_Config.OCNPolarity = TIM_OCNPOLARITY_LOW;
    OC_Config.OCFastMode = TIM_OCFAST_DISABLE;
    OC_Config.OCIdleState = TIM_OCIDLESTATE_RESET;
    OC_Config.OCNIdleState = TIM_OCNIDLESTATE_RESET;

    HAL_TIM_PWM_ConfigChannel(&TIM_TimeBaseStructure, &OC_Config,
                            TIM_CHANNEL_1);
}

ADVANCE_TIM_Mode_Config()函数中初始化了三个结构体,有关这三个结构体成员的具体含义可参考“定时器初始化结构体详解”小节, 剩下的程序参考注释阅读即可。如果需要修改PWM的周期和占空比,修改头文件里面的ADVANCE_TIM_PERIOD、 ADVANCE_TIM_PSC和ADVANCE_TIM_PULSE这三个宏即可。 PWM信号的频率的计算公司为:F =TIM_CLK/{(ARR+1)*(PSC+1)}, 其中TIM_CLK等于72MHZ,ARR即自动重装载寄存器的值,对应ADVANCE_TIM_PERIOD这个宏,PSC即计数器时钟的分频因子,对应ADVANCE_TIM_PSC这个宏。

主函数

代码清单:高级定时器-8 main函数
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
int main(void)
{
    /* 初始化系统时钟为72MHz */
    SystemClock_Config();
    /* 初始化LED */
    DEBUG_USART_Config();

    printf("\r\nPWM波输出实验\r\n");

    ADVANCE_TIM_Mode_Config();
    /* 启动通道PWM输出 */
    HAL_TIM_PWM_Start(&TIM_TimeBaseStructure,TIM_CHANNEL_1);
    /* 启动定时器互补通道PWM输出 */
    HAL_TIMEx_PWMN_Start(&TIM_TimeBaseStructure,TIM_CHANNEL_1);
    /* 无限循环 */
    while (1) {
    }
}

Main函数很简单,调用了ADVANCE_TIM_Init()函数,该函数调用了ADVANCE_TIM_GPIO_Config()和ADVANCE_TIM_Mode_Config()这两个函数完成了定时器GPIO引脚和工作模式的初始化, 这时,相应的GPIO引脚上就可以检测到互补输出的PWM信号,而且带死区时间,如果程序运行的过程中, BKIN引脚被拉高的话,PWM输出会被禁止,就好像是断路或者刹车一样。

31.6.3. 下载验证

根据实验的硬件设计内容接好示波器输入通道和开发板引脚连接,,编译实验程序并下载到开发板上,调整示波器到合适参数, 在示波器显示屏和看到一路互补的带死区时间的PWM波形,参考图 PWM互补带死区时间波形输出。 至于图中的信号有毛刺是因为信号的输出引脚还接了其他的芯片,受到了影响。

PWM互补带死区时间波形输出

当BKIN引脚接高电平时,PWM输出被禁止,就好像是刹车一样, 具体见图 PWM刹车输出

PWM刹车输出

31.7. 脉宽测量输入捕获实验

上一节我们讲了输出比较,这一节我们讲输入捕获。输入捕获有常见的测量脉宽和特殊的PWM输入,这节我们先讲测量一个信号的脉宽,下一节再讲PWM输入。

31.7.1. 硬件设计

根据开发板引脚使用情况,我们选用通用定时器TIM5的CH1,就PA0这个GPIO来测量信号的脉宽。 在开发板中PA0接的是一个按键,默认接GND,当按键按下的时候IO口会被拉高, 这个时候我们可以利用定时器的输入捕获功能来测量按键按下的这段高电平的时间,按键的具体原理图见图 按键原理图

按键原理图

31.7.2. 软件设计

这里只讲解核心的部分代码,有些变量的设置,头文件的包含等并没有涉及到,完整的代码请参考本章配套的工程。 我们创建了两个文件:bsp_GeneralTim.c和bsp_GeneralTim.h文件用来存定时器驱动程序及相关宏定义。

31.7.2.1. 编程要点

  1. 定时器用到的GPIO初始化

  2. 定时器时基结构体TIM_TimeBaseInitTypeDef初始化

  3. 定时器输入捕获结构体TIM_ICInitTypeDef初始化

  4. 编写中断服务函数,读取捕获值,计算出脉宽的时间

31.7.2.2. 软件分析

宏定义

代码清单:高级定时器-9 宏定义
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
/************通用定时器TIM参数定义,只限TIM2、3、4、5***********/
// 当使用不同的定时器的时候,对应的GPIO是不一样的,这一点要注意
// 我们这里默认使用TIM5

#define GENERAL_TIMx                        TIM5
#define GENERAL_TIM_RCC_CLK_ENABLE()        __HAL_RCC_TIM5_CLK_ENABLE()
#define GENERAL_TIM_RCC_CLK_DISABLE()       __HAL_RCC_TIM5_CLK_DISABLE(
                                    )
#define GENERAL_TIM_GPIO_RCC_CLK_ENABLE()   __HAL_RCC_GPIOA_CLK_ENABLE(
                                        );
#define GENERAL_TIM_CHANNELx                TIM_CHANNEL_1
#define GENERAL_TIM_IT_CCx                  TIM_IT_CC1

#define GENERAL_TIM_IRQn                    TIM5_IRQn
#define GENERAL_TIM_IRQHANDLER              TIM5_IRQHandler

#define KEY1_RCC_CLK_ENABLE()               __HAL_RCC_GPIOA_CLK_ENABLE(
                            )
#define KEY1_GPIO_PIN                       GPIO_PIN_0
#define KEY1_GPIO                           GPIOA

//----------------------------------------------------------------
// 测量的起始边沿
#define            GENERAL_TIM_STRAT_ICPolarity
TIM_INPUTCHANNELPOLARITY_RISING
// 测量的结束边沿
#define            GENERAL_TIM_END_ICPolarity
TIM_INPUTCHANNELPOLARITY_FALLING

使用宏定义非常方便程序升级、移植。有关具体每个宏的含义看注释即可。

定时器复用功能引脚初始化

代码清单:高级定时器-10 定时器复用功能引脚初始化
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
void HAL_TIM_Base_MspInit(TIM_HandleTypeDef* htim_base)
{
    GPIO_InitTypeDef GPIO_InitStruct;

    /* 基本定时器外设时钟使能 */
    GENERAL_TIM_RCC_CLK_ENABLE();

    KEY1_RCC_CLK_ENABLE();

    GPIO_InitStruct.Pin = KEY1_GPIO_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
    GPIO_InitStruct.Pull = GPIO_PULLDOWN;
    HAL_GPIO_Init(KEY1_GPIO, &GPIO_InitStruct);

    /* 配置定时器中断优先级并使能 */
    HAL_NVIC_SetPriority(GENERAL_TIM_IRQn, 0, 0);
    HAL_NVIC_EnableIRQ(GENERAL_TIM_IRQn);

}

GENERAL_TIM_GPIO_Config()函数初始化了定时器用到的相关的GPIO,当使用不同的GPIO的时候, 只需要修改头文件里面的宏定义即可,而不需要修改这个函数。

定时器模式配置

代码清单:高级定时器-11 定时器模式配置
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
void GENERAL_TIM_Mode_Config(void)
{
    TIM_ClockConfigTypeDef CLKSource;
    TIM_MasterConfigTypeDef MasterConfig;
    TIM_IC_InitTypeDef ICConfig;

    TIM_TimeBase.Instance = GENERAL_TIMx;
    // 驱动CNT计数器的时钟 = Fck_int/(psc+1)
    TIM_TimeBase.Init.Prescaler = GENERAL_TIM_PRESCALER;
    // 计数器计数模式,设置为向上计数
    TIM_TimeBase.Init.CounterMode = TIM_COUNTERMODE_UP;
    // 自动重装载寄存器的值,累计TIM_Period+1个频率后产生一个更新或者中断
    TIM_TimeBase.Init.Period = GENERAL_TIM_PERIOD;
    // 时钟分频因子 ,配置死区时间时需要用到
    TIM_TimeBase.Init.ClockDivision=TIM_CLOCKDIVISION_DIV1;
    HAL_TIM_Base_Init(& TIM_TimeBase);

    CLKSource.ClockSource = TIM_CLOCKSOURCE_INTERNAL;
    HAL_TIM_ConfigClockSource(& TIM_TimeBase, &CLKSource);

    MasterConfig.MasterOutputTrigger = TIM_TRGO_RESET;
    MasterConfig.MasterSlaveMode = TIM_MASTERSLAVEMODE_DISABLE;
    HAL_TIMEx_MasterConfigSynchronization(& TIM_TimeBase,
                                        &MasterConfig);

    ICConfig.ICPolarity = GENERAL_TIM_STRAT_ICPolarity;
    ICConfig.ICSelection = TIM_ICSELECTION_DIRECTTI;
    ICConfig.ICPrescaler = TIM_ICPSC_DIV1;
    ICConfig.ICFilter = 0;

    HAL_TIM_IC_ConfigChannel(& TIM_TimeBase, &ICConfig,
                            GENERAL_TIM_CHANNELx);
}

ADVANCE_TIM_Mode_Config()函数中初始化了两个结构体,有关这两个结构体成员的具体含义可参考“定时器初始化结构体详解”小节,剩下的程序参考注释阅读即可。

在初始化时基结构体的周期和时钟分频因子这两个成员时,我们使用了两个宏GENERAL_TIM_PERIOD和GENERAL_TIM_PSC。GENERAL_TIM_PERIOD配置的是ARR寄存器的值,决定了计数器一个周期的计数时间,默认我们配置为0XFFFF,即最大。GENERAL_TIM_PSC配 置的是分频因子,默认配置为72-1,则可以计算出计数器的计数周期为(GENERAL_TIM_PSC+1)/72M = 1US。所以输入捕获能捕获的最小的时间为1us,最长的时间为1us*(0Xffff+1)=65536us=65.536ms,当超过这个计数周期的时候,就会产生中断,然后在中断里面做额外的处理,需要记录好产生了多少次更新中断,最后把这个更新时间加入到脉宽的时间里面。

主函数

代码清单:高级定时器-12 main函数
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
int main(void)
{
    uint32_t time,TIM_PscCLK;
    /* 初始化系统时钟为72MHz */
    SystemClock_Config();
    /* 初始化LED */
    LED_GPIO_Config();

    DEBUG_USART_Config();

    printf("\r\n按下KEY1,测试KEY1按下的时间\r\n");

    GENERAL_TIM_Mode_Config();
    // TIM 计数器的驱动时钟
    TIM_PscCLK= HAL_RCC_GetHCLKFreq()/GENERAL_TIM_PRESCALER;

    /* 启动定时器 */
    HAL_TIM_Base_Start_IT(&TIM_TimeBase);
    /* 启动定时器通道输入捕获并开启中断 */
    HAL_TIM_IC_Start_IT(&TIM_TimeBase,GENERAL_TIM_CHANNELx);

    while (1) {
        /* 完成测量高电平脉宽 */
        if (TIM_ICUserValueStructure.ucFinishFlag == 1 ) {
            /* 计算高电平计数值 */
            time = TIM_ICUserValueStructure .usPeriod *
                GENERAL_TIM_PERIOD + TIM_ICUserValueStructure .
                usCtr;
            /* 打印高电平脉宽时间 */
            printf ( "测得高电平脉宽时间:%d.%d s\n", time /
                    TIM_PscCLK, time % TIM_PscCLK );
            TIM_ICUserValueStructure .ucFinishFlag = 0;
        }
    }
}

主函数很简单,主要是一些初始化,然后在一个while循环中打印测量的脉宽时间。在计算的时候, 记得把周期GENERAL_TIMPERIOD和Capture_CcrValue的值都加1后再运算,因为计数器是从开始计数的。

31.7.3. 下载验证

把编译好的程序烧写进开发板,用USB线连接好电脑与开发板的USB转串口接口,按下K1按键, 电脑的串口调试助手就会打印出按键按下的时间,具体见图 测试按键按下的时间

测试按键按下的时间