User manual

UM0036 Project creation and build
Doc ID 7705 Rev 11 91/385
The source file with the segment declarations (default is mapping.asm) is regenerated each
time you build the application when the Auto feature is enabled. If you make changes to the
file and Auto is enabled, your modifications will be overwritten when STVD updates the file
based on the mapping in the Linker tab.
This file must always be assembled first as the segment names are used in the other source
files in your project. For this reason it is automatically placed at the top of the list of source
files in your project in the Workspace window.
You can change the name of the output file assembly source file by typing a new name in
the Mapping File Name field.
Modify the segment mapping
The segment mapping in the Linker tab can be entirely modified. The interface allows you to:
● Change any segment name and address range.
● Add your own segments and specify their address ranges
● Delete any segment
However, the interface does not allow you to delete segment if it is the last segment in the
mapping. At least one segment must always be declared.
Right-clicking on a segment in the mapping opens a contextual menu with the following
commands:
● Add Segment - Adds a row of empty fields to the mapping. Enter the name of the new
segment and press the Enter key. If you do not enter a segment name, and only press
enter, the new segment is removed from the mapping. You cannot use the same
segment name twice. Naming is case sensitive.
● Change - Allows you to change the value or entry in the selected cell of the mapping.
Address values can be entered in decimal or hexadecimal (use “0x______” notation)
formats.
● Delete - Deletes the selected entry. The last segment entry in the mapping cannot be
deleted.
Output filename
The Output filename field allows you to specify the name of the final output. By default, the
output file is project_name.s19.
Libraries
The Libraries field allows you to enter the path names for object libraries to include when
linking your application. These path names appear in the command line for the linker step.
To specify a library to include, type the library path name in the field. To add a second library
type a semicolon (;) followed by the second path name.
Format
In the Format list box you can specify the file format of the executable. When a format is
specified a code appears at the end of the OBSEND command line. In the Format list box,
you can choose from the options described in Table 30 .