Renode

Авторское право (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 решает эту проблему, позволяя запускать неизменяемые бинарные файлы, идентичные тем, которые вы обычно прошиваете на целевое оборудование, на виртуальной плате или системе плат.

Важный аспект инструмента заключается в том, что он симулирует не только ЦП, но и целые 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 — пакет для macOS для Mac на Apple Silicon (arm64)
• renode-latest.osx-x64-portable.dmg — пакет для macOS для Mac на Intel (x86_64)
• renode-latest.windows-portable.zip — переносимый пакет для Windows, без установщика
• renode-latest.setup.exe — установщик для Windows
• renode-latest.tar.xz — исходный код Renode

Стабильные релизы

Стабильные, номерные релизы и их примечания к выпуску доступны в разделе Релизы на GitHub.

Установка через homebrew tap

На macOS как стабильные, так и ночные версии Renode можно установить с помощью Homebrew из нашего собственного tap. Чтобы установить стабильную версию, используйте brew install renode/tap/renode, или brew install renode/tap/renode-nightly для последней ночной сборки. Это установит все зависимости, включая предварительную настройку окружения Python для renode-test.

Использование переносимого пакета для 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"

Обратите внимание, что переносимый пакет требует наличия GTK2 на хосте для работы с включенным графическим интерфейсом.

Перейдите к разделу Дополнительные требования, если хотите использовать Robot Framework для тестирования. В противном случае переходите к разделу 'Запуск Renode'.

Установка зависимостей

dotnet

Renode требует dotnet >= 6.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

Установите Renode с помощью вашего предпочтительного менеджера пакетов, используя предоставленные пакеты *.deb, *.rpm или *.pkg.tar.xz.

macOS

Используйте предоставленный *.dmg как обычно. Кроме того, чтобы использовать Renode из командной строки на macOS, создайте соответствующие алиасы, добавив alias renode='/Applications/Renode.app/Contents/MacOS/renode' и alias renode-test='/Applications/Renode.app/Contents/MacOS/renode-test' в ваш файл .bashrc или .zshrc, в зависимости от используемой оболочки.

Windows

Установите Renode из предоставленного файла *.msi. Установщик позволит добавить иконки на Рабочий стол и/или в меню Пуск, а также запись в PATH.

Дополнительные требования

Тестирование с помощью Robot Framework

Для написания и запуска тестовых сценариев Renode интегрируется с тестовым фреймворком Robot. Это требует установки Python 3 (в Windows также потребуется Cygwin — см. расширенные инструкции по установке) с pip (обратите внимание, что соответствующий пакет может называться python-pip или python3-pip в Linux).

После установки Python 3 и pip установите дополнительные модули:

python3 -m pip install -r tests/requirements.txt

Другие инструменты

Кроме того, каждый из инструментов в поддиректории /tools может содержать файл requirements.txt, отдельный от требований Renode.

Установите их в вашем виртуальном окружении с помощью pip install -r requirements.txt.

Сборка из исходного кода

Информацию о сборке Renode из исходного кода см. в документации.

Запуск Renode

После выполнения инструкций выше по установке из пакета команда renode должна быть доступна системно:

renode [flags] [file]

Если вы собрали его из исходного кода, перейдите в соответствующую директорию и используйте:

./renode [flags] [file]

Необязательный аргумент [file] позволяет указать путь к скрипту, который будет выполнен при запуске.

Скрипт поддерживает несколько опциональных флагов, наиболее полезные из которых представлены ниже: