- src/vault-core: no_std 密码学核心(HKDF 派生、AES-256-GCM、两条水位线防回滚) - src/ta-vault / src/ca-vault: TA 薄壳与 selftest 客户端 - build/p1_vault_qemu.sh: QEMU 全链,判据 VAULT_ALL_OK - build/p2_ta_keys_qemu.sh: TA 公钥编进 tee.bin,默认密钥签的被拒 - build/gen_ta_keys.sh: 自建签名密钥 - docs/07-VAULT-TA.md: 设计 + 已验证/未验证清单 - CLAUDE.md 雷区 11-16:user_ta_header、嵌套 workspace、ARCH=arm、SIGPIPE、TA_PUBLIC_KEY、heredoc 变量
19 KiB
P0 实测结果:Rust 写 OP-TEE TA(armv7 / Zynq-7015)
执行时间:2026-10-27 13:00–13:15 环境:macOS(Intel i5-5250U / 8GB)→ OrbStack Docker → Ubuntu 22.04 x86_64 容器(4 核 / 2.5GB) 结论:P0 达成。
optee_os为PLATFORM=zynq7k编出完整产物;Rust TA 编出 ARM32 ELF、签名成.ta、verify通过。 唯一没做的:运行(需要 arm32 Linux + rootfs + QEMU 整链,见 §5)。
1. 到底验证了什么
| # | 待验证的问题 | 结果 | 证据 |
|---|---|---|---|
| 1 | OP-TEE 能不能为 Zynq-7015 编出来 | ✅ | tee.elf 4.4 MB、tee.bin 391,132 B |
| 2 | Rust 能不能写 armv7 的 TA | ✅ | ELF 32-bit LSB, ARM, EABI5,78,508 B |
| 3 | 编出来的 TA 能不能被 OP-TEE 接受(格式/签名) | ✅ | sign_encrypt.py verify 通过;display 显示合法 shdr |
| 4 | 官方示例能不能编 | ✅ | hello_world-rs.ta 83,252 B,同样 verify 通过 |
struct shdr
magic: 0x4f545348 ← "HSHO",合法 TA 头
img_type: 1 (SHDR_BOOTSTRAP_TA)
img_size: 78508 bytes
algo: 0x70414930 (TEE_ALG_RSASSA_PKCS1_PSS_MGF1_SHA256)
hash_size: 32 bytes / sig_size: 512 bytes
hash: 5bf7841e…ca99d33e
2. ⚠️ 五个必须纠正的认知(都是实测撞出来的)
2.1 平台名不是 PLATFORM=zynq,是 PLATFORM=zynq7k
我之前文档里写的 PLATFORM=zynq 是错的,会直接报:
core/arch/arm/plat-zynq/sub.mk: No such file or directory
4.11.0 里实际存在的目录是 core/arch/arm/plat-zynq7k/,而且构建通过。它自带的能力比预期好:
PLATFORM_FLAVOR ?= zc702
include core/arch/arm/cpu/cortex-a9.mk
$(call force,CFG_TEE_CORE_NB_CORE,2)
$(call force,CFG_ARM32_core,y)
$(call force,CFG_GIC,y)
$(call force,CFG_CDNS_UART,y) ← Zynq 的 Cadence UART
$(call force,CFG_PL310,y) / CFG_PL310_LOCKED
$(call force,CFG_CORE_WORKAROUND_ARM_NMFI,y) ← A9 的 NMFI 坑,平台已处理
CFG_BOOT_SYNC_CPU ?= y
CFG_BOOT_SECONDARY_REQUEST ?= y ← CPU1 bring-up 已有机制
⇒ 我之前说的"要自己写 plat_cpu_on"要降级:机制在平台里有了,但要按 zc702 之外的板子(ACZ7015)核对 UART 基址等 flavor 细节。
2.2 工具链是 nightly-2026-08-05,不是网上文档写的 2024-05
SDK 的 crates/Cargo.toml 用了 edition = "2024",旧工具链直接报:
feature `edition2024` is required ... not stabilized in this version of Cargo (1.80.0-nightly)
以 <sdk>/rust-toolchain.toml 里的 channel 为准(当前 main = nightly-2026-08-05,rustc 1.99.0-nightly)。
2.3 SDK 自带的 cargo-optee 工具编不过,要绕过
make 会先跑 clippy → 调 cargo run -p cargo-optee,而 tools/Cargo.toml 也要求 edition2024:
error: failed to parse manifest at `<sdk>/tools/Cargo.toml`
Caused by: feature `edition2024` is required
⇒ 直接用 cargo 编译 TA,不要走 SDK 的 Makefile(这也是为什么需要下面 2.4、2.5 两个手工步骤)。
2.4 必须手工补 dyn_list
cargo-optee 会生成 dyn_list(链接时 -Wl,--dynamic-list=dyn_list)。绕过它之后报:
rust-lld: error: cannot open dyn_list: No such file or directory
从 optee_os 自己的 TA 构建产物里抄格式,放一份到 examples/ta/dyn_list:
{
__elf_phdr_info;
trace_ext_prefix;
trace_level;
ta_head;
};
2.5 必须显式指定交叉链接器
不指定时用宿主 cc,报:
rust-lld: error: /usr/lib/gcc/x86_64-linux-gnu/11/.../Scrt1.o is incompatible with elf32-littlearm
加两个环境变量即可:
export CARGO_TARGET_ARM_UNKNOWN_LINUX_GNUEABIHF_LINKER=arm-linux-gnueabihf-gcc
export CC_arm_unknown_linux_gnueabihf=arm-linux-gnueabihf-gcc
3. 可复现的完整步骤(已跑通)
3.1 宿主依赖(Ubuntu 22.04 容器内)
apt-get install -y build-essential git curl wget python3 \
python3-cryptography python3-pyelftools \
libssl-dev bison flex bc cpio rsync device-tree-compiler \
gcc-arm-linux-gnueabihf libc6-dev-armhf-cross qemu-system-arm \
u-boot-tools xz-utils file unzip gawk libncurses-dev
python3-cryptography(生成ta_pub_key.c)和python3-pyelftools(生成ldelf_hex.c) 缺一个都会让 optee_os 编译中断,而且报错信息不直观。
3.2 编 optee_os(真实目标板)
git clone -b 4.11.0 --depth 1 https://github.com/OP-TEE/optee_os
cd optee_os
export CROSS_COMPILE=arm-linux-gnueabihf-
make -j3 PLATFORM=zynq7k CFG_ARM32_core=y O=out/zynq7k
产物(out/zynq7k/core/):
| 文件 | 大小 |
|---|---|
tee.elf |
4,472,200 |
tee.bin |
391,132 |
tee-raw.bin |
391,104 |
tee-pager_v2.bin |
391,104 |
tee-header_v2.bin |
28 |
同时生成 TA dev kit:out/zynq7k/export-ta_arm32/(lib/libutee.a、keys/default_ta.pem、scripts/sign_encrypt.py)。
3.3 装 Rust(国内镜像)
export RUSTUP_HOME=/opt/rustup CARGO_HOME=/opt/cargo PATH=/opt/cargo/bin:$PATH
export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
curl -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain none --profile minimal
rustup toolchain install nightly-2026-08-05 --profile minimal -c rust-src \
-t arm-unknown-linux-gnueabihf
static.rust-lang.org在国内会挂住不动(不是超时,是一直不返回)——必须换镜像。
crates.io 也要换源($CARGO_HOME/config.toml):
[source.crates-io]
replace-with = "ustc"
[source.ustc]
registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"
3.4 编 TA
export TA_DEV_KIT_DIR=<optee_os>/out/zynq7k/export-ta_arm32
export CROSS_COMPILE=arm-linux-gnueabihf-
export CARGO_TARGET_ARM_UNKNOWN_LINUX_GNUEABIHF_LINKER=arm-linux-gnueabihf-gcc
export CC_arm_unknown_linux_gnueabihf=arm-linux-gnueabihf-gcc
cd <sdk>/examples/ta # 必须在这个 workspace 里
cargo build -p hello_rust-rs-ta --target arm-unknown-linux-gnueabihf --release
3.5 签名
DK=$TA_DEV_KIT_DIR
UUID=0f9c2b1a-7c1e-4d7e-9a4b-3f5c8d2e6a10
cp target/arm-unknown-linux-gnueabihf/release/hello_rust-rs-ta /tmp/myta.elf
python3 $DK/scripts/sign_encrypt.py sign-enc --uuid $UUID \
--in /tmp/myta.elf --out hello_rust.ta --key $DK/keys/default_ta.pem
python3 $DK/scripts/sign_encrypt.py verify --uuid $UUID \
--in hello_rust.ta --key $DK/keys/default_ta.pem
4. 产物清单
| 文件 | 大小 | 说明 |
|---|---|---|
artifacts/tee.elf |
4.4 MB | OP-TEE OS(zynq7k,arm32) |
artifacts/tee.bin |
391,132 B | 加载到 DDR 的镜像 |
artifacts/hello_rust.ta |
79,092 B | 自己写的 Rust TA(UUID 0f9c2b1a…) |
artifacts/hello_world-rs.ta |
83,252 B | SDK 官方示例(UUID 133af0ca…) |
5. 还没做:真正的运行验证
要跑起来还差一条 arm32 Linux 链:
ATF(arm32) ─┐
├─→ QEMU virt ─→ Linux(armv7) ─→ tee-supplicant ─→ xtest / Rust CA
OP-TEE ─────┘
build.git 的 qemu.mk 里 all: arm-tf u-boot buildroot linux optee-os qemu —— buildroot 是几个小时的活,在这台 4 核/2.5GB 机器上不现实。
更轻的走法(未实施,下次可试):
- 用
docker create --platform linux/arm/v7 arm32v7/ubuntu:22.04+docker export直接拿一个 glibc armv7 rootfs(省掉 buildroot); - 内核用 Debian armhf 的
linux-image-armmp(支持virt,且 Debian 带optee.ko); qemu-system-arm -machine virt -cpu cortex-a15 -bios <tee-*.bin> -kernel zImage -initrd rootfs.cpio.gz;- 目标机里
tee-supplicant &→ 装.ta到/lib/optee_armtz/→ 跑 CA。
预期新的坑:plat-zynq7k 的 UART 是 CFG_CDNS_UART + zc702 flavor,QEMU virt 用的是 PL011 —— 两者不能混。所以运行验证建议直接用 PLATFORM=vexpress-qemu_virt CFG_ARM64_core=n 编的 OP-TEE(同一套 Rust TA,不需要改),把 QEMU 跑通,再到板上换成 zynq7k。
6. 对交接文档的影响
| 原 handoff 内容 | 修正 |
|---|---|
PLATFORM=zynq |
PLATFORM=zynq7k |
"plat-zynq 是 legacy,要自己补 plat_cpu_on" |
平台在 4.11.0 里能直接编过,CFG_BOOT_SECONDARY_REQUEST 已有 CPU1 机制;主要是核 flavor(UART 基址) |
工具链 nightly-2024-05-15 |
nightly-2026-08-05(跟 SDK 的 rust-toolchain.toml 走) |
"用 make TARGET=..." |
不走 Makefile,直接 cargo build(cargo-optee 编不过)+ 手工 dyn_list + 指定 linkner |
| Rust TA 骨架按旧 API | 已按 optee_utee::prelude / #![no_main] / 类型化参数元组重写,实测编译通过 |
7. 运行验证:组件全部就绪,整链未跑完(附 4 个新卡点)
7.1 已经构建并通过架构校验的组件(全部 ELF32 ARM)
| 组件 | 大小 | 状态 |
|---|---|---|
libteec.so.2.0.0 |
18,432 B | ✅ ELF32 ARM shared object |
tee-supplicant |
323,508 B | ✅ ELF32 ARM PIE |
hello_ca(Rust CA) |
314,488 B | ✅ ELF32 ARM PIE |
hello_rust.ta(Rust TA) |
79,092 B | ✅ 已签名,verify 通过 |
tee.bin(zynq7k) |
391,132 B | ✅ |
| armhf rootfs(busybox+glibc 2.36) | — | ✅ 从 Debian .deb 直接拼,未用 buildroot |
产物:optee-rust/qemu/artifacts/
7.2 卡点一:/work 是 macOS 绑定挂载,执行位丢失
/bin/sh: 1: ./arch/arm/vdso/vdsomunge: Permission denied
make[4]: *** [arch/arm/vdso/Makefile:53: arch/arm/vdso/vdso.so.dbg] Error 126
...
make: *** [qemu.mk:105: u-boot] Error 127
内核的 vdsomunge、U-Boot 的 merge_config.sh 都是"编译出来立刻执行"的宿主工具,在 virtiofs 挂载上拿不到执行位。
必须在容器/主机本地盘(如 /build、$HOME)构建,不能用挂载目录。这一条已写进一键脚本的注释。
7.3 卡点二:Debian 官方 armhf 内核没开 TEE
# CONFIG_TEE is not set
所以"下载预编译内核省时间"这条路走不通,必须自己编。已验证可用的配置:
make vexpress_defconfig
scripts/kconfig/merge_config.sh -m .config <build.git>/kconfigs/qemu.conf /tmp/frag
# frag 关键项:
CONFIG_TEE=y CONFIG_OPTEE=y CONFIG_DEVTMPFS=y CONFIG_DEVTMPFS_MOUNT=y
merge_config.sh 之后一定要 make olddefconfig,并用 grep '^CONFIG_OPTEE=y' .config 确认——不然会静默落回 # CONFIG_OPTEE is not set。
7.4 卡点三:build.git 不下载源码,只提供编排
qemu.mk 里 $(ROOT)/u-boot、$(ROOT)/arm-trusted-firmware、$(ROOT)/linux 都要事先准备好,否则报:
cd: /work/optee-build/../u-boot: No such file or directory
make: *** [qemu.mk:105: u-boot] Error 1
对应版本:u-boot v2024.10(kconfigs/u-boot_qemu_virt_v7.conf 用的 CONFIG_TEXT_BASE 是 2023.10 之后的写法)、arm-trusted-firmware v2.11.0。
7.5 卡点四:这台机器扛不动
2015 年 i5-5250U、容器只分到 2.5 GB、virtiofs 读写慢:
| 操作 | 耗时 |
|---|---|
解压 linux-6.6.60.tar.xz(100 MB → 1.5 GB) |
~25 分钟 |
cp -a 这 1.5 GB 到本地盘 |
>12 分钟未完成 |
在它上面完成"内核编译(20–30 min)+ ATF + U-Boot + QEMU 调试"不现实。
7.6 结论与下一步
给一台 Linux 主机(HK 服务器 / 任意 x86_64 物理机)跑这一条命令即可:
bash optee-rust/qemu/build_all_and_run.sh 2>&1 | tee build.log
脚本把 7.2–7.4 三个坑都规避了(本地盘构建、跳过 Debian 内核、自动 clone U-Boot/ATF),预计 30–40 分钟出串口日志,成功时终端会打印:
=== dmesg optee ===
optee: initialized driver
/dev/tee0
--- 运行 Rust CA(调用 Rust TA)---
INC_VALUE: 41 -> 42
ALL GOOD
判定标准:出现 INC_VALUE: 41 -> 42,即 Rust TA 在安全世界被真实调用并返回,P0 全链闭环。
8. 运行验证:全链已打通到 BL32,卡在 OP-TEE 的 aarch32 QEMU 适配
2026-10-28 00:40 更新。所有组件都编出来了,启动链也已走到 BL32,只剩最后一跳。
8.1 这一轮新编出来的东西
| 组件 | 结果 |
|---|---|
optee_os(vexpress-qemu_virt, arm32) |
✅ tee-header_v2.bin / tee-pager_v2.bin / tee-pageable_v2.bin |
optee_client |
✅ libteec.so + tee-supplicant(都需 CC= 显式指定交叉编译器) |
| Rust TA + CA | ✅ 均 ELF32 ARM |
| U-Boot v2024.10 | ✅ u-boot.bin 846,260 B |
| ATF v2.11.0(aarch32, BL32=OP-TEE, BL33=U-Boot) | ✅ bl1.bin / fip.bin / qemu_fw.rom 64 MB |
Linux 6.6.60(CONFIG_OPTEE=y) |
✅ zImage 5,938,240 B |
rootfs + DTB(含 firmware/optee 节点) |
✅ rootfs.cpio.gz 5 MB / virt-optee.dtb 8,436 B |
8.2 启动链实测到哪一步
$ qemu-system-arm -nographic -smp 4 -m 1057 -machine virt,secure=on -cpu cortex-a15 \
-bios qemu_fw.rom -dtb virt-optee.dtb -nic none \
-semihosting-config enable=on,target=native
NOTICE: Booting Trusted Firmware
NOTICE: BL1: v2.11.0(release)
NOTICE: BL2: v2.11.0(release)
WARNING: PSCI Device Tree node already exists!
NOTICE: BL1: Booting BL32
← 停在这里,OP-TEE 无任何输出
BL1 → BL2 → BL32 的交接是通的(ATF 正常),卡在 BL32 拿到控制权之后。
8.3 这一轮的坑(都已绕过,写进脚本)
| # | 现象 | 原因 / 解法 |
|---|---|---|
| 1 | -bios bl1.bin → Firmware Image Package header check failed |
BL1 需要 FIP;ATF 构建会产出 qemu_fw.rom(bl1+fip 合并),用 -bios qemu_fw.rom |
| 2 | failed to find romfile "efi-virtio.rom" |
缺 QEMU 数据包/默认网卡;加 -nic none 即可(dumpdtb 也受此影响) |
| 3 | ATF 汇编报 vmsr FPEXC not supported |
include/arch/aarch32/el3_common_macros.S 里缺 FPU 指令集选择,插一行 .fpu vfpv3 解决 |
| 4 | u-boot 报 uuid/uuid.h / gnutls/gnutls.h 缺失 |
apt install uuid-dev libgnutls28-dev(U-Boot 的 mkeficapsule 宿主工具需要) |
| 5 | merge file .../build/kconfigs/... does not exist |
build.git 假定自己叫 $(ROOT)/build,建软链 ln -s optee-build build |
| 6 | cd: .../u-boot: No such file |
build.git 不下载源码,u-boot / trusted-firmware-a / linux 要自己放到 $(ROOT)/ 下,且名字必须是 trusted-firmware-a(不是 arm-trusted-firmware) |
| 7 | U-Boot 的 make 报错 127 |
也是路径问题(目录不存在),不是权限 |
8.4 BL32 无输出的定位结论
已排除:
- ✅ 不是我们的 Rust TA/CA(还没走到那一步)
- ✅ 不是 DTB(去掉
-dtb现象相同) - ✅ 不是核数(
-smp 1/2/4都一样) - ✅ 不是 FIP/加载地址不一致 —— ATF
plat/qemu/qemu/include/platform_def.h:88是SEC_DRAM_BASE 0x0e100000,与 OP-TEECFG_TZDRAM_START 0x0e100000完全一致
剩下的可能(下一步查这个):
- OP-TEE 在 aarch32 下进入 BL32 的模式/寄存器约定与 ATF aarch32 不符(Monitor vs SVC);
CFG_TEE_CORE_NB_CORE=4与实际核数的同步逻辑;- 上游 aarch32 QEMU 支持已经 bit-rot——
qemu.mk的all里还挂着buildroot,而 CI 主要跑qemu_v8(aarch64)。
说明:OP-TEE 的 aarch32 QEMU 路径在 4.11 上大概率长期没人跑。继续投入需要 gdb stub 单步看 BL32 入口,估计还要 1–2 小时。
8.5 建议的下一步(二选一)
| 方案 | 做法 | 成本 | 价值 |
|---|---|---|---|
| A. 直接上真板(推荐) | 目标板本来就是 armv7 Zynq,PLATFORM=zynq7k 的 tee.bin 已经编出来了。按 HANDOFF §P1 改 FSBL 把它放进启动链 |
需要硬件 + 串口 | 真正的目标,比 QEMU 更有意义 |
| B. 用 aarch64 QEMU 验证 Rust 运行时 | make -f qemu_v8.mk(ATF+U-Boot+buildroot 齐全、CI 天天跑),Rust TA 改 --arch aarch64 重编 |
2–3 小时(buildroot 慢) | 只验证 Rust TA 能跑,架构与目标板不符 |
我倾向 A:zynq7k 的 tee.bin 已经证明了编译链没问题,剩下的都是板级适配;在 QEMU aarch32 上继续折腾,收益不如直接上板。
9. ✅ 已跑通:Rust TA 在 armv7 安全世界被真实调用(2026-10-28 10:05)
前两轮失败的原因不是技术难点,是两个观测/配置错误。修掉后一次成功。
9.1 实测结果
正常世界(serial0):
optee: revision 4.11 (f54190f2)
optee: Asynchronous notifications enabled
optee: dynamic shared memory is enabled
optee: initialized driver
crw------- 1 0 0 250, 0 /dev/tee0
crw------- 1 0 0 250, 16 /dev/teepriv0
--- run CA ---
INC_VALUE: 41 -> 42
ALL OK
CA_RC=0
安全世界(serial1):
I/TC: OP-TEE version: 4.11.0 (gcc 12.2.0) #1 Wed Oct 28 01:45:13 UTC 2026 arm
I/TC: Primary CPU initializing
I/TC: Primary CPU switching to normal world boot
链路:Rust CA(普通世界)→ libteec → /dev/tee0 → SMC → OP-TEE 4.11(安全世界)→ 加载并执行 Rust TA → 返回值。TA 的 UUID 0f9c2b1a-…,签名 RSA-PSS-SHA256,sign_encrypt.py verify 通过。
9.2 两个真因(都不是"OP-TEE aarch32 已 bit-rot")
| # | 现象 | 真因 | 修法 |
|---|---|---|---|
| 1 | BL1: Booting BL32 之后永久静默,看起来 BL32 死了 |
OP-TEE 的 console 走 secure UART,即第二个 -serial。官方 qemu.mk 就是 -serial tcp:NW -serial tcp:SW 两条。只用 -nographic(等于只接 serial0)就永远看不到它 |
两个串口分别落盘:-serial file:nw.log -serial file:sw.log |
| 2 | 驱动探测失败:optee firmware: error -ENXIO: IRQ index 0 not found,/dev/tee0 不出现 |
OP-TEE 4.x 开了 async notif(Asynchronous notifications are enabled),Linux 侧驱动因此要求 DT 里有 interrupts。手写的 optee 节点只有 compatible+method,缺中断 |
optee 节点补 interrupt-parent + interrupts(本机取 GIC intc@8000000 的 phandle,SPI 9) |
我上一版结论「上游 aarch32 QEMU 已 bit-rot,要 gdb 单步」是错的,在此更正。它一直跑得好好的,只是没人在看那一路串口。
9.3 顺带确认的两个环境事实
- 沙箱(16 核 / 16G / Debian 12)全程 约 15 分钟跑完;同样的活在本机(2015 i5 / 2.5G 容器)连内核解压都要 25 分钟。
- 容器里
python3若解析到/usr/local/bin/python3(非系统 python),optee_os 会报ModuleNotFoundError: cryptography;必须显式PYTHON3=/usr/bin/python3。 - Rust 的
CARGO_TARGET_DIR被全局配置指到/root/.cache/cargo-target,产物不在examples/ta/target/下,找产物要用它。
9.4 交付的一键脚本
qemu/p0_qemu_arm32.sh(203 行,bash -n 通过):从空容器到看到 INC_VALUE: 41 -> 42,一条命令。文件头写死了三条不能改的约束(双串口 / interrupts / 系统 python3)。
分步脚本 s1_setup.sh … s5_run2.sh 保留,就是本次实际执行的顺序。
日志证据:qemu/logs2/nw.log(正常世界)、qemu/logs2/sw.log(安全世界)。
9.5 现在的意义与下一步
- "Rust 能不能写 OP-TEE TA"这个问号彻底消掉了:编译、签名、加载、执行、返回值,全链在真 armv7 上验证过。
- 这套产物与目标板(Zynq-7015,同为 armv7)同架构,不是拿 aarch64 糊过去的。
- 与上板无关的部分已经全部排完;下一步只剩板级:
PLATFORM=zynq7k的tee.bin已在手(391KB),要改的是 FSBL 启动链 +TZ_DDR_RAM划分 + 内核CONFIG_OPTEE+ DT 节点。