1 | .. SPDX-License-Identifier: CC-BY-SA-4.0 |
---|
2 | |
---|
3 | .. Copyright (C) 2018 Chris Johns <chrisj@rtems.org> |
---|
4 | |
---|
5 | Testing |
---|
6 | ******* |
---|
7 | |
---|
8 | RTEMS developers run test executables when adding new features or testing a bug |
---|
9 | fix. All tests are run to make sure changes do not introduce regressions. Users |
---|
10 | can run the RTEMS tests to be certain the build of the kernel they have is |
---|
11 | functioning. |
---|
12 | |
---|
13 | The section describes using and configuring the RTEMS Tester and RTEMS Run |
---|
14 | tools, the types of laboratory set ups supported and how to add your BSP to the |
---|
15 | framework. The tools command line interfaces are detailed in |
---|
16 | :ref:`rtems-tester-command`. |
---|
17 | |
---|
18 | An RTEMS Test is an RTEMS executable where the application code is a |
---|
19 | test. Tests in RTEMS print banners to the console to indicate the configuration |
---|
20 | of the test and if it has start and finished. |
---|
21 | |
---|
22 | The RTEMS Tools Project provides the RTEMS Tester and RTEMS Run tools. The |
---|
23 | RTEMS Tester command is ``rtems-test`` and the RTEMS Run command is |
---|
24 | ``rtems-run``. These commands manage the complexity of running embedded |
---|
25 | executables. The commands provide a consistent command line interface to a |
---|
26 | testing framework that supports the various run time and testing scenarios we |
---|
27 | encounter such as simulators, GDB and executing directly on target hardware. |
---|
28 | |
---|
29 | The RTEMS kernel code contains an extensive set of tests to exercise and test |
---|
30 | the RTEMS kernel. The tests check functionality, provide coverage testing and |
---|
31 | make sure the kernel is operating as intended on your target system. The |
---|
32 | testsuite has support to make creating a test simple and uniform. |
---|
33 | |
---|
34 | The tests are built by adding ``--enable-tests`` to the RTEMS build |
---|
35 | configuration command line. There are over 600 tests and building them does |
---|
36 | extend the RTEMS kernel's build time and use more disk space but it worth |
---|
37 | building and running them. The RTEMS test executables have the ``.exe`` file |
---|
38 | extension. |
---|
39 | |
---|
40 | .. include:: tests.rst |
---|
41 | .. include:: configuration.rst |
---|
42 | .. include:: consoles.rst |
---|
43 | .. include:: simulation.rst |
---|
44 | .. include:: gdb-jtag.rst |
---|
45 | .. include:: tftp.rst |
---|