📚 课程目录第1章 Renode入门

1. Renode入门：从零认识这个嵌入式仿真利器

我第一次接触Renode，是在一个多芯片协同项目的调试阶段。那时候硬件还没回来，驱动代码却已经堆了一大堆。说实话，心里挺没底的——没有硬件，怎么验证？后来团队引入了Renode，这个问题才算真正解决。

Renode是什么？简单说，它是一个开源的嵌入式系统仿真框架。你可以在PC上模拟出一块完整的开发板，包括CPU、外设、中断控制器、GPIO、UART，甚至多个芯片互联。而且，它跑的是你编译好的真实二进制文件——不是抽象模型，是实实在在的ARM、RISC-V指令。

  核心要点： Renode不是模拟器，是仿真器。模拟器解释指令，仿真器模拟整个硬件系统。你的驱动代码在Renode上跑，跟在真实芯片上跑，行为几乎一致。

1.1 Renode的架构与核心概念

Renode的架构，我习惯把它分成三层来看：

仿真引擎层——负责CPU指令翻译、时间同步、外设事件调度。这是Renode的心脏。
外设模型层——用C#写的各种外设模型，比如UART、SPI、I2C、GPIO、定时器。每个模型都实现了真实硬件的寄存器行为。
平台描述层——通过RPL（Renode Platform Language）脚本，把CPU、外设、内存、中断线连接起来，组成一个完整的“虚拟开发板”。

你想想看，这三层分工非常清楚。引擎层只管“怎么跑”，模型层只管“外设长什么样”，描述层只管“怎么拼”。我在项目中遇到过最头疼的问题，就是外设模型和真实芯片的寄存器偏移对不上。后来我养成了一个习惯：每次建新平台，先对照数据手册，把外设基地址和中断号在RPL里逐条核对一遍。

1.2 核心概念速览

刚开始用Renode时，有几个概念容易混淆。我整理了一张表，你对照着看会清楚很多：

概念	说明	我的一点经验
Machine	一个虚拟的SoC实例，包含CPU、内存、外设	一个Machine就是一个“芯片”，多芯片项目就开多个Machine
Platform	描述Machine的RPL脚本文件	我习惯把Platform文件按芯片型号命名，方便复用
Peripheral	外设模型，比如UART、GPIO	外设模型可以热插拔，调试时特别方便
Repl	Renode的交互式命令行	我最常用的调试入口，直接读写寄存器
Robot	自动化测试框架集成	故障注入测试全靠它，后面章节会细讲

小技巧： 刚上手时，别急着写复杂Platform。先用Renode自带的demo平台跑一遍，比如demo-platforms/boards/stm32f4_discovery.repl。跑通了，再改自己的。

1.3 Renode的安装与配置

安装Renode，其实比你想的简单。我个人推荐用官方打包好的二进制版本，省去编译的麻烦。当然，如果你喜欢从源码构建，也完全支持。

方式一：二进制安装（推荐）

# Linux (Ubuntu/Debian)
wget https://github.com/renode/renode/releases/latest/download/renode_1.14.0_amd64.deb
sudo dpkg -i renode_1.14.0_amd64.deb

# macOS
brew install renode

# Windows
# 直接下载 .msi 安装包，双击安装

安装完成后，在终端输入 renode，就能看到交互式命令行界面。嗯，这里要注意：第一次启动可能会慢一点，因为Renode要加载一些默认的CPU模型和外设库。

方式二：从源码构建

如果你需要定制化修改，或者想深入理解Renode内部，那就从源码构建：

git clone https://github.com/renode/renode.git
cd renode
./build.sh
# 构建完成后，运行：
./renode.sh

我曾经在源码构建上踩过一个坑：Mono版本不对，编译到一半报错。后来我统一用.NET 6 SDK，再也没出过问题。建议你也用这个版本。

验证安装

装好了，怎么确认没问题？跑一个最简单的测试：

# 在Renode交互界面输入：
(machine-0) mach create
(machine-0) machine LoadPlatform @demo-platforms/boards/stm32f4_discovery.repl
(machine-0) sysbus.uart0 WriteDoubleWord 0x0 0x55
(machine-0) sysbus.uart0 ReadDoubleWord 0x0

如果能正常读写寄存器，说明安装成功。我每次在新机器上配环境，都用这个命令验证，又快又准。

避坑指南： 我曾经在Windows上遇到路径包含中文导致Renode无法加载Platform的问题。解决方案很简单：把工程路径全部改成英文。另外，Renode对权限有要求，Linux下建议用普通用户运行，不要用sudo。

1.4 目录结构说明

安装完成后，Renode的目录结构大致如下。我标注了几个你一定会用到的目录：

目录/文件	用途	备注
`bin/`	可执行文件和启动脚本	入口在这里
`scripts/`	Robot测试脚本和辅助工具	故障注入测试的核心战场
`platforms/`	各种开发板的RPL描述文件	参考这些文件写你自己的Platform
`tests/`	官方测试用例	学习怎么写测试的好材料

我个人习惯把自定义的Platform文件和测试脚本单独放在一个目录里，比如 my_workspace/，不和官方文件混在一起。这样升级Renode时，不会覆盖自己的东西。

1.5 第一个仿真：点亮一颗LED

理论说完了，来点实际的。我们用Renode仿真STM32F4 Discovery板，点亮板载LED。这是嵌入式世界的“Hello World”。

# 1. 启动Renode
renode

# 2. 创建Machine并加载平台
(machine-0) mach create
(machine-0) machine LoadPlatform @demo-platforms/boards/stm32f4_discovery.repl

# 3. 查看外设列表
(machine-0) peripherals

# 4. 模拟GPIO输出（点亮LED）
(machine-0) sysbus.gpioE WriteDoubleWord 0x14 0xFF00

# 5. 观察仿真窗口
# 如果GUI打开了，你会看到LED亮起

你可能会问：为什么是 0x14 和 0xFF00？0x14 是GPIO的BSRR寄存器偏移，0xFF00 表示设置PE8~PE15引脚为高电平——这些引脚正好连着板载LED。说白了，这就是在模拟驱动代码里写寄存器的操作。

  关键理解： Renode仿真的是“寄存器行为”，不是“电气行为”。你写寄存器，外设模型响应，LED模型改变颜色。驱动代码在真实芯片上也是这么干的——写寄存器，硬件响应。所以，驱动代码在Renode上跑的逻辑，和真实硬件完全一致。

好了，第一章的内容就到这里。你已经知道了Renode是什么、它的三层架构、核心概念，以及怎么安装和跑第一个仿真。这些基础打牢了，后面讲故障注入和驱动健壮性测试时，你才不会觉得飘。