coreboot 实战:StarFighter Mk I(Star Labs)Meteor Lake 笔记本的构建与烧录全流程

原创2026-10-14 11:35:251,845 阅读
文章标签:固件嵌入式驱动开发系统底层与硬件

coreboot 实战:StarFighter Mk I(Star Labs)Meteor Lake 笔记本的构建与烧录全流程

本文围绕 coreboot 仓库中 Star Labs StarFighter Mk I(Meteor Lake 平台,代号 starlabs_starfighter_mtl)的官方主板文档展开,完整继承原文档的硬件规格、构建前置条件与烧录参数,并结合 src/mainboard/starlabs/starfighter 目录下的真实板级源码,讲解 SPD 内存参数索引、VBT 双版本选择、Flash 布局与 ACPI/USB 拓扑等实现细节。读完本文,你将能够独立完成该机型 coreboot 固件的构建,理解其配置项与板级代码的对应关系,并掌握通过 fwupd 安全刷写固件的完整前置要求。

硬件规格总览

StarFighter Mk I 是 Star Labs 面向高性能创作场景的笔记本平台,其固件支持要点在原文档 starfighter_mtl.md 中列得相当完整:

  • CPU:Intel Core Ultra 125H(Meteor Lake)或 Intel 285H(Arrow Lake),完整处理器参数可在 Intel ARK 中查询;
  • EC(嵌入式控制器):ITE IT5570E,负责背光键盘(标准 PS/2 键码 + SCI 热键)、电池管理、USB-C PD 充电、挂起/恢复;
  • GPU:Intel Iris Xe 核显。文档明确建议启用 GOP driver,并提供 VBT 文件;显示输出包括 16 英寸 eDP 屏幕(3840×2400 或 2560×1600)、HDMI 视频、USB-C DisplayPort 视频;
  • 内存:32 GB 或 64 GB 板载 LPDDR5(不可更换);
  • 网络:AX210 2230 规格 WiFi/蓝牙模块;
  • 音频:Realtek ALC235,内置扬声器、可拆卸麦克风、3.5 mm 耳麦复合接口,以及 HDMI 与 USB-C DisplayPort 音频通路;
  • 存储:2 × M.2 PCIe SSD + RTS5129 MicroSD 读卡器;
  • USB/接口:1920×1080 可拆卸 CCD 摄像头、2 × Thunderbolt 4(左侧)、左/右各 USB 3.1 Gen 2 Type-A、右侧 USB 3.1 Gen 1 Type-A。

在板级代码层面,src/mainboard/starlabs/starfighter/board_info.txt 记录了该机的固件身份标识:

Vendor name: Star Labs
Board name: StarFighter
Category: laptop
ROM protocol: SPI
ROM socketed: n
Flashrom support: y

这些信息会进入 SMBIOS/硬件识别,也与后文“Flash 芯片不可插拔(socketed: no)”的描述相互印证。

构建 coreboot:前置文件与构建命令

构建前置条件(blobs 文件)

构建 StarFighter 的 coreboot 之前,必须准备以下二进制文件(原文档 Preliminaries 部分):

文件 说明 必需性
descriptor.bin Intel Flash Descriptor(SPI 区域划分、STRP/Region Access 等策略) 必需
me.bin Intel Management Engine 固件 必需
ec.bin ITE 嵌入式控制器固件 必需
Logo.bmp Windows 3.1 BMP 格式开机画面 可选

这些文件位于 Star Labs 自有的 StarLabsLtd/blobs 仓库(GitHub),构建时它替代标准的 3rdparty/blobs 仓库。这与 Star Labs 全系主板的通用构建文档 building.md 一致——通用文档同样要求 descriptor.bin、me.bin、ec.bin 三个必需文件,并统一使用 StarLabsLtd/blobs 作为 blobs 来源。

注意:descriptor.bin 不是可缺省的占位文件。StarFighter 系列的 Kconfig 强制选择了 VALIDATE_INTEL_DESCRIPTOR,即构建/运行时会对 Flash Descriptor 做校验,Descriptor 内容必须与硬件实际引脚配置匹配。

构建命令

原文档给出的可构建镜像的命令序列如下(使用 config.starlabs_starfighter_mtl 作为 defconfig):

make distclean
make defconfig KBUILD_DEFCONFIG=configs/config.starlabs_starfighter_mtl
make

对应关系说明:

  • config.starlabs_starfighter_mtl 对应 Kconfig 符号 BOARD_STARLABS_STARFIGHTER_MTL,其定义位于 Kconfig;
  • 该符号选择 BOARD_STARLABS_STARFIGHTER_SERIES(系列公共项)以及 SOC_INTEL_METEORLAKE / SOC_INTEL_METEORLAKE_U_H,即 Meteor Lake U/H 系列 SoC;
  • 同目录下的 starlabs_starfighter_rpl 变体(Arrow Lake)对应 BOARD_STARLABS_STARFIGHTER_RPL,二者共享系列公共 Kconfig、板级目录不同 variant 子目录(mtl 与 rpl)。

需要说明的一点:当前 coreboot 上游主线的 configs/ 目录中并未包含 config.starlabs_starfighter_mtl 的现成配置文件(上游 configs 多为各厂商提交到上游的示例配置),该配置由 Star Labs 在其分发流程中维护并随 StarLabsLtd/blobs 体系使用。若在当前仓库直接执行 make defconfig 找不到该文件,可通过 make menuconfig 手工选择 Star Labs 厂商下的 StarFighter(MTL 变体)得到等效配置。

关键 Kconfig 选项解读

从 Kconfig 的 BOARD_STARLABS_STARFIGHTER_SERIES 选项块可以看到 StarFighter 系列的固件特性清单,逐条对应原文档的硬件描述:

config BOARD_STARLABS_STARFIGHTER_SERIES
	def_bool n
	select BOARD_ROMSIZE_KB_32768          # 32 MiB SPI Flash
	select CSE_DEFAULT_CFR_OPTION_STATE_DISABLED
	select DRIVERS_EFI_VARIABLE_STORE       # EFI 变量存储
	select DRIVERS_OPTION_CFR_ENABLED
	select DRIVERS_GFX_GENERIC              # 通用 GPU 驱动(承载 GOP/VBT 初始化)
	select DRIVERS_INTEL_PMC                # Intel 平台管理器(电源/热)
	select DRIVERS_INTEL_USB4_RETIMER       # TB4 信号重定时器
	select DRIVERS_I2C_HID                  # EC/触摸板 I2C HID 通信
	select EC_STARLABS_FAN
	select EC_STARLABS_MERLIN               # ITE EC(Merlin)通信框架
	select HAVE_ACPI_RESUME
	select HAVE_ACPI_TABLES
	select HAVE_HDA_DMIC                    # 板载数字麦克风(ALC235)
	select HAVE_SPD_IN_CBFS                 # SPD 数据打包进 CBFS
	select INTEL_GMA_HAVE_VBT               # 内置 VBT
	select INTEL_LPSS_UART_FOR_CONSOLE
	select MAINBOARD_HAS_TPM2
	select MEMORY_MAPPED_TPM
	select NO_UART_ON_SUPERIO
	select PMC_IPC_ACPI_INTERFACE
	select SOC_INTEL_COMMON_BLOCK_HDA_VERB
	select SOC_INTEL_COMMON_BLOCK_TCSS
	select SOC_INTEL_ENABLE_USB4_PCIE_RESOURCES
	select SPD_READ_BY_WORD
	select SPI_FLASH_WINBOND                 # Winbond W25Q256
	select SYSTEM_TYPE_LAPTOP
	select TPM_MEASURED_BOOT
	select VALIDATE_INTEL_DESCRIPTOR
	select STARLABS_NVME_POWER_SEQUENCE

其中几个与原文档直接对应的点值得注意:

  • BOARD_ROMSIZE_KB_32768:镜像尺寸上限 32 MiB,正好等于后文 Flash 芯片容量(Winbond W25Q256,32 MiB);
  • SPI_FLASH_WINBOND:与原文档 flashing 表格中 Vendor = Winbond 一致;
  • HAVE_SPD_IN_CBFS + INTEL_GMA_HAVE_VBT:分别对应“SPD 文件随固件内置”与“提供 VBT”两条硬件说明;
  • MAINBOARD_PART_NUMBER 的默认值在 MTL 变体下为 "StarFighter Mk II"、RPL 变体下为 "StarFighter Mk I"——即硬件家族名沿用 Mk I/Mk II 的命名体系,MTL 板对应的 Kconfig 主目录仍为 starlabs/starfighter。

此外 MB_STARLABS_PL4_WATTS 默认 80 W(PL4 功耗策略)、CCD_PORT 默认 4(摄像头所在 USB2 端口号,在 devicetree 中以 CONFIG_CCD_PORT 形式被引用)、TPM_PIRQ 在 MTL 下默认 0x3d,这些都是该板特有的板级默认值,可在 defconfig 基础上按需调整。

板级实现细节:从源码看 MTL 变体的关键逻辑

SPD:按内存配置 strap 选择 CBFS 中的 SPD 索引

原文档指出该机为 32 GB 或 64 GB 板载 LPDDR5。由于内存不可更换,coreboot 并不在运行时读取 SPD 总线,而是把不同容量/速率组合的 SPD 数据文件打包进 CBFS,按硬件 strap 选择。这一机制在源码中有完整体现:

board_id.c 中的 get_memory_config_straps() 读取 4 个 ID GPIO(GPP_B05~GPP_B08)判定内存容量:

/*
 * |      | ID3 | ID2 | ID1 | ID0 |
 * | 32GB |  1  |  0  |  0  |  0  |   -> 13
 * | 64GB |  1  |  1  |  0  |  1  |   -> 13 + 4 + 1 = 18? 见下方注释
 */
gpio_t spd_id[] = { GPP_B05, GPP_B06, GPP_B07, GPP_B08 };
return (uint8_t)gpio_base2_value(spd_id, ARRAY_SIZE(spd_id));

romstage.c 再把 strap 值与用户可选的内存速率档位(5500/6400/7500)合成 CBFS 索引:

static uint8_t strap_to_memcfg_index(uint8_t strap)
{
	switch (strap) {
	case 13: /* 32GB */
		return 0;
	default: /* 64GB */
		return 1;
	}
}

static uint8_t memcfg_and_speed_to_cbfs_index(uint8_t memcfg, unsigned int speed)
{
	if (speed > 2)
		speed = 2;
	return (uint8_t)(memcfg * 3 + speed);
}

即索引 = 容量档位(0/1) × 3 + 速率档位(0~2),与 spd/Makefile.mk 中的打包顺序严格对应(MTL 平台依次打包 32gb-mtl-5500/6400/7500、64gb-mtl-5500/6400/7500,共 6 个 .spd.json)。fsp_memory_mainboard_version() 最终把这个索引交给 FSP 的 M_UPD,完成内存初始化参数选择。这就是为什么 spd/ 目录中存在按容量与速率命名的成套 JSON 文件——每一个都对应一种 strap+速率组合。

VBT:两套 VBT 按屏幕分辨率选择

原文档提到“GOP driver 推荐、提供 VBT”,且屏幕存在 3840×2400 与 2560×1600 两种规格。板级代码用同一套 strap 位区分这两种屏幕,并在 ramstage.c 中动态选择 VBT 文件名:

const char *mainboard_vbt_filename(void)
{
	if (get_memory_config_straps() == 13)
		return "vbt_qhd.bin";
	return "vbt.bin";
}

对应的 variants/mtl/Makefile.mk 将第二套 VBT 以别名写入 CBFS:

$(call add_vbt_to_cbfs, vbt_qhd.bin, data_qhd.vbt)

即 CBFS 中同时存在 vbt.bin(高分辨率面板)与 vbt_qhd.bin(QHD 面板),ramstage 根据硬件实际面板选择加载。data.vbt 与 data_qhd.vbt 两个源文件均位于 variants/mtl/ 目录。

设备树:iGPU 输出、WiFi 与双 SSD 拓扑

MTL 变体的 devicetree.cb 把硬件规格逐条落实为设备树节点,可直接对照原文档 Specs 阅读:

  • iGPU:挂载 drivers/gfx/generic,声明 6 个显示设备:LCD0(eDP 面板)、DD01(HDMI)、DD02/DD03(两路 Type-C DisplayPort,并绑定 ACPI 物理位置属性 ACPI_PLD_TYPE_C(LEFT, CENTER, ...)),与文档中“eDP + HDMI + USB-C DP”三路输出一致;
  • WiFi:挂在 pcie_rp9,SMBIOS 槽位描述为 M.2/M 2230、Gen3×1,并挂载 rtd3 芯片实现运行时 D3 电源管理(enable/reset GPIO 分别为 GPP_B19 / GPP_H02);
  • SSD:pcie_rp10 声明为 M.2/M 2280 的 x4 插槽(另一颗 SSD 由 CPU 直连通道承载),同样启用 rtd3;
  • USB 拓扑:xhci 节点逐端口声明了后部/前置 USB Type-C、左/右 Type-A、读卡器、内置摄像头(usb2_ports[CONFIG_CCD_PORT])与内置蓝牙,每个端口都绑定了物理位置描述(PLD),与文档中“左 2×TB4 + 3×Type-A + 摄像头”的接口布局逐一对应;
  • TB4:tbt_pcie_rp0/1 两个 Thunderbolt 端口节点开启,tcss_dma0 下挂载 drivers/intel/usb4/retimer 重定时器(对应 Kconfig 的 DRIVERS_INTEL_USB4_RETIMER)。

Flash 布局(board.fmd)

MTL 变体的 Flash 分区定义在 board.fmd:

FLASH	0x2000000 {
	SI_ALL	0x1000000 {
		SI_DESC			0x4000
		SI_ME			0xbb1000
	}
	SI_BIOS 0x1000000 {
		EC@0x0			0x20000
		RW_MRC_CACHE@0x20000	0x10000
		SMMSTORE@0x30000	0x80000
		CONSOLE@0xB0000		0x20000
		FMAP@0xD0000		0x1000
		COREBOOT(CBFS)
	}
}

整片 32 MiB(0x2000000)Flash 被划分为两个约 16 MiB 的镜像区:SI_ALL 区含 descriptor.bin(4 KiB,SI_DESC)与 me.bin(约 11.9 MiB,SI_ME);SI_BIOS 区则依次放置 EC 固件(128 KiB,ec.bin)、MRC 内存缓存、SMMSTORE、console 数据、FMAP 表,剩余空间全部交给 coreboot CBFS。这一布局解释了原文档为什么要求三个 blobs 文件——descriptor.bin、me.bin、ec.bin 恰好一一对应 Flash 中 SI_DESC、SI_ME、EC 三个固定区域。

Flashing:通过 fwupd 刷写 coreboot

原文档给出的 Flash 芯片参数表如下(与 board_info.txt 的 Flashrom support: y、Kconfig 的 SPI_FLASH_WINBOND 相互印证):

属性 值
Socketed flash(可插拔) no
Vendor Winbond
Model W25Q256.V
Size 32 MiB
Package SOIC-8
Internal flashing(内部刷写) yes
External flashing(外部刷写) yes

Star Labs 推荐的刷写方式是 fwupd(LVFS 固件更新通道),完整要求与步骤见 common/flashing.md:

  1. fwupd 版本:≥ 1.5.6。用 fwupdmgr --version 检查;在 Ubuntu 20.04/20.10、Linux Mint 20.1、elementaryOS 6 上可通过 Star Labs 的 PPA 安装:

    sudo add-apt-repository ppa:starlabs/ppa
    sudo apt update
    sudo apt install fwupd
    

    Manjaro 用户:sudo pacman -Sy fwupd-git flashrom-starlabs。

  2. 电池与电源:电量 ≥ 30%,且必须连接充电器(USB-C 或 DC 口)。刷写过程中断电会导致变砖风险,这是硬性要求。

  3. 关闭 BIOS Lock:从原厂 AMI 固件切换到 coreboot 前,必须在 BIOS 设置中关闭 BIOS Lock。操作路径为:关机 → 开机时按住 F2 进入 BIOS → Advanced 选项卡找到 BIOS Lock → 设为 Disabled → F10 保存退出。

BIOS 设置界面中 Advanced 选项卡下的 BIOS Lock 项,用于在刷写 coreboot 前将其禁用

  1. 分支切换(switch branch):

    fwupdmgr refresh --force
    fwupdmgr switch-branch
    

    刷新 LVFS 固件清单后,switch-branch 会列出可用分支(AMI 原厂 / coreboot),输入对应编号并确认。切换完成后需要重启,且下次重启最长可耗时约 5 分钟,期间切勿断电或断开充电器。之后即持续接收所选分支的固件更新;分支可随时来回切换。

fwupdmgr 输出的 fwupd 版本号检查结果

小结与延伸阅读

本文以 starfighter_mtl.md 为骨架,覆盖了三块核心内容:

  1. 硬件规格:Meteor Lake/Arrow Lake 平台、ITE EC、双 VBT 面板、LPDDR5 板载内存、双 M.2 SSD 与 TB4 接口布局;
  2. 构建:blobs 三件套(descriptor/me/ec)+ 可选 Logo.bmp、KBUILD_DEFCONFIG 三行构建命令,以及 Kconfig 中各 select 项与硬件的对应关系;
  3. 刷写:Winbond W25Q256(32 MiB,SOIC-8)的 fwupd 刷写全流程,包括版本要求、BIOS Lock 关闭与分支切换注意事项。

进一步深入可阅读:

适用前提说明:本文所有命令与配置均以当前 coreboot 仓库源码为准;config.starlabs_starfighter_mtl 配置文件由 Star Labs 分发体系维护,上游主线 configs/ 目录当前未收录该文件,使用 make menuconfig 手工选择等效选项即可;刷机操作务必在连接电源、电量达标且已关闭 BIOS Lock 的前提下进行。

登录后查看全文
coreboot