nrz-m4 application printable application help · the nrz-m4 application is designed to run on a pc...

NRZ-M4 ApplicationPrintable Application Help

*P077154500*077-1545-00

NRZ-M4 ApplicationPrintable Application Help

www.tek.com077-1545-00

Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiariesor suppliers, and are protected by national copyright laws and international treaty provisions. Tektronix productsare covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in allpreviously published material. Specifications and price change privileges reserved.

TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.Contacting TektronixTektronix, Inc.14150 SW Karl Braun DriveP.O. Box 500Beaverton, OR 97077USA

For product information, sales, service, and technical support:

■ In North America, call 1-800-833-9200.

■ Worldwide, visit www.tek.com to find contacts in your area.

http://www.tek.com

Table of ContentsWelcome ............................................................................................................................................. iii

Getting help and supportConventions .................................................................................................................................... 1Related documentation ................................................................................................................... 2Technical support ........................................................................................................................... 2

Getting startedComputer requirements .................................................................................................................. 3Instruments and accessories required ............................................................................................. 4TekVISA software .......................................................................................................................... 4Installing the software .................................................................................................................... 5File name extensions ...................................................................................................................... 5View software version .................................................................................................................... 6Application directories ................................................................................................................... 6

Operating basicsLaunch the application .................................................................................................................... 7Application panels overview .......................................................................................................... 8File menu ...................................................................................................................................... 13Scope menu ................................................................................................................................... 13Results elements ........................................................................................................................... 14

Programmatic interfaceRemote control introduction ......................................................................................................... 17Handshaking protocol ................................................................................................................... 17Setting up the PI environment ...................................................................................................... 18Syntax ........................................................................................................................................... 19Variable name arguments and queries .......................................................................................... 20Programming examples ................................................................................................................ 26

Perl program example: configure and operate NRZ-M4 ......................................................... 26Python example ....................................................................................................................... 28

NRZ-M4 Application Help i

Guide to connect the oscilloscopeCheck network access ................................................................................................................... 29TekVISA setup and troubleshooting ............................................................................................ 29Firewall exceptions ....................................................................................................................... 32

Table of Contents

ii NRZ-M4 Application Help

WelcomeThe Tektronix NRZ-M4 application provides NRZ signaling analysis, includingTDEC (Transmitter and Dispersion Eye Closure) measurement. The applicationbrings together NRZ optical measurements in a simple and easy to useapplication. This application is designed to minimize the computation time ofwaveform analysis which suits the manufacturing environment.

This application is intended to be installed on a PC and works by connecting tothe sampling scope. Application allows you to acquire signal directly from theconnected DSA8300 sampling oscilloscope and analyze the acquired waveformdata.

NOTE. NRZ-M4 application requires the installation of an option key on thetarget DSA8300 oscilloscope to enable establishing a connection from the NRZ-M4 application to the DSA8300. Refer to the documentation provided with theDSA8300 for instructions of adding a new option key.

NRZ-M4 Application Help iii

Key featuresThe NRZ-M4 application performs comprehensive analysis of optical NRZsignals, including TDEC, Mask margin and other optical measurements.

NRZ-M4 application provides the following features:

■ Simultaneously analyze up to 4 optical channels■ Characterization of 100Gbps Optical transceivers (SR4, LR4) devices with

Mask margin measurements. Perform optimal mask fitting for better margin.■ Supports TDEC (Transmitter and Dispersion Eye Closure)■ Signal characterization measurements such as Amplitude and Timing

measurements■ Support for Phase reference characterization clock for more accurate results.■ Support for measurements at various population limits.■ Show results as numeric and graphical display.■ Display 2D eye diagrams with embedded mask■ Save the analysis results to a file.■ Run multiple instances of the application and connect each of them to

different DSA8300s' and perform parallel analysis of multiple channels.

Welcome

iv NRZ-M4 Application Help

Getting help and support

ConventionsHelp uses the following conventions:

■ The term "Application" and "Software" refers to the Tektronix NRZ-M4application.

■ The term “select” is a generic term that applies to the different methods ofchoosing a screen item (button, control, list item): using a mouse or using thetouch screen.

Table 1: Icon descriptions

Icon MeaningThis icon identifies important information.

This icon identifies conditions or practices that could result in lossof data.

This icon identifies additional information that will help you usethe application more efficiently.

NRZ-M4 Application Help 1

Related documentationThe following documentation is available as part of the NRZ-M4 application.

Table 2: Product documentation

Item Purpose LocationHelp Application operation

and User Interface help

PDF of the help Printable version of thecompiled help

PDF file that ships with the NRZ-M4 application.You can download the PDF version of themanual from the Tektronix website.www.tek.com

See also: Technical support

Technical supportTektronix values your feedback on our products. To help us serve you better,please send us your suggestions, ideas, or comments on your application oroscilloscope. Contact Tektronix through mail, telephone, or the Web site. See Contacting Tektronix at the front of this document for contact information.

When you contact Tektronix Technical Support, please include the followinginformation (be as specific as possible):

General information ■ All instrument model numbers■ Hardware options, if any■ Modules used■ Your name, company, mailing address, phone number, FAX number■ Please indicate if you would like to be contacted by Tektronix about your

suggestion or comments.

Application specificinformation

■ Software version number■ Description of the problem such that technical support can duplicate the

problem■ If possible, save the setup files for all the instruments used and the

application

Getting help and support

2 NRZ-M4 Application Help

Getting started

Computer requirementsThe NRZ-M4 application is designed to run on a PC running Windows operatingsystem. A high performance PC is recommended to minimize the computationtime of waveform analysis.

These are the minimum requirements to successfully run the NRZ-M4application. A PC with higher performance results in faster measurements.

■ Operating system: Microsoft Windows 10 (64 bit) operating system.

■ Screen resolution: 1920 x 1080.

NOTE. Installing the NRZ-M4 application directly on a DSA8300 samplingoscilloscope is not permitted.

Software requirements The NRZ-M4 application requires the following software to be installed on thePC.

■ TekVISA: TekVISA version 4.2.0.10 is recommended. Installation isavailable during NRZ-M4 installation.

■ Matlab runtime: Matlab 2017b version 9.3 is required. The Matlab runtime isavailable from MathWorks® (www.mathworks.com).


Instruments and accessories requiredThe following are the instruments and accessories required.

Table 3: Instruments and accessories required

Instrument/Accessory Model number QuantityMainframe DSA8300 1 Optical modules 80C17, 80C18, 80C20, 80C21,

80C10C2 (Min 1 Qty)

Phase reference module 82A04B 1 (Optional)

NOTE. Optical module 80C10C has performance limitation. The overallexecution time of the measurement with this module is greater than the othermodules.

TekVISA softwareTekVISA is preinstalled on the DSA8300 sampling oscilloscopes, but to use thisprotocol to connect and communicate with a DSA8300 sampling oscilloscope,TekVISA must also be installed on the PC (where the NRZ-M4 applicationresides).

TekVISA is available with the NRZ-M4 application installation file or can bedownloaded for free from the Tektronix website (www.tek.com). Search forTekVISA Connectivity software.

Getting started


Installing the softwareComplete the following steps to download and install the latest NRZ-M4application. See Computer requirements for compatibility.

1. Go to www.tek.com.

2. Click Downloads. In the Downloads menu, select DOWNLOAD TYPE asSoftware and enter NRZ-M4 in the MODEL OR KEYWORD field and clickSEARCH.

3. Select the latest version of software and follow the instructions to download.

4. Double-click the executable and follow the on-screen instructions. Thesoftware is installed at C:\Program Files\TekApplications\NRZ-M4\.

5. Double-click NRZ-M4 icon in the desktop to Launch the application.

File name extensionsThe TekExpress NRZ-M4 application uses the following file name extensions:

File name extension Description.gm4 Setup file format.pl Perl example for PI commands.py Python example file for PI commands.csv Results saving file format.jpg Plots image file format.pdf Test result reports

Application help document.chm Application help file

Getting started


See also Application directories

View software versionUse the following instructions to view the version information for the application.

To view version information for NRZ-M4, click Help > About.

NOTE. This example shows a typical Version Details dialog box, and may notreflect the actual values as shown when you open this item in the application.

Application directories

TekExpress NRZ-M4application

The TekExpress NRZ-M4 application files are installed at the following location:

C:\Program Files\TekApplication\NRZ-M4

Getting started


Operating basics

Launch the applicationDouble-click the NRZ-M4 icon in the desktop to launch the application.


See also Application panel overview

Application panels overview

Operating basics


Measurement selections The measurement selection includes all the available optical measurements.

Table 4: Measurement selections

Measurements DescriptionAmplitude Includes the following amplitude measurements to the results section.

■ AOP: The average optical power of a NRZ optical signal.

■ ER: The extinction ratio of the highest and lowest optical power levels of a NRZ opticalsignal.

■ Cross%: The height of eye crossing as a percentage of eye height measured in theEye Aperture.

■ +Overshoot: The ratio of the maximum value of the measured signal to its amplitude,expressed as a percentage. The waveform is scanned for the maximum value withinthe measurement region, while the amplitude is measured in the Eye Aperture.

■ -Overshoot: The ratio of the minimum value of the measured signal to its amplitude,expressed as a percentage. The waveform is scanned for the minimum value withinthe measurement region, while the amplitude is measured in the Eye Aperture.

■ NRZHigh: The logical 1 of the NRZ signal.

■ NRZLow: The logical 0 of the NRZ signal.

■ NRZAmplitude: The difference between the logical 1 level (High) and the logical 0 level(Low) of the NRZ signal. Both High and Low levels are measured within the EyeAperture.

■ OMA: An approximation defined as the difference of the logical power 1 and0 determined a vertical slice through the eye crossing. The levels are determined asthe means of the histograms of the vertical data slice through the High (logical 1) andLow (logical 0) levels

■ NRZHigh_Histogram: Mean of the vertical histogram above the threshold, around thecenter 20% of the eye(40% to 60% of the eye opening).

■ NRZLow_Histogram: Mean of the vertical histogram below the threshold, around thecenter 20% of the eye(40% to 60% of the eye opening).

NOTE. NRZHigh_Histogram and NRZLow_Histogram are performed using the exportedwaveform database file from sampling oscilloscope.

Timing Includes the following timing measurements to the results section.

■ Jitter RMS: Jitter is the measure of time variance on the rising and falling edges at theNRZ eye crossing or at the mid-reference level.

■ Jitter Pk2Pk: The delta between the minimum and maximum of time crossings, withthe mean of the histogram being Tcross.

■ RiseTime: Computes the time interval between the mean crossings of the lowreference level and the high reference level to characterize the positive slope of theeye.

■ FallTime: NRZ Fall Time characterizes the negative slope of the NRZ eye bycomputing the time interval between the mean crossings of the high reference leveland the low reference level.

Operating basics


Measurements DescriptionTDEC, VECP Includes the following measurements to the results section.

■ TDEC: Transmitter and Dispersion Eye Closure (TDEC) of a NRZ signal.

■ VECP: Vertical Eye Closure Penalty (VECP), a measure of the closure.

Where,

An - Normalized amplitude without ISI

Ao - Vertical eye opening with ISI

Mask Includes the following measurements to the results section.Mask margin explores the design margins of the signal. It measures the margin inpercentage by expanding the mask on the NRZ eye until the mask hit ratio crosses thetarget hit ratio. User has to input the target hit ratio and mask to be used for themeasurement.Following are the steps to calculate the Mask Margin:

1. Find the eye center. Place the mask and measure the mask margin.

■ If the Margin is positive, the mask is well inside the open eye and mask has to beblown out to measure the positive mask margin.

Operating basics


Measurements Description

■ If the Margin is negative, the eye is already stressful and mask has to be blown-into measure the negative mask margin.

2. Binary search method is followed to come across results faster.

3. Mask will be expanded/shrunk until the actual hit ratio exceeds the target hit ratio.Mask margin will be measured at the point where the actual hit ratio is just below thetarget hit ratio. Both Mask margin and actual hit ratio are given in results.

Measurementconfiguration

The measurement configuration applies to the NRZ measurement selection tofurther define the measurement parameters.

Operating basics


Measurements DescriptionMask ConfigurationsSelect Mask File ■ 100GBaseSR4

■ 100GBaseLR4

■ 10GBaseR

Target Hit Ratio Enter the target hit ratio.Optimize Mask Filtting (takesmore time)

This is disabled by default.When enabled, the mask will be shifted in all directions (up,down, right and left) and best mask fitting is done to get thebetter margin.

Enable Plots This is enabled by default.When enabled, displays the 2D Eye diagram plot with theembedded mask in it.

Eye ConfigurationsTDEC BER Enter the TDEC BER value.General ConfigurationsPopulation Specify the acquisition population. Specify number of samples

per each acquisition and number of acquisitions. Total populationwill be product of these two values.

Save Results to File This is disabled by default.When enabled, this option saves the results to a .csv file at C:\Users\<username> \AppData\Local\Temp. File name format is"<AppInstance>_<ChannelName>_Results.csv".

Use Phase Reference module. This is disabled by default.Select to enable the phase reference clock connected tochannels. Also, select the clock ratio given to the phasereference module.

Mode selection Measurements DescriptionEnable This is disabled by default.

Enable the channel to analyze the signal. Channel can beenabled only if the supported module (CH1 to CH4) is installedand the option key is installed in the oscilloscope.

Scope Noise Enter the scope noise value for the corresponding channel.Oscilloscope noise values are automatically read whileconnecting to the oscilloscope or while doing Autosync.Oscilloscope noise characterization tool has to be run on theoscilloscope to measure the oscilloscope noise for each channelbefore running the NRZ-M4 application.

Operating basics


Clear button The Clear button removes all measurement results, including the plot display.

Run button Press the Run button to start the analysis cycle. At least one measurement mustbe selected.

File menuThe file menu provides the following operations:

Setting DescriptionSave Setup Use the dialog screen to navigate to a location to save the setup

file to recall at a later time. Setup files use .gm4 file extension.Recall Setup Use the dialog screen to navigate to a saved setup file to restore

the application to a known setup.Default Use to configure the default settings in the application.Exit Exits the application.

The File menu operations are unavailable if an analysis is currently running.

Scope menuSelecting Scope opens the Connect To Scope dialog screen.

Operating basics


Item DescriptionEnter Instrument IP address Enter the IP address of the oscilloscope you want to connect.Connect Select the Connect button to make the connection. The Connect

button changes to Disconnect if a connection is established.During the connection process, the NRZ-M4 application detectsthe modules installed in the oscilloscope along with theircharacteristics (such as the module type, serial number, filters orbandwidth).

AutoSync to Selected Sources Click to update the NRZ-M4 application, when you change anymodule or the characteristics. The NRZ-M4 application detectsthe modules installed in the oscilloscope along with theircharacteristics (such as the module type, serial number, filters orbandwidth).

Results elementsThe results area is populated with the latest measurements from the latestanalysis. The areas populated with results depend on the selected measurementsto make during analysis.

Operating basics


Operating basics


Programmatic interface

Remote control introductionThe NRZ-M4 software application can be controlled programmatically throughthe programmatic interface. Communication with the application is accomplishedusing VARIABLE:VALUE remote GPIB commands.

For information on how to operate the sampling oscilloscope and use itsapplication-specific GPIB commands, refer to the programmers guide for yoursampling oscilloscope.

Your program should comply with the following guidelines:

1. The application startup must complete before sending additional GPIBcommands to the application.

2. The measurements cycle must complete before you query data.

Handshaking protocolThe application handles GPIB communications through its own protocolhandshaking.

The requirements for GPIB communications with a controller are as follows:

1. Once the application has started, it writes an "OK" status to the applicationhandshake variable. This tells the controller that it may now write a validcommands into the "NRZ" variable.

2. The GPIB controller polls the handshake variable (VARIABLE:VALUE?"NRZ") until it detects the OK status.

3. The GPIB controller writes a command string into the application handshakevariable. For example, sending the command VARIABLE:VALUE "NRZ","single" writes the string "single" into the variable "NRZ".

4. The application GPIB function polls the handshake variable, reads thecommand string and interprets it as a command. If the command is notunderstood, it writes an ERROR handshake value to the variable.

5. A good command is parsed and executed. On successful execution, theapplication writes an OK to the handshake variable. When the GPIBcontroller reads the OK status, it may send a new command string.


Setting up the PI environmentTo help users get started with using GPIB commands to operate the NRZ-M4Analysis application, examples of automatic testing script written in Perl andPython 3.7 is included. These are examples only. Users are free to use anyprogramming language of their choice as long as the handshaking protocol isfollowed.

Start Client with Perl

The prerequisites are:

■ Matlab runtime needs to be installed and in the user’s path

■ Perl v5.24.3 or later needs to be installed and in the user’s path

When the NRZ-M4 is running, you can start the client with the following Perlscript.

perl NRZ-M4_PI_Client.pl

When the NRZ-M4 is not running, the script needs to start the NRZ-M4 as wellas set up the environment by using:

perl NRZ-M4_PI_Client.pl –startApp

NOTE. You may need to use the –filePath “<NRZ-M4>” to tell the client whereto connect to the currently running Applications’ process.

Start Client with Python

The prerequisites are:


■ Python 3.7 or above needs to be installed and in the user’s path

When the NRZ-M4 is running, you can start the client with the following Pythonscript.

python NRZ-M4_PI_Client.py

When the NRZ-M4 is not running, the script needs to start the NRZ-M4, as wellas set up the environment by using:

NOTE. You may need to use the -filePath “<NRZ-M4.exe>” to tell the clientwhere to connect to the currently running Applications’ process.

Running Multiple Instances

Use the following to start the main UI program with assigned instance id of<instanceId>. The default <instanceId> is 1. See the Example Main ProgramExecution for more details and examples.

NRZ-M4.exe <instanceId>

Running Using TCP/IP Address



For an IP connect, use the following command

perl NRZ-M4_PI_Client.pl -cmdfilepath=\\ip address\c$\Program Files\TekApplications\NRZ-M4

This starts NRZ-M4.exe at C:\Program Files\TekApplications\NRZ-M4\NRZ-M4.exe. The TCPIP

requires that the C: drive on the target running the NRZ-M4 application ispublicly accessible. In the example, it shares as "c$".

SyntaxThe VARIABLE:VALUE command accepts string arguments for a control ordata variable and a value to which to set the argument.

To set a variable to a value, use the syntax:

VARIABLE:VALUE "NRZ”,"<variableName>:<variableValue>"

To query the value in a variable:

VARIABLE:VALUE? "NRZ","<variableName>"

NOTE.■ The arguments <variableName> and <variableValue> are required in the

order indicated, no spaces, and use of proper capitalization.■ Your program will not operate correctly if you do not follow these

requirements.



Variable name arguments and queries

Table 5: Control commands and queries

Commands Description:VARIABLE:VALUE:"NRZ","CONNECT:<ip_address>"

The set form provides the IP address or the computer name of the oscilloscope to connectto the application.The query form returns the IP address of the connected oscilloscope if it exists.Make sure TekVISA is turned on and the instrument can be found via the TekVisa beforesetting the IP address.For help with connection issues, refer to Oscilloscope connection tips.

Syntax :VARIABLE:VALUE: "NRZ","CONNECT:<ip_address>"Example :VARIABLE:VALUE: "NRZ","CONNECT:134.62.9.4" connects to the instrument with the

given IP address.:VARIABLE:VALUE:? "NRZ","CONNECT" returns the IP address of a connectedinstrument.

Return Example Returns: $response = ’134.62.9.4'

:VARIABLE:VALUE: "NRZ","DISCONNECT" Disconnects the application from the oscilloscope.Syntax :VARIABLE:VALUE: "NRZ","DISCONNECT"

:VARIABLE:VALUE: "NRZ","CLEAR" Command only.Clears all measurement results.

Syntax :VARIABLE:VALUE: "NRZ","CLEAR"

:VARIABLE:VALUE "NRZ","EXIT" Command only.Exits the application.

Syntax :VARIABLE:VALUE "NRZ","EXIT"

:VARIABLE:VALUE "NRZ", "ANALYZE" Command only.Starts the measurement execution.

Syntax :VARIABLE:VALUE "NRZ", "ANALYZE"

:VARIABLE:VALUE? "NRZ", "STATUS" Query only.Returns the status of measurement execution.

Syntax :VARIABLE:VALUE? "NRZ", "STATUS"

:VARIABLE:VALUE "NRZ","AUTOSYNC" Command only.Synchronizes the noise value and module detail with the connected oscilloscope.

Syntax :VARIABLE:VALUE "NRZ","AUTOSYNC"

:VARIABLE:VALUE? "NRZ","INSTANCEID" Query only.Returns the instance id of the application.

Syntax :VARIABLE:VALUE? "NRZ","INSTANCEID"

:VARIABLE:VALUE "NRZ", "ACTIVATE:5" Command only.Sets the instance id for the application window.

Syntax :VARIABLE:VALUE "NRZ", "ACTIVATE:5"



Commands Description:VARIABLE:VALUE "NRZ","DEFAULTSETUP"

Command only.Sets the oscilloscope to default configuration.

Syntax :VARIABLE:VALUE "NRZ", "DEFAULTSETUP"

:VARIABLE:VALUE "NRZ","SAVESETUP:<FILEPATH>"

Command only.Saves the setup in the path.

Syntax :VARIABLE:VALUE "NRZ", "SAVESETUP:<FILEPATH>"<FILEPATH> = File name with the path.

Example :VARIABLE:VALUE "NRZ", "SAVESETUP:D:\test1.gm4" saves the setup file.

:VARIABLE:VALUE "NRZ","RECALLSETUP:<FILEPATH>"

Command only.Recalls the setup in the path.

Syntax :VARIABLE:VALUE "NRZ", "RECALLSETUP:<FILEPATH>"<FILEPATH> = File name with the path.

Example :VARIABLE:VALUE "NRZ", "RECALLSETUP:D:\test1.gm4" recalls the setup file.

:VARIABLE:VALUE? "NRZ", "ONLINE" Query only.Returns the status of the application license.

Syntax :VARIABLE:VALUE? "NRZ", "ONLINE"Returns 0 if the application license is disabledReturns 1 if the application license is enabled

Table 6: Horizontal settings commands and queries

Commands Description:VARIABLE:VALUE:"NRZ","DATARATE:<INTEGER>"

Sets or returns the data rate value.

Syntax :VARIABLE:VALUE: "NRZ","DATARATE:<INTEGER>"<INTEGER> = 10 to 55

Example :VARIABLE:VALUE: "NRZ","DATARATE:10e9" sets the datarate as 10e9.:VARIABLE:VALUE:? "NRZ","DATARATE" returns the IP address of a connectedinstrument.

Return Example Returns: $response = ’10e9'

Table 7: Measurement select commands and queries

Commands Description:VARIABLE:VALUE: "NRZ","eyemeasurements:1|0"

Sets or returns the Enabled stated (enables or disabled) for eye measurement.

Syntax :VARIABLE:VALUE: "NRZ", "eyemeasurements:1|0"1 enables the TDEC measurement.0 disables the TDEC measurement.

Example :VARIABLE:VALUE: "NRZ", "eyemeasurements:1" enables the TDEC measurement.:VARIABLE:VALUE:? "NRZ", "eyemeasurements" returns 1 if TDEC measurement isselected.

Return Example Returns: $response = ’1'



Commands Description:VARIABLE:VALUE: "NRZ","amplitudemeasurements:1|0"

Sets or returns the Enabled stated (enables or disabled) for amplitude measurement.

Syntax :VARIABLE:VALUE: "NRZ", "amplitudemeasurements:1|0"1 enables the amplitude measurement.0 disables the amplitude measurement.

Example :VARIABLE:VALUE: "NRZ", "amplitudemeasurements:1" enables the amplitudemeasurement.:VARIABLE:VALUE:? "NRZ", "amplitudemeasurements" returns 1 if amplitudemeasurement is selected.


:VARIABLE:VALUE: "NRZ","timingmeasurements:1|0"

Sets or returns the Enabled stated (enables or disabled) for timing measurement.

Syntax :VARIABLE:VALUE: "NRZ", "timingmeasurements:1|0"1 enables the timing measurement.0 disables the timing measurement.

Example :VARIABLE:VALUE: "NRZ", "timingmeasurements:1" enables the timing measurement.:VARIABLE:VALUE:? "NRZ", "timingmeasurements" returns 1 if timing measurement isselected.


:VARIABLE:VALUE: "NRZ","maskmeasurements:1|0"

Sets or returns the Enabled stated (enables or disabled) for mask measurement.

Syntax :VARIABLE:VALUE: "NRZ", "maskmeasurements:1|0"1 enables the mask measurement.0 disables the mask measurement.

Example :VARIABLE:VALUE: "NRZ", "maskmeasurements:1" enables the mask measurement.:VARIABLE:VALUE:? "NRZ", "maskmeasurements" returns 1 if mask measurement isselected.


:VARIABLE:VALUE: "NRZ","SELECT:CH<X>:1|0"

Sets or enables the selected channel.

Syntax :VARIABLE:VALUE: "NRZ", "SELECT:CH<X>:1|0"<X> = 1 to 4

Example :VARIABLE:VALUE: "NRZ", "SELECT:CH1:1" selects the channel CH1.:VARIABLE:VALUE:? "NRZ", "SELECT:CH1" returns 1 if CH1 is selected.


:VARIABLE:VALUE: "NRZ","CHANNEL:CH<X>"Syntax :VARIABLE:VALUE: "NRZ", "CHANNEL:CH<X>"

<X> = 1 to 4 Example :VARIABLE:VALUE: "NRZ", "CHANNEL:CH1" enables the mask measurement.

:VARIABLE:VALUE:? "NRZ", "CHANNEL" returns 1 if mask measurement is selected.Return Example Returns: $response = ’1'



Commands Description:VARIABLE:VALUE: "NRZ","NOISE:CH<X>:<INTEGER>"

Sets or returns the scope noise value.

Syntax :VARIABLE:VALUE: "NRZ", "NOISE:CH<X>:<INTEGER>"<X> = 1 to 4 <INTEGER> = 0 to 100

Example :VARIABLE:VALUE: "NRZ", "NOISE:CH1:0.00002" sets the scope noise value as 0.00002.:VARIABLE:VALUE:? "NRZ", "NOISE:CH1" returns returns the scope noise value.

Return Example Returns: $response = ’0.00002'

:VARIABLE:VALUE:? "NRZ","MODULE:CH<X>"

Returns the module number for configured optical module for the specified channel.

Syntax :VARIABLE:VALUE:? "NRZ", "MODULE:CH<X>"<X> = 1 to 4

Example :VARIABLE:VALUE:? "NRZ", "MODULE:CH1" returns the module number for configuredoptical module of the specified channel.

:VARIABLE:VALUE:? "NRZ","SERIALNUM:CH<X>"

Returns the serial number for configured optical module for the specified channel.

Syntax :VARIABLE:VALUE:? "NRZ", "SERIALNUM:CH<X>"<X> = 1 to 4

Example :VARIABLE:VALUE:? "NRZ", "SERIALNUM:CH1" returns the serial number for configuredoptical module of the specified channel.

:VARIABLE:VALUE:? "NRZ","MODFILTER:CH<X>"

Returns the module filter for configured optical module for the specified channel.

Syntax :VARIABLE:VALUE:? "NRZ", "MODFILTER:CH<X>"<X> = 1 to 4

Example :VARIABLE:VALUE:? "NRZ", "MODFILTER:CH1" returns the module filter for configuredoptical module of the specified channel.

:VARIABLE:VALUE:? "NRZ","MODBW:CH<X>"

Returns the module bandwidth for configured optical module for the specified channel.

Syntax :VARIABLE:VALUE:? "NRZ", "MODBW:CH<X>"<X> = 1 to 4

Example :VARIABLE:VALUE:? "NRZ", "MODBW:CH1" returns the module bandwidth for configuredoptical module of the specified channel.

Table 8: Configuration commands and queries

Commands Description:VARIABLE:VALUE: "NRZ","CONFIG:TDECBER:<NR3>"

Sets or returns the TDEC BER value.

Syntax :VARIABLE:VALUE: "NRZ", "CONFIG:TDECBER:<NR3>"<NR3> (Floating point value with an exponent) = 0.000000001 to 1

Example :VARIABLE:VALUE: "NRZ", "CONFIG:TDECBER:6e-7" sets the TDEC BER value as 6e-7 :VARIABLE:VALUE:? "NRZ", "CONFIG:TDECBER" returns the TDEC BER value.

Return Example Returns: $response = ’6e-7'



Commands Description:VARIABLE:VALUE: "NRZ","CONFIG:HITRATIO:<NR3>"

Sets or returns the hit ratio value.

Syntax :VARIABLE:VALUE: "NRZ", "CONFIG:HITRATIO:<NR3>"<NR3> (Floating point value with an exponent) = 0.000000001 to 1

Example :VARIABLE:VALUE: "NRZ", "CONFIG:HITRATIO:4e-7" sets the TDEC BER value as 4e-7 :VARIABLE:VALUE:? "NRZ", "CONFIG:HITRATIO" returns the TDEC BER value.

Return Example Returns: $response = ’4e-7'

:VARIABLE:VALUE: "NRZ","CONFIG:SELECTMASK:<FILENAME>"

Sets or returns the mask file name.

Syntax :VARIABLE:VALUE: "NRZ", "CONFIG:SELECTMASK:<FILENAME>"Example :VARIABLE:VALUE: "NRZ", "CONFIG:SELECTMASK:100GBaseSR4" selects the mask file

as 100GBaseSR4.:VARIABLE:VALUE: "NRZ", "CONFIG:SELECTMASK:100GBaseSR4" returns the selectedmask file name.

Return Example Returns: $response = ’100GBaseSR4'

:VARIABLE:VALUE: "NRZ","CONFIG:ENABLEPLOT:ON|OFF"

Sets or returns the enable plot (enabled or disabled) in configuration settings.

Syntax :VARIABLE:VALUE: "NRZ", "CONFIG:ENABLEPLOT:ON|OFF"ON enables the enable plot in configuration settings.OFF disables the enable plot in configuration settings

Example :VARIABLE:VALUE: "NRZ", "CONFIG:ENABLEPLOT:ON" enables the enable plots inconfiguration settings.:VARIABLE:VALUE:? "NRZ", "CONFIG:ENABLEPLOT" returns 1 if enable plots is enabled.


:VARIABLE:VALUE: "NRZ","CONFIG:OPTIMIZEMASKFITTING:ON|OFF"

Sets or returns the optimize mask fitting (enabled or disabled) in configuration settings.

Syntax :VARIABLE:VALUE: "NRZ", "CONFIG:OPTIMIZEMASKFITTING:ON|OFF"ON enables the optimize mask fitting in configuration settings.OFF disables the optimize mask fitting in configuration settings

Example :VARIABLE:VALUE: "NRZ", "CONFIG:OPTIMIZEMASKFITTING:ON" enables the OptimizeMask Fitting in configuration settings.:VARIABLE:VALUE: "NRZ", "CONFIG:OPTIMIZEMASKFITTING" returns 1 if OptimizeMask Fitting is enabled.


:VARIABLE:VALUE: "NRZ","CONFIG:USEPHASEREF:ON|OFF"

Sets or returns the use phase reference (enabled or disabled) in configuration settings.

Syntax :VARIABLE:VALUE: "NRZ", "CONFIG:USEPHASEREF:ON|OFF"1 enables the use phase reference in configuration settings.0 disables the use phase reference in configuration settings.

Example :VARIABLE:VALUE: "NRZ", "CONFIG:USEPHASEREF:ON" enables the Use PhaseReference in configuration settings.:VARIABLE:VALUE: "NRZ", "CONFIG:USEPHASEREF" returns 1 if Use Phase Referenceis enabled.



Commands DescriptionReturn Example Returns: $response = ’1'

:VARIABLE:VALUE: "NRZ","CONFIG:PHASEREFCLOCKRATIO:1|2|4|8"

Sets or returns the phase reference clock ratio.

Syntax :VARIABLE:VALUE: "NRZ", "CONFIG:PHASEREFCLOCKRATIO:1|2|4|8"Example :VARIABLE:VALUE: "NRZ", "CONFIG:PHASEREFCLOCKRATIO:1" sets the phase

reference clock value as 1.:VARIABLE:VALUE: "NRZ", "CONFIG:PHASEREFCLOCKRATIO" returns the phasereference clock value as 1.


:VARIABLE:VALUE: "NRZ","CONFIG:SAMPLESPERACQ:1000|2000|4000|8000|16000"

Sets or returns the samples per acquisition.

Syntax :VARIABLE:VALUE: "NRZ", "CONFIG:SAMPLESPERACQ:1000|2000|4000|8000|16000"Example :VARIABLE:VALUE: "NRZ", "CONFIG:SAMPLESPERACQ:1000" sets the samples per

acquisition value as 64.:VARIABLE:VALUE:? "NRZ", "CONFIG:SAMPLESPERACQ" returns the samples peracquisition value as 1000.


:VARIABLE:VALUE: "NRZ","CONFIG:NOOFACQS:<INTEGER>"

Sets or returns the number of acquisitions value.

Syntax :VARIABLE:VALUE: "NRZ", "CONFIG:NOOFACQS:<INTEGER>"<INTEGER> = 50 to 1000

Example :VARIABLE:VALUE: "NRZ", "CONFIG:NOOFACQS:64" sets the acquisitions value as 64.:VARIABLE:VALUE:? "NRZ", "CONFIG:NOOFACQS" returns the acquisitions value as 64.


:VARIABLE:VALUE "NRZ","CONFIG:SAVERESULTSTOFILE:ON|OFF"

Sets or disables the save results to file.

Syntax :VARIABLE:VALUE "NRZ", "CONFIG:SAVERESULTSTOFILE:ON|OFF"ON | 1 enables the save results to file.OFF | 0 disables the save results to file.

Example :VARIABLE:VALUE "NRZ", "CONFIG:SAVERESULTSTOFILE:ON" enables the saveresults to file.

Table 9: Results commands and queries

Commands Description:VARIABLE:VALUE? "NRZ","RESULT:CH<X>:<MeasurementList>"

Returns the measurement result for the selected channel.

Syntax :VARIABLE:VALUE? "NRZ", "RESULT:CH<X>:<MeasurementList>"<X> = 1 to 4 <MeasurementList> = ALLMEAS | AOP | ER | TDEC | +Overshoot

Example :VARIABLE:VALUE? "NRZ", "RESULT:Ch2:ALLMEAS" returns the measurement result forchannel 2



Programming examples

Perl program example:configure and operate

NRZ-M4

With available offline analysis, NRZ-M4 offers a programmatic interface similarto that of TekScope, JNB, or other on-scope applications. A client needs to knowhow to interface and synchronize with the application. The Perl script belowgives an example of such a client (similar clients could be implemented inPython, .NET, etc.). A file interface is used to communicate between NRZ-M4and the client.

NOTE.■ The examples presume that you are familiar with designing GPIB programs.■ All words within quotes are case sensitive and must be entered exactly as

shown, including spaces and quotes.

Prerequisites


■ Perl needs to be installed and in the user’s path

■ The client expects to be able to write “NRZ_CommandFile.txt” and “NRZ-M4_LogFile.txt” to the current working directory (C:\Users\<user>\AppData\Local\Temp) for communication and logging. For multiple instances, thefiles "NRZ_CommandFile<instanceId>.txt" and "NRZ-M4_LogFile<instanceId>.txt" are used. See below for examples.

The measurement results are captured in NRZ-M4_ResultsFile.txt at thesame directory.

■ The client by default enters an ‘interactive’ mode, reading from STDIN(which times out and exits after 5 minutes). At this point you can send any ofthe specified commands and queries.

Example Main Program Execution

NRZ-M4.exe <instanceId>

Starts the main UI program with assigned instance id of <instanceId>. Thedefault instanceId is 1. For each instance other than 1, a separate client mayconnect to each unique instance. Each separate client for instanceIds other than1 can connect to that particular <instanceId> via the corresponding"NRZ_CommandFile<instanceId>.txt". e.g., upon execution of the following:

NRZ-M4.exe 1

NRZ-M4.exe 2

NRZ-M4.exe 3

, client 1 may connect to instance 1 via %TEMP%\NRZ_CommandFile.txt, andclient 2 may connect to instance 2 via %TEMP%\NRZ_CommandFile2.txt, andclient 3 may connect to instance 3 via %TEMP%\NRZ_CommandFile3.txt.



NOTE. For the Example Client Execution below, you would need to use the "–appInstance=<instanceId>" to tell the client to connect to the specific<instanceId> UI execution. See the example using the "-appInstance" flag below.

Example Client Execution

perl NRZ-M4_PI_Client.pl

Starts the client in interactive mode, which reads the commands/queries fromstdin. This is ideal if the UI is already running.

NOTE. You may need to use the –filePath “<pathToTDECQexe>” to tell theclient where to connect to the currently running Appplication’s process).

perl NRZ-M4_PI_Client.pl –startApp

Starts the client and the main application (ideal if the UI is not running yet)which in turn reads the set of commands/queries from stdin.

Once stdin is ready to read commands, an example set to send is:

:VARIABLE:VALUE "NRZ", "ACTIVATE"

:VARIABLE:VALUE "NRZ", "CONNECT:134.64.245.72"

:VARIABLE:VALUE "NRZ", "eyemeasurements:1"

:VARIABLE:VALUE "NRZ", "amplitudemeasurements:1"

:VARIABLE:VALUE "NRZ", "timingmeasurements:1"

:VARIABLE:VALUE "NRZ", "maskmeasurements:1"

:VARIABLE:VALUE "NRZ", "ANALYZE"

:VARIABLE:VALUE? "NRZ", "STATUS"

:VARIABLE:VALUE? "NRZ", "RESULT:ALLCHANNELS:ALLMEAS"

perl NRZ-M4_PI_Client.pl –startApp < NRZ-M4_PI_Client_Example_CmdSet.txt

Starts the client which in turn reads the set of commands/queries from the .txtfile.

Example output from similar commands is:...> :variable:value? "NRZ","NRZ" $response = ‘NRZ:5.8421’> :variable:value "NRZ","exit" Beginning shutdown......shutdown complete.

perl NRZ-M4_PI_Client.pl –startApp -appInstance=2



Starts the client and the main application with the instance ID 2, which in turnreads the set of commands/queries from stdin. A query of :var:val?"tdecq","instanceid" at this point should return the value of "2".

NOTE.■ The log file at “%TEMP%\NRZ-M4_LogFile.txt” will contain trace and

debug information from any client run, including the NRZ-M4 MatLabprocessing output after exiting the client.

■ Many other behaviors may be configured by the client, such as file paths andrun modes. See the “$configParams” section for details.

Python example A simple Python programming example file is provided.

The example establishes a connection to the NRZ-M4 application and provides asimple interface to send commands to the application.

NOTE. Python is required to be installed on the PC.

1. Open a DOS command window.

2. Enter the Python example file name “NRZ-M4_PIClient.py”.

3. Wait for the program to run and for the UI window to open to sendcommands.

The actual Python example file is located at C:\Users\Public\Tektronix\TekApplications\NRZ-M4\ PIExamples.



Guide to connect the oscilloscope

Check network accessThe first step to troubleshoot a connection problem is to check the networkaccess.

Ensure that the DSA8300 is connected to the network, and the TekScopeapplication is running.

TekVISA setup and troubleshooting■ Verify that TekVISA is installed on the PC.

■ TekVISA is required to be running on both the PC and the targetoscilloscope.Look for the TekVISA icon in task bar.

■ If other VISA software is installed on the PC, verify that TekVISA is thedefault VISA. Use the OpenChoice VISA64 Conflict Manger (available inthe list of applications under the TekVISA program folder).


■ Make sure that the instrument is detected in the TekVISA Open ChoiceInstrument Manager (available in the list of applications under the TekVISAprogram folder).

To detect an instrument for through TekVISA, select the Search Criteriabutton and then select LAN. Search on the IP address.



■ Make sure that the VXI-11 server under TekVISA LAN Server is started onthe DSA8300. The server is turned off after the instrument is rebooted, souser needs to start it manually.

Firewall exceptions■ Make sure that TekVISA inbound and outbound traffic are allowed through

the Windows Firewall on both the DSA8300 instrument and the PC runningNRZ-M4 application.

■ Make sure that NRZ-M4 application is added to the Windows Firewallexception list on the PC.

Open the "Windows Firewall" from "Control Panel", and follow instructionsunder "Allow an app or feature through Windows Firewall".



IndexAApplication directories, 6Application panels

measurement configuration, 11measurement selections, 9

CComputer requirements, 3Contacting Tektronix, 2

EExtensions, file names, 5

FFile menu, 13File name extensions, 5

HHelp conventions, 1

IInstalling the software, 5Instruments and accessories required, 4

LLaunch the application, 7

NNames, file extensions, 5

PProgrammatic interface

handshaking protocol, 17perl program example, 26python example, 28remote control introduction, 17setting up the PI environment, 18syntax, 19variable name arguments and queries, 20

RRelated documentation, 2Results elements, 14

SScope menu, 13Software requirements, 3Support, 2

TTechnical support, 2TekVISA software, 4

VView software version, 6


Index


nrz-m4 application printable application help · the nrz-m4 application is designed to run on a pc...

Documents