Comtrol eCos - Manual (Page 751)

Installation
Name
Installation — Preparing to use the synthetic target
Host-side Software
To get the full functionality of the synthetic target, users must build and install the I/O auxiliary ecosynth and
various support files. It is possible to develop applications for the synthetic target without the auxiliary, but only
limited I/O facilities will be available. The relevant code resides in the
host subdirectory of the synthetic target
architectural HAL package, and building it involves the standard configure, make, and make install steps.
There are two main ways of building the host-side software. It is possible to build both the generic host-side
software and all package-specific host-side software, including the I/O auxiliary. in a single build tree. This involves
using the configure script at the toplevel of the eCos repository, which will automatically search the
packages
hierarchy for host-side software. For more information on this, see the README.host file at the top of the repository.
Note that if you have an existing build tree which does not include the synthetic target architectural HAL package
then it will be necessary to rerun the toplevel configure script: the search for appropriate packages happens at
configure time.
The alternative is to build just the host-side for this package. This involves creating a suitable build directory and
running the configure script. Note that building directly in the source tree is not allowed.
$ cd < somewhere suitable >
$ mkdir synth_build
$ cd synth_build
$ < repo <> /packages/hal/synth/arch/ < version > /host/configure < options >
$ make
$ make install
The code makes extensive use of Tcl/TK and requires version 8.3 or later. This is checked by the configure script.
By default it will use the system’s Tcl installation in
/usr . If a different, more recent Tcl installation should be
used then its location can be specified using the options --with-tcl= < path > , --with-tcl-header= < path >
and --with-tcl-lib= < path > . For more information on these options see the README.host file at the toplevel
of the eCos repository.
Some users may also want to specify the install location using a --prefix= < path > option. The default install
location is /usr/local . It is essential that the bin subdirectory of the install location is on the user’s search PATH,
otherwise the eCos application will be unable to locate and execute the I/O auxiliary ecosynth.
Because ecosynth is run automatically by an eCos application rather than explicitly by the user, it is not installed
in the
bin subdirectory itself. Instead it is installed below libexec , together with various support files such as
images. At configure time it is usually possible to specify an alternative location for libexec using --exec-
prefix= < path > or --libexecdir= < path > . These options should not be used for this package because the
eCos application is built completely separately and does not know how the host-side was configured.
647