Teledyne T3DSO1000 Operating instructions

1
Programming Guide
T3DSO1000 and T3DSO2000 Digital
Oscilloscopes Programming Guide
Manual Version 1.2

Digital Oscilloscope Series
2
Version Declaration
This chapter indicates the modifications of commands in the most recent
release of the programming guide version.
Introduction
Manual version 1.2 describes all the currently available commands. Some
of the commands vary between the oscilloscope series, and these will be
annotated in the description of command.
The following are the main revisions:
wDelete the Table of Commands & Queries, and all the instructions are
classified according to the functional modules.
wRemoved incorrect instructions, added instructions for GEN and DIGITAL
modules.
wAdd two new communication features: Telnet and Socket, visible in
“Programming Overview-Remote Control”.
wDetailed programming instances for instructions (WF?/SCDP) to make
it easier to understand.
wSupport obtaining waveform data of Digital channel and Math.

Digital Oscilloscope Series
3
Content
Programming Overview ....................................... .............................................. 6
Establishing Communications ....................................... ................................. 6
Install NI-VISA ....................................... ......................................... .......... 6
Connect the Instrument............................................................................. 10
Remote Control ........................................... ................................................. 11
User-defined Programming......................................... .............................. 11
Send SCPI Commands via NI-MAX ........................................................ 11
Using SCPI with Telnet.................................. .......................................... 11
Using SCPI with Sockets............................................... ........................... 13
Introduction to the SCPI Language .................................................................. 14
About Commands & Queries................................................................... ..... 14
Description ........................................... ........................................................ 14
Usage........................................... ........................................ ......................... 14
Command Notation............................................................................. .......... 15
Commands & Queries ........................................ .............................................. 17
COMMON (*) Commands ........................................................................... 18
COMM_HEADER Commands ....................................... ............................. 22
ACQUIRE Commands ................................................................................ . 24
AUTOSET Commands........................................ ......................................... 38
CHANNEL Commands .............................................. .................................. 40
CURSOR Commands ............................................................................ ....... 50
DIGITAL Commands......... .......................................................................... 58
DISPLAY Commands ................................ ........................................ .......... 68
HISTORY Commands........................................................... ....................... 74

Digital Oscilloscope Series
4
MATH Commands. ................................................................................. ......79
MEASURE Commands................................................................ .................96
PASS/FAIL Commands ....................................................................... .......110
PRINT Commands ........................................................................... ...........122
RECALL Commands ..................................... .............................................124
REFERENCE Commands............. .............................................................. 128
SAVE Commands ............................................. ..........................................138
STATUS Commands.............................. ......................................... ............145
SYSTEM Commands.................................................................................. 148
TIMEBASE Commands....................................................... ....................... 153
TRIGGER Commands ....................................... ......................................... 161
WAVEFORM Commands ....................................... ................................... 178
WGEN Commands...................................................................... ................19 2
Programming Examples ................................................................................. 199
VISA Examples................................... ......................................... ...............200
VC++ Example................................................. ....................................... 200
VB Example................................................... ......................................... 207
MATLAB Example........... ...................................................................... 213
LabVIEW Example.................................... ............................................ .215
C# Example..................................................... ........................................ 218
Examples of Using Sockets................................... ...................................... 221
Python Example ........................................... ...........................................221
C Example..................................................... ......................................... .224
Common Command Examples............................................................ ........226
Read waveform data (WF) Example ....................................... ................226

Digital Oscilloscope Series
5
Screen Dump (SCDP) Example............................................................ .. 228
Index............................................................ ....................................... ............ 229

Digital Oscilloscope Series
6
Programming Overview
This chapter introduces how to build communication between the instrument and
the PC. It also introduces how to configure a system for remote instrument control.
By using USB and LAN interfaces, in combination with NI-VISA and
programming languages, users can remotely control the instruments. Through LAN
interface, VXI-11, Sockets and Telnet protocols can be used to communicate with
the instruments.
Establishing Communications
Install NI-VISA
Before programming, you need to install the National Instruments NI-VISA
library, which you can download from the National Instruments web site.
Currently, NI-VISA is packaged in two versions: a full version and a Run-Time
Engine version. The full version includes the NI device drivers and a tool named
NI MAX which is a user interface to control and test remotely connected
devices. The Run-Time Engine is recommended, as it is a much smaller
download than the full version and includes the necessary tools for basic
communication to instruments.
For example, you can get the NI-VISA 5.4 full version from:
http://www.ni.com/download/ni-visa-5.4/4230/en/.
You also can download NI-VISA Run-Time Engine 5.4 to your PC and install it
as the default selection. Its installation process is similar with the full version.
After you downloaded the file, follow these steps to install NI-VISA (The full
version of NI-VISA 5.4 is used in this example. Newer versions are likely, and
should be compatible with Teledyne Test Tools instrumentation. Download the
latest version available for the operating system being used by the controlling
computer):
a. Double click the visa540_full.exe, dialog shown as below:

Digital Oscilloscope Series
7
b. Click Unzip, the installation process will automatically launch after unzipping
files. If your computer needs to install .NET Framework 4, it may auto start.
c. The NI-VISA installing dialog is shown above. Click Next to start the
installation process.

Digital Oscilloscope Series
8
d. Set the install path, default path is “C:\Program Files\National Instruments\”,
you can change it. Click Next, dialog shown as above.
e. Click Next twice, in the License Agreement dialog, select the “I accept the
above 2 License Agreement(s).”,and click Next, dialog shown as below:

Digital Oscilloscope Series
9
f. Click Next to begin installation.
g. Now the installation is complete. Reboot your PC.

Digital Oscilloscope Series
10
Connect the Instrument
Depending on the specific model, your oscilloscope may be able to communicate
with a PC through the USB or LAN interface.
Connect the instrument and the USB Host interface of the PC using a USB cable.
Assuming your PC is already turned on, turn on your oscilloscope, and then the
PC will display the “Device Setup” screen as it automatically installs the device
driver as shown below.
Wait for the installation to complete and then proceed to the next step.

Digital Oscilloscope Series
11
Remote Control
User-defined Programming
Users can use SCPI commands via a computer to program and control the digital
oscilloscope. For details, refer to the introductions in "Programming Examples".
Send SCPI Commands via NI-MAX
NI-Measurement and Automation eXplorer (NI-MAX) is a program created and
maintained by National Instruments. It provides a basic remote control interface
for VXI, LAN, USB, GPIB, and Serial communications. It is a utility that enables
you to send commands one-at-a-time and also retrieve data from connected devices.
It is a great tool for troubleshooting and testing command sequences. The
oscilloscopes can be controlled remotely by sending SCPI commands via NI-MAX.
Using SCPI with Telnet
Telnet provides a means of communicating with the oscilloscopes over a LAN
connection. The Telnet protocol sends SCPI commands to the oscilloscopes from
a PC and is similar to communicating with the oscilloscopes over USB. It sends
and receives information interactively: one command at a time. Windows operating
systems use a command prompt style interface for the Telnet client. The steps are
as follows:
1. On your PC, click Start > All Programs > Accessories > Command Prompt.
2. At the command prompt, type in telnet.
3. Press the Enter key. The Telnet display screen will be displayed.

Digital Oscilloscope Series
12
4. At the Telnet command line, type:
open XXX.XXX.XXX.XXX 5024
Where XXX.XXX.XXX.XXX is the instrument‘s IP address and 5024 is the port.
You should see a response similar to the following:
5. At the SCPI> prompt, input the SCPI commands such as *IDN? to return the
company name, model number, serial number, and firmware version number.

Digital Oscilloscope Series
13
6. To exit the SCPI> session, press the Ctrl+] keys simultaneously.
7. Type quit at the prompt or close the Telnet window to close the
connection to the instrument and exit Telnet.
Using SCPI with Sockets
Socket API can be used to control the T3DSO series via LAN without
installing any other libraries. This can reduce the complexity of
programming.
SOCKET ADDRESS IP address + port number
IP ADDRESS T3DSO IP address
PORT NUMBER 5024
Please see section "Examples of Using Sockets" for the details.

Digital Oscilloscope Series
14
Introduction to the SCPI Language
About Commands & Queries
This section lists and describes the remote control commands and queries
recognized by the instrument. All commands and queries can be executed
in either local or remote state.
The description for each command or query, with syntax and other
information, begins on a new page. The name (header) is given in both
long and short form at the top of the page, and the subject is indicated as
a command or query or both.
The commands are given in long format for the “COMMAND SYNTAX“
and “QUERY SYNTAX“ sections and they are used in a short form for the
“EXAMPLE” .
Queries perform actions such as obtaining information, and are recognized
by the question mark (?) following the header.
Description
In the description, a brief explanation of the function performed is given.
This is followed by a presentation of the formal syntax, with the header
given in upper case characters and the short form derived from it. Where
applicable, the syntax of the query is given with the format of its response.
Usage
The commands and queries listed here can be used for the T3DSO1000
and T3DSO2000 Digital Oscilloscope Series.

Digital Oscilloscope Series
15
Command Notation
The following notations are used in the commands:
< > Angular brackets enclose words that are used as placeholders, of which there
are two types: the header path and the data parameter of a command.
:= A colon followed by an equals sign separates a placeholder from the
description of the type and range of values that may be used in a
command instead of the placeholder.
{ } Braces enclose a list of choices, one of which one must be made.
[ ] Square brackets enclose optional items.
… An ellipsis indicates that the items both to its left and right may be repeated
for a number of times.
As an example, consider the syntax notation for the command to set the vertical
input sensitivity:
<channel>:VOLT_DIV <v_gain>
<channel>:={C1,C2,C3,C4}
<v_gain>:= 2 mV to 10 V
The first line shows the formal appearance of the command, with <channel>
denoting the placeholder for the header path and <v_gain> the placeholder for
the data parameter specifying the desired vertical gain value. The second line
indicates that one of four channels must be chosen for the header path. And the
third explains that the actual vertical gain can be set to any value between 2 mV
and 10 V.

Digital Oscilloscope Series
16

Digital Oscilloscope Series
17
Commands & Queries
This chapter introduces each command subsystem of the Teledyne Test Tools
Digital Oscilloscope Series command set. The contents of this chapter are shown
as below:
wCOMMON (*) Commands
wCOMM_HEADER Commands
wACQUIRE Commands
wAUTOSET Commands
wCHANNEL Commands
wCURSOR Commands
wDIGITAL Commands
wDISPLAY Commands
wHISTORY Commands
wMATH Commands
wMEASURE Commands
wPASS/FAIL Commands
wPRINT Commands
wRECALL Commands
wREFERENCE Commands
wSAVE Commands
wSTATUS Commands
wSYSTEM Commands
wTIMEBASE Commands
wTRIGGER Commands
wWAVEFORM Commands
wWGEN Commands
wObsolete Commands for Old Models

Digital Oscilloscope Series
18
COMMON (*) Commands
The IEEE 488.2 standard defines some general commands for querying the basic
information of an instrument or performing common basic operations. These
commands usually start with *, and the command key length is 3 characters.
w*IDN? (Identification Number)
w*OPC (Operation Complete)
w*RST (Reset)

Digital Oscilloscope Series
19
COMMON (*) *IDN?
Query
DESCRIPTION The *IDN? query identifies the instrument type
and software version. The response consists of
four different fields providing information on the
manufacturer, the scope model, the serial
number and the firmware revision.
QUERY SYNTAX *IDN?
RESPONSE FORMAT Teledyne Test Tools,<model>,<serial
number>,<firmware>
<model>:= the model number of the instrument.
<serial number>:= A 14-digit decimal code.
<firmware>:= the software revision of the
instrument
EXAMPLE The query identifies the instrument type and
software version.
Command message:
*IDN?
Response message:
Teledyne Test Tools, T3DSO1204
,NDS1EBAC0L0098,7.6.1.15

Digital Oscilloscope Series
20
COMMON (*) *OPC
Command/Query
DESCRIPTION The *OPC command sets the operation complete
bit in the Standard Event Status Register when
all pending device operations have finished.
The *OPC? query places an ASCII "1" in the
output queue when all pending device operations
have completed. The interface hangs until this
query returns.
COMMAND SYNTAX *OPC
QUERY SYNTAX *OPC?
RESPONSE FORMAT *OPC 1