Tektronix MSO2024, MSO2012B, MSO2022B, MSO2014B, MSO2012 Programmer's Manual

...

MSO2000B, DPO2000B, MSO2000 and DPO2000

ZZZ

Series Oscilloscopes

Programmer Manual

*P077073800*

077-0738-00

MSO2000B, DPO2000B, MSO2000 and DPO2000

ZZZ

Series Oscilloscopes

Programmer Manual

Revision A

www.tektronix.com

077-0738-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. 14150 SW Karl Braun Drive P.O. B o x 5 0 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 Hardware . . .... . ..... . ..... . ... . . ..... . ..... . ... . . . .... . ..... . .... 1-2

Connecting via Ethernet................................................................................ 1-2

Connecting via USB........... ................................ .................................. ....... 1-3

Connecting via GPIB ...................... ................................ ............................. 1-4

Setting Up Remote Communications Software . ..... . ..... . ... . . . .... . ..... . ..... . ..... . ... . . ..... . ..... 1-5

Using TekVISA .......................... ................................ ............................... 1-6

Using Tektronix e*Scope Software .................................................................. 1-7

Documentation ............................................................................................... 1-9

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

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

Clearing the oscilloscope ..... . ... . . . .... . ..... . ..... . ..... . ..... . ..... ..... . ..... . ..... . ..... . ..... . ... . . . . 2-4

Command Entry.............................................................................................. 2-4

Constructed Mnemonics .................................................................................... 2-6

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-16

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

Display Command Group................................................................................. 2-18

Ethernet Command Group................................................................................ 2-19

File System Command Group ................. ................................ ........................... 2-20

FilterVu Command Group ................................................................................ 2-21

Hard Copy Command Group................ ................................ ............................. 2-22

Horizontal Command Group .......................... .................................. ................. 2-23

Mark Command Group..... ................................ .................................. ............. 2-23

Math Command Group................... ................................ ................................. 2-25

Measurement Command Group ................. ................................ ......................... 2-26

Miscellaneous Command Group ......................................................................... 2-29

PictBridge Command Group ............................ ................................ ................. 2-30

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

Search Command Group....... ................................ ................................ ........... 2-33

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

Trigger Command Group .............................. ................................ ................... 2-38

Vertical Command Group.......... ................................ ................................ ....... 2-47

Waveform Transfer Command Group................................................................... 2-50

Zoom Command Group................................................................................... 2-57

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual i

Table of Contents

Commands Liste

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

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

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

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

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

Messages.................................................................................................... 3-

Appendix A: Character Set..................................................................................... A-1

Appendix B: Waveform Data in MSO/DPO2000B and MSO/DPO2000 Series Instruments. .......... B-1

Appendix C: Reserved Words.................................................................................. C-1

Appendix D: Application Module-enabled Commands ..................................................... D-1

Appendix E: Search and Trigger Command Sequence Examples........................ .................. E-1

Example

Example 2: Single Threshold Edge Trigger ............. ................................ ................ E-1

Example 3: Dual Threshold Runt Search ...................... .................................. ........ E-2

Example 4: Single Threshold Logic Search on Three Waveforms.................................... E-2

Index

d in Alphabetical Order .................................................................... 2-59

1: Single Threshold Edge Search .............................................................. E-1

ii MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

Getting Started

Table 1-1:

Model Bandwidth

MSO2024B, MSO2024

MSO2022B

MSO2014B, MSO2014

MSO2012B, MSO2012

MSO2004B

MSO2002B

DPO2024B, DPO2024

DPO2022B

DPO2014B, DPO2014

DPO2012B, DPO2012

DPO2004B

DPO2002B

200 MHz 4

200 MHz 2

100 MHz 4

100 MHz 2

70 MHz 4

70 MHz 2

200 MHz 4

200 MHz 2

100 MHz 4

100 MHz 2

70 MHz 4

70 MHz 2

This manual explains the use of commands for remotely controlling your oscilloscope. With this information, you can write computer programs to perform func

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

performing statistical calculations, and exporting data for use in other programs.

This manual describes commands for the following models:

Number of Analog Channels Sample Rate

1GS/s

Record Length, all ch.

1 M pts. 5,000

Wfm. Capture Rate

New in the Programmer

Manual

Thefollowingmajorchangesweremadetothisversionoftheprogrammer manual (077-0738-00):

Added 6 new oscilloscope models:

MSO2002B – 70 MHz, 2 channel

MSO2004B – 70 MHz, 4 channel

MSO2022B – 200 MHz, 2 channel

DPO2002B – 7 0 MHz, 2 channel

DPO2004B – 7 0 MHz, 4 channel

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 1-1

Getting Started

DPO2022B – 200 M

Hz, 2 channel

Setting Up Remote Communications Hardware

You c a n remo t USB, or GPIB cables.

NOTE. In order to communicate via an Ethernet cable, you need to install an

optional DPO2CONN Connectivity Module into the back of the instrument. This module includes both Ethernet and VGA video monitor ports.

ely communicate between your oscilloscope and PC via Ethernet,

Connecting via Ethernet

1-2 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

If your PC is connected to a local area network, you can use an Ethernet cable to

ect your oscilloscope to the same network, and then use software to remotely

conn control the oscilloscope via the PC. First, you’ll need to acquire an optional DPO2CONN Connectivity Module, which provides Ethernet and video out ports for your oscilloscope (search on www.tektronix.com). Then, simply plug one end of the Ethernet cable into the Ethernet port (RJ-45 connector), and the other end into your network connection.

OTE. You can connect an MSO/DPO2000B oscilloscope only to a 10/100

Base-T local area network.

Getting Started

Connecting via USB

To view or chang

1. On the front panel, push Utility.

2. Push Utility Page.

3. Select I/O with the Multipurpose knob.

4. Push Ethernet Network Settings.

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

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

hard-coded TCPIP address.

You can co cable, and then use software to remotely control the oscilloscope v ia the PC. Simply plug one end of the cable into the USB 2.0 high-speed device port on the rear panel of your oscilloscope, and the other end into a USB port on your computer.

This port requires that the cable connected from the port to the host computer meets the USB 2.0 speciﬁcation for high speed connections. Typically, such cables should be 3 feet or shorter in length, but this is determined by the quality of

able and, with higher quality cables, this length can be extended. (It is also

the c dependent upon the drive capability of the host USB port to which the instrument is connected.) The use of high quality short cables is recommended to avoid USB connection problems.

e the Ethernet settings on your oscilloscope, do the following:

nnect your oscilloscope directly to a PC by using a high-speed USB

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

1. On the front panel, push Utility.

2. Push Utility Page.

elect I/O with the Multipurpose knob.

3.S

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

5. If USB is not enabled, push Enabled on the side menu.

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

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 1-3

Getting Started

Table 1-2: USB D

Parameter Value

Manufacturer

Product ID

Serial number Serial number

Manufacturer description

Interface description “USBTMC-USB488”

evice Parameters

0x0699 (decim

0x399 DPO200

0x39A MSO2002B (decimal 922)

0x39B DPO2004B (decimal 923)

0x39C MSO20

0x39D DPO2012B (decimal 925)

0x39E MSO2012B (decimal 926)

0x39F DPO20

0x3A0 MSO2014B (decimal 928)

0x3A1 DPO2022B (decimal 929)

0x3A2 MSO2

0x3A3 DPO2024B (decimal 931)

0x3A4 MSO2024B (decimal 932)

0x0372 DP

0x0373 DPO2014

0x0374 DPO2024

0x0376 M

0x0377 MSO2014

0x0378 MSO2024

“Tektronix”

al 1689)

2B (decimal 921)

04B (decimal 924)

14B (decimal 927)

022B (decimal 930)

O2012

SO2012

Connecting via GPIB

The oscilloscope has a USB 2.0 high-speed device port to control the oscilloscope through USBTMC or GPIB with a TEK-USB-488 Adapter. The USBTMC

tocol allows USB devices to communicate using IEEE488 style messages.

pro This lets you run your GPIB software applications on USB hardware.

To use GPIB, start by connecting an appropriate USB cable to the USB 2.0

igh-speed device port on the rear panel of your oscilloscope. Connect the other

h 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-4 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

Getting Started

1. Use the optiona on the Adapter.

2. Use an appropr PC and the Device port on the TEK-USB-488 Adapter.

Before sett (physical) GPIB interface, you should familiarize yourself with the following GPIB requirements:

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

ing up the oscilloscope for remote communication using the electronic

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

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

Only one d

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

At least two-thirds of the devices on the network should be powered on while

he network.

using t

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

op or parallel conﬁgurations.

use lo

ult setting for the GPIB conﬁguration is GPIB Address 1.

l5V

iate USB cable connected to a powered USB host port on your

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

power adapter connected to the 5 VDCpower input

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.

nter the GPIB address on the side menu, using the multipurpose knob. This

5.E

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

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

Setting Up Remote Communications Software

Connect your oscilloscope directly to a computer to let the PC analyze your data, collect screen images, or to control the oscilloscope using a program of your own creation. You can connect using TekVISA drivers, or connect directly from any computer’s web browser using Tektronix e*Scope Web-enabled tools.

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 1-5

Getting Started

Using TekVISA

NOTE. The CD tha

efﬁcient connectivity between your oscilloscope and your computer. These include toolbars that speed connectivity with Microsoft Excel and Word.

TekVISA lets you use your MS-Windows computer to acquire data from your oscilloscope for use in an analysis package that runs on your PC, such as Microsoft Excel, National Instruments LabVIEW, Tektronix OpenChoice Desktop software, or your own custom software. You can use a common communications connection, such as USB, Ethernet, or GPIB, to connect the computer to the oscilloscope. The TekVIS Desktop software that came with your instrument’s CD. You can also download the OpenChoice Desktop software from www.tektronix.com\downloads.

NOTE. TekVISA cannot run if any other version of VISA drivers is installed.

To set up communications between your oscilloscope and a computer running TekVISA drivers:

A drivers are automatically installed by installing the OpenChoice

t your oscilloscope shipped with contains additional tools for

1-6 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

Getting Started

1. Install the Tek CD that came with your instrument or from the Tektronix website. This w ill automatically install the TekVISA drivers.

2. Connect the oscilloscope to your computer with the appropriate USB, Ethernet or GPIB cable. Cycle the power on the oscilloscope.

3. Push Utility.

4. Push Utilit

5. Turn multipurpose knob a and select I/O.

tronix OpenChoice Desktop software package, either from the

y Page.

sing Tektronix e*Scope

Software

6. If you are using USB, the system sets itself up automatically for you, if USB is enabled. Check USB on the lower menu to be sure that USB is enabled. If it is not enabled, push USB. Then push Connect to Computer on the side menu.

7. To use Ethernet, push Ethernet Network Settings on the lower menu. Use the s ide menu buttons to adjust your network settings, as needed. For more information, see the e*Scope setup information below.

8. If you are using GPIB, push GPIB. Enter the GPIB address on the side menu, using multipurpose knob a. This will set the GPIB address on an attached

K-USB-488 Adapter.

9. Run the application software on your computer.

Your oscilloscope contains a pre-installed remote control software package by Tektronix called e*Scope. You can use this to “talk” to a networked PC’s web browser so that you can view and control the oscilloscope wherever it is on your network.

First, you’ll need to acquire an optional DPO2CONN Connectivity Module, which provides Ethernet and video out ports for your oscilloscope (search on www.tektronix.com).

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 1-7

Getting Started

To set up e*Scop computer:

1. With the DPO2C cable from the back of the oscilloscope to the same network as your computer.

2. Power u p you

a. Push the Utility button, and then push Utility Page on the bottom menu.

b. Turn multipurpose knob a to select I/O, and then push Ethernet Network

Settings on the bottom menu.

c. Push Test Connection on the side menu. The button should say OK.

e communications between your oscilloscope and a networked

ONN Connectivity Module installed, connect an Ethernet

r oscilloscope and test the network connection:

3. Next, ﬁnd your oscilloscope’s IP address:

a. Push Change Instrument Settings on the side menu to display the

network parameters conﬁgured on your oscilloscope.

b. Note down the Instrument IP address.

1-8 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

Getting Started

Documentation

4. On the menu bar o Instrument IP address and press Enter.

5. You should now s ee the e*Scope screen on your PC and an image of your oscillos oscilloscope from your PC’s browser.

cope’s display. You may use the menu items at the top to control your

f your PC’s web browser, type in the oscilloscope’s

The following documents are available for download on the Manuals Finder Web site at www.tektronix.com:

MSO/DPO2000B Series User Manual. Information about installing and operating the oscilloscope.

MSO/DPO2000B Series Technical Reference. Oscilloscope speciﬁcations and a performance veriﬁcation procedure.

TekVISA Programmer Manual. Description of TekVISA, the Tektronix 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).

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 1-9

Getting Started

1-10 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes 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 mark 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

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 2-1

A command message is a command or query name followed by any information the oscilloscope needs to execute the command or query. Command messages may c ontain ﬁve element type s, 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 (:) characte 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 character is used between a command header and the related argument. Optionally, a white space may consist of multiple 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 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

Command Syntax

Queries

Headers

Queries cause t

he oscilloscope to return status or setting information. Queries

have the structure:

[:]<Header>

[:]<Header>[<Space><Argument> [<Coma><Argument>]...]

You can specify a query command at any level within the command tree unless otherwise noted. These branch queries return information about all the mnemonics below the sp

eciﬁ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?

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

100

:ACQUIRE:NUMAVG 100

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 2-3

Command Syntax

Clearing the o

scilloscope

Command Entry

Abbrev

iating

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.

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 a ny combination of white space characters and line feeds.

You can abbreviate 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

:numa.

or acq

Concatenating

Abbreviation rules may change over time as new oscilloscope models are

oduced. Thus, for the most robust code, use the full spelling.

intr

If you use the HEADer command to have command headers included as part

uery responses, you can further control whether the returned headers are

of q abbreviated or are full-length with the VERBose command.

You can concatenate any combination of set commands and queries using a

micolon (;). The oscilloscope executes concatenated commands in the order

se received.

2-4 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

Command Syntax

When concatena

ting 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 AVErage

and ACQuire:NUMAVg 8 into a single command:

ACQuire:MODe AVErage; NUMAVg 8

The longer version works equally well:

ACQuire:MODe AVErage;: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 ENVelope;*OPC;NUMAVg 8

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

Terminating

4. When you concatenate queries, the responses to all the queries are

concatenated into a single response message.

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 of acquisitions for averaging and the acquisition state. Concatenated comma nds and queries are executed in the order received.

Here are some invalid concatenations:

HORizontal:SCAle 400E-9;ACQuire:NUMAVg 8 (no colon before

ACQuire)

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)

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

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 2-5

Command Syntax

Table 2-4: End o

Symbol Meaning

<EOM>

The end-of-message terminator must be the END message (EOI asserted concurrently with the last data byte). The last data byte may be an ASCII 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 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>.

Cursor Position

Mnemonics

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

f Message Terminator

Message termi

nator

mnemonic can be CH1, CH2, CH3, or CH4. You use these mnemonics

Math Speciﬁer Mnemonics

Table 2-5: Channel Mnemonics

Symbol Meaning

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

Table 2-6: Cursor 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.

2-6 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

Command Syntax

Measurement Speciﬁer

Mnemonics

Channel Mnemonics

Reference Waveform

Mnemonics

Commands can sp

ecify which measurement to set or query as a mnemonic in the

header. Up to four 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 header.

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

Table 2-9: Re f erence Waveform Mnemonics

Symbol Meaning

REF<x>

A reference waveform speciﬁer; <x> 1 or 2. The MSO/DPO2000B and MSO/DPO2000 series provides only two REF waveforms regardless of whether the instrument is a 2 or 4 channel model.

Argument Types

Numeric

Quoted String

ny oscilloscope commands require numeric arguments. The syntax shows

Ma the format that the oscilloscope returns in response to a query. This is also the preferred format when sending the command to the oscilloscope though any of the formats will be accepted. This documentation represents these arguments as described below.

Table 2-10: Numeric Arguments

Symbol Meaning

<NR1>

<NR2> Floating point value without an exponent

<NR3> Floating point value with an exponent

<bin>

Most num

eric arguments will be automatically forced to a valid setting, by either

Signed integer value

Digital data in binary format

rounding or truncating,, when an invalid number is input, unless otherwise noted in the command description.

Some commands accept or return data in the form of a quoted string, which is simply a group of ASCII characters enclosed by a single quote (') or double quote ("). The following is an example of a quoted string:

string"

. This documentation represents these arguments as follows:

"This is a quoted

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 2-7

Command Syntax

Table 2-11: Quo

Symbol Meaning

<QString> Quoted string of AS CII text

ted String Argument

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 type of quote character to open and close the string. For example:

"this is a valid string".

2. You can mix quotation marks within a string as long as you follow the previous rule. For example:

"this is an 'acceptable' string".

3. You can include a quote character within a string by repeating the quote. For example:

"here is a "" mark".

4. Strings can have upper or lower case characters.

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

END message before the closing delimiter.

6. A carriage return or line feed embedded in a quoted string does not terminate the string. The return is treated as another character in the string.

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

Block

Here are some invalid strings:

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

st<EOI>"

"te

(termination character is embedded in the string)

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

able 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 in 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[<DChar>...]<terminator>}

<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 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

Command Syntax

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 2-9

Command Syntax

2-10 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

Command Groups

This manual lists the MSO/DPO2000B and MSO/DPO2000 series IEEE488.2 commands in two ways. First, it presents them by functional groups. Then, it lists them alphabe list provides detail on each command. (See page 2-59, Commands Listed in Alphabetical Order.)

Acquisition Command Group

Use the commands in the Acquisition Command Group to set up the modes 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 over successive acquisitions of that waveform.

Set the controls or conditions that start and stop acquisitions.

Contr

tically. The functional group list starts b elow. The alphabetical

ol acquisition of channel waveforms.

Set acquisition parameters.

e 2-13: Acquisition Commands

Tabl

Command Description

urns acquisition parameters

ACQuire?

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

urns the maximum real-time sample rate

Ret

occurred

an averaged waveform

continuous or single sequence

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes 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 header.

The a lias

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 b eing 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 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

Command Groups

Bus Command Gr

oup

Use the Bus commands when working with serial bus measurements.

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

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

Install the DPO2COMP module when working with RS232 bus signals.

Table2-15: BusCommands

Commands Description

BUS Returns the parameters for each 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 CA N 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>: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

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 <x> source

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

bus <x>

BUS:B<x>:PARallel:CLOCK:ISCLOCKed Sets or returns whether the parallel bus is

clocked

BUS:B<x>:PARallel:CLOCK:SOUrce Sets or returns the parallel bus<x> clock

source

BUS:B<x>:PARallel:WIDth Sets or returns the number of bits used for

the width of the parallel bus <x>

MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual 2-13

Command Groups

Table2-15: BusCommands(cont.)

Commands Description

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

bus waveform

BUS:B<x>:RS232C:BITRate Sets or returns the RS232 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 RS232 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 RS232 data

BUS:B<x>:RS232C:POLarity Sets or returns the RS232C polarity for the

speciﬁed bus

BUS:B<x>:RS232C:RX:SOUrce Sets or returns the RS232 RX source

BUS:B<x>:RS232C:TX:SOUrce Sets or returns the RS232 TX Source

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{: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>:SPI:BITOrder Sets or returns the bit order for the speciﬁed

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

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

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

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

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

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

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

Sets or returns the SPI MOSI polarity

SPI bus

for the speciﬁed SPI bus

seconds for the speciﬁed SPI bus

channel

2-14 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual

+ 411 hidden pages

Tektronix MSO2024, MSO2012B, MSO2022B, MSO2014B, MSO2012 Programmer's Manual

Specifications and Main Features

Frequently Asked Questions

User Manual