URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [ipaq.html] - Blame information for rev 858

Go to most recent revision | Details | Compare with Previous | View Log


<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
<!-- This material may be distributed only subject to the terms      -->
<!-- and conditions set forth in the Open Publication License, v1.0  -->
<!-- or later (the latest version is presently available at          -->
<!-- http://www.opencontent.org/openpub/).                           -->
<!-- Distribution of the work or derivative of the work in any       -->
<!-- standard (paper) book form is prohibited unless prior           -->
<!-- permission is obtained from the copyright holder.               -->
<HTML
><HEAD
><TITLE
>ARM/StrongARM(SA11X0) Compaq iPAQ PocketPC</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="eCos Reference Manual"
HREF="ecos-ref.html"><LINK
REL="UP"
TITLE="Installation and Testing"
HREF="installation-and-testing.html"><LINK
REL="PREVIOUS"
TITLE="ARM/StrongARM(SA11X0) Bright Star Engineering commEngine and nanoEngine"
HREF="nano.html"><LINK
REL="NEXT"
TITLE="ARM/StrongARM(SA11X0) Intrinsyc CerfCube"
HREF="cerfcube.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>eCos Reference Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="nano.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 5. Installation and Testing</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="cerfcube.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="IPAQ">ARM/StrongARM(SA11X0) Compaq iPAQ PocketPC</H1
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN5927">Overview</H2
><P
>RedBoot supports the serial port via cradle or cable, and Compact Flash
ethernet cards if fitted for communication and downloads. The LCD touchscreen
may also be used for the console, although by default RedBoot will switch
exclusively to one channel once input arrives. </P
><P
>The default serial port settings are 38400,8,N,1. RedBoot runs from
and supports flash management for the system flash region. </P
><P
>The following RedBoot configurations are supported:
 
      <DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5932"><P
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><THEAD
><TR
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Configuration</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Mode</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Description</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>File</TH
></TR
></THEAD
><TBODY
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>ROM</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>[ROM]</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>RedBoot running from the board's flash boot
              sector.</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>redboot_ROM.ecm</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>RAM</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>[RAM]</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>RedBoot running from RAM with RedBoot in the
              flash boot sector.</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>redboot_RAM.ecm</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>WinCE</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>[RAM]</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>RedBoot running from RAM, started from
              <SPAN
CLASS="APPLICATION"
>OSloader</SPAN
>.</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>redboot_WinCE.ecm</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN5957">Initial Installation</H2
><P
>RedBoot ROM and WinCE mode images are needed by the installation process.</P
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN5960">Installing RedBoot on the iPAQ using Windows/CE</H3
><P
>The Windows/CE environment originally shipped with the iPAQ contains a hidden
mini-loader, sometimes referred to as the "Parrot" loader.  This loader can
be started by holding down the action button (the joypad) while resetting
the unit or when powering on.  At this point, a blue bird will appear on
the LCD screen.  Also at this point, a simple loader can be accessed over the
serial port at 115200/8N1.  Using this loader, the contents of the iPAQ flash
memory can be saved to a Compact Flash memory card.
<DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>NOTE: </B
>We have only tested this operation with a 32Mbyte CF memory card.
Given that the backup will take 16MBytes + 1KByte, something more than a 16MByte
card will be required.</P
></BLOCKQUOTE
></DIV
></P
><P
>Use the "r2c" command to dump Flash contents to the CF memory card.  Once this
completes, RedBoot can be installed with no fear since the Parrot loader can
be used to restore the Flash contents at a later time.</P
><P
>If you expect to completely recover the state of the iPAQ Win/CE environment, then
HotSync should be run to backup all "RAM" files as well before installing RedBoot.</P
><P
>The next step in installing RedBoot on the iPAQ actually involves Windows/CE,
which is the native environment on the unit.  Using WinCE, you need to
install an application which will run a RAM based version of RedBoot. Once
this is installed and running, RedBoot can be used to update the flash with
a native/ROM version of RedBoot.       <P
></P
><UL
><LI
><P
>Using ActiveSync, copy the file OSloader to your iPAQ. </P
></LI
><LI
><P
>Using ActiveSync, copy the file redboot_WinCE.bin to the iPAQ
as bootldr in its root directory.  Note: this is not the top level folder
displayed by Windows (Mobile Device), but rather the 'My Pocket PC' folder
within it.</P
></LI
><LI
><P
>Execute OSloader.  If you didn't create a shortcut, then you
will have to poke around for it using the WinCE file explorer.</P
></LI
><LI
><P
>Choose the <SPAN
CLASS="GUIMENUITEM"
>Tools-&#62;BootLdr-&#62;Run after loading
from file</SPAN
> menu item.   </P
></LI
></UL
>At this point, the RAM based version of RedBoot should be running.
 You should be able to return to this point by just executing the last two
steps of the previous process if necessary.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN5979">Installing RedBoot on the iPAQ - using the Compaq boot loader</H3
><P
>This method of installation is no longer supported.
If you have previously installed either the Compaq boot loader or older
versions of RedBoot, restore the Win/CE environment and proceed as outlined
above.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SETTING-UP-AND-TESTING-REDBOOT">Setting up and testing RedBoot</H3
><P
>When RedBoot first comes up, it will want to initialize its LCD touch
screen parameters. It does this by displaying a keyboard graphic and asks
you to press certain keys.  Using the stylus, press and hold until the prompt
is withdrawn. When you lift the stylus, RedBoot will continue with the next
calibration.    </P
><P
>Once the LCD touchscreen has been calibrated, RedBoot will start. The
calibration step can be skipped by pressing the <SPAN
CLASS="GUIBUTTON"
>return/abort</SPAN
>
button on the unit (right most button with a curved arrow icon). Additionally,
the unit will assume default values if the screen is not touched within about
15 seconds.   </P
><P
>Once RedBoot has started, you should get information similar to this
on the LCD screen.  It will also appear on the serial port at 38400,8,N,1.
 
<TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="SCREEN"
>RedBoot(tm) bootstrap and debug environment [ROM]
Non-certified release, version UNKNOWN - built 06:17:41, Mar 19 2001
Platform: Compaq iPAQ Pocket PC (StrongARM 1110)
 
Copyright (C) 2000, 2001, Red Hat, Inc.
 
RAM: 0x00000000-0x01fc0000, 0x0001f200-0x01f70000 available
FLASH: 0x50000000 - 0x51000000, 64 blocks of 0x00040000 bytes
each.</PRE
></TD
></TR
></TABLE
>
 
Since the LCD touchscreen is only 30 characters wide, some of this
data will be off the right hand side of the display. The joypad may be
used to pan left and right in order to see the full lines.  </P
><P
>If you have a Compact Flash ethernet card, RedBoot should find
it.  You'll need to have BOOTP enabled for this unit (see your
sysadmin for details).  If it does, it will print a message like:
 
<TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="SCREEN"
>... Waiting for network card: .Ready!
Socket Communications Inc: CF+ LPE Revision E 08/04/99
IP: 192.168.1.34, Default server: 192.168.1.101</PRE
></TD
></TR
></TABLE
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="IPAQ-INSTALL-RB-PERMANENTLY">Installing RedBoot permanently</H3
><P
>Once you are satisfied with the setup and that RedBoot is operating
properly in your environment, you can set up your iPAQ unit to have RedBoot
be the bootstrap application.
 
<DIV
CLASS="CAUTION"
><P
></P
><TABLE
CLASS="CAUTION"
BORDER="1"
WIDTH="100%"
><TR
><TD
ALIGN="CENTER"
><B
>CAUTION</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
>This step will destroy your Windows/CE environment.</P
><P
>Before you take this step, it is strongly recommended you save your WinCE FLASH contents
as outlined above using the "parrot" loader, or
by using the Compaq OSloader:<P
></P
><UL
><LI
><P
>Using OSloader on the iPAQ, select the <SPAN
CLASS="GUIMENUITEM"
>Tools-&#62;Flash-&#62;Save
to files...</SPAN
>.  menu item.</P
></LI
><LI
><P
>Four (4) files, 4MB each in size will be created.</P
></LI
><LI
><P
>After each file is created, copy the file to your computer,
then delete the file from the iPAQ to make room in the WinCE ramdisk for the
next file.</P
></LI
></UL
></P
></TD
></TR
></TABLE
></DIV
>You will need to download the version of RedBoot designed as the
ROM bootstrap. Then install it permanently  using these commands:
 <TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="SCREEN"
>RedBoot&#62; <TT
CLASS="USERINPUT"
><B
>lo -r -b 0x100000 redboot_ROM.bin</B
></TT
>
RedBoot&#62; <TT
CLASS="USERINPUT"
><B
>fi loc -f 0x50000000 -l 0x40000</B
></TT
>
RedBoot&#62; <TT
CLASS="USERINPUT"
><B
>fis init</B
></TT
>
RedBoot&#62; <TT
CLASS="USERINPUT"
><B
>fi unl -f 0x50040000 -l 0x40000</B
></TT
>
RedBoot&#62; <TT
CLASS="USERINPUT"
><B
>fi cr RedBoot -b 0x100000</B
></TT
>
RedBoot&#62; <TT
CLASS="USERINPUT"
><B
>fi loc -f 0x50040000 -l 0x40000</B
></TT
>
RedBoot&#62; <TT
CLASS="USERINPUT"
><B
>reset</B
></TT
></PRE
></TD
></TR
></TABLE
>
 
<DIV
CLASS="WARNING"
><P
></P
><TABLE
CLASS="WARNING"
BORDER="1"
WIDTH="100%"
><TR
><TD
ALIGN="CENTER"
><B
>WARNING</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
>You must type these commands exactly! Failure to do so may render your
iPAQ totally useless. Once you've done this, RedBoot should come up every
time you reset.</P
></TD
></TR
></TABLE
></DIV
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN6017">Restoring Windows/CE</H3
><P
>To restore Windows/CE from the backup taken in <A
HREF="ipaq.html#IPAQ-INSTALL-RB-PERMANENTLY"
>the Section called <I
>Installing RedBoot permanently</I
></A
>,
visit <A
HREF="http://www.handhelds.org/projects/wincerestoration.html"
TARGET="_top"
>http://www.handhelds.org/projects/wincerestoration.html</A
>
for directions.</P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN6022">Additional commands</H2
><P
>The <B
CLASS="COMMAND"
>exec</B
> command which allows the loading
and execution of Linux kernels,
is supported for this board (see <A
HREF="executing-programs.html"
>the Section called <I
>Executing Programs from RedBoot</I
> in Chapter 2</A
>). The <B
CLASS="COMMAND"
>exec</B
> parameters used for the iPAQ are:</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>-b <TT
CLASS="REPLACEABLE"
><I
>&lt;addr&#62;</I
></TT
></DT
><DD
><P
>Location Linux kernel was loaded to</P
></DD
><DT
>-l <TT
CLASS="REPLACEABLE"
><I
>&lt;len&#62;</I
></TT
></DT
><DD
><P
>Length of kernel</P
></DD
><DT
>-c <TT
CLASS="REPLACEABLE"
><I
>"params"</I
></TT
></DT
><DD
><P
>Parameters passed to kernel</P
></DD
><DT
>-r <TT
CLASS="REPLACEABLE"
><I
>&lt;addr&#62;</I
></TT
></DT
><DD
><P
>'initrd' ramdisk location</P
></DD
><DT
>-s <TT
CLASS="REPLACEABLE"
><I
>&lt;len&#62;</I
></TT
></DT
><DD
><P
>Length of initrd ramdisk</P
></DD
></DL
></DIV
><P
>Linux kernels may be run on the iPAQ using the sources from the anonymous
CVS repository at the Handhelds project (<A
HREF="http://www.handhelds.org/"
TARGET="_top"
>http://www.handhelds.org/</A
>) with
the <TT
CLASS="FILENAME"
>elinux.patch</TT
> patch file applied. This file can be
found in the
<TT
CLASS="FILENAME"
>misc/</TT
> subdirectory of the iPAQ platform HAL in the
RedBoot sources, normally
<TT
CLASS="FILENAME"
>hal/arm/sa11x0/ipaq/<TT
CLASS="REPLACEABLE"
><I
>VERSION</I
></TT
>/misc/</TT
>
  </P
><P
>On the iPAQ (and indeed all SA11x0 platforms), Linux expects to be loaded
at address 0xC0008000 and the entry point is also at 0xC0008000.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN6061">Memory Maps</H2
><P
>RedBoot sets up the following memory map on the iPAQ:   The first level
page table is located at physical address 0xC0004000.  No second level tables
are used.   <DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>NOTE: </B
>The virtual memory maps in this section use a C and B column to indicate
whether or not the region is cached (C) or buffered (B).</P
></BLOCKQUOTE
></DIV
> <TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>Physical Address Range     Description
-----------------------    ----------------------------------
0x00000000 - 0x01ffffff    16Mb to 32Mb FLASH (nCS0) [organized as below]
  0x000000 - 0x0003ffff      Parrot Loader
  0x040000 - 0x0007ffff      RedBoot
  0xf80000 - 0x00fbffff      Fconfig data
  0xfc0000 - 0x00ffffff      FIS directory
0x30000000 - 0x3fffffff    Compact Flash
0x48000000 - 0x4bffffff    iPAQ internal registers
0x80000000 - 0xbfffffff    SA-1110 Internal Registers
0xc0000000 - 0xc1ffffff    DRAM Bank 0 - 32Mb SDRAM
0xe0000000 - 0xe7ffffff    Cache Clean
 
 
Virtual Address Range    C B  Description
-----------------------  - -  ----------------------------------
0x00000000 - 0x01ffffff  Y Y  DRAM - 32Mb
0x30000000 - 0x3fffffff  N N  Compact Flash
0x48000000 - 0x4bffffff  N N  iPAQ internal registers
0x50000000 - 0x51ffffff  Y Y  Up to 32Mb FLASH (nCS0)
0x80000000 - 0xbfffffff  N N  SA-1110 Internal Registers
0xc0000000 - 0xc1ffffff  N Y  DRAM Bank 0: 32Mb
0xe0000000 - 0xe7ffffff  Y Y  Cache Clean   </PRE
></TD
></TR
></TABLE
> </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN6068">Rebuilding RedBoot</H2
><P
>These shell variables provide the platform-specific information
needed for building RedBoot according to the procedure described in
<A
HREF="rebuilding-redboot.html"
>Chapter 3</A
>:
<TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>export TARGET=ipaq
export ARCH_DIR=arm
export PLATFORM_DIR=sa11x0/ipaq</PRE
></TD
></TR
></TABLE
></P
><P
>The names of configuration files are listed above with the
description of the associated modes.</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="nano.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ecos-ref.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="cerfcube.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>ARM/StrongARM(SA11X0) Bright Star Engineering commEngine and nanoEngine</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="installation-and-testing.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>ARM/StrongARM(SA11X0) Intrinsyc CerfCube</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Line No.	Rev	Author	Line
1	28	unneback	`<!-- 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			`>ARM/StrongARM(SA11X0) Compaq iPAQ PocketPC</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 Reference Manual"`
20			`HREF="ecos-ref.html"><LINK`
21			`REL="UP"`
22			`TITLE="Installation and Testing"`
23			`HREF="installation-and-testing.html"><LINK`
24			`REL="PREVIOUS"`
25			`TITLE="ARM/StrongARM(SA11X0) Bright Star Engineering commEngine and nanoEngine"`
26			`HREF="nano.html"><LINK`
27			`REL="NEXT"`
28			`TITLE="ARM/StrongARM(SA11X0) Intrinsyc CerfCube"`
29			`HREF="cerfcube.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 Reference Manual</TH`
50			`></TR`
51			`><TR`
52			`><TD`
53			`WIDTH="10%"`
54			`ALIGN="left"`
55			`VALIGN="bottom"`
56			`><A`
57			`HREF="nano.html"`
58			`ACCESSKEY="P"`
59			`>Prev</A`
60			`></TD`
61			`><TD`
62			`WIDTH="80%"`
63			`ALIGN="center"`
64			`VALIGN="bottom"`
65			`>Chapter 5. Installation and Testing</TD`
66			`><TD`
67			`WIDTH="10%"`
68			`ALIGN="right"`
69			`VALIGN="bottom"`
70			`><A`
71			`HREF="cerfcube.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="IPAQ">ARM/StrongARM(SA11X0) Compaq iPAQ PocketPC</H1`
86			`><DIV`
87			`CLASS="SECT2"`
88			`><H2`
89			`CLASS="SECT2"`
90			`><A`
91			`NAME="AEN5927">Overview</H2`
92			`><P`
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`
97			`><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`
100			`><P`
101			`>The following RedBoot configurations are supported:`
102
103			`<DIV`
104			`CLASS="INFORMALTABLE"`
105			`><A`
106			`NAME="AEN5932"><P`
107			`></P`
108			`><TABLE`
109			`BORDER="1"`
110			`CLASS="CALSTABLE"`
111			`><THEAD`
112			`><TR`
113			`><TH`
114			`ALIGN="LEFT"`
115			`VALIGN="TOP"`
116			`>Configuration</TH`
117			`><TH`
118			`ALIGN="LEFT"`
119			`VALIGN="TOP"`
120			`>Mode</TH`
121			`><TH`
122			`ALIGN="LEFT"`
123			`VALIGN="TOP"`
124			`>Description</TH`
125			`><TH`
126			`ALIGN="LEFT"`
127			`VALIGN="TOP"`
128			`>File</TH`
129			`></TR`
130			`></THEAD`
131			`><TBODY`
132			`><TR`
133			`><TD`
134			`ALIGN="LEFT"`
135			`VALIGN="TOP"`
136			`>ROM</TD`
137			`><TD`
138			`ALIGN="LEFT"`
139			`VALIGN="TOP"`
140			`>[ROM]</TD`
141			`><TD`
142			`ALIGN="LEFT"`
143			`VALIGN="TOP"`
144			`>RedBoot running from the board's flash boot`
145			`sector.</TD`
146			`><TD`
147			`ALIGN="LEFT"`
148			`VALIGN="TOP"`
149			`>redboot_ROM.ecm</TD`
150			`></TR`
151			`><TR`
152			`><TD`
153			`ALIGN="LEFT"`
154			`VALIGN="TOP"`
155			`>RAM</TD`
156			`><TD`
157			`ALIGN="LEFT"`
158			`VALIGN="TOP"`
159			`>[RAM]</TD`
160			`><TD`
161			`ALIGN="LEFT"`
162			`VALIGN="TOP"`
163			`>RedBoot running from RAM with RedBoot in the`
164			`flash boot sector.</TD`
165			`><TD`
166			`ALIGN="LEFT"`
167			`VALIGN="TOP"`
168			`>redboot_RAM.ecm</TD`
169			`></TR`
170			`><TR`
171			`><TD`
172			`ALIGN="LEFT"`
173			`VALIGN="TOP"`
174			`>WinCE</TD`
175			`><TD`
176			`ALIGN="LEFT"`
177			`VALIGN="TOP"`
178			`>[RAM]</TD`
179			`><TD`
180			`ALIGN="LEFT"`
181			`VALIGN="TOP"`
182			`>RedBoot running from RAM, started from`
183			`<SPAN`
184			`CLASS="APPLICATION"`
185			`>OSloader</SPAN`
186			`>.</TD`
187			`><TD`
188			`ALIGN="LEFT"`
189			`VALIGN="TOP"`
190			`>redboot_WinCE.ecm</TD`
191			`></TR`
192			`></TBODY`
193			`></TABLE`
194			`><P`
195			`></P`
196			`></DIV`
197			`></P`
198			`></DIV`
199			`><DIV`
200			`CLASS="SECT2"`
201			`><H2`
202			`CLASS="SECT2"`
203			`><A`
204			`NAME="AEN5957">Initial Installation</H2`
205			`><P`
206			`>RedBoot ROM and WinCE mode images are needed by the installation process.</P`
207			`><DIV`
208			`CLASS="SECT3"`
209			`><H3`
210			`CLASS="SECT3"`
211			`><A`
212			`NAME="AEN5960">Installing RedBoot on the iPAQ using Windows/CE</H3`
213			`><P`
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.`
221			`<DIV`
222			`CLASS="NOTE"`
223			`><BLOCKQUOTE`
224			`CLASS="NOTE"`
225			`><P`
226			`><B`
227			`>NOTE: </B`
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`
231			`></BLOCKQUOTE`
232			`></DIV`
233			`></P`
234			`><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`
238			`><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`
241			`><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`
247			`></P`
248			`><UL`
249			`><LI`
250			`><P`
251			`>Using ActiveSync, copy the file OSloader to your iPAQ. </P`
252			`></LI`
253			`><LI`
254			`><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`
258			`within it.</P`
259			`></LI`
260			`><LI`
261			`><P`
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`
264			`></LI`
265			`><LI`
266			`><P`
267			`>Choose the <SPAN`
268			`CLASS="GUIMENUITEM"`
269			`>Tools->BootLdr->Run after loading`
270			`from file</SPAN`
271			`> menu item. </P`
272			`></LI`
273			`></UL`
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`
277			`></DIV`
278			`><DIV`
279			`CLASS="SECT3"`
280			`><H3`
281			`CLASS="SECT3"`
282			`><A`
283			`NAME="AEN5979">Installing RedBoot on the iPAQ - using the Compaq boot loader</H3`
284			`><P`
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`
288			`above.</P`
289			`></DIV`
290			`><DIV`
291			`CLASS="SECT3"`
292			`><H3`
293			`CLASS="SECT3"`
294			`><A`
295			`NAME="SETTING-UP-AND-TESTING-REDBOOT">Setting up and testing RedBoot</H3`
296			`><P`
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`
301			`calibration. </P`
302			`><P`
303			`>Once the LCD touchscreen has been calibrated, RedBoot will start. The`
304			`calibration step can be skipped by pressing the <SPAN`
305			`CLASS="GUIBUTTON"`
306			`>return/abort</SPAN`
307			`>`
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`
310			`15 seconds. </P`
311			`><P`
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.`
314
315			`<TABLE`
316			`BORDER="5"`
317			`BGCOLOR="#E0E0F0"`
318			`WIDTH="70%"`
319			`><TR`
320			`><TD`
321			`><PRE`
322			`CLASS="SCREEN"`
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)`
326
327			`Copyright (C) 2000, 2001, Red Hat, Inc.`
328
329			`RAM: 0x00000000-0x01fc0000, 0x0001f200-0x01f70000 available`
330			`FLASH: 0x50000000 - 0x51000000, 64 blocks of 0x00040000 bytes`
331			`each.</PRE`
332			`></TD`
333			`></TR`
334			`></TABLE`
335			`>`
336
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`
340			`><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:`
344
345			`<TABLE`
346			`BORDER="5"`
347			`BGCOLOR="#E0E0F0"`
348			`WIDTH="70%"`
349			`><TR`
350			`><TD`
351			`><PRE`
352			`CLASS="SCREEN"`
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`
356			`></TD`
357			`></TR`
358			`></TABLE`
359			`></P`
360			`></DIV`
361			`><DIV`
362			`CLASS="SECT3"`
363			`><H3`
364			`CLASS="SECT3"`
365			`><A`
366			`NAME="IPAQ-INSTALL-RB-PERMANENTLY">Installing RedBoot permanently</H3`
367			`><P`
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.`
371
372			`<DIV`
373			`CLASS="CAUTION"`
374			`><P`
375			`></P`
376			`><TABLE`
377			`CLASS="CAUTION"`
378			`BORDER="1"`
379			`WIDTH="100%"`
380			`><TR`
381			`><TD`
382			`ALIGN="CENTER"`
383			`><B`
384			`>CAUTION</B`
385			`></TD`
386			`></TR`
387			`><TR`
388			`><TD`
389			`ALIGN="LEFT"`
390			`><P`
391			`>This step will destroy your Windows/CE environment.</P`
392			`><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`
396			`></P`
397			`><UL`
398			`><LI`
399			`><P`
400			`>Using OSloader on the iPAQ, select the <SPAN`
401			`CLASS="GUIMENUITEM"`
402			`>Tools->Flash->Save`
403			`to files...</SPAN`
404			`>. menu item.</P`
405			`></LI`
406			`><LI`
407			`><P`
408			`>Four (4) files, 4MB each in size will be created.</P`
409			`></LI`
410			`><LI`
411			`><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`
414			`next file.</P`
415			`></LI`
416			`></UL`
417			`></P`
418			`></TD`
419			`></TR`
420			`></TABLE`
421			`></DIV`
422			`>You will need to download the version of RedBoot designed as the`
423			`ROM bootstrap. Then install it permanently using these commands:`
424			`<TABLE`
425			`BORDER="5"`
426			`BGCOLOR="#E0E0F0"`
427			`WIDTH="70%"`
428			`><TR`
429			`><TD`
430			`><PRE`
431			`CLASS="SCREEN"`
432			`>RedBoot> <TT`
433			`CLASS="USERINPUT"`
434			`><B`
435			`>lo -r -b 0x100000 redboot_ROM.bin</B`
436			`></TT`
437			`>`
438			`RedBoot> <TT`
439			`CLASS="USERINPUT"`
440			`><B`
441			`>fi loc -f 0x50000000 -l 0x40000</B`
442			`></TT`
443			`>`
444			`RedBoot> <TT`
445			`CLASS="USERINPUT"`
446			`><B`
447			`>fis init</B`
448			`></TT`
449			`>`
450			`RedBoot> <TT`
451			`CLASS="USERINPUT"`
452			`><B`
453			`>fi unl -f 0x50040000 -l 0x40000</B`
454			`></TT`
455			`>`
456			`RedBoot> <TT`
457			`CLASS="USERINPUT"`
458			`><B`
459			`>fi cr RedBoot -b 0x100000</B`
460			`></TT`
461			`>`
462			`RedBoot> <TT`
463			`CLASS="USERINPUT"`
464			`><B`
465			`>fi loc -f 0x50040000 -l 0x40000</B`
466			`></TT`
467			`>`
468			`RedBoot> <TT`
469			`CLASS="USERINPUT"`
470			`><B`
471			`>reset</B`
472			`></TT`
473			`></PRE`
474			`></TD`
475			`></TR`
476			`></TABLE`
477			`>`
478
479			`<DIV`
480			`CLASS="WARNING"`
481			`><P`
482			`></P`
483			`><TABLE`
484			`CLASS="WARNING"`
485			`BORDER="1"`
486			`WIDTH="100%"`
487			`><TR`
488			`><TD`
489			`ALIGN="CENTER"`
490			`><B`
491			`>WARNING</B`
492			`></TD`
493			`></TR`
494			`><TR`
495			`><TD`
496			`ALIGN="LEFT"`
497			`><P`
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`
500			`time you reset.</P`
501			`></TD`
502			`></TR`
503			`></TABLE`
504			`></DIV`
505			`></P`
506			`></DIV`
507			`><DIV`
508			`CLASS="SECT3"`
509			`><H3`
510			`CLASS="SECT3"`
511			`><A`
512			`NAME="AEN6017">Restoring Windows/CE</H3`
513			`><P`
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`
518			`></A`
519			`>,`
520			`visit <A`
521			`HREF="http://www.handhelds.org/projects/wincerestoration.html"`
522			`TARGET="_top"`
523			`>http://www.handhelds.org/projects/wincerestoration.html</A`
524			`>`
525			`for directions.</P`
526			`></DIV`
527			`></DIV`
528			`><DIV`
529			`CLASS="SECT2"`
530			`><H2`
531			`CLASS="SECT2"`
532			`><A`
533			`NAME="AEN6022">Additional commands</H2`
534			`><P`
535			`>The <B`
536			`CLASS="COMMAND"`
537			`>exec</B`
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`
544			`> in Chapter 2</A`
545			`>). The <B`
546			`CLASS="COMMAND"`
547			`>exec</B`
548			`> parameters used for the iPAQ are:</P`
549			`><P`
550			`></P`
551			`><DIV`
552			`CLASS="VARIABLELIST"`
553			`><DL`
554			`><DT`
555			`>-b <TT`
556			`CLASS="REPLACEABLE"`
557			`><I`
558			`><addr></I`
559			`></TT`
560			`></DT`
561			`><DD`
562			`><P`
563			`>Location Linux kernel was loaded to</P`
564			`></DD`
565			`><DT`
566			`>-l <TT`
567			`CLASS="REPLACEABLE"`
568			`><I`
569			`><len></I`
570			`></TT`
571			`></DT`
572			`><DD`
573			`><P`
574			`>Length of kernel</P`
575			`></DD`
576			`><DT`
577			`>-c <TT`
578			`CLASS="REPLACEABLE"`
579			`><I`
580			`>"params"</I`
581			`></TT`
582			`></DT`
583			`><DD`
584			`><P`
585			`>Parameters passed to kernel</P`
586			`></DD`
587			`><DT`
588			`>-r <TT`
589			`CLASS="REPLACEABLE"`
590			`><I`
591			`><addr></I`
592			`></TT`
593			`></DT`
594			`><DD`
595			`><P`
596			`>'initrd' ramdisk location</P`
597			`></DD`
598			`><DT`
599			`>-s <TT`
600			`CLASS="REPLACEABLE"`
601			`><I`
602			`><len></I`
603			`></TT`
604			`></DT`
605			`><DD`
606			`><P`
607			`>Length of initrd ramdisk</P`
608			`></DD`
609			`></DL`
610			`></DIV`
611			`><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/"`
615			`TARGET="_top"`
616			`>http://www.handhelds.org/</A`
617			`>) with`
618			`the <TT`
619			`CLASS="FILENAME"`
620			`>elinux.patch</TT`
621			`> patch file applied. This file can be`
622			`found in the`
623			`<TT`
624			`CLASS="FILENAME"`
625			`>misc/</TT`
626			`> subdirectory of the iPAQ platform HAL in the`
627			`RedBoot sources, normally`
628			`<TT`
629			`CLASS="FILENAME"`
630			`>hal/arm/sa11x0/ipaq/<TT`
631			`CLASS="REPLACEABLE"`
632			`><I`
633			`>VERSION</I`
634			`></TT`
635			`>/misc/</TT`
636			`>`
637			`</P`
638			`><P`
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`
641			`></DIV`
642			`><DIV`
643			`CLASS="SECT2"`
644			`><H2`
645			`CLASS="SECT2"`
646			`><A`
647			`NAME="AEN6061">Memory Maps</H2`
648			`><P`
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`
651			`are used. <DIV`
652			`CLASS="NOTE"`
653			`><BLOCKQUOTE`
654			`CLASS="NOTE"`
655			`><P`
656			`><B`
657			`>NOTE: </B`
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`
660			`></BLOCKQUOTE`
661			`></DIV`
662			`> <TABLE`
663			`BORDER="5"`
664			`BGCOLOR="#E0E0F0"`
665			`WIDTH="70%"`
666			`><TR`
667			`><TD`
668			`><PRE`
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`
682
683
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`
693			`></TD`
694			`></TR`
695			`></TABLE`
696			`> </P`
697			`></DIV`
698			`><DIV`
699			`CLASS="SECT2"`
700			`><H2`
701			`CLASS="SECT2"`
702			`><A`
703			`NAME="AEN6068">Rebuilding RedBoot</H2`
704			`><P`
705			`>These shell variables provide the platform-specific information`
706			`needed for building RedBoot according to the procedure described in`
707			`<A`
708			`HREF="rebuilding-redboot.html"`
709			`>Chapter 3</A`
710			`>:`
711			`<TABLE`
712			`BORDER="5"`
713			`BGCOLOR="#E0E0F0"`
714			`WIDTH="70%"`
715			`><TR`
716			`><TD`
717			`><PRE`
718			`CLASS="PROGRAMLISTING"`
719			`>export TARGET=ipaq`
720			`export ARCH_DIR=arm`
721			`export PLATFORM_DIR=sa11x0/ipaq</PRE`
722			`></TD`
723			`></TR`
724			`></TABLE`
725			`></P`
726			`><P`
727			`>The names of configuration files are listed above with the`
728			`description of the associated modes.</P`
729			`></DIV`
730			`></DIV`
731			`><DIV`
732			`CLASS="NAVFOOTER"`
733			`><HR`
734			`ALIGN="LEFT"`
735			`WIDTH="100%"><TABLE`
736			`SUMMARY="Footer navigation table"`
737			`WIDTH="100%"`
738			`BORDER="0"`
739			`CELLPADDING="0"`
740			`CELLSPACING="0"`
741			`><TR`
742			`><TD`
743			`WIDTH="33%"`
744			`ALIGN="left"`
745			`VALIGN="top"`
746			`><A`
747			`HREF="nano.html"`
748			`ACCESSKEY="P"`
749			`>Prev</A`
750			`></TD`
751			`><TD`
752			`WIDTH="34%"`
753			`ALIGN="center"`
754			`VALIGN="top"`
755			`><A`
756			`HREF="ecos-ref.html"`
757			`ACCESSKEY="H"`
758			`>Home</A`
759			`></TD`
760			`><TD`
761			`WIDTH="33%"`
762			`ALIGN="right"`
763			`VALIGN="top"`
764			`><A`
765			`HREF="cerfcube.html"`
766			`ACCESSKEY="N"`
767			`>Next</A`
768			`></TD`
769			`></TR`
770			`><TR`
771			`><TD`
772			`WIDTH="33%"`
773			`ALIGN="left"`
774			`VALIGN="top"`
775			`>ARM/StrongARM(SA11X0) Bright Star Engineering commEngine and nanoEngine</TD`
776			`><TD`
777			`WIDTH="34%"`
778			`ALIGN="center"`
779			`VALIGN="top"`
780			`><A`
781			`HREF="installation-and-testing.html"`
782			`ACCESSKEY="U"`
783			`>Up</A`
784			`></TD`
785			`><TD`
786			`WIDTH="33%"`
787			`ALIGN="right"`
788			`VALIGN="top"`
789			`>ARM/StrongARM(SA11X0) Intrinsyc CerfCube</TD`
790			`></TR`
791			`></TABLE`
792			`></DIV`
793			`></BODY`
794			`></HTML`
795			`>`

Browse

Tools

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [ipaq.html] - Blame information for rev 858