Chapters

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

APPENDICES

A. Flexible License Manager (FLEXlm)

MANUAL PURPOSE AND STRUCTURE

Windows Users

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.

UNIX Users

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.

Structure

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.

Short Table of Contents

Chapter 1: Software Installation and Configuration

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.

Chapter 2: Getting Started

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.

Chapter 3: TriCore C Language

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.

Chapter 4: TriCore Assembly Language

Describes the specific features of the TriCore assembly language as well as 'directives', which are pseudo instructions that are interpreted by the assembler.

Chapter 5: Using the Compiler

Describes how you can use the compiler. An extensive overview of all options is included in the Reference Guide.

Chapter 6: Using the Assembler

Describes how you can use the assembler. An extensive overview of all options is included in the Reference Guide.

Chapter 7: Using the Linker

Describes how you can use the linker. An extensive overview of all options is included in the Reference Guide.

Chapter 8: Using the Utilities

Describes several utilities and how you can use them to facilitate various tasks. The following utilities are included: control program, make utility and archiver.

Appendix A: Flexible Licence Manager (FLEXlm)

TASKING products are licensed through FLEXlm. This chapter provides information about this license system and how to solve possible problems.

CONVENTIONS USED IN THIS MANUAL

Notation for syntax

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.

Example

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:

Not valid is:

According to the syntax description, you have to specify a filename.

Icons

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.

RELATED PUBLICATIONS

C Standards

MISRA C

TASKING Tools

TriCore


Copyright © 2003 Altium BV