引导启动与 BSP 工程陷阱与实战避坑指南
1. 引导交接与固件核心工程陷阱
陷阱 1：阶段交接时继承未知的硬件外设状态
- 现象：Linux 内核启动初期在开启中断（
local_irq_enable）瞬间直接崩溃，或在网卡驱动加载前网卡物理内存被异常修改。
- 根因：U-Boot 在执行 TFTP 网络下载或 USB 引导后，未显式关闭外设控制器的 DMA 引擎与中断。外设继续在后台执行 DMA 传输，向已经被内核分配的数据结构中写入网络包。
- 规范规避：在跳转下一阶段前，Bootloader 必须显式调用全局外设静默函数（
eth_halt(), usb_stop()），重置所有物理总线 Master 使能位。
陷阱 2：安全启动信任链断层（Broken Chain of Trust）
- 现象：BootROM 对 SPL 进行了强签名的密码学校验，但 SPL 在从外部存储加载 U-Boot 或 Kernel 时跳过了验签逻辑。
- 根因：开发团队为调试方便，在 SPL 中短路了验签分支，导致攻击者只需篡改 eMMC 中的 U-Boot 即可取得全盘控制权。
- 规范规避：每一级固件必须严格遵循“先验签、后解密、最后跳转”的原则，并将防回滚计数器（Anti-Rollback Counter）与硬件 eFuse 绑定。
2. DDR 内存与设备树工程陷阱
陷阱 1：SPL 内存测试通过但 Linux 内核仍随机崩溃
- 现象：SPL 在板级初始化时运行简单的内存测试全部 PASS，但 Linux 启动到多任务并发阶段频繁触发随机 Kernel Oops。
- 根因：SPL 仅在常温、低频或单核环境下运行了简单的走步 1/0 模式测试，未覆盖多核高并发、高速 DDR 读写切换（Read-to-Write Turnaround）以及高温下的眼图边缘（Margin）。
- 规范规避：在产线与实验室环境集成基于 Memtester 的高强度压力测试套件，全面覆盖全通道（All Channels）、不同 Burst 长度及温变循环。
陷阱 2：DTS 语法通过编译但时钟/中断绑定失效
- 现象：DTC 编译顺利生成 DTB，但驱动在
probe() 时报告 -EINVAL 或无法响应外部事件。
- 根因：DTC 编译器仅进行语法检查，无法感知引用的时钟 ID（
clocks = <&ccu 12>）或 GIC 中断号（interrupts = <GIC_SPI 48 ...>）是否在物理上存在。
- 规范规避：在代码提交流水线中集成
dt-schema 校验工具（基于 make dtbs_check），严格比对 YAML Binding 规范与硬件 Address Map。
3. 根文件系统与 A/B 升级工程陷阱
陷阱 1：Waiting for root device 存储驱动加载时延超标
- 现象：内核在挂载根文件系统时挂死，日志卡在
Waiting for root device /dev/mmcblk0p2...。
- 根因：eMMC / NVMe 主机控制器与 PHY 的异步探测耗时超过了内核等待阈值，或者根分区设备名使用了不稳定的人类可读设备号。
- 规范规避：在
bootargs 中使用唯一的 PARTUUID= 代替传统的 /dev/mmcblk0p2，并增加 rootdelay=3 或 rootwait 内核参数。
陷阱 2：A/B 分区切换中的元数据写穿断电
- 现象：OTA 升级写入新固件后设备重启，元数据损坏导致两套分区均无法被 Bootloader 识别。
- 规范规避：元数据存储扇区必须配置双份冗余备份与 CRC32 校验，且写入时严格执行扇区擦除前置与持久化刷写。