v0.2.0

v0.2.0

Firmware & tooling release on the pinned iPXE baseline e6e51ccb with 12 patches (UEFI-only, 7 artifacts).

What's new

• Firmware: NBCT credentials ACPI table, per-MAC hostnqn, device trust-root (NVS/TOFU/key commands)
• initramfs-nbft: NBFT/NBCT consumer seed module, hostid pin on nvme connect
• Golden image: one-shot Debian 12 setup script + customization guide
• Docs: NVMe-oF suite, NBFT research, production verification records

Assets: pxe-uefi/ + direct-uefi/ (ipxe / ipxe-debug / snponly / snponly-debug), checksums in SHA256SUMS.

v0.1.2

版本概述

本版本基于上游 iPXE 基线 e6e51ccb 及 5 个定制补丁（0001-0005）构建。相较上一发行版新增设备信息采集能力（SMBIOS 内存参数 + 网卡芯片名），完成 RTL8126 驱动修复收尾，并对 README 与附属文档整体重构。

主要变更

• 新增 0005 设备信息采集补丁：
  • SMBIOS type 17 内存参数设置 mem-total / mem-type / mem-speed（多插槽聚合总量，Extended Size 与 MB/GB 单位换算、未知槽跳过；type/speed 取首槽）
  • PCI 网卡经 driver_name 暴露设备表芯片名，${net0/chip} 可用（如 RTL8125）
  • 新增文档 docs/device-info-reporting：采集变量清单与上报 URL 用法（数值设置按 iPXE 约定以十六进制展开）
• RTL8126（0004）驱动修复完成：PHY 直写与读改写语义区分，驱动修复收尾
• README 重构：按主仓库（iPXE-All-Ready）风格精简（移除适用范围 / 验证状态 / 目录结构 / 构建流程章节），产物清单独立为 docs/build-artifacts

产物清单

文件	使用场景
pxe-uefi/ipxe.efi	UEFI PXE 链加载（native + SNP 双通道），无 EMBED
pxe-uefi/ipxe-debug.efi	UEFI PXE 链加载调试版，REALTEK 驱动日志
pxe-uefi/snponly.efi	UEFI PXE 链加载（SNP 专用，不依赖驱动表），无 EMBED
pxe-uefi/snponly-debug.efi	SNP 链加载调试版
direct-uefi/ipxe.efi	UEFI 本地引导（USB/磁盘），内置 iSCSI 自动启动脚本
direct-uefi/ipxe-debug.efi	调试版，REALTEK 驱动日志，用于网卡问题定位
direct-uefi/snponly.efi	固件 PXE 链加载 / SNP 兜底（RTL8125 除外：其固件驱动存在 iSCSI TX 挂起缺陷，须用 native 驱动）
grub-bios/ipxe.lkrn	GRUB2 菜单链加载（BIOS 环境）
undionly.kpxe	BIOS PXE 链加载（经网卡 UNDI 接口），无 EMBED
usb/ipxe.usb	USB 磁盘启动镜像

校验值（SHA256，与 dist/SHA256SUMS 一致）

文件	SHA256
direct-uefi/ipxe-debug.efi	35813b6d3df8f8a843aecee5f8a8a74b2606137971f277209632b055c30b007f
direct-uefi/ipxe.efi	5e1b64c2e3d6718b8d80e911eef60e011f91f2074064cd0bd9325d93eef482d8
direct-uefi/snponly.efi	26080ea95464d847bee9fc9868eedf89ccc4fb41271314ae9cd5abb8ec07c68e
grub-bios/ipxe.lkrn	c24728bff5505dcc18f94b07de7432fb9f8bf2f06667f1bb99a8f6f66cd42ef1
pxe-uefi/ipxe-debug.efi	d74bd4d97caf26ddef79b8ffe28fc3154b68aed2fae328e627a281b001960d41
pxe-uefi/ipxe.efi	d52af1e83b604f127b0875cf2987c0ee7301ed851749f792822042da96b26be7
pxe-uefi/snponly-debug.efi	11d6de41482303cc464da91e4f2f0d9fc00e11efb8ef60679160a611b9fc7c78
pxe-uefi/snponly.efi	e6fa83e6fc2d7d662fd5a9fd6cf15e6f0a3842ba636c0cce8ae34134677f7f89
undionly.kpxe	aac2b68d72da2a5a6bc2504debee89f3e236d346501d768bcec1ba27afc0f6f5
usb/ipxe.usb	c4346a99a3dece401fcd246f0e81160932ebafbbd562106101332f03462f48f3

许可

GPL-2.0（见 LICENSE）。上游利用声明见 README：iPXE（GPL-2.0-or-later / UBDL）基础源码及 Linux 内核 r8169 驱动（GPL-2.0）参考实现。

v0.1.1

版本概述

本版本基于上游 iPXE 基线 e6e51ccb 及 3 个定制补丁构建，相较上一发行版补齐 PXE 网络引导链所需固件，构建产物由 6 个扩展至 10 个。

主要变更

• 新增 PXE 链加载固件：pxe-uefi/ipxe-debug.efi（REALTEK 驱动日志，用于链加载场景问题定位）、pxe-uefi/snponly.efi（纯 SNP，不依赖驱动表）、pxe-uefi/snponly-debug.efi
• 新增 BIOS PXE 链加载固件 undionly.kpxe：经网卡 Option ROM 的 UNDI 接口收发，兼容一切带 PXE ROM 的网卡；命名与官方及 dnsmasq 下发配置一致
• PXE 链加载固件均不含 EMBED 脚本（由第二阶段 DHCP 下发，与 dnsmasq 链式部署配套）；本地引导固件（direct-uefi / grub-bios / usb）保留内置脚本
• 0002 补丁扩展：新增 DRIVERS_snponly-debug 驱动集定义，修复 snponly-debug.efi 目标链接失败（上游仅支持 ipxe-debug）
• 新增网卡支持矩阵 docs/network-support.md（覆盖良好 / 不支持 / 有条件三类及实测记录），并声明适配方向：聚焦 2.5G 及以上速率高性能网卡驱动移植与适配，普通千兆/百兆网卡不再更新适配
• 设计动机与定制内容独立为 docs/customizations.md

产物清单

文件	使用场景
pxe-uefi/ipxe.efi	UEFI PXE 链加载（native + SNP 双通道），无 EMBED
pxe-uefi/ipxe-debug.efi	UEFI PXE 链加载调试版，REALTEK 驱动日志
pxe-uefi/snponly.efi	UEFI PXE 链加载（SNP 专用，不依赖驱动表），无 EMBED
pxe-uefi/snponly-debug.efi	SNP 链加载调试版
direct-uefi/ipxe.efi	UEFI 本地引导（USB/磁盘），内置 iSCSI 自动启动脚本
direct-uefi/ipxe-debug.efi	调试版，REALTEK 驱动日志，用于网卡问题定位
direct-uefi/snponly.efi	固件 PXE 链加载 / SNP 兜底（RTL8125 除外：其固件驱动存在 iSCSI TX 挂起缺陷，须用 native 驱动）
grub-bios/ipxe.lkrn	GRUB2 菜单链加载（BIOS 环境）
undionly.kpxe	BIOS PXE 链加载（经网卡 UNDI 接口），无 EMBED
usb/ipxe.usb	USB 磁盘启动镜像

校验值（SHA256，与 dist/SHA256SUMS 一致）

文件	SHA256
pxe-uefi/ipxe.efi	3032fcf7003735e0391795793524ae77f6d8f25fea4391da44e2e5ace9bb3f0e
pxe-uefi/ipxe-debug.efi	3bd25fe23adeaeaf907310e045a7c8024de9db5e30e9000d0984a7080b53be91
pxe-uefi/snponly.efi	05a1f99258bb968b47952a6b14500bbc0cc388b157c55e1933ab2ac7810e71ce
pxe-uefi/snponly-debug.efi	78653ea61fbab8c409484b07fd439d79a02563268a4d44930bf27417fc821d82
direct-uefi/ipxe.efi	24c0b8c6554814d29aa083b7323b82c342bb4f2c08d0bd28d98e5a1ff13d665f
direct-uefi/ipxe-debug.efi	9564ea719d66f012d4feff607cd733ede5d964e6b45de6a6efc211434578b4ca
direct-uefi/snponly.efi	83b6773eed6a5612151c68fd9170140d21b8a53d0e1a3fbdb8a057997841284c
grub-bios/ipxe.lkrn	9e2bfca6949d0d646d13b94f04770ea9606ae440a38961a54072609023819787
undionly.kpxe	7f9fba20bb15b71e9664874dce313a938e5643f3c6c2a4751bfe51a00e13d30a
usb/ipxe.usb	cfc3cc957439fb7059bdbf623fab4716350eaaf5dca7648df5849e4a15a7c138

许可

GPL-2.0（见 LICENSE）。上游利用声明见 README：iPXE（GPL-2.0-or-later / UBDL）基础源码及 Linux 内核 r8169 驱动（GPL-2.0）参考实现。

v0.1.0

首个发行版：无状态云原生 iPXE

基于上游 iPXE 基线 e6e51ccb + 3 个定制补丁构建。

特性

• RTL8125 全系适配（0001）：新增 0x10ec:0x8125 设备支持，XID 版本表覆盖 A/B/D/K/CP/BP 全系（参考 Linux 内核 r8169 驱动），EPHY 初始化与电源管理对齐 Linux；未知步进安全回退 8169 路径，无挂死风险
• debug 构建修复（0002）：ipxe-debug.efi 输出 REALTEK 驱动级日志（REALTEK:3），可显示芯片版本（如 REALTEK ... is a RTL8125D (XID 0688)）
• snponly 本地引导支持（0003）：本地 UEFI（USB/磁盘）引导时接管全部 SNP/NII/MNP 设备；PXE 链加载场景行为不变

产物（对应 dist/ 目录结构）

文件	使用场景
direct-uefi/ipxe.efi	UEFI 本地引导（USB/磁盘），内置 iSCSI 自动启动脚本
direct-uefi/ipxe-debug.efi	调试版，REALTEK 驱动日志，用于网卡问题定位
direct-uefi/snponly.efi	固件 PXE 链加载 / SNP 兜底（RTL8125 除外：其固件驱动存在 iSCSI TX 挂起缺陷，须用 native 驱动）
pxe-uefi/ipxe.efi	UEFI 网卡 PXE 启动链加载
grub-bios/ipxe.lkrn	GRUB2 菜单链加载（BIOS 环境）
usb/ipxe.usb	USB 磁盘启动镜像

校验值（SHA256，与 dist/SHA256SUMS 一致）

文件	SHA256
pxe-uefi/ipxe.efi	479fbe32022ccf539061b0a476df540394ce0e1ca0b2d618469ec0dee262803c
direct-uefi/ipxe.efi	6b63b4276247088e759d26d7124136a52b9b608a0b713a0b27b93ecb22943bc1
direct-uefi/ipxe-debug.efi	d8b12687aafa1e8ad134335875813394122b2cd0251c63fb274c83218057c1c6
direct-uefi/snponly.efi	89c22ac0974b04f80cb242a0a330a626b7e46f6360d3fc9b16ec395c7d2ce68d
grub-bios/ipxe.lkrn	9e2bfca6949d0d646d13b94f04770ea9606ae440a38961a54072609023819787
usb/ipxe.usb	cfc3cc957439fb7059bdbf623fab4716350eaaf5dca7648df5849e4a15a7c138

许可

GPL-2.0（见 LICENSE）。上游利用声明见 README：iPXE（GPL-2.0-or-later / UBDL）基础源码 + Linux 内核 r8169 驱动（GPL-2.0）参考实现。