11.3. Assembler Options. Altium TriCore
Quảng cáo
Quảng cáo
TASKING VX-toolset for TriCore User Guide
11.3. Assembler Options
This section lists all assembler options.
Options in Eclipse versus options on the command line
Most command line options have an equivalent option in Eclipse but some options are only available on the command line. Eclipse invokes the assembler via the control program. Therefore, it uses the syntax of the control program to pass options and files to the assembler. If there is no equivalent option in Eclipse, you can specify a command line option in Eclipse as follows:
1.
From the Project menu, select Properties
The Properties dialog appears.
2.
In the left pane, expand C/C++ Build and select Settings.
In the right pane the Settings appear.
3.
On the Tool Settings tab, select Assembler » Miscellaneous.
4.
In the Additional options field, enter one or more command line options.
Because Eclipse uses the control program, Eclipse automatically precedes the option with -Wa to pass the option via the control program directly to the assembler.
Note that the options you enter in the Assembler page are not only used for hand-coded assembly files, but also for the assembly files generated by the compiler.
Be aware that some command line options are not useful in Eclipse or just do not have any effect. For example, the option -V displays version header information and has no effect in Eclipse.
Short and long option names
Options can have both short and long names. Short option names always begin with a single minus (-) character, long option names always begin with two minus (--) characters.You can abbreviate long option names as long as it forms a unique name. You can mix short and long option names on the command line.
Options can have flags or suboptions. To switch a flag 'on', use a lowercase letter or a +longflag. To switch a flag off, use an uppercase letter or a -longflag. Separate longflags with commas. The following two invocations are equivalent: astc -Ogs test.src
astc --optimize=+generics,+instr-size test.src
When you do not specify an option, a default value may become active.
470
Tool Options
Assembler option: --case-insensitive (-c)
Menu entry
1.
Select Assembler » Symbols.
2.
Enable the option Case insensitive identifiers.
Command line syntax
--case-insensitive
-c
Default: case sensitive
Description
With this option you tell the assembler not to distinguish between upper and lower case characters. By default the assembler considers upper and lower case characters as different characters.
Assembly source files that are generated by the compiler must always be assembled case sensitive.
When you are writing your own assembly code, you may want to specify the case insensitive mode.
Example
When assembling case insensitive, the label
LabelName
is the same label as labelname
.
astc --case-insensitive test.src
Related information
471
TASKING VX-toolset for TriCore User Guide
Assembler option: --check
Menu entry
-
Command line syntax
--check
Description
With this option you can check the source code for syntax errors, without generating code. This saves time in developing your application.
The assembler reports any warnings and/or errors.
This option is available on the command line only.
Related information
(Check syntax)
472
Tool Options
Assembler option: --core
Menu entry
1.
Select Assembler » Miscellaneous.
2.
Add the option --core to the Additional options field.
Command line syntax
--core=core
You can specify the following core arguments:
tc1.2
tc1.3
tc1.3.1
tc2
TriCore 1.2 architecture
TriCore 1.3 architecture
TriCore 1.3.1 architecture, TriCore 1.3.1 instructions are allowed
TriCore 2 architecture, TriCore 2 instructions are allowed
Default: derived from
--cpu
, if used, otherwise tc1.3
Description
With this option you specify the core architecture for a custom target processor for which you create your application. By default the TriCore toolset derives the core from the processor you selected.
With --core=tc1.3.1, you can use TriCore 1.3.1 instructions in the assembly code. The define
__TC131__ is set to 1.
With --core=tc2, you can use TriCore 2 instructions in the assembly code. The define
__TC2__
is set to
1.
If you select a valid target processor (
command line option --cpu (-C)
), th core is automatically set, based on the chosen target processor.
Example
To allow the use of TriCore 2 instructions in the assembly code, enter: astc --core=tc2 test.src
Related information
(Select processor)
Assembler option --fpu-present
(FPU present)
Assembler option --mmu-present
(MMU present)
473
TASKING VX-toolset for TriCore User Guide
Assembler option: --cpu (-C)
Menu entry
1.
Expand C/C++ Build and select Processor.
2.
From the Processor Selection list, select a processor.
Command line syntax
--cpu=cpu
-Ccpu
Description
With this option you define the target processor for which you create your application.
Based on this option the assembler always includes the special function register file reg
cpu
.def
, unless
you disable the option Automatic inclusion of '.def' file on the Preprocessing page ( option
Based on the target processor the assembler automatically detects whether a MMU or FPU-unit is present and whether the architecture is a TriCore2. This means you do not have to specify the assembler options
explicitly when one of the supported derivatives is selected.
To avoid conflicts, make sure you specify the same target processor as you did for the compiler (Eclipse and the control program do this automatically).
Example
To assemble the file test.src
for the TC1165 processor and use the register file regtc1165.def
: astc --cpu=tc1165 test.src
Related information
Assembler option --no-tasking-sfr (Do not include .def file)
C compiler option --cpu (Select processor)
Section 3.5.1, Special Function Registers
474
Tool Options
Assembler option: --debug-info (-g)
Menu entry
1.
Select Assembler » Symbols.
2.
Select an option from the Generate symbolic debug list.
Command line syntax
--debug-info[=flags]
-g[flags]
You can set the following flags:
+/-asm
+/-hll
+/-local
+/-smart a/A h/H l/L s/S
Assembly source line information
Pass high level language debug information (HLL)
Assembler local symbols debug information
Smart debug information
Default:
--debug-info=+hll
Default (without flags):
--debug-info=+smart
Description
With this option you tell the assembler which kind of debug information to emit in the object file.
You cannot specify --debug-info=+asm,+hll. Either the assembler generates assembly source line information, or it passes HLL debug information.
When you specify --debug-info=+smart, the assembler selects which flags to use. If high level language information is available in the source file, the assembler passes this information (same as
--debug-info=-asm,+hll,-local). If not, the assembler generates assembly source line information (same as --debug-info=+asm,-hll,+local).
With --debug-info=AHLS the assembler does not generate any debug information.
Related information
475
TASKING VX-toolset for TriCore User Guide
Assembler option: --define (-D)
Menu entry
1.
Select Assembler » Preprocessing.
The Defined symbols box right-below shows the symbols that are currently defined.
2.
To define a new symbol, click on the Add button in the Defined symbols box.
3.
Type the symbol definition (for example, demo=1
)
Use the Edit and Delete button to change a macro definition or to remove a macro from the list.
Command line syntax
--define=macro_name[=macro_definition]
-Dmacro_name[=macro_definition]
Description
With this option you can define a macro and specify it to the assembler preprocessor. If you only specify a macro name (no macro definition), the macro expands as '1'.
You can specify as many macros as you like. Simply use the Add button to add new macro definitions.
On the command line, use the option --define (-D) multiple times. If the command line exceeds the limit of the operating system, you can define the macros in an option file which you then must specify to the assembler with the option --option-file (-f) file.
Defining macros with this option (instead of in the assembly source) is, for example, useful in combination with conditional assembly as shown in the example below.
This option has the same effect as defining symbols via the
.DEFINE
,
.SET
, and
.EQU
directives.
(similar to
#define
in the C language). With the
.MACRO
directive you can define more complex macros.
Example
Consider the following assembly program with conditional code to assemble a demo program and a real program:
.IF DEMO == 1
... ; instructions for demo application
.ELSE
... ; instructions for the real application
.ENDIF
476
You can now use a macro definition to set the DEMO flag: astc --define=DEMO test.src
astc --define=DEMO=1 test.src
Note that both invocations have the same effect.
Related information
Assembler option --option-file
(Specify an option file)
Tool Options
477
TASKING VX-toolset for TriCore User Guide
Assembler option: --diag
Menu entry
1.
From the Window menu, select Show View » Other » Basic » Problems.
The Problems view is added to the current perspective.
2.
In the Problems view right-click on a message.
A popup menu appears.
3.
Select Detailed Diagnostics Info.
A dialog box appears with additional information.
Command line syntax
--diag=[format:]{all | nr,...}
You can set the following output formats:
html rtf text
HTML output.
Rich Text Format.
ASCII text.
Default format: text
Description
With this option you can ask for an extended description of error messages in the format you choose.
The output is directed to stdout (normally your screen) and in the format you specify. You can specify the following formats: html, rtf or text (default). To create a file with the descriptions, you must redirect the output.
With the suboption all, the descriptions of all error messages are given. If you want the description of one or more selected error messages, you can specify the error message numbers, separated by commas.
Example
To display an explanation of message number 244, enter: astc --diag=244
This results in the following message and explanation:
W244: additional input files will be ignored
The assembler supports only a single input file. All other input files are ignored.
478
Tool Options
To write an explanation of all errors and warnings in HTML format to file cerrors.html
, use redirection and enter: astc --diag=html:all > aserrors.html
Related information
Section 7.6, Assembler Error Messages
479
TASKING VX-toolset for TriCore User Guide
Assembler option: --emit-locals
Menu entry
1.
Select Assembler » Symbols.
2.
Enable or disable one or both of the following options:
• Emit local EQU symbols
• Emit local non-EQU symbols
Command line syntax
--emit-locals[=flag,...]
You can set the following flags:
+/-equs
+/-symbols e/E s/S
emit local EQU symbols emit local non-EQU symbols
Default:
--emit-locals=ES
Default (without flags):
--emit-locals=+symbols
Description
With the option --emit-locals=+equs the assembler also emits local EQU symbols to the object file.
Normally, only global symbols and non-EQU local symbols are emitted. Having local symbols in the object file can be useful for debugging.
Related information
480
Tool Options
Assembler option: --error-file
Menu entry
-
Command line syntax
--error-file[=file]
Description
With this option the assembler redirects error messages to a file. If you do not specify a filename, the error file will be named after the input file with extension
.ers
.
Example
To write errors to errors.ers
instead of stderr
, enter: astc --error-file=errors.ers test.src
Related information
Section 7.6, Assembler Error Messages
481
TASKING VX-toolset for TriCore User Guide
Assembler option: --error-limit
Menu entry
1.
Select Assembler » Diagnostics.
2.
Enter a value in the Maximum number of emitted errors field.
Command line syntax
--error-limit=number
Default: 42
Description
With this option you tell the assembler to only emit the specified maximum number of errors. When 0
(null) is specified, the assembler emits all errors. Without this option the maximum number of errors is
42.
Related information
Section 7.6, Assembler Error Messages
482
Tool Options
Assembler option: --fpu-present
Menu entry
1.
Expand C/C++ Build and select Processor.
2.
From the Processor Selection list, select a processor that has an FPU.
Command line syntax
--fpu-present
Description
With this option you can use single precision floating-point instructions in the assembly code. When you select this option, the define
__FPU__
is set to 1.
If you select a valid target processor ( command line option --cpu (-C)
), this option is automatically set, based on the chosen target processor.
Example
To allow the use of floating-point unit (FPU) instructions in the assembly code, enter: astc --fpu-present test.src
Related information
(Select processor)
Assembler option --core (Select TriCore architecture)
483
TASKING VX-toolset for TriCore User Guide
Assembler option: --help (-?)
Menu entry
-
Command line syntax
--help[=item]
-?
You can specify the following arguments:
options
Show extended option descriptions
Description
Displays an overview of all command line options. When you specify the argument options you can list detailed option descriptions.
Example
The following invocations all display a list of the available command line options: astc -?
astc --help astc
To see a detailed description of the available options, enter:
astc --help=options
Related information
484
Tool Options
Assembler option: --include-directory (-I)
Menu entry
1.
Select Assembler » Include Paths.
The Include paths box shows the directories that are added to the search path for include files.
2.
To define a new directory for the search path, click on the Add button in the Include paths box.
3.
Type or select a path.
Use the Edit and Delete button to change a path or to remove a path from the list.
Command line syntax
--include-directory=path,...
-Ipath,...
Description
With this option you can specify the path where your include files are located. A relative path will be relative to the current directory,
The order in which the assembler searches for include files is:
1. The pathname in the assembly file and the directory of the assembly source.
2. The path that is specified with this option.
3. The path that is specified in the environment variable
ASTCINC
when the product was installed.
4. The default directory
$(PRODDIR)\include
.
Example
Suppose that the assembly source file test.src
contains the following lines:
.INCLUDE 'myinc.inc'
You can call the assembler as follows: astc --include-directory=c:\proj\include test.src
First the assembler looks for the file myinc.inc
in the directory where test.src
is located. If it does not find the file, it looks in the directory c:\proj\include
(this option). If the file is still not found, the assembler searches in the environment variable and then in the default include directory.
485
TASKING VX-toolset for TriCore User Guide
Related information
Assembler option --include-file (Include file at the start of the input file)
486
Tool Options
Assembler option: --include-file (-H)
Menu entry
1.
Select Assembler » Preprocessing.
The upper box shows the files that are currently included before the assembling starts.
2.
To define a new file, click on the Add button in the Include files at start of input file box.
3.
Type the full path and file name or select a file.
Use the Edit and Delete button to change a file name or to remove a file from the list.
Command line syntax
--include-file=file,...
-Hfile,...
Description
With this option (set at project level) you include one extra file at the beginning of the assembly source file. The specified include file is included before all other includes. This is the same as specifying
.INCLUDE
'file'
at the beginning of your assembly source.
Example
astc --include-file=myinc.inc test.src
The file myinc.inc
is included at the beginning of test.src
before it is assembled.
Related information
Assembler option --include-directory
(Add directory to include file search path)
487
TASKING VX-toolset for TriCore User Guide
Assembler option: --keep-output-files (-k)
Menu entry
Eclipse always removes the object file when errors occur during assembling.
Command line syntax
--keep-output-files
-k
Description
If an error occurs during assembling, the resulting object file (
.o
) may be incomplete or incorrect. With this option you keep the generated object file when an error occurs.
By default the assembler removes the generated object file when an error occurs. This is useful when you use the make utility. If the erroneous files are not removed, the make utility may process corrupt files on a subsequent invocation.
Use this option when you still want to use the generated object. For example when you know that a particular error does not result in a corrupt object file.
Related information
Assembler option --warnings-as-errors
(Treat warnings as errors)
488
Tool Options
Assembler option: --list-file (-l)
Menu entry
1.
Select Assembler » List File.
2.
Enable the option Generate list file.
3.
Enable or disable the types of information to be included.
Command line syntax
--list-file[=file]
-l[file]
Default: no list file is generated
Description
With this option you tell the assembler to generate a list file. A list file shows the generated object code and the relative addresses. Note that the assembler generates a relocatable object file with relative addresses.
With the optional file you can specify an alternative name for the list file. By default, the name of the list file is the basename of the source file with the extension
.lst
.
Related information
Assembler option --list-format (Format list file)
489
TASKING VX-toolset for TriCore User Guide
Assembler option: --list-format (-L)
Menu entry
1.
Select Assembler » List File.
2.
Enable the option Generate list file.
3.
Enable or disable the types of information to be included.
Command line syntax
--list-format=flag,...
-Lflags
You can set the following flags:
+/-section
+/-symbol
+/-generic-expansion
+/-generic
+/-macro
+/-empty-line
+/-conditional
+/-equate
+/-relocations
+/-equate-values
+/-wrap-lines
+/-macro-expansion
+/-cycle-count
+/-define-expansion r/R v/V w/W x/X y/Y z/Z d/D e/E g/G i/I m/M n/N p/P q/Q
List section directives (
.SDECL
,
.SECT
)
List symbol definition directives
List expansion of generic instructions
List generic instructions
List macro definitions
List empty source lines (newline)
List conditional assembly
List equate and set directives (
.EQU
,
.SET
)
List relocations characters 'r'
List equate and set values
Wrap source lines
List macro expansions
List cycle counts
List define expansions
Use the following options for predefined sets of flags:
--list-format=0 -L0
--list-format=1 -L1
All options disabled
Alias for --list-format=DEGIMNPQRVWXYZ
All options enabled
Alias for --list-format=degimnpqrvwxyz
Default:
--list-format=dEGiMnPqrVwXyZ
Description
With this option you specify which information you want to include in the list file.
490
On the command line you must use this option in combination with the option --list-file (-l).
Related information
Assembler option --list-file (Generate list file)
Assembler option --section-info=+list (Display section information in list file)
Tool Options
491
TASKING VX-toolset for TriCore User Guide
Assembler option: --mmu-present
Menu entry
1.
Expand C/C++ Build and select Processor.
2.
From the Processor Selection list, select a processor that has an MMU.
Command line syntax
--mmu-present
Description
With this option you can use memory management instructions in the assembly code. When you select this option, the define
__MMU__
is set to 1.
If you select a valid target processor (
command line option --cpu (-C) ), this option is automatically set,
based on the chosen target processor.
Example
To allow the use of memory management unit (MMU) instructions in the assembly code, enter: astc --mmu-present test.src
Related information
Assembler option --cpu (Select processor)
Assembler option --fpu-present (FPU present)
(Select TriCore architecture)
492
Tool Options
Assembler option: --no-tasking-sfr
Menu entry
1.
Select Assembler » Preprocessing.
2.
Disable the option Automatic inclusion of '.def' file.
Command line syntax
--no-tasking-sfr
Description
Normally, the assembler includes a special function register (SFR) file before assembling. The assembler automatically selects the SFR file belonging to the target you select on the Processor page (assembler option --cpu).
With this option the assembler does not include the register file reg
cpu
.def
as based on the selected target processor.
Use this option if you want to use your own set of SFR files.
Example
astc --cpu=tc1165 --no-tasking-sfr test.src
The register file regtc1165.def
is not included, but the assembler allows the use of MMU instructions due to --cpu.
Related information
(Select processor)
493
TASKING VX-toolset for TriCore User Guide
Assembler option: --no-warnings (-w)
Menu entry
1.
Select Assembler » Diagnostics.
The Suppress warnings box shows the warnings that are currently suppressed.
2.
To suppress a warning, click on the Add button in the Suppress warnings box.
3.
Enter the numbers, separated by commas, of the warnings you want to suppress (for example
201,202
). Or you can use the Add button multiple times.
4.
To suppress all warnings, enable the option Suppress all warnings.
Use the Edit and Delete button to change a warning number or to remove a number from the list.
Command line syntax
--no-warnings[=number,...]
-w[number,...]
Description
With this option you can suppresses all warning messages or specific warning messages.
On the command line this option works as follows:
• If you do not specify this option, all warnings are reported.
• If you specify this option but without numbers, all warnings are suppressed.
• If you specify this option with a number, only the specified warning is suppressed. You can specify the option --no-warnings=number multiple times.
Example
To suppress warnings 201 and 202, enter: astc test.src --no-warnings=201,202
Related information
Assembler option --warnings-as-errors
(Treat warnings as errors)
494
Tool Options
Assembler option: --optimize (-O)
Menu entry
1.
Select Assembler » Optimization.
2.
Select one or more of the following options:
• Optimize generic instructions
• Optimize instruction size
Command line syntax
--optimize=flag,...
-Oflags
You can set the following flags:
+/-generics
+/-instr-size g/G s/S
Allow generic instructions
Optimize instruction size
Default:
--optimize=gs
Description
With this option you can control the level of optimization. For details about each optimization see
Section 7.4, Assembler Optimizations
.
Related information
Section 7.4, Assembler Optimizations
495
TASKING VX-toolset for TriCore User Guide
Assembler option: --option-file (-f)
Menu entry
1.
Select Assembler » Miscellaneous.
2.
Add the option --option-file to the Additional options field.
Be aware that the options in the option file are added to the assembler options you have set in the other pages. Only in extraordinary cases you may want to use them in combination.
Command line syntax
--option-file=file,...
-f file,...
Description
This option is primarily intended for command line use. Instead of typing all options on the command line, you can create an option file which contains all options and flags you want to specify. With this option you specify the option file to the assembler.
Use an option file when the command line would exceed the limits of the operating system, or just to store options and save typing.
Option files can also be generated on the fly, for example by the make utility. You can specify the option
--option-file multiple times.
Format of an option file
• Multiple arguments on one line in the option file are allowed.
• To include whitespace in an argument, surround the argument with single or double quotes.
• If you want to use single quotes as part of the argument, surround the argument by double quotes and vise versa:
"This has a single quote ' embedded"
'This has a double quote " embedded'
'This has a double quote " and a single quote '"' embedded"
• When a text line reaches its length limit, use a \ to continue the line. Whitespace between quotes is preserved.
"This is a continuation \ line"
-> "This is a continuation line"
496
• It is possible to nest command line files up to 25 levels.
Example
Suppose the file myoptions
contains the following lines:
--debug=+asm,-local test.src
Specify the option file to the assembler: astc --option-file=myoptions
This is equivalent to the following command line:
astc --debug=+asm,-local test.src
Related information
Tool Options
497
TASKING VX-toolset for TriCore User Guide
Assembler option: --output (-o)
Menu entry
Eclipse names the output file always after the input file.
Command line syntax
--output=file
-o file
Description
With this option you can specify another filename for the output file of the assembler. Without this option, the basename of the assembly source file is used with extension
.o
.
Example
To create the file relobj.o
instead of asm.o
, enter: astc --output=relobj.o asm.src
-
Related information
498
Tool Options
Assembler option: --page-length
Menu entry
1.
Select Assembler » Miscellaneous.
2.
Add the option --page-length to the Additional options field.
Command line syntax
--page-length=number
Default: 72
Description
If you generate a list file with the assembler option --list-file, this option sets the number of lines in a page in the list file. The default is 72, the minimum is 10. As a special case, a page length of 0 turns off page breaks.
Related information
Assembler option --list-file (Generate list file)
499
TASKING VX-toolset for TriCore User Guide
Assembler option: --page-width
Menu entry
1.
Select Assembler » Miscellaneous.
2.
Add the option --page-width to the Additional options field.
Command line syntax
--page-width=number
Default: 132
Description
If you generate a list file with the assembler option --list-file, this option sets the number of columns per line on a page in the list file. The default is 132, the minimum is 40.
Related information
(Generate list file)
500
Tool Options
Assembler option: --preprocess (-E)
Menu entry
-
Command line syntax
--preprocess
-E
Description
With this option the assembler will only preprocess the assembly source file. The assembler sends the preprocessed file to stdout.
-
Related information
501
TASKING VX-toolset for TriCore User Guide
Assembler option: --preprocessor-type (-m)
Menu entry
-
Command line syntax
--preprocessor-type=type
-mtype
You can set the following preprocessor types:
none tasking t n
No preprocessor
TASKING preprocessor
Default:
--preprocessor-type=tasking
Description
With this option you select the preprocessor that the assembler will use. By default, the assembler uses the TASKING preprocessor.
When the assembly source file does not contain any preprocessor symbols, you can specify to the assembler not to use a preprocessor.
-
Related information
502
Tool Options
Assembler option: --section-info (-t)
Menu entry
1.
Select Assembler » List File.
2.
Enable the option Generate list file.
3.
Enable the option List section summary.
and/or
1.
Select Assembler » Diagnostics.
2.
Enable the option Display section summary.
Command line syntax
--section-info[=flag,...]
-t[flags]
You can set the following flags:
+/-console
+/-list c/C l/L
Display section summary on console
List section summary in list file
Default:
--section-info=CL
Default (without flags):
--section-info=cl
Description
With this option you tell the assembler to display section information. For each section its memory space, size, total cycle counts and name is listed on stdout and/or in the list file.
The cycle count consists of two parts: the total accumulated count for the section and the total accumulated count for all repeated instructions. In the case of nested loops it is possible that the total supersedes the section total.
Example
To writes the section information to the list file and also display the section information on stdout, enter: astc --list-file --section-info asm.src
Related information
Assembler option --list-file (Generate list file)
503
TASKING VX-toolset for TriCore User Guide
all-tc1762 all-tc1764 all-tc1765 all-tc1766 all-tc1775 all-tc1792 all-tc1796 all-tc1910 all-tc1912 all-tc1920 all-tc11ib all-tc1100 all-tc1115 all-tc1130 all-tc1161 all-tc1162 all-tc1163 all-tc1164 all-tc1165 all-tc1166
Assembler option: --silicon-bug
Menu entry
1.
Expand C/C++ Build and select Processor.
2.
From the Processor Selection list, select a processor.
The CPU Problem Bypasses and Checks box shows the available workarounds/checks available for the selected processor.
3.
(Optional) Select Show all CPU problem bypasses and checks.
4.
Click Select All or select one or more individual options.
Command line syntax
--silicon-bug=arg,...
You can give one or more of the following arguments:
All TriCore TC11IB checks
All TriCore TC1100 checks
All TriCore TC1115 checks
All TriCore TC1130 checks
All TriCore TC1161 checks
All TriCore TC1162 checks
All TriCore TC1163 checks
All TriCore TC1164 checks
All TriCore TC1165 checks
All TriCore TC1166 checks
All TriCore TC1762 checks
All TriCore TC1764 checks
All TriCore TC1765 checks
All TriCore TC1766 checks
All TriCore TC1775 checks
All TriCore TC1792 checks
All TriCore TC1796 checks
All TriCore TC1910 checks
All TriCore TC1912 checks
All TriCore TC1920 checks
cpu-tc013
Check for CPU_TC.013
504
Tool Options
cpu-tc018 cpu-tc021 cpu-tc023 cpu-tc024 cpu-tc030 cpu-tc031 cpu-tc033 cpu-tc034 cpu-tc048 cpu-tc050 cpu-tc051 cpu-tc060 cpu-tc065 cpu-tc068 cpu-tc069 cpu-tc070 cpu-tc071 cpu-tc072 cpu-tc074 cpu-tc081 cpu-tc082 cpu-tc083 cpu-tc094 cpu-tc095 cpu-tc096 cpu-tc104 dmu-tc001 pmi-tc003 pmu-tc004
Check for CPU_TC.018
Check for CPU_TC.021
Check for CPU_TC.023
Check for CPU_TC.024
Check for CPU_TC.030
Check for CPU_TC.031
Workaround for CPU_TC.033
Check for CPU_TC.034
Check for CPU_TC.048
Check for CPU_TC.050
Workaround for CPU_TC.051
Check for CPU_TC.060
Check for CPU_TC.065
Check for CPU_TC.068
Check for CPU_TC.069
Check for CPU_TC.070
Check for CPU_TC.071
Check for CPU_TC.072
Workaround for CPU_TC.082
Check for CPU_TC.082
Check for CPU_TC.082
Check for CPU_TC.083
Check for CPU_TC.094
Check for CPU_TC.095
Check for CPU_TC.096
Check for CPU_TC.104
Check for DMU_TC.001
Workaround for PMI_TC.003
Workaround for PMU_TC.004
Description
With this option you specify for which hardware problems the assembler should check or generate
workarounds. Please refer to Chapter 16, CPU Problem Bypasses and Checks
for more information about the individual problems and workarounds.
Instead of this option you can use the following assembler controls:
$CPU_TCnum {ON|OFF}
$DMU_TCnum {ON|OFF}
505
TASKING VX-toolset for TriCore User Guide
$PMI_TCnum {ON|OFF}
$PMU_TCnum {ON|OFF}
When you use this option or control, the define __defect_TCnum__ is set to 1.
Example
To check for problems CPU_TC.024 and CPU_TC.030, enter: astc --silicon-bug=cpu-tc024,cpu-tc030 test.src
Related information
Chapter 16, CPU Problem Bypasses and Checks
Assembler controls $defect_TCnum
C compiler option --silicon-bug
506
Tool Options
Assembler option: --symbol-scope (-i)
Menu entry
1.
Select Assembler » Symbols.
2.
Enable or disable the option Set default symbol scope to global.
Command line syntax
--symbol-scope=scope
-iscope
You can set the following scope:
global local l g
Default symbol scope is global
Default symbol scope is local
Default:
--symbol-scope=local
Description
With this option you tell the assembler how to treat symbols that you have not specified explicitly as global or local. By default the assembler treats all symbols as local symbols unless you have defined them explicitly as global.
Related information
507
TASKING VX-toolset for TriCore User Guide
Assembler option: --user-mode
Menu entry
1.
Select Assembler » Miscellaneous.
2.
Add the option --user-mode to the Additional options field.
Command line syntax
--user-mode=mode
You can specify the following mode arguments:
user-0 user-1 kernel
User-0 unprivileged mode
User-1 privileged mode
Kernel/Supervisor mode
Default:
--user-mode=kernel
Description
With this option you specify the mode (I/O privilege mode) the TriCore runs in: User-0, User-1 or
Kernel/Supervisor. The availability of some instructions depends on this mode. Most instructions run in all modes. The instructions enable
and disable
run in User-1 or kernel mode only. The instructions bisr
, mtcr
, cachea.i
and tlb
instructions run in kernel mode only.
The define
__UM_KERNEL__
or
__UM_USER_1__
is set to 1, depending on the mode.
Example
To restrict the instructions in the assembly code to User-1 mode, enter: astc --user-mode=user-1 test.src
Related information
(Select user mode)
508
Assembler option: --version (-V)
Menu entry
-
Command line syntax
--version
-V
Description
Display version information. The assembler ignores all other options or input files.
Example
astc --version
The assembler does not assemble any files but displays the following version information:
TASKING VX-toolset for TriCore: assembler vx.yrz Build nnn
Copyright 2002-year Altium BV Serial# 00000000
-
Related information
Tool Options
509
TASKING VX-toolset for TriCore User Guide
Assembler option: --warnings-as-errors
Menu entry
1.
Select Global Options.
2.
Enable the option Treat warnings as errors.
Command line syntax
--warnings-as-errors[=number,...]
Description
If the assembler encounters an error, it stops assembling. When you use this option without arguments, you tell the assembler to treat all warnings as errors. This means that the exit status of the assembler will be non-zero after one or more assembler warnings. As a consequence, the assembler now also stops after encountering a warning.
You can also limit this option to specific warnings by specifying a comma-separated list of warning numbers.
Related information
Assembler option --no-warnings (Suppress some or all warnings)
510
Tải xuống
Đã cập nhật liên kết công khai
Liên kết công khai đến cuộc trò chuyện của bạn đã được cập nhật. You may view and manage your chat links after registration here.
Liên kết công khai tài liệu
Quảng cáo
