Skip to content

技术参考 ​

从这里查找一次修改对应的文件、操作步骤和验证方法。完整流程见移植设备和构建与启动;板级参数与当前结果见设备列表。

1. 找到配置或实现 ​

修改内容文件或实现操作步骤
本地输入路径主仓库 unixnu.local.toml配置构建输入
设备、SoC 或组件选择设备 board.toml、feeds.toml、configs/解析设备配置
硬件资源SoC DTSI 和板级 DTS设备树
驱动行为所选组件或设备 package适配硬件、开发驱动
内核行为所属 profile 或组件的补丁序列修改 XNU
XNU 启动参数[payload] kernel_args 或本地 [build] kernel_args应用启动参数
启动菜单或 kitpayload 的 EFI/UniXNU/unixnu.toml、kit 的 Kit.toml启动配置
设备支持记录设备 porting.toml 与主仓库 devices.toml更新和发布记录
文档主仓库 docs/ 中英文页面编辑和发布文档

完成结果: 编辑前确定文件归属和对应操作步骤。

2. 查阅对应规范 ​

内容参考文档
构建工具命令与参数、配置字段、输出路径与报告
组件组件目录与源码身份、仓库和组件页面
驱动接口UEFI 驱动、内置 XNU 驱动、kext 包、设备树匹配
XNU源码与补丁归属、补丁目录、4 KiB 页表
启动与镜像格式启动链、预链接、payload、userdata 布局、启动配置
完整性trust cache 与启动策略
项目结构仓库归属、术语

字段表列出可用值和路径,操作顺序与构建命令见对应步骤链接。

3. 验证受影响的输出 ​

在主仓库中选定目标设备,运行:

sh
./unixnu status --json

核对设备、OS profile、配置、模块来源和输出目录,再执行对应验证:

改动验证方法预期结果
内核、驱动或补丁构建内核,再按启动验证顺序检查内核与预链接成功,受影响的设备检查点单独记录
固件或 payload构建与启动更新的 FD、payload 和启动镜像使用指定输入
启动参数检查 payload 配置打包后的 args 与预期命令行一致
公共 UEFI 行为QEMU 操作步骤所选场景出现预期日志标记
适配记录或文档记录检查、站点构建记录验证和文档构建通过

步骤失败时按故障排查处理,保存命令、输入版本和相关日志。

Released under the BSD-2-Clause-Patent License.