📚 课程目录第2章 Renode模拟器入门

Renode模拟器入门：安装、配置与第一个虚拟平台

说实话，我第一次接触Renode时，心里是有点抵触的。做嵌入式这么多年，习惯了QEMU和硬件调试器，总觉得多一个模拟器就是多一个麻烦。但后来在一个多核ARM项目里，硬件板子还没回来，软件deadline已经压到眼前了——Renode硬是帮我把驱动调通了七七八八。嗯，从那以后，我的工具箱里就永远给它留了个位置。

这一章，咱们就从头开始，把Renode装好、跑起来，再亲手搭一个能用的虚拟平台。别怕，整个过程不会超过半小时。

2.1 安装与配置

Renode的安装方式很灵活。我个人习惯用官方提供的包管理器安装，干净、好卸载。当然，你也可以从源码编译，但说实话，除非你要改模拟器内核，否则没必要折腾自己。

2.1.1 系统要求

项目	最低要求	推荐配置
操作系统	Ubuntu 20.04 / macOS 11 / Windows 10	Ubuntu 22.04 LTS
CPU	双核 x86_64	4核以上（多核仿真时优势明显）
内存	4 GB	8 GB（跑复杂SoC时建议16 GB）
磁盘	2 GB 空闲	10 GB（存放多个平台镜像）
.NET	.NET 6.0 SDK	.NET 8.0 SDK

我曾经踩过的坑：在Windows上用WSL2跑Renode，USB设备映射总是断断续续。后来我干脆切到原生Ubuntu，世界清净了。如果你主力机是Windows，建议装个双系统或者直接用虚拟机跑Ubuntu。

2.1.2 安装步骤（以Ubuntu为例）

安装.NET SDK
Renode基于C#开发，需要.NET运行时。执行以下命令：

# 添加Microsoft包仓库
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt update

# 安装.NET 8.0 SDK
sudo apt install dotnet-sdk-8.0

# 验证安装
dotnet --version

安装Renode
官方提供了deb包和Linux portable版本。我推荐用portable版，不污染系统目录：

# 下载最新portable版本
wget https://github.com/renode/renode/releases/latest/download/renode-latest-portable.tar.gz

# 解压到指定目录
mkdir -p ~/tools/renode
tar -xzf renode-latest-portable.tar.gz -C ~/tools/renode

# 添加环境变量
echo 'export PATH=$PATH:~/tools/renode' >> ~/.bashrc
source ~/.bashrc

# 验证安装
renode --version

安装依赖库
Renode在Linux上需要GTK#和libusb：

sudo apt install gtk-sharp3 libusb-1.0-0-dev

小技巧：安装完成后，运行 renode --help 看看所有命令行选项。我个人习惯把常用平台的.repl文件放在 ~/renode_platforms/ 目录下，方便复用。

2.2 基本命令行操作

Renode的交互方式很有意思——它用Mona脚本语言作为控制台。你想想看，一个模拟器居然有自己的脚本语言，这本身就说明它的可编程性很强。

2.2.1 启动与退出

# 启动Renode（带图形界面）
renode

# 启动Renode（纯命令行模式，适合脚本自动化）
renode --console

# 退出
(mona) quit

纯命令行模式是我最常用的。为什么？因为可以写脚本批量跑测试，不用盯着GUI看。

2.2.2 核心命令速查

命令	作用	示例
`machine create`	创建新机器实例	`machine create "my_board"`
`machine LoadPlatformDescription`	加载平台描述文件(.repl)	`machine LoadPlatformDescription @platforms/boards/stm32f4_discovery.repl`
`sysbus`	查看系统总线上的外设	`sysbus`
`cpu`	查看/控制CPU状态	`cpu PC` 查看程序计数器
`log`	设置日志级别	`logLevel -1` 显示所有日志
`start`	启动仿真	`start`
`pause`	暂停仿真	`pause`
`showgui`	显示外设的图形化窗口	`showgui`

  核心思路：Renode的操作流程可以概括为三步——创建机器 → 加载平台 → 加载程序并运行。记住这个流程，后面所有章节都围绕它展开。

2.2.3 加载与运行程序

# 加载ELF文件（支持符号调试）
machine LoadELF @/path/to/your/firmware.elf

# 加载二进制文件（裸机程序）
machine LoadBinary @/path/to/your/program.bin 0x08000000

# 设置断点
cpu SetBreakpoint 0x08000100

# 单步执行
cpu Step

# 查看寄存器
cpu Registers

我在项目中遇到过一个问题：加载ELF后，程序跑起来但串口没输出。后来发现是Renode的UART模型默认没连到终端。解决办法很简单——加一句 showgui 把UART窗口调出来，或者用 uart Connect 重定向到主机串口。

2.3 创建第一个虚拟平台

理论说完了，咱们动手。下面我带你创建一个最简单的虚拟平台：一个Cortex-M3内核，带UART和GPIO。你想想看，这其实就是一块最小系统的软件模型。

2.3.1 编写平台描述文件（.repl）

Renode使用REPL（Renode Platform Language）来描述硬件。语法很直观，就是声明外设和它们的地址映射。

// my_first_platform.repl
// 一个简单的Cortex-M3虚拟平台

using "cortex-m"

cpu:
    CPU: CortexM @ sysbus
        cpuType: "cortex-m3"
        frequency: 72000000

sysbus:
    // 系统定时器
    systick: Timer @ 0xE000E010
        frequency: 72000000

    // UART1
    uart1: UART @ 0x40013800
        -> uart1_irq: 37

    // GPIOA
    gpioa: GPIO @ 0x40020000
        -> gpioa_irq: 0

    // 内存
    flash: Memory.MappedMemory @ 0x08000000
        size: 0x100000  // 1 MB

    ram: Memory.MappedMemory @ 0x20000000
        size: 0x20000   // 128 KB

避坑指南：地址一定要和芯片手册一致。我曾经把UART基地址写错了一个字节，结果仿真时数据全乱码。查了整整一下午才发现是地址偏移了一位。

2.3.2 启动虚拟平台

# 在Renode控制台中执行
machine create "my_first_board"
machine LoadPlatformDescription @my_first_platform.repl

# 查看外设列表
sysbus

# 加载一个简单的测试程序（假设已编译好）
machine LoadELF @test_blink.elf

# 启动仿真
start

如果一切正常，你会看到CPU开始执行指令。用 showgui 可以打开UART和GPIO的图形窗口，观察外设行为。

2.3.3 验证平台是否工作

我习惯用一个小循环来验证：让GPIOA的PIN0每隔1秒翻转一次。在Renode里，你可以用 gpioa 命令直接查看引脚状态：

# 查看GPIOA所有引脚状态
gpioa

# 如果程序正确，你应该看到Pin 0在0和1之间周期性变化

注意：Renode的GPIO模型默认是推挽输出。如果你的程序配置了开漏或复用功能，记得在.repl文件中添加对应的配置参数。否则仿真行为会和真实芯片不一样。

2.4 本章知识结构

下面这张图帮你梳理了Renode入门的核心脉络。我画图时习惯把「安装」和「配置」放在最底层，因为它们是基础；「命令行操作」是日常使用频率最高的；「创建虚拟平台」则是最终目标。

嗯，到这里，你已经完成了Renode的安装、学会了基本命令，并且亲手创建了第一个虚拟平台。这个平台虽然简单，但麻雀虽小五脏俱全——CPU、内存、UART、GPIO都有了。后面的章节，我们会在这个基础上不断加料，让它越来越接近真实的开发板。