Mercurial > ecos-v3_0-branch
annotate doc/sgml/user-guide/installation.sgml @ 2729:74dbf4c3f2e1 after-copyright-change-20090129
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
| author | jlarmour |
|---|---|
| date | Thu, 29 Jan 2009 17:47:46 +0000 |
| parents | 42a060de9457 |
| children | 1e88b56417ea |
| rev | line source |
|---|---|
| 596 | 1 <!-- {{{ Banner --> |
| 2 | |
| 3 <!-- =============================================================== --> | |
| 4 <!-- --> | |
| 5 <!-- installation.sgml --> | |
| 6 <!-- --> | |
| 7 <!-- eCos User Guide --> | |
| 8 <!-- --> | |
| 9 <!-- =============================================================== --> | |
|
2729
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
10 <!-- ####ECOSDOCCOPYRIGHTBEGIN#### --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
11 <!-- =============================================================== --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
12 <!-- Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc. --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
13 <!-- This material may be distributed only subject to the terms --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
14 <!-- and conditions set forth in the Open Publication License, v1.0 --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
15 <!-- or later (the latest version is presently available at --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
16 <!-- http://www.opencontent.org/openpub/) --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
17 <!-- Distribution of the work or derivative of the work in any --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
18 <!-- standard (paper) book form is prohibited unless prior --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
19 <!-- permission obtained from the copyright holder --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
20 <!-- =============================================================== --> |
|
74dbf4c3f2e1
Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents:
1343
diff
changeset
|
21 <!-- ####ECOSDOCCOPYRIGHTEND#### --> |
| 596 | 22 <!-- =============================================================== --> |
| 23 <!-- #####DESCRIPTIONBEGIN#### --> | |
| 24 <!-- --> | |
| 25 <!-- ####DESCRIPTIONEND#### --> | |
| 26 <!-- =============================================================== --> | |
| 27 | |
| 28 <!-- }}} --> | |
| 29 | |
| 30 <part ID="user-guide-installation"> | |
| 31 <TITLE>Installing <productname>eCos</productname></TITLE> | |
| 32 | |
| 33 <!-- {{{ System Requirements --> | |
| 34 | |
| 35 <chapter id="user-guide-installation-requirements"> | |
| 36 <title>System Requirements</title> | |
| 37 | |
| 38 <ITEMIZEDLIST> | |
| 39 | |
| 40 <LISTITEM> | |
| 41 <PARA><!-- <conditionaltext> -->Standard Intel architecture PC running | |
|
997
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
42 Linux (tested on recent Red Hat, SuSE and Debian distributions), |
|
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
43 Microsoft Windows NT (no earlier than 4.0 + SP6a), Windows 2000 and |
|
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
44 Windows XP. Linux distributions from other vendors may also work, but |
|
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
45 are currently untested. </PARA> |
| 596 | 46 </LISTITEM> |
| 47 | |
| 48 <LISTITEM> | |
| 49 <PARA>Enough <!-- <index></index> --> disk space for the installed | |
| 50 distribution. The <productname>eCos</productname> installation process | |
| 51 will detail the various components of <productname>eCos</productname> | |
| 52 and the compiler toolkit that can be installed, and their disk space | |
| 53 requirements.</PARA> | |
| 54 </LISTITEM> | |
| 55 | |
| 56 <LISTITEM> | |
| 57 <PARA>64MB of RAM and a 350MHz or faster Pentium processor.</PARA><!-- <conditionaltext> --> | |
| 58 </LISTITEM> | |
| 59 | |
| 60 </ITEMIZEDLIST> | |
| 61 | |
| 62 <PARA>If you are downloading the <productname>eCos</productname> | |
|
997
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
63 release distribution from <ULINK |
| 1343 | 64 URL="http://ecos.sourceware.org">ecos.sourceware.org</ULINK>, |
| 596 | 65 you will also need space to store that image and to compile the |
| 66 toolchain and <productname>eCos</productname> from source.</PARA> | |
| 67 | |
| 68 | |
| 69 </chapter> | |
| 70 | |
| 71 <!-- }}} --> | |
| 72 <!-- {{{ Installation on Linux --> | |
| 73 | |
| 74 <chapter id="user-guide-installation-linux"> | |
| 75 <title>Installation on Linux</title> | |
| 76 | |
| 77 <para> | |
|
997
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
78 Full instructions for the <ULINK |
| 1343 | 79 URL="http://ecos.sourceware.org/getstart.html">downloading and |
|
997
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
80 installation of eCos</ULINK> on Linux hosts are provided on the eCos |
|
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
81 website. |
| 596 | 82 </para> |
| 83 | |
| 84 </chapter> | |
| 85 | |
| 86 <!-- }}} --> | |
| 87 <!-- {{{ Installation on Windows --> | |
| 88 | |
| 89 <chapter id="user-guide-installation-windows"> | |
| 90 <title>Installation on Windows</title> | |
| 91 | |
|
997
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
92 <para> |
|
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
93 Full instructions for the <ULINK |
| 1343 | 94 URL="http://ecos.sourceware.org/getstart.html">downloading and |
|
997
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
95 installation of eCos</ULINK> on Windows hosts are provided on the |
|
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
96 eCos website. |
|
256a8a1a3333
* installation.sgml: Refer to installation instructions on the eCos website.
jld
parents:
596
diff
changeset
|
97 </para> |
| 596 | 98 |
| 99 </chapter> | |
| 100 | |
| 101 <!-- }}} --> | |
| 102 <!-- {{{ Target Setup --> | |
| 103 | |
| 104 <chapter id="user-guide-installation-target"> | |
| 105 <title>Target Setup</title> | |
| 106 | |
| 107 <PARA>While <productname>eCos</productname> supports a variety of | |
| 108 targets, communication with all the targets happens in one of four | |
| 109 ways. These are described in general below. Any details or variations | |
| 110 from these descriptions will be found in the | |
| 111 <productname>eCos</productname> documentation for a specific target, | |
| 112 in the appendix.</PARA> | |
| 113 | |
| 114 <SECT1 id="connecting-target-serial"> | |
| 115 <TITLE><!-- <index></index> -->Connecting Via Serial Line</TITLE> | |
| 116 | |
| 117 <PARA>Most targets will have RedBoot or GDB Stubs installed. | |
| 118 These normally waits for GDB to connect at 38400 baud, using 8 data | |
| 119 bit, no parity bit and 1 stop-bit and no hardware flow control. Check | |
| 120 the documentation for your target to ensure it uses this speed. If not, | |
| 121 adjust the following instructions accordingly.</PARA> | |
| 122 | |
| 123 <PARA>The following instructions depend on your having selected | |
| 124 the appropriate serial port on the host. That is, the serial port | |
| 125 which connects to the target's (primary) serial port. On | |
| 126 Linux this could be <FILENAME>/dev/ttyS0</FILENAME>, | |
| 127 while the same port on Windows would be named COM1. | |
| 128 Substitute the proper serial port name in the below.</PARA> | |
| 129 | |
| 130 <PARA>Connect to the target by issuing the following commands in | |
| 131 GDB console mode:</PARA> | |
| 132 | |
| 133 <PROGRAMLISTING> | |
| 134 (gdb) set remotebaud 38400 <!-- <conditionaltext> --> | |
| 135 (gdb) target remote /dev/ttyS0 | |
| 136 </PROGRAMLISTING> | |
| 137 | |
| 138 <PARA>In Insight, connect by opening the <EMPHASIS>File->Target | |
| 139 Settings</EMPHASIS> window and enter:</PARA> | |
| 140 | |
| 141 <PROGRAMLISTING> | |
| 142 Target: Remote/Serial | |
| 143 Baud Rate: 38400 | |
| 144 Port: /dev/ttyS0 | |
| 145 </PROGRAMLISTING> | |
| 146 | |
| 147 <PARA>Set other options according to preference, close the window | |
| 148 and select | |
| 149 <EMPHASIS>Run->Connect to target</EMPHASIS>. | |
| 150 </PARA> | |
| 151 | |
| 152 </SECT1> | |
| 153 | |
| 154 <!-- ==================================================== --> | |
| 155 | |
| 156 <SECT1 id="connecting-target-ethernet"> | |
| 157 <TITLE><!-- <index></index> -->Connecting Via Ethernet</TITLE> | |
| 158 | |
| 159 <PARA>Some targets allow GDB to connect via Ethernet - if so, it will | |
| 160 be mentioned in the document describing the target. Substitute the | |
| 161 target's assigned IP address or hostname for <hostname> in the | |
| 162 following. Depending on how RedBoot has been configured, it will | |
| 163 either have this address allocated statically, or will acquire it via | |
| 164 BOOTP. In both cases RedBoot will report the IP address it is | |
| 165 listening on in its startup message printed on the serial port. The | |
| 166 <port> is the TCP port which RedBoot is listening on, usually | |
| 167 9000. It is also listed in the target document.</PARA> | |
| 168 | |
| 169 <PARA>Connect to the target by issuing the following command in | |
| 170 GDB console mode:</PARA> | |
| 171 | |
| 172 <PROGRAMLISTING> | |
| 173 (gdb) target remote <hostname>:<port> | |
| 174 </PROGRAMLISTING> | |
| 175 | |
| 176 <PARA>In Insight, connect by opening the <EMPHASIS>File->Target | |
| 177 Settings</EMPHASIS> window and enter:</PARA> | |
| 178 | |
| 179 <PROGRAMLISTING> | |
| 180 Target: Remote/TCP | |
| 181 Hostname: <hostname> | |
| 182 Port: <port> | |
| 183 </PROGRAMLISTING> | |
| 184 | |
| 185 <PARA><!-- <conditionaltext> -->Set other options according to | |
| 186 preference, close the window and select <EMPHASIS>Run->Connect to | |
| 187 target</EMPHASIS>.</PARA> | |
| 188 | |
| 189 </SECT1> | |
| 190 | |
| 191 <!-- ==================================================== --> | |
| 192 | |
| 193 <SECT1 id="connecting-target-sim"> | |
| 194 <TITLE><!-- <index></index> -->Using A Simulator Target</TITLE> | |
| 195 | |
| 196 <PARA>GDB connects to all simulator targets using the same basic | |
| 197 command, although each simulator may require additional options. | |
| 198 These are listed in the document describing the target, and should | |
| 199 be used when connecting.</PARA> | |
| 200 | |
| 201 <PARA>Connect to the target by issuing the following command in | |
| 202 GDB console mode:</PARA> | |
| 203 | |
| 204 <PROGRAMLISTING> | |
| 205 (gdb) target sim [target specific options] | |
| 206 </PROGRAMLISTING> | |
| 207 | |
| 208 <PARA>In Insight, connect by opening the <EMPHASIS>File->Target | |
| 209 Settings</EMPHASIS> window and enter:</PARA> | |
| 210 | |
| 211 <PROGRAMLISTING> | |
| 212 Target: Simulator | |
| 213 Options: [target specific options] | |
| 214 </PROGRAMLISTING> | |
| 215 | |
| 216 <PARA>Set other options according to preference, close the window and | |
| 217 select <EMPHASIS>Run->Connect to target</EMPHASIS>.</PARA> | |
| 218 | |
| 219 </SECT1> | |
| 220 | |
| 221 <!-- ==================================================== --> | |
| 222 | |
| 223 <SECT1 id="connecting-target-synth"> | |
| 224 <TITLE>Using A Synthetic Target</TITLE> | |
| 225 | |
| 226 <PARA>Synthetic targets are special in that the built tests and | |
| 227 applications actually run as native applications on the host. This | |
| 228 means that there is no target to connect to. The test or application | |
| 229 can be run directly from the GDB console using:</PARA> | |
| 230 | |
| 231 <PROGRAMLISTING> | |
| 232 (gdb) run | |
| 233 </PROGRAMLISTING> | |
| 234 | |
| 235 <PARA>or from Insight by pressing the <EMPHASIS>Run</EMPHASIS> icon. | |
| 236 There is therefore no need to connect to the target or download the | |
| 237 application, so you should ignore GDB “target” and | |
| 238 “load” commands in any instructions found in other places | |
| 239 in the documentation.</PARA> | |
| 240 </SECT1> | |
| 241 | |
| 242 </chapter> | |
| 243 | |
| 244 <!-- }}} --> | |
| 245 | |
| 246 </part> | |
| 247 |