Page 5 - Preface; Read This First; About This Manual; special typeface; bold version; italics
iii 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 parameter...
Page 6 - mkdir; Related Documentation From Texas Instruments; TMS470R1x Optimizing C Compiler User’s Guide (literature number
Notational Conventions / Related Documentation From Texas Instruments iv 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 asshown in bold and replace tool_dir with the name of your tools direc- t...
Page 7 - TMS470R1x C Source Debugger User’s Guide (literature number; Trademarks; Pentium is a trademark of Intel Corporation.
Related Documentation From Texas Instruments / Trademarks v Read This First TMS470R1x C Source Debugger User’s Guide (literature number SPNU124) describes the TMS470R1x emulator and simulator versionsof the C source debugger interface. This book discusses various aspectsof the debugger interface, in...
Page 8 - North America, South America, Central America
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...
Page 9 - Contents; Setting Up the Code Generation Tools With DOS or Windows 3.1x
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...
Page 10 - Setting Up the Code Generation Tools With SunOS
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 . . . . . . . . . . . . . . . . . . . . . ....
Page 11 - Getting Started With the Code Generation Tools
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 . . . . . . . . . ....
Page 13 - Topic; Chapter 1
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...
Page 14 - Hardware checklist; based PC with an ISA/EISA bus; Software checklist; One of these operating systems:; TMS470R1x Code Generation Tools
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...
Page 15 - Installing the Code Generation Tools; Installing the tools on DOS systems; To install the tools on a DOS system, follow these steps:; install; Installing the tools on Windows 3.1x systems; To install the tools on a Windows 3.1x system, follow these steps:
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...
Page 16 - Setting Up the Code Generation Environment; TMP
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...
Page 18 - option
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 ...
Page 19 - Specifying a temporary file directory (TMP); To set the TMP environment variable, use this syntax:; Resetting defined environment variables; Verifying that the environment variables are set; set
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...
Page 20 - Performance Considerations
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...
Page 21 - Chapter 2
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...
Page 22 - Monochrome or color monitor (color recommended)
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...
Page 23 - TMS470R1x Code Generation Tools CD-ROM into your CD-
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...
Page 26 - pathname
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...
Page 27 - For more information about shell options, see the
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’...
Page 28 - Where to Go From Here; Getting Started With the Code Generation Tools. This
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...
Page 29 - Chapter 3
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 ...
Page 31 - must have root privileges to
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...
Page 32 - Copying the files; ) Create a tools directory; Unmounting the CD-ROM; You must unmount the CD-ROM after copying the files.
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...
Page 36 - setenv C_OPTION ”–qs –z”
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...
Page 37 - setenv TMP ”; Reinitializing your shell; unsetenv
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...
Page 38 - To verify that the environment variables are set, enter:
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...
Page 39 - Chapter 4
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 ...
Page 40 - Root privileges to mount and unmount the CD-ROM
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...
Page 41 - exit
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...
Page 42 - Setting up the software tools using a C shell; If you are using a C shell, enter the following:; Setting up the software tools using a Korn shell; If you are using a Bourne or Korn shell, enter the following:
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...
Page 49 - TMS470R1x Assembly Language; Chapter 5
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...
Page 51 - lnk470 file1 file2 –m lnker2.map –o prog.out
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 ...
Page 53 - TMS470R1x Assembly Language Tools User’s Guide for more in-
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...
Page 55 - Getting Started With the C Compiler; Optimizing C Compiler User’s Guide.; cl470 –o –k function
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...
Page 57 - Release Notes; Chapter 6
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...
Page 58 - Table 6–1. Media Contents for SPARCstations and HP Workstations
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 ...
Page 59 - Table 6–2. Media Contents for PCs
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...
Page 60 - Release Enhancements; General enhancements; The TMS470R1x general enhancements include the following items:; Using Version 1 COFF; Assembler enhancements; The TMS470R1x assembler enhancements are as follows:
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...
Page 61 - C compiler enhancements
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...
Page 63 - Appendix A; is a memory manager that is embedded into the DOS version of; Appendix A
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 ...
Page 64 - A.1 Troubleshooting in the Protected-Mode Environment; When an
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...
Page 65 - The PMINFO32.EXE program; If this error message appears:
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...
Page 66 - PMINFO provides the information shown in Table A–1.; Table A–1. PMINFO Fields
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...
Page 67 - A.2 Kernel Error Messages; : involuntary switch to real mode
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...
Page 68 - : cannot allocate tstack
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...
Page 69 - 7: system software does not follow VCPI or DPMI specifications
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...
Page 70 - 5: general protection fault
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 ...
Page 71 - 000 ”can’t hook interrupts”
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 ...
Page 72 - Description
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...
Page 73 - Glossary; Appendix B
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...
Page 74 - environment variables:
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...
Page 77 - Index
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...
