1. Software Installation
2. Getting Started
3. TriCore C Language
4. TriCore Assembly Language
5. Using the Compiler
6. Using the Assembler
7. Using the Linker
8. Using the Utilities
A. Flexible License Manager (FLEXlm)
The documentation explains and describes how to use the TriCore toolchain to program a TriCore DSP. The documentation is primarily aimed at Windows users. You can use the tools either with the graphical Embedded Development Environment (EDE) or from the command line in a command prompt window.
For UNIX the toolchain works the same as it works for the Windows command line.
Directory paths are specified in the Windows way, with back slashes as in .\include. Simply replace the back slashes by forward slashes for use with UNIX: ./include.
Some characters have a special meaning in a UNIX shell. In such cases you must escape the special characters. For example, '-?' must be specified as '-\?' in some shells. See your UNIX documentation for more information.
The toolchain documentation consists of a User's Guide (this manual) which includes a Getting Started section and a separate Reference Guide.
First you need to install the software and make it run under the licence manager FLEXlm. This is described in Chapter 1 , Software Installation and Configuration
After installation you are ready to follow the Getting Started in Chapter 2.
Next, move on with the other chapters which explain how to use the compiler, assembler, linker and the various utilities.
Once you are familiar with these tools, you can use the Reference Guide to lookup specific options and details to make full use of the TriCore toolchain.
Guides you through the installation of the software. Describes the most important settings, paths and filenames that you must specify to get the package up and running.
Overview of the toolchain and its individual elements. Describes the relation between the toolchain and specific features of the TriCore. Explains step-by-step how to write, compile, assemble and debug your application. Teaches how you can use projects to organize your files.
The TriCore C compiler is fully compatible with ISO-C. This chapter describes the specific TriCore features of the C language, including language extensions that are not standard in ISO-C. For example, pragmas are a way to control the compiler from within the C source.
Describes the specific features of the TriCore assembly language as well as 'directives', which are pseudo instructions that are interpreted by the assembler.
Describes how you can use the compiler. An extensive overview of all options is included in the Reference Guide.
Describes how you can use the assembler. An extensive overview of all options is included in the Reference Guide.
Describes how you can use the linker. An extensive overview of all options is included in the Reference Guide.
Describes several utilities and how you can use them to facilitate various tasks. The following utilities are included: control program, make utility and archiver.
TASKING products are licensed through FLEXlm. This chapter provides information about this license system and how to solve possible problems.
The following notation is used to describe the syntax of command line input:
bold Type this part of the syntax literally.
italics Substitute the italic word by an instance. For example:
filename
Type the name of a file in place of the word filename.
{ } Encloses a list from which you must choose an item.
[ ] Encloses items that are optional. For example
ctc [ -? ]
Both ctc and ctc -? are valid commands.
| Separates items in a list. Read it as OR.
... You can repeat the preceding item zero or more times.
,... You can repeat the preceding item zero or more times, separating each item with a comma.
You can read this line as follows: enter the command ctc with or without an option, follow this by zero or more options and specify a filename. The following input lines are all valid:
ctc test.c ctc -g test.c ctc -g -E test.c
Not valid is:
ctc -g
According to the syntax description, you have to specify a filename.
The following illustrations are used in this manual:
Note: notes give you extra information.
Warning: read the information carefully.
It prevents you from making serious mistakes or from loosing information.
This illustration indicates actions you can perform with
the mouse. Such as EDE menu entries and dialogs.
Command line: type your input on the
command line.
Reference: follow this reference to
find related topics.