RTEMS Eclipse Manual (5.3).

Copyrights and License

© 1988, 2015 On-Line Applications Research Corporation (OAR)

This document is available under the Creative Commons Attribution-ShareAlike 4.0 International Public License.

The authors have used their best efforts in preparing this material. These efforts include the development, research, and testing of the theories and programs to determine their effectiveness. No warranty of any kind, expressed or implied, with regard to the software or the material contained in this document is provided. No liability arising out of the application or use of any product described in this document is assumed. The authors reserve the right to revise this material and to make changes from time to time in the content hereof without obligation to notify anyone of such revision or changes.

The RTEMS Project is hosted at https://www.rtems.org. Any inquiries concerning RTEMS, its related support components, or its documentation should be directed to the RTEMS Project community.

1. Overview

Welcome to the RTEMS Eclipse Manual.

This document covers using Eclipse with RTEMS.

RTEMS, Real-Time Executive for Multiprocessor Systems, is a real-time executive (kernel) which provides a high performance environment for embedded applications.

Eclipse is an Integrated Development Environment (IDE) for a wide range of languages and platforms.

RTEMS’s eco-system provides all the tools and capabilities to integrate with Eclipse. You can build and develop RTEMS with Eclipse as well as build applications with Eclipse.

Unless otherwise stated this document refers to the Eclipse Mars release.

2. RTEMS Development

RTEMS can be developed using Eclipse. The RTEMS kernel is an autotools or autoconf and automake based package. You can create a project in Eclipse that lets you configure and build a BSP for an architecture. We assume you have already build and installed your tools using the RTEMS Source Builder.

2.1. Kernel Source

Download or clone the RTEMS Kernel source code. We will clone the source code:

$ git clone git://git.rtems.org/rtems.git rtems.master
Cloning into 'rtems'...
remote: Counting objects: 483342, done.
remote: Compressing objects: 100% (88974/88974), done.
remote: Total 483342 (delta 390053), reused 475669 (delta 383809)
Receiving objects: 100% (483342/483342), 69.88 MiB | 1.37 MiB/s, done.
Resolving deltas: 100% (390053/390053), done.
Checking connectivity... done.

We need to bootstrap the kernel source code. A botostrap invokes the various autotools commands need to generate build system files. First we need to the path to our tools:

$ export PATH=/opt/rtems/5/bin:$PATH

Now run the bootstrap command:

$ cd rtems.master
$ ./bootstrap

Sit back, this can take a while. The Getting Started Guide talks about using the RSB’s sb-bootstrap to run the bootstrap process in parallel on all available cores. The output of the bootstrap has not been copied into this documentment.

The source code is now ready.

2.2. Eclipse SDK Software

We need the following Eclipse SDK Software packages installed:

  • C/C++ Autotools support

  • C/C++ Development Tools

  • C/C++ GCC Cross Compiler Support

Start Eclipse and check to see if you have the them installed via the Help, Installation Details menu item:

Help, Installation Details

The dialog box shows the installed software packages and you can see the C/C++ Autotools support and the C/C++ Development Tools are installed:

SDK Installation Details

You can see some other software packages are installed in the figure. You can ignore those.

If you do not have the listed software packages install select Help, Install New Software and in the Work with: list box select http://download.eclipse.org/releases/mars.

Help, Install New Software

Afer a small period of time a list of available packages will populate and you can select the ones we are interested in. Enter autotools in the search box and select the package:

C/C++ Autotools support

Clear the search line and enter development tools in the search box and then scroll down to find C/C++ Development Tools:

C/C++ Development Tools

Again clear the search line and enter gcc cross in the search box and select the package:

C/C++ GCC Cross Compiler Support

Click Next and once the Install Details have determined what is needed select Finish to install the packages.

2.3. Kernel Build Project

We create a project in Eclipse that can configure and build RTEMS for the pc686 BSP. This BSP is based on the pc386 BSP and is under the i386 architecture.

We assume you have built and installed the i386 RTEMS Tools, obtained the RTEMS kernel code and bootstrapped it if a git clone, and installed the required Eclipse Software packages.

The paths used in this project are:

/opt/work/rtems/4.11

The RTEMS Tools prefix the tools are install under.

/opt/work/chris/rtems/kernel/rtems.master

The RTEMS Kernel source code.

/opt/work/chris/rtems/kernel/5

The RTEMS Kernel prefix.

/opt/work/chris/rtems/kernel/bsp/pc

The RTEMS Kernel BSP build directory.

The menus shown here may vary from those you have as Eclipse changes them based on what you do.

Select File, New, Project :

File, New, Project...

Click on C/C++ and select Makefile Project with Existing Code then select Next :