Texas Instruments TMS370 manual Using Keystroke Capture Files

Page 91

Appendix D

Using Keystroke Capture Files

A keystroke capture file is a file in which the keystrokes you type are re- corded to be replayed later. Keystroke capture files are useful in setting up the programmer to perform a commonly repeated program or to verify operation.

Two command line switches allow the recording and replaying of keystroke files, and a control character allows you to turn off recording of a keystroke file.

/Cfilename.ext records keystrokes into file fliename.ext

/Kfilename.ext replays keystrokes from file filename.ext

stops recording keystrokes

For example, assume you are programming a TMS370C756 to check your code. As you make changes to the code, you program another device. The steps required to select the device, fill the memory to FF's, and to load the file can all be recorded in a keystroke file so that you do not have to type them each time you program or verify the device.

In the following example, it is assumed that the program is contained in the file a.out, which is in the directory DEMO on the current drive. The device selected is TMS370 16K_PE, the seventh entry in the default device table. The key- stroke file used is example.key.

To create a keystroke capture file, invoke the programmer with the /C option followed immediately by a filename (there are no spaces between the `C' and the filename).

prgrm370 /cexample.key

Select the device type, fill the memory with FF's, and load the object file as nor- mal. Before the actual program or verify step, stop the keystroke recording by

pressing . The following file, example.key, is created.

D-1

Image 91
Contents Users Guide 2546239-9704 TMS370 Microcontroller/Gang Programmer Users Guide Important Notice Read This First How to Use This ManualRelated Documentation Information About Cautions and Warnings Read This First Contents Differences in Command Structures for Microcontroller Figures Tables Examples Xii Section Introduction and Installation±1. Microcontroller Programmer Personality Module Microcontroller Programmer Overview and DescriptionMicrocontroller Programmer Overview and Description ±2. Gang Programmer Board Gang Programmer Overview and DescriptionGang Programmer Overview and Description Operating the Gang Programmer in Standalone Mode Operating the Gang Programmer in PC ModeGang Programmer Overview and Description Connecting a Programmer to the PDS Base Unit Properly Installing the Programmer HardwareConnection to a PC Power ConnectionConnection to an XDS Switch No ±3. Socket Identification Integrated Circuit IC InsertionTo install a DIP device To install a Plcc device Installing the Software in a Single Directory Properly Installing the Programmer SoftwareInstalling the Software in Multiple Directories PRGRM370 @PROJ1.CFG Coff file Invoking the Programmer SoftwareInteractive Programming Example Getting StartedÐExample SessionsGettingStartedÐExampleSessions \prgrm370 xyz.out @abc.cfg ±b Batch Programming ExampleIntroduction and Installation Operating in the Configuration Window ±1. Command Menu Structure How Command Menus WorkWhat Happens If I Make an Error? Using the Special Function Keys±1. Edit Control Keys Understanding Your Input at the Cursor Prompt±2. Configuration Window Commands Configuration Window Overview and DescriptionConfiguration Window Overview and Description ±3. Show Ranges Parameter Summary Secondary Configuration WindowÐthe Show Ranges WindowSelecting the Proper Program Algorithm Device family name Device first name Control Register Program Algorithm Editing the Configuration ParametersEditing the Device Table ±4. Device Table Edit CommandsEditing the Configuration Parameters and Device Table Loading the Device Table Saving the Device Table Selecting a Current Device Ð the Choose Device CommandShowing 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 ±2. PC Memory Display and Reverse Assembled Code Windows Display Window Overview and Description±3. Reverse Assembled Code Window Commands ±2. Display 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 Using the Microcontroller Programmer Programming a Device From PC Memory Ð the Program CommandProgramming Complete, Program another device?y/n Programming Using the Gang Programmer Address out of range, Press any key ±4. Show Text File Commands Showing and Operating Within a Text FileÐthe Show CommandPositioning 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 Quitting the Program and Exiting to DOSÐthe Quit Command Suspending the Program and Entering DOSÐthe System CommandOperating the Programmer in Batch Mode Example A±1. Example Configuration/Batch File Understanding the Batch Mode FileExecutable Batch Commands Batch File Command Rules and DescriptionsDefaultable Commands Nonexecutable Batch CommandsBatch Mode Status Messages Operating the Programmer in Batch Mode Error Messages Invalid programming range ± Retry, Abort Error Message DescriptionsInvalid Vcc chosen ± Retry, Abort These error messages are specific to the gang programmers Table C±1. Valid Configuration Parameters Configuration ParametersConfiguration Parameters Using Keystroke Capture Files Table D±1. Valid Nonprintable Characters Example D±1. Keystroke File Example.key$INS Using Keystroke Capture Files Show ID software revision information, 2-9 description IndexConnecting to a pc, 1-9 connecting to an XDS Index Index-4 Important Notice