12 December 2008

This is the source distribution for RTEMS 4.9.1 source, add-ons,
and documentation.  The primary development platforms supported are
GNU/Linux distribtions which use RPMs.  MS-Windows is supported as a
secondary platform.

The 4.9.1 release is the second release in the 4.9 series.  This release
is primarily a bug fix release to address issues reported in the 4.9.0
release.  For a complete list of the issues addressed between 4.9.0 and
4.9.0 as well as a description of the enhancements made since the 4.8
release branch, visit:

http://www.rtems.org/rtems-4.9/index.html

Installing Tools
================
For Fedora users, loading the prebuilt tools should be very easy and
something like this:

(1) Load the appropriate Yum repository configuration
    information.  This example is for Fedora GNU/Linux.
    RPMs are also provided for RedHat Enterprise Linux
    and SUSE.

    # Replace NNN with your 8-10 to reflect the Fedora version
    # Replace ARCH with your i386 or x86_64 to reflect your host architecture
    rpm -ivh ftp://ftp.rtems.org/pub/rtems/linux/4.9/fedora/NNN/i386/rtems-4.9-yum-conf-0.10-1.fcNNN.noarch.rpm

(2) Load cross development RPMs for your RTEMS target architecture
    along with the RTEMS 4.9 specific version of GNU autoconf
    and automake.

      # Replace CPU with the name of the CPU architecture you
      # want to use RTEMS on.  Choice are: 
      #   arm bfin h8300 i386 m68k mips powerpc sh sparc 
      yum -y install "*4.9*CPU*" "*4.9*auto*"

That's it.  You should be able to configure and build RTEMS at this
point.  

Building the SPARC/SIS BSP
==========================
If targeting a simulator BSP included with GDB (e.g. sparc/sis,
powerpc/psim, mips/jmr3904, sh/simsh1, or h8300/h8sim), you should be able
to generate and run target executables in a matter of minutes.  Normally
it takes longer to download the tools via ftp than to build RTEMS.

In this example, we will build RTEMS for the sparc/sis BSP. Since
it has a simulator which requires no command line arguments to
run executable, there is less opportunity for something to go wrong.
The following steps should get you to a running example after you
have loaded the SPARC RTEMS tools.

tar xjf rtems-4.9.1.tar.bz2
export PATH=/opt/rtems-4.9/bin:$PATH
mkdir b-sis
cd b-sis
../rtems-4.9.1/configure --target=sparc-rtems4.9 --enable-rtemsbsp=sis \
  --enable-tests=samples
make
sparc-rtems4.9-run sparc-rtems4.9/c/sis/testsuites/samples/ticker/ticker.exe

At this point you should see the output of the ticker sample executable.

Conclusion
==========

Configuring qemu so that it will boot an RTEMS application for the
i386/pc386 takes a bit longer but is still quite straightfoward. 

Many ARM and Blackfin BSPs can be executed on the Skyeye simulator.

Comments, feedback welcomed.  See the instructions at http://www.rtems.org
on joining the users mailing list.

Support, training, and consulting services are available from OAR
Corporation (http://www.rtems.com/oarsupport).

--joel sherrill
joel.sherrill@OARcorp.com