我们在之前介绍中断的概念,接下来我们实际的应用中断,将按键的引脚配置为外部中断模式,通过中断点灯。
配置流程
一般使用GPIO的外部中断功能,都需要有以下几个步骤。
- 开启时钟(包括GPIO时钟和系统配置时钟)
- 配置GPIO的模式
- 使能NVIC中断并配置优先级
- 配置GPIO中断
- 使能中断和清除中断标志位
- 编写中断服务函数
GD32单片机的任意GPIO都可以配置为外部中断触发,开发板的按键使用的是KEY_UP,接到了单片机的PA0引脚上,因此我们可以使能PA0的外部中断功能。
开启时钟
开启时钟分为两步,第一步就是先开启GPIO端口的时钟,第二步就是开启系统配置时钟,系统配置寄存器可以将外部中断线连接到我们需要的引脚。关于系统配置寄存器的EXTI源选择寄存器可以查看用户手册的第31页。
按键接到了单片机的PA0引脚上,首先要使能GPIOA端口的时钟。还是用rcu_periph_clock_enable
函数,只需要将GPIOA时钟当做参数传入。系统配置寄存器时钟为RCU_SYSCFG
,直接作为参数传入即可。
宏定义:
#define BSP_KEY_RCU RCU_GPIOA
使能时钟可以写为:
// 开启时钟
rcu_periph_clock_enable(BSP_KEY_RCU);
// 系统配置时钟
rcu_periph_clock_enable(RCU_SYSCFG);
2
3
4
配置GPIO模式
按键配置方式没有变化,使能按键的引脚为输入模式和下拉模式,编写代码为:
/* 配置为输入模式 下拉模式 */
gpio_mode_set(BSP_KEY_PORT, GPIO_MODE_INPUT, GPIO_PUPD_PULLDOWN, BSP_KEY_PIN);
// 按键默认状态是低电平,配置为下拉
2
3
使能NVIC中断并配置优先级
上一章介绍了每一个中断都需要配置优先级。配置优先级之前需要先对NVIC进行分组,关于NVIC的定义在gd32fvw55x_eclic.h
中。
void eclic_priority_group_set(uint8_t prigroup);
这个函数设置中断优先级分组,有一个参数prigroup
,关于参数选项如图所示。
关于优先级的选择根据系统功能的不同配置不同,选择一个合适的即可。这里就选择中间的作为讲解。
设置优先级分组代码为:
eclic_priority_group_set(ECLIC_PRIGROUP_LEVEL2_PRIO2);
// 设置中断优先级组 2位用于抢占优先级,2位用于响应优先级
2
中断分组设置完成还需要配置中断的抢占优先级和响应优先级。
void eclic_irq_enable(IRQn_Type source, uint8_t level, uint8_t priority);
这个函数配置中断的优先级。有三个参数,第一个参数source
就是要配置的中断类型,第二个参数level
是抢占优先级,第三个参数priority
是响应优先级。
关于中断类型在gd32vw55x.h
中有定义,如图所示(部分截取)。
这里需要注意一下,关于16个IO中断的中断类型为 0-4引脚配置为EXTIx_IRQn(x=可取0-4)
,
5-9引脚配置为 EXTI5_9_IRQn
,10-15引脚配置为EXTI10_15_IRQn
。
配置PA0引脚中断类型宏定义如下:
#define BSP_KEY_EXTI_IRQn EXTI0_IRQn // 中断类型
上一步中断分组设置了2位抢占优先级,2位响应优先级,二进制的11,那对应的抢占优先级等级为0-3,响应优先级等级为0-3,按键检测事件属于不是很紧急的任务,我们配置为最低优先级。配置代码为:
/* 使能NVIC中断 中断分组为2位抢占优先级,2位子优先级
*/eclic_irq_enable(BSP_KEY_EXTI_IRQn,3U,3U); // 抢占优先级3,子优先级3
2
配置GPIO中断
在配置中断优先级之后,需要将中断线和gpio进行连接。在gd32vw55x_syscfg.h中有定义
void syscfg_exti_line_config(uint8_t exti_port, uint8_t exti_pin);
这个函数配置GPIO作为中断使用,有两个参数,第一个参数exti_port
就是对应的中断引脚资源端口,第二个参数exti_pin
就是对应的中断引脚。关于中断资源引脚定义在gd32vw55x_syscfg.h
中可以查看,如图所示。
中断引脚资源定义如下:
#define BSP_KEY_EXTI_PORT_SOURCE EXTI_SOURCE_GPIOA
#define BSP_KEY_EXTI_PIN_SOURCE EXTI_SOURCE_PIN0
2
配置中断到GPIO可写为:
/* 连接中断线到GPIO */
syscfg_exti_line_config(BSP_KEY_EXTI_PORT_SOURCE,BSP_KEY_EXTI_PIN_SOURCE);
2
配置好中断和GPIO连接之后,还需要对中断进行初始化,配置一些参数。在gd32vw55x_exti.h中有
void exti_init(exti_line_enum linex, exti_mode_enum mode, exti_trig_type_enum trig_type);
这个函数初始化中断配置。有三个参数,第一个参数linex
是中断线,第二个参数mode
是中断模式,第三个参数trig_type
是触发类型。
关于中断线一共有26个,在gd32vw55x_exti.h
中有定义,如图所示。
关于每个中断线对应的功能在用户手册的第130页,如图所示。
PA0的中断线就是EXTI_0。关于中断线宏定义如下:
#define BSP_KEY_EXTI_LINE EXTI_0 // 中断线
关于中断模式的可选选项如图所示。
我们的示例是用按键来触发,因此选择中断模式即可。
关于触发类型的可选选项如图所示。
开发板的按键引脚默认是低电平,当按键按下的时候为高电平,这样一个从低到高变化的过程就是一个上升沿;当按键松开的时候,将会从高电平变为低电平,变化的过程是一个下降沿。如果要同时检测按键按下和松开就需要两者都配置,选择上升沿和下降沿均触发。
最终初始化中断线配置为中断模式,上升沿触发,当我们松开按键触发了上升沿就进入中断。
/* 初始化中断线 */
exti_init(BSP_KEY_EXTI_LINE,EXTI_INTERRUPT,EXTI_TRIG_RISING);
2
使能中断和清除中断标志位
配置好中断之后,就可以开启中断了。
void exti_interrupt_enable(exti_line_enum linex);
这个函数使能中断,有一个参数linex
就是中断线。
配置如下:
/* 使能中断 */
exti_interrupt_enable(BSP_KEY_EXTI_LINE);
2
在使用中断的时候先清一下中断标志位,确保中断是有效的。因为初始上电状态,就会进入一次中断。
void exti_interrupt_flag_clear(exti_line_enum linex);
这个函数是清除中断标志位,有一个参数linex
就是中断线。
配置如下:
/* 清除中断标志位 */
exti_interrupt_flag_clear(BSP_KEY_EXTI_LINE);
2
编写中断服务函数
使能中断之后,如果有中断触发,就会跳转到中断处理函数里面执行。需要编写中断处理函数。首先是中断函数名, 这个是固定的,在start.s
启动文件中有定义,如图所示。(部分截取)
在中断处理函数里需要检测中断标志位是否被置位。
FlagStatus exti_interrupt_flag_get(exti_line_enum linex);
这个函数是获取中断标志位。只有一个参数linex
就是中断线。有一个返回值FlagStatus
,返回值的状态为SET
(1)和RESET
(0)。需要注意的是每次中断执行完毕之后都需要清除一下中断标志位等待下一次中断发生。
宏定义中断服务函数名:
#define BSP_KEY_EXTI_IRQHandler EXTI0_IRQHandler // 中断服务函数名
中断服务函数编写代码如下:
void BSP_KEY_EXTI_IRQHandler(void)
{
if(exti_interrupt_flag_get(BSP_KEY_EXTI_LINE) == SET) // 中断标志位为1,按键按下
{
if(gpio_input_bit_get(KEY_PORT,KEY_GPIO) == SET) // 按键按下
{
/* 执行功能 */
gpio_bit_toggle(GPIOC,GPIO_PIN_13); // LED状态翻转
}
exti_interrupt_flag_clear(BSP_KEY_EXTI_LINE); // 清中断标志位
}
}
2
3
4
5
6
7
8
9
10
11
12
实验现象
关于这一章节的代码,可以在开发板资料/03 - 软件资料/代码例程/里面的007外部中断按键点灯
。
下载中心跳转📦
资料下载中心:点击跳转🚀
烧写我们的代码之后,按下一次按键,开启LED1,再按下一次按键,关闭LED1,以此类推。