【正点原子STM32连载】第十三章 按键输入实验 摘自【正点原子】APM32F407最小系统板使用指南

1）实验平台：正点原子stm32f103战舰开发板V4
2）平台购买地址：https://detail.tmall.com/item.htm?id=609294757420
3）全套实验源码+手册+视频下载地址： http://www.openedv.com/thread-340252-1-1.html#

第十三章 按键输入实验

上一章中介绍了GPIO的输出模式，并用其控制LED的亮灭。在实际的应用尝尽中，还会需要使用到GPIO的输入模式，来获取外部的输入信号，例如获取按键的状态。通过本章的学习，读者将学习到GPIO作为输入模式的使用。
本章分为如下几个小节：
11.1 硬件设计
11.2 程序设计
11.3 下载验证

11.1 硬件设计
11.1.1 例程功能

1. 按下KEY0按键可控制LED0状态翻转，按下KEY_UP按键可控制LED1翻转。
   11.1.2 硬件资源
2. LED
   LED0 - PF9
   LED1 - PF10
3. 按键
   KEY0 - PE4
   KEY_UP - PA0
   11.1.3 原理图
   本章实验使用的两个APM32F407最小系统板板载按键，分别为KEY0按键和KEY_UP按键，其于板载MCU的连接原理图，如下图所示：
   

图11.1.3.1 按键与MCU的连接原理图
从上面的原理图中可以看出，KEY0按键和KEY_UP按键的一端连接到了电源正极，而另一端分别与MCU的PE4引脚和PA0引脚相连接，因此当任意一个按键被按下时，MCU对应的引脚都能够读取到高电平的状态，而当松开按键后，MCU对应的引脚读取到的电平状态却是是确定的，因此用于读取KEY0按键和KEY_UP按键的PE4引脚和PA0引脚不仅要配置为输入模式，还需要配置成下拉，使对应引脚在悬空时被下拉在电源负极。
11.2 程序设计
11.2.1 Geehy标准库的GPIO驱动
本章实验中要通过读取GPIO引脚的输入状态来判断按键是否被按下，以此来控制对应LED的状态翻转，因此对于判断按键的状态，需要以下几个步骤：
①：配置GPIO引脚为输入模式和下拉
②：读取GPIO引脚的输入状态
在Geehy标准库中对应的驱动函数如下：
①：配置GPIO引脚
请见第10.2.1小节中配置GPIO引脚的相关内容。
②：读取GPIO引脚输入电平
该函数用于读取GPIO引脚的输入电平（高电平或低电平），其函数原型如下所示：
uint8_t GPIO_ReadInputBit(GPIO_T* port, uint16_t pin);
该函数的形参描述，如下表所示：

表11.2.1.1 函数GPIO_ReadInputBit()形参描述
该函数的返回值描述，如下表所示：

表11.2.1.2 函数GPIO_ReadInputBit()返回值描述
该函数的使用示例，如下所示：

#include "apm32f4xx.h"
#include "apm32f4xx_gpio.h"

void example_fun(void)
{
    uint8_t value;
    
    /* 读取PA0引脚输入电平 */
    value = GPIO_ReadInputBit(GPIOA, GPIO_PIN_0);
    
    if (value == BIT_SET)
    {
        /* Do something. */
    }
    else
    {
        /* Do something. */
    }
}

11.2.2 按键驱动
按键驱动主要就是读取GPIO引脚的输入状态，以此判断按键是否被按下，本章实验中，按键的驱动代码包括key.c和key.h两个文件。
根据原理图可知，应当将PE4引脚和PA0引脚配置为输入模式和下拉，并在需要读取KEY0按键（KEY_UP按键）状态的时候，读取PE4引脚（PA0引脚）的输入电平，若读取到PE4引脚（PA0引脚）的输入电平为高电平，则说明KEY0按键（KEY_UP按键）被按下，反之，则说明KEY0按键（KEY_UP按键）没有被按下。
按键驱动中，对引脚的定义，如下所示：

#define KEY0_GPIO_PORT			GPIOE
#define KEY0_GPIO_PIN			GPIO_PIN_4
#define KEY0_GPIO_CLK_ENABLE()								\
    do {														\
    		RCM_EnableAHB1PeriphClock(RCM_AHB1_PERIPH_GPIOE);	\
    } while (0)

#define WKUP_GPIO_PORT			GPIOA
#define WKUP_GPIO_PIN			GPIO_PIN_0
#define WKUP_GPIO_CLK_ENABLE()								\
    do {														\
    		RCM_EnableAHB1PeriphClock(RCM_AHB1_PERIPH_GPIOA);	\
    } while (0)

按键驱动中，操作引脚的定义，如下所示：

#define KEY0	GPIO_ReadInputBit(KEY0_GPIO_PORT, KEY0_GPIO_PIN)
#define WK_UP	GPIO_ReadInputBit(WKUP_GPIO_PORT, 

WKUP_GPIO_PIN)
按键驱动中，按键的初始化函数，如下所示：

/**
 * @brief	初始化按键
 * @param	无
 * @retval	无
 */
void key_init(void)
{
    GPIO_Config_T gpio_init_struct;
    
    /* 使能时钟 */
    KEY0_GPIO_CLK_ENABLE();
    WKUP_GPIO_CLK_ENABLE();
    
    /* 配置KEY0引脚 */
    gpio_init_struct.pin	= KEY0_GPIO_PIN;		/* KEY0引脚 */
    gpio_init_struct.mode	= GPIO_MODE_IN;			/* 输入模式 */
    gpio_init_struct.pupd	= GPIO_PUPD_DOWN;		/* 下拉 */
    GPIO_Config(KEY0_GPIO_PORT, &gpio_init_struct);	/* 配置KEY0引脚 */
    
    /* 配置KEY_UP引脚 */
    gpio_init_struct.pin	= WKUP_GPIO_PIN;		/* KEY_UP引脚 */
    gpio_init_struct.mode	= GPIO_MODE_IN;			/* 输入模式 */
    gpio_init_struct.pupd	= GPIO_PUPD_DOWN;		/* 下拉 */
    GPIO_Config(WKUP_GPIO_PORT, &gpio_init_struct);	/* 配置KEY_UP引脚 */
}
按键的初始化函数中，使能了KEY0按键和KEY_UP按键对应引脚的GPIO端口时钟，并将其配置为输入模式和下拉。
按键的驱动中，扫描按键状态的函数，如下所示：
/**
 * @brief	扫描按键
 * @note	该函数具有响应优先级（同时按下多个按键）：KEY_UP > KEY0
 * @param	mode: 扫描模式
 * 	@arg 	不支持连按（当按键按下不放时，只有第一次调用会返回键值，
 * 			必须松开以后，再次按下才会返回其他键值）
 * 	@arg 	支持连续按（当按键按下不放时，每次调用该函数都会返回键值）
 * @retval	键值
 * 	@arg	KEY0_PRES: KEY0按下
 * 	@arg	WKUP_PRES: KEY_UP按下
 */
uint8_t key_scan(uint8_t mode)
{
    static uint8_t key_up = 1;					/* 按键松开标志 */
    uint8_t key_val = 0;
    
    if (mode == 1)								/* 支持连按 */
    {
    		key_up = 1;
    }
    
    /* 按键松开标志为1，且有按键按下 */
    if ((key_up == 1) && ((KEY0 == 1) || (WK_UP == 1)))
    {
    		key_up = 0;
    		delay_ms(10);							/* 去抖动 */
    		if (KEY0 == 1)
    		{
    			key_val = KEY0_PRES;
    		}
    		if (WK_UP == 1)
    		{
    			key_val = WKUP_PRES;
    		}
    }
    else if ((KEY0 == 0) && (WK_UP == 0))		/* 没有按键按下，标记按键松开 */
    {
    		key_up = 1;
    }
    
    return key_val;								/* 返回键值 */
}

以上函代码就实现了按键扫描，且具有按键消抖的功能。
11.2.3 实验应用代码
本章实验的应用代码，如下所示：

int main(void)
{
    uint8_t key;
    
    NVIC_ConfigPriorityGroup(NVIC_PRIORITY_GROUP_3);	/* 设置中断优先级分组为组3 */
    sys_apm32_clock_init(336, 8, 2, 7);					/* 配置系统时钟 */
    delay_init(168);										/* 初始化延时功能 */
    usart_init(115200);									/* 初始化串口 */
    led_init();											/* 初始化LED */
    key_init();											/* 初始化按键 */
    
    while (1)
    {
    		key = key_scan(0);		/* 扫描按键 */
    		
    		switch (key)
    		{
    			case KEY0_PRES:		/* KEY0被按下 */
    			{
    				LED0_TOGGLE();	/* LED0状态翻转 */
    				break;
    			}
    			case WKUP_PRES:		/* KEY_UP被按下 */
    			{
    				LED1_TOGGLE();	/* LED1状态翻转 */
    				break;
    			}
    			default:
    			{
    				break;
    			}
    		}
    		
    		delay_ms(10);
    }
}

可以看到应用代码中，在初始化完LED和按键后，就进入了一个while循环，在循环中，每间隔10毫秒就调用key_scan()函数扫描以此按键的状态，如果扫描到KEY0按键或KEY_UP按键被按下，则反转对应LED的亮灭状态。
11.3 下载验证
在完成编译和烧录操作后，可以看到板子上的LED0和LED1默认是处于熄灭的状态，若此时按下并释放一次KEY0按键，则能够看到LED0的亮灭状态发生了一次翻转，同样的，若此时按下并释放一次KEY_UP按键，则能够看到LED1的亮灭状态发生了一次翻转，与预期的实验现象效果相符。