1. 课程导入
在嵌入式Linux产品开发中，驱动工程师常常遇到这样的场景：驱动代码在开发板上单独编译、加载、打印都正常，但一旦接入真实底板、外设、传感器或通信模块，系统就出现枚举失败、时序错乱、数据丢包、功耗异常等问题。这类问题往往不在单一驱动内部，而横跨SoC、总线、电源、时钟、GPIO、设备树、内核子系统与外设硬件。解决它所需要的，正是Linux驱动板级联调能力。
本课程定位：不是单纯讲“如何写一个字符设备驱动”，而是围绕真实硬件板卡，把驱动、设备树、总线、外设、内核配置、调试工具和测试方法串成一条完整的工程链路，训练你独立定位并解决板级问题的能力。
一、什么是Linux驱动板级联调
Linux驱动板级联调，是指在具体硬件板卡上，将Linux内核驱动与板级硬件资源、设备树描述、总线协议、电源时钟、外设行为进行联合调试，使驱动能够稳定识别硬件、正确配置参数、可靠传输数据，并满足性能与功耗要求的过程。
它包含三个关键词：
- 驱动：内核中的设备驱动代码，负责控制硬件并向上提供统一接口。
- 板级：具体PCB板上的引脚分配、电源域、时钟源、复位信号、外设连接关系。
- 联调：软硬件协同验证，通过日志、示波器、逻辑分析仪、总线工具等手段定位问题。
与“驱动开发”相比，板级联调更强调系统视角。例如I2C传感器读不到ID，可能是驱动问题，也可能是设备树地址错误、上拉电阻缺失、电源未使能、时钟未配置或总线被占用。联调的目标是快速缩小范围，找到根因。
二、学习目标
完成本课程后，你应具备以下能力：
- 理解Linux设备模型、总线、驱动、设备树之间的匹配关系。
- 能够阅读原理图和芯片手册，提取引脚、电源、时钟、总线等关键信息。
- 能够编写和修改设备树节点，完成驱动与硬件的绑定。
- 掌握常用调试手段：dmesg、sysfs、debugfs、i2c-tools、spidev、gpiod、示波器等。
- 能够分析典型板级故障：枚举失败、中断不触发、DMA异常、时序违例、电源域冲突。
- 能够完成一个从硬件确认到驱动加载、功能验证、性能测试的完整联调闭环。
三、整体知识框架
本课程的知识框架可以概括为“一条主线、四个层次、两类工具”。
| 层次 | 核心内容 | 典型对象 |
|---|---|---|
| 硬件层 | 原理图、电源、时钟、复位、引脚复用 | PMIC、晶振、GPIO、连接器 |
| 描述层 | 设备树、ACPI、板级配置文件 | dts/dtsi、compatible、reg、interrupts |
| 驱动层 | 总线驱动、子系统框架、probe流程 | I2C、SPI、UART、USB、PCIe、GPIO |
| 应用层 | 设备节点、sysfs、ioctl、网络接口 | /dev、/sys、/proc、socket |
两类工具分别是：内核观测工具（dmesg、ftrace、debugfs、sysfs）和硬件测量工具（万用表、示波器、逻辑分析仪、协议分析仪）。只有软硬结合，才能高效定位板级问题。
四、实战项目概览
课程以一个典型的ARM64嵌入式板卡为平台，围绕以下外设展开联调：
- I2C接口的温湿度传感器与EEPROM；
- SPI接口的显示屏与Flash；
- GPIO按键与LED；
- UART串口通信模块；
- USB摄像头或4G模块；
- 以太网PHY与网络性能测试。
每个外设都按照“原理图确认 → 设备树配置 → 驱动加载 → probe分析 → 功能验证 → 稳定性测试”的流程推进。最终你会得到一个可复现的板级联调方法论，而不是零散的命令集合。
五、典型误区与复盘
误区一：只改驱动，不看设备树。很多枚举失败、资源冲突问题，根因在设备树节点缺失、reg地址错误或中断号不匹配。
误区二：只看软件日志，不测硬件信号。I2C无应答可能是上拉电阻未焊、电源未上电或时钟未起振，dmesg只能告诉你“超时”，不能告诉你“为什么”。
误区三：忽略电源域和时钟顺序。外设上电时序错误会导致probe随机失败，表现为“有时能识别，有时不能”。
误区四：没有建立基线。联调前应记录原始dmesg、寄存器值、波形，否则问题复现时无法对比。
下面是一段典型的板级联调启动日志片段，后续章节会反复用到类似信息：
[ 2.315672] i2c i2c-1: Added multiplexed i2c bus 2
[ 2.320114] lm75 2-0048: probing...
[ 2.324891] lm75 2-0048: sensor register read failed: -6
[ 2.329003] lm75: probe of 2-0048 failed with error -6
[ 2.335210] spi spi0.0: setup mode 0, 8 bits/w, 10000000 Hz
[ 2.341778] panel-spi spi0.0: failed to get reset gpio
[ 2.348902] gpio-keys: gpio_keys_probe: no interrupt found
这些日志分别指向I2C通信失败、SPI复位GPIO缺失、按键中断未配置。联调的过程，就是把这些“症状”映射回硬件、设备树和驱动配置，并逐一验证。
学习建议：每完成一个外设联调，都整理一份“问题—现象—定位手段—根因—修复—验证”的记录。30章结束后，这份记录就是你自己的板级联调手册。
本课程后续将沿着这条主线展开：先建立设备模型与设备树基础，再进入总线与外设实战，最后完成综合项目联调与性能优化。你现在需要做的，是准备好一块可调试的开发板、一根串口线、一个逻辑分析仪，以及一颗愿意从现象追到根因的心。