Index of /pub/rtems/releases/4.9/4.9.4

18 March 2010

This is the source distribution for RTEMS 4.9.4 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.4 release is the fifth release in the 4.9 series.  This
release is a bug fix release with updates to a few BSPs.  It includes
fixes for 7 bugs with PRs of varying severity.  The list of PRs is at:

http://www.rtems.org/wiki/index.php/4.9_Release_Notes#Release_4.9.4_Changes

For a full description of the enhancements included between
the 4.8 and 4.9 release series, 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-12 to reflect the Fedora version
    # Replace ARCH with your i386 or x86_64 to reflect your host architecture
    # Verify the package numbers are correct
    rpm -ivh ftp://ftp.rtems.org/pub/rtems/linux/4.9/fedora/NNN/ARCH/rtems-4.9-yum-conf-0.14-1.fcNNN.noarch.rpm ftp://ftp.rtems.org/pub/rtems/linux/4.9/fedora/NNN/ARCH/rtems-4.9-release-0.21-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 (sparc/sis,
powerpc/psim, or mips/jmr3904), 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.4.tar.bz2
export PATH=/opt/rtems-4.9/bin:$PATH
mkdir b-sis
cd b-sis
../rtems-4.9.4/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
available at http://www.skyeye.org.  Please use the 1.2.6 release
until known issues in the 1.2.7 source base are addressed.

For details on running simulators and helper scripts check out the
gcc-testing CVS module.  All RTEMS BSPs which can be run by simulators
have helper scripts in that module.

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

--joel sherrill
joel.sherrill@OARcorp.com