Professional Documents
Culture Documents
Programmer
*P077044403*
077-0444-03
xx TBS1000B/EDU, TBS1000, TDS2000C/TDS1000C-EDU,
TDS2000B/TDS1000B, TDS2000/TDS1000, TDS200 and
TPS2000B/TPS2000 Series Digital Oscilloscopes
ZZZ
Programmer
Contacting Tektronix
Tektronix, Inc.
14150 SW Karl Braun Drive
P.O. Box 500
Beaverton, OR 97077
USA
Getting Started
Getting Started .................................................................................................... 1-1
Programming Examples
Programming Examples ......................................................................................... 4-1
Appendices
Appendix A: ASCII Code Chart ............................................................................... A-1
Appendix B: Factory Setup..................................................................................... B-1
TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series Oscilloscopes..... B-1
TPS2000 Series Oscilloscopes ............................................................................ B-2
TPS2000B Series Oscilloscopes .......................................................................... B-4
TDS1000 and TDS2000 Series Oscilloscopes........................................................... B-5
TDS210 and TDS220 Oscilloscopes ..................................................................... B-7
TDS224 Oscilloscopes ..................................................................................... B-8
Appendix C: Reserved Words .................................................................................. C-1
Glossary
Related Documents
Each series of oscilloscopes has a different set of documentation.
TPS2000 and TPS2000B For general operation, refer to your product user manual, a standard accessory,
Series Manuals listed in the following table.
TDS1000, TDS2000, For general operation, refer to the user manual for your product. For information
TDS1000C-EDU, and on the TDS2CMA Communications module, refer to the TDS1000 and TDS2000
TDS2000C Series manuals Series Digital Storage Oscilloscope User Manual.
TDS200 Series Manuals For general operation, refer to the TDS200 Series Digital Real-Time Oscilloscope
User Manual, a standard accessory.
Service Manuals (English For information on how to service your oscilloscope, refer to the appropriate
Only) manual from the following optional accessories:
TBS1000B/EDU Series Digital Storage Oscilloscopes Service Manual
(077-0897-XX)
TBS1000 Series Digital Storage Oscilloscopes Service Manual
(077-0772-XX)
TDS2000C and TDS1000C-EDU Series Digital Storage Oscilloscopes Service
Manual (077-0446-XX)
TDS1000B and TDS2000B Series Digital Storage Oscilloscopes Service
Manual (077-0356-XX)
TDS1000 and TDS2000 Series Digital Storage Oscilloscopes Service Manual
(071-1076-XX)
TDS200 Series Digital Real-Time Oscilloscopes Service Manual
(071-0492-XX)
TPS2000B Series Digital Storage Oscilloscopes Service Manual
(077-4447-XX)
TPS2000 Series Digital Storage Oscilloscopes Service Manual
(071-1465-XX) or (077-0306-00)
Conventions
Refer to Command Syntax for information about command conventions. (See
page 2-1.)
This manual uses the following conventions:
References to the TDS2CMA Communications Extension Module include the
TDS2CM and TDS2CMAX modules.
Command descriptions list specific oscilloscopes series (and modules) when
commands are valid for only those products
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.
Refer to your oscilloscope user manual for information on how to install, test, and
configure your oscilloscope and module.
TDS2CM,
TDS2CMA or
Series TDS2CMAX TDS2MM TDS2MEM TEK-USB-488
TDS200 Yes Yes No No
TDS1000 or Yes No Yes 1 No
TDS2000
TBS1000B/EDU, No No No Yes
TBS1000,
TDS2000C,
TDS1000C-EDU,
TDS1000B or
TDS2000B
TPS2000 or No No No No
TPS2000B 2
1 TDS1001 and TDS2004 models are not compatible with the TDS2MEM module.
2 RS-232 is included in the oscilloscope firmware.
Command Syntax
Table 2-1: Oscilloscope communication protocol
Model or option GPIB RS-232 USB
TDS2CM, Yes Yes No
TDS2CMA,
TDS2CMAX
TDS2MM Yes Yes No
TDS2MEM No Yes No
TDS1000 or Yes 1 Yes 1 2 No
TDS2000
TBS1000B/EDU, Yes 3 No Yes
TBS1000,
TDS2000C,
TDS1000C-EDU,
TDS1000B, or
TDS2000B
TPS2000B, No Yes No
TPS2000
1 Function available with a TDS2CM, TDS2CMA, or TDS2CMAX module.
2 Function available with a TDS2MEM module.
3 Function available with a TEK-USB-488 adapter.
Commands Commands cause the oscilloscope to perform a specific function or change one of
its settings. Commands have the structure:
[:]<Header>[<Space><Argument>[<Comma><Argument>]...]
A command header is made up of one or more 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:
[:]<Header>
[:]<Header>[<Space><Argument>[<Comma><Argument>]...]
You can specify a query command at any level within the command tree unless
otherwise noted. These branch queries return information about all the mnemonics
below the specified branch or level.
For example, MEASUrement:MEAS<x>:UNIts? returns the measurement
units, while MEASUrement:MEAS<x>:TYPe? returns the measurement type
selected for the measurement, and MEASUrement:MEAS<x>? returns all the
measurement parameters for the specified measurement.
Headers in Query You can control whether the oscilloscope returns headers as part of the query
Responses 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.
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.
Command Entry
Follow these general rules when entering commands:
Enter commands in upper or lower case.
You can precede any command with white space characters. White space
characters include any combination of the ASCII control characters 00 through
09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal).
The oscilloscope ignores commands that consists of just a combination of
white space characters and line feeds.
Abbreviating Commands You can abbreviate many oscilloscope commands. These abbreviations are shown
in capital letters in the command listing in the Command Groups section and
Command Descriptions section. For example, the command ACQuire:NUMAvg
can be entered simply as ACQ:NUMA or acq:numa.
If you use the HEADer command to have command headers included as part
of query responses, you can 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:
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
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
Never precede a star (*) command with a colon or semicolon:
ACQuire:MODe AVErage;*TRG
The oscilloscope processes commands that follow the star command as if
the star command was not there, so:
ACQuire:MODe AVErage;*TRG;NUMAVg 16
sets the acquisition mode to average and sets acquisition averaging to 16. The
*TRG command is ignored.
When you concatenate queries, the responses to all queries are combined into
a single response message. For example, if channel 1 coupling is set to DC
and the bandwidth is set to 20 MHz, the concatenated query:
CH1:COUPling;BANdwidth
returns CH1:COUPLING DC;:CH1:BANDWIDTH ON if header is on, or
DC;ON if header is off.
You can concatenate set commands and queries in the same message. For
example:
ACQuire:MODe AVErage;NUMAVg;STATE
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.
Any query that returns arbitrary data, such as ID, must be the last query when
part of a concatenated command. If the query is not last, the oscilloscope
generates event message 440.
Here are some INVALID concatenation examples:
CH1:COUPling DC;ACQuire:NUMAVg 16 (missing colon before ACQuire)
CH1:COUPling DC;:BANDwidth ON (invalid colon before BANDwidth)
CH1:COUPling DC;:*TRG (invalid colon before a star (*) command)
Message Terminators This manual uses the term <EOM> (End of message) to represent a message
terminator.
GPIB End of Message (EOM) Terminators. GPIB EOM terminators can be the
END message (EOI asserted concurrently with the last data byte), the ASCII
code for line feed (LF) sent as the last data byte, or both. The oscilloscope
always terminates messages with LF and EOI. White space is allowed before the
terminator; for example, CR LF is acceptable.
USB End of Message (EOM) Terminators. The EOM bit must be set in the USB
header of the last transfer of a command message
See the USB Test and Measurement Class 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.
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<x>.
Symbol Meaning
CH<x> 2-channel models: A channel specifier; <x> is 1 or 2.
4-channel models: A channel specifier; <x> is 1, 2, 3, or 4.
Reference Waveform Commands can specify the reference waveform to use as a mnemonic in the
Mnemonics header.
Symbol Meaning
REF<x> 2-channel models: A reference waveform specifier; <x> is A or B.
4-channel models: A reference waveform specifier; <x> is A, B, C,
or D.
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
<wfm> Can be CH<x>, MATH, or REF<y>
Cursor Position Mnemonic When the oscilloscope displays cursors, commands may specify which cursor
of the pair to use.
Symbol Meaning
POSITION<x> A cursor selector;<x> is 1 or 2.
Measurement Specifier Commands can specify which measurement to set or query as a mnemonic in the
Mnemonics header. The oscilloscope can display up to four (TDS200) or five (TBS1000,
TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000,
TPS2000B, and TPS2000) or six (TBS1000B/EDU) automated measurements.
Symbol Meaning
MEAS<x> A measurement specifier; <x> is 1-4 (TDS200) or 1-5 (TBS1000,
TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000,
TDS1000, TPS2000B, and TPS2000) or 1-6 (TBS1000B/EDU).
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.
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.
Quoted String Arguments Some commands accept or return data in the form of a quoted string, which is
simply a group of ASCII characters enclosed by single quotes (') or double quotes
("). For example:
"this is a quoted string"
Symbol Meaning
<QString> Quoted string of ASCII text
Acquisition Commands
Acquisition commands affect the acquisition of waveforms. These commands
control mode, averaging, and single-waveform acquisition.
Cursor Commands
Cursor commands provide control over the oscilloscope cursor display and
readout.
Display Commands
Display commands let you change the graticule style, displayed contrast, and
change other display attributes.
File System Conventions Use the following conventions when specifying file paths and file names:
The default folder (directory) for non-TBS1000B/EDU models is A:\.
The default folder (directory) for TBS1000B/EDU models is /usb0/.
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.
Wild card characters (*, %, ) are not valid characters in file or path names.
Lists the Windows-generated short file and folder names for long file or folder
names created on PC Windows operating systems.
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.
Math Commands
Math commands provide math function definition.
Measurement Commands
Measurement commands control the automated measurement system. The
oscilloscope can display up to four (TDS200) or five (TBS1000, TDS2000C,
TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and
TPS2000) or six (TBS1000B/EDU) automated measurements. In the commands,
these measurement readouts are named MEAS<x>, where <x> can be 1, 2, 3, or
4 (or 5 for TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B,
TDS2000, TDS1000, TPS2000B, and TPS2000) (or 6 for the TBS1000B/EDU).
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.
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.
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-23: Power and Battery-Related commands (TPS2000B and TPS2000 only)
Command Description
POWer? Return all power parameters
POWer:AC:PRESENt? Return whether the oscilloscope is being
powered by battery or AC
POWer:BATTERY<x>:GASgauge? Return the charge remaining in battery x
POWer:BATTERY<x>: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
Only certain oscilloscope models are compatible with RS-232. (See Table 2-1
on page 2-1.)
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.
Vertical Commands
Vertical commands control the attributes of the channels. The SELect:<wfm>
command also displays a specified waveform or removes it from the display.
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.
Refer to the text following this table for more information about waveform
commands.
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:
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
If receiving data, the oscilloscope truncates the data (divides by 256) and
saves the most significant byte
The oscilloscope can transfer waveform data in either ASCII or binary format.
Use the DATa:ENCdg command to specify one of the following formats:
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<space>-110,-109,-110,-110,-109,-107,-109,-107,
-106,-105,-103,-100,-97,-90,-84,-80
Binary data can be represented by signed integer or positive integer values.
The range of the values depends on the byte width specified.
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.
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
part 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 The DATa:SOUrce command specifies the location of the data when transferring
and Memory Allocation 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.
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 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 transfer times depend on data format, data width, and the speed of the
Data controller. (See page 4-1, Programming Examples.)
Manual Conventions
This manual uses the following conventions:
No query form exists for commands identified as "No Query Form"
A question mark (?) appended to the command and "Query Only" indicates
query-only commands
Headers,, mnemonics, and arguments are fully spelled out, with the minimal
spelling shown in upper case. For example, to use the abbreviated form of the
ACQuire:MODe command, just type ACQ:MOD
The syntax of some commands varies, depending on the model of oscilloscope
and extension module you use; differences are noted
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 front-panel TRIG VIEW
button), 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).
Group Acquisition
Syntax ACQuire?
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
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.
NOTE. Any change made when in Average mode aborts the acquisition and resets
ACQuire:NUMACq to zero.
TDS200: changing the vertical position does not reset the value
TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B,
TDS1000B, TDS2000, TDS1000, TPS2000B, 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
Group Acquisition
Syntax ACQuire:NUMACq?
Returns <NR1>
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
Arguments <NR1> is the number of waveform acquisitions. Correct values are 4, 16, 64,
and 128.
Examples ACQUIRE:NUMAVG 16 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.
Group Acquisition
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 the acquisition system is
running.
ACQuire:STOPAfter
Tells the oscilloscope when to stop taking acquisitions.
Group Acquisition
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.
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.
Syntax ALLEv?
Related Commands *CLS, DESE, *ESE, *ESR?, EVENT?, EVMsg?, EVQty?, *SRE, *STB?
<Event Code><Comma><QString>[<Comma><Event
Code><Comma><QString>...]
<QString>::= <Message>;[<Command>]
<Command> 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 <Message>
and <Command> strings combined. The command string is right-justified.
Group Miscellaneous
Syntax AUTORange
AUTORange:STATE
Toggles Autorange off and on.
Group Miscellaneous
AUTORange:SETTings
Controls the parameters that the Autorange function can adjust. It is equivalent to
the option buttons in the Autorange menu.
Group Miscellaneous
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.
Group Miscellaneous
AUTOSet:ENABLE
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 your product service manual.
Group Miscellaneous
Syntax AUTOSet:ENABLE
Group Miscellaneous
Syntax AUTOSet:SIGNAL?
Group Miscellaneous
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.
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.
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 will display video signals synchronized on even fields
when operated in autoset mode.
Syntax BUSY?
Returns <NR1> = 0 means the oscilloscope is not busy processing a command whose
execution time is extensive.
<NR1> = 1 means the oscilloscope is busy processing a command whose execution
time is extensive. (See Table 3-3 on page 3-7.)
Examples BUSY? might return :BUSY 1 indicating that the oscilloscope is now busy.
NOTE. The self-calibration can take several minutes to complete. During this
time, the oscilloscope does not execute any commands.
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.
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 nonvolatile memory.
Syntax CALibrate:ABOrt
Syntax CALibrate:CONTINUE
Syntax CALibrate:FACtory
NOTE. The self-calibration can take several minutes to complete. During this
time, the oscilloscope does not execute any commands.
Syntax CALibrate:INTERNAL
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 on.
Group Vertical
Syntax CH<x>?
Examples CH1? might return the following string for channel 1: CH1:SCALE
1.0E0;POSITION 0.0E0; COUPLING DC;BANDWIDTH OFF;PROBE 1.0E0
CH<x>:BANdwidth
Sets or queries the bandwidth setting of the specified oscilloscope channel. The
value of <x> 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
OFF sets the channel bandwidth to the full bandwidth of the oscilloscope.
CH<x>:COUPling
Sets or queries the input attenuator coupling setting of the specified oscilloscope
channel. The value of <x> 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
GND sets the specified oscilloscope channel to ground. Only a flat ground-level
waveform is displayed.
CH<x>:CURRENTPRObe
Sets or queries the scale factor of the specified channel for current probes. The
value of <x> 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<x>:YUNit <QString> is set to V. However,
this command only affects the readouts when CH<x>:YUNit <QString> is set
to A.
Group Vertical
Returns <NR1>
CH<x>:INVert
NOTE. You cannot 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 <x> 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
CH<x>:POSition
Sets or queries the vertical position of the specified oscilloscope channel. The
value of <x> 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
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<x>:PRObe
Sets or queries the attenuation factor of the specified channel or voltage probes.
The value of <x> can vary from 1 through 4 for 4-channel instruments or 1
through 2 for 2-channel instruments.
Group Vertical
Returns <NR1>
CH<x>:SCAle
Sets or queries the vertical gain of the specified oscilloscope channel. The value
of <x> 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.
Group Vertical
Arguments <NR3> 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.
CH2:SCALE? might return 1.0E0 , indicating that the current V/div setting of
channel 2 is 1 V/div.
CH<x>:VOLts
Sets or queries the vertical gain of the specified channel. The value of <x> 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<x>:SCAle command and is included for
compatibility purposes. Only CH<x>:SCAle is returned in response to a CH<x>?
query.
Group Vertical
Syntax CH<x>:VOLts
CH<x>:YUNit
Sets or queries the units of the specified channel. The value of <x> can vary from
1 through 4 for 4-channel instruments or 1 through 2 for 2-channel instruments.
Group Vertical
Arguments <QString> 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.
Syntax *CLS
Group Counter
Syntax COUNTERFreq?
COUNTERFreq:CH1Level
Sets or queries the CH1 trigger level value.
Group Counter
COUNTERFreq:CH1State
Sets or queries the CH1 counter frequency to be on or off.
Group Counter
Examples COUNTERFreq:CH1State OFF turns off the CHQ counter frequency feature.
Group Counter
Syntax COUNTERFreq:CH1Value?
COUNTERFreq:CH2Level
Sets or queries the CH2 trigger level value.
Group Counter
COUNTERFreq:CH2State
Sets or queries the CH2 counter frequency to be on or off.
Group Counter
Group Counter
Syntax COUNTERFreq:CH2Value?
Group Cursor
Syntax CURSor?
Examples CURSOR? 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
Arguments HBArs specifies horizontal bar cursors that measure the vertical units in volts,
amps, divisions, or decibels.
OFF removes cursors from the display.
Group Cursor
Syntax CURSor:HBArs?
NOTE. If Trigger View is active, this query returns 9.9E37 and generates event
221 (Settings conflict).
Group Cursor
Syntax CURSor:HBArs:DELTa?
Returns <NR3>
Examples CURSOR:HBARS:DELTA? might return 5.08E0 for the difference between the
two cursors.
CURSor:HBArs:POSITION<x>
Positions a horizontal bar cursor. The value of <x> 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
Arguments <NR3> 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.
Group Cursor
Syntax CURSor:HBArs:UNIts?
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
Arguments <wfm> specifies the waveform data source on which cursor measurements will
be taken.
Group Cursor
Syntax CURSor:VBArs?
NOTE. If Trigger View is active, this query returns 9.9E37 and generates event
221 (Settings conflict).
Group Cursor
Syntax CURSor:VBArs:DELTa?
Returns <NR3>
NOTE. If Trigger View is active, this query returns 9.9E37 and generates event
221 (Settings conflict).
Group Cursor
Syntax CURSor:VBArs:HDELTa?
Returns <NR3>
Group Cursor
Syntax CURSor:VBArs:HPOS<x>?
Examples CURSOR:VBARS:HPOS1? might return 1.37, indicating the value of one vertical
bar tic.
CURSor:VBArs:POSITION<x>
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
Arguments <x> specifies which cursor to position. Correct values are 1 and 2.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Group Cursor
Syntax CURSor:VBArs:SLOPE?
CURSor:VBArs:UNIts
Sets or queries the units for the vertical bar cursors.
Group Cursor
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.
Group Cursor
Syntax CURSor:VBArs:VDELTa?
Returns <NR3> indicates the vertical difference between the two vertical bar cursors.
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?. 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.
In Scan Mode (Sec/div ≥100 ms and AUTO Mode), approximately one division
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.
Group Waveform
Arguments <Block> is the waveform data in binary format. The waveform is formatted as:
#<x><yyy><data> where <x> is the number of characters in <yyy>. For example,
if <yyy> = 500, then <x> = 3, where <yyy> is the number of bytes to transfer.
Refer to Block Arguments
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. <data> is the curve data.
<asc curve> is the waveform data in ASCII format. The format for ASCII data
is <NR1>[,<NR1>...] where each <NR1> represents a data point.
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
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
Arguments INIT reinitializes the waveform data settings to their factory defaults.
Examples DATA INIT reinitializes the waveform data settings to their factory defaults:
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
Arguments REF<x> is the reference memory location where the waveform will be stored.
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. (See
Table 2-35.)
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
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.
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.
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
Arguments <wfm> is the location of the waveform data that will be transferred from the
oscilloscope to the external device. Allowable values are CH<x>, MATH, and
REF<x>. For TBS1000B/EDU models, FFT is also permitted.
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.
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
Arguments <NR1> is an integer value that ranges from 1 to 2500, and specifies the first data
point that will be transferred. Data is transferred from <NR1> 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? might return 214 as the first waveform data point that will be
transferred.
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
Arguments <NR1> 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.
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.
Group Waveform
Syntax DATa:TARget
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
Arguments <NR1> = 1 sets the number of bytes per waveform data point to 1 byte (8 bits).
<NR1> = 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.
NOTE. Data Logging features are available only on TBS1000B, TBS1000 and
TDS2000C Series models.
Syntax DATALOGging?
DATALOGging:DURAtion
Sets the duration of the data logging, in minutes.
NOTE. Data Logging features are available only on TBS1000B, TBS1000 and
TDS2000C Series models.
Syntax DATALOGging:DURAtion 30, 60, 90, 120, 150, 180, 210, 240,
270, 300, 330, 360, 390, 420, 450, 480, 540, 600, 660, 720,
780, 840, 900, 960, 1020, 1080, 1140, 1200, 1260, 1320,
1380, 1440, Infinite.
DATALOGging:DURAtion?
Arguments { 30 | 60 | 90 | 120 | 150 | 180 | 210 | 240 | 270 | 300 | 330 | 360 | 390 | 420 | 450 |
480 | 540 | 600 | 660 | 720 | 780 | 840 | 900 | 960 | 1020 | 1080 | 1140 | 1200 | 1260 |
1320 | 1380 | 1440} is the data logging time period, in minutes.
{Infinite} runs data logging with no set time limit.
Examples DATALOGGING:DURATION 30
enables data logging to last for 30 minutes.
DATALOGging:SOURCE
Sets up the data logging source.
NOTE. Data Logging features are available only on TBS1000B, TBS1000 and
TDS2000C Series models.
DATALOGging:STATE
Turns on or off the data logging feature.
NOTE. Data Logging features are available only on TBS1000B, TBS1000 and
TDS2000C Series models.
Syntax DATALOGging:STATE
DATALOGging:STATE { OFF | ON | 0 | 1 }
Examples DATALOGGING:STATE ON
turns on data logging.
DATE
Sets or queries the oscilloscope date value. The oscilloscope uses these
values to time stamp files saved to the CompactFlash card (TDS2MEM and
TPS2000B/TPS2000 Series only), or to the USB flash drive (TBS1000B/EDU,
TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series
only), as well as show the time and date on the oscilloscope display.
Group Miscellaneous
Group Miscellaneous
Examples *DDT #217ACQuire:STATE RUN<EOI> specifies that the acquisition system will
be started each time a *TRG command is sent.
DESE
Sets and queries the bits in the Device Event Status Enable Register (DESER).
The DESER is the mask that determines whether events are reported to the
Standard Event Status Register (SESR), and entered into the Event Queue. (See
page 3-1, Status and Events.)
Arguments <NR1> 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 section.
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.
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.
Syntax DIAg:RESUlt:LOG?
Group Display
Syntax DISplay?
DISplay:BACKLight
Sets the backlight value.
Group Display
Arguments Sets the display backlight value in percent, as an integer, between 1 and 100.
DISplay:BRIGHTness
Sets or queries the brightness of the LCD display.
Conditions This command applies to the TPS2000 Series and TPS2000B Series only.
Group Display
DISplay:CONTRast
Sets or queries the contrast of the LCD display. This command is equivalent
to setting the Contrast option in the Display menu. The TBS1000B/EDU,
TBS1000, TDS2000C, TDS1000C-EDU, and TDS2000B Series do not support
the DISplay:CONTRast command and the display contrast feature.
Group Display
Arguments <NR1> is an integer in the range from 1 through 100. The larger the value, the
greater the screen contrast.
DISplay:FORMat
Sets or queries the oscilloscope display format. This command is equivalent to
setting the Format option in the Display menu.
Group Display
Syntax DISplay:FORMat { XY | YT }
DISplay:FORMat?
Arguments XY displays the voltage of channel 1 (horizontal axis) against the voltage of
channel 2 (vertical axis).
NOTE. Setting the display format to XY turns cursors off. 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.
YT sets the display to vertical values versus time format and is the default mode.
Examples DISPLAY:FORMAT YT selects a voltage versus time format for the display.
DISplay:INVert
Sets or queries the TDS1000B and TDS1000 display format. This command is
equivalent to setting the Display Style option in the Utility Options menu for
the TDS1000B and TDS1000 Series.
The TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B,
TDS2000, TPS2000B, and TPS2000 Series do not have a Display Style option,
but accept the DISplay:INVert command and query for compatibility. The query
always returns OFF.
The TDS200 Series is not supported.
Group Display
DISplay:PERSistence
Sets the length of time that data points are displayed.
Group Display
Arguments 1|2|5 specifies the length, in seconds, that the waveform points are displayed
on the screen.
INF specifies infinite persistence.
DISplay:STYle
Selects how to display the waveform data. This command is equivalent to setting
the Type option in the Display menu.
Group Display
Examples DISPLAY:STYLE VEC sets the display to connect adjacent data points.
DISPLAY:STYLE might return DOTS indicating that the display shows individual
waveform data points.
Syntax ERRLOG:FIRST?
Returns Refer to the service manual for your oscilloscope for information about error log
message format.
Syntax ERRLOG:NEXT?
Returns Refer to the service manual for your oscilloscope for information about error log
message format.
Arguments <NR1> is a value in the range from 0 through 255. The binary bits of the ESER
are set according to this value.
The power-on default for ESER is 0 if *PSC is 1. If *PSC is 0, the ESER
maintains its value through a power cycle.
NOTE. Setting the DESER and the 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 DESE command to set the DESER. (See
page 3-5, Event Handling Sequence.)
Examples *ESE 209 sets the ESER to binary 11010001, which enables the PON, URQ,
EXE, and OPC bits.
*ESE might return the string *ESE 186, showing that the ESER contains the
binary value 10111010.
Syntax *ESR?
Related Commands ALLEv?, *CLS, DESE, *ESE, EVENT?, EVMsg?, *OPC, *SRE
Examples *ESR? might return the value 213, showing that the SESR contains binary
11010101.
Syntax EVENT?
Returns <NR1>
Examples EVENT? might return EVENT 110, indicating there was an error in a command
header.
Syntax EVMsg?
<QString>::= <Message>;[<Command>]
where <Command> 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
as possible is returned without exceeding the 60 character limit of the <Message>
and <Command> strings combined. The command string is right-justified.
Examples EVMSG? might return the message EVMSG 110, "Command header error"
Syntax EVQty?
Returns <NR1>
Examples EVQTY? might return 3 as the number of event codes in the Event Queue.
FACtory
Resets the oscilloscope to its factory default settings. Refer to Appendix B:
Factory Setup for a list of the factory default settings.
Group Miscellaneous
Syntax FACtory
Setting the oscilloscope to factory default has the following impact on the
programming interface:
Clears the Event Status Enable Register
Clears the Service Request Enable Register
Sets the Device Event Status Enable Register to 255
Sets the Power On Status Clear Flag to TRUE
Enables all Command Headers (HEADer ON)
Sets the macro defined by *DDT to a "zero-length field"
Clears the pending operation flag and associated operations
Performs the equivalent of DATA INIT
The FACtory command does not change the following items:
State of the RS-232, GPIB, or USB interface
Selected GPIB address
Front panel LOCK state
Verbose state
Display Brightness, TPS2000 Series and TPS2000B Series only
Display Contrast, TDS1000, TDS2000, TDS1000B, and TPS2000 Series
Calibration data that affects device specifications
Stored settings
Stored waveforms or data
Hard copy parameters
Display messages language selection
Current page of paged menus
SAVE:IMAGE:FILEFORMAT
FILESYSTEM:CWD
Syntax FILESystem?
FILESystem:CWD
Sets or queries the current working folder path on the CompactFlash card
(TDS2MEM and TPS2000B/TPS2000 Series only), or on the USB flash drive
(TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and
TDS1000B Series only).
Arguments <folder path> is a quoted string that defines the folder name and path. The root
folder is A:\ for non-TBS1000B/EDU models and is /usb0/ for TBS1000B/EDU
models. If there is no CompactFlash card or USB flash drive installed in the
oscilloscope, the query returns a null string. This command is the easiest way for
a program to check for the presence of a CompactFlash card or a USB flash drive.
Arguments <file path> is a quoted string that defines the folder path and file name of the
file to delete. The root directory is “A:\” for non-TBS1000B/EDU models and
is “/usb0/” for TBS1000B/EDU models. You cannot use an asterisk (*) wild
card character to delete multiple files. For example, FILESYSTEM:DELETE
"A:\PROD-TST\*.SET" is not valid for non-TBS1000B/EDU models.
Also, FILESYSTEM:DELETE "/usb0/PROD-TST/*.SET" is not valid for
TBS1000B/EDU models.
Syntax FILESystem:DIR?
Arguments <drive> is a quoted string that sets the CompactFlash card (TDS2MEM and
TPS2000B/TPS2000 Series only), or the USB flash drive (TBS1000B/EDU,
TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B and TDS1000B Series only)
to format. Valid non-TBS1000B/EDU drive values are "A:" and "a:". The valid
TBS1000B/EDU drive value is "/usb0/". Using any other drive value returns
an error.
NOTE. The oscilloscope reads the internal structure of the CompactFlash card or
the USB flash drive every time the card is inserted. The time to complete the read
depends on the size of the card and how it was formatted. To significantly shorten
the initial read time of 64 MB and larger cards, format the card or flash drive as
FAT32 with your personal computer.
Syntax FILESystem:FREESpace?
Arguments <folder path> is a quoted string that defines the location and name of the
folder to create. If you do not specify a path to the folder, the oscilloscope creates
the folder in the current working directory. The current directory refers to the
name of a folder as returned by the FILESystem:CWD query.
Folder names must follow the same rules as file names. (See page 2-16, File
System Conventions.)
Arguments <old filepath> is a quoted string that defines the path and name of the file
to rename. If you do not specify a path to the file, the oscilloscope looks for the
file in the current working folder. The current directory refers to the name of a
folder as returned by the FILESystem:CWD query.
<new filepath> is a quoted string that defines the path and new name of the
file. If you do not specify a path to a folder, the oscilloscope places the renamed
file into the current working folder. (See page 2-16, File System Conventions.)
Arguments <folder path> is a quoted string that defines the location and name of the
folder to delete. If you do not specify a path to the folder, the oscilloscope deletes
the specified folder in the current working folder. The current folder refers to the
name of a folder as returned by the FILESystem:CWD query.
Group FFT
Syntax FFT?
FFT:HORizontal:POSition
Sets or queries the FFT horizontal display position.
Group FFT
FFT:HORizontal:SCAle
Sets or queries the FFT zoom factor.
Group FFT
FFT:SOURce
Sets or queries the FFT source.
Group FFT
FFT:SRCWFM
Sets or queries the FFT source waveform display state.
Group FFT
FFT:VERtical:POSition
Sets or queries the FFT vertical display position.
Group FFT
FFT:VERtical:SCAle
Sets or queries the FFT vertical zoom factor.
Group FFT
FFT:WIN
Sets or queries the FFT window state.
Group FFT
HARDCopy
Sends a copy of the screen display followed by an EOI to the port specified by
HARDCopy:PORT. The format and layout of the output is specified with the
HARDCopy:FORMat and HARDCopy:LAYout commands. This command
is equivalent to pressing the PRINT button on the front panel of the TBS1000,
TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000,
TPS2000B, and TPS2000 Series or the HARDCOPY button on the front panel
of the TDS200 Series.
NOTE. DCL does not clear the output queue once a hard copy is in process.
The only way to abort the hard copy process is to send the HARDCopy ABOrt
command. The output queue can then be cleared by sending a DCL message.
STARt initiates a screen copy that is sent to the port specified by the
HARDCOPY:PORT command.
NOTE. Use the *WAI command between HARDCopy STARt commands to make
sure that the first hard copy is complete before starting another.
Examples HARDCOPY ABORT stops any hard copy output that is in process.
HARDCopy:BUTTON
Sets or returns the current PRINT front-panel button function.
NOTE. This command does not affect the HARDCopy STARt command.
Arguments PRINTS sets the PRINT button to send the screen image to the current printer
port, using the current printer format.
SAVESAll sets the PRINT button to save all active oscilloscope information
(waveforms, screen image, settings) to files in a new subfolder in the current
CompactFlash card folder (TDS2MEM and TPS2000B/TPS2000 Series only), or
in the current USB flash drive folder (TBS1000B/EDU, TBS1000, TDS2000C,
TDS1000C-EDU, TDS2000B, and TDS1000B Series only).
SAVESImage sets the PRINT button to save the screen image to a file on the
CompactFlash card or on the USB flash drive.
HARDCopy:FORMat
Sets the hard copy output data format. This command is the same as setting the
Format option in the UTILITY > Options > Hard Copy or Printer Setup menu,
depending on your oscilloscope model.
Arguments BMP (non-TBS1000B/EDU Series only) sets the hard copy output format to
Microsoft Windows Bitmap format.
BUBBLEJet (TDS1000, TDS2000, TPS2000, and TPS2000B Series only) sets the
hard copy output format to Canon Bubblejet format.
DESKjet (TDS200, TDS1000, TDS2000, TPS2000, and TPS2000B Series only)
sets the hard copy output format to HP DeskJet format.
DPU3445 (TDS1000, TDS2000, TPS2000, and TPS2000B Series only), DPU411,
and DPU412 set the hard copy output format to Seiko formats.
EPSC60 sets the hard copy output to Epson C60 model printer format. Available
on TDS1000 and TDS2000 models with firmware versions 2.12 or greater
(two channel models) or 4.12 or greater (four channel models), any firmware
version with a TDS2CMA, TDS2CMAX, or TDS2MEM module installed, or the
TPS2000B/TPS2000 Series.
EPSC80 sets the hard copy output to Epson C80 model printer format. Available
on TDS1000 and TDS2000 series models with firmware versions 2.12 or greater
(two channel models) or 4.12 or greater (four channel models), any firmware
version with a TDS2CMA, TDS2CMAX, or TDS2MEM module installed, or the
TPS2000B/TPS2000 Series.
EPSIMAGE (non-TBS1000B/EDU Series only) sets the hard copy format data to
Postscript format.
EPSOn (TDS2000, TDS1000, TDS200, TPS2000B, and TPS2000 Series only)
sets the hard copy output format to 9-pin or 24-pin dot matrix printer format.
INTERLEAF (TDS200 Series only) sets the hard copy format data to Interleaf
file format.
JPEG (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B,
and TDS1000B Series only) sets the hard copy format to JPEG format.
LASERJet (TBS1000, TDS1000C-EDU, TDS2000, TDS1000, TDS200,
TPS2000B, and TPS2000 Series only) sets the hard copy output format to HP
LaserJet II printer format.
PCX (non-TBS1000B/EDU) sets the hard copy output format to DOS Paintbrush
format.
RLE (TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B,
TDS2000, TDS1000, TPS2000B, and TPS2000 Series only) sets the hard copy
output format to Windows color image file format (*.RLE). Use RLE for faster
transfer rates and smaller resulting files. Many programs that recognize .BMP
files also recognize .RLE files.
THINKjet (TDS2000, TDS1000, TDS200, TPS2000B, and TPS2000 Series only)
sets the hard copy output format to HP Thinkjet printer format.
TIFF (TDS2000, TDS1000, TPS2000B, and TPS2000 Series only) sets the hard
copy output format to Tagged Image File Format.
Examples HARDCOPY:FORMAT LASERJET sets the hard copy output format to LaserJet II.
HARDCopy:INKSaver
Sets the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B,
TDS1000B, TDS2000, TPS2000B, and TPS2000 Ink Saver feature to on or off.
This command is equivalent to setting the Ink Saver option in the UTILITY
> Options > Printer Setup menu of TBS1000B/EDU, TBS1000, TDS2000C,
TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TPS2000B, and TPS2000
oscilloscopes. This command has no effect on the TDS1000 oscilloscope, but
is accepted for compatibility.
Arguments OFF prints "WYSIWYG" hard copies, with color waveforms on a black
background.
ON (default) prints color waveforms on a white background.
HARDCopy:LAYout
Selects the printing orientation. This command is equivalent to setting the Layout
option in the UTILITY > Options > Hard Copy Setup menu.
Arguments LANdscape specifies that the bottom of the hard copy is along the long side
of the piece of paper.
PORTRait specifies that the bottom of the hard copy is along the short side of the
piece of paper. This is the standard format.
Examples HARDCOPY:LAYOUT might return PORTRAIT as the page layout format of the
hard copy output.
HARDCopy:PORT
Selects where to send the hard copy data when the oscilloscope receives the next
HARDCOPY STARt command. This command is equivalent to setting the Port
option in the UTILITY > Options > Hard Copy Setup menu.
Arguments CENtronics specifies that the hard copy data is sent out the Centronics port.
RS232 specifies that the hard copy data is sent out the RS232 port. If you set the
port to RS232, and use it to transfer a BMP screen image format file to a PC or
other computer, observe the following precaution that the BMP file is a binary
file, and therefore does not use line feeds (hexadecimal 0a) as a terminator.
There are two ways to work around this limitation:
Write your controller program to use the byte count information in the BMP
file header.
Set your RS232 program time out value to a large enough value to guarantee
that the program does not time out before completing the data transfer. For
example, to transfer an 80 kB file at 9600 baud, set the transfer program time
out to 300 seconds.
GPIb specifies that the hard copy data is sent to the GPIB port. This argument is
available on instruments with a TDS2CM, TDSCMA, TDSCMAX, or TDSMM
module installed.
USB specifies that the hard copy data is sent to the USB Device port on the back
of a TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, or
TDS1000B Series oscilloscope only.
Examples HARDCOPY:PORT might return RS232 as the selected hard copy output port.
Syntax HARmonics?
HARmonics:ENABle
Turns the harmonics measurement on or off.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Arguments ON causes the oscilloscope to display the harmonics menu and turn on Harmonics
analysis.
OFF causes the oscilloscope to display the CH1 menu.
Syntax HARmonics:FREquency?
Returns <NR3>
Syntax HARmonics:HRMS?
Returns <NR3>
Syntax HARmonics:PERCent?
Examples HARMONICS:PERCENT? might return 5.0, indicating that the amplitude of the
selected harmonic as a percent of the fundamental frequency is 5.0%.
Syntax HARmonics:PHAse?
Examples HARMONICS:PHASE? might return 45.0, indicating that the phase of the selected
harmonic, relative to the fundamental frequency, is 45 degrees.
Syntax HARmonics:RMS?
Examples HARMONICS:RMS? might return 120.0, indicating that the RMS value is 120
volts RMS.
NOTE. You can view the contents of the saved file on your personal computer. You
cannot recall saved harmonics files to the oscilloscope.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Arguments <file path> specifies the full path to save harmonic measurement data.
Examples HARMONICS:SAVE “A:\data1.CSV" specifies the file name and path to save
harmonic loss measurement data to the oscilloscope CompactFlash card.
HARmonics:SELect
Selects an individual harmonic. If the harmonics function is enabled but the
requested harmonic is not currently on the screen, the oscilloscope will put it
on the screen. If the harmonics function is not enabled, the oscilloscope will
remember the requested value but will not enable the harmonics function.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
HARmonics:SETUp
Sets or queries the operating mode of harmonics measurements.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Arguments MANUAL The oscilloscope does not adjust the setup when entering or exiting the
harmonics measurement mode.
AUTOMATIC The oscilloscope adjusts various settings to optimize the harmonics
display. The oscilloscope returns to your previous settings when you exit the
harmonics measurement mode.
HARmonics:SHOW
Sets or returns the type of displayed harmonics.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
HARmonics:SOUrce
Sets the source in the power menu.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Arguments CH<x> is one of the allowable input channels. The value of <x> can vary from 1
through 4 for 4-channel instruments or 1 through 2 for 2-channel instruments.
Examples HARMONICS:SOURCE CH1 sets the source for the harmonics function to CH1.
Syntax HARmonics:THDF?
Returns <NR3>
Syntax HARmonics:THDR?
Returns <NR3>
HDR
This command is identical to the HEADer query and is included for compatibility
with other Tektronix oscilloscopes.
Group Miscellaneous
Syntax HDR
HEADer
Sets and queries the Response Header Enable State that causes the oscilloscope to
either include or omit headers on query responses. This command does not affect
IEEE Std 488.2-1987 Common Commands (those starting with an asterisk); they
never return headers.
Group Miscellaneous
Arguments ON or <NR1> ≠ 0 sets the Response Header Enable State to true. This causes the
oscilloscope to include headers on applicable query responses. You can then
use the query response as a command.
OFF or <NR1> = 0 sets the Response Header Enable State to false. This causes
the oscilloscope to omit headers on query responses so that only the argument is
returned.
Examples HEADER OFF causes the oscilloscope to omit headers from query responses.
HEADER? might return 1, showing that the Response Header Enable State is true.
Group Horizontal
Syntax HORizontal?
Group Horizontal
Syntax HORizontal:DELay?
HORizontal:DELay:POSition
Sets or queries the window time base horizontal position. This command is
equivalent to adjusting the Horizontal Position when Window Zone or Window
is selected from the Horizontal menu.
Group Horizontal
Arguments <NR3> is the position in seconds. This value is the difference between the trigger
point and the center graticule. Positive values place the trigger before the center
graticule.
HORizontal:DELay:SCAle
Sets the time per division for the oscilloscope window time base. This command
is equivalent to setting SEC/DIV when Window Zone or Window is selected from
the Horizontal menu.
Group Horizontal
Arguments <NR3> is the time per division. The range depends on the oscilloscope model.
The acceptable values are in a 1-2.5-5 sequence. If the window time base scale is
set slower than the main time base scale, both the main and window time base
scales are set to the window scale value.
HORizontal:DELay:SECdiv
This command is identical to the HORizontal:DELay:SCAle. It is provided
to maintain program compatibility with some older models of Tektronix
oscilloscopes.
Group Horizontal
Syntax HORizontal:DELay:SECdiv
Group Horizontal
Syntax HORizontal:MAIn?
HORizontal:MAIn:POSition
Sets or queries the main time base horizontal position. This command is
equivalent to adjusting the Horizontal Position when Main is selected from the
Horizontal menu.
Horizontal
Group Horizontal
Arguments <NR3> is the position in seconds. This value is the difference between the trigger
point and the center graticule. Positive values place the trigger before the center
graticule.
HORizontal:MAIn:SCAle
Sets the time per division for the main time base. This command is equivalent to
setting SEC/DIV when Main is selected from the Horizontal menu.
Group Horizontal
Arguments <NR3> is the time per division. The range depends on the oscilloscope model.
The acceptable values are in a 1-2.5-5 sequence. Other values are forced to the
closest acceptable value.
Examples HORIZONTAL:MAIN:SCALE 2.5E-6 sets the main scale to 2.5 ms per division.
HORizontal:MAIn:SECdiv
Sets the time per division for the oscilloscope main time base. This command is
identical to the HORizontal:MAIn:SCAle command. It is provided to maintain
program compatibility with some older models of Tektronix oscilloscopes.
Group Horizontal
Syntax HORizontal:MAIn:SECdiv
HORizontal:POSition
Sets or queries the main time base horizontal position. This command is identical
to the HORizontal:MAIn:POSition command. This command is included for
compatibility.
Group Horizontal
Arguments <NR3> is the position in seconds. This value is the difference between the trigger
point and the center graticule. Positive values place the trigger before the center
graticule.
Examples HORIZONTAL:POSITION 2.0E-6 sets the main trigger position to 2ms before the
center graticule.
HORIZONTAL:POSITION? might return -1.0E-3, indicating that the main trigger
position is 1 ms after the center graticule.
Group Horizontal
Syntax HORizontal:RECOrdlength?
Returns 2500
HORizontal:SCAle
Sets the time per division for the main time base and is identical to the
HORizontal:MAIn:SCAle command. It is included for compatibility purposes.
Group Horizontal
Syntax HORizontal:SCAle
HORizontal:SECdiv
Sets the time per division for the main time base and is identical to the
HORizontal:MAIn:SCAle command. It is included for compatibility purposes.
Group Horizontal
Syntax HORizontal:SECdiv
HORizontal:VIEW
Specifies whether the horizontal display uses the Main, Window Zone, or Window
view. This is equivalent to setting the View in the Horizontal menu.
Group Horizontal
Arguments MAIn specifies that the waveform is acquired and displayed using the Main time
base.
WINDOW specifies that the waveform is acquired and displayed using the Window
(delay) time base.
ZONE is the same as MAIn, but adds display of vertical cursor bars to show the
part of the waveform that is acquired and displayed using the window (delay)
time base.
NOTE. ID? must be the last command when part of a concatenated statement.
Otherwise the oscilloscope generates event message 440.
Group Miscellaneous
Syntax ID?
Returns Returns the oscilloscope identification in the following format for TDS2CM,
TDS2CMA, and TDS2MM modules:
ID TEK/<model number>,CF:91.1CT,FV:v<oscilloscope firmware version
number>,TDS2XX:XXV:v<module firmware version number>
Where XX is the module type, CM (TDS2CM or TDS2CMA communications
module) or MM (measurement module).
Returns the oscilloscope identification in the following format for TDS2MEM
modules:
Examples ID? might return the following response with a TDS2CMA installed: ID
TEK/TDS 220,CF:91.1CT,FV:V1.00 TDS2CM:CMV:V1.00
NOTE. *IDN? must be the last command when part of a concatenated statement.
Otherwise the oscilloscope generates event message 440.
Group Miscellaneous
Syntax *IDN?
Returns Returns the oscilloscope identification in the following format for TDS2CM,
TDS2CMA, and TDS2MM modules:
Examples *IDN? might return the following response with a TDS2CMA installed: ID
TEKTRONIX,TDS 220,0,CF:91.1CT FV:v2.12 TDS2CM:CMV: v1.04
*IDN? might return the following response for a TPS2022B oscilloscope with
the serial number CU10100: TEKTRONIX,TDS 2022B,CU10100,CF:91.1CT
FV:v20.22
*IDN? might return the following response for a TDS1012B oscilloscope with
the serial number CU010114: TEKTRONIX,TDS 1012B,CU010114,CF:91.1CT
FV:v21.21
LANGuage
Sets or queries the languages that the oscilloscope uses to display information on
the screen. This is equivalent to setting the Language option in the Utility menu.
Group Miscellaneous
Arguments Specifies the language used to display oscilloscope information on the screen.
Examples LANGUAGE FRENch specifies that the oscilloscope displays information in French.
Syntax LIMit?
Examples LIMIT?
asks for all the limit testing parameters.
LIMit:COMpare
Sets or returns the template against which to compare the waveform acquired
through the specified channel. The template can be a waveform saved in any of
the reference locations REF1 through REF4.
Syntax LIMit:RESUlt:FAIL?
Examples LIMIT:RESULT:FAIL?
might return: 25, indicating that 25 test cases were detected as failing.
Syntax LIMit:RESUlt:PASS?
Examples LIMIT:RESULT:PASS?
might return: 25, indicating that 25 test cases were detected as passing.
Syntax LIMit:RESUlt:TOTAL?
Examples LIMIT:RESULT:TOTAL?
might return: 25, indicating that there were 25 test cases detected.
LIMit:SAVEIMAge
Sets or returns whether the oscilloscope should save the screen image to a file on
a limit test failure event. When enabled, this command copies image data from
all active waveforms that have limit test failures to a file on the oscilloscope
flash memory drive.
Arguments OFF or <NR1> = 0 turns off the function to save waveform image data to the flash
drive for limit testing.
ON or <NR1> ≠ 0 turns on the function to save waveform image data to the flash
drive for limit testing.
Examples LIMIT:SAVEIMAGE ON
turns on the function to save waveform image data to the flash drive for limit
testing.
LIMit:SAVEWFM
Sets or returns whether the oscilloscope should save the waveform to a file on a
limit test failure event. When enabled, this command copies waveform data from
all active waveforms that have limit test failures to a file on the oscilloscope
flash memory drive.
Arguments OFF or <NR1> = 0 turns off the function to save waveform data to the flash
drive for limit testing.
ON or <NR1> ≠ 0 turns on the function to save waveform data to the flash drive
for limit testing.
turns off the feature to save the waveform to a file on a limit test failure.
LIMit:SOUrce
Sets or returns the source channel for the waveform currently being compared to
the test template.
Arguments CH<x> specifies that the source channel for the waveform currently being
compared to the test template.
MATH specifies the source channel as the math waveform.
LIMit:STATE
Turns limit testing on or off, or returns whether limit testing is in effect.
LIMit:STOPAfter:MODe
Sets or restores the mode for the limit test stop after feature.
Syntax LIMit:STOPAfter:MODe
{ MANual | WAVEform | VIOLation | TIMe }
LIMit:STOPAfter:MODe?
Arguments MANual causes the test to stop after an operator manually stops it.
WAVEform causes the test to stop after the oscilloscope tests a specified number
of waveforms.
VIOLation causes the test to stop after the oscilloscope detects a violation.
TIMe causes the test to stop after the oscilloscope detects that the preset running
time has elapsed.
Examples LIMIT:STOPAFTER:MODE?
LIMit:STOPAfter:TIMe
Sets or returns the limit test stop after time setting. The limit test will automatically
stop when it reaches the specified time, in seconds.
Examples LIMIT:STOPAFTER:TIME 10
sets the limit test to run for 10 seconds.
LIMit:STOPAfter:VIOLation
Sets or returns the limit test stop after violation setting. The test will automatically
stop after it detects the specified number of violations.
Arguments <NR3> is the number of violations to detect before stopping the limit test.
Examples LIMIT:STOPAFTER:VIOLATION 10
sets the limit test to run until it detects 10 violations.
LIMit:STOPAfter:WAVEform
Sets or returns the setting for the limit test stop after waveform function. The test
will automatically stop when it tests the specified number of waveforms.
Arguments <NR3> is the number of waveforms to test before stopping the limit test.
Arguments APPLY creates a template with the specified source waveform and tolerances,
and stores it in the destination reference waveform to be used in the limit test
comparisons.
LIMit:TEMPLate:DESTination
Sets or returns the destination reference waveform that the LIMit:TEMPLate
APPLY command will use.
Conditions TBS1000 and TDS2000C Series models only. It is not applicable for TBS1000B
Series models.
Arguments REF<x> specifies the reference waveform destination in which the template
waveform is to be stored.
LIMit:TEMPlate:DUALSOUrce
Sets or returns the dual template waveform source. LIMit:TEMPLate:APPLY will
use this value in deriving the limit test template waveform, when the template
is created by a single source.
Syntax LIMit:TEMPLate:SAVEFIRSource
Syntax LIMit:TEMPLate:SAVESECSource
Syntax LIMit:TEMPLate:SAVESOUrce
LIMit:TEMPLate:SOUrce
Sets or returns the source channel or math waveform that LIMit:TEMPLate
APPLY will use in deriving the limit test template waveform, when the template
is created by single source.
Arguments CH<x> specifies that the template waveform source is the waveform currently
being acquired using the specified channel.
MATH specifies the template waveform source channel as the math waveform.
LIMit:TEMPLate:TOLerance:HORizontal
Sets or returns the amount, in units of horizontal divisions, by which the source
waveform is varied horizontally when creating the destination template waveform.
Arguments <NR3> is the amount, in horizontal divisions, by which the source waveform is
horizontally modified to generate the template that is stored in the destination
reference. The range is 0 to 5 divisions.
LIMit:TEMPLate:TOLerance:VERTical
Sets or returns the amount, in units of vertical divisions, by which the source
waveform is varied vertically when creating the destination template waveform.
Arguments <NR3> is the amount, in vertical divisions, by which the source waveform is
varied vertically when creating the test waveform. The range is 0 to 5 divisions.
LOCk
Enables and disables all front-panel buttons and knobs. There is no front-panel
equivalent.
Group Miscellaneous
NONe enables all front-panel controls. This is equivalent to the UNLock ALL
command.
LOCK? returns NONE when the front-panel controls are enabled by this command.
Group Miscellaneous
Syntax *LRN?
Group Math
Syntax MATH?
Examples MATH? might return the following for an FFT waveform: MATH:DEFINE
"FFT(CH1,HANNING)";VERTICAL:POSITION 0.0E0;SCALE
1.0E0;:MATH:FFT:HORIZONTAL:POSITION 5.0E1;SCALE
1.0E0;:MATH:FFT:VERTICAL:POSITION 0.0E0;SCALE 1.0E0
MATH:DEFINE
Performs the specified mathematical operation on the input signal or signals. To
activate or deactivate the math waveform, use the SELect:<wfm> command.
NOTE. Remember that <QString> must be enclosed in quotes. You can use white
space characters between words.
Group Math
Arguments <QString> specifies a math waveform, and can be one of the following:
TDS1001, TDS1002, TDS1012, TDS2002, TDS2012 and TDS2022 models;
TDS210 and TDS220 models (firmware V2.00 and above) with a TDS2MM
measurement module.
CH1+CH2 CH1-CH2 CH2-CH1 FFT (CH<x> [, <window>]) TDS2004,
TDS2014 and TDS2024 models; TDS224 model with a TDS2MM measurement
module.
CH1+CH2 CH3+CH4 CH1-CH2 CH2-CH1 CH3-CH4 CH4-CH3 FFT (CH<x>
[, <window>]) TDS210 and TDS220 models, firmware below V2.00 with a
TDS2CMA communications module.
CH1-CH2 CH2-CH1 CH1+CH2 -CH1 -CH2 TDS210 and TDS220 models
(firmware below V2.00) with a TDS2MM measurement module.
CH1+CH2 (to subtract, invert one of the waveforms through CH<x>:INVert, and
then add) FFT (CH<x> [, <window>])TDS210 and TDS220 models (firmware
V2.00) and above with a TDS2CMA communications module.
CH1+CH2 CH1-CH2 CH2-CH1 TDS224 model with a TDS2CMA
communications module.
CH1+CH2 CH3+CH4 (4-channel models) CH1-CH2 CH2-CH1 CH3-CH4
(4-channel models) CH4-CH3 (4-channel models) TBS1000B/EDU, TBS1000,
TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000
Series.
CH1+CH2 CH3+CH4 (4-channel models) CH1-CH2 CH2-CH1 CH3-CH4
(4-channel models) CH4-CH3 (4-channel models) CH1*CH2 CH3*CH4
(4-channel models) FFT (CH<x>[, <window>])
For FFT, the optional <window> argument is HANning, FLATtop, or
RECTangular.
Examples MATH:DEFINE "CH1+CH2" sets the math waveform so that it displays the sum of
channel 1 and channel 2.
MATH:DEFINE "FFT (CH1, HANNING)" sets the math waveform to display an
FFT of channel 1 using a Hanning window.
NOTE. You can use this FFT example with TBS1000, TDS2000C,
TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and
TPS2000 Series oscilloscopes, as well as a TDS200 Series oscilloscope with a
TDS2MM measurement module. It is not applicable for TBS1000B/EDU models.
Group Math
Syntax MATH:FFT?
MATH:FFT:HORizontal:POSition
NOTE. You can use this command with TBS1000, TDS2000C, TDS1000C-EDU,
TDS2000B, TDS1000C, TDS2000, TDS1000, TPS2000B, and TPS2000
oscilloscopes, as well as a TDS200 oscilloscope with a TDS2MM measurement
module.
Group Math
Arguments <NR3> specifies the point in the FFT waveform data record to display at the
center vertical graticule line. The data record point is a percentage of the total
record length, in the range of 0 to 100. The default value is 50. How much data
is displayed depends on the FFT Zoom factor setting. The oscilloscope rounds
<NR3> to the nearest workable value.
MATH:FFT:HORizontal:SCAle
NOTE. You can use this command with TBS1000, TDS2000C, TDS1000C-EDU,
TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000
oscilloscopes, as well as a TDS200 oscilloscope with a TDS2MM measurement
module.
Group Math
Arguments <NR3> specifies the horizontal magnification factor, where the axis of
magnification is the center vertical graticule line. Valid zoom factors are 1, 2, 5,
and 10. If other values are entered the oscilloscope rounds the value of <NR3> to
the nearest valid zoom factor.
MATH:FFT:VERtical:POSition
NOTE. You can use this command with TBS1000, TDS2000C, TDS1000C-EDU,
TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000
oscilloscopes, as well as a TDS200 oscilloscope with a TDS2MM measurement
module.
Group Math
MATH:FFT:VERtical:SCAle
NOTE. You can use this command with TBS1000, TDS2000C, TDS1000C-EDU,
TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000
oscilloscopes, as well as a TDS200 oscilloscope with a TDS2MM measurement
module.
Group Math
Arguments <NR3> specifies the vertical zoom factor, where the axis of magnification is the
center horizontal graticule line. Valid zoom factors are 0.5, 1, 2, 5, and 10. If
other values are entered the oscilloscope rounds the value of <NR3> to the nearest
valid zoom factor.
Group Math
Syntax MATH:VERtical?
MATH:VERtical:POSition
Sets or returns the math waveform display position.
Group Math
Arguments <NR3> specifies the math vertical position in divisions from center screen.
MATH:VERtical:SCAle
Sets or returns the math waveform display scale in units per division. It is not
possible to use this command to set the math scale to a fine scale not achievable
from the front panel. This command typically rounds down to an achievable value.
If the value input is below the minimum value, then the command will round up.
Group Math
Arguments <NR3> specifies the math vertical scale in units per division.
Examples MATH:VERTICAL:SCALE 5.0E0 sets the math vertical scale to five math
waveform units per division.
Group Measurement
Syntax MEASUrement?
Group Measurement
Syntax MEASUrement:CLEARSNAPSHOT
MEASUrement:GATing
Sets or returns the measurement gating.
Group Measurement
Group Measurement
Syntax MEASUrement:IMMed?
MEASUrement:IMMed:SOUrce[1]
Sets or queries the source for single-source immediate measurements.
Group Measurement
Arguments CH<x> specifies the measurement source channel as one of the input channels.
The value of <x> can vary from 1 through 4 for 4-channel instruments or 1
through 2 for 2-channel instruments.
MATH specifies the measurement source channel as the math waveform.
(TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B,
TDS1000B, TPS2000B, and TPS2000 Series only)
MEASUrement:IMMed:SOURCE2
Sets or queries the secondary source for dual-source immediate measurements.
For example, power analysis and phase angle measurements.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
NOTE. This command is only available when the Power Analysis Module
application key is installed.
Group Measurement
Arguments CH<x> specifies the measurement source channel as one of the input channels. The
value of <x> can vary from 1 through 4 for 4-channel instruments or 1 through 2
for 2-channel instruments. For power analysis, Source2 must be Amperes.
MATH specifies the measurement source channel as the math waveform.
MEASUrement:IMMed:TYPe
Sets or queries the immediate measurement type.
NOTE. Selecting one of the power arguments for this command, without installing
the Power Analysis Module application key, will generate an error.
Group Measurement
MEASUrement:IMMed:TYPe?
Arguments CRMs is the true Root Mean Square voltage of the first complete cycle in the
waveform.
CURSORRms (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU Series)
is the true Root Mean Square (RMS) value of the selected waveform data,
between the start point and the end point.
The following are for use with the TPS2000 Series with the TPS2PWR1 Power
Analysis Module:
PFPHASE (TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module
only) is the phase angle measurement in degrees. Source 1 must be volts; source
2 must be Amperes.
PHAse (TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module
only) is the measurement of phase between source 1 and source 2, in degrees.
POWERFACTOR (TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis
Module only) is the true power factor ratio measurement. Source 1 must be volts;
source 2 must be Amperes.
TRUEPOWER (TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis
Module only) is the true power measurement in Watts. Source 1 must be volts;
source 2 must be Amperes.
VAR (TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module
only) is the reactive power measurement. Source 1 must be volts; source 2 must
be Amperes.
WFCREST (TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module
only) is the measurement of the maximum value to the cycle RMS value of the
waveform, a unit-less ratio.
WFCYCRMS (TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis
Module only) is the measurement of RMS voltage calculated over the first cycle,
using the min-max, high-low method.
WFFREQ (TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module
only) is the measurement of frequency using the min-max, high-low method.
DELAYRR (TBS1000B/EDU Series only) is the time between the mid reference
(default 50%) amplitude point of two different rising waveforms.
DELAYRF (TBS1000B/EDU Series only) is the time between the mid reference
(default 50%) amplitude point of the rising and falling waveforms.
DELAYFR (TBS1000B/EDU Series only) is the time between the mid reference
(default 50%) amplitude point of the falling and rising waveforms.
DELAYFF (TBS1000B/EDU Series only) is the between the mid reference (default
50%) amplitude point of the two different falling waveforms.
AMplitude (TBS1000B/EDU Series only) is the high value less the low value
measured over the entire waveform or gated region.
CMEAN (TBS1000B/EDU Series only) (cycle mean) is the arithmetic mean over
the first cycle in the waveform or the first cycle in the gated region.
HIGH (TBS1000B/EDU Series only) is the value used as 100% whenever high
reference, mid reference, or low reference values are needed, such as in fall time
or rise time measurements. Calculate using either the min-max or histogram
method. The min-max method uses the maximum value found. The histogram
method uses the most common value found above the midpoint. This value is
measured over the entire waveform or gated region.
LOW (TBS1000B/EDU Series only) is the value used as 0% whenever high
reference, mid reference, or low reference values are needed, such as in fall time
or rise time measurements. Calculate using either the min-max or histogram
method. The min-max method uses the minimum value found. The histogram
method uses the most common value found below the midpoint. This value is
measured over the entire waveform or gated region.
NDUty (TBS1000B/EDU Series only) is the ratio of the negative pulse width to
the signal period expressed as a percentage. The duty cycle is measured on the
first cycle in the waveform or gated region.
POVERshoot (TBS1000B/EDU Series only) is measured over the entire
waveform or gated region and is expressed as:
Positive Overshoot = (Maximum – High) / Amplitude * 100%.
NOVERshoot (TBS1000B/EDU Series only) is measured over the entire
waveform or gated region and is expressed as:
Negative Overshoot = (Low – Minimum) / Amplitude * 100%.
CURSORMean (TBS1000B/EDU Series only) is the arithmetic mean of the
waveform data from the selected starting to the ending point.
BURSTWIDth (TBS1000B/EDU Series only) is the duration of a burst (a series of
transient events) and is measured over the entire waveform or gated region.
AREA (TBS1000B/EDU Series only) is a voltage over time measurement. It
returns the area over the entire waveform or gated region in volt-seconds. Area
measured above ground is positive. Area measured below ground is negative.
CAREA (TBS1000B/EDU Series only) (cycle area) is a voltage over time
measurement. The measurement is the area over the first cycle in the waveform
or the first cycle in the gated region expressed in volt-seconds. The area above
the common reference point is positive. The area below the common reference
point is negative.
PPULSECount (TBS1000B/EDU Series only) is the number of positive pulses
that rise above the mid reference crossing in the waveform or gated region.
NPULSECount (TBS1000B/EDU Series only) is the number of negative pulses
that fall below the mid reference crossing in the waveform or gated region.
REDGECount (TBS1000B/EDU Series only) is the number of positive transitions
from the low reference value to the high reference value in the waveform or
gated region.
FEDGECount (TBS1000B/EDU Series only) is the number of negative transitions
from the high reference value to the low reference value in the waveform or
gated region.
Group Measurement
Syntax MEASUrement:IMMed:UNIts?
Returns <QString> returns "V" for volts, "s" for seconds, or "Hz" for Hertz.
Examples MEASUREMENT:IMMED:UNITS? might return "s", indicating that the unit for the
immediate measurement is seconds.
Group Measurement
Syntax MEASUrement:IMMed:VALue?
Returns <NR3>
Group Measurement
Syntax MEASUrement:MEAS<x>?
MEASUrement:MEAS<x>:SOUrce
Sets or queries the source for an automated measurement. Where <x>
identifies the measurement, 1 through 4 for the TDS200 Series, and 1 through
5 for the TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B,
TDS2000, TDS1000, TPS2000B, and TPS2000 Series, and 1 through 6 for the
TBS1000B/EDU Series.
This is equivalent to selecting the measurement source in the MEASURE menu.
Group Measurement
Arguments CH<y> specifies the input channel source for the measurement.
MEASUrement:MEAS<x>:SOUrce2
Sets or queries the secondary source for dual-source automated measurements.
Where <x> identifies the measurement, 1 through 4 for the TDS200 Series,
and 1 through 5 for the TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B,
TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series, and 1 through
6 for the TBS1000B/EDU Series.
This is equivalent to selecting the measurement source2 in the MEASURE menu.
Group Measurement
Arguments CH<y> specifies the input channel source for the measurement.
MEASUrement:MEAS<x>:TYPe
Sets or queries the on-screen periodic oscilloscope measurement type for the
measurement specified by <x>. Where <x> identifies the measurement, 1
through 4 for the TDS200 Series, and 1 through 5 for the TBS1000, TDS2000C,
TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and
TPS2000 Series, and 1 through 6 for the TBS1000B/EDU Series.
This is equivalent to selecting the measurement type in the MEASURE menu.
Setting the type to anything other than NONE displays the MEASURE menu
on the screen.
Group Measurement
MEASUrement:MEAS<x>:TYPe?
Arguments CRMs is the true Root Mean Square voltage of the first complete cycle in the
waveform.
module, TPS2000B, and TPS2000 Series only) is the rise time between 10% and
90% of the first rising edge of the waveform. Rising edge must be displayed
to measure. The oscilloscope automatically calculates the 10% and 90%
measurement points.
DELAYRR (TBS1000B/EDU Series only) is the time between the mid reference
(default 50%) amplitude point of two different rising waveforms.
DELAYRF (TBS1000B/EDU Series only) is the time between the mid reference
(default 50%) amplitude point of the rising and falling waveforms.
DELAYFR (TBS1000B/EDU Series only) is the time between the mid reference
(default 50%) amplitude point of the falling and rising waveforms.
DELAYFF (TBS1000B/EDU Series only) is the between the mid reference (default
50%) amplitude point of the two different falling waveforms.
AMplitude (TBS1000B/EDU Series only) is the high value less the low value
measured over the entire waveform or gated region.
CMEAN (TBS1000B/EDU Series only) (cycle mean) is the arithmetic mean over
the first cycle in the waveform or the first cycle in the gated region.
HIGH (TBS1000B/EDU Series only) is the value used as 100% whenever high
reference, mid reference, or low reference values are needed, such as in fall time
or rise time measurements. Calculate using either the min-max or histogram
method. The min-max method uses the maximum value found. The histogram
method uses the most common value found above the midpoint. This value is
measured over the entire waveform or gated region.
LOW (TBS1000B/EDU Series only) is the value used as 0% whenever high
reference, mid reference, or low reference values are needed, such as in fall time
or rise time measurements. Calculate using either the min-max or histogram
method. The min-max method uses the minimum value found. The histogram
method uses the most common value found below the midpoint. This value is
measured over the entire waveform or gated region.
NDUty (TBS1000B/EDU Series only) is the ratio of the negative pulse width to
the signal period expressed as a percentage. The duty cycle is measured on the
first cycle in the waveform or gated region.
POVERshoot (TBS1000B/EDU Series only) is measured over the entire
waveform or gated region and is expressed as:
Positive Overshoot = (Maximum – High) / Amplitude * 100%.
NOVERshoot (TBS1000B/EDU Series only) is measured over the entire
waveform or gated region and is expressed as:
Negative Overshoot = (Low – Minimum) / Amplitude * 100%.
CURSORMean (TBS1000B/EDU Series only) is the arithmetic mean of the
waveform data from the selected starting to the ending point.
Group Measurement
Syntax MEASUrement:MEAS<x>:UNIts?
Returns <QString> returns "V" for volts, "s" for seconds, or "Hz" for Hertz, or a null
string if MEASUrement:MEAS<x>:TYPe is set to NONE.
NOTE. If Trigger View is active, scan mode is in effect, or the display format set to
XY, this query generates event 221 (Settings conflict) and returns 9.9E37.
NOTE. When math is FFT, turned on, and used as a measurement source,
attempting to query the measurement value returns 9.9e37 and raises error 2225
(no waveform to measure).
Group Measurement
Syntax MEASUrement:MEAS<x>:VALue?
Returns <NR3>
Group Measurement
Syntax MEASUrement:SNAPSHOT
MEASUrement:SNAPSOUrce
Sets or returns the snapshot source.
Group Measurement
*OPC
Generates the operation complete message in the Standard Event Status Register
(SESR) when all pending commands that generate an OPC message are complete.
The *OPC? query places the ASCII character "1" into the output queue when all
such OPC commands are complete. The *OPC? response is not available to read
until all pending operations finish. (See page 3-224, Status and Events.)
The *OPC command allows you to synchronize the operation of the oscilloscope
with your application program. (See page 3-7, Synchronization Methods.)
Certain oscilloscope operations can affect the *OPC response. (See Table 3-3
on page 3-7.)
Syntax *OPC
*OPC?
Examples *OPC generates the operation complete message in the SESR at the completion of
all pending OPC operations.
*OPC? might return 1 to indicate that all pending OPC operations are finished.
PICTBridge:DATEPRINT
Sets the date and time to be printed on the hard copy if the feature is available
on the compatible printer. This command is equivalent to setting the Date Print
option in the UTILITY > Options > Printer Setup > PRINT Button > Prints menu
of TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and
TDS1000B oscilloscopes.
Group PictBridge
Arguments DEFLT will match the default setting of the printer: on or off.
Examples PICTBRIDGE:DATEPRINT? might return ON if the printer is set to print the date
and time.
Group PictBridge
Syntax PICTBridge:DEF
Examples PICTBRIDGE:DEF sets the parameters for the compatible printer to the default
values.
PICTBridge:IDPRINT
Sets the oscilloscope model and serial number to be printed on the hard copy if
the feature is available on the compatible printer. This command is equivalent
to setting the ID Print option in the UTILITY > Options > Printer Setup >
PRINT Button > Prints menu of TBS1000B/EDU, TBS1000, TDS2000C,
TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes.
Group PictBridge
Arguments DEFLT will match the default setting of the printer: on or off.
Examples PICTBRIDGE:IDPRINT? might return ON if the printer is set to print the model
and serial number.
PICTBridge:IMAGESIZE
Sets the size of the image to print. This command is equivalent to setting the
Image Size option in the UTILITY > Options > Printer Setup > PRINT Button
> Prints menu of TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU,
TDS2000B, and TDS1000B oscilloscopes.
Group PictBridge
All image size arguments are valid if the paper size can accommodate the image.
The paper size should be larger than the image size.
Examples PICTBRIDGE:IMAGESIZE? might return LETTER as the size of the image to print.
PICTBridge:PAPERSIZE
Sets the paper size of the hard copy from those available on the compatible
printer. This command is equivalent to setting the Paper Size option in the
UTILITY > Options > Printer Setup > PRINT Button > Prints menu of
TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and
TDS1000B oscilloscopes.
Group PictBridge
Any paper size argument is valid when the paper is available for the printer.
Examples PICTBRIDGE:PAPERSIZE? might return LETTER as the selected paper size for
the printer.
PICTBridge:PAPERTYPE
Sets the type of paper from those available on the compatible printer. This
command is equivalent to setting the Paper Type option in the UTILITY > Options
> Printer Setup > PRINT Button > Prints menu of TBS1000B/EDU, TBS1000,
TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes.
Group PictBridge
Arguments DEFLT specifies the type of paper used by default in the printer.
PICTBridge:PRINTQUAL
Sets the quality of the print from those available on the compatible printer. This
command is equivalent to setting the Print Quality option in the UTILITY >
Options > Printer Setup > PRINT Button > Prints menu of TBS1000B/EDU,
TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B
oscilloscopes.
Group PictBridge
Arguments DEFLT specifies the quality of the hard copy used by default on the printer.
Syntax POWer?
NOTINSTALLED;:POWER:BATTERY2:GASGAUGE 0 ;STATUS
NOTINSTALLED;:POWER:BATTERIES:TIME 0; POWER:BUTTONLIGHT 1
Syntax POWer:AC:PRESENt?
Syntax POWer:BATTERY<x>:GASgauge?
Returns <NR1>, a number between 0 and 100, indicates the charge remaining in the
battery. 0 indicates the battery is fully discharged. 100 indicates the battery
is fully charged.
Syntax POWer:BATTERY<x>:STATUS?
DISCHARGED indicates that the battery has no charge remaining. The battery can
be discharged, but still report a small percent remaining.
UNCALIBRATED indicates that the oscilloscope cannot predict the battery charge
remaining.
NOTINSTALLED indicates that the battery is not installed in the oscilloscope.
NORMAL indicates that the battery status is not any of the states in this list.
Syntax POWer:BATTERIES:TIME?
Returns <NR1> specifies the operating time remaining for both batteries in minutes.
POWer:BUTTONLIGHT
Turns the lights on the front-panel buttons of the TPS2000 Series and TPS2000B
Series on and off.
Conditions This command applies to the TPS2000 Series and TPS2000B Series only.
POWerANALYSIS:SOUrces
Sets or queries the Power Analysis sources. This command is equivalent to setting
the Sources option in the Power Analysis menu. It does not affect the sources for
any customer-visible PI measurements.
Conditions This command applies to the TPS2000 Series and TPS2000B Series only.
Arguments CH1CH2 selects Channel 1 and Channel 2 as the power analysis source.
NOTE. The "CH3CH4" argument is only valid for instruments with four channels.
Arguments <NR1> = 0 sets the power-on status clear flag to false, disables the power on clear,
and allows the oscilloscope to possibly assert SRQ after power on.
<NR1> ≠ 0 sets the power-on status clear flag true. Sending *PSC 1, therefore,
enables the power-on status clear and prevents any SRQ assertion after power on.
*PSC? might return the value 1, showing that the power-on status clear flag
is set to true.
Examples *RCL 3 restores the oscilloscope from a copy of the settings stored in memory
location 3.
Examples RECALL:SETUP FACTORY recalls the oscilloscope setup to its factory defaults.
Arguments <file path> is a quoted string that defines the location and name of the
waveform file to recall. If you do not specify a path to the folder, the oscilloscope
looks for the file in the current working folder. The current folder refers to the
name of a folder as returned by the FILESystem:CWD query.
REF<x> is the oscilloscope reference memory location in which to load the
waveform. You must load a saved waveform into a reference memory location
before displaying the waveform.
Group Miscellaneous
Group RS-232
Syntax RS232?
Examples RS232? might return the following string: RS232:BAUD 9600; SOFTFLAGGING
0; HARDFLAGGING 1; PARITY NONE; TRANSMIT:TERMINATOR LF
RS232:BAUd
Sets or queries the RS-232C interface transmission speed. If no flow control
(flagging) is used, commands may be received faster than the oscilloscope can
process them. Also, if another command is sent immediately after this command,
without waiting for the baud rate to be programmed, the first couple of characters
may be lost.
Conditions This command applies to the TDS2000, TDS1000, TDS200, TPS2000B, and
TPS2000 Series only.
Group RS-232
Arguments <NR1> which can be 300, 600, 1200, 2400, 4800, 9600, or 19200.
RS232:HARDFlagging
Sets or queries the state of RS232 hard flagging. When hard flagging is enabled,
the oscilloscope sends data if CTS (Clear To Send) is asserted. When receiving
data, the oscilloscope asserts RTS (Request To Send) until the input buffer is
almost full. When the oscilloscope no longer asserts RTS, it continues to read
incoming data until the input buffer is full and then reports an input overrun
error. The oscilloscope asserts DTR (Data Terminal Ready) at all times when
the oscilloscope power is on.
Hard flagging and soft flagging cannot be on at the same time. However, hard and
soft flagging can both be off at the same time. Turning hard flagging on turns soft
flagging off. Turning soft flagging on turns hard flagging off.
Conditions This command applies to the TDS2000, TDS1000, TDS200, TPS2000B, and
TPS2000 Series only.
Group RS-232
Arguments ON or <NR1> ≠ 0 activates hard flagging and turns off soft flagging.
RS232:PARity
Sets or queries the parity used for all RS-232C data transfers. When parity is odd
or even, the oscilloscope generates the selected parity on output and checks all
input against the selected parity. When parity is none, the oscilloscope performs
no input parity error checks and generates no output parity.
When the parity (ninth) bit does not match the parity type, the oscilloscope reports
a parity error. If another command is sent immediately after this command,
without waiting for the parity to be programmed, the first few characters may be
lost.
Conditions This command applies to the TDS2000, TDS1000, TDS200, TPS2000B, and
TPS1000B Series only.
Group RS-232
RS232:SOFTFlagging
Sets or queries the input and output soft flagging over the RS-232C port. After
receiving an XOFF (DC3), the oscilloscope sends two or less characters. The
oscilloscope begins transmitting data again when it receives an XON (DC1)
character.
The oscilloscope sends an XOFF character when its input buffer is running out of
space. After sending an XOFF character it can receive at least 20 more bytes. It
sends XON when its input buffer has an acceptable number of free bytes.
When soft flagging is enabled and binary data is transferred, data transmission
will lock up if the data contains XOFF or XON characters.
Hard flagging and soft flagging cannot be active at the same time. However, hard
and soft flagging can both be inactive at the same time. Activating soft flagging
deactivates hard flagging. Activating hard flagging deactivates soft flagging.
Conditions This command applies to the TDS2000, TDS1000, TDS200, TPS2000B, and
TPS2000 Series only.
Group RS-232
RS232:TRANsmit:TERMinator
Sets or queries the end-of-line (EOL) terminator. When transmitting, the
oscilloscope appends the terminator to the end of each message. When receiving,
the oscilloscope accepts all four 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; it treats the
second character as a null command.
CR represents an ASCII carriage return character (0x0D) and LF represents an
ASCII line feed character (0x0A).
Conditions This command applies to the TDS2000, TDS1000, TDS200, TPS2000B, and
TPS2000 Series only.
Group RS-232
LFCr selects the line feed and carriage return characters as the EOL terminator.
*RST
(Reset) Returns the oscilloscope to a known set of oscilloscope settings, but does
not purge any stored settings. This command executes a subset of the FACtory
command.
Group Miscellaneous
Syntax *RST
Arguments <NR1> is an integer value in the range from 1 to 5 (TDS200 Series) or from 1
to 10 (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B,
TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series) and specifies
a memory location. Any settings that have been stored previously at this location
are overwritten.
Arguments <file path> is a quoted string that defines the path and name of the screen
image file to save. Use file name extensions that are appropriate for image format.
If you do not specify a path to a folder, the oscilloscope saves the screen image file
in the current working folder, using the current save image file format. The current
folder refers to the name of a folder as returned by the FILESystem:CWD query.
Use the SAVe:IMAge:FILEFormat command to set the screen image graphical
file format.
Arguments BMP sets the screen image file format to Microsoft Windows Bitmap format.
EPSIMAGE (non-TBS1000B/EDU Series only) sets the screen image file format to
Postscript format.
JPG (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and
TDS1000B Series only) sets the screen image file format to JPEG bitmap (uses a
lossy file compression algorithm).
PCX (non-TBS1000B/EDU Series only) sets the screen image file format to DOS
Paintbrush format.
RLE (non-TBS1000B/EDU Series only) sets the screen image file format to
Windows color image file format (*.RLE). Use RLE for faster transfer rates and
smaller resulting files. Many programs that recognize .BMP files also recognize
.RLE files.
TIFF (non-TBS1000B/EDU Series only) sets the screen image file format to
Tagged Image File Format.
Examples SAVE:IMAGE:FILEFORMAT TIFF sets the screen image graphical file format
to TIFF.
Arguments <wfm> is CH<y> (one of the allowable channels) or MATH. This is the waveform
that will be saved. For TBS1000B/EDU models, <wfm> can be FFT. For
TDS2MEM module and TPS2000B/TPS2000 Series, <wfm> can also be a
reference waveform location (for example REF4) if the destination is <file path>.
REF<x> is one of the allowable reference waveform storage locations.
Examples SAVE:WAVEFORM MATH, REFB saves the math waveform in stored waveform
memory location REFB.
For non-TBS1000B/EDU models:
SAVE:WAVEFORM CH1, "A:\PROD-TST\FRQTST03.CSV" saves the channel 1
waveform data to the file FRQTST03.CSV in the folder A:\PROD-TST on the
CompactFlash card (TDS2MEM and TPS2000B/TPS2000 Series only), or on
the USB flash drive (TBS1000, TDS200C, TDS1000C-EDU, TDS2000B, and
TDS1000B Series only).
For TBS1000B/EDU models:
SAVE:WAVEFORM CH1, "/usb0/PROD-TST/FRQTST03.CSV" saves the channel
1 waveform data to the file FRQTST03.CSV in the folder /usb0/PROD-TST
on the USB flash drive.
Group Vertical
Syntax SELect?
SELect:<wfm>
Controls the display of waveforms. This command is equivalent to activating or
deactivating a waveform from the oscilloscope front panel.
Group Vertical
SELect:FFT
Sets or queries the FFT display state.
Group FFT
Syntax SELect:FFT
SELect:FFT?
NOTE. The SET? query always returns command headers, regardless of the
setting of the HEADer command. This is because the returned data is intended
to be able to be sent back to the oscilloscope as concatenated commands. The
VERBose command can still be used to specify whether the returned headers
should be abbreviated or full length.
Group Miscellaneous
Syntax SET?
Examples SET? might return a partial string like the following: ACQUIRE:STOPAFTER
RUNSTOP;STATE 1;MODE SAMPLE; NUMAVG 16;:HEADER
1;:VERBOSE 1;:DISPLAY:FORMAT YT;STYLE VECTORS;PERSISTENCE
500.0E-3;CONTRAST 50;:LOCK NONE;:HARDCOPY:FORMAT EPSON;PORT
RS232;LAYOUT PORTRAIT;
Related Commands *CLS, DESE, *ESE, *ESR?, EVENT?, EVMsg?, FACtory, *PSC
Arguments <NR1> is an integer value in the range from 0 to 255. The binary bits of the SRER
are set according to this value. Using an out-of-range value causes an execution
error. The power-on default for SRER is 0 if *PSC is 1. If *PSC is 0, the SRER
maintains its value through a power cycle.
*SRE? might return a value of 32, showing that the bits in the SRER have the
binary value 00100000.
Syntax *STB?
Returns <NR1>
Examples *STB? might return the value 96, showing that the SBR contains the binary
value 01100000.
SWLoss?
Returns the current Switching Loss measurement settings.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss?
SWLoss:ACQuire
Sets or queries the type of acquisition used for Switching Loss measurements.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
NOTE. This command returns error 221 (settings conflict) if the Switching Loss
menu is not active.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:AVErage:CONDUCTION?
Returns <NR3>
NOTE. This command returns error 221 (settings conflict) if the Switching Loss
menu is not active.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:AVErage:N?
Returns <NR1>
Examples SWLOSS:AVERAGE:N? might return 185, indicating that the oscilloscope used
185 measurements to calculate the average.
NOTE. This command returns error 221 (settings conflict) if the Switching Loss
menu is not active.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:AVErage:TOTAL?
Returns <NR3>
NOTE. This command returns error 221 (settings conflict) if the Switching Loss
menu is not active.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:AVErage:TURNOFF?
Returns <NR3>
NOTE. This command returns error 221 (settings conflict) if the Switching Loss
menu is not active.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:AVErage:TURNON?
Returns <NR3>
SWLoss:ENABLe
Sets or queries the switching loss menu, on or off.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:LOG:CONDUCTION?
Returns <NR3>
SWLoss:LOG:INDEX
Sets or queries which measurement to return for the following
commands: SWLoss:LOG:CONDUCTION, SWLoss:LOG:TOTAL,
SWLoss:LOG:TURNON, and SWLoss:LOG:TURNOFF.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:LOG:TOTAL?
Returns <NR3>
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:LOG:TURNOFF?
Returns <NR3>
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:LOG:TURNON?
Returns <NR3>
SWLoss:SAVE
Saves the Switching Loss measurements to the oscilloscope CompactFlash card.
Uses .CSV format.
NOTE. You can view the contents of the saved file on your personal computer. You
cannot recall saved Switching Loss files to the oscilloscope.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Arguments <filename> specifies the file name and full path to save switching loss
measurement data.
Examples SWLOSS:SAVE "A:\Data2.CSV" specifies the file name and path to save
switching loss measurement data to the oscilloscope CompactFlash card.
SWLoss:SOURCES
Sets or queries the input sources for Switching Loss measurements.
Before taking measurements, you must use the CH<x>:YUNit command to set
the units of the voltage and current sources.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
NOTE. The "CH3CH4" argument is only valid for instruments with four channels.
SWLoss:STOPAfter
Sets or queries the number of measurements used for Switching Loss
measurement.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Examples SWLOSS:STOPAFTER? might return 15, indicating that the oscilloscope will take
fifteen measurements and stop.
SWLoss:TOFFEND
Sets or queries a level on the first falling edge of the current waveform that occurs
after the turn-off start point (SWLoss:TOFFSTART).
The Turn-Off loss measurement is calculated by integrating the math
waveform between the turn-off start (SWLoss:TOFFSTART) and turn-off end
(SWLoss:TOFFEND) points.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Examples SWLOSS:TOFFEND? might return 10, indicating that Switching Loss Turn-off
End is set to 10%.
SWLoss:TONEND
Sets or queries a level on the first falling edge of the voltage waveform.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Examples SWLOSS:TONEND? might return 10, indicating that Switching Loss Turn-off Start
is set to 10%.
SWLoss:TOFFSTART
Sets or queries a level on the rising edge of the voltage waveform.
The Turn-Off loss measurement is calculated by integrating the math
waveform between the turn-off start (SWLoss:TOFFSTART) and turn-off end
(SWLoss:TOFFEND) points.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Examples SWLOSS:TOFFSTART? might return 10, indicating that Switching Loss Turn-on
End is set to 10%.
SWLoss:TONSTART
Sets or queries a level on the falling edge of the voltage waveform.
The Turn-On loss measurement is calculated by integrating the math
waveform between the turn-on start (SWLoss:TONSTART) and turn-on end
(SWLoss:TONEND) points.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Examples SWLOSS:TONSTART? might return 80, indicating that Switching Loss Turn-on
Start is set to 80%.
SWLoss:UNITs
Sets or queries the units for Switching Loss measurements.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Examples SWLOSS:UNITS? might return WATTS, indicating that the current measurement
units are Watts.
NOTE. If the units are Watts, the trigger type must be Edge and the trigger source
must be a channel specified by SWLoss:SOURCES.
SWLoss:VALue:CONDUCTION?
Returns the power loss of the device under test when the device is conducting in
its on state. You must enter the saturation voltage of the device under test using
the SWLoss:VSAT command.
This command returns an immediate-measurement value that does not depend of
the current oscilloscope menu.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:VALue:CONDUCTION?
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:VALue:TOTAL?
Returns <NR3>
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:VALue:TURNOFF?
Returns <NR3>
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Syntax SWLoss:VALue:TURNON?
Returns <NR3>
SWLoss:VSAT
Sets or queries the saturation voltage for the device under test.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
TIMe
Sets or queries the oscilloscope time value. The oscilloscope uses the time and
date values to time stamp files saved to the CompactFlash card (TDS2MEM and
TPS2000B/TPS2000 Series only), or to the USB flash drive (TBS1000B/EDU,
TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series
only), as well as show the time and date on the oscilloscope display.
Group Miscellaneous
Arguments <QString> is a time in the form "hh:mm:ss", based on a 24-hour clock (00:00:00
through 23:59:59).
Syntax TRENDPLOT?
TRENDPLOT:STATE
Sets or returns the running state of the trend plot.
TRENDPLOT:TIME
Returns the elapsed time since starting the plot function.
Syntax TRENDPLOT:TIME?
Syntax TRENDPLOT:TP<x>:AVG?
Syntax TRENDPLOT:TP<x>:MAX?
Syntax TRENDPLOT:TP<x>:MIN?
Syntax TRENDPLOT:TP<x>:SCALE?
Syntax TRENDPLOT:TP<x>:SCALEMAX?
Syntax TRENDPLOT:TP<x>:SCALEMIN?
TRENDPLOT:TP<x>:SOURCE
Sets or returns the trend plot source.
TRENDPLOT:TP<x>:TYPe
Sets or returns the trend plot type. z is 1 or 2.
Group Miscellaneous
Syntax *TRG
TRIGger
Forces a trigger event to occur. When used as a query, TRIGger? returns the
current trigger settings.
Group Trigger
TRIGger:MAIn
Sets the oscilloscope trigger level to 50% of the minimum and maximum values
of the signal. Returns the current main trigger settings when used as a query.
Group Trigger
Arguments SETLevel sets the main trigger level to half way between the MIN and MAX
amplitudes of the trigger source input. This is equivalent to pressing the
front-panel SET LEVEL TO 50% button.
If the oscilloscope acquisition state is STOP and you send TRIGger:MAIn
SETLevel, the oscilloscope ignores the command and generates event 221
(Settings conflict).
Examples TRIGGER:MAIN SETLEVEL sets the main trigger level mid way between MAX
and MIN.
Group Trigger
Syntax TRIGger:MAIn:EDGE?
Returns Trigger coupling, source, and slope settings for the main edge trigger
TRIGger:MAIn:EDGE:COUPling
Sets or queries the type of coupling for the edge trigger. This is equivalent to
setting the Coupling option in the Trigger menu.
Group Trigger
DC selects DC coupling.
TRIGger:MAIn:EDGE:SLOpe
Selects a rising or falling slope for the edge trigger. This is equivalent to setting
the Slope option in the Trigger menu.
Group Trigger
Examples TRIGGER:MAIN:EDGE:SLOPE RISE sets the main edge trigger to occur on the
rising slope.
TRIGger:MAIn:EDGE:SOUrce
Sets or queries the source for the edge trigger. This is equivalent to setting the
Source option in the Trigger menu.
Group Trigger
Arguments CH<x> specifies one of the allowable input channels. The value of <x> can
vary from 1 through 4 for 4-channel instruments or 1 through 2 for 2-channel
instruments.
EXT specifies the external input (not available with TDS224 oscilloscopes).
EXT5 specifies that the external input is attenuated by a factor of 5 (not available
with TDS224 oscilloscopes).
EXT10 specifies that the external input is attenuated by a factor of 10
(TPS2000B/TPS2000 Series only).
LINE specifies the power line signal as a trigger source (not available with
TPS2000B/TPS2000 Series oscilloscopes).
Group Trigger
Syntax TRIGger:MAIn:FREQuency?
Group Trigger
Syntax TRIGger:MAIn:HOLDOff?
TRIGger:MAIn:HOLDOff:VALue
Sets or queries the oscilloscope trigger holdoff value.
Group Trigger
Arguments <NR3> is the main trigger holdoff value. The range is 500 ns to 10 s.
TRIGger:MAIn:LEVel
Sets the oscilloscope edge (all models) and pulse width (TBS1000B/EDU,
TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000,
TDS1000, TPS2000B, and TPS2000 Series only) trigger level. This command is
equivalent to adjusting the front-panel TRIGGER LEVEL knob.
NOTE. When the edge trigger source is set to AC LINE, the oscilloscope ignores
the set form of the command and generates event 221 (Settings conflict).
When the edge trigger source is set to AC LINE, the query form of the command
returns zero.
Group Trigger
Examples TRIGGER:MAIN:LEVEL might return 1.4, indicating that the main edge trigger is
set to 1.4 V.
TRIGger:MAIn:MODe
Sets or queries the trigger mode for the Edge (all models) and Pulse width
(TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B,
TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series only) trigger
types.
Group Trigger
Arguments AUTO generates a trigger if a trigger is not detected within a specific time period.
AUTO also enables scan mode for sweep speeds of 100 ms/div and slower.
Group Trigger
Syntax TRIGger:MAIn:PULse?
TRIGger:MAIn:PULse:SOUrce
Sets or queries the source for the pulse trigger. This is equivalent to setting the
Source option in the Trigger menu.
Group Trigger
Arguments CH<x> specifies one of the allowable input channels. The value of <x> can be 1
through 4 on four channel oscilloscopes, or 1 or 2 on two channel oscilloscopes.
EXT specifies the external input (not available with TDS224 oscilloscopes).
EXT5 specifies the external input attenuated by a factor of 5 (not available with
TDS224 oscilloscopes).
EXT10 specifies the external input attenuated by a factor of 10
(TPS2000B/TPS2000 Series only).
Group Trigger
Syntax TRIGger:MAIn:PULse:WIDth?
TRIGger:MAIn:PULse:WIDth:POLarity
Sets or queries the polarity for the pulse trigger. This is equivalent to setting the
Polarity option in the Pulse Trigger menu.
Group Trigger
TRIGger:MAIn:PULse:WIDth:WHEN
Sets or queries the trigger conditions for the pulse trigger. This is equivalent to
setting the When option in the Pulse Trigger menu.
Group Trigger
TRIGger:MAIn:PULse:WIDth:WHEN?
Arguments EQual triggers on the trailing edge of pulses of the specified width.
NOTEQual triggers when a pulse trailing edge occurs before the specified width,
or a pulse continues longer than the specified width without a trailing edge.
INside < triggers on the trailing edge of any pulses that are narrower than the
specified width.
OUTside (greater than; also called time-out trigger) triggers when a pulse
continues longer that the specified width.
TRIGger:MAIn:PULse:WIDth:WIDth
Sets or queries the width for the pulse trigger. This is equivalent to setting the
Width option by using the Pulse Trigger menu and the TRIGGER knob.
Group Trigger
TRIGger:MAIn:TYPe
Sets or queries the type of oscilloscope trigger. This is equivalent to setting the
Type option in the Trigger menu.
Group Trigger
Arguments EDGE is a normal trigger. A trigger event occurs when a signal passes through
a specified voltage level in the specified direction and is controlled by the
TRIGger:MAIn:EDGE commands.
VIDeo specifies that a trigger occurs when a specified signal is found and is
controlled by the TRIGger:MAIn:VIDeo commands.
PULse specifies that a trigger occurs when the specified signal meets the pulse
width criteria that is controlled by the TRIGger: MAIn:PULse commands (not
available with TDS200 Series oscilloscopes).
Examples TRIGGER:MAIN:TYPE might return VIDEO, indicating that the main trigger type
is a video trigger.
Group Trigger
Syntax TRIGger:MAIn:VIDeo?
TRIGger:MAIn:VIDeo:LINE
Sets or queries the line number for the video trigger when
TRIGger:MAIn:VIDeo:SYNC is set to LINENUM. This is equivalent
to selecting a line number in the Trigger/Video menu.
Group Trigger
Arguments <NR1> specifies the line number. The minimum is 1. The maximum is 525 for
NTSC, 625 for PAL and SECAM.
Examples The following command sequence sets the oscilloscope to trigger on video line
123:
TRIGGER:MAIN:TYPE VIDEO
TRIGGER:MAIN:VIDEO:SYNC LINENUM
TRIGGER:MAIN:VIDEO:LINE 123
TRIGger:MAIn:VIDeo:POLarity
Sets or queries the video trigger polarity. This is equivalent to selecting the
Polarity option in the Trigger/Video menu.
Group Trigger
TRIGger:MAIn:VIDeo:SOUrce
Sets or queries the source for the video trigger. This is equivalent to selecting the
Source option in the Video trigger menu.
Group Trigger
Arguments CH<x> specifies one of the allowable input channels. The value of <x> can
vary from 1 through 4 for 4-channel instruments or 1 through 2 for 2-channel
instruments.
EXT specifies the external input (not available with TDS224 oscilloscopes).
EXT5 specifies the external input, attenuated by a factor of 5 (not available with
TDS224 oscilloscopes).
EXT10 specifies the external input attenuated by a factor of 10
(TPS2000B/TPS2000 Series only).
TRIGger:MAIn:VIDeo:STANDard
Sets or queries the video trigger standard. This is equivalent to selecting the
Standard option in the Trigger/Video menu.
Group Trigger
TRIGger:MAIn:VIDeo:SYNC
Sets or queries the type for the video trigger sync. This is equivalent to selecting
the Sync option in the Trigger/Video menu.
Group Trigger
Arguments FIELD specifies that triggering occur on the vertical sync pulse.
NOTE. Accurate real time reporting of the trigger state within any single
waveform acquisition is limited by several factors, including horizontal sweep
speed, and communications and task latencies. To check for the completion of a
single sequence acquisition, use the *OPC? query.
Group Trigger
Syntax TRIGger:STATE?
Returns ARMED indicates that the oscilloscope is acquiring pretrigger information. All
triggers are ignored when TRIGger:STATE is ARMed.
READY indicates that all pretrigger information has been acquired and the
oscilloscope is ready to accept a trigger.
TRIGGER indicates that the oscilloscope has seen a trigger and is acquiring the
posttrigger information.
AUTO indicates that the oscilloscope is in auto mode and acquires data even in
the absence of a trigger.
SAVE indicates that acquisition is stopped or that all channels are off.
Examples TRIGGER:STATE? might return READY, indicating that pretrigger data has been
acquired and the oscilloscope is waiting for a trigger.
Group Miscellaneous
Syntax *TST?
Returns 0
NOTE. If the oscilloscope is in the Remote With Lockout State (RWLS), the
UNLock command has no effect. For more information refer to ANSI-IEEE Std.
488.1-1987, Standard Digital Interface for Programmable Instrumentation,
section 2.8.3, on RL State descriptions.
Group Miscellaneous
Examples UNLOCK ALL unlocks all front-panel buttons and knobs so they can be used.
VERBose
Sets and queries the Verbose state that controls the length of keywords on query
responses. Keywords can be both headers and arguments. This command does not
affect IEEE Std 488.2-1987 Common Commands (those starting with an asterisk).
Group Miscellaneous
Arguments ON or <NR1> ≠ 0 sets the Verbose state true, which returns full-length keywords
for applicable setting queries.
OFF or <NR1> = 0 sets the Verbose state false, which returns minimum-length
keywords for applicable setting queries.
VERBOSE? might return the value 1, showing that the Verbose state is true.
Syntax *WAI
Examples *WAI prevents the oscilloscope from executing any further commands or queries
until all pending commands that generate an OPC message are complete.
WAVEFORMANALYSIS:SOUrce
Sets or queries the Waveform Analysis source. This command is equivalent to
setting the Sources option in the Waveform Analysis menu.
Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power
Analysis Module only.
Arguments CH1, CH2, CH3, or CH4 specifies one of the input channels as the waveform
analysis source.
NOTE. The "CH3 and CH4" options are only valid for instruments with four
channels.
Group Waveform
Syntax WAVFrm?
Group Waveform
Syntax WFMPre?
Related Commands
Returns The format of the response when the DATa:SOUrce waveform is activated is:
BYT_Nr <NR1>;BIT_Nr <NR1>;ENCdg { ASC | BIN }; BN_Fmt { RI | RP
};BYT_Or { LSB | MSB };NR_Pt <NR1>; WFID <Qstring>;PT_FMT {ENV |
Y};XINcr <NR3>; PT_Off <NR1>;XZERo <NR3>;XUNit<QString>;YMUlt
<NR3>; YZEro <NR3>;YOFF <NR3>;YUNit <QString>
Group Waveform
Syntax WFMPre:<wfm>?
WFMPre:<wfm>:YZEro
Same as WFMPre:YOFf, except that <wfm> specifies the source/destination
waveform instead of DATa:SOUrce and DATa:DESTINATION.
For set commands, if <wfm> is not a reference waveform, the oscilloscope
generates error 2241.
Group Waveform
Syntax WFMPre:<wfm>:YZEro
WFMPre:<wfm>:YZEro?
WFMPre:BIT_Nr
Sets or queries the number of bits per waveform point for the waveform to be
transferred. Changing the value of WFMPre:BIT_Nr also changes the values of
WFMPRe:BYT_Nr and DATa:WIDth.
Group Waveform
Examples WFMPRE:BIT_NR might return 8, indicating that there are 8 bits per waveform
point.
WFMPre:BN_Fmt
Sets or queries the format of binary data for the waveform to be transferred.
Changing the value of WFMPre:BN_Fmt also changes the value of DATa:ENCdg.
Group Waveform
Syntax WFMPre:BN_Fmt { RI | RP }
WFMPre:BN_Fmt?
Examples WFMPRE:BN_FMT RP specifies that the binary waveform data are positive integer
data-points.
WFMPRE:BN_FMT? returns either RI or RP as the current waveform data format.
WFMPre:BYT_Nr
Sets or queries the data width for the waveform to be transferred. This command
is equivalent to DATa:WIDth. Changing WFMPre:BYT_Nr also changes
WFMPre:BIT_Nr and DATa:WIDth.
Group Waveform
Arguments <NR1> is an integer in the range of 1 to 2 that sets the number of bytes per point.
Examples WFMPRE:BYT_NR specifies that there are 2 bytes per waveform data point.
WFMPre:BYT_Or
Sets or queries which byte of binary waveform data is transmitted first during
a waveform data transfer when DATa:WIDth or WFMPre:BYT_Nr is set to
2, or WFMPre:BIT_Nr is set to 16. Changing WFMPre:BYT_Or changes
DATa:ENCdg.
Group Waveform
Examples WFMPRE:BYT_OR MSB specifies that the most significant byte in the waveform
data is transferred first.
WFMPRE:BYT_OR? returns either MSB or LSB depending on which data byte
is transferred first.
WFMPre:ENCdg
Sets or queries the type of encoding for waveform data transferred with the
CURVe command. Changing WFMPre:ENCdg also changes DATa:ENCdg.
Group Waveform
Examples WFMPRE:ENCDG ASC specifies that the waveform data is in ASCII format.
WFMPRE:ENCDG? might return BIN, indicating that the waveform data is in binary
format.
Group Waveform
Syntax WFMPre:NR_Pt?
Examples WFMPRE:NR_PT? might return 1024, which is the number of data points. If
DATa:WIDth is 2, then there are 2048 bytes in the curve.
Returns the number of points that are in the transmitted waveform record.
The number of points depends on DATa:STARt, DATa:STOP, and whether
DATa:SOUrce is YT or FFT. NR_Pt is at most 2500 for YT and 1024 for FFT.
NR_Pt is always at least one.
When the DATa:SOUrce is not displayed, the oscilloscope will generate an error
and return event code 2244.
Group Waveform
Syntax WFMPre:<wfm>:NR_Pt?
Examples WFMPre:CH1:NR_Pt
Returns <NR1>, which is the number of data points. If DATa:WIDth is 2, then
there are <NR1>*2 bytes in the curve.
WFMPre:PT_Fmt
The set form of this command sets the format (Y or ENV) of the reference
waveform specified by the DATa:DESTination command.
The query form returns the format of the waveform specified by the DATa:SOUrce
command, if that waveform is on or displayed. If the waveform is not displayed,
the query form of this command generates an error and returns event code 2244.
Group Waveform
Arguments Y specifies a normal waveform where one ASCII or binary data point is
transmitted for each point in the waveform record.
For Y format, the time (absolute coordinate) of a point, relative to the trigger, can
be calculated using the following formula. N ranges from 0 to 2499.
Xn = XZEro + XINcr (n - PT_OFf)
For Y format, the magnitude (usually voltage, relative to ground) (absolute
coordinate) of a point can be calculated:
Yn = YZEro + YMUIty (yn - YOFf)
ENV specifies that the oscilloscope transmit the waveform as minimum and
maximum point pairs. Peak detect waveforms use ENV format. Peak Detect
mode specifies a maximum of 1250 (minimum, maximum) pairs, with the time
between pairs being 2*XINcr.
The magnitudes and times of ENV format waveform points can be calculated
using the same formulas used for Y format, if you recognize that the points
consist of (minimum, maximum) pairs, where each pair was collected over a
time period of 2*XINcr.
Thus, the samples for n=0 (a minimum) and n=1 (a maximum), the first
(minimum, maximum) pair, were collected over a time interval of width 2*XINcr,
that began at the time found by setting n to zero in the formula. The next pair
were collected over the interval that began at the time found by setting n to 2 in
the formula, and so on.
WFMPre:<wfm>:PT_Fmt
Same as WFMPre:PT_Fmt, except that <wfm> specifies the source/destination
waveform instead of DATa:SOUrce and DATa:DESTINATION. For set
commands, if <wfm> is not a reference waveform, the oscilloscope generates
error 2241.
WFMPre:PT_Off
The set form this command is ignored.
The query form always returns a 0, unless the DATA:SOUrce waveform is not
displayed, in which case the query generates an error and returns event code 2244.
This command is included for compatibility with other Tektronix oscilloscopes.
Group Waveform
Syntax WFMPre:PT_Off
WFMPre:<wfm>:PT_Off
Same as WFMPre:PT_Off, except that <wfm> specifies the source/destination
waveform instead of DATa:SOUrce and DATa:DESTINATION.
For set commands, if <wfm> is not a reference waveform, the oscilloscope
generates error 2241.
Otherwise, the set form of this command is ignored.
Group Waveform
Syntax WFMPre:WFId?
For TBS1000B/EDU.
WFMPRE:WFID? might return: "FFT, DC coupling, 1.0E1 dB/div,
2.52525253E4 Hz/div, 1024 points, Sample mode"
WFMPre:<wfm>:WFId?
Same as WFMPre:WFId, except that <wfm> specifies the source waveform
instead of DATa:SOUrce.
WFMPre:XINcr
The set form of this command specifies the interval (seconds per point for nonFFT,
Hertz per point for FFT) between samples of the reference waveform specified by
the DATa:DESTination command. The oscilloscope uses this value to calculate
the seconds/division or Hertz/division units shown in the status bar and cursor
readouts when displaying a reference waveform.
The query form returns the interval between samples of the waveform specified
by the DATa:SOUrce command, if that waveform is active or displayed. If
that waveform is inactive or not displayed, the query fails and the oscilloscope
generates an execution error with event code 2244 (waveform requested is not
active).
NOTE. For waveform records acquired in Peak Detect mode, even though there is
a pair of samples for each conceptual time period, the XINcr is such that (XINcr *
recl) = the total time over which the data was collected.
Group Waveform
Arguments <NR3> is the interval between points in the waveform record, in the units specified
by WFMPre:XUNit. Note that at some fast sweeps, some points in the waveform
record are produced by interpolation.
WFMPre:<wfm>:XINcr
Same as WFMPre:XINcr, except that <wfm> specifies the source/destination
waveform instead of DATa:SOUrce and DATa:DESTINATION.
For set commands, if <wfm> is not a reference waveform, the oscilloscope
generates error 2241.
WFMPre:XUNit
For all model and firmware combinations except the TDS200 Series with a
TDS2CMA communications module, the set form of this command specifies the
horizontal units ("s" for seconds and "Hz" for Hertz) for the reference waveform
specified by the DATa:DESTination command. Setting a reference waveform to
Hz causes the oscilloscope to display the waveform as an FFT waveform.
The query form returns the horizontal units for the waveform specified by
DATa:SOURce. If the waveform specified by DATa:SOURce is not displayed, the
query generates event message 2244.
Group Waveform
WFMPre:<wfm>:XUNit
Same as WFMPre:XUNit, except that <wfm> specifies the source/destination
waveform instead of DATa:SOUrce and DATa:DESTINATION.
WFMPre:XZEro
The set form of this command specifies the position, in XUNits, of the first
sample of the reference waveform specified by the DATa:DESTination command,
relative to the trigger.
The query form returns the position of the first sample of the waveform specified
by the DATa:SOUrce command, if that waveform is active or displayed.
If that waveform is not active or displayed, the query fails and the oscilloscope
generates an execution error with event code 2244 (waveform requested is not
active).
The oscilloscope sets WFMPre:XZEro to zero when:
The display mode is set to XY.
The DATa:SOUrce is set to MATH FFT when the waveform is acquired.
Group Waveform
WFMPre:<wfm>:XZEro
Same as WFMPre:XZEro, except that <wfm> specifies the source/destination
waveform instead of DATa:SOUrce and DATa:DESTINATION.
For set commands, if <wfm> is not a reference waveform, the oscilloscope
generates error 2241.
WFMPre:YMUlt
YMUlt is a value, expressed in YUNits per digitizer level, used to convert
waveform record values to YUNit values using the following formula (where
dl is digitizer levels):
value_in_YUNits = ((curve_in_dl - YOFF_in_dl) * YMUlt) + YZERO_in_YUNits
The set form of this command sets the vertical scale factor of the reference
waveform specified by the DATa:DESTination command, expressed in YUNits
per digitizing level.
The query form returns a value for the waveform specified by the DATa:SOUrce
command, if that waveform is active or displayed. If that waveform is not active
or displayed, the query fails and the oscilloscope generates an execution error with
event code 2244 (waveform requested is not active).
Group Waveform
Arguments <NR3> is the vertical scale factor, in YUNits (usually volts) per sample value.
Returns A query result of zero has special meaning. A zero indicates the waveform has
unknown vertical scaling. This is possible in the TBS1000B/EDU, TBS1000,
TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, or
TDS200 Series. The TPS2000B/TPS2000 Series will never return zero.
An example of unknown vertical scaling is a math waveform of CH1+CH2
where CH1 vertical scaling is different from CH2 vertical scaling. In this case,
WFMPre:YUNit? returns U. (Does not apply to the TPS2000B/TPS2000 Series.)
WFMPre:<wfm>:YMUlt
Same as WFMPre:YMUlt, except that <wfm> specifies the source/destination
waveform instead of DATa:SOUrce and DATa:DESTINATION.
For set commands, if <wfm> is not a reference waveform, the oscilloscope
generates error 2241.
WFMPre:YOFf
YOFf is a value, expressed in digitizer levels, used to convert waveform record
values to YUNit values using the following formula (where dl is digitizer levels):
value_in_YUNits = ((curve_in_dl - YOFF_in_dl) * YMUlt) + YZERO_in_YUNits
The set form of this command stores a value for the reference waveform specified
by the DATa:DESTination command. This value does not affect how the
oscilloscope displays the waveform, but does affect the cursor readouts.
The query form returns a value for the waveform specified by the DATa:SOUrce
command, in digitizer levels, if that waveform is active or displayed. If that
waveform is not active or displayed, the query fails and the oscilloscope generates
an execution error with event code 2244 (waveform requested is not active).
Group Waveform
WFMPre:<wfm>:YOFf
Same as WFMPre:YOFf, except that <wfm> specifies the source/destination
waveform instead of DATa:SOUrce and DATa:DESTINATION.
For set commands, if <wfm> is not a reference waveform, the oscilloscope
generates error 2241.
WFMPre:YUNit
For all model and firmware combinations except the TDS200 Series with a
TDS2CMA communications module or a TDS2MM measurement module, the set
form of this command sets the vertical units for the reference waveform specified
by DATa:DESTination.
Group Waveform
dB for decibels
WFMPre:<wfm>:YUNit
Same as WFMPre:YUNit, except that <wfm> specifies the source/destination
waveform instead of DATa:SOUrce and DATa:DESTINATION.
For set commands, if <wfm> is not a reference waveform, the oscilloscope
generates error 2241.
WFMPre:YZEro
For all model and firmware combinations except the TDS210 or TDS220
oscilloscope (firmware below V 2.00) with a TDS2CMA communications
module, YZEro is a value, expressed in YUNits, used to convert waveform record
values to YUNit values using the following formula (where dl is digitizer levels):
value_in_YUNits = ((curve_in_dl - YOFF_in_dl) * YMUlt) + YZERO_in_YUNits
YZEro is used when calculating cursor readouts.
The set form of this command affects the reference waveform specified by
DATA:DESTination.
The query form of this command returns a value for the waveform specified by
DATA:SOUrce. If that waveform is not active or displayed, the query fails and
the oscilloscope generates an execution error with event code 2244 (waveform
requested is not active).
NOTE. For the TDS210 or TDS220 oscilloscope (firmware below V 2.00) with a
TDS2CMA communications module, the set form is ignored. The query always
returns zero.
Group Waveform
Group Zoom
Syntax ZOOM?
ZOOM:FACtor
Sets or queries the zoom factor of a particular zoom box.
Group Zoom
Examples ZOOM:FACtor X5 indicates that the specified zoom range is 20% of the acquired
waveform.
ZOOM:HORizontal:POSition
Sets or returns the horizontal position of a particular zoom box.
Group Zoom
Arguments NR3 is 1 to 100. It is the percent of the upper window that is to the left of the
screen center.
Group Zoom
Syntax ZOOM:HORizontal:SCAle?
ZOOM:MODE
Sets or queries the zoom mode as SCAle/POSition.
Group Zoom
ZOOM:STATE
Sets or queries the zoom on/off state.
Group Zoom
Registers
Overview The registers in the event handling system fall into two functional groups:
Status Registers contain information about the status of the oscilloscope.
They include the Standard Event Status Register (SESR).
Enable Registers determine whether selected types of events are reported to
the Status Registers and the Event Queue. They include the Device Event
Status Enable Register (DESER), the Event Status Enable Register (ESER),
and the Service Request Enable Register (SRER).
Status Registers The Standard Event Status Register (SESR) and the Status Byte Register (SBR)
record certain types of events that may occur while the oscilloscope is in use.
IEEE Std 488.2-1987 defines these registers.
Each bit in a Status Register records a particular type of event, such as an execution
error or message available. When an event of a given type occurs, the oscilloscope
sets the bit that represents that type of event to a value of one. (You can disable
bits so that they ignore events and remain at zero. See Enable Registers). Reading
the status registers tells you what types of events have occurred.
The Standard Event Status Register (SESR). The SESR records eight types of
events that can occur within the oscilloscope. Use the *ESR? query to read the
SESR register. Reading the register clears the bits of the register so that the
register can accumulate information about new events.
The Status Byte Register (SBR). Records whether output is available in the Output
Queue, whether the oscilloscope requests service, and whether the SESR has
recorded any events.
Use a Serial Poll or the *STB? query to read the contents of the SBR. The bits in
the SBR are set and cleared depending on the contents of the SESR, the Event
Status Enable Register (ESER), and the Output Queue. When you use a Serial
Poll to obtain the SBR, bit 6 is the RQS bit. When you use the *STB? query to
obtain the SBR, bit 6 is the MSS bit. Reading the SBR does not clear the bits.
Enable Registers DESER, ESER, and SRER allow you to select which events are reported to the
Status Registers and the Event Queue. Each Enable Register acts as a filter to a
Status Register (the DESER also acts as a filter to the Event Queue) and can
prevent information from being recorded in the register or queue.
Each bit in an Enable Register corresponds to a bit in the Status Register it
controls. In order for an event to be reported to a bit in the Status Register, the
corresponding bit in the Enable Register must be set to one. If the bit in the Enable
Register is set to zero, the event is not recorded.
Various commands set the bits in the Enable Registers. The Enable Registers and
the commands used to set them are described below.
The Device Event Status Enable Register (DESER). This register controls which
types of events are reported to the SESR and the Event Queue. The bits in the
DESER correspond to those in the SESR.
Use the DESE command to enable and disable the bits in the DESER. Use the
DESE? query to read the DESER.
The Event Status Enable Register (ESER). This register controls which types of
events are summarized by the Event Status Bit (ESB) in the SBR. Use the *ESE
command to set the bits in the ESER. Use the *ESE? query to read it.
The Service Request Enable Register (SRER). This register controls which bits
in the SBR generate a Service Request and are summarized by the Master Status
Summary (MSS) bit.
Use the *SRE command to set the SRER. Use the *SRE? query to read the
register. The RQS bit remains set to one until either the Status Byte Register is
read with a Serial Poll or the MSS bit changes back to a zero.
*PSC Command The *PSC command controls the Enable Registers contents at power-on. Sending
*PSC 1 sets the Enable Registers at power on as follows:
DESER 255 (equivalent to a DESe 255 command)
ESER 0 (equivalent to an *ESE 0 command)
SRER 0 (equivalent to an *SRE 0 command)
Sending *PSC 0 lets the Enable Registers maintain their values in nonvolatile
memory through a power cycle.
NOTE. To enable the PON (Power On) event to generate a Service Request, send
*PSC 0, use the DESe and *ESE commands to enable PON in the DESER and
ESER, and use the *SRE command to enable bit 5 in the SRER. Subsequent
power-on cycles will generate a Service Request.
Queues
The *PSC command controls the Enable Registers contents at power-on. Sending
*PSC 1 sets the Enable Registers at power on as follows:
Output Queue The oscilloscope stores query responses in the Output Queue and empties this
queue each time it receives a new command or query message after an <EOM>.
The controller must read a query response before it sends the next command (or
query) or it will lose responses to earlier queries.
Event Queue The Event Queue stores detailed information on up to 20 events. If than 20
events stack up in the Event Queue, the 20th event is replaced by event code
350, "Queue Overflow."
Read the Event Queue with the EVENT? query (which returns only the event
number), with the EVMSG? query (which returns the event number and a text
description of the event), or with the ALLEV? query (which returns all the event
numbers with a description of the event). Reading an event removes it from the
queue.
Before reading an event from the Event Queue, you must use the *ESR? query to
read the summary of the event from the SESR. This makes the events summarized
by the *ESR? read available to the EVENT? and EVMSG? queries, and empties
the SESR.
Reading the SESR erases any events that were summarized by previous *ESR?
reads but not read from the Event Queue. Events that follow an *ESR? read are
put in the Event Queue but are not available until *ESR? is used again.
Synchronization Methods
Overview Although most commands are completed almost immediately after being received
by the oscilloscope, some commands start a process that requires time. For
example, once a single sequence acquisition command is executed, depending
upon the applied signals and trigger settings, it may take an extended period
of time before the acquisition is complete. Rather than remain idle while the
operation is in process, the oscilloscope will continue processing other commands.
This means that some operations will not be completed in the order that they
were sent.
Sometimes the result of an operation depends on the result of an earlier operation.
A first operation must complete before the next one is processed. The oscilloscope
status and event reporting system is designed to accommodate this process.
The Operation Complete (OPC) bit of the Standard Event Status Register (SESR)
can be programmed to indicate when certain oscilloscope operations have
completed and, by setting the Event Status Enable Register (ESER) to report
OPC in the Event Status Bit (ESB) of the Status Byte Register (SBR) and setting
the Service Request Enable Register (SRER) to generate service request upon a
positive transition of the ESB, a service request (SRQ) interrupt can be generated
when certain operations complete as described in this section.
The following oscilloscope operations can generate an OPC:
The acquisition of the waveform requires extended processing time. It may not
finish before the oscilloscope takes an amplitude measurement (see the following
figure). This can result in an incorrect amplitude value.
Using the *WAI Command The *WAI command forces completion of previous commands that generate
an OPC message. No commands after the *WAI are processed before the OPC
message(s) are generated
The same command sequence using the *WAI command for synchronization
looks like this:
The controller can continue to write commands to the input buffer of the
oscilloscope, but the commands will not be processed by the oscilloscope until
all in-process OPC operations are complete. If the input buffer becomes full,
the controller will be unable to write commands to the buffer. This can cause a
time-out.
Using the BUSY Query The BUSY? query allows you to find out whether the oscilloscope is
busy processing a command that has an extended processing time such as
single-sequence acquisition.
The same command sequence, using the BUSY? query for synchronization, looks
like this:
/* Set up conditional acquisition */
ACQUIRE:STATE OFF
SELECT:CH1 ON
ACQUIRE:MODE SAMPLE
ACQUIRE:STOPAFTER SEQUENCE
/* Acquire waveform data */
ACQUIRE:STATE ON
/* Set up the measurement parameters */
MEASUREMENT:IMMED:TYPE AMPLITUDE
MEASUREMENT:IMMED:SOURCE CH1
/* Wait until the acquisition is complete before taking
the measurement */
While BUSY? keep looping
/* Take amplitude measurement */
MEASUREMENT:IMMED:VALUE?
This sequence lets you create your own wait loop rather than using the *WAI
command. The BUSY? query helps you avoid time-outs caused by writing too
many commands to the input buffer. The controller is still tied up though, and
the repeated BUSY? query will result in bus traffic.
Using the *OPC Command If the corresponding status registers are enabled, the *OPC command sets the
OPC bit in the Standard Event Status Register (SESR) when an operation is
complete. You achieve synchronization by using this command with either a
serial poll or service request handler.
Serial Poll Method: Enable the OPC bit in the Device Event Status Enable
Register (DESER) and the Event Status Enable Register (ESER) using the DESE
and *ESE commands.
When the operation is complete, the OPC bit in the Standard Event Status Register
(SESR) will be enabled and the Event Status Bit (ESB) in the Status Byte Register
will be enabled.
The same command sequence using the *OPC command for synchronization with
serial polling looks like this:
/* Set up conditional acquisition */
ACQUIRE:STATE OFF
SELECT:CH1 ON
ACQUIRE:MODE SAMPLE
ACQUIRE:STOPAFTER SEQUENCE
/* Enable the status registers */
DESE 1
*ESE 1
*SRE 0
/* Acquire waveform data */
ACQUIRE:STATE ON
/* Set up the measurement parameters */
MEASUREMENT:IMMED:TYPE AMPLITUDE
MEASUREMENT:IMMED:SOURCE CH1
/* Wait until the acquisition is complete before taking the
measurement.*/
*OPC
While serial poll = 0, keep looping
/* Take amplitude measurement */
MEASUREMENT:IMMED:VALUE?
This technique requires less bus traffic than did looping on BUSY.
Service Request Method: Enable the OPC bit in the Device Event Status Enable
Register (DESER) and the Event Status Enable Register (ESER) using the DESE
and *ESE commands.
You can also enable service requests by setting the ESB bit in the Service Request
Enable Register (SRER) using the *SRE command. When the operation is
complete, the oscilloscope will generate a Service Request.
The same command sequence using the *OPC command for synchronization
looks like this
/* Set up conditional acquisition */
ACQUIRE:STATE OFF
SELECT:CH1 ON
ACQUIRE:MODE SAMPLE
ACQUIRE:STOPAFTER SEQUENCE
/* Enable the status registers */
DESE 1
*ESE 1
*SRE 32
/* Acquire waveform data */
ACQUIRE:STATE ON
/* Set up the measurement parameters */
MEASUREMENT:IMMED:TYPE AMPLITUDE
MEASUREMENT:IMMED:SOURCE CH1
/* Wait until the acquisition is complete before taking the
measurement*/
*OPC
The program can now do different tasks such as talk to other devices. The SRQ,
when it comes, interrupts those tasks and returns control to this task.
/* Take amplitude measurement */
MEASUREMENT:IMMED:VALUE?
Using the *OPC? Query The *OPC? query places a 1 in the Output Queue once an operation that generates
an OPC message is complete. The *OPC? query does not return until all pending
OPC operations have completed. Therefore, your time-out must be set to a time at
least if the longest expected time for the operations to complete.
The same command sequence using the *OPC? query for synchronization looks
like this:
/* Set up single sequence acquisition */
ACQUIRE:STATE OFF
SELECT:CH1 ON
ACQUIRE:MODE SAMPLE
ACQUIRE:STOPAFTER SEQUENCE
/* Acquire waveform data */
ACQUIRE:STATE ON
/* Set up the measurement parameters */
MEASUREMENT:IMMED:TYPE AMPLITUDE
MEASUREMENT:IMMED:SOURCE CH1
/* Wait until the acquisition is complete before taking the
measurement*/
*OPC?
Messages The information contained in the topic tabs above covers all the programming
interface messages the oscilloscope generates in response to commands and
queries.
For most messages, a secondary message from the oscilloscope gives detail about
the cause of the error or the meaning of the message. This message is part of the
message string and is separated from the main message by a semicolon.
Each message is the result of an event. Each type of event sets a specific bit in the
SESR and is controlled by the equivalent bit in the DESER. Thus, each message
is associated with a specific SESR bit. In the message tables, the associated SESR
bit is specified in the table title, with exceptions noted with the error message text.
No Event The following table shows the messages when the system has no events or status
to report. These have no associated SESR bit.
Command Error The following table shows the command error messages generated by improper
syntax. Check that the command is properly formed and that it follows the rules
in the section on command Syntax.
Execution Error The following table lists the execution errors that are detected during execution of
a command.
Device Error The following table lists the device errors that can occur during oscilloscope
operation. These errors may indicate that the oscilloscope needs repair.
System Event The following table lists the system event messages. These messages are
generated whenever certain system conditions occur.
Execution Warning The following table lists warning messages that do not interrupt the flow of
command execution. They also notify you of a possible unexpected results.
Internal Warning The following table shows internal errors that indicate an internal fault in the
oscilloscope.
1
> REM "Use the oscilloscope built-in measurements to measure the waveform
you acquired."
> MEASU:IMMED:TYPE MEAN
> MEASU:IMMED:VALUE?
:MEASUREMENT:IMMED:VALUE 2.4631931782E0
> REM "Be sure to use the *esr? query to check for measurement errors."
> MEASU:IMMED:TYPE FREQ
> MEASU:IMMED:VALUE?
:MEASUREMENT:IMMED:VALUE 9.9E37
> *ESR?
16
> ALLEV?
:ALLEV 2202,"Measurement error, No period found; "
> REM "Query out the waveform points, for later analysis on your controller
computer." > data:encdg ascii
> CURVE?
:CURVE 7,6,5,5,5,6,6,6,8 [...]
> REM "Query out the parameters used for calculating the times and voltages of
the waveform points."
> WFMPRE?
:WFMPRE:BYT_NR 1;BIT_NR 8;ENCDG ASC;BN_FMT RP;BYT_OR
MSB;NR_PT 2500; [...]
(<SAVE:IMAGE:FILEFORMAT BMP;>)
(:LANGUAGE ENGLISH)
TDS224 Oscilloscopes
Items enclosed in < > brackets are present only when the TDS2MM module is
installed.
:HEADER 1;(:VERBOSE 1;)
:DATA:ENCDG RIBINARY;DESTINATION REFA;SOURCE CH1; START
1;STOP 2500;WIDTH 1;
(:LOCK NONE;)
:DISPLAY:FORMAT YT;STYLE VECTORS;PERSISTENCE 0; CONTRAST
50;
:ACQUIRE:MODE SAMPLE;NUMAVG 16;STATE 1;STOPAFTER RUNSTOP;
:CH1:PROBE 10;SCALE 1.0E0;POSITION 0.0E0;COUPLING
DC;BANDWIDTH OFF;INVERT OFF;
:CH2:PROBE 10;SCALE 1.0E0;POSITION 0.0E0;COUPLING
DC;BANDWIDTH OFF;INVERT OFF;
:CH3:PROBE 10;SCALE 1.0E0;POSITION 0.0E0;COUPLING
DC;BANDWIDTH OFF;INVERT OFF;
:CH4:PROBE 10;SCALE 1.0E0;POSITION 0.0E0;COUPLING
DC;BANDWIDTH OFF;INVERT OFF;
:HORIZONTAL:VIEW MAIN;MAIN:SCALE 5.0E-4;POSITION 0.0E0;
:HORIZONTAL:DELAY:SCALE 5.0E-5; POSITION 0.0E0;
:TRIGGER:MAIN:MODE AUTO;TYPE EDGE; HOLDOFF:VALUE 5.0E-7;
:TRIGGER:MAIN:EDGE:SOURCE CH1;COUPLING DC;SLOPE RISE;
:TRIGGER:MAIN:VIDEO:SOURCE CH1;SYNC LINE;POLARITY NORMAL;
:TRIGGER:MAIN:LEVEL 0.0E0;
:SELECT:CH1 1;CH2 0;CH3 0;CH4 0;MATH 0;REFA 0; REFB 0;REFC
0;REFD 0;
:CURSOR:FUNCTION OFF;SELECT:SOURCE CH1;
Any device requesting service returns a status byte with bit 6 set and then
unasserts the SRQ line (GPIB only). Devices not requiring service return a status
byte with bit 6 cleared.
USB
An acronym for Universal Serial Bus.
USBTMC
An acronym for USB Test and Measurement Class.
USB488
The USBTMC subclass specification that implements an IEEE488-like interface
over USB.
V
VERBose, 2-207