第3章 前置条件与验证环境准备：硬件模拟器配置、固件编译工具链、调试接口设置

适用场景

• 项目启动阶段：为新的 SoC 项目搭建标准化的固件-硬件协同验证环境。
• 环境重构期：现有验证环境缺乏统一的模拟器配置、编译流程或调试接入规范。
• 版本切换时：RTL 版本升级或地址映射变更后，需要同步更新验证前置条件。

前置条件

操作步骤

1. 硬件模拟器配置
   • 创建模拟快照目录 snapshots/<tag_name>。
   • 链接目标 GCC 运行时库（libgcc.a）至模拟器 lib 目录。
   • 应用平台特定修复补丁（如 patches/sim_fix_v3.patch）。

   # 构建模拟器可执行文件
   make -f sim.makefile build_sim TARGET_SOC=chip_v2
   # 运行初始化快照
   ./simv -snapshot ch3_init -l sim_init.log

2. 固件编译工具链
   • 安装交叉编译器并验证版本：riscv64-unknown-elf-gcc -v。
   • 创建项目级 CMake 工具链文件 toolchain.cmake。
   • 编写链接脚本 soc.lds，严格对齐地址映射 CSV。

   # CMake 工具链文件关键内容
   set(CMAKE_SYSTEM_NAME Generic)
   set(CMAKE_C_COMPILER   riscv64-unknown-elf-gcc)
   set(CMAKE_CXX_COMPILER riscv64-unknown-elf-g++)
   set(CMAKE_ASM_COMPILER riscv64-unknown-elf-as)
   set(LINKER_SCRIPT "${CMAKE_SOURCE_DIR}/lds/soc.lds")

3. 调试接口设置
   • 配置 JTAG/SWD TAP 控制器（选择 jtag_v2 或 swd_fast 拓扑）。
   • 设置 GDB 服务器监听端口（默认 :3333）。
   • 编写 .gdbinit 自动加载符号并复位目标。

   # GDB 服务器启动命令
   openocd -f interface/ftdi.cfg -f target/soc_chip.cfg -c "bindto 0.0.0.0"
   
   # GDB 客户端连接初始化
   target remote localhost:3333
   monitor reset halt
   load firmware.elf
   monitor reg pc

4. 集成验证
   • 使用 make -j4 编译固件，确认二进制大小符合预期。
   • 将固件加载至模拟器内存模型，运行 run 1000 条指令。
   • 通过 GDB 读取 SoC 控制状态寄存器，验证内存映射读回正确。

责任边界

记录材料

• sim_init.log：模拟器启动日志，确认无致命 UVM 错误。
• compile_test.log：工具链编译测试日志，确认 firmware.elf 内存布局正确。
• gdb_connect.log：调试接口连接日志，记录 monitor reset halt 返回状态。

验收标准

1. 环境可复现： 按步骤新建空目录，可从零完整复现模拟器启动、固件编译、调试连接全流程。
2. 功能正确性：
   • 启动模拟器后，固件 firmware.elf 可加载至地址映射起始点。
   • GDB target remote :3333 在 5 秒内建立连接。
   • monitor reg pc 返回值等于复位向量 0x80000000（依据具体 SoC 设计）。
3. 文档闭环： 上述输入输出物、记录材料均归档至项目共享目录 //server/proj/ch3_env_prep/，并附带 README.md。