Texas Instruments TMS470R1x User Manual

Getting StartedGuide1997 Microcontroller Products

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

Contentsix Contents5 Getting Started With the Code Generation Tools 5-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Provide

x

1-1Setting Up the Code GenerationTools With DOS or Windows 3.1xThis chapter helps you install release 1.20 of the TMS470R1x code generationtools and s

System Requirements 1-21.1 System RequirementsTo install and use the code generation tools, you need the items listed in thefollowing hardware and sof

Installing the Code Generation Tools1-3Setting Up the Code Generation Tools With DOS or Windows 3.1x1.2 Installing the Code Generation ToolsThis secti

Setting Up the Code Generation Environment 1-41.3 Setting Up the Code Generation EnvironmentBefore or after you install the code generation tools, you

Setting Up the Code Generation Environment1-5Setting Up the Code Generation Tools With DOS or Windows 3.1xIdentifying the directory that contains the

Setting Up the Code Generation Environment 1-6Setting default shell options (C_OPTION)You might find it useful to set the compiler, assembler, and lin

Setting Up the Code Generation Environment1-7Setting Up the Code Generation Tools With DOS or Windows 3.1xSpecifying a temporary file directory (TMP)T

Printed in U.S.A., March 1997M414003-9741 revision BSPNU117B

Performance Considerations 1-81.4 Performance ConsiderationsYou may notice a speed degradation when you use the code generation toolswith DOS or Windo

2-1Setting Up the Code Generation ToolsWith Windows 95 and Windows NTThis chapter helps you install release 1.20 of the TMS470R1x code generationtools

System Requirements 2-22.1 System RequirementsTo install and use the code generation tools, you need the items listed in thefollowing hardware and sof

Installing the Code Generation Tools2-3Setting Up the Code Generation Tools With Windows 95 and Windows NT2.2 Installing the Code Generation ToolsThis

Setting Up the Code Generation Environment 2-42.3 Setting Up the Code Generation EnvironmentBefore or after you install the code generation tools, you

Setting Up the Code Generation Environment2-5Setting Up the Code Generation Tools With Windows 95 and Windows NTIdentifying the directory that contain

Setting Up the Code Generation Environment 2-6Identifying alternate directories for the compiler to search (C_DIR)The compiler uses the C_DIR environm

Setting Up the Code Generation Environment2-7Setting Up the Code Generation Tools With Windows 95 and Windows NTFor more information about shell optio

Where to Go From Here 2-82.4 Where to Go From HereYour code generation tools are now installed on your Windows 95 or WindowsNT system. Now you should

3-1Setting Up the CodeGeneration Tools With SunOSThis chapter helps you install release 1.20 of the TMS470R1x code generationtools and set up your cod

TMS470R1x Code Generation ToolsGetting Started GuideRelease 1.20Literature Number: SPNU117BManufacturing Part Number: M414003-9741 revision BMarch 199

System Requirements 3-23.1 System RequirementsTo install and use the code generation tools, you need the items in the followinghardware and software c

Installing the Code Generation Tools3-3Setting Up the Code Generation Tools With SunOS3.2 Installing the Code Generation ToolsThis section helps you i

Installing the Code Generation Tools 3-4Copying the filesBe sure you are not logged on as root. After you mount the CD-ROM, you mustcreate the directo

Setting Up the Code Generation Environment3-5Setting Up the Code Generation Tools With SunOS3.3 Setting Up the Code Generation EnvironmentBefore or af

Setting Up the Code Generation Environment 3-6Identifying the directory that contains the executable files (path statement)You must include the tool_d

Setting Up the Code Generation Environment3-7Setting Up the Code Generation Tools With SunOSFor more information on the –i option, see the TMS470R1x A

Setting Up the Code Generation Environment 3-8(Be sure to enclose the options within quotes.)Environment variable options are specified in the same wa

Setting Up the Code Generation Environment3-9Setting Up the Code Generation Tools With SunOSTo set the TMP environment variable, use this syntax:For C

Where to Go From Here 3-10Verifying that the environment variables are setTo verify that the environment variables are set, enter:set This command lis

4-1Setting Up the Code GenerationTools on an HP WorkstationThis chapter helps you install release 1.20 of the TMS470R1x code generationtools and set u

IMPORTANT NOTICETexas Instruments (TI) reserves the right to make changes to its products or to discontinue any semiconductorproduct or service withou

System Requirements 4-24.1 System RequirementsTo install and use the code generation tools, you need the items in the followinghardware and software c

Installing the Code Generation Tools4-3Setting Up the Code Generation Tools on an HP Workstation4.2 Installing the Code Generation ToolsThis section h

Installing the Code Generation Tools 4-4Setting up the software tools using a C shellIf you are using a C shell, enter the following:setenv C_DIR ”too

Setting Up the Code Generation Environment4-5Setting Up the Code Generation Tools on an HP Workstation4.3 Setting Up the Code Generation EnvironmentBe

Setting Up the Code Generation Environment 4-6Identifying the directory that contains the executable files (path statement)You must include the tool_d

Setting Up the Code Generation Environment4-7Setting Up the Code Generation Tools on an HP WorkstationIdentifying alternate directories for the compil

Setting Up the Code Generation Environment 4-8Environment variable options are specified in the same way and have thesame meaning as they do on the co

Setting Up the Code Generation Environment4-9Setting Up the Code Generation Tools on an HP WorkstationTo set the TMP environment variable, use this sy

Where to Go From Here 4-10Verifying that the environment variables are setTo verify that the environment variables are set, enter:set This command lis

5-1Getting Started With theCode Generation ToolsThis chapter helps you start using the assembler, linker, and compiler byproviding a quick walkthrough

iii PrefaceRead This FirstAbout This ManualThe TMS470R1x Code Generation Tools Getting Started Guide tells you howto install release 1.20 of the TMS4

Getting Started With the Assembler and Linker 5-25.1 Getting Started With the Assembler and LinkerThis section provides a quick walkthrough of the ass

Getting Started With the Assembler and Linker5-3Getting Started With the Code Generation Tools3) Now enter the following command to assemble file2.asm

Getting Started With the Assembler and Linker 5-4Example 5–4. Output Map File, lnker2.map*****************************************************TMS470 C

Getting Started With the Assembler and Linker5-5Getting Started With the Code Generation ToolsThe two files, file1 and file2, can be linked together w

Getting Started With the Assembler and Linker 5-6Example 5–6. Linker Map File (linker2.map) Linked Using a Linker Command File************************

Getting Started With the C Compiler5-7Getting Started With the Code Generation Tools5.2 Getting Started With the C CompilerThe TMS470R1x C compiler co

Getting Started With the C Compiler 5-83) Also by default, the shell creates a COFF object file as output; however,if you use the –z option, the outpu

6-1Release NotesRelease NotesThis chapter describes the media contents of the TMS470R1x tools kit. Thetools are supported on SPARCstations, HP workst

Media Contents 6-26.1 Media ContentsThe CD-ROM included in the TMS470R1x tools kit for SPARCstations and HPworkstations contains the files listed in T

Media Contents6-3Release NotesTable 6–2. Media Contents for PCsFile Descriptionreadme.1st Online release bulletinabs470.exe Absolute listerac470.exe A

Notational Conventions / Related Documentation From Texas Instrumentsiv Here is an example of a command that you might enter:set PATH=c:\tool_dir;%PAT

Release Enhancements 6-46.2 Release EnhancementsRelease 1.20 of the TMS470R1x code generation tools contains generalenhancements as well as enhancemen

Release Enhancements6-5Release NotesThe section in which the entry point of a C program is defined cannot bemarked as a conditionally linked section.

6-6

A-1Troubleshooting DOS SystemsAppendix ATroubleshooting DOS SystemsDOS/4GW is a memory manager that is embedded into the DOS version ofthe TMS470R1x

Troubleshooting in the Protected-Mode Environment A-2A.1 Troubleshooting in the Protected-Mode EnvironmentGetting 32-bit programs to execute properly

Troubleshooting in the Protected-Mode EnvironmentA-3Troubleshooting DOS SystemsThe PMINFO32.EXE programPurpose: Run PMINFO.EXE to determine the perfor

Troubleshooting in the Protected-Mode Environment A-4PMINFO provides the information shown in Table A–1.Table A–1. PMINFO FieldsMeasurement PurposeCPU

Kernel Error MessagesA-5Troubleshooting DOS SystemsA.2 Kernel Error MessagesThis section describes error messages from the DOS/16M kernel embeddedin t

Kernel Error Messages A-69: cannot allocate tstackDescriptionThere is not enough memory to load DOS/4G.ActionMake more memory available and try aga

Kernel Error MessagesA-7Troubleshooting DOS Systems17: system software does not follow VCPI or DPMI specificationsDescriptionSome memory-resident p

Related Documentation From Texas Instruments / Trademarksv Read This FirstTMS470R1x C Source Debugger User’s Guide (literature numberSPNU124) descr

Kernel Error Messages A-829: memory error, out of rangeDescriptionMemory was probably corrupted during execution of yourprogram. Writing through an

DOS/4G Error MessagesA-9Troubleshooting DOS SystemsA.3 DOS/4G Error MessagesDOS/4G errors are more common than kernel errors when using DOS/4G orDOS/4

DOS/4G Error Messages A-103301 ”unhandled EMPTYFWD, GATE16, or unknown relocation”3302 ”unhandled ALIAS16 reference to unaliased object”3304 ”unhandle

GlossaryB-1 GlossaryAppendix AGlossaryAasm470: The name of the command that invokes the assembler for theTMS470R1x.assembler: A software program tha

GlossaryB-2 DOS/4GW: A memory extender that is bound with the DOS version of theTMS470R1x code generation tools. The executable DOS/4GW file is notshi

GlossaryB-3 GlossaryPpragma: Preprocessor directive that provides directions to the compilerabout how to treat a particular statement.protected-mode

B-4

IndexIndex-1Index@ shell option 6-5AA_DIR environment variablefor DOS systems 1-5for HP workstations 4-6for SPARCstations 3-6 to 3-7for Windows 3.1x s

IndexIndex-2 DdirectivesMEMORY 5-5SECTIONS 5-5directories, software toolsfor DOS systems 1-5for HP workstations 4-3, 4-6for SPARCstations 3-4, 3-6for

IndexIndex-3Iinstallation, softwarefor DOS systems 1-3for HP workstations 4-3 to 4-4for SPARCstations 3-3for Windows 3.1x systems 1-3for Windows 95/NT

If You Need Assistancevi If You Need Assistance . . .World-Wide Web SitesTI Online http://www.ti.comSemiconductor Product Information Center (PIC) htt

IndexIndex-4 .profile filefor HP workstations 4-5 to 4-10for SPARCstations 3-5 to 3-10protected-modeenvironment, troubleshooting A-2programs, definiti

IndexIndex-5virtual memory, definition B-3Wwalkthroughassembler 5-2 to 5-4C compiler 5-7 to 5-8linker 5-2 to 5-4Windows 3.1x systemsrequirements 1-2se

Index-6

IMPORTANT NOTICETexas Instruments (TI) reserves the right to make changes to its products or to discontinue any semiconductorproduct or service withou

ContentsviiContents1 Setting Up the Code Generation Tools With DOS or Windows 3.1x 1-1. . . . . . . . . . . . . . . . . . Provides installation instr