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. -->
12 >ARM/StrongARM(SA11X0) Compaq iPAQ PocketPC</TITLE
13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
19 TITLE="eCos Reference Manual"
20 HREF="ecos-ref.html"><LINK
22 TITLE="Installation and Testing"
23 HREF="installation-and-testing.html"><LINK
25 TITLE="ARM/StrongARM(SA11X0) Bright Star Engineering commEngine and nanoEngine"
26 HREF="nano.html"><LINK
28 TITLE="ARM/StrongARM(SA11X0) Intrinsyc CerfCube"
29 HREF="cerfcube.html"></HEAD
40 SUMMARY="Header navigation table"
49 >eCos Reference Manual</TH
65 >Chapter 5. Installation and Testing</TD
85 NAME="IPAQ">ARM/StrongARM(SA11X0) Compaq iPAQ PocketPC</H1
91 NAME="AEN5927">Overview</H2
93 >RedBoot supports the serial port via cradle or cable, and Compact Flash
94 ethernet cards if fitted for communication and downloads. The LCD touchscreen
95 may also be used for the console, although by default RedBoot will switch
96 exclusively to one channel once input arrives. </P
98 >The default serial port settings are 38400,8,N,1. RedBoot runs from
99 and supports flash management for the system flash region. </P
101 >The following RedBoot configurations are supported:
104 CLASS="INFORMALTABLE"
144 >RedBoot running from the board's flash boot
163 >RedBoot running from RAM with RedBoot in the
164 flash boot sector.</TD
182 >RedBoot running from RAM, started from
190 >redboot_WinCE.ecm</TD
204 NAME="AEN5957">Initial Installation</H2
206 >RedBoot ROM and WinCE mode images are needed by the installation process.</P
212 NAME="AEN5960">Installing RedBoot on the iPAQ using Windows/CE</H3
214 >The Windows/CE environment originally shipped with the iPAQ contains a hidden
215 mini-loader, sometimes referred to as the "Parrot" loader. This loader can
216 be started by holding down the action button (the joypad) while resetting
217 the unit or when powering on. At this point, a blue bird will appear on
218 the LCD screen. Also at this point, a simple loader can be accessed over the
219 serial port at 115200/8N1. Using this loader, the contents of the iPAQ flash
220 memory can be saved to a Compact Flash memory card.
228 >We have only tested this operation with a 32Mbyte CF memory card.
229 Given that the backup will take 16MBytes + 1KByte, something more than a 16MByte
230 card will be required.</P
235 >Use the "r2c" command to dump Flash contents to the CF memory card. Once this
236 completes, RedBoot can be installed with no fear since the Parrot loader can
237 be used to restore the Flash contents at a later time.</P
239 >If you expect to completely recover the state of the iPAQ Win/CE environment, then
240 HotSync should be run to backup all "RAM" files as well before installing RedBoot.</P
242 >The next step in installing RedBoot on the iPAQ actually involves Windows/CE,
243 which is the native environment on the unit. Using WinCE, you need to
244 install an application which will run a RAM based version of RedBoot. Once
245 this is installed and running, RedBoot can be used to update the flash with
246 a native/ROM version of RedBoot. <P
251 >Using ActiveSync, copy the file OSloader to your iPAQ. </P
255 >Using ActiveSync, copy the file redboot_WinCE.bin to the iPAQ
256 as bootldr in its root directory. Note: this is not the top level folder
257 displayed by Windows (Mobile Device), but rather the 'My Pocket PC' folder
262 >Execute OSloader. If you didn't create a shortcut, then you
263 will have to poke around for it using the WinCE file explorer.</P
269 >Tools->BootLdr->Run after loading
274 >At this point, the RAM based version of RedBoot should be running.
275 You should be able to return to this point by just executing the last two
276 steps of the previous process if necessary.</P
283 NAME="AEN5979">Installing RedBoot on the iPAQ - using the Compaq boot loader</H3
285 >This method of installation is no longer supported.
286 If you have previously installed either the Compaq boot loader or older
287 versions of RedBoot, restore the Win/CE environment and proceed as outlined
295 NAME="SETTING-UP-AND-TESTING-REDBOOT">Setting up and testing RedBoot</H3
297 >When RedBoot first comes up, it will want to initialize its LCD touch
298 screen parameters. It does this by displaying a keyboard graphic and asks
299 you to press certain keys. Using the stylus, press and hold until the prompt
300 is withdrawn. When you lift the stylus, RedBoot will continue with the next
303 >Once the LCD touchscreen has been calibrated, RedBoot will start. The
304 calibration step can be skipped by pressing the <SPAN
308 button on the unit (right most button with a curved arrow icon). Additionally,
309 the unit will assume default values if the screen is not touched within about
312 >Once RedBoot has started, you should get information similar to this
313 on the LCD screen. It will also appear on the serial port at 38400,8,N,1.
323 >RedBoot(tm) bootstrap and debug environment [ROM]
324 Non-certified release, version UNKNOWN - built 06:17:41, Mar 19 2001
325 Platform: Compaq iPAQ Pocket PC (StrongARM 1110)
327 Copyright (C) 2000, 2001, Red Hat, Inc.
329 RAM: 0x00000000-0x01fc0000, 0x0001f200-0x01f70000 available
330 FLASH: 0x50000000 - 0x51000000, 64 blocks of 0x00040000 bytes
337 Since the LCD touchscreen is only 30 characters wide, some of this
338 data will be off the right hand side of the display. The joypad may be
339 used to pan left and right in order to see the full lines. </P
341 >If you have a Compact Flash ethernet card, RedBoot should find
342 it. You'll need to have BOOTP enabled for this unit (see your
343 sysadmin for details). If it does, it will print a message like:
353 >... Waiting for network card: .Ready!
354 Socket Communications Inc: CF+ LPE Revision E 08/04/99
355 IP: 192.168.1.34, Default server: 192.168.1.101</PRE
366 NAME="IPAQ-INSTALL-RB-PERMANENTLY">Installing RedBoot permanently</H3
368 >Once you are satisfied with the setup and that RedBoot is operating
369 properly in your environment, you can set up your iPAQ unit to have RedBoot
370 be the bootstrap application.
391 >This step will destroy your Windows/CE environment.</P
393 >Before you take this step, it is strongly recommended you save your WinCE FLASH contents
394 as outlined above using the "parrot" loader, or
395 by using the Compaq OSloader:<P
400 >Using OSloader on the iPAQ, select the <SPAN
402 >Tools->Flash->Save
408 >Four (4) files, 4MB each in size will be created.</P
412 >After each file is created, copy the file to your computer,
413 then delete the file from the iPAQ to make room in the WinCE ramdisk for the
422 >You will need to download the version of RedBoot designed as the
423 ROM bootstrap. Then install it permanently using these commands:
435 >lo -r -b 0x100000 redboot_ROM.bin</B
441 >fi loc -f 0x50000000 -l 0x40000</B
453 >fi unl -f 0x50040000 -l 0x40000</B
459 >fi cr RedBoot -b 0x100000</B
465 >fi loc -f 0x50040000 -l 0x40000</B
498 >You must type these commands exactly! Failure to do so may render your
499 iPAQ totally useless. Once you've done this, RedBoot should come up every
512 NAME="AEN6017">Restoring Windows/CE</H3
514 >To restore Windows/CE from the backup taken in <A
515 HREF="ipaq.html#IPAQ-INSTALL-RB-PERMANENTLY"
516 >the Section called <I
517 >Installing RedBoot permanently</I
521 HREF="http://www.handhelds.org/projects/wincerestoration.html"
523 >http://www.handhelds.org/projects/wincerestoration.html</A
533 NAME="AEN6022">Additional commands</H2
538 > command which allows the loading
539 and execution of Linux kernels,
540 is supported for this board (see <A
541 HREF="executing-programs.html"
542 >the Section called <I
543 >Executing Programs from RedBoot</I
548 > parameters used for the iPAQ are:</P
563 >Location Linux kernel was loaded to</P
585 >Parameters passed to kernel</P
596 >'initrd' ramdisk location</P
607 >Length of initrd ramdisk</P
612 >Linux kernels may be run on the iPAQ using the sources from the anonymous
613 CVS repository at the Handhelds project (<A
614 HREF="http://www.handhelds.org/"
616 >http://www.handhelds.org/</A
621 > patch file applied. This file can be
626 > subdirectory of the iPAQ platform HAL in the
627 RedBoot sources, normally
630 >hal/arm/sa11x0/ipaq/<TT
639 >On the iPAQ (and indeed all SA11x0 platforms), Linux expects to be loaded
640 at address 0xC0008000 and the entry point is also at 0xC0008000.</P
647 NAME="AEN6061">Memory Maps</H2
649 >RedBoot sets up the following memory map on the iPAQ: The first level
650 page table is located at physical address 0xC0004000. No second level tables
658 >The virtual memory maps in this section use a C and B column to indicate
659 whether or not the region is cached (C) or buffered (B).</P
669 CLASS="PROGRAMLISTING"
670 >Physical Address Range Description
671 ----------------------- ----------------------------------
672 0x00000000 - 0x01ffffff 16Mb to 32Mb FLASH (nCS0) [organized as below]
673 0x000000 - 0x0003ffff Parrot Loader
674 0x040000 - 0x0007ffff RedBoot
675 0xf80000 - 0x00fbffff Fconfig data
676 0xfc0000 - 0x00ffffff FIS directory
677 0x30000000 - 0x3fffffff Compact Flash
678 0x48000000 - 0x4bffffff iPAQ internal registers
679 0x80000000 - 0xbfffffff SA-1110 Internal Registers
680 0xc0000000 - 0xc1ffffff DRAM Bank 0 - 32Mb SDRAM
681 0xe0000000 - 0xe7ffffff Cache Clean
684 Virtual Address Range C B Description
685 ----------------------- - - ----------------------------------
686 0x00000000 - 0x01ffffff Y Y DRAM - 32Mb
687 0x30000000 - 0x3fffffff N N Compact Flash
688 0x48000000 - 0x4bffffff N N iPAQ internal registers
689 0x50000000 - 0x51ffffff Y Y Up to 32Mb FLASH (nCS0)
690 0x80000000 - 0xbfffffff N N SA-1110 Internal Registers
691 0xc0000000 - 0xc1ffffff N Y DRAM Bank 0: 32Mb
692 0xe0000000 - 0xe7ffffff Y Y Cache Clean </PRE
703 NAME="AEN6068">Rebuilding RedBoot</H2
705 >These shell variables provide the platform-specific information
706 needed for building RedBoot according to the procedure described in
708 HREF="rebuilding-redboot.html"
718 CLASS="PROGRAMLISTING"
721 export PLATFORM_DIR=sa11x0/ipaq</PRE
727 >The names of configuration files are listed above with the
728 description of the associated modes.</P
736 SUMMARY="Footer navigation table"
775 >ARM/StrongARM(SA11X0) Bright Star Engineering commEngine and nanoEngine</TD
781 HREF="installation-and-testing.html"
789 >ARM/StrongARM(SA11X0) Intrinsyc CerfCube</TD