Keysight N1091APCA, Programmer'S Reference Manual

Page 1: ...Keysight N1091APCA BMCA BACA BJCA IEEE 802 3 Compliance and Debug Application Programmer s Reference ...

Page 2: ...ly Keysight provides the Software to U S government customers under its standard commercial license which is embodied in its End User License Agreement EULA a copy of which can be found at www keysight com find sweula The license set forth in the EULA represents the exclusive authority by which the U S government may use modify distribute or disclose the Software The EULA and the license set forth...

Page 3: ...ance application programming basics Chapter 2 Configuration Variables and Values starting on page 9 Chapter 3 Test Names and IDs starting on page 19 and Chapter 4 Instruments starting on page 41 provide information specific to programming the N1091APCA BMCA BACA BJCA IEEE 802 3 Compliance and Debug Application How to Use This Book Programmers who are new to compliance application programming shoul...

Page 4: ...4 Keysight N1091APCA BMCA BACA BJCA IEEE 802 3 Compliance and Debug Application Programmer s ...

Page 5: ...CA IEEE 802 3 Compliance and Debug Application Programmer s Reference 5 Contents In This Book 3 1 Introduction to Programming Remote Programming Toolkit 8 2 Configuration Variables and Values 3 Test Names and IDs 4 Instruments Index ...

Page 6: ...6 Keysight N1091APCA BMCA BACA BJCA IEEE 802 3 Compliance and Debug Application Programmer s ...

Page 7: ...ance test application The programming commands provide the means of remote control Basic operations that you can do remotely with a computer and a compliance test app running on an oscilloscope include Launching and closing the application Configuring the options Running tests Getting results Controlling when and were dialogs get displayed Saving and loading projects You can accomplish other tasks...

Page 8: ...t here www keysight com find rpi The N1091APCA BMCA BACA BJCA IEEE 802 3 Compliance and Debug Application uses Remote Interface Revision 6 30 The help files provided with the toolkit indicate which features are supported in this version In the toolkit various documents refer to application specific configuration variables test information and instrument information These are provided in Chapters 2...

Page 9: ...ibes which graphical user interface control is used to change the value Variable The name to use with the SetConfig method Values The values to use with the SetConfig method Description The purpose or function of the variable For example if the graphical user interface contains this control on the Set Up tab Enable Advanced Features then you would expect to see something like this in the table bel...

Page 10: ... Source CDRSource Diff CDR CDR Allows you to choose to recover a clock from Differential CDR or CDR Default is Differential Configure CDR State CDRState ON OFF Allows you to choose whether clock recovery is used for the trigger source Default is On which uses clock recovery for the trigger Configure Channels for N104x N1055A CHANPAIR DIFF1A DIFF1C DIFF2A DIFF2C When using the N104x N1055A you may ...

Page 11: ...t This setting does take longer User can set to lower probability for quick results Configure Fixed Rj for Lane0 RjLane0 Accepts user defined text 1e 12 Allows you to provide a fixed RJ value for use in Eye Mode Enter the value in seconds using the format 374E 15 or 1 13E 12 The allowable range is 0 to 10 ps Configure Fixed Rj for Lane1 RjLane1 Accepts user defined text 1e 12 Allows you to provide...

Page 12: ...ou to provide a fixed RJ value for use in Eye Mode Enter the value in seconds using the format 374E 15 or 1 13E 12 The allowable range is 0 to 10 ps Configure Fixed Rj for Lane8 RjLane8 Accepts user defined text 1e 12 Allows you to provide a fixed RJ value for use in Eye Mode Enter the value in seconds using the format 374E 15 or 1 13E 12 The allowable range is 0 to 10 ps Configure Fixed Rj for La...

Page 13: ...ent results Default is 5 patterns Value can be typed in by user Note that longer patterns may take longer time to complete Configure Number of averages for Coefficient Tests StepLoop Accepts user defined text 10 16 20 Set the number of averages used for the Coefficient tests Configure Optimize for Rj and Linearity OptLin ON OFF Controls selection of setting the precision time base to optimize for ...

Page 14: ...mulation Signals RunSim No Yes Select Yes to run simulation signals Set simulation signals to slot 5 channels 5A and 5B Configure SIRC Bandwidth SIRCBW Accepts user defined text 33e9 25e9 Select or enter the SIRC BW This will automatically be applied to any pattern lock waveform Configure SIRC Response SIRCResponse BESSel SINC FLAT Select the SIRC response This will automatically be applied to any...

Page 15: ...se for the Find optimal CTLE Eye Opening test The test will test the range of settings from this start value to the stop value set in the next config Configure Stop value for CTLE utility for Eye Opening StopCTLE 1 2 3 4 5 6 7 8 9 Select the last CTLE setting to use for the Find optimal CTLE Eye Opening test The test will test the range of settings from start value selected in the previous config ...

Page 16: ...TCH Yes No Other Only available in Debug Mode Configure Variable Equalization Level VarEQ Accepts user defined text 0 100 To open closed degraded signals The equalizer level value can be set from 0 to 100 percent Default is 0 Run Tests Event RunEvent None Fail Margin N Pass Names of events that can be used with the StoreMode Event or RunUntil RunEventAction options Run Tests RunEvent Margin N Mini...

Page 17: ...being used to measure return loss PNA ENA or N1055A Set Up Switch Option SwitchType Switch Matrix N104x 55A Single Lane This option allows user to select Switch Matrix or N104x N1055A for four lane for automated lane testing User can select Single Lane to test one lane in any measurement option Set Up User Comment txtOverallUserComment Accepts user defined text This option allows user to key in re...

Page 18: ...utton SkewChan7A7B 0 0 1 0 automate the auto skew button Set Up automate the auto skew button SkewChan7C7D 0 0 1 0 automate the auto skew button Set Up automate the done button Donebtn 1 automate the done button When task completes value automatically resets to 0 Table 2 Configuration Variables and Values continued GUI Location Label Variable Values Description ...

Page 19: ...escription The description of the test as it appears on the user interface Select Tests tab For example if the graphical user interface displays this tree in the Select Tests tab All Tests Rise Time Fall Time then you would expect to see something like this in the table below and you would run these tests remotely using ARSL syntax arsl a ipaddress c SelectedTests 100 110 arsl a ipaddress c Run C ...

Page 20: ...fficient Status dis min min 527 v1 v4 v1 measurement for Coefficient status c1 disabled c0 minimum c 1 minimum v1 v4 v1 Additional Coefficient Status dis min min 1527 v1 v4 v1 measurement for Coefficient status c1 disabled c0 minimum c 1 minimum v1 v4 v1 Additional Coefficient Status min min dis 520 v1 v4 v1 measurement for Coefficient status c1 minimum c0 minimum c 1 disabled v1 v4 v1 Additional ...

Page 21: ... v3 measurement for Coefficient status c1 minimum c0 minimum c 1 disabled v3 v6 v3 Additional Coefficient Status min min dis 1522 v3 v6 v3 measurement for Coefficient status c1 minimum c0 minimum c 1 disabled AC Common Mode Output Voltage Test 5103 Test the AC common mode voltage This test can only be tested in dual single ended connection Must be DC coupled AC Common Mode Output Voltage Test 2051...

Page 22: ... can only be tested in dual single ended connection Common Mode AC Output Voltage Test 18101 Test the AC common mode voltage This test can only be tested in dual single ended connection Common Mode AC Output Voltage Test 28101 Test the AC common mode voltage This test can only be tested in dual single ended connection Common Mode AC Output Voltage Test 9101 Test the AC common mode voltage This tes...

Page 23: ... measurement Crosstalk source Fall Time 20 80 19303 Crosstalk source Fall Time measurement at TP1a Crosstalk source Fall Time 20 80 39303 Crosstalk source Fall Time measurement at TP1a Crosstalk source Fall Time 20 80 9303 Crosstalk source Fall Time measurement at TP4 Crosstalk source Fall Time 20 80 29303 Crosstalk source Fall Time measurement at TP4 Crosstalk source Rise Time 20 80 19302 Crossta...

Page 24: ...ge of the signal during DME DME T1 Transition Position Spacing period Test 701 Test transition position spacing when in mode DME DME T1 Transition Position Spacing period Test 1701 Test transition position spacing when in mode DME DME T1 Transition Position Spacing period Test 2701 Test transition position spacing when in mode DME DME T1 Transition Position Spacing period Test 3701 Test transition...

Page 25: ...nal De emphasis 18103 Measures the Maximum and Minimum De emphasis of the signal Deterministic Jitter 202 Deterministic Jitter measurement Deterministic Jitter 1202 Deterministic Jitter measurement Deterministic Jitter 7202 Deterministic Jitter measurement Deterministic Jitter 17202 Deterministic Jitter measurement Deterministic Jitter 27202 Deterministic Jitter measurement Deterministic Jitter 82...

Page 26: ...t the maximum voltage with the TX enabled Differential Peak to Peak Output Voltage Test 205102 Test the maximum voltage with the TX enabled Differential Peak to Peak Output Voltage Test 206102 Test the maximum voltage with the TX enabled Differential Peak to Peak Output Voltage Test 6102 Test the maximum voltage with the TX enabled Differential Peak to Peak Output Voltage Test with TX disabled 100...

Page 27: ...02 Test the common mode voltage Deviation in EEE This test can only be tested in dual single ended connection EEE Differential Peak to Peak Output Voltage Test 801 Test the maximum voltage with the TX enabled in EEE EEE Differential Peak to Peak Output Voltage Test 1801 Test the maximum voltage with the TX enabled in EEE EEE Differential Peak to Peak Output Voltage Test 2801 Test the maximum volta...

Page 28: ...nPPI Host eye does not violate the defined mask Eye Mask 19205 Verifies that the nPPI Module eye does not violate the defined mask Eye Mask 39205 Verifies that the nPPI Module eye does not violate the defined mask Eye Width 206601 Measures the width of the eye at user CTLE Eye Width 306601 Measures the width of the eye at user CTLE Far end transmit output noise High insertion loss channel 3601 Tes...

Page 29: ...er 19202 J2 jitter measurement J2 Jitter 29202 J2 jitter measurement J2 Jitter 39202 J2 jitter measurement J9 Jitter 9204 J9 Jitter measurement J9 Jitter 19204 J9 Jitter measurement J9 Jitter 29204 J9 Jitter measurement J9 Jitter 39204 J9 Jitter measurement Linear Fit Pulse 2301 Linear Fit Pulse Linear Fit Pulse Peak 3301 Linear Fit Pulse Peak Linear Fit Pulse Peak 5301 Linear Fit Pulse Peak Linea...

Page 30: ...imum Output Rise Time 20 80 18300 Rise Time measurement Minimum Output Rise Time 20 80 28300 Rise Time measurement Minimum Post cursor Full scale Range 5501 Minimum Post cursor Full scale measurement for Coefficient c 1 zero c 0 minimum c 1 minimum Minimum Post cursor Full scale Ratio 2501 Minimum Post cursor Full scale measurement for Coefficient c 1 zero c 0 minimum c 1 minimum Minimum Post curs...

Page 31: ...efficient update c1 hold c0 hold c 1 dec Normalized Coefficient Step Size c 1 hold c 0 hold c 1 inc 5404 Normalized Coefficient Step Size measurement for Coefficient update c1 hold c0 hold c 1 inc Normalized Coefficient Step Size c 1 hold c 0 hold c 1 inc 205404 Normalized Coefficient Step Size measurement for Coefficient update c1 hold c0 hold c 1 inc Normalized Coefficient Step Size c 1 hold c 0...

Page 32: ...e cursor equalization for c 1 weight 1 Pre cursor equalization Local_eq_cm1 2 205502 Measures Pre cursor equalization for c 1 weight 2 Pre cursor equalization Local_eq_cm1 3 205503 Measures Pre cursor equalization for c 1 weight 3 Preset 1 Measures the preset signal for step size and full scale tests Qsq 9103 Measures the amplitude to noise ratio Qsq 29103 Measures the amplitude to noise ratio Ran...

Page 33: ...ed c0 minimum c 1 disabled Rpst Coefficient Status min min dis 516 Rpst measurement for Coefficient status c1 minimum c0 minimum c 1 disabled Rpst Coefficient Status min min dis 1516 Rpst measurement for Coefficient status c1 minimum c0 minimum c 1 disabled Rpst Result 609 Rpst measurement Rpst Result 1609 Rpst measurement Signal to noise and distortion ratio 5302 Measures the SNDR Signal to noise...

Page 34: ...s not specified for XLAUI module test Single Ended Output Voltage Test 206104 Test the minimum and maximum voltages of the single ended signals Single Ended Output Voltage Test 7100 Test the minimum and maximum voltages of the single ended signals Single Ended Output Voltage Test 8100 Test the minimum and maximum voltages of the single ended signals Single Ended Output Voltage Test 9100 Test the m...

Page 35: ...Transmitter DC Amplitude 3300 Transmitter DC Amplitude masurement Transmitter DC Amplitude 2300 Transmitter DC Amplitude measurement Vertical Eye Closure 306602 Measures the Vertical Eye Closure 20 log AV EH15 abs Coefficient Step Size c 1 dec c 0 hold c 1 hold 2401 abs Coefficient Step Size measurement for Coefficient update c1 dec c0 hold c 1 hold abs Coefficient Step Size c 1 dec c 0 hold c 1 h...

Page 36: ... Coefficient Step Size measurement for Coefficient update c1 hold c0 inc c 1 hold abs Coefficient Step Size c 1 inc c 0 hold c 1 hold 2400 abs Coefficient Step Size measurement for Coefficient update c1 inc c0 hold c 1 hold abs Coefficient Step Size c 1 inc c 0 hold c 1 hold 3400 abs Coefficient Step Size measurement for Coefficient update c1 inc c0 hold c 1 hold abs Coefficient Step Size c 1 inc ...

Page 37: ...Additional Coefficient Status min min dis 1519 delta_v5 measurement for Coefficient status c1 minimum c0 minimum c 1 disabled delta_v5 Result 607 delta_v5 measurement delta_v5 Result 1607 delta_v5 measurement v1 Coefficient Update dec hold hold 403 v1 measurement for Coefficient update c1 dec c0 hold c 1 hold v1 Coefficient Update dec hold hold 1403 v1 measurement for Coefficient update c1 dec c0 ...

Page 38: ...ld c 1 hold v2 Coefficient Update dec hold hold 1404 v2 measurement for Coefficient update c1 dec c0 hold c 1 hold v2 Coefficient Update hold dec hold 410 v2 measurement for Coefficient update c1 hold c0 dec c 1 hold v2 Coefficient Update hold dec hold 1410 v2 measurement for Coefficient update c1 hold c0 dec c 1 hold v2 Coefficient Update hold hold dec 416 v2 measurement for Coefficient update c1...

Page 39: ...414 v3 measurement for Coefficient update c1 hold c0 hold c 1 inc v3 Coefficient Update hold hold inc 1414 v3 measurement for Coefficient update c1 hold c0 hold c 1 inc v3 Coefficient Update hold inc hold 408 v3 measurement for Coefficient update c1 hold c0 inc c 1 hold v3 Coefficient Update hold inc hold 1408 v3 measurement for Coefficient update c1 hold c0 inc c 1 hold v3 Coefficient Update inc ...

Page 40: ...40 Keysight N1091APCA BMCA BACA BJCA IEEE 802 3 Compliance and Debug Application Programmer s 3 Test Names and IDs ...

Page 41: ... ARSL syntax replace description with actual parameter arsl a ipaddress c SendScpiCommandCustom Command scpi command Timeout 100 Instrument pulsegen arsl a ipaddress c SendScpiQueryCustom Command scpi query Timeout 100 Instrument pulsegen C syntax replace description with actual parameter SendScpiCommandOptions commandOptions new SendScpiCommandOptions commandOptions Command scpi command commandOp...

Page 42: ...ication NOTE The file InstrumentInfo txt which may be found in the same directory as this help file contains all of the information found in the table below in a format suitable for parsing Table 6 Instrument Names Instrument Name Description FlexDca Primary oscilloscope N4877A Clock Data recovery and Demultiplexer Keysight PNA Performance Network Analyzer Keysight ENA Economy Network Analyzer Inf...

Page 43: ...Index C configuration variables and values 9 copyright 2 I IDs and names of tests 19 instrument names 41 N names and IDs of tests 19 names of instruments 41 notices 2 P programming introduction to 7 R Remote Programming Toolkit 8 T test names and IDs 19 V variables and values configuration 9 W warranty 2 ...

Page 44: ...44 Keysight N1091APCA BMCA BACA BJCA IEEE 802 3 Compliance and Debug Application Programmer s Index ...