doc/html/ref/fis-init-command.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 >fis init</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="Flash Image System (FIS)"
  23 HREF="flash-image-system.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Flash Image System (FIS)"
  26 HREF="flash-image-system.html"><LINK
  27 REL="NEXT"
  28 TITLE="fis list"
  29 HREF="fis-list-command.html"></HEAD
  30 ><BODY
  31 CLASS="REFENTRY"
  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="flash-image-system.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 ></TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="fis-list-command.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><H1
  81 ><A
  82 NAME="FIS-INIT-COMMAND">fis init</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN3892"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >fis init&nbsp;--&nbsp;Initialize Flash Image System (FIS)</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN3895"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >fis init</B
 100 >  [<TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 >-f</I
 104 ></TT
 105 >]</P
 106 ></DIV
 107 ><DIV
 108 CLASS="REFSECT1"
 109 ><A
 110 NAME="AEN3900"
 111 ></A
 112 ><H2
 113 >Arguments</H2
 114 ><DIV
 115 CLASS="INFORMALTABLE"
 116 ><A
 117 NAME="AEN3902"><P
 118 ></P
 119 ><TABLE
 120 BORDER="1"
 121 CLASS="CALSTABLE"
 122 ><THEAD
 123 ><TR
 124 ><TH
 125 WIDTH="25%"
 126 ALIGN="LEFT"
 127 VALIGN="TOP"
 128 >Name</TH
 129 ><TH
 130 WIDTH="25%"
 131 ALIGN="LEFT"
 132 VALIGN="TOP"
 133 >Type</TH
 134 ><TH
 135 WIDTH="25%"
 136 ALIGN="LEFT"
 137 VALIGN="TOP"
 138 >Description</TH
 139 ><TH
 140 WIDTH="25%"
 141 ALIGN="LEFT"
 142 VALIGN="TOP"
 143 >Default</TH
 144 ></TR
 145 ></THEAD
 146 ><TBODY
 147 ><TR
 148 ><TD
 149 WIDTH="25%"
 150 ALIGN="LEFT"
 151 VALIGN="TOP"
 152 >-f</TD
 153 ><TD
 154 WIDTH="25%"
 155 ALIGN="LEFT"
 156 VALIGN="TOP"
 157 >&nbsp;</TD
 158 ><TD
 159 WIDTH="25%"
 160 ALIGN="LEFT"
 161 VALIGN="TOP"
 162 >All blocks of flash memory (except for the boot
 163               blocks) will be erased as part of the initialization
 164               procedure.</TD
 165 ><TD
 166 WIDTH="25%"
 167 ALIGN="LEFT"
 168 VALIGN="TOP"
 169 >&nbsp;</TD
 170 ></TR
 171 ></TBODY
 172 ></TABLE
 173 ><P
 174 ></P
 175 ></DIV
 176 ></DIV
 177 ><DIV
 178 CLASS="REFSECT1"
 179 ><A
 180 NAME="AEN3920"
 181 ></A
 182 ><H2
 183 >Description</H2
 184 ><P
 185 >This command is used to initialize the Flash Image System
 186        (FIS). It should normally only be executed once, when RedBoot
 187        is first installed on the hardware. If the reserved images or
 188        their sizes in the FIS change, due to a different configuration
 189        of RedBoot being used, it may be necessary to issue the command
 190        again though.
 191
 192         <DIV
 193 CLASS="NOTE"
 194 ><BLOCKQUOTE
 195 CLASS="NOTE"
 196 ><P
 197 ><B
 198 >Note: </B
 199 >Subsequent executions will cause loss of
 200        previously stored information in the FIS.</P
 201 ></BLOCKQUOTE
 202 ></DIV
 203 >
 204      </P
 205 ></DIV
 206 ><DIV
 207 CLASS="REFSECT1"
 208 ><A
 209 NAME="AEN3925"
 210 ></A
 211 ><H2
 212 >Examples</H2
 213 ><P
 214 >Initialize the FIS directory.
 215 <TABLE
 216 BORDER="5"
 217 BGCOLOR="#E0E0F0"
 218 WIDTH="70%"
 219 ><TR
 220 ><TD
 221 ><PRE
 222 CLASS="SCREEN"
 223 >
 224 RedBoot&#62; <TT
 225 CLASS="USERINPUT"
 226 ><B
 227 >fis init</B
 228 ></TT
 229 >
 230 About to initialize [format] flash image system - continue (y/n)? <TT
 231 CLASS="USERINPUT"
 232 ><B
 233 >y</B
 234 ></TT
 235 >
 236 *** Initialize FLASH Image System
 237     Warning: device contents not erased, some blocks may not be usable
 238 ... Erase from 0x00070000-0x00080000: .
 239 ... Program from 0x0606f000-0x0607f000 at 0x00070000: .</PRE
 240 ></TD
 241 ></TR
 242 ></TABLE
 243 > </P
 244 ><P
 245 >Initialize the FIS directory and all of flash memory, except for first
 246 blocks of the flash where the boot monitor resides.
 247 <TABLE
 248 BORDER="5"
 249 BGCOLOR="#E0E0F0"
 250 WIDTH="70%"
 251 ><TR
 252 ><TD
 253 ><PRE
 254 CLASS="SCREEN"
 255 >
 256 RedBoot&#62; <TT
 257 CLASS="USERINPUT"
 258 ><B
 259 >fis init -f</B
 260 ></TT
 261 >
 262 About to initialize [format] flash image system - continue (y/n)? <TT
 263 CLASS="USERINPUT"
 264 ><B
 265 >y</B
 266 ></TT
 267 >
 268 *** Initialize FLASH Image System
 269 ... Erase from 0x00020000-0x00070000: .....
 270 ... Erase from 0x00080000-0x00080000:
 271 ... Erase from 0x00070000-0x00080000: .
 272 ... Program from 0x0606f000-0x0607f000 at 0x00070000: .                         </PRE
 273 ></TD
 274 ></TR
 275 ></TABLE
 276 > </P
 277 ></DIV
 278 ><DIV
 279 CLASS="NAVFOOTER"
 280 ><HR
 281 ALIGN="LEFT"
 282 WIDTH="100%"><TABLE
 283 SUMMARY="Footer navigation table"
 284 WIDTH="100%"
 285 BORDER="0"
 286 CELLPADDING="0"
 287 CELLSPACING="0"
 288 ><TR
 289 ><TD
 290 WIDTH="33%"
 291 ALIGN="left"
 292 VALIGN="top"
 293 ><A
 294 HREF="flash-image-system.html"
 295 ACCESSKEY="P"
 296 >Prev</A
 297 ></TD
 298 ><TD
 299 WIDTH="34%"
 300 ALIGN="center"
 301 VALIGN="top"
 302 ><A
 303 HREF="ecos-ref.html"
 304 ACCESSKEY="H"
 305 >Home</A
 306 ></TD
 307 ><TD
 308 WIDTH="33%"
 309 ALIGN="right"
 310 VALIGN="top"
 311 ><A
 312 HREF="fis-list-command.html"
 313 ACCESSKEY="N"
 314 >Next</A
 315 ></TD
 316 ></TR
 317 ><TR
 318 ><TD
 319 WIDTH="33%"
 320 ALIGN="left"
 321 VALIGN="top"
 322 >Flash Image System (FIS)</TD
 323 ><TD
 324 WIDTH="34%"
 325 ALIGN="center"
 326 VALIGN="top"
 327 ><A
 328 HREF="flash-image-system.html"
 329 ACCESSKEY="U"
 330 >Up</A
 331 ></TD
 332 ><TD
 333 WIDTH="33%"
 334 ALIGN="right"
 335 VALIGN="top"
 336 >fis list</TD
 337 ></TR
 338 ></TABLE
 339 ></DIV
 340 ></BODY
 341 ></HTML
 342 >