doc/html/ref/fis-write-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 write</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 erase"
  26 HREF="fis-erase-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="Persistent State Flash-based Configuration and Control"
  29 HREF="persistent-state-flash.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-erase-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="persistent-state-flash.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-WRITE-COMMAND">fis write</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN4351"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >fis write&nbsp;--&nbsp;Write flash area</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN4354"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >fis write</B
 100 >  {-b <TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 >mem_address</I
 104 ></TT
 105 >} {-l <TT
 106 CLASS="REPLACEABLE"
 107 ><I
 108 >length</I
 109 ></TT
 110 >} {-f <TT
 111 CLASS="REPLACEABLE"
 112 ><I
 113 >flash_address</I
 114 ></TT
 115 >}</P
 116 ></DIV
 117 ><DIV
 118 CLASS="REFSECT1"
 119 ><A
 120 NAME="AEN4363"
 121 ></A
 122 ><H2
 123 >Arguments</H2
 124 ><DIV
 125 CLASS="INFORMALTABLE"
 126 ><A
 127 NAME="AEN4365"><P
 128 ></P
 129 ><TABLE
 130 BORDER="1"
 131 CLASS="CALSTABLE"
 132 ><THEAD
 133 ><TR
 134 ><TH
 135 WIDTH="25%"
 136 ALIGN="LEFT"
 137 VALIGN="TOP"
 138 >Name</TH
 139 ><TH
 140 WIDTH="25%"
 141 ALIGN="LEFT"
 142 VALIGN="TOP"
 143 >Type</TH
 144 ><TH
 145 WIDTH="25%"
 146 ALIGN="LEFT"
 147 VALIGN="TOP"
 148 >Description</TH
 149 ><TH
 150 WIDTH="25%"
 151 ALIGN="LEFT"
 152 VALIGN="TOP"
 153 >Default</TH
 154 ></TR
 155 ></THEAD
 156 ><TBODY
 157 ><TR
 158 ><TD
 159 WIDTH="25%"
 160 ALIGN="LEFT"
 161 VALIGN="TOP"
 162 ><TT
 163 CLASS="REPLACEABLE"
 164 ><I
 165 >mem_address</I
 166 ></TT
 167 ></TD
 168 ><TD
 169 WIDTH="25%"
 170 ALIGN="LEFT"
 171 VALIGN="TOP"
 172 >Number</TD
 173 ><TD
 174 WIDTH="25%"
 175 ALIGN="LEFT"
 176 VALIGN="TOP"
 177 >Address of data to be written to flash.</TD
 178 ><TD
 179 WIDTH="25%"
 180 ALIGN="LEFT"
 181 VALIGN="TOP"
 182 >&nbsp;</TD
 183 ></TR
 184 ><TR
 185 ><TD
 186 WIDTH="25%"
 187 ALIGN="LEFT"
 188 VALIGN="TOP"
 189 ><TT
 190 CLASS="REPLACEABLE"
 191 ><I
 192 >length</I
 193 ></TT
 194 ></TD
 195 ><TD
 196 WIDTH="25%"
 197 ALIGN="LEFT"
 198 VALIGN="TOP"
 199 >Number</TD
 200 ><TD
 201 WIDTH="25%"
 202 ALIGN="LEFT"
 203 VALIGN="TOP"
 204 >Length of data to be writtem.</TD
 205 ><TD
 206 WIDTH="25%"
 207 ALIGN="LEFT"
 208 VALIGN="TOP"
 209 >&nbsp;</TD
 210 ></TR
 211 ><TR
 212 ><TD
 213 WIDTH="25%"
 214 ALIGN="LEFT"
 215 VALIGN="TOP"
 216 ><TT
 217 CLASS="REPLACEABLE"
 218 ><I
 219 >flash_address</I
 220 ></TT
 221 ></TD
 222 ><TD
 223 WIDTH="25%"
 224 ALIGN="LEFT"
 225 VALIGN="TOP"
 226 >Number</TD
 227 ><TD
 228 WIDTH="25%"
 229 ALIGN="LEFT"
 230 VALIGN="TOP"
 231 >Address of flash to write to.</TD
 232 ><TD
 233 WIDTH="25%"
 234 ALIGN="LEFT"
 235 VALIGN="TOP"
 236 >&nbsp;</TD
 237 ></TR
 238 ></TBODY
 239 ></TABLE
 240 ><P
 241 ></P
 242 ></DIV
 243 ></DIV
 244 ><DIV
 245 CLASS="REFSECT1"
 246 ><A
 247 NAME="AEN4396"
 248 ></A
 249 ><H2
 250 >Description</H2
 251 ><P
 252 >This command is used to write data from memory to flash. There
 253 is no cross-checking to ensure that the area being written to does not
 254 correspond to an existing image.</P
 255 ></DIV
 256 ><DIV
 257 CLASS="REFSECT1"
 258 ><A
 259 NAME="AEN4399"
 260 ></A
 261 ><H2
 262 >Examples</H2
 263 ><P
 264 >Write an area of data to the flash
 265 <TABLE
 266 BORDER="5"
 267 BGCOLOR="#E0E0F0"
 268 WIDTH="70%"
 269 ><TR
 270 ><TD
 271 ><PRE
 272 CLASS="SCREEN"
 273 >RedBoot&#62; <TT
 274 CLASS="USERINPUT"
 275 ><B
 276 >fis write -b 0x0606f000 -l 0x1000 -f 0x00020000</B
 277 ></TT
 278 >
 279 * CAUTION * about to program FLASH
 280             at 0x00020000..0x0002ffff from 0x0606f000 - continue (y/n)? <TT
 281 CLASS="USERINPUT"
 282 ><B
 283 >y</B
 284 ></TT
 285 >
 286 ... Erase from 0x00020000-0x00030000: .
 287 ... Program from 0x0606f000-0x0607f000 at 0x00020000: .</PRE
 288 ></TD
 289 ></TR
 290 ></TABLE
 291 ></P
 292 ></DIV
 293 ><DIV
 294 CLASS="NAVFOOTER"
 295 ><HR
 296 ALIGN="LEFT"
 297 WIDTH="100%"><TABLE
 298 SUMMARY="Footer navigation table"
 299 WIDTH="100%"
 300 BORDER="0"
 301 CELLPADDING="0"
 302 CELLSPACING="0"
 303 ><TR
 304 ><TD
 305 WIDTH="33%"
 306 ALIGN="left"
 307 VALIGN="top"
 308 ><A
 309 HREF="fis-erase-command.html"
 310 ACCESSKEY="P"
 311 >Prev</A
 312 ></TD
 313 ><TD
 314 WIDTH="34%"
 315 ALIGN="center"
 316 VALIGN="top"
 317 ><A
 318 HREF="ecos-ref.html"
 319 ACCESSKEY="H"
 320 >Home</A
 321 ></TD
 322 ><TD
 323 WIDTH="33%"
 324 ALIGN="right"
 325 VALIGN="top"
 326 ><A
 327 HREF="persistent-state-flash.html"
 328 ACCESSKEY="N"
 329 >Next</A
 330 ></TD
 331 ></TR
 332 ><TR
 333 ><TD
 334 WIDTH="33%"
 335 ALIGN="left"
 336 VALIGN="top"
 337 >fis erase</TD
 338 ><TD
 339 WIDTH="34%"
 340 ALIGN="center"
 341 VALIGN="top"
 342 ><A
 343 HREF="flash-image-system.html"
 344 ACCESSKEY="U"
 345 >Up</A
 346 ></TD
 347 ><TD
 348 WIDTH="33%"
 349 ALIGN="right"
 350 VALIGN="top"
 351 >Persistent State Flash-based Configuration and Control</TD
 352 ></TR
 353 ></TABLE
 354 ></DIV
 355 ></BODY
 356 ></HTML
 357 >