一个设备树驱动程序Demo（linux）

mftang

已于 2024-02-28 17:15:32 修改

阅读量1.2k

点赞数 22

分类专栏： linux 驱动开发文章标签： linux 运维服务器

于 2024-01-27 14:19:40 首次发布

本文链接：https://blog.csdn.net/mftang/article/details/135882177

版权

linux 驱动开发专栏收录该内容

20 篇文章 1 订阅

订阅专栏

系统环境：

使用Linux内核： linux-imx-4.1.15-2.1.0-g3dc0a4b-v2.7.tar.bz2

硬件：正点原子ATK-DL6Y2C开发板

内核启动位置：eMMC

platform 驱动框架分为总线、设备和驱动，其中总线不需要我们这些驱动程序员去管理，这个是 Linux 内核提供的，在编写驱动的时候只要关注于设备和驱动的具体实现即可。在使用设备树架构，设备的描述被放到了设备树中，因此 platform_device 就不需要去编写了，只需要实现 platform_driver 即可。

下面实现一个基于platfrom架构的程序，其具体方法如下：

1 编写节点参数

在imx6ull-14x14-evk.dts中编写节点参数，参数内容包括：IO-PIN引脚，状态信息等，具体代码如下：

    //mftang: user's led, 2024-1-26
	// IO: GPIO-4-PIN20
	userleds {
		compatible = "atk-dl6y2c,userled";
		pinctrl-names = "default";
		pinctrl-0 = <&pinctrl_gpio_userleds>;
		gpios = <&gpio4 20 GPIO_ACTIVE_HIGH>;
		status = "okay";
	};

其中compatible和驱动代码中的compatible相比较，如果字符串一致，则match成功

修改完成后，使用如下命令编译.dts文件，使其转换为.dtb文件， 注意： 编译文件时，必须在内核的根目录下进行：

make dtbs

编译后在arch/arm/boot/dts/目录下可以看见生成的 .dtb

挂载NFS服务器

从NFS挂载的目录中将 imx6ull-14x14-emmc-4.3-480x272-c.dtb文件复制到开发板的 /run/media/mmcblk1p1目录，使用命令：

cp /mnt/atk_dl6y2c/imx6ull-14x14-emmc-4.3-480x272-c.dtb /run/media/mmcblk1p1

在开发板中看见：

reboot 开发板，然后查看driver是否被内核解析到，查看方法：

cd /proc/device-tree 
ls -l

2 编写驱动代码

1) 编写驱动程序

通过上节方法，驱动已经加载到内核中，现在编写设备驱动

/***************************************************************
Copyright  2024-2029. All rights reserved.
文件名     : drv_05_platform_template.c
作者       : tangmingfei2013@126.com
版本       : V1.0
描述       : led 驱动程序, GPIO4_PIN20-----led port
其他       : 无
日志       : 初版V1.0 2024/1/27 

使用方法：
1) 在.dts文件中定义节点信息
    //mftang: user's led, 2024-1-26
    // IO: GPIO-4-PIN20
    userleds {
        compatible = "atk-dl6y2c,userled";
        pinctrl-names = "default";
        pinctrl-0 = <&pinctrl_gpio_userleds>;
        gpios = <&gpio4 20 GPIO_ACTIVE_HIGH>;
        status = "okay";
    };
    
2) 在驱动匹配列表 
static const struct of_device_id led_of_match[] = {
    { .compatible = "atk-dl6y2c,userled" },
    { } // Sentinel
};
***************************************************************/
#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 <linux/cdev.h>
#include <linux/device.h>
#include <linux/of_gpio.h>
#include <linux/semaphore.h>
#include <linux/timer.h>
#include <linux/irq.h>
#include <linux/wait.h>
#include <linux/poll.h>
#include <linux/fs.h>
#include <linux/fcntl.h>
#include <linux/platform_device.h>
#include <asm/mach/map.h>
#include <asm/uaccess.h>
#include <asm/io.h>

#define LEDDEV_CNT         1                /* 设备号长度     */
#define LEDDEV_NAME        "userled"        /* device name    */

#define OFF             0
#define ON              1

/* leddev设备结构体 */
struct leddev_dev{
    dev_t   devid;                 /* 设备号    */
    struct  cdev cdev;             /* cdev        */
    struct  class *class;          /* 类         */
    struct  device *device;        /* 设备        */
    int     major;                 /* 主设备号    */    
    struct  device_node *node;     /* LED设备节点 */
    int     usedled;              /* LED灯GPIO标号 */
};

struct leddev_dev leddev;         /* led设备 */

/*
 * @description : LED打开/关闭
 * @param - sta : ON(0) 打开LED，OFF(1) 关闭LED
 * @return      : 无
 */
void usedled_switch(u8 sta)
{
    if (sta == ON )
        gpio_set_value(leddev.usedled, 0);
    else if (sta == OFF)
        gpio_set_value(leddev.usedled, 1);    
}

/*
 * @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 = &leddev; /* 设置私有数据  */
    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[2];
    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 == ON) 
    {
        usedled_switch(ON);
    } 
    else if (ledstat == OFF) 
    {
        usedled_switch(OFF);
    }
    return 0;
}

/* 设备操作函数 */
static struct file_operations led_fops = {
    .owner = THIS_MODULE,
    .open = led_open,
    .write = led_write,
};

/*
 * @description : flatform驱动的probe函数，当驱动与
 *                设备匹配以后此函数就会执行
 * @param - dev : platform设备
 * @return      : 0，成功;其他负值,失败
 */
static int led_probe(struct platform_device *dev)
{    
    printk("led driver and device was matched!\r\n");
    
    /* 1、设置设备号 */
    if (leddev.major) {
        leddev.devid = MKDEV(leddev.major, 0);
        register_chrdev_region(leddev.devid, LEDDEV_CNT, LEDDEV_NAME);
    } 
    else {
        alloc_chrdev_region(&leddev.devid, 0, LEDDEV_CNT, LEDDEV_NAME);
        leddev.major = MAJOR(leddev.devid);
    }

    /* 2、注册设备      */
    cdev_init(&leddev.cdev, &led_fops);
    cdev_add(&leddev.cdev, leddev.devid, LEDDEV_CNT);

    /* 3、创建类      */
    leddev.class = class_create(THIS_MODULE, LEDDEV_NAME);
    if (IS_ERR(leddev.class)) {
        return PTR_ERR(leddev.class);
    }

    /* 4、创建设备 */
    leddev.device = device_create(leddev.class, NULL, leddev.devid, NULL, LEDDEV_NAME);
    if (IS_ERR(leddev.device)) {
        return PTR_ERR(leddev.device);
    }

    /* 5、初始化IO */
    /*
        //mftang: user's led, 2024-1-26
        // IO: GPIO-4-PIN20
        userleds {
            compatible = "atk-dl6y2c,userled";
            pinctrl-names = "default";
            pinctrl-0 = <&pinctrl_gpio_userleds>;
            gpios = <&gpio4 20 GPIO_ACTIVE_HIGH>;
            status = "okay";
        };
    */
    leddev.node = of_find_node_by_path("/userleds");   /* find this from root */
    if (leddev.node == NULL){
        printk("kernel can't find userleds node!\r\n");
        return -EINVAL;
    } 
    
    leddev.usedled = of_get_named_gpio(leddev.node, "gpios", 0); /* 找到对应的IO-pin*/
    if (leddev.usedled < 0) {
        printk("can't get led-gpio\r\n");
        return -EINVAL;
    }

    gpio_request(leddev.usedled, "usedled");
    gpio_direction_output(leddev.usedled, 1);   /* usedled IO设置为输出，默认高电平    */
    return 0;
}

/*
 * @description : platform驱动的remove函数，移除platform驱动的时候此函数会执行
 * @param - dev : platform设备
 * @return      : 0，成功;其他负值,失败
 */
static int led_remove(struct platform_device *dev)
{
    gpio_set_value(leddev.usedled, 1);        /* 卸载驱动的时候关闭LED */
    gpio_free(leddev.usedled);                /* 释放IO             */
    
    cdev_del(&leddev.cdev);                   /*  删除cdev */
    
    unregister_chrdev_region(leddev.devid, LEDDEV_CNT); /* 注销设备号 */
    device_destroy(leddev.class, leddev.devid);
    class_destroy(leddev.class);
    
    return 0;
}

/* 匹配列表 */
static const struct of_device_id led_of_match[] = {
    { .compatible = "atk-dl6y2c,userled" },
    { /* Sentinel */ }
};

/* platform驱动结构体 */
static struct platform_driver led_driver = {
   .driver = {
        .name           = "atk-dl6u2c-led",  /* driver's name */
        .of_match_table = led_of_match,      /* 设备树匹配表   */
    },
   .probe  = led_probe,
   .remove = led_remove,
};
        
/*
 * @description : 驱动模块加载函数
 * @param       : 无
 * @return      : 无
 */
static int __init leddriver_init(void)
{
    return platform_driver_register(&led_driver);
}

/*
 * @description : 驱动模块卸载函数
 * @param       : 无
 * @return      : 无
 */
static void __exit leddriver_exit(void)
{
    platform_driver_unregister(&led_driver);
}

module_init(leddriver_init);
module_exit(leddriver_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("tangmingfei2013@126.com");

2）编写驱动程序的Makefile

PWD := $(shell pwd)

KERNEL_DIR=/home/mftang/linux_workspace/study_atk_dl6y2c/kernel/atk-dl6u2c
ARCH=arm
CROSS_COMPILE=/home/ctools/gcc-linaro-4.9.4-arm-linux-gnueabihf/bin/arm-linux-gnueabihf-

export  ARCH  CROSS_COMPILE

obj-m:= drv_05_platform_template.o

all:
	$(MAKE) -C $(KERNEL_DIR) M=$(PWD) modules


clean:
	rm -rf .*.cmd *.o *.mod.c *.ko .tmp_versions *.order *.symvers

3) 编译驱动，并将它复制到NFS挂载的目录下

编译驱动文件，生成.ko文件

复制文件到NFS挂载的目录

4）在板卡中装载驱动

3 编写测试程序

1）上节已经完成驱动程序的加载，下面编写测试程序来验证驱动程序是否能够正常工作。创建测试程序.c文件，编写代码

/***************************************************************
Copyright  2024-2029. All rights reserved.
文件名  : test_05_led.c
作者    : tangmingfei2013@126.com
版本    : V1.0
描述    : LED 测试程序,用于测试 drv_05_led
日志    : 初版V1.0 2024/1/23 
使用方法：./test_05_led 1       开灯
          ./test_05_led 0       关灯
***************************************************************/
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>
#include <stdio.h>
#include <string.h>

#define DEV_NAME    "/dev/userled"

int main(int argc, char **argv)
{
    int fd;
    char status;

    if (argc < 1){
        printf("Usage: %s <string>\n", argv[0]);
        printf(" %s -r\n", argv[0]);
        return -1;
    }

    fd = open(DEV_NAME, O_RDWR);
    if (fd < 0){
        printf("can not open file %s \r\n", DEV_NAME);
        return -1;
    }

    printf("parameters lists: %s  %s \r\n",argv[0], argv[1] );
    if ((0 == strcmp(argv[1], "1")) && (argc == 2)){
        status = 1;
        write(fd, &status, 1);  
        printf("turn on led, status is %d  \r\n", status);
    }
    else{
        status = 0;
        write(fd, &status, 0);    
        printf("turn off led, status is %d  \r\n", status);
    }

    close(fd);

    return 0;
}

2) 编写Makefile

CFLAGS= -Wall -O2
CC=/home/ctools/gcc-linaro-4.9.4-arm-linux-gnueabihf/bin/arm-linux-gnueabihf-gcc
STRIP=/home/ctools/gcc-linaro-4.9.4-arm-linux-gnueabihf/bin/arm-linux-gnueabihf-strip


test_05_led: test_05_led.o
	$(CC) $(CFLAGS) -o test_05_led test_05_led.o
	$(STRIP) -s test_05_led

clean:
	rm -f test_05_led test_05_led.o

3）编译代码，并将其复制到NFS共享文件夹中