Using the fromelf Image Converter

--widthxbanks

ARM Compiler toolchain v5.02 for µVision Using the fromelf Image Converter

Home > fromelf command reference > --widthxbanks

`--widthxbanks`

This option outputs multiple files for multiple memory banks.

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

Restrictions

You must use --output with this option.

Syntax

--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

Usage

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
...
```

Using the fromelf Image Converter

--widthxbanks

`--widthxbanks`

Restrictions

Syntax

Usage

See also

Products

Development Tools

Hardware & Collateral

Downloads

Support

Buy

Important information