【正点原子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。

相关文章

java -jar example.jar 产生的日志输出到指定文件的方法

java -jar example.jar 产生的日志输出到指定文件的方法

《java-jarexample.jar产生的日志输出到指定文件的方法》这篇文章给大家介绍java-jarexample.jar产生的日志输出到指定文件的方法,本文给大家介绍的非常详细,对大家的... 目录怎么让 Java -jar example.jar 产生的日志输出到指定文件一、方法1：使用重定向1、
阅读更多...
Linux查询服务器系统版本号的多种方法

Linux查询服务器系统版本号的多种方法

《Linux查询服务器系统版本号的多种方法》在Linux系统管理和维护工作中,了解当前操作系统的版本信息是最基础也是最重要的操作之一,系统版本不仅关系到软件兼容性、安全更新策略,还直接影响到故障排查和... 目录一、引言：系统版本查询的重要性二、基础命令解析：cat /etc/Centos-release详
阅读更多...
Linux grep 命令的使用指南

Linux grep 命令的使用指南

《Linuxgrep命令的使用指南》本文给大家介绍Linuxgrep命令的使用指南,包括基础搜索语法、实践指南,感兴趣的朋友跟随小编一起看看吧... 目录linux grep 命令全面使用指南一、基础搜索语法1. 基本文本搜索2. 多文件搜索二、常用选项详解1. 输出控制选项2. 上下文控制选项三、正则表达
阅读更多...
更改linux系统的默认Python版本方式

更改linux系统的默认Python版本方式

《更改linux系统的默认Python版本方式》通过删除原Python软链接并创建指向python3.6的新链接,可切换系统默认Python版本,需注意版本冲突、环境混乱及维护问题,建议使用pyenv... 目录更改系统的默认python版本软链接软链接的特点创建软链接的命令使用场景注意事项总结更改系统的默
阅读更多...
Spring Security6.3.x的使用指南与注意事项

Spring Security6.3.x的使用指南与注意事项

《SpringSecurity6.3.x的使用指南与注意事项》SpringSecurity6.3.1基于现代化架构,提供简洁配置、增强默认安全性和OAuth2.1/OIDC支持,采用Lambda... 目录介绍基础配置 (Servlet 应用 - 使用 Lambda DSL)关键配置详解（Lambda DS
阅读更多...
在Linux系统上连接GitHub的方法步骤(适用2025年)

在Linux系统上连接GitHub的方法步骤(适用2025年)

《在Linux系统上连接GitHub的方法步骤(适用2025年)》在2025年,使用Linux系统连接GitHub的推荐方式是通过SSH(SecureShell)协议进行身份验证,这种方式不仅安全,还... 目录步骤一：检查并安装 Git步骤二：生成 SSH 密钥步骤三：将 SSH 公钥添加到 github
阅读更多...
Spring Boot集成/输出/日志级别控制/持久化开发实践

Spring Boot集成/输出/日志级别控制/持久化开发实践

《SpringBoot集成/输出/日志级别控制/持久化开发实践》SpringBoot默认集成Logback,支持灵活日志级别配置（INFO/DEBUG等）,输出包含时间戳、级别、类名等信息,并可通过... 目录一、日志概述1.1、Spring Boot日志简介1.2、日志框架与默认配置1.3、日志的核心作用
阅读更多...
Python操作PDF文档的主流库使用指南

Python操作PDF文档的主流库使用指南

《Python操作PDF文档的主流库使用指南》PDF因其跨平台、格式固定的特性成为文档交换的标准,然而,由于其复杂的内部结构,程序化操作PDF一直是个挑战,本文主要为大家整理了Python操作PD... 目录一、 基础操作1.PyPDF2 (及其继任者 pypdf)2.PyMuPDF / fitz3.Fre
阅读更多...
Linux系统中查询JDK安装目录的几种常用方法

Linux系统中查询JDK安装目录的几种常用方法

《Linux系统中查询JDK安装目录的几种常用方法》：本文主要介绍Linux系统中查询JDK安装目录的几种常用方法,方法分别是通过update-alternatives、Java命令、环境变量及目... 目录方法 1：通过update-alternatives查询（推荐）方法 2：检查所有已安装的 JDK方
阅读更多...
Linux系统之lvcreate命令使用解读

Linux系统之lvcreate命令使用解读

《Linux系统之lvcreate命令使用解读》lvcreate是LVM中创建逻辑卷的核心命令,支持线性、条带化、RAID、镜像、快照、瘦池和缓存池等多种类型,实现灵活存储资源管理,需注意空间分配、R... 目录lvcreate命令详解一、命令概述二、语法格式三、核心功能四、选项详解五、使用示例1. 创建逻
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2