Tektronix TDS200 Series Operating and maintenance manual

Programmer Manual
TDS200, TDS1000/TDS2000,
TDS1000B/TDS2000B, and
TPS2000 Series Digital Oscilloscopes
071-1075-04
This document supports:
STPS2000 Series instruments, any version.
STDS1000B and TDS2000B Series instruments,
any version.
STDS2CM or TDS2CMA, any version, when
used in TDS1000 or TDS2000 Series instruments,
any version.
STDS2MEM any version, when used in most
TDS1000 or TDS2000 Series instruments (except
TDS1001 and TDS2004 models), any version.
STDS2CM, TDS2CMA, or TDS2MM any
version, when used in a TDS224 instrument, any
version.
STDS2CM 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:
HIn North America, call 1-800-833-9200.
HWorldwide, visit www.tektronix.com to find contacts in your area.

TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer i
Table of Contents
Preface vii............................................
Related Documents vii..................................
Conventions 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 2--15..................................
Acquisition Commands 2--15...............................
Calibration and Diagnostic Commands 2--16...................
Cursor Commands 2--17...................................
Display Commands 2--18..................................
File System Commands (TDS2MEM Module, TDS1000B,
TDS2000B, and TPS2000 Only) 2--19....................
Hard Copy Commands 2--20...............................
Horizontal Commands 2--21................................
Math Commands 2--22....................................
Measurement Commands 2--23.............................
Miscellaneous Commands 2--25.............................
PictBridge Commands (TDS1000B and TDS2000B Only) 2--27...
Power and Battery-Related Commands (TPS2000 Only) 2--28.....
Power Measurement (TPS2000 with TPS2PWR1 Power
Analysis Application Key Installed Only) 2--28.............
RS-232 Commands 2--32..................................
Save and Recall Commands 2--32...........................
Status and Error Commands 2--33...........................
Trigger Commands 2--34..................................
Vertical Commands 2--36..................................
Waveform Commands 2--37................................
Waveform Data Formats 2--40..............................

Table of Contents
ii TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
Waveform Data Record 2--42...............................
Waveform Data Locations and Memory Allocation 2--42.........
Waveform Preamble 2--43.................................
Scaling Waveform Data 2--43...............................
Transferring Waveform Data 2--43...........................
Command Descriptions 2--45..............................
Status and Events
Status and Events 3--1...................................
Registers 3--1...........................................
Status Registers 3--1..................................
Enable Registers 3--4..................................
The Enable Registers and the *PSC Command 3--6.........
Queues 3--6............................................
The Output Queue 3--6................................
The Event Queue 3--7.................................
Event Handling Sequence 3--8.............................
Synchronization Methods 3--10.............................
Using the *WAI Command 3--11.........................
Using the BUSY Query 3--13............................
Using the *OPC Set Command 3--14......................
Using the *OPC? Query 3--16............................
Messages 3--17..........................................
Programming Examples
Programming Examples 4--1.............................
Appendices
Appendix A: ASCII Code Chart A--1.......................
Appendix B: Factory Setup B--1...........................
TDS1000B and TDS2000B Series Oscilloscopes B--1...........
TPS2000 Series Oscilloscopes B--3.........................
TDS1000 and TDS2000 Series Oscilloscopes B--5.............
TDS210 and TDS220 Oscilloscopes B--6.....................
TDS224 Oscilloscopes B--8................................
Glossary and Index

Table of Contents
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer iii
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....

Table of Contents
iv TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
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.......................

Table of Contents
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer v
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.................

Table of Contents
vi TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer

TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer vii
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

Preface
viii TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
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.
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

Preface
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer ix
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 Commu-
nications 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 Commu-
nications module, refer to the TDS2MEM Storage Memory and
Communications Module User Manual (071--1262--XX), an optional
accessory that includes all eleven languages.

Preface
xTDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
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.

Preface
TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer xi
Service Manuals (English Only)
For information on how to service your oscilloscope, refer to the
appropriate manual from the following optional accessories:
HTPS2000 Series Digital Storage Oscilloscopes Service Manual
(071-1465-XX)
HTDS1000B and TDS2000B Series Digital Storage Oscilloscopes
Service Manual (071-1828-XX)
HTDS1000 and TDS2000 Series Digital Storage Oscilloscopes
Service Manual (071-1076-XX)
HTDS200 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:
HReferences to the TDS2CMA Communications Extension
Module include the TDS2CM and TDS2CMAX modules.
HCommand descriptions list specific oscilloscopes series (and
module) when commands are valid for only those products

Preface
xii TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer

Getting Started

TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer 1-1
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
Communications, TDS2MM Math
RS-232, Centronics, GPIB
TDS1000/
TDS2000*
TDS2CMA or TDS2CMAX
TDS2MEM Storage Memory and
Communications
RS-232, Centronics, GPIB
RS-232, Centronics, CompactFlash
TDS1000B/
T
D
S
B
{
Back of oscilloscope USB Device
/
TDS2000B{
p
GPIB with a TEK-USB-488 adapter
TPS2000 Back of oscilloscope RS-232, Centronics
* 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.

Getting Started
1-2 TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer
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.

Syntax and Commands