IEEE.org     |     IEEE Xplore Digital Library     |     IEEE Standards     |     IEEE Spectrum     |     More Sites

README.md 3.48 KB
Newer Older
Alfredo's avatar
Alfredo committed
1
# riscv_vm
Alfredo's avatar
Alfredo committed
2
3
&nbsp;<img src="https://github.com/openhwgroup/riscv_vm/blob/master/RISCV_VM.png" width="200" title="RISC-V VM">

Alfredo's avatar
Alfredo committed
4
The OpenHW Group's RISC-V Virtual Machine (riscv_vm) is intended for anyone wanting to study, configure as-preferred, modify, implement or release hardware based the RISC-V Instruction Set Architecture. The VM is preconfigured for RISC-V HW development.
Alfredo's avatar
Alfredo committed
5
6
7
   * RISC-V SW tool chain using the Eclipse-IDE
   * RISC-V Imperas OVPSim model
   * RISC-V Verilator model
Alfredo's avatar
Alfredo committed
8
9
10
11
   * The files in the ~/bin directory are used to create the VM Linux image after Ubuntu 18.04LT has been installed. 
   * The VM'sminimal configuration is 2CPU/4G-RAM/20GB-DISK with USB 2.0 enabled
   * To donwload a protable *.osa appliance file, go to:
     - [RISCV_VM *.OVA image on Google Drive](https://drive.google.com/drive/folders/18njYttFpczl-CrHkZ7HQ-lLf-w2fBcL9)
Alfredo's avatar
Alfredo committed
12
   * **Note that the virtual machine userID /password is _user/abc123_**
13
 
Alfredo's avatar
Alfredo committed
14
## Importing VM into VirtualBox on Windows10 host
15
The instructions to install and run are:
Alfredo's avatar
Alfredo committed
16
17
1. Open a Windows Command-line prompt with Admin privileges:
   * Press the Windows-Start key
Alfredo's avatar
Alfredo committed
18
   * search for the _"cmd.exe"_ program
Alfredo's avatar
Alfredo committed
19
   * right-click on CMD icon
Alfredo's avatar
Alfredo committed
20
   * select _“Run as administrator”_
Alfredo's avatar
Alfredo committed
21
2. Download and run the installer batch file available in this repository: 
Alfredo's avatar
Alfredo committed
22
   - [riscv_vm Windows10 Install script](https://github.com/openhwgroup/riscv_vm/blob/master/riscv_vm_win10_install.bat)
Alfredo's avatar
Alfredo committed
23
24
25
26
3. Install VirtualBox and its corresponding Extension Pack downloaded by the installer script
4. Import the *.OVA “appliance” into VirtualBox
5. Start the VcXsrv client
6. Start git-bash to run the following:
Alfredo's avatar
Alfredo committed
27
28
29
30
31
   - Start the VM from the git-bash in head-less mode (your path may be different):
  ```
        <PROMPT$>/c/bta_cadtree/VirtualBox/vb6_0_10/VBoxManage startvm riscv_vm2 --type headless
        <PROMPT$>export DISPLAY=localhost:0.0
  ```
Alfredo's avatar
Alfredo committed
32
7. SSH into the VM using the command:
Alfredo's avatar
Alfredo committed
33
34
   - ssh -Yv user@<_IP of riscv_vm2_>
   - In my case that is: ssh -Yv user@192.168.56.101
35

Alfredo's avatar
Alfredo committed
36
## Installing the riscv_vm tools directly on Ubuntu 18.04LT host (UNTESTED)
37
38
39
40
41
On a Linux machine with Ubuntu 18.04LT installed, follow these instructions:
1. clone the repo from your Linux machine:
   - git clone git@github.com:openhwgroup/riscv_vm.git
2. run the installe and follow the prompts on the screen:
   - sudo riscv_vm/bin/ubuntu_post-install.sh
42
 
Alfredo's avatar
Alfredo committed
43
44
## Importing VM into VirtualBox on MacOS host
The instructions to install and run are:
Alfredo's avatar
Alfredo committed
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
1. Open the “Terminal” application, found in /Applications/Utilities/
2. Download and run the installer script  available in this repository: 
   - [riscv_vm MacOS Install script](https://github.com/openhwgroup/riscv_vm/blob/master/riscv_vm_macos_install.command) 
3. Install VirtualBox and its corresponding Extension Pack downloaded by the installer script
4. Import the *.OVA “appliance” into VirtualBox
5. Start the XQuartz client:
   - Install XQuartz on your Mac, which is the official X server software for Mac
   - Run Applications > Utilities > XQuartz.app
6. Right click on the XQuartz icon in the dock and select Applications > Terminal.  This should bring up a new xterm terminal windows to run the following:
   - Start the VM from the xquartz-terminal in head-less mode (your path may be different):
  ```
        <PROMPT$>/c/bta_cadtree/VirtualBox/vb6_0_10/VBoxManage startvm riscv_vm2 --type headless
        <PROMPT$>export DISPLAY=localhost:0.0
  ```
7. SSH into the VM using the command:
   - ssh -Yv user@<_IP of riscv_vm2_>
   - In my case that is: ssh -Yv user@192.168.56.101