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 panels [Download File Settings] tab).