User manual

UM0036 Project creation and build
Doc ID 7705 Rev 11 113/385
<BEGIN OBJECT_FILES>, <END OBJECT_FILES>
<BEGIN LIBRARY_FILES>, <END LIBRARY_FILES>
<BEGIN VECTOR_FILE>, <END VECTOR_FILE>
<BEGIN DEFINED_VARIABLES>, <END DEFINED_VARIABLES>
If you want to stop STVD automatic update for one section, simply remove both BEGIN/END
markers of this section.You may restore the mechanism later by restoring the markers.
In Automatic mode, a configurable mapping is displayed in the Linker tab. The mapping's
first level elements are segments in the target microcontroller's memory. Clicking on the "+"
sign for a segment allows you to see the code sections that are assigned to the segment.
This mapping is used to automatically generate a linker script file (default name
Targe tS Name.lkf) that contains the declarations of memory segments and the code sections
assigned for each.
The linker script file is regenerated automatically when you close the Project Settings
window, or execute a build command. In Automatic mode, any modification that you made
externally into the linker file are lost. In Semi-automatic mode, any modification that you
made inside STVD-reserved sections are lost.
If you want to customize the linker file but keep some automatic mechanisms (for instance,
define a customized segment while keeping the automatic update of object files list when
adding or removing files into the project), use the Semi-automatic mode.
Modify the segment mapping and section assignments
You can move code sections from any memory segment except the Zero Page Vars to any
other code segment by simply dragging and dropping them.
You can add memory segments and delete or rename the segments that you have created.
Default segments cannot be deleted or renamed. However, you can modify their start and
end addresses.
Right-clicking on a cell 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, but click on
enter, the new segment is removed from the mapping. You cannot use the same
segment name twice. Naming is case sensitive.
● Add Section - Adds a new code section to the mapping. If you do not enter a section
name, but click on enter, the new section is removed from the mapping. You cannot use
the same section name twice. Naming is case sensitive. The interface only allows you
to enter the name of the section (not an address range for it). Upon link, the code
sections are assigned to the memory segment in the order in which they appear in the
mapping.
● 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. You cannot use the same section or segment name twice in the mapping. You
can change the names of the default memory segments, however you cannot change
the names of the default code sections.
● Delete - Deletes the selected entry. You cannot delete the default memory segments or
code sections.