Texas Instruments TMS470R1x - Manuals

If You Need Assistance vi 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...

Contents vii 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...

Contents viii 3 Setting Up the Code Generation Tools With SunOS 3-1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Provides installation instructions for the code generation tools for SPARCstations runningSunOS. 3.1 System Requirements 3-2 . . . . . . . . . . . . . . . . . . . . . ....

Contents ix 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 . . . . . . . . . ....

1-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 generationtools and set up your code-development environment on a 32-bit x86-basedor Pentium PC running MS-DOS, PC-DOS, or Windows 3.1x. These toolsinclude an optimizin...

System Requirements 1-2 1.1 System Requirements To install and use the code generation tools, you need the items listed in thefollowing 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 h...

Installing the Code Generation Tools 1-3 Setting Up the Code Generation Tools With DOS or Windows 3.1x 1.2 Installing the Code Generation Tools This section helps you install the code generation tools on your hard-disksystem. The code generation tools package is shipped on CD-ROM. Theinstallation in...

Setting Up the Code Generation Environment 1-4 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. Anenvironment variable is a special system symbol tha...

Setting Up the Code Generation Environment 1-6 Setting default shell options (C_OPTION) You might find it useful to set the compiler, assembler, and linker shell defaultoptions using the C_OPTION environment variable. If you do this, the shelluses the default options and/or input filenames that you ...

Setting Up the Code Generation Environment 1-7 Setting Up the Code Generation Tools With DOS or Windows 3.1x Specifying a temporary file directory (TMP) The compiler shell program creates intermediate files as it processes yourprogram. By default, the shell puts intermediate files in the current dir...

Performance Considerations 1-8 1.4 Performance Considerations You may notice a speed degradation when you use the code generation toolswith DOS or Windows 3.1x. This speed degradation may occur when you useDOS with the tools to get appropriate host memory support. If you encounter error messages whe...

2-1 Setting Up the Code Generation Tools With Windows 95 and Windows NT This chapter helps you install release 1.20 of the TMS470R1x code generationtools and set up your code-development environment on a 32-bit x86-basedor Pentium PC running Windows 95 or Windows NT  . These tools include an optimi...

System Requirements 2-2 2.1 System Requirements To install and use the code generation tools, you need the items listed in thefollowing hardware and software checklists. Hardware checklist Host 32-bit x86-based or Pentium based PC with an ISA/EISA bus Memory Minimum of 16M bytes of RAM plus 32M byte...

Installing the Code Generation Tools 2-3 Setting Up the Code Generation Tools With Windows 95 and Windows NT 2.2 Installing the Code Generation Tools This section helps you install the code generation tools on your hard-disk sys-tem. The code generation tools package is shipped on CD-ROM. To install...

Setting Up the Code Generation Environment 2-6 Identifying alternate directories for the compiler to search (C_DIR) The compiler uses the C_DIR environment variable to name alternate direc-tories that contain #include files and function libraries. To set the C_DIR envi-ronment variable, use this syn...

Setting Up the Code Generation Environment 2-7 Setting Up the Code Generation Tools With Windows 95 and Windows NT For more information about shell options, see the TMS470R1x Optimizing C Compiler User’s Guide. For more information about linker options, see theTMS470R1x Assembly Language Tools User’...

Where to Go From Here 2-8 2.4 Where to Go From Here Your code generation tools are now installed on your Windows 95 or WindowsNT system. Now you should do each of the following tasks: - Turn to Chapter 5, Getting Started With the Code Generation Tools. This chapter provides you with an overview of h...

3-1 Setting Up the Code Generation Tools With SunOS This chapter helps you install release 1.20 of the TMS470R1x code generationtools and set up your code-development environment on a SPARCstation run-ning SunOS  version 4.1.x (or higher) or Solaris  version 2.5.x (or higher). These tools include ...

Installing the Code Generation Tools 3-3 Setting Up the Code Generation Tools With SunOS 3.2 Installing the Code Generation Tools This section helps you install the code generation tools on your hard-disk sys-tem. The software package is shipped on a CD-ROM. To install the tools ona SPARCstation run...

Installing the Code Generation Tools 3-4 Copying the files Be sure you are not logged on as root. After you mount the CD-ROM, you mustcreate the directory that will contain the tools software and copy the softwareto that directory. 1) Create a tools directory on your hard disk. To create this direct...

Setting Up the Code Generation Environment 3-8 (Be sure to enclose the options within quotes.) Environment variable options are specified in the same way and have thesame meaning as they do on the command line. For example, if you want toalways run quietly (the –q option), enable C source interlisti...

Setting Up the Code Generation Environment 3-9 Setting Up the Code Generation Tools With SunOS To set the TMP environment variable, use this syntax: - For C shells: setenv TMP ” pathname” - For Bourne or Korn shells: TMP=” pathname” export TMP (Be sure to enclose the directory name within quotes.) F...

Where to Go From Here 3-10 Verifying that the environment variables are set To verify that the environment variables are set, enter: set This command lists the path and environment variables and their currentvalues. 3.4 Where to Go From Here Your code generation tools are now installed. Now you shou...

4-1 Setting Up the Code Generation Tools on an HP Workstation This chapter helps you install release 1.20 of the TMS470R1x code generationtools and set up your code-development environment on an HP 9000 Series700  PA-RISC  computer with HP-UX  9.0x. These tools include an optimiz- ing C compiler ...

System Requirements 4-2 4.1 System Requirements To install and use the code generation tools, you need the items in the followinghardware and software checklists. Hardware checklist Host An HP 9000 Series 700 PA-RISC computer Display Monochrome or color monitor (color recommended) Disk space 4M byte...

Installing the Code Generation Tools 4-3 Setting Up the Code Generation Tools on an HP Workstation 4.2 Installing the Code Generation Tools This section helps you install the code generation tools on your hard-disk sys-tem. The software package is shipped on a CD-ROM. To install the tools onan HP wo...

Installing the Code Generation Tools 4-4 Setting up the software tools using a C shell If you are using a C shell, enter the following: setenv C_DIR ” tool_dir” setenv A_DIR ” tool_dir” set path=( tool_dir $path) You can move the setenv and set path commands into your .login or .cshrcfile to avoid e...

5-1 Getting Started With the Code Generation Tools This chapter helps you start using the assembler, linker, and compiler byproviding a quick walkthrough of these tools. For more information aboutinvoking and using these tools, see the TMS470R1x Assembly Language Tools User’s Guide and the TMS470R1x...

Getting Started With the Assembler and Linker 5-3 Getting Started With the Code Generation Tools 3) Now enter the following command to assemble file2.asm: asm470 file2.asm –l This time, the assembler creates an object file called file2.obj. The –l(lowercase L) option tells the assembler to create a ...

Getting Started With the Assembler and Linker 5-5 Getting Started With the Code Generation Tools The two files, file1 and file2, can be linked together with or without a com-mand file. However, using a command file allows you to configure yourmemory using the MEMORY and SECTIONS directives: - The ME...

Getting Started With the C Compiler 5-7 Getting Started With the Code Generation Tools 5.2 Getting Started With the C Compiler The TMS470R1x C compiler consists of many phases, including parsing, opti-mization, and code generation. The simplest way to compile is to use the shellprogram, which is inc...

6-1 Release Notes Release Notes This chapter describes the media contents of the TMS470R1x tools kit. Thetools are supported on SPARCstations, HP workstations, and PCs with DOS,Windows 3.1x, Windows 95, or Windows NT. This chapter also contains documentation of tools and features that are newor have...

Media Contents 6-2 6.1 Media Contents The CD-ROM included in the TMS470R1x tools kit for SPARCstations and HPworkstations contains the files listed in Table 6–1. The CD-ROM included inthe TMS470R1x tools kit for PCs contains the files listed in Table 6–2. Table 6–1. Media Contents for SPARCstations ...

Media Contents 6-3 Release Notes Table 6–2. Media Contents for PCs File Description readme.1st Online release bulletin abs470.exe Absolute lister ac470.exe ANSI C parser ar470.exe Archiver asm470.exe Assembler cg470.exe Code generator cl470.exe Compiler shell program clist.exe C source interlist uti...

Release Enhancements 6-4 6.2 Release Enhancements Release 1.20 of the TMS470R1x code generation tools contains generalenhancements as well as enhancements specific to the assembler andcompiler. The following sections list these enhancements. General enhancements The TMS470R1x general enhancements in...

Release Enhancements 6-5 Release Notes The section in which the entry point of a C program is defined cannot bemarked as a conditionally linked section. The compiler marks all functionveneers as conditionally linked. You must link with the –a linker option, which creates an absolute, execut-able out...

A-1 Troubleshooting DOS Systems Appendix A Troubleshooting DOS Systems DOS/4GW  is a memory manager that is embedded into the DOS version of the TMS470R1x code generation tools, so you may occasionally seeDOS/4GW error messages while you are using the tools. The executable filesfor DOS/4GW are not ...

Troubleshooting in the Protected-Mode Environment A-2 A.1 Troubleshooting in the Protected-Mode Environment Getting 32-bit programs to execute properly under DOS can be frustrating.Your computer’s configuration and memory management can cause problemsthat may be difficult to find because many progra...

Troubleshooting in the Protected-Mode Environment A-3 Troubleshooting DOS Systems The PMINFO32.EXE program Purpose: Run PMINFO.EXE to determine the performance of protected/real-mode switching and extended memory. Notes: The time-based measurements made by PMINFO may varyslightly from run to run. If...

Troubleshooting in the Protected-Mode Environment A-4 PMINFO provides the information shown in Table A–1. Table A–1. PMINFO Fields Measurement Purpose CPU performance Shows the CPU processor equivalent and the speed of the CPU (in MHz) According to BIOS Shows the configured memory in DOS and extende...

Kernel Error Messages A-5 Troubleshooting DOS Systems A.2 Kernel Error Messages This section describes error messages from the DOS/16M kernel embeddedin the TMS470R1x code generation tools. Kernel error messages can occurbecause of severe resource shortages, corruption of the executable file, cor-ru...

Kernel Error Messages A-6 9: cannot allocate tstack Description There is not enough memory to load DOS/4G. Action Make more memory available and try again. 10: cannot allocate memory for GDT Description There is not enough memory to load DOS/4G. Action Make more memory available and try again. 11: n...

Kernel Error Messages A-7 Troubleshooting DOS Systems 17: system software does not follow VCPI or DPMI specifications Description Some memory-resident program has put your 386 or 486CPU into virtual 8086 mode. This is done to provide specialmemory services to DOS programs, such as EMS simulation(EMS...

Kernel Error Messages A-8 29: memory error, out of range Description Memory was probably corrupted during execution of yourprogram. Writing through an invalid or stale alias selector maycause this error. Action Check your source code for references to variables that arenot declared or are no longer ...

DOS/4G Error Messages A-9 Troubleshooting DOS Systems A.3 DOS/4G Error Messages DOS/4G errors are more common than kernel errors when using DOS/4G orDOS/4GW with the TMS470R1x code generation tools. They are usually re-lated to an unknown path name, corrupt files, or memory problems. Memoryproblems ...

DOS/4G Error Messages A-10 3301 ”unhandled EMPTYFWD, GATE16, or unknown relocation”3302 ”unhandled ALIAS16 reference to unaliased object”3304 ”unhandled or unknown relocation” Description If your program was built for another platform that supportsthe LINEXE format, it may contain a construct that D...

Glossary B-1 Glossary Appendix A Glossary A asm470: The name of the command that invokes the assembler for the TMS470R1x. assembler: A software program that creates a machine-language program from a source file that contains assembly language instructions, direc-tives, and macro definitions. The ass...

Glossary B-2 DOS/4GW: A memory extender that is bound with the DOS version of the TMS470R1x code generation tools. The executable DOS/4GW file is not shipped separately but is embedded within the other executables. Errormessages from DOS/4GW are included in Appendix A, Troubleshooting DOS Systems, t...

Index Index-1 Index @ shell option 6-5 A A_DIR environment variable for DOS systems 1-5 for HP workstations 4-6 for SPARCstations 3-6 to 3-7 for Windows 3.1x systems 1-5 for Windows 95/NT systems 2-5 asm470 definition B-1 invoking 5-2 assembler, definition B-1 assembler walkthrough 5-2 to 5-4 assist...