
renode v1.17.0
マルチノードの組み込みシステムおよびIoTシステム向けに、未変更のソフトウェアを開発、テスト、デバッグするためのオープンソースシミュレーションフレームワーク。ARM、RISC-V、x86などをサポート。
Renode
Copyright (c) 2010-2026 Antmicro
Renodeとは?
Renodeは、マルチノードの組み込みネットワーク(有線・無線の両方)向けの仮想開発ツールとしてAntmicroによって作成され、効果的でテスト済みかつ安全なIoTシステムを構築するためのスケーラブルなワークフローを実現することを目的としています。
Renodeを使えば、IoTデバイス向けの未改変のソフトウェアを迅速かつ低コスト、そして信頼性高く開発、テスト、デバッグ、シミュレーションできます。
対応アーキテクチャには以下が含まれます:
- ARMv7およびARMv8 Cortex-A、Cortex-R、Cortex-M
- x86およびx86_64
- RISC-V
- SPARC
- POWER
- Xtensa
- MSP430X
Renodeを使う理由
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用ビルド済みアーカイブ、ホストにdotnetのインストールが必要renode-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セクションで入手できます。
homebrew tapからのインストール
macOSでは、Renodeの安定版とナイトリー版の両方を、独自のtapからHomebrewを使ってインストールできます。
安定版をインストールするにはbrew install renode/tap/renodeを、最新のナイトリービルドにはbrew install renode/tap/renode-nightlyを使用してください。
これにより、renode-test用のPython環境の事前設定を含む、すべての依存関係がインストールされます。
Linuxポータブルリリースの使用
Linuxユーザーの場合、Renodeを使う最も簡単な方法は、リリースセクションから最新の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"
ポータブルパッケージをUI有効で実行するには、ホスト上にGTK2が利用可能である必要があることにご注意ください。
テストにRobot Frameworkを使用する場合は、追加の前提条件セクションに従ってください。 それ以外の場合は、「Renodeの実行」セクションに進んでください。
依存関係のインストール
dotnet
Renodeにはdotnet >= 10.0が必要です。
dotnetをインストールするには、公式インストールガイドに従ってください。
その他の依存関係(Linuxのみ)
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
別のディストリビューションを使用している場合は、お使いのパッケージマネージャーを使って同様のパッケージリストをインストールする必要があります。パッケージ名が多少異なる場合があることに注意してください。
パッケージからのインストール
このリポジトリのリリースセクションに移動し、お使いのシステムに適したパッケージをダウンロードしてください。
Linux
提供されている *.deb、*.rpm、または *.pkg.tar.xz パッケージを使用して、お好みのパッケージマネージャーで Renode をインストールしてください。
macOS
提供されている *.dmg を通常どおり使用してください。
さらに、macOS でコマンドラインから Renode を使用するには、使用しているシェルに応じて .bashrc または .zshrc ファイルに alias renode='/Applications/Renode.app/Contents/MacOS/renode' と alias renode-test='/Applications/Renode.app/Contents/MacOS/renode-test' を追加して、適切なエイリアスを作成してください。
Windows
提供されている *.msi ファイルから Renode をインストールしてください。インストーラーでは、デスクトップやスタートメニューにアイコンを追加したり、PATH にエントリを追加したりできます。
追加の前提条件
Robot Framework テスト
テストケースを記述して実行するために、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 とは別の requirements.txt ファイルが含まれている場合があります。
仮想環境にインストールするには、pip install -r requirements.txt を実行してください。
ソースからのビルド
Renode をソースからビルドする方法については、ドキュメントを参照してください。
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出力とロガーを表示するアナライザーウィンドウと並んで表示されています。 この特定のセットアップの詳細については、専用リポジトリを参照してください。
LinuxでRenodeを実行する代替方法
renode-run
renode-runは、Renodeをダウンロードして実行するPythonスクリプトであり、Renodepediaで利用可能なデモやローカルのELFファイルを簡単に実行できます。
使用方法についてはリポジトリを参照してください。
renode-runはポータブルパッケージに依存しており、その主な利点は、単一のコマンドでRenodeを最新のナイトリービルドに簡単に更新できることです。
pyrenode3
pyrenode3は、Renodeとプログラム的にやり取りするためのPythonライブラリです。
使用方法についてはリポジトリを参照してください。
DockerコンテナでのRenodeの実行
DockerでRenodeを実行したい場合は、Docker Hubで利用可能なビルド済みイメージを使用できます。
システムにDockerがインストールされていると仮定して、Linux上でRenodeをインタラクティブモードで起動するには、次のいずれかを実行します:
- 最新の番号付きバージョンビルドの場合:
docker run -ti -e DISPLAY -v $XAUTHORITY:/home/developer/.Xauthority --net=host antmicro/renode:latest - ナイトリーdotnetビルドの場合:
docker run -ti -e DISPLAY -v $XAUTHORITY:/home/developer/.Xauthority --net=host antmicro/renode:nightly-dotnet
これによりRenode Monitorウィンドウが表示されます。 あるいは、上記の行の末尾にカスタムコマンドを指定することもできます。
Xサーバーのパススルーなしでコンソールモードでイメージを実行するには、次を実行します:
docker run -ti antmicro/renode bash
コマンドに -v スイッチを追加することで、独自のディレクトリをマウントできます。
詳細および基となる Dockerfile については、GitHub 上のリポジトリをご覧ください。
ドキュメント
ドキュメントは Read the Docs でご利用いただけます。