1. 课程导论：内核版本演进史与API适配

1.1 内核版本演进史（2.4 → 6.x）

Linux 内核自 1991 年诞生以来，经历了从单板架构到模块化、从同步到可抢占、从单一设备模型到统一设备驱动模型（Device Driver Model）的深刻变革。理解版本演进史，是掌握 API 变更规律的前提。

1.2 API 变更的必然性与挑战

内核 API 变更不是随意的，而是由以下驱动力推动：

• 架构演进： 从单核到多核、从 SMP 到 NUMA、从同步到 RCU 锁，驱动必须适配新的并发模型。
• 安全加固： 内核社区持续消除未定义行为、内存越界、竞态条件，API 签名和语义随之收紧。
• 可维护性： 统一设备模型、devm_ 资源管理、regmap 抽象，减少驱动样板代码。
• 新硬件支持： PCIe Gen5/6、CXL、USB4、NVMe 等新协议要求内核提供新的子系统 API。

API 变更带来的具体挑战包括：

1. 编译失败： 函数签名变更、结构体成员重命名、头文件路径调整。
2. 运行时行为差异： 同一 API 在不同版本下的语义变化（如 dma_alloc_coherent 的 GFP 标志要求）。
3. 设备树绑定变更： 属性名、节点结构、compatible 字符串的版本化。
4. Kconfig 选项迁移： 配置项被合并、拆分或重命名，导致 defconfig 失效。

1.3 适配策略的重要性

没有适配策略的驱动开发，本质上是不可持续的。一个典型的反面案例：

// 错误做法：硬编码版本判断，导致代码难以维护
#if LINUX_VERSION_CODE < KERNEL_VERSION(3,10,0)
    static int __init my_driver_init(void)
    {
        return platform_driver_register(&my_driver);
    }
#else
    static int __init my_driver_init(void)
    {
        return platform_driver_register(&my_driver);
    }
#endif

正确的适配策略应遵循以下原则：

• 使用内核提供的兼容性宏： 如 module_platform_driver() 自动处理版本差异。
• 分离平台相关代码： 将设备树绑定、寄存器偏移、时钟频率等参数化，避免硬编码。
• 利用 devm_ 资源管理： 减少错误路径处理，提高代码可移植性。
• 遵循内核编码规范： 使用 checkpatch.pl 检查，确保代码风格一致。
• 持续跟踪 LWN 和内核邮件列表： 提前了解 API 变更计划。

1.4 课程学习路径

本课程将按照以下主线展开：