# op-tee-test Zynq-7015(ACZ7015,双核 Cortex-A9 / armv7)上跑 **OP-TEE 4.11 + Rust 写的 TA** 的完整工作集: 构建脚本、沙箱编排、实测日志、预编译产物,以及**板子上的后续动作清单**。 打包时间:2026-10-28 · 来源工程:`~/WorkBuddy/2026-10-26-13-43-18` --- ## 一句话现状 | | 状态 | |---|---| | **QEMU(arm32)全链** | ✅ **已跑通**。Rust CA → `/dev/tee0` → SMC → OP-TEE 4.11 → **Rust TA 执行并返回** | | **真板(Zynq-7015)** | ❌ 未开始。`tee.bin` 已编出,剩下是 FSBL/内存/内核/DT 的板级活 | | **vault(设备绑定密钥 + 密封存储)** | ✅ 宿主 16 用例 + QEMU `VAULT_ALL_OK` + 签名验收(默认密钥签的 TA 被拒),见 `docs/07` | QEMU 上的成功证据(`logs/p0-nw.log`): ``` optee: revision 4.11 (f54190f2) 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 ``` 安全世界侧(`logs/p0-sw.log`): ``` I/TC: OP-TEE version: 4.11.0 (gcc 12.2.0) #1 ... arm I/TC: Primary CPU switching to normal world boot ``` > 验证用的是 **armv7**,和目标板同架构 —— 不是拿 aarch64 糊过去的。 --- ## 目录 ``` op-tee-test/ ├── README.md ← 本文件 ├── CLAUDE.md ← 给 AI 编码助手的项目约定(怎么改、别踩什么) ├── docs/ │ ├── 01-HANDOFF.md 交接文档:目标/前置/阶段划分/Rust 侧要点 │ ├── 02-P0-RESULTS.md ★ QEMU 实测全过程,含两个「根因级」坑与纠正 │ ├── 03-TRUST-CHAIN.md Zynq 八层启动信任链 + eFuse 位定义 + 优化排序 │ ├── 04-PL-ENCLAVE.md PL 安全岛设计(PS 不可见内存 / AXI-NS 校验 / 寄存器映射) │ ├── 05-BOARD-ACTIONS.md ★★ 上板动作清单(P1→P5、验收、回滚) │ ├── 06-QSPI-UPDATE-LOOP.md QSPI 安全更新闭环 + eFuse 烧写 Runbook │ └── 07-VAULT-TA.md ★ 设备绑定密钥 + 密封存储(core/TA/CA 三层,QEMU 已验证) ├── build/ │ ├── p0_qemu_arm32.sh ★ 一键:空容器 → 看到 INC_VALUE(203 行,已验证) │ ├── p1_vault_qemu.sh ★ 一键:vault TA 全链 → VAULT_ALL_OK(已验证) │ ├── p2_ta_keys_qemu.sh ★ 一键:TA 签名公钥进 tee.bin → 默认密钥签的被拒 │ ├── build_ta_ca.sh TA+CA 单独编译签名(本地容器版,参数化) │ ├── build_vault.sh 编 vault TA/CA,支持 board / VAULT_SIM_DEV │ ├── gen_ta_keys.sh 生成自己的 TA 签名密钥(公钥编进 tee.bin) │ ├── vault_selftest_host.sh 宿主验证:纯 Rust,两秒,不需要板子/QEMU │ ├── steps/s1..s5 分步脚本,就是本次实际执行顺序(排错用这个) │ └── sandbox/csbx.py CubeSandbox 托管(创建/复用/后台跑/收发文件) ├── src/ │ ├── ta/ Rust TA(no_std,CMD_INC_VALUE / CMD_ECHO)— P0 基线 │ ├── ca/ Rust CA(libteec)— P0 基线 │ ├── vault-core/ ★ no_std 密码学核心:HKDF 派生 / AES-GCM 密封 / 防回滚 │ ├── ta-vault/ ★ vault TA(薄壳:参数/随机数/secure storage/DNA) │ ├── ca-vault/ ★ vault CA(provision/seal/unseal/rotate/selftest) │ ├── c-skeleton/ C 版 TA/CA 对照骨架(想用 C 写就从这开始) │ └── pl_enclave_regs.h PL 安全岛寄存器/命令字定义(RTL 与驱动共用) ├── logs/ │ ├── p0-nw.log 正常世界串口(成功) │ ├── p0-sw.log 安全世界串口(成功) │ ├── vault-nw.log ★ vault 全链:VAULT_ALL_OK │ ├── vault-sw.log ★ 同上,安全世界侧 │ └── fail-bl32-silent.log 修复前:「BL32 后静默」的真实现象,留作对照 └── artifacts/ ├── tee-zynq7k.bin OP-TEE OS,PLATFORM=zynq7k(391 KB) ├── hello_rust.ta Rust TA,已 RSA-PSS-SHA256 签名 + verify 通过 ├── hello_ca Rust CA(ELF32 ARM) ├── libteec.so.2.0.0 armhf ├── tee-supplicant armhf ├── SHA256SUMS 上面几个产物的校验和 └── vault/ ├── syvault.ta ★ vault TA(armv7,开发密钥签名) ├── syvault_ca ★ vault CA(armhf) └── SHA256SUMS ``` 全部都是 **ELF32 / ARM**(`hello_rust.ta` 是被签名的容器,`file` 显示 `data` 属正常)。 --- ## 怎么跑(QEMU,约 15 分钟) ### 路线 A:沙箱(推荐,16 核 / 16G,不受本机 I/O 拖累) ```bash cd build/sandbox PY=/path/to/python3 # 需要 pip install cubesandbox $PY csbx.py up # 创建(token 会落到 /tmp/cube_sbx.json) $PY csbx.py put ../p0_qemu_arm32.sh /root/p0.sh $PY csbx.py bg p0 'bash /root/p0.sh' 1800 $PY csbx.py log p0 80 $PY csbx.py down # 用完销毁 ``` 服务端地址与默认模板写在 `csbx.py` 顶部(`CUBE_API_URL` 等),按环境改。 ### 路线 B:任意 Linux x86_64(含 WSL / 云主机) ```bash bash build/p0_qemu_arm32.sh 2>&1 | tee build.log # 判据:最后打印 PASS: Rust TA 在安全世界被调用并返回 ``` 脚本自带:装依赖 → 拉 6 个源码 → 编 optee_os/u-boot/ATF → 编内核(开 OPTEE)→ 编 Rust TA/CA 并签名 → 拼 armhf rootfs → 生成带 optee 节点的 DTB → 跑 QEMU → 判 PASS。 > 本机(2015 i5 / 4 核 / 2.5G 容器)跑不动:**光解压内核就要 25 分钟**。 > 别在这类机器上死磕,换台像样的。 --- ## 五条「不改就会再踩」的硬约束 1. **OP-TEE 的 console 走 secure UART = 第二个 `-serial`** 官方 `qemu.mk` 一直是 `-serial tcp:NW -serial tcp:SW` 两条。只用 `-nographic`(只接 serial0) 会看到 `BL1: Booting BL32` 之后**永久静默**,让人误判「BL32 挂了 / 上游已 bit-rot」。 → 正确做法:`-serial file:nw.log -serial file:sw.log` 分开落盘。 2. **DT 的 optee 节点必须带 `interrupts`** OP-TEE 4.x 默认开 async notif,Linux 驱动因此强制要求中断。缺了就是 `optee: error -ENXIO: IRQ index 0 not found`,`/dev/tee0` 不出现。**板子上同理。** 3. **平台名是 `PLATFORM=zynq7k`**,不是 `zynq`(后者报 `plat-zynq/sub.mk: No such file`)。 4. **Rust 工具链版本以 SDK 的 `rust-toolchain.toml` 为准**(当前 `nightly-2026-08-05`)。 网上文档写的 2024-05 已过时,会报 `feature edition2024 is required`。 另外 SDK 自带的 `cargo-optee` 工具本身编不过,**直接用 `cargo build`**,然后手工补 `dyn_list`。 5. **构建机上的 `python3` 必须是系统 python3**(带 `cryptography` / `pyelftools`)。 很多镜像 `/usr/local/bin/python3` 是另一个,会报 `ModuleNotFoundError: cryptography`。 → `PYTHON3=/usr/bin/python3`。 --- ## vault:密钥托管,不用等板子 ```sh bash build/vault_selftest_host.sh # 2 秒:16 个用例 + 「两台设备互相解不开」 SRC=/root/src bash build/p1_vault_qemu.sh # 15 分钟:QEMU 全链 → VAULT_ALL_OK ``` 做的事:`K_device = HKDF(K_root, Device DNA ‖ USER eFuse)`,AES-256-GCM 密封, `K_root` 只在 TA 内存与 secure storage 里出现;普通世界拿到的只有 blob,且旧 blob 会被判回滚。 它**不解决**内核被替换(L3)—— 换掉 `zImage` 的攻击者仍能调用 TA 的合法接口。 详见 `docs/07-VAULT-TA.md`(含"已验证 / 未验证"清单)。 ## 从哪开始做板子 先读 **`docs/05-BOARD-ACTIONS.md`**,按 §0 把六个先决条件过一遍。最关键的两条: - **内核源码 + DTS 拿不拿得到?** 拿不到就做不了(开 OP-TEE 必须重编内核)。 - **用哪块板?** `.233` 是生产网关(别碰),`.234` 的 SD 卡已坏(先换卡)。 然后按 P1(OP-TEE 起来)→ P2(内存划分)→ P3(内核+用户态)→ P4(Rust TA)→ P5(DEK 下沉)推进。 **Zynq 上没有 ATF**:A9 无虚拟化扩展,OP-TEE 自己就是 secure monitor,跑 Monitor 模式。 QEMU 那套 ATF(BL1/BL2/BL31) + BL32 的启动链**不能照搬**。 --- ## 注意 - `artifacts/` 里的 TA/CA 是 **armv7 + 开发签名**,只能用于验证;量产换自己的密钥, 且要把 TA 签名公钥编进 `tee.bin`,否则攻击者可以换 TA。 - 令牌/凭据不落盘:`csbx.py` 把 sandbox token 写到 `/tmp/cube_sbx.json`,用完 `down` 即删。 - 三个 eFuse 位(`AES_ONLY` bit8 / `BBRAM_KEY_DISABLE` bit10 / `JTAG_DIS` bit9)**不可逆**, 顺序在 `docs/06` 里;**`JTAG_DIS` 必须最后烧**,否则 PL eFuse 永久改不了。