Chapters

1. TriCore C Language
2. Libraries
3. TriCore Assembly Language
4. Tools Options
5. List File Formats
6. Object File Formats
7. Linker Script Language
8. CPU Functional Problems
9. MISRA C Rules

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 \ctc\bin. Simply replace the back slashes by forward slashes for use with UNIX: /ctc/bin.

Structure

The TriCore documentation consists of a User's Guide which includes a Getting Started section and a separate Reference Guide (this manual).

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, of the User's Guide.

After installation you are ready to follow the Getting Started in Chapter 2 of the User's Guide.

Next, move on with the other chapters in the User's Guide 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 fully use of the TriCore toolchain.

Short Table of Contents

Chapter 1: TriCore C Language

Contains overviews of all language extensions:

Chapter 2: Libraries

Contains overviews of all library functions you can use in your C source. First libraries are listed per header file that contains the prototypes. These tables also show the level of implementation per function. Second, all library functions are listed and discussed into detail.

Chapter 3: TriCore Assembly Language

Contains an overview of all assembly functions that you can use in your assembly source code.

Chapter 4: Tool Options

Contains a description of all tool options:

Chapter 5: List File Formats

Contains a description of the following list file formats:

Chapter 6: Object File Formats

Contains a description of the following object file formats:

Chapter 7: Linker Script Language

Contains a description of the linker script language (LSL).

Chapter 8: CPU Functional Problems

Contains a description of the TASKING TriCore toolchain software solutions for functional problems and deviations from the electrical specifications and timing specifications for some TriCore derivatives.

Chapter 9: MISRA C Rules

Contains a description the supported and unsupported MISRA C code checking rules.

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