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 - the result of this stage is a binary ELF image of the test program;
3. Test program emulation - the result of this stage is a *-qemu.log trace file.

   In the nearest future the one more stage will be added:

4. Execution trace comparison - the *.log MicroTESK trace and the *-qemu.log QEMU4V trace will be compared, a report will be generated.

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

./gradlew test