Chapter 15. The Configuration

15.1. Adding and Removing Packages

To add or remove packages from the configuration, select BuildPackages (Ctrl+P). The following dialog box will be displayed:

Figure 15.1. Packages dialog box

Packages dialog box

The left-hand list shows those packages that are available to be loaded. The right-hand list shows those that are currently loaded. In order to transfer packages from one list to another (that is, to load or unload packages) double-click the selection or click the Add or Remove buttons.

The version drop-down list displays the versions of the selected packages. When loading packages, this control may be used to load versions other than the most recent (current). Note that if more than one package is selected, the version drop-down list will display only the versions common to all the selected packages.

The window under the version displays a brief description of the selected package. If more than one package is selected, this window will be blank.

Under the description window there is a Keywords control into which you can type a string to be matched against package names, macro names and descriptions. The lists are updated a second or so after typing has stopped. If you type several separate words, all of these words must be associated with a given package for that package to be displayed. If you select the Match exactly checkbox, then the string is taken to be a complete fragment and matched against the beginning of a name, macro name or descriptions. All matches are done case-insensitively.

If you check Omit hardware packages, only non-hardware packages will be shown.

15.2. Switching Targets, Repositories and Versions

To migrate an eCos configuration to a different target, version of eCosPro, or repository, the following steps should be followed:

  • Export the existing configuration to an .ecm file.

  • Confirm the target and template set in the existing configuration using the Repository Information dialog illustrated in Figure 15.7, “Repository and Configuration Information dialog box”. HelpRepository Information (Ctrl+I)

  • If applicable, switch to the new version, repository or profile using the file menu: BuildProfile (Alt+P).

  • Create a new configuration by selecting the new target (if applicable) and template, selecting same template as the original configuration FileNew Target (Alt+N) illustrated in Figure 7.3, “Target and Template selection”.

    Set the hardware template and the packages template to the originals determined above.To select a hardware template, choose from the first drop-list. To choose a packages template, choose from the second. Brief descriptions of each kind of template are provided in the corresponding edit boxes.

  • Import the original configuration from the exported .ecm file create in the first step above.

  • Resolve conflicts, if any.

  • Save the configuation.

[Note]Note
  • While it remains possible to switch targets within a configuration using the command line tool ecosconfig, users are advised against this as inferred changes within common hardware packages to both the targets are not reset or re-inferred unless a conflict arises as a result of the switch. This may result in unexpected or unintended consequences. For example, while a template may contain the SPI package, this package may be disabled through inference as a result of the initial target hardware lacking an SPI device. However, when switching to a processor variant with more cells, such as one that includes an SPI device, the SPI package could remain disabled when the configuration is switched to the more superior variant (unless of course it is marked as required by the CDL which would result in a conflict and so would be re-enabled). While this is perfectly legimate behavior (e.g. SPI support could be disabled on a superior variant if it were not required by the CDL), users are advised to use the method above when switching targets.

  • The same method described above may be used to switch an existing target, template and custom configuration to a new version, profile or repository.

15.3. Platform Selection

To add, modify or remove entries in the list of platforms used for running tests, select ToolsPlatforms (Ctrl+P). The following dialog will be displayed:

Figure 15.2. Platforms dialog box

Platforms dialog box

You may add, modify or remove platform entries as you wish, but in order to run tests, a platform must be defined to correspond to the currently loaded hardware template. The information associated with each platform name is used to run tests.

To modify a platform, click the Modify button with the appropriate platform selected, or double-click on an entry in the list. A dialog will be displayed that allows you to change the command prefix, platform type and arguments for GDB.

Figure 15.3. Platform Modify dialog box

Platform Modify dialog box

To add a new platform, click the Add button. A similar dialog will be displayed that allows you to define a new platform. To remove a platform, click the Delete button or press the DEL key with the appropriate platform selected.

Platform dialog fields

Command prefix

Used when running tests in order to determine the names of the executables (such as gdb) to be used. For example, if the gdb executable name is “arm-eabi-gdb.exe” the prefix should be set to “arm-eabi”.

Arguments for GDB

Specifies the set of commands, in sequence, are normally required to run an eCos test from start to finish. This includes how to specify the remote timeout (necessary for some slower forms of hardware debugger, or to provide for additional delays if the hardware is remotely accessed on a slow internet connection) and how to make provision for retrieving diagnostic messages from the target.

Inferior

Specifies the full GDB command with arguments to be launched in order to commence each test. If the executable is not on the PATH, the full path to the executable must be used.

Prompt

Specifies the prompt to expect before executing the next gdb command provided in the list above.

Variables: To facilitate easy modification of test executables, timeouts, baud rates, target location, etc. the Arguments for GDB and Inferior may reference variables which are replaced at execution time. The following variables may be used:

Platform variables

%b

Serial baud rate

%p

Port, such as the serial port, path to the device, TCPIP address and port, pipe and pipe command

%e

Full path name to the test executable

%E(VARIABLE)

The value of the environment variable VARIABLE.

See Section 11.2, “Environment Variables” for further information on environment variables.

15.4. Using Templates

To switch a configuration to a new template, select BuildTemplates (Ctrl+M).

The following dialog box will be displayed:

Figure 15.4. Templates dialog box

Templates dialog box

The target hardware dialog will be disabled as switching hardware within a configuration can have unintended consequences within eCos. See Section 15.2, “Switching Targets, Repositories and Versions” for details on how to switch a configuration to a new target.

To choose a packages template, choose from the template drop-down. Brief descriptions of each kind of template are provided in the corresponding edit boxes.

15.4.1. Resolving conflicts

During the process of configuring eCos it is possible that conflicts will be created. For more details of the meaning of conflicts, see Chapter 22, CDL Concepts.

The Conflicts Window displays all conflicts in the current configuration. Additionally, a window in the status bar displays a count of the conflicts. Because the resolution of conflicts can be time-consuming, a mechanism exists whereby conflicts can be resolved automatically.

You can choose to have a conflicts resolution dialog box displayed by means of the ViewSettings (Ctrl+T) menu item, on the Conflict Resolution tab of the dialog.

Figure 15.5. Options

Options

You can choose to have conflicts checked under the following circumstances:

  • After any item is changed (in other words, as soon as the conflict is created)

  • Before saving the configuration (including building)

  • Never

The method you chose depends on how much you need your configuration to be free of conflicts. You may want to avoid having to clean up all the conflicts at once, or you may want to keep the configuration consistent at all times. If you have major changes to implement, which may resolve the conflicts, then you might want to wait until after you have completed these changes before you check for conflicts.

[Note]Note

If you choose to check conflicts after any item is changed, only newly arising conflicts are displayed. If you choose to check for conflicts before saving the configuration, the complete set is displayed.

15.4.2. Automatic resolution

If you check the “Automatically suggest fixes” check box, a conflicts resolution dialog box will be displayed whenever new conflicts are created. The same dialog box may be displayed at any stage by means of the ToolsResolve Conflicts menu item.

The conflicts resolution dialog box contains two major windows.

Figure 15.6. Resolve conflicts window

Resolve conflicts window

The upper contains the set of conflicts to be addressed; the format of the data being as that of the Conflicts Window. The lower window contains a set of proposed resolutions – each entry is a suggested configuration item value change that as a whole may be expected to lead to the currently selected conflict being resolved.

Note that there is no guarantee:

  • that automatic resolutions will be determinable for every conflict.

  • that the resolutions for separate conflicts will be independent. In other words, the resolution of one conflict may serve to prevent the resolution of another.

  • that the resolution conflicts will not create further conflicts.

The above warnings are, however, conservative. In practice (so long as the number and extent of conflicts are limited) automatic conflict resolution may be used to good effect to correct problems without undue amounts of programmer intervention.

In order to select the conflicts to be applied, select or clear the check boxes against the resolutions for each proposed resolution. By default all resolutions are selected; you can return to the default state (in other words, cause all check boxes for each conflict to again become checked) by pressing the “Reset” button. Note that multiple selection may be used in the resolutions control to allow ranges of check boxes to be toggled in one gesture.

When you are happy to apply the selected resolutions for each conflict displayed, click Apply; this will apply the resolutions. Alternatively you may cancel from the dialog box without any resolutions being applied.

15.5. Configuration Information

An important part of creating products using eCos is determining the licenses under which the sources forming the active packages of an eCos configuration are distibuted. To assist with this process, all top-level eCos packages have one or more license attributes associated with the package. Each attribute name indicates the licenses under which the source code of the package is distributed. Some example attributes and their associated licenses are:

Table 15.1. License Attributes


If a top-level package is select within the configuration tree, the properties window will include an Attributes property field that contains the attributes associated with the package.

Figure 15.7. Repository and Configuration Information dialog box

Repository and Configuration Information dialog box


In addition to the Attributes property field, the configuration tool includes a Repository and Configuration dialog, as illustrated above. This dialog displays summary information of the user's configuration and may be opened by selecting the HelpRepository Information (Ctrl+I) menu option. An HTML copy of the summary information may also be saved to a local file for reference purposes through the Save option of the dialog box.

As illustrated, the repository, hardware template and packages template used in generating the initial configuration are displayed, as well as any packages subsequently added or removed from the initial configuration. Lastly, the license attributes allocated to each top-level package used in the configuration are presented, with the macro names of packages with that attribute appearing beneath each license attribute. If a license attribute is selected, the configuration tool will open a browser window to the corresponding license on eCosCentric's web site. If an evaluation package has been included, the developer is alerted in the summary that binaries generated by this eCos configuration will require a commercial license for the eCosPro packages listed. Note that because packages may have multiple license attributes and so the macro names may appear more than once in the licensing breakdown.

[Note]Note

The Attributes property as well as the additional repository, configuration and licensing information are only available in verions of eCosPro 4.0 and above.