doc/html/user-guide/coarse-grained-configuration.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 >Coarse-grained Configuration</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="Manual Configuration"
  23 HREF="manual-configuration.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Packages"
  26 HREF="ecos-packages.html"><LINK
  27 REL="NEXT"
  28 TITLE="Fine-grained Configuration"
  29 HREF="fine-grained-configuration.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="ecos-packages.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 28. Manual Configuration</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="fine-grained-configuration.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="COARSE-GRAINED-CONFIGURATION">Coarse-grained Configuration</H1
  86 ><P
  87 >Coarse-grained configuration of
  88           an <SPAN
  89 CLASS="PRODUCTNAME"
  90 >eCos</SPAN
  91 > system means making configuration changes using the
  92           <B
  93 CLASS="COMMAND"
  94 >ecosconfig</B
  95 > tool. These changes
  96           include: </P
  97 ><P
  98 ></P
  99 ><OL
 100 TYPE="1"
 101 ><LI
 102 ><P
 103 >switching to different target hardware</P
 104 ></LI
 105 ><LI
 106 ><P
 107 >switching to a different template</P
 108 ></LI
 109 ><LI
 110 ><P
 111 >adding or removing a package</P
 112 ></LI
 113 ><LI
 114 ><P
 115 >changing the version of a package</P
 116 ></LI
 117 ></OL
 118 ><P
 119 >Whenever <B
 120 CLASS="COMMAND"
 121 >ecosconfig</B
 122 > generates or
 123           updates an <SPAN
 124 CLASS="PRODUCTNAME"
 125 >eCos</SPAN
 126 > configuration, it generates a configuration
 127           save file.</P
 128 ><P
 129 >Suppose that the configuration was first created using
 130           the following command line: </P
 131 ><TABLE
 132 BORDER="5"
 133 BGCOLOR="#E0E0F0"
 134 WIDTH="70%"
 135 ><TR
 136 ><TD
 137 ><PRE
 138 CLASS="SCREEN"
 139 >$ ecosconfig new stdeval1</PRE
 140 ></TD
 141 ></TR
 142 ></TABLE
 143 ><P
 144 >To change the target hardware to the Cogent CMA28x
 145           PowerPC board, the following command would be needed:
 146         </P
 147 ><TABLE
 148 BORDER="5"
 149 BGCOLOR="#E0E0F0"
 150 WIDTH="70%"
 151 ><TR
 152 ><TD
 153 ><PRE
 154 CLASS="SCREEN"
 155 >$ ecosconfig target cma28x</PRE
 156 ></TD
 157 ></TR
 158 ></TABLE
 159 ><P
 160 >To switch to the PowerPC simulator instead: </P
 161 ><TABLE
 162 BORDER="5"
 163 BGCOLOR="#E0E0F0"
 164 WIDTH="70%"
 165 ><TR
 166 ><TD
 167 ><PRE
 168 CLASS="SCREEN"
 169 >$ ecosconfig target psim</PRE
 170 ></TD
 171 ></TR
 172 ></TABLE
 173 ><P
 174 >As the hardware changes, hardware-related packages such as
 175 the HAL packages and device drivers will be added to and removed
 176 from the configuration as appropriate. </P
 177 ><P
 178 >To remove any package from the current configuration, use
 179 the <B
 180 CLASS="COMMAND"
 181 >remove</B
 182 > command: </P
 183 ><TABLE
 184 BORDER="5"
 185 BGCOLOR="#E0E0F0"
 186 WIDTH="70%"
 187 ><TR
 188 ><TD
 189 ><PRE
 190 CLASS="SCREEN"
 191 >$ ecosconfig remove uitron</PRE
 192 ></TD
 193 ></TR
 194 ></TABLE
 195 ><P
 196 >You can disable multiple packages using multiple arguments,
 197 for example: </P
 198 ><TABLE
 199 BORDER="5"
 200 BGCOLOR="#E0E0F0"
 201 WIDTH="70%"
 202 ><TR
 203 ><TD
 204 ><PRE
 205 CLASS="SCREEN"
 206 >$ ecosconfig remove uitron libm</PRE
 207 ></TD
 208 ></TR
 209 ></TABLE
 210 ><P
 211 >If this turns out to have been a mistake then you can
 212           re-enable one or more packages with the
 213           <B
 214 CLASS="COMMAND"
 215 >add</B
 216 > command: </P
 217 ><TABLE
 218 BORDER="5"
 219 BGCOLOR="#E0E0F0"
 220 WIDTH="70%"
 221 ><TR
 222 ><TD
 223 ><PRE
 224 CLASS="SCREEN"
 225 >$ ecosconfig add libm</PRE
 226 ></TD
 227 ></TR
 228 ></TABLE
 229 ><P
 230 >Changing the desired version for a package is also
 231           straightforward:</P
 232 ><TABLE
 233 BORDER="5"
 234 BGCOLOR="#E0E0F0"
 235 WIDTH="70%"
 236 ><TR
 237 ><TD
 238 ><PRE
 239 CLASS="SCREEN"
 240 >$ ecosconfig version v2_1 kernel</PRE
 241 ></TD
 242 ></TR
 243 ></TABLE
 244 ><P
 245 >It is necessary to regenerate the build tree and header
 246           files following any changes to the configuration before
 247           rebuilding <SPAN
 248 CLASS="PRODUCTNAME"
 249 >eCos</SPAN
 250 >:</P
 251 ><TABLE
 252 BORDER="5"
 253 BGCOLOR="#E0E0F0"
 254 WIDTH="70%"
 255 ><TR
 256 ><TD
 257 ><PRE
 258 CLASS="SCREEN"
 259 >$ ecosconfig tree</PRE
 260 ></TD
 261 ></TR
 262 ></TABLE
 263 ></DIV
 264 ><DIV
 265 CLASS="NAVFOOTER"
 266 ><HR
 267 ALIGN="LEFT"
 268 WIDTH="100%"><TABLE
 269 SUMMARY="Footer navigation table"
 270 WIDTH="100%"
 271 BORDER="0"
 272 CELLPADDING="0"
 273 CELLSPACING="0"
 274 ><TR
 275 ><TD
 276 WIDTH="33%"
 277 ALIGN="left"
 278 VALIGN="top"
 279 ><A
 280 HREF="ecos-packages.html"
 281 ACCESSKEY="P"
 282 >Prev</A
 283 ></TD
 284 ><TD
 285 WIDTH="34%"
 286 ALIGN="center"
 287 VALIGN="top"
 288 ><A
 289 HREF="ecos-user-guide.html"
 290 ACCESSKEY="H"
 291 >Home</A
 292 ></TD
 293 ><TD
 294 WIDTH="33%"
 295 ALIGN="right"
 296 VALIGN="top"
 297 ><A
 298 HREF="fine-grained-configuration.html"
 299 ACCESSKEY="N"
 300 >Next</A
 301 ></TD
 302 ></TR
 303 ><TR
 304 ><TD
 305 WIDTH="33%"
 306 ALIGN="left"
 307 VALIGN="top"
 308 >Packages</TD
 309 ><TD
 310 WIDTH="34%"
 311 ALIGN="center"
 312 VALIGN="top"
 313 ><A
 314 HREF="manual-configuration.html"
 315 ACCESSKEY="U"
 316 >Up</A
 317 ></TD
 318 ><TD
 319 WIDTH="33%"
 320 ALIGN="right"
 321 VALIGN="top"
 322 >Fine-grained Configuration</TD
 323 ></TR
 324 ></TABLE
 325 ></DIV
 326 ></BODY
 327 ></HTML
 328 >