RISC-V eXpress CLI Manual for Linux/Windows
- Application -

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

v2025-07-10 or later

Overview

In the application directory, users can develop and compile the application software source code. Execution of the application must be performed using either RTL simulation or FPGA prototyping.

Build Mode

	debug	release	profile
assert*	O	X	X
assert_must*	O	O	O
printf	O	O	X
printf_must	O	O	O
debug_print*	O	O	O

Functionality

Creating an Application Directory

Command:

cmd) cd #(platform dir)/app
cmd) make new APP_NAME=#(app name)

Result:
#(platform dir)/app/#(app name) is created,
which we refer to as #(app dir).

Developing an Application

The application software must be written in C,
and the source code should be stored in #(app dir)/src.
The location of the source code can be changed by modifying #(app dir).

Building an Application (Including Compiling)

Prerequisite: Synthesizing a Platform
Command:
```
cmd) cd #(app dir)
cmd) make rtl
```
Result: #(app dir)/rtl.release is created.
Note: #(app dir)/rtl.release is automatically managed by the RVX tool.

Cleaning Build Results

The following files and/or directories are maintained:
./Makefile, ./compile_list, and ./src

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

Auxiliary Functionality

Specifying Compile Options Manually

Specify CFLAGS_RELEASE, CFLAGS_DEBUG, and/or CFLAGS_PROFILE
in #(app dir)/rvx_each.mh, depending on your needs.

Specifying Compile Sources Manually

Edit #(app dir)/compile_list.

Updating Makefile after RVX Update

This is not mandatory unless an error occurs.

cmd) cd #(app dir)
cmd) make update_makefile