十三、外部中断按键点灯
1.配置流程
一般使用GPIO的外部中断功能,都需要有以下几个步骤。
- 开启时钟(包括GPIO时钟和系统配置时钟)
- 配置GPIO的模式
- 使能NVIC中断并配置优先级
- 配置GPIO中断
- 使能中断和清除中断标志位
- 编写中断服务函数
GD32单片机的任意引脚都可以配置为外部中断触发,开发板的按键使用的是外接按键(忘记的可以,点我查看),接到了单片机的PA1引脚上,因此我们可以使能PA1的外部中断功能。
1.1.开启时钟
开启时钟分为两步,第一步就是先开启GPIO端口的时钟,第二步就是开启系统配置时钟,系统配置寄存器可以将外部中断线连接到我们需要的引脚。关于系统配置寄存器的EXTI源选择寄存器可以查看用户手册的第45页。
按键接到了单片机的PA1引脚上,首先要使能GPIOA端口的时钟。还是用rcu_periph_clock_enable函数,只需要将GPIOA时钟当做参数传入。系统配置寄存器时钟为RCU_CFGCMP,直接作为参数传入即可。 宏定义:
#define BSP_KEY_RCU RCU_GPIOA
使能时钟可以写为:
/* 开启时钟 */
rcu_periph_clock_enable(BSP_KEY_RCU);
rcu_periph_clock_enable(RCU_CFGCMP); // 系统配置时钟
2
3
1.2.配置GPIO模式
按键配置方式没有变化,使能按键的引脚为输入模式和下拉模式,编写代码为:
/* 配置为输入模式 下拉模式 */
gpio_mode_set(BSP_KEY_PORT, GPIO_MODE_INPUT, GPIO_PUPD_PULLDOWN, BSP_KEY_PIN);
// 按键默认状态是低电平,配置为下拉
2
3
1.3.使能NVIC中断并配置优先级
上一章介绍了每一个中断都需要配置优先级。
void nvic_irq_enable(uint8_t nvic_irq, uint8_t nvic_irq_priority);
关于优先级的选择根据系统功能的不同配置不同,选择一个合适的即可。这里就选择中间的作为讲解。
设置优先级分组代码为:
nvic_irq_enable(BSP_KEY_EXTI_IRQn, 1); // 设置中断优先级
关于中断类型在gd32e23x.h中有定义,如图1-3-2所示(部分截取)。
配置PA0引脚中断类型宏定义如下:
#define BSP_KEY_EXTI_IRQn EXTI0_1_IRQn // 中断类型
1.4.配置GPIO中断
在配置中断优先级之后,需要将中断线和gpio进行连接。在gd32e23x_syscfg.h中有定义
void syscfg_exti_line_config(uint8_t exti_port, uint8_t exti_pin);
这个函数配置GPIO作为中断使用,有两个参数,第一个参数就是对应的中断引脚资源端口,第二个参数就是对应的中断引脚。关于中断资源引脚定义在gd32e23x_syscfg.h中可以查看,如图1-4-1所示。
中断引脚资源定义如下:
#define BSP_KEY_EXTI_PORT_SOURCE EXTI_SOURCE_GPIOA
#define BSP_KEY_EXTI_PIN_SOURCE EXTI_SOURCE_PIN1
2
配置中断到GPIO可写为:
/* 配置外部中断线的映射,将外部中断线与具体的 GPIO 引脚进行关联。 */
syscfg_exti_line_config(BSP_KEY_EXTI_PORT_SOURCE,BSP_KEY_EXTI_PIN_SOURCE);
2
配置好中断和GPIO连接之后,还需要对中断进行初始化,用于初始化外部中断线的触发条件和模式。在gd32e23x_exti.h中有
void exti_init(exti_line_enum linex, exti_mode_enum mode, exti_trig_type_enum trig_type);
这个函数初始化中断配置。有三个参数,第一个参数是中断线,第二个参数是中断模式,第三个参数是触发类型。
关于中断线一共有28个,在gd32e23x_exti.h中有定义,如图1-4-2所示。
关于每个中断线对应的功能在用户手册的第95页,如图1-4-3所示。
PA1的中断线就是EXTI_1。关于中断线宏定义如下:
#define BSP_KEY_EXTI_LINE EXTI_1 // 中断线
关于中断模式的可选选项如图1-4-4所示。
用按键来触发选择中断模式即可。
关于触发类型的可选选项如图1-4-5所示。
按键接到了3V3,但PA1口在按键没有按下的时候是低电平,当按键按下的时候为高电平,这样一个从低到高变化的过程就是一个上升沿,即选择上升沿触发。当按键松开的时候,将会从高电平变为低电平,变化的过程是一个下降沿。如果要同时检测按键按下和松开就需要两者都配置,选择上升沿和下降沿均触发。
最终初始化中断线配置为中断模式,上升沿和下降沿均触发。
/* 初始化中断线配置为中断模式,上升沿和下降沿均触发。 */
exti_init(BSP_KEY_EXTI_LINE,EXTI_INTERRUPT,EXTI_TRIG_BOTH);
2
1.5.使能中断和清除中断标志位
配置好中断之后,就可以开启中断了。
void exti_interrupt_enable(exti_line_enum linex);
这个函数使能中断,有一个参数就是中断线。 配置如下:
/* 使能中断 */
exti_interrupt_enable(BSP_KEY_EXTI_LINE);
2
在使用中断的时候先清一下中断标志位,确保中断是有效的。
void exti_interrupt_flag_clear(exti_line_enum linex);
这个函数清中断标志位,有一个参数就是中断线。
配置如下:
/* 清除中断标志位 */
exti_interrupt_flag_clear(BSP_KEY_EXTI_LINE);
2
1.6.编写中断服务函数
使能中断之后,如果有中断触发,就会跳转到中断处理函数里面执行。需要编写中断处理函数。首先是中断函数名, 这个是固定的,在startup_gd32e23x.s启动文件中有定义,如图1-6-1所示。(部分截取)
在中断处理函数里需要检测中断标志位是否被置位。
FlagStatus exti_interrupt_flag_get(exti_line_enum linex);
这个函数是获取中断标志位。只有一个参数就是中断线。有一个返回值FlagStatus,返回值的状态为SET和RESET。需要注意的是每次中断执行完毕之后都需要清除一下中断标志位等待下一次中断发生。
宏定义中断服务函数名:
#define BSP_KEY_EXTI_IRQHandler EXTI0_1_IRQHandler // 中断服务函数名
中断服务函数编写代码如下:
void BSP_KEY_EXTI_IRQHandler(void){
if(exti_interrupt_flag_get(BSP_KEY_EXTI_LINE) == SET) // 中断标志位为1,按键按下
{
if(gpio_input_bit_get(BSP_KEY_PORT,BSP_KEY_PIN) == SET) // 按键按下
{
/* 执行功能 */
printf("key press!\r\n");
gpio_bit_toggle(BSP_LED2_PORT,BSP_LED2_PIN); // led电平状态翻转
}else{
// 按键释放
printf("key release!\r\n");
}
exti_interrupt_flag_clear(BSP_KEY_EXTI_LINE); // 清中断标志位
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2.实验现象
关于这一章节的代码,在资源包的软件资料目录中。
烧写我们的代码之后,按下一次按键,开启LED2,再按下一次按键,关闭LED2,以此类推。每次按下按键都会打印key press!,松开按键都会打印key release!。如图2-1-1所示。