S820E Microwave Site Master™ Programming Manual : Vector Voltmeter Mode Commands
 
Vector Voltmeter Mode Commands
 
:INITiate:HOLD OFF|ON|0|1
:SOURce:POWer LOW|HIGH
[:SENSe]:AVERage:CLEar
[:SENSe]:AVERage:COUNt <integer>
[:SENSe]:CORRection:CKIT:SELect# <"calibration-kit name">
[:SENSe]:CORRection:CKIT:USER#:COAX:SOLT:THRU:OFFSet DISTance|TIME, <param-value>
[:SENSe]:CORRection:CKIT:USER#:WGUid:SOLT|SSLT:FCUToff <param-value>
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SOLT:OPEN C0|C1|C2|C3|OFFSet, <param-value>
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SOLT:SHORt L0|L1|L2|L3|OFFSet, <param-value>
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SOLT|SSLT:NAMe <"calibration-kit name">
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SSLT:SHORt[1]|2 L0|L1|L2|L3|OFFSet, <param-value>
[:SENSe]:CORRection:COLLect:ABORt
[:SENSe]:CORRection:COLLect:CONNector# NMALe|NFEMale|KMALe|KFEMale|716Male|716Female|TNCMale|TNCFemale|SMAMale|SMAFemale|WG11|WG12|WG13|WG14|WG15|WG16|WG17|WG18|WG20|WG22|USR1|USR2|USR3|USR4|USR5|USR6|USR7|USR8|USR9|USR10
[:SENSe]:CORRection:COLLect:LOAD
[:SENSe]:CORRection:COLLect:MEDium COAX|WGUide
[:SENSe]:CORRection:COLLect:OPEN
[:SENSe]:CORRection:COLLect:SAVe
[:SENSe]:CORRection:COLLect:SHORt
[:SENSe]:CORRection:COLLect:TYPE RFP1|2PFP|RRP1|TRFP
[:SENSe]:CORRection:COLLect[:ACQUire] OPEN|SHORT|SHORT1|SHORT2|LOAD|THRu|ISOLation|ZERo, 1|2|3
[:SENSe]:CORRection[:STATe] ON|OFF|1|0
[:SENSe]:RFON[:STATe] ON|OFF|1|0
[:SENSe]:SWEep:IFBW <frequency>{ Hz|kHz|MHz|GHz}
[:SENSe]:VVM:DATA:CLEar 1-12
[:SENSe]:VVM:DATA:MEMorize 1-12
[:SENSe]:VVM:DISPlay:FORMat CW|TABLe
[:SENSe]:VVM:DISPlay:RESolution 1|2
[:SENSe]:VVM:FORMat LMP|LNMP|VSWR|IMPedance
[:SENSe]:VVM:FREQuency:CW <frequency>{ Hz|kHz|MHz|GHz}
[:SENSe]:VVM:IMPedance 50|75
[:SENSe]:VVM:REFerence:CLEar
[:SENSe]:VVM:REFerence:MEMorize
[:SENSe]:VVM:TYPe REFLection|TRANsmission|A/B|B/A
The commands in this section apply to the Vector Voltmeter (VVM) mode.
:FETCh:VVM:DATA?
Query Description
Returns the measurement data in comma separated values depending upon the measurement type and the measurement format. If no signal is detected, query returns a blank string.
Example
To fetch the VVM measurement data:
:FETC:VVM:DATA?
:FETCh:VVM:MEASurement#? ABSolute|RELative
Query Description
Returns the absolute or relative data at a specified measurement location in the table display format. Data must be memorized to that location before it can be returned. If no signal is detected, query returns a blank string.
Example
To fetch the absolute data memorized at measurement location 2:
:FETC:VVM:MEASurement2? ABS
Notes
Replace ’#’ with the required measurement number in the table.

:FETCh:VVM:REFerence:DATA?
Query Description
Returns the reference data in comma separated values depending upon the measurement type and the measurement format. If no reference was saved, query returns a blank string.
Example
To fetch the VVM reference data:
:FETC:VVM:REF:DATA?
:INITiate:HOLD OFF|ON|0|1
:INITiate:HOLD?
Cmd Description
Command sets the sweep state between run and hold. This command is ignored in external trigger mode.
Query Description
Query returns the sweep state, run or hold. Query returns 1 for hold mode, and returns 0 for run mode.
Param Range
OFF|ON|0|1
Default Value
OFF|0
Example
To set the sweep state to hold:
:INIT:HOLD ON
:SOURce:POWer LOW|HIGH
:SOURce:POWer?
Cmd Description
Command sets the source power level. Default is high.
Query Description
Query returns the source power level, LOW or HIGH.
Example
To set source power to low:
SOUR:POW LOW
:STATus:OPERation?
Query Description
Queries sweep status. This is used in combination with :INITiate[:IMMediate]. Sweep complete bit is the bit 8. Query returns 256 if sweep has completed. Otherwise, it returns 0.
Example
To query sweep status:
:STAT:OPER?
[:SENSe]:AVERage:CLEar
Cmd Description
Clears and restarts averaging of the measurement data.
Example
To clear and restart averaging of the measurement data:
AVER:CLE
[:SENSe]:AVERage:COUNt <integer>
[:SENSe]:AVERage:COUNt?
Cmd Description
Command sets number of sweeps to be averaged. When number of sweep averaging is set to be greater than 1, averaging is turned on.
Query Description
Query returns the number of sweeps to be averaged.
Param Range
1 to 100
Default Value
1
Example
To set the number of sweep averaging to 10:
:AVER:COUN 10
[:SENSe]:CALibration:STATe?
Query Description
Query returns the state of calibrated measurements depending on the calibration collection type. 0 means no calibration was done. For calibration types RFP1 & RRP1, return value is 1. For calibration types TRFP & TRES, return value is 4. For calibration types 2PFP & 2PES, return value is 5.
Example
To query state after calibration is completed:
:CAL:STAT?
[:SENSe]:CORRection:CKIT:CATalog:FULL? {1|2}
Query Description
Query returns the available calibration kits for the selected port. The available ports depend on the calibration collection type.
Param Type
Integer
Param Description
Optional Param: Port number
Param Range
1|2
Example
To get the available cal-kits for port 1:
:CORR:CKIT:CAT:FULL? 1
Notes
In Cable & Antenna Analyzer and Vector Volt Meter modes, only port 1 is available for calibration. In Vector Network Analyzer mode, port 1 and port 2 are available for calibration.

[:SENSe]:CORRection:CKIT:DATA? {1|2}
Query Description
Query returns the calibration kit data as a comma-delimited string with description-value pairs for the selected port. The available ports depend on the calibration collection type.
Param Type
Integer
Param Description
Optional Param: Port number, default is 1.
Param Range
1|2
Example
To get the cal-kit data for port 1:
:CORR:CKIT:DATA? 1
Notes
In Cable & Antenna Analyzer and Vector Volt Meter modes, only port 1 is available for calibration. In Vector Network Analyzer mode, port 1 and port 2 are available for calibration.
[:SENSe]:CORRection:CKIT:SELect# <"calibration-kit name">
[:SENSe]:CORRection:CKIT:SELect#?
Cmd Description
Command sets the calibration kit for the selected port. The available ports depend on the calibration collection type. Before setting the calibration kit, make sure the device is set to the appropriate connector type (refer [:SENSe]:CORRection:COLLect:CONNector#). A mismatch between the connector type and the given calibration kit will result in a command error.
Query Description
Query returns the calibration kit for the selected port.
Param Type
String
Param Description
Calibration kit name
Example
To set the cal-kit for the connector at port 1:
:CORR:CKIT:SEL1 "OSLN50A-18"
Notes
Replace ’#’ with the required port number. Advanced/Classic Cable & Antenna Analyzer and Vector Volt Meter modes support only one port. Vector Network Analyzer mode supports two ports.
[:SENSe]:CORRection:CKIT:USER#:COAX:SOLT:THRU:OFFSet DISTance|TIME, <param-value>
[:SENSe]:CORRection:CKIT:USER#:COAX:SOLT:THRU:OFFSet? DISTance|TIME
Cmd Description
Command sets the user calibration kit thru offset value in Distance or Time.
Query Description
Query returns the user calibration kit thru offset value.
Param Range
Param1: DISTance|TIME, Param2: value (DISTance:mm, TIME:s)
Example
To set the thru offset in distance for the second user cal-kit:
:CORR:CKIT:USER2:COAX:SOLT:THRU:OFFS DIST, 20
Notes
Replace ’#’ with the required kit number. Ten user calibration kits are supported.
[:SENSe]:CORRection:CKIT:USER#:WGUid:SOLT|SSLT:FCUToff <param-value>
[:SENSe]:CORRection:CKIT:USER#:WGUid:SOLT|SSLT:FCUToff?
Cmd Description
Command sets the waveguide user calibration kit frequency cutoff value.
Query Description
Query returns the waveguide user calibration kit Cutoff Frequency.
Param Range
Param1: FCUToff: GHz
Default Units
GHz
Example
To set the Cutoff Frequency of SSLT Waveguide kit to 5GHz:
:CORR:CKIT:USER2:WGU:SSLT:FCUT 5
Notes
Replace ’#’ with the required kit number. Ten user calibration kits are supported.
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SOLT:OPEN C0|C1|C2|C3|OFFSet, <param-value>
[:SENSe]:CORRection:CKIT:USER#:WGUid:SOLT:OPEN? C0|C1|C2|C3|OFFSet
Cmd Description
Command sets the user calibration kit capacitance or offset value for OPEN.
Query Description
Query returns the user calibration kit capacitance or offset value for OPEN.
Param Range
Param1: C0|C1|C2|C3|OFFSet, Param2: value (C0:e-15F, C1:e-27F, C2:e-36F, C3:e-45F, OFFSet:mm)
Example
To set the capacitance 1 for the second user cal-kit of WGUid line type and SOLT cal method:
:CORR:CKIT:USER2:WGUid:SOLT:OPEN C1, 20
Notes
Replace ’#’ with the required kit number. Ten user calibration kits are supported.
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SOLT:SHORt L0|L1|L2|L3|OFFSet, <param-value>
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SOLT:SHORt? L0|L1|L2|L3|OFFSet
Cmd Description
Command sets the user calibration kit Inductance or offset value for SHORT.
Query Description
Query returns the user calibration kit inductance or offset value for SHORt.
Param Range
Param1: L0|L1|L2|L3|OFFSet, Param2: value (L0:e-12H, L1:e-24H, L2:e-33H, L3:e-42H, OFFSet:mm)
Example
To set the inductance 1 for the second user cal-kit of Coax line type and SOLT cal method:
:CORR:CKIT:USER2:COAX:SOLT:SHORt L1, 20
Notes
Replace ’#’ with the required kit number. Ten user calibration kits are supported.
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SOLT|SSLT:NAMe <"calibration-kit name">
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SOLT|SSLT:NAMe?
Cmd Description
Command sets the user calibration kit name.
Query Description
Query returns the user calibration kit name.
Param Type
String
Param Description
Calibration kit name
Example
To set the name for the second user cal-kit:
:CORR:CKIT:USER2:COAX:SOLT:NAM "My_Cal_Kit"
Notes
Replace ’#’ with the required kit number. Ten user calibration kits are supported.
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SSLT:SHORt[1]|2 L0|L1|L2|L3|OFFSet, <param-value>
[:SENSe]:CORRection:CKIT:USER#:WGUid|COAX:SSLT:SHORt[1]|2? L0|L1|L2|L3|OFFSet
Cmd Description
Command sets the user calibration kit inductance or offset value for SHORT1 or SHORT2.
Query Description
Query returns the user calibration kit inductance or offset value for SHORT.
Param Range
Param1: L0|L1|L2|L3|OFFSet, Param2: value (L0:e-12H, L1:e-24H, L2:e-33H, L3:e-42H, OFFSet:mm)
Example
To set the inductance 1 for the second user cal-kit of Coax line type and SOLT cal method:
:CORR:CKIT:USER2:COAX:SSLT:SHORt1 L1, 20
Notes
Replace ’#’ with the required kit number. Ten user calibration kits are supported.
[:SENSe]:CORRection:COLLect:ABORt
Cmd Description
Aborts all steps of the RF calibration.
Example
To abort RF calibration:
:CORR:COLL:ABOR
[:SENSe]:CORRection:COLLect:ACQUire:STATus? OPEN|SHORT|SHORT1|SHORT2|LOAD|THRu|ISOLation|ZERo, 1|2|3
Query Description
Query returns 1 if a specified cal step is completed. Otherwise, query returns 0. If no query parameters are provided, then the last cal step status is returned. If no cal was performed, then the query returns 0. For cal step OPEN|SHORT|SHORT1|SHORT2|LOAD|ZERo, use port numbers 1 and 2. For cal step THRu|ISOLation, use 1 for forward path, 2 for reverse path, and 3 for both forward and reverse paths.
Param Type
Character, Integer
Param Description
Param1: Cal step to perform, Param2: Port number or forward/reverse path
Param Range
OPEN|SHORT|SHORT1|SHORT2|LOAD|THRu|ISOLation|ZERo, 1|2|3
Example
To query calibration step ’Open’ status at port 1:
:CORR:COLL:ACQU:STAT? OPEN, 1
[:SENSe]:CORRection:COLLect:CONNector# NMALe|NFEMale|KMALe|KFEMale|716Male|716Female|TNCMale|TNCFemale|SMAMale|SMAFemale|WG11|WG12|WG13|WG14|WG15|WG16|WG17|WG18|WG20|WG22|USR1|USR2|USR3|USR4|USR5|USR6|USR7|USR8|USR9|USR10
[:SENSe]:CORRection:COLLect:CONNector#?
Cmd Description
Command sets connector type.
Query Description
Query returns connector type.
Param Range
NMALe|NFEMale|KMALe|KFEMale|716Male|716Female|TNCMale|TNCFemale|SMAMale|SMAFemale|USR1|USR2|USR3|USR4|USR5|USR6|USR7|USR8|USR9|USR10 for Coax; WG11|WG12|WG13|WG14|WG15|WG16|WG17|WG18|WG20|WG22|USR1|USR2|USR3|USR4|USR5|USR6|USR7|USR8|USR9|USR10 for Waveguide
Default Value
NMAL for S820E with option 708 or 714. KFEM for S820E with option 720, 730 or 740.
Example
To set connector type for port 1 to 716 female:
:CORR:COLL:CONN1 716F
Notes
Replace ’#’ with the required port number. Advanced/Classic Cable & Antenna Analyzer and Vector Volt Meter modes support only one port. Vector Network Analyzer mode supports two ports.

[:SENSe]:CORRection:COLLect:INFO:STATus?
Query Description
Query returns 0 if calibration is not in progress, 1 if calibration is in progress, 2 if calibration was aborted, 3 if cal-coefficients are being calculated, or 4 if calibration has completed.
Example
To query calibration progress status:
:CORR:COLL:INFO:STAT?
[:SENSe]:CORRection:COLLect:LOAD
Cmd Description
Perform ’Load’ step of calibration.
Example
To measure load:
:CORR:COLL:LOAD
[:SENSe]:CORRection:COLLect:MEDium COAX|WGUide
[:SENSe]:CORRection:COLLect:MEDium?
Cmd Description
Command sets calibration medium type.
Query Description
Query returns calibration medium type.
Param Range
COAX|WGUide
Default Value
COAX
Example
To set medium type to WGUide:
:CORR:COLL:MED WGU
[:SENSe]:CORRection:COLLect:OPEN
Cmd Description
Perform ’Open’ step of calibration.
Example
To measure open:
:CORR:COLL:OPEN
[:SENSe]:CORRection:COLLect:SAVe
Cmd Description
Complete an RF Cal and perform coefficient calculation.
Example
To complete a RF calibration and perform coefficient calculation:
:CORR:COLL:SAV
[:SENSe]:CORRection:COLLect:SHORt
Cmd Description
Perform ’Short’ step of calibration.
Example
To measure short:
:CORR:COLL:SHOR
[:SENSe]:CORRection:COLLect:TYPE RFP1|2PFP|RRP1|TRFP
[:SENSe]:CORRection:COLLect:TYPE?
Cmd Description
Command sets calibration collection type.
Query Description
Query returns calibration collection type.
Param Range
RFP1|2PFP|RRP1|TRFP
Default Value
RFP1
Example
To set collection type to RFP1:
:CORR:COLL:TYPE RFP1
[:SENSe]:CORRection:COLLect[:ACQUire] OPEN|SHORT|SHORT1|SHORT2|LOAD|THRu|ISOLation|ZERo, 1|2|3
[:SENSe]:CORRection:COLLect[:ACQUire]?
Cmd Description
Command performs a calibration step with the given two parameters. For cal step OPEN|SHORT|SHORT1|SHORT2|LOAD|ZERo, use port numbers 1 and 2. For cal step THRu|ISOLation, use 1 for forward path, 2 for reverse path, and 3 for both forward and reverse paths.
Query Description
Query returns the last measurement performed, which includes cal step and port number. If no cal step was done, query returns "NONE, 0".
Param Type
Character, Integer
Param Description
Param1: Cal step to perform, Param2: Port number or forward/reverse path
Param Range
OPEN|SHORT|SHORT1|SHORT2|LOAD|THRu|ISOLation|ZERo, 1|2|3
Example
To measure short on port 1:
:CORR:COLL SHORT, 1
[:SENSe]:CORRection[:STATe] ON|OFF|1|0
[:SENSe]:CORRection[:STATe]?
Cmd Description
Command sets correction status.
Query Description
Query returns correction status. Query returns 1 if RF cal is on. Otherwise, it returns 0.
Param Range
ON|OFF|1|0
Default Value
OFF|0
Example
To turn calibration correction on:
:CORR:STAT ON
[:SENSe]:RFON[:STATe] ON|OFF|1|0
[:SENSe]:RFON[:STATe]?
Cmd Description
Command sets the RF power output state when the sweep is in Hold mode.
Query Description
Query returns the RF power output state when the sweep is in Hold mode.
Param Range
ON|OFF|1|0
Default Value
ON|1
Example
To set RF power output state off:
:RFON OFF
[:SENSe]:SWEep:IFBW <frequency>{ Hz|kHz|MHz|GHz}
[:SENSe]:SWEep:IFBW?
Cmd Description
Command sets the IF bandwidth. The permissible values are 10Hz, 100Hz, 1kHz, 2kHz, and 100kHz.
Query Description
Query returns the IF bandwidth.
Param Type
Float
Param Description
Bandwidth frequency
Default Units
Hz
Example
To set IFBW to 1000Hz:
:SWE:IFBW 1 kHz
[:SENSe]:VVM:DATA:CLEar 1-12
Cmd Description
Clear the data at a specified measurement location for the table display format.
Param Range
1 to 12
Example
To clear the data at measurement location 2:
:VVM:DATA:CLE 2
[:SENSe]:VVM:DATA:MEMorize 1-12
Cmd Description
Memorize the data at a specified measurement location for the table display format.
Param Range
1 to 12
Example
To memorize the data at measurement location 2:
:VVM:DATA:MEM 2
[:SENSe]:VVM:DISPlay:FORMat CW|TABLe
[:SENSe]:VVM:DISPlay:FORMat?
Cmd Description
Sets the VVM display format.
Query Description
Query returns the VVM display format.
Param Range
CW|TABLe
Example
To set the VVM display format to table:
:VVM:DISP:FORM TABL
[:SENSe]:VVM:DISPlay:RESolution 1|2
[:SENSe]:VVM:DISPlay:RESolution?
Cmd Description
Sets the VVM display resolution.
Query Description
Query returns the VVM display resolution.
Param Range
1|2
Example
To set the VVM display resolution to 2:
:VVM:DISP:RES 2
[:SENSe]:VVM:FORMat LMP|LNMP|VSWR|IMPedance
[:SENSe]:VVM:FORMat?
Cmd Description
Sets the VVM measurement format.
Query Description
Query returns the VVM measurement format.
Param Range
LMP|LNMP|VSWR|IMPedance
Example
To set the VVM measurement format to VSWR:
:VVM:FORM VSWR
[:SENSe]:VVM:FREQuency:CW <frequency>{ Hz|kHz|MHz|GHz}
[:SENSe]:VVM:FREQuency:CW?
Cmd Description
Command sets the measurement frequency.
Query Description
Query returns the measurement frequency in Hertz.
Param Type
Float
Param Description
Measurement frequency
Default Value
Model-dependent
Default Units
Hz
Example
To set the Measurement frequency to 2 GHz:
:VVM:FREQ:CW 2 GHz
[:SENSe]:VVM:IMPedance 50|75
[:SENSe]:VVM:IMPedance?
Cmd Description
Command sets the reference impedance in Ohms.
Query Description
Query returns the reference impedance in Ohms.
Param Range
50|75
Example
To set the reference impedance to 75 Ohms:
:VVM:IMP 75
[:SENSe]:VVM:REFerence:CLEar
Cmd Description
Clears the reference data for the current measurement type.
Example
To clear the Reference:
:SENS:VVM:REF:CLE
[:SENSe]:VVM:REFerence:MEMorize
Cmd Description
Sets the reference data for the current measurement type.
Example
To set the new Reference:
:SENS:VVM:REF:MEM
[:SENSe]:VVM:TYPe REFLection|TRANsmission|A/B|B/A
[:SENSe]:VVM:TYPe?
Cmd Description
Sets the VVM measurement type.
Query Description
Query returns the VVM measurement type.
Param Range
REFLection|TRANsmission|A/B|B/A
Example
To set the VVM measurement type to transmission:
:VVM:TYP TRAN