Texas Instruments Code Generation Tools TMS470R1x User Manual

Size:
286.7 Kb
Download

TMS470R1x

Code Generation Tools

Release 1.20

Getting Started

Guide

1997

Microcontroller Products

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Printed in U.S.A., March 1997

SPNU117B

 

 

 

M414003-9741revision B

 

 

 

 

 

 

 

 

 

 

 

 

TMS470R1x Code Generation Tools

Getting Started Guide

Release 1.20

Literature Number: SPNU117B

Manufacturing Part Number: M414003-9741revision B

March 1997

Printed on Recycled Paper

IMPORTANT NOTICE

Texas Instruments (TI) reserves the right to make changes to its products or to discontinue any semiconductor product or service without notice, and advises its customers to obtain the latest version of relevant information to verify, before placing orders, that the information being relied on is current.

TI warrants performance of its semiconductor products and related software to the specifications applicable at the time of sale in accordance with TI's standard warranty. Testing and other quality control techniques are utilized to the extent TI deems necessary to support this warranty. Specific testing of all parameters of each device is not necessarily performed, except those mandated by government requirements.

Certain applications using semiconductor products may involve potential risks of death, personal injury, or severe property or environmental damage (ªCritical Applicationsº).

TI SEMICONDUCTOR PRODUCTS ARE NOT DESIGNED, INTENDED, AUTHORIZED, OR WARRANTED TO BE SUITABLE FOR USE IN LIFE-SUPPORTAPPLICATIONS, DEVICES OR SYSTEMS OR OTHER CRITICAL APPLICATIONS.

Inclusion of TI products in such applications is understood to be fully at the risk of the customer. Use of TI products in such applications requires the written approval of an appropriate TI officer. Questions concerning potential risk applications should be directed to TI through a local SC sales office.

In order to minimize risks associated with the customer's applications, adequate design and operating safeguards should be provided by the customer to minimize inherent or procedural hazards.

TI assumes no liability for applications assistance, customer product design, software performance, or infringement of patents or services described herein. Nor does TI warrant or represent that any license, either express or implied, is granted under any patent right, copyright, mask work right, or other intellectual property right of TI covering or relating to any combination, machine, or process in which such semiconductor products or services might be or are used.

Copyright 1997, Texas Instruments Incorporated

Preface

Read This First

About This Manual

The TMS470R1x Code Generation Tools Getting Started Guidetells you how to install release 1.20 of the TMS470R1x code generation tools on your system. It also provides the following information:

-Tells you how to set environment variables for parameters that you use often

-Gets you started using the compiler, linker, and assembler

-Provides a list of the media contents for your tools set, so you will know what information is associated with each file you have installed

-Details enhancements in this release and tells you where to find further information

-Describes how you can resolve problems that you may encounter on a PC running DOS (MS-DOSorPC-DOS)

Notational Conventions

In this document, the following notational conventions are used:

-Program listings, program examples, and interactive displays are shown in a special typeface. Examples use abold version of the special typeface for emphasis. Interactive displays usebold to distinguish commands that you enter from items that the system displays (such as prompts, command output, error messages, etc.). Some interactive displays useitalics to describe the type of information that should be entered.

Here is a sample program listing:

0011

0005

0001

.field

1, 2

0012

0005

0003

.field

3,

4

0013

0005

0006

.field

6,

3

0014

0006

 

.even

 

 

iii

Notational Conventions / Related Documentation From Texas Instruments

Here is an example of a command that you might enter:

set PATH=c:\tool_dir;%PATH%

To change your path statement to use the tools, enter the command text as shown in bold and replace tool_dir with the name of your tools directory.

-In syntax descriptions, the instruction, command, or directive is in a bold typeface font and parameters are in anitalic typeface. Portions of a syntax that are inbold should be entered as shown; portions of a syntax that are initalics describe the type of information that should be entered.

Here is an example of a command that you might use: mkdir tool_dir

In this example, you would type mkdir, as shown, and replace tool_dir with the name of your directory.

-Square brackets ( [ and ] ) identify an optional parameter. If you use an optional parameter, you specify the information within the brackets; you don't enter the brackets themselves. Here's an example of a command that has optional parameters:

SET C_DIR=pathname1 [;pathname2 . . .]

Setting the C_DIR environment variable allows you to specify one or more pathnames for the C compiler to search.

Related Documentation From Texas Instruments

The following books describe the TMS470R1x and related support tools. To obtain a copy of any of these TI documents, call the Texas Instruments Literature Response Center at (800) 477±8924. When ordering, please identify the book by its title and literature number.

TMS470R1x Assembly Language Tools User's Guide (literature number SPNU118) describes the assembly language tools (assembler, linker, and other tools used to develop assembly language code), assembler directives, macros, common object file format, and symbolic debugging directives for the TMS470R1x devices.

TMS470R1x Optimizing C Compiler User's Guide (literature number SPNU119) describes the TMS470R1x C compiler. This C compiler accepts ANSI standard C source code and produces assembly language source code for the TMS470R1x devices.

iv

Related Documentation From Texas Instruments / Trademarks

TMS470R1x C Source Debugger User's Guide (literature number SPNU124) describes the TMS470R1x emulator and simulator versions of the C source debugger interface. This book discusses various aspects of the debugger interface, including window management, command entry, code execution, data management, and breakpoints. It also includes a tutorial that introduces basic debugger functionality.

TMS470R1x User's Guide (literature number SPNU134) describes the TMS470R1x RISC microcontroller, its architecture (including registers), ICEBreaker module, interfaces (memory, coprocessor, and debugger),16-bitand32-bitinstruction sets, and electrical specifications.

Trademarks

DOS/4G is a trademark of Tenberry Software, Inc.

HP-UX,HP 9000 Series 700, andPA-RISCare trademarks of HewlettPackard Company.

IBM, PC, and PC-DOSare trademarks of International Business Machines Corp.

MS-DOS,Windows, and Windows NT are registered trademarks of Microsoft Corp.

OpenWindows, SunOS, and Solaris are trademarks of Sun Microsystems, Inc.

Pentium is a trademark of Intel Corporation.

SPARCstation is trademark of SPARC International, Inc., but licensed exclusively to Sun Microsystems, Inc.

UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Limited.

X Window System is a trademark of the Massachusetts Institute of Technology.

Read This First

v

If You Need Assistance

If You Need Assistance . . .

- World-WideWeb Sites

TI Online

http://www.ti.com

Semiconductor Product Information Center (PIC)

http://www.ti.com/sc/docs/pic/home.htm

Microcontroller Home Page

http://www.ti.com/sc/micro

- North America, South America, Central America

Product Information Center (PIC)

 

(972) 644-5580

 

 

TI Literature Response Center U.S.A.

 

(800) 477-8924

 

 

Software Registration/Upgrades

 

(214) 638-0333

Fax: (214) 638-7742

 

U.S.A. Factory Repair/Hardware Upgrades

(281) 274-2285

 

 

U.S. Technical Training Organization

 

(972) 644-5580

 

 

Microcontroller Hotline

 

(281) 274-2370

Fax: (281) 274-4203

Email: micro@ti.com

Microcontroller Modem BBS

(281) 274-37008-N-1

 

 

- Europe, Middle East, Africa

European Product Information Center (EPIC) Hotlines:

 

 

Multi-LanguageSupport

+33

1 30 70 11 69

Fax: +33

1 30 70 10 32 Email: epic@ti.com

Deutsch

+49 8161 80 33 11 or +33 1 30 70 11 68

 

 

English

 

+33 1 30 70 11 65

 

 

Francais

 

+33 1 30 70 11 64

 

 

Italiano

 

+33 1 30 70 11 67

 

 

EPIC Modem BBS

 

+33 1 30 70 11 99

 

 

European Factory Repair

+33 4 93 22 25 40

 

 

Europe Customer Training Helpline

 

 

Fax: +49

81 61 80 40 10

- Asia-Pacific

Literature Response Center +852 2 956 7288 Fax: +852 2 956 2200

- Japan

Product Information Center

+0120-81-0026(in Japan)

Fax:

+0120-81-0036(in Japan)

+03-3457-0972or (INTL)813-3457-0972

Fax:

+03-3457-1259or (INTL)813-3457-1259

- Documentation

When making suggestions or reporting errors in documentation, please include the following information that is on the title page: the full title of the book, the publication date, and the literature number.

Mail: Texas Instruments Incorporated

Email: comments@books.sc.ti.com

Technical Documentation Services, MS 702

 

P.O. Box 1443

 

Houston, Texas 77251-1443

 

Note: When calling a Literature Response Center to order documentation, please specify the literature number of the book.

vi

Contents

Contents

1 Setting Up the Code Generation Tools With DOS or Windows 3.1x . . . . . . . . . . . . . . . . . . 1-1

Provides installation instructions for PCs running DOS or Windows 3.1x.

1.1

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-2

 

Hardware checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-2

 

Software checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-2

1.2

Installing the Code Generation Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-3

 

Installing the tools on DOS systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-3

 

Installing the tools on Windows 3.1x systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-3

1.3

Setting Up the Code Generation Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-4

 

Identifying the directory that contains the executable files (PATH statement) . . . . . . . .

1-5

 

Identifying alternate directories for the assembler to search (A_DIR) . . . . . . . . . . . . . .

1-5

 

Identifying alternate directories for the compiler to search (C_DIR) . . . . . . . . . . . . . . . .

1-5

 

Setting default shell options (C_OPTION) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-6

 

Specifying a temporary file directory (TMP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-7

 

Resetting defined environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-7

 

Verifying that the environment variables are set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-7

1.4

Performance Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-8

1.5

Where to Go From Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-8

2 Setting Up the Code Generation Tools With Windows 95 and Windows NT . . . . . . . . . . .

2-1

Provides installation instructions for the code generation tools for PCs running Windows 95 or Windows NT.

2.1

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-2

 

Hardware checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-2

 

Software checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-2

2.2

Installing the Code Generation Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-3

2.3

Setting Up the Code Generation Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-4

 

Identifying the directory that contains the executable files (PATH statement) . . . . . . . .

2-5

 

Identifying alternate directories for the assembler to search (A_DIR) . . . . . . . . . . . . . .

2-5

 

Identifying alternate directories for the compiler to search (C_DIR) . . . . . . . . . . . . . . . .

2-6

 

Setting default shell options (C_OPTION) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-6

 

Specifying a temporary file directory (TMP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-7

 

Resetting defined environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-7

 

Verifying that the environment variables are set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-7

2.4

Where to Go From Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-8

vii

Contents

3 Setting Up the Code Generation Tools With SunOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Provides installation instructions for the code generation tools for SPARCstations running SunOS.

3.1

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-2

 

Hardware checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-2

 

Software checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-2

3.2

Installing the Code Generation Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-3

 

Mounting the CD-ROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-3

 

Copying the files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-4

 

Unmounting the CD-ROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-4

3.3

Setting Up the Code Generation Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-5

 

Identifying the directory that contains the executable files (path statement) . . . . . . . . .

3-6

 

Identifying alternate directories for the assembler to search (A_DIR) . . . . . . . . . . . . . .

3-6

 

Identifying alternate directories for the compiler to search (C_DIR) . . . . . . . . . . . . . . . .

3-7

 

Setting default shell options (C_OPTION) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-7

 

Specifying a temporary file directory (TMP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-8

 

Reinitializing your shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-9

 

Resetting defined environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-9

 

Verifying that the environment variables are set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-10

3.4

Where to Go From Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-10

4 Setting Up the Code Generation Tools on an HP Workstation . . . . . . . . . . . . . . . . . . . . . . .

4-1

Provides installation instructions for HP 9000 Series 700 PA-RISCcomputers runningHP-UX.

4.1

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-2

 

Hardware checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-2

 

Software checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-2

4.2

Installing the Code Generation Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-3

 

Mounting the CD-ROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-3

 

Copying the files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-3

 

Setting up the software tools using a C shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-4

 

Setting up the software tools using a Korn shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-4

 

Unmounting the CD-ROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-4

4.3

Setting Up the Code Generation Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-5

 

Identifying the directory that contains the executable files (path statement) . . . . . . . . .

4-6

 

Identifying alternate directories for the assembler (A_DIR) . . . . . . . . . . . . . . . . . . . . . . .

4-6

 

Identifying alternate directories for the compiler (C_DIR) . . . . . . . . . . . . . . . . . . . . . . . . .

4-7

 

Setting default shell options (C_OPTION) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-7

 

Specifying a temporary file directory (TMP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-8

 

Reinitializing your shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-9

 

Resetting defined environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-9

 

Verifying that the environment variables are set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-10

4.4

Where to Go From Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-10

viii