四、GD32 MCU 常见外设介绍 (5) TIMER 模块介绍

5.1.TIMER 基础知识

TIMER分高级定时器,通用定时器L0,L1,L2和基本定时器。

5.2.硬件连接说明

TIMER 属于片内外设,对于外部硬件设计,只需要单独IO口外接信号线即可。

5.3.GD32 TIMER 外设原理简介(以 GD32F30X 的高级定时器为例)

GD32 TIMER 主要特性

◼ 总通道数: 4;

◼ 计数器宽度: 16位;

◼ 定时器时钟源可选:内部时钟,内部触发,外部输入,外部触发;

◼ 多种计数模式:向上计数,向下计数和中央计数;

◼ 正交编码器接口:用来追踪运动和分辨旋转方向和位置;

◼ 霍尔传感器接口:用来做三相电机控制;

◼ 可编程的预分频器: 16位。运行时可以被改变;

◼ 每个通道可配置:输入捕获模式,输出比较模式,可编程的PWM模式,单脉冲模式;

◼ 可编程的死区时间;

◼ 自动重装载功能;

◼ 可编程的计数器重复功能;

◼ 中止输入功能;

◼ 中断输出和DMA请求:更新事件,触发事件,比较/捕获事件和中止事件;

◼ 多个定时器的菊链使得一个定时器可以同时启动多个定时器;

◼ 定时器的同步允许被选择的定时器在同一个时钟周期开始计数;

◼ 定时器主/从模式控制器。

TIMER 结构框图介绍

5.4.软件配置说明

定时中断 TIMER4

通用定时器L0(TIMER1/2/3/4) 是4通道定时器,支持输入捕获,输出比较,产生PWM信号控制电机和电源管理。通用定时器L0计数器是16位无符号计数器。通用定时器L0是可编程的,可以被用来计数,其外部事件可以驱动其他定时器。

这一章,将使用定时器产生中断,然后在中断服务函数里面翻转 LED上的电平,来指示定时器中断的产生。接下来我们以通用定时器 TIMER4 为实例,来说明要经过哪些步骤,才能达到这个要 求,并产生中断。定时器配置步骤如下:

1)TIMER4 时钟使能

复制代码
rcu_periph_clock_enable(RCU_TIMER4);

2) 初始化定时器参数,设置自动重装值,分频系数,计数方式等

在库函数中,定时器的初始化参数是通过初始化函数timer_parameter_struct 实现的:

复制代码
void timer_init(uint32_t timer_periph, timer_parameter_struct* initpara);

第一个参数是确定是哪个定时器,这个比较容易理解。第二个参数是定时器初始化参数结构体指针,结构体类型为timer_parameter_struct ,下面我们看看这个结构体的定义:

复制代码
/* TIMER init parameter struct definitions */
typedef struct
{ 
 uint16_t prescaler; /*!< prescaler value */
 uint16_t alignedmode; /*!< aligned mode */
 uint16_t counterdirection; /*!< counter direction */
 uint32_t period; /*!< period value */
 uint16_t clockdivision; /*!< clock division value */
 uint8_t repetitioncounter; /*!< the counter repetition value */
}timer_parameter_struct;

针对 TIMR4 初始化范例代码格式

复制代码
 timer_initpara.prescaler = 5999; //30M/6000 =500Hz
 timer_initpara.alignedmode = TIMER_COUNTER_EDGE;
 timer_initpara.counterdirection = TIMER_COUNTER_UP;
 timer_initpara.period = 4000-1; //800ms
 timer_initpara.clockdivision = TIMER_CKDIV_DIV1;
timer_init(TIMER4, &timer_initpara);

对于定时器定时周期的计算,设 TIMER4 的经过总线分频后得到的时钟为 30MHz,通过预分频 5999,得到 TIMER4 每个计 数的时钟为 1/(30MHz / (5999+1)) =0.2ms,4000 得到的周期为 0.2ms *4000 =800ms

3)设置 TIMER 允许更新中断

因为我们要使用 TIMER4 的更新中断,寄存器的相应位便可使能更新中断。在库函数里面定时器中断使能是通过timer_interrupt_enable函数来实现的:

复制代码
void timer_interrupt_enable(uint32_t timer_periph, uint32_t interrupt);

第一个参数是选择定时器号,这个容易理解。

第二个参数非常关键,是用来指明我们使能的定时器中断的类型。

4) TIMER4 中断优先级设置

在定时器中断使能之后,因为要产生中断,必不可少的要设置 NVIC 相关寄存器,设置中断优先级。通过nvic_irq_enable 函数实现中断优先级的设置。

针对 TIMR4 初始化范例代码格式

复制代码
nvic_irq_enable(TIMER4_IRQn, 1, 1);

5)允许 TIMER工作,也就是使能 TIMER

光配置好定时器还不行,没有开启定时器,照样不能用。我们在配置完后要开启定时器,在固件库里面使能定时器的函数是通过timer_enable函数来实现的

复制代码
void timer_enable(uint32_t timer_periph)

这个函数非常简单,比如我们要使能TIMER4,方法为:

复制代码
timer_enable(TIMER4);

6)编写中断服务函数

在最后,还是要编写定时器中断服务函数,通过该函数来处理定时器产生的相关中断。中断产生后,通过状态寄存器的值来判断此次产生的中断属于什么类型。然后执行相关的操作,我们这里使用的是更新(溢出)中断,在处理完中断之后应来清除该中断标志。

在固件库函数里面,用来读取中断状态寄存器的值判断中断类型的函数是:

复制代码
FlagStatus timer_interrupt_flag_get(uint32_t timer_periph, uint32_t interrupt)

该函数的作用是,判断定时器 TIMER 的中断类型,并判断是否发生中断。

针对 TIMR4 中断服务函数范例代码:

复制代码
void TIMER4_IRQHandler(void)
{
 if(SET == timer_interrupt_flag_get(TIMER4, TIMER_INT_UP)){
 /* clear channel 0 interrupt bit */
 timer_interrupt_flag_clear(TIMER4, TIMER_INT_UP);
 gd_eval_led_toggle(LED2);
 }
}

PWM 输出 TIMER0

高级定时器(TIMER0和TIMER7)是四通道定时器,支持输入捕获和输出比较。可以产生PWM信号控制电机和电源管理。高级定时器含有一个16位无符号计数器。高级定时器是可编程的,可以用来计数,其外部事件可以驱动其他定时器。高级定时器包含了一个死区时间插入模块,非常适合电机控制。

本章,我们使用的是 TIMER0的通道0 输出 PWM(脉冲宽度调制)。

下面我们介绍通过库函数来配置该功能的步骤:

(1)开启 TIMER0 和 GPIO 时钟,配置 PA8复用功能输出。

复制代码
rcu_periph_clock_enable(RCU_TIMER0);
rcu_periph_clock_enable(RCU_GPIOA);
gpio_init(GPIOA, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_8);

这里还需要说明一下, 对于定时器通道的引脚关系,引脚的IO口

这里补充说明下关于TIMER的相关GPIO口的命名

TIMERx_CHx : 定时器通道x

TIMERx_CHx_ON :定时器反向通道

TIMERx_BRKIN :刹车引脚

TIMERx_ETI:外部时钟输入

(2)初始化 TIMER0 ,设置 TIMER0 的预分频和周期等参数, ,在上一节定时器中断章节我们已经有讲解,这里就不详细讲解,调用的格式为

复制代码
timer_initpara.prescaler = 5999;
 timer_initpara.alignedmode = TIMER_COUNTER_EDGE;
 timer_initpara.counterdirection = TIMER_COUNTER_UP;
 timer_initpara.period = 4000;
 timer_initpara.clockdivision = TIMER_CKDIV_DIV1;
 timer_initpara.repetitioncounter = 0;
timer_init(TIMER0, &timer_initpara);

3)设置 TIMER0_CH0 的 PWM 模式, 使能 TIMER0 的 CH0 输出。 在库函数中, PWM 通道设置是通过函数timer_channel_output_config来设置的

复制代码
void timer_channel_output_config(uint32_t timer_periph, uint16_t channel, timer_oc_parameter_struct* ocpara)

我们直接来看看结构体timer_oc_parameter_struct的定义:

复制代码
typedef struct
{ 
 uint16_t outputstate; /*!< channel output state */
 uint16_t outputnstate; /*!< channel complementary output state */
 uint16_t ocpolarity; /*!< channel output polarity */
 uint16_t ocnpolarity; /*!< channel complementary output polarity */
 uint16_t ocidlestate; /*!< idle state of channel output */
 uint16_t ocnidlestate; /*!< idle state of channel complementary output */
}timer_oc_parameter_struct;

针对 TIMR0 CH0 初始化范例代码格式

复制代码
/* CH0, CH1 and CH2 configuration in PWM mode */
 timer_ocinitpara.outputstate = TIMER_CCX_ENABLE;
 timer_ocinitpara.outputnstate = TIMER_CCXN_DISABLE;
 timer_ocinitpara.ocpolarity = TIMER_OC_POLARITY_HIGH;
 timer_ocinitpara.ocnpolarity = TIMER_OCN_POLARITY_HIGH;
 timer_ocinitpara.ocidlestate = TIMER_OC_IDLE_STATE_LOW;
 timer_ocinitpara.ocnidlestate = TIMER_OCN_IDLE_STATE_LOW;
timer_channel_output_config(TIMER0, TIMER_CH_0, &timer_ocinitpara);

4)设置PWM输出以及脉冲宽度占空比

复制代码
timer_channel_output_pulse_value_config(TIMER0, TIMER_CH_0, 2000);
 timer_channel_output_mode_config(TIMER0, TIMER_CH_0, TIMER_OC_MODE_PWM0);
 timer_channel_output_shadow_config(TIMER0, TIMER_CH_0, TIMER_OC_SHADOW_DISABLE);
 timer_primary_output_config(TIMER0,ENABLE);

5)使能 TIMER0

在完成以上设置了之后,我们需要使能 TIMER0。使能 TIMER0 的方法前面已经讲解过:

复制代码
timer_enable(TIMER0);

通过以上 5 个步骤,我们就可以控制 TIMER0的 CH0 输出 PWM 波了。这里特别提醒一下大家,高级定时器虽然和通用定时器类似,但是高级定时器要想输出 PWM,必须多额外加一条函数

复制代码
void timer_primary_output_config(uint32_t timer_periph, ControlStatus newvalue);

输入捕获 TIMER2

通用定时器L0(TIMER1/2/3/4) 是4通道定时器,支持输入捕获,输出比较,产生PWM信号控制电机和电源管理。通用定时器L0计数器是16位无符号计数器。通用定时器L0是可编程的,可以被用来计数,其外部事件可以驱动其他定时器。

本章要实现通过输入捕获,来获取TIMER2_CH0(PA6)上面的下降沿,下面我们介绍库函数配置上述功能输入捕获的步骤:

1)开启 TIMER2 时钟,配置 PA6为复用功能,并开启上拉电阻。

复制代码
rcu_periph_clock_enable(RCU_TIMER2);
rcu_periph_clock_enable(RCU_GPIOA);
gpio_init(GPIOA, GPIO_MODE_IPU, GPIO_OSPEED_50MHZ, GPIO_PIN_6); //INCUPTURE -TIMER2

跟上一讲 PWM 输出类似,这里我们使用的是定时器2的通道 0,所以我们从对应的数据手册可以查看到对应的 IO 口为 PA6:

2) 初始化定时器参数,设置自动重装值, 分频系数,计数方式等

复制代码
/* TIMER2 configuration */
 timer_initpara.prescaler = 5999;
 timer_initpara.alignedmode = TIMER_COUNTER_EDGE;
 timer_initpara.counterdirection = TIMER_COUNTER_UP;
 timer_initpara.period = 4000;
 timer_initpara.clockdivision = TIMER_CKDIV_DIV1;
timer_init(TIMER2, &timer_initpara);

3)设置 TIMER2 的输入捕获参数,开启输入捕获

库函数是通过 timer_input_capture_config 函数来初始化输入比较参数的: timer_input_capture_config(TIMER2,TIMER_CH_0,&timer_icinitpara);

同样,我们来看看参数设置结构体 TIM_ICInitTypeDef 的定义:

复制代码
typedef struct
{ 
 uint16_t icpolarity; /*!< channel input polarity */
 uint16_t icselection; /*!< channel input mode selection */
 uint16_t icprescaler; /*!< channel input capture prescaler */
 uint16_t icfilter; /*!< channel input capture filter control */
}timer_ic_parameter_struct;

我们的配置代码是:

复制代码
/* initialize TIMER channel input parameter struct */
 timer_channel_input_struct_para_init(&timer_icinitpara);
 /* TIMER2 CH0 input capture configuration */
 timer_icinitpara.icpolarity = TIMER_IC_POLARITY_RISING;
 timer_icinitpara.icselection = TIMER_IC_SELECTION_DIRECTTI;
 timer_icinitpara.icprescaler = TIMER_IC_PSC_DIV1;
 timer_icinitpara.icfilter = 0x0;
timer_input_capture_config(TIMER2,TIMER_CH_0,&timer_icinitpara);

4) 使能捕获中断和NVIC

复制代码
timer_interrupt_enable(TIMER2,TIMER_INT_CH0);
nvic_irq_enable(TIMER2_IRQn, 1, 1);

5) 编写中断服务函数

复制代码
void TIMER2_IRQHandler(void){......}

6) 使能定时器

复制代码
timer_enable(TIMER2);

通过以上 6 步设置,定时器 2 的通道 0 就可以开始输入捕获了

外部时钟输入 TIMER1

通用定时器L0(TIMER1/2/3/4) 是4通道定时器,支持输入捕获,输出比较,产生PWM信号控制电机和电源管理。通用定时器L0计数器是16位无符号计数器。通用定时器L0是可编程的,可以被用来计数,其外部事件可以驱动其他定时器。

本章要实现使用TIMER1 PA0 作为时钟输入引脚,配置流程:

(1)使能GPIO,TIMER 时钟和GPIO口复用配置

复制代码
rcu_periph_clock_enable(RCU_GPIOA);
rcu_periph_clock_enable(RCU_AF);
rcu_periph_clock_enable(RCU_TIMER1);
gpio_init(GPIOA,GPIO_MODE_IN_FLOATING,GPIO_OSPEED_50MHZ,GPIO_PIN_0);

(2)通过查看数据手册,可以看到TIMER1_CH0_ETI,根据前面所讲,是可以支持外部时钟输入的。

TIMER的结构体,初始化定时器参数,设置自动重装值, 分频系数,计数方式等

复制代码
//ETI
 timer_initpara.prescaler = 1; // 2 分频
 timer_initpara.alignedmode = TIMER_COUNTER_EDGE;
 timer_initpara.counterdirection = TIMER_COUNTER_UP;
 timer_initpara.period = 65535;
 timer_initpara.clockdivision = TIMER_CKDIV_DIV1;
 timer_initpara.repetitioncounter = 0;
 timer_init(TIMER1,&timer_initpara);
timer_enable(TIMER1);

(3)配置TIMER的时钟来源和时钟源处理的配置

复制代码
timer_input_trigger_source_select(TIMER1,TIMER_SMCFG_TRGSEL_ETIFP);
timer_external_clock_mode1_config(TIMER1, TIMER_EXT_TRI_PSC_OFF, TIMER_ETP_RISING, 0);

(4)使能TIMER

复制代码
timer_enable(TIMER1);

5.5.TIMER 使用注意事项

TIMER 高级定时器 做定时用的时候(使用到UPDAT中断),在产生中断之后,高级定时器的其他所有的状态标志位会被置位,但是不会置位中断标志位.

本章内容每日持续更新,如有兴趣,请关注收藏

更多GD32 MCU相关咨询:https://www.gd32bbs.com/

相关推荐
智者知已应修善业1 小时前
【51单片机用数码管显示流水灯的种类是按钮控制数码管加一和流水灯】2022-6-14
c语言·经验分享·笔记·单片机·嵌入式硬件·51单片机
智商偏低7 小时前
单片机之helloworld
单片机·嵌入式硬件
青牛科技-Allen9 小时前
GC3910S:一款高性能双通道直流电机驱动芯片
stm32·单片机·嵌入式硬件·机器人·医疗器械·水泵、
森焱森11 小时前
无人机三轴稳定控制(2)____根据目标俯仰角,实现俯仰稳定化控制,计算出升降舵输出
c语言·单片机·算法·架构·无人机
白鱼不小白11 小时前
stm32 USART串口协议与外设(程序)——江协教程踩坑经验分享
stm32·单片机·嵌入式硬件
S,D11 小时前
MCU引脚的漏电流、灌电流、拉电流区别是什么
驱动开发·stm32·单片机·嵌入式硬件·mcu·物联网·硬件工程
芯岭技术14 小时前
PY32F002A单片机 低成本控制器解决方案,提供多种封装
单片机·嵌入式硬件
youmdt15 小时前
Arduino IDE ESP8266连接0.96寸SSD1306 IIC单色屏显示北京时间
单片机·嵌入式硬件
嘿·嘘15 小时前
第七章 STM32内部FLASH读写
stm32·单片机·嵌入式硬件
Meraki.Zhang15 小时前
【STM32实践篇】:I2C驱动编写
stm32·单片机·iic·驱动·i2c