doc/html/ref/fis-unlock-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 unlock</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="fis lock"
  26 HREF="fis-lock-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="fis erase"
  29 HREF="fis-erase-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="fis-lock-command.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-erase-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-UNLOCK-COMMAND">fis unlock</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN4257"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >fis unlock&nbsp;--&nbsp;Unlock flash area</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN4260"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >fis unlock</B
 100 >  {-f <TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 >flash_address</I
 104 ></TT
 105 >} {-l <TT
 106 CLASS="REPLACEABLE"
 107 ><I
 108 >length</I
 109 ></TT
 110 >}</P
 111 ></DIV
 112 ><DIV
 113 CLASS="REFSECT1"
 114 ><A
 115 NAME="AEN4267"
 116 ></A
 117 ><H2
 118 >Arguments</H2
 119 ><DIV
 120 CLASS="INFORMALTABLE"
 121 ><A
 122 NAME="AEN4269"><P
 123 ></P
 124 ><TABLE
 125 BORDER="1"
 126 CLASS="CALSTABLE"
 127 ><THEAD
 128 ><TR
 129 ><TH
 130 WIDTH="25%"
 131 ALIGN="LEFT"
 132 VALIGN="TOP"
 133 >Name</TH
 134 ><TH
 135 WIDTH="25%"
 136 ALIGN="LEFT"
 137 VALIGN="TOP"
 138 >Type</TH
 139 ><TH
 140 WIDTH="25%"
 141 ALIGN="LEFT"
 142 VALIGN="TOP"
 143 >Description</TH
 144 ><TH
 145 WIDTH="25%"
 146 ALIGN="LEFT"
 147 VALIGN="TOP"
 148 >Default</TH
 149 ></TR
 150 ></THEAD
 151 ><TBODY
 152 ><TR
 153 ><TD
 154 WIDTH="25%"
 155 ALIGN="LEFT"
 156 VALIGN="TOP"
 157 ><TT
 158 CLASS="REPLACEABLE"
 159 ><I
 160 >flash_address</I
 161 ></TT
 162 ></TD
 163 ><TD
 164 WIDTH="25%"
 165 ALIGN="LEFT"
 166 VALIGN="TOP"
 167 >Number</TD
 168 ><TD
 169 WIDTH="25%"
 170 ALIGN="LEFT"
 171 VALIGN="TOP"
 172 >Address of area to be unlocked.</TD
 173 ><TD
 174 WIDTH="25%"
 175 ALIGN="LEFT"
 176 VALIGN="TOP"
 177 >&nbsp;</TD
 178 ></TR
 179 ><TR
 180 ><TD
 181 WIDTH="25%"
 182 ALIGN="LEFT"
 183 VALIGN="TOP"
 184 ><TT
 185 CLASS="REPLACEABLE"
 186 ><I
 187 >length</I
 188 ></TT
 189 ></TD
 190 ><TD
 191 WIDTH="25%"
 192 ALIGN="LEFT"
 193 VALIGN="TOP"
 194 >Number</TD
 195 ><TD
 196 WIDTH="25%"
 197 ALIGN="LEFT"
 198 VALIGN="TOP"
 199 >Length of area to be unlocked.</TD
 200 ><TD
 201 WIDTH="25%"
 202 ALIGN="LEFT"
 203 VALIGN="TOP"
 204 >&nbsp;</TD
 205 ></TR
 206 ></TBODY
 207 ></TABLE
 208 ><P
 209 ></P
 210 ></DIV
 211 ></DIV
 212 ><DIV
 213 CLASS="REFSECT1"
 214 ><A
 215 NAME="AEN4294"
 216 ></A
 217 ><H2
 218 >Description</H2
 219 ><P
 220 >This command is used to unlock a portion of flash memory forcibly, allowing
 221 it to be updated. It must be issued for regions which have been locked before
 222 the FIS can reuse those portions of flash.</P
 223 ><DIV
 224 CLASS="NOTE"
 225 ><BLOCKQUOTE
 226 CLASS="NOTE"
 227 ><P
 228 ><B
 229 >Note: </B
 230 >Some flash devices power up in locked state and always need to
 231 be manually unlocked before they can be written to.</P
 232 ></BLOCKQUOTE
 233 ></DIV
 234 ></DIV
 235 ><DIV
 236 CLASS="REFSECT1"
 237 ><A
 238 NAME="AEN4299"
 239 ></A
 240 ><H2
 241 >Examples</H2
 242 ><P
 243 >Unlock an area of the flash
 244 <TABLE
 245 BORDER="5"
 246 BGCOLOR="#E0E0F0"
 247 WIDTH="70%"
 248 ><TR
 249 ><TD
 250 ><PRE
 251 CLASS="SCREEN"
 252 >RedBoot&#62; <TT
 253 CLASS="USERINPUT"
 254 ><B
 255 >fis unlock -f 0xa0040000 -l 0x20000</B
 256 ></TT
 257 >
 258 ... Unlock from 0xa0040000-0xa0060000: .</PRE
 259 ></TD
 260 ></TR
 261 ></TABLE
 262 ></P
 263 ></DIV
 264 ><DIV
 265 CLASS="NAVFOOTER"
 266 ><HR
 267 ALIGN="LEFT"
 268 WIDTH="100%"><TABLE
 269 SUMMARY="Footer navigation table"
 270 WIDTH="100%"
 271 BORDER="0"
 272 CELLPADDING="0"
 273 CELLSPACING="0"
 274 ><TR
 275 ><TD
 276 WIDTH="33%"
 277 ALIGN="left"
 278 VALIGN="top"
 279 ><A
 280 HREF="fis-lock-command.html"
 281 ACCESSKEY="P"
 282 >Prev</A
 283 ></TD
 284 ><TD
 285 WIDTH="34%"
 286 ALIGN="center"
 287 VALIGN="top"
 288 ><A
 289 HREF="ecos-ref.html"
 290 ACCESSKEY="H"
 291 >Home</A
 292 ></TD
 293 ><TD
 294 WIDTH="33%"
 295 ALIGN="right"
 296 VALIGN="top"
 297 ><A
 298 HREF="fis-erase-command.html"
 299 ACCESSKEY="N"
 300 >Next</A
 301 ></TD
 302 ></TR
 303 ><TR
 304 ><TD
 305 WIDTH="33%"
 306 ALIGN="left"
 307 VALIGN="top"
 308 >fis lock</TD
 309 ><TD
 310 WIDTH="34%"
 311 ALIGN="center"
 312 VALIGN="top"
 313 ><A
 314 HREF="flash-image-system.html"
 315 ACCESSKEY="U"
 316 >Up</A
 317 ></TD
 318 ><TD
 319 WIDTH="33%"
 320 ALIGN="right"
 321 VALIGN="top"
 322 >fis erase</TD
 323 ></TR
 324 ></TABLE
 325 ></DIV
 326 ></BODY
 327 ></HTML
 328 >