| 1 |
2 |
mballance |
# FWRISC Quickstart
|
| 2 |
|
|
|
| 3 |
|
|
This Quickstart guide describes the process for getting up and running with FWRISC. Follow the process
|
| 4 |
|
|
described below
|
| 5 |
|
|
|
| 6 |
|
|
## Setup Tools
|
| 7 |
|
|
|
| 8 |
|
|
Please see the [Tools](fwrisc_tools.md) page for information on the tools required to run FWRISC.
|
| 9 |
|
|
Please install the required tools and configure your environment before proceeding.
|
| 10 |
|
|
|
| 11 |
|
|
## Setup FWRISC Project
|
| 12 |
|
|
|
| 13 |
|
|
Please see the [Setup](fwrisc_setup.md) page for information on cloning and bootstrapping the
|
| 14 |
|
|
FWRISC project.
|
| 15 |
|
|
|
| 16 |
|
|
## Run Regression Tests
|
| 17 |
|
|
|
| 18 |
|
|
The block-level regression tests can be run using the following steps. Note that the
|
| 19 |
|
|
FWRISC environment-setup script must have previously been sourced:
|
| 20 |
|
|
|
| 21 |
|
|
```
|
| 22 |
|
|
% cd fwrisc/ve/fwrisc/sim
|
| 23 |
|
|
% runtest.pl -testlist testlists/fwrisc_riscv_all_tests.tl
|
| 24 |
|
|
```
|
| 25 |
|
|
|
| 26 |
|
|
The runtest command above will run unit tests, RISC-V compliance tests, and simple Zephyr tests. You should see
|
| 27 |
|
|
something like the following after the test run completes:
|
| 28 |
|
|
|
| 29 |
|
|
```
|
| 30 |
|
|
#*********************************************************************
|
| 31 |
|
|
# PASSED: 120
|
| 32 |
|
|
# FAILED: 0
|
| 33 |
|
|
# UNKNOWN: 0
|
| 34 |
|
|
# TOTAL: 120
|
| 35 |
|
|
#*********************************************************************
|
| 36 |
|
|
```
|
| 37 |
|
|
|
| 38 |
|
|
|
| 39 |
|
|
|
| 40 |
|
|
## Run Zephyr Examples
|
| 41 |
|
|
Two of the Zephyr examples, synchronization and philosophers, are much more visual and do not terminate.
|
| 42 |
|
|
Running these tests interactively is recommended.
|
| 43 |
|
|
|
| 44 |
|
|
### Run "philosophers":
|
| 45 |
|
|
|
| 46 |
|
|
```
|
| 47 |
|
|
% cd fwrisc/ve/fwrisc/sim
|
| 48 |
|
|
% runtest.pl -test tests/fwrisc_zephyr_philosophers.f
|
| 49 |
|
|
```
|
| 50 |
|
|
|
| 51 |
|
|
You should see something like what is seen below:
|
| 52 |
|
|
|
| 53 |
|
|
|
| 54 |
|
|
|
| 55 |
|
|
|
| 56 |
|
|
### Run "synchronization"
|
| 57 |
|
|
|
| 58 |
|
|
```
|
| 59 |
|
|
% cd fwrisc/ve/fwrisc/sim
|
| 60 |
|
|
% runtest.pl -test tests/fwrisc_zephyr_synchronization.f
|
| 61 |
|
|
```
|
| 62 |
|
|
|
| 63 |
|
|
You will see several messages from threadA and threadB, which the testbench monitors to determine
|
| 64 |
|
|
when the test has passed. Note that the test specifies special flags to the test compilation
|
| 65 |
|
|
to shorten the test run.
|
| 66 |
|
|
|
| 67 |
|
|
### Run "dhrystone"
|
| 68 |
|
|
|
| 69 |
|
|
```
|
| 70 |
|
|
% cd fwrisc/ve/fwrisc/sim
|
| 71 |
|
|
% runtest.pl -test tests/fwrisc_zephyr_dhrystone.f
|
| 72 |
|
|
```
|
| 73 |
|
|
|
| 74 |
|
|
You should see the following:
|
| 75 |
|
|
```
|
| 76 |
|
|
# ***** Booting Zephyr OS zephyr-v1.13.0-1808-gd18ff80 *****
|
| 77 |
|
|
# start=70458 ; end=1873006
|
| 78 |
|
|
# Microseconds for one run through Dhrystone: 72
|
| 79 |
|
|
# Dhrystones per Second: 13500
|
| 80 |
|
|
```
|
| 81 |
|
|
|
| 82 |
|
|
Note that the clock for this test is 50Mhz, resulting in 0.15 DMIPS/Mhz.
|
| 83 |
|
|
|
| 84 |
|
|
## Run Synthesis
|
| 85 |
|
|
Please see the [Synthesis](fwrisc_synthesis.md) document for more information on running synthesis. The short version is:
|
| 86 |
|
|
|
| 87 |
|
|
- Ensure your environment is properly configured
|
| 88 |
|
|
- cd fwrisc/synth/microsemi
|
| 89 |
|
|
- make
|
| 90 |
|
|
- cd fwrisc/synth/lattice
|
| 91 |
|
|
- make
|
| 92 |
|
|
|
| 93 |
|
|
|
| 94 |
|
|
|
| 95 |
|
|
|
