coreboot 移植 Supermicro X11SSW-F 服务器主板全解析：BMC 刷写、功能验证与源码级配置详解

固件嵌入式操作系统驱动开发【免费下载链接】corebootRead-only mirror of https://review.coreboot.org/coreboot.git. Synced every hour. We dont handle Pull Requests.项目地址https://gitcode.com/gh_mirrors/co/coreboot点击查看免费下载本篇技术指南围绕 coreboot 对 Supermicro X11SSW-FIntel Kaby Lake C236 芯片组的微型服务器主板的官方支持展开涵盖通过 BMC 网页界面刷写固件的完整流程、已验证/未验证/已知问题的功能清单以及从 主板移植源码 出发的硬件初始化、设备树配置与 IPMI 驱动集成细节。读完本文你将掌握该主板在 coreboot 下的实际可用状态、潜在风险如 S3 休眠不可用并能依据源码逐项核对 FSP 内存参数、USB/SATA 端口映射、PCIe 槽位定义等关键配置。主板与移植概况X11SSW-F 是 Supermicro X11 LGA1151 系列中的一员该系列各型号主板在内部结构与外部接口上高度相似差异主要体现在 PCIe 槽位、网卡1 GbE / 10 GbE、IPMI 与 RAID 控制器等方面见 系列文档。coreboot 将四款型号X11SSH-F/LN4F、X11SSH-TF、X11SSM-F、X11SSW-F合并为同一个基板工程src/mainboard/supermicro/x11-lga1151-series/通过 Kconfig 与overridetree.cb区分各型号差异。在 Kconfig 中BOARD_SUPERMICRO_X11SSW_F选中基板配置后会依次启用以下关键特性SOC_INTEL_KABYLAKE与SKYLAKE_SOC_PCH_HKaby Lake CPU 与 C236 PCHMEMORY_MAPPED_TPMTPM 通过内存映射方式访问DRIVERS_ASPEED_AST2050与SUPERIO_ASPEED_AST2400ASPEED 图形/管理控制器与 Super I/O 驱动IPMI_KCS板载 BMC 的 KCS 接口驱动MAINBOARD_NO_FSP_GOP不使用 FSP 的图形输出协议显示交由 Aspeed 方案SUPERIO_ASPEED_HAS_UART_DELAY_WORKAROUND、DRIVERS_UART_8250IO、SOC_INTEL_COMMON_BLOCK_LPC_COMB_ENABLE串口与 LPC COM 端口相关支持HAVE_ACPI_TABLES、HAVE_OPTION_TABLE、HAVE_CMOS_DEFAULTACPI 表、选项表与 CMOS 默认值。同时SUPERMICRO_BOARDID为 X11SSW-F 分配了板号089BMAINBOARD_PART_NUMBER为X11SSW-F。BOARD_ROMSIZE_KB_16384表明整块 SPI 闪存为 16 MiBCBFS_SIZE默认0xb0000011 MiB。核心技术规格项目规格CPUIntel Kaby Lake如 Xeon E3-1200 v6 / 第 7 代 Core 系列PCHIntel C236协处理器Intel SPSME 的服务器版本server version of the MESuper I/OASPEED AST2400同时承载 BMC/IPMI 与 VGA 输出以太网2x Intel I210-AT 1 GbE外加 1x 专用 BMC 管理口PCIe 槽位1x PCIe 3.0 x16Left Riser、1x PCIe 3.0 x4Right Riser 插于 x16 槽位、1x PCIe 3.0 x4NVMeUSB2x USB 2.0外部、2x USB 3.0外部、1x USB 3.0内部、1x 双口 USB 3.0 header、2x 双口 USB 2.0 headerSATA6x S-ATA III其他接口1x RS232外部、1x RS232 header、1x TPM header、1x Power SMB header、6x PWM 风扇接口、1x 机箱入侵检测 header以上数据来源于 X11SSW-F 官方文档 中的技术规格表。注意主板信息文件 board_info.txt 还注明该板 ROM 协议为 SPI、ROM 为不可插拔socketed: n且 flashrom 支持标记为 y。刷写 coreboot通过 BMC 网页界面官方文档记录的刷写方式是通过BMC 网页界面IPMI Web 界面完成的前提是输入了有效的许可license——Supermicro 服务器的 BMC 固件更新/刷写功能通常受许可证控制。这也是该主板在 coreboot 流程中最具特色的刷写路径无需拆机使用编程器直接通过网络管理口完成整片 SPI 固件的替换。对于同一系列的其他主板系列文档 还指向通用刷写教程 external power flashing。由于 X11SSW-F 的 ROM 芯片不可插拔若 BMC 刷写通道不可用需要评估编程器/夹子方案时请以该教程及板卡实际布局为准。刷写前务必注意coreboot 固件需要Intel FSP2.0与Intel ME等专有二进制见下文De-blobbing小节且与原生 BIOS 的布局不同刷写完成后原有固件将被覆盖。功能验证状态官方文档给出了实际测试结论以下信息直接决定该主板能否满足你的使用场景。已验证可用Tested and workingSeaBIOS 1.16.2作为 payload 成功加载Ubuntu 22.04内核 5.4.0-162-genericECC 内存Linux 的ie31200驱动正常工作即 ECC 纠错能力有效USB 端口以太网SATA 端口外部 RS232 串口左侧 PCIe 槽位Left RiserPCIe 3.0 x16BMCIPMIAspeed 上的 VGA 输出。未测试Untested右侧 PCIe 槽位Right RiserNVMe板载 PCIe x4 NVMe 槽位TPM 扩展 header 上的 TPM。已知问题Known issues见系列通用问题章节详见下文LNXTHERM 缺失DSDT 中未提供 ACPI 温度区thermal zone操作系统下无法通过 ACPI 读取板载温度S3 休眠恢复不可用SLP_S3睡眠唤醒存在问题服务器场景下建议禁用 S3。系列级已知问题系列文档 补充了适用于所有 X11 LGA1151 型号的通用问题MRC 缓存MRC caching在冷启动时对 Intel SPS 无效因为 SPS 固件会改变内存训练相关的存储布局FSP 内存参考代码缓存在冷启动场景下无法复用。De-blobbing去除专有固件该系列主板依赖两类必需专有组件且各有去除方案Intel FSP2.0当前没有自由实现可替代因此无法移除Intel MESPS可以使用仓库中的me_cleaner工具进行清理文档实测可腾出约4.5 MiB额外可用空间工具源码位于 util/me_cleanerIntel 以太网控制器固件若不需要其扩展功能可以移除细节需查阅对应数据手册如 I210 的 333016-008带 AST2400 BMC/IPMI 的型号BMC 固件可以替换为OpenBMC开源实现。源码级配置详解内存初始化FSP 参数romstage.c 展示了 FSP 内存参考代码的关键参数struct spd_block blk { .addr_map { 0x50, 0x51, 0x52, 0x53, }, }; mem_cfg-DqPinsInterleaved 1; mem_cfg-CaVrefConfig 2; get_spd_smbus(blk); mem_cfg-MemorySpdDataLen blk.len; mem_cfg-MemorySpdPtr00 (uintptr_t)blk.spd_array[0]; mem_cfg-MemorySpdPtr10 (uintptr_t)blk.spd_array[2]; mem_cfg-MemorySpdPtr01 (uintptr_t)blk.spd_array[1]; mem_cfg-MemorySpdPtr11 (uintptr_t)blk.spd_array[3]; mem_cfg-UserBd BOARD_TYPE_SERVER; mupd-FspmTestConfig.DmiVc1 1;要点解读SPD 通过 SMBus 从地址0x50 ~ 0x53读取对应 4 根 DIMM 槽的 EEPROMDqPinsInterleaved 1开启数据引脚交错CaVrefConfig 2配置 CA 参考电压这两项是 Kaby Lake 服务器板常见的内存拓扑设定UserBd BOARD_TYPE_SERVER告知 FSP 这是服务器板型DmiVc1 1启用 DMI 链路的 VC1 虚拟通道满足服务器设备的带宽需求。基板设备树devicetree.cbdevicetree.cb 定义了所有 X11 LGA1151 型号共享的设备SkipExtGfxScan 1跳过外部显卡扫描服务器板通常无独显需求s0ix_enable true与一组PmConfigSlp*MinAssert寄存器配置 SLP_S0/S3/S4/SUS/SLP_A 信号的最小拉低时间S3 为 50 ms、S4 为 4 s、SUS 为 4 s、SLP_A 为 2 sSATA 控制器使能全部 8 个端口SataPortsEnable且全部开启热插拔SataPortsHotPlugSataSalpSupport 1lpc_espi上挂载superio/commonPNP2e.0与drivers/pc80/tpmPNP0c31.0。变体覆盖树overridetree.cbX11SSW-F 的差异化配置集中在 overridetree.cbGPE 路由与显示策略register gpe0_dw0 GPP_B register gpe0_dw1 GPP_D register gpe0_dw2 GPP_E register PrimaryDisplay Display_AutoGPE 事件位宽与 ASL 代码中的 GPE 偏移相互关联源码注释特别提醒改动路由必须同步修改 ASL 中的 GPE 位。PrimaryDisplay设为Display_Auto是因为该板 IGD 无显示输出显示实际由 Aspeed 承担。USB 端口与过流配置USB 2.0 与 USB 3.0 端口都通过usb2_ports/usb3_ports数组逐端口指定过流overcurrent引脚例如register usb2_ports { [0] USB2_PORT_MID(OC3), /* USB 6 (3.0) */ [1] USB2_PORT_MID(OC3), /* USB 7 (3.0) */ [2] USB2_PORT_MID(OC2), /* USB 0 */ ... [13] USB2_PORT_MID(OC_SKIP), /* IPMI USB hub */ ... }值得注意[13]被标记为OC_SKIP并注释为 IPMI USB hub——即该内部 USB 端口专供 BMC 管理使用不做过流检测。源码注释还诚实标注 Overcurrent OCx values untested过流值未经实测这是移植者的重要提示。PCIe 槽位与 SMBIOS 描述peg0CPU SLOT1 PCI-E 3.0 X16即文档中Left RiserSMBIOS 描述SlotTypePciExpressGen3X16pcie_rp1/pcie_rp2挂载两片 I210 GbE 网卡pcie_rp5M.2 2280 槽SlotTypeM2Socket3x4 带宽pcie_rp9PCH SLOT2 PCI-E 3.0 X4插于 x8 槽位即文档中Right Riserpcie_rp13Aspeed PCI 桥接器其下挂载 Aspeed 2400 VGA。LPC 解码窗口与 Super I/O / IPMIregister gen1_dec LPC_IO(0xa00, 0x80) /* Super IO SWC */ register gen2_dec LPC_IO(0xca0, 0x10) /* IPMI KCS */ chip drivers/ipmi register wait_for_bmc 1 register bmc_boot_timeout 60 device pnp ca2.0 on end # IPMI KCS end通过通用解码窗口generic decode为 Super I/O 的 SWC 寄存器0xa00与 BMC KCS 接口0xca0保留 I/O 空间IPMI 驱动设置wait_for_bmc 1与bmc_boot_timeout 60即上电后等待 BMC 启动最长 60 秒——这是因为冷启动时 BMC 启动 IPMI 服务需要较长时间据 IPMI KCS 驱动文档同系列 AST2400 的 X11SSH 实测需约 34 秒superio/aspeed/ast2400子设备完整定义了SUART1IO 0x3f8, IRQ 4、SUART2IO 0x2f8, IRQ 3、SWC4 组 IO 窗口、GPIO、iLPC2AHB、MailboxIO 0xa40并关闭 KBC、SUART3、SUART4。启动早期初始化bootblock.c 在 bootblock 阶段就完成了两件事mainboard_configure_early_gpios()配置早期 GPIOaspeed_enable_serial()打开 AST2400 的 SUART1 作为CONFIG_TTYS0_BASE串口保证 coreboot 启动早期即有串口日志输出。mainboard.c 则通过mainboard_ops.init在 ramstage 调用mainboard_configure_gpios()完成全量 GPIO 配置详见于 variants/x11ssw-f/gpio.c其中包含 GPP_C22 的 SMI 触发、GPP_D2/GPP_E6 的 NMI 触发等服务器管理相关引脚。ACPI 与 CMOSfadt.c 将 FADT 的preferred_pm_profile设为PM_ENTERPRISE_SERVER向操作系统声明这是一台企业服务器cmos.layout 提供了选项表option table包括boot_optionFallback/Normal、debug_levelEmergency 到 Spew 共 9 级、hyper_threading超线程开关、power_on_after_fail掉电后上电策略支持 Disable/Enable/Keep 三态等并配有对应的 cmos.default 默认值dsdt.asl 以标准方式汇聚 CPU、System Agent、PCH 与主板 ACPI 逻辑睡眠状态由 southbridge/intel/common/acpi/sleepstates.asl 提供——这与S3 恢复不可用的已知问题直接相关ACPI 定义了 S3 状态但实际恢复路径存在问题。安全启动vboot基板 Kconfig 默认启用VBOOT_SLOTS_RW_AB双 A/B 槽位闪存布局由 vboot-ro-rwab.fmd 定义16 MiB 闪存中Intel 描述符 ME 占据前 5 MiBBIOS 区 11 MiB内部再划分 RW_SECTION_A/B、MISC_RW含 MRC 缓存、RW_VPD、SMMSTORE与写保护 RO 区含 GBB 与 coreboot CBFS。这意味着启用 vboot 后固件具备 A/B 冗余升级与回滚能力适合服务器远程运维场景。实战建议小结刷写路径优先通过 BMC Web 界面刷写需有效 license失败时参考 刷写教程 评估外部供电/编程器方案注意 ROM 芯片不可插拔。固件准备构建前确认已提供 Intel FSP2.0 与 MESPS二进制如需省空间可用me_cleaner清理 ME约省 4.5 MiBBMC 固件可替换为 OpenBMC。使用预期SeaBIOS Linux 主流通用场景已验证可用ECC 内存由ie31200驱动正确支持但 S3 恢复不可用、ACPI 缺少 LNXTHERMNVMe 与右侧 PCIe 槽尚未验证部署前需做好取舍。排查依据串口日志从 bootblock 起即输出IPMI KCS 驱动等待 BMC 最长 60 秒属正常现象MRC 缓存冷启动失效属已知限制不应视为故障。赞分享固件嵌入式操作系统驱动开发【免费下载链接】corebootRead-only mirror of https://review.coreboot.org/coreboot.git. Synced every hour. We dont handle Pull Requests.项目地址https://gitcode.com/gh_mirrors/co/coreboot点击查看免费下载相关推荐coreboot 实战指南Supermicro X11SSM-F 主板刷写、IPMI BMC 与驱动配置全解析coreboot 实战指南Supermicro X11SSM F 主板刷写、IPMI BMC 与驱动配置全解析 本篇技术指南围绕 coreboot 对 Sup固件嵌入式操作系统驱动开发SANA-Video 推理实战指南CLI 批量生成与 Sana LTX2 两阶段精修管线SANA Video 推理实战指南CLI 批量生成与 Sana LTX2 两阶段精修管线 本文面向希望在本仓库Sana中运行 SANA Video 视固件嵌入式操作系统驱动开发coreboot 移植实战Supermicro X10SLM-F 的构建、刷写与 BMC 移除coreboot 移植实战Supermicro X10SLM F 的构建、刷写与 BMC 移除 本文围绕 coreboot 对 Supermicro X10固件嵌入式操作系统驱动开发上一篇Visual C运行库完整解决方案告别软件兼容性问题下一篇VisualCppRedist AIO告别DLL错误困扰的终极解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考