荔枝派zero驱动开发01：基本字符设备

记录基于荔枝派zero（v3s）的驱动开发的过程，欢迎共同学习交流

本系列下一篇：荔枝派zero驱动开发02：完善字符设备

创建工程

可以在docker中自定义位置建立工程（编译时指定linux内核源码位置即可）

mkdir -p ~/licheepi/driver_develop/01_chardev
cd ~/licheepi/driver_develop/01_chardev
vi chardev.c
vi Makefile

首先创建源码文件 chardev.c（源码附在文后），然后编辑Makefile文件如下

KERNELDIR := /root/licheepi/linux-zero-5.2.y
CURRENT_PATH := $(shell pwd)

obj-m := chardev.o

build: kernel_modules

kernel_modules:
	$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) modules

clean:
	$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) clean

其中KERNELDIR根据内核源码存放位置修改，obj-m根据源文件名修改，其他无需修改

编译

按下图编译，产物即chardev.ko

测试

将chardev.ko拷贝到开发板（使用nfs挂载，直接拷贝到nfs的文件系统即可）

//ubuntu环境
sudo mkdir -p ~/linux/nfs/rootfs/lib/modules/5.2.0/
cd ~/linux/nfs/rootfs/lib/modules/5.2.0/
sudo docker cp d67:/root/licheepi/driver_develop/01_chardev/chardev.ko ~/linux/nfs/rootfs/lib/modules/5.2.0/

在开发板执行驱动测试操作

//开发板环境
cd /lib/modules/5.2.0/
insmod chardev.ko
cat /proc/devices |grep chardevbase
//创建设备节点
mknod /dev/chardev c 246 0
//读取
cat /dev/chardev
//写入
echo "write to kernel test!"  >  /dev/chardev

简要流程分析

使用module_init()宏和module_exit()宏，分别注册驱动入口函数和出口函数（module_init()与module_exit()看起来像函数，实际上是宏，可以写在函数外部）

其中入口函数调用register_chrdev，向系统注册驱动以及操作接口ops，接口原型参考struct file_operations（本例涉及open、release、read、write）；

出口函数调用unregister_chrdev销毁驱动

源码

chardev.c

#include <linux/types.h>
#include <linux/kernel.h>
#include <linux/delay.h>
#include <linux/ide.h>
#include <linux/init.h>
#include <linux/module.h>
#include <asm/uaccess.h>


static int char_major = 0;
#define CHARDEV_NAME "chardevbase"

// fs.h
// static struct file_operations chardev_ops;
// 按ops实现open,read,write,release
/*
    ssize_t (*read) (struct file *, char __user *, size_t, loff_t *);
    ssize_t (*write) (struct file *, const char __user *, size_t, loff_t *);
    int (*open) (struct inode *, struct file *);
    int (*release) (struct inode *, struct file *);
*/

static int chardev_open(struct inode *inode, struct file *filp)
{
    printk("chardev_open\r\n");
    return 0;
}

static ssize_t chardev_read(struct file *filp,
                            char __user *buf,
                            size_t cnt, loff_t *offsetp)
{
    printk("chardev_read %d bytes\r\n",cnt);
    return 0;
}
static ssize_t chardev_write(struct file *filp,
                             const char __user *buf,
                             size_t cnt, loff_t *offsetp)
{
    printk("chardev_write %d bytes\r\n",cnt);
    return cnt;
}

static int chardev_release(struct inode *inode, struct file *filp)
{
    printk("chardev_release\r\n");
    return 0;
}

static struct file_operations chardev_fops =
    {
        .owner = THIS_MODULE,
        .open = chardev_open,
        .read = chardev_read,
        .write = chardev_write,
        .release = chardev_release,
};

// 入口与出口需使用__init和__exit修饰
static int __init chardev_init(void)
{
    int ret = 0;
    // char_major参数为0时为动态申请设备号，返回值为设备号
    //           参数不为0时，注册失败返回负值，注册成功返回0
    ret = register_chrdev(char_major, CHARDEV_NAME, &chardev_fops);
    if (ret < 0)
    {
        printk("chardev driver register failed\r\n");
        return -1;
    }
    else
    {
        char_major = ret;
        printk("chardev_init(),char_major:%d\r\n", char_major);
    }
    return 0;
}

static void __exit chardev_exit(void)
{
    unregister_chrdev(char_major, CHARDEV_NAME);
    printk("chardev_exit()\r\n");
}

// 宏
module_init(chardev_init);
module_exit(chardev_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("USER");
MODULE_INFO(intree, "Y");