Skip to content

Commit 8c8378c

Browse files
committed
Revise riscv-arch-test description and Makefile
1 parent 9e774e7 commit 8c8378c

File tree

12 files changed

+27
-19
lines changed

12 files changed

+27
-19
lines changed

.gitignore

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
build/DOOM1.WAD*
22
shareware_doom_iwad.zip*
33
build/rv32emu
4-
build/compliance
4+
build/arch-test
55
*.o
66
*.o.d

.gitmodules

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
[submodule "riscv-arch-test"]
22
path = riscv-arch-test
3-
url = https://github.com/riscv-non-isa/riscv-arch-test.git
3+
url = https://github.com/riscv-non-isa/riscv-arch-test

Makefile

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -81,20 +81,20 @@ check: $(BIN)
8181
(cd $(OUT); ../$(BIN) hello.elf)
8282
(cd $(OUT); ../$(BIN) puzzle.elf)
8383

84-
COMPLIANCE_DIR ?= ./riscv-arch-test
85-
export RISCV_TARGET = compliance-target
86-
export RISCV_PREFIX = riscv-none-embed-
84+
ARCH_TEST_DIR ?= ./riscv-arch-test
85+
export RISCV_TARGET = arch-test-target
86+
export RISCV_PREFIX ?= riscv-none-embed-
8787
export TARGETDIR = $(shell pwd)
8888
export XLEN = 32
8989
export JOBS ?= -j
90-
export WORK = $(TARGETDIR)/build/compliance
90+
export WORK = $(TARGETDIR)/build/arch-test
9191

92-
$(COMPLIANCE_DIR):
92+
$(ARCH_TEST__DIR):
9393
git submodule update --init
9494

95-
compliance: $(BIN) $(COMPLIANCE_DIR)
96-
$(Q)$(MAKE) --quiet -C $(COMPLIANCE_DIR) clean;
97-
$(Q)$(MAKE) --quiet -C $(COMPLIANCE_DIR);
95+
arch-test: $(BIN) $(ARCH_TEST__DIR)
96+
$(Q)$(MAKE) --quiet -C $(ARCH_TEST_DIR) clean
97+
$(Q)$(MAKE) --quiet -C $(ARCH_TEST_DIR)
9898

9999
demo: $(BIN) $(OUT)/DOOM1.WAD
100100
(cd $(OUT); ../$(BIN) doom.elf)

README.md

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -30,21 +30,31 @@ make demo
3030
The build script will then download data file for Doom automatically. SDL2 based window
3131
should appear when Doom is loaded and executed.
3232

33-
## Run riscv-arch-test
33+
## riscv-arch-test
3434

35-
Once the submodule `riscv-arch-test` is pulled, run all the available compliance test via command:
35+
The RISC-V Architectural Tests, [riscv-arch-test](https://github.com/riscv-non-isa/riscv-arch-test) is basic set of tests that ensure software implemented can be match important aspects of the RISC-V specification.(not a **substitute for rigorous design verification**)
36+
37+
There has the **reference signatures** generate by [RISC-V SAIL](https://github.com/riscv/sail-riscv) and the test signatures, specific memory location can be written.Once the test be executed, the **test signatures** will be written by testing-model(rv32emu-next)during the test, and it will be compared to **reference signature**.The test will pass if both signatures exactly match.
38+
39+
[riscv-arch-test](https://github.com/riscv-non-isa/riscv-arch-test) is integrated with submodule, and the setup was done.Once the submodule `riscv-arch-test` is pulled, run all the available riscv-arch-test via command:
3640
```shell
37-
make compliance
41+
make arch-test
3842
```
3943

4044
* To run the tests for specific extension, set the environmental variable `RISCV_DEVICE` to one of `I`,`M`,`C`,`Zifencei`,`privilege`.
4145
```shell
42-
make compliance RISCV_DEVICE=I
46+
make arch-test RISCV_DEVICE=I
4347
```
4448
* To run a specific test case,set both `RISCV_DEVICE` and `RISCV_TEST`.For example:
4549
```shell
46-
make compliance RISCV_DEVICE=M RISCV_TEST=div-01
50+
make arch-test RISCV_DEVICE=M RISCV_TEST=div-01
4751
```
52+
The detail in setup enviroment variables is in [RISC-V Architectural Testing Framework](https://github.com/riscv-non-isa/riscv-arch-test/blob/master/doc/README.adoc) **5.1 Setup environment variables**.
53+
54+
Reference:
55+
[riscv-arch-test repository](https://github.com/riscv-non-isa/riscv-arch-test)
56+
[RISC-V Architectural Testing Framework](https://github.com/riscv-non-isa/riscv-arch-test/blob/master/doc/README.adoc)
57+
[RISC-V Architecture Test Format Specification](https://github.com/riscv-non-isa/riscv-arch-test/blob/master/spec/TestFormatSpec.adoc)
4858

4959
## Customization
5060

compliance-target/link.ld renamed to arch-test-target/link.ld

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,4 +13,3 @@ SECTIONS
1313
.bss : { *(.bss) }
1414
_end = .;
1515
}
16-

0 commit comments

Comments
 (0)