readme

RTEMS (Real-Time Executive for Multiprocessor Systems) is a free open source real-time operating sys

#
#  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.rtems.com/license/LICENSE.
#
#  $Id: README,v 1.7.8.1 2003/09/04 18:46:30 joel Exp $
#

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.