TMS370 Microcontroller/Gang Programmer User’s Guide 2546239-9704 Microcontroller Products
546239-9704
TMS370 Microcontroller/Gang Programmer User’s Guide SPNU023 February, 1991
IMPORTANT NOTICE Texas Instruments (TI) reserves the right to make changes to its products or to discontinue any semiconductor product or service without notice, and advises its customers to obtain the latest version of relevant information to verify, before placing orders, that the information being relied on is current. TI warrants performance of its semiconductor products and related software to the specifications applicable at the time of sale in accordance with TI’s standard warranty.
Preface Read This First How to Use This Manual This manual describes how to use and operate the TMS370 Microcontroller Programmer and the TMS370 Gang Programmer. Chapter 1 gives an overview of each programmer and describes the correct way to install your specific programmer. After your programmer is correctly installed, you can use the configuration commands and display commands, described in Chapters 2 and 3, respectively, to operate your programming system for your specific application.
Related Documentation Related Documentation The following TMS370 documents are available through Texas Instruments Incorporated: The TMS370 Family Data Manual (literature number SPNS014) describes the hardware aspects of the TMS370, such as pin functions, architecture, stack operation, and interface; the manual also includes the TMS370 assembly language instruction set.
Information About Cautions and Warnings Information About Cautions and Warnings This book may contain cautions and warnings. A caution describes a situation that could potentially damage your software or equipment. This is what a caution looks like. A warning describes a situation that could potentially cause harm to you. This is what a warning looks like. The information in a caution or a warning is provided for your protection. Please read each caution and warning carefully.
vi Read This First
Contents 1 Introduction and Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1.1 Microcontroller Programmer Overview and Description . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 1.2 Gang Programmer Overview and Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 1.2.1 Operating the Gang Programmer in PC Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 1.2.
Contents 2.12 2.13 2.14 Saving Configuration Parameters and the Device Table to a File — the Save Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15 Showing the Display Window — the Display Command . . . . . . . . . . . . . . . . . . . . . . . . . 2-16 Ending Your Current Session and Returning to DOS — the Quit Command . . . . . . . 2-16 3 Operating in the Display Window . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running Title Figures 1–1. 1–2. 1–3. 2–1. 2–2. 2–3. 2–4. 3–1. 3–2. Microcontroller Programmer Personality Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Gang Programmer Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Socket Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11 Command Menu Structure . . . . . . . . . . . . . .
Running Title Tables 1–1. 2–1. 2–2. 2–3. 2–4. 3–1. 3–2. 3–3. 3–4. 3–5. C–1. D–1. x XDS Memory Expansion/Communications Board Switch Settings . . . . . . . . . . . . . . . . . . 1-10 Edit Control Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Configuration Window Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Show Ranges Parameter Summary . . . . . . . . . . . . . .
Running Title Examples A–1. D–1. Example Configuration/Batch File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2 Keystroke File Example.key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
xii Table of Contents
Chapter 1 Introduction and Installation This chapter describes how each programmer operates, how to install hardware, and how to install software. It also gives examples on getting started. Chapter 1 comprises the following sections: Section Page 1.1 Microcontroller Programmer Overview and Description . . . . . . . . 1-2 1.2 Gang Programmer Overview and Description . . . . . . . . . . . . . . . . 1-4 1.3 Properly Installing the Programmer Hardware . . . . . . . . . . . . . . . . 1-8 1.
Microcontroller Programmer Overview and Description 1.1 Microcontroller Programmer Overview and Description The TMS370 Microcontroller Programmer is an interactive, menu-driven system that facilitates programming TMS370 family devices and EPROMs either directly or through an XDS. The microcontroller programmer is currently capable of programming the TMS370, TMS7742, TMS77C82, 2732, 2764, 27128, and 27256 device families.
Microcontroller Programmer Overview and Description The base unit of the programmer contains two LEDs. The red LED is marked program or device power and is lit whenever power is applied to device sockets. The green LED is marked power and indicates that the base is turned on. This LED should turn on approximately three seconds after power is supplied to the programmer.
Gang Programmer Overview and Description 1.2 Gang Programmer Overview and Description The TMS370 Gang Programmer is an interactive, menu-driven system that provides programming support for on-chip EEPROM or EPROM of TMS370 microcontrollers in production environments. The gang programmer has the following features: Two modes of operation—PC mode and standalone mode. Ability to program up to 16 devices. LEDs that indicate programming or verification failure. A buzzer that indicates programming completion.
Gang Programmer Overview and Description alone mode; it is ignored in PC mode. The red LED built into this switch is marked TMS370 power on and indicates that power is being supplied to the sockets on the gang programmer. Do not insert or remove devices from the programmer while the red TMS370 power on LED is lit! The main body of the gang programmer consists of 16 sockets whose type and arrangement are dependent on the type of gang programmer top you have.
Gang Programmer Overview and Description 1.2.1 Operating the Gang Programmer in PC Mode In PC mode, the gang programmer is an interactive, menu-driven system that facilitates programming TMS370 family devices and EPROMs. The system allows you to perform any or all of the operations listed below. Program any or all of the 16 devices from PC memory Modify or add a new device to the device table Verify any or all devices against either PC memory or the master device. Upload any of the 16 devices.
Gang Programmer Overview and Description 1) Position the toggle switch to either the program position or the verification position. 2) Press the push button on the programmer. While you press the push button, all 16 LEDs turn on, and remain on to verify LED operation, until you release the push button. 3) Release the push button to begin the programming or verification.
Properly Installing the Programmer Hardware 1.3 Properly Installing the Programmer Hardware Correctly installing the programmer hardware is essential to the proper operation of programmer system. The following subsections explain how to connect the programming board to the PDS base unit and the required power connections for connecting your programmer to a PC or TMS370 XDS. Also included in these subsections is a description of how to properly insert DIPs and PLCCs. 1.3.
Properly Installing the Programmer Hardware 1.3.2 Power Connection Connect the female end of the power cord to the PDS base unit. The programmer can handle a power range of 105 to 265 volts AC at 47 to 440 hertz. All units are equipped with two power cords. If you are in the U.S.A., use the power cord with a male connector that can be plugged directly into a 120-V, 60-Hz power socket. Outside the U.S.A., use the power cord with no male connector because the type of receptacle to be used is unknown.
Properly Installing the Programmer Hardware 2) Connect port A of the XDS to the PC by using the cable supplied with the XDS. 3) Ensure that the switches on the XDS Communications board are set as in Table 1–1. Table 1–1. XDS Memory Expansion/Communications Board Switch Settings 1-10 Switch No.
Properly Installing the Programmer Hardware 1.3.5 Integrated Circuit (IC) Insertion ICs may be inserted or removed while power is applied to the programmer; however: 1) When using the microcontroller programmer, never use more than one IC socket at a time. Damage to the IC or the programmer could result. 2) Never insert or remove the IC while the red LED is on. Damage to the IC or the programmer could result.
Properly Installing the Programmer Hardware To install a DIP device: 1) Align the IC so that pin 1 is oriented in the upper-left corner, indicated on the printed circuit board by a circled number 1: 2) Raise the locking arm, pulling it toward you to the upright position. 3) Insert the IC. locking arm DIP 4) Lower the locking arm by pushing it away from you and down, as far as it will go.
Properly Installing the Programmer Hardware To install a PLCC device: With this release of the programmers, the PLCC sockets do not have a lid; therefore, they are not sensitive to the device package height. These new sockets also have the pin 1 orientation at the top of each socket, making it less likely for you to insert a device backwards. 1) Place the PLCC in the empty socket. 2) Press firmly until it is properly seated. The programmer hardware is now ready to use.
Properly Installing the Programmer Software 1.4 Properly Installing the Programmer Software Installing software is exactly the same whether you are using the Microcontroller Programmer or the Gang Programmer. Insert the diskette supplied with the programmer into the PC disk drive and use one of the following methods to copy the contents of the diskette to a directory in your hard disk. 1.4.
Properly Installing the Programmer Software table. The order in which the programmer looks for the device table is outlined below. a) First, it looks for a device table file specified in the configuration/batch file if the configuration/batch file was included in the command line to invoke the programmer software. PRGRM370 @PROJ1.CFG where PROJ1.CFG is the configuration/batch file. b) Next, it looks in the current directory for the default DEVICE.TBL.
Invoking the Programmer Software 1.5 Invoking 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 programmer software. The command to run the programmer software from the DOS prompt is: prgrm370 [COFF file] [@Config.
Getting Started—Example Sessions 1.6 Getting Started—Example Sessions This section will help you get a quick start using your programmer. Once you get started, the menu structure and prompts make the programmer easy to learn and to use. The remainder of this manual provides a detailed reference if you need further information on any of the commands, prompts, or error messages.
Getting Started—Example Sessions Object file: 6) Enter the name of the COFF file containing the object code with which the , and the following prompt appears: device is to be programmed. Press Object base address: all where all is the default, meaning that the entire object code address range is to be used. 7) Select the address range default of all by pressing . The cursor returns to the display window command line. 8) Press to start the programming process.
Getting Started—Example Sessions 1.6.2 Interactive Programming Example 2 This sample session illustrates entering the interactive mode with the COFF file automatically loaded into PC memory. If the programmer software is active, to quit the programthat is, in the display or configuration windows, press mer and verify your choice. This returns the DOS environment. 1) At the DOS prompt, type the following command: C:\>prgrm370 xyz.out where xyz.
1-20 Introduction and Installation
Chapter 2 Operating in the Configuration Window This chapter describes the commands offered in the configuration window of the programmer’s display. The first part of this chapter explains how the command menus and function keys work; it also has a short section on entering information at the cursor prompt. These sections are the same as the initial sections in Chapter 3; if you have already read these sections in Chapter 3, there is no need to read them in this chapter.
How Command Menus Work 2.1 How Command Menus Work The interactive mode of the programmer is driven by command menus that are displayed on the top line of the screen. A command menu is a list of command names, each of which is displayed with one highlighted letter, usually the first character in the name. The highlighted letter is the key you use to invoke the command. You may type command letters in upper or lower case.
Using the Special Function Keys/What Happens If I Make an Error 2.2 Using the Special Function Keys Function keys through invoke various actions in the programmer, depending on your location in the command menu structure. The valid function keys and their definitions for each mode are displayed on the bottom line of the screen for reference. Press the highlighted key for the desired action. Another special function key is .
Understanding Your Input at the Cursor Prompt 2.4 Understanding Your Input at the Cursor Prompt The programmer software often requires you to enter a response to a prompt or to move the cursor to a value on the screen and modify it. The previous or default value for the prompted parameter value is always displayed. You can accept the displayed default or former value by pressing only in response to the prompt.
Configuration Window Overview and Description 2.5 Configuration Window Overview and Description If you use the configuration command while in the display window, the configuration window illustrated in Figure 2–2 is displayed; it also displays when the programmer software is first invoked. Figure 2–2.
Configuration Window Overview and Description The device table lists devices that can be programmed through the programmer. The device table displays 12 device types at a time and is sorted first by the device family names and then by the device first names. If there is more than one device type under one device family, the family name is displayed only once, on the first line of the device family.
Secondary Configuration Window—the Show Ranges Window 2.6 Secondary Configuration Window—the Show Ranges Window A small subwindow appears when you select the show ranges function key, , from the device area of the configuration window. Figure 2–3 illustrates what the show ranges window looks like. Figure 2–3.
Secondary Configuration Window—the Show Ranges Window 2.6.1 Selecting the Proper Program Algorithm For EEPROM memory in devices, there are three programming modes: writing 0s only, all 1s in the data bytes are ignored. writing 1s only, all 0s in the data bytes are ignored. writing 0s and 1s. For all other types of memory, writing 0s is the only programming mode. The three modes provided for the TMS370 allow the selection of the most efficient programming.
Showing the Software Revision Information/Defining and Adding a Device to the Device Table 2.7 Showing the Software Revision Information — the Show ID Command This command displays the software release/revision information on the top line of the PC screen for reference. Press any key to return to the configuration command line. 2.
Defining and Adding a Device to the Device Table Valid types of memory are EPROM or EEPROM. Legal VCC values are listed following the prompt—0, 5, or 6. If you enter a value that is not one of the three valid choices, the following error message appears: invalid VCC value: 0, 5, or 6 (hit any key) Press any key to erase the error message and return to the prompt to enter the VCC value again. Legal VPP values are listed following the prompt—0, 5, 12, 12.5, or 21.
Editing the Configuration Parameters and Device Table Program Algorithm: If the family code is 10h (TMS370 EEPROM range), one of three programming algorithms can be chosen—program 1s, program 0s, or program 1s and 0s. Using this parameter along with the block erase parameter, you can optimize for programming speed or can minimize the number of write erase cycles. This parameter is ignored for any other family code and should be set to program 0s only for clarity.
Editing the Configuration Parameters and Device Table 2.9.2 Editing the Device Table The device table is a list of devices catagorized by family name and device first name. The software diskette provides a device table file, device.tbl, that contains a list of devices and their configuration parameters. The devices and their configurations are loaded automatically when the programmer software is invoked. from the port # field causes the cursor to enter the device table Pressing field.
Editing the Configuration Parameters and Device Table Pressing causes this temporary window to disappear, and the previous window is resumed. Pressing from the device table selects the device on the line where your cursor is positioned. The device you have chosen is highlighted when selected. deletes the device on the line where your cursor is positioned. Pressing If the deleted device is the current device, there is no current device type, and you must select a new device from the device table.
Loading the Device Table and Configuration Parameters From a File 2.10 Loading the Device Table and Configuration Parameters From a File — the Load Command When you select the L command, a submenu displays options for choosing a file to load. The commands in this submenu are listed below; the letter that invokes the command is printed in bold type. Command Function Device Table Load a device table file. Configuration Load configuration parameters from a configuration/batch file.
Selecting a Current Device/Saving the Configuration Parameters and Device Table to a File 2.11 Selecting a Current Device — the Choose Device Command The choose device command moves the cursor directly to the device table. Use the cursor control keys to move the cursor to the device you will be proto select it. The selected device is highlighted. Pressgramming and press ing returns you to the configuration command line. A device must be specified before the software allows you to enter the display window.
Showing the Display Window/Ending Your Current Session and Returning to DOS 2.13 Showing the Display Window — the Display Command When you choose the display command, the programmer software checks to to see if a current device type has been selected. If you have selected a current device type, the programmer sets up the configuration and briefly displays the following message before returning to the top level command. Set programmer configuration.....
Chapter 3 Operating in the Display Window This chapter describes the commands offered in the display window of the programmer’s display. The first part of this chapter explains how the command menus and function keys work; it also has a short section on entering information at the cursor prompt. These sections are the same as the initial sections in Chapter 2; if you have already read these sections in Chapter 2, there is no need to read them in this chapter.
How Command Menus Work 3.1 How Command Menus Work The interactive mode of the programmer is driven by command menus that are displayed on the top line of the screen. A command menu is a list of command names, each of which is displayed with one highlighted letter, usually the first character in the name. The highlighted letter is the key you use to invoke the command. You may type command letters in upper or lower case.
Using Special Function Keys/What Happens If I Make an Error? 3.2 Using the Special Function Keys Function keys through invoke various actions in the programmer, depending on your location in the command menu structure. The valid function keys and their definitions for each mode are displayed on the bottom line of the screen for reference. Press the highlighted key for the desired action. Another special function key is .
Understanding Your Input At the Cursor Prompt 3.4 Understanding Your Input at the Prompt The programmer software often requires you to enter a response to a prompt or to move the cursor to a value on the screen and modify it. The previous or default value for the prompted parameter value is always displayed. You can accept the displayed default or former value by pressing only in response to the prompt.
Display Window Overview and Description 3.5 Display Window Overview and Description The display window has two separate areas (see Figure 3–2): the PC memory display (left half of screen) and the reverse assembled code (right half of screen). The programmer displays the PC memory in a hexadecimal format. The memory address occupies the left-most column of each line, followed by eight bytes of PC memory contents.
Display Window Overview and Description Table 3–2. Display Window Commands Command Function Fill Memory Fill PC memory with a byte value. Load COFF File Load a COFF file to PC memory. Output COFF File Create a COFF file from PC memory. Move Memory Move a block of PC memory to another location in the PC memory. Program Device Program device from the PC memory. Show File Show a text file. Upload Device Upload device content to the PC memory. Verify Device Verify device from the PC memory.
Display Window Overview and Description F2 (Pg Up) Scroll backward through code. F3 (Address) Invoke disassembler at specified PC memory address. ESC Leave inspect mode and return to display command menu. ← Move cursor left one space. → Move cursor right one space. ↑ Move up one line, scrolling if necessary. ↓ Move down one line, scrolling if necessary. The programmer can not disassemble backwards through the PC memory.
Filling a Block of PC Memory With a Value 3.6 Filling a Block of PC Memory With a Value — the Fill Command Use the fill command to fill a block of PC memory with a value. Step 1: Define the size of the block by answering the following two prompts: Fill Start Address: 0000h Size (in bytes) : 0000h Enter the start address in the range (0000h–FFFFh).
Loading a COFF File Into PC Memory 3.7 Loading a COFF File Into PC Memory— the Load Command Use the load command to load a COFF file into the PC memory. This command allows you to load the entire COFF file or part of it and also to specify where in the PC memory you want it loaded. Step 1: Identify the COFF file you want to load at the following prompt: Object file: If the file does not exist, an error message is displayed.
Outputting a COFF File From PC Memory 3.8 Outputting a COFF File From PC Memory — the Output COFF Command Use the output COFF command to create a COFF object file from the PC memory. This command allows you to specify the block(s) of PC memory to be used to create the COFF file. Each block of the PC memory is made into one section in the COFF file, and you can specify the section address in the COFF file to use for the block. Step 1: Identify the file for the COFF output.
Outputting a COFF File From PC Memory After the input session is completed, the programmer uses the PC memory blocks given to create the COFF file. As a result of debugging, you may have made code changes that you would like to save. You can save the changes for later use by creating a COFF file from the working code in the PC memory. You may specify the range(s) of the source to be read or you can use the valid address ranges defined for the current device type.
Moving Blocks of PC Memory 3.9 Moving Blocks of PC Memory—the Move Command Use the move command to move a block of PC memory from one location to another PC memory location. Step 1: Identify the size of PC memory to be moved. Move PC memory From Address: Size (in bytes) : 0000h 0000h Enter the start address of the block to be moved and then enter the size of the block to be moved. Step 2: Specify a destination address where the block of memory is to be moved.
Programming a Device From PC Memory 3.10 Programming a Device From PC Memory — the Program Command When you use the program command, the microcontroller and gang programmers display different prompts and messages. The microcontroller programmer is discussed in sub-section 3.10.1, and the gang programmer is discussd in subsection 3.10.2. 3.10.1 Programming Using the Microcontroller Programmer Use the microcontroller programmer’s program command to program a device from the PC memory with verification.
Programming a Device From PC Memory This message is updated when the programmer starts programming the next packet. If, for some reason, you want to terminate the programming process before it key to abort the process and return to the display is completed, press the command menu. When the programming process is either completed or aborted, a message informs you whether or not the programming was successful.
Programming a Device From PC Memory 3.10.2 Programming Using the Gang Programmer In PC mode, use the gang programmer’s program command to program multiple devices from the PC memory with verification. (For information on programming from standalone mode, refer to subsection 1.2.2 on page 1-6.) Starting the programming is a simple one-step process of defining PC memory and device address ranges. Step 1: Identify the address ranges of PC memory used to program the device.
Programming a Device From PC Memory Once the programming begins, it proceeds packet by packet in180-byte segments. Before a packet is programmed, the programmer verifies that the destination device address is inside the valid address ranges defined for the current device type. If the address is not inside the range, the following error message is displayed.
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.
Showing and Operating Within a Text File 3.11.1 Finding Character Strings Within a Text File — the Find Command The find command allows you to search for a string of characters in the text file. When the programmer prompts you for a character string, type a string up to 30 characters long. The programmer begins at the current position and searches for the string.
Uploading a Device’s Contents Into PC Memory 3.12 Uploading a Device’s Contents Into PC Memory– the Upload Command When you use the upload command, the microcontroller and gang programmers display different prompts and messages. The microcontroller programmer is discussed in sub-section 3.12.1, and the gang programmer is discussd in sub-section 3.12.2. 3.12.1 Uploading Using the Microcontroller Programmer Use the upload command to upload the device contents to the PC memory .
Uploading a Device’s Contents Into PC Memory During the uploading process, the programmer displays a status message on the bottom line of the screen to indicate the address currently being read. Reading at address 7000 (hit ESC key to abort) This message is updated when the programmer starts to upload the next packet. If you want to terminate the uploading process before it has completed, press to abort the process and return to the display command menu. 3.12.
Uploading a Device’s Contents Into PC Memory unable to communicate with TMS370 device – Retry, Abort You should inspect all of the devices for misalignment or bent pins. You may have to remove devices until the bad device is found. Once the actual uploading begins, it proceeds packet by packet in180-byte segments. Before a packet is uploaded, the programmer verifies that the source device address is inside the valid address ranges defined for the current device type.
Verifying the Contents of a Device 3.13 Verifying the Contents of a Device – the Verify Command When you use the verify command, the microcontroller and gang programmers display different prompts and messages. The microcontroller programmer is discussed in sub-section 3.13.1, and the gang programmer is discussd in subsection 3.13.2. 3.13.1 Verifying Using the Microcontroller Programmer The verify command compares the contents of the device with the contents of the PC memory.
Verifying the Contents of a Device rent device type. If the address is not in the range, the following error message is displayed. Address out of range, Press any key During the verification process, the programmer displays a status message on the bottom line to indicate the beginning address of the packet currently being programmed. Reading at address 7000 (hit ESC key to abort) This message is updated when the programmer starts to verify the next packet.
Verifying the Contents of a Device Step 3: If you chose to verify a single device against PC memory, you must now specify the error file. Otherwise, verification errors are indicated with the red LEDs found below each device socket. If you have entered an error file previously, it will appear as the default. Error File: Step 4: If you are verifying against PC memory, you must select the address range to be used during verification.
Verifying the Contents of a Device Once the actual verification begins, it proceeds packet by packet (180-byte segments). Before a packet is read, the programmer verifies that the source device address is inside the valid address ranges defined for the current device type. If the address is not inside the range, the following error message is displayed. Address out of range, (press any key) Press any key to erase the error message and return to the display command menu.
Editing the Contents of PC Memory 3.14 Editing the Contents of PC Memory—the Edit Command The edit command puts the programmer in a special mode that allows you to overwrite the contents of the PC memory by typing new values. When you press , the cursor moves into the PC memory display area. You can scroll up and down through the PC memory with the cursor and function keys, and modify individual bytes. The value at the cursor location is highlighted to indicate that you can edit it.
Using the Master Mode Menu 3.15 Using the Master Mode Menu—the Master Command The master command mode allows you to program and manipulate data with a master device as the source of the data manipulation. This command brings up a menu simliar to the display window command menu. All the commands, except program, upload, and copy, work identically to the display window commands; however, the operations are performed on the master device only.
Suspending the Program and Entering DOS/Quitting the Program and Exiting to DOS 3.16 Suspending the Program and Entering DOS—the System Command The system command temporarily suspends the programmer software so that you can use DOS commands and functions. When you are ready to leave . DOS and return to the programmer software, enter EXIT and press 3.17 Quitting the Program and Exiting to DOS—the Quit Command The quit command exits the programmer software and returns to DOS. The and a .
Appendix A Operating the Programmer in Batch Mode In the batch control mode, the execution flow is defined in a configuration/ batch file, and all messages are displayed in line-oriented mode. The configuration/batch file consists of a set of commands that define the current configuration and give direction of execution. Section Page A.1 Understanding the Batch Mode File . . . . . . . . . . . . . . . . . . . . . . . . . A-2 A.2 Batch File Command Rules and Descriptions . . . . . . . . . . . . . . . . .
Understanding the Batch Mode File A.1 Understanding the Batch Mode File Batch mode allows you to program and/or verify devices repeatedly with a fixed configuration setup in the configuration/batch file. When you invoke the programmer in batch mode, all device parameters are specified by the device type called out in the configuration/batch file. The configuration/batch file is an ASCII file that calls out the device table and device type.
Batch File Command Rules and Descriptions A.2 Batch File Command Rules and Descriptions The batch commands can be classified as executable or nonexecutable. The executable commands invoke operations, whereas the nonexecutable commands define programming parameters and the device type. The batch commands must conform to the following basic syntax rules: 1) Lower case and upper case characters are not distinguished. 2) Only one command is allowed on each line.
Batch File Command Rules and Descriptions A.2.2 Nonexecutable Batch Commands Nonexecutable commands do not invoke any action. They set certain programming parameters and define the device type. These commands can be classified as defaultable or nondefaultable. Defaultable commands are not required in the configuration/batch file; the commands have their own default values if not specified. Nondefaultable commands must be specified in the configuration/batch file because no default is provided.
Batch Mode Status Messages A.3 Batch Mode Status Messages When programming begins, a status message informs you: Programming at device address where device address is the location on the device that is currently being programmed. This message is updated every time the programmer starts on the next packet of data. A similar message appears when verification begins: Reading at device address where device address is the location on the device that is currently being read and verified.
A-6 Operating the Programmer in Batch Mode
Appendix B Error Messages This appendix briefly describes the error messages associated with the programmers. It also gives reasons why the error occurred and suggestions on how to fix the error. The messages are arranged in alphabetic order.
Error Message Descriptions B.1 Error Message Descriptions The following messages are common to all programmers. Chip inserted incorrectly, or bad – Retry, Abort For the microcontroller programmer, this message refers to the 2732, 2764, 27128, and 27256 devices. For the gang programmer, this message refers to the master EPROM device. Re-insert the device or replace the device with a new one.
Error Message Descriptions invalid Vcc chosen – Retry, Abort The VCC value you have chosen for your device is invalid. Use a valid VCC value—0, 5, or 6 volts. invalid VPP chosen – Retry, Abort The VPP value you have chosen is invalid. Use a valid VPP value—0, 5, 12, 12.5, or 21 volts. unable to communicate with TMS370 device – Retry, Abort The programmer is unable to communicate with the TMS370 microcontroller. The microcontroller may have bent pins, may be inserted incorrectly, or may be inoperable.
Error Message Descriptions These error messages are specific to the gang programmers. checksum error in master device – Retry, Abort The data in the master device is corrupt. Replace the master EPROM. illegal memory type detected in master – Retry, Abort The master EPROM device has illegal configuration data. Replace the master EPROM. Invalid master configuration data The configurable data of the master device is corrupt, or else the master device is blank. Replace the master EPROM.
Appendix C Configuration Parameters Table C–1 describes the valid configuration parameters for the programmers discussed in this manual. Use of invalid parameters will result in programming errors. Table C–1. Valid Configuration Parameters Device Family Device 1st Name Start Size VCC VPP Pdt Ctrl Reg. Family Code 27128 TMS27C128 0000h 4000h 27256 TMS27C256 0000h 8000h EPROM 6 12.5 01 00h 42h No 0s only EPROM 6 12.
C-2 Configuration Parameters
Appendix D Using Keystroke Capture Files A keystroke capture file is a file in which the keystrokes you type are recorded 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.
Using Keystroke Capture Files Example D–1. Keystroke File Example.key C$DARW $DARW $DARW $DARW $DARW $DARW $F5 $ESC d$F3 40000h$CR f4000h$CR 4000h$CR 0ffh$CR 1\demo\a.out$CR $CR $SRECORD choose device move cursor down to 370C756 device select this device go back to top menu go to display window, select address 4000h fill memory starting at address 4000h length of fill 4000h bytes fill value 0FFh load object file ‘\demo\a.
Using Keystroke Capture Files Text Name Actual Keystroke $INS insert $LARW left arrow arrow $RAWR right arrow $SRECORD stop record $SP space $TAB tab $UARW up arrow D-3
D-4 Using Keystroke Capture Files
Index device table, 2-12 A load, 2-14 configuration parameters, 2-14 device table, 2-14 add device command, 2-9 address range, PC memory, 3-5 quit, 2-16 save, 2-15 B configuration parameters, 2-15 device table, 2-15 batch mode command descriptions, A-3 executable, A-3 nonexecutable, A-4 description, A-2 status messages, A-5 block erase, 2-8 C choose device command, 2-15 command menus, proper usage, 2-2, 3-2 commands configuration window, 2-5 differences between microcontroller and gang, 3-7 display
Index system (using DOS commands), 3-28 uploading (device’s contents), 3-19, 3-20 verify (device contents), 3-22, 3-23 description, 3-5 E edit command, 2-11 edit mode command, 3-26 editing screen values, 2-4, 3-4 error messages, B-2 cannot open file, 2-14 clearing, 2-3, 3-3 descriptions, B-2 device not selected, unable to set up the programmer, 2-16 device parameters not complete, device not added, 2-11 duplicate device name, 2-9 end address out of bound, 3-8 error occurred during programming, 3-23 fill v
Index upload, 3-27 memory, PC, 1-2 microcontroller programmer description, 1-2 features, 1-2 physical description, 1-3 move PC memory command, 3-12 O output COFF file command, 3-10 P parameters.
Index Index-4
IMPORTANT NOTICE Texas Instruments (TI) reserves the right to make changes to its products or to discontinue any semiconductor product or service without notice, and advises its customers to obtain the latest version of relevant information to verify, before placing orders, that the information being relied on is current. TI warrants performance of its semiconductor products and related software to the specifications applicable at the time of sale in accordance with TI’s standard warranty.