Restoring Build Properties
3. Select Project > Properties.
The Properties for <project> dialog box appears. The left side of this window has a
Properties list. This list shows the build properties that apply to the current project.
4. Expand the C/C++ Build property node.
5. Select Settings.
6. Use the Configuration drop-down list to specify the launch configuration for which you want to modify the build properties.
7. Click the Tool Settings tab. The corresponding page appears.
8. From the list of tools on the Tool Settings page, select the tool for which you want to modify properties.
9. Change the settings as per the requirements.
10. Click Apply.
The CodeWarrior IDE saves your new settings.
You can select other tool pages and modify their settings. When you finish, click OK to save your changes and close the Properties for <project> dialog box.
3.2 Restoring Build Properties
You can modify a build configuration of a project and restore it back in order to have a factory-default configuration, or to revert to a last-known working build configuration.
To undo your modifications to build properties, click the Restore Defaults button at the bottom of the Properties for<project> dialog box.
This changes the values of the options to the absolute default of the toolchain. By default, the toolchain options are blank.
3.3 Build Properties for StarCore
The Properties for <project> dialog box shows the corresponding build properties for a
StarCore project.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
48 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-1. Properties for <Project> Dialog Box
Table 3-1
lists the build tool settings specific to developing software for StarCore.
StarCore 3900 C/C++ Compiler
Table 3-1. Build Tool Settings for StarCore
Build Tool
StarCore Environment
StarCore 3900 Disassembler
StarCore 3900 C/C++ Linker Application
Build Properties Panels
Disassembler Settings
Linker Settings
C/C++ Options
Libraries
C/C++ Language
Control
Hardware Configuration
Output Listing
Warnings
Compiler Front End Messages
Assembler
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
49
Build Properties for StarCore
Table 3-1. Build Tool Settings for StarCore (continued)
StarCore 3900 Assembler
Build Tool
StarCore 3900 Preprocessor
Build Properties Panels
Linker
Include Search Paths
Macros
Processor
Optimization
Configuration Files
Additional Arguments
Code and Language Options
Include Search Paths
Preprocessor
Listing File
Listing Contents
Listing Format
Additional Arguments
Preprocessor Settings
The CodeWarrior build tools listed in
Table 3-1 share some properties panels, such as the
Include Search Paths. The properties that you specify in these panels apply to the selected build tool on the Tool Settings page of the Properties for <project> dialog box.
3.3.1 StarCore Environment
Use this panel to specify the StarCore architecture for the build and the memory model that the architecture uses.
The build tools (compiler, linker, and assembler) use the properties that you specify on this page.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
50 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-2. Tool Settings - StarCore Environment
Table 3-2
describes the various options available on the StarCore Environment panel.
Architecture
Memory Model
Table 3-2. Tool Settings - StarCore Environment Options
Option Description
Specify the StarCore architecture for which you build your project.
Specify the memory model for the build tools:
• Small Memory Model-absolute addresses fit in 64KB
• Big Memory Model-absolute addresses do not fit in
64KB, but fit in 1MB
• Big Memory Model w/ Far RT Lib Calls-Absolute addresses do not fit in 64KB, but fit in 1MB. The build tools make runtime-library calls in the same manner they do for the huge memory model.
• Huge Memory Model-absolute addresses do not fit in
1MB
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
51
Build Properties for StarCore
Table 3-2. Tool Settings - StarCore Environment Options (continued)
Force C++ Compilation
Floating Point
Option Description
Checked -Enforce C++ compilation for the files that do not have the .cpp extension. This setting is equivalent to specifying the -force c++ command-line option. Cleared -
C++ compilation is not enforced for the files that do not have the .cpp extension.
Specify floating point type for the project, Hardware or
Software. Both hardware floating point and software floating point are supported on B4420, B4860, SC3900fp, and their derivatives.
3.3.2 StarCore 3900 Disassembler
Use this panel to specify the command, options, and expert settings for the StarCore 3900 disassembler.
Figure 3-3. Tool Settings - StarCore 3900 Disassembler
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
52 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-3
describes the various options available on the StarCore 3900 Disassembler panel.
Command
All options
Table 3-3. Tool Settings - StarCore 3900 Disassembler Options
Expert Settings:
Command line pattern
Option Description
Shows the location of the disassembler executable file.
Shows the actual command line the disassembler will be called with.
Shows the expert settings command line parameters; default is "${SCToolsInstallDir}${COMMAND}" ${FLAGS} $
{INPUTS}.
3.3.2.1 Disassembler Settings
Use this panel to specify the Disassembler behavior.
Figure 3-4. Tool Settings - Disassembler Settings
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
53
Build Properties for StarCore
Table 3-4
describes the various options available on the Disassembler Settings panel.
Compact
Start Label
End Label
Start Address (Hex)
End Address (Hex)
Verbose
Table 3-4. Tool Settings - Disassembler Settings Options
Print loopstart - loopend
Suppress Banner
Ignore Relocation Information
Display Unmangled C++ Names
Suppress PC
Suppress Label and Header
Option
Display Mixed Hexadecimal and Assembly
Description
Specifies compact output mode.
Checked - The disassembler prints instructions in an execution -set on a single line.
Cleared - The disassembler does not print instructions in an execution -set on a single line.
Specifies the label at which disassembly of the input file starts.
Specifies the label at which disassembly of the input file ends.
Specifies the hexadecimal address at which the disassembly starts.
Specifies the hexadecimal address at which the disassembly ends.
Checked - The disassembler prints loopstart-loopend directives.
Cleared - The disassembler prints lpmarka/lpmarkb directives.
Checked - The disassembler suppresses display of banner information.
Cleared - The disassembler does not suppress banner display.
Checked - The disassembler ignores the relocation information relevant to .eln and .elb files.
Cleared - Disassembler does not ignore the relocation information.
Checked - The disassembler displays unmangled form of C+
+ names.
Cleared - The disassembler does not display unmangled form of C++ names.
Checked - The disassembler suppresses the PC display for
VLES.
Cleared - The disassembler does not supress the PC display for VLES.
Checked - The disassembler suppresses display of labels, headers, and global information ( equs, globals, and section information).
Cleared - The disassembler does not supress display of labels and header information.
Checked - The disassembler displays mixed hexadecimal codification and assembly code.
Cleared - The disassembler does not display mixed hexadecimal codification and assembly code.
Checked - Enables verbose mode.
Cleared - Does not enable verbose mode.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
54 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-4. Tool Settings - Disassembler Settings Options (continued)
Display Statistics
Option Description
Checked - The disassembler displays statistics after each section, which includes but not limited to: number of VLES with 0 - 4 DALU instructions, number of VLES with 0 - 2
AGU instructions, not-generated instructions.
Cleared - The disassembler does not display statistics after each section.
3.3.3 StarCore 3900 C/C++ Linker Application
Use this panel to specify the command, options, and expert settings for the build tool linker.
Figure 3-5. Tool Settings - StarCore 3900 C/C++ Linker Application
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
55
Build Properties for StarCore
Table 3-5
describes the various options available on the StarCore 3900 C/C++ Linker
Application panel.
Table 3-5. Tool Settings - StarCore 3900 C/C++ Linker Application Options
Command
All options
Expert Settings
Command line pattern
Option Description
Shows the location of the linker executable file.
Shows the actual command line the linker will be called with.
Shows the expert settings command line parameters; default is "${SCToolsInstallDir}${COMMAND}" ${FLAGS} $
{OUTPUT_FLAG} ${OUTPUT_PREFIX}${OUTPUT} $
{INPUTS}.
3.3.3.1 Linker Settings
Use this panel to specify the linker behavior.
For C and C++ source files, build tools optimize the output object code. The build tools do not optimize hand-coded assembly language.
Figure 3-6. Tool Settings - Linker Settings
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
56 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-6
describes the various options available on the Linker Settings panel.
Map File
Strip Dead Code
Linker Command File
Additional Options
Table 3-6. Tool Settings - Linker Settings Options
Option Description
Enter the path of the file to which the linker writes memorymap information. This filename must have a .map extension.
Checked - The linker removes both unreferenced source code and unreferenced data from your program. Enabling this option reduces your program's memory footprint.
Cleared - The linker preserves both unreferenced source code and unreferenced data in your program.
Enter the path of the linker-command file that the build tools use for processing your project. Alternatively, click the
Browse button, then use the resulting dialog box to specify the linker command file.
Enter additional linker command-line options. The IDE passes these options to the scc shell during the link phase. Note that the IDE passes command-line options to the scc shell exactly as you enter them in this text box.
3.3.3.2 C/C++ Options
Use this panel to specify linker behavior.
For C and C++ source files, the build tools optimize output object code. The build tools do not optimize hand-coded assembly language.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
57
Build Properties for StarCore
Figure 3-7. Tool Settings - C/C++ Options
Table 3-7
describes the various options available on the C/C++ Options panel.
Table 3-7. Tool Settings - C/C++ Options
Option
Use Re-entrant Runtime Libraries
Custom Start-Up File
Description
Checked - The linker uses the correct thread-safe libraries and start-up code for your target architecture. If checked, the
IDE passes -reentrant to the scc shell.
Cleared - The linker uses default libraries and startup code.
Enter the path to a custom start-up file that the linker uses instead of a default start-up file. Alternatively, click the Browse button, then use the resulting dialog box to specify the custom start-up file. Leave this text box blank to have the linker use a default start-up file.
3.3.3.3 Libraries
Use this panel to specify additional libraries that the StarCore C/C++ Linker should use.
You can specify multiple additional libraries and library search paths. Also, you can change the order in which the IDE uses or searches the libraries.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
58 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-8. Tool Settings - Libraries
Table 3-8
describes the various options available on the Libraries panel.
Table 3-8. Tool Settings - Libraries
Additional Libraries
Library Search Paths
Option Description
Lists paths to additional libraries that the StarCore C/C++ linker uses. The linker uses the libraries in the order shown in this list.
Lists paths that the StarCore C/C++ linker searches for libraries. The linker searches the paths in the order shown in this list.
Table 3-9
lists and describes the toolbar buttons that help work with the libraries.
Table 3-9. Tool Settings - Libraries Toolbar Buttons
Button Description
Add - Click to open the Add file path or the Add directory
path dialog box and create a file or directory path.
Delete - Click to delete the selected file or directory. To confirm deletion, click
Yes in the Confirm Delete dialog box.
Edit - Click to open the Edit file path or Edit directory path dialog box and update the selected file or directory.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
59
Build Properties for StarCore
Table 3-9. Tool Settings - Libraries Toolbar Buttons (continued)
Button Description
Move up - Click to move the selected file search path one position higher in the list.
Move down - Click to move the selected file search path one position lower in the list.
3.3.4 StarCore 3900 C/C++ Compiler
Use this panel to specify the command, options, and expert settings for the build tool compiler.
Figure 3-9. Tool Settings - StarCore 3900 C/C++ Compiler
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
60 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-10 describes the various options available on the StarCore 3900 C/C++
Compiler panel.
Command
All options
Table 3-10. Tool Settings - StarCore 3900 C/C++ Compiler Options
Expert Settings
Command line pattern
Option Description
Shows the location of the linker executable file.
Shows the actual command line the compiler will be called with.
Shows the expert settings command line parameters; default is "${SCToolsInstallDir}${COMMAND}" ${FLAGS} -o
${OUTPUT_PREFIX}${OUTPUT} -c ${INPUTS}.
3.3.4.1 C/C++ Language
Use this panel to direct the CodeWarrior C/C++ compiler to apply specific processing modes to your C/C++ language source code. The C/C++ compiler's default state is
ANSI/ISO mode with extensions.
The C/C++ compiler treats the settings of this panel as one collection. You can compile source files with just one collection at a time. To compile source files with multiple collections, you must compile the source code sequentially. After each compile iteration, you change the collection of settings that the C/C++ compiler uses.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
61
Build Properties for StarCore
Figure 3-10. Tool Settings - C/C++ Language
Table 3-11 describes the various options available on the C/C++ Language panel.
Strict ANSI mode
Type 'char' is signed
64-Bit Data Type Support
Table 3-11. Tool Settings - C/C++ Language Options
Option Description
Checked - The C/C++ compiler operates in strict ANSI mode.
In this mode, the compiler strictly applies the rules of the
ANSI/ISO specification to all input files. This setting is equivalent to specifying the - ansi command-line option.
The compiler issues a warning for each ANSI/ISO extension it finds.
Cleared - The C/C++ compiler does not operate in strict ANSI mode.
Checked - The C/C++ compiler treats all char data types as signed. This setting is the default.
Cleared - The C/C++ compiler treats all char data types as unsigned (as if you had declared them unsigned char).
This setting is equivalent to specifying the -usc command line option.
Checked - The C/C++ compiler supports 64-bit data types long long and double. A long long is a 64-bit integer. A double is a 64-bit double-precision floating-point value.
Cleared - The C/C++ compiler does not support data types long long and double.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
62 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
3.3.4.2 Control
Use this panel to control compiler and shell behavior. You can specify command-line options to pass to the compiler and whether to generate debugging information.
Figure 3-11. Tool Settings - Control
Table 3-12 describes the various options available on the Control panel.
Read Options from File
Table 3-12. Tool Settings - Control Options
Options Description
Enter the path to a file that contains compiler command-line options. Alternatively, click
Browse and use the resulting dialog box to specify the file. This setting is equivalent to specifying the -F file command-line option. The filename must use the .opt extension. The shell treats the options in this file as if you had passed them on the command line. Each
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
63
Build Properties for StarCore
Table 3-12. Tool Settings - Control Options (continued)
Options
Generate Debugging Information
Description
time you invoke the compiler, you can select a file with the set of options that suits your needs. Note that the IDE does not verify the validity of the options in the file.
Checked - The compiler produces symbolic information for debugging the build target.
Cleared - The compiler does not produce symbolic information.
3.3.4.3 Hardware Configuration
Use this panel to control how the compiler structures generated object code. You can specify whether to initialize variables from read-only memory (ROM).
Figure 3-12. Tool Settings - Hardware Configuration
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
64 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-13 describes the various options available on the Hardware Configuration panel.
Table 3-13. Tool Settings - Hardware Configuration Options
Option
Initialize Variables from ROM
Description
Checked - The compiler places the initialization data for your program's global variables in a separate section. This setting is equivalent to specifying the -mrom command-line option.
The IDE can manipulate the section at link time and at load time.
Cleared - The compiler bypasses placing the initialization data for your program's global variables in a separate section.
You can clear this checkbox as you develop your source code, because a separate loader program handles initializing your program's global variables. After you finish development, you can check this checkbox, then place into ROM the segment with the initialization data for your global variables.
3.3.4.4 Output Listing
Use this panel to control how the compiler formats the listing file, as well as error and warning messages.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
65
Build Properties for StarCore
Figure 3-13. Tool Settings - Output Listing
Table 3-14 describes the various options available on the Output Listing panel.
Verbosity
Table 3-14. Tool Settings - Output Listing Options
Option
Create File with Error Output
Description
Specify the amount of information that the compiler generates:
• Quiet - The IDE displays just error messages that the compiler emits. The IDE suppresses warning and informational messages. This setting is equivalent to specifying the -q command-line option.
•
Default - The IDE chooses whether to use Quiet or
Verbose.
•
Verbose - The IDE shows each command line that it passes to the shell, along with all progress, error, warning, and informational messages that the tools emit. This setting is equivalent to specifying the -v command-line option.
Checked - The IDE generates a file that contains error messages that the compiler outputs.
Cleared - The IDE does not generate a file that contains error messages.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
66 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-14. Tool Settings - Output Listing Options (continued)
Keep assembly (.sl) files
Option
Define Struct Fd Offsets as EQUs
Description
Checked - The compiler keeps the intermediate assemblylanguage source files ( .sl files) it creates, instead of deleting them. This setting is equivalent to specifying the -s command-line option. The compiler generates one .sl file for each C source file in the build target.
Cleared - The compiler discards the intermediate assemblylanguage source files it creates.
Checked - The compiler includes the offsets of C datastructure field definitions in each generated intermediate assembly-language source file. This setting is equivalent to specifying the - do command-line option.
Cleared - The compiler does not include the offsets of C datastructure field definitions in each generated intermediate assembly-language source file.
3.3.4.5 Warnings
Use this panel to control how the compiler reports the error and warning messages.
Figure 3-14. Tool Settings - Warnings
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
67
Build Properties for StarCore
Table 3-15 describes the various options available on the Warning panel.
Report All Warnings
Generate Wrapper Remarks
Generate Wrapper Warnings
Table 3-15. Tool Settings - Warning Options
Option Description
Specifies global remark/warning control. This setting is equivalent to specifying the -W command-line option.
Checked-The IDE generates a file that contains Wrapper remarks that the compiler outputs. Cleared-The IDE does not generate a file that contains Wrapper remarks.
Checked-The IDE generates a file that contains Wrapper warnings that the compiler outputs. Cleared-The IDE does not generate a file that contains Wrapper remarks.
3.3.4.5.1 Compiler Front End Messages
Use this panel to control how the compiler generates compiler-front-end warnings.
Figure 3-15. Tool Settings - Compiler Front End Messages
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
68 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-16 describes the various options available on the Compiler Front End
Messages panel.
Extra Commas
Invalid Pragmas
Table 3-16. Tool Settings - Compiler Front End Messages Options
Option
Report All Compiler Front End Warnings
Treat Warnings As Errors
Any Pointer-to-Integer Conversions
Lossy Pointer-to- Integer Conversions
Command-Line Driver/Parser Warnings
Display List of Active Warnings
Empty Declarations
Pedantic Error Checking
Incorrect Capitalization In #include "...."
Incorrect Capitalization In #include <....>
Hidden Virtual Functions
Description
Specifies global Compiler Front End warning control. This setting is equivalent to specifying the -Wmwfe or -Wnomwfe command-line options.
Activates or deactivates treatment of compiler-front-end warnings as errors.
Activates or deactivates generation of warnings about any pointer-to-integer conversions. This setting is equivalent to specifying the -Wmwfe-anyptrintconv or -Wnomwfeanyptrintconv command-line options.
Activates or deactivates generation of warnings about lossy pointer-to-integer conversions.
Activates or deactivates generation of command-line driver/ parser warnings. This setting is equivalent to specifying the -
Wmwfe-cmdline or -Wnomwfe-cmdline command-line options.
Activates or deactivates generation of warnings about extra commas. This setting is equivalent to specifying the -Wmwfecomma or -Wnomwfe-comma command-line options.
Activates or deactivates display of archive warnings list. This setting is equivalent to specifying the -Wmwfe-display or -
Wnomwfe-display command-line options.
Activates or deactivates generation of warnings about empty declarations. This setting is equivalent to specifying the -
Wmwfe-emptydecl or -Wnomwfe-emptydecl commandline options.
Activates or deactivates pedantic error checking. This setting is equivalent to specifying the -Wmwfe-pedantic or -
Wnomwfe-pedantic command-line options.
Activates or deactivates generation of warnings about incorrect capitalization in #include "...". This setting is equivalent to specifying the -Wmwfe-filecaps or -
Wnomwfe-filecaps command-line options.
Activates or deactivates generation of warnings about incorrect capitalization in #include <...>. This setting is equivalent to specifying the -Wmwfe-sysfilecaps or -
Wnomwfe-sysfilecaps command-line options.
Activates or deactivates generation of warnings about hidden virtual functions. This setting is equivalent to specifying the -
Wmwfe-hidenvirtual or -Wnomwfe-hidevirtual command-line options.
Activates or deactivates generation of warnings about invalid pragmas. This setting is equivalent to specifying the -Wmwfeillpragmas or -Wnomwfe-illpragmas command-line options.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
69
Build Properties for StarCore
Table 3-16. Tool Settings - Compiler Front End Messages Options (continued)
Implicit Integer-to-Floating-Point or Floating-Point-to-Integer
Conversions
Option
Implicit Floating-Point-to-Integer Conversions
Implicit Integer-to-Floating-Point Conversions
Implicit Signed/Unsigned Conversions
Passing Large Arguments to Unprototyped Functions
Returning Without Values in Non-Void-Returning Function
`inline' Functions Not Inlined
Result of Non-Void-Returning Function Not Being Used
Padding Added Between Struct Members
Possible Unwanted Side Effects
Inconsistent Use of Class and Struct
Tokens Not Formed By The ## Operator
Description
Activates or deactivates generation of warnings about implicit integer-to-floating-point or floating-point-to-integer conversions. This setting is equivalent to specifying the -
Wmwfe-implicitconv(or -Wmwfe-implicit) or -
Wnomwfe-implicitconv(or -Wnomwfe-implicit) command-line options.
Activates or deactivates generation of warnings about implicit floating-point-to-integer conversions. This setting is equivalent to specifying the -Wmwfe-float2int or -Wnomwfefloat2int command-line options.
Activates or deactivates generation of warnings about implicit integer-to-floating-point conversions. This setting is equivalent to specifying the -Wmwfe-int2float or -Wnomwfeint2float command-line options.
Activates or deactivates generation of warnings about implicit signed/unsigned conversions. This setting is equivalent to specifying the -Wmwfe-impl_signedunsigned or -
Wnomwfe-impl_signedunsigned command-line options.
Activates or deactivates generation of warnings about passing large arguments to unprototyped functions. This setting is equivalent to specifying the -Wmwfe-largeargs or -
Wnomwfe-largeargs command-line options.
Activates or deactivates generation of warnings about returns without values in non-void-returning functions. This setting is equivalent to specifying the -Wmwfe-missingreturn or -
Wnomwfe-missingreturn command-line options.
Activates or deactivates generation of warnings about `inline' functions not inlined. This setting is equivalent to specifying the -Wmwfe-notinlined or -Wnomwfe-notinlined command-line options.
Activates or deactivates generation of warnings about result of non-void-returning function not being used. This setting is equivalent to specifying the -Wmwfe-notused or -
Wnomwfe-notused command-line options.
Activates or deactivates generation of warnings about padding added between struct members. This setting is equivalent to specifying the -Wmwfe-padding or -
Wnomwfe-padding command-line options.
Activates or deactivates generation of warnings about padding added between struct members. This setting is equivalent to specifying the -Wmwfe-padding or -
Wnomwfe-padding command-line options.
Activates or deactivates generation of warnings about inconsistent use of class and struct. This setting is equivalent to specifying the -Wmwfe-structclass or -Wnomwfestructclass command-line options.
Activates or deactivates generation of warnings about tokens not formed by the ## operator. This setting is equivalent to specifying the -Wmwfe-tokenpasting or -Wnomwfetokenpasting command-line options.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
70 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-16. Tool Settings - Compiler Front End Messages Options (continued)
Option
Undefined Macros In #if/#else Conditionals
Unused Variables
Unused Arguments
Using Expressions As Statements Without Side Effects
Overriding Function Has No `virtual' Keyword
Variables Uninitialized Before Used
Hidden Local Variables
Missing Enum Case Labels
Description
Activates or deactivates generation of warnings about undefined macros in #if/#else conditionals. This setting is equivalent to specifying the -Wmwfe--undefmacro (or -
Wmwfe-undef) or -Wnomwfe-undefmacro (or -
Wnomwfe-undef) command-line options.
Activates or deactivates generation of warnings about unused variables. This setting is equivalent to specifying the -Wmwfeunusedvar or -Wnomwfe-unusedvar command-line options.
Activates or deactivates generation of warnings about unused arguments. This setting is equivalent to specifying the -
Wmwfe-unusedarg or -Wnomwfe-unusedarg commandline options.
Activates or deactivates generation of warnings about using expressions as statements without side effects. This setting is equivalent to specifying the -Wmwfe-unusedexpr or -
Wnomwfe-unusedexpr command-line options.
Activates or deactivates generation of warnings about overriding function that has no `virtual' keyword.
Activates or deactivates generation of warnings about variables uninitialized before used. This setting is equivalent to specifying the -Wmwfe-unused or -Wnomwfe-unused command-line options.
Activates or deactivates generation of warnings about hidden local variables. This setting is equivalent to specifying the -
Wmwfe-hidden or -Wnomwfe-hidden command-line options.
Activates or deactivates generation of warnings about missing
Enum case labels.
3.3.4.5.2 Assembler
Use this panel to control how the compiler generates FALIGN, assembler remarks and warnings.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
71
Build Properties for StarCore
Figure 3-16. Tool Settings - Assembler
Table 3-17 describes the various options available on the Assembler panel.
All Assembler warnings
FALIGN Remarks
Assembler Remarks
Assembler Warnings
Table 3-17. Tool Settings - Assembler Options
Option Description
Specifies global Assembler warning control. This setting is equivalent to specifying the -Wasm or -Wnoasm commandline options.
Activates or deactivates generation of FALIGN remarks. This setting is equivalent to specifying the -Wasm-falign or -
Wnoasm-falign command-line options.
Activates or deactivates generation of assembler remarks.
This setting is equivalent to specifying the -Wasm-remarks or -Wnoasm-remarks command-line options.
Activates or deactivates generation of assembler warnings.
This setting is equivalent to specifying the -Wasm-warnings or -Wnoasm-warnings command-line options.
3.3.4.5.3 Linker
Use this panel to control how the compiler generates all linker warnings.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
72 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-17. Tool Settings - Linker
Table 3-18 describes the various options available on the Linker panel.
All Linker Warnings
Table 3-18. Tool Settings - Linker Options
Option
SHT_NOBITS (.bss) Section Precedes SHT_PROGBITS
(data/text) Sections
Recursive Function Calls Make Stack-Effect Computation An
Estimate
Description
Specifies global Linker warning control. This setting is equivalent to specifying the -Wlnk or -Wnolnk commandline options.
Activates or deactivates generation of warnings if
SHT_NOBITS (.bss) section precedes SHT_PROGBITS
(data/text) sections in the segment. By default, this option is turned on. This setting is equivalent to specifying the -Wlnkprogbits-after-nobits or -Wnolnk-progbitsafter-nobits command-line options.
Activates or deactivates generation of warnings about if recursive function calls make stack-effect computation an estimate. By default, this option is turned on. This setting is equivalent to specifying the -Wlnk-stack-effect or -
Wnolnk-stack-effect command-line options.
3.3.4.6 Include Search Paths
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
73
Build Properties for StarCore
Use this panel to specify paths to search for
#include
files. Note that the IDE displays an error message if a header file is in a different directory from the referencing source file.
Sometimes, the IDE also displays an error message if a header file is in the same directory as the referencing source file.
For example, if you see the message
Could not open source file myfile.h
, you must add the path for myfile.h
to this panel.
Figure 3-18. Tool Settings - Include Search Paths
Table 3-19 lists and describes the toolbar buttons that help work with the file search
paths.
Table 3-19. Tool Settings - Include Search Paths Toolbar Buttons
Button Description
Add - Click to open the
Add directory path dialog box
(
Figure 3-19 ) and specify the file search path.
Delete - Click to delete the selected file search path. To confirm deletion, click Yes in the Confirm Delete dialog box.
Edit - Click to open the Edit directory path dialog box (
Figure
3-20
) and update the selected object file search path.
Move up - Click to move the selected file search path one position higher in the list.
Move down - Click to move the selected file search path one position lower in the list.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
74 Freescale Semiconductor, Inc.
Figure 3-19 shows the Add directory path dialog box.
Chapter 3 Build Properties
Figure 3-19. Add directory path Dialog Box
Figure 3-20 shows the Edit directory path dialog box.
Figure 3-20. Edit directory path Dialog Box
The buttons in the Add directory path and Edit directory path dialog boxes help work with the object file search paths.
• OK- Click to confirm the action and exit the dialog box.
• Cancel - Click to cancel the action and exit the dialog box.
• Workspace- Click to display the Folder Selection dialog box and specify the object file search path. The resulting path, relative to the workspace, appears in the appropriate list.
• File system- Click to display the Browse for Folder dialog box and specify the object file search path. The resulting path appears in the appropriate list.
3.3.4.7 Macros
Use this panel to define and undefine preprocessor macros. You can specify multiple macros and change the order in which the IDE uses the macros.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
75
Build Properties for StarCore
Figure 3-21. Tool Settings - Macros
Table 3-20 describes the various options available on the Macros panel.
Table 3-20. Tool Settings - Macros Options
Option
Define Preprocessor Macros
Undefine Preprocessor Macros
Description
Define preprocessor macros and optionally assign their values. This setting is equivalent to specifying the -D name[=value] command-line option. To assign a value, use the equal sign (=) with no white space. For example, this syntax defines a preprocessor value named
EXTENDED_FEATURE and assigns ON as its value:
EXTENDED_FEATURE=ON
Note that if you do not assign a value to the macro, the shell assigns a default value of 1.
Undefine preprocessor macros. This setting is equivalent to specifying the -U name command-line option. For example, this syntax undefines the EXTENDED_ FEATURE macro:
EXTENDED_FEATURE
Note that the shell processes these items after it processes all
Defined Preprocessor Macros items.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
76 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-21 lists and describes the toolbar buttons that help work with the macros.
Table 3-21. Tool Settings - Macros Toolbar Buttons
Button Description
Add - Click to add a defined preprocessor macro.
Delete - Click to delete the selected macro. To confirm deletion, click Yes in the Confirm Delete dialog box.
Edit - Click to update the selected defined preprocessor macro.
Move up - Click to move the selected macro one position higher in the list.
Move down - Click to move the selected macro one position lower in the list.
3.3.4.8 Processor
Use this panel to enable fused multiply and accumulate operation.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
77
Build Properties for StarCore
Figure 3-22. Tool Settings - Processor Panel
Table 3-22 explains the options available on the Processor panel.
Option
Fused multiply and accumulate
Table 3-22. Tool Settings - Processor
Description
Check to enable the fused multiply and accumulate operation.
Fused multiply and add are generated only if hardware floating point support is enabled on the SC3900fp compiler.
3.3.4.9 Optimization
Use this panel to control compiler optimizations. Compiler optimization can be applied in either global or non-global optimization mode. You can apply global optimization at the end of the development cycle, after compiling and optimizing all source files individually or in groups.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
78 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-23. Tool Settings - Optimization
Table 3-23 describes the various options available on the Optimization panel.
Alignment
Table 3-23. Tool Settings - Optimization Options
Option Description
Specify the alignment level that the compiler uses. This setting is equivalent to specifying the -align level commandline option.
• default - level 0 applies to size optimizations, and level
2 applies to speed optimizations
• 0 - disable alignment
•
1 - align hardware loops
• 2 - align hardware and software loops
•
3 - align all existing labels
• 4 - align all existing labels and subroutine-return points
Optimization Level
Note that using a higher alignment constraint increases execution speed but also increases object-code size.
Specify the optimizations that you want the compiler to apply to the generated object code:
•
0 - Disable optimizations. This setting is equivalent to specifying the -O0 command-line option. The compiler generates unoptimized, linear assembly-language code.
•
1 - The compiler performs all target-independent (that is, non-parallelized) optimizations, such as function inlining. This setting is equivalent to specifying the -O1 command-line option.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
79
Build Properties for StarCore
Table 3-23. Tool Settings - Optimization Options (continued)
Option Description
The compiler omits all target-specific optimizations and generates linear assembly-language code.
• 2 - The compiler performs all optimizations (both targetindependent and target-specific). This setting is equivalent to specifying the -O2 command-line option.
The compiler outputs optimized, non-linear, parallelized assembly-language code.
• 3 - The compiler performs all the level 2 optimizations, then the low-level optimizer performs global-algorithm register allocation. This setting is equivalent to specifying the -O3 command-line option.
At this optimization level, the compiler generates code that is usually faster than the code generated from level
2 optimizations.
• 4 - The compiler performs all the level 3 optimizations, then the low-level optimizer performs global-algorithm register allocation. This setting is equivalent to specifying the -O4 command-line option.
At this optimization level, the compiler generates code that is usually faster than the code generated from level
3 optimizations.
Optimize For
Type-Based Alias Analysis
Global Optimization
To specify this setting, specify an Optimization Level greater than 0. Specify the goal of the optimizations that the compiler performs:
•
Faster Execution Speed - The compiler optimizes object code at the specified Optimization Level such that the resulting binary file has a faster execution speed, as opposed to a smaller executable code size.
•
Smaller Code Size - The compiler optimizes object code at the specified Optimization Level such that the resulting binary file has a smaller executable code size, as opposed to a faster execution speed. This setting is equivalent to specifying the -Os command-line option.
Instructs the compiler to use alias by type rules for alias analysis. As per alias by type rules, a value which is stored in memory should always be accessed using the same access size or through a signed/unsigned char*. For more information, see Chapter 6.5, Paragraph 7 in C99 Standard document.
To specify this setting, specify an Optimization Level greater than 0.
Checked - The compiler applies the selected optimizations across all files in the build target. This global optimization is the most effective. This setting is equivalent to specifying the
-cfe compiler command-line option followed by the -Og linkphase command-line option.
Cleared - The compiler creates intermediate files that have the .obj file extension.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
80 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
3.3.4.10 Configuration Files
Use this panel to specify the application-configuration file view, and the custom application-configuration file.
Figure 3-24. Tool Settings - Configuration Files
Table 3-24 describes the various options available on the Configuration Files panel.
Configuration View
Table 3-24. Tool Settings - Configuration Files Options
Option
Application Configuration File
Description
Enter the application-configuration file view that the build target uses. This setting is equivalent to specifying the -view identifier command-line option. If you use this text box, you must specify a path in the Application Configuration File text box.
Enter the path to a custom application-configuration file. This setting is equivalent to specifying the -ma filename command line option. Alternatively, click the Browse button, then use the resulting dialog box to specify the file. Clear this text box to use a default application-configuration file. Use a custom application-configuration file to apply different settings
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
81
Build Properties for StarCore
Table 3-24. Tool Settings - Configuration Files Options
Option Description
and optimization levels to various files and functions of the build target. An application-configuration file must have the .appli filename extension.
3.3.4.11 Additional Arguments
Use this panel to specify command-line options that the shell program (scc) passes directly to individual build tools (such as the front-end compiler, the various optimizers, and the assembler). Because the IDE shares this panel among multiple tools, just the options that apply to the selected tool appear in each instance of the panel.
NOTE
The IDE applies the command-line options that you specify in this panel to the compilation of the C-language source files in a build target (even the options that you enter in the To
Assembler text box). To pass command-line options to the assembler for application to the assembly-language files in a build target, use the Read Options from File text box of the
StarCore 3900 Assembler > Preprocessor panel.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
82 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-25. Tool Settings - Additional Arguments
Table 3-25 describes the various options available on the Additional Arguments panel.
Table 3-25. Tool Settings - Additional Arguments Options
To Front-End
To Assembler
To Shell
Option Description
Enter command-line options for the shell program to pass to the front-end compiler. This setting is equivalent to specifying the -Xcfe command-line option.
Enter command-line options for the shell program to pass to the assembler. This setting is equivalent to specifying the -
Xasm command-line option.
Enter command-line options for the IDE to pass to the shell program. The IDE passes the options exactly as you type them and does not check for errors.
3.3.5 StarCore 3900 Assembler
Use this panel to specify the command, options, and expert settings for the build tool assembler.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
83
Build Properties for StarCore
Figure 3-26. Tool Settings - StarCore 3900 Assembler
Table 3-26 describes the various options available on the StarCore 3900 Assembler
options.
Command
All options
Table 3-26. Tool Settings - StarCore 3900 Assembler Options
Expert Settings
Command line pattern
Option Description
Shows the location of the assembler executable file.
Shows the actual command line the assembler will be called with.
Shows the expert settings command line parameters; default is "${SCToolsInstallDir}${COMMAND}" ${FLAGS} $
{OUTPUT_FLAG}${OUTPUT_PREFIX}${OUTPUT} $
{INPUTS}.
3.3.5.1 Code and Language Options
Use this panel to specify code- and symbol-generation options for the StarCore assembler.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
84 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-27. Tool Settings - Code and Language Options
Table 3-27 describes the various options available on the Code and Language Options
panel.
Table 3-27. Tool Settings - Code and Language Options
Option
Generate Debugging Information
Ignore Case in Symbol Names
Write Symbols to Object File
Description
Checked - The assembler produces symbolic information for debugging the build target.
Cleared - The assembler does not produce symbolic information.
Checked - The assembler ignores the case of symbol, section, and macro names. This setting corresponds to the IC option of the OPT directive and to the -oic command-line option.
Cleared - The assembler considers the case of symbol, section, and macro names.
Checked - The assembler writes symbol information to the object files that it generates. This setting corresponds to the
SO option of the OPT directive and to the -oso commandline option.
Cleared - The assembler does not write symbol information to assembler-generated object files.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
85
Build Properties for StarCore
Table 3-27. Tool Settings - Code and Language Options (continued)
Option
Enable Check Summing
Continue Check Summing
Do Not Restrict Directives in Loops
Pack Strings
Scan MACLIB for Include Files
Enable Cycle Counts
Description
Checked - The assembler allows check-summing of instruction and data values and clearing the cumulative checksum.
Cleared - The assembler does not allow check summing of instruction and data values. You can use the @CHK() function to obtain the checksum value.
Note that the assembler never preserves a comment line in a macro definition that starts with two consecutive semicolons
(;;). This setting corresponds to the CK option of the OPT directive and to the -ock command-line option.
Checked-The assembler re-enables check summing of instructions and data. This setting corresponds to the CONTCK option of the OPT directive and to the -ocontck commandline option. Checking this checkbox does not cause the assembler to clear the cumulative checksum value. Cleared-
The assembler does not re-enable check summing of instructions and data.
Checked - The assembler suppresses error messages related to directives that might be invalid in DO loops. This setting corresponds to the DLD option of the OPT directive and to the -odld command-line option.
Cleared - The assembler generates error messages related to directives that might be invalid in DO loops.
Checked - The assembler packs strings that appear in the
Define Constant ( DC) directive. This setting corresponds to the PS option of the OPT directive and to the -ops commandline option. The assembler packs individual bytes of strings into consecutive target words for the length of the string.
Cleared - The assembler does not pack strings that appear in the DC directive.
Checked - The assembler searches for #include files in the paths shown in the Macro Library (MACLIB) Search Paths list,
as well as the paths shown in the Include Search Paths panel
of the StarCore Assembler. This setting corresponds to the MI option of the OPT directive and to the -omi command-line option.
Cleared - The assembler searches for include files just in the paths shown in the
Include Search Paths
panel of the
StarCore Assembler.
Checked - The assembler enables the cycle counter and clear-total-cycle-count features. This setting corresponds to the CC option of the OPT directive and to the -occ commandline option. Checking this checkbox causes the listing file to show a cycle count for each instruction entry.
Cleared - The assembler disables the cycle counter.
Note that cycle counts assume a full instruction-fetch pipeline and no wait states.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
86 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-27. Tool Settings - Code and Language Options (continued)
Option
Preserve Comment Lines in Macros
Make All Section Symbols Global
Perform Interrupt Location Checks
Expand Define Symbols in Strings
Preserve Object File on Errors
Dynamic Programming Rule Checks
Macro Library (MACLIB) Search Paths
Description
Checked - The assembler preserves comment lines in macros. This setting corresponds to the CM option of the OPT directive and to the -ocm command-line option.
Cleared - The assembler does not preserve comment lines in macros.
Checked - The assembler treats all sections as if you had declared them explicitly as GLOBAL sections. This setting corresponds to the GL option of the OPT directive and to the ogl command-line option. You must check this checkbox before explicitly defining any section in a source file.
Cleared - The assembler does not treat all sections as if you had declared them explicitly as GLOBAL sections.
Checked-The assembler checks for DSP instructions that cannot appear in the interrupt-vector locations of program memory. This setting corresponds to the INTR option of the
OPT directive and to the - ointr command-line option.
Cleared-The assembler does not check for DSP instructions that cannot appear in the interrupt- vector locations of program memory.
Checked - The assembler expands DEFINE symbols in strings. This setting corresponds to the DEX option of the OPT directive and to the -odex command-line option.
Cleared - The assembler does not expand DEFINE symbols in strings.
Checked - The assembler preserves object files if assembly errors occur. This setting corresponds to the SVO option of the OPT directive and to the - osvo command-line option.
Cleared - The assembler discards object files if assembly errors occur.
Specify how the assembler reports violations of programming rules:
·
Disable All - The assembler does not report violations of dynamic StarCore 3900FP DSP programming rules. This setting is the default behavior when you invoke the assembler from the command line.
·
Default - The assembler chooses whether to report violations of dynamic StarCore 3900FP DSP programming rules.
Enable All - The assembler reports violations of dynamic
StarCore 3900FP DSP programming rules. The IDE passes the -s all option to the assembler.
Lists paths to search for #include files. The assembler searches the paths in the order shown in this list. Use these toolbar buttons to work with the search paths:
• Add - Click, then use the resulting dialog box to specify the path.
• Delete - Click to remove the selected path.
•
Edit - Click, then use the resulting dialog box to change the selected path.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
87
Build Properties for StarCore
Table 3-27. Tool Settings - Code and Language Options
Option Description
• Move up - Click to move the selected path one position higher in the list.
• Move down - Click to move the selected path one position lower in the list.
Use these buttons in the dialog boxes to help you work with paths:
•
Workspace - Click, then use the resulting dialog box to specify the path. The resulting path, relative to the workspace, appears in the list.
• File system - Click, then use the resulting dialog box to specify the path. The resulting absolute path appears in the list.
3.3.5.2 Include Search Paths
Use this panel to specify multiple search paths and the order in which to search those paths. The IDE first looks for the specified file in the current directory, or the directory that you specify in the
INCLUDE
directive. If the IDE does not find the file, it continues searching the paths shown in this panel. The IDE keeps searching paths until it finds the file or finishes searching the last path at the bottom of the Include File Search Paths list.
The IDE appends to each path the string that you specify in the
INCLUDE
directive.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
88 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-28. Tool Settings - Include Search Paths
Table 3-28 lists and describes the toolbar buttons that help work with the file search
paths.
Table 3-28. Tool Settings - Include Search Paths Toolbar Buttons
Button Description
Add - Click to open the Add directory path dialog box
(
Include Search Paths ) and specify the file search path.
Delete - Click to delete the selected file search path. To confirm deletion, click Yes in the Confirm Delete dialog box.
Edit - Click to open the Edit directory path dialog box
(
Include Search Paths ) and update the selected object file
search path.
Move up - Click to move the selected file search path one position higher in the list.
Move down - Click to move the selected file search path one position lower in the list.
Figure 3-29 shows the Add directory path dialog box.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
89
Build Properties for StarCore
Figure 3-29. Add directory path Dialog Box
Figure 3-30 shows the Edit directory path dialog box.
Figure 3-30. Edit directory path Dialog Box
The buttons in the Add directory path and Edit directory path dialog boxes help work with the object file search paths.
• OK- Click to confirm the action and exit the dialog box.
• Cancel- Click to cancel the action and exit the dialog box.
• Workspace- Click to display the Folder Selection dialog box and specify the object file search path. The resulting path, relative to the workspace, appears in the appropriate list.
• File system- Click to display the Browse for Folder dialog box and specify the object file search path. The resulting path appears in the appropriate list.
3.3.5.3 Preprocessor
Use this panel to specify preprocessor behavior. You can specify whether to display banner information or verbose progress messages, and you can control error output. Also, you can specify substitution strings for the preprocessor.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
90 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-31. Tool Settings - Preprocessor
Table 3-29 describes the various options available on the Preprocessor panel.
Table 3-29. Tool Settings - Preprocessor Options
Display Banner
Read Options from File
Redirect Errors to File
Option
Show Verbose Assembly Progress Messages
Description
Checked - The assembler shows banner information.
Cleared - The assembler hides banner information.
Note that this option has no effect on hosts where the default setting is to hide the banner.
Checked - The assembler reports the progress of the assembly process to the standard error output stream. For example, the assembler reports the beginning of each pass and the opening and closing of input files. You can use this information to monitor the assembly process and ensure that it proceeds normally.
Cleared - The assembler does not report assembly progress to the standard error-output stream.
Enter the path to a file that specifies command-line options for assembler use. Alternatively, click the Browse button, then use the resulting dialog box to specify the file.
Enter the path to a file that the assembler uses in place of the default error file (errfil). The Overwrite Existing Error
File checkbox controls how the assembler writes to the file that you specify in this text box.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
91
Build Properties for StarCore
Table 3-29. Tool Settings - Preprocessor Options (continued)
Overwrite Existing Error File
Option
Defined Symbols
Description
Checked - The assembler overwrites the file that you specify in the Redirect Errors to File text box.
Cleared - The assembler appends information to the file that you specify in the Redirect Errors to File text box.
Specify substitution strings that the assembler applies to all the assembly-language modules in the build target. Enter just the string portion of a substitution string. The IDE prepends the -d token to each string that you enter. For example, entering opt1 x produces this result on the command line: dopt1 x Note that this option is similar to the DEFINE directive, but applies to all assembly-language modules in a build target. Use these toolbar buttons to work with the substitution strings:
•
Add - Click, then use the resulting dialog box to specify the string.
• Delete - Click to remove the selected string.
• Edit - Click, then use the resulting dialog box to change the selected string.
•
Move up - Click to move the selected string one position higher in the list.
•
Move down - Click to move the selected string one position lower in the list.
3.3.5.4 Listing File
Use this panel to specify whether the assembler generates a listing file. When generating a listing file, you can specify whether the assembler also prints a memory-utilization report. Also, you can specify the types of warnings that the assembler includes in the listing file. (
Figure 3-32
)
NOTE
Use the
Additional Arguments
panel of the StarCore Assembler to specify options that you want to apply to all assemblylanguage files in the current build target. Use the
OPT
directive for options that you want to apply to just the assembly-language source file in which the
OPT
directive appears.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
92 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-32. Tool Settings - Listing File
Table 3-30 describes the various options available on the Listing File panel.
Generate Listing File
Listing File Debug
Table 3-30. Tool Settings - Listing File Options
Option
Print Memory Utilization Report
Description
Checked - The assembler creates a listing file named lstfil.lst.
Cleared - The assembler does not create a list file.
To specify this setting, check the
Generate Listing File
checkbox.
Checked - The assembler uses the source listing, instead of the assembly-language source file, as the debug source file.
This setting corresponds to the LDB option of the OPT directive and to the -oldb command-line option.
Cleared - The assembler uses the assembly language source file, instead of the source listing, as the debug source file.
To specify this setting, check the
Generate Listing File
checkbox.
Checked - The assembler writes a report of load and runtime memory-use information to the listing file. This setting corresponds to the MU option of the OPT directive and to the omu command-line option.
Cleared - The assembler does not write the memoryutilization report to the listing file.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
93
Build Properties for StarCore
Table 3-30. Tool Settings - Listing File Options (continued)
Option
Print Warning for Unresolved References
Print All Warnings
Description
To specify this setting, check the
Generate Listing File
checkbox.
Checked - The assembler generates a warning at assembly time for each unresolved external reference. This setting, valid just in relocatable mode, corresponds to the UR option of the OPT directive and to the -our command-line option.
Cleared - The assembler does not generate a warning at assembly time for each unresolved external reference.
To specify this setting, check the
Generate Listing File
checkbox.
Checked - The assembler writes all warning messages to the listing file. This setting corresponds to the W option of the OPT directive and to the -ow command-line option.
Cleared - The assembler does not write all warning messages to the listing file.
3.3.5.5 Listing Contents
Use this panel to specify the information that the assembler generates in a listing file.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
94 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-33. Tool Settings - Listing Contents
Table 3-31 describes the various options available on the Listing Contents panel.
Table 3-31. Tool Settings - Listing Contents Options
Generate Listing Headers
Print DC Expansion
Option
Expand DEFINE Directive Strings
Description
Checked - The assembler writes listing headers, titles, and subtitles to the listing file. This setting corresponds to the HDR option of the OPT directive and to the -ohdr command-line option.
Cleared - The assembler does not write listing headers, titles, and subtitles to the listing file.
Checked - The assembler writes Define Constant (DC) expansions to the listing file. This setting corresponds to the
CEX option of the OPT directive and to the -ocex commandline option.
Cleared - The assembler does not write Define Constant expansions to the listing file.
Checked - The assembler writes expanded DEFINE directives to the listing file. This setting corresponds to the MD option of the OPT directive and to the - omd command-line option.
Cleared - The assembler does not write expanded DEFINE directives to the listing file.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
95
Build Properties for StarCore
Table 3-31. Tool Settings - Listing Contents Options (continued)
Option
Print Conditional Assembly Directive
Print Conditional Assembly
Print Skipped Conditional Assembly Lines
Print Macro Definitions
Print Macro Calls
Print Macro Expansions
Description
Checked - The assembler writes conditional-assembly directives to the listing file. This setting corresponds to the CL option of the OPT directive and to the -ocl command-line option.
Cleared - The assembler does not write conditionalassembly directives to the listing file.
Checked - The assembler writes conditional-assembly and section nesting-level information to the listing file. This setting corresponds to the NL option of the OPT directive and to the onl command-line option.
Cleared - The assembler does not write conditional-assembly and section nesting-level information to the listing file.
Checked - The assembler writes to the listing file assemblylanguage statements skipped due to conditional assembly.
This setting corresponds to the U option of the OPT directive and to the -ou command-line option.
Cleared - The assembler does not write to the listing file assembly-language statements skipped due to conditional assembly.
Checked - The assembler writes macro definitions to the listing file. This setting corresponds to the MD option of the
OPT directive and to the -omd command-line option.
Cleared - The assembler does not write macro definitions to the listing file.
Checked - The assembler writes macro calls to the listing file.
This setting corresponds to the MC option of the OPT directive and to the -omc command-line option.
Cleared - The assembler does not write macro calls to the listing file.
Checked - The assembler writes macro expansions to the listing file. This setting corresponds to the MEX option of the
OPT directive and to the -omex command-line option.
Cleared - The assembler does not write macro expansions to the listing file.
3.3.5.6 Listing Format
Use this panel to specify format of the information that the assembler generates in a listing file.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
96 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Figure 3-34. Tool Settings - Listing Format
Table 3-32 describes the various options available on the Listing Format panel.
Fold Trailing Comments
Form Feed for Page Ejects
Format Messages
Table 3-32. Tool Settings - Listing Format Options
Option Description
Checked - For each source-code statement that has a trailing comment, the assembler moves the comment underneath that statement. The assembler aligns the moved comment with the opcode field. This setting corresponds to the FC option of the OPT directive and to the -ofc command-line option.
Cleared - The assembler does not move trailing comments underneath their corresponding source code statements.
Checked - The assembler inserts form feeds into the listing file. Each form feed causes a printer to eject the currently printing page. This setting corresponds to the FF option of the
OPT directive and to the -off command-line option.
Cleared - The assembler does not insert form feeds into the listing file.
Checked - The assembler inserts format messages into the listing file such that the message text aligns and breaks at word boundaries. This setting corresponds to the FM option of the OPT directive and to the -ofm command-line option.
Cleared - The assembler does not insert format messages into the listing file.
Table continues on the next page...
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
97
Build Properties for StarCore
Table 3-32. Tool Settings - Listing Format Options (continued)
Pretty Print Listing
Relative Comment Spacing
Option Description
Checked - The assembler aligns listing-file fields at fixed column positions (without regard to the related source file's format). This setting corresponds to the PP option of the OPT directive and to the -opp command-line option.
Cleared - The assembler does not align listing-file fields at fixed column positions.
Checked - The assembler uses relative comment spacing in the listing file. Checking this checkbox causes the position of comments in the listing file to float. This setting corresponds to the RC option of the OPT directive and to the -orc command-line option. Cleared - The assembler uses fixed comment spacing in the listing file.
3.3.5.7 Additional Arguments
Use this panel to specify StarCore assembler additional arguments.
Figure 3-35. Tool Settings - Additional Arguments
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
98 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-33 describes the various options available on the Additional Arguments panel.
Table 3-33. Tool Settings - Additional Arguments Options
StarCore 3900 Assembler
Option Description
Specify additional command-line options to the assembler.
The arguments specified in this panel apply will to all assembly language files in the current build target.
3.3.6 StarCore 3900 Preprocessor
Use this panel to specify the command, options, and expert settings for the StarCore 3900 preprocessor.
Figure 3-36. Tool Settings - StarCore 3900 Preprocessor
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
99
Build Properties for StarCore
Table 3-34 describes the various options available on the StarCore 3900 Preprocessor
panel.
Command
All options
Table 3-34. Tool Settings - StarCore 3900 Preprocessor Options
Expert Settings:
Command line pattern
Option Description
Shows the location of the disassembler executable file.
Shows the actual command line the disassembler will be called with.
Shows the expert settings command line parameters; default is "${SCToolsInstallDir}${COMMAND}" ${FLAGS} $
{INPUTS}.
3.3.6.1 Preprocessor Settings
Use this panel to specify the Preprocessor behavior.
Figure 3-37. Tool Settings - Preprocessor Settings
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
100 Freescale Semiconductor, Inc.
Chapter 3 Build Properties
Table 3-35 describes the various options available on the Preprocessor Settings panel.
Keep All Comments
Table 3-35. Tool Settings - Preprocessor Settings Options
Option Description
Checked -The preprocessor preserves all the comments.
Cleared -The preprocessor does not preserve comments.
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
Freescale Semiconductor, Inc.
101
Build Properties for StarCore
CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,
11/2015
102 Freescale Semiconductor, Inc.
