字符设备驱动 框架（未完）

字符设备是指在I/O传输过程中以字符为单位进行传输的设备，通过字符流的方式进行数据读写，按照顺序逐个处理数据

特点：

        逐个字符读写

        顺序访问：不支持随机访问

        无缓冲区：字符设备通常没有内部缓冲区，数据会立即传输到设备或从设备中读取。这意味着字符设备的读写操作是实时的，不会有额外的延迟

        文件系统中的字符设备：在Linux系统中一切皆文件，字符设备驱动加载成功后会在 /dev 下生成设备节点文件，通过操作这些特殊文件，可以实现操作硬件设备的目的

Linux 应用程序控制硬件

用户空间中的应用程序通过系统调用，实现内核空间中的驱动对硬件的操控。每一个系统调用函数都有一个驱动函数与之对应

应用程序用统一的、各平台通用的、可能需要另下载的普通库函数编写，每个 API 都可以调用一个或多个甚至零个系统调用函数，而不需要与之一一对应，Linux 内核提供了一些C函数库对系统调用进行了一些包装和扩展，兼容了各普通库函数对系统调用函数的调用，又因为这些库函数与系统调用的关系非常紧密，所以习惯上把这些函数也称为系统调用

系统调用是用户进入内核的接口层，它本身并非内核函数，在进入内核后，不同的系统调用会找到各自对应的内核函数，这些内核函数为系统调用的“服务例程”，而系统调用则是内核函数的“封装例程”，标准C库为每个系统调用设置了一个封装例程，系统调用已属于Linux内核，所以由此向下不再存在兼容与否的问题。另外在陷入内核前，进程会保存现场后挂起，等待系统调用完毕，之后恢复现场继续运行，这点和中断处理类似

在 Linux 内核文件 include/linux/fs.h 中描述了 file_operations 结构体，是 Linux 内核驱动操作函数的集合

struct file_operations {
    //owner 拥有该结构体的模块的指针，一般设置为 THIS_MODULE
	struct module *owner;
    //llseek 函数用于修改文件当前的读写位置
	loff_t (*llseek) (struct file *, loff_t, int);
    //read 函数用于读取设备文件
	ssize_t (*read) (struct file *, char __user *, size_t,loff_t *);
    //write 函数用于向设备文件写入(发送)数据
	ssize_t (*write) (struct file *, const char __user *,size_t, loff_t *);
	ssize_t (*read_iter) (struct kiocb *, struct iov_iter *);
	ssize_t (*write_iter) (struct kiocb *, struct iov_iter *);
	int (*iopoll)(struct kiocb *kiocb, bool spin);
	int (*iterate) (struct file *, struct dir_context *);
	int (*iterate_shared) (struct file *, struct dir_context *);
    //poll 是个轮询函数，用于查询设备是否可以进行非阻塞的读写
	__poll_t (*poll) (struct file *, struct poll_table_struct *);
	//unlocked_ioctl 函数提供对于设备的控制功能，与应用程序中的 ioctl 函数对应
    long (*unlocked_ioctl) (struct file *, unsigned int,unsigned long);
	//compat_ioctl 函数与 unlocked_ioctl 函数功能一样，区别在于在 64 位系统上，32 位的应用程序调用将会使用此函数。在 32 位的系统上运行 32 位的应用程序调用的是unlocked_ioctl
    long (*compat_ioctl) (struct file *, unsigned int,unsigned long);
	//mmap 函数用于将将设备的内存映射到进程空间中(也就是用户空间)，一般帧缓冲设备会使用此函数，比如 LCD 驱动的显存，将帧缓冲(LCD 显存)映射到用户空间中以后应用程序就可以直接操作显存了，这样就不用在用户空间和内核空间之间来回复制
    int (*mmap) (struct file *, struct vm_area_struct *);
	unsigned long mmap_supported_flags;
    //open 函数用于打开设备文件
	int (*open) (struct inode *, struct file *);
	int (*flush) (struct file *, fl_owner_t id);
    //release 函数用于释放(关闭)设备文件，与应用程序中的 close 函数对应
	int (*release) (struct inode *, struct file *);
	int (*fsync) (struct file *, loff_t, loff_t, int datasync);
    //fasync 函数用于刷新待处理的数据，用于将缓冲区中的数据刷新到磁盘中
	int (*fasync) (int, struct file *, int);
	int (*lock) (struct file *, int, struct file_lock *);
	ssize_t (*sendpage) (struct file *, struct page *,int, size_t, loff_t *, int);
	unsigned long (*get_unmapped_area)(struct file *,unsigned long, unsigned long, unsigned long, unsigned long);
	int (*check_flags)(int);
	int (*flock) (struct file *, int, struct file_lock *);
	ssize_t (*splice_write)(struct pipe_inode_info *,
	struct file *, loff_t *, size_t, unsigned int);
	ssize_t (*splice_read)(struct file *, loff_t *,
	struct pipe_inode_info *, size_t, unsigned int);
	int (*setlease)(struct file *, long, struct file_lock **,void **);
	long (*fallocate)(struct file *file, int mode, loff_t offset,loff_t len);
	void (*show_fdinfo)(struct seq_file *m, struct file *f);
	#ifndef CONFIG_MMU
	unsigned (*mmap_capabilities)(struct file *);
	#endif
	ssize_t (*copy_file_range)(struct file *, loff_t,
	struct file *, loff_t, size_t, unsigned int);
	loff_t (*remap_file_range)(struct file *file_in,loff_t pos_in,struct file *file_out, loff_t pos_out,loff_t len, unsigned int remap_flags);
	int (*fadvise)(struct file *, loff_t, loff_t, int);
} __randomize_layout;

驱动程序有两种实现方式：

1.直接编进Linux内核中，内核启动后自动运行

2.编译成模块（.ko），使用时再加载（命令：modprobe 或 insmod）

#include <linux/init.h>
#include <linux/module.h>

//入口，加载模块时调用此函数
// static：限定作用域
// int:返回值类型
// __init:告诉编译器将 XXX_init 函数放在.init.text段中
// XXX_init:驱动的入口函数的名字
// (void):不能传递参数
static int __init XXX_init(void)
{
    
    // 分配资源

    return 0;
}

//出口，卸载模块时调用此函数
// __exit:告诉编译器将 XXX_exit 函数放在.exit.text段中
static void __exit XXX_exit(void)
{
    // 释放资源
}

//将入口函数的地址告诉给内核
module_init(XXX_init);
//将出口函数的地址告诉给内核
module_exit(XXX_exit);
//许可证
MODULE_LICENSE("GPL");