Download Files dialog box


This dialog box selects a file to download and sets download conditions (see Section "2.5 Download and Upload").

The files specified in the project (main project or sub-project) as the subject to build are automatically registered as the subject files to be downloaded (not removable).

Figure A.43

Download Files Dialog Box

 

This section describes the following.

[How to open]

-

Select the [Download files] property in the [Download] category on the [Download File Settings] tab of the Property panel and then click the [...] button that is displayed.

Caution

This dialog box cannot be opened during program execution.

[Description of each area]

(1)

[Download file list] area

(a)

Displaying a list

This area displays a list of file names to download. By default, the file names specified in the project (main project or sub-project) as the subject to build are displayed (not removable).

Files are downloaded in the order in which they are listed here.

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

(b)

Buttons

Button

Function

Up

Moves a selected file one line up.

However, this button is disabled when the file at the top of the list or a file specified as the subject to build in the project is selected.

Down

Moves a selected file one line down.

However, this button is disabled when the file at the bottom of the list or a file specified as the subject to build in the project is selected.

Add

Adds one blank item ("-") to the list, with the item selected.

In the [Download file property] area, specify the download conditions for the file to be added.

However, this button is disabled when 20 or more files are already registered.

Remove

Removes a selected file from the list.

However, the files specified as the subject to build in the project cannot be removed.

Remark 1.

Place the mouse cursor at a file name, and the path information for the subject file is displayed in a popup box.

Remark 2.

The order in which files are listed can be changed by dragging any file name up or down in the list with the mouse. However, the files specified as the subject to build in the project cannot have their order in the list changed.

(2)

[Download file property] area

(a)

[Download file information]

This section displays download conditions or changes of settings made for a file selected in the [Download file list] area.

Also, if a new download file is added using the [Add] button, this section may be used to specify download conditions for the file added.

File

Specify a file to download

Default

File name (However, blank when newly added)

How to change

Enter directly from the keyboard, or specify in the Select Download File dialog box that is opened by clicking the [...] buttonNote 1 that is displayed at the right edge of the column when this item is selected.

Specifiable value

See "Table 2.2 Downloadable File Formats".

Specifiable in up to 259 characters

File type

Specify the file format of a file to download.

Default

Load module file

How to change

Select from the drop-down list.

Specifiable value

One of the following:

-

Load module file

-

Hex file

-

S record file

-

Binary data file

Offset

This item is displayed only when the files to download are in hex format or S record files.

Specify an offset value from the address at which download of a specified file begins.

Default

0

How to change

Enter directly from the keyboard.

Specifiable value

Hexadecimal values from 0x0 to 0xFFFFFFFF

Start address

This item is displayed only when the files to download are in binary data format.

Specify the start address from which a specified file is downloaded.

Default

0

How to change

Enter directly from the keyboard.

Specifiable value

Hexadecimal values from 0x0 to 0xFFFFFFFF

Download object

This item is displayed only when the files to download are in load module format.

Specify whether or not to download object information from a specified file.

Default

Yes

How to change

Select from the drop-down list.

Specifiable value

Yes

Object information is downloaded.

No

Object information is not downloaded.

Download symbol information

This item is displayed only when the files to download are in load module format.

Specify whether or not to download symbol information from a specified fileNote 2.

Default

Yes

How to change

Select from the drop-down list.

Specifiable value

Yes

Downloads symbol information.

No

Does not download symbol information.

Specify the PIC/PID offset

Specify whether to change the positions of PIC (Position Independent Code) 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" and "PID Offset" will appear as sub-items.

Default

No

How to change

Select from the drop-down list.

Specifiable value

Yes

PIC/PID offset is specifiedNote 3.

No

PIC/PID offset is not specified.

PIC Offset

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

For instance, if you enter "1000" here when the start address of the program section is 0x1000, the corresponding section will be downloaded to 0x2000.

Default

0

How to change

Enter directly from the keyboard.

Specifiable value

Hex number between 0x0 and 0xFFFFFFFF

PID Offset

Input the offset values to the PID register specified at the time of load module creation.

For instance, if you want to set 0x200 to the PID register when executing the load module, enter "200" here.

Default

0

How to change

Enter directly from the keyboard.

Specifiable value

Hex number between 0x0 and 0xFFFFFFFF

Generate the information for input completion

This item is displayed only when the files to be downloaded are in the load-module format.

Specify whether or not to generate information for use by the auto-complete feature while symbol information is being downloaded from a specified file.

If you use the symbol name completion function in "Watch panel", "Memory panel", select is "Yes".

Download time is long in order to generate this information during the download.

Default

Yes

How to change

Select from the drop-down list.

Specifiable value

Yes

Generate information for use by the auto-complete feature

No

Does not generate information for use by the auto-complete feature

Note 1.

If any file as the subject to build in the project is selected in the [Download file list] area, or while the program is under execution, the [...] button is not displayed.

Note 2.

Unless symbol information is downloaded, source-level debugs 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.7 Usage of PIC/PID Function").

[Function buttons]

Button

Function

OK

Terminates download file settings and closes this dialog box.

Cancel

Nullifies download file changes made and closes this dialog box.

Help

Displays help for this dialog box.