1. 课程导入
在嵌入式Linux产品生命周期中，内核升级几乎不可避免：芯片原厂发布新的BSP、社区修复安全漏洞、产品需要支持新硬件或新文件系统，都会推动内核从旧版本迁移到新版本。而驱动代码是内核与硬件之间的“翻译层”，它直接依赖内核内部API、数据结构、锁机制和子系统框架。一旦内核版本跨越较大，驱动往往出现编译失败、加载异常、功能退化甚至系统崩溃。因此，Linux驱动版本迁移不是简单的“改几个函数名”，而是一项涉及接口适配、行为对齐、验证回归的系统工程。
一、为什么驱动迁移越来越频繁
驱动迁移的需求通常来自四个方向。第一是安全与维护：旧内核停止维护后，CVE修复不再合入，产品合规风险上升。第二是硬件演进：新SoC、新外设、新总线（如从设备树早期绑定到更严格的YAML描述）要求驱动适配新框架。第三是社区API收敛：内核社区持续清理旧接口，例如copy_from_user相关检查、file_operations成员变化、probe函数签名调整、platform_driver与设备树匹配方式变化。第四是发行版与BSP策略：Yocto、Buildroot、Android GKI等对内核版本有明确要求。
这些变化叠加后，驱动迁移的难点并不在“写代码”，而在于识别差异、定位影响面、选择替代方案、验证行为一致性。如果只靠编译报错逐个修改，很容易陷入“改完能编译，加载就崩溃”的循环。
二、核心概念：迁移中必须建立的四个认知
- 内核API不是稳定ABI：内核内部接口不保证跨版本兼容，驱动必须随内核源码一起编译。迁移时要以目标内核的
include/和Documentation/为准。 - 驱动模型与子系统框架：平台设备、字符设备、sysfs、设备树、电源管理、DMA、中断等子系统在不同版本中可能调整注册流程和生命周期回调。
- 配置与编译系统：Kconfig、Makefile、模块签名、内核配置项（如
CONFIG_OF、CONFIG_ACPI、CONFIG_MODULE_SIG）会直接影响驱动能否被编入或加载。 - 验证闭环：迁移成功不等于编译通过，必须覆盖加载/卸载、并发、错误路径、电源状态切换和长时间稳定性。
三、整体课程框架与学习目标
本课程共30章，按“认知—分析—改造—验证—复盘”的主线推进。学习完成后，你应能够独立完成一个中等复杂度驱动的跨版本迁移，并输出迁移报告与回归测试记录。
| 阶段 | 主要内容 | 产出 |
|---|---|---|
| 认知与准备 | 版本差异来源、环境搭建、源码比对方法 | 迁移影响面清单 |
| 接口适配 | file_operations、platform_driver、设备树、并发与锁 | 可编译的驱动模块 |
| 行为对齐 | probe/remove、电源管理、中断、DMA、sysfs | 功能一致的驱动 |
| 验证与回归 | 加载卸载、并发压力、错误注入、性能对比 | 测试报告与迁移记录 |
| 排障与复盘 | oops分析、ftrace、动态调试、常见坑 | 问题库与规范 |
四、一个典型迁移场景：从4.19到6.1
假设有一个平台设备驱动，负责采集GPIO中断并向上层提供字符设备节点。在4.19上工作正常，迁移到6.1后出现三类问题：编译时报implicit declaration of function ‘class_create’，加载时probe未被调用，运行中卸载模块触发Oops。对应处理思路如下：
# 1. 编译错误：class_create 参数变化
# 4.19: class_create(THIS_MODULE, "mydev");
# 6.1 : class_create("mydev");
# 2. probe未调用：检查设备树compatible与of_match_table
static const struct of_device_id mydev_of_match[] = {
{ .compatible = "vendor,mydev-v2" },
{ }
};
MODULE_DEVICE_TABLE(of, mydev_of_match);
# 3. 卸载Oops：检查remove中是否释放了仍被引用的资源
# 使用devm_*接口可降低此类风险
这个场景说明：迁移问题往往同时涉及API签名、匹配机制、资源生命周期三个层面。课程后续会逐一拆解，并给出可复用的检查清单。
五、常见误区与学习建议
误区一：只改编译错误。编译通过只是最低门槛，probe顺序、锁粒度、引用计数、电源管理回调都可能引入运行时缺陷。
误区二：直接照搬旧版写法。目标内核可能已移除旧接口，或提供了更安全的devm_*替代方案。
误区三：忽略配置差异。同一份代码在不同.config下行为不同，迁移前必须固定目标配置。
学习建议：每章动手实践时，保留迁移前后的diff、编译日志和dmesg输出。遇到问题时，先用git log和git blame查看目标内核中相关接口的变更历史，再决定适配策略。
六、本节知识结构总览
下图给出本章的核心关系：从迁移背景出发，经过核心概念与课程框架，最终落到典型场景与误区，形成完整的学习入口。