Copyright (c) 2010-2026 Antmicro
Renode 由 Antmicro 创建,是一款面向多节点嵌入式网络(有线和无线)的虚拟开发工具,旨在为构建高效、经过测试且安全的 IoT 系统提供可扩展的工作流。
借助 Renode,为 IoT 设备开发、测试、调试和模拟未经修改的软件变得快速、经济且可靠。
支持的架构包括:
Renode 的创建基于多年来在嵌入式系统软件开发方面的经验——涵盖网关、板载计算机,以及传感器节点和微控制器。
由于可复现性差且缺乏对系统当前状态的洞察,尤其是在多节点场景下,测试和开发物理嵌入式系统十分困难。
Renode 通过让你在虚拟板或板卡系统上运行未经修改的二进制文件来解决这一问题,这些二进制文件与你通常烧录到目标硬件上的完全相同。
该工具的一个重要特点是,它不仅模拟 CPU,还模拟整个 SoC(例如异构多核 SoC 和各种外设)以及它们之间的有线或无线连接,使用户能够应对复杂场景并测试真实的生产软件。
适用于所有系统的 Renode 每日构建可在 builds.renode.io 获取。
最新构建始终以 renode-latest.* 包的形式提供。
可用的包格式如下:
renode-latest.linux-portable.tar.gz - 便携式 Linux 包,内嵌 dotnet 运行时renode-latest.linux.tar.gz - Linux 预构建归档,需要主机上安装 dotnetrenode-latest.pkg.tar.xz - Arch Linux 包renode-latest.x86_64.rpm - Red Hat / Fedora 包renode-latest.deb - 基于 Debian 的发行版包renode-latest.osx-arm64-portable.dmg - 适用于 Apple Silicon(arm64)Mac 的 macOS 包renode-latest.windows-portable.zip - Windows 便携式包,不含安装程序renode-latest.setup.exe - Windows 安装程序renode-latest.tar.xz - Renode 源代码稳定的编号版本及其发行说明可在 GitHub 的 Releases 部分 获取。
在 macOS 上,稳定版和每日构建版的 Renode 均可通过 Homebrew 从我们的自定义 tap 安装。
要安装稳定版,请使用 brew install renode/tap/renode,或使用 brew install renode/tap/renode-nightly 安装最新的每日构建。
这将安装所有依赖项,包括为 renode-test 预配置 Python 环境
如果你是 Linux 用户,使用 Renode 最简单的方法是从 releases 部分 下载最新的 linux-portable 并使用以下命令解压:
mkdir renode_portable
wget https://builds.renode.io/renode-latest.linux-portable.tar.gz
tar xf renode-latest.linux-portable.tar.gz -C renode_portable --strip-components=1
要在任意位置使用它,请进入已创建的目录并将其添加到系统路径中:
cd renode_portable
export PATH="`pwd`:$PATH"
请注意,便携包需要主机上提供 GTK2 才能以启用 UI 的方式运行。
如果你希望使用 Robot Framework 进行测试,请遵循 Additional Prerequisites 部分。 否则,请继续前往“Running Renode”部分。
Renode 需要 dotnet >= 10.0。
要安装 dotnet,请遵循官方安装指南。
在 Ubuntu 20.04 上,你可以使用以下命令安装其余依赖项:
sudo apt-get install policykit-1 libgtk2.0-0 screen uml-utilities gtk-sharp2 libc6-dev libicu-dev gcc python3 python3-pip
如果你使用的是其他发行版,则需要使用你的包管理器安装类似的软件包列表;请注意,软件包名称可能略有不同。
前往本仓库的发布区,下载适合你系统的软件包。
使用提供的 *.deb、*.rpm 或 *.pkg.tar.xz 软件包,通过你偏好的包管理器安装 Renode。
像平常一样使用提供的 *.dmg。
此外,要在 macOS 上从命令行使用 Renode,请根据你使用的 shell,将 alias renode='/Applications/Renode.app/Contents/MacOS/renode' 和 alias renode-test='/Applications/Renode.app/Contents/MacOS/renode-test' 添加到你的 .bashrc 或 .zshrc 文件中,以创建相应的别名。
从提供的 *.msi 文件安装 Renode。安装程序允许你向桌面和/或开始菜单添加图标,并向 PATH 添加一个条目。
为了编写和运行测试用例,Renode 集成了 Robot 测试框架。
这要求你安装 Python 3(在 Windows 上,你还需要 Cygwin——参见高级安装说明)以及 pip(请注意,在 Linux 上相关软件包可能名为 python-pip 或 python3-pip)。
安装好 Python 3 和 pip 后,安装额外的模块:
python3 -m pip install -r tests/requirements.txt
此外,/tools 子目录中的每个工具都可能包含一个独立于 Renode 依赖的 requirements.txt 文件。
在虚拟环境中使用 pip install -r requirements.txt 安装它们。
有关从源码构建 Renode 的信息,请参阅文档。
按照上述从软件包安装的说明操作后,你应该可以在系统范围内使用 renode 命令:
renode [flags] [file]
如果你是从源码构建的,请导航到相关目录并使用:
./renode [flags] [file]
可选的 [file] 参数允许你提供启动时要运行的脚本路径。
该脚本支持多个可选标志,下面列出了其中最常用的几个:
-p Remove steering codes (e.g., colours) from output
-P INT32 Instead of opening a window, listen for Monitor commands on the specified port
-e COMMAND Execute command on startup (executed after the optional script). May be used multiple times
--console Run the Monitor in the console instead of a separate window
--disable-gui Disable XWT GUI support. It automatically sets HideMonitor
--hide-monitor Do not show the Monitor window
--hide-log Do not show log messages in console
--hide-analyzers Do not show analyzers
-v Print version and exit
-h Display help and usage information
Renode 可以在 Windows 系统上运行,并支持一组类似的可选参数。
下面展示了在模拟硬件上运行的一段固件。 Renode Monitor 与一个显示 UART 输出和日志记录器的分析器窗口并排可见。 有关此特定设置的更多信息,请参阅其专用仓库。
renode-run 是一个 Python 脚本,可下载并运行 Renode,让你轻松运行 Renodepedia 中提供的演示以及本地 ELF 文件。
请前往该仓库查看使用说明。
renode-run 依赖于便携式软件包,其主要优势是可以通过单条命令轻松将 Renode 更新到最新的 nightly 构建。
pyrenode3 是一个用于以编程方式与 Renode 交互的 Python 库。
请前往该仓库查看使用说明。
如果你想在 Docker 中运行 Renode,可以使用 Docker Hub 上提供的预构建镜像。
假设你的系统已安装 Docker,要在 Linux 上以交互模式启动 Renode,请运行以下命令之一:
docker run -ti -e DISPLAY -v $XAUTHORITY:/home/developer/.Xauthority --net=host antmicro/renode:latest
docker run -ti -e DISPLAY -v $XAUTHORITY:/home/developer/.Xauthority --net=host antmicro/renode:nightly-dotnet
这将显示 Renode Monitor 窗口。 或者,你可以在上述命令行的末尾提供自定义命令。
要在不传递 X server 的情况下以控制台模式运行镜像,请运行:
docker run -ti antmicro/renode bash
你可以向命令中添加更多 -v 开关来挂载你自己的目录。
有关更多信息以及底层 Dockerfile,请访问 GitHub 上的仓库。
文档可在 Read the Docs 上获取。
Renode 在宽松的 MIT 许可证下发布。 有关详细信息,请参阅 LICENSE 文件。
我们乐于通过 GitHub 拉取请求 / 议题接受错误报告、功能请求和贡献。 有关详细信息,请参阅 CONTRIBUTING.md 文件。
Renode 的商业支持由 Antmicro 提供,该公司专门帮助其客户采用新的嵌入式技术和现代开发方法。
Antmicro 创建并维护 Renode 框架及相关工具,并乐于提供诸如添加新平台、集成、插件和工具等服务。
如需咨询我们的服务,请通过 [email protected] 联系我们。