【正点原子STM32连载】第十八章 通用定时器PWM输出实验 摘自【正点原子】APM32E103最小系统板使用指南

2023-12-28 16:36
文章标签 输出 系统 通用 最小 实验 stm32 定时器 正点 原子 连载 使用指南 pwm 摘自 第十八章 apm32e103

本文主要是介绍【正点原子STM32连载】第十八章 通用定时器PWM输出实验 摘自【正点原子】APM32E103最小系统板使用指南，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

1）实验平台：正点原子APM32E103最小系统板
2）平台购买地址：https://detail.tmall.com/item.htm?id=609294757420
3）全套实验源码+手册+视频下载地址： http://www.openedv.com/docs/boards/xiaoxitongban

第十八章 通用定时器PWM输出实验

本章将介绍使用APM32E103的通用定时器输出PWM，通过本章的学习，读者将学习到通用定时器输出比较的使用。
本章分为如下几个小节：
18.1 硬件设计
18.2 程序设计
18.3 下载验证

18.1 硬件设计
18.1.1 例程功能

  1. LED0由暗变亮，再从亮变暗，以此循环
    18.1.2 硬件资源
  2. LED
    LED0 - PB5
  3. 定时器3
    通道2
    18.1.3 原理图
    本章实验使用的定时器3为APM32E103的片上资源，因此没有对应的连接原理图。
    18.2 程序设计
    18.2.1 Geehy标准库的TMR驱动
    本章实验将使用TMR3从通道2（PE5引脚）输出PWM，因此除了像上章实验配置定时器的基本参数外，还需要配置通用定时器的输出比较通道，具体的步骤如下：
    ①：配置TMR3的自动重装载值和预分频器数值等参数
    ②：配置输出比较通道1
    ③：使能TMR3
    ④：使能输出比较通道1输出
    ⑤：修改比较值以修改PWM输出的占空比
    在Geehy标准库中对应的驱动函数如下：
    ①：配置TMR
    请见第16.2.1小节中配置TMR的相关内容。
    ②：配置输出比较通道
    该函数用于配置TMR的任意输出比较通道，其函数原型如下所示：
void TMR_ConfigOC1(TMR_T* tmr, TMR_OCConfig_T* OC1Config)
void TMR_ConfigOC2(TMR_T* tmr, TMR_OCConfig_T* OC2Config)
void TMR_ConfigOC3(TMR_T* tmr, TMR_OCConfig_T* OC3Config)
void TMR_ConfigOC4(TMR_T* tmr, TMR_OCConfig_T* OC4Config)

该函数的形参描述，如下表所示：
在这里插入图片描述

表18.2.1.1 函数TMR_ConfigOCn()形参描述
该函数的返回值描述，如下表所示：
返回值 描述
无 无
表18.2.1.2 函数TMR_ConfigOCn()返回值描述
该函数使用TMR_OCConfig_T类型的结构体变量传入TMR输出比较通道的配置参数，该结构体的定义如下所示：

typedef enum
{TMR_OC_MODE_TMRING		= 0x00,	/* 冻结 */TMR_OC_MODE_ACTIVE		= 0x01,	/* 匹配时输出置为高 */TMR_OC_MODE_INACTIVE	= 0x02,	/* 匹配时输出置为低 */TMR_OC_MODE_TOGGLE		= 0x03,	/* 匹配时输出翻转 */TMR_OC_MODE_LOWLEVEL	= 0x04,	/* 强制输出为低 */TMR_OC_MODE_HIGHLEVEL	= 0x05,	/* 强制输出为高 */TMR_OC_MODE_PWM1		= 0x06,	/* PWM模式1 */TMR_OC_MODE_PWM2		= 0x07	/* PWM模式2 */
} TMR_OC_MODE_T;typedef enum
{TMR_OC_STATE_DISABLE,			/* 禁止输出 */TMR_OC_STATE_ENABLE				/* 开启输出 */
} TMR_OC_STATE_T;typedef enum
{TMR_OC_NSTATE_DISABLE,			/* 禁止互补输出 */TMR_OC_NSTATE_ENABLE			/* 开启互补输出 */
} TMR_OC_NSTATE_T;typedef enum
{TMR_OC_POLARITY_HIGH,			/* 高电平有效 */TMR_OC_POLARITY_LOW				/* 低电平有效 */
} TMR_OC_POLARITY_T;typedef enum
{TMR_OC_NPOLARITY_HIGH,			/* 互补高电平有效 */TMR_OC_NPOLARITY_LOW			/* 互补低电平有效 */
} TMR_OC_NPOLARITY_T;typedef enum
{TMR_OC_IDLE_STATE_RESET,		/* 空闲时为低电平 */TMR_OC_IDLE_STATE_SET			/* 空闲时为高电平 */
} TMR_OC_IDLE_STATE_T;typedef enum
{TMR_OC_NIDLE_STATE_RESET,		/* 互补空闲时为低电平 */TMR_OC_NIDLE_STATE_SET			/* 互补空闲时为高电平 */
} TMR_OC_NIDLE_STATE_T;typedef struct
{TMR_OC_MODE_T			mode;			/* 模式 */TMR_OC_STATE_T			outputState;	/* 输出状态 */TMR_OC_NSTATE_T			outputNState;	/* 互补通道输出状态 */TMR_OC_POLARITY_T		polarity;		/* 极性 */TMR_OC_NPOLARITY_T		nPolarity;		/* 互补通道极性 */TMR_OC_IDLE_STATE_T		idleState;		/* 空闲状态 */TMR_OC_NIDLE_STATE_T	nIdleState;		/* 互补通道空闲状态 */uint16_t					pulse;		/* 比较值 */
} TMR_OCConfig_T;该函数的使用实例，如下所示：
#include "apm32e10x.h"
#include "apm32e10x_tmr.h"	void example_fun(void)
{TMR_OCConfig_T tmr_oc_init_struct;/* 配置TMR1输出比较通道1 */tmr_oc_init_struct.mode			 = TMR_OC_MODE_PWM1;tmr_oc_init_struct.outputState	 = TMR_OC_STATE_ENABLE;tmr_oc_init_struct.outputNState = TMR_OC_NSTATE_ENABLE;tmr_oc_init_struct.polarity		 = TMR_OC_POLARITY_LOW;tmr_oc_init_struct.nPolarity	 = TMR_OC_NPOLARITY_HIGH;tmr_oc_init_struct.idleState	 = TMR_OC_IDLE_STATE_RESET;tmr_oc_init_struct.nIdleState	 = TMR_OC_NIDLE_STATE_RESET;tmr_oc_init_struct.pulse		 = 255;TMR_ConfigOC1(TMR1, &tmr_oc_init_struct);
}

③：使能TMR
请见第16.2.1小节中使能TMR的相关内容。
④：使能捕获比较通道
该函数用于使能捕获比较通道，其函数原型如下所示：
void TMR_EnableCCxChannel(TMR_T* tmr, TMR_CHANNEL_T channel);
该函数的形参描述，如下表所示：
在这里插入图片描述

表18.2.1.3 函数TMR_EnableCCxChannel()形参描述
该函数的返回值描述，如下表所示：
返回值 描述
无 无
表18.2.1.4 函数TMR_EnableCCxChannel()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_tmr.h"void example_fun(void)
{/* 使能TMR1捕获比较通道1 */TMR_EnableCCxChannel(TMR1, TMR_CHANNEL_1);
}
⑤：配置捕获比较值
该函数用于配置TMR指定通道的捕获比较值，其函数原型如下所示：
void TMR_ConfigCompare1(TMR_T* tmr, uint16_t compare1)
void TMR_ConfigCompare2(TMR_T* tmr, uint16_t compare2)
void TMR_ConfigCompare3(TMR_T* tmr, uint16_t compare3)
void TMR_ConfigCompare4(TMR_T* tmr, uint16_t compare4)

该函数的形参描述，如下表所示：
形参 描述
tmr 指向TMR外设结构体的指针
例如：TMR1、TMR2等（在apm32e10x.h文件中有定义）
compare x 捕获比较值
表18.2.1.5 函数TMR_ConfigComparen()形参描述
该函数的返回值描述，如下表所示：
返回值 描述
无 无
表18.2.1.6 函数TMR_ConfigComparen()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_tmr.h"void example_fun(void)
{/* 配置TMR1捕获比较寄存器1的值 */TMR_ConfigCompare1(TMR1, 200);
}

18.2.2 通用定时器驱动
本章实验的通用定时器驱动主要负责向应用层提供通用定时器的初始化函数。本章实验中，通用定时器驱动的驱动代码包括gtmr.c和gtmr.h两个文件。
通用定时器驱动中，对GPIO、TMR的相关宏定义，如下所示：
/* 通用定时器PWM输出引脚定义 */

#define GTMR_TMRX_PWM_CHY_GPIO_PORT         GPIOB
#define GTMR_TMRX_PWM_CHY_GPIO_PIN          GPIO_PIN_5
#define GTMR_TMRX_PWM_CHY_GPIO_REMAP()      do{ GPIO_ConfigPinRemap(GPIO_PARTIAL_REMAP_TMR3); }while(0)
#define GTMR_TMRX_PWM_CHY_GPIO_CLK_ENABLE() do{ RCM_EnableAPB2PeriphClock(RCM_APB2_PERIPH_GPIOB); }while(0)/* 通用定时器定义 */ 
#define GTMR_TMRX_PWM                       TMR3
#define GTMR_TMRX_PWM_CHY                   TMR_CHANNEL_2
#define GTMR_TMRX_INT_CLK_ENABLE()          do{ RCM_EnableAPB1PeriphClock(RCM_APB1_PERIPH_TMR3); }while(0)
通用定时器驱动中TMR3的初始化函数，如下所示：
/*** @brief       初始化通用定时器通道与PWM* @note*              通用定时器的时钟来自APB1,当PPRE1 ≥ 2分频的时候*              通用定时器的时钟为APB1时钟的2倍, 而APB1为60M,所以定时器时钟 = 120Mhz*              定时器溢出时间计算方法: Tout = ((arr + 1) * (psc + 1)) / Ft us.*              Ft=定时器工作频率,单位:Mhz** @param       arr: 自动重装值。* @param       psc: 时钟预分频数。* @retval      无*/
void gtmr_tmrx_pwm_chy_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;/* 使能时钟 */GTMR_TMRX_PWM_CHY_GPIO_CLK_ENABLE();                    /* 使能GPIOB时钟 */GTMR_TMRX_INT_CLK_ENABLE();                             /* 使能TIM时钟 */RCM_EnableAPB2PeriphClock(RCM_APB2_PERIPH_AFIO);        /* 使能复用时钟 *//* 配置PWM输出引脚 */
/* 初始化IO口为复用功能 */gpio_init_struct.pin = GTMR_TMRX_PWM_CHY_GPIO_PIN;gpio_init_struct.mode = GPIO_MODE_AF_PP;                /* 复用推挽 */
gpio_init_struct.speed = GPIO_SPEED_50MHz;              /* 高速 */
/* 初始化LED引脚 */GPIO_Config(GTMR_TMRX_PWM_CHY_GPIO_PORT, &gpio_init_struct);/* 配置引脚复用功能 */
/* IO口REMAP设置, 是否必要查看头文件配置的说明 */GTMR_TMRX_PWM_CHY_GPIO_REMAP();/* 配置通用定时器 */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_ConfigTimeBase(GTMR_TMRX_PWM, &tmr_init_struct);    /* 初始化通用定时器 *//* 配置通用定时器PWM输出 */tmr_oc_init_struct.mode = TMR_OC_MODE_PWM1;             /* 模式选择PWM1 */tmr_oc_init_struct.outputState = TMR_OC_STATE_ENABLE;   /* 使能输出 */tmr_oc_init_struct.outputNState = TMR_OC_NSTATE_DISABLE;/* 失能互补输出 */tmr_oc_init_struct.polarity = TMR_OC_POLARITY_LOW;      /* 输出极性 */tmr_oc_init_struct.nPolarity = TMR_OC_NPOLARITY_LOW;    /* 互补输出极性 */
tmr_oc_init_struct.idleState = TMR_OC_IDLE_STATE_RESET; /* 输出比较空闲状态 */
/* 互补输出比较空闲状态 */
tmr_oc_init_struct.nIdleState = TMR_OC_NIDLE_STATE_RESET;
/* 设置比较值,此值用来确定占空比,默认比较值为自动重装载值的一半,即占空比为50% */
tmr_oc_init_struct.pulse = arr / 2;                              TMR_ConfigOC2(GTMR_TMRX_PWM, &tmr_oc_init_struct);     /* 配置通用定时器通道 *//* 使能通用定时器及其自动重装载 */TMR_EnableAUTOReload(GTMR_TMRX_PWM);                   /* 使能自动重装载 */TMR_Enable(GTMR_TMRX_PWM);                             /* 使能通用定时器 */
}

从TMR3的初始化代码中可以看到，我们不仅配置了TMR3的自动重装载值和预分频器数值等基本参数，还配置了TMR3的输出比较通道2。因为需要使用GPIO引脚输出PWM，所以对应的GPIO引脚同样配置了复用功能。
18.2.3 实验应用代码
本实验的应用代码，如下所示：

int main(void)
{uint8_t dir = 1;uint16_t ledrpwmval = 0;NVIC_ConfigPriorityGroup(NVIC_PRIORITY_GROUP_4);  /* 设置中断优先级分组为组4 */sys_apm32_clock_init(15);                         /* 配置系统时钟 */delay_init(120);                                  /* 初始化延时功能 */
usart_init(115200);                               /* 初始化串口 */
/* 初始化通用定时器通道与PWM */gtmr_tmrx_pwm_chy_init(500 - 1, 60 - 1);while (1){delay_ms(10);if (dir){
/* dir==1,ledrpwmval递增 */ledrpwmval ++;}else{
/* dir==0,ledrpwmval递减 */ledrpwmval --;}if (ledrpwmval > 300){/* ledrpwmval到达300后，方向改为递减 */dir = 0;}if (ledrpwmval == 0){/* ledrpwmval递减到0后，方向改为递增 */dir = 1;}/* 修改比较值控制占空比 */TMR_ConfigCompare2(GTMR_TMRX_PWM, ledrpwmval);}
}

从上面的代码中可以看到，在初始化完TMR3输出PWM后，就不断地改变TMR3通道2的比较值，以达到改变PWM占功比的目的。又因为PWM由PB5引脚输出，PB5引脚连接至LED0，所以LED0的亮度也会随之发生变化，从而实现呼吸灯的效果。
18.3 下载验证
在完成编译和烧录后，可以看到板子上的LED0先由暗再逐渐变亮，以此循环，实现了呼吸灯的效果。

这篇关于【正点原子STM32连载】第十八章 通用定时器PWM输出实验 摘自【正点原子】APM32E103最小系统板使用指南的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/546573。

相关文章

sqlite3 命令行工具使用指南

sqlite3 命令行工具使用指南

《sqlite3命令行工具使用指南》本文系统介绍sqlite3CLI的启动、数据库操作、元数据查询、数据导入导出及输出格式化命令,涵盖文件管理、备份恢复、性能统计等实用功能,并说明命令分类、SQL语... 目录一、启动与退出二、数据库与文件操作三、元数据查询四、数据操作与导入导出五、查询输出格式化六、实用功
阅读更多...
linux重启命令有哪些? 7个实用的Linux系统重启命令汇总

linux重启命令有哪些? 7个实用的Linux系统重启命令汇总

《linux重启命令有哪些?7个实用的Linux系统重启命令汇总》Linux系统提供了多种重启命令，常用的包括shutdown-r、reboot、init6等，不同命令适用于不同场景，本文将详细... 在管理和维护 linux 服务器时，完成系统更新、故障排查或日常维护后，重启系统往往是必不可少的步骤。本文
阅读更多...
Mac系统下卸载JAVA和JDK的步骤

Mac系统下卸载JAVA和JDK的步骤

《Mac系统下卸载JAVA和JDK的步骤》JDK是Java语言的软件开发工具包,它提供了开发和运行Java应用程序所需的工具、库和资源,：本文主要介绍Mac系统下卸载JAVA和JDK的相关资料,需... 目录1. 卸载系统自带的 Java 版本检查当前 Java 版本通过命令卸载系统 Java2. 卸载自定
阅读更多...
Python虚拟环境与Conda使用指南分享

Python虚拟环境与Conda使用指南分享

《Python虚拟环境与Conda使用指南分享》：本文主要介绍Python虚拟环境与Conda使用指南,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、python 虚拟环境概述1.1 什么是虚拟环境1.2 为什么需要虚拟环境二、Python 内置的虚拟环境工具
阅读更多...
基于Python实现一个简单的题库与在线考试系统

基于Python实现一个简单的题库与在线考试系统

《基于Python实现一个简单的题库与在线考试系统》在当今信息化教育时代,在线学习与考试系统已成为教育技术领域的重要组成部分,本文就来介绍一下如何使用Python和PyQt5框架开发一个名为白泽题库系... 目录概述功能特点界面展示系统架构设计类结构图Excel题库填写格式模板题库题目填写格式表核心数据结构
阅读更多...
Linux系统中的firewall-offline-cmd详解(收藏版)

Linux系统中的firewall-offline-cmd详解(收藏版)

《Linux系统中的firewall-offline-cmd详解(收藏版)》firewall-offline-cmd是firewalld的一个命令行工具,专门设计用于在没有运行firewalld服务的... 目录主要用途基本语法选项1. 状态管理2. 区域管理3. 服务管理4. 端口管理5. ICMP 阻断
阅读更多...
Windows 系统下 Nginx 的配置步骤详解

Windows 系统下 Nginx 的配置步骤详解

《Windows系统下Nginx的配置步骤详解》Nginx是一款功能强大的软件,在互联网领域有广泛应用,简单来说,它就像一个聪明的交通指挥员,能让网站运行得更高效、更稳定,：本文主要介绍W... 目录一、为什么要用 Nginx二、Windows 系统下 Nginx 的配置步骤1. 下载 Nginx2. 解压
阅读更多...
如何确定哪些软件是Mac系统自带的? Mac系统内置应用查看技巧

如何确定哪些软件是Mac系统自带的? Mac系统内置应用查看技巧

《如何确定哪些软件是Mac系统自带的?Mac系统内置应用查看技巧》如何确定哪些软件是Mac系统自带的？mac系统中有很多自带的应用，想要看看哪些是系统自带，该怎么查看呢？下面我们就来看看Mac系统内... 在MAC电脑上，可以使用以下方法来确定哪些软件是系统自带的：1.应用程序文件夹打开应用程序文件夹
阅读更多...
windows系统上如何进行maven安装和配置方式

windows系统上如何进行maven安装和配置方式

《windows系统上如何进行maven安装和配置方式》：本文主要介绍windows系统上如何进行maven安装和配置方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不... 目录1. Maven 简介2. maven的下载与安装2.1 下载 Maven2.2 Maven安装2.
阅读更多...
使用Python实现Windows系统垃圾清理

使用Python实现Windows系统垃圾清理

《使用Python实现Windows系统垃圾清理》Windows自带的磁盘清理工具功能有限,无法深度清理各类垃圾文件,所以本文为大家介绍了如何使用Python+PyQt5开发一个Windows系统垃圾... 目录一、开发背景与工具概述1.1 为什么需要专业清理工具1.2 工具设计理念二、工具核心功能解析2.
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2