Invoking the eCos Configuration Tool

On Linux

Invoke the configuration tool using one of the following methods:

  • Directly from a command line by specifying the full path to it from the command line: The exact location is dependant on where it was installed and by whom. For example:

    > /opt/ecos/ecoshosttools/bin/configtool       # Global installation
    > $HOME/ecospro/ecoshosttools/bin/configtool   # Local installation
  • Add the executable install directory for the eCos Configuration Tool to your PATH, and run configtool from your command line. For example:

    > export PATH=/opt/ecos/ecoshosttools/bin:$PATH
    > configtool
  • Invoking it from the Desktop as illustrated in Figure 11-1.

    Figure 11-1. Linux Menu

    The exact representation is dependent on your Linux desktop environment. The eCosPro installer uses the FreeDesktop.org's xdg-desktop-menu command, if available, to install a desktop menu item for the eCos configuration tool.

  • Run the application from the Run Application... dialog.

  • Invoking it from your File Manager

You may run configtool with zero, one or two arguments. You can specify the eCos repository location, and/or an eCos save file (extension .ecc) on the command line. The ordering of these two arguments is not significant. For example:

configtool /opt/ecos/ecos<version>/packages myfile.ecc

Once started, the Configuration Tool will be displayed (see the Section called Configuration Tool).

On Windows

There are four ways in which to invoke the eCos Configuration Tool:

  • from the desktop explorer or program set up at installation time. By default on Windows 7 and below this is: Start->Programs->eCosPro->Configuration Tool. On Windows 10 this is: ->All Apps->eCosPro->Configuration Tool.

  • navigate to the executable directory where ConfigTool.exe was installed using Windows Explorer and double-click on the command.

  • type (at a command prompt or in the Start menu’s Run item): <foldername>\ConfigTool.ex xe where <foldername> is the full path of the directory in which you installed the eCos Configuration Tool.

  • open an eCos Command shell (by default on Windows 7: Start->Programs->eCosPro->Command Shell) and run the command ConfigTool.

Figure 11-2. Windows 10 Menu

The Windows 10 Menu items added on installation are illustrated in Figure 11-2.

Once started, the Configuration Tool will be displayed (see the Section called Configuration Tool).

Configuration Tool

If multiple eCosPro installations exist you will normally be prompted to select the profile of an installation before the main configuration window is displayed. See Figure 11-4 in the Section called Profiles.

Figure 11-3. Configuration Tool

Once started, the Configuration Tool main window is displayed as illustrated in Figure 11-3.

You may run configtool with zero, one or two arguments. You can specify the eCos repository location, and/or an eCos save file (extension .ecc) on the command line. The ordering of these two arguments is not significant. For example:

configtool "c:\eCosPro\ecos-3.1.79\packages" myfile.ecc

If a profile name matching the profile used to create the eCos exists on your installation, it will automatically be selected and the user will not be prompted to select a profile as described in the Section called Profiles.

If you invoke the configuration tool from the command line with --help, you will see this output:

Usage: configtool [-ceEhpPsvV] [-p <str>] [input file 1] [input file 2]
  -c, --compile-help 	compile online help only
  -e, --edit-only    	edit save file only
  -E, --eclipse      	Eclipse mode to disable certain options
  -h, --help         	displays help on the command line parameters
  -p, --profile=<str>	specifies the eCosPro profile to use
  -P, --edit-profile 	create, edit or delete profiles only
  -s, --shell        	Open shell with selected profile
  -v, --version      	print version
  -V, --Verbose      	be verbose

This summarizes valid parameters and switches. Switches are shown with both short form and long form.

--compile-help compiles help contents files from the HTML documentation files that the tool finds in the eCos repository, and exits.

--edit-only runs the Configuration Tool in a mode that suppresses creation of a build tree, in case you only want to create and edit save files.

--eclipse runs the Configuration Tool in a mode that is used by the eCosCentric eCosPro Eclipse plug-in. This mode restricts the configuration tool to a specified eCos Configuration file and profile by disabling certain menu options, such as File->Open (Ctrl+O), File->Save As..., File->History, Build->Profile (Alt+P) and the modification of the Build (Toolchain) Tools, Host Tools and Paths. This allows eCosPro Eclipse plugin users to operate only within the corresponding Eclipse project.

--help shows valid options and parameters, as above.

--profile=<profile> selects the profile <profile> on startup, bypassing the profile dialog selection.

--edit-profile opens the profile dialog to allow editing, adding or deletion of profiles without invoking the configuration tool. This feature is particlarly useful when you only have one profile, which is also the active profile, and wish to edit it.

--shell opens the profile dialog to allow selection of a profile and opens a development shell (command line shell) for the selected profile. This is equivalent to opening the configuration tool, selecting the menu options Tools>Shell and exiting the configuration tool.

--version shows version and build date information, and exits.

--Verbose be verbose on the command line when running.

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