doc/html/ref/startup-mode.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 >RedBoot Startup Mode</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="Getting Started with RedBoot"
  23 HREF="getting-started-with-redboot.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="RedBoot Editing Commands"
  26 HREF="redboot-editing-commands.html"><LINK
  27 REL="NEXT"
  28 TITLE="RedBoot Resource Usage"
  29 HREF="resource-usage.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="redboot-editing-commands.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 1. Getting Started with RedBoot</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="resource-usage.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="STARTUP-MODE">RedBoot Startup Mode</H1
  86 ><P
  87 >
  88   </P
  89 ><P
  90 >RedBoot can normally be configured to run in a number of startup
  91 modes (or just "modes" for short), determining its location of
  92 residence and execution:
  93 <P
  94 ></P
  95 ><DIV
  96 CLASS="VARIABLELIST"
  97 ><DL
  98 ><DT
  99 >ROM mode</DT
 100 ><DD
 101 ><P
 102 >In this mode, RedBoot both resides and executes from
 103  ROM memory (flash or EPROM). This mode is used when there are limited
 104  RAM resources. The flash commands cannot update the region of flash
 105  where the RedBoot image resides. In order to update the RedBoot image
 106  in flash, it is necessary to run a RAM mode instance of
 107  RedBoot.</P
 108 ></DD
 109 ><DT
 110 >ROMRAM mode</DT
 111 ><DD
 112 ><P
 113 >In this mode, RedBoot resides in ROM memory (flash or
 114  EPROM), but is copied to RAM memory before it starts executing. The
 115  RAM footprint is larger than for ROM mode, but there are two
 116  advantages to make up for this: it normally runs faster (relevant
 117  only on slower boards) and it is able to update the flash region
 118  where the image resides.</P
 119 ></DD
 120 ><DT
 121 >RAM mode</DT
 122 ><DD
 123 ><P
 124 >In this mode, RedBoot both resides and executes from
 125  RAM memory. This is used for updating a primary ROM
 126  mode image in situ and sometimes as part of the RedBoot installation
 127  on the board when there's already an existing (non-RedBoot) boot
 128  monitor available.</P
 129 ><P
 130 > You can only use ROM and ROMRAM mode images for booting a
 131  board - a RAM mode image cannot run unless loaded by another ROM
 132  monitor. There is no need for this startup mode if a RedBoot ROMRAM
 133  mode image is the primary boot monitor.  When this startup mode is
 134  programmed into flash (as a convenience as it's fast to load from
 135  flash) it will generally be named as "RedBoot[RAM]" in the FIS
 136  directory.  </P
 137 ></DD
 138 ></DL
 139 ></DIV
 140 >
 141
 142 The chosen mode has influence on flash and RAM resource usage (see
 143 <A
 144 HREF="resource-usage.html"
 145 >the Section called <I
 146 >RedBoot Resource Usage</I
 147 ></A
 148 >) and the procedure of an in situ update
 149 of RedBoot in flash (see <A
 150 HREF="updating-redboot.html"
 151 >Chapter 4</A
 152 >).</P
 153 ><P
 154 >The startup mode is controlled by the option CYG_HAL_STARTUP
 155 which resides in the platform HAL. Some platforms provide only some of
 156 the RAM, ROM, and ROMRAM modes, others provide additional
 157 modes.</P
 158 ><P
 159 >To see mode of a currently executing RedBoot, issue the
 160 <B
 161 CLASS="COMMAND"
 162 >version</B
 163 > command, which prints the RedBoot banner,
 164 including the startup mode (here ROM):
 165 <TABLE
 166 BORDER="5"
 167 BGCOLOR="#E0E0F0"
 168 WIDTH="70%"
 169 ><TR
 170 ><TD
 171 ><PRE
 172 CLASS="SCREEN"
 173 >RedBoot&#62;<TT
 174 CLASS="USERINPUT"
 175 ><B
 176 >version</B
 177 ></TT
 178 >
 179
 180 RedBoot(tm) bootstrap and debug environment <SPAN
 181 CLASS="emphasis"
 182 ><I
 183 CLASS="EMPHASIS"
 184 >[ROM]</I
 185 ></SPAN
 186 >
 187 Non-certified release, version UNKNOWN - built 13:31:57, May 17 2002</PRE
 188 ></TD
 189 ></TR
 190 ></TABLE
 191 ></P
 192 ></DIV
 193 ><DIV
 194 CLASS="NAVFOOTER"
 195 ><HR
 196 ALIGN="LEFT"
 197 WIDTH="100%"><TABLE
 198 SUMMARY="Footer navigation table"
 199 WIDTH="100%"
 200 BORDER="0"
 201 CELLPADDING="0"
 202 CELLSPACING="0"
 203 ><TR
 204 ><TD
 205 WIDTH="33%"
 206 ALIGN="left"
 207 VALIGN="top"
 208 ><A
 209 HREF="redboot-editing-commands.html"
 210 ACCESSKEY="P"
 211 >Prev</A
 212 ></TD
 213 ><TD
 214 WIDTH="34%"
 215 ALIGN="center"
 216 VALIGN="top"
 217 ><A
 218 HREF="ecos-ref.html"
 219 ACCESSKEY="H"
 220 >Home</A
 221 ></TD
 222 ><TD
 223 WIDTH="33%"
 224 ALIGN="right"
 225 VALIGN="top"
 226 ><A
 227 HREF="resource-usage.html"
 228 ACCESSKEY="N"
 229 >Next</A
 230 ></TD
 231 ></TR
 232 ><TR
 233 ><TD
 234 WIDTH="33%"
 235 ALIGN="left"
 236 VALIGN="top"
 237 >RedBoot Editing Commands</TD
 238 ><TD
 239 WIDTH="34%"
 240 ALIGN="center"
 241 VALIGN="top"
 242 ><A
 243 HREF="getting-started-with-redboot.html"
 244 ACCESSKEY="U"
 245 >Up</A
 246 ></TD
 247 ><TD
 248 WIDTH="33%"
 249 ALIGN="right"
 250 VALIGN="top"
 251 >RedBoot Resource Usage</TD
 252 ></TR
 253 ></TABLE
 254 ></DIV
 255 ></BODY
 256 ></HTML
 257 >