Linux Virtual Appliance User Guide

This is a draft document and is subject to change without notice.

This is a manual on how to use Virtual Appliance for ARC Linux Virtual Platform.

Installing

1. Download latest VirtualBox distribution from https://www.virtualbox.org/wiki/Downloads. VirtualBox Extension Pack is not required. Install VirtualBox. Start it.
2. Click menu item "File > Import Appliance". Choose *.ova file of this virtual appliance.
3. When importing dialog will pop that will prompt for a VM parameters. Check them and edit of needed. Most likely candidates for editing: VM name, amount of CPU cores, amoount of RAM.

Running ARC Linux Virtual Platform

Start Virtual appliance.

Change current directory to the ~/snps/virtual-appliance:

$ cd ~/snps/virtual-appliance

Start SystemC model:

$ SC_SIGNAL_WRITE_CHECK=DISABLE ./sc_top

Depending on the parameters used at compile time, one of the provided properties.ini will be used. For the default ARC 700 single core model properties_up_a7.ini will be used, which in turn will set appropriate nSIM properties file and vmlinux file.

Recompiling the model

Set required environment variables: NSIM_HOME, SYSTEMC_HOME, TLM_HOME and SCML_HOME. You can source ~/snps/setenv.sh to use packages provided with this virtual appliance.

Compile model:

$ make clean
$ make EXTRA_CXXFLAGS="-fpermissive"

Set required permissions to sc_top:

sudo /sbin/setcap cap_net_admin,cap_net_bind_service=pe ./sc_top

Your recompiled model is ready.