VNA. TekVISA Programmer Manual (Tektronix part number 077-0140-XX) This manual is available as a printable PDF file on the Tektronix web site (www.tek.com). The manual describes TekVISA, the Tektronix implementation of the VISA Application Programming Interface (API).
Page 8
Preface DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Page 11
Overview of the Manual Summarizes each major section of this manual. Using TekVISA Describes how to use the TekVISA communication protocol to communicate with the VNA to a programmatic interface. DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
The program may request information from the instrument. The instrument provides information in the form of status and error messages. Status and Events describes how to get status or event information from the program and details the event and error messages. DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Install TekVISA Install TekVISA You must install the Tektronix Virtual Instrument Software Architecture (TekVISA) on your PC: To communicate to VectorVu-PC to a programmatic interface. TekVISA is the Tektronix implementation of VISA (Virtual Instrument Software Architecture), an industry-standard communication protocol.
2. Once the software has installed, the InstallShield Wizard prompts you to install TekVisa as well. Proceed with this installation: 3. Install the Tektronix Power Meter applications next. 4. Click Finish to complete the installation. Enable control over the Ethernet TekVISA supports communication with VectorVu-PC over an Ethernet LAN connection.
5. In the next window, select Manual Entry of Raw Socket. 6. In the LAN resource details window, enter: Hostname: localhost or 127.0.0.1 Port number: 5026 7. Click Validate. A popup window validates the connection: DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Page 16
Network Devices in the left pane. 9. Click on the TTR500 device connection. In the right pane, the Settings tab displays the connection information you entered. You can create an alias for this connection for future use: DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
2. Under VXI-11 Server, check Start server on system power up: 3. Restart the machine. 4. Open NI-VISA and VectorVu-PC. 5. Right click Network Devices in NI-VISA and select Create new VISA/TCP-IP Resource: DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Page 18
Connect with NI-VISA and LabVIEW 6. Select Auto-detect of LAN Instrument and click Next: NI-VISA should detect VectorVu-PC to enable the LabVIEW interface. DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
The SCPI language is based on a hierarchical or tree structure, which represents a subsystem, as shown in the following figure. The top level of the tree is the root node; it is followed by one or more lower-level nodes: DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Page 22
(boolean). Some parameter types are defined specifically for the VNA Series command set and some are defined by ANSI/IEEE 488.2-1987 as shown on the following table: DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Page 23
You can create a short form by using only the upper case letters, as shown in the next figure. The accepted short form and the long form are equivalent and request the same action of the instrument: DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Page 24
In the following figure, the second, third, and fourth commands have the same root node (SENSe1:SWEep) as the first command, so these nodes can be omitted. DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Page 25
170 mHz, 170 Mhz, 170 MHz, etc. 250 mv, 250 mV, 250 MV, etc. General Rules Here are three general rules for using SCPI commands, queries, and parameters: DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
IEEE 488.2 Common commands Description ANSI/IEEE Standard 488.2 defines the codes, formats, protocols, and usage of common commands and queries used on the interface between the controller and the instruments. The analyzer complies with this standard. DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
If the numeric suffix is omitted, the analyzer uses the default value of "1". Item Description MARKer<x> Marker specifier where <x> = 1–9 See Marker Mnemonics. TRACe<x> Trace specifier where <x> = 1–16 CHANnel<x> Channel specifier where <x> = 1–16 DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
For the conventions of notation in this manual, refer to Command Syntax and following pages. Functional groups The SCPI commands for the TTR500 series VNA are divided into these functional groups, based on the action they perform: Group Function ABORt Resets trigger system and stops measurements.
Abort commands Abort commands Use Abort commands to stop current measurements for all channels. Command Description ABORt Abort current measurement for all channels. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-11...
The bandwidth test must be enabled using CALCulate<x>:[SELected]:BLIMit: [STATe] to properly use this command. The bandwidth test returns a value in power sweep. DRAFT – 01/24/2019 2-12 TTR500 Series Programmer Manual...
Page 33
To set this command, you must set the same number of points as the number of points contained on the active trace. CALCulate<x>:[SELected]:FORMat Set or query the data format of the active trace on the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-13...
Page 34
CALCulate<x>:[SELected]:FUNCtion:PEXCursion Set or query the lower limit (in Hz) of the peak excursion value when performing a peak search using CALCulate<x>:[SELected]:FUNCtion: EXECute for the active trace on the specified channel. DRAFT – 01/24/2019 2-14 TTR500 Series Programmer Manual...
Page 35
(in Hz) for the limit line test of the active trace on the specified channel. CALCulate<x>:[SELected]:LIMit:OFFSet:MARKer Set the amplitude offset value to the active marker value for the limit line test of the active trace on the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-15...
Page 36
CALCulate<x>:[SELected]:MARKer<y>: Set or query an arbitrary or entire FUNCtion:DOMain:[STATe] sweep range for a marker search on the specified marker of the active trace of on the specified channel. DRAFT – 01/24/2019 2-16 TTR500 Series Programmer Manual...
Page 37
CALCulate<x>:[SELected]:MARKer<y>: Set or query the state of the marker FUNCtion:TRACking tracking for a marker search, using the specified marker of the active trace on the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-17...
Page 38
MEMorize for the active trace on the specified channel. Display the math result on the data trace. CALCulate<x>:[SELected]:MATH:MEMorize Copy the measurement data to the memory trace of the active trace on the specified channel. DRAFT – 01/24/2019 2-18 TTR500 Series Programmer Manual...
Page 39
CALCulate<x>:[SELected]:PHASe Set or query the phase unit used for data formats PHASe, UPHase, and PPHase (CALCulate<x>:[SELected]: FORMat) for the active trace on the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-19...
Before operating the marker, you have to enable it using the CALCulate basic commands. If you attempt to use a marker other than the above markers in a CALCulate command, the suffix error (error code -130) occurs. DRAFT – 01/24/2019 2-20 TTR500 Series Programmer Manual...
To store the memory trace of the specified trace, use CALCulate<x>:[SELected]:MATH: MEMorize. DISPlay:CHANnel<x>:TRACe<y>:[STATe] Set or query the status of the display for the data trace on the specified trace for the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-21...
Page 42
DISPlay:GRAPh<x>:[ACTivate]:CHANnel Set the specified channel to the specified graph, only if the channel layout displays the corresponding specified graph value and the specified channel value is enabled. DRAFT – 01/24/2019 2-22 TTR500 Series Programmer Manual...
Page 43
Set or query the status for the display of the data trace for the specified trace on the specified channel. DISPlay:UPDate:[IMMediate] Execute a single, immediate update of the display when DISPlay:ENABle has set updates to 0. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-23...
When you execute this command for a channel that is not idle (with hold or continuous mode enabled), an error occurs. DRAFT – 01/24/2019 2-24 TTR500 Series Programmer Manual...
file is not loaded. MMEMory:LOAD:[STATe] Load the specified instrument state file. Make sure the CSV file exists at the provided file path as no notification is provided if the file is not loaded. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-25...
Page 46
CSV file for the specified port. Make sure the CSV file exists at the provided file path as no notification is provided if the file is not loaded. DRAFT – 01/24/2019 2-26 TTR500 Series Programmer Manual...
Page 47
Make sure the CSV file exists at the provided file path as no notification is provided if the file is not loaded. The SnP format is not automatically appended to the file name. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-27...
Page 48
Save the state of the instrument to the specified state file. Make sure the CSV file exists at the provided file path as no notification is provided if the file is not loaded. DRAFT – 01/24/2019 2-28 TTR500 Series Programmer Manual...
If you omit the directory path, the default path is used, which is C:\Program Files\Tektronix\VectorVu-PC initially. Once a file is saved to a different directory, the new directory will be used as the default for all load and store operations. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-29...
Use OUTPut commands to control the characteristics of the signal output. Description Command OUTPUT:[STATe] Set or query the stimulus signal output. You can only make measurements when the signal output is enabled. DRAFT – 01/24/2019 2-30 TTR500 Series Programmer Manual...
(short) of the specified port. SENSe<x>:CORRection:COEFficient:METHod: Set the calibration type for the specified RESPonse:THRU channel to the same response calibration thru of the specified port (input or output). DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-31...
Page 52
SENSe<x>:CORRection:COLLect:[ACQuire]: Measure the calibration data of the thru THRU standard from the specified stimulus port to the specified response port for the specified channel. DRAFT – 01/24/2019 2-32 TTR500 Series Programmer Manual...
Page 53
SENSe<x>:CORRection:COLLect: CKIT: STAN<y>:TYPE. SENSe<x>:CORRection:COLLect:CKIT:ORDer: Set or query a subclass for calibration [SELect] from the subclass menu for the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-33...
Page 54
Set or query the type of media for the CHARacter specified calibration kit standard for the specified channel. SENSe<x>:CORRection:COLLect:CKIT:STAN<y>: Set or query the offset delay for the DELay specified calibration kit standard for the specified channel. DRAFT – 01/24/2019 2-34 TTR500 Series Programmer Manual...
Page 55
Set or query the label of the specified LABel calibration kit standard for the specified channel. SENSe<x>:CORRection:COLLect:CKIT:STAN<y>: Set or query the offset loss for the LOSS specified calibration kit standard for the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-35...
Page 56
SENSe<x>:CORRection:COLLect:PARTial:SAVE Use the partial overwrite function and recalculate calibration coefficients depending on the type of calibration and data measured. This action clears all measured data and the selection for calibration type. DRAFT – 01/24/2019 2-36 TTR500 Series Programmer Manual...
Page 57
SENSe<x>:FREQuency:CENTer Set or query the center frequency value of the sweep range for the specified channel. SENSe<x>:FREQuency:CW Set or query the CW frequency value of the sweep range of the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-37...
Page 58
IF BW and the number of measurement points. SENSe<x>:SWEep:TYPE Set or query the sweep type for the selected channel. SENSe<x>:SWEep:GENeration Set or query the sweep mode of the specified channel. DRAFT – 01/24/2019 2-38 TTR500 Series Programmer Manual...
SERVice:CHANnel:ACTive Read the number of the active channel. SERVice:CHANnel<x>:COUNt Display the number of enabled channels. SERVice:CHANnel<x>:TRACe:ACTive? Display the active trace for the specified channel. SERVice:CHANnel:TRACe:COUNt? Display the number of traces per channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-39...
Set or query the touchstone file name that describes the DUT. SIMulator:NF Set or query the noise floor value for simulator mode. SIMulator:RCF Set or query the RCF value for the instrument. DRAFT – 01/24/2019 2-40 TTR500 Series Programmer Manual...
COLLect:TABLe:LOSS:DATA the loss compensation table for the active power sensor at the specified port of the specified channel. SOURce<x>:POWer:PORT<y>:CORRection: Set or query the loss compensation for COLLect:TABLe:LOSS:[STATe] the specified port and channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-41...
Page 62
Set or query the starting value of the sweep range for the power sweep on the specified channel. SOURce<x>:POWer:STOP Set or query the stopping value of the sweep range for the power sweep of the specified channel. DRAFT – 01/24/2019 2-42 TTR500 Series Programmer Manual...
Register for the specified channel. For traces 15-16, bits 0-1 use 0 for no event occurred and 1 for an event based on the transition type used for the bandwidth limit test. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-43...
Page 64
1 to 0. This occurs during the bandwidth limit test, when the test result transitions from pass (0) to fail (1). Traces 1-14 are only used to represent bits 1-14 DRAFT – 01/24/2019 2-44 TTR500 Series Programmer Manual...
Page 65
15-16. Bits used are 0-1, while bits 2 and 15 are always 0. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-45...
Page 66
1 to 0. This occurs during the limit test, when the test result transitions from fail (1) to pass (0). Traces 1-14 are only used to represent bits 1-14. DRAFT – 01/24/2019 2-46 TTR500 Series Programmer Manual...
Page 67
Register. You cannot set bits 0 and 3–15 to 1. STATus:QUEStionable:PTRansition Set or query the value of the positive transition filter of the Questionable Status Register for the specified channel. You cannot set bits 0 and 3–15 to 1. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-47...
Page 68
(0) to fail (1). Traces 15-16 are only used, representing bits 0-1. STATus:QUEStionable:RLIMit:CHANnel<x>: Set or query the value of the Questionable ENABle Ripple Limit Channel Status Enable Register for the specified channel. DRAFT – 01/24/2019 2-48 TTR500 Series Programmer Manual...
Page 69
0 and 3–15 to 1. STATus:QUEStionable:RLIMit:PTRansition Set or query the value of the positive transition filter of the Questionable Ripple Limit Status Register. You cannot set bits 0 and 3–15 to 1. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-49...
SYSTem:PRESet:MODE Set or query the preset mode for the TTR500 instrument. SYSTem:SERVice? Query the operating mode (normal or service mode) for the TTR500 instrument. DRAFT – 01/24/2019 2-50 TTR500 Series Programmer Manual...
Page 71
Set or query the state of the stacking timing test for the TTR500 instrument. SYSTem:TEMPerature:DATA? Query the temperature sensor data for the TTR500 instrument. SYSTem:TIMing:DATA Set or query the stacking timing test data for the TTR500 instrument. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-51...
The trigger function requires VectorVu-PC to have an active connection to a TTR500 unit. The trigger function does not work in simulator mode. TRIGger:[SEQuence]:SOURce Set or query the source for the trigger. DRAFT – 01/24/2019 2-52 TTR500 Series Programmer Manual...
You can use the MAV bit of the Status Byte Register (SBR) to check whether the Output Queue contains a response message. For details, refer to Status Byte Register (SBR). DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-53...
3, as the number of traces displayed on channel CALC2:PAR:COUNt? sets 2 traces to show on channel 3. CALC3:PAR:COUNt 2 CALCulate<x>:PARameter<y>:DEFine Set or query a measurement parameter of the specified trace on the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-55...
Page 76
1 or 2 Examples sets the receiver port 2 of trace 3 on channel 1. CALC1:PAR3:RPOR 2 may return 1, which is the receiver port number of trace 1 CALC3:PAR1:RPOR? on channel 3. DRAFT – 01/24/2019 2-56 TTR500 Series Programmer Manual...
Page 77
1 or 2 Examples sets source port 1 of trace 2 on channel 4. CALC4:PAR2:SPOR 1 may return 2, which is the source port number of trace 3 CALC1:PAR3:SPOR? on channel 1. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-57...
Page 78
1 means the marker for the bandwidth test shows. 0 means the marker for the bandwidth test is hidden. Examples enables the display of the marker for the CALC1:SEL:BLIM:DISP:MARK 1 bandwidth test for the active trace on channel 1. DRAFT – 01/24/2019 2-58 TTR500 Series Programmer Manual...
Page 79
2. CALCulate<x>:[SELected]:BLIMit:FAIL? (Query Only) Query the result for the bandwidth test of the active trace on the specified channel. Group Calculate commands Syntax CALCulate<x>:[SELected]:BLIMit:FAIL? Related Commands CALCulate<x>:[SELected]:BLIMit:[STATe] DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-59...
Page 80
3. CALCulate<x>:[SELected]:BLIMit:MINimum Set or query the lower limit value (in Hz) for the bandwidth test in the active trace for the specified channel. DRAFT – 01/24/2019 2-60 TTR500 Series Programmer Manual...
Page 81
Command variables. <x> is the channel number (1 to 16). <NRf> Range: 0 to 6e9 mdB Examples may return 5e8, which means 0.5 GHz is the CALC1:SEL:BLIM:REP:DATA? bandwidth value for the bandwidth test set for the active trace on channel 1. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-61...
Page 82
Related Commands CALCulate<x>:[SELected]:CORRection:EDELay:TIME CALCulate<x>:[SELected]:CORRection:EDELay:WGCutoff Arguments Command variables. <x> is the channel number (1 to 16). sets a coaxial medium for the electrical delay. COAXial sets a waveguide medium for the electrical delay. WAVeguide DRAFT – 01/24/2019 2-62 TTR500 Series Programmer Manual...
Page 83
5 seconds for the CALC1:SEL:CORR:EDEL:TIME 5 active trace on channel 1. may return -3, which means -3 seconds is the CALC4:SEL:CORR:EDEL:TIME? electrical delay set for the active trace on channel 4. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-63...
Page 84
Set or query the phase offset of the active trace on the specified channel. If the specified phase offset is outside the range, the minimum or maximum offset is set accordingly. Group Calculate commands Syntax CALCulate<x>:[SELected]:CORRection:OFFSet:PHASe <value> CALCulate<x>:[SELected]:CORRection:OFFSet:PHASe? DRAFT – 01/24/2019 2-64 TTR500 Series Programmer Manual...
Page 85
Polar formats, however, contain an auxiliary response value. Returns [numeric1],[numeric2],[numeric3],...[numeric600] Examples may return 1.52, 0,0.905 , 0, if the active trace on CALC1:SEL:DATA:FDATa? channel 1 has only two measurement points and the display format is set to log magnitude. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-65...
Page 86
Command variables. <x> is the channel number (1 to 16). is the raw data array of NP*2 for any value n between 1 <value>::=<NRf> and NP, where: is the data real value at then measurement point. Data(n*2–1) DRAFT – 01/24/2019 2-66 TTR500 Series Programmer Manual...
Page 87
1 has only 2 measurement points and the display format is set to log magnitude. CALCulate<x>:[SELected]:DATA:SMEMory? (Query Only) Query the corrected memory array for the active trace on the specified channel. Group Calculate commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-67...
Page 88
Select one of the following arguments: Argument Description MLOGarithmic Log magnitude PHASe Phase GDELay Group delay SLINear Smith chart (Linear/Phase) SLOGarithmic Smith chart (Log/Phase) SCOMplex Smith chart (Real/Imaginary) SMITh Smith chart (R+jX) SADMittance Smith chart (G+jB) DRAFT – 01/24/2019 2-68 TTR500 Series Programmer Manual...
Page 89
CALCulate<x>:[SELected]:FUNCtion:TYPE specified channel. Group Calculate commands Syntax CALCulate<x>:[SELected]:FUNCtion:DATA? Related Commands CALCulate<x>:[SELected]:FUNCtion:EXECute CALCulate<x>:[SELected]:FUNCtion:TYPE CALCulate<x>:[SELected]:FUNCtion:POINts? Returns Command variables. <x> is the channel number (1 to 16). is the data array [numeric1],[numeric2],[numeric3],..[numericn*2] NP*2. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-69...
Page 90
0, which means the analysis range is CALC2:SEL:FUNC:DOM:COUP? decoupled to all traces on channel 2. CALCulate<x>:[SELected]:FUNCtion:DOMain:STARt Set or query the starting stimulus value for the arbitrary analysis range (in Hz) used by for the specified CALCulate<x>:SELected]:FUNCtion:EXECute DRAFT – 01/24/2019 2-70 TTR500 Series Programmer Manual...
Page 91
Set or query whether to use an arbitrary range or an entire sweep range on the specified channel, when executing the analysis with CALCulate<x>:[SELected]:FUNCtion:EXECute Group Calculate commands Syntax CALCulate<x>:[SELected]:FUNCtion:DOMain:[STATe] <value> CALCulate<x>:[SELected]:FUNCtion:DOMain:[STATe]? Related Commands CALCulate<x>:[SELected]:FUNCtion:EXECute CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:DOMain:STARt DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-71...
Page 92
CALCulate<x>:[SELected]:FUNCtion:DOMain:STARt CALCulate<x>:[SELected]:FUNCtion:DOMain:[STATe] CALCulate<x>:[SELected]:FUNCtion:DOMain:COUPle Arguments Command variables. <x> is the channel number (1 to 16). is the stopping stimulus value for the arbitrary analysis <value>::=<NRf> range. Range: 1e5 to 6e9 Hz. Returns <NRf> DRAFT – 01/24/2019 2-72 TTR500 Series Programmer Manual...
Page 93
Set or query the lower limit (in Hz) of the peak excursion value when performing a peak search using for the CALCulate<x>:[SELected]:FUNCtion:EXECute active trace on the specified channel. Group Calculate commands Syntax CALCulate<x>:[SELected]:FUNCtion:PEXCursion <value> CALCulate<x>:[SELected]:FUNCtion:PEXCursion? Related Commands CALCulate<x>:[SELected]:FUNCtion:PPOLarity DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-73...
Page 94
1. CALCulate<x>:[SELected]:FUNCtion:PPOLarity Set or query the polarity of the peak excursion search when performing a peak search using for the active CALCulate<x>:[SELected]:FUNCtion:EXECute trace on the specified channel. DRAFT – 01/24/2019 2-74 TTR500 Series Programmer Manual...
Page 95
Set or query a target value (in Hz) for the target search when using for the active trace on CALCulate<x>:[SELected]:FUNCtion:EXECute the specified channel. Group Calculate commands Syntax CALCulate<x>:[SELected]:FUNCtion:TARGet <value> CALCulate<x>:[SELected]:FUNCtion:TARGet? Related Commands CALCulate<x>:[SELected]:FUNCtion:TTRansition CALCulate<x>:[SELected]:FUNCtion:TYPE DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-75...
Page 96
BOTH Returns means the target transition is positive. POSitive means the target transition is negative. NEGative means it is the target transition for positive and negative peaks. BOTH DRAFT – 01/24/2019 2-76 TTR500 Series Programmer Manual...
Page 97
PTPeak Difference between max. and min. values STDEV Standard deviation MEAN Mean value MAXimum Max. value MINimum Min. value PEAK Max. positive or min. negative peak APEak All peaks ATARget All targets DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-77...
Page 98
Supposed range is based on UI: -200 to 200 of start point of line n. numeric1+(n*5) Y coordinate of end point of line n. Range: 3e5 to 6e9 Returns See Arguments. DRAFT – 01/24/2019 2-78 TTR500 Series Programmer Manual...
Page 99
0, which means the limit line is CALC4:SEL:LIM:DISP:STA? disabled for the active trace on channel 4. CALCulate<x>:[SELected]:LIMit:FAIL? (Query Only) Query the limit test result for the active trace on the specified channel. Group Calculate commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-79...
Page 100
0.3 GHz for CALC1:SEL:LIM:OFFS:AMPL 3e8 the active trace on channel 1. may return -4e8, which means -0.4 GHz is the CALC3:SEL:LIM:OFFS:AMPL? amplitude offset value set for the active trace on channel 3. DRAFT – 01/24/2019 2-80 TTR500 Series Programmer Manual...
Page 101
Range: -1e12 to 1e12 Hz. <value>::=<NRf> Returns <NRf> Examples sets 100 MHz for the value of the limit line CALC1:SEL:LIM:OFFS:STIM 1e8 stimulus offset for the active trace on channel 1. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-81...
Page 102
(upper limit). The second point at 5e9 passed because its amplitude was lower than -100 dB. CALCulate<x>:[SELected]:LIMit:REPort:DATA? (Query Only) Query the stimulus values of all measurement points that failed the limit test for the active trace on the specified channel. Group Calculate commands DRAFT – 01/24/2019 2-82 TTR500 Series Programmer Manual...
Page 103
1. CALCulate<x>:[SELected]:LIMit:[STATe] Set or query the status of the limit test for the active trace on the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-83...
Page 104
0, unless the plot format is Smith Chart or Polar. Examples may return -109.907,0 for the marker response value of CALC1:SEL:MARK1:Y? marker 1 for the active trace on channel 1, if the format for channel 1 is set to Logarithmic Magnitude. DRAFT – 01/24/2019 2-84 TTR500 Series Programmer Manual...
Page 105
Command variables. <x> is the channel number (1 to 16); <y> is the marker number (1 to 10). NOTE. The query in this command may return nothing if it does not find any data in bandwidth (Hz). [numeric1],[numeric2],[numeric3],[numeric4] where: DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-85...
Page 106
CALC1:SEL:MARK1:BWID:STAT 1 marker 1 of the active trace for channel 1. may return 0, which means the bandwidth CALC5:SEL:MARK4:BWID:STAT? search results are disabled for marker 4 of the active trace for channel 5. DRAFT – 01/24/2019 2-86 TTR500 Series Programmer Manual...
Page 107
Syntax CALCulate<x>:[SELected]:MARKer<y>:COUPle <value> CALCulate<x>:[SELected]:MARKer<y>:COUPle? Arguments Command variables. <x> is the channel number (1 to 16); <y> is the marker number (1 to 10). <value>::=<boolean> Returns 1 means marker coupling is turned on. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-87...
Page 108
Set or query the state of the marker search range for the specified marker to coupled or decoupled to all traces or only to the active trace for the specified channel. Group Calculate commands DRAFT – 01/24/2019 2-88 TTR500 Series Programmer Manual...
Page 109
The arbitrary marker search range is set by CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:DOMain:[STATe] Group Calculate commands Syntax CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:DOMain:STARt <value> CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:DOMain:STARt? Related Commands CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:DOMain:COUPle CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:DOMain:[STATe] CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:DOMain:STOP DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-89...
Page 110
1 means the arbitrary range is set for marker search. 0 means the entire sweep range is set for marker search. Examples sets an arbitrary range for a search on CALC1:SEL:MARK1:FUNC:DOM:STAT 1 marker 1 of the active trace for channel 1. DRAFT – 01/24/2019 2-90 TTR500 Series Programmer Manual...
Page 111
Set or query the lower limit of the peak excursion value when executing a peak excursion search for the specified marker of the active trace on the specified channel. Group Calculate commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-91...
Page 112
Set or query the polarity for a peak excursion search for the specified marker of the active trace for the specified channel. Group Calculate commands Syntax CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:PPOLarity { POSitive | NEGative | BOTH } CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:PPOLarity? Related Commands CALCulate<x>:[SELected]:MARKer<y>FUNCtion:TYPE CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:PEXCursion CALCulate<x>[SELected]:MARKer<y>:FUNCtion:EXECute DRAFT – 01/24/2019 2-92 TTR500 Series Programmer Manual...
Page 113
Command variables. <x> is the channel number (1 to 16); <y> is the marker number (1 to 10). is the target value specified for the target search. Range: <value>::=<NRf> -5e8 to 5e8 (Hz). Returns <NRf> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-93...
Page 114
2 of the active trace on channel 3. CALCulate<x>:[SELected]:MARKer<y>:FUNCtion:TTRansition Set or query the transition type used during a target search for the specified marker on the active trace for the specified channel. Group Calculate commands DRAFT – 01/24/2019 2-94 TTR500 Series Programmer Manual...
Page 115
2 of the active trace on channel 4. CALCulate<x>:[SELected]:MARKer<y>:NOTCh:DATA? (Query Only) Query the results from a notch search using the specified marker of the active trace on the specified channel. Group Calculate commands Syntax CALCulate<x>:[SELected]:MARKer<y>:NOTCh:DATA? Related Commands CALCulate<x>:[SELected]:MARKer<y>:NOTCh:[STATe] CALCulate<x>:[SELected]:MARKer<y>:NOTCh:THReshold DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-95...
Page 116
1 of CALC1:SEL:MARK1:NOTC:STAT 1 the active trace on channel 1. may return 0, which means the notch search is CALC2:SEL:MARK2:NOTC:STAT? turned off for marker 2 of the active trace on channel 2. DRAFT – 01/24/2019 2-96 TTR500 Series Programmer Manual...
Page 117
Group Calculate commands Syntax CALCulate<x>:[SELected]:MARKer<y>:REFerence:[STATe] <value> CALCulate<x>:[SELected]:MARKer<y>:REFerence:[STATe]? Arguments Command variables. <x> is the channel number (1 to 16); <y> is the marker number (1 to 9). DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-97...
Page 118
1. If marker 1 on the active trace has a stimulus value of 4 GHz, the center frequency for channel 1 becomes 4 GHz. DRAFT – 01/24/2019 2-98 TTR500 Series Programmer Manual...
Page 119
Command variables. <x> is the channel number (1 to 16); <y> is the marker number (1 to 10). is the marker stimulus value. Range: Sweep start to sweet <value>::=<NRf> stopping values (Hz). DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-99...
Page 120
Argument Description Maximum Find max. peak MINimum Find min. peak. PEAK Find peak. LPEak Find peaks to left of marker position. RPEak Find peaks to right of marker position. TARGet Find target. DRAFT – 01/24/2019 2-100 TTR500 Series Programmer Manual...
Page 121
NORMal Data Only, No Math DIVide Data/Memory MULTiply Data x Memory Data - Memory SUBTract Data + Memory is the measurement data. Data is the data stored in the memory trace. Memory DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-101...
Page 122
Calculate commands Syntax CALCulate<x>:[SELected]:PHASe { DEGrees | RADians } CALCulate<x>:[SELected]:PHASe? Related Commands CALCulate<x>:[SELected]:FORMat Arguments Command variables. <x> is the channel number (1 to 16). where <value>::=<string> sets the phase unit to degrees. DEGrees DRAFT – 01/24/2019 2-102 TTR500 Series Programmer Manual...
Page 123
1, with a range from 1e5 to 6e9 at 10 dB. The second ripple line is inactive with a range from 2e7 to 5e7 at 7 dB. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-103...
Page 124
Set or query the ripple limit band that shows the value of the ripple test result for the active trace on the specified channel. Set the display value for the ripple limit band with CALCulate<x>:[SELected]:RLIMit:DISPlay:VALue Group Calculate commands DRAFT – 01/24/2019 2-104 TTR500 Series Programmer Manual...
Page 125
Returns means the ripple value is hidden on the active trace. means the ripple value display is absolute. ABSolute means a margin is set for the display of the ripple value. MARgin DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-105...
Page 126
Command variables. <x> is the channel number (1 to 16). This query returns an array of data of 1+n*3, where n is the number of limit lines (1 to 12): is the number of ripple limit lines. DRAFT – 01/24/2019 2-106 TTR500 Series Programmer Manual...
Page 127
0, which means the ripple test is disabled CALC2:SEL:RLIM:STAT? for the active trace on channel 2. CALCulate<x>:[SELected]:SMOOthing:APERture Set or query the smoothing aperture percentage of the sweep span for the active trace on the specified channel. Group Calculate commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-107...
Page 128
Examples enables the smoothing aperture for the active trace CALC1:SEL:SMO:STAT 1 on channel 1. may return 0, which means the smoothing aperture is CALC2:SEL:SMO:STAT? disabled for the active trace on channel 2. DRAFT – 01/24/2019 2-108 TTR500 Series Programmer Manual...
Page 129
*CLS command is executed. For a complete discussion of these registers and bits, and of event handling in general, refer to the Status and Events section. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-109...
Page 130
DISPlay:CHANnel<x>:[ACTivate] (No Query Form) Set the channel for the active graph set by DISPlay:GRAPh<x>:[ACTivate] Command variables. <x> is the channel number (1 to 16). Group Display commands Syntax DISPlay:CHANnel<x>:[ACTivate] DRAFT – 01/24/2019 2-110 TTR500 Series Programmer Manual...
Page 131
1 for channel 2. may return 0, which means you can DISP:CHAN3:ANN:MARK:ALIG:STAT? position the marker information for each trace in a different part of the graph for channel 3. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-111...
Page 132
Set or query the state of the display of the vertical axis label on the specified graph and channel. Group Display commands Syntax DISPlay:CHANnel<x>:LABel <value> DISPlay:CHANnel<x>:LABel? Related Commands DISPlay:GRAPh<x>:[ACTivate]:LABel Arguments Command variables. <x> is the channel number (1 to 16). <value>::=<boolean> DRAFT – 01/24/2019 2-112 TTR500 Series Programmer Manual...
Page 134
Related Commands DISPlay:SPLit Arguments Command variables. <x> is the channel number (1 to 16). Select one of the arguments. Each argument correlates to one of these graph display layouts: Returns See Arguments. DRAFT – 01/24/2019 2-114 TTR500 Series Programmer Manual...
Page 135
Set or query the state of the display of the label title for the specified channel. Group Display commands Syntax DISPlay:CHANnel<x>:TITLe:[STATe] <value> DISPlay:CHANnel<x>:TITLe:[STATe]? Arguments Command variables. <x> is the channel number (1 to 16). <value>::=<boolean> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-115...
Page 136
Set or query the position of the marker value on the Y-axis, using a percentage of the width of the display span for the specified trace on the specified channel. Group Display commands DRAFT – 01/24/2019 2-116 TTR500 Series Programmer Manual...
Page 137
0 means the memory trace is turned off. 1 means the memory trace is turned on. Examples enables the display of the memory trace for DISP:WIND2:TRAC1:MEM:STAT 1 trace 1 on channel 2. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-117...
Page 138
This function adjusts the value of the reference value and the scale per division to display the trace. Command variables. <x> is the channel number (1 to 16); <y> is the trace number (1 to 16). Group Display commands Syntax DISPlay:CHANnel<x>:TRACe<y>:Y:[SCALe]:AUTO DRAFT – 01/24/2019 2-118 TTR500 Series Programmer Manual...
Page 139
3 on channel 2. DISPlay:CHANnel<x>:TRACe<y>:Y:[SCALe]:RLEVEL Set or query the value of the reference division line on the specified trace for the specified channel. Group Display commands Syntax DISPlay:CHANnel<x>:TRACe<y>:Y:[SCALe]:RLEVEL <value> DISPlay:CHANnel<x>:TRACe<y>:Y:[SCALe]:RLEVEL? DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-119...
Page 140
4, which is the position DISP:WIND2:TRAC3:MEM:Y:SCAL:RPOS? of the reference division line for trace 3 on channel 2. DISPlay:CHANnel<x>:X:SPACing Set or query the type of display of the graph horizontal axis on the specified channel. DRAFT – 01/24/2019 2-120 TTR500 Series Programmer Manual...
Page 141
Command variables. <x> is the channel number (1 to 16). is the number of divisions per graph. Range: 4 to 30. <value>::=<NR1> Returns <NR1> Examples sets 15 as the number of divisions on graphs DISP:WIND1:Y:SCAL:DIV 15 for channel 1. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-121...
Page 142
DISPlay:FONT:[BAR] Set or query the menu bar text font size. Group Display commands Syntax DISPlay:FONT:[BAR] { SIZE } DISPlay:FONT:[BAR]? Related Commands DISPlay:MENU:[STATe] Arguments Range: 8 to 20 <size>::=<NR1> Returns <NR1> DRAFT – 01/24/2019 2-122 TTR500 Series Programmer Manual...
Page 143
Set or query the display of the fail sign for the limit, ripple limit, and bandwidth tests. Group Display commands Syntax DISPlay:FSIGn <value> DISPlay:FSIGn? Related Commands CALCulate<x>:[SELected]:LIMit:[STATe] CALCulate<x>:[SELected]:RLIMit:[STATe] CALCulate<x>:[SELected]:BLIMit:[STATe] Arguments <value>::=<boolean> Returns 1 means the fail sign shows. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-123...
Page 144
Group Display commands Syntax DISPlay:GRAPh<x>:[ACTivate]:CHANnel <value> Related Commands SERVice:CHANnel<x>:COUNt Arguments Command variables. <x> is the graph number (1 to 16). DRAFT – 01/24/2019 2-124 TTR500 Series Programmer Manual...
Page 145
Examples sets the title of graph 1 DISP:GRAP1:ACT:TITL:DATA “FILTER RESPONSE” to Filter Response. DISPlay:GRAPh<x>:[ACTivate]:TITLe:[STATe] (No Query Form) Set to display or hide the channel title for the specified graph. Group Display commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-125...
Page 146
Returns <NR1> Examples activates channel 1 to graph 2. DISP:GRAP2:ACT:CHAN 1 allocates these traces to graph DISP:GRAP2:ACT:TRAC 1,3,5,7,9,11,13,15 2 on channel 1. DISPlay:IMAGe Set or query the color scheme of the display. DRAFT – 01/24/2019 2-126 TTR500 Series Programmer Manual...
Page 147
DISP:MAX 1 may return 0, which means maximization is disabled for the active DISP:MAX? channel. DISPlay:MENU:[STATe] Set or query the state of the display of the menu bar. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-127...
Page 149
D12_34, which is the layout set for the channels. DISP:SPL? DISPLay:TABLe:[STATe] Set or query the status of the display window located on the lower part of the screen. Group Display commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-129...
Page 150
SCFactor Power Sensor's calibration factor table window RLIMit Ripple test table window Returns See Arguments. Examples sets echo, as the window type set for the lower part DISP:TABL:TYPE ECHO of the screen. DRAFT – 01/24/2019 2-130 TTR500 Series Programmer Manual...
Page 151
2 as the active channel, if channel 2 is enabled. DISP:WIND2:ACT DISPlay:WINDow<x>:TRACe<y>:[STATe] Set or query the state of the display for the data trace on specified trace for the specified channel. Conditions Display commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-131...
Page 152
Related Commands *WAI *ESE *SRE *STB? Arguments is the value in the range from 0 to 255. <value>::=<NRf> NOTE. The binary bits of the ESER are set based on this value. Returns <NRf> DRAFT – 01/24/2019 2-132 TTR500 Series Programmer Manual...
Page 153
213, which shows that SESR contains binary 11010101. *ESR? *IDN? (Query Only) Query the analyzer identification code. Group IEEE common commands Syntax *IDN? Returns The analyzer identification code in the following format: TEKTRONIX,TTR5xx,<serial_number>,<firmware_version> where: DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-133...
Page 154
Indicates the serial number. <serial_number> Indicates the firmware version. <firmware_version> Examples may return TEKTRONIX, TTR503, B000111, FV1.3.2100, which *IDN? correspond to the manufacturer name, model number, serial number, and firmware version. INITiate<x>:CONTinuous Set or query the status of the trigger mode (continuous or hold) for the specified channel.
Page 155
CSV file name and destination of the calibration coefficient <string> table. Range: 254 characters or less. Examples loads the calibration factor MMEM:LOAD:ASCF 1 “C:\Users\sensor1.csv” table from the file sensor1.csv for port 1 on the active channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-135...
Page 156
CSV file name and destination, which contains the <value>::=<string> limit table. Range: 254 characters or less. Examples loads the limit table from MMEM:LOAD:LIM “C:\Users\limitTable1.csv” the file limitTable1.csv for the active trace. DRAFT – 01/24/2019 2-136 TTR500 Series Programmer Manual...
Page 157
CSV file name and destination for the ripple limit <value>::=<string> table. Range: 254 characters or less. Examples loads the ripple limit MMEM:LOAD:RLIM “C:\Users\rippleTable1.csv” table from the file rippleTable1.csv for the active trace. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-137...
Page 158
Contains measurement conditions. cstate Contains measurement conditions and calibration data. dstate Contains measurement conditions and trace data. cdstate Contains measure conditions, calibration state, and trace data. Range: 254 characters or less DRAFT – 01/24/2019 2-138 TTR500 Series Programmer Manual...
Page 159
Save the limit table to the specified CSV file on the active trace. Make sure the CSV file is available at the provided file path as no notification is provided if the file is not loaded. Group Memory commands Syntax MMEMory:STORe:LIMit <value> Related Commands CALCulate<x>:[SELected]:LIMit:DATA MMEMory:LOAD:LIMit DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-139...
Page 160
CSV file for the active channel. Make sure the CSV file is available at the provided file path as no notification is provided if the file is not loaded. Group Memory commands Syntax MMEMory:STORe:PSCFactor <port>,<string> MMEMory:STORe:PSCFactor? DRAFT – 01/24/2019 2-140 TTR500 Series Programmer Manual...
Page 161
Set or query what content (all channels/traces or only displayed channels/traces) must be saved as instrument state. Make sure the CSV is available at the provided file path as no notification is provided if the file is not loaded. Group Memory commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-141...
Page 162
MMEMory:STORe:SNP:[DATA] (No Query Form) Save the measurement data as a touchstone file in SnP format (S1P or S2P). The measurement data format is applied by MMEMory:STORe:SNP:FORMat while the SnP format is set by MMEMory:STORe:SNP:TYPE:S1P DRAFT – 01/24/2019 2-142 TTR500 Series Programmer Manual...
Page 163
Make sure the CSV file is available at the provided file path as no notification is provided if the file is not loaded. NOTE. The SnP file format is not automatically appended to the file name. Group Memory commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-143...
Page 164
Number of ports used when saving a touchstone file in the SnP format Examples may return 1, which indicates the number of ports MMEM:STOR:SNP:NPORTS? used to save the touchstone file. The format used to save the touchstone file was S1P. DRAFT – 01/24/2019 2-144 TTR500 Series Programmer Manual...
Page 165
The SnP file format is not automatically appended to the file name. Group Memory commands Syntax MMEMory:STORe:SNP:TYPE:S1P <value> Related Commands MMEMory:STORe:SNP:NPORTS? MMEMory:STORe:SNP:[DATA] Arguments is the port number (1 or 2) used when saving a touchstone <value>::=<NR1> file in S1P format. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-145...
Page 166
Arguments is the CSV file name, extension, and destination used <file>::=<string> to save the desired state of the instrument, where the extension and the content saved is described in the following table: DRAFT – 01/24/2019 2-146 TTR500 Series Programmer Manual...
Page 167
Generates the operation complete message in the Standard Event Status Register (SESR) when all pending operations are complete. places the ASCII character 1 into the output queue when all pending *OPC? operations are complete. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-147...
Page 168
1 means the stimulus signal output shows. 0 means the stimulus signal output is hidden. Examples enables the stimulus signal output. OUTP:STAT 1 may return 0, which means the stimulus signal output is disabled. OUTP:STAT? DRAFT – 01/24/2019 2-148 TTR500 Series Programmer Manual...
Page 169
. Measurement data SENSe<x>:AVERage:[STATe] recorded before executing this command is not used for averaging. Command variables. <x> is the channel number (1 to 16). Group Sense commands Syntax SENSe<x>:AVERage:CLEar DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-149...
Page 170
Set or query the state of the averaging function for the specified channel. Group Sense commands Syntax SENSe<x>:AVERage:[STATe] <value> SENSe<x>:AVERage:[STATe]? Arguments Command variables. <x> is the channel number (1 to 16). <value>::=<boolean> Returns 1 means the averaging function is turned on. DRAFT – 01/24/2019 2-150 TTR500 Series Programmer Manual...
Page 171
2. SENSe<x>:CORRection:CLEar (No Query Form) Clear the calibration error coefficients for the specified channel. Command variables. <x> is the channel number (1 to 16). Group Sense commands Syntax SENSe<x>:CORRection:CLEar Arguments None DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-151...
Page 172
<string> String Description Source match Reflection tracking Directivity Load match Transmission tracking Isolation is the response port (1 or 2). <value1>::=<NR1> is the stimulus port (1 or 2). <value2>::=<NR1> DRAFT – 01/24/2019 2-152 TTR500 Series Programmer Manual...
Page 173
1. SENS1:CORR:COEF:HDR 1 may return 0, which means the gain path is set to SENS4:CORR:COEF:HDR? low for each port on channel 4. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-153...
Page 174
Command variables. <x> is the channel number (1 to 16). is the response port (1 or 2). <value>::=<NR1> Examples sets the response calibration (open) SENS1:CORR:COEF:METH:RESP:OPEN 1 for channel 1, with port 1 as the response port. DRAFT – 01/24/2019 2-154 TTR500 Series Programmer Manual...
Page 175
(1 or 2). <value2>::=<NR1> Examples sets the response calibration (thru) SENS1:CORR:COEF:METH:RESP:THRU 2,1 for channel 1, assigning port 2 as the input port and port 1 as the output port. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-155...
Page 176
2 as the number of ports used SENS1:CORR:COEF:METH:SOLT:NPORTS 2 for the SOLT calibration for channel 1. sets ports 1 and 2 to be SENS1:CORR:COEF:METH:SOLT:PORTS 1,2 used on the 2–port SOLT calibration for channel 1. This is equivalent SENS1:CORR:COEFt:METH:SOLT2 DRAFT – 01/24/2019 2-156 TTR500 Series Programmer Manual...
Page 177
When you enable the calibration coefficients, this action clears all calibration data regardless of whether it was used for calculation. This action also clears the calibration type selection. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-157...
Page 178
Measure the port isolation calibration data from the specified stimulus port to the specified response port for the specified channel. Group Sense commands Syntax SENSe<x>:CORRection:COLLect:[ACQuire]:ISOLation <value1>,<value2> Related Commands SENSe<x>:CORRection:COLLect:METHod:ERESPonse SENSe<x>:CORRection:COLLect:METHod:RESPonse:THRU SENSe<x>:CORRection:COLLect:METHod:SOLT:NPORTS SENSe<x>:CORRection:COLLect:METHod:SOLT2 DRAFT – 01/24/2019 2-158 TTR500 Series Programmer Manual...
Page 179
SENS1:CORR:COLL:ACQ:LOAD 1 standard for port 1 on channel 1. SENSe<x>:CORRection:COLLect:[ACQuire]:OPEN (No Query Form) Measure the calibration data of the open standard for the specified port and channel. Group Sense commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-159...
Page 180
Command variables. <x> is the channel number (1 to 16). is the port (1 or 2) where the short standard is calibrated. <value>::=<NR1> Examples measures the calibration data for the short SENS1:CORR:COLL:ACQ:SHORT 1 standard for port 1 on channel 1. DRAFT – 01/24/2019 2-160 TTR500 Series Programmer Manual...
Page 181
Measure the calibration data of the thru standard from the specified stimulus port to the specified response port for the specified channel. Group Sense commands Syntax SENSe<x>:CORRection:COLLect:[ACQuire]:THRU <value1>,<value2> Related Commands SENSe<x>:CORRection:COLLect:METHod:ERESPonse SENSe<x>:CORRection:COLLect:METHod:RESPonse:THRU SENSe<x>:CORRection:COLLect:METHod:SOLT:NPORTS SENSe<x>:CORRection:COLLect:METHod:SOLT2 DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-161...
Page 182
CEM, which is the name of the SENS2:CORR:COLL:CKIT:LAB? active calibration kit used for channel 2. SENSe<x>:CORRection:COLLect:CKIT:ORDer:LABel Set or query the name of the subclass label selected for the active calibration kit for the specified channel. Group Sense commands DRAFT – 01/24/2019 2-162 TTR500 Series Programmer Manual...
Page 183
SENSe<x>:CORRection:COLLect:CKIT:ORDer:[SELect] SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:TYPE Arguments Command variables. <x> is the channel number (1 to 16). is the standard number. Range: 1 to 21. <value>::=<NR1> is the port number (1 or 2). <port>::=<NR1> Returns <value>,<port> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-163...
Page 184
1, 3, where standard 3 is the SENS2:CORR:COLL:CKIT:ORD:OPEN? open measurement used on port 1 for channel 2. SENSe<x>:CORRection:COLLect:CKIT:ORDer:[SELect] Set or query the subclass for the active calibration from the subclass menu for the specified channel. DRAFT – 01/24/2019 2-164 TTR500 Series Programmer Manual...
Page 185
Sense commands Syntax SENSe<x>:CORRection:COLLect:CKIT:ORDer:SHORt <value> SENSe<x>:CORRection:COLLect:CKIT:ORDer:SHORt? Related Commands SENSe<x>:CORRection:COLLect:CKIT:ORDer:[SELect] SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:TYPE Arguments Command variables. <x> is the channel number (1 to 16). is the number of the standard. Range: 1 to 21. <value>::=<NR1> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-165...
Page 186
1 and 2 for calibrations on channel 1. may return 1, 2, 4, where standard 4 is SENS3:CORR:COLL:CKIT:ORD:THRU? the thru measurement between ports 1 and 2 used for calibrations on channel 3. DRAFT – 01/24/2019 2-166 TTR500 Series Programmer Manual...
Page 187
Examples sets index 3 for the calibration kit standard SENS1:CORR:COLL:CKIT:SEL 3 for channel 1. may return 1, which means index 2 is set for SENS2:CORR:COLL:CKIT:SEL? the calibration kit standard for channel 2. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-167...
Page 188
SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:TYPE OPEN specified calibration kit standard for the specified channel. Group Sense commands Syntax SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:C0 <value> SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:C0? Related Commands SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:TYPE DRAFT – 01/24/2019 2-168 TTR500 Series Programmer Manual...
Page 189
<value>::=<NRf> calibration kit standard. Range: -1e18 to 1e18; Units: 1e-27 farad/Hz. If the specified variable is outside the allowable setup range, the minimum or maximum value is set. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-169...
Page 190
3 on channel 1. may return 15e-36, which means 15e36 SENS2:CORR:COLL:CKIT:STAN3:C2? farad/Hz is the C value of the open standard type for standard 3 on channel 2. DRAFT – 01/24/2019 2-170 TTR500 Series Programmer Manual...
Page 191
2 for channel 3. SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:CHARacter Set or query the type of media for the specified calibration kit standard on the specified channel. Group Sense commands Syntax SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:CHARacter { COAX | WAV } SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:CHARacter? DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-171...
Page 192
3 SENS1:CORR:COLL:CKIT:STAN3:DEL 13 to 13 seconds for channel 1. may return 32, which is the offset delay SENS2:CORR:COLL:CKIT:STAN2:DEL? (seconds) for standard 2 is set to 32 seconds for channel 2. DRAFT – 01/24/2019 2-172 TTR500 Series Programmer Manual...
Page 193
Command variables. <x> is the channel number (1 to 16); <y> is the standard number of the calibration kit (1 to 21). is the stop frequency for the specified calibration standard. <value>::=<NRf> Range: 0 to 1e12 (Hz). DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-173...
Page 194
2 on channel 4. SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:L0 Set or query the value of L for the short standard type set by for the SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:TYPE SHORt specified calibration kit standard on the specified channel. Group Sense commands DRAFT – 01/24/2019 2-174 TTR500 Series Programmer Manual...
Page 195
Command variables. <x> is the channel number (1 to 16); <y> is the standard number of the calibration kit (1 to 21). is the value of L for the specified calibration standard. <value>::=<NRf> Range: -1e18 to 1e18; Units: 1e-24 H/Hz. Returns <NRf> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-175...
Page 196
2 of the short standard type for channel 2. SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:L3 Set or query the value of L for the short standard type set by for the SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:TYPE SHORt specified calibration kit standard on the specified channel. Group Sense commands DRAFT – 01/24/2019 2-176 TTR500 Series Programmer Manual...
Page 197
Command variables. <x> is the channel number (1 to 16); <y> is the standard number of the calibration kit (1 to 21). is the label of the calibration kit standard. <value>::=<string> Range: < 254 characters Returns <string> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-177...
Page 198
Set or query standard type for the specified calibration kit standard for the specified channel. Group Sense commands Syntax SENSe<x>:CORRection:COLLect:CKIT:STAN<y>:TYPE { OPEN | SHORt | LOAD | THRU | UTHRu | ARBI | NONE } DRAFT – 01/24/2019 2-178 TTR500 Series Programmer Manual...
Page 199
Command variables. <x> is the channel number (1 to 16); <y> is the number of the calibration kit standard (1 to 21). is the characteristic impedance value of the calibration <value>::=<NRf> standard. Range: -1e18 to 1e18; Units: kΩ/s. Returns <NRf> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-179...
Page 200
Set enhanced response calibration as the calibration method for the specified channel between the stimulus and response ports. Group Sense commands Syntax SENSe<x>:CORRection:COLLect:METHod:ERESPonse <port1>,<port2> Related Commands SENSe<x>:CORRection:COLLect:CLEar SENSe<x>:CORRection:COLLect:[ACQuire]:OPEN SENSe<x>:CORRection:COLLect:[ACQuire]:SHORt SENSe<x>:CORRection:COLLect:[ACQuire]:LOAD SENSe<x>:CORRection:COLLect:[ACQuire]:THRU SENSe<x>:CORRection:COLLect:[ACQuire]:ISOLation SENSe<x>:CORRection:COLLect:SAVE DRAFT – 01/24/2019 2-180 TTR500 Series Programmer Manual...
Page 201
SENS1:CORR:COLL:ACQ:THRU 2,1 SENS1:CORR:COLL:SAVE SENSe<x>:CORRection:COLLect:METHod:RESPonse:OPEN (No Query Form) Set the response calibration type to open for the specified port and channel. Group Sense commands Syntax SENSe<x>:CORRection:COLLect:METHod:RESPonse:OPEN <value> Related Commands SENSe<x>:CORRection:COLLect:CLEar SENSe<x>:CORRection:COLLect:[ACQuire]:OPEN SENSe<x>:CORRection:COLLect:[ACQuire]:LOAD SENSe<x>:CORRection:COLLect:SAVE SENSe<x>:CORRection:COLLect:METHod:TYPE? DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-181...
Page 202
Related Commands SENSe<x>:CORRection:COLLect:CLEar SENSe<x>:CORRection:COLLect:[ACQuire]:SHORt SENSe<x>:CORRection:COLLect:[ACQuire]:LOAD SENSe<x>:CORRection:COLLect:SAVE SENSe<x>:CORRection:COLLect:METHod:TYPE? Arguments Command variables. <x> is the channel number (1 to 16). is the port where you perform the response calibration (short). <value>::=<NR1> Returns 1 or 2 DRAFT – 01/24/2019 2-182 TTR500 Series Programmer Manual...
Page 203
Commands 2 and 3 perform the calibration data measurements for the response calibration thru. Command 4 saves the output and applies the calibration data to the specified channel. Command 5 queries the type of calibration used for the specified channel: DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-183...
Page 204
2. SENSe<x>:CORRection:COLLect:METHod:SOLT:PORTS (No Query Form) Set the ports for the SOLT calibration based on the number of ports set by for the specified SENSe<x>:CORRection:COLLect:METHod:SOLT:NPORTS channel. Group Sense commands Syntax SENSe<x>:CORRection:COLLect:METHod:SOLT:PORTS <array> DRAFT – 01/24/2019 2-184 TTR500 Series Programmer Manual...
Page 205
3, 4, 5, 6, 7, 8, 9, 10, 11, and 12 perform the calibration data measurements for the 2-port SOLT calibration. Command 13 saves the output and applies the calibration data to the specified channel: DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-185...
Page 206
Related Commands SENSe<x>:CORRection:COLLect:CLEar SENSe<x>:CORRection:COLLect:SAVE SENSe<x>:CORRection:COLLect:METHod:TYPE? SENSe<x>:CORRection:COLLect:[ACQuire]:OPEN SENSe<x>:CORRection:COLLect:[ACQuire]:SHORt SENSe<x>:CORRection:COLLect:[ACQuire]:LOAD Arguments Command variables. <x> is the channel number (1 to 16). is the port (1 or 2) at which you perform 1-port calibration. <value>::=<NR1> DRAFT – 01/24/2019 2-186 TTR500 Series Programmer Manual...
Page 207
SENSe<x>:CORRection:COLLect:[ACQuire]:OPEN SENSe<x>:CORRection:COLLect:[ACQuire]:SHORt SENSe<x>:CORRection:COLLect:[ACQuire]:LOAD SENSe<x>:CORRection:COLLect:[ACQuire]:THRU SENSe<x>:CORRection:COLLect:[ACQuire]:ISOLation Arguments Command variables. <x> is the channel number (1 to 16). is the first port (1 or 2). <port1>::=<NR1> is the second port (1 or 2). <port2>::=<NR1> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-187...
Page 208
Query the type of calibration for the specified channel. Group Sense commands Syntax SENSe<x>:CORRection:COLLect:METHod:TYPE? Returns Command variables. <x> is the channel number (1 to 16). Response Value NONE RESPO RESPS RESPT ERES SOLT DRAFT – 01/24/2019 2-188 TTR500 Series Programmer Manual...
Page 209
This action clears all measured data and the selection for calibration type. Command variables. <x> is the channel number (1 to 16). Group Sense commands Syntax SENSe<x>:CORRection:COLLect:SAVE Related Commands SENSe<x>:CORRection:COLLect:METHod:TYPE? SENSe<x>:CORRection:COLLect:METHod:ERESPonse SENSe<x>:CORRection:COLLect:METHod:RESPonse:OPEN SENSe<x>:CORRection:COLLect:METHod:RESPonse:SHORt SENSe<x>:CORRection:COLLect:METHod:RESPonse:THRU DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-189...
Page 210
Set or query the status of the respective port extension loss correction and frequency values for the specified port and channel. For Loss 2 to be enabled, Loss 1 must also be enabled. DRAFT – 01/24/2019 2-190 TTR500 Series Programmer Manual...
Page 211
DC loss value of the port 1 or 2. <value>::=<NRf> Range: -90 to 90 dB Returns <NRf> Examples sets 50 dB as the DC loss value for port 1 SENS1:CORR:EXT:PORT1:LDC 50 on channel 1. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-191...
Page 212
Command variables. <x> is the channel number (1 to 16); <y> is the port number (1 or 2). is the delay time for the port extension. <value>::=<NRf> Range: -10 to 10 s DRAFT – 01/24/2019 2-192 TTR500 Series Programmer Manual...
Page 213
Execute the receiver calibration for the specified port and channel. Group Sense commands Syntax SENSe<x>:CORRection:RECeiver<y>:COLLect:[ACQuire] <value> Arguments Command variables. <x> is the channel number (1 to 16); <y> is the port number (1 or 2). DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-193...
Page 214
Command 3 queries whether error correction is enabled or disabled for the receiver calibration for a specified port: SENS1:CORR:REC1:COLL:ACQ 2 SENS1:CORR:REC1:STAT 1 SENS1:CORR:REC1:STAT? DRAFT – 01/24/2019 2-194 TTR500 Series Programmer Manual...
Page 215
Group Sense commands Syntax SENSe<x>:CORRection:[STATe] <value> SENSe<x>:CORRection:[STATe]? Arguments Command variables. <x> is the channel number (1 to 16). <value>::=<boolean> Returns 1 means error correction is enabled. 0 means error correction is disabled. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-195...
Page 216
0, which means the trigger source is set SENS2:CORR:TRIG:FREE? to system for channel 2. SENSe<x>:CORRection:TYPE? (Query Only) Query the calibration type used for the specified channel. Group Sense commands Syntax SENSe<x>:CORRection:TYPE? Related Commands SENSe<x>:CORRection:COLLect:METHod:TYPE? DRAFT – 01/24/2019 2-196 TTR500 Series Programmer Manual...
Page 217
2e6, which means 2 MHz is the center frequency SENS2:FREQ:CENT? value set for channel 2. SENSe<x>:FREQuency:CW Set or query the CW frequency value of the sweep range of the specified channel. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-197...
Page 218
Range of n: 1 to NP Examples may return 1e9, 2e9, 3e9, if there are only 3 measurement SENS1:FREQ:DATA? points with a linear sweep range from 1 to 3 GHz for channel 1. DRAFT – 01/24/2019 2-198 TTR500 Series Programmer Manual...
Page 219
Syntax SENSe<x>:FREQuency:STARt <value> SENSe<x>:FREQuency:STARt? Arguments Command variables. <x> is the channel number (1 to 16). is the starting frequency of the sweep range. <value>::=<NRf> Range: 1e5 to [maximum frequency] Hz Returns <NRf> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-199...
Page 220
2. SENSe<x>:SEGMent:DATA Create or query the array for the segment sweep table on the specified channel. Group Sense commands Syntax SENSe<x>:SEGMent:DATA SEGTABLE SENSe<x>:SEGMent:DATA? Related Commands MMEMory:STORe:SEGMent DRAFT – 01/24/2019 2-200 TTR500 Series Programmer Manual...
Page 221
Optional: Power level value (dBm) <NRf> for segment n Range: –50 to 10 dBm delay n Optional: Sweep delay time <NRf> (seconds) for segment n. Auto Range 0 to 1 s Sweep Time must be disabled. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-201...
Page 222
300 kHz, 0 span, and 2 measurement points. SENSe<x>:SEGMent:SWEep:POINts? (Query Only) Query the total number of measurement points for the segment sweep for the specified channel. Group Sense commands Syntax SENSe<x>:SEGMent:SWEep:POINts? DRAFT – 01/24/2019 2-202 TTR500 Series Programmer Manual...
Page 223
SENSe<x>:SWEep:DELay Set or query the sweep delay for the specified channel. NOTE. You must disable auto sweep time before using this command. Group Sense commands Syntax SENSe<x>:SWEep:DELay <value> SENSe<x>:SWEep:DELay? Related Commands SENSe<x>:SWEep:TIME:AUTO DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-203...
Page 224
STEPped, which means the sweep mode is set to SENS2:SWE:GEN? normal for channel 2. SENSe<x>:SWEep:POINts Set or query the number of measurement points for the specified channel. Group Sense commands DRAFT – 01/24/2019 2-204 TTR500 Series Programmer Manual...
Page 225
Set or query the value of the sweep time for the specified channel. If the specified time value (in seconds) is outside the range, the respective minimum or maximum value is set accordingly. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-205...
Page 226
2, if 0.02 seconds is within the acceptable time range. SENSe<x>:SWEep:TYPE Set or query the sweep type for the selected channel. Group Sense commands Syntax SENSe<x>:SWEep:TYPE { LINear | LOGarithmic | SEGMent | POWer SENSe<x>:SWEep:TYPE? DRAFT – 01/24/2019 2-206 TTR500 Series Programmer Manual...
Page 227
3e9, which means 3 GHz is the fixed value used SENS3:FREQ:FIX? by power sweep for channel 3. SERVice:CHANnel:ACTive Set or query the active channel. NOTE. An error occurs if the specified channel is not yet allocated. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-207...
Page 228
SERVice:CHANnel:TRACe:COUNt? Returns <NR1> Examples may return 4, which means there are 4 traces per SERV:CHAN:TRAC:COUN? channel. SERVice:CHANnel<x>:COUNt Set or query the number of allocated channels. Group Service commands Syntax SERVice:CHANnel<x>:COUNt <value> SERVice:CHANnel<x>:COUNt? DRAFT – 01/24/2019 2-208 TTR500 Series Programmer Manual...
Page 229
4, which means trace 4 is the active trace SERV:CHAN1:TRAC:ACT? on channel 1. SIMulator:FILE:FET (No Query Form) Load the CSV file of the factory error terms to the specified port. Group Simulator commands Syntax SIMulator:FILE:FET <value1>,<value2> SIMulator:FILE:FET? DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-209...
Page 230
SimulatorDataFiles, which is the simulator files SIM:FILE:FOLD? folder. SIMulator:FILE:LCOM (No Query Form) Load the simulator loss compensation file. Group Simulator commands Syntax SIMulator:FILE:LCOM <value> Arguments is the simulator loss compensation file. <value>::=<string> DRAFT – 01/24/2019 2-210 TTR500 Series Programmer Manual...
Page 231
Simulator commands Syntax SIMulator:FILE:RTF <value> Arguments is the simulator RTF file. <value>::=<string> Examples loads the Simulator1.rtf. SIM:FILE:RTF “Simulator1.rtf” SIMulator:FILE:STF (No Query Form) Load the simulator STF file. Group Simulator commands Syntax SIMulator:FILE:STF <value> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-211...
Page 232
Group Simulator commands Syntax SIMulator:FILEname <value> SIMulator:FILEname? Arguments is the SNP (touchstone) file name describing the DUT. <value>::=<string> Returns <string> Examples loads the file SimulatorFilter.s2p , which SIM:FILE “SimulatorFilter.s2p” describes the DUT. DRAFT – 01/24/2019 2-212 TTR500 Series Programmer Manual...
Page 233
<value>::=<NRf> Range: 1 to 150 Examples sets the reference calibration factor of the instrument to 100. SIM:RCF 100 may return 50, which is the reference calibration factor of the SIM:RCF? instrument. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-213...
Page 234
Set or query the value of the power level on the specified channel. Group Source commands Syntax SOURce<x>:POWer:[LEVel]:[IMMediate]:[AMPLitude] <value> SOURce<x>:POWer:[LEVel]:[IMMediate]:[AMPLitude]? Arguments Command variables. <x> is the channel number (1 to 16). is the power level value (dBm) for the specified channel. <value>::=<NRf> Returns <NRf> DRAFT – 01/24/2019 2-214 TTR500 Series Programmer Manual...
Page 235
When you complete the calibration measurements, this command turns on the power level error correction. NOTE. An error occurs if the power sensor is not properly connected. Group Source commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-215...
Page 236
30, which means 30% SOUR2:POW:PORT2:CORR:COLL:ASEN:RCF? is the reference calibration coefficient set for port 2 on channel 2. SOURce<x>:POWer:PORT<y>:CORRection:COLLect:NTOLerance Set or query the tolerance value for power calibration data of the specified port and channel. DRAFT – 01/24/2019 2-216 TTR500 Series Programmer Manual...
Page 237
For any integer n between 1 and N: is the number of data items to set (1 to 100). DATA[0] is the frequency of the n data item (1 kHz to 5 GHz). DATA[2n-1] DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-217...
Page 238
DATA[2n] Returns <NRf> Examples sets the data array SOUR1:POW:PORT1:CORR:COLL:TABL:LOSS:DATA 0,5,6 for the loss compensation table with the assigned values for port 1 on channel 1. DRAFT – 01/24/2019 2-218 TTR500 Series Programmer Manual...
Page 239
Set or query the power calibration data array, for the specified port and channel. Group Source commands Syntax SOURce<x>:POWer:PORT<y>:CORRection:DATA <DATA> SOURce<x>:POWer:PORT<y>:CORRection:DATA? Arguments Command variables. <x> is the channel number (1 to 16); <y> is the port number (1 or 2). DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-219...
Page 240
0, which means power level error SOUR3:POW:PORT2:CORR:STAT? correction is disabled for port 2 on channel 3. SOURce<x>:POWer:PORT<y>:COUPle Set or query the same power level for all ports on the specified channel. DRAFT – 01/24/2019 2-220 TTR500 Series Programmer Manual...
Page 241
10 dBm SOUR1:POW:PORT1:LEVEL:IMM:AMP 10 for port 1 on channel 1. may return the 2, which means 2 dB is SOUR2:POW:PORT2:LEVEL:IMM:AMP? the power level value set for port 2 on channel 2. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-221...
Page 242
Command variables. <x> is the channel number (1 to 16). is the starting value (dBm) of the sweep range for power <value>::=<NRf> sweep for the specified channel. Range: -50 to 10 dBm Returns <NRf> DRAFT – 01/24/2019 2-222 TTR500 Series Programmer Manual...
Page 243
2. SOURce<xz>:POWer:PORT<y>:CORRection:COLLect:AVERage:[COUNt] Set or query the averaging factor value for power calibration data measurements for the specified port on the specified channel. Group Source commands Syntax SOURce<xz>:POWer:PORT<y>:CORRection:COLLect:AVERage:[COUNt] <value> SOURce<xz>:POWer:PORT<y>:CORRection:COLLect:AVERage:[COUNt]? DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-223...
Page 244
0, which means the power slope is SOUR2:POW:LEV:SLOP:STAT? disabled for channel 2. *SRE Sets or queries the value of the Service Request Enable Register (SRER). Refer to Section 3 in Status and Events for the register information. DRAFT – 01/24/2019 2-224 TTR500 Series Programmer Manual...
Page 245
<NR1> Examples may return 16, which is the value of the Operation Status STAT:OPER:COND? Condition Register, if measurement is activated. STATus:OPERation:ENABle Set or query the value of the Operation Status Enable Register. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-225...
Page 246
0, which is the value of the Operation Status Event STAT:OPER:EVE? Register. STATus:OPERation:NTRansition Set or query the value of the negative transition filter of the Operation Status Register. Group Status commands Syntax STATus:OPERation:NTRansition <value> STATus:OPERation:NTRansition? DRAFT – 01/24/2019 2-226 TTR500 Series Programmer Manual...
Page 247
Operation Status Register to 16. may return 16, which is the value of the positive transition STAT:OPER:PTR? filter of the Operation Status Register. STATus:PRESet (No Query Form) Initialize the Status Registers. Group Status commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-227...
Page 248
If trace 1 fails, the return value may be 2 (0000 0000 0000 0010); if trace 14 fails, the return may be 16384 (0100 0000 0000 0000). DRAFT – 01/24/2019 2-228 TTR500 Series Programmer Manual...
Page 249
15-16. Bits used are 0-1, while bits 2 and 15 are always 0. Group Status commands Syntax STATus:QUEStionable:BLIMit:CHANnel<x>:ECHannel:ENABle <value> STATus:QUEStionable:BLIMit:CHANnel<x>:ECHannel:ENABle? DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-229...
Page 250
1 for an event based on the transition type used for the bandwidth limit test. Group Status commands Syntax STATus:QUEStionable:BLIMit:CHANnel<x>:ECHannel:[EVENt]? Related Commands STATus:QUEStionable:BLIMit:CHANnel<x>:ECHannel:NTRansition STATus:QUEStionable:BLIMit:CHANnel<x>:ECHannel:PTRansition STATus:QUEStionable:BLIMit:CHANnel<x>:ECHannel:CONDition? Returns Command variables. <x> is the channel number (1 to 16). <NR1> DRAFT – 01/24/2019 2-230 TTR500 Series Programmer Manual...
Page 251
If the bandwidth limit test result changes from fail (1) to pass (0), the query may return 1, 2, or 3, depending on which traces saw the transition occurred on channel 1: STAT:QUES:BLIM:CHAN1:ECH:PTR 3 STAT:QUES:BLIM:CHAN1:ECH:EVEN? DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-231...
Page 252
Register for the specified channel. This enables the corresponding status event register, based on the type of transition used for the respective event bit for traces 1-14. Bits used are 1-14, where bits 0 and 15 are always 0. Group Status commands DRAFT – 01/24/2019 2-232 TTR500 Series Programmer Manual...
Page 253
Register for the specified channel. For traces 0-14, bits 0 and 1 use 0 for no event occurred and 1 for an event based on the transition type used for the bandwidth limit test. Group Status commands Syntax STATus:QUEStionable:BLIMit:CHANnel<x>:[EVENt]? Related Commands STATus:QUEStionable:BLIMit:CHANnel<x>:PTRansition STATus:QUEStionable:BLIMit:CHANnel<x>:NTRansition STATus:QUEStionable:BLIMit:CHANnel<x>:CONDition? DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-233...
Page 254
If the bandwidth limit test result changes from fail (1) to pass (0) for all four enabled traces, the query may return 1920, indicating that the transition occurred on channel 1: DRAFT – 01/24/2019 2-234 TTR500 Series Programmer Manual...
Page 255
Query the value of the Questionable Bandwidth Limit Status Condition Register. For channels 1-14, bits 1-14 are defined by 0 for pass and 1 for fail. Bit 0 ORs the enabled bits of the extra status condition register. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-235...
Page 256
Enable Register to 20. may return 20, which is the value of the Questionable STAT:QUES:BLIM:ENAB? Limit Status Enable Register. STATus:QUEStionable:BLIMit:[EVENt]? (Query Only) Query the value of the Questionable Limit Status Event Register. Group Status commands DRAFT – 01/24/2019 2-236 TTR500 Series Programmer Manual...
Page 257
Questionable Limit Channel Status Condition Register set for channel 3, if traces 2 and 4 are active and the limit test is failing for each of these traces. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-237...
Page 258
15-16. Bits used are 0-1, while bits 2 and 15 are always 0. Group Status commands Syntax STATus:QUEStionable:LIMit:CHANnel<x>:ECHannel:ENABle <value> STATus:QUEStionable:LIMit:CHANnel<x>:ECHannel:ENABle? DRAFT – 01/24/2019 2-238 TTR500 Series Programmer Manual...
Page 259
1 for an event based on the transition type used for limit test. Group Status commands Syntax STATus:QUEStionable:LIMit:CHANnel<x>:ECHannel:[EVENt]? Related Commands STATus:QUEStionable:LIMit:CHANnel<x>:ECHannel:NTRansition STATus:QUEStionable:LIMit:CHANnel<x>:ECHannel:PTRansition STATus:QUEStionable:LIMit:CHANnel<x>:ECHannel:CONDition? Returns Command variables. <x> is the channel number (1 to 16). <NR1> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-239...
Page 260
If the limit test result changes from fail (1) to pass (0), the query may return 1, 2, or 3, depending on which traces saw the transition occurred on channel 1: STAT:QUES:LIM:CHAN1:ECH:NTR 3 STAT:QUES:LIM:CHAN1:ECH:EVEN? DRAFT – 01/24/2019 2-240 TTR500 Series Programmer Manual...
Page 261
This enables the corresponding status event register based on the type of transition used for the respective event bit for traces 1-14. Bits used are 1-14, where bits 0 and 15 are always 0. Group Status commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-241...
Page 262
Query the value of the Questionable Limit Channel Status Event Register for the specified channel. Group Status commands Syntax STATus:QUEStionable:LIMit:CHANnel<x>:[EVENt]? Related Commands STATus:QUEStionable:LIMit:CHANnel<x>:NTRansition STATus:QUEStionable:LIMit:CHANnel<x>:PTRansition STATus:QUEStionable:LIMit:CHANnel<x>:CONDition? Returns Command variables. <x> is the channel number (1 to 16). DRAFT – 01/24/2019 2-242 TTR500 Series Programmer Manual...
Page 263
If the limit test result changes from fail (1) to pass (0) for all four enabled traces, the query may return 1920, indicating that the transition occurred on channel 1: STAT:QUES:LIM:CHAN1:NTR 1920 DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-243...
Page 264
(1) for all four enabled traces, the query may return 30720, indicating that the transition occurred on channel 1: STAT:QUES:LIM:CHAN1:PTR 30720 STAT:QUES:LIM:CHAN1:EVEN? STATus:QUEStionable:LIMit:CONDition? (Query Only) Query the value of the Questionable Limit Status Condition Register. Group Status commands DRAFT – 01/24/2019 2-244 TTR500 Series Programmer Manual...
Page 265
Arguments is the value of the Questionable Limit Extra Status <value>::=<NR1> Enable Register. Returns <NR1> Examples may return 5, which is the value of the STAT:QUES:LIM:ELIM:ENAB? Questionable Limit Extra Status Enable Register. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-245...
Page 266
filter of STAT:QUES:LIM:ELIM:NTR 8 the Questionable Limit Extra Status Register to 8. may return 4, which is the value of the negative STAT:QUES:LIM:ELIM:NTR? transition filter of the Questionable Limit Extra Status Register. DRAFT – 01/24/2019 2-246 TTR500 Series Programmer Manual...
Page 267
Returns <NR1> Examples may return 5, which is the value of the Questionable STAT:QUES:LIM:ENAB? Limit Status Enable Register. sets the value of the Questionable Limit Status Enable STAT:QUES:LIM:ENAB 2 Register to 2. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-247...
Page 268
filter of the Questionable Limit Status Register. STATus:QUEStionable:LIMit:PTRansition Set or query the value of the positive transition filter of the Questionable Limit Status Register for the specified channel. You cannot set bits 0 and 3-15 to 1. DRAFT – 01/24/2019 2-248 TTR500 Series Programmer Manual...
Page 269
filter of the STAT:QUES:NTR 8 Questionable Status Register to 8. may return 3, which is the value of the negative transition STAT:QUES:NTR? filter of the Questionable Status Register. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-249...
Page 270
The pass/fail status for all traces for the specified channel, where the ripple limit test is enabled: Bits 0-15 represent the pass/fail status for traces 1-14, where bits 0 and 15 are always 0, and bit 1-14 respectively represents traces 1-14. DRAFT – 01/24/2019 2-250 TTR500 Series Programmer Manual...
Page 271
2, which is the value of STAT:QUES:RLIM:CHAN1:ECH:COND? the Questionable Ripple Limit Channel Extra Status Condition Register set for channel 1, if trace 16 is active and the ripple limit test is failing for this trace. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-251...
Page 272
0 for no event occurred and 1 for an event based on the transition type used for the ripple limit test. Group Status commands Syntax STATus:QUEStionable:RLIMit:CHANnel<x>:ECHannel:[EVENt]? Related Commands STATus:QUEStionable:RLIMit:CHANnel<x>:ECHannel:NTRansition STATus:QUEStionable:RLIMit:CHANnel<x>:ECHannel:PTRansition Returns Command variables. <x> is the channel number (1 to 16). <NR1> DRAFT – 01/24/2019 2-252 TTR500 Series Programmer Manual...
Page 273
If the ripple limit test result changes from fail (1) to pass (0), the query may return 1, 2, or 3, depending on which traces saw the transition occurred on channel 1: STAT:QUES:RLIM:CHAN1:ECH:NTR 3 STAT:QUES:RLIM:CHAN1:ECH:EVEN? DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-253...
Page 274
(1), the query may return 1, 2, or 3, depending on which traces saw the transition occurred on channel 1: STAT:QUES:RLIM:CHAN1:ECH:PTR 3 STAT:QUES:RLIM:CHAN1:ECH:EVEN? STATus:QUEStionable:RLIMit:CHANnel<x>:ENABle Set or query the value of the Questionable Ripple Limit Channel Status Enable Register for the specified channel. Group Status commands DRAFT – 01/24/2019 2-254 TTR500 Series Programmer Manual...
Page 275
If the ripple limit test result changes from pass (0) to fail (1) for all three enabled traces, the query may return 112, indicating that the transition occurred on channel 1: STAT:QUES:RLIM:CHAN1:PTR 112 STAT:QUES:RLIM:CHAN1:EVEN? DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-255...
Page 276
0 to a 1. This occurs during the ripple limit test, when the test result transitions from pass (0) to fail (1). Traces 1-14 are only used, representing bits 1-14. Group Status commands DRAFT – 01/24/2019 2-256 TTR500 Series Programmer Manual...
Page 277
Examples may return 15, which is the value of the Questionable STAT:QUES:RLIM:COND? Ripple Limit Status Condition Register. STATus:QUEStionable:RLIMit:ELIMit:CONDition? (Query Only) Query the value of the Questionable Ripple Limit Extra Status Condition Register. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-257...
Page 278
5, which is the value of the Questionable STAT:QUES:RLIM:ENAB? Ripple Limit Status Enable Register. STATus:QUEStionable:RLIMit:[EVENt]? (Query Only) Set or query the value of the Questionable Ripple Limit Status Event Register. Group Status commands Syntax STATus:QUEStionable:RLIMit:[EVENt]? DRAFT – 01/24/2019 2-258 TTR500 Series Programmer Manual...
Page 279
Limit Status Register. You cannot set bits 0 and 3-15 to 1. Group Status commands Syntax STATus:QUEStionable:RLIMit:PTRansition STATus:QUEStionable:RLIMit:PTRansition? Arguments is the value of the positive transition filter of the Questionable <value>::=<NR1> Ripple Limit Status Register. Returns <NR1> DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-259...
Page 280
96, indicating that SBR contains the binary 0110 0000. *STB? SYSTem:BEEPer:WARNing:IMMediate (No Query Form) Generate an immediate beep to verify if the warning beep works properly. Group System commands Syntax SYSTem:BEEPer:WARNing:IMMediate Arguments None DRAFT – 01/24/2019 2-260 TTR500 Series Programmer Manual...
Page 281
Set or query the state of the bias tee function. Group System commands Syntax SYSTem:BIAStee <value> SYSTem:BIAStee? Arguments <value>::=<boolean> Returns 1 means the bias tee function is turned on. 0 means the bias tee function is turned off. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-261...
Page 282
Set or display the model name of the power meter used with the TTR500 instrument. Group System commands Syntax SYSTem:COMMunicate:VISA:PMETer:MODel <string> SYSTem:COMMunicate:VISA:PMETer:MODel? Arguments is the model name of the power meter. Select one from the following <string> list: DRAFT – 01/24/2019 2-262 TTR500 Series Programmer Manual...
Page 283
<value>::=<string> Examples connects VectorVu-PC to the SYST:CONN “TTR506A_Y010060_C3022822” specified TTR500 instrument. returns the instrument name currently connected to VectorVu-PC. SYST:CONN? SYSTem:CORRection:PERFormance Set or query the corrected performance measurement. Group System commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-263...
Page 284
0 means system error correction is turned off. Examples enables system error correction. SYST:CORR:STAT 1 may return 0, which means system error correction is SYST:CORR:STAT? disabled. SYSTem:DISConnect (No Query Form) Disconnect the disaggregate TTR500 instrument. Group System commands DRAFT – 01/24/2019 2-264 TTR500 Series Programmer Manual...
Page 285
If this command finds no errors, the return value will be 0. Group System commands Syntax SYSTem:ERRor:ALL? Returns <error code>,<error/event description>,<error/event details> Examples may return a list of all errors, descriptions and details about SYST:ERR:ALL? errors or events. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-265...
Page 286
SYSTem:ERRor:COUNt? (Query Only) Display the total number of errors and events. Group System commands Syntax SYSTem:ERRor:COUNt? Returns <NR1> Examples may return 6, which is the total number of errors and events. SYST:ERR:COUN? DRAFT – 01/24/2019 2-266 TTR500 Series Programmer Manual...
Page 287
SYST:PRES:MODE FAC may return USER, which means the preset mode is set to user. SYST:PRES:MODE? SYSTem:SERVice? (Query Only) Query the operating mode (normal or service mode) for the TTR500 instrument. Group System commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-267...
Page 288
0, which means the stacking test is disabled for SYST:STAC:TEST? the TTR500 instrument. SYSTem:STACking:TIMing Set or query the state of the stacking timing test for the TTR500 instrument. Group System commands Syntax SYSTem:STACking:TIMing <value> SYSTem:STACking:TIMing? DRAFT – 01/24/2019 2-268 TTR500 Series Programmer Manual...
Page 289
SYSTem:TEMPerature:[STATe]? Returns 1 means the TTR500 instrument is warmed up. 0 means the TTR500 instrument is not warmed up. Examples may return 1, which means the TTR500 instrument is SYST:TEMP:STAT? warmed up. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-269...
Page 290
file used to preset the TTR500 instrument. <value>::=<string> Examples sets the TTR500 to user1 as the file for preset SYST:UPR:FILE “user1” conditions. TRIGger:AVERage Set or query the averaging trigger function. Group Trigger commands DRAFT – 01/24/2019 2-270 TTR500 Series Programmer Manual...
Page 291
This command generates a trigger and executes a measurement, independently of the SCPI manual trigger mode settings. Unlike , the execution of the object is complete at the TRIGger:SEQuence:SINGle same time as the trigger. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-271...
Page 292
1 means the point trigger is turned on. 0 means the point trigger is turned off. Examples enables the point trigger. TRIG:SEQ:POIN 1 may return 0, which means the point trigger is disabled. TRIG:SEQ:POIN? DRAFT – 01/24/2019 2-272 TTR500 Series Programmer Manual...
Page 293
Use triggers to synchronize measurements with external events. The trigger function requires VectorVu-PC to have an active connection to a TTR500 unit. The trigger function does not work in simulator mode. Group Trigger commands DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-273...
Page 294
SCPI commands as the trigger source used to TRIG:SEQ:SOUR BUS synchronize measurements with external events. may return MAN, which is the trigger source used to TRIG:SEQ:SOUR? synchronize measurements with external events. DRAFT – 01/24/2019 2-274 TTR500 Series Programmer Manual...
Page 295
This command allows you to synchronize the analyzer operations with your application program. For more details, refer to Synchronizing Execution (See page 3-9.). Group IEEE common commands Syntax *WAI Related Commands *OPC Arguments None DRAFT – 01/24/2019 TTR500 Series Programmer Manual 2-275...
4 registers and 1 queue that conform to IEEE Std 488.2-1987. This section discusses these registers and queues along with status and event processing. Status and Event Reporting System The status and event reporting mechanism in the TTR500 series analyzers has two major blocks: Standard Event Status Operation Status The processes performed in these blocks are summarized in the Status Byte.
Page 300
Status and Events DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
The SBR is made up of 8 bits. Bits 4, 5 and 6 are defined in accordance with IEEE Std 488.2-1987. These bits are used to monitor the output queue, SESR and service requests, respectively. Contents of this register are returned when the *STB? query is used. DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
SRER. Bit 6 must normally be set to 0. *SRE? Standard Event Status Block This block reports the power on/off state, command errors, and the running state. It consists of the following 2 registers: DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Page 303
The SBR OAV bit is also set. If the bit corresponding to the event has also been set in the ESER, the SBR ESB bit is also set. When a message is sent to the Output Queue, the SBR MAV bit is set. DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
If the bit corresponding to the event is also set in the OENR, the SBR OSS bit will also be set. Queues There are two types of queues in the status reporting system used in the analyzer: output queues and event queues. DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
-350 ("Queue Overflow"). The error code and text are retrieved using the queries. SYSTem:ERRor Status and Event Processing Sequence The following figure shows an outline of the sequence for status and event processing: DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Page 306
5. Setting either the ESB or MAV bits in the SBR sets the respective bit in the SRER. 6. When the SRER bit is set, the SBR MSS bit is set and a service request is generated when using the GPIB interface. DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
:TRIGger:SINGle; // Generate a trigger signal *OPC? // Wait for measurement to complete :SYSTem:ERRor? //Query if an error has occurred :CALCulate1:DATA:SDATa? // Query the measurement results The command waits for generation of SRQ. DRAFT – 01/24/2019 TTR500 Series Programmer Manual...
Page 308
*WAI the following example: ABOR:INIT:IMM:*WAI // Wait for the *WAI process to provide synchronization Commands and queries subsequent to *WAI are held off until the wait completes. DRAFT – 01/24/2019 3-10 TTR500 Series Programmer Manual...
Expression data not allowed Expression data element was received at invalid position. Execution error Error in execution. Measurement in progress - init ignored Init command received while measurement is in progress. Init command is ignored. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 3-11...
Unable to perform partial override when the No calibration method specified. calibration method is not specified. Correction not enabled. No Error correction cannot be enabled because calibration data exists. no calibration data exists. DRAFT – 01/24/2019 3-12 TTR500 Series Programmer Manual...
Page 311
Unable to locate signal generator based on specified VISA resource name. Unable to control external signal Unable to control external signal generator. generator. Unable to communicate with power Unable to communicate with power meter. meter. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 3-13...
Page 312
USB Storage get state failure. Unable to get state of USB Storage. Instrument activation failed. Instrument already claimed. Instrument already activated. Instrument activation failed. Instrument activation failed. Device is not connected to USB. DRAFT – 01/24/2019 3-14 TTR500 Series Programmer Manual...
Global power or IF BW changed - the per-segment power / updated segment table accordingly IF BW were overridden in the segment table Notifications Notification ID Message Description 2000 Instrument connected A TTR500 unit has been connected. DRAFT – 01/24/2019 TTR500 Series Programmer Manual 3-15...
Need help?
Do you have a question about the TTR500 Series and is the answer not in the manual?
Questions and answers