Download Files dialog, Options page
Determines when an automatic download should be performed. The options are:
•Never - No automatic download is performed.
•After link - Download is performed when link process completes.
•Prompt when changed - User is prompted to confirm download when a change to the download files is detected.
•When changed - Download is performed when a change to the download files is detected..
An action to be performed before download can be selected here.
•Nothing - Do nothing. Note that the emulation must already be started (typically through Debug/CPU Reset command).
•Regular initialization – Initializes the CPU as defined in the Hardware/Emulation Options/Initialization menu (default).
Download in Hot Attach configuration
Optionally winIDEA can, upon Debug/Download command, disable Hot Attach and perform regular download.
•Initialize debugger, load symbols - initialize debugger hardware and loads symbols. (This is the default setting).
•Initialize, attach to CPU, download code - performs regular download, bypassing hot attach configuration.
After download the Hot Attach capabilities are restored.
Memory region Actions
The configured items are displayed with a 3 letter prefix indicating the operation:
•x – the region is excluded from download
•_ - regular/no exclusion
•v – the region is skipped in verify
•_ - regular verify
•c – the region is copied to another location
•m – the region is moved to another location
•_ - no mirroring
Multiple memory ranges can be defined. New areas can be specified by pressing the 'New area' button.
The configured areas can be edited by double-clicking on the area. An area can be removed by pressing the 'Remove area' button.
Beside download exclusions, further memory actions on loaded code can be performed before it is moved into target.
•Exclude for download – the specified region is not loaded to target
•Ignore in Verify operation – the region is not verified
•Mirror – the region is either copied (duplicated) or moved to another address.
After the primary download a secondary download can be performed. This is usually used to load program code to target memory that is accessible after the debugged CPU has been released from reset.
•None - No target download is performed (default)
•Download files - Target download is performed with the original set of download files
•Target download files - Target download is performed with the set of download files specified in the Target Download page.
An action can be performed after the download completes.
When checked, the downloaded code is verified after download finishes.
Download verification can be performed in two ways:
•against Loaded code - downloaded code is verified against the code which winIDEA loaded into the target .
•against File content - downloaded code is verified against against code in the download files.
The later is useful when the program code is loaded using different means, but synchronization with the symbols in the download file must be checked.
When checked two options are available:
•Go to program entry point - Presets the program execution point to the program entry point (if one is specified in the download file). This option is usually used along with Before download/Reset for… option.
•Go to… - Presets the execution point to the specified address (any function can be selected with the button).
Note: Use caution when using Go to... This can cause the CPUor application startup to be skipped.
Goto Address MMU Verification
If Debug/Goto address… operation is performed explicitly or implicitly (as a part of Download process), winIDEA verifies that a matching TLB entry is configured in the MMU. If no such entry exists, operation fails. User is instructed to ensure correct MMU configuration.
When checked two options are available:
•Run until… - The CPU is set to running until it reaches the specified position (typically the 'main' function, but any function can be selected with the button).
•Run - The CPU is set to running.
Perform this action also after Debug/CPU Reset
If this option is selected, the action defined in the ‘After download’ option is also performed when a debug or CPU reset occurs.
Show load map when download errors occur
When checked, a load map error will be reported, if code is loaded outside debugger range or code overlaps.
Save Download Report
winIDEA can generate an XML formatted load report after download.
The report can include:
•Regions where code from different download files overlaps
•Regions where verify errors occurred.
Every region reports:
•Last address in the region
•Size of the region