Connecting to the host network¶
Renode allows you to connect a host network interface to a simulated wired network.
To do that you need to be able to create a
Renode will try to create one, provided you have sufficient privileges.
Host-guest networking is currently available on Linux and macOS only.
Regarding time flow¶
All devices simulated in Renode operate in virtual time, which is typically slower than the real time flow. Moreover, network packets are delivered in periodical synchronisation points, delaying the communication even further.
This means that time constraints (e.g. timeouts) placed by applications trying to connect to the simulated network from the host may need to be altered to take these delays into account.
Opening a TAP interface¶
To create and open a TAP interface which will be listed on your host system as
tap0 and inside Renode as
(monitor) emulation CreateTap "tap0" "tap"
If you want the interface to be retained after Renode closes, add a
(monitor) emulation CreateTap "tap0" "tap" true
Depending on your system configuration, you may be asked for a password to open the interface.
The newly created interface needs to be enabled and configured on your host machine.
By default it has no IP address assigned and is in
Please refer to your system documentation for further instructions.
Connecting TAP interface switch¶
Assuming you have already configured the simulated network, you can connect a TAP interface to a
switch device by running:
(monitor) connector Connect host.tap switch
Starting the interface¶
The TAP interface is created as “paused”. To enable communication with the host system you must start it manually, either by running:
or, if your emulation is already started, with:
(monitor) host.tap Start