Linux学习笔记11---按键输入

I.MX6U 的 IO 不仅能作为输出，而且也可以作为输入。I.MX6U-ALPHA 开发板上有一个按键，按键连接了一个 IO，将这个 IO 配置为输入功能，读取这个 IO 的值即可获取按键的状态(按下或松开)。本章通过这个按键来控制蜂鸣器的开关。

1、 硬件原理分析

本试验我们用到的硬件有：
1） LED 灯 LED0。
2）蜂鸣器。
3）1 个按键 KEY0。
按键 KEY0 的原理图如图所示

按键 KEY0 是连接到 I.MX6U 的 UART1_CTS 这个 IO 上的，KEY0接了一个 10K 的上拉电阻，因此 KEY0 没有按下的时候 UART1_CTS 应该是高电平，当 KEY0按下以后 UART1_CTS 就是低电平。

2、实验程序编写

        本试验在上一章试验例程的基础上完成，重新创建 VSCode 工程，工作区名字为“key”，在工程目录的 bsp 文件夹中创建名为“key”和“gpio”两个文件夹。按键相关的驱动文件都放到“key”文件夹中，本章试验我们对 GPIO 的操作编写一个函数集合，也就是编写一个 GPIO驱动文件，GPIO 的驱动文件放到“gpio”文件夹里面。

        新建 bsp_gpio.c 和 bsp_gpio.h 这两个文件，将这两个文件都保存到刚刚创建的 bsp/gpio 文件夹里面，然后在 bsp_gpio.h 文件夹里面输入如下内容：

#ifndef _BSP_GPIO_H
#define _BSP_GPIO_H
#define _BSP_KEY_H
#include "imx6ul.h"

/* 枚举类型和结构体定义 */
typedef enum _gpio_pin_direction
{
    kGPIO_DigitalInput = 0U,  		/* 输入 */
    kGPIO_DigitalOutput = 1U, 		/* 输出 */
} gpio_pin_direction_t;
	

typedef struct _gpio_pin_config
{
    gpio_pin_direction_t direction; /* GPIO方向:输入还是输出 */
    uint8_t outputLogic;            /* 如果是输出的话，默认输出电平 */
} gpio_pin_config_t;


/* 函数声明 */
void gpio_init(GPIO_Type *base, int pin, gpio_pin_config_t *config);
int gpio_pinread(GPIO_Type *base, int pin);
void gpio_pinwrite(GPIO_Type *base, int pin, int value);

#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 中输入如下所示内容：

#include "bsp_gpio.h"


/*
 * @description		: GPIO初始化。
 * @param - base	: 要初始化的GPIO组。
 * @param - pin		: 要初始化GPIO在组内的编号。
 * @param - config	: GPIO配置结构体。
 * @return 			: 无
 */
void gpio_init(GPIO_Type *base, int pin, gpio_pin_config_t *config)
{
	if(config->direction == kGPIO_DigitalInput) /* 输入 */
	{
		base->GDIR &= ~( 1 << pin);
	}
	else										/* 输出 */
	{
		base->GDIR |= 1 << pin;
		gpio_pinwrite(base,pin, config->outputLogic);/* 设置默认输出电平 */
	}
}

 /*
  * @description	 : 读取指定GPIO的电平值 。
  * @param - base	 : 要读取的GPIO组。
  * @param - pin	 : 要读取的GPIO脚号。
  * @return 		 : 无
  */
 int gpio_pinread(GPIO_Type *base, int pin)
 {
	 return (((base->DR) >> pin) & 0x1);
 }

 /*
  * @description	 : 指定GPIO输出高或者低电平 。
  * @param - base	 : 要输出的的GPIO组。
  * @param - pin	 : 要输出的GPIO脚号。
  * @param - value	 : 要输出的电平，1 输出高电平， 0 输出低低电平
  * @return 		 : 无
  */
void gpio_pinwrite(GPIO_Type *base, int pin, int value)
{
	 if (value == 0U)
	 {
		 base->DR &= ~(1U << pin); /* 输出低电平 */
	 }
	 else
	 {
		 base->DR |= (1U << pin); /* 输出高电平 */
	 }
}

        文件 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 文件夹里面输入如下内容：

#ifndef _BSP_KEY_H
#define _BSP_KEY_H
#include "imx6ul.h"


/* 定义按键值 */
enum keyvalue{
	KEY_NONE   = 0,
	KEY0_VALUE,
	KEY1_VALUE,
	KEY2_VALUE,
};

/* 函数声明 */
void key_init(void);
int key_getvalue(void);


#endif

bsp_key.h 文件中定义了一个枚举类型：keyvalue，此枚举类型表示按键值，因为I.MX6UALPHA 开发板上只有一个按键，因此枚举类型里面只到 KEY0_VALUE。在 bsp_key.c 中输入如下所示内容：

#include "bsp_key.h"
#include "bsp_gpio.h"
#include "bsp_delay.h"
void key_init(void)
{	
	gpio_pin_config_t key_config;
	
	/* 1、初始化IO复用, 复用为GPIO1_IO18 */
	IOMUXC_SetPinMux(IOMUXC_UART1_CTS_B_GPIO1_IO18,0);

	/* 2、、配置UART1_CTS_B的IO属性	
	 *bit 16:0 HYS关闭
	 *bit [15:14]: 11 默认22K上拉
	 *bit [13]: 1 pull功能
	 *bit [12]: 1 pull/keeper使能
	 *bit [11]: 0 关闭开路输出
	 *bit [7:6]: 10 速度100Mhz
	 *bit [5:3]: 000 关闭输出
	 *bit [0]: 0 低转换率
	 */
	IOMUXC_SetPinConfig(IOMUXC_UART1_CTS_B_GPIO1_IO18,0xF080);
	
	/* 3、初始化GPIO */
	//GPIO1->GDIR &= ~(1 << 18);	/* GPIO1_IO18设置为输入 */	
	key_config.direction = kGPIO_DigitalInput;
	gpio_init(GPIO1,18, &key_config);
	
}

/*
 * @description	: 获取按键值 
 * @param 		: 无
 * @return 		: 0 没有按键按下，其他值:对应的按键值
 */
int key_getvalue(void)
{
	int ret = 0;
	static unsigned char release = 1; /* 按键松开 */ 

	if((release==1)&&(gpio_pinread(GPIO1, 18) == 0)) 		/* KEY0 	*/
	{	
		delay(10);		/* 延时消抖 		*/
		release = 0;	/* 标记按键按下 */
		if(gpio_pinread(GPIO1, 18) == 0)
			ret = KEY0_VALUE;
	}
	else if(gpio_pinread(GPIO1, 18) == 1)
	{
		ret = 0;
		release = 1; 	/* 标记按键释放 */
	}

	return ret;	
}

        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 表示按键是否释放。

在 main.c 中输入如下代码：

#include "bsp_clk.h"
#include "bsp_delay.h"
#include "bsp_led.h"
#include "bsp_beep.h"
#include "bsp_key.h"

/*
 * @description	: main函数
 * @param 		: 无
 * @return 		: 无
 */
int main(void)
{
	int i = 0;
	int keyvalue = 0;
	unsigned char led_state = OFF;
	unsigned char beep_state = OFF;
	
	clk_enable();		/* 使能所有的时钟 			*/
	led_init();			/* 初始化led 			*/
	beep_init();		/* 初始化beep	 		*/
	key_init();			/* 初始化key 			*/
	
	while(1)			
	{	
		keyvalue = key_getvalue(); //查询按键状态
		if(keyvalue)
		{
			switch ((keyvalue))
			{
				case KEY0_VALUE:
					beep_state = !beep_state;
					beep_switch(beep_state);
					break;
			}
		}

		i++;
		if(i==50)
		{
			i = 0;
			led_state = !led_state;
			led_switch(LED0, led_state);
		}
		delay(10);	
	}

	return 0;
}

main.c 函数先初始化 led 灯、蜂鸣器和按键，然后在 while(1)循环中不断的调用函数key_getvalue 来读取按键值，如果 KEY0 按下的话就打开/关闭蜂鸣器。LED0 作为系统提示指示灯闪烁，闪烁周期大约为 500ms。本章例程的软件编写就到这里结束了，接下来就是编译下载验证了。

3、编写 Makefile 和链接脚本

Makefile 使用上一章编写的通用 Makefile，修改变量 TARGET 为 key，在变量 INCDIRS和 SRCDIRS 中追加“bsp/gpio”和“bsp/key”，修改完成以后如下所示：

CROSS_COMPILE 	?= arm-linux-gnueabihf-
TARGET		  	?= key

CC 				:= $(CROSS_COMPILE)gcc
LD				:= $(CROSS_COMPILE)ld
OBJCOPY 		:= $(CROSS_COMPILE)objcopy
OBJDUMP 		:= $(CROSS_COMPILE)objdump

INCDIRS 		:= imx6ul \
				   bsp/clk \
				   bsp/led \
				   bsp/delay \
				   bsp/beep \
				   bsp/gpio \
				   bsp/key 
				   			   
SRCDIRS			:= project \
				   bsp/clk \
				   bsp/led \
				   bsp/delay \
				   bsp/beep \ 
				   bsp/gpio \
				   bsp/key
				   
				   
INCLUDE			:= $(patsubst %, -I %, $(INCDIRS))

SFILES			:= $(foreach dir, $(SRCDIRS), $(wildcard $(dir)/*.S))
CFILES			:= $(foreach dir, $(SRCDIRS), $(wildcard $(dir)/*.c))

SFILENDIR		:= $(notdir  $(SFILES))
CFILENDIR		:= $(notdir  $(CFILES))

SOBJS			:= $(patsubst %, obj/%, $(SFILENDIR:.S=.o))
COBJS			:= $(patsubst %, obj/%, $(CFILENDIR:.c=.o))
OBJS			:= $(SOBJS) $(COBJS)

VPATH			:= $(SRCDIRS)

.PHONY: clean
	
$(TARGET).bin : $(OBJS)
	$(LD) -Timx6ul.lds -o $(TARGET).elf $^
	$(OBJCOPY) -O binary -S $(TARGET).elf $@
	$(OBJDUMP) -D -m arm $(TARGET).elf > $(TARGET).dis

$(SOBJS) : obj/%.o : %.S
	$(CC) -Wall -nostdlib -c -O2  $(INCLUDE) -o $@ $<

$(COBJS) : obj/%.o : %.c
	$(CC) -Wall -nostdlib -c -O2  $(INCLUDE) -o $@ $<
	
clean:
	rm -rf $(TARGET).elf $(TARGET).dis $(TARGET).bin $(COBJS) $(SOBJS)
	

第 2 行修改变量 TARGET 为“key”，也就是目标名称为“key”。

4、编译下载

使用 Make 命令编译代码，编译成功以后使用软件 imxdownload2 将编译完成的 bsp.bin 文件生成可执行的img文件，命令如下：

make 
./imxdownload2 key.bin

如果  imxdownload2无权限，可用以下命令添加权限

chmod 777 imxdownload2

 

利用Win32DiskImager软件将load.img执行文件写入SD卡，SD卡插入开发板上即可正常运行。如果代码运行正常的话 LED0 会以大约 500ms 周期闪烁， 按下开发板上的 KEY0 按键，蜂鸣器打开，再按下 KEY0按键，蜂鸣器关闭。

5、例程

【免费】Linux学习笔记11-按键输入资源-CSDN文库