Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication
supersedes that in all previously published material. Specifications and price change privileges reserved.
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
Contacting Tektronix
Tektronix, Inc.
14150 SW Karl Braun Drive
P.O . B o x 5 0 0
Beaverto
USA
For product information, sales, service, and technical support:
n, OR 97077
In North America, call 1-800-833-9200.
World w ide, visi t www.tektronix.com to find contacts in your area.
This document contains a comprehensive listing or remote control commands
for the Tektronix BERTScope family of products. It includes commands for the
different pl
for each of those commands.
The remote control features enable operation of instrument processes remotely
via an IEEE-488 communications connection. Remote control is implemented
using a text-oriented command protocol that enable you to set and query system
parameters, and to operate the analyzer in different modes, including live error
analysis and offline playback of previously recorded error data.
The text-oriented commands follow a basic three-part structure, consisting of one
word identifying the major feature being addressed, another word identifying
aspeci
The analyzer receives and operates on each command immediately. Command
execution sets a status variable that may be queried by the user to determine if
the previous command was successful. Alternatively, a mode can be selected in
which these statuses are automatically returned after each command execution.
atforms. Restrictions and separate parameters or ranges are noted
fic operation or parameter within that feature, and optional parameters.
This document describes how to interface with the analyzer using the IEEE-488
connection. The Analyzer is an IEEE-488 bus peripheral only; it is not an
IEEE-488 bus controller and cannot produce SRQ signals. The IEEE-488 Setup
el. In the System View, touch the Tools tab, then the Remote button, then
pan
IEEE Address. Enter the unique address in the GPIB Address field.
r more technical assistance in programming your remote control applications,
Fo
please contact your local Tektronix representative.
BERTScope Remote Control Guidev
Preface
viBERTScope Remote Control Guide
Getting started
Remote contro
loverview
The BERTScope analyzer and any connected BERTScope instruments can
be controlled remotely via either an IEEE-488 or a TCP/IP communications
connection
or a host PC..
The remote
computer via either an IEEE-488 or TCP/IP connection. It then routes the
commands to one or more BERTScope instruments, connected to the BERTScope
analyzer or host PC via USB.
If the local host is a BERTScope, then the BERTScope software gets a chance
to handle the command first. Any commands the BERTScope software doesn’t
understand are sent to the BERTScope instruemnt software, which then controls
the BERTScope instruments.
When a BERTScope instrument is connected to a BERTScope, you can inter-mix
BERTScope and BERTScope instrument commands in the same script, program,
or int
are routed to the remote control software directly. In this case, using the
BERTScope-specific commands will result in an error.
For most applications, a single BERTScope instrument is connected to a
BERTScope or host PC. In this case, the BERTScope instrument is automatically
detected and connected when the remote control software is started, and
automatically disconnected when the remote control software is stopped. There
is no need in this case to use the OPEN or CLOSE commands described later in
is section.
th
. The remote control software runs on either a BERTScope anaylyzer,
control software accepts text-oriented commands from a remote
eractive session. If the host is just an ordinary PC, then the commands
If more than one BERTScope instrument is connected (such as a DPP125C and
ne or more Clock Recovery instruments) to the BERTScope or host computer,
o
the remote control software will not connect automatically. In this case, the
Remote computer must issue a NAMES? query to discover the IDs of the
connected BERTScope instruments, and OPEN the one desired before issuing
control commands. If the Remote computer needs to control multiple BERTScope
instruments, it would OPEN, control, then CLOSE one, then OPEN, control, and
CLOSE another. The device that is OPEN is referred to as the current device
throughout this document.
Remote control is implemented using a text-oriented command protocol described
in the following pages of this document. These commands enable you to set
and query the system parameters of the BERTScope instruments, and to retrieve
measurements made by the instrument.
BERTScope Remote Control Guide1
Getting started
Set up the inst
rument for remote control operation
Remote setup is a ccessed from the BERTScope Analyzer System View.
1. In the System view, under the Tools tab Utilities heading, click the Remote
button to access the configuration panel.
2. Before beginning a remote control session, it is necessary to start the Remote
Client application, RemoteClient.exe, on the host computer.
If the host is a BERTScope, click the Remote button from the System View
To ols page. If the host computer is a normal PC, then just execute the
RemoteClient.exe, file.
3. If you are using GPIB to control the BERTScope, enable the IEEE Address
button.
If the button is not enabled, click the Disconnect button; it might take a few
seconds to enable the IEEE Address button.
4. Click the IEEE Address button and enter the required information into the
NI-488.2 Settings dialog box.
Command description
Remote control communications are exchanged as ASCII strings over a LAN
telnet (TCP port 23) between the host computer and the analyzer. Select a
communications port to be used for access to the instrument's remote control
operations. If the port is set to NONE, then remote control is disabled.
The input values of commands are checked against the same ranges as the user
interface. If an input is received that is outside of this legal range, the input will
be clipped and recorded in the status queue.
It is recommended that you request the status of a command by sending
SYStemERRor? after each command. Besides telling you what has happened
with the command, this will also synchronize command transmission and
handling.
2BERTScope Remote Control Guide
Getting started
Command synta
x
Remote Control Command Lines are defined as ASCII text strings ending with
‘\r’ or ‘\n’.
The commands follow a basic three-part structure, consisting of one word
identifying the feature of the BERTScope instrument being addressed, another
word identi
The feature and operation are separated by a colon, and the operation and
parameter (if any), are separated by a space. The operation can be Double,
Integer, or Boolean numbers; a file path name; a special word; or a data type. For
a Boolean data type, the input can be ON, OFF, 1, or 0. The returned response
will be either 1 for true or 0 for false. A question-mark character (?) is added at
the end o
FEATURE:OPERATION PARAMETER
Commands and parameters are generally case-insensitive, with the notable
exception of those requiring a case-sensitive parameter for the Standard names.
Most commands have both a “long version” and “short version,” indicated by
capitalized versus lowercase letters. For example:
typed
are required; the lowercase letters are optional – commands are not case-sensitive.
The s
for example). You might want to use the long form in scripts or programs, to
increase code clarity.
fying a specific operation within that feature, and optional parameters.
f a command, without a space, to create a query.
GENerator:PATTern? can be
out exactly as shown, or as
hort form is convenient during interactive control (using a telnet session,
GEN:PATT? The capital letters and the colon (:)
Features
When command setup data uses a string as a parameter (a filename or path name,
for instance), enclose the string in double-quotes (“string”).
For every command processed, an error code will be returned. If the command
has a question mark (a query), the setup information is also returned.
The BERTScope remote control commands are divided into feature groups. The
number of features per each group depend on the BERTScope product.
In the first group are commands that handle device discovery and connection. You
can use these commands anytime, even if a current device has not been selected
yet (with the OPEN command). The NAMES, OPEN, and CLOSE commands are
allpartofthisgroup.
A second group consists of commands for controlling and monitoring a particular
BERTScope instruments. The current device must have been specified (using the
OPEN command) before to using any commands in this group.
BERTScope Remote Control Guide3
Getting started
Operations
Read-only properties
Read-write properties
In addition to t
to control the host computer display (VIEW, PTFILE, GUILOCKOUT), the
run state (RSTATE, RDURATION), and the overall program configuration
(SCONFIGURATION, RCONFIGURATION, ISSTATUS, RSSTATUS). These
commands primarily implement the functionality provided by the GUI Console
buttons.
Queryareadablepropertybyappendingaquestionmarktoit(withnospace
between the command and the question mark). For example:
CRS:OPEN?
returns the device name of the currently connected BERTScope CR. In most
cases, the returned values are all capitalized.
Query a read-write property by appending a question mark after it.
Set a read-write property by adding an appropriate parameter. For example:
DPP:OPEN “DPP_1234”
selects the BERTScope DPP with the device name DPP_1234 as the current
device, while
he various feature groups, several miscellaneous features exist
Write-only operation
Parameters
DPP:OPEN?
returns name of the device previously OPENed.
Question marks are illegal for write-only operation, and parameters may or may
not be required, depending upon the particular operation. For example:
requires the complete pathname of the BERTScope DPP configuration file.
A parameter can be a double or integer number, Boolean (0 or 1), an enumerated
data type, or a string.
When a command uses a string as a parameter, the string is enclosed in double
quotes (
double quotes.
“string”). Filenames always require the absolute path, enclosed within
4BERTScope Remote Control Guide
Getting started
Command status
Parameters are
generally case-insensitive, with the notable exception of
case-sensitive Standard names. For example:
CRC:STANDARD “123abc”
and
CRC:DELETESTANDARD “123ABC”
are specifying different user-defined clock recovery standards.
The BERTScope instrument receives and operates on each command immediately.
The input values of commands are checked. If an input is received that is outside
of the legal range, the input will be clipped and recorded in the status queue.
Command execution sets a status variable that can be queried by the user to
determine if the previous command was successful.
Request the status of a command by sending:
SYSTEM:ERROR? or SYST:ERR?
This command retrieves items listed in the error status queue, in the format:
Command
Error messages
< n, “event/string” >
The status queue is first in, first out. It can contain up t o 100 error messages. If the
status queue overflows, the last error/event in the queue is replaced with Error
-350, “Queue overflow”. When all errors/events have been read from the
queue, further error/event queries will return
To clear the status queue all at once, send:
*CLS
error messages and codes
The following error messages might be returned:
"TOO MANY PARAMETERS"
"UNRECOGNIZED COMMA
"WRONG PARAMETER TYPE"
"TOO LITTLE PARAMETERS"
"WRONG PARAMETER FORMAT"
"WRONG PARAMETER NUMBER"
0, “NO ERROR”.
ND"
"WRONG ACTION-ONLY"
BERTScope Remote Control Guide5
Getting started
Error codes
The following error codes might be returned:
0 "NO ERROR"
-350 "Queue Overflow"
-10 File transfer error
-20 System
-30 Command error, see list of error messages
-40 No software option
Communications timeouts
Most commands issued to the BERTSope/BitAlyzer are processed quickly and
return within immediately. However a handful of commands might require
considerable processing and take longer, including the following:
"WRONG QUERY-O
“REQUESTED <QUERY PARAMETER> IS NOT SUPPORTED ON THE
PLATFORM”
rator data signal enabling (BERTScope only) — 7 seconds
Gene
Run state enable (Physical layer tests that perform initial auto-align) —
conds
6se
As a result, programming the communications architecture with a two-second
meout for most command, and a 10-second timeout for the above-listed
ti
commands is one approach. Another approach is to set all communication
timeouts to be 10 seconds. Of course, commands that don’t require this much time
will not be affected by the longer timeout. This ensures that all commands can
complete without triggering communications timeouts.
6BERTScope Remote Control Guide
Command listing
Generator (See page 11, Generator.)
Data Generator (See page 17,
Generator Data Generator.)
Pattern Start (See page 19, GeneratorPattern Start.)
Spread Spectrum Clock (See page 20,
Generator Spread Spectrum Clock.)
Clock Input (See page 22, GeneratorClock Input.)
Clock Output + (See page 24,
Generator Clock Output Positive.)
Clock Output – (See page 27,
Generator Clock Output Negative.)
GSM Configure/Enable (See page 41,
GSM - Stressed Eye Configure/Enable.)
Detector (See page 51, Detector.)
Error D etector (See page 54, DetectorError Detector.)
Start Detect (See page 58, DetectorStart Detect.)
Clock Input (See page 59, DetectorClock Input.)
Data Input (See page 61, Detector DataInput.)
Blank Input (See page 63, DetectorBlank Input.)
Symbol Filtering (See page 67,
Detector Symbol Filtering.)
Stress Combiner (See page 71, Stress Combiner Option.)
Stress Combiner command summary
(See page 72, Stress Combinercommand summary.)
Clock Recovery (See page 79, Clock Recovery Option.)
CR Service (See page 84, CRService :Clock Recovery Service.)
CR Control (See page 85, CRControl :Clock Recovery Control.)
CR Loop Response (See page 94,
Clock Recovery Loop Response.)
Clock Output +/– (See page 30, GeneratorClock Output Pos/Neg.)
Data Output + (See page 31, Generator DataOutput Positive.)
Data Output –(See page 34, Generator DataOutput Negative.)
Data Output +/– (See page 36, GeneratorData Output Pos/Neg.)
Trigger (See page 37, Generator Trigger.)
Error Inject(See page 38, Generator ErrorInject.)
GSM Stress Setup (See page 42, GSM -Stressed Eye Setup.)
Trigger (See page 64, Detector Trigger.)
Results (See page 65, Detector Results.)
Auto Align Results (See page 68, DetectorAuto Align Results.)
Optical Mode (See page 69, Detector OpticalMode.)
Convenience (See page 68, DetectorConvenience.)
Stress Combiner commands (See page 74,
Stress Combiner commands.)
CR Jitter Spectrum (See page 99, ClockRecovery Jitter Spectrum.)
CR Miscellaneous (See page 103, ClockRecovery Miscellaneous.)
CR Sample Program (See page 106, ClockRecovery: Sample Program.)
BERTScope Remote Control Guide7
Command listing
CR SSC Waveform (See page 96,
Clock Recovery SSC Waveform.)
Digital Pre-Emphasis Processor (DPP) (S ee page 113, Digital Pre-Emphasis Processor
(DPP) Option
DPP command s
page 114, DPP command summary.)
Lightwave Test Set LTS option (See page 131, Lightwave Test Set (LTS) option.)
LTS remote control setup (See
page 132, LTS remote control setup.)
RC LTS Remote Control Commands
(See page
Commands.)
Analysis Engine (See page 145, Analysis Engine.)
Basic BER (See page 149, Basic BER.)2D Error Map (See page 160, Error Map.)
Block Errors (See page 150, BlockErrors.)
Burst Length (See page 153, Burst
Lengt
Corr
Correlation.)
Error Free Interval (See page 158,
Error Free Interval.)
Physical Layer Test (See page 175, Physical Layer Test.)
Eye Diagram (See page 176, Eye
Di
BER Contour (See page 215, BER Contour.)
Mainframe (See page 261, Mainframe.)
System (See page 269, System View.)
System Event Log (See page 273, System Event Log.)
Configuration (See page 275, Configuration.)
.)
ummary (See
136, LTS Remote Control
h.)
elation (See page 155,
agram.)
e: CleanEye (See page 187,
Ey
Eye: CleanEye.)
Eye: Single Value Waveform (See
page 207, Eye: Single ValueWaveform.)
Eye: Data Collecting (See
page 206, Eye: Data Collecting.)
Eye: Optical Mode (See page 208,
Eye: Optical Mode.)
Eye: Read Eye Measurement
(See page 212, Eye: Read EyeMeasurement.)
DPP Interfac
control commands.)
RC LTS command summary (See page 135,
LTS command summary.)
FEC Emulation (See page 163, FECEmulation.)
Pattern Sensitivity (See page 169, Pattern
Sensi
p Chart (See page 172, Strip Chart.)
Stri
sk Test (See page 247, Mask Test.)
Ma
Jitter Map (See page 222, Jitter Map.)
Jitter Peak (See page 234, Jitter Peak.)
Jitter Tolerance (See page 242, JitterTolerance.)
Q-Factor (See page 254, Q-Factor.)
e(See page 116, DPP remote
tivity.)
Contour Optical Mode (See page 221,
R Contour: Optical Mode.)
BE
8BERTScope Remote Control Guide
Status Queries (See page 277, Status Queries.)
Common Commands (See page 281, Common Commands .)
Command listing
BERTScope Remote Control Guide9
Command listing
10BERTScope Remote Control Guide
Generator
Complete command list (See page 7, Command listing.)
DELAY:GENR e c a l ?
Retrieve the information that indicates whether Generator delay needs
recalibration. Query only. Note: Since monitoring for these calibrations is
suspended while Physical Layer tests are running, using this command under
those circumstances may not return an accurate result.
< 1 >Needs delay recalibration.Returns:
< 0 >Does not need delay recalibration.
GENerato
r:CREFerence <EXTernal | INTernal>
GENerator:CREFerence?
BERTSco
Params:
Returns:
pe Analyzer only. Set or retrieve the Generator input clock reference.
<EXTernal>
<INTernal>
< EXTERNAL | INTERNAL >
External clock reference
Internal clock reference
GENerator:CSELect <INTernal | EXTernal>
rator:CSELect?
GENe
Set or retrieve the clock used by the Generator.
Params:
Returns:
<INTernal>
<EXTernal>
< INTERNAL | EXTERNAL >
Generator uses the internal clock synthesizer
Generator uses the external clock
BERTScope Remote Control Guide11
Generator
GENerator:CUT
OFFKHZ?
Retrieve the frequency at which the Generator switches to the DDR mode.
Applies to BER
TScope BSA175C. Query only.
GENerator:DDEFs <numeric>
GENerator:
DDEFs?
Set or retrieve the Generator data delay in femto-seconds.
Params:<numeric>
Returns:<numeric>
Set Generator data delay in fs.
GENerator:DDELay <numeric>
GENerator:DDELay?
Set or retrieve the Generator data delay in picoseconds.
Params:<numeric>
Returns:<numeric>
or data delay.
Generat
BitAlyzer: Input out of range will be clipped and recorded
in the status queue.
When th
1,500 MHz], Data Delay is within range [0 to 5,000 ps].
BERTScope Analyzer: Input out of range will be clipped
and rec
When the Analyzer is operating within range [1,100 to
12,500 MHz], Data Delay is within range [0 to 3,000 ps].
e BitAlyzer is operating w ithin range [982 to
orded in the status queue.
GENerator:DINVert <bool>
GENerator:DINVert?
Set or retrieve data inversion state for the Generator.
Params:<bool>
Returns:
Nerator:DRATe?
GE
< 1 >Data inversion is on
<0>
On=1,Off=0
Data inversion is off
Retrieve the Generator data rate. Query only.
Returns:<numeric>
Generator data rate in bits/sec. “0” means “No Clock.”
Set or retrieve the Generator data type. PRBS-11 is available only on BERTScope
Analyzers. The Passthrough type is available only on BSA85C, BSA175C, and
BSA286CL.
Params:
Returns:
mand list (See page 7, Command listing.)
<"filename" >
<PN7 | PN11|
PN15 | PN20 |
PN23 | PN31>
<USTart>User pattern (See GEN:UPLoad command to load a
Generator pseudo-random pattern data type.
PN11 pattern is available only on the BERTScope
Analyzer.
user pattern file)
User pattern cycle
All-zeros pattern
When corresponding option is purchased, Detector
Pass-Through mode outputs whatever the Detector has
just received. Available only on BSA85C, BSA175C,
and BSA286CL.
GENerator:PSELect <A | B>
GENerator:PSELect?
Set or retrieve the selected page of the user pattern loaded to the Generator.
<A>User pattern page AParams:
<B>User pattern page B
Returns:
< PAGEA | PAGEB >
GENerator:PSWitch
Switch the page of the user pattern loaded to the Generator. Action only.
BERTScope Remote Control Guide17
Generator Data Generator
GENerator:UPL
oad <"filename">
Load user pattern from the specified file. Action only.
Params:
<"filename">
Use the absolute path name and enclose the string in
double quotes.
GENerator:UPLPercent?
Retrieve the user pattern loading percentage completion value. Query returns 100
if the loading is complete. Query only.
Returns:< number >
The percentage of user pattern loaded into the
Generator
GENerator:UPLTracking<bool>
GENerato
r:UPLTracking?
Set or retrieve whether the Generator tracks the Detector when loading a user
pattern
. If the tracking is true, the command GEN:UPL <“filename”> loads the
user pattern into both the Generator and Detector.
Params:<bool>
Returns:
<1>
<0>
On=1,Off=0
Generator tracks Detector when loading
Generator does not track D etector when loading
rator:UPWLen?
GENe
Retrieve the word count from the Generator RAM. Query only.
Returns:< number >
The number of words in RAM
Complete command list (See page 7, Command listing.)
Set or retrieve the SSC modulation deviation. Argument range is different for first
generation hardware (Option SSC) and second generation (Option XSSC).
Params:<numeric>
Returns:<numeric>
SSC modulation deviation in ppm.
Option SSC: Range [0 to 10,000] in Down spread or Up
spread mode; [0 to 5,000] in Center spread mode.
Option XSSC: Range is a function of data rate. Refer to
BERTScope Analyzer Technical Specifications.
Set or retrieve whether the SSC/XSSC option is enabled (option must be present
in order to enable; see GEN:SSCMOD:PRES command below).
Params:<bool>
Returns:
<1>
<0>
On=1,Off=0
SSC is enabled
SSC is disabled
20BERTScope Remote Control Guide
Generator Spread Spectrum Clock
GENerator:SSC
MOD:FREQuency <numeric>
GENerator:SSCMOD:FREQuency?
Set or retriev
e the SSC modulation frequency. Argument range is different for
first generation hardware (Option SSC) and second generation (Option XSSC).
Params:<numeric>
Returns:<numeric>
GENerator
:SSCMOD:PRESent <bool>
SSC modulation frequency in Hz.
Option SSC: Range [25,000 to 35,000]
Option XSSC:Range [20,000 to 160,000]. Note that
modulation deviation is uncalibrated for modulation
frequencies >40 kHz.
Set or retrieve the termination voltage of the Generator Clock input.
Params:<numeric>
Returns:<numeric>
Generato
[–2,000 to +3,300]. Input out of range will be clipped and
recorded in the status queue.
r Clock input termination voltage in mV. Range
GENerator:CLocKOPTimize
BitAlyzer only. Initiates procedure for optimizing the location of the Generator
external clock input thre shold. May take seconds to complete. Locates the
mid-point of the clock envelope. Action only.
GENerator:CLocKOPTimizeResult?
BitAlyzer only. Returns the located threshold in millivolts. If optimization fails,
returns -99999999 as a sentinel value. Query only.
GENerator:SUBRatediv<1|2|4|8|16|32|64|128>
GENerator:SUBRatediv?
t or retrieve the sub-rate clock output divider for the Generator’s internal
Se
clock synthesizer.
Params:
Returns:
<1 | 2 | 4 | 8 | 16 | 32 | 64 | 128>“1” is full rate.
<1|2|4|8|16|32|64|128>
Complete command list (See page 7, Command listing.)
BERTScope Remote Control Guide23
Generator Clock Output Positive
Generator Clo
ck Output Positive
Complete com
GENerator:COPositive:CLIPped?
Retrieve whether the Generator Clock+ output setting is clipped. Query only.
e the signal level amplitude of the Generator Clock+ output. May
require some delay to complete.
Params:<numeric>
Returns:<numeric>
Generator Clock+ output signal level amplitude in mV.
Input out of range will be clipped and recorded in the
status queue.
BitAlyzer: Range [70 to 2,000].
BERTScope Analyzer: Range [250 to 2,000].
Set or retrieve the signal level offset of the Generator Clock+ output. May require
some delay to complete.
Params:<numeric>
Returns:<numeric>
Generator Clock+ output signal level offset in mV. Input
out of range will be clipped and recorded in the status
queue.
BitAlyzer: Range [–2,000 to +4,000].
BERTScope Analyzer: Range [–2,000 to +2,000].
Set or retrieve whether the Generator Data+/- outputs are linked. May require
some delay to complete.
Params:<bool>
Returns:
<1>
<0>
Generator Data– output termination voltage in mV.
e [–2,000 to +2,000]. Input out of range will be
Rang
clipped and recorded in the status queue.
On=1,Off=0
Generator Data+/– outputs are linked
Generator Data+/– outputs are not linked
36BERTScope Remote Control Guide
Generator Trigger
Generator Tri
gger
Complete com
GENerator:TOFFset <numeric>
GENerator:
Set or retrieve the Generator Trigger offset.
Params:<numeric>
Returns:<numeric>
GENerat
GENerator:TOMethod?
Set or r
mand list (See page 7, Command listing.)
TOFFset?
Generator Trigger offset
BitAlyzer: in 32-bit words. Range [0 to (Pattern Size –
1)] for all the PRBS patterns. For others, the range is
[0 to 0]. Input out of range will be clipped and recorded
in the status queue.
BERTScope Analyzer: in 128-bit words. Range [0 to
(Pattern Size – 1)] for all the PRBS patterns. For others,
the range is [0 to 0]. Input out of range will be clipped
and recorded in the status queue.
or:TOMethod <PCYCle | CLOCk>
etrieve the Generator Trigger out method.
Params:
Returns:
Complete command list (See page 7, Command listing.)
<PCYCle>Generator Trigger out method is pattern cycle
<CLOCk>BitAlyzer: Generator Trigger out method is a
ded-down clock/64
divi
BERTScope Analyzer: Generator trigger out method is
a divided-down clock/256
e the Generator Error Inject mode. May require some delay to
complete.
Params:
Returns:
<CONTinuous>Generator Error Inject mode is continuous
<MANual>
<EXTernal>
<OFF>Generator Error Inject is off
< CONTINUOUS | MANUAL | EXTERNAL | OFF >
Generator Error Inject mode is manual
Generator is set to inject a single error on receipt of an
external signal
GENerator:IBER?
Retrieve the injected BER of the Generator. Query only.
Returns:<numeric>
Comple
te command list (See page 7, Command listing.)
Generator injected bit error rate
BERTScope Remote Control Guide39
Generator Error Inject
40BERTScope Remote Control Guide
Generator Stress Module (GSM) - Stressed Eye
Complete command listing (See page 7, Command listing.)
All GSM commands apply only to the BERTScope family of analyzers. Before
using the GSM commands, send GSM:STRess:ENABle 1 to enable all stress
features (see GSM:STRess).
Complete command listing (See page 7, Command listing.)
All GSM commands apply only to the BERTScope family of analyzers. Before
using the GSM commands, send GSM:STRess:ENABle 1 to enable all stress
es (see GSM:STRess below).
featur
GSM:RCONfiguration <“filename”>
RestoreStressconfiguration. Action only.
s:
Param
Returns:
GSM:SCONfiguration <“filename”>
Save Stress configuration. Action only.
ams:
Par
Returns:
<“filename”>Configuration filename used to restore.
< filename >
<“filename”>Configuration filename used to save.
< filename >
Filename is enclosed in double quotes.
Filename is enclosed in quotes.
BERTScope Remote Control Guide41
GSM - Stressed Eye Setup
GSM:STRess:EN
ABle <bool>
GSM:STRess:ENABle?
Set or retrieve whether the entire global stress feature is enabled. The entire stress
feature includes jitter insertion of sinusoidal jitter (SJ), external sinusoidal jitter
(EXSJ), random jitter (RJ), PRBS jitter (BUJ) and external high frequency jitter
(EXHF).
There are commands to enable each individual stress insertion, such as
GSM:SJitter:ENABle; however, unless the Stress Feature is enabled using this
command, those individual jitter insertion enabling commands do not enable any
jitter insertion. For example, if one sent a GSM:SJ:ENAB 1 without enabling the
stress feature (query GSM:STR:ENAB? returns 0), the system merely caches the
SJ Enable value. The next time GSM:STR:ENAB 1 is sent, the SJ is then enabled.
After the stress feature is enabled, one can still enable or disable individual types
of jitter insertion by sending the corresponding ENABle command.
This command corresponds to the Clock control’s “Jitter Insertion Enabled” menu
item in the Generator view.
Params:<bool>
Returns:
< 1 >All stress enabled
< 0 >All stress disabled
On=1,Off=0
GSM - Stressed Eye Setup
Complete command listing (See page 7, Command listing.)
GSM:BUJitter:AMPUi <number>
GSM:BUJitter:AMPUi?
Set or retrieve the PRBS jitter amplitude in percent of UI.
Params:<number>
Returns:< number >
GSM:BUJitter:ENABle <bool>
GSM:BUJitter:ENABle?
Set or retrieve whether the PRBS jitter on the clock is enabled.
Params:<bool>
Returns:
<1>
<0>
Range [0 to 50%]. The amplitude limits
change with regard to the analyzer’s
operating frequency.
On=1,Off=0
PRBS jitter on the clock is enabled
PRBS jitter on the clock is disabled
42BERTScope Remote Control Guide
GSM - Stressed Eye Setup
GSM:BUJitter:
FREQuency <number>
GSM:BUJitter:FREQuency?
Set or retrieve the PRBS jitter frequency in Hz.
Params:<number>Range [100,000,000 to 2,500,000,000].
e whether sinusoidal interference on the Data+ output is enabled.
On=1,Off=0
<1>
<0>
Sinusoidal interference on Data+ is enabled
Sinusoidal interference on Data+ is disabled
48BERTScope Remote Control Guide
GSM - Stressed Eye Setup
GSM:STRess:EN
ABle <bool>
GSM:STRess:ENABle?
Set or retriev
e whether the entire global stress feature is enabled. The entire stress
feature includes jitter insertion of sinusoidal jitter (SJ), external sinusoidal jitter
(EXSJ), random jitter (RJ), PRBS jitter (BUJ) and external high frequency jitter
(EXHF).
There are commands to enable each individual stress insertion, such as
GSM:SJitter:ENABle; however, unless the Stress Feature is enabled using this
command, those individual jitter insertion enabling commands do not enable any
jitter insertion. For example, if one sent a “GSM:SJ:ENAB 1” without enabling
the stres
s feature (query “GSM:STR:ENAB?” returns 0), the system merely
caches the SJ Enable value. The next time “GSM:STR:ENAB 1” is sent, the
SJ is then enabled. After the stress feature is enabled, one can still enable or
disable individual types of jitter insertion by sending the corresponding ENABle
command.
This command corresponds to the Clock control “Jitter Insertion Enabled” menu
item in the Generator view.
Param
Retur
s:
ns:
>
<bool
<1>Allst
< 0 >All stress disabled
On = 1, Off = 0
ress enabled
BERTScope Remote Control Guide49
GSM - Stressed Eye Setup
50BERTScope Remote Control Guide
Detector
Complete command listing (See page 7, Command listing.)
BERTScope Analyzer only. Set or retrieve the clock invert of the Detector.
Params:<bool>
Returns:
<1>
<0>
On=1,Off=0
Detector Clock is inverted
Detector Clock is not inverted
DETector:DDEFs <numeric>
DETector:DDEFs?
Set or retrieve the Detector data delay in femto-seconds.
Params:<numeric>
Returns:<numeric>
Set Detector data delay in fs
DETector:DDELay <numeric>
DETector:DDELay?
Set or retrieve the data delay of the Detector (in picoseconds).
Params:<numeric>Detector Data delay.
BitAlyzer:When operating within the range [1 to
981 MHz], Detector Data Delay is within a range [0
to 33,000 ps]. Input out of range will be clipped and
recorded in the status queue.
When operating within the range [982 to 1,500 MHz],
the Detector Data Delay is within a range [0 to 5,000 ps].
BERTScope Analyzer: When the Analyzer is operating
within the range [500 to 1,000 MHz], the Detector Data
Delay is within a range [0 to 32,000 ps]. Input out of
range will be clipped and recorded in the status queue.
When the Analyzer is operating within the range [1,100
to 12,500 MHz], the Detector Data Delay is within a
range [0 to 3,000 ps].
Returns:<numeric>
52BERTScope Remote Control Guide
Detector
DELAY:DET R e c a
l?
Retrieve the information that indicates whether Detector delay needs recalibration.
Query only.
NOTE. Since monitoring for these calibrations is suspended while Physical Layer
tests are running, using this command under those circumstances may not return
an accurate result.
Returns:
< 1 >Needs Delay
< 0 >Does not need a Delay Recalibration
Recalibration
DETector:DINVert <bool>
DETector
:DINVert?
Set or retrieve the data invert of the Detector.
Params:<bool>
Returns:
DETect
< 1 >Detector Data is inverted
< 0 >Detector Data is not inverted
or:DRATe?
On=1,Off=0
Retrieve the data rate of the Detector. Query only.
BERTScope Analyzer only. Set or retrieve Detector operating mode, Electrical or
Optical.
Params:
Returns:
<ELEC>BERTScope Analyzer operates in Electrical mode
<OPTIC>BERTScope Analyzer operates in Optical mode
< ELEC | OPTIC >
BERTScope Remote Control Guide53
Detector Error Detector
DETector:PCAL
Perform Detector delay calibration. Action only. May require some delay to
complete.
DETector:RSNumber?
Retrieve the result serial number of the Detector. Query only.
Returns:<numeric>Detector’s
Detector Error Detector
Complete command listing (See page 7, Command listing.)
DETector:ARENable <bool>
DET:AREN <bool>
Set or retrieve the automatic resync setting of the Detector.
Params:<bool>
Returns:
ibration
result serial number
On=1,Off=0
< 1 >Detector automatic resync is on
<0>
Detector automatic resync is off
DETec
tor:ARTHreshold <numeric>
DETector:ARTHreshold?
r retrieve the threshold of the Detector automatic resync.
Set o
Params:<numeric>
Ret
urns:
<nu
meric>
Detector automatic resync threshold in number of errors.
ge [3 to 100,000]. Input out of range will be clipped
Ran
and recorded in the status queue.
54BERTScope Remote Control Guide
Detector Error Detector
DETector:DPAT
tern?
Retrieve detected pattern of the Detector. The PRBS-11 pattern is available only
on BERTScope Analyzers. Query only.
Returns:
1
*PN11 pattern is available only on the BERTScope Analyzer.
GRABNGOGrab and Go
NO_CLOCK
NONE
NOT_AVAILABLE
ONE
IPN7 | IPN11 |
IPN15 | IPN20 |
IPN23 | IPN31
RAM_SHIFTNSYNC Shift and Sync
RAM_TRIGGER
IGRABNGOInverted Grab and Go
IPN7 | IPN11 |
IPN15 | IPN20 |
IPN23 | IPN31
IRAM_SHIFTNSYNC Inverted Shift and Sync
IRAM_TRIGGER
ZERO
No clock
No pattern
Detector is in Live Data mode
All ones
Pseudo-random pattern: PRBS-7, PRBS-111, PRBS-15,
PRBS-20, PRBS-23, or PRBS-31
Trigger
Inverted pseudo-random pattern: PRBS-7, PRBS-11
PRBS-15, PRBS-20, PRBS-23, or PRBS-31
Inverted Trigger
All zeros
1
,
DETector:GLENgth <integer>
DETector:GLENgth?
Set or retrieve the Detector capture length. The action causes the machine to
capture the input number of words into the Detector. The query returns the amount
of captured RAM in words.
Params:<integer>
Returns:< integer >
Number of words to capture
Number of words captured
DETector:ISYNc?
Retrieve whether the Detector is in sync. Query only.
< 1 >Detector is in syncReturns:
< 0 >Detector is not in sync
DETector:LUPFilename?
Retrieve user pattern file that has been loaded to the Detector. Query only.
Returns:
< filename >User pattern file that has been loaded to the Detector.
BERTScope Remote Control Guide55
Detector Error Detector
DETector:NALA
rm?
Retrieve the negative input protection alarm. Query only.
< 1 >Negative input protection alarm is onReturns:
< 0 >No negative input protection alarm
DETector:PA
LArm?
Retrieve the positive input protection alarm state. Query only.
Set or retrieve the termination AC of the Detector Data input in mV. May require
some delay to complete. This command is available only on the BitAlyzer.
Set or retrieve the “Count during blank” setting of the Detector Blank input.
Detector Blank Input
Params:<bool>
Returns:
DETector
< 1 >Detector blank input count during blank is on
<0>
:BINPut:ROENd <bool>
DETector:BINPut:ROENd?
Set or re
Params:<bool>
Returns:
trieve the “Resync on end” setting of the Detector Blank input.
< 1 >Detector blank input resync on end is on
<0>
On=1,Off=0
Detector blank input count during blank is off
On = 1, Off = 0
Detector blank input resync on end is off
BERTScope Remote Control Guide63
Detector Trigger
Detector Trigger
Complete command listing (See page 7, Command listing.)
DETector:TOFFset <numeric>
DETector:TOFFset?
Set or retrieve the Detector Trigger offset.
Params:<numeric>
Returns:<numeric>
DETecto
r:TOMethod <PCYCle | CLOCk>
DETector:TOMethod?
Set or r
Returns:
etrieve the Detector Trigger out method.
<PCYCle>
<CLOCk>BitAlyzer: Detector trigger out method is clock/64
< PATTERNCYCLE | CLOCK/64 >
Detector Trigger offset.
BitAlyzer in 32-bit words. Range [0 to (Pattern Size 1) if
the detected pattern is one of the PRBS patterns. For
other patterns, the range is [0to 0]. Input out of range
will be clipped and recorded in the status queue.
BERTScope Analyzer: in 128-bit words. Range [0 to
(Pattern Size –1)] if the detected pattern is one of the
PRBS patterns. For others, the range is [0 to 0]. Input
out of range will be clipped and recorded in the status
queue.
Detector Trigger out method is pattern cycleParams:
64BERTScope Remote Control Guide
Detector Results
Detector Results
Complete command listing (See page 7, Command listing.)
Set or retrieve the Detector’s results update interval.
Params:<numeric>Detector results update interval in seconds. Range [1 to
put out of range will be clipped and recorded
Returns:<numeric
3,600]. In
in the status queue.
>
66BERTScope Remote Control Guide
Detector Symbol Filtering
Detector Symb
ol Filtering
Complete com
DETector:SYMbolFILtering:ENABle <bool>
DETector:S
Set or retrieve whether Detector Symbol Filtering option is enabled (the
correspon
and 26G analyzers.
Params:<bool>
Returns:
DETecto
PCIESWITCH | SASALIGN | SASPRIMITIVES>
Sets De
tector Symbol Filtering according to a preset. The presets are equivalent
to setting the symbols as shown below. Available only on BERTScope 17.5G and
26G analyzers. Action only.
Params:
Returns:
mand listing (See page 7, Command listing.)
YMbolFILtering:ENABle?
ding option must be purchased). Available only on BERTScope 17.5G
Set or retrieve symbol sequence for Detector Symbol Filtering. User can specify
up to four symbols to be filtered. Available only on BERTScope 17.5G and 26G
analyzers. Usage examples:
Perform Dark Calibration. Action only. May require some delay to complete.
DETector:PDCenter
Perform Data Centering. This command is equivalent to the Auto Align function
on the local control interface. Action only. May require some delay to complete.
DETector:MRESync
Perform manual resync. Action only.
mand listing (See page 7, Command listing.)
Detector Auto Align Results
Complete command listing (See page 7, Command listing.)
DETector:DCAMv?
DET:DCAM?
Retrieve the data center amplitude in mV. Query only.
DETector:DCHMv?
DET:DCHM?
Retrieve the data center height in mV. Query only.
DETector:DCSuccess?
DET:DCS?
Retrieve whether Detector Data Centering (Auto Align) succeeds or not. Query
only.
Returns:
DETector:DCTime?
DET:DCT?
Retrieve the data center time. Query only.
DETector:DCUinterval?
DET:DCU?
<1>
<0>
Data centering is successful
Data centering is not successful
Retrieve the data center unit interval. Query only.
68BERTScope Remote Control Guide
Detector Optical Mode
DETector:DCUM
DET:DCUM?
Retrieve the data center Ua in mV. Query only.
DETector:DCWidth?
DET:DCW?
Retrieve the data center width. Query only.
DETector:IVALue?
DET:IVAL?
Retrieve the illegal value. Query only. Before data centering is successful, all
the result queries will return this illegal value. The user can read the value to
know what it is.
Detector Optical Mode
Complete command listing (See page 7, Command listing.)
NOTE. In Electrical mode, values are displayed in mV or percent of amplitude. In
BERTScope Analyzer only. Set or retrieve Detector operating mode, Electrical or
Optical.
Params:
Returns:
<ELEC>BERTScope Analyzer operates in Electrical mode
<OPTIC>BERTScope Analyzer operates in O ptical mode
< ELEC | OPTIC >
OPTIC:ADDRcv <“string”,long,double,double,bool>
Add a new optical Receiver. Action only.
Params:
<“Name”>
<Wavelength>Range [500 to 2000]
<Gain>
<Offset>
<ACCoupled>Boolean: True (1) for AC Coupled, False (0) for DC
String of (maximum) 15 characters. String is enclosed in
double quotes.
Range [1 to 3000]
Range [500 to 2000]
Coupled
BERTScope Remote Control Guide69
Detector Optical Mode
OPTIC:DELRcv <
“string”>
Delete an optical Receiver.
Params:<“Name”>
OPTIC:PIKRcv <“string”>
OPTIC:PIKRcv?
Select or r
Params:<“Name”>
Returns:<"string
etrieve the selected optical Receiver.
">
String of (maximum) 15 characters. String is enclosed
in double quotes. There should be at least one valid
optical receiver.
String of (maximum) 15 characters. String is enclosed
in double
optical receiver.
quotes. There should be at least one valid
70BERTScope Remote Control Guide
Stress Combiner Option
Complete command listing (See page 7, Command listing.)
Software is available to control the BSAITS125 Interference test set through
the BERTScope Analyzer interface. The following commands apply only to
a BERTScope Analyzer with the BSAITS125 or BSAITS125 EXP capability
installed.
host PC running Microsoft Windows operating systems.
The remote control software runs on either a BERTScope Analyzer, or a
The remote
computer via either an IEEE-488 or TCP/IP connection. It then routes the
commands to the BSAITS125, connected to the BERTScope Analyzer or to a host
PC through a USB connection.
IfthelocalhostisaBERTScopeAnalyzer, then the Analyzer software gets a
chance to handle the command first. Any commands the Analyzer software
doesn’t understand are sent to the stress combiner software, which then controls
the BERTScope BSAITS125.
When a BSAITS125 is connected to a BERTScope Analyzer, you can intermix
BERTScope Analyzer and stress combiner commands in the same script, program,
or interactive session. If the host is just an ordinary PC, then the commands
are routed to the stress combiner software directly. In this case, using the
BERTScope-specific commands will result in an error.
control software accepts text-oriented commands from a remote
For most applications, the BSAITS125 is connected to a BERTScope Analyzer or
host PC. In this case, the BSAITS125 is automatically detected and connected
when the remote control software is started, and automatically disconnected when
the remote control software is stopped. There is no need in this case to use the
OPEN or CLOSE commands described below.
If more than one instrument is connected to the BERTScope Analyzer or host
computer, the remote control software will not connect automatically. In this
case, the Re mote computer must issue a NAMES? query to discover the IDs of
the connected BERTScope instruments, and OPEN the one desired before issuing
control commands. If the Remote computer needs to control multiple BERTScope
instruments, it would OPEN, control, then CLOSE one, then OPEN, control, and
CLOSE another. The device that is OPEN is referred to as the current device
throughout this document.
BERTScope Remote Control Guide71
Stress Combiner command summary
Remote control
in the following pages of this document. These commands enable you to set and
query the system parameters of the BSAITS125, and to retrieve measurements
made by the instrument.
is implemented using a text-oriented command protocol described
Stress Combiner command summary
Complete command listing (See page 7, Command listing.)
NOTE. Commands can only be sent to a BSAITS125 instrument when the
instrument is connected to the system. You can send a query if the device is
connected using the CONNECTED query and start using other Read/Write
properties. Currently, only a single BSAITS125 instrument can be connected to
either a BERTScope instrument or to a laptop for control.
Dynamic Read-Only
Properties
ATTACHDEVCOUNT or ADCT
ATTACHDEVNAMES or NAMES
TOTALDEVCOUNT or TDCT
Read-Write Settings
Write-Only Operations
Static Read-Only
Identification and
Capabilities
Dynamic Read-Only
Properties
Read-Write Settings
OPEN
CLOSE
DATAHZAUTO or DATA
DEVICENAME or DN
ENABVARISI or ENAB
ISSECPRES or ISSE
LINKPRISEC or LINK
SERIALNUM or SN
USEDPP or USED
CONNECTED or CONN
CABLOSS or CABL
CMBISI or CMBI
DPPISI or DPPI
EXT1
EXT2
OUTINF or OUTI
72BERTScope Remote Control Guide
PRIISI
REFFREQ or REFF
SECISI
VA R I S I o r VA R I
Stress Combiner command summary
BERTScope Remote Control Guide73
Stress Combiner commands
Stress Combin
er commands
Complete com
STRCmb:AttachDevCounT?
Retrieves the number of unique BSAITS125s (unique serial numbers) that are
currently responding. Query only.
Returns:< numeric >
STRCmb:attachDevNAMES?
Retrieves a comma-separated list of all BSAITS125s that a re currently connected.
Query only.
Each BSAITS125 is identified by its device name.
Returns:< “string” >
STRCmb:CABLoss <numeric>
STRC:CABLoss?
mand listing (See page 7, Command listing.)
Comma-separated list of BERTScope BSAITS125s
found, or
““ if none found.
Sets or retrieves the cable loss in dB.
Params:< numeric >
Returns:< numeric >
STRCmb:CLOSE
Close the communication connection to the current BSAITS125. Action only.
NOTE. Closing the current BSAITS125 requires that a new BSAITS125 be selected
pened) before issuing any more device-specific commands.
s the serial number string of the currently selected BSAITS125. Query
only.
Returns:< “string” >
STRCmb:
TotalDe v C o u n T ?
Serial number string of the current device
Retrieves the total number of unique BSAITS125s (unique serial numbers) found.
Query o
nly.
NOTE. This number may include devices that are no longer connected to the host
computer, or are powered off.
STRCmb:USEDpp <0 | 1>
STRC:USEDpp?
Set or determine if a DPP is used as an ISI source.
Params:< 0 >
<1>
Returns:
<0 | 1>
DPP is not used as an ISI source.
PP is used as an ISI source.
STRCmb:VARIsi <numeric>
STRC:VARIsi?
Sets or retrieves the variable ISI in dB.
Params:< numeric >
Returns:< numeric >
Variable ISI in dB
78BERTScope Remote Control Guide
Clock Recovery Option
Complete command listing (See page 7, Command listing.)
Software is available to control the BERTScope Clock Recovery instrument
through the BERTScope Analyzer interface. The following commands apply only
to a BERTScope Analyzer with the Clock Recovery Option capability installed.
Clock Recovery command summary (See page 81, Clockrecoverycommandsummary.)
Clock Recovery Service (See page 84, CRService : Clock Recovery Service.)
Clock Recovery Control (See page 85, CRControl : Clock Recovery Control.)
CR Loop Response (See page 94, Clock Recovery Loop Response.)
SSC Waveform (See page 96, Clock Recovery SSC Waveform.)
CR Jitte
CR Miscellaneous (See page 103, Clock Recovery Miscellaneous.)
Sample Program for Clock Recovery Remote Control (See page 106, ClockRecovery: Sample Program.)
The characteristics that define a standard are:
The following industry standards are pre-programmed as defined at this time.
Note that the definitions of the standards are subject to change by the establishing
committees.
All parameters can be manually adjusted, and custom configurations can be
created. This provision also makes it possible to delete a predefinedstandard—if
this happens, you will have to manually re-create its settings.
r Spectrum – CRJ (See page 99, ClockRecoveryJitterSpectrum.)
Standard Name (up to 11 characters; may contain spaces)
Nominal Frequency (150 MHz to 12.5 GHz)
Loop Bandwidth (0.02 MHz to 12 MHz)
king (0.0 dB to 6.0 dB)
Pea
Lock Range (10 MHz to 500 MHz)
Nominal Edge Density (10.0% to 100%)
BERTScope Remote Control Guide79
Clock Recovery Option
Standard
FBDIMM1
3.2
FBDIMM1
4.0
FBDIMM1
4.8
FBDIMM2
4.8
FBDIMM2
6.4
FBDIMM2
8.0
FBDIMM2
9.6
FC1X
FC2X
FC4X
FC8X
GbE1
GbE10
OC12
OC48
OC192
OIF CEI
6G+
OIF CEI
1G+
1
CIe-1(2.5)
P
PCIe-1(10.0)
PCIe-2(6.0)
PCIe-2(10.0)
PCIe-3(2.5)
PCIe-3(4.5)
SATA1(0.9)
SATA1(1.98)
SATA1(6.0)
SATA2(1.8)
SATA2(1.98)
Nominal
Frequency
HertzHertzdBHertzPercent
3.20000E+091.10000E+0715.00E+0750
4.00000E+091.10000E+0715.00E+0750
4.80000E+091.10000E+0715.00E+0750
4.80000E+091.10000E+0715.00E+0750
6.40000E+
8.00000E+
9.60000E
E+09
1.06250
E+09
2.12500
0E+09
4.2500
0E+09
8.5000
00E+09
1.250
125E+10
1.03
000E+08
6.22
8800E+09
2.4
5000E+09
9.9
00000E+094.00000E+060.1
6.
1.10000E+108.00000E+060.15.00E+0750
2.50000E+092.50000E+061.55.00E+0750
2.50000E+0910.0000E+062.25.00E+0750
5.00000E+096.00000E+060.55.00E+0750
5.00000E+0910.0000E+062.25.00E+0750
8.00000E+092.50000E+061.55.00E+0750
8.00000E+094.50000E+060.55.00E+0750
1.50000E+099.00000E+052.095.00E+0750
1.50000E+091.98000E+0605.00E+07100
1.50000E+096.00000E+062.095.00E+07100
3.00000E+091.80000E+062.095.00E+0750
3.00000E+091.98000E+0605.00E+07100
Loop
Bandwidth
09
1.10000E+0715.00E+0750
09
1.10000E+0715.00E+0750
+09
1.10000E
6.38000
1.27500
0E+06
2.5500
0E+06
5.1000
00E+05
6.370
000E+06
4.00
000E+05
2.50
0000E+06
1.0
0000E+06
4.0
PeakingLock
Range
+07
15.00E+0750
E+05
0.15.00E+0
E+06
0.15.00E+0
0.15.00E+
0.15.00E+
0.15.00E
0.15.00
0.15.00
0.15.0
0.15.0
5.
00E+07
07
07
+07
E+07
E+07
0E+07
0E+07
Nominal
Edge
Density
7
50
7
50
50
50
50
50
50
50
50
50
80BERTScope Remote Control Guide
Clock recovery command summary
SATA2(6.0)
XAUI3.12500E+091.87500E+06 0.15.00E+0750
XFP/XFI
RX
XFP/XFI
TX
3.00000E+096.00000E+062.095.00E+07100
9.95000E+098.00000E+060.15.00E+0750
9.95000E+094.00000E+060.15.00E+0750
Clock recovery command summary
Complete command listing (See page 7, Command listing.)
TOTALDEVCOUNT or TDCT
ATTA C H
ATTACHDEVNAMES or NAMES
OPEN
DEVCOUNT or ADCT
Write-Only Operations
Static Read-Only
Identification and
Capabilities
CLOSE
CRControl Commands (requires prior OPEN)
SERIALNUM or SN
DEVICENAME or DN
SWREV or SW
EV or HW
HWR
FPGAREV or FPGA
EXPREV or EXP
STANDARDLIST or STANDARDS
SUBCLOCKDIVLIST or SUBDIVS
BERTScope Remote Control Guide81
Clock recovery command summary
Dynamic Read-Only
Properties
Read-Write Settings
CONNECTED or CO
BUSY
LOCKSTATE or LOCKST
LOCKCOUNT or LOCKCT
DATARATE
DUTYCYCLEDISTORTION or DCD
EDGEDENSIT
MAXLBW or MAXCALLOOPBWIDTH
MINLBW or MINCALLOOPBWIDTH
PHASEERRP2P or PHERR
PHASEERRRMS or PHERMS
STANDARD
NOMFREQUENCY or NOMFREQ
LOCKRANGE or RANGE
LOOPBANDWIDTH or LOOPBW
PEAKING
LOCKMO
EDGEDENSITYMODE or EDGEDMODE
NOMEDGEDENSITY or NOMEDGED
PHASEERRLIMIT or PHERRLMT
CLOCKOUTPUT or CLKOUT
CLOCKAMPLITUDE or CLKAMPL
SUBC
SUBCLOCKAMPLITUDE or SUBAMPL
SUBCLOCKDIV or SUBDIV
AUTOSCONFIGDEVICE or AUTOSDEV
DE
LOCKOUTPUT or SUBOUT
NN
YorEDGED
LOCK or LOCK
Write-Only Operations
82BERTScope Remote Control Guide
RE
RESETLOCKCOUNT or RESETLOCKCT
SCONFIGDISK or SDISK
RCONFIGDISK or RDISK
RCONFIGURATION or RCONFIG
SCONFIGDEVICE or SDEV
SCONFIGURATION or SCONFIG
RCONFIGDEVICE or RDEV
CREATESTANDARD
DELETESTANDARD
AVGCOUNT or AVGC
NUMSCANS or SCANS
NUMHISTOGRAMS or HISTOS
HISTOGRAMPOINTS or HISTOPTS
DEVMIN_PPM or DEVMIN
DEVM
DEVMAX_PPM or DEVMAX
DEVMAX_HZ
MAXDER
MODFREQ
NOMFREQ
IN_HZ
eCommandsClockRecoveryLoopResponse(Seepage94,
ELTA
BERTScope Remote Control Guide83
CRService : Clock Recovery Service
CRService : Cl
ock Recovery Service
Complete com
CRService:AttachDevCounT?
Retrieves the number of unique BERTScope CRs (unique serial numbers) that are
currently communicating with the Clock Recovery Service, whether or not the
remote com
Returns:<numeric>
CRService:attachdevNAMES?
Retrieves a comma-separated list of all BERTScope CRs currently communicating
with the Clock Recovery Service, whether or not the remote computer has
OPENed a
Each BERTScope CR is identified by its user-assignable device name.
Returns:<"string">
CRSer
vice:CLOSE
mand listing (See page 7, Command listing.)
puter has OPENed a session to any of them. Query only.
Number of CRs found
session to any of them. Query only.
Comma-separated list of BERTScope CRs found, or
“” if none
Close the communication connection to the current BERTScope CR. Action only.
Note that closing the current BERTScope CR requires that a new current
BERTScope CR be selected (or opened) prior to issuing any more device-specific
The user-assigned device name or serial number string may be passed to select
a particular BERTScope CR. An empty string may be passed to select the first
usually only) BERTScope CR found. A B ERTScope CR can be opened by
(
multiple clients.
Params:<"string">
Returns:<"string">
Serial number, device name, or
Current device name, or
“NONE”
“” if none
84BERTScope Remote Control Guide
CRControl : Clock Recovery Control
CRService:Tot
alDevCounT?
Retrieves the total number of unique BERTScope CRs (unique serial numbers)
that the Clock
Recovery Service has encountered since last restarted. Query only.
NOTE. This number may include devices that are no longer connected to the host
computer, or are powered off.
Returns:<numeric>
Number of CRs encountered
CRControl : Clock Recovery Control
Complete command listing (See page 7, Command listing.)
Sets or retrieves whether the clock output is enabled.
Params:<bool>0 or 1
Returns:
<0>
<1>
Clock output disabled
Clock output enabled
BERTScope Remote Control Guide85
CRControl : Clock Recovery Control
CRControl:CLo
cKAMPLitude <numeric>
CRControl:CLocKAMPLitude?
Sets or retrie
Params:<numeric>Range [250 mV to 900 mV]
Returns:<numeric>
ves the clock output amplitude in mV.
Current clock output amplitude in mV
CRControl:CONNected?
Retrieves the connection status of the currently selected BERTScope CR. Query
only.
Returns:
<0>
<1>
Device is opened, but not found by the host computer
Device is opened and available for communication
CRControl:CREATESTANDARD <"string">
Saves a new Clock Recovery Standard to the non-volatile memory of
the BERTScope CR, using the current settings for NOMFREQUENCY,
LOCKRANGE, LOOPBANDWIDTH, PEAKING, and NOMEDGEDENSITY.
Action only.
NOTE. The Standard name parameter is case-sensitive, and may contain space
acters.
char
Params:<"string">
ontrol:DATARATE?
CRC
Name of the Standard to select
Retrieves the measured data rate in Hertz. Query only.
Returns:<numeric>Measured data rate in Hz
86BERTScope Remote Control Guide
CRControl : Clock Recovery Control
CRControl:DEL
ETESTANDARD <"string">
Removes a Clock Recovery Standard from the BERTScope CR’s non-volatile
memory. Actio
nonly.
NOTE. The Standard name parameter is case-sensitive, and may contain space
characters.
NOTE. The factory-supplied Standards are treated no differently than user-created
Standards, and can be deleted. If accidentally deleted, a Standard can be
manually r
e-created by pre-setting the desired values for NOMFREQUENCY,
LOCKRANGE, LOOPBANDWIDTH, PEAKING, and NOMEDGEDENSITY, then
sending CRC:CREATESTANDARD with the desired Standard name.
Params:<"string">
Name of the Standard to delete
CRControl:DeviceName <"string">
CRCont
rol:DeviceName?
Changes or retrieves the device name of t he currently selected BERTScope CR. A
e name can be from 1 to 11 characters in length. Note that the BERTScope
devic
CR device name is saved in non-volatile memory.
Params:<"string">New device name
Returns:<"string">
Device name of current device
CRControl:DutyCycleDistortion?
Retrieves the Duty Cycle Distortion measurement in % Unit Interval. Query only.
Note: The DCD measurement is only valid for the period of acquisition, so a new
“CRC:MDCD” should be called prior to each “CRC:DCD?” query.
Returns:<numeric>
DCD measurement in %UI
CRControl:EDGEDensity?
Retrieves the measured edge density in percent. Query only.
Returns:<numeric>
Measured edge density in %
BERTScope Remote Control Guide87
CRControl : Clock Recovery Control
CRControl:EDG
EDensityMODE <enum>
CRControl:EDGEDENSITYMODE?
Sets or retrie
Params:
Returns:
ves the edge density mode.
<NOMINAL>Use NOMEDGEDENSITY setting
<ON_LOCK>Use edge density found when first locked
< NOMINAL | ON_LOCK >
CRControl:EQUALization <numeric>
CRControl
: EQUALization?
Sets or retrieves the equalization value. BERTScope Si 25000C only.
Params:<numeric>Range [0 to 10]
Returns:<numeric>
Current setting
CRControl:EXPrev?
Retrieves the expansion board revision string of the currently selected BERTScope
CR. Query only.
Note that if no expansion board is installed in the BERTScope CR, then
Sets or retrieves the the phase error limit in percent unit interval.
Params:<numeric>
Returns:<numeric>
Range is 10 %UI to 90 %UI
Current setting in %UI
90BERTScope Remote Control Guide
CRControl : Clock Recovery Control
CRControl:PHA
SEERRP2P?
Retrieves the phase error peak-to-peak measurement in percent unit interval.
Query only.
Returns:<numeric>
Control:PHASEERRRMS?
CR
Retrieves the phase error RMS measurement in percent unit intervals. Query only.
Returns:<numeric>
CRControl:RconfigDEVice <enum>
Restores BERTScope CR setti
ngs from a non-volatile Setup location in the
BERTScope CR. Action only.
Params:
<POWER_ON>Configuration used at power-on
<SETUP_1>
<SETUP_2>
<SETUP_3>
<SETUP_4>
<FACTORY>Restore to the “factory default” configuration
CRControl:RconfigDISK <"string">
Restores BERTScope CR settings from a file. The complete path must be specified
in the parameter string. The path must be accessible to the host computer or
BERTScope CR running the remote control software. Use the file extension “.cru”
and enclose the path name in quotes. Action only.
Example:
Params:<“string.cru”>
CRC:RDISK “D:\BitAlyzer\Configu
Path name of the configuration file
rations\mycfg.cru”
CRControl:reLOCK
Initiates a search for the data rate. Action only.
.
NOTE. This command may take some time to complete. An application program
would typically call this, then repeatedly query LOCKSTATE until lock is achieved.
CRControl:RESETLOCKCounT
Resets the lock count to zero. Action only.
BERTScope Remote Control Guide91
CRControl : Clock Recovery Control
CRControl:Sco
nfigDEVice <enum>
Saves the current BERTScope CR settings to a non-volatile Setup location in the
BERTScope CR.
Params:
Action only.
<POWER_ON>Configuration used at power-on
<SETUP_1>
<SETUP_2>
<SETUP_3>
<SETUP_4>
CRControl:SconfigDISK <"string">
Saves the current BERTScope CR settings to a file. The complete path must be
specified in the parameter string. The path must be accessible to the host computer
or BERTS
cope running the remote control software. Use the file extension “.cru”
and enclose the path name in quotes. Action only.
e:
Exampl
Params:<“string.cru”>
CRC:SDISK “D:\BitAlyzer\Configurations\mycfg.cru”
Path name of the configuration file
CRControl:SerialNum?
Retrieves the serial number string of the currently selected BERTScope CR.
Query only.
Returns:<"string">
Serial number string of current device.
CRControl:STANDARD <"string">
CRControl:STANDARD?
Changes or retrieves the name of the Clock Recovery Standard. Selecting a new
Standard will change the BERTScope CR’s settings for NOMFREQUENCY,
OCKRANGE, LOOPBANDWIDTH, PEAKING, and NOMEDGEDENSITY.
L
NOTE. The Standard name parameter is case-sensitive, and may contain space
characters.
Params:<"string">
Returns:<"string">
Name of the Standard to select
Currently selected Standard, or “None”
92BERTScope Remote Control Guide
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.