KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

riscv-hyp-tests

★ 45 Open GitHub ↗

A bare-metal application to test specific features of the risc-v hypervisor extension

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# RISCV-HYP-TESTS
## About 
This repository hosts unit tests for riscv hypervisor extension.

Testing is done by executing bare metal applications, which *set up the environment at different privilege levels*, *execute the testing code or trigger traps* and *check the execution results and processor status* to determine if specific features of the target platform is compliant with the hypervisor extension specification.

## Building
We assume that the RISC-V toolchain is installed and is added to the PATH.

### Target platform

The target platform on which the test will run should be specified by setting the PLAT environment variables. And the platforms that are currently supported are shown in the table below:

| Platform | ${PLAT} Parameters |
| - | - |
| *QEMU* | `qemu` |
| *Rocket Chip Emulator* | `rocket_emul` |
| *Rocket Chip FPGA* | `rocket_fpga` |
| *Spike Emulator* | `spike` |

### Output level

The output level can be specified via the `LOG_LEVEL` environment variable (default is `LOG_INFO`).

Options include:
`LOG_NONE`, `LOG_ERROR`, `LOG_INFO`, `LOG_DETAIL`, `LOG_WARNING`, `LOG_VERBOSE`, `LOG_DEBUG`

### Compile

The build process is as follows:

```bash
$ git clone https://github.com/josecm/riscv-hyp-tests
$ cd riscv-hyp-tests
$ PLAT=${target_platform} make
```

The compilation result is located at *build/*`${target_platform}`*/rvh_test.elf* or *rvh_test.bin*.

### Run

[`scripts/run_on_spike.sh`](scripts/run_on_spike.sh) is a script to run on spike

### Trouble-shooting

#### *boot.S:6: Error: unrecognized opcode `csrwi sscratch,0xf'*

We found that in higher versions of RISC-V gcc than gcc-10, instructions such as `csrwi` are grouped separately under the *zicsr extension* and need to be specified explicitly by appending `zicsr` string to the `-march` parameter of gcc.

#### *additional relocation overflows omitted from the output* or *relocation truncated to fit: R_RISCV_HI20*
Please check if the currently used RISC-V toolchain is configured with the `--with-cmodel=medany` parameter.
This can be determined by executing command: `riscv64-unknown-elf-gcc -v`.

And look at the `Configured with: ......` line in the output.

riscv-hyp-tests

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README