萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux 字符設備驅動開發全流程:設備號申請、file_operations、cdev 註冊、自動建立 /dev 節點、ioctl 實戰與 LED 驅動完整範例

字符設備驅動是 Linux 驅動開發的入門必修課,也是最廣泛應用的驅動類型(串口、GPIO、IIO、輸入子系統等)。本文系統梳理從「設備號申請 → file_operations 實作 → cdev 註冊 → device_create 自動建節點」的完整流程,並附上可編譯運行的 **S3C6410 LED 驅動完整範例**,助你從零構建專業級字符驅動。

核心流程圖解

模組載入 (module_init)
    │
    ├─ 1. 申請設備號
    │     ├─ 靜態指定:register_chrdev_region(dev_t first, count, name)
    │     └─ 動態分配:alloc_chrdev_region(dev_t *dev, firstminor, count, name)  ← 推薦
    │
    ├─ 2. 定義 file_operations (fops)
    │     .owner = THIS_MODULE
    │     .open  = xxx_open
    │     .read  = xxx_read
    │     .write = xxx_write
    │     .unlocked_ioctl = xxx_ioctl
    │     .release = xxx_release
    │     .llseek = xxx_llseek
    │
    ├─ 3. 初始化並註冊 cdev
    │     cdev_init(&my_cdev, &fops)        // 綁定 fops
    │     my_cdev.owner = THIS_MODULE
    │     cdev_add(&my_cdev, dev_number, count)  // 向核心登記
    │
    ├─ 4. 自動建立 /dev 節點 (device model)
    │     class = class_create(THIS_MODULE, "my_class")
    │     device_create(class, NULL, dev_number, NULL, "my_dev%d", minor)
    │     → 自動產生 /dev/my_dev0, /dev/my_dev1... 並觸發 udev 規則
    │
    └─ 模組卸載 (module_exit) 反向釋放所有資源

關鍵資料結構與 API 速查

結構體/函數用途關鍵成員/參數
dev_t設備號 (32-bit: 12-bit major + 20-bit minor)MAJOR(dev_t), MINOR(dev_t), MKDEV(maj, min)
file_operations驅動操作函數表open, read, write, unlocked_ioctl, compat_ioctl, release, llseek, poll, mmap...
struct file開啟檔案實例 (內核空間)f_op, f_pos, f_flags, private_data, f_inode
struct inode檔案系統索引節點i_rdev (設備號), i_cdev (指向 cdev)
struct cdev字符設備核心物件ops, owner, kobj
struct class設備類別 (sysfs /sys/class/)devnode 回調可自定義 /dev 權限/名稱

設備號申請:靜態 vs 動態

// 靜態指定 (需向 LANANA 申請,現代驅動極少用)
#define MY_MAJOR 240
#define MY_MINOR 0
dev_t dev = MKDEV(MY_MAJOR, MY_MINOR);
register_chrdev_region(dev, COUNT, "my_dev");

// 動態分配 (推薦,避免衝突)
dev_t dev;
alloc_chrdev_region(&dev, 0, COUNT, "my_dev");  // firstminor=0
int major = MAJOR(dev);  // 取得核心分配的主設備號

file_operations 核心回調實作範本

static int my_open(struct inode *inode, struct file *filp) {
    struct my_dev *dev = container_of(inode->i_cdev, struct my_dev, cdev);
    filp->private_data = dev;  // 傳遞私有資料給後續 read/write
    return 0;
}

static ssize_t my_read(struct file *filp, char __user *buf, size_t count, loff_t *f_pos) {
    struct my_dev *dev = filp->private_data;
    if (*f_pos >= dev->size) return 0;  // EOF
    if (*f_pos + count > dev->size) count = dev->size - *f_pos;
    if (copy_to_user(buf, dev->data + *f_pos, count)) return -EFAULT;
    *f_pos += count;
    return count;
}

static ssize_t my_write(struct file *filp, const char __user *buf, size_t count, loff_t *f_pos) {
    struct my_dev *dev = filp->private_data;
    // 簡單實作:環狀緩衝或擴容
    if (copy_from_user(dev->data + *f_pos, buf, count)) return -EFAULT;
    *f_pos += count;
    dev->size = max(dev->size, *f_pos);
    return count;
}

static long my_ioctl(struct file *filp, unsigned int cmd, unsigned long arg) {
    struct my_dev *dev = filp->private_data;
    switch (cmd) {
        case MY_IOC_RESET:
            memset(dev->data, 0, dev->size);
            *filp->f_pos = 0;
            return 0;
        case MY_IOC_GET_SIZE:
            return put_user(dev->size, (int __user *)arg);
        default:
            return -ENOTTY;
    }
}

static int my_release(struct inode *inode, struct file *filp) {
    return 0;  // 釋放 private_data 參考等
}

完整 LED 驅動範例 (S3C6410 / ARM 架構)

// s3c6410_leds.c
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 

#define DEVICE_NAME "s3c6410_leds"
#define LED_COUNT 4

static int major = 0;          // 動態分配
static struct class *leds_class;
static struct cdev leds_cdev;
static void __iomem *gpmcon, *gpmdat;

static long leds_ioctl(struct file *filp, unsigned int cmd, unsigned long arg) {
    int led = (int)arg;
    if (led < 0 || led >= LED_COUNT) return -EINVAL;
    u32 val = readl(gpmdat);
    if (cmd == 0)      // ON (低電平點亮)
        val &= ~(1 << led);
    else if (cmd == 1) // OFF
        val |= (1 << led);
    else
        return -ENOTTY;
    writel(val, gpmdat);
    return 0;
}

static struct file_operations leds_fops = {
    .owner = THIS_MODULE,
    .unlocked_ioctl = leds_ioctl,
    .open = simple_open,   // 僅增加模組引用計數
    .release = simple_release,
};

static int __init leds_init(void) {
    dev_t dev;
    int ret;

    // 1. 申請設備號
    ret = alloc_chrdev_region(&dev, 0, 1, DEVICE_NAME);
    if (ret) return ret;
    major = MAJOR(dev);

    // 2. 初始化 cdev
    cdev_init(&leds_cdev, &leds_fops);
    leds_cdev.owner = THIS_MODULE;
    ret = cdev_add(&leds_cdev, dev, 1);
    if (ret) goto err_cdev;

    // 3. 建立 class & device 節點
    leds_class = class_create(THIS_MODULE, DEVICE_NAME);
    if (IS_ERR(leds_class)) { ret = PTR_ERR(leds_class); goto err_class; }
    device_create(leds_class, NULL, dev, NULL, DEVICE_NAME);  // /dev/s3c6410_leds

    // 4. 映射 GPIO 寄存器 (平台驅動應用 of_iomap/platform_get_resource)
    gpmcon = ioremap(0x7F0080A0, 16);  // GPMCON
    gpmdat = ioremap(0x7F0080A4, 16);  // GPMDAT
    if (!gpmcon || !gpmdat) { ret = -ENOMEM; goto err_map; }

    // 設定 GPM0-3 為輸出
    u32 con = readl(gpmcon);
    con &= ~0xFFFF;  // 清除 0-3
    con |= 0x1111;   // 設為輸出
    writel(con, gpmcon);

    // 預設全滅
    u32 dat = readl(gpmdat);
    dat |= 0xF;
    writel(dat, gpmdat);

    printk(KERN_INFO "%s: major=%d loaded\n", DEVICE_NAME, major);
    return 0;

err_map:
    device_destroy(leds_class, dev);
    class_destroy(leds_class);
err_class:
    cdev_del(&leds_cdev);
err_cdev:
    unregister_chrdev_region(dev, 1);
    return ret;
}

static void __exit leds_exit(void) {
    dev_t dev = MKDEV(major, 0);
    device_destroy(leds_class, dev);
    class_destroy(leds_class);
    cdev_del(&leds_cdev);
    unregister_chrdev_region(dev, 1);
    iounmap(gpmcon);
    iounmap(gpmdat);
    printk(KERN_INFO "%s: unloaded\n", DEVICE_NAME);
}

module_init(leds_init);
module_exit(leds_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Your Name");
MODULE_DESCRIPTION("S3C6410 LED Char Driver");

Makefile (核心樹外建置)

obj-m := s3c6410_leds.o
KDIR := /lib/modules/$(shell uname -r)/build
PWD := $(shell pwd)

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

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

用戶空間測試程式

// test_led.c
#include 
#include 
#include 
#include 
#include 

#define LED_ON  0
#define LED_OFF 1

int main(int argc, char *argv[]) {
    int fd = open("/dev/s3c6410_leds", O_RDWR);
    if (fd < 0) { perror("open"); return 1; }
    if (argc != 3) { fprintf(stderr, "Usage: %s  \n", argv[0]); return 1; }
    int led = atoi(argv[1]);
    int cmd = (strcmp(argv[2], "on") == 0) ? LED_ON : LED_OFF;
    if (ioctl(fd, cmd, led) < 0) perror("ioctl");
    close(fd);
    return 0;
}
# 編譯測試
gcc test_led.c -o test_led
sudo ./test_led 0 on   # 點亮 LED0
sudo ./test_led 0 off  # 熄滅 LED0

現代驅動模型:Platform Driver + Device Tree (推薦)

上述範例為傳統「手動註冊」寫法。現代內核 (3.10+) 強烈建議使用 Platform Driver + Device Tree:

  • 驅動只實作 probe/remove,由核心自動匹配 Device Tree 節點。
  • 資源 (registers, IRQ, GPIO) 從 Device Tree 取得,零硬編碼。
  • 自動處理 devm_* 資源管理、module_platform_driver() 單行註冊。

掌握字符驅動全流程與現代 Platform Driver 模型,是邁向 Linux 驅動開發專家的必經之路。

copyright © 萬盛學電腦網 all rights reserved