TDS200, TDS1000/TDS2000, TDS1000B/TDS2000B, And TPS2000 Series Digital Oscilloscopes Programmer Manual Tektronix TDS
Tektronix_TDS_Programmer_Manual
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 346
| Download | |
| Open PDF In Browser | View PDF |
Programmer Manual
TDS200, TDS1000/TDS2000,
TDS1000B/TDS2000B, and
TPS2000 Series Digital Oscilloscopes
071-1075-04
This document supports:
S TPS2000 Series instruments, any version.
S TDS1000B and TDS2000B Series instruments,
any version.
S TDS2CM or TDS2CMA, any version, when
used in TDS1000 or TDS2000 Series instruments,
any version.
S TDS2MEM any version, when used in most
TDS1000 or TDS2000 Series instruments (except
TDS1001 and TDS2004 models), any version.
S TDS2CM, TDS2CMA, or TDS2MM any
version, when used in a TDS224 instrument, any
version.
S TDS2CM or TDS2CMA version CMV:v1.04
and above, or TDS2MM any version, when used
in TDS210 and TDS220 instruments with
FV:v1.09 and above.
www.tektronix.com
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 supercedes that in all previously
published material. Specifications 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.
14200 SW Karl Braun Drive
P.O. Box 500
Beaverton, OR 97077
USA
For product information, sales, service, and technical support:
H
H
In North America, call 1-800-833-9200.
Worldwide, visit www.tektronix.com to find contacts in your area.
Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vii
vii
xi
Getting Started
Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1-- 1
Syntax and Commands
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 1
Command and Query Structure . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 2
Command Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 6
Constructed Mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 9
Argument Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 11
Command Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Acquisition Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Calibration and Diagnostic Commands . . . . . . . . . . . . . . . . . . .
Cursor Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Display Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
File System Commands (TDS2MEM Module, TDS1000B,
TDS2000B, and TPS2000 Only) . . . . . . . . . . . . . . . . . . . .
Hard Copy Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Horizontal Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Math Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Measurement Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Miscellaneous Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PictBridge Commands (TDS1000B and TDS2000B Only) . . .
Power and Battery-Related Commands (TPS2000 Only) . . . . .
Power Measurement (TPS2000 with TPS2PWR1 Power
Analysis Application Key Installed Only) . . . . . . . . . . . . .
RS-232 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Save and Recall Commands . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status and Error Commands . . . . . . . . . . . . . . . . . . . . . . . . . . .
Trigger Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Vertical Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Waveform Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Waveform Data Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2-- 15
2-- 15
2-- 16
2-- 17
2-- 18
2-- 19
2-- 20
2-- 21
2-- 22
2-- 23
2-- 25
2-- 27
2-- 28
2-- 28
2-- 32
2-- 32
2-- 33
2-- 34
2-- 36
2-- 37
2-- 40
i
Table of Contents
Waveform Data Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Waveform Data Locations and Memory Allocation . . . . . . . . .
Waveform Preamble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scaling Waveform Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Transferring Waveform Data . . . . . . . . . . . . . . . . . . . . . . . . . . .
2-- 42
2-- 42
2-- 43
2-- 43
2-- 43
Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 45
Status and Events
Status and Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Enable Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Enable Registers and the *PSC Command . . . . . . . . .
Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Output Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Event Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Event Handling Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Synchronization Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the *WAI Command . . . . . . . . . . . . . . . . . . . . . . . . .
Using the BUSY Query . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the *OPC Set Command . . . . . . . . . . . . . . . . . . . . . .
Using the *OPC? Query . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-- 1
3-- 1
3-- 1
3-- 4
3-- 6
3-- 6
3-- 6
3-- 7
3-- 8
3-- 10
3-- 11
3-- 13
3-- 14
3-- 16
3-- 17
Programming Examples
Programming Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4-- 1
Appendices
Appendix A: ASCII Code Chart . . . . . . . . . . . . . . . . . . . . . . .
A-- 1
Appendix B: Factory Setup . . . . . . . . . . . . . . . . . . . . . . . . . . .
TDS1000B and TDS2000B Series Oscilloscopes . . . . . . . . . . .
TPS2000 Series Oscilloscopes . . . . . . . . . . . . . . . . . . . . . . . . .
TDS1000 and TDS2000 Series Oscilloscopes . . . . . . . . . . . . .
TDS210 and TDS220 Oscilloscopes . . . . . . . . . . . . . . . . . . . . .
TDS224 Oscilloscopes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
B-- 1
B-- 1
B-- 3
B-- 5
B-- 6
B-- 8
Glossary and Index
ii
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Table of Contents
List of Figures
Figure 2-- 1: Command message elements . . . . . . . . . . . . . . .
2-- 4
Figure 2-- 2: Block Argument example . . . . . . . . . . . . . . . . . . 2-- 14
Figure 3-- 1: The Standard Event Status Register (SESR) . .
3-- 2
Figure 3-- 2: The Status Byte Register (SBR) . . . . . . . . . . . . .
3-- 3
Figure 3-- 3: The Device Event Status Enable Register
(DESER) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-- 5
Figure 3-- 4: The Event Status Enable Register (ESER) . . . .
3-- 5
Figure 3-- 5: The Service Request Enable Register (SRER) .
3-- 5
Figure 3-- 6: Status and event handling process . . . . . . . . . . .
3-- 9
Figure 3-- 7: Command processing without using
synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-- 11
Figure 3-- 8: Processing sequence with synchronization . . . . 3-- 11
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
iii
Table of Contents
List of Tables
Table 1-- 1: Communications ports and functions . . . . . . . .
1-- 1
Table 1-- 2: Oscilloscope, extension module, and
adapter compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1-- 2
Table 2-- 1: Oscilloscope communication protocol . . . . . . . .
2-- 1
Table 2-- 2: BNF notation . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2-- 2
Table 2-- 3: Command message elements . . . . . . . . . . . . . . . .
2-- 3
Table 2-- 4: Comparison of Header Off and Header
On responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2-- 5
Table 2-- 5: Types of numeric arguments . . . . . . . . . . . . . . . . 2-- 11
Table 2-- 6: Oscilloscope handling of incorrect
numeric arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 12
Table 2-- 7: Parts of a block argument . . . . . . . . . . . . . . . . . . 2-- 13
Table 2-- 8: Acquisition commands . . . . . . . . . . . . . . . . . . . . . 2-- 15
Table 2-- 9: Calibration and Diagnostic commands . . . . . . . 2-- 16
Table 2-- 10: Cursor commands . . . . . . . . . . . . . . . . . . . . . . . 2-- 17
Table 2-- 11: Display commands . . . . . . . . . . . . . . . . . . . . . . . 2-- 18
Table 2-- 12: File System commands . . . . . . . . . . . . . . . . . . . 2-- 19
Table 2-- 13: Hard Copy commands . . . . . . . . . . . . . . . . . . . . 2-- 20
Table 2-- 14: Horizontal commands . . . . . . . . . . . . . . . . . . . . 2-- 21
Table 2-- 15: Math commands . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 22
Table 2-- 16: Measurement commands . . . . . . . . . . . . . . . . . . 2-- 24
Table 2-- 17: Miscellaneous commands . . . . . . . . . . . . . . . . . 2-- 25
Table 2-- 18: PictBridge commands (TDS1000B
and TDS2000B only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 27
Table 2-- 19: Power and Battery-Related commands
(TPS2000 only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 28
Table 2-- 20: Power Measurement commands
(TPS2000 with TPS2PWR1 only) . . . . . . . . . . . . . . . . . . 2-- 29
Table 2-- 21: RS-232 commands . . . . . . . . . . . . . . . . . . . . . . . 2-- 32
iv
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Table of Contents
Table 2-- 22: Save and Recall commands . . . . . . . . . . . . . . . . 2-- 33
Table 2-- 23: Status and Error commands . . . . . . . . . . . . . . . 2-- 33
Table 2-- 24: Trigger commands . . . . . . . . . . . . . . . . . . . . . . . 2-- 35
Table 2-- 25: Vertical commands . . . . . . . . . . . . . . . . . . . . . . . 2-- 36
Table 2-- 26: Waveform commands . . . . . . . . . . . . . . . . . . . . 2-- 38
Table 2-- 27: Binary data ranges . . . . . . . . . . . . . . . . . . . . . . . 2-- 41
Table 2-- 28: Vertical position ranges using a 1X probe . . . . 2-- 68
Table 2-- 29: DATa and WFMPre parameter settings . . . . . 2-- 88
Table 2-- 30: Commands that generate an Operation
Complete message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-- 170
Table 2-- 31: Additional WFMPre commands . . . . . . . . . . . . 2-- 259
Table 3-- 1: SESR bit functions . . . . . . . . . . . . . . . . . . . . . . . .
3-- 2
Table 3-- 2: SBR bit functions . . . . . . . . . . . . . . . . . . . . . . . . .
3-- 4
Table 3-- 3: No event messages . . . . . . . . . . . . . . . . . . . . . . . . 3-- 17
Table 3-- 4: Command error messages – CME bit 5 . . . . . . . 3-- 18
Table 3-- 5: Execution error messages – EXE bit 4 . . . . . . . . 3-- 18
Table 3-- 6: Device error messages – DDE bit 3 . . . . . . . . . . 3-- 22
Table 3-- 7: System event messages . . . . . . . . . . . . . . . . . . . . . 3-- 22
Table 3-- 8: Execution warning messages – EXE Bit 4 . . . . . 3-- 23
Table 3-- 9: Internal warning messages . . . . . . . . . . . . . . . . . 3-- 24
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
v
Table of Contents
vi
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Preface
This programmer manual provides information on how to remotely
operate your TDS200, TDS1000/TDS2000, TDS1000B/TDS2000B,
or TPS2000 series oscilloscope. You can use communication ports
and protocols, such as for the RS-232, the General Purpose Interface
Bus (GPIB), or Universal Serial Bus (USB) standards, to remotely
control and operate your oscilloscope.
Related Documents
Each series of oscilloscopes has a different set of documentation.
TPS2000 Series Manuals
For general operation, refer to the TPS2000 Series Digital Storage
Oscilloscope User Manual, a standard accessory.
Language
TPS2000 series user manual part number
English
071-1441-XX
French
071-1442-XX
Italian
071-1443-XX
German
071-1444-XX
Spanish
071-1445-XX
Japanese
071-1446-XX
Portuguese
071-1447-XX
Simplified Chinese
071-1448-XX
Traditional Chinese 071-1449-XX
Korean
071-1450-XX
Russian
071-1451-XX
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
vii
Preface
For information on the TPS2PWR1 Power Analysis Application,
refer to the TPS2PWR1 Power Analysis Application User Manual, an
optional accessory available in eleven languages.
Language
TDS2PWR1 user manual part number
English
071-1452-XX
French
071-1453-XX
Italian
071-1454-XX
German
071-1455-XX
Spanish
071-1456-XX
Japanese
071-1457-XX
Portuguese
071-1458-XX
Simplified Chinese
071-1459-XX
Traditional Chinese 071-1460-XX
Korean
071-1461-XX
Russian
071-1462-XX
TDS1000B and TDS2000B Series Manuals
For general operation, refer to the TDS1000B and TDS2000B Series
Digital Storage Oscilloscope User Manual, a standard accessory.
viii
Language
TDS1000B/TDS2000B user manual part number
English
071-1817-XX
French
071-1818-XX
Italian
071-1819-XX
German
071-1820-XX
Spanish
071-1821-XX
Japanese
071-1822-XX
Portuguese
071-1823-XX
Simplified Chinese
071-1824-XX
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Preface
Traditional Chinese 071-1825-XX
Korean
071-1826-XX
Russian
071-1827-XX
TDS1000 and TDS2000 Series Manuals
For general operation, and information on the TDS2CMA Communications module, refer to the TDS1000 and TDS2000 Series Digital
Storage Oscilloscope User Manual, a standard accessory.
Language
TDS1000/TDS2000 user manual part number
English
071-1064-XX
French
071-1065-XX
Italian
071-1066-XX
German
071-1067-XX
Spanish
071-1068-XX
Japanese
071-1069-XX
Portuguese
071-1070-XX
Simplified Chinese
071-1071-XX
Traditional Chinese 071-1072-XX
Korean
071-1073-XX
Russian
071-1074-XX
For information on the TDS2MEM Storage Memory and Communications module, refer to the TDS2MEM Storage Memory and
Communications Module User Manual (071-- 1262-- XX), an optional
accessory that includes all eleven languages.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
ix
Preface
TDS200 Series Manuals
For general operation, refer to the TDS200 Series Digital Real-Time
Oscilloscope User Manual, a standard accessory.
Language
TDS200 series user manual part number
English
071-0398-XX
French
071-0400-XX
Italian
071-0401-XX
German
071-0402-XX
Spanish
071-0399-XX
Japanese
071-0405-XX
Portuguese
071-0403-XX
Simplified Chinese
071-0406-XX
Traditional Chinese 071-0407-XX
Korean
071-0408-XX
Russian
071-0404-XX
For information on the TDS2CMA Communications module, or
TDS2MM Math Measurements module, refer to the TDS200 Series
Extension Modules Instructions Manual (071-0409-XX), a standard
accessory for extension modules in English only.
x
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Preface
Service Manuals (English Only)
For information on how to service your oscilloscope, refer to the
appropriate manual from the following optional accessories:
H TPS2000 Series Digital Storage Oscilloscopes Service Manual
(071-1465-XX)
H TDS1000B and TDS2000B Series Digital Storage Oscilloscopes
Service Manual (071-1828-XX)
H TDS1000 and TDS2000 Series Digital Storage Oscilloscopes
Service Manual (071-1076-XX)
H TDS200 Series Digital Real-Time Oscilloscopes Service Manual
(071-0492-XX)
Conventions
Refer to the Command Syntax section of the Syntax and Commands
chapter (page 2-- 1) for information about command conventions.
This manual uses the following convention:
H References to the TDS2CMA Communications Extension
Module include the TDS2CM and TDS2CMAX modules.
H Command descriptions list specific oscilloscopes series (and
module) when commands are valid for only those products
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
xi
Preface
xii
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Getting Started
Getting Started
This manual contains information on how to remotely control and
operate your oscilloscope through communications protocol and
commands.
NOTE. For TDS1000B and TDS2000B 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 TDS1000B and TDS2000B 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.
Table 1- 1: Communications ports and functions
Series
Port location
Port function
TDS200
TDS2CM, TDS2CMA, or TDS2CMAX RS-232, Centronics, GPIB
Communications, TDS2MM Math
TDS1000/
TDS2000*
TDS2CMA or TDS2CMAX
RS-232, Centronics, GPIB
TDS2MEM Storage Memory and
Communications
RS-232, Centronics, CompactFlash
TDS1000B// Back of oscilloscope
p
TDS
TDS2000B{
B{
USB Device
TPS2000
RS-232, Centronics
Back of oscilloscope
GPIB with a TEK-USB-488 adapter
*
TDS1001 and TDS2004 are not compatible with the TDS2MEM module.
{
Install the PC Communications software from the CD that came with the
oscilloscope first; refer to your TDS1000B and TDS2000B user manual for
information on installing the software. After the software is installed, then
connect the oscilloscope to a PC.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
1- 1
Getting Started
Refer to your oscilloscope user manual (Tektronix part numbers
listed on page v) for information on how to install, test, and
configure your oscilloscope and module.
NOTE. The firmware for the TDS1000B, TDS2000B, and TPS2000
series oscilloscopes includes communications, math, and storage
memory functions.
Table 1- 2: Oscilloscope, extension module, and adapter compatibility
Series
TDS2CM,TDS2CMA
or TDS2CMAX
TDS2MM
TDS2MEM
TEK-USB-488
TDS200
Yes
Yes
No
No
TDS1000 or
TDS2000
Yes
No
Yes*
No
TDS1000B or
TDS2000B
No
No
No
Yes
TPS2000{
No
No
No
No
*
TDS1001 and TDS2004 models are not compatible with the TDS2MEM module.
{
RS-232 included in the oscilloscope firmware.
NOTE. If you use GPIB with the TDS1000B or TDS2000B series, you
can set a unique GPIB address for the oscilloscope through the
UTILITY " Options " GPIB Setup option.
1- 2
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 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.
Table 2- 1: Oscilloscope communication protocol
Model or option
GPIB
RS-232
USB
TDS2CM, TDS2CMA, TDS2CMAX
Yes
Yes
No
TDS2MM
Yes
Yes
No
TDS2MEM
No
Yes
No
TDS1000 or TDS2000
Yes*
Yes*{
No
TDS1000B or TDS2000B
Yes}
No
Yes
TPS2000
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.
You transmit commands to the oscilloscope using the enhanced
American Standard Code for Information Interchange (ASCII)
character encoding. Appendix A contains a chart of the ASCII
character set.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 1
Command Syntax
The Backus Naur Form (BNF) notation is used in this manual to
describe commands and queries. Table 2-- 2 lists the BNF notation.
Table 2- 2: BNF notation
Symbol
Meaning
<>
Defined element
::=
Is defined as
|
Exclusive OR
{}
Group; one element is required
[]
Optional; can be omitted
...
Previous element(s) may be
repeated
()
Comment
Command and Query Structure
Commands consist of set commands and query commands (usually
simply called commands and queries). Commands change oscilloscope settings or perform a specific 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.
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 five different element types.
2- 2
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Syntax
Table 2-- 3 lists and describes the five element types.
Table 2- 3: Command message elements
Symbol
Meaning
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.
A quantity, quality, restriction, or limit associated with
the header. Not all commands have an argument,
while other commands have multiple arguments.
Arguments are separated from the header by a
. Arguments are separated from each
other by a .
A single comma between arguments of multiple-argument commands. It may optionally 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.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 3
Command Syntax
Figure 2-- 1 shows the five command message elements.
Header
Comma
SAVe:WAVEform CH1,REFA
Mnemonics
Arguments
Space
Figure 2- 1: Command message elements
Commands
Commands cause the oscilloscope to perform a specific function or
change one of its settings. Commands have the structure:
[:][[]...]
A command header is made up of one or more mnemonics arranged
in a hierarchical or tree structure. The first mnemonic is the base or
root of the tree and each subsequent mnemonic is a level or branch
off of 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.
Queries
Queries cause the oscilloscope to return information about its status
or settings. Queries have the structure:
[:]?
[:]?[[]...]
You can specify a query command at any level within the command
tree unless otherwise noted. These branch queries return information
about all the mnemonics below the specified branch or level.
2- 4
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Syntax
For example, MEASUrement:MEAS:UNIts? returns the measurement units, while MEASUrement:MEAS:TYPe? returns the
measurement type selected for the measurement, and MEASUrement:MEAS? returns all the measurement parameters for the
specified measurement.
Headers in Query Responses
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.
Table 2-- 4 shows the difference in responses.
Table 2- 4: Comparison of Header Off and Header On responses
Query
Header Off response
Header On response
ACQuire:NUMAVg?
64
:ACQUIRE:NUMAVG 64
CHx1:COUPling?
DC
:CH1:COUPLING DC
Clearing the Output Queue
To clear the output queue and reset the oscilloscope to accept a new
command 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
CHECK_CLEAR_STATUS. The USB interface responds to
CHECK_CLEAR_STATUS with STATUS_SUCCESS when it is
finished clearing the output queue.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 5
Command Syntax
Command Entry
Follow these general rules when entering commands:
H Enter commands in upper or lower case.
H 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).
H The oscilloscope ignores commands that consists of just a
combination of white space characters and line feeds.
Abbreviating Commands
You can abbreviate many oscilloscope commands. These abbreviations are shown in capital letters in the command listing in the
Command Groups section on page 2-- 15 and Command Descriptions
section on page 2-- 45. 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 also control whether the returned
headers are abbreviated or are full-length using the VERBose
command.
Concatenating Commands
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:
H Completely different headers must be separated by both a
semicolon and by the beginning colon on all commands but the
first. For example, the commands TRIGger:MODe NORMal and
ACQuire:NUMAVg 16 can be concatenated into a single
command:
TRIGger:MODe NORMal;:ACQuire:NUMAVg 16
2- 6
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Syntax
H 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, the commands
ACQuire:MODe AVErage and ACQuire:NUMAVg 16 could be
concatenated into a single command:
ACQuire:MODe AVErage; NUMAVg 16
The longer version works equally well:
ACQuire:MODe AVErage;:ACQuire:NUMAVg 16
H 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.
H 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:
CH1:COUPling?;BANdwidth?
returns :CH1:COUPLING DC;:CH1:BANDWIDTH ON if header is on,
or DC;ON if header is off.
H You can concatenate set commands and queries in the same
message. For example:
ACQuire:MODe AVErage;NUMAVg?;STATE?
is a valid message that sets the acquisition mode to average,
queries the number of acquisitions for averaging, and then
queries the acquisition state. The oscilloscope executes
concatenated commands and queries in the order it receives
them.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 7
Command Syntax
H 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:
H CH1:COUPling DC;ACQuire:NUMAVg 16
(missing colon before ACQuire)
H CH1:COUPling DC;:BANDwidth ON
(invalid colon before BANDwidth)
H CH1:COUPling DC;:*TRG
(invalid colon before a star (*) command)
H HORizontal:MAIn:POSition 0;MAIn:SCAle 1E–13
(levels of mnemonics are different—either remove the second
occurrence of MAIn:, or put :HORizontal: in front of
MAIN:SCAle)
Message Terminators
This manual uses the term (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 Specification (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 Specification section 3.3.1), and by terminating
messages with a LF. White space is allowed before the terminator;
for example, CR LF is acceptable.
2- 8
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Syntax
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).
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 first 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
choices is abbreviated CH.
Channel Mnemonics
Commands specify the channel to use as a mnemonic in the header.
Symbol
Meaning
CH
2-channel models: A channel specifier; is 1 or 2.
4-channel models: A channel specifier; is 1, 2,
3, or 4.
Reference Waveform Mnemonics
Commands can specify the reference waveform to use as a
mnemonic in the header.
Symbol
Meaning
REF
2-channel models: A reference waveform specifier;
is A or B.
4-channel models: A reference waveform specifier;
is A, B, C, or D.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 9
Command Syntax
Waveform Mnemonics
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
Can be CH, MATH, or REF
Cursor Position Mnemonic
When the oscilloscope displays cursors, commands may specify
which cursor of the pair to use.
Symbol
Meaning
POSITION
A cursor selector; is 1 or 2.
Measurement Specifier Mnemonics
Commands can specify which measurement to set or query as a
mnemonic in the header. The oscilloscope can display up to four
(TDS200) or five (TDS1000, TDS2000, TDS1000B, TDS2000B, and
TPS2000) automated measurements.
2- 10
Symbol
Meaning
MEAS
A measurement specifier; is 1--4 (TDS200)
or 1--5 (TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000).
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Syntax
Argument Types
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.
Numeric Arguments
Many oscilloscope commands require numeric arguments. Table 2-- 5
lists the three types of numeric argument.
Table 2- 5: Types of numeric arguments
Symbol
Meaning
Signed integer value
Floating point value without an exponent
Floating point value with an exponent
The syntax shown is the data format that the oscilloscope returns in
response to a query. This format is also the preferred format when
sending a command to the oscilloscope.
When you enter an incorrect numeric argument, the oscilloscope
automatically forces the numeric argument to a correct value.
Table 2-- 6 lists how the oscilloscope handles incorrect numeric
arguments.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 11
Command Syntax
Table 2- 6: Oscilloscope handling of incorrect numeric arguments
Argument value
Oscilloscope response
Numeric argument is
less than lowest correct
value for that command
Sets the specified command to the lowest correct
value and executes the command
Numeric argument is
greater than the highest
correct value for that
command
Sets the specified command to the highest correct
value and executes the command
Numeric value is beRounds the entered value to the nearest correct
tween two correct values value and executes the command
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
Quoted string of ASCII text
Follow these rules when you use quoted strings:
1. A quoted string can include any character defined in the 7-bit
ASCII character set. Refer to Appendix A.
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 as long as you
follow the previous rule:
”this is an ’acceptable’ string”
2- 12
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Syntax
4. You can include a quote character within a string simply by
repeating the quote. For example,
”here is a ”” 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 message before the closing delimiter.
7. A carriage return or line feed embedded in a quoted string does
not terminate the string, but is treated as just another character in
the string.
8. The maximum length of a quoted string returned from a query is
1000 characters.
Here are some examples of invalid strings:
”Invalid string argument’
(quotes are not of the same type)
”test”
(termination character is embedded in the string)
Block Arguments
Several oscilloscope commands use a block argument form.
Table 2-- 7 lists and describes each part of a block argument.
Table 2- 7: Parts of a block argument
Symbol
Meaning
A non-zero digit character, in the range 1–9
Specifies the number of elements that follow
A digit character, in the range 0–9
A character with the hex equivalent of 00 through FF hexadecimal
(0 through 255 decimal)
A block of data bytes, defined as:
::=
{ #[...][...]
| #0[...] }
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 13
Command Syntax
Figure 2-- 2 shows an example of a block argument.
Block argument
*DDT #217ACQuire:STATE RUN
Block header
Specifies data length
Specifies number of
length digits that follow
Figure 2- 2: Block Argument example
specifies the number of elements that follow. Taken
together, the elements form a decimal integer that specifies
how many elements follow.
#0 means that the is an indefinite length block. The
ends the block. You should not use indefinite length
blocks with RS-232, because there is no way to include a character as a character.
The first occurrence of a character signals the end of
the block and any subsequent 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 the last byte.
2- 14
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
This section lists the commands organized by functional group. The
Command Descriptions section, starting on page 2-- 45, 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 Specification, except where noted.
Acquisition Commands
Acquisition commands affect the acquisition of waveforms. These
commands control mode, averaging, and single-waveform
acquisition. Table 2-- 8 lists and describes Acquisition commands.
Table 2- 8: Acquisition commands
Header
Description
ACQuire?
Return acquisition parameters
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 average
ACQuire:STATE
Start or stop the acquisition system
ACQuire:STOPAfter
Set or query the acquisition control
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 15
Command Groups
Calibration and Diagnostic Commands
Calibration and Diagnostic commands let you initiate the oscilloscope self-calibration routines and examine the results of diagnostic
tests. Table 2-- 9 lists and describes Calibration and Diagnostic
commands.
Table 2- 9: Calibration and Diagnostic commands
2- 16
Header
Description
*CAL?
Perform an internal self-calibration and
return result status
CALibrate:ABOrt
Stop an in-progress factory calibration
CALibrate:CONTINUE
Perform the next step in the factory
calibration sequence
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- or factory-calibration operation
DIAg:RESUlt:FLAG?
Return diagnostic tests status
DIAg:RESUlt:LOG?
Return diagnostic test sequence results
ERRLOG:FIRST?
Returns first entry from error log
ERRLOG:NEXT?
Returns next entry from error log
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Cursor Commands
Cursor commands provide control over the oscilloscope cursor
display and readout. Table 2-- 10 lists and describes Cursor commands.
Table 2- 10: Cursor commands
Header
Description
CURSor?
Return cursor settings
CURSor:FUNCtion
Set or query the cursors on or off; select
cursor type
CURSor:HBArs?
Return horizontal bar settings
CURSor:HBArs:DELTa?
Return vertical distance between
horizontal bar cursors
CURSor:HBArs:POSITION
Set or query the position of a horizontal
bar cursor
CURSor:HBArs:UNIts?
Query vertical scale units
CURSor:SELect:SOUrce
Select waveform
CURSor:VBArs?
Return vertical bar settings
CURSor:VBArs:DELTa?
Return horizontal distance between
cursors
CURSor:VBArs:HDELTa?
(TDS1000B, TDS2000B, and
TPS2000 only)
Return horizontal distance between
cursors. Same as CURSor:VBArs:DELTa?
CURSor:VBArs:HPOS?
(TDS1000B, TDS2000B, and
TPS2000 only)
Return the amplitude of the waveform at
the cursor position
CURSor:VBArs:POSITION
Set or query the position of a vertical bar
cursor
CURSor:VBArs:SLOPE?
(TPS2000 with Power Analysis
Module only)
Return the value of the on-screen dV/dt
or dI/dt measurement
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 17
Command Groups
Table 2- 10: Cursor commands (Cont.)
Header
Description
CURSor:VBArs:UNIts
Set or query the vertical cursors to time
or frequency
CURSor:VBArs:VDELTa?
(TDS1000B, TDS2000B, and
TPS2000 only)
Return the vertical distance between
cursors
Display Commands
Display commands let you change the graticule style, displayed
contrast, and alter other display attributes. Table 2-- 11 lists and
describes Display commands.
Table 2- 11: Display commands
2- 18
Header
Description
DISplay?
Return display settings
DISplay:BRIGHTness
(TPS2000 only)
Set or query the LCD display brightness
DISplay:CONTRast
Set or query the LCD display contrast
DISplay:FORMat
Set or query the YT or XY display
DISplay:INVert
(not available on the TDS200,
accepted as a legal command on
theTDS2000B and TPS2000 but
has no effect on these models)
Set or query the normal or inverted
monochrome display
DISplay:PERSistence
Set or query the accumulate time
DISplay:STYle
Set or query the waveform display style
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
File System Commands
(TDS2MEM Module, TDS1000B, TDS2000B, and TPS2000 Only)
File system commands perform file management tasks on the
CompactFlash (CF) card of TPS2000 oscilloscopes, and TDS models
with a TDS2MEM module; and on USB flash drives of TDS1000B
and TDS2000B oscilloscopes. Table 2-- 12 lists these commands.
Table 2- 12: File System commands
Header
Description
FILESystem?
Return the current working directory (CWD) and
CF card or USB flash drive free space values
FILESystem:CWD
Set or query the current CF card or USB flash
drive directory
FILESystem:DELEte
Delete specified file on the CF card or USB flash
drive
FILESystem:DIR?
Return a list of files in current CF card or USB
flash drive directory
FILESystem:FORMat
Format the CF card or USB flash drive
FILESystem:FREESpace?
Return free space on the CF card or USB flash
drive
FILESystem:MKDir
Create a new directory on the CF card or USB
flash drive
FILESystem:REName
Assign new name to specified file on the CF
card or USB flash drive
FILESystem:RMDir
Delete specified directory
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 19
Command Groups
File System Conventions
Use the following conventions when specifying file paths and file
names::
H The default folder (directory) is A:\.
H File and folder names have a maximum of 11 characters; eight
characters, followed by a period, followed by up to three
characters. This format is referred to as 8.3 naming.
H Wild card characters (*, %, ?) are not valid characters in file or
path names.
H Lists the Windows-generated short file and folder names for long
file or folder names created on PC Windows operating systems.
Hard Copy Commands
The hard copy commands let you control the format of hard copy
output, and the starting and stopping of hard copies. Table 2-- 13 lists
and describes Hard Copy commands. :
NOTE. TDS1000B and TDS2000B oscilloscopes include PictBridge
commands to provide additional control of the hard copy format.
Refer to page 2-- 27 for information on the PictBridge commands.
Table 2- 13: Hard Copy commands
2- 20
Header
Description
HARDCopy
Start or terminate hard copy
HARDCopy:BUTTON
(TDS2MEM, TDS1000B,
TDS2000B, and TPS2000 only)
Set or query the hard copy button
function
HARDCopy:FORMat
Set or query the hard copy output format
For TDS1000B, TDS2000B, and
TPS2000, set or query the PRINT button
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Table 2- 13: Hard Copy commands (Cont.)
Header
Description
HARDCopy:INKSaver
(TDS1000, TDS2000, TDS2000B,
and TPS2000 only)
Set or query the hard copy ink saver
option
HARDCopy:LAYout
Set or query the hard copy orientation
HARDCopy:PORT
Set or query the hard copy port for
output: RS232, GPIB, Centronics, or
USB
Horizontal Commands
Horizontal commands control the time bases of the oscilloscope. You
can set the position and time per division of both the main and
window time bases. You can substitute SECdiv for SCAle in all
appropriate horizontal commands. This provides program compatibility with previous Tektronix digitizing oscilloscopes. Table 2-- 14
lists and describes Horizontal commands.
Table 2- 14: Horizontal commands
Header
Description
HORizontal?
Return horizontal settings
HORizontal:DELay?
Return all settings for the window time
base
HORizontal:DELay:POSition
Position window
HORizontal:DELay:SCAle
Set or query the window time base
time/division
HORizontal:DELay:SECdiv
Same as HORizontal:DELay:SCAle
HORizontal:MAIn?
Return the main time base time/division
HORizontal:MAIn:POSition
Set or query the main time base trigger
point
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 21
Command Groups
Table 2- 14: Horizontal commands (Cont.)
Header
Description
HORizontal:MAIn:SCAle
Set or query the main time base time/division
HORizontal:MAIn:SECdiv
Same as HORizontal:MAIn:SCAle
HORizontal:POSition
Set or query the position of waveform to
display
HORizontal:RECOrdlength
Return waveform record length
HORizontal:SCAle
Same as HORizontal:MAIn:SCAle
HORizontal:SECdiv
Same as HORizontal:MAIn:SCAle
HORizontal:VIEW
Select view
Math Commands
Math commands provide math function definition. Table 2-- 15 lists
and describes Math commands.
Table 2- 15: Math commands
2- 22
Header
Description
MATH?
Query the definition for the
math waveform
MATH:DEFINE
Set or query the math waveform definition
MATH:FFT?
Return all math FFT parameters
MATH:FFT:HORizontal:POSition
(TDS200 with a TDS2MM module, TDS1000,
TDS2000, TDS1000B, TDS2000B, and
TPS2000 only)
Set or query the FFT horizontal display position
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Table 2- 15: Math commands (Cont.)
Header
Description
MATH:FFT:HORizontal:SCAle
(TDS200 with a TDS2MM module, TDS1000,
TDS2000, TDS1000B, TDS2000B, and
TPS2000 only)
Set or query the FFT horizontal zoom factor
MATH:FFT:VERtical:POSition
(TDS200 with a TDS2MM module, TDS1000,
TDS2000, TDS1000B, TDS2000B, and
TPS2000 only)
Set or query the FFT vertical
display position
MATH:FFT:VERtical:SCAle
(TDS200 with a TDS2MM module, TDS1000,
TDS2000, TDS1000B, TDS2000B, and
TPS2000 only)
Set or query the FFT vertical
zoom factor
MATH:VERtical?
Return all math vertical
waveform parameters
MATH:VERtical:POSition
(TDS1000B, TDS2000B, and TPS2000 only)
Set or query the math waveform display position
MATH:VERtical:SCAle
(TDS1000B, TDS2000B, and TPS2000 only)
Set or query the math waveform display scale
Measurement Commands
Measurement commands control the automated measurement
system. The oscilloscope can display up to four (TDS200) or five
(TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000)
automated measurements. In the commands, these measurement
readouts are named MEAS, where can be 1, 2, 3, or 4 (or 5
for TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000).
The best method for taking measurements over the computer
interface is to use the MEASUREMENT:IMMED commands and
queries. The immediate measurement has no front-panel equivalent,
and the oscilloscope never displays immediate measurements.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 23
Command Groups
Because they are computed only when they are requested, immediate
measurements slow the waveform update rate less than displayed
measurements.
Use the VALue? query to obtain measurement results of either
displayed or immediate measurements.
Several measurement commands set and query measurement
parameters. You can assign some parameters, such as waveform
sources, differently for each measurement readout.
Table 2-- 16 lists and describes Measurement commands.
Table 2- 16: Measurement commands
2- 24
Header
Description
MEASUrement?
Return all measurement parameters
MEASUrement:IMMed?
Return immediate measurement parameters
MEASUrement:IMMed:SOUrce1
Set or query the channel for immediate
measurement
MEASUrement:IMMed:SOUrce2
Set or query the channel for two-source
immediate measurements (TPS2000
with Power Analysis Module only)
MEASUrement:IMMed:TYPe
Set or query the immediate measurement to be taken
MEASUrement:IMMed:UNIts?
Return the immediate measurement
units
MEASUrement:IMMed:VALue?
Return the immediate measurement
result
MEASUrement:MEAS?
Return parameters on the periodic
measurement
MEASUrement:MEAS:SOUrce
Set or query the channel to take the
periodic measurement from
MEASUrement:MEAS:TYPe
Set or query the type of periodic measurement to be taken
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Table 2- 16: Measurement commands (Cont.)
Header
Description
MEASUrement:MEAS:UNIts?
Return the units for periodic measurement
MEASUrement:MEAS:VALue?
Return periodic measurement results
Miscellaneous Commands
Miscellaneous commands are a group of commands that do not fit
into any other category.
Several commands and queries are common to all 488.2–1987
devices on the GPIB or USB bus, and the device on the RS-232
interface. These commands and queries are defined by IEEE Std.
488.2–1987 and Tektronix Standard Codes and Formats 1989 and
begin with an asterisk (*) character. Table 2-- 17 lists and describes
Miscellaneous commands.
Table 2- 17: Miscellaneous commands
Header
Description
AUTORange?
(TDS1000B, TDS2000B, and
TPS2000 only)
Return all autorange parameters
AUTORange:SETTings
(TDS1000B, TDS2000B, and
TPS2000 only)
Set or query the which parameters
autorange can adjust
AUTORange:STATE
(TDS1000B, TDS2000B, and
TPS2000 only)
Set or query the autorange to on or off
AUTOSet
Automatic oscilloscope setup
AUTOSet: ENABLE
(TDS1000B and TDS2000B only)
Allows educators to disable or enable the
Autorange and Autoset functions.*
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 25
Command Groups
Table 2- 17: Miscellaneous commands (Cont.)
2- 26
Header
Description
AUTOSet:SIGNAL?
(TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Return the type of signal found by
autoset
AUTOSet:VIEW
(TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Set or query the Autoset view
DATE
(TDS2MEM, TDS1000B,
TDS2000B, and TPS2000 only)
Set or query the date value
*DDT
Set or query the group execute trigger
(GET)
FACtory
Reset to factory default
HDR
Same as HEADer
HEADer
Set or query the command header
ID?
Return identification information
*IDN?
Return identification information
LANGUAGE
Set or query the language for display
messages
LOCk
Lock front panel (local lockout)
*LRN?
Query device settings
REM
No action; remark only
*RST
Reset
SET?
Same as *LRN?
TIME
(TDS2MEM, TDS1000B,
TDS2000B, and TPS2000 only)
Set or query the time value
*TRG
Perform Group Execute Trigger (GET)
*TST?
Return self-test results
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Table 2- 17: Miscellaneous commands (Cont.)
Header
Description
UNLock
Unlock front panel (local lockout)
VERBose
Return full command name or minimum
spellings with query
*
AUTOSet: ENABLE can be manually set from the Service Diag
menu. To access the service diagnostics menu, refer to the
TDS1000B and TDS2000B series service manual.
PictBridge Commands (TDS1000B and TDS2000B Only)
The PictBridge commands let you control the format of the hard
copy on the PictBridge compatible printer. Table 2-- 13 lists and
describes PictBridge commands. :
NOTE. The HARDCopy:BUTTON, HARDCopy:INKSaver, and
HARDCopy:LAYOUT commands apply to the TDS1000B and
TDS2000B oscilloscopes. Refer to page 2-- 20 for more information.
Table 2- 18: PictBridge commands
Header
Description
PICTBridge:DEF
Set the next six options to default
PICTBridge:PAPERSIZE
Set or query the paper size
PICTBridge:IMAGESIZE
Set or query the image size
PICTBridge:PAPERTYPE
Set or query the paper type
PICTBridge:PRINTQUAL
Set or query the print quality
PICTBridge:DATEPRINT
Set or query the date print
PICTBridge:IDPRINT
Set or query the ID print
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 27
Command Groups
Power and Battery-Related Commands (TPS2000 Only)
Power and Battery-Related commands provide battery management
functions to a TPS2000 oscilloscope.
Table 2-- 19 lists and describes the Power and Battery-Related
commands.
Table 2- 19: Power and Battery-Related commands (TPS2000 only)
Header
Description
POWer?
Return all power parameters
POWer:AC:PRESENt?
Return whether the oscilloscope is being
powered by battery or AC
POWer:BATTERY:GASgauge?
Return the charge remaining in battery x
POWer:BATTERY:STATUS?
Return status for battery x
POWer:BATTERIES:TIME?
Return the time remaining in both
batteries
POWer:BUTTONLIGHT
Turn the lighted front-panel buttons on
and off
Power Measurement (TPS2000 with TPS2PWR1 Power
Analysis Application Key Installed Only)
Power Measurement commands provide power measurements to a
TPS2000 oscilloscope with the TPS2PWR1 Power Analysis
application software key installed.
Table 2-- 20 lists and describes Power Measurement commands.
2- 28
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Table 2- 20: Power Measurement commands (TPS2000 with TPS2PWR1
only)
Header
Description
HARmonics?
Return all harmonic parameters
HARmonics:ENABle
Set or query the harmonics menu on and off
HARmonics:FREquency?
Return the frequency of the selected harmonic
HARmonics:HRMS?
Return the frequency of the selected harmonic
HARmonics:PERCent?
Return the amplitude of the selected harmonic as a
percent of the fundamental
HARmonics:PHAse?
Return the phase of the selected harmonic, in
degrees, relative to the fundamental
HARmonics:RMS?
Return the amplitude of the harmonics source in
RMS units. This may be Vrms or Irms depending on
the type of source waveform
HARmonics:SAVe
Set the file name and path to save harmonic data
HARmonics:SELect
Set or query the selected harmonic
HARmonics:SETUp
Set or query the operating mode for harmonics
measurements commands
HARmonics:SHOW
Set or query the specified harmonics
HARmonics:SOUrce
Set or query the source in the harmonics menu
HARmonics:THDF?
Query the total harmonic distortion of the waveform
as percent of fundamental
HARmonics:THDR?
Query the total harmonic distortion of the waveform
as % of input Vrms
POWerANALYSIS:SOUrces
Sets or query the power analysis sources
SWLoss?
Return switching loss measurement settings
SWLoss:ACQuire
Set or query the type of acquisition to use for
Switching Loss commands
SWLoss:AVErage:CONDUCTION?
Return the power loss of the device under test when
the device is conducting
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 29
Command Groups
Table 2- 20: Power Measurement commands (TPS2000 with TPS2PWR1
only) (Cont.)
Header
Description
SWLoss:AVErage:N?
Return the number of measurements used to
calculate the averaged value for switching loss
commands
SWLoss:AVErage:TOTAL?
Return the sum of the turn-on, turn-off, and
conduction switching losses for an Average
measurement
SWLoss:AVErage:TURNOFF?
Return the power loss of the device under test when
the device is transitioning from on to off
SWLoss:AVErage:TURNON?
Return the power loss of the device under test when
the device is transitioning from off to on
SWLoss:ENABLe
Set or query switching loss measurements on or off
SWLoss:LEVELS
Return oscilloscope Switching Loss Measurement
settings to factory default (SWLoss:TONSTART,
SWLoss:TONEND, SWLoss:TOFFSTART,
SWLoss:TOFFEND only)
SWLoss:LOG:CONDUCTION?
Return the Conduction Loss for a switching loss
measurement
SWLoss:LOG:INDEX
Set or query which measurement to return for a
SWLoss:LOG command
SWLoss:LOG:TOTAL?
Return the Total Loss for a switching loss measurement
SWLoss:LOG:TURNOFF?
Return the Turn-Off Loss for a switching loss
measurement
SWLoss:LOG:TURNON?
Return the Turn-On Loss for a switching loss
measurement
SWLoss:SAVE
Saves the Switching Loss Measurements
SWLoss:SOURCES
Set or query the input sources for Switching Loss
Measurements
SWLoss:STOPAfter
Set or query the number of acquisitions used for
Switching Loss Measurements
2- 30
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Table 2- 20: Power Measurement commands (TPS2000 with TPS2PWR1
only) (Cont.)
Header
Description
SWLoss:TOFFEND
Set or query a level on the first falling edge of the
current waveform that occurs after the turn-off starts
SWLoss:TONEND
Set or query a level on the first rising edge of the
voltage waveform that occurs after the first falling
edge
SWLoss:TOFFSTART
Set or query a level on the falling edge of the voltage
waveform that defines where the beginning of the
switching loss measurement ends
SWLoss:TONSTART
Set or query a level on the falling edge of the voltage
waveform that defines where the switching loss
measurement begins
SWLoss:UNIts
Set or query the units for Switching Loss Measurement
SWLoss:VALue:CONDUCTION?
Return the power loss of the device under test when
the device is conducting in its on state
SWLoss:VALue:TOTAL?
Return the sum of the turn-on, turn-off, and
conduction switching losses
SWLoss:VALue:TURNOFF?
Return the power loss of the device under test when
the device is transitioning between its on and off
state
SWLoss:VALue:TURNON?
Return the power loss of the device under test when
the device is transitioning between its off and on
state display
SWLoss:VSAT
Set or query the saturation voltage for the device
under test
WAVEFORMANALYSIS:SOUrce
Set or query the source for Waveform Analysis
commands
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 31
Command Groups
RS-232 Commands
(TDS200, TDS1000, TDS2000, and TPS2000 Only)
RS-232 commands allow you to set or query the parameters that
control the RS-232 port. Table 2-- 21 lists and describes RS-232
commands.
Table 2- 21: RS-232 commands
Header
Description
RS232?
Query RS232 parameters
RS232:BAUd
Set or query the baud rate
RS232:HARDFlagging
Set or query the hard flagging
RS232:PARity
Set or query the parity type
RS232:SOFTFlagging
Set or query the soft flagging
RS232:TRANsmit:TERMinator
Set or query the end-of-line terminator
Refer to Table 2-- 1 on page 2-- 1 for a list of products that are
compatible with RS-232.
Save and Recall Commands
Save and Recall commands allow you to store and retrieve internal
waveforms and settings. When you “save a setting,” you save most
of the settings of the oscilloscope. When you then “recall a setting,”
the oscilloscope restores itself to the state it was in when you saved
that setting.
To display a saved waveform, use the SELect: command
described on page 2-- 197. Table 2-- 22 lists and describes Save and
Recall commands.
2- 32
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Table 2- 22: Save and Recall commands
Header
Description
*RCL
Recall setting
RECAll:SETUp
Recall saved oscilloscope setting
RECAll:WAVEform
Recall saved waveform
*SAV
Save oscilloscope setting
SAVe:IMAge
(TDS2MEM, TDS1000B,
TDS2000B, and TPS2000 only)
Save screen image to file
SAVe:IMAge:FILEFormat
(TDS2MEM, TDS1000B,
TDS2000B, and TPS2000 only)
Set screen image file format
SAVe:SETUp
Save oscilloscope setting
SAVe:WAVEform
Save waveform
Status and Error Commands
Status and error commands let you determine the status of the
oscilloscope and control events.
Several commands and queries are common to all devices on the
GPIB or USB bus. These commands and queries are defined by
IEEE Std. 488.2–1987 and Tek Standard Codes and Formats 1989,
and begin with an asterisk (*) character. Table 2-- 23 lists and
describes Status and Error commands.
Table 2- 23: Status and Error commands
Header
Description
ALLEv?
Return all events
BUSY?
Return oscilloscope busy status
*CLS
Clear status
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 33
Command Groups
Table 2- 23: Status and Error commands (Cont.)
Header
Description
DESE
Set or query the device event status enable
*ESE
Set or query the standard event status enable
*ESR?
Return standard event status register; this is the usual
way to determine whether a set command executed
without error
EVENT?
Return event code
EVMsg?
Return event message
EVQty?
Return number of events in queue
*OPC
Set or query the operation complete
*PSC
Set or query the power-on status clear
*SRE
Set or query the service request enable
*STB?
Read status byte
*WAI
Wait to continue
Trigger Commands
Trigger commands control all aspects of oscilloscope triggering.
The three types of triggers are edge, pulse width, and video. Edge
triggering is the default type. Edge triggering lets you acquire a
waveform when the signal passes through a voltage level of your
choosing. Pulse width triggering lets you trigger on normal or
aberrant pulses. Video triggering adds the capability of triggering on
video fields and lines. Table 2-- 24 lists and describes Trigger
commands.
2- 34
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Table 2- 24: Trigger commands
Header
Description
TRIGger
Force trigger event
TRIGger:MAIn
Set main trigger level to 50%; Query
returns main trigger settings
TRIGger:MAIn:EDGE?
Return edge trigger settings
TRIGger:MAIn:EDGE:COUPling
Set or query the edge trigger coupling
TRIGger:MAIn:EDGE:SLOpe
Set or query the edge trigger slope
TRIGger:MAIn:EDGE:SOUrce
Set or query the edge trigger source
TRIGger:MAIn:FREQuency?
(TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Return trigger frequency value
TRIGger:MAIn:HOLDOff?
Return trigger holdoff value
TRIGger:MAIn:HOLDOff:VALue
Set or query the trigger holdoff value
TRIGger:MAIn:LEVel
Set or query the trigger level
TRIGger:MAIn:MODe
Set or query the trigger mode
TRIGger:MAIn:PULse?
(TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Return pulse trigger settings
TRIGger:MAIn:PULse:SOUrce
(TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Set or query the pulse trigger source
TRIGger:MAIn:PULse:WIDth?
(TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Return pulse trigger width parameters
TRIGger:MAIn:PULse:WIDth:POLarity
(TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Set or query the pulse trigger polarity
TRIGger:MAIn:PULse:WIDth:WHEN
Set or query the pulse trigger when
TRIGger:MAIn:PULse:WIDth:WIDth
Set or query the pulse trigger width
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 35
Command Groups
Table 2- 24: Trigger commands (Cont.)
Header
Description
TRIGger:MAIn:TYPe
Set or query the main trigger type
TRIGger:MAIn:VIDeo?
Query video trigger parameters
TRIGger:MAIn:VIDeo:LINE
(TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Set or query the video trigger line
TRIGger:MAIn:VIDeo:POLarity
Set or query the video trigger polarity
TRIGger:MAIn:VIDeo:SOUrce
Set or query the video trigger source
TRIGger:MAIn:VIDeo:STANdard
(TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Set or query the video trigger
standard
TRIGger:MAIn:VIDeo:SYNC
Set or query the video trigger sync
TRIGger:STATE?
Return trigger system status
Vertical Commands
Vertical commands control the attributes of the channels. The
SELect: command also displays a specified waveform or
removes it from the display. Table 2-- 25 lists and describes Vertical
commands.
Table 2- 25: Vertical commands
2- 36
Header
Description
CH?
Return vertical parameters
CH:BANdwidth
Set or query the channel bandwidth
CH:COUPling
Set or query the channel coupling
CH:CURRENTPRObe
(TDS1000B, TDS2000B, and
TPS2000 only)
Set or query the scale settings for current
probes
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Table 2- 25: Vertical commands (Cont.)
Header
Description
CH:INVert
(All oscilloscope, firmware version,
and module combinations except
TDS210 and TDS220 with firmware
below V 2.00 and a TDS2CMA
communications module.)
Set or query the channel invert
CH:POSition
Set or query the channel position
CH:PRObe
Set or query the channel probe parameters
CH:SCAle
Set or query the channel volts/div
CH:VOLts
Same as CH:SCAle
CH:YUNit
(TDS1000B, TDS2000B, and
TPS2000 only)
Set or query the units of the specified
channel
SELect?
Controls the display of waveforms
SELect:
Set or query the waveform display state
Waveform Commands
Waveform commands let you transfer waveform data points to and
from the oscilloscope. Waveform data points are a collection of
values that define a waveform. One data value usually represents one
data point in the waveform record. When working with peak-detect
waveforms, each data value is either the min or max of a min/max
pair. Before you can transfer waveform data, you must specify the
data format and waveform locations.
Table 2-- 26 lists and describes Waveform commands. Refer to the
text following this table for more information about waveform
commands.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 37
Command Groups
Table 2- 26: Waveform commands
2- 38
Header
Description
CURVe
Transfer waveform data to or from the
oscilloscope
DATa
Set or query the waveform data format and
location
DATa:DESTination
Set or query the destination for waveforms
sent to the oscilloscope
DATa:ENCdg
Set or query the waveform data encoding
method
DATa:SOUrce
Set or query the source of CURVe? data
DATa:STARt
Set or query the starting point in waveform
transfer
DATa:STOP
Set or query the ending point in waveform
transfer
DATa:TARget
Same as DATa:DESTination
DATa:WIDth
Set or query the byte width of waveform
points
WAVFrm?
Return waveform preamble and curve data
WFMPre?
Return waveform preamble
WFMPre:BIT_Nr
Set or query the preamble bit width of
waveform points
WFMPre:BN_Fmt
Set or query the preamble binary encoding
type
WFMPre:BYT_Nr
Set or query the preamble byte width of
waveform points
WFMPre:BYT_Or
Set or query the preamble byte order of
waveform points
WFMPre:ENCdg
Set or query the preamble encoding
method
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
Table 2- 26: Waveform commands (Cont.)
Header
Description
WFMPre:NR_Pt
Query the number of points in the curve
transfer
WFMPre:PT_Fmt
Set or query the format of curve points
WFMPre:PT_Off
Query the trigger offset
WFMPre:WFId?
Query the waveform identifier
WFMPre:XINcr
Set or query the horizontal sampling
interval
WFMPre:XUNit
Set or query the horizontal units
WFMPre:XZEro
Set or query the time of first point in
waveform
WFMPre:YMUlt
Set or query the vertical scale factor
WFMPre:YOFf
Set or query the vertical offset
WFMPre:YUNit
Set or query the vertical units
WFMPre:YZEro?
(TDS200 with TDS2MM module,
TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Set or query the waveform conversion
factor
WFMPre:?
Return waveform formatting data
WFMPre::NR_Pt?_Fmt
Return the number of points in the
transmitted waveform record
WFMPre::PT_Fmt
Set or query the format of curve points
WFMPre::PT_Off?
Query the trigger offset
WFMPre::WFId?
Query the waveform identifier
WFMPre::XINcr
Set or query the horizontal sampling
interval
WFMPre::XUNit
Set or query the horizontal units
WFMPre::XZEro
Set or query the time of first data point in
waveform
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 39
Command Groups
Table 2- 26: Waveform commands (Cont.)
Header
Description
WFMPre::YMUlt
Set or query the vertical scale factor
WFMPre::YOFf
Set or query the vertical position
WFMPre::YUNit
Set or query the vertical units
WFMPre::YZEro?
(TDS200 with TDS2MM module,
TDS1000, TDS2000, TDS1000B,
TDS2000B, and TPS2000 only)
Set or query the waveform conversion
factor
Waveform Data Formats
Internally, the oscilloscope uses one 8-bit data byte to represent each
waveform data point, regardless of the acquisition mode.
The DATa:WIDth command lets you specify the number of bytes per
data point when transferring data to and from an oscilloscope. This
provides compatibility with other digitizing oscilloscopes.
When DATa:WIDth is set to two:
H If sending data, the oscilloscope multiplies each point by 256; the
most significant byte then has meaningful data and the least
significant byte is 0
H If receiving data, the oscilloscope truncates the data (divides by
256) and saves the most significant byte
NOTE. The oscilloscopes uses these methods to handle waveforms
transmitted in ASCII or binary format.
2- 40
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
The oscilloscope can transfer waveform data in either ASCII or
binary format. Use the DATa:ENCdg command to specify one of the
following formats:
H ASCII data is represented by signed integer values. The range of
values depends on the byte width specified. One-byte-wide data
ranges from –128 to 127. Two-byte-wide data ranges from
–32768 to 32767.
Each data value requires two to seven characters. This includes
one character for the minus sign if the value is negative, one to
five ASCII characters for the waveform value, and a comma to
separate data points.
An example of an ASCII waveform data string follows:
CURVE–110,–109,–110,–110,–109,–107,–109,–107,
–106,–105,–103,–100,–97,–90,–84,–80
H Binary data can be represented by signed integer or positive
integer values. The range of the values depends on the byte width
specified.
Table 2-- 27 lists the ranges for one- and two-byte-wide data.
Table 2- 27: Binary data ranges
Byte width
Signed integer range
Positive integer range
1
–128 to 127
0 to 255
2
–32,768 to 32,767
0 to 65,535
The defined binary formats also specify the order in which the bytes
are transferred giving a total of four binary formats: RIBinary,
RPBinary, SRIbinary, and SRPbinary.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 41
Command Groups
RIBinary is signed integer where the most significant byte is
transferred first, and RPBinary is positive integer where the most
significant byte is transferred first. SRIbinary and SRPbinary
correspond to RIBinary and RPBinary respectively but use a
swapped byte order where the least significant byte is transferred
first. The byte order is ignored when DATa:WIDth is set to 1.
Waveform Data Record
You can transfer multiple points for each waveform record. You can
transfer a portion of the waveform or you can transfer the entire
record. The DATa:STARt and DATa:STOP commands let you
specify the first and last data points of the waveform record.
When transferring data into the oscilloscope you must specify the
location of the first data point within the waveform record. For
example, when DATa:STARt is set to 1, data points will be stored
starting with the first point in the record, and when DATa:STARt is
set to 500, data will be stored starting at the 500th point in the record.
The oscilloscope ignores DATa:STOP when reading in data as the
oscilloscope will stop reading data when there is no more data to
read or when it has reached 2500 data points.
You must specify the first and last data points in the waveform
record when transferring data from the oscilloscope to an external
device. Setting DATa:STARt to 1 and DATa:STOP to 2500 always
sends the entire waveform, regardless of the acquisition mode.
Waveform Data Locations and Memory Allocation
The DATa:SOUrce command specifies the location of the data when
transferring waveforms from the oscilloscope. You can transfer one
waveform at a time.
You can transfer only one waveform into the oscilloscope at a time.
Each waveform is stored in one of two stored waveform locations for
2-channel models or one of four stored waveform locations for
4-channel models. You specify the stored waveform location with
the DATa:DESTination command.
2- 42
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Groups
NOTE. The oscilloscope stores waveforms that are ≤2500 data points
long. The oscilloscope truncates waveforms longer than 2500 data
points.
Waveform Preamble
Each waveform that is transferred has an associated waveform
preamble that contains information such as the horizontal scale,
vertical scale, and other settings in place when the waveform was
created. Refer to the WFMPre commands on page 2-- 244 for more
information about the waveform preamble.
Scaling Waveform Data
Once you transfer the waveform data to the controller, you can
convert the data points into voltage values for analysis using
information from the waveform preamble.
Transferring Waveform Data
Data transfer times depend on data format, data width, and the speed
of the controller. Refer to Programming Examples on page 4-- 1.
From the Oscilloscope. To transfer waveforms from the oscilloscope to
an external controller, follow these steps:
1. Use the DATa:SOUrce command to select the waveform source.
2. Use the DATa:ENCdg command to specify the waveform data
format.
3. Use the DATa:WIDth command to specify the number of bytes
per data point.
4. Use the DATa:STARt and DATa:STOP commands to specify the
portion of the waveform that you want to transfer.
5. Use the WFMPRe? command to transfer waveform preamble
information.
6. Use the CURVe? command to transfer waveform data.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 43
Command Groups
To the Oscilloscope. To transfer waveform data to an oscilloscope
waveform storage location, follow these steps:
1. Use the DATa:DESTination command to specify the stored
waveform location.
2. Use the DATa:ENCdg command to specify the waveform data
format.
3. Use the DATa:WIDth command to specify the number of bytes
per data point.
4. Use the DATa:STARt command to specify the first data point in
the waveform record.
5. Use the WFMPRe command to transfer waveform preamble
information.
6. Use the CURVe? command to transfer waveform data.
2- 44
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Commands either set or query oscilloscope values. Some commands
both set and query, some only set, and some only query.
Manual Conventions
This manual uses the following conventions:
H No query form exists for commands identified as “Set Only”
H A question mark (?) appended to the command and “Query
Only” indicates query-only commands
H Fully spells out headers, mnemonics, and arguments with the
minimal spelling shown in upper case; for example, to use the
abbreviated form of the ACQuire:MODe command, just type
ACQ:MOD
H Syntax of some commands varies, depending on the model of
oscilloscope and extension module you use; differences are noted
H Command descriptions list specific oscilloscopes series (and
module) when commands are valid for only those products
NOTE. While Trigger View is active (when you push the TRIG VIEW
button on the front panel), the oscilloscope ignores the set form of
most commands. If you send a command at this time, the oscilloscope
generates execution error 221 (Settings conflict).
ACQuire? (Query Only)
Returns current acquisition settings.
Group
Acquisition
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 45
Command Descriptions
Syntax
ACQuire?
Returns
Returns current acquisition settings.
Examples
ACQuire?
Might return the following string for the current acquisition:
ACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE;NUMAVG 16
ACQuire:MODe
Sets or queries the oscilloscope acquisition mode. This affects all
live waveforms and is equivalent to setting the Mode option in the
Acquire menu.
Waveforms are the displayed data point values taken from
acquisition intervals. Each acquisition interval represents a time
duration that is determined by the horizontal scale (time per
division).
The oscilloscope sampling system can operate at a rate greater than
that indicated by the horizontal scale. Therefore, an acquisition
interval can include more than one sample.
The acquisition mode, which you set using this ACQuire:MODe
command, determines how the final value of the acquisition interval
is generated from the many data samples.
Group
Acquisition
Syntax
ACQuire:MODe { SAMple | PEAKdetect | AVErage }
ACQuire:MODe?
2- 46
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Arguments
SAMple specifies that the displayed data point value is the first
sampled value that was taken during the acquisition interval. The
waveform data has 8 bits of precision in all acquisition modes. You
can request 16 bit data with a CURVe? query, but the lower-order
8 bits of data will be zero. SAMple is the default mode.
PEAKdetect specifies the display of the high-low range of the
samples taken from a single waveform acquisition. The oscilloscope
displays the high-low range as a vertical range that extends from the
highest to the lowest value sampled during the acquisition interval.
PEAKdetect mode can reveal the presence of aliasing.
AVErage specifies averaging mode, where the resulting waveform
shows an average of SAMple data points from several separate
waveform acquisitions. The number of waveform acquisitions that
go into making up the average waveform is set or queried using the
ACQuire:NUMAVg command.
Examples
ACQuire:MODe PEAKdetect
Displays a vertical area representing the range of the highest to
lowest value of the acquired signal.
ACQuire:MODe?
Might return SAMPLE.
Related Commands
WFMPre:PT_Fmt
ACQuire:NUMACq? (Query Only)
Indicates the number of acquisitions that have taken place since
starting oscilloscope acquisition. The maximum number of
acquisitions that can be counted is 231-1. This value is reset to zero
when you change most Acquisition, Horizontal, Vertical, or Trigger
arguments that affect the waveform except for the following:
H Changing the trigger level or trigger holdoff when in Sample or
Peak Detect mode does not reset the value
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 47
Command Descriptions
NOTE. Any change made when in Average mode aborts the
acquisition and resets ACQuire:NUMACq to zero.
H TDS200: changing the vertical position does not reset the value
H TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000
series: if the Trigger mode is set to Auto, and the Horizontal
Scale is 10 ms/div or slower, changing the vertical position does
not reset the value
NOTE. In Scan mode, ACQuire:NUMACq? always returns zero.
Group
Acquisition
Syntax
ACQuire:NUMACq?
Returns
Examples
ACQuire:NUMACq?
Might return 350, indicating that 350 acquisitions took place since
an ACQuire:STATE RUN command was executed.
ACQuire:NUMAVg
Sets the number of oscilloscope waveform acquisitions that make up
an averaged waveform. This command is equivalent to setting the
Averages option in the Acquire menu.
Group
Acquisition
2- 48
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Syntax
ACQuire:NUMAVg
ACQuire:NUMAVg?
Arguments
is the number of waveform acquisitions. Correct values are 4,
16, 64, and 128.
Examples
ACQuire:NUMAVg 16
This specifies that an averaged waveform will show the result of
combining 16 separately acquired waveforms.
ACQuire:NUMAVg?
Might return 64, indicating that there are 64 acquisitions specified
for averaging.
ACQuire:STATE
Starts or stops oscilloscope acquisitions. This command is the
equivalent of pressing the front-panel RUN/STOP button. If
ACQuire:STOPAfter is set to SEQuence, other signal events may
also stop acquisition.
NOTE. The best way to determine when a single sequence acquisition
is complete is to use *OPC? rather than ACQuire:STATE?. For more
information on the *OPC? command, refer to page 2-- 169.
Group
Acquisition
Syntax
ACQuire:STATE { OFF | ON | RUN | STOP | }
ACQuire:STATE?
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 49
Command Descriptions
Arguments
OFF | STOP | = 0 stops acquisitions.
ON | RUN | ≠ 0 starts acquisition and display of waveforms. If
the command was issued in the middle of an acquisition sequence
(for instance averaging), RUN restarts the sequence, discarding any
data accumulated before the STOP. It also resets the number of
acquisitions.
Examples
ACQuire:STATE RUN
Starts acquisition of waveform data and resets the number of
acquisitions count (NUMACq) to zero.
ACQuire:STATE?
Returns 0 or 1, depending on whether or not the acquisition system is
running.
Related Commands
*OPC?
ACQuire:STOPAfter
Tells the oscilloscope when to stop taking acquisitions.
Group
Acquisition
Syntax
ACQuire:STOPAfter { RUNSTop | SEQuence}
ACQuire:STOPAfter?
Arguments
RUNSTop specifies that the run and stop states should be determined
by pressing the front-panel RUN/STOP button or issuing the
ACQuire:STATE command.
2- 50
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
SEQuence specifies “single sequence” operation, where the
oscilloscope stops after it has acquired enough waveforms to satisfy
the conditions of the acquisition mode. For example, if the
acquisition mode is set to sample, the oscilloscope stops after
digitizing a waveform from a single trigger event. However, if the
acquisition mode is set to average 64 waveforms, then the oscilloscope stops only after acquiring all 64 waveforms.
The ACQuire:STATE command and the front-panel RUN/STOP
button also stop acquisitions when the oscilloscope is in single
sequence mode.
Examples
ACQuire:STOPAfter RUNSTop
Sets the oscilloscope to stop the acquisition when you press the
front-panel RUN/STOP button.
ACQuire:STOPAfter?
Might return SEQUENCE.
ALLEv? (Query Only)
Causes the oscilloscope to return all events and their messages, and
removes the returned events from the Event Queue. The messages
are separated by commas. Use the *ESR? query to enable the events
to be returned. For a complete discussion of how to use these
registers, refer to page 3-- 1. This command is similar to repeatedly
sending *EVMsg? queries to the oscilloscope.
Group
Status and error
Syntax
ALLEv?
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 51
Command Descriptions
Returns
The event code and message in the following format:
[...]
::= ;[]
is the command that caused the error and may be
returned when a command error is detected by the oscilloscope. As
much of the command is returned as possible without exceeding the
60 character limit of the and strings
combined. The command string is right-justified.
Examples
ALLEv?
Might return the following string:
:ALLEV 2225,“Measurement error, No waveform to measure;
”,420,“Query UNTERMINATED; ”
Related Commands
*CLS, DESE, *ESE, *ESR?, EVENT?, EVMsg?, EVQty?, *SRE,
*STB?
AUTORange?
(TDS1000B, TDS2000B, and TPS2000 Series Only)
Returns current AUTORange settings.
Group
Power Measurement
Syntax
AUTORange?
Examples
AUTORange?
2- 52
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Might return :AUTORANGE:SETTINGS BOTH;STATE 1, indicating that
Autorange is active and adjusting both the horizontal and vertical
settings.
AUTORange:STATE
(TDS1000B, TDS2000B, and TPS2000 Series Only)
Toggles Autorange off and on.
Group
Miscellaneous
Syntax
AUTORange:STATE { OFF | ON | }
AUTORange:STATE?
Arguments
OFF deactivates the Autorange feature.
ON activates the Autorange feature.
= 0 deactivates the Autorange feature.
≠ 0 activates the Autorange feature.
Examples
AUTORANGE:STATE ON
Starts the Autorange function.
AUTORANGE:STATE?
Returns 0 or 1, depending on whether or not the Autorange function
is on.
Related Commands
AUTORange:SETTings
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 53
Command Descriptions
AUTORange:SETTings
(TDS1000B, TDS2000B, and TPS2000 Series Only)
Controls the parameters that the Autorange function can adjust. It is
equivalent to the option buttons in the Autorange menu.
Group
Miscellaneous
Syntax
AUTORange:SETTings { HORizontal | VERTical | BOTH }
AUTORange:SETTings?
Arguments
HORizontal allows Autorange to adjust the horizontal, but not
vertical, settings.
VERTical allows Autorange to adjust the vertical, but not horizontal, settings.
BOTH allows Autorange to adjust both the horizontal and vertical
settings.
Examples
AUTORANGE:SETTINGS VERTICAL
Turns on the Autorange vertical settings.
AUTORANGE:SETTINGS?
Might return VERTICAL, indicating that Autorange will only adjust
the vertical settings.
Related Commands
AUTORange:STATE
2- 54
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
AUTOSet (Set Only)
Causes the oscilloscope to adjust its vertical, horizontal, and trigger
controls to display a stable waveform. This command is equivalent
to pushing the front-panel AUTOSET button.
For a detailed description of the Autoset function, refer to the user
manual for your oscilloscope.
Group
Miscellaneous
Syntax
AUTOSet EXECute
Arguments
EXECute invokes Autoset.
AUTOSet:ENABLE
(TDS1000B and TDS2000B Series Only)
Allows educators to disable or enable the Autorange and Autoset
functions. The function can be manually set from the Service Diag
menu. To access the menu, refer to the TDS1000B and TDS2000B
series service manual.
Group
Miscellaneous
AUTOSet:SIGNAL? (Query Only)
(TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series
Only)
Returns the type of signal discovered by the most recent execution of
Autoset.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 55
Command Descriptions
Group
Miscellaneous
Syntax
AUTOSet:SIGNAL?
Returns
Might return { LEVEL | SINE | SQUARE | VIDPAL | VIDNTSC |
OTHER | NONe }
LEVEL if the oscilloscope discovered a DC level.
SINE if the oscilloscope discovered a sine-like waveform.
SQUARE if the oscilloscope discovered a square-like waveform.
VIDPAL if the oscilloscope discovered a PAL or SECAM standard
video signal.
VIDNTSC if the oscilloscope discovered an NTSC standard video
signal.
OTHER if the oscilloscope was unable to classify the signal.
NONE if the AUTOSET menu is not displayed.
AUTOSet:VIEW
(TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series
Only)
If the current menu is not the Autoset menu, or if the view is not
valid for the detected waveform, the set command causes the
oscilloscope to generate error 221 (Settings conflict).
Group
Miscellaneous
Syntax
AUTOSet:VIEW { MULTICYcle | SINGLECYcle | FFT |
RISINGedge | FALLINGedge | FIELD | ODD | EVEN | LINE |
LINENum | DCLIne | DEFault | NONE }
2- 56
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Arguments
MULTICYcle displays a sine or square wave of several cycles. Default
for sine-like and square-like signals.
SINGLECYcle displays a sine or square wave of approximately one
cycle.
FFT displays the FFT of a sine wave.
RISING displays the rising edge of a square wave.
FALLING displays the falling edge of a square wave.
FIELD displays a video signal synchronized on all fields. This is the
default for video signals.
ODD displays a video signal synchronized on odd fields.
EVEN displays a video signal synchronized on even fields.
LINE displays a video signal synchronized on all lines.
LINENum displays a video signal synchronized on the specified line
number.
DCLIne returns a query response when the oscilloscope finds a DC
level.
DEFault returns a query response when the oscilloscope cannot
determine the signal type.
NONE returns a query response when the AUTOSET menu is not
displayed. Set is ignored.
Examples
AUTOSet:VIEW EVEN
The oscilloscope will display video signals synchronized on even
fields when operated in autoset mode.
BUSY? (Query Only)
Returns the status of the oscilloscope. This command allows you to
synchronize the operation of the oscilloscope with your application
program. Refer to Synchronization Methods on page 3-- 10 for more
information.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 57
Command Descriptions
Group
Status and error
Syntax
BUSY?
Returns
0 when the oscilloscope is not busy processing any of the commands
listed in Table 2-- 30 (*OPC) on page 2-- 170.
1 when the oscilloscope is busy processing one of the commands
listed in Table 2-- 30 (*OPC) on page 2-- 170.
Examples
BUSY?
Might return 1, indicating that the oscilloscope is busy.
Related Commands
*OPC, *WAI
*CAL? (Query Only)
Performs an internal self-calibration and returns its status. This is
equivalent to selecting the Do Self Cal option in the Utility menu.
Although *CAL? is a query command, it does perform an action.
NOTE. The self-calibration can take several minutes to complete.
During this time, the oscilloscope does not execute any commands.
Disconnect all signals from the oscilloscope before performing an
internal self-calibration.
Group
Calibration and Diagnostic
2- 58
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Syntax
*CAL?
Returns
0 indicates that the self-calibration completed without any errors
detected.
Any value other than zero indicates that the self-calibration did not
complete successfully or completed with errors.
Examples
*CAL?
Performs a self-calibration and might return 0 to indicate that it
completed successfully.
Related Commands
CALibrate:INTERNAL
CALibrate:ABOrt (Set Only)
NOTE. You should only use this command in a qualified service
environment. For more information about the factory calibration
sequence, refer to the service manual for your oscilloscope.
Aborts the factory calibration process. When you abort the factory
calibration, the oscilloscope restores the calibration settings to the
previous factory calibration constants stored in non-volatile memory.
Group
Calibration and Diagnostic
Syntax
CALibrate:ABOrt
Examples
CALibrate:ABOrt
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 59
Command Descriptions
Stops the in-process factory calibration procedure.
CALibrate:CONTINUE (Set Only)
NOTE. You should only use this command in a qualified service
environment. For more information about the factory calibration
sequence, refer to the service manual for your oscilloscope.
Performs the next step in the factory calibration operation.
Group
Calibration and Diagnostic
Syntax
CALibrate:CONTINUE
Examples
CALibrate:CONTINUE
Performs the next step in the factory calibration operation.
CALibrate:FACtory (Set Only)
NOTE. You should only use this command in a qualified service
environment. For more information about the factory calibration
sequence, refer to the service manual for your oscilloscope.
Starts the oscilloscope’s internal factory calibration operation. The
calibration operation consists of a sequence of steps. You send the
CALibrate:CONTINUE command to advance to the next calibration
step. The calibration program automatically sets up the oscilloscope
for each calibration step. Use the CALibrate:ABOrt command to
abort the factory calibration.
2- 60
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
You can only send synchronization commands or queries (such as
*OPC, OPC?, *WAI, BUSY?) while doing a factory calibration.
Group
Calibration and Diagnostic
Syntax
CALibrate:FACtory
Examples
CALibrate:FACtory
Starts the factory calibration process.
CALibrate:INTERNAL (Set Only)
Performs an internal self-calibration but does not return any status.
This is equivalent to selecting the Do Self Cal option in the Utility
menu.
NOTE. The self-calibration can take several minutes to complete.
During this time, the oscilloscope does not execute any commands.
Disconnect all signals from the oscilloscope before performing an
internal self-calibration.
Syntax
CALibrate:INTERNAL
Examples
CALibrate:INTERNAL
Performs an internal self-calibration.
Related Commands
*CAL?
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 61
Command Descriptions
CALibrate:STATUS? (Query Only)
Returns the status of the last calibration operation performed (either
self- or factory-calibration) since power up.
Group
Calibration and Diagnostic
Syntax
CALibrate:STATUS?
Returns
PASS indicates that the oscilloscope completed the last calibration
operation without detecting any errors.
FAIL indicates that the oscilloscope detected errors during the last
calibration operation, or that no calibration operations have been
performed since power up.
Examples
CALibrate:STATUS?
Might return CALIBRATE:STATUS FAIL, if the oscilloscope failed the
last calibration operation.
CH? (Query Only)
Returns the current oscilloscope vertical settings. The value of
can vary from 1 through 4 for 4-channel instruments or 1 through 2
for 2-channel instruments.
Because CH:SCAle and CH:VOLts are identical, only
CH:SCAle is returned.
Group
Vertical
Syntax
CH?
2- 62
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Returns
Oscilloscope vertical settings.
Examples
CH1?
Might return the following string for channel 1:
CH1:SCALE 1.0E0;POSITION 0.0E0; COUPLING DC;BANDWIDTH
OFF;PROBE 1.0E0
Related Commands
SELect:CH
CH:BANdwidth
Sets or queries the bandwidth setting of the specified oscilloscope
channel. The value of can vary from 1 through 4 for 4-channel
instruments or 1 through 2 for 2-channel instruments.
This command is equivalent to setting the BW Limit option in the
Vertical menu.
Group
Vertical
Syntax
CH:BANdwidth { ON | OFF }
CH:BANdwidth?
Arguments
ON sets the channel bandwidth to 20 MHz.
OFF sets the channel bandwidth to the full bandwidth of the
oscilloscope.
In most acquisition modes, full bandwidth is 60 MHz, 100 MHz, or
200 MHz (depending on the oscilloscope model). There are
exceptions.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 63
Command Descriptions
TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series
At vertical scales from 2.00 to 4.99 mV/div (sensitivity at the BNC;
that is, after the probe factor is removed), the full bandwidth is
20 MHz.
TDS200 Series
At vertical scales of 5 mV/div or less (sensitivity at the BNC; that is,
after the probe factor is removed), the full bandwidth is 20 MHz.
When the acquisition mode is Peak Detect, and the vertical scale at
the BNC is 10 mV/div or less, the full bandwidth is also 20 MHz.
Examples
CH2:BANDWIDth ON
Sets the bandwidth of channel 2 to 20 MHz.
CH1:BANDWIDth?
Might return OFF. This indicates there is no bandwidth limiting on
channel 1.
CH:COUPling
Sets or queries the input attenuator coupling setting of the specified
oscilloscope channel. The value of can vary from 1 through 4
for 4-channel instruments or 1 through 2 for 2-channel instruments.
This command is equivalent to setting the Coupling option in the
Vertical menu.
Group
Vertical
Syntax
CH:COUPling { AC | DC | GND }
CH:COUPling?
Arguments
AC sets the specified oscilloscope channel to AC coupling.
2- 64
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
DC sets the specified oscilloscope channel to DC coupling.
GND sets the specified oscilloscope channel to ground. Only a flat
ground-level waveform is displayed.
Examples
CH1:COUPlING AC
This establishes AC coupling on channel 1.
CH2:COUPlING?
Might return DC. Indicating that channel 2 is set to DC coupling.
CH:CURRENTPRObe
(TDS1000B, TDS2000B, and TPS2000 Series Only)
Sets or queries the scale factor of the specified channel for current
probes. The value of can vary from 1 through 4 for 4-channel
instruments or 1 through 2 for 2-channel instruments.
You can issue this command when CH:YUNit is set
to V. However, this command only affects the readouts when
CH:YUNit is set to A.
Group
Vertical
Syntax
CH:CURRENTPRObe { 0.2 | 1 | 2 | 5 | 10 | 50 | 100 |
1000 }
CH:CURRENTPRObe?
Arguments
0.2 sets the specified oscilloscope channel to 0.2X attenuation.
1 sets the specified oscilloscope channel to 1X attenuation.
2 sets the specified oscilloscope channel to 2X attenuation.
5 sets the specified oscilloscope channel to 5X attenuation.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 65
Command Descriptions
10 sets the specified oscilloscope channel to 10X attenuation.
50 sets the specified oscilloscope channel to 50X attenuation.
100 sets the specified oscilloscope channel to 100X attenuation.
1000 sets the specified oscilloscope channel to 1000X attenuation.
Returns
Examples
CH2:CURRENTPRObe 1000
This sets channel 2 to 1000X attenuation.
CH1:CURRENTPRObe?
Might return 10.
CH:INVert
NOTE. You can NOT use this command with a TDS210 or TDS220
oscilloscope with firmware below V 2.00 and a TDS2CMA
(or TDS2CM) communications module.
Sets or queries the inversion state of the specified oscilloscope
channel. The value of can vary from 1 through 4 for 4-channel
instruments or 1 through 2 for 2-channel instruments.
This command is equivalent to setting the Invert option in the
Vertical channel menus.
Group
Vertical
Syntax
CH:INVert { ON | OFF }
CH:INVert?
2- 66
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Arguments
ON inverts the specified oscilloscope channel.
OFF sets the specified oscilloscope channel to non-inverted.
Examples
CH1:INVert ON
Inverts the signal on channel 1.
CH2:INVert?
Might return OFF, indicating that channel 2 is not inverted.
CH:POSition
Sets or queries the vertical position of the specified oscilloscope
channel. The value of can vary from 1 through 4 for 4-channel
instruments or 1 through 2 for 2-channel instruments.
The position voltage value is applied to the signal before digitization. This command is equivalent to adjusting the front-panel
VERTICAL POSITION knob.
Group
Vertical
Syntax
CH:POSition
CH:POSition?
Arguments
is the position in divisions from the center graticule.
Table 2-- 28 lists the vertical position ranges using a 1X probe.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 67
Command Descriptions
Table 2- 28: Vertical position ranges using a 1X probe
CH:SCAle
Position range
2 mV/div
±1000 divs
5 mV/div
±400 divs
10 mV/div
±200 divs
20 mV/div
±100 divs
50 mV/div
±40 divs
100 mV/div
±20 divs
200 mV/div
±10 divs
500 mV/div
±100 divs
1 V/div
±50 divs
2 V/div
±25 divs
5 V/div
±10 divs
Examples
CH2:POSition 1.32E0
Positions the channel 2 input signal 1.32 divisions above the center
of the display.
CH1:POSition?
Might return –1.32E0, indicating that the current position of channel
1 is at –1.32 divisions.
CH:PRObe
Sets or queries the attenuation factor of the specified channel or
voltage probes. The value of can vary from 1 through 4 for
4-channel instruments or 1 through 2 for 2-channel instruments.
Group
Vertical
2- 68
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Syntax
CH:PRObe { 1 | 10 | 20 | 50 | 100 | 500 | 1000 }
CH:PRObe?
Arguments
1 sets the specified oscilloscope channel to 1X attenuation.
10 sets the specified oscilloscope channel to 10X attenuation.
20 sets the specified oscilloscope channel to 20X attenuation.
(TDS1000B, TDS2000B, and TPS2000 series only)
50 sets the specified oscilloscope channel to 50X attenuation.
(TDS1000B, TDS2000B, and TPS2000 series only)
100 sets the specified oscilloscope channel to 100X attenuation.
500 sets the specified oscilloscope channel to 500X attenuation.
(TDS1000B, TDS2000B, and TPS2000 series only)
1000 sets the specified oscilloscope channel to 1000X attenuation.
Returns
Examples
CH2:PRObe 1000
Sets channel 2 to 1000X attenuation.
CH1:PRObe?
Might return CH1:PROBE 10
CH:SCAle
Sets or queries the vertical gain of the specified oscilloscope
channel. The value of can vary from 1 through 4 for 4-channel
instruments or 1 through 2 for 2-channel instruments.
This command is equivalent to adjusting the front-panel VOLTS/
DIV knob.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 69
Command Descriptions
Group
Vertical
Syntax
CH:SCAle
CH:SCAle?
Arguments
is the gain, in volts or amps per division. For example, the
voltage range is 5 V/div to 2 mV/div when using a 1X voltage probe.
Examples
CH1:SCAle 100E–3
Sets the channel 1 gain to 100 mV/div.
CH2:SCAle?
Might return 1.0E0, indicating that the current V/div setting of
channel 2 is 1 V/div.
Related Commands
CH1:VOLts
CH:VOLts
Sets or queries the vertical gain of the specified channel. The value
of can vary from 1 through 4 for 4-channel instruments or 1
through 2 for 2-channel instruments.
This command is identical to the CH:SCAle command and is
included for compatibility purposes. Only CH:SCAle is returned
in response to a CH? query.
2- 70
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
CH:YUNit
(TDS1000B, TDS2000B, and TPS2000 Series Only)
Sets or queries the units of the specified channel. The value of
can vary from 1 through 4 for 4-channel instruments or 1 through 2
for 2-channel instruments.
Group
Vertical
Syntax
CH:YUNit
CH:YUNit?
Arguments
is either “V” for volts or “A” for amps. This is equivalent
to setting the probe to Voltage or Current in the probe front-panel
menu. This command is case insensitive.
Examples
CH2:YUNIT?
Might return CH2:YUNIT “V”, indicating that the channel 2 units are
volts.
*CLS (Set Only)
The *CLS command clears the following oscilloscope status data
structures:
H The Event Queue
H The Standard Event Status Register (SESR)
H The Status Byte Register (except the MAV bit described on
page 2-- 72)
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 71
Command Descriptions
If the *CLS command immediately follows an , the Output
Queue and MAV bit (Status Byte Register bit 4) are also cleared.
MAV indicates information is in the output queue. The device clear
(DCL) GPIB control message and the USBTMC INITIATE_CLEAR
control message will clear the output queue and also MAV.
*CLS does not clear the output queue or MAV. *CLS can suppress a
service request that is to be generated by an *OPC command. This
will happen if a hard copy output or single sequence acquisition
operation is still being processed when the *CLS command is
executed.
Refer to Registers on page 3-- 1 for more information.
Group
Status and Error
Syntax
*CLS
Related Commands
DESE, *ESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB?
CURSor? (Query Only)
Returns current cursor settings.
Group
Cursor
Syntax
CURSor?
Returns
Oscilloscope cursor settings.
Examples
CURSor?
2- 72
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Might return the following string as the current cursor settings:
CURSOR:FUNCTION VBARS;SELECT:SOURCE CH1; :CURSOR:VBARS:UNITS SECONDS;POSITION1 0.0E0;POSITION2
4.48E–3;:CURSOR:HBARS:UNITS VOLTS;POSITION1 0.0E0;POSITION2 5.0E–1.
CURSor:FUNCtion
Selects and displays the oscilloscope cursor type. Cursors are
attached to the waveform selected by CURSor:SELect:SOUrce. This
command is equivalent to setting the Type option in the Cursor
menu. Setting the function to anything other than OFF causes the
Cursor menu to be displayed.
NOTE. Setting the display format to XY removes the cursors. Sending
the CURSor:FUNCtion command when the display format is XY
causes the oscilloscope to generate event 221 (Settings conflict) and
leaves the display in XY format.
Group
Cursor
Syntax
CURSor:FUNCtion { HBArs | OFF | VBArs }
CURSor:FUNCtion?
Arguments
HBArs specifies horizontal bar cursors that measure the vertical units
in volts, amps, divisions, or decibels.
OFF removes cursors from the display.
VBArs specifies vertical bar cursors that measure time or frequency.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 73
Command Descriptions
Examples
CURSor:FUNCtion VBArs
Selects vertical bar type cursors.
CURSor:HBArs? (Query Only)
Returns the current settings for the oscilloscope horizontal bar
cursors.
Group
Cursor
Syntax
CURSor:HBArs?
Returns
Current horizontal bar cursor settings.
Examples
CURSor:HBArs?
Might return the following string:
CURSOR:HBARS:UNITS VOLTS;POSITION1 0.0E0; POSITION2
0.0E0.
CURSor:HBArs:DELTa? (Query Only)
Returns the difference (in vertical units) between the two horizontal
bar cursors in the oscilloscope display.
NOTE. If Trigger View is active, this query returns 9.9E37 and
generates event 221 (Settings conflict).
Group
Cursor
2- 74
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Syntax
CURSor:HBArs:DELTa?
Returns
Examples
CURSor:HBArs:DELTa?
Might return 5.08E0 for the difference between the two cursors.
CURSor:HBArs:POSITION
Positions a horizontal bar cursor. The value of can vary from 1
through 2.
NOTE. If Trigger View is active, the query form returns 9.9E37 and
generates event 221 (Settings conflict).
Group
Cursor
Syntax
CURSor:HBArs:POSITION
CURSor:HBArs:POSITION?
Arguments
specifies the horizontal bar cursor position, relative to ground
(in volts when the units are volts and amps when the units are amps),
relative to the center of the screen (in divs when units are divisions),
or relative to 1 V RMS (in decibels when the source is an FFT math
waveform), for the waveform specified by the CURSor:SELect:SOUrce command.
The cursor position is limited to the graticule whenever an attempt is
made to move it outside the graticule.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 75
Command Descriptions
NOTE. The source always determines the measurement units.
Examples
CURSor:HBArs:POSITION1 25.0E–3
Positions one of the horizontal cursors at 25.0 mV (assuming the
vertical units are volts).
CURSor:HBArs:POSITION2?
Might return –6.40E–2, indicating that the second horizontal bar
cursor is at –64.0 mV (assuming the vertical units are volts).
CURSor:HBArs:UNIts? (Query Only)
Returns the vertical scale units for the selected cursor source
waveform.
Group
Cursor
Syntax
CURSor:HBArs:UNIts?
Returns
VOLts indicates volts from ground as the unit of measure.
DIVs indicates divisions as the unit of measure, with center of screen
as 0 divisions and bottom of screen as –4 divisions.
DECIBELS indicates decibels as the unit of measure, relative to a
1 Vrms sine wave. (FFT only)
UNKNOWN indicates that Trigger View is active. This also generates
event message 221. (Settings conflict)
AMPS indicates amps as the unit of measure. (TDS1000B,
TDS2000B, and TPS2000 series only)
2- 76
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
VOLTSSQUARED indicates volts squared (V*V) as the unit of measure.
(TDS1000B, TDS2000B, and TPS2000 series only)
AMPSSQUARED indicates amps squared (A*A) as the unit of measure.
(TDS1000B, TDS2000B, and TPS2000 series only)
VOLTSAMPS indicates voltage times current (V*A) as the unit of
measure. (TDS1000B, TDS2000B, and TPS2000 series only)
NOTE. Unknown units are represented by ”?” in the oscilloscope
readouts.
Examples
CURSor:HBArs:UNIts?
Might return CURSOR:HBARS:UNITS VOLTS.
CURSor:SELect:SOUrce
Sets or queries the waveform that is the source of the vertical and
horizontal scale factors used in determining cursor values. This
command is equivalent to setting the Source option in the Cursor
menu.
Group
Cursor
Syntax
CURSor:SELect:SOUrce
CURSor:SELect:SOUrce?
Arguments
specifies the waveform data source on which cursor
measurements will be taken.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 77
Command Descriptions
Examples
CURSor:SELect:SOUrce CH1
Selects channel 1.
CURSor:SELect:SOUrce?
Might return MATH.
CURSor:VBArs? (Query Only)
Returns the current vertical bar cursor horizontal position and units
settings.
Group
Cursor
Syntax
CURSor:VBArs?
Examples
CURSor:VBArs?
Might return CURSOR:VBARS:UNITS SECONDS;
POSITION1 1.00E–6;POSITION2 9.00E–6
CURSor:VBArs:DELTa? (Query Only)
Returns the time or frequency difference between the two vertical
bar cursors. The units (seconds or Hertz) are specified by the
CURSor:VBArs:UNIts command. If the cursor source is an FFT
math waveform, CURSor:VBArs:DELTa is always in Hertz,
regardless of the value set by CURSor:VBArs:UNIts.
NOTE. If Trigger View is active, this query returns 9.9E37 and
generates event 221 (Settings conflict).
2- 78
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Group
Cursor
Syntax
CURSor:VBArs:DELTa?
Returns
Examples
CURSor:VBArs:DELTa?
Might return 8.92E–1, indicating that the time difference between
the vertical bar cursors is 0.892 seconds.
CURSor:VBArs:HDELTa? (Query Only)
(TDS1000B, TDS2000B, and TPS2000 Series Only)
Returns the time or frequency difference between the two vertical
bar cursors. The units (seconds or Hertz) are specified by the
CURSor:VBArs:UNIts command. If the cursor source is an FFT
math waveform, CURSor:VBArs:DELTa is always in Hertz,
regardless of the value set by CURSor:VBArs:UNIts.
The command is identical to the CURSor:VBArs:DELTa? query. It is
included for compatibility with the TDS3000 series.
NOTE. If Trigger View is active, this query returns 9.9E37 and
generates event 221 (Settings conflict).
Group
Cursor
Syntax
CURSor:VBArs:HDELTa?
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 79
Command Descriptions
Returns
Examples
CURSor:VBArs:HDELTa?
Might return 8.92E–1, indicating that the time difference between
the vertical bar cursors is 0.892 seconds.
CURSor:VBArs:HPOS? (Query Only)
(TDS1000B, TDS2000B, and TPS2000 Series Only)
Returns the waveform amplitude at the specified cursor position. The
units are specified by the CURSor:HBArs:UNIts query.
Group
Cursor
Syntax
CURSor:VBArs:HPOS?
Arguments
specifies the cursor. Valid values are 1 and 2.
Returns
indicates the amplitude value at the selected position.
Examples
CURSOR:VBARS:HPOS1?
Might return 1.37, indicating the value of one vertical bar tic.
Related Commands
CURSor:HBArs:UNIts
2- 80
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
CURSor:VBArs:POSITION
Positions a vertical bar cursor. The unit is specified by the
CURSor:VBArs:UNIts command, and can be in units of seconds or
frequency (Hertz). If the cursor source is an FFT math waveform,
CURSor:VBArs:POSITION is always in Hertz, regardless of the
value set by CURSor:VBArs:UNIts.
NOTE. If Trigger View is active, the query form returns 9.9E37 and
generates event 221 (Settings conflict).
Group
Cursor
Syntax
CURSor:VBArs:POSITION
CURSor:VBArs:POSITION?
Arguments
specifies which cursor to position. Correct values are 1 and 2.
specifies the cursor position in the units specified by the
CURSor:VBArs:UNIts command. The position is relative to the
trigger except when the cursor source is a math FFT waveform.
The cursor position is limited to the graticule whenever an attempt is
made to move it outside the graticule.
Examples
CURSor:VBArs:POSITION2 9.00E–6
Positions the second vertical bar cursor at 9 s.
CURSor:VBArs:POSITION1?
Might return 1.00E–6, indicating the first vertical bar cursor is at
1 s.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 81
Command Descriptions
CURSor:VBArs:SLOPE? (Query Only)
(TPS2000 Series with TPS2PWR1 Power Analysis Module Only)
Returns the change in amplitude divided by the change in time, as
measured between the two cursors. The units are derivable from the
CURSor:HBArs:UNIts and CURSor:VBArs:UNIts queries.
Group
Cursor
Syntax
CURSor:VBArs:SLOPE?
Examples
CURSor:VBArs:SLOPE?
Might return 1.22E3, indicating the slope measured between Vertical
Cursor 1 and Vertical Cursor 2.
CURSor:VBArs:UNIts
Sets or queries the units for the vertical bar cursors.
NOTE. When Trigger View is active, CURSor:VBArs:UNIts?
generates event 221(Settings conflict).
Group
Cursor
Syntax
CURSor:VBArs:UNIts { SECOnds | HERtz }
CURSor:VBArs:UNIts?
Arguments
SECOnds specifies units of time.
2- 82
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
HERtz specifies units of frequency (reciprocal of time).
Examples
CURSor:VBArs:UNIts SECONDS
Sets the units for the vertical bar cursors to seconds.
CURSor:VBArs:UNIts?
Returns HERTZ when the vertical bar cursor units are Hertz.
CURSor:VBArs:VDELTa? (Query Only)
(TDS1000B, TDS2000B, and TPS2000 Series Only)
Returns the vertical (amplitude) difference between the two vertical
bar cursors. The units are specified by the CURSor:HBArs:UNits
query.
Group
Cursor
Syntax
CURSor:VBArs:VDELTa?
Returns
indicates the vertical difference between the two vertical bar
cursors.
Examples
CURSor:VBArs:VDELTa?
Might return 1.064E+0, indicating that the vertical difference
between the vertical bar cursor ticks is 1.064 units.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 83
Command Descriptions
CURVe
Transfers oscilloscope waveform data to and from the oscilloscope in
binary or ASCII format. Each waveform that is transferred has an
associated waveform preamble that contains information such as
data format and scale. For information about the waveform
preamble, refer to WFMPre? (Query Only) on page 2-- 244. The data
format is specified by the DATa:ENCdg and DATa:WIDth commands.
The CURVe? query sends data from the oscilloscope to an external
device. The data source is specified by the DATa:SOUrce command.
The first and last data points that are transferred are specified by the
DATa:STARt and DATa:STOP commands.
NOTE. If the waveform specified by the DATa:SOUrce command is
not displayed, the CURVe? query returns nothing, and generates
events 2244 (Waveform requested is not activated) and 420 (Query
UNTERMINATED).
In Scan Mode (Sec/di ≥100 ms and AUTO Mode), approximately one
division’s worth of data points will be invalid due to the blanked
moving cursor.
The CURVe set command sends waveform data from an external
device to the oscilloscope. The data is stored in the stored waveform
location specified by DATa:DESTination, starting with the data point
specified by DATa:STARt. Only one waveform can be transferred at
a time. The waveform will only be displayed if the reference
waveform is displayed.
Refer to Waveform Commands on page 2-- 38 for a description of the
waveform transfer process.
Group
Waveform
Syntax
CURVe { | }
2- 84
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
CURVe?
Arguments
is the waveform data in binary format. The waveform is
formatted as: # where is the number of
characters in . For example, if = 500, then = 3,
where is the number of bytes to transfer. Refer to Block
Arguments on page 2-- 13 for more information.
If width is 1, then all bytes on the bus are single data points. If width
is 2, then all bytes on the bus are 2-byte pairs. Use the DATa:WIDth
command to set the width. is the curve data.
is the waveform data in ASCII format. The format for
ASCII data is [,...] where each represents a
data point.
Examples
CURVe?
Might return the following ASCII data:
:CURVE 13,6,3,2,–1,–9,–14,–19,–29,–35,–67,–1,–78,–62,
–50,–31,–27,–7,0,12,29,39,45,43,41,47,41,38,33,26
Related Commands
DATa, WFMPre
DATa
Sets or queries the format and location of the waveform data that is
transferred with the CURVe command. Since DATa:DESTination and
DATa:TARget are equivalent, only DATa:DESTination is returned by
the DATa? query.
Group
Waveform
Syntax
DATa { INIT }
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 85
Command Descriptions
DATa?
Arguments
INIT reinitializes the waveform data settings to their factory
defaults.
Examples
DATa INIT
Reinitializes the waveform data settings to their factory defaults:
DESTINATION = REFA (=TARGET)
ENCDG = RIBINARY
SOUrce = CH1
START = 1
STOP = 2500
WIDTH = 1
DATa?
Might return the following string:
:DATA:ENCDG RPBINARY;DESTINATION REFA; SOURCE REFB;START
1;STOP 500;WIDTH 2
Related Commands
CURVe, WAVFrm
DATa:DESTination
Sets or queries the reference memory location for storing oscilloscope waveform data that is transferred into the oscilloscope by the
CURVe command. This command is identical to the DATa:TARget
command.
Group
Waveform
Syntax
DATa:DESTination REF
2- 86
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
DATa:DESTination?
Arguments
REF is the reference memory location where the waveform will
be stored.
Examples
DATa:DESTINATION REFA
Stores incoming waveform data into reference memory REFA.
DATa:DESTINATION?
Might return REFB as the waveform location that is currently
selected.
Related Commands
CURVe?
DATa:ENCdg
Sets or queries the format of the waveform data. This command is
equivalent to setting WFMPre:ENCdg, WFMPre:BN_Fmt, and
WFMPre:BYT_Or as shown in Table 2-- 29 on page 2-- 88.
Setting the DATa:ENCdg value causes the corresponding WFMPre
values to update. Setting the WFMPre value causes the corresponding DATa:ENCdg values to update.
Group
Waveform
Syntax
DATa:ENCdg { ASCIi | RIBinary | RPBinary | SRIbinary |
SRPbinary }
DATa:ENCdg?
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 87
Command Descriptions
Arguments
ASCIi specifies the ASCII representation of signed integer
(RIBinary) data. If this is the value at power-on, the WFMPre values
for BN_Fmt, BYT_Or, and ENCdg are set as RP, MSB, and ASC
respectively.
RIBinary specifies signed integer data-point representation with the
most significant byte transferred first. This format results in the
fastest data transfer rate when DATa:WIDth is set to 2.
The range is –128 to 127 when DATa:WIDth is 1. Zero is center
screen. The range is –32768 to 32767 when DATa:WIDth is 2. The
upper limit is one division above the top of the screen and the lower
limit is one division below the bottom of the screen.
RPBinary specifies positive integer data-point representation with
the most significant byte transferred first.
The range is 0 to 255 when DATa:WIDth is 1. Center screen is 127.
The range is 0 to 65,535 when DATa:WIDth is 2. The upper limit is
one division above the top of the screen and the lower limit is one
division below the bottom of the screen.
SRIbinary is the same as RIBinary except that the byte order is
swapped, meaning that the least significant byte is transferred first.
This format is useful when transferring data to IBM compatible PCs.
SRPbinary is the same as RPBinary except that the byte order is
swapped, meaning that the least significant byte is transferred first.
This format is useful when transferring data to IBM compatible PCs.
Table 2-- 29 lists DATa and WFMPre parameter settings.
Table 2- 29: DATa and WFMPre parameter settings
WFMPre settings
2- 88
DATa:ENCdg setting
:ENCdg
:BN_Fmt
:BYT_Or
ASCIi
ASC
N/A
N/A
RIBinary
BIN
RI
MSB
RPBinary
BIN
RP
MSB
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Table 2- 29: DATa and WFMPre parameter settings (Cont.)
DATa:ENCdg setting
SRIbinary
:ENCdg
:BN_Fmt
:BYT_Or
BIN
RI
LSB
SRPbinary
BIN
RP
LSB
Examples
DATa:ENCdg RPBINARY
Sets the data encoding format to be positive integer where the most
significant byte is transferred first.
DATa:ENCdg?
Might return SRPBINARY for the format of the waveform data.
Related Commands
WFMPre:ENCdg, WFMPre:BN_Fmt, WFMPre:BYT_Or
DATa:SOUrce
Sets or queries which waveform will be transferred from the
oscilloscope by the CURVe?, WFMPre?, or WAVFrm? queries. You
can transfer only one waveform at a time.
Group
Waveform
Syntax
DATa:SOUrce
DATa:SOUrce?
Arguments
is the location of the waveform data that will be transferred
from the oscilloscope to the external device. Allowable values are
CH, MATH, and REF.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 89
Command Descriptions
Examples
DATa:SOUrce REFB
Specifies that reference waveform REFB will be transferred in the
next CURVe? query.
DATa:SOUrce?
Might return REFA, indicating the source for the waveform data that
is transferred using the CURVe? command.
Related Commands
CURVe?, WFMPre?, WAVFrm?
DATa:STARt
Sets or queries the starting data point for waveform data transfers.
This command lets you transfer partial waveforms to and from the
oscilloscope.
Group
Waveform
Syntax
DATa:STARt
DATa:STARt?
Arguments
is an integer value that ranges from 1 to 2500, and specifies
the first data point that will be transferred. Data is transferred from
to DATa:STOP or 2500, whichever is less. When
DATa:STOP is less than DATa:STARt, the values are swapped
internally for CURVe?.
Examples
DATa:STARt 10
Specifies that the waveform transfer will begin with data point 10.
DATa:STARt?
2- 90
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Might return 214 as the first waveform data point that will be
transferred.
Related Commands
CURVe?
DATa:STOP
Sets or queries the last data point in the waveform that will be
transferred when executing the CURVe? command. This lets you
transfer partial waveforms from the oscilloscope.
When using the CURVe command, the oscilloscope stops reading
data when there is no more data to read or when the 2500 data point
limit is reached.
Group
Waveform
Syntax
DATa:STOP
DATa:STOP?
Arguments
is an integer value that ranges from 1 to 2500, and specifies
the last data point that will be transferred. When DATa:STOP is less
than DATa:STARt, the values are swapped internally for CURVe?.
If you always want to transfer complete waveforms, set DATa:STARt
to 1 and DATa:STOP to 2500.
Examples
DATa:STOP 150
Specifies that the waveform transfer will stop at data point 150.
DATa:STOP?
Might return 285 as the last data point that will be transferred.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 91
Command Descriptions
Related Commands
CURVe?
DATa:TARget
Sets or queries the location for storing waveform data transferred
from an external device to the oscilloscope when executing the
CURVe command. This command is equivalent to the DATa:DESTination command and is included here for compatibility with older
Tektronix oscilloscopes.
DATa:WIDth
Sets the number of bytes per waveform data point to be transferred
when executing the CURVe command. (Changing DATa:WIDth may
change the following WFMPre parameters: BIT_Nr, BYT_Nr,
YMULt, YOFf, and YZEro.)
Group
Waveform
Syntax
DATa:WIDth
DATa:WIDth?
Arguments
= 1 sets the number of bytes per waveform data point to 1
byte (8 bits).
= 2 sets the number of bytes per waveform data point to
2 bytes (16 bits). If DATa:WIDth is set to 2, the least significant byte
is always zero.
Examples
DATa:WIDth 1
Sets the data width to 1 byte per data point for CURVe data.
2- 92
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Related Commands
CURVe, WFMPre:BIT_Nr, WFMPre:BYT_Nr
DATE
(TDS2MEM, TDS1000B, TDS2000B, and TPS2000 Series Only)
Sets or queries the oscilloscope date value. The oscilloscope uses
these values to time stamp files saved to the CompactFlash card
(TDS2MEM and TPS2000 series only), or to the USB flash drive
(TDS1000B and TDS2000B series only), as well as show the time
and date on the oscilloscope display.
Group
Miscellaneous
Syntax
DATE
DATE?
Arguments
is a date in the form “yyyy-mm-dd”.
Examples
DATE “2003-05-06”
Sets the date to May 6th, 2003.
Related Commands
TIMe
*DDT
Lets you specify a command or a list of commands to execute when
the oscilloscope receives a *TRG command, or the GET GPIB
interface message, or the USBTMC TRIGGER message. This is a
special alias that *TRG uses.
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 93
Command Descriptions
TRG command, or the GET GPIB interface message, or the
USBTMC TRIGGER message.
Group
Miscellaneous
Syntax
*DDT { | }
*DDT?
Arguments
or is a complete sequence of program messages.
The messages must contain only valid commands that must be
separated by semicolons and must follow all rules for concatenating
commands (refer to page 2-- 6). The sequence must be ≤80 characters.
format is always returned as a query response.
Examples
*DDT #217ACQuire:STATE RUN
Specifies that the acquisition system will be started each time a
*TRG command is sent.
Related Commands
*TRG
DESE
Sets and queries the bits in the Device Event Status Enable Register
(DESER). The DESER is the mask that determines whether or not
events are reported to the Standard Event Status Register (SESR),
and entered into the Event Queue. Refer to the Status and Events
chapter on page 3-- 1 for more information.
Group
Status and Error
2- 94
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Syntax
DESE
DESE?
Arguments
is an integer value in the range from 0 to 255. The binary bits
of DESER are set according to this value. For example, DESE 209
sets the DESER to the binary value 11010001 (that is, the most
significant bit in the register is set to 1, the next most significant bit
to 1, the next bit to 0, and so on).
The power-on default for DESER is all bits set to 1 if *PSC is 1. If
*PSC is 0, the DESER maintains its value through a power cycle.
NOTE. Setting DESER and ESER to the same value allows only those
codes to be entered into the Event Queue and summarized on the
ESB bit (bit 5) of the Status Byte Register. Use the *ESE command to
set ESER. For more information on event handling, refer to the
Status and Events chapter.
Examples
DESE 209
Sets the DESER to binary 11010001, which enables the PON, URQ,
EXE, and OPC bits.
DESE?
Might return the following string :DESE 186, showing that DESER
contains the binary value 10111010.
Related Commands
*CLS, *ESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB?
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 95
Command Descriptions
DIAg:RESUlt:FLAg? (Query Only)
Returns the Pass/Fail status from the last diagnostic test sequence
execution (those run automatically at power on, or those requested
through the Service Menu). Use the DIAg:RESUlt:LOG? query to
determine which test(s) has failed.
Group
Calibration and Diagnostic
Syntax
DIAg:RESUlt:FLAg?
Returns
PASS means that the oscilloscope passes all diagnostic tests.
FAIL means that the oscilloscope has failed at least one of the
diagnostic tests.
Examples
DIAg:RESUlt:FLAG?
Returns either PASS or FAIL.
DIAg:RESUlt:LOG? (Query Only)
Returns the internal results log from the last diagnostic test sequence
execution (those run automatically at power on, or those requested
through the Service Menu). The list contains all modules and module
interfaces that were tested along with the pass or fail status of each.
Group
Calibration and Diagnostic
Syntax
DIAg:RESUlt:LOG?
2- 96
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Command Descriptions
Returns
in the following format:
,[,,...]
Examples
DIAg:RESUlt:LOG?
Might return “pass-CPU, pass-ACQ1, pass-EXTENSION” for
power-up diagnostics.
DISplay? (Query Only)
Returns the current display settings.
Group
Display
Syntax
DISplay?
Returns
The current display settings
Examples
DISplay?
Might return :DISPLAY:FORMAT YT;STYLE VECTORS;
PERSISTENCE OFF;CONTRAST 50; INVERT OFF
DISplay:BRIGHTness
(TPS2000 Series Only)
Sets or queries the brightness of the LCD display.
Group
Display
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
2- 97
Command Descriptions
Syntax
DISplay:BRIGHTness { 100 | 90 | 75| 60 | 45 | 30
| 15 | 0 }
DISplay:BRIGHTness?
Arguments
Sets the display brightness in percent.
Examples
DISPLAY:BRIGHTNESS 75
Sets the display brightness to 75%.
Related Commands
DISplay:CONTRast
DISplay:INVert
DISplay:CONTRast
Sets or queries the contrast of the LCD display. This command is
equivalent to setting the Contrast option in the Display menu.
Group
Display
Syntax
DISplay:CONTRast
DISplay:CONTRast?
Arguments