Tektronix DPO4000, MSO4000 User Manual

Download

MSO4000 and DPO4000 Series

ZZZ

Digital Phosphor Oscilloscopes

Programmer Manual

*P077024800*

077-0248-00

MSO4000 and DPO4000 Series

ZZZ

Digital Phosphor Oscilloscopes

Programmer Manual

www.tektronix.com

077-0248-00

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. Speciﬁcations and price change privileges reserved.

TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.

Contacting

Tektronix, Inc. 14200 SW Karl Braun Drive P.O. Box 50 Beaverton, OR 97077 USA

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

In North America, call 1-800-833-9200. Worl dwi

Tektronix

de, visit www.tektronix.com to ﬁnd contacts in your area.

Table of Contents

Getting Started .. ..... . ..... . ..... . ... . . ..... . ..... . ..... . ..... . ..... . ... . . . .... . ..... . ..... . ..... . ..... . ..... . .... 1-1

Setting Up Remote Communications.... . ..... . .... . . .... . ..... . ..... . ... . . ..... . ..... . ... . . . .... . ..... . .. 1-1

Command Syntax........................................ ................................ ......................... 2-1

Command and Query Structure ............................................................................ 2-1

Clearing the oscilloscope ... . ..... . ... . . . .... . ..... . ..... . ..... . ..... . ..... ..... . ..... . ..... . ..... . ..... . ... 2-3

Command Entry.............................................................................................. 2-3

Constructed Mnemonics .................................................................................... 2-5

Argument Types... ................................ .................................. ......................... 2-7

Command Groups .............................................................................................. 2-11

Acquisition Command Group .... . ..... . ..... . ..... . ... . . . .... . ..... . ..... . ..... . ..... . ..... . ..... . ... . . . 2-11

Alias Command Group... .................................. ................................ ............... 2-12

Bus Command Group ..................................................................................... 2-13

Calibration and Diagnostic Command Group .......................................................... 2-17

Cursor Command Group... .................................. ................................ ............. 2-17

Display Command Group................................................................................. 2-19

Ethernet Command Group ................................................................................ 2-20

File System Command Group ............................. ................................ ............... 2-21

rd Copy Command Group.. ................................ ................................ ........... 2-22

Horizontal Command Group .. .................................. ................................ ......... 2-24

Mark Command Group............... .................................. ................................ ... 2-24

Math Command Group..................... .................................. ............................. 2-26

Measurement Command Group..................... ................................ ..................... 2-27

Miscellaneous Command Group ......................................................................... 2-30

PictBridge Command Group .. ................................ .................................. ......... 2-32

Power Command Group ........... .................................. ................................ ..... 2-32

Save and Recall Command Group ....................................................................... 2-40

Search Command Group....... ................................ ................................ ........... 2-41

Status and Error Command Group ................................ ................................ ....... 2-47

Trigger Command Group ...... ................................ .................................. ......... 2-48

Vertical Command Group...................................... ................................ ........... 2-58

Waveform Transfer Command Group ................................................................... 2-61

Zoom Command Group................................................................................... 2-67

Commands Listed in Alphabetical Order ......................... ................................ ........... 2-69

Status and Events ................................................................................................. 3-1

Registers ..................... ................................ .................................. ............... 3-1

Queues ........................................................................................................ 3-4

Event Handling Sequence................................................................................... 3-5

Synchronization Methods ............................ ................................ ....................... 3-7

MSO4000 and DPO4000 Series Programmer Manual i

Table of Contents

Appendix A: Cha

Appendix B: Reserved Words.................................................................................. B-1

Appendix C: Factory Defaults ................................................................................. C-1

Default Setup .............................. ................................ ................................ .. C-1

Appendix D: Programming Example.......................................................................... D-1

Index

racter Set ......................... .................................. .......................... A-1

ii MSO4000 and DPO4000 Series Programmer Manual

Getting Started

This manual explains the use of commands for remotely controlling your oscilloscope. With this information, you c an write computer programs to perform func performing statistical calculations, and exporting data for use in other programs.

Setting Up Remote Communications

You can remotely communicate between your oscilloscope and PC via the Ethernet, USB, and, GPIB using the TEK-USB-488 Adapter.

tions, such as setting the front-panel controls, taking measurements,

Ethernet

If you are Ethernet port (RJ-45 connector) on the rear panel of your oscilloscope. This connects the oscilloscope to a 10/100 Base-T local area network.

To change the Ethernet settings on your oscilloscope, do the following:

1. On the front panel, push Utility.

2. Push Utility Page.

3. Select I/O with the Multipurpose knob.

using Ethernet, start by connecting an appropriate Ethernet cable to the

4. Push Ethernet Network Settings.

5. On the side-bezel menu, if you are on a DHCP Ethernet network and using a through cable, set DHCP/BOOTP to On.

6. If you are using a cross-over cable, set DHCP/BOOTP to Off, and set a hard

coded TCPIP address.

USB

MSO4000 and DPO4000 Series Programmer Manual 1-1

If you are using USB, start by connecting an appropriate USB cable to the U SB

2.0 high-speed device port on the rear panel of your oscilloscope.

Getting Started

With USB, the system automatically conﬁgures itself. To verify that the USB is enabled:

1. On the front panel, push Utility.

2. Push Utility Page.

3. Select I/O with the Multipurpose knob.

GPIB

4. Push USB, and verify that USB is enabled.

5. If USB is disabled, push Connect to computer on the side-bezel menu.

After connection, the host, with appropriate software, can list the oscilloscope as a USB device with the following parameters. (See Table 1-1.)

Table 1-1: USB Device Parameters

Parameter Value

Manufacturer ID 0x0699 (decimal 1689)

Product ID

Serial number Serial number

Manufacturer description

Interface description “USBTMC-USB488”

0x0401 (decimal 1025)

“Tektronix”

To use GPIB, start by connecting an appropriate USB cable to the USB 2.0 high speed device port on the rear panel of your oscilloscope. Connect the other end to the TEK-USB-488 Adapter host port. Then connect a GPIB cable from the TEK-USB-488 Adapter to your PC.

Supply power to the Adapter in either of these two ways:

1. Use the optional 5 V

power adapter connected to the 5 VDCpower input

on the Adapter.

2. Use an appropriate USB cable connected to a powered USB host port on your PC and the Device port on the TEK-USB-488 Adapter.

1-2 MSO4000 and DPO4000 Series Programmer Manual

Getting Started

The oscillosco through USBTMC or GPIB with a TEK-USB-488 Adapter. The USBTMC protocol allows USB devices to communicate using IEEE488 style messages. This lets you run your GPIB software applications on USB hardware.

Before setting up the oscilloscope for remote communication using the electronic (physical) GPIB interface, you should familiarize yourself with the following GPIB requirements:

A unique device address must be assigned to each device on the bus. No two devices can share the same device address.

No than 15 devices can be connected to any one line.

One device should be connected for every 6 feet (2 meters) of cable used.

No than

At least two-thirds of the d evices on the network should be powered on while using

pe has a USB 2.0 High speed device port to control the oscilloscope

65 feet (20 meters) of cable should be used to connect devices to a bus.

the network.

Connect the devices on the network in a star or linear conﬁguration. Do not

oop or parallel conﬁgurations.

use l

To function correctly, your oscilloscope must have a unique device address. The

ault setting for the GPIB c onﬁguration is GPIB Address 1.

def

To change the GPIB address settings, do the following:

1. On the front panel, push Utility.

2. Push Utility Page.

3. Select I/O with the Multipurpose knob.

4. Push GPIB.

5. Enter the GPIB address on the side-bezel menu, using the multipurpose knob.

This will set the GPIB address on an attached TEK-USB-488 Adapter

The oscilloscope is now set up for bidirectional communication with your controller.

MSO4000 and DPO4000 Series Programmer Manual 1-3

Getting Started

Documentation

The following d Web site at www.tektronix.com:

MSO4000 and DP

Information about installing and operating the oscilloscope.

Getting Sta

from your oscilloscope into a ny one of several available analysis tools.

MSO4000 and Reference. Oscilloscope speciﬁcations and a performance veriﬁcation procedure.

TekVI SA P r

implementation of the VISA Application Programming Interface (API). TekVISA is industry-compliant software for writing interoperable oscilloscope drivers in a variety of Application Development Environments (ADEs).

ocuments are available for download on the Manuals Finder

O4000 Series Digital Phosphor Oscilloscopes User Manual.

rted with OpenChoice ™ Solutions Manual. Options for getting data

DPO4000 Series Digital Phosphor Oscilloscopes Technical

ogrammer Manual. Description of TekVISA, the Tektronix

1-4 MSO4000 and DPO4000 Series Programmer Manual

Command Syntax

You can control the operations and functions of the oscilloscope through the Ethernet port or the USB 2.0 device port using commands and queries. The related topi The topics also describe the conventions that the oscilloscope 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 speciﬁc command.

cs listed below describe the syntax of these commands and queries.

Backus-Naur Form

Notation

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

Table 2-1: Symbols for Backus-Naur Form

Symbol Meaning

| Exclusive OR

{ } Group; one element is required

[] .. .

( ) Comment

Command and Query Structure

mmands consist of set commands and query commands (usually called

Co commands and queries). Commands modify oscilloscope settings or tell the oscilloscope to perform a speciﬁc action. Queries cause the oscilloscope to return data and status information.

Deﬁned element

Is deﬁned as

Optional; can be omitted

Previous element(s) may be repeated

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 ma rk at the end. For example, the set command commands have both a set and a query form. Some commands have set only and some have query only.

Messages

MSO4000 and DPO4000 Series Programmer Manual 2-1

A command message is a command or query name followed by any information the oscilloscope n eeds to execute the command or query. Command messages may contain ﬁve element types, deﬁned in the following table.

ACQuire:MODe has a query form ACQuire:MODe?.Notall

Command Syntax

Commands

Table 2-2: Comm

Symbol Meaning

<Argument

<Comma> A single c

<Space>

Comman

ds cause the oscilloscope to perform a speciﬁc function or change one of

and Message Elements

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 (:) c haracte 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. I character always separates them from each other.

This is a qu Some commands have no arguments while others have multiple arguments. A <space> separates arguments from the header. A <comma> se

commands. Optionally, there may be white space characters before and after the comma.

A white space c haracter is used between a command header and the related argument. Optionally, a white space may consist of m ultiple white sp

r. If the command is concatenated with other commands,

f a command header has multiple mnemonics, a colon (:)

antity, quality, restriction, or limit associated with the header.

parates arguments from each other.

omma is used between arguments of multiple-argument

ace characters.

the settings. Commands have the structure:

eader>[<Space><Argument>[<Comma> <Argument>]...]

[:]<H

A command header consists of one or more mnemonics arranged in a hierarchical

ee structure. The ﬁrst mnemonic is the base or root of the tree and each

or tr 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 MSO4000 and DPO4000 Series Programmer Manual

Command Syntax

Queries

Headers

Queries cause t have the structure:

[:]<Header>

[:]<Header>[<Space><Argument> [<Comma><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 speciﬁed branch or level.

Use the HEADer command to control whether the oscilloscope returns headers as part of the query response. 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 Header Off Header On

TIME?

ACQuire:NUMAVg?

he oscilloscope to return status or setting information. Queries

14:30:00 :TIME “14:30:00”

100

:ACQUIRE:NUMAVG 100

Clearing the oscilloscope

You can clear the Output Queue and reset the oscilloscope to accept a new command or query by using the selected Device Clear (DCL) function.

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 oscilloscope ignores commands consisting of any combination of white space characters and line feeds.

MSO4000 and DPO4000 Series Programmer Manual 2-3

Command Syntax

Abbreviating

Concatenating

You can abbrevi

ate many oscilloscope commands. Each command in this documentation shows the minimum acceptable abbreviations in capitals. For example, you can enter the command ACQuire:NUMAvg simply as ACQ:NUMA or acq:numa.

Abbreviation rules may change over time as new oscilloscope 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.

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

When concatenating commands and queries, you must follow these rules:

1. Separate completely different headers by a semicolon and by the beginning

colon on all commands except the ﬁrst one. For example, the commands

TRIGger:MODe NORMal and ACQuire:NUMAVg 8, can be concatenated

into the following single command:

TRIGger:MODe NORMal;:ACQuire:NUMAVg 8

2. 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 ENVelope

and ACQuire:NUMAVg 8 into a single command:

ACQuire:MODe ENVelope; NUMAVg 8

The longer version works equally well:

ACQuire:MODe ENVelope;:ACQuire:NUMAVg 8

3. Never precede a star (*) command with a colon:

ACQuire:STATE 1;*OPC

Any commands that follow will be processed as if the star command was not there so the commands,

ACQuire:MODe ENVel

ope;*OPC;NUMAVg 8

will set the acquisition mode to envelope and set the number of acquisitions for averaging to 8.

4. When you concat enate queries, the responses to all the queries are

concatenated into a single response message. For example, if the display graticule is set to Full and the display style is set to dotsonly, the concatenated query

DISplay:GRAticule?;STYle:DOTsonly? will return the following.

Iftheheaderison:

DISPLAY:GRATICULE FULL;:DISPLAY:STYLE:DOTSONLY 1

2-4 MSO4000 and DPO4000 Series Programmer Manual

Command Syntax

If the header is

FULL;1

off:

5. 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 o f acquisitions for averaging and the acquisition state. Concatenated commands and queries are executed in the order receive d.

Here are some invalid concatenations:

DISPlay:STYle:NORMal;ACQuire:NUMAVg 8 (no colon before ACQuire)

DISPlay:GRAticule FULL;:DOTSONLY OFF (extra colon before DOTSonly. You could use DISPla y:DOTsonly OFF instead)

DISPlay:GRAticule FULL;:*TRG (colon before a star (*) command)

MATH:HORizontal:SCAle 1.0e-1;HORizontal:POSition 5.0el

(levels of the mnemonics are different; either remove the second use of

HORizontal: or place :MATH in front of HORizontal :POSition)

Terminating

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

Table 2-4: End of Message Terminator

Symbol Meaning

<EOM>

Th concurrently with the last data byte). The last data byte may be an ASCII line feed (LF) character.

This oscilloscope does not support ASCII LF only message termination. The oscilloscope always terminates outgoing messages with LF and EOI.

Constructed Mnemonics

Some header mnemonics specify one of a range of mnemonics. For example, a channel mnemonic can be CH1, CH2, CH3, or CH4. You use these mnemonics in the command just as you do any other mnemonic. For example, there is a CH1:POSition command, and there is also a CH2:POSition command. In the command descriptions, this list of choices is abbreviated as CH<x>.

Message terminator

e end-of-message terminator must be the END message (EOI asserted

MSO4000 and DPO4000 Series Programmer Manual 2-5

Command Syntax

Math Spe

Cursor Position

Mnemonics

ciﬁer Mnemonics

When cursors ar

e displayed, commands may specify which cursor of the pair to

use.

Table 2-5: Channel Mnemonics

Symbol Meaning

CH<x> A channel speciﬁer; <x> is 1 through 4.

Table 2-6: C ursor Mnemonics

Symbol Meaning

CURSOR<x>

POSITION<x>

HPOS<x>

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

Commands can specify the mathematical waveform to use as a mnemonic in the header.

Table 2-7: Math Speciﬁer Mnemonics

Symbol Meaning

Math<x>

A math waveform speciﬁer; <x> is 1.

Measurement Speciﬁer

Mnemonics

hannel Mnemonics

Reference Waveform

Mnemonics

Commands can specify which measurement to set or query as a mnemonic in the header. Up to eight automated measurements may be displayed.

Table 2-8: Measurement Speciﬁer Mnemonics

Symbol Meaning

MEAS<x> A measurement speciﬁer; <x> is 1 through 4.

Commands specify the channel to use as a mnemonic in the h eader.

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

Table 2-9: Reference Waveform Mnemonics

Symbol Meaning

REF<x>

A reference waveform speciﬁer; <x> is 1, 2, 3, or 4 for 4-channel oscilloscopes and 1 or 2 for 2-channel oscilloscopes.

2-6 MSO4000 and DPO4000 Series Programmer Manual

Argument Types

Command Syntax

Commands use arguments such as enumeration, numeric, quoted string and block. Each of these arguments are listed in detail below.

Enumeration

Numeric

Enter these arguments as unquoted text words. Like key words, enumeration arguments follow the same convention where the portion indicated in uppercase is required and that in lowercase is optional.

For example:

Many osci

SAVe:WAVEform:FILEFormat INTERNal

lloscope commands require numeric arguments. The syntax shows the format that the oscilloscope returns in response to a query. This is also the preferred format when sending the command to the o scilloscope though any of the formats will be accepted. This documentation represents these arguments as described below.

Table 2-10: Numeric A rguments

Symbol Meaning

<NR1>

<NR2> Floating point value without an exponent

<NR3> Floating point value with an exponent

<bin>

Signed integer value

Digital data in binary format

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

the command description.

Quoted String

Some commands accept or return data in the form of a quoted string, w hich is simply a group of ASCII characters enclosed by a single quote (’) or double quote

"). The following is an example of a quoted string:

(

string"

. This documentation represents these arguments as follows:

"This is a quoted

Table 2-11: Quoted String Argument

Symbol Meaning

<QString> Quoted string of ASCII text

MSO4000 and DPO4000 Series Programmer Manual 2-7

Command Syntax

A quoted string

can include any character deﬁned in the 7-bit ASCII character

set. Follow these rules when you use quoted strings:

1. Use the same ty example:

2. You can mix q previous rule. For example:

3. You c an i ncl example:

4. Strings ca

pe of quote character to open and close the string. For

"this is a valid string".

uotation marks within a string as long as you follow the

"this is an ’acceptable’ string".

ude a quote character within a string b y repeating the quote. For

"here is a "" mark".

n have u pper or lower case characters.

5. If you use a GPIB network, you cannot terminate a quoted string with the END messa

ge before the c losing delimiter.

6. A carriage return or line feed embedded in a quoted string does not terminate the stri

ng. The return is treated as another character in the string.

7. The maximum length of a quoted string returned from a query is 1000

ters.

charac

Here are some invalid strings:

"Invalid string argument’ (quotes are not of the same type)

Block

"test<EOI>" (termination character is embedded in the string)

Several oscilloscope commands use a block argument form, as deﬁned in the table below.

Table 2-12: Block Argument

Symbol Meaning

<NZDig>

<Dig>

<DChar> A character with the hexadecimal equivalent of 00 through FF (0

<Block>

A nonzero digit character i n the range of 1–9

A digit character, in the range of 0–9

through 255 decimal)

A block of data bytes deﬁned as: <Block> ::= {#<NZDig><Dig>[<Dig>...][<DChar>...] |#0[<D Char>...]<term inator>}

<NZDig> speciﬁes the number of <Dig> elements that follow. Taken together, the <NZDig> and <Dig> elements form a decimal integer that speciﬁes how many <DChar> elements follow.

2-8 MSO4000 and DPO4000 Series Programmer Manual

Command Syntax

MSO4000 and DPO4000 Series Programmer Manual 2-9

Command Syntax

2-10 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

This manual lists the MSO4000 and DPO4000 Series IEEE488.2 commands in two ways. First, it presents them by functional groups. Then, it lists them alphabetica provides detail on each command. (See page 2-69, Commands Listed in Alphabetical Order.)

Acquisition Command Group

Use the commands in the Acquisition Command Group to set up the m odes and functions that control how the oscilloscope acquires signals input to the channels, and processes them into waveforms.

Using the commands in this group, you can do the following:

Start and stop acquisitions.

Control whether each waveform is simply acquired, averaged, or enveloped over successive acquisitions of that waveform.

Set the controls or conditions that start and stop acquisitions.

Contr

lly. The functional group list starts below. The alphabetical list

ol acquisition of channel waveforms.

Set acquisition parameters.

e 2-13: Acquisition Commands

Tabl

Command Description

urns acquisition parameters

ACQuire?

ACQuire:MAGnivu Sets or returns the MagniVu feature

ACQuire:MAXSamplerate?

ACQuire:MODe Sets or returns the acquisition mode

ACQuire:NUMACq? Returns number of acquisitions that have

ACQuire:NUMAVg Sets or returns the number of acquisitions for

ACQuire:STATE Starts or stops the acquisition system

ACQuire:STOPAfter Sets or returns whether the acquisition is

Ret

turns the maximum real-time sample rate

occurred

an averaged waveform

continuous or single sequence

MSO4000 and DPO4000 Series Programmer Manual 2-11

Command Groups

Alias Command

Group

Use the Alias commands to deﬁne new commands as a sequence of standard commands. You may ﬁnd this useful when repeatedly using the same commands to perform ce

rtain tasks like setting up measurements.

Aliases are similar to macros but do not include the capability to substitute parameters

into alias bodies. The alias mechanism obeys the following rules:

The alias name must consist of a valid IEEE488.2 message unit, which may not appear

in a message preceded by a colon, comma, or a command or query

program he ader.

The alias

name may not appear in a message followed by a colon, comma,

or question mark.

An alias

name must be distinct from any keyword or keyword short form.

An alias name cannot be redeﬁned without ﬁrst being deleted using one of

as deletion functions.

the ali

Alias names do not appear in response messages.

2-14: Alias Commands

Table

Command Description

ALIa

ALIas:CATalog? Returns a list of the currently deﬁned alias

ALIas:DEFine

ALIas:DELEte

ALIas:DELEte:ALL Deletes all existing aliases

ALIas:DELEte[:NAMe]

ALIas[:STATE] Sets or returns the alias state

Sets or returns the alias state

labels

Assigns a sequence of program messages

n alias label

to a

moves a speciﬁed alias

Removes a speciﬁed alias

2-12 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Bus Command Gr

oup

Use the Bus commands when working with serial or parallel bus measurements.

Install the DPOEMBD application module when working with I2CorSPI bus signals.

Install the DPO4COMP module when working with RS-232, RS-422, RS-485, or UART bus signals.

Install the DPO4AUDIO module when working with I2S, Left Justiﬁed (LJ), Right Justiﬁed (RJ), or TDM bus signals.

Install the DPO4AUTO or DPO4AUTOMAX module when working with CAN or LIN bus signals.

Install the DPO4AUTOMAX module when working with FlexRay bus signals.

NOTE. LIN and FlexRay work on DPO4000s with serial numbers greater than

C02000

0 and on all MSO4000s.

NOTE. The parallel bus commands work with MSO4000 Series oscilloscopes only.

NOTE. The Search Command Group and the Trigger Command Group also

contain bus-related commands.

Table2-15:BusCommands

mands

Com

S:B<1-4>:AUDio:BITDelay

BUS:B<1-4>:AUDio:BITOrder Sets or returns the bit order for the AUDIO

BUS:B<1-4>:AUDio:CHANnel:SIZe Sets o r returns the number of bits per

BUS:B<1-4>:AUDio:CLOCk:POLarity Sets or returns the clock polarity for the

BUS:B<1-4>:AUDio:CLOCk:SOUrce Sets or returns the clock source waveform

BUS:B<1-4>:AUDio:DATa:POLarity Sets or returns the data polarity for the

BUS:B<1-4>:AUDio:DATa:SIZe Sets or returns the number of bits per word

cription

Des

turns the parameters for each bus

ts or returns the number of delay bits for

Se the AUDIO bus

bus

channel for the AUDIO bus

AUDIO bus

for the AUDIO bus

AUDIO bus

for the AUDIO bus

MSO4000 and DPO4000 Series Programmer Manual 2-13

Command Groups

Table2-15:BusCommands(cont.)

Commands Description

BUS:B<1-4>:AUDio:DATa:SOUrce Sets or returns the data source waveform for

the A UD IO bus

BUS:B<1-4>:AUDio:DISplay:FORMat Sets or returns the display format for the

AUDIO bus

BUS:B<1-4>:AUDio:FRAME:SIZe Sets or returns the number of channels in

each frame for the AUDIO bus

BUS:B<1-4>:AUDio:FRAMESync:POLarity Sets or returns the frame sync polarity for

the A UD IO bus

BUS:B<1-4>:AUDio:FRAMESync:SOUrce Sets or returns the frame sync source

waveform for the AUDIO bus

BUS:B<1-4>:AUDio:TYPe Sets or returns the audio format ( type) for

the A UD IO bus

BUS:B<1-4>:AUDio:WORDSel:POLarity Sets or returns the word select polarity for

the A UD IO bus

BUS:B<1-4>:AUDio:WORDSel:SOUrce Sets or returns the word select source

waveform for the AUDIO bus

BUS:B<x>:CAN:BITRate Sets or returns the bit rate for the CAN bus

BUS:B<x>:CAN:PRObe Sets or returns the probing method used to

probe the CAN bus

BUS:B<x>:CAN:SAMPLEpoint Sets or returns the sample point (in %) to

sample during each bit period

BUS:B<x>:CAN:SOUrce Sets or returns the CAN data source

BUS:B<x>:DISplay:FORMAt Sets the display format for the numerical

information in the speciﬁed bus waveform

BUS:B<x>:DISplay:TYPe Sets the display type for the speciﬁed bus

BUS:B<x>:FLEXray:BITRate Sets or returns the bit rate for FLEXRAY

BUS:B<x>:FLEXray:CHannel Sets or returns the FLEXRAY ID format

BUS:B<x>:FLEXray:SIGnal Sets or returns the FLEXRAY standard

BUS:B<x>:FLEXray:SOUrce Sets or returns the FLEXRAY data source

BUS:B<x>:I2C:ADDRess:RWINClude Sets and returns whether the read/write bit is

included in the address

BUS:B<x>:I2C{:CLOCK|:SCLK}:SOUrce Sets or returns the I2C SCLK source

BUS:B<x>:I2C{:DATA|:SDATA}:SOUrce Sets or returns the I2C SDATA source

BUS:B<x>:LABel Sets or returns the waveform label for the

speciﬁed bus

BUS:B<x>:LIN:BITRate Sets or returns the bit rate for LIN

BUS:B<x>:LIN:IDFORmat Sets or returns the LIN ID format

BUS:B<x>:LIN:POLARity Sets or returns the LIN polarity

BUS:B<x>:LIN:SAMPLEpoint Sets or returns the sample point (in %) at

which to sample during each bit period

2-14 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Table 2-15: Bus Commands (cont.)

Commands Description

BUS:B<x>:LIN:SOUrce Sets or returns the LIN data source

BUS:B<x>:LIN:STANDard Sets or returns the LIN standard

BUS:B<x>:PARallel:BIT<x>:SOUrce Sets or returns the Parallel bit source for the

speciﬁed bus

BUS:B<x>:PARallel:CLOCK:EDGE Sets or returns the Parallel clock edge for

the speciﬁed bus

BUS:B<x>:PARallel:CLOCK:ISCLOCKed Sets or returns the Parallel bus clock function

for the speciﬁed bus

BUS:B<x>:PARallel:CLOCK:SOUrce Sets or returns the Parallel clock source for

the speciﬁed bus

BUS:B<x>:PARallel:WIDth Sets or returns the w idth of the Parallel bus

BUS:B<x>:POSition Sets or returns the position of the speciﬁed

bus waveform

BUS:B<x>:RS232C:BITRate Sets or returns the RS-232 bit rate for the

speciﬁed bus

BUS:B<x>:RS232C:DATABits Sets or returns the number of bits for the

data frame

BUS:B<x>:RS232C:DELIMiter Sets or returns the RS-232 delimiting value

for a packet on the speciﬁed bus

BUS:B<x>:RS232C:DISplaymode Sets or returns the display mode for the

speciﬁed bus display and event table

BUS:B<x>:RS232C:PARity Sets or returns parity for RS-232 data

BUS:B<x>:RS232C:POLarity Sets or returns the RS-232C polarity for the

speciﬁed bus

BUS:B<x>:RS232C:RX:SOUrce Sets or returns the RS-232 RX source

BUS:B<x>:RS232C:TX:SOUrce Sets or returns the RS-232 TX Source

BUS:B<x>:SPI:BITOrder Sets or returns the bit order for the speciﬁed

SPI bus

BUS:B<x>:SPI{:CLOCK|:SCLK}:POLARity Sets or returns the SPI SCLK polarity

BUS:B<x>:SPI{:CLOCK|:SCLK}:SOUrce Sets or returns the SPI SCLK source

BUS:B<x>:SPI:DATA{:IN|:MISO}:POLARity Sets or returns the SPI MISO polarity

BUS:B<x>:SPI:DATA{:IN|:MISO}:SOUrce Sets or returns the SPI MISO source

BUS:B<x>:SPI:DATA{:OUT|:MOSI}: POLARity

BUS:B<x>:SPI:DATA{:OUT|:MOSI}:SOUrce Sets or returns the SPI MOSI source

BUS:B<x>:SPI:DATA:SIZe Sets or returns the number of bits per word

BUS:B<x>:SPI:FRAMING Sets or returns the SPI framing type

BUS:B<x>:SPI:IDLETime Sets or returns the SPI bus idle time in

Sets or returns the SPI MOSI polarity

for the speciﬁed bus

seconds for the speciﬁed bus

MSO4000 and DPO4000 Series Programmer Manual 2-15

Command Groups

Table2-15:BusCommands(cont.)

Commands Description

BUS:B<x>:SPI{:SELect|:SS}:POLARity Sets or returns the SPI SS polarity

BUS:B<x>:SPI{:SELect|:SS}:SOUrce Sets or returns the SPI SS source

BUS:B<x>:STATE Turns the speciﬁed bus on and off

BUS:B<x>:TYPE Sets or returns the speciﬁed bus type

BUS:LOWerthreshold:CH<x> Sets or returns the lower threshold for each

channel

BUS:THReshold:CH<x> Sets or returns the threshold for a channel

BUS:THReshold:D<x> Sets or returns the threshold for a digital

channel

BUS:UPPerthreshold:CH<x> Sets or returns the upper threshold for each

channel

2-16 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Calibration a

nd Diagnostic Command Group

The Calibration and Diagnostic commands provide information about the current state of oscilloscope calibration. They also initiate internal signal path calibration (SPC) or exec calibration are not described in this manual. They are described in the Service manual, located on the DPO4000 Documentation CD-ROM in PDF format. You can also order a printed copy.

Table 2-16: Calibration and Diagnostic Commands

Command

*CAL? Instructs the oscilloscope to perform

CALibrate:FACtory:STATus? Returns the factory calibration status value

CALibrate:INTERNal Starts a signal path compensation

CALibrate:INTERNal:STARt Starts the internal signal path calibration

CALibrate:INTERNal:STATus? Returns the current status of the internal

CALibrate:RESults? Returns the status of all calibration

CALibrate:RESults:FACtory? Returns the status of internal and factory

CALibrate:RESults:SPC? Returns the results of the last SPC operation

DIAg:LOOP:OPTion Sets the self-test loop option

DIAg:LOOP:OPTion:NTIMes Sets the self-test loop option to run N times

DIAg:LOOP:STOP Stops the self-test at the end of the current

DIAg:RESUlt:FLAg? Returns the pass/fail status from the last

DIAg:RESUlt:LOG? Returns the internal results log from the last

DIAg:SELect:<function> Selects one of the available self-test areas

DIAg:STATE Sets the oscilloscope operating state

DIAg:SELect Runs self tests on the speciﬁed system

ute diagnostic tests. Commands that are speciﬁctofactory

Description

self-calibration and returns the oscilloscope self calibration status

saved in nonvolatile memory

signal path calibration

subsystems without performing an SPC operation

calibration

loop

self-test sequence execution

subsystem

Cursor Command Group

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 cursor position.

MSO4000 and DPO4000 Series Programmer Manual 2-17

Command Groups

You can also use

the commands to select one of the following cursor functions:

Off. Turns off the display of all cursors.

Waveform Cursors. Consists of two cursors. Waveform cursors enable you to conveniently measure waveform amplitude and time.

Screen Cursors. Consists of two pairs of independent horizontal and vertical cursors. You can use these cursors to indicate an arbitrary position within the wavefor

m display area.

Table 2-17: Cursor Commands

Command

CURSor?

CURSor:DDT? Returns the cursor deltaY/deltaT (dY/dT)

CURSor:FUNCtion Sets or returns the cursor type

CURSor:HBArs?

CURSor:HBArs:DELTa? Returns hbars cursors vertical difference

CURSor:HBArs:POSITION<x> Sets or r eturns the hbar cursor<x> vertical

CURSor:HBArs:UNIts

CURSor:HBArs:USE Sets the horizontal bar cursor measurement

CURSor:MODe Sets or returns whether cursors move in

CURSor:VBArs? Sets or returns the position of vertical bar

CURSor:VBArs:ALTERNATE<x>? Returns the alternate readout for the

CURSor:VBArs:DELTa? Returns the horizontal difference between

CURSor:VBArs:HPOS<x>? Returns the vertical value of the speciﬁed

CURSor:VBArs:POSITION<x> Sets or returns the vbar cursor<x> horizontal

CURSor:VBArs:UNIts Sets or returns the horizontal units for vbar

CURSor:VBArs:USE Sets the vertical bar cursor measurement

CURSor:VBArs:VDELTa? Returns the vertical difference between the

CURSor:XY:POLar:RADIUS:DELta? Returns the difference between the cursors

Description

Returns cursor settings

readout

Returns hbar cursor settings

position

Returns hbar cursor units

scale, for use with ratio cursors

unison or separately

cursors

waveform (V bar) cursors

vbar cursors

vertical bar tick

position

cursors

scale

two vertical bar cursor ticks

X radius and the cursor Y radius

2-18 MSO4000 and DPO4000 Series Programmer Manual

Table 2-17: Cursor Commands (cont.)

Command Groups

Command

CURSor:XY:POLar:RADIUS:POSITION<x>? Returns the polar radius of the speciﬁed

CURSor:XY:POLar:RADIUS:UNIts?

CURSor:XY:POLar:THETA:DELta?

CURSor:XY:POLar:THETA:PO SITION<x>?

CURSor:XY:POLar:THETA:U NIts ?

CURSor:XY:PRODUCT:DELta? Returns the difference between the cursors

CURSor:XY:PRODUCT:POSITION<x>? Returns the position of the X or Y cursor used

CURSor:XY:PRODUCT:UNIts?

CURSor:XY:RATIO:DELta? Returns the ratio of the difference between

CURSor:XY:RATIO:POSITION<x>? Returns the X or Y position for the speciﬁed

CURSor:XY:RATIO:UNIts? Returns the X and Y cursor units for the ratio

CURSor:XY:READOUT Sets or returns the XY cursor readout

CURSor:XY:RECTangular:X:DELta?

CURSor:XY:RECTangular:X:POSITION<x> Sets or returns the cursor X rectangular

CURSor:XY:RECTangular:X:UNIts? Returns the Cursor X rectangular units

CURSor:XY:RECTangular:Y:DELta?

CURSor:XY:RECTangular:Y:POSITION<x>> Sets or returns the cursor Y rectangular

CURSor:XY:RECTangular:Y:UNIts?

Description

cursor

Returns the polar radius units

Returns the XY cursor polar coordinate delta

Returns the cursor X or cursor Y polar coordinate

Returns the cursor polar coordinate units

X position and cursor Y position

to calculate the X × Y cursor measurement

Returns the XY cursor product units

the cursor X position and cursor Y position

cursor

measurement

selection.

Returns the cursor X delta value in rectangular coordinates

coordinates

Returns The cursor Y delta value in rectangular coordinates

coordinate

Returns the cursor Y rectangular units

Display Command Group

Use the commands in the Display Command Group to change the graticule style, the display intensities, and to set the characteristics of the waveform display.

NOTE. Your settings globally affect all displayed waveforms.

MSO4000 and DPO4000 Series Programmer Manual 2-19

Command Groups

Table 2-18: Dis

Command

DISplay?

DISplay:CLOCk Sets or returns the display of the date/time

DISplay:DIGital:HEIght Sets or returns the number of available digital

DISplay:G

DISplay:FORMat Sets or returns the display format

DISplay:INTENSITy?

DISplay:INTENSITy:BACKLight Sets or returns the backlight intensity for the

DISplay:INTENSITy:GRAticule Sets or returns the graticule intensity for the

y:INTENSITy:WAVEform

DISpla

ay:PERSistence

DISpl

lay:STYle:DOTsonly

DISp

age

MESS

MESSage:BOX Sets or returns the coordinates of the

MESSage:CLEAR Clears the contents of the message box.

MESSage:SHOW Sets or returns the contents of the message

ESSage:STATE

play Commands

RAticule

Description

Returns curre

stamp

waveform po

Sets or ret displayed

Returns a

display

displa

Sets or

Sets o

a dots-only display

Sets

or queries message box (screen

Sets annotation) parameters

message box

ontrols the display of the message box

nt display settings

sition slots

urns the type of graticule that is

ll display intensity settings

returns the intensity of the waveforms

r returns display persistence setting

Ethernet Command Group

Use the commands in the Ethernet Command Group to set up the Ethernet remote interface.

Table 2-19: Ethernet Commands

Command

ETHERnet:DHCPbootp Sets or returns the network initialization

ETHERnet:DNS:IPADDress Sets or returns the network Domain Name

ETHERnet:DOMAINname Sets or returns the network domain name

ETHERnet:ENET:ADDress?

2-20 MSO4000 and DPO4000 Series Programmer Manual

Description

search for a DHCP/BOOTP server

Server (Dns) IP address

Returns the Ethernet address value assigned to the oscilloscope

Table 2-19: Ethernet Commands (cont.)

Command Groups

Command

ETHERnet:GATEWay:IPADDress Sets or returns the remote interface gateway

ETHERnet:HTTPPort

ETHERnet:IPADDress

ETHERnet:NAME

ETHERnet:PASSWord Sets or returns the Ethernet access password

ETHERnet:PING Causes the o scilloscope to ping the gateway

ETHERnet:PING:STATUS? Returns the results from pinging the gateway

ETHERnet:SUBNETMask Sets or returns the remote interface subnet

File System Command Group

Use the commands in the File System Command Group to help you use CompactFlash and USB media. You can use the commands to do the f ollowing:

Description

IP address

Sets or returns the remote interface HTTP port value

Sets or returns the IP address assigned to the osc illoscope

Sets or returns the network name assigned to the oscilloscope

IP address

mask value

List the contents of a directory

Create and delete directories

Create, read, rename, or delete a ﬁle

ormat media

When using these commands, keep the following points in mind:

File arguments are always enclosed within double quotes: "D:/MYDIR/TEK00001.SET"

File names follow the non-case sensitive, MSDOS format: [DRIVE:][\PATH\]ﬁlename

Path separators may be either forwardslashes(/)orbackslashes(\)

MSO4000 and DPO4000 Series Programmer Manual 2-21

Command Groups

NOTE. Using bac

k slash as a path separator may produce some unexpected results, depending on how your application treats escaped characters. Many applications recognize the sequence of back slash followed by an alphabetic character as an escaped character, and, as such, interpret that alphabetic character as a control character. For example, the sequence "\n" may be interpreted as a newline character; "\t" may be interpreted as a tab character. To ensure that

this interpretation does not occur, you can use double back slashes.

For example, "D:\\testﬁle.txt".

Table 2-20

Command

FILESystem? Returns the ﬁle system state

FILESystem:CWD Sets or returns the current working d irectory

FILESystem:DELEte Deletes a named ﬁle or directory

FILESystem:DIR? Returns a list of directory contents

FILESystem:FORMat

FILESystem:FREESpace? Returns the number of bytes of free space

FILE

ESystem:READFile

FIL

FILESystem:REName Assigns a new name to an existing ﬁle

FILESystem:RMDir

FILESystem:WRITEFile Writes the speciﬁed block data to the

: File System Commands

System:MKDir

Descripti

for FILESystem commands

Formats a named drive

on th

Crea

Wri speciﬁed interface

oscilloscope current working directory

e current drive

tes a new directory

tes the contents of the speciﬁed ﬁle to the

letes a named directory

Hard Copy Command Group

Use the commands in the Hard Copy Command Group to make hard copies. PictBridge commands belong to a separate group. (See page 2-32, PictBridge Command Group.)

Table 2-21: Hard Copy Commands

Command

HARDCopy Sends a copy of the screen display to the

HARDCopy:ACTIVeprinter Sets or returns the currently active printer

HARDCopy:INKSaver Changes hard copy output to print color

2-22 MSO4000 and DPO4000 Series Programmer Manual

Description

selected printer

traces and graticule on a white background

Table 2-21: Hard Copy Commands (cont.)

Command Groups

Command

HARDCopy:LAYout Sets or returns the page orientation for hard

HARDCopy:PREVIEW

HARDCopy:PRINTer:ADD Adds a network printer to the list of available

HARDCopy:PRINTer:DELete Removes a network printer from the list of

HARDCopy:PRINTer:LIST? Returns the list of currently attached printers

HARDCopy:PRINTer:REName Renames a network printer in the list of

Description

copy

Previews the current screen contents with the InkSaver palette applied

printers

available printers

MSO4000 and DPO4000 Series Programmer Manual 2-23

Command Groups

Horizontal Co

mmand Group

Use the commands in the Horizontal Command Group to control the oscilloscope horizontal parameters.

Table 2-22: Horizontal Commands

Command

HORizontal? Returns settings for the horizontal commands

HORizontal:DELay:MODe Sets or returns the horizontal delay mode

HORizontal:DELay:TIMe Sets or returns the horizontal delay time

HORizontal:DIGital:RECOrdlength: MAGnivu?

HORizontal:DIGital:RECOrdlength:MAIN? Returns the record length of the main digital

HORizontal:DIGital:SAMPLERate: MAGnivu?

HORizontal:DIGital:SAMPLERate:MAIN? Returns the sample rate of the main digital

HORizontal:POSition Sets or r eturns the horizontal position, in

HORizontal:PREViewstate?

HORizontal:RECOrdlength Sets or returns the record length

HORizontal:SAMPLERate Sets or returns the sample rate

HORizontal:SCAle Sets or returns the horizontal scale

Description

Returns the record length of the MagniVu digital acquisition

acquisition

Returns the sample rate of the Magnivu digital acquisition

acquisition

percent, that is used when delay is off

Returns the display system preview state

Mark Command Group

Use the commands in the Mark Command Group to identify areas of the acquired waveform that warrant further investigation.

Table 2-23: Mark Commands

Command Description

MARK Move to the next or previous mark on the

waveform or returns all learnable settings from the mark commands

MARK:CREATE Creates a mark on a particular waveform or

all waveforms in a c olumn

MARK:DELEte

MARK:FREE? Returns how many marks are free to be used

MARK:SELected:END? Returns the end of the selected mark, in

Deletes a mark on a particular waveform, all waveforms in a column, or all marks

terms of 0 to 100% of the waveform

2-24 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Table 2-23: Mark Commands (cont.)

Command Description

MARK:SELected:FOCUS? Returns the focus of the selected mark, in

terms of 0 to 100% of the waveform

MARK:SELected:MARKSINCOLumn?

MARK:SELected:OWNer? Returns the owner of the selected mark

MARK:SELected:SOURCE? Returns the source waveform of the selected

MARK:SELected:STARt? Returns the start of the selected mark, in

MARK:SELected:STATe? Returns the on or off state of the selected

MARK:SELected:ZOOm:POSition? Returns the position of the selected mark, in

MARK:TOTal?

Returns how many marks are in the current zoom pixel column

mark

terms of 0 to 100% of the waveform

mark

terms of 0 to 100% of the upper window

Returns how many marks are used

MSO4000 and DPO4000 Series Programmer Manual 2-25

Command Groups

Math Command G

roup

Use the commands in the Math Command Group to create and deﬁne a math waveform. Use the available math functions to deﬁne your math waveform.

The math waveform you create depends on sources listed in the math expression. If you change these sources, the math waveform you previously deﬁned will be affected.

Math expressions can be simple, containing no mathematical computation, such as CH1, whi

ch speciﬁes that a waveform shows the signal source of Channel 1. Math expressions can also be complex, consisting of up to 128 characters and comprising many sources, functions, and operands.

When a live waveform is updated or a reference waveform is altered, math waveforms containing those waveforms as sources are also updated to reﬂect the changes. Remember that sources must exist, but do not need to be displayed, to be used in and to update math waveforms.

Table 2-24: Math Commands

Command

MATH[1]? Returns the deﬁnition of the math waveform

MATH[1]:DEFine

MATH[1]:HORizontal:SCAle Sets or returns the math horizontal display

MATH[1]:HORizontal:UNIts Returns the math waveform horizontal unit

{MATH|MATH1}:LABel Sets or queries the waveform label for the

MATH[1]:SPECTral:MAG Sets or returns the units of spectral

MATH[1]:SPECTral:WINdow Sets or returns the window function for math

MATH[1]:VERTical:POSition Sets or returns the vertical position of the

MATH[1]:VERTi cal:SCAle Sets or returns the vertical scale of the

MATH[1]:VERTical:UNIts

MATH[1]:HORizontal:POSition Sets or returns the math horizontal display

MATH[1]:TYPe

Description

Sets or returns the current math function as atextstring

scale for F FT or for Dual M a th waveforms

value

math w a veform

magniﬁcation in the math string

waveform spectral input data

currently selected math type

Returns the math waveform vertical units

position for FFT or (non-live) math reference waveforms

Sets or returns the math waveform mode type

2-26 MSO4000 and DPO4000 Series Programmer Manual

Table 2-24: Math Commands (cont.)

Command Groups

Command

MATHVAR?

MAT HVAR:VAR<x>

Measurement Command Group

Use the commands in the Measurement Command Group to control the automated measurement system.

Up to four automated measurements can be displayed on the screen. In the commands, these measurement re adouts are named MEAS<x>, where <x> is the measurement number.

In addition to the four displayed measurements, the measurement commands let you specify an additional measurement, IMMed. The immediate measurement has no Because they are computed only when needed, immediate measurements slow the waveform update rate less than displayed measurements.

Whether you use display ed or immediate measurements, use the VALue query to obtain measurement results.

front-panel equivalent. Immediate measurements are never displayed.

Description

Returns all numerical values used within math expressions

Sets or returns numerical values you can use within math expressions

Measurement commands can set and query measurement parameters. You can assign some parameters, such as waveform sources, differently for each measurement. Other parameters, such as reference levels, have only one value, which applies to all measurements.

Table 2-25: Measurement Commands

Command

MEASUrement?

MEASUrement:CLEARSNapshot

MEASUrement:GATing Sets or returns the measurement gating

MEASUrement:IMMed?

MEASUrement:IMMed:DELay? Returns information about the immediate

MEASUrement:IMMed:DELay:DIRection Sets or returns the search direction to use for

MEASUrement:IMMed:DELay:EDGE<x> Sets or returns the slope of the edge used for

Description

Returns all measurement parameters

Removes the measurement snapshot display

Returns all immediate measurement setup parameters

delay measurement

immediate delay measurements

immediate delay “from” and “to” waveform measurements

MSO4000 and DPO4000 Series Programmer Manual 2-27

Command Groups

Table 2-25: Measurement Commands (cont.)

Command

MEASUrement:IMMed:SOUrce Sets or returns the “from” source for all single

MEASUrement:IMMed:SOUrce2 Sets or returns the source to measure “to” for

MEASUrement:IMMed:TYPe Sets or returns the type of the immediate

MEASUrement:IMMed:UNIts? Returns the units of the immediate

MEASUrement:IMMed:VALue? Returns the value of the immediate

MEASUrement:INDICators?

MEASUrement:INDICators:HORZ<x>? Returns the position of the speciﬁed

MEASUrement:INDICators:NUMHORZ? Returns the number of horizontal

MEASUrement:INDICators:NUMVERT? Returns the number of vertical measurement

MEASUrement:INDICators:STATE Sets or returns the state of visible

MEASUrement:INDICators:VERT<x>? Returns the value of the speciﬁed vertical

MEASUrement:MEAS<x>?

MEASUrement:MEAS<x>:COUNt? Returns the number of values accumulated

MEASUrement:MEAS<x>:DELay?

MEASUrement:MEAS<x>:DELay:DIRection Sets or returns the search direction to use for

MEASUrement:MEAS<x>:DELay:EDGE<x> Sets or returns the slope of the edge to

MEASUrement:MEAS<x>:MAXimum? Returns the maximum value found since the

MEASUrement:MEAS<x>:MEAN?

MEASUrement:MEAS<x>:MINImum? Returns the minimum value found since the

MEASUrement:MEAS<x>:SOURCE[1] Sets or returns the channel from which

Description

channel immediate measurements

phase or delay immediate m easurements

measurement

Returns all measurement indicator parameters

horizontal measurement indicator

measurement indicators currently being displayed

indicators currently being displayed

measurement indicators

measurement indicator

Returns all measurement parameters

since the last statistical reset

Returns the delay measurement parameters for the speciﬁed measurement

delay measurements

use for delay “from” and “to” waveform measurements

last statistical reset

Returns the mean value accumulated since the last statistical reset

last statistical reset

measurements are taken

2-28 MSO4000 and DPO4000 Series Programmer Manual

Table 2-25: Measurement Commands (cont.)

Command Groups

Command

MEASUrement:MEAS<x>:SOURCE2 Sets or returns the channel to which

MEASUrement:MEAS<x>:STATE Sets or returns whether the speciﬁed

MEASUrement:MEAS<x>:STDdev? Returns the standard deviation of values

MEASUrement:MEAS<x>:TYPe Sets or returns the measurement<x> type

MEASUrement:MEAS<x>:UNIts?

MEASUrement:MEAS<x>:VALue? Returns the value of measurement<x>

MEASUrement:METHod Sets or returns the method used for

MEASUrement:REFLevel? Returns the current reference level

MEASUrement:REFLevel:ABSolute:HIGH Sets or returns the top reference level for

MEASUrement:REFLevel:ABSolute:LOW Sets or returns the low reference level for

MEASUrement:REFLevel:ABSolute:MID Sets or returns the mid reference level for

MEASUrement:REFLevel:ABSolute:MID<x> Sets or returns the mid reference level in

MEASUrement:REFLevel:ABSolute:MID2 Sets or returns the mid reference level for

MEASUrement:REFLevel:METHod Sets or returns the method for assigning high

MEASUrement:REFLevel:PERCent:HIGH Sets or returns the top reference percent

MEASUrement:REFLevel:PERCent:LOW Sets or returns the low reference percent

MEASUrement:REFLevel:PERCent:MID Sets or returns the mid reference percent

MEASUrement:REFLevel:PERCent:MID2 Sets or returns the mid reference percent

MEASUrement:IMMed:SOUrce<x> Sets or returns the s ource for the current

MEASUrement:MEAS<x>:SOUrce<x> Sets or returns the source for the speciﬁed

MEASUrement:REFLevel:ABSolute:MID<x> Sets or returns the mid reference level for

MEASUrement:REFLevel:PERCent:MID<x> Sets or returns the m id reference level for

Description

measurements are sent

measurement slot is computed and displayed

accumulated since the last statistical reset

Returns measurement<x> units

calculating reference levels

parameters

rise time

measurements

absolute units (e.g. volts)

delay "to" measurements

and low reference levels

level for rise time

level for waveform measurements

level for second waveform measurements

single channel measurement

measurement.

the speciﬁed channel in absolute volts

the speciﬁed channel in percent

MSO4000 and DPO4000 Series Programmer Manual 2-29

Command Groups

Table 2-25: Measurement Commands (cont.)

Command

MEASUrement:SNAPShot

MEASUrement:STATIstics Clears or returns all of the statistics

MEASUrement:STATIstics:MODE Turns measurement statistics on or off

MEASUrement:STATIstics:WEIghting Controls the responsiveness of the mean

Miscellaneous Command Group

Use the commands in the Miscellaneous Command Group to perform actions that do not ﬁt into other categories.

Several commands and queries are common to all 488.2-1987 devices. The

488.2-1987 standard deﬁnes these commands. The common commands begin with an asterisk (*) character.

Table 2-26: Miscellaneous Commands

Command

AUTOSet Sets the vertical, horizontal and trigger

AUTOSet:ENAble Enables or disables the autoset feature

CLEARMenu Clears the current menu from the display

DATE

*DDT Sets or returns the commands that will be

DESkew Causes the deskew values for all channels

DESkew:DISPlay Sets or returns the state of the deskew table

FPAnel:PRESS Simulates the action of pressing a speciﬁed

FPAnel:TURN

GPIBUsb:ADDress? Returns the current GPIB address

GPIBUsb:ID? Returns the identiﬁcation string of the

Description

Displays the measurement snapshot list

accumulated for all period measurements (MEAS1 through MEAS4)

and standard deviation to waveform changes

Description

controls to provide a stable display of the appropriate waveform. This is equivalent to pressing the front panel Autoset button

Sets or returns the date displayed by the oscilloscope

executed by the group execute trigger

to be set to the recommended values

display

front-panel button

Duplicates the action of turning a speciﬁed front-panel control knob

connected adaptor module and ﬁrmware version

2-30 MSO4000 and DPO4000 Series Programmer Manual

Table 2-26: Miscellaneous Commands (cont.)

Command Groups

Command

HEADer

ID? Returns identifying information about the

*IDN? Returns the same information as the ID?

LANGuage Sets or returns the user interface display

LOCk Sets or returns the front panel lock state

*LRN? Returns a listing of oscilloscope settings

NEWpass

PASSWord Enables the *PUD and NEWpass set

REM

SET? Returns a listing of oscilloscope settings

TEKSecure Initializes both waveform and setup

TIME

TOTaluptime? Returns the total number of hours that the

*TRG Performs the group execute trigger (GET)

*TST? Tests the interface and returns the status

UNLock

USBTMC? Returns the USBTMC information used b y

USBTMC:PRODUCTID:DECimal? Returns the USBTMC product ID

USBTMC:PRODUCTID:HEXadecimal? Returns the USBTMC product ID

USBTMC:SERIALnumber?

USBTMC:VENDORID:DECimal? Returns the USBTMC vendor ID

USBTMC:VENDORID:HEXadecimal? Returns the US BTMC vendor ID

VERBose

Description

Sets or returns the Response Header Enable State

oscilloscope and its ﬁrmware

command except the data i s formatted according to Tektronix Codes & Formats

language

Changes the password for user protected data

commands

Speciﬁes a comment, which is ignored by the osc illoscope

memories

Sets or r eturns the time displayed by the oscilloscope

oscilloscope has been turned on since the nonvolatile memory was last programmed

Unlocks front panel

the USB hosts to determine the instrument interfaces

Returns the instrument serial number

Sets or returns the verbose state

MSO4000 and DPO4000 Series Programmer Manual 2-31

Command Groups

PictBridge Co

mmand Group

Power Command Group

Use the commands in the PictBridge Command Group to store printer settings.

Table 2-27: PictBridge Commands

Command

PICTBridge:DATEPrint

PICTBridge:DEFault Sets the arguments for all PICTBridge

PICTBridge:IDPrint

PICTBridge:IMAGESize Sets or returns the image print size

PICTBridge:PAPERSize Sets the output print paper size

PICTBridge:PAPERType Sets or returns the paper type

PICTBridge:PRINTQual Sets or returns the output print quality

USBDevice:CONFigure Enables or disables the rear USB port for

Description

Enables or disables printing the date on the print output

commands to their default values

Enables or disables printing the oscilloscope model and serial number on the print output

use with Pictbridge printers

Use the commands in the Power Command Group for power analysis. The power measurements include:

Power quality

Switching loss

Safe operating area

Harmonics

Ripple

Modulation analysis

This command group is available when the DPO4PWR application module is installed.

Table 2-28: Power Commands

Command Description

POWer:CURRENTSOurce Sets or returns the current source for the

power application

POWer:DISplay Sets or returns the display state for the

power application

POWer:GATESOurce Sets or returns the gate source for the power

application

2-32 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Table 2-28: Power Commands (cont.)

Command Description

POWer:GATing Sets or returns the power application gating

POWer:HARMonics:DISPlay:SELect Sets or returns the harmonics to be displayed

when the harmonics standard is None

POWer:HARMonics:DISPlay:TYPe Sets or returns the display type for harmonics

tests

POWer:HARMonics:FREQRef Sets or returns the frequency reference

waveform for harmonics tests

POWer:HARMonics:FREQRef: FIXEDFREQValue

POWer:HARMonics:IEC:CLAss Sets or returns the ﬁltering class for IEC

POWer:HARMonics:IEC:FILter Sets or returns the enabled state for ﬁltering

POWer:HARMonics:IEC:FUNDamental Sets or returns the fundamental current for

POWer:HARMonics:IEC:GROUPing Sets or returns the enabled state for grouping

POWer:HARMonics:IEC:INPUTPOWer Sets of returns the class D input power for

POWer:HARMonics:IEC:LINEFREQuency Sets or returns the line frequency for the IEC

POWer:HARMonics:IEC:OBSPERiod Sets or returns the IEC observation period

POWer:HARMonics:IEC:POWERFACtor Sets or returns the power factor for IEC

POWer:HARMonics:MIL:FUNDamental: CALCmethod

POWer:HARMonics:MIL:FUNDamental: USER:CURRent

POWer:HARMonics:MIL:LINEFREQuency Sets or returns the line frequency for

POWer:HARMonics:MIL:POWERLEVel Sets or returns the power level for

POWer:HARMonics:NR_HARMonics Sets of returns the number of harmonics (a

POWer:HARMonics:RESults:HAR<1-400>: FREQuency?

Sets or returns the ﬁxed reference frequency value for harmonics measurements

harmonics

of IEC harmonics

IEC harmonics

of IEC harmonics

IEC harmonics

standard

harmonics

Sets or returns the measurement method for the MIL harmonics fundamental frequency

Sets or returns RMS amperes for User calculation method

MIL-STD-1399 harmonics tests

value in the range of 20 to 400) when the harmonics standard is N ONe

Returns the frequency of the harmonic

MSO4000 and DPO4000 Series Programmer Manual 2-33

Command Groups

Table 2-28: Power Commands (cont.)

Command Description

POWer:HARMonics:RESults:HAR<1-400>: IECMAX?

POWer:HARMonics:RESults:HAR<1-400>: LIMit?

POWer:HARMonics:RESults:HAR<1-400>: PHASe?

POWer:HARMonics:RESults:HAR<1-400>: RMS:ABSolute?

POWer:HARMonics:RESults:HAR<1-400>: RMS:PERCent?

POWer:HARMonics:RESults:HAR<1-400>: TEST:IEC:CLAS SALIMit?

POWer:HARMonics:RESults:HAR<1-400>: TEST:IEC:NO RMAL?

POWer:HARMonics:RESults:HAR<1-400>: TEST:IEC:POHCLIMit?

POWer:HARMonics:RESults:HAR<1-400>: TEST:MIL:NORMAL?

POWer:HARMonics:RESults:IEC: FUNDamental?

POWer:HARMonics:RESults:IEC: HARM3ALTernate?

POWer:HARMonics:RESults:IEC: HARM5ALTernate?

POWer:HARMonics:RESults:IEC:POHC? Returns the IEC POHC measurement

The IEC standard speciﬁes harmonics measurements to be computed in windows of time, with each time window being nominally 200 ms. This returns the maximum of the RMS magnitude of the harmonic, computed across successive 200 ms time windows within an observation period entered by the user

The IEC and MIL standards specify a limit for each harmonic magnitude. Returns the limit in absolute units, or as a percentage of the fundamental as speciﬁed by the standard. IEC C lass C (Table 2) and MIL standards specify the limit as a percentage of the fundamental

Returns the phase of the harmonic in degrees. The phase is measured relative to the zero-crossing of the reference waveform. When there is no reference waveform, the phase is relative to the fundamental component

Returns the RMS magnitude of the harmonic expressed in absolute units

Returns the RMS magnitude of the harmonic expressed as a percentage of the fundamental

Returns PASS, FAIL or NA. Speciﬁes if the IEC Class A higher harmonic limit (and conditions) are met

Returns PASS, FAIL or NA. Speciﬁes if the Normal IEC harmonic limits are met

Returns PASS, FAIL or NA. Speciﬁes if the higher harmonic limit (and conditions) for the 21st and higher order odd harmonics are met

Returns the test result for the speciﬁed harmonic for the MIL-STD-1399 testing standard

Returns the IEC fundamental frequency

Returns the IEC harmonics test result for the 3rd harmonic: PASS, FAIL or NA

Returns the IEC harmonics test result for the 5th harmonic: PASS, FAIL or NA

2-34 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Table 2-28: Power Commands (cont.)

Command Description

POWer:HARMonics:RESults:IEC:POHL? Returns the IEC POHL measurement

POWer:HARMonics:RESults:IEC:POWer? Returns the IEC input power measurement

POWer:HARMonics:RESults:IEC: POWERFactor?

POWer:HARMonics:RESults:PASSFail?

POWer:HARMonics:RESults:RMS? Returns the root mean square value of the

POWer:HARMonics:RESults:SAVe Saves the harmonic results to the speciﬁed

POWer:HARMonics:RESults:THDF? Returns the Total Harmonic Distortion (THD)

POWer:HARMonics:RESults:THDR? Returns the Total Harmonic Distortion (THD)

POWer:HARMonics:SOURce Sets or returns the source waveform for

POWer:HARMonics:STANDard Sets or returns the s tandard for harmonics

POWer:INDICators Sets or returns the state of the measurement

POWer:MODulation:SOUrce Sets or returns the source waveform for

POWer:MODulation:TYPe Sets or returns the modulation type

POWer:QUALity:APPpwr?

POWer:QUALity:DISplay:APPpwr Sets or returns the display state for the

POWer:QUALity:DISplay:FREQuency Sets or returns the display state for the

POWer:QUALity:DISplay:ICRESTfactor Sets or returns the display state for the

POWer:QUALity:DISplay:IRMS Sets or returns the display state for the rms

POWer:QUALity:DISplay:PHASEangle Sets or returns the display state for the

POWer:QUALity:DISplay:POWERFACtor Sets or returns the display state for the

POWer:QUALity:DISplay:REACTpwr Sets or returns the display state for the

Returns the IEC power factor measurement

Returns the overall harmonics test result: PASS, FAIL or NA

source waveform

ﬁle in CSV format

in percentage, measured as a ratio to the RMS value of the fundamental component of the source waveform

in percentage, measured as a ratio to the RMS value of the source waveform

harmonics tests

tests

indicators for the power application

modulation tests

Returns the apparent power measurement

apparent power readout

frequency readout

current crest factor readout

current (IRMS) readout

phase angle readout

power factor readout

reactive power readout

MSO4000 and DPO4000 Series Programmer Manual 2-35

Command Groups

Table 2-28: Power Commands (cont.)

Command Description

POWer:QUALity:DISplay:TRUEpwr Sets or returns the display state for the true

power readout

POWer:QUALity:DISplay:VCRESTfactor Sets or returns the display state for the

voltage crest factor readout

POWer:QUALity:DISplay:VRMS Sets or returns the display state for the rms

voltage (VRMS) readout

POWer:QUALity:FREQREFerence Sets or returns the power quality frequency

reference

POWer:QUALity:FREQuency? Returns the frequency measurement

POWer:QUALity:ICRESTfactor? Returns the current crest factor measurement

POWer:QUALity:IRMS?

POWer:QUALity:PHASEangle?

POWer:QUALity:POWERFACtor? Returns the power factor measurement

POWer:QUALity:REACTpwr?

POWer:QUALity:TRUEpwr?

POWer:QUALity:VRMS?

POWer:REFLevel:ABSolute Sets the reference levels to their default unit

POWer:REFLevel:ABSolute:HIGH Sets or returns the top reference level for

POWer:REFLevel:ABSolute:LOW Sets or returns the low reference level for

POWer:REFLevel:ABSolute:MID<1-3> Sets or returns the mid reference level for

POWer:REFLevel:HYSTeresis Sets or returns the measurement reference

POWer:REFLevel:METHod Sets or returns the method used to calculate

POWer:REFLevel:PERCent Sets the reference levels to the default

POWer:REFLevel:PERCent:HIGH Sets or returns the top reference percent

POWer:REFLevel:PERCent:LOW Sets or returns the low reference percent

POWer:REFLevel:PERCent:MID<1-3> Sets or returns the mid reference percent

POWer:RIPPle Sets the vertical offset of the source

POWer:RIPPle:RESults:AMPLitude?

Returns the rms current measurement

Returns the phase angle measurement

Returns the reactive power measurement

Returns the true power measurement

Returns the rms voltage measurement

values

rise time

measurements

level hysteresis value

the 0% and 100% reference level

percentage values

level for rise time

level for waveform measurements

waveform

Returns the peak-to-peak ripple measurement

2-36 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Table 2-28: Power Commands (cont.)

Command Description

POWer:RIPPle:RESults:MAX? Returns the maximum of the peak-to-peak

ripple measurements

POWer:RIPPle:RESults:MEAN? Returns the mean of the peak-to-peak ripple

measurements

POWer:RIPPle:RESults:MIN? Returns the minimum of the peak-to-peak

ripple measurement

POWer:RIPPle:RESults:STDdev? Returns the standard deviation of the

peak-to-peak ripple measurements

POWer:RIPPle:SOUrce Sets or returns the source waveform for

ripple tests

POWer:SOA:LINear:XMAX Sets or returns the user XMAX value for use

in linear SOA calculations

POWer:SOA:LINear:XMIN Sets or returns the user XMIN value for use

in linear SOA calculations

POWer:SOA:LINear:YMAX Sets or returns the user YMAX value for use

in linear SOA calculations

POWer:SOA:LINear:YMIN Sets or returns the user YMIN value for use

in linear SOA calculations

POWer:SOA:LOG:XMAX Sets or returns the user XMAX value for u se

in log SOA calculations

POWer:SOA:LOG:XMIN Sets or returns the user XMIN value for use

in log SOA calculations

POWer:SOA:LOG:YMAX Sets or returns the user YMAX value for u se

in log SOA calculations

POWer:SOA:LOG:YMIN Sets or returns the user YMIN value for use

in log SOA calculations

POWer:SOA:MASK:DEFine Sets or returns the X (Volts) and Y (Amps)

coordinates of the current SOA mask

POWer:SOA:MASK:MAXAmps Sets or returns the maximum current applied

to SOA mask testing

POWer:SOA:MASK:MAXVolts Sets or returns the maximum voltage applied

to SOA mask testing

POWer:SOA:MASK:MAXWatts Sets or returns the maximum power applied

to SOA mask testing

POWer:SOA:MASK:NR_PT? Returns the number of mask points deﬁned

POWer:SOA:MASK:STATe Sets or returns the state of the mask for SOA

calculations

POWer:SOA:MASK:STOPOnviol Sets or returns the enabled state of the mask

stop on violation condition

POWer:SOA:PLOTTYPe Sets or returns the SOA plot type

POWer:SOA:RESult:FAILures:QTY? Returns the number of failures in the test

MSO4000 and DPO4000 Series Programmer Manual 2-37

Command Groups

Table 2-28: Power Commands (cont.)

Command Description

POWer:SOA:RESult:NUMACq? Returns the number of acquisitions in the test

POWer:SOA:RESult:STATe? Returns the pass/fail state of the SOA test

POWer:STATIstics Clears all the accumulated statistics of all

measurements

POWer:STATIstics:MODE Enables or disables the display of the

measurement statistics

POWer:STATIstics:WEIghting Sets the number of samples which are

included for the statistics computations for mean and the standard deviation

POWer:SWLoss:CONDCALCmethod Sets or returns the power application

switching loss conduction calculation method

POWer:SWLoss:CONDuction:ENERGY: MAX?

POWer:SWLoss:CONDuction:ENERGY: MEAN?

POWer:SWLoss:CONDuction:ENERGY: MIN?

POWer:SWLoss:CONDuction:POWER: MAX?

POWer:SWLoss:CONDuction:POWER: MEAN?

POWer:SWLoss:CONDuction:POWER: MIN?

POWer:SWLoss:DISplay Sets or returns the display selection for

POWer:SWLoss:GATe:POLarity Sets or returns the switching loss gate

POWer:SWLoss:GATe:TURNON Sets or returns the gate turn on level for

POWer:SWLoss:NUMCYCles? Returns the number of cycles counted for the

POWer:SWLoss:RDSon Sets or returns RDSON value for use

POWer:SWLoss:REFLevel:ABSolute: GATEMid

POWer:SWLoss:REFLevel:ABSolute: LOWCurrent

Returns the maximum conduction energy for the switching loss calculation

Returns the mean conduction energy for the switching loss calculation

Returns the minimum conduction energy for the switching loss calculation

Returns the maximum conduction power for the switching loss calculation

Returns the mean conduction power for the switching loss calculation

Returns the minimum c onduction power for the switching loss calculation

switching loss results

polarity

switching loss power measurements

switching loss calculation

in switching loss calculations when the conduction calculation method is RDSON

Sets or returns the mid voltage reference level used in switching loss power measurements in volts

Sets or returns the low current reference level used in switching loss power measurements in amperes

2-38 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Table 2-28: Power Commands (cont.)

Command Description

POWer:SWLoss:REFLevel:ABSolute: LOWVoltage

POWer:SWLoss:REFLevel:PERCent: GATEMid

POWer:SWLoss:REFLevel:PERCent: LOWCurrent

POWer:SWLoss:REFLevel:PERCent: LOWVoltage

POWer:SWLoss:TOFF:ENERGY:MAX? Returns the maximum Toff energy switching

POWer:SWLoss:TOFF:ENERGY:MEAN? Returns the mean Toff energy switching loss

POWer:SWLoss:TOFF:ENERGY:MIN? Returns the minimum Toff energy switching

POWer:SWLoss:TOFF:POWER:MAX? Returns the maximum Toff power switching

POWer:SWLoss:TOFF:POWER:MEAN? Returns the mean Toff power switching loss

POWer:SWLoss:TOFF:POWER:MIN? Returns the minimum Toff power switching

POWer:SWLoss:TON:ENERGY:MAX?

POWer:SWLoss:TON:ENERGY:MEAN?

POWer:SWLoss:TON:ENERGY:MIN?

POWer:SWLoss:TON:POWER:MAX?

POWer:SWLoss:TON:POWER:MEAN?

POWer:SWLoss:TON:POWER:MIN?

POWer:SWLoss:TOTal:ENERGY:MAX?

POWer:SWLoss:TOTal:ENERGY:MEAN?

POWer:SWLoss:TOTal:ENERGY:MIN?

Sets or returns the low voltage reference level used in switching loss power measurements in volts

Sets or returns the mid voltage reference level used in switching loss power measurements in percentage

Sets or returns the low current reference level used in switching loss power measurements in percentage

Sets or returns the low voltage reference level used in switching loss power measurements in percentage

loss calculation

calculation

loss calculation

calculation

loss calculation

Returns the maximum Ton energy switching loss calculation

Returns the mean Ton energy switching loss calculation

Returns the minimum Ton energy switching loss calculation

Returns the maximum Ton power switching loss calculation

Returns the mean Ton power switching loss calculation

Returns the minimum Ton power switching loss calculation

Returns the maximum total energy switching loss calculation

Returns the mean total energy switching loss calculation

Returns the minimum total energy switching loss calculation

MSO4000 and DPO4000 Series Programmer Manual 2-39

Command Groups

Table 2-28: Power Commands (cont.)

Command Description

POWer:SWLoss:TOTal:POWER:MAX?

POWer:SWLoss:TOTal:POWER:MEAN?

POWer:SWLoss:TOTal:POWER:MIN?

POWer:SWLoss:VCEsat Sets or returns VCESAT value for use

POWer:TYPe Sets or returns the power application

POWer:VOLTAGESOurce Sets or returns the voltage source for the

Save and Recall Command Group

Returns the maximum total power switching loss calculation

Returns the mean total power switching loss calculation

Returns the minimum total power switching loss calculation

in switching loss calculations when the conduction calculation method is VCESAT

measurement type

power application

UsethecommandsintheSaveandRecallCommand Group to store and retrieve waveforms and settings. When you save a setup, you save all the settings of the oscilloscope. When you recall a setup, the oscilloscope restores itself to the state

s in when you originally saved the setting.

it wa

Table 2-29: Save and Recall Commands

Command

FACtory Resets the oscilloscope to factory default

*RCL

RECAll:SETUp

RECAll:WAVEform Recalls a stored waveform to a reference

*SAV Stores the state of the oscilloscope to a

SAVe:ASSIgn:TYPe Sets or returns the assignment of the save

SAVe:EVENTtable:BUS<x> Saves event table data from bus<x> to a

SAVe:IMAGe Saves a capture o f the screen image to the

Description

settings

Recalls saved oscilloscope settings

location

speciﬁed memory location

button

speciﬁed ﬁle

2-40 MSO4000 and DPO4000 Series Programmer Manual

Table 2-29: Save and Recall Commands (cont.)

Command Groups

Command

SAVe:IMAGe:FILE Format Sets or returns the ﬁle format to use for

SAVe:IMAGe:INKSaver Sets or returns the current inksaver setting

SAVe:IMAGe:LAYout Sets or returns the layout to use for saved

SAVe:SETUp Saves the state of the oscilloscope to a

SAVe:WAVEform Saves a waveform to one of the reference

SAVe:WAVEform:FILEFormat Sets or returns the format for saved

SAVe:WAVEform:GATIng Speciﬁes whether save waveform operations

SETUP<x>:DATE? Returns the date when the speciﬁed

SETUP<x>:LABEL Sets or returns the speciﬁed oscilloscope

SETUP<x>:TIME? Returns the time when the speciﬁed

Description

saving screen images. The ﬁle format is not automatically determined by the ﬁle name extension. You need to choose a ﬁle name with an extension which is consistent with the selected ﬁle format

for the SAVe:IMAGe command

screen images

speciﬁed memory location or ﬁle

memory locations or a ﬁ le

waveforms

should save the entire waveform or a speciﬁed portion of the waveform

oscilloscope setup was saved

setup label

oscilloscope setup was saved

Search Command Group

Use the commands in the Search Commands Group to seek out information in waveform records.

Search Commands

Command Description

SEARCH?

SEARCH:SEARCH<x>:COPy Copies the search criteria to the trigger, or

SEARCH:SEARCH<x>:STATE Sets the search state to on or off

SEARCH:SEARCH<x>:TOTAL? Returns the total number of matches for

SEARCH:SEARCH<x>:TRIGger:A:BUS?

MSO4000 and DPO4000 Series Programmer Manual 2-41

Returns all search-related settings

the trigger criteria to the search.

search <x>

Returns the search trigger bus type

Command Groups

Search Commands (cont.)

Command Description

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<1-4>:AUDio:CONDition

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<1-4>:AUDio:DATa:HIVALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<1-4>:AUDio:DATa:OFFSet

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<1-4>:AUDio:DATa:QUALiﬁer

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<1-4>:AUDio:DATa:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<1-4>:AUDio:DATa:WORD

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:CAN:CONDition

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:CAN:DATa:DIRection

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:CAN:DATa:QUALiﬁer

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:CAN:DATa:SIZe

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:CAN:DATa:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:CAN:FRAMEtype

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:CAN{:IDentiﬁer|:ADDRess}:MODe

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:CAN{:IDentiﬁer|:ADDRess}:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:CONDition

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:CYCLEcount:HIVALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:CYCLEcount:QUALiﬁer

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:CYCLEcount:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:DATa:HIVALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:DATa:OFFSet

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:DATa:QUALiﬁer

Sets or returns the search trigger condition for the AUDIO bus: Start of Frame or Data

Sets or returns the search trigger data upper word for the AUDIO bus

Sets or returns the search trigger data offset for the AUDIO bus

Sets or returns the search trigger data qualiﬁer for the AUDIO bus

Sets or returns the search trigger data lower word for the AUDIO bus

Sets or returns the search trigger data alignment for the AUDIO bus

Sets or returns the search condition for CAN search

Sets or returns the CAN search condition to be valid on a READ, WRITE or either

Sets or returns the CAN data qualiﬁer

Sets or returns the length of the data string in bytes to be used for CAN search

Sets or returns the binary data string to be used for CAN search

Sets or returns the CAN Frame Type to be used

Sets or returns the CAN addressing mode to standard or extended format

Sets or returns the binary address string to be used for CAN search

Sets or returns the trigger condition for FLEXRAY

Sets or returns the binary data string to be used for FLEXRAY cycle count high value

Sets or returns the FLEXRAY cycle count qualiﬁer

Sets or returns the binary data string to be used for FLEXRAY cycle count low value

Sets or returns the high binary data string

Sets or returns the offset of the data string in bytes

Sets or returns the FLEXRAY data qualiﬁer

2-42 MSO4000 and DPO4000 Series Programmer Manual

Search Commands (cont.)

Command Description

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:DATa:SIZe

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:DATa:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:EOFTYPE

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:ERRTYPE

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:FRAMEID:HIVALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:FRAMEID:QUALiﬁer

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:FRAMEID:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:FRAMEType

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:HEADER:CRC

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:HEADER:CYCLEcount

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:HEADER:FRAMEID

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:HEADER:INDBits

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:HEADER:PAYLength

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:I2C:ADDRess:MODe

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:I2C:ADDRess:TYPe

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:I2C:ADDRess:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:I2C:CONDition

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:I2C:DATa:DIRection

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:I2C:DATa:SIZe

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:I2C:DATa:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:LIN:CONDition

Sets or returns the length of the data string in bytes

Sets or returns the low binary data string

Sets or returns the end of frame type

Sets or returns the error type

Sets or returns the binary data string used for FLEXRAY frame ID high value

Sets or returns the FLEXRAY frame ID qualiﬁer

Sets or returns the binary data string to be used for FLEXRAY frame ID low value

Sets or returns the frame type

Sets or returns the CRC portion of the binary header string

Sets or returns the cycle count portion of the binary header string

Sets or returns the frame id portion of the binary header string

Sets or returns the indicator bits portion of the binary header string

Sets or returns the payload length portion of the binary header string

Sets or returns the I2C address mode to 7 or 10-Bit

Sets or returns the I2C address type to I2C special addresses

Sets or returns the binary address string to be used for I2C search

Sets or returns the search condition for I2C search

Sets or returns the I2C search condition to be valid on a READ, WRITE or either

Sets or returns the length of the data string inbytestobeusedforI2Csearch

Sets or returns the binary data string to be used for I2C search

Sets or returns the search condition for a LIN search

Command Groups

MSO4000 and DPO4000 Series Programmer Manual 2-43

Command Groups

Search Commands (cont.)

Command Description

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:LIN:DATa:HIVALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:LIN:DATa:QUALiﬁer

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:LIN:DATa:SIZe

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:LIN:DATa:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:LIN:ERRTYPE

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:LIN:IDentiﬁer:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:PARallel:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:RS232C:CONDition

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:RS232C:RX:DATa:S IZe

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:RS232C:RX:DATa:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:RS232C:TX:DATa:SIZe

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:RS232C:TX:DATa:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:SPI:CONDition

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:SPI:DATa{:MISO|:IN}:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:SPI:DATa{:MOSI|:OUT}:VALue

SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:SPI:DATa:SIZe

SEARCH:SEARCH<x>:TRIGger:A:BUS: SOUrce

SEARCH:SEARCH<x>:TRIGger:A:EDGE: SLOpe

SEARCH:SEARCH<x>:TRIGger:A:EDGE: SOUrce

Sets or returns the binary data string

Sets or returns the LIN data qualiﬁer

Sets or returns the length of the data string in bytes

Sets or returns the binary data string used for a LIN search

Sets or returns the error type used for a LIN Search

Sets or returns the binary address string used for LIN search

Sets or returns the binary data string to be used for a Parallel search

Sets or returns the trigger condition for an RS-232 trigger

Sets or returns the length of the data string for an RS-232 trigger, if the trigger condition is RX

Sets or returns the binary data string for an RS-232 trigger, if the condition involves RX

Sets or returns the length of the data string to be used for an RS-232 Trigger, if the Trigger condition is TX

Sets or returns the binary data string to be used for an RS-232 trigger, if the condition involves RX

Sets or returns the search condition for SPI search

Sets or returns the binary data string to be used for SPI search if the search condition is MISO or MISOMOSI

Sets or returns the binary data string for an SPI search if the search condition is MISO or MISOMOSI

Sets or returns the length of the data string in bytes to be used for SPI search

Sets or returns the bus for a serial search

Sets or returns the slope for an edge search

Sets or returns the source waveform for an edge search

2-44 MSO4000 and DPO4000 Series Programmer Manual

Search Commands (cont.)

Command Groups

Command Description

SEARCH:SEARCH<x>:TRIGger:A:LEVel Sets or returns the level for an edge search

SEARCH:SEARCH<x>:TRIGger:A:LEVel: CH<x>

SEARCH:SEARCH<x>:TRIGger:A:LEVel: MATH

SEARCH:SEARCH<x>:TRIGger:A:LEVel: REF<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: FUNCtion

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: INPut:CH<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: INPut:CLOCk:EDGE

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: INPut:CLOCk:SOUrce

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: INPut:D<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: INPut:MATH

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: INPut:REF<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: PATtern:INPut:CH<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: PATtern:INPut:D<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: PATtern:INPut:MATH

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: PATtern:INPut:REF<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: PATtern:WHEn

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: PATtern:WHEn:LESSLimit

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: PATtern:WHEn:MORELimit

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: THReshold:CH<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: THReshold:MATH

Sets or returns the level for an edge search of the speciﬁed channel

Sets or returns the math waveform level for edge search

Sets or returns the reference waveform level for edge search

Sets or returns the logic operator for the logic search

Sets or returns the Boolean logic criteria for the logic search

Sets or returns whether the clock edge is rise or fall for a logic s earch

Sets or returns the clock source deﬁnition for logic search

Sets or returns the criteria for a logic search to determine where to place a mark for digital channel <x>

Sets or returns the Boolean logic criteria for the logic search

Sets or returns the criteria for a pattern search to determine wheretoplaceamark for digital channel <x>

Sets or returns the Boolean logic criteria for the logic search

Sets or returns the condition for generating a logic pattern search

Sets or returns the maximum time that the selected pattern may be true

Sets or returns the minimum time that the selected pattern may be true

Sets or returns the c hannel threshold level for an logic search

Sets or returns the m ath waveform threshold level for logic search

MSO4000 and DPO4000 Series Programmer Manual 2-45

Command Groups

Search Commands (cont.)

Command Description

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: THReshold:REF<x>

SEARCH:SEARCH<x>:TRIGger:A: LOWerthreshold:CH<x>

SEARCH:SEARCH<x>:TRIGger:A: LOWerthreshold:MATH

SEARCH:SEARCH<x>:TRIGger:A: LOWerthreshold:REF<x>

SEARCH:SEARCH<x>:TRIGger:A: PULSEWidth:POLarity

SEARCH:SEARCH<x>:TRIGger:A: PULSEWidth:SOUrce

SEARCH:SEARCH<x>:TRIGger:A: PULSEWidth:WHEn

SEARCH:SEARCH<x>:TRIGger:A: PULSEWidth:WIDth

SEARCH:SEARCH<x>:TRIGger:A:RUNT: POLarity

SEARCH:SEARCH<x>:TRIGger:A:RUNT: SOUrce

SEARCH:SEARCH<x>:TRIGger:A:RUNT: WHEn

SEARCH:SEARCH<x>:TRIGger:A:RUNT: WIDth

SEARCH:SEARCH<x>:TRIGger:A: SETHold:CLOCk:EDGE

SEARCH:SEARCH<x>:TRIGger:A: SETHold:CLOCk:SOUrce

SEARCH:SEARCH<x>:TRIGger:A: SETHold:CLOCk:THReshold

SEARCH:SEARCH<x>:TRIGger:A: SETHold:DATa:SOUrce

SEARCH:SEARCH<x>:TRIGger:A: SETHold:DATa:THReshold

SEARCH:SEARCH<x>:TRIGger:A: SETHold:HOLDTime

SEARCH:SEARCH<x>:TRIGger:A: SETHold:SETTime

SEARCH:SEARCH<x>:TRIGger:A: SETHold:THReshold:CH<x>

SEARCH:SEARCH<x>:TRIGger:A: SETHold:THReshold{:MATH|:MATH1}

Sets or returns the reference waveform threshold level for l ogic search

Sets or returns the lower waveform threshold level for all channel waveform searches

Sets or returns the lower waveform threshold level for all math waveform searches

Sets or returns the lower waveform threshold level for all reference waveform searches

Sets or returns the polarity for a pulse search

Sets or returns the source waveform for a pulse search

Sets or returns the condition for generating a pulse width search

Sets or returns the pulse width s etting for a pulse width search

Sets or returns the polarity setting for a runt search

Sets or returns the source setting for a runt search

sets or returns the condition setting for a runt search

Sets or returns the width setting for a runt search

Sets or returns the clock slope setting for a setup/hold search

Sets or returns the c lock source setting for an setup/hold search

Sets or returns the clock threshold setting for an setup/hold search

Sets or returns the data source setting for an setup/hold search

Sets or returns the data threshold setting for an setup/hold search

Sets or returns the hold time setting for an setup/hold search

Sets or returns the setup time setting for an setup/hold search

Sets or returns the trigger search setup and hold threshold for the selected channel

Sets or returns the trigger search setup and hold threshold for the math waveform

2-46 MSO4000 and DPO4000 Series Programmer Manual

Search Commands (cont.)

Command Groups

Command Description

SEARCH:SEARCH<x>:TRIGger:A: SETHold:THReshold:REF<x>

SEARCH:SEARCH<x>:TRIGger:A{: TRANsition|:RISEFall}:DELTatime

SEARCH:SEARCH<x>:TRIGger:A{: TRANsition|:RISEFall}:POLarity

SEARCH:SEARCH<x>:TRIGger:A{: TRANsition|:RISEFall}:SOUrce

SEARCH:SEARCH<x>:TRIGger:A{: TRANsition|:RISEFall}:WHEn

SEARCH:SEARCH<x>:TRIGger:A:TYPe Sets or returns the trigger type setting for a

SEARCH:SEARCH<x>:TRIGger:A: UPPerthreshold:CH<x>

SEARCH:SEARCH<x>:TRIGger:A: UPPerthreshold:MATH

SEARCH:SEARCH<x>:TRIGger:A: UPPerthreshold:REF<x>

Sets or returns the trigger search setup and hold threshold for the selected reference waveform

Sets or returns the transition time setting for an transition search

Sets or returns the polarity setting for an transition search

Sets or returns the source setting for an transition search

Sets or returns the condition setting for an transition search

Sets or returns the waveform upper threshold level for all channel waveform searches

Sets or returns the waveform upper threshold level for all math waveform searches

Sets or returns the waveform upper threshold level for all reference waveform searches

Status and Error Command Group

Use the commands in the Status and Error Command Group to determine the status of the oscilloscope and control events.

Several commands and queries used with the oscilloscope are common to all IEEE488.2 compliant devices. The IEEE Std 488.2-1987 deﬁnes these commands and queries. The common commands begin with an asterisk (*) character.

Table 2-30: Status and Error Commands

Command

ALLEv?

BUSY?

*CLS Clears s tatus

DESE Sets or r eturns the bits in the Device Event

*ESE Sets or returns the bits in the Event Status

*ESR? Returns the contents of the S tandard Event

EVENT? Returns event code from the e vent queue

Description

Returns all events and their messages

Returns oscilloscope status

Status Enable Register

Enable Register

Status Register

MSO4000 and DPO4000 Series Programmer Manual 2-47

Command Groups

Table 2-30: Status and Error Commands (cont.)

Command

EVMsg? Returns event code, message from the event

EVQty? Return number of events in the event queue

*OPC Generates the operation complete message

*PSC Sets or returns the power on status ﬂag

*PUD Sets or returns a string of protected user data

*RST Resets the oscilloscope to factory default

*SRE Sets or returns the bits in the Service

*STB? Returns the contents of the Status Byte

*WAI Prevents the oscilloscope from executing

Description

queue

in the standard event status register when all pending operations are ﬁnished

Or returns "1" when all current operations are ﬁnished

settings

Request Enable Register

further commands until all pending operations ﬁnish

Trigger Command Group

Use the commands in the Trigger Command Group to control all aspects of triggering for the oscilloscope.

There are two triggers: A and B. Where appropriate, this command set has parallel construction between triggers.

You can set the A or B triggers to edge mode. Edge triggering lets you display a waveform at or near the p oint where the signal passes through a voltage level of your choosing.

You can also set A triggers to pulse, logic the oscilloscope triggers whenever it detects a pulse of a certain width or height. Logic triggering lets you logically combine the signals on one or channels. The oscilloscope then triggers when it detects a certain combination of signal levels. Video triggering enables you to trigger on the most common Standard Deﬁnition video standards.

Table 2-31: Trigger Commands

Command

TRIGger

, or video modes. With pulse triggering,

Description

Forces a trigger event to occur

2-48 MSO4000 and DPO4000 Series Programmer Manual

Table 2-31: Trigger Commands (cont.)

Command Groups

Command

TRIGger:A Sets A trigger level to 50%

TRIGger:A:BUS Sets or returns the serial

TRIGger:A:BUS:B<1-4>:AUDio:CONDition Sets or returns the trigger

TRIGger:A:BUS:B<1-4>:AUDio:DATa:HIVALue Sets or returns the trigger

TRIGger:A:BUS:B<1-4>:AUDio:DATa:OFFSet Sets or returns the trigger

TRIGger:A:BUS:B<1-4>:AUDio:DATa:QUALiﬁer Sets or returns the trigger

TRIGger:A:BUS:B<1-4>:AUDio:DATa:VALue Sets or returns the trigger

TRIGger:A:BUS:B<1-4>:AUDio:DATa:WORD Sets or returns the trigger

TRIGger:A:BUS:B<x>:CAN:CONDition Sets or returns the CAN

TRIGger:A:BUS:B<x>:CAN:DATa:DIRection Sets or returns the CAN

TRIGger:A:BUS:B<x>:CAN:DATa:QUALiﬁer Sets or returns the CAN data

TRIGger:A:BUS:B<x>:CAN:DATa:SIZe Sets or returns the length of

TRIGger:A:BUS:B<x>:CAN:DATa:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:CAN:FRAMEtype Sets or returns the CAN

TRIGger:A:BUS:B<x>:CAN{:IDentiﬁer|:ADDRess}:MODe Sets or returns the CAN

TRIGger:A:BUS:B<x>:CAN{:IDentiﬁer|:ADDRess}:VALue Sets or returns the binary

Description

or returns current A trigger parameters

trigger type

condition for the AUDIO bus: Start of Frame or Data

data upper word for the AUDIO bus

dataoffsetfortheAUDIO bus

data qualiﬁer for the AUDIO bus

data lower word for the AUDIO bus

data alignment for the AUDIO bus.

condition

trigger condition to be valid on a READ, WRITE, or either

qualiﬁer

thedatastringinbytestobe used for CAN trigger

datastringtobeusedfor CAN trigger

trigger frame type

addressing mode

address string used for the CAN trigger

MSO4000 and DPO4000 Series Programmer Manual 2-49

Command Groups

Table 2-31: Trigger Commands (cont.)

Command

TRIGger:A:BUS:B<x>:FLEXray:CONDition Sets or returns the trigger

TRIGger:A:BUS:B<x>:FLEXray:CYCLEcount:HIVALue Sets or returns the binary

TRIGger:A:BUS:B<x>:FLEXray:CYCLEcount:QUALiﬁer Sets or returns the FLEXRAY

TRIGger:A:BUS:B<x>:FLEXray:CYCLEcount:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:FLEXray:DATa:HIVALue Sets or returns the high

TRIGger:A:BUS:B<x>:FLEXray:DATa:OFFSet Sets or returns the offset of

TRIGger:A:BUS:B<x>:FLEXray:DATa:QUALiﬁer Sets or returns the FLEXRAY

TRIGger:A:BUS:B<x>:FLEXray:DATa:SIZe Sets or returns the length of

TRIGger:A:BUS:B<x>:FLEXray:DATa:VALue Sets or returns the low binary

TRIGger:A:BUS:B<x>:FLEXray:EOFTYPE Sets or returns the end of ﬁle

TRIGger:A:BUS:B<x>:FLEXray:ERRTYPE Sets or returns the error type

TRIGger:A:BUS:B<x>:FLEXray:FRAMEID:HIVALue Sets or returns the binary

TRIGger:A:BUS:B<x>:FLEXray:FRAMEID:QUALiﬁer Sets or returns the FLEXRAY

TRIGger:A:BUS:B<x>:FLEXray:FRAMEID:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:FLEXray:FRAMEType Sets or returns the frame

TRIGger:A:BUS:B<x>:FLEXray:HEADER:CRC Sets or returns the CRC

Description

condition for FLEXRAY

datastringtobeusedfor FLEXRAY cycle count high value

cycle count qualiﬁer

datastringtobeusedfor FLEXRAY cycle count low value

binary data string to be used for FLEXRAY trigger

thedatastringinbytes

data qualiﬁer

thedatastringinbytes

datastringtobeusedfor FLEXRAY trigger condition

type

datastringtobeusedfor FLEXRAY frame ID high value

frame ID qualiﬁer

datastringtobeusedfor FLEXRAY frame ID low value

type

portion of the binary header string

2-50 MSO4000 and DPO4000 Series Programmer Manual

Table 2-31: Trigger Commands (cont.)

Command Groups

Command

TRIGger:A:BUS:B<x>:FLEXray:HEADER:CYCLEcount Sets or returns the c ycle

TRIGger:A:BUS:B<x>:FLEXray:HEADER:FRAMEID Sets or returns the frame id

TRIGger:A:BUS:B<x>:FLEXray:HEADER:INDBits Sets or returns the indicator

TRIGger:A:BUS:B<x>:FLEXray:HEADER:PAYLength Sets or returns the payload

TRIGger:A:BUS:B<x>:I2C:ADDRess:MODe Sets or returns the I2C

TRIGger:A:BUS:B<x>:I2C:ADDRess:TYPe Sets or returns the I2C

TRIGger:A:BUS:B<x>:I2C:ADDRess:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:I2C:CONDition Sets or returns the trigger

TRIGger:A:BUS:B<x>:I2C:DATa:DIRection Sets or returns the I2C

TRIGger:A:BUS:B<x>:I2C:DATa:SIZe Sets or returns the length of

TRIGger:A:BUS:B<x>:I2C:DATa:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:LIN:CONDition Sets or returns the trigger

TRIGger:A:BUS:B<x>:LIN:DATa:HIVALue Sets or returns the binary

TRIGger:A:BUS:B<x>:LIN:DATa:QUALiﬁer Sets or returns the LIN data

TRIGger:A:BUS:B<x>:LIN:DATa:SIZe Sets or returns the length of

TRIGger:A:BUS:B<x>:LIN:DATa:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:LIN:ERRTYPE Sets or returns the error type

Description

count portion of the binary header string

portion of the binary header string

bits portion of the binary header string

length portion of the binary header string

address mode to 7 or 10-bit

address type to USER

address string used for the I2C trigger

condition for I2C trigger

trigger condition valid on a READ, WRITE, or either

thedatastringinbytestobe used for I2C trigger

datastringusedforI2C triggering

condition for LIN

datastringtobeusedforLIN trigger

qualiﬁer

thedatastringinbytestobe used for LIN trigger

data string

MSO4000 and DPO4000 Series Programmer Manual 2-51

Command Groups

Table 2-31: Trigger Commands (cont.)

Command

TRIGger:A:BUS:B<x>:LIN:IDentiﬁer:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:PARallel:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:RS232C:CONDition Sets or returns the condition

TRIGger:A:BUS:B<x>:RS232C:RX:DATa:SIZe Sets or returns the length of

TRIGger:A:BUS:B<x>:RS232C:RX:DATa:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:RS232C:TX:DATa:SIZe Sets or returns the length

TRIGger:A:BUS:B<x>:RS232C:TX:DATa:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:SPI:CONDition Sets or returns the trigger

TRIGger:A:BUS:B<x>:SPI:DATa{:IN|:MISO}:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:SPI:DATa{:OUT|:MOSI}:VALue Sets or returns the binary

TRIGger:A:BUS:B<x>:SPI:DATa:SIZe Sets or returns the length of

TRIGger:A:BUS:SOUrce Sets or returns the source

TRIGger:A:EDGE?

TRIGger:A:EDGE:COUPling Sets or returns the type

TRIGger:A:EDGE:SLOpe Sets or returns the slope for

TRIGger:A:EDGE:SOUrce Sets or returns the source

Description

address string used for LIN trigger

datastringtobeusedfora Parallel trigger

for an RS-232C trigger

the data string in Bytes for an RX RS-232 Trigger

data string for an RX RS-232 trigger

of the data string for a TX RS-232 trigger

data string for an RS-232 trigger if the trigger condition involves TX

condition for SPI triggering

datastringtobeusedforSPI trigger

data string used for the SPI trigger

thedatastringinbytestobe used for SPI trigger

for a bus trigger

Returns the source, coupling and source for the A edge trigger

of coupling for the A edge trigger

the A edge trigger

for the A edge trigger

2-52 MSO4000 and DPO4000 Series Programmer Manual

Table 2-31: Trigger Commands (cont.)

Command Groups

Command

TRIGger:A:HOLDoff? Returns the A trigger holdoff

TRIGger:A:HOLDoff:TIMe Sets or returns the A trigger

TRIGger:A:LEVel Sets or returns the trigger

TRIGger:A:LEVel:AUXin Sets or returns the trigger

TRIGger:A:LEVel:CH<x> Speciﬁes or returns the

TRIGger:A:LEVel:D<x> Sets or returns the trigger

TRIGger:A:LOGIc?

TRIGger:A:LOGIc:CLAss Sets or returns the type of A

TRIGger:A:LOGIc:FUNCtion Sets or returns the logical

TRIGger:A:LOGIc:INPut?

TRIGger:A:LOGIc:INPut:CH<x> Speciﬁes or returns the

TRIGger:A:LOGIc:INPut:CLOCk:EDGE Sets the polarity of the clock

TRIGger:A:LOGIc:INPut:CLOCk:SOUrce Sets or returns the channel

TRIGger:A:LOGIc:INPut:D<x> Sets or returns the logic

TRIGger:A:LOGIc:PATtern? Returns the conditions for

TRIGger:A:LOGIc:PATtern:D ELTatime Sets or returns the pattern

TRIGger:A:LOGIc:PATtern:INPut:D<x> Sets or returns the A logic

Description

parameters

holdoff time

level for the A trigger

level for the AUXIN port

trigger level for the speciﬁed trigger channel

level for the speciﬁed digital channel

Returns all A trigger logic settings

trigger logic

combination of the input channels for the A logic trigger

Returns the logic input values for all channels

logic setting for the speciﬁed channel

channel

to use as the clock source

pattern for a trigger on digital channel <x>

generating an A logic pattern trigger

trigger delta time value

trigger pattern for a trigger on digital channel <x>

MSO4000 and DPO4000 Series Programmer Manual 2-53

Command Groups

Table 2-31: Trigger Commands (cont.)

Command

TRIGger:A:LOGIc:PATtern:WH En Sets or returns the pattern

TRIGger:A:LOGIc:PATtern:WHEn:LESSLimit Sets or returns the maximum

TRIGger:A:LOGIc:PATtern:WH En:M OR ELim i t Sets or returns the minimum

TRIGger:A:LOGIc:THReshold:CH<x> Sets or queries the trigger

TRIGger:A:LOGIc:THReshold:D<x> Sets or returns the trigger A

TRIGger:A:LOWerthreshold:CH<x> Sets or returns the lower

TRIGger:A:LOWerthreshold:D<x> Sets the A trigger lower

TRIGger:A:LOWerthreshold{:EXT|:AUX} Sets or returns the lower

TRIGger:A:MODe Sets or returns the A trigger

TRIGger:A:PULse?

TRIGger:A:PULse:CLAss Sets or returns the type of

TRIGger:A:PULSEWIDth?

TRIGger:A:PULSEWidth:POLarity Sets or returns the polarity

TRIGger:A:PULSEWidth:SOUrce Sets or returns the source

TRIGger:A:PULSEWidth:WHEn Sets or returns the criteria for

TRIGger:A:PULSEWidth:WIDth Sets or returns the width

Description

logic condition on which to trigger the oscilloscope

time that the selected pattern may be true and still generate an A logic pattern trigger

A logic threshold voltage for the speciﬁed channel

logic threshold level for the speciﬁed digital channel

threshold for the channel selected

threshold for the digital channel selected

threshold for the Auxiliary input.

mode

Returns the A pulse trigger parameters

pulse on which to trigger

Returns the trigger A pulse width parameters

for the A pulse width trigger

for the pulse width trigger

width speciﬁcation of pulse width trigger events

setting for the pulse width trigger

2-54 MSO4000 and DPO4000 Series Programmer Manual

Table 2-31: Trigger Commands (cont.)

Command Groups

Command

TRIGger:A:RUNT?

TRIGger:A:RUNT:POLarity Sets or returns the polarity

TRIGger:A:RUNT:SOUrce Sets or returns the source

TRIGger:A:RUNT:WHEn Sets or returns the type

TRIGger:A:RUNT:WIDth Sets or returns the minimum

TRIGger:A:SETHold? Returns settings for setup

TRIGger:A:SETHold:CLOCk?

TRIGger:A:SETHold:CLOCk:EDGE Sets or returns the clock

TRIGger:A:SETHold:CLOCk:SOUrce Sets or returns the clock

TRIGger:A:SETHold:CLOCk:THReshold Sets or returns the clock

TRIGger:A:SETHold:DATa?

TRIGger:A:SETHold:DATa:SOUrce Sets or returns the data

TRIGger:A:SETHold:DATa:THReshold Sets or returns the data

TRIGger:A:SETHold:HOLDTime Sets or returns the hold

TRIGger:A:SETHold:SETTime Sets or returns the setup

TRIGger:A:SETHold:THReshold:CH<x> Sets or queries the threshold

Description

Returns the current A runt pulse trigger logic parameters

for the A pulse runt trigger

for the A pulse trigger

of pulse width the trigger checks for when it uncovers a runt

width for A pulse runt trigger

and hold violation triggering

Returns clock edge polarity, voltage threshold and source input for setup/hold triggering

edge polarity for setup and hold triggering

source for the A logic trigger setup and hold input

voltage threshold for setup and hold trigger

Returns the voltage threshold and data source for the setup/hold trigger

source for the setup and hold trigger

voltage threshold for setup and hold trigger

time for the setup and hold violation triggering

time for setup and hold violation triggering

for the channel

MSO4000 and DPO4000 Series Programmer Manual 2-55

Command Groups

Table 2-31: Trigger Commands (cont.)

Command

TRIGger:A:SETHold:THReshold:D<x> Sets the A trigger setup

TRIGger:A:UPPerthreshold:CH<x> Sets the upper threshold for

TRIGger:A{:TRANsition|:RISEFall}?

TRIGger:A{:TRANsition|:RISEFall}:DELTatime Sets or returns the delta

TRIGger:A{:TRANsition|:RISEFall}:POLarity Sets or returns the polarity

TRIGger:A{:TRANsition|:RISEFall}:SOUrce Sets or returns the source

TRIGger:A{:TRANsition|:RISEFall}:WHEn Sets or returns the

TRIGger:A:TYPe Sets or returns the type of A

TRIGger:A:VIDeo?

TRIGger:A:VIDeo:CUSTom{:FORMat|:TYPE} Sets or returns the video

TRIGger:A:VIDeo:CUSTom:LINEPeriod Sets or queries the line

TRIGger:A:VIDeo:CUSTom:SCAN Sets or returns the horizontal

TRIGger:A:VIDeo:CUSTom:SYNCInterval Sets or queries the sync

TRIGger:A:VIDeo:HDtv:FORMat Sets or returns the HDTV

TRIGger:A:VIDeo:HOLDoff:FIELD Sets or returns the video

TRIGger:A:VIDeo:LINE Sets or returns the video

TRIGger:A:VIDeo:POLarity Sets or returns the polarity of

Description

and hold threshold for the selected digital channel

the channel selected

Returns the delta time, polarity, and both upper and lower threshold limits for the transition time trigger

time used in calculating the transition value

for the A pulse transition trigger

for transition trigger

relationship of delta time to transitioning signal

trigger

Returns the video parameters for the A trigger

trigger format

period

line scan rate of the A video trigger

interval

video signal format on which to trigger

trigger holdoff

line number on which the oscilloscope triggers

the A video trigger

2-56 MSO4000 and DPO4000 Series Programmer Manual

Table 2-31: Trigger Commands (cont.)

Command Groups

Command

TRIGger:A:VIDeo:SOUrce Sets or returns the polarity of

TRIGger:A:VIDeo:STANdard Sets or returns the video

TRIGger:A:VIDeo{:SYNC|:FIELD} Sets or returns the video

TRIGger:B Sets the B trigger level to

TRIGger:B:BY Sets or returns B trigger time

TRIGger:B:EDGE?

TRIGger:B:EDGE:COUPling Sets or returns the type of B

TRIGger:B:EDGE:SLOpe Sets or returns the B edge

TRIGger:B:EDGE:SOUrce Sets or returns the B edge

TRIGger:B:EVENTS?

TRIGger:B:EVENTS:COUNt Sets or returns the number

TRIGger:B:LEVel Sets or returns the level for

TRIGger:B:LEVel:CH<x> Sets or returns the level for

TRIGger:B:LEVel:D<x> Sets or returns the B trigger

TRIGger:B:LOWerthreshold:CH<x> Sets or returns the B trigger

TRIGger:B:LOWerthreshold:D<x> Sets or queries the B trigger

TRIGger:B:STATE Returns the current state of

TRIGger:B:TIMe Sets or returns the B trigger

TRIGger:B:TYPe Sets or returns the type of B

Description

the video trigger

standard

ﬁeld trigger

50% or returns the B trigger parameters

or event qualiﬁers

Returns B trigger edge type parameters

trigger coupling

trigger slope

trigger source

Returns the current B trigger events parameter

of events that must occur before the B trigger occurs

the B trigger

the B trigger for a speciﬁc channel

level for digital channel <x>

lower threshold for the channel selected

lower threshold for the digital channel selected

the B trigger

delay time

trigger

MSO4000 and DPO4000 Series Programmer Manual 2-57

Command Groups

Table 2-31: Trigger Commands (cont.)

Command

TRIGger:B:UPPerthreshold:CH<x> Sets or returns the B trigger

TRIGger:EXTernal?

TRIGger:EXTernal:PRObe Sets or returns the

TRIGger:EXTernal:YUNIts?

TRIGger:FREQuency? Returns the trigger frequency

TRIGger:STATE? Returns the current state of

Vertical Command Group

Use the commands in the Vertical Command Group to control the vertical setup of all live (channel) waveforms for acquisition and display of channel, reference, and math waveforms.

Description

upper threshold for the channel selected

Returns external trigger parameters

attenuation factor value of the external probe connector

Returns the external trigger vertical (Y) units value

in hertz, if available

the triggering system

Table 2-32: Vertical Commands

Command Description

AUXin?

AUXin:PRObe Returns all information concerning the probe

AUXin:PRObe:AUTOZero Sets the TekVPI probe attached to the

AUXin:PRObe:COMMAND Sets the state of the speciﬁed probe control

AUXin:PRObe:DEGAUss Starts a degauss/autozero cycle on a TekVPI

AUXin:PRObe:DEGAUss:STATE? Returns the degauss state of the TekVPI

AUXin:PRObe:FORCEDRange Sets or returns the range of the TekVPI probe

AUXin:PRObe:GAIN Sets or returns the gain factor of the probe

AUXin:PRObe:ID:SERnumber? Returns the serial number of the probe that

AUXin:PRObe:ID:TYPE? Returns the type of probe that is attached to

Returns auxiliary input parameters

attached to auxilary input

auxiliary input to autozero

current probe attached to the auxiliary input

attached to the auxiliary input

that is attached to the auxiliary input

is attached to the auxiliary input

the auxiliary input

2-58 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Table 2-32: Vertical Commands (cont.)

Command Description

AUXin:PRObe:RESistance? Returns the resistance of the probe that is

attached to the Auxiliary input

AUXin:PRObe:SIGnal Sets or returns the input bypass setting on

VPI probes that support input bypass

AUXin:PRObe:UNIts? Returns the units of measure of the probe

that is attached to the auxiliary input

CH<x>? Returns vertical parameters for the s peciﬁed

channel

CH<x>:AMPSVIAVOLTs:ENAble Sets or returns the state of the amps via volts

feature for the speciﬁed channel

CH<x>:AMPSVIAVOLTs:FACtor Sets or returns the amps via volts factor for

the speciﬁed channel

CH<x>:BANdwidth Sets or returns the bandwidth of the speciﬁed

channel

CH<x>:COUPling Sets or returns the coupling setting for the

speciﬁed channel

CH<x>:DESKew Sets or returns the deskew time for the

speciﬁed channel

CH<x>:INVert Sets or returns the invert function for the

speciﬁed channel

CH<x>:LABel Sets or r eturns the waveform label for

channel <x>

CH<x>:OFFSet Sets or returns the channel offset

CH<x>:POSition Sets or returns the channel vertical position

CH<x>:PRObe?

CH<x>:PRObe:AUTOZero Sets the TekVPI probe attached to the

CH<x>:PRObe:COMMAND Sets the state of the speciﬁed probe control

CH<x>:PRObe:DEGAUss Starts a degauss/autozero cycle on a TekV PI

CH<x>:PRObe:DEGAUss:STATE? Returns the state of the probe degauss

CH<x>:PRObe:FORCEDRange Sets or returns the range on a TekVPI probe

CH<x>:PRObe:GAIN Sets or returns the gain factor of the probe

CH<x>:PRObe:ID? Returns the type and serial number of

Returns the gain, resistance, units, and ID of the probe that is attached to the speciﬁed channel

speciﬁed channel input to autozero

current probe attached to the speciﬁed channel input

attached to the speciﬁed channel

that is attached to the speciﬁed channel

the probe that is attached to the speciﬁed channel

MSO4000 and DPO4000 Series Programmer Manual 2-59

Command Groups

Table 2-32: Vertical Commands (cont.)

Command Description

CH<x>:PRObe:ID:SERnumber? Returns the serial number of the probe that

is attached to the speciﬁed channel

CH<x>:PRObe:ID:TYPE? Returns the type of probe that is attached to

the speciﬁed channel

CH<x>:PRObe:MODel Sets or returns the probe model for the

speciﬁed channel

CH<x>:PRObe:PROPDELay Sets or returns the propagation delay for the

probe connected to the speciﬁed channel

CH<x>:PRObe:RECDESkew? Returns the recommended deskew for the

probe connected to the speciﬁed channel

CH<x>:PRObe:RESistance? Returns the resistance of the probe that is

attached to the speciﬁed channel

CH<x>:PRObe:SIGnal Sets or returns the input bypass setting of

channel <x>TekVPI probe

CH<x>:PRObe:UNIts? Returns the units of measure of the probe

that is attached to the speciﬁed channel

CH<x>:SCAle Sets or returns the vertical scale of the

speciﬁed channel

CH<x>:TERmination Sets or returns channel input termination

CH<x>:YUNits Sets or returns the units for the speciﬁed

channel

D<x>

D<x>:LABel

D<x>:THREshold

D<x>:POSition Sets or returns the vertical position for digital

DESkew Causes the deskew values for all channels

DESkew:DISPlay Sets or returns the state of the deskew table

REF<x>? Returns reference waveform data for channel

REF<x>:DATE? Returns the date that a reference waveform

REF<x>:HORizontal:DELay:TIMe Sets or returns the horizontal position of the

REF<x>:HORizontal:SCAle Sets or returns the horizontal scale for a

Returns parameters for digital channel <x>

Sets or returns the waveform label for digital channel<x>

Sets or returns the logical threshold for digital channel <x>

channel <x>

to be set to the recommended values

display

<x>

was stored

speciﬁed reference waveform in percent of the waveform that is displayed to the right of the center vertical graticule

reference waveform

2-60 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Table 2-32: Vertical Commands (cont.)

Command Description

REF<x>:LABel

REF<x>:TIMe? Returns the time that a reference waveform

REF<x>:VERTical:POSition Sets or returns the vertical position of the

REF<x>:VERTical:SCAle Sets or returns the reference waveform

SELect Returns information on which w aveforms are

SELect:BUS<x> Turnsonoroffthespeciﬁed bus waveform

SELect:CH<x> Turns on or off the speciﬁed waveform or

SELect:CONTROl Sets or returns the waveform that is selected

SELect:D<x> Turns on the display of digital channel <x>

SELect:MATH[1] Turns on or off the math waveform or returns

SELect:REF<x> Turns on or off the speciﬁed reference

Sets or returns the speciﬁed reference waveform label

Sets or returns the vertical position for reference channel <x>

was stored

speciﬁed reference waveform

vertical scale in vertical units/div

on or off and which waveform is selected.

or returns whether the speciﬁ ed bus channel is on or off

returns whether the speciﬁed channel is on or off

as the implied recipient of channel-related commands

and resets the acquisition

whether the math waveform is on or off

waveform or returns whether the speciﬁed reference waveform is on or off

Waveform Transfer Command Group

Use the commands i n the Waveform Transfer Command Group to transfer waveform data points to and from the oscilloscope. Waveform data points are a collection of values that deﬁne a waveform. One data value usually represents one data point in the waveform record. When working with envelope waveforms, each data value is either the minimum or maximum of a min/max pair.

Before you transfer waveform data, you must specify the data format, record length, and waveform source or destination.

MSO4000 and DPO4000 Series Programmer Manual 2-61

Command Groups

Data Formats

All data points

for DPO and MSO models are signed integer format only. Valid data widths for CH1-CH4, MATH, REF1-REF4 and D0-D15 are 1 and 2-byte widths. The valid data widths for the digital collection is either 4 or 8-byte widths.

The oscilloscope can transfer waveform data in either ASCII or binary format. You specify the format with the DATa:ENCdg command.

ASCII Data. ASCII data is represented by signed integer values. The range of the values depends on the byte width speciﬁed. One byte wide data ranges from -128 to 127. Two byte wide data ranges from -32768 to 32767.

Each data value requires two to seven characters. This includes one to ﬁve characters to represent the value, another character, if the value is negative, to represent a minus sign, and a comma to separate the data points.

An example ASCII waveform data string may look like this:

CURVE<space>-110,-109,-110,-110,-109,-107,-109,-107,-106,

-105,-103,-100,-97,-90,-84,-80

NOTE. You can use ASCII to obtain a readable and easier to format output than

binary. However, the oscilloscope may require bytes to send the same values with ASCII than with binary, reducing transmission speed.

The use of ASCII for waveform data transfer is inefﬁcient. ASCII-formatted Waveform (WAVFRM?) and Curve (CURVE?) queries, exceeding 1 M points, are not supported.

Binary Data. Binary data is represented by signed integer or positive integer values. The range of the values depends on the byte width speciﬁed. When the byte width is one, signed integer data ranges from -128 to 127, and positive integer values range from 0 to 255. When the byte width is two, the values range from -32768 to 32767. and positive integer values range from 0 to 65,535.

Table 2-33: Binary data ranges

Byte width Signed integer range Positive integer range

1 -128 to 127 0 to 255

2 32,768 to 32,767 0 to 65,535

The deﬁned binary formats also specify the order in which the bytes are transferred. The four binary formats are RIBinary, RPBinary, SRIbinary, and SRPbinary.

RIBinary is signed integer where the most signiﬁcant byte is transferred ﬁrst, and RPBinary is positive integer where the most signiﬁcant byte is transferred ﬁrst. SRIbinary and SRPbinary correspond to RIBinary and RPBinary respectively but

2-62 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Waveform Data and Record

Lengths

Waveform Data Locations

and Memory Allocation

use a swapped by byte order is ignored when DATa:WIDth is set to 1.

You can transfer multiple points for each waveform record. You can transfer a portion of th DATa:STARt and DATa:STOP c ommands to specify the ﬁrst and last data points of the waveform record.

When transferring data into the oscilloscope, you must ﬁrst specify the record length of the destination waveform record. You do this with the WFMInpre:NR_Pt command. Next, specify the ﬁrst data point within the waveform record. For example, when you set DATa:STARt to 1, data points will be stored starting with the ﬁrst point in the record. The oscilloscope will ignore the value set by DATa:ST to read or when it has reached the speciﬁed record length.

When tra data points in the waveform record. Setting D ATa:STARt to 1 and DATa:STOP to the record length will always return the entire waveform.

The DA waveform from the oscilloscope . You can only transfer one waveform at a time. Waveforms sent to the oscilloscope are always stored in one of the reference memory locations. Use the DATa:DESTination command to specify a reference memory location.

OP when reading in data. It will stop reading data when there is no data

nsferring data from the oscilloscope, you must specify the ﬁrst and last

Ta:SOUrce command speciﬁes the waveform source when transferring a

te order where the least signiﬁcant byte is transferred ﬁrst. The

e waveform or you can transfer the e ntire record. You can use the

Waveform Preamble

caling Waveform Data

Each waveform you transfer has an associated waveform preamble, which contains information such as horizontal scale, vertical scale, and the other settings in effect when the waveform was created. Refer to the individual WFMInpre and WFMOutpre commands for information.

Once you transfer the waveform data to the controller, you can convert the data points into voltage values for analysis using information from the waveform preamble.

MSO4000 and DPO4000 Series Programmer Manual 2-63

Command Groups

Transferring Waveform

Data from the Oscilloscope

Transferring Waveform

Data to the Oscilloscope

You can transfe

r waveforms from the oscilloscope to an external controller using the following sequence:

1. Select the waveform source(s) using DATa:SOUrce.

2. Specify the waveform data format using DATa:ENCdg.

3. Specify the number of bytes per data point using WFMOutpre:BYT_Nr.

4. Specify the portion of the waveform that you want to transfer using

DATa:STARt and DATa:STOP.

5. Transfer waveform preamble information using the WFMOutpre? query.

6. Transfer waveform data from the oscilloscope using the CURVe? query.

You can transfer waveforms to the oscilloscope

from an external controller using

the following sequence:

1. Specify the reference waveform using DATa:DESTination.

2. Specify the record length of the reference waveform using WFMPre:NR_Pt.

3. Specify the waveform data format using WFMInpre:ENCdg.

4. Specify the number of bytes per data point using WFMInpre:BYT_Nr.

5. Specify ﬁrst data point in the waveform record using DATa:STARt.

6. Transfer waveform preamble information using WFMInpre.

7. Transfer waveform data to t

he oscilloscope using CURVe.

Table 2-34: Waveform Transfer Commands

Command

CURVe The command format transfers waveform

DATa

DATa:DESTination Sets or returns the reference waveform

DATa:ENCdg Sets or returns the format of outgoing

Description

data to the oscilloscope (reference waveform speciﬁed by DATa:DESTination)

The query format transfers waveform data from oscilloscope speciﬁed by the DATa:SOUrce command

Sets the format and location of the waveform data that is transferred with the CURVe Command

Or returns the format and location of the waveform data that is transferred with the CURVe? command

for storing wa veform data sent to the oscilloscope

waveform data

2-64 MSO4000 and DPO4000 Series Programmer Manual

Table 2-34: Waveform Transfer Commands (cont.)

Command Groups

Command

DATa:SOUrce Sets or returns the location of waveform data

DATa:STARt Sets or returns the starting point in waveform

DATa:STOP Sets or returns the ending data point in

WAVFrm? Returns a branch query containing waveform

WFMInpre? Returns the waveform formatting

WFMInpre:BIT_Nr

WFMInpre:BN_Fmt

WFMInpre:BYT_Nr

WFMInpre:BYT_Or Sets or returns the byte order of waveform

WFMInpre:ENCdg Sets or returns the type of encoding for

WFMInpre:NR_Pt

WFMInpre:PT_Fmt

WFMInpre:PT_Off

WFMInpre:XINcr

WFMInpre:XUNit

WFMInpre:XZEro

WFMInpre:YMUlt

WFMInpre:YOFf Sets or returns the vertical position of the

WFMInpre:YUNit

Description

transferred from the oscilloscope

transfer

waveform transfer

data in either binary or ASCII format, waveform formatting data, and the location of the waveform data source

speciﬁcation to be applied to the next incoming CURVE command data

Sets or returns the number of bits per binary waveform point for the incoming waveform

Sets or returns the format of binary data for the incoming waveform

Sets or returns the data width for the incoming waveform

points for the incoming waveform

incoming waveform data

Sets or returns the number of points in the incoming waveform record

Sets or returns the point format of incoming waveform data

This query always returns a 0

Sets or returns the horizontal sampling interval between incoming waveform points

Sets or returns the horizontal units of the incoming waveform

Sets or returns the time of the ﬁrst point in the incoming waveform

Sets or returns the vertical scale factor, per digitizing level, of the incoming waveform points

incoming waveform in digitizing levels

Sets or returns the vertical units of the incoming waveform

MSO4000 and DPO4000 Series Programmer Manual 2-65

Command Groups

Table 2-34: Waveform Transfer Commands (cont.)

Command

WFMInpre:YZEro

WFMOutpre? Returns the waveform formatting data for the

WFMOutpre:BIT_Nr Sets or returns the number of bits per

WFMOutpre:BN_Fmt Sets or returns the format of binary data for

WFMOutpre:BYT_Nr Sets or returns the data width for the

WFMOutpre:BYT_Or Sets or returns the byte order of waveform

WFMOutpre:ENCdg Sets or returns the type of encoding for

WFMOutpre:FRACTional? This query always returns a 0 if the waveform

WFMOutpre:NR_Pt? Returns the number of points for the

WFMOutpre:PT_Fmt? Returns the point format for the outgoing

WFMOutpre:PT_Off? This query always returns a 0 if the waveform

WFMOutpre:PT_ORder?

WFMOutpre:WFId?

WFMOutpre:XINcr? Returns the horizontal sampling interval for

WFMOutpre:XUNit? Returns the horizontal units for the outgoing

WFMOutpre:XZEro? Returns the time of the ﬁrst point in the

WFMOutpre:YMUlt? Returns the vertical scale factor per digitizing

WFMOutpre:YOFf?

WFMOutpre:YUNit? Returns the vertical units for the outgoing

WFMOutpre:YZEro? Returns the vertical offset for the outgoing

Description

Sets or returns the vertical offset of the incoming waveform

waveform speciﬁed by the DATA:SOURCE command

waveform point that outgoing waveforms contain

the outgoing waveform

outgoing waveform

points for the outgoing waveform

outgoing waveforms

speciﬁed by DATA:SOUrce i s on or displayed

waveform transmitted in response to a CURVe? query

waveform

speciﬁed by DATA:SOUrce i s on or displayed

This query always returns LINEAR

Returns a string describing the acquisition parameters for the outgoing waveform

the outgoing waveform

waveform

outgoing waveform

level for the outgoing waveform

Returns the vertical position in digitizing levels for the outgoing waveform

waveform

2-66 MSO4000 and DPO4000 Series Programmer Manual

Command Groups

Zoom Command G

roup

Use the commands in the Zoom Command Group to expand and position the waveform display horizontally, without changing the time base settings.

Table 2-35:

Command

ZOOm?

ZOOm:MODe Sets or returns the zoom mode

ZOOm:ZOOM<x>?

ZOOm:ZOOM<x>:FACtor? Returns the zoom factor of the zoom window.

ZOOm:ZOOM<x>:POSition Sets or returns the horizontal position of the

ZOOm:ZOOM<x>:SCAle Sets or returns the horizontal zoom scale of

ZOOm:ZOOM<x>:STATE Speciﬁes or returns a trace as zoomed, on or

Zoom Commands

Descriptio

Returns the scaling of the zoom display

Returns t and scaling of the zoom display

<x> can only be 1

zoom win overview window. < x> can only be 1

the zoom window. <x> can only be 1

off. <

horizontal positioning and

he current horizontal positioning

dow in terms of 0 to 100% of the

x> can only be 1

MSO4000 and DPO4000 Series Programmer Manual 2-67

Command Groups

2-68 MSO4000 and DPO4000 Series Programmer Manual

Commands Listed in Alphabetical Order

ACQuire? (Query Only)

Group

Syntax

Related Commands

ACQuire:MAGnivu

Returns the f

Stop after

Acquisition state

Mode

Number of averages

Sampling mode

Acquisition

ACQuire?

ACQuire:MODe, ACQuire:NUMACq?, ACQuire:NUMAVg, ACQuire:STOPAfter

ollowing current acquisition parameters:

Group

Syntax

Arguments

Sets or returns the MagniVu feature, which provides up to 32 times signal detail for fast viewing of short events. This feature is not recommended for slow data formats such as RS-232.

NOTE. MagniVu channel sampling is available on MSO oscilloscopes only.

Acquisition

ACQuire:MAGnivu {<NR1>|OFF|ON} ACQuire:MAGnivu?

<NR1> = 0 disables the MagniVu feature; any other value turns this feature on.

ON enables the MagniVu feature.

OFF disables the MagniVu feature.

MSO4000 and DPO4000 Series Programmer Manual 2-69

Commands Listed in Alphabetical Order

ACQuire:MAXS

Examples

ACQuire:MODe

amplerate? (Query Only)

Returns the maximum real-time sample rate, which varies from model to model.

Group

Syntax

Acquisition

ACQuire:MAXSamplerate?

ACQUIRE:MAXSAMPLERATE? might return 2.5000E+9 in a DPO4034 indicating

the maximum real-time sample rate is 2.5GS/s.

Sets or returns the acquisition mode of the oscilloscope for all live waveforms.

Waveforms are the displayed data point values taken from acquisition intervals. Each acquisition interval represents a time duration set by the horizontal scale (time per division). The oscilloscope sampling system always samples at the maximum rate, so the acquisition interval may include than one sample.

The acquisition mode (which you set using this ACQuire:MODe command) determines how the ﬁnal value of the acquisition interval is generated from the many data samples.

Group

Syntax

Related Commands

Arguments

Acquisition

ACQuire:MODe {SAMple|PEAKdetect|HIRes|AVErage|ENVelope} ACQuire:MODe?

ACQuire:NUMAVg, CURVe

SAMple speciﬁes that the displayed data point value is the ﬁ rst sampled value

that is taken during the acquisition interval. In sample mode, all waveform data has 8 bits of precision. You can request 16 b it data with a CURVe query but the lower-order 8 bits of data will be zero. SAMple is the default mode.

PEAKdetect speciﬁes the display of high-low range of the samples taken from a

single waveform acquisition. The high-low range is displayed as a vertical column that extends from the highest to the lowest value sampled during the acquisition interval. PEAKdetect mode can reveal the presence of aliasing or narrow spikes.

HIRes speciﬁes Hi Res mode where the displayed data point value is the

average of all the samples taken during the acquisition interval. This is a form

2-70 MSO4000 and DPO4000 Series Programmer Manual

Commands Listed in Alphabetical Order

of averaging, w number of samples taken during the acquisition interval determines the number of data values that compose the average.

AVErage speciﬁes averaging mode, in which the resulting waveform shows an

average of SAMple data points from several separate waveform acquisitions. The oscilloscope processes the number of waveforms you specify into the acquired waveform, creating a running 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.

ENVelope speciﬁes envelope mode, w here the resulting waveform shows the

PEAKdetect range of data points from every waveform acquisition.

Examples

ACQUIRE:MODE ENVELOPE sets the acquisition mode to display a waveform that

is an envelope of many individual waveform acquisitions.

ACQUIRE:MODE? might return:ACQuire:MODe AVERAGE indicating that

the displayed waveform is the average of the speciﬁed number of waveform acquisitions.

ACQuire:NUMACq? (Query Only)

here the average comes from a single waveform acquisition. The

Group

Syntax

Related Commands

Returns

ACQuire:NUMAVg

Returns the number of waveform acquisitions that have occurred since starting acquisition with the ACQuire:STATE:RUN command. This value is reset to zero when any acquisition, horizontal, or vertical arguments that affect the waveform are changed. The maximum number of acquisitions that can be counted is 2

Acquisition

ACQuire:NUMACq?

ACQuire:STATE

ACQuire:NUMACq? might return :ACQUIRE:NUMACQ 350 indicat

acquisitions have occurred since executing an ACQuire:STATE RUN command.

Sets or returns the number of waveform acquisitions that make up an averaged waveform. Use the ACQuire:MODe command to enable the Average mode. Sending this command is equivalent to turning a multipurpose knob to enter the number of waveform acquisitions to average.

ing that 350

MSO4000 and DPO4000 Series Programmer Manual 2-71

Commands Listed in Alphabetical Order

Related Commands

Arguments

Examples

ACQuire:STATE

Group

Syntax

Acquisition

ACQuire:NUMAVg <NR1> ACQuire:NUMAVg?

ACQuire:MODe

<NR1> is the number of waveform acquisitions to average. The range of values is

from 2 to 512 in powers of two.

ACQUIRE:NUMAVG 16 speciﬁes that 16 waveform averages will be performed

before exponential averaging starts.

ACQUIRE:NUMAVG? might return :ACQUIRE :NUMAVG 64 indicating that there

are 64 acquisitions speciﬁed for averaging.

Starts or stops acquisitions. When state is set to ON or RUN, a new acquisition will be started. If the last acquisition was a single acquisition sequence, a new single sequence acquisition will be started. If the last acquisition was continuous, a new continuous acquisition will be started.

Group

Syntax

Related Commands

Arguments

If RUN is issued in the middle of completing a single sequence acquisition (for example, averaging or enveloping), the acquisition sequence is restarted, and any accumulated data is discarded. Also, the oscilloscope resets the number of acquisitions. If the RUN argument is issued while in continuous mode, acquisition continues.

Acquisition

ACQuire:STATE {OFF|ON|RUN|STOP|<NR1>} ACQuire:STATE?

ACQuire:STOPAfter

OFF stops acquisitions.

STOP stops acquisitions.

ON starts acquisitions.

RUN starts acquisitions.

2-72 MSO4000 and DPO4000 Series Programmer Manual

Commands Listed in Alphabetical Order

Examples

ACQuire:STOPAfter

Group

Syntax

Related Commands

<NR1> =0stopsa

ACQUIRE:STATE RUN starts the acquisition of waveform data and resets the count

of the number

ACQUIRE:STATE? might return:ACQUIRE:STATE 0 indicating that the

acquisition is stopped.

Sets or returns whether the oscilloscope continually acquires acquisitions or acquires a single sequence.

Acquisition

ACQuire:STOPAfter {RUNSTop|SEQuence} ACQuire:STOPAfter?

ACQuire:STATE

cquisitions; any other value starts acquisitions.

of acquisitions.

ALIas

Arguments

Examples

Group

RUNSTop speciﬁes that the oscilloscope will continually acquire data, if

ACQuire:STATE is turned on.

SEQuence speciﬁes that the next acquisition will be a single-sequence acquisition.

ACQUIRE:STOPAFTER RUnsTOP sets the oscilloscope to continually acquire data.

ACQUIRE:STOPAFTER? might return:ACQUIRE:ST OPAFTER SEQUENCE

indicating that the next acquisition the oscilloscope makes will be of the single-sequence type.

Sets or returns the state of alias functionality. Use Alias commands to deﬁne new commands as a sequence of standard commands. You may ﬁnd this useful when repeatedly using the same commands to perform certain tasks like setting up measurements. Aliases are similar to m acros but do not include the c apability to substitute parameters into alias bodies.

To use Alias commands, ﬁrst deﬁne the alias, then turn on the alias state.

Alias

MSO4000 and DPO4000 Series Programmer Manual 2-73

Commands Listed in Alphabetical Order

Syntax

Related Commands

Arguments

Examples

ALIas {OFF|ON| ALIas?

ALIas:DEFine

ALIas[:STATE]

OFF turns alias expansion off. If a deﬁned alias is sent when ALIas is off, a

command error (110) will be generated.

ON turns alias expansion on. When a deﬁnedaliasisreceived,thespeciﬁed

command sequence is s ubstituted for the alias and executed.

<NR1> = 0 disables alias mode; any other value enables alias mode.

ALIAS ON turns the alias feature on. When a deﬁned alias is received, the speciﬁed

command sequence is s ubstituted for the alias and executed.

ALIAS? might return :A LIAS 1 indicating that the alias feature is on.

ALIas:CATalog? (Query Only)

<NR1>}

ALIas:DEFine

Group

Syntax

Examples

Returns a list of the currently deﬁnedaliaslabels,separatedbycommas. Ifno aliases are deﬁned, the query returns the string "".

Alias

ALIas:CATalog?

ALIAS:CATALOG? might return the string :ALIAS:CATALOG "SETUP1","TESTMENU1","DEFAULT"

named SETUP1, TESTMENU1, and DEFAULT.

Assigns a sequence of program messages to an alia s label. These messages are then substituted for the alias whenever it is received as a command or query, provided that ALIas:STATE has been turned on. The query form of this command returns the de ﬁnitions of a selected alias.

NOTE. Attempting to give two aliases the same name causes an error. To give a

new alias the name of an existing alias, the existing alias must ﬁrst be deleted.

showing that there are three aliases

2-74 MSO4000 and DPO4000 Series Programmer Manual

Commands Listed in Alphabetical Order

Group

Syntax

Related Commands

Arguments

Examples

Alias

ALIas:DEFine <QString><,>{<QString>|<Block>} ALIas:DEFine? <QString>

ALIas[:STATE]

The ﬁrst <QString> is the alias label.

This label cannot be a command name. Labels must start with a letter and can contain only letters, numbers, and underscores; other characters are not allowed. The label must be less than or equal to 12 characters.

The second

The messages can contain only valid commands that must be separated by semicolons and must follow all rules for concatenating c ommands. The sequence must be less than or equal to 256 characters.

ALIAS:DEFINE "ST1",":RECALL:SETUP 5;:AUTOSET EXECUTE;:SELECT:CH1 ON"

up the oscilloscope.

<QString> or <Block> is a complete sequence of program messages.

deﬁnes an alias named "ST1" that sets

ALIAS:DEFINE? "ST1" returns :ALIAS:DEFINE "ST1",#246 :RECALL:SETUP 5;:AUTOSET EXECUTE ;:SELECT:CH1 ON

ALIas:DELEte (No Query Form)

Removesaspeciﬁed alias and is identical to ALIas:DELEte:NAMe. An error message is generated if the named alias does not exist.

Group

Syntax

Related Commands

Arguments

Alias

ALIas:DELEte <QString>

*ESR?, ALIas:DELEte:ALL

<QString> is the name of the alias to be removed. Using ALIas:DELEte

without specifying an alias causes an execution error. <QString> must be a previously deﬁned value.

MSO4000 and DPO4000 Series Programmer Manual 2-75

Commands Listed in Alphabetical Order

Examples

ALIAS:DELETE "

SETUP1"

ALIas:DELEte:ALL (No Query Form)

Deletes all existing aliases.

Group

Syntax

Related Commands

Examples

Alias

ALIas:DELEte:ALL

ALIas:DELEte, ALIas:DELEte[:NAMe]

ALIAS:DELETE:ALL deletes all existing aliases.

ALIas:DELEte[:NAMe] (No Query Form)

Removesaspeciﬁed alias. This command is identical to ALIas:DELEte

deletes the alias named SETUP1.

Arguments

Examples

ALIas[:STATE]

Group

Syntax

Group

Syntax

Alias

ALIas:DELEte[:NAMe] <QString>

<QString> is the name of the alias to remove. Using ALIas:DELEte[:NAMe]

without specifying an alias causes an execution error. <QString> must be an existing alias.

ALIAS:DELETE[:NAME] “STARTUP” deletes the alias named STARTUP.

Turns aliases on or off. This command is identical to the ALIas command.

Alias

ALIas[:STATE] {<NR1>|OFF|ON} ALIas[:STATE]?

2-76 MSO4000 and DPO4000 Series Programmer Manual

Commands Listed in Alphabetical Order

Arguments

Examples

ALLEv? (Query Only)

Group

Syntax

OFF or <NR1> =0t

ALIas:STATE is OFF, a command error (102) is generated.

ON or <NR1>0tu

speciﬁed command sequence is substituted for the alias and executed.

ALIAS[:STATE] OFF turns the command alias feature off.

ALIAS[:STATE]? returns 0 when the alias feature is off.

Prompts the oscilloscope to return all events and their messages (delimited by commas), and removes the returned events from the Event Queue. Use the *ESR? query to enable the events to be returned. This command is similar to repeatedly sending *EVMsg? queries to the oscilloscope.

Status and Error

ALLEv?

urns alias expansion off. If a deﬁnedaliasissentwhen

rns alias expansion on. When a deﬁned alias is received, the

Related Commands

Examples

*ESR?, EVMsg?

ALLEV? might return :ALLE V 2225,"Measurement error, No waveform to measure; "420,"Query UNTERMINATED;"

AUTOSet (No Query Form)

Sets the vertical, horizontal, and trigger controls of the oscill automatically acquire and display the selected waveform.

Group

Syntax

Arguments

Miscellaneous

AUTOSet {EXECute|UNDo}

EXECute autosets the displayed waveform.

UNDo restores the oscilloscope settings to those p resent prior to the autoset

execution.

oscope to

MSO4000 and DPO4000 Series Programmer Manual 2-77

Commands Listed in Alphabetical Order

Examples

AUTOSET EXECUT

automatically acquire and display the selected waveform.

AUTOSet:ENAble

Enables or disables the autoset feature. This is useful for classroom purposes where the instructor wants the students to achieve the desired instrument settings without the beneﬁt of the autoset feature. This setting is not saved in setup ﬁles or SET? or *LRN? q ueries. The default state is 1 (autoset enabled).

vertical, horizontal, and trigger controls of the oscilloscope to

Group

Syntax

Arguments

Examples

AUXin? (Query Only)

Group

Miscellaneous

AUTOSet:ENAble {OFF|ON|0|1} AUTOSet:ENAble?

OFFor0disables autoset.

ON or 1 enables autoset.

AUTOSET:ENABLE 1 enables the front-panel Autoset button.

AUTOSET:ENABLE? might return AUTOSET:ENABLE 0 indicating that the autoset

feature is disabled.

Returns all auxiliary input parameters.

Vertical

Syntax

AUXin?

AUXin:PRObe

Returns all information concerning the probe attached to auxilary input.

Group

Syntax

2-78 MSO4000 and DPO4000 Series Programmer Manual

Vertical

AUXin:PRObe AUXin:PRObe?

Commands Listed in Alphabetical Order

Examples

AUXIN:PROBE? m Detected";SERNUMBER "";:AUXIN:PROBE:UNITS "";RESISTANCE

1.0000E+6

ight return

giving information about the probe attached to the AUX In input.

AUXin:PRObe:AUTOZero (No Query Form)

Sets the TekVPI probe attached to the Aux In input to autozero. The oscilloscope will ignore this command if the Auxiliary input does not have a TekVPI probe connected to it.

Group

Syntax

Arguments

Examples

Vertical

AUXin:PRObe:AUTOZero {EXECute}

EXECute sets the probe to autozero.

AUXin:PROBE:AUTOZERO EXECUTE

AUXIN:PROBE:ID:TYPE "No Probe

AUXin:PRObe:COMMAND (No Query Form)

Sets the state of the probe control sp speciﬁed with the second argument. The commands and states are unique to the attached probe type. Only certain VPI probes support this command. See the probe documentation for how to set these string arguments.

Group

Syntax

Arguments

Examples

Vertical

AUXin:PRObe:COMMAND <QString>, < QString>

<QString> are quoted strings specifying the probe command and value to set in

the probe attached to the auxiliary input.

AUXIN:PROBE:COMMAND “OUTPUT”, “ ON” turns the output of a Tektronix

VPI-DPG probe on.

AUXIN:PROBE:COMMAND “MODE”, “4–4V1M Hz” sets a Tektronix VPI-DPG

probe to t

AUXIN:PROBE:COMMAND?“MODE” might return AUXIN:PROBE:COMMAND “MODE”,“4-4V1MHZ”

he 4-4V1MHz mode.

eciﬁed with the ﬁrst argument to the state

MSO4000 and DPO4000 Series Programmer Manual 2-79

Commands Listed in Alphabetical Order

AUXin:PRObe:

DEGAUss (No Query Form)

Starts a degauss/autozero cycle on a TekVPI current probe attached to the Aux In input. If you send this command to a probe that does not support this function, it is ignored

Group

Syntax

Arguments

Examples

Vertical

AUXin:PRObe:DEGAUss {EXECute}

EXECute starts a probe degauss cycle.

AUXin:PROBE:DEGAUSS EXECUTE degausses the probe attached to the Aux

In input.

AUXin:PRObe:DEGAUss:STATE? (Query Only)

Returns the state of the probe degauss (NEEDED, RECOMMENDED, PASSED,

FAILED, RUNNING). The command will return PASSED for probes that do not

support degauss operations.

Group

Syntax

Examples

Vertical

AUXin:PRObe:DEGAUss:STATE?

AUXin:PROBE:DEGAUSS:STATE? might return: AUXin:PROBE:DEGAUSS:STATE PASSED indicating that the probe has been

degaussed.

AUXin:PRObe:FORCEDRange

Changes o r returns the range on a TekVPI probe attached to the Aux In input.

Group

Syntax

Vertical

AUXin:PRObe:FORCEDRange <NR3> AUXin:PRObe:FORCEDRange?

2-80 MSO4000 and DPO4000 Series Programmer Manual

Commands Listed in Alphabetical Order

Arguments

AUXin:PRObe:GAIN

Group

Syntax

Arguments

Examples

<NR3> is the pro

Sets or returns the gain factor of a probe that is attached to the Aux In input.

Vertical

AUXin:PRObe:GAIN <NR3> AUXin:PRObe:GAIN?

<NR3> is the probe gain, which is probe dependent.

AUXin:PROBE:GAIN? might return :AUXin:PROBE:GAIN 100.0000E-3

indicating that the attached 10x probe delivers 0.1 V to the Aux In BNC for every

1.0 V applied to the probe input.

be range, which is probe dependent.

AUXin:PRObe:ID:SERnumber? (Query Only)

Returns the serial number of the probe that is attached to the auxiliary input.

Group

Syntax

Vertical

AUXin:PRObe:ID:SERnumber?

AUXin:PRObe:ID:TYPE? (Query Only)

Returns the type of probe that is attached to the auxiliary input.

Group

Syntax

Vertical

AUXin:PRObe:ID:TYPE?

AUXin:PRObe:RESistance? (Query Only)

Returns the resistance of the probe attached to the front panel Aux In connector.

MSO4000 and DPO4000 Series Programmer Manual 2-81

Commands Listed in Alphabetical Order

Group

Syntax

Examples

AUXin:PRObe:SIGnal

Group

Vertical

AUXin:PRObe:RESistance?

AUXin:PRObe:RESistance? might return :AUXin:PROBE:RESISTANCE

1.0000E+6

panel Aux In connector is 1 MΩ.

NOTE. This query will return 0.0 if no probe is attached or the attached probe

does not report the

This command changes the input bypass setting on VPI probes that support input bypass, for example the TCP0001. If sent to a probe that does not support input bypass, it is ignored.

Vertical

indicating that the input resistance of the probe attached to the front

input resistance.

Syntax

Arguments

AUXin:PRObe:SIGnal {BYPass|PASS} AUXin:PRObe:SIGnal?

ByPass sets the probe to Bypass mode.

PASS sets the probe to Pass mode.

AUXin:PRObe:UNIts? (Query Only)

Returns a string describing the units of measure of the probe attached to the Aux In input.

Group

Syntax

Examples

Vertical

AUXin:PRObe:UNIts?

AUXin:PROBE:UNITS? might return: :AUXin:PROBE:UNITS “V” indicating

that the units of measure for the attached probe are volts.

2-82 MSO4000 and DPO4000 Series Programmer Manual

BUS

Commands Listed in Alphabetical Order

Sets or returns the parameters for each bus. These parameters affect either the Serial Trigger Setup or the Bus Display.

Conditions

Group

Syntax

This command requires a DPO4AUTO, DPO4EMBD, or DPO4COMP application module.

Bus

BUS

BUS:B<1-4>:AUDio:BITDelay

Sets or returns the number of delay bits for the AUDIO bus.

NOTE. This command is applicable only for TDM audio bus type

BUS:B<x>AUDio:TYPe TDM

(

Conditions

Group

This command requires DPO4AUDIO application module.

Bus

)

Syntax

Arguments

Examples

BUS:B<1-4>:AUDio:BITDelay <NR1> BUS:B<1-4>:AUDio:BITDelay?

<NR1> speciﬁes the number of delay bits.

BUS:B1:AUDIO:BITDELAY 2 sets the bit delay to 2.

BUS:B1:AUDIO:BITDELAY? might return :BUS:B1:AUDIO:BITDELAY 1

indicating that the number of delay bits is 1.

BUS:B<1-4>:AUDio:BITOrder

Sets or returns the bit order for the AUDIO bus.

Conditions

MSO4000 and DPO4000 Series Programmer Manual 2-83

This command requires DPO4AUDIO application module.

Commands Listed in Alphabetical Order

Group

Syntax

Arguments

Examples

Bus

BUS:B<1-4>:AUDio:BITOrder {MSB|LSB} BUS:B<1-4>:AUDio:BITOrder?

MSB speciﬁes that the most signiﬁcant bit will be expected ﬁrst in the order.

LSB speciﬁes that the least signiﬁcant bit will be expected ﬁrst in the order.

BUS:B1:AUDIO:BITORDER LSB sets the bit order to LSB.

BUS:B1:AUDIO:BITORDER? might return :BUS:B1:AUDIO:BITORDER MSB

indicating that the MSB is ﬁrst in the bit order.

BUS:B<1-4>:AUDio:CHANnel:SIZe

Sets or returns the number of bits per channel for the A UDIO bus.

NOTE. This command is applicable only for TDM audio bus type

BUS:B<x>AUDio:TYPe TDM

(

)

Conditions

Group

Syntax

Arguments

Examples

This command requires DPO4AUDIO application module.

Bus

BUS:B<1-4>:AUDio:CHANnel:SIZe <NR1> BUS:B<1-4>:AUDio:CHANnel:SIZe?

<NR1> speciﬁes the number of bits per channel.

BUS:B1:AUDIO:CHANNEL:SIZE 8 sets the number of bits per channel to 8.

BUS:B1:AUDIO:CHANNEL:SIZE? might return :BUS:B1:AUDIO:CHANNEL:SIZe 24 indicating that the number of bits per

channel is 24.

BUS:B<1-4>:AUDio:CLOCk:POLarity

Sets or returns the clock polarity for the AUDIO bus.

2-84 MSO4000 and DPO4000 Series Programmer Manual

Commands Listed in Alphabetical Order

Conditions

Group

Syntax

Arguments

Examples

This command re

Bus

BUS:B<1-4>:AUDio:CLOCk:POLarity {FALL|RI BUS:B<1-4>:AUDio:CLOCk:POLarity?

FALL sets falling edge as the clock polarity.

RISe sets rising edge as the clock polarity.

BUS:B1:AUDIO:CLOCK:POLARITY Fall sets the clock polarity to Fall.

BUS:B1:AUDIO:CLOCK:POLARITY? might return :BUS:B1:AUDIO:CLOCK:POLARITY RISe indicating that the clock polarity

is set to Rise.

BUS:B<1-4>:AUDio:CLOCk:SOUrce

quires DPO4AUDIO application module.

Se}

Conditions

Group

Syntax

Arguments

Examples

Sets or returns the clock source waveform for the AUDIO bus.

This command requires DPO4AUDIO application module.

Bus

BUS:B<1-4>:AUDio:CLOCk:SOUrce {CH1|CH2|CH3|CH4| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} BUS:B<1-4>:AUDio:CLOCk:SOUr

CH1–Ch4 or D0–D15 speciﬁes the clock source for the audio bus.

BUS:B1:AUDIO:CLOCK:SOURCE D1 sets D1 as the clock source for the audio

ce?

bus.

BUS:B1:AUDIO:CLOCK:SOURCE? might return :BUS:B1:AUDIO:CLOCK:SOURCE CH1 indicating that the clock source is

set to CH1.

MSO4000 and DPO4000 Series Programmer Manual 2-85

Commands Listed in Alphabetical Order

BUS:B<1-4>:A

Conditions

Arguments

Exampl

UDio:DATa:POLarity

Sets or returns the data polarity for the AUDIO bus.

This command requires DPO4AUDIO application module.

Group

Syntax

Bus

BUS:B<1-4>:AUDio:DATa:POLarity {NORMal|INVERTed} BUS:B<1-4>:AUDio:DATa:POLarity?

NORMal speciﬁes positive data polarity for the audio bus.

INVERTed speciﬁes negative data polarity for the audio bus.

BUS:B1:AUDIO:DATA:POLARITY INVERTed sets the data polarity to Inverted.

BUS:B1:AUDIO:DATA:POLARITY? might return :BUS:B1:AUDIO:DATA:POLARITY NORMAL indicating that the data polarity is

set to Normal.

BUS:B<1-4>:AUDio:DATa:SIZe

Sets or returns the number of bits per word for the AUDIO bus.

NOTE. The number of bits speciﬁed for this command must be always less than or

equal to the number of bits per channel (BUS:B<x>:AUDio:CHANnel:SIZe)

Conditions

Group

Syntax

Arguments

This command requires DPO4AUDIO application module.

Bus

BUS:B<1-4>:AUDio:DATa:SIZe <NR1> BUS:B<1-4>:AUDio:DATa:SIZe?

NR1 speciﬁesthenumberofbitsperword.

2-86 MSO4000 and DPO4000 Series Programmer Manual

Commands Listed in Alphabetical Order

Examples

BUS:B1:AUDIO:

BUS:B1:AUDIO:DATA:SIZE? might return :BUS:B1:AUDIO:DATA:SIZE 24

indicating th

at the number of bits per word is set to 24.

BUS:B<1-4>:AUDio:DATa:SOUrce

Sets or returns the data source waveform for the AUDIO bus.

Conditions

oup

Syntax

Arguments

This command requires DPO4AUDIO application module.

BUS:B<1-4>:AUDio:DATa:SOUrce {CH1|CH2|CH3|CH4| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15}

<1-4>:AUDio:DATa:SOUrce?

BUS:B

CH1–Ch4 or D0–D15 speciﬁes the channel to use for data source for the audio

bus.

DATA:SIZE 8

sets the number of bits per word to 8.

Examples

BUS:B1:AUDIO:DATA:SOURCE D1 sets the data source to D1.

BUS:B1:AUDIO:DATA:SOURCE? might return :BUS:B1:AUDIO:DATA:SOURCE

indicating that the data source is set to CH3.

CH3

BUS:B<1-4>:AUDio:DISplay:FORMat

Sets or returns the display format for the A UDIO bus.

Conditions

Group

Syntax

Arguments

This command requires DPO4AUDIO application module.

Bus

BUS:B<1-4>:AUDio:DISplay:FORMat {BINary|HEXadecimal|SIGNEDDECimal} BUS:B<1-4>:AUDio:DISplay:FORMat?

BINary speciﬁes a binary data display.

HEXadecimal speciﬁes a hexadecimal data display.

MSO4000 and DPO4000 Series Programmer Manual 2-87

Commands Listed in Alphabetical Order

SIGNEDDECimal

Examples

BUS:B1:AUDIO:DISPLAY:FORMAT BINARY sets the display format to Binary.

BUS:B1:AUDIO:DISPLAY:FORMAT? might return :BUS:B1:AUDIO:DISPLAY:FORMAT SIGNEDDECIMAL indicating that the

display format is set to signed decimal.

BUS:B<1-4>:AUDio:FRAME:SIZe

Sets or returns the number of channels in each frame for the AUDIO bus.

NOTE. This command is applicable only for TDM audio bus type

(

BUS:B<x>AUDio:TYPe TDM

Conditions

Group

This command requires DPO4AUDIO application module.

Bus

speciﬁes a signed decimal data display.

)

Syntax

Arguments

Examples

BUS:B<1-4>:AUDio:FRAME:SIZe <NR1> BUS:B<1-4>:AUDio:FRAME:SIZe?

<NR1> speciﬁes the number of channels in each frame.

BUS:B1:AUDIO:FRAME:SIZE 2 sets the frame size to 2.

BUS:B1:AUDIO:FRAME:SIZE? might return :BUS:B1:AUDIO:FRAME:SIZE 8

indicating that the number of channels in each frame is set to 8.

BUS:B<1-4>:AUDio:FRAMESync:POLarity

Sets or returns the frame sync polarity for the AUDIO bus.

Conditions

Group

Syntax

This command requires DPO4AUDIO application module.

Bus

BUS:B<1-4>:AUDio:FRAMESync:POLarity {FALL|RISe} BUS:B<1-4>:AUDio:FRAMESync:POLarity?

2-88 MSO4000 and DPO4000 Series Programmer Manual

Commands Listed in Alphabetical Order

Arguments

Examples

FALL speciﬁes t

RISe speciﬁes the rising edge as the frame sync polarity.

BUS:B1:AUDIO:FRAMESYNC:POLARITY FALL sets the falling edge for frame

sync polarity.

BUS:B1:AUDIO:FRAMESYNC:POLARITY? might return :BUS:B1:AUDIO:FRAMESYNC:POLARITY RISe indicating that the

polarity is set to Rise.

he falling edge as the frame sync polarity.

BUS:B<1-4>:AUDio:FRAMESync:SOUrce

Sets or returns the frame sync source waveform for the AUDIO bus.

Conditions

Group

This command requires DPO4AUDIO application module.

Bus

Syntax

Arguments

Examples

BUS:B<1-4>:AUDio:FRAMESync:SOUrce {CH1|CH2|CH3|CH4| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} BUS:B<1-4>:AUDio:FRAMESync:SOUrce?

CH1–CH4 or D0–D15 speciﬁes the channel to use as the frame sync source.

BUS:B1:AUDIO:FRAMESYNC:SOURCE CH1 sets CH1 as the frame sync source.

BUS:B1:AUDIO:FRAMESYNC:SOURCE? might return :BUS:B1:AUDIO:FRAMESYNC:SOURCE Ch2 indicating that the source is set to

Ch2.

BUS:B<1-4>:AUDio:TYPe

Sets or returns the audio format (type) for the AUDIO bus.

Conditions

Group

This command requires DPO4AUDIO application module.

Bus

MSO4000 and DPO4000 Series Programmer Manual 2-89

Commands Listed in Alphabetical Order

Syntax

Arguments

Examples

BUS:B<1-4>:AU BUS:B<1-4>:AUDio:TYPe?

I2S speciﬁes I

LJ speciﬁes left-justiﬁed audio format.

RJ speciﬁes right justiﬁed audio format.

TDM speciﬁes time-division multiplexing audio format.

BUS:B1:AUDIO:TYPE RJ sets right-justiﬁed as the audio format.

BUS:B1:AUDIO:TYPE? might return :BUS:B1:AUDIO:TYPE I2S indicating

Dio:TYPe {I2S|LJ|RJ|TDM}

S audio format.

that the audio format is set to I

BUS:B<1-4>:AUDio:WORDSel:POLarity

Sets or returns the word select polarity for the AUDIO bus.

Conditions

This command requires DPO4AUDIO application module.

Group

Syntax

Arguments

Examples

Bus

BUS:B<1-4>:AUDio:WORDSel:POLarity {NORMal|INVERTed} BUS:B<1-4>:AUDio:WORDSel:POLarity?

NORMal speciﬁes positive WORDSel polarity.

INVERTed speciﬁes negative WORDSel polarity.

BUS:B1:AUDIO:WORDSEL:POLARITY NORMal sets normal as the word select

polarity.

BUS:B1:AUDIO:WORDSEl:POLARITY? might return :BUS:B1:AUDIO:WORDSEL:POLARITY NORMAL indicating that the word select

polarity is set to normal.

S:B<1-4>:AUDio:WORDSel:SOUrce

Sets or returns the word select source waveform for the AUDIO bus.

onditions

This command requires DPO4AUDIO application module.

2-90 MSO4000 and DPO4000 Series Programmer Manual

Tektronix DPO4000, MSO4000 User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual