summaryrefslogtreecommitdiffstats
path: root/c/src/tests/samples/README
blob: 9a94a9b0fdc3f28a2caa344e032af3c4006f145d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
#
#  COPYRIGHT (c) 1989-1999.
#  On-Line Applications Research Corporation (OAR).
#
#  The license and distribution terms for this file may be
#  found in the file LICENSE in this distribution or at
#  http://www.OARcorp.com/rtems/license.html.
#
#  $Id$
#

This directory contains the RTEMS Sample Application Suite.
The tests in this directory perform two functions:

   + provide simple examples of applications which can be
     used as a starting point for your application.

   + help test a new board support package

The hello and ticker applications are useful when first bringing up
a new board support package.  The base_mp test is useful when
performing initial checkout on a new MPCI layer.

The following describes each of the sample applications:

   base_mp

      This is a very simple two node multiprocessor application.  It consists
      of a single initialization task on each node which print out
      their respective node numbers and task IDs.  This test can be
      used as a simple test of a new MPCI layer because it minimizes
      the number of packets sent by RTEMS.

      This is intended as a starting point for custom developed multiprocessor
      applications.

   base_sp

      This is a simple single processor application which consists of
      an initialization task which creates another task.

      This is intended as a starting point for custom developed single
      processor applications.

   cdtest

      A very simple C++ application which demonstrates that it is
      possible to use C++ contructors and destructors in an RTEMS
      application.  Also does a perfunctory iostream test.

   hello

      This is the RTEMS version of the classic hello world program.
      It consists of single initialization task which prints out
      a few messages.

      This test does not include a Clock Tick device driver and can
      be used to test the startup code of the board support package
      as well as console output.

   paranoia

      A public domain test of the floating point and math library
      capabilities of a toolset.  It reports discrepancies between
      actual and expected results.  It is a large test.

   ticker

      This is a simple test of the user's Clock Tick device driver.
      This test has an initialization task create three application
      tasks which sleep and periodically wake up and print the time.