Tektronix VM700T Programmer's Manual
Tektronix VM700T Programmer's Manual

Tektronix VM700T Programmer's Manual

Video measurement set option 48 gpib interface
Hide thumbs Also See for VM700T:
Table of Contents

Advertisement

Programmer Manual
VM700T Video Measurement Set
Option 48 GPIB Interface
070-9657-00

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the VM700T and is the answer not in the manual?

Questions and answers

Summary of Contents for Tektronix VM700T

  • Page 1 Programmer Manual VM700T Video Measurement Set Option 48 GPIB Interface 070-9657-00...
  • Page 2 Programmer Manual VM700T Video Measurement Set Option 48 GPIB Interface 070-9657-00...
  • Page 3 Commercial Computer Software – Restricted Rights clause at FAR 52.227-19, as applicable. Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supercedes that in all previously published material. Specifications and price change privileges reserved.
  • Page 4 Tektronix, with shipping charges prepaid. Tektronix shall pay for the return of the product to Customer if the shipment is to a location within the country in which the Tektronix service center is located.
  • Page 6: Table Of Contents

    ........... . 2–12 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 7 ......... . Index VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 8 Table B-1: GPIB Diagnostic Tests ......VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 9 Table of Contents VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 10: Preface

    Programmer Manual. That manual contains the keywords lists for all of the options and samples of the get results files that are sent by the VM700T Video Measurement Set when commanded to do so. That manual also describes how to use the Function Key feature.
  • Page 11 Preface VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 12: Getting Started

    Getting Started...
  • Page 14: Standards

    Programmer Manual. That manual contains the keywords lists for all of the options and samples of the get results files that are sent by the VM700T Video Measurement Set when commanded to do so. That manual also describes how to use the Function Key feature.
  • Page 15: Setup

    NOTE. The GPIB address is factory set to address 1. You can change the VM700T GPIB card to any address in the range of 0–30, offline, and talk only. Offline takes the GPIB card off the GPIB bus. Talk Only enables the VM700T to output directly to a GPIB printer without an intervening controller.
  • Page 16: Figure 1-1: Communication Setup File

    Getting Started Figure 1–1: Communication setup file 1–3 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 17: Operation

    GPIB device address message from the VM700T. The device address message is sent to the GPIB card by the VM700T at power-up if GPIB is selected as the Remote Port. Otherwise, it is sent when the user goes into the Communication Setup file and selects GPIB for the Remote Port.
  • Page 18: Gpib Remote Mode

    Remote Control selection must be changed in the Communications Setup file. 1. Press the Configure button on the front panel of the VM700T to return to local control; then press it again to bring up the Configure menu.
  • Page 19 This may result in several commands being executed prior to finding a command that is incorrect or cannot be executed. The VM700T remains in the state determined by the last command executed.
  • Page 20: Gpib Indicator Led

    Seven LED indicators are mounted on the GPIB board. They are visible at the rear of the VM700T when the board is installed as shown in Figure 1–2. Table 1–1 defines the lamp, the lamp label, the lamp color and the meaning of the lamp being lighted.
  • Page 21: Command Set Summary

    Sending the VM700T a filemode command puts the VM700T in the File Commands Transfer mode. File Transfer mode enables file transferring to and from the VM700T over the GPIB bus. It also allows creation and deletion of directories. 1–8 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 22: Table 1-2: Gpib Command Type

    Password. The passwd File Transfer command is needed to access the file system if VM700T password file protection is in effect. This command is required each time File Transfer mode is started. Refer to the VM700T Option 01 (NTSC) and Option 11 (PAL) User Manual for more information on the password function.
  • Page 23: Gpib Remote Commands

    VM 700T application remote presses and releases a specified front-panel button remote presses, without releasing, a specified front-panel button remote releases a specified front-panel button GPIB returns a list of VM 700T/GPIB commands 1–10 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 24 Getting Started Table 1–3: VM700T GPIB Remote Commands (Cont.) Command Type Purpose GPIB returns the VM 700T/GPIB identification GPIB initializes the VM 700T/GPIB to a known state remote turns the control knob as specified by a numerical argument GPIB returns the current VM 700T mode...
  • Page 25 Getting Started 1–12 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 26: Gpib Commands

    GPIB Commands...
  • Page 28: Vm700T Command Set Detailed Description

    This section describes the VM700T Video Measurement Set GPIB commands and gives examples of how they may be used to control the operation of the VM700T and work in its internal file system through the GPIB interface option. VM700T Command Set Detailed Description This section describes the command set, in more detail.
  • Page 29: Vm700T Commands

    NOTE. GPIB cannot be selected as the control port. Control is meant for use in controlling a serial device connected to one of the RS-232 ports of the VM700T. command is usually used to control a device attached to the VM700T, such as a modem.
  • Page 30: Controlbreak

    (This happens because of the way the VM700T buffers requests.) To ensure that the break character is sent for the full amount of time...
  • Page 31: Evmsg

    GPIB Use the query to determine the GPIB event code <number> and the VM700T error number (or 0 if there is none). Use this command after an SRQ is received to find the cause of the SRQ. Compare Example: execute...
  • Page 32: Dir

    LF - EOI. These ASCII reply strings are in addition to any error messages generated in the event of a GPIB or VM command error code. If you send the Go to Local GPIB command to the VM700T while filemode is active, the GPIB filemode display will remain, but filemode is terminated. You must send an executable command to the VM700T to remove the GPIB filemode display.
  • Page 33 VM700T directory contents. Note that a file called GPIBtmp is created during execution of the command. This file is deleted when the VM700T leaves File Transfer mode. Example: 2–6 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 34: Mkdir

    GPIB Commands mkdir Syntax Form: Type: Filemode See Also: to create a new named directory in the VM700T. Example: Syntax Form: Type: Filemode See Also: to change a file’s name from filename1 to filename2. Example: passwd Syntax Form: “<passwd>” Type:...
  • Page 35: Readfile

    Type: Filemode See Also: command returns a VM700T file. The file contents can be ASCII or 8-bit binary data. The file is returned in <definite length arbitrary block> format. For example, a file that contains “abc” is returned as #6000003abc where the first digit, 6, states how many digits define the block length (000003), and abc is the data block.
  • Page 36: Rmdir

    If you want to write a pc file to the VM700T, the following procedure using IBIC commands may prove helpful in following the steps needed. 1. Edit and save the file you want to send to the VM700T. In this example we will name that file 2.
  • Page 37: Filesin

    VM700T turns EOI back on sends the pc file to the VM700T returns the VM700T back to the Waveform display Turning off EOI before the command leaves the command line open so that the second command, , will be appended. The command turns EOI back on so the end of the pc file will be appended with the EOI.
  • Page 38: Get

    Copy port output. getclock Syntax Form: Type: Remote (remote operation) command returns the date and time from the VM700T system clock in the form: where is the first three letters of the month, is the day of the month,...
  • Page 39: Getdisptext

    NOTE. This command may take an extended period of time to execute with the VM700T in the Auto Mode and for the Camera Option measurements. You must allow time for it to return with the results file message in your programming to prevent a GPIB time out error.
  • Page 40: Getspooltext

    (less if the spool memory is full). Note that spooled text is sent by the VM700T, even if GPIB is not selected as the remote port, if the copy, log, or report ports are set to GPIB, and the user initiates an action which causes the print spooler to function.
  • Page 41: Hardkey

    ASCII Printer or EPSON LQ). Since pressing the front panel button is usually a local event, the error indicator in the event of an improper format selection is to sound the VM700T alarm bell; a GPIB error or event is not generated.
  • Page 42: Hardrelease

    GPIB Commands VM700T Programmer Manual. Note also that if a button toggles (e.g., Freeze, Average) you can use again to turn it off. When specifying button names in functions or remote operation commands, match the name shown in the VM700T Programmer Manual, including upper or lower case.
  • Page 43: Init

    Example: This command turns the knob 50 clicks counterclockwise. mode? Syntax Form: Type: GPIB query returns the current mode of the VM700T. The possible modes include: Display (Waveform, Vector, or Picture) 2–16 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 44: Playback

    GPIB not active GPIB connected The GPIB card maintains the mode of the VM700T and will issue extra commands (such as ‘execute Waveform’) to put the VM700T into a known mode. For example, after a VM700T function has been executed, the GPIB card will send an command to the VM700T.
  • Page 45: Print

    The printer format must be set to output a graphics file (for example, PostScript), and your program will have to be able to handle the large data files. Example: 2–18 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 46: Query

    Communications Setup file. (Note that the path shown only applies to VM700T units equipped with both Option 01, NTSC, and Option 11, PAL.) Again, the file is sent to the GPIB only if the Copy port is set for GPIB.
  • Page 47: Res

    Remote command returns the result of executing a measurement on the VM700T. If the optional argument “-v” is given, the data returned is an ASCII string without a <definite length arbitrary block> header. Otherwise, the data returned is binary encoded data in <definite length arbitrary block> format.
  • Page 48: Rqs

    Example: command returns the result of executing a measurement on the VM700T file. This command is similar to the res command with the -v option, except that the data is returned in NR3 format. where 18 again identifies the H_Timing measurement and 1 is the first measure- ment result.
  • Page 49: Setclock

    The keywords available to use with set are listed in Appendix A: Get/Set Keywords of the VM700T RS-232 Interface Programmer Manual. Configuration values changed with remain in effect until they are changed by another command, is executed, or the instrument is powered off.
  • Page 50: Softkey

    When specifying soft key names in functions or remote operation commands, it is important to match the case (upper or lower) and any special characters used in the soft key name. Refer to Naming Conventions in the VM700T RS-232 Interface Programmer Manual, for information about the rules for specifying soft key names.
  • Page 51: Softrelease

    Measurement~Results directory. The VM700T GPIB Interface will issue an SRQ when spooled text is available. The controller can then issue a command to get the text. The spooled files will only go to GPIB if the Copy port is set to GPIB in the Communication~Setup file.
  • Page 52: Touchpress

    GPIB Commands VM700T remains in the state that is executing at the time the command is received. touchpress Syntax Form: number number Type: Remote (function playback, remote operation) Descriptive Form: x_coordinate y_coordinate See also: command indicates that a specified x,y location on the touchscreen is being “touched”.
  • Page 53 GPIB Commands 2–26 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 54: Status And Events

    Status and Events...
  • Page 56: Gpib Events

    RSQ on and RSQ off. GPIB Events The events returned from the VM700T GPIB card can consist of two parts, the GPIB code and the VM700T code. The GPIB code only is returned if the command is sent.
  • Page 57 Status and Events Table 3–1: VM700T GPIB Event Codes (Cont.) Code Description VM700T Command Errors (returned by evmsg? query) Function directory inaccessible Function not found Unknown command Unknown hard key Out of memory Recursive function call Bad command in this context...
  • Page 58 Status and Events Table 3–1: VM700T GPIB Event Codes (Cont.) Code Description VM700T File Transfer errors Verification failed Unknown descriptor Password command error Password required Incorrect password Filemode error Cannot open Cannot read Cannot write Failure in cd command Failure in pwd command...
  • Page 59: Gpib Status Bytes

    Status and Events GPIB Status Bytes A status byte is returned by the VM700T GPIB interface card when it is serial polled by a controller. Table 3–2 shows the status bytes when the RQS bit is enabled (On) and disabled (Off).
  • Page 60: Vm700T Programming Procedures

    VM700T Programming Procedures...
  • Page 62 2. Initialize the Program (these are commands within the application) Declare and initialize the program variables. This includes creating the needed libraries and linking those libraries so the program has use of the 4–1 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 63 GPIB operation. However, it remains in local until it is addressed by the GPIB controller. At that time, the VM700T goes into remote. In remote, its front panel is not totally locked out; the CONFIGURE button is still active.
  • Page 64 3. User Interface Prompt the user for operation specific information. This may be as simple as just prompting for a command input to send to the VM700T. 4. Begin the Program Start sending control commands to the instruments on the bus to perform the operations needed for your application.
  • Page 65 VM700T Programming Procedures 4–4 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 66: Appendices

    Appendices...
  • Page 68: Appendix A: Specification

    Appendix A: Specification The GPIB interface function set implemented in the VM 700T GPIB interface and the capability level is given in Table A-1. Table A-1: IEEE 488.1 Interface Functions Implemented in the VM700T GPIB Interface Card Function Implemented Notes...
  • Page 69: Table A-3: Mechanical Specifications

    Table A-4: Optional Accessories Item Description GPIB Cable 1 m, double-shielded. Tektronix Part No. 012–0991–012 m, double-shielded. Tektronix Part No. 012–0991–003m, double-shielded. Tektronix Part No. 012–0991–02 GURU II+. GPIB User’s Software/manual plus National PC2A GPIB controller board; Resource Utility for the IBM GPIB cable;...
  • Page 70: Appendix B: Gpib Diagnostics

    Failure of any diagnostic test indicates a hardware problem that requires servicing. The VM700T may function for local operation, but may be faulty for remote operation if a GPIB Diagnostic test fails. Refer to the VM700T Option 01 (NTSC)/Option 11 (PAL) User Manual to configure the Diagnostic Test Selection file to either run or skip the GPIB diagnostic on power-up of the VM700T.
  • Page 71: Power-Up Mode

    This continues until all the test are com- pleted, and then returns to the first menu screen for selecting run mode. Figure B-2: Interactive run mode menu after running first main test VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 72: Gpib Diagnostic Routines

    –Pass– Bit 3 Control –––––– –––––– –––––– –––––– –Pass– Bit 4 Control –––––– –––––– –––––– –––––– –Pass– Bit 5 Control –––––– –––––– –––––– –––––– –Pass– Bit 6 Control –––––– –––––– –––––– –––––– –Pass– VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 73 –––––– –––––– –––––– –––––– –Pass– Readable –––––– –––––– –––––– –––––– –Pass– Writable –––––– –––––– –––––– –––––– –Pass– Bit 0 Control –––––– –––––– –––––– –––––– –Pass– Bit 1 Control –––––– –––––– –––––– –––––– –Pass– VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 74 –––––– –Pass– GP Spurious Ints ––––– –––––– –––––– –––––– –––––– –Pass– Level 7 (NMI) –––––– –––––– –––––– –––––– –Pass– Level 6 –––––– –––––– –––––– –––––– –Pass– Level 5 –––––– –––––– –––––– –––––– –Pass– VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 75 –––––– –––––– –Pass– GP Get Int –––––– –––––– –––––– –––––– –––––– –Pass– Int Occurs –––––– –––––– –––––– –––––– –Pass– Int Clears –––––– –––––– –––––– –––––– –Pass– Int Disables –––––– –––––– –––––– –––––– –Pass– VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 76 Index...
  • Page 78 2–14 hardrelease, 2–15 help?, 2–15 event?, 2–3 id?, 2–15 event? command, 3–1 init, 2–16 evmsg?, 2–4 knob, 2–16 evmsg? command, 3–1 ls, 2–6 execute, 2–4 mkdir, 2–7 execute Waveform, 2–17 mode?, 2–16 Index–1 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 79 GPIB syntax, 1–6 Operation, 1–4 GURU II software, 4–1 optional –V argument, 2–20 hardkey, 2–14 passwd, 2–7 for pressing the COPY button, 2–14 passwd File Transfer, 1–9 hardpress, 2–14 playback, 2–17 hardrelease, 2–15 Index–2 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 80 VM700T GPIB events, 3–1 rqs, 2–21 VM700T GPIB Interface Messages, 1–8 RQS bit, 3–4 VM700T syntax, 1–6 rqs?, 2–21 RS-232 and GPIB remote differences, 1–5 writefile, 2–9 SDC (Selected Device Clear), 1–8 Index–3 VM700T Option 48 GPIB Interface Programmer Manual...
  • Page 81 Index Index–4 VM700T Option 48 GPIB Interface Programmer Manual...

Table of Contents