You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

How-to Build New Applications

Checkout top level release directory and cd to it. This contains the Makefile infrastructure:

cvs co -d <mydir> release
cd <mydir>

Checkout the appropriate projects:

cvs co rce
cvs co rceusr
cvs co rceapp

The ideas behind these three projects are as follows:

  • rce project provides common infrastructure that should be re-usable for all software that runs on the RCE. It is like a C++ extension of the RTEMS BSP (e.g. network, thread wrappers, ethernet/PGP PIC drivers).
  • rceusr is higher level code that can be reused (e.g. libraries to support a console application, or a particular use of PGP).
  • rceapp is the highest level executables.

Edit projects.mk according to your needs (this is the list of projects to build)

Build one or more of the available targets, eg:

gmake ppc-rtems-rce405
gmake i386-linux

You may append -opt to the architecture name for building with optimization and/or -dbg for building with the debugging information. For example the following commands specify valid targets:

gmake i386-linux-opt
gmake i386-linux-dbg
gmake i386-linux-opt-dbg

These commands can be issued at the top level to build the specified architecture for all projects in the release, at the project level to build all packages for that project or at the package level to build one package only. Note that:

gmake rceapp.console.ppc-rtems-rce405

and

cd rceapp/console
gmake ppc-rtems-rce405

are equivalent.

Note that we use shared libraries on Linux, but with the much-improved-but-not-perfect $ORIGIN approach for locating shared libraries, so there is no more LD_LIBRARY_PATH or RPATH to worry about.

Software Storage

There are three types of flash memory currently associated with the RCE:

  • "platform flash" is flash memory that stores the Xilinx FPGA configuration
  • "petacache flash" is the flash memory that lives on DIMM boards associated with the slice FX20s
  • "configuration flash" is controlled by the powerPC software, and contains elf executable images and data needed by the powerPC.

Only the third is relevant for software. The configuration flash is 32MB samsung chip. The filesystem supports 64 files of which 16 may contain executable images. The remainder of the files may be used for storage of data. The image loaded on board-reset is determined by a rotary selector switch on the front-panel (one for each of the two RCEs on a board). The configuration flash may be programmed as described in the Debug section.

  • No labels