Tektronix TSO8 Series Sampling Oscilloscop User Manual

This programmer manual provides information on using SCPI
programmatic commands to remotely control a Tektronix TSO820
Sampling Oscilloscope through LAN connection.

Syntax and Commands

This section provides an overview of the command syntax used to
communicate with the instrument. It includes information on
constructing commands and queries, entering commands, mnemonics,
and argument types.

Commands

This section lists all commands, related arguments, returns, and
examples. Commands are categorized by group for easier
reference.

Status and Events

This section covers the status and event reporting system for
GPIB interfaces. It includes information on registers, queues,
event handling sequences, synchronization methods, and messages
returned by the instrument, including error messages.

FAQ

Q: How can I remotely control the instrument using PI
commands?

A: To remotely control the instrument using PI commands, ensure
you are connected via LAN and follow the command syntax provided in
the manual.

Q: What should I do if I encounter error messages while using
the instrument?

A: Refer to the Messages section in the manual to understand the
error messages and troubleshoot accordingly.

Q: Can I write computer programs to perform functions similar
to the User Interface?

A: Yes, with the information provided in this manual, you can
write computer programs to perform virtually all functions
available through the User Interface.

“`

View Fullscreen

8 Series Sampling Oscilloscope

Programmer Manual
ZZZ

This document supports TSOVu software release v1.4
www.tek.com
077-1609-03

Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected 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 previously published material. Specifications and price change privileges reserved.
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
TekVISA is a trademark of Tektronix, Inc.
Contacting Tektronix
Tektronix, Inc. 14150 SW Karl Braun Drive P.O. Box 500 Beaverton, OR 97077 USA
For product information, sales, service, and technical support: In North America, call 1-800-833-9200. Worldwide, visit www.tek.com to find contacts in your area.

Table of Contents
Preface ……………………………………………………………………………………………….. iii
Getting Started
Getting Started ………………………………………………………………………………………. 1-1
Syntax and Commands
Command syntax ……………………………………………………………………………………. 2-1 Command and Query structure ………………………………………………………………….. 2-1 Clearing the Instrument …………………………………………………………………………. 2-3 Command entry …………………………………………………………………………………. 2-4 Constructed mnemonics…………………………………………………………………………. 2-6 Argument types …………………………………………………………………………………. 2-7
Command Groups and Descriptions……………………………………………………………….. 2-11
Status and Events
Status and Events ……………………………………………………………………………………. 3-1 Synchronization Methods ……………………………………………………………………….. 3-2 Messages………………………………………………………………………………………… 3-7
Commands Index …………………………………………………………………………………………………………………… 126

TSO8 Series Programmer Manual

Table of Contents

TSO8 Series Programmer Manual

Preface

This programmer manual provides you with the information required to use SCPI programmatic commands (PI) to remotely control a Tektronix TSO820 Sampling Oscilloscope through LAN connection.

TSO8 Series Programmer Manual

iii

Preface

TSO8 Series Programmer Manual

Getting Started
This programmer manual provides you with the information required to use PI commands to remotely control your instrument. With this information, you can write computer programs that will perform virtually all the same functions as provided by the User Interface.
The programmer manual is divided into the following major sections:
Syntax and Commands. This section provides an overview of the command syntax used to communicate with the instrument and other general information about commands, such as how commands and queries are constructed, how to enter commands, constructed mnemonics, and argument types.
Commands. This section contains all the commands and related arguments, returns, and examples. Commands are listed by group.
Status and Events. This section discusses the status and event reporting system for the GPIB interfaces. This system informs you of certain significant events that occur within the instrument. Topics discussed include registers, queues, event handling sequences, synchronization methods, and messages that the instrument may return, including error messages.

TSO8 Series Programmer Manual

1-1

Getting Started

1-2

TSO8 Series Programmer Manual

Command syntax
You can control the operations and functions of the instrument through the LAN interface using commands and queries. The related topics listed below describe the syntax of these commands and queries. The topics also describe the conventions that the instrument uses to process them. See the Command Groups topic in the table of contents for a listing of the commands by command group, or use the index to locate a specific command.

Backus-Naur Form This documentation describes the commands and queries using Backus-Naur Notation Form (BNF) notation. Refer to the following table for the symbols that are used.

Table 2-1: Symbols for Backus-Naur Form

Symbol <> ::= | {} [] .. . ()

Meaning Defined element Is defined as Exclusive OR Group; one element is required Optional; can be omitted Previous element(s) may be repeated Comment

Command and Query structure
Commands consist of set commands and query commands (usually called commands and queries). Commands modify instrument settings or tell the instrument to perform a specific action. Queries cause the instrument to return data and status information.
Most commands have both a set form and a query form. The query form of the command differs from the set form by its question mark on the end. For example, the set command ACQuire:MODe has a query form ACQuire:MODe?. Not all commands have both a set and a query form. Some commands have set only and some have query only.

Messages

A command message is a command or query name followed by any information the instrument needs to execute the command or query. Command messages may contain five element types, defined in the following table.

TSO8 Series Programmer Manual

2-1

Command syntax

Table 2-2: Command Message Elements

Symbol <Header>
<Mnemonic> <Argument>
<Comma> <Space>

Meaning
This is the basic command name. If the header ends with a question mark, the command is a query. The header may begin with a colon (:) character. If the command is concatenated with other commands, the beginning colon is required. Never use the beginning colon with command headers beginning with a star (*).
This is a header subfunction. Some command headers have only one mnemonic. If a command header has multiple mnemonics, a colon (:) character always separates them from each other.
This is a quantity, quality, restriction, or limit associated with the header. Some commands have no arguments while others have multiple arguments. A <space> separates arguments from the header. A <comma> separates arguments from each other.
A single comma is used between arguments of multiple-argument commands. Optionally, there may be white space characters before and after the comma.
A white space character is used between a command header and the related argument. Optionally, a white space may consist of multiple white space characters.

Commands

Commands cause the instrument to perform a specific function or change one of the settings. Commands have the structure:
[:]<Header>[<Space><Argument>[<Comma> <Argument>]…] A command header consists of one or more mnemonics arranged in a hierarchical or tree structure. The first mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off the previous one. Commands at a higher level in the tree may affect those at a lower level. The leading colon (:) always returns you to the base of the command tree.

2-2

TSO8 Series Programmer Manual

Command syntax

Queries

Queries cause the instrument to return status or setting information. Queries have the structure:
[:]<Header>?
[:]<Header>?[<Space><Argument> [<Coma><Argument>]…] You can specify a query command at any level within the command tree unless otherwise noted. These branch queries return information about all the mnemonics below the specified branch or level. For example, HIStogram:STATistics:STDdev? returns the standard deviation of the histogram, while HIStogram:STATistics? returns all the histogram statistics, and HIStogram? returns all the histogram parameters.

Headers

You can control whether the instrument returns headers as part of the query response. Use the HEADer command to control this feature. If header is on, the query response returns command headers, then formats itself as a valid set command. When header is off, the response includes only the values. This may make it easier to parse and extract the information from the response. The table below shows the difference in responses.

Table 2-3: Comparison of Header Off and Header On Responses

Query TIME? ACQuire:NUMAVg?

Header Off “14:30:00″ 100

Header On :TIME”14:30:00” :ACQUIRE:NUMAVG 100

Clearing the Instrument
You can clear the Output Queue and reset TSOVu to accept a new command or query by using the selected Device Clear (DCL) GPIB function. Refer to your GPIB library documentation for further details about the selected Device Clear operation.

TSO8 Series Programmer Manual

2-3

Command syntax

Command entry

The following rules apply when entering commands:
You can enter commands in upper or lower case.
You can precede any command with white space characters. White space characters include any combination of the ASCII control characters 00 through 09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal).
The instrument ignores commands consisting of any combination of white space characters and line feeds.

Abbreviating

You can abbreviate many instrument commands. Each command in this documentation shows the abbreviations in capitals. For example, you can enter the command ACQuire:NUMAvg simply as ACQ:NUMAVG or acq:numavg.
Abbreviation rules may change over time as new instrument models are introduced. Thus, for the most robust code, use the full spelling.
If you use the HEADer command to have command headers included as part of query responses, you can further control whether the returned headers are abbreviated or are full-length with the VERBose command.

Concatenating

You can concatenate any combination of set commands and queries using a semicolon (;). The instrument executes concatenated commands in the order received.

2-4

TSO8 Series Programmer Manual

Command syntax
When concatenating commands and queries, you must follow these rules:
Separate completely different headers by a semicolon and by the beginning colon on all commands except the first one. For example, the commands TRIGger:SOUrce FREerun and ACQuire:NUMAVg 10, can be concatenated into the following single command:
TRIGger:SOUrce FREerun;:ACQuire:NUMAVg 10
If concatenated commands have headers that differ by only the last mnemonic, you can abbreviate the second command and eliminate the beginning colon. For example, you can concatenate the commands ACQuire:MODe AVERage and ACQuire:NUMAVg 10 into a single command:
ACQuire:MODe AVERage; NUMAVg 10
The longer version works equally well:
ACQuire:MODe AVERage;:ACQuire:NUMAVg 10
Never precede a star (*) command with a colon:
ACQuire:MODe AVERage;*OPC
Any commands that follow will be processed as if the star command was not there so the commands, ACQuire:MODe AVERage;*OPC;NUMAVg 10 will set the acquisition mode to envelope and set the number of acquisitions for averaging to 10.
When you concatenate queries, the responses to all the queries are concatenated into a single response message. For example, if the Acquire mode is set to sample and state is set to on, the concatenated query :ACQuire:MODe?;STATE? will return the following.
If the header is on:
:ACQuire:MODe SAMple :ACQuire:STATE ON
If the header is off:
SAMple;ON
Set commands and queries may be concatenated in the same message. For example,
ACQuire:MODe SAMple;NUMAVg?;STATE?
is a valid message that sets the acquisition mode to sample. The message then queries the number of acquisitions for averaging and the acquisition state. Concatenated commands and queries are executed in the order received.
Here are some invalid concatenations:
DISplay:MODE TILE;ACQuire:NUMAVg 10 (no colon before ACQuire)

TSO8 Series Programmer Manual

2-5

Command syntax

DISPLAY:REF1 1 1;:REF2 0 (extra colon before REF2; use DISPLAY:REF1 1;REF2 0 instead)
DISplay:MODE TILE;:*OPC (colon before a star (*) command)
CURSOR:VIEW1:VBARS:POSITION1 21E-9;VBARS:POSITION2 3.45E-6
(levels of the mnemonics are different; either remove the second use of VBARS or place :CURSOR:VIEW1: in front of VBARS:POSITION2 3.45E-6)

Terminating

This documentation uses <EOM> (End of message) to represent a message terminator.

Table 2-4: End of Message Terminator

Symbol <EOM>

Meaning Message terminator

The end-of-message terminator must be the END message (EOI asserted concurrently with the last data byte). The last data byte may be an ASCII linefeed (LF) character.
This instrument does not support ASCII LF only message termination. The instrument always terminates outgoing messages with LF and EOI. It allows white space before the terminator. For example, CR LF.

Constructed mnemonics
Some header mnemonics specify one of a range of mnemonics. A channel mnemonic has to be M<n>{A|B}, where <n> is the module number and {A|B} is the channel name of the module. You use these mnemonics in the command just as you do any other mnemonic. For example, there is a M1A:POSITION command, and there is also a M1B:POSITION command.

Cursor Position Mnemonics

When cursors are displayed, commands may specify which cursor of the pair to use.

Table 2-5: Cursor Mnemonics

Symbol CURSOR<n> POSITION<n> HPOS<n>

Meaning A cursor selector; <n> is either 1 or 2. A cursor selector; <n> is either 1 or 2. A cursor selector; <n> is either 1 or 2.

Measurement specifier mnemonics

Commands can specify which measurement to set or query as a mnemonic in the header. Up to 32 automated measurements may be displayed in the system. The displayed measurements are specified in this way:

2-6

TSO8 Series Programmer Manual

Command syntax

Table 2-6: Measurement specifier mnemonics

Symbol MEAS<n> SOURCE<n>
REFLevel<n>
GATE<n>

Meaning
A measurement specifier; <n> is 1 through 32. A waveform specifier; <n> is either 1 (Source 1 waveform) or 2 (Source 2 waveform).
A waveform specifier for reference level measurements; <n> is either 1 (Source 1 waveform) or 2 (Source 2 waveform).
A gate specifier; <n> is either 1 (Gate 1) or 2 (Gate 2).

Channel mnemonics Commands specify the channel to use as a mnemonic in the header.

Table 2-7: Channel mnemonics

Symbol M<n>{A|B}

Meaning A channel specifier; <n> is 1 to 4.

Reference waveform Commands can specify the reference waveform to use as a mnemonic in the mnemonics header.

Table 2-8: Reference waveform mnemonics

Symbol REF<n>

Meaning A reference waveform specifier; <n> is 1 through 8.

Argument types
Numeric

Many instrument commands require numeric arguments. The syntax shows the format that the instrument returns in response to a query. This is also the preferred format when sending the command to the instrument though any of the formats will be accepted. This documentation represents these arguments as follows:

Table 2-9: Numeric arguments

Symbol <NR1> <NR2> <NR3>

Meaning Signed integer value Floating point value without an exponent Floating point value with an exponent

Most numeric arguments will be automatically forced to a valid setting, either by rounding or truncating, when an invalid number is input unless otherwise noted in the command description.

TSO8 Series Programmer Manual

2-7

Command syntax

Quoted String

Some commands accept or return data in the form of a quoted string, which is simply a group of ASCII characters enclosed by a single quote (‘) or double quote (“). The following is an example of a quoted string: “This is a quoted string”. This documentation represents these arguments as follows:

Table 2-10: Quoted String Argument

Symbol <QString>

Meaning Quoted string of ASCII text

A quoted string can include any character defined in the 7-bit ASCII character set. Follow these rules when you use quoted strings:
1. Use the same type of quote character to open and close the string. For example: “this is a valid string”.
2. You can mix quotation marks within a string as long as you follow the previous rule. For example, “this is an ‘acceptable’ string”.
3. You can include a quote character within a string by repeating the quote. For example: “here is a “” mark”.
4. Strings can have upper or lower case characters.
5. If you use a GPIB network, you cannot terminate a quoted string with the END message before the closing delimiter.
6. A carriage return or line feed embedded in a quoted string does not terminate the string, but is treated as just another character in the string.
7. The maximum length of a quoted string returned from a query is 1000 characters.
Here are some invalid strings:
“Invalid string argument’ (quotes are not of the same type)
“test<EOI>” (termination character is embedded in the string)

Block Several instrument commands use a block argument form (see the following table).

Table 2-11: Block Argument

Symbol <NZDig> <Dig> <DChar>
<Block>

Meaning
A nonzero digit character in the range of 19
A digit character, in the range of 09
A character with the hexadecimal equivalent of 00 through FF (0 through 255 decimal)
A block of data bytes defined as: <Block> ::= {#<NZDig><Dig>[<Dig>…][<DChar>…] |#0[<DChar>…]<terminator>}

2-8

TSO8 Series Programmer Manual

Command syntax
<NZDig> specifies the number of <Dig> elements that follow. Taken together, the <NZDig> and <Dig> elements form a decimal integer that specifies how many <DChar> elements follow.

TSO8 Series Programmer Manual

2-9

Command syntax

2-10

TSO8 Series Programmer Manual

Command Groups and Descriptions

TSO8 Series Programmer Manual

2-11

Acquisition Command Group
Use the commands in the Acquisition Command Group to set up the modes and functions that control how the instrument acquires the signals you input to the channels and processes them into waveforms.
Using these commands for acquiring waveforms, you can do the following: · Start and stop acquisitions. · Control whether all waveforms are simply acquired and averaged. · Set the controls or conditions that start and stop acquisitions. · Get data on acquired waveforms and histograms. · Get acquisition parameters. · Clear all acquired data.

ACQuire:STOPAfter:CONDition 1. ACQWfms

ACQuire: STOPAfter: COUNT

2. AVGComp
ACQuire:RAAFter (EACQuisition | STOP | COUNt)
1. EACQuisition 2. STOP 3. COUNt ACQuire:RAAFter:COUNt <NR3> ACQuire:STATE { OFF | ON | RUN | STOP | <NR1> }*
ACQuire:MODe { SAMple | AVERage }

ACQuire:NUMAVg Sets/queries the “run analysis after” state of the instrument.
Sets/queries periodicity at which analysis occurs RUN/STOP button on the right side of TSOVu
Acquisition Mode in “Acquisition Menu”

1. SAMple

2. AVERage ACQuire:CURRentcount:ACQWfms ACQuire:DATA:CLEar

ACQuire:NUMAVg
smaller than Stop After Count
Clear acquisition data, but not setup

TSO8 Series Programmer Manual

ACQuire:MODe
Description This command sets or queries the acquisition mode of the instrument, which determines how the final value of the acquisition interval is generated from the many data samples. The instrument applies the specified mode globally to all channel waveforms that it acquires. The three, mutually exclusive acquisition modes are:
· Sample: Use Sample mode to see the signal in its purest form with no post processing. This is the default mode.
· Average: Use Average mode to reduce the apparent noise in the signal to reveal fundamental waveform behavior.
Syntax ACQuire:MODe { SAMple | AVERage } ACQuire:MODe?
Related Commands ACQuire:NUMAVg
Arguments · SAMple specifies sample mode, in which the displayed data point value is simply the sampled value that was taken during the acquisition interval. There is no post processing of acquired samples; the instrument overwrites waveforms at each new acquisition cycle. SAMple is the default acquisition mode. · AVERage specifies averaging mode, in which the resulting waveform shows an average of SAMple data points from several consecutive waveform acquisitions. The instrument processes the number of waveforms you specify into the acquired waveform, creating a running back-weighted exponential average of the input signal. The number of waveform acquisitions that go into making up the average waveform is set or queried using the ACQuire:NUMAVg command.
Returns ACQUIRE:MODE? might return ACQUIRE:MODE AVERAGE, indicating that the displayed waveform is the average of the specified number of waveform acquisitions.
Examples ACQUIRE:MODE AVERage sets the acquisition mode to display a waveform that is an average of SAMple data points from several consecutive waveform acquisitions.
ACQuire:RAAFter
Description This command sets or queries the run analysis after state of the instrument. Analysis includes:
Measurements Histograms Mask tests
Syntax ACQuire:RAAFter { EACQuisition | STOP | COUNt } ACQuire:RAAFter?
Arguments · EACQuistion shall set the analysis to be run on every acquisition · STOP shall set the analysis to be run on acquisition stop

TSO8 Series Programmer Manual

· COUNT shall set the analysis to be run periodically as determined by the count specified
Related Commands ACQuire:RAAFter:COUNt
Returns The current run analysis mode (EACQuisition, STOP, COUNT).
Examples ACQUIRE:RAAFTER COUNT sets the analysis to be run after a specific number of acquisitions. ACQUIRE:RAAFTER? may return EACQUISITION, indicating that analysis runs after every acquisition.
ACQuire:RAAFter:COUNt
Description This command sets or queries the run analysis count parameter of the acquisition to indicate the periodicity at which analysis occurs.
Syntax ACQuire:RAAFter:COUNt <NR3> ACQuire:RAAFter:COUNt?
Arguments <NR3> indicates the periodicity of the analysis with respect to acquisitions.
Related Commands ACQuire:RAAFter
Returns <NR3> indicating the periodicity of the analysis with respect to acquisitions.
Examples ACQUIRE:RAAFTER:COUNT 23 sets the analysis to be run for 23 acquisitions. ACQUIRE:RAAFTER? may return 11, indicating that analysis will run for 11 acquisitions.
Further information If acquisition stop on condition is set to 53 and analysis count periodicity is set to 5, then 11 analyses will run, provided measurements have been added before acquisitions have started.
ACQuire:STATE
Description This command starts or stops acquisitions or queries whether the acquisition is running or stopped.
Syntax ACQuire:STATE { OFF | ON | RUN | STOP | 1 | 0 } ACQuire:STATE?
Arguments · OFF stops acquisitions. · STOP stops acquisitions. · ON starts acquisitions. · RUN starts acquisitions.

TSO8 Series Programmer Manual

· 0 stops acquisitions. · 1 starts acquisitions.
Returns ACQUIRE:STATE? might return ACQUIRE:STATE 1, indicating that the acquisition system is running.
Examples ACQUIRE:STATE RUN starts acquisition of waveform data.
ACQuire:CURRentcount:ACQWfms?
Description This query only command returns the current count value of acquired waveforms. The target value of this count is set by the ACQuire:STOPAfter:COUNt command (in conjunction with the ACQuire:STOPAfter:CONDition command). The instrument then counts up to this value. When the count reaches (or exceeds) the value, acquisition stops, and the specified StopAfter action is enabled.
Syntax ACQuire:CURRentcount:ACQWfms?
Related Commands · ACQuire:STOPAfter:COUNt · ACQuire:STOPAfter:CONDition
Arguments Query only command has no arguments.
Returns NR1 is the current count value of acquired waveforms.
Examples ACQUIRE:CURRENTCOUNT:ACQWFMS? might return ACQUIRE:CURRENTCOUNT:ACQWFMS 20, indicating that currently 20 waveforms have been acquired.
ACQuire:STOPAfter:MODe
Description This command tells the instrument when to stop taking acquisitions. The query form of this command returns the StopAfter mode. Syntax ACQuire:STOPAfter:MODe { RUNSTop | CONDition } ACQuire:STOPAfter:MODe?
Related Commands ACQuire:STOPAfter:CONDition ACQuire:STATE
Arguments · RUNSTop specifies that the run and stop state is determined by the RUN/STOP button of the application. · CONDition specifies that the run and stop state of the system is determined by a set a qualifiers specified by the StopAfter Condition. These sub-states are further described in the ACQuire:STOPAfter:CONDition section. (The instrument can still be stopped unconditionally by pressing the RUN/STOP button of the application or by sending the ACQuire:STATEcommand.)

TSO8 Series Programmer Manual

Examples · ACQUIRE:STOPAFTER:MODE RUNSTOP sets the instrument to run or stop acquisitions when the user presses the RUN/STOP button of the application or the user sends the ACQuire:STATE command. · ACQUIRE:STOPAFTER:MODE? might return ACQUIRE:STOPAFTER:MODE CONDITION, indicating that the run and stop state of the system is determined by a set of qualifiers specified by the StopAfter condition.
ACQuire:STOPAfter:CONDition
Description This command sets or queries the StopAfter condition. The StopAfter condition qualifies a stop condition for the acquisition system. Only one StopAfter condition can be active at a given time. Each StopAfter condition identifies, directly or indirectly, a specific data element or operation such that all mutually exclusive conditions are unique and unambiguous. This command allows you to specify the condition on which to stop acquiring. The condition is valid when the ACQuire:STOPAfter:MODE is set to CONDition.
Syntax ACQuire:STOPAfter:CONDition { ACQWfms | AVGComp } ACQuire:STOPAfter:CONDition?
Related Commands ACQuire:STOPAfter:COUNt ACQuire:NUMAVg
Arguments · ACQWfms sets the instrument to stop acquiring after some specified number of raw acquisition cycles. This setting tells the instrument to count the number of MainTime base sweeps (Mag sweeps are not counted independently) and stop acquisition after the specified number of acquisitions has been reached. Use the ACQuire:STOPAfter:COUNt command to set the target number of waveforms. · AVGComp sets the instrument to stop acquisition after the number of waveforms specified by the ACQuire:NUMAVg command have been acquired and averaged.
Examples ACQUIRE:STOPAFTER:CONDITION ACQWFMS sets the instrument to stop acquiring after some specified number of raw acquisition cycles. ACQUIRE:STOPAFTER:CONDITION? might return ACQUIRE:STOPAFTER:CONDITION ACQWFMS
ACQuire:STOPAfter:COUNt
Description This command sets or queries the target StopAfter count for the condition specified by the ACQuire:STOPAfter:CONDition command. The current count for the condition must be equal to or greater than this value before acquisitions are stopped and a StopAfter action is enabled. The state of the numeric StopAfter count for each condition is kept individually so that you do not need to re-enter a count when switching between conditions. Use the appropriate ACQuire:CURRentcount command to get the current count for a condition.
Syntax ACQuire:STOPAfter:COUNt <NR1> ACQuire:STOPAfter:COUNt?

TSO8 Series Programmer Manual

Related Commands ACQuire:STOPAfter:MODe ACQuire:STOPAfter:CONDition ACQuire:CURRentcount:ACQWfms?
Arguments NR1 is the count value that must be reached (or exceeded) before the acquisitions stop and StopAfter action can occur.
Examples · ACQUIRE:STOPAFTER:COUNT 12 sets the StopAfter count for the specified condition to 12. · ACQUIRE:STOPAFTER:COUNT? might return ACQuire:STOPAfter:COUNt 5, indicating that the total count for the specified condition is 5.
ACQuire:NUMAVg
Description This command sets or queries the number of waveform acquisitions that makeup an averaged waveform. Use the ACQuire:MODe command to enable the Average mode.
Syntax ACQuire:NUMAVg <NR1> ACQuire:NUMAVg?
Related Commands ACQuire:MODe
ACQuire:STOPAfter:CONDition
Arguments NR1 is the number of consecutive waveform acquisitions (from 2 to 4,096) used for averaging.
Examples · ACQUIRE:NUMAVG 10 specifies that an averaged waveform will show the result of combining 10 separately acquired waveforms. · ACQUIRE:NUMAVG? might return ACQUIRE:NUMAVG 75, indicating that there are 75 acquisitions specified for averaging.
ACQuire:DATa:CLEar
Description This command (no query form) causes an acquisition reset and clears all acquired data and clears the display. When a clear data occurs, it has the following effects:
· When Acquisition is Running the current waveform data is replaced by the waveform data of the next acquisition cycle when it is available.
· Counts. Resets all counts, including number of acquired waveforms, acquisition and average counts, conditional stop counts.
· Measurement statistics. Measurement statistics are reset. · Histogram data and statistics. The data and all statistics will be cleared immediately.
Syntax ACQuire:DATa:CLEar
Examples

TSO8 Series Programmer Manual

ACQUIRE:DATA:CLEAR causes an acquisition reset and clears all acquired data.
Compensation Command Group
The compensation commands provide information about the current state of the compensation for the mainframe and all installed module channels, means to invoke compensation functions, and management of compensation storage memory locations.
COMPensate:M[n]{A|B}
Description This command (no query form) compensates the module channel for DC variances. Volatile run-time compensation data for compensated channels are saved into their respective nonvolatile user memories.
Warning: Before proceeding, please save your setup. For Mainframe SPC (Signal Path Compensation): 1. Disconnect or disable signals to mainframe’s Clock Prescale Input. For Module SPC (Signal Path Compensation): 1. Leave any trigger/clock signal connected to the mainframe’s Clock Prescale Input. 2. Disconnect or disable signals from sampling modules Inputs. 3. Terminate all unused electrical inputs with a 50 Ohms terminator and cover the unused
optical modules inputs with dust covers.
Syntax COMPensate:M[n]{A|B}
Examples
COMPENSATE:M1A performs the compensation routines for channel A on module 1.
COMPensate:MAInframe
Description This command (no query form) compensates the mainframe for DC variances. Volatile run-time compensation data for compensated mainframes are saved into their respective nonvolatile user memories.
Warning: Before proceeding, please save your setup. For Mainframe SPC (Signal Path Compensation): 2. Disconnect or disable signals to mainframe’s Clock Prescale Input. For Module SPC (Signal Path Compensation): 4. Leave any trigger/clock signal connected to the mainframe’s Clock Prescale Input. 5. Disconnect or disable signals from sampling modules Inputs. 6. Terminate all unused electrical inputs with a 50 Ohms terminator and cover the unused
optical modules inputs with dust covers.
Syntax COMPensate:MAInframe
Examples
COMPENSATE:MAINFRAME performs the compensation routines for channel A on module 1.

TSO8 Series Programmer Manual

COMPensate:DATE:M[n]{A|B}?
Description This is a query only command that returns the date and the time of the current in-use (that is, run-time) compensation data for the module channel.
Syntax COMPensate:DATE:M[n]{A|B}?
Returns <QString> Date and the time of the current in-use compensation data
Examples COMPENSATE:DATE:M1A? might return COMPENSATE:DATE:M1A “10/15/2019 7:55:01 AM”
COMPensate:DATE:MAInframe?
Description This is a query only command that returns the date and the time of the current in-use (that is, run-time) compensation data for the mainframe.
Syntax COMPensate:DATE:MAInframe?
Returns <QString> Date and the time of the current in-use (that is, run-time) compensation data for the mainframe.
Examples COMPENSATE:DATE:MAINFRAME? might return COMPENSATE:DATE:MAINFRAME “12/23/1973 1:13:34 AM”
COMPensate:RESults?
Description This is a query only command that returns an abbreviated status about the results of the last compensation execution. Any result other than PASS generally indicates a failure. For a more detailed message about the results of the last compensation execution, use the COMPensate:RESults:VERBose? query.
Syntax COMPensate:RESults?
Returns <QString>
Examples COMPENSATE:RESULTS? might return COMPENSATE:RESULTS “PASS”, indicating that the compensation was successful.
COMPensate:STATus:M[n]{A|B}?
Description

TSO8 Series Programmer Manual

This is a query only command that returns the current compensation status for the module channel.
Syntax COMPensate:STATus:M[n]{A|B}?
Returns Enum. Possible responses are DEFaults, WARMup, FAIL, PASS, and COMPReq.
Examples COMPENSATE:STATUS:M1A? might return COMPENSATE:STATUS:M1A COMPREQ, indicating that the warm-up period for the instrument has elapsed, but the current compensation temperature delta is greater than desired, or that the specified module has been moved to a different module compartment since last compensated. In either case, the instrument should be compensated again.
COMPensate:STATus:MAInframe?
Description This is a query only command that returns the current compensation status for the mainframe.
Syntax COMPensate:STATus:MAInframe?
Returns Enum. Possible responses are DEFaults, WARMup, FAIL, PASS, and COMPReq.
Examples COMPENSATE:STATUS:MAINFRAME? might return COMPENSATE:STATUS:MAINFRAME PASS, indicating that the current compensation data should allow the instrument to meet operating specifications.
COMPensate:TEMPerature:M[n]{A|B}?
Description This query only command returns the difference (in °C) between the current temperature of the module channel and the associated temperature currently residing in the in-use run-time compensation memory.
Syntax COMPensate:TEMPerature:M[n]{A|B}?
Returns NR3
Examples COMPENSATE:TEMPERATURE:M1A? might return COMPENSATE:TEMPERATURE:M1A 1.5
COMPensate:TEMPerature:MAInframe?
Description This query only command returns the difference (in °C) between the current temperature of the mainframe and the associated temperature currently residing in the in-use run-time compensation memory.
Syntax

TSO8 Series Programmer Manual

COMPensate:TEMPerature:MAInframe?
Returns NR3
Examples COMPENSATE:TEMPERATURE:MAINFRAME? might return COMPENSATE:TEMPERATURE:MAINFRAME 2.7.
Calibration Command Group
The calibration commands provide information about the current state of the calibration for the mainframe and all resident sampling-module channels.
CALibration:TEMPerature:MAInframe?
Description This query only command returns the difference (in °C) between the current temperature of the mainframe and the associated temperature currently residing in the in-use run-time calibration memory.
Syntax CALibration:TEMPerature:MAInframe?
Returns NR3
Examples CALiBRATION:TEMPERATURE:MAINFRAME? might return CALiBRATION:TEMPERATURE:MAINFRAME 2.7.
CALibration:TEMPerature:M[n]{A|B}?
Description This query only command returns the difference (in °C) between the current temperature of the module channel and the associated temperature currently residing in the in-use run-time calibration memory.
Syntax CALibration:TEMPerature:M[n]{A|B}?
Returns NR3
Examples CALiBRATION:TEMPERATURE:M1A? might return CALiBRATION:TEMPERATURE:M1A 1.5
CALibration:STATus:M[n]{A|B}?
Description This is a query only command that returns the current calibration status for the module channel.
Syntax CALibration:STATus:M[n]{A|B}?
Returns Enum. Possible responses are FAIL or PASS.

TSO8 Series Programmer Manual

Examples CALiBRATION:STATUS:M1A? might return CALiBRATION:STATUS:M1A PASS indicates the calibration test has passed.
CALibration:STATus:MAInframe?
Description This is a query only command that returns the current calibration status for the mainframe.
Syntax CALibration:STATus:MAInframe?
Returns Enum. Possible responses are FAIL and PASS
Examples CALiBRATION:STATUS:MAINFRAME? might return CALiBRATION:STATUS:MAINFRAME PASS, indicating that the current calibration data should allow the instrument to meet operating specifications.
CALIbration:DATE:M[n]{A|B}?
Description This is a query only command that returns the date and the time of the current in-use (that is, run-time) calibration data for the module channel.
Syntax CALIbration:DATE:M[n]{A|B}?
Returns <QString> Date and the time of the current in-use calibration data
Examples CALIBRATION:DATE:M1A? might return :CALIBRATION:DATE:M1A “12/23/1973 1:13:34 AM”
CALIbration:DATE:MAInframe?
Description This is a query only command that returns the date and the time of the current in-use (that is, run-time) calibration data for the mainframe.
Syntax CALIbration:DATE:MAInframe?
Returns <QString> Date and the time of the current in-use (that is, run-time) calibration data for the mainframe.
Examples CALIBRATION:DATE:MAINFRAME? might return :CALIBRATION:DATE:MAINFRAME “12/23/1973 1:13:34 AM”
Cursor Command Group

TSO8 Series Programmer Manual

Use the commands in the Cursor Command Group to control the cursor display and readout. You can use these commands to control the setups for cursor 1 and cursor 2, such as waveform source, cursor position, and cursor color. You can also use the commands to select one of the following cursor functions:
· Off. Shuts off the display of all cursors. · Vertical Bars. Displays vertical bar cursors, which provide traditional horizontal unit readouts for
Cursor 1 (bar1), Cursor 2 (bar2), the delta between them, and 1/delta (results in frequency when the horizontal unit is time). · Horizontal Bars. Displays horizontal bar cursors, which provide traditional vertical unit readouts for Cursor 1 (bar1), Cursor 2 (bar2), and the delta between them. · Waveform. Displays waveform cursors, which provide horizontal and vertical unit readouts for Cursor 1 (bar1), Cursor 2 (bar2), the delta between them, and 1/delta (results in frequency when the horizontal unit is time).
CURSor[:VIEW[x]]:CURSor[x]:SOUrce
Description This command sets or queries which waveform is associated with the specified cursor. The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate. The cursor is specified by x in the :CURSor[x] portion of the command, which can be 1 or 2.
Syntax :CURSor[:VIEW[x]]:CURSor[x]:SOUrce { M[n]{A|B} | REF[x] } :CURSor[:VIEW[x]]:CURSor[x]:SOUrce?
Arguments · M[n]{A|B} specifies a live waveform to use as the source for the specified cursor. · REF[x] specifies a reference waveform to use as the source for the specified cursor.
Returns The waveform that is associated with the specified cursor.
Examples · :CURSOR:CURSOR2:SOURCE M1B associates cursor 2 in the default waveform view with the module 1 channel B waveform. · :CURSOR:VIEW2:CURSOR1:SOURCE? might return :CURSOR:VIEW2:CURSOR1:SOURCE
REF5, indicating that in waveform view 2, cursor 1 is associated with the Ref 5 waveform.
CURSor[:VIEW[x]]:FUNCtion
Description This command sets or queries cursor type. The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate. Waveform cursors are not supported with Pattern Sync off.
Syntax :CURSor[:VIEW[x]]:FUNCtion { WAVEform | VBArs | HBArs | VHBars } :CURSor[:VIEW[x]]:FUNCtion?
Arguments · WAVEform enables waveform cursors, which provide both vertical and horizontal unit readouts but are constrained to valid data points of the selected waveform.

TSO8 Series Programmer Manual

· VBArs enables vertical bar cursors, which provide horizontal unit readouts. · HBArs enables horizontal bar cursors, which provide vertical unit readouts. · VHBars enables vertical and horizontal bar cursors, which provide their respective unit readouts.
Returns The current cursor type
Examples · :CURSOR:VIEW3:FUNCTION VBARS enables the vertical bar type cursors in waveform view 3. · :CURSOR:FUNCTION? might return :CURSOR:FUNCTION WAVEFORM, indicating that the waveform type cursors are enabled in the default waveform view.
CURSor[:VIEW[x]]:HBArs:POSition[x] Description This command sets or queries the position of a horizontal bar cursor. The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate.The cursor is specified by x in the :POSition[x] portion of the command, which can be 1 or 2.
Syntax :CURSor[:VIEW[x]]:HBArs:POSition[x] <NR3> :CURSor[:VIEW[x]]:HBArs:POSition[x]?
Related Commands :CURSor[:VIEW[x]]:VBArs:POSition[x] :CURSor[:VIEW[x]]:HBArs:DELTa?
Arguments NR3 specifies the cursor position relative to zero for the source waveform.
Returns The position of the specified horizontal bar cursor.
Examples · :CURSOR:HBARS:POSITION1 5.0E-6 positions Cursor 1 at 5uW above the zero level of the source waveform in the default waveform view. · :CURSOR:VIEW2:HBARS:POSITION2? might return :CURSOR:VIEW2:HBARS:POSITION2 1.68E-6 indicating that in waveform view 2, cursor 2 is 1.68 uW below the zero level of the source waveform.
CURSor[:VIEW[x]]:HBArs:DELTa? (Query Only)
Description This query only command returns the difference between the two horizontal bar cursors. The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate.
Syntax :CURSor[:VIEW[x]]:HBArs:DELTa?
Related Commands :CURSor[:VIEW[x]]:VBArs:DELTa? :CURSor[:VIEW[x]]:HBArs:POSition[x] Returns

TSO8 Series Programmer Manual

The difference between the two horizontal bar cursors.
Examples · :CURSOR:VIEW4:HBARS:DELTA? might return :CURSOR:VIEW4:HBARS:DELTA 556.000E-6, indicating a 556uW difference between the two horizontal bar cursors in waveform view 4.
CURSor[:VIEW[x]]:VBArs:POSition[x] Description This command sets or queries the position of a vertical bar cursor. The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate. The cursor is specified by x in the :POSition[x] potion of the command, which can be 1 or 2.
Syntax :CURSor[:VIEW[x]]:VBArs:POSition[x] <NR3> :CURSor[:VIEW[x]]:VBArs:POSition[x]?
Related Commands :CURSor[:VIEW[x]]:HBArs:POSition[x] :CURSor[:VIEW[x]]:VBArs:DELTa?
Arguments NR3 specifies the cursor position measured from the trigger point of the source waveform.
Returns The position of the specified vertical bar cursor.
Examples · :CURSOR:VIEW1:VBARS:POSITION1 21E-9 positions Cursor 1 at 21ns from the trigger point of the source waveform in waveform view 1. · :CURSOR:VBARS:POSITION2? might return :CURSOR:VBARS:POSITION2 3.45E-6 indicating that in the default waveform view, cursor 2 is 3.45us from the trigger point of the source waveform.
CURSor[:VIEW[x]]:VBArs:DELTa? (Query Only)
Description This query only command returns the difference between the two vertical bar cursors. The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate.
Syntax :CURSor[:VIEW[x]]:VBArs:DELTa?
Related Commands :CURSor[:VIEW[x]]:HBArs:DELTa? :CURSor[:VIEW[x]]:VBArs:POSition[x] Returns The difference between the two vertical bar cursors.
Examples :CURSOR:VBARS:DELTA? might return :CURSOR:VBARS:DELTA 3e-12, indicating a 3ps difference between the two vertical bar cursors in the default waveform view.

TSO8 Series Programmer Manual

CURSor[:VIEW[x]]:WAVeform:HPOS[x]? (Query Only)
Description This query only command returns the position of the specified waveform cursor in vertical units. The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate. The cursor is specified by x in the :HPOS[x] portion of the command, which can be 1 or 2. Because this is waveform cursor mode, this command returns the vertical value in the source waveform which occurs at the time specified by the CURSor:WAVeform:POSition[x] command.
Syntax :CURSor[:VIEW[x]]:WAVeform:HPOS[x]?
Related Commands :CURSor[:VIEW[x]]:WAVeform:POSition[x] :CURSor[:VIEW[x]]:WAVeform:VDELTa? :CURSor[:VIEW[x]]:WAVeform:HDELTa?
Returns The position of the specified waveform cursor.
Examples :CURSOR:VIEW6:WAVEFORM:HPOS2? might return :CURSOR:VIEW6:WAVEFORM:HPOS2 4.67E-4, indicating that in waveform view 6, cursor 2 is at 467uW relative to ground on the source waveform.
CURSor[:VIEW[x]]:WAVeform:POSition[x] Description This command sets or queries the position of a waveform cursor in horizontal units (usually time). The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate. The cursor is specified by x in the :POSition[x] portion of the command, which can be 1 or 2.
Syntax :CURSor[:VIEW[x]]:WAVeform:POSition[x] <NR3> :CURSor[:VIEW[x]]:WAVeform:POSition[x]?
Related Commands :CURSor[:VIEW[x]]:WAVeform:HPOS[x]? :CURSor[:VIEW[x]]:WAVeform:VDELTa? :CURSor[:VIEW[x]]:WAVeform:HDELTa?
Arguments <NR3> specifies the cursor position measured relative to the time of the trigger point of the source waveform.
Returns The position of a waveform cursor.
Examples · :CURSOR:VIEW2:WAVEFORM:POSITION1 36.8E-9 positions waveform cursor 1 at 36.8ns relative to the time of the trigger point of the source waveform in waveform view 2. · :CURSOR:WAVEFORM:POSITION2? might return :CURSOR:WAVEFORM:POSITION2 19E-9, indicating that in the default waveform view, waveform cursor 2 is at 19ns relative to the time of the trigger point of the source waveform.

TSO8 Series Programmer Manual

CURSor[:VIEW[x]]:WAVeform:VDELTa?
Description This query only command returns the vertical difference between the waveform cursors. The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate.
Syntax :CURSor[:VIEW[x]]:WAVeform:VDELTa?
Related Commands :CURSor[:VIEW[x]]:WAVeform:POSition[x] :CURSor[:VIEW[x]]:WAVeform:HPOS[x]? :CURSor[:VIEW[x]]:WAVeform:HDELTa?
Returns The vertical difference between the waveform cursors.
Examples :CURSOR:VIEW3:WAVEFORM:VDELTA? might return :CURSOR:VIEW3:WAVEFORM:VDELTA 1.06E3, indicating that in waveform view 3, the difference between the waveform cursors is 1.06 mW.
CURSor[:VIEW[x]]:WAVeform:HDELTa?
Description This query only command returns the horizontal difference between the waveform cursors. The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate.
Syntax :CURSor[:VIEW[x]]:WAVeform:HDELTa?
Related Commands :CURSor[:VIEW[x]]:WAVeform:POSition[x] :CURSor[:VIEW[x]]:WAVeform:HPOS[x]? :CURSor[:VIEW[x]]:WAVeform:VDELTa?
Returns The vertical difference between the waveform cursors.
Examples :CURSOR:WAVEFORM:HDELTA? might return :CURSOR:WAVEFORM:HDELTA 3.88E-9, indicating that in the default waveform view, the difference between the waveform cursors is 3.88ns.
CURSor[:VIEW[x]]:MODe
Description This command sets or queries the cursor mode. The optional [:VIEW[x]] argument specifies which waveform view’s cursors to manipulate.
Syntax :CURSor[:VIEW[x]]:MODe { INDependent | LINKed } :CURSor[:VIEW[x]]:MODe?
Arguments

TSO8 Series Programmer Manual

· INDependent sets the cursor mode to independent, where moving one cursor does not move the other.
· LINKed set the cursor mode to linked, where TSOVu does its best to maintain the same delta between the two cursors while one is moved.
Returns The current cursor mode.
Examples · :CURSOR:VIEW1:MODE LINKED sets the current cursor mode to linked in waveform view 1. · :CURSOR:MODE? might return :CURSOR:MODE INDEPENDENT, indicating that in the default waveform view, the current cursor mode is independent.
CURSor[:VIEW[x]]:WFMSource
Description This command sets or queries the Source Waveform mode. Source Waveform mode defines whether the set of cursors share a waveform source or can have split waveform sources.
Syntax :CURSor[:VIEW[x]]:WFMSource { SAMe | SPLit } :CURSor[:VIEW[x]]:WFMSource?
Related Commands :CURSor[:VIEW[x]]:CURSOR[x]:SOUrce
Arguments · SAMe sets the Source Waveform mode to Same, meaning all cursors will have the same waveform source. · SPLit sets the Source Waveform mode to Split, meaning each cursor can have a different waveform source.
Returns The Source Waveform mode.
Examples · :CURSOR:WFMSOURCE SAME sets the Source Waveform mode to Same in the default waveform view. · :CURSOR:VIEW2:WFMSOURCE? might return :CURSOR:VIEW2:WFMSOURCE SPLIT, indicating that in waveform view 2, the Source Waveform mode is set to Split.
Diagnostic
DIAG:POWERUP:STATUS?
Description This is a query only command that returns a result of the power on diagnostic execution. “Pass” indicates the system has passed the diagnostic test, it is similar for “Fail” case.
Syntax DIAG:POWERUP:STATUS?
Returns

TSO8 Series Programmer Manual

<QString>
Examples DIAG:POWERUP:STATUS? might return DIAG:POWERUP:STATUS? “PASS”, indicating that the power on diagnostic was passed.
Display Control Command Group
You use the commands in the Display Control Command Group to change the graticule style, the displayed intensities, and to set the characteristics of the waveform display.
You can set the following: · Histogram · Whether cursor and histogram are displayed. · Whether waveforms are displayed (shown) or not displayed (hidden). · Whether waveforms are displayed in Normal mode as dots or vectors, in · Variable Persistence mode, or in Infinite Persistence mode. · If interpolation is used, which type (Sin(x) or Linear). · The style of graticule that underlies the waveforms.
Use the commands to set the style that best displays your waveforms and graticule display properties.
DISplay:MODE
Description This command will get or set the mode of the display view.
Syntax DISplay:MODE { OVERlay | TILE } DISplay:MODE?
Arguments · OVERlay · TILE
Examples DISplay:MODE TILE sets thedisplay mode to TILE. DISplay:MODE? might return DISplay:MODE TILE if TILE is selected.
DISplay:WAVeform:VIEW[x]:GRATicule:STYLe
Description This command will get or set the style of graticule that is displayed. The display view is specified by x.
Syntax DISplay:WAVeform:VIEW[x]:GRATicule:STYLe { TIME|FULL | NONE | GRID } DISplay:WAVeform:VIEW[x]:GRATicule:STYLe?
Arguments · FULL specifies a frame and a grid. · TIME specifies vertical grid related to time · GRID specifies a frame and a grid. · NONE means no grid at all.

TSO8 Series Programmer Manual

Examples · DISplay:WAVeform:VIEW1:GRATicule:STYLe GRID sets the graticule style to display a frame and a grid which is on display view 1. · DISplay:WAVeform:VIEW1:GRATicule:STYLe? might return · DISplay:WAVeform:VIEW1:GRATicule:STYLe FULL when all graticule elements (grid and frame) are displayed which is on display view 1.
DISplay:WAVeform:VIEW[x]:GRATicule:INTensity
Description This command will get or set the graticule intensity of the specified display view. The display view is specified by x.
Syntax DISplay:WAVeform:VIEW[x]:GRATicule:INTensity <NR3> DISplay:WAVeform:VIEW[x]:GRATicule:INTensity?
Arguments <NR3> is the graticule intensity of the waveform in percentage.
Returns It returns the graticule intensity of the reference waveform or live waveform of specified display view.
Examples · DISplay:WAVeform:VIEW1:GRATicule:INTensity 70 sets the graticule intensity 70 percentage which is on display view 1 · DISplay:WAVeform:VIEW1:GRATicule:INTensity? Might return DISplay:WAVeform:VIEW1:GRATicule:INTensity 70, indication that the graticlue display is 70 percentage on display view 1.
DISplay:WAVeform:VIEW[x]:WINTensity
Description This command will get or set the waveform intensity of the waveform of specified display view. The display view is specified by x.
Syntax DISplay:WAVeform:VIEW[x]:WINTensity<NR3> DISplay:WAVeform:VIEW[x]:WINTensity?
Arguments <NR3> is the waveform intensity of the waveform in percentage.
Returns It returns the waveform intensity of the reference waveform or live waveform of specified display view.
Examples · DISplay:WAVeform:VIEW1:WINTensity 70 sets the waveform intensity 70 percentage which is on display view 1 · DISplay:WAVeform:VIEW1:WINTensity? Might return DISplay:WAVeform:VIEW1:WINTensity 70, indication that the waveform display is 70 percentage on display view 1.

TSO8 Series Programmer Manual

DISplay:WAVeform:VIEW[x]:WIPolate
Description This command will get or set the interpolation algorithm used to display any waveform. The display view is specified by x.
Syntax DISplay:WAVeform:VIEW[x]:WIPolate { SINX | LINear | NONE } DISplay:WAVeform:VIEW[x]:WIPolate?
Arguments
· SINX specifies Sin (x)/x interpolation. This algorithm computes points using a curve fit between the actual values acquired. It assumes all interpolated points fall along the curve. This is useful when displaying more rounded waveforms such as sine waves. This algorithm can be used for general use, but it may introduce some overshoot or undershoot in signals with fast rise times
· LINear specifies linear interpolation. This algorithm computes points between actual acquired samples by using a straight line fit. The algorithm assumes all interpolated points fall along the straight line. Linear interpolation is useful for many waveforms such as pulse trains.
· NONE turns off the interpolation function.
Returns It returns the interpolation method in query form.
Limitation This command only applies to pattern mode. When Waveform Style is selected as DOTS Interpolation dropdown will contain Sin (x)/x, Linear, None. When Waveform Style is selected as VECTORS Interpolation dropdown will contain Sin (x)/x, Linear.
Examples DISplay:WAVeform:VIEW2:WIPolate LINEAR selects the linear interpolation algorithm which is on display view 1. DISplay:WAVeform:VIEW2:WIPolate? might return DISplay:WAVeform:VIEW2:WIPolate LINEAR, indicating that linear interpolation algorithm is selected which is on display view 2.
DISplay:WAVeform:VIEW[x]:ZOOM:STATe
Description This command will get or set the state of Zoom of the specified display view. The display view is specified by x.
Syntax DISplay:WAVeform:VIEW[x]:ZOOM:STATe { OFF | ON } DISplay:WAVeform:VIEW[x]:ZOOM:STATe?
Arguments · OFF · ON
Examples · DISplay:WAVeform:VIEW1:ZOOM:STATe OFF switch off the zoom for display view 1. · DISplay:WAVeform:VIEW1:ZOOM:STATe? might return DISplay:WAVeform:VIEW[x]:ZOOM:STATe ON if zoom is on for display view 1.

TSO8 Series Programmer Manual

DISplay:WAVeform:VIEW[x]:ZOOM:HORizontal:POSition
Description This command will get or set the Horizontal position of zoom for specified display view. The display view is specified by x..
Syntax DISplay:WAVeform:VIEW[x]:ZOOM:HORizontal:POSition <NR3> DISplay:WAVeform:VIEW[x]:ZOOM:HORizontal:POSition?
Arguments <NR3> is the Horizontal position of the zoom.
Returns It returns the Horizontal position of the zoom window of specified display view.
Examples · DISplay:WAVeform:VIEW1:ZOOM:HORizontal:POSition 70 sets the horizontal position to 70 which is on display view 1 · DISplay:WAVeform:VIEW1:ZOOM:HORizontal:POSition? Might return DISplay:WAVeform:VIEW1:ZOOM:HORizontal:POSition 70, indication that the horizontal position is 70 on display view 1.
DISplay:WAVeform:VIEW[x]:ZOOM:HORizontal:SCALe
Description This command will get or set the Horizontal scale of zoom for specified display view. The display view is specified by x.
Syntax DISplay:WAVeform:VIEW[x]:ZOOM:HORizontal:SCALe <NR3> DISplay:WAVeform:VIEW[x]:ZOOM:HORizontal:SCALe?
Arguments <NR3> is the Horizontal scale of the zoom.
Returns It returns the Horizontal scale of the zoom window of specified display view.
Examples · DISplay:WAVeform:VIEW1:ZOOM:HORizontal:SCALe 3 sets the horizontal scale to 3 which is on display view 1 · DISplay:WAVeform:VIEW1:ZOOM:HORizontal:SCALe? Might return DISplay:WAVeform:VIEW1:ZOOM:HORizontal:SCALe 5, indication that the horizontal scale is 5 on display view 1.
DISplay:WAVeform:VIEW[x]:ZOOM:HORizontal:WINScale
Description This command will get or set the Horizontal scale in window of zoom for specified display view. The display view is specified by x.
Syntax

TSO8 Series Programmer Manual

DISplay:WAVeform:VIEW[x]:ZOOM:HORizontal:WINScale <NR3> DISplay:WAVeform:VIEW[x]:ZOOM:HORizontal:WINScale?
Arguments <NR3> is the Horizontal scale in window of the zoom.
Returns It returns the Horizontal scale in window of the zoom window of specified display view.
Examples · DISplay:WAVeform:VIEW1:ZOOM:HORizontal:WINScale 2e-12 sets the horizontal scale in window of zoom to 2ps/div which is on display view 1 · DISplay:WAVeform:VIEW1:ZOOM:HORizontal:WINScale? Might return DISplay:WAVeform:VIEW1:ZOOM:HORizontal:WINScale 2E-9, which is on display view 1.
DISplay:ERRor:DIALog
Description This command enables or disables error dialogs from displaying on the UI when an error condition occurs.
Syntax DISplay:ERRor:DIALog {ON | OFF | 1 | 0} DISplay:ERRor:DIALog?
Arguments 0 or OFF hides the error dialogs. 1 or ON displays the error dialogs.
Returns The query version of this command returns 1 or 0.
Examples DISPLAY:ERROR:DIALOG 0 hides the error dialogs from display. DISPLAY:ERROR:DIALOG? might return 1, indicating that error messages will be displayed on the main window.
DISplay:REF[x] Description The user shall use this PI command to set or query whether the specified reference waveform is displayed. The waveform is specified by x. This is equivalent to the Display toggle that is available in the Ref Configuration Menu (right-click property of the Ref Badge in the Settings Bar at the bottom of the user interface). NOTE: You should define a reference waveform before turning the waveform on. Group: Vertical
Syntax DISplay:REF[x] { ON | OFF | 0 | 1 } DISplay:REF[x]?

TSO8 Series Programmer Manual

Arguments 1. ON displays the specified reference waveform. 2. OFF turns off the display of the specified reference waveform. 3. NR1 set to 0 turns off the display of the specified reference waveform; any other value displays the specified reference waveform.
Returns It returns the display status of the waveform.
Examples DISPLAY:REF1 0: it turns off the REF1 display. DISPLAY:REF1?: it returns the DISPLAY:REF1 0, the waveform display status.
DISplay:M[n]{A|B}
Description The user shall use this PI command to set or query whether the specified live waveform is displayed. The waveform is specified by M[n]{A|B}, where [n] is the module number and {A|B} is the channel name of the module.
Syntax DISplay:M[n]{A|B} { ON | OFF | 0 | 1 } DISplay:M[n]{A|B}?
Arguments 1. { ON | OFF | 0 | 1 }: ON or 1 displays the specified live waveform. OFF or 0 turns off the display of the specified live waveform.
Returns It returns the status of the waveform display.
Examples DISPLAY:M1A ON displays M1A waveform. DISPLAY:M1A? might return 0 to signify that the M1A waveform is not currently being displayed.
Histogram Command Group
Histogram commands lets you select the type of histogram, what part of the waveform should go into the histogram, and histogram statistics.
You can use commands from this group to do the following: · Select any channel or reference waveform and create a histogram of vertical or horizontal values for it. · Adjust the limits of the box that define the area on the waveform from which the histogram data is obtained. The histogram box can be set using source waveform coordinates or percentage-ofdisplay coordinates. · Create a linear or logarithmic plot of histogram data and set plot size and color. · Turn the display of the histogram on or off. · Set or query the color of the histogram box and histogram plot. · Get histogram statistics, such as total hits, mean value, peak-to-peak value, and standard deviation. · Get all the histogram parameters

TSO8 Series Programmer Manual

:HISTogram:ADDHisto
Description This command adds a histogram using the specified source, mode, area type, left, top, right and bottom boundary limits.
Syntax HISTogram:ADDHisto <source>, {HORizontal | VERTical}, {ABSolute | PERCentage}, <NR3>,<NR3>,<NR3>,<NR3>
Arguments <source> can be any of the following three:
1. M[x]A|B selects a channel waveform as the source or destination waveform 2. MATH<x> selects a math waveform as the source for the histogram 3. REF<x> selects a reference waveform as the source for the histogram
HORizontal creates a horizontally positioned histogram that shows time distribution VERTical creates a vertically positioned histogram that shows a voltage distribution (or other vertical distribution, such as amperes)
ABSolute specifies that the histogram plot box boundary limits are specified in absolute values PERCentage specifies that the histogram plot box boundary limits are specified in percentage values
<NR3> (first) is the left position of the histogram box <NR3> (second) is the top position of the histogram box <NR3> (third) is the right position of the histogram box <NR3> (fourth) is the bottom position of the histogram box
Examples HISTOGRAM:ADDHISTO REF1,VERTICAL,ABSOLUTE,20.5E-9,248.9E-3,22.5E-9,-251.1E-3 adds a vertical Histogram1 with source as Ref1 and whose boundary limits are specified in terms of absolute values.
:HISTogram:DELete:ALL
Description This command deletes all active histograms.
Syntax HISTogram:DELete:ALL
Examples HISTOGRAM:DELETE:ALL will delete all active histograms
:HISTogram:HISTo<x>:CONFig:DISPlay
Description This command sets or queries the display setting for the given histogram. Histograms are specified by <x>. This command is used to add/remove the histogram plot to the display associated with it’s source.
Syntax HISTogram:HISTo<x>:CONFig:DISPlay { ON | OFF | 0 | 1 }
Arguments

TSO8 Series Programmer Manual

ON or any other non-zero value adds the histogram plot to the display associated with it’s source OFF or 0 removes the histogram plot from the display associated with it’s source
Returns 0 or 1 indicating state of display of the specified histogram is OFF or ON respectively
Examples · HISTOGRAM:HISTO1:CONFIG:DISPLAY ON adds the HISTO1’s plot to the display associated with its source. · HISTOGRAM:HISTO2:CONFIG:DISPLAY OFF removes the HISTO2’s plot from the display associated with it’s source · HISTOGRAM:HISTO3:CONFIG:DISPLAY 1 adds the HISTO3’s plot to the display associated with it’s source · HISTOGRAM:HISTO1:CONFIG:DISPLAY? might return HISTOGRAM:HISTO1:CONFIG:DISPLAY 1 meaning the HISTO1’s plot is added to the display associated with it’s source
:HISTogram:HISTo<x>:CONFig:SOURce
Description This command sets or queries the source of the histogram measurement. Histograms are specified by <x>. The waveform need not be displayed for histograms to run.
Syntax :HISTogram:HISTo<x>:CONFig:SOURce <source>
Arguments <source> can be any one of the following: M[x]A|B selects a channel waveform as the source or destination waveform. MATH<x> selects a math waveform as the source for the histogram REF<x> selects a reference waveform as the source for the histogram
Returns The source of the specified histogram
Examples · HISTOGRAM:HISTO1:CONFIG:SOURCE REF2 sets REF2 as the source waveform for Histogram1 · HISTOGRAM:HISTO2:CONFIG:SOURCE M1B sets channel B on module 1 as the source waveform for Histogram2 · HISTOGRAM:HISTO1:CONFIG:SOURCE? Might return HISTOGRAM:HISTO1:CONFIG:SOURCE REF2 indicating that the waveform source for Histogram1 is Ref1
:HISTogram:HISTo<x>:CONFig:MODe
Description This command sets or queries the mode of the given histogram. Histograms are specified by <x>.
Syntax HISTogram:HISTo<x>:CONFig:MODe {HORizontal | VERTical}
Arguments

TSO8 Series Programmer Manual

HORizontal creates a horizontally positioned histogram that shows time distribution VERTical creates a vertically positioned histogram that shows a voltage distribution (or other vertical distribution, such as amperes)

Returns HORIZONTAL indicating the histogram is horizontally positioned showing time distribution VERTICAL indicating the histogram is vertically positioned showing voltage distribution (or other vertical distribution, such as amperes)
Examples HISTOGRAM:HISTO1:CONFIG:MODE HORIZONTAL configures Histogram1 to be horizontally positioned HISTOGRAM:HISTO2:CONFIG:MODE? might return HISTOGRAM:HISTO2:CONFIG:MODE VERTICAL indicating Histogram2 is vertically positioned
:HISTogram:HISTo<x>:CONFig:TYPE
Description This command sets or queries whether the histogram is calculated linearly or logarithmically. Histograms are specified by <x>.
Syntax HISTogram:HISTo<x>:CONFig:TYPE {LINear | LOG }
Arguments LINear specifies that bin counts smaller than the maximum should be scaled linearly by dividing the bin count by the maximum bin count. LOG specifies that bin counts smaller than the maximum should be scaled logarithmically (log (bin-count)) with log(0) staying at 0 (baseline). The base of the log does not matter since logs to different bases differ only by a constant multiplier. Logarithmic scaling provides better visual detail for bins with low counts.
Returns LINEAR indicating the histogram is displayed linearly. LOG indicating the histogram is displayed logarithmically.
Examples HISTOGRAM:HISTO1:CONFIG:TYPE LINEAR displays the count in each bin scaled linearly HISTOGRAM:HISTO2:CONFIG:TYPE? might return HISTOGRAM:HISTO2:CONFIG:TYPE LINEAR, indicating that the histogram display is scaled linearly
:HISTogram:HISTo<x>:CONFig:AREA
Description This command sets or queries whether boundary limits of histogram plot box is specified in absolute or percentage.
Syntax HISTogram:HISTo<x>:CONFig:AREA {ABSolute | PERCentage}
Arguments ABSolute specifies that the histogram plot box boundary limits are specified in absolute values

TSO8 Series Programmer Manual

PERCentage specifies that the histogram plot box boundary limits are specified in percentage values
Returns ABSOLUTE indicating that the histogram plot box boundary limits are specified in absolute values PERCENTAGE indicating that the histogram plot box boundary limits are specified in percentage values
Examples HISTOGRAM:HISTO1:CONFIG:AREA ABSOLUTE sets the boundary limits of HISTO1’s plot box to be specified in absolute HISTOGRAM:HISTO2:CONFIG:AREA? might return HISTOGRAM:HISTO2:CONFIG:AREA PERCENTAGE, indicating that the HISTO2’s plot box is specified in percentage
:HISTogram:HISTo<x>:CONFig:BOX
Description This command sets or queries the left, top, right, and bottom boundaries of the histogram box in source waveform coordinates (absolute values). Histograms are specified by <x>.
Syntax HISTogram:HISTo<x>:CONFig:BOX <NR3>,<NR3>,<NR3>,<NR3>
Arguments <NR3> (first) is the left position of the histogram box in source waveform coordinates <NR3> (second) is the top position of the histogram box in source waveform coordinates <NR3> (third) is the right position of the histogram box in source waveform coordinates <NR3> (fourth) is the bottom position of the histogram box in source waveform coordinates
Returns A comma separated list of left, top, right and bottom positions of histogram box in source waveform coordinates
Examples · HISTOGRAM:HISTO1:CONFIG:BOX 1.518E-006,-2.46E-1,3.518E-6,-7.47E-1 defines the coordinates of the HISTO1’s histogram box in source waveform coordinates. HISTOGRAM:HISTO2:CONFIG:BOX? might return · HISTOGRAM:HISTO2:BOX 1.51800000000E-006,-0.246000000000,3.51800000000E-006, 0.747000000000 indicating the left, top, right and bottom positions of HISTO2’s box in source waveform coordinates respectively.
:HISTogram:HISTo<x>:STATistics:HITS (Query only)
Description This command is used to get the total hits calculated for the specified histogram. Histograms are specified by <x>.
Syntax HISTogram:HISTo<x>:STATistics:HITS?
Arguments This query only command shall have no arguments
Returns <NR3> the hits value for the specified histogram

TSO8 Series Programmer Manual

Examples HISTOGRAM:HISTO1:STATISTICS:HITS? might return HISTOGRAM:HISTO1:STATISTICS:HITS 6.83400000000E+003, indicating that the total hits for Histogram1 is 6,834
:HISTogram:HISTo<x>:STATistics:MEAN (Query only)
Description This command is used to get the mean value calculated for the specified histogram. Histograms are specified by <x>.
Syntax HISTogram:HISTo<x>:STATistics:MEAN?
Arguments This query only command shall have no arguments
Returns <NR3> the mean value for the specified histogram
Examples HISTOGRAM:HISTO2:STATISTICS:MEAN? might return HISTOGRAM:HISTO2:STATISTICS:MEAN 43.0000000000E009, indicating that the mean value for Histogram2 is 43 ns
:HISTogram:HISTo<x>:STATistics:MEDian (Query only)
Description This command is used to get the median value calculated for the specified histogram. Histograms are specified by <x>.
Syntax HISTogram:HISTo<x>:STATistics:MEDian?
Arguments This query only command shall have no arguments
Returns <NR3> the median value for the specified histogram
Examples HISTOGRAM:HISTO1:STATISTICS:MEDIAN? might return HISTOGRAM:HISTO1:STATISTICS:MEDIAN 43.0000000000E009, indicating that the median value for Histogram1 is 43 ns
:HISTogram:HISTo<x>:STATistics:MODe (Query only)
Description This command is used to get the bin having maximum hits for the specified histogram. Histograms are specified by <x>.
Syntax

TSO8 Series Programmer Manual

HISTogram:HISTo<x>:STATistics:MODe?
Arguments This query only command shall have no arguments
Returns <NR3> the bin having maximum hits for the specified histogram
Examples HISTOGRAM:HISTO3:STATISTICS:MODE? might return HISTOGRAM:HISTO3:STATISTICS:MODE 390.0000000000E-6, indicating that the bin having maximum hits value for the waveform source of Histogram3 is 390µ
:HISTogram:HISTo<x>:STATistics:PKTopk (Query only)
Description This command is used to get the peak-to-peak value calculated for the specified histogram. Histograms are specified by <x>.
Syntax HISTogram:HISTo<x>:STATistics:PKTopk?
Arguments This query only command shall have no arguments
Returns <NR3> the peak-to-peak value for the specified histogram
Examples HISTOGRAM:HISTO1:STATISTICS:PKTOPK? might return HISTOGRAM:HISTO1:STATISTICS:PKTOPK 20.0000000000E009, indicating that the peak-to-peak value for Histogram1 is 20 ns
:HISTogram:HISTo<x>:STATistics:STDDev (Query only)
Description This command is used to get the standard deviation value calculated for the specified histogram. Histograms are specified by <x>.
Syntax HISTogram:HISTo<x>:STATistics:STDDev?
Arguments Query only command shall have no arguments
Returns <NR3> the standard deviation value for the specified histogram

Examples HISTOGRAM:HISTO4:STATISTICS:STDDEV? might return HISTOGRAM:HISTO4:STATISTICS:STDDEV 5.80230767128E009, indicating that the standard deviation value for Histogram4 is 5.80 ns

TSO8 Series Programmer Manual

:HISTogram:HISTo<x>:STATistics:WAVeforms (Query only)
Description This command is used to get the number of waveforms used in the specified histogram. Histograms are specified by <x>.
Syntax HISTogram:HISTo<x>:STATistics:WAVeforms?
Arguments This query only command shall have no arguments
Returns <NR3> the number of waveforms used in the specified histogram
Examples HISTOGRAM:HISTO1:STATISTICS:WAVEFORMS? might return HISTOGRAM:HISTO1:STATISTICS:WAVEFORMS 2.08100000000E+003, indicating that 2081 waveforms were used to create Histogram1
:HISTogram:HISTo<x>:DELete
Description This command is used to delete the specified histogram.
Syntax HISTogram:HISTo<x>:DELete
Examples HISTOGRAM:HISTO3:DELETE will delete Histogram3
Horizontal Command Group
You use the commands from the Horizontal Command Group to control the time bases of the instrument.
HORizontal:APOSition
Description This command sets or queries auto position. Setting auto position is available only in eye mode. Enabling auto position mode will center the eye on the display.
Syntax :HORizontal:APOSition {ON | OFF | 1 | 0} :HORizontal:APOSition?
Arguments ON or 1 turns on auto position. OFF or 0 turns off auto position.
Returns

TSO8 Series Programmer Manual

The query version of this command returns 1 or 0.
Examples · :HORIZONTAL:APOSition ON sets Auto Position to On. · :HORIZONTAL:APOSition? might return 0, indicating that Auto Position is Off.
Limitations This command is set/query only when Pattern Sync is Off.
HORizontal[:MAIN]:REFPoint
Description This command sets or queries the horizontal reference point in percentage.
The horizontal reference point is the point that holds stationary when horizontal scale changes. The only time this rule is broken, is when it would cause the acquisition window to extend beyond the beginning or end of a pattern.
Syntax :HORizontal[:MAIN]:REFPoint <NR3> :HORizontal[:MAIN]:REFPoint?
Related Commands :HORizontal[:MAIN]:POSition
Arguments <NR3> is the percentage of the record at which the horizontal reference is set. The range is 0 through 100 (corresponding to 0% through 100% of the record.)
Returns The query version of this command returns an NR3 value between 0 and 100, representing the fraction of the record at which the horizontal reference point is set.
Examples · :HORIZONTAL:REFPOINT 25 sets the horizontal reference point to 25% of Record Length. · :HORIZONTAL:REFPOINT? might return “:HORIZONTAL:REFPOINT 25.0000000000”.
:HORizontal[:MAIN]:POSition
Description This command sets or queries the horizontal position in seconds.
The horizontal position is the time between the trigger and the first acquired point in a record.
Syntax :HORizontal[:MAIN]:POSition <NR3> :HORizontal[:MAIN]:POSition?
Related Commands :HORizontal[:MAIN]:REFPoint
Arguments

TSO8 Series Programmer Manual

<NR3> is the horizontal position in seconds. The valid range is defined by the instrument that TSOVu is connected to.
Returns The query version of this command returns an NR3 value representing the horizontal position in seconds.
Examples · :HORIZONTAL:POSITION 30e-9 sets the horizontal position be 30 ns. · :HORIZONTAL:POSITION? might return “:HORIZONTAL:POSITION 30.0000000000E-9” indicating that horizontal position is set to 30ns.
:HORizontal[:MAIN]:SCALe
Description This command sets or queries the horizontal scale (time per division).
Syntax :HORizontal[:MAIN]:SCALe <NR3> :HORizontal[:MAIN]:SCALe?
Related Commands :HORizontal[:MAIN]:RESolution? :HORizontal:PLENgth :HORizontal:SRATe
Arguments <NR3> is the horizontal time per division in seconds.
Returns The query version of this command returns an NR3 value for the horizontal scale value is seconds.
Examples · :HORIZONTAL:SCALE 2.5E-9 sets the horizontal scale to 2.5ns per division. · :HORIZONTAL:SCALE? might return “:HORIZONTAL:SCALE 2.50000000000E-9”
Limitations This command is query only when Full Pattern is On and Pattern Sync is On.
:HORizontal[:MAIN]:RECordlength
Description This command sets or queries the record length in samples.
Syntax :HORizontal[:MAIN]:RECordlength <NR1>
Related Commands :HORizontal:PLENgth :HORizontal:SAMPlesui
Arguments <NR1> is the integer value of the record length in samples. The valid range is defined by the instrument that TSOVu is connected to.

TSO8 Series Programmer Manual

Returns The query version of this command returns an NR1 value of the record length.
Examples :HORIZONTAL:RECordlength 1e+4 sets the record length to be 10000. :HORIZONTAL:RECordlength? might return “:HORIZONTAL:RECORDLENGTH 10.0000000000E+3” as the record length value.
Limitations This command is query only when Full Pattern is On and Pattern Sync is On.
:HORizontal[:MAIN]:RESolution (Query only)
Description This command returns the current resolution per sample in seconds, which is the time between two samples.
Syntax :HORizontal[:MAIN]:RESolution?
Related Commands :HORizontal[:MAIN]:SCALe :HORizontal:SAMPlesui :HORizontal[:MAIN]:SCALe :HORizontal:SRATe :HORizontal[:MAIN]:RECordlength
Returns This query command returns an NR3 value representing the time between any two samples in seconds.
Examples :HORIZONTAL:RESolution? might return “:HORIZONTAL:RESolution 1.9820606061E-12”, which indicates the horizontal resolution is 1.982ps.
HORizontal:SAMPlesui
Description This command sets or queries the samples per UI.
Syntax HORizontal:SAMPlesUI <NR1> HORizontal:SAMPlesUI?
Related Commands HORizontal:SAMPlesUI <NR1>
Arguments <NR1> is the integer value that sets the value of samples per UI.
Returns The query version of this command returns an NR1 value as the samples per UI.
Examples · HORIZONTAL:SAMPlesui 20 sets the samples per UI to be 20.

TSO8 Series Programmer Manual

· HORIZONTAL:SAMPlesui? might return “HORIZONTAL:SAMPLESUI 20.0000000000”
Limitations This command is query only when Pattern Sync is Off.
HORizontal:PLENgth
Description Set or query the number of symbols in a pattern.
Syntax HORizontal:PLENgth <NR1>
Related Commands TRIGger:PSYNc:PLENgth
Arguments <NR1> is the integer value of number of symbols in a pattern.
Returns The query version of this command returns an NR1 value as the number of symbols in a pattern.
Examples HORIZONTAL:PLENgth 32760 sets the pattern length to be 32760, and the Pattern name becomes “User Defined” in UI. HORIZONTAL:PLENgth? might return “HORIZONTAL:PLENgth 32.7600000000E+3”
HORizontal:SRATe
Description This command sets or queries the symbol rate, which is equivalent to the signal baud rate.
Syntax HORizontal:SRATe <NR3>
Related Commands TRIGger:PSYNc:DATARate HORizontal[:MAIN]:SCALe
Arguments <NR3> is the value of the symbol rate. The valid range is defined by the instrument TSOVu is connected to.
Returns The query version of this command returns an NR3 value of the symbol rate.
Examples HORIZONTAL:SRATE 2.5E+9 sets the symbol rate to be 2.5 G. HORIZONTAL:SRATE? might return HORIZONTAL:SRATE 2.5000000000E+9
HORizontal:PSYNc
Description

TSO8 Series Programmer Manual

This command sets or queries pattern sync. Setting pattern sync to Off puts the instrument in eye mode.
Syntax HORizontal:PSYNc {ON | OFF | 1 | 0}
Related Commands HORizontal:FPATtern
Arguments ON or 1 turns on pattern sync OFF or 0 turns off pattern sync
Returns The query version of this command returns 1 or 0.
Examples HORIZONTAL:PSYNC ON sets Pattern Sync to be on. HORIZONTAL:PSYNC? might return HORIZONTAL:PSYNC 0 indicating that pattern sync is Off.
HORizontal:DCRAtio
Description This command sets or queries the data-to-clock ratio (<data rate>,<clock rate>). The first <NR1> value represents the data rate and the second <NR1> value represents the clock rate.
Syntax :HORizontal:DCRAtio <NR1>,<NR1>
Related Commands :TRIGger:PSYNc:DCRAtio
Arguments <NR1> (first argument) sets the data rate. <NR1> (second argument) sets the clock rate.
The valid Data Rate:Clock Rate ratios are 1:1 2:1 4:1 8:1 16:1 32:1
Returns The query version of this command returns two commas separated NR1 values, the first being Data Rate and the second being Clock Rate.
Examples · :HORIZONTAL:DCRATIO 2,1 sets the data-to-clock ratio as 2:1. · :HORIZONTAL:DCRATIO? might return :HORIZONTAL:DCRATIO 16,1 indicating a data-to-clock ratio of 16:1.
:HORizontal:REF<x>[:MAIN]:RESolution? (Query Only)
Description

TSO8 Series Programmer Manual

This query only command returns the current resolution per sample of the reference waveform.
Syntax :HORizontal:REF<x>[:MAIN]:RESolution?
Related Commands :HORizontal:REF<x>[:MAIN]:RECordlength? :HORizontal:REF<x>[:MAIN]:SCALe?
Returns This query returns an NR3 value representing the current resolution per sample of the reference waveform.
Examples :HORIZONTAL:REF1:RESOLUTION? might return “:HORIZONTAL:REF1:RESOLUTION 16.6666668892E-12”, indicating 16.667ps between each sample in the reference waveform.
:HORizontal:REF<x>[:MAIN]:RECordlength? (Query Only)
Description This query only command returns the record length of the reference waveform.
Syntax :HORizontal:REF<x>[:MAIN]:RECordlength?
Related Commands :HORizontal:REF<x>[:MAIN]:RESolution? :HORizontal:REF<x>[:MAIN]:SCALe?
Returns The NR3 value representing the record length of the reference waveform.
Examples :HORIZONTAL:REF1:RECORDLENGTH? might return “:HORIZONTAL:REF1:RECORDLENGTH 327.6400000000E+3” indicating a record length of 327,640 samples.
:HORizontal:REF<x>[:MAIN]:SCALe? (Query Only)
Description This query only command returns the horizontal scale (time per division) of the specified reference waveform.
Syntax :HORizontal:REF<x>[:MAIN]:SCALe?
Related Commands :HORizontal:REF<x>[:MAIN]:RESolution? :HORizontal:REF<x>[:MAIN]:RECordlength?
Returns The NR3 value representing the horizontal scale of the specified reference waveform.
Examples

TSO8 Series Programmer Manual

:HORIZONTAL:REF1:SCALE? might return “:HORIZONTAL:REF1:SCALE 15.4318439998E-9” indicating 15.43ns per division for the horizontal scale.
:HORizontal:REF<x>[:MAIN]:TOFPoint? (Query Only)
Description This query only command returns time of first point of the specified reference waveform.
Syntax :HORizontal:REF<x>[:MAIN]:TOFPoint?
Returns The NR3 value representing the time of first point of the reference waveform.
Examples :HORIZONTAL:REF3:TOFPOINT? might return “:HORIZONTAL:REF1:TOFPOINT 0.0000” indicating a time of first point of 0s.
Limitations If the reference waveform specified is a waveform database, this command will return the IEEE standard value for Not a Number.
Licensing Command Group
LICense:COUNt?
Description This query returns a count of the number of active licenses installed.
Syntax LICense:COUNt?
Returns A count of the number of active licenses installed.
Examples LICENSE:COUNT? might return :LICENSE:COUNT 2 indicating that 2 active licenses are installed.
LICense:APPID?
Description This query returns a comma-separated list of the active application IDs.
Syntax LICENSE:APPID?
Returns This query returns a comma-separated list of the active application IDs.
Examples LIC:APPID? might return :LICENSE:APPID “NRZ,PAM4,” which is a complete list of the active applications.

TSO8 Series Programmer Manual

LICense:ITEM?
Description This query returns the nomenclatures, type, descriptions, checked out date, License ID to a specific license. The NR1 argument is zero-indexed. If no argument is provided, zero is assumed.
Syntax LICense:ITEM? <NR1>
Arguments <NR1> is the zero-indexed argument specifying a specific license.
Returns This query returns the nomenclatures, type, descriptions, checked out date, License ID to a specific license.
Examples LICENSE:ITEM? 1 might return LICENSE:ITEM0 “TSO8SW-NL1-NRZ,Fixed,2/4/2020 9:15:43 AM,949667294,””NRZ””,””ENGINEERING LICENSE – License; NRZ Optical Measurements; NodeLocked 1-Year Subscription”””
LICense:LIST?
Description This query returns the active license nomenclatures as a comma-separated list of strings. Duplicate nomenclatures, that is, the same license but with different expiration dates, are included.
Syntax LICense:LIST?
Returns The active license nomenclatures as a comma-separated list of strings.
Examples LICENSE:LIST? might return :LICENSE:LIST “TSO8SW-FL1-PAM4-O,Floating,ENGINEERING LICENSE – License; PAM4 Optical Measurements; Floating 1-Year Subscription, TSO8SW-NL1-PAM4-O,Fixed,ENGINEERING LICENSE – License; PAM4 Optical Measurements; NodeLocked 1-Year Subscription”
LICense:HID?
Description This query returns the TSOVu HostID unique identifier.
Syntax LICense:HID?
Returns The TSOVu HostID unique identifier.
Examples LICENSE:HID? might return LICENSE:HID “TSO-JVSCGZBGK4PJYKH5”

TSO8 Series Programmer Manual

LICense:INSTall:FILE
Description This command accepts a <File_Path> string with license path and installs it on the instrument.
Syntax LICense:INSTall:FILE “<File_Path>”
Arguments <File_Path> is the license file name with path.
Examples :LICense:INSTall:FILE “C:UserssacbDocumentsLicense-_-_TSO-B4SSD2AHTU2AFPFL_TSO8SWNLP-PAM4-O_ENTER (1).LIC”
LICense:INSTall:OPTion
Description This command sets or queries the current selection for license installation. If TSOVu is the selected option, then the license shall be installed on the host application. If INSTrument is the selected option, then the license shall be installed on the connected instrument.
Syntax LICense:INSTall:OPTion {TSOVu | INSTrument} LICense:INSTall:OPTion?
Arguments TSOVu sets the license to be installed on the host application. INSTrument sets the license to be installed on the connected instrument.
Returns TSOVu means the license is set to be installed on the host application. INSTrument means the license is set to be installed on the connected instrument
Examples LICense:INSTall:OPTion? might return TSOVU, indicating that the license will be installed on the host application, which is TSOVu. LICense:INSTall:OPTion INSTrument might set the current install option to connected instrument and any subsequent license installation shall be done on that connected instrument.
LICense:UNINSTALL?
Description Returns the exit license indicated for the user to return to their TekAMS account. License ID can be used to specify uninstalled license. the exit-license is returned as block-data.
Syntax LICense:UNINSTALL? “<License ID>”
Arguments <License ID> License ID of the installed license.
Returns

TSO8 Series Programmer Manual

The exit-license is returned as block-data.
Examples LIC:UNINSTALL? “569765772” uninstalls the license with the given license ID and returns the license block data.
Measurement Command Group
:MEASUrement:ADDMEAS
:MEASUrement:ADDMEAS <string_category>,<string_name>,<source1>[,<source2>] [,<meas[x]>] Description This command adds a measurement from the specified category on the given source or sources with specified measurement ID.
Syntax :MEASUrement:ADDMeas <category>, <measType>, { M[n]{A|B} | MATH[x] | REF[x] } [, { M[n]{A|B} | MATH[x] | REF[x] } ] [, MEAS[x] ] Arguments <category> is the name of the measurement group <measType> is the type of an available measurement as a quoted string
{ M[n]{A|B} | MATH[x] | REF[x] } is the primary source for the measurement: · M[n]{A|B} selects a channel waveform source. · MATH[x] selects a math waveform source. · REF[x] selects a reference waveform source.
{ M[n]{A|B} | MATH[x] | REF[x] } is the optional secondary source for the measurement (e.g., for delay measurements). It follows the conventions of the primary source.
{ MEAS[x] } is the optional measurement ID the user wants to create the measurement on.
See “:MEASUrement:MEAS<x>:SOUrce<x>” for details on valid source names
Examples MEASUREMENT:ADDMeas “PAM4”, “RLM”,REF1 adds a RLM measurement on Ref1 MEASUREMENT:ADDMeas “PAM4”, “RLM”,M1A, MEAS7 adds a RLM measurement on M1A with measurement ID 7 MEASUREMENT:ADDMeas “PAM4”, “RLM”,M1A, M1B, MEAS10 adds a RLM measurement on M1A with measurement ID 10 MEASUREMENT:ADDMeas “PAM4”, “TDECQ”, M1A, MEAS1 adds a TDECQ measurement on M1A with measurement ID 1 MEASUREMENT:MEAS1:PLOT:STATe “Equalized Eye”, ON; add an Equalized Eye diagram for the TDECQ measurement with measurement ID 1
Limitations The selected source must exist and be active for the measurement to be created successfully.
:MEASUrement:MEAS<x>:TYPe?

TSO8 Series Programmer Manual

Description This query-only command returns a measurement type as a string, for a measurement specified by <x>.
Syntax MEASUrement:MEAS<x>:TYPe?
Returns Type of the given measurement
Examples MEASUREMENT:MEAS1:TYPE? might return :MEASUREMENT:MEAS1:TYPE “RMS” indicating that measurement 1 is defined to measure the “RMS” value of a waveform.
:MEASUrement:MEAS<x>:SOUrce<y>
Description This command sets or queries the source for all single channel measurements and specifies the reference source to measure “to” when taking a delay measurement or phase measurement. Measurements are specified by <x>. This command is equivalent to selecting Measurement Setup from the Measure menu, selecting a measurement type of either Phase or Delay, and then choosing the desired measurement source. Tip: Source2 measurements apply only to phase and delay measurement types, which require both a target (Source1) and reference (Source2) source.
Syntax MEASUrement:MEAS<x>:SOUrce<y> <source>
Arguments <source> can be one of: M<n>A|B selects a channel waveform as the source or destination waveform. MATH<x> selects a math waveform as the source REF<x> selects a reference waveform as the source
Returns the quoted string source of the specified measurement
Examples MEASUREMENT:MEAS2:SOURCE1 MATH1 sets MATH1 as the source waveform for Measurement 2 MEASUREMENT:MEAS7:SOURCE1 M2A sets channel A on module 2 as the source waveform for Measurement 7 MEASUREMENT:MEAS7:SOURCE1? might return MEASUREMENT:MEAS7:SOURCE1 REF1 indicating that the first source for Measurement 7 is Ref 1
:MEASUrement:MEAS<x>:LABel
Description This command sets or queries the label for the measurement. The measurement number is specified by <x>.
Syntax MEASUrement:MEAS<x>:LABel <QString>
Arguments <QString> is the quoted string measurement label.

TSO8 Series Programmer Manual

Returns the quoted string label of the specified measurement
Examples MEASUREMENT:MEAS1:LABel “Delay” sets the label to Delay. MEASUrement:MEAS1:LABel? might return :MEASUREMENT:MEAS1:LABEL “Peak-to-Peak” indicating that the measurement 1 label is Peak-to-peak.
:MEASUrement:MEAS<x>:VALue? [<string_attribute>] (Query Only)
Description This query-only command returns the value that is calculated for the measurement specified by <x>.
Syntax MEASUrement:MEAS<x>:VALue? [<string_attribute>] Arguments [<string_attribute>] optionally the quoted string name of the desired result attribute. This is required for measurements with multiple attributes. Measurements with a single result do not require an attribute to be specified.
Returns NR3 the value of the specified measurement for present acquisition if source is reference waveform NR3 the value of the specified measurement across acquisitions if source is live waveform
Examples MEASUREMENT:MEAS1:VALUE? might return :MEASUREMENT:MEAS1:VALUE 2.8740E-06. If the Measurement has an error or warning associated with it, then an item is added to the error queue. The error can be checked for with the *ESR? and ALLEv? commands. MEASUREMENT:MEAS4:VALUE? “L3” might return MEASUREMENT:MEAS4:VALUE “L3”,5.89248655395E-003, indicating that the value for the “L3” attribute of Meas 4 is 5.892 mV
:MEASUrement:MEAS<x>:MAXimum? [<string_attribute>] (Query Only)
Description This query only command returns the maximum value found for the measurement slot specified by x, since the last statistical reset. Measurements with a single result do not require an attribute to be specified. Measurements with multiple attributes require a specified attribute. Tip: To find available result attributes for a measurement, use the query MEASUrement:MEAS[x]:RESult:ATTR?
Syntax MEASUrement:MEAS<x>:MAXimum? [<string_attribute>] Arguments [<string_attribute>] optionally the quoted string name of the desired result attribute. This is required for measurements with multiple attributes. Measurements with a single result do not require an attribute to be specified.
Returns NR3 the maximum value for present acquisition if source of measurement is reference waveform. NR3 the maximum value across acquisitions if source of measurement is live waveform.
Examples

TSO8 Series Programmer Manual

MEASUREMENT:MEAS3:MAXIMUM? might return MEASUREMENT:MEAS3:MAXIMUM 4.27246105395E-003, indicating that the maximum value for Meas 3 is 4.272 mV MEASUREMENT:MEAS9:MAXIMUM? “L3” might return MEASUREMENT:MEAS9:MAXIMUM “L3”,7.23248678995E-003, indicating that the maximum value for the “L3” attribute of Meas 9 is 7.232 mV
:MEASUrement:MEAS<x>:GATing:STATE
Description This command sets or queries the gating setting for the given measurement. Measurements are specified by <x>. This command is equivalent to opening the Measurement configuration menu and setting gating to enabled ON of OFF.
Syntax MEASUrement:MEAS<x>:GATing:STATE { ON | OFF | 0 | 1 } MEASUrement:MEAS<x>:GATing:STATE?
Arguments ON or any other non-zero value enables gating OFF or 0 disables gating
Returns 0 or 1 indicating state of gating of the specified measurement is OFF or ON respectively
Examples MEASUREMENT:MEAS2:GATING:STATE ON sets gating for MEAS2’s gating to enabled (ON) MEASUREMENT:MEAS1:GATING:STATE OFF sets gating for MEAS1’s gating to enabled (OFF) MEASUREMENT:MEAS3:GATING:STATE 0 sets gating for MEAS3’s gating to enabled (OFF) MEASUREMENT:MEAS2:GATING:STATE? Might return MEASUREMENT:MEAS2:GATING:STATE 0 meaning that gating for MEAS2’s is disabled (OFF)
:MEASUrement:MEAS<x>:CONfig:ATTRibutes? (Query only)
Description This command returns a list of measurement specific attributes by name for the given measurement. Measurements are specified by <x>. This command is equivalent to double-clicking the measurement badge, opening the Measurement configuration subcategory in the menu, and viewing configuration attributes.
Syntax MEASUrement:MEAS<x>:CONfig:ATTRibutes?
Returns a comma separated list of configuration attribute names or an empty string if the specified measurement has no specified attributes
Examples :MEASUREMENT:MEAS1:CONFIG:ATTRIBUTES? might return :MEASUREMENT:MEAS1:CONFIG:ATTRIBUTES “TrackingMethod” to indicate the measurement configuration attribute is “TrackingMethod”.
:MEASUrement:MEAS<x>:CONfig <string_attribute>,<value>
Description

TSO8 Series Programmer Manual

This command returns or sets the value of a measurement specific configuration attribute for the given measurement. Measurements are specified by <x>. The configuration attribute is specified by its string name. The query returns the attribute string name and the value of a configuration attribute separated by a comma. The command sets the configuration value to the input value, if the input is valid (of correct type and/or range, where applicable), and the specific attribute is configurable (in some cases attributes may be read-only). This command is equivalent to double-clicking the measurement badge, opening the Measurement configuration subcategory in the menu, viewing configuration attributes and their values, and setting a non-read-only configuration attribute. Tip: Measurement attributes are specific to each measurement, use the query MEASUrement:MEAS<x>:CONfig:ATTRibutes? to find a measurement’s available attributes.
Syntax MEASUrement:MEAS<x>:CONfig <string_attribute>,{<QString>|<NR3>|<Boolean>} MEASUrement:MEAS<x>:CONfig? <string_attribute> Arguments <string_attribute> is the measurement attribute name as a quoted string <QString> if applicable, an attribute may be set to a string value <NR3> if applicable, an attribute may be set to a numeric value Returns The value of the configuration attribute as an NR3, quoted string, or boolean.
Examples :MEASUrement:MEAS1:CONfig “TrackingMethod”,”Min/Max” sets the Tracking Method to Min/Max :MEASUrement:MEAS1:CONfig? “TrackingMethod” might return :MEASUREMENT:MEAS1:CONFIG “TrackingMethod”,”Auto”
MEASUrement:MEAS<x>:RESults:ATTRibutes? (Query only)
Description This command returns a list of measurement specific attributes by name for the given measurement. Measurements are specified by <x>. This command is equivalent to double-clicking the measurement badge, opening the Measurement configuration subcategory in the menu, and viewing configuration attributes.
Syntax MEASUrement:MEAS<x>:RESults:ATTRibutes?
Returns A string containing a comma separated list of result attributes or an empty string if no result attributes are specified for the measurement.
Examples MEASUREMENT:MEAS2:RESULTS:ATTRIBUTES? might return MEASUREMENT:MEAS2:RESULTS:ATTRIBUTES “Level1,Level2,Level3,Level4” MEASUREMENT:MEAS2:RESULTS:ATTRIBUTES? might return MEASUREMENT:MEAS2:RESULTS:ATTRIBUTES “” indicating no result attributes are specified
MEASUrement:MEAS<x>:GATE[1|2]:PCTPOS
Description This command or query sets or returns a measurement’s gate’s position. Chosen Measurement is specified by value given for <x>. The Gate can be 1 or 2. Tip: a gate cannot be set unless gating for that measurement has been enabled (with MEASUrement:MEAS<x>:GATing ON command)

TSO8 Series Programmer Manual

Syntax MEASUrement:MEAS<x>:GATE[1|2]:PCTPOS? MEASUrement:MEAS<x>:GATE[1|2]:PCTPOS <NR1>
Arguments <NR1> a numeric value for the position of the specified gate as a percentage
Returns A numeric value for the position of the specified gate as a percentage
Examples MEASUREMENT:MEAS2:GATE1:PCTPOS 27 sets gate position to 27% of total display MEASUREMENT:MEAS2:GATE1:PCTPOS? Could return MEASUREMENT:MEAS1:GATE1:PCTPOS 27 if position was set to 27% of total display
:MEASUrement:MEAS<x>:MINimum? [<string_attribute>] (Query Only)
Description This query only command returns the minimum value found for the measurement slot specified by x, since the last statistical reset. Measurements with a single result do not require an attribute to be specified. Measurements with multiple attributes require a specified attribute. Tip: To find available result attributes for a measurement, use the query MEASUrement:MEAS[x]:RESult:ATTR?
Syntax MEASUrement:MEAS<x>:MINimum? [<string_attribute>] Arguments [<string_attribute>] optionally the quoted string name of the desired result attribute. This is required for measurements with multiple attributes. Measurements with a single result do not require an attribute to be specified.
Returns NR3 the minimum value for present acquisition if source of measurement is reference waveform. NR3 the minimum value across acquisitions if source of measurement is live waveform.
Examples MEASUREMENT:MEAS4:MINIMUM? might return MEASUREMENT:MEAS4: MINIMUM 4.27246105395E-003, indicating that the minimum value for Meas 4 is 4.272 mV MEASUREMENT:MEAS3:MINIMUM? “L3” might return MEASUREMENT:MEAS3:MINIMUM “L3”,5.89248655395E-003, indicating that the minimum value for the “L3” attribute of Meas 3 is 5.892 mV
:MEASUrement:MEAS<x>:MEAN? [<string_attribute>] (Query Only)
Description This query only command returns the mean value found for the measurement slot specified by x, since the last statistical reset. Measurements with a single result do not require an attribute to be specified. Measurements with multiple attributes require a specified attribute. Tip: To find available result attributes for a measurement, use the query MEASUrement:MEAS<x>:RESult:ATTR?
Syntax MEASUrement:MEAS<x>:MEAN? [<string_attribute>]

TSO8 Series Programmer Manual

Arguments [<string_attribute>] optionally the quoted string name of the desired result attribute. This is required for measurements with multiple attributes. Measurements with a single result do not require an attribute to be specified.
Returns NR3 the mean value for present acquisition if source of measurement is reference waveform NR3 the mean value across acquisitions if source of measurement is live waveform
Examples MEASUREMENT:MEAS2:MEAN? might return MEASUREMENT:MEAS2:MEAN 3.14146105395E-003, indicating that the mean value for Meas 2 is 3.141 mV MEASUREMENT:MEAS4:MEAN? “L3” might return MEASUREMENT:MEAS4:MEAN “L3”,4.12348655395E-003, indicating that the mean value for the “L3” attribute of Meas 4 is 4.123 mV
:MEASUrement:MEAS<x>:STDdev? [<string_attribute>] (Query Only)
Description This query only command returns the standard deviation value found for the measurement slot specified by x, since the last statistical reset. Measurements with a single result do not require an attribute to be specified. Measurements with multiple attributes require a specified attribute. Tip: To find available result attributes for a measurement, use the query MEASUrement:MEAS<x>:RESult:ATTR?
Syntax MEASUrement:MEAS<x>:STDdev? [<string_attribute>] Arguments [<string_attribute>] optionally the quoted string name of the desired result attribute. This is required for measurements with multiple attributes. Measurements with a single result do not require an attribute to be specified.
Returns NR3 the standard deviation value for present acquisition if source of measurement is reference waveform. NR3 the standard deviation value across acquisitions if source of measurement is live waveform.
Examples MEASUREMENT:MEAS2:STDdev? might return MEASUREMENT:MEAS2:STDDEV 5.80230767128E 009, indicating that the standard deviation value for Meas 2 is 5.80 ns. MEASUREMENT:MEAS4:STDdev? “L3” might return MEASUREMENT:MEAS4:STDDEV “L3”,1.16796169259E-011, indicating that the standard deviation for the “L3” attribute of Meas 4 is 11.68 ps.
:MEASUrement:MEAS<x>:PK2PK? [<string_attribute>] (Query Only)
Description This query only command returns the peak-to-peak value found for the measurement slot specified by x, since the last statistical reset. Measurements with a single result do not require an attribute to be specified. Measurements with multiple attributes require a specified attribute. Tip: To find available result attributes for a measurement, use the query MEASUrement:MEAS<x>:RESult:ATTR?
Syntax

TSO8 Series Programmer Manual

MEASUrement:MEAS<x>:PK2PK? [<string_attribute>] Arguments [<string_attribute>] optionally the quoted string name of the desired result attribute. This is required for measurements with multiple attributes. Measurements with a single result do not require an attribute to be specified.
Returns NR3 the peak-to-peak value for present acquisition if source of measurement is reference waveform. NR3 the peak-to-peak value across acquisitions if source of measurement is live waveform.
Examples MEASUREMENT:MEAS2:PK2PK? might return MEASUREMENT:MEAS2:PK2PK 200.0E-3 indicating the peak-to-peak value for Meas 2 is 200 mV. MEASUREMENT:MEAS4:PK2PK? “L3” might return MEASUREMENT:MEAS4:PK2PK “L3”,4.000E-3, indicating that the peak-to-peak value for the “L3” attribute of Meas 4 is 400 mV.
:MEASUrement:MEAS<x>:DELEte
Description This command deletes the specified measurement. If the measurement specified by <x> does not exist or is not able to be deleted, an error will be reported.
Syntax MEASUrement:MEAS<x>:DELEte
Examples MEASUREMENT:MEAS2:DELETE will delete measurement 2.
:MEASUrement:DELEte:ALL
Description This command deletes all measurements. If a measurement is not able to be deleted, an error will be reported.
Syntax MEASUrement:DELEte:ALL
Examples MEASUREMENT:DELETE:ALL will delete all measurements.
:MEASUrement:MEAS<x>:COUNt? [<string_attribute>] (Query Only)
Description This query only command returns the count of the result values found for the measurement slot specified by x, since the last statistical reset. Measurements with a single result do not require an attribute to be specified. Measurements with multiple attributes require a specified attribute. Tip: To find available result attributes for a measurement, use the query MEASUrement:MEAS<x>:RESult:ATTR?
Syntax MEASUrement:MEAS<x>:COUNt? [<string_attribute>] Arguments

TSO8 Series Programmer Manual

[<string_attribute>] optionally the quoted string name of the desired result attribute. This is required for measurements with multiple attributes. Measurements with a single result do not require an attribute to be specified.
Returns An integer value count of the result values of a given measurement or measurement’s attribute for present acquisition if source is reference waveform. An integer value count of the result values of a given measurement or measurement’s attribute across acquisitions if source is live waveform.
Examples MEASUREMENT:MEAS3:COUNT? might return MEASUREMENT:MEAS3:COUNT 1, indicating that the count of result values for Meas 3 is 1 MEASUREMENT:MEAS9:COUNT? “L3” might return MEASUREMENT:MEAS9:COUNT “L3”,39, indicating that the count of result values for the “L3” attribute of Meas 9 is 39
:MEASUrement:MEAS<x>:STATus? (Query Only)
Description This query-only command returns a measurement Info (Error/Warning) as a string, for a measurement specified by <x>.
Syntax :MEASUrement:MEAS<x>:STATus?
Returns Error/Warning information of the given measurement.
Examples MEASUREMENT:MEAS1:STATus? might return Error/Warning for the selected measurement, if any.
:MEASUrement:MEAS<n>:PLOT:STATe
Description This command sets or gets the state of the plot named <plot_name> for measurement specified by <n>.
Syntax MEASUrement:MEAS<n>:PLOT:STATe <plot_name>,{ ON | OFF | 0 | 1 } MEASUrement:MEAS<n>:PLOT:STATe? <plot_name>
Arguments <plot_name> is the plot attribute name as a quoted string ON or any other non-zero value enables the plot OFF or 0 disables the plot
Returns 0 or 1 indicating state of the plot of the specified measurement is OFF or ON respectively
Examples MEASUREMENT:MEAS2:PLOT:STATE “Equalized Eye”,ON turns on the Equalized Eye plot when TDECQ measurement is added as MEAS2 MEASUREMENT:MEAS1:PLOT:STATE “Equalized Eye”,0 turns off the Equalized Eye plot when TDECQ measurement is added as MEAS1

TSO8 Series Programmer Manual

MEASUREMENT:MEAS1:PLOT:STATE? “Equalized Eye” might return MEASUREMENT:MEAS1:PLOT:STATE “Equalized Eye”,0 meaning that the plot for MEAS1 is turned off
MEASUrement:MEAS<x>:RLEVel:ATTRibutes? (Query Only)
Description This query only command returns a list of the names of the ref level attributes available for the measurement slot specified by x.
Syntax MEASUrement:MEAS<x>:RLEVel:ATTRibutes?
Related Commands MEASUrement:MEAS<x>:RLEVel [<stringAttributes>] Returns A comma separated list of the names of the ref level attributes available for the measurement slot specified by x
Examples MEASUREMENT:MEAS3:RLEVEL:ATTRIBUTES? might return MEASUREMENT:MEAS3:RLEVEL:ATTRIBUTES “High”,”Mid”,”Low”, indicating that there are 3 reference levels, named “High”,”Mid”, and “Low”, available to query and set for the measurement 3 MEASUREMENT:MEAS9:RLEVEL:ATTRIBUTES? might return MEASUREMENT:MEAS9:RLEVEL:ATTRIBUTES “Mid”, indicating that there is a single reference level with the name “Mid” available to query and set for Measurement 9.
MEASUrement:MEAS<x>:RLEVel:METHod
Description This command sets or queries the method the instrument uses to calculate the reference levels for a specified measurement taken on a specified source waveform. The measurement slot is specified by x.
Syntax MEASUrement:MEAS<x>:RLEVel:METHod {RELative | ABSolute } MEASUrement:MEAS<x>:RLEVel:METHod?
Related Commands MEASUrement:MEAS<x>:RLEVel?
Arguments · RELative calculates the reference levels as a percentage of the High/Low amplitude (High amplitude minus the Low amplitude). The default values are 90% for the high reference level, 10% for the low reference level, and 50% for the mid reference levels. You can set other percentages using the MEASUrement:MEAS:RLEVel:RELative commands. · ABSolute uses reference levels set explicitly in absolute user units with the MEASUrement:MEAS:RLEVel:ABSolute commands (see related commands above). This method is useful when precise values are required (for example, when you are designing to published interface specifications such as RS-232-C). The default values are 0 V for the high reference level, the low reference level, and the mid reference levels.
Returns RELATIVE or ABSOLUTE

TSO8 Series Programmer Manual

Examples MEASUREMENT:MEAS1:RLEVEL:METHOD RELATIVE sets the method of calculating the reference levels to relative for Measurement 1; MEASUREMENT:MEAS8:RLEVEL:METHOD? might return MEASUREMENT:MEAS8:RLEVEL:METHOD ABSOLUTE, indicating the reference levels used are set to absolute values in user units.
MEASUrement:MEAS<x>:RLEVel <stringAttribute>
Description This command sets or queries reference level for the specified measurement. If the reference level method is set to ABSOLUTE, this command will set or query the given reference level in absolute user units for the specified measurement. If the reference level method is set to RELATIVE, this command will set or query the value as a percent of the High/Low range that the instrument uses to calculate the given reference level for the specified measurement, where 100% is equal to the High/Low range. The measurement slot is specified by x. And the reference level is specified by it’s <stringAttribute> name. When a measurement has multiple reference levels the reference level attribute name must be specified. If the measurement has a single reference level, providing the attribute name is not required.
Tip: To Find a list of available reference level attribute names for the given measurement use the MEASUrement:MEAS<x>:RLEVel:ATTRibutes? query. Set or query the reference level method by using the command MEASUrement:MEAS<x>:RLEVel:METHod
Syntax MEASUrement:MEAS<x>:RLEVel [<stringAttribute>],<NR3> MEASUrement:MEAS<x>:RLEVel [<stringAttribute>] Related Commands MEASUrement:MEAS<x>:RLEVel:METHod MEASUrement:MEAS<x>:RLEVel:ATTRibutes?
Arguments <stringAttribute> is the reference level by name to set or query NR3 can be from 0 to 100 (percent) and is the given reference level.
Returns When Method is set to ABSOLUTE, NR3 is the given reference level in absolute user units. When in Method is set to RELATIVE, NR3 is the given reference level as a percentage (value 0-100) of the High/Low Range.
Examples When the Reference Level method is set to RELATIVE the command MEASUREMENT:MEAS3:RLEVEL “High”,20 sets the “High” reference level for Measurement 3 to 20% of the High/Low range. When the Reference Level method is set to RELATIVE the query MEASUREMENT:MEAS2:RLEVEL? “Mid” might return MEASUREMENT:MEAS2:RLEVEL “Mid”,10, indicating that the “Mid” reference level for Measurement 2 is set to 10% of the High/Low range.
When the Reference Level method is set to ABSOLUTE the command MEASUREMENT:MEAS3:REFLEVEL “High”,4.0E2 sets the “High” reference level for Measurement 3 to 40 mV.

TSO8 Series Programmer Manual

When the Reference Level method is set to ABSOLUTE the query MEASUREMENT:MEAS2:REFLEVEL? “Mid” might return MEASUREMENT:MEAS2:REFLEVEL “Mid”,5.0000000000E2, indicating that the “Mid” reference level for Measurement 2 is set to 50 mV.
MEASUrement:MEAS<x>:CONfig:ATTRibutes?
Description This command returns the value of a measurement specific configuration attribute for the given measurement. Measurements are specified by <x>. The query returns the attribute string name and the value of a configuration attribute separated by a comma.
Syntax MEASUrement:MEAS<x>:CONfig:ATTRibutes?
Returns The value of the configuration attribute as an NR3, quoted string, or boolean.
Examples :MEASUrement:MEAS1:CONfig:ATTRibutes? might return “TrackingMethod”,”Auto”.
:MEASUrement:MEAS<x>:CONfig <string_attribute>,<value>
Description This command returns or sets the value of a measurement specific configuration attribute for the given measurement. Measurements are specified by <x>. The configuration attribute is specified by its string name. Measurement specific attribute(s): “TrackingMethod” Measurement specific attribute values: “Auto”, “Mean”, “Mode”, “Min/Max”
Syntax :MEASUrement:MEAS<x>:CONfig <string_attribute>,<value>
Returns The value of the configuration attribute as quoted string.
Examples :MEASUrement:MEAS1:CONfig:ATTRibutes? might return “TrackingMethod”,”Auto”.
:MEASUrement:ADDMEAS “PULSE”,”PCross”,<source1>[,<source2>] See :MEASUrement:ADDMEAS
:MEASUrement:ADDMEAS “PULSE”,”PWidth”,<source1>[,<source2>] See :MEASUrement:ADDMEAS
:MEASUrement:ADDMEAS “PULSE”,”RMSJitter”,<source1>[,<source2>] See :MEASUrement:ADDMEAS
:MEASUrement:ADDMEAS “PULSE”,”Pk-PkJitter”,<source1>[,<source2>] See :MEASUrement:ADDMEAS
:MEASUrement:ADDMEAS “PULSE”,”Delay”,<source1>,<source2>
See :MEASUrement:ADDMEAS

TSO8 Series Programmer Manual

:MEASUrement:ADDMEAS “PULSE”,”NCross”,<source1>[,<source2>] See :MEASUrement:ADDMEAS
Adding Level deviation measurement on a source
Description This command adds level deviation measurement from PAM4 category on the given source with specified measurement ID
Syntax MEASUREMENT:ADDMeas “PAM4″,”LDeviation”,{M[n]{A|B} | REF[x]}[, MEAS[x] ] Examples MEASUREMENT:ADDMeas “PAM4″,”LDeviation”,M1A MEASUREMENT:ADDMeas “PAM4″,”LDeviation”,Ref1 MEASUREMENT:ADDMeas “PAM4″,”LDeviation”,Ref1,MEAS20
Adding Level Thickness measurement on a source
Description This command adds level thickness measurement from PAM4 category on the given source with specified measurement ID
Syntax MEASUREMENT:ADDMeas “PAM4″,”LThickness”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “PAM4″,”LThickness”,M1A MEASUREMENT:ADDMeas “PAM4″,”LThickness”,Ref1 MEASUREMENT:ADDMeas “PAM4″,”LThickness”,Ref1,MEAS2
Adding Eye Width measurement on a source
Description This command adds Eye width measurement from PAM4 category on the given source with specified measurement ID
Syntax MEASUREMENT:ADDMeas “PAM4″,”EyeWidth”,{M[n]{A|B} | REF[x]}[, MEAS[x] ] Examples MEASUREMENT:ADDMeas “PAM4″,”EyeWidth”,M1A MEASUREMENT:ADDMeas “PAM4″,”EyeWidth”,Ref1 MEASUREMENT:ADDMeas “PAM4″,”EyeWidth”,Ref1,MEAS20

Querying results of Eye Width measurement
Description
Eye width measurement gives following results for all 3 PAM4 eyes – Threshold

TSO8 Series Programmer Manual

– Width
Syntax MEASUREMENT:MEAS<x>VALue? [<string_attribute>] (Query Only)
Arguments String attribute will be Upper Eye threshold — “ThreshU” Upper Eye width – “WidthU” Middle Eye threshold – “ThreshM” Middle Eye width – “WidthM” Lower Eye threshold – “ThreshL” Lower Eye width – “WidthL”
Returns “ThreshU” returns the threshold of upper eye at which eye width is computed “WidthU” returns the width of upper eye at the “ThreshU” “ThreshM” returns the threshold of upper eye at which eye width is computed “WidthM” returns the width of upper eye at the “ThreshM” “ThreshL” returns the threshold of upper eye at which eye width is computed “WidthL” returns the width of upper eye at the “ThreshL”
Examples MEASUREMENT:MEAS1:VALUE? “ThreshU” MEASUREMENT:MEAS1:VALUE? “WidthM”
Adding Eye Height measurement on a source
Description
This command adds Eye height measurement from PAM4 category on the given source with specified measurement ID
Syntax MEASUREMENT:ADDMeas “PAM4″,”EyeHeight”,{M[n]{A|B} | REF[x]}[, MEAS[x] ] Examples MEASUREMENT:ADDMeas “PAM4″,”EyeHeight”,M1A MEASUREMENT:ADDMeas “PAM4″,”EyeHeight”,Ref1 MEASUREMENT:ADDMeas “PAM4″,”EyeHeight”,Ref1,MEAS20
Querying results of Eye height measurement
Description
Eye Height measurement gives following results for all 3 PAM4 eyes – Offset – Height
Syntax MEASUREMENT:MEAS<x>VALue? [<string_attribute>] (Query Only)
Arguments String attribute will be Upper Eye Offset — “OffsetU” Upper Eye Height – “HeightU” Middle Eye Offset — “OffsetM”

TSO8 Series Programmer Manual

Middle Eye Height – “HeightM” Lower Eye Offset — “OffsetM” Lower Eye Height – “HeightM”
Returns “OffsetU” returns the offset of upper eye at which eye height is computed “HeightU” returns the height of upper eye at the “OffsetU” “OffsetM” returns the offset of upper eye at which eye height is computed “HeightM” returns the height of upper eye at the “OffsetM” “OffsetL” returns the offset of upper eye at which eye height is computed “HeightL” returns the height of upper eye at the “OffsetL”
Examples MEASUREMENT:MEAS1:VALUE? “OffsetU” MEASUREMENT:MEAS1:VALUE? “HeightL”
Adding PAM4 Summary on a source
Description
This command adds PAM4 Summary measurement from PAM4 category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “PAM4″,”PAM4Summary”,{M[n]{A|B} | REF[x]}[, MEAS[x] ] Examples
MEASUREMENT:ADDMeas “PAM4″,”PAM4Summary”,M1A MEASUREMENT:ADDMeas “PAM4″,”PAM4Summary”,Ref1 MEASUREMENT:ADDMeas “PAM4″,”PAM4Summary”,Ref1,MEAS20
For Other supported commands(below given), please refer general measurement command group. – Setting label – Setting source – Querying results – Querying statistics of present acquisition
Changing or querying measurement configurations
Description
PAM4 Summary has two configurations that can be set or queried. · ERAdjustPct: Extinction Ratio adjust/correction factor in percentage. It is used by Extinction Ratio measurement in PAM4 Summary · NLOutput: Normalized output. It is used by Levels measurement in PAM4 Summary · RLMMethod: Method for computing of RLM · RLMLevelsMethod: Method of computing Levels measurement for RLM · AOPUnits: Units for AOP.
Syntax Use the following query to get to know the available configurations for the measurement. MEASUrement:MEAS<x>:CONfig:ATTRibutes? (Query only) – This returns the list of available configurations Return: “ERAdjustPct,NLOutput,RLMMethod,AOPUnits,RLMLevelsMethod”

TSO8 Series Programmer Manual

Use the following syntax to set the configuration: MEASUrement:MEAS<x>:CONfig <string_attribute>,{<QString>|<NR3>|<Boolean>}
Arguments ERAdjustPct can take any double value from -100 to 100 NLOutput can take boolean value(True or False) RLMMethod can take the following values: “Cl. 120D.3.1.2”, “Cl. 94.3.12.5.1”, “All” AOPUnits can take the following values: “W”, “dBm” RLMLevelsMethod can take the following values: “Central sample from each UI”, “Central 2UI of longest run length”
Returns Configuration query will return the value set before. Querying “ERAdjustPct” configuration will return the double value set before. Querying “NLOutput” configuration will return the boolean value set before. Querying “RLMMethod” configuration will return the string value set before. Querying “AOPUnits” configuration will return the string value set before. Querying “RLMLevelsMethod” configuration will return the string value set before.
Examples
Setting Configurations: MEASUrement:MEAS1:CONfig “ERAdjustPct”,10.5 MEASUrement:MEAS1:CONfig “NLOutput”,0 MEASUrement:MEAS1:CONfig “NLOutput”,ON MEASUrement:MEAS1:CONfig “NLOutput”,OFF MEASUrement:MEAS1:CONfig “RLMMethod”,”Cl. 120D.3.1.2″
Querying Configurations: MEASUrement:MEAS1:CONfig? “ERAdjustPct” MEASUrement:MEAS1:CONfig? “NLOutput” MEASUrement:MEAS1:CONfig? “RLMMethod”
Querying results of PAM4 Summary measurement
Description PAM4 Summary gives following results
· RLM(Cl. 120D.) – If RLM method is set to All or Cl. 120D.3.1.2 · RLM(Cl. 94.) – If RLM method is set to All or Cl. 94.3.12.5.1 · OMAouter · ER · AOP · T Time · L3 · L2 · L1 · L0
Syntax Querying PAM4 Summary result attributes is done using below command MEASUREMENT:MEAS<x>:RESULTS:ATTRIBUTES?
Querying result of an attribute of PAM4 Summary is done using MEASUREMENT:MEAS<x>VALue? [<string_attribute>] (Query Only)

TSO8 Series Programmer Manual

String attribute can be: · RLM(Cl. 120D.) – If RLM method is set to All or Cl. 120D.3.1.2 · RLM(Cl. 94.) – If RLM method is set to All or Cl. 94.3.12.5.1 · OMAouter · ER · AOP · T Time · L3 · L2 · L1 · L0
Returns PAM4 Summary result attributes query will return “RLM(Cl. 120D.),RLM(Cl. 94.),OMAouter,ER,AOP,T Time,L3,L2,L1,L0”
Depending on the Measurement configuration, RLM(Cl. 120D.) or RLM(Cl. 94.) may not be present.
Querying result of an attribute of PAM4 Summary and return value are given in below table.

string attribute RLM(Cl. 120D.) RLM(Cl. 94.) OMAouter ER AOP T Time L3 L2 L1 L0

return value returns the RLM(Cl. 120D.) result with no unit returns the RLM(Cl. 94.) result with no unit returns the OMA outer result with unit as dBm returns the extinction ratio result with unit configured by user returns the AOP result with unit as ordinate unit of input signal returns the transition time result with unit as abscissa unit of input signal returns the mean of level3 with unit configured by user(normalized or absolute) returns the mean of level2 with unit configured by user(normalized or absolute) returns the mean of level1 with unit configured by user(normalized or absolute) returns the mean of level0 with unit configured by user(normalized or absolute)

Examples MEASUREMENT:MEAS1:VALUE? “RLM(Cl. 120D.)” MEASUREMENT:MEAS1:VALUE? “OMAouter” MEASUREMENT:MEAS1:VALUE? “ER” MEASUREMENT:MEAS1:VALUE? “AOP” MEASUREMENT:MEAS1:VALUE? “T Time” MEASUREMENT:MEAS1:VALUE? “L3” MEASUREMENT:MEAS1:VALUE? “L2” MEASUREMENT:MEAS1:VALUE? “L1” MEASUREMENT:MEAS1:VALUE? “L0”

Adding TPE measurement
Description This command adds TPE measurement from PAM4 category on the given source with specified measurement ID.

TSO8 Series Programmer Manual

Syntax MEASurement:ADDMeas “PAM4”, “TPE”, <source> <measX>
Changing or querying TPE measurement configurations
Use the following query to get to know the available configurations for the measurement. MEASUREMENT:MEAS<x>:CONFIG:ATTRIBUTES? (Query only)
Returns :MEASUREMENT:MEAS1:CONFIG:ATTRIBUTES “HitRatio,TPEUnits,TPEat”
Use the following syntax to set and query the configuration:
Hit ratio: MEASUREMENT:MEAS1:CONFIG “HitRatio”,1e-5 (Set) MEASUREMENT:MEAS1:CONFIG? “HitRatio” (Query)
TPE unit: MEASUREMENT:MEAS1:CONFIG “TPEUnits”, “W” (Set) MEASUREMENT:MEAS1:CONFIG? “TPEUnits” (Query)
TPE at: MEASUREMENT:MEAS1:CONFIG “TPEat”, “Level-0” (Set) MEASUREMENT:MEAS1:CONFIG “TPEat”, “Level-3” (Set) MEASUREMENT:MEAS1:CONFIG? “TPEat ” (Query)
Querying results of TPE measurement
Use the following query to get to know the available attribute for the measurement. MEASUREMENT:MEAS<x>:RESULTS:ATTRIBUTES? (Query only)
Returns :MEASUREMENT:MEAS1:RESULTS:ATTRIBUTES “Oversh.HR,Undersh.HR,TPE”
Use the following syntax to query the results:
Overshoot: MEASUREMENT:MEAS<x>:VALUE? “Oversh.HR” (Query)
Result :MEASUREMENT:MEAS1:VALUE “Oversh.HR”,<result>
Undershoot MEASUREMENT:MEAS<x>:VALUE? “Undersh.HR” (Query)
Result :MEASUREMENT:MEAS1:VALUE “Undersh.HR”,<result>
TPE MEASUREMENT:MEAS<x>:VALUE? “TPE” (Query)
Result :MEASUREMENT:MEAS1:VALUE “TPE”,<result>

TSO8 Series Programmer Manual

Adding TDECQ measurement on a source
Description This command adds TDECQ measurement from PAM4 category on the given source with specified measurement ID.
Syntax MEASurement:ADDMEAS “PAM4″,”TDECQ”,{M[n]{A|B} | REF[x]}[, MEAS[x] ]

Changing or querying TDECQ measurement configurations
Use the following query to get to know the available configurations for the measurement. MEASUREMENT:MEAS<x>:CONFIG:ATTRIBUTES? (Query only)
Returns :MEASUREMENT:MEAS<x>:CONFIG:ATTRIBUTES “VerticalThresholdAdjust,VerticalAdjustLimit,TargetSER,CeqIndB,HistogramWidth,HistogramSpacing,FF EAutoset,ExtendedSearch,FFERecalc,FFELockMainCursor,FFEMainCursorPosition,FFETaps,FFETapsP erUI,FFEMaxPrecursors,FFETapVal”

Use the following syntax to set and query the configuration:

MEASUREMENT:MEAS<x>:CONFIG “<parameter_name>”,<value> MEASUREMENT:MEAS<x>:CONFIG> “<parameter_name>”

Parameter_name VerticalThresholdAdjust VerticalAdjustLimit TargetSER CeqIndB HistogramWidth HistogramSpacing FFEAutoset ExtendedSearch FFERecalc FFELockMainCursor FFEMainCursorPosition FFETaps FFETapsPerUI FFEMaxPrecursors FFETapValues

Type Boolean Double Double Boolean Double Double Boolean Boolean Boolean Boolean Integer Integer Integer Integer Double array

Value 1/true/ON or 0/false/OFF 0 to 3 1e-15 to 1e-2 1/true/ON or 0/false/OFF 0.01 to 0.08 0.08 to 0.12 1/true/ON or 0/false/OFF 1/true/ON or 0/false/OFF 1/true/ON or 0/false/OFF 1/true/ON or 0/false/OFF 0 to FFE number of taps 1 1 to 99 1 or 2 0 to FFE number of taps 1 It can take “FFETaps” number of values

If FFE is executed in MATH and MATH output is given as source for TDECQ, then configurations affecting only FFE are ignored while evaluating TDECQ.

Querying results of TDECQ measurement
Use the following query to get to know the available attribute for the measurement. MEASUREMENT:MEAS<x>:RESULTS:ATTRIBUTES? (Query only)

TSO8 Series Programmer Manual

Returns :MEASUREMENT:MEAS<x>:RESULTS:ATTRIBUTES “AOP,TDECQ,Ceq,SERUpL,SERUpR,SERMidL,SERMidR,SERLoL,SERLoR”
Use the following syntax to query the results:
AOP: MEASUREMENT:MEAS<x>:VALUE? “AOP” (Query only)
TDECQ: MEASUREMENT:MEAS<x>:VALUE? “TDECQ” (Query only)
Ceq:: MEASUREMENT:MEAS<x>:VALUE? “Ceq” (Query only)
SER upper eye left MEASUREMENT:MEAS<x>:VALUE? ” SERUpL” (Query only)
SER upper eye right MEASUREMENT:MEAS<x>:VALUE? ” SERUpR” (Query only)
SER middle eye left MEASUREMENT:MEAS<x>:VALUE? ” SERMidL” (Query only)
SER middle eye right MEASUREMENT:MEAS<x>:VALUE? ” SERMidR” (Query only)
SER lower eye left MEASUREMENT:MEAS<x>:VALUE? ” SERLoL” (Query only)
SER lower eye right MEASUREMENT:MEAS<x>:VALUE? ” SERLoR” (Query only)

Adding NRZ Low measurement
Description This command adds NRZ-Low measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”Low”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”Low”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”Low”,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”Low”,Ref1,MEAS20
Measurement specific configurations: Use the following query to get to know the available configurations for the measurement. MEASUrement:MEAS<x>:CONfig:ATTRibutes? (Query only) – This returns the list of available configurations Return: “TrackingMethod”, “EyeAperture”
Use the following syntax to set the configuration: MEASUrement:MEAS<x>:CONfig <string_attribute>,{<QString>|<NR3>|<Boolean>}

TSO8 Series Programmer Manual

Example: MEASUrement:MEAS1:CONfig ” EyeAperture”,10 MEASUrement:MEAS1:CONfig ” TrackingMethod “,”Mean”
Adding NRZ High measurement
Description This command adds NRZ-High measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”HIGH”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”HIGH”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”HIGH “,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”HIGH “,Ref1,MEAS20
Measurement specific configurations: Use the following query to get to know the available configurations for the measurement. MEASUrement:MEAS<x>:CONfig:ATTRibutes? (Query only) – This returns the list of available configurations Return: “TrackingMethod”, “EyeAperture”
Use the following syntax to set the configuration: MEASUrement:MEAS<x>:CONfig <string_attribute>,{<QString>|<NR3>|<Boolean>} Example: MEASUrement:MEAS1:CONfig “EyeAperture”,10 MEASUrement:MEAS1:CONfig “TrackingMethod”,”Mean”
Adding NRZ ER measurement
Description This command adds NRZ Extinction Ratio (ER) measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”Extinction Ratio”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”Extinction Ratio”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”Extinction Ratio”,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”Extinction Ratio”,Ref1,MEAS20
Measurement specific configurations: Use the following query to get to know the available configurations for the measurement. MEASUrement:MEAS<x>:CONfig:ATTRibutes? (Query only) – This returns the list of available configurations Return: “ERAdjust”, “EyeAperture”, “Units”
Use the following syntax to set the configuration: MEASUrement:MEAS<x>:CONfig <string_attribute>,{<QString>|<NR3>|<Boolean>} Example: MEASUrement:MEAS1:CONfig “EyeAperture “,10 MEASUrement:MEAS1:CONfig “ERAdjust”,”1.56″ MEASUrement:MEAS1:CONfig “Units”,”%”

TSO8 Series Programmer Manual

Adding NRZ Crossing Percentage measurement
Description This command adds NRZ Crossing Percentage measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”PCTCROss”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”PCTCROss”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”PCTCROss”,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”PCTCROss”,Ref1,MEAS20
Measurement specific configurations: Use the following query to get to know the available configurations for the measurement. MEASUrement:MEAS<x>:CONfig:ATTRibutes? (Query only) – This returns the list of available configurations Return: “EyeAperture”
Use the following syntax to set the configuration: MEASUrement:MEAS<x>:CONfig <string_attribute>,{<QString>|<NR3>|<Boolean>} Example: MEASUrement:MEAS1:CONfig “EyeAperture “,10
Adding NRZ Crossing Level measurement
Description This command adds NRZ Crossing Level measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”LEVCROss”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”LEVCROss”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”LEVCROss”,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”LEVCROss”,Ref1,MEAS20
Adding NRZ Crossing Time measurement
Description This command adds NRZ Crossing Time measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”TIMCROss”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”TIMCROss”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”TIMCROss”,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”TIMCROss”,Ref1,MEAS20

TSO8 Series Programmer Manual

Adding NRZ OMA measurement
Description This command adds NRZ OMA measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”OMA”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”OMA”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”OMA”,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”OMA”,Ref1,MEAS20
Measurement specific configurations: Use the following query to get to know the available configurations for the measurement. MEASUrement:MEAS<x>:CONfig:ATTRibutes? (Query only) – This returns the list of available configurations Return: “Units”, “Signal Ordinate”
Use the following syntax to set the configuration: MEASUrement:MEAS<x>:CONfig <string_attribute>,{<QString>|<NR3>|<Boolean>} Example: MEASUrement:MEAS1:CONfig “Units”,”Signal Ordinate”

Adding NRZ AC RMS measurement
Description This command adds NRZ AC RMS measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”ACRMS”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”ACRMS”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”ACRMS”,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”ACRMS”,Ref1,MEAS20
Adding NRZ RMS Noise measurement
Description This command adds NRZ RMS Noise measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”RMSNoise”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”RMSNoise”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”RMSNoise”,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”RMSNoise”,Ref1,MEAS20
Measurement specific configurations: Use the following query to get to know the available configurations for the measurement.

TSO8 Series Programmer Manual

MEASUrement:MEAS<x>:CONfig:ATTRibutes? (Query only) – This returns the list of available configurations Return: “NoiseAt”
Use the following syntax to set the configuration: MEASUrement:MEAS<x>:CONfig <string_attribute>,{<QString>|<NR3>|<Boolean>} Example: MEASUrement:MEAS1:CONfig “NoiseAt”,”High” MEASUrement:MEAS1:CONfig “NoiseAt”,”Low”
Adding NRZ Amplitude measurement
Description This command adds NRZ Amplitude measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”Amplitude”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”Amplitude”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”Amplitude”,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”Amplitude”,Ref1,MEAS20
Measurement specific configurations: Use the following query to get to know the available configurations for the measurement. MEASUrement:MEAS<x>:CONfig:ATTRibutes? (Query only) – This returns the list of available configurations Return: “TrackingMethod”, “EyeAperture”
Use the following syntax to set the configuration: MEASUrement:MEAS<x>:CONfig <string_attribute>,{<QString>|<NR3>|<Boolean>} Example: MEASUrement:MEAS1:CONfig “EyeAperture”,10 MEASUrement:MEAS1:CONfig “TrackingMethod”,”Mean”
Adding NRZ Eye Width measurement
Description This command adds NRZ Eye Width measurement from NRZ-Eye category on the given source with specified measurement ID.
Syntax MEASUREMENT:ADDMeas “NRZ-EYE”,”EYEWIdth”,{M[n]{A|B} | REF[x]}
Examples MEASUREMENT:ADDMeas “NRZ-EYE”,”EYEWIdth”,M1A MEASUREMENT:ADDMeas “NRZ-EYE”,”EYEWIdth”,Ref1 MEASUREMENT:ADDMeas “NRZ-EYE”,”EYEWIdth”,Ref1,MEAS20
Measurement specific configurations: Use the following query to get to know the available configurations for the

Documents / Resources

Tektronix TSO8 Series Sampling Oscilloscop [pdf] User Manual
TSO8 Series Sampling Oscilloscop, TSO8, Series Sampling Oscilloscop, Sampling Oscilloscop, Oscilloscop

References

User Manual

TSO8 Series Sampling Oscilloscop

Specifications

Product Usage Instructions

Getting Started

Syntax and Commands

Commands

Status and Events

FAQ

Q: How can I remotely control the instrument using PI
commands?

Q: What should I do if I encounter error messages while using
the instrument?

Q: Can I write computer programs to perform functions similar
to the User Interface?

Documents / Resources

References

Leave a comment

Cancel reply