coreboot 4.12 版本深度解读:x86 强制化的三大启动特性与单元测试基础设施
coreboot 4.12 版本深度解读:x86 强制化的三大启动特性与单元测试基础设施
coreboot 4.12 于 2020 年 5 月 12 日发布,是 x86 启动流程定型的关键版本:可重定位 ramstage、Postcar 阶段与 C 环境 bootblock 三项机制在本版本起成为 x86 平台的强制要求,同时首次提供了结构化的单元测试构建子系统与 SMMSTORE 生产级驱动。读完本文,你将理解这次版本在启动架构上做出的取舍(以及为何 FSP1.0 平台因此被移入独立分支)、如何在当前代码树中验证这些机制的落地位置,以及如何复现当年引入的单元测试基础设施。
版本概览
- 发布日:2020 年 5 月 12 日;
- 自 4.11 以来共新增 2692 次提交,来自 190 余位开发者,其中 59 人为首次贡献者,增长幅度相当显著;
- 本版本对 MAINTAINERS 文件有不少活动,更多个人、团队与公司公开声明将负责维护特定主板与子系统;
- 代码树内的文档建设也在加速,本版本约有 70 个提交落在文档领域,涵盖从拼写修正到主板支持说明、coreboot API 文档等各类内容。
硬件支持:删除多于新增的罕见版本
由于此前宣布的弃用项被实际移除,以及大量主板被去重为 board variant(板卡变体),本版本的顶层统计略显“反常”:这是一个删除主板数量(51 块)多于新增(49 块)的罕见 coreboot 版本。
但把 variant 归并的因素计入后,4.12 支持的硬件数量仍高于上一版本。亮点包括:
- 一如既往的批量 Chrome OS 设备支持;
- 大量针对“原装非 coreboot 厂商固件”设备的 retrofit(改装移植);
- 出厂即搭载 coreboot 的设备支持,发布说明特别点名了 System76、Protectli、Libretrend 与 Open Compute Project。
在 src/mainboard 目录下可以看到这些 ODM 厂商对应的板卡目录(如 system76、protectli、libretrend、ocp),印证了“coreboot 从工厂直出”这一生态方向在 4.12 时代的落地。
代码清理:SPDX 标识符与文件头瘦身
本版本简化了每个文件顶部的版权头:不再引用冗长的许可证名称甚至许可证全文,而是改用简洁的 SPDX 许可证标识符;由于各人对 copyright 行的写法不一,作者信息被统一收集进 AUTHORS,完整的作者历史则交由 git 记录承载;没有实际内容的“This file is part of this-and-that project”样板行也一并移除。
此外还有两项与 4.12 主题呼应的清理工作:
- 对全树的
#include头文件做了梳理,目标是减少每个编译单元受影响的代码范围(这一工作直接服务于后文提到的 C 环境 bootblock——头文件越少,bootblock 可编译的 C 代码越灵活); - 随着 board-variant 机制成熟,许多原先各自独立的单板型号被转换为同一主板的 variant,便于维护“一个家族、多块板子”的设备群。
当前代码树中大量文件顶部的 /* SPDX-License-Identifier: GPL-2.0-only */ 单行头(例如 src/arch/x86/postcar.c 首行)即是这次清理的直接产物。
强制化的三大 x86 特性(Deprecations)
4.12 的核心变化是:x86 平台上的三项特性从“可选”变为“强制”——可重定位 ramstage(relocatable ramstage)、Postcar 阶段与 C_ENVIRONMENT_BOOTBLOCK。未实现的平台因此被移出 master 分支。
可重定位 ramstage
可重定位阶段是 x86 独有的能力:阶段(stage)可在运行时被重定位到新的执行位置。对 ramstage 强制重定位的理由是:你总是希望 cbmem 被缓存使用,那么 cbmem 所在内存区域就同时是运行 ramstage 的好位置。它的好处是:
- 完全不再占用低地址内存,把这部分内存留给 OS 使用;
- S3 挂起恢复时不再需要对 ramstage 做备份/恢复操作。
Postcar 阶段:CAR 拆除有了独立的程序边界
Postcar 阶段把“拆除 Cache-as-Ram(CAR)”这件事从 romstage 中剥离出来,放进一个独立的、从 RAM 加载执行的阶段。由此带来两个架构层面的收益:
- romstage 拥有了干净的程序边界,其中所有变量都可以直接通过链接地址访问,无需运行时地址解析;
- 不再需要
CAR_GLOBAL宏来链接全局/静态变量,也不再需要car_set_var/car_get_var/car_get_ptr这类访问函数。
这一机制在当前代码树中可以直接验证:
- src/arch/x86/Kconfig 中的
POSTCAR_STAGE选项已是def_bool y(依赖ARCH_X86且不依赖RESET_VECTOR_IN_RAM的反例情况),即默认强制启用——这正是 4.12 之后“成为强制项”的源码体现; - src/arch/x86/postcar.c 中 postcar 阶段的
main()先调用late_car_teardown()(弱符号,允许无原生 CAR 拆除路径的 SoC 提供替代实现),再恢复 console、cbmem 基础设施,随后加载 ramstage——与发布说明描述的“独立阶段负责拆 CAR”完全一致; - 同目录下的 postcar_loader.c 与 exit_car.S 分别承担 romstage 侧加载 postcar 程序、以及退出 CAR 时刷新/关闭缓存的汇编工作,三者共同构成完整的 CAR 拆除链路。
C_ENVIRONMENT_BOOTBLOCK:告别 romcc 的 20K+ 行汇编编译器
历史上 x86 bootblock 由 romcc 编译。这意味着生成代码只能使用 CPU 寄存器、没有栈,而这个 20K+ 行代码量的编译器本身有限、难以维护,在它环境下编写代码同样痛苦。
C_ENVIRONMENT_BOOTBLOCK 给出的替代方案是:在 bootblock 中就完成 Cache-as-Ram 的建立,让 bootblock 运行 GCC 编译出来的 C 代码。收益包括:
- 更强的灵活性与跨架构、跨阶段的一致性(其它架构与后续阶段本来就用 C);
- bootblock 中可以打印控制台输出;
- VBOOT 可以运行在 romstage 之前,使得 romstage 能通过 RW FMAP 区域实现可更新(read-write flash map)。
从当前仓库结构看,这次强制化是彻底完成的过渡:rg 搜索全树已找不到 C_ENVIRONMENT_BOOTBLOCK 或 romcc 的任何痕迹,src/arch/x86 下的 bootblock 构建(bootblock_normal.c、bootblock.ld)全部按 C/C++ 编译路径组织——即当年的过渡选项已被吸收,bootblock 恒定运行 C 代码成为既成事实。
被移出 master 的平台
未实现上述特性的以下平台在 4.12 中被移出 master,以便主分支继续演进:
- AMDFAM10;
- 全部 FSP1.0 平台:
BROADWELL_DE、FSP_BAYTRAIL、RANGELEY; - VIA
VX900。
当前仓库中可以确认这些目录均已不存在:src/soc/intel/fsp1.0、src/northbridge/amdfam10、src/southbridge/via/vx900 均查无此路径。
其中 FSP1.0 的情况特别值得玩味:它根本无法实现 Postcar 阶段。原因是 FSP1.0 在返回 coreboot 之前,会把 CAR 区域迁移到 HOB(Hand-Off Block)里;FSP 返回后,romstage 变量已无法通过其原始地址访问。一种能拿到同样行为的做法是重新建立一套(开源实现的)Cache-as-Ram,再从 HOB 把迁移后的数据拷贝过去——但方案被判定为过于 hacky。发布说明从中提炼出一条经验:blob 不应干预执行环境,否则与固件的正常集成会困难得多。
4.11_branch 的由来
由于部分 FSP1.0 支持的平台仍在量产且流行,4.11 发布被保留为独立分支,后续开发在该分支上继续。这也说明 coreboot 的分支策略:master 可以为了架构演进抛弃旧平台,而旧平台用户并非无路可走。
SMMSTORE 正式走向生产
4.12 宣布基于 x86 SMM 的存储驱动 SMMSTORE 达到生产可用状态。其 API 文档见 SMM 闪存存储驱动文档;发布说明同时提醒,API 此后会有一次大幅改进的不兼容更新。
结合当前仓库,可以看到这条演进路径的落点:
- 驱动实现位于 src/drivers/smmstore,包含
ramstage.c(ring0 侧接口)、smi.c(SMM 侧处理)、store.c(存储逻辑)等文件; - 当前文档描述的是“former SMMSTORE version 2 API”(即
smmstorev2兼容协议),v1 的 key/value 协议已被移除,coreboot 表结构体名为struct lb_smmstorev2(coreboot 表 tag0x0039)——正是发布说明所预告的“改进但不兼容”的 API 更新; - 该协议通过 FADT 中
smi_cmd端口触发 SMI(%al = 0xed,%ah传命令,%ebx传参数缓冲区指针),所有数据交换走 CBMEM/HOB 中的通信缓冲区,并校验载荷指针不与 SMM 内存重叠,防止恶意 ring0 代码触碰任意内存。
单元测试基础设施落地
4.12 引入了结构化的 coreboot 单元测试能力:新增构建子系统,并采纳 Cmocka 测试框架;代码树新增 tests 目录,包含基础设施与单元测试示例。设计文档见 Unit testing coreboot,其中对候选框架(SputUnit、GoogleTest、Cmocka、Unity)的评估结论是:Cmocka 为纯 C、自包含、支持 mock 与 XML 输出(可供 Jenkins 消费)、被 libssh/OpenVPN/Samba 等项目使用,最契合需求。
当前仓库中的 tests/ 目录正是当年设计文档所规划的结构的延续:按 src/ 的镜像组织(tests/lib、tests/device、tests/commonlib、tests/console 等),并配有 mock/(mock 实现)、stubs/(桩函数)与 helpers/。构建入口 tests/Makefile.mk 中还保留了几个当时就设计好的开关:
USE_SYSTEM_CMOCKA ?= 1:默认使用系统包安装的 Cmocka,否则回退到从 3rdparty 源码构建——对应设计文档中“先试验发行版包、不行再切 submodule”的决策;COV=1:为覆盖率构建追加--coverage,并把输出放入独立的coverage目录,避免与常规测试构建混用;GDB_DEBUG:为测试二进制开启-g -Og以便调试。
设计文档同时明确了单元测试的定位与边界:它不是集成测试的替代,单元测试跑在构建机上、追求快而频繁地执行;对 coreboot 而言,公共库(lib/、commonlib/、payloads/libpayload)与基础设施(console/、device/、security/)是最受益的部分。测试默认使用一份统一的 qemu_x86_i440fx 配置,个别测试需要不同配置值时,可在 config.h 之后包含额外头文件做 #undef/#define 覆盖。
结语:发布说明本身也是协作产物
4.12 发布说明的收尾同样值得记录:如果你最期待的新特性或新支持的主板没有出现在发布说明里,不要犹豫——coreboot 的发布说明是协作维护的,落地值得注意的东西时,顺手为 Documentation/releases 中下一个版本的文档贡献一段。这种“发布说明即文档”的做法,配合 MAINTAINERS 维护机制与单元测试基础设施,共同构成了 coreboot 在 4.12 时代“架构收敛 + 工程化提速”的整体面貌。