User manual

UM0036 Project creation and build
Doc ID 7705 Rev 11 135/385
Message Display
With the Category list box set to General, you can choose what types of messages to
generate from the following options:
● Errors + Warnings: Introduces -W1 option in the command line, which suppresses the
generation of information messages.
● Only Errors: Introduces -W2 option in the command line, which suppresses the
generation of error and warning messages.
● Errors + Warnings + Info: No option in the command line. Information, error and
warning messages are generated.
Optimizations
The Optimization settings allow you to optimize your code once you have finished
debugging your application, in order to make the final version more compact and faster. You
should not optimize your code when debugging because some optimizations will eliminate
or ignore the debug information required by STVD and your debug instrument.
When the Category list box is set to General, the standard optimization options are:
● Default (Minimize code size): Introduces -Os option in the command line, which
directs the Compiler to generate smaller code, even though it may be slower than other
possible solutions.
● Disabled (Debug): Introduces options in the command line that disable optimizations
that are not compatible with debugging.
● Maximize Execution Speed: Introduces -Ot option in the command line, which
directs the Compiler to generate fast code, even though the code may be longer than
other possible solutions.
● Customize: Allows you to choose the optimization options that you want (options are
summarized in Customizing Metrowerks compiler optimizations on page 137). For
complete descriptions of these options, refer to the STMicroelectronics ST7 Compiler
user manual from Metrowerks.
Debug info
The Debug Info settings allow you to choose to generate debug information for your
application based on use (for programming or debugging). By default, the Metrowerks C
compiler generates the debug information required to debug your application with STVD.
Including the debug information will make the application file larger, however debug
information is not included in the code that is loaded in the microcontroller’s memory. This
information is used by STVD’s debugger only.
When the Category list box is set to General, the standard debug information options are:
● Generates debug info: No option in the command line. This setting causes the
compiler to generate the debug information required by STVD
● No Debug info in Objects: Introduces -NoDebugInfo option in the command line,
which suppresses the generation of debug information in the object file(s).
● Strip Path Info from Objects: Introduces -NoPath option in the command line, which
suppresses the generation of path information in the object files
Listings
The Listing settings allow you to generate a listing file and log errors to a file.