background image

Command Descriptions

2Ć36

3026 Programmer Manual

HCOPy:DEVice:DESTination (?)

The 

HCOPy:DEVice:DESTination

 command sets the hard copy output destina-

tion (printer or file). The 

HCOPy:DEVice:DESTination?

 query returns the

currently specified hard copy destination.

HARDCOPY

HCOPy?, HCOPY:DEVice:LANGuage

HCOPy:DEVice:DESTination {OFF|PRINter|FILE}

HCOPy:DEVice:DESTination?

HCOPy:DEVice:LANGuage (?)

The 

HCOPy:DEVice:LANGuage

 command sets the hard copy output format. The

HCOPy:DEVice:LANGuage?

 query returns the currently specified hard copy

output format.

HARDCOPY

HCOPy?, HCOPy:DEVice:DESTination

HCOPy:DEVice:LANGuage {BMP|EPS}

HCOPy:DEVice:LANGuage?

BMP

 

the standard bit-mapped graphics format.

EPS

the encapsulated Postscript image file format.

{BMP|EPS}

:HCOPY:DEVICE:LANGUAGE BMP

sets the instrument to output hard copy in the BMP format.

Group

Related Commands

Syntax

Group

Related Commands

Syntax

Arguments

Responses

Examples

Summary of Contents for 3026

Page 1: ...Programmer Manual 3026 Realtime Spectrum Analyzer 071 0419 00 This document supports firmware version 1 10 ...

Page 2: ...s issued and pending Information in this publication supercedes that in all previously published material Specifications and price change privileges reserved Printed in Japan Sony Tektronix Corporation P O Box 5209 Tokyo Int l Tokyo 100 31 Japan Tektronix Inc P O Box 1000 Wilsonville OR 97070 1000 TEKTRONIX and TEK are registered trademarks of Tektronix Inc ...

Page 3: ...ers 3 1 Status Registers 3 1 Enable Registers 3 4 Queues 3 6 Status and Event Processing Sequence 3 7 Messages 3 8 Error Messages and Codes 3 11 Command Errors 3 11 Execution Errors 3 12 Device Specific Errors 3 14 Query Errors 3 15 Device Errors 3 15 Appendix A Character Chart A 1 Appendix B Reserved Words B 1 Appendix C Interface Specification C 1 Interface Functions C 1 Interface Messages C 2 A...

Page 4: ...mple of abbreviating a command 2 3 Figure 2 3 Example of chaining commands and queries 2 4 Figure 2 4 Example of omitting root and lower level nodes in a chained message 2 4 Figure 3 1 The Status Byte Register SBR 3 2 Figure 3 2 The Standard Event Status Register SESR 3 3 Figure 3 3 The Event Status Enable Register ESER 3 5 Figure 3 4 The Service Request Enable Register SRER 3 5 Figure 3 5 Status ...

Page 5: ... 12 Table 2 9 STATUS commands 2 12 Table 2 10 SYSTEM commands 2 13 Table 2 11 TRIGGER commands 2 13 Table 2 12 COMMON commands 2 14 Table 2 13 Other commands 2 14 Table 3 1 SRB bit functions 3 2 Table 3 2 SESR bit functions 3 3 Table 3 3 Command errors 3 11 Table 3 4 Execution errors 3 12 Table 3 5 Device specific errors 3 14 Table 3 6 Query errors 3 15 Table A 1 ASCII GPIB Code Chart A 1 Table C ...

Page 6: ...Table of Contents 3026 Programmer Manual ...

Page 7: ...conventions and describes each command in the realtime spectrum analyzer command set H Status and Events explains the status information and event messages reported by the realtime spectrum analyzer H Appendices contains various topics of use to the programmer H Index contains an index to this manual Other documentation for the realtime spectrum analyzer includes H The 3026 User Manual Tektronix p...

Page 8: ...Preface 3026 Programmer Manual ...

Page 9: ... ...

Page 10: ......

Page 11: ...in Command Syntax The GPIB interface conforms to ANSI IEEE Std 488 1 1987 which specifies the hardware interface its basic functional protocol and a set of interface messages codes that control the interface functions This instrument also conforms to ANSI IEEE Std 488 2 1987 which specifies Codes Formats Protocols and Common Commands to support the system application The functional layers of the G...

Page 12: ... the realtime spectrum analyzer GPIB connector Instruments can be connected to the GPIB in linear or star configurations or in a combination of both configurations A linear hookup is one where a GPIB cable is used to string one device to a second and then another GPIB cable is used to string from a second to a third and so on until all devices in the system are connected A star setup is one where ...

Page 13: ...he controller can be included on a signal bus 2 In order to maintain the electrical characteristics of the bus one device load must be connected for every two meters of cable most often each device represents one device load to the bus 3 The total cable length cumulative must not exceed 66 feet 20 meters 4 At least two thirds of the device loads must be powered on ...

Page 14: ... Listener side button This sets the communication mode to Talker Listener The realtime spectrum analyzer accepts as a terminator either the software LF Line Feed sent as the last data byte or the hardware EOI with the EOI line asserted concurrently with the last data byte sent 4 Set the GPIB address using the rotary knob or the front panel keypad The value can be set from 1 to 30 ...

Page 15: ... ...

Page 16: ......

Page 17: ...rogramming of instruments These guidelines provide a consistent program ming environment for instrument control and data transfer This environment uses defined programming messages instrument responses and data format across all SCPI instruments regardless of manufacturer The realtime spectrum analyzer uses a command language based on the SCPI standard The SCPI language is based on a hierarchical ...

Page 18: ...add a question mark SENSe AVERage TYPE is an example of a valid SCPI query using the hierarchy tree in Figure 2 1 Many commands accept either string or numeric arguments For example a boolean argument can either be 1 or ON Select signal parameter commands accept either a numeric value or one of the following strings Use this argument to query the minimum value or set the parameter value to the min...

Page 19: ...ecimal2 Hexadecimal numbers 0 9 A B C D E F HAA H1 NR12 3 numeric Integers 0 1 15 1 NR22 numeric Decimal numbers 1 2 3 141516 6 5 NR32 numeric Floating point numbers 3 1415E 9 16 1E5 NRf2 numeric Flexible decimal number that may be type NR1 NR2 or NR3 See NR1 NR2 NR3 examples string4 Alphanumeric characters must be within quotation marks Testing 1 2 3 1 Defined in ANSI IEEE 488 2 as Definite Lengt...

Page 20: ... a command You can chain several commands or queries together into a single message To create a chained message first create a command or query add a semicolon and then add more commands or queries and semicolons until you are done If the command following a semicolon is a root node precede it with a colon Figure 2 3 illustrates a chained message consisting of several commands and queries The sing...

Page 21: ...ries and parameters H You can use single or double quotation marks for quoted strings but you cannot use both types of quotation marks for the same string correct This string uses quotation marks correctly correct This string also uses quotation marks correctly incorrect This string does not use quotation marks correctly H You can use upper case lower case or a mixture of both cases for all comman...

Page 22: ...n command is an asterisk followed by a command and optionally a space and parameter value The syntax for an IEEE 488 2 common query is an asterisk followed by a query and a question mark All of the common commands and queries are listed in the last part of the Syntax and Commands section The following are examples of common commands H ESE 16 H CLS The following are examples of common queries H ESR...

Page 23: ...ator The end of message terminator may be the END message EOI asserted concurrently with the last data byte the ASCII code for line feed LF sent as the last data byte or both The realtime spectrum analyzer always terminates messages with LF and EOI It allows white space before the terminator ...

Page 24: ...Syntax 3026 Programmer Manual ...

Page 25: ...h a command and query form of the command can be used Command Summaries Tables 2 3 through 2 13 list the command that are part of the 10 functional groups Use these commands to control settings related to the measurement functions such as the kind of measurement and parameter settings and to query measure ment results and readiness state Table 2Ć3 CALCULATE commands Header Description CALCulate 1 ...

Page 26: ...Play CURrent TRACe DISPlay CURrent WINDow DISPlay FORMat DISPlay MARKer FNUMber DISPLay MARKer PEAK DISPlay MARKer PEAK SEParaĆ tion DISPlay MARKer SELect DISPlay MARKer TYPE DISPlay MARKer X DISPlay MARKer X UNIT DISPlay MARKer Y DISPlay MARKer Y UNIT DISPlay MENU NAME DISPlay MENU STATe DISPlay TRACe ACTIVE DISPlay TRACe AVERage DISPlay TRACe REFerence DISPlay WINDow 1 2 TYPE DISPLAY Commands ...

Page 27: ...ontrol file and directory operations Table 2Ć6 MEMORY commands Header Description MMEMory CDIRectory MMEMory MDIRectory MMEMory RSETUP MMEMory RTMASK MMEMory RWAVE MMEMory SAWAVe MMEMory SORT MMEMory SSETUP MMEMory STMASK MMEMory STWAVe MMEMory SWAVE Use these commands to control settings related to data acquisition and query acquisition data Table 2Ć7 SENSE commands Header Description SENSe SENSe...

Page 28: ...Se GAIN EXTernal GAIN SENSe GAIN EXTernal STATe SENSe LEVel SENSe LEVel UNIT SENSe RF SENSe WINDow TYPE Use these commands to select the reference clock signal source Table 2Ć8 SOURCE commands Header Description SOURce ROSCillator SOURce Use these commands to address the instrument status and event queue Table 2Ć9 STATUS commands Header Description STATus OPERation EVENt STATus OPERation ENABle ST...

Page 29: ...ch as system date and time Table 2Ć10 SYSTEM commands Header Description SYSTem DATE SYSTem ERRor SYSTem FTPD STATe SYSTem TIME SYSTem VERSion Use these commands to set the trigger conditions for the internal and external trigger source Table 2Ć11 TRIGGER commands Header Description TRIGger TRIGger COUNt TRIGger FREQMASK CONDition TRIGger LEVel TRIGger MODE TRIGger POSition TRIGger SOURce SYSTEMĂC...

Page 30: ... installed modules Table 2Ć12 COMMON commands Header Description CAL CLS ESE ESR IDN RCL SAV SRE STB TST This group is a collection of commands that cannot be classified in any other group Table 2Ć13 Other commands Header Description ABORt INITiate IMMediate RUNNing COMMON Commands Other Commands ...

Page 31: ...mal spelling shown in upper case For example to use the abbreviated version of the command just type The symbol follows the command header of those commands that can be used as either a command or a query The symbol follows those commands that can only be a query If neither symbol follows the command it can only be used as a command The command stops data acquisition It performs the same function ...

Page 32: ...ng Zero value the calibration is complete without error NonĆzero value an error has been detected CAL executes gain calibration and then returns the result CALCulate 1 2 The CALCulate 1 2 query returns the measurement item and the result of measurement CALCULATE CALCulate 1 2 FUNCtion CALCulate 1 2 FUNCtion RESult CALCulate 1 2 Switch 1 specifies the lower window of the data display area and switc...

Page 33: ...he current bandwidth setting CALCULATE CALCulate 1 2 ACP SPACing CALCulate 1 2 ACP BANDwidth numeric value CALCulate 1 2 ACP BANDwidth Switch 1 specifies the lower window of the data display area and switch 2 specifies the upper one numeric value NR3 where NR3 is a bandwidth ranging from 1 Hz to 2E 6 Hz NR3 CALCULATE ACP BANDWIDTH 3E 5 sets the bandwidth for ACP measurement to 300 kHz Examples Gro...

Page 34: ...specifies the upper one numeric value NR3 where NR3 is a bandwidth ranging from 1 Hz to 2E 6 Hz NR3 CALCULATE ACP SPACING 6E 5 sets the channel interval for ACP measurement to 600 kHz CALCulate 1 2 FUNCtion The CALCulate 1 2 FUNCtion command selects the measurement item The CALCulate 1 2 FUNCtion query returns the current selected measurement item CALCULATE None CALCulate 1 2 FUNCtion OFF OBW CN A...

Page 35: ...Sult The CALCulate 1 2 FUNCtion RESult query returns the result of measure ment CALCULATE None CALCulate 1 2 FUNCtion RESult Switch 1 specifies the lower window of the data display area and switch 2 specifies the upper one None NR3 NR3 CALCULATE FUNCTION RESULT during C N measurement might return 60 4917 23 2237 In this case the first value indicates the result of the C N measurement and the secon...

Page 36: ...y about the result of measurement is disabled CALCULATE FUNCTION RESULT READY might return 1 This indicates that the query is enabled CALCulate 1 2 OBW RATE The CALCulate 1 2 OBW RATE command sets the power rate of the carrier signal relative to the total power for the OBW measurement The CALCuĆ late 1 2 OBW RATE query returns the current power rate setting CALCULATE None CALCulate 1 2 OBW RATE nu...

Page 37: ... the power rate for the OBW measurement to 99 The CLS common command clears SESR Standard Event Status Register the SBR Status Byte Register and the Event Queue which are used in the instrument status and event reporting system For more details refer to Section 3 Status and Events COMMON None CLS CLS clears the SESR the SBR and the Event Queue ...

Page 38: ...IT DBM DBV DBMV DBUV DBUVM W V DEG PERCENT HZ NONE MARKER X NR3 MARKER UNIT HZ S NONE MARKER PEAK SEPARATION NR1 MARKER FNUMBER NR1 Items in brackets are not displayed DISPLAY might return MEAS 1 TWO SPEC WIND1 ACTIVE 1 0 0 SING MARK1 1 160666E 02 BM 6 343750E 06 HZ 9 0 DISPlay CURrent TRAce When two waveforms the reference and the one currently being acquired are on display the DISPlay CURrent TR...

Page 39: ...ISPLAY DISPlay FORMat DISPlay WINDow 1 2 TYPE DISPlay CURrent WINDow WINDow1 WINDow2 DISPlay CURrent WINDow WINDow1 selects the lower window in the data display area WINDow2 selects the upper window in the data display area WIND1 WIND2 DISPLAY CURRENT WINDOW WINDOW1 sets the lower window to the current window DISPlay FORMat The DISPlay FORMat command sets the display format in the data display are...

Page 40: ...ive cursor to specified frame The DISPlay MARKer FNUMber query returns the frame number that the active cursor is on DISPLAY None DISPlay MARKer FNUMber MAXimum MINimum NTRigger NR1 DISPlay MARKer FNUMber MAXimum moves the active cursor to the last frame MINimum moves the active cursor to the fist frame NTRigger moves the active cursor to the trigger frame numeric value NR1 frame number DISPLAY MA...

Page 41: ...y MARKer PEAK BIGGest NRIGht NLEFt BIGGest moves the marker to the highest peak NRIGht moves the marker to the nearest peak to the right of the current marker position NLEFt moves the marker to the nearest peak to the left of the current marker position DISPLAY MARKER PEAK BIGGEST moves the marker to the highest peak in the waveform Group Related Commands Syntax Arguments Examples ...

Page 42: ...eak detection interval ranging from 1 to 10 NR1 DISPLAY MARKER PEAK SEPARATION 4 sets the peak detection interval to 4 DISPlay MARKer SELect The DISPlay MARKer SELect command selects the active marker when two markers MARKER1 and MARKER2 are displayed on a waveform The DISPlay MARKer SELect query returns which marker is currently active DISPLAY DISPlay MARKer TYPE DISPlay MARKer SELect MARKer1 MAR...

Page 43: ...e DISPlay MARKer TYPE query returns a string which corresponds to the number of markers displayed on the current waveform DISPLAY DISPlay MARKer SELect DISPlay MARKer TYPE OFF SINGle DUAL DISPlay MARKer TYPE OFF displays no markers SINGle displays the single marker MARKER1 DUAL displays the dual markers MARKER1 and MARKER2 DISPLAY MARKER TYPE DUAL displays two markers Examples Group Related Comman...

Page 44: ...umeric value DISPlay MARKer X numeric value NRf unit unit Hz kHz MHz M GHz G s ms us u ns n DISPLAY MARKER X might return 1 6000000E 07 DISPlay MARKer X UNIT The DISPlay MARKer X UNIT query the horizontal display unit on the graticule for the current marker DISPLAY DISPlay MARKer Y UNIT DISPlay MARKer X UNIT None HZ S NONE DISPLAY MARKER X UNIT might return HZ Group Related Commands Syntax Argumen...

Page 45: ...Y MARKER Y might return 1 606673E 01 DISPlay MARKer Y UNIT The DISPlay MARKer Y UNIT query the vertical display unit on the graticule for the current marker DISPLAY DISPlay MARKer X UNIT DISPlay MARKer Y UNIT None DBM DBV DBMV DBUV DBUVM W V DEG PERCENT HZ NONE DISPLAY MARKER Y UNIT might return DBM Group Related Commands Syntax Arguments Responses Examples Group Related Commands Syntax Arguments ...

Page 46: ...tility menu TRIG displays the trigger menu MARKer displays the marker menu SAVE displays the save menu RESTore displays the restore menu FREQuency displays the frequency menu SPAN displays the span menu LEVel displays the level menu DISP MEAS SETU UTIL TRIG MARK SAVE REST FREQ SPAN LEV 1 0 where 1 0 indicate display status of the menu DISPLAY MENU NAME UTILITY selects the UTILITY menu DISPlay MENU...

Page 47: ...Ce ACTIVE The DISPlay TRACe ACTIVE command sets whether to display input waveform The DISPlay TRACe ACTIVE query returns the setting of whether to display input waveform DISPLAY None DISPlay TRACe ACTIVE boolean DISPlay TRACe ACTIVE boolean 0N 0FF 1 0 ON 1 displays the input waveform OFF 0 hides the input waveform boolean DISPLAY TRACE ACTIVE OFF hides the input waveform Syntax Arguments Responses...

Page 48: ...age boolean ON OFF 1 0 ON 1 displays averaged or peak held waveform OFF 0 displays acquired original waveform boolean DISPLAY TRACE AVERAGE ON displays averaged or peak held waveform DISPlay TRACe REFerence The DISPlay TRACe REFerence command sets whether to display the reference waveform The DISPlay TRACe REFerence query returns the setting of whether to display the reference waveform DISPLAY Non...

Page 49: ...ng DISPLAY DISPlay FORMat DISPlay WINDow 1 2 TYPE PROFile SPECtrogram WATerfall ADEMod DISPlay WINDow 1 2 TYPE Switch 1 specifies the lower window of the data display area and switch 2 specifies the upper one PROFile display the data in a spectrum view SPECtrogram display the data in a spectrogram view WATerfall display the data in a waterfall view ADEMod displays the data as an AM FM PM or FSK de...

Page 50: ... value NR1 where NR1 is a decimal integer ranging from 0 to 255 The ESER bits will be set to the binary equivalent of the decimal integer sent ESE 177 sets the ESER to 177 binary 10110001 which sets the PON CME EXE and OPC bits ESE might return 176 which indicates that the ESER contains the binary number 10110000 The ESR common query returns the contents of SESR Standard Event Status Register used...

Page 51: ...y number 10110101 The HCOPy query returns the set image data format and output port for hardcopy output HARDCOPY HCOPy DEVice LANGuage HCOPy DEVice DESTination HCOPy None BMP EPS FILE PRIN OFF HCOPY might return BMP FILE In this case the instrument outputs hardcopy data to file on the floppy disk in the BMP format ...

Page 52: ...Tination HCOPy DEVice LANGuage The HCOPy DEVice LANGuage command sets the hard copy output format The HCOPy DEVice LANGuage query returns the currently specified hard copy output format HARDCOPY HCOPy HCOPy DEVice DESTination HCOPy DEVice LANGuage BMP EPS HCOPy DEVice LANGuage BMP the standard bit mapped graphics format EPS the encapsulated Postscript image file format BMP EPS HCOPY DEVICE LANGUAG...

Page 53: ...ppy disk OFF PRIN FILE HCOPY DEVICE DESTINATION FILE sets the hard copy output destination to a file on the floppy disk HCOPy IMMediate The HCOPy IMMediate command immediately outputs the hardcopy with the current settings HARDCOPY None HCOPy IMMediate None HCOPY IMMEDIATE starts hardcopy output Arguments Responses Examples Group Related Commands Syntax Arguments Examples ...

Page 54: ...Serial Number Jxxxxxx System Status SCPI SCPI Version FW Firmware Version HW Hardware Version IDN might return SONY TEK 3026 J300110 SCPI 94 0 FW 1 00 HW 1 00 INITiate IMMediate The INITiate IMMediate command restarts data acquisition It performs the same function as the front panel START key Other None INITiate IMMediate None Group Related Commands Syntax Arguments Responses Examples Group Relate...

Page 55: ...ORY CDIRECTORY HARDCOPY WORK3 changes the current working directory to HARDCOPY WORK3 MMEMory MDIRectory The MMEMory MDIRectory command creates a new subdirectory The command is invalid if a directory with the specified name already exists MEMORY MMEMory CDIRectory MMEMory RDIRectory MMEMory MDIRectory Directory Path Directory Path string where string is the name or path of the new directory MMEMO...

Page 56: ...he register MMEMORY RSETUP D1 restores the instrument setup from the D1 register MMEMory RTMASK The MMEMory RTMASK command restores the trigger mask from a disk file or the specified register MEMORY MMEMory STMASK MMEMory RTMASK string D1 D2 D3 D4 string the name of the file to be restored D1 D4 the number of the register MMEMORY RTMASK D1 restores the trigger mask from the D1 register Group Relat...

Page 57: ...stored D1 D4 the number of the register MMEMORY RWAVE D1 restores the waveform data from the D1 register The MMEMory SAWAVe command saves the averaged waveform data to a disk file or the specified register MEMORY None MMEMory SAWAVe string D1 D2 D3 D4 string the name of the file that the averaged waveform data is to be saved in D1 D4 the number of the register MMEMORY SAWAVE D1 saves the averaged ...

Page 58: ...c order NAME2 orders the display in the reverse order of the NAME1 order TIME1 orders the display with older Date and Time files first TIME2 orders the display with more recent Date and Time files first NAME1 NAME2 TIME1 TIME2 MMEMORY SORT NAME1 sets the order of file information recorded in disk directory listings to alphabeti cal order by file name MMEMory SSETUP The MMEMory SSETUP command saves...

Page 59: ...ETUP D1 saves the instrument setup to the D1 register The MMEMory STMASK command saves the trigger mask to a disk file or the specified register MEMORY MMEMory RTMASK MMEMory STMASK string D1 D2 D3 D4 string the name of the file that the trigger mask is to be saved in D1 D4 the number of the register MMEMORY STMASK D1 saves the trigger mask to the D1 register ...

Page 60: ...he waveform data is to be saved in D1 D4 the number of the register MMEMORY STWAVE D1 saves the waveform data to the D1 register as a text format The MMEMory SWAVe command saves the waveform data to a disk file or the specified register MEMORY MMEMory RWAVe MMEMory SWAVe string D1 D2 D3 D4 string the name of the file the waveform data is saved D1 D4 the number of the register MMEMORY SWAVE D1 save...

Page 61: ... RUNNing query returns whether the instrument is either acquiring data or waiting for a trigger Other STARt STOP RUNNing None 1 The instrument is either acquiring waveform data or waiting for a trigger 0 The instrument is not acquiring waveform data RUNNING might return 0 This indicates that the instrument is not acquiring waveform data Group Related Commands Syntax Arguments Examples Group Relate...

Page 62: ...query returns data acquisition settings SENSE None SENSe None SENSE RF 1 0 FREQUENCY CENTER NRf SPAN NRf LEVEL NR3 LEVEL UNIT DBM DBV DBMV DBUV V W ADEMOD WIND1 WIND2 AM PM FM FSK WINDOW TYPE REC BLACK HAMM FFT SIZE FFT1024 FFT256 FRAME PERIOD NR3 BLOCK SIZE NR1 AVERAGE TYPE OFF RMS EXPONENTIAL PEAK AVERAGE COUNT NR1 GAIN EXTERNAL GAIN NR2 GAIN EXTERNAL STATE 1 0 ACQUISITION MODE ROLL BLOCK Items ...

Page 63: ...the data acquisition mode to Roll or Block The SENSe ACQuisition MODE query returns the current setting of the data acquisition mode SENSE None SENSe ACQuisition MODE ROLL BLOCK SENSe ACQuisition MODE ROLL sets the data acquisition mode to Roll BLOCK sets the data acquisition mode to Block ROLL BLOCK SENSE ACQUISITION MODE BLOCK sets the data acquisition mode to Block Examples Group Related Comman...

Page 64: ...window AM demodulates an AM signal PM demodulates a PM signal FM demodulate an FM signal FSK demodulates an FSK signal WIND1 WIND2 AM PM FM FSK SENSE ADEMOD WINDOW1 FM sets the type of demodulation in the lower window to FM SENSe AVERage COUNt The SENSe AVERage COUNt command sets the number of frames used for averaging in average peak hold mode The SENSe AVERage COUNt query returns the number of f...

Page 65: ... where NR1 is number of times of averaging ranging from 2 to 100 NR1 SENSE AVERAGE COUNT 16 sets the number of averaging to 16 The SENSe AVERage RESET command resets the average peak hold data SENSE SENSe AVERage COUNt SENSe AVERage TYPE SENSe AVERage RESET None ...

Page 66: ...nctions RMS selects RMS averaging EXPONENTIAL selects averaging with an exponential delay function PEAK selects peak hold OFF RMA EXPONENTIAL PEAK SENSE AVERAGE TYPE RMS sets the average peak hold mode to RMS SENSe BLOCK SIZE The SENSe BLOCK SIZE command sets the block size of the data that is acquired in block mode The SENSe BLOCK SIZE query returns the current block size setting SENSE SENSe ACQu...

Page 67: ...er Manual numeric value NR1 where NR1 is a block size The set range is as follows If FFT points 1 024 20 to 1 000 in increments of 20 If FFT points 256 20 to 4 000 in increments of 20 NR1 SENSE BLOCK SIZE 500 sets the block size to 500 ...

Page 68: ...physical frames The data corresponding to the horizontal range currently being displayed is sent The number of data elements is 450 which equals the number of pixels contained in the area displaying the waveform The range of the data to send can be varied by using Horizontal Axis to adjust the horizontal range displayed DEFINE LENGTH ARBITRARY BLOCK RESPONSE DATA defined in IEEE 488 2 is used to r...

Page 69: ... the number of FFT sampling points The SENSe FFT SIZE query returns the current setting of the number of FFT sampling points SENSE None SENSe FFT SIZE FFT1024 FFT256 SENSe FFT SIZE FFT1024 sets 1 024 for the number of sampling points FFT256 sets 256 for the number of sampling points FFT1024 FFT256 SENSE FFT SIZE FFT256 sets the FFT sampling points to 256 Group Related Commands Syntax Arguments Res...

Page 70: ... value SENSe FRAMe PERIOD MAXimum sets the frame period to the maximum MINimum sets the frame period to the minimum numeric value NR3 where NR3 is a frame period MAXIMUM MINIMUM NR3 SENSE FRAME PERIOD 3 2E 4 sets the frame period to 320 s SENSe FREQuency CENTer The SENSe FREQuency CENTer sets the center frequency The SENSe FREQuenĆ cy query returns the current center frequency setting SENSE None S...

Page 71: ...uency SPAN command sets the frequency span The SENSe FREQuency SPAN query returns the current frequency span setting SENSE SENSe RF SENSe FREQuency SPAN numeric value MAXimum MINimum SENSe FREQuency SPAN numeric value NRf unit where unit Hz MHz GHz MAXimum sets the frequency span to the maximum MINimum sets the frequency span to the minimum numeric value SENSE FREQUENCY SPAN 1MHz sets the frequenc...

Page 72: ...where NR2 is a gain correction value ranging from 20 0 dB to 90 0 dB in 0 1 dB steps NR2 SENSE GAIN EXTERNAL GAIN 10 sets the gain correction value to 10 dB SENSe GAIN EXTernal STATe The SENSe GAIN EXTernal STATe command sets whether gain correction is enabled The SENSe GAIN EXTernal STATe query returns whether gain correction is currently enabled SENSE SENSe GAIN EXTernal GAIN SENSe GAIN EXTernal...

Page 73: ... the graticule unit of the vertical axis The value in parentheses represent the set range that applies when the 50 Hz to 10 MHz input range is used dBm 50 0 dBm to 30 0 dBm 30 0 dBm to 30 0 dBm dBV 63 0 dBV to 17 0 dBV 43 0 dBV to 17 0 dBV dBmV 3 0 dBmV to 77 0 dBmV 17 0 dBmV to 77 0 dBmV dB V 57 0 dB V to 137 0 dB V 77 0 dB V to 137 0 dB V V 707 1 uV to 7 071 V 7 071 mV to 7 071 V W 10 00 nW to 1...

Page 74: ...rtical axis to dBV DBMV sets the graticule unit of the vertical axis to dBmV DBUV sets the graticule unit of the vertical axis to dB V V sets the graticule unit of the vertical axis to V W sets the graticule unit of the vertical axis to W DBM DBV DBMV DBUV V W SENSe LEVel UNIT DBV sets the graticule unit of the vertical axis to dBV SENSe RF The SENSe RF command sets the input range to RF or baseba...

Page 75: ... SENSe WINDow TYPE command sets the FFT window type The SENSe WINDow TYPE query returns the current FFT window type setting SENSE None SENSe WINDow TYPE RECTangle BLACKman HAMMing SENSe WINDow TYPE RECTangle selects rectangle BLACKman selects Blackman Harris HAMMing selects hamming RECT BLACK HAMM SENSE WINDOW TYPE BLACKMAN sets the FFT window type to Blackman Harris Arguments Responses Examples G...

Page 76: ...rnal SOURce ROSCillator SOURce INTernal uses the internal clock source EXTernal uses the external clock source INT EXT SOURCE ROSCILLATOR SOURCE EXTERNAL sets the external clock signal for the reference clock SRE The SRE common command sets the bits of the SRER Service Request Enable Register The SRE common query returns the contents of SRER COMMON CLS ESE ESR STB SRE numeric Value SRE numeric Val...

Page 77: ...tains the binary number 00100000 STATus OPERation EVENt The STATus OPERation EVENt query returns the contents of the OSR Operational Status Register Executing this command causes the contents of the register to be cleared STATUS STATus QUEStionable EVENt STATus OPERation EVENt None STATUS OPERATION EVENT might return 0 Examples Group Related Commands Syntax Arguments Examples ...

Page 78: ...ON might return 81 STATus OPERation ENABle The STATus OPERation ENABle command set the register that enables the individual bits within the Event Register which records event transition The STATus OPERation ENABle query returns the current Event Register settings STATUS None STATus OPERation ENABle numeric value STATus OPERation ENABle numeric value NR1 NR1 Group Related Commands Syntax Arguments ...

Page 79: ...TATUS CLS STATus PRESet None STATus QUEue NEXT The STATus QUEue NEXT query returns an error from the error event queue STATUS SYSTem ERRor STATus QUEue NEXT None NR1 string STATUS QUEUE NEXT might return 221 Settings conflict disp Group Related Commands Syntax Arguments Group Related Commands Syntax Arguments Responses Examples ...

Page 80: ...TATUS STATus OPERation EVENt STATus QUEStionable EVENt None STATUS QUESTIONABLE EVENT might return 0 STATus QUEStionable CONDition The STATus QUEStionable CONDition query returns the contents of the CR Condition Register STATUS STATus QUEStionable EVENt STATus QUEStionable CONDition None STATUS QUESTIONABLE CONDITION might return 81 Group Related Commands Syntax Arguments Examples Group Related Co...

Page 81: ...le numeric value NR1 NR1 STB The STB common query returns the value of the SBR Status Byte Register Bit 6 of the SBR is read as a MSS Master Status Summary bit Refer to Section 3 Status and Events for more details on the SBR COMMON CLS ESE ESR SRE STB None numeric value NR1 where NR1 is a decimal integer which must range from 0 to 255 STB might return 96 which indicates that the SBR contains the b...

Page 82: ... SYSTem DATE Year NR1 the year Month NR1 the month Day NR1 the day Year Month Day SYSTEM DATE 1998 6 10 sets the date SYSTem ERRor The SYSTem ERRor query returns an error message from the error event queue SYSTEM STATus QUEue NEXT SYSTem ERRor None NR1 string SYSTEM ERROR might return 0 No error Group Related Commands Syntax Arguments Responses Examples Group Related Commands Syntax Arguments Resp...

Page 83: ... to enable or disable file transfer using FTP File Transfer Protocol The SYSTem FTPD STATe query returns the current FTP setting SYSTEM None SYSTem FTPD STATe boolean SYSTem FTPD STATe boolean ON OFF 1 0 ON 1 enables FTP OFF 0 disables FTP boolean SYSTEM FTPD STATE ON enables FTP Group Related Commands Syntax Arguments Responses Examples ...

Page 84: ...econd SYSTem TIME Hour the hours Minute the minutes Second the seconds Hour Minute Second SYSTEM TIME 10 10 35 sets the time SYSTem VERSion The SYSTem VERSion query returns the SCPI version number complied with the instrument SYSTEM None SYSTem VERSion None NR2 SYSTEM VERSION might return 1994 0 Group Related Commands Syntax Arguments Responses Examples Group Related Commands Syntax Arguments Resp...

Page 85: ... TIMELEVEL EXT IN COUNT NR1 FREQMASK CONDITION BREAK INSIDE LEVEL NR2 POSITION NR1 Items in brackets are not displayed TRIGGER might return NORM FREQMASK 1 BREAK 1 000000 50 TRIGger COUNt The TRIGger COUNt command sets the number of blocks block count of data acquired in block mode The TRIGger COUNt query returns the current block count setting TRIGGER SENSe BLOCk SIZE TRIGger COUNt MAXimum MINimu...

Page 86: ...ion command sets the condition that causes a trigger to occur when the frequency mask is being used The TRIGger FREQĆ MASK CONDition query returns the current setting TRIGGER None TRIGger FREQMASK CONDition BREAK INSIDE TRIGger FREQMASK CONDition BREAK causes a trigger when a waveform value outside the trigger mask pattern is encountered INSIDE causes a trigger when a waveform value inside the tri...

Page 87: ...IGger LEVel numeric value NR2 where NR2 is a trigger level value ranging from 0 000 V to 8 000 V NR2 TRIGGER LEVEL 0 01 sets the level to 0 01 V TRIGger MODE The TRIGger MODE command sets the trigger mode The TRIGger MODE query returns the current trigger mode setting TRIGGER None TRIGger MODE NORMal AUTO TRIGger SLOPe NORMal selects the Normal mode AUTO selects the Auto mode TRIGGER MODE AUTO set...

Page 88: ...OSition numeric value TRIGger Position numeric value NR1 where NR1 is a trigger position ranging from 10 to 90 in steps of 1 NR1 TRIGGER POSITION 50 sets the trigger position to 50 TRIGger SOURce The TRIGger SOURce command selects the trigger source for generating the trigger The TRIGger SOURce query returns the current trigger source setting TRIGGER TRIGger MODE TRIGger SOURce FREQMASK TIMELEVEL ...

Page 89: ...l within the time domain to generate the trigger EXT IN uses the signal input through the front panel EXT TRIG connector to generate the trigger FREQMASK TIMELEVEL EXT IN TRIGGER SOURCE FREQMASK uses a trigger mask pattern to generate the trigger The TST common query performs the self test sequence No response is returned COMMON None TST None None ...

Page 90: ...Command Descriptions 3026 Programmer Manual ...

Page 91: ... ...

Page 92: ......

Page 93: ... There are two main types of registers H Status Registers stores data relating to instrument status This register is set by the realtime spectrum analyzer H Enable Registers determines whether to set events that occur in the instrument to the appropriate bit in the status registers and event queues This type of register can be set by the user There are five types of status registers H Status Byte ...

Page 94: ...it and indicates to the controller that a service request has occurred in other words that the GPIB bus SRQ line is LOW The RQS bit is cleared when serial poll ends When the instrument is accessed using the STB query this bit is called the Master Status Summary MSS bit and indicates that the instrument has issued a service request for one or more reasons The MSS bit is never cleared to 0 by the ST...

Page 95: ...hen a value designated in the argument is outside the allowable range of the instrument or is in conflict with the capabilities of the instrument H When the command could not be executed properly because the conditions for execution differed from those essentially required 3 DeviceĆSpecific Error DDE An instrument error has been detected 2 Query Error QYE Indicates that a query error has been dete...

Page 96: ...se registers The query will return an integer value whose bits represent the status of each slot The most significant bit MSB of each ISR is always set to 0 For example given the following response to the CAT FULL query CPU 0 CLOCK 1 BG1 2 AGL1 3 AVG1 7 DVG1 8 The response from the STAT OPER INST COND query will be 399 Converting the decimal integer 399 to binary gives 110001111 Starting at the le...

Page 97: ... 0 through 7 in the SBR see Figure 3 4 This register is used by the user to determine what events will generate service requests The SRER bit 6 cannot be set Also the RQS is not maskable The generation of a service request with the GPIB interface involves changing the SRQ line to LOW and making a service request to the controller The result is that a status byte for which an RQS has been set is re...

Page 98: ...mptied each time a command or query is received so the controller must read the output queue before the next command or query is issued If this is not done an error will occur and the output queue will be emptied however the operation will proceed even if an error occurs The event queue is a FIFO queue and stores events as they occur in the instru ment If more than 32 events occur event 32 will be...

Page 99: ... QYE OPC 7 6 5 4 3 2 1 0 PON CME EXE DDE QYE OPC 7 6 5 4 3 2 1 0 RQS ESB MAV Ċ Ċ Ċ MSS 7 6 5 4 3 2 1 0 6 Ċ ESB MAV Ċ Ċ Ċ 7 6 5 4 3 2 1 0 OSB QSB Ċ Ċ OSB QSB Ċ Ċ 1 If an event has occurred the SESR bit corresponding to that event is set and the event is placed in the event queue 2 A bit corresponding to that event in the ESER has is set 3 The SBR ESB bit is set to reflect the status of the ESER 4 W...

Page 100: ...YSTem ER Ror and STATus QUEue NEXT These are returned in the following format event code event message Table 3 3 shows the messages generated when there is a syntax error in the command Table 3 4 shows the messages generated when an error is detected while a command is being executed Table 3 5 shows the messages generated when an internal instrument error is detected When this type of error occurs...

Page 101: ... Manual Error codes with a negative value are SCPI standard error codes errors with a positive value are unique to the realtime spectrum analyzer Command errors are returned when there is a syntax error in the command ...

Page 102: ...Error Messages and Codes 3026 Programmer Manual These error codes are returned when an error is detected while a command is being executed ...

Page 103: ...Error Messages and Codes 3026 Programmer Manual ...

Page 104: ... 3Ć4 Execution errors Cont Error code Error message Device Specific Errors These error codes are returned when an internal instrument error is detected This type of error may indicate a hardware problem Table 3Ć5 Device specific errors Error code Error message ...

Page 105: ...Error Messages and Codes 3026 Programmer Manual These error codes are returned in response to an unanswered query ...

Page 106: ...Error Messages and Codes 3026 Programmer Manual ...

Page 107: ... ...

Page 108: ......

Page 109: ... 0 1 1 ETX DC3 LA3 LA19 3 TA3 C TA19 S SA3 c SA19 s 0 1 0 0 SDC EOT DCL DC4 LA4 LA20 4 TA4 D TA20 T SA4 d SA20 t 0 1 0 1 PPC ENQ PPU NAK LA5 LA21 5 TA5 E TA21 U SA5 e SA21 u 0 1 1 0 ACK SYN LA6 LA22 6 TA6 F TA22 V SA6 f SA22 v 0 1 1 1 BEL ETB LA7 LA23 7 TA7 G TA23 W SA7 g SA23 w 1 0 0 0 GET BS SPE CAN LA8 LA24 8 TA8 H TA24 X SA8 h SA24 x 1 0 0 1 TCT HT SPD EM LA9 LA25 9 TA9 I TA25 Y SA9 i SA25 y 1...

Page 110: ...M 4D 77 135 TA29 5D 93 155 SA13 m 6D 109 175 SA29 7D 125 1 1 1 0 16 SO E 14 36 RS 1E 30 56 LA14 2E 46 76 LA30 3E 62 116 TA14 N 4E 78 136 TA30 5E 94 156 SA14 n 6E 110 176 SA30 7E 126 1 1 1 1 17 SI F 15 37 US 1F 31 57 LA15 2F 47 77 UNL 3F 63 117 TA15 O 4F 79 137 UNT 5F 95 157 SA15 o 6F 111 177 7F 127 RUBOUT DEL ADDRESSED COMMANDS UNIVERSAL COMMANDS LISTEN ADDRESSES TALK ADDRESSES SECONDARY ADDRESSES...

Page 111: ...DEVice DESTination DISPlay ENABle EVENt ERRor EXTernal FFT FORMat FNUMber FRAMe FREQMASK FREQuency FTPD FUNCtion GAIN HCOPy IMMediate INITiate LEVel LANGuage MARKer MDIRectory MENU MMEMory MODE NAME OBW OPERation PEAK PERIOD POSition PRESet QUEStionable QUEue RATE REFerence RESET RESult RF ROSCillator RSETUP RTMASK RUNNing RWAVe SAWAVe SELect SENSe SEParation SIZE SORT SOURce SPACing SPAN SSETUP S...

Page 112: ...Appendix B Reserved Words 3026 Programmer Manual ...

Page 113: ...ss if my talk address MTA No talk only mode Talker T T5 Basic Talker Serial Poll Unaddress if myĆlistenĆaddress MLA Device Clear DC DC1 Complete Remote Local RL RL1 Complete Service Request SR SR1 Complete Parallel Poll PP PP0 None Device Trigger DT DT1 Complete Controller C C0 None Electrical Interface E2 ThreeĆstate driver H Acceptor Handshake AH Allows a listening device to help coordinate the ...

Page 114: ... sources for operating control This function determines whether input information from the front panel controls local or GPIB commands remote control the data generator H Service Request SR Allows a device to request service from the controller H Controller C Allows a device with the capability to send the device address universal commands and addressed commands to other device over the interface ...

Page 115: ... request H Serial Poll Disable SPD Changes all devices on the bus from the serial poll state to the normal operating state H Go To Local GTL Causes the listen addressed device to switch from remote to local front panel control H Select Device Clear SDC Clears or initializes all listen addressed devices H Group Execute Trigger GET Triggers all applicable devices and causes them to initiate their pr...

Page 116: ...Appendix C Interface Specification 3026 Programmer Manual ...

Page 117: ...NCTION OFF CALCulate OBW RATE 99 000000 DISPLAY commands DISPlay CURrent WINDow WINDOW1 DISPlay FORMat SINGLE DISPlay MARKer PEAK BIGGEST DISPlay MARKer SELect MARKER1 DISPlay MARKer TYPE OFF DISPlay TRACe ACTIVE ON DISPlay TRACe AVERage OFF DISPlay TRACe REFerence OFF DISPlay WINDOW 1 2 TYPE PROFILE HARDCOPY commands HCOPy DEVice DESTination OFF HCOPy DEVice LANGuage EPS MEMORY commands MMEMory S...

Page 118: ...100000000 SENSe EXTernal GAIN 0 0 SENSe LEVel 0 0 SENSe LEVel UNIT DBM SENSe RF ON SENSe SPAN 2 000000E 06 SENSe WINDow BLACKman SOURCE commands SOURce ROSCillator SOURce INTERNAL SYSTEM commands SYSTem FTPD OFF TRIGGER commands TRIGger COUNt 1 TRIGger FREQMASK CONDition BREAK TRIGger LEVel 1 000000 TRIGger MODE NORM TRIGger POSition 50 TRIGger SOURce FREQMASK COMMON commands ESE 0 SRE 0 ...

Page 119: ... ...

Page 120: ......

Page 121: ... 21 ESE 2 34 ESR 2 34 IDN 2 38 RCL 2 45 SAV 2 46 SRE 2 60 STB 2 65 TST 2 73 Creating commands 2 2 Default Settings D 1 Description GPIB 1 1 Display commands DISPlay 2 22 DISPlay CURrent TRAce 2 22 DISPlay CURrent WINDow 2 23 DISPlay FORMat 2 23 DISPlay MARKer FNUMber 2 24 DISPlay MARKer PEAK 2 25 DISPlay MARKer PEAK SEParation 2 26 DISPlay MARKer SELect 2 26 DISPlay MARKer TYPE 2 27 DISPlay MARKer...

Page 122: ...erarchy Tree 2 1 IDN 2 38 IEEE 488 2 Common Commands 2 1 2 6 IEEE Std 488 2 1987 2 6 INITiate IMMediate 2 38 Memory commands MMEMory CDIRectory 2 39 MMEMory MDIRectory 2 39 MMEMory RSETUP 2 40 MMEMory RTMASK 2 40 MMEMory RWAVe 2 41 MMEMory SAWAVe 2 41 MMEMory SORT 2 42 MMEMory SSETUP 2 42 MMEMory STMASK 2 43 MMEMory STWAVe 2 44 MMEMory SWAVe 2 44 Message Terminators 2 7 MMEMory CDIRectory 2 39 MME...

Page 123: ...NSe BLOCK SIZE 2 50 SENSe DATA 2 52 SENSe FFT SIZE 2 53 SENSe FRAMe PERIOD 2 54 SENSe FREQuency CENTer 2 54 SENSe GAIN EXTernal GAIN 2 56 SENSe GAIN EXTernal STATe 2 56 SENSe LEVel 2 57 SENSe LEVel UNIT 2 58 SENSe RF 2 58 SENSe SPAN 2 55 SENSe WINDow TYPE 2 59 Source commands SOURce ROSCillator SOURce 2 60 SOURce ROSCillator SOURce 2 60 SRE 2 60 Status commands STATus OPERation CONDition 2 62 STAT...

Page 124: ...RIGger MODE 2 71 TRIGger POSition 2 72 TRIGger SOURce 2 72 TRIGger COUNt 2 69 TRIGger FREQMASK CONDition 2 70 TRIGger LEVel 2 71 TRIGger MODE 2 71 TRIGger POSition 2 72 TRIGger SOURce 2 72 TST 2 73 Where to find other information v ...

Page 125: ......

Page 126: ......

Reviews: