STM32MP157驱动开发——新字符设备驱动


一、新字符设备驱动原理

  之前的驱动在编写代码时就指定了主设备号,这样就需要开发人员提前确认主设备号是否被占用,另外,该驱动会占用主设备号下的所有次驱动号。新字符驱动就使用int alloc_chrdev_region(dev_t *dev, unsigned baseminor, unsigned count, const char *name)int register_chrdev_region(dev_t from, unsigned count, const char *name)来注册设备号。其中alloc_chrdev_region函数是由系统自动分配,而register_chrdev_region函数由开发人员指定主设备号和次设备号。释放设备号则统一使用void unregister_chrdev_region(dev_t from, unsigned count)函数。

常用的字符设备驱动函数

①字符设备结构体cdev

struct cdev {
	struct kobject kobj;
	struct module *owner;
	const struct file_operations *ops;
	struct list_head list;
	dev_t dev;
	unsigned int count;
} __randomize_layout;

其中有两个重要的成员变量:ops和dev。这两个与前两节中的file_operations和设备号dev_t等价。在写字符型设备驱动代码前要用struct cdev tset_cdev定义一个cdev结构体变量。
②cdev_init函数
定义好cdev变量之后就要对设备进行初始化
③cdev_add函数
用于向Linux系统添加字符设备(cdev结构体变量),原型为int cdev_add(struct cdev *p, dev_t dev, unsigned count),参数p指向要添加的字符设备,dev为设备号,count为要添加的设备数量
④cdev_del函数
卸载驱动时,使用cdev_del函数从Linux内核中删除相应的字符设备。
⑤创建与删除设备节点
创建完设备后,还要在Linux系统中创建设备节点,使用struct device *device_create()void device_destroy()来创建和删除。

参考示例:

struct class *class; /* 类 */
struct device *device; /* 设备 */
dev_t devid; /* 设备号 */

/* 驱动入口函数 */
static int __init xxx_init(void)
{
	/* 创建类 */
	class = class_create(THIS_MODULE, "xxx");
	/* 创建设备 */
	device = device_create(class, NULL, devid, NULL, "xxx");
	return 0;
}

/* 驱动出口函数 */
static void __exit led_exit(void)
{
	/* 删除设备 */
	device_destroy(newchrled.class, newchrled.devid);
	/* 删除类 */
	class_destroy(newchrled.class);
}

module_init(led_init);
module_exit(led_exit);

二、新LED驱动

  在旧版本的基础上进行修改,使用新版字符驱动编写LED驱动。

#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 <linux/errno.h>
#include <linux/gpio.h>
#include <asm/mach/map.h>
#include <asm/uaccess.h>
#include <asm/io.h>
#include <linux/cdev.h>
#include <linux/device.h>

#define NEWCHRLED_CNT   1   /*设备号个数*/
#define NEWCHRLED_NAME  "newchrled" /*名字*/

#define LEDOFF  0       /*关灯*/
#define LEDON   1       /*开灯*/

/*寄存器物理地址*/
#define PERIPH_BASE             (0x40000000)
#define MPU_AHB4_PERIPH_BASE    (PERIPH_BASE + 0x10000000)
#define RCC_BASE                (MPU_AHB4_PERIPH_BASE + 0x0000)
#define RCC_MP_AHB4ENSETR       (RCC_BASE + 0XA28)
#define GPIOI_BASE              (MPU_AHB4_PERIPH_BASE + 0xA000)
#define GPIOI_MODER             (GPIOI_BASE + 0X0000)
#define GPIOI_OTYPER            (GPIOI_BASE + 0x0004)
#define GPIOI_OSPEEDR           (GPIOI_BASE + 0x0008)
#define GPIOI_PUPDR             (GPIOI_BASE + 0x000C)
#define GPIOI_BSRR              (GPIOI_BASE + 0x0018)   

/*映射后的寄存器虚拟地址指针*/
static void __iomem *MPU_AHB4_PERIPH_RCC_PI;
static void __iomem *GPIOI_MODER_PI;
static void __iomem *GPIOI_OTYPER_PI;
static void __iomem *GPIOI_OSPEEDR_PI;
static void __iomem *GPIOI_PUPDR_PI;
static void __iomem *GPIOI_BSRR_PI;

/*newchrled设备结构体*/
struct newchrled_dev{
    dev_t devid;            /*设备号*/
    struct cdev cdev;       /*cdev*/
    struct class *class;    /*类*/
    struct device *device;  /*设备*/
    int major;              /*主设备号*/
    int minor;              /*次设备号*/
};

struct newchrled_dev newchrled;     /*LED设备*/

/*
* @description : LED 打开/关闭
* @param - sta : LEDON(0) 打开 LED, LEDOFF(1) 关闭 LED
* @return : 无
*/
void led_switch(u8 sta)
{
    u32 val = 0;
    if(sta == LEDON){
        val = readl(GPIOI_BSRR_PI);
        val |= (1 << 16);
        writel(val, GPIOI_BSRR_PI);
    } else if(sta == LEDOFF){
        val = readl(GPIOI_BSRR_PI);
        val |= (1 << 0);
        writel(val, GPIOI_BSRR_PI);
    }
}

/*
* @description : 取消映射
* @return : 无
*/
void led_unmap(void)
{
    /*取消映射*/
    iounmap(MPU_AHB4_PERIPH_RCC_PI);
    iounmap(GPIOI_MODER_PI);
    iounmap(GPIOI_OTYPER_PI);
    iounmap(GPIOI_OSPEEDR_PI);
    iounmap(GPIOI_PUPDR_PI);
    iounmap(GPIOI_BSRR_PI);
}

/*
* @description : 打开设备
* @param – inode : 传递给驱动的 inode
* @param - filp : 设备文件, file 结构体有个叫做 private_data 的成员变量
* 一般在 open 的时候将 private_data 指向设备结构体。
* @return : 0 成功;其他 失败
*/
static int led_open(struct inode *inode, struct file *filp)
{
    filp->private_data = &newchrled; /* 设置私有数据 */
    return 0;
}

/*
* @description : 从设备读取数据
* @param - filp : 要打开的设备文件(文件描述符)
* @param - buf : 返回给用户空间的数据缓冲区
* @param - cnt : 要读取的数据长度
* @param - offt : 相对于文件首地址的偏移
* @return : 读取的字节数,如果为负值,表示读取失败
*/
static ssize_t led_read(struct file *filp, char __user *buf, size_t cnt, loff_t *offt)
{
    return 0;
}

/*
* @description : 向设备写数据
* @param - filp : 设备文件,表示打开的文件描述符
* @param - buf : 要写给设备写入的数据
* @param - cnt : 要写入的数据长度
* @param - offt : 相对于文件首地址的偏移
* @return : 写入的字节数,如果为负值,表示写入失败
*/
static ssize_t led_write(struct file *filp, const char __user *buf, size_t cnt, loff_t *offt)
{
    int retvalue;
    unsigned char databuf[1];
    unsigned char ledstat;

    retvalue = copy_from_user(databuf, buf, cnt);
    if(retvalue < 0){
        printk("kernel write failed!\r\n");
        return -EFAULT;
    }

    ledstat = databuf[0];   /*获取状态值*/

    if(ledstat == LEDON){
        led_switch(LEDON);      /*打开LED灯*/
    } else if(ledstat == LEDOFF){
        led_switch(LEDOFF);     /*关闭LED灯*/
    }
    
    return 0;
}

/*
* @description : 关闭/释放设备
* @param - filp : 要关闭的设备文件(文件描述符)
* @return : 0 成功;其他 失败
*/
static int led_release(struct inode *inode, struct file *filp)
{
    return 0;
}

/*设备操作函数*/
static struct file_operations newchrled_fops = {
    .owner      = THIS_MODULE,
    .open       = led_open,
    .read       = led_read,
    .write      = led_write,
    .release    = led_release,
};

/*
* @description : 驱动入口函数
* @param : 无
* @return : 无
*/
static int __init led_init(void)
{
    int retvalue = 0;
    u32 val = 0;

    /*初始化LED*/
    /*1、寄存器地址映射*/
    MPU_AHB4_PERIPH_RCC_PI = ioremap(RCC_MP_AHB4ENSETR, 4);
    GPIOI_MODER_PI = ioremap(GPIOI_MODER, 4);
    GPIOI_OTYPER_PI = ioremap(GPIOI_OTYPER, 4);
    GPIOI_OSPEEDR_PI = ioremap(GPIOI_OSPEEDR, 4);
    GPIOI_PUPDR_PI = ioremap(GPIOI_PUPDR, 4);
    GPIOI_BSRR_PI = ioremap(GPIOI_BSRR, 4);
    
    /*2、使能PI时钟*/
    val = readl(MPU_AHB4_PERIPH_RCC_PI);
    val &= ~(0x1 << 8); /*清除以前的设置*/
    val |= (0x1 << 8);  /*设置新值*/
    writel(val, MPU_AHB4_PERIPH_RCC_PI);

    /*3、设置PI0通用的输出模式*/
    val = readl(GPIOI_MODER_PI);
    val &= ~(0x3 << 0);     /*bit0:1清零*/
    val |= (0x1 << 0);      /*bit0:1设置01*/
    writel(val, GPIOI_MODER_PI);

    /*4、设置PI0为推挽模式*/
    val = readl(GPIOI_OTYPER_PI);
    val &= ~(0x1 << 0);     /*bit0清零,设置为上拉*/
    writel(val, GPIOI_OTYPER_PI);

    /*5、设置PI0为高速*/
    val = readl(GPIOI_OSPEEDR_PI);
    val &=~(0x3 << 0);      /*bit0:1清零*/
    val |= (0x2 << 0);      /*bit0:1设置为10*/
    writel(val, GPIOI_OSPEEDR_PI);

    /*6、设置PI0为上拉*/
    val = readl(GPIOI_PUPDR_PI);
    val &= ~(0x3 << 0);     /*bit0:1清零*/
    val |= (0x1 << 0);      /*bit0:1设置为01*/
    writel(val, GPIOI_PUPDR_PI);

    /*7、默认关闭LED*/
    val = readl(GPIOI_BSRR_PI);
    val |= (0x1 << 0);
    writel(val, GPIOI_BSRR_PI);

    /*注册字符设备驱动*/
    /*创建设备号*/
    if(newchrled.major){        /*已经定义过设备号*/
        newchrled.devid = MKDEV(newchrled.major, 0);
        retvalue = register_chrdev_region(newchrled.devid, NEWCHRLED_CNT, NEWCHRLED_NAME);

        if(retvalue < 0){
            pr_err("cannot register %s char driver, [retvalue = %d]\r\n", NEWCHRLED_NAME, NEWCHRLED_CNT);
            goto fail_map;
        }
    } else {        /*没有定义设备号*/
        retvalue = alloc_chrdev_region(&newchrled.devid, 0, NEWCHRLED_CNT, NEWCHRLED_NAME); /*申请设备号*/
        
        if(retvalue < 0){
            pr_err("%s couldn't alloc_chedev_region, ret=%d\r\n", NEWCHRLED_NAME, retvalue);
            goto fail_map;
        }

        newchrled.major = MAJOR(newchrled.devid);   /*获取主设备号*/
        newchrled.minor = MINOR(newchrled.devid);   /*获取次设备号*/
    }

    printk("newchrled major = %d, minor = %d\r\n", newchrled.major, newchrled.minor);

    /*初始化cdev*/
    newchrled.cdev.owner = THIS_MODULE;
    cdev_init(&newchrled.cdev, &newchrled_fops);

    /*添加一个cdev*/
    retvalue = cdev_add(&newchrled.cdev, newchrled.devid, NEWCHRLED_CNT);
    if(retvalue < 0){
        goto del_unregister;
    }

    /*创建类*/
    newchrled.class = class_create(THIS_MODULE, NEWCHRLED_NAME);
    if(IS_ERR(newchrled.class)){
        goto del_cdev;
    }

    /*创建设备*/
    newchrled.device = device_create(newchrled.class, NULL, newchrled.devid, NULL, NEWCHRLED_NAME);
    if(IS_ERR(newchrled.device)){
        goto destroy_class;
    }

    return 0;

destroy_class:
    class_destroy(newchrled.class);
del_cdev:
    cdev_del(&newchrled.cdev);
del_unregister:
    unregister_chrdev_region(newchrled.devid, NEWCHRLED_CNT);
fail_map:
    led_unmap();
    return -EIO;
}

/*
* @description : 驱动出口函数
* @param : 无
* @return : 无
*/
static void __exit led_exit(void)
{
    /*取消映射*/
    led_unmap();

    /*注销字符设备驱动*/
    cdev_del(&newchrled.cdev);/* 删除 cdev */
    unregister_chrdev_region(newchrled.devid, NEWCHRLED_CNT);

    device_destroy(newchrled.class, newchrled.devid);
    class_destroy(newchrled.class);
}

module_init(led_init);
module_exit(led_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Amonter");
MODULE_INFO(intree, "Y");

  与旧版本的代码区别不是太大。首先添加和cdev有关的两个头文件,然后引入了一个newchrled_dev结构体,存储一些驱动设备的基本属性,如设备号、设备节点等,其中还包括一个class类,类中存储的是挂载设备节点相关的信息,比如设备节点名称等。
  创建完这些设备信息后,则需要在初始化中对这些节点信息赋值。其中设备号的分配,在实际使用中可以不需要进行register_chrdev_region()相关的调用和判断,直接使用alloc_chrdev_region()调用系统动态分配即可。在释放设备驱动时,也要对挂载节点cdev_class和设备号devid进行销毁。

三、运行结果

将编译生成的newchrled.ko文件拷贝到网络文件系统下,启动开发板后挂载设备驱动。
在这里插入图片描述
可以看到在挂载设备驱动的时候就自动生成了设备节点,之后使用上一节的测试程序直接操作该节点即可。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值