xx
80SJARB
ZZZ
Jitter Analysis of Arbitrary Data Software
Printable Online Help
*P077064200*
077-0642-00
80SJARB
Jitter Analysis of Arbitrary Data Software
ZZZ
PrintableOnlineHelp
www.tektronix.com
077-0642-00
Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its
subsidiaries or suppliers, and are p rotected by national copyright laws and international treaty provisions.
Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this
publication supersedes that in all p reviously published material. Specifications and price change privileges
reserved.
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
This document supports 80SJARB software version 3.0.X and greater, operating on a DSA8300 Digital
Serial Analyzer oscilloscope.
Contacting Tektronix
Tektronix, Inc.
14150 SW Karl Braun Drive
P. O . B o x 5 0 0
Beaverton, OR 97077
USA
For product information, sales, service, and technical support:
In North America, call 1-800-833-9200.
Worldwide, visit www.tektronix.com to find contacts in your area.
Table of Contents
Welcome
Welcome to the 80SJARB Jitter Analysis of Arbitrary Data Software .. . . .... . .... . .... ... . . .... . .... . .... . . 1
Using Online Help....... .................................. ................................ ......................... 1
Conventions ................ ................................ .................................. ....................... 2
Feedback and Technical Support........... ................................ ................................ ....... 3
Table of Contents
Getting S
tarted
Requirements................... ................................ .................................. ................... 5
Install and Activate the Software .......................... ................................ ....................... 5
Install from the Jitter Application CD .... . .... . .... .... . .... . .... ..... ... . . .... . .... . .... .... . .... . .... ..... 5
Download and Install from the Tektronix Web Site........................................................ 6
Operating Basics
Starting the 80SJARB Application ............................................................................... 7
The User Interface
The 80SJARB User Interface.......................................... .................................. ..... 7
Menu Items ..................................................................................................... 8
Function Buttons.......................... ................................ .................................. ... 9
Measurement Readout........................................................................................ 10
Status Bar...................................................................................................... 11
Bathtub and Histogram Graphs .............. ................................ ................................ .... 12
Measurement Workflow........................................................................................... 13
Reference
Measurement Setup Modes......................... ................................ .............................. 15
Automatic Setup of Waveform Database and Histogram .... ................................ ............ 15
Manual Setup of Waveform Database and Histogram............ ................................ ........ 15
Comparison of Jitter Measurement Applications ............................ ................................ .. 16
Measurement Methodology .......................... ................................ ............................ 17
Measurement Readouts and Accuracy .......................................................................... 18
Remote Control
Remote Control Introduction................................................................................ 19
GPIB Reference Materials................................................................................... 19
Programming Tips ...... .................................. ................................ .................... 20
Syntax.... .................................. ................................ ................................ .... 22
80SJARB GPIB Commands......... .................................. ................................ ...... 22
Error and Warning Codes and Messages............. ................................ ...................... 24
80SJARB Printable Online Help i
Table of Contents
Index
ii 80SJARB Printable Online Help
Welcome Welcome to the 80SJARB Jitter Analysis of Arbitrary Data Software
Welcome to the 80SJARB Jitter Analysis of Arbitrary Data Software
The 80SJARB Jitter Analysis of Arbitrary Data software enhances the capabilities of the Tektronix
DSA8300 Digital Serial Analyzer sampling oscilloscope. This application provides basic jitter
measurement
J2 – Total jitter for Bit Error Rate (BER) = 2.5E-03
J9 – Total jitter for BER = 2.5E-10
Tj – Total jitter for BER = 1.0E-12
DJdd – Deterministic jitter (Dual Dirac method)
RJdd – Random jitter (Dual Dirac method)
s for arbitrary data signals, including:
Jitter ba
Histogram of the acquired data
The accuracy and repeatability of all measurements improves as the application acquires additional data.
While the standa r ds specify that J2 and J9 measurements be taken on a minimum of 10,000 points, the
80SJAR
number of points used for the extrapolated measurement calculations.
onix also offers two other optional jitter measurement applications for the DSA8300 oscilloscope:
Tektr
80SJNB (Jitter, Noise and BER Analysis Essentials) and 80SJNB-01 (Jitter, Noise and BER Analysis
Advanced). Comparison of Jitter Measurement Applications
the jitter analysis applications.
thtub curve graph (both measured and extrapolated data)
B application acquires data beyond this minimum requirement (in free-run mode) and shows the
See Also:
Requirements (see page 5)
Starting the 80SJARB Application (see page 7)
Using Online Help
(see page 16) provides a comparison of
Online help has many advantages over a printed manual because of advanced search capabilities. The
main (opening) Help screen shows a series of book icons and three tabs along the top menu, each of
which offers a unique mode of assistance:
80SJARB Printable Online Help 1
Welc ome Conventions
Contents tab - organizes the Help into book-like sections. Select a book icon to open a section;
select any of the topics listed under the book.
Index tab - enables you to scroll a list of alphabetical keywords. Select the topic of interest to display
the corresponding help page.
Search tab - enables you to search the entire help contents for keywords. Select the topic of interest to
display the corresponding help page. Search results do not include text c ontained within illustrations
or screen sh
NOTE. Blue-underlined text in a topic indicates a hyperlink to another topic. For example, select the blue
text in this sentence to jump to the topic on Feedback and Technical Support
TIP. When you use a mouse, the normal cursor changes to a link cursor when over an active hyperlink.
ots.
(see page 3).
Convent
Online
ions
help topics use the following conventions:
The terms “80SJARB”, “80SJARB application” or “application” refer to the 80SJARB Jitter Analysis
itrary Data software.
of Arb
The term “oscilloscope” refers to the product on which this application runs.
The term “select” is a generic term that applies to the two mechanical methods of choosing an option:
with a mouse or with the touch screen.
When steps require a sequence of selections in the application interface, the “>” delimiter marks
each transition between a menu and an option. For example, File > Exit indicates to select the File
u, then select the Exit submenu item.
men
2 80SJARB Printable Online Help
Welcome Feedback and Technical Support
Feedback and Technical Support
Tektronix values your feedback on our products. To help us serve you better, please send us your
suggestions, ideas, or comments about your application or oscilloscope.
When you contact Tektronix Technical Support with suggestions, or to help you resolve a problem, please
include the following information (be as specific as possible):
General Information
Oscillosc
Module and probe configuration. Include model numbers and the channel/slot location.
Serial data standard.
Signaling rate.
Pattern type and length.
Your name, company, mailing address, phone number, FAX number.
ope model number, firmware version number, and hardware options, if any.
Application-Specific Information
80SJARB Software version number.
Description of the problem such that technical support can duplicate the problem.
ssible, save the oscilloscope waveform fileasa.wfmfile.
If po
If possible, save the oscilloscope and application .stp setup files.
Once you have gathered this information, you can contact Tektronix
e-mail, be sure to enter 80SJARB Problem in the subject line, and attach the .stp and .wfm files.
P. To include screen shots, select Print > Save as File from the oscilloscope menu bar. Enter a file name
TI
and image type. The recommended .png format preserves all pixels in the image. The .jpg format is not
recommended as it compresses the image and can change some pixels. Click Save to save the file in the
C:\Users\<username>\Documents\TekScope\UI directory.
by phone or through e-mail. If using
80SJARB Printable Online Help 3
Welcome Feedback and Technical Support
4 80SJARB Printable Online Help
Getting Started Requirements
Requirements
A Tektronix DSA8300 oscilloscope running Microsoft Windows 7.
TekScope firmware version 6.0.3.X or higher.
An 80SJARB, 80SJNB, or 80SJNB-01 application license. To check if an application license is already
active on the instrument, click Utilities > System Properties andlookattheOptions tab contents.
NOTE. You do not need to purchase a license for 8 0SJARB if you already have a license for 80SJNB or
80SJNB-01.
NOTE. You can run the 80SJARB software up to ten times in the free trial mode. Once the trials are
used, the software will no longer start.
See Also:
Install and Activate the Software (see page 5)
Install and Activate the Software
NOTE. Make sure to check the requirements (see page 5) before installing and activating the 80SJARB
application.
See Also:
Starting the 80SJARB Application (see page 7)
Install from the Jitter Application CD
1. Power on the instrument and wait until the startup procedure is complete.
2. Insert the DSA8300 Digital Serial Analyzer Jitter Analysis Software CD into the instrument media
drive to open the install application.
3. Click 80SJARB Arbitrary Jitter Analyzer. Follow on-screen instructions.
4. Restart the oscilloscope after installing the 80SJARB software.
5. Click the Applications menu and verify that 80SJARB is listed.
6. Click Utilities > Option Installation and follow the instructions to enable the 80SJARB application if
you purchased a license and key code.
80SJARB Printable Online Help 5
Getting Started Install and Activate the Software
NOTE. You do not need a license and Option Installation Key for 80SJARB if you already have a license
and key for 80SJNB or 80SJNB-01. If you do not have a license and key for the 80SJNB or 80SJNB-01
application,
you must purchase a license and key code for 80SJARB.
Download and Install from the Tektronix Web Site
1. Go to www.tek.com\software.
2. Enter the application name (80SJARB) in the Search Software fi eld and click GO.
3. Click the Sort by DATE link at the top of the list.
4. Click the l
information on the application.
5. Click Dow
6. When requested, specify to Save the application file to your PC.
7. Copy the install software to the DSA8300 oscilloscope.
8. Double-click the install software file to begin installation. Follow on-screen instructions.
9. Restart the oscilloscope after installing the 80SJARB software.
10. Click the Applications menu and verify that 80SJARB is listed.
11. Click
you purchased a license and key code.
NOTE. You do not need a license and Option Installation Key for 80SJARB if you already have a license
and key for 80SJNB or 80SJNB-01. If you do not have a license and key for the 80SJNB or 80SJNB-01
application, you must purchase a license and key code for 80SJARB.
ink for the latest version of 80SJARB application software to open a Web page with more
nload File. Follow instructions to log in.
Utilities > Option Installation and follow the instructions to enable the 80SJARB application if
6 80SJARB Printable Online Help
Operating Basics Starting the 80SJARB Application
Starting the 80SJARB Application
Use any of the following methods to start the 80SJARB application:
Click Applications > 80SJARB in the oscilloscope menu.
Double-click the 80SJARB shortcut on the desktop.
Click Start > All Programs > Tektronix Applications > 80SJARB > 80SJARB.
Activate 80
See Remote Control Introduction
All of thes
NOTE. You can run only one oscilloscope application at a time. Running more than one application
causes one or more of the running applications to fail. To run the 80SJARB application, close all other
applications (such as 80SJNB). To run another application, you must close the 80SJARB application. The
optional applications communicate with the oscilloscope over VISA to detect commands to itself. A
communications conflict happens when two applications run simultaneously.
Please contact Tektronix if activating multiple applications simultaneously is important to your use of the
instrument.
NOTE. To start the 80SJARB application more quickly, click the oscilloscope Run/Stop button to stop the
oscilloscope signal acquisition before you start the 80SJARB application.
SJARB remotely by using GPIB commands with the oscilloscope programmable interface.
(see page 19).
e methods open the 80SJARB user interface
(see page 7).
See Also:
The 80SJARB User Interface (see page 7)
Measurement Workflow (see page 13)
Operating Modes (see page 15)
mote Control Introduction
Re
(see page 19)
The 80SJARB User Interface
The 80SJARB user interface consists of menus, function buttons, a measurement readout pane, and
a status bar at the bottom of the display. The application also displays a progress bar to indicate the
approximate completion status of each step.
80SJARB Printable Online Help 7
Operating Basics Menu Items
See Also:
Menu Items (see page 8)
Function Buttons (see page 9)
Measurement Readout (see page 10)
Status Bar (see page 11)
Bathtub and Histogram Graphs (see page 12)
Measurement Workflow (see page 13)
Operating Modes (see page 15)
Menu Items
Menu Submenu Description
File
View
Hibernate
Exit Exits the application.
BER Bathtub
Histogram
Data
Places 80SJARB in a hibernation state; the application remains running but does
not communicate with the oscilloscope. This prevents 80SJARB from interfering
with other applications.
To wake up the application, click File and unselect the Hibernate menu item. You
can also wake up the application by selecting Applications > 80SJARB in the
oscilloscope menu, or using commands through the programmatic interface
page 19).
Displays a graph of the cumulative density function, in Q scale versus time.
Displays a normalized histogram of the acquired data.
(see
8 80SJARB Printable Online Help
Operating Basics Function Buttons
Menu Submenu Description
Help
xxx
Online Help Displays the a
About
80SJARB
Displays an Ab
pplication online help (this document).
out dialog box that contains the version number of 80SJARB.
See Also:
Function Buttons (see page 9)
Measurement Readout (see page 10)
Status Bar (see page 11)
Bathtub and Histogram Graphs (see page 12)
Functio
80SJARB
Button Name Description
xxx
See Also:
n Buttons
provides three control buttons: Free Run, Run, and Stop.
Free Run
Run
p
Sto
Menu Items (see page 8)
Enables or disables the Free-Run (continuous) measurement mode. In Free Run mode
illoscope continues to acquire data after a single measurement is taken. 80SJARB
the osc
continues to process and display updated measurement results, including the number of
hits in the histogram. The number of hits continues to increase when in this mode.
utton does not start a measurement acquisition; you must click the Run button to
This b
start taking m easurements.
Starts a measurement sequence (single or Free Run). 80SJARB takes a measurement
acquisition based on the oscilloscope settings, then processes and displays the
urement values.
meas
ps the 80SJARB measurement sequence. The application does not display
Sto
measurements from a stopped single Run sequence. The application displays
measurements from a stopped Free Run sequence if the application has acquired the
imum 10,000 points.
min
Measurement Readout (see page 10)
Status Bar (see page 11)
80SJARB Printable Online Help 9
Operating Basics Measurement Readout
Measurement Readout
The Measurement Read out pane displays the 80SJARB measurement results. You can select and copy
measurement readout values to paste them into a report or other document.
See Als
o:
Menu Items (see page 8)
Function Buttons (see page 9)
Status Bar (see page 11)
10 80SJARB Printable Online Help
Operating Basics Status Bar
Status Bar
The status bar at the bottom of the display shows the measurement status and error and warning messages
(see page 24). The following table lists the measurement status messages:
Message Description
Ready
Setting up 80SJARB is taking preliminary measurements and setting up the oscilloscope as needed to
Acquiring
Processing
Stopped The Stop button was clicked during a Run mode before the measurement and processing
Hibernating
xxx
See Also:
80SJARB is ready to take measurements.
acquire the histogram data.
The oscilloscope is acquiring data into the histogram for later processing.
80SJARB is processing the histogram data to produce the J2 and J9 measurement results.
sequence was completed.
80SJARB has stopped communicating with the oscilloscope to allow another application to run.
To wake up the application, click File and unselect the Hibernate menu item. You can also
wake up the application by selecting Applications > 80SJARB in the oscilloscope menu.
Menu Items (see page 8)
Function Buttons (see page 9)
Measurement Readout (see page 10)
80SJARB Printable Online Help 11
Operating Basics Bathtub and Histogram Graphs
Bathtub and Histogram Graphs
Select BER Bathtub or Histogram Data in the View menu to display a graph of these items. Use the
Toolbar buttons on the graphs to zoom in or out of the graph, pan the graph, rotate the graph to view it in
2D or 3D mode,
context-sensitive menu (displayed by right-clicking on the graph).
or use cursors to take measurements on the graph. Each graph mode has its own unique
12 80SJARB Printable Online Help
Operating Basics Measurement Workflow
Measurement Workflow
1. Click Utilities > Default Setup to restore the oscilloscope to the default instrument settings.
2. Set the oscilloscope to properly display an eye diagram. One method is to use a defined test mask and
then perform a mask autoset.
3. In the 80SJARB application, click the Run button. For more accurate measurements, click the Free
Run button to enable the Free Run mode before clicking Run. 80SJARB communicates with the
oscilloscope, changes measurement settings as required, and displays the measurement values in the
Measurement Results pane.
4. Click View > BER Bathtub or View > Histogram Data to view a Bathtub or histogram plot.
5. Click File > Exit to close the application.
See Also:
Measurement Modes (see page 15)
Measurement Methodology (see page 17)
80SJARB Printable Online Help 13
Operating Basics Measurement Workflow
14 80SJARB Printable Online Help
Reference Measurement Setup Modes
Measurement Setup Modes
All 80SJARB measurements require that the DSA8300 oscilloscope be set up to acquire and display a
clean eye diagram, with two crossings, in the instrument Main time base view. The waveform can be for
an active (ch
There are two measurement setup modes: automatic setup (default) and manual setup. The application
selects the measurement setup mode based on whether the application or the user sets up the histogram and
waveform database before acquiring data for jitter analysis.
Automatic Setup of Waveform Database and Histogram
For automatic measurement setup, 80SJARB requires a two-crossing eye diagram on the Main acquisition
window (actively acquiring or stopped) with no histograms enabled. The application uses the oscilloscope
waveform databa se and measurement system to find the amplitude of the signal and the crossing level of
the eye diagram on the Main view, then calculates the size and position of a histogram box (set to 1% of
the signal amplitude, centered on the crossing level). It then activates a Mag1 acquisition positioned on the
first eye crossing, turns on the histogram and acquires 10,000 hits in the histogram box.
annel) or a math waveform.
When the acquisition is complete, the application analyzes the histogram data
to its pre-measurement state, turns off the histogram, waveform database and Mag1 view, and displays
the J2 and J9 measurements.
The oscilloscope acquisition can be running or stopped. The Stop After acquisition mode should be
settoRun/StopButtonOnly(default).
Automatic measurements are the fastest way to capture a new set of data for jitter analysis.
Manual Setup of Waveform Database and Histogram
80SJARB uses manual measurement setup mode when a histogram and waveform database are already set
up for a measurement. Reasons to use manual measurement setup include:
When jitter testing is coupled with other measurements, such as Mask testing.
Data is already accumulated, for which you would like additional information.
More precise or custom definition of the eye crossing histogram area to submit for jitter analysis.
There are two forms of manual setups:
1. A histogram with an infinite persist waveform database is definedonjusttheselectedMain waveform.
This waveform must display an eye pattern and the histogram must include two edges.
If acquisitions are running, JARB waits for the required number of histogram hits before
completing its measurements using the Main view of the selected waveform.
, returns the oscilloscope
If acquisitions are stopped, JARB uses the existing waveform database data to take its
measurements using the Main view of the selected waveform. If the number of points in the
80SJARB Printable Online Help 15
Reference Comparison of Jitter Measurement Applications
histogram are significantly below the requirement, the application may show a low resolution
warning message.
2. A h istogram with an infinite persist waveform database is definedontheMag1 view and the Main
view of the selected waveform. The Main view must display an eye pattern.
If acquisitions are running, 80SJARB waits for the required number of histogram hits before
completing its measurements using the Mag1 view of the selected waveform.
If acquisitions are stopped, 80SJARB uses the existing waveform database data to make its
measurements using the Mag1 view of the selected waveform. If the number of points in the
histogram
is significantly below the requirement, the application may show a low resolution
warning message.
In all oth
points in the histogram to correctly measure in compliance with the standard requirements.
See Also:
Compa
Capa
NRZ data supported Any data, including
J2 jitter result Yes
J9 j
TJ total jitter result Yes
DJdd, RJdd
Jitter and Noise analysis
(PJ, RJ, D DJ, PN, RN,
D
BER surface graphs
er cases, 80SJARB adjusts instrument settings to measure the bit period and acquire sufficient
Measurement Methodology (see page 17)
Measurement Readouts and Accuracy (see page 18)
rison of Jitter Measurement Applications
bility
itter result
1
DN, and so on)
ARB
80SJ
31 or random traffic
PRBS
a histogram according
(on
to IEEE 802.3ba)
Yes
(on a histogram according
to IEEE 802.3ba)
(at BER=1E-12)
Yes Yes Yes
No Yes Yes
No Yes Yes
NB
80SJ
Repetitive pattern up to
000 bits
100,
Yes
every edge; set the
(on
BER level to BER=2.5E-03)
Yes
(on every edge; set the
BER level to 2.5E-10)
Yes
(at settable BER; default
R=1.0E-12)
BE
NB-01
80SJ
Repetitive pattern up to
000 bits
100,
Yes
every edge; set the
(on
BER level to BER=2.5E -03)
Yes
(on every edge; set the
BER level to 2.5E-10)
Yes
(at settable BER; default
R=1.0E-12)
BE
16 80SJARB Printable Online Help
Reference Measurement Methodology
Capability 80SJARB 80SJNB 80SJNB-01
SDLA features
(channel emulation,
fixture de-embedding,
equalization
Additional Features
xxx
1
)
dd = Dual Dir
ac.
No No Yes
As the tools a
for up-to-date information.
re updated periodically, please consult the latest data sheet from www.tek.com
Measurement Methodology
80SJARB works with the selected channel or math waveform. If no waveform is selected, or if the selected
waveform
80SJARB uses the oscilloscope’s measurement system to capture eye diagram parameters to take proper
measurem
one waveform database must be available . If a measurement slot or waveform database is not available,
80SJARB displays an error message.
is not a channel or math waveform, 80SJARB displays an error message.
ents. This means that at least one measurement slot (measurement type is set to NONE) and
Under certain conditions 80SJARB enables the Mag1 viewer, a high-resolution acquisition window, to
gather histogram d ata for its measurements. It also enables waveform database and histogram analysis
if needed. W hen the 80SJARB enables an additional resourc e (such as a waveform database or a
Magnification view), it turns off the resource after completing the measurements.
lso:
See A
Measurement Readouts and Accuracy (see page 18)
80SJARB Printable Online Help 17
Reference Measurement Readouts and Accuracy
Measurement Readouts and Accuracy
80SJARB provides the following measurement readouts: J2, J9, TJ (at 1.0E-12), DJdd, RJdd, and the
number of hits in the histogram.
The J2 measurement is the total jitter measured at a BER of 2.5E-3 by measuring from 0.5th to the 99.5th
percentile of the jitter histogram according to IEEE 802.3, paragraph 86.8.3.
Remaining measurements are calculated from a linear extrapolation in Q-space. The J9 measurement is the
total jitter measured at a BER of 2.5E-10. TJ is the total jitter at BER=1.0E-12. DJdd and RJdd are the
Determini
NOTE. While 80SJARB allows measurement on any data (such as larger PRBS patterns, scrambled data,
or live traffic), the accuracy of extrapolated jitter measurements depends on many factors (such as type of
data, probability function of jitter, and amount of data captured) and is less reliable than in a measurement
method that performs full jitter analysis, such as 80SJNB. For this reason the extrapolated results, and the
DJdd and RJdd in particular, should be considered as mostly relative values. For best accuracy, use the
Free Ru
stic Jitter Dual Dirac and Random Jitter Dual Dirac measurements, respectively.
n mode until the extrapolated results stabilize, or use the 80SJNB application.
For additional information on the Dual Dirac method, please see the Tektronix white paper What the
Dual-Dirac Model is and What it is Not, available at www.tek.com.
80SJARB resets the measurement results when you click the Run button and updates the Hits measurement
with the number of hits that have accumulated into the histogram. After processing is completed, the
outs show the latest results.
read
In Free Run mode, once the first set of data is processed, the analysis continues processing new sets of
togram data and updates the measurement readouts until you click the Stop button.
his
See Also:
Measurement Methodology (see page 17)
18 80SJARB Printable Online Help
Reference Remote Control Introduction
Remote Control Introduction
You can control the 80SJARB application through the programmatic interface (PI) of the sampling
oscilloscope on which it is running. You communicate with the application by using VARIABLE:VALUE
remote GPIB c
ommands.
Use the PI command
Your program should comply with the following guidelines:
The 80SJARB application startup must complete before sending GPIB commands to the application.
Querying the variable “Application” returns “80SJARB” when the application startup is complete.
The measurements cycle must comple te before you query data. Querying the variable
“SequencerState” returns “Stop” when the data is ready.
Because the oscilloscope software hosts the GPIB interface for the 80SJARB application, there is some
additional information that is helpful for successful programming.
See Als
o:
GPIB Reference Materials (see page 19)
Programming Tips (see page 20)
Syntax (see page 22)
80SJARB GPIB Commands (see page 22)
Error and Wa rning Codes and Messages (see page 24)
APPlication:ACTivate “80SJARB” to start the 80SJARB application.
B Reference Materials
GPI
use GPIB commands with your oscilloscope, see the programmer manual for your oscilloscope.
To
See Also:
Remote Control Introduction (see page 19)
rogramming Tips
P
Syntax (see page 22)
80SJARB GPIB Commands (see page 22)
Error and Wa rning Codes and Messages (see page 24)
80SJARB Printable Online Help 19
(see page 20)
Reference Programming Tips
Programming Tips
How the Variab
Programmable Interface (PI) commands for the 80SJARB application use a variable/value table.
This table associates named variables with text values. These values are set (variable:value
“VariableName”,“VariableValue”) or queried (variable:value? “VariableName”) from the PI.
If the variable does not already exist in the table when a set command is received, that variable is created
and the specified value is associated with that variable. If the variable is already in the table, the specified
value replaces the existing value. There is no checking done by the table on variable names or values.
Since both items are strings, any arbitrary pair of strings can be associated with each other in this table.
le Value Table Works
Polling and Limit of Variable Values
Each time a change is made to a variable’s value in the table, an event is generated. The 80SJARB
software application polls the oscilloscope software application every 200 ms to see if an event occurred.
If so, 80SJARB queries for the event information which tells 80SJARB which variable changed and
the new value. 80SJARB parses this information to find the variables pertinent to its operation and
reads the new values for those variables. These new values can change the state of 80SJARB
changing the state of the free-run mode) or can cause 80SJARB to perform an operation (such as setting
the sequencer mode to Run).
Because 80SJA
of variables has changed since the last time 80SJARB polled for changes. A result of this operation is
when 80SJARB receives a list of changes but does not necessarily execute those changes in the order
in which they were sent. For example, sending a command to change the sequence mode (such as
“SequenceMode”,“Freerun”) followed immediately by a command to start a measurement sequence
(“SequencerState”,“Run”) does not guarantee that the sequencer mode changed before 80SJARB began
the sequenc
least 400 ms before the SequencerState command.
RB polls for changes at a fixed rate, the oscilloscope application may indicate that a list
ing operation. To enable the proper execution order of these commands, insert a delay of at
(such as
How the Variable Value Table is Updated
80SJARB updates table entries when sequencing is startedandwhenthereisnewdatatoreport. For
example, if an error occurs during sequencing, 80SJARB updates the variables “ErrorCode” and
“ErrorMessage” with new values. These values are set to null strings when sequencing starts again.
Variables to set to null strings (“”) before starting a sequence operation include:
ErrorCode
ErrorMessage
WarningCode
WarningMessage
All measurement values
20 80SJARB Printable Online Help
Reference Programming Tips
Determining if 80SJARB is Running
The “Application” variable indicates the run status of the 80SJARB application. When it is running, this
variable is set to “80SJARB”. When 80SJARB exits normally, the variable is set to “Done”. However, if
the application encounters an error and exits abnormally, 80SJARB does not set the “Application” variable
to “Done”, le
send the c ommand to start it again. If 80SJARB is already running, the new copy immediately exits
(only one copy of 80SJARB can run at a time).
aving the variable set to “80SJARB”. If you are not sure that 80SJARB is running, you can
See Also:
Remote Control Introduction (see page 19)
GPIB Reference Materials (see page 19)
Syntax (see page 22)
80SJARB
Error and Wa rning Codes and Messages (see page 24)
GPIB Commands
(see page 22)
80SJARB Printable Online Help 21
Reference Syntax
Syntax
The VARIABLE:VALUE command structure accepts string arguments for a control or data variable and
a value to which to set the argument.
To set a variable to a value:
VARIABLE:VALUE "<VariableName>","<VariableValue>"
For example:
VARIABLE:VALUE "SequencerState","Stop"
NOTE. The arguments <variable name> and <variable value> are required in the order shown with no
spaces allowed.
To query the value in a variable:
VARIABLE:VALUE? <variable name>
For example:
VARIABLE:VALUE? "TJ"
NOTE. The <variable name> and <variable v alue> arguments are case and space sensitive. The program
will not operate correctly if you do not follow the capitalization and spacing precisely.
See Also:
Remote Control Introduction (see page 19)
GPIB Reference Materials (see page 19)
Programming Tips (see page 20)
80SJARB GPIB Commands (see page 22)
Error and Warning Codes and Messages (see page 24)
80SJARB GPIB Commands
Use the PI command APPlication:ACTivate “80SJARB” to start the 80SJARB application. This
command also wakes up the application when it is in the hibernate state.
The following table lists the 80SJARB application commands. These arguments are in addition to the
instrument and module PI arguments.
22 80SJARB Printable Online Help
Reference 80SJARB GPIB Commands
Variable Value(s) Description Query form retu
Application
DJdd Returns the de
ErrorCode
ErrorMessage Returns the last error
Hits
J2 Returns the measured J2
J9 Returns the measured J9
RJdd Return
SequencerMode {SingleSequence |
SequencerState {Run | Stop} Sets or returns the
TJ Retu
WarningCode
WarningMessage Returns the last warning
xxx
Exit | Hiberna
Freer
te
un}
Exits the application or
enters the app
hibernate state
jitter computed using the
Dual-Dirac method
Returns a numeric code
corresponding to the last
error
message
Returns the number of hits
in the processed histogram
value
value
jitter computed using the
Dual-Dirac method
Sets or returns the
ncer mode
seque
Startup default is Free Run
Measurement Sequencing
e Stop Sequencing
or th
command
rns the measured total
jitter at BER 1E-12
Returns a numeric code
corresponding to the last
rning code
wa
ssage
me
lication
terministic
s the random
Done
Current value
0 = results have been cleared
Current value
0 = errors ha
Current val
"" = errors have been cleared
Current value
0 = results have been cleared
Current value
0=result
Current
0 = results have been cleared
Current value
0 = results have been cleared
Sequencer mode
Sequencer state
Current value
0 = results have been cleared
Current value
warnings have been cleared
0=
rrent value
Cu
"" = warnings have been cleared
ve been cleared
ue
s have been cleared
value
See Also:
rns
emote Control Introduction
R
(see page 19)
GPIB Reference Materials (see page 19)
Programming Tips (see page 20)
Syntax (see page 22)
Error and Wa rning Codes and Messages (see page 24)
80SJARB Printable Online Help 23
Reference Error and Warning Codes and Messages
Error and Warning Codes and Messages
Table 1: Error codes and messages
Error code Error message Description
1
2
3
4 Error: Measurement
5
6
7
8
9
10
11 Error: More than one
Error: No waveform
is selected.
Error: Selected
waveform is not a
channel or math.
Error: Waveform
database is not
available.
slot is not available.
Error: Histogram is
not available.
Error: Could not find
the bit crossing level.
Error: Could not find
the bit crossing time.
Error: Could not
measure the bit
interval.
Error: Could not
measure the signal
amplitude.
Error: Could
not measure the
peak-to-peak jitter.
eye on the main time
base.
No waveforms have been turned on. Turn on the channel or math waveform
on which you want to take measurements.
The selected waveform is a reference waveform. 80SJARB cannot take
measurements on a reference waveform.
All waveform databases are in use and none are available for use on the
selected channel. Turn off at least one waveform database to make it
available to take m easurements.
All measurement slots are in use. Set at least one measurement slot type to
NONE to make it available for use by 80SJARB.
The histogram is assigned to a waveform other than the selected waveform.
Turn the histogram off or set its source to the selected waveform.
The oscilloscope measurement system reports an error when it cannot
find the bit crossing level of the eye diagram. In most cases this error is
generated because the eye diagram does not show an open eye, or one
of the crossings is too close to the edge of the screen or is off the screen.
Make sure that the oscilloscope displays an open eye diagram.
The oscilloscope measurement system reports an error when it cannot
find the bit crossing time of the eye diagram. In most cases this error is
generated because the eye diagram does not show an open eye, or the left
transition is too close to the edge of the screen or is off the screen. Make
sure that the oscilloscope displays an open eye diagram.
The oscilloscope measurement system reports an error when it cannot find
the bit interval of the eye diagram. In most cases this error is generated
because the eye diagram does not show an open eye, or one of the
crossings is too close to the edge of the screen or is off the screen. Make
sure that the oscilloscope displays an open eye diagram.
The oscilloscope measurement system reports an error when it cannot
measure the amplitude of the signal. Make sure that the signal is not larger
than the dynamic input range of the sampling module.
The oscilloscope measurement system reports an error when it cannot
measure the amplitude of the peak-to-peak jitter on the left crossing of the
eye. In most cases this error is caused because the eye diagram does
not show an open eye, or one of the crossings is too close to the edge of
the screen or is off the screen. Make sure that the oscilloscope displays
an open eye diagram.
The oscilloscope is displaying m o re than one eye diagram associated with
the main time base. 80SJARB only works properly with one eye diagram
displayed on the main time base.
24 80SJARB Printable Online Help
Reference Error and Warning Codes and Messages
Table 1: Error codes and messages (cont.)
Error code Error message Description
98 Error: Measurement
error.
The oscilloscope has returned a measurement error that is not covered by
one of the error codes above.
99 Error MATLAB error. An error occurred in MATLAB that was not otherwise handled.
xxx
Table 2: Warning codes and messages
Warning code Warning message Description
1 Warning: Low
Several conditions can cause this warning to be issued, including:
Resolution.
An insufficient number of points in the histogram.
The histogram is distributed in only a few vertical columns.
xxx
See Also:
Remote Control Introduction (see page 19)
GPIB Reference Materials (see page 19)
Programming Tips (see page 20)
x
Synta
(see page 22)
80SJARB GPIB Commands (see page 22)
80SJARB Printable Online Help 25
Reference Error and Warning Codes and Messages
26 80SJARB Printable Online Help
Index
Index
Symbols and Numbers
80SJARB user interface, 7
A
Activate software, 5
Application license, 5
Application trial mode, 5
Application user interface, 7
Argument
s and queries, 22
B
Back button (online help), 1
Bathtub graph, 12
Buttons (user interface), 9
C
Check if 80SJARB is running, 21
Command syntax, 22
ands, 22
Comm
Compare jitter analysis
applications, 16
Conventions, 2
D
Determining if 80SJARB is
running, 21
wnload software, 5
Do
E
Error codes, 24
F
Features, 1
Feedback and technical support, 3
Free application trial mode, 5
G
Getting help, 3
GPIB
arguments and queries, 22
check if 80SJARB is
running, 21
command syntax, 22
commands, 19
error codes
guidelines, 19
limit of variable values, 20
program, 19
programming command, 22
return values, 22
starting
syntax, 22
the variable value table, 20
value table updates, 20
variable value, 22
warning codes and
messa
GPIB reference materials, 19
Graphs
bathtub and histogram, 12
context menus, 12
righ-click m enus, 12
lbar buttons, 12
too
and messages, 24
80SJARB, 19
ges, 24
H
Help topics, 1
Hibernate state, 22
Histogram graph, 12
Histograms and measure-
ments, 15
How to start the application, 7
How to take measurements, 13
I
Install, 5
Install software, 5
Installation requirements, 5
J
J80SJARB, 80SJNB,
80SJNB-01 measurement
comparison, 16
Jitter analysis application
comparison, 16
K
Key code, 5
L
Limit of Variable Values, 20
M
Measurem
Measurement modes, 15
Measurement readout pane (user
Measurement readouts and
Measu
ent methodology, 17
interface), 10
accuracy, 18
rement workflow, 13
O
Online help, 1
P
Polling Variable Values, 20
Product description, 1
Programmer information
(GPIB, 19
ogramming
Pr
arguments and queries, 22
check if 80SJARB is
running, 21
command syntax, 22
commands, 22
error codes and messages, 24
GPIB commands, 22
polling variable values, 20
return values, 22
syntax, 22
Thetariablevaluetable, 20
value table updates, 20
variable value, 22
80SJARB Printable Online Help 27
Index
warning codes and
messages, 24
Programming t
ips, 20
Q
Queries and arguments, 22
R
Remote Control (GPIB), 19
Requirements, 5
Running the application, 7
S
Send us your ideas or
suggest
Software
activate, 6
download, 6
install, 6
key code, 6
ions, 3
Software key code, 5
Starting 80SJARB using
GPIB, 19
Starting the application, 7
Status bar (user interface), 11
Syntax, 22
T
Table of Contents (online help), 1
Taking measurements, 13
Terminolo
The 80SJARB user interface, 7
The variable value table
TOC (online help), 1
Trial mode, 5
gy in online help, 2
(programming), 20
U
Update
s to the variable value
table, 20
User interface, 7
function buttons, 9
measurement r
pane, 10
menus, 8
status bar, 11
Using online help, 1
eadout
V
Variable value, 22
Variable v
alue table updates, 20
W
Warning codes, 2 4
Waveform database and
measurements, 15
28 80SJARB Printable Online Help
Loading...