设备配置
设备仓库有四个配置文件：board.toml、configs/<name>_defconfig、feeds.toml 和 local.toml。
board.toml
[board]
| 键 | 类型 | 含义 |
|---|
name | 字符串 | 输出目录名 |
soc | 字符串 | SoC 标识 |
description | 字符串 | 可读描述 |
kit | 字符串 | 设备 package 在 kits/ 下的目录 |
example | 布尔 | 标记示例，build 和 bootimg 会拒绝 |
[ipsw]
| 键 | 类型 | 含义 |
|---|
url | 字符串 | 默认远程 IPSW |
product | 字符串 | 产品类型，例如 iPad7,1 |
version | 字符串 | 产品版本 |
build | 字符串 | 产品 build |
device_class | 字符串 | manifest 中的 device class |
chip_id | 整数 | ApChipID |
board_id | 整数 | ApBoardID |
fetch | 数组 | ipsw fetch 提取的组件 |
[ipsw.sha256]
| 键 | 类型 | 含义 |
|---|
| 成员文件 | 字符串 | 解压成员的期望 SHA-256 |
[userdata]
| 键 | 类型 | 含义 |
|---|
first_lba | 整数 | userdata GPT 条目起始 LBA |
last_lba | 整数 | userdata GPT 条目结束 LBA |
lba_bytes | 整数 | 逻辑块大小 |
windows | 数组 | { name, component } 条目 |
[kernel]
| 键 | 类型 | 含义 |
|---|
defconfig | 字符串 | configs/ 下的文件名 |
[kernel.prelink]
| 键 | 类型 | 含义 |
|---|
tool | 字符串 | 构建树中的预链接工具 |
kernel | 字符串 | 构建树中的原生内核 |
slide | 字符串 | 地址 slide |
roots | 数组 | 保留的 kernelcache bundle identifier |
early_security_init | 字符串 | identifier=address |
kernelcache | 字符串 | 可选本地 kernelcache 路径 |
kernelcache_sha256 | 字符串 | 期望 kernelcache 哈希 |
extra_args | 数组 | 预链接额外参数 |
[firmware]
| 键 | 类型 | 含义 |
|---|
config | 字符串 | Mu-Silicium Resources/Configs/<name>.toml |
dsc | 字符串 | 仓库中的 DSC 路径 |
fd | 字符串 | 固件卷路径，{target} 替换 |
packages | 数组 | PACKAGES_PATH 条目 |
preflight | 数组 | 构建树预检脚本 |
patches | 数组 | 构建期间应用到 edk2 的补丁 |
submodules | 数组 | 需要初始化的 Mu-Silicium 子模块 |
[firmware.defines]
| 键 | 类型 | 含义 |
|---|
| 任意 | 字符串 | EDK II 构建的 -D NAME=VALUE |
[bootimg.image]
| 键 | 类型 | 含义 |
|---|
base | 整数 | 镜像基址 |
kernel_offset | 整数 | 内核偏移 |
tags_offset | 整数 | tags 偏移 |
pagesize | 整数 | 镜像页大小 |
header_version | 整数 | Android 启动镜像 header 版本 |
[[bootimg.dtb_node]]
| 键 | 类型 | 含义 |
|---|
path | 字符串 | 设备树节点路径 |
props | 数组 | { name, type, value } |
类型为 s 字符串、x 十六进制 cell、i 十进制 cell、u 无符号 cell、empty。
[payload]
| 键 | 类型 | 含义 |
|---|
volume | 字符串 | FAT 卷标，最多 11 字符 |
size_mib | 整数 | 卷大小 |
loader | 字符串 | firmware 或驱动加载模式 |
title | 字符串 | 菜单标题 |
dram_size | 字符串 | ADT 使用的 DRAM 大小 |
panic_screen | 布尔 | 把 panic 屏幕打进负载内核 |
trust_cache_sha256 | 数组 | 接受的 trust cache 哈希 |
kernel_args | 数组 | 默认内核参数 |
timeout | 整数 | 菜单超时 |
skip_setup_tool | 字符串 | --skip-setup 使用的脚本 |
[payload.adt]
| 键 | 类型 | 含义 |
|---|
tool | 字符串 | ADT 生成器路径 |
chip_id | 字符串 | ADT 芯片 ID |
owned_memory_size | 字符串 | 连续窗口请求 |
root_match_volume_uuid | 字符串 | 根卷 UUID |
cpu_regs | 字符串 | CPU MPIDR 值，逗号分隔 |
psci_method | 字符串 | smc 或 hvc |
packed_data_ramdisk | 布尔 | 使用 packed Data 格式 |
ipad_identity | 布尔 | 写入 Apple 设备身份属性 |
unique_chip_id | 字符串 | 种子必需时写 required |
defconfig
CONFIG_NAME=y
CONFIG_NAME=n
CONFIG_NAME="text"
CONFIG_NAME=123
# CONFIG_NAME is not set
每个 CONFIG_XNU_<NAME> 变成 XNU_<NAME>，字符串中的 {tree} 替换为构建树路径。
feeds.toml
toml[[source]]
name = "Name"
kind = "driver" # driver、kit、patch、package、refer
git = "https://github.com/ORG/REPO"
ref = "main"
path = "drivers/Name"
commit = "..."
local = "/path/to/local"
submodules = []
| 键 | 含义 |
|---|
name | 模块名 |
kind | 模块类型 |
git | 源码仓库 |
ref | 拉取的分支、tag 或 commit |
path | 可选子目录，sparse 拉取 |
commit | 可选固定 commit |
local | 使用本地目录 |
submodules | 初始化的上游子模块 |
local.toml
设备仓库中被 Git 忽略的文件：
toml[local]
drivers = "/path/to/drivers"
kits = "/path/to/kits"
patches = "/path/to/patches"
scripts = "/path/to/scripts"
package = "/path/to/package"
unixnu.lock
toml[source."Name"]
commit = "0123456789abcdef"
由 unixnu fetch 写入。构建使用锁定的 commit，锁只记录 git 源码。
模块解析
--local-module [KIND:]NAME=PATH--local-<kind> DIR--local DIRfeeds.toml 的 local 键或 local.toml- 设备仓库
- 基础仓库
feeds.toml 的 git 源码
第一个匹配生效。
下一步
