How To Run jUnit Tests¶

Prerequisites¶

The most preferable OS is Linux. We prefer Debian-based distros, like Ubuntu.

To run the project's jUnit tests the gcc-mips-linux-gnu package should be installed. Create MIPS_64_TCHAIN environment variable that points to a directory, that contains the bin subdirectory with the toolchain components.

See the QEMU4V emulator's Installation Guide, because it is used in testsing.

Overview¶

The MicroTESK for MIPS project's Git repository contains a number of JUnit tests. The typical JUnit test contains the following sequence of stages:

1. Template-based test program generation - the result of this stage is *.s MIPS assembly file and a *.log trace file;
2. Test program compilation - at this stage the MIPS toolchain is used (we use gcc-mips-linux-gnu); the result of this stage is a binary ELF image of the test program;
3. Test program emulation - here the QEMU4V is used to emulate the ELF image; the result of this stage is a *-qemu.log trace file.

To run the project tests, enter the project directory that contains the gradlew script, and do the following:

./gradlew test