RISC-V eXpress Installation Manual
- Step 2 -

Kyuseung Han, Sukho Lee, Hyunguk Jang, Jae-Jin Lee
ETRI, Daejeon, South Korea

v2025-07-10 or later

Overview

Clone the RVX design git repository and set up a Python3 environment for RVX.
Check whether Python3 is installed and configured properly.
Resolve conflicts when multiple versions of Python3 are installed.

Git Repository Cloning

Instruction @ Any OS

inst) Open a terminal.
inst) Navigate to the parent directory where you want to clone.
cmd) git clone --recursive #(design repository URL)
cmd) cd #(cloned directory)
cmd) git submodule init
cmd) git submodule update

Python3 Configuration for RVX

Objective

Set the python3 command used in RVX.

Check

cmd) cd #(cloned directory)
cmd) make check_python

Instruction @ Linux

cmd) cd #(cloned directory)
cmd) make config_python
inst) Verify that ‘‘rvx_python_config.mh’’ is generated.
inst) Open ‘rvx_python_config.mh’ in a text editor
> If no path is listed, manually enter the path to the executable.
> If more than one path is listed, keep only the one you intend to use and delete the others.

Instruction @ Windows

cmd) cd #(cloned directory)
cmd) make config_python
inst) Verify that ‘rvx_python_config.mh’ and ‘python3.bat’ are generated.
inst) Do NOT modify ‘rvx_python_config.mh’
inst) Open ‘python3.bat’ in a text editor
> If no path is listed, manually enter the path to the executable.
> If more than one path is listed, keep only the one you intend to use and delete the others.
> Do NOT remove ‘%*’ at the end of the line.
> If the directory name contains spaces, enclose it in double quotation marks as shown below.
ex) C:\Users\‘‘Kyuseung Han’’\... %*

Python3 Library Install

Objective

Install python3 libaries.

Check

cmd) make check_pip

Instruction @ Any OS

cmd) make pip

If you encounter any issues, try:

cmd) make fix_pip

Preparation

Instruction @ Linux

cmd) cd #(cloned directory)
cmd) make prepare
> Check that the file ./rvx_setup.sh has been created.
inst) Add the line source #(cloned directory)/rvx_setup.sh to your .bashrc.
> Be sure to replace #(cloned directory) with the absolute path before adding it.
inst) To apply the changes to .bashrc, close and reopen the terminal.
> Now, #(cloned directory) is registered as ${RVX_MINI_HOME}.

Instruction @ Windows

cmd) cd #(cloned directory)
cmd) make prepare
inst) Update the PATH variable
> If a message indicates that it was updated successfully, proceed to the next step.
> If a WARNING appears, manually add ‘‘#(cloned directory)\windows_binary’’ to the PATH.
inst) To apply the changes to PATH variable, close and reopen the terminal.
> Now, #(cloned directory) is registered as ${RVX_MINI_HOME}.

Install Check

Objective

Check which installation process has issues

Instruction @ Any OS

cmd) cd #(cloned directory)
cmd) make check

Navigate