11.linux驱动模版

原创于 2026-06-29 16:43:55 发布 · 139 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#linux #运维 #服务器

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

12 篇文章

订阅专栏

整体结构

一共 3 部分：

设备树节点（DTS）
内核驱动（平台驱动 + 字符设备，最简版）
用户层测试APP
环境：Linux 5.x / 6.x，ZYNQ / STM32MP1 通用。

一、第一步：添加设备树节点 dts

打开板级 dts，在根节点下添加：

myhello_dev {
    compatible = "mycompany,hello_dev";
    status = "okay";
};

compatible 是驱动和设备匹配的关键字，必须两边一致。
本例只做字符设备，不需要寄存器地址，所以不用 reg。

编译生成 dtb，更新到开发板。

二、第二步：驱动代码 hello_dev.c（两层最简封装）

#include <linux/module.h>
#include <linux/platform_device.h>
#include <linux/cdev.h>
#include <linux/fs.h>
#include <linux/device.h>

// ---------------- 字符设备变量 ----------------
#define DEV_NAME "hello_dev"
static dev_t devno;
static struct cdev cdev;
static struct class *dev_class;

// ---------------- 文件操作接口（应用调用open/read/write） ----------------
static int hello_open(struct file *file)
{
    pr_info("hello dev opened\n");
    return 0;
}

static ssize_t hello_read(struct file *file, char __user *buf, size_t count, loff_t *ppos)
{
    char k_buf[] = "Hello World from kernel driver!\n";
    int len = strlen(k_buf);

    // 内核数据拷贝到用户空间
    copy_to_user(buf, k_buf, len);
    return len;
}

static int hello_release(struct file *file)
{
    pr_info("hello dev closed\n");
    return 0;
}

static struct file_operations hello_fops = {
    .owner = THIS_MODULE,
    .open  = hello_open,
    .read  = hello_read,
    .release = hello_release,
};

// ---------------- 平台驱动：设备匹配成功后执行probe ----------------
static int hello_probe(struct platform_device *pdev)
{
    int ret;

    // 1. 申请设备号
    ret = alloc_chrdev_region(&devno, 0, 1, DEV_NAME);
    if (ret < 0)
    {
        pr_err("alloc devno failed\n");
        return ret;
    }

    // 2. 初始化字符设备，绑定文件操作集
    cdev_init(&cdev, &hello_fops);
    cdev_add(&cdev, devno, 1);

    // 3. 自动在 /dev 下生成设备节点
    dev_class = class_create(THIS_MODULE, DEV_NAME);
    device_create(dev_class, NULL, devno, NULL, DEV_NAME);

    pr_info("hello driver probed success\n");
    return 0;
}

static int hello_remove(struct platform_device *pdev)
{
    // 销毁设备节点
    device_destroy(dev_class, devno);
    class_destroy(dev_class);

    // 删除字符设备
    cdev_del(&cdev);
    unregister_chrdev_region(devno, 1);

    pr_info("hello driver removed\n");
    return 0;
}

// 匹配表：和dts里compatible严格对应
static const struct of_device_id hello_of_match[] = {
    { .compatible = "mycompany,hello_dev" },
    { /* Sentinel */ }
};
MODULE_DEVICE_TABLE(of, hello_of_match);

// 注册平台驱动
static struct platform_driver hello_driver = {
    .probe  = hello_probe,
    .remove = hello_remove,
    .driver = {
        .name = "hello_plat_driver",
        .of_match_table = hello_of_match,
    },
};

module_platform_driver(hello_driver);

MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("Hello world platform char driver");
MODULE_AUTHOR("Newbie");

分层说明

底层封装：file_operations，向上给应用提供 open/read；
上层框架封装：platform_driver，和设备树做匹配，实现软硬件分离；
硬件信息只留在DTS，C代码里没有写死任何硬件地址。

三、Makefile

obj-m += hello_dev.o
KERNELDIR ?= /home/xxx/linux-kernel
PWD := $(shell pwd)

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

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

编译得到：hello_dev.ko

四、第三步：用户层应用 app.c

#include <stdio.h>
#include <fcntl.h>
#include <unistd.h>
#include <errno.h>

int main(void)
{
    int fd;
    char buf[128];

    fd = open("/dev/hello_dev", O_RDONLY);
    if (fd < 0)
    {
        perror("open");
        return -1;
    }

    read(fd, buf, sizeof(buf));
    printf("Recv: %s\n", buf);

    close(fd);
    return 0;
}

交叉编译：