Texas Instruments TMS320C2x, User Manual

Page: 9 / 250

Contents
ix
Contents
1 Introduction 1-1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Provides an overview of the TMS320C2x/C2xx/C5x software development tools, specifically,
the optimizing C Compiler.
1.1 Software Development Tools Overview 1-2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 C Compiler Overview 1-5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2 C Compiler Description 2-1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Describes how to operate the C compiler and the shell program. Contains instructions for invok-
ing the shell program, which compiles, assembles, and links a C source file. Discusses the in-
terlist utility and compiler errors.
2.1 About the Shell Program 2-2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 Invoking the Compiler Shell 2-4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3 Changing the Compiler’s Behavior With Options 2-6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.1 Frequently Used Options 2-13 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.2 Specifying Filenames 2-15 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.3 Changing How the Shell Program Interprets Filenames ( − fa, − fc, and − fo
Options) 2-15 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.4 Changing How the Shell Program Interprets and Names Extensions ( − ea
and − eo Options) 2-16 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.5 Specifying Directories 2-16 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.6 Options That Overlook ANSI C Type Checking 2-17 . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.7 Runtime-Model Options 2-18 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.8 Options That Control the Assembler 2-19 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4 Changing the Compiler’s Behavior With Environment Variables 2-20 . . . . . . . . . . . . . . . . . .
2.4.1 Setting Default Shell Options (C_OPTION) 2-20 . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4.2 Specifying a Temporary File Directory (TMP) 2-21 . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.5 Controlling the Preprocessor 2-22 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.5.1 Predefined Macro Names 2-22 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.5.2 The Search Path for #include Files 2-23 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.5.3 Changing the #include File Search Path With the − i Option 2-24 . . . . . . . . . . . . . .
2.5.4 Generating a Preprocessed Listing File ( − pl Option) 2-25 . . . . . . . . . . . . . . . . . . . . .
2.5.5 Creating Custom Error Messages with the #error and #warn Directives 2-26 . . . .
2.5.6 Enabling Trigraph Expansion ( − p? Option) 2-26 . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.5.7 Creating a Function Prototype Listing File ( − pf Option) 2-26 . . . . . . . . . . . . . . . . . .