redboot_cmds.sgml

来自「ecos实时嵌入式操作系统」· SGML 代码 · 共 1,934 行 · 第 1/5 页

Where possible (hardware support permitting), this will be
equivalent to a power-on reset condition.
      </para>
    </refsect1>
    <refsect1>
      <title>Examples</title>
      <para>
Reset the platform.
<screen>
RedBoot> <userinput>reset</userinput>
... Resetting.+... Waiting for network card: .
Socket Communications, Inc: Low Power Ethernet CF Revision C 5V/3.3V 08/27/98
Ethernet eth0: MAC address 00:c0:1b:00:ba:28
IP: 192.168.1.29, Default server: 192.168.1.101

RedBoot(tm) bootstrap and debug environment [ROM]
Non-certified release, version UNKNOWN - built 10:41:41, May 14 2002

Platform: Compaq iPAQ Pocket PC (StrongARM 1110) 
Copyright (C) 2000, 2001, 2002, Red Hat, Inc.

RAM: 0x00000000-0x01fc0000, 0x00014748-0x01f71000 available
FLASH: 0x50000000 - 0x51000000, 64 blocks of 0x00040000 bytes each.
RedBoot> 
</screen> 
      </para>
    </refsect1>
  </refentry>


<!-- ******** version *************************************************** -->
  <refentry id="version-command">
    <refnamediv>
      <refname>version</refname>
      <refpurpose>Display RedBoot version information</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>version</command>
      </cmdsynopsis>
    </refsynopsisdiv>
    <refsect1>
      <title>Arguments</title>
      <para><emphasis>None</emphasis></para>
    </refsect1>
    <refsect1>
      <title>Description</title>
      <para>The <command>version</command> command simply displays version information about RedBoot.
      </para>
    </refsect1>
    <refsect1>
      <title>Examples</title>
      <para>
Display RedBoot's version.
<screen>
RedBoot> <userinput>version</userinput>
RedBoot(tm) debug environment - built 09:12:03, Feb 12 2001
Platform: XYZ (PowerPC 860)
Copyright (C) 2000, 2001, Red Hat, Inc.
RAM: 0x00000000-0x00400000
</screen> 
      </para>
    </refsect1>
  </refentry>

</sect1>
 
<sect1 id="Flash-Image-System">
<title>Flash Image System (FIS)</title>
<para><indexterm><primary>commands</primary><secondary>flash image system
</secondary></indexterm><indexterm><primary>flash image system commands</primary>
</indexterm><indexterm><primary>commands</primary><secondary>fis</secondary>
</indexterm><indexterm><primary>fis commands</primary></indexterm>If the platform
has flash memory, RedBoot can use this for image storage. Executable images,
as well as data, can be stored in flash in a simple file store. The <command>
fis</command> command (fis is short for Flash Image System) is used to
manipulate and maintain flash images.
</para>

<!-- ******** fis init ************************************************ -->

  <refentry id="fis-init-command">
    <refnamediv>
      <refname>fis init</refname>
      <refpurpose>Initialize Flash Image System (FIS)</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>fis init</command>
	<arg><replaceable>-f</replaceable></arg>
      </cmdsynopsis>
    </refsynopsisdiv>
    <refsect1>
      <title>Arguments</title>
      <informaltable frame="all">
	<tgroup cols="4" colsep="1" rowsep="1" align="left">
	  <colspec colname="c1">
	  <colspec colname="c2">
	  <colspec colname="c3">
	  <colspec colname="c4">
	  <thead>
	    <row>
	      <entry>Name</entry>
	      <entry>Type</entry>
	      <entry>Description</entry>
	      <entry>Default</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry>-f</entry>	     
	      <entry></entry>
	      <entry>All blocks of flash memory (except for the boot
	      blocks) will be erased as part of the initialization
	      procedure.</entry>
	      <entry></entry>	     
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </refsect1>
    <refsect1>
      <title>Description</title>

       <para>This command is used to initialize the Flash Image System
       (FIS). It should normally only be executed once, when RedBoot
       is first installed on the hardware. If the reserved images or
       their sizes in the FIS change, due to a different configuration
       of RedBoot being used, it may be necessary to issue the command
       again though.

        <note><para>Subsequent executions will cause loss of
       previously stored information in the FIS.</para></note>
     </para>
    </refsect1>
    <refsect1>
      <title>Examples</title>
      <para>
Initialize the FIS directory.
<screen> 
RedBoot> <userinput>fis init</userinput>
About to initialize [format] flash image system - continue (y/n)? <userinput>y</userinput>
*** Initialize FLASH Image System
    Warning: device contents not erased, some blocks may not be usable
... Erase from 0x00070000-0x00080000: .
... Program from 0x0606f000-0x0607f000 at 0x00070000: .
</screen> 
</para>

      <para>
Initialize the FIS directory and all of flash memory, except for first
blocks of the flash where the boot monitor resides.
<screen> 
RedBoot> <userinput>fis init -f</userinput>
About to initialize [format] flash image system - continue (y/n)? <userinput>y</userinput>
*** Initialize FLASH Image System                                               
... Erase from 0x00020000-0x00070000: .....                                     
... Erase from 0x00080000-0x00080000:                                           
... Erase from 0x00070000-0x00080000: .                                         
... Program from 0x0606f000-0x0607f000 at 0x00070000: .                         
</screen> 
</para>
</refsect1>
</refentry>

<!-- ******** fis list ************************************************ -->
  <refentry id="fis-list-command">
    <refnamediv>
      <refname>fis list</refname>
      <refpurpose>List Flash Image System directory</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>fis list</command>
	<arg><replaceable>-f</replaceable></arg>
      </cmdsynopsis>
    </refsynopsisdiv>
    <refsect1>
      <title>Arguments</title>
      <informaltable frame="all">
	<tgroup cols="4" colsep="1" rowsep="1" align="left">
	  <colspec colname="c1">
	  <colspec colname="c2">
	  <colspec colname="c3">
	  <colspec colname="c4">
	  <thead>
	    <row>
	      <entry>Name</entry>
	      <entry>Type</entry>
	      <entry>Description</entry>
	      <entry>Default</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry>-c</entry>
	      <entry></entry>
	      <entry>Show image checksum instead of memory address
	      (column <computeroutput>Mem addr</computeroutput> is
	      replaced by
	      <computeroutput>Checksum</computeroutput>).</entry>
	      <entry></entry>
	    </row>
	    <row>
	      <entry>-d</entry>
	      <entry></entry>
	      <entry>Show image data length instead of amount of flash
	      occupied by image (column
	      <computeroutput>Length</computeroutput> is replaced by
	      <computeroutput>Datalen</computeroutput>).</entry>
	      <entry></entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </refsect1>
    <refsect1>
      <title>Description</title>
<para>This command lists the images currently available in the FIS. Certain
images used by RedBoot have fixed names and have reserved slots in the
FIS (these can be seen after using the <command>fis init</command>
command). Other images can be manipulated by the user.</para>
<note><para>The images are listed in the order they appear in the FIS
directory, not by name or creation time.</para></note>
    </refsect1>

    <refsect1>
      <title>Examples</title>
      <para>
List the FIS directory.
<screen> 
RedBoot> <userinput>fis list</userinput>
Name              FLASH addr  Mem addr    Length      Entry point               
RedBoot           0x00000000  0x00000000  0x00020000  0x00000000                
RedBoot config    0x0007F000  0x0007F000  0x00001000  0x00000000                
FIS directory     0x00070000  0x00070000  0x0000F000  0x00000000                
</screen> 
</para>

      <para>
List the FIS directory, with image checksums substituted for
memory addresses.
<screen> 
RedBoot> <userinput>fis list -c</userinput>
Name              FLASH addr  Checksum    Length      Entry point               
RedBoot           0x00000000  0x00000000  0x00020000  0x00000000                
RedBoot config    0x0007F000  0x00000000  0x00001000  0x00000000                
FIS directory     0x00070000  0x00000000  0x0000F000  0x00000000                
</screen> 
</para>

      <para>
List the FIS directory with image data lengths substituted for flash
block reservation lengths.
<screen> 
RedBoot> <userinput>fis list</userinput>
Name              FLASH addr  Mem addr    Datalen     Entry point               
RedBoot           0x00000000  0x00000000  0x00000000  0x00000000                
RedBoot config    0x0007F000  0x0007F000  0x00000000  0x00000000                
FIS directory     0x00070000  0x00070000  0x00000000  0x00000000                
</screen> 
</para>
</refsect1>
</refentry>

<!-- ******** fis free ************************************************ -->

  <refentry id="fis-free-command">
    <refnamediv>
      <refname>fis free</refname>
      <refpurpose>Free flash image</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>fis free</command>
      </cmdsynopsis>
    </refsynopsisdiv>
    <refsect1>
      <title>Description</title>


<para>This command shows which areas of the flash memory are currently
not in use. When a block contains non-erased contents it is considered
in use. Since it is possible to force an image to be loaded at a
particular flash location, this command can be used to check whether
that location is in use by any other image.</para>

<note><para>There is currently no cross-checking between actual flash
contents and the FIS directory, which mans that there could be a
segment of flash which is not erased that does not correspond to a
named image, or vice-versa.</para></note>
    </refsect1>

    <refsect1>
      <title>Examples</title>
      <para>
Show free flash areas.
<screen>
RedBoot> <userinput>fis free</userinput>
        0xA0040000 .. 0xA07C0000
        0xA0840000 .. 0xA0FC0000
</screen></para>
</refsect1>
</refentry>

<!-- ******** fis create ************************************************ -->

  <refentry id="fis-create-command">
    <refnamediv>
      <refname>fis create</refname>
      <refpurpose>Create flash image</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>fis create</command>
	<arg choice="req">-b <replaceable> data address</replaceable></arg>
	<arg choice="req">-l <replaceable> length</replaceable></arg>
	<arg>-f <replaceable> flash address</replaceable></arg>
	<arg>-e <replaceable> entry</replaceable></arg>
	<arg>-r <replaceable> relocation address</replaceable></arg>
	<arg>-s <replaceable> data length</replaceable></arg>
	<arg>-n </arg>
	<arg><replaceable>name</replaceable></arg>
      </cmdsynopsis>
    </refsynopsisdiv>
    <refsect1>
      <title>Arguments</title>
      <informaltable frame="all">
	<tgroup cols="4" colsep="1" rowsep="1" align="left">
	  <colspec colname="c1">
	  <colspec colname="c2">
	  <colspec colname="c3">
	  <colspec colname="c4">
	  <thead>
	    <row>
	      <entry>Name</entry>
	      <entry>Type</entry>
	      <entry>Description</entry>
	      <entry>Default</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry>-b</entry>
	      <entry>Number</entry>
	      <entry>Address of data to be written to the flash.</entry>
	      <entry>Address of last loaded file. If not set in a load
	      operation, it must be specified.</entry>
	    </row>
	    <row>
	      <entry>-l</entry>
	      <entry>Number</entry>
	      <entry>Length of flash area to occopy. If specified, and
	      the named image already exists, the length must match
	      the value in the FIS directory.</entry>
	      <entry>Length of area reserved in FIS directory if the
	      image already exists, or the length of the last loaded
	      file. If neither are set, it must be specified.</entry>
	    </row>
	    <row>
	      <entry>-f</entry>
	      <entry>Number</entry>
	      <entry>Address of flash area to occopy.</entry>
	      <entry>The address of an area reserved in the FIS
	      directory for extant images. Otherwise the first free block
	      which is large enough will be used.</entry>
	    </row>
	    <row>
	      <entry>-e</entry>
	      <entry>Number</entry>
	      <entry>Entry address for an executable image, used by
	      the <command>fis load</command> command.</entry>
	      <entry>The entry address of last loaded file.</entry>
	    </row>
	    <row>
	      <entry>-r</entry>
	      <entry>Number</entry>
	      <entry>Address where the image should be relocated to by
	      the <command>fis load</command> command. This is only
	      relevant for images that will be loaded with the
	      <command>fis load</command> command.</entry>
	      <entry>The load address of the last loaded file.</entry>
	    </row>
            <row>
	      <entry>-s</entry>
	      <