Usage

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

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 --cpu=8-A.32 --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 --cpu=8-A.32 --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 --cpu=8-A.32 --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
  …

Restrictions

You must use --output with this option.