doc/html/user-guide/config-tool-platform-selection.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >Platform Selection</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos User Guide"
  20 HREF="ecos-user-guide.html"><LINK
  21 REL="UP"
  22 TITLE="Updating the Configuration"
  23 HREF="config-tool-updating-configuration.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Updating the Configuration"
  26 HREF="config-tool-updating-configuration.html"><LINK
  27 REL="NEXT"
  28 TITLE="Using Templates"
  29 HREF="config-tool-using-templates.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos User Guide</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="config-tool-updating-configuration.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 19. Updating the Configuration</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="config-tool-using-templates.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="CONFIG-TOOL-PLATFORM-SELECTION">Platform Selection</H1
  86 ><P
  87 >To add, modify or remove entries in the list of
  88           platforms used for running tests, select
  89           <SPAN
  90 CLASS="emphasis"
  91 ><I
  92 CLASS="EMPHASIS"
  93 >Tools-&gt;Platforms</I
  94 ></SPAN
  95 >. The following
  96           dialog will be displayed:</P
  97 ><DIV
  98 CLASS="FIGURE"
  99 ><A
 100 NAME="AEN1393"><P
 101 ><B
 102 >Figure 19-2. Platforms dialog box</B
 103 ></P
 104 ><P
 105 ><IMG
 106 SRC="pix/toolsplatforms.png"></P
 107 ></DIV
 108 ><P
 109 >You may add, modify or remove platform entries as you
 110           wish, but in order to run tests, a platform must be defined
 111           to correspond to the currently loaded hardware template. The
 112           information associated with each platform name is used to
 113           run tests.</P
 114 ><P
 115 >To modify a platform, click the
 116           <SPAN
 117 CLASS="emphasis"
 118 ><I
 119 CLASS="EMPHASIS"
 120 >Modify</I
 121 ></SPAN
 122 > button with the appropriate
 123           platform selected, or double-click on an entry in the list.
 124           A dialog will be displayed that allows you to change the
 125           command prefix, platform type and arguments for
 126           <SPAN
 127 CLASS="emphasis"
 128 ><I
 129 CLASS="EMPHASIS"
 130 >GDB</I
 131 ></SPAN
 132 >. </P
 133 ><DIV
 134 CLASS="FIGURE"
 135 ><A
 136 NAME="AEN1400"><P
 137 ><B
 138 >Figure 19-3. Platform Modify dialog box</B
 139 ></P
 140 ><P
 141 ><IMG
 142 SRC="pix/modifyplatform.png"></P
 143 ></DIV
 144 ><P
 145 >To add a new platform, click the
 146           <SPAN
 147 CLASS="emphasis"
 148 ><I
 149 CLASS="EMPHASIS"
 150 >Add</I
 151 ></SPAN
 152 > button. A similar dialog will be
 153           displayed that allows you to define a new platform. To
 154           remove a platform, click the <SPAN
 155 CLASS="emphasis"
 156 ><I
 157 CLASS="EMPHASIS"
 158 >Delete</I
 159 ></SPAN
 160 >
 161           button or press the <SPAN
 162 CLASS="emphasis"
 163 ><I
 164 CLASS="EMPHASIS"
 165 >DEL</I
 166 ></SPAN
 167 > key with the
 168           appropriate platform selected.</P
 169 ><P
 170 >The command prefix is used when running tests in order
 171           to determine the names of the executables (such as gdb) to
 172           be used. For example, if the gdb executable name is
 173           &#8220;arm-elf-gdb.exe&#8221; the prefix should be set to
 174           &#8220;arm-elf&#8221;.</P
 175 ><P
 176 >The platform type indicates the capabilities of the platform
 177 - whether it is hardware or a simulator, and whether breakpoints
 178 are supported.</P
 179 ><P
 180 >The arguments for the <SPAN
 181 CLASS="emphasis"
 182 ><I
 183 CLASS="EMPHASIS"
 184 >GDB</I
 185 ></SPAN
 186 > field allow
 187 additional arguments to be passed to gdb when it is used to run
 188 a test.  This is typically used in the case of simulators linked
 189 to gdb in order to define memory layout.</P
 190 ></DIV
 191 ><DIV
 192 CLASS="NAVFOOTER"
 193 ><HR
 194 ALIGN="LEFT"
 195 WIDTH="100%"><TABLE
 196 SUMMARY="Footer navigation table"
 197 WIDTH="100%"
 198 BORDER="0"
 199 CELLPADDING="0"
 200 CELLSPACING="0"
 201 ><TR
 202 ><TD
 203 WIDTH="33%"
 204 ALIGN="left"
 205 VALIGN="top"
 206 ><A
 207 HREF="config-tool-updating-configuration.html"
 208 ACCESSKEY="P"
 209 >Prev</A
 210 ></TD
 211 ><TD
 212 WIDTH="34%"
 213 ALIGN="center"
 214 VALIGN="top"
 215 ><A
 216 HREF="ecos-user-guide.html"
 217 ACCESSKEY="H"
 218 >Home</A
 219 ></TD
 220 ><TD
 221 WIDTH="33%"
 222 ALIGN="right"
 223 VALIGN="top"
 224 ><A
 225 HREF="config-tool-using-templates.html"
 226 ACCESSKEY="N"
 227 >Next</A
 228 ></TD
 229 ></TR
 230 ><TR
 231 ><TD
 232 WIDTH="33%"
 233 ALIGN="left"
 234 VALIGN="top"
 235 >Updating the Configuration</TD
 236 ><TD
 237 WIDTH="34%"
 238 ALIGN="center"
 239 VALIGN="top"
 240 ><A
 241 HREF="config-tool-updating-configuration.html"
 242 ACCESSKEY="U"
 243 >Up</A
 244 ></TD
 245 ><TD
 246 WIDTH="33%"
 247 ALIGN="right"
 248 VALIGN="top"
 249 >Using Templates</TD
 250 ></TR
 251 ></TABLE
 252 ></DIV
 253 ></BODY
 254 ></HTML
 255 >