RTEMS 4.6.1 On-Line Library

Sample Applications Introduction

RTEMS Development Environment Guide

3.1: Introduction

The RTEMS source distribution includes a set of sample applications that are located in the ${RTEMS_ROOT}/c/src/tests/samples/ directory. These applications are intended to illustrate the basic format of RTEMS single and multiple processor applications and the use of some features. In addition, these relatively simple applications can be used to test locally developed board support packages and device drivers as they exercise a critical subset of RTEMS functionality that is often broken in new BSPs.

Each of the following sample applications will be listed in more detail in the following sections:

Hello World: The RTEMS Hello World test is provided in the subdirectory ${RTEMS_ROOT}/c/src/tests/samples/hello/. This test is helpful when testing new versions of RTEMS, BSPs, or modifications to any portion of the RTEMS development environment.
Clock Tick: The ${RTEMS_ROOT}/c/src/tests/samples/ticker/ subdirectory provides a test for verification of clock chip device drivers of BSPs.
Base Single Processor: A simple single processor test similar to those in the single processor test suite is provided in ${RTEMS_ROOT}/c/src/tests/samples/base_sp/.
Base Multiple Processor: A simple two node multiprocessor test capable of testing an newly developed MPCI layer is provided in ${RTEMS_ROOT}/c/src/tests/samples/base_mp/.
Constructor/Destructor C++ Test: The ${RTEMS_ROOT}/c/src/tests/samples/cdtest/ subdirectory provides a simple C++ application using constructors and destructors. It is only built when C++ is enabled.
Paranoia Floating Point Test: The directory ${RTEMS_ROOT}/c/src/tests/samples/paranoia/ contains the public domain floating point and math library test.
Minimum Size Test: The directory ${RTEMS_ROOT}/c/src/tests/samples/minimum/ contains a simple RTEMS program that results in a non-functional executable. It is intended to show the size of a minimum footprint application based upon the current RTEMS configuration.
Unlimited Object Allocation: The ${RTEMS_ROOT}/c/src/tests/samples/unlimited/ directory contains a sample test that demonstrates the use of the unlimited object allocation configuration option to RTEMS.
Network Loopback Test: The ${RTEMS_ROOT}/c/src/tests/samples/loopback/ directory contains a sample test that demonstrates the use of sockets and the loopback network device. It does not require the presence of network hardware in order to run. It is only built if RTEMS was configured with networking enabled.

The sample tests are written using the Classic API so the reader should be familiar with the terms used and material presented in the RTEMS Applications Users Guide.

RTEMS Development Environment Guide