Tektronix 2714 Programmer's Manual
Tektronix 2714 Programmer's Manual

Tektronix 2714 Programmer's Manual

Spectrum analyzer
Hide thumbs Also See for 2714:
Table of Contents

Advertisement

Quick Links

Programmer Manual
2714 & 2715
Spectrum Analyzer
070-8533-05
This document supports Firmware
Version 10.28.98.

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Summary of Contents for Tektronix 2714

  • Page 1 Programmer Manual 2714 & 2715 Spectrum Analyzer 070-8533-05 This document supports Firmware Version 10.28.98.
  • Page 2 Copyright © Tektronix, Inc. All rights reserved. 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. Printed in the U.S.A.
  • Page 3 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 5 ........... 6–46 2714 & 2715 Programmer Manual...
  • Page 6 ........B–14 Index 2714 & 2715 Programmer Manual...
  • Page 7: Table Of Contents

    ........1–17 2714 & 2715 Programmer Manual...
  • Page 8: Figure 6-2: Terminal Display Before Catv Xmod Test Begins

    ..... . B–11 Figure B–4: Handshake Timing Sequence, Idealized ... . . B–12 2714 & 2715 Programmer Manual...
  • Page 9 ......5–12 Table 5–5: Specific Device-Dependent Status Bytes ....5–13 2714 & 2715 Programmer Manual...
  • Page 10 Table B–3: Interface Messages and Functions: Remote Messages Sent ..B–8 Table B–4: ASCII and GPIB Code Chart ..... . . B–9 2714 & 2715 Programmer Manual...
  • Page 11 Introduction...
  • Page 13 Introduction to Programming The Tektronix 2714 or 2715 Spectrum Analyzer allows remote control of its functions with one of two communication port options. Option 08 provides an RS-232 data communications interface; Option 03 provides an IEEE Standard 488.1 General Purpose Interface Bus (GPIB) communications interface.
  • Page 14 The control program must be ready to receive the incoming data. In the following subsections you will learn how to set up your 2714 or 2715 for RS-232 operation. Appendix A: RS-232 Concepts provides additional information concerning RS-232 imple- mentation for the 2714 or 2715 including wiring for connectors and null-modem adapters.
  • Page 15 IC language, optional arguments in the OPEN statement can supply RS-232 configuration settings. 2714 or 2715 Equipped Your 2714 or 2715 Spectrum Analyzer must be equipped with an RS-232 port to with RS-232 Interface communicate over the RS-232 interface. If your 2714 or 2715 is equipped with the GPIB interface (Option 03), refer to GPIB Operation later in this section.
  • Page 16: Figure 1-1: Two Rs-232 System Configurations

    Interconnecting Cable An appropriate cable is required to connect between the controller and the spectrum analyzer. The pinout and connector type on the 2714 or 2715 are identical to the 9-pin connector used for PC/AT type RS-232 interfaces. Such cables are available in most computer stores. For some RS-232 devices, null-modem adapters will be needed.
  • Page 17: Menu

    To set the spectrum analyzer configuration settings, turn on the power to the 2714 or 2715 and press the key sequence [UTIL] [4] [0] [2] on the spectrum analyzer KEYPAD. An RS-232 PORT CONFIGURATION Menu appears that is similar to the one shown in Figure 1–2.
  • Page 18: Figure 1-2: The Rs-232 Port Configuration Menu

    ON/OFF Figure 1–2: The RS-232 Port Configuration Menu Placing the 2714 or 2715 Online. Item 0 of the RS-232 PORT CONFIGURATION Menu, STATUS, controls the RS-232 online/offline status. When the status is set to OFFLINE, the RS-232 interface is ignored; data is neither received nor transmitted.
  • Page 19 It then sets RTS FALSE. Data is received while RTS is FALSE until the buffer overflows. If the buffer is allowed to overflow, the spectrum analyzer signals an error (Event 372), and incoming data is discarded. 1–7 2714 & 2715 Programmer Manual...
  • Page 20 H If NONE is specified, you must ensure that buffers do not overflow. This can be done by allocating enough buffer space to handle most contingencies. A buffer size of 1200 is sufficient for most purposes. The 2714 or 2715 uses a 1200-byte, internal input buffer.
  • Page 21 This method of driver configuration is recommended because it sets the driver to a known, and presumably correct, operating state from within the application program and just prior to actual operation. If the 1–9 2714 & 2715 Programmer Manual...
  • Page 22 Tektronix HC100 plotter is recommended. Its four pens provide a useful complement to the four-trace capability of the 2714 or 2715. A serial printer or plotter, such as the Tektronix HC100 Option 03, can be attached to the spectrum analyzer’s RS-232 interface instead of a computer controller.
  • Page 23 GPIB Operation (Option 03) Option 03 adds a General Purpose Interface Bus (GPIB) port. This GPIB port conforms to the IEEE 488.1 Standard and to the Tektronix Interface Standard for GPIB Codes, Formats, Conventions, and Features. This standard promotes ease...
  • Page 24 (generally supplied with the GPIB board). In the following subsections you will learn how to set up your spectrum analyzer for GPIB operation. See Appendix B: GPIB System Concepts for additional information concerning IEEE 488.1 and the GPIB. 1–12 2714 & 2715 Programmer Manual...
  • Page 25 Introduction to Programming Operation Over the GPIB The following equipment is required to operate the 2714 or 2715 Spectrum Analyzer over the General Purpose Interface Bus (GPIB): H System controller H Software device driver H 2714 or 2715 equipped with the GPIB interface (Option 03)
  • Page 26: Figure 1-3: Typical Small Instrument System For Gpib

    Figure 1–3: Typical Small Instrument System for GPIB 2714 or 2715 Equipped Your 2714 or 2715 must be equipped with the Option 03 GPIB interface to with the GPIB Interface operate over the General Purpose Interface Bus. Refer to RS-232 Operation (Option 08) on page 1–1 for configuration information if your instrument has...
  • Page 27 A GPIB PORT CONFIGURATION Menu appears. It should resemble the one shown in Figure 1–5. You will use this menu to configure the GPIB parameters. Placing the 2714 or 2715 Item 0 of the GPIB PORT CONFIGURATION Menu, STATUS, controls the Online GPIB ONLINE/OFFLINE status (see Figure 1–5).
  • Page 28: Figure 1-4: Connecting Multiple Instruments On The Gpib

    Address spectrum analyzer’s GPIB device address. You must assign a primary address to the spectrum analyzer (the 2714 or 2715 does not support secondary addresses). The address can have a value from 0 through 30. However, addresses 0 and 30 are usually reserved for system controllers.
  • Page 29: Figure 1-5: The Spectrum Analyzer's Gpib Port Configuration

    Therefore, the default setting of item 2, POWER ON SRQ, is OFF. However, some test sequences require that the power to the spectrum analyzer is removed (power down). Under these conditions it may be beneficial for the program to sense the return of power. 1–17 2714 & 2715 Programmer Manual...
  • Page 30 EOI is still asserted (brought to its low state) simulta- neously with the transmission of LF. All Tektronix instruments and controllers are equipped to use the EOI selection. You should, therefore, toggle item 3 of the GPIB PORT CONFIGURATION Menu until its status changes to EOI.
  • Page 31: Table 1-1: National Instruments Pcii Board Characteristics

    NOTE. You must assign the same GPIB address to the spectrum analyzer that was used when configuring the device driver for the spectrum analyzer. Use the EOI message terminator for all Tektronix controllers. Table 1–1: National Instruments PCII Board Characteristics...
  • Page 32: Table 1-3: Tek_Sa Device Characteristics

    GPIB. Use the following procedure. Refer to your DOS manual if you need help creating or modifying files. 1. Copy GPIB.COM to your computer’s root directory. 2. Add the following line to your CONFIG.SYS file: device=GPIB.COM 1–20 2714 & 2715 Programmer Manual...
  • Page 33 Down Down All bits should be set when the Tektronix HC100 plotter is in LISTEN ONLY mode, and its power must be cycled to load the settings into memory. You must also correctly configure the plotter DEVICE CHARACTERISTICS using the IBCONF file.
  • Page 34 Functional Groups provides a summary of the messages. Command and Query Definitions describes the individual messages in detail, and Programming provides some programming examples for the National Instruments GPIB/2714 or 2715 combination working in the QuickBASIC environment. The spectrum analyzer is addressed as a talker or listener to send or receive messages, depending on whether messages are being sent to or received from the system controller.
  • Page 35 [0]). The instrument is nominally ONLINE, but is not yet handshaking with the controller. 3. Start the program. The computer display shows: 2714 or 2715 SHOULD NOW BE HANDSHAKING NDAC SHOULD BE DISPLAYED PRESS ANY KEY TO CONTINUE When the spectrum analyzer is handshaking with the controller, NDAC (Not Data ACcepted) is displayed at the lower right of the spectrum analyzer’s...
  • Page 36 4. Press any key. The word REMOTE should appear at the lower left of the spectrum analyzer’s screen and the controller should display these messages: 2714 or 2715 SHOULD NOW BE IN REMOTE MODE PRESS ANY KEY TO CONTINUE The National Instruments software places the spectrum analyzer in remote mode whenever a message is sent (the message HDR ON was transmitted).
  • Page 37 Introduction to Programming NOTE. The 2714 or 2715 must have a spectral display on its screen when any RS-232 or GPIB program is executed. If the 2714 or 2715 is displaying a menu when a program is executed, the program will not run properly.
  • Page 38 Introduction to Programming 1–26 2714 & 2715 Programmer Manual...
  • Page 39 Message Structure...
  • Page 41 When the GPIB interface is installed, generic GPIB messages are exchanged between the system controller and the 2714 or 2715 in addition to instrument- specific messages. Generic GPIB messages exercise control over the bus and carry out routine system operations such as instrument addressing, handshaking, requesting service, and terminating messages.
  • Page 42 HDR ON is selected (see Command and Query Definitions). Both messages close with a message terminator “Bye bye”. The instrument-specific messages for the 2714 or 2715 are constructed in a similar way. The following definitions clarify the structure. Message Unit A message unit is a single command, query, or response.
  • Page 43 A semicolon (;) must be used to delimit or separate message units in a message. Following the last message unit, the use of a delimiter is optional with one exception. The 2714 or 2715 always appends a message unit delimiter as the last data byte when it sends a response.
  • Page 44 Some commands have no arguments, or only one argument, and may not require header or argument delimiters. For instance, the command returns the 2714 or 2715 to local control without adding arguments or delimiters. Query A query consists of a query mnemonic or header, a question mark (?), header delimiter, and an argument.
  • Page 45 Argument An argument is the value that a command, query, or response transfers to or from its associated 2714 or 2715 setting(s). For instance, from the command FREq 200 MHZ the value of 200 MHz is transferred to the center frequency setting. Arguments may be numbers (with or without units), characters, strings, or linked with a colon (:).
  • Page 46 2715. It does not wait for the message terminator. Once processing begins, the 2714 or 2715 remains busy until it is done executing the commands in its input buffer unless the process is stopped by a BREAK. BREAK is sensed by the interface as a null character together with a framing error.
  • Page 47 Message processing begins as soon as messages are received by the 2714 or 2715; it does not wait for the message terminator. The 2714 or 2715 remains busy until it is done executing the commands in its input buffer, unless the process is stopped by the DCL (Device Clear) or SDC (Selected Device Clear) GPIB messages.
  • Page 48 However, message units may be combined using message delimiters (;) to form more complex messages like this one: FREq 200 MHZ;SAVe A:ON;CURve? Notice that commands and queries can be mixed in a single message. 2–8 2714 & 2715 Programmer Manual...
  • Page 49: Commands

    (msec) when used within the TIME command, but it represents 10 command. Commands that use a dB unit require the entire unit to avoid confusion between the various dB units. For instance, the command REFlvl must be 2–9 2714 & 2715 Programmer Manual...
  • Page 50 (required) (space) Most queries recognized by the 2714 or 2715 have no arguments, but a few have one argument. There are no queries with multiple arguments. Following are several examples of queries to which the 2714 or 2715 will respond:...
  • Page 51 MAMpl DELTA:18.5; 18.5; Most responses consist of an optional header and the response argument. However, responses such as the WFMpre? response have many arguments separated by commas (,). Others, including the response to CURve?, contain 2–11 2714 & 2715 Programmer Manual...
  • Page 52 Headers The 2714 or 2715 understands uppercase letters, lowercase letters, or a mixture of upper and lowercase letters in command and query headers. Our examples use the long form of command and query headers.
  • Page 53 The line feed character can be used instead of a semicolon (;) to delimit message units in a single message. The 2714 or 2715 will substitute line feeds for semicolons in its responses when MSGdlm is set to LF. Line feed can also be used as a message terminator with controllers that do not support the GPIB EOI protocol.
  • Page 54 Instrument-Specific Message Structure 2–14 2714 & 2715 Programmer Manual...
  • Page 55 Functional Groups...
  • Page 57 The capital letters in a header indicate the minimum number of letters that must be supplied for the 2714 or 2715 to recognize the header. For instance, the query ACQ? would produce the same response as the query ACQmode?. The lowercase letters are optional, additional letters that may be used to clarify the meaning of the header.
  • Page 58: Table 3-1: Commands And Queries

    Functional Groups The Command/Query List Table 3–1 lists all the commands available for controlling the 2714 or 2715 Spectrum Analyzer. This table provides the correct form of each command and query header. Table 3–1 is a convenient reference for the mnemonics of each command or query for users who are already familiar with instrument functions.
  • Page 59 VSYnc? OBWResult? SAVe? TOPsig WAIt PKHeight SET? TRIgger WAVfrm? PKHeight? SGErr TRIgger? WFMpre PLLmode SGErr? TTLMode WFMpre? PLLmode? SGSrch TTLMode? ZERosp PLOT? SGTrak TUNe ZERosp? POFset SGTrak? TVLine POFset? SIGswp TVLine? PRDouts? SIGswp? TVLMode 3–3 2714 & 2715 Programmer Manual...
  • Page 60 Command And Query Functional Groups Tables 3–2 through 3–16 show how the commands and queries available for programming the 2714 or 2715 correspond to the front panel controls and menu selections. An illustration of each front panel function block or menu is shown.
  • Page 61: Table 3-2: Freq/Mkrs Front Panel Commands

    Equivalent to turning the knob one click to the left. PSTep Equivalent to turning the knob one click to the right. SGTrak Turn signal tracking on and off. SGTrak? Is signal tracking on or off? TUNe Change frequency. 3–5 2714 & 2715 Programmer Manual...
  • Page 62: Table 3-3: Mkr/Freq Menu Commands

    4 FREQ OFFSET MODE MAMpl?, MKTime?, TAMpl?, and TFReq? return on-screen measurement parame- ters. MPOs? and MVPos? have no visible effect when the 2714 or 2715 has an analog display (all Display Storage registers disabled). Table 3–3: MKR/FREQ Menu Commands...
  • Page 63 THRhld Replace the auto threshold with the specified value. THRhld? What is the threshold value? TMOde Select the knob function. TMOde? What is the knob function? TOPsig Change reference level to the marker amplitude. 3–7 2714 & 2715 Programmer Manual...
  • Page 64: Table 3-4: Frequency, Span/Div And Ref Level Front Panel

    Set/increment/decrement reference level. REFlvl? What is the reference level? SPAn Select the frequency span per division. SPAn? What is the frequency span? ZERosp Turn ZERO SPAN on and off. ZERosp? Is ZERO SPAN on or off? 3–8 2714 & 2715 Programmer Manual...
  • Page 65: Table 3-5: Vert Scale, Plot, And Readout Front Panel

    1 PREAMP RLUnit 3 REF LEVEL UNIT DBUVM MXRlvl 4 1ST MXR INPUT LVL –30DBM ARFatt, RFAtt 5 RF ATTENUATION AUTO 50DB ROFset, ROMode 6 EXTERNAL ATTEN/AMPL NONE CALsig 9 CAL SIG @ 100MHZ –30DBM 3–9 2714 & 2715 Programmer Manual...
  • Page 66: Table 3-6: Input Menu Commands

    What is the measurement distance? VMDEst Select destination register in dBmV/m mode. VMDEst? What is the destination register? VMMkrunit Select marker units of dBmV/m or Volts/m in dBmV/m mode. VMMkrunit? What is the marker unit in dBmV/m mode? 3–10 2714 & 2715 Programmer Manual...
  • Page 67: Table 3-7: Swp/Trig Menu Commands

    What is the number of the TV line to trigger on? TVLMode Select continuous or programmed TV line trigger. TVLMode? Is continuous or programmed TV line trigger used? TVLStd Select TV standards used in various countries. TVLStd? What TV standard is being used? 3–11 2714 & 2715 Programmer Manual...
  • Page 68: Table 3-8: Sweep And Res Bw Front Panel Commands

    What is the status of the single sweep mode? TIMe Select/increment/decrement the sweep speed. TIMe? What is the sweep speed? TIMMode Select auto, manual, or programmed sweep mode. TIMMode? What sweep mode is selected? 3–12 2714 & 2715 Programmer Manual...
  • Page 69: Table 3-9: Display Storage Front Panel Commands

    Is storage on or off in any or all registers? VIEw Turn display on and off in any or all registers. Also turns waterfall and B,C minus A modes on and off. VIEw? What is the display status of any or all registers? 3–13 2714 & 2715 Programmer Manual...
  • Page 70: Table 3-10: Dspl Menu Commands

    AVDest? What is the destination register for averaging? Turn ensemble averaging on and off. AVG? Is ensemble averaging on or off? AVMode Select the ensemble averaging mode. AVMode? What is the ensemble averaging mode? 3–14 2714 & 2715 Programmer Manual...
  • Page 71 Display the indicated text as a title in title mode. TITLe? What is the title? TTLMode Turn title mode on and off. TTLMode? Is title mode on or off? VIEw Minusa: Turn B,C MINUS A mode on and off. 3–15 2714 & 2715 Programmer Manual...
  • Page 72 CATv LINe: 7 FREQUENCY RESPONSE CATv FRSp:REF CATv FRSp:NOREF CATv REFRecall: 8 CATV MEASUREMENTS SETUP CATv CHTbl: CATv CHDel: CATv MODE:OFF 9 MORE CATv SKIp: CATv ACHan: CATv SITe: *2715 only CATv OPErator CATv REMove 3–16 2714 & 2715 Programmer Manual...
  • Page 73 7 CROSS MODULATION CATv STOre:XMOd CATv XMMode:TDomain or FDomain (2715 Only) ICFreq 8 IN-CHANNEL RESPONSE ICDefault CATv ICLine:<int> (2715 Only) CATv ICR:PAUse or CATv ICR 9 MORE CATv ICR:INServe (2715 Only) *2715 only CATv STOre:ICR 3–17 2714 & 2715 Programmer Manual...
  • Page 74: Table 3-11: Catv/Appl Menu Commands (Catv Mode Active)

    What are the results of the last CSO measurement? CATv DEPth: Perform the depth of modulation measurement. CATv? DEPth What are the results of the last depth of modulation measurement? CATv DPAdj: Turn modulation depth adjustment mode on or off. 2715 only. 3–18 2714 & 2715 Programmer Manual...
  • Page 75 What is the video line number set for the in-service test? CATv ICR: Perform the in-channel response measurement. CATv? ICR What are the results of the last in-channel response measurement? CATv LINe: Select 50 Hz or 60 Hz power line frequency. 2715 only. 3–19 2714 & 2715 Programmer Manual...
  • Page 76 What is the current cross modulation measurement mode? CATv XMOd Perform the cross modulation measurement. CATv? XMOd What are the results of the last cross modulation measurement? CONT RST Provides continuous measurement for a period of 24 hours. 2715 only. 3–20 2714 & 2715 Programmer Manual...
  • Page 77 Recall the default values for the AUTO TEST LOCATIONS table used by the In-Channel Response test. SURv FASt: Turn the fast carrier survey mode on or off. SURv? FASt What is the on/off status of the fast carrier survey mode? 3–21 2714 & 2715 Programmer Manual...
  • Page 78 0 DB DOWN FOR BW MODE –3DBC CNBw 1 NORM BW FOR C/N 5.0MHZBW NNBw 2 NOISE NORM’D BW 1.0HZBW 3 PERCENT OCCUPIED BW NOTE. BWResult?, CNResult?, and NNResult? return results normally displayed on the screen. 3–22 2714 & 2715 Programmer Manual...
  • Page 79 Set the ending signal search frequency. SSEnd? What is the ending signal search frequency? SGSrch THRhld Search for signals greater than threshold ( ) between beginning and ending search frequencies. SSResult? What is the result of the signal search? 3–23 2714 & 2715 Programmer Manual...
  • Page 80: Table 3-13: Util Menu Commands

    What is the time of day? CLOck Turn the date and time display on or off. CLOck? Is the date and time display on or off? ERAse Erase the stored settings in a particular register. 3–24 2714 & 2715 Programmer Manual...
  • Page 81 Functional Groups Table 3–13: UTIL Menu Commands (Cont.) Header Function List the 2714 or 2715’s firmware version and installed options. INIT Reset to user-defined or factory power-up settings. NORM Carry out the indicated normalizations. NORM? Return a list of current normalization parameters.
  • Page 82: Table 3-14: Demod Menu Commands

    Is the the video monitor on or off? VPOlarity Select positive or negative video polarity. VPOlarity? Is positive or negative video polarity selected? VSYnc Select positive or negative video sync polarity. VSYnc? Is positive or negative sync polarity being used? 3–26 2714 & 2715 Programmer Manual...
  • Page 83: Commands

    Turn the response header on and off. HDR? Is the response header on or off? HELp? 2714 or 2715 sends a list of valid GPIB command headers. MSGdlm Select semicolon or line feed as response delimiter. MSGdlm? What is the response delimiter? Enable or disable SRQs (except power-on SRQ).
  • Page 84: Table 3-17: Miscellaneous Commands

    2714 or 2715’s display screen. Table 3–17: Miscellaneous Commands Header Function CLRMenu Clear the menu on the 2714 or 2715’s screen. CLRKey Clear the last key pressed. DEFMenu Write a menu on the 2714 or 2715’s screen.
  • Page 85 Command/Query...
  • Page 87 This section contains an alphabetical listing of all instrument-specific commands and queries. The list defines each command or query. In addition, it contains all the information needed to send messages to the 2714 or 2715, or to interpret the responses from the 2714 or 2715.
  • Page 88 When a large range of responses is possible (such as numeric values), typical examples are shown as in this example: QUERY? QUERY 10.500E+3 (for example) Typical examples are always followed by this phrase: (for example) 4–2 2714 & 2715 Programmer Manual...
  • Page 89 List of Commands and Queries The following list of commands and queries provides detailed information about the 2714 or 2715 instruction set. This section does not attempt to explain the operation of the spectrum analyzer. Refer to the user manual for the 2714 or 2715 for descriptions of the 2714 or 2715 or its features and functions.
  • Page 90 1). If no argument is specified, the currently selected table is returned. ATBl? 3 ATBL ANTENNA 3 Cal Distance = 3.0 Meters Frequency Factor(dB) ------------------------- 100.0MHz 200.0MHz 300.0MHz 1.8GHz 18.0 ------------------------- "; (for example) 4–4 2714 & 2715 Programmer Manual...
  • Page 91 AVDest B AVDest C AVDest? Arguments: None This simple query returns the spectrum analyzer display register currently selected as the destination for MIN Hold and ensemble average functions. AVDest? AVDEST A AVDEST B AVDEST C 4–5 2714 & 2715 Programmer Manual...
  • Page 92 This single-argument command designates the ensemble average mode. AVMode MAX AVMode MAXMin AVMode MEAN AVMode MIN AVMode? Arguments: None This simple query returns the currently selected ensemble averaging mode. AVMode? AVMODE MAX AVMODE MAXMIN AVMODE MEAN AVMODE MIN 4–6 2714 & 2715 Programmer Manual...
  • Page 93 BWMode OFF BWMode IDLE BWMode IDLE has the same effect as BWMode ON. BWMode? Arguments: None This simple query returns the status of the bandwidth measurement mode. BWMode? BWMODE ON BWMODE OFF BWMODE IDLE 4–7 2714 & 2715 Programmer Manual...
  • Page 94 CALSig ON CALSig OFF CALSig? Arguments: None This simple query returns the on/off status of the calibration signal. CALSig? CALSIG OFF CALSIG ON 4–8 2714 & 2715 Programmer Manual...
  • Page 95 CATv MODe:ON enables the CATV mode. When running a CATV measurement routine (such as CTB:AUTo), the 2714 or 2715 pauses when prompts appear on its screen. The pause generates event code 403, which must be cleared before the measurement will continue. A pause may...
  • Page 96: Table 4-1: Catv Command Arguments

    Skip status is always ignored. Event code 801 and the message RANGE ERROR is returned if the channel is not defined in the current channel table. The channel number remains unchanged under these circumstances. 2715 only. 4–10 2714 & 2715 Programmer Manual...
  • Page 97 You may change equipment setup, but you cannot adjust the 2714 or 2715 controls. The measurement proceeds after you respond to the prompt. If the current channel is identified in the channel table as DIGITAL, then CN:PAUse will run the desired-to-undesired measurement.
  • Page 98 CSO:SINgle Perform the single-sweep version of the CSO measurement, which minimizes carrier-off time. In this mode the 2714 or 2715 pauses and generates event code 403 (USER REQUEST OR CATV PROMPT) after measuring the carrier. The user is then prompted to turn the carrier off.
  • Page 99 Set listen mode to on so you can listen to demodulated audio. MODe:OFF Turn CATV mode off. MODe:ON Turn CATV mode on. The 2714 or 2715 will tune to the last active channel and install the base settings. NBW:<num> Set the noise bandwidth used for carrier-to-noise measurements to <num>.
  • Page 100 Set view picture mode to OFF. VPIc:ON Set view picture mode to ON. This mode allows you to view a demodulated television picture on the 2714 or 2715’s screen. XMMode:FDomain Sets the measurement mode for the cross modulation measurement to the frequency domain method.
  • Page 101: Table 4-2: Catv? Query Arguments

    2nd aural carrier frequency relative to visual carrier in Hz. If a result is not actually measured, 1.0 E 38 is returned in its place. See FULLCLVl. 2715 only. 4–15 2714 & 2715 Programmer Manual...
  • Page 102 Quoted string naming the channel table 2. <chan> Channel number as nr1 3. <datime> Date and time as a quoted string 4. <site> Site as a quoted string 5. <operator> Operator as a quoted string 4–16 2714 & 2715 Programmer Manual...
  • Page 103 VFIELD:ON or CATV VFIELD:OFF. Returns the status of the view modulation (line) mode as CATV VLIne VLINE:ON or CATV VLINE:OFF. Returns the status of the view picture mode as CATV VPIC:ON or VPIc CATV VPIC:OFF. 2715 only. 4–17 2714 & 2715 Programmer Manual...
  • Page 104 CFSF? CFSF CENTER CFSF START Arguments: ON, OFF CLOck <arg> This single-argument command turns the date and time display on and off. CLOck ON CLOck OFF 4–18 2714 & 2715 Programmer Manual...
  • Page 105 Arguments: frequency in the range 1 Hz to 1.8 GHz This single-argument command specifies the bandwidth used by the carrier-to- noise (C/N) feature to perform a C/N measurement. Hertz are used if no units are appended. CNBw 4.0 MHz (for example) 4–19 2714 & 2715 Programmer Manual...
  • Page 106 (C/N) measurement performed by the spectrum analyzer’s C/N feature. The measurement is updated at the end of the current sweep if C/N mode is enabled. CNMode must be set to ON to obtain valid results. CNResult? CNRESULT -4.65E+1 (for example) 4–20 2714 & 2715 Programmer Manual...
  • Page 107 CONTinue Arguments: None This is a command that resumes an operation after the 2714 or 2715 pauses to display a prompt. Event code 403 (CATV PROMPT) is generated when the 2714 or 2715 is paused. This command clears the prompt in the same way that pressing the [W] key does.
  • Page 108 (for example) CSFreq?/CTFreq? Arguments: None This simple query returns the complete AUTO TEST FREQUENCIES table in this format: BTFreq 5,1 <type>,<freq>,2,<type>,<freq>,... 5,<type>,<freq> The <type> field contains one of the three parameters (REL, ABS, or DEL). 4–22 2714 & 2715 Programmer Manual...
  • Page 109 <arg>. DEL sets the carrier frequency to the default. This command sets the carrier frequency for the CATV continuous CSO test. For example, the following command sets the carrier frequency to 200 MHz: CSRFreq ABS, 200MHz; 4–23 2714 & 2715 Programmer Manual...
  • Page 110 Binary responses always start with these characters Binary: CURVE%fF&ÇwNc)*§>V...0¶; Hexidecimal responses always start with these characters CURVE#H02015E21B0F...E7B; ASCII-encoded hexidecimal: ASCII responses have no coding indicator or byte count characters ASCII-encoded hexidecimal: CURVE94,233,7,182,...51,2,16; 4–24 2714 & 2715 Programmer Manual...
  • Page 111: Figure 4-1: Format Of Curve Data

    H The use of delimiters in decimal encoding makes this form compatible with many spread sheets and word processors. This enables you to create custom waveforms for later transmission to the spectrum analyzer, or to edit waveforms previously returned from the spectrum analyzer. 4–25 2714 & 2715 Programmer Manual...
  • Page 112: Figure 4-2: Spectrum Analyzer Graticule Coordinates

    Therefore, the sixth data point (5) along the vertical axis crosses the bottom graticule line. The 245 point crosses the top graticule line. See Programming for programming examples using CURve and CURve?. 4–26 2714 & 2715 Programmer Manual...
  • Page 113 0. The MON field may be any mixture of uppercase and lowercase letters. Note that these elements are separated by dashes (–), and the quotation marks (") must be present. DATe 10-JAN-90" 4–27 2714 & 2715 Programmer Manual...
  • Page 114 User-Defined Menu. The DEFMenu command also clears the last key press, but only if the User-Defined Menu space is clear. See Programming for an example. DEFMenu L0:"TEST MENU" DEFMenu L0:"TEST MENU",L2:"TEST 1",L3:"TEST 2" 4–28 2714 & 2715 Programmer Manual...
  • Page 115 Each line in the listing (except the first and last) is formatted as in this example: filename, read/write enabled (R or W), size in bytes DIR? DIR  12.88, TMPDBG, RW, 16380 12.88, , DSET00, RW, 386 4–29 2714 & 2715 Programmer Manual...
  • Page 116 DIScor OFF DIScor? Arguments: None This simple query returns the current on/off status of the spectrum analyzer’s frequency corrections. Note that DISCOR ON means the frequency corrections are off. DIScor? DISCOR ON DISCOR OFF 4–30 2714 & 2715 Programmer Manual...
  • Page 117 Alarm when signal > display line UNDer Alarm when signal < display line OVUNder Alarm when signal > display line or when signal < threshold No alarm DLLimit OFF DLLimit OVEr DLLimit OVUNder DLLimit UNDer 4–31 2714 & 2715 Programmer Manual...
  • Page 118 If FM or EXTernal is selected, the spectrum analyzer is placed in zero span mode and max/min signal acquisition is selected. FM and EXTernal are not allowed in DBUVM mode. DSRc AM DSRc EXTernal DSRc FM 4–32 2714 & 2715 Programmer Manual...
  • Page 119 PROTSET is ON), only the waveforms associated with the indicated settings are erased and an SRQ and event 839 are generated. If register 9, 19, or 29 is specified, an SRQ and Event 701 are generated. ERAse 2 ERAse 24 (for example) 4–33 2714 & 2715 Programmer Manual...
  • Page 120 For instance, you might develop a User Definable Program (UDP) in one 2714 or 2715, transfer it to the controller using the FILE? query, and subsequently download it to a number of other spectrum analyzers using the 4–34...
  • Page 121: Table 4-3: File Types

    Normalization files save data generated by normalizing the spectrum analyzer, including reference normalizations. Channel Table Each file saves data pertaining to a particular channel in numbered locations. Numbers correspond to tables accessed under [CATV APPL] [8] [1]. 4–35 2714 & 2715 Programmer Manual...
  • Page 122: Table 4-4: Valid File Names

    These files should not be altered. If HDR was OFF when the file was returned, FILE" must precede the disk file. In this case, transmit the following message: FILE FILEDAT$ See Programming for programming examples. 4–36 2714 & 2715 Programmer Manual...
  • Page 123 Follow this sequence to store a spectrum analyzer file: 1. Send HDR ON to the 2714 or 2715. 2. Send FILE? “<filename>” query to 2714 or 2715. 3. Read response into string variable FILEDAT$.
  • Page 124 Command and Query Definitions 2. Send FILEDAT$ to the 2714 or 2715. Be aware that files can theoretically occupy up to 64 Kbytes. Binary blocks are limited to 64 Kbytes because of the 16-bit byte count. See Programming for programming examples.
  • Page 125 FOFfset command if FOMode is enabled. FREq 193.25 MHz (for example) FREq? Arguments: None This simple query returns the currently selected center or start frequency. FREq? FREQ 193.25E+6 (for example) 4–39 2714 & 2715 Programmer Manual...
  • Page 126 VRTdsp?, WAVfrm?, and WFMpre? queries), the link is turned off along with the command header. The link remains for linked character arguments (see MFREq? and VIEw? in the table) when HDR is OFF. 4–40 2714 & 2715 Programmer Manual...
  • Page 127 If signal track is enabled, HRAmpl turns signal track off, enables the marker, and assigns the knob function to marker control. If there is no higher peak and SGErr is on, an SRQ and event 896 are generated. HRAmpl 4–41 2714 & 2715 Programmer Manual...
  • Page 128 The <freq> field is the frequency in the corresponding table location. If the table type is REL, <freq> is a value within the 1800 MHz range. If the table type is DEL, <freq> is 0. 4–42 2714 & 2715 Programmer Manual...
  • Page 129 Command and Query Definitions Arguments: None This query returns the instrument identification, firmware version, and installed options. ID TEK/2714 or 2715,V81.1,"VERSION 02.28.92 FIRMWARE","300HZ,1,10,100KHZ,1MHZ RBW FLTR","GPIB","NVM 12.88","OPT NVM 12.88" (for example) The items in quotes (”) indicate the firmware version and options installed in the instrument.
  • Page 130: Table 4-6: Arguments Of The Key Command

    3 key 4 key 5 key 6 key 7 key 8 key 9 key MAXHold Max Hold MAXSpan Max Span MKREnab Marker On/Off/Delta MKRLeft Marker Left MKRMenu Marker/Frequency Menu MKRPeak Marker Peak MKRRight Marker Right 4–44 2714 & 2715 Programmer Manual...
  • Page 131 Sweep Time Up TERMW First Terminator TERMX Third Terminator TERMY Second Terminator TERMZ Fourth Terminator USErdef User Def Menu UTilmenu Utility Menu VIDflt Video Filter VRTLIn Lin Mode VRTLOg Log Mode Zerospan Zero Span 4–45 2714 & 2715 Programmer Manual...
  • Page 132 (<arg> = SECond) marker, or their amplitude difference (<arg> = DELta). The applicable units are those currently selected for the reference level unit. MAMpl? MAMPL PRIMARY:6.8 (for example) MAMpl? SECond MAMPL SECOND:2.4 (for example) MAMpl? DELta MAMPL DELTA:4.4 (for example) 4–46 2714 & 2715 Programmer Manual...
  • Page 133 This is a command that requires no argument. It interchanges the primary (stationary) and secondary (moveable) markers. If delta marker mode is not active, the command generates an SRQ and event code 825. MEXchg 4–47 2714 & 2715 Programmer Manual...
  • Page 134 This single-argument command selects the MIN Hold destination waveform. MHDest A MHDest B MHDest C MHDest? Arguments: None This simple query returns the MIN Hold destination waveform. MHDest? MHDEST A MHDEST B MHDEST C 4–48 2714 & 2715 Programmer Manual...
  • Page 135 MMAx turns signal track mode off, enables the primary marker, and assigns the knob function to marker control. If SGErr is ON and a higher peak does not exist, an SRQ and event code are generated. MMAx 4–49 2714 & 2715 Programmer Manual...
  • Page 136 (<arg> = SECond) marker, or their horizontal difference (<arg> = DELta). See the CURve command for an explanation of screen coordinates. MPOs? MPOS PRIMARY:356 (for example) MPOs? SECond MPOS SECOND:233 (for example) MPOs? DELta MPOS DELTA:123 (for example) 4–50 2714 & 2715 Programmer Manual...
  • Page 137 1.8 GHz, the value specified must position the new marker frequency within the spectrum analyzer’s on-screen frequency span or an SRQ and event code are generated. MTUNE 546 kHz (for example) 4–51 2714 & 2715 Programmer Manual...
  • Page 138 2 dB steps. Odd values are rounded. Units are not allowed; the number is interpreted as dBm. NOMinal selects the factory default value of –30 dBm. MXRlvl NOMinal MXRlvl -24 (for example) 4–52 2714 & 2715 Programmer Manual...
  • Page 139 Units may be appended; otherwise hertz are assumed. NNBw 4 MHz (for example) NNBw? Arguments: None This simple query returns the noise bandwidth in hertz to be used for normalized noise mode measurements. NNBw? NNBW 4.0E+6 (for example) 4–53 2714 & 2715 Programmer Manual...
  • Page 140 (for example) Arguments: ALL, AMPlitude, FREquency NORM This single-argument command instructs the spectrum analyzer to carry out the indicated normalizations. NORM ALL (all normalization except reference) NORM AMPlitude (amplitude normalizations) NORM FREquency (frequency normalizations) 4–54 2714 & 2715 Programmer Manual...
  • Page 141 This simple query returns a listing of the current normalization parameters. The following list shows the format of the response. Actual values for each category will vary. NORM? NORM TEK 2714 or 2715 CURRENT NORMALIZATION VALUES: =================================== MISCELLANEOUS - NORM VALUES...
  • Page 142 This simple query returns the occupied bandwidth percentage. OBWPcnt? OBWPCNT 40 (for example) OBWResult? Arguments: None This simple query returns the result of the most recent occupied bandwidth measurement (in hertz). OBWResult? OBWRESULT 4.0E+6 (for example) 4–56 2714 & 2715 Programmer Manual...
  • Page 143 This single-argument command enables or disables the 1st LO phase lock system. If the PLLmode is on, the spectrum analyzer’s 1st LO automatically phase locks for spans of 20 kHz/div or less. PLLmode ON PLLmode OFF 4–57 2714 & 2715 Programmer Manual...
  • Page 144 Arguments: None This simple query returns information indicating whether the result of the B,C MINUS A function is offset to the center or top of the spectrum analyzer display. POFset? POFSET CENTER POFSET TOP 4–58 2714 & 2715 Programmer Manual...
  • Page 145 (the string length is dimensioned for a maximum of 17 32 = 544 characters), but this length is never achieved in practice. The query does not return the spectrum analyzer’s general purpose message line, GPIB status line, or user-defined DISPLAY MESSAGE line. 4–59 2714 & 2715 Programmer Manual...
  • Page 146 PROTset is ON. PROTset ON PROTset OFF PROTset?? Arguments: None This simple query returns the current on/off status of the stored settings protection. Protected settings cannot be erased. PROTset? PROTSET ON PROTSET OFF 4–60 2714 & 2715 Programmer Manual...
  • Page 147 This single-argument command instructs the spectrum analyzer to recall the stored settings in the location indicated by the argument. Integers between 0 and 39 (inclusive) are valid except for 9, 19, and 29. RECall 0 (for example) RECall 24 (for example) 4–61 2714 & 2715 Programmer Manual...
  • Page 148 REFlvl INC REFlvl DEC REFlvl 10 DBMV (for example) REFlvl? Arguments: None This simple query returns the current reference level in the currently selected reference level units. REFlvl? REFLVL -35.0 (for example) 4–62 2714 & 2715 Programmer Manual...
  • Page 149 RFAtt? RFATT 34 (for example) Arguments: DBM, DBMV, DBV, DBUV, DBUW, DBUVM RLUnit <arg> This single-argument command specifies the units for the reference level. The DBUVM argument is not allowed under these conditions: 4–63 2714 & 2715 Programmer Manual...
  • Page 150 Arguments: Value within the range 100 dB This single-argument command sets the reference level offset value. The offset value must be within the –100 dB to +100 dB range. Units are not allowed. ROFset -7.5 (for example) ROFset? Arguments: None 4–64 2714 & 2715 Programmer Manual...
  • Page 151 (SRQ) by the spectrum analyzer. The user request is affected but the power-on SRQ is not. RQS ON RQS OFF RQS? Arguments: None This simple query returns the spectrum analyzer’s current on/off status of service request generation. RQS? RQS ON RQS OFF 4–65 2714 & 2715 Programmer Manual...
  • Page 152 This is a query that returns the current RS-232 parameter of the specified Interface) argument. If no argument is given, this command returns all RS-232 settings, separated by commas (,). RS232? FLOw RS232 FLOW:HARD (for example) 4–66 2714 & 2715 Programmer Manual...
  • Page 153 (for example) SAVe C:OFF (for example) SAVe A:ON,B:OFF (for example) SAVe A:ON,B:OFF,C:OFF (for example) Using the SAVe <link>:OFF command with the destination register for an ensemble average or minimum hold operation terminates these operations. 4–67 2714 & 2715 Programmer Manual...
  • Page 154 The string of commands can be retained for transfer to the same or another 2714 or 2715 spectrum analyzer at a later time when it is desirable to reproduce the same setup.
  • Page 155 NOTE. If the SET? query is used while a CATV test is running, the returned settings string may contain invalid control settings. The CATV test may change a 2714 or 2715 control parameter while the SET? query is processed. Arguments: OFF, ON SGErr <arg>...
  • Page 156 Any TRIGGER command cancels single sweep mode. SIGswp SIGswp? Arguments: None This simple query returns the current status of the single sweep mode. SIGswp? SIGSWP ON SIGSWP OFF SIGSWP ARM 4–70 2714 & 2715 Programmer Manual...
  • Page 157 The value is offset by FOFfset if FOMode is on. SSBegin 54 MHz (for example) SSBegin? Arguments: None This simple query returns (in hertz) the currently specified BEGIN frequency for the signal search mode. SSBegin? SSBEGIN 54.000e+6 (for example) 4–71 2714 & 2715 Programmer Manual...
  • Page 158 If no signal is detected during the search, SSResult? returns zero (with HDR ON, the response is SSRESULT 0;). If the amplitude of a detected signal is off-screen, it is listed as 1.0E+6. SSResult? SSRESULT 8,55.250E+6,7.3,...299.75E+6,-4.0; (for example) See Programming for programming examples. 4–72 2714 & 2715 Programmer Manual...
  • Page 159 Locations 0 and 1 are reserved for the last power-down and factory default power-up settings, respectively. Locations 9, 19, and 29 are invalid. STOre 2 STOre 24 (for example) 4–73 2714 & 2715 Programmer Manual...
  • Page 160 The stop frequency may be set lower than the start frequency. Under these conditions the spectrum analyzer is tuned to the lower frequency and zero span mode is activated. STStop MARker STStop 192 MHz,198 MHz (for example) 4–74 2714 & 2715 Programmer Manual...
  • Page 161 Transmit a null string (TEXt ") to erase the message. TEXt MY MESSAGE" (for example) TEXt? Arguments: None This simple query returns the current contents of the message buffer in the spectrum analyzer. Lowercase letters are returned if lowercase letters were 4–75 2714 & 2715 Programmer Manual...
  • Page 162 This single-argument command increases, decreases, or sets the sweep speed. This command also turns off the spectrum analyzer’s automatic sweep speed selection. Units of ns, ms, ms, or s may be appended; otherwise seconds are assumed. 4–76 2714 & 2715 Programmer Manual...
  • Page 163 TIMe command. TIMMode AUTo TIMMode FIXed TIMMode MANual TIMMode? Arguments: None This simple query returns the current time base mode. TIMMode? TIMMODE AUTO TIMMODE FIXED TIMMODE MANUAL 4–77 2714 & 2715 Programmer Manual...
  • Page 164 Select video line number if knob selectable, TV line triggering is enabled TMOde FREquency TMOde MARker TMOde VIDline TMOde? Arguments: None This simple query returns the currently selected function of the frequency/mark- ers knob. TMOde? TMODE FREQUENCY TMODE MARKER TMODE VIDLINE 4–78 2714 & 2715 Programmer Manual...
  • Page 165 TRIgger? TRIGGER FRERUN TRIGGER EXTERNAL TRIGGER INTERNAL TRIGGER LINE TRIGGER TVFIELD TRIGGER TVLINE Arguments: OFF, ON TTLMode <arg> This single-argument command turns the spectrum analyzer screen title on and off. TTLMode ON TTLMode OFF 4–79 2714 & 2715 Programmer Manual...
  • Page 166 This single-argument command designates the specific TV line trigger mode, and enables TVLine trigger mode. This command turns the Video Monitor mode off if enabled. The arguments and their functions are described in the following table. 4–80 2714 & 2715 Programmer Manual...
  • Page 167 TV standard. TVLStd NTSC TVLStd OPEN TVLStd PAL TVLStd SECAM TVLStd? Arguments: None This simple query returns the currently selected TV standard. TVLStd? TVLSTD NTSC TVLSTD OPEN TVLSTD PAL TVLSTD SECAM 4–81 2714 & 2715 Programmer Manual...
  • Page 168 This single-argument command turns the video filter on and off. VFEnab ON VFEnab OFF VFEnab? Arguments: None This simple query returns the current on/off status of the video filter. VFEnab? VFENAB ON VFENAB OFF 4–82 2714 & 2715 Programmer Manual...
  • Page 169 VIDflt OFF VIDflt 30 kHz (for example) VIDflt? Arguments: None This simple query returns the currently selected video filter bandwidth in hertz whether or not the filter is enabled. VIDflt? VIDFLT 3.0E+4 (for example) 4–83 2714 & 2715 Programmer Manual...
  • Page 170 (for example) VMAnttbl <arg> Arguments: Integer in the range 1 to 5 This single-argument command designates by number the antenna table to be used for dBmV/M measurements. Units are not allowed. VMAnttbl 3 (for example) 4–84 2714 & 2715 Programmer Manual...
  • Page 171 VMDIst 3 M (for example) VMDIst? Arguments: None This simple query returns the currently specified source-antenna distance for dBmV/M measurements. Units are meters. VMDIst? VMDIST 3.0 (for example) VMDIST 3.0 (for example) 4–85 2714 & 2715 Programmer Manual...
  • Page 172 This simple query returns the current on/off status of the Video Monitor mode. VMOnitor? VMONITOR ON VMONITOR OFF Arguments: NEGative, POSitive VPOlarity <arg> This single-argument command specifies the polarity of video signals to be received with the Video Monitor mode. VPOlarity NEGative VPOlarity POSitive 4–86 2714 & 2715 Programmer Manual...
  • Page 173 When used with an argument, VRTdsp? returns the scale factor used when the indicated mode was last entered. Units are decibel (dB) for LOG, volts (v) for LIN or EXTernal, and hertz (Hz) for FM. 4–87 2714 & 2715 Programmer Manual...
  • Page 174 This is a command that requires no argument. It causes the spectrum analyzer to wait for an end-of-sweep to occur before processing any more commands. WAIt can be cancelled by the DCL or SDC GPIB commands, or the RS-232 BREAK command. See also the EOS command. WAIt 4–88 2714 & 2715 Programmer Manual...
  • Page 175 WFMpre WFId:D,ENCdg:Asc The last command string is a typical message. It indicates that, in this example, register D is the source/destination for future CURve transfers, and ASCII encoding is to be used for the data. 4–89 2714 & 2715 Programmer Manual...
  • Page 176 The response identifies the waveform, specifies data encoding, and provides the offsets, scale factors, and units necessary to plot or interpret the curve data. Tables 4–7 and 4–8 define the terms in the response. WFMpre? WFMPRE WFID:A,ENCDG:BIN,NR.PT:512, PT.FMT:Y,PT.OFF:5,XINCR:3.6e+6,XZERO:0.000, XUNIT:HZ,YOFF:245,YMULT:3.333E-1,YZERO: 4–90 2714 & 2715 Programmer Manual...
  • Page 177: Table 4-7: Arguments Of The Wfmpre? Query

    ENCDG:<enc> Encoding The possibilities are ASC, BIN or HEX. NR.PT:512 Number of points There are 512 data points on every 2714 or 2715 curve. PT.FMT:Y Point format Only Y-data is transmitted. X-data is implicit by the position of the point.
  • Page 178 This single-argument command turns the zero span mode on and off. ZERosp ON ZERosp OFF ZERosp? Arguments: None This simple query returns the current on/off status of the zero span mode. ZERosp? ZEROSP ON ZEROSP OFF 4–92 2714 & 2715 Programmer Manual...
  • Page 179 Status Reporting...
  • Page 181 SRQ, RQS, and serial polling. The 2714 or 2715 reports its status to the controller using the status byte and event codes. The status byte is a reporting feature provided in the IEEE-488.1 (GPIB) standard.
  • Page 182 If RQS is off and an error is pending, the REQUEST indicator does not appear on the 2714 or 2715’s screen. Under these conditions an EVEnt? or ERRor? query is required to report and clear the error condition. Otherwise the error remains pending.
  • Page 183: Table 5-1: Event Codes

    When an error occurs, the appropriate event is declared and all unparsed data are discarded until a terminator is received. Table 5–1 lists the complete set of 2714 or 2715 event codes and status bytes, including three RS-232-specific event codes (numbers 410, 411, and 412).
  • Page 184 Timer Interrupt Fault No Signal (Normalizations) Ampl Out Of Range (Normalizations) Freq Out Of Range (Normalizations) Func Not Avail In Current Mode Frequency Normalization Failed Amplitude Normalization Failed Reference Normalization Failed Internal Ref Freq Too Inaccurate 5–4 2714 & 2715 Programmer Manual...
  • Page 185 Cannot Count Beat Frequency FREQ Norm Suggested (Set Beat) FREQ Norm Suggested (1 Setting Corrupted NVM Fragmentation Error NVM Segmentation Error Comm Port Not Installed Real Time Clock Hardware Failure Real Time Clock Not Installed 5–5 2714 & 2715 Programmer Manual...
  • Page 186 Warning: Using Empty Antenna Table Not Available With DBUV/M Idle Mkr Would Overwrite Noise Value Function Not Avail In DBUV/M Mode No Listener Select TALK ONLY Mode First QP Filters Not Installed Destination Waveform Conflict TG Normalization Suggested 5–6 2714 & 2715 Programmer Manual...
  • Page 187 Noise Level Less Than 2 dB Start Frequency Changed Stop Frequency Changed Signal Out Of IF Passband No Modulation On Signal Measurement Complete Disconnect Input Signal ZERO SPAN Entered Must Be In Delta Marker Mode Stand By Printer Error 5–7 2714 & 2715 Programmer Manual...
  • Page 188 Invalid Device Number End of File NVM Version Mis-Match Fatal Error In File Directory Error In File Data Error In File Table In Use Clear Event Calibrator Doesn’t Match Readout Return to Local Request 5–8 2714 & 2715 Programmer Manual...
  • Page 189 End of Sweep Detected CATV Function Complete Display Line Limit Exceeded Signal Find Error Func Not Available On This Chan Type CATV Measurement Failure No Reference Defined Cannot Overwrite Stored Reference Leave Interactive Mode First 5–9 2714 & 2715 Programmer Manual...
  • Page 190 H Device-dependent failures or warnings. These SRQs include all 2714 or 2715 error messages that appear on-screen. They cannot be independently masked. H Power up SRQ mode enabled. The 2714 or 2715 generates an SRQ at power up when the power-up SRQ is enabled (requires GPIB interface). Press the key sequence [UTIL] [4] [0] [0] [2] to implement this mode.
  • Page 191 Because of the status coding scheme, only one condition can be reported in a single status byte. More than one condition may exist in the 2714 or 2715 at one time. Therefore, the following rules are used to determine which condition is reported by a status byte: H Each condition is assigned a priority according to Table 5–6.
  • Page 192: Table 5-2: General System Status Bytes

    Event Value Description 00,10 No status to report 41,51 Power on 43,53 User Request 61,71 Command error 62,72 Execution error 63,73 Internal error Byte value depends on B = 1 or B = 0 5–12 2714 & 2715 Programmer Manual...
  • Page 193: Table 5-5: Specific Device-Dependent Status Bytes

    User request Signal find error (MRGtnx, etc.) Display line limit exceeded Device-dependent failure or warning Device-dependent operation complete (EOS, Norm, etc.) Firmware error Normal device dependent status No status to report Highest priority = 1 5–13 2714 & 2715 Programmer Manual...
  • Page 194 REM $INCLUDE 'IBDCL4.BAS' Example 5-1 Subroutine to Read the COMMON SHARED BDNAME$,BD%,SPR$ Status Byte BDNAME$ = "TEK_SA" CALL IBFIND (BDNAME$, BD%) GOSUB SERIAL.POLL SERIAL.POLL: CALL IBRSP (BD%,SPR%) PRINT SPR% RETURN 5–14 2714 & 2715 Programmer Manual...
  • Page 195 For this reason the Request for Service (RQS) command is implemented in the 2714 or 2715. This command allows the controller to prevent the 2714 or 2715 from asserting SRQ. In this mode of operation, the EVEnt? and ERRor? queries request error and status information.
  • Page 196 In either RQS mode, the DCL or (if the instrument is first addressed) SDC GPIB commands may be used to clear all event codes except POWER ON. 5–16 2714 & 2715 Programmer Manual...
  • Page 197 Programming...
  • Page 199 Before attempting to run the RS-232 programming examples, connect a null modem cable between the COM1 serial port on your computer and the RS-232 port on the 2714 or 2715. The 2714 or 2715 RS-232 port must also be enabled and configured properly. This information is provided with each programming example in this section.
  • Page 200 H Talk/Listen Demo Program (Example 6–1) H CATV XMOD Command Demo Program (Example 6–2) NOTE. The 2714 or 2715 must have a spectral display on its screen when these programs are executed. If the 2714 or 2715 is displaying a menu when either program is executed, the program will not run properly.
  • Page 201: Figure 6-1: Terminal Display Of Id? Query Response

    RS-232 interface. It also calls RS232.CALLS to perform actual RS-232 communications. RS232.CALLS This procedure performs all input/output for RS-232 communications between the controller and the 2714 or 2715. It also checks for communica- tion errors and displays error messages. 6–3 2714 & 2715 Programmer Manual...
  • Page 202 NOTE. The SUB RS232.CALLS subroutine in this program is identical to the SUB RS232.CALLS subroutine used in Example 6–2. The 2714 or 2715 must have a spectral display on its screen when this program is executed. If the 2714 or 2715 is displaying a menu when the program is executed, it will not run properly.
  • Page 203 Talk/Listen Demo Program ' operator to communicate with the 2714 or 2715 spectrum analyz ' Commands can be sent to the 2714 or 2715 and responses are read ' back. All communication is via RS 232 and is contained in ' the procedure RS232.CALLS and in the main module sub...
  • Page 204 '======================================================== END.PROGRAM: COLOR 7, 0 '************************************************** '* read routine for RS232 branched from RS232. '* CALLS subprogram '************************************************** '=========== READ.BUFFER: '=========== COM(1) OFF 'turn automatic branch off rd$ = "" 'initialize string to save 6–6 2714 & 2715 Programmer Manual...
  • Page 205 'initialize counter DO WHILE TIMER < i + hold.i 'try to read for time alotted make sure controller is just GOSUB READ.INPUT 'not too fast for 2714 or 2715 IF end.of.read$ = "Y" THEN i = 0 END IF LOOP end.of.read$ = "Y"...
  • Page 206 Programming ' waveform transfer and any other response from the 2714 or 2715. ' Binary transfers can contain embedded cr/lf characters so ' must ignore them until get past the binary data '**************************************************************** IF func% <> 5 THEN 'use first cr/lf...
  • Page 207 ' fill in the upper portion of screen with help info '==================================================== SCREEN 0 COLOR 0, 0 COLOR 12, 0 LOCATE 1, 26, 0 PRINT "2714 or 2715 TALK/LISTEN DEMO FOR RS 232"; COLOR 14, 9 FOR i% = 3 TO 8 LOCATE i%, 6 PRINT STRING$(70, " "); NEXT LOCATE 4, 15, 0 PRINT "THIS ROUTINE ACCEPTS SINGLE COMMANDS OR...
  • Page 208 = 1 CALL RS232.CALLS '==================================================== ' initialize string which holds communication message '==================================================== wrt$ = "" '================================================= ' now accept user input which will be sent to 2714 or 2715 '================================================= LOCATE 11, 8, 1 '====== INLOOP: '====== IN$ = INKEY$ IF IN$ = ""...
  • Page 209 'return to accept more input END IF '**************************************************************** ' Routine to back up cursor and erase character. This is a ' DESTRUCTIVE backspace routine. '**************************************************************** '========= BACKSPACE: '========= x = POS(0) y = CSRLIN 6–11 2714 & 2715 Programmer Manual...
  • Page 210 ' SPEED = 9600 (bits per second-also called BAUD RATE) ' PARITY = NONE (parity bit not used) ' DATA = 8 (number of data bits per byte) ' STOP = 1 (number of stop bits) 6–12 2714 & 2715 Programmer Manual...
  • Page 211 ' ECHO = OFF (only needed for terminal emulation) ' VERBOSE = ON (guarantees a response for each communication '**************************************************************** ' If the 2714 or 2715 has not been configured to agree with the above ' parameters, the program will display an error message and ' force the user to change the 2714 or 2715.
  • Page 212 IF read.error% = 1 THEN GOTO SELECT.DEVICE END IF ' set up the 2714 or 2715 so REQUEST message will NOT display on analyzer ' and so the 2714 or 2715 will return header information PRINT #1, "RQS Off;HDR ON"...
  • Page 213 '======================================= ' begin read loop for response from 2714 or 2715 '======================================= GOSUB READ.FOR.VERBOSE EXIT SUB '**************************************************************** ' This routine will read the 2714 or 2715 response to get a binary ' waveform. '**************************************************************** 'GET.BINARY.WAVEFORM: GOSUB READ.FOR.VERBOSE IF LEN(rd$) >= 14 THEN...
  • Page 214 FOR index% = 1 TO 8 FOR p% = 0 TO 7 FOR q% = min% TO max% STEP 7 frgrnd% = colr%(p%, q%) MOD 16 bckgrnd% = (((colr%(p%, q%) - frgrnd%) / 16) MOD 128) 6–16 2714 & 2715 Programmer Manual...
  • Page 215 = "" RETURN READ.FOR.VERBOSE: end.of.read$ = "N" error.query$ = "N" 'two flags used in reading response from 2714 or 2715 COM(1) ON 'enable event trapping for communication activity on com port 1 i = TIMER DO WHILE end.of.read$ = "N"...
  • Page 216 CLOSE #1 END IF RETURN END SUB '**************************************************************** ' Procedure to SEND COMMAND to the 2714 or 2715 after input from ENTERCOMMAND procedure. ' Command passed in the global string "WRT$" NOTE: only SINGLE commands can be sent by the user.
  • Page 217 DO WHILE LEN(rd$) >= 3 'groups small enough to fit. GOSUB FRAGMENT.RESPONSE LOOP ELSE PRINT rd$; END IF END IF RETURN ACQUIRE.WAVE: '================================== ' insure a binary waveform transfer '================================== 6–19 2714 & 2715 Programmer Manual...
  • Page 218 ' read and format the response '============================= func% = 5 CALL RS232.CALLS '============== ' go display it '============== GOSUB DISPLAY.WAVE RETURN '**************************************************************** ' Here is an example of a hex waveform being sent to the 2714 or 2715. * 6–20 2714 & 2715 Programmer Manual...
  • Page 219 ' decision for demonstration purposes. ' Any combination of characters can be constructed to create ' a waveform to be sent to the 2714 or 2715. ' Also the waveform is always being sent to storage location C. * ' This is strictly an arbitrary target location.
  • Page 220 DO WHILE posit <> 0 posit = INSTR(rd1$, CHR$(10)) IF posit <> 0 THEN MID$(rd1$, posit, 1) = " " END IF LOOP posit = INSTR(rd1$, CHR$(13)) IF posit <> 0 THEN rd1$ = LEFT$(rd1$, posit - 1) 6–22 2714 & 2715 Programmer Manual...
  • Page 221 NEXT RETURN '=============================================== ' routine invoked to control display of response '=============================================== 'TEMP.STOP: COLOR 0, 7 LOCATE 25, 9, 0: PRINT "Press {Enter} to continue the list"; DO WHILE INKEY$ <> CHR$(13)LOOPCOLOR 9, 9 6–23 2714 & 2715 Programmer Manual...
  • Page 222 Programming FOR indx% = 20 TO 25 LOCATE indx%, 8 PRINT STRING$(66, CHR$(32)); NEXT COLOR 14, 9 RETURN END SUB 6–24 2714 & 2715 Programmer Manual...
  • Page 223 CR LF Flow control: NONE If the 2714 is not properly configured the program displays an error message. Refer to the RS232 command description in Command and Query Defini- tions and the RS-232 installation procedure in Introduction To Programming for more information on RS-232 configuration.
  • Page 224 Programming 2714 or 2715 RS 232 DEMO PROGRAM (executes CATV XMOD command) TURN OFF THE MODULATION Press {Enter} to continue Figure 6–2: Terminal Display Before CATV XMOD Test Begins 2714 or 2715 RS 232 DEMO PROGRAM (executes CATV XMOD command)
  • Page 225 NOTE. The SUB RS232.CALLS subroutine in this program is identical to the SUB RS232.CALLS subroutine used in Example 6–1. The 2714 or 2715 must have a spectral display on its screen when this program is executed. If the 2714 or 2715 is displaying a menu when the program is executed, it will not run properly.
  • Page 226 PRINT "Press {Enter} to rerun program, or {Esc} to end." WHILE INKEY$ <> "": WEND DO WHILE INKEY$ <> CHR$(13) LOOP CALL CROSS.MOD GOTO RERUN.TEST END.PROGRAM: COLOR 7, 0 '**************************************************************** ' read routine for RS232 branched from RS232. ' CALLS subprogram '**************************************************************** 6–28 2714 & 2715 Programmer Manual...
  • Page 227 READ.BUFFER: '=========== COM(1) OFF 'turn automatic branch off RD$ = "" 'initialize string to save response from 2714 or 2715 IF INSTR(wrt$, "NORM") THEN 'set time limit for reading response from 2714 or 2715 hold.i = 40 'normalize query takes...
  • Page 228 'something '**************************************************************** ' Following code segment distinguishes between a binary ' waveform transfer and any other response from the 2714 or 2715. ' Binary transfers can contain embedded cr/lf characters so ' must ignore them until get past the binary data.
  • Page 229 Programming SUB CROSS.MOD COLOR 14 LOCATE 2, 20 PRINT " 2714 or 2715/RS 232 DEMO PROGRAM" LOCATE 3, 20 PRINT " (executes CATV XMOD command)" wrt$ = "CATV XMOD;EVE?" 'send CATV XMOD command func% = 3 'and query the CALL RS232.CALLS 'event IF INSTR(RD$, "EVENT 403") THEN...
  • Page 230 END SUB '**************************************************************** ' This procedure performs all RS232 calls. All information ' needed has been defined as global variables: rd$ = returned info from RS232 call wrt$ = info to send to device 6–32 2714 & 2715 Programmer Manual...
  • Page 231 ' ECHO = OFF (only needed for terminal emulation) ' VERBOSE = ON (guarantees a response for each communication) * *'*************************************************************** ' If the 2714 or 2715 has not been configured to agree with the above * ' parameters, the program will display an error message and ' force the user to change the 2714 or 2715.
  • Page 232 PRINT #1, "rs232 ECHO:OFF" GOSUB READ.FOR.VERBOSE IF read.error% = 1 THEN GOTO SELECT.DEVICE END IF PRINT #1, "RS232 EOL:CRLF" GOSUB READ.FOR.VERBOSE IF read.error% = 1 THEN GOTO SELECT.DEVICE END IF PRINT #1, "rs232 FLOW:NONE" GOSUB READ.FOR.VERBOSE 6–34 2714 & 2715 Programmer Manual...
  • Page 233 '======================================= ' begin read loop for response from 2714 or 2715 '======================================= GOSUB READ.FOR.VERBOSE EXIT SUB '**************************************************************** ' This routine will read the 2714 or 2715 response to get a binary ' waveform. '**************************************************************** GET.BINARY.WAVEFORM: GOSUB READ.FOR.VERBOSE IF LEN(RD$) >= 14 THEN...
  • Page 234 ' next print the window and the error message '============================================ COLOR 14, 6 FOR z% = 18 TO 25 LOCATE z%, 20, 0 PRINT STRING$(42, CHR$(32)); NEXT LOCATE 18, 30, 0 PRINT "COM(1) PORT PROBLEM"; 6–36 2714 & 2715 Programmer Manual...
  • Page 235 LOCATE p% + 18, q% + 20 PRINT before$(p%, q%); NEXT q% NEXT p% IF min% > hold.min% THEN min% = min% + 1 hold.min% = min% ELSE min% = min% + 1 hold.min% = 0 END IF NEXT index% 6–37 2714 & 2715 Programmer Manual...
  • Page 236 RD$ = "" RETURN' READ.FOR.VERBOSE: end.of.read$ = "N" error.query$ = "N" 'two flags used in reading response from 2714 or 2715 COM(1) ON 'enable event trapping for communication activity on com port 1 i = TIMER DO WHILE end.of.read$ = "N"...
  • Page 237 Programming Remote Menu Control The 2714 or 2715 includes a set of commands and queries for designing menus on the spectrum analyzer screen, and interacting with these menus by pressing keys on the spectrum analyzer Keypad. This feature is designed primarily for making automated measurements with the Tektronix 2402A TekMateT, an external, portable, PC-based controller without a display or keyboard.
  • Page 238 [0] key on the spectrum analyzer’s front panel Keypad. This is accomplished by the following algorithm executing on either the Tektronix 2402A TekMate or a controller: H Do KEY? queries until the result is not NULL.
  • Page 239 When the 2714 or 2715’s front panel [1] key is pressed, a numeric entry line is displayed at the bottom of the screen (Figure 6–5). Terminator keys for the entry are also defined;...
  • Page 240 DEFMENU commands to rewrite the screen. TEST MENU 0 INIT INSTRUMENT *1 CHANGE REF LEVEL (NOW 12.3 DBM) 2 PERFORMANCE TESTS ENTER REF LEVEL: 15.7_ Y = +DBM Z= -DBM Figure 6–6: Specifying a Numeric Value 6–42 2714 & 2715 Programmer Manual...
  • Page 241 DEFMENU L16:" "<-"" = PREVIOUS MENU" The resulting menu is shown in Figure 6–7. Note that the 2714 or 2715 does not understand a nested menu structure. The nesting structure is maintained by the application program running on the controller.
  • Page 242 National Instruments along with their boards. The devices considered are the National Instruments PCII, PCIIA, and PCII/IIA GPIB boards, supplied by Tektronix or directly available from National Instruments dealers. Consult Introduction To Programming on page 1–1 and the material supplied with your board for detailed instructions.
  • Page 243 IBWRT function to contain the data WRT.DAT$, MESSAGE$, B4$, etc. to be sent to the 2714 or 2715. You may desire to dimension arrays or variables at the beginning of your program, even though they are to be used later. For instance, CUR%() is the integer array used for curve data in our demonstration program.
  • Page 244 Instruments with a GPIB interface may encounter GPIB system errors. (Refer to programming examples in RS-232 Program Examples on page 6–2 for RS-232 error handling techniques.) These errors are detected by examining IBSTA% following each GPIB function call. 6–46 2714 & 2715 Programmer Manual...
  • Page 245 RETURN Instrument-Related Errors A third type of error involves those directly related to the 2714 or 2715 or its interface with the bus. Any time the 2714 or 2715 detects an abnormal condition, it issues a service request (SRQ) if RQS is set to ON. The SRQ causes the GPIB board to generate a light pen interrupt.
  • Page 246 GPIB System Software All of the programming examples in this manual make use of the subroutines supplied by National Instruments as part of the GPIB or Tektronix GURU II software. If you are using a board from another manufacturer, equivalent software should have accompanied your board.
  • Page 247 See Status Reporting and the demonstration program at the end of this section for error and event reporting routines. NOTE. The 2714 or 2715 must have a spectral display on its screen when any RS-232 or GPIB program is executed. If the 2714 or 2715 is displaying a menu when a program is executed, the program will not run properly.
  • Page 248 Programming NOTE. The 2714 or 2715 must have a spectral display on its screen when any RS-232 or GPIB program is executed. If the 2714 or 2715 is displaying a menu when a program is executed, the program will not run properly.
  • Page 249 The currently created files can be viewed by pressing the key sequence [UTIL MENU] [4] [6]. NOTE. The 2714 or 2715 must have a spectral display on its screen when any RS-232 or GPIB program is executed. If the 2714 or 2715 is displaying a menu when a program is executed, the program will not run properly.
  • Page 250 National Instruments IBWRTF() and IBRDF() calls to transfer data directly between the spectrum analyzer and disk. Example 6–5 is an example of this approach. The PLOT? query enables the transfer of data representing an image of the 2714 Plotting Spectrum Analyzer Screen Data or 2715 display screen from the spectrum analyzer to a plotter or printer.
  • Page 251 Each “Do it” in the diagrams can represent a separate subroutine for a specific device. Example 6–6 shows a subroutine for obtaining screen plot data from the 2714 or 2715 using the PLOT? query. It does not store the data on disk (you can add that capability if desired), but holds the data in memory as the string variable PLOT.DAT$.
  • Page 252: Figure 6-8: Possible Data Acquisition Scheme

    Do it instrument 1 and store? Get data from 2714 using Plot? Do it query and store? Get data from Do it instrument N and store? Enough data? Return Figure 6–8: Possible Data Acquisition Scheme 6–54 2714 & 2715 Programmer Manual...
  • Page 253 The PRDouts? query enables returns most of Readouts these readouts to the computer. This query does not return the 2714 or 2715’s general purpose message line, the GPIB status line, or the user-defined DIS- PLAY MESSAGE line.
  • Page 254 Programming NOTE. The 2714 or 2715 must have a spectral display on its screen when any RS-232 or GPIB program is executed. If the 2714 or 2715 is displaying a menu when a program is executed, the program will not run properly.
  • Page 255 2714 or 2715 in its current configuration. Settings can be saved in a controller disk file for later transfer to the same 2714 or 2715, or to another 2714 or 2715, when restoring the same operating environment.
  • Page 256 Programming NOTE. The 2714 or 2715 must have a spectral display on its screen when any RS-232 or GPIB program is executed. If the 2714 or 2715 is displaying a menu when a program is executed, the program will not run properly.
  • Page 257 2714 or 2715 during program execution. NOTE. The 2714 or 2715 must have a spectral display on its screen when any RS-232 or GPIB program is executed. If the 2714 or 2715 is displaying a menu when a program is executed, the program will not run properly.
  • Page 258 ' now reset the analyzer and view the C register which contains ' the difference between what is saved in A and what is ' actively displayed '============================================================== wrt$ = "EOS OFF;VIEW A:OFF;VIEW B:OFF;VIEW C:ON;VIEW D:OFF;VIEW MINUSA:ON;" CALL IBWRT(bd%, wrt$) '======================= 6–60 2714 & 2715 Programmer Manual...
  • Page 259 The following COMM2714 or 2715 program is a simple utility for communicat- ing with the 2714 or 2715 spectrum analyzer over the GPIB. It contains some of the subroutines (or elements of them) discussed earlier in this section, in addition to some new material.
  • Page 260 Programming ' obtain bus device unit descriptor (BD%). ' BDNAME$ must match name ' established for the 2714 or 2715 with the IBCONF program BDNAME$ = "TEK_SA" CALL IBFIND(BDNAME$, bd%) ' establish link to abnormal event handler; enable interrupt line ON PEN GOSUB ABNORM.EVE...
  • Page 261 CALL IBRD(bd%, RD$) GOSUB GPIB.ERR PRINT : PRINT "THE RESPONSE IS:" PRINT : PRINT MID$(RD$, 1, IBCNT%) PRINT : PRINT INPUT "SEND MORE (ENTER Y OR N)?"; Y$ IF Y$ = "Y" THEN GOTO SEND.RCV RETURN 6–63 2714 & 2715 Programmer Manual...
  • Page 262 'OK, then restore CALL IBWRT(BD%, WRT$) 'to 2714 or 2715 GOSUB GPIB.ERR RETURN ' subroutine fetches file from 2714 or 2715, stores on disk SAVE.FILE: CLS : PRINT PRINT "ENTER NAME OF 2714 or 2715 FILE TO STORE" INPUT FILE2714 or 2715$ ' see FILE command for 2714 or 2715 file names 6–64...
  • Page 263 CALL IBRDF(bd%, FILENAME$) 'read and store GOSUB GPIB.ERR '2714 or 2715 file to disk RETURN 'as FILENAME$ ' subroutine restores 2714 or 2715 file from disk to the 2714 or 2715 RES.FILE: CLS : PRINT PRINT "ENTER DISK FILE TO RESTORE TO 2714 or 2715"...
  • Page 264 GOTO MENU 'are not erased RETURN ' subroutine to serially poll the 2714 or 2715, read the status byte, ' and print it used as part of abnormal event handler, but ' can be used any time to obtain status byte; see your GPIB ' documentation for more information SERIAL.POLL:...
  • Page 265 PRINT "CHECK YOUR SYSTEM AND RESTART." RETURN ' subroutine to end program gracefully on DOS error ERR.TRAP: CLS : PRINT PRINT "DOS ERROR HAS OCCURRED." PRINT : PRINT PRINT "CHECK YOUR SYSTEM AND RESTART." RESUME NEXT 6–67 2714 & 2715 Programmer Manual...
  • Page 266 Programming 6–68 2714 & 2715 Programmer Manual...
  • Page 267 Appendices...
  • Page 269 RS-232 communications concepts to users with no experience using the RS-232 interface. The second part, Implementation of the RS-232 Interface, describes implementation of the RS-232 interface on the 2714 or 2715 Spectrum Analyzer. Other sections in this manual contain the detailed instructions needed to operate over the RS-232.
  • Page 270 J104. This is a DB9P male connector as shown in Figure A–2. Refer to Table A–1 for a listing of the connector pin definitions. The RS-232 connector on the 2714 or 2715 (J104) is a PC/AT type RS-232 9-pin male interface connector. The RS-232 connectors used on the PC interface card are not consistent.
  • Page 271 Table A–2 and Figure A–3 show the wiring configuration for this type of cable. A cable with this configuration is available as an optional accessory. Refer to the 2714 or 2715 Spectrum Analyzer User Manual for the part number. NOTE. Pins 1 and 8 are connected together on each 9-pin female connector. Both pins connect to pin 7 on the opposite 9-pin connector.
  • Page 272: Figure A-3: 9-Pin Female To 9-Pin Female Null-Modem Cable

    A cable with this configuration is available as an optional accessory. Refer to the 2714 or 2715 Spectrum Analyzer User Manual for the part number. NOTE. Pins 1 and 8 are connected together on the 9-pin female connector; these connect to pin 4 on the 25-pin female connector.
  • Page 273: Figure A-4: 9-Pin Female To 25-Pin Female Null-Modem Cable

    20 (DTR) 7 (RTS) 5, 8 (CTS, DCD) 8 (see pin 1) 9 (not used) 9-Pin Female 25-Pin Female To 2714 or 2715 To PC Figure A–4: 9-pin Female to 25-pin Female Null-Modem Cable A–5 2714 & 2715 Programmer Manual...
  • Page 274: Figure A-5: 9-Pin Female To 25-Pin Male Extension Cable

    Table A–4 and Figure A–5 show the connections for this type of cable. A cable with this configuration is available as an optional accessory. Refer to the 2714 or 2715 Spectrum Analyzer User Manual for the part number. Table A–4: 9-pin Female to 25-pin Male Extension...
  • Page 275 The following documents include the RS-232 standard and Mastering Serial Communications, written primarily for programmers. EIA Standard RS-232-C, August 1969 EIA Standard RS-232-D, January 1987 Mastering Serial Communications by Peter W. Gofton RS-232 Made Easy by Martin D. Seyer A–7 2714 & 2715 Programmer Manual...
  • Page 276 Appendix A: RS-232 Concepts A–8 2714 & 2715 Programmer Manual...
  • Page 277 Contact your local Tektronix Field Office or representative for cable ordering information. Connectors may be rigidly stacked, using standard counter-bored captive screws.
  • Page 278 Messages can be sent over the GPIB as either active-true or passive-true signals. Passive-true signals occur at a high voltage level and must be carried on a signal line using open-collector devices. Active-true signals occur at a low voltage level. B–2 2714 & 2715 Programmer Manual...
  • Page 279 Such a scheme can be used for programmable plug-ins housed in a mainframe where the mainframe is addressed with a primary address code and the plug-ins are addressed with a secondary address code. B–3 2714 & 2715 Programmer Manual...
  • Page 280 NRFD ’ Not Ready For Data NDAC ’ Not Data Accepted IFC ’ Interface Clear ATN ’ Attention SRQ ’ Service Request REN ’ Remote Enable EOI ’ End Or Identify Figure B–2: Typical GPIB System B–4 2714 & 2715 Programmer Manual...
  • Page 281 Only instruments previously addressed to listen will respond to addressed commands. All instruments, whether they have been addressed or not, will respond to universal commands. B–5 2714 & 2715 Programmer Manual...
  • Page 282 ATN line is asserted (low) is an interface control message. Any message (data bytes) sent or received when the ATN line is unasserted (high) is a device-dependent message. B–6 2714 & 2715 Programmer Manual...
  • Page 283 Parallel Poll Disable Parallel Poll Enable Parallel Poll Unconfigure Remote Enable Ready For Data Selected Device Clear Serial Poll Disable T,TE Serial Poll Enable T,TE Service Request (via C) Take Control Unlisten L,LE Multiline messages. B–7 2714 & 2715 Programmer Manual...
  • Page 284 Remote Enable Ready For Data Selected Device Clear (via C) Serial Poll Disable (via C) Serial Poll Enable (via C) Service Request Take Control (via C) Unlisten (via C) Untalk (via C) Multiline messages. B–8 2714 & 2715 Programmer Manual...
  • Page 285 LOWER CASE " & < > DEL(RUBOUT) ADDRESSED UNIVERSAL LISTEN TALK SECONDARY ADDRESSES COMMANDS COMMANDS ADDRESSES ADDRESSES OR COMMANDS octal GPIB code REF: ANSI STD X3.4-1977 ASCII character IEEE STD 488.1-1987 ISO STD 646-2973 decimal B–9 2714 & 2715 Programmer Manual...
  • Page 286 A and B (decimal 65 and decimal 66). Note that the ATN line is asserted for the first two data bytes and unasserted for the device-dependent character to indicate the last data byte in the message. B–10 2714 & 2715 Programmer Manual...
  • Page 287 Each time a data byte is transferred over the data bus, an enabled talker and all enabled listeners execute a handshake sequence via signal lines DAV, NRFD, and NDAC (see Figure B–4 — the ATN line is shown to illustrate the controller’s role in the process). B–11 2714 & 2715 Programmer Manual...
  • Page 288: Figure B-4: Handshake Timing Sequence, Idealized

    NDAC signal line becomes unasserted (high) telling the talker to remove the data byte from the bus. The DAC message (Data Accepted) tells the talker that all assigned listeners have accepted the current data byte. B–12 2714 & 2715 Programmer Manual...
  • Page 289 To Local). A remote-local interface function indicates to an instrument that the instrument will use either information input from the interface (remote) or information input by the operator via the front panel controls (local). B–13 2714 & 2715 Programmer Manual...
  • Page 290 The controller can also disable the instrument’s front-panel “return to local” switch(es) by sending a LLO (Local Lockout) command. The LLO command must be preceded or followed by a listen address (MLA) to cause the instrument B–14 2714 & 2715 Programmer Manual...
  • Page 291 Secondary talk and listen addresses (or commands) are represented by the controller sending both data bits (6 and 7) as a logical 1. The controller may listen to bus traffic without actually addressing itself over the bus. B–15 2714 & 2715 Programmer Manual...
  • Page 292 GET message. Thus, the basic operating time is the major factor that determines how fast the instrument(s) can be repeatedly “triggered” by commands from the bus. B–16 2714 & 2715 Programmer Manual...
  • Page 293 The controller in charge first addresses the other controller as a talker and then sends the TCT (Take Control) command. The other controller then becomes the controller in charge when ATN is released. B–17 2714 & 2715 Programmer Manual...
  • Page 294 (0 through 7) that corresponds to a specific line on the data bus. An instrument must assert this data bus line when its internal status has the same value as the sense bit (S may equal 1 or 0). B–18 2714 & 2715 Programmer Manual...
  • Page 295 Disable) command accomplishes essentially the same results, except that the PP function remains in the “configured” state. PPU is a universal command (all instruments) while PPD is used with PPC and becomes an addressed command (only those devices selected with PPC will accept PPD). B–19 2714 & 2715 Programmer Manual...
  • Page 296 Appendix B: GPIB System Concepts B–20 2714 & 2715 Programmer Manual...
  • Page 297 Index...
  • Page 299 ATHrhld, 4–5 CLOck?, 4–19 AVDest, 4–5 CLRKey, 4–19 AVDest?, 4–5 CLRMenu, 4–19 AVG, 4–6 CMEas, 4–19 AVG?, 4–6 CNBw, 4–19 AVMode, 4–6 CNBw?, 4–20 AVMode?, 4–6 CNMode, 4–20 AVNum, 4–7 CNMode?, 4–20 AVNum?, 4–7 Index–1 2714 & 2715 Programmer Manual...
  • Page 300 POFset, 4–58 CURve?, 4–27 POFset?, 4–58 TEXt, 4–75 TEXt?, 4–75 TITLe, 4–78 TITLe?, 4–78 data plotting, 6–52 TTLMode, 4–79 DATe, 4–27 TTLMode?, 4–80 DATe?, 4–28 VIEw Minusa, 4–84 DATIme?, 4–28 VIEw? Minusa, 4–84 DEFMenu, 4–28 Index–2 2714 & 2715 Programmer Manual...
  • Page 301 1–20 FREq?, 4–39 equipment required, 1–13 frequency and markers commands (front panel) equipment, connecting, 1–15 CMEas, 4–19 GPIB device address, setting the, 1–16 COUnt?, 4–21 interconnecting cable, 1–14 FREq, 4–39 Index–3 2714 & 2715 Programmer Manual...
  • Page 302 RFAtt?, 4–63 STEp, 4–73 RLUnit, 4–63 STEp?, 4–73 RLUnit?, 4–64 STPinc, 4–74 ROFset, 4–64 STPinc?, 4–74 ROFset?, 4–64 STStop, 4–74 ROMode, 4–65 TAMpl?, 4–75 ROMode?, 4–65 TFReq?, 4–76 VMAnttbl, 4–84 THRhld, 4–76 VMAnttbl?, 4–85 Index–4 2714 & 2715 Programmer Manual...
  • Page 303 (GPIB), 2–3 NORM, 4–54 message terminator (RS-232), 2–3 NORM?, 4–55 message unit, 2–2 message unit delimiter, 2–3 mnemonic or header, 2–4 output message, 2–2 query, 2–4 response, 2–4 units, 2–5 message, instrument-specific, definition, 2–1 Index–5 2714 & 2715 Programmer Manual...
  • Page 304 6–55 RECall, 4–61 REDout, 4–61 REDout?, 4–62 REFlvl, 4–62 SAVe, 4–67 REFlvl?, 4–62 SAVe?, 4–68 RESbw, 4–62 saving equipment settings, 6–57 RESbw?, 4–63 screen data, plotting, 6–52 restoring equipment settings, 6–57 service request, 5–10 Index–6 2714 & 2715 Programmer Manual...
  • Page 305 TIMe, 4–76 TRIgger?, 4–79 TIMe?, 4–77 TTLMode, 4–79 TIMMode, 4–77 TTLMode?, 4–80 TIMMode?, 4–77 TUNe, 4–80 TRIgger, 4–79 TVLine, 4–80 TRIgger?, 4–79 TVLine?, 4–80 TVLine, 4–80 TVLMODE, 4–80 TVLine?, 4–80 TVLMODE?, 4–81 TVLMode, 4–80 Index–7 2714 & 2715 Programmer Manual...
  • Page 306 6–58 VFMode?, 4–83 waveform transfer, 6–49 VIDflt, 4–83 WAVfrm?, 4–89 VIDflt?, 4–83 WFMpre, 4–89 WFMpre?, 4–90 VDMode, 4–82 VDMode?, 4–82 ZERosp, 4–92 vertical scale, plot, and readout commands (front ZERosp?, 4–92 panel) PLOT?, 4–58 Index–8 2714 & 2715 Programmer Manual...

This manual is also suitable for:

2715

Table of Contents