第017例：TIM-通用定时器呼吸灯

【HAL库每天一例】系列例程从今天开始持续更新。
我们将坚持每天至少发布一个基于YS-F1Pro开发板的HAL库例程，
该系列例程将带领大家从零开始使用HAL库，后面会持续添加模块应用例程。
同样的，我们还程序发布基于HAL库的指导文档和视频教程，欢迎持续关注，并提出改进意见。
例程下载：
资料包括程序、相关说明资料以及软件使用截图
链接：http://pan.baidu.com/s/1i574oPv
密码：r3s3
（硬石YS-F1Pro开发板HAL库例程持续更新\1. 软件设计之基本裸机例程(HAL库版本)\YSF1_HAL-017. TIM-通用定时器呼吸灯）

/**
  ******************************************************************************
  *                           硬石YS-F1Pro开发板例程功能说明
  *
  *  例程名称: YSF1_HAL-017. TIM-通用定时器呼吸灯
  *   
  ******************************************************************************
  * 说明：
  * 本例程配套硬石stm32开发板YS-F1Pro使用。
  *
  * 淘宝：
  * 论坛：http://www.ing10bbs.com
  * 版权归硬石嵌入式开发团队所有，请勿商用。
  ******************************************************************************
  */
【1】例程简介
  系统滴答定时器一般用来提供“心跳”作用，而STM32定时器最基本功能也是定时，可以设置不同
时间长度的定时。定时器除了最基本的定时功能外，定时器与GPIO有挂钩使得它可以发挥强大的作用，
比如可以输出不同频率、不同占空比的方波信号、PWM信号，同时做为输入捕获功能时，可以测量脉冲
宽度、实现电容按键检测等等。
  STM32F103ZET6总共有8个定时器，TIM1和TIM8是高级控制定时器，TIM2、3、4、5是通用定时器，
TIM6和TIM7是基本定时器。
本例程使用通用定时器产生PWM信号，不断改变占空比，使得输出通道产生类正弦波图像，接在LED灯
上实现呼吸灯效果。
【2】跳线帽情况
******* 为保证例程正常运行，必须插入以下跳线帽 **********
丝印编号     IO端口      目标功能引脚        出厂默认设置
  
【3】操作及现象
  使用开发板配套的MINI USB线连接到开发板标示“调试串口”字样的MIMI USB接口用于为开发板
提供电源。下载完程序之后，可观察到LED1灯是个呼吸灯效果。
/******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/

bsp_GeneralTIM.h文件内容：

1. #ifndef __GENERAL_TIM_H__
   
2. #define __GENERAL_TIM_H__
   
3. 
   
4. /* 包含头文件 ----------------------------------------------------------------*/
   
5. #include "stm32f1xx_hal.h"
   
6. 
   
7. /* 类型定义 ------------------------------------------------------------------*/
   
8. /* 宏定义 --------------------------------------------------------------------*/
   
9. #define GENERAL_TIMx                        TIM3
   
10. #define GENERAL_TIM_RCC_CLK_ENABLE()        __HAL_RCC_TIM3_CLK_ENABLE()
    
11. #define GENERAL_TIM_RCC_CLK_DISABLE()       __HAL_RCC_TIM3_CLK_DISABLE()
    
12. #define GENERAL_TIM_GPIO_RCC_CLK_ENABLE()   __HAL_RCC_GPIOB_CLK_ENABLE();
    
13. 
    
14. #define GENERAL_TIM_CH3_PORT                GPIOB
    
15. #define GENERAL_TIM_CH3_PIN                 GPIO_PIN_0
    
16. 
    
17. #define GENERAL_TIM_IRQn                    TIM3_IRQn
    
18. #define GENERAL_TIM_IRQHANDLER              TIM3_IRQHandler
    
19. 
    
20. // 定义定时器预分频，定时器实际时钟频率为：72MHz/（GENERAL_TIMx_PRESCALER+1）
    
21. #define GENERAL_TIM_PRESCALER               1999  // 实际时钟频率为：36kHz
    
22. 
    
23. // 定义定时器周期，当定时器开始计数到GENERAL_TIMx_PERIOD值是更新定时器并生成对应事件和中断
    
24. #define GENERAL_TIM_PERIOD                  255
    
25. 
    
26. /* 扩展变量 ------------------------------------------------------------------*/
    
27. extern TIM_HandleTypeDef htimx;
    
28. extern uint8_t indexWave[];
    
29. 
    
30. /* 函数声明 ------------------------------------------------------------------*/
    
31. void GENERAL_TIMx_Init(void);
    
32. 
    
33. #endif        /* __GENERAL_TIM_H__ */
    
34. /******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/
    

复制代码

bsp_GeneralTIM.c文件内容：

1. /**
   
2.   ******************************************************************************
   
3.   * 文件名程: bsp_GeneralTIM.c
   
4.   * 作    者: 硬石嵌入式开发团队
   
5.   * 版    本: V1.0
   
6.   * 编写日期: 2015-10-04
   
7.   * 功    能: 通用定时器底层驱动程序
   
8.   ******************************************************************************
   
9.   * 说明：
   
10.   * 本例程配套硬石stm32开发板YS-F1Pro使用。
    
11.   *
    
12.   * 淘宝：
    
13.   * 论坛：http://www.ing10bbs.com
    
14.   * 版权归硬石嵌入式开发团队所有，请勿商用。
    
15.   ******************************************************************************
    
16.   */
    
17. /* 包含头文件 ----------------------------------------------------------------*/
    
18. #include "GeneralTIM/bsp_GeneralTIM.h"
    
19. 
    
20. /* 私有类型定义 --------------------------------------------------------------*/
    
21. /* 私有宏定义 ----------------------------------------------------------------*/
    
22. /* 私有变量 ------------------------------------------------------------------*/
    
23. TIM_HandleTypeDef htimx;
    
24. 
    
25. /* LED亮度等级 PWM表 */
    
26. uint8_t indexWave[] = {1,1,2,2,3,4,6,8,10,14,19,25,33,44,59,80,107,143,191,255,
    
27.                        255,191,143,107,80,59,44,33,25,19,14,10,8,6,4,3,2,2,1,1};
    
28. 
    
29. /* 扩展变量 ------------------------------------------------------------------*/
    
30. /* 私有函数原形 --------------------------------------------------------------*/
    
31. /* 函数体 --------------------------------------------------------------------*/
    
32. /**
    
33.   * 函数功能: 定时器硬件初始化配置
    
34.   * 输入参数: htim：定时器句柄类型指针
    
35.   * 返 回 值: 无
    
36.   * 说    明: 该函数被GENERAL_TIMx_Init函数调用
    
37.   */
    
38. void HAL_TIM_MspPostInit(TIM_HandleTypeDef* htim)
    
39. {
    
40.   GPIO_InitTypeDef GPIO_InitStruct;
    
41.   if(htim->Instance==GENERAL_TIMx)
    
42.   {  
    
43.     /* 定时器通道功能引脚端口时钟使能 */
    
44.     GENERAL_TIM_GPIO_RCC_CLK_ENABLE();
    
45. 
    
46.     /* 定时器通道3功能引脚IO初始化 */
    
47.     GPIO_InitStruct.Pin = GENERAL_TIM_CH3_PIN;
    
48.     GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
    
49.     GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
    
50.     HAL_GPIO_Init(GENERAL_TIM_CH3_PORT, &GPIO_InitStruct);
    
51.   }
    
52. }
    
53. 
    
54. /**
    
55.   * 函数功能: 通用定时器初始化并配置通道PWM输出
    
56.   * 输入参数: 无
    
57.   * 返 回 值: 无
    
58.   * 说    明: 无
    
59.   */
    
60. void GENERAL_TIMx_Init(void)
    
61. {
    
62.   TIM_ClockConfigTypeDef sClockSourceConfig;
    
63.   TIM_MasterConfigTypeDef sMasterConfig;
    
64.   TIM_OC_InitTypeDef sConfigOC;
    
65.   
    
66.   htimx.Instance = GENERAL_TIMx;
    
67.   htimx.Init.Prescaler = GENERAL_TIM_PRESCALER;
    
68.   htimx.Init.CounterMode = TIM_COUNTERMODE_UP;
    
69.   htimx.Init.Period = GENERAL_TIM_PERIOD;
    
70.   htimx.Init.ClockDivision=TIM_CLOCKdivISION_div1;
    
71.   HAL_TIM_Base_Init(&htimx);
    
72. 
    
73.   sClockSourceConfig.ClockSource = TIM_CLOCKSOURCE_INTERNAL;
    
74.   HAL_TIM_ConfigClockSource(&htimx, &sClockSourceConfig);
    
75. 
    
76.   sMasterConfig.MasterOutputTrigger = TIM_TRGO_RESET;
    
77.   sMasterConfig.MasterSlaveMode = TIM_MASTERSLAVEMODE_DISABLE;
    
78.   HAL_TIMEx_MasterConfigSynchronization(&htimx, &sMasterConfig);
    
79.   
    
80.   sConfigOC.OCMode = TIM_OCMODE_PWM1;
    
81.   sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH;
    
82.   sConfigOC.OCFastMode = TIM_OCFAST_DISABLE;
    
83.   sConfigOC.Pulse = indexWave[0];
    
84.   HAL_TIM_PWM_ConfigChannel(&htimx, &sConfigOC, TIM_CHANNEL_3);
    
85. 
    
86.   HAL_TIM_MspPostInit(&htimx);
    
87. }
    
88. 
    
89. /**
    
90.   * 函数功能: 基本定时器硬件初始化配置
    
91.   * 输入参数: htim_base：基本定时器句柄类型指针
    
92.   * 返 回 值: 无
    
93.   * 说    明: 该函数被HAL库内部调用
    
94.   */
    
95. void HAL_TIM_Base_MspInit(TIM_HandleTypeDef* htim_base)
    
96. {
    
97. 
    
98.   if(htim_base->Instance==GENERAL_TIMx)
    
99.   {
    
100.     /* 基本定时器外设时钟使能 */
     
101.     GENERAL_TIM_RCC_CLK_ENABLE();
     
102.    
     
103.     /* 配置定时器中断优先级并使能 */
     
104.     HAL_NVIC_SetPriority(GENERAL_TIM_IRQn, 0, 0);
     
105.     HAL_NVIC_EnableIRQ(GENERAL_TIM_IRQn);
     
106.   }
     
107. }
     
108. 
     
109. /**
     
110.   * 函数功能: 基本定时器硬件反初始化配置
     
111.   * 输入参数: htim_base：基本定时器句柄类型指针
     
112.   * 返 回 值: 无
     
113.   * 说    明: 该函数被HAL库内部调用
     
114.   */
     
115. void HAL_TIM_Base_MspDeInit(TIM_HandleTypeDef* htim_base)
     
116. {
     
117. 
     
118.   if(htim_base->Instance==GENERAL_TIMx)
     
119.   {
     
120.     /* 基本定时器外设时钟禁用 */
     
121.     GENERAL_TIM_RCC_CLK_DISABLE();
     
122.     /* 禁用定时器中断 */
     
123.     HAL_NVIC_DisableIRQ(GENERAL_TIM_IRQn);
     
124.   }
     
125. }
     
126. /******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/
     

复制代码

这个软件不错

HAL库是什么?

ST官方新版本软件库，用来代替标准固件库的