【正点原子Linux连载】第十五章按键输入试验-摘自【正点原子】I.MX6U嵌入式Linux驱动开发指南V1.0
1）实验平台：正点原子阿尔法Linux开发板
2）平台购买地址：https://item.taobao.com/item.htm?id=603672744434
2）全套实验源码+手册+视频下载地址：http://www.openedv.com/thread-300792-1-1.html
3）对正点原子Linux感兴趣的同学可以加群讨论：935446741
4）关注正点原子公众号，获取最新资料更新
第十五章按键输入试验
前面几章试验都是讲解如何使用I.MX6U的GPIO输出控制功能，I.MX6U的IO不仅能作为输出，而且也可以作为输入。I.MX6U-ALPHA开发板上有一个按键，按键连接了一个IO，将这个IO配置为输入功能，读取这个IO的值即可获取按键的状态(按下或松开)。本章通过这个按键来控制蜂鸣器的开关，通过本章的学习你将掌握如何将I.MX6UL的IO作为输入来使用。
15.1按键输入简介
按键就两个状态：按下或弹起，将按键连接到一个IO上，通过读取这个IO的值就知道按键是按下的还是弹起的。至于按键按下的时候是高电平还是低电平要根据实际电路来判断。前面几章我们都是讲解I.MX6U的GPIO作为输出使用，当GPIO连接按键的时候就要做为输入使用。关于I.MX6U的GPIO已经在第八章详细的讲解了，本章我们的主要工作就是配置按键所连接的IO为输入功能，然后读取这个IO的值来判断按键是否按下。
I.MX6U-ALPHA开发板上有一个按键KEY0，本章我们将会编写代码通过这个KEY0按键来控制开发板上的蜂鸣器，按一下KEY0蜂鸣器打开，再按一下蜂鸣器就关闭。
15.2 硬件原理分析
本试验我们用到的硬件有：
1） LED灯LED0。
2）蜂鸣器。
3）1个按键KEY0。
按键KEY0的原理图如图15.2.1所示：
图15.2.1 按键原理图
从图15.2.1可以看出，按键KEY0是连接到I.MX6U的UART1_CTS这个IO上的，KEY0接了一个10K的上拉电阻，因此KEY0没有按下的时候UART1_CTS应该是高电平，当KEY0按下以后UART1_CTS就是低电平。
15.3实验程序编写
本实验对应的例程路径为：开发板光盘-> 1、裸机例程->7_key。
本试验在上一章试验例程的基础上完成，重新创建VSCode工程，工作区名字为“key”，在工程目录的bsp文件夹中创建名为“key”和“gpio”两个文件夹。按键相关的驱动文件都放到“key”文件夹中，本章试验我们对GPIO的操作编写一个函数集合，也就是编写一个GPIO驱动文件，GPIO的驱动文件放到“gpio”文件夹里面。
新建bsp_gpio.c和bsp_gpio.h这两个文件，将这两个文件都保存到刚刚创建的bsp/gpio文件夹里面，然后在bsp_gpio.h文件夹里面输入如下内容：
示例代码15.3.1 bsp_gpio.h文件代码
1 #ifndef _BSP_GPIO_H
2 #define _BSP_GPIO_H
3 #define _BSP_KEY_H
4 #include "imx6ul.h"
5/***************************************************************
6 Copyright © zuozhongkai Co., Ltd. 1998-2019. All rights reserved.
7文件名 : bsp_gpio.h
8作者 : 左忠凯
9版本 : V1.0
10描述 : GPIO操作文件头文件。
11其他 : 无
12论坛 : www.openedv.com
13日志 : 初版V1.0 2019/1/4 左忠凯创建
14 ***************************************************************/
15
16/* 枚举类型和结构体定义 */
17typedefenum _gpio_pin_direction
18{
19 kGPIO_DigitalInput =0U,/* 输入 */
20 kGPIO_DigitalOutput =1U,/* 输出 */
21} gpio_pin_direction_t;
22
23/* GPIO配置结构体 */
24typedefstruct _gpio_pin_config
25{
26 gpio_pin_direction_t direction;/* GPIO方向:输入还是输出 */
27uint8_t outputLogic; /* 如果是输出的话，默认输出电平 */
28} gpio_pin_config_t;
29
30
31/* 函数声明 */
32void gpio_init(GPIO_Type *base,int pin, gpio_pin_config_t *config);
33int gpio_pinread(GPIO_Type *base,int pin);
34void gpio_pinwrite(GPIO_Type *base,int pin,int value);
35
36 #endif
bsp_gpio.h中定义了一个枚举类型gpio_pin_direction_t和结构体gpio_pin_config_t，枚举类型gpio_pin_direction_t表示GPIO方向，输入或输出。结构体gpio_pin_config_t是GPIO的配置结构体，里面有GPIO的方向和默认输出电平两个成员变量。在bsp_gpio.c中输入如下所示内容：
示例代码15.3.2 bsp_gpio.c文件代码
1 #include "bsp_gpio.h"
2/***************************************************************
3 Copyright © zuozhongkai Co., Ltd. 1998-2019. All rights reserved.
4文件名 : bsp_gpio.h
5作者 : 左忠凯
6版本 : V1.0
7描述 : GPIO操作文件。
8其他 : 无
9论坛 : www.openedv.com
10日志 : 初版V1.0 2019/1/4 左忠凯创建
11 ***************************************************************/
12
13/*
14 * @description : GPIO初始化。
15 * @param - base : 要初始化的GPIO组。
16 * @param - pin : 要初始化GPIO在组内的编号。
17 * @param - config : GPIO配置结构体。
18 * @return : 无
19 */
20void gpio_init(GPIO_Type *base,int pin, gpio_pin_config_t *config)
21{
22 if(config->direction == kGPIO_DigitalInput) /* 输入 */
23 {
24 base->GDIR &=~(1<< pin);
25 }
26 else /* 输出 */
27 {
28 base->GDIR |=1<< pin;
29 gpio_pinwrite(base,pin, config->outputLogic);/* 默认输出电平 */
30 }
31}
32
33/*
34 * @description : 读取指定GPIO的电平值。
35 * @param – base : 要读取的GPIO组。
36 * @param - pin : 要读取的GPIO脚号。
37 * @return : 无
38 */
39int gpio_pinread(GPIO_Type *base,int pin)
40{
41 return(((base->DR)>> pin)&0x1);
42}
43
44/*
45 * @description : 指定GPIO输出高或者低电平。
46 * @param – base : 要输出的的GPIO组。
47 * @param - pin : 要输出的GPIO脚号。
48 * @param – value : 要输出的电平，1 输出高电平， 0 输出低低电平
49 * @return : 无
50 */
51void gpio_pinwrite(GPIO_Type *base,int pin,int value)
52{
53 if(value ==0U)
54 {
55 base->DR &=~(1U<< pin);/* 输出低电平 */
56 }
57 else
58 {
59 base->DR |=(1U<< pin);/* 输出高电平 */
60 }
61}
文件bsp_gpio.c中有三个函数：gpio_init、gpio_pinread和gpio_pinwrite，函数gpio_init用于初始化指定的GPIO引脚，最终配置的是GDIR寄存器，此函数有三个参数，这三个参数的含义如下：
base:要初始化的GPIO所属于的GPIO组，比如GPIO1_IO18就属于GPIO1组。
pin：要初始化GPIO在组内的标号，比如GPIO1_IO18在组内的编号就是18。
config:要初始化的GPIO配置结构体，用来指定GPIO配置为输出还是输入。
函数gpio_pinread是读取指定的GPIO值，也就是读取DR寄存器的指定位，此函数有两个参数和一个返回值，参数含义如下：
base:要读取的GPIO所属于的GPIO组，比如GPIO1_IO18就属于GPIO1组。
pin：要读取的GPIO在组内的标号，比如GPIO1_IO18在组内的编号就是18。
返回值：读取到的GPIO值，为0或者1。
函数gpio_pinwrite是控制指定的GPIO引脚输入高电平(1)或者低电平(0)，就是设置DR寄存器的指定位，此函数有三个参数，参数含义如下：
base:要设置的GPIO所属于的GPIO组，比如GPIO1_IO18就属于GPIO1组。
pin：要设置的GPIO在组内的标号，比如GPIO1_IO18在组内的编号就是18。
value:要设置的值，1(高电平)或者0(低电平)。
我们以后就可以使用函数gpio_init设置指定GPIO为输入还是输出，使用函数gpio_pinread和gpio_pinwrite来读写指定的GPIO，文件bsp_gpio.c文件就讲解到这里。
接下来编写按键驱动文件，新建bsp_key.c和bsp_key.h这两个文件，将这两个文件都保存到刚刚创建的bsp/key文件夹里面，然后在bsp_key.h文件夹里面输入如下内容：
示例代码15.3.3 bsp_key.h文件代码
1 #ifndef _BSP_KEY_H
2 #define _BSP_KEY_H
3 #include "imx6ul.h"
4/***************************************************************
5 Copyright © zuozhongkai Co., Ltd. 1998-2019. All rights reserved.
6文件名 : bsp_key.h
7作者 : 左忠凯
8版本 : V1.0
9描述 : 按键驱动头文件。
10其他 : 无
11论坛 : www.openedv.com
12日志 : 初版V1.0 2019/1/4 左忠凯创建
13 ***************************************************************/
14
15/* 定义按键值 */
16enum keyvalue{
17 KEY_NONE =0,
18 KEY0_VALUE,
19};
20
21/* 函数声明 */
22void key_init(void);
23int key_getvalue(void);
24
25 #endif
bsp_key.h文件中定义了一个枚举类型：keyvalue，此枚举类型表示按键值，因为I.MX6U-ALPHA开发板上只有一个按键，因此枚举类型里面只到KEY0_VALUE。在bsp_key.c中输入如下所示内容：
示例代码15.3.4 bsp_key.c文件代码
1 #include "bsp_key.h"
2 #include "bsp_gpio.h"
3 #include "bsp_delay.h"
4/***************************************************************
5 Copyright © zuozhongkai Co., Ltd. 1998-2019. All rights reserved.
6文件名 : bsp_key.c
7作者 : 左忠凯
8版本 : V1.0
9描述 : 按键驱动文件。
10其他 : 无
11论坛 : www.openedv.com
12 日志 : 初版V1.0 2019/1/4 左忠凯创建
13 ***************************************************************/
14
15/*
16 * @description : 初始化按键
17 * @param : 无
18 * @return : 无
19 */
20void key_init(void)
21{
22 gpio_pin_config_t key_config;
23
24 /* 1、初始化IO复用, 复用为GPIO1_IO18 */
25 IOMUXC_SetPinMux(IOMUXC_UART1_CTS_B_GPIO1_IO18, 0);
26
27 /* 2、、配置UART1_CTS_B的IO属性
28 *bit 16:0 HYS关闭
29 *bit [15:14]: 11 默认22K上拉
30 *bit [13]: 1 pull功能
31 *bit [12]: 1 pull/keeper使能
32 *bit [11]: 0 关闭开路输出
33 *bit [7:6]: 10 速度100Mhz
34 *bit [5:3]: 000 关闭输出
35 *bit [0]: 0 低转换率
36 */
37 IOMUXC_SetPinConfig(IOMUXC_UART1_CTS_B_GPIO1_IO18, 0xF080);
38
39 /* 3、初始化GPIO GPIO1_IO18设置为输入*/
40 key_config.direction = kGPIO_DigitalInput;
41 gpio_init(GPIO1,18,&key_config);
42
43}
44
45 /*
46 * @description : 获取按键值
47 * @param : 无
48 * @return : 0 没有按键按下，其他值:对应的按键值
49 */
50int key_getvalue(void)
51{
52 int ret =0;
53 staticunsignedchar release =1; /* 按键松开 */
54
55 if((release==1)&&(gpio_pinread(GPIO1,18)==0))/* KEY0按下 */
56 {
57 delay(10);/* 延时消抖 */
58 release =0;/* 标记按键按下 */
59 if(gpio_pinread(GPIO1,18)==0)
60 ret = KEY0_VALUE;
61 }
62 elseif(gpio_pinread(GPIO1,18)==1) /* KEY0未按下 */
63 {
64 ret =0;
65 release =1;/* 标记按键释放 */
66 }
67
68 return ret;
69}
bsp_key.c中一共有两个函数：key_init和key_getvalue，key_init是按键初始化函数，用来初始化按键所使用的UART1_CTS这个IO。函数key_init先设置UART1_CTS复用为GPIO1_IO18，然后配置UART1_CTS这个IO为速度为100MHz，默认22K上拉。最后调用函数gpio_init来设置GPIO1_IO18为输入功能。
函数key_getvalue用于获取按键值，此函数没有参数，只有一个返回值，返回值表示按键值，返回值为0的话就表示没有按键按下，如果返回其他值的话就表示对应的按键按下了。获取按键值其实就是不断的读取GPIO1_IO18的值，如果按键按下的话相应的IO被拉低，那么GPIO1_IO18值就为0，如果按键未按下的话GPIO1_IO18的值就为1。此函数中静态局部变量release表示按键是否释放。
“示例代码15.3.4”中的57行是按键消抖延时函数，延时时间大约为10ms，用于消除按键抖动。理想型的按键电压变化过程如图15.3.1所示：
图15.3.1 理想的按键电压变化过程
在图15.3.1中，按键没有按下的时候按键值为1，当按键在t1时刻按键被按下以后按键值就变为0，这是最理想的状态。但是实际的按键是机械结构，加上刚按下去的一瞬间人手可能也有抖动，实际的按键电压变化过程如图15.3.2所示：
图15.3.2实际的按键电压变化过程
在图15.3.2中t1时刻按键被按下，但是由于抖动的原因，直到t2时刻才稳定下来，t1到t2这段时间就是抖动。一般这段时间就是十几ms左右，从图15.3.2中可以看出在抖动期间会有多次触发，如果不消除这段抖动的话软件就会误判，本来按键就按下了一次，结果软件读取IO值发现电平多次跳变以为按下了多次。所以我们需要跳过这段抖动时间再去读取按键的IO值，也就是至少要在t2时刻以后再去读IO值。在“示例代码15.3.4”中的57行是延时了大约10ms后再去读取GPIO1_IO18的IO值，如果此时按键的值依旧是0，那么就表示这是一次有效的按键触发。
按键驱动就讲解到这里，最后就是main.c文件的内容了，在main.c中输入如下代码：
示例代码15.3.5 main.c文件代码
/**************************************************************
Copyright © zuozhongkai Co., Ltd. 1998-2019. All rights reserved.
文件名 : mian.c
作者 : 左忠凯
版本 : V1.0
描述 : I.MX6U开发板裸机实验7 按键输入实验
其他 : 本实验主要学习如何配置I.MX6U的GPIO作为输入来使用，通过
开发板上的按键控制蜂鸣器的开关。
论坛 : www.openedv.com
日志 : 初版V1.0 2019/1/4 左忠凯创建
**************************************************************/
1 #include "bsp_clk.h"
2 #include "bsp_delay.h"
3 #include "bsp_led.h"
4 #include "bsp_beep.h"
5 #include "bsp_key.h"
6
7/*
8 * @description : main函数
9 * @param : 无
10 * @return : 无
11 */
12int main(void)
13{
14 int i =0;
15 int keyvalue =0;
16 unsignedchar led_state = OFF;
17 unsignedchar beep_state = OFF;
18
19 clk_enable();/* 使能所有的时钟 */
20 led_init();/* 初始化led */
21 beep_init();/* 初始化beep */
22 key_init();/* 初始化key */
23
24 while(1)
25 {
26 keyvalue = key_getvalue();
27 if(keyvalue)
28 {
29 switch(keyvalue)
30 {
31 case KEY0_VALUE:
32 beep_state =!beep_state;
33 beep_switch(beep_state);
34 break;
35 }
36 }
37 i++;
38 if(i==50)
39 {
40 i =0;
41 led_state =!led_state;
42 led_switch(LED0, led_state);
43 }
44 delay(10);
45 }
46 return0;
47}
main.c函数先初始化led灯、蜂鸣器和按键，然后在while(1)循环中不断的调用函数key_getvalue来读取按键值，如果KEY0按下的话就打开/关闭蜂鸣器。LED0作为系统提示指示灯闪烁，闪烁周期大约为500ms。本章例程的软件编写就到这里结束了，接下来就是编译下载验证了。
15.4编译下载验证
15.4.1编写Makefile和链接脚本
Makefile使用第十三章编写的通用Makefile，修改变量TARGET为key，在变量INCDIRS和SRCDIRS中追加“bsp/gpio”和“bsp/key”，修改完成以后如下所示：
示例代码15.4.1.1 Makefile文件代码
1 CROSS_COMPILE ?= arm-linux-gnueabihf-
2 TARGET ?=key
3
4/* 省略掉其它代码...... */
5
6 INCDIRS := imx6ul \
7 bsp/clk \
8 bsp/led \
9 bsp/delay \
10 bsp/beep \
11 bsp/gpio \
12 bsp/key
13
14 SRCDIRS := project \
15 bsp/clk \
16 bsp/led \
17 bsp/delay \
18 bsp/beep \
19 bsp/gpio \
20 bsp/key
21
22/* 省略掉其它代码...... */
23
24 clean:
25 rm -rf $(TARGET).elf $(TARGET).dis $(TARGET).bin $(COBJS)$(SOBJS)
第2行修改变量TARGET为“key”，也就是目标名称为“key”。
第11、12行在变量INCDIRS中添加GPIO和按键驱动头文件(.h)路径。
第19、20行在变量SRCDIRS中添加GPIO和按键驱动文件(.c)路径。
链接脚本就使用第十三章试验中的链接脚本文件imx6ul.lds即可。
15.4.2编译下载
使用Make命令编译代码，编译成功以后使用软件imxdownload将编译完成的key.bin文件下载到SD卡中，命令如下：
chmod 777 imxdownload //给予imxdownload可执行权限，一次即可
./imxdownload key.bin /dev/sdd //烧写到SD卡中
烧写成功以后将SD卡插到开发板的SD卡槽中，然后复位开发板。如果代码运行正常的话LED0会以大约500ms周期闪烁，按下开发板上的KEY0按键，蜂鸣器打开，再按下KEY0按键，蜂鸣器关闭。