Tektronix TBS1000B/EDU, TDS2000B, TDS1000B, TBS1000, TDS2000C Programmer's Manual

...

TBS1000B/EDU, TBS1000, TDS2000C/TDS1000C-EDU, TDS2000B/TDS1000B, TDS2000/TDS1000, TDS200 and

ZZZ

TPS2000B/TPS2000 Series Digital Oscilloscopes

Programmer

*P077044403*

077-0444-03

TBS1000B/EDU, TBS1000, TDS2000C/TDS1000C-EDU, TDS2000B/TDS1000B, TDS2000/TDS1000, TDS200 and

ZZZ

TPS2000B/TPS2000 Series Digital Oscilloscopes

Programmer

Revision A 20170113

www.tek.com

077-0444-03

Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions.

Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in all previously published material. Speciﬁcations and price change privileges reserved.

TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.

OpenChoice® is a registered trademark of Tektronix Inc.

Tektronix is an authorized licensee of the CompactFlash® trademark.

PictBridge is a trademark of the Standard of Camera & Imaging Products Association CIPA DC-001-2003 Digital Photo Solutions for Imaging Devices.

Contacting Tektronix

Tektronix, Inc. 14150 SW Karl Braun Drive P.O. B o x 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

Related Documents ........................................................................................... iv

Conventions .................................................................................................. vii

Getting Started

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

Syntax and Commands

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

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

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

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

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

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

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

Acquisition Commands .... . . .... . ..... . ..... . ..... . ..... . ..... ..... . ..... . ..... . ..... . ..... . ... . . . .... . .. 2-11

Calibration and Diagnostic Commands .. ................................ ............................... 2-11

Counter Commands (TBS1000B/EDU models only).................................................. 2-12

Cursor Commands ......................................................................................... 2-12

Data Logging Commands (Available Only On TBS1000B, TBS1000 and TDS2000C Series

Models) ... ................................ .................................. ........................... 2-13

Display Commands........................................................................................ 2-13

FFT Commands (TBS1000B/EDU models only)...................................................... 2-15

File System Commands (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B,

TDS1000B, TDS2MEM Module, TPS2000B, and TPS2000 Only) .. . ..... . ..... . ..... . ..... . . 2-15

Hard Copy Commands .................................................................................... 2-17

Horizontal Commands .................................................................................... 2-17

Limit Test Commands (Available Only On TBS1000B, TBS1000 and TDS2000C Series

Models) ... ................................ .................................. ........................... 2-18

Math Commands........................................................................................... 2-20

Measurement Commands ................................................................................. 2-22

Miscellaneous Commands................................................................................ 2-23

PictBridge Commands (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and

TDS1000B Only) ..................................................................................... 2-24

Power and Battery-Related Commands (TPS2000B and TPS2000 Only) .......................... 2-25

Power Measurement (TPS2000B/TPS2000 with TPS2PWR1 Power Analysis Application Key

Installed Only)................ ................................ ................................ ......... 2-25

RS-232 Commands (TDS2000, TDS1000, TDS200, TPS2000B, and TPS2000 Only) ... . ... . . . . 2 -28

TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer i

Table of Contents

Save and Recall

Status and Error Commands .............................................................................. 2-29

Trend Plot Commands (TBS1000B models only)...................................................... 2-30

Trigger Commands ........................... ................................ ............................. 2-30

Vertical Commands........................................................................................ 2-32

Waveform Commands................................ .................................. ................... 2-32

Zoom Comman

Command Descriptions ........................................................................................ 2-39

Manual Conventions................ ................................ .................................. ..... 2-39

Commands.............................................................................. 2-28

ds (TBS1000B/EDU models only) ............... ................................ ..... 2-36

Status and Events

Status a

nd Events ...... ................................ ................................ ........................... 3-1

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

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

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

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

Programming Examples

Programming Examples .......................... ................................ ............................... 4-1

Appendices

endix A: ASCII Code Chart ................. ................................ .............................. A-1

App

Appendix B: Factory Setup..................................................................................... B-1

TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series Oscilloscopes. . . .. B-1

TPS2000 Series Oscilloscopes . . .... . ..... . ..... . ..... . ..... . ... . . ..... . ..... . ..... . ... . . . .... . ..... . ..... B-2

TPS2000B Series Oscilloscopes .. . ..... . ..... . ..... . ... . . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . B-4

TDS1000 and TDS2000 Series Oscilloscopes. ... . . . .... . ..... . ..... . .... . ..... . ..... . .... . . .... . ..... . . B-5

DS210 and TDS220 Oscilloscopes .. . ..... . ..... . ..... . ..... . ... . . . .... . . .... . ..... . ..... . ..... . ..... . . B-7

TDS224 Oscilloscopes . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ... . . . B-8

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

Glossary

ii TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer

Preface

This programmer manual provides information on how to remotely operate your oscilloscope. You can use communication ports and protocols, such as for the RS-232, the G (USB) standards, to remotely control and operate your oscilloscope.

eneral Purpose Interface Bus (GPIB), or Universal Serial Bus

This docume

TBS1000B/EDU Series instructions, any version

TBS1000 Series instruments, any version

TPS2000 and TPS2000B Series instruments, any version.

TDS1000C-EDU, any version.

TDS2000C Series instruments, any version.

TDS1000

TDS2CMorTDS2CMA,anyversion,whenusedinTDS1000orTDS2000 Series

TDS2MEM any version, when used in most TDS1000 or TDS2000 Series instr

TDS2CM, TDS2CMA, or TDS2MM any version, when used in a TDS2

TDS2CM or TDS2CMA version CMV:v1.04 and above, or TDS2MM any ver above.

nt supports the following products:

B and TDS2000B Series instruments, any version.

instruments, any version.

uments (except TDS1001 and TDS2004 models), any version.

24 instrument, any version.

sion, when used in TDS210 and TDS220 instruments with FV:v1.09 and

TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer iii

Preface

Conventions

er to Command Syntax for information about command conventions. (See

Ref page 2-1.)

s manual uses the following conventions:

Thi

References to the TDS2CMA Communications Extension Module include the

S2CM and TDS2CMAX modules.

Command descriptions list speciﬁc oscilloscopes series (and modules) when

ommands are valid for only those products

TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer vii

Preface

viii TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer

Getting Started

This manual contains information on how to remotely control and operate your oscilloscope through communications protocol and commands.

NOTE. For TB

S1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and the TDS1000B Series, you need to install the PC Communications software from the CD that came with the oscilloscope on a PC before you connect the oscilloscope USB Device port to the PC. Refer to the product user manual for installation information.

For all products, you need to connect an appropriate cable between the communications port on your oscilloscope and your PC.

The next table describes where the communications port is located on an extension module or oscilloscope, and the function of the port.

Series Port location Port function

TDS200 TDS2CM, TDS2CMA,

or TDS2CMAX

nications, TDS2MM

Commu Math

TDS1000/ TDS2000

1000B/EDU,

TBS TBS1000, TDS2000C, TDS1000C-EDU,

1000B, and

TDS TDS2000B

TPS2000 and TPS2000B Back of oscilloscope RS-232, Centronics

TDS1001 and TDS2004 are not compatible with the TDS2MEM module.

stall the PC Communications software from the CD that came with the oscilloscope ﬁrst,andthenreferto

In your product user manual for information on installing the software. After the software is installed, connect the oscilloscope to a PC.

TDS2CMA or TDS2CMAX

TDS2MEM Storage Memory

ommunications

and C

k of o s cil loscope

Bac

RS-232, Centronics, GPIB

RS-232, Centronics,

actFlash

Comp

Device

USB

B with a TEK-USB-488

GPI adapter

Refer to your oscilloscope user manual for information on how to install, test, and conﬁgure your oscilloscope and module.

NOTE. The ﬁrmware for the TBS1000B/EDU, TBS1000, TDS2000C,

TDS1000C-EDU, TDS1000B, TDS2000B, TPS2000B, and TPS2000 Series oscilloscopes includes communications, math, and storage memory functions.

TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer 1-1

Getting Started

TDS2CM, TDS2CMA or

Series

TDS200

TDS1000 or

TDS2CMAX TDS2MM TDS2MEM TEK-USB-488

Yes Yes No No

Yes No Yes

TDS2000

TBS1000B/EDU,

No No No Yes TBS1000, TDS2000C, TDS1000C-EDU, TDS1000B or TDS2000B

TPS2000 o TPS2000B

TDS1001 and TDS2004 models are not compatible with the TDS2MEM module.

RS-232 is

No No No No

included in the oscilloscope ﬁrmware.

NOTE. If you use GPIB with the TBS1000B/EDU, TBS1000, TDS2000C,

TDS1000C-EDU, TDS2000B, or TDS1000B Series, you can set a unique GPIB address for the oscilloscope through the UTILITY ► Options ► GPIB Setup option.

1-2 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer

Syntax and Commands

Command Syntax

You can control the oscilloscope through the GPIB, RS-232, or USB interface using a large group of commands and queries.

This section describes the syntax these commands and queries use and the conventions the oscilloscope uses to process them. The commands and queries themselves are listed in the Command Descriptions section.

Command Syntax

Table 2-1: Oscilloscope communication protocol

Model or option GPIB RS-232 USB

TDS2CM, TDS2CMA, TDS2CMAX

TDS2MM

TDS2MEM

TDS1000 or TDS2000

TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS1000B, or TDS2000B

TPS2000B, TPS2000

Yes Yes No

No Yes No

Yes

No Yes No

Function available with a TDS2CM, TDS2CMA, or TDS2CMAX module. Function available with a TDS2MEM module. Function available with a TEK-USB-488 adapter.

Yes

No Yes

You transmit commands to the oscilloscope using the enhanced American Standard Code for Information Interchange (ASCI

I) character encoding. Appendix

A contains a chart of the ASCII character set.

The Backus Naur Form (BNF) notation is used in this manual to describe commands and queries.

Table 2-2: BNF notation

Symbol Meaning

::=

| Exclusive OR

{ } Group; one element is required

Deﬁned element

Is deﬁned as

TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer 2-1

Command Syntax

Table 2-2: BNF notation (cont.)

Symbol Meaning

[] .. .

( ) Comment

Command and Query Structure

Commands consist of set commands and query commands (usually simply called commands and queries). Commands change oscilloscope settings or perform a speciﬁc action. Queries cause the oscilloscope to return data and information about its status.

Most commands have both a set form and a query form. The query form of the command is the same as the set form except that it ends with a question mark. For example, the set command ACQuire:MODe has a query form ACQuire:MODe. Not all commands have both a set and a query form; some commands are set only and some are query only.

Optional; can be omitted

Previous element(s) may be repeated

A few commands do both a set and query action. For example, the *CAL? command runs a self-calibration program on the oscilloscope, then returns the result of the calibration.

A command message is a command or query name, followed by any information the oscilloscope needs to execute the command or query. Command messages consist of ﬁve different element types.

Table 2-3: Command message elements

Symbol Meaning

<Argument> A quantity, quality, restriction, or limit associated with the header.

<Comma> A single comma between arguments of multiple-argument commands.

<Space>

The basic command name. If the header ends with a question mark, the command is a query. The header may begin with a colon (:) character; if the command is concatenated with other commands the beginning colon is required. The beginning colon can never be used with command headers beginning with a star (*).

A header subfunction. Some command headers have only one mnemonic. If a command header has multiple mnemonics, they are always separated from each other by a colon (:) character.

Not all commands have an argument, while other commands have multiple arguments. Arguments are separated from the header by a <Space>. Arguments are separated from each other by a <Comma>.

It may o ptionally have white space characters before and after the comma.

A white space character between command header and argument. It may optionally consist of multiple white space characters.

2-2 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer

Command Syntax

Commands

The following ﬁ

Figure 2-1: Command message elements

Commands cause the oscilloscope to perform a speciﬁc function or change one of its settings. Commands have the structure:

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

A command header is made up of one or more m nemonics arranged in a hierarchical or tree structure. The ﬁrst mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off of the previous one. Commands at a higher level in the tree may affect those at a lower level. The

g colon (:) always returns you to the base of the command tree.

leadin

gure shows the ﬁve command message elements.

Queries

Headers in Query

Responses

Queries cause the oscilloscope to return information about its status or settings. Queries have the structure:

[:]<Header>

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

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

For example, MEASUrement:MEAS<x>:UNIts? returns the measurement units, while MEASUrement:MEAS<x>:TYPe? returns the measurement type selected for t he measurement, and MEASUrement:MEAS<x>? returns all the

easurement parameters for the speciﬁed measurement.

You can control whether the oscilloscope returns headers as part of the query response. Use the HEADer command to control this feature. If header is on, the oscilloscope returns command headers as part of the query and formats the query response as a valid set command. When header is off, the oscilloscope sends back only the values in the response. This format can make it easier to parse and extract the information from the response.

TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer 2-3

Command Syntax

Clearing the Output Queue

Command Entry

Table 2-4: Comp

Query Header Off response Header On response

ACQuire:NUMAVg

CHx1:COUPling DC CH1:COUPLING DC

To clear the output queue and reset the oscilloscope to accept a new c ommand or query, send a Device Clear (DCL) from a GPIB host.

From an RS-232 host, send a break signal. The RS-232 interface responds by returning the ASCII string "DCL."

From a USB host, send an INITIATE_CLEAR followed by a C HECK_CLEAR_STATUS. The USB interface responds to CHECK_CLEAR_STATUS with STATUS_SUCCESS when it is ﬁnished clearing the output queue.

Follow these general rules when entering commands:

Enter commands in upper or lower case.

arison of Header Off and Header On responses

ACQUIRE:NUMAVG 64

Abbreviating Commands

Concatenating C ommands

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

You can abbreviate many oscilloscope commands. These abbreviations are shown in capital letters in the command listing in the Command Groups section and Command Descriptions section. For example, the command ACQuire:NUMAvg can be entered simply as ACQ : NUMA or acq:numa.

If you use the HEADer command to have command headers included as part of query responses, you can a lso control whether the returned headers are abbreviated or are full-length using the VERBose command.

You can concatenate any combination of set commands and queries using a semicolon (;). The oscilloscope executes concatenated commands in the order received. When concatenating commands and queries you must follow these rules:

Completely different headers must beseparatedbybothasemicolonand by the beginning colon on all commands but the ﬁrst. For example, the commands TRIGger:MODe NORMal and ACQuire:NUMAVg 16 can be concatenated into a single command:

2-4 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer

Command Syntax

TRIGger:MODe N

If concatenated commands have headers that differ by only the last mnemonic, you beginning colon. For example, the commands ACQuire:MODe AVErage and ACQuire:NUMAVg 16 could be concatenated into a s ingle command:

ACQuire:MODe AVErag e; NUMAVg 16

The longer v

ACQuire:MODe AVErage;:ACQuire:NUMAVg 16

Never precede a star (*) command with a colon or semicolon:

ACQuire:MODe AVErage;*TRG

The oscilloscope processes commands that follow the star command as if the star command was not there, so:

ACQuire:MODe AVErage;*TRG;NUMAVg 16

sets the acquisition mode to average and sets acquisition averaging to 16. The *TRG command is ignored.

When you concatenate queries, the responses to all queries are combined into a single response message. For example, if channel 1 coupling is set to DC and the bandwidth is set to 20 MHz, the concatenated query:

ORMal;:ACQuire:NUMAVg 16

can abbreviate the second command and eliminate the

ersion works equally well:

CH1:COUPling;BANdwidth

returns CH1:COUPLING DC;:CH1:BANDWIDTH ON if header is on, or DC;ON if header is off.

You can concatenate set commands and queries in the same message. For example:

ACQuire:MODe AVErage;NUMAVg;STATE

s a valid message that sets the acquisition mode to average, queries the

i number of acquisitions for averaging, and then queries the acquisition state. The oscilloscope executes concatenated commands and queries in the order it receives them.

Any query that returns arbitrary data, such as ID, must be the last query when part of a concatenated command. If the query is not last, the oscilloscope generates event message 440.

Here are some INVALID concatenation examples:

CH1:COUPling DC;ACQuire:NUMAVg 16 (missing colon before ACQuire)

CH1:COUPling DC;:BANDwidth ON (invalid colon before BANDwidth)

CH1:COUPling DC;:*TRG (invalid colon before a star (*) command)

TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer 2-5

Command Syntax

Message Terminators

HORizontal:MA different; either remove the second occurrence of MAIn:, or put HORizontal: in front of MAIN:SCAle)

This manual uses the term <EOM> (End of message) to represent a message terminator.

GPIB End of Message (EOM) Terminators. GPIB EOM terminators can be the END message (EOI asserted concurrently with the last data byte), the ASCII code for line feed (LF) sent as the last data byte, or both. The oscilloscope always terminates messages with LF and EOI. White space is allowed before the terminator; for example, CR LF is acceptable.

USB End of Message (EOM) Terminators. The EOM bit must be set in the USB header of the last transfer of a command message

See the USB Test and Measurement Class Speciﬁcation (USBTMC) section

3.2.1 for details. The oscilloscope terminates messages by setting the EOM bit in the USB header of the last transfer of a message to the host (USBTMC Speciﬁcation section 3.3.1), and by terminating messages with a LF. White space is allowed before the terminator; for example, CR LF is acceptable.

RS-232 End of Message Terminators. RS-232 EOM terminators can be a CR (carriage return), LF (line feed), CRLF (carriage return followed by a line feed), or LFCR (line feed followed by a carriage return)

In:POSition 0;MAIn:SCAle 1E-13 (levels of mnemonics are

When receiving, the oscilloscope accepts all four combinations as valid input message terminators regardless of the currently selected terminator. When a combination of multiple characters is selected (CRLF or LFCR), the oscilloscope interprets the ﬁrst character as the terminator and the second character as a null command.

Constructed Mnemonics

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

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

Symbol

CH<x> 2-channel models: A channel speciﬁer; <x> is 1 or 2.

Meaning

4-channel models: A channel speciﬁer; <x> is 1, 2, 3, or 4.

2-6 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer

Command Syntax

Reference Waveform

Mnemonics

Waveform Mnemonics

Cursor Position Mnemonic

Commands can sp

ecify the reference waveform to use as a mnemonic in the

header.

Symbol Meaning

REF<x>

2-channel models: A reference waveform speciﬁer; <x> is A or B.

4-channel models: A reference waveform speciﬁer; <x> is A, B, C, or D.

In some commands you can specify a waveform without regard to its type: channel waveform, math waveform, or reference waveform. The "y" is the same as "x" in Reference Waveform Mnemonics.

Symbol Meaning

When the oscilloscope displays cursors, commands may specify which cursor of the pair to use.

Symbol Meaning

POSITION<x>

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

Measurement Speciﬁer

Mnemonics

Argument Types

Commands can specify which measurement to set or query as a mnemonic in the header. The oscilloscope can display up to four (TDS200) or ﬁve (TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, a nd TPS2000) or six (TBS1000B/EDU) automated measurements.

Symbol Meaning

MEAS<x> A measurement speciﬁer; <x> is 1-4 (TDS200) or 1-5 (TBS1000,

TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000,

S1000, TPS2000B, and TPS2000) or 1-6 (TBS 1000B/EDU).

A command argument can be in one of several forms. The individual descriptions of each command tell which argument types to use with that command.

TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer 2-7

Command Syntax

Numeric Arguments

Many oscillosc

ope commands require numeric arguments.

Table 2-5: Types of numeric arguments

Symbol Meaning

<NR1>

<NR2> Floating po

<NR3> Floating point value with an exponent

Signed integer value

int value without an exponent

The syntax shown is the data format that the oscilloscope returns in response to aquery.Th

is format is also the preferred format when sending a command to

the oscilloscope.

When you e

nter an incorrect numeric argument, the oscilloscope automatically

forces the numeric argument to a correct value.

Table 2-6: Oscilloscope handling of incorrect numeric arguments

Argument value

Numeric argument is less than lowest correct value for that command

Numeric argument is greater than the highest

ct value for that command

corre

ic value is between two correct values

Numer

Oscilloscope response

Sets the speciﬁed command to the lowest

t value and executes the command

correc

he speciﬁed command to the highest

Sets t correct value and executes the c ommand

s the entered value to the nearest

Round correct value and executes the c ommand

Quoted String Arguments

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

"this is a quoted string"

Symbol Meaning

<QString> Quoted string of ASCII text

2-8 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer

Command Syntax

Follow these ru

les when you use quoted strings:

1. A quoted string can include any character deﬁned in the 7-bit ASCII character set. (See page

A-1, ASCII Code Chart.).

2. Use the same type of quote character to open and close the string:

"this is a valid string"

3. You can mix quotation marks within a string if you follow the previous rule:

"this is an 'accepta ble' string"

4. You can include a quote character within a string simply by repeating the quote. For example,

"hereisa""mark"

5. Strings

can have upper or lower case characters.

6. If you use a GPIB network, you cannot terminate a quoted string with the END mes

sage before the closing delimiter.

7. A carriage return or line feed embedded in a quoted string does not terminate

ring, but is treated as just another character in the string.

the st

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

cters.

chara

Block Arguments

Herearesomeexamplesofinvalidstrings:

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

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

Several oscilloscope commands use a block argument form.

Table 2-7: Parts of a block argument

Symbol Meaning

<NZDig>

<Dig> A digit character, in the range 0-9

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

<Block>

A nonzero digit character, in the range 1-9 Speciﬁes the number of <Dig> elements that follow

(0 through 255 decimal)

A block of data bytes, deﬁned as:

<Block> := { #<NZDig><Dig>[<Dig>...][<DChar>...] | #0[<DChar>...]<terminator> }

The following ﬁgure shows an example o f a block argument.

TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer 2-9

Command Syntax

Figure 2-2: Block argument example

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

#0 means that the <Block> is a n indeﬁnite length block. The <terminator> ends the block. You should not use indeﬁnite length blocks with RS-232, because there is no way to include a <terminator> character as a <DChar> character.

The ﬁrst occurrence of a <terminator> character signals the end of the block and any subsequent <DChar> characters will be interpreted as a syntax error. With the GPIB, the EOI line signals the last byte. With the USB, the EOM bit signals

tbyte.

the las

2-10 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer

Command Groups

This section lists the c ommands organized by functional group. The Command Descriptions section lists all commands alphabetically.

The oscilloscope GPIB, USB, and RS-232 interfaces conform to Tektronix standard codes and formats except where noted. The GPIB interface also conforms to IEEE Std 488.2–1987 except where noted. The USB interface also conforms to USB Test and Measurement Class, Subclass USB488 Speciﬁcation, except where noted.

Acquisition Commands

Acquisition commands affect the acquisition of waveforms. These commands control mode, averaging, and single-waveform acquisition.

Table 2-8: Acquisition commands

Command Description

ACQuire?

ACQuire:MODe Set or query the acquisition mode

ACQuire:NUMACq? Return the # of acquisitions obtained

ACQuire:NUMAVg Set or query the number of acquisitions for

ACQuire:STATE Start or stop the acquisition system

ACQuire:STOPAfter Set or query the acquisition control

Return acquisition parameters

average

Calibration and Diagnostic Commands

Calibration and Diagnostic commands let you initiate the oscilloscope self-calibr

Table 2-9: Calibration and Diagnostic commands

Command Description

*CAL? Perform an internal self-calibration and

CALibrate:ABOrt Stop an in-progress factory calibration

CALibrate:CONTINUE Perform the next step in the factory

CALibrate:FACtory Initialize the factory calibration sequence

CALibrate:INTERNAL Perform an internal self-calibration

CALibrate:STATUS? Return PASS or FAIL status of the last self-

TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer 2-11

ation routines and examine the results of diagnostic tests.

return result status

calibration sequence

or factory-calibration operation

Command Groups

Table 2-9: Calibration and Diagnostic commands (cont.)

Command Description

DIAg:RESUlt:FLAg?

DIAg:RESUlt:LOG?

ERRLOG:FIRST? Returns ﬁrst entry from error log

ERRLOG:NEXT? Returns next entry from error log

Counter Commands (TBS1000B/EDU models only)

Counter commands provide control over the oscilloscope counter feature.

Return diagnostic tests status

Return diagnostic test sequence results

Cursor Commands

Table 2-10: Coun

Header Description

COUNTERFreq? Returns all coun

COUNTERFreq:CH1Level Sets or queries the CH1 trigger level value

COUNTERFreq:CH1State Sets or queries the CH1 counter to be on or

COUNTERFreq

COUNTERFreq:CH2Level Sets or queries the CH2 trigger level value

COUNTERFreq:CH2State Sets or queries the CH2 counter to be on or

COUNTERFr

ter commands

:CH1Value?

eq:CH2Value?

ter frequency parameters

(TBS1000B/EDU models only)

off (TBS1000B

Returns the C (TBS1000B/EDU models only)

(TBS1000B/EDU models only)

off (TBS10

Returns th (TBS1000B/EDU models only)

/EDU)

H1 counter frequency value

00B/EDU models only)

e CH2 counter frequency value

Cursor commands provide control over the oscilloscope cursor display and readout.

Table 2-11: Cursor commands

Header Description

CURSor?

Command Set or query the cursors on or off; select

CURSor:HBArs

CURSor:HBAr

s:DELTa?

Return cursor settings

cursor type

Return horizontal bar settings

Return vertical distance between horizontal bar cursors

2-12 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer

+ 261 hidden pages

Tektronix TBS1000B/EDU, TDS2000B, TDS1000B, TBS1000, TDS2000C Programmer's Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Preface

Related Documents

Conventions

Getting Started

Getting Started

Syntax and Commands

Command Syntax

Command Syntax

Command and Query Structure

Command Entry

Constructed Mnemonics

Argument Types

Command Groups

Acquisition Commands

Calibration and Diagnostic Commands

Counter Commands (TBS1000B/EDU models only)

Cursor Commands