# sdu-riscv-brs-tests

**Repository Path**: dongshan-community/sdu-riscv-brs-tests

## Basic Information

- **Project Name**: sdu-riscv-brs-tests
- **Description**: RISC-V Boot and Runtime Services Test Suite
- **Primary Language**: C
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 17
- **Forks**: 16
- **Created**: 2025-09-26
- **Last Updated**: 2025-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

riscv-brs-tests
=======================
RISC-V Boot and Runtime Services Test Suite

## Overview

Used for simplifying the construction process of related test projects. There are two menu in build.sh.

## Environments

Before running, make sure that you have installed these packages:

        curl mtools gdisk gcc openssl automake autotools-dev libtool bison flex bc uuid-dev python3 	libglib2.0-dev libssl-dev autopoint gcc-riscv64-unknown-elf gcc g++

At the same time, please build on Ubuntu 22.04 and ensure at least 30GB of free disk space.

## Structure

The structure of this repository is listed below:

        .
        ├── Scripts
        ¦      ├── BRSIStartup.nsh
        ¦      ├── debug_dump.nsh
        ¦      ├── start_uefi_sct.sh
        ¦      └── startup.nsh
        ├── src
        ¦    ├── brs-buildroot
        ¦    ├── brs-edk2-test
        ¦    ├── brs-edk2
        ¦    ├── brs-grub
        ¦    ├── brs-linux
        ¦    ├── brs-opensbi
        ¦    ├── brs-qemu
        ¦    ├── brs-sbi-test
        ¦    └── brs-fwts
        ├── .gitgnore
        ├── LICENSE
        ├── NOTICE
        ├── README.md
        └── build.sh

## How To Run

Download and enter riscv-brs-tests repository.

        cd riscv-brs-tests

Run build.sh, firstly you will see start menu. There are 6 options in this menu:

        1. Initialize Target Directory
        2. Compile Components
        3. Build Disk Image
        4. Install Components
    	5. Clean Up
        6. Exit

If you don't make any choice within 10 seconds, the script will execute all choices.

Specially, if you choose "Compile Components",
you will see a menu which contains 11 options:

        1. linux
        2. grub
        3. edk2
        4. edk2-test
        5. buildroot
        6. opensbi
        7. sbi-test
        8. qemu
        9. fwts
        C. Compile All Components
        0. Back to main menu

Similar with last menu, if you don't make any choice within 10 seconds, all components will be compiled. The sources of these components are as follows:
| project   | source                                               | tag/branch                               |
| --------- | ---------------------------------------------------- | ---------------------------------------- |
| buildroot | https://github.com/buildroot/buildroot.git           | 2023.11                                  |
| edk2-test | https://github.com/tianocore/edk2-test.git           | 81dfa8d53d4290366ae41e1f4c2ed6d6c5016c07 |
| edk2      | https://github.com/tianocore/edk2.git                | edk2-stable202308                        |
| grub      | https://git.savannah.gnu.org/git/grub.git            | grub-2.12                                |
| linux     | https://github.com/torvalds/linux.git                | v6.12                                    |
| opensbi   | https://github.com/riscv-software-src/opensbi.git    | v1.4                                     |
| qemu      | https://github.com/qemu/qemu.git                     | v9.0.0                                   |
| SBI-test  | https://gitlab.com/kvm-unit-tests/kvm-unit-tests.git | v2024-01-08                              |
| fwts      | https://github.com/fwts/fwts.git                     | V24.11.00                                |
|           |                                                      |                                          |

After executing the build.sh, you will see a directory named 'target'. Enter this directory and run start_uefi_sct.sh.

Supports two parameters, allowing the edk2-test(1) and sbi-test(2) test projects to run.

        cd target
        . start_uefi_sct.sh [1/2]



Brs test will be executed.