Overview

• This manual explains how to install NPX on a local machine.

Notice

• All results produced using NPX are subject to the following conditions:

  • They must not be used beyond the predefined purpose and scope specified in advance for a particular class or research project.

  • They must not be distributed to third parties other than the designated users or organizations.

  • They are free for non-commercial research use, provided that the paper is cited. All other uses require prior approval and a technology transfer agreement.

Things to Know

• Manuals are available online - riscvexpress.github.io/npx

• Any part starting with # should be replaced or modified according to your environment.

• On Linux, use the bash shell for command-line operations.

• Skills for Linux

Requirements

• License Tools

  • Mixed-language RTL Simulator: Modelsim/QuestaSim or Xcelium/NCSim/Incisive

  • FPGA Tool: AMD Vivado 2022.1 or later

• A High-Performance Computer

  • A capable machine is required to run license tools efficiently.

  • The actual performance needed depends on the specific license tools being used.

  • Using a GPU is recommended for learning.

• Recommended OS Version

  • Must be compatible with license tools, not just NPX.

  • NPX-compatible OS

    • CentOS 7 / 8

    • Redhat 8 / 9

    • Ubuntu 18 / 20 / 22 (recommended) / 24

• For Linux systems, the locale setting must be en_US.UTF-8.

  • If using a GUI, set the language format to United States.

  • Or, comment out the line SendEnv LANG LC* in /etc/ssh/ssh_config

    • i.e., add a # at the beginning).

• User Account

  • Linux: Requires sudo privileges

Step 1 - Install HW Frameworks

To install RVX in a Linux environment,
follow the ‘RVX Tutorial: Hello’ using the NPX tutorial repository.

• RVX Tutorial: Hello

• https://github.com/rvx-etri/npx-tutorials.git

Step 2 - Install Learning Frameworks

Cloning the Xarvis Repository

cmd) git clone --recursive https://github.com/rvx-etri/npx-xarvis.git

Python3 Configuration for NPX

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.

Installing snnTorch and Python Packages

cmd) cd #(cloned directory)
cmd) make preinstall
cmd) make install

Setting Up Bash Environment

cmd) make config
> 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.

Navigate

• Home