2.5.2.3
Downloading multiple load module files
To download multiple load module files, follow the procedure described below as you fill in the Download Files dialog box.
Caution | When debugging a program comprised of multiple load module files, be careful that location addresses will not overlap. |
Remark | When multiple load module files are downloaded, the load module names are displayed as the detailed information on the Events panel. |
(1) | Clicking the [Add] button |
When you click the [Add] button, a blank item ("-") is displayed on the last line in the [Download file list] area.
(2) | Setting the properties of a download file to add |
In the [Download file property] area, select a download file you want to add and set its download conditions.
For each displayed item, make the following setting.
When setting is completed, the file name you've specified here is reflected in the blank item in the [Download file list] area.
|
File
|
Specify a file in load module format to add (specifiable in up to 259 characters).
|
|
Default
|
Blank
|
|
Method to change
|
By entering directly from the keyboard, or specifying in the Select Download File dialog box that is opened by clicking the [...] button displayed at the right edge of this property when it is selected
|
|
Specifiable values
|
See "Table 2.2 Downloadable File Formats"
|
|
File type
|
Specify the file type of a download file to add.
Here, select [Load module file].
|
|
Default
|
Load module file
|
|
Download object
|
Specify whether or not to download object information from a specified file.
|
|
Default
|
Yes
|
|
Method to change
|
By selecting from drop-down list
|
|
Specifiable values
|
Yes
|
Downloads object information.
|
|
No
|
Does not download object information.
|
|
Download symbol information
|
Specify whether or not to download symbol information from a specified fileNote 1.
|
|
Default
|
Yes
|
|
Method to change
|
By selecting from drop-down list
|
|
Specifiable values
|
Yes
|
Downloads symbol information.
|
|
No
|
Does not download symbol information.
|
|
Specify the PIC/PID offset
|
Specify whether or not to change the positions of PIC (Position Independent Code) and PID (Position Independent Data) areas of the load module to be downloaded from those at which they were when the load module was created. When this item is changed to [Yes], "PIC Offset" and "PID Offset" are displayed in the sub-item.
|
|
Default
|
No
|
|
Method to change
|
By selecting from drop-down list
|
|
Specifiable values
|
Yes
|
Specifies PIC/PID offsetNote 2.
|
|
No
|
Does not specify PIC/PID offset.
|
|
PIC Offset
|
Enter an offset value from an address that was in the load module when it was created.
For example, if the program section's start address begins with the address 0x1000, enter "1000" for this item. The subject section is downloaded to the address 0x2000.
|
|
Default
|
0
|
|
Method to change
|
By entering directly from the keyboard
|
|
Specifiable values
|
Hexadecimal number in the range 0x0 to 0xFFFFFFFF
|
|
PID Offset
|
Enter an offset value to be set in the PID register that was specified in the load module when it was created.
For example, to set 0x200 in the PID register when the load module is executed, enter "200" for this item.
|
|
Default
|
0
|
|
Method to change
|
By entering directly from the keyboard
|
|
Specifiable values
|
Hexadecimal number in the range 0x0 to 0xFFFFFFFF
|
Note 1. | Unless symbol information is downloaded, source-level debugging cannot be performed. |
Note 2. | If you select [Yes] for load modules created not using the PIC/PID functions (see Section “2.7 Usage of PIC/PID Function“), debug operation cannot be guaranteed. |
Remark | For the load module files that do not require symbol information, you can set [No] for the [Download symbol information] item to reduce the amount of memory used (However, this file cannot be debugged at the source level.). |
(3) | Confirming the order in which a download is executed |
A download is executed in the order in which files are displayed in the [Download file list] area.
To change the order, use the [Up] or [Down] button to move any file up or down in the list.
(4) | Clicking the [OK] button |
Settings you've made in this dialog box are enabled, with the specified load module file added as a download file. (The added file is displayed in the [Download] category on the Property panel’s [Download File Settings] tab).