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文件拷贝到网络文件系统下,启动开发板后挂载设备驱动。
可以看到在挂载设备驱动的时候就自动生成了设备节点,之后使用上一节的测试程序直接操作该节点即可。