Tektronix MSO56, MSO54, MSO58, MSO58LP Programmer's Manual

Download

5SeriesMSO

ZZZ

MSO54, MSO56, MSO58, MSO58LP

Programmer Manual

*P077130502*

077-1305-02

5SeriesMSO

ZZZ

MSO54, MSO56, MSO58, MSO58LP

Programmer Manual

www.tek.com

077-1305-02

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.

FlexChannel, FastFrame, OpenChoice, iView, Pinpoint, RT-Eye, TekVPI, FastAcq, and e*Scope are registered trademarks of Tektronx, Inc.

TekSecure is a trademark of Tektronix, Inc.

5 Series MSO Programmer documentation. 077-1305-02 Released January 16, 2018.

Contacting Tektronix

Tektronix, Inc. 14150 SW Karl Braun Drive P.O. Box 500 Beaverton, OR 97077 USA

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

In North America, call 1-800-833-9200. Worldwide, visit www.tek.com to ﬁnd contacts in your area.

Table of Contents

Preface.............................................................................................................. iii

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

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

Ethernet .................................................................................................. 1-1

USB....................................................................................................... 1-2

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

Using VISA....................................... ................................ ....................... 1-3

Using the LXI Web Page and e*Scope .. ................................ ............................. 1-4

Using a Socket Server .................................................................................. 1-5

Documentation ....... ................................ .................................. ................. 1-7

Dynamic programmatic interface .......................................................................... 1-7

Implicit activation ........................................................................................... 1-7

Creating, deleting, and listing dynamic instances ......................... ............................... 1-8

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

AFG Command Group .................................................................................... 2-12

Alias command group..................................................................................... 2-13

Bus command group............ ................................ ................................ ........... 2-14

Calibration command group ............................. ................................ ................. 2-19

Cursor command group ........ ................................ ................................ ........... 2-20

Digital command group .................................................................................. 2-26

Display control command group......................................................................... 2-28

DVM Command Group............ ................................ .................................. ..... 2-31

Ethernet Command Group................................................................................ 2-31

File system command group.............................................................................. 2-33

Horizontal command group.................................... .................................. ......... 2-35

Math command group .............. ................................ .................................. ..... 2-37

Measurement command group ........................................................................... 2-39

Miscellaneous command group .......................................................................... 2-53

Plot command group ...................................................................................... 2-55

Power command group............................. ................................ ....................... 2-55

Save and Recall command group ........................................................................ 2-62

Save On command Group ................................................................................ 2-63

MSO54, MSO56, MSO58, MSO58LP Programmer i

Table of Contents

Search and Mark

Self Test command group .......................... ................................ ....................... 2-74

Status and Error command group ........................................................................ 2-75

Trigger command group ................... ................................ ............................... 2-76

Vertical command group .................................................................................. 2-85

Waveform Transfer command group .................................................................... 2-88

Zoom comman

Commands listed in alphabetical order.............................. ................................ ......... 2-93

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

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

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

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

Synchro

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

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

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

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

Appendix D: Waveform Transfer (WFMOutpre and CURVe Query) Examples ......................... D-1

Exam

Example 2: Digital Waveform ............................................................................ D-3

Example 3: Digital with 4 Bytes Per Point and Zoom Off............................................. D-5

Example 4: Digital with 8 Bytes Per Point and Zoom Off............................................. D-8

Example 5: Digital with 4 Bytes Per Point and Zoom On ..... .................................. .... D-10

Example 6: Digital with 8 Bytes Per Point and MagniVu On ....................................... D-13

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

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

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

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

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

Glossary

Index

nization Methods .............................. .................................. ................... 3-7

ple 1: Analog Waveform (Channels 1–4) ................... ................................ ...... D-1

ample 7: RF Frequency Domain Waveform.......... .................................. ............ D-15

command group ........ ................................ ............................... 2-64

d group .................................................................................... 2-92

ii MSO54, MSO56, MSO58, MSO58LP Programmer

Preface

This programmer guide provides you with the information required to use Programmable Interface commands to remotely control your instrument.

The programmer manual is divided into the following major topics:

Getting started. This topic introduces you to the programming information and provides basic information about setting up your instrument for remote control.

Command syntax. This topic provides an overview of the command syntax that you use to communicate with the instrument and other general information about com enter commands, constructed mnemonics, and argument types.

mands, such as how commands and queries are constructed, how to

Command

groups. Each group consists of an overview of the commands in that group and a table that lists all the commands and queries for that group. You can click a command in the listing to display a detailed description of the command.

Commands listed in alphabetical o rder. This topic contains all commands listed in alphabetical order. Command details, syntax, and examples are provided.

Status and events. This topic discusses the status and event reporting system for the programming interfaces. This system informs you of certain signiﬁcant events that occur within the instrument. Topics that are discussed include

isters, queues, event handling sequences, synchronization methods, and

reg messages that the instrument might return, including error messages.

pendices. These topics contain miscellaneous information, such as a list

of reserved words, a table of the factory initialization (default) settings, and interface speciﬁcations that can be helpful when using commands to remotely control the instrument.

groups. This topic contains all the commands listed in functional

MSO54, MSO56, MSO58, MSO58LP Programmer iii

Preface

iv MSO54, MSO56, MSO58, MSO58LP Programmer

Getting Started

This manual explains the use of commands to remotely control your oscilloscope. With this information, you can write computer programs to perform functions, such as setti statistical calculations, and exporting d ata for use in other programs.

ng the front-panel controls, taking measurements, performing

Familiarit download the User Manual from the Tektronix website at www.tek.com.

NOTE. Most examples in this document assume that both HEADer and VERBose

are set to ON.

y with the User Manual for your oscilloscope is assumed. You can

SettingUpRemoteCommunicationsHardware

You can remotely control communications between your oscilloscope and a PC via Ethernet or USB cables.

Ethernet

If you are using Ethernet, start by connecting an appropriate Ethernet cable to the Ethernet port (RJ-45 connector) on the rear panel of your oscilloscope. This connects the oscilloscope to a 10BASE-T/100BASE-TX/1000BASE-T local area network.

MSO54, MSO56, MSO58, MSO58LP Programmer 1-1

Getting Started

USB

To change the Et

1. Select the Utility drop-down menu.

2. Select the I/O menu.

3. Select the LAN panel.

4. In the menu, if you are on a DHCP Ethernet network that supplies the IP

address automati

5. In the menu, if you want to supply your own n etwork settings, tap Manual to set a hard coded TCP/IP address.

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

3.0 super-speed (SS) Device port on the rear panel of your oscilloscope. This

port requires that the cable connected from the port to the host computer meets the USB 3.0 speciﬁcation for super speed connections. Typically, such cables should be 3 feet or shorter in length, but this is determined by the quality of the cable and, with higher quality cables, this length can be extended. (It is also 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.

hernet settings on your oscilloscope, do the following:

cally by a DHCP, tap Auto.

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

1. Select the Utility drop-down menu.

2. Select the I/O menu.

3. Touch USB Device Port to open the USB Device Port conﬁguration menu.

4. If USB is disabled, tap USB Device Port to enable the USB Device port.

1-2 MSO54, MSO56, MSO58, MSO58LP Programmer

Getting Started

After connecti

on, 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 0x0522

Serial num

Manufact

Interfac

ber

urer description

e description

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. Three ways to connect your oscilloscope to a computer are through the VISA drivers, the e*Scope Web-enabled tools, or via a socket server.

(You can send the USBTMC:PRODUCTID:HEXadecimal? query to rea

Serial num

“Tektronix”

“USBTMC-

d the value)

ber

USB488”

Using

VISA

VISA 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

tware, or your own custom software. You can use a common communications

sof connection, such as USB or Ethernet, to connect the computer to the oscilloscope.

et up VISA communications between your oscilloscope and a computer:

To s

MSO54, MSO56, MSO58, MSO58LP Programmer 1-3

Getting Started

1. Load the VISA dr as OpenChoice Desktop. You will ﬁnd the drivers and OpenChoice Desktop software on the appropriate CD that comes with your oscilloscope or at the Tektronix software ﬁnder Web page (www.tektronix.com\downloads).

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

3. Select the Utility drop-down menu

4. Select I/O menu.

5. If you are u

USB is enabled. Check USB DEVICE PORT panel to be s ure that USB is enabled. If it is not enabled, toggle the On/Off button to On.

6. To use Ethernet, select the LAN panel. Use the controls to adjust your network settings, as needed. For more information, see the e*Scope setup information below.

7. If you want to change socket server parameters, select the Socket Server panel and enter new values through the resulting panel controls.

8. Run your application software o n your computer.

ivers on your computer. Also, load your application, such

sing USB, the system sets itself up automatically for you, if

Quick Tips

Using the LXI Web Page

and e*Scope

SB 3.0 super-speed (SS) device port is the correct USB port for

The U computer connectivity. Use the rear- and front-panel USB 2.0 or 3.0 host ports to connect your oscilloscope to U SB ﬂash drives, hard drives, keyboards or mice. Use the USB Device port to connect your oscilloscope to a PC.

There are both USB 2.0 and 3.0 host ports on the instrument. The d evice port is USB 3.0. Printers are not supported on host ports. PictBridge printers are not supported on the device port.

With e*Scope, you can access your Internet-connected instrument from a web browser. To set up e*Scope communications between your oscilloscope and a webbrowserrunningonaremotecomputer:

1-4 MSO54, MSO56, MSO58, MSO58LP Programmer

Getting Started

1. Connect the osc Ethernet cable.

2. Select the Uti

3. Select the I/O menu.

4. Select the LAN panel.

5. At the top left of the panel, there is an indicator light which turns red if the

device detects a fault.

6. Read the network parameters conﬁgured on your oscilloscope.

7. Tap LAN Reset to restore the LAN defaults to your oscilloscope.

8. Tap Test Connection to check if your oscilloscope can ﬁnd an attached

network.

9. Double tap Host Name, Domain Name,orService Name to change the name of the oscilloscope, the domain name, or the service name using the pop-up keyboard.

10. Start your browser on your remote computer. In the browser address line, enter the host name, a dot, and the domain name together. Alternatively, just enter the IP address of the instrument. Either way, you should then see the LXI Welcome page on your Web browser on your computer screen.

illoscope to your computer network with an appropriate

lity drop-down menu.

Using a Socket Server

11. Click “Network Conﬁguration” to view and edit the network conﬁguration settings.

12. For e*Scope, click the Instrument Control (e*Scope) link on the left side of the LXI Welcome page. You should then see a new tab (or window) open in

ur browser with e*Scope running.

A socket server provides two-way communication over an Internet Protocol-based computer network. You can use your oscilloscope’s socket server feature to let

our oscilloscope talk to a remote-terminal device or computer.

To set up and use a socket server between your oscilloscope and a remote terminal or computer:

1. Connect the oscilloscope to your computer network with an appropriate Ethernet cable.

2. Select the Utility drop-down menu.

3. Select the I/O menu.

4. Tap Socket Server.

5. On the resulting Socket Server panel, tap the top entry to toggle the Socket

Server On..

MSO54, MSO56, MSO58, MSO58LP Programmer 1-5

Getting Started

6. Choose whether

the protocol should be None or Te r m inal. A communication session run by a human at a keyboard typically uses a terminal protocol. An automated session might handle its own communications without using such a protocol.

7. If required, change the port number by rotating multipurpose knob a.

8. If required, press OK to set the new port number.

9. After setting up the socket server parameters, you can now have the computer

“talk” to the oscilloscope. If you are running an MS Windows PC, you could run its default client with its command-like interface. One way to do this is by typing “

Telnet ” in the Run window. The Telnet window will open on

the PC.

NOTE. On MS Windows 7, you must ﬁrst enable Telnet in order for it to work.

10. Start a terminal session between your computer and your oscilloscope by typing in an open command with the oscilloscope LAN address and port #. You can obtain the LAN address by pushing the LAN panel to view the resulting LAN setting panel. You can obtain the port # by tapping the Socket Server panel and viewing the Port item.

For example, if the oscilloscope IP address was # was the default of

4000, you could open a session by writing into the MS

123.45.67.89 and the port

Windows Telnet screen:

open 123.45.67.89 4000

The oscilloscope will send a help screen to the computer when it is done connecting.

11. You can now type in a standard query, as found in the programmer manual, such as

*idn?

The Telnet session window will respond by displaying a character string describing your instrument. You can type in more queries and view more results on this Telnet session window. You can ﬁnd the syntax for relevant queries and related status codes in other sections of this manual.

NOTE. Do not use the computer’s backspace key during an MS Windows' Telnet

session with the oscilloscope.

Socket Server Terminal Protocol Mode Commands. Following are Tektronix Instrument Control Terminal Session Control commands:

!t <timeout> : set the response timeout in milliseconds.

!d : send device clear to the instrument.

1-6 MSO54, MSO56, MSO58, MSO58LP Programmer

Getting Started

!r : read respon

!h : print this usage info.

NOTE. Comman

read automatically.

Documentation

Documenta

tion for your instrument is available for download at www.tek.com.

Dynamic programmatic interface

This prog recognize certain commands until the objects referenced by those commands actually exist. For example, commands related to measurements are not recognized until measurements are added. Therefore, the response to a *LRN? query will not normally include the instrument's complete command set.

The following command groups are not available when the instrument is in its default state:

rammatic interface is dynamic. This means the instrument will not

Measurement

se from instrument.

ds containing a ? are treated as queries, a nd the responses are

Implicit activation

Math

Bus

ch and Mark

Sear

Plot

Adding an instance of one of t hose components will cause all comma nds related to that component to be recognized. For example, sending the

ASUrement:ADDNew command adds a measurement at which point the

measurement commands will be recognized. Conversely, once all ins tances of a component have been deleted, the commands related to that component will no longer be recognized.

When you send a command or query related to a dynamic object (such as Math1, Bus3, or Meas2) to the instrument and that instance does not yet exist, the instrument:

creates a default instance with the name you speciﬁed

adds all relevant commands and queries to the set of recognized commands

responds to the command or query

MSO54, MSO56, MSO58, MSO58LP Programmer 1-7

Getting Started

Example 1

Example 2

*RST followed b the default state, the instrument does not have any math waveforms. However querying :MATH:MATH1:DEFinition? will add MATH1 with the default math expression Ch1 - Ch2. Then the query will return the expected result. Note that if Ch1 or Ch2 is not active, they will be activated as part of this action. A *LRN issued after this will return MATH commands in addition to other available commands.

*RST followed by :MEASUrement:MEAS3:TYPE? createsameasurement named MEAS3 and return it's type. Since the default type is Period, you will get P MEASUrement:MEAS3 commands in addition to other available commands.

Not all c and LIST commands do not result in implicit activation.

eriod as the response. A *LRN issued after this will return all

ommands in these groups start implicit activation. ADDNew, DELete,

y a *LRN? will not return any MATH<x> commands because in

Creating, deleting, and listing dynamic instances

You can create a new default instance of a dynamic feature by using the ADDNew command. For example, :MEASUrement:ADDNew "Meas1" will create a new measurement named Meas1. Meas1 will be a Period measurement since the default type for measurements is Period. Note that you can change Meas1 type to any other supported type using :MEASUrement:MEAS1:TYPE command.

ELete comman d deletes the named dynamic instance. For example

The D :BUS:DELete “B2” will delete a bus named B2 if it exists. You can delete only one instance at a time. The LIST command returns a list of all dynamic instances currently in existence. For example, if you have added three measurements named Meas1, Meas2 and Meas3, :MEASUrement:LIST? returns MEAS1, MEAS2, MEAS3.

1-8 MSO54, MSO56, MSO58, MSO58LP Programmer

Command Syntax

You can control the operations and functions of the oscilloscope through the Ethernet port or the USB 3.0 super speed (SS) device port using commands and queries. The and queries. 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.

related topics listed below describe the syntax of these commands

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

[] .. .

Command and Query Structure

Commands consist of set commands and query commands (usually called 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.

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 ACQuire:MODe has a query form ACQuire:MODe?.Notall commands have both a set and a query form. Some commands have set only and some have query only.

Deﬁned element

Is deﬁned as

Optional; can be omitted

Previous element(s) may be repeated

Messages

MSO54, MSO56, MSO58, MSO58LP Programmer 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.

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 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 MSO54, MSO56, MSO58, MSO58LP Programmer

Command Syntax

Queries

Headers

Queries cause t have the structure:

[:]<Header>

[:]<Header>[<Space><Argument> [<Comma><Argumen t>]...]

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 h eaders 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 b elow 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.

MSO54, MSO56, MSO58, MSO58LP Programmer 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 querie s 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 concatenate 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? will return the following.

If the header is on:

DISPLAY:GRATICULE FULL;:DISPLAY:STYLE DOTSONLY

2-4 MSO54, MSO56, MSO58, MSO58LP Programmer

Command Syntax

If the header is

FULL;DOTSONLY

off:

1. Set commands and queries may be concatenated in the same message. For example,

ACQuire:MODe SAMple;NUMAVg?;STATE?

is a valid message that sets the acquisition mode to sample. The message then queries the number of acquisitions for averaging and the acquisition state. Concatenated commands and queries are executed in the order received.

Here are some invalid concatenations:

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

DISPlay:GRAticule FULL;:STYle DOTSONLY OFF (extra colon before STYle.

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

ACQUIRE:FASTACQ:PALETTE TEMPerature;FASTAcq: STATE ON (levels

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

FASTACQ:

or place :ACQUIRE in front of FASTAcq:STATE)

Terminating

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

Table 2-4: End of Message Terminator

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 mnemonic can be CH1, CH2, CH3, CH4, CH5, CH6, CH7, or CH8 depending on the number of FlexChannels in your instrument. You use these mnemonics in the command just as you do any other mnemon there is a command. In the command descriptions, this list of choices is abbreviated as CH<x>.

Message terminator

ic. For example,

CH1:POSition command, and there is also a CH2:POSition

MSO54, MSO56, MSO58, MSO58LP Programmer 2-5

Command Syntax

Bus Mnemonics

Channel Mne

Cursor Position

Mnemonics

monics

Commands speci

fy the bus to use as a mnemonic in the header.

Table 2-5: Bus Mnemonics

Symbol Meaning

B<x>

A bus speciﬁer; <x> is ≥1.

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

Table 2-6: Channel Mnemonics

Symbol Meaning

CH<x> A channel

FlexChannels in your instrument.

CH<x>_D<x> A digital channel speciﬁer; <x> in CH<x> is 1 through 8 and is limited

by the number of FlexChannels in your instrument. <x> in D<x> is 0 through

When cu

rsors are displayed, commands may specify which cursor of the pair to

speciﬁer; <x> is 1 through 8 and is limited by the number of

7. Together they deﬁne a FlexChannel digital input.

use.

Math Speciﬁer Mnemonics

Measurement Speciﬁer

Mnemonics

Table 2-7: Cursor Mnemonics

Symbol Meaning

CURSOR<x>

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

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

ble 2-8: Math Speciﬁer Mnemonics

Symbol Meaning

TH<x>

A m ath waveform speciﬁer; <x> is ≥1.

Commands can specify which measurement to set or query as a mnemonic in the header.

Table 2-9: Measurement Speciﬁer Mnemonics

Symbol Meaning

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

2-6 MSO54, MSO56, MSO58, MSO58LP Programmer

Command Syntax

Reference Waveform

Mnemonics

View Mnemonics

Search Mnemonics

Commands can sp

ecify the reference waveform to use as a mnemonic in the

header.

Table 2-10: Reference Waveform Mnemonics

Symbol Meaning

REF<x>

REF<x>_D<x>

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

A digital reference waveform speciﬁer; <x> is ≥1.

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

Table 2-11: Waveview Mnemonics

Symbol Meaning

WAVEView<x>

PLOTView<x> A plotview speciﬁer; <x> must be equal to 1.

MATHFFTView<x>

A waveview speciﬁer; <x> must be equal to 1.

A mathfftview speciﬁer; <x> must be equal to 1.

Commands can specify a search to use as a mnemonic in t he header.

Zoom Mnemonics

Argument Types

Enumeration

Table 2-12: Search Mnemonics

Symbol Meaning

SEARCH<x> A Search speciﬁ er; <x> is ≥1.

Commandscanspecifyazoomtouseasamnemonicintheheader.

Table 2-13: Zoom Mnemonics

Symbol Meaning

ZOOM<x> A zoom speciﬁer; <x> must be equal to 1.

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

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:

ACQuire:MODe SAMple

MSO54, MSO56, MSO58, MSO58LP Programmer 2-7

Command Syntax

Numeric

Quoted String

Many oscillosc

ope 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 oscilloscope, though any of the formats will be accepted. This documentation represents these arguments as described below.

Table 2-14: Numeric Arguments

Symbol Meaning

<NR1>

<NR2> Floating point value without an exponent

<NR3> Floating point value with an exponent

<bin>

Signed integer value

Signed or unsigned integer 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 in the c

ommand 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

he following is an example of a quoted string:

("). T

string"

. This documentation represents these arguments as follows:

"This is a quoted

Table 2-15: Quoted String Argument

Symbol Meaning

<QString> Quoted string of ASCII text

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

t. Follow these rules when you use quoted strings:

1. Use the same type of quote character to open and close the string. For

xample:

"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. 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.

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

characters.

2-8 MSO54, MSO56, MSO58, MSO58LP Programmer

Command Syntax

Block

Here are some in

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

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

valid strings:

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

Table 2-16: Block Argument

Symbol Meaning

<NZDig>

<Dig>

<DChar> A charac

<Block>

A nonzero

A digit ch

through 255 decimal)

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

digit character in the range of 1–9

aracter, in the range of 0–9

ter with the hexadecimal equivalent of 00 through FF (0

<NZDig> speciﬁes the number of <Dig> elements that follow. Taken together, the <N

ZDig> and <Dig> elements form a decimal integer that speciﬁes how

many <DChar> elements follow.

MSO54, MSO56, MSO58, MSO58LP Programmer 2-9

Command Syntax

2-10 MSO54, MSO56, MSO58, MSO58LP Programmer

Command groups

The programmable interface conforms to Tektronix standard codes and formats except where noted. The interface also conforms to IEEE Std 488.2-1987 except where noted.

Acquisition command group

Acquisiti

on commands set up the modes and functions that control how the instrument acquires signals and processes them into waveforms. Us i ng these commands for acquiring waveforms, you can do the following:

Start and stop acquisitions.

Control w

hether each waveform is simply acquired, averaged, or enveloped

over successive acquisitions of that waveform.

Set the c

ontrols or conditions that start and stop acquisitions.

Control acquisition of acquired channel waveforms.

Set acquisition parameters.

Table 2-17: Acquisition commands

Command Description

ACQuire? Queries the current acquisition state.

ACQuire:FASTA cq:PALEtte Sets or queries the waveform grading for fast acquisition mode.

ACQuire:FASTAcq:STATE Sets or queries the state of fast acquisition mode.

ACQuire:MAXSamplerate?

ACQuire:MODe Sets o r queries the acquisition mode.

ACQuire:NUMACq? Returns the number of waveform acquisitions that have occurred since starting

ACQuire:NUMAVg Sets or queries number of acquisitions for an averaged waveform.

ACQuire:SEQuence:CURrent? In single sequence acquisition mode, this query returns the number of acquisitions

ACQuire:SEQuence:MODe In single sequence acquisition, the single sequence stop after count is based on

ACQuire:SEQuence:NUMSEQuence In single sequence acquisition mode, specify the number of acquisitions or

ACQuire:STATE Starts, stops, or returns acquisition state.

ACQuire:STOPAfter Sets or queries whether the acquisition is continuous or single sequence.

Returns the maximum real-time sample rate.

acquisition with the

or measurements in the sequence completed so far.

number of acquisitions or measurements. Number of acquisitions is the only m ode supported for this product.

measurements that comprise the sequence.

ACQuire:STATE RUN command.

MSO54, MSO56, MSO58, MSO58LP Programmer 2-11

Command groups

AFG Command Gr

oup

Use the AFG commands for Arbitrary Func tion Generator functionality. Requires option AFG.

Table 2-18:

Command Description

AFG:AMPLitude Sets (or queries) the AFG amplitude in volts, peak to peak.

AFG:ARBitrary:SOUrce Sets or queries the source name for the Arbitrary Waveform.

AFG:FREQuency Sets (or queries) the AFG frequency, in Hz.

AFG:FUNCtion Sets (or queries) which AFG function to execute.

AFG:HIGHLevel Sets (or queries) the high level value of the output waveform, in volts.

AFG:LOWLevel Sets (or queries) the low level value of the output waveform, in volts.

AFG:NOISEAdd:PERCent Sets (or queries) the AFG additive noise level as a percentage.

AFG:NOISEAdd:STATE Sets (or queries) the AFG additive noise state.

AFG:OFFSet Sets (or queries) the AFG offset value, in volts.

AFG:OUTPut:LOAd:IMPEDance Sets (or queries) the AFG output load impedance.

AFG:OUTPut:STATE Sets (or queries) the AFG output state.

AFG:PERIod Sets (or queries) the period of the AFG waveform, in seconds.

AFG:PULse:WIDth Sets (or queries) the AFG pulse width, in seconds.

AFG:RAMP:SYMmetry Sets (or queries) the AFG ramp symmetry as a percentage.

AFG:SQUare:DUty Sets (or queries) the AFG duty cycle, as a percentage.

AFG commands

2-12 MSO54, MSO56, MSO58, MSO58LP Programmer

Alias command group

Command groups

Alias commands allow you to deﬁne new commands as a sequence of standard commands. You might ﬁnd this useful when repeatedly using the same commands to perform certain tasks like setting up m easurements.

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 IEEE 488.2 message unit, which may not appear in a message preceded by a colon, comma, or a command or query program header.

The alias name may not appear in a message followed by p rogram date, 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 the alias deletion functions.

Alias names do not appear in response messages.

TheAliascommandsaredeﬁned in Tektronix Standard Codes and Formats. Deviations between that standard and what is speciﬁed here will be considered errors unless speciﬁcally noted in the command description in this document.

Table 2-19: Alias commands

Command Description

ALIas

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

ALIas:DEFine

ALIas:DELEte

ALIas:DELEte:ALL Deletes all existing aliases.

ALIas:DELEte:NAMe

ALIas:STATE Sets or queries the alias state.

Sets or queries the alias state.

Assigns a sequence of program messages to an alias label.

Removes a speciﬁed alias.

MSO54, MSO56, MSO58, MSO58LP Programmer 2-13

Command groups

Bus command group

Use the commands in the Bus Command Group to conﬁgure a bus. These commands let you:

Specify the bus type.

Specifythesignalstobeusedinthebus.

Specify its display style.

NOTE. Bus commands are present once a bus has been added.

Bus Mnemonics

Commands specify the bus to use as a mnemonic in the header.

Table 2-20: Bus mnemonics

Symbol Meaning

B<x>

A bus speciﬁer; <x> is ≥1.

Table 2-21: Bus commands

Command Description

BUS:ADDNew Adds the speciﬁed bus.

BUS:B<x>:ARINC429A:SOUrce Sets or queries the source for the speciﬁed ARINC429 bus.

BUS:B<x>:ARINC429A:THRESHold Sets or queries the ARINC429 upper threshold for the speciﬁed bus.

BUS:B<x>:ARINC429A:POLARITY Sets or queries the source polarity for the speciﬁed ARINC429 bus.

BUS:B<x>:ARINC429A:DATAFORmat Sets or queries the format of the DATA ﬁeld for the speciﬁed ARINC429 bus.

BUS:B<x>:ARINC429A:BITRate Sets of queries the ARINC429 bit rate for the speciﬁed bus.

BUS:B<x>:ARINC429A:BITRate:CUSTom Sets or queries the ARINC429 custom bit rate for the speciﬁed bus.

BUS:B<x>:AUDio:BITDelay Sets or queries the number of delay bits for the speciﬁed AUDIO bus.

BUS:B<x>:AUDio:BITOrder Speciﬁes the bit order for the speciﬁed AUDIO bus.

BUS:B<x>:AUDio:CLOCk:POLarity Sets or queries the clock polarity for the speciﬁed AUDIO bus.

BUS:B<x>:AUDio:CLOCk:SOUrce Sets or queries the clock source waveform for the speciﬁed AUDIO bus.

BUS:B<x>:AUDio:CLOCk:THReshold Sets or queries the Audio Clock source threshold for the speciﬁed bus.

BUS:B<x>:AUDio:DATa:POLarity Speciﬁes the data polarity for the speciﬁed AUDIO bus.

BUS:B<x>:AUDio:DATa:SIZe Speciﬁes the number of bits per word for the speciﬁed AUDIO bus.

BUS:B<x>:AUDio:DATa:SOUrce Speciﬁes the audio data source waveform for the speciﬁed AUDIO bus.

BUS:B<x>:AUDio:DATa:THReshold Sets or queries the Audio Data source threshold for the speciﬁed bus.

BUS:B<x>:AUDio:DATa:WORDSize Sets or queries the Audio bits per word for the speciﬁed bus.

BUS:B<x>:AUDio:FRAME: CLOCKBITSPERCHANNEL

BUS:B<x>:AUDio:FRAME:SIZe Speciﬁes the number of channels in each frame for the speciﬁed AUDIO bus.

BUS:B<x>:AUDio:TYPe Speciﬁes the audio format (type) for the speciﬁed AUDIO bus.

Sets or queries the Audio bits of sync width for the speciﬁed bus.

2-14 MSO54, MSO56, MSO58, MSO58LP Programmer

Command groups

Table 2-21: Bus commands (cont.)

Command Description

BUS:B<x>:AUDio:WORDSel:POLarity Sets or queries the word select polarity for the speciﬁed AUDIO bus.

BUS:B<x>:AUDio:WORDSel:SOUrce Speciﬁes the word select source waveform for the AUDIO bus.

BUS:B<x>:AUDio:WORDSel:THReshold Sets or queries the Audio Word Select source threshold for the speciﬁed bus.

BUS:B<x>:CAN:BITRate Sets or queries the CAN bit rate.

BUS:B<x>:CAN:BITRate:VALue Sets or queries CAN bit rate.

BUS:B<x>:CAN:FD:BITRate Sets or queries the increased data phase bit rate used by CAN FD packets on

the speciﬁed CAN bus.

BUS:B<x>:CAN:FD:BITRate:CUSTom Sets or queries the custom bit rate for the increased data phase of CAN FD

packets on the speciﬁed CAN bus.

BUS:B<x>:CAN:SAMPLEpoint Sets or queries the sample point for the speciﬁed CAN bus.

BUS:B<x>:CAN:SIGNal Sets or queries the signal type for the speciﬁed CAN bus.

BUS:B<x>:CAN:SOUrce Sets or queries the CAN source channel.

BUS:B<x>:CAN:STANDard Sets or queries which CAN standard speciﬁcation to analyze the speciﬁed

CAN bus with.

BUS:B<x>:CAN:THReshold Sets or queries the source channel threshold for the speciﬁed CAN bus.

BUS:B<x>:DISplay:FORMat Sets or queries how the data is represented in the busform for the speciﬁed bus.

BUS:B<x>:DISplay:LAYout This command sets or queries the format a bus layer should use.

BUS:B<x>:ETHERnet:DATAMINUSTHRESHold Sets or queries the Ethernet DATA Minus source threshold for the speciﬁed bus.

BUS:B<x>:ETHERnet:DATAPLUSTHRESHold Sets or queries the Ethernet DATA Plus source threshold for the speciﬁed bus.

BUS:B<x>:ETHERnet:IPVFOUR Sets or queries whether IPV4 packets are available for triggering on Ethernet.

BUS:B<x>:ETHERnet:LOWTHRESHold Sets or queries the Ethernet DATA source Low threshold for the speciﬁed bus.

BUS:B<x>:ETHERnet:QTAGGING Sets or queries whether Q-Tagging packets are available for triggering on

Ethernet.

BUS:B<x>:ETHERnet:SIGNALTYpe Sets or queries the Ethernet signal type for the speciﬁed bus.

BUS:B<x>:ETHERnet:SOUrce Speciﬁes the Ethernet data source for differential input.

BUS:B<x>:ETHERNET:SOUrce:DMINus Sets or queries the Ethernet DMINus source.

BUS:B<x>:ETHERNET:SOUrce:DPLUs Sets or queries the Ethernet DPLUs source.

BUS:B<x>:ETHERnet:THRESHold Sets or queries the Ethernet DATA source High threshold for the speciﬁed bus.

BUS:B<x>:ETHERnet:TYPe Speciﬁes the Ethernet standard type: 10Base-T or 100Base-T.

BUS:B<x>:FLEXray:BITRate Sets or queries the FlexRay bus bit rate.

BUS:B<x>:FLEXray:BITRate:CUSTom Sets or queries the FlexRay custom bit rate for the speciﬁed bus.

BUS:B<x>:FLEXray:CHannel Sets or queries the FlexRay bus channel.

BUS:B<x>:FLEXray:LOWTHRESHold Sets or queries the FlexRay data source low threshold for the speciﬁed bus.

BUS:B<x>:FLEXray:SIGnal Sets or queries the FlexRay probe.

BUS:B<x>:FLEXray:SOUrce Sets or queries the FlexRay bus source.

BUS:B<x>:FLEXray:SOUrce:TXRX Sets or queries the FlexRay TxRx data source for the speciﬁed bus.

BUS:B<x>:FLEXray:THRESHold Sets or queries the FlexRay data source threshold for the speciﬁed bus.

BUS:B<x>:FLEXray:TXRXTHRESHold Sets or queries the FlexRay data source TxRx threshold for the speciﬁed bus.

MSO54, MSO56, MSO58, MSO58LP Programmer 2-15

Command groups

Table 2-21: Bus commands (cont.)

Command Description

BUS:B<x>:I2C:CLOCk:SOUrce Sets or queries the I2C clock (SCLK) source for the speciﬁed bus.

BUS:B<x>:I2C:CLOCk:THReshold Sets or queries the I2C Clock (SCLK) source threshold for the speciﬁed bus.

BUS:B<x>:I2C:DATa:SOUrce Sets or queries the I2C data (SDA) source for the speciﬁed bus.

BUS:B<x>:I2C:DATa:THReshold Sets or queries the I2C Data (SDA) source threshold for the speciﬁed bus.

BUS:B<x>:I2C:RWINADDR Determines whether decoded I2C slave addresses are pure seven-bit values,

or have the R/W* combined with them.

BUS:B<x>:LABel:COLor Sets or queries the color of the speci ﬁed bus label.

BUS:B<x>:LABel:FONT:BOLD Sets or queries the bold state of the speciﬁed bus label.

BUS:B<x>:LABel:FONT:ITALic Sets or queries the italic state of the speciﬁed bus label.

BUS:B<x>:LABel:FONT:SIZE Sets or queries the font size of the speciﬁed bus label.

BUS:B<x>:LABel:FONT:TYPE Sets or queries the font type of the s peciﬁed bus label, such as Arial or Times

New Roman.

BUS:B<x>:LABel:FONT:UNDERline Sets or queries the underline state of the speciﬁed bus label.

BUS:B<x>:LABel:name Sets or queries the waveform label for the speciﬁed bus.

BUS:B<x>:LABel:XPOS Sets or queries the x-position of the speciﬁed bus' label.

BUS:B<x>:LABel:YPOS Sets or queries the y-position of the speciﬁed bus' l abel.

BUS:B<x>:LIN:BITRate Sets or queries the LIN bus bit rate.

BUS:B<x>:LIN:IDFORmat Sets or queries LIN bus id format.

BUS:B<x>:LIN:POLarity Sets or queries the LIN bus polarity.

BUS:B<x>:LIN:SAMPLEpoint Speciﬁes the point to sample during each bit period, as a percent, for the

speciﬁed LIN bus.

BUS:B<x>:LIN:SOUrce Sets o r queries sets the LIN bus source.

BUS:B<x>:LIN:SOUrce:THReshold Sets or queries the LIN source threshold for the speciﬁed bus.

BUS:B<x>:LIN:STANDard Sets or queries the LIN bus standard.

BUS:B<x>:LIN:BITRate:CUSTom Sets or queries LIN custom bit rate for the speciﬁed bus.

BUS:B<x>:MIL1553B:SOUrce Sets or queries the source for the speciﬁed MIL-STD-1553 bus.

BUS:B<x>:MIL1553B:THRESHold Sets or queries the MIL-STD-1553 upper threshold for the speciﬁed bus.

BUS:B<x>:MIL1553B:LOWTHRESHold Sets or queries the MIL-STD-1553 lower threshold for the speciﬁed bus.

BUS:B<x>:MIL1553B:POLarity Sets or queries the source polarity for the speciﬁed MIL-STD-1553 bus.

BUS:B<x>:MIL1553B:RESPonsetime:MINimum Sets or queries the minimum response time to a valid command issued for the

speciﬁed MIL-STD-1553 bus.

BUS:B<x>:MIL1553B:RESPonsetime:MAXimum Sets or queries the maximum response time to a valid command issued for the

speciﬁed MIL-STD-1553 bus.

BUS:B<x>:PARallel:ALLTHResholds Sets or queries the threshold for all sources for the parallel bus.

BUS:B<x>:PARallel:ALLTHResholds:APPly Sets all of the data source thresholds to the value of the allMRefs parameter for

the parallel bus.

BUS:B<x>:PARallel:BIT<n>SOUrce Sets or queries the speciﬁed bit source for speciﬁed parallel bus.

BUS:B<x>:PARallel:BIT<n>SOUrce:THReshold Sets or queries the speciﬁed bit source threshold for the speciﬁed parallel bus.

2-16 MSO54, MSO56, MSO58, MSO58LP Programmer

Command groups

Table 2-21: Bus commands (cont.)

Command Description

BUS:B<x>:PARallel:CLOCk:EDGE Determines which edges of its clock signal cause a clocked parallel bus to

sample new states.

BUS:B<x>:PARallel:CLOCk:ISCLOCKED Determines whether the bus operates in a clocked or asynchronous fashion.

BUS:B<x>:PARallel:CLOCkSOUrce Sets or queries the Parallel clock source for the speciﬁed bus.

BUS:B<x>:PARallel:CLOCKSOUrce:THReshold Sets or queries the bit source threshold for the parallel bus.

BUS:B<x>:RS232C:BITRate Sets or queries the RS-232 bit rate for the speciﬁed bus.

BUS:B<x>:RS232C:BITRate:CUSTom Sets or queries the RS232 custom bit rate for the speciﬁed bus.

BUS:B<x>:RS232C:DATABits Sets or queries the number of RS-232 data bits for the speciﬁed bus.

BUS:B<x>:RS232C:DELIMiter Sets or queries the RS-232 delimiting value for a packet on the speciﬁed bus.

BUS:B<x>:RS232C:DISplaymode Sets or queries the display mode for the speciﬁed bus.

BUS:B<x>:RS232C:PARity Sets or queries the RS-232 parity for the speciﬁed bus.

BUS:B<x>:RS232C:POLarity Sets or queries the RS-232 polarity for the speciﬁed bus.

BUS:B<x>:RS232C:SOUrce Sets or queries the RS-232 polarity for the speciﬁed bus.

BUS:B<x>:RS232C:SOUrce:THReshold Sets or queries the RS232 source threshold for the speciﬁed bus.

BUS:B<x>:SPI:BITOrder Sets or queries the shift direction used to de-serialize data for the SPI mode of

the bus.

BUS:B<x>:SPI:CLOCk:POLarity Sets or queries the SPI clock (SCLK) polarity for the speciﬁed bus.

BUS:B<x>:SPI:CLOCk:SOUrce Sets or queries the SPI clock (SCLK) source for the speciﬁed bus.

BUS:B<x>:SPI:CLOCk:THReshold Sets or queries the SPI Clock (SCLK) source threshold for the speciﬁed bus.

BUS:B<x>:SPI:DATa:POLarity Sets or queries the SPI data (DATA) polarity for the speciﬁed bus.

BUS:B<x>:SPI:DATa:SIZe Sets or queries the number of bits per word for the speciﬁed bus.

BUS:B<x>:SPI:DATa:SOUrce Sets or queries the SPI data (DATA) source for the speciﬁed bus.

BUS:B<x>:SPI:DATa:THReshold Sets or queries the SPI Data (SDA) source threshold for the speciﬁed bus.

BUS:B<x>:SPI:FRAMING Sets or queries the SPI bus framing.

BUS:B<x>:SPI:IDLETime Sets or queries the SPI bus idle time.

BUS:B<x>:SPI:SELect:POLarity Sets or queries the SPI Slave Select (SS) polarity for the speciﬁed bus.

BUS:B<x>:SPI:SELect:SOUrce Sets or queries the SPI Slave Select (SS) source for the speciﬁed bus.

BUS:B<x>:SPI:SELect:THReshold Sets or queries the SPI Select (SS) source threshold for the speciﬁed bus.

BUS:B<x>:TYPe Sets or queries the bus type speciﬁed.

BUS:B<x>:USB:BITRate Sets or queries the USB bit rate for the speciﬁed bus.

BUS:B<x>:USB:SOUrce Sets or queries the USB Data Source for the speciﬁed bus.

BUS:B<x>:USB:SOUrce:DMINus Sets or queries the USB Data Source for D- input for the speciﬁed bus.

BUS:B<x>:USB:SOUrce:DPLUs Sets or queries the USB Data Source for D+ input for the speciﬁed bus.

BUS:B<x>:USB:DATAMINUSTHRESHold Sets o r queries the USB DATA Minus source threshold for the speciﬁed bus.

BUS:B<x>:USB:DATAPLUSTHRESHold Sets or queries the USB DATA Plus source threshold for the speciﬁed bus.

BUS:B<x>:USB:LOWTHRESHold Sets or queries the USB DATA source Low threshold for the speciﬁed bus.

BUS:B<x>:USB:SIGNALTYpe Sets or queries the USB signal type for the speciﬁed bus.

MSO54, MSO56, MSO58, MSO58LP Programmer 2-17

Command groups

Table 2-21: Bus commands (cont.)

Command Description

BUS:B<x>:USB:THRESHold Sets or queries the USB DATA source High threshold for the speciﬁed bus.

BUS:DELete Deletes the speciﬁed bus.

BUS:LIST? Lists all currently de ﬁned bus.

BUSTABle:ADDNew Adds the s peciﬁed bus table.

BUSTABle:DELete Deletes the speciﬁed bus table.

BUSTABle:LIST? Lists all currently deﬁned bus tables.

DISplay:WAVEView<x>:BUS:B<x>:STATE Sets or queries the state of the speciﬁed bus in the speciﬁed waveview.

DISplay:WAVEView<x>:BUS:B<x>:VERTical: POSition

Sets or queries the vertical position of the speciﬁed bus in the speciﬁed

waveview.

2-18 MSO54, MSO56, MSO58, MSO58LP Programmer

Command groups

Calibration c

ommand group

The Calibration commands provide information about the current state of instrument calibration and allow you to initiate signal path calibration (SPC).

NOTE. When r

unning SPC through the remote interface, calibration status cannot be obtained until after the SPC completes, which can take several minutes. Any remote command that performs an action on the oscilloscope is also disabled until the SPC is complete.

Table 2-22: Calibration commands

Command

*CAL? Instructs the instrument to perform signal path calibration and returns the calibration

CALibrate?

CALibrate:INTERNal Starts the signal path calibration. Takes several minutes to run.

CALibrate:INTERNal:STARt Starts the signal path calibration.

CALibrate:INTERNal:STATus? Returns the status of the signal path calibration.

CALibrate:PWRUpstatus? Returns the current status of the power-up calibration.

TOUCHSCReen:CALibrate

TOUCHSCReen:STATe Sets or queries the enabled state of the touch screen.

Description

status when complete. Takes several minutes to run.

Returns the calibration status.

Launches the touchscreen calibration.

MSO54, MSO56, MSO58, MSO58LP Programmer 2-19

Command groups

Cursor comman

d 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 each cursor, such as wavef

orm source, and cursor position.

You can also use the commands to select one of the following cursor functions:

Off. Shuts off the display of all cursors.

Vertical bars. Displays vertical bar cursors, which provide traditional

horizontal unit readouts for Cursor 1 (bar1), Cursor 2 (bar2), the delta between them, and 1/delta (results in frequency when the horizontal unit is time). Ve

rtical bars are another name for vertical screen cursors.

Horizontal bars. Displays horizontal bar cursors, w hich provide traditional vertica

l unit readouts for Cursor 1 (bar1), Cursor 2 (bar2), and the delta

between them. Horizontal bars are another name for horizontal screen cursors.

Wavefo

rm cursors. Consists of two cursors you can independently assign to a

waveform. Waveform cursors enable you to conveniently measure waveform amplitude and time at speciﬁc points on the waveform. In XY or XYZ format, waveform cursors indicate the amplitude position of an XY pair (Ch1 vs Ch2 voltage, where Ch1 is the X axis and Ch2 is the Y axis) relative to the trigger.

Screen cursors. Consist of two pairs of horizontal and vertical bar cursors. You can use these cursors to indicate an arbitrary position within the waveform display area. Screen cursors are basically just turning on horizontal

s and vertical bars at the same time. These cursors have no association

bar with any waveform, except that they inherit the color of the waveform they are assigned to.

NOTE. Cursor commands are available once a view has been added.

Table 2-23: Cursor commands

Command

DISplay:MATHFFTView<x>:CURSor: ASOUrce?

DISplay:MATHFFTView<x>:CURSor: BSOUrce?

DISplay:MATHFFTView<x>:CURSor:DDT? Queries the delta V over delta T cursor readout value of the speciﬁed cursor in

DISplay:MATHFFTView<x>:CURSor: FUNCtion

DISplay:MATHFFTView<x>:CURSor:HBArs: APOSition

Description

Queries the cursor source for plot cursor A.

Queries the cursor source for plot cursor B.

the speciﬁed view.

Sets or queries the cursor type of the speciﬁed cursor in the s peciﬁed view.

Sets or returns the vertical cursor A position of the speciﬁed cursor in the speciﬁed view.

2-20 MSO54, MSO56, MSO58, MSO58LP Programmer

Table 2-23: Cursor commands (cont.)

Command groups

Command

DISplay:MATHFFTView<x>:CURSor:HBArs: AUNIts?

DISplay:MATHFFTView<x>:CURSor:HBArs: BPOSition

DISplay:MATHFFTView<x>:CURSor:HBArs: BUNIts?

DISplay:MATHFFTView<x>:CURSor:HBArs: DELTa?

DISplay:MATHFFTView<x>:CURSor:MODe Sets or returns the cursor tracking mode of the speciﬁed cursor in the speciﬁed view.

DISplay:MATHFFTView<x>:CURSor: ONEOVERDELTATVALUE?

DISplay:MATHFFTView<x>:CURSor: SCREEN:AXPOSition

DISplay:MATHFFTView<x>:CURSor: SCREEN:AYPOSition

DISplay:MATHFFTView<x>:CURSor: SCREEN:BXPOSition

DISplay:MATHFFTView<x>:CURSor: SCREEN:BYPOSition

DISplay:MATHFFTView<x>:CURSor:STATE Sets or queries the visible state of the speciﬁed cursor in the speciﬁed view.

DISplay:MATHFFTView<x>:CURSor:VBArs: APOSition

DISplay:MATHFFTView<x>:CURSor:VBArs: BPOSition

DISplay:MATHFFTView<x>:CURSor:VBArs: DELTa?

DISplay:MATHFFTView<x>:CURSor:VBArs: UNIts?

DISplay:MATHFFTView<x>:CURSor: WAVEform:APOSition

DISplay:MATHFFTView<x>:CURSor: WAVEform:BPOSition

DISplay:PLOTView<x>:CURSor:ASOUrce? Queries the cursor source for plot cursor A.

DISplay:PLOTView<x>:CURSor:BSOUrce? Queries the cursor source for plot cursor B.

DISplay:PLOTView<x>:CURSor:DDT? Queries the delta V over delta T cursor readout value of the speciﬁed cursor in

DISplay:PLOTView<x>:CURSor:FUNCtion Sets or queries the cursor mode of the speciﬁed cursor in the speciﬁed view.

DISplay:PLOTView<x>:CURSor:HBArs: APOSition

DISplay:PLOTView<x>:CURSor:HBArs: AUNIts?

Description

Queries cursor A vertical units of the speciﬁed cursor in the speciﬁed view.

Sets or returns the vertical cursor B position of the speciﬁed cursor in the speciﬁed view.

Queries the cursor B vertical units of the speciﬁed cursor in the speciﬁed view.

Queries the delta V cursor readout value of the speciﬁed cursor in the speciﬁed view.

Queries the one over delta T cursor readout value of the speciﬁed cursor in the speciﬁed view.

Sets or returns the horizontal cursor A position of the speciﬁed cursor in the speciﬁed view.

Sets or returns the vertical cursor A position of the speciﬁed cursor in the speciﬁed view.

Sets or returns the horizontal cursor B position of the speciﬁed cursor in the speciﬁed view.

Sets or returns the vertical cursor B position of the speciﬁed cursor in the speciﬁed view.

Sets or queries the horizontal cursor A position of the speciﬁed cursor in the speciﬁed view.

Sets or queries the horizontal cursor B position of the speciﬁed cursor in the speciﬁed view.

Queries the delta T cursor readout value of the speciﬁed cursor in the speciﬁed view.

Queries the cursor A vertical units of the speciﬁed cursor in the speciﬁed view.

Sets or queries the waveform cursor A position in the speciﬁed plot view.

Sets or queries the waveform cursor B position in the speciﬁed plot view.

the speciﬁed view.

Sets or queries the vertical cursor A position of the speciﬁed cursor in the speciﬁed view.

Sets or queries the cursor A vertical units of the s peciﬁed cursor in the speciﬁed view.

MSO54, MSO56, MSO58, MSO58LP Programmer 2-21

Command groups

Table 2-23: Cursor commands (cont.)

Command

DISplay:PLOTView<x>:CURSor:HBArs: BPOSition

DISplay:PLOTView<x>:CURSor:HBArs: BUNIts?

DISplay:PLOTView<x>:CURSor:HBArs: DELTa?

DISplay:PLOTView<x>:CURSor:MODe Sets or queries the cursor tracking mode of the speciﬁed cursor in the speciﬁed view.

DISplay:PLOTView<x>:CURSor: ONEOVERDELTATVALUE?

DISplay:PLOTView<x>:CURSor:SCREEN: AXPOSition

DISplay:PLOTView<x>:CURSor:SCREEN: AYPOSition

DISplay:PLOTView<x>:CURSor:SCREEN: BXPOSition

DISplay:PLOTView<x>:CURSor:SCREEN: BYPOSition

DISplay:PLOTView<x>:CURSor: SPLITMODE

DISplay:PLOTView<x>:CURSor:STATE Sets or queries the visible state of the cursor of the speciﬁed cursor in the speciﬁed

DISplay:PLOTView<x>:CURSor:VBArs: APOSition

DISplay:PLOTView<x>:CURSor:VBArs: BPOSition

DISplay:PLOTView<x>:CURSor:VBArs: DELTa?

DISplay:PLOTView<x>:CURSor:VBArs: UNIts?

DISplay:PLOTView<x>:CURSor:WAVEform: APOSition

DISplay:PLOTView<x>:CURSor:WAVEform: BPOSition

DISplay:REFFFTView<x>:CURSor: ASOUrce?

DISplay:REFFFTView<x>:CURSor: BSOUrce?

DISplay:REFFFTView<x>:CURSor:DDT? Queries the delta V over delta T cursor readout value of the speciﬁed cursor in

DISplay:REFFFTView<x>:CURSor:FUNCtion Sets or queries the cursor type of the speciﬁed cursor in the s peciﬁed view.

DISplay:REFFFTView<x>:CURSor:HBArs: APOSition

Description

Sets or queries the vertical cursor B position of the speciﬁed cursor in the speciﬁed view.

Sets or queries the cursor B vertical units of the speciﬁed cursor in the speciﬁed view.

Sets or queries the delta V cursor readout value of the speciﬁed cursor in the speciﬁed view.

Sets or queries the one over delta T cursor readout value of the speciﬁed cursor in the speciﬁed view.

Sets or queries the horizontal cursor A position of the speciﬁed cursor in the speciﬁed view.

Sets or queries the vertical cursor A position of the speciﬁed cursor in the speciﬁed view.

Sets or queries the horizontal cursor B position of the speciﬁed cursor in the speciﬁed view.

Sets or queries the vertical cursor B position of the speciﬁed cursor in the speciﬁed view.

Sets or queries the cursor source mode in the speciﬁed view.

view.

Sets or queries the horizontal cursor A position of the speciﬁed cursor in the speciﬁed view.

Sets or queries the horizontal cursor B position of the speciﬁed cursor in the speciﬁed view.

Queries the delta T cursor readout value of the speciﬁed cursor in the speciﬁed view.

Queries the VBArs cursor readout units of the speciﬁed cursor in the speciﬁed view.

Sets or queries the horizontal cursor A position of the speciﬁed cursor in the speciﬁed view.

Sets or queries the horizontal cursor B position of the speciﬁed cursor in the speciﬁed view.

Queries the cursor source for plot cursor A

Queries the cursor source for plot cursor B.

the speciﬁed view.

Sets or queries the vertical cursor A position of the speciﬁed cursor in the speciﬁed view.

2-22 MSO54, MSO56, MSO58, MSO58LP Programmer

Table 2-23: Cursor commands (cont.)

Command groups

Command

DISplay:REFFFTView<x>:CURSor:HBArs: AUNIts?

DISplay:REFFFTView<x>:CURSor:HBArs: BPOSition

DISplay:REFFFTView<x>:CURSor:HBArs: BUNIts?

DISplay:REFFFTView<x>:CURSor:HBArs: DELTa?

DISplay:REFFFTView<x>:CURSor:MODe Sets or queries the cursor tracking mode of the speciﬁed cursor in the speciﬁed view.

DISplay:REFFFTView<x>:CURSor: ONEOVERDELTATVALUE?

DISplay:REFFFTView<x>:CURSor:SCREEN: AXPOSition

DISplay:REFFFTView<x>:CURSor:SCREEN: AYPOSition

DISplay:REFFFTView<x>:CURSor:SCREEN: BXPOSition

DISplay:REFFFTView<x>:CURSor:SCREEN: BYPOSition

DISplay:REFFFTView<x>:CURSor: SPLITMODE

DISplay:REFFFTView<x>:CURSor:STATE Sets or queries the visible state of the cursor of the speciﬁed cursor n the speciﬁed

DISplay:REFFFTView<x>:CURSor:VBArs: APOSition

DISplay:REFFFTView<x>:CURSor:VBArs: BPOSition

DISplay:REFFFTView<x>:CURSor:VBArs: DELTa?

DISplay:REFFFTView<x>:CURSor:VBArs: UNIts?

DISplay:REFFFTView<x>:CURSor: WAVEform:AHPOSition?

DISplay:REFFFTView<x>:CURSor: WAVEform:APOSition

DISplay:REFFFTView<x>:CURSor: WAVEform:AVPOSition?

DISplay:REFFFTView<x>:CURSor: WAVEform:BHPOSition?

DISplay:REFFFTView<x>:CURSor: WAVEform:BPOSition