Platform Selection

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

Figure 15-2. 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

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.


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.


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


Serial baud rate


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


Full path name to the test executable


The value of the environment variable VARIABLE.

See the Section called Environment Variables in Chapter 11 for further information on environment variables.

Documentation license for this page: Open Publication License