<!-- {{{ Banner                         --><!-- =============================================================== --><!--                                                                 --><!--     installation.sgml                                           --><!--                                                                 --><!--     eCos User Guide                                             --><!--                                                                 --><!-- =============================================================== --><!-- ####COPYRIGHTBEGIN####                                          --><!--                                                                 --><!-- =============================================================== --><!-- Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.  --><!-- Copyright (C) 2003 Nick Garnett                                 --><!-- This material may be distributed only subject to the terms      --><!-- and conditions set forth in the Open Publication License, v1.0  --><!-- or later (the latest version is presently available at          --><!-- http://www.opencontent.org/openpub/)                            --><!-- Distribution of the work or derivative of the work in any       --><!-- standard (paper) book form is prohibited unless prior           --><!-- permission obtained from the copyright holder                   --><!-- =============================================================== --><!--                                                                 -->      <!-- ####COPYRIGHTEND####                                            --><!-- =============================================================== --><!-- #####DESCRIPTIONBEGIN####                                       --><!--                                                                 --><!-- ####DESCRIPTIONEND####                                          --><!-- =============================================================== --><!-- }}} --><part ID="user-guide-installation"><TITLE>Installing <productname>eCos</productname></TITLE><!-- {{{ System Requirements            --><chapter id="user-guide-installation-requirements"><title>System Requirements</title><ITEMIZEDLIST><LISTITEM><PARA><!-- <conditionaltext> -->Standard Intel architecture PC running Linux (tested on recent Red Hat, SuSE and Debian distributions), Microsoft Windows NT (no earlier than 4.0 + SP6a), Windows 2000 and Windows XP. Linux distributions from other vendors may also work, but are currently untested. </PARA></LISTITEM><LISTITEM><PARA>Enough <!-- <index></index> --> disk space for the installeddistribution. The <productname>eCos</productname> installation processwill detail the various components of <productname>eCos</productname>and the compiler toolkit that can be installed, and their disk spacerequirements.</PARA></LISTITEM><LISTITEM><PARA>64MB of RAM and a 350MHz or faster Pentium processor.</PARA><!-- <conditionaltext> --></LISTITEM></ITEMIZEDLIST><PARA>If you are downloading the <productname>eCos</productname>release distribution from <ULINKURL="http://ecos.sourceware.org">ecos.sourceware.org</ULINK>,you will also need space to store that image and to compile thetoolchain and <productname>eCos</productname> from source.</PARA></chapter><!-- }}} --><!-- {{{ Installation on Linux          --><chapter id="user-guide-installation-linux"><title>Installation on Linux</title><para>Full instructions for the <ULINKURL="http://ecos.sourceware.org/getstart.html">downloading andinstallation of eCos</ULINK> on Linux hosts are provided on the eCoswebsite.</para></chapter><!-- }}} --><!-- {{{ Installation on Windows        --><chapter id="user-guide-installation-windows"><title>Installation on Windows</title><para>Full instructions for the <ULINKURL="http://ecos.sourceware.org/getstart.html">downloading andinstallation of eCos</ULINK> on Windows hosts are provided on theeCos website.</para></chapter><!-- }}} --><!-- {{{ Target Setup                   --><chapter id="user-guide-installation-target"><title>Target Setup</title><PARA>While <productname>eCos</productname> supports a variety oftargets, communication with all the targets happens in one of fourways. These are described in general below. Any details or variationsfrom these descriptions will be found in the<productname>eCos</productname> documentation for a specific target,in the appendix.</PARA><SECT1 id="connecting-target-serial"><TITLE><!-- <index></index> -->Connecting Via Serial Line</TITLE><PARA>Most targets will have RedBoot or GDB Stubs installed.These normally waits for GDB to connect at 38400 baud, using 8 databit, no parity bit and 1 stop-bit and no hardware flow control. Checkthe documentation for your target to ensure it uses this speed. If not,adjust the following instructions accordingly.</PARA><PARA>The following instructions depend on your having selectedthe appropriate serial port on the host. That is, the serial portwhich connects to the target's (primary) serial port. OnLinux this could be <FILENAME>/dev/ttyS0</FILENAME>,while the same port on Windows would be named COM1.Substitute the proper serial port name in the below.</PARA><PARA>Connect to the target by issuing the following commands inGDB console mode:</PARA><PROGRAMLISTING>(gdb) set remotebaud 38400    <!-- <conditionaltext> -->(gdb) target remote /dev/ttyS0</PROGRAMLISTING><PARA>In Insight, connect by opening the <EMPHASIS>File-&#62;TargetSettings</EMPHASIS> window and enter:</PARA><PROGRAMLISTING>Target: Remote/Serial     Baud Rate: 38400     Port: /dev/ttyS0</PROGRAMLISTING><PARA>Set other options according to preference, close the windowand select <EMPHASIS>Run-&#62;Connect to target</EMPHASIS>.</PARA></SECT1><!-- ==================================================== --><SECT1 id="connecting-target-ethernet"><TITLE><!-- <index></index> -->Connecting Via Ethernet</TITLE><PARA>Some targets allow GDB to connect via Ethernet - if so, it willbe mentioned in the document describing the target. Substitute thetarget's assigned IP address or hostname for &lt;hostname&#62; in thefollowing. Depending on how RedBoot has been configured, it willeither have this address allocated statically, or will acquire it viaBOOTP. In both cases RedBoot will report the IP address it islistening on in its startup message printed on the serial port. The&lt;port&#62; is the TCP port which RedBoot is listening on, usually9000. It is also listed in the target document.</PARA><PARA>Connect to the target by issuing the following command inGDB console mode:</PARA><PROGRAMLISTING>(gdb) target remote &lt;hostname&#62;:&lt;port&#62;</PROGRAMLISTING><PARA>In Insight, connect by opening the <EMPHASIS>File-&#62;TargetSettings</EMPHASIS> window and enter:</PARA><PROGRAMLISTING>Target: Remote/TCP     Hostname: &lt;hostname&#62;     Port: &lt;port&#62;</PROGRAMLISTING><PARA><!-- <conditionaltext> -->Set other options according topreference, close the window and select <EMPHASIS>Run-&#62;Connect totarget</EMPHASIS>.</PARA></SECT1><!-- ==================================================== --><SECT1 id="connecting-target-sim"><TITLE><!-- <index></index> -->Using A Simulator Target</TITLE><PARA>GDB connects to all simulator targets using the same basiccommand, although each simulator may require additional options.These are listed in the document describing the target, and shouldbe used when connecting.</PARA><PARA>Connect to the target by issuing the following command inGDB console mode:</PARA><PROGRAMLISTING>(gdb) target sim [target specific options]</PROGRAMLISTING><PARA>In Insight, connect by opening the <EMPHASIS>File-&#62;TargetSettings</EMPHASIS> window and enter:</PARA><PROGRAMLISTING>Target: Simulator     Options: [target specific options]</PROGRAMLISTING><PARA>Set other options according to preference, close the window andselect <EMPHASIS>Run-&#62;Connect to target</EMPHASIS>.</PARA></SECT1><!-- ==================================================== --><SECT1 id="connecting-target-synth"><TITLE>Using A Synthetic Target</TITLE><PARA>Synthetic targets are special in that the built tests andapplications actually run as native applications on the host. Thismeans that there is no target to connect to. The test or applicationcan be run directly from the GDB console using:</PARA><PROGRAMLISTING>(gdb) run</PROGRAMLISTING><PARA>or from Insight by pressing the <EMPHASIS>Run</EMPHASIS> icon.There is therefore no need to connect to the target or download theapplication, so you should ignore GDB &ldquo;target&rdquo; and&ldquo;load&rdquo; commands in any instructions found in other placesin the documentation.</PARA></SECT1></chapter><!-- }}} --></part>