21.13.1.68 signal_integrity_write

Description

This Tcl command writes parameter to a specified lane.

signal_integrity_write \
[-deviceName "device name"] \
[-lane "Lane Instance Name"] \
[-TX_EMPHASIS_AMPLITUDE "TX Transmit Emphasis and Amplitude"] \
[-TX_IMPEDANCE "TX Impedance"] \
[-TX_POLARITY "TX Impedance"] \
[-TX_TRANSMIT_COMMON_MODE_ADJUSTMENT "TX Transmit Common Mode Adjust"] \
[-RX_TERMINATION "RX Termination"] \
[-RX_LOSS_OF_SIGNAL_DETECTOR_LOW "RX Loss of Signal Detector Low "] \
[-RX_LOSS_OF_SIGNAL_DETECTOR_HIGH "RX Loss of Signal Detector High "] \
[-RX_PN_BOARD_CONNECTION "RX Board Connection "] \
[-RX_POLARITY "Polarity RX "] \
[-RX_CTLE "RX CTLE"] \
[-RX_INSERTION_LOSS "RX Insertion Loss"] \
[-RX_CDR_GAIN "RX CDR Gain"]

Arguments

ParameterTypeDescription

deviceName

string

Optional user-defined device name. The device name is not required if there is only one device in the current configuration.

lane

string

Specifies the physical location of the lane.

TX_EMPHASIS_AMPLITUDE

string

Specifies TX Emphasis Amplitude.

TX_IMPEDANCE

integer

Specifies TX Impedance(ohms) value. Possible values are: 100, 150, 85 180.

TX_TRANSMIT_COMMON_MODE_ADJUSTMENT

integer​

Specifies

TX Transmit Common Mode Adjustment (% of VDDA). Possible values are: 50, 60, 70, and 80.

RX_INSERTION_LOSS

string

Specifies RX Insertion Loss. Possible values are: 6.5dB, 17.0bdB and 25.0dB.

RX_CTLE

string

RX CTLE value.

RX_CDR_GAIN

string

Specifies CDR Gain value. It can be "Low" or "High".

RX_TERMINATION

integer​

Specifies RX Termination(ohms). Possible values are: 85, 100 and150.

RX_PN_BOARD_CONNECTION

string

Specifies RX P/N Board Connection. Possible values are "AC_COUPLED_WITH_EXT_CAP" or "DC_COUPLED".

RX_LOSS_OF_SIGNAL_DETECTOR_LOW

string/ integer

Specifies RX Loss Signal Detector value. Possible values are: Off, PCIE, SATA, BMR and 1, 2, 3, 4, 5, 6 and 7.

RX_LOSS_OF_SIGNAL_DETECTOR_HIGH

string/ integer​

Specifies RX Loss Signal Detector value. Possible values are: Off, PCIE, SATA, BMR and 1, 2, 3, 4, 5, 6 and 7.

RX_POLARITY

string​

Specifies Polarity (P/N reversal) value, it can be "Normal" or "Inverted".

Return TypeDescription
NoneNone

Error Codes

Error CodeDescription

None

Parameter 'param_name' is not defined. Valid command formatting is 'signal_integrity_write [-deviceName "device name"] [-lane "Lane Instance Name"] [-TX_EMPHASIS_AMPLITUDE "TX Transmit Emphasis and Amplitude"] [-TX_IMPEDANCE "TX Impedance"] [-TX_POLARITY "TX Impedance"] [-TX_TRANSMIT_COMMON_MODE_ADJUSTMENT "TX Transmit Common Mode Adjust"] [-RX_TERMINATION "RX Termination"] [-RX_LOSS_OF_SIGNAL_DETECTOR_LOW "RX Loss of Signal Detector Low "] [-RX_LOSS_OF_SIGNAL_DETECTOR_HIGH "RX Loss of Signal Detector High "] [-RX_PN_BOARD_CONNECTION "RX Board Connection "] [-RX_POLARITY "Polarity RX "] [-RX_CTLE "RX CTLE"] [-RX_INSERTION_LOSS "RX Insertion Loss"] [-RX_CDR_GAIN "RX CDR Gain"]'.

None

Parameter 'RX_CDR_GAIN' has illegal value.

None

Parameter 'RX_INSERTION_LOSS' has illegal value.

None

Parameter 'RX_CTLE' has illegal value.

None

Signal Integrity: RX_INSERTION value is invalid. It must be 6.5dB, 17.0dB or 25.0dB.

None

Parameter 'RX_POLARITY' has illegal value.

None

Parameter 'RX_PN_BOARD_CONNECTION' has illegal value.

None

Parameter 'RX_LOSS_OF_SIGNAL_DETECTOR_HIGH' has illegal value.

None

Parameter 'RX_LOSS_OF_SIGNAL_DETECTOR_LOW' has illegal value.

None

Parameter 'RX_TERMINATION' has illegal value.

None

Parameter 'TX_TRANSMIT_COMMON_MODE_ADJUSTMENT' has illegal value.

None

Parameter 'TX_IMPEDANCE' has illegal value.

​​​​​​None​

Parameter 'TX_EMPHASIS_AMPLITUDE' has illegal value.

None​

Signal Integrity: Must specify one of '-TX_EMPHASIS_AMPLITUDE', '-TX_IMPEDANCE','-TX_POLARITY','-TX_TRANSMIT_COMMON_MODE-ADJUSTMENT','-RX_TERMINATION','-RX_LOSS_OF_SIGNAL_DETECTOR_LOW', '-RX_LOSS_OF_SIGNAL_DETECTOR_HIGH', 'RX_PN_BOARD_CONNECTION', '-RX_POLARITY', '-RX_CTLE', '-RX_INSERTION_LOSS' or '-RX_CDR_GAIN' arguments.

None​

Parameter 'lane' has illegal value.

Supported Families

PolarFire
PolarFire SoC

Example

Write signal integrity on "Q2_LANE0" lane with the possible values of parameters:

signal_integrity_write \
-lane {Q2_LANE0} \
-TX_EMPHASIS_AMPLITUDE {400mV_with_-3.5dB} \
-TX_IMPEDANCE {100} \
-TX_TRANSMIT_COMMON_MODE_ADJUSTMENT {50} \
-RX_TERMINATION {100} \
-RX_LOSS_OF_SIGNAL_DETECTOR_LOW {1} \
-RX_LOSS_OF_SIGNAL_DETECTOR_HIGH {3} \
-RX_PN_BOARD_CONNECTION {AC_COUPLED_WITH_EXT_CAP} \
-RX_POLARITY {Normal} \
-RX_CTLE {No_Peak_+2.8dB} \
-RX_INSERTION_LOSS {6.5dB} \
-RX_CDR_GAIN {High}

See Also

  • signal_integrity_import

  • signal_integrity_export

  • load_SI_design_defaults