Command Syntax

:MEASure:EYE:PAM:LEVel

Query Syntax

:MEASure:EYE:PAM:LEVel?

Description

In Eye/Mask mode, measures all four amplitude levels (0, 1, 2, 3) of a PAM4 eye diagram. On NRZ signals, this measurement will measure the zero or one levels. Before sending this command, select the actual level to be measured using the :LEVel child command. To measure all the levels on a signal, you must send this command once for each level as there is no command for simultaneously measuring all levels. The query form of the command returns the measured value. Sources can be any displayed PAM4 or NRZ waveform from a channel, differential channel, color-grade memory, or function. For example, CHAN1A, CGMemory1, or FUNCtion1.

Measurement Identification

Avoid subtle programming errors! To ensure that the correct measurement is installed or queried, always explicitly identify a measurement when installing a measurement or querying a measured value, status, or detail. To identify a measurement, specify the measurement's source waveform (:SOURce child command). With some measurements, you may also need to specify other identifying values. Generally, when selecting a measurement using FlexDCA's GUI, if a dialog appears prompting you to select values, you should explicitly specify these values when remotely identifying the measurement. More information.

For example, to return the status of the measurement, :MEASure:EYE:PAM:LEVel:

flex.write(':MEASure:EYE:PAM:LEVel:SOURce CHAN1A')
if flex.query(':MEASure:EYE:PAM:LEVel:STATus?') == 'CORR';
    measurement = flex.query(':MEASure:EYE:PAM:LEVel?')
else:
	details = flex.query(':MEASure:EYE:PAM:LEVel:STATus:DETails?')
	reason = flex.query(':MEASure:EYE:PAM:LEVel:STATus:REASon?')

Child commands for measurement identification:

• :MEASure:EYE:PAM:LEVel:SOURce

Related Commands

Command	Equivalent Setting in PAM-N Analysis Setup Dialog	Description
:MEASure:PAM:EYE:ESTiming	Receiver Sample Timing	Configures the timing for sampling the signal data for all PAM measurements in Eye/Mask mode. Depending on measurement conditions, this command may not affect the measurement.
:MEASure:PAM:EYE:ELMethod	Eye Center Location	Selects the basis for determining the location of an eye's center on the waveform: at maximum eye width or maximum eye height. Depending on measurement conditions, this command may not affect the measurement.
:MEASure:PAM:EYE:PPERcent	Eye Level Width	Defines the timespan (in percentage of symbol width) over which an eye's amplitude level is measured.
:MEASure:PAM:EYE:TIME:LTDefinition	Time of Level	Specifies the method used to locate the time at which to measure an eye's level.
:MEASure:PAM:AMPLitude:UNITs	Amplitude Units	Sets the amplitude units for measurement: volts, Watts, or percent.

Example Command Sequence

:SYSTem:MODE EYE
:CHAN1A:SIGNal:TYPE:AUTO OFF  //  Specify signal type, if needed.
:CHAN1A:SIGNal:TYPE PAM4
:SYSTem:AUToscale
:MEASure:EYE:PAM:LEVel:SOURce CHAN1A
:MEASure:EYE:PAM:LEVel:LEVel LEVel2  //  Select logic level to be measured.
:MEASure:EYE:PAM:LEVel  //  Run measurement.
:MEASure:EYE:PAM:LEVel?  //  Ruturn value.