This chapter indicates the modifications of commands in the most recent
release of the programming guide version.
Introduction
Manual version 1.3 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:
Delete the Table of Commands & Queries, and all the instructions are
classified according to the functional modules.
Removed incorrect instructions, added instructions for GEN and DIGITAL
modules.
Add two new communication features: Telnet and Socket, visible in
“Programming Overview-Remote Control”.
Detailed programming instances for instructions (WF?/SCDP) to make
it easier to understand.
Support obtaining waveform data of Digital channel and Math.
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:
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.
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 commandsone-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 receivesinformation 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.
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(A) and T3DSO2000 Digital Oscilloscope Series.
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 2mV
and 10V.
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:
COMMON (*) Commands
COMM_HEADER Commands
ACQUIRE Commands
AUTOSET Commands
CHANNEL Commands
CURSOR Commands
DIGITAL Commands
DISPLAY Commands
HISTORY Commands
MATH Commands
MEASURE Commands
PASS/FAIL Commands
PRINT Commands
RECALL Commands
REFERENCE Commands
SAVE Commands
STATUS Commands
SYSTEM Commands
TIMEBASE Commands
TRIGGER Commands
WAVEFORM Commands
WGEN Commands
Obsolete Commands for Old Models
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.
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.
*IDN?
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
The query identifies the instrument type and
software version.
Command message:
*IDN?
Response message:
Teledyne Test Tools, T3DSO1204
,NDS1EBAC0L0098,7.6.1.15
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.
The COMM_HEADER command controls the
way the oscilloscope formats response to
queries. This command does not affect the
interpretation of messages sent to the
oscilloscope. Headers can be sent in their long or
short form regardless of the CHDR setting.
Examples of the three response formats to
“C1:VDIV?”:
The ARM_ACQUISITION command starts a
new signal acquisition.
ARM_ACQUISITION
The following steps show the effect of ARM.
Note:
INR bit 13 (8192) = Trigger is ready.
INR bit 0 (1) = New Signal Acquired.
Step 1: Set the trigger mode to single, and input
a signal which can be triggered. Once triggered,
you can see the state of acquisition changes to
stop. Send the query.
Query message:
INR?
Response message:
INR 8193(trigger ready)
Step 2: Send the query again to clear the
register.
Query message:
INR?
Response message:
INR 0
Step 3; Now, send the command to start a new
signal acquisition.
The ACQUIRE_WAY command specifies the
acquisition mode.
The ACQUIRE_WAY? query returns the current
acquisition mode.
ACQUIRE_WAY <mode>[,<time>]
<mode>:={SAMPLING,PEAK_DETECT,AVE
RAGE,HIGH_RES}
<time>:={4,16,32,64,128,256,512,…}
• SAMPLING — sets the oscilloscope in the
normal mode.
• PEAK_DETECT — sets the oscilloscope in
the peak detect mode.
• AVERAGE — sets the oscilloscope in the
averaging mode.
• HIGH_RES — sets the oscilloscope in the
enhanced resolution mode (also known as
smoothing). This is essentially a digital boxcar
filter and is used to reduce noise at slower
sweep speeds.
Note:
• The [HIGH_RES] option is valid for T3DSO
models. See models on page 14.
• <time>:={4,16,32,64,128,256,512,…} when
<mode> = AVERAGE.
Options vary from models. See the data sheet or
the acquire menu of the oscilloscope.
The MEMORY_SIZE command sets the
maximum depth of memory.
The MEMORY_SIZE? query returns the
maximum depth of memory.
MEMORY_SIZE <size>
<size>:={7K,70K,700K,7M} for non-interleaved
mode. Non-interleaved means a single channel is
active per A/D converter. Most oscilloscopes
feature two channels per A/D converter. .
<size>:={14K,140K,1.4M,14M} for interleave
mode. Interleave mode means multiple active
channels per A/D converter.
Note:
Options of <size> vary from models. See the
data sheet or the acquire menu of the
oscilloscope for details.
MEMORY_SIZE?
MEMORY_SIZE <size>
The following command sets the maximum
depth of memory to 14M in interleave mode.
Command message:
The SANU?query returns the number of data
points that the hardware will acquire from the
input signal. The number of points acquired
is based on the horizontal scale and
memory/acquisition depth selections and
cannot be directly set.
SANU?<channel>
<channel>:={C1,C2,C3,C4}
SANU <value>
ModelFormat of <value>
T3DSO1000(A)
T3DSO2000
The following query returns the number of
sampled points available from last
acquisition from Channel 2.
Query message:
SANU? C2
Numericalvalue
in E-notationwith
SI unit, such as
7.00E+05pts.
Numericalvalue
withmeasurement
unit and physical
unit, such as 28Mpts.
The XY_DISPLAY command enables or
disables the display of XY mode. XY mode
plots the voltage data of both channels with
respect to one-another. For example, channel
1 vs. channel 2. This can be used to create
Lissajous curves. The standard display mode
plots voltage data vs. time.
The XY_DISPLAY? query returns whether
the XY format display is enabled.
XY_DISPLAY <state>
<state>:={ON,OFF}
X Y _ D I S P L A Y ?
XY_DISPLAY <state>
The following command enables the XY
format.
Command message:
The AUTOSET subsystem commands control the function of automatic waveform
setting. The oscilloscope will automatically adjust the vertical position, the
horizontal time base and the trigger mode according to the input signal to make
the waveform display to the best state.
The CHANNEL subsystem commands control the analog channels. Channels are
independently programmable for offset, probe, coupling, bandwidth limit,
inversion, and more functions. The channel index (1, 2, 3, or 4) specified in the
command selects the analog channel that is affected by the command.
The ATTENUATION command specifies the
probe attenuation factor for the selected channel.
The probe attenuation factor may be 0.1 to
10000.This command does not change the actual
input sensitivity of the oscilloscope. It changes
the reference constants for scaling the display
factors, for making automatic measurements,
and for setting trigger levels.
The ATTENUATION? query returns the current
probe attenuation factor for the selected channel.
The following command sets the attenuation
factor of Channel 1 to 100:1. To ensure the data
matches the true signal voltage values, the
physical probe attenuation must match the scope
attenuation values for that input channel.
BANDWIDTH_LIMIT enables or disables the
bandwidth-limiting low-pass filter. If the
bandwidth filters are on, it will limit the
bandwidth to reduce display noise. When you
turn Bandwidth Limit ON, the Bandwidth Limit
value is set to 20 MHz. It also filters the signal to
reduce noise and other unwanted high frequency
components.
The BANDWIDTH_LIMIT? query returns
whether the bandwidth filters are on.
The OFFSET command allows adjustment of the
vertical offset of the specified input channel. The
maximum ranges depend on the fixed sensitivity
setting.
The OFFSET? query returns the offset value of the
specified channel.
<channel>:OFFSET <offset>
<channel>:={C1,C2,C3,C4}
<offset>:= vertical offset value with unit, see the
data sheet for details.
Note:
• If there is no unit (V/mV/uV) added, it defaults
to volts (V).
• If you set the offset to a value outside of thelegal
range, the offset value is automatically set to the
nearest legal value. Legal values are affected by
the probe attenuation setting.
<channel>:OFFSET?
<channel>:OFFSET <offset>
<offset>:= Numerical value in E-notation with
SI unit.
• The following command sets the offset of
Channel 2 to -3 V.
Command message:
C2:OFST -3V
• The following command sets the offset of
Channel 1 to -50 mV.
Command message:
The SKEW command sets the channel-tochannel skew factor for the specified
channel. Each analog channel can be
adjusted + or -100 ns for a total of 200 ns
difference between channels. You can use
the oscilloscope's skew control to remove
cable-delay errors between channels.
The SKEW? query returns the skew value
of the specified trace.
<trace>:SKEW <skew>
<trace>:={C1,C2,C3,C4}
<skew>:= -100 ns to +100 ns.
<trace>:SKEW?
<trace>:SKEW <skew>
ModelFormat of <skew>
T3DSO1000(A)
T3DSO2000Numericalvalue
Numericalvalue
in E-notationwith
SI unit, such as
9.99E-08S.
withmeasurement
unit and physical
unit, such as 0.00ns.
EXAMPLE
The following command sets skew value of
Channel 1 to 3ns.
The UNIT command sets the unit of the
specified trace. Measurement results, channel
sensitivity, and trigger level will reflect the
measurement units you select.
The UNIT? query returns the unit of the
specified trace.
<channel>:UNIT <type>
<channel>:={C1,C2,C3,C4}
<type>:={V,A}
<channel>:UNIT?
<channel>:UNIT <type>
The following command sets the unit of
Channel 1 to V.
The CURSOR subsystem commands set and query the settings of X-axis
markers(X1 and X2 cursors) and the Y-axis markers (Y1 and Y2 cursors). You
can set and query the marker mode and source, the position of X and Y cursors,
and query delta X and delta Y cursor values.
The CURSOR_SET command allows the user to
position any one of the four independent cursors
at a given screen location. The positions of the
cursors can be modified or queried even if the
required cursor is not currently displayed on the
screen. When setting a cursor position, a trace
must be specified, relative to which the cursor
will be positioned.
The CURSOR_SET? query returns the current
position of the cursor(s). The values returned
depend on the grid type selected.
• When the current time base is 1 us, vdiv is 500
mV, the cursor mode is manual, the following
command sets the X1 positions to -3 DIV, Y2
position to −1 DIV,using Channel 1 as a reference.
Command message:
C1:CRST TREF,-3us,VDIF,-500mV
• When the current time base is 1 us, the cursor
mode is track, the following command sets the X1
positions to -1 DIV, X2 position to 2 DIV, using
Channel 1 as a reference.
Command message:
The DIGITAL_THR command sets the
threshold for the specified group of channels.
The threshold is used for triggering purposes and
for displaying the digital data as high (above the
threshold) or low (below the threshold).
The DIGITAL_THR? query returns the
threshold value for the specified group of
channels.
<group>:DIGITAL_THR <type>[,<level>]
<group>:={C1,C2}
• C1 — D0-D7.
• C2 — D8-D15.
<type>:={TTL,CMOS,CMOS3.3,CMOS2.5,CU
STOM}
<level>:= -5V to 5V when <type> is CUSTOM.
Note:
• If there is no unit(V) added to <level>, it
defaults to be V.
• If you set the threshold to a value outside of
the legal range, the threshold is automatically
set to the nearest legal value.
The table below shows the availability of command in each oscilloscope series.
ModelValid?
T3DSO2000no
T3DSO1000(A)
THRESHOLD_MODE | TSM
The THRESHOLD_MODE command sets the
threshold type for the specified group of
channels. The threshold is used for triggering
purposes and for displaying the digital data as
high (above the threshold) or low (below the
threshold).
The THRESHOLD_MODE? query returns the
threshold type for the specified group of
channels.
<group>:THRESHOLD_MODE <type>
<group>:={H8,L8}
• H8 — D8-D15.
• L8 — D0-D7.
<type>:={TTL,CMOS,LVCMOS33,LVCMOS2
5,CUSTOM}
<group>:THRESHOLD_MODE?
<group>:THRESHOLD_MODE <type>
For T3DSO1000(A) series, when the Digital
function is on, the following command sets the
threshold of D0-D7 to LVLCMOS3.3.
Command message:
The CUSTOM command sets the threshold
value by customer for the specified group of
channels. The threshold is used for triggering
purposes and for displaying the digital data as
high (above the threshold) or low (below the
threshold).
The CUSTOM? query returns the threshold
value set by customer for the specified group of
channels.
<group>:CUSTOM <value>
<group>:={H8,L8}
• H8 — D8-D15.
• L8 — D0-D7.
<value>:= volt value with unit.
Note:
• You need to add the volt unit(V/mV) to the
value. If there is no unit added, it defaults to
volts (V).
• The range of value varies from models. See
the data sheet for details.
• An out-of-range value will be adjusted to the
closest legal value.
<group>:CUSTOM?
<group>:CUSTOM <value>
For T3DSO1000(A) series, when the Digital
function is on, the following command sets the
threshold value of D8-D15 to 5V.
Command message:
The MATH subsystem controls the math functions in the oscilloscope. As
selected by the DEF command, these math functions are available:
Operators: Add, Subtract, Multiply, Divide.
Operators perform their function on two analog channel sources.
Transforms: DIFF, Integrate, FFT, SQRT.
•When the Math function is on, and both
Channel 1 and Channel 2 are on, the following
command sets the math operation to
Multiplication, source1 to C1, source2 to C2.
Command message:
The MATH_VERT_DIV command sets the
vertical scale of the selected math operation.
This command is only valid in add, subtract,
multiply and divide operation.
The MATH_VERT_DIV? query returns the
current scale value for the selected operation.
MATH_VERT_DIV <scale>
<scale>:={500uV,1mV,2mV,5mV,10mV,20mV,
50mV,100mV,200mV,500mV,1V,2V,5V,10V ,2
0V ,50V,100V}(for add, subtract, multiply and
divide)
Note:
Legal values for the scale depend on the selected
operation. For details, please refer to the math
menu of the oscilloscope as shown below.
The MATH_VERT_POS command sets the
vertical position of the math waveform with
specified source.
The FFT waveform isn‘t included, but we have
another command which called FFTP to set
vertical position.
The MATH_VERT_POS? query returns the
vertical position of the math waveform.
MATH_VERT_POS <point>
<point>:= -255 to 255.
Note:
The point represents the screen pixels and is
related to the screen center. For example, if the
point is 50. The math waveform will be
displayed 1 grid above the vertical center of the
screen. Namely one grid is 50.
MATH_VERT_POS?
MATH_VERT_POS <point>
When the Math function is on, the following
command sets the vertical position of the math
waveform to 1 grid above the screen vertical
center.
Command message:
The FFT_CENTER command sets the center
frequency when FFT (Fast Fourier Transform) is
selected.
The FFT_CENTER? query returns the current
center frequency of FFT waveform.
FFT_CENTER <center>
<center>:= frequency value with unit (MHz/
kHz/ Hz).
Note:
• If you set the center to a value outside of the
legal range, the center value is automatically set
to the nearest legal value. Legal values are
affected by the Hz/div setting.
• The range for center is related to the
horizontal scale of FFT and varied by models.
See the math menu of oscilloscope as shown
below for details.
QUERY SYNTAX
RESPONSE FORMAT
EXAMPLE
FFT_CENTER?
FFT_CENTER <center>
When the Math function is on, the operator is
FFT, and the horizontal scale is 100 MHz, the
following command sets the center frequency of
FFT to 58 MHz.
Command message:
The FFT_POSITION command sets the vertical
offset of FFT waveform. The unit is related to
the vertical scale type of the current FFT and the
unit of the channel.
The FFT_POSITION? query returns the current
vertical offset of the FFT waveform.
Note:
• This command is only valid when the scale
type is Vrms.
FFT_POSITION <offset>
<offset>:= -24.4*DIV to 15.6*DIV.
Note:
• If there is no unit (V/mV/uV) added, it
defaults to volts (V).
• If you set the offset to a value outside of the
legal range, the center value is automatically set
to the nearest legal value. Legal values are
affected by the Scale setting.
FFT_POSITION?
FFT_POSITION <offset>
<offset>:= Numerical value in E-notation with
SI unit.
• When the Math function is on, the operator is
FFT, and the scale is 10 mV, the following steps
set the offset of FFT waveform to 28 mV.
Step 1: Send command to set the scale unit to
Vrms.
The FFT_SCALE command sets the vertical
scale of FFT waveform. The unit is related to the
vertical scale type of the current FFT and the
unit of the channel.
The FFT_SCALE? query returns the current
vertical scale of FFT waveform.
FFT_SCALE <scale>
<scale>:={0.1,0.2,0.5,1,2,5,10,20} when scale
type is dBVrms or dBm.
<scale>:={0.001,0.002,0.005,0.01,0.02,0.05,0.1,
0. 2,0.5,1, 2,5,10,20} when scale type is Vrms.
FFT_SCALE?
FFT_SCALE <scale>
<scale>:= Numerical value in E-notation with
SI unit.
• When the Math function is on, and the
operator is FFT, the following steps set the
vertical scale of FFT to 5 dBVrms.
Step 1: Send command to set the scale unit to
dBVrms.
Command message:
FFTU DBVRMS
Step 2: Send command to set the scale to 5.
Command message:
FFTS 5
• When the Math function is on, and the
operator is FFT, the following steps set the
vertical scale of FFT to 100 mVrms.
Step 1: Send command to set the scale unit to
Vrms.
The table below shows the availability of command in each oscilloscope series.
ModelValid?
T3DSO2000no
T3DSO1000(A)yes
The FFT_UNIT command sets the vertical scale
type of FFT (Fast Fourier Transform algorithm).
The FFT_UNIT? query returns the current
vertical scale type of FFT waveform.
FFT_UNIT <unit>
<unit>:={VRMS,DBM,DBVRMS}
FFT_UNIT?
FFT_ UNIT <unit>
For T3DSO1000(A) series, when the Math
function is on, and the operator is FFT, the
following command sets the vertical scale unit of
FFT to dBVrms.
Command message:
The FFT_WINDOW command allows the
selection of five different windowing transforms
or operations for the FFT (Fast Fourier
Transform) function. Each window is useful for
certain classes of input signals.
The FFT_WINDOW? query returns the current
window of FFT.
• RECT — Rectangle is useful for transient
signals, and signals where there are an integral
number of cycles in the time record.
• BLAC — Blackman reduces time resolution
compared to the rectangular window, but it
improves the capacity to detect smaller impulses
due to lower secondary lobes (provides minimal
spectral leakage).
• HANN — Hanning is useful for frequency
resolution and general purpose use. It is good for
resolving two frequencies that are close together,
or for making frequency measurements.
• HAMM — Hamming.
• FLAT — Flattop is the best for making
accurate amplitude measurements of frequency
peaks.
FFT_WINDOW?
FFT_WINDOW <window>
When the Math function is on, and the operator
is FFT, the following command sets the FFT
window to Hamming.
Command message:
The CYMOMETER? query measures and
returns the frequency counter of the specified
source. The counter measurement counts the
trigger level crossings at the selected trigger
slope and displays the results in MHz/kHz/Hz.
In the following picture, the content of the red
box is the measured value of the cymometer.
CYMOMETER?
CYMOMETER <freq>
ModelFormat of <freq>
T3DSO1000(A)
othersNumericalvalue
Numericalvalue
in E-notationwith
SI unit, such as
1.00E+03Hz.
withmeasurement
unit and physical
unit,suchas
1.00001kHz.
Note:
When the signal frequency is less than 10 Hz, it
Returns 10 Hzǁ or <10Hzǁ .
The phase difference
between two channels.
(rising edge - rising edge)
Delay between two
channels.
(first rising edge - first
rising edge)
Delay between two
channels.
(first rising edge - first
falling edge)
Delay between two channels.
(first falling edge - first
rising edge)
FFF
LRR
Delay between two channels.
(first falling edge - first
falling edge)
Delay between two channels.
(First rising edge - last rising