VectorStar™ MS464xB Series Microwave Vector Network Analyzer Programming Manual : SCPI Commands : :CALCulate{1-16}[:SELected]:EYE Subsystem
 
:CALCulate{1-16}[:SELected]:EYE Subsystem
The :CALCulate{1-16}[:SELected]:EYE subsystem commands set configuration parameters for EYE calculations for the indicated channel.
Eye-diagram Configuration and Setup Validation
The eye-diagram setup commands in this subsystem require a sequence of steps and a valid setup:
1. Before sending any settings, the :CALCulate{1-16}[:SELected]:EYE:CONFigure:DEFine[:STATe] <char> command should be set to ON.
2. After changing the eye-diagram settings, issue :CALCulate{1-16}[:SELected]:EYE:EXECute to validate the settings.
3. Use :CALCulate{1-16}[:SELected]:EYE:CONFigure:STATus? to query for eye-diagram setup errors.
4. To view the values of eye-diagram settings, the :CALCulate{1-16}[:SELected]:EYE:CONFigure:DEFine[:STATe] <char> command must be set to OFF.
:CALCulate{1-16}[:SELected]:EYE:CONFigure:DEFine[:STATe] <char>
:CALCulate{1-16}[:SELected]:EYE:CONFigure:DEFine[:STATe]?
Description
Sets the eye configuration define mode on/off state for the active trace on the indicated channel.
Returns on/off state of the eye configuration define mode for the active trace of the indicated channel.
Cmd Parameters
<char> 1 | 0 | ON | OFF
Query Parameters
NA
Query Output
<char> 1 | 0
Range
NA
Default Value
0
Syntax Example
:CALC1:EYE:CONF:DEF 1
:CALC1:EYE:CONF:DEF?
 
:CALCulate{1-16}[:SELected]:EYE:CONFigure:STATus?
Description
Query only.
Returns the eye-diagram configure and setup status for the active trace on the indicated channel.
Cmd Parameters
NA
Query Parameters
NA
Query Output
<NR1> Query returns one of the following:
0 – Valid
1 – Invalid
2 – InvalidDataStreamSelection
3 – InvalidPatternLength
4 – InvalidRiseTime
5 – InvalidFallTime
6 – InvalidHighLowLevels
7 – InvalidRandomRMS
8 – InvalidDiracOffset
9 – InvalidDiracProbability
10 – InvalidSinAmp
11 – InvalidSinFreq
12 – InvalidNoiseRMSAmp
13 – InvalidUserFixedPattern
14 – TurnOnTEDFail
15 – DataRateWarning
16 – InvalidPAM4Eye1Level
17 – InvalidPAM4Eye2Level
18 – InvalidPAM4Eye3Level
Range
NA
Default Value
NA
Syntax Example
:CALC1:EYE:CONF:STAT?
:CALCulate{1-16}[:SELected]:EYE:EXECute
Description
Performs the calculation of the eye-diagram for the active trace of the indicated channel.
No query.
Cmd Parameters
NA
Query Parameters
NA
Query Output
NA
Range
NA
Default Value
NA
Syntax Example
:CALC1:EYE:EXEC
:CALCulate{1-16}[:SELected]:EYE:INPut:BPATtern:TYPE <char>
:CALCulate{1-16}[:SELected]:EYE:INPut:BPATtern:TYPE?
Description
Sets the input bit pattern type on the active trace of the indicated channel.
Returns the bit pattern type on the active trace of the indicated channel.
Parameter definitions are:
• PRBS = Pseudo‑Random Bit Sequence
• K285 = K 28.5
• USER = User fixed pattern
Cmd Parameters
<char> PRBS | K285 | USER
Query Parameters
NA
Query Output
<char> PRBS | K285 | USER
Range
NA
Default Value
PRBS
Syntax Example
:CALC1:EYE:INP:BPAT:TYPE K285
:CALC1:EYE:INP:BPAT:TYPE?
:CALCulate{1-16}[:SELected]:EYE:INPut:BPATtern:LENGth <int>
:CALCulate{1-16}[:SELected]:EYE:INPut:BPATtern:LENGth?
Description
Sets bits’ power of 2 for PRBS / K28.5 pattern.
This value is used only when the bit pattern type is selected as PRBS / K28.5. (In the user fixed pattern scenario, the pattern length is set by the number of bits entered by the user (up to a maximum limit of 64).)
Returns the bit pattern length on the active trace of the indicated channel.
Cmd Parameters
<int> 5 | 7 | 9 | 11 | 13 | 15 | 17 | 19 | 21
Query Parameters
NA
Query Output
<int>
31 = 25 – 1
127= 27 – 1
511= 29 – 1
2047= 211 – 1
8191= 213 – 1
32767= 215 – 1
131071= 217 – 1
524287= 219 – 1
2097151= 221 – 1
Range
NA
Default Value
511
Syntax Example
:CALC1:EYE:INP:BPAT:LENG 11
:CALC1:EYE:INP:BPAT:LENG?
:CALCulate{1-16}[:SELected]:EYE:INPut:BPATtern:USER <string>
Description
Sets the user fixed pattern on the active trace of the indicated channel.
No query.
Cmd Parameters
< string > String with 0s and 1s only, maximum length allowed is 64bits.
Query Parameters
NA
Query Output
NA
Range
Maximum length allowed is 64 bits
Default Value
NA
Syntax Example
:CALC1:EYE:INP:BPAT:USER '10001011110'
:CALCulate{1-16}[:SELected]:EYE:INPut:DRATe <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:DRATe?
Description
Sets the input data rate (bit rate) on the active trace of the indicated channel.
Returns the data rate (bit rate) on the active trace of the indicated channel.
Cmd Parameters
<NRf> data rate value in GBPS
Query Parameters
NA
Query Output
<nr3> outputs the set data rate value in GBPS
Range
Data rate should be positive numbers only
Default Value
1 GBPS
Syntax Example
:CALC1:EYE:INP:DRAT 2
:CALC1:EYE:INP:DRAT?
:CALCulate{1-16}[:SELected]:EYE:INPut:HSHift <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:HSHift?
Description
Sets the horizontal shift of eye on the active trace of the indicated channel.
Returns the horizontal shift of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<NRf> Horizontal shift represented in fraction of a Bit Period
Query Parameters
NA
Query Output
<nr3> outputs the horizontal shift represented in fraction of a Bit Period
Range
–0.5 to +0.5
Default Value
0
Syntax Example
:CALC1:EYE:INP:HSH 0.5
:CALC1:EYE:INP:HSH?
:CALCulate{1-16}[:SELected]:EYE:INPut:RTIMe:DATA <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:RTIMe:DATA?
Description
Sets the rise time value of the input bit stream on the active trace of the indicated channel.
Returns the rise time value of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<NRf> rise time value in picoseconds (ps)
Query Parameters
NA
Query Output
<nr3> outputs the rise time value in picoseconds
Range
0 and larger, but may not be > 0.4/(Data rate)
Default Value
0 ps
Syntax Example
:CALC1:EYE:INP:RTIM:DATA 15
:CALC1:EYE:INP:RTIM:DATA?
:CALCulate{1-16}[:SELected]:EYE:INPut:FTIMe:DATA <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:FTIMe:DATA?
Description
Sets the fall time value of the input bit stream on the active trace of the indicated channel.
Returns the fall time value of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<NRf> fall time value in picoseconds (ps)
Query Parameters
NA
Query Output
<nr3> outputs the fall time value in picoseconds
Range
0 and larger, but may not be > 0.4/(Data rate)
Default Value
0 ps
Syntax Example
:CALC1:EYE:INP:FTIM:DATA 25
:CALC1:EYE:INP:FTIM:DATA?
:CALCulate{1-16}[:SELected]:EYE:INPut[:NRZ]:HLEVel <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut[:NRZ]:HLEVel?
Description
Sets the high voltage level on the active trace for NRZ signaling type.
(high level > low level)
Returns the high voltage level of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<NRf> High voltage level in mV
Query Parameters
NA
Query Output
<nr3> Outputs the high voltage level in mV
Range
–5000 mV to +5000 mV
Default Value
1000 mV
Syntax Example
:CALC1:EYE:INP:HLEV 5000
:CALC1:EYE:INP:HLEV?
:CALCulate{1-16}[:SELected]:EYE:INPut[:NRZ]:LLEVel <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut[:NRZ]:LLEVel?
Description
Sets the low voltage level type on the active trace for NRZ signaling type.
(high level > low level).
Returns the low voltage level of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<NRf> Low voltage level in mV
Query Parameters
NA
Query Output
<nr3> Outputs the low voltage level in mV
Range
–5000 mV to +5000 mV
Default Value
0 mV
Syntax Example
:CALC1:EYE:INP:LLEV 3000
:CALC1:EYE:INP:LLEV?
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:RANDom[:STATe] <char>
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:RANDom[:STATe]?
Description
Sets the Jitter‑Random RMS on/off for the active trace of the indicated channel
Returns the Jitter‑Random RMS state for the active trace of the indicated channel.
Cmd Parameters
<char> 1 | 0 | ON | OFF
Query Parameters
NA
Query Output
<char> 1 | 0
Range
NA
Default Value
0
Syntax Example
:CALC1:EYE:INP:JITT:RAND 1
:CALC1:EYE:INP:JITT:RAND?
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:RANDom:MAGNitude <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:RANDom:MAGNitude?
Description
Sets the Jitter‑Random Magnitude of the input bit stream on the active trace of the indicated channel. This value is used only when Random RMS state is ON.
Returns the Jitter‑Random Magnitude of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<NRf> Magnitude value in picoseconds (ps)
Query Parameters
NA
Query Output
<nr3> Outputs the magnitude value in picoseconds
Range
Must be ≥ 0 and < 0.4/(data rate).
Default Value
0 ps
Syntax Example
:CALC1:EYE:INP:JITT:RAND:MAGN 100
:CALC1:EYE:INP:JITT:RAND:MAGN?
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:DIRac{1-2}[:STATe] <char>
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:DIRac{1-2}[:STATe]?
Description
Sets the Jitter‑Dirac 1/2 settings on/off for the active trace of the indicated channel.
Returns the Jitter‑Dirac 1/2 settings state for the active trace of the indicated channel.
Cmd Parameters
<char> 1 | 0 | ON | OFF
Query Parameters
NA
Query Output
<char> 1 | 0
Range
NA
Default Value
0
Syntax Example
:CALC1:EYE:INP:JITT:DIR1 1
:CALC1:EYE:INP:JITT:DIR1?
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:DIRac{1-2}:OFFSet <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:DIRac{1-2}:OFFSet?
Description
Sets the Jitter‑Dirac 1/2 offset of the input bit stream on the active trace of the indicated channel. This value is used only when Dirac 1 settings state is ON.
Returns the Jitter‑Dirac 1/2 offset of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<NRf> Offset value in picoseconds (ps)
Query Parameters
NA
Query Output
<nr1> Outputs the offset value in picoseconds
Range
Must be ≥ 0 and < 0.4/(data rate).
Default Value
0 ps
Syntax Example
:CALC1:EYE:INP:JITT:DIR1:OFFS 10
:CALC1:EYE:INP:JITT:DIR1:OFFS?
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:DIRac{1-2}:PROBability <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:DIRac{1-2}:PROBability?
Description
Sets the Jitter‑Dirac 1/2 probability of the input bit stream on the active trace of the indicated channel. This value is used only when Dirac 1/2 settings state is ON.
Returns the Jitter‑Dirac 1/2 probability of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<nr2> probability value
Query Parameters
NA
Query Output
<nr2> outputs the probability value
Range
≥ 0 and ≤ 1 (The sum of the two probabilities cannot exceed 1 if both are enabled.)
Default Value
0.1
Syntax Example
:CALC1:EYE:INP:JITT:DIR1:PROB 0.2
:CALC1:EYE:INP:JITT:DIR1:PROB?
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:SINusoidal{1-2}[:STATe] <char>
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:SINusoidal{1-2}[:STATe]?
Description
Sets the Jitter‑Sinusoidal 1/2 settings on/off for the active trace of the indicated channel.
Returns the Jitter‑Sinusoidal 1/2 settings state for the active trace of the indicated channel.
Cmd Parameters
<char> 1 | 0 | ON | OFF
Query Parameters
NA
Query Output
<char> 1 | 0
Range
NA
Default Value
0
Syntax Example
:CALC1:EYE:INP:JITT:SIN1 1
:CALC1:EYE:INP:JITT:SIN1?
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:SINusoidal{1-2}:AMPLitude <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:SINusoidal{1-2}:AMPLitude?
Description
Sets the Jitter‑Sinusoidal 1/2 amplitude of the input bit stream on the active trace of the indicated channel. This value is used only when Sinusoidal 1 /2 settings state is ON.
Returns the Jitter‑Sinusoidal 1/2 amplitude of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<NRf> Amplitude value in picoseconds
Query Parameters
NA
Query Output
<nr1> Outputs the amplitude value in picoseconds
Range
Must be ≥ 0 and < 0.4/(data rate).
Default Value
0 ps
Syntax Example
:CALC1:EYE:INP:JITT:SIN1:AMPL 10
:CALC1:EYE:INP:JITT:SIN1:AMPL?
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:SINusoidal{1-2}:FREQuency <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:JITTer:SINusoidal{1-2}:FREQuency?
Description
Sets the Jitter‑Sinusoidal 1/2 frequency of the input bit stream on the active trace of the indicated channel. This value is used only when Sinusoidal 1/2 settings state is ON.
Returns the Jitter‑Sinusoidal 1/2 frequency of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<NRf> Frequency value in Hz
Query Parameters
NA
Query Output
<nr1> Outputs the frequency value in Hz
Range
Must be > 0 and < data rate.
Default Value
1000000 Hz
Syntax Example
:CALC1:EYE:INP:JITT:SIN1:FREQ 1000
:CALC1:EYE:INP:JITT:SIN1:FREQ?
:CALCulate{1-16}[:SELected]:EYE:INPut:NOISe[:STATe] <char>
:CALCulate{1-16}[:SELected]:EYE:INPut:NOISe[:STATe]?
Description
Sets the Noise‑RMS Amplitude on/off for the active trace of the indicated channel.
Returns the Noise‑RMS Amplitude state for the active trace of the indicated channel.
Cmd Parameters
<char> 1 | 0 | ON | OFF
Query Parameters
NA
Query Output
<char> 1 | 0
Range
NA
Default Value
0
Syntax Example
:CALC1:EYE:INP:NOIS 1
:CALC1:EYE:INP:NOIS?
:CALCulate{1-16}[:SELected]:EYE:INPut:NOISe:AMPLitude <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:NOISe:AMPLitude?
Description
Sets the Noise‑RMS Amplitude of the input bit stream on the active trace of the indicated channel. This value is used only when Noise settings state is ON.
Returns the Noise‑RMS Amplitude of the input bit stream on the active trace of the indicated channel.
Cmd Parameters
<NRf> amplitude value in mV
Query Parameters
NA
Query Output
<nr3> outputs the amplitude value in mV
Range
Must be less than high‑low level/2
Default Value
0 mV
Syntax Example
:CALC1:EYE:INP:NOIS:AMPL 100
:CALC1:EYE:INP:NOIS:AMPL?
:CALCulate{1-16}[:SELected]:EYE:INPut:PERSistence <NR1>
:CALCulate{1-16}[:SELected]:EYE:INPut:PERSistence?
Description
Sets the persistence value on the active trace of the indicated channel.
Returns the persistence value on the active trace of the indicated channel.
Cmd Parameters
<nr1> Persistence value
Query Parameters
NA
Query Output
<nr1> Outputs the set persistence value
Range
1 to 10000
Default Value
200
Syntax Example
:CALC1:EYE:INP:PERS 2
:CALC1:EYE:INP:PERS?
:CALCulate{1-16}[:SELected]:EYE[:NRZ]:RESults:DATA?
Description
Query only.
Returns the ‘eye measurement results’ for the active trace of the indicated channel for NRZ signaling.
Fourteen values (amplitude- and time-related parameters) are returned. This query will always return the values of all the amplitude- and time-related parameters of the selected eye trace, irrespective of whether the display for each parameter is turned ON or OFF.
Cmd Parameters
NA
Query Parameters
NA
Query Output
<string> This query returns string in <ACSII> format consisting of 14 fields separated by commas. The fields are:
• <Level Zero: {numeric}>
• <Level One: {numeric}>
• <Level Mean: {numeric}>
• <Amplitude: {numeric}>
• <Height: {numeric}>
• <Opening factor: {numeric}>
• <SNR: {numeric}>
• <CrossPercentage: {numeric}>
• <Width: {numeric}>
• <Rise time: {numeric}>
• <Fall time: {numeric}>
• <PP jitter: {numeric}>
• <RMS jitter: {numeric}>
• <Duty cycle distortion: {numeric}>
Range
NA
Default Value
NA
Syntax Example
:CALC1:EYE:RES:DATA?
:CALCulate{1-16}[:SELected]:EYE:PAM4:EYE{1-3}:RESults:DATA?
Description
Query only.
Returns the ‘eye measurement results’ for the active trace of the indicated channel for PAM-4 signaling.
Fourteen values (amplitude- and time-related parameters) are returned. This query will always return the values of all the amplitude- and time-related parameters of the selected eye trace, irrespective of whether the display for each parameter is turned ON or OFF.
Cmd Parameters
NA
Query Parameters
NA
Query Output
<string> This query returns string in <ACSII> format consisting of 14 fields separated by commas. The fields are:
• <Level Zero: {numeric}>
• <Level One: {numeric}>
• <Level Mean: {numeric}>
• <Amplitude: {numeric}>
• <Height: {numeric}>
• <Opening factor: {numeric}>
• <SNR: {numeric}>
• <CrossPercentage: {numeric}>
• <Width: {numeric}>
• <Rise time: {numeric}>
• <Fall time: {numeric}>
• <PP jitter: {numeric}>
• <RMS jitter: {numeric}>
• <Duty cycle distortion: {numeric}>
Range
NA
Default Value
NA
Syntax Example
:CALC1:EYE:PAM4:EYE1:RES:DATA?
:CALCulate{1-16}[:SELected]:EYE:INPut:SIGNaling:TYPE <char>
:CALCulate{1-16}[:SELected]:EYE:INPut:SIGNaling:TYPE?
Description
Sets the input signaling format for the active trace of the indicated channel.
Returns the input signaling format for the active trace of the given channel.
Cmd Parameters
<char> NRZ | PAM4
Query Parameters
NA
Query Output
<char> NRZ | PAM4
Range
NA
Default Value
NRZ
Syntax Example
:CALC1:EYE:INP:SIGN:TYPE NRZ
:CALC1:EYE:INP:SIGN:TYPE?
:CALCulate{1-16}[:SELected]:EYE:INPut:PAM4:LEVel{0-3} <NRf>
:CALCulate{1-16}[:SELected]:EYE:INPut:PAM4:LEVel{0-3}?
Description
Sets the indicated voltage level for PAM4 signaling type on the active trace of the indicated channel. The voltage level values should follow this relationship: Level0 < Level1 < Level2 < Level3, otherwise will result in error.
Returns the value of the indicated voltage level for PAM4 signaling type on the active trace of the indicated channel.
Cmd Parameters
<NRf> High voltage level in mV.
Query Parameters
NA
Query Output
<nr3> Outputs the high voltage level in mV.
Range
-5000mV to +5000mV
Default Value
Level0 = 0mV; Level1 = 333mV; Level2 = 666mV; Level3 = 1000
Syntax Example
:CALC1:EYE:INP:PAM4:LEV1 100
:CALC1:EYE:INP:PAM4:LEV1?