:MEASure:EYE:PAM:EHEight

Meas. mode:
Eye
Package License:
L-RND
L-MFG
Waveform type:
NRZ
PAM4
Flex Apps:
FlexDCA
FlexRT
Eye Height Commands

Command Syntax

:MEASure:EYE:PAM:EHEight

Query Syntax

:MEASure:EYE:PAM:EHEight?

Description

Returns Eye/Mask mode's PAM4 Eye Height measurement for the selected eye. Eye Height measures the vertical opening for the selected eye of a PAM4 signal. Select the eye measurement to be returned using the :EYE child command. To measure the eye height for all of the eyes on a PAM4 signal, you must send this command once for each eye as there is no command for simultaneously measuring all eyes.

For each eye, the eye height is derived from eye boundaries that are located based on zero data "hits" or at an eye opening probability (:DEFine:EOPening child command). The probability defines the ratio of total hits in a waveform database column that can occur in the eye's opening. The probablility can be set from 1 x 10–1 to 1 x 10–9 using the :DEFine:EOPening:PROBability child command. The default probability is 1 x 10–2. No extrapolation is used to determine Eye Widths at a specified probability. Specify the measurement units with the :MEASure:EYE:PAM:AMPLitude:UNITs command.

NRZ Waveform?

Use this command instead:

The fastest and recommended method of performing an Eye Height measurement on PAM4 waveforms is to use Jitter Mode's :MEASure:PEYE:EHEight command. Eye mode's :MEASure:EYE:PAM:EHEight command can be used as a quick comparative check between signals. For example, when tuning pre-emphasis on a transmitter. In the following situations, you may want to use Eye Mode's measurement:

  • For longer patterns, such as PRBS31Q, as Eye mode does not require pattern lock.
  • When data is random or when measuring multiple waveforms at the same time.

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.
: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.
: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:AMPLitude:UNITs Amplitude Units Sets the amplitude units for measurement: volts, Watts, or percent.

Requires FlexDCA revision A.04.50 and above.

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:EHEight:

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

Child commands for measurement identification:

  • :MEASure:EYE:PAM:EHEight:SOURce
  • :MEASure:EYE:PAM:EHEight:DEFine:EOPening
  • :MEASure:EYE:PAM:EHEight:DEFine:EOPening:PROBability
  • :MEASure:EYE:PAM:EHEight:DEFine:EOPening:RJSTabilize
  • :MEASure:EYE:PAM:EHEight:DEFine:EOPening:RJSValue
  • :MEASure:EYE:PAM:EHEight:DEFine:EOPening:RNSTabilize
  • :MEASure:EYE:PAM:EHEight:DEFine:EOPening:RNSValue:LEVel1
  • :MEASure:EYE:PAM:EHEight:DEFine:EOPening:RNSValue:LEVel0

Example Command Sequence

:MEASure:EYE:PAM:EHEight:SOURce CHAN1A
:MEASure:PAM:AMPLitude:UNITs PERCent
:MEASure:EYE:PAM:EHEight:DEFine:EOPening ZHITs 
:MEASure:EYE:PAM:EHEight:EYE EYE2
:MEASure:EYE:PAM:EHEight
:MEASure:EYE:PAM:EHEight?

Common Measurement Queries