Detailed steps of setting up environment

Below are the steps of getting the hypervisor, and the OS image, and then creating a VM and installing the required tools inside that VM, and then testing that the tools work correctly.

Get VirtualBox from here: https://www.virtualbox.org/wiki/Downloads

Get Mint 18 from here: https://www.linuxmint.com/edition.php?id=217

Install Virtualbox, and create a VM (choose "Ubuntu 64bit" as the type), at least 40GB of virtual disk, and install Mint into that VM

Select the new VM, click "settings" then "system" then "motherboard" to configure it with a large amount of RAM (at least 2GB), then "Processor" to configure with at least half of the CPUs on your machine, then "Acceleration" to turn on VT-x and nested paging. click "Display"->"screen" and set video memory to 64MB and enable 3D acceleration click "Storage" -- on the right side of the popup is "Optical Drive" next to that is a little icon of a CD click on that and select the .iso file of the Linux distribution that you downloaded. (double check that the virtual hard disk size is larger than 40GB). click "save" or "ok" at the top, is a settings icon, click on that, then click on tab labelled "shared folders". In the dialog, on the left you'll see a folder with a "+" on it.. click on that and choose a folder that is outside of the VM. You will use use this for transferring files between VM and your host. Then start the VM. This will cause it to boot into the Linux install disk. Go through the linux install procedure.

In the window where the VM is running:

click "Devices"->"shared clipboard" and select "bidirectional" select "Devices"->"drag and drop"->"bidirectional" Install the Guest Additions and git and add permissions for shared folder in the Linux Mint that is installed inside the VM:

Devices->"Insert Guest Additions CD" for more see https://www.virtualbox.org/manual/ch04.html $ sudo apt-get install git $ sudo usermod -a -G vboxsf <your_username> Restart the VM then run the appropriate setup scripts.

Clone the repositories appropriate for your work The repositories are clone by running the appropriate script. The script puts the repo in a fixed location, which is important because bits of code depend on the directory structure being just the right way. The script also sets environment variables and so on. The first script to run is the generic one:

$ cd $ sh setup_basic.sh After this, run the script or scripts that are appropriate to the work you are doing:

setup_intencore_caches.sh if you're working on the caches setup_intensys_emulation.sh if you're working on the emulation environment and/or verification setup_project__st_chip.sh if you're assembling the full chip, or working with the EDA tools. Note that if you previously cloned any other repository, you may need to delete "IntensivateRoot" folder that it created, then run this script after that (ask on Slack if things aren't working right).