doc/html/user-guide/using-configtool-windows-linux.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 >Configuration Tool on Windows and Linux Quick Start</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="Configuring and Building eCos from Source"
  23 HREF="configuring-and-building-ecos-from-source.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Configuring and Building eCos from Source"
  26 HREF="configuring-and-building-ecos-from-source.html"><LINK
  27 REL="NEXT"
  28 TITLE="Ecosconfig on Windows and Linux Quick Start"
  29 HREF="using-ecosconfig-on-linux.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="configuring-and-building-ecos-from-source.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 11. Configuring and Building <SPAN
  66 CLASS="PRODUCTNAME"
  67 >eCos</SPAN
  68 > from Source</TD
  69 ><TD
  70 WIDTH="10%"
  71 ALIGN="right"
  72 VALIGN="bottom"
  73 ><A
  74 HREF="using-ecosconfig-on-linux.html"
  75 ACCESSKEY="N"
  76 >Next</A
  77 ></TD
  78 ></TR
  79 ></TABLE
  80 ><HR
  81 ALIGN="LEFT"
  82 WIDTH="100%"></DIV
  83 ><DIV
  84 CLASS="SECT1"
  85 ><H1
  86 CLASS="SECT1"
  87 ><A
  88 NAME="USING-CONFIGTOOL-WINDOWS-LINUX">Configuration Tool on Windows and Linux Quick Start</H1
  89 ><P
  90 >
  91
  92 Note that the use of the <SPAN
  93 CLASS="APPLICATION"
  94 >Configuration Tool</SPAN
  95 >
  96 is described in detail in <A
  97 HREF="the-ecos-configuration-tool.html"
  98 >Part IV in <I
  99 >eCos User Guide</I
 100 ></A
 101 >.</P
 102 ><P
 103 >The <SPAN
 104 CLASS="APPLICATION"
 105 >Configuration Tool</SPAN
 106 > (see <A
 107 HREF="using-configtool-windows-linux.html#PROGRAMMING-FIGURE-CONFIGURATION-TOOL"
 108 >Figure 11-1</A
 109 >)
 110 has five main elements: the <SPAN
 111 CLASS="emphasis"
 112 ><I
 113 CLASS="EMPHASIS"
 114 >configuration window</I
 115 ></SPAN
 116 >,
 117 the <SPAN
 118 CLASS="emphasis"
 119 ><I
 120 CLASS="EMPHASIS"
 121 >conflicts window</I
 122 ></SPAN
 123 >,
 124 the <SPAN
 125 CLASS="emphasis"
 126 ><I
 127 CLASS="EMPHASIS"
 128 >properties window</I
 129 ></SPAN
 130 >, the <SPAN
 131 CLASS="emphasis"
 132 ><I
 133 CLASS="EMPHASIS"
 134 >short
 135 description window</I
 136 ></SPAN
 137 >,
 138 and the <SPAN
 139 CLASS="emphasis"
 140 ><I
 141 CLASS="EMPHASIS"
 142 >output window</I
 143 ></SPAN
 144 >.</P
 145 ><DIV
 146 CLASS="FIGURE"
 147 ><A
 148 NAME="PROGRAMMING-FIGURE-CONFIGURATION-TOOL"><P
 149 ><B
 150 >Figure 11-1. Configuration Tool</B
 151 ></P
 152 ><P
 153 ><IMG
 154 SRC="pix/config-f1.png"></P
 155 ></DIV
 156 ><P
 157 >Start by opening the templates window via <SPAN
 158 CLASS="GUIMENUITEM"
 159 >Build-&#62;Templates</SPAN
 160 >.
 161 Select the desired target (see <A
 162 HREF="using-configtool-windows-linux.html#FIGURE-TEMPLATE-SELECTION"
 163 >Figure 11-2</A
 164 >).</P
 165 ><DIV
 166 CLASS="FIGURE"
 167 ><A
 168 NAME="FIGURE-TEMPLATE-SELECTION"><P
 169 ><B
 170 >Figure 11-2. Template selection</B
 171 ></P
 172 ><P
 173 ><IMG
 174 SRC="pix/templates01.png"></P
 175 ></DIV
 176 ><P
 177 >Make sure that the configuration is correct for the target
 178 in terms of endianness, CPU model, Startup type, etc. (see <A
 179 HREF="using-configtool-windows-linux.html#CONFIGURING-FOR-THE-TARGET"
 180 >Figure 11-3</A
 181 >).</P
 182 ><DIV
 183 CLASS="FIGURE"
 184 ><A
 185 NAME="CONFIGURING-FOR-THE-TARGET"><P
 186 ><B
 187 >Figure 11-3. Configuring
 188 for the target</B
 189 ></P
 190 ><P
 191 ><IMG
 192 SRC="pix/ARMStartup01.png"></P
 193 ></DIV
 194 ><P
 195 >Next, select the <SPAN
 196 CLASS="emphasis"
 197 ><I
 198 CLASS="EMPHASIS"
 199 >Build-&#62;Library</I
 200 ></SPAN
 201 > menu
 202 item to start building <SPAN
 203 CLASS="PRODUCTNAME"
 204 >eCos</SPAN
 205 > (see <A
 206 HREF="using-configtool-windows-linux.html#FIGURE-SELECTING-THE-BUILD-LIBRARY-MENU-ITEM"
 207 >Figure 11-4</A
 208 >).  The
 209 application will configure the sources, prepare a build tree, and
 210 build the <TT
 211 CLASS="FILENAME"
 212 >libtarget.a</TT
 213 > library, which contains the
 214 <SPAN
 215 CLASS="PRODUCTNAME"
 216 >eCos</SPAN
 217 > kernel and other packages.</P
 218 ><DIV
 219 CLASS="FIGURE"
 220 ><A
 221 NAME="FIGURE-SELECTING-THE-BUILD-LIBRARY-MENU-ITEM"><P
 222 ><B
 223 >Figure 11-4. Selecting the Build Library menu item</B
 224 ></P
 225 ><P
 226 ><IMG
 227 SRC="pix/build-lib01.png"></P
 228 ></DIV
 229 ><P
 230 >The <SPAN
 231 CLASS="emphasis"
 232 ><I
 233 CLASS="EMPHASIS"
 234 >Save As</I
 235 ></SPAN
 236 > dialog box will appear, asking
 237 you to specify a directory in which to place your save file. You
 238 can use the default, but it is a good idea to make a subdirectory,
 239 called <TT
 240 CLASS="FILENAME"
 241 >ecos-work</TT
 242 > for example. </P
 243 ><DIV
 244 CLASS="FIGURE"
 245 ><A
 246 NAME="AEN607"><P
 247 ><B
 248 >Figure 11-5. Save file dialog</B
 249 ></P
 250 ><P
 251 ><IMG
 252 SRC="pix/save-as-dialog.png"></P
 253 ></DIV
 254 ><P
 255 >The first time you build an <SPAN
 256 CLASS="PRODUCTNAME"
 257 >eCos</SPAN
 258 > library for a specific
 259 architecture, the <SPAN
 260 CLASS="APPLICATION"
 261 >Configuration Tool</SPAN
 262 > may prompt
 263 you for the location of the appropriate build tools (including
 264 <B
 265 CLASS="COMMAND"
 266 >make</B
 267 > and
 268 <B
 269 CLASS="COMMAND"
 270 ><TT
 271 CLASS="REPLACEABLE"
 272 ><I
 273 >TARGET-</I
 274 ></TT
 275 >gcc</B
 276 >) using a
 277 <SPAN
 278 CLASS="emphasis"
 279 ><I
 280 CLASS="EMPHASIS"
 281 >Build Tools</I
 282 ></SPAN
 283 > dialog box (as shown in <A
 284 HREF="using-configtool-windows-linux.html#FIGURE-BUILD-TOOLS-DIALOG"
 285 >Figure 11-6</A
 286 >). You can select a location from
 287 the drop down list, browse to the directory using the
 288 <SPAN
 289 CLASS="emphasis"
 290 ><I
 291 CLASS="EMPHASIS"
 292 >Browse</I
 293 ></SPAN
 294 > button, or type in the location of the
 295 build tools manually.</P
 296 ><DIV
 297 CLASS="FIGURE"
 298 ><A
 299 NAME="FIGURE-BUILD-TOOLS-DIALOG"><P
 300 ><B
 301 >Figure 11-6. Build tools dialog</B
 302 ></P
 303 ><P
 304 ><IMG
 305 SRC="pix/build-tools2.png"></P
 306 ></DIV
 307 ><P
 308 >The <SPAN
 309 CLASS="APPLICATION"
 310 >Configuration Tool</SPAN
 311 > may also prompt you
 312 for the location of the user tools (such as <B
 313 CLASS="COMMAND"
 314 >cat</B
 315 > and
 316 <B
 317 CLASS="COMMAND"
 318 >ls</B
 319 >) using a <SPAN
 320 CLASS="emphasis"
 321 ><I
 322 CLASS="EMPHASIS"
 323 >User Tools</I
 324 ></SPAN
 325 > dialog
 326 box (as shown in <A
 327 HREF="using-configtool-windows-linux.html#FIGURE-USER-TOOLS-DIALOG"
 328 >Figure 11-7</A
 329 >). As with
 330 the <SPAN
 331 CLASS="emphasis"
 332 ><I
 333 CLASS="EMPHASIS"
 334 >Build Tools</I
 335 ></SPAN
 336 > dialog, you can select a location
 337 from the drop down list, browse to the directory using the
 338 <SPAN
 339 CLASS="emphasis"
 340 ><I
 341 CLASS="EMPHASIS"
 342 >Browse</I
 343 ></SPAN
 344 > button, or type in the location of the
 345 user tools manually. Note that on Linux, this will often be
 346 unnecessary as the tools will already be on your PATH.</P
 347 ><DIV
 348 CLASS="FIGURE"
 349 ><A
 350 NAME="FIGURE-USER-TOOLS-DIALOG"><P
 351 ><B
 352 >Figure 11-7. User tools dialog</B
 353 ></P
 354 ><P
 355 ><IMG
 356 SRC="pix/user-tools-dialog.png"></P
 357 ></DIV
 358 ><P
 359 >When the tool locations have been entered, the <SPAN
 360 CLASS="APPLICATION"
 361 >Configuration
 362 Tool</SPAN
 363 > will configure the sources, prepare a build tree,
 364 and build the <TT
 365 CLASS="FILENAME"
 366 >libtarget.a</TT
 367 > library, which contains
 368 the <SPAN
 369 CLASS="PRODUCTNAME"
 370 >eCos</SPAN
 371 > kernel and other packages.</P
 372 ><P
 373 >The output from the configuration process and the building
 374 of <TT
 375 CLASS="FILENAME"
 376 >libtarget.a</TT
 377 > will be shown in the output
 378 window.</P
 379 ><P
 380 >Once the build process has finished you will have a kernel
 381 with other packages in <TT
 382 CLASS="FILENAME"
 383 >libtarget.a</TT
 384 >. You should
 385 now build the <SPAN
 386 CLASS="PRODUCTNAME"
 387 >eCos</SPAN
 388 > tests for your particular configuration. </P
 389 ><P
 390 >You can do this by selecting <SPAN
 391 CLASS="emphasis"
 392 ><I
 393 CLASS="EMPHASIS"
 394 >Build</I
 395 ></SPAN
 396 > -&#62; <SPAN
 397 CLASS="emphasis"
 398 ><I
 399 CLASS="EMPHASIS"
 400 >Tests</I
 401 ></SPAN
 402 >.
 403 Notice that you could have selected <SPAN
 404 CLASS="emphasis"
 405 ><I
 406 CLASS="EMPHASIS"
 407 >Tests</I
 408 ></SPAN
 409 > instead
 410 of <SPAN
 411 CLASS="emphasis"
 412 ><I
 413 CLASS="EMPHASIS"
 414 >Library</I
 415 ></SPAN
 416 > in the earlier step and it would
 417 have built <SPAN
 418 CLASS="emphasis"
 419 ><I
 420 CLASS="EMPHASIS"
 421 >both</I
 422 ></SPAN
 423 > the library and the tests,
 424 but this would increase the build time substantially, and if you
 425 do not need to build the tests it is unnecessary.</P
 426 ><DIV
 427 CLASS="FIGURE"
 428 ><A
 429 NAME="AEN648"><P
 430 ><B
 431 >Figure 11-8. Selecting the Build Tests menu item</B
 432 ></P
 433 ><P
 434 ><IMG
 435 SRC="pix/build-tests01.png"></P
 436 ></DIV
 437 ><P
 438 ><A
 439 HREF="running-an-ecos-test-case.html"
 440 >Chapter 12</A
 441 > will guide you through running one
 442             of the test cases you just built on the selected target,
 443             using GDB. </P
 444 ></DIV
 445 ><DIV
 446 CLASS="NAVFOOTER"
 447 ><HR
 448 ALIGN="LEFT"
 449 WIDTH="100%"><TABLE
 450 SUMMARY="Footer navigation table"
 451 WIDTH="100%"
 452 BORDER="0"
 453 CELLPADDING="0"
 454 CELLSPACING="0"
 455 ><TR
 456 ><TD
 457 WIDTH="33%"
 458 ALIGN="left"
 459 VALIGN="top"
 460 ><A
 461 HREF="configuring-and-building-ecos-from-source.html"
 462 ACCESSKEY="P"
 463 >Prev</A
 464 ></TD
 465 ><TD
 466 WIDTH="34%"
 467 ALIGN="center"
 468 VALIGN="top"
 469 ><A
 470 HREF="ecos-user-guide.html"
 471 ACCESSKEY="H"
 472 >Home</A
 473 ></TD
 474 ><TD
 475 WIDTH="33%"
 476 ALIGN="right"
 477 VALIGN="top"
 478 ><A
 479 HREF="using-ecosconfig-on-linux.html"
 480 ACCESSKEY="N"
 481 >Next</A
 482 ></TD
 483 ></TR
 484 ><TR
 485 ><TD
 486 WIDTH="33%"
 487 ALIGN="left"
 488 VALIGN="top"
 489 >Configuring and Building <SPAN
 490 CLASS="PRODUCTNAME"
 491 >eCos</SPAN
 492 > from Source</TD
 493 ><TD
 494 WIDTH="34%"
 495 ALIGN="center"
 496 VALIGN="top"
 497 ><A
 498 HREF="configuring-and-building-ecos-from-source.html"
 499 ACCESSKEY="U"
 500 >Up</A
 501 ></TD
 502 ><TD
 503 WIDTH="33%"
 504 ALIGN="right"
 505 VALIGN="top"
 506 >Ecosconfig on Windows and Linux Quick Start</TD
 507 ></TR
 508 ></TABLE
 509 ></DIV
 510 ></BODY
 511 ></HTML
 512 >