User manual

UM0036 Project creation and build
Doc ID 7705 Rev 11 109/385
Customizing Cosmic Assembler language settings
The assembler language settings allow you to set options related to language checking
during assembly. To access these options, select Language from the Category list box. The
resulting view provides check boxes to enable or disable the options listed in Tabl e 39 .
Customizing Cosmic Assembler listing settings
The assembler Listing settings allow you to generate listing and error files. The listing
contains the source code that was input to the assembler, along with the hexadecimal
representation of the corresponding object code and the address for which it was generated.
To access these options select Listing from the Category list box. The resulting view
provides check boxes to enable or disable the options listed in Tabl e 4 0.
Table 38. Cosmic Assembler debug options
Option
(1)
1. For complete descriptions of assembler debug options, refer to the C Cross Compiler User’s Guide.
Description
Generate full (-xx)
Generate debug information
for any label defining code or data in
the object files, that will allow you to take full advantage of
STVD’s debugging features.
Generate line (-x)
Add only line debug information to the object file. This
information provides the debugger the link between a line of
source code and the beginning and end address of an instruction
in the compiled application.
Add on local variable (-pl)
Add local symbols to the debug symbol table. These are only
displayed in the linker map file.
Add on any label
(-c)
Lines that are changed or removed are kept in the assembly
source as comments.
Use relative path for debug info
(-xp)
Filenames in the debug information are not prefixed with an
absolute path name. The debugger must be informed about the
actual file location (see Section 4.5.2: Debug settings tab on
page 86)
Table 39. Cosmic Assembler language options
Option
(1)
1. For complete descriptions of assembler language settings, refer to the C Cross Compiler User’s Guide.
Description
Map all sections as
Absolute (-a)
Map all sections, including predefined sections to absolute.
Mark all symbols as
Public (-p)
Mark all symbols as public. This option has the same effect as adding
an xdef directive for all symbols.
Mark all “equ” defined
Symbols as Public (-pe)
Mark all symbols defined with an equ directive as public. This option
has the same effect as adding an xdef directive for those symbols.