字符設備驅動是 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) 反向釋放所有資源
| 結構體/函數 | 用途 | 關鍵成員/參數 |
|---|---|---|
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 權限/名稱 |
// 靜態指定 (需向 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); // 取得核心分配的主設備號
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 參考等
}
// 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");
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
上述範例為傳統「手動註冊」寫法。現代內核 (3.10+) 強烈建議使用 Platform Driver + Device Tree:
probe/remove,由核心自動匹配 Device Tree 節點。devm_* 資源管理、module_platform_driver() 單行註冊。掌握字符驅動全流程與現代 Platform Driver 模型,是邁向 Linux 驅動開發專家的必經之路。