Files
ssw 60b6fa6f7b vault: 设备绑定密钥 + 密封存储(宿主 16 用例 / QEMU VAULT_ALL_OK / 签名验收通过)
- 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 变量
2026-10-28 14:37:04 +08:00

19 KiB
Raw Permalink Blame History

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 机器上不现实。

更轻的走法(未实施,下次可试):

  1. 用 docker create --platform linux/arm/v7 arm32v7/ubuntu:22.04 + docker export 直接拿一个 glibc armv7 rootfs(省掉 buildroot);
  2. 内核用 Debian armhf 的 linux-image-armmp(支持 virt,且 Debian 带 optee.ko);
  3. qemu-system-arm -machine virt -cpu cortex-a15 -bios <tee-*.bin> -kernel zImage -initrd rootfs.cpio.gz;
  4. 目标机里 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-TEE CFG_TZDRAM_START 0x0e100000 完全一致

剩下的可能(下一步查这个):

  1. OP-TEE 在 aarch32 下进入 BL32 的模式/寄存器约定与 ATF aarch32 不符(Monitor vs SVC);
  2. CFG_TEE_CORE_NB_CORE=4 与实际核数的同步逻辑;
  3. 上游 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 节点。