1. 驱动移植概述
1.1 什么是驱动移植
驱动移植（Driver Porting）是指将已有的设备驱动程序从一个硬件平台、操作系统版本或内核版本迁移到另一个目标环境的过程。在嵌入式 Linux 开发中，驱动移植通常涉及以下三个维度的变更：
- 硬件平台变更：SoC 升级、外设控制器更换、引脚复用重定义
- 内核版本升级：驱动框架 API 变化、设备模型演进、中断/时钟子系统重构
- 设备树适配：从板级文件（board-*.c）迁移到设备树（.dts），或设备树节点属性调整
核心观点：驱动移植不是从头重写驱动，而是在理解原有驱动逻辑的基础上，针对目标平台的差异做最小化修改，同时保持驱动功能与性能不变。
1.2 为什么需要驱动移植
在实际嵌入式项目中，驱动移植是不可避免的工程活动。以下是驱动移植的主要驱动因素：
| 驱动因素 | 典型场景 | 移植必要性 |
|---|---|---|
| 芯片升级 | 从 i.MX6UL 升级到 i.MX8M Mini | 外设控制器 IP 版本变化，寄存器偏移和时序参数不同 |
| 内核主线化 | 从 Linux 4.19 迁移到 Linux 6.1 LTS | 驱动框架重构（如 GPIO 子系统、时钟框架 API 变更） |
| 设备树化改造 | 从板级文件（board-*.c）迁移到设备树 | ARM 平台强制要求设备树，旧驱动需适配 OF 接口 |
| 外设复用 | 将 SPI 触摸屏驱动从 A 平台移植到 B 平台 | 中断号、DMA 通道、时钟源等资源描述方式不同 |
| BSP 版本对齐 | 客户要求使用特定内核版本 | 供应商 BSP 驱动与主线内核存在 API 差异 |
经验之谈：驱动移植在项目开发中占比通常达到 30%~50%。掌握移植方法论，可以大幅缩短产品上市时间（TTM），避免从零开发驱动的重复劳动。
1.3 驱动移植的常见挑战
驱动移植并非简单的"复制-粘贴-编译"，工程师在实际工作中常遇到以下挑战：
- 寄存器映射差异：不同 SoC 的外设寄存器基地址、偏移量和位域定义不同，需要逐项核对芯片手册。
- 中断机制变化：中断控制器类型（GIC v2 vs GIC v3）、中断触发方式、中断号映射规则可能完全不同。
- 时钟与电源管理：时钟树结构、PLL 配置、门控时钟使能方式因芯片而异。
- DMA 适配：DMA 引擎驱动接口（dmaengine API 版本）、通道分配策略、描述符管理方式存在差异。
- 设备树绑定变更：内核版本升级后，设备树 binding 文档更新，旧属性名或格式被废弃。
- 内核 API 废弃：如
class_device_create()被device_create()替代，i2c_attach_client()被移除。
1.4 解决思路与系统方法论
针对上述挑战，本课程总结出一套经过验证的驱动移植方法论，分为四个阶段：
| 阶段 | 核心任务 | 关键动作 | 产出物 |
|---|---|---|---|
| ① 差异分析 | 对比源/目标平台差异 | 芯片手册对比、内核 API 差异扫描、设备树 binding 检查 | 差异清单（Diff List） |
| ② 资源映射 | 建立外设资源映射表 | 基地址、中断号、时钟、DMA、GPIO 引脚映射 | 资源映射表（Resource Map） |
| ③ 代码适配 | 修改驱动源码与设备树 | 寄存器偏移修正、API 替换、设备树节点重写 | 适配后的驱动源码 + .dts |
| ④ 验证回归 | 功能与性能验证 | 基本功能测试、中断延迟测量、DMA 吞吐量验证 | 测试报告 + 回归用例 |
重要提醒：很多工程师在移植时跳过"差异分析"和"资源映射"阶段，直接修改代码。这种做法在简单外设上可能侥幸成功，但遇到复杂外设（如 MIPI DSI、USB 3.0、GMAC）时，往往导致反复调试、进度延误。本课程强调"先分析、后动手"的工程原则。
1.5 设备树在驱动移植中的角色
在设备树（Device Tree）时代，驱动移植的工作重心发生了显著变化：
- 硬件描述与驱动分离：驱动代码不再硬编码寄存器地址、中断号等硬件信息，而是通过设备树节点获取。
- 平台差异集中在 .dts：同一份驱动源码可以适配多个平台，差异仅体现在设备树文件中。
- OF API 成为标准接口：驱动通过
of_property_read_u32()、of_iomap()、irq_of_parse_and_map()等 API 读取硬件资源。
/* 传统方式：硬编码寄存器地址 */
#define UART_BASE 0x02020000
#define UART_IRQ 32
/* 设备树方式：动态获取 */
static int my_probe(struct platform_device *pdev)
{
struct resource *res;
void __iomem *base;
int irq;
res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
base = devm_ioremap_resource(&pdev->dev, res);
irq = platform_get_irq(pdev, 0);
/* 驱动逻辑与硬件地址解耦 */
...
}
课程定位：本课程将重点讲解如何利用设备树机制简化驱动移植过程，包括设备树节点设计、属性映射、中断/时钟/DMA 资源描述方法，以及从旧板级文件到设备树的迁移实战。
1.6 本章小结
驱动移植是嵌入式 Linux 开发中的高频工程活动，其核心在于"理解差异、精准适配"。通过本章的学习，你应该掌握：
- 驱动移植的定义与三个维度（硬件平台、内核版本、设备树）
- 驱动移植的六大驱动因素与典型场景
- 六大常见挑战及其根因分析
- 四阶段系统方法论（差异分析 → 资源映射 → 代码适配 → 验证回归）
- 设备树在驱动移植中的桥梁作用