eCos Configuration Tool

Status

The eCos Configuration Tool was originally written using the Microsoft Foundation Classes (configtool version 1) and ran on Microsoft Windows only. More recently, it was ported to the wxWidgets cross-platform GUI library (formerly known as wxWindows). Current development is focussed on the wxWidgets port (configtool version 2) exclusively. The version 2 tool is functionally similar to the version 1 tool but currently lacks the memory layout feature. The latest sources can be built against wxWidgets 2.4.0 (and possibly later releases) using GNU tools for both Microsoft Windows and Linux.

The eCos Configuration Tool is currently maintained by John Dallaway and feedback on the tool is always appreciated. General comments should be directed to the ecos-discuss mailing list. Specific bugs should be reported via Bugzilla. Bugzilla may also be interrogated for reported eCos Configuration Tool bugs in both the version shipped with the eCos 2.0 release and the version built from the latest CVS sources.

Downloading snapshots and source code

The eCos host tools which shipped with the eCos 2.0 public release are known to have problems when run against Cygwin 1.5.10 or later. This problem is described in Bugzilla 1000095. There is a known issue concerning C++ exception handling with Cygwin 1.5.19, Cygwin 1.5.20 and possibly later versions. The 2.0 release build of the eCos Configuration Tool is also known to not work correctly under Microsoft Vista. Unsupported snapshot builds of the host tools which incorporate fixes and workarounds for these issues may be downloaded via the following anchors:

• eCos Configuration Tool for Windows 2000 and Windows XP (2006-07-10)
• ecosconfig command line tool for Windows (2006-07-10)
• UNSTABLE eCos Configuration Tool for Windows Vista (2008-08-13)

The executable files must then be decompressed using the following commands at a bash prompt:

• bunzip2 configtool*.bz2
  bunzip2 ecosconfig*.bz2
  

The sources for the eCos Configuration Tool are available via anonymous CVS. When checking out the code, you should specify the ecos-host module in addition to the ecos module. For example:

• mkdir ~/cvs
  cd ~/cvs
  cvs -z3 -d :pserver:anoncvs@ecos.sourceware.org:/cvs/ecos \
        co -P ecos ecos-host
  

In order to rebuild the eCos Configuration Tool, wxWidgets source code is also required. The 2.0 release version of the tool is built against wxWidgets version 2.4.0. The 2.4.0 sources may be downloaded via one of the following anchors:

• wxGTK-2.4.0.tar.bz2 (for Linux/GTK+)
• wxMSW-2.4.0.zip (for Windows)

• wxGTK-2.4.0-scrolwin.patch (for Linux/GTK+)

Building for Linux/GTK+

The following instructions assume that you are working at a bash prompt and that the GTK+ and Tcl libraries have been installed from your Linux distribution. First, extract the wxWidgets sources and apply the patch:

• mkdir ~/src
  cd ~/src
  bunzip2 -c wxGTK-2.4.0.tar.bz2 | tar xf -
  cd wxGTK-2.4.0
  patch -p0 < wxGTK-2.4.0-scrolwin.patch
  

Configure wxWidgets for static linking without socket support, then build and install:

• mkdir ~/wx-build
  cd ~/wx-build
  $HOME/src/wxGTK-2.4.0/configure --disable-shared \
      --disable-sockets --prefix=$HOME/wxGTK-2.4.0
  make
  make install
  

Configure, build and install the eCos host infrastructure:

• mkdir ~/infra-build
  cd ~/infra-build
  $HOME/cvs/ecos/host/configure --prefix=$HOME/ecos-tools
  make
  make install
  

Build and install the eCos Configuration Tool (INSTALLDIR must match the eCos host infrastructure prefix):

• mkdir ~/configtool-build
  cd ~/configtool-build
  make -f ~/cvs/ecos/host/tools/configtool/standalone/wxwin/makefile.gnu \
      install WXDIR=$HOME/wxGTK-2.4.0 ECOSSRCDIR=$HOME/cvs/ecos/host \
      INSTALLDIR=$HOME/ecos-tools
  

The eCos Configuration Tool binary should now be located at: ~/ecos-tools/bin/configtool

Building for Windows

The following instructions assume that you are working at a Cygwin bash prompt and that the Cygwin development tools have been installed from the Devel category in the Cygwin installer. First, extract the wxWidgets sources:

• mkdir ~/src
  cd ~/src
  unzip wxMSW-2.4.0.zip
  

Configure wxWidgets for static linking without socket support, then build and install:

• mkdir ~/wx-build
  cd ~/wx-build
  $HOME/src/wxWindows-2.4.0/configure --disable-shared \
      --disable-sockets --prefix=$HOME/wxMSW-2.4.0
  make
  make install
  

Configure, build and install the eCos host infrastructure:

• mkdir ~/infra-build
  cd ~/infra-build
  $HOME/cvs/ecos/host/configure --prefix=$HOME/ecos-tools
  make
  make install
  

Build and install the eCos Configuration Tool (INSTALLDIR must match the eCos host infrastructure prefix):

• mkdir ~/configtool-build
  cd ~/configtool-build
  make -f ~/cvs/ecos/host/tools/configtool/standalone/wxwin/makefile.gnu \
      install WXDIR=$HOME/wxMSW-2.4.0 ECOSSRCDIR=$HOME/cvs/ecos/host \
      INSTALLDIR=$HOME/ecos-tools
  

The eCos Configuration Tool binary should now be located at: ~/ecos-tools/bin/configtool.exe