Summary of the content on the page No. 1
Getting Started
Guide
1997 Microcontroller Products
Summary of the content on the page No. 2
Printed in U.S.A., March 1997 SPNU117B M414003-9741 revision B
Summary of the content on the page No. 3
TMS470R1x Code Generation Tools Getting Started Guide Release 1.20 Literature Number: SPNU117B Manufacturing Part Number: M414003-9741 revision B March 1997 Printed on Recycled Paper
Summary of the content on the page No. 4
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. Testi
Summary of the content on the page No. 5
Preface Read This First About This Manual The TMS470R1x Code Generation Tools Getting Started Guide tells you how to install release 1.20 of the TMS470R1x code generation tools on your sys- tem. 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 fil
Summary of the content on the page No. 6
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 direc- tory. In syntax descriptions, the instruction, command, or directive is in a bold typeface font and parameters are in an italic typeface. Portions of a syntax that are in bold should be entered as shown
Summary of the content on the page No. 7
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
Summary of the content on the page No. 8
If You Need Assistance If You Need Assistance . . . World-Wide Web 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 (28
Summary of the content on the page No. 9
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 . . . . . .
Summary of the content on the page No. 10
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
Summary of the content on the page No. 11
Contents 5 Getting Started With the Code Generation Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 Provides an overview of how to invoke and use the assembler, linker, and compiler. 5.1 Getting Started With the Assembler and Linker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 5.2 Getting Started With the C Compiler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7 6 Release Notes . . . . . . . . . .
Summary of the content on the page No. 12
x
Summary of the content on the page No. 13
Chapter 1 Setting Up the Code Generation Tools With DOS or Windows 3.1x This chapter helps you install release 1.20 of the TMS470R1x code generation tools and set up your code-development environment on a 32-bit x86-based or Pentium PC running MS-DOS, PC-DOS, or Windows 3.1x. These tools include an optimizing C compiler and a full set of assembly language tools for developing and manipulating assembly language and object (executable) code. The C compiler tools are composed of the following compo
Summary of the content on the page No. 14
System Requirements 1.1 System Requirements To install and use the code generation tools, you need the items listed in the following hardware and software checklists. Hardware checklist Host 32-bit x86-based or Pentium based PC with an ISA/EISA bus Memory 4M–16M bytes of RAM plus 32M bytes of hard-disk space for temporary files and 4M bytes of hard-disk space for the code generation tools Display Monochrome or color monitor (color recommended) Required hardware CD-ROM drive Optional hardware Mi
Summary of the content on the page No. 15
Installing the Code Generation Tools 1.2 Installing the Code Generation Tools This section helps you install the code generation tools on your hard-disk system. The code generation tools package is shipped on CD-ROM. The installation instructions vary according to your operating system. Installing the tools on DOS systems To install the tools on a DOS system, follow these steps: 1) Insert the TMS470R1x Code Generation Tools CD-ROM into your CD-ROM drive. 2) Change to the CD-ROM drive (where d: i
Summary of the content on the page No. 16
Setting Up the Code Generation Environment 1.3 Setting Up the Code Generation Environment Before or after you install the code generation tools, you can define environ- ment variables that set certain software tool parameters you normally use. An environment variable is a special system symbol that you define and associate to a string. A program uses this symbol to find or obtain certain types of information. When you use environment variables, default values are set, making each individual invo
Summary of the content on the page No. 17
Setting Up the Code Generation Environment Identifying the directory that contains the executable files (PATH statement) You must include the tool_dir directory in your PATH statement so that you can specify the assembler and compiler tools without specifying the name of the directory that contains the executable files. If you modify your autoexec.bat file to change the path information, add the following to the end of the PATH statement: ;c:\tool_dir If you set the PATH statement from the c
Summary of the content on the page No. 18
Setting Up the Code Generation Environment Setting default shell options (C_OPTION) You might find it useful to set the compiler, assembler, and linker shell default options using the C_OPTION environment variable. If you do this, the shell uses the default options and/or input filenames that you name with C_OPTION every time you run the shell. Setting the default options with the C_OPTION environment variable is useful when you want to run the shell consecutive times with the same set of option
Summary of the content on the page No. 19
Setting Up the Code Generation Environment Specifying a temporary file directory (TMP) The compiler shell program creates intermediate files as it processes your program. By default, the shell puts intermediate files in the current directory. However, you can name a specific directory for temporary files by using the TMP environment variable. Using the TMP environment variable allows use of a RAM disk or other file systems. It also allows source files to be compiled from a remote directory with
Summary of the content on the page No. 20
Performance Considerations Performance Considerations / Where to Go From Here 1.4 Performance Considerations You may notice a speed degradation when you use the code generation tools with DOS or Windows 3.1x. This speed degradation may occur when you use DOS with the tools to get appropriate host memory support. If you encounter error messages when you use the tools on a PC with DOS, run PMINFO to determine your system configuration before you contact tech- nical support. For more information ab
