upload

Save target memory to a file.

Syntax

[[px]] upload filename [addr to addr | addr length expr] [overwrite]

Where:

[px]	is the viewpoint override, including punctuation ( [] ), specifies that the viewpoint is temporarily set for this command to the specified processor. The processor can be specified as px (where x is the processor ID), or an alias you have defined for a given processor ID.
filename	specifies a filename.  See Filenames for details.
addr	specifies the address of the first byte.
to addr	specifies the ending address of a range of addresses. The addr after the "to" reserved word must be greater than the addr before the "to" reserved word.
length expr	specifies the number of bytes desired.
overwrite	specifies that filename is to be overwritten, if it exists.

Discussion

Use the upload command to transfer the contents of target memory to a host file. The contents can be saved as a binary file, or as an axf file.

Saving as an axf file has advantages when performing trace disassembly in the Trace View.  If the "Disassembly Uses" setting is set to "Use Cached Program", then when an axf file is loaded, SourcePoint will read memory from the file rather than the target.  This is useful when the area traced has been overlayed and is no longer present in the target.

If the file specified by filename already exists, upload does not overwrite the file nor prompt for an overwrite, but instead an error is reported. To overwrite an existing file, you must specify the overwrite option. The overwrite option causes the file to lose its original contents.

Example 1

To save the contents of 0x300 bytes of target memory starting at 1000p to a file named mypatch.bin, and then reload it at the same address:

Command input:

upload mypatch.bin 1000p length 0x300
load mypatch.bin at 1000p nopsp noinit

 

Example 2

To save 1 Mb of memory at address 0x80000000:

Command input:

upload range1.axf  0x80000000 length 0x100000

Related Topics:

load

reload