You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-5Lines changed: 16 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -99,13 +99,12 @@ To compatible with SoC test, All types of TreeCore have same memory map range:
99
99
#### Configuration
100
100
101
101
## Usage
102
-
adsfadfasdfasf
102
+
This section introduces how to set up development environment and runs unit test for your own riscv processor.
103
103
### Enviroment Setup
104
104
> NOTE: All of the components and tools are installed under linux operation system. To gurantee the compatibility and stability, I strongly recommend using `ubuntu 20.04 LTS`. `ubuntu 18.04` and `ubuntu 16.04` is not supported official.
105
105
106
106
First, you need to install verilator, mill and dependency libraries:
107
107
```bash
108
-
$ su -
109
108
$ cd rtl
110
109
$ chmod +x scripts/install.sh
111
110
$ make install
@@ -119,7 +118,7 @@ After that, you need to add the `NEMU_HOME` and `NOOP_HOME` environment variable
119
118
```bash
120
119
$ echoexport NEMU_HOME=$(pwd)/dependency/NEMU >>~/.bashrc # according to shell type your system uses
Becuase running the isa test don't need 8G memory, so you need to config the simulation memory size to reduce memory usage. You need to type `make menuconfig` as follow:
@@ -153,6 +152,7 @@ Last, remember to type `Save` button in bottom menu to save the `.config` file.
153
152
If you already run above commands correctly, you need to compile runtime libraries as follow:
154
153
155
154
```bash
155
+
$ cd ../../
156
156
$ make nemuBuild
157
157
$ make dramsim3Build
158
158
```
@@ -164,13 +164,24 @@ $ make riscvTestBuild
164
164
$ make cpuTestBuild
165
165
$ make amTestBuild
166
166
```
167
-
> NOTE: you need to enough memory to compile the
167
+
> NOTE: you need to enough memory to compile the application binaries.
168
168
169
169
### Recursive test
170
-
or after you modify the processor design, you need to run recursive test to gurantee the
170
+
After you modify the processor design, you need to run recursive unit test to gurantee the modification is correct.
171
+
171
172
```bash
172
173
$ make unit-tests
173
174
```
175
+
176
+
First, Running unit test need to download `mill` from github. If you cannot access the github correctly, you need to type below commands to configure `mill` manually:
177
+
178
+
```bash
179
+
$ # download '0.9.9-assembly' from https://github.com/com-lihaoyi/mill/releases/download/0.9.9/0.9.9-assembly manually.
180
+
$ cp 0.9.9-assembly ~/.cache/mill/download
181
+
$ mv ~/.cache/mill/download/0.9.9-assembly ~/.cache/mill/download/0.9.9 # change name
0 commit comments