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