User manual

UM0036 Project creation and build
Doc ID 7705 Rev 11 111/385
General settings for Cosmic linker
With the category set to General, you can access the following standard options:
Output filename option
Allows you to specify the name for the output file. By default, this field contains a macro that
will specify the project source in .elf format.
Std. libraries
Select whether to use the Int or Float libraries by checking the appropriate box. If Int is
checked, the builder inserts the standard integer library in the .lkf template.
Note: There are several standard integer libraries depending on the memory model you have
chosen.
Object/Library modules
In this field, you can type the names for specific library or object modules to include in the
build.
Library path names
This field allows you to enter additional libraries to be included by the linker.
You can type the library path name or use the browse button to enter the libraries to include.
When entering more than one library, entries are separated by a semicolon (;). When you
add a library via this field, the -l option followed by the library path name are added to the
command line.
Run the converter
The converter (chex utility) allows you to translate executable files produced by the linker
into either the Motorola S-record or Intel standard hexadecimal format, and output to a
specific location.
When you click to place a checkmark in the Run Converter checkbox, a command line with
the Write output to file option (-o) is added to the Commands field in the Post-build tab.
A pop-up window opens whenever you activate this option, to tell you that the command line
is being added or removed to the Post- build tab.
You can customize the command line with options that allow you to override text and data
biases or output only a portion of the executable. For more about the supported options
refer to C Cross Compiler User’s Guide.
Startup file
The startup file establishes the runtime environment for C. Typically it provides:
● Initialization of the .bss section
● ROM to RAM copy
● Initialization of the stack pointer
● Call-up of the program entry point
● An exit sequence