Software Installation
To Contents | To previous page | To next page

## Software Installation

### Software Installation on Windows

If you have a CD distribution of the eCos Developer's Kit, you have received the eCos software and its supporting utilities on a single CDROM for installation on a PC-compatible computer running Windows NT 4.0, Windows 95, or Windows 98. If you use NT you must apply the NT 4.0 Service Pack 3 or above before installing eCos. Support is only for Windows NT 4.0. Installations on other Windows platforms are beta.

The following components are provided on the eCos CDROM:

- eCos source code

- Prebuilt eCos libraries and tests

- eCos documentation

- Red Hat GNUPro compiler toolchain for eCos source code compilation

- Red Hat Cygwin environment: this product provides a POSIX compatibility layer on top of Windows NT, and supports the GNUPro tools on Windows NT.

- The GNU user tools--a collection of utilities that developers, particularly those with a UNIX background, will find useful. However, they are not supported by Red Hat.

- Documentation for the GNUPro tools, including a Reference Manual for the particular evaluation board being used to run eCos.

If you have obtained the Net release of eCos for Windows, you will have the distribution in a self-extracting archive. Apart from the difference in medium, the installation procedure for eCos itself will be the same as for the CDROM-based distribution.

The software installation process involves a number of installation utilities. Some familiarity with Windows is assumed.

1. Invoke the file Setup.exe on the CDROM. This will start the installation procedure. If you have the `autorun` feature enabled, Windows will run Setup.exe automatically when the CDROM is inserted into the drive.

2. The setup program will offer to install the GNU user tools. Click `Ok` .

3. You will be prompted for a path in which to install the GNU user tools. The default will be in the `/cygnus/gnupro/i686-cygwin32/i686-cygwin32` hierarchy (usually on drive C). It will then offer to install the source code and documentation for the GNU user tools. It is recommended that you install the documentation, but not the source code, unless you are interested in modifying or recompiling the GNU user tools.

4. At this point the setup program will begin installing eCos. Click `Ok` .

5. The default path offered for eCos installation will be in the `/Program Files/Red Hat` hierarchy (usually on drive C). You may change this path, and indeed you will need to change it if that partition does not have sufficient free disk space available. It is recommended that you accept the default selection of software components for installation.

6. You will be asked to select the program folder under which the eCos menu items will be placed. The default folder name is `Red Hat eCos` .

7. The installation should finish normally, offering to show you the `README` file that contains any last minute information and a list of known problems detected after this document was printed. Once the installation is finished, you can start eCos or view the online documentation by selecting Start -> Programs -> Red Hat eCos , and then choosing an option within this folder, e.g Configuration Tool , Package Administration Tool , etc.

At this point you are ready to configure and build a customized eCos kernel as described in Configuring and Building eCos from Source .

### Software Installation on UNIX

Installation and build instructions for the eCos Net release are available on the Red Hat eCos web site `http://sourceware.cygnus.com/ecos/`

Users of the eCos Developer's Kit under UNIX should use the following instructions, which assume that the CD-ROM is available at `/cdrom/cdrom0` .

1. Extract the eCos repository from the compressed tar archive ecos-131.taz , located in the root directory of the CD-ROM using the following commands:
   `
   # mkdir /usr/local
   # cd /usr/local
   # zcat < /cdrom/cdrom0/ecos-131.taz | tar xvf -
   `
   On completion, the eCos repository may be found in the directory `/usr/local/ecos-1.3.1` .

2. Extract the eCos development tools from the compressed tar archive `tool-bin.taz` , located in the root directory of the CD-ROM, using the following commands:
   `
   # mkdir /usr/cygnus
   # cd /usr/cygnus
   # zcat < /cdrom/cdrom0/tool-bin.taz | tar xvf -
   `
   On completion, the executable files of the eCos development tools may be found in the directory `/usr/cygnus/ecos-DEVTOOLSVERSION/H-host-triplet/bin` . The source code for the development tools may optionally be installed in the same way:
   `
   $ zcat < /cdrom/cdrom0/tool-src.taz | tar xvf -`

3. Add the eCos development tools and any native tools supporting the eCos build process to the front of your path. Under Solaris, for example, you should modify the PATH environment variable as follows.
   Using sh, ksh, or bash:
   `
   $ PATH=/usr/cygnus/ecos-99r1-991015/H-sparc-sun-solaris2.5/bin:/usr/xpg4/bin:/usr/ucb:$PATH
   $ export PATH
   `
   Using csh or tcsh:

Note that csh also requires the shell command "rehash" after modifying the path for the path change to take effect.
`
% setenv PATH /usr/cygnus/ecos-99r1-991015/H-sparc-sun-solaris2.5/bin:/usr/xpg4/bin:/usr/ucb:$PATH
`
At this point you are ready to configure and build a customized eCos kernel as shown in Configuring and Building eCos from Source .

### NOTE

The order of directories in the PATH is very important, and build failures may result if the PATH is not set correctly. If you are having difficulties in building eCos, please make sure you have set the PATH exactly as above.

Software Installation
To Contents | To previous page | To next page