Chapter 17. Building

When you have configured eCos, you may build the configuration.

On the Build menu, click:

  • Library (or click the Build Library icon on the toolbar) – this causes the eCos configuration to be built. The result of a successful build will be (among other things) a library against which user code can be linked

  • Tests – this causes the eCos configuration to be built, and additionally builds the relevant test cases linked against the eCos library

  • Clean – this removes all intermediate files, thus causing a subsequent build/library or build/tests operation to cause recompilation of all relevant files.

  • Stop – this causes a currently executing build (any of the above steps) to be interrupted

  • Generate Build Tree – this causes a build tree to be generated for the existing eCos configuration. The option is greyed out if there are any conflicts. This will only overwrite makefiles and headers that must be changed as a result of a change in the eCos configuration since the previous build tree was last generated.

Note: Any changes made to automatically generated makefiles and headers will be lost whenever a new build tree is generated. These files must therefore never be edited.

When either Build->Library (F7) or Build->Tests (Shift+F7) are selected, before the build is permitted to start:

  • if there are any conflicts within your eCos configuration, you will be prompted to resolve these

  • if you have not already saved your eCos configuration, you will be prompted to do so

  • a build tree will be generated automatically. This will only overwrite makefiles and headers that must be changed as a result of a change in the eCos configuration since the previous build tree was last generated.

Build options may be displayed by using the Build->Options menuitem. This displays a dialog box containing a drop-list control and two windows. The drop-list control allows you to select the type of build option to be displayed (for example “LDFLAGS” are the options applied at link-time. The left-hand window is a tree view of the packages loaded in the current configuration. The right-hand window is a list of the build options that will be used for the currently selected package.

Note that this dialog box currently affords only read-only access to the build options. In order to change build options you must edit the relevant string configuration item.

A single level of inheritance is supported: each package’s build options are combined with the global options (these are to be found in the “Global build options” folder in the configuration view).

Selecting Build Tools

Normally the profile or installation process will supply the information required for the eCos Configuration Tool to locate the build tools (compiler, linker, etc.) necessary to perform a build. However if this information is not registered, or it is necessary to override or specify the location manually (for example, to use a user-defined toolchain), select Tools->Paths->Build Tools... to set user-defined build tools. This location will take precedence over the build tools defined by the Profile or PATH environment. This setting will also remain persistent on subsequent invocations of the eCos Configuration Tool. The following dialog box will be displayed:

Figure 17-1. Build tools

This dialog box allows you to locate the folder containing the build tools or toolchain.

Note: User-defined build tools set in this way will override the the build tool setting provided by the Profile. Furthermore this override will be saved persistently for that profile. However if you switch to a different profile, then the appropriate build tool settings for that new profile will be used instead (or if user-defined build tools had previously been set for that new profile, then those will be used).

2017-02-09
Documentation license for this page: Open Publication License