riscv is an RISCV(RV32IM) emulator

The emulator can be build by running:

$./build.sh

which uses gcc

There are example binaries in the tests directory which are compiled using the riscv32-unknown-elf-* toolchain. Example usage:

$./riscv tests/hello_world.bin 2> log.txt

should print Hello World. Note the 2>, it is used to redirect the STDERR to print to the file log.txt.

The emulator prints a log for every instruction it executes to the standard error stream.

The emulator provides two syscalls: exit and write. Here is a table that describes their usage using the ecall instruction.