備驅(qū)動(dòng)開發(fā)：從基礎(chǔ)概念到實(shí)戰(zhàn)實(shí)現(xiàn))
1. 項(xiàng)目概述為什么字符設(shè)備驅(qū)動(dòng)是Linux內(nèi)核的基石在嵌入式開發(fā)、服務(wù)器運(yùn)維乃至桌面應(yīng)用開發(fā)中只要你的程序需要和硬件打交道或者需要在內(nèi)核層面實(shí)現(xiàn)一個(gè)特殊的虛擬設(shè)備那么“驅(qū)動(dòng)”這個(gè)概念就繞不開。而字符設(shè)備驅(qū)動(dòng)可以說是Linux驅(qū)動(dòng)開發(fā)中最基礎(chǔ)、最經(jīng)典也是應(yīng)用最廣泛的一類。它不像塊設(shè)備驅(qū)動(dòng)那樣需要考慮復(fù)雜的緩存和I/O調(diào)度也不像網(wǎng)絡(luò)設(shè)備驅(qū)動(dòng)那樣需要處理協(xié)議棧它的核心任務(wù)就是提供一種“字節(jié)流”式的訪問方式。簡單來說你可以把它想象成一個(gè)特殊的文件用戶空間的程序通過標(biāo)準(zhǔn)的文件操作接口open,read,write,ioctl,close來和它交互而驅(qū)動(dòng)則負(fù)責(zé)將這些操作翻譯成對(duì)具體硬件或邏輯的操作。我見過很多剛接觸內(nèi)核開發(fā)的朋友一上來就想搞懂復(fù)雜的框架比如V4L2、DRM或者IIO結(jié)果往往一頭霧水。原因就在于這些高級(jí)框架的底層無一例外都建立在字符設(shè)備驅(qū)動(dòng)框架之上。不理解這個(gè)基礎(chǔ)框架就像蓋樓不打地基看再多的上層建筑也是空中樓閣。今天我們就來徹底拆解Linux的字符設(shè)備驅(qū)動(dòng)框架我會(huì)結(jié)合我過去在多個(gè)嵌入式項(xiàng)目從簡單的GPIO按鍵到復(fù)雜的傳感器數(shù)據(jù)采集中的實(shí)際踩坑經(jīng)驗(yàn)把它的設(shè)計(jì)思想、核心數(shù)據(jù)結(jié)構(gòu)、注冊(cè)流程以及如何與用戶空間通信掰開揉碎了講清楚。無論你是想為一塊自制的開發(fā)板寫驅(qū)動(dòng)還是想深入理解某個(gè)內(nèi)核子系統(tǒng)這篇文章都能給你提供一個(gè)堅(jiān)實(shí)、清晰的起點(diǎn)。2. 核心概念與框架設(shè)計(jì)思想2.1 什么是字符設(shè)備與塊設(shè)備、網(wǎng)絡(luò)設(shè)備的本質(zhì)區(qū)別在Linux的“一切皆文件”哲學(xué)里設(shè)備也被抽象成了文件。但不同類型的設(shè)備其“文件”的行為模式天差地別。理解這種差異是選擇正確驅(qū)動(dòng)框架的前提。字符設(shè)備的核心特征是“字節(jié)流”。數(shù)據(jù)像一個(gè)連續(xù)的水流按順序被讀取或?qū)懭?。典型的例子有終端(/dev/tty*): 你敲入的字符按順序被讀取。串口(/dev/ttyS*): 數(shù)據(jù)一個(gè)字節(jié)一個(gè)字節(jié)地收發(fā)。隨機(jī)數(shù)生成器(/dev/random,/dev/urandom): 每次讀取都得到一串隨機(jī)的字節(jié)流。大部分傳感器比如溫度傳感器你讀取它得到的是一個(gè)代表溫度值的字節(jié)序列。內(nèi)存(/dev/mem,/dev/null): 對(duì)內(nèi)存地址的線性訪問。它的訪問通常是“直接”的沒有中間緩存驅(qū)動(dòng)開發(fā)者可以自己實(shí)現(xiàn)緩存但內(nèi)核不強(qiáng)制提供。一個(gè)read系統(tǒng)調(diào)用可能只讀取幾個(gè)字節(jié)下一個(gè)read會(huì)從上次結(jié)束的地方繼續(xù)。塊設(shè)備則不同它的核心特征是“塊”。數(shù)據(jù)被組織成固定大小的塊如512字節(jié)、4KB并且訪問是“隨機(jī)”的。典型的例子是硬盤、SSD、U盤 (/dev/sda*)。內(nèi)核為塊設(shè)備提供了復(fù)雜的緩存機(jī)制Page Cache和I/O調(diào)度器以提高性能。你可以在文件的任意位置進(jìn)行讀寫而不必關(guān)心物理介質(zhì)上數(shù)據(jù)是否連續(xù)。網(wǎng)絡(luò)設(shè)備則完全脫離了“文件”的抽象。它沒有對(duì)應(yīng)的設(shè)備文件如/dev/eth0而是通過套接字接口進(jìn)行訪問。數(shù)據(jù)以“數(shù)據(jù)包”為單位處理涉及復(fù)雜的網(wǎng)絡(luò)協(xié)議棧。注意區(qū)分字符設(shè)備和塊設(shè)備的一個(gè)簡單方法是字符設(shè)備通常不支持“掛載文件系統(tǒng)”而塊設(shè)備可以。你不能把/dev/ttyS0掛載成一個(gè)目錄但可以把/dev/sda1掛載到/home。2.2 “文件操作”接口驅(qū)動(dòng)與用戶空間的契約字符設(shè)備驅(qū)動(dòng)框架的精髓在于它定義了一套清晰的“契約”。內(nèi)核提供了一套標(biāo)準(zhǔn)的操作函數(shù)集合struct file_operations驅(qū)動(dòng)開發(fā)者需要實(shí)現(xiàn)這個(gè)結(jié)構(gòu)體中與自己設(shè)備相關(guān)的函數(shù)指針。當(dāng)用戶空間程序調(diào)用open(“/dev/mydevice”)時(shí)內(nèi)核最終會(huì)調(diào)用到你驅(qū)動(dòng)中實(shí)現(xiàn)的.open方法。這套設(shè)計(jì)的好處是解耦和統(tǒng)一。用戶空間的應(yīng)用程序員不需要關(guān)心底層是真實(shí)的串口芯片還是一個(gè)虛擬的日志設(shè)備他們一律用read(fd, buf, size)來讀數(shù)據(jù)。驅(qū)動(dòng)開發(fā)者則只需要關(guān)注如何填充file_operations這個(gè)“填空題”內(nèi)核負(fù)責(zé)將系統(tǒng)調(diào)用路由到正確的驅(qū)動(dòng)函數(shù)。2.3 核心數(shù)據(jù)結(jié)構(gòu)關(guān)系圖邏輯層面理解驅(qū)動(dòng)框架必須理清幾個(gè)核心數(shù)據(jù)結(jié)構(gòu)之間的關(guān)系。它們構(gòu)成了驅(qū)動(dòng)模型的骨架。struct cdev: 這是內(nèi)核中代表一個(gè)字符設(shè)備對(duì)象的核心結(jié)構(gòu)。它內(nèi)部包含了一個(gè)struct kobject用于內(nèi)核對(duì)象管理和sysfs導(dǎo)出最重要的是它擁有一個(gè)指向struct file_operations的指針。你可以認(rèn)為一個(gè)cdev就是一個(gè)“驅(qū)動(dòng)實(shí)例”它綁定了具體的操作函數(shù)集。struct file_operations: 這是驅(qū)動(dòng)需要實(shí)現(xiàn)的“方法表”。包含了open、release、read、write、unlocked_ioctl、llseek等一系列函數(shù)指針。驅(qū)動(dòng)的工作就是填充這個(gè)表。struct inode: 索引節(jié)點(diǎn)。在文件系統(tǒng)中每個(gè)文件包括設(shè)備文件都有一個(gè)inode它存儲(chǔ)文件的元數(shù)據(jù)權(quán)限、所有者、時(shí)間戳等。對(duì)于設(shè)備文件inode中有一個(gè)關(guān)鍵的i_cdev字段指向其對(duì)應(yīng)的struct cdev對(duì)象。正是通過這個(gè)鏈接內(nèi)核在打開設(shè)備文件時(shí)能找到該由哪個(gè)驅(qū)動(dòng)來處理。struct file: 文件對(duì)象。每當(dāng)一個(gè)進(jìn)程打開一個(gè)文件包括設(shè)備文件內(nèi)核都會(huì)創(chuàng)建一個(gè)file對(duì)象。它代表了一次打開的上下文。它內(nèi)部包含了一個(gè)f_op指針在打開設(shè)備文件時(shí)這個(gè)指針會(huì)被初始化為對(duì)應(yīng)cdev所擁有的file_operations。此外它還包含一個(gè)private_data指針這是一個(gè)非常重要的字段驅(qū)動(dòng)可以用它來存儲(chǔ)本次文件打開相關(guān)的私有數(shù)據(jù)比如一個(gè)指向設(shè)備硬件寄存器映射地址的結(jié)構(gòu)體。它們的關(guān)系可以簡單描述為用戶程序打開/dev/mydev- 內(nèi)核找到其inode- 通過inode-i_cdev找到對(duì)應(yīng)的cdev- 將本次打開的file-f_op指向cdev-ops- 后續(xù)的read/write等調(diào)用便通過file-f_op-read等指針調(diào)用到驅(qū)動(dòng)實(shí)現(xiàn)的具體函數(shù)。3. 驅(qū)動(dòng)開發(fā)全流程拆解與實(shí)操理論說再多不如動(dòng)手寫一行代碼。下面我們以一個(gè)虛擬的“全局內(nèi)存”設(shè)備為例一步步實(shí)現(xiàn)一個(gè)完整的字符設(shè)備驅(qū)動(dòng)。這個(gè)設(shè)備的功能很簡單在內(nèi)核中分配一段內(nèi)存用戶空間可以通過讀寫/dev/gmem來操作這段內(nèi)存就像操作一個(gè)普通的字節(jié)數(shù)組文件一樣。3.1 環(huán)境準(zhǔn)備與模塊基礎(chǔ)首先你需要一個(gè)Linux開發(fā)環(huán)境?？梢允菍?shí)體機(jī)也可以是虛擬機(jī)。確保安裝了對(duì)應(yīng)內(nèi)核版本的頭文件或開發(fā)包。例如在Ubuntu上sudo apt update sudo apt install linux-headers-$(uname -r) build-essential一個(gè)最簡單的內(nèi)核模塊“Hello World”是理解模塊加載/卸載機(jī)制的基礎(chǔ)。這里給出骨架// gmem_driver.c #include linux/init.h #include linux/module.h #include linux/kernel.h MODULE_LICENSE(GPL); MODULE_AUTHOR(Your Name); MODULE_DESCRIPTION(A simple global memory character device driver); static int __init gmem_init(void) { printk(KERN_INFO GMEM: Driver loaded.\n); return 0; } static void __exit gmem_exit(void) { printk(KERN_INFO GMEM: Driver unloaded.\n); } module_init(gmem_init); module_exit(gmem_exit);對(duì)應(yīng)的Makefileobj-m gmem_driver.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編譯 (make) 后使用sudo insmod gmem_driver.ko加載dmesg | tail查看內(nèi)核日志再用sudo rmmod gmem_driver卸載。這個(gè)流程是所有驅(qū)動(dòng)開發(fā)的起點(diǎn)。3.2 核心結(jié)構(gòu)體定義與初始化現(xiàn)在開始為我們的“全局內(nèi)存”設(shè)備定義核心數(shù)據(jù)。#include linux/fs.h // 包含 file_operations 定義 #include linux/cdev.h #include linux/slab.h // kmalloc, kfree #include linux/uaccess.h // copy_to_user, copy_from_user #define GMEM_DEVICE_NAME gmem #define GMEM_BUFFER_SIZE 1024 // 假設(shè)我們的“設(shè)備”只有1KB內(nèi)存 // 代表我們?cè)O(shè)備自身的數(shù)據(jù)結(jié)構(gòu) struct gmem_dev { struct cdev cdev; // 內(nèi)嵌的字符設(shè)備對(duì)象必須 unsigned char *buffer; // 指向設(shè)備內(nèi)存內(nèi)核空間的指針 unsigned long buffer_size; // 緩沖區(qū)大小 // 可以添加其他設(shè)備特定信息如信號(hào)量、自旋鎖等 }; static int gmem_major 0; // 主設(shè)備號(hào)0表示動(dòng)態(tài)分配 static struct gmem_dev *gmem_device;在模塊初始化函數(shù)gmem_init中我們需要做以下幾件事申請(qǐng)?jiān)O(shè)備號(hào)。分配并初始化我們的設(shè)備結(jié)構(gòu)體struct gmem_dev。初始化內(nèi)嵌的struct cdev并將其與file_operations綁定。將cdev添加到內(nèi)核中使其生效。3.3 實(shí)現(xiàn)文件操作集合 (file_operations)這是驅(qū)動(dòng)的“大腦”我們來實(shí)現(xiàn)最關(guān)鍵的幾個(gè)操作。// 首先定義 file_operations static struct file_operations gmem_fops { .owner THIS_MODULE, // 防止模塊在使用中被卸載 .open gmem_open, .release gmem_release, .read gmem_read, .write gmem_write, .llseek gmem_llseek, }; // open 方法 static int gmem_open(struct inode *inode, struct file *filp) { struct gmem_dev *dev; // 通過 inode 找到我們之前注冊(cè)的 cdev進(jìn)而找到我們的設(shè)備結(jié)構(gòu)體 dev container_of(inode-i_cdev, struct gmem_dev, cdev); // 將設(shè)備結(jié)構(gòu)體指針存儲(chǔ)到 file 的私有數(shù)據(jù)區(qū)方便其他函數(shù)使用 filp-private_data dev; printk(KERN_DEBUG GMEM: Device opened.\n); return 0; } // release 方法 (對(duì)應(yīng) close) static int gmem_release(struct inode *inode, struct file *filp) { printk(KERN_DEBUG GMEM: Device closed.\n); return 0; } // read 方法將設(shè)備內(nèi)存內(nèi)核空間的數(shù)據(jù)拷貝到用戶空間緩沖區(qū) static ssize_t gmem_read(struct file *filp, char __user *buf, size_t count, loff_t *f_pos) { struct gmem_dev *dev filp-private_data; ssize_t retval 0; // 計(jì)算可讀的最大字節(jié)數(shù)不能超過緩沖區(qū)大小也不能超過請(qǐng)求的count if (*f_pos dev-buffer_size) return 0; // 文件指針已到末尾 if (*f_pos count dev-buffer_size) count dev-buffer_size - *f_pos; // 核心將內(nèi)核緩沖區(qū)的數(shù)據(jù)拷貝到用戶空間。這是必須的一步不能直接傳遞指針。 if (copy_to_user(buf, dev-buffer *f_pos, count)) { retval -EFAULT; // 拷貝失敗返回錯(cuò)誤碼 goto out; } *f_pos count; // 更新文件指針 retval count; // 返回實(shí)際讀取的字節(jié)數(shù) out: return retval; } // write 方法將用戶空間緩沖區(qū)數(shù)據(jù)拷貝到設(shè)備內(nèi)存內(nèi)核空間 static ssize_t gmem_write(struct file *filp, const char __user *buf, size_t count, loff_t *f_pos) { struct gmem_dev *dev filp-private_data; ssize_t retval 0; // 計(jì)算可寫的最大字節(jié)數(shù) if (*f_pos dev-buffer_size) return -ENOSPC; // 設(shè)備已滿 if (*f_pos count dev-buffer_size) count dev-buffer_size - *f_pos; // 核心將用戶空間數(shù)據(jù)拷貝到內(nèi)核緩沖區(qū)。 if (copy_from_user(dev-buffer *f_pos, buf, count)) { retval -EFAULT; goto out; } *f_pos count; retval count; out: return retval; } // llseek 方法修改文件指針位置 static loff_t gmem_llseek(struct file *filp, loff_t offset, int whence) { struct gmem_dev *dev filp-private_data; loff_t newpos; switch (whence) { case SEEK_SET: // 從文件開始處偏移 newpos offset; break; case SEEK_CUR: // 從當(dāng)前位置偏移 newpos filp-f_pos offset; break; case SEEK_END: // 從文件末尾偏移 newpos dev-buffer_size offset; break; default: return -EINVAL; } // 檢查新位置是否合法 if (newpos 0 || newpos dev-buffer_size) return -EINVAL; filp-f_pos newpos; return newpos; }實(shí)操心得copy_to_user和copy_from_user是用戶空間與內(nèi)核空間數(shù)據(jù)交換的唯一安全通道。直接解引用用戶空間指針會(huì)導(dǎo)致內(nèi)核崩潰或安全漏洞。這兩個(gè)函數(shù)在拷貝失敗時(shí)會(huì)返回未拷貝的字節(jié)數(shù)成功時(shí)返回0所以判斷條件通常是if (copy_to_user(...))。3.4 設(shè)備號(hào)申請(qǐng)與cdev注冊(cè)現(xiàn)在我們?cè)诔跏蓟瘮?shù)中將這些部分串聯(lián)起來。static int __init gmem_init(void) { dev_t devno; int ret; // 1. 動(dòng)態(tài)申請(qǐng)一個(gè)主設(shè)備號(hào)以及此設(shè)備號(hào)下的次設(shè)備號(hào)范圍這里我們只用一個(gè)設(shè)備 ret alloc_chrdev_region(devno, 0, 1, GMEM_DEVICE_NAME); if (ret 0) { printk(KERN_ERR GMEM: Failed to allocate device number.\n); return ret; } gmem_major MAJOR(devno); // 提取主設(shè)備號(hào) printk(KERN_INFO GMEM: Allocated major number %d.\n, gmem_major); // 2. 分配設(shè)備結(jié)構(gòu)體內(nèi)存 gmem_device kzalloc(sizeof(struct gmem_dev), GFP_KERNEL); if (!gmem_device) { ret -ENOMEM; goto fail_alloc_dev; } // 3. 分配設(shè)備內(nèi)存緩沖區(qū) gmem_device-buffer kzalloc(GMEM_BUFFER_SIZE, GFP_KERNEL); if (!gmem_device-buffer) { ret -ENOMEM; goto fail_alloc_buf; } gmem_device-buffer_size GMEM_BUFFER_SIZE; // 4. 初始化 cdev 結(jié)構(gòu)并將其與 file_operations 綁定 cdev_init(gmem_device-cdev, gmem_fops); gmem_device-cdev.owner THIS_MODULE; // 5. 將 cdev 添加到內(nèi)核系統(tǒng)使其生效 ret cdev_add(gmem_device-cdev, devno, 1); if (ret) { printk(KERN_ERR GMEM: Failed to add cdev.\n); goto fail_add_cdev; } printk(KERN_INFO GMEM: Character device driver initialized successfully.\n); return 0; // 成功 // 錯(cuò)誤處理路徑內(nèi)核編程必須嚴(yán)謹(jǐn)處理每一步可能出現(xiàn)的錯(cuò)誤 fail_add_cdev: kfree(gmem_device-buffer); fail_alloc_buf: kfree(gmem_device); fail_alloc_dev: unregister_chrdev_region(devno, 1); return ret; }對(duì)應(yīng)的退出函數(shù)需要對(duì)稱地釋放所有資源static void __exit gmem_exit(void) { dev_t devno MKDEV(gmem_major, 0); // 根據(jù)主設(shè)備號(hào)生成完整的設(shè)備號(hào) // 1. 從系統(tǒng)刪除cdev cdev_del(gmem_device-cdev); // 2. 釋放設(shè)備緩沖區(qū) kfree(gmem_device-buffer); // 3. 釋放設(shè)備結(jié)構(gòu)體 kfree(gmem_device); // 4. 釋放設(shè)備號(hào) unregister_chrdev_region(devno, 1); printk(KERN_INFO GMEM: Driver unloaded.\n); }3.5 創(chuàng)建設(shè)備文件節(jié)點(diǎn)模塊加載成功后內(nèi)核里已經(jīng)有了我們的驅(qū)動(dòng)但用戶空間還沒有一個(gè)“文件”入口來訪問它。我們需要手動(dòng)創(chuàng)建設(shè)備文件節(jié)點(diǎn)。# 加載模塊后查看內(nèi)核日志獲取動(dòng)態(tài)分配的主設(shè)備號(hào) $ sudo insmod gmem_driver.ko $ dmesg | tail -2 [ 1234.567890] GMEM: Allocated major number 511. [ 1234.567891] GMEM: Character device driver initialized successfully. # 使用 mknod 命令創(chuàng)建設(shè)備文件。主設(shè)備號(hào)為511次設(shè)備號(hào)為0。 $ sudo mknod /dev/gmem c 511 0 # 設(shè)置合適的權(quán)限 $ sudo chmod 666 /dev/gmem現(xiàn)在你就可以像操作普通文件一樣測(cè)試這個(gè)驅(qū)動(dòng)了$ echo Hello, GMEM Driver! /dev/gmem $ cat /dev/gmem Hello, GMEM Driver! $ dd if/dev/zero of/dev/gmem bs1 count5 seek10 # 從偏移10處寫入5個(gè)字節(jié) $ hexdump -C /dev/gmem # 以十六進(jìn)制查看設(shè)備內(nèi)存內(nèi)容4. 高級(jí)話題與生產(chǎn)環(huán)境考量一個(gè)玩具級(jí)的驅(qū)動(dòng)和能在實(shí)際項(xiàng)目中使用的驅(qū)動(dòng)差距往往在于對(duì)細(xì)節(jié)和復(fù)雜場(chǎng)景的處理。下面這些點(diǎn)是你在開發(fā)真實(shí)驅(qū)動(dòng)時(shí)必須考慮的。4.1 并發(fā)控制與同步機(jī)制我們的示例驅(qū)動(dòng)有一個(gè)致命缺陷它沒有處理并發(fā)訪問。如果兩個(gè)進(jìn)程同時(shí)調(diào)用gmem_write它們可能會(huì)互相覆蓋數(shù)據(jù)導(dǎo)致數(shù)據(jù)錯(cuò)亂。在內(nèi)核中共享資源比如我們驅(qū)動(dòng)的buffer必須被保護(hù)。最常用的同步原語是自旋鎖和信號(hào)量。自旋鎖適用于臨界區(qū)執(zhí)行時(shí)間非常短如幾條指令且不能在睡眠的上下文如中斷處理程序中。等待鎖的線程會(huì)“忙等待”。信號(hào)量適用于臨界區(qū)可能執(zhí)行較長時(shí)間或操作可能睡眠如等待數(shù)據(jù)。等待鎖的線程會(huì)進(jìn)入睡眠狀態(tài)讓出CPU。對(duì)于我們的內(nèi)存緩沖區(qū)寫操作可能涉及copy_from_user這個(gè)函數(shù)可能引起缺頁異常而導(dǎo)致睡眠因此更適合使用信號(hào)量。我們使用內(nèi)核更推薦的mutex互斥鎖它是一種特殊的信號(hào)量。#include linux/mutex.h struct gmem_dev { struct cdev cdev; unsigned char *buffer; unsigned long buffer_size; struct mutex lock; // 添加一個(gè)互斥鎖 }; // 在初始化函數(shù)中初始化鎖 mutex_init(gmem_device-lock); // 在 read/write 函數(shù)中使用鎖保護(hù)臨界區(qū) static ssize_t gmem_write(struct file *filp, const char __user *buf, size_t count, loff_t *f_pos) { struct gmem_dev *dev filp-private_data; ssize_t retval 0; // 獲取鎖 if (mutex_lock_interruptible(dev-lock)) return -ERESTARTSYS; // 如果在獲取鎖時(shí)被信號(hào)中斷 // ... 原有的計(jì)算和拷貝邏輯 ... mutex_unlock(dev-lock); // 釋放鎖 return retval; } // read 函數(shù)也需要用同樣的鎖保護(hù)4.2 自動(dòng)創(chuàng)建設(shè)備節(jié)點(diǎn)udev/mdev手動(dòng)mknod太不專業(yè)了。在生產(chǎn)環(huán)境中我們期望模塊加載后/dev目錄下自動(dòng)出現(xiàn)設(shè)備節(jié)點(diǎn)。這需要驅(qū)動(dòng)向內(nèi)核的設(shè)備模型sysfs注冊(cè)一個(gè)類class和設(shè)備device。#include linux/device.h static struct class *gmem_class; static struct device *gmem_device_node; // 在初始化函數(shù)成功注冊(cè)cdev后 gmem_class class_create(THIS_MODULE, gmem_class); if (IS_ERR(gmem_class)) { ret PTR_ERR(gmem_class); goto fail_class_create; } // 創(chuàng)建設(shè)備節(jié)點(diǎn)udev/mdev會(huì)根據(jù)這個(gè)信息自動(dòng)創(chuàng)建 /dev/gmem gmem_device_node device_create(gmem_class, NULL, devno, NULL, GMEM_DEVICE_NAME); if (IS_ERR(gmem_device_node)) { ret PTR_ERR(gmem_device_node); goto fail_device_create; } // 在退出函數(shù)中對(duì)稱銷毀 device_destroy(gmem_class, devno); class_destroy(gmem_class);使用了class_create和device_create后加載模塊/dev/gmem會(huì)自動(dòng)出現(xiàn)權(quán)限由udev規(guī)則決定通常為root:root 666。4.3 ioctl實(shí)現(xiàn)自定義控制命令read/write是流式操作但設(shè)備往往需要一些控制命令比如“設(shè)置波特率”、“讀取設(shè)備狀態(tài)”、“啟動(dòng)校準(zhǔn)”等。這就是ioctl的用武之地。它允許用戶空間傳遞一個(gè)命令字和一個(gè)可選參數(shù)給驅(qū)動(dòng)。首先需要為你的驅(qū)動(dòng)定義一個(gè)唯一的“幻數(shù)”magic number并枚舉出所有命令。#include linux/ioctl.h #define GMEM_IOC_MAGIC G // 定義一個(gè)幻數(shù)通常是一個(gè)字符 // 定義命令_IO/_IOR/_IOW/_IOWR 是構(gòu)造命令號(hào)的宏 #define GMEM_IOC_RESET _IO(GMEM_IOC_MAGIC, 0) // 無參數(shù)命令 #define GMEM_IOC_GET_SIZE _IOR(GMEM_IOC_MAGIC, 1, int) // 從驅(qū)動(dòng)讀數(shù)據(jù)參數(shù)是指向int的指針 #define GMEM_IOC_SET_DATA _IOW(GMEM_IOC_MAGIC, 2, int) // 向驅(qū)動(dòng)寫數(shù)據(jù) #define GMEM_IOC_MAXNR 2 // 最大命令編號(hào)然后在file_operations中實(shí)現(xiàn).unlocked_ioctl新驅(qū)動(dòng)推薦使用這個(gè)而非舊的.ioctl。static long gmem_ioctl(struct file *filp, unsigned int cmd, unsigned long arg) { struct gmem_dev *dev filp-private_data; int ret 0; int size 0; // 檢查命令是否屬于本設(shè)備 if (_IOC_TYPE(cmd) ! GMEM_IOC_MAGIC) return -ENOTTY; if (_IOC_NR(cmd) GMEM_IOC_MAXNR) return -ENOTTY; switch (cmd) { case GMEM_IOC_RESET: mutex_lock(dev-lock); memset(dev-buffer, 0, dev-buffer_size); filp-f_pos 0; mutex_unlock(dev-lock); printk(KERN_INFO GMEM: Buffer reset.\n); break; case GMEM_IOC_GET_SIZE: size dev-buffer_size; // 將內(nèi)核數(shù)據(jù)拷貝到用戶空間指針 arg 指向的位置 if (copy_to_user((int __user *)arg, size, sizeof(size))) ret -EFAULT; break; case GMEM_IOC_SET_DATA: // 從用戶空間指針 arg 讀取一個(gè)整數(shù)作為填充值 if (copy_from_user(size, (int __user *)arg, sizeof(size))) { ret -EFAULT; break; } mutex_lock(dev-lock); memset(dev-buffer, size 0xFF, dev-buffer_size); // 用低8位填充緩沖區(qū) mutex_unlock(dev-lock); break; default: ret -ENOTTY; // 未知命令 } return ret; } // 別忘了在 file_operations 中添加 .unlocked_ioctl gmem_ioctl用戶空間程序可以這樣調(diào)用int fd open(/dev/gmem, O_RDWR); int size; ioctl(fd, GMEM_IOC_GET_SIZE, size); // 獲取緩沖區(qū)大小 ioctl(fd, GMEM_IOC_RESET); // 重置緩沖區(qū) int fill_value 0xAA; ioctl(fd, GMEM_IOC_SET_DATA, fill_value); // 用0xAA填充緩沖區(qū)5. 調(diào)試技巧與常見問題排查驅(qū)動(dòng)開發(fā)調(diào)試不像用戶態(tài)程序那樣方便但掌握一些核心工具和方法能極大提升效率。5.1 內(nèi)核日志printk 的藝術(shù)printk是你的眼睛。但它有幾個(gè)級(jí)別KERN_DEBUG,KERN_INFO,KERN_WARNING,KERN_ERR等默認(rèn)情況下KERN_DEBUG信息可能不會(huì)顯示在控制臺(tái)?？梢酝ㄟ^dmesg查看所有級(jí)別的日志或者動(dòng)態(tài)調(diào)整內(nèi)核日志級(jí)別# 查看當(dāng)前控制臺(tái)日志級(jí)別 cat /proc/sys/kernel/printk # 臨時(shí)將控制臺(tái)日志級(jí)別調(diào)整為8打印所有信息 echo 8 /proc/sys/kernel/printk在驅(qū)動(dòng)中合理使用__FILE__,__LINE__,__func__宏可以幫助你快速定位打印信息的位置。5.2 使用 /proc 和 sysfs 進(jìn)行調(diào)試除了printk你還可以通過/proc或sysfs接口在運(yùn)行時(shí)導(dǎo)出驅(qū)動(dòng)內(nèi)部狀態(tài)這比反復(fù)修改代碼加printk更靈活。例如創(chuàng)建一個(gè)/proc/gmem_info文件來顯示緩沖區(qū)使用情況#include linux/proc_fs.h #include linux/seq_file.h static int gmem_proc_show(struct seq_file *m, void *v) { struct gmem_dev *dev gmem_device; // 假設(shè)是全局變量 seq_printf(m, GMEM Driver Status:\n); seq_printf(m, Buffer Size: %lu bytes\n, dev-buffer_size); seq_printf(m, Buffer Addr: %p\n, dev-buffer); // 可以打印更多信息如前10個(gè)字節(jié)內(nèi)容 seq_printf(m, First 10 bytes: ); for (int i 0; i 10 i dev-buffer_size; i) seq_printf(m, %02x , dev-buffer[i]); seq_printf(m, \n); return 0; } static int __init gmem_init(void) { // ... 其他初始化 ... proc_create_single(gmem_info, 0, NULL, gmem_proc_show); // ... } // 退出函數(shù)中需要 remove_proc_entry(gmem_info, NULL);加載驅(qū)動(dòng)后cat /proc/gmem_info就能看到這些信息。5.3 常見問題與排查表問題現(xiàn)象可能原因排查思路insmod失敗報(bào)Invalid module format模塊編譯的內(nèi)核版本與當(dāng)前運(yùn)行內(nèi)核版本不匹配。使用uname -r確認(rèn)運(yùn)行內(nèi)核版本確保編譯用的內(nèi)核頭文件路徑 (KDIR) 正確。insmod成功但dmesg看不到初始化信息。printk級(jí)別太低或者初始化函數(shù)出錯(cuò)提前返回。1. 檢查dmesg -l debug或調(diào)整printk級(jí)別。2. 在初始化函數(shù)每一步后都加printk看執(zhí)行到哪一步。open(“/dev/xxx”)失敗返回-1errno2(ENOENT)。設(shè)備文件節(jié)點(diǎn)不存在。1. 檢查設(shè)備號(hào)是否申請(qǐng)成功 (dmesg)。2. 檢查mknod命令的主次設(shè)備號(hào)是否正確或檢查udev/mdev是否自動(dòng)創(chuàng)建。3. 檢查/dev目錄下是否有該文件。open失敗返回-1errno13(EACCES)。權(quán)限不足。使用ls -l /dev/xxx檢查設(shè)備文件權(quán)限確保當(dāng)前用戶有讀寫權(quán)限。read/write返回-1errno14(EFAULT)。用戶空間指針非法。檢查驅(qū)動(dòng)中copy_to_user/copy_from_user的返回值。確保用戶空間傳入的緩沖區(qū)地址和大小有效。在用戶程序中使用malloc或棧數(shù)組并檢查指針是否為NULL。多進(jìn)程讀寫數(shù)據(jù)混亂或驅(qū)動(dòng)崩潰。缺乏并發(fā)控制鎖。檢查所有訪問共享資源全局變量、緩沖區(qū)的地方是否都用鎖如mutex保護(hù)。特別注意read,write,ioctl函數(shù)。模塊卸載 (rmmod) 失敗提示Module in use。設(shè)備文件仍被進(jìn)程打開。使用lsof /dev/xxx或fuser /dev/xxx查看是哪個(gè)進(jìn)程打開了設(shè)備關(guān)閉后再卸載。檢查驅(qū)動(dòng)的.release方法是否被正確調(diào)用。系統(tǒng)不穩(wěn)定或死機(jī)。內(nèi)核空間內(nèi)存訪問越界、使用了錯(cuò)誤的指針、死鎖。這是最棘手的問題。1. 使用KASAN內(nèi)核地址消毒劑工具編譯內(nèi)核它能檢測(cè)很多內(nèi)存錯(cuò)誤。2. 仔細(xì)檢查所有指針操作特別是數(shù)組索引。3. 檢查鎖的獲取和釋放是否成對(duì)出現(xiàn)避免死鎖如重復(fù)加鎖、鎖未釋放就返回。5.4 內(nèi)核調(diào)試器KGDB 與 ftrace對(duì)于極其復(fù)雜的問題可能需要更強(qiáng)大的工具。KGDB允許你像調(diào)試用戶態(tài)程序一樣通過GDB連接到一個(gè)運(yùn)行中的內(nèi)核設(shè)置斷點(diǎn)、單步執(zhí)行、查看變量。這需要兩臺(tái)機(jī)器或使用虛擬機(jī)配置較為復(fù)雜。ftrace內(nèi)核內(nèi)置的跟蹤工具可以跟蹤函數(shù)調(diào)用關(guān)系、測(cè)量延遲、分析中斷關(guān)閉時(shí)間等對(duì)性能分析和查找復(fù)雜執(zhí)行路徑問題非常有用。例如你可以跟蹤gmem_read函數(shù)的調(diào)用情況echo 0 /sys/kernel/debug/tracing/tracing_on echo function /sys/kernel/debug/tracing/current_tracer echo gmem_read /sys/kernel/debug/tracing/set_ftrace_filter echo 1 /sys/kernel/debug/tracing/tracing_on # ... 執(zhí)行你的測(cè)試 ... echo 0 /sys/kernel/debug/tracing/tracing_on cat /sys/kernel/debug/tracing/trace驅(qū)動(dòng)開發(fā)是一個(gè)對(duì)細(xì)節(jié)要求極高的工作一個(gè)微小的錯(cuò)誤就可能導(dǎo)致系統(tǒng)崩潰。從最簡單的框架開始逐步添加功能如鎖、自動(dòng)創(chuàng)建設(shè)備節(jié)點(diǎn)、ioctl并在每一步進(jìn)行充分的測(cè)試是穩(wěn)健推進(jìn)的不二法門。理解并熟練運(yùn)用字符設(shè)備驅(qū)動(dòng)框架就等于拿到了打開Linux內(nèi)核世界一扇大門的鑰匙后續(xù)無論是學(xué)習(xí)更復(fù)雜的子系統(tǒng)框架還是為自己的硬件編寫驅(qū)動(dòng)都將事半功倍。 Linux字符設(shè)備驅(qū)動(dòng)開發(fā)：從基礎(chǔ)概念到實(shí)戰(zhàn)實(shí)現(xiàn)
1. 項(xiàng)目概述為什么字符設(shè)備驅(qū)動(dòng)是Linux內(nèi)核的基石在嵌入式開發(fā)、服務(wù)器運(yùn)維乃至桌面應(yīng)用開發(fā)中只要你的程序需要和硬件打交道或者需要在內(nèi)核層面實(shí)現(xiàn)一個(gè)特殊的虛擬設(shè)備那么“驅(qū)動(dòng)”這個(gè)概念就繞不開。而字符設(shè)備驅(qū)動(dòng)可以說是Linux驅(qū)動(dòng)開發(fā)中最基礎(chǔ)、最經(jīng)典也是應(yīng)用最廣泛的一類。它不像塊設(shè)備驅(qū)動(dòng)那樣需要考慮復(fù)雜的緩存和I/O調(diào)度也不像網(wǎng)絡(luò)設(shè)備驅(qū)動(dòng)那樣需要處理協(xié)議棧它的核心任務(wù)就是提供一種“字節(jié)流”式的訪問方式。簡單來說你可以把它想象成一個(gè)特殊的文件用戶空間的程序通過標(biāo)準(zhǔn)的文件操作接口open,read,write,ioctl,close來和它交互而驅(qū)動(dòng)則負(fù)責(zé)將這些操作翻譯成對(duì)具體硬件或邏輯的操作。我見過很多剛接觸內(nèi)核開發(fā)的朋友一上來就想搞懂復(fù)雜的框架比如V4L2、DRM或者IIO結(jié)果往往一頭霧水。原因就在于這些高級(jí)框架的底層無一例外都建立在字符設(shè)備驅(qū)動(dòng)框架之上。不理解這個(gè)基礎(chǔ)框架就像蓋樓不打地基看再多的上層建筑也是空中樓閣。今天我們就來徹底拆解Linux的字符設(shè)備驅(qū)動(dòng)框架我會(huì)結(jié)合我過去在多個(gè)嵌入式項(xiàng)目從簡單的GPIO按鍵到復(fù)雜的傳感器數(shù)據(jù)采集中的實(shí)際踩坑經(jīng)驗(yàn)把它的設(shè)計(jì)思想、核心數(shù)據(jù)結(jié)構(gòu)、注冊(cè)流程以及如何與用戶空間通信掰開揉碎了講清楚。無論你是想為一塊自制的開發(fā)板寫驅(qū)動(dòng)還是想深入理解某個(gè)內(nèi)核子系統(tǒng)這篇文章都能給你提供一個(gè)堅(jiān)實(shí)、清晰的起點(diǎn)。2. 核心概念與框架設(shè)計(jì)思想2.1 什么是字符設(shè)備與塊設(shè)備、網(wǎng)絡(luò)設(shè)備的本質(zhì)區(qū)別在Linux的“一切皆文件”哲學(xué)里設(shè)備也被抽象成了文件。但不同類型的設(shè)備其“文件”的行為模式天差地別。理解這種差異是選擇正確驅(qū)動(dòng)框架的前提。字符設(shè)備的核心特征是“字節(jié)流”。數(shù)據(jù)像一個(gè)連續(xù)的水流按順序被讀取或?qū)懭?。典型的例子有終端(/dev/tty*): 你敲入的字符按順序被讀取。串口(/dev/ttyS*): 數(shù)據(jù)一個(gè)字節(jié)一個(gè)字節(jié)地收發(fā)。隨機(jī)數(shù)生成器(/dev/random,/dev/urandom): 每次讀取都得到一串隨機(jī)的字節(jié)流。大部分傳感器比如溫度傳感器你讀取它得到的是一個(gè)代表溫度值的字節(jié)序列。內(nèi)存(/dev/mem,/dev/null): 對(duì)內(nèi)存地址的線性訪問。它的訪問通常是“直接”的沒有中間緩存驅(qū)動(dòng)開發(fā)者可以自己實(shí)現(xiàn)緩存但內(nèi)核不強(qiáng)制提供。一個(gè)read系統(tǒng)調(diào)用可能只讀取幾個(gè)字節(jié)下一個(gè)read會(huì)從上次結(jié)束的地方繼續(xù)。塊設(shè)備則不同它的核心特征是“塊”。數(shù)據(jù)被組織成固定大小的塊如512字節(jié)、4KB并且訪問是“隨機(jī)”的。典型的例子是硬盤、SSD、U盤 (/dev/sda*)。內(nèi)核為塊設(shè)備提供了復(fù)雜的緩存機(jī)制Page Cache和I/O調(diào)度器以提高性能。你可以在文件的任意位置進(jìn)行讀寫而不必關(guān)心物理介質(zhì)上數(shù)據(jù)是否連續(xù)。網(wǎng)絡(luò)設(shè)備則完全脫離了“文件”的抽象。它沒有對(duì)應(yīng)的設(shè)備文件如/dev/eth0而是通過套接字接口進(jìn)行訪問。數(shù)據(jù)以“數(shù)據(jù)包”為單位處理涉及復(fù)雜的網(wǎng)絡(luò)協(xié)議棧。注意區(qū)分字符設(shè)備和塊設(shè)備的一個(gè)簡單方法是字符設(shè)備通常不支持“掛載文件系統(tǒng)”而塊設(shè)備可以。你不能把/dev/ttyS0掛載成一個(gè)目錄但可以把/dev/sda1掛載到/home。2.2 “文件操作”接口驅(qū)動(dòng)與用戶空間的契約字符設(shè)備驅(qū)動(dòng)框架的精髓在于它定義了一套清晰的“契約”。內(nèi)核提供了一套標(biāo)準(zhǔn)的操作函數(shù)集合struct file_operations驅(qū)動(dòng)開發(fā)者需要實(shí)現(xiàn)這個(gè)結(jié)構(gòu)體中與自己設(shè)備相關(guān)的函數(shù)指針。當(dāng)用戶空間程序調(diào)用open(“/dev/mydevice”)時(shí)內(nèi)核最終會(huì)調(diào)用到你驅(qū)動(dòng)中實(shí)現(xiàn)的.open方法。這套設(shè)計(jì)的好處是解耦和統(tǒng)一。用戶空間的應(yīng)用程序員不需要關(guān)心底層是真實(shí)的串口芯片還是一個(gè)虛擬的日志設(shè)備他們一律用read(fd, buf, size)來讀數(shù)據(jù)。驅(qū)動(dòng)開發(fā)者則只需要關(guān)注如何填充file_operations這個(gè)“填空題”內(nèi)核負(fù)責(zé)將系統(tǒng)調(diào)用路由到正確的驅(qū)動(dòng)函數(shù)。2.3 核心數(shù)據(jù)結(jié)構(gòu)關(guān)系圖邏輯層面理解驅(qū)動(dòng)框架必須理清幾個(gè)核心數(shù)據(jù)結(jié)構(gòu)之間的關(guān)系。它們構(gòu)成了驅(qū)動(dòng)模型的骨架。struct cdev: 這是內(nèi)核中代表一個(gè)字符設(shè)備對(duì)象的核心結(jié)構(gòu)。它內(nèi)部包含了一個(gè)struct kobject用于內(nèi)核對(duì)象管理和sysfs導(dǎo)出最重要的是它擁有一個(gè)指向struct file_operations的指針。你可以認(rèn)為一個(gè)cdev就是一個(gè)“驅(qū)動(dòng)實(shí)例”它綁定了具體的操作函數(shù)集。struct file_operations: 這是驅(qū)動(dòng)需要實(shí)現(xiàn)的“方法表”。包含了open、release、read、write、unlocked_ioctl、llseek等一系列函數(shù)指針。驅(qū)動(dòng)的工作就是填充這個(gè)表。struct inode: 索引節(jié)點(diǎn)。在文件系統(tǒng)中每個(gè)文件包括設(shè)備文件都有一個(gè)inode它存儲(chǔ)文件的元數(shù)據(jù)權(quán)限、所有者、時(shí)間戳等。對(duì)于設(shè)備文件inode中有一個(gè)關(guān)鍵的i_cdev字段指向其對(duì)應(yīng)的struct cdev對(duì)象。正是通過這個(gè)鏈接內(nèi)核在打開設(shè)備文件時(shí)能找到該由哪個(gè)驅(qū)動(dòng)來處理。struct file: 文件對(duì)象。每當(dāng)一個(gè)進(jìn)程打開一個(gè)文件包括設(shè)備文件內(nèi)核都會(huì)創(chuàng)建一個(gè)file對(duì)象。它代表了一次打開的上下文。它內(nèi)部包含了一個(gè)f_op指針在打開設(shè)備文件時(shí)這個(gè)指針會(huì)被初始化為對(duì)應(yīng)cdev所擁有的file_operations。此外它還包含一個(gè)private_data指針這是一個(gè)非常重要的字段驅(qū)動(dòng)可以用它來存儲(chǔ)本次文件打開相關(guān)的私有數(shù)據(jù)比如一個(gè)指向設(shè)備硬件寄存器映射地址的結(jié)構(gòu)體。它們的關(guān)系可以簡單描述為用戶程序打開/dev/mydev- 內(nèi)核找到其inode- 通過inode-i_cdev找到對(duì)應(yīng)的cdev- 將本次打開的file-f_op指向cdev-ops- 后續(xù)的read/write等調(diào)用便通過file-f_op-read等指針調(diào)用到驅(qū)動(dòng)實(shí)現(xiàn)的具體函數(shù)。3. 驅(qū)動(dòng)開發(fā)全流程拆解與實(shí)操理論說再多不如動(dòng)手寫一行代碼。下面我們以一個(gè)虛擬的“全局內(nèi)存”設(shè)備為例一步步實(shí)現(xiàn)一個(gè)完整的字符設(shè)備驅(qū)動(dòng)。這個(gè)設(shè)備的功能很簡單在內(nèi)核中分配一段內(nèi)存用戶空間可以通過讀寫/dev/gmem來操作這段內(nèi)存就像操作一個(gè)普通的字節(jié)數(shù)組文件一樣。3.1 環(huán)境準(zhǔn)備與模塊基礎(chǔ)首先你需要一個(gè)Linux開發(fā)環(huán)境?？梢允菍?shí)體機(jī)也可以是虛擬機(jī)。確保安裝了對(duì)應(yīng)內(nèi)核版本的頭文件或開發(fā)包。例如在Ubuntu上sudo apt update sudo apt install linux-headers-$(uname -r) build-essential一個(gè)最簡單的內(nèi)核模塊“Hello World”是理解模塊加載/卸載機(jī)制的基礎(chǔ)。這里給出骨架// gmem_driver.c #include linux/init.h #include linux/module.h #include linux/kernel.h MODULE_LICENSE(GPL); MODULE_AUTHOR(Your Name); MODULE_DESCRIPTION(A simple global memory character device driver); static int __init gmem_init(void) { printk(KERN_INFO GMEM: Driver loaded.\n); return 0; } static void __exit gmem_exit(void) { printk(KERN_INFO GMEM: Driver unloaded.\n); } module_init(gmem_init); module_exit(gmem_exit);對(duì)應(yīng)的Makefileobj-m gmem_driver.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編譯 (make) 后使用sudo insmod gmem_driver.ko加載dmesg | tail查看內(nèi)核日志再用sudo rmmod gmem_driver卸載。這個(gè)流程是所有驅(qū)動(dòng)開發(fā)的起點(diǎn)。3.2 核心結(jié)構(gòu)體定義與初始化現(xiàn)在開始為我們的“全局內(nèi)存”設(shè)備定義核心數(shù)據(jù)。#include linux/fs.h // 包含 file_operations 定義 #include linux/cdev.h #include linux/slab.h // kmalloc, kfree #include linux/uaccess.h // copy_to_user, copy_from_user #define GMEM_DEVICE_NAME gmem #define GMEM_BUFFER_SIZE 1024 // 假設(shè)我們的“設(shè)備”只有1KB內(nèi)存 // 代表我們?cè)O(shè)備自身的數(shù)據(jù)結(jié)構(gòu) struct gmem_dev { struct cdev cdev; // 內(nèi)嵌的字符設(shè)備對(duì)象必須 unsigned char *buffer; // 指向設(shè)備內(nèi)存內(nèi)核空間的指針 unsigned long buffer_size; // 緩沖區(qū)大小 // 可以添加其他設(shè)備特定信息如信號(hào)量、自旋鎖等 }; static int gmem_major 0; // 主設(shè)備號(hào)0表示動(dòng)態(tài)分配 static struct gmem_dev *gmem_device;在模塊初始化函數(shù)gmem_init中我們需要做以下幾件事申請(qǐng)?jiān)O(shè)備號(hào)。分配并初始化我們的設(shè)備結(jié)構(gòu)體struct gmem_dev。初始化內(nèi)嵌的struct cdev并將其與file_operations綁定。將cdev添加到內(nèi)核中使其生效。3.3 實(shí)現(xiàn)文件操作集合 (file_operations)這是驅(qū)動(dòng)的“大腦”我們來實(shí)現(xiàn)最關(guān)鍵的幾個(gè)操作。// 首先定義 file_operations static struct file_operations gmem_fops { .owner THIS_MODULE, // 防止模塊在使用中被卸載 .open gmem_open, .release gmem_release, .read gmem_read, .write gmem_write, .llseek gmem_llseek, }; // open 方法 static int gmem_open(struct inode *inode, struct file *filp) { struct gmem_dev *dev; // 通過 inode 找到我們之前注冊(cè)的 cdev進(jìn)而找到我們的設(shè)備結(jié)構(gòu)體 dev container_of(inode-i_cdev, struct gmem_dev, cdev); // 將設(shè)備結(jié)構(gòu)體指針存儲(chǔ)到 file 的私有數(shù)據(jù)區(qū)方便其他函數(shù)使用 filp-private_data dev; printk(KERN_DEBUG GMEM: Device opened.\n); return 0; } // release 方法 (對(duì)應(yīng) close) static int gmem_release(struct inode *inode, struct file *filp) { printk(KERN_DEBUG GMEM: Device closed.\n); return 0; } // read 方法將設(shè)備內(nèi)存內(nèi)核空間的數(shù)據(jù)拷貝到用戶空間緩沖區(qū) static ssize_t gmem_read(struct file *filp, char __user *buf, size_t count, loff_t *f_pos) { struct gmem_dev *dev filp-private_data; ssize_t retval 0; // 計(jì)算可讀的最大字節(jié)數(shù)不能超過緩沖區(qū)大小也不能超過請(qǐng)求的count if (*f_pos dev-buffer_size) return 0; // 文件指針已到末尾 if (*f_pos count dev-buffer_size) count dev-buffer_size - *f_pos; // 核心將內(nèi)核緩沖區(qū)的數(shù)據(jù)拷貝到用戶空間。這是必須的一步不能直接傳遞指針。 if (copy_to_user(buf, dev-buffer *f_pos, count)) { retval -EFAULT; // 拷貝失敗返回錯(cuò)誤碼 goto out; } *f_pos count; // 更新文件指針 retval count; // 返回實(shí)際讀取的字節(jié)數(shù) out: return retval; } // write 方法將用戶空間緩沖區(qū)數(shù)據(jù)拷貝到設(shè)備內(nèi)存內(nèi)核空間 static ssize_t gmem_write(struct file *filp, const char __user *buf, size_t count, loff_t *f_pos) { struct gmem_dev *dev filp-private_data; ssize_t retval 0; // 計(jì)算可寫的最大字節(jié)數(shù) if (*f_pos dev-buffer_size) return -ENOSPC; // 設(shè)備已滿 if (*f_pos count dev-buffer_size) count dev-buffer_size - *f_pos; // 核心將用戶空間數(shù)據(jù)拷貝到內(nèi)核緩沖區(qū)。 if (copy_from_user(dev-buffer *f_pos, buf, count)) { retval -EFAULT; goto out; } *f_pos count; retval count; out: return retval; } // llseek 方法修改文件指針位置 static loff_t gmem_llseek(struct file *filp, loff_t offset, int whence) { struct gmem_dev *dev filp-private_data; loff_t newpos; switch (whence) { case SEEK_SET: // 從文件開始處偏移 newpos offset; break; case SEEK_CUR: // 從當(dāng)前位置偏移 newpos filp-f_pos offset; break; case SEEK_END: // 從文件末尾偏移 newpos dev-buffer_size offset; break; default: return -EINVAL; } // 檢查新位置是否合法 if (newpos 0 || newpos dev-buffer_size) return -EINVAL; filp-f_pos newpos; return newpos; }實(shí)操心得copy_to_user和copy_from_user是用戶空間與內(nèi)核空間數(shù)據(jù)交換的唯一安全通道。直接解引用用戶空間指針會(huì)導(dǎo)致內(nèi)核崩潰或安全漏洞。這兩個(gè)函數(shù)在拷貝失敗時(shí)會(huì)返回未拷貝的字節(jié)數(shù)成功時(shí)返回0所以判斷條件通常是if (copy_to_user(...))。3.4 設(shè)備號(hào)申請(qǐng)與cdev注冊(cè)現(xiàn)在我們?cè)诔跏蓟瘮?shù)中將這些部分串聯(lián)起來。static int __init gmem_init(void) { dev_t devno; int ret; // 1. 動(dòng)態(tài)申請(qǐng)一個(gè)主設(shè)備號(hào)以及此設(shè)備號(hào)下的次設(shè)備號(hào)范圍這里我們只用一個(gè)設(shè)備 ret alloc_chrdev_region(devno, 0, 1, GMEM_DEVICE_NAME); if (ret 0) { printk(KERN_ERR GMEM: Failed to allocate device number.\n); return ret; } gmem_major MAJOR(devno); // 提取主設(shè)備號(hào) printk(KERN_INFO GMEM: Allocated major number %d.\n, gmem_major); // 2. 分配設(shè)備結(jié)構(gòu)體內(nèi)存 gmem_device kzalloc(sizeof(struct gmem_dev), GFP_KERNEL); if (!gmem_device) { ret -ENOMEM; goto fail_alloc_dev; } // 3. 分配設(shè)備內(nèi)存緩沖區(qū) gmem_device-buffer kzalloc(GMEM_BUFFER_SIZE, GFP_KERNEL); if (!gmem_device-buffer) { ret -ENOMEM; goto fail_alloc_buf; } gmem_device-buffer_size GMEM_BUFFER_SIZE; // 4. 初始化 cdev 結(jié)構(gòu)并將其與 file_operations 綁定 cdev_init(gmem_device-cdev, gmem_fops); gmem_device-cdev.owner THIS_MODULE; // 5. 將 cdev 添加到內(nèi)核系統(tǒng)使其生效 ret cdev_add(gmem_device-cdev, devno, 1); if (ret) { printk(KERN_ERR GMEM: Failed to add cdev.\n); goto fail_add_cdev; } printk(KERN_INFO GMEM: Character device driver initialized successfully.\n); return 0; // 成功 // 錯(cuò)誤處理路徑內(nèi)核編程必須嚴(yán)謹(jǐn)處理每一步可能出現(xiàn)的錯(cuò)誤 fail_add_cdev: kfree(gmem_device-buffer); fail_alloc_buf: kfree(gmem_device); fail_alloc_dev: unregister_chrdev_region(devno, 1); return ret; }對(duì)應(yīng)的退出函數(shù)需要對(duì)稱地釋放所有資源static void __exit gmem_exit(void) { dev_t devno MKDEV(gmem_major, 0); // 根據(jù)主設(shè)備號(hào)生成完整的設(shè)備號(hào) // 1. 從系統(tǒng)刪除cdev cdev_del(gmem_device-cdev); // 2. 釋放設(shè)備緩沖區(qū) kfree(gmem_device-buffer); // 3. 釋放設(shè)備結(jié)構(gòu)體 kfree(gmem_device); // 4. 釋放設(shè)備號(hào) unregister_chrdev_region(devno, 1); printk(KERN_INFO GMEM: Driver unloaded.\n); }3.5 創(chuàng)建設(shè)備文件節(jié)點(diǎn)模塊加載成功后內(nèi)核里已經(jīng)有了我們的驅(qū)動(dòng)但用戶空間還沒有一個(gè)“文件”入口來訪問它。我們需要手動(dòng)創(chuàng)建設(shè)備文件節(jié)點(diǎn)。# 加載模塊后查看內(nèi)核日志獲取動(dòng)態(tài)分配的主設(shè)備號(hào) $ sudo insmod gmem_driver.ko $ dmesg | tail -2 [ 1234.567890] GMEM: Allocated major number 511. [ 1234.567891] GMEM: Character device driver initialized successfully. # 使用 mknod 命令創(chuàng)建設(shè)備文件。主設(shè)備號(hào)為511次設(shè)備號(hào)為0。 $ sudo mknod /dev/gmem c 511 0 # 設(shè)置合適的權(quán)限 $ sudo chmod 666 /dev/gmem現(xiàn)在你就可以像操作普通文件一樣測(cè)試這個(gè)驅(qū)動(dòng)了$ echo Hello, GMEM Driver! /dev/gmem $ cat /dev/gmem Hello, GMEM Driver! $ dd if/dev/zero of/dev/gmem bs1 count5 seek10 # 從偏移10處寫入5個(gè)字節(jié) $ hexdump -C /dev/gmem # 以十六進(jìn)制查看設(shè)備內(nèi)存內(nèi)容4. 高級(jí)話題與生產(chǎn)環(huán)境考量一個(gè)玩具級(jí)的驅(qū)動(dòng)和能在實(shí)際項(xiàng)目中使用的驅(qū)動(dòng)差距往往在于對(duì)細(xì)節(jié)和復(fù)雜場(chǎng)景的處理。下面這些點(diǎn)是你在開發(fā)真實(shí)驅(qū)動(dòng)時(shí)必須考慮的。4.1 并發(fā)控制與同步機(jī)制我們的示例驅(qū)動(dòng)有一個(gè)致命缺陷它沒有處理并發(fā)訪問。如果兩個(gè)進(jìn)程同時(shí)調(diào)用gmem_write它們可能會(huì)互相覆蓋數(shù)據(jù)導(dǎo)致數(shù)據(jù)錯(cuò)亂。在內(nèi)核中共享資源比如我們驅(qū)動(dòng)的buffer必須被保護(hù)。最常用的同步原語是自旋鎖和信號(hào)量。自旋鎖適用于臨界區(qū)執(zhí)行時(shí)間非常短如幾條指令且不能在睡眠的上下文如中斷處理程序中。等待鎖的線程會(huì)“忙等待”。信號(hào)量適用于臨界區(qū)可能執(zhí)行較長時(shí)間或操作可能睡眠如等待數(shù)據(jù)。等待鎖的線程會(huì)進(jìn)入睡眠狀態(tài)讓出CPU。對(duì)于我們的內(nèi)存緩沖區(qū)寫操作可能涉及copy_from_user這個(gè)函數(shù)可能引起缺頁異常而導(dǎo)致睡眠因此更適合使用信號(hào)量。我們使用內(nèi)核更推薦的mutex互斥鎖它是一種特殊的信號(hào)量。#include linux/mutex.h struct gmem_dev { struct cdev cdev; unsigned char *buffer; unsigned long buffer_size; struct mutex lock; // 添加一個(gè)互斥鎖 }; // 在初始化函數(shù)中初始化鎖 mutex_init(gmem_device-lock); // 在 read/write 函數(shù)中使用鎖保護(hù)臨界區(qū) static ssize_t gmem_write(struct file *filp, const char __user *buf, size_t count, loff_t *f_pos) { struct gmem_dev *dev filp-private_data; ssize_t retval 0; // 獲取鎖 if (mutex_lock_interruptible(dev-lock)) return -ERESTARTSYS; // 如果在獲取鎖時(shí)被信號(hào)中斷 // ... 原有的計(jì)算和拷貝邏輯 ... mutex_unlock(dev-lock); // 釋放鎖 return retval; } // read 函數(shù)也需要用同樣的鎖保護(hù)4.2 自動(dòng)創(chuàng)建設(shè)備節(jié)點(diǎn)udev/mdev手動(dòng)mknod太不專業(yè)了。在生產(chǎn)環(huán)境中我們期望模塊加載后/dev目錄下自動(dòng)出現(xiàn)設(shè)備節(jié)點(diǎn)。這需要驅(qū)動(dòng)向內(nèi)核的設(shè)備模型sysfs注冊(cè)一個(gè)類class和設(shè)備device。#include linux/device.h static struct class *gmem_class; static struct device *gmem_device_node; // 在初始化函數(shù)成功注冊(cè)cdev后 gmem_class class_create(THIS_MODULE, gmem_class); if (IS_ERR(gmem_class)) { ret PTR_ERR(gmem_class); goto fail_class_create; } // 創(chuàng)建設(shè)備節(jié)點(diǎn)udev/mdev會(huì)根據(jù)這個(gè)信息自動(dòng)創(chuàng)建 /dev/gmem gmem_device_node device_create(gmem_class, NULL, devno, NULL, GMEM_DEVICE_NAME); if (IS_ERR(gmem_device_node)) { ret PTR_ERR(gmem_device_node); goto fail_device_create; } // 在退出函數(shù)中對(duì)稱銷毀 device_destroy(gmem_class, devno); class_destroy(gmem_class);使用了class_create和device_create后加載模塊/dev/gmem會(huì)自動(dòng)出現(xiàn)權(quán)限由udev規(guī)則決定通常為root:root 666。4.3 ioctl實(shí)現(xiàn)自定義控制命令read/write是流式操作但設(shè)備往往需要一些控制命令比如“設(shè)置波特率”、“讀取設(shè)備狀態(tài)”、“啟動(dòng)校準(zhǔn)”等。這就是ioctl的用武之地。它允許用戶空間傳遞一個(gè)命令字和一個(gè)可選參數(shù)給驅(qū)動(dòng)。首先需要為你的驅(qū)動(dòng)定義一個(gè)唯一的“幻數(shù)”magic number并枚舉出所有命令。#include linux/ioctl.h #define GMEM_IOC_MAGIC G // 定義一個(gè)幻數(shù)通常是一個(gè)字符 // 定義命令_IO/_IOR/_IOW/_IOWR 是構(gòu)造命令號(hào)的宏 #define GMEM_IOC_RESET _IO(GMEM_IOC_MAGIC, 0) // 無參數(shù)命令 #define GMEM_IOC_GET_SIZE _IOR(GMEM_IOC_MAGIC, 1, int) // 從驅(qū)動(dòng)讀數(shù)據(jù)參數(shù)是指向int的指針 #define GMEM_IOC_SET_DATA _IOW(GMEM_IOC_MAGIC, 2, int) // 向驅(qū)動(dòng)寫數(shù)據(jù) #define GMEM_IOC_MAXNR 2 // 最大命令編號(hào)然后在file_operations中實(shí)現(xiàn).unlocked_ioctl新驅(qū)動(dòng)推薦使用這個(gè)而非舊的.ioctl。static long gmem_ioctl(struct file *filp, unsigned int cmd, unsigned long arg) { struct gmem_dev *dev filp-private_data; int ret 0; int size 0; // 檢查命令是否屬于本設(shè)備 if (_IOC_TYPE(cmd) ! GMEM_IOC_MAGIC) return -ENOTTY; if (_IOC_NR(cmd) GMEM_IOC_MAXNR) return -ENOTTY; switch (cmd) { case GMEM_IOC_RESET: mutex_lock(dev-lock); memset(dev-buffer, 0, dev-buffer_size); filp-f_pos 0; mutex_unlock(dev-lock); printk(KERN_INFO GMEM: Buffer reset.\n); break; case GMEM_IOC_GET_SIZE: size dev-buffer_size; // 將內(nèi)核數(shù)據(jù)拷貝到用戶空間指針 arg 指向的位置 if (copy_to_user((int __user *)arg, size, sizeof(size))) ret -EFAULT; break; case GMEM_IOC_SET_DATA: // 從用戶空間指針 arg 讀取一個(gè)整數(shù)作為填充值 if (copy_from_user(size, (int __user *)arg, sizeof(size))) { ret -EFAULT; break; } mutex_lock(dev-lock); memset(dev-buffer, size 0xFF, dev-buffer_size); // 用低8位填充緩沖區(qū) mutex_unlock(dev-lock); break; default: ret -ENOTTY; // 未知命令 } return ret; } // 別忘了在 file_operations 中添加 .unlocked_ioctl gmem_ioctl用戶空間程序可以這樣調(diào)用int fd open(/dev/gmem, O_RDWR); int size; ioctl(fd, GMEM_IOC_GET_SIZE, size); // 獲取緩沖區(qū)大小 ioctl(fd, GMEM_IOC_RESET); // 重置緩沖區(qū) int fill_value 0xAA; ioctl(fd, GMEM_IOC_SET_DATA, fill_value); // 用0xAA填充緩沖區(qū)5. 調(diào)試技巧與常見問題排查驅(qū)動(dòng)開發(fā)調(diào)試不像用戶態(tài)程序那樣方便但掌握一些核心工具和方法能極大提升效率。5.1 內(nèi)核日志printk 的藝術(shù)printk是你的眼睛。但它有幾個(gè)級(jí)別KERN_DEBUG,KERN_INFO,KERN_WARNING,KERN_ERR等默認(rèn)情況下KERN_DEBUG信息可能不會(huì)顯示在控制臺(tái)?？梢酝ㄟ^dmesg查看所有級(jí)別的日志或者動(dòng)態(tài)調(diào)整內(nèi)核日志級(jí)別# 查看當(dāng)前控制臺(tái)日志級(jí)別 cat /proc/sys/kernel/printk # 臨時(shí)將控制臺(tái)日志級(jí)別調(diào)整為8打印所有信息 echo 8 /proc/sys/kernel/printk在驅(qū)動(dòng)中合理使用__FILE__,__LINE__,__func__宏可以幫助你快速定位打印信息的位置。5.2 使用 /proc 和 sysfs 進(jìn)行調(diào)試除了printk你還可以通過/proc或sysfs接口在運(yùn)行時(shí)導(dǎo)出驅(qū)動(dòng)內(nèi)部狀態(tài)這比反復(fù)修改代碼加printk更靈活。例如創(chuàng)建一個(gè)/proc/gmem_info文件來顯示緩沖區(qū)使用情況#include linux/proc_fs.h #include linux/seq_file.h static int gmem_proc_show(struct seq_file *m, void *v) { struct gmem_dev *dev gmem_device; // 假設(shè)是全局變量 seq_printf(m, GMEM Driver Status:\n); seq_printf(m, Buffer Size: %lu bytes\n, dev-buffer_size); seq_printf(m, Buffer Addr: %p\n, dev-buffer); // 可以打印更多信息如前10個(gè)字節(jié)內(nèi)容 seq_printf(m, First 10 bytes: ); for (int i 0; i 10 i dev-buffer_size; i) seq_printf(m, %02x , dev-buffer[i]); seq_printf(m, \n); return 0; } static int __init gmem_init(void) { // ... 其他初始化 ... proc_create_single(gmem_info, 0, NULL, gmem_proc_show); // ... } // 退出函數(shù)中需要 remove_proc_entry(gmem_info, NULL);加載驅(qū)動(dòng)后cat /proc/gmem_info就能看到這些信息。5.3 常見問題與排查表問題現(xiàn)象可能原因排查思路insmod失敗報(bào)Invalid module format模塊編譯的內(nèi)核版本與當(dāng)前運(yùn)行內(nèi)核版本不匹配。使用uname -r確認(rèn)運(yùn)行內(nèi)核版本確保編譯用的內(nèi)核頭文件路徑 (KDIR) 正確。insmod成功但dmesg看不到初始化信息。printk級(jí)別太低或者初始化函數(shù)出錯(cuò)提前返回。1. 檢查dmesg -l debug或調(diào)整printk級(jí)別。2. 在初始化函數(shù)每一步后都加printk看執(zhí)行到哪一步。open(“/dev/xxx”)失敗返回-1errno2(ENOENT)。設(shè)備文件節(jié)點(diǎn)不存在。1. 檢查設(shè)備號(hào)是否申請(qǐng)成功 (dmesg)。2. 檢查mknod命令的主次設(shè)備號(hào)是否正確或檢查udev/mdev是否自動(dòng)創(chuàng)建。3. 檢查/dev目錄下是否有該文件。open失敗返回-1errno13(EACCES)。權(quán)限不足。使用ls -l /dev/xxx檢查設(shè)備文件權(quán)限確保當(dāng)前用戶有讀寫權(quán)限。read/write返回-1errno14(EFAULT)。用戶空間指針非法。檢查驅(qū)動(dòng)中copy_to_user/copy_from_user的返回值。確保用戶空間傳入的緩沖區(qū)地址和大小有效。在用戶程序中使用malloc或棧數(shù)組并檢查指針是否為NULL。多進(jìn)程讀寫數(shù)據(jù)混亂或驅(qū)動(dòng)崩潰。缺乏并發(fā)控制鎖。檢查所有訪問共享資源全局變量、緩沖區(qū)的地方是否都用鎖如mutex保護(hù)。特別注意read,write,ioctl函數(shù)。模塊卸載 (rmmod) 失敗提示Module in use。設(shè)備文件仍被進(jìn)程打開。使用lsof /dev/xxx或fuser /dev/xxx查看是哪個(gè)進(jìn)程打開了設(shè)備關(guān)閉后再卸載。檢查驅(qū)動(dòng)的.release方法是否被正確調(diào)用。系統(tǒng)不穩(wěn)定或死機(jī)。內(nèi)核空間內(nèi)存訪問越界、使用了錯(cuò)誤的指針、死鎖。這是最棘手的問題。1. 使用KASAN內(nèi)核地址消毒劑工具編譯內(nèi)核它能檢測(cè)很多內(nèi)存錯(cuò)誤。2. 仔細(xì)檢查所有指針操作特別是數(shù)組索引。3. 檢查鎖的獲取和釋放是否成對(duì)出現(xiàn)避免死鎖如重復(fù)加鎖、鎖未釋放就返回。5.4 內(nèi)核調(diào)試器KGDB 與 ftrace對(duì)于極其復(fù)雜的問題可能需要更強(qiáng)大的工具。KGDB允許你像調(diào)試用戶態(tài)程序一樣通過GDB連接到一個(gè)運(yùn)行中的內(nèi)核設(shè)置斷點(diǎn)、單步執(zhí)行、查看變量。這需要兩臺(tái)機(jī)器或使用虛擬機(jī)配置較為復(fù)雜。ftrace內(nèi)核內(nèi)置的跟蹤工具可以跟蹤函數(shù)調(diào)用關(guān)系、測(cè)量延遲、分析中斷關(guān)閉時(shí)間等對(duì)性能分析和查找復(fù)雜執(zhí)行路徑問題非常有用。例如你可以跟蹤gmem_read函數(shù)的調(diào)用情況echo 0 /sys/kernel/debug/tracing/tracing_on echo function /sys/kernel/debug/tracing/current_tracer echo gmem_read /sys/kernel/debug/tracing/set_ftrace_filter echo 1 /sys/kernel/debug/tracing/tracing_on # ... 執(zhí)行你的測(cè)試 ... echo 0 /sys/kernel/debug/tracing/tracing_on cat /sys/kernel/debug/tracing/trace驅(qū)動(dòng)開發(fā)是一個(gè)對(duì)細(xì)節(jié)要求極高的工作一個(gè)微小的錯(cuò)誤就可能導(dǎo)致系統(tǒng)崩潰。從最簡單的框架開始逐步添加功能如鎖、自動(dòng)創(chuàng)建設(shè)備節(jié)點(diǎn)、ioctl并在每一步進(jìn)行充分的測(cè)試是穩(wěn)健推進(jìn)的不二法門。理解并熟練運(yùn)用字符設(shè)備驅(qū)動(dòng)框架就等于拿到了打開Linux內(nèi)核世界一扇大門的鑰匙后續(xù)無論是學(xué)習(xí)更復(fù)雜的子系統(tǒng)框架還是為自己的硬件編寫驅(qū)動(dòng)都將事半功倍。