通用定时器实验
  q; @, u+ Z$ _5 s0 }3 S1 L; G本章我们主要来学习通用定时器，上一章我们知道STM32H750有10个通用定时器（TIM2TIM5，TIM12 TIM17）。我们将通过四个实验来学习通用定时器的各个功能，分别是通用定时器中断实验、通用定时器PWM输出实验、通用定时器输入捕获实验和通用定时器脉冲计数实验。
$ W6 ~. [2 N( u, I" \$ W
  m& e, f+ U5 H. C: H2 n  o/ F21.1 通用定时器简介
STM32H750的通用定时器有10个之多，其基本特性也是不尽相同，为了更好的区别各个定时器的特性，我们列了一个表格，如下所示：

! j6 ^1 J& ]4 t( X* z' z6 s
# l9 n$ F5 `# ?. @$ t, t' @+ o
% [5 a" e2 M3 V& c" S! T4 \表21.1.1 定时器基本特性表
注：该表摘自《STM32H750VBT6.pdf》，原表在该文档的3.29小节（第39页）。
1 u- ~1 k0 k+ }" q/ Q4 E! h3 N( p由上表知道：除了TIM2和TIM5是32位的计数器，其他定时器是16位的。通用定时器和高级定时器其实也就是在基本定时器的基础上，添加了一些其他功能，如：输入捕获、输出比较、输出PWM和单脉冲模式等。而通用定时器数量较多，其特性也有一些的差异，但是基本原理都一样。
- i( ?4 I- p. L1 w4 y4 O通用定时器框图
1 Z9 p8 j4 Y+ ^+ ~6 x, a, B下面我们以TIM2/TIM3/TIM4/TIM5的框图为例来学习通用定时器框图，其他通用定时器的框图会有差异，因为内容比较多，大家学习了这里的框图再看ST官方手册其他的定时器框图就会比较容易理解。通过学习通用定时器框图会有一个很好的整体掌握，同时对之后的编程也会有一个清晰的思路。

: ]; z2 `: O, s+ w3 @
9 U2 T1 K& ~6 ^1 U2 W
图21.1.1 通用定时器框图
$ L6 P- t) m+ s8 r0 N如上图，通用定时器的框图比基本定时器的框图复杂许多，为了方便介绍，我们将其分成六个部分讲解：
①时钟源
通用定时器时钟可以选择下面四类时钟源之一：
+ x& m( |+ n9 Q1）内部时钟(CK_INT)
2）外部时钟模式1：外部输入引脚(TIx)，x=1，2（即只能来自于通道1或者通道2）
/ a9 J3 M* J2 ?' D3）外部时钟模式2：外部触发输入(ETR)
4）内部触发输入(ITRx)：使用一个定时器作为另一定时器的预分频器
7 F3 V, I8 b2 z* C: J' G" J3 w通用定时器时钟源的设置方法如下表所示：



表21.1.2 通用定时器时钟源设置方法
内部时钟（CK_INT）
6 Q3 }& y( k# j) H/ mSTM32H7系列的TIM2/TIM3/TIM4/TIM5/ TIM6/TIM7/ TIM12/ TIM13/ TIM14都是挂载在APB1总线上，这些定时器的内部时钟(CK_INT)实际上来自于APB1总线提供的时钟。但是这些定时器时钟不是由APB1总线直接提供，而是要先经过一个倍频器。在HAL库版本例程源码的sys.c文件中，系统时钟初始化函数sys_stm32_clock_init已经设置APB1总线时钟频率为120MHz，D2PPRE1预分频器的预分频系数为2，所以这些定时器时钟源频率为240MHz。因为在TIMPRE位默认设置为0的情况下，当APB1的D2PPRE1预分频器的预分频系数≥2分频时，挂载在APB1总线上的定时器时钟频率是该总线时钟频率的两倍。这个和基本定时器一样，可回顾基本定时器这部分内容。
APB2总线上挂载的通用定时器TIM15/TIM16/TIM17，以及高级定时器TIM1和 TIM8，它们的情况是上面的描述是一样的，不同点是：定时器挂载的总线变成了APB2，需要看的预分频器变成了D2PPRE2。在系统时钟初始化函数sys_stm32_clock_init已经设置APB2总线时钟频率为120MHz，D2PPRE2预分频器的预分频系数为2，所以上述的定时器时钟源频率为240MHz。具体可以参考《STM32H7xx参考手册_V3（中文版）.pdf》第290页，表47。
$ V$ L/ H7 ^# h1 Z. g+ B外部时钟模式1（TI1、TI2）
" N- ?% V2 O0 F# R5 @% s, m  J外部时钟模式1这类时钟源，顾名思义时钟信号来自芯片外部。时钟源进入定时器的流程如下：外部时钟源信号IOTIMx_CH1（或者TIMx_CH2），这里需要注意的是：外部时钟模式1下，时钟源信号只能从CH1或者CH2输入到定时器，CH3和CH4都是不可以的。从IO到TIMx_CH1（或者TIMx_CH2），就需要我们配置IO的复用功能，才能使IO和定时器通道相连通。
时钟源信号来到定时器CH1或CH2后，需要经过什么“关卡”才能到达计数器作为计数的时钟频率的，下面通过外部时钟模式1框图给大家解答。

* X" S% p+ [& l8 z" \; M* i0 z9 B

图21.1.2 外部时钟模式1框图
图21.1.2中是以CH2（通道2）为例的，时钟源信号到达CH2后，那么这里我们把这个时钟源信号用TI2表示，因为它只是个信号，来到定时器内部，那我们就按定时器内部的信号来命名，所谓入乡随俗。
! M, W! O: W1 E5 X  s7 ~0 u9 TTI2首先经过一个滤波器，由ICF[3:0]位来设置滤波方式，也可以设置不使用滤波器。
+ t9 W: ^6 ]7 n4 z! ?接着经过边沿检测器，由CC2P位来设置检测的边沿，可以上升沿或者下降沿检测。
然后经过触发输入选择器，由TS[4:0]位来选择TRGI（触发输入信号）的来源。可以看到图21.1.2中框出了TI1F_ED、TI1FP1和TI2FP2三个触发输入信号（TRGI）。TI1F_ED表示来自于CH1，并且没有经过边沿检测器过滤的信号，所以它是CH1的双边沿信号，即上升沿或者下降沿都是有效的。TI1FP1表示来自CH1并经过边沿检测器后的信号，可以是上升沿或者下降沿。TI2FP2表示来自CH2并经过边沿检测器后的信号，可以是上升沿或者下降沿。这里以CH2为例，那只能选择TI2FP2。如果是CH1为例，那就可以选择TI1F_ED或者TI1FP1。
: o8 Z: N9 T2 S- B  ?# R7 j最后经过从模式选择器，由ECE位和SMS[2:0]位来选择定时器的时钟源。这里我们介绍的是外部时钟模式1，所以ECE位置0，SMS[2:0] = 111即可。CK_PSC需要经过定时器的预分频器分频后，最终就能到达计数器进行计数了。
6 G( V* X! J5 Q( P/ M4 O! l. p外部时钟模式2（ETR）
0 \9 \2 m+ e( ]9 _6 O3 z; q- f% {8 D: E外部时钟模式2，顾名思义时钟信号来自芯片外部。时钟源进入定时器的流程如下：外部时钟源信号IOTIMx_ETR。从IO到TIMx_ETR，就需要我们配置IO的复用功能，才能使IO和定时器相连通。
时钟源信号来到定时器TIMx_ETR后，需要经过什么“关卡”才能到达计数器作为计数的时钟频率的，下面通过外部时钟模式2框图给大家解答。

' Y5 L9 H9 z5 j, D. n

图21.1.3 外部时钟模式2框图
图21.1.3中，首先配置TIMx_AF1寄存器中的ETRSEL[3:0]位选择正确的ETR源（内部或外部，这里我们选择外部IO作为时钟源，所以ETRSEL[3:0]位设置为0000即可）。注意：不是所有通用定时器都有这个寄存器的，这个需要查看参考手册。因为外部时钟模式2的时钟信号是来自IO外部的，ETRSEL[3:0]位默认就是0000，所以我们可以直接不用设置这个寄存器。
+ J3 t6 I' x% Z' A接着经过外部触发极性选择器，由ETP位来设置上升沿有效还是下降沿有效，选择下降沿有效的话，信号会经过反相器。
, \( _% J  m+ |5 Z然后经过外部触发预分频器，由ETPS[1:0]位来设置预分频系数，系数范围：1、2、4、8。
紧接着经过滤波器器，由ETF[3:0]位来设置滤波方式，也可以设置不使用滤波器。fDTS由TIMx_CR1寄存器的CKD位设置。
1 j0 Y6 }  I9 W  P: j最后经过从模式选择器，由ECE位和SMS[2:0]位来选择定时器的时钟源。这里我们介绍的是外部时钟模式2，直接把ECE位置1即可。CK_PSC需要经过定时器的预分频器分频后，最终就能到达计数器进行计数了。
内部触发输入（ITRx）
/ ~5 s1 s- M/ }! E9 d0 u2 p) {内部触发输入是使用一个定时器作为另一个定时器的预分频器，即实现定时器的级联。下面以TIM3作为TIM2的预分频器为例，给大家介绍。


. h, ]; w+ U) `  {
图21.1.4 TIM3作为TIM2的预分频器框图
  O7 b8 _1 M$ t上图中，TIM3作为TIM2的预分频器，需要完成的配置步骤如下：
1，TIM3_CR2寄存器的MMS[2:0]位设置为010，即TIM3的主模式选择为更新（选择更新事件作为触发输出 （TRGO））。
6 h6 q! O5 z8 l$ ?6 o. k. H8 i2，TIM2_SMCR寄存器的TS[4:0]位设置为00010，即使用ITR2作为内部触发。TS[4:0]位用于配置触发选择，除了ITR2，还有其他的选择，详细描述如下图所示：
3 N( m) H' y9 T% I


图21.1.5触发选择
' C& M7 a  D2 r上图中的触发选择中，我们在讲解外部时钟模式1的时候说过TI1F_ED、TI1FP1和TI2FP2，以及外部时钟模式2讲的ETRF，它们都是属于外部的，其余的都是内部触发了。那么这内部触发都代表什么意思呢？大家打开《STM32H7xx参考手册_V3（中文版）.pdf》的1538页，就可以找下面这个表。
  W6 t& D5 q$ R$ f, u+ ^* u


表21.1.3 TIMx内部触发连接
# @+ k+ Y/ l& t% Y4 ^0 q在步骤2中，TS[4:0]位设置为00010，使用ITR2作为内部触发，这个ITR2什么意思？由表21.1.3可以知道，当从模式定时器为TIM2时，ITR2表示主模式定时器就是TIM3。这里只是TIM2~5的内部触发连接情况，其他定时器请查看参考手册的相应章节。
& w% v; W# d* c% O' ]5 c3，TIM2_SMCR寄存器的SMS[2:0]位设置为111，即从模式控制器选择外部时钟模式1。
4，TIM3和TIM2的CEN位都要置1，即启动计数器。
+ o* h( Z! ~! g4 X' L5 T. l定时器的时钟源这部分内容是非常重要的，因为这计数器工作的基础。虽然定时器有四类时钟源之多，但是我们最常用的还是内部时钟。
* C1 }: B7 h, Z1 v②控制器
控制器包括：从模式控制器、编码器接口和触发控制器（TRGO）。从模式控制器可以控制计数器复位、启动、递增/递减、计数。编码器接口针对编码器计数。触发控制器用来提供触发信号给别的外设，比如为其它定时器提供时钟或者为DAC/ADC的触发转换提供信号。
③时基单元
时基单元包括：计数器寄存器(TIMx_CNT)、预分频器寄存器(TIMx_PSC)、自动重载寄存器(TIMx_ARR)。这部分内容和基本定时器基本一样的，大家可以参考基本定时器的介绍。
不同点是：通用定时器的计数模式有三种：递增计数模式、递减计数模式和中心对齐模式；TIM2 和TIM5的计数器是32位的。递增计数模式在讲解基本定时器的时候已经讲过了，那么对应到递减计数模式就很好理解了。就是来了一个计数脉冲，计数器就减1，直到计数器寄存器的值减到0，减到0时定时器溢出，由于是递减计数，故而称为定时器下溢，定时器溢出就会伴随着更新事件的发生。然后计数器又从自动重载寄存器影子寄存器的值开始继续递减计数，如此循环。最后是中心对齐模式，字面上不太好理解。该模式下，计数器先从0开始递增计数，直到计数器的值等于自动重载寄存器影子寄存器的值减1时，定时器上溢，同时生成更新事件，然后从自动重载寄存器影子寄存器的值开始递减计算，直到计数值等于1时，定时器下溢，同时生成更新事件，然后又从0开始递增计数，依此循环。每次定时器上溢或下溢都会生成更新事件。计数器的计数模式的设置请参考TIMx_CR1寄存器的位CMS和位DIR。
下面通过一张图给大家展示定时器工作在不同计数模式下，更新事件发生的情况。


" j7 o  p  z% o! U4 w
图21.1.6 更新事件发生条件
上图中，纵轴表示计数器的计数值，横轴表示时间，ARR表示自动重载寄存器的值，小红点就是更新事件发生的时间点。举个例子，递增计数模式下，当计数值等于ARR时，计数器的值被复位为0，定时器溢出，并伴随着更新事件的发生，后面继续递增计数。递减计数模式和中心对齐模式请参考前面的描述。
* H, M- ?7 ^# W上表的描述属于硬件更新事件发生条件，我们还可以通过UG位产生软件更新事件。
7 [$ R8 _# d7 m关于影子寄存器和定时器溢出时间计算公式等内容可以参考基本定时器的相关内容。
, ~7 z/ `" V6 ]' z+ B9 q7 C( x9 b④输入捕获
2 y9 T  S9 T- P: ~0 c图21.1.1.1中的第④部分是输入捕获，一般应用是要和第⑤部分一起完成测量功能。TIMx_CH1~ TIMx_CH4表示定时器的4个通道，这4个通道都是可以独立工作的。IO端口通过复用功能与这些通道相连。配置好IO端口的复用功能后，将需要测量的信号输入到相应的IO端口，输入捕获部分可以对输入的信号的上升沿，下降沿或者双边沿进行捕获，常见的测量有：测量输入信号的脉冲宽度、测量 PWM 输入信号的频率和占空比等。后续有相应的实验。
下面简单说一下测量高电平脉冲宽度的工作原理，方便大家的理解：一般先要设置输入捕获的边沿检测极性，如：我们设置上升沿检测，那么当检测到上升沿时，定时器会把计数器CNT的值锁存到相应的捕获/比较寄存器TIMx_CCRy里，y=1~4。然后我们再设置边沿检测为下降沿检测，当检测到下降沿时，定时器会把计数器CNT的值再次锁存到相应的捕获/比较寄存器TIMx_CCRy里。最后，我们将前后两次锁存的CNT的值相减，就可以算出高电平脉冲期间内计数器的计数个数，再根据定时器的计数频率就可以计算出这个高电平脉冲的时间。如果要测量的高电平脉宽时间长度超过定时器的溢出时间周期，就会发生溢出，这时候我们还需要做定时器溢出的额外处理。低电平脉冲捕获同理。
( F: _% J4 S( L4 L9 ]上面的描述是第④部分输入捕获整体上的一个应用情况，下面我们来看第④部分的细节。当需要测量的信号进入通道后，需要经过哪些“关卡”？我们用图21.1.7给大家讲解。
4 e5 e8 T$ c& O
1 W# d2 U- K1 H$ L
! T: R! F& x4 \0 y3 K
& ?' c" D% n6 y0 ~% m, g图21.1.7 通道1输入阶段
图21.1.7是图21.1.1第④部分通道1的“放大版”，这里是以通道1输入捕获为例进行介绍，其他通道同理。
9 ]9 F9 M1 m: c! I& x待测量信号到达TIMx_CH1后，那么这里我们把这个待测量信号用TI1表示，原因在讲解外部时钟模式1的时候说过，所谓“入乡随俗”。
& R$ G6 d: P$ W7 t  [& MTI1首先经过一个滤波器，由ICF[3:0]位来设置滤波方式，也可以设置不使用滤波器。fDTS由TIMx_CR1寄存器的CKD位设置。
接着经过边沿检测器，由CC1P位来设置检测的边沿，可以上升沿或者下降沿检测。CC1NP是配置互补通道的边沿检测的，在高级定时器才有，通用定时器没有。
8 K5 o0 X  ~2 n, D3 V, A+ ~然后经过输入捕获映射选择器，由CC1S[1:0]位来选择把IC1映射到TI1、TI2还是TRC。这里我们的待测量信号从通道1进来，所以选择IC1映射到TI1上即可。
紧接着经过输入捕获1预分频器，由ICPS[1:0]位来设置预分频系数，范围：1、2、4、8。
最后需要把CC1E位置1，使能输入捕获，IC1PS就是分频后的捕获信号。这个信号将会到达图21.1.1的第⑤部分。
  y0 V1 z, _8 x3 H5 w) X下面我们接着看图21.1.1的第⑤部分的“放大版”，如下图所示：
$ _( U4 N  S/ F% }1 d; l" h


图21.1.8 捕获/比较通道1主电路（输入捕获功能部分）
7 @4 l' ]2 g( o$ O! Z图21.1.8中，灰色阴影部分是输出比较功能部分，讲到第⑥部分输出比较的时候再介绍。左边没有阴影部分就是输入捕获功能部分了。
首先看到捕获/比较预装载寄存器，我们以通道1为例，那么它就是CCR1寄存器，通道2、通道3、通道4就分别对应CCR2、CCR3、CCR4。在图21.1.1中就可以看到CCR1~4是有影子寄存器的，所以这里就可以看到图21.1.8中有捕获/比较影子寄存器，该寄存器不可直接访问。
  B* x& n3 S: p图21.1.8左下角的CC1G位可以产生软件捕获事件，那么硬件捕获事件如何产生的？这里我们还是以通道1输入为例，CC1S[1:0] = 01，即IC1映射到TI1上；CC1E位置1，使能输入捕获；比如不滤波、不分频，ICF[3:0] = 00，ICPS[1:0] = 00；比如检测上升沿，CC1P位置0；接着就是等待测量信号的上升沿到来。当上升沿到来时，IC1PS信号就会触发输入捕获事件发生，计数器的值就会被锁存到捕获/比较影子寄存器里。当CCR1寄存器没有被进行读操作的时候，捕获/比较影子寄存器里的值就会锁存到CCR1寄存器中，那么程序员就可以读取CCR1寄存器，得到计数器的计数值。检测下降沿同理。
; ]5 d& c# l% t* `5 @. N) E7 N3 ]⑤输入捕获和输出比较公用部分
该部分需要结合第④部分或者第⑥部分共同完成相应功能。
⑥输出比较
图21.1.1.1中的第⑥部分是输出比较，一般应用是要和第⑤部分一起完成定时器输出功能。TIMx_CH1~ TIMx_CH4表示定时器的4个通道，这4个通道都是可以独立工作的。IO端口通过复用功能与这些通道相连。
下面我们按照输出信号产生过程顺序给大家介绍定时器如何实现输出功能的？首先看到第⑤部分的“放大版”图，如下图所示：


7 _- j- u- X& S3 d9 e9 `3 ~- k7 b
  D* I# A3 B3 _) z! S* V$ i图21.1.9 捕获/比较通道1主电路（输出比较功能部分）
/ y( Y; ~8 O3 z+ j图21.1.9中，灰色阴影部分是输入捕获功能部分，前面已经讲过。这里我们看到右边没有阴影部分就是输出比较功能部分了。下面以通道1输出比较功能为例给大家介绍定时器如何实现输出功能的。
8 P* A1 _. K) B! T+ V* r首先程序员写CCR1寄存器，即写入比较值。这个比较值需要转移到对应的捕获/比较影子寄存器后才会真正生效。什么条件下才能转移？图21.1.9中可以看到compare_transfer旁边的与门，需要满足三个条件：CCR1不在写入操作期间、CC1S[1:0] = 0配置为输出、OC1PE位置0（或者OC1PE位置1，并且需要发生更新事件，这个更新事件可以软件产生或者硬件产生）。
- l% v9 G, [7 F: h当CCR1寄存器的值转移到其影子寄存器后，新的值就会和计数器的值进行比较，它们的比较结果将会通过第⑥部分影响定时器的输出。
  D' \8 y) I  W! t: `下面来看看第⑥部分通道1的“放大版”，如下图所示：


( G$ S$ U) ^# W" F; c2 V' Q
% G3 i# e9 Q$ [# p! F6 C图21.1.10 通道1输出阶段
上图中，可以看到输出模式控制器，由OC1M[3:0]位配置输出比较模式，该位的描述请参考《STM32H7xx参考手册_V3（中文版）.pdf》相关定时器章节的TIMx_CCMR1寄存器。H7系列有14种输出比较模式之多，后面用到再来介绍。
oc1ref是输出参考信号，高电平有效，为高电平时称之为有效电平，为低电平时称之为无效电平。它的高低电平受到三个方面的影响：OC1M[3:0]位配置的输出比较模式、第⑤部分比较器的比较结果、还有就是OC1CE位配置的ETRF信号。ETRF信号可以将Oc1ref电平强制清零，该信号来自IO外部。
, l6 q$ |0 P% H一般来说，当计数器的值和捕获/比较寄存器的值相等时，输出参考信号oc1ref的极性就会根据我们选择的输出比较模式而改变。如果开启了比较中断，还会发生比较中断。
CC1P位用于选择通道输出极性。
CC1E位置1使能通道输出。
) r, B& v" n* w) T: tOC1信号就会从TIMx_CH1输出到IO端口，再到IO外部。
下面分别通过四个实验来学习通用定时器的功能。
21.2 通用定时器中断实验
+ e: D9 ?! F4 i2 P3 {本小节我们来学习通用定时器中断实验，以定时器3中断为例，首先来了解相关的寄存器。
, t8 N9 J0 I9 ]3 e  P3 `1 x4 X21.2.1 TIM2/TIM3/TIM4/TIM5寄存器
下面介绍TIM2/TIM3/TIM4/TIM5的几个与定时器中断相关且重要的寄存器，其他的通用定时器的寄存器会有一些差异，请大家自行对比《STM32H7xx参考手册_V3（中文版）.pdf》相关章节。下面先来看TIMx_CR1寄存器的一些位描述，具体如下：
/ a+ s* v( _0 t, S4 J  E控制寄存器 1（TIMx_CR1）
TIM2/TIM3/TIM4/TIM5的控制寄存器1描述如图21.2.1.1所示：
2 r. [  v) v  c1 S9 Q& |
3 a3 L6 _3 n9 U9 W# ~9 m
, H$ V, H9 a+ S# g  s
- c1 ~+ y6 F. C3 i+ m+ ~2 N7 ]% m( V# p图21.2.1.1 TIMx_CR1寄存器
上图中我们只列出了本实验需要用的一些位，其中：位7（APRE）用于控制自动重载寄存器是否进行缓冲，如果ARPE位置1，ARR起缓冲作用，即只有在更新事件发生时才会把ARR的值写入其影子寄存器里；如果ARPE位置0，那么修改自动重载寄存器的值时，该值会马上被写入其影子寄存器中，从而立即生效。
CMS[1:0]位，用于设置边沿对齐模式还是中心对齐模式，本实验我们使用边沿对齐模式，所以设置为00即可。
( @6 q# ?* C7 i0 w# MDIR位，用于控制定时器的计数方向，我们使用递增计数模式，所以设置DIR位为0。
  m0 E+ l. N: i3 W& L- k; }9 h  UCEN位，用于使能计数器的工作，必须要设置该位为1，计数器才会开始计数。
! l4 l( P' p3 I$ i从模式控制寄存器（TIMx_SMCR）
2 @: h+ O7 Z6 e  VTIM2/TIM3/TIM4/TIM5的从模式控制寄存器描述如图21.2.1.2所示：
% q6 }' K4 v3 G$ P/ E


图21.2.1.2 TIMx_SMCR寄存器
该寄存器的SMS[3:0]位，用于从模式选择，其实就是选择计数器输入时钟的来源。比如通用定时器中断实验我们设置SMS[3:0]=0000，禁止从模式，这样PSC预分频器的时钟就直接来自内部时钟（CK_INT），按照我们例程sys_stm32_clock_init函数的配置，频率为240MHz（APB1总线时钟频率的2倍）。
TIMx DMA/中断使能寄存器 (TIMx_DIER)
TIM2/TIM3/TIM4/TIM5的DMA/中断使能寄存器描述如图21.2.1.3所示：
( i; Z2 y5 s% C5 f( `
" @# E2 `" e. P9 i

图21.2.1.3 TIMx_DIER寄存器
0 F7 X# `4 m" k3 e3 p该寄存器用于使能/失能触发DMA请求、捕获/比较中断以及更新中断。本实验只用到更新中断，所以把位0（UIE）置1即可。
5 x  l0 Q9 r4 ~" J$ U状态寄存器（TIMx_SR）
TIM2/TIM3/TIM4/TIM5的状态寄存器描述如图21.2.1.4所示：

7 v% Z: S1 Z- [; b% g; s8 c

图21.2.1.4 TIMx_SR寄存器
% @9 S$ D% |, G& ~该寄存器都是一些中断标志位，比如更新中断标志位、捕获/比较中断标志位等。在通用定时器中断实验我们用到更新中断标志位，当定时器更新中断到来后，位0（UIF）会由硬件置1，我们需要在中断服务函数里面把该位清零。
计数器寄存器（TIMx_CNT）
5 w( k2 b" h( }0 ~TIM2/TIM3/TIM4/TIM5的计数器寄存器描述如图21.2.1.5所示：


+ p/ h% p" G4 B- }
图21.2.1.5 TIMx_CNT寄存器
% H* V5 Y4 k5 l, K! t. X因为定时器2和定时器5的计数器是32位的，所以当用到这两个定时器的时候，TIMx_CNT寄存器的32位都是用做计数器寄存器，其他定时器的就跟基本定时器一样，低16位有效。可以直接写该寄存器设置计数的初始值，也可以读取该寄存器获取计数器值。
% U# T* }  }  o, M' V预分频寄存器（TIMx_PSC）
8 {7 x) G/ ]6 p7 C. K; G5 P定时器的预分频寄存器都是16位的，即写入该寄存器的数值范围是0到65535，表示1到65536分频。比如我们要24000分频，就往该寄存器写入23999。
: [# F+ }0 T0 L自动重载寄存器（TIMx_ARR）
TIM2/TIM3/TIM4/TIM5的自动重载寄存器描述如图21.2.1.6所示：
* ?* W. N9 Q) }# N


图21.2.1.6 TIMx_ARR寄存器
在H7系列中，TIM2和TIM5的自动重载寄存器是32位的，其他定时器的自动重载寄存器是低16位有效。该寄存器可以由APRE位设置是否进行缓冲。计数器的值会和自动重装寄存器影子寄存器进行比较，当两者相等，定时器就会溢出，从而发生更新事件，如果打开了更新中断，还会发生更新中断。

) d0 r- d2 \- s21.2.2 硬件设计
' L- x0 Y* g# T! x" O+ E/ R3 |5 h+ O1.例程功能
LED0用来指示程序正在运行，200ms翻转一次。LED1在定时器中断中翻转，500ms进入中断一次。
2.硬件资源
1）RGB灯
9 ]% g4 a, T+ K: T, kRED ：LED0 - PB4
1 m/ T) W; ^7 s" o- J4 j1 hGREEN ：LED1 - PE6
2）定时器3
3.原理图
定时器属于STM32H750的内部资源，只需要软件设置好即可正常工作。我们通过LED1来指示STM32H750的定时器进入中断的频率，LED0则指示程序的运行状态。

21.2.3 程序设计
, S  d* l3 f' q本实验的相关HAL库驱动以及实验配置步骤请参考基本定时器相关内容，基本一样。不同点是基本定时器只能是递增计数模式，通用定时器可以递增计数模式、递减计数模式和中心对齐模式。
8 T! H7 D" Y+ l& s6 Z
/ L  E8 f' L2 A. M6 O# a- i+ ]21.2.3.1 程序流程图
) c  C4 n+ x. k! }1 D$ a6 T下面看看本实验的程序流程图，main函数中并没有对LED1的操作，我们把对LED1的操作放到定时器的中断中进行处理：


4 `2 J, v( @$ s2 \1 `* B
" u+ P& ]% K9 [- H4 O2 T9 q图21.2.3.1.1 通用定时器中断实验程序流程图
0 }8 ~& C$ r: l7 N4 N, Q
$ V! R; |0 t8 N" C1 D7 |21.2.3.2 程序解析
这里我们只讲解核心代码，详细的源码请大家参考光盘本实验对应源码。通用定时器驱动源码包括两个文件：gtim.c和gtim.h。
首先看gtim.h头文件的几个宏定义：

- S& M( [% Q: e1 F& B- h

1. /*****************************************************************************/
   ) \6 n. B& F! F+ k$ C
2. /* TIMX 中断定义
   
3. * 默认是针对TIM2~TIM5, TIM12~TIM17.
   
4. * 注意: 通过修改这4个宏定义,可以支持TIM1~TIM17任意一个定时器.
   
5. */
   7 ]$ U8 {' W2 p9 e6 l/ j6 l' \
6. 
   
7. #define GTIM_TIMX_INT                   TIM3
   
8. #define GTIM_TIMX_INT_IRQn             TIM3_IRQn
   3 t% t; y- W& p/ C& c/ t
9. #define GTIM_TIMX_INT_IRQHandler      TIM3_IRQHandler
   9 D1 e$ o! c4 w, q. C
10. /* TIM3 时钟使能 */
    
11. #define GTIM_TIMX_INT_CLK_ENABLE()    do{ __HAL_RCC_TIM3_CLK_ENABLE(); }while(0)  
    $ Y9 o4 G, w1 ]; s
12. /*****************************************************************************/
    # f7 x, e' l9 n/ ~  f
13. 通过修改这4个宏定义，可以支持TIM1~TIM17任意一个定时器。
    3 {) A7 B: j' V9 b& \! v
14. 下面再来看一下gtim.c文件的代码，主要包括两个函数，先来看看通用定时器的初始化函数，其定义如下：
    $ Q/ R7 q6 r* x$ Q
15. /**
    
16. * @brief      通用定时器TIMX定时中断初始化函数
    
17. * @note
    
18. *              通用定时器的时钟来自APB1,当D2PPRE1≥2分频的时候
    
19. *              通用定时器的时钟为APB1时钟的2倍, 而APB1为120M, 所以定时器时钟 = 240Mhz
    5 e3 D% {7 d! g2 x
20. *              定时器溢出时间计算方法: Tout = ((arr + 1) * (psc + 1)) / Ft us.
    8 O/ k+ {) t7 H, N- E' k
21. *              Ft=定时器工作频率,单位:Mhz
    + ^$ U) t6 n% S5 Y/ J
22. * @param       arr: 自动重装值。
    4 x& f# ~9 O4 l; L3 p( G
23. * @param       psc: 时钟预分频数
    " n& p4 i- e! f( j
24. * @retval      无
    
25. */
    ; b9 G9 m9 E! q' f
26. void gtim_timx_int_init(uint16_t arr, uint16_t psc)
    : d  ?/ l& ], ]' M
27. {
    
28.     GTIM_TIMX_INT_CLK_ENABLE();                               /* 使能TIMx时钟 */
    ' _( [  r: o* t0 M
29. 
    
30.     g_timx_handle.Instance = GTIM_TIMX_INT;                 /* 通用定时器x */
    
31.     g_timx_handle.Init.Prescaler = psc;                      /* 预分频系数 */
    
32.     g_timx_handle.Init.CounterMode = TIM_COUNTERMODE_UP; /* 递增计数模式 */
    & _: M% j8 Z; m! p7 H' E" J3 _  f  C
33.     g_timx_handle.Init.Period = arr;                         /* 自动装载值 */
    + b3 b/ g" V; ]( R. w
34. HAL_TIM_Base_Init(&g_timx_handle);
    
35. 
    
36. /* 设置中断优先级，抢占优先级1，子优先级3 */
    
37.     HAL_NVIC_SetPriority(GTIM_TIMX_INT_IRQn, 1, 3);  
    
38.     HAL_NVIC_EnableIRQ(GTIM_TIMX_INT_IRQn);   /* 开启ITMx中断 */
    
39. 
    
40.     HAL_TIM_Base_Start_IT(&g_timx_handle);    /* 使能定时器x和定时器x更新中断 */
    
41. }

复制代码

- i( {5 F, }1 {这里配置的参数和基本定时器中断实验的是一样的，只是这里没有使用到HAL库的HAL_TIM_Base_MspInit函数来存放NVIC和使能时钟的代码，而是全部存放到gtim_timx_int_init函数里。在一个项目中，用到多个定时器时，建议大家使用这种方式来处理代码，这样方便代码的管理。
下面再来看看定时器中断服务函数，其定义如下：

1. /**
   0 h7 B5 n; f3 d0 y2 m
2. * @brief       定时器中断服务函数
   6 U) [! g6 s  m3 U
3. * @param       无
   & M# g+ t0 i  y4 v3 H7 I3 p
4. * @retval      无
   
5. */
   
6. void GTIM_TIMX_INT_IRQHandler(void)
   8 A+ K& i8 z$ K
7. {
   
8.     /* 以下代码没有使用定时器HAL库共用处理函数来处理，而是直接通过判断中断标志位的方式 */
   
9.     if(__HAL_TIM_GET_FLAG(&g_timx_handle, TIM_FLAG_UPDATE) != RESET)
   . G0 k6 U/ s$ p4 E4 f
10.     {
    + Y8 M- x/ i7 t9 c4 S2 |# R3 d: ^
11.         LED1_TOGGLE();
    ) w+ W* L+ {. b; H, D
12. /* 清除定时器溢出中断标志位 */
    ! i3 z1 N4 u/ ]5 O& x4 p
13.         __HAL_TIM_CLEAR_IT(&g_timx_handle, TIM_IT_UPDATE);
    ' O' N4 _# U( h  B$ w( h
14.     }
    
15. }

复制代码

$ R6 s' g5 [5 e* j& w1 K可以看到，这里我们没有使用HAL库的定时器公共处理函数来处理中断部分的代码，而是通过自行判断中断标志位的方式来处理。只不过获取标志位的方式还是使用HAL库的函数宏__HAL_TIM_GET_FLAG()，大家也可以直接使用寄存器的方式来操作。
通过__HAL_TIM_GET_FLAG()获取中断标志位并判断是否了中断，然后处理中断程序，最后通过__HAL_TIM_CLEAR_IT()将中断标志位清零，这样就完成了一次对中断的处理。这样的方式来处理中断，也是大家学习HAL库需要掌握的。在一个项目中，用到多个定时器相关中断时，建议大家使用这种方式来处理代码，这样方便代码的管理。
( |* ~7 E, }; [; C
21.2.4 下载验证
下载代码后，可以看到LED0不停闪烁（每400ms一个周期），而LED1也是不停的闪烁，但是闪烁时间较LED0慢（每1s一个周期）。
; D' }  j9 `8 M! c
21.3 通用定时器PWM输出实验
本小节我们来学习使用通用定时器的PWM输出模式。
" |  t7 Z5 V6 R6 |脉冲宽度调制(PWM)，是英文“Pulse Width Modulation”的缩写，简称脉宽调制，是利用微处理器的数字输出来对模拟电路进行控制的一种非常有效的技术。我们可以让定时器产生PWM，在计数器频率固定时，PWM频率或者周期由自动重载寄存器（TIMx_ARR）的值决定，其占空比由捕获/比较寄存器（TIMx_CCRx）的值决定。PWM产生原理示意图如下图所示：
4 w- ]4 \& M6 ~) G
7 @  r1 ]; T7 P2 o8 f
5 ^$ b. ]9 O" B- a+ y2 [
0 S7 E' ]1 i, b! ]% N图21.3.1 PWM生成示意图
) L3 p1 s) \+ @! R8 {上图中，定时器工作在递增计数模式，纵轴是计数器的计数值CNT，横轴表示时。当CNT<CCRx时，IO输出低电平（逻辑0）；当CNT>=CCRx时，IO输出高电平（逻辑1）；当CNT=ARR时，定时器溢出，CNT的值被清零，然后继续递增，依次循环。在这个循环中，改变CCRx的值，就可以改变PWM的占空比，改变ARR的值，就可以改变PWM的频率，这就是PWM输出的原理。
* h% X* m* Z$ f5 q; {6 B定时器产生PWM的方式有许多种，下面我们以边沿对齐模式（即递增计数模式/递减计数模式）为例，PWM模式1或者PWM模式2产生PWM的示意图，如下图所示：
: z5 R# O: J% c# z5 z1 l6 X


; Y5 x; N8 O* u5 ~3 R/ R! B图21.3.2 产生PWM示意图
* J$ _$ H1 V) j4 b+ P$ f( X1 N. \STM32H750的定时器除了TIM6和TIM7外，其他的定时器都可以产生PWM输出。其中高级定时器TIM1和TIM8可以同时产生多达7路的PWM输出。而通用定时器也能同时产生多达4路的PWM输出！本实验我们以TIM3的CH1产生一路PWM输出为例进行学习。

$ Z# x" ?. b" `. v/ D* D21.3.1 TIM2/TIM3/TIM4/TIM5寄存器
要使STM32H750的通用定时器TIMx产生PWM输出，除了上一小节介绍的寄存器外，我们还会用到另外3个寄存器，来控制PWM输出。这三个寄存器分别是：捕获/比较模式寄存器（TIMx_CCMR1/2）、捕获/比较使能寄存器（TIMx_CCER）、捕获/比较寄存器（TIMx_CCR1~4）。接下来我们简单介绍一下这三个寄存器。
+ j+ h- a' Z$ Z  b' J- T捕获/比较模式寄存器1/2（TIMx_CCMR1/2）
. t# |6 ?. P9 ^% N8 N! L5 l. v8 M- DTIM2/TIM3/TIM4/TIM5的捕获/比较模式寄存器（TIMx_CCMR1/2），该寄存器一般有2个：TIMx _CCMR1和TIMx _CCMR2。TIMx_CCMR1控制CH1和CH2，而TIMx_CCMR2控制CH3和CH4。TIMx_CCMR1寄存器描述如图21.3.1.1所示：
0 [, W+ V. Y: U6 C+ m) X% k9 B

5 M, i6 }. b, D) \( |# O图21.3.1.1 TIMx_CCMR1寄存器
8 ?/ H& f* G. G该寄存器的有些位在不同模式下，功能不一样，我们现在用到输出比较，先看输出比较部分，输入捕获在后面的实验再讲解。关于该寄存器的详细说明，请参考《STM32H7xx参考手册_V3（中文版）.pdf》第1542页，39.4.7节。比如我们要让TIM3的CH1输出PWM波，该寄存器的模式设置位OC1M[3:0]就是对应着通道1的模式设置。总共可以配置14种模式，我们使用的是PWM模式1或者PWM模式2，所以位OC1M[3:0]设置为0110或者0111。这两种PWM模式的区别就是输出有效电平的极性相反。位 OC1PE控制输出比较通道1的预装载使能，实际就是控制CCR1寄存器是否进行缓冲。因为CCR1寄存器也是有影子寄存器的，影子寄存器才是真正起作用的寄存器。CC1S[1:0]用于设置通道1的方向（输入/输出）默认设置为0，就是设置通道作为输出使用。
 捕获/比较使能寄存器（TIMx_ CCER）
- z" U( a- R* C# w4 L$ iTIM2/TIM3/TIM4/TIM5的捕获/比较使能寄存器，该寄存器控制着各个输入输出通道的开关和极性。TIMx_CCER寄存器描述如图21.3.1.2所示：

" [3 q3 `. N5 G# u6 K
; ~# y  p, q. Z6 Q2 R7 @/ k, Q
" j! Z  k( F( i# Y5 B图21.3.1.2 TIMx_CCER寄存器
2 @! k; z6 \% [) s+ x0 w该寄存器比较简单，要让TIM3的CH1输出PWM波，这里我们要使能CC1E位，该位是通道1输入/输出使能位，要想PWM从IO口输出，这个位必须设置为1。CC1P位是设置通道1的输出极性，我们默认设置0。
( b& y- y; t6 k0 \/ n捕获/比较寄存器1/2/3/4（TIMx_ CCR1/2/3/4）
& O6 @7 H$ ], h, Q" Z# E捕获/比较寄存器（TIMx_ CCR1/2/3/4），该寄存器总共有4个，分别对应4个通道CH1~CH4。我们使用的是通道1，所以来看看TIMx_ CCR1寄存器描述，如图21.3.1.3所示：
, ~2 X% k( `* I9 h- ^
# j1 ~; c) O( y+ g7 t9 z$ a
# ~8 R/ m7 b2 K0 D3 `2 l
图21.3.1.3 TIMx_ CCR1寄存器
/ H* s: f% W) L6 N, ?9 n; X在输出模式下，捕获/比较寄存器影子寄存器的值与CNT的值比较，根据比较结果产生相应动作，利用这点，我们通过修改这个寄存器的值，就可以控制PWM的占空比了。注意，对于TIM2和TIM5来说，该寄存器是32位有效的，对其他定时器来说，则是16位有效位。
断路和死区寄存器（TIMx_ BDTR）
STMH7系列，通用定时器TIM15、TIM16和TIM17，以及高级定时器TIM1和TIM8，除了配置上述的寄存器之外，还需要配置：断路和死区寄存器（TIMx_BDTR），该寄存器各位描述如图21.3.1.4所示：

3 g; Y8 H2 S1 j$ O

图21.3.1.4 TIMx_ BDTR寄存器
要想上述定时器的PWM正常输出，则必须设置MOE位为1，否则不会有输出。该寄存器的其他位我们这里就不详细介绍了，讲到高级定时器的时候再介绍其它位。
, {1 p1 _( m. Q# Q8 I4 N$ s* F
21.3.2 硬件设计
9 B) G" E' E( y2 b9 Y7 E' t9 }1.例程功能
使用TIM3通道1（由PB4复用）输出PWM， PB4引脚连接了LED0，从而实现PWM输出控制LED0亮度。
0 v* u# h# @+ h- S( \: m2.硬件资源
6 R* b- n0 [3 ]4 k1 ~# U1）RGB灯 RED : LED0 - PB4
2）定时器3输出通道1（对应PB4）
  B) V, ~5 E  o* w- i0 p6 X# I' {3.原理图
) _8 r3 v; P! k5 M定时器属于STM32H750的内部资源，只需要软件设置好即可正常工作。我们通过LED0来间接指示定时器的PWM输出情况。
( K( l+ M+ E; r* a4 y$ M5 ?
21.3.3 程序设计
21.3.3.1 定时器的HAL库驱动
定时器在HAL库中的驱动代码在前面介绍基本定时器已经介绍了部分，这里我们再介绍几个本实验用到的函数。
4.HAL_TIM_PWM_Init函数
2 L; y8 M3 A' c) W定时器PWM输出基础工作参数初始化函数，其声明如下：
4 f' \. C0 g( L! F3 pHAL_StatusTypeDef HAL_TIM_PWM_Init(TIM_HandleTypeDef *htim);
函数描述：
用于初始化定时器的基础工作参数，即初始化TIM_HandleTypeDef结构体成员。
. ?0 t( |- Q9 T& J9 h: {; c8 D% h函数形参：
形参1是TIM_HandleTypeDef结构体类型指针变量，基本定时器的时候已经介绍。
函数返回值：HAL_StatusTypeDef枚举类型的值。
注意事项：
7 N. m: `! T! z4 ]- c该函数实现的功能以及使用方法和HAL_TIM_Base_Init类似，作用都是初始化定时器的ARR和PSC等参数。为什么HAL库要提供这个函数而不直接让我们使用HAL_TIM_Base_Init函数呢？这是因为HAL库为定时器的针对PWM输出定义了单独的MSP回调函数HAL_TIM_PWM_MspInit，所以当我们调用HAL_TIM_PWM_Init进行PWM初始化之后，该函数内部会调用MSP回调函数HAL_TIM_PWM_MspInit。当我们使用HAL_TIM_Base_Init初始化定时器参数的时候，它内部调用的回调函数是HAL_TIM_Base_MspInit，这里大家注意区分。
5.HAL_TIM_PWM_ConfigChannel函数
定时器PWM模式通道配置函数。其声明如下：
. R" O. d( I, @& d$ r' I* p0 Y- bHAL_StatusTypeDef HAL_TIM_PWM_ConfigChannel(TIM_HandleTypeDef *htim,
2 z9 E" h, d  B5 S& S1 X$ dTIM_OC_InitTypeDef *sConfig, uint32_t Channel);
% v& x0 |% W) ]: D函数描述：
# h+ @# F: w/ H: e. L. H' K该函数用于设置定时器的PWM输出模式及通道等参数。
函数形参：
形参1是TIM_HandleTypeDef结构体类型指针变量，用于配置定时器基本参数。
形参2是TIM_OC_InitTypeDef结构体类型指针变量，用于配置定时器输出比较参数。
下面重点来了解一下TIM_OC_InitTypeDef结构体指针类型，其定义如下：

1. typedef struct
   
2. {
   
3.   uint32_t OCMode;                 /* 输出比较模式选择，寄存器的时候说过了，共14种模式 */
   + \6 S+ \; x7 n% Z6 t# ]( D+ w( v
4.   uint32_t Pulse;                  /* 设置比较值*/
   / F0 j# c7 ^( S: [7 h$ h1 H) E
5.   uint32_t OCPolarity;           /* 设置输出比较极性 */
   * o0 m0 @- R8 ~6 o/ S" Z! d
6.   uint32_t OCNPolarity;           /* 设置互补输出比较极性 */
   
7.   uint32_t OCFastMode;            /* 使能或失能输出比较快速模式 */
   
8.   uint32_t OCIdleState;           /* 选择空闲状态下的非工作状态（OC1 输出） */
   2 o. d0 t% u( J6 m2 R" A: h, U. ^
9.   uint32_t OCNIdleState;         /* 设置空闲状态下的非工作状态（OC1N 输出） */
   ( H) j# y! U8 |
10. } TIM_OC_InitTypeDef;  

复制代码

2 _8 |6 J" s( \我们重点关注前三个结构体成员。成员变量OCMode用来设置模式，这里我们设置为PWM模式1。成员变量Pulse用来设置捕获比较值。成员变量TIM_OCPolarity用来设置输出极性。其他成员TIM_OutputNState，TIM_OCNPolarity，TIM_OCIdleState和TIM_OCNIdleState后面用到再介绍。
+ E( {8 q: [" t0 J$ B2 O形参3是定时器通道，范围：TIM_CHANNEL_16，比如定时器3只有4个通道，那选择范围就只有TIM_CHANNEL_14，所以要根据具体情况选择。
函数返回值：HAL_StatusTypeDef枚举类型的值。
6 ^% ~- s8 s4 C4 |3 a7 l7 M3. HAL_TIM_PWM_Start函数
% W4 C  }4 ?- F) p/ L+ G定时器PWM输出启动函数，其声明如下：
HAL_StatusTypeDef HAL_TIM_PWM_Start(TIM_HandleTypeDef *htim, uint32_t Channel);
9 h- V, e  g* q" ?# T函数描述：
, g) N" p) F) ^; T4 |, t; ~用于使能通道输出和启动计数器，即启动PWM输出。
函数形参：
形参1是TIM_HandleTypeDef结构体类型指针变量。
形参2是定时器通道，范围：TIM_CHANNEL_1到TIM_CHANNEL_6。
1 h: W+ K/ H2 w) Y& u! m函数返回值：HAL_StatusTypeDef枚举类型的值。
注意事项：
: e) W& m8 K8 H/ X' I! f7 jHAL库提供了单独使能定时器输出通道的函数，其声明如下：
void TIM_CCxChannelCmd(TIM_TypeDef *TIMx, uint32_t Channel,
6 E% i) \2 m& M! P( B$ I1 wuint32_t ChannelState);
HAL_TIM_PWM_Start函数内部也是调用了该函数。
( v" n$ I2 R1 e" Z# S' X, a9 Z6 `4. HAL_TIM_ConfigClockSource函数
! s# C5 m2 t, r% o) ~配置定时器时钟源函数，其声明如下：
9 m# [0 \4 D0 [HAL_StatusTypeDef HAL_TIM_ConfigClockSource(TIM_HandleTypeDef *htim,
TIM_ClockConfigTypeDef *sClockSourceConfig);
' k2 r' y( R0 G: f函数描述：
用于配置定时器时钟源。
; `/ s6 M# T- d* Y- i, |1 T3 u函数形参：
  E* h# w) _! j! t形参1是TIM_HandleTypeDef结构体类型指针变量。
形参2是TIM_ClockConfigTypeDef结构体类型指针变量，用于配置定时器时钟源参数。
2 X' _  j* i5 W) g( zTIM_ClockConfigTypeDef定义如下：
. k5 Y5 z% y4 Z9 g9 Q! R

1. typedef struct
   
2. {
   
3.   uint32_t ClockSource;                     /* 时钟源 */
   
4.   uint32_t ClockPolarity;                   /* 时钟极性 */
   
5.   uint32_t ClockPrescaler;          /* 定时器预分频器 */
   0 ?) g8 i  ^6 [. J( j- W0 D' q
6.   uint32_t ClockFilter;                    /* 时钟过滤器 */
   
7. } TIM_ClockConfigTypeDef;

复制代码

' }8 T2 A! q/ v, B3 V! a9 F函数返回值：HAL_StatusTypeDef枚举类型的值。
注意事项：
该函数主要配置TIMx_SMCR寄存器。默认情况下，定时器的时钟源是内部时钟。本实验就是使用内部时钟的，所以我们不用对时钟源就行初始化，默认即可。这里只是让大家知道有这个函数可以设定时器的时钟源。比如用HAL_TIM_ConfigClockSource初始化选择内部时钟，方法如下：
0 F  W, n6 s9 ^4 @7 ]TIM_HandleTypeDef timx_handle; /* 定时器x句柄 */
7 |/ U( G2 u: ^5 ~# g" w$ N" c3 [& Q

1. TIM_ClockConfigTypeDef sClockSourceConfig = {0};
   
2. sClockSourceConfig.ClockSource = TIM_CLOCKSOURCE_INTERNAL;    /* 选择内部时钟 */
   8 `2 B2 k1 L, K5 S' ~$ r& E* J
3. HAL_TIM_ConfigClockSource(&timx_handle, &sClockSourceConfig);

复制代码

后面的定时器初始化凡是用到内部时钟我们都没有去进行初始化，系统默认即可。
定时器PWM输出模式配置步骤
1）开启TIMx和相应通道输出的GPIO时钟，配置该IO口的复用功能输出
  b; ^/ p# i0 _8 o* h( p首先开启TIMx的时钟，然后配置GPIO为复用功能输出。本实验我们默认用到定时器3通道1，对应IO是PB4，它们的时钟开启方法如下：
  L/ F  I* e1 ]% ~+ [$ M__HAL_RCC_TIM3_CLK_ENABLE(); /* 使能定时器3 /
# h4 m% ^( C7 w, Y__HAL_RCC_GPIOB_CLK_ENABLE(); / 开启GPIOB时钟 /
! o6 U' F& ^- o6 |IO口复用功能是通过函数HAL_GPIO_Init来配置的。
( U9 X8 Y( I. O2）初始化TIMx,设置TIMx的ARR和PSC等参数
使用定时器的PWM输出功能时，通过HAL_TIM_PWM_Init函数初始化定时器ARR和PSC等参数。
3 S' L/ `  m) `注意：该函数会调用：HAL_TIM_PWM_MspInit函数，我们可以通过后者存放定时器和GPIO时钟使能、GPIO初始化、中断使能以及优先级设置等代码。
3）设置定时器为PWM模式，输出比较极性，比较值等参数
在HAL库中，通过HAL_TIM_PWM_ConfigChannel函数来设置定时器为PWM1模式或者PWM2模式，根据需求设置输出比较的极性，设置比较值（控制占空比）等。
4）使能TIMx，使能TIMx的CHy输出
在HAL库中，通过调用 HAL_TIM_PWM_Start函数来使能TIMx的某个通道输出PWM。
5）修改TIM3_CCR4来控制占空比
在经过以上设置之后，PWM其实已经开始输出了，只是其占空比和频率都是固定的，而我们可以通过修改比较值来控制PWM的输出占空比。HAL库中提供一个修改占空比的宏定义：
__HAL_TIM_SET_COMPARE (HANDLE, CHANNEL, COMPARE)
__HANDLE__是TIM_HandleTypeDef结构体类型指针变量，__CHANNEL__对应PWM的输出通道，_COMPARE__则是要写到捕获/比较寄存器（TIMx CCR1/2/3/4）的值。实际上该宏定义最终还是往对应的捕获/比较寄存器写入比较值来控制PWM波的占空比。如下解析：
比如我们要修改定时器3通道1的输出比较值（控制占空比），寄存器操作方法：
8 v7 z2 Y4 e+ E6 Y7 R- [2 vTIM3->CCR1 = ledrpwmval; / ledrpwmval是比较值，并且动态变化的，
所以我们要周期性调用这条语句，已达到及时修改PWM的占空比 */
: g; Y7 B4 i2 O  N- |/ ?' z* J__HAL_TIM_SET_COMPARE这个宏定义函数最终也是调用这个寄存器操作的，所以说我们使用HAL库的函数其实就是间接操作寄存器的。
21.3.3.2 程序流程图

+ S3 w2 ?) L: W. B8 c/ W
  A8 I. X1 G& o  s: J! b3 @
8 h6 F! g% W* k# e( r图21.3.3.2.1 通用定时器PWM输出实验程序流程图
' b5 }) J; y, O6 h. U21.3.3.3 程序解析
这里我们只讲解核心代码，详细的源码请大家参考本实验对应源码。通用定时器驱动源码包括两个文件：gtim.c和gtim.h。
3 c; i- r! `# q首先看gtim.h头文件的几个宏定义：

3 q5 F" Y3 Z6 l

1. /*****************************************************************************/
   
2. /* TIMX PWM输出定义
   
3. * 这里输出的PWM控制LED0(RED)的亮度
   / y8 f4 K' `9 V, \8 N" Z1 Z
4. * 默认是针对TIM2~TIM5, TIM12~TIM17.
   
5. * 注意: 通过修改这8个宏定义,可以支持TIM1~TIM17任意一个定时器,任意一个IO口输出PWM
   
6. */
   4 p0 `) ~8 p) W8 ?; y- Y7 w
7. #define GTIM_TIMX_PWM_CHY_GPIO_PORT         GPIOB
   $ ~! j2 t4 b1 k; I5 Y( {/ o$ m
8. #define GTIM_TIMX_PWM_CHY_GPIO_PIN          GPIO_PIN_4
   4 [$ i3 q1 B1 b& }8 s! P
9. #define GTIM_TIMX_PWM_CHY_GPIO_AF           GPIO_AF2_TIM3 /* AF功能选择 */
   
10. #define GTIM_TIMX_PWM_CHY_GPIO_CLK_ENABLE()
    
11. do{ __HAL_RCC_GPIOB_CLK_ENABLE(); }while(0)     /* PB口时钟使能 */
    / H9 c5 J( I% g5 e9 s
12. 
    1 |: _! y$ `8 D
13. #define GTIM_TIMX_PWM                         TIM3
    
14. #define GTIM_TIMX_PWM_CHY                    TIM_CHANNEL_1 /* 通道Y,  1<= Y <=4 */
    ! r7 h# f; ^8 _' P1 n; b/ I  |/ M  @+ o
15. #define GTIM_TIMX_PWM_CHY_CCRX              TIM3->CCR1    /* 通道Y的输出比较寄存器 */
    : V1 A- D: j$ y4 h; g" D+ \
16. #define GTIM_TIMX_PWM_CHY_CLK_ENABLE()      
    / F& r& v' T3 W9 x% [
17. do{ __HAL_RCC_TIM3_CLK_ENABLE(); }while(0)     /* TIM3 时钟使能 */
    0 ]3 D5 q0 {1 S5 X/ }
18. /*****************************************************************************/

复制代码

可以把上面的宏定义分成两部分，第一部分是定时器3输出通道1对应的IO口的宏定义。第二部分则是定时器3输出通道1的相应宏定义，这里的宏定义是定时器3通道1输出PWM控制LED0的相关宏定义，我们还列出了定时器15通道2输出PWM控制LED1的相关宏定义，以及定时器15通道1输出PWM控制LED2的相关宏定义，请在源码里面查看，这里由于篇幅原因，没有列出来。
6 m0 H$ j; O7 i' X: u, _gtim.h头文件就添加了这部分的程序，下面看gtim.c的程序，首先是通用定时器PWM输出初始化函数。

1. /**
   
2. * @brief       通用定时器TIMX 通道Y PWM输出 初始化函数（使用PWM模式1）
   ! g/ L/ I( {& y+ v" N
3. * @note
   5 T1 ?7 q+ b+ l6 [: h1 E1 D0 I
4. *              通用定时器的时钟来自APB1,当D2PPRE1≥2分频的时候
   9 v- `2 Q2 n7 h9 Z6 e) P
5. *              通用定时器的时钟为APB1时钟的2倍, 而APB1为120M, 所以定时器时钟 = 240Mhz
   
6. *              定时器溢出时间计算方法: Tout = ((arr + 1) * (psc + 1)) / Ft us.
   + M7 ~1 z6 O+ N# _
7. *              Ft=定时器工作频率,单位:Mhz
   
8. *
   
9. * @param       arr: 自动重装值。
   ) f8 I- e9 }5 u. h/ A( g, _
10. * @param       psc: 时钟预分频数
    
11. * @retval      无
    $ d6 }/ n# [. V) |7 I* o
12. */
    
13. void gtim_timx_pwm_chy_init(uint16_t arr,uint16_t psc)
    
14. {
    
15.     g_timx_pwm_chy_handle.Instance = GTIM_TIMX_PWM;               /* 定时器x */
    ; k2 j9 q5 T* I  w" |( ]
16.     g_timx_pwm_chy_handle.Init.Prescaler = psc;                    /* 定时器分频 */
    
17.     g_timx_pwm_chy_handle.Init.CounterMode = TIM_COUNTERMODE_UP;/* 向上计数模式 */
    * d, m5 U* N2 N+ F; Z
18.     g_timx_pwm_chy_handle.Init.Period = arr;                        /* 自动重装载值 */
    2 s3 l* _3 p# V4 \5 r0 ]' R9 ?
19.     HAL_TIM_PWM_Init(&g_timx_pwm_chy_handle);                       /* 初始化PWM */
    3 F0 {7 ]7 }  \3 m3 g6 r4 b1 F. [
20. 
    0 U" O6 N! g* U% E5 H
21. g_timx_oc_pwm_chy_handle.OCMode = TIM_OCMODE_PWM1;          /* 模式选择PWM1 */
    : M5 l- n7 o; w8 H& v4 z( D
22. /* 设置比较值,此值用来确定占空比，这里默认比较值为自动重装载值的一半,即占空比为50% */
    ( `0 z4 {2 o6 f6 ~& r6 f
23.     g_timx_oc_pwm_chy_handle.Pulse = arr/2;  
    9 @6 R% @6 @8 }
24.     g_timx_oc_pwm_chy_handle.OCPolarity = TIM_OCPOLARITY_LOW;/* 输出比较极性为低 */
    1 P* r% @" k" ?
25. HAL_TIM_PWM_ConfigChannel(&g_timx_pwm_chy_handle, &g_timx_oc_pwm_chy_handle,
      |+ W, p' ]8 b" Q7 @
26. GTIM_TIMX_PWM_CHY);/* 配置TIMx通道y */
    & a( Q# A' ]1 ~! \. }( T
27.    HAL_TIM_PWM_Start(&g_timx_pwm_chy_handle, GTIM_TIMX_PWM_CHY);/*开启PWM通道1*/
    $ o  K/ r9 n6 S2 A
28. }

复制代码

3 g$ l; S, E% ~# Y* Y' ^HAL_TIM_PWM_Init初始化TIM3并设置TIM3的ARR和PSC等参数，其次通过调用函数HAL_TIM_PWM_ConfigChannel设置TIM3_CH1的PWM模式以及比较值等参数，最后通过调用函数HAL_TIM_PWM_Start来使能TIM3以及使能PWM通道TIM3_CH1输出。
: i7 X% ^$ _' m本实验我们使用PWM的MSP初始化回调函数HAL_TIM_PWM_MspInit来存放时钟、GPIO的初始化代码，其定义如下：

1. /**
   
2. * @brief       定时器底层驱动，时钟使能，引脚配置
   
3.                 此函数会被HAL_TIM_PWM_Init()调用
   
4. * @param       htim:定时器句柄
   ( p9 {; J6 K6 I  Z
5. * @retval      无
   1 G5 o# ?! r% S2 ]" W( A- n
6. */
   
7. void HAL_TIM_PWM_MspInit(TIM_HandleTypeDef *htim)
   ( w& o- r- W" h
8. {
   
9.     if (htim->Instance == GTIM_TIMX_INT)
   2 C; C- C7 t4 Q
10.     {
    4 O/ X  T0 m$ Y2 F. n# ]* _# U  @
11.         GPIO_InitTypeDef gpio_init_struct;
    . ]9 B6 L% q) i1 A2 f" x, [; Q
12.         GTIM_TIMX_PWM_CHY_GPIO_CLK_ENABLE();             /* 开启通道y的GPIO时钟 */
    " V4 Y. s/ @" V3 }
13.         GTIM_TIMX_PWM_CHY_CLK_ENABLE();
    8 C8 V! W" T" n+ f% `8 J1 T: U
14. 
    
15.         gpio_init_struct.Pin = GTIM_TIMX_PWM_CHY_GPIO_PIN;  /* 通道y的GPIO口 */
    8 {# }% E; ?, O9 H7 x5 q
16.         gpio_init_struct.Mode = GPIO_MODE_AF_PP;              /* 复用推完输出 */
    % L" a7 H$ `- e5 o" f9 o
17.         gpio_init_struct.Pull = GPIO_PULLUP;                   /* 上拉 */
    1 F# ^7 B# @9 u$ |
18.         gpio_init_struct.Speed = GPIO_SPEED_FREQ_HIGH;       /* 高速 */
    ! }. M- }" a' Q  }
19. /* 定时器x通道y的GPIO口复用 */
    ' U" L1 u  R* M) P; D
20.         gpio_init_struct.Alternate = GTIM_TIMX_PWM_CHY_GPIO_AF;
    ; d6 t. e" |0 H% {, k8 X
21.         HAL_GPIO_Init(GTIM_TIMX_PWM_CHY_GPIO_PORT, &gpio_init_struct);
    
22.     }
    " D: C# ~4 y; q2 U, j. V4 G
23. }

复制代码

该函数首先判断定时器寄存器基地址，符合条件后，开启对应的GPIO时钟和定时器时钟，并且初始化GPIO。上面是使用HAL库标准的做法，我们亦可把HAL_TIM_PWM_MspInit函数里面的代码直接放到gtim_timx_pwm_chy_init函数里。这样做的好处是当一个项目中用到多个定时器时，代码的移植性、可读性好，方便管理。
在main.c里面编写如下代码：
4 f- C* ^/ C; k# ]

1. int main(void)
   
2. {
   % j5 F' k1 H4 r3 e3 F. P  Y+ }% o
3.     uint16_t ledrpwmval = 0;
   
4.     uint8_t dir = 1;
   
5.     sys_cache_enable();                             /* 打开L1-Cache */
   
6.     HAL_Init();                                       /* 初始化HAL库 */
   " v$ }$ j& V0 t; a+ s: K' x
7.     sys_stm32_clock_init(240, 2, 2, 4);          /* 设置时钟, 480Mhz */
   " ]0 E, ^" k0 s' K. L' `- R5 D
8.     delay_init(480);                                 /* 延时初始化 */
   
9.     usart_init(115200);                             /* 串口初始化为115200 */
   
10. led_init();                                      /* 初始化LED */
    
11. /* 240M/240=1M的计数频率，自动重装载为500，那么PWM频率为1M/500=2kHZ */
    0 f, P0 d7 W  t7 ^  w) |3 W$ n& H
12.     gtim_timx_pwm_chy_init(500 - 1, 240 - 1);
    
13.     while (1)
      I- h1 q/ G# V6 {+ j0 t
14.     {
    3 j) v2 b, q& o0 M% g/ ^& \5 Z
15.         delay_ms(10);
    
16. 
    / U" [: O! l0 T' x
17.         if (dir)ledrpwmval++;                     /* dir==1 ledrpwmval递增 */
    
18.         else ledrpwmval--;                      /* dir==0 ledrpwmval递减 */
    & Z  e( u: \" ~% \- B# L. F9 g2 \% ?
19. 
    " K5 a- Q0 f7 d$ _3 l- H* w
20.         if (ledrpwmval > 300)dir = 0;    /* ledrpwmval到达300后，方向为递减 */
    
21.         if (ledrpwmval == 0)dir = 1;     /* ledrpwmval递减到0后，方向改为递增 */
    1 t$ [; J* y1 K
22. 
    
23.         /* 修改比较值控制占空比 */
    ( O1 q8 G* @6 O  D
24.         __HAL_TIM_SET_COMPARE(&g_timx_pwm_chy_handle, GTIM_TIMX_PWM_CHY,
    1 X7 i" A2 |7 ~
25. ledrpwmval);
    , @' R% R- C# i- G- o
26.     }
    
27. }

复制代码

1 I8 L. ?" I# P' S) s9 y本小节开头我们就说PWM频率由自动重载寄存器（TIMx_ARR）的值决定，其占空比则由捕获/比较寄存器（TIMx_CCRx）的值决定。下面结合实际看看具体怎么计算：
定时器3的时钟源频率为2倍APB1总线时钟频率，即频率为240MHz，而调用gtim_timx_pwm_chy_init初始化函数之后，就相当于写入预分频寄存器的值为239，写入自动重载寄存器的值为499。基本定时器讲的定时器溢出公式由公式得：
Tout= ((arr+1)(psc+1))/Tclk= ((499+1)(239+1))/240000000=0.0005s
" F* M* B0 d& S+ c再由频率是周期的倒数关系得到PWM的频率为2000Hz。
占空比怎么计算的呢？结合图21.3.1，我们分两种情况分析，输出比较极性为低和输出比较极性为高，它们的情况正好相反。因为在main函数中的比较值是动态变化的，不利于我们计算占空比，我们假设比较值固定为200，在本实验中可以调用如下语句得到。
: `, u3 P2 N. G__HAL_TIM_SET_COMPARE(&g_timx_pwm_chy_handle, GTIM_TIMX_PWM_CHY, 200);
, o* |8 T" c# A& }& P因为LED0是低电平有效，所以我们在gtim_timx_pwm_chy_init函数中设置了输出比较极性为低，那么当比较值固定为200时，占空比 = (arr+1) – CCR1 / (arr+1) = 500-200/500=60%。其中arr是写入自动重载寄存器（TIMx_ARR）的值，CCR1就是写入捕获/比较寄存器1（TIMx_CCR1）的值。这里我们还需要提醒一下，占空比是指在一个周期内，高电平时间相对于总时间所占的比例。
另外一种情况：设置了输出比较极性为高，那么当比较值固定为200时，占空比 = CCR1 / (arr+1) = 200/500=40%。可以看到输出比较极性为低和输出比较极性为高的占空比正好反过来。
在这里，我们使用DS100示波器进行验证，效果图如图21.3.3.3.1所示：
- l7 r4 o) w( M9 b. |0 s$ }0 A1 z
; y) f2 K& }% d; T! [+ B- A4 Z

图21.3.3.3.1 验证效果图
' u$ k& g9 K5 c这里把输出比较极性低和输出比较极性高的PWM波形都显示出来了。本实验默认设置PWM模式1、输出比较极性低，当CCR1寄存器的值设置为200时，对应的PWM波形如上图黄色的波形图。如果把输出比较极性设置为高，对应的波形图就是绿色的波形图了。
! h5 y9 F0 z% G5 Y大家感兴趣也可以自行用示波器进行验证。

21.3.4 下载验证
下载代码后，定时器3通道1输出PWM信号到PB4口。可以看到LED0不停的由暗变到亮，然后又从亮变到暗。



3 A% H/ }8 h/ l8 D21.4 通用定时器输入捕获实验
本小节我们来学习使用通用定时器的输入捕获模式。
输入捕获模式可以用来测量脉冲宽度或者测量频率。我们以测量脉宽为例，用一个简图来说明输入捕获脉宽测量原理，如图21.4.1所示：
+ _& h6 w1 Y3 C- R

6 b# ~& E$ ]1 |+ }- l
, I9 k; K& G& F- {图21.4.1 输入捕获脉宽测量原理
图21.4.1中，t1到t2的时间段，就是我们需要测量的高电平时间。测量方法如下：假如定时器工作在递增计数模式，首先设置定时器通道x为上升沿捕获，这样在t1时刻上升沿到来时，就会发生捕获事件。这里我们还会打开捕获中断，所以捕获事件发生就意味着捕获中断也会发生。在捕获中断里将计数器值清零，并设置通道x为下降沿捕获，这样t2时刻下降沿到来时，就会发生捕获事件和捕获中断。捕获事件发生时，计数器的值会被锁存到捕获/比较寄存器中（比如通道1对应的是CCR1寄存器）。那么在捕获中断里，我们读取捕获/比较寄存器就可以获取到高电平脉冲时间内，计数器计数的个数，从而可以算出高电平脉冲的时间。这里是假设定时器没有溢出为前提的。
实际上，t1到t2时间段，定时器可能会产生N次溢出，这就需要我们对定时器溢出做相应的处理，防止高电平太长，导致测量出错。在t1到t2时间段，假设定时器溢出N次，那么高电平脉冲时间内，计数器计数的个数计算方法为：N*（ARR+1）+ CCRx2，CCRx2表示t2时间点，捕获/比较寄存器的值。经过计算得到高电平脉宽时间内计数器计数个数后，用这个个数乘以计数器的计数周期，就可得到高电平持续的时间。就是输入捕获测量高电平脉宽时间的整个过程。
1 O# ~7 K! ?8 T' m2 O, K2 B2 r3 bSTM32H750的定时器除了TIM6和TIM7，其他定时器都有输入捕获功能。输入捕获，简单的说就是通过检测TIMx_Chy输入的信号边沿，在信号边沿发生跳变（比如上升沿/下降沿）时，会发生捕获事件，将当前定时器的值（TIMx_CNT）锁存到对应通道的捕获/比较寄存器（TIMx_CCRy）里，完成一次捕获。同时还可以配置捕获事件发生时是否触发捕获中断/DMA。另外还要考虑测量的过程中是否可能发生定时器溢出，如果可能溢出，还要做溢出处理。

21.4.1 TIM2/TIM3/TIM4/TIM5寄存器
3 n" s/ z7 }) r3 Q% H通用定时器输入捕获实验需要用到的寄存器有：TIMx_ARR、TIMx_PSC、TIMx_CCMR1、TIMx_CCER、TIMx_DIER、TIMx_CR1、TIMx_CCR1这些寄存器在前面的章节都有提到，在这里只需针对性的介绍。
捕获/比较模式寄存器1/2（TIMx_CCMR1/2）
- U7 i; s( G# g( y, S该寄存器我们在PWM输出实验时讲解了他作为输出功能的配置，现在重点学习输入捕获模式的配置。因为本实验我们用到定时器5通道1输入，所以我们要看TIMx_CCMR1寄存器，其描述如图21.4.1.1所示：
/ ?, w! G( G+ I' K9 V5 ^


图21.4.1.1 TIMx_CCMR1寄存器
该寄存器在输入模式和输出模式下，功能是不一样，所以需要看准不同模式的描述，请打开手册查看。TIMx_CCMR1寄存器对应于通道1和通道2的设置，CCMR2寄存器对应通道3和通道4。如：TIMx_CCMR1寄存器位[7：0]和位16用于捕获/比较通道1的控制，而位[15：8]和位24则用于捕获/比较通道2的控制。我们用到定时器5通道1输入，所以需要配置TIMx_CCMR1的位[7:0]和位16。
) U+ g6 j7 N# H1 M5 N: m其中CC1S[1:0]，这两个位用于CCR1的通道配置，这里我们设置IC1S[1:0]=01，也就是配置IC1映射在TI1上。
1 M; x* G; z# }/ }输入捕获1预分频器IC1PSC[1:0]，这个比较好理解。我们是1次边沿就触发1次捕获，所以选择00就行了。
. \9 }6 J1 O$ Q) S. Z( \% H输入捕获1滤波器IC1F[3:0]，这个用来设置输入采样频率和数字滤波器长度。其中，fCK_INT是定时器时钟源频率，按照例程的配置为240Mhz，而fDTS则是根据TIMx_CR1的CKD[1:0]的设置来确定的，如果CKD[1:0]设置为00，那么fDTS=fCK_INT。N值采样次数，举个简单的例子：假设IC1F[3:0]=0011，并设置IC1映射到TI1上。表示以fCK_INT为采样频率，当连续8次都是采样到TI1为高电平或者低电平，滤波器才输出一个有效输出边沿。当8次采样中有高有低，那就保持原来的输出，这样可以滤除高频干扰信号，从而达到滤波的效果。这里，我们不做滤波处理，所以设置IC1F[3:0]=0000。
* i. e9 \  T6 ~( T" j0 @6 b2 e6 A& ~ 捕获/比较使能寄存器（TIMx_ CCER）
TIM2/TIM3/TIM4/TIM5的捕获/比较使能寄存器，该寄存器控制着各个输入输出通道的开关和极性。TIMx_CCER寄存器描述如图21.4.1.2所示：
5 O! O/ a' [& D' Y


" t# L$ y: T5 P- K$ q( e2 e& K8 L$ A图21.4.1.2 TIMx_CCER寄存器
我们要用到这个寄存器的最低2位，CC1E和CC1P位。要使能输入捕获，必须设置CC1E=1，而CC1P则根据自己的需要来配置。我们这里是保留默认设置值0，即高电平触发捕获。
# b$ I" T' H) I: w4 w接下来我们再看看DMA/中断使能寄存器：TIMx_DIER，该寄存器的各位描述见图21.2.1.3（在21.2.1小节）。本小节，我们需要用到中断来处理捕获数据，所以必须开启通道1的捕获比较中断，即CC1IE设置为1。同时我们还需要在定时器溢出中断中累计定时器溢出的次数，所以还需要使能定时器的更新中断，即UIE置1。
控制寄存器：TIMx_CR1，我们只用到了它的最低位，也就是用来使能定时器的。
, v5 H8 j$ }# V& a7 {最后再来看看捕获/比较寄存器1：TIMx_CCR1，该寄存器用来存储发生捕获事件时，TIMx_CNT的值，我们从TIMx_CCR1就可以读出通道1捕获事件发生时刻的TIMx_CNT值，通过两次捕获（一次上升沿捕获，一次下降沿捕获）的差值，就可以计算出高电平脉冲的宽度（注意，对于高电平脉宽太长的情况，还要计算定时器溢出的次数）。
) s; @0 ^  J% l. X/ S( @# l
1 ]+ ]( o$ _9 n4 V; S! K2 G5 K0 v21.4.2 硬件设计
7 ?- E- p6 Y  H+ d4 z/ u0 n! p) Y1.例程功能
1、使用TIM5_CH1来做输入捕获，捕获PA0上的高电平脉宽，并将脉宽时间通过串口打印出来，通过按WK_UP按键，模拟输入高电平，例程中能测试的最长高电平脉宽时间为：4194303 us。
0 @" Q- f5 w5 D3 T, F2、LED0闪烁指示程序运行。
2.硬件资源
2 c' \( H  w6 K3 F4 B/ v1）RGB灯
( Q* }; W* b' d5 D# QRED : LED0 - PB4
2）独立按键：WK_UP - PA0
! W) t8 b, t0 f- l  c, k0 j3）定时器5，使用TIM5通道1，将PA0复用为TIM5_CH1。
3 A7 x/ g( Y3 X  Z( Z3.原理图
定时器属于STM32H750的内部资源，只需要软件设置好即可正常工作。我们借助WK_UP做输入脉冲源并通过串口上位机来监测定时器输入捕获的情况。
8 ~/ T8 |  E: L5 o
21.4.3 程序设计
+ F' T9 P4 d; \+ Y+ _) l' k21.4.3.1 定时器的HAL库驱动
定时器在HAL库中的驱动代码在前面已经介绍了部分，这里我们再介绍几个本实验用到的函数。
, }: M3 P  V! |  D$ Q5 {3 q% ~! H& I+ b4.HAL_TIM_IC_Init函数
定时器的输入捕获模式初始化函数，其声明如下：
3 q2 u4 r. O# d5 `- }HAL_StatusTypeDef HAL_TIM_IC_Init(TIM_HandleTypeDef *htim);
) I: J$ g- q0 C$ {& r7 D函数描述：
用于初始化定时器的输入捕获模式。
$ U2 n/ {% E7 X$ u8 `) @1 }: P函数形参：
! Y* l" r; J3 f8 b9 {* \形参1是TIM_HandleTypeDef结构体类型指针变量，介绍基本定时器的时候已经介绍。
7 L6 Z( {2 Y& q3 |3 o3 z) T函数返回值：
HAL_StatusTypeDef枚举类型的值。
4 V9 G" C6 b6 h& I, w/ w3 B7 P注意事项：
! U" L* J" Y3 f1 Y* S与PWM输出实验一样，当使用定时器做输入捕获功能时，在HAL库中并不使用定时器初始化函数HAL_TIM_Base_Init来实现，而是使用输入捕获特定的定时器初始化函数HAL_TIM_IC_Init。该函数内部还会调用输入捕获初始化回调函数HAL_TIM_IC_MspInit来初始化输入通道对应的GPIO（复用），以及输入捕获相关的配置。
9 x; ~# \6 b  b7 D8 _( S2 Y! M) U; p5.HAL_TIM_IC_ConfigChannel函数
定时器的输入捕获通道设置初始化函数。其声明如下：
7 a* t! [9 K  j- b9 u' D( ZHAL_StatusTypeDef HAL_TIM_IC_ConfigChannel(TIM_HandleTypeDef *htim,
% l7 ^+ }- b+ d/ `5 YTIM_IC_InitTypeDef *sConfig, uint32_t Channel);
5 @* ^6 j+ B1 _, F函数描述：
( i- `* F" a9 l( d8 B: c该函数用于设置定时器的输入捕获通道。
3 j, O4 _. F& T) v/ e0 d' A& h* ^$ ^函数形参：
9 u5 s4 u' v  l  Y形参1是TIM_HandleTypeDef结构体类型指针变量，用于配置定时器基本参数。
形参2是TIM_IC_InitTypeDef结构体类型指针变量，用于配置定时器的输入捕获参数。
重点了解一下TIM_IC_InitTypeDef结构体指针类型，其定义如下：
7 k. ~5 z0 d5 v4 d7 G& O1 N: i

1. typedef struct
   . j% n- R% g" K: z
2. {
   ' N* q+ T' X% g( ?  ~! T
3.   uint32_t ICPolarity;                 /* 输入捕获触发方式选择，比如上升、下降和双边沿捕获 */
   $ C6 `2 R. }$ K# v& Y6 @* |# y2 a" E
4.   uint32_t ICSelection;         /* 输入捕获选择，用于设置映射关系 */
   
5.   uint32_t ICPrescaler;         /* 输入捕获分频系数 */
   $ y' t$ p# }: `
6.   uint32_t ICFilter;                 /* 输入捕获滤波器设置 */
   8 s, I6 ]5 ?% E
7. } TIM_IC_InitTypeDef;

复制代码

该结构体成员我们现在介绍一下。成员变量ICPolarity用来设置输入信号的有效捕获极性，取值范围为：TIM_ICPOLARITY_RISING(上升沿捕获)，TIM_ICPOLARITY_FALLING（下降沿捕获）和TIM_ICPOLARITY_BOTHEDGE（双边沿捕获）。成员变量ICSelection用来设置映射关系，我们配置IC1直接映射在TI1上，选择TIM_ICSELECTION_DIRECTTI（另外还有两个输入通道TIM_ICSELECTION_INDIRECTTI 和TIM_ICSELECTION_TRC）。成员变量ICPrescaler用来设置输入捕获分频系数，可以设置为TIM_ICPSC_DIV1（不分频），TIM_ICPSC_DIV2（2分频），TIM_ICPSC_DIV4（4分频）以及TIM_ICPSC_DIV8（8分频），本实验需要设置为不分频，所以选值为TIM_ICPSC_DIV1。成员变量ICFilter用来设置滤波器长度，这里我们不使用滤波器，所以设置为0。
形参3是定时器通道，范围：TIM_CHANNEL_1到TIM_CHANNEL_6，比如定时器5只有4个通道，那选择范围只有TIM_CHANNEL_1到TIM_CHANNEL_4，就具体情况选择。
" m- E; z5 B/ D1 S函数返回值：
  ]8 G- c8 w  F; KHAL_StatusTypeDef枚举类型的值。
6 U$ Z! S" d$ \9 I3. HAL_TIM_IC_Start_IT函数
+ L) g& w2 V+ m4 n% b5 R9 ~启动定时器输入捕获模式函数，其声明如下：
5 l( N' `: g9 ?  a$ C1 p: }HAL_StatusTypeDef HAL_TIM_IC_Start_IT(TIM_HandleTypeDef *htim,
uint32_t Channel);
' A3 `7 U) t0 N( l函数描述：
! |5 l3 S/ c4 U4 k  z1 x/ T( a3 X% M用于启动定时器的输入捕获模式，且开启输入捕获中断。
3 u/ G$ k) g$ b5 h) ^  |函数形参：
" K. d0 X8 R9 `8 M8 P1 X1 L0 j形参1是TIM_HandleTypeDef结构体类型指针变量。
7 c+ t3 ]/ r" N+ T, c形参2是定时器通道，范围：TIM_CHANNEL_1到TIM_CHANNEL_6。
" J; Y" w( |) g函数返回值：
  `0 Y" I9 x# }0 z5 K1 NHAL_StatusTypeDef枚举类型的值。
注意事项：
如果我们不需要开启输入捕获中断，只是开启输入捕获功能，HAL库函数为：
6 @2 Q8 v- H0 ]HAL_StatusTypeDef HAL_TIM_IC_Start(TIM_HandleTypeDef htim, uint32_t Channel);
3 }) ^6 M+ w3 `6 N( Y0 _定时器输入捕获模式配置步骤
+ e7 l+ \5 y0 S3 Y  D% d3 w1）开启TIMx和相应输入通道的GPIO时钟，配置该IO口的复用功能输入
首先开启TIMx的时钟，然后配置GPIO为复用功能输出。本实验我们默认用到定时器5通道1，对应IO是PA0，它们的时钟开启方法如下：
0 D" P0 y' }& G4 ~__HAL_RCC_TIM5_CLK_ENABLE(); / 使能定时器5 /
# v/ d( v) f3 C( D+ O1 }5 j__HAL_RCC_GPIOA_CLK_ENABLE(); / 开启GPIOA时钟 */
IO口复用功能是通过函数HAL_GPIO_Init来配置的。
2）初始化TIMx，设置TIMx的ARR和PSC等参数
9 c: @7 u. R. _% M2 ]) l使用定时器的输入捕获功能时，我们调用的是HAL_TIM_IC_Init函数来初始化定时器ARR和PSC等参数。
注意：该函数会调用：HAL_TIM_IC_MspInit函数，我们可以通过后者存放定时器和GPIO时钟使能、GPIO初始化、中断使能以及优先级设置等代码。
3）设置定时器为输入捕获模式，开启输入捕获
在HAL库中，定时器的输入捕获模式是通过HAL_TIM_IC_ConfigChannel函数来设置定时器某个通道为输入捕获通道，包括映射关系，输入滤波和输入分频等。
4）使能定时器更新中断，开启捕获功能以及捕获中断，配置定时器中断优先级
通过__HAL_TIM_ENABLE_IT函数使能定时器更新中断。
通过HAL_TIM_IC_Start_IT函数使能定时器并开启捕获功能以及捕获中断。
通过HAL_NVIC_EnableIRQ函数使能定时器中断。
通过HAL_NVIC_SetPriority函数设置中断优先级。
因为我们要捕获的是高电平信号的脉宽，所以，第一次捕获是上升沿，第二次捕获是下降沿，必须在捕获上升沿之后，设置捕获边沿为下降沿，同时，如果脉宽比较长，那么定时器就会溢出，对溢出必须做处理，否则结果就不准了。
8 P) E1 q+ r& {& N( a, |6 V& v7 f5）编写中断服务函数
) a% E( ?5 r8 [, K6 q3 V3 R5 o, i" V* o定时器中断服务函数为：TIMx_IRQHandler等，当发生中断的时候，程序就会执行中断服务函数。HAL库提供了一个定时器中断公共处理函数HAL_TIM_IRQHandler，该函数会根据中断类型调用相关的中断回调函数。用户根据自己的需要重定义这些中断回调函数来处理中断程序。本实验我们除了用到更新（溢出）中断回调函数HAL_TIM_PeriodElapsedCallback之外，还要用到捕获中断回调函数HAL_TIM_IC_CaptureCallback。详见本实验例程源码。

21.4.3.2 程序流程图
+ D4 f: Y" t$ i1 d
; }7 I& |3 A  L4 b. ]+ z0 u- K

图21.4.3.2.1 通用定时器输入捕获实验程序流程图
7 Y; C9 x4 c/ k
21.4.3.3 程序解析
这里我们只讲解核心代码，详细的源码请大家参考光盘本实验对应源码。通用定时器驱动源码包括两个文件：gtim.c和gtim.h。
首先看gtim.h头文件的几个宏定义：

, l% i  T% P" T  f  ^% t

1. /*****************************************************************************/
   
2. /* TIMX 输入捕获定义
   ( V$ C* |2 S: X+ C7 r' e
3. * 这里的输入捕获使用定时器TIM2_CH1,捕获WK_UP按键的输入
   % V# ~& E( Z6 ^0 p6 W. }
4. * 默认是针对TIM2~TIM5, TIM12~TIM17.
   
5. * 注意: 通过修改这8个宏定义,可以支持TIM1~TIM17任意一个定时器,任意一个IO口做输入捕获
   0 Q7 h9 l$ x% T3 ?0 d- F
6. *       注意:默认用的PA0,设置的是下拉输入!如果改其他IO,对应的上下拉方式/AF功能等也得改!
   # c9 E2 c: k% }6 M4 |: p
7. */
     T+ V- R4 N% x  N+ h7 M
8. #define GTIM_TIMX_CAP_CHY_GPIO_PORT            GPIOA
   5 [  N3 J* ^  F( R
9. #define GTIM_TIMX_CAP_CHY_GPIO_PIN             GPIO_PIN_0
   5 R4 s% V) x: k$ I
10. #define GTIM_TIMX_CAP_CHY_GPIO_AF              GPIO_AF2_TIM5             /* AF功能选择 */
    / w2 D* W) h. E! `
11. #define GTIM_TIMX_CAP_CHY_GPIO_CLK_ENABLE()
    ) Z" b8 B& C( r+ o& k; u: ?3 I# g
12. do{ __HAL_RCC_GPIOA_CLK_ENABLE(); }while(0)          /* PA口时钟使能 */
    6 X& E$ r* t2 n) C7 x3 m: T
13. 
    6 f& T2 B1 V' [% I5 e
14. #define GTIM_TIMX_CAP                      TIM5                       
    ( J' V' H' J2 L2 O, {
15. #define GTIM_TIMX_CAP_IRQn                TIM5_IRQn
    
16. #define GTIM_TIMX_CAP_IRQHandler         TIM5_IRQHandler
    ; W5 p- P( X* U/ g# ~* I% c7 m
17. #define GTIM_TIMX_CAP_CHY                 TIM_CHANNEL_1         /* 通道Y,  1<= Y <=4 */
    
18. #define GTIM_TIMX_CAP_CHY_CCRX           TIM5->CCR1             /* 通道Y的输出比较寄存器 */
    + u7 Y3 U- a  d, I
19. #define GTIM_TIMX_CAP_CHY_CLK_ENABLE()      
    
20.   do{ __HAL_RCC_TIM5_CLK_ENABLE(); }while(0)            /* TIMX 时钟使能 */
    
21. /*****************************************************************************/

复制代码

可以把上面的宏定义分成两部分，第一部分是定时器5输入通道1对应的IO口的宏定义，第二部分则是定时器5输入通道1的相应宏定义。
gtim.h头文件就添加了这部分的程序，下面看gtim.c的程序，首先是通用定时器输入捕获初始化函数，其定义如下：

1. /**
   , o4 }' d8 U$ G1 I* U* ~
2. * @brief       通用定时器TIMX 通道Y 输入捕获 初始化函数
   
3. * @note
   3 ]* c4 y& D+ `5 k, j5 k
4. *              通用定时器的时钟来自APB1,当D2PPRE1≥2分频的时候
   
5. *              通用定时器的时钟为APB1时钟的2倍, 而APB1为120M, 所以定时器时钟 = 240Mhz
   9 S2 N* m( ]- m- i9 X
6. *              定时器溢出时间计算方法: Tout = ((arr + 1) * (psc + 1)) / Ft us.
   / c; |9 d5 k! [8 H1 V# g
7. *              Ft=定时器工作频率,单位:Mhz
   ( C" \0 y) r. ?$ Z, M# J
8. *
   
9. * @param       arr: 自动重装值
   
10. * @param       psc: 时钟预分频数
    
11. * @retval      无
    8 ^" h" f; ]& f5 P* l  o; D
12. */
    ) U: ^+ f7 f2 o- m/ c+ Z" I8 N
13. void gtim_timx_cap_chy_init(uint16_t arr, uint16_t psc)
    3 f! H0 n$ \$ v: H8 U
14. {
    
15.     TIM_IC_InitTypeDef timx_ic_cap_chy = {0};
    
16. 
    
17.     g_timx_cap_chy_handle.Instance = GTIM_TIMX_CAP;                /* 定时器5 */
    
18.     g_timx_cap_chy_handle.Init.Prescaler = psc;                    /* 定时器分频 */
    5 k8 k5 [" p; Z
19.     g_timx_cap_chy_handle.Init.CounterMode = TIM_COUNTERMODE_UP;/* 递增计数模式 */
    
20.     g_timx_cap_chy_handle.Init.Period = arr;                        /* 自动重装载值 */
    
21.     HAL_TIM_IC_Init(&g_timx_cap_chy_handle);
    : v9 P6 Q. V, N& \
22. 
    2 R' X3 d, n2 J3 g$ Y5 H& \
23.     timx_ic_cap_chy.ICPolarity = TIM_ICPOLARITY_RISING;          /* 上升沿捕获 */
    " i5 T- |; N" e
24.     timx_ic_cap_chy.ICSelection = TIM_ICSELECTION_DIRECTTI;     /* 映射到TI1上 */
    : G* d* [2 z& t1 F
25.     timx_ic_cap_chy.ICPrescaler = TIM_ICPSC_DIV1;     /* 配置输入分频，不分频 */
      ]* |# {& j0 B: s
26.     timx_ic_cap_chy.ICFilter = 0;                        /* 配置输入滤波器，不滤波 */
    
27. HAL_TIM_IC_ConfigChannel(&g_timx_cap_chy_handle, &timx_ic_cap_chy,
    ) d: o; S( I1 @; @. T" M
28. GTIM_TIMX_CAP_CHY);/* 配置TIM5通道1 */
    
29. 
    - X3 e# `; v% k* F) i5 x1 L* D0 Q5 l
30. __HAL_TIM_ENABLE_IT(&g_timx_cap_chy_handle, TIM_IT_UPDATE);  /* 使能更新中断 */
    8 d0 M& y# F5 n8 B  j
31. /* 使能通道输入以及使能捕获中断*/
    # [, h+ H6 ~" t' m
32.     HAL_TIM_IC_Start_IT(&g_timx_cap_chy_handle, GTIM_TIMX_CAP_CHY);
    4 K* e/ U. B5 j
33. }
    : ]& k: R1 N/ `

复制代码

, _. ~9 J6 a6 r% P7 ~5 w( }4 bHAL_TIM_IC_Init初始化定时器的基础工作参数，如：ARR和PSC等，第二部分则是调用HAL_TIM_IC_ConfigChannel函数配置输入捕获通道映射关系，滤波和分频等。最后是使能更新中断和使能通道输入以及定时器捕获中断。通道对应的IO、时钟开启和NVIC的初始化都在HAL_TIM_IC_MspInit函数里编写，其定义如下：
' {8 S9 ]9 [. D9 e# ~

1. /**
   ( T5 L" }  a/ b) p8 r. c1 m7 _
2. * @brief       通用定时器输入捕获初始化接口
   $ B9 f; T# Y3 U! Z0 v. f
3.                  HAL库调用的接口，用于配置不同的输入捕获
   $ }" W8 U0 i6 I3 ^0 R
4. * @param       htim:定时器句柄
   
5. * @note        此函数会被HAL_TIM_IC_Init()调用
   1 Q+ t) a% y+ p
6. * @retval      无
   ! z& v5 W* o' t) Q0 T
7. */
   - T* J2 g( |2 _: }/ [( y) s: J
8. void HAL_TIM_IC_MspInit(TIM_HandleTypeDef *htim)
   ' `! D$ s" _9 b- H: o+ h, g
9. {
   ) `& C, m2 @, H( ]: @  ]7 x
10.     if (htim->Instance == GTIM_TIMX_CAP)                      /* 输入通道捕获 */
    
11.     {
    
12.         GPIO_InitTypeDef gpio_init_struct;
    . [# U6 S: n6 w5 d
13.         GTIM_TIMX_CAP_CHY_CLK_ENABLE();                        /* 使能TIMx时钟 */
    7 j& ?9 r' i7 P
14.         GTIM_TIMX_CAP_CHY_GPIO_CLK_ENABLE();                  /* 开启捕获IO的时钟 */
    & Q* m( }( [* B1 w/ W) y7 l
15. 
    & W8 @* L) f3 q# e2 e3 _
16.         gpio_init_struct.Pin = GTIM_TIMX_CAP_CHY_GPIO_PIN; /* 输入捕获的GPIO口 */
    
17.         gpio_init_struct.Mode = GPIO_MODE_AF_PP;             /* 复用推挽输出 */
    
18.         gpio_init_struct.Pull = GPIO_PULLDOWN;               /* 下拉 */
    9 N3 D6 w. a. O( E4 ^( M
19.         gpio_init_struct.Speed = GPIO_SPEED_FREQ_VERY_HIGH; /* 高速 */
    
20.         gpio_init_struct.Alternate = GTIM_TIMX_CAP_CHY_GPIO_AF; /* 复用 */
    
21.         HAL_GPIO_Init(GTIM_TIMX_CAP_CHY_GPIO_PORT, &gpio_init_struct);
    9 z  D2 H# A* J: c) ~% L, T# [
22. 
    
23.         HAL_NVIC_SetPriority(GTIM_TIMX_CAP_IRQn, 1, 3);    /* 抢占1，子优先级3 */
    " t( q& S( r) m8 d$ G  ~! v
24.         HAL_NVIC_EnableIRQ(GTIM_TIMX_CAP_IRQn);              /* 开启ITMx中断 */
    
25.     }
    ; s. k2 K( X. V# g
26. }

复制代码

该函数调用HAL_GPIO_Init函数初始化定时器输入通道对应的IO，并且开启GPIO时钟，使能定时器。其中要注意IO口复用功能的选择一定要选对了。最后配置中断抢占优先级和响应优先级，以及打开定时器中断。
通过上面的两个函数输入捕获的初始化就完成了，下面先来介绍两个变量。
/* 输入捕获状态(g_timxchy_cap_sta)
( v, ^+ D# T) o0 l
7 e) K% H) Q: A/ v& o% V[7] :0,没有成功的捕获;1,成功捕获到一次.
[6] :0,还没捕获到高电平;1,已经捕获到高电平了.
[5:0]:捕获高电平后溢出的次数,最多溢出63次,所以最长捕获值= 63*65536+65535 = 4194303
  注意:为了通用,我们默认ARR和CCRy都是16位寄存器,对于32位的定时器(如:TIM5),
2 f1 i6 V8 r" Y+ J       也只按16位使用
  按1us的计数频率,最长溢出时间为:4194303 us, 约4.19秒
0 o; b9 V  L6 k/ y" u (说明一下：正常32位定时器来说,1us计数器加1,溢出时间:4294秒)
/
# ?% N7 L: ~5 i9 J/ muint8_t g_timxchy_cap_sta = 0; / 输入捕获状态 /
" i9 \/ s/ Z/ `/ ?' X" k9 duint16_t g_timxchy_cap_val =0 ; / 输入捕获值 */
这两个变量用于辅助实现高电平捕获。其中g_timxchy_cap_sta，是用来记录捕获状态， （这个变量，我们把它当成一个寄存器那样来使用）。对其各位赋予状态含义，描述如下表所示：
1 m6 _# }' e% Bg_timxchy_cap_sta
  r& w1 Z. W$ N- q/ f. |bit7 bit6 bit5~0
捕获完成标志 捕获到高电平标志 捕获高电平后定时器溢出的次数
1 e6 M2 r3 ?: {: `2 R- L表21.4.3.3.1 g_timxchy_cap_sta各位描述
变量g_timxchy_cap_sta的位[5:0]是用于记录捕获高电平定时器溢出次数，总共6位，所以最多可以记录溢出的次数为2的6次方减一次，即63次。
变量g_timxchy_cap_val，则用来记录捕获到下降沿的时候，TIM5_CNT寄存器的值。
下面开始看中断服务函数的逻辑程序，HAL_TIM_IRQHandler函数会调用下面两个回调函数，我们的逻辑代码就是放在回调函数里，函数定义如下：
. g! D4 A. R! R1 M4 Q% v

1. /**
   
2. * @brief       定时器输入捕获中断处理回调函数
   
3. * @param       htim:定时器句柄指针
   
4. * @note        该函数在HAL_TIM_IRQHandler中会被调用
     r- Y9 ], }1 z+ w/ F
5. * @retval      无
   
6. */
   
7. void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim)
   + s2 ?, d& f7 C& q- d
8. {
   6 b( M1 m% B0 P9 K+ u; Q
9.     if ((g_timxchy_cap_sta & 0X80) == 0)             /* 还没成功捕获 */
   : N' @' J2 i3 p
10.     {
    ' S8 }9 M7 [' H; \
11.         if (g_timxchy_cap_sta & 0X40)                    /* 捕获到一个下降沿 */
    ( T5 g0 t0 p7 f% ~$ a
12.         {
    1 e2 E5 C5 r$ u
13.             g_timxchy_cap_sta |= 0X80;                   /* 标记成功捕获到一次高电平脉宽 */
    
14.             g_timxchy_cap_val = HAL_TIM_ReadCapturedValue(&g_timx_cap_chy_handler,
    4 i. q- k" d+ r7 E( n
15. GTIM_TIMX_CAP_CHY); /* 获取当前的捕获值 */
    
16.             TIM_RESET_CAPTUREPOLARITY(&g_timx_cap_chy_handler,
    
17. GTIM_TIMX_CAP_CHY);/* 一定要先清除原来的设置 */
    
18.             TIM_SET_CAPTUREPOLARITY(&g_timx_cap_chy_handler, GTIM_TIMX_CAP_CHY,
    
19. TIM_ICPOLARITY_RISING);/* 配置TIM5通道1上升沿捕获 */
    
20.         }
    
21.         else                                     /* 还未开始,第一次捕获上升沿 */
    
22.         {
    0 M% m. T% y& z- j0 m% O! N
23.             g_timxchy_cap_sta = 0;           /* 清空 */
    
24.             g_timxchy_cap_val = 0;
    
25.             g_timxchy_cap_sta |= 0X40;      /* 标记捕获到了上升沿 */
    
26.             __HAL_TIM_DISABLE(&g_timx_cap_chy_handler);  /* 关闭定时器5 */
    6 {" m! p3 [: R. a3 Y. N+ b" \
27.             __HAL_TIM_SET_COUNTER(&g_timx_cap_chy_handler,0); /* 计数器清零 */
    7 t  t3 |- d/ d9 D
28.             TIM_RESET_CAPTUREPOLARITY(&g_timx_cap_chy_handler,
    : s) U  R8 M0 |. {9 L" c
29. GTIM_TIMX_CAP_CHY); /* 一定要先清除原来的设置！！ */
    
30.             TIM_SET_CAPTUREPOLARITY(&g_timx_cap_chy_handler, GTIM_TIMX_CAP_CHY,
    
31. TIM_ICPOLARITY_FALLING);     /* 定时器5通道1设置为下降沿捕获 */
    1 y$ m% K; G0 {; F9 V6 v0 o
32.             __HAL_TIM_ENABLE(&g_timx_cap_chy_handler);   /* 使能定时器5 */
    
33.         }
    
34.     }
    ! O6 `6 f+ }- p$ ]# F( f! c
35. }
    - A- P( B! y3 J' U8 A6 T
36. 
    7 `2 d, h# V! t5 _, L0 j
37. /**
    
38. * @brief       定时器更新中断回调函数
    1 i4 j' T+ Q/ i
39. * @param        htim:定时器句柄指针
    4 W2 f( P+ w  I3 Q
40. * @note        此函数会被定时器中断函数共同调用的
    
41. * @retval      无
    / S2 i  m8 z/ B; N
42. */
    
43. void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
    . p! z- p2 E0 I. U
44. {
    3 t3 f) q/ g; \5 e5 e$ ?
45.     if (htim->Instance == GTIM_TIMX_CAP)
    $ @% T+ v9 L) o9 Y, D; ~
46.     {
    
47.         if ((g_timxchy_cap_sta & 0X80) == 0)               /* 还没成功捕获 */
    ! B$ `  p( A  `! T* m
48.         {
    1 W* c1 Y8 s1 {- u' K# v2 i
49.             if (g_timxchy_cap_sta & 0X40)                   /* 已经捕获到高电平了 */
    
50.             {
    2 v$ j1 L5 `, n5 ?6 F9 {
51.                 if ((g_timxchy_cap_sta & 0X3F) == 0X3F)   /* 高电平太长了 */
    
52.                 {
    
53.                     TIM_RESET_CAPTUREPOLARITY(&g_timx_cap_chy_handle,
    1 \+ M& O- B" V4 u2 ?1 T- @
54. GTIM_TIMX_CAP_CHY);  /* 一定要先清除原来的设置 */
    
55. /* 配置TIM5通道1上升沿捕获 */
    
56.                     TIM_SET_CAPTUREPOLARITY(&g_timx_cap_chy_handle,
    + A" t. I1 }- D1 x( Z2 V4 c
57. GTIM_TIMX_CAP_CHY, TIM_ICPOLARITY_RISING);
    
58.                     g_timxchy_cap_sta |= 0X80;             /* 标记成功捕获了一次 */
    + d) t/ K, v1 t5 v- ]( R
59.                     g_timxchy_cap_val = 0XFFFF;
    
60.                 }
    
61.                 else                                           /* 累计定时器溢出次数 */
    
62.                 {
    1 C; j, U0 L* I0 U! I' `
63.                     g_timxchy_cap_sta++;
    / p+ _: D' P0 r# [
64.                 }
    
65.             }
    
66.         }
    
67.     }
    
68. }

复制代码

现在我们来介绍一下，捕获高电平脉宽的思路：首先，设置TIM5_CH1捕获上升沿，然后等待上升沿中断到来，当捕获到上升沿中断，此时如果g_timxchy_cap_sta的第6位为0，则表示还没有捕获到新的上升沿，就先把g_timxchy_cap_sta、g_timxchy_cap_val和TIM5_CNT寄存器等清零，然后再设置g_timxchy_cap_sta的第6位为1，标记捕获到高电平，最后设置为下降沿捕获，等待下降沿到来。如果等待下降沿到来期间，定时器发生了溢出，就用g_timxchy_cap_sta变量对溢出次数进行计数，当最大溢出次数来到的时候，就强制标记捕获完成，并配置定时器通道上升沿捕获。当下降沿到来的时候，先设置g_timxchy_cap_sta的第7位为1，标记成功捕获一次高电平，然后读取此时的定时器值到g_timxchy_cap_val里面，最后设置为上升沿捕获，回到初始状态。
. D( s* \7 M* _/ y3 \这样，我们就完成一次高电平捕获了，只要g_timxchy_cap_sta的第7位一直为1，那么就不会进行第二次捕获，我们在main函数处理完捕获数据后，将g_timxchy_cap_sta置零，就可以开启第二次捕获。
+ {; Y0 V: _- e9 J; T在main.c里面编写如下代码：
: _# N+ ?  I6 ~' U6 _' F0 o

1. int main(void)
   
2. {
   
3.     uint32_t temp = 0;
   
4.     uint8_t t = 0;
   . J6 {0 m! |( I* s) A% I- L4 _
5. 
   
6.     sys_cache_enable();                                     /* 打开L1-Cache */
   
7.     HAL_Init();                                       /* 初始化HAL库 */
   # o" b6 O/ L* V2 h
8.     sys_stm32_clock_init(240, 2, 2, 4);          /* 设置时钟, 480Mhz */
   0 G) q1 ]- ~) G8 |" `7 j
9.     delay_init(480);                                 /* 延时初始化 */
   ) ?+ C$ c6 `" k
10.     usart_init(115200);                             /* 串口初始化为115200 */
      C8 V% ?$ c- i0 i9 V4 G6 m
11.     led_init();                                              /* 初始化LED */
    
12.     key_init();                                              /* 初始化按键 */
    
13.     gtim_timx_cap_chy_init(0XFFFF, 240 - 1);           /* 以1Mhz的频率计数 捕获 */
    
14. 
    1 h! [" \7 q( I& N
15.     while (1)
    
16.     {
    
17.         if (g_timxchy_cap_sta & 0X80)                   /* 成功捕获到了一次高电平 */
    
18.         {
    
19.             temp = g_timxchy_cap_sta & 0X3F;
    
20.             temp *= 65536;                                 /* 溢出时间总和 */
    
21.             temp += g_timxchy_cap_val;                  /* 得到总的高电平时间 */
    
22.             printf("HIGH:%d us\r\n", temp);            /* 打印总的高点平时间 */
    * \( V' F; L* M, p" B5 Z
23.             g_timxchy_cap_sta = 0;                      /* 开启下一次捕获*/
    7 X1 I1 P/ ?+ O/ e6 {
24.         }
    
25.         t++;
    6 O' S9 Q$ D$ i/ ?( g
26.         if (t > 20)                 /* 200ms进入一次 */
    
27.         {
    2 Y% N( u" }  N( `+ P( |
28.             t = 0;
    # O- i( ]3 j4 q& r2 }! d
29.             LED0_TOGGLE();          /* LED0闪烁 ,提示程序运行 */
    ' W, S7 Z1 e( n+ |/ V. O5 _
30.         }
    
31.         delay_ms(10);
    
32.     }
    7 [! N5 t- g/ T% f0 k
33. }

复制代码

先看gtim_timx_cap_chy_init(0XFFFF, 240 - 1)这个语句，这两个形参分别设置自动重载寄存器的值为65535，以及预分频器寄存器的值为239。定时器5是32位的计数器，为了通用性，我们只使用16位，所以计数器设置为65535。预分频系数，我们设置为240分频，定时器5的时钟频率是2倍的APB1总线时钟频率，即240MHz，可以得到计数器的计数频率是1MHz，即1us计数一次，所以我们的捕获时间精度是1us。这里可以知道定时器的溢出时间是65536us。
While（1）无限循环通过判断g_timxchy_cap_sta的第7位，来获知有没有成功捕获到一次高电平，如果成功捕获，先计算总的高电平时间，再通过串口传输到电脑。

21.4.4 下载验证
下载代码后，可以看到LED0在闪烁，说明程序已经正常在跑了，我们再打开串口调试助手，选择对应的串口端口，我这边是COM15，然后按KEY_UP按键，可以看到串口打印的高电平持续时间，如图21.4.4.1所示：
4 s0 B( K) K! \3 z% a- \7 J

3 b# M) M0 w) }, K( k2 g# ^
2 K$ t7 H; H+ U! j图21.4.4.1 打印捕获到的高电平时间

, B" b: j2 U- z, I9 P& ^21.5 通用定时器脉冲计数实验
+ ]  Q3 a0 W0 {前面我们介绍了通用定时器的四类时钟源，本小节我们来学习使用通用定时器的外部时钟模式1这类时钟源。
6 ^4 Q* d- i* P) j5 x前面的三个通用定时器实验的时钟源都是来自内部时钟 (CK_INT)，本实验我们将使用外部时钟模式 1：外部输入引脚 (TIx)作为定时器的时钟源。关于这个外部输入引脚(TIx)，我们使用WK_UP按键按下产生的高电平脉冲作为定时器的计数器时钟，每按下一次按键产生一次高电平脉冲，计数器加一。
8 Q! ?+ t2 f1 j& H下面通过框图给大家展示本实验用到定时器内部哪些资源，如下图所示：
4 b# I. _3 O0 Y& p( h( H5 z
. o- K2 j  ^9 P: z1 @4 l

图21.5.1 脉冲计数实验原理
前面介绍过，外部时钟模式1的外部输入引脚只能是通道1或者通道2对应的IO，通道3或者通道4是不可以的。以通道1输入为例，外部时钟源信号通过通道1输入后，接下来我们用TI1表示该信号。TI1分别要经过滤波器、边沿检测器后，来到TI1FP1，被触发输入选择器选择为触发源，接着来到从模式控制器。从模式选择为外部时钟模式1，这时候外部时钟源信号就会到达时基单元的预分频器，后面就是经过分频后就作为计数器的计数时钟了。这个过程的描述，大家亦可参考前面介绍外部时钟模式1的描述。因为前面已经介绍过，这里只是简单讲一下。
如果大家想时钟源信号的上升沿和下降沿，计数器都计数，可以选择TI1F_ED作为触发输入选择器的触发源。
3 _6 ?& r) O' x0 D% O5 n% Q假设计数器工作在递增计数模式，那么每来一个选择的边沿，计数器就加一。最后，外部时钟源信号的边沿计数个数会保存计数器寄存器中，我们只需要直接读取CNT的值即可。这里是没有考虑定时器溢出的情况，如果定时器溢出还需要对溢出进行处理。比如开启更新中断，定时器溢出后，在更新中断里，对溢出次数进行记录，然后用溢出次数乘以溢出一次计数的个数，再加上CNT现在的值，就可以得到总的计数个数了。在例程中，我们也是这样处理的。
下面开始讲解本实验用到的寄存器配置情况。
; q. K$ {. I8 E5 |9 k( z' Q8 d# _
0 f' P/ ~" O$ K+ e, `, r6 v21.5.1 TIM2/TIM3/TIM4/TIM5寄存器
3 X+ i, j: e! C; W4 {! s通用定时器脉冲计数实验需要用到的寄存器有：TIMx_ARR、TIMx_PSC、TIMx_CCMR1、TIMx_CCER、TIMx_DIER、TIMx_CR1、TIMx_EGR这些寄存器在前面的章节都有提到，在这里只需针对性的介绍。
; c, R4 p1 C; ]+ v9 M捕获/比较模式寄存器1/2（TIMx_CCMR1/2）
该寄存器我们在PWM输出实验时讲解了他作为输出功能的配置，在输入捕获实验学习了输入捕获模式的配置，本小节我们的外部信号也同样要作为输入信号给定时器作为时钟源，所以我们要看输入捕获模式定时器对应功能。WK_UP按键（PA0）对应着定时器2的通道1，这个可以在《STM32H750VBT6.pdf》数据手册62页找到。接下来我们开始配置TIMx_CCMR1寄存器，其描述如图21.5.1.1所示：

. j- ^+ {) [0 y1 }$ Z& m$ u
8 T( b- H3 r& L7 Y; y; \( k( g
: }, W4 r0 ^/ C- c& t  s& f9 _图21.5.1.1 TIMx_CCMR1寄存器
用到定时器2的通道1，所以要配置TIM2_CCMR1寄存器的位[7：0]，其中CC1S[1:0]，这两个位用于CCR1的通道配置，这里我们设置IC1S[1:0]=01，也就是配置IC1映射在TI1上，即CCR1对应TIMx_CH1。
, Z. D- K. v6 t0 ]) x( r输入捕获1预分频器IC1PSC[1:0]，我们是1次高电平脉冲就触发1次计数，所以不用分频选择00即可。
4 T# u! O; T: H0 @6 o7 j# b输入捕获1滤波器IC1F[3:0]，这个用来设置输入采样频率和数字滤波器长度，关于滤波长度的介绍请看上一个实验。这里，我们不做滤波处理，所以设置IC1F[3:0]=0000，只要采集到上升沿，就触发捕获。
捕获/比较使能寄存器（TIMx_ CCER）
% O* Z1 ]& l; tTIM2/TIM3/TIM4/TIM5的捕获/比较使能寄存器，该寄存器控制着各个输入输出通道的开关和极性。TIMx_CCER寄存器描述如图21.5.1.2所示：


+ Q/ L+ V$ C6 K8 I, u
$ F( X  l$ O- K+ f1 c1 K图21.5.1.2 TIMx_CCER寄存器
) ]' Y  V3 K; R+ V9 q/ j7 N我们要用到这个寄存器的最低2位，CC1E和CC1P位。要使能输入捕获，必须设置CC1E=1，而CC1P则根据自己的需要来配置。我们这里是保留默认设置值0，即高电平触发捕获。
从模式控制寄存器（TIMx_ SMCR）
TIM2/TIM3/TIM4/TIM5的从模式控制寄存器，该寄存器用于配置从模式，以及定时器的触发源相关的设置。TIMx_SMCR寄存器描述如图21.5.1.3所示：



图21.5.1.3 TIMx_SMCR寄存器
8 \2 d4 a' g; ]+ F+ Q因为我们要让外部引脚脉冲信号作为定时器的时钟源，所以位[2:0]和位16组合的SMS[0:3]，我们设置的值是0111，即外部时钟模式1。位[6:4] 和位[21:20]组合的TS[0:5]是触发选择设置，TIMx_CH1对应TI1FP1，TIMx_CH2则对应TI2FP2，我们是定时器通道1，所以需要配置的值为00101。ETF[3:0]和ETPS[1:0]分别是外部触发滤波器和外部触发预分频器，我们没有用到。
接下来我们再看看DMA/中断使能寄存器：TIMx_DIER，该寄存器的各位描述见图21.2.1.3（在21.2.1小节）。本本实验，我们需要用到定时器更新中断，在中断服务函数中累加定时器溢出的次数，所以需要使能定时器的更新中断，即UIE置1。
控制寄存器1：TIMx_CR1，我们只用到了它的最低位，也就是用来使能定时器的。

21.5.2 硬件设计
1.例程功能
使用TIM2_CH1做输入捕获，我们将捕获PA0上的高电平脉宽，并对脉宽进行计数，通过串口打印出来。大家可以通过按WK_UP按键，输入高电平脉冲，通过按KEY0重设当前计数。LED0闪烁，提示程序运行。
2.硬件资源
) i0 B/ u# I3 u; ]7 m* t7 S1）RGB灯
( f; C  h% Q6 t1 M% CRED : LED0 - PB4
3）独立按键：
: y( t" i* u) V5 j6 E2 R+ eKEY0 - PA1
WK_UP - PA0
7 ^+ h5 z- v! N1 g/ C5 E0 m3）定时器2，使用TIM2通道1，PA0复用为TIM2_CH1。
3.原理图
定时器属于STM32H750的内部资源，只需要软件设置好即可正常工作。我们借助WK_UP做输入脉冲源，捕获PA0上的高电平脉宽，然后对脉宽进行计数并通过串口上位机打印出来。还可以通过按KEY0重设当前计数。
+ `- x( Z' Z% G1 E4 }$ y
21.5.3 程序设计
( A* B" T8 i; {( b; j# F& C  W$ f21.5.3.1 定时器的HAL库驱动
* [  F. p$ t9 u0 b2 K. K定时器在HAL库中的驱动代码在前面已经介绍了部分，这里我们针对定时器从模式介绍HAL_TIM_SlaveConfigSynchronization函数。
HAL_TIM_SlaveConfigSynchronization函数
/ ~+ m. E  T; H- H8 @' ~该函数是HAL_TIM_SlaveConfigSynchro函数的宏定义，真正的函数定义是后者，其定义如下：
HAL_StatusTypeDef HAL_TIM_SlaveConfigSynchro(TIM_HandleTypeDef *htim,
TIM_SlaveConfigTypeDef *sSlaveConfig);
函数描述：
该函数用于配置定时器的从模式选择、输入触发源等参数。
* C( O9 y$ y# E) p9 b3 c7 D函数形参：
形参1是TIM_HandleTypeDef结构体类型指针变量，用于配置定时器基本参数。
  L7 [" U, E: P# R7 e  h形参2是TIM_SlaveConfigTypeDef结构体类型指针变量，用于配置定时器的从模式。
重点了解一下TIM_SlaveConfigTypeDef结构体指针类型，其定义如下：
2 `+ C* J  t) ~

1. typedef struct
   * k5 A$ W# j( _0 l  h4 ~2 O
2. {
   
3.   uint32_t SlaveMode;                       /* 从模式选择 */
   
4.   uint32_t InputTrigger;               /* 输入触发源选择 */
   
5.   uint32_t TriggerPolarity;           /* 输入触发极性 */
   
6.   uint32_t TriggerPrescaler;          /* 输入触发预分频 */
   * k, z. ^0 L  }4 s1 q7 Y
7.   uint32_t TriggerFilter;                   /* 输入滤波器设置 */
   
8. } TIM_SlaveConfigTypeDef;

复制代码

0 T) g2 C- H$ }( \函数返回值：
HAL_StatusTypeDef枚举类型的值。
定时器从模式脉冲计数配置步骤
9 i' R! O) e) m" \! E8 \; R1）开启TIMx和输入通道的GPIO时钟，配置该IO口的复用功能输入
4 L5 B+ b8 j" Z) |首先开启TIMx的时钟，然后配置GPIO为复用功能输出。本实验我们默认用到定时器2通道1，对应IO是PA0，它们的时钟开启方法如下：
__HAL_RCC_TIM2_CLK_ENABLE(); /* 使能定时器2 /
__HAL_RCC_GPIOA_CLK_ENABLE(); / 开启GPIOA时钟 */
, [. \; ]" \  `+ _* s8 EIO口复用功能是通过函数HAL_GPIO_Init来配置的。
2）初始化TIMx，设置TIMx的ARR和PSC等参数
使用定时器的输入捕获功能时，我们调用的是HAL_TIM_IC_Init函数来初始化定时器ARR和PSC等参数。
5 ]! C6 h( ~" ]. R4 a注意：该函数会调用：HAL_TIM_IC_MspInit函数，我们可以通过后者存放定时器和GPIO时钟使能、GPIO初始化、中断使能和优先级设置等代码。
3）选择从模式：外部触发模式1
. R' f% G6 }8 P$ K' k# lTIMx_SMCR寄存器控制着定时器的从模式，包括模式选择，触发源选择、极性和输入预分频等。HAL库是通过HAL_TIM_SlaveConfigSynchro函数来初始化定时器从模式配置参数的。
4）设置定时器为输入捕获模式，开启输入捕获
( ^: D4 C, W+ ?2 b0 }: T2 v4 [$ r- Z- V在HAL库中，定时器的输入捕获模式是通过HAL_TIM_IC_ConfigChannel函数来设置定时器某个通道为输入捕获通道，包括映射关系，输入滤波和输入分频等。
) s, l: f5 X1 y! L/ W! v9 y5）使能定时器更新中断，开启捕获功能，配置定时器中断优先级
0 [; i. ?. [* U' u+ b' s" {通过__HAL_TIM_ENABLE_IT函数使能定时器更新中断。
通过HAL_TIM_IC_Start函数使能定时器并开启捕获功能。
, p/ |' ?3 l+ p6 v通过HAL_NVIC_EnableIRQ函数使能定时器中断。
通过HAL_NVIC_SetPriority函数设置中断优先级。
" l" r) e/ b/ l* ~+ S# [8 T6）编写中断服务函数
定时器中断服务函数为：TIMx_IRQHandler等，当发生中断的时候，程序就会执行中断服务函数。HAL库提供了一个定时器中断公共处理函数HAL_TIM_IRQHandler，该函数会根据中断类型调用相关的中断回调函数。用户根据自己的需要重定义这些中断回调函数来处理中断程序。本实验我们不使用HAL库的中断回调机制，而是把中断程序写在定时器中断服务函数里。详见本实验例程源码。
: n. j1 }- g/ n! m2 d
21.5.3.2 程序流程图
/ g8 o5 X9 \) V$ e9 R
9 Y  e5 }$ Y# G
6 e$ ~7 o% L' I/ u: s: W0 ?
图21.5.3.2.1 通用定时器脉冲计数实验程序流程图

7 N0 L0 I4 D" {1 R0 D+ r/ Q  Y21.5.3.3 程序解析
! o' |' A( {8 N, m; I' G+ _2 k( }9 i这里我们只讲解核心代码，详细的源码请大家参考光盘本实验对应源码。通用定时器驱动源码包括两个文件：gtim.c和gtim.h。
首先看gtim.h头文件的几个宏定义：
/*****************************************************************************/
% i& ]0 Y8 R9 X2 }) t) s" g/* TIMX 输入计数定义

这里的输入计数使用定时器TIM2_CH1,捕获WK_UP按键的输入
默认是针对TIM2~TIM5, TIM12~TIM17.只有CH1和CH2通道可以用做输入计数,CH3/CH4不支持!
5 m# }8 |# x) \& d注意: 修改这9个宏定义,可以支持TIM1~TIM17任意一个定时器,CH1/CH2对应IO口做输入计数
特别要注意:默认用的PA0,设置的是下拉输入!如果改其他IO,对应的上下拉方式/AF功能等也得改!

1. /
   
2. #define GTIM_TIMX_CNT_CHY_GPIO_PORT      GPIOA
   
3. #define GTIM_TIMX_CNT_CHY_GPIO_PIN       GPIO_PIN_0
   
4. #define GTIM_TIMX_CNT_CHY_GPIO_AF        GPIO_AF1_TIM2               /* AF功能选择 */
   
5. #define GTIM_TIMX_CNT_CHY_GPIO_CLK_ENABLE()   
   # E4 o* l/ q0 y' }
6. do{ __HAL_RCC_GPIOA_CLK_ENABLE(); }while(0)         /* PA口时钟使能 */
   
7. 
   
8. #define GTIM_TIMX_CNT                       TIM2
   
9. #define GTIM_TIMX_CNT_IRQn                 TIM2_IRQn
   
10. #define GTIM_TIMX_CNT_IRQHandler          TIM2_IRQHandler
    , v* ?% E- v8 Q3 @% T7 G2 i
11. #define GTIM_TIMX_CNT_CHY                  TIM_CHANNEL_1    /* 通道Y,  1<= Y <=2 */
    ) a8 O, R0 Z7 q$ E7 Z
12. #define GTIM_TIMX_CNT_CHY_CLK_ENABLE()     
    
13.     do{ __HAL_RCC_TIM2_CLK_ENABLE(); }while(0) /* TIMX 时钟使能 */
      v: h% j# O+ I; i5 H4 S/ x
14. /*****************************************************************************/

复制代码

: S5 `. e1 ~9 H* A可以把上面的宏定义分成两部分，第一部分是定时器2输入通道1对应的IO口的宏定义，第二部分则是定时器2输入通道1的相应宏定义。需要注意的点是：只有CH1和CH2通道可以用做输入计数，CH3/CH4不支持!
5 N4 l6 Y( J: Z3 \( X, V- ]  xgtim.h头文件就添加了这部分的程序，下面看gtim.c的程序，首先是通用定时器脉冲计数初始化函数，其定义如下：

4 ]+ V; n5 t+ g% C& X

1. /**
   
2. * @brief       通用定时器TIMX 通道Y 脉冲计数 初始化函数
   
3. * @note
   
4. *              本函数选择通用定时器的时钟选择: 外部时钟源模式1(SMS[2:0] = 111)
   
5. *              计数器时钟源就来自 TIMX_CH1/CH2, 可以实现外部脉冲计数(脉冲接入CH1/CH2)
   # s3 o! T3 |. q5 Y) q7 v) }& t6 g
6. *
   
7. *              时钟分频数 = psc, 一般设置为0, 表示每一个时钟都会计数一次, 以提高精度.
     _: _, `8 |/ e. U1 E/ b$ ]
8. *              通过读取CNT和溢出次数, 经过简单计算, 可以得到当前的计数值, 从而实现脉冲计数
   
9. *
   ; q0 R( a" d' `# ]9 i
10. * @param       arr: 自动重装值
    
11. * @retval      无
    0 e! O/ ?/ a" j2 \" }6 [% K
12. */
    5 F: G' `+ Y, e1 m* y
13. void gtim_timx_cnt_chy_init(uint16_t psc)
    
14. {
    
15.     GPIO_InitTypeDef gpio_init_struct;
    
16.     TIM_SlaveConfigTypeDef tim_slave_config = {0};
    4 k8 \9 O+ Y3 X$ N
17.     GTIM_TIMX_CNT_CHY_CLK_ENABLE();                           /* 使能TIMx时钟 */
    
18.     GTIM_TIMX_CNT_CHY_GPIO_CLK_ENABLE();                     /* 开启GPIOA时钟 */
    
19. 
    
20.     g_timx_cnt_chy_handle.Instance = GTIM_TIMX_CNT;       /* 定时器x */
    9 ~2 m! j5 c* J% B( U
21.     g_timx_cnt_chy_handle.Init.Prescaler = psc;            /* 定时器分频 */
    ( B8 |6 H- v  V% F; Q) x; ^! H
22.     g_timx_cnt_chy_handle.Init.CounterMode = TIM_COUNTERMODE_UP;/* 递增计数模式 */
    
23.     g_timx_cnt_chy_handle.Init.Period = 65535;             /* 自动重装载值 */
    6 {% k6 H  U" Q9 d8 x. M
24.     HAL_TIM_IC_Init(&g_timx_cnt_chy_handle);
    4 ]% V2 v  H0 P: I6 V
25. 
    ( g$ \% S1 h, I
26.     gpio_init_struct.Pin = GTIM_TIMX_CNT_CHY_GPIO_PIN;   /* 输入捕获的GPIO口 */
    
27.     gpio_init_struct.Mode = GPIO_MODE_AF_PP;               /* 复用推挽输出 */
    2 j6 e& w) I1 P
28.     gpio_init_struct.Pull = GPIO_PULLDOWN;                 /* 下拉 */
    ( n) l! |8 a" t2 ?$ o2 i, n
29.     gpio_init_struct.Speed = GPIO_SPEED_FREQ_VERY_HIGH; /* 高速 */
    
30.     gpio_init_struct.Alternate = GTIM_TIMX_CNT_CHY_GPIO_AF; /* 复用 */
    7 b- _& _5 X  E8 {
31.     HAL_GPIO_Init(GTIM_TIMX_CNT_CHY_GPIO_PORT, &gpio_init_struct);
    
32. 
    
33.     /* 从模式：外部触发模式1 */
    
34.     tim_slave_config.SlaveMode = TIM_SLAVEMODE_EXTERNAL1;/* 外部触发模式1 */
    ' n2 ^* \9 T# I! n# C* n: d
35.     tim_slave_config.InputTrigger = TIM_TS_TI1FP1;/* TI1FP1作为触发输入源 */
    
36.     tim_slave_config.TriggerPolarity = TIM_TRIGGERPOLARITY_RISING;/* 上升沿 */
    / ^( ~0 n: |& e( O  d! z
37.     tim_slave_config.TriggerPrescaler = TIM_TRIGGERPRESCALER_DIV1;/* 不分频 */
    : w# D3 o4 P: z0 i; l! }- I/ g
38.     tim_slave_config.TriggerFilter = 0x0;          /* 滤波：本例中不需要任何滤波 */
    ) ]; \% h3 K5 q8 i
39. HAL_TIM_SlaveConfigSynchronization(&g_timx_cnt_chy_handle,
    
40. &tim_slave_config);
    / F, C/ \, x. E' Z3 ^
41. /* 设置中断优先级，抢占优先级1，子优先级3 */
    . j2 {, a9 P8 I* P
42.     HAL_NVIC_SetPriority(GTIM_TIMX_CNT_IRQn, 1, 3);                        
    
43.     HAL_NVIC_EnableIRQ(GTIM_TIMX_CNT_IRQn);           /* 开启ITMx中断 */
    
44. 
    % g6 N9 M8 Q/ |% b9 H7 Z! o
45.     __HAL_TIM_ENABLE_IT(&g_timx_cnt_chy_handle, TIM_IT_UPDATE); /* 使能更新中断 */
    " l7 M! {, {% q
46.     HAL_TIM_IC_Start(&g_timx_cnt_chy_handle, GTIM_TIMX_CNT_CHY);/* 使能通道输入 */
    0 x( z# R: ~1 X" j' X0 ?
47. }

复制代码

gtim_timx_cnt_chy_init函数包含了输入通道对应IO的初始代码、NVIC、使能时钟、定时器基础工作参数和从模式配置的所有代码。下面来看看该函数的代码内容。
第一部分使能定时器和GPIO的时钟。
6 w8 o" X! R$ P) A- W; _4 T第二部分调用HAL_TIM_IC_Init函数初始化定时器的基础工作参数，如：ARR和PSC等。
/ ]6 G- s* }5 A8 ?1 b. [第三部分是定时器输入通道对应的IO的初始化。
第四部分调用HAL_TIM_SlaveConfigSynchronization函数配置从模式选择、输入捕获通道映射关系、捕获边沿和滤波等。
" z3 d& D/ G  `/ U$ ^第五部分是NVIC的初始化，配置抢占优先级、响应优先级和开启NVIC定时器中断。
最后是使能更新中断和使能通道输入。
我们在通用定时器输入捕获实验使用了HAL_TIM_IC_MspInit函数，为了方便代码的管理和移植性等，这里就不再使用这个函数了。当一个项目使用到多个定时器时，也同样建议大家不要使用HAL库的回调机制，真的不方便。至于前面为什么要用HAL_TIM_IC_MspInit函数，只是为了让大家知道HAL库回调机制的使用方法。大家可以根据自己的情况权衡利弊，决定是否使用HAL库的回调机制。
下面先看中断服务函数，在基本定时器中断实验中，我们知道中断逻辑程序的逻辑代码是放在更新中断回调函数里面的，这是HAL库回调机制标准的做法。因为我们在通用定时器输入捕获实验中使用过HAL_TIM_PeriodElapsedCallback更新中断回调函数，所以本实验我们不使用HAL库这套回调机制，而是直接将中断处理写在定时器中断服务函数中，定时器中断服务函数定义如下：
# `: ^. E- I( ]; S) t4 H

1. /**
   , N( _, j2 D% i2 o8 b2 j- M
2. * @brief       通用定时器TIMX 脉冲计数 更新中断服务函数
   & Z* O# u! h5 F' E( M5 F. y( d
3. * @param       无
   
4. * @retval      无
   7 V' i, H" X* A, ^0 e* \7 L9 D( m
5. */
   $ c$ v8 q& m* f2 w" A
6. void GTIM_TIMX_CNT_IRQHandler(void)
   
7. {
   
8.     /* 以下代码没有使用定时器HAL库共用处理函数来处理，而是直接通过判断中断标志位的方式 */
   
9.     if(__HAL_TIM_GET_FLAG(&g_timx_cnt_chy_handle, TIM_FLAG_UPDATE) != RESET)
   
10.     {
    3 Z( N1 q- w* A* w7 W
11.         g_timxchy_cnt_ofcnt++;          /* 累计溢出次数 */
    ( L5 ]# h6 S4 o: }& b  E! K
12.     }
    0 {1 c) {; |& H+ j: R
13. 
    
14.     __HAL_TIM_CLEAR_IT(&g_timx_cnt_chy_handle, TIM_IT_UPDATE);
    ( i" w  X+ ?2 ~  T0 r! ?- r. _
15. }

复制代码

在函数中，使用__HAL_TIM_GET_FLAG函数宏获取更新更新中断标志位，然后判断是否发生更新中断，如果发生了更新中断，表示脉冲计数的个数等于ARR寄存器的值，那么我们让g_timxchy_cnt_ofcnt变量++，累计定时器溢出次数。最后调用__HAL_TIM_CLEAR_IT函数宏清除更新中断标志位。这样就完成一次对更新中断的处理。
再来介绍两个自定义的功能函数，第一个是获取当前计数值函数，其定义如下：
  L9 }& F7 s6 @1 d3 J' `

1. /**
   ) Z2 h: j! j  u. q4 B! s% h) x
2. * @brief       通用定时器TIMX 通道Y 获取当前计数值
   
3. * @param       无
   
4. * @retval      当前计数值
   
5. */
   6 C* [1 ?* w0 ^4 d
6. uint32_t gtim_timx_cnt_chy_get_count(void)
   * p: k( p( U& e/ }! [0 Z4 z
7. {
   
8.     uint32_t count = 0;
   
9.     count = g_timxchy_cnt_ofcnt * 65536;/* 计算溢出次数对应的计数值 */
   5 {1 w9 J- y) @7 [+ ?
10.     count += __HAL_TIM_GET_COUNTER(&g_timx_cnt_chy_handler);/* 加上当前CNT的值 */
    # N. `5 Q& h4 L
11.     return count;
    5 i) w$ o: l* Y1 U. J
12. }

复制代码

该函数先是计算定时器溢出次数对应的计数个数，因为定时器每溢出一次的计数个数是65536，所以这里用g_timxchy_cnt_ofcnt乘以65536，就可以得到溢出计数的个数，前提是ARR寄存器的值得设置为65535。然后再加上定时器计数器当前的值，计数器当前的值通过调用__HAL_TIM_GET_COUNTER函数宏可以获取。函数返回值是脉冲计数的总个数。
第二个自定义功能函数是重启计数器函数，其定义如下：

1. /**
   0 {1 o5 ^- R0 r* A/ X% T
2. * @brief       通用定时器TIMX 通道Y 重启计数器
   
3. * @param       无
   
4. * @retval      当前计数值
   7 d5 d+ W" I( G  Q0 U9 ]
5. */
   
6. void gtim_timx_cnt_chy_restart(void)
   / s! Z( T- t6 V% l7 P
7. {
   * r2 ]1 j: @( o8 q: q9 c# B
8.     __HAL_TIM_DISABLE(&g_timx_cnt_chy_handler);                   /* 关闭定时器TIMX */
   
9.     g_timxchy_cnt_ofcnt = 0;                                          /* 累加器清零 */
   
10.     __HAL_TIM_SET_COUNTER(&g_timx_cnt_chy_handler, 0);           /* 计数器清零 */
    % S- e& `% T" x6 {$ u5 V9 X
11.     __HAL_TIM_ENABLE(&g_timx_cnt_chy_handler);                          /* 使能定时器TIMX */
    
12. }

复制代码

该函数先关闭定时器，然后做清零操作，包括：记录溢出次数全局变量g_timxchy_cnt_ofcnt和定时器计数器的值，最后使能定时器重新计数。
通用定时器脉冲计数实验的整体驱动和逻辑程序还算比较容易理解，下面看看main.c里面编写的代码：
- `. G- v. [8 r9 W

1. int main(void)
   + X7 q' H* n, z; z& M
2. {
   $ M6 n: I7 Z- y. g/ o
3.     uint32_t curcnt = 0;
   
4.     uint32_t oldcnt = 0;
   
5.     uint8_t key = 0;
   9 X; Q7 ~; q, y& k' y+ N# R7 x
6.     uint8_t t = 0;
   * f, h4 s, y5 N6 G3 ?, j* q
7.     sys_cache_enable();                            /* 打开L1-Cache */
   
8.     HAL_Init();                                      /* 初始化HAL库 */
   
9.     sys_stm32_clock_init(240, 2, 2, 4);         /* 设置时钟, 480Mhz */
   
10.     delay_init(480);                                /* 延时初始化 */
    1 F2 q# l$ a, p9 _% Q/ [$ q8 ^! u
11.     usart_init(115200);                            /* 串口初始化为115200 */
    5 _# v, e9 T( j" R  t- H8 g
12.     led_init();                                             /* 初始化LED */
    - t' L" M4 s$ Q8 l/ |; \
13.     key_init();                                             /* 初始化按键 */
    
14.     gtim_timx_cnt_chy_init(0);                           /* 定时器计数初始化, 不分频 */
    ' Z( n) R, d/ m% N+ X- l; v
15.     gtim_timx_cnt_chy_restart();                        /* 重启计数 */
    
16.     while (1)
    
17.     {
    
18.         key = key_scan(0);       /* 扫描按键 */
    2 ~% A7 Z9 P9 }6 Y/ L
19.         if (key == KEY0_PRES)   /* KEY0按键按下,重启计数 */
    
20.         {
    : x5 E% @! a$ {. R5 o0 C9 Z
21.             gtim_timx_cnt_chy_restart();                  /* 重新启动计数 */
    
22.         }
    
23.         curcnt = gtim_timx_cnt_chy_get_count(); /* 获取计数值 */
    : C6 J* |6 `$ m
24.         if (oldcnt != curcnt)
    % B- w* G0 M9 j
25.         {
    
26.             oldcnt = curcnt;
    0 F! _" _4 k! z1 W2 C9 k4 i/ l, p. P
27.             printf("CNT:%d\r\n", oldcnt);               /* 打印脉冲个数 */
    : t5 D- m5 Z  o  {6 f- m3 J
28.         }
    7 ?: k% t$ d: r. q* Z) Y
29.         t++;
    . H6 J1 ~. r( ~' b3 l8 H+ X. t3 k6 R
30.         if (t > 20)                 /* 200ms进入一次 */
    7 K! p- |' d- o; Y8 H, U
31.         {
    . i) L" x6 r9 G/ I! g0 @- U
32.             t = 0;
    , Y* I  r, u& j7 V5 p/ x0 E8 k* n% Q  V
33.             LED0_TOGGLE();          /* LED0闪烁 ,提示程序运行 */
    ( F& b: D9 f+ O# e' O/ v
34.         }
    
35.         delay_ms(10);
    
36.     }
    
37. }
    

复制代码

2 `2 R3 E+ ]* R调用定时器初始化函数gtim_timx_cnt_chy_init(0)，形参是0，表示设置预分频器寄存器的值为0，即表示不分频。如果形参设置为1，就是2分频，这种情况，要按按键WK_UP两次才会计数一次，大家不妨试试。该函数内部已经设置自动重载寄存器的值为65535，所以在不分频的情况下，定时器发生一次更新中断，表示脉冲计数了65536次。

$ T+ D3 o9 m4 f' k  T21.5.4 下载验证
下载代码后，可以看到LED0在闪烁，说明程序已经正常在跑了，我们再打开串口调试助手，然后每按KEY_UP按键一次，就可以看到串口打印的高电平脉冲次数。如果按KEY0按键，就会重设当前计数，从0开始计数，如图21.5.4.1所示：
2 j7 G* n$ A. a


" e( m+ |& |! \" _+ F- Q. ~图21.5.4.1 打印高电平脉冲次数
5 e2 v) S( p5 g, m( b+ `————————————————
版权声明：正点原子
) S# ?/ V+ r! S: c" C
7 K, }. \! Y" }5 T5 S# v- ]
  q, ~( n: j% `0 y# @