1. Renode仿真环境搭建与基础操作
各位同学，咱们直接进入正题。Renode这个工具，说白了就是一个开源的嵌入式仿真框架。它厉害的地方在于——不仅能仿CPU，还能仿整个板子上的外设。我最早接触它是在做一个多核ARM项目的时候，当时硬件还没回来，全靠Renode提前把驱动调通了。
好，这一章我们先把环境搭起来，跑通第一个仿真。后面所有故障注入和稳定性测试，都建立在这个基础上。
1.1 安装Renode
安装方式其实挺灵活的。我个人习惯用官方提供的包管理器安装，干净利落。当然你也可以从源码编译，但第一次接触的话，我建议直接用二进制包。
Linux环境（Ubuntu 20.04/22.04）
# 添加Renode官方仓库
wget -qO- https://renode.io/renode.gpg | sudo apt-key add -
echo "deb https://renode.io/linux/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/renode.list
# 安装
sudo apt update
sudo apt install renode
Windows环境
去GitHub Releases页面下载最新的.msi安装包。双击安装，一路Next就行。嗯，这里要注意——安装路径不要带中文和空格，否则后面跑脚本会出一些莫名其妙的错误。我曾经帮一个同事排查了半天，最后发现是路径里有个“项目”两个字。
macOS环境
brew tap renode/renode
brew install renode
renode --version 确认安装成功。如果看到版本号，说明基础环境没问题。
1.2 配置环境变量
Renode安装后，可执行文件默认在系统PATH里。但有几个环境变量我建议你手动配一下，后面做故障注入脚本时会省很多事。
| 环境变量 | 说明 | 推荐值 |
|---|---|---|
RENODE_ROOT |
Renode安装根目录 | /opt/renode 或安装路径 |
RENODE_SCRIPTS |
自定义脚本存放路径 | $HOME/renode_scripts |
RENODE_PLATFORMS |
自定义平台描述文件路径 | $HOME/renode_platforms |
配好之后，记得 source ~/.bashrc 或者重启终端。你想想看，如果每次都要输绝对路径调用脚本，那得多烦？
1.3 理解仿真架构
在跑第一个仿真之前，咱们先搞清楚Renode到底是怎么工作的。说白了，它分三层：
- 机器层（Machine）：模拟一块完整的开发板，包含CPU、内存、外设。
- 外设层（Peripheral）：每个外设都是一个独立的C#类，比如UART、GPIO、SPI。
- 平台描述层（Platform Description）：用.repl文件把机器和外设组装起来。
我刚开始用的时候，总以为Renode和QEMU差不多。其实区别很大——QEMU偏重CPU指令模拟，Renode更关注整个系统的可调试性和可注入性。这也是为什么我们选它来做故障注入。
1.4 启动第一个仿真平台
理论说完了，咱们动手。我选一个最经典的平台——STM32F4 Discovery 来演示。Renode官方仓库里已经带了这个板子的.repl文件。
步骤1：启动Renode Monitor
renode
你会看到一个命令行界面，这就是Renode的Monitor。所有操作都在这里输入。
步骤2：加载平台描述
(monitor) mach create "stm32f4"
(monitor) machine LoadPlatformDescription @platforms/boards/stm32f4_discovery.repl
这里 @ 符号表示从Renode内置的搜索路径加载文件。如果你有自己的.repl文件，可以用绝对路径。
步骤3：加载固件
(monitor) sysbus LoadELF @/path/to/your/firmware.elf
LoadBinary 命令，并且要指定加载地址。我曾经在这里卡了半小时，因为忘了给bin文件指定地址。
步骤4：启动仿真
(monitor) start
看到CPU开始跑了吧？你可以用 pause 暂停，用 showAnalyzer sysbus.uart 打开串口终端。
1.5 验证仿真是否正常工作
怎么确认仿真真的在跑？我一般用两个方法：
- 看CPU执行计数：在Monitor里输入
cpu ExecutedInstructions，如果数字在增长，说明CPU在干活。 - 看串口输出：如果固件有打印，用
showAnalyzer sysbus.uart打开终端，应该能看到日志。
避坑指南： 我曾经遇到过仿真启动后CPU计数不动的情况。后来发现是.repl文件里CPU类型配置错了——我用的Cortex-M4，但文件里写的是Cortex-M3。Renode不会报错，但指令集不兼容，CPU直接卡在第一条指令。
1.6 常用Monitor命令速查
| 命令 | 作用 | 示例 |
|---|---|---|
mach create |
创建新机器实例 | mach create "myboard" |
machine LoadPlatformDescription |
加载板级描述文件 | machine LoadPlatformDescription @path/file.repl |
sysbus LoadELF |
加载ELF固件 | sysbus LoadELF @firmware.elf |
start |
启动仿真 | start |
pause |
暂停仿真 | pause |
showAnalyzer |
打开外设分析器 | showAnalyzer sysbus.uart |
cpu ExecutedInstructions |
查看已执行指令数 | cpu ExecutedInstructions |
这些命令够你起步了。后面章节我们会深入每个命令的细节，尤其是故障注入相关的扩展命令。
1.7 本章小结
好，到这儿我们把Renode的环境搭好了，也跑通了第一个仿真。你想想看，整个过程其实不复杂——安装、配环境、加载平台、跑固件。但这一步是后面所有工作的地基。
我个人建议你多试几个不同的板子，比如 zynq7000 或者 riscv_virt，感受一下不同架构的仿真差异。只有亲手踩过坑，后面做故障注入时才不会手忙脚乱。