Texas Instruments TMS370 manual Showing and Operating Within a Text FileÐthe Show Command

Page 67

Showing and Operating Within a Text File

3.11 Showing and Operating Within a Text FileÐthe Show Command

Use the show command to show a text file. This command uses the entire screen below the second line as the file display window. When you select the show command, the programmer prompts for a file name:

File:

Type the pathname of the file to be displayed. If the file exists, the programmer displays the first lines of it on the screen.

The maximum size of a file that can be displayed is 2048 lines. Any file larger than this is truncated to 2048 lines. The maximum file size is also limited by available memory because the entire file is PC memory-resident.

Table 3±4 gives the commands, functions, and control keys available for in- specting the text file. The letters used to invoke the command are printed in bold type.

Table 3±4. Show Text File Commands

Command

Function

 

 

Find

Find a character string.

 

 

Find Next

Find the next occurrence of the string.

 

 

Line No.

Move to the specified line number.

 

 

Top

Move to top of file.

 

 

Bottom

Move to end of file.

 

 

ESC

Leave inspect file mode and return to the display command

 

menu.

 

 

Move cursor left one space, scrolling if necessary.

 

 

Move cursor right one space, scrolling if necessary.

 

 

Move to beginning of line.

Control/

 

Move to end of line.

Control/

 

Insert

Scroll window left.

 

 

Delete

Scroll window right.

 

 

Move up one line, scrolling if necessary.

 

 

Move down one line, scrolling if necessary.

When you inspect the file, the second line on the screen displays the name of the file, the current line number, and the total number of lines in the file.

Example:

ºfile.txtº line 113/355

3-17

Image 67
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