blob: de993402a78d3e85869ca2ff18cff347ef31b065 [file] [log] [blame] [view]
# Running Renode
Tips for running Renode
## Automatically Start Renode Script
To streamline firing-up renode, use the `-e` flag to execute onload:
```
renode "i @sim/config/shodan_hellovector.resc; start"
```
This will start the renode script (resc) automatically.
Make sure to follow with `"i @path/to/file.resc; start` where the path starts
after `$ROOTDIR` (don't include the `$ROOTDIR` in the path).
## Using Headless Mode
To utilize without the pop-up renode consoles, utilize two flags:
1. `--disable-xwt` -- to prevent the windows from opening
2. `--port 1234` -- or port of choice for prompt access
This can be combined with the `-e` flag:
```
renode --disable-xwt --port 1234 -e "i @sim/config/shodan_hellovector.resc; start"
```
In a separate terminal window (or tmux pane), start a telnet at that port for
prompt access:
```
telnet 127.0.0.1 1234
```
Using this should create the following prompt:
```
$ telnet 127.0.0.1 1234
Trying 127.0.0.1...
Connected to 127.0.0.1.
Escape character is '^]'.
Renode, version 1.10.1.31213 (773406ba-202011051557)
(monitor) i @sim/config/shodan_hellovector.resc
(machine-0) start
Starting emulation...
(machine-0)
```
## Quitting Headless Renode Session
To quit the session, just type `quit` into the telnet prompt:
```
(machine-0) quit
Renode is quitting
Connection closed by foreign host.
```
This will quickly exit both telnet and the renode process on this port.