Builds/Tests

Automated testing

There are a number of automated tests that can be run from the command line from the top level Paparazzi directory:

• make test: runs test_math and test_examples
• make test_math: test math lib
• make test_examples: test compiles all aircrafts/targets in conf/conf_tests.xml
• make test_all_confs: test compiles all confs, i.e. all aircrafts found in all conf files found by find_confs.py

To test compile all aircrafts in one specific conf file:
CONF_XML=conf/conf_personal.xml prove tests/aircrafts/
See tests/aircrafts/01_compile_all_aircrafts.t for more details.

If you require more verbose output of the results run the command make test TEST_VERBOSE=1

The test results can also be generated in JUnit format adding the option JUNIT=1 to the command line i.e. make test JUNIT=1 or make test TEST_VERBOSE=1 JUNIT=1

JUnit formatting of test results requires that the Perl module TAP::Formatters::JUnit is installed on the machine that the tests are run on. Please see installing Perl modules for more details

Hardware tests

The hardware testing is executed using the Perl test framework.

To implement the hardware testing we need do the following

• Build the firmware
• Upload the firmware to the target board noting that multiple boards may be connected to the same computer
• Start up the server program
• Start up the link program
• Run the test suite by reading and writing data to the Ivy bus.
• Stop the server and link processes

The Perl module IO::Socket::Multicast is required to be installed to be able to execute the hardware tests. Please see installing Perl modules for more details

To execute the hardware tests run the command make test TEST_HARDWARE=1

Installing Perl modules

On Ubuntu/Debian simply

 apt-get install libio-socket-multicast-perl libtap-formatter-junit-perl

To install Perl modules directly from CPAN the following procedure can be run.

1. sudo perl -MCPAN -e shell
2. install <module name>

This should install all of the required modules. note that errors may be reported during the installation process so you should pay attention to what is happening.