MicroTESK » MicroTESK for MIPS

h1. How To Run jUnit Tests

h2. 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":https://forge.ispras.ru/projects/qemu4v/wiki/Installation, because it is used in testsing.

h2. Overview

The *MicroTESK for MIPS* project's "Git repository":https://forge.ispras.ru/projects/microtesk-mips64/repository contains a number of JUnit tests. The typical JUnit test contains the following sequence of stages:

# Template-based test program generation - the result of this stage is _<notextile>*</notextile>.s_ MIPS assembly file and a _<notextile>*</notextile>.log_ trace file;

# 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;

# Test program emulation - here the QEMU4V is used to emulate the ELF image; the result of this stage is a _<notextile>*</notextile>-qemu.log_ trace file.

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

<pre>

./gradlew test

</pre>