1. 课程导入
在嵌入式与服务器硬件开发中，Linux 驱动是操作系统与物理硬件之间的“翻译层”。它把寄存器读写、中断响应、DMA 搬运、时钟与电源控制等底层动作，抽象成内核可调度的设备模型。而硬件联调工程，则是把“代码能编译”推进到“板子能跑、信号正确、性能达标、异常可复现”的完整工程过程。本课程的目标，是让学习者同时具备驱动开发能力与硬件调试能力，能够独立完成从设备树描述、驱动注册、总线匹配，到示波器/逻辑分析仪抓波形、内核日志定位、性能与稳定性验证的闭环。
本课程不是“只讲 API”的驱动课，也不是“只讲仪器”的硬件课，而是把内核软件栈与板级硬件信号放在同一张图上，训练“软硬协同定位问题”的工程思维。
一、学习目标：从会写驱动到能联调
完成本课程后，学习者应达到以下四个层次的目标：
- 理解内核设备模型：掌握 bus、device、driver 三者的匹配关系，理解 platform、I2C、SPI、PCIe、USB 等总线的驱动注册与探测流程。
- 能编写可加载驱动：独立完成字符设备、platform 驱动、中断处理、GPIO 控制、sysfs/procfs 接口，并能用 insmod/rmmod 验证。
- 能进行硬件联调：使用万用表、示波器、逻辑分析仪、JTAG 等工具，测量电源、时钟、复位、总线时序，判断是硬件问题还是驱动问题。
- 能定位与复盘：通过 dmesg、ftrace、perf、gpioinfo、i2cdetect 等工具，结合波形与日志，形成可复现的故障分析报告。
二、核心概念：一张图看清软硬边界
驱动与硬件联调的核心，是理解“软件看到的设备”与“硬件真实信号”之间的映射。下图给出本课程的整体知识框架：左侧是内核软件栈，右侧是板级硬件与测量工具，中间通过设备树、总线时序和寄存器接口连接。
三、方法流程：驱动开发与联调的闭环
一个完整的驱动与联调流程，通常遵循“描述—注册—匹配—探测—验证—测量—复盘”的闭环。下面给出可落地的步骤清单：
- 硬件确认：核对原理图，确认供电电压、时钟频率、复位极性、总线地址、中断号。
- 设备树描述：在 DTS 中填写 compatible、reg、interrupts、clocks、pinctrl 等属性。
- 驱动注册：实现 module_init/module_exit，注册 platform_driver 或 i2c_driver。
- 总线匹配：通过 of_match_table 与设备树 compatible 匹配，进入 probe 函数。
- 资源申请：request_mem_region、ioremap、request_irq、clk_get、regulator_get。
- 功能验证：用 insmod 加载，dmesg 查看 probe 日志，sysfs 读写寄存器。
- 硬件测量：用示波器/逻辑分析仪抓 I2C/SPI 波形，确认时序与电平。
- 问题定位：对比日志与波形，判断是驱动配置错误、设备树错误还是硬件故障。
- 复盘归档：记录现象、根因、修改点、验证结果，形成可复用的调试笔记。
四、案例场景：I2C 温度传感器联调
假设我们在板子上接了一颗 I2C 温度传感器，地址为 0x48，驱动加载后读取温度始终为 0。此时可以按以下顺序排查：
# 1. 查看设备树是否匹配
cat /proc/device-tree/soc/i2c@1000/temp@48/compatible
# 2. 查看驱动是否 probe 成功
dmesg | grep -i temp
# 3. 扫描 I2C 总线，确认设备是否应答
i2cdetect -y 1
# 4. 手动读取寄存器
i2cget -y 1 0x48 0x00 w
# 5. 用逻辑分析仪抓 SCL/SDA，确认起始、地址、ACK
如果 i2cdetect 能扫到 0x48，说明硬件连接与地址正确，问题可能在驱动读取逻辑或寄存器偏移；如果扫不到，则优先检查上拉电阻、供电、地址引脚和焊接。这个案例体现了“先分层、再定位”的联调思想。
五、常见误区与复盘
| 误区 | 表现 | 正确做法 |
|---|---|---|
| 只改驱动，不看设备树 | probe 不执行，日志无输出 | 先确认 compatible 与 of_match_table 一致 |
| 忽略电源与时钟 | 寄存器读写全为 0 或 0xFF | 先测供电、时钟、复位，再调驱动 |
| 用 printk 代替仪器 | 时序问题无法定位 | 关键总线用逻辑分析仪抓波形 |
| 不记录复现条件 | 问题偶发，无法复盘 | 记录温度、电压、负载、操作序列 |
建议每位学习者准备一份“联调记录表”：记录板卡型号、内核版本、设备树片段、驱动模块、测量工具、现象、根因和验证结果。这份表比任何教程都更有价值。
驱动加载成功不等于硬件工作正常。probe 成功只说明软件资源申请通过，真正的功能验证必须结合寄存器读回值、总线波形和实际物理量（温度、电压、转速等）综合判断。
本课程后续将围绕字符设备、platform 总线、设备树、中断、DMA、I2C/SPI 子系统、调试工具和典型故障案例逐步展开。学习时请始终带着“软件—硬件—测量”三重视角，把每一行驱动代码都对应到真实的引脚、时序和寄存器上，这样才能真正具备 Linux 驱动与硬件联调的工程能力。