RISC-V eXpress CLI Manual for Linux/Windows
- RTL Simulation -

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

v2025-07-10 or later

Overview

This manual is intended for simulating applications on an RTL-based hardware platform. Applications developed in #(app dir) are converted into RISC-V binary files through the build process, and are then loaded into the main memory of the RTL platform at the start of simulation. The simulation automatically terminates when the application’s main function returns.
Note that this process requires a license for the mixed-language RTL simulator, which must be obtained separately.

Simulation Functionality

Creating an RTL Simulation Directory

Cleaning All Simulation Results

cmd) cd #(sim dir)
cmd) make clean

Compiling the Platform RTL Code

cmd) cd #(sim dir)
cmd) make compile_test

Displaying the Compilation Log of the Platform RTL Code

cmd) cd #(sim dir)
cmd) make compile_check

Simulating the RTL Platform Using an Application

Common

Simulating the Platform with an Application

cmd) cd #(sim dir)
cmd) make #(app name).sim

Simulating the Platform Including an Application Rebuild

cmd) cd #(sim dir)
cmd) make #(app name).resim

Simulating the Platform from Scratch

cmd) cd #(sim dir)
cmd) make #(app name).all // make clean #(app name).resim

Simulating with RTL Waveform Recording

cmd) cd #(sim dir)
cmd) make #(app name).debug

Simulating with Rebuild and Recording

cmd) cd #(sim dir)
cmd) make #(app name).redebug

Simulating with RTL Waveform Recording from Boot

cmd) cd #(sim dir)
cmd) make #(app name).debug_init

Opening the Waveform Viewer for Debugging

cmd) cd #(sim dir)
cmd) make view

Auxiliary Functionality

Displaying Applications List

cmd) cd #(sim dir)
cmd) make app_list

Compiling the Platform RTL Code One by One

This command helps identify missing include files.

cmd) cd #(sim dir)
cmd) make compile_test_all

Identifying RTL Compilation Failures

cmd) cd #(sim dir)
cmd) make compile_check

Navigate