intel x flash technology
TRANSCRIPT
-
8/13/2019 Intel x flash technology
1/38
IntelXFlash
Users Manual
September 2003
Revision 1.0
Order Number: 278859-001
-
8/13/2019 Intel x flash technology
2/38
IntelXFlash Users Manual
Information in this document is provided in connection with IntelProducts. No license, express or implied, by estoppel or otherwise, to anyintellectual property rights is granted by this document. Except as provided in Intel's Terms and Conditions of Sale for such products, Intel assumes noliability whatsoever, and Intel disclaims any express or implied warranty, relating to sale and/or use of Intel products including liability or warrantiesrelating to fitness for a particular purpose, merchantability, or infringement of any patent, copyright or other intellectual property right. Intel products arenot intended for use in medical, life saving, or life sustaining applications.
Intel may make changes to specifications and product descriptions at any time, without notice.
Designers must not rely on the absence or characteristics of any features or instructions marked reserved or undefined. Intel reserves these forfuture definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them.
This document and the software described in it are furnished under license and may only be used or copied in accordance with the terms of thelicense. The information in this document is furnished for informational use only, is subject to change without notice, and should not be construed as acommitment by Intel Corporation. Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in thisdocument or any software that may be provided in association with this document. Except as permitted by such license, no part of this document maybe reproduced, stored in a retrieval system, or transmitted in any form or by any means without the express written consent of Intel Corporation.
Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order.
Copies of documents which have an ordering number and are referenced in this document, or other Intel literature may be obtained by calling1-800-548-4725 or by visiting Intel's website at http://www.intel.com.
Copyright Intel Corporation, 2003
Intel and Intel XScale are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
* Other names and brands may be claimed as the property of others.
-
8/13/2019 Intel x flash technology
3/38
IntelXFlash Users Manual 3
Contents
Contents
1 Introduction......................................................................................................................................5
1.1 About this Manual.................................................................................................................61.2 Related Documentation ........................................................................................................71.3 Requirements .......................................................................................................................81.4 Conventions..........................................................................................................................9
2 General Usage ..............................................................................................................................11
2.1 Command Line Syntax .......................................................................................................122.1.1 Order of Arguments ...............................................................................................132.1.2 Option Arguments and their Order.........................................................................13
2.2 Option Overview .................................................................................................................14
3 IntelXFlash Options ....................................................................................................................15
3.1 -a.........................................................................................................................................163.2 -b.........................................................................................................................................173.3 -bb.......................................................................................................................................183.4 -bd.......................................................................................................................................193.5 -check .................................................................................................................................203.6 -e.........................................................................................................................................213.7 -f..........................................................................................................................................223.8 -help....................................................................................................................................233.9 -l ..........................................................................................................................................243.10 -lock ....................................................................................................................................253.11 -n.........................................................................................................................................263.12 -o.........................................................................................................................................273.13 -p.........................................................................................................................................28
3.14 -t..........................................................................................................................................293.15 -tgttype................................................................................................................................303.16 -u.........................................................................................................................................313.17 -unlock ................................................................................................................................323.18 -v.........................................................................................................................................333.19 -verify ..................................................................................................................................34
A Configuration File and Initialization................................................................................................35
Index .......................................................................................................................................................37
-
8/13/2019 Intel x flash technology
4/38
4 IntelXFlash Users Manual
Contents
Figures1 Structure of the Configuration File boards.ini .............................................................................35
Tables1 Intel XFlash Option Overview .....................................................................................................142 Available Binary Formats of the Image File................................................................................223 Flashnames for the Option -n .....................................................................................................26
Revision History
Date Revision Description
September 2003 1.0 SDT 1.2 Gold release for the IntelXFlash 1.0 and higher.
-
8/13/2019 Intel x flash technology
5/38
IntelXFlash Users Manual 5
Introduction 1
The IntelXFlash is a command line tool to access the flash memory of an embedded system
target board. It is used to write or erase data or code within a flash memory.
It supports the following features:
Support of several types of target boards
Support of all types of flash memory on the supported target board
Erasing flash memory
Writing flash memory
Verifying flash memory
Checking flash memory
-
8/13/2019 Intel x flash technology
6/38
6 IntelXFlash Users Manual
Introduction
1.1 About this Manual
This is a users manual which describes the usage of the IntelXFlash.
The following overview provides a short description of the chapters contained in the manual:
Chapter 1, Introductionis this chapter. It also includes related documentation, requirements,and an overview of the manuals conventions.
Chapter 2, General Usagedescribes the command line syntax to start the Intel XFlash andprovides an option overview.
Chapter 3, IntelXFlash Optionsdescribes each option with the syntax, description, and anexample.
Appendix Acovers information on the configuration file boards.ini and associatedinitialization scripts.
-
8/13/2019 Intel x flash technology
7/38
IntelXFlash Users Manual 7
Introduction
1.2 Related Documentation
This section provides an overview of documentation which supplements this manual. These are:
IntelXDB Debugger Reference Manual, order number 278461
IntelXDB JTAG Debugger Users Manual, order number 278471
Furthermore, Release Notes are provided. Release Notes describe features or changes of the
product that are not documented in the corresponding manual. For more information on the
development board, please refer to the manual associated with the board you are using.
Information on the Macraigor Systems OCDemon* interface is provided on the World Wide Web
on the following Website:
www.macraigor.com
-
8/13/2019 Intel x flash technology
8/38
8 IntelXFlash Users Manual
Introduction
1.3 Requirements
To use the IntelXFlash, the following environment is required:
Microsoft* Windows* 2000 Professional or Windows* XP Professional as host platform
The IntelXFlash installed on your host platform
The IntelXDB JTAG Debugger installed on your host platform
A development board
A parallel cable
A Macraigor Systems OCDemon* Raven ARM 20 JTAG interface
-
8/13/2019 Intel x flash technology
9/38
IntelXFlash Users Manual 9
Introduction
1.4 Conventions
This manual uses several notational and typographical conventions to visually differentiate text.
The following table explains these conventions.
Convention Description
Italics Italics identify variables and introduce new terminology. Titles of manuals are initalic font. Italics are used for emphasis.
Bold Used to specify something important.
Plain Courier Used to specify written code.
Italic Courier Used to specify parameters.
GUI-elements Elements of the graphical user interface are written in this style.
Filenames and function names to be defined are delimited by .
| Used to specify an alternative between several items.
,... Used to specify an item which may be repeated.
[ ] Used to specify optional items.
{ } Used to specify an optional item which may be repeated.
"[" "]" "{" "}" "|" Writing a metacharacter in quotation marks negates the syntactical meaningstated above; the character is taken as a li teral. For example, the line"[" X "]" [ Y ]denotes the letter X enclosed in brackets, optionally followed by the letter Y.
-
8/13/2019 Intel x flash technology
10/38
10 IntelXFlash Users Manual
Introduction
This page intentionally left blank.
-
8/13/2019 Intel x flash technology
11/38
IntelXFlash Users Manual 11
General Usage 2
This chapter provides the general usage of the IntelXFlash, including:
Section 2.1, Command Line Syntax on page 12describes the command line syntax andshows a simple example. It also describes the mandatory order of options.
Section 2.2, Option Overview on page 14provides a brief description of options.
-
8/13/2019 Intel x flash technology
12/38
12 IntelXFlash Users Manual
General Usage
2.1 Command Line Syntax
The Intel XFlash is started using the following command line:
where:
Standard mode: xflash[imagefile] -pplatform [options]
Expert mode: xflash[imagefile] -tplatform [options]
Argument Description
xflash xflashis the program name. The Intel XFlash can be used instandard modeand expert mode. We recommend to use thestandard mode. Where expert mode is an expanded standardmode providing additional options. See also Section 2.2, OptionOverview on page 14and Chapter 3, IntelXFlash Options. Ifyou start the program from another directory location than it is
installed, you need to specify the entire directory path to theprogram. E.g. C:\programs\xflash.
imagefile Specifies the complete name of the image file including fileextension and the directory path. The specification ofimagefileis not allowed if the option -eis used. See alsoSection 3.6, -e on page 21.
-pplatform-tplatform
The option -por -tis mandatory. If -pis used, the Intel XFlashis started in standard mode where -tstarts the Intel XFlash inexpert mode. The difference between standard and expert modeis the number of options. There are some additional options thatcan only be used in expert mode. See also Section 2.2, OptionOverview on page 14and Chapter 3, IntelXFlash Options.The parameterplatformspecifies the board being used. Allparameters available forplatformare listed in the boards.ini fileand are case-sensitive. For more information on the parameter
list refer toAppendix A.options The Intel XFlash may be called using command line options.
Available options are described Section 2.2, Option Overviewon page 14and Chapter 3, IntelXFlash Options.The numbersof options related to standard mode and expert mode differs. Instandard mode, all options specific to expert mode are disabledwhere in expert mode all options are supported.
-
8/13/2019 Intel x flash technology
13/38
IntelXFlash Users Manual 13
General Usage
Example 1. Starting the Intel XFlash
xflash C:\working\led.bin -p DPXA250
The command line above burns the image file led.bin, located in the directory C:\workinginto the
flash memory of the board.
Example 2. Starting the Intel XFlash
xflash ..\working\led.bin -p DPXA250
Assuming the Intel XFlash is installed inPrograms\Xflash, the command line above burns the
image file led.bin, located in the directoryPrograms\workinginto the flash memory of the board.
2.1.1 Order of Arguments
The order of arguments is important. Please see the command line syntax for details and
Section 2.1.2, Option Arguments and their Order on page 13.
2.1.2 Option Arguments and their Order
Option arguments optionsare preceded by -. They modify the default actions of the Intel
XFlash. The option names and their parameters are case-sensitive. The available options are
described in Section 2.2, Option Overview on page 14.
The orderof options is mandatory. The order is as follows:
-e -v -lock|-unlock -verify -check -n -f -a -u -l -o -b|-bb|-bd -tgttype "tgt"
-help
-
8/13/2019 Intel x flash technology
14/38
14 IntelXFlash Users Manual
General Usage
2.2 Option Overview
The following table contains a brief description of available command line options. Column Mode
shows if the option is in standard mode or in expert mode available. For a detailed description refer
to Chapter 3, IntelXFlash Options.
Warning: The order of options is mandatory. Please refer to Section 2.1.2, Option Arguments and their
Order on page 13.
Table 1. Intel XFlash Option Overview
Option
Mode
Description
Standard Expert
-a offset X X Sets an offset offsetfor the image file.
-b blocknumber|startblock-endblock
X Specifies which block blocknumberor which blockrange startblock-endblockare used. Only oneof -b, -bb, -bdmay be set.
-bb X Specifies that all boot blocks are used. Only one of-b, -bb, -bdmay be set.
-bd X Specifies that all data blocks are used. Only one of-b, -bb, -bdmay be set.
-check X X Checks if the flash memory has been erased.
-e X X Erases the complete flash memory. Only one of -e,-v, -lock, -unlockmay be set.
-fformat X X Sets the binary format of the image file to format.
-help X X Displays the help text. Use xflash -help.
-l address X Sets the start address of the relocatable burnalgorithm to address.
-lock X X Locks the complete flash memory. Only one of -e,-v, -lock, -unlockmay be set.
-n flashname X X Sets the targets external flash memory toflashname.
-o X Burns the flash without erasing the used blocks.
-pplatform X Sets the standard mode. Cannot be used with -t.
-tplatform X Sets the expert mode. Cannot be used with -p.
-tgttype "tgt" X X Sets the target connection interface to tgt.
-u base_address X X Sets the base address of the flash tobase_address.
-unlock X X Unlocks the complete flash memory. Only one of -e,-v, -lock, -unlockmay be set.
-v X X Compares the contents of the flash memory with theimage file. Only one of -e, -v, -lock, -unlockmaybe set.
-verify X X Compares the contents of the flash memory with theimage file after the burn process.
-
8/13/2019 Intel x flash technology
15/38
IntelXFlash Users Manual 15
IntelXFlash Options 3
This chapter describes all available command line options in detail. The syntax, a description and
examples are provided. For the usage of options and an overview, refer to Chapter 2, General
Usage.
Warning: The order of options is mandatory. Please refer to Section 2.1.2, Option Arguments and their
Order on page 13.
-
8/13/2019 Intel x flash technology
16/38
16 IntelXFlash Users Manual
IntelXFlash Options
3.1 -a
Syntax: -a offset
Description:
The -aoption defines the offset offsetfor the image file. A binary is burned at the flash
memorys base address + offset. A hex file is burned at the flash memorys base address + contained
address + offset. The default value of offsetis 0x0.
Example 3. Option -a
xflash hello.bin -p DPXA250 -a 0x0F
The flash memory of the board is burned at address 0x0000000F because the flash starts at 0x0.
-
8/13/2019 Intel x flash technology
17/38
IntelXFlash Users Manual 17
IntelXFlash Options
3.2 -b
Syntax: -b blocknumber| startblock-endblock
Note: This option requires option -t(expert mode).
Description:
The option -bspecifies which block or which block range of the flash memory is used. The
parameter blocknumberdefines the block number. In case of a block range, startblock
defines the first block number and endblockthe last block number. Note that option -brequires
option -t. Only one of -b, -bb, -bdmay be set. If none of them is set, all blocks are used. You
may combine this option with one of -e, -v, -lock, or -unlock.
Example 4. Option -b
xflash -t DPXA250 -unlock -b 0-10
The command line above unlocks the blocks 0-10 of the flash memory.
Further Information:
Section 3.3, -bb on page 18
Section 3.4, -bd on page 19
Section 3.6, -e on page 21
Section 3.10, -lock on page 25
Section 3.14, -t on page 29
Section 3.17, -unlock on page 32
Section 3.18, -v on page 33
-
8/13/2019 Intel x flash technology
18/38
18 IntelXFlash Users Manual
IntelXFlash Options
3.3 -bb
Syntax: -bb
Note: This option requires option -t(expert mode).
Description:
The option -bbspecifies that all boot blocks are used. Note that option -bbrequires option -t.
Only one of -b, -bb, -bd may be set. If none of them is set, all blocks are used. You may combine
this option with one of -e, -v, -lock, or -unlock.
Example 5. Option -bb
xflash -t DPXA250 -unlock -bb
The command line above unlocks all data blocks of the flash memory.
Further Information:
Section 3.2, -b on page 17
Section 3.4, -bd on page 19
Section 3.6, -e on page 21
Section 3.10, -lock on page 25
Section 3.14, -t on page 29
Section 3.17, -unlock on page 32
Section 3.18, -v on page 33
-
8/13/2019 Intel x flash technology
19/38
IntelXFlash Users Manual 19
IntelXFlash Options
3.4 -bd
Syntax: -bd
Note: This option requires option -t(expert mode).
Description:
The option -bdspecifies that all data blocks are used. Note that option -bdrequires option -t.
Only one of -b, -bb, -bd may be set. If none of them is set, all blocks are used. You may combine
this option with one of -e, -v, -lock, or -unlock.
Example 6. Option -bb
xflash -t DPXA250 -unlock -bd
The command line above unlocks all boot blocks of the flash memory.
Further Information:
Section 3.2, -b on page 17
Section 3.3, -bb on page 18
Section 3.6, -e on page 21
Section 3.10, -lock on page 25
Section 3.14, -t on page 29
Section 3.17, -unlock on page 32
Section 3.18, -v on page 33
-
8/13/2019 Intel x flash technology
20/38
20 IntelXFlash Users Manual
IntelXFlash Options
3.5 -check
Syntax: -check
Note: The option -checkcan only be combined with -b, -bb, -bd, not with other options.
Description:
When the option -checkis set, the Intel XFlash checks if the whole flash memory has been erased.
This is useful to check whether the memory is physically OK or not. The option -checkcan only
be combined with the options -b, -bd, -bb, not with other options. If the option -checkis
omitted, no check is performed.
Example 7. Option -check
xflash hello.bin -p DPXA250 -check
This command line checks if the flash memory of the board has been erased.
Further Information:
Section 3.2, -b on page 17
Section 3.3, -bb on page 18
Section 3.4, -bd on page 19
-
8/13/2019 Intel x flash technology
21/38
IntelXFlash Users Manual 21
IntelXFlash Options
3.6 -e
Syntax: -e
Description:
The option -eerases the complete flash memory, or erases specific blocks of the flash memory
when combined with one of the options -b, -bb, -bd. If the option -eis omitted, all used blocks
are automatically erased during the burn process. Only one of -e, -v, -lock, -unlockmay be
set.
Example 8. Option -e
xflash -t DPXA250 -e -b 0-10
The command line above erases the blocks 0-10 of the flash memory.
Further Information:
Section 3.2, -b on page 17
Section 3.3, -bb on page 18
Section 3.4, -bd on page 19
Section 3.10, -lock on page 25
Section 3.17, -unlock on page 32
Section 3.18, -v on page 33
-
8/13/2019 Intel x flash technology
22/38
22 IntelXFlash Users Manual
IntelXFlash Options
3.7 -f
Syntax: -fformat
Description:
The option -fenables to specify the binary format formatof the image file. If the option -fis
omitted, the Intel XFlash automatically detects the image file format. The parameter formatmay
have one of the following values:
Example 9. Option -f
xflash hello.hx -p DPXA250 -fi
This command line burns the flash memory of the board. The image file hello.hx contains the Intel
HEX format.
Table 2. Available Binary Formats of the Image File
Format Description
b absolute binary format
h Motorola* HEX format
i Intel HEX format
-
8/13/2019 Intel x flash technology
23/38
IntelXFlash Users Manual 23
IntelXFlash Options
3.8 -help
Syntax: -help
Description:
The option -helpdisplays an overview of available options in standard as well as expert mode.
Example 10. Option -help
xflash -help
This command line displays the help text.
-
8/13/2019 Intel x flash technology
24/38
24 IntelXFlash Users Manual
IntelXFlash Options
3.9 -l
Syntax: -l address
Note: This option requires option -t(expert mode).
Description:
The option -lenables to set the start address addressof the relocatable burn algorithm in the
flash memory. If the option -lis omitted, the Intel XFlash assumes the boards default. See also
Appendix A, Configuration File and Initialization.
Example 11. Option -l
xflash hello.bin -t DPXA250 -l 0xA0100000
Assuming an application has already been loaded to addresses 0xA0000000..0xA00FFFFF, the
command line above loads the start address of the burn algorithm at 0xA01000000.
Further Information:
Section 3.14, -t on page 29
-
8/13/2019 Intel x flash technology
25/38
IntelXFlash Users Manual 25
IntelXFlash Options
3.10 -lock
Syntax: -lock
Description:
The option -locklocks the complete flash memory, or locks specific blocks of the flash memory
when combined with one of the options -b, -bb, -bd. If -lockis omitted, all used blocks are
automatically locked during the burn process. Only one of -e, -v, -lock, -unlockmay be set.
Example 12. Option -lock
xflash -p DPXA250 -lock -b 0-10
The command line above locks the blocks 0-10 of the flash memory.
Further Information:Section 3.2, -b on page 17
Section 3.3, -bb on page 18
Section 3.4, -bd on page 19
Section 3.6, -e on page 21
Section 3.17, -unlock on page 32
Section 3.18, -v on page 33
-
8/13/2019 Intel x flash technology
26/38
26 IntelXFlash Users Manual
IntelXFlash Options
3.11 -n
Syntax: -n flashname
Description:
The option -nsets the name of the targets external flash memory to flashname. The parameter
flashnamemay have one of the values listed in Table 3.If the option -nis omitted, the Intel
XFlash assumes the boards standard external flash memory.
Example 13. Option -n
xflash hello.bin -p DBPXA250 -n GENPID_16
This command line burns the flash memory of the board using the external flash memory.
Table 3. Flashnames for the Option -n
Flash Type on Board flashname
B C W30 GENPID_SIMPLE
IQ80310 GENPID_IQ80310
J3 K3 K18 GENPID_8
J3 K3 K18 GENPID_16
MSA of PXA800F GENPID_S_800F_MSA
PXA262 internal GENPID_PXA262
XScale of PXA800F GENPID_S_800F_XS
-
8/13/2019 Intel x flash technology
27/38
IntelXFlash Users Manual 27
IntelXFlash Options
3.12 -o
Syntax: -o
Note: This option requires option -t(expert mode).
Description:
The option -oburns the flash without erasing the used blocks. If the option -ois omitted, all blocks
are automatically erased before the flash memory is burned.
Example 14. Option -o
xflash hello.bin -t DBPXA250 -o
The command line above overwrites all blocks during the burn process.
Further Information:
Section 3.2, -b on page 17
Section 3.3, -bb on page 18
Section 3.4, -bd on page 19
Section 3.14, -t on page 29
-
8/13/2019 Intel x flash technology
28/38
28 IntelXFlash Users Manual
IntelXFlash Options
3.13 -p
Syntax: -pplatform
Note: Either option -por -thas to be set.
Description:
The option -pstarts the Intel XFlash in standard mode. A specific set of options is enabled for this
mode. For an overview of enabled options in standard mode see Section 2.2, Option Overview on
page 14. The parameterplatformspecifies the board being used. All parameters available for
platformare listed in the boards.ini file and are case-sensitive. For more information on the
parameter list refer to Appendix A, Configuration File and Initialization.
Example 15. Option -p
xflash hello.bin -p DBPXA250
This command line burns the flash memory of the board using the image file hello.bin.
Further Information:
Section 3.14, -t on page 29
-
8/13/2019 Intel x flash technology
29/38
IntelXFlash Users Manual 29
IntelXFlash Options
3.14 -t
Syntax: -tplatform
Note: Either option -por -thas to be set.
Description:
The option -tstarts the Intel XFlash in expert mode. All options of the standard mode and an
additional set of options are enabled for this mode. For an overview of enabled options in expert
mode see Section 2.2, Option Overview on page 14. The parameterplatformspecifies the
board being used. All parameters available forplatformare listed in the boards.ini file and are
case-sensitive. For more information on the parameter list refer to Appendix A, Configuration File
and Initialization.
Example 16. Option -p
xflash hello.bin -t DBPXA250
This command line burns the flash memory of the board in expert mode using the image file
hello.bin.
Further Information:
Section 3.13, -p on page 28
-
8/13/2019 Intel x flash technology
30/38
30 IntelXFlash Users Manual
IntelXFlash Options
3.15 -tgttype
Syntax: -tgttype "tgt"
Description:
The option -tgttypesets the target connection interface to tgt. If the option -tgttypeis
omitted, the Intel XFlash assumes the Macraigor Systems OCDemon* Raven ARM 20 JTAG
interface. The parameter tgtmay have one of the following values:
Example 17. Option -tgttype
xflash hello.bin -p DBPXA250 -tgttype "JTAG XScale"
This command line burns the flash memory of the board using the Macraigor Systems OCDemon*
Raven ARM 20 JTAG interface.
tgt Description
JTAG XScale Specif ies the Macraigor Systems OCDemon* Raven ARM 20 JTAG interface.
-
8/13/2019 Intel x flash technology
31/38
IntelXFlash Users Manual 31
IntelXFlash Options
3.16 -u
Syntax: -u base_address
Description:
The option -usets the base address of the flash memory to the address base_address. The
parameter base_addressis a hexadecimal value. If the option -uis omitted, the Intel XFlash
assumes the boards default. See also Appendix A, Configuration File and Initialization.
Example 18. Option -u
xflash hello.bin -p DBPXA250 -u 0x100000
This command line burns the flash memory of the board. The base address of the flash memory is
set to 0x0B.
-
8/13/2019 Intel x flash technology
32/38
32 IntelXFlash Users Manual
IntelXFlash Options
3.17 -unlock
Syntax: -unlock
Description:
The option -unlockunlocks the complete flash memory, or unlocks specific blocks of the flash
memory when combined with one of the options -b, -bb, -bd. If -unlockis omitted, all used
blocks are automatically unlocked during the burn process. Only one of-e, -v, -lock, -unlock
may be set.
Example 19. Option -lock
xflash -t DBPXA250 -unlock -b 0-10
The command line above unlocks the blocks 0-10 of the flash memory.
Further Information:
Section 3.2, -b on page 17
Section 3.3, -bb on page 18
Section 3.4, -bd on page 19
Section 3.6, -e on page 21
Section 3.10, -lock on page 25
Section 3.18, -v on page 33
-
8/13/2019 Intel x flash technology
33/38
IntelXFlash Users Manual 33
IntelXFlash Options
3.18 -v
Syntax: -v
Description:
The option -vcompares the contents of the flash memory with the image file. No burn process is
performed. If -vis omitted, no comparison takes place. Only one of -e, -v, -lock, -unlock
may be set. The result of the comparison is printed to the screen using a message like the following
ones:
If the comparison fails:
...
Progress: 0%
Verify memory failed at address 0x4c.
Stop verifying
Error when verifying file!
If the comparison is successfully:
...
Progress: 100%
Memory Successfully Verified
File successfully verified.
Example 20. Option -v
xflash hello.bin -p DBPXA250 -v -b 0-10
The contents of the flash memory (block 0-10) is compared with the image file hello.bin.
Further Information:
Section 3.2, -b on page 17
Section 3.3, -bb on page 18
Section 3.4, -bd on page 19Section 3.6, -e on page 21
Section 3.10, -lock on page 25
Section 3.17, -unlock on page 32
Section 3.19, -verify on page 34
-
8/13/2019 Intel x flash technology
34/38
34 IntelXFlash Users Manual
IntelXFlash Options
3.19 -verify
Syntax: -verify
Description:
The option -verifycompares the contents of the flash memory with the image file after the burn
process. The result of the comparison is printed to the screen using a message shown in Section 3.18,
-v on page 33.If the option -verifyis omitted, the Intel XFlash performs a burn process only.
Example 21. Option -verify
xflash hello.bin -p DBPXA250 -verify
The flash memory of the board is burned. After the burn process has been completed, the contents
of the flash memory is compared with the image file.
Further Information:
Section 3.18, -v on page 33
-
8/13/2019 Intel x flash technology
35/38
IntelXFlash Users Manual 35
Configuration File and Initialization A
The IntelXFlash uses a board configuration file boards.ini.The configuration file contains
board-specific default settings such as the flash type of the board or the base address of the flash
memory. The installation of the Intel XFlash contains a predefined boards.ini file and initialization
scripts. Figure 1shows the structure of this configuration file.
The configuration file contains two types of sections: a global section and one or more platform
sections. The global section starts with [GLOBAL]followed by the target connection
connection=parameter. The parameterparameterspecifies the port, e.g. lpt1:1. The port may be
changed. The platform section starts with [platform]whereplatformis the name of the platform. Each
platform section contains the following lines:
The Intel XFlash uses an associated initialization script .xdb for the debugger as well.
Where filename is the name of the platform specified in the configuration file asplatform.
Figure 1. Structure of the Configuration File boards.ini
[GLOBAL]connection=parameter
[platform]standardflash=flashname
monaddr=maddress
scanchain=namealgoaddr=addressbaseaddr=base_address
...
...
...
[platform]standardflash=flashnamemonaddr=maddressscanchain=namealgoaddr=addressbaseaddr=base_address
Global section
Platform section 1
Platform section n
standardflash=flashname Defines the default flashname flashnameof the platform. To change the default,refer to Section 3.11, -n on page 26.
monaddr=maddress Defines the default address maddressthat is used with the option -monaddrinthe debugger startup command.
scanchain=name Defines the default board type namein the JTAG chain.
algoaddr=address Defines the default start address addressof the relocatable burn algorithm in theflash memory. The default value is 0xa. To change the default, refer toSection 3.9, -l on page 24.
baseaddr=base_address Defines the default base address base_addressof the flash memory. To changethe default, refer to Section 3.16, -u on page 31.
-
8/13/2019 Intel x flash technology
36/38
36 IntelXFlash Users Manual
Configuration File and Initialization
This page intentionally left blank.
-
8/13/2019 Intel x flash technology
37/38
IntelXFlash Users Manual 37
Index
Symbols-a, option 14,16-b, option 14, 17-bb, option 14,18-bd, option 14,19-check, option 14,20-e, option 14,21-f, option 14,22-help, option 14, 23-l, option 14, 24-lock, option 14, 25-n, option 14, 26-o, option 14, 27
-p, option 12, 14,28-t, option 12, 14,29-tgttype, option 14,30-u, option 14, 31-unlock, option 14, 32-v, option 14, 33-verify, option 14, 34
Aarguments, order 13
Bbase address 31, 35
binary format 22blocks
setting blocks to be used 17setting boot blocks to be used 18setting data blocks to be used 19
board type 35boards.ini, file 35boot blocks 18burn algorithm, start address 24
Cchecking flash memory 20command line syntax
expert mode 12
standard mode 12comparing flash memory with image file 33, 34configuration file 35conventions of this manual 9
Ddata blocks 19
data, overwriting 27defaults
base address 35board type 35flashname 35start address 35startup address 35
displaying help list 23documentation, related documentation 7
Eerasing flash memory 21expert mode 12, 29
Ffiles
boards.ini 35configuration file 35image file 12
comparing with flash memory 33, 34setting binary format 22
flash memorychecking 20comparing with image file 33, 34erasing 21locking 25setting name 26unlocking 32XFlash tool 5
flashname 35format setting binary format of image file 22
Ggeneral usage 11global section 35
Hhelp list 23
Iimage file 12
comparing with flash memory 33, 34setting binary format 22
initialization script 35Intel XFlash
general usage 1114introduction 5
-
8/13/2019 Intel x flash technology
38/38
options 1534
Llocking flash memory 25
Mmanuals, related manuals 7
Nnames, flashname 35
Ooptions 1534
order 13overview 14
-a 14, 16-b 14,17-bb 14, 18-bd 14, 19-check 14, 20-e 14, 21-f 14, 22-help 14,23-l 14,24-lock 14,25-n 14,26-o 14,27-p 12,14, 28-t 12,14, 29-tgttype 14, 30
-u 14,31-unlock 14,32-v 14,33-verify 14,34
orderof arguments 13
of option arguments 13overwriting existing data 27
Pplatform 12
platform section 35
Rrequirements 8
Ssetting
base address 31binary format of image file 22blocks 17boot blocks 18
data blocks 19name of external flash 26start address of burn algorithm 24target connection 30
standard mode 12, 28start address 35
of burn algorithm 24startup address 35
Ttarget connection 30
Uunlocking flash memory 32
XXFlash tool, introduction 5