新字符设备驱动框架

新字符设备驱动框架

---

一、驱动代码

代码如下（示例）：

/*参照linux内核去写驱动*/
#include <linux/module.h>
#include <linux/kernel.h>                        //printk需要包含的头文件
#include <linux/init.h>
#include <linux/fs.h>
#include <linux/slab.h>
#include <linux/uaccess.h>
#include <linux/gpio.h>
#include <linux/cdev.h>
#include <linux/device.h>
#define NEWCHRLED_NAME "newchrled"
#define NEWCHRLED_COUNT 1
/*寄存器物理地值*/
#define CCM_CCGR1_BASE            (0x020C406C)
#define SW_MUX_GPIO1_IO03_BASE    (0X020E0068)
#define SW_PAD_GPIO1_IO03_BASE    (0X020E02F4)
#define GPIO1_DR_BASE             (0X0209C000)
#define GPIO1_GDIR_BASE           (0X0209C004)

/*地址映射后的虚拟地址指针*/
static void __iomem *IMX6U_CCM_CCGR1;
static void __iomem *SW_MUX_GPIO1_IO03;
static void __iomem *SW_PAD_GPIO1_IO03;
static void __iomem *GPIO1_DR;
static void __iomem *GPIO1_GDIR;
#define LEDOFF 0                 //关闭
#define LEDON 1                  //打开

/*LED设备结构体*/
struct newchrled_dev
{
    struct cdev cdev;            //字符设备
    dev_t devid;                 //设备号
    struct class *class;         //类
    struct device *device;       //类下创建一个设备
    int major;                   //主设备号
    int minor;                   //次设备号
};
struct newchrled_dev newchrled;  //led设备
void led_switch(u8 sta)
{
	u32 val = 0;
	if(sta == LEDON) {
		val = readl(GPIO1_DR);
		val &= ~(1 << 3);	
		writel(val, GPIO1_DR);
	}else if(sta == LEDOFF) {
		val = readl(GPIO1_DR);
		val|= (1 << 3);	
		writel(val, GPIO1_DR);
	}	
}
static int newchrled_open(struct inode *inode, struct file *filp)
{
    filp->private_data=&newchrled;        
    //在 open 函数里面设置好私有数据以后，在 write、read、close 等函数中直接读取 private_data即可得到设备结构体
    return 0;
}
static ssize_t newchrled_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;
}
static int newchrled_release(struct inode *inode, struct file *filp)
{
    /*
    struct newchrled_dev *dev=(struct newchrled_dev*)filp->private_data;  //结构体强制转换
    dev->device                                                           //这样就可以通过dev进行访问私有数据里的成员变量
    */
    return 0;
}
static const struct file_operations newchrled_fops=
{
    .owner=THIS_MODULE,
    .write=newchrled_write,
    .open=newchrled_open,
    .release=newchrled_release,
};
/*入口*/
static int __init newchrled_init(void)
{
    int ret=0;
    unsigned int val=0;
    printk("newchrled_init\r\n");
    /*初始化led*/
    /* 1、寄存器地址映射 */
  	IMX6U_CCM_CCGR1 = ioremap(CCM_CCGR1_BASE, 4);
	SW_MUX_GPIO1_IO03 = ioremap(SW_MUX_GPIO1_IO03_BASE, 4);
  	SW_PAD_GPIO1_IO03 = ioremap(SW_PAD_GPIO1_IO03_BASE, 4);
	GPIO1_DR = ioremap(GPIO1_DR_BASE, 4);
	GPIO1_GDIR = ioremap(GPIO1_GDIR_BASE, 4);
	/* 2、使能GPIO1时钟 */
	val = readl(IMX6U_CCM_CCGR1);
	val &= ~(3 << 26);	/* 清楚以前的设置 */
	val |= (3 << 26);	/* 设置新值 */
	writel(val, IMX6U_CCM_CCGR1);
	/* 3、设置GPIO1_IO03的复用功能，将其复用为
	 *    GPIO1_IO03，最后设置IO属性。
	 */
	writel(5, SW_MUX_GPIO1_IO03);
	/*寄存器SW_PAD_GPIO1_IO03设置IO属性
	 *bit 16:0 HYS关闭
	 *bit [15:14]: 00 默认下拉
     *bit [13]: 0 kepper功能
     *bit [12]: 1 pull/keeper使能
     *bit [11]: 0 关闭开路输出
     *bit [7:6]: 10 速度100Mhz
     *bit [5:3]: 110 R0/6驱动能力
     *bit [0]: 0 低转换率
	 */
	writel(0x10B0, SW_PAD_GPIO1_IO03);
	/* 4、设置GPIO1_IO03为输出功能 */
	val = readl(GPIO1_GDIR);
	val &= ~(1 << 3);	/* 清除以前的设置 */
	val |= (1 << 3);	/* 设置为输出 */
	writel(val, GPIO1_GDIR);
	/* 5、默认关闭LED */
	val = readl(GPIO1_DR);
	val |= (1 << 3);	
	writel(val, GPIO1_DR);
    newchrled.major=0;                               //设置为0表示由系统申请设备号
    /*注册字设备号*/
    if(newchrled.major)                              //如果major不为0则说明已经给定主设备号
    {                                                //先绑定后用 register_chrdev_region注册
        newchrled.devid=MKDEV(newchrled.major,0);    //绑定次设备号
        ret=register_chrdev_region(newchrled.devid, NEWCHRLED_COUNT,NEWCHRLED_NAME); //1.绑定好的设备号 2.要申请几个次设备 3.设备名
    }
    else                                             //没有给定设备号
    {//int alloc_chrdev_region(dev_t *dev, unsigned baseminor, unsigned count, const char *name)与上一个区分开来第一个参数是指针
        ret=alloc_chrdev_region(&newchrled.devid,0,NEWCHRLED_COUNT,NEWCHRLED_NAME); //1.设备号2.次设备号起始3.要申请几个4.设备名
        newchrled.major=MAJOR(newchrled.devid);
        newchrled.minor=MINOR(newchrled.devid);
    }
    if(ret<0)
    {
        printk("newchrled chrdev_region error!\r\n");
        //return -1;
        goto fail_devid;
    }
    printk("newchrled major=%d,minor=%d\r\n",newchrled.major,newchrled.minor);
    /*注册字符设备*/
    newchrled.cdev.owner=THIS_MODULE;
    cdev_init(&newchrled.cdev,&newchrled_fops);                    //初始化cdev
    ret=cdev_add(&newchrled.cdev,newchrled.devid,NEWCHRLED_COUNT);     //字符设备添加进linux内核
    if(ret<0)
    {
        goto fail_cdev;
    }
    /*自动创建设备节点*/
    newchrled.class=class_create(THIS_MODULE,NEWCHRLED_NAME);
    if(IS_ERR(newchrled.class))                                        //判断是否出错 是linux内核的函数不用深究会用就可
    {
        ret=PTR_ERR(newchrled.class);
        goto fail_class;
        //return PTR_ERR(newchrled.class);                               //把错误返回
    }   
    newchrled.device=device_create(newchrled.class,NULL,newchrled.devid,NULL,NEWCHRLED_NAME);
    //1.类2.父设备为NULL3.设备号4.设备使用数据一般为NULL5.设备名
    if(IS_ERR(newchrled.device))                                        //判断是否出错 是linux内核的函数不用深究会用就可
    {
        ret=PTR_ERR(newchrled.device); 
        goto fail_device;
    }
    return 0;
/*采用倒序出错法：该步骤出错删除前一步不用重复删除*/
fail_device:                         //第四步出错 摧毁类(前一个步骤)
    class_destroy(newchrled.class);
fail_class:                          //第三步出错 删除字符设备(前一个步骤)
    cdev_del(&newchrled.cdev);
fail_cdev:                           //第二步出错此处为cdevinit初始化失败但是之前已经创建了设备号所以要释放掉(前一个步骤)
    unregister_chrdev_region(newchrled.devid, NEWCHRLED_COUNT);
fail_devid:                          //第一步出错直接返回ret不需要释放任何东西
    return ret;                      //无论哪一步出错会一直走到这一句然后返回ret
}
/*出口*/
static void __exit newchrled_exit(void)
{
    unsigned int val=0;
    printk("newchrled_exit\r\n");
    val = readl(GPIO1_DR);
	val |= (1 << 3);	
	writel(val, GPIO1_DR);
    /* 取消映射 */
	iounmap(IMX6U_CCM_CCGR1);
	iounmap(SW_MUX_GPIO1_IO03);
	iounmap(SW_PAD_GPIO1_IO03);
	iounmap(GPIO1_DR);
	iounmap(GPIO1_GDIR);
    /*删除字符设备*/
    cdev_del(&newchrled.cdev);
    /*注销设备号*/
    unregister_chrdev_region(newchrled.devid, NEWCHRLED_COUNT);
    /*摧毁设备*/
    device_destroy(newchrled.class,newchrled.devid);
    /*摧毁类*/
    class_destroy(newchrled.class);
}
/*注册和卸载驱动*/
module_init(newchrled_init);
module_exit(newchrled_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("yqh");

二、Makefile

代码如下（示例）：

KERNELDIR := /home/yqh/linux/IMX6ULL/linux_kernel/linux-imx-rel_imx_4.1.15_2.1.0_ga  
CURRENT_PATH := $(shell pwd)
obj-m :=newchrled.o
build: kernel_modules
kernel_modules:
	$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) modules
clean:
	$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) clean

make -j32
编译成功以后就会生成一个名为“newchrled.ko”的驱动模块文件。

三、应用层代码

代码如下（示例）：

#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
#include <stdlib.h>
#include <string.h>
#include <fcntl.h>
#include <stdio.h>
#define LEDOFF 0
#define LEDON 1
/*argc应用程序参数个数
*argv[]:具体的参数内容，字符串形式
*./ledAPP <filename> <0:1> 1表示关灯1表示开灯
*./ledAPP /dev/led 0 关灯
*./ledAPP /dev/led 1 开灯
*1执行读，在应用层打印出来读得数据 2执行写，通过调用chrdevbase_write离得打印语句而打印出来
*/
int main(int argc,char *argv[])
{
    int fd;
    int retvalue;
    char *filename;
    unsigned char databuf[1];
    if(argc !=3)
    {
        printf("Error Usage\r\n");
        return -1;
    }
    filename=argv[1];
    fd=open(filename,O_RDWR);
    if(fd<0)
    {
        printf("file %s open failed!\r\n",filename);
        return -1;
    }
    databuf[0]=atoi(argv[2]);                       //将字符转化为数字
    retvalue=write(fd,databuf,sizeof(databuf));
    if(retvalue<0)
    {
        printf("LED Control Failed\r\n");
        //colse(fd);
        return -1;
    }
    
    retvalue=close(fd);
    if(retvalue<0)
    {
        printf("file %s close failed!\r\n",filename);
        return -1;
    }
    
    return 0;
}

运行测试

arm-linux-gnueabihf-gcc ledApp.c -o ledApp

编译成功以后就会生成 ledApp 这个应用程序。
将编译出来的 newchrled.ko 和 ledApp 这两个文件拷贝到 rootfs/lib/modules/4.1.15目录中，重启开发板，进入到目录 lib/modules/4.1.15 中，输入如下命令加载 newchrled.ko 驱动
模块：

depmod
modprobe newchrled.ko
./ledApp /dev/newchrled 1 //打开 LED 灯
./ledApp /dev/newchrled 0 //关闭 LED 灯

---

总结

例如：还没写完细节以后完善，发出来每天看一遍加深理解力求盲打驱动框架。