--widthxbanks

This option outputs multiple files for multiple memory banks.

fromelf uses the last specified configuration if more than one configuration is specified.

Show/hideRestrictions

You must use --output with this option.

Show/hideSyntax

--widthxbanks

Where:

banks

specifies the number of memory banks in the target memory system. It determines the number of output files that are generated for each load region.

width

is the width of memory in the target memory system (8-bit, 16-bit, 32-bit, or 64-bit).

Valid configurations are:

--8x1
--8x2
--8x4
--16x1
--16x2
--32x1
--32x2
--64x1

Show/hideUsage

If the image has one load region, fromelf generates the same number of files as the number of banks specified. The filenames are derived from the --output=destination argument, using the following naming conventions:

  • If there is one memory bank (banks = 1) the output file is named destination.

  • If there are multiple memory banks (banks > 1), fromelf generates banks number of files named destinationN where N is in the range 0 to banks - 1. If you specify a file extension for the output filename, then the number N is placed before the file extension. For example:

    fromelf --vhx --8x2 test.axf --output=test.txt
    

    This generates two files named test0.txt and test1.txt.

If the image has multiple load regions, fromelf creates a directory named destination and generates banks files for each load region in that directory. The files for each load region are named load_regionN where load_region is the name of the load region, and N is in the range 0 to banks - 1. For example:

fromelf --vhx --8x2 multiload.axf --output=regions/

This might produce the following files in the regions directory:

EXEC_ROM0
EXEC_ROM1
RAM0
RAM1

The memory width specified by width controls the amount of memory that is stored in a single line of each output file. The size of each output file is the size of memory to be read divided by the number of files created. For example:

  • fromelf --vhx --8x4 test.axf --output=file produces four files (file0, file1, file2, and file3). Each file contains lines of single bytes, for example:

    00
    00
    2D
    00
    2C
    8F
    ...
    
  • fromelf --vhx --16x2 test.axf --output=file produces two files (file0 and file1). Each file contains lines of two bytes, for example:

    0000
    002D
    002C
    ...
    

Show/hideSee also

Copyright © 2010-2011 ARM. All rights reserved.ARM DUI 0477E
Non-ConfidentialID071611