RTEMS 4.9.6 On-Line Library

Using the RTEMS configure Script Directly

Getting Started with RTEMS

5.5.1: Using the RTEMS configure Script Directly

Make a build directory under tools and build the RTEMS product in this directory. The ../rtems-4.9.<VERSION>/configure command has numerous command line arguments. These arguments are discussed in detail in documentation that comes with the RTEMS distribution. A full list of these arguments can be obtained by running ../rtems-4.9.<VERSION>/configure --help If you followed the procedure described in the section Unarchive the RTEMS Source, these configuration options can be found in the file tools/rtems-4.9.<VERSION>/README.configure.

NOTE: The GNAT/RTEMS run-time implementation is based on the POSIX API and the GNAT/RTEMS run-time cannot be compiled with networking disabled. Your application does not have to use networking but it must be enabled. Thus the RTEMS configuration for a GNAT/RTEMS environment MUST include the --enable-posix --enable-networking flag.

The following shows the command sequence required to configure, compile, and install RTEMS with the POSIX API, FreeBSD TCP/IP, and C++ support disabled. RTEMS will be built to target the BOARD_SUPPORT_PACKAGE board.

mkdir build-rtems
cd build-rtems
../rtems-4.9.VERSION/configure --target=<TARGET_CONFIGURATION> \
    --disable-posix --disable-networking --disable-cxx \
    --enable-rtemsbsp=<BSP>\
    --prefix=<INSTALL_POINT>
make all install

<TARGET> is of the form <CPU>-rtems4.9 and the list of currently supported <TARGET> configuration's and <BSP>'s can be found in tools/RTEMS-4.9.<VERSION>/README.configure.

<INSTALL_POINT> is typically the installation point for the tools and defaults to /opt/rtems-4.9.

BSP is a supported BSP for the selected CPU family. The list of supported BSPs may be found in the file tools/rtems-4.9.<VERSION>/README.configure in the RTEMS source tree. If the BSP parameter is not specified, then all supported BSPs for the selected CPU family will be built.

NOTE: The POSIX API and networking must be enabled to use GNAT/RTEMS.

NOTE: The make utility used should be GNU make.

Getting Started with RTEMS