readme.txt

Real-Time Kernel

Paradigm C++ Real-Time Kernel
=============================
RTKernel is a Paradigm C++ option that allows you to add real-time components
to your application is a fast and efficient way.  Tasks, semaphores, mailboxes,
message passing, memory pools and more can be added to your application to
allow it to run in demanding real-time environments.

An added bonus is tight integration that RTKernel enjoys within the Paradigm C++
IDE.  Creating an real-time application is as simple as selecting it in the
TargetExpert project wizard.  Once enabled, you will find that many of the
RTKernel objects are integrated with the Paradigm C++ debugger so the state of
tasks and other RTKernel objects can be viewed along with other debugger data
structures.


Sample applications
===================
RTKernel includes a number of sample application which you will want to explore
to see how easily RTKernel can be designed into an application and extend it
with tasking and synchronization.

FloatDemo   Runs four separate floating point tasks sharing common code and
            calculates and check floating point results.  Without a timer device
            this example will run cooperatively, with a timer device, this task
            will run preemptively.


StressTest  Runs four tasks that do nothing but allocate and free memory from
            the system heap.  Without a timer device this example will run
            cooperatively, with a timer device, this task will run preemptively.

RoundRobin  Runs three tasks at the same priority level to demonstrate round-
            robin task execution.

RTBench     An application that times the various RTKernel operations and
            reports the results to the console.


Helper files
============
The Paradigm C++ RTKernel examples contain one or more helper files that can
be used to direct output to a console device or add a target-dependent timer
driver to the application.  Some of the more common files included are:

CONSOLE.C   A console driver that can be customized for a physical device or
            used with the Paradigm C++ debugger Remote Console implementation.

AM186TMR.C  A sample hardware timer interrupt that works with most AMD Am186Ex
            processors.  This file is target-dependent on the clock frequency
            and may need customization depending on the target platform used.

These files can be moved or shared from the Helper files SourcePool depending
on the application and target system.

More information
================
You can learn more on using RTKernel in an application by reading the Paradigm
C++ RTKernel User Guide which is included with Paradigm C++.  You can also visit
the Paradigm C++ RTKernel web site at http://www.devtools.com/rtkernel and get
more information.

Questions on RTKernel or the supplied examples?  Contact the Paradigm C++
technical support staff at [e-mail].