Table of Contents Previous topic Next topic

Projects and Workspaces->Build Settings->Linker->Standard Settings

To change the linker settings for your project, select Settings from the Build menu and select the Linker tab (Build->Settings->Linker).

The linker project settings tab allows you to modify project options that apply to the link phase of the project build process.

Output Format

Click on the down arrow in the output format drop down list to see the output formats available for the target family that you have selected. Select the one that is appropriate for your target system.

Note that only the IEEE695 format supports debug records.

If you have changed the target family in the general project settings tab this may affect the output formats available. If the previously specified format is no longer available, then the selection will automatically change to IEEE695.

Target Memory Configuration

The target memory configurations available will be slightly different for 8051 and non 8051 target families. Both sets of options are presented below:

Non 8051 target families:


Code and data in ram Check this option if your target system already has a program such as a monitor or debugger running on it and your intention is to download your program to run in the ram of that target system.

Min rom address Enter the lowest rom address on your system. This value is ignored if you have checked the code and data in ram option.

Max rom address Enter the highest rom address on your system. This value is ignored if you have checked the code and data in ram option.

Min ram address Enter the lowest ram address on your system.

Max ram address Enter the highest ram address on your system.

8051 target family:


Code and data in ram Check this option if your target system already has a program such as a monitor or debugger running on it and your intention is to download your program to run in the ram of that target system.

Min code address Enter the lowest program address on your system (usually zero). This value is ignored if you have checked the code and data in ram option.

Max code address Enter the highest program address on your system. This value is ignored if you have checked the code and data in ram option.

Min xdata address Enter the lowest external ram address on your system.

Max xdata address Enter the highest external ram address on your system.

Max idata address Enter the highest internal ram address on your system

If you elected to allow the Embedded Development Studio to create a startup file for you, this startup file will automatically be updated with any modifications that you make to the target memory configuration. See the Startup Files in the Embedded Development Studio for more information on how the Embedded Development Studio maintains your startup files.

Suppress Startup Banner and Message Display

Check this option if you wish to suppress the sign-on message displayed by the linker and also suppress the display of the list of object files and options passed to the linker.

Output Debug Records

Check this option if you want the linker to output debug records to your program file. This option is only effective it your program file is in IEEE695 format and if at least some of the object files being linked contain debug records.

Produce Map File

Check this option if you want the linker to create a map file showing the addresses allocated to your variables and segments.

Map File Sort Order


None Check this option if you do not want the variable list in the map file to be sorted.

Name Check this option if you want the variable list in the map file to be sorted alphabetically according to the names of the variables.

Address Check this option if you want the variable list in the map file to be sorted numerically according to the addresses of the variables.

Library Files

This field should be used to specify any libraries that you wish the linker to scan for unresolved references.

The linker will automatically include the default libraries required by the C compiler when it links your C code. You therefore only need to specify additional libraries in this field (if any).

Output File Name
Edit this field to change the name of the program file that will be generated by the build process.

Note that the file extension of the program file changes whenever you change the output format.

Code and data in ram	Check this option if your target system already has a program such as a monitor or debugger running on it and your intention is to download your program to run in the ram of that target system.
Min rom address	Enter the lowest rom address on your system. This value is ignored if you have checked the code and data in ram option.
Max rom address	Enter the highest rom address on your system. This value is ignored if you have checked the code and data in ram option.
Min ram address	Enter the lowest ram address on your system.
Max ram address	Enter the highest ram address on your system.

Code and data in ram	Check this option if your target system already has a program such as a monitor or debugger running on it and your intention is to download your program to run in the ram of that target system.
Min code address	Enter the lowest program address on your system (usually zero). This value is ignored if you have checked the code and data in ram option.
Max code address	Enter the highest program address on your system. This value is ignored if you have checked the code and data in ram option.
Min xdata address	Enter the lowest external ram address on your system.
Max xdata address	Enter the highest external ram address on your system.
Max idata address	Enter the highest internal ram address on your system

None	Check this option if you do not want the variable list in the map file to be sorted.
Name	Check this option if you want the variable list in the map file to be sorted alphabetically according to the names of the variables.
Address	Check this option if you want the variable list in the map file to be sorted numerically according to the addresses of the variables.