Everything
 

Download Files dialog box


This dialog box is used to select files for downloading and configure download conditions (see "2.6 Download/Upload Programs").

Note that files specified as build targets in a project (main project or sub-project) are automatically registered as download targets (they can be unregistered).

Caution

This dialog box cannot be opened during execution of a program.

Figure A.27

Download Files Dialog Box

 

This section describes the following.

[How to open]

-

On the [Download File Settings] tab of the Property panel, click the [...] button displayed by selecting the [Download files] property in the [Download] category.

[Description of each area]

(1)

[Download file list] area

(a)

List display

Displays a list of files to download. The names of files specified as build targets in a project (main project or sub-project) are displayed by default (they can be removed).

Files are downloaded in the order that they are displayed here.

To add a new file to be downloaded, click the [Add] button in this area, then in the [Download file property] area, specify the download conditions of the file to add.

(b)

Button

Button

Function

Up

Moves the selected file up one row in the list.

Clicking this for the top file in the list has no effect.

Down

Moves the selected file down one row in the list.

Clicking this for the bottom file in the list has no effect.

Add

Adds an empty item "-" to the list, and selects it.

Specify the download conditions of the file to add in the [Download file property] area.

Note that this button will be disabled if 20 files have already been registered.

Remove

Removes the selected file from the list.

Note, however, that this button is disabled if the selected file is a project build target.

Remark 1.

By hovering the mouse cursor over a file name, the pass information of the file is pop-up displayed.

Remark 2.

By dragging a file name with the mouse, the display order in the list can be changed.
Note, however, that the order of a project build target cannot be changed.

(2)

[Download file property] area

(a)

[Download file information]

This area is used to display or edit the download conditions of the file selected in the [Download file list] area.

It can also be used to specify the download conditions of new download files added via the [Add] button.

File

Specify the name of the file to download.

Default

File name (but it will be blank for newly added files)

Modifying

Directly enter from the keyboard, or specify with the Select Download File dialog box opened by clicking the [...] buttonNote 1 appears at right by selecting this item.

Available values

See "Table 2.4 Downloadable File Formats"

Up to 259 characters

File type

Select the type of the file to download.

Default

Load module file

Modifying

Select from the drop-down list.

Available values

Load module file

Specifies a load module file.

Hex file

Specifies an Intel HEX file.

S-record file

Specifies a Motorola S-record file.

Binary data file

Specifies an binary file.

Compiler Vendor

Specify the vendor of the compiler that was used to create a load module file.

This property setting is used to handle the information that was output in the load module file and is specific to the compiler's vendor.

Default

Auto

Modifying

Select from the drop-down list.

Available values

Auto

Specify when having the compiler determined automatically.

Green Hills Software

Specify when using a GHS compiler.

Offset

Specify the offset from the address at which the file's download is to start.

Note that this item appears only when [File type] is set to [Hex file] or [S record file].

Default

0

Modifying

Directly enter from the keyboard.

Available values

0x0 to 0xFFFFFFFF in hexadecimal number

Start address

Specify the address at which to start the file's download.

Note that this item appears only when [File type] is set to [Binary file].

Default

0

Modifying

Directly enter from the keyboard.

Available values

0x0 to 0xFFFFFFFF in hexadecimal number

Download object

Select whether to download the object information from the specified file.

Note that this item appears only when [File type] is set to [Load module file].

Default

Yes

Modifying

Select from the drop-down list.

Available values

Yes

Downloads object information.

No

Does not download object information.

Download symbol information

Select whether to download the symbol information from the specified fileNote 2.

Note that this item appears only when [File type] is set to [Load module file].

Default

Yes

Modifying

Select from the drop-down list.

Available values

Yes

Downloads symbol information.

No

Does not download symbol information.

Specify the PIC/PIRDD/PID offset

Specify whether to change the positions of PIC (Position Independent Code), PIRDD (Position Independent Read Only Data) and PID (Position Independent Data) areas of the load modules to download from those specified during the creation of load modules. When "Yes" is selected, "PIC Offset", "PIROD Offset" and "PID Offset" will appear as sub-items.

Default

No

How to change

Select from the drop-down list.

Specifiable value

Yes

PIC/PIROD/PID offset is specifiedNote 3.

No

PIC/PIROD/PID offset is not specified.

PIC Offset

Input the offset values from the start address of the program section specified at the time of load module creation.

For example, if 1000 is specified for this item when a load module for which the program section starts at address 1000 is to be downloaded, the section will be downloaded to address 2000.

Default

0

How to change

Enter directly from the keyboard.

Specifiable value

Hex number between 0x0 and 0xFFFFFFFF

PIROD Offset

Input the offset values from the start address of the ROM data section specified at the time of load module creation.

For example, if 1000 is specified for this item when a load module for which the ROM data section starts at address 1000 is to be downloaded, the section will be downloaded to address 2000.

Default

0

How to change

Enter directly from the keyboard.

Specifiable value

Hex number between 0x0 and 0xFFFFFFFF

PID Offset

Input the offset values from the start address of the RAM data section specified at the time of load module creation.

For example, if 1000 is specified for this item when a load module for which the RAM data section starts at address 1000 is to be downloaded, the section will be downloaded to address 2000.

Default

0

How to change

Enter directly from the keyboard.

Specifiable value

Hex number between 0x0 and 0xFFFFFFFF

Generate the information for input completion

Select whether to generate the information for the Symbol name completion function when downloadingNote 4.

Note that this item appears only when [File type] is set to [Load module file].

Default

Yes

Modifying

Select from the drop-down list.

Available values

Yes

Generates the information for the symbol name completion function. (i.e. uses the symbol name completion function.)

No

Does not generate the information for the symbol name completion function. (i.e. does not use the symbol name completion function.)

Note 1.

When a file specified as build target in the project is selected in the [Download file list] area, or when the program is executing, the [...] button does not appear.

Note 2.

If the symbol information have not been downloaded, the source level debugging cannot be performed.

Note 3.

Proper debug operation is not guaranteed when you have selected "Yes" for load modules that were created without using PIC/PID function (see Section "2.8 Usage of PIC/PID Function").

Note 4.

When [Yes] is selected, the time taken for downloading and the memory usage on the host machine will increase. We recommend selecting [No] in this item if you do not intend to use the symbol name completion function.

[Function buttons]

Button

Function

OK

Finishes configuring the download files, and closes this dialog box.

Cancel

Cancels any changes to the download files, and closes this dialog box.

Help

Displays the help for this dialog box.