1. 课程导入
在嵌入式安全领域，ARM TrustZone 已经成为从智能终端、车规 MCU 到工业网关的主流隔离底座。它把一颗芯片划分为安全世界（Secure World）与非安全世界（Normal World），通过硬件级的地址空间、中断、外设与总线访问控制，让敏感资产与普通业务在同一硅片上共存而不互相污染。但真正落地时，工程师遇到的难点往往不是"TrustZone 是什么"，而是"安全世界与非安全世界如何可靠地互相调用、传递数据、共享外设，并保证整个链路可验证、可调试、可量产"。本课程正是围绕这条工程主线展开。
学习目标：从概念到可交付系统
完成本课程后，你应当具备四项可验证的能力。第一，能画出目标 SoC 的 TrustZone 安全边界图，明确哪些内存、外设、中断、DMA 通道归属安全域。第二，能独立实现一条安全调用链路，包括非安全侧发起、SMC 陷入、安全侧分发、参数校验、结果回传。第三，能设计跨域通信机制，在共享内存、消息队列、邮箱中断之间做出合理取舍，并处理并发与缓存一致性。第四，能对整条链路做安全复盘，识别参数污染、TOCTOU、重放、权限提升等典型风险。
核心概念：五个必须建立的心智模型
- 世界切换（World Switch）：通过 SMC/HVC 指令或中断触发，CPU 在安全态与非安全态之间切换，伴随寄存器上下文与栈的隔离。
- 安全边界（Security Boundary）：由 SAU/IDAU、TZASC、TZPC、MPU 等硬件单元共同定义的访问控制面，是信任的物理起点。
- 安全调用（Secure Call）：非安全侧请求安全服务的唯一受控入口，典型形态是 SMC 调用号加参数寄存器。
- 跨域通信（Cross-domain Communication）：两个世界之间的数据交换通道，常见为共享内存加中断通知，或专用邮箱外设。
- 可信服务（Trusted Service）：运行在安全侧、对外提供受控能力的逻辑单元，如密钥管理、安全存储、加解密、身份认证。
这五个概念构成一条因果链：硬件边界决定谁能访问什么，世界切换提供进入安全侧的通道，安全调用是通道上的协议，跨域通信是协议承载的数据面，可信服务是最终被保护与暴露的能力集合。理解这条链，比记住任何单个寄存器都重要。
方法流程：一条安全调用的标准生命周期
把安全调用拆成可复用的阶段，是工程化的第一步。下面给出一个与具体芯片无关的通用流程，后续章节会逐层替换为真实寄存器与代码。
- 请求构造：非安全侧客户端准备调用号、参数指针、长度、会话标识，写入约定寄存器或共享内存描述符。
- 陷入与切换：执行 SMC 指令，CPU 进入安全态，保存非安全上下文，跳转到安全侧入口。
- 入口校验：检查调用号合法性、参数地址是否落在允许的共享区、长度是否越界、会话是否有效。
- 服务分发：按调用号路由到具体可信服务，必要时做权限与策略判定。
- 执行与数据搬运：在安全侧完成密钥操作、加解密或安全存储访问，必要时通过共享内存回写结果。
- 结果回传与返回：写入返回码与输出长度，清理临时缓冲，执行返回指令回到非安全态。
这条流程的关键在于：校验必须发生在数据被信任之前。很多真实漏洞并非算法被攻破，而是安全侧直接信任了非安全侧传入的指针或长度。
案例场景：安全存储读写调用
假设一个车规网关需要把设备证书写入安全存储，非安全侧应用只持有句柄，不接触明文密钥。典型调用约定如下：
/* 非安全侧客户端伪代码 */
uint32_t handle;
uint8_t cert_buf[512];
smc_args_t args = {
.func_id = SMC_SECSTORE_WRITE,
.arg0 = (uint32_t)(uintptr_t)cert_buf,
.arg1 = sizeof(cert_buf),
.arg2 = SLOT_DEVICE_CERT,
};
smc_call(&args, &handle);
if (args.ret != SEC_OK) {
log_error("secure store write failed: 0x%x", args.ret);
}安全侧收到后，先确认 cert_buf 落在预注册的共享内存窗口内，再校验长度不超过槽位上限，随后调用安全存储服务完成写入，并把句柄通过输出参数返回。整个过程非安全侧无法读取密钥材料，只能拿到一个不可伪造的引用。
常见误区与复盘清单
| 误区 | 后果 | 纠正做法 |
|---|---|---|
| 安全侧直接解引用非安全指针 | 任意地址读写、权限提升 | 只接受共享内存描述符，入口做范围校验 |
| 忽略缓存一致性 | 读到旧数据或半写数据 | 明确 clean/invalidate 时机与内存属性 |
| 用全局变量传递跨域数据 | 并发竞争、状态串扰 | 每会话独立上下文，加锁或原子操作 |
| 只测正常路径 | 异常输入导致安全侧崩溃 | 对长度、空指针、越界、重放做负向测试 |
| 调试口未鉴权 | 绕过全部安全边界 | 量产配置关闭或鉴权安全调试 |
实战路线图
本课程按"边界—调用—通信—验证"四段推进。先建立硬件安全边界与启动链认知，再实现最小可用的 SMC 安全调用，随后引入共享内存与中断完成跨域通信，最后用故障注入与负向测试做安全复盘。每一章都会给出可运行的代码骨架、寄存器配置片段与验证方法，确保你不仅理解原理，还能在自己的目标板上复现。