Status and Error Command Group ............... 2-31 System Command Group ................. 2-32 TDR Command Group ..................2-34 Trigger Command Group ................. 2-35 Vertical Command Group................. 2-40 Waveform Database Command Group ..............2-42 Waveform Transfer Command Group ..............2-44 DSA8300 Programmer Manual...
Preface This programmer manual provides you with the information required to use GPIB commands for remotely controlling your instrument. This document supports the following instruments: DSA8300 Series, TekScope application SW version 6.2.X and greater. DSA8300 Programmer Manual...
Page 11
VERBOSE. Verbosity enabled or disabled on one interface is correspondingly enabled or disabled on the other interface. Refer to the command description for more detailed information. Most examples in this document assume that both HEADER VERBOSE DSA8300 Programmer Manual...
Appendices. This section contains miscellaneous information, such as a list of reserved words, a table of the factory initialization (default) settings, and interface specifications that may be helpful when using commands to remotely control the instrument. DSA8300 Programmer Manual...
D-type shell and conforms to IEEE Std 488.1–1987. Attach an Instrument IEEE Std 488.1–1987 GPIB cable to this connector and to your controller as shown in the following figure. If necessary, the GPIB connectors can be stacked as shown in the figure below. DSA8300 Programmer Manual...
Page 14
Getting Started Setting the GPIB Address By default, the DSA8300 is set to address 1 and Talk/Listen (Slave) mode, to enable remote access and control. Software applications that communicate with the instrument over the GPIB bus should use the specified instrument GPIB address.
Messages A command message is a command or query name followed by any information the instrument needs to execute the command or query. Command messages may contain five element types, defined in the following table. DSA8300 Programmer Manual...
Page 18
Commands at a higher level in the tree may affect those at a lower level. The leading colon (:) always returns you to the base of the command tree. DSA8300 Programmer Manual...
You can clear the Output Queue and reset the instrument to accept a new command or query by using the selected Device Clear (DCL) GPIB function. Refer to your GPIB library documentation for further details about the selected Device Clear operation. DSA8300 Programmer Manual...
VERBose command. Concatenating You can concatenate any combination of set commands and queries using a semicolon (;). The instrument executes concatenated commands in the order received. DSA8300 Programmer Manual...
Page 21
The message then queries the number of acquisitions for averaging and the acquisition state. Concatenated commands and queries are executed in the order received. Here are some invalid concatenations: (no colon before ACQuire) DISplay:STYle:NORMal;ACQuire:NUMAVg 10 DSA8300 Programmer Manual...
Mnemonics Table 2-5: Cursor Mnemonics Symbol Meaning A cursor selector; <x> is either 1 or 2. CURSOR<x> POSITION<x> A cursor selector; <x> is either 1 or 2. HPOS<x> A cursor selector; <x> is either 1 or 2. DSA8300 Programmer Manual...
Page 23
A gate specifier; <x> is either 1 (Gate 1) or 2 (Gate 2). Channel Mnemonics Commands specify the channel to use as a mnemonic in the header. Table 2-10: Channel Mnemonics Symbol Meaning CH<x> A channel specifier; <x> is 1 through 8. DSA8300 Programmer Manual...
Quoted String Some commands accept or return data in the form of a quoted string, which is simply a group of ASCII characters enclosed by a single quote (') or double quote DSA8300 Programmer Manual...
Page 25
A nonzero digit character in the range of 1–9 <Dig> A digit character, in the range of 0–9 <DChar> A character with the hexadecimal equivalent of 00 through FF (0 through 255 decimal) <Block> A block of data bytes defined as: <Block> ::= {#<NZDig><Dig>[<Dig>...][<DChar>...] |#0[<DChar>...]<terminator>} DSA8300 Programmer Manual...
Page 26
Command Syntax <NZDig> specifies the number of <Dig> elements that follow. Taken together, the <NZDig> and <Dig> elements form a decimal integer that specifies how many <DChar> elements follow. 2-10 DSA8300 Programmer Manual...
Command Groups The DSA8300 programmable interface conforms to Tektronix standard codes and formats except where noted. The GPIB interface also conforms to IEEE Std 488.2-1987 except where noted. Acquisition Command Group Use the commands in the Acquisition Command Group to set up the modes and functions that control how the instrument acquires the signals you input to the channels and processes them into waveforms.
Returns calibration status for specified sampling module channel<x> CALibrate:STATus:MAInframe? Returns calibration status for mainframe CALibrate:TEMPerature:CH<x>? Returns the difference in ºC between the current sampling module channel<x> temperature and the temperature recorded at the last calibration information update 2-12 DSA8300 Programmer Manual...
COMPensate:DATE:MAInframe? Returns date and time of the current in-use compensation data for the mainframe COMPensate:MAInframe Compensates the mainframe for DC variances COMPensate:OPTGAIN:CH<x> Compensates optical user wavelength gain (wavelengths and input power) DSA8300 Programmer Manual 2-13...
Page 30
COMPensate:SAVe:USER:MAInframe Saves volatile run-time compensation data for the mainframe into its nonvolatile user memory COMPensate:STATus:CH<x>? Returns the current compensation status of the specified module channel<x> COMPensate:STATus:MAInframe? Returns the current compensation status of the mainframe 2-14 DSA8300 Programmer Manual...
Returns hbars cursors vertical difference CURSor:HBArs:POSition<x> Sets or returns the hbar cursor<x> vertical position CURSor:SELect Sets or returns which cursor is active for front-panel control CURSor:VBArs? Returns vbar cursor parameters CURSor:VBArs:DELTa? Returns the difference between vbar cursors DSA8300 Programmer Manual 2-15...
The mode you choose globally affects all displayed waveforms; for example, you cannot set channel 1 to display in Normal mode and channel 2 in Variable Persistence mode. There are four graticule settings: Frame Grid Cross Hair Full 2-16 DSA8300 Programmer Manual...
Sets or returns the display state of the waveform readout Hard Copy Command Group Hard copy commands allow you to make hard copies of your data file or send hard copy data in various formats to a specified file. DSA8300 Programmer Manual 2-17...
You can also export a histogram to a file of comma-separated values. See EXPort command for more information. Description Command HIStogram? Return all histogram parameters HIStogram:BOX Sets or returns the left, top, right, and bottom positions of the histogram box, in source waveform coordinates 2-18 DSA8300 Programmer Manual...
Sets or returns whether the histogram counting is on a waveform database Horizontal Command Group You use the commands from the Horizontal Command Group to control the timebases of the instrument. You can use these commands to do the following: DSA8300 Programmer Manual 2-19...
Page 36
Sets or queries the display scale mode when horizontal units are set to SEConds. HORizontal:DISTance:PVELocity Sets or returns the propagation velocity HORizontal:EXT10MHZref:FREQ Sets or returns the frequency of the 10 MHz external reference when enabled for TDR acquisitions 2-20 DSA8300 Programmer Manual...
Page 37
Sets or returns the main timebase time per division HORizontal:MAIn:TOFPoint? Returns the main timebase time of first point HORizontal:MAIn:TOLPoint? Returns the main timebase time of last point HORizontal:MATH<x>:MAGnify<x>: Returns the Math<x>"Acquisition" horizontal POSition? position for Mag<x> timebase DSA8300 Programmer Manual 2-21...
Page 38
Returns the Reference<x> Mag<x> timebase TOLPoint? time of last point HORizontal:REF<x>:MAIn:POSition? Returns the Reference<x> "Acquisition" horizontal position for main timebase HORizontal:REF<x>:MAIn:RECordlength? Returns the Reference<x> main timebase record length HORizontal:REF<x>:MAIn:REFPoint? Returns the Reference<x> main timebase reference position in percent of record 2-22 DSA8300 Programmer Manual...
Enable, disable, or reset the mask counts. Once you turn on mask counting, it remains on until you explicitly turn it off. Set the color for the mask polygons. DSA8300 Programmer Manual 2-23...
Page 40
Sets or returns which waveform and timebase will be compared against the mask(s) when counting is turned on MASK:STANdard Sets or returns the standard communication mask MASK:WFMDB:STATE Returns whether a waveform database is used as a source for mask counting 2-24 DSA8300 Programmer Manual...
Up to eight automated measurements can be displayed on the screen. In the commands, these eight measurement slots are named MEAS<x>, where <x> can be 1 through 8. You use the commands to do the following: DSA8300 Programmer Manual 2-25...
Page 42
Sets or returns whether the measurement shows annotations MEASUrement:LIST Sets or returns a list of defined measurements for which you want values returned MEASUrement:LISTValue? Returns the values of the measurements in the list created with the MEASUrement:LIST command 2-26 DSA8300 Programmer Manual...
Page 43
Sets or returns the direction (forward or EDGE:DIRection backward) that the instrument uses to look for the rising or falling edge MEASUrement:MEAS<x>:SOUrce<x>: Sets or returns the slope of the edges used EDGE:SLOPe in delay time measurements DSA8300 Programmer Manual 2-27...
Page 44
Returns the units for the specified measurement MEASUrement:MEAS<x>:VALue? Returns the measurement value for the specified measurement MEASUrement:STATIstics:ENABle Sets or returns whether or not measurement statistics are enabled (on or off) MEASUrement:STATIstics:WEIghting Sets or returns measurement statistics weighting for all measurements 2-28 DSA8300 Programmer Manual...
TIMe Sets or returns the time displayed by the instrument UNLock Unlocks the front panel Returns the front panel lock state VERBose Sets or returns the response header abbreviation control command DSA8300 Programmer Manual 2-29...
Command Description DELEte:WAVEform Deletes (one or all) of the stored reference waveforms from memory FACtory Resets the instrument to factory default settings 2-30 DSA8300 Programmer Manual...
Sets or returns the bits in the Service Request Enable Register *STB? Returns the contents of the Status Byte Register *WAI Prevents the instrument from executing further commands until all pending operations finish ALLEv? Returns all events BUSY? Returns instrument status DSA8300 Programmer Manual 2-31...
Where applicable, returns sampling module input impedance of the specified channel SYSTem:PROPerties:CH<x>:MODElnum? Returns sampling module model number per specified channel SYSTem:PROPerties:CH<x>:NONDestruct? Where applicable, returns sampling module lower and upper maximum nondestructive range of the specified channel 2-32 DSA8300 Programmer Manual...
Page 49
Returns mainframe option key SYSTem:PROPerties:MAInframe: Returns mainframe model number MODElnum? SYSTem:PROPerties:MAInframe: Returns mainframe serial number SERialnum? SYSTem:PROPerties:MAInframe: Returns mainframe software version number SWVersion? SYSTem:PROPerties:MAInframe: Returns mainframe id number UNIQueid? SYSTem:PROPerties:OFEHWver? Returns the Optical Front-End (OFE) board version number. DSA8300 Programmer Manual 2-33...
Sets the instrument to predefined differential TDR settings for the specified TDR channel pair TDR:EXT10MHZref:FREQ Sets or returns the external 10 MHz reference frequency used for TDR acquisitions TDR:CH<x>:PRESET Sets the instrument to predefined TDR settings for the specified TDR channel 2-34 DSA8300 Programmer Manual...
Sets or returns the TDR (Internal Clock) rate; same as TRIG:INTRATE Trigger Command Group You use the commands in the Trigger Command Group to control all aspects of triggering for the instrument. You use the commands to do the following: DSA8300 Programmer Manual 2-35...
Page 52
Set and query Pattern Autosync parameters (Pattern Length, Data Rate, Data to Clock Ratio). Initiate a Pattern Autosync. Control and Query USB-attached clock recovery instruments (such as the Tektronix CR125A, CR175A, or CR286A) Command Description AUTOSet:TRIGger Sets whether the trigger Autoset options are...
Page 53
Sets or queries the device name of the connected Clock Recovery instrument TRIGger:CLKRec:CRC:EDGEDensity? Returns the measured edge density (in percent) from the connected Clock Recovery instrument TRIGger:CLKRec:CRC: Sets or queries the edge density mode EDGEDENSITYMode setting of the connected Clock Recovery instrument DSA8300 Programmer Manual 2-37...
Page 54
Recovery instrument TRIGger:CLKRec:CRC:PHASEERRRMS? Returns the phase error RMS measurement from the connected Clock Recovery instrument TRIGger:CLKRec:CRC:RCONfigdevice Restores the connected Clock Recovery instrument to the settings from one of the non-volatile setup locations in the Clock Recovery Instrument 2-38 DSA8300 Programmer Manual...
Page 55
Sets or returns the noise rejection mode for Trigger Direct input triggering TRIGger:PSYNc:DATARate Sets or returns the data rate of the PatternSync portion of the trigger system TRIGger:PSYNc:DCRAtio Sets or returns the data:clock ratio of the PatternSync portion of the trigger system DSA8300 Programmer Manual 2-39...
Set the wavelength to match the wavelength of the optical signal you are using. Set the type of filtering, if any, you want performed on the selected optical channel. Specify bandwidth for use on the selected optical channel. 2-40 DSA8300 Programmer Manual...
Page 57
Sets or returns the reference vertical scale (per div) REF<x>:WFMLabel Sets or returns the label associated with the specified reference waveform SELect? Returns information on which waveforms are ON/OFF and which waveform is the selected waveform DSA8300 Programmer Manual 2-41...
Use waveform databases for measurements, histogram calculations and display, mask testing, and generating a density-style graded display. If a waveform database is turned on for the selected source, then the mask testing, histogram calculations, and measurements can use the waveform database. 2-42 DSA8300 Programmer Manual...
Page 59
WFMDB:WFMDB<x>:PERSistence:MODe Sets or returns the persistence mode (Infinite or Variable) used by WfmDB<x> WFMDB:WFMDB<x>:PERSistence: Returns the samples count in effect SAMPles? for WfmDB<x> when using in Variable Persistence mode WFMDB:WFMDB<x>:SOURce Sets or returns the WfmDB<x> source DSA8300 Programmer Manual 2-43...
FPBinary specifies floating-point data-point representation with the most significant byte transferred first. SFPBinary is the same as RFBinary except that the byte order is reversed; the least significant byte is transferred first. This format is useful when transferring data to IBM-compatible PCs. 2-44 DSA8300 Programmer Manual...
Page 61
WFMOutpre query commands are set by the previous curve query. Therefore, to have a valid set of preamble and data, you must perform a CURVe? query followed by a WFMOutpre? query. Refer to the individual WFMInpre and WFMOutpre commands for more information. DSA8300 Programmer Manual 2-45...
Page 62
WFMInpre:BYT_Nr? Returns the byte width of the waveform to be transferred to the instrument WFMInpre:BYT_Or Sets or returns which byte of binary waveform data is transmitted first during a waveform data transfer to the instrument 2-46 DSA8300 Programmer Manual...
Page 63
WFMOutpre:BN_Fmt Sets or returns the format of the binary data encoding of the waveform to be transferred from the instrument WFMOutpre:BYT_Nr? Returns the byte width for the waveform to be transferred from the instrument DSA8300 Programmer Manual 2-47...
Page 64
Returns vertical unit scale factor of the incoming waveform by the previous CURVe? command WFMOutpre:YUNit? Returns the vertical units of the waveform returned by the previous CURVe? command WFMOutpre:YZEro? Returns the vertical offset of the waveform returned by the previous CURVe? command 2-48 DSA8300 Programmer Manual...
StopAfter action is enabled. Group Acquisition Syntax ACQuire:CURRentcount:ACQWfms? Related Commands ACQuire:STOPAfter:COUNt, ACQuire:STOPAfter:CONDition Returns is the current count value of acquired waveforms. Examples might return ACQUIRE:CURRENTCOUNT:ACQWFMS? , indicating that currently 20 waveforms ACQUIRE:CURRENTCOUNT:ACQWFMS 20 have been acquired. DSA8300 Programmer Manual 2-49...
Page 66
When the count reaches (or exceeds) this value, acquisition stops, and the specified StopAfter action is performed. Group Acquisition Syntax ACQuire:CURRentcount:HISTWfms? Related Commands ACQuire:STOPAfter:COUNt ACQuire:STOPAfter:CONDition Returns is the current count value of histogram waveforms. 2-50 DSA8300 Programmer Manual...
Page 67
ACQuire:STOPAfter:COUNt command (in conjunction with the ACQuire:STOPAfter:CONDition command). The instrument then counts up to this value. When the count reaches (or exceeds) this value, acquisition stops, and the specified StopAfter action is performed. Group Acquisition Syntax ACQuire:CURRentcount:MASKSamples? DSA8300 Programmer Manual 2-51...
Page 68
The target value of this count is set by the ACQuire:STOPAfter:COUNt command (in conjunction with the ACQuire:STOPAfter:CONDition command). The instrument then counts up to this value. When the count reaches (or exceeds) this value, acquisition stops, and the specified StopAfter action is performed. 2-52 DSA8300 Programmer Manual...
Page 69
Counts. Resets all counts, including number of acquired waveforms, acquisition and math average counts, conditional stop counts, and FrameScan counts (if any of these are active). Measurement statistics. Measurement statistics are reset. DSA8300 Programmer Manual 2-53...
Page 70
Envelope. Use Envelope mode when it's important to see the variation of extremes in a waveform over time. Group Acquisition Syntax ACQuire:MODe { SAMple | AVERage | ENVElope } ACQuire:MODe? Related Commands ACQuire:NUMAVg 2-54 DSA8300 Programmer Manual...
Page 71
Average is checked for the Acquisition Mode. Use the ACQuire:MODe command to enable the Average mode. Group Acquisition Syntax ACQuire:NUMAVg <NR1> ACQuire:NUMAVg? Related Commands ACQuire:MODe Arguments is the number of consecutive waveform acquisitions (from 2 to 4,096) used for averaging. DSA8300 Programmer Manual 2-55...
Page 72
Wavetest.bmp (in the current directory) to which the screen will be saved after a StopAfter SAVEScreen condition is met. might return ACQUIRE:SAVEFILE:SAVESCREEN? , indicating that the ACQUIRE:SAVEFILE:SAVESCREEN "TESTFILE.BMP" screen will be saved in TESTFILE.BMP in the current directory when the StopAfter action is enabled. 2-56 DSA8300 Programmer Manual...
Page 73
files to C:\Users\<username>\TekScope\UI. might return ACQUIRE:SAVEFILE:SAVEWFM? ACQUIRE:SAVEFILE:SAVEWFM , indicating that the instrument will use the base file name DUT123 to "DUT123" save waveforms in the current directory when the StopAfter action is enabled. If DSA8300 Programmer Manual 2-57...
Page 74
ACQUIRE:STATE RUN might return , indicating that the ACQUIRE:STATE? ACQUIRE:STATE 1 acquisition system is running. NOTE. A query always returns a 0 or 1. ACQuire:STOPAfter? (Query Only) This query only command returns all StopAfter parameters. Group Acquisition 2-58 DSA8300 Programmer Manual...
Page 75
ACQUIRE:STOPAFTER:ACTION PRINTSCREEN bitmap image of the application to the printer when the stop after condition is met. might return ACQUIRE:STOPAFTER:ACTION? ACQUIRE:STOPAFTER:ACTION , indicating that no action is taken when the stop after condition is met. NONE DSA8300 Programmer Manual 2-59...
Page 76
NOTE. A query always returns a 0 or 1. NOTE. The DSA8300 does not have an internal speaker. To hear a "bell" on stop, connect a speaker to the audio Line Output jack on the back of the instrument. ACQuire:STOPAfter:CONDition This command sets or queries the StopAfter condition.
Page 77
Use the ACQuire:STOPAfter:COUNt command to set the target number of waveforms. sets the instrument to stop acquisition after a HISTWaveform specified number of Histogram source waveforms is acquired. Use the ACQuire:STOPAfter:COUNt command to set the specified number of waveforms. DSA8300 Programmer Manual 2-61...
Page 78
ACQUIRE:STOPAFTER:CONDITION? , indicating that the acquisition ACQuire:STOPAfter:CONDition MASK3HITS will be stopped after the hits in mask 3 are equal to or greater than the specified number of hits. 2-62 DSA8300 Programmer Manual...
Page 79
This command tells the instrument when to stop taking acquisitions. The query form of this command returns the StopAfter mode. This command is the equivalent of checking Run/Stop or Condition in the Stop After section of the DSA8300 Programmer Manual 2-63...
Page 80
For a complete discussion of the use of these registers, see the topics in Status and Events. This command is similar to repeatedly sending *EVMsg? queries to the instrument. Group Status and Error Syntax ALLEv? 2-64 DSA8300 Programmer Manual...
Page 81
Group Miscellaneous Syntax APPlication:ACTivate {"80SJNB" | "80SJARB" | "CRXXX Control" | "IConnect" | "IConnect and MeasureXtractor" | "IConnect and MeasureXtractor Evaluation" | "IConnect S-Parameters and Z-line" | "IConnect S-parameter Wizard" | “DiffChanAlign” } DSA8300 Programmer Manual 2-65...
Page 82
BERTScope Clock Recovery Instrument Control CRXXX Control software. This control software works with 80A07, CR125A, CR175A and CR286A clock recovery instruments connected to the DSA8300 via USB. is the optional IConnect® software for measurement-based IConnect performance evaluation of gigabit interconnect links and devices, including signal integrity analysis, impedance, S-parameter, and eye-diagram tests and fault isolation.
Page 83
EXECUTE Examples performs an autoset on the currently selected waveform. AUTOSET EXECUTE AUTOSet:HORizontal This command sets or queries whether an autoset should perform the horizontal autoset portion when Autoset is executed. DSA8300 Programmer Manual 2-67...
Page 84
TDR Autoset. If the Display Incident Edge is on, the incident edge is placed at the one-half horizontal division (from left edge). If the Display Incident Edge is off, the incident edge is placed one horizontal division off the left edge of the screen. 2-68 DSA8300 Programmer Manual...
Page 85
AUTOSet:TRIGger { ON | OFF | NR1 } AUTOSet:TRIGger? Related Commands AUTOSet Arguments enables the trigger AutoSet options. disables the trigger AutoSet options. set to 0 disables the trigger AutoSet options; any other value enables the trigger AutoSet options. DSA8300 Programmer Manual 2-69...
Page 86
MASK:AUTOSET command is unable to obtain autoset parameters from a user-defined mask standard. Group Miscellaneous Syntax AUTOSet:TYPE { EDGe | PERIod | EYE | RZ | TDR } AUTOSet:TYPE? Related Commands AUTOSet AUTOSet:TDR:INCident AUTOSet:VERTical AUTOSet:TRIGger AUTOSet:HORizontal 2-70 DSA8300 Programmer Manual...
Page 87
AUTOSet:UNDO (No Query Form) This command (no query form) returns the parameters changed by an AUTOSet command to their previous states. This command is invalidated the first time you modify any instrument state parameter. Group Miscellaneous Syntax AUTOSet:UNDO DSA8300 Programmer Manual 2-71...
Page 88
This is a query only command that returns the status of the instrument. This command allows you to synchronize the operation of the instrument with your application program. See Synchronization Methods for more detailed information. Group Status and Error 2-72 DSA8300 Programmer Manual...
Page 89
, indicating that the instrument is busy. BUSY? CALibrate:DATE:CH<x>? (Query Only) This query only command returns the date and time of the last calibration information update for the sampling module channel. Group Calibration Syntax CALibrate:DATE:CH<x>? DSA8300 Programmer Manual 2-73...
Page 90
, indicating that the DC Calibrator voltage is set to 0.5 V. 5.00000000000E-001 CALibrate:HOSTinfo:CH<x>? (Query Only) This query only command returns the mainframe channel, model number, and serial number in which the sampling module channel was located during the last calibration information update. 2-74 DSA8300 Programmer Manual...
Page 91
This is a query only command that returns the current calibration status for the sampling module channel. Group Calibration Syntax CALibrate:STATus:CH<x>? Returns May return PASS, DEFAULTS, or WARMUP. Examples might return CALIBRATE:STATUS:CH1? CALIBRATE:STATUS:CH1 PASS indicating that the calibration status of the sampling module in channel 1 is PASS. DSA8300 Programmer Manual 2-75...
Page 92
1.5 °C. CALibrate:TEMPerature:MAInframe? (Query Only) This is a query only command that returns the difference (in °C) between the current mainframe temperature and the temperature recorded at the last calibration information update. Group Calibration Syntax CALibrate:TEMPerature:MAInframe? 2-76 DSA8300 Programmer Manual...
Page 93
This command is for service personnel only. Refer to the calibration procedures in the Service Manual. Group Calibration Syntax CALibrate:UPDATEinfo:CH<x> Examples updates the nonvolatile memory of the module CALIBRATE:UPDATEINFO:CH1 occupying channel 1 with the latest calibration information. DSA8300 Programmer Manual 2-77...
Page 94
The optical modules have differing valid settings. Use the <>:LIST? query to determine the valid {Clock Recovery | Filter | Bandwidth | Wavelength} settings for your optical module. Features of currently installed optical modules can be viewed using the System Properties dialog. 2-78 DSA8300 Programmer Manual...
Page 95
The instrument automatically selects the bandwidth nearest to the input value. Examples sets the Channel 1 bandwidth to 20 GHz. CH1:BANDWIDTH:VALUE 2.0E+10 might return CH2:BANDWIDTH:VALUE? CH2:BANDWIDTH:VALUE , indicating that the bandwidth for Channel 2 is set 12.49999974400E+009 to 12.5 GHz. DSA8300 Programmer Manual 2-79...
Page 96
Sets or queries the delay time (in seconds) for the specified channel. Supported by the 80E07B, 80E08B, 80E09B, 80E10B, 80E11 and 80E11X1 modules. Group Vertical Syntax CH<x>:DELay:TIMe<NR3> CH<x>:DELay:TIMe? Related Commands CH<x>:DELay:UNIts? Arguments is the delay time for this channel, in seconds. 2-80 DSA8300 Programmer Manual...
Page 97
This multiple pass acquisition process applies to the acquisition of the channels within each active timebase. DSA8300 Programmer Manual 2-81...
Page 98
A query always returns a 0 or 1. CH<x>:EXTAtten:MODe This command sets or queries the external attenuation mode for the channel specified by x, which can be 1 through 8. Group Vertical Syntax CH<x>:EXTAtten:MODe { LINear | DB } CH<x>:EXTAtten:MODe? 2-82 DSA8300 Programmer Manual...
Page 99
TDR sources. External attenuation is set to 1 (linear) or 0 dB when you attach an external real-time accessory, such as a probe, to the selected channel. Group Vertical Syntax CH<x>:EXTAtten:VALue <NR3> CH<x>:EXTAtten:VALue? Related Commands CH<x>:EXTAtten:MODe DSA8300 Programmer Manual 2-83...
Page 100
If you select a filter that your sampling module does not support, you will receive Execution Error code 2508, with error message "Selected filter is not available". See Messages for general information on programming interface messages. 2-84 DSA8300 Programmer Manual...
Page 101
filter for the 11.095728 Gb/s bit rate, ENET11096 which is a forward error-correction rate for 10GbE (10.3125 Gb/s per IEEE 802.3ae-2002 standard). selects a reference-receiver filter for the 41.250 Gb/s bit rate, in ENET41250 accordance with the Ethernet 40GBASE-FR standard. DSA8300 Programmer Manual 2-85...
Page 102
ITU-T G.709 Recommendation. selects a reference-receiver filter for the 43.018414 Gb/s bit rate, in FEC43018 accordance with the ITU-T G.709 Draft Recommendation. enables the full power electrical output for optical modules. This FPELECOUT is not a filter. 2-86 DSA8300 Programmer Manual...
Page 103
Sonet/SDH OC-768/STM-256 standard. selects a reference-receiver filter for a 32.00 Gb/s bit rate. ORR32G selects a reference-receiver filter for the 27.95 Gb/s bit rate, in OTU27952 accordance with the Fibre Channel Optical OTU4 standard. DSA8300 Programmer Manual 2-87...
Page 104
(if attached), the external attenuation factor, the selected units (if TDR is active), and the scale. For more information on how offset ranges are determined, refer to the topic Vertical Offset in the online help for your instrument. Group Vertical Syntax CH<x>:OFFSet <NR3> CH<x>:OFFSet? 2-88 DSA8300 Programmer Manual...
Page 105
Channel 1 is 2 divisions below the center graticule. CH<x>:SCAle This command sets or queries the vertical scale of the channel specified by x, which can be 1 through 8. Sending this command is the equivalent to setting a DSA8300 Programmer Manual 2-89...
Page 106
This command sets or queries the units for the specified channel. The channel is specified by x, which can be 1 through 8. Sending this command is the equivalent to setting the Units control in the Channel section of the Vertical Setup dialog 2-90 DSA8300 Programmer Manual...
Page 107
, indicating that the vertical-axis CH1:UNITS? CH1:UNITS VOLT units for Channel 1 are set to volts. CH<x>:WFMLabel This command sets or queries the label associated with the channel waveform specified. Group Vertical Syntax CH<x>:WFMLabel <Qstring> CH<x>:WFMLabel? DSA8300 Programmer Manual 2-91...
Page 108
This command sets or queries the wavelength for the channel specified by x, which can be 1 through 16. Generally, only optical modules in slots CH1 or CH3 have filter selections. You can use the CH<x>:WLENgth:LIST? query to determine the available wavelengths. Group Vertical 2-92 DSA8300 Programmer Manual...
Page 109
*CLS can suppress a service request that is to be generated by an *OPC. This will happen if a hardcopy output or conditional acquisition operation is still being processed when the *CLS command is executed. Group Status and Error Syntax *CLS Related Commands DESE *ESE *ESR? DSA8300 Programmer Manual 2-93...
Page 110
Group Compensation Syntax COMPensate:ALLModules Related Commands COMPensate:SAVe:USER:ALLModules Examples performs the compensation routines on all installed COMPENSATE:ALLMODULES module channels. COMPensate:CH<x> (No Query Form) This command (no query form) compensates the module channel for DC variances. 2-94 DSA8300 Programmer Manual...
Page 111
For best results, ensure that the mainframe compensation is valid and leave trigger sources for the selected channel connected and active. Group Compensation Syntax COMPensate:DARKLev:CH<x> Examples performs the darklevel compensation on the optical COMPENSATE:DARKLEV:CH1 module occupying channel 1. DSA8300 Programmer Manual 2-95...
Page 112
50 Ω and all optical module inputs have dust covers installed before continuing. NOTE. Data from a successful compensation is not automatically saved into nonvolatile user storage. Use the COMPensate:SAVe commands if you want to retain the data in nonvolatile storage. Group Compensation 2-96 DSA8300 Programmer Manual...
Page 113
COMPensate:RECAll:FACTory:ALLModules (No Query Form) This command (no query form) recalls compensation data for all installed module channels from their respective nonvolatile factory memories into the current, in-use (that is, run-time) compensation memory. Group Compensation Syntax COMPensate:RECAll:FACTory:ALLModules Examples COMPENSATE:RECALL:FACTORY:ALLMODULES DSA8300 Programmer Manual 2-97...
Page 114
COMPensate:RECAll:USER:ALLModules (No Query Form) This command (no query form) recalls compensation data for all installed module channels from their respective nonvolatile user memories into the current, in-use (that is, run-time) compensation memory. Group Compensation Syntax COMPensate:RECAll:USER:ALLModules Examples COMPENSATE:RECALL:USER:ALLMODULES 2-98 DSA8300 Programmer Manual...
Page 115
For a more detailed message about the results of the last compensation execution, use the COMPensate:RESults:VERBose? query. Group Compensation Syntax COMPensate:RESults? Examples might return , indicating COMPENSATE:RESULTS? COMPENSATE:RESULTS Pass that the compensation was successful. DSA8300 Programmer Manual 2-99...
Page 116
This command (no query form) saves the volatile run-time compensation data for the module channel into the nonvolatile user memory of the module channel. The channel is specified by x, which can be 1 through 8. Group Compensation Syntax COMPensate:SAVe:USER:CH<x> Examples COMPENSATE:SAVE:USER:CH2 2-100 DSA8300 Programmer Manual...
Page 117
In either case, the instrument should be compensated again. COMPensate:STATus:MAInframe? (Query Only) This is a query only command that returns the current compensation status for the mainframe. Possible responses are DEFaults, WARMup, FAIL, PASS, and COMPReq. Group Compensation Syntax COMPensate:STATus:MAInframe? DSA8300 Programmer Manual 2-101...
Page 118
Group Compensation Syntax COMPensate:TEMPerature:MAInframe? Examples might return COMPENSATE:TEMPERATURE:MAINFRAME? COMPENSATE:TEMPERATURE:MAINFRAME 2.7 CURSor? This is a query only command that returns all of the current cursor settings. Group Cursor Syntax CURSor? 2-102 DSA8300 Programmer Manual...
Page 119
Index number values for common cursor colors Name Index number Black Blue 16711680 Aqua 16776960 Lime 65280 Fuchsia 16711935 Yellow 65535 White 16777215 Navy 8388608 Teal 8421376 32768 Green Purple 8388736 Maroon Olive 32896 8421504 Gray Silver 12632193 DSA8300 Programmer Manual 2-103...
Page 120
(and timebase) in the Source control for the Cursor 1 or Cursor 2 section of the Cursor Setup dialog box. If you do not set the timebase, the default is Main for both cursors. Group Cursor Syntax CURSor:CURSor<x>:SOUrce {CH<x> | MATH<x> | REF<x>}[,{MAIn | MAG1 | MAG2}] CURSor:CURSor<x>:SOUrce? 2-104 DSA8300 Programmer Manual...
Page 121
This command sets or queries cursor type. Cursors are attached to the selected waveform. Sending this command is equivalent to setting Function in the Cursor Setup dialog box. Group Cursor Syntax CURSor:FUNCtion { HBArs | OFF | VBArs | WAVEforms } CURSor:FUNCtion? Related Commands SELect:CONTROl DSA8300 Programmer Manual 2-105...
Page 122
This query only command returns the current settings for the horizontal bar cursors. Group Cursor Syntax CURSor:HBArs? Examples might return CURSOR:HBARS? CURSOR:HBARS:DELTA -4.01084010840E-003; POSITION1 2.01897018970E-003; POSITION2 -1.99186991870E-003 CURSor:HBArs:DELTa? (Query Only) This query only command returns the difference between the two horizontal bar cursors. Group Cursor Syntax CURSor:HBArs:DELTa? 2-106 DSA8300 Programmer Manual...
Page 123
The unselected cursor is displayed as a dashed line. This command is equivalent to clicking in the Position control box in the Cursor 1 or Cursor 2 section of the Cursor Setup dialog box. DSA8300 Programmer Manual 2-107...
Page 124
CURSOR:VBARS:DELTA 1.00601202405E-009; POSITION1 20.9968917836E-009; POSITION2 22.0029038076E-009 CURSor:VBArs:DELTa? (Query Only) This query only command returns the difference between the two vertical bar cursors. This corresponds to the Δt value in the Cursors readout. Group Cursor Syntax CURSor:VBArs:DELTa? 2-108 DSA8300 Programmer Manual...
Page 125
CURSOR:VBARS:POSITION1 , indicating that the cursor 1 vertical bar is at 17.49 ns 17.4929859719E-009 from the trigger point of the source waveform. CURSor:WAVeform? (Query Only) This query only command returns all of the waveform cursor parameters. DSA8300 Programmer Manual 2-109...
Page 126
The cursor is specified by x, which can be 1 or 2. This corresponds to the v1 or v2 (cursor 1 or cursor 2) cursor readout. Group Cursor Syntax CURSor:WAVeform:HPOS<x>? Examples might return CURSOR:WAVEFORM:HPOS1? CURSOR:WAVEFORM:HPOS2 , indicating that cursor 2 is at 247.3 mV with respect to ground 0.247344970703 on the source waveform. 2-110 DSA8300 Programmer Manual...
Page 127
This is equivalent to the waveform Δv readout value. Group Cursor Syntax CURSor:WAVeform:VDELTa? Examples might return CURSOR:WAVEFORM:VDELTA? CURSOR:WAVEFORM:VDELTA , indicating that the voltage between the waveform cursors is 1.06 mV. 1.06E-3 DSA8300 Programmer Manual 2-111...
Page 128
<yyy> = 500, then <x> = 3. <yyy> is the number of bytes to transfer including checksum. is the waveform data in ASCII format. The format for ASCII data is ascii <NR1>[,<NR1>...] where each <NR1> represents a data point. 2-112 DSA8300 Programmer Manual...
Page 129
DATa:STARt and DATa:STOP to match the current vertical bar SNAp cursor positions. Examples assigns the current position of the vertical bar cursors to DATA SNAP DATA:START and DATA:STOP. might return DATA? DATA:DESTINATION REF1;SOURCE CH3;ENCDG ASCII;START 1;STOP 500 DSA8300 Programmer Manual 2-113...
Page 130
floating point or signed integer, based on how the data is stored in the instrument. Group Waveform Transfer Syntax DATa:ENCdg { ASCIi | RIBinary | FPBinary | SRIbinary | SFPBinary } DATa:ENCdg? 2-114 DSA8300 Programmer Manual...
Page 131
To update these commands, you must send the CURVe? command. You may also set or query the timebase associated with the waveform data transferred from the instrument using the DATa:TIMebase command. Group Waveform Transfer Syntax DATa:SOUrce { CH<x> | MATH<x> | REF<x>} DATa:SOUrce? DSA8300 Programmer Manual 2-115...
Page 132
When DATa:STOP is less than DATa:STARt, the stop value will equal DATa:STARt + (DATa:STARt - DATa:STOP). For example, if DATa:STARt = 30 and DATa:STOP = 20, then the range of data points for the waveform transfer will equal 30 through 40. 2-116 DSA8300 Programmer Manual...
Page 133
30 through 40. Examples specifies that the waveform transfer will stop at data point DATA:STOP 4000 4000. might return , indicating that 500 is the last data DATA:STOP? DATA:STOP 500 point that will be transferred. DSA8300 Programmer Manual 2-117...
Page 134
, indicating that the DATA:TIMEBASE? DATA:TIMEBASE MAIN timebase for the source waveform data is set to main. DATE This command sets or queries the date that the instrument can display. Group Miscellaneous Syntax DATE <QString> DATE? 2-118 DSA8300 Programmer Manual...
Page 135
(REF1 through REF<x> REF8). specifies all the stored reference waveforms. Examples removes all the waveforms stored in reference memory. DELETE:WAVEFORM ALL removes the waveform stored at REF2. DELETE:WAVEFORM REF2 DSA8300 Programmer Manual 2-119...
Page 136
Status Byte Register. Use the *ESE command to set the ESER. Examples sets the DESER to binary 11010001, which enables the PON, URQ, DESE 209 EXE, and OPC bits. might return , indicating that the DESER contains the binary DESE? DESE 186 value 10111010. 2-120 DSA8300 Programmer Manual...
Page 137
Mask Cursor 1 Cursor 2 The following table lists values for common colors. Index number values for common cursor colors Name Index number Black Blue 16711680 Aqua 16776960 Lime 65280 Fuchsia 16711935 Yellow 65535 White 16777215 DSA8300 Programmer Manual 2-121...
Page 138
(red, green, and blue). You specify the value for each of the three color values and sum them to specify the background color. The following table lists values for common colors. Index number values for common colors Name Index number Black Blue 16711680 Aqua 16776960 Lime 65280 Fuchsia 16711935 Yellow 65535 2-122 DSA8300 Programmer Manual...
Page 139
1 or 2. This is equivalent to setting Color in the Cursor 1 or Cursor 2 section of the Cursor Setup dialog box. The default cursor color is red. The following table lists values for common colors. Index number values for common cursor colors Name Index number Black Blue 16711680 Aqua 16776960 DSA8300 Programmer Manual 2-123...
Page 140
This command sets or queries the color of the graticule foreground, which is the color of the graticule itself. This is equivalent to setting the Foreground color in the Graticule section of the Display Setup dialog box. The default foreground color is silver. 2-124 DSA8300 Programmer Manual...
Page 141
+ 256 × green + 65536 × blue where red, green and blue are values between 0 and 255. Examples sets the color of the foreground (graticule) DISPLAY:COLOR:FOREGROUND 255 to red. might return DISPLAY:COLOR:FOREGROUND? DISPLAY:COLOR:FOREGROUND , indicating that the color of the foreground (graticule) is white. 16777215 DSA8300 Programmer Manual 2-125...
Page 142
0 through 16777215 representing a color defined as follows: red + 256 × green + 65536 × blue where red, green and blue are values between 0 and 255. 2-126 DSA8300 Programmer Manual...
Page 143
Index number Black Blue 16711680 Aqua 16776960 Lime 65280 Fuchsia 16711935 Yellow 65535 White 16777215 Navy 8388608 Teal 8421376 Green 32768 Purple 8388736 Maroon Olive 32896 Gray 8421504 Silver 12632193 Group Display Control Syntax DISplay:COLor:MASK <NR1> DISplay:COLor:MASK? DSA8300 Programmer Manual 2-127...
Page 144
A query always returns a 0 or 1. DISplay:DATe This command sets or queries state of the Date/Time display. This is equivalent to toggling the Date/Time display on or off from the View menu. Group Display Control 2-128 DSA8300 Programmer Manual...
Page 145
DISplay:GRAticule:HDIVS? (Query Only) This query only command returns the number of horizontal divisions in the graticule. Group Display Control Syntax DISplay:GRAticule:HDIVS? Examples might return DISPLAY:GRATICULE:HDIVS? DISPLAY:GRATICULE:HDIVS 10 indicating that the graticule display is 10 horizontal divisions wide. DSA8300 Programmer Manual 2-129...
Page 146
10 vertical divisions high. DISplay:HISTReadout This command sets or queries state of the Histogram readout. This is equivalent to checking or clearing the Histogram readout item in the readout selection menu. 2-130 DSA8300 Programmer Manual...
Page 147
You can set interpolation display algorithms to None, Linear, or Sin (x)/x. Group Display Control Syntax DISplay:INTERPolat { LINear | NONe | SINX } DISplay:INTERPolat? Related Commands DISplay:STYle DSA8300 Programmer Manual 2-131...
Page 148
0 disables the Mask readout display; any other integer enables the Mask readout display. Examples enables the Mask readout display. DISPLAY:MASKREADOUT 1 might return , indicating DISPLAY:MASKREADOUT? DISPLAY:MASKREADOUT 0 that the Mask readout display is off. NOTE. A query always returns a 0 or 1. 2-132 DSA8300 Programmer Manual...
Page 149
DISplay:MEASReadout { ON | OFF | NR1 } DISplay:MEASReadout? Arguments enables the readout display for the Measurement function. disables the readout display for the Measurement function. set to 0 disables the Measurement readout display; any other integer enables the Measurement readout display. DSA8300 Programmer Manual 2-133...
Page 150
This is equivalent to selecting or clearing the Show Vectors check box in the Style section of the Display Setup dialog box. Group Display Control Syntax DISplay:SHOWVector { ON | OFF | NR1 } DISplay:SHOWVector? 2-134 DSA8300 Programmer Manual...
Page 151
VARPersist specified by the DISplay:PERSistence command. Examples sets the display to indefinitely accumulate data DISPLAY:STYLE INFPERSIST points on the screen. DSA8300 Programmer Manual 2-135...
Page 152
The ESER prevents events from being reported to the Status Byte Register (SBR). For a more detailed discussion of the use of these registers, see Registers. Group Status and Error Syntax *ESE <NR1> *ESE? Related Commands *CLS DESE 2-136 DSA8300 Programmer Manual...
Status Register (SESR). This query also clears the SESR, since reading the SESR clears it. For a more detailed discussion of the use of these registers, see Registers. Group Status and Error Syntax *ESR? Related Commands ALLEv? *CLS DESE *ESE EVENT? DSA8300 Programmer Manual 2-137...
Page 154
This is a query only command that removes a single event code from the Event Queue that is associated with the results of the last *ESR? read and returns the event code along with an explanatory message. For more information, see Event Handling for more information. 2-138 DSA8300 Programmer Manual...
Page 155
This query only command returns the number of event codes that are in the Event Queue. This is useful when using the ALLEv? query, since it lets you know exactly how many events will be returned. Group Status and Error Syntax EVQty? DSA8300 Programmer Manual 2-139...
Page 156
The <file path> is a quoted string that defines the file name and path. Input the file path using the form <drive>/<dir>/<filename>. The <filename> can be a Windows long file name. Do not use wild card characters. Examples exports the REF2 EXPORT REF2,"C:MY DOCUMENTS\DSA8300\MAINR2.TXT" waveform data to the specified file. 2-140 DSA8300 Programmer Manual...
Page 157
Sets the Device Event Status Enable Register to 255 Sets the Power On Status Clear Flag to TRUE Enables all Command Headers (HEADer ON) Clears the pending operation flag and associated operations Clears all references from the reference slots DSA8300 Programmer Manual 2-141...
Page 158
file name and path. Input the file FILE PATH path using the form "<drive>\dir\filename". The <filename> can be a Windows long file name. Do not use wild card characters. Examples "c:\My Documents\TekScope\PI\test.txt" FILESYSTEM:READFILE? 2-142 DSA8300 Programmer Manual...
Page 159
If the file you specify doesn't exist, sending this command creates it. If the file does exist, sending this command overwrites its contents. The image-file format that your hardcopy will have depends on whether you include a file extension when you specify the file path: DSA8300 Programmer Manual 2-143...
Page 160
filename extension included in the command argument. HARDCopy:FORMat (No Query Form) This command selects the image-file format used with the hardcopy commands. Several image file formats are provided to support compatibility with image-processing applications and efficient utilization of disk capacity. 2-144 DSA8300 Programmer Manual...
Page 161
file using the HARDCopy:FILEName command. Group Hardcopy Syntax HARDCopy:INKSaver { ON | OFF | NR1 } Related Commands HARDCopy DSA8300 Programmer Manual 2-145...
Page 162
0 sets the Response Header Enable State to false, which disables the headers; any other integer sets the Response Header Enable State to true, which enables the headers. (A query always returns a 0 or 1.) 2-146 DSA8300 Programmer Manual...
Page 163
This is equivalent to setting the Limit Controls for Left, Top, Right, and Bottom in the Histogram Setup dialog box. This command is similar to the HIStogram:BOXPcnt command, which uses percentage coordinates to define the boundaries of the histogram box. Group Histogram DSA8300 Programmer Manual 2-147...
Page 164
100, 100. Any value outside the range of 0 to 100 is clipped and generates an error. This command is similar to the HIStogram:BOX command, which uses waveform coordinates to define the boundaries of the histogram box. Group Histogram Syntax HIStogram:BOXPcnt <NR3>,<NR3>,<NR3>,<NR3> HIStogram:BOXPcnt? Related Commands HIStogram:BOX 2-148 DSA8300 Programmer Manual...
Page 165
The following table lists values for common colors. Index number values for common colors Name Index number Black Blue 16711680 Aqua 16776960 Lime 65280 Fuchsia 16711935 Yellow 65535 White 16777215 Navy 8388608 Teal 8421376 Green 32768 Purple 8388736 DSA8300 Programmer Manual 2-149...
Page 166
Clear in the Source section of the Histogram Setup dialog box. There is no query form of this command. Group Histogram Syntax HIStogram:COUNt {RESET} Examples clears the count and statistics for the histogram and HISTOGRAM:COUNT RESET the histogram source data. 2-150 DSA8300 Programmer Manual...
Page 167
Histogram Setup dialog box. Sending this command will cause the histogram statistics to be displayed (but not the histogram). Use the HIStogram:DISplay command to control whether the histogram is displayed on screen. Group Histogram Syntax HIStogram:ENABle { ON | OFF | NR1 } HIStogram:ENABle? DSA8300 Programmer Manual 2-151...
Page 168
This command sets or queries the width or height in divisions of the histogram plot on the screen. This is equivalent to setting Size in the Display Options section of the Histogram Setup dialog box. Group Histogram 2-152 DSA8300 Programmer Manual...
Page 169
1 through 8. (optional) selects Main as the timebase for the histogram display. MAIn (optional) selects MAG1 as the timebase for the histogram display. MAG1 (optional) selects MAG2 as the timebase for the histogram display. MAG2 DSA8300 Programmer Manual 2-153...
Page 170
The histogram statistics (and count) can be reset with the HIStogram:COUNt command. Group Histogram Syntax HIStogram:STATistics? Related Commands HIStogram:COUNt Examples might return the following: HISTOGRAM:STATISTICS? HISTOGRAM:STATISTICS:MEAN 43.0000000000E–009;MEDIAN 43.0000000000E–009;STDDEV 5.80230431544E–009;PKTOPK 20.0000000000E–009;SIGMA1 58.7064;SIGMA2 58.7064;SIGMA3 100.0000; PEAKHITS 2.43800000000E+003;HITS 490.038000000E+003; WAVEFORMS 2.43800000000E+003 2-154 DSA8300 Programmer Manual...
Page 171
This is the value that is displayed for Median in the Histogram readout. Group Histogram Syntax HIStogram:STATistics:MEDIAN? Examples might return HISTOGRAM:STATISTICS:MEDIAN? , indicating that the HISTOGRAM:STATISTICS:MEDIAN 43.0000000000E–009 median value for the horizontal histogram is 43 ns. DSA8300 Programmer Manual 2-155...
Page 172
µ±1s, µ±2s, or µ±3s in the Histogram readout. Group Histogram Syntax HIStogram:STATistics:SIGMA<x>? Arguments (1, 2, or 3) is the value indicating a query for the sigma1, sigma2, or sigma3 <x> value. 2-156 DSA8300 Programmer Manual...
Page 173
2081 waveforms were used to create the histogram. HIStogram:TYPE This command sets or queries whether the histogram is displayed linearly or logarithmically. This is equivalent to selecting Linear or Logarithmic in the Display Options section of the Histogram Setup dialog box. Group Histogram DSA8300 Programmer Manual 2-157...
Page 174
0 disables the histogram counting on a waveform database; any other value enables histogram counting on a waveform database. Examples enables histogram counting on a waveform HISTOGRAM:WFMDB:STATE ON database. might return HISTOGRAM:WFMDB:STATE? HISTOGRAM:WFMDB:STATE 0 indicating that the histogram counting on a waveform database is disabled. 2-158 DSA8300 Programmer Manual...
Page 175
Horizontal Setup dialog box. This value is used to convert horizontal scales from seconds to bits. If a communications standard is set by the HORizontal:BITS:STANdard command, the bit rate is coerced to the bit rate for the specified standard. Group Horizontal Syntax HORizontal:BITS:BITRate <NR3> HORizontal:BITS:BITRate? DSA8300 Programmer Manual 2-159...
Page 177
11.095728 Gb/s bit rate, which is a forward ENET11096 error-correction rate for 10GbE (10.3125 Gb/s per IEEE 802.3ae-2002), and mask. selects the 41.2500 Gb/s bit rate and mask in accordance with ENET41250 the Ethernet 40GBASE-FR standard. DSA8300 Programmer Manual 2-161...
Page 178
4.25 Gb/s bit rate and mask, in accordance with FC4250E_ABT FIBRE CHANNEL PHYSICAL INTERFACES (FC-PI-2), Rev 3.0 9/13/02 Abs, Beta, Transm. selects the 4.25 Gb/s bit rate and mask, in accordance with FC4250E_AGR FIBRE CHANNEL PHYSICAL INTERFACES (FC-PI-2), Rev 3.0 9/13/02, Abs, Gamma, Recv. 2-162 DSA8300 Programmer Manual...
Page 179
ITU-T G.709 Draft Recommendation. selects the 42.6569 Gb/s bit rate and mask, in accordance with FEC42657 the ITU-T G.975 Recommendation. selects the 43.018414 Gb/s bit rate and mask, in accordance with FEC43018 the ITU-T G.709 Draft Recommendation. DSA8300 Programmer Manual 2-163...
Page 180
2.5 Gb/s bit rate and mask, in accordance with the RIO_SERIAL2G Rapid IO Serial, 2.5 Gb/s standard. selects the 3.25 Gb/s bit rate and mask, in accordance with RIO_SERIAL3G the Rapid IO Serial, 3.25 Gb/s standard. 2-164 DSA8300 Programmer Manual...
Page 181
This is the legacy behavior. sets the horizontal scale controls and readouts to display the time span PERScreen of the entire graticule (10 divisions). This is the default setting for this command. DSA8300 Programmer Manual 2-165...
Page 182
DISTANCE. HORizontal:DISPlayscale:SEConds This commands sets or queries the display scale mode when horizontal units are set to SEConds. Group Horizontal 2-166 DSA8300 Programmer Manual...
Page 183
Propagation velocity (Vp) is related to the dielectric constant (e) by the following equation: where c is the speed of light in a vacuum. Setting the dielectric constant will cause the propagation velocity to be set as appropriate. Group Horizontal Syntax HORizontal:DISTance:DIELectric <NR3> HORizontal:DISTance:DIELectric? DSA8300 Programmer Manual 2-167...
Page 184
Setting the propagation velocity will cause the dielectric constant to be set as appropriate. Group Horizontal Syntax HORizontal:DISTance:PVELocity <NR3> HORizontal:DISTance:PVELocity? Related Commands HORizontal:UNIts HORizontal:DISTance:DIELectric Arguments is the propagation velocity of the material being tested, in meters per second. 2-168 DSA8300 Programmer Manual...
Page 185
This command (no query form) resets and restarts the FrameScan acquisition. Sending this command is equivalent to clicking the Reset button in the FrameScan section of the Pattern Sync/FrameScan dialog box. Group Horizontal Syntax HORizontal:FRAMescan:RESET Examples resets and restarts the FrameScan acquisition. HORIZONTAL:FRAMESCAN:RESET DSA8300 Programmer Manual 2-169...
Page 186
FrameScan mode superior to traditional methods of analyzing pattern-dependent failures in high bit rate communications signals. Refer to the online help for this instrument for additional information about FrameScan. Group Horizontal 2-170 DSA8300 Programmer Manual...
Page 187
The Mag timebase is specified by x, which can be 1 or 2. Sending this command is equivalent to selecting a Mag timebase and entering a value in the Position control in the Timebase section of the Horizontal Setup dialog box or adjusting the front-panel Horizontal position control. DSA8300 Programmer Manual 2-171...
Page 188
The position of the Mag timebase is constrained to be in the domain of the Main timebase. Changing the Main timebase position can affect the position of each Mag timebase, but a Mag timebase position cannot affect the Main timebase position. Group Horizontal Syntax HORizontal:MAGnify<x>:POSition <NR3> HORizontal:MAGnify<x>:POSition? 2-172 DSA8300 Programmer Manual...
Page 189
HORizontal:MAGnify<x>:RECordlength? Related Commands HORizontal:MAGnify<x>:SCAle HORizontal:MAGnify<x>:RESolution? Arguments is the record length. Valid record lengths are 50, 100, 250, 500, 1000, 2000, and 4000 samples. Examples sets the Mag 2 timebase record HORIZONTAL:MAG2:RECORDLENGTH 1000 length to 1000 samples. DSA8300 Programmer Manual 2-173...
Page 190
Mag view. Refer to the illustration below for a diagram of the relationships of horizontal reference point, time of first point, time of last point, and horizontal position. Group Horizontal Syntax HORizontal:MAGnify<x>:REFPoint <NR2> HORizontal:MAGnify<x>:REFPoint? Related Commands HORizontal:MAGnify<x>:SCAle 2-174 DSA8300 Programmer Manual...
Page 191
The Mag timebase is specified by x, which can be 1 or 2. Sending this command is equivalent to selecting a Mag timebase and adjusting the Scale control in the Timebase section of the Horizontal Setup dialog box (or adjusting the Horizontal SCALE front-panel knob). DSA8300 Programmer Manual 2-175...
Page 192
Mag timebase record (waveform). The Mag timebase is specified by x, which can be 1 or 2. Refer to the illustration below for a diagram of the relationships of time of first point, time of last point, horizontal position, and horizontal reference point. 2-176 DSA8300 Programmer Manual...
Page 193
Mag timebase record (waveform). Refer to the illustration below for a diagram of the relationships of time of last point, time of first point, horizontal position, and horizontal reference point. DSA8300 Programmer Manual 2-177...
Page 194
Mag1 or Mag2 icon in the timebase selector drop down box located below the graticule area of the display, or pressing the equivalent VIEW buttons on the front panel. Group Horizontal Syntax HORizontal:MAGnify<x>:VIEW { ON | OFF | NR1 } HORizontal:MAGnify<x>:VIEW? 2-178 DSA8300 Programmer Manual...
Page 195
BITS. The equivalent position in time can be computed as time = (bits / bit rate) + insertion delay. The bit rate is the rate specified by the HORIZONTAL:BITS:BITRATE command. Group Horizontal Syntax HORizontal:MAIn:BITS:POSition NR3 HORizontal:MAIn:BITS:POSition? DSA8300 Programmer Manual 2-179...
Page 196
This command sets or queries the horizontal position for the Main timebase. Sending this command is equivalent to selecting MainTB and entering a value in the Position control in the Timebase section of the Horizontal Setup dialog box or adjusting the front-panel Horizontal position control. 2-180 DSA8300 Programmer Manual...
Page 197
Mag timebase positions cannot affect the main timebase position. Refer to the illustration below for a diagram of the relationships of horizontal position, horizontal reference point, time of first point, and time of last point. Group Horizontal Syntax HORizontal:MAIn:POSition <NR3> HORizontal:MAIn:POSition? DSA8300 Programmer Manual 2-181...
Page 198
4000, 8000, and 16000 samples. Examples sets the record length for the Main HORIZONTAL:MAIN:RECORDLENGTH 500 timebase to 500 samples. might return HORIZONTAL:MAIN:RECORDLENGTH ? , indicating that the record length for HORIZONTAL:MAIN:RECORDLENGTH 1000 the Main timebase is set to 1000 samples. 2-182 DSA8300 Programmer Manual...
Page 199
Arguments is the fraction of the record at which the horizontal reference point is set. The range is 0 through 1 (corresponding to 0% through 100% of record); the default is 0.5. The resolution is 0.01. DSA8300 Programmer Manual 2-183...
Page 200
Timebase section of the Horizontal Setup dialog box. The horizontal scale that you set with this command is common to all channel waveforms using the Main timebase. The horizontal scale, together with the record length setting, determines the sample interval. Group Horizontal 2-184 DSA8300 Programmer Manual...
Page 201
first point in a Main timebase record (waveform). Refer to the illustration below for a diagram of the relationships of time of first point, time of last point, horizontal position, and horizontal reference point. Group Horizontal DSA8300 Programmer Manual 2-185...
Page 202
Main timebase record (waveform). Refer to the illustration below for a diagram of the relationships of time of last point, time of first point, horizontal position, and horizontal reference point. Group Horizontal Syntax HORizontal:MAIn:TOLPoint? 2-186 DSA8300 Programmer Manual...
Page 203
Group Horizontal Syntax HORizontal:MATH<x>:MAGnify<x>:RECordlength? Related Commands HORizontal:MATH<x>:MAGnify<x>:SCAle? HORizontal:MATH<x>:MAGnify<x>:RESolution? Examples might return HORIZONTAL:MATH5:MAG2:RECORDLENGTH? , indicating HORIZONTAL:MATH5:MAGNIFY2:RECORDLENGTH 1000 that the record length of the Mag 2 timebase is set to 1000 samples for the Math 5 waveform. DSA8300 Programmer Manual 2-187...
Page 204
1 through 8; the Mag timebase is specified by x, which can be 1 or 2. Resolution is always displayed in time units. Group Horizontal Syntax HORizontal:MATH<x>:MAGnify<x>:RESolution? Related Commands HORizontal:MATH<x>:MAGnify<x>:SCAle? HORizontal:MATH<x>:MAGnify<x>:RECordlength? Examples might return HORIZONTAL:MATH1:MAG1:RESOLUTION? HORIZONTAL:MATH1:MAGNIFY1:RESOLUTION 1.00000000000E–009 2-188 DSA8300 Programmer Manual...
Page 205
1 through 8; the Mag timebase is specified by x, which can be 1 or 2. The time of first point is the time interval between the trigger point and the first point in the specified Mag timebase record (waveform). Group Horizontal Syntax HORizontal:MATH<x>:MAGnify<x>:TOFPoint? Related Commands HORizontal:MATH<x>:MAGnify<x>:POSition? DSA8300 Programmer Manual 2-189...
Page 206
HORizontal:MATH<x>:MAIn:POSition? (Query Only) This query only command returns the horizontal position of the specified math waveform using the Main timebase. The math waveform is specified by x, which can be 1 through 8. Group Horizontal Syntax HORizontal:MATH<x>:MAIn:POSition? 2-190 DSA8300 Programmer Manual...
Page 207
HORizontal:MAIn:SCAle command contracts or expands the waveform, which affects the acquired and observable horizontal window of data. The horizontal reference position is set as a fraction of the record; 0.5 (50% of the record) is the default. DSA8300 Programmer Manual 2-191...
Page 208
This query only command returns the scale (time per division) of the Main timebase for the specified math waveform. The math waveform is specified by x, which can be 1 through 8. Group Horizontal Syntax HORizontal:MATH<x>:MAIn:SCAle? 2-192 DSA8300 Programmer Manual...
Page 209
The math waveform is specified by x, which can be 1 through 8. Group Horizontal Syntax HORizontal:MATH<x>:MAIn:TOLPoint? DSA8300 Programmer Manual 2-193...
Page 210
1 through 8, using the specified Mag timebase (1 or 2). The value of the record length can be 50, 100, 250, 500, 1000, 2000, and 4000 samples. Group Horizontal Syntax HORizontal:REF<x>:MAGnify<x>:RECordlength? 2-194 DSA8300 Programmer Manual...
Page 211
Reference waveform. The Reference waveform is specified by x, which can be 1 through 8; the Mag timebase is specified by x, which can be 1 or 2. Resolution is always displayed in time units. Group Horizontal Syntax HORizontal:REF<x>:MAGnify<x>:RESolution? DSA8300 Programmer Manual 2-195...
Page 212
1 through 8; the Mag timebase is specified by x, which can be 1 or 2. The time of first point is the time interval between the trigger point and the first point in the specified Mag timebase record (waveform). Group Horizontal Syntax HORizontal:REF<x>:MAGnify<x>:TOFPoint? 2-196 DSA8300 Programmer Manual...
Page 213
HORizontal:REF<x>:MAIn:POSition? (Query Only) This query only command returns the horizontal position of the specified reference waveform using the Main timebase. The reference waveform is specified by x, which can be 1 through 8. Group Horizontal Syntax HORizontal:REF<x>:MAIn:POSition? DSA8300 Programmer Manual 2-197...
Page 214
HORizontal:REF<x>:MAIn:REFPoint? (Query Only) This query only command returns the horizontal reference point of the specified reference waveform using the Main timebase. The reference waveform is specified by x, which can be 1 through 8. Group Horizontal Syntax HORizontal:REF<x>:MAIn:REFPoint? 2-198 DSA8300 Programmer Manual...
Page 215
1 through 8. The horizontal scale that is returned with this command is unique to the specified reference waveform. The horizontal scale, together with the record length value, determines the sample interval. Group Horizontal DSA8300 Programmer Manual 2-199...
Page 216
This query only command returns time of last point of the specified reference record (waveform) using the Main timebase. The time of last point is the time interval between the trigger point and the last point in the specified Reference Main timebase record. Group Horizontal 2-200 DSA8300 Programmer Manual...
Page 217
Examples sets the horizontal units for all timebases to seconds. HORIZONTAL:UNITS S might return , indicating that HORIZONTAL:UNITS? HORIZONTAL:UNITS BITS horizontal units for all timebases is set to bits. DSA8300 Programmer Manual 2-201...
Page 218
Group Miscellaneous Syntax *IDN? Related Commands Returns The instrument ID in the following format: TEKTRONIX,<model number>,0,CF:92.1CT FV <firmware version number> Examples might return *IDN? TEKTRONIX,DSA8300,B010112,CF:91.1CT FV:5.5.214 IMPort CUSTommask (No Query Form) This command imports and loads the custom mask from the specified file path.
Page 219
If the instrument is in the Remote With Lockout State (RWLS), the LOCk NONe command has no effect. For more information, see the ANSI/IEEE Std. 488.1-1987 Standard Digital Interface for Programmable Instrumentation, section 2.8.3 on RL State Descriptions. disables the touchscreen. TOUCH disables the front-panel controls. FPAnel DSA8300 Programmer Manual 2-203...
Page 220
ONCE; COUNT 1; :DIAG:STATE HALT; :HEADER 1;:VERBOSE 1; CURSOR:FUNCTION OFF; VBARS:UNITS SECONDS; POSITION1 1.00E–6; POSITION2 9.00E–6; SELECT CURSOR1 MASK? (Query Only) This query only command returns the status of all settable mask parameters. Group Mask Syntax MASK? 2-204 DSA8300 Programmer Manual...
Page 221
For absolute masks, the mask is adjusted vertically so that the mask high and low positions are based on the vertical scale, offset and position of the mask source waveform. Running a mask autofit turns off mask margin (if it is on) but does not change the percentage value. DSA8300 Programmer Manual 2-205...
Page 222
Low value used when aligning the input signal to NRZ eye masks. The method set will be used when Autoset executes on a mask source (that is, when a mask source is the currently selected waveform). The query form of this command returns the current method set for Mask Autoset. 2-206 DSA8300 Programmer Manual...
Page 223
This command sets or queries whether or not a mask autoset will automatically be done after a standard mask is selected. This is equivalent to selecting Automatic or Manual in the Autoset section of the Mask Setup dialog box. Group Mask Syntax MASK:AUTOSet:MODe {AUTO | MANual} MASK:AUTOSet:MODe? DSA8300 Programmer Manual 2-207...
Page 224
The following table lists values for common colors. Index number values for common colors Name Index number Black Blue 16711680 Aqua 16776960 Lime 65280 Fuchsia 16711935 Yellow 65535 White 16777215 Navy 8388608 Teal 8421376 2-208 DSA8300 Programmer Manual...
Page 225
Mask Setup dialog box. The query form of this command returns all the values for the mask count parameters. Group Mask Syntax MASK:COUNt {RESET} MASK:COUNt? Examples clears the counts for the masks, clears the data source, MASK:COUNT RESET and restarts the counting. DSA8300 Programmer Manual 2-209...
Page 226
0 turns off mask counting; any other integer turns on mask counting. Examples turns on mask counting. MASK:COUNT:STATE ON might return , indicating that MASK:COUNT:STATE? MASK:COUNT:STATE 0 mask counting is turned off. NOTE. A query always returns a 0 or 1. 2-210 DSA8300 Programmer Manual...
Page 227
This command sets or queries whether or not defined masks are displayed on the screen. This is useful for temporarily turning off user-defined masks without deleting them. This is equivalent to checking or clearing the Display Mask control in the Options section of the Mask Setup dialog box. DSA8300 Programmer Manual 2-211...
Page 228
Setting a negative mask margin percentage shrinks the polygon sizes and the mask test will be easier to pass due to the smaller area. Group Mask Syntax MASK:MARgin:PERCent <NR3> MASK:MARgin:PERCent? Arguments value is -90.0 to +100.0. The default is 5. 2-212 DSA8300 Programmer Manual...
Page 229
This command deletes all points in the mask specified by x, which can be 1 through 8. The query form of this command returns all the parameters for the specified mask. Group Mask Syntax MASK:MASK<x> {DELEte} MASK:MASK<x>? DSA8300 Programmer Manual 2-213...
Page 230
This query only command returns the number of points (vertices) in the specified mask. The mask is specified by <x>, which can be 1 through 8. One use of this query is to see how many pairs a MASK:MASK<x>:POINTSPcnt or MASK:MASK<x>POInts command will return. Group Mask 2-214 DSA8300 Programmer Manual...
Page 231
The default is no points in the mask. Examples MASK:MASK7:POINTS -2.3E-9,44E-3,-2.5E-9,47E-3,1.2E-9,40E-3 defines the points in Mask 7. might return MASK:MASK3:POINTS? MASK:MASK3:POINTS 1.97664729029E-008, -5.00000000000E-001, DSA8300 Programmer Manual 2-215...
Page 232
This command can optionally set the timebase of the source. This is equivalent to selecting a waveform (and timebase) in the Source section of the Mask Setup dialog box. If you do not specify the timebase, the default is Main. 2-216 DSA8300 Programmer Manual...
Page 233
This command selects a set of predefined mask polygons (hereafter referred to as a “mask”) to be used for mask testing in accordance with the communications standard specified by the command argument. The query form of this command returns the current mask. Note the following usage rules: DSA8300 Programmer Manual 2-217...
Page 235
ENET3125 IEEE 802.3ae-2002 standard. selects the 9.95328 Gb/s bit rate and mask, in accordance with the ENET9953 IEEE 802.3ae-2002 standard. selects the 10.3125 Gb/s bit rate and mask, in accordance with ENET10313 the IEEE 802.3ae-2002 standard. DSA8300 Programmer Manual 2-219...
Page 236
2.125 Gb/s bit rate and mask, in accordance with FC2125E_ABT ANS1 X3.230-1999 NCITS 1235D/Rev 11, Abs, Beta, Transm. selects the 2.125 Gb/s bit rate and mask, in accordance with FC2125E_AGR ANS1 X3.230-1999 NCITS 1235D/Rev 11, Abs, Gamma, Recv. 2-220 DSA8300 Programmer Manual...
Page 237
8.5 Gb/s bit rate and mask, in accordance with FC8GFCDREV6 Fibre Channel Physical Interfaces FC-PI-4, REV 6.00. selects the 10.51875 Gb/s bit rate and mask, in accordance with the FC10519 Fibre Channel Optical 10GFC standard. DSA8300 Programmer Manual 2-221...
Page 238
OC18 Sonet/SDH OC-18/STM-6 standard. selects the 1.24416 Gb/s bit rate and mask, in accordance with the OC24 Sonet/SDH OC-24/STM-8 standard. selects the 1.86624 Gb/s bit rate and mask, in accordance with the OC36 Sonet/SDH OC-36/STM-12 standard. 2-222 DSA8300 Programmer Manual...
Page 239
3.1250 Gb/s near-end normalized bit rate and mask, in XAUINear accordance with the IEEE 802.3ae-2002 standard. selects the 3.1250 Gb/s near-end relative bit rate and mask, in XAUIRNear accordance with the IEEE 802.3ae-2002 standard. DSA8300 Programmer Manual 2-223...
Page 240
A query always returns a 0 or 1. MATH<x>? (Query Only) This is a query only command that returns the settings for the math waveform specified by <x>, which can be 1 through 8. Group Math Syntax MATH<x>? 2-224 DSA8300 Programmer Manual...
Page 241
QString Examples adds the Channel 1 waveform and Channel 2 MATH2:DEFINE "C1+C2" waveform, and stores the result in Math 2. might return as the expression that MATH1:DEFINE? MATH1:DEFINE "C2*R2" defines Math 1. DSA8300 Programmer Manual 2-225...
Page 242
MATH<x>:DEFine MATH<x>:FILTer:MODe Arguments is the value of the risetime in the range 1 ps to 10 s. Given the characteristics of the DSA8300 and available sampling modules, reasonable values range from ~10 ps to 100 ns. 2-226 DSA8300 Programmer Manual...
Page 243
8. This is equivalent to specifying a math waveform in the Waveform section of the Vertical Setup dialog box and then entering a value for Position in the Setup section. Group Math Syntax MATH<x>:POSition <NR3> MATH<x>:POSition? DSA8300 Programmer Manual 2-227...
Page 244
Math 4 waveform scale to 100 mV per division. MATH4:SCALE 100E-03 might return as the scale MATH1:SCALE? MATH1:SCALE 1.00000000000 setting for the Math 1 waveform, indicating that the scale setting of the Math 1 waveform is 1 volt per division. 2-228 DSA8300 Programmer Manual...
Page 245
Group Math Syntax MATH<x>:UNIts? Examples might return , indicating that the units for MATH3:UNITS? MATH3:UNITS "V" Math 3 waveform are volts. MATH<x>:WFMLabel This command sets or queries the label associated with the math waveform specified. DSA8300 Programmer Manual 2-229...
Page 247
Annotations check box in the Measurement Setup dialog box. To display gates used in gated measurements, Gates must be enabled with the MEASUrement:MEAS<x>:GATing:STATE command. Group Measurement Syntax MEASUrement:ANNOtations:STATE { ON | OFF | NR1 } MEASUrement:ANNOtations:STATE? Related Commands MEASUrement:MEAS<x>:GATing:STATE DSA8300 Programmer Manual 2-231...
Page 248
3 defined measurements (Meas MEASUREMENT:LIST 1,4,5 1, Meas 4, and Meas 5) for which values can be returned. might return , indicating that MEASUREMENT:LIST? MEASUREMENT:LIST 1,2 the list consists of two measurements. 2-232 DSA8300 Programmer Manual...
Page 249
MEASUrement:STATIstics:ENABle ON command to ensure accurate measurement statistics. The following measurement values are returned (in the order listed below): Maximum Minimum Mean Standard deviation Measurement value Group Measurement Syntax MEASUrement:MEAS<x>:ALL? Related Commands MEASUrement:MEAS<x>:MAXimum? MEASUrement:MEAS<x>:MINimum? MEASUrement:MEAS<x>:MEAN? MEASUrement:MEAS<x>:STDdev? DSA8300 Programmer Manual 2-233...
Page 250
Qfactor, Eye Height and Crossing Percent. Group Measurement Syntax MEASUrement:MEAS<x>:EYEWindow <NR2> MEASUrement:MEAS<x>:EYEWindow? Arguments is the percent of interval between two eye crossings centered on the middle of the region. The range is 0 to 100. The default is 20. 2-234 DSA8300 Programmer Manual...
Page 251
0 disables the gating for the specified measurement; any other value enables the gating for the specified measurement. Examples enables the gating for Measurement MEASUREMENT:MEAS2:GATING:STATE ON might return MEASUREMENT:MEAS1:GATING:STATE? , indicating that gating is enabled MEASUREMENT:MEAS1:GATING:STATE 1 for Measurement 1. DSA8300 Programmer Manual 2-235...
Page 252
MEASUrement:MEAS<x>:MAXimum? (Query Only) This query only command returns the maximum value found for the measurement slot specified by x, which can be 1 through 8, since the last statistical reset. Measurement Group Syntax MEASUrement:MEAS<x>:MAXimum? Related Commands MEASUrement:MEAS<x>:ALL? Returns 2-236 DSA8300 Programmer Manual...
Page 253
1 through 8, since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS<x>:MINimum? Related Commands MEASUrement:MEAS<x>:ALL? Returns Examples might return MEASUREMENT:MEAS1:MINIMUM? , indicating that the MEASUREMENT:MEAS1:MINIMUM 1.92260747428E-003 minimum value for Meas 1 is 1.923 mV. DSA8300 Programmer Manual 2-237...
Page 254
This is a query only command that returns all reference level <x> settings for measurement slot <x> (slot one through slot eight). Measurement Group Syntax MEASUrement:MEAS<x>:REFLevel<x>? Examples might return MEASUREMENT:MEAS1:REFLEVEL? MEASUREMENT:MEAS1:REFLEVEL1:METHOD RELATIVE; ABSOLUTE:HIGH 0.00000000000E+000; LOW 0.00000000000E+000;MID 0.00000000000E+000 2-238 DSA8300 Programmer Manual...
Page 255
Absolute in the Reference Level Calc Method section of the RefLevel dialog and then entering an absolute value for Low in the Reference section of the Measurement Setup dialog box. Measurement Group DSA8300 Programmer Manual 2-239...
Page 256
MEASUrement:MEAS<x>:REFLevel<x>:ABSolute:MID? Related Commands MEASUrement:MEAS<x>:REFLevel<x>:METHod Arguments is the mid reference level in absolute user units. The default is 0 V. Examples sets the mid MEASUREMENT:MEAS3:REFLEVEL2:ABSOLUTE:MID 4.0E–2 reference level for Measurement 3 on Source 2 to 40 mV. 2-240 DSA8300 Programmer Manual...
Page 257
Reference Level Calc Method section of the RefLevel dialog in the Measurement Setup dialog box. The following diagram shows how RELative, ABSolute, HIDelta, and LODelta methods calculate the High and Low reference levels. Measurement Group DSA8300 Programmer Manual 2-241...
Page 258
90% for the high reference level, 50% for the mid reference level, and 10% for the low reference level. might return MEASUREMENT:MEAS8:REFLEVEL1:METHOD? , indicating MEASUREMENT:MEAS8:REFLEVEL1:METHOD ABSOLUTE the reference levels used are set to absolute values in user units. 2-242 DSA8300 Programmer Manual...
Page 259
1 for this measurement (or defaults to 1 if not specified). This percentage is used to calculate the low reference level when MEASUrement:MEAS<x>:REFLevel<x>:METHod is set to RELative. Sending this command is equivalent to selecting Relative in the Reference Level Calc DSA8300 Programmer Manual 2-243...
Page 260
Relative in the Reference Level Calc Method section of the RefLevel dialog and then entering a percentage for Mid in the Reference section of the Measurement Setup dialog box. Group Measurement Syntax MEASUrement:MEAS<x>:REFLevel<x>:RELative:MID <NR2> MEASUrement:MEAS<x>:REFLevel<x>:RELative:MID? 2-244 DSA8300 Programmer Manual...
Page 261
2. To set the actual waveform (channel, reference, or math) that is assigned to source, you must use the MEASUrement:MEAS<x>:SOURCE<x> WFM command. Two sources are provided because some measurements (gain, phase) require two sources. Group Measurement DSA8300 Programmer Manual 2-245...
Page 262
BACkward waveform (or gated region) and find the last edge with the slope set by the MEASUrement:MEAS<x>:SOURCE<x>:EDGE:SLOPe command (delay measurements) or for the edge implicitly determined by the defined measurement. 2-246 DSA8300 Programmer Manual...
Page 263
2. To set the actual waveform (channel, reference, or math) that is assigned to source, you must use the MEASUrement:MEAS<x>:SOURCE<x> WFM command. Two sources are provided because some measurements (such as gain and phase) require two sources. Group Measurement Syntax MEASUrement:MEAS<x>:SOUrce<x>:EDGE:SLOPe {RISE | FALL | EITHer} MEASUrement:MEAS<x>:SOUrce<x>:EDGE:SLOPe? DSA8300 Programmer Manual 2-247...
Page 264
2. To set the actual waveform (channel, reference, or math) that is assigned to source, you must use the MEASUrement:MEAS<x>:SOURCE<x> WFM command. Two sources are provided because some measurements (gain, phase) require two sources. Group Measurement Syntax MEASUrement:MEAS<x>:SOUrce<x>:GATE<x>? Examples might return MEASUREMENT:MEAS1:SOURCE1:GATE1? MEASUREMENT:MEAS1:SOURCE1:GATE1 POS 20.25000000000E-9;PCTPOS 25.00000000000 2-248 DSA8300 Programmer Manual...
Page 265
Group Measurement Syntax MEASUrement:MEAS<x>:SOUrce<x>:GATE<x>:PCTPos <NR2> MEASUrement:MEAS<x>:SOUrce<x>:GATE<x>:PCTPos? Related Commands MEASUrement:MEAS<x>:GATing:STATE Arguments is the position of the specified gate in percentage. Examples sets Gate 1 to 25% on the MEASUREMENT:MEAS4:SOURCE1:GATE1:PCTPOS 25 Source 1 waveform used for Measurement 4. DSA8300 Programmer Manual 2-249...
Page 266
Syntax MEASUrement:MEAS<x>:SOUrce<x>:GATE<x>:POS <NR3> MEASUrement:MEAS<x>:SOUrce<x>:GATE<x>:POS? Related Commands MEASUrement:MEAS<x>:SOUrce<x>:GATE<x>:PCTPos MEASUrement:MEAS<x>:GATing:STATE Arguments is the position of the specified gate in waveform units. The position is constrained to be ≥TOFP (time of first point) and ≤TOLP (time of last point). 2-250 DSA8300 Programmer Manual...
Page 267
(such as Meas 3), selecting a source (such as Source1), and then checking the radio button for the desired Tracking Method in the in the Hi/Low pane of the Measurement Setup dialog box. The exact value of High and Low depends on which calculation method you set. DSA8300 Programmer Manual 2-251...
Page 268
figure below. This method is useful for measuring frequency, width, and period for many types of signals. However, this method is sensitive to waveform ringing and spikes and does not always accurately measure rise time, fall time, overshoot, and undershoot. 2-252 DSA8300 Programmer Manual...
Page 269
Source1), and then checking the control box for Track High in the in the Hi/Low pane of the Measurement Setup dialog box. (If tracking is enabled, the instrument automatically calculates the high value using the method set with the command, MEASUrement:MEAS<x>:SOURCE<x>:HILow:METHod.) DSA8300 Programmer Manual 2-253...
Page 270
2. Sending this command is equivalent to selecting a measurement slot (such as Meas 3), selecting a source (such as Source1), turning tracking High off, and then entering an absolute value in the High control box in the in the Hi/Low pane of the 2-254 DSA8300 Programmer Manual...
Page 271
(such as Source1), and then checking the control box for Track Low in the in the HiLow dialog of the Measurement Setup dialog box. (If tracking is enabled, the instrument automatically calculates the low value using the method set with the command, MEASUrement:MEAS<x>:SOURCE<x>:HILow:METHod.) DSA8300 Programmer Manual 2-255...
Page 272
2. Sending this command is equivalent to selecting a measurement slot (such as Meas 3), selecting a source (such as Source1), setting tracking Low to off, and then entering an absolute value in the Low control box in the in the Hi/Low 2-256 DSA8300 Programmer Manual...
Page 273
(either 1 or 2), the default is SOURCE1. Optionally, this command can specify the timebase for the specified source or destination waveform. If the timebase is not specified, the default is the Main timebase. Group Measurement DSA8300 Programmer Manual 2-257...
Page 274
2. To set the actual waveform (channel, reference, or math) that is assigned to source, you must use the MEASUrement:MEAS<x>:SOURCE<x> WFM command. Two sources are provided because some measurements (gain, phase) require two sources. 2-258 DSA8300 Programmer Manual...
Page 275
2. To set the actual waveform (channel, reference, or math) that is assigned to source, you must use the MEASUrement:MEAS<x>:SOURCE<x> WFM command. Two sources are provided because some measurements (gain, phase) require two sources. Group Measurement DSA8300 Programmer Manual 2-259...
Page 276
You select the measurement source with the MEASUrement:MEAS<x>:SOURCE<x>:WFM command. You define the measurement type with the MEASUrement:MEAS<x>:TYPe command. Group Measurement Syntax MEASUrement:MEAS<x>:STATE {OFF | ON | <NR1>} MEASUrement:MEAS<x>:STATE? Related Commands MEASUrement:MEAS<x>:SOUrce<x>:WFM MEASUrement:MEAS<x>:TYPe 2-260 DSA8300 Programmer Manual...
Page 277
MEASUrement:MEAS<x>:STDdev? (Query Only) This query only command returns the standard deviation of values accumulated for the measurement slot specified by x, which can be 1 through 8, since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS<x>:STDdev? DSA8300 Programmer Manual 2-261...
Page 279
1 mw. measures the true root mean square of the waveform within the measurement region. measures the root mean square, minus the DC component, of the ACRMs waveform within the measurement region. DSA8300 Programmer Manual 2-263...
Page 280
first and last crossings, either BURst positive or negative, of the waveform at the mid-reference level within the measurement region. measures the one standard deviation (s) of the time variance RMSJitter where the waveform crosses the mid-reference level. 2-264 DSA8300 Programmer Manual...
Page 281
BITTime bits of the waveform. measures the inverse of the time interval between the start of two BITRate successive data bits of the waveform. DSA8300 Programmer Manual 2-265...
Page 282
This query only command returns the units for the measurement slot specified by x, which can be 1 through 8. You first must have defined the measurement slot using the MEASUrement:MEAS<x>:TYPe command before the units can be returned. Group Measurement Syntax MEASUrement:MEAS<x>:UNIts? Return Values. MEASUrement:MEAS<x>:UNIts? <QString> 2-266 DSA8300 Programmer Manual...
Page 283
MEASUrement:MEAS<x>:VALue? (Query Only) This query only command returns the value that has been calculated for the measurement slot specified by x. Measurement Group Syntax MEASUrement:MEAS<x>:VALue? Related Commands MEASUrement:MEAS<x>:TYPe MEASUrement:MEAS<x>:UNIts? Returns is the calculated value for the specified measurement. DSA8300 Programmer Manual 2-267...
Page 284
Examples enables the calculation of the MEASUREMENT:STATISTICS:ENABLE ON measurement statistics. might return MEASUREMENT:STATISTICS:ENABLE? , indicating that the calculation of MEASUREMENT:STATISTICS:ENABLE 0 statistics is disabled. NOTE. A query always returns a 0 or 1. 2-268 DSA8300 Programmer Manual...
finish. For a complete discussion of the use of these registers and the output queue, see Registers and Queues. The *OPC command allows you to synchronize the operation of the instrument with your application program. For more information, see Synchronization Methods. DSA8300 Programmer Manual 2-269...
Page 286
OPC operations. might return , indicating that all pending OPC operations are finished. *OPC ? *OPT? (Query Only) This query-only command returns a list of the options installed in your instrument. Group Status and Error Syntax *OPT? 2-270 DSA8300 Programmer Manual...
Page 287
Phase PHASEREF:CHAR Reference Module. PHAseref:CH<x>:ESTAmplitude? (Query Only) Queries the estimated amplitude (p-p) of the phase reference clock signal on the specified channel, as measured by the phase reference characterization process. Group Phase Reference Syntax PHAseref:CH<x>:ESTAmplitude? DSA8300 Programmer Manual 2-271...
Page 288
The command returns NONE (no usable clock phase reference signal detected), LOW, MEDIUM, or HIGH. Group Phase Reference Syntax PHAseref:CH<x>:ESTQuality? Examples might return PHAseref:CH7:ESTQuality? PHAseref:CH7:ESTQuality , indicating that the phase reference clock signal on Channel 7 is sufficient to HIGH obtain the best low jitter performance 2-272 DSA8300 Programmer Manual...
Page 289
32E+09 60E+09 Allowed range 2E+09 to 2E+09 to 2E+09 to 2E+09 to 25E+09 110E+09 32E+09 110E+09 Examples sets the phase reference PHASEREF:CH2:FREQUENCY 43.01841400000E+9 clock frequency to match a 43.018414 GHz clock connected to the 82A04-60G or DSA8300 Programmer Manual 2-273...
Page 290
NOTE. The allowed range of values that is accepted is larger than the guaranteed range that's supported. See the PHAseref:CH<x>:FREQuency command for more information. Group Phase Reference Syntax PHAseref:CH<x>:RANge? Related Commands PHAseref:CH<x>:FREQuency PHAseref:CHAR PHAseref:MODe PHAseref:SOUrce PHAseref:CH<x>:STAtus? 2-274 DSA8300 Programmer Manual...
Page 291
Either you have not run a successful characterization since you connected the clock and turned phase correction on, or you have changed the clock input, or the clock has changed in amplitude, offset or shape, or you have changed one or more of the following settings: DSA8300 Programmer Manual 2-275...
Page 292
If fail status still results, you may be providing a faulty clock or one that mismatches the clock frequency that you set with the PHAseref:CH<x>:FREQuency command. Here are some possible status messages that return with the "Characterization failed" string: 2-276 DSA8300 Programmer Manual...
Page 293
Characterization (see the PHAseref:CHAR command) is required whenever the phase correction mode is changed. The 82A04 and 82A04B Phase Reference Modules provides a phase-correction timebase. This timebase, in turn, supports ultra-low trigger jitter (typical is 100 fs DSA8300 Programmer Manual 2-277...
Page 295
PHASEREF:MODE? will return PHASEREF:MODE FREERUN when the mode has been set to either FREERUN or UNTRIGGER. PHAseref:SOUrce This command sets or queries the small-module compartment that is used as the phase ref source when phase-correction is turned on. The compartment must DSA8300 Programmer Manual 2-279...
Page 296
5 and 6 as the source for the phase correction timebase. might return , indicating that the PHASEREF:SOURCE? PHASEREF:SOURCE C1C2 currently selected source is the Phase Reference Module that is installed in the small-module compartment for channels 1 and 2. 2-280 DSA8300 Programmer Manual...
Page 297
Setup or Recall Factory Setup in the Save/Recall Setup menu. Group Save and Recall Syntax RECAll:SETUp {FACtory | <file path>} Related Commands FACtory *RST SAVe:SETUp Arguments selects the factory setup. FACtory is the location from which the setup will be recalled. <file path> DSA8300 Programmer Manual 2-281...
Page 298
The reference waveform is specified by x, which can be 1 through 8. This is the equivalent to specifying a reference waveform in the Waveform section of the Vertical Setup dialog box and then entering a value for Position in the Setup section. 2-282 DSA8300 Programmer Manual...
Page 299
Reference 4 waveform scale to 10 mV per REF4:SCALE 1.0E-02 division. might return , indicating that REF1:SCALE? REF1:SCALE 0.100000000000 the current volts per division setting of the Reference 1 waveform is 100 mV per division. DSA8300 Programmer Manual 2-283...
Page 300
The Output Queue The Service Request Enable Register setting The Standard Event Status Enable Register setting The Power-on status clear flag setting Stored settings This command is equivalent to pressing the DEFAULT SETUP button on the front panel. 2-284 DSA8300 Programmer Manual...
Page 301
Settings saved in one instrument may or may not work on a different instrument with a different version of firmware. Examples saves SAVE:SETUP "C:\MY DOCUMENTS\TESTS\UI\DATA\SETUPTEST.STP" the current instrument setup to the file Setuptest.STP in the Data subdirectory on the C drive. DSA8300 Programmer Manual 2-285...
Page 302
Math 2 waveform displayed by SAVE:WAVEFORM MATH2,MAIN,REF1 the Main timebase in Reference memory location 2. saves the Math1 waveform SAVE:WAVEFORM MATH1,MAG1,"TEK00000.WFM" displayed by the Mag 1 timebase to the file TEK00000.WFM in the default directory and on the default drive. 2-286 DSA8300 Programmer Manual...
Page 303
Channel 4. SELECT:CH4 1 might return , indicating that the display of the SELECT:CH2? SELECT:CH2 0 Channel 2 acquisition waveform is disabled. NOTE. A query always returns a 0 or 1. DSA8300 Programmer Manual 2-287...
Page 304
This waveform is displayed using the main timebase. might return , indicating SELECT:CONTROL? SELECT:CONTROL math5,main that the Math 5 waveform is currently affected by the front-panel controls and is displayed using the main timebase. 2-288 DSA8300 Programmer Manual...
Page 305
On control in the Waveform section of the Vertical Setup dialog box. NOTE. You should define a reference waveform before turning the waveform on. Group Vertical DSA8300 Programmer Manual 2-289...
Page 306
The VERBose command can still be used to specify whether the returned headers should be abbreviated or full length. Related Commands HEADer *LRN? VERBose 2-290 DSA8300 Programmer Manual...
Page 307
The *SRE (Service Request Enable) command sets or queries the bits in the Service Request Enable Register (SRER). For more information, refer to Registers. Group Status and Error Syntax *SRE <NR1> *SRE? Related Commands *CLS DESE *ESE *ESR? EVENT? EVMsg? FACtory *STB? DSA8300 Programmer Manual 2-291...
Page 308
Register (SBR) using the Master Summary Status (MSS) bit. For more information, refer to Registers. Group Status and Error Syntax *STB? Related Commands *CLS DESE *ESE *ESR? EVENT? EVMsg? FACtory *SRE Returns <NR1> Examples might return showing that the SBR contains the binary value 01100000. *STB? 2-292 DSA8300 Programmer Manual...
Page 309
CPU cycles or system resources. Group Miscellaneous Syntax SYNC:TIMEOUT <NR1> SYNC:TIMEOUT? Related Commands MEASUrement:ALL:VALue? MEASUrement:LIST MEASUrement:LISTValue? MEASUrement:MEAS<x>:MAXimum? MEASUrement:MEAS<x>:MINimum? MEASUrement:MEAS<x>:MEAN? MEASUrement:MEAS<x>:STDdev? MEASUrement:MEAS<x>:VALue? MEASUrement:MEAS<x>:ALL? MEASUrement:MEAS<x>:UNIts? MEASUrement:MEAS<x>:TYPe ACQuire:CURRentcount:ACQWfms? ACQuire:CURRentcount:HISTWfms? ACQuire:CURRentcount:HISTHits? ACQuire:CURRentcount:MASKWfms? DSA8300 Programmer Manual 2-293...
Page 310
, indicating the default timeout is 3 seconds. SYNC:TIMEOUT? SYSTem:PROPerties:CH<x>:BANDwidth? (Query Only) This query only command returns a list of available bandwidth selections or, if applicable to the sampling module channel, its characteristic bandwidth. Group System 2-294 DSA8300 Programmer Manual...
Page 311
This query only command returns a list of the available clock recovery selections available to the trigger system from the channel specified by x, which can be 1 through 8. Group System Syntax SYSTem:PROPerties:CH<x>:CLKRec? Related Commands TRIGger:CH<x>:CLKRec:LIST? TRIGger:CH<x>:CLKRec:VALue DSA8300 Programmer Manual 2-295...
Page 312
1 through 8. Group System Syntax SYSTem:PROPerties:CH<x>:DYNamic? Examples might SYSTEM:PROPERTIES:CH5:DYNAMIC? return SYSTEM:PROPERTIES:CH5:DYNAMIC , indicating that the input –5.00000000000E–001,5.00000000000E–001 dynamic range of Channel 5 is between –0.5 to +0.5, for a total dynamic range 2-296 DSA8300 Programmer Manual...
Page 313
This query only command returns a list of the available filter selections for the channel specified by x, which can be 1 through 8. Group System Syntax SYSTem:PROPerties:CH<x>:FILTer? Related Commands CH<x>:FILTer:LIST? CH<x>:FILTer:VALue Examples might return SYSTEM:PROPERTIES:CH1:FILTER? SYSTEM:PROPERTIES:CH1:FILTER NONE,OC12,OC48,OC192 DSA8300 Programmer Manual 2-297...
Page 314
This query only command returns the lower (minimum) and upper (maximum) absolute input signal nondestructive limits of the channel specified by x, which can be 1 through 8. Group System Syntax SYSTem:PROPerties:CH<x>:NONDestruct? Examples might SYSTEM:PROPERTIES:CH3:NONDESTRUCT? return SYSTEM:PROPERTIES:CH3 NONDESTRUCT , indicating that the absolute –3.00000000000E+000,3.00000000000E+000 2-298 DSA8300 Programmer Manual...
Page 315
See the PHAseref:CH<x>:RANge? query for more information. Group System Syntax SYSTem:PROPerties:CH<x>:PRAnge? Related Commands PHAseref:CH<x>:RANge? PHAseref:CH<x>:STAtus? Examples might return for an SYSTEM:PROPERTIES:CH2:PRANGE? 8.000GHZ-60.00GHZ 82A04B or 82A04 module installed in the CH1/CH2 small-module compartment. DSA8300 Programmer Manual 2-299...
Page 316
Channel 1 is 100 kΩ. SYSTem:PROPerties:CH<x>:PRObe:MODElnum? (Query Only) This query only command returns the model number of the probe attached to the channel specified by x, which can be 1 through 8. 2-300 DSA8300 Programmer Manual...
Page 317
SYSTEM:PROPERTIES:CH3:PROBE:MODELNUM? , indicating that a SYSTEM:PROPERTIES:CH3:PROBE MODELNUM "P6209" Tektronix P6209 FET probe is attached to Channel 3. SYSTem:PROPerties:CH<x>:PRObe:SCAle? (Query Only) This query only command returns the scale factor of a probe attached to the channel specified by x, which can be 1 through 8.
Page 318
, indicating the SYSTEM:PROPERTIES:CH4:TEKPDRIVER "1.00" TEKPROBE driver revision number for Channel 4. SYSTem:PROPerties:CH<x>:TEKPVersion? (Query Only) This query only command returns the TEKPROBE version number for the channel specified by x, which can be 1 through 8. 2-302 DSA8300 Programmer Manual...
Page 319
CH<x>:WLENgth:VALue Examples might return SYSTEM:PROPERTIES:CH2:WLENGTH? SYSTEM:PROPERTIES:CH2:WLENGTH FACTORY,1550,1310,USER,1000 SYSTem:PROPerties:EFEHWver? (Query Only) This query only command returns the version number of the Electrical Front End (EFE) circuit board. Group System Syntax SYSTem:PROPerties:EFEHWver? Examples might return SYSTEM:PROPERTIES:EFEHWVER? SYSTEM:PROPERTIES:EFEHWVER? 1 DSA8300 Programmer Manual 2-303...
Page 320
SYSTEM:PROPERTIES:GROUP1:TEKPVERSION "1331-00" version of the TEKPROBE controller for Group 1. SYSTem:PROPerties:MAInframe:KEY? (Query Only) This query only command returns the key used to enable instrument options. Group System Syntax SYSTem:PROPerties:MAInframe:KEY? Examples might return SYSTEM:PROPERTIES:MAINFRAME:KEY? SYSTEM:PROPERTIES:MAINFRAME KEY "WEMYMKKKKMYYYYYBBBBBAAAAA" 2-304 DSA8300 Programmer Manual...
Page 321
This query only command returns the model number of the mainframe instrument. Group System Syntax SYSTem:PROPerties:MAInframe:MODElnum? Examples might return SYSTEM:PROPERTIES:MAINFRAME:MODELNUM? SYSTEM:PROPERTIES:MAINFRAME MODELNUM "DSA8300" SYSTem:PROPerties:MAInframe:SERialnum? (Query Only) This query only command returns the serial number of the mainframe instrument. Group System Syntax SYSTem:PROPerties:MAInframe:SERialnum? Examples...
Page 322
(OFE) circuit board. Group System Syntax SYSTem:PROPerties:OFESERialnum? Examples might return SYSTEM:PROPERTIES:OFESERIALNUM? SYSTEM:PROPERTIES: OFESERIALNUM? "05G7T8" SYSTem:PROPerties:ONTime? (Query Only) This query only command returns the on time (in hours) for the current power-on cycle of the instrument. Group System 2-306 DSA8300 Programmer Manual...
Page 323
Group System Syntax SYSTem:PROPerties:PROCHWver? Examples might return SYSTEM:PROPERTIES:PROCHWVER? SYSTEM:PROPERTIES:PROCHWVER 1 SYSTem:PROPerties:TBHWver? (Query Only) This query only command returns the version number of the Timebase (TB) circuit board in the instrument. Group System DSA8300 Programmer Manual 2-307...
Page 324
Syntax SYSTem:PROPerties:TOTalontime? Examples might return SYSTEM:PROPERTIES:TOTALONTIME? , indicating the total power-on SYSTEM:PROPERTIES:TOTALONTIME 533.47 time for the instrument is 533.47 hours. TDR? (Query Only) This query only command returns all of the TDR parameters. Group Syntax TDR? 2-308 DSA8300 Programmer Manual...
Page 325
TDR steps on those channels not attached to the longest cable due to the effect of extender cables on the minimum horizontal position. Group Syntax TDR:CH<x>:DIFfpreset DSA8300 Programmer Manual 2-309...
Page 326
TDR steps on those channels not attached to the longest cable due to the effect of extender cables on the minimum horizontal position. Group Syntax TDR:CH<x>:PRESET Related Commands TDR:CH<x>:UNIts TDR:CH<x>:STEP:POLarity TDR:CH<x>:STEP:STATE 2-310 DSA8300 Programmer Manual...
Page 327
This command sets or queries the step skew time (in seconds) for the specified TDR channel. This command is only supported by the 80E08B and 80E10B modules. Group Syntax TDR:CH<x>:STEP:DESkew:TIMe <NR3> TDR:CH<x>:STEP:DESkew:TIMe? Arguments is the step skew time for this channel, in seconds. DSA8300 Programmer Manual 2-311...
Page 328
1 through 8. This is equivalent to toggling the polarity icon between a rising edge and a falling edge in the TDR Step section of the TDR Setup dialog box for the specified channel. Group Syntax TDR:CH<x>:STEP:POLarity {PLUS | MINUS} TDR:CH<x>:STEP:POLarity? 2-312 DSA8300 Programmer Manual...
Page 329
Examples turns off the TDR generator for Channel 6. TDR:CH6:STEP:STATE OFF might return , indicating that TDR:CH5:STEP:STATE? TDR:CH5:STEP:STATE 1 the TDR generator for Channel 5 is on. NOTE. A query always returns a 0 or 1. DSA8300 Programmer Manual 2-313...
Page 330
The command allows you to adjust the external 10 MHz reference frequency to ensure that the timebase locks when the Lock to Ext 10 MHz mode is set using the TDR:REF10Mhz command. Group Syntax TDR:EXT10MHZref:FREQ <NR3> TDR:EXT10MHZref:FREQ? 2-314 DSA8300 Programmer Manual...
Page 331
Examples sets the internal clock rate to 100 kHz. TDR:INTRATE 100E3 might return TDR:INTRATE? TDR:INTRATE 0.200000000000E+006 indicating that the internal clock rate is set to 200 kHz (the default value). DSA8300 Programmer Manual 2-315...
Page 332
0 to 59. ss is the seconds number in the minute from 0 to 59. NOTE. There must be a colon between the hh and mm, and between the mm and ss. 2-316 DSA8300 Programmer Manual...
Page 333
The command supports both the *OPC and *OPC? Operation Complete capabilities. Group Trigger Syntax TRIGger:AUTOSync {EXECute} Arguments executes the AutoSync operations. EXECute Examples executes all the AutoSync operations. TRIGGER:AUTOSYNC EXECUTE DSA8300 Programmer Manual 2-317...
Page 334
OFF, so that when AutoSync executes it will or will not attempt to determine the data-to-clock ratio for the currently selected waveform. The query form returns the status of the option. Group Trigger Syntax TRIGger:AUTOSync:DCRAtio { ON | OFF | NR1 } TRIGger:AUTOSync:DCRAtio? 2-318 DSA8300 Programmer Manual...
Page 335
ON, so that AutoSync attempts to determine the pattern length of the selected waveform when it executes. might return TRIGGER:AUTOSYNC:PLENGTH? TRIGGER:AUTOSYNC:PLENGTH , indicating that AutoSync is not set to automatically determine the pattern length of the selected waveform when it executes. DSA8300 Programmer Manual 2-319...
Page 336
Use the range returned values of this query to set the User clock rate with the TRIGger:CH<x>:CLKRec:USEr command. Group Trigger Syntax TRIGger:CH<x>:CLKRec:RANge? Related Commands TRIGger:CH<x>:CLKRec:USEr SYSTem:PROPerties:CH<x>:CLKUser? Examples might return , indicating that TRIGGER:CH1:CLKREC:RANGE? 9.8E9 - 12.6E9 any user rate between 9.8 Gb/s and 12.6 Gb/s can be defined for Channel 1. 2-320 DSA8300 Programmer Manual...
Page 337
If you select a clock recovery setting that your sampling module does not support, you will receive Execution Error code 220 with error message "Parameter Error." (See Messages for general information on programming interface messages.) DSA8300 Programmer Manual 2-321...
Page 338
10.518750 Gb/s bit rate, in accordance FC10519 with the proposed 10 Gigabit Fibre Channel (10GFC) standard. selects clock recovery for the 2.6660571 Gb/s bit rate, in accordance FEC2666 with the ITU-T G.975 Recommendation. 2-322 DSA8300 Programmer Manual...
Page 339
PCI Express Base specification. selects clock recovery for the 1.5 Gb/s bit rate, in accordance SATA1500 with the Serial ATA 1.0a specification. selects clock recovery for the 3.0 Gb/s bit rate (2nd generation SATA3000 SATA rate). DSA8300 Programmer Manual 2-323...
Page 340
Group Trigger Syntax TRIGger:CLKRec:CRC:AUTOSConfigdev {ON | OFF | <NR1>} TRIGger:CLKRec:CRC:AUTOSConfigdev? Arguments specifies that Auto-save is enabled. specifies that Auto-save is disabled. . 1 enables auto-save, 0 disables auto-save. <NR1> 2-324 DSA8300 Programmer Manual...
Page 341
Bit 11 indicates DDR capability, allows data input above 14.3 GHz. Bits are in LSB to MSB order. For example, HS is bit zero (00000000001), DDS is bit one (00000000010), and so on. Query response when no clock recovery instrument is present: 0. DSA8300 Programmer Manual 2-325...
Page 342
TRIGger:CLKRec:CRC:CLOCKOutput {ON | OFF | <NR1>} TRIGger:CLKRec:CRC:CLOCKOutput? Arguments enables the clock output on the clock recovery instrument. disables the clock output on the clock recovery instrument. . 1 enables the clock output. 0 disables the clock output. <NR1> 2-326 DSA8300 Programmer Manual...
Page 343
TRIGGER:CLKREC:CRC:CREATESTANDARD "USER_10G" named USER_10G to the non-volatile memory of the clock recovery instrument. TRIGger:CLKRec:CRC:DATARate? (Query Only) This query only command returns the measured data rate (in Hz) from the connected clock recovery instrument. DSA8300 Programmer Manual 2-327...
Page 344
USER_10G from the clock recovery instrument. TRIGger:CLKRec:CRC:DEVICEName This command sets or queries the device name of the connected clock recovery instrument. The name is saved in non-volatile memory on the clock recovery instrument. Group Trigger 2-328 DSA8300 Programmer Manual...
Page 345
NAN is returned if a clock recovery instrument is not present. TRIGger:CLKRec:CRC:EDGEDENSITYMode This command sets or queries the edge density mode setting of the connected clock recovery instrument. Group Trigger Syntax TRIGger:CLKRec:CRC:EDGEDENSITYMode {NOMinal | ON_Lock} TRIGger:CLKRec:CRC:EDGEDENSITYMode? DSA8300 Programmer Manual 2-329...
Page 346
10 = minimum equalization, and 0.1 = maximum equalization. Query response when no clock recovery instrument is present: NaN. Examples sets the CR286A equalizer value to TRIGGER:CLKREC:CRC:EQUALIZER 4.6 4.6. ? might return , indicating that the TRIGGER:CLKREC:CRC:EQUALIZER CR286A equalizer setting is 2.2. 2-330 DSA8300 Programmer Manual...
Page 347
TRIGger:CLKRec:CRC:HALFRate? (Query Only) Indicates whether the clock outputs of the clock recovery instrument (CRI) are at the full-rate or half of the input signal's data rate. Group Trigger Syntax TRIGger:CLKRec:CRC:HALFRate? DSA8300 Programmer Manual 2-331...
Page 348
This query only command returns the number of times the connected clock recovery instrument. Group Trigger Syntax TRIGger:CLKRec:CRC:LOCKCount? Examples might return TRIGGER:CLKREC:CRC:LOCKCOUNT? indicating that the clock recovery :TRIGGER:CLKREC:CRC:LOCKCOUNT 1 instrument has locked once. NOTE. 0 is returned if a clock recovery instrument is not present. 2-332 DSA8300 Programmer Manual...
Page 349
TRIGGER:CLKREC:CRC:LOCKMODE AUTOMATIC clock recovery instrument to automatic. might return TRIGGER:CLKREC:CRC:LOCKMODE? , indicating that the lock mode is :TRIGGER:CLKREC:CRC:LOCKMODE AUTO set to the automatic setting. NOTE. AUTOMATIC is returned if a clock recovery instrument is not present. DSA8300 Programmer Manual 2-333...
Page 350
May return UNLocked, ACQuiringlock, LOCKed, or HIGHJitter. Examples might return TRIGGER:CLKREC:CRC:LOCKSTATE? indicating that the clock recovery :TRIGGER:CLKREC:CRC:LOCKSTATE LOCK instrument is locked to the signal. NOTE. UNLOCKED is returned if a clock recovery instrument is not present. 2-334 DSA8300 Programmer Manual...
Page 351
BERTScope that supports jitter analysis. TRIGger:CLKRec:CRC:NOMEDgedensity This command sets or queries the nominal edge density (in percent) of the clock recovery instrument. The edge density refers to the average percentage of unit intervals which contain a transition. Group Trigger DSA8300 Programmer Manual 2-335...
Page 352
12.5 GHz. might return TRIGGER:CLKREC:CRC:NOMFREQUENCY? :TRIGGER:CLKREC:CRC:NOMFREQUENCY 12.00000000000E9, indicating that the nominal frequency of the clock recovery instrument is set to 12 GHz. NOTE. NAN is returned if a clock recovery instrument is not present. 2-336 DSA8300 Programmer Manual...
Page 353
50%. TRIGGER:CLKREC:CRC:PHASEERRLIMIT 50 might return TRIGGER:CLKREC:CRC:PHASEERRLIMIT? :TRIGGER:CLKREC:CRC:PHASEERRLIMIT 50.00000000000 indicating that phase error limit is set to 50% UI. NOTE. NAN is returned if a clock recovery instrument is not present. DSA8300 Programmer Manual 2-337...
Page 354
NAN is returned if a clock recovery instrument is not present. TRIGger:CLKRec:CRC:RCONfigdevice (No Query Form) This command restores the clock recovery instrument to the settings from one of the non-volatile setup locations in the clock recovery instrument. Group Trigger 2-338 DSA8300 Programmer Manual...
Page 355
TRIGger:CLKRec:CRC:LOCKState? Examples causes the connected clock recovery instrument TRIGGER:CLKREC:CRC:RELOCK to search and lock to the data rate. TRIGger:CLKRec:CRC:RESETLockcount (No Query Form) This command resets the lock count to zero on the clock recovery instrument. Group Trigger DSA8300 Programmer Manual 2-339...
Page 356
SETUP_4 Examples stores the current clock TRIGGER:CLKREC:CRC:SCONFIGDEVICE SETUP_1 recovery instrument instrument settings to memory location 1. TRIGger:CLKRec:CRC:SERIalnum? (Query Only) This query only command returns the serial number of the clock recovery instrument. Group Trigger Syntax TRIGger:CLKRec:CRC:SERIalnum? 2-340 DSA8300 Programmer Manual...
Page 357
This query only command returns a comma-separated list of the standards available on the clock recovery instrument. Group Trigger Syntax TRIGger:CLKRec:CRC:STANDARDList? Examples might return TRIGGER:CLKREC:CRC:STANDARDLIST? :TRIGGER:CLKREC:CRC:STANDARDLIST SATA1(0.9), SATA1(1.98), … indicating these are the standards supported by the connected clock recovery instrument. DSA8300 Programmer Manual 2-341...
Page 358
NOTE. NAN is returned if a clock recovery instrument is not present. TRIGger:CLKRec:CRC:SUBCLOCKDiv This command sets or queries the division ratio of the sub-rate clock of the clock recovery instrument. Group Trigger Syntax TRIGger:CLKRec:CRC:SUBCLOCKDiv <NR1> TRIGger:CLKRec:CRC:SUBCLOCKDiv? 2-342 DSA8300 Programmer Manual...
Page 359
TRIGGER:CLKREC:CRC:SUBCLOCKDIVLIST? return :TRIGGER:CLKREC:CRC:SUBCLOCKDIVLIST 1,2,4,5,6,7,8,9,10,12,14,16,18,20,24,25,28,30,32,35,36,40,42,45 NOTE. undefined is returned if a clock recovery instrument is not present. TRIGger:CLKRec:CRC:SUBCLOCKOutput This command sets or queries the state of the sub-rate clock output of the clock recovery instrument. Group Trigger DSA8300 Programmer Manual 2-343...
Page 360
UNDEFINED is returned if a clock recovery instrument is not present. TRIGger:HIFreq This command sets or queries the high-frequency triggering function. The high-frequency function increases the trigger circuit sensitivity by decreasing hysteresis. This allows more stable triggering on higher frequency signals. 2-344 DSA8300 Programmer Manual...
Page 361
TRIGger:NOISErej parameter to OFF. There is no DSA8300 user interface access to this function. This command is present to provide compatibility of the DSA8300 with programs written for legacy TDS/CSA8000/DSA8200 series sampling oscilloscopes. High frequency triggering is enabled only when the trigger source is set to Direct.
Page 362
HORizontal:MAIn:POSition CH<x>:DESkew Arguments is the value of the holdoff time. Examples sets the requested trigger holdoff to 5 µs. TRIGGER:HOLDOFF 5.0E-6 might return TRIGGER:HOLDOFF? TRIGGER:HOLDOFF 6.00000000000E-006 indicating that the actual holdoff is set to 6 µs. 2-346 DSA8300 Programmer Manual...
Page 363
This command is equivalent to setting a value for the level in the Level section of the Trigger Setup dialog box or adjusting the Trigger LEVEL control on the front panel. Group Trigger Syntax TRIGger:LEVel <NR3> TRIGger:LEVel? DSA8300 Programmer Manual 2-347...
Page 364
"bit stream", with minimal clock to data jitter. NOTE. Pattern mode is only available if the DSA8300 has the ADVTRIG option present. Select Other mode if the signal you are acquiring is synchronous with the selected clock source and you wish to display the acquired data showing the effects of any clock modulation (such as Spread Spectrum Clocking).
Page 365
Examples enables the noise rejection triggering for the TRIGGER TRIGGER:NOISEREJ ON DIRECT INPUT connector. might return , indicating that noise TRIGGER:NOISEREJ? TRIGGER:NOISEREJ 0 rejection triggering is disabled on the TRIGGER DIRECT INPUT connector. DSA8300 Programmer Manual 2-349...
Page 366
If you attempt to modify this parameter while the AUTOSync:DCRAtio is ON, you will receive Execution Error code 2539 with an error message "Pattern Sync Parameter is not settable". The Messages section contains general information on programming interface messages.(See page 3-11.) Group Trigger 2-350 DSA8300 Programmer Manual...
Page 367
This trigger level is effective only when the trigger source is set to External Direct (see the TRIGger:SOUrce command). The trigger level is the voltage threshold through which the trigger DSA8300 Programmer Manual 2-351...
Page 368
External Direct. might return , indicating that the TRIGGER:SLOPE? TRIGGER:SLOPE RISE instrument is set to trigger on the rising slope of the trigger source signal. 2-352 DSA8300 Programmer Manual...
Page 369
(triggers) signal acquisition. This is equivalent to selecting the trigger source in the Trigger/Mode Setup dialog box. Group Trigger Syntax TRIGger:SOUrce { C1CLKRec | C3CLKRec | CLKPre | EXTDirect | EXTPrescaler | FREerun | INTClk | TDR } TRIGger:SOUrce? DSA8300 Programmer Manual 2-353...
Page 370
TDR step pulses with the subsequent acquisition. The Internal Clock Out connector on the instrument front panel supplies a sample of the internal clock. Examples sets the trigger source to use the Trigger Direct TRIGGER:SOURCE EXTDIRECT Input front panel connector. 2-354 DSA8300 Programmer Manual...
Page 371
If the instrument is in the Remote With Lockout State (RWLS), the UNLOCk command has no effect. For more information see the ANSI-IEEE Std. 488.1-1987 Standard Digital Interface for Programmable Instrumentation, section 2.8.3 on RL State Descriptions. Group Miscellaneous Syntax UNLock ALL DSA8300 Programmer Manual 2-355...
Page 372
Examples sets the verbose state true, which returns full-length keywords for VERBOSE ON queries. might return , indicating that the verbose state is true. VERBOSE? VERBOSE 1 NOTE. A query always returns a 0 or 1. 2-356 DSA8300 Programmer Manual...
Page 373
(data and outgoing waveform preamble) for the waveform as specified by the DATa:SOUrce command. This command is equivalent to sending the CURVe? and WFMOutpre? commands. Group Waveform Transfer Syntax WAVFrm? Related Commands CURVe DATa:SOUrce DATa:TIMebase WFMOutpre? Examples might return (partial) WAVFRM? WAVFRM -447610880,-467206144,-501547008, -499187712,-513605632,-510001152,-511508480, -519241728,-504365056,-504365056,-507576320, -509214720,-509476864,-509476864,-509476864, DSA8300 Programmer Manual 2-357...
Page 374
MODE VARPERSIST;COUNT 2000;SAMPLES 500000;:WFMDB WFMDB3:SOURCE CH3,MAIN;DISPLAY 1;ENABLE 1; PERSISTENCE:MODE INFPERSIST;COUNT 500;SAMPLES 125000; WFMDB:WFMDB4:SOURCE MATH3,MAG1;DISPLAY 0;ENABLE 0; PERSISTENCE:MODE INFPERSIST;COUNT 500;SAMPLES 125000 WFMDB:DISPlay?P (Query Only) This query only command returns all the WfmDB display parameters. Group Waveform Database Syntax WFMDB:DISPlay? 2-358 DSA8300 Programmer Manual...
Page 375
This command sets or queries which grading type (color or intensity) the instrument uses to draw the WfmDB. This is equivalent to selecting Color or Intensity for Grading in the Display Options section of the WfmDB Setup dialog box. Group Waveform Database DSA8300 Programmer Manual 2-359...
Page 376
Use of this command is equivalent to selecting Grading Method in the Display Options section of the Wfm Database Setup dialog box. Group Waveform Database Syntax WFMDB:DISPlay:GRADMethod {EMPH8 | EMPH7 | BIN8 | BIN7} WFMDB:DISPlay:GRADMethod? Related Commands WFMDB:DISPlay:EMPHasis 2-360 DSA8300 Programmer Manual...
Page 377
When Invert is enabled, the mapping function that applies colors and intensity to the WfmDB significantly emphasizes the least occurring pixels. This is the equivalent to selecting or deselecting Invert Color/Intensity in the Display Options section of the WfmDB Setup dialog box. Group Waveform Database DSA8300 Programmer Manual 2-361...
Page 378
This command (no query form) resets to zero (clears) the counts in the specified WfmDB. The WfmDB is specified by x, which can be 1 through 4. (Sending the ACQuire:DATA:CLEAR command has the same effect on the WfmDB.) Group Waveform Database 2-362 DSA8300 Programmer Manual...
Page 379
(WfmDB) is enabled. The WfmDB is specified by x, which can be 1 through 4. This command is the equivalent to selecting or deselecting the On check box in the Database section of the Wfm Database Setup dialog box. Use DSA8300 Programmer Manual 2-363...
Page 380
WFMDB:WFMDB<x>:PERSistence:MODe VARPersist. Use of this command is equivalent to entering a value in the Waveforms Edit Box in the Persistence section of the Wfm Database Setup dialog box. Group Waveform Database Syntax WFMDB:WFMDB<x>:PERSistence:COUNt <nr1> WFMDB:WFMDB<x>:PERSistence:COUNt? 2-364 DSA8300 Programmer Manual...
Page 381
1 through 4. The modes are described under Arguments, below. Use of this command is equivalent to selecting Infinite or Variable in the Persistence section of the Wfm Database Setup dialog box. Group Waveform Database Syntax WFMDB:WFMDB<x>:PERSistence:MODe {INFPersist | VARPersist} WFMDB:WFMDB<x>:PERSistence:MODe? Related Commands WFMDB:WFMDB<x>:PERSistence:SAMPles? WFMDB:WFMDB<x>:PERSistence:COUNt DSA8300 Programmer Manual 2-365...
Page 382
Persistence section of the Wfm Database Setup dialog box. Group Waveform Database Syntax WFMDB:WFMDB<x>:PERSistence:SAMPles? Related Commands WFMDB:WFMDB<x>:PERSistence:MODe WFMDB:WFMDB<x>:PERSistence:COUNt Examples might return , indicating WFMDB:WFMDB<1>:PERSistence:SAMPles? 50000 that the oldest waveforms will be dropped from the database 1 as the sample count exceeds 50000 samples. 2-366 DSA8300 Programmer Manual...
Page 383
Math 2 waveform is set as the source for WfmDB2 and is displayed with the Main timebase. WFMInpre? (Query Only) This is a query only that returns the waveform formatting data (preamble) for the incoming waveform. Group Waveform Transfer Syntax WFMInpre? DSA8300 Programmer Manual 2-367...
Page 384
This command sets or queries the format of the binary or ascii data encoding of the waveform to be transferred to the instrument. Group Waveform Transfer Syntax WFMInpre:BN_Fmt {RI | FP} WFMInpre:BN_Fmt? Related Commands DATa:ENCdg WFMInpre:BYT_Or WFMInpre:ENCdg 2-368 DSA8300 Programmer Manual...
Page 385
WFMInpre:BYT_Or Selects which byte of binary waveform data is transmitted first during a waveform data transfer to the instrument. Group Waveform Transfer Syntax WFMInpre:BYT_Or {LSB | MSB} WFMInpre:BYT_Or? Related Commands DATa:ENCdg WFMInpre:BN_Fmt DSA8300 Programmer Manual 2-369...
Page 386
BINary Examples specifies that the input waveform data is in ASCII WFMINPRE:ENCDG ASCII format. might return , indicating that the WFMINPRE:ENCDG? WFMINPRE:ENCDG BIN waveform data is in binary format. 2-370 DSA8300 Programmer Manual...
Page 387
WFMINPRE:NR_PT 4000 record length for the input waveform is set to 4000. WFMInpre:PT_Fmt This command sets or queries the data point format of the incoming waveform. Group Waveform Transfer Syntax WFMInpre:PT_Fmt {Y | ENV} Related Commands DATa:DESTination DSA8300 Programmer Manual 2-371...
Page 388
Qstring Examples sets the label for the incoming waveform WFMINPRE:WFMLABEL "PULSE TEST" to Pulse Test. might return WFMINPRE:WFMLABEL? WFMINPRE:WFMLABEL "TEST 4" indicating that the label for the incoming waveform is set to Test 4. 2-372 DSA8300 Programmer Manual...
Page 389
10 µs per division. WFMINPRE:XMULT 1.0E-5 might return WFMINPRE:XMULT? WFMINPRE:XMULT 1.00000000000E-009 indicating that the horizontal scale factor of the waveform to be transferred is set to 1 ns per division. DSA8300 Programmer Manual 2-373...
Page 390
WFMInpre:XUNit? Related Commands HORizontal:UNIts Arguments is a quoted string. Qstring Examples sets the horizontal units to seconds. WFMINPRE:XUNIT "S" might return , indicating that the WFMINPRE:XUNIT? WFMINPRE:XUNIT "S" horizontal units of the incoming waveform are seconds. 2-374 DSA8300 Programmer Manual...
Page 391
This command sets or queries the vertical scale in vertical units per division of the incoming waveform returned by the previous CURVe? command. Group Waveform Transfer Syntax WFMInpre:YMUlt <NR3> WFMInpre:YMUlt? Related Commands CH<x>:SCAle CURVe Arguments is the vertical scale factor in YUNits (usually volts) per division of the incoming waveform. DSA8300 Programmer Manual 2-375...
Page 392
Vertical Units = (Raw Data) * YSCALE + YZERO. Group Waveform Transfer Syntax WFMInpre:YSCALE <NR3> WFMInpre:YSCALE? Arguments is the value of the vertical scale factor. Note that the argument is always 1 when DATA:SOURCE is set to a math waveform. 2-376 DSA8300 Programmer Manual...
Page 393
WFMInpre:YZEro This command sets or queries the vertical offset voltage of the incoming waveform. Group Waveform Transfer Syntax WFMInpre:YZEro <NR3> WFMInpre:YZEro? Related Commands CH<x>:OFFSet Arguments is the vertical offset in volts of the incoming waveform. DSA8300 Programmer Manual 2-377...
Page 394
WFMOutpre:BIT_Nr? (Query Only) This query only command returns the number of bits (width) per waveform point of the waveform to be transferred from the instrument. NOTE. This instrument supports only a 32-bit format. Group Waveform Transfer Syntax WFMOutpre:BIT_Nr? 2-378 DSA8300 Programmer Manual...
Page 395
floating point binary. WFMOutpre:BYT_Nr? (Query Only) This query only command returns the byte width for the waveform to be transferred from the instrument. NOTE. This instrument supports only 4-byte data widths. Group Waveform Transfer DSA8300 Programmer Manual 2-379...
Page 396
This command sets or queries the type of encoding used for waveform data transferred with the CURVe? command. Using this command to change the type of encoding also changes the encoding set by the DATA:ENCdg command. Group Waveform Transfer 2-380 DSA8300 Programmer Manual...
Page 397
CURVe? command. The number of points returned is the lesser of the absolute value of (DATa:STOP - DATa:STARt) +1, or the record length of the source waveform specified by the DATa:SOUrce command. Group Waveform Transfer Syntax WFMOutpre:NR_Pt? Related Commands CURVe DATa:STOP DATa:STARt DATa:SOUrce DATa:TIMebase DSA8300 Programmer Manual 2-381...
Page 398
Waveform Transfer Syntax WFMOutpre:WFId? Examples might return WFMOUTPRE:WFID? WFMOUTPRE:WFID "C3, 100.0MV/DIV, 5.000NS, 500 POINTS, Sample mode" WFMOutpre:WFMLabel? (Query Only) This is query only command that returns the label for the previous waveform transferred by the CURVe? command. 2-382 DSA8300 Programmer Manual...
Page 399
CURVe? command. Group Waveform Transfer Syntax WFMOutpre:XMUlt? Related Commands HORizontal:MAIn:SCAle Examples might return WFMOUTPRE:XMULT? WFMOUTPRE:XMULT 5.00000000000E-006 indicating that the horizontal scale factor of the previously transferred waveform was set to 5 µs per division. DSA8300 Programmer Manual 2-383...
Page 400
WFMOutpre:XZEro? (Query Only) This is a query only command that returns the time of first point (sample) of the waveform returned by the previous CURVe? command. Group Waveform Transfer Syntax WFMOutpre:XZEro? 2-384 DSA8300 Programmer Manual...
Page 401
This is a query only command that returns the vertical position of the waveform returned by the previous CURVe? command. Group Waveform Transfer Syntax WFMOutpre:YOFf? Related Commands CH<x>:POSition Examples might return , indicating that the WFMOUTPRE:YOFF? WFMOUTPRE:YOFF 0 vertical position of the previously transferred waveform was at the centerline. DSA8300 Programmer Manual 2-385...
Page 402
, indicating that the WFMOUTPRE:YUNIT? WFMOUTPRE:YUNIT "V" vertical units of the previously transferred waveform were volts. WFMOutpre:YZEro? (Query Only) This is a query only command that returns the vertical offset of the waveform returned by the previous CURVe? command. 2-386 DSA8300 Programmer Manual...
Page 403
Commands Listed in Alphabetical Order Group Waveform Transfer Syntax WFMOutpre:YZEro? Related Commands CH<x>:OFFSet Examples might return WFMOUTPRE:YZERO 1.00000000000E-001 WFMOUTPRE:YZERO? indicating that the vertical offset of the previously transferred waveform was 100 mV. DSA8300 Programmer Manual 2-387...
Page 404
Commands Listed in Alphabetical Order 2-388 DSA8300 Programmer Manual...
Page 407
SESR register. Reading the register clears the bits of the register so that the register can accumulate information about new events. NOTE. TekVISA applications use SESR bit 6 to respond to any of several events, including some front panel actions. DSA8300 Programmer Manual...
Page 408
Master Status Summary. Obtained from *STB? query. Summarizes the ESB and MAV bits in the SBR. Event Status Bit. Shows that status is enabled and present in the SESR. Message Available. Shows that output is available in the Output Queue. DSA8300 Programmer Manual...
Page 409
Use the *SRE command to set the SRER. Use the *SRE? query to read the register. The RQS bit remains set to one until either the Status Byte Register is read with a Serial Poll or the MSS bit changes back to a zero. DSA8300 Programmer Manual...
Page 410
EVMSG? query (which returns the event number and a text description of the event), or with the ALLEV? query (which returns all the event numbers along with a description of the event). Reading an event removes it from the queue. DSA8300 Programmer Manual...
Page 411
When an event occurs, a signal is sent to the DESER (1). If that type of event is enabled in the DESER (that is, if the bit for that event type is set to 1), the appropriate bit in the SESR is set to one, and the event is recorded in the Event DSA8300 Programmer Manual...
Page 412
DATA:STOP 500 DATA:ENCDG RIBINARY /** Clear data and acquire waveforms until conditional stop occurs**/ ACQUIRE:DATA:CLEAR ACQUIRE:STATE ON /** Synchronize the operations by using *WAI, Busy?, *OPC, or *OPC?/ <Synchronization command> /** Get the curve data **/ CURVE? DSA8300 Programmer Manual...
Page 413
DATA:STOP 500 DATA:ENCDG RIBINARY /** Clear data and then acquire waveforms until conditional stop occurs**/ ACQUIRE:DATA:CLEAR ACQUIRE:STATE ON /** Wait until the acquisition is complete before querying the curve data**/ *WAI /** Get the curve data **/ DSA8300 Programmer Manual...
Page 414
If the corresponding status registers are enabled, the *OPC command sets the OPC bit in the Standard Event Status Register (SESR) when an operation is complete. You achieve synchronization by using this command with either a serial poll or service request handler. DSA8300 Programmer Manual...
Page 415
Enable Register (SRER) using the *SRE command. When the operation is complete, a Service Request will be generated. The same command sequence using the *OPC command for synchronization looks like this: /** Sets up conditional acquisition **/ DSA8300 Programmer Manual...
Page 416
/** Sets up conditional acquisition **/ ACQUIRE:STATE OFF SELECT:CH1 ON HORIZONTAL:RECORDLENGTH 500 ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER:COUNT 1 ACQUIRE:STOPAFTER:MODE CONDITION /** Set up measurement parameters **/ MEASUREMENT:MEAS1:TYPE AMPLITUDE EASUREMENT:MEAS1:SOURCE CH1 /** Clear data, and then acquire waveforms until conditional stop occurs**/ 3-10 DSA8300 Programmer Manual...
Page 417
Check that the command is properly formed and that it follows the rules in the section on Command Syntax. Table 3-4: Command Error Messages (CME Bit 5) Code Message Command error Invalid character Syntax error DSA8300 Programmer Manual 3-11...
Page 418
String data not allowed Block data error Invalid block data Block data not allowed Expression error Invalid expression Expression data not allowed Execution Error The following table lists the execution errors that are detected during execution of a command. 3-12 DSA8300 Programmer Manual...
Page 419
Missing media Corrupt media Media full Directory full File name not found File name error Media protected Expression error Math error in expression Program runtime error 2200 Measurement error, Measurement system error 2201 Measurement error, Zero period DSA8300 Programmer Manual 3-13...
Page 420
Math error, Out of acquisition memory 2241 Waveform request is invalid 2243 This measurement cannot be performed on this type of waveform 2244 Source waveform is not active 2245 Saveref error, Selected channel is turned off 3-14 DSA8300 Programmer Manual...
Page 421
Clock Recovery not available 2504 Record length incompatible with scale 2505 Autoset Execute Warning – No waveforms enabled 2506 Error saving waveform to file 2507 FrameScan and Average Complete incompatible 2508 Selected filter is not available DSA8300 Programmer Manual 3-15...
Page 422
Autoset warning, Nothing to autoset 2542 Autoset error, Signal offset out of range 2543 Autoset error, Trigger not found 2544 Autoset error, Trigger Amplitude too small 2545 Autoset error, Signal Amplitude too small 2546 Autoset error, Signal Amplitude too large 3-16 DSA8300 Programmer Manual...
Page 423
2585 Phase Ref Untriggered mode is not compatible with Clock trigger source Device Error The following table lists the device errors that can occur during instrument operation. These errors may indicate that the instrument needs repair. DSA8300 Programmer Manual 3-17...
Page 424
The following table lists warning messages that do not interrupt the flow of command execution. These notify you that you may get unexpected results. Table 3-8: Execution Warning Messages (EXE Bit 4) Code Message Execution warning String data too long, truncated Parameter underrange Parameter overrange Parameter rounded 3-18 DSA8300 Programmer Manual...
Page 425
Measurement warning, Clipping positive/negative Measurement warning, Clipping positive Measurement warning, Clipping negative Internal Warning The following table shows internal errors that indicate an internal fault in the instrument. Table 3-9: Internal Warning Messages Code Message Internal warning DSA8300 Programmer Manual 3-19...
Page 426
Status and Events 3-20 DSA8300 Programmer Manual...
Programming Examples The DSA8300 comes with sample programs that illustrate methods that you can use to control the instrument from the GPIB interface. The programs were written in Microsoft Visual C++, version 6.0, and were generated using the AppWizard program. Both program listings and source codes are included on the product software CD-ROM that comes with your instrument.
Page 430
Samples directory containing the programs. 2. Navigate to the Programs directory contained in the Samples directory. 3. Open the program file in your favorite editor or IDE, and copy the code you want into your programs. DSA8300 Programmer Manual...
Table D-2: Interface Functions Interface Function Subset Meaning Acceptor Handshake The instrument can receive multiline messages across the interface from other devices. Controller Controller capability, the instrument can control other devices. DSA8300 Programmer Manual...
Page 448
ATN line asserted. The instrument also ceases to be a talker when it detects the talk address of another device being sent over the data lines with ATN asserted. DSA8300 Programmer Manual...
Need help?
Do you have a question about the DSA8300 and is the answer not in the manual?
Questions and answers