ETISS ArchImpl Plugins

This repository contains plugins for custom ArchImpl support in ETISS.

Contents

• RV32IMACFDK: TODO: Description

Building Instructions

Integrated ETISS Build

1. Clone ETISS repository
2. Copy (or symlink) the plugin directory (i.e. RV32IMACFDK) into the PluginImpl directory of the ETISS source tree.
3. Build ETISS as usual (following the instructions in the README)

Out-of-Tree Build

1. Clone, build and install ETISS according to the README.
2. Enter one plugin directory, i.e. cd
3. Build plugin with CMake, passing it ETISS_DIR to find the relevant CMake configuration

cmake -B ./build -S . -DETISS_DIR=/path/to/etiss/install/etiss/lib/CMake/ETISS
cmake --build build -j$(nproc)

Running Instructions

Integrated ETISS Build

Out-of-Tree Build

Option A (etiss_wd)

1. Create a directory: mkdir ./temp/
2. Create INI file with following contents:

# Filename: custom.ini
[StringConfigurations]
etiss_wd=/path/to/temp

3. Create PluginImpl subdirectory: mkdir ./temp/PluginImpl
4. Copy ./build/libRV32IMACFDK.so (or other plugin) into this subdir: cp ./build/libRV32IMACFDK.so ./temp/PluginImpl
5. Run EISS via run_helper.sh script (or calling bare_etiss_processor directly)

/path/to/etiss/install/etiss/bin/run_helper.sh /path/to/program --arch.cpu=RV32IMACFDK -icustom.ini

Hint: Steps 1.-3. can be skipped if executing ETISS in the same path where the PluginImpl directory is located. This yields to this more simple procedure:

mkdir ./PluginImpl
cp ./build/libRV32IMACFDK.so ./PluginImpl
/path/to/etiss/install/etiss/bin/run_helper.sh /path/to/program --arch.cpu=RV32IMACFDK

Option B (list.txt)

1. Edit the list.txt file located in /path/to/etiss/install/etiss/lib/plugins/

echo "RV32IMACFDK,$(pwd)/build/,RV32IMACFDK" >> /path/to/etiss/install/etiss/lib/plugins/list.txt

2. Run ETISS: /path/to/etiss/install/etiss/bin/run_helper.sh /path/to/program --arch.cpu=RV32IMACFDK

Warning: These changes will be overwritten, when ETISS is being rebuilt!