Screen Layout
To Contents | To previous page | To next page

## Screen Layout

##

The following windows are available within the eCos Configuration Tool:

- Configuration Window

- Properties Window

- Short Description

- Conflicts

- Output

The layout of the windows my be adjusted to suit your preferences: see Settings .

### Configuration Window

This is the principal window used to configure eCos. It takes the form of a tree-based representation of the configuration items within the currently loaded eCos packages.

In the case of items whose values may be changed, controls are available to set the item values. These either take the form of check boxes or radio buttons within the tree itself or cells to the right of the thin vertical splitter bar. Controls in the tree may be used in the usual way; cells, however, must first be activated.

To activate a cell, simply click on it: it will assume a sunken appearance and data can then be edited in the cell. To terminate in-cell editing, click elsewhere in the configuration window or press ENTER. To discard the partial results of in-cell editing and revert to the previous value, press ESCAPE. Note that an asterisk appears

against configuration items which have changed since the configuration was last saved.

Cells come in three varieties, according to the type of data they accept:

Cell Type | Data Accepted
Integer | Decimal or hexadecimal values
Floating Point | Floating point values
String | Any

In the case of string cells, you can double-click the cell to display a dialog box containing a larger region in which to edit the string value. This is useful in the case of long strings, or those spanning multiple lines.

#### Disabled items

Some items will appear disabled. In this case the item label and any associated controls and cells will be grayed. It is not be possible to change the values of disabled items.

##### Right-Clicking

You can right-click on an item in the configuration window item to display a pop-up menu which (depending on the type of the item selected) allows you to:

- Properties - information relating to the currently selected item is displayed. The information is equivalent to that displayed in the Properties Window.

- Restore Defaults - the default value of the currently selected item is restored.

- Visit Documentation - causes the HTML page most closely relating to the currently selected item to be displayed. This has the same effect as double-clicking the URL property in the Properties Window. Note: if this fails to display the first time you select on it, try again after the browser has appeared.

- View Header File - this causes the file containing the items to be displayed. This is equivalent to double-clicking on the File property in the Properties Window. The viewer used for this purpose may be changed using the ViewSettings menu item (see Settings ). Note that this operation is only possible when the current configuration is saved, in order to avoid the possibility of changing the source repository.

- Unload Package - this is equivalent to using the BuildPackages menu item to select and unload the package in question.

#### Conflicts Window

This window exists to display any configuration item conflicts. Conflicts are the result of failures to meet the requirements between configuration items expressed in the CDL. See "Conflicts" in CDL Concepts .

The window comprises three columns:

- Item

This is the macro name of the first item involved in the conflict.

- Conflict

This is a description of the conflict type. The currently supported types are "unresolved", "illegal value", "evaluation exception", "goal unsatisfied" and "bad data".

- Property

This contains a description of the configuration item's property that caused the conflict.

Within the conflicts window you can right-click on any item to display a context menu which allows you to choose from one of the following options:

- What's This? Gives a small description of the conflict window's purpose.

- Locate the item involved in the conflict - this will cause the configuration window to display the item relating most closely to the selected conflict (the item mentioned in the first or third column depending on where you clicked). You can also double-click on an item to locate it.

- Resolve the specified conflict - see Resolving conflicts.

#### Output Window

This window displays any output generated by execution of external tools and any error messages that are not suitable for display in other forms (for example, as message boxes).

Within the output window you can right-click to display a context menu which allows you to:

- Save the contents of the window to a file

- Clear the contents of the window

#### Properties Window

This window displays the CDL properties of the item currently selected in the configuration window. The same information may be displayed by right-clicking the item and selecting "Properties".

Two properties may be double-clicked as follows:

- URL - double-clicking on a URL property causes the referenced HTML page to be displayed. This has the same effect as right-clicking on the item and choosing "Visit Documentation".

- File - double-clicking on a File property in a saved configuration causes the File to be displayed. The viewer used for this purpose may be changed using the ViewSettings menu item. Note that this operation is only possible when the current configuration is saved, in order to avoid the possibility of changing the source repository.

#### Short Description Window

This window displays a short description of the item currently selected in the configuration window. More extensive documentation may be available by right-clicking on the item and choosing "Visit Documentation".

Screen Layout
To Contents | To previous page | To next page