STM32MP157驱动开发——按键驱动（查询方式）

概述

通过阅读博文：APP 访问硬件的 4 种方式，可以知道这 4 种方法并不仅仅用于 GPIO 按键，在所有的APP 调用驱动程序过程中，都是使用这些方法。

所以：

1. APP 开发的基本技能：阻塞 、非阻塞、休眠、poll、异步通知

2. 相应的驱动的基本技能：中断、休眠、唤醒、poll 等机制【这些基本技能是驱动开发的基础，其他大型驱动复杂的地方是它的框架及设计思想】

APP 读取按键的 4 种方法

四种方法：

• ① 查询方式
• ② 休眠-唤醒方式
• ③ poll 方式
• ④ 异步通知方式

第 2、3、4 种方法，都涉及中断服务程序。中断时，它会做某些事情：唤醒 APP、向 APP 发信号。所以，在按键驱动程序中，中断是核心。实际上，中断无论是在单片机还是在 Linux 中都很重要。在 Linux 中，中断的知识还涉及进程、线程等（中断上下文，保存资源等）

查询方式

驱动程序中构造、注册一个 file_operations 结构体，里面提供有对应的open,read 函数。APP 调用 open 时，导致驱动中对应的 open 函数被调用，在里面配置 GPIO 为输入引脚。APP 调用 read 时，导致驱动中对应的 read 函数被调用，它读取寄存器，把引脚状态直接返回给 APP。

休眠-唤醒方式

驱动程序中构造、注册一个 file_operations 结构体，里面提供有对应的open,read 函数。APP 调用 open 时，导致驱动中对应的 open 函数被调用，在里面配置 GPIO 为输入引脚；并且注册 GPIO 的中断处理函数。

APP 调用 read 时，导致驱动中对应的 read 函数被调用，如果有按键数据则直接返回给 APP；否则 APP 在内核态休眠。

当用户按下按键时，GPIO 中断被触发，导致驱动程序之前注册的中断服务程序被执行。它会记录按键数据，并唤醒休眠中的 APP。APP 被唤醒后继续在内核态运行，即继续执行驱动代码，把按键数据返回给 APP(的用户空间)。

poll 方式

poll 方式就相当于定个闹钟

驱动程序中构造、注册一个 file_operations 结构体，里面提供有对应的open,read,poll 函数。APP 调用 open 时，导致驱动中对应的 open 函数被调用，在里面配置 GPIO为输入引脚；并且注册 GPIO 的中断处理函数。

APP 调用 poll 或 select 函数，意图是“查询”是否有数据，这 2 个函数都可以指定一个超时时间，即在这段时间内没有数据的话就返回错误，这会导致驱动中对应的 poll 函数被调用。如果有按键数据则直接返回给 APP；否则APP 在内核态休眠一段时间。

当用户按下按键时，GPIO 中断被触发，导致驱动程序之前注册的中断服务程序被执行。它会记录按键数据，并唤醒休眠中的 APP。如果用户没按下按键，但是超时时间到了，内核也会唤醒 APP。

所以 APP 被唤醒有 2 种原因：用户操作了按键，超时。被唤醒的 APP 在内核态继续运行，即继续执行驱动代码，把“状态”返回给 APP(的用户空间)。APP 得到 poll/select 函数的返回结果后，如果确认是有数据的，则再调用 read 函数，这会导致驱动中的 read 函数被调用，这时驱动程序中含有数据，会直接返回数据。

休眠-唤醒和poll方式的区别在于唤醒的方式，以及唤醒后App首先收到的是立即调用read指令还是根据 poll/select 函数的返回结果决定是否调用read指令

异步通知方式

异步通知的实现原理是：内核给 APP 发信号。信号有很多种，这里发的是SIGIO。

驱动程序中构造、注册一个 file_operations 结构体，里面提供有对应的open,read,fasync 函数。APP 调用 open 时，导致驱动中对应的 open 函数被调用，在里面配置 GPIO为输入引脚；并且注册 GPIO 的中断处理函数。

APP 给信号 SIGIO 注册自己的处理函数：my_signal_fun。

APP 调用 fcntl 函数，把驱动程序的 flag 改为 FASYNC，这会导致驱动程序的 drv_fasync 函数被调用，它只是简单记录进程 PID。

当用户按下按键时，GPIO 中断被触发，导致驱动程序之前注册的中断服务程序被执行。它会记录按键数据，然后给进程 PID 发送 SIGIO 信号（利用kill_fasync函数）。 APP 收到信号后会被打断，先执行注册的信号处理函数my_signal_fun：在信号处理函数中可以去调用 read 函数读取按键值。信号处理函数返回后，APP 会继续执行原先被打断的代码。

查询方式的按键驱动程序（框架）

按键驱动编写思路

GPIO 按键的原理图一般有如下 2 种：

• 按键没被按下时，上图中左边的 GPIO 电平为高，右边的 GPIO 电平为低。
• 按键被按下后，上图中左边的 GPIO 电平为低，右边的 GPIO 电平为高。

按键驱动框架：

采用分层的思想编写按键驱动：写出一个容易扩展到各种芯片、各种板子的按键驱动程序，所以驱动程序分为上下两层。参考LED驱动：STM32MP157驱动开发——LED驱动（原始架构优化：分层/分离）

1. button_drv.c ：分配/设置/注册 file_operations 结构体
   起承上启下的作用，向上提供 button_open,button_read 供 APP 调用。而这 2 个函数又会调用底层硬件提供的 p_button_opr 中的 init、read函数操作硬件。

2. board_xxx.c 分配/设置/注册 button_operations 结构体
   里面定义单板 xxx 的按键操作函数。这样的结构易于扩展，对于不同的单板，只需要替换 board_xxx.c 提供自己的 button_operations 结构体即可。

board_xxx.c

注意 ：凡是有分配、设置、注册结构体的源文件，都有入口函数的定义，出口函数的定义，入口函数注册该结构体，出口函数销毁该结构体

#include <linux/module.h>
#include <linux/errno.h>
#include <linux/kernel.h>
#include <linux/major.h>
#include <linux/sched.h>
#include <linux/slab.h>
#include <linux/fcntl.h>
#include <linux/fs.h>
#include <linux/signal.h>
#include <linux/mutex.h>
#include <linux/mm.h>
#include <linux/timer.h>
#include <linux/wait.h>
#include <linux/skbuff.h>
#include <linux/proc_fs.h>
#include <linux/poll.h>
#include <linux/capi.h>
#include <linux/kernelcapi.h>
#include <linux/init.h>
#include <linux/device.h>
#include <linux/moduleparam.h>

#include "button_drv.h"


static void board_xxx_button_init_gpio (int which)
{
   
   
    printk("%s %s %d, init gpio for button %d\n", __FILE__, __FUNCTION__, __LINE__, which);
}

static int board_xxx_button_read_gpio (int which)
{
   
   
    printk("%s %s %d, read gpio for button %d\n", __FILE__, __FUNCTION__, __LINE__, which);
    //固定写1返回
    return 1;
}

static struct button_operations my_buttons_ops ={
   
   
    .count = 2,
    .init  = board_xxx_button_init_gpio,
    .read  = board_xxx_button_read_gpio,
};

int board_xxx_button_init(void)
{
   
   
    register_button_operations(&my_buttons_ops);
    return 0;
}

void board_xxx_button_exit(void)
{
   
   
    unregister_button_operations();
}

module_init(board_xxx_button_init);
module_exit(board_xxx_button_exit);

MODULE_LICENSE(