1. 课程导入
当你拿到一块全新的开发板，CPU 能上电、串口能打印出几行乱码，但网口不通、屏幕不亮、SD 卡识别不到——这时候真正要做的，不是写应用程序，而是把 Linux 内核“安家”到这块具体的硬件上。这项工作就是 Linux BSP 板级适配工程。BSP（Board Support Package，板级支持包）是连接通用 Linux 内核与特定电路板之间的桥梁，它把“内核认识的世界”翻译成“这块板子真实存在的世界”。
一、学习目标：从“能启动”到“能交付”
本课程的目标不是让你背下某个芯片的寄存器手册，而是建立一套可迁移的板级适配方法论。学完之后，你应当具备以下能力：
- 看懂硬件：能从原理图、引脚复用表、时钟树和电源域中提取出内核适配所需的关键信息。
- 改得动内核：能独立完成设备树（Device Tree）编写、驱动配置、内核裁剪与编译。
- 调得通外设：能定位串口、I2C、SPI、GPIO、以太网、显示等常见外设“不工作”的原因。
- 做得成产品：能规划启动流程、根文件系统、升级方案与量产测试，把原型板变成可交付产品。
二、核心概念：BSP 到底包含什么
很多人把 BSP 等同于“驱动”，这是最常见的误解。实际上，一个完整的 BSP 至少包含四个层次：
| 层次 | 典型内容 | 作用 |
|---|---|---|
| 引导层 | BootROM、SPL、U-Boot、TF-A | 初始化 DDR、时钟、串口，加载内核 |
| 内核层 | 设备树、驱动、内核配置 | 让内核识别并管理板级硬件 |
| 根文件系统层 | BusyBox、systemd、库、固件 | 提供用户空间运行环境 |
| 板级配置层 | 环境变量、分区表、升级脚本 | 保证量产一致性与可维护性 |
其中，设备树是现代 Linux BSP 的核心。它把“板子上有什么、接在哪、怎么接”从内核代码中剥离出来，用数据描述硬件。同一颗 SoC 可以支持成百上千种板子，靠的就是不同的设备树。
三、整体框架：一条从硬件到应用的适配链路
下面这张图展示了 Linux BSP 板级适配的整体框架。它从最底层的硬件出发，经过引导、内核、根文件系统，最终到达应用层。每一层都有明确的输入、输出和调试手段。
这条链路的关键在于：每一层都依赖下一层正确工作。如果 DDR 没初始化好，内核根本加载不了；如果设备树里 I2C 控制器没使能，接在它上面的传感器就不会被探测到。因此，BSP 调试必须自下而上、逐层验证。
四、典型应用场景：BSP 工程师每天都在做什么
BSP 适配不是实验室里的孤立工作，它贯穿产品从立项到量产的整个生命周期。以下是几个典型场景：
- 新板点亮：拿到新 PCB，先让串口输出 U-Boot 日志，再让内核启动到 shell，最后逐个验证外设。
- 外设适配：为一块新的触摸屏编写设备树节点，配置 I2C 地址、中断引脚、复位 GPIO 和供电 regulator。
- 内核裁剪：去掉不需要的驱动和子系统，把内核镜像从 20MB 压到 6MB，加快启动速度。
- 量产升级：设计 A/B 分区、OTA 升级流程和回滚机制，保证现场设备可远程维护。
- 问题定位：客户反馈“网口偶尔不通”，需要从 PHY 供电、时钟、复位时序、设备树配置到驱动日志逐项排查。
五、常见误区与复盘
初学者在 BSP 适配中容易陷入几个误区，提前了解可以少走很多弯路：
- 把设备树当成“配置文件”随便改：设备树有严格的绑定文档（Documentation/devicetree/bindings），属性名和取值必须符合规范，否则驱动不会 probe。
- 忽略引脚复用和时钟：很多“驱动加载失败”其实是 pinctrl 没配对、时钟没使能、regulator 没打开。
- 只改内核不看 U-Boot：DDR 参数、启动介质、环境变量都在 U-Boot 阶段，内核启动失败往往要回到引导层找原因。
- 没有版本管理：设备树、内核配置、U-Boot 补丁必须纳入 Git 管理，否则量产时无法复现。
# 一个典型的板级适配验证顺序
1. 串口输出 U-Boot 版本与 DDR 容量
2. 内核启动日志中确认 machine model 与 compatible
3. 检查 /proc/device-tree 下节点是否存在
4. 用 dmesg | grep -i "i2c\|spi\|mmc\|eth" 查看驱动 probe 情况
5. 用 ls /sys/class/ 确认设备类是否注册
6. 用示波器/万用表验证供电、时钟、复位信号掌握这套方法后，你会发现 BSP 适配并不是“玄学”，而是一条有明确层次、明确工具、明确验证手段的工程链路。接下来的章节将沿着这条链路，从硬件信息提取开始，逐步深入到设备树、驱动、启动优化和量产交付。