1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/dist/tools/renode
Gaëtan Harter 41a891f284
tools: use 'BOARDSDIR' for the boards directory
Replace uses of 'RIOTBOARD' by 'BOARDSDIR' for tools.
2019-12-16 15:35:04 +01:00
..
README.md Update README.md for release 1.1 + link to docs 2017-11-21 15:22:55 +01:00
run-renode.sh tools: use 'BOARDSDIR' for the boards directory 2019-12-16 15:35:04 +01:00

Emulation using Renode

Introduction

Renode is a virtual development tool for multinode embedded networks (both wired and wireless) enabling a scalable workflow for building effective, tested and secure IoT systems, created by Antmicro. It can easily be used to run applications on a broad range of embedded platforms without any changes in the code itself, as if you were running on real hardware - but with more possibilities.

Installation

From package

Packages for macOS, deb-based and rpm-based systems, for Windows and for Arch Linux are available on GitHub.

From source

Follow the installation instructions on Renode's GitHub page.

After compilation is successful, ensure that renode is available on your PATH. One way to do so, is via symlink: sudo ln -s path/to/renode/repository/renode /usr/local/bin/renode.

Testing

After installation, verify if Renode is working using renode --help. You should be presented with a help screen.

Documentation

Documentation for Renode can be found on Read The Docs.

Usage

From within RIOT-OS, you can use make emulate to start emulation. It expects a board definition file in boards/<BOARD>/dist/board.resc.

The board definition file will tell Renode how to setup an emulation session. The application binary file (*.elf) is available using the variable $image_file.

For an example, refer to boards/cc2538dk/dist/board.resc.