= RTEMS Add-On Packages =


The RTEMS Addon Packages is an infrastucture complete with examples of how to add libraries to RTEMS to make more complex applications.
= Getting the RTEMS Addon Package =

To get the RTEMS addon packages:
   $ git clone git://git.rtems.org/rtems-addon-packages.git \
     rtems-addon-packages
= Adding Libraries to RTEMS =

=  Setting up the Environment  =

First, set your RTEMS_MAKEFILE_PATH
   $ export RTEMS_MAKEFILE_PATH=/opt/rtems-4.11/i386-rtems4.11/pc386

Another (recommended choice) would be to add 

   export RTEMS_MAKEFILE_PATH=/opt/rtems-4.11/i386-rtems4.11/pc386

to your ~/.bashrc 

Second, to ensure i386-rtems4.11-gcc, will work, add your install point to your PATH.
   $ export PATH=$PATH:/opt/rtems-4.11
=  Using Makefile.avl  =

Navigate to the RTEMS Addon Packages
   $ cd ~/rtems-addon-packages

Navigate to the AVL library
   $ cd avl-1.4.0

Make the AVL library
   $ make -f ../RTEMS_Makefiles/Makefile.avl
=  Writing Your Own Makefile.<<library>>  =

Makefile.<<library>> is a shell script to configure a package.

Look at rtems-addon-packages/RTEMS_Makefiles/Makefile.ncurses
   $ cat ~/rtems-addon-packages/RTEMS_Makefiles/Makefile.ncurses

The first four lines are comments that describe the package.
   #
   # Declare supported terminal types.
   # This value can be augmented/overridden by the site-configuration file
   #

The next line sets some environmental variables:
   TERMINALS=xterm,vt100,linux,ansi

The next paragraph explains the dependencies:
   #
   # The following will work only if you have the latest ncurses version
   # of infocmp installed before trying to build for an RTEMS target.
   # The cf_cv_type_of_bool hack works around a bug when configuring
   # for a cross-target.
   #

all: is simply the makefile rule for all

'''''Note:''' Cached variables help with cross-compiling by providing values that can't be determined by configure.''

Makefile.ncurses use some some cached variables.  
   cf_cv_type_of_bool=char

Set the C++ compiler to the C compiler.
CXX="$(CC)" 

Select the TERM environmental variable to xterm
TERM=xterm 

make -f ../RTEMS_Makefiles/Makefile.avl




The RTEMS Addon Packages come with the following additions:
Name: avl-1.4.0
Site: http://savannah.gnu.org/projects/avl
Description: GNU libavl is a library in ANSI/ISO C for the manipulation of binary trees and balanced binary trees.

Name: gsl-1.9
Site: http://www.gnu.org/software/gsl/
Description: The GNU Scientific Library (GSL) is a numerical library for C and C++ programmers.

Name: libtecla-1.6.1
Site: http://www.astro.caltech.edu/~mcs/tecla/index.html
Description: The tecla library provides UNIX and LINUX programs with interactive command line editing facilities, similar to those of the UNIX tcsh shell.

Name: ncurses-5.9
Site: http://www.gnu.org/software/ncurses/
Description: The Ncurses (new curses) library is a free software emulation of curses in System V Release 4.0, and more.

Name: adline-6.2
Site: http://cnswww.cns.cwru.edu/php/chet/readline/rltop.html
The GNU Readline library provides a set of functions for use by applications that allow users to edit command lines as they are typed in.


To
The current maintainer of the RTEMS Addon Packages is: Mark Johannes.