【正点原子STM32连载】第二十二章 高级定时器输出比较模式实验 摘自【正点原子】APM32F407最小系统板使用指南
1）实验平台：正点原子stm32f103战舰开发板V4
2）平台购买地址：https://detail.tmall.com/item.htm?id=609294757420
3）全套实验源码+手册+视频下载地址： http://www.openedv.com/thread-340252-1-1.html#
第二十二章 高级定时器输出比较模式实验
本章将介绍使用APM32F407的高级定时器输出多个频率、占空比相同但相位不同的PWM。通过本章的学习，读者将学习到高级定时器输出比较的匹配时输出翻转模式的使用。
本章分为如下几个小节：
22.1 硬件设计
22.2 程序设计
22.3 下载验证
22.1 硬件设计
22.1.1 例程功能
- 定时器8通道1、2、3、4在匹配时输出翻转模式下分别输出相位为25%、50%、75%、100%，占空比为50%的PWM
- LED0闪烁，指示程序正在运行
22.1.2 硬件资源 - LED
LED0 - PF9 - 定时器8
通道1 - PC6
通道2 - PC7
通道3 - PC8
通道4 - PC9
22.1.3 原理图
本章实验使用的定时器8为APM32F407的片上资源，因此没有对应的连接原理图。
22.2 程序设计
22.2.1 Geehy标准库的TMR驱动
本章实验将使用TMR8的四个通道同时输出频率、占空比相同，但相位不同的4个PWM，其配置方式与第十八章“通用定时器PWM输出实验”中的配置方式基本一致，不同在于第十八章“通用定时器PWM输出实验”中配置输出比较通道为PWM模式1，而本实验要将其配置为“匹配时输出翻转模式”，其具体步骤如下：
①：配置TMR8的自动重装载值和预分频器数值等参数
②：配置TMR8的4个输出比较通道
③：使能TMR8
④：使能TMR8的PWM输出
⑤：使能4个输出比较通道输出
⑥：配置4个输出比较通道的捕获计较寄存器数值
在Geehy标准库中对应的驱动函数如下：
①：配置TMR
请见第16.2.1小节中配置TMR的相关内容。
②：配置输出比较通道
请见第18.2.1小节中配置输出比较通道的相关内容。
③：使能TMR
请见第16.2.1小节中使能TMR的相关内容。
④：使能高级定时器PWM输出
请见第21.2.1小节中使能高级定时器PWM输出的相关内容。
⑤：使能捕获比较通道
请见第18.2.1小节中使能捕获比较通道的相关内容。
⑥：配置捕获比较寄存器数值
该函数用于配置捕获比较寄存器的数值，在匹配时输出翻转模式下，当定时器的计数值与对应通道的捕获比较寄存器数值匹配时，就会翻转对应通道的输出电平，其函数原型如下所示：
void TMR_ConfigCompare1(TMR_T* tmr, uint32_t compare1);
void TMR_ConfigCompare2(TMR_T* tmr, uint32_t compare2);
void TMR_ConfigCompare3(TMR_T* tmr, uint32_t compare3);
void TMR_ConfigCompare4(TMR_T* tmr, uint32_t compare4);
该函数的形参描述，如下表所示：
形参 描述
tmr 指向TMR外设结构体的指针
例如：TMR1、TMR2等（在apm32f4xx.h文件中有定义）
comparen 对应通道的捕获比较寄存器数值
表22.2.1.1 函数TMR_ConfigComparen()形参描述
该函数的返回值描述，如下表所示：
返回值 描述
无 无
表22.2.1.2 函数TMR_ConfigComparen()返回值描述
该函数的使用示例，如下所示：
#include "apm32f4xx.h"
#include "apm32f4xx_tmr.h"
void example_fun(void)
{
/* 配置TMR8的通道1捕获比较寄存器数值为1000 */
TMR_ConfigCompare1(TMR8, 1000);
}
22.2.2 高级定时器驱动
本章实验的高级定时器驱动主要负责向应用层提供高级定时器的初始化函数。本章实验中，高级定时器的驱动代码包括atmr.c和atmr.h两个文件。
高级定时器驱动中，对TMR、GPIO的相关宏定义，如下所示：
#define ATMR_TMRX_COMP TMR8
#define ATMR_TMRX_COMP_CLK_ENABLE() \
do { \
RCM_EnableAPB2PeriphClock(RCM_APB2_PERIPH_TMR8); \
} while (0)
#define ATMR_TMRX_COMP_CH1_GPIO_PORT GPIOC
#define ATMR_TMRX_COMP_CH1_GPIO_PIN GPIO_PIN_6
#define ATMR_TMRX_COMP_CH1_GPIO_PIN_SOURCE GPIO_PIN_SOURCE_6
#define ATMR_TMRX_COMP_CH1_GPIO_AF GPIO_AF_TMR8
#define ATMR_TMRX_COMP_CH1_GPIO_CLK_ENABLE() \
do { \
RCM_EnableAHB1PeriphClock(RCM_AHB1_PERIPH_GPIOC); \
} while (0)
#define ATMR_TMRX_COMP_CH2_GPIO_PORT GPIOC
#define ATMR_TMRX_COMP_CH2_GPIO_PIN GPIO_PIN_7
#define ATMR_TMRX_COMP_CH2_GPIO_PIN_SOURCE GPIO_PIN_SOURCE_7
#define ATMR_TMRX_COMP_CH2_GPIO_AF GPIO_AF_TMR8
#define ATMR_TMRX_COMP_CH2_GPIO_CLK_ENABLE() \
do { \
RCM_EnableAHB1PeriphClock(RCM_AHB1_PERIPH_GPIOC); \
} while (0)
#define ATMR_TMRX_COMP_CH3_GPIO_PORT GPIOC
#define ATMR_TMRX_COMP_CH3_GPIO_PIN GPIO_PIN_8
#define ATMR_TMRX_COMP_CH3_GPIO_PIN_SOURCE GPIO_PIN_SOURCE_8
#define ATMR_TMRX_COMP_CH3_GPIO_AF GPIO_AF_TMR8
#define ATMR_TMRX_COMP_CH3_GPIO_CLK_ENABLE() \
do { \
RCM_EnableAHB1PeriphClock(RCM_AHB1_PERIPH_GPIOC); \
} while (0)
#define ATMR_TMRX_COMP_CH4_GPIO_PORT GPIOC
#define ATMR_TMRX_COMP_CH4_GPIO_PIN GPIO_PIN_9
#define ATMR_TMRX_COMP_CH4_GPIO_PIN_SOURCE GPIO_PIN_SOURCE_9
#define ATMR_TMRX_COMP_CH4_GPIO_AF GPIO_AF_TMR8
#define ATMR_TMRX_COMP_CH4_GPIO_CLK_ENABLE() \
do { \
RCM_EnableAHB1PeriphClock(RCM_AHB1_PERIPH_GPIOC); \
} while (0)
高级定时器驱动中TMR8的初始化函数，如下所示：
/**
* @brief 初始化高级定时器输出比较模式
* @note 当APB1PSC!=1时，定时器的时钟频率为APB2时钟的2倍
* 因此定时器的时钟频率为168MHz
* 定时器溢出时间计算方法：Tout = ((arr + 1) * (psc + 1)) / TMRxCLK
* TMRxCLK=定时器时钟频率，单位MHz
* @param arr: 自动重装载值
* @param psc: 预分频器数值
* @retval 无
*/
void atmr_tmrx_comp_pwm_init(uint16_t arr, uint16_t psc)
{
GPIO_Config_T gpio_init_struct;
TMR_BaseConfig_T tmr_init_struct;
TMR_OCConfig_T tmr_oc_init_struct;
/* 使能时钟 */
ATMR_TMRX_COMP_CLK_ENABLE(); /* 使能高级定时器时钟 */
ATMR_TMRX_COMP_CH1_GPIO_CLK_ENABLE(); /* 使能输出比较通道1端口时钟 */
ATMR_TMRX_COMP_CH2_GPIO_CLK_ENABLE(); /* 使能输出比较通道2端口时钟 */
ATMR_TMRX_COMP_CH3_GPIO_CLK_ENABLE(); /* 使能输出比较通道3端口时钟 */
ATMR_TMRX_COMP_CH4_GPIO_CLK_ENABLE(); /* 使能输出比较通道4端口时钟 */
/* 配置输出比较通道1输出引脚 */
gpio_init_struct.pin = ATMR_TMRX_COMP_CH1_GPIO_PIN; /* 输出比较通道1输出引脚 */
gpio_init_struct.mode = GPIO_MODE_AF; /* 复用功能模式 */
gpio_init_struct.speed = GPIO_SPEED_100MHz; /* 高速 */
gpio_init_struct.otype = GPIO_OTYPE_PP; /* 推挽输出 */
gpio_init_struct.pupd = GPIO_PUPD_DOWN; /* 下拉 */
GPIO_Config(ATMR_TMRX_COMP_CH1_GPIO_PORT, &gpio_init_struct);
GPIO_ConfigPinAF(ATMR_TMRX_COMP_CH1_GPIO_PORT, /* 配置引脚复用功能 */
ATMR_TMRX_COMP_CH1_GPIO_PIN_SOURCE,
ATMR_TMRX_COMP_CH1_GPIO_AF);
/* 配置输出比较通道2输出引脚 */
gpio_init_struct.pin = ATMR_TMRX_COMP_CH2_GPIO_PIN; /* 输出比较通道2输出引脚 */
gpio_init_struct.mode = GPIO_MODE_AF; /* 复用功能模式 */
gpio_init_struct.speed = GPIO_SPEED_100MHz; /* 高速 */
gpio_init_struct.otype = GPIO_OTYPE_PP; /* 推挽输出 */
gpio_init_struct.pupd = GPIO_PUPD_DOWN; /* 下拉 */
GPIO_Config(ATMR_TMRX_COMP_CH2_GPIO_PORT, &gpio_init_struct);
GPIO_ConfigPinAF(ATMR_TMRX_COMP_CH2_GPIO_PORT, /* 配置引脚复用功能 */
ATMR_TMRX_COMP_CH2_GPIO_PIN_SOURCE,
ATMR_TMRX_COMP_CH2_GPIO_AF);
/* 配置输出比较通道3输出引脚 */
gpio_init_struct.pin = ATMR_TMRX_COMP_CH3_GPIO_PIN; /* 输出比较通道3输出引脚 */
gpio_init_struct.mode = GPIO_MODE_AF; /* 复用功能模式 */
gpio_init_struct.speed = GPIO_SPEED_100MHz; /* 高速 */
gpio_init_struct.otype = GPIO_OTYPE_PP; /* 推挽输出 */
gpio_init_struct.pupd = GPIO_PUPD_DOWN; /* 下拉 */
GPIO_Config(ATMR_TMRX_COMP_CH3_GPIO_PORT, &gpio_init_struct);
GPIO_ConfigPinAF(ATMR_TMRX_COMP_CH3_GPIO_PORT, /* 配置引脚复用功能 */
ATMR_TMRX_COMP_CH3_GPIO_PIN_SOURCE,
ATMR_TMRX_COMP_CH3_GPIO_AF);
/* 配置输出比较通道4输出引脚 */
gpio_init_struct.pin = ATMR_TMRX_COMP_CH4_GPIO_PIN; /* 输出比较通道4输出引脚 */
gpio_init_struct.mode = GPIO_MODE_AF; /* 复用功能模式 */
gpio_init_struct.speed = GPIO_SPEED_100MHz; /* 高速 */
gpio_init_struct.otype = GPIO_OTYPE_PP; /* 推挽输出 */
gpio_init_struct.pupd = GPIO_PUPD_DOWN; /* 下拉 */
GPIO_Config(ATMR_TMRX_COMP_CH4_GPIO_PORT, &gpio_init_struct);
GPIO_ConfigPinAF(ATMR_TMRX_COMP_CH4_GPIO_PORT, /* 配置引脚复用功能 */
ATMR_TMRX_COMP_CH4_GPIO_PIN_SOURCE,
ATMR_TMRX_COMP_CH4_GPIO_AF);
/* 配置高级定时器 */
tmr_init_struct.countMode = TMR_COUNTER_MODE_UP; /* 向上计数 */
tmr_init_struct.clockDivision = TMR_CLOCK_DIV_1; /* 时钟分频系数 */
tmr_init_struct.period = arr; /* 自动重装载值 */
tmr_init_struct.division = psc; /* 预分频器数值 */
tmr_init_struct.repetitionCounter = 0; /* 重复计数数值 */
TMR_ConfigTimeBase(ATMR_TMRX_COMP, &tmr_init_struct); /* 配置高级定时器 */
/* 配置输出比较通道1 */
tmr_oc_init_struct.mode = TMR_OC_MODE_TOGGLE; /* 匹配时输出翻转 */
tmr_oc_init_struct.outputState = TMR_OC_STATE_ENABLE; /* 使能输出 */
tmr_oc_init_struct.polarity = TMR_OC_POLARITY_LOW; /* 低电平有效 */
tmr_oc_init_struct.pulse = (arr + 1) >> 1; /* 有效电平脉宽 */
TMR_ConfigOC1(ATMR_TMRX_COMP, &tmr_oc_init_struct); /* 配置输出比较通道1 */
/* 配置输出比较通道2 */
tmr_oc_init_struct.mode = TMR_OC_MODE_TOGGLE; /* 匹配时输出翻转 */
tmr_oc_init_struct.outputState = TMR_OC_STATE_ENABLE; /* 使能输出 */
tmr_oc_init_struct.polarity = TMR_OC_POLARITY_LOW; /* 低电平有效 */
tmr_oc_init_struct.pulse = (arr + 1) >> 1; /* 有效电平脉宽 */
TMR_ConfigOC2(ATMR_TMRX_COMP, &tmr_oc_init_struct); /* 配置输出比较通道2 */
/* 配置输出比较通道3 */
tmr_oc_init_struct.mode = TMR_OC_MODE_TOGGLE; /* 匹配时输出翻转 */
tmr_oc_init_struct.outputState = TMR_OC_STATE_ENABLE; /* 使能输出 */
tmr_oc_init_struct.polarity = TMR_OC_POLARITY_LOW; /* 低电平有效 */
tmr_oc_init_struct.pulse = (arr + 1) >> 1; /* 有效电平脉宽 */
TMR_ConfigOC3(ATMR_TMRX_COMP, &tmr_oc_init_struct); /* 配置输出比较通道3 */
/* 配置输出比较通道4 */
tmr_oc_init_struct.mode = TMR_OC_MODE_TOGGLE; /* 匹配时输出翻转 */
tmr_oc_init_struct.outputState = TMR_OC_STATE_ENABLE; /* 使能输出 */
tmr_oc_init_struct.polarity = TMR_OC_POLARITY_LOW; /* 低电平有效 */
tmr_oc_init_struct.pulse = (arr + 1) >> 1; /* 有效电平脉宽 */
TMR_ConfigOC4(ATMR_TMRX_COMP, &tmr_oc_init_struct); /* 配置输出比较通道4 */
/* 使能高级定时器和输出比较通道输出 */
TMR_Enable(ATMR_TMRX_COMP); /* 使能高级定时器 */
TMR_EnablePWMOutputs(ATMR_TMRX_COMP); /* 使能PWM主输出 */
TMR_EnableCCxChannel(ATMR_TMRX_COMP, TMR_CHANNEL_1);/* 使能输出比较通道1输出 */
TMR_EnableCCxChannel(ATMR_TMRX_COMP, TMR_CHANNEL_2);/* 使能输出比较通道2输出 */
TMR_EnableCCxChannel(ATMR_TMRX_COMP, TMR_CHANNEL_3);/* 使能输出比较通道3输出 */
TMR_EnableCCxChannel(ATMR_TMRX_COMP, TMR_CHANNEL_4);/* 使能输出比较通道4输出 */
}
从上面的代码中可以看出，虽然因为配置了TMR8的4个通道，导致代码量比较大，但是配置方式基本是与第十八章“通用定时器PWM输出实验”中通用定时器的初始化函数一致的，区别在于本实验配置4个通道都为匹配时输出翻转模式，并且对于高级定时器需要调用函数TMR_EnablePWMOutputs()使能PWM输出。
22.2.3 实验应用代码
本章实验的应用代码，如下所示：
int main(void)
{
uint8_t t = 0;
NVIC_ConfigPriorityGroup(NVIC_PRIORITY_GROUP_3); /* 设置中断优先级分组为组3 */
sys_apm32_clock_init(336, 8, 2, 7); /* 配置系统时钟 */
delay_init(168); /* 初始化延时功能 */
usart_init(115200); /* 初始化串口 */
led_init(); /* 初始化LED */
/* 初始化高级定时器输出比较模式，输出频率为1KHz */
atmr_tmrx_comp_pwm_init(1000 - 1, 168 - 1);
TMR_ConfigCompare1(ATMR_TMRX_COMP, 250 - 1); /* 通道1相位25% */
TMR_ConfigCompare2(ATMR_TMRX_COMP, 500 - 1); /* 通道2相位50% */
TMR_ConfigCompare3(ATMR_TMRX_COMP, 750 - 1); /* 通道3相位75% */
TMR_ConfigCompare4(ATMR_TMRX_COMP, 1000 - 1); /* 通道4相位100% */
while (1)
{
t++;
if (t >= 20)
{
t = 0;
LED0_TOGGLE();
}
delay_ms(10);
}
}
从上面的代码中可以看到，TMR8的自动重装载值配置为(1000-1)，TMR8的预分频器数值配置为(168-1)，并且TMR8的时钟频率为168MHz，因此TMR8的计数频率为1MHz，且TMR8每计数1000次溢出一次，因此溢出频率为1KHz，但TMR8的4个通道配置为了匹配时输出翻转模式，因此4个通道输出的PWM频率应为500Hz。
初始化完TMR8后，调用函数TMR_ConfigComparen()配置了4个通道的捕获比较寄存器数值，要注意的是，该寄存器的值不能超过TMR8的自动重装载值，且捕获比较寄存器的数值与TMR8自动重装载值的比值就是输出PWM的相位。
22.3 下载验证
在完成编译和烧录操作后，可以通过示波器观察PC6引脚、PC7引脚、PC8引脚和PC9引脚输出的4路PWM，可以发现这4路PWM的频率都为500Hz、占空比都为50%，但相位两两相差了25%。