Texas Instruments TMS370 manual Invoking the Programmer Software, Coff file

Page 30

Invoking the Programmer Software

1.5Invoking the Programmer Software

Before activating the programmer, be sure that it is plugged in and correctly connected as described in Section 1.3. Turn on the programmer's power switch (and the gang programmer's external power) before invoking the pro- grammer software.

The command to run the programmer software from the DOS prompt is:

prgrm370 [COFF file] [@Config./Batchfile] [±b] [±p=port #]

where
COFF file	Optional argument that specifies a file to be pro-
	grammed or verified in the batch control mode or
	loaded into PC memory in the interactive control
	mode.
@Config./Batch file	Optional argument that specifies a configuration/
	batch file that contains the configuration parame-
	ters or the batch commands for the batch control
	mode.
±b	Optional argument that turns on the batch mode if
	specified.
±p = port #	The communication port number to be used. De-
	fault is 1.

After you invoke the programmer software, the PC screen briefly displays a version number and copyright message.

If you specified a configuration/batch file but did not turn on the batch mode, the configuration specified in the file is loaded as the current configuration. Any other batch commands that would control the flow of the programming process are ignored.

If you specified a configuration/batch file and turned on the batch mode with the ±b argument, the programmer software operates as directed by the batch file.

If you specified a port number and the programmer is not physically connected to that port, then the following error message is displayed.

Programmer not properly connected: Abort, Retry?

Aborting the invocation returns you to the DOS prompt. To retry the invocation, make sure the programmer is turned on and properly connected to the port

specified in the command. Then, press followed by to restart the programmer software.

Interactive mode commands are described in detail in Sections 2 and 3. Batch commands are covered in Appendix 1.

1-16	Introduction and Installation

Image 30

Contents Users Guide 2546239-9704 TMS370 Microcontroller/Gang Programmer Users Guide Important Notice How to Use This Manual Read This FirstRelated Documentation Information About Cautions and Warnings Read This First Contents Differences in Command Structures for Microcontroller Figures Tables Examples Xii Introduction and Installation SectionMicrocontroller Programmer Overview and Description ±1. Microcontroller Programmer Personality ModuleMicrocontroller Programmer Overview and Description Gang Programmer Overview and Description ±2. Gang Programmer BoardGang Programmer Overview and Description Operating the Gang Programmer in PC Mode Operating the Gang Programmer in Standalone ModeGang Programmer Overview and Description Properly Installing the Programmer Hardware Connecting a Programmer to the PDS Base UnitPower Connection Connection to a PCConnection to an XDS Switch No Integrated Circuit IC Insertion ±3. Socket IdentificationTo install a DIP device To install a Plcc device Properly Installing the Programmer Software Installing the Software in a Single DirectoryInstalling the Software in Multiple Directories PRGRM370 @PROJ1.CFG Invoking the Programmer Software Coff fileGetting StartedÐExample Sessions Interactive Programming ExampleGettingStartedÐExampleSessions Batch Programming Example \prgrm370 xyz.out @abc.cfg ±bIntroduction and Installation Operating in the Configuration Window How Command Menus Work ±1. Command Menu StructureUsing the Special Function Keys What Happens If I Make an Error?Understanding Your Input at the Cursor Prompt ±1. Edit Control KeysConfiguration Window Overview and Description ±2. Configuration Window CommandsConfiguration Window Overview and Description Secondary Configuration WindowÐthe Show Ranges Window ±3. Show Ranges Parameter SummarySelecting the Proper Program Algorithm Device family name Device first name Control Register Editing the Configuration Parameters Program Algorithm±4. Device Table Edit Commands Editing the Device TableEditing the Configuration Parameters and Device Table Loading the Device Table Selecting a Current Device Ð the Choose Device Command Saving the Device TableShowing the Display Window Ð the Display Command Operating in the Display Window Operating in the Display Window What Happens If I Make an Error Understanding Your Input at the Prompt Display Window Overview and Description ±2. PC Memory Display and Reverse Assembled Code Windows±2. Display Window Commands ±3. Reverse Assembled Code Window CommandsESC Filling a Block of PC Memory With a Value Ð the Fill Command Loading a Coff File Into PC MemoryÐ the Load Command Outputting a Coff File From PC Memory Outputting a Coff File From PC Memory Moving Blocks of PC MemoryÐthe Move Command Programming a Device From PC Memory Ð the Program Command Programming Using the Microcontroller ProgrammerProgramming Complete, Program another device?y/n Programming Using the Gang Programmer Address out of range, Press any key Showing and Operating Within a Text FileÐthe Show Command ±4. Show Text File CommandsPositioning the Cursor at Top of a File Ð the Top Command Uploading Using the Microcontroller Programmer Uploading Using the Gang Programmer Unable to communicate with TMS370 device ± Retry, Abort Verifying the Contents of a Device ± the Verify Command Verifying Using the Gang Programmer Device test failed, continue? y/n Verifying the Contents of a Device Editing the Contents of PC MemoryÐthe Edit Command Using the Master Mode MenuÐthe Master Command Suspending the Program and Entering DOSÐthe System Command Quitting the Program and Exiting to DOSÐthe Quit CommandOperating the Programmer in Batch Mode Understanding the Batch Mode File Example A±1. Example Configuration/Batch FileBatch File Command Rules and Descriptions Executable Batch CommandsNonexecutable Batch Commands Defaultable CommandsBatch Mode Status Messages Operating the Programmer in Batch Mode Error Messages Error Message Descriptions Invalid programming range ± Retry, AbortInvalid Vcc chosen ± Retry, Abort These error messages are specific to the gang programmers Configuration Parameters Table C±1. Valid Configuration ParametersConfiguration Parameters Using Keystroke Capture Files Example D±1. Keystroke File Example.key Table D±1. Valid Nonprintable Characters$INS Using Keystroke Capture Files Index Show ID software revision information, 2-9 descriptionConnecting to a pc, 1-9 connecting to an XDS Index Index-4 Important Notice