Intel x flash technology

Embed Size (px)

Citation preview

  • 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