doc/html/user-guide/setup-arm-ebsa285.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 >StrongARM EBSA-285 Hardware Setup</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="Target Setup"
  23 HREF="appendix-target-setup.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Cirrus Logic ARM CL-PS7111 Evaluation Board Hardware Setup"
  26 HREF="setup-arm-clps7111.html"><LINK
  27 REL="NEXT"
  28 TITLE=" Compaq iPAQ PocketPC Hardware Setup"
  29 HREF="setup-arm-ipaq.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="setup-arm-clps7111.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Appendix A. Target Setup</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="setup-arm-ipaq.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="SETUP-ARM-EBSA285">StrongARM EBSA-285 Hardware Setup</H1
  86 ><P
  87 >The eCos Developer&#8217;s Kit package comes with a ROM
  88 image which provides GDB support for
  89 the Intel&reg; StrongARM&reg; Evaluation Board EBSA-285.
  90  Both eCos and the Stub ROM image assume the clocks are: 3.6864
  91 MHz PLL input for generating the core clock, and 50MHz osc input
  92 for external clocks. An image of this ROM is also provided at <TT
  93 CLASS="FILENAME"
  94 >loaders/arm-ebsa285/gdbload.bin</TT
  95 > under
  96 the root of your eCos installation.</P
  97 ><P
  98 >The ROM monitor image (an eCos GDB
  99 stub) provided for the EBSA-285 board must be programmed into the
 100 flash, replacing the Angel monitor on the board. Please refer to
 101 the section titled "Loading the ROM Image into On-Board flash" on how
 102 to program the ROM onto the board.</P
 103 ><P
 104 >The Stub ROM allows communication with GDB via the serial
 105 connector on the bulkhead mounting bracket COM0.  The communication
 106 parameters are fixed at 38400 baud, 8 data bits, no parity bit and
 107 1 stop bit (8-N-1).  No flow control is employed.</P
 108 ><DIV
 109 CLASS="SECT2"
 110 ><H2
 111 CLASS="SECT2"
 112 ><A
 113 NAME="AEN3981">Building the GDB Stub FLASH ROM images</H2
 114 ><P
 115 >Pre-built GDB stubs images are provided in the directory loaders/arm-ebsa285 relative
 116 to the root of your eCos installation, but here are instructions
 117 on how to rebuild them if you should ever need to.</P
 118 ></DIV
 119 ><DIV
 120 CLASS="SECT2"
 121 ><H2
 122 CLASS="SECT2"
 123 ><A
 124 NAME="AEN3984">Building the GDB Stubs with the eCos Configuration Tool</H2
 125 ><P
 126 ></P
 127 ><OL
 128 TYPE="1"
 129 ><LI
 130 ><P
 131 >Start with a new document - selecting the
 132 <SPAN
 133 CLASS="emphasis"
 134 ><I
 135 CLASS="EMPHASIS"
 136 >File</I
 137 ></SPAN
 138 >
 139 -&#62;
 140 <SPAN
 141 CLASS="emphasis"
 142 ><I
 143 CLASS="EMPHASIS"
 144 >New</I
 145 ></SPAN
 146 >
 147  menu item if necessary to do this.</P
 148 ></LI
 149 ><LI
 150 ><P
 151 >Choose the
 152 <SPAN
 153 CLASS="emphasis"
 154 ><I
 155 CLASS="EMPHASIS"
 156 >Build</I
 157 ></SPAN
 158 >
 159 -&#62;
 160 <SPAN
 161 CLASS="emphasis"
 162 ><I
 163 CLASS="EMPHASIS"
 164 >Templates</I
 165 ></SPAN
 166 >
 167  menu item, and then select the StrongARM EBSA285 hardware.</P
 168 ></LI
 169 ><LI
 170 ><P
 171 >While still displaying the
 172 <SPAN
 173 CLASS="emphasis"
 174 ><I
 175 CLASS="EMPHASIS"
 176 >Build</I
 177 ></SPAN
 178 >
 179 -&#62;
 180 <SPAN
 181 CLASS="emphasis"
 182 ><I
 183 CLASS="EMPHASIS"
 184 >Templates</I
 185 ></SPAN
 186 >
 187  dialog box, select the "stubs" package template to build a GDB
 188 stub image. Click
 189 <SPAN
 190 CLASS="emphasis"
 191 ><I
 192 CLASS="EMPHASIS"
 193 >OK</I
 194 ></SPAN
 195 >.</P
 196 ></LI
 197 ><LI
 198 ><P
 199 >Build eCos using
 200 <SPAN
 201 CLASS="emphasis"
 202 ><I
 203 CLASS="EMPHASIS"
 204 >Build</I
 205 ></SPAN
 206 >
 207 -&#62;
 208 <SPAN
 209 CLASS="emphasis"
 210 ><I
 211 CLASS="EMPHASIS"
 212 >Library</I
 213 ></SPAN
 214 ></P
 215 ></LI
 216 ><LI
 217 ><P
 218 >When the build completes, the image files can be found
 219 in the bin/ subdirectory of the install tree. The GDB stub
 220 ROM images have the prefix "gdb_module".</P
 221 ></LI
 222 ></OL
 223 ></DIV
 224 ><DIV
 225 CLASS="SECT2"
 226 ><H2
 227 CLASS="SECT2"
 228 ><A
 229 NAME="AEN4006">Building the GDB Stub ROMs with ecosconfig</H2
 230 ><P
 231 >(See &#8220;Using ecosconfig on UNIX&#8221; on&nbsp;page&nbsp;72)</P
 232 ><P
 233 ></P
 234 ><OL
 235 TYPE="1"
 236 ><LI
 237 ><P
 238 >Make an empty directory to contain the build tree,
 239 and cd into it.</P
 240 ></LI
 241 ><LI
 242 ><P
 243 >To build a GDB stub ROM image, enter the command:
 244
 245 <TABLE
 246 BORDER="5"
 247 BGCOLOR="#E0E0F0"
 248 WIDTH="70%"
 249 ><TR
 250 ><TD
 251 ><PRE
 252 CLASS="PROGRAMLISTING"
 253 >$ ecosconfig new ebsa285 stubs</PRE
 254 ></TD
 255 ></TR
 256 ></TABLE
 257 ></P
 258 ></LI
 259 ><LI
 260 ><P
 261 >Enter the commands:
 262
 263 <TABLE
 264 BORDER="5"
 265 BGCOLOR="#E0E0F0"
 266 WIDTH="70%"
 267 ><TR
 268 ><TD
 269 ><PRE
 270 CLASS="PROGRAMLISTING"
 271 >$ ecosconfig tree
 272 $ make</PRE
 273 ></TD
 274 ></TR
 275 ></TABLE
 276 ></P
 277 ></LI
 278 ><LI
 279 ><P
 280 >When the build completes, the image files can be found
 281 in the bin/ subdirectory of the install tree. The GDB stub
 282 ROM images have the prefix "gdb_module".</P
 283 ></LI
 284 ></OL
 285 ></DIV
 286 ><DIV
 287 CLASS="SECT2"
 288 ><H2
 289 CLASS="SECT2"
 290 ><A
 291 NAME="AEN4020">Loading the ROM Image into On-board Flash</H2
 292 ><P
 293 >There are several ways to install the eCos gdb stub ROM image
 294 in the EBSA board&#8217;s flash memory. Once installed, the gdb
 295 stub ROM provides standard eCos download and debug via the EBSA
 296 board&quot;s serial port. The options available include the
 297 Linux based EBSA flash upgrade utility provided by Red Hat, direct writing
 298 of the flash via MultiICE (JTAG) hardware debugger, and other flash management
 299 utilities from Intel (these only support DOS, and proprietary ARM tools
 300 and image formats). Only the Red Hat flash upgrade tool is supported
 301 and tested in this release.</P
 302 ><P
 303 >The flash upgrade tool requires the EBSA board to be configured
 304 as a PCI slave (rather than a master, its normal operating mode)
 305 and plugged into a Linux host computer&quot;s PCI bus.</P
 306 ><P
 307 >Configuring the board for flash loading: Follow the instructions
 308 in the EBSA-285 Reference Manual, pages A-2 and A-3 to configure
 309 the board as an add-in card, and enable flash blank programming.
 310  Briefly: assuming the board was in the default setting to execute
 311 as a bus master ("Host Bridge") make jumper 9 (J9), move jumper
 312 10 (J10) to external reset (PCI_RST), and move jumper 15
 313 (J15) link 4-6-5 to connect 5-6 instead of 4-6.</P
 314 ><P
 315 >Configuring the board for execution of eCos programs: Follow
 316 the instructions in the EBSA-285 Reference Manual, pages A-2 and
 317 A-3 to configure the board as a "Host Bridge" with "Central Function".
 318  Briefly: unset J9, move J10 to on-board reset (BRD_RST),
 319 and set J15 to make 4-6 instead of 5-6 (see page A-8 also).  Plug
 320 the card into its own PCI bus, not the Linux PC used for the flash-programming
 321 process.</P
 322 ><P
 323 >Building the Linux software: the Linux software sources are
 324 in directory</P
 325 ><TABLE
 326 BORDER="5"
 327 BGCOLOR="#E0E0F0"
 328 WIDTH="70%"
 329 ><TR
 330 ><TD
 331 ><PRE
 332 CLASS="PROGRAMLISTING"
 333 >      &lt;BASE_DIR&#62;/packages/hal/arm/ebsa285/v1_3/support/linux/safl_util</PRE
 334 ></TD
 335 ></TR
 336 ></TABLE
 337 ><P
 338 >in the eCos source repository.  There are two parts to the
 339 system: a loadable kernel module and the flash utility.  The loadable
 340 kernel module is safl.o and the utility is sa_flash.  To
 341 build:</P
 342 ><P
 343 >  cd to this directory, or a copy of it.</P
 344 ><P
 345 >  make</P
 346 ><P
 347 >This builds safl.o and sa_flash. The kernel module
 348 must be installed, and a device file created for it. Both of these
 349 operations require root permissions.  Create the device file by: </P
 350 ><TABLE
 351 BORDER="5"
 352 BGCOLOR="#E0E0F0"
 353 WIDTH="70%"
 354 ><TR
 355 ><TD
 356 ><PRE
 357 CLASS="PROGRAMLISTING"
 358 >      % mknod /dev/safl c 10 178</PRE
 359 ></TD
 360 ></TR
 361 ></TABLE
 362 ><P
 363 >Programming the flash: switch off the EBSA-285, and remove
 364 the EBSA-285 board from its PCI bus.  Take appropriate anti-static
 365 precautions. Configure it for flash loading as above, halt your
 366 Linux system and turn it off.  Install the EBSA-285 board in the
 367 PCI bus of the Linux system and boot it up. (Single user is good enough,
 368 assuming your image and safl_util build dir are on a local
 369 disc partition.)  Change directory to the safl_util directory,
 370 then, to load the kernel module and flash an image onto the eval
 371 board (as root): </P
 372 ><TABLE
 373 BORDER="5"
 374 BGCOLOR="#E0E0F0"
 375 WIDTH="70%"
 376 ><TR
 377 ><TD
 378 ><PRE
 379 CLASS="PROGRAMLISTING"
 380 >       % insmod safl.o
 381        % sa_flash &lt;image_file&#62;</PRE
 382 ></TD
 383 ></TR
 384 ></TABLE
 385 ><P
 386 >Halt and turn off the Linux machine and remove the EBSA-285
 387 card.  Take appropriate anti-static precautions.  Configure it for
 388 execution of eCos programs as above, and plug it into its own PCI
 389 bus.  Restart the Linux machine however you wish.</P
 390 ><P
 391 >This information is replicated in the README file within the
 392 safl_util directory and its parents, and in the EBSA-285
 393 Reference Manual from Intel, appendix A "Configuration Guide".
 394 If in doubt, please refer to those documents also.</P
 395 ><P
 396 >This procedure also applies for loading ROM-startup eCos programs
 397 into the on-board flash memory, given a binary format image of the
 398 program from arm-elf-objcopy.  Loading a ROM-startup eCos program
 399 into flash will overwrite the StubROM in flash, so you would have
 400 to reload the StubROM to return to normal RAM-startup program development.</P
 401 ></DIV
 402 ><DIV
 403 CLASS="SECT2"
 404 ><H2
 405 CLASS="SECT2"
 406 ><A
 407 NAME="AEN4038">Running your eCos Program Using GDB and the StubROM</H2
 408 ><DIV
 409 CLASS="NOTE"
 410 ><BLOCKQUOTE
 411 CLASS="NOTE"
 412 ><P
 413 ><B
 414 >Note: </B
 415 >You must first load the StubROM image into the flash memory
 416 on the EBSA-285 board before doing this.  See &#8220;Loading
 417 the ROM Image into On-board Flash&#8221;, page 93 for details.</P
 418 ></BLOCKQUOTE
 419 ></DIV
 420 ><P
 421 >Connect to the StubROM in the board and run your eCos program &lt;PROGRAM&#62; as</P
 422 ><P
 423 >follows:</P
 424 ><TABLE
 425 BORDER="5"
 426 BGCOLOR="#E0E0F0"
 427 WIDTH="70%"
 428 ><TR
 429 ><TD
 430 ><PRE
 431 CLASS="PROGRAMLISTING"
 432 >      $ arm-elf-gdb -nw &lt;PROGRAM&#62;
 433       (gdb) set remotebaud 38400
 434       (gdb) target remote &lt;DEVICE&#62;</PRE
 435 ></TD
 436 ></TR
 437 ></TABLE
 438 ><P
 439 >Where &lt;DEVICE&#62; is /dev/ttyS0
 440 or COM1: or similar, depending on your environment and how you connected
 441 your serial line to the host computer. Expect some output here,
 442 for example:</P
 443 ><TABLE
 444 BORDER="5"
 445 BGCOLOR="#E0E0F0"
 446 WIDTH="70%"
 447 ><TR
 448 ><TD
 449 ><PRE
 450 CLASS="PROGRAMLISTING"
 451 >      Remote debugging using /dev/ttyS0
 452       0x410026a4 in ?? ()</PRE
 453 ></TD
 454 ></TR
 455 ></TABLE
 456 ><P
 457 >then, to load the program</P
 458 ><TABLE
 459 BORDER="5"
 460 BGCOLOR="#E0E0F0"
 461 WIDTH="70%"
 462 ><TR
 463 ><TD
 464 ><PRE
 465 CLASS="PROGRAMLISTING"
 466 >        (gdb) load
 467     </PRE
 468 ></TD
 469 ></TR
 470 ></TABLE
 471 ><P
 472 >which will report locations and sizes of sections as they
 473 load, then begin execution using</P
 474 ><TABLE
 475 BORDER="5"
 476 BGCOLOR="#E0E0F0"
 477 WIDTH="70%"
 478 ><TR
 479 ><TD
 480 ><PRE
 481 CLASS="PROGRAMLISTING"
 482 >      (gdb) continue</PRE
 483 ></TD
 484 ></TR
 485 ></TABLE
 486 ><P
 487 >If you have no eCos program yet, but you want to connect to
 488 the board just to verify serial communications, tell gdb "set endian
 489 little" before anything else, so that it understands the board (GDB
 490 normally infers this from information within the eCos program).</P
 491 ><DIV
 492 CLASS="NOTE"
 493 ><BLOCKQUOTE
 494 CLASS="NOTE"
 495 ><P
 496 ><B
 497 >Note: </B
 498 >When an eCos program is run on the EBSA-285 board, the GDB
 499 stub in ROM loses control. This means that if you require the ability
 500 to stop execution on the target remotely, or want thread debugging
 501 capabilities, you must include GDB stub support when configuring
 502 <SPAN
 503 CLASS="PRODUCTNAME"
 504 >eCos</SPAN
 505 >.</P
 506 ></BLOCKQUOTE
 507 ></DIV
 508 ></DIV
 509 ></DIV
 510 ><DIV
 511 CLASS="NAVFOOTER"
 512 ><HR
 513 ALIGN="LEFT"
 514 WIDTH="100%"><TABLE
 515 SUMMARY="Footer navigation table"
 516 WIDTH="100%"
 517 BORDER="0"
 518 CELLPADDING="0"
 519 CELLSPACING="0"
 520 ><TR
 521 ><TD
 522 WIDTH="33%"
 523 ALIGN="left"
 524 VALIGN="top"
 525 ><A
 526 HREF="setup-arm-clps7111.html"
 527 ACCESSKEY="P"
 528 >Prev</A
 529 ></TD
 530 ><TD
 531 WIDTH="34%"
 532 ALIGN="center"
 533 VALIGN="top"
 534 ><A
 535 HREF="ecos-user-guide.html"
 536 ACCESSKEY="H"
 537 >Home</A
 538 ></TD
 539 ><TD
 540 WIDTH="33%"
 541 ALIGN="right"
 542 VALIGN="top"
 543 ><A
 544 HREF="setup-arm-ipaq.html"
 545 ACCESSKEY="N"
 546 >Next</A
 547 ></TD
 548 ></TR
 549 ><TR
 550 ><TD
 551 WIDTH="33%"
 552 ALIGN="left"
 553 VALIGN="top"
 554 >Cirrus Logic ARM CL-PS7111 Evaluation Board Hardware Setup</TD
 555 ><TD
 556 WIDTH="34%"
 557 ALIGN="center"
 558 VALIGN="top"
 559 ><A
 560 HREF="appendix-target-setup.html"
 561 ACCESSKEY="U"
 562 >Up</A
 563 ></TD
 564 ><TD
 565 WIDTH="33%"
 566 ALIGN="right"
 567 VALIGN="top"
 568 >Compaq iPAQ PocketPC Hardware Setup</TD
 569 ></TR
 570 ></TABLE
 571 ></DIV
 572 ></BODY
 573 ></HTML
 574 >