SDS Series Programming Guide
SDS Series Programming Guide
Digital Oscilloscope
Programming Guide
EN11D
Feb, 2023
SDS Series Programming Guide
Trademark Information
Declaration
SIGLENT reserves the right to modify or change parts of or all the specifications or pricing
policies at the companys.
Any way of copying, extracting or translating the contents of this manual is not allowed without
the permission of SIGLENT.
Product Certification
SIGLENT guarantees this product conforms to the national and industrial standards in China and
other international standard conformance certifications are in progress.
Contact Us
If you have any problem or requirement when using our products, please contact SIGLENT
TECHNOLOGIES CO., LTD
Headquarters
SIGLENT Technologies Co., Ltd.
Add: Blog No.4 & No.5, Antongda Industrial Zone, 3rd Liuxian Road,
Bao’an District, Shenzhen, 518101, China.
Tel: + 86 755 3688 7876
Fax: + 86 755 3359 1582
Emall: [email protected]
Website: www.siglent.com/ens
www.siglent.com 1 / 757
SD S Series Pr ogrammin g Guide
Europe
SIGLENT Technologies Germany GmbH
Add: Staetzlinger Str. 70, 86165 Augsburg, Germany
Tel: +49(0)-821-666 0 111 0
Fax: +49(0)-821-666 0 111 22
Emall: [email protected]
Website www.siglenteu.com
America
2 / 757 www.siglent.com
SDS Series Programming Guide
Version Declaration
This chapter declares the modifications of command in the most recent release of the programming
guide version.
New commands for parameter settings of filter, maxhold, interpolation, average and eres
function operators
Supplementary path description of save commands, the path type can be local, network storage,
and udisk.
Support memory source(Mx), function source(Fx), digital bus(DIGital) for save commands.
Modify the description of “SAVE:MATLab”, which can only be saved in mat format at present.
The return header of “WAVeform:DATA” shows the number of digits according to the actual data
length, instead of the fixed 9 digits.
www.siglent.com 3 / 757
SD S Series Pr ogrammin g Guide
DVM commands.
Memory commands.
Update C# example.
Measure threshold
Network storage
4 / 757 www.siglent.com
SDS Series Programming Guide
www.siglent.com 5 / 757
SD S Series Pr ogrammin g Guide
Supported Models
The commands and queries listed in this document can be used for SIGLENTs Digital Oscilloscope
Series as shown below. Models are arranged according to their initial release dates.
SDS6000 Pro/
1.1.7.0 and later
SDS6000A
SHS800X/
1.1.9 and later
SHS1000X
SDS6000L 1.0.1.0
6 / 757 www.siglent.com
SDS Series Programming Guide
Programming Overview
This chapter introduces how to build communication between the instrument and the PC. It also
introduces how to configure a system for remote instrument control.
Users can remotely control the instrument through USB and LAN interfaces, in combination with
National Instruments NI-VISA and programming languages. Through the LAN interface, users can
communicate using VXI-11, Sockets and Telnet protocols, depending on the capabilities of the
specific instrument.
Establishing Communications
Install NI-VISA
USB control requires the National Instruments NI-VISA Library for communications. We also
recommend using it for LAN communications for its ease of use, but sockets, telnet, and VXI-11 can
also be implemented via LAN connections.
Currently, NI-VISA is packaged in two versions: A full version and a Run-Time Engine version. The
full version includes the NI device drivers and a tool named NI MAX which is a user interface to
control and test remotely connected devices. The Run-Time Engine is recommended, as it is a much
smaller download than the full version and includes the necessary tools for basic communication to
instruments.
For example, you can get the NI-VISA 5.4 full version from
http://www.ni.com/download/ni-visa-5.4/4230/en/.
You also can download NI-VISA Run-Time Engine 5.4 to your PC and install it as the default
selection. Its installation process is similar to the full version.
After you downloaded the file, follow these steps to install NI-VISA (The full version of NI-VISA 5.4 is
used in this example. Newer versions are likely and should be compatible with SIGLENT
instrumentation. Download the latest version available for the operating system being used by the
controlling computer):
a. Double click the visa540_full.exe, the dialog will be similar to that shown below:
www.siglent.com 7 / 757
SD S Series Pr ogrammin g Guide
b. Click Unzip, the installation process will automatically launch after unzipping files. If your
computer needs to install .NET Framework 4, it may auto start.
c. The NI-VISA installing dialog is shown above. Click Next to start the installation process.
d. Set the install path. The default path is “C:\Program Files\National Instruments\”, you can
change it. Click Next, dialog shown as above.
8 / 757 www.siglent.com
SDS Series Programming Guide
e. Click Next twice, in the License Agreement dialog, select the “I accept the above 2 License
Agreement(s).”, and click Next, dialog shown as below:
www.siglent.com 9 / 757
SD S Series Pr ogrammin g Guide
Depending on the specific model, your oscilloscope may be able to communicate with a PC through
the USB or LAN interface.
Connect the instrument and the USB Host interface of the PC using a USB cable. Assuming your PC
is already turned on, turn on your oscilloscope, and then the PC will display the “Device Setup”
screen as it automatically installs the device driver as shown below.
Wait for the installation to complete and then proceed to the next step.
10 / 757 www.siglent.com
SDS Series Programming Guide
Remote Control
User-defined Programming
Users can use SCPI commands via a computer to program and control the digital oscilloscope. For
details, refer to the introductions in "Programming Examples".
Telnet provides a means of communicating with the oscilloscopes over a LAN connection. The Telnet
protocol sends SCPI commands to the oscilloscopes from a PC and is similar to communicating with
the oscilloscopes over USB. It sends and receives information interactively: one command at a time.
Windows operating systems use a command prompt style interface for the Telnet client. The steps
are as follows:
1. On your PC, click Start > All Programs > Accessories > Command Prompt.
3. Press the Enter key. The Telnet display screen will be displayed.
Where XXX.XXX.XXX.XXX is the instrument’s IP address and 5024 is the port. You should see
a response similar to the following:
www.siglent.com 11 / 757
SD S Series Pr ogrammin g Guide
5. At the SCPI> prompt, input the SCPI commands such as *IDN? to return the company name,
model number, serial number, and firmware version number.
7. Type quit at the prompt or close the Telnet window to close the connection to the instrument and
exit Telnet.
Socket API can be used to control the SDS2000X Plus series via LAN without installing any other
libraries. This can reduce the complexity of programming.
Please see the section "Examples of Using Sockets" for the details.
12 / 757 www.siglent.com
SDS Series Programming Guide
Commands consist of set commands and query commands (usually called commands and queries).
Commands modify oscilloscope settings or tell the oscilloscope to perform a specific action. Queries
cause the oscilloscope to return data and status information. Not all commands have both a set and
a query form. Some commands have set only and some have query only.
Commands usually start with a colon [:]. A keyword is separated by a colon (:) followed by optional
parameter settings. A question mark (?) is added after the command line to indicate that this function
is queried. The command keyword is separated from the first parameter by spaces.
Example:
:CHANnel:SCALe <value>
:CHANnel:SCALe?
Each command has both a long and a short form. Note that elsewhere in this document a special
notation is employed to differentiate the short form keyword from the long form of the same keyword.
The long form of the keyword is shown, with the short form portion shown in uppercase characters,
and the rest of the keyword is shown in lowercase characters. If you want to abbreviate, you have to
type all the capital letters in the command format.
Example:
:CHANnel1:SCALe?
:CHAN1:SCAL?
Syntax Notation
:= (Defined As)
A colon followed by an equals sign separates a placeholder from the description of the type and
range of values that may be used in a command instead of the placeholder.
www.siglent.com 13 / 757
SD S Series Pr ogrammin g Guide
{ } (Braces)
Braces or curly brackets are used to enclose one or more parameters that may be included zero or
more times. The vertical bar (|) can be read as “or” and is used to separate alternative parameter
options.
[ ] (Square Brackets)
Square brackets are used to enclose a keyword that is optional when programming the command;
that is, the instrument shall process the command to have the same effect whether the option node is
omitted by the programmer or not.
… (Ellipsis)
An ellipsis (trailing dots) indicates that the preceding element may be repeated one or more times.
Parameter Types
Enumeration
Enter these arguments as unquoted text words. Like keywords, enumeration arguments follow the
same convention where the portion indicated in uppercase is required and that in lowercase is
optional.
Numeric
Many oscilloscope commands require numeric arguments. The syntax shows the format that the
oscilloscope returns in response to a query. This is also the preferred format when sending the
command to the oscilloscope, though any of the formats will be accepted. This documentation
represents these arguments as described below.
Type Meaning
<NR1> Signed integer value
<NR2> Floating point value without an exponent
<NR3> Floating point value with an exponent
<bin> Signed or unsigned integer in binary format
Quoted String
A quoted string is simply a group of ASCII characters enclosed by double quote ("). The following is
an example of a quoted string: "This is a quoted string". This documentation represents these
arguments as follows: Some commands accept or return data in the form of a quoted string
Type Meaning
<qstring> Quoted string of ASCII text
14 / 757 www.siglent.com
SDS Series Programming Guide
A quoted string can include any character defined in the 7-bit ASCII character set. Follow these rules
when you use quoted strings:
1. Use a double quote character to open and close the string.
2. You can mix quotation marks within a string as long as you follow the previous rule. But cannot
include a double quote character within a string by repeating the quote.
3. You cannot include double quotes character within a string by repeating the double quote.
4. Strings can have upper or lower case characters. But the oscilloscope will automatically convert
it to uppercase.
5. A carriage return or line feed embedded in a quoted string will be recognized as the string.
"here is a " " mark" (Duplicate double quotes inside double quotes)
www.siglent.com 15 / 757
SD S Series Pr ogrammin g Guide
16 / 757 www.siglent.com
SDS Series Programming Guide
*IDN
*OPC
*RST
www.siglent.com 17 / 757
SD S Series Pr ogrammin g Guide
*IDN
Query
Query message:
*IDN?
Response message:
Siglent
Technologies,SDS5104X,SDS5XDAD2R0160,4.6.0.8.7R1
18 / 757 www.siglent.com
SDS Series Programming Guide
*OPC
Query
DESCRIPTION The command query places an ASCII "1" in the output queue
when all pending device operations have completed. The
interface hangs until this query returns.
RESPONSE FORMAT 1
Response message:
1
www.siglent.com 19 / 757
SD S Series Pr ogrammin g Guide
*RST
Command
Command message:
*RST
20 / 757 www.siglent.com
SDS Series Programming Guide
Root(:) Commands
The Root commands for querying the basic information of an instrument or performing common
basic operations. These commands are only located at the root of the command tree, with no next
level and no parameters.
:AUToset
www.siglent.com 21 / 757
SD S Series Pr ogrammin g Guide
:AUToset
Command
Query
DESCRIPTION The query captures the screen and returns the data in specified
image format.
<type>:= {BMP|PNG}
BMP selects bitmap format
PNG selects Portable Networks Graphics format
22 / 757 www.siglent.com
SDS Series Programming Guide
:FORMat:DATA
Command/Query
DESCRIPTION The command sets the returned precision of the command with
data in NR1/NR3 format. The current default precision is
3-digits.
<option>:= {SINGle|DOUBle|CUSTom}
SINGle indicates that the single precision type and
significant digit is 7.
DOUBle indicates that the double precision type and
significant digit is 14.
CUSTom is user-defined precision, and <digit> need to be
set.
EXAMPLE The following command sets the returned data precision of the
command to 5-digits.
Command message:
:FORMat:DATA CUSTom,5
FORM:DATA CUST,5
Query message:
FORM:DATA?
Response message:
CUSTom,5
www.siglent.com 23 / 757
SD S Series Pr ogrammin g Guide
ACQUire Commands
The :ACQUIRE subsystem commands control the way in which waveforms are acquired. These
commands set the parameters for acquiring and storing data.
:ACQuire:AMODe
:ACQuire:CSWeep
:ACQuire:INTerpolation
:ACQuire:MMANagement
:ACQuire:MODE
:ACQuire:MDEPth
:ACQuire:NUMAcq
:ACQuire:POINts
:ACQuire:SEQuence
:ACQuire:SEQuence:COUNt
:ACQuire:SRATe
:ACQuire:TYPE
24 / 757 www.siglent.com
SDS Series Programming Guide
:ACQuire:AMODe
Command/Query
<rate>:= {FAST|SLOW}
EXAMPLE The following command sets the FAST acquisition rate mode.
Command message:
:ACQuire:AMODe FAST
ACQ:AMOD FAST
Query message:
ACQ:AMOD?
Response message:
FAST
www.siglent.com 25 / 757
SD S Series Pr ogrammin g Guide
:ACQuire:CSWeep
Command
DESCRIPTION The command clears the sweep and restarts the acquisition. It
is equivalent to the Clear Sweeps button on the front panel.
Command message:
:ACQuire:CSWeep
ACQ:CSW
26 / 757 www.siglent.com
SDS Series Programming Guide
:ACQuire:INTerpolation
Command/Query
<state>:= {ON|OFF}
ON selects sinx/x (sinc) interpolation
OFF selects linear interpolation
<state>:= {ON|OFF}
Command message:
:ACQuire:INTerpolation ON
ACQ:INT ON
Query message:
ACQ:INT?
Response message:
ON
www.siglent.com 27 / 757
SD S Series Pr ogrammin g Guide
:ACQuire:MMANagement
Command/Query
<mem_mode>:= {AUTO|FSRate|FMDepth}
AUTO mode maintain the maximum sampling rate, and
automatically set the memory depth and sampling rate
according to the time base.
FSRate mode is Fixed Samling Rate, maintain the
specified sampling rate and automatically set the memory
depth according to the time base.
FMDepth mode is Fixed Memory Depth, the oscilloscope
automatically sets the sampling rate according to the
storage depth and time base.
Command message:
:ACQuire:MMANagement FMDepth
ACQ:MMAN FMD
Query message:
ACQ:MMAN?
Response message:
FMDepth
28 / 757 www.siglent.com
SDS Series Programming Guide
:ACQuire:MODE
Command/Query
<mode_type>:= {YT|XY|ROLL}
YT mode plots amplitude (Y) vs. time (T)
XY mode plots channel X vs. channel Y, commonly
referred to as a Lissajous curve
Roll mode plots amplitude (Y) vs. time (T) as in YT mode,
but begins to write the waveforms from the right-hand side
of the display. This is similar to a “strip chart” recording and
is ideal for slow events that happen a few times/second.
<mode_type>:= {YT|XY|ROLL}
Command message:
:ACQuire:MODE YT
ACQ:MODE YT
Query message:
ACQ:MODE?
Response message:
YT
www.siglent.com 29 / 757
SD S Series Pr ogrammin g Guide
:ACQuire:MDEPth
Command/Query
Note:
• For the definition of single and dual channel mode, please
refer to the user manual.
• Turn on digital channels or set the acquisition type to
AVERage/ERES or set the acquisition mode to roll, will
limit the memory depth.
30 / 757 www.siglent.com
SDS Series Programming Guide
EXAMPLE The following command sets the memory depth to 125 Mpts for
the SDS5000X series.
Command message:
:ACQuire:MDEPth 125M
ACQ:MDEP 125M
Query message:
:ACQ:MDEP?
Response message:
125M
www.siglent.com 31 / 757
SD S Series Pr ogrammin g Guide
:ACQuire:NUMAcq
Query
EXAMPLE The following query returns that 350 acquisitions have occurred
since starting acquisition.
Query message:
:ACQuire:NUMAcq?
ACQ:NUMA?
Response message:
350
32 / 757 www.siglent.com
SDS Series Programming Guide
:ACQuire:POINts
Query
DESCRIPTION The query returns the number of sampled points of the current
waveform on the screen.
Query message:
ACQ:POIN?
Response message:
1.25E+08
www.siglent.com 33 / 757
SD S Series Pr ogrammin g Guide
:ACQuire:RESolution
Command/Query
DESCRIPTION The command sets the ADC resolution for SDS2000X Plus
oscilloscope.
<bit>:= {8Bits|10Bits}
<bit>:= {8Bits|10Bits}
Command message:
:ACQuire:RESolution 10Bits
ACQ:RES 10B
Query message:
ACQ:RES?
Response message:
10Bits
34 / 757 www.siglent.com
SDS Series Programming Guide
:ACQuire:SEQuence
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:ACQuire:SEQuence ON
ACQ:SEQ ON
Query message:
ACQ:SEQ?
Response message:
ON
www.siglent.com 35 / 757
SD S Series Pr ogrammin g Guide
:ACQuire:SEQuence:COUNt
Command/Query
Command message:
:ACQuire:SEQuence:COUNt 5
ACQ:SEQ:COUN 5
Query message:
ACQ:SEQ:COUN?
Response message:
5
36 / 757 www.siglent.com
SDS Series Programming Guide
:ACQuire:SRATe
Command/Query
DESCRIPTION The command set the sampling rate when in the fixed sampling
rare mode.
Command message:
:ACQuire:SRATe 5.00E9
ACQ:SRAT 5.00E9
Query message:
ACQ:SRAT?
Response message:
5.00E+09
www.siglent.com 37 / 757
SD S Series Pr ogrammin g Guide
:ACQuire:TYPE
Command/Query
DESCRIPTION The command selects the type of data acquisition that is to take
place.
<type>:= {NORMal|PEAK|AVERage[,<times>]|ERES[,<bits>]}
<times>:= {4|16|32|64|128|256|512|1024}
<bits>:= {0.5|1.0|1.5|2.0|2.5|3.0}
NORMal sets the oscilloscope to normal mode.
PEAK sets the oscilloscope to peak detect mode.
AVERage sets the oscilloscope acquisition to averaging
mode. You can set the number of averages by sending the
command followed by a numeric integer value <times>.
ERES sets the oscilloscope to the enhanced resolution
mode. This is essentially a digital boxcar filter and is used
to reduce noise at slower sweep speeds. You can set the
enhanced bits by sending the command followed by the
<bits>.
Note:
The AVERage|ERES type is not available when in sequence
mode (:ACQuire:SEQuence ON).
<type>:= {NORMal|PEAK|AVERage[,<times>]|ERES[,<bits>]}
Command message:
:ACQuire:TYPE AVERage,16
ACQ:TYPE AVER,16
Query message:
ACQ:TYPE?
Response message:
AVERage,16
38 / 757 www.siglent.com
SDS Series Programming Guide
CHANnel Commands
The :CHANnel<n> subsystem commands control the analog channels. Channels are independently
programmable for offset, probe, coupling, bandwidth limit, inversion, and more functions. The
channel index (1, 2, 3, or 4) specified in the command selects the analog channel that is affected by
the command.
:CHANnel:REFerence
:CHANnel<n>:BWLimit
:CHANnel<n>:COUPling
:CHANnel<n>:IMPedance
:CHANnel<n>:INVert
:CHANnel<n>:LABel
:CHANnel<n>:LABel:TEXT
:CHANnel<n>:OFFSet
:CHANnel<n>:PROBe
:CHANnel<n>:SCALe
:CHANnel<n>:SKEW
:CHANnel<n>:SWITch
:CHANnel<n>:UNIT
:CHANnel<n>:VISible
www.siglent.com 39 / 757
SD S Series Pr ogrammin g Guide
:CHANnel:REFerence
Command/Query
DESCRIPTION This command sets the strategy for the offset value change in
the vertical direction when the vertical scale is changed.
<type>:= {OFFSet|POSition}
OFFset means when the vertical scale is changed, the
vertical offset remains fixed. As the vertical scale is
changed, the waveform expands/contracts around the
main X-axis of the display.
POSition means when the vertical scale is changed, the
vertical offset remains fixed to the grid position on the
display. As the vertical scale is changed, the waveform
expands/contracts around the position of the vertical
ground position on the display.
<type>:= {OFFSet|POSition}
Command message:
:CHANnel:REFerence OFFSet
CHAN:REF OFFS
Query message:
CHAN:REF?
Response message:
OFFSet
40 / 757 www.siglent.com
SDS Series Programming Guide
:CHANnel<n>:BWLimit
Command/Query
<bwlimit>:= {FULL|20M|200M}
FULL sets the oscilloscope bandwidth to full.
20M enables the 20 MHz bandwidth filter.
200M enables the 200 MHz bandwidth filter.
<bwlimit>:= {FULL|20M|200M}
Command message:
:CHANnel1:BWLimit 20M
CHAN1:BWL 20M
Query message:
CHAN1:BWL?
Response message:
20M
www.siglent.com 41 / 757
SD S Series Pr ogrammin g Guide
:CHANnel<n>:COUPling
Command/Query
DESCRIPTION The command selects the coupling mode of the specified input
channel.
<coupling_mode>:= {DC|AC|GND}
DC sets the channel coupling to DC.
AC sets the channel coupling to AC.
GND sets the channel coupling to Ground.
<coupling_mode>:= {DC|AC|GND}
Command message:
:CHANnel1:COUPling AC
CHAN1:COUP AC
Query message:
CHAN1:COUP?
Response message:
AC
42 / 757 www.siglent.com
SDS Series Programming Guide
:CHANnel<n>:IMPedance
Command/Query
<impedance>:= {ONEMeg|FIFTy}
ONEMeg means 1 Mohm.
FIFTy means 50 ohm.
Note:
When set to FIFTy, the range of legal values set by
the :CHAN<n>:SCAL commands is limited to less than 1 V.
<impedance>:= {ONEMeg|FIFTy}
Command message:
:CHANnel2:IMPedance ONEMeg
CHAN2:IMP ONEM
Query message:
CHAN2:IMP?
Response message:
ONEMeg
www.siglent.com 43 / 757
SD S Series Pr ogrammin g Guide
:CHANnel<n>:INVert
Command/Query
<state>:= {ON|OFF}
ON enables channel inversion.
Off disables channel inversion.
<state>:= {ON|OFF}
Command message:
:CHANnel2:INVert ON
CHAN2:INV ON
Query message:
CHAN2:INV?
Response message:
ON
44 / 757 www.siglent.com
SDS Series Programming Guide
:CHANnel<n>:LABel
Command/Query
<state>:= {ON|OFF}
ON enables the channel label.
OFF disables the channel label.
<state>:= {ON|OFF}
Command message:
:CHANnel1:LABel ON
CHAN1:LAB ON
Query message:
CHAN1:LAB?
Response message:
ON
www.siglent.com 45 / 757
SD S Series Pr ogrammin g Guide
:CHANnel<n>:LABel:TEXT
Command/Query
DESCRIPTION The command sets the selected channel label to the string that
follows. Setting a label for a channel also adds the name to the
label list in non-volatile memory (replacing the oldest label in
the list)
The query returns the current label text of the selected channel.
Note:
All characters will be automatically converted to uppercase.
Command message:
:CHANnel2:LABel:TEXT ”VOUT”
CHAN2:LAB:TEXT “VOUT”
Query message:
CHAN2:LAB:TEXT?
Response message:
“VOUT”
46 / 757 www.siglent.com
SDS Series Programming Guide
:CHANnel<n>:OFFSet
Command/Query
Note:
The range of legal values varies with the value set by
the :CHANnel<n>:SCALe commands.
Command message:
:CHANnel2:OFFSet -3.8E+00
CHAN1:OFFS -3.8E+00
Query message:
CHAN1:OFFS?
Response message:
-3.8E+00
www.siglent.com 47 / 757
SD S Series Pr ogrammin g Guide
:CHANnel<n>:PROBe
Command/Query
DESCRIPTION The command specifies the probe attenuation factor for the
selected channel. This command does not change the actual
input sensitivity of the oscilloscope. It changes the reference
constants for scaling the display factors, for making automatic
measurements, and for setting trigger levels.
The query returns the current probe attenuation factor for the
selected channel.
<attenuation>:= {DEFault|VALue}
DEFault means set to the default value 1X.
VALue means set to the <value>.
Command message:
:CHANnel1:PROBe VALue,1.00E+02
CHAN1:PROB VAL,1.00E+02
Query message:
CHAN1:PROB?
Response message:
1.00E+02
48 / 757 www.siglent.com
SDS Series Programming Guide
:CHANnel<n>:SCALe
Command/Query
Note:
The range of value varies from the models and the bandwidth
of the model. See the data sheet for details.
Channel 1 to 50 mV/div
Command message:
:CHANnel1:SCALe 5.00E-02
CHAN1:SCAL 5.00E-02
Query message:
CHAN1:SCAL?
Response message:
5.00E-02
5.00E-01 (when the probe attenuation ratio is 10:1)
www.siglent.com 49 / 757
SD S Series Pr ogrammin g Guide
:CHANnel<n>:SKEW
Command/Query
DESCRIPTION The command sets the channel-to-channel skew factor for the
specified channel.
The query returns the current probe skew setting for the selected
channel.
EXAMPLE The following command sets the skew of Channel 1 to 1.52 ns.
Command message:
:CHANnel1:SKEW 1.52E-09
CHAN1:SKEW 1.52E-09
Query message:
CHAN1:SKEW?
Response message:
1.52E-09
50 / 757 www.siglent.com
SDS Series Programming Guide
:CHANnel<n>:SWITch
Command/Query
<state>:= {OFF|ON}
Command message:
:CHANnel1:SWITch ON
CHAN1:SWIT ON
Query message:
CHAN1:SWIT?
Response message:
ON
www.siglent.com 51 / 757
SD S Series Pr ogrammin g Guide
:CHANnel<n>:UNIT
Command/Query
Note:
The related parameter units are changed to the selected unit
after processing this command. This also effects measurement
results, cursors value, channel sensitivity, and trigger level.
<unit>:= {V|A}
Command message:
:CHANnel1:UNIT A
CHAN1:UNIT A
Query message:
CHAN1:UNIT?
Response message:
A
52 / 757 www.siglent.com
SDS Series Programming Guide
:CHANnel<n>:VISible
Command/Query
<display_state>:= {ON|OFF}
Command message:
:CHANnel2:VISible ON
CHAN2:VIS ON
Query message:
CHAN2:VIS?
Response message:
ON
www.siglent.com 53 / 757
SD S Series Pr ogrammin g Guide
CURSor Commands
:CURSor
:CURSor:TAGStyle
:CURSor:IXDelta
:CURSor:MITem
:CURSor:MODE
:CURSor:SOURce1
:CURSor:SOURce2
:CURSor:X1
:CURSor:X2
:CURSor:XDELta
:CURSor:XREFerence
:CURSor:Y1
:CURSor:Y2
:CURSor:YDELta
:CURSor:YREFerence
54 / 757 www.siglent.com
SDS Series Programming Guide
:CURSor
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:CURSor ON
CURS ON
Query message:
CURS?
Response message:
ON
www.siglent.com 55 / 757
SD S Series Pr ogrammin g Guide
:CURSor:TAGStyle
Command/Query
DESCRIPTION The command selects the tag type of the cursor value.
<type>:= {FIXed|FOLLowing}
<type>:= {FIXed|FOLLowing}
EXAMPLE The following command sets the tag type of cursor value to
FIXed.
Command message:
:CURSor:TAGStyle FIXed
CURS:TAGS FIXed
Query message:
:CURS:TAGS?
Response message:
FIXed
56 / 757 www.siglent.com
SDS Series Programming Guide
:CURSor:IXDelta
Query
Response message:
5.7143E+00
www.siglent.com 57 / 757
SD S Series Pr ogrammin g Guide
:CURSor:MITem
Command/Query
DESCRIPTION The command specifies the measure item of the cursors, when
the cursor mode is measure.
EXAMPLE The following command sets the mesure item of the cursor to
PKPK(C2), when the advanced measurement is turned on.
Command message:
:CURSor:MITem PKPK,C2
CURS:MIT PKPK,C2
Query message:
CURS:MIT?
Response message:
PKPK,C2
58 / 757 www.siglent.com
SDS Series Programming Guide
:CURSor:MODE
Command/Query
DESCRIPTION The command specifies the mode of cursor, and the type of
cursor to be displayed when the cursor mode is manual.
<type>:= {TRACk|MANual[,<mode>]|MEASure}
<mode>:= {X|Y|XY}
MANul means the manual cursors
TRACk means the track cursors
MEASure means the measure cursors
<type>:= {TRACk|MANual[,<mode>]}
<mode>:= {X|Y|XY}
EXAMPLE The following command sets the cursor type to manual X, when
the cursor mode is manual.
Command message:
:CURSor:MODE MANual,X
CURS:MODE MAN,X
Query message:
CURS:MODE?
Response message:
MANual,X
www.siglent.com 59 / 757
SD S Series Pr ogrammin g Guide
:CURSor:SOURce1
Command/Query
<source>:=
{C<x>|F<x>|REFA|REFB|REFC|REFD|DIGital|HISTOGram}
<x>:= 1 to (# analog channels) in NR1 format, including an
integer and no decimal point, like 1.
Note:
When the cursor mode is a TRACk, the source cannot be set to
HISTOGram or DIGital.
<source>:=
{C<x>|F<x>|REFA|REFB|REFC|REFD|DIGital|HISTOGram}
EXAMPLE The following command sets the source of the cursor source 1
as Channel 1.
Command message:
:CURSor:SOURce1 C1
CURS:SOUR1 C1
Query message:
CURS:SOUR1?
Response message:
C1
60 / 757 www.siglent.com
SDS Series Programming Guide
:CURSor:SOURce2
Command/Query
<source>:=
{C<x>|F<x>|REFA|REFB|REFC|REFD|DIGital|HISTOGram}
<x>:= 1 to (# analog channels) in NR1 format, including an
integer and no decimal point, like 1.
Note:
When the cursor mode is a TRACk, the source cannot be set to
HISTOGram or DIGital.
<source>:=
{C<x>|F<x>|REFA|REFB|REFC|REFD|DIGital|HISTOGram}
EXAMPLE The following command sets the source of the cursor source 2
as Channel 1.
Command message:
:CURSor:SOURce2 C1
CURS:SOUR2 C1
Query message:
CURS:SOUR2?
Response message:
C1
www.siglent.com 61 / 757
SD S Series Pr ogrammin g Guide
:CURSor:X1
Command/Query
EXAMPLE The following command sets the value of the cursor X1 to 1 us.
Command message:
:CURSor:X1 1.00E-06
CURS:X1 1.00E-06
Query message:
CURS:X1?
Response message:
1.00E-06
62 / 757 www.siglent.com
SDS Series Programming Guide
:CURSor:X2
Command/Query
EXAMPLE The following command sets the value of the cursor X2 to 1 us.
Command message:
:CURSor:X2 1.00E-06
CURS:X2 1.00E-06
Query message:
CURS:X2?
Response message:
1.00E-06
www.siglent.com 63 / 757
SD S Series Pr ogrammin g Guide
:CURSor:XDELta
Query
EXAMPLE The following command returns the current value of the cursor
X1-X2.
Query message:
CURS:XDEL?
Response message:
1.750E-01
64 / 757 www.siglent.com
SDS Series Programming Guide
:CURSor:XREFerence
Command/Query
<type>:= {DELay|POSition}
DELay means that the cursor value is fixed, and the
on-screen cursor position changes for different timebase
values.
POSition means that the cursor position is fixed, and does
not change at any time. Timebase changes cause an
expansion or contraction of the waveforms around the
cursor position.
EXAMPLE The following command sets the type of the X cursor reference
to delay.
Command message:
:CURSor:XREFerence DELay
CURS:XREF DEL
Query message:
CURS:XREF?
Response message:
DELay
www.siglent.com 65 / 757
SD S Series Pr ogrammin g Guide
:CURSor:Y1
Command/Query
Command message:
:CURSor:Y1 1.20E+01
CURS:Y1 1.20E+01
Query message:
CURS:Y1?
Response message:
1.20E+01
66 / 757 www.siglent.com
SDS Series Programming Guide
:CURSor:Y2
Command/Query
Command message:
:CURSor:Y2 1.00E+01
CURS:Y2 1.00E+01
Query message:
CURS:Y2?
Response message:
1.00E+01
www.siglent.com 67 / 757
SD S Series Pr ogrammin g Guide
:CURSor:YDELta
Query
DESCRIPTION The query returns the vertical difference between the cursor Y1
and cursor Y2.
EXAMPLE The following command returns the current value of the cursor
Y1-Y2.
Query message:
CURS:YDEL?
Response message:
1.80E+01
68 / 757 www.siglent.com
SDS Series Programming Guide
:CURSor:YREFerence
Command/Query
<type>:= {OFFSet|POSition}
OFFSet means that the cursor value is fixed, and the
cursor position moves with vertical scale changes. The
cursors expand or contract if the vertical scale changes.
POSition means that the cursor position is fixed, and does
not change at any time.
<type>:= {OFFSet|POSition}
EXAMPLE The following command sets the type of the Y cursor reference
to offset.
Command message:
:CURSor:YREFerence OFFSet
CURS:YREF OFFS
Query message:
CURS:YREF?
Response message:
OFFSet
www.siglent.com 69 / 757
SD S Series Pr ogrammin g Guide
DECode Commands
The :DECode subsystem commands control the basic decode functions of the oscilloscope.
:DECode
:DECode:LIST
:DECode:LIST:LINE
:DECode:LIST:SCRoll
:DECode:BUS<n>
:DECode:BUS<n>:COPY
:DECode:BUS<n>:FORMat
:DECode:BUS<n>:PROTocol
:DECode:BUS<n>:RESult
:DECode:BUS<n>:IIC Commands
:DECode:BUS<n>:SPI Commandds
:DECode:BUS<n>:UART Commands
:DECode:BUS<n>:CAN Commands
:DECode:BUS<n>:LIN Commands
70 / 757 www.siglent.com
SDS Series Programming Guide
:DECode
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:DECode ON
DEC ON
Query message:
DEC?
Response message:
ON
www.siglent.com 71 / 757
SD S Series Pr ogrammin g Guide
:DECode:LIST
Command/Query
This query returns the current switch state of the decode list.
<state>:= {OFF|D1|D2}
D1 means bus 1
D2 means bus 2
<state>:= {OFF|D1|D2}
Command message:
:DECode:LIST D1
DEC:LIST D1
Query message:
DEC:LIST?
Response message:
D1
72 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:LIST:LINE
Command/Query
Command message:
:DECode:LIST:LINE 6
DEC:LIST:LINE 6
Query message:
DEC:LIST:LINE?
Response message:
6
www.siglent.com 73 / 757
SD S Series Pr ogrammin g Guide
:DECode:LIST:SCRoll
Command/Query
DESCRIPTION The command sets the selected line when the decode list is
turned on.
EXAMPLE The following command sets the third line 3 selected when
decoding the display.
Command message:
:DECode:LIST:SCRoll 3
DEC:LIST:SCR 3
Query message:
DEC:LIST:SCR?
Response message:
3
74 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>
Command/Query
<state>:= {ON|OFF}.
<state>:= {ON|OFF}
Command message:
:DECode:BUS1 ON
DEC:BUS1 ON
Query message:
DEC:BUS1?
Response message:
ON
www.siglent.com 75 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:COPY
Command
<operation>:= {FROMtrigger|TOTRigger}.
FROMtrigger means copy trigger settings to the decoding
bus.
TOTRigger means copy decoding settings to trigger.
Command message:
:DECode:BUS1:COPY FROMtrigger
DEC:BUS1:COPY FROM
76 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:FORMat
Command/Query
<format>:= {BINary|DECimal|HEX|ASCii}
<format>:= {BINary|DECimal|HEX|ASCii}
EXAMPLE The following command selects the display format of the bus 1
as HEX.
Command message:
:DECode:BUS1:FORMat HEX
DEC:BUS1:FORM HEX
Query message:
DEC:BUS1:FORM?
Response message:
HEX
www.siglent.com 77 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:PROTocol
Command/Query
<protocol>:=
{IIC|SPI|UART|CAN|LIN|FLEXray|CANFd|IIS|M1553}
<protocol>:=
{IIC|SPI|UART|CAN|LIN|FLEXray|CANFd|IIS|M1553}
Command message:
:DECode:BUS1:PROTocol IIC
DEC:BUS1:PROT IIC
Query message:
DEC:BUS1:PROT?
Response message:
IIC
78 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:RESult
Query
Query message:
DEC:BUS1:RES?
Response message:
lin,sync,id,parity,data,checksum;
0x55,0x06,0,0x54\s0x5F,0x46;
www.siglent.com 79 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:IIC Commands
The :DECode:BUS<n>:IIC subsystem commands control the IIC decode settings of the specified
bus.
:DECode:BUS<n>:IIC:RWBit
:DECode:BUS<n>:IIC:SCLSource
:DECode:BUS<n>:IIC:SCLThreshold
:DECode:BUS<n>:IIC:SDASource
:DECode:BUS<n>:IIC:SDAThreshold
80 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:IIC:RWBit
Command/Query
<state>:= {ON|OFF}.
<state>:= {ON|OFF}
EXAMPLE The following command selects to enable read and write bits
on bus 1.
Command message:
:DECode:BUS1:IIC:RWBit ON
DEC:BUS1:IIC:RWB ON
Query message:
DEC:BUS1:IIC:RWB?
Response message:
ON
www.siglent.com 81 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:IIC:SCLSource
Command/Query
DESCRIPTION The command selects the SCL source of the IIC bus.
This query returns the current SCL source of the IIC bus.
<source>:= {C<x>|D<m>}.
<source>:= {C<x>|D<m>}
EXAMPLE The following command selects the SCL source of the IIC on
bus 1 as C1.
Command message:
:DECode:BUS1:IIC:SCLSource C1
DEC:BUS1:IIC:SCLS C1
Query message:
DEC:BUS1:IIC:SCLS?
Response message:
C1
:DECode:BUS<n>:IIC:SDASource
82 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:IIC:SCLThreshold
Command/Query
DESCRIPTION The command sets the threshold of the SCL on IIC bus.
This query returns the current threshold of the SCL on IIC bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:DECode:BUS1:IIC:SCLThreshold 1.00E+00
DEC:BUS1:IIC:SCLT 1.00E+00
Query message:
DEC:BUS1:IIC:SCLT?
Response message:
1.00E+00
www.siglent.com 83 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:IIC:SDASource
Command/Query
DESCRIPTION The command selects the SDA source of the IIC bus.
This query returns the current SDA source of the IIC bus.
<source>:= {C<x>|D<m>}
<source>:= {C<x>|D<m>}
EXAMPLE The following command selects the SDA source of the IIC on
bus 1 as C1.
Command message:
:DECode:BUS1:IIC:SDASource C1
DEC:BUS1:IIC:SDAS C1
Query message:
DEC:BUS1:IIC:SDAS?
Response message:
C1
84 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:IIC:SDAThreshold
Command/Query
DESCRIPTION The command sets the threshold of the SDA on IIC bus.
This query returns the current threshold of the SDA on IIC bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:DECode:BUS1:IIC:SDAThreshold 1.00E+00
DEC:BUS1:IIC:SDAT 1.00E+00
Query message:
DEC:BUS1:IIC:SDAT?
Response message:
1.00E+00
www.siglent.com 85 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:SPI Commandds
The :DECode:BUS<n>:SPI subsystem commands control the SPI decode settings of the specified
bus.
:DECode:BUS<n>:SPI:BITorder
:DECode:BUS<n>:SPI:CLKSource
:DECode:BUS<n>:SPI:CLKThreshold
:DECode:BUS<n>:SPI:CSSource
:DECode:BUS<n>:SPI:CSThreshold
:DECode:BUS<n>:SPI:CSTYpe
:DECode:BUS<n>:SPI:DLENgth
:DECode:BUS<n>:SPI:LATChedge
:DECode:BUS<n>:SPI:MISOSource
:DECode:BUS<n>:SPI:MISOThreshold
:DECode:BUS<n>:SPI:MOSISource
:DECode:BUS<n>:SPI:MOSIThreshold
:DECode:BUS<n>:SPI:NCSSource
:DECode:BUS<n>:SPI:NCSThreshold
86 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:SPI:BITorder
Command/Query
DESCRIPTION The command sets the bit order of the SPI bus.
This query returns the current bit order of the SPI bus.
<order>:= {LSB|MSB}.
<order>:= {LSB|MSB}
EXAMPLE The following command sets bit order of the SPI on BUS 1 to
LSB.
Command message:
:DECode:BUS1:SPI:BITorder LSB
DEC:BUS1:SPI:BIT LSB
Query message:
DEC:BUS1:SPI:BIT?
Response message:
LSB
www.siglent.com 87 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:SPI:CLKSource
Command/Query
DESCRIPTION The command selects the CLK source of the SPI bus.
This query returns the current CLK source of the SPI bus.
<source>:= {C<x>|D<m>}.
<source>:= {C<x>|D<m>}
EXAMPLE The following command selects the CLK source of the SPI on
bus 1 as C1.
Command message:
:DECode:BUS1:SPI:CLKSource C1
DEC:BUS1:SPI:CLKS C1
Query message:
DEC:BUS1:SPI:CLKS?
Response message:
C1
88 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:SPI:CLKThreshold
Command/Query
DESCRIPTION The command sets the threshold of the CLK on SPI bus.
This query returns the current threshold of the CLK on SPI bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:DECode:BUS1:SPI:CLKThreshold 1.00E+00
DEC:BUS1:SPI:CLKT 1.00E+00
Query message:
DEC:BUS1:SPI:CLKT?
Response message:
1.00E+00
www.siglent.com 89 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:SPI:CSSource
Command/Query
<source>:= {C<x>|D<m>}.
<source>:= {C<x>|D<m>}
EXAMPLE The following command sets the CS source of the SPI on bus 1
as C1.
Command message:
:DECode:BUS1:SPI:CSSource C1
DEC:BUS1:SPI:CSS C1
Query message:
DEC:BUS1:SPI:CSS?
Response message:
C1
90 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:SPI:CSThreshold
Command/Query
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Query message:
DEC:BUS1:SPI:CST?
Response message:
1.00E+00
www.siglent.com 91 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:SPI:CSTYpe
Command/Query
DESCRIPTION The command sets the chip selection type of the SPI bus.
This query returns the current chip selection type of the SPI
bus.
<type>:= {NCS|CS|TIMeout[,<time>]}
CS means set to chip select state.
NCS means set to non-chip select state.
TIMeout indicates set to clock timeout status.
<type>:= {NCS|CS|TIMeout[,<time>]}
EXAMPLE The following command sets the chip selection type of the SPI
on bus 1 to CS.
Command message:
:DECode:BUS1:SPI:CSTYpe CS
DEC:BUS1:SPI:CSTY CS
Query message:
DEC:BUS1:SPI:CSTY?
Response message:
CS
92 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:SPI:DLENgth
Command/Query
DESCRIPTION The command sets the data length of the SPI bus.
This query returns the current data length of the SPI bus.
EXAMPLE The following command sets the data length of the SPI on bus
1 to 5.
Command message:
:DECode:BUS1:SPI:DLENgth 5
DEC:BUS1:SPI:DLEN 5
Query message:
DEC:BUS1:SPI:DLEN?
Response message:
5
www.siglent.com 93 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:SPI:LATChedge
Command/Query
DESCRIPTION The command selects the sampling edge of CLK on SPI bus.
<slope>:= {RISing|FALLing}
<slope>:= {RISing|FALLing}
Command message:
:DECode:BUS1:SPI:LATChege RISing
DEC:BUS1:SPI:LATC RIS
Query message:
DEC:BUS1:SPI:LATC?
Response message:
RISing
94 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:SPI:MISOSource
Command/Query
DESCRIPTION The command selects the MISO source of the SPI bus.
This query returns the current MISO source of the SPI bus.
<source>:= {C<x>|D<m>|DIS}
<source>:= {C<x>|D<m>|DIS}
EXAMPLE The following command sets the MISO source of the SPI on
bus 1 as C1.
Command message:
:DECode:BUS1:SPI:MISOSource C1
DEC:BUS1:SPI:MISOS C1
Query message:
DEC:BUS1:SPI:MISOS?
Response message:
C1
www.siglent.com 95 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:SPI:MISOThreshold
Command/Query
DESCRIPTION The command sets the threshold of the MISO on SPI bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:DECode:BUS1:SPI:MISOThreshold 1.00E+00
DEC:BUS1:SPI:MISOT 1.00E+00
Query message:
DEC:BUS1:SPI:MISOT?
Response message:
1.00E+00
96 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:SPI:MOSISource
Command/Query
DESCRIPTION The command selects the MOSI source of the SPI bus.
This query returns the current MOSI source of the SPI bus.
<source>:= {C<x>|D<m>|DIS}
<source>:= {C<x>|D<m>|DIS}
EXAMPLE The following command selects the MOSI source of the SPI on
bus 1 as C1.
Command message:
:DECode:BUS1:SPI:MOSISource C1
DEC:BUS1:SPI:MOSIS C1
Query message:
DEC:BUS1:SPI:MOSIS?
Response message:
C1
www.siglent.com 97 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:SPI:MOSIThreshold
Command/Query
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:DECode:BUS1:SPI:MOSIThreshold 1.00E+00
DEC:BUS1:SPI:MOSIT 1.00E+00
Query message:
DEC:BUS1:SPI:MOSIT?
Response message:
1.00E+00
98 / 757 www.siglent.com
SDS Series Programming Guide
:DECode:BUS<n>:SPI:NCSSource
Command/Query
DESCRIPTION The command sets the NCS source of the SPI bus.
This query returns the current NCS source of the SPI bus.
<source>:= {C<x>|D<m>}
<source>:= {C<x>|D<m>}
EXAMPLE The following command sets the NCS source of the SPI on bus
1 as C1.
Command message:
:DECode:BUS1:SPI:NCSSource C1
DEC:BUS1:SPI:NCSS C1
Query message:
DEC:BUS1:SPI:NCSS?
Response message:
C1
www.siglent.com 99 / 757
SD S Series Pr ogrammin g Guide
:DECode:BUS<n>:SPI:NCSThreshold
Command/Query
DESCRIPTION The command sets the threshold of the NCS on SPI bus.
This query returns the current threshold of the NCS on SPI bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the NCS on bus 1
to 1 V.
Command message:
:DECode:BUS1:SPI:NCSThreshold 1.00E+00
DEC:BUS1:SPI:NCST 1.00E+00
Query message:
DEC:BUS1:SPI:NCST?
Response message:
1.00E+00
:DECode:BUS<n>:UART Commands
The :DECode:BUS<n>:UART subsystem commands control the UART decode settings of the
specified bus.
:DECode:BUS<n>:UART:BAUD
:DECode:BUS<n>:UART:BITorder
:DECode:BUS<n>:UART:DLENgth
:DECode:BUS<n>:UART:IDLE
:DECode:BUS<n>:UART:PARity
:DECode:BUS<n>:UART:RXSource
:DECode:BUS<n>:UART:RXThreshold
:DECode:BUS<n>:UART:STOP
:DECode:BUS<n>:UART:TXSource
:DECode:BUS<n>:UART:TXThreshold
:DECode:BUS<n>:UART:BAUD
Command/Query
DESCRIPTION The command sets the baud rate of the UART bus.
This query returns the current baud rate of the UART bus.
<baud>:=
{600bps|1200bps|2400bps|4800bps|9600bps|19200bps|38400
bps|57600bps|115200bps|CUSTom[,<value>]}
<baud>:=
{600bps|1200bps|2400bps|4800bps|9600bps|19200bps|38400
bps|57600bps|115200bps|CUSTom[,<value>]}
EXAMPLE The following command sets the baud rate of the UART to
9600bps on bus 1.
Command message:
:DECode:BUS1:UART:BAUD 9600bps
DEC:BUS1:UART:BAUD 9600bps
Query message:
DEC:BUS1:UART:BAUD?
Response message:
9600bps
:DECode:BUS<n>:UART:BITorder
Command/Query
DESCRIPTION The command sets the bit order of the UART bus.
This query returns the current bit order of the UART bus.
<order>:= {LSB|MSB}
<order>:= {LSB|MSB}
LSB is Least Significant Bit order
MSB is Most Significant Bit order
EXAMPLE The following command sets bit order of the UART bus on bus
1 to LSB.
Command message:
:DECode:BUS1:UART:BITorder LSB
DEC:BUS1:UART:BIT LSB
Query message:
DEC:BUS1:UART:BIT?
Response message:
LSB
:DECode:BUS<n>:UART:DLENgth
Command/Query
DESCRIPTION The command sets the data length of the UART bus.
This query returns the current data length of the UART bus.
EXAMPLE The following command sets the data length of the UART to 5 on
bus 1.
Command message:
:DECode:BUS1:UART:DLENgth 5
DEC:BUS1:UART:DLEN 5
Query message:
DEC:BUS1:UART:DLEN?
Response message:
5
:DECode:BUS<n>:UART:IDLE
Command/Query
DESCRIPTION The command sets the idle level of the UART bus.
This query returns the current idle level of the UART bus.
<idle>:= {LOW|HIGH}
<idle>:= {LOW|HIGH}
LOW means that the idle voltage value is low
HIGH means that the idle voltage value is high
EXAMPLE The following command sets the idle level of the UART on bus
1 to low.
Command message:
:DECode:BUS1:UART:IDLE LOW
DEC:BUS1:UART:IDLE LOW
Query message:
DEC:BUS1:UART:IDLE?
Response message:
LOW
:DECode:BUS<n>:UART:PARity
Command/Query
DESCRIPTION The command sets the parity check of the UART bus.
This query returns the current parity check of the UART bus.
<parity>:= {NONE|ODD|EVEN|MARK|SPACe}
<parity>:= {NONE|ODD|EVEN|MARK|SPACe}
EXAMPLE The following command sets the parity check of the UART on
bus 1 to NONE.
Command message:
:DECode:BUS1:UART:PARity NONE
DEC:BUS1:UART:PAR NONE
Query message:
DEC:BUS1:UART:PAR?
Response message:
NONE
:DECode:BUS<n>:UART:RXSource
Command/Query
<source>:= {C<x>|D<m>|DIS}
<source>:= {C<x>|D<m>|DIS}
Command message:
:DECode:BUS1:UART:RXSource C1
DEC:BUS1:UART:RXS C1
Query message:
DEC:BUS1:UART:RXS?
Response message:
C1
:DECode:BUS<n>:UART:RXThreshold
Command/Query
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:DECode:BUS1:UART:RXThreshold 1.00E+00
DEC:BUS1:UART:RXT 1.00E+00
Query message:
DEC:BUS1:UART:RXT?
Response message:
1.00E+00
:DECode:BUS<n>:UART:STOP
Command/Query
DESCRIPTION The command sets the length of the stop bit on UART bus.
This query returns the current length of the stop bit on UART
bus.
<bit>:= {1|1.5|2}
<bit>:= {1|1.5|2}
EXAMPLE The following command sets the current length of the stop bit to
1 on bus 1.
Command message:
:DECode:BUS1:UART:STOP 1
DEC:BUS1:UART:STOP 1
Query message:
DEC:BUS1:UART:STOP?
Response message:
1
:DECode:BUS<n>:UART:TXSource
Command/Query
<source>:= {C<x>|D<m>|DIS}
<source>:= {C<x>|D<m>|DIS}
Command message:
:DECode:BUS1:UART:TXSource C1
DEC:BUS1:UART:TXS C1
Query message:
DEC:BUS1:UART:TXS?
Response message:
C1
:DECode:BUS<n>:UART:TXThreshold
Command/Query
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:DECode:BUS1:UART:TXThreshold 1.00E+00
DEC:BUS1:UART:TXT 1.00E+00
Query message:
DEC:BUS1:UART:TXT?
Response message:
1.00E+00
:DECode:BUS<n>:CAN Commands
The :DECode:BUS<n>:CAN subsystem commands control the CAN decode settings of the specified
bus.
:DECode:BUS<n>:CAN:BAUD
:DECode:BUS<n>:CAN:SOURce
:DECode:BUS<n>:CAN:THReshold
:DECode:BUS<n>:CAN:BAUD
Command/Query
DESCRIPTION The command sets the baud rate of the CAN bus.
This query returns the current baud rate of the CAN bus.
<baud>:=
{5kbps|10kbps|20kbps|50kbps|100kbps|125kbps|250kbps|500
kbps|800kbps|1Mbps|CUSTom[,<value>]}
<baud>:=
{5kbps|10kbps|20kbps|50kbps|100kbps|125kbps|250kbps|500
kbps|800kbps|1Mbps|CUSTom[,<value>]}
EXAMPLE The following command sets the baud rate of the CAN on bus 1
to 10kbps.
Command message:
:DECode:BUS1:CAN:BAUD 10kbps
DEC:BUS1:CAN:BAUD 10kbps
Query message:
DEC:BUS1:CAN:BAUD?
Response message:
10kbps
:DECode:BUS<n>:CAN:SOURce
Command/Query
<source>:= {C<x>|D<m>}
<source>:= {C<x>|D<m>}
EXAMPLE The following command selects the source of the CAN on bus
1 as C1.
Command message:
:DECode:BUS1:CAN:SOURce C1
DEC:BUS1:CAN:SOUR C1
Query message:
DEC:BUS1:CAN:SOUR?
Response message:
C1
:DECode:BUS<n>:CAN:THReshold
Command/Query
DESCRIPTION The command sets the threshold of the source on CAN bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the CAN bus
source to 1 V on bus 1.
Command message:
:DECode:BUS1:CAN:THReshold 1.00E+00
DEC:BUS1:CAN:THR 1.00E+00
Query message:
DEC:BUS1:CAN:THR?
Response message:
1.00E+00
:DECode:BUS<n>:LIN Commands
The :DECode:BUS<n>:LIN subsystem commands control the LIN decode settings of the specified
bus.
:DECode:BUS<n>:LIN:BAUD
:DECode:BUS<n>:LIN:SOURce
:DECode:BUS<n>:LIN:THReshold
:DECode:BUS<n>:LIN:BAUD
Command/Query
DESCRIPTION The command sets the baud rate for the LIN bus.
This query returns the current baud rate for the LIN bus.
<baud>:=
{600bps|1200bps|2400bps|4800bps|9600bps|19200bps|CUST
om[,<value>]}
<baud>:=
{600bps|1200bps|2400bps|4800bps|9600bps|19200bps|CUST
om[,<value>]}
EXAMPLE The following command sets the baud rate for the LIN to
9600bps on bus 1.
Command message:
:DECode:BUS1:LIN:BAUD 9600bps
DEC:BUS1:LIN:BAUD 9600bps
Query message:
DEC:BUS1:LIN:BAUD?
Response message:
9600bps
:DECode:BUS<n>:LIN:SOURce
Command/Query
<source>:= {C<x>|D<m>}
<x>:= 1 to (# analog channels) in NR1 format, including an
integer and no decimal point, like 1.
<source>:= {C<x>|D<m>}
EXAMPLE The following command selects the source of the LIN on bus 1
as C1.
Command message:
:DECode:BUS1:LIN:SOURce C1
DEC:BUS1:LIN:SOUR C1
Query message:
DEC:BUS1:LIN:SOUR?
Response message:
C1
:DECode:BUS<n>:LIN:THReshold
Command/Query
DESCRIPTION The command sets the threshold of the source on LIN bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the LIN source to
1 V on bus 1.
Command message:
:DECode:BUS1:LIN:THReshold 1.00E+00
DEC:BUS1:LIN:THR 1.00E+00
Query message:
DEC:BUS1:LIN:THR?
Response message:
1.00E+00
The :DECode:BUS<n>:FLEXray subsystem commands control the FLEXray decode settings of the
specified bus.
:DECode:BUS<n>:FLEXray:BAUD
:DECode:BUS<n>:FLEXray:SOURce
:DECode:BUS<n>:FLEXray:THReshold
:DECode:BUS<n>:FLEXray:BAUD
Command/Query
DESCRIPTION The command sets the baud rate of the Flexray bus.
This query returns the current baud rate of the Flexray bus.
<baud>:= {2500kbps|5Mbps|10Mbps|CUSTom[,<value>]}
<baud>:= {2500kbps|5Mbps|10Mbps|CUSTom[,<value>]}
EXAMPLE The following command sets the baud rate of the Flexray to
5Mbps on bus 1.
Command message:
:DECode:BUS1:FLEXray:BAUD 5Mbps
DEC:BUS1:FLEX:BAUD 5Mbps
Query message:
DEC:BUS1:FLEX:BAUD?
Response message:
5Mbps
:DECode:BUS<n>:FLEXray:SOURce
Command/Query
<source>:= {C<x>|D<m>}
<source>:= {C<x>|D<m>}
Command message:
:DECode:BUS1:FLEXray:SOURce C1
DEC:BUS1:FLEX:SOUR C1
Query message:
DEC:BUS1:FLEX:SOUR?
Response message:
C1
:DECode:BUS<n>:FLEXray:THReshold
Command/Query
DESCRIPTION The command sets the threshold of the source on Flexray bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:DECode:BUS1:FLEXray:THReshold 1.00E+00
DEC:BUS1:FLEX:THR 1.00E+00
Query message:
DEC:BUS1:FLEX:THR?
Response message:
1.00E+00
The :DECode:BUS<n>:CANFd subsystem commands control the CANFD decode settings of the
specified bus.
:DECode:BUS<n>:CANFd:BAUDData
:DECode:BUS<n>:CANFd:BAUDNominal
:DECode:BUS<n>:CANFd:SOURce
:DECode:BUS<n>:CANFd:THReshold
:DECode:BUS<n>:CANFd:BAUDData
Command/Query
DESCRIPTION The command sets the data baud rate of the CAN FD bus.
This query returns the current data baud rate of the CAN FD
bus.
<baud>:=
{500kbps|1Mbps|2Mbps|5Mbps|8Mbps|10Mbps|CUSTom[,<val
ue>]}
<baud>:=
{500kbps|1Mbps|2Mbps|5Mbps|8Mbps|10Mbps|CUSTom[,<val
ue>]}
EXAMPLE The following command sets the data baud rate of the CAN FD
to 500kbps on bus 1.
Command message:
:DECode:BUS1:CANFd:BAUDData 500kbps
DEC:BUS1:CANF:BAUDD 500kbps
Query message:
DEC:BUS1:CANF:BAUDD?
Response message:
500kbps
:DECode:BUS<n>:CANFd:BAUDNominal
Command/Query
DESCRIPTION The command sets the nominal baud rate of the CAN FD bus.
This query returns the current nominal baud rate of the CAN FD
bus.
<baud>:=
{10kbps|25kbps|50kbps|100kbps|250kbps|1Mbps|CUSTom[,<v
alue>]}
<baud>:=
{10kbps|25kbps|50kbps|100kbps|250kbps|1Mbps|CUSTom[,<v
alue>]}
EXAMPLE The following command sets the nominal baud rate of the CAN
FD to 50kbps on bus 1.
Command message:
:DECode:BUS1:CANFd:BAUDNominal 50kbps
DEC:BUS1:CANF:BAUDN 50kbps
Query message:
DEC:BUS1:CANF:BAUDN?
Response message:
50kbps
:DECode:BUS<n>:CANFd:SOURce
Command/Query
<source>:= {C<x>|D<m>}
<source>:= {C<x>|D<m>}
Command message:
:DECode:BUS1:CANFd:SOURce C1
DEC:BUS1:CANF:SOUR C1
Query message:
DEC:BUS1:CANF:SOUR?
Response message:
C1
:DECode:BUS<n>:CANFd:THReshold
Command/Query
DESCRIPTION The command sets the threshold of the source on CAN FD bus.
The range of the value varies by model, see the table below for
details
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the CAN FD source
to 1 V on bus 1.
Command message:
:DECode:BUS1:CANFd:THReshold 1.00E+00
DEC:BUS1:CANF:THR 1.00E+0
Query message:
DEC:BUS1:CANF:THR?
Response message:
1.00E+00
The :DECode:BUS<n>:IIS subsystem commands control the IIS decode settings of the specified
bus.
:DECode:BUS<n>:IIS:ANNotate
:DECode:BUS<n>:IIS:AVARiant
:DECode:BUS<n>:IIS:BCLKSource
:DECode:BUS<n>:IIS:BCLKThreshold
:DECode:BUS<n>:IIS:BITorder
:DECode:BUS<n>:IIS:DLENgth
:DECode:BUS<n>:IIS:DSource
:DECode:BUS<n>:IIS:DTHReshold
:DECode:BUS<n>:IIS:LATChedge
:DECode:BUS<n>:IIS:LCH
:DECode:BUS<n>:IIS:SBIT
:DECode:BUS<n>:IIS:WSSource
:DECode:BUS<n>:IIS:WSTHreshold
:DECode:BUS<n>:IIS:ANNotate
Command/Query
<type>:= {ALL|LEFT|RIGHt}
<type>:= {ALL|LEFT|RIGHt}
Command message:
:DECode:BUS1:IIS:ANNotate ALL
DEC:BUS1:IIS:ANN ALL
Query message:
DEC:BUS1:IIS:ANN?
Response message:
ALL
:DECode:BUS<n>:IIS:AVARiant
Command/Query
DESCRIPTION The command selects the audio variant for IIS bus.
This query returns the current audio variant for IIS bus.
<type>:= {I2S|LJ|RJ}
I2S justified.
LJ is left justified.
RL is right justified.
<type>:= {I2S|LJ|RJ}
EXAMPLE The following command sets the audio variable of the IIS on
bus 1 to RJ.
Command message:
:DECode:BUS1:IIS:AVARiant RJ
DEC:BUS1:IIS:AVAR RJ
Query message:
DEC:BUS1:IIS:AVAR?
Response message:
RJ
:DECode:BUS<n>:IIS:BCLKSource
Command/Query
DESCRIPTION The command selects the BCLK source of the IIS bus.
This query returns the current BCLK source of the IIS bus.
<source>:= {C<x>|D<m>}
<source>:= {C<x>|D<m>}
EXAMPLE The following command selects the BCLK source of IIS on bus
1 as C1.
Command message:
:DECode:BUS1:IIS:BCLKSource C1
DEC:BUS1:IIS:BCLKS C1
Query message:
DEC:BUS1:IIS:BCLKS?
Response message:
C1
:DECode:BUS<n>:IIS:BCLKThreshold
Command/Query
DESCRIPTION The command sets the threshold of the BCLK on IIS bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:DECode:BUS1:IIS:BCLKThreshold 1.00E+00
DEC:BUS1:IIS:BCLKT 1.00E+00
Query message:
DEC:BUS1:IIS:BCLKT?
Response message:
1.00E+00
:DECode:BUS<n>:IIS:BITorder
Command/Query
DESCRIPTION The command sets the bit order for the IIS bus.
This query returns the current bit order for the IIS bus.
<order>:= {LSB|MSB}
LSB is Least Significant Bit.
MSB is Most Significant Bit.
<order>:= {LSB|MSB}
EXAMPLE The following command sets bit order for the IIS on bus 1 to
LSB.
Command message:
:DECode:BUS1:IIS:BITorder LSB
DEC:BUS1:IIS:BIT LSB
Query message:
DEC:BUS1:IIS:BIT?
Response message:
LSB
:DECode:BUS<n>:IIS:DLENgth
Command/Query
DESCRIPTION The command sets the data bits for the IIS bus.
This query returns the current data bits for the IIS bus.
EXAMPLE The following command sets the data bits for the IIS to 5 on bus
1.
Command message:
:DECode:BUS1:IIS:DLENgth 5
DEC:BUS1:IIS:DLEN 5
Query message:
DEC:BUS1:IIS:DLEN?
Response message:
5
:DECode:BUS<n>:IIS:DSource
Command/Query
DESCRIPTION The command selects the data source of the IIS bus.
This query returns the current data source of the IIS bus.
<source>:= {C<x>|D<m>}
<source>:= {C<x>|D<m>}
EXAMPLE The following command selects the data source of the IIS bus
on bus 1 as C1.
Command message:
:DECode:BUS1:IIS:DSource C1
DEC:BUS1:IIS:DS C1
Query message:
DEC:BUS1:IIS:DS?
Response message:
C1
:DECode:BUS<n>:IIS:DTHReshold
Command/Query
DESCRIPTION The command sets the threshold of the data source on IIS bus.
This query returns the current threshold of the data source on IIS
bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the data source to
1 V on bus 1.
Command message:
:DECode:BUS1:IIS:DTHReshold 1.00E+00
DEC:BUS1:IIS:DTHR 1.00E+00
Query message:
DEC:BUS1:IIS:DTHR?
Response message:
1.00E+00
:DECode:BUS<n>:IIS:LATChedge
Command/Query
DESCRIPTION The command selects the sampling edge of BCLK on IIS bus.
<slope>:= {RISing|FALLing}
<slope>:= {RISing|FALLing}
RISing selects the rising edge.
FALLing selects the falling edge.
EXAMPLE The following command sets the sampling edge of BCLK on bus
1 to RISing.
Command message:
:DECode:BUS1:IIS:LATChege RISing
DEC:BUS1:IIS:LATC RIS
Query message:
DEC:BUS1:IIS:LATC?
Response message:
RISing
:DECode:BUS<n>:IIS:LCH
Command/Query
<left>:= {LOW|HIGH}
<left>:= {LOW|HIGH}
EXAMPLE The following command sets the left channel on bus 1 to LOW.
Command message:
:DECode:BUS1:IIS:LCH LOW
DEC:BUS1:IIS:LCH LOW
Query message:
DEC:BUS1:IIS:LCH?
Response message:
LOW
:DECode:BUS<n>:IIS:SBIT
Command/Query
EXAMPLE The following command sets the number of the data bit to 1 on
bus 1.
Command message:
:DECode:BUS1:IIS:SBIT 1
:DEC:BUS1:IIS:SBIT 1
Query message:
DEC:BUS1:IIS:SBIT?
Response message:
1
:DECode:BUS<n>:IIS:WSSource
Command/Query
<source>:= {C<x>|D<m>}
<source>:= {C<x>|D<m>}
EXAMPLE The following command selects the WS source of the IIS bus
on bus 1 as C1.
Command message:
:DECode:BUS1:IIS:WSSource C1
DEC:BUS1:IIS:WSS C1
Query message:
DEC:BUS1:IIS:WSS?
Response message:
C1
:DECode:BUS<n>:IIS:WSTHreshold
Command/Query
The range of the value varies by model, see the table below for
details
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:DECode:BUS1:IIS:WSTHreshold 1.00E+00
DEC:BUS1:IIS:WSTH 1.00E+00
Query message:
DEC:BUS1:IIS:WSTH?
Response message:
1.00E+00
The :DECode:BUS<n>:M1553 subsystem commands control the M1553 decode settings of the
specified bus.
:DECode:BUS<n>:M1553:LTHReshold
:DECode:BUS<n>:M1553:SOURce
:DECode:BUS<n>:M1553:UTHReshold
:DECode:BUS<n>:M1553:LTHReshold
Command/Query
DESCRIPTION The command sets the lower threshold of the M1553 source.
The range of the value varies by model, see the table below for
details
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The lower threshold value cannot be greater than the upper
threshold value set by the command
:DECode:BUS<n>:M1553:UTHReshold.
EXAMPLE The following command sets the lower threshold of the M1553
source to 1 V on bus 1.
Command message:
:DECode:BUS1:M1553:LTHReshold 1.00E+00
DEC:BUS1:M1553:LTHR 1.00E+00
Query message:
DEC:BUS1:M1553:LTHR?
Response message:
1.00E+00
:DECode:BUS<n>:M1553:SOURce
Command/Query
<source>:= {C<x>}
<source>:= {C<x>}
Command message:
:DECode:BUS1:M1553:SOURce C1
DEC:BUS1:M1553:SOUR C1
Query message:
DEC:BUS1:M1553:SOUR?
Response message:
C1
:DECode:BUS<n>:M1553:UTHReshold
Command/Query
DESCRIPTION The command sets the upper threshold of the M1553 source.
The range of the value varies by model, see the table below for
details
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset
SDS6000A
, 4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The upper threshold value cannot be less than the lower
threshold value set by the command
:DECode:BUS<n>:M1553:LTHReshold.
EXAMPLE The following command sets the upper threshold of the M1553
bus source to 2 V on bus 1.
Command message:
:DECode:BUS1:M1553:UTHReshold 2.00E+00
DEC:BUS1:M1553:UTHR 2.00E+00
Query message:
DEC:BUS1:M1553:UTHR?
Response message:
2.00E+00
The :DECode:BUS<n>:SENT subsystem commands control the SENT decode settings of the
specified bus.
:DECode:BUS<n>:SENT:SOURce
:DECode:BUS<n>:SENT:THReshold
:DECode:BUS<n>:SENT:FORMat
:DECode:BUS<n>:SENT:CLOCk
DECode:BUS<n>:SENT:TOLerance
:DECode:BUS<n>:SENT:IDLE
:DECode:BUS<n>:SENT:LENGth
:DECode:BUS<n>:SENT:CRC
:DECode:BUS<n>:SENT:PPULse
:DECode:BUS<n>:SENT:SOURce
Command/Query
<source>:= {C<x>|D<m>}
<source>:= {C<x>|D<m>}
Command message:
:DECode:BUS1:SENT:SOURce C1
DEC:BUS1:SENT:SOUR C1
Query message:
DEC:BUS1:SENT:SOUR?
Response message:
C1
:DECode:BUS<n>:SENT:THReshold
Command/Query
DESCRIPTION The command sets the threshold of the source on SENT bus.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X [-4.1*vertical_scale-vertical_offset,
SDS2000X HD 4.1*vertical_scale-vertical_offset]
EXAMPLE The following command sets the threshold of the SENT bus
source to 1 V on bus 1.
Command message:
:DECode:BUS1:SENT:THReshold 1.00E+00
DEC:BUS1:SENT:THR 1.00E+00
Query message:
DEC:BUS1:SENT:THR?
Response message:
1.00E+00
:DECode:BUS<n>:SENT:FORMat
Command/Query
DESCRIPTION The command selects the message format of the SENT bus.
<format>:= {NIBBles|FSIGnal|SSERial|ESERial}
<format>:= {NIBBles|FSIGnal|SSERial|ESERial}
Command message:
:DECode:BUS1:SENT:FORMat NIBBles
DEC:BUS1:SENT:FORM NIBB
Query message:
DEC:BUS1:SENT:FORM?
Response message:
NIBBles
:DECode:BUS<n>:SENT:CLOCk
Command/Query
DESCRIPTION The command sets the clock period (tick) time of the SENT
bus.
This query returns the current clock period of the SENT bus.
COMMAND SYNTAX :DECode:BUS<n>:SENT:CLOCk <value>
EXAMPLE The following command sets the clock cycle of SENT bus on
the bus 1 to 1us.
Command message:
:DECode:BUS1:SENT:CLOCk 1.00E-06
DEC:BUS1:SENT:CLOC 1.00E-06
Query message:
DEC:BUS1:SENT:CLOC?
Response message:
1.00E-06
DECode:BUS<n>:SENT:TOLerance
Command/Query
DESCRIPTION The command sets the clock percent tolerance of the SENT bus.
This query returns the current clock tolerance of the SENT bus.
EXAMPLE The following command sets the tolerance of the SENT on bus 1
to 5%.
Command message:
:DECode:BUS1:SENT:TOLerance 5
DEC:BUS1:SENT:TOL 5
Query message:
DEC:BUS1:SENT:TOL?
Response message:
5
:DECode:BUS<n>:SENT:IDLE
Command/Query
DESCRIPTION The command sets the idle level of the SENT bus.
The query returns the current idle level of the SENT bus.
<idle>:= {LOW|HIGH}
<idle>:= {LOW|HIGH}
EXAMPLE The following command sets the idle level of the SENT bus of
the bus 1 as low.
Command message:
:DECode:BUS1:SENT:IDLE LOW
DEC:BUS1:SENT:IDLE LOW
Query message:
DEC:BUS1:SENT:IDLE?
Response message:
LOW
:DECode:BUS<n>:SENT:LENGth
Command/Query
DESCRIPTION The command sets the number of nibbles of the SENT bus.
EXAMPLE The following command sets the Number of nibbles of the SENT
on bus 1 to 5.
Command message:
:DECode:BUS1:SENT:LENGth 5
DEC:BUS1:SENT:LENG 5
Query message:
DEC:BUS1:SENT:LENG?
Response message:
5
:DECode:BUS<n>:SENT:CRC
Command/Query
DESCRIPTION The command sets the CRC format of the SENT bus.
<state>:= {OFF|ON}
ON sets to 2010 CRC format.
OFF sets to 2008 CRC format.
<state>:= {OFF|ON}
EXAMPLE The following command sets to 2010 CRC format of the SENT
bus on the bus 1.
Command message:
:DECode:BUS1:SENT:CRC ON
DEC:BUS1:SENT:CRC ON
Query message:
DEC:BUS1:SENT:CRC?
Response message:
ON
:DECode:BUS<n>:SENT:PPULse
Command/Query
DESCRIPTION The command sets the state of pause pulse of the SENT bus.
The query returns the current state of pause pulse of the SENT
bus.
<state>:= {OFF|ON}
<state>:= {OFF|ON}
EXAMPLE The following command sets the state of pause of the SENT
bus on the bus 1 as ON.
Command message:
:DECode:BUS1:SENT:PPULse ON
DEC:BUS1:SENT:PPUL ON
Query message:
DEC:BUS1:SENT:PPUL?
Response message:
ON
:DECode:BUS<n>:MANChester:SOURce
:DECode:BUS<n>:MANChester:THReshold
:DECode:BUS<n>:MANChester:BAUD
:DECode:BUS<n>:MANChester:POLarity
:DECode:BUS<n>:MANChester:IDLE
:DECode:BUS<n>:MANChester:IBITs
:DECode:BUS<n>:MANChester:STARt
:DECode:BUS<n>:MANChester:SSIZe
:DECode:BUS<n>:MANChester:HSIZe
:DECode:BUS<n>:MANChester:TSIZe
:DECode:BUS<n>:MANChester:WSIZe
:DECode:BUS<n>:MANChester:DSIZe
:DECode:BUS<n>:MANChester:DISPlay
:DECode:BUS<n>:MANChester:BITorder
:DECode:BUS<n>:MANChester:SOURce
Command/Query
<source>:= {C<x>|D<m>}
<source>:= {C<x>|D<m>}
Command message:
:DECode:BUS1:MANChester:SOURce C1
DEC:BUS1:MANC:SOUR C1
Query message:
DEC:BUS1:MANC:SOUR?
Response message:
C1
:DECode:BUS<n>:MANChester:THReshold
Command/Query
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X [-4.1*vertical_scale-vertical_offset,
SDS2000X HD 4.1*vertical_scale-vertical_offset]
Command message:
:DECode:BUS1:MANChester:THReshold 1.00E+00
DEC:BUS1:MANC:THR 1.00E+00
Query message:
DEC:BUS1:MANC:THR?
Response message:
1.00E+00
:DECode:BUS<n>:MANChester:BAUD
Command/Query
DESCRIPTION The command sets the baud rate for the Manchester bus.
This query returns the current baud rate for the Manchester
bus.
EXAMPLE The following command sets the baud rate for the Manchester
to 9600bps on bus 1.
Command message:
:DECode:BUS1:MANChester:BAUD 9600
DEC:BUS1:MANC:BAUD 9600
Query message:
DEC:BUS1:MANC:BAUD?
Response message:
9600
:DECode:BUS<n>:MANChester:POLarity
Command/Query
DESCRIPTION The command sets the signal's logic type of the Manchester
bus.
<polar>:= {RISing|FALLing}
RISing indicates that rising edge is used to encode a bit
value of logic 1.
FALLing indicates that falling edge is used to encode a bit
value of logic 1.
<polar>:= {RISing|FALLing}
Command message:
:DECode:BUS1:MANChester:POLarity RISing
DEC:BUS1:MANC:POL RIS
Query message:
DEC:BUS1:MANC:POL?
Response message:
RISing
:DECode:BUS<n>:MANChester:IDLE
Command/Query
DESCRIPTION The command sets the idle level of the Manchester bus.
The query returns the current idle level of the Manchester bus.
<idle>:= {LOW|HIGH}
<idle>:= {LOW|HIGH}
EXAMPLE The following command sets the idle level of the Manchester
bus of the bus 1 as LOW.
Command message:
:DECode:BUS<n>:MANChester:IDLE LOW
DEC:BUS1:MANC:IDLE LOW
Query message:
DEC:BUS1:MANC:IDLE?
Response message:
LOW
:DECode:BUS<n>:MANChester:IBITs
Command/Query
DESCRIPTION The command sets the idle bits of the Manchester bus.
This query returns the current idle bits of the Manchester bus.
EXAMPLE The following command sets the idle bits of the Manchester on
bus 1 to 5.
Command message:
:DECode:BUS<n>:MANChester:IBITs 5
DEC:BUS1:MANC:IBIT 5
Query message:
DEC:BUS1:MANC:IBIT?
Response message:
5
:DECode:BUS<n>:MANChester:STARt
Command/Query
DESCRIPTION The command sets the start edge of the Manchester bus.
This query returns the current start edge of the Manchester bus.
EXAMPLE The following command sets the start edge of the Manchester on
bus 1 to 5.
Command message:
:DECode:BUS<n>:MANChester:STARt 5
DEC:BUS1:MANC:STAR 5
Query message:
DEC:BUS1:MANC:STAR?
Response message:
5
:DECode:BUS<n>:MANChester:SSIZe
Command/Query
DESCRIPTION The command sets the sync size of the Manchester bus.
This query returns the current sync size of the Manchester bus.
EXAMPLE The following command sets the sync size of the Manchester on
bus 1 to 5.
Command message:
:DECode:BUS<n>:MANChester:SSIZe 5
DEC:BUS1:MANC:SSIZ 5
Query message:
DEC:BUS1:MANC:SSIZ?
Response message:
5
:DECode:BUS<n>:MANChester:HSIZe
Command/Query
DESCRIPTION The command sets the header size of the Manchester bus.
EXAMPLE The following command sets the header size of the Manchester
on bus 1 to 5.
Command message:
:DECode:BUS<n>:MANChester:HSIZe 5
DEC:BUS1:MANC:HSIZ 5
Query message:
DEC:BUS1:MANC:HSIZ?
Response message:
5
:DECode:BUS<n>:MANChester:TSIZe
Command/Query
DESCRIPTION The command sets the trailer size of the Manchester bus.
This query returns the current trailer size of the Manchester bus.
EXAMPLE The following command sets the trailer size of the Manchester
on bus 1 to 5.
Command message:
:DECode:BUS<n>:MANChester:TSIZe 5
DEC:BUS1:MANC:TSIZ 5
Query message:
DEC:BUS1:MANC:TSIZ?
Response message:
5
:DECode:BUS<n>:MANChester:WSIZe
Command/Query
DESCRIPTION The command sets the word size of the Manchester bus.
This query returns the current word size of the Manchester bus.
EXAMPLE The following command sets the word size of the Manchester on
bus 1 to 5.
Command message:
:DECode:BUS<n>:MANChester:WSIZe 5
DEC:BUS1:MANC:WSIZ 5
Query message:
DEC:BUS1:MANC:WSIZ?
Response message:
5
:DECode:BUS<n>:MANChester:DSIZe
Command/Query
DESCRIPTION The command sets the data word length of the Manchester bus.
EXAMPLE The following command sets the data bits of the Manchester on
bus 1 to 5.
Command message:
:DECode:BUS<n>:MANChester:DSIZe 5
DEC:BUS1:MANC:DSIZ 5
Query message:
DEC:BUS1:MANC:DSIZ?
Response message:
5
:DECode:BUS<n>:MANChester:DISPlay
Command/Query
DESCRIPTION The command sets the display format of the Manchester bus.
<format>:= {WORD|BIT}
<format>:= {WORD|BIT}
Command message:
:DECode:BUS<n>:MANChester:DISPlay WORD
DEC:BUS1:MANC:DISP WORD
Query message:
DEC:BUS1:MANC:DISP?
Response message:
WORD
:DECode:BUS<n>:MANChester:BITorder
Command/Query
DESCRIPTION The command sets the bit order of the Manchester bus.
The query returns the current bit order of the Manchester bus.
<order>:= {LSB|MSB}
<order>:= {LSB|MSB}
EXAMPLE The following command sets the bit order of the Manchester
bus of the bus 1 as MSB.
Command message:
:DECode:BUS<n>:MANChester:BITorder MSB
DEC:BUS1:MANC:BIT MSB
Query message:
DEC:BUS1:MANC:BIT?
Response message:
MSB
The :DIGital subsystem commands control the viewing of digital channels. They also control
threshold settings for groups of digital channels.
:DIGital
:DIGital:ACTive
:DIGital:BUS<n>:DEFault
:DIGital:BUS<n>:DISPlay
:DIGital:BUS<n>:FORMat
:DIGital:BUS<n>:MAP
:DIGital:D<n>
:DIGital:HEIGht
:DIGital:LABel<n>
:DIGital:POINts
:DIGital:POSition
:DIGital:SKEW
:DIGital:SRATe
:DIGital:THReshold<n>
:DIGital
Command/Query
<state>:= {ON|OFF}
ON enables the channel.
OFF disables the channel.
<state>:= {ON|OFF}
Command message:
:DIGital ON
DIG ON
Query message:
DIG?
Response message:
ON
:DIGital:ACTive
Command/Query
<digital>:= {D<x>}
<digital>:= {D<x>}
Command message:
:DIGital:ACTive D5
DIG:ACT D5
Query message:
DIG:ACT?
Response message:
D5
:DIGital:BUS<n>:DEFault
Command
DESCRIPTION This command resets the digital channel bus bit order
EXAMPLE The following command resets the digital channel bus1 data.
Command message:
:DIGital:BUS1:DEFault
DIG:BUS1:DEF
:DIGital:BUS<n>:DISPlay
Command/Query
DESCRIPTION The command sets the display of the specified digital bus.
<state>:= {ON|OFF}
<state>:= {ON|OFF}
ON displays the selected bus.
OFF removes the selected bus from the display.
Command message:
:DIGital:BUS1:DISPlay ON
DIG:BUS1:DISP ON
Query message:
DIG:BUS1:DISP?
Response message:
ON
:DIGital:BUS<n>:FORMat
Command/Query
DESCRIPTION The command selects the display format of the specified digital
bus.
<format>:= {BINary|DECimal|HEX|ASCii}
BINary presents the decoded data in binary format
DECimal presents the decoded data in decimal format
HEX presents the decoded data in hexadecimal format
ASCii presents the decoded data in ASCII format
<format>:= {BINary|DECimal|HEX|ASCii}
EXAMPLE The following command selects the display format of the digital
bus 1 to HEX.
Command message:
:DIGital:BUS1:FORMat HEX
DIG:BUS1:FORM HEX
Query message:
DIG:BUS1:FORM?
Response message:
HEX
:DIGital:BUS<n>:MAP
Command/Query
DESCRIPTION The command sets the bit order of each digital channel in the
digital bus and the bit width of the digital bus.
<source>:= {D<x>}
Note:
• It will synchronously set the bit width of the digital bus,
which is determined by the number of parameters.
• Use the command :DIGital:BUS<n>:DEFault to reset the
bit sequence to d0-d15 according to the current digital bus
bit width.
<source>:= {D<x>}
Command message:
:DIGital:BUS1:MAP D0,D3,D7,D15
DIG:BUS1:MAP D0,D3,D7,D15
Query message:
DIG:BUS1:MAP?
Response message:
D0,D3,D7,D15
:DIGital:D<n>
Command/Query
<state>:= {ON|OFF}
ON enables the specified digital channel.
OFF disables the specified digital channel.
<state>:= {ON|OFF}
Command message:
:DIGital:D5 OFF
DIG:D5 OFF
Query message:
DIG:D5?
Response message:
OFF
:DIGital:HEIGht
Command/Query
EXAMPLE The following command sets the height of the digital channel
display area to 6 div.
Command message:
:DIGital:HEIGht 6.00E+00
DIG:HEIG 6.00E+00
Query message:
DIG:HEIG?
Response message:
6.00E+00
:DIGital:LABel<n>
Command/Query
DESCRIPTION This command sets the label text of the selected digital
channel.
This query returns the current label text of the selected digital
channel.
EXAMPLE The following command sets the label name of the digital
channel 15 to "IIC_DATA".
Command message:
:DIGital:LABel15 "IIC_DATA"
DIG:LAB15 "IIC_DATA"
Query message:
DIG:LAB15?
Response message:
“IIC_DATA”
:DIGital:POINts
Query
DESCRIPTION This query returns the number of sampling points of the digital
channel.
Query message:
DIG:POIN?
Response message:
6.25E+02
:DIGital:POSition
Command/Query
DESCRIPTION The command sets the position of the digital channel waveform
display.
Note:
The range of legal values varies with the number of digital
channels displayed.
EXAMPLE The following command sets the position of the digital channel
display area to 4 div when the digital channel height is 4.
Command message:
:DIGital:POSition 4.00E+00
DIG:POS 4.00E+00
Query message:
DIG:POS?
Response message:
4.00E+00
:DIGital:SKEW
Command/Query
EXAMPLE The following command sets the skew of the digital channel to
100 ns.
Command message:
:DIGital:SKEW 1.00E-07
DIG:SKEW 1.00E-07
Query message:
DIG:SKEW?
Response message:
1.00E-07
:DIGital:SRATe
Query
DESCRIPTION This command query returns the sampling rate of the digital
channel.
EXAMPLE The following command query returns the sampling rate of the
digital channel.
Query message:
DIG:SRAT?
Response message:
1.25E+09
:DIGital:THReshold<n>
Command/Query
DESCRIPTION This command sets the threshold value of the digital channel
group.
<n>:= {1|2}
1 means D0-D7
2 means D8-D15
<type>:=
{TTL|CMOS|LVCMOS33|LVCMOS25|CUSTom[,<value>]}
<type>:=
{TTL|CMOS|LVCMOS33|LVCMOS25|CUSTom[,<value>]}
Command message:
:DIGital:THReshold1 CMOS
DIG:THR1 CMOS
Query message:
DIG:THR1?
Response message:
CMOS
DISPlay Commands
:DISPlay:AXIS
:DISPlay:AXIS:MODE
:DISPlay:BACKlight
:DISPlay:CLEar
:DISPlay:COLor
:DISPlay:GRATicule
:DISPlay:GRIDstyle
:DISPlay:INTensity
:DISPlay:MENU
:DISPlay:PERSistence
:DISPlay:TRANsparence
:DISPlay:TYPE
:DISPlay:AXIS
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:DISPlay:AXIS ON
DISP:AXIS ON
Query message:
DISP:AXIS?
Response message:
ON
:DISPlay:AXIS:MODE
Command/Query
<mode>:= {FIXed|MOVing}
FIXed means that position of the axes remain fixed, while
the coordinates update as the waveform is moving.
MOVing means when moving the waveform, the position of
the axes moves with the waveform, while the coordinates
remain fixed.
<mode>:= {FIXed|MOVing}
EXAMPLE The following command sets the mode of axis label to FIXed.
Command message:
:DISPlay:AXIS:MODE FIXed
DISP:AXIS:MODE FIXed
Query message:
DISP:AXIS:MODE?
Response message:
FIXed
:DISPlay:BACKlight
Command/Query
Command message:
:DISPlay:BACKlight 100
DISP:BACK 100
Query message:
DISP:BACK?
Response message:
100
:DISPlay:CLEar
Command
Command message:
:DISPlay:CLEar
DISP:CLE
:DISPlay:COLor
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:DISPlay:COLor ON
DISP:COL ON
Query message:
DISP:COL?
Response message:
ON
:DISPlay:GRATicule
Command/Query
Command message:
:DISPlay:GRATicule 50
DISP:GRAT 50
Query message:
DISP:GRAT?
Response message:
50
:DISPlay:GRIDstyle
Command/Query
<type>:= {FULL|LIGHt|NONE}
<type>:= {FULL|LIGHt|NONE}
EXAMPLE The following command sets the grid type to light grid.
Command message:
:DISPlay:GRIDstyle LIGHt
DISP:GRID LIGH
Query message:
DISP:GRID?
Response message:
LIGHt
:DISPlay:INTensity
Command/Query
EXAMPLE The following command sets the intensity level of the waveform
to 75%.
Command message:
:DISPlay:INTensity 75
DISP:INT 75
Query message:
DISP:INT?
Response message:
75
:DISPlay:MENU
Command/Query
<type>:= {EMBedded|FLOating}
<type>:= {EMBedded|FLOating}
Command message:
:DISPlay:MENU FLOating
DISP:MENU FLO
Query message:
DISP:MENU?
Response message:
FLOating
:DISPlay:PERSistence
Command/Query
<time>:= {OFF|INFinite|1S|5S|10S|30S}
<time>:= {OFF|INFinite|1S|5S|10S|30S}
Command message:
:DISPlay:PERSistence 5S
DISP:PERS 5S
Query message:
DISP:PERS?
Response message:
5S
:DISPlay:TRANsparence
Command/Query
Command message:
:DISPlay:TRANsparence 80
DISP:TRAN 80
Query message:
DISP:TRAN?
Response message:
80
:DISPlay:TYPE
Command/Query
DESCRIPTION The command sets the interpolation lines between data points.
<type>:= {VECTor|DOT}
VECTor is the default mode and draws lines between points.
DOT mode displays data more quickly than vector mode but
does not draw lines between sample points.
<type>:= {VECTor|DOT}
EXAMPLE The following command sets the interpolation lines between data
points to vector.
Command message:
:DISPlay:TYPE VECTor
DISP:TYPE VECT
Query message:
DISP:TYPE?
Response message:
VECTor
DVM Commands
The :DVM subsystem commands control the digital voltage meter (DVM) feature. This function can
be used to measure parameters such as DC and AC amplitudes.
:DVM
:DVM:ALARm
:DVM:ARANge
:DVM:CURRent
:DVM:HOLD
:DVM:MODE
:DVM:SOURce
:DVM
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:DVM ON
DVM ON
Query message:
DVM?
Response message:
ON
:DVM:ALARm
Command/Query
DESCRIPTION This command sets the switch of the overload alarm. When
enabled, an alarm will be given if the signal amplitude exceeds
the screen range.
<state>:= {ON|OFF}
<state>:= {ON|OFF}.
Command message:
:DVM:ALARm ON
DVM:ALAR ON
Query message:
DVM:ALAR?
Response message:
ON
:DVM:ARANge
Command/Query
DESCRIPTION This command sets the auto range state for the dvm.
The query returns the auto range state for the dvm.
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:DVM:ARANge ON
DVM:ARAN ON
Query message:
DVM:ARAN?
Response message:
ON
:DVM:CURRent
Query
DESCRIPTION The query returns the displayed 3-digit DVM value based on
the current mode.
EXAMPLE The following query returns the value of the current dvm mode.
Query message:
DVM:CURR?
Response message:
0.98E+00
:DVM:HOLD
Command/Query
DESCRIPTION This command sets the hold switch of dvm. When enabled, the
measured display value will remain unchanged.
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:DVM:HOLD ON
DVM:HOLD ON
Query message:
DVM:HOLD?
Response message:
ON
:DVM:MODE
Command/Query
<mode>:= {DCavg|DCRMs|ACRMs|PKPK|AMPLitude}
DCavg displays the DC value of the acquired data.
DCRMs displays the root-mean-square value of the
acquired data.
ACRMs displays the root-mean-square value of the
acquired data, with the DC component removed.
PKPK displays the difference between maximum and
minimum data values
AMPLitude displays difference between top and base in a
bimodal waveform. If not bimodal, displays difference
between max and min
<mode>:= {DCavg|DCRMs|ACRMs|PKPK|AMPLitude}
Command message:
:DVM:MODE AMPLitude
DVM:MODE AMPL
Query message:
DVM:MODE?
Response message:
AMPLitude
:DVM:SOURce
Command/Query
DESCRIPTION This command sets the select the analog channel on which
digital voltmeter (DVM) measurements are made.
<source>:= {C<x>}
C is analog channel <x>
<source>:= {Cx}
Command message:
:DVM:SOURce C2
DVM:SOUR C2
Query message:
DVM:SOUR?
Response message:
C2
FUNCtion Commands
The :FUNCtion subsystem commands control the math functions in the oscilloscope.
:FUNCtion:FFTDisplay
:FUNCtion:GVALue
:FUNCtion<n>
:FUNCtion<n>:AVERage:NUM
:FUNCtion<n>:DIFF:DX
:FUNCtion<n>:ERES:BITS
:FUNCtion<n>:FFT:AUToset
:FUNCtion<n>:FFT:HCENter
:FUNCtion<n>:FFT:HSCale
:FUNCtion<n>:FFT:SPAN
:FUNCtion<n>:FFT:LOAD
:FUNCtion<n>:FFT:MODE
:FUNCtion<n>:FFT:POINts
:FUNCtion<n>:FFT:RESET
:FUNCtion<n>:FFT:RLEVel
:FUNCtion<n>:FFT:SCALe
:FUNCtion<n>:FFT:SEARch
:FUNCtion<n>:FFT:SEARch:EXCursion
:FUNCtion<n>:FFT:SEARch:THReshold
:FUNCtion<n>:FFT:UNIT
:FUNCtion<n>:FFT:WINDow
:FUNCtion<n>:FILTer:TYPe
:FUNCtion<n>:FILTer:HFRequency
:FUNCtion<n>:FILTer:LFRequency
:FUNCtion<n>:INTegrate:GATE
:FUNCtion<n>:INTErpolate:COEF
:FUNCtion<n>:INVert
:FUNCtion<n>:LABel
:FUNCtion<n>:LABel:TEXT
:FUNCtion<n>:MAXHold:SWeeps
:FUNCtion<n>:MINHold:SWeeps
:FUNCtion<n>:OPERation
:FUNCtion<n>:POSition
:FUNCtion<n>:SCALe
:FUNCtion<n>:SOURce1
:FUNCtion<n>:SOURce2
:FUNCtion:FFTDisplay
Command/Query
DESCRIPTION This command sets the display mode of the FFT waveform.
<mode>:= {SPLit|FULL|EXCLusive}
SPLit means that the channel waveform and the FFT
waveform are displayed on the screen separately.
FULL means a full-screen display of the FFT waveform.
EXCLusive means that only the FFT waveform is
displayed on the screen.
<mode>:= {SPLit|FULL|EXCLusive}
EXAMPLE The following command sets the display mode of the FFT
waveform to split.
Command message:
:FUNCtion:FFTDisplay SPLit
FUNC:FFTD SPL
Query message:
FUNC:FFTD?
Response message:
SPLit
:FUNCtion:GVALue
Command/Query
Note:
The value of GA cannot be greater than that of GB. If you set
the value greater than GB, it will automatically be set to the
same value as GB.
Command message:
:FUNCtion:GVALue -1.00E-07,1.00E-07
FUNC:GVAL -1.00E-07,1.00E-07
Query message:
FUNC:GVAL?
Response message:
-1.00E-07,1.00E-07
:FUNCtion<n>
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:FUNCtion1 ON
FUNC1 ON
Query message:
FUNC1?
Response message:
ON
:FUNCtion<n>:AVERage:NUM
Command/Query
DESCRIPTION This command sets the average number for the average
operation.
This query returns the current average number for the average
operation.
<num>:= vary from models, see the table below for details.
Model <num>
SDS6000 Pro
SDS6000A {4|16|32|64|128|256|512|1024|2048
SDS6000L |4096|8192}
SDS2000X HD
SDS2000X Plus {4|16|32|64|128|256|512|1024}
EXAMPLE The following command changes the average number for the
average operation to 128 on Function2.
Command message:
:FUNCtion2:AVERage:NUM 128
FUNC2:AVER:NUM 128
Query message:
FUNC2:AVER:NUM?
Response message:
128
:FUNCtion<n>:DIFF:DX
Command/Query
DESCRIPTION This command sets the step size of the differential operation.
Command message:
:FUNCtion1:DIFF:DX 4
FUNC1:DIFF:DX 4
Query message:
FUNC1:DIFF:DX?
Response message:
4
:FUNCtion<n>:ERES:BITS
Command/Query
DESCRIPTION This command sets the eres bits for the eres operation.
This query returns the current eres bits for the eres operation.
<bits>:= {0.5|1.0|1.5|2.0|2.5|3.0}
EXAMPLE The following command changes the eres bits for the eres
operation to 3.0 on Function2.
Command message:
:FUNCtion2:ERES:BITS 3.0
FUNC2:ERES:BITS 3.0
Query message:
FUNC2:ERES:BITS?
Response message:
3.0
:FUNCtion<n>:FFT:AUToset
Command
<mode>:= {SPAN|PEAK|NORMal}
SPAN – full span.
PEAK – center to peak.
NORMal –center set to the fundamental frequency and the
span is set to one-half of the fft sampling rate
Command message:
:FUNCtion2:FFT:AUToset NORMal
FUNC2:FFT:AUT NORM
:FUNCtion<n>:FFT:HCENter
Command/Query
Note:
The range of legal values varies with the value set by the
command :TIMebase:SCALe.
Command message:
:FUNCtion2:FFT:HCENter 2.00E+06
FUNC2:FFT:HCEN 2.00E+06
Query message:
FUNC2:FFT:HCEN?
Response message:
2.00E+06Hz
:FUNCtion<n>:FFT:HSCale
Query
Query message:
FUNC2:FFT:HSC?
Response message:
1.00E+08
:FUNCtion<n>:FFT:SPAN
Command/Query
Query message:
FUNC2:FFT:SPAN?
Response message:
1.00E+08
:FUNCtion<n>:FFT:LOAD
Command/Query
Note:
The load can be set only when the FFT unit is dBm.
Command message:
:FUNCtion2:FFT:LOAD 50
FUNC2:FFT:LOAD 50
Query message:
FUNC2:FFT:LOAD?
Response message:
50
:FUNCtion<n>:FFT:MODE
Command/Query
<mode>:= {NORMal|MAXHold|AVERage[,<num>]}
NORMal sets the FFT in the normal mode.
MAXHold sets the FFT in the max detect mode.
AVERage sets the FFT in the averaging mode.
<mode>:= {NORMal|MAXHold|AVERage[,<num>]}
EXAMPLE The following command sets the acquisition mode of the FFT
operation on Function2 to normal.
Command message:
:FUNCtion2:FFT:MODE NORMaL
FUNC2:FFT:MODE NORM
Query message:
FUNC2:FFT:MODE?
Response message:
NORMal
:FUNCtion<n>:FFT:POINts
Command/Query
DESCRIPTION This command sets the maximum number of points for the FFT
operation.
<point>:= Vary from models, see the table below for details.
Model Value Range
SDS6000 Pro
{1k|2k|4k|8k|16k|32k|64k|128k|256k
SDS6000A
|512k|1M|2M|4M|8M}
SDS6000L
SDS5000X
{1k|2k|4k|8k|16k|32k|64k|128k|256k
SDS2000X Plus
|512k|1M|2M}
SDS2000X HD
SHS800X {1k|2k|4k|8k|16k|32k|64k|128k|256k
SHS1000X |512k|1M}
QUERY SYNTAX :FUNCtion<n>:FFT:POINts?
Command message:
:FUNCtion2:FFT:POINts 2M
FUNC2:FFT:POIN 2M
Query message:
FUNC2:FFT:POIN?
Response message:
2M
:FUNCtion<n>:FFT:RESET
Command
Command message:
:FUNCtion2:FFT:RESET
FUNC2:FFT:RESET
:FUNCtion<n>:FFT:RLEVel
Command/Query
DESCRIPTION The command sets the reference level of the FFT operation.
Note:
The smaller the :FUNCtion<n>:FFT:SCALe, the greater the
accuracy of the level value.
Command message:
:FUNCtion2:FFT:RLEVel 1.00E+01
FUNC2:FFT:RLEV 1.00E+01
Query message:
FUNC2:FFT:RLEV?
Response message:
1.00E+01
:FUNCtion<n>:FFT:SCALe
Command/Query
Command message:
:FUNCtion2:FFT:SCALe 2.00E+01
FUNC2:FFT:SCAL 2.00E+01
Query message:
FUNC2:FFT:SCAL?
Response message:
2.00E+01
:FUNCtion<n>:FFT:SEARch
Command/Query
DESCRIPTION This command selects the search tools type of the FFT
operation.
This query returns the current search tools type of the FFT
operation.
<type>:= {OFF|PEAK|MARKer}
<type>:= {OFF|PEAK|MARKer}
EXAMPLE The following command sets the search tools type of FFT
operation on Function2 to marker.
Command message:
:FUNCtion2:FFT:SEARch MARKer
FUNC2:FFT:SEAR MARK
Query message:
FUNC2:FFT:SEAR?
Response message:
MARKer
:FUNCtion<n>:FFT:SEARch:EXCursion
Command/Query
DESCRIPTION This command sets the search excursion of the search tool
(marker or peak) for the FFT operation.
The range of the values is [0, 1.60E+02] when the FFT unit is
dBVrms. The value range varies with the corresponding unit.
Note:
The range of values varies with the value set by
the :CHANnel<n>:PROBe commands.
Command message:
:FUNCtion2:FFT:SEARch:EXCursion 2.00E+01
FUNC2:FFT:SEAR:EXC 2.00E+01
Query message:
FUNC2:FFT:SEAR:EXC?
Response message:
2.00E+01
:FUNCtion<n>:FFT:SEARch:RESult
Query
DESCRIPTION The query returns the current search list result for the FFT
operation. It only contains search number, frequency and
amplitude information.
<type>:={Markers|Peaks}
<no>:= Value in NR1 format, indicates the peak number or
marker number
<freq>:= Value in NR3 format, including a decimal point and
exponent, like 1.23E+2.
<ampl>:= Value in NR3 format, including a decimal point and
exponent, like 1.23E+2. The unit is the same as FFT vertical
unit
EXAMPLE The following query returns the peaks result of function1 in the
figure below.
Query message:
FUNC1:FFT:SEAR:RES?
Response message:
Peaks,1,9.536743E+02,2.231755E+00;2,3.099442E+03,-8.05
6905E+00;3,5.006790E+03,-1.151463E+01;4,6.914139E+03,-
1.514894E+01;5,9.059906E+03,-1.694874E+01;6,1.096725E
+04,-1.847880E+01;7,1.311302E+04,-2.107302E+01;8,1.5020
37E+04,-2.107302E+01;9,1.692772E+04,-2.264706E+01;10,1
.907349E+04,-2.361992E+01;
:FUNCtion<n>:FFT:SEARch:THReshold
Command/Query
DESCRIPTION The command sets the search threshold of the search tool
(marker or peak) for the FFT operation.
Command message:
:FUNCtion2:FFT:SEARch:THReshold -1.00E+2
FUNC2:FFT:SEAR:THR -1.00E+2
Query message:
FUNC2:FFT:SEAR:THR?
Response message:
-1.00E+02
:FUNCtion<n>:FFT:UNIT
Command/Query
DESCRIPTION This command sets the unit type of the FFT operation.
This query returns the current unit type of the FFT operation.
<unit>:= {DBVrms|Vrms|DBm}
<unit>:= {DBVrms|Vrms|DBm}
EXAMPLE The following command sets the unit type of FFT operation on
Function2 to dBVrms.
Command message:
:FUNCtion2:FFT:UNIT DBVrms
FUNC2:FFT:UNIT DBVrms
Query message:
FUNC2:FFT:UNIT?
Response message:
DBVrms
:FUNCtion<n>:FFT:WINDow
Command/Query
DESCRIPTION This command selects the window type of the FFT operation.
This query returns the current window type of the FFT operation.
<window>:=
{RECTangle|BLACkman|HANNing|HAMMing|FLATtop}
RECTangle is useful for transient signals, and signals where
there are an integral number of cycles in the time record.
BLACkman reduces time resolution compared to the
rectangular window, but it improves the capacity to detect
smaller impulses due to lower secondary lobes (provides
minimal spectral leakage).
HANNing is useful for frequency resolution and
general-purpose use. It is good for resolving two frequencies
that are close together, or for making frequency
measurements.
HAMMing means Hamming.
FLATtop is the best for making accurate amplitude
measurements of frequency peaks.
<window>:=
{RECTangle|BLACkman|HANNing|HAMMing|FLATtop}
EXAMPLE The following command sets the windowing of the FFT operation
on Function2 to Flattop.
Command message:
:FUNCtion2:FFT:WINDow FLATtop
FUNC2:FFT:WIND FLAT
Query message:
FUNC2:FFT:WIND?
Response message:
FLATtop
:FUNCtion<n>:FILTer:TYPe
Command/Query
DESCRIPTION This command selects the filter type of the filter operation.
This query returns the current filter type of the filter operation.
<type>:= {LPASs|HPASs|BPASs|BREJect}
LPASs - Low pass filter.
HPASs - High pass filter.
BPASs - Band pass filter.
BREJect - Band reject filter.
<type>:= {LPASs|HPASs|BPASs|BREJect}
EXAMPLE The following command sets the filter type of the filter operation on
Function2 to HPASs.
Command message:
:FUNCtion<n>:FILTer:TYPe HPASs
FUNC2:FILT:TYP HPAS
Query message:
FUNC2:FILT:TYP?
Response message:
HPASs
:FUNCtion<n>:FILTer:HFRequency
Command/Query
EXAMPLE The following command sets the upper freq for the filter
operation to 100MHz on Function2.
Command message:
:FUNCtion2:FILTer:HFRequency 100MHz
FUNC2:FILT:HFR 100MHz
Query message:
FUNC2:FILT:HFR?
Response message:
1.00E+08
:FUNCtion<n>:FILTer:LFRequency
Command/Query
EXAMPLE The following command sets the lower freq for the filter
operation to 50MHz on Function2.
Command message:
:FUNCtion2:FILTer:LFRequency 50MHz
FUNC2:FILT:LFR 50MHz
Query message:
FUNC2:FILT:LFR?
Response message:
5.00E+07
:FUNCtion<n>:INTegrate:GATE
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
EXAMPLE The following command turns on the threshold for the integral
operation of function 1.
Command message:
:FUNCtion1:INTegrate:GATE ON
FUNC1:INT:GATE ON
Query message:
FUNC1:INT:GATE?
Response message:
ON
:FUNCtion<n>:INTegrate:OFFSet
Command/Query
Command message:
:FUNCtion1:INTegrate:OFFSet 1.00E-01
FUNC1:INT:OFFS 1.00E-01
Query message:
FUNC1:INT:OFFS?
Response message:
1.00E-01
:FUNCtion<n>:INTErpolate:COEF
Command/Query
DESCRIPTION This command sets the upsample coef for the interpolate
operation.
This query returns the current upsample coef for the interpolate
operation.
<coef>:= {2|5|10|20}
EXAMPLE The following command changes the upsample coef for the
interpolate operation to 10 on Function2.
Command message:
:FUNCtion2:INTErpolate:COEF 10
FUNC2:INTE:COEF 10
Query message:
FUNC2:INTE:COEF?
Response message:
10
:FUNCtion<n>:INVert
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:FUNCtion1:INVert ON
FUNC1:INV ON
Query message:
FUNC1:INV?
Response message:
ON
:FUNCtion<n>:LABel
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:FUNCtion1:LABel ON
FUNC1:LAB ON
Query message:
FUNC1:LAB?
Response message:
ON
:FUNCtion<n>:LABel:TEXT
Command/Query
DESCRIPTION This command sets the selected math label to the string that
follows. Setting a label for a math function also adds the name
to the label list in non-volatile memory (replacing the oldest
label in the list)
This query returns the current label text of the selected math.
EXAMPLE The following command sets the label text of the Function1 to
“MATH”.
Command message:
:FUNCtion1:LABel:TEXT "MATH"
FUNC1:LAB:TEXT "MATH"
Query message:
FUNC1:LAB:TEXT?
Response message:
“MATH”
:FUNCtion<n>:MAXHold:SWeeps
Command/Query
DESCRIPTION This command sets the sweeps limit for the maxhold operation.
This query returns the current sweeps limit for the maxhold
operation.
EXAMPLE The following command changes the sweeps limit for the
maxhold operation to 100 on Function2.
Command message:
:FUNCtion2:MAXHold:SWeeps 100
FUNC2:MAXH:SW 100
Query message:
FUNC2:MAXH:SW?
Response message:
100
:FUNCtion<n>:MINHold:SWeeps
Command/Query
DESCRIPTION This command sets the sweeps limit for the minhold operation.
This query returns the current sweeps limit for the minhold
operation.
EXAMPLE The following command changes the sweeps limit for the
minhold operation to 100 on Function2.
Command message:
:FUNCtion2:MINHold:SWeeps 100
FUNC2:MINH:SW 100
Query message:
FUNC2:MINH:SW?
Response message:
100
:FUNCtion<n>:OPERation
Command/Query
<operation>:=
{ADD|SUBTract|MULTiply|DIVision|INTegrate|DIFF|FFT|SQRT|
ERES|AVERage|ABSolute|SIGN|IDENtity|NEGation|EXP|TEN|
LN|LOG|INTErpolate|MAXHold|MINHold|FILTer}
<operation>:=
{ADD|SUBTract|MULTiply|DIVision|INTegrate|DIFF|FFT|SQRT|
ERES|AVERage|ABSolute|SIGN|IDENtity|NEGation|EXP|TEN|
LN|LOG|INTErpolate|MAXHold|MINHold|FILTer}
Command message:
:FUNCtion1:OPERation MULTiply
FUNC1:OPER MULT
Query message:
FUNC1:OPER?
Response message:
MULTiply
:FUNCtion<n>:POSition
Command/Query
DESCRIPTION This command sets the vertical position of the selected math
operation (arithmetic and algebra operation).
This query returns the current position value for the selected
operation.
Note:
The range of values is uniform and related to an operation.
Command message:
:FUNCtion1:POSition 5.00E-01
FUNC1:POS 5.00E-01
Query message:
FUNC1:POS?
Response message:
5.00E-01
:FUNCtion<n>:SCALe
Command/Query
DESCRIPTION The command sets the vertical scale of the selected math
operation (arithmetic and algebra operation).
The query returns the current scale value for the selected
operation.
Note:
• The range of the function scale is related to the scale of
the function source.
• When the operation is INTegrate and DIFF, the scale range
is related to the timebase.
Command message:
:FUNCtion1:SCALe 1.00E+00
FUNC1:SCAL 1.00E+00
Query message:
FUNC1:SCAL?
Response message:
1.00E+00
:FUNCtion<n>:SOURce1
Command/Query
<source>:= {C<x>|Z<x>|F<x>}
C is analog channel <x>
Z is zoom channel <x>
F is math function <x>, for math-on-math operations
Note:
• Z<x> is optional only when Zoom is on.
• FUNCtion<n> cannot set itself as the source.
<source>:= {C<x>|Z<x>|F<x>}
Command message:
:FUNCtion2:SOURce1 C1
FUNC2:SOUR1 C1
Query message:
FUNC2:SOUR1?
Response message:
C1
:FUNCtion<n>:SOURce2
Command/Query
<source>:= {C<x>|Z<x>|F<x>}
C is analog channel <x>
Z is zoom channel <x>
F is math function <x>, for math-on-math operations
Note:
• Z<x> is optional only when Zoom is on.
• FUNCtion<n> cannot set itself as the source.
<source>:= {C<x>|Z<x>|F<x>}
Command message:
:FUNCtion2:SOURce2 C1
FUNC2:SOUR2 C1
Query message:
FUNC2:SOUR2?
Response message:
C1
HISTORy Commands
The :HISTORy subsystem commands control the waveform recording function and the history
waveform play function.
:HISTORy
:HISTORy:FRAMe
:HISTORy:INTERval
:HISTORy:LIST
:HISTORy:PLAY
:HISTORy:TIME
:HISTORy
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:HISTORy ON
HISTOR ON
Query message:
HISTOR?
Response message:
ON
:HISTORy:FRAMe
Command/Query
Note:
The maximum number of frames is related to the number of
samples set for the acquisition (memory depth). More
points/frame means less total frames available. Fewer
points/frame equals more frames available.
EXAMPLE The following command sets the number of the history frame to
4.
Command message:
:HISTORy:FRAMe 4
HISTOR:FRAM 4
Query message:
HISTOR:FRAM?
Response message:
4
:HISTORy:INTERval
Command/Query
DESCRIPTION This command sets the play interval of the history frame.
This query returns the current play interval of the history frame.
EXAMPLE The following command sets the play interval of the history frame
to 1 ms.
Command message:
:HISTORy:INTERval 1.00E-03
HISTOR:INTER 1.00E-03
Query message:
HISTOR:INTER?
Response message:
1.00E-03
:HISTORy:LIST
Command/Query
<state>:= {OFF|ON[,<type>]}
<type>:= {TIME|DELTa}
TIME indicates that the time column is displayed by
sampling time
DELTa indicates that the time column is displayed by the
sampling interval.
<state>:= {OFF|ON[,<type>]}
<type>:= {TIME|DELTa}
EXAMPLE The following command turns on the history list and displays it
by sampling time.
Command message:
:HISTORy:LIST ON,TIME
HISTOR:LIST ON,TIME
Query message:
HISTOR:LIST?
Response message:
ON,TIME
:HISTORy:PLAY
Command/Query
DESCRIPTION This command sets the play state of the history waveform.
<state>:= {BACKWards|PAUSe|FORWards}
BACKWards indicates that the frame number is played
from highest frame number to lowest (last-to-first,
chronologically).
FORWards indicates that the frame number is played from
the lowest frame number to the highest (first-to-last,
chronologically).
PAUSe will pause playback.
<state>:= {BACKWards|PAUSe|FORWards}
EXAMPLE The following command sets the playback state of the history
waveform to backwards.
Command message:
:HISTORy:PLAY BACKWards
HISTOR:PLAY BACKW
Query message:
HISTOR:PLAY?
Response message:
BACKWards
:HISTORy:TIME
Query
DESCRIPTION The query returns the acquire timestamp of the current frame.
Query message:
:HISTOR:TIME?
Response message:
07:48:09.253827
MEASure Commands
:MEASure
:MEASure:ADVanced:LINenumber
:MEASure:ADVanced:P<n>
:MEASure:ADVanced:P<n>:SOURce1
:MEASure:ADVanced:P<n>:SOURce2
:MEASure:ADVanced:P<n>:STATistics
:MEASure:ADVanced:P<n>:TYPE
:MEASure:ADVanced:P<n>:VALue
:MEASure:ADVanced:STATistics
:MEASure:ADVanced:STATistics:HISTOGram
:MEASure:ADVanced:STATistics:MAXCount
:MEASure:ADVanced:STATistics:RESet
:MEASure:ADVanced:STYLe
:MEASure:GATE
:MEASure:GATE:GA
:MEASure:GATE:GB
:MEASure:MODE
:MEASure:SIMPle:ITEM
:MEASure:SIMPle:SOURce
:MEASure:SIMPle:VALue
:MEASure
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MEASure ON
:MEAS ON
Query message:
MEAS?
Response message:
ON
:MEASure:ADVanced:LINenumber
Command/Query
Command message:
:MEASure:ADVanced:LINenumber 12
MEAS:ADV:LIN 12
Query message:
MEAS:ADV:LIN?
Response message:
12
:MEASure:ADVanced:P<n>
Command/Query
<n>:= 1 to 12
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MEASure:ADVanced:P1 ON
MEAS:ADV:P1 ON
Query message:
MEAS:ADV:P1?
Response message:
ON
:MEASure:ADVanced:P<n>:SOURce1
Command/Query
<n>:= 1 to 12
<source>:=
{C<x>|Z<x>|F<x>|D<m>|ZD<m>|REFA|REFB|REFC|REFD}
C denotes an analog input channel.
Z denotes a zoomed input.
F denotes a math function.
D denotes a digital input channel.
ZD denotes a zoomed digital input channel.
REF denotes a reference waveform.
Note:
• Z<x> and ZD<m> are optional only when Zoom is on.
• The source can only be set to C<x> when the type is delay
measurement.
<source>:=
{C<x>|Z<x>|F<x>|D<m>|ZD<m>|REFA|REFB|REFC|REFD}
Command message:
:MEASure:ADVanced:P1:SOURce1 C1
MEAS:ADV:P1:SOUR1 C1
Query message:
MEAS:ADV:P1:SOUR1?
Response message:
C1
:MEASure:ADVanced:P<n>:SOURce2
Command/Query
<n>:= 1 to 12
<source>:=
{C<x>|Z<x>|F<x>|D<m>|ZD<m>|REFA|REFB|REFC|REFD}
C denotes an analog input channel. For example, C1 is
analog input 1.
Z denotes a zoomed waveform. For example, Z1 is zoom
waveform 1.
F denotes a math function. For example, F1 is math
function 1.
D denotes a digital waveform. For example, D1 denotes
digital input 1.
ZD denotes a zoomed digital input.
REF denotes a reference waveform.
Note:
• Z<x> and ZD<m> are optional only when Zoom is on.
• The source can only be set to C<x> when the type is delay
measurement.
<source>:=
{C<x>|Z<x>|F<x>|D<m>|ZD<m>|REFA|REFB|REFC|REFD}
Command message:
:MEASure:ADVanced:P1:SOURce2 C2
MEAS:ADV:P1:SOUR2 C2
Query message:
MEAS:ADV:P1:SOUR2?
Response message:
C2
:MEASure:ADVanced:P<n>:STATistics
Query
<n>:= 1 to 12
<type>:=
{ALL|CURRent|MEAN|MAXimum|MINimum|STDev|COUNt}
ALL returns all the statistics
CURRent returns the current value of the statistics
MEAN returns the mean value of the statistics
MAXimum returns the maximum value of the statistics
MINimum returns the minimum value of the statistics
STDev returns the standard deviation of the statistics
COUNt returns the current number of counts used to
calculate the statistical data
Note:
When measurement statistics are off, it returns OFF.
EXAMPLE The following query returns the statistical current value of the
first measurement item.
Query message:
MEAS:ADV:P1:STAT? CURR
Response message:
6.7E-02
:MEASure:ADVanced:P<n>:TYPE
Command/Query
DESCRIPTION This command sets the type for the specified measurement
item.
This query returns the type for the specified measurement item.
<n>:= 1 to 12
<parameter>:=
{PKPK|MAX|MIN|AMPL|TOP|BASE|LEVELX|CMEAN|MEAN|S
TDEV|VSTD|RMS|CRMS|MEDIAN|CMEDIAN|OVSN|FPRE|O
VSP|RPRE|PER|FREQ|TMAX|TMIN|PWID|NWID|DUTY|NDU
TY|WID|NBWID|DELAY|TIMEL|RISE|FALL|RISE10T90|FALL9
0T10|CCJ|PAREA|NAREA|AREA|ABSAREA|CYCLES|REDGE
S|FEDGES|EDGES|PPULSES|NPULSES|PHA|SKEW|FRR|F
RF|FFR|FFF|LRR|LRF|LFR|LFF|PACArea|NACArea|ACArea|A
BSACArea|PSLOPE|NSLOPE|TSR|TSF|THR|THF}
Description of Parameters
Parameter Description
Difference between maximum and
PKPK
minimum data values
MAX Highest value in waveform
MIN Lowest value in waveform
Difference between top and base in a
AMPL bimodal waveform. If not bimodal,
difference between max and min
Value of most probable higher state in a
TOP
bimodal waveform
Value of most probable lower state in a
BASE
bimodal waveform
LEVELX Level measured at trigger position
CMEAN Average value of the first cycle
MEAN Average of data values
STDEV Standard deviation of the data
VSTD Standard deviation of the first cycle
RMS Root mean square of the data
CRMS Root mean square of the first cycle
Value at which 50% of the measurement
MEDIAN
are above and 50% are below
CMEDIAN Median of the first cycle
Overshoot following a falling edge; 100%*
OVSN
(base-min)/amplitude
Overshoot before a falling edge;
FPRE
100%*(max-top)/amplitude
Overshoot following a rising edge;
OVSP
100%*(max-top)/amplitude
Overshoot before a rising edge;
RPRE
100%*(base-min)/amplitude
Time between the middle threshold points
PER
of two consecutive, like-polarity edges
EXAMPLE The following command sets the type of the first measurement
to maximum.
Command message:
:MEASure:ADVanced:P1:TYPE MAX
MEAS:ADV:P1:TYPE MAX
Query message:
MEAS:ADV:P1:TYPE?
Response message:
MAX
:MEASure:ADVanced:P<n>:VALue
Query
<n>:= 1 to 12
EXAMPLE The following query returns the value of the first measurement
item.
Query message:
MEAS:ADV:P1:VAL?
Response message:
4.033E+00
:MEASure:ADVanced:STATistics
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MEASure:ADVanced:STATistics ON
MEAS:ADV:STAT ON
Query message:
MEAS:ADV:STAT?
Response message:
ON
:MEASure:ADVanced:STATistics:HISTOGram
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MEASure:ADVanced:STATistics:HISTOGram ON
MEAS:ADV:STAT:HISTOG ON
Query message:
MEAS:ADV:STAT:HISTOG?
Response message:
ON
:MEASure:ADVanced:STATistics:MAXCount
Command/Query
DESCRIPTION This command sets the maximum value of the statistics count.
Note:
When the value is set to 0, it means unlimited statistics.
Command message:
:MEASure:ADVanced:STATistics:MAXCount 1024
MEAS:ADV:STAT:MAXC 1024
Query message:
MEAS:ADV:STAT:MAXC?
Response message:
1024
:MEASure:ADVanced:STATistics:RESet
Command
Command message:
:MEASure:ADVanced:STATistics:RESet
MEAS:ADV:STAT:RES
:MEASure:ADVanced:STYLe
Command/Query
<type>:= {M1|M2}
M1 lists a measurement, corresponding statistics, and
histogram vertically on the display.
M2 lists a measurement and corresponding statistics
horizontally on the display. No histogram is available with
M2.
<type>:= {M1|M2}
Command message:
:MEASure:ADVanced:STYLe M1
MEAS:ADV:STYL M1
Query message:
MEAS:ADV:STYL?
Response message:
M1
:MEASure:GATE
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MEASure:GATE ON
MEAS:GATE ON
Query message:
MEAS:GATE?
Response message:
ON
:MEASure:GATE:GA
Command/Query
Note:
The value of GA cannot be greater than that of GB. If you set the
value greater than GB, it will automatically be set to the same
value as GB.
EXAMPLE The following command sets the position of gate A to -100 ns.
Command message:
:MEASure:GATE:GA -1.00E-07
MEAS:GATE:GA -1.00E-07
Query message:
MEAS:GATE:GA?
Response message:
-1.00E-07
:MEASure:GATE:GB
Command/Query
Note:
The value of GB cannot be less than that of GA. If you set the
value less than GA, it will automatically be set to the same
value as GA.
EXAMPLE The following command sets the position of gate B to 100 ns.
Command message:
:MEASure:GATE:GB 1.00E-07
MEAS:GATE:GB 1.00E-07
Query message:
MEAS:GATE:GB?
Response message:
1.00E-07
:MEASure:MODE
Command/Query
<type>:= {SIMPle|ADVanced}
SIMPle shows measurements only
ADVanced shows measurements and includes selections
for statistics, view mode (M1, M2), histogram, and
trending.
<type>:= {SIMPle|ADVanced}
Command message:
:MEASure:MODE SIMPle
MEAS:MODE SIMP
Query message:
MEAS:MODE?
Response message:
SIMPle
:MEASure:SIMPle:ITEM
Command
<parameter>:=
{PKPK|MAX|MIN|AMPL|TOP|BASE|LEVELX|CMEAN|MEAN|S
TDEV|VSTD|RMS|CRMS|MEDIAN|CMEDIAN|OVSN|FPRE|O
VSP|RPRE|PER|FREQ|TMAX|TMIN|PWID|NWID|DUTY|NDU
TY|WID|NBWID|DELAY|TIMEL|RISE|FALL|RISE20T80|FALL8
0T20|CCJ|PAREA|NAREA|AREA|ABSAREA|CYCLES|REDGE
S|FEDGES|EDGES|PPULSES|NPULSES|PACArea|NACArea|
ACArea|ABSACArea}
<state>:= {ON|OFF}
Note:
See the table for details.
Command message:
:MEASure:SIMPle:ITEM MAX,ON
MEAS:SIMP:ITEM MAX,ON
:MEASure:SIMPle:SOURce
Command/Query
<source>:=
{C<x>|Z<x>|F<x>|D<m>|ZD<m>|REFA|REFB|REFC|REFD}
C denotes an analog input channel. For example, C1 is
analog input 1.
Z denotes a zoomed waveform. For example, Z1 is zoom
waveform 1.
F denotes a math function. For example, F1 is math function
1.
D denotes a digital waveform. For example, D1 denotes
digital input 1.
REF denotes a reference waveform.
Note:
Z<x> and ZD<m> are optional only when Zoom is on.
<source>:=
{C<x>|Z<x>|F<x>|D<m>|ZD<m>|REFA|REFB|REFC|REFD}
Command message:
:MEASure:SIMPle:SOURce C1
MEAS:SIMP:SOUR C1
Query message:
MEAS:SIMP:SOUR?
Response message:
C1
:MEASure:SIMPle:VALue
Query
<type>:=
{PKPK|MAX|MIN|AMPL|TOP|BASE|LEVELX|CMEAN|MEAN|S
TDEV|VSTD|RMS|CRMS|MEDIAN|CMEDIAN|OVSN|FPRE|O
VSP|RPRE|PER|FREQ|TMAX|TMIN|PWID|NWID|DUTY|NDU
TY|WID|NBWID|DELAY|TIMEL|RISE|FALL|RISE20T80|FALL8
0T20|CCJ|PAREA|NAREA|AREA|ABSAREA|CYCLES|REDGE
S|FEDGES|EDGES|PPULSES|NPULSES|PACArea|NACArea|
ACArea|ABSACArea|ALL}
Note:
• See the table for details.
• ALL is only valid for queries, and it returns all
measurement values of all measurement types except for
delay measurements.
Query message:
MEAS:SIMP:VAL? MAX
Response message:
2.000E+00
:MEASure:THReshold:SOURce
Command/Query
<source>:= {C<x>|Z<x>|F<x>|REFA|REFB|REFC|REFD}
C denotes an analog input channel. For example, C1 is
analog input 1.
Z denotes a zoomed waveform. For example, Z1 is zoom
waveform 1.
F denotes a math function. For example, F1 is math function
1.
REF denotes a reference waveform.
Note:
Z<x> and ZD<m> are optional only when Zoom is on.
Command message:
:MEASure:THReshold:SOURce C1
MEAS:THR:SOUR C1
Query message:
MEAS:THR:SOUR?
Response message:
C1
:MEASure:THReshold:TYPE
Command/Query
<type>:= {PERCent|ABSolute}
<type>:= {PERCent|ABSolute}
Command message:
:MEASure:THReshold:TYPE PERCent
MEAS:THR:TYPE PERC
Query message:
MEAS:THR:TYPE?
Response message:
PERCent
:MEASure:THReshold:ABSolute
Command/Query
Command message:
:MEASure:THReshold:ABSolute 3.00,1.00,-1.50
MEAS:THR:ABS 3.00,1.00,-1.50
Query message:
MEAS:THR:ABS?
Response message:
3.00 E+00,1.00 E+00,-1.50E+00
:MEASure:THReshold:PERCent
Command/Query
Command message:
:MEASure:THReshold:PERCent 80,45,10
MEAS:THR:PERC 80,45,10
Query message:
MEAS:THR:PERC?
Response message:
80,45,10
MEMory Commands
:MEMory<n>:HORizontal:POSition
:MEMory<n>:HORizontal:SCALe
:MEMory<n>:HORizontal:SYNC
:MEMory<n>:IMPort
:MEMory<n>:LABel
:MEMory<n>:LABel:TEXT
:MEMory<n>:SWITch
:MEMory<n>:VERTical:POSition
:MEMory<n>:VERTical:SCALe
:MEMory<n>:HORizontal:POSition
Command/Query
Command message:
:MEMory2:HORizontal:POSition 1.00E-05
MEM2:HOR:POS 1.00E-05
Query message:
MEM2:HOR:POS?
Response message:
1.00E-05
:MEMory<n>:HORizontal:SCALe
Command/Query
DESCRIPTION The command sets the horizontal scale per division for the
memory waveform.
Command message:
:MEMory2:HORizontal:SCALe 1.00E-07
MEM2:HOR:SCAL 1.00E-07
Query message:
MEM2:HOR:SCAL?
Response message:
1.00E-07
:MEMory<n>:HORizontal:SYNC
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MEMory2:HORizontal:SYNC ON
MEM2:HOR:SYNC ON
Query message:
MEM2:HOR:SYNC?
Response message:
ON
:MEMory<n>:IMPort
Command
<source>:= {C<x>|Z<x>|F<x>|M<x>|<path>}
C denotes an analog input channel. For example, C1 is
analog input 1.
Z denotes a zoomed waveform. For example, Z1 is zoom
waveform 1.
F denotes a math function. For example, F1 is math
function 1.
M denotes a memory waveform. For example, M1 denotes
Memory 1.
<path>:= Quoted string of path with an extension “.bin”,
denotes a waveform file.
Command message:
:MEMory2:IMPort C2
MEM2:IMP C2
:MEMory<n>:LABel
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MEMory2:LABel ON
MEM2:LAB ON
Query message:
MEM2:LAB?
Response message:
ON
:MEMory<n>:LABel:TEXT
Command/Query
DESCRIPTION The command sets the selected memory label to the string that
follows. Setting a label for a memory waveform also adds the
name to the label list in non-volatile memory (replacing the
oldest label in the list)
The query returns the current label text of the selected memory
waveform.
EXAMPLE The following command sets the label text of the M2 to “MATH”.
Command message:
:MEMory2:LABel:TEXT “MATH”
MEM2:LAB:TEXT “MATH”
Query message:
MEM2:LAB:TEXT?
Response message:
“MATH”
:MEMory<n>:SWITch
Command
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MEMory2:SWITch ON
MEM2:SWIT ON
Query message:
MEM2:SWIT?
Response message:
ON
:MEMory<n>:VERTical:POSition
Command/Query
This query returns the current position value for the selected
memory.
Command message:
:MEMory2:VERTical:POSition 1.00E-01
MEM2:VERT:POS 1.00E-01
Query message:
MEM2:VERT:POS?
Response message:
1.00E-01
:MEMory<n>:VERTical:SCALe
Command/Query
DESCRIPTION The command sets the vertical scale of the selected memory
waveform.
The query returns the current scale value for the selected
memory waveform.
Command message:
:MEMory2:VERTical:SCALe 1.00E-01
MEM2:VERT:SCAL 1.00E-01
Query message:
MEM2:VERT:SCAL?
Response message:
1.00E-01
MTEst Commands
:MTESt
:MTESt:COUNt
:MTESt:FUNCtion:BUZZer
:MTESt:FUNCtion:COF
:MTESt:FUNCtion:FTH
:MTESt:FUNCtion:SOF
:MTESt:IDISplay
:MTESt:MASK:CREate
:MTESt:MASK:LOAD
:MTESt:OPERate
:MTESt:RESet
:MTESt:SOURce
:MTESt:TYPE
:MTESt
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MTESt ON
MTES ON
Query message:
MTES?
Response message:
ON
:MTESt:COUNt
Query
EXAMPLE The following command returns the count of the mask test.
Query message:
MTES:COUN?
Response message:
FAIL,38176,PASS,5617,TOTAL,43793
:MTESt:FUNCtion:BUZZer
Command/Query
DESCRIPTION This command sets the state of the buzzer when failure frames
are detected.
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MTESt:FUNCtion:BUZZer ON
MTES:FUNC:BUZZ ON
Query message:
MTES:FUNC:BUZZ?
Response message:
ON
:MTESt:FUNCtion:COF
Command/Query
DESCRIPTION This command sets the state of the mask test function "Capture
on Fail". When this function is enabled, the default path to save
the image of failing frames is “SIGLENT/”.
<state>:= {OFF|ON}
<state>:= {OFF|ON}
EXAMPLE The following command turns on the Capture on Fail and saves
the screenshot to the U disk path “SIGLENT/”.
Command message:
:MTESt:FUNCtion:COF ON
MTES:FUNC:COF ON
Query message:
MTES:FUNC:COF?
Response message:
ON
:MTESt:FUNCtion:FTH
Command/Query
DESCRIPTION This command sets the state of the mask test function "Failure
to History".
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MTESt:FUNCtion:FTH ON
MTES:FUNC:FTH ON
Query message:
MTES:FUNC:FTH?
Response message:
ON
:MTESt:FUNCtion:SOF
Command/Query
DESCRIPTION This command sets the state of the mask test function
“Stop-on-Fail”.
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:MTESt:FUNCtion:SOF ON
MTES:FUNC:SOF ON
Query message:
MTES:FUNC:SOF?
Response message:
ON
:MTESt:IDISplay
Command/Query
DESCRIPTION This command sets the state of the mask test result display.
This command query returns the status of the mask test result
display.
<state>:= {ON|OFF}
<state>:= {ON|OFF}
EXAMPLE The following command enables the display of the mask test.
Command message:
:MTESt:IDISplay ON
MTES:IDIS ON
Query message:
MTES:IDIS?
Response message:
ON
:MTESt:MASK:CREate
Command
DESCRIPTION This command sets the mask X and mask Y of mask test.
EXAMPLE The following command sets the mask X to 0.8, the mask Y to
0.08.
Command message:
:MTESt:MASK:CREate 0.8,0.08
MTES:MASK:CRE 0.8,0.08
:MTESt:MASK:LOAD
Command
<location>:= {INTernal,<num>|EXTernal,<path>}
<num>:= {1|2|3|4}
Note:
The file format is not automatically determined by the file name
extension. You need to choose a file name with an extension
which is consistent with the selected file format.
Command message:
:MTESt:MASK:LOAD INTernal,1
MTES:MASK:LOAD INT,1
Command message:
MTES:MASK:LOAD EXTernal,”SIGLENT/TEST.msk”
:MTESt:OPERate
Command/Query
DESCRIPTION This command sets the state of the mask test operation.
<state>:= {ON|OFF}
<state>:= {ON|OFF}
EXAMPLE The following command enables the operation of the mask test.
Command message:
:MTESt:OPERate ON
MTES:OPER ON
Query message:
MTES:OPER?
Response message:
ON
:MTESt:RESet
Command
Command message:
:MTESt:RESet
MTES:RES
:MTESt:SOURce
Command/Query
<source>:= {C<x>|Z<x>}
C denotes an analog input. C1 is analog input channel 1,
for example.
Z denotes a zoomed input. Z1 denotes zoom 1.
Note:
Only Z<x> can be selected when Zoom is on.
<source>:= {C<x>|Z<x>}
EXAMPLE The following command sets the source of the mask test
source as C1.
Command message:
:MTESt:SOURce C1
MTES:SOUR C1
Query message:
MTES:SOUR?
Response message:
C1
:MTESt:TYPE
Command/Query
<type>:= {ALL_IN|ALL_OUT|ANY_IN|ANY_OUT}
EXAMPLE The following command sets the type of the mask test source
as all in.
Command message:
:MTESt:TYPE ALL_IN
MTES:TYPE ALL_IN
Query message:
MTES:TYPE?
Response message:
ALL_IN
RECall Commands
The :RECall subsystem commands control the recall of setups or waveform data to the oscilloscope.
:RECall:FDEFault
:RECall:REFerence
:RECall:SERase
:RECall:SETup
:RECall:FDEFault
Command
Command message:
:RECall:FDEFault
REC:FDEF
:RECall:REFerence
Command
<location>:= {REFA|REFB|REFC|REFD}
REF is the reference waveform name
Note:
The file format is not automatically determined by the file name
extension. You need to choose a file name with an extension
which is consistent with the selected file format.
Command message:
:RECall:REFerence REFD,"U-disk0/SIGLENT/math.ref"
REC:REF REFD,"U-disk0/SIGLENT/math.ref"
:RECall:SERase
Command
DESCRIPTION This command deletes user defined files stored inside the
oscilloscope, includes reference waveforms, internal setups,
internal mask files, custom default setups, the waveform files
copied from analog trace to AWG.
EXAMPLE The following command deletes user defined files stored inside
the oscilloscope.
Command message:
:RECall:SERase
REC:SER
:RECall:SETup
Command
DESCRIPTION This command will recall the saved settings file from internal or
external sources.
<state>:= {INTernal,<num>|EXTernal,<path>}
Note:
• The file format is not automatically determined by the file
name extension. You need to choose a file name with an
extension which is consistent with the selected file format.
• If the storage path type is not specified, it is recall from
U-disk0 by default
EXAMPLE The following command recalls the settings from internal file
“SDS00001.xml”.
Command message:
:RECall:SETup INTernal,1
REC:SET INT,1
Command message:
:RECall:SETup EXTernal,”U-disk0/SIGLENT/default.xml”
REC:SET EXT,”SIGLENT/default.xml”
REF Commands
:REF<r>:LABel
:REF<r>:LABel:TEXT
:REF<r>:DATA
:REF<r>:DATA:SOURce
:REF<r>:DATA:SCALe
:REF<r>:DATA:POSition
:REF<r>:LABel
Command/Query
The query returns the state of the label associated with the
specified reference.
<r>:= {A|B|C|D}
Reference waveform name
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:REFA:LABel ON
REFA:LAB ON
Query message:
REFA:LAB?
Response message:
ON
:REF<r>:LABel:TEXT
Command/Query
DESCRIPTION The command sets the selected REF label to the string that
follows. Setting a label for a REF also adds the name to the
label list in non-volatile memory (replacing the oldest label in
the list).
<r>:= {A|B|C|D}
Reference waveform name
EXAMPLE The following command sets the reference waveform label text
to REFA.
Command message:
:REFA:LABel:TEXT “REFA”
REFA:LAB:TEXT “REFA”
Query message:
REFA:LAB:TEXT?
Response message:
“REFA”
:REF<r>:DATA
Command
<r>:= {A|B|C|D}
Reference waveform name
<operation>:= {LOAD|UNLoad|SAVE,<source>}
LOAD means to call up the reference waveform display.
UNLoad means to turn off the reference waveform display.
SAVE means to save the waveform to the reference
waveform.
<source>:= {C<x>|F<x>|D<n>}
C denotes an analog input channel. For example, C1 is
analog input 1.
F denotes a math function. For example, F1 is math
function 1.
D denotes a digital waveform. For example, D1 denotes
digital input 1.
Command message:
:REFA:DATA LOAD
REFA:DATA LOAD
:REF<r>:DATA:SOURce
Query
DESCRIPTION This query returns the source of the current reference channel.
<r>:= {A|B|C|D}
<source>:= {C<x>|F<x>|D<n>}
C denotes an analog input channel. For example, C1 is
analog input 1.
F denotes a math function. For example, F1 is math function
1.
D denotes a digital waveform. For example, D1 denotes
digital input 1.
Query message:
REFA:DATA:SOUR?
Response message:
C1
:REF<r>:DATA:SCALe
Command/Query
DESCRIPTION The command sets the vertical scale of the current reference
channel. This command is only used when the current reference
channel has been stored, and the display state is on.
<r>:= {A|B|C|D}
Reference waveform name
Note:
The scale range of the reference waveform is the same as that of
the reference source.
EXAMPLE When the Reference function is on, and REFA has been saved,
the following command sets the vertical scale of REFA to 100
mV.
Command message:
:REFA:DATA:SCALe 1.00E-01
REFA:DATA:SCAL 1.00E-01
Query message:
REFA:DATA:SCAL?
Response message:
1.00E-01
:REF<r>:DATA:POSition
Command/Query
DESCRIPTION The command sets the vertical offset of the current reference
channel. This command is only used when the current reference
channel has been saved, and the display state is on.
<r>:= {A|B|C|D}
Reference channel name
Note:
The position range of the reference waveform is the same as that
of the reference source.
EXAMPLE When the Reference function is on, REFB has been saved and
the scale is 2 V, the following command sets the current
reference channel vertical offset to 0.2 V.
Command message:
:REFA:DATA:POSition 2.00E-01
REFA:DATA:POS 2.00E-01
Query message:
REFA:DATA:POS?
Response message:
2.00E-01
SAVE Commands
The SAVE subsystem commands control to save oscilloscope setups and waveform data to internal
or external memory locations.
:SAVE:BINary
:SAVE:CSV
:SAVE:DEFault
:SAVE:IMAGe
:SAVE:MATLab
:SAVE:REFerence
:SAVE:SETup
:SAVE:BINary
Command
DESCRIPTION This command saves the binary data of the channel displayed
on the screen to an external USB memory device.
<src>:= {C<x>|F<x>|M<x>|D0_D15}
C denotes an analog input channel. For example, C1 is
analog input 1.
F denotes a math function. For example, F1 is math
function 1.
M denotes a memory trace. For example, M1 is memory 1.
D0_D15 denotes a digital waveform. Data display by bit.
Note:
• When save to internal, the default path is local.
• When save to external, if the path type is not set, it is
stored to u-disk0 by default
• The file format is not automatically determined by the file
name extension. You need to choose a file name with an
extension which is consistent with the selected file format.
• If the parameter <src> is not specified, the command is
invalid.
Command message:
:SAVE:BINary "U-disk0/Siglent/c1.bin",C1
SAVE:BIN "U-disk0/Siglent/c1.bin",C1
:SAVE:CSV
Command
<source>:= {C<x>|F<x>|M<x>|D0_D15|DIGital}
C denotes an analog input channel. For example, C1 is
analog input 1.
F denotes a math function. For example, F1 is math
function 1.
M denotes a memory trace. For example, M1 is memory 1.
D0_D15 denotes a digital waveform. Data display by bit.
DIGital denotes a digital waveform. Data display by bus.
<state>:= {OFF|ON}
ON enables parameter save. This adds vertical scale
values, horizontal timebase settings, and more instrument
configuration information to the file.
OFF means to disables parameter save.
Note:
• When save to internal, the default path is local.
• When save to external, if the path type is not set, it is
stored to u-disk0 by default
• The file format is not automatically determined by the file
name extension. You need to choose a file name with an
extension which is consistent with the selected file format.
Command message:
:SAVE:CSV "local/SIGLENT/channel1.csv",C1,ON
:SAVE:DEFault
Command
<set>:= {CUSTom|FACTory}
CUSTom means the current settings.
FACTory means factory settings.
Command message:
:SAVE:DEFault CUSTom
SAVE:DEF CUST
:SAVE:IMAGe
Command
<type>:= {BMP|JPG|PNG}
<invert>:= {OFF|ON}}
ON will store images that have inverted colors. This means
that a normally black background will be white when
inverted. This setting is recommended if you plan on
printing the image as an inverted image with a white
background will save on ink.
OFF will store images that are identical to the display of
the instrument.
Note:
• When save to internal, the default path is local.
• When save to external, if the path type is not set, it is
stored to u-disk0 by default
• The file format is not automatically determined by the file
name extension. You need to choose a file name with an
extension which is consistent with the selected file format.
Command message:
:SAVE:IMAGe “U-disk0/SIGLENT/screen.bmp”,BMP,ON
SAVE:IMAG “U-disk0/SIGLENT/screen.bmp",BMP,ON
:SAVE:MATLab
Command
<source>:= {C<x>|F<x>|M<x>|D0_D15|DIGital}
C denotes an analog input channel. For example, C1 is
analog input 1.
F denotes a math function. For example, F1 is math
function 1.
M denotes a memory trace. For example, M1 is memory 1.
D0_D15 denotes a digital waveform. Data display by bit.
DIGital denotes a digital waveform. Data display by bus.
Note:
• When save to internal, the default path is local.
• When save to external, if the path type is not set, it is
stored to u-disk0 by default
• The file format is not automatically determined by the file
name extension. You need to choose a file name with an
extension which is consistent with the selected file format.
Command message:
:SAVE:MATLab "U-disk0/SIGLENT/channel.mat",C1
SAVE:MATL "U-disk0/SIGLENT/channel.mat",C1
:SAVE:REFerence
Command
<source>:= {C<x>|F<x>|D<n>}
C denotes an analog input channel. For example, C1 is
analog input 1.
F denotes a math function. For example, F1 is math
function 1.
D denotes a digital waveform. For example, D1 denotes
digital input 1.
Note:
The file format is not automatically determined by the file name
extension. You need to choose a file name with an extension
which is consistent with the selected file format.
Command message:
:SAVE:REFerence "local/SIGLENT/channel.ref",C1
SAVE:REF "local/SIGLENT/channel.ref",C1
:SAVE:SETup
Command
<setup_num>:= {INTernal,<num>|EXTernal,<path>}
Note:
• When save to internal, the default path is local. And the
setup file will be stored in local with the name
"SDS000x.xml"
• When save to external, if the path type is not set, it is
stored to u-disk0 by default
• The file format is not automatically determined by the file
name extension. You need to choose a file name with an
extension which is consistent with the selected file format.
EXAMPLE There are two ways to save the current settings to internal file
“SDS00001.xml”.
Command message:
:SAVE:SETup INTernal,1
SAVE:SET INT,1
:SAVE:SETup EXTernal,”local/SDS00001.xml”
:SAVE:SET EXT,”local/SDS00001.xml”
SEARch Commands
The :SEARch subsystem commands control the search functions of the oscilloscope.
:SEARch
:SEARch:MODE
:SEARch:COUNt
:SEARch:EVENt
:SEARch:COPY
:SEARch:EDGE: Commands
:SEARch:SLOPe Commands
:SEARch:PULSe Commands
:SEARch:INTerval Commands
:SEARch:RUNT Commands
:SEARch
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:SEARch ON
SEAR ON
Query message:
SEAR?
Response message:
ON
:SEARch:MODE
Command/Query
<mode>:= {EDGE|SLOPe|PULSE|INTerval|RUNT}
<mode>:= {EDGE|SLOPe|PULSE|INTerval|RUNT}
Command message:
:SEARch:MODE EDGE
SEAR:MODE EDGE
Query message:
SEAR:MODE?
Command message:
EDGE
:SEARch:COUNt
Query
DESCRIPTION The query returns the total number of search events in the
current screen.
EXAMPLE The following query returns the number of search events in the
current screen.
Query message:
SEARch:COUNt?
SEAR:COUN?
Response message:
10
:SEARch:EVENt
Query
DESCRIPTION The query returns the index of the search event in the center of
the screen when the oscilloscope acquisition is stopped.
Query message:
SEARch:EVENt?
SEAR:EVEN?
Response message:
5
:SEARch:COPY
Command
<operation>:= {FROMtrigger|TOTRigger|CANCel}
FROMtrigger means copy trigger settings to search.
TOTRigger means copy search settings to trigger.
CANCel can undo the above two copying operations.
Command message:
:SEARch:COPY FROMtrigger
SEAR:COPY FROM
:SEARch:EDGE Commands
:SEARch:EDGE:SOURce
:SEARch:EDGE:SLOPe
:SEARch:EDGE:LEVel
:SEARch:EDGE:SOURce
Command/Query
DESCRIPTION The command sets the search source of the edge search.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the search source of the edge
search as C1.
Command message:
:SEARch:EDGE:SOURce C1
SEAR:EDGE:SOUR C1
Query message:
SEAR:EDGE:SOUR?
Response message:
C1
:SEARch:EDGE:SLOPe
Command/Query
The query returns the current slope setting of the edge search.
<slope_type>:= {RISing|FALLing|ALTernate}
<slope_type>:= {RISing|FALLing|ALTernate}
EXAMPLE The following command set the rising slope to the edge search.
Command message:
:SEARch:EDGE:SLOPe RISing
SEAR:EDGE:SLOP RIS
Query message:
SEAR:EDGE:SLOP?
Response message:
RISing
:SEARch:EDGE:LEVel
Command/Query
DESCRIPTION The command sets the search level of the edge search.
The query returns the current search level value of the edge
search.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the search level of the edge
search to 0.5 V.
Command message:
:SEARch:EDGE:LEVel 5.00E-01
SEAR:EDGE:LEV 5.00E-01
Query message:
SEAR:EDGE:LEV?
Response message:
5.00E-01
:SEARch:SLOPe Commands
:SEARch:SLOPe:SOURce
:SEARch:SLOPe:SLOPe
:SEARch:SLOPe:HLEVel
:SEARch:SLOPe:LLEVel
:SEARch:SLOPe:LIMit
:SEARch:SLOPe:TUPPer
:SEARch:SLOPe:TLOWer
:SEARch:SLOPe:SOURce
Command/Query
DESCRIPTION The command sets the search source of the slope search.
<source>:= {C<x>}
<source>:= {C<x>}
EXAMPLE The following command sets the search source of the slope
search to C2 (channel 2).
Command message:
:SEARch:SLOPe:SOURce C2
SEAR:SLOP:SOUR C2
Query message:
SEAR:SLOP:SOUR?
Response message:
C2
:SEARch:SLOPe:SLOPe
Command/Query
<slope_type>:= {RISing|FALLing|ALTernate}
<slope_type>:= {RISing|FALLing|ALTernate}
EXAMPLE The following command sets the rising slope of the slope
search.
Command message:
:SEARch:SLOPe:SLOPe RISing
SEAR:SLOP:SLOP RIS
Query message:
SEAR:SLOP:SLOP?
Response message:
RISing
:SEARch:SLOPe:HLEVel
Command/Query
DESCRIPTION The command sets the high level of the slope search.
The query returns the current high level of the slope search.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The high level value cannot be less than the low level value
using by the command :SEARch:SLOPe:LLEVel.
EXAMPLE The following command sets the high level of the slope search
to 0.5 V.
Command message:
:SEARch:SLOPe:HLEVel 5.00E-01
SEAR:SLOP:HLEV 5.00E-01
Query message:
SEAR:SLOP:HLEV?
Response message:
5.00E-01
:SEARch:SLOPe:LLEVel
Command/Query
DESCRIPTION The command sets the low level of the slope search.
The query returns the current low level of the slope search.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The low level value cannot be greater than the low level value
using by the command :SEARch:SLOPe:HLEVel.
EXAMPLE The following command sets the low level of the slope search
to -0.5 V.
Command message:
:SEARch:SLOPe:LLEVel -5.00E-01
SEAR:SLOP:LLEV -5.00E-01
Query message:
SEAR:SLOP:LLEV?
Response message:
-5.00E-01
:SEARch:SLOPe:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the slope search.
The query returns the current limit range type of the slope
search.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the limit of the slope search to
LESSthan.
Command message:
:SEARch:SLOPe:LIMit LESSthan
SEAR:SIOP:LIM LESS
Query message:
SEAR:SIOP:LIM?
Response message:
LESSthan
:SEARch:SLOPe:TUPPer
Command/Query
DESCRIPTION The command sets the upper value of the slope search limit
type.
The query returns the current upper value of the slope search
limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :SEARch:SLOPe:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the upper value of the slope
search to 30 ns, when the limit range type is OUTer.
Command message:
:SEARch:SLOPe:TUPPer 3.00E-08
SEAR:SLOP:TUPP 3.00E-08
Query message:
SEAR:SLOP:TUPP?
Response message:
3.00E-08
:SEARch:SLOPe:TLOWer
Command/Query
DESCRIPTION The command sets the lower value of the slope search limit
type.
The query returns the current lower value of the slope search
limit type.
Note:
• The lower value cannot be greater than the upper value
using by the command :SEARch:SLOPe:TUPPer.
• The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the lower time of the slope search
to 10 ns.
Command message:
:SEARch:SLOPe:TLOWer 1.00E-08
SEAR:SLOP:TLOW 1.00E-08
Query message:
SEAR:SLOP:TLOW?
Response message:
1.00E-08
:SEARch:PULSe Commands
:SEARch:PULSe:SOURce
:SEARch:PULSe:POLarity
:SEARch:PULSe:LEVel
:SEARch:PULSe:LIMit
:SEARch:PULSe:TUPPer
:SEARch:PULSe:TLOWer
:SEARch:PULSe:SOURce
Command/Query
DESCRIPTION The command sets the search source of the pulse search.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the polarity of the pulse search as
channel 2.
Command message:
:SEARch:PULSe:SOURce C2
SEAR:PULS:SOUR C2
Query message:
SEAR:PULS:SOUR?
Response message:
C2
:SEARch:PULSe:POLarity
Command/Query
<polarity_type>:= {POSitive|NEGative}
<polarity_type>:= {POSitive|NEGative}
EXAMPLE The following command sets the polarity of the pulse search to
POSitive.
Command message:
:SEARch:PULSe:POLarity POSitive
SEAR:PULS:POL POS
Query message:
SEAR:PULS:POL?
Response message:
POSitive
:SEARch:PULSe:LEVel
Command/Query
DESCRIPTION The command sets the search level of the pulse search.
The query returns the current search level of the pulse search.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the search level of the pulse
search to 0.5 V.
Command message:
:SEARch:PULSe:LEVel 5.00E-01
SEAR:PULS:LEV 5.00E-01
Query message:
SEAR:PULS:LEV?
Response message:
5.00E-01
:SEARch:PULSe:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the pulse search.
The query returns the current limit range type of the pulse
search.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the search limit of the pulse
search to inner.
Command message:
:SEARch:PULSe:LIMit INNer
SEAR:PULS:LIM INN
Query message:
SEAR:PULS:LIM?
Response message:
INNer
:SEARch:PULSe:TUPPer
Command/Query
DESCRIPTION The command sets the upper value of the pulse search limit
type.
The query returns the current upper value of the pulse search
limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :SEARch:PULse:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the upper time of the pulse search
to 30 ns.
Command message:
:SEARch:PULSe:TUPPer 3.00E-08
SEAR:PULS:TUPP 3.00E-08
Query message:
SEAR:PULS:TUPP?
Response message:
3.00E-08
:SEARch:PULSe:TLOWer
Command/Query
DESCRIPTION The command sets the lower value of the pulse search limit
type.
The query returns the current lower value of the pulse search
limit type.
Note:
• The lower value cannot be greater than the upper value
using by the command :SEARch:PULSe:TUPPer.
• The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the lower time of the pulse search
to 10 ns.
Command message:
:SEARch:PULSe:TLOWer 1.00E-08
SEAR:PULS:TLOW 1.00E-08
Query message:
SEAR:PULS:TLOW?
Response message:
1.00E-08
:SEARch:INTerval Commands
:SEARch:INTerval:SOURce
:SEARch:INTerval:SLOPe
:SEARch:INTerval:LEVel
:SEARch:INTerval:LIMit
:SEARch:INTerval:TUPPer
:SEARch:INTerval:TLOWer
:SEARch:INTerval:SOURce
Command/Query
DESCRIPTION The command sets the search source of the interval search.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the search source of the interval
search as channel 1.
Command message:
:SEARch:INTerval:SOURce C1
SEAR:INT:SOUR C1
Query message:
SEAR:INT:SOUR?
Response message:
C1
:SEARch:INTerval:SLOPe
Command/Query
<slope_type>:= {RISing|FALLing}
<slope_type>:= {RISing|FALLing}
EXAMPLE The following command sets the rising slope of the interval
search.
Command message:
:SEARch:INTerval:SLOPe RISing
SEAR:INT:SLOP RIS
Query message:
SEAR:INT:SLOP?
Response message:
RISing
:SEARch:INTerval:LEVel
Command/Query
DESCRIPTION The command sets the search level of the interval search.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the search level of the interval
search to 0.5 V.
Command message:
:SEARch:INTerval:LEVel 5.00E-01
SEARr:INT:LEV 5.00E-01
Query message:
SEAR:INT:LEV?
Response message:
5.00E-01
:SEARch:INTerval:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the interval search.
The query returns the current limit range type of the interval
search.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the limit of the interval search to
LESSthan.
Command message:
:SEARch:INTerval:LIMit LESSthan
SEAR:INT:LIM LESS
Query message:
SEAR:INT:LIM?
Response message:
LESSthan
:SEARch:INTerval:TUPPer
Command/Query
DESCRIPTION The command sets the upper value of the interval search limit
type.
The query returns the current upper value of the interval search
limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :SEARch:INTerval:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the time upper value of the
interval search to 30 ns.
Command message:
:SEARch:INTerval:TUPPer 3.00E-08
SEAR:INT:TUPP 3.00E-08
Query message:
SEAR:INT:TUPP?
Response message:
3.00E-08
:SEARch:INTerval:TLOWer
Command/Query
DESCRIPTION The command sets the lower value of the interval search limit
type.
The query returns the current lower value of the interval search
limit type.
Note:
• The lower value cannot be greater than the upper value
using by the command :SEARch:INTerval:TUPPer.
• The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the time lower value of the interval
search to 10 ns.
Command message:
:SEARch:INTerval:TLOWer 1.00E-08
SEAR:INT:TLOW 1.00E-08
Query message:
SEAR:INT:TLOW?
Response message:
1.00E-08
:SEARch:RUNT Commands
:SEARch:RUNT:SOURce
:SEARch:RUNT:POLarity
:SEARch:RUNT:HLEVel
:SEARch:RUNT:LLEVel
:SEARch:RUNT:LIMit
:SEARch:RUNT:TUPPer
:SEARch:RUNT:TLOWer
:SEARch:RUNT:SOURce
Command/Query
DESCRIPTION The command sets the search source of the runt search.
The query returns the current search source of the runt search.
<source>:= {C<x>}
<source>:= {C<x>}
EXAMPLE The following command sets the search source of the runt
search to channel 2
Command message:
:SEARch:RUNT:SOURce C2
SEAR:RUNT:SOUR C2
Query message:
SEAR:RUNT:SOUR?
Response message:
C2
:SEARch:RUNT:POLarity
Command/Query
<polarity_type>:= {POSitive|NEGative}
<polarity_type>:= {POSitive|NEGative}
EXAMPLE The following command sets the polarity of the runt search to
POSitive.
Command message:
:SEARch:RUNT:POLarity POSitive
SEAR:RUNT:POL POS
Query message:
SEAR:RUNT:POL?
Response message:
POSitive
:SEARch:RUNT:HLEVel
Command/Query
DESCRIPTION The command sets the high search level of the runt search.
The query returns the current high search level of the runt
search.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The high level value cannot be less than the low level value
using by the command :SEARch:RUNT:LLEVel.
EXAMPLE The following command sets the high search level of the runt
search to 0.5 V.
Command message:
:SEARch:RUNT:HLEVel 5.00E-01
SEAR:RUNT:HLEV 5.00E-01
Query message:
SEAR:RUNT:HLEV?
Response message:
5.00E-01
:SEARch:RUNT:LLEVel
Command/Query
DESCRIPTION The command sets the low search level of the runt search.
The query returns the current low search level of the runt search.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset,
SDS6000L 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The low level value cannot be greater than the high level value
using by the command :SEARch:RUNT:HLEVel.
EXAMPLE The following command sets the low search level of the runt
search to -0.5 V.
Command message:
:SEARch:RUNT:LLEVel - 5.00E-01
SEAR:RUNT:LLEV - 5.00E-01
Query message:
SEAR:RUNT:LLEV?
Response message:
-5.00E-01
:SEARch:RUNT:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the runt search.
The query returns the current limit range type of the runt
search.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the limit of the runt search to
LESSthan.
Command message:
:SEARch:RUNT:LIMit LESSthan
SEAR:RUNT:LIM LESS
Query message:
SEAR:RUNT:LIM?
Response message:
LESSthan
:SEARch:RUNT:TUPPer
Command/Query
DESCRIPTION The command sets the upper value of the runt search limit
type.
The query returns the current upper value of the runt search
limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :SEARch:RUNT:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the upper time of the runt search
to 30 ns.
Command message:
:SEARch:RUNT:TUPPer 3.00E-08
SEAR:RUNT:TUPP 3.00E-08
Query message:
SEAR:RUNT:TUPP?
Response message:
3.00E-08
:SEARch:RUNT:TLOWer
Command/Query
DESCRIPTION The command sets the lower value of the runt search limit type.
The query returns the current lower value of the runt search
limit type.
Note:
• The lower value cannot be greater than the upper value
using by the command :SEARch:RUNT:TUPPer.
• The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the lower time of the runt search
to 10 ns.
Command message:
:SEARch:RUNT:TLOWer 1.00E-08
SEAR:RUNT:TLOW 1.00E-08
Query message:
SEAR:RUNT:TLOW?
Response message:
1.00E-08
SYSTem Commands
The :SYSTem subsystem commands control the basic system functions of the oscilloscope.
:SYSTem:BUZZer
:SYSTem:CLOCk
:SYSTem:COMMunicate:LAN:GATeway
:SYSTem:COMMunicate:LAN:IPADdress
:SYSTem:COMMunicate:LAN:MAC
:SYSTem:COMMunicate:LAN:SMASk
:SYSTem:COMMunicate:LAN:TYPE
:SYSTem:COMMunicate:VNCPort
:SYSTem:DATE
:SYSTem:EDUMode
:SYSTem:MENU
:SYSTem:NSTorage
:SYSTem:NSTorage:CONNect
:SYSTem:NSTorage:DISConnect
:SYSTem:NSTorage:STATus
:SYSTem:PON
:SYSTem:REBoot
:SYSTem:REMote
:SYSTem:SELFCal
:SYSTem:SHUTdown
:SYSTem:SSAVer
:SYSTem:TIME
:SYSTem:TOUCh
:SYSTem:BUZZer
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:SYSTem:BUZZer ON
SYST:BUZZ ON
Query message:
SYST:BUZZ?
Response message:
ON
:SYSTem:CLOCk
Command/Query
DESCRIPTION The command sets the oscilloscope clock source and the state
of the 10 MHz clock output.
<source>:= {EXT|IN_ON|IN_OFF}
EXT selects the external clock source. The 10 MHz output
will be automatically disabled.
IN_ON selects the internal clock source and enables the
10 MHz output.
IN_OFF selects the internal clock source and disables the
10M output.
<source>:= {EXT|IN_ON|IN_OFF}
Command message:
:SYSTem:CLOCk IN_ON
SYST:CLOC IN_ON
Query message:
SYST:CLOC?
Response message:
IN_ON
:SYSTem:COMMunicate:LAN:GATeway
Command/Query
Command message:
:SYSTem:COMMunicate:GATeway "10.12.0.1"
SYST:COMM:LAN:GAT "10.12.0.1"
Query message:
SYST:COMM:LAN:GAT?
Response message:
"10.12.0.1"
:SYSTem:COMMunicate:LAN:IPADdress
Command/Query
Command message:
:SYSTem:COMMunicate:IPADdress "10.12.255.229"
SYST:COMM:LAN:IPAD "10.12.255.229"
Query message:
SYST:COMM:LAN:IPAD?
Response message:
"10.12.255.229"
:SYSTem:COMMunicate:LAN:MAC
Query
Query message:
SYST:COMM:LAN:MAC?
Response message:
00:01:D2:0C:00:A0
:SYSTem:COMMunicate:LAN:SMASk
Command/Query
Command message:
:SYSTem:COMMunicate:SMASk "255.255.0.0"
SYST:COMM:LAN:SMAS "255.255.0.0"
Query message:
SYST:COMM:LAN:SMAS?
Response message:
"255.255.0.0"
:SYSTem:COMMunicate:LAN:TYPE
Command/Query
<state>:= {STATIC|DHCP}
STATIC means that the Ethernet settings will be configured
manually, using
commands :SYSTem:COMMunicate:LAN:IPADdress, :SY
STem:COMMunicate:LAN:SMASK,
and :SYSTem:COMMunicate:LAN:GATeway
DHCP means that the oscilloscope’s IP address, subnet
mask and gateway settings will be received from a DHCP
server on the local network.
<state>:= {STATIC|DHCP}
EXAMPLE The following command sets the type of the LAN configuration
to DHCP.
Command message:
:SYSTem:COMMunicate:LAN:TYPE DHCP
SYST:COMM:LAN:TYPE DHCP
Query message:
SYST:COMM:LAN:TYPE?
Response message:
DHCP
:SYSTem:COMMunicate:VNCPort
Command/Query
Command message:
:SYSTem:COMMunicate:VNVPort 5903
SYST:COMM:VNCP 5903
Query message:
SYST:COMM:VNCP?
Response message:
5903
:SYSTem:DATE
Command/Query
Command message:
:SYSTem:DATE 20191220
SYST:DATE 20190819
Query message:
SYST:DATE?
Response message:
20190819
:SYSTem:EDUMode
Command/Query
<func>:= {AUTOSet|MEASure|CURSor}
<lock>:= {ON|OFF}
ON means the enable the function.
OFF means disable the function.
Note:
The query without parameters will return the lock status of all
functions.
Format 2:
<lock>
<lock>:= {ON|OFF}
Command message:
:SYSTem:EDUMode AUTOSet,OFF
SYST:EDUM AUTOS,OFF
Query message:
SYST:EDUM? AUTOS
Response message:
OFF
:SYSTem:LANGuage
Command/Query
<language>:=
{SCHinese|TCHinese|ENGLish|FRENch|JAPanese|KORean|D
EUTsch|ESPan|RUSSian|ITALiana|PORTuguese}
<language>:=
{SCHinese|TCHinese|ENGLish|FRENch|JAPanese|KORean|D
EUTsch|ESPan|RUSSian|ITALiana|PORTuguese}
Command message:
:SYSTem:LANGuage ENGLish
SYST:LANG ENGL
Query message:
SYST:LANG?
Response message:
ENGLish
:SYSTem:MENU
Command/Query
Note:
This command is only valid for models with the menu switch.
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:SYSTem:MENU ON
SYST:MENU ON
Query message:
SYST:MENU?
Response message:
ON
:SYSTem:NSTorage
Command/Query
Note:
For security, the password is always returned “***”.
Command message:
:SYSTem:NSTorage "//10.12.255.239/nfs","","",0,0,1,0,0
SYST:NST "//10.12.255.239/nfs","","",0,0,1,0,0
Query message:
SYST:NST?
Response message:
"//10.12.255.239/nfs","","***",0,0,1,0,0
:SYSTem:NSTorage:CONNect
Command
Command message:
:SYSTem:NSTorage:CONNect
SYST:NST:CONN
:SYSTem:NSTorage:DISConnect
Command
Command message:
:SYSTem:NSTorage:DISConnect
SYST:NST:DISC
:SYSTem:NSTorage:STATus
Query
<status>:= {ON|OFF}.
EXAMPLE The following query returns the mount status of network drive.
Query message:
SYST:NST:STAT?
Response message:
OFF
:SYSTem:PON
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:SYSTem:PON ON
SYST:PON ON
Query message:
SYST:PON?
Response message:
ON
:SYSTem:REBoot
Command
Command message:
:SYSTem:REBoot
SYST:REB
:SYSTem:REMote
Command/Query
DESCRIPTION The command sets the status of the remote control. When the
remote control is turned on, the touch screen, the front panel
and the touch screen, front panel and peripheral will be locked,
and there will be a remote prompt on the screen.
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:SYSTem:REMote ON
SYST:REM ON
Query message:
SYST:REM?
Response message:
ON
:SYSTem:SELFCal
Command/Query
<state>:= {DOING|DONE}
Command message:
:SYSTem:SELFCal
SYST:SELFC
Query message:
SYST:SELFC?
Response message:
DONE
:SYSTem:SHUTdown
Command
Command message:
:SYSTem:SHUTdown
SYST:SHUT
:SYSTem:SSAVer
Command/Query
<time>:= {OFF|1MIN|5MIN|10MIN|30MIN|60MIN}
<time>:= {OFF|1MIN|5MIN|10MIN|30MIN|60MIN}
Command message:
:SYSTem:SSAVer 10MIN
SYST:SSAV 10MIN
Query message:
SYST:SSAV?
Response message:
10MIN
:SYSTem:TIME
Command/Query
Command message:
:SYSTem:TIME 081040
SYST:TIME 081040
Query message:
SYST:TIME?
Response message:
081040
:SYSTem:TOUCh
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:SYSTem:TOUCh ON
SYST:TOUC ON
Query message:
SYST:TOUC?
Response message:
ON
TIMebase Commands
The :TIMEBASE subsystem commands control the horizontal (X-axis) functions. The time per
division, delay, and reference can be controlled for the main and window (zoomed) time bases.
:TIMebase:DELay
:TIMebase:REFerence
:TIMebase:REFerence:POSition
:TIMebase:SCALe
:TIMebase:WINDow
:TIMebase:WINDow:DELay
:TIMebase:WINDow:SCALe
:TIMebase:DELay
Command/Query
DESCRIPTION The command specifies the main timebase delay. This delay is
the time between the trigger event and the delay reference
point on the screen.
Command message:
:TIMebase:DELay 1.00E-05
TIM:DEL 1.00E-05
Query message:
TIM:DEL?
Response message:
1.00E-05
:TIMebase:REFerence
Command/Query
DESCRIPTION The command sets the strategy for the delay value change in
the horizontal direction when the horizontal scale is changed.
<type>:= {DELay|POSition}
DELay means when the time base is changed, the
horizontal delay value remains fixed. As the horizontal
timebase scale is changed, the waveform
expands/contracts around the center of the display.
POSition means When the time base is changed, the
horizontal delay remains fixed to the grid position on the
display. As the horizontal time base scale is changed, the
waveform expands/contracts around the position of the
horizontal display.
<type>:= {DELay|POSition}
Command message:
:TIMebase:REFerence DELay
TIM:REF DEL
Query message:
TIM:REF?
Response message:
DELay
:TIMebase:REFerence:POSition
Command/Query
DESCRIPTION The command sets the horizontal reference center when the
reference strategy is DELay.
Command message:
:TIMebase:REFerence:POSition 20
TIM:REF:POS 20
Query message:
TIM:REF:POS?
Response message:
20
:TIMebase:SCALe
Command/Query
DESCRIPTION The command sets the horizontal scale per division for the
main window.
Note:
Due to the limitation of the expansion strategy, when the time
base is set from large to small, it will automatically adjust to the
minimum time base that can be set currently.
Note:
The range of value varies from the models. See the datasheet
for details.
EXAMPLE The following command sets the horizontal scale to 100 ns/div.
Command message:
:TIMebase:SCALe 1.00E-07
TIM:SCAL 1.00E-07
Query message:
TIM:SCAL?
Response message:
1.00E-07
:TIMebase:WINDow
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
Command message:
:TIMebase:WINDow ON
TIM:WIND ON
Query message:
TIM:WIND?
Response message:
ON
:TIMebase:WINDow:DELay
Command/Query
DESCRIPTION The command sets the horizontal position in the zoomed view
of the main sweep.
The query returns the current delay value between the zoomed
window and the main sweep.
Note:
• The main sweep range and the main sweep horizontal
position determine the range for the delay value of the
zoomed window. It must keep the zoomed view window
within the main sweep range.
• If you set the delay to a value outside of the legal range,
the delay value is automatically set to the nearest legal
value.
Command message:
:TIMebase:WINDow:DELay 1.00E-03
TIM:WIND:DEL 1.00E-03
Query message:
TIM:WIND:DEL?
Response message:
1.00E-03
:TIMebase:WINDow:SCALe
Command/Query
Note:
The scale of the zoomed window cannot be greater than that of
the main window. If you set the value greater than, it will
automatically be set to the same value as the main window.
EXAMPLE The following command sets a 1 ms/div horizontal scale for the
zoomed window.
Command message:
:TIMebase:WINDow:SCALe 1.00E-03
TIM:WIND:SCAL 1.00E-03
Query message:
TIM:WIND:SCAL?
Response message:
1.00E-03
TRIGger Commands
The :TRIGGER subsystem commands control the trigger modes and parameters for each trigger
type.
:TRIGger:FREQuency
:TRIGger:MODE
:TRIGger:RUN
:TRIGger:STATus
:TRIGger:STOP
:TRIGger:TYPE
:TRIGger:EDGE Commands
:TRIGger:SLOPe Commands
:TRIGger:PULSe Commands
:TRIGger:VIDeo Commands
:TRIGger:WINDow Commands
:TRIGger:INTerval Commands
:TRIGger:DROPout Commands
:TRIGger:PATTern Commands
:TRIGger:QUALified Commands
:TRIGger:DELay Commands
:TRIGger:NEDGe Commands
:TRIGger:DELay Commands
:TRIGger:SHOLd Commands
:TRIGger:IIC Commands
:TRIGger:SPI Commands
:TRIGger:UART Commands
:TRIGger:CAN Commands
:TRIGger:LIN Commands
:TRIGger:FREQuency
Query
Command message:
:FORMat:DATA CUSTom,7
TRIG:FREQ?
Response message:
1.234561E+04
:TRIGger:MODE
Command/Query
<mode>:= {SINGle|NORMal|AUTO|FTRIG}
AUTO: The oscilloscope begins to search for the trigger
signal that meets the conditions. If the trigger signal is
satisfied, the running state on the top left corner of the user
interface shows Trig'd, and the interface shows stable
waveform. Otherwise, the running state always shows
Auto, and the interface shows unstable waveform.
NORMal: The oscilloscope enters the wait trigger state
and begins to search for trigger signals that meet the
conditions. If the trigger signal is satisfied, the running
state shows Trig'd, and the interface shows stable
waveform. Otherwise, the running state shows Ready, and
the interface displays the last triggered waveform
(previous trigger) or does not display the waveform (no
previous trigger).
SINGle: The backlight of SINGLE key lights up, the
oscilloscope enters the waiting trigger state and begins to
search for the trigger signal that meets the conditions. If
the trigger signal is satisfied, the running state shows
Trig'd, and the interface shows stable waveform. Then, the
oscilloscope stops scanning, the RUN/STOP key becomes
red, and the running status shows Stop. Otherwise, the
running state shows Ready, and the interface does not
display the waveform.
FTRIG: Force to acquire a frame regardless of whether the
input signal meets the trigger conditions or not.
<mode>:= {SINGle|NORMal|AUTO|FTRIG}
Command message:
:TRIGger:MODE SINGle
TRIG:MODE SING
Query message:
TRIG:MODE?
Response message:
SINGle
:TRIGger:RUN
Command
Command message:
:TRIGger:RUN
TRIG:RUN
:TRIGger:STATus
Query
DESCRIPTION The command query returns the current state of the trigger.
<status>:= {Arm|Ready|Auto|Trig'd|Stop|Roll}
Query message:
TRIG:STAT?
Response message:
Stop
:TRIGger:STOP
Command
Command message:
:TRIGger:STOP
TRIG:STOP
:TRIGger:TYPE
Command/Query
<type>:= {EDGE|PULSE|SLOPe|INTerval|PATTern|RUNT|
WINDow|DROPout|VIDeo|QUALified|NTHEdge|DELay|SETup
hold|IIC|SPI|UART|LIN|CAN|FLEXray|CANFd|IIS|1553B|SENT
}
<type>:= {EDGE|PULSE|SLOPe|INTerval|PATTern|RUNT|
WINDow|DROPout|VIDeo|QUALified|NTHEdge|DELay|SETup
hold|IIC|SPI|UART|LIN|CAN|FLEXray|CANFd|IIS|1553B|SENT
}
EXAMPLE The following command sets the type of trigger to edge trigger.
Command message:
:TRIGger:TYPE EDGE
TRIG:TYPE EDGE
Query message:
TRIG:TYPE?
Command message:
EDGE
:TRIGger:EDGE Commands
:TRIGger:EDGE:COUPling
:TRIGger:EDGE:HLDEVent
:TRIGger:EDGE:HLDTime
:TRIGger:EDGE:HOLDoff
:TRIGger:EDGE:HSTart
:TRIGger:EDGE:IMPedance
:TRIGger:EDGE:LEVel
:TRIGger:EDGE:NREJect
:TRIGger:EDGE:SLOPe
:TRIGger:EDGE:SOURce
:TRIGger:EDGE:COUPling
Command/Query
DESCRIPTION The command sets the coupling mode of the edge trigger.
<mode>:= {DC|AC|LFREJect|HFREJect}
DC coupling allows dc and ac signals into the trigger path.
AC coupling places a high-pass filter in the trigger path,
removing dc offset voltage from the trigger waveform. Use
AC coupling to get a stable edge trigger when your
waveform has a large dc offset.
HFREJect which is a high-frequency rejection filter that
adds a low-pass filter in the trigger path to remove
high-frequency components from the trigger waveform.
Use the high-frequency rejection filter to remove
high-frequency noise, such as AM or FM broadcast
stations, from the trigger path.
LFREJect which is a low frequency rejection filter adds a
high-pass filter in series with the trigger waveform to
remove any unwanted low-frequency components from a
trigger waveform, such as power line frequencies, that can
interfere with proper triggering.
<mode>:= {DC|AC|LFREJect|HFREJect}
EXAMPLE The following command sets the coupling mode of the edge
trigger to DC.
Command message:
:TRIGger:EDGE:COUPling DC
TRIG:EDGE:COUP DC
Query message:
TRIG:EDGE:COUP?
Response message:
DC
:TRIGger:EDGE:HLDEVent
Command/Query
DESCRIPTION This command sets the number of holdoff events of the edge
trigger.
Command message:
:TRIGger:EDGE:HLDEVent 3
TRIG:EDGE:HLDEV 3
Query message:
TRIG:EDGE:HLDEV?
Response message:
3
:TRIGger:EDGE:HLDTime
Command/Query
DESCRIPTION The command sets the holdoff time of the edge trigger.
The query returns the current holdoff time of the edge trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS5000X
SDS2000X Plus
SDS6000 Pro
[8.00E-09, 3.00E+01]
SDS6000A
SDS6000L
SDS2000X HD
SHS800X/SHS1000X [80.00E-09, 1.5E+00]
EXAMPLE The following command sets the holdoff time of the edge
trigger to 15 ns.
Command message:
:TRIGger:EDGE:HLDTime 1.50E-08
TRIG:EDGE:HLDT 1.50E-08
Query message:
TRIG:EDGE:HLDT?
Response message:
1.50E-08
:TRIGger:EDGE:HOLDoff
Command/Query
DESCRIPTION The command selects the holdoff type of the edge trigger.
The query returns the current holdoff type of the edge trigger.
<holdoff_type>:= {OFF|EVENts|TIME}
OFF means to turn off the holdoff.
EVENts means the number of trigger events that the
oscilloscope counts before re-arming the trigger circuitry.
TIME means the amount of time that the oscilloscope
waits before re-arming the trigger circuitry.
<holdoff_type>:= {OFF|EVENts|TIME}
EXAMPLE The following command turns off the holdoff of the edge trigger.
Command message:
:TRIGger:EDGE:HOLDoff OFF
TRIG:EDGE:HOLD OFF
Query message:
TRIG:EDGE:HOLD?
Response message:
OFF
:TRIGger:EDGE:HSTart
Command/Query
DESCRIPTION The command defines the initial position of the edge trigger
holdoff.
The query returns the initial position of the edge trigger holdoff.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
LAST_TRIG means the initial position of holdoff is the first
time point satisfying the trigger condition.
ACQ_START means the initial position of holdoff is the
time of the last trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
EXAMPLE The following command sets the start holdoff mode to last
trigger.
Command message:
:TRIGger:EDGE:HSTart LAST_TRIG
TRIG:EDGE:HST LAST_TRIG
Query message:
TRIG:EDGE:HST?
Response message:
LAST_TRIG
:TRIGger:EDGE:IMPedance
Command/Query
DESCRIPTION The command sets the edge trigger source impedance, which
is only valid when the source is EXT or EXT/5.
<ohm>:= {ONEMeg|FIFTy}
<ohm>:= {ONEMeg|FIFTy}
Command message:
:TRIGger:EDGE:IMPedance FIFTy
TRIG:EDGE:IMP FIFT
Query message:
TRIG:EDGE:IMP?
Response message:
FIFTy
:TRIGger:EDGE:LEVel
Command/Query
DESCRIPTION The command sets the trigger level of the edge trigger.
The query returns the current trigger level value of the edge
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the trigger level of the edge
trigger to 0.5 V.
Command message:
:TRIGger:EDGE:LEVel 5.00E-01
TRIG:EDGE:LEV 5.00E-01
Query message:
TRIG:EDGE:LEV?
Response message:
5.00E-01
:TRIGger:EDGE:NREJect
Command/Query
<state>:= {OFF|ON}
<state>:= {OFF|ON}
Command message:
:TRIGger:EDGE:NREJect ON
TRIG:EDGE:NREJ ON
Query message:
TRIG:EDGE:NREJ?
Response message:
ON
:TRIGger:EDGE:SLOPe
Command/Query
The query returns the current slope setting of the edge trigger.
<slope_type>:= {RISing|FALLing|ALTernate}
<slope_type>:= {RISing|FALLing|ALTernate}
EXAMPLE The following command set the rising slope as trigger edge.
Command message:
:TRIGger:EDGE:SLOPe RISing
TRIG:EDGE:SLOP RIS
Query message:
TRIG:EDGE:SLOP?
Response message:
RISing
:TRIGger:EDGE:SOURce
Command/Query
DESCRIPTION The command sets the trigger source of the edge trigger.
The query returns the current trigger source of the edge trigger.
<source>:= {C<x>|D<n>|EX|EX5|LINE}
<source>:= {C<x>|D<n>|EX|EX5|LINE}
EXAMPLE The following command sets the trigger source of the edge
trigger as C1.
Command message:
:TRIGger:EDGE:SOURce C1
TRIG:EDGE:SOUR C1
Query message:
TRIG:EDGE:SOUR?
Response message:
C1
:TRIGger:SLOPe Commands
:TRIGger:SLOPe:COUPling
:TRIGger:SLOPe:HLDEVent
:TRIGger:SLOPe:HLDTime
:TRIGger:SLOPe:HLEVel
:TRIGger:SLOPe:HOLDoff
:TRIGger:SLOPe:HSTart
:TRIGger:SLOPe:LIMit
:TRIGger:SLOPe:LLEVel
:TRIGger:SLOPe:NREJect
:TRIGger:SLOPe:SLOPe
:TRIGger:SLOPe:SOURce
:TRIGger:SLOPe:TLOWer
:TRIGger:SLOPe:TUPPer
:TRIGger:SLOPe:COUPling
Command/Query
DESCRIPTION The command sets the coupling mode of the slope trigger.
The query returns the current the coupling mode of the slope
trigger.
<mode>:= {DC|AC|LFREJect|HFREJect}
DC coupling allows dc and ac signals into the trigger path.
AC coupling places a high-pass filter in the trigger path,
removing dc offset voltage from the trigger waveform. Use
AC coupling to get a stable edge trigger when your
waveform has a large dc offset.
HFREJect which is a high-frequency rejection filter adds a
low-pass filter in the trigger path to remove high frequency
components from the trigger waveform. Use the
high-frequency reject filter to remove high-frequency
noise, such as AM or FM broadcast stations, from the
trigger path.
LFREJect which is a low frequency rejection filter adds a
high-pass filter in series with the trigger waveform to
remove any unwanted low frequency components from a
trigger waveform, such as power line frequencies, that can
interfere with proper triggering.
<mode>:= {DC|AC|LFREJect|HFREJect}
EXAMPLE The following command sets the coupling mode of the slope
trigger to DC.
Command message:
:TRIGger:SLOPe:COUPling DC
TRIG:SLOP:COUP DC
Query message:
TRIG:SLOP:COUP?
Response message:
DC
:TRIGger:SLOPe:HLDEVent
Command/Query
DESCRIPTION This command sets the number of holdoff events of the slope
trigger.
Command message:
:TRIGger:SLOPe:HLDEVent 3
TRIG:SLOP:HLDEV 3
Query message:
TRIG:SLOP:HLDEV?
Response message:
3
:TRIGger:SLOPe:HLDTime
Command/Query
DESCRIPTION This This command sets the holdoff time of the slope trigger.
The query returns the current holdoff time of the slope trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS5000X
SDS2000X Plus
SDS6000 Pro
[8.00E-09, 3.00E+01]
SDS6000A
SDS6000L
SDS2000X HD
EXAMPLE The following command sets the holdoff time of the slope
trigger to 15 ns.
Command message:
:TRIGger:SLOPe:HLDTime 1.50E-08
TRIG:SLOP:HLDT 1.50E-08
Query message:
TRIG:SLOP:HLDT?
Response message:
1.50E-08
:TRIGger:SLOPe:HLEVel
Command/Query
DESCRIPTION The command sets the high level of the slope trigger.
The query returns the current high level of the slope trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The high level value cannot be less than the low level value
using by the command :TRIGger:SLOPe:LLEVel.
EXAMPLE The following command sets the high level of the slope trigger
to 0.5 V.
Command message:
:TRIGger:SLOPe:HLEVel 5.00E-01
TRIG:SLOP:HLEV 5.00E-01
Query message:
TRIG:SLOP:HLEV?
Response message:
5.00E-01
:TRIGger:SLOPe:HOLDoff
Command/Query
DESCRIPTION The command selects the holdoff type of the slope trigger.
The query returns the curent holdoff type of the slope trigger.
<holdoff_type>:= {OFF|EVENts|TIME}
OFF means to turn off the holdoff
EVENts means the amount of events that the oscilloscope
counts before re-arming the trigger circuitry
TIME means the amount of time that the oscilloscope waits
before re-arming the trigger circuitry
EXAMPLE The following command turns off the holdoff of the slope trigger.
Command message:
:TRIGger:SLOPe:HOLDoff OFF
TRIG:SLOP:HOLD OFF
Query message:
TRIG:SLOP:HOLD?
Response message:
OFF
:TRIGger:SLOPe:HSTart
Command/Query
DESCRIPTION The command defines the initial position of the slope trigger
holdoff.
The query returns the initial position of the slope trigger holdoff.
<start_type>:= {LAST_TRIG|ACQ_START}
LAST_TRIG means the initial position of holdoff is the first
time point satisfying the trigger condition.
ACQ_START means the initial position of holdoff is the
time of the last trigger.
<type>:= {LAST_TRIG|ACQ_START}
Command message:
:TRIGger:SLOPe:HSTart LAST_TRIG
TRIG:SLOP:HST LAST_TRIG
Query message:
TRIG:SLOP:HST?
Response message:
LAST_TRIG
:TRIGger:SLOPe:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the slope trigger.
The query returns the current limit range type of the slope
trigger.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the limit of the slope trigger to
LESSthan.
Command message:
:TRIGger:SLOPe:LIMit LESSthan
TRIG:SIOP:LIM LESS
Query message:
TRIG:SIOP:LIM?
Response message:
LESSthan
:TRIGger:SLOPe:LLEVel
Command/Query
DESCRIPTION The command sets the low level of the slope trigger.
The query returns the current low level of the slope trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The low level value cannot be greater than the low level value
using by the command :TRIGger:SLOPe:HLEVel.
EXAMPLE The following command sets the low level of the slope trigger to
-0.5 V.
Command message:
:TRIGger:SLOPe:LLEVel -5.00E-01
TRIG:SLOP:LLEV -5.00E-01
Query message:
TRIG:SLOP:LLEV?
Response message:
-5.00E-01
:TRIGger:SLOPe:NREJect
Command/Query
<state>:= {OFF|ON}
<state>:= {OFF|ON}
Command message:
:TRIGger:SLOPe:NREJect ON
TRIG:SLOP:NREJ ON
Query message:
TRIG:SLOP:NREJ?
Response message:
ON
:TRIGger:SLOPe:SLOPe
Command/Query
<slope_type>:= {RISing|FALLing|ALTernate}
<slope_type>:= {RISing|FALLing|ALTernate}
EXAMPLE The following command sets the rising slope of the slope
trigger.
Command message:
:TRIGger:SLOPe:SLOPe RISing
TRIG:SLOP:SLOP RIS
Query message:
TRIG:SLOP:SLOP?
Response message:
RISing
:TRIGger:SLOPe:SOURce
Command/Query
DESCRIPTION The command sets the trigger source of the slope trigger.
The query returns the current trigger source of the slope trigger.
<source>:= {C<x>}
<source>:= {C<x>}
EXAMPLE The following command sets the trigger source of the slope
trigger to C2 (channel 2).
Command message:
:TRIGger:SLOPe:SOURce C2
TRIG:SLOP:SOUR C2
Query message:
TRIG:SLOP:SOUR?
Response message:
C2
:TRIGger:SLOPe:TLOWer
Command/Query
DESCRIPTION The command sets the lower value of the slope trigger limit
type.
The query returns the current lower value of the slope trigger
limit type.
Note:
• The lower value cannot be greater than the upper value
using by the command :TRIGger:SLOPe:TUPPer.
• The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the lower time of the slope trigger
to 10 ns.
Command message:
:TRIGger:SLOPe:TLOWer 1.00E-08
TRIG:SLOP:TLOW 1.00E-08
Query message:
TRIG:SLOP:TLOW?
Response message:
1.00E-08
:TRIGger:SLOPe:TUPPer
Command/Query
DESCRIPTION The command sets the upper value of the slope trigger limit
type.
The query returns the current upper value of the slope trigger
limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :TRIGger:SLOPe:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the upper value of the slope
trigger to 30 ns, when the limit range type is OUTer.
Command message:
:TRIGger:SLOPe:TUPPer 3.00E-08
TRIG:SLOP:TUPP 3.00E-08
Query message:
TRIG:SLOP:TUPP?
Response message:
3.00E-08
:TRIGger:PULSe Commands
:TRIGger:PULSe:COUPling
:TRIGger:PULSe:HLDEVent
:TRIGger:PULSe:HLDTime
:TRIGger:PULSe:HOLDoff
:TRIGger:PULSe:HSTart
:TRIGger:PULSe:LEVel
:TRIGger:PULSe:LIMit
:TRIGger:PULSe:NREJect
:TRIGger:PULSe:POLarity
:TRIGger:PULSe:SOURce
:TRIGger:PULSe:TLOWer
:TRIGger:PULSe:TUPPer
:TRIGger:PULSe:COUPling
Command/Query
DESCRIPTION The command sets the coupling mode of the pulse trigger.
<mode>:= {DC|AC|LFREJect|HFREJect}
DC coupling allows dc and ac signals into the trigger path.
AC coupling places a high-pass filter in the trigger path,
removing dc offset voltage from the trigger waveform. Use
AC coupling to get a stable edge trigger when your
waveform has a large dc offset.
HFREJect which is a high-frequency rejection filter adds a
low-pass filter in the trigger path to remove high frequency
components from the trigger waveform. Use the
high-frequency rejection filter to remove high-frequency
noise, such as AM or FM broadcast stations, from the
trigger path.
LFREJect which is a low frequency rejection filter adds a
high-pass filter in series with the trigger waveform to
remove any unwanted low frequency components from a
trigger waveform, such as power line frequencies, that can
interfere with proper triggering.
<mode>:= {DC|AC|LFREJect|HFREJect}
EXAMPLE The following command sets coupling mode of the pulse trigger
to DC.
Command message:
:TRIGger:PULSe:COUPling DC
TRIG:PULS:COUP DC
Query message:
TRIG:PULS:COUP?
Response message:
DC
:TRIGger:PULSe:HLDEVent
Command/Query
DESCRIPTION This command sets the number of holdoff events of the pulse
trigger.
Command message:
:TRIGger:PULSe:HLDEVent 3
TRIG:PULS:HLDEV 3
Query message:
TRIG:PULS:HLDEV?
Response message:
3
:TRIGger:PULSe:HLDTime
Command/Query
DESCRIPTION This This command sets the holdoff time of the pulse trigger.
The query returns the current holdoff time of the pulse trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS5000X
SDS2000X Plus
SDS6000 Pro
[8.00E-09, 3.00E+01]
SDS6000A
SDS6000L
SDS2000X HD
EXAMPLE The following command sets the holdoff time of the pulse
trigger to 15 ns.
Command message:
:TRIGger:PULSe:HLDTime 1.50E-08
TRIG:PULS:HLDT 1.50E-08
Query message:
TRIG:PULS:HLDT?
Response message:
1.50E-08
:TRIGger:PULSe:HOLDoff
Command/Query
DESCRIPTION The command selects the holdoff type of the pulse trigger.
The query returns the current holdoff type of the pulse trigger.
<holdoff_type>:= {OFF|EVENts|TIME}
OFF means to turn off the holdoff.
EVENts means the amount of events that the oscilloscope
counts before re-arming the trigger circuitry.
TIME means the amount of time that the oscilloscope waits
before re-arming the trigger circuitry.
EXAMPLE The following command turns off the holdoff of the pulse trigger.
Command message:
:TRIGger:PULSe:HOLDoff OFF
TRIG:PULS:HOLD OFF
Query message:
TRIG:PULS:HOLD?
Response message:
OFF
:TRIGger:PULSe:HSTart
Command/Query
DESCRIPTION The command defines the initial position of the pulse trigger
holdoff.
The query returns the initial position of the pulse trigger holdoff.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
LAST_TRIG means the initial position of holdoff is the first
time point satisfying the trigger condition.
ACQ_START means the initial position of holdoff is the
time of the last trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
EXAMPLE The following command sets the start holdoff mode of pulse
trigger to LAST_TRIG (last trigger).
Command message:
:TRIGger:PULSe:HSTart LAST_TRIG
TRIG:PULS:HST LAST_TRIG
Query message:
TRIG:PULS:HST?
Response message:
LAST_TRIG
:TRIGger:PULSe:LEVel
Command/Query
DESCRIPTION The command sets the trigger level of the pulse trigger.
The query returns the current trigger level of the pulse trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the trigger level of the pulse
trigger to 0.5 V.
Command message:
:TRIGger:PULSe:LEVel 5.00E-01
TRIG:PULS:LEV 5.00E-01
Query message:
TRIG:PULS:LEV?
Response message:
5.00E-01
:TRIGger:PULSe:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the pulse trigger.
The query returns the current limit range type of the pulse
trigger.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the trigger limit of the pulse trigger
to inner.
Command message:
:TRIGger:PULSe:LIMit INNer
TRIG:PULS:LIM INN
Query message:
TRIG:PULS:LIM?
Response message:
INNer
:TRIGger:PULSe:NREJect
Command/Query
<state>:= {OFF|ON}
<state>:= {OFF|ON}
Command message:
:TRIGger:PULSe:NREJect ON
TRIG:PULS:NREJ ON
Query message:
TRIG:PULS:NREJ?
Response message:
ON
:TRIGger:PULSe:POLarity
Command/Query
<polarity_type>:= {POSitive|NEGative}
<polarity_type>:= {POSitive|NEGative}
EXAMPLE The following command sets the polarity of the pulse trigger to
POSitive.
Command message:
:TRIGger:PULSe:POLarity POSitive
TRIG:PULS:POL POS
Query message:
TRIG:PULS:POL?
Response message:
POSitive
:TRIGger:PULSe:SOURce
Command/Query
DESCRIPTION The command sets the trigger source of the pulse trigger.
The query returns the current trigger source of the pulse trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the polarity of the pulse trigger as
channel 2.
Command message:
:TRIGger:PULSe:SOURce C2
TRIG:PULS:SOUR C2
Query message:
TRIG:PULS:SOUR?
Response message:
C2
:TRIGger:PULSe:TLOWer
Command/Query
DESCRIPTION The command sets the lower value of the pulse trigger limit
type.
The query returns the current lower value of the pulse trigger
limit type.
Note:
• The lower value cannot be greater than the upper value
using by the command :TRIGger:PULSe:TUPPer.
• The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the lower time of the pulse trigger
to 10 ns.
Command message:
:TRIGger:PULSe:TLOWer 1.00E-08
TRIG:PULS:TLOW 1.00E-08
Query message:
TRIG:PULS:TLOW?
Response message:
1.00E-08
:TRIGger:PULSe:TUPPer
Command/Query
DESCRIPTION The command sets the upper value of the pulse trigger limit
type.
The query returns the current upper value of the pulse trigger
limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :TRIGger:PULse:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the upper time of the pulse trigger
to 30 ns.
Command message:
:TRIGger:PULSe:TUPPer 3.00E-08
TRIG:PULS:TUPP 3.00E-08
Query message:
TRIG:PULS:TUPP?
Response message:
3.00E-08
:TRIGger:VIDeo Commands
:TRIGger:VIDeo:FCNT
:TRIGger:VIDeo:FIELd
:TRIGger:VIDeo:FRATe
:TRIGger:VIDeo:INTerlace
:TRIGger:VIDeo:LCNT
:TRIGger:VIDeo:LEVel
:TRIGger:VIDeo:LINE
:TRIGger:VIDeo:SOURce
:TRIGger:VIDeo:STANdard
:TRIGger:VIDeo:SYNC
:TRIGger:VIDeo:FCNT
Command/Query
DESCRIPTION The command sets the fields of the custom video trigger.
The query returns the current fields of the custom video trigger.
<field_cnt>:= {1|2|4|8}
<field_cnt>:= {1|2|4|8}
EXAMPLE The following command sets the fields of the custom video
trigger to 8.
Command message:
:TRIGger:VIDeo:FCNT 8
TRIG:VID:FCNT 8
Query message:
TRIG:VID:FCNT?
Response message:
8
:TRIGger:VIDeo:FIELd
Command/Query
DESCRIPTION The command sets the synchronous trigger field when the
video standard is NTSC, PAL, 1080i/50 or 1080i/60.
<field>:= {1|2}
<field>:= {1|2}
Command message:
:TRIGger:VIDeo:FIELd 2
TRIG:VID:FIEL 2
Query message:
TRIG:VID:FIEL?
Response message:
2
:TRIGger:VIDeo:FRATe
Command/Query
DESCRIPTION The command sets the frame rate of the custom video trigger.
The query returns the current frame rate of the custom video
trigger.
<frate>:= {25Hz|30Hz|50Hz|60Hz}
<frate>:= {25Hz|30Hz|50Hz|60Hz}
EXAMPLE The following command sets the frame rate of the custom video
trigger to 50Hz.
Command message:
:TRIGger:VIDeo:FRATe 50Hz
TRIG:VID:FRAT 50Hz
Query message:
TRIG:VID:FRAT?
Response message:
50Hz
:TRIGger:VIDeo:INTerlace
Command/Query
DESCRIPTION The command sets the interlace of the custom video trigger.
<interlace>:= {1|2|4|8}
<interlace>:= {1|2|4|8}
EXAMPLE The following command sets the interlace of the custom video
trigger to 8:1.
Command message:
:TRIGger:VIDeo:INTerlace 8
TRIG:VID:INT 8
Query message:
TRIG:VID:INT?
Response message:
8
:TRIGger:VIDeo:LCNT
Command/Query
DESCRIPTION The command sets the lines of the custom video trigger.
Of Of Trigger
Interlace Trigger Field
Lines Fields Line
800 1:1 1 800 1
EXAMPLE The following command sets the lines of the custom video
trigger to 500.
Command message:
:TRIGger:VIDeo:LCNT 500
TRIG:VID:LCNT 500
Query message:
TRIG:VID:LCNT?
Response message:
500
:TRIGger:VIDeo:LEVel
Command/Query
DESCRIPTION The command sets the trigger level of the video trigger.
The query returns the current trigger level of the video trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro [-4.5*vertical_scale-vertical_offse
SDS6000A t,
SDS6000L 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X [-4.1*vertical_scale-vertical_offse
SDS2000X Plus t,
SDS2000X HD 4.1*vertical_scale-vertical_offset]
EXAMPLE The following command sets the trigger level of the video
trigger to 0.5 V.
Command message:
:TRIGger:VIDeo:LEVel 5.00E-01
TRIG:VID:LEV 5.00E-01
Query message:
TRIG:VID:LEV?
Response message:
5.00E-01
:TRIGger:VIDeo:LINE
Command/Query
DESCRIPTION The command sets the synchronous trigger line when the video
standard is not custom.
Command message:
:TRIGger:VIDeo:LINE 2
TRIG:VID:LINE 2
Query message:
TRIG:VID:LINE?
Response message:
2
:TRIGger:VIDeo:SOURce
Command/Query
DESCRIPTION The command sets the trigger source of the video trigger.
The query returns the current trigger source of the video trigger.
<source>:= {C<x>}
<source>:= {C<x>}
EXAMPLE The following command sets the trigger source of the video
trigger to channel 2.
Command message:
:TRIGger:VIDeo:SOURce C2
TRIG:VID:SOUR C2
Query message:
TRIG:VID:SOUR?
Response message:
C2
:TRIGger:VIDeo:STANdard
Command/Query
<standard>:=
{NTSC|PAL|P720L50|P720L60|P1080L50|P1080L60|I1080L50
|I1080L60|CUSTom}
<standard>:=
{NTSC|PAL|P720L50|P720L60|P1080L50|P1080L60|I1080L50
|I1080L60|CUSTom}
EXAMPLE The following command sets the standard of the video trigger
to NTSC.
Command message:
:TRIGger:VIDeo:STANdard NTSC
TRIG:VID:STAN NTSC
Query message:
TRIG:VID:STAN?
Response message:
NTSC
:TRIGger:VIDeo:SYNC
Command/Query
DESCRIPTION The command sets the sync mode of the video trigger.
The query returns the current sync mode of the video trigger.
<sync>:= {SELect|ANY}
<sync>:= {SELect|ANY}
EXAMPLE The following command sets the sync mode of the video trigger
to select.
Command message:
:TRIGger:VIDeo:SYNC SELect
TRIG:VID:SYNC SEL
Query message:
TRIG:VID:SYNC?
Response message:
SELect
:TRIGger:WINDow Commands
:TRIGger:WINDow:CLEVel
:TRIGger:WINDow:COUPling
:TRIGger:WINDow:DLEVel
:TRIGger:WINDow:HLDEVent
:TRIGger:WINDow:HLDTime
:TRIGger:WINDow:HLEVel
:TRIGger:WINDow:HOLDoff
:TRIGger:WINDow:HSTart
:TRIGger:WINDow:LLEVel
:TRIGger:WINDow:NREJect
:TRIGger:WINDow:SOURce
:TRIGger:WINDow:TYPE
:TRIGger:WINDow:CLEVel
Command/Query
DESCRIPTION The command sets the center level of the window trigger.
The query returns the current center level of the window trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the center level of the window
trigger to 0.5 V.
Command message:
:TRIGger:WINDow:CLEVel 5.00E-01
TRIG:WIND:CLEV 5.00E-01
Query message:
TRIG:WIND:CLEV?
Response message:
5.00E-01
:TRIGger:WINDow:COUPling
Command/Query
DESCRIPTION The command sets the coupling mode of the window trigger.
<mode>:= {DC|AC|LFREJect|HFREJect}
DC coupling allows dc and ac signals into the trigger path.
AC coupling places a high-pass filter in the trigger path,
removing dc offset voltage from the trigger waveform. Use
AC coupling to get a stable edge trigger when your
waveform has a large dc offset.
HFREJect which is a high-frequency rejection filter adds a
low-pass filter in the trigger path to remove high-frequency
components from the trigger waveform. Use the high
frequency rejection filter to remove high-frequency noise,
such as AM or FM broadcast stations, from the trigger
path.
LFREJect which is a low frequency rejection filter adds a
high-pass filter in series with the trigger waveform to
remove any unwanted low frequency components from a
trigger waveform, such as power line frequencies, that can
interfere with proper triggering.
<mode>:= {DC|AC|LFREJect|HFREJect}
EXAMPLE The following command sets the coupling mode of the window
trigger to DC.
Command message:
:TRIGger:WINDow:COUPling DC
TRIG:WIND:COUP DC
Query message:
TRIG:WIND:COUP?
Response message:
DC
:TRIGger:WINDow:DLEVel
Command/Query
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the delta level of window trigger to
0.5 V.
Command message:
:TRIGger:WINDow:DLEVel 5.00E-01
TRIG:WIND:DLEV 5.00E-01
Query message:
TRIG:WIND:DLEV?
Response message:
5.00E-01
:TRIGger:WINDow:HLDEVent
Command/Query
DESCRIPTION This command sets the number of holdoff events of the window
trigger.
Command message:
:TRIGger:WINDow:HLDEVent 3
TRIG:WIND:HLDEV 3
Query message:
TRIG:WIND:HLDEV?
Response message:
3
:TRIGger:WINDow:HLDTime
Command/Query
DESCRIPTION This This command sets the holdoff time of the window trigger.
The query returns the current holdoff time of the window trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS5000X
SDS2000X Plus
SDS6000 Pro
[8.00E-09, 3.00E+01]
SDS6000A
SDS6000L
SDS2000X HD
EXAMPLE The following command sets the holdoff time of the window
trigger to 15 ns.
Command message:
:TRIGger:WINDow:HLDTime 1.50E-08
TRIG:WIND:HLDT 1.50E-08
Query message:
TRIG:WIND:HLDT?
Response message:
1.50E-08
:TRIGger:WINDow:HLEVel
Command/Query
DESCRIPTION The command sets the high trigger level of window trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The high level value cannot be less than the low level value
using by the command :TRIGger:WINDow:LLEVel.
EXAMPLE The following command sets the high trigger level of window
trigger to 0.5 V.
Command message:
:TRIGger:WINDow:HLEVel 5.00E-01
TRIG:WIND:HLEV 5.00E-01
Query message:
TRIG:WIND:HLEV?
Response message:
5.00E-01
:TRIGger:WINDow:HOLDoff
Command/Query
DESCRIPTION The command selects the holdoff type of the window trigger.
The query returns the current holdoff type of the window trigger.
<holdoff_type>:= {OFF|EVENts|TIME}
OFF means to turn off the holdoff.
EVENts means the amount of events that the oscilloscope
counts before re-arming the trigger circuitry.
TIME means the amount of time that the oscilloscope waits
before re-arming the trigger circuitry.
EXAMPLE The following command turns off the holdoff of the window
trigger.
Command message:
:TRIGger:WINDow:HOLDoff OFF
TRIG:WIND:HOLD OFF
Query message:
TRIG:WIND:HOLD?
Response message:
OFF
:TRIGger:WINDow:HSTart
Command/Query
DESCRIPTION The command defines the initial position of the window trigger
holdoff.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
LAST_TRIG means the initial position of holdoff is the first
time point satisfying the trigger condition.
ACQ_START means the initial position of holdoff is the time
of the last trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
Command message:
:TRIGger:WINDow:HSTart LAST_TRIG
TRIG:WIND:HST LAST_TRIG
Query message:
TRIG:PULS:HST?
Response message:
LAST_TRIG
:TRIGger:WINDow:LLEVel
Command/Query
DESCRIPTION The command sets the low trigger level of the window trigger.
The query returns the current low trigger level of the window
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset,
SDS6000L 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The low level value cannot be greater than the high level value
using by the command :TRIGger:WINDow:HLEVel.
EXAMPLE The following command sets the low trigger level of runt trigger
to -0.5 V.
Command message:
:TRIGger:WINDowLLEVel -5.00E-01
TRIG:WIND:LLEV -5.00E-01
Query message:
TRIG:WIND:LLEV?
Response message:
-5.00E-01
:TRIGger:WINDow:NREJect
Command/Query
<state>:= {OFF|ON}
<state>:= {OFF|ON}
Command message:
:TRIGger:WINDow:NREJect ON
TRIG:WIND:NREJ ON
Query message:
TRIG:WIND:NREJ?
Response message:
ON
:TRIGger:WINDow:SOURce
Command/Query
DESCRIPTION The command sets the trigger source of the window trigger.
<source>:= {C<x>}
<source>:= {C<x>}
EXAMPLE The following command sets the trigger source of the window
trigger to channel 2.
Command message:
:TRIGger:WINDow:SOURce C2
TRIG:WIND:SOUR C2
Query message:
TRIG:WIND:SOUR?
Response message:
C2
:TRIGger:WINDow:TYPE
Command/Query
DESCRIPTION The command sets the window type of the window trigger.
<type>:= {ABSolute|RELative}
<type>:= {ABSolute|RELative}
Command message:
:TRIGger:WINDow:TYPE ABSolute
TRIG:WIND:TYPE ABS
Query message:
TRIG:WIND:TYPE?
Response message:
ABSolute
:TRIGger:INTerval Commands
:TRIGger:INTerval:COUPling
:TRIGger:INTerval:HLDEVent
:TRIGger:INTerval:HLDTime
:TRIGger:INTerval:HOLDoff
:TRIGger:INTerval:HSTart
:TRIGger:INTerval:LEVel
:TRIGger:INTerval:LIMit
:TRIGger:INTerval:NREJect
:TRIGger:INTerval:SLOPe
:TRIGger:INTerval:SOURce
:TRIGger:INTerval:TLOWer
:TRIGger:INTerval:TUPPer
:TRIGger:INTerval:COUPling
Command/Query
DESCRIPTION The command sets the coupling mode of the interval trigger.
<mode>:= {DC|AC|LFREJect|HFREJect}
DC coupling allows dc and ac signals into the trigger path.
AC coupling places a high-pass filter in the trigger path,
removing dc offset voltage from the trigger waveform. Use
AC coupling to get a stable edge trigger when your
waveform has a large dc offset.
HFREJect which is a high-frequency rejection filter adds a
low-pass filter in the trigger path to remove high-frequency
components from the trigger waveform. Use the
high-frequency reject filter to remove high-frequency
noise, such as AM or FM broadcast stations, from the
trigger path.
LFREJect which is a low frequency rejection filter adds a
high-pass filter in series with the trigger waveform to
remove any unwanted low frequency components from a
trigger waveform, such as power line frequencies, that can
interfere with proper triggering.
<mode>:= {DC|AC|LFREJect|HFREJect}
EXAMPLE The following command sets the coupling mode of the interval
trigger to DC.
Command message:
:TRIGger:INTerval:COUPling DC
TRIG:INT:COUP DC
Query message:
TRIG:INT:COUP?
Response message:
DC
:TRIGger:INTerval:HLDEVent
Command/Query
DESCRIPTION This command sets the number of holdoff events of the interval
trigger.
EXAMPLE The following command sets the number of holdoff events of the
interval trigger to 3.
Command message:
:TRIGger:INTerval:HLDEVent 3
TRIG:INT:HLDEV 3
Query message:
TRIG:INT:HLDEV?
Response message:
3
:TRIGger:INTerval:HLDTime
Command/Query
DESCRIPTION This This command sets the holdoff time of the interval trigger.
The query returns the current holdoff time of the interval trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS5000X
SDS2000X Plus
SDS6000 Pro
[8.00E-09, 3.00E+01]
SDS6000A
SDS6000L
SDS2000X HD
EXAMPLE The following command sets the holdoff time of the interval
trigger to 15 ns.
Command message:
:TRIGger:INTerval:HLDTime 1.50E-08
TRIG:INT:HLDT 1.50E-08
Query message:
TRIG:INT:HLDT?
Response message:
1.50E-08
:TRIGger:INTerval:HOLDoff
Command/Query
DESCRIPTION The command selects the holdoff type of the interval trigger.
The query returns the current holdoff type of the interval trigger.
<holdoff_type>:= {OFF|EVENts|TIME}
OFF means to turn off the holdoff.
EVENts means the amount of events that the oscilloscope
counts before re-arming the trigger circuitry
TIME means the amount of time that the oscilloscope waits
before re-arming the trigger circuitry.
EXAMPLE The following command turns off the holdoff of the interval
trigger.
Command message:
:TRIGger:INTerval:HOLDoff OFF
TRIG:INT:HOLD OFF
Query message:
TRIG:INT:HOLD?
Response message:
OFF
:TRIGger:INTerval:HSTart
Command/Query
DESCRIPTION The command sets the start holdoff mode of the interval trigger.
The query returns the current start holdoff mode of the interval
trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
LAST_TRIG means the initial position of holdoff is the first time
point satisfying the trigger condition.
ACQ_START means the initial position of holdoff is the time of
the last trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
EXAMPLE The following command sets the start holdoff mode of the
interval trigger as LAST_TRIG (last trigger).
Command message:
:TRIGger:INTerval:HSTart LAST_TRIG
TRIG:INT:HST LAST_TRIG
Query message:
TRIG:INT:HST?
Response message:
LAST_TRIG
:TRIGger:INTerval:LEVel
Command/Query
DESCRIPTION The command sets the trigger level of the interval trigger.
The query returns the current trigger level of the interval trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the trigger level of the interval
trigger to 0.5 V.
Command message:
:TRIGger:INTerval:LEVel 5.00E-01
TRIGr:INT:LEV 5.00E-01
Query message:
TRIG:INT:LEV?
Response message:
5.00E-01
:TRIGger:INTerval:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the interval trigger.
The query returns the current limit range type of the interval
trigger.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the limit of the interval trigger to
LESSthan.
Command message:
:TRIGger:INTerval:LIMit LESSthan
TRIG:INT:LIM LESS
Query message:
TRIG:INT:LIM?
Response message:
LESSthan
:TRIGger:INTerval:NREJect
Command/Query
<state>:= {OFF|ON}
<state>:= {OFF|ON}
Command message:
:TRIGger:INTerval:NREJect ON
TRIG:INT:NREJ ON
Query message:
TRIG:INT:NREJ?
Response message:
ON
:TRIGger:INTerval:SLOPe
Command/Query
<slope_type>:= {RISing|FALLing}
<slope_type>:= {RISing|FALLing}
EXAMPLE The following command sets the rising slope of the interval
trigger.
Command message:
:TRIGger:INTerval:SLOPe RISing
TRIG:INT:SLOP RIS
Query message:
TRIG:INT:SLOP?
Response message:
RISing
:TRIGger:INTerval:SOURce
Command/Query
DESCRIPTION The command sets the trigger source of the interval trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the trigger source of the interval
trigger as channel 1.
Command message:
:TRIGger:INTerval:SOURce C1
TRIG:INT:SOUR C1
Query message:
TRIG:INT:SOUR?
Response message:
C1
:TRIGger:INTerval:TLOWer
Command/Query
DESCRIPTION The command sets the lower value of the interval trigger limit
type.
The query returns the current lower value of the interval trigger
limit type.
Note:
• The lower value cannot be greater than the upper value
using by the command :TRIGger:INTerval:TUPPer.
• The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the time lower value of the interval
trigger to 10 ns.
Command message:
:TRIGger:INTerval:TLOWer 1.00E-08
TRIG:INT:TLOW 1.00E-08
Query message:
TRIG:INT:TLOW?
Response message:
1.00E-08
:TRIGger:INTerval:TUPPer
Command/Query
DESCRIPTION The command sets the upper value of the interval trigger limit
type.
The query returns the current upper value of the interval trigger
limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :TRIGger:INTerval:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the time upper value of the
interval trigger to 30 ns.
Command message:
:TRIGger:INTerval:TUPPer 3.00E-08
TRIG:INT:TUPP 3.00E-08
Query message:
TRIG:INT:TUPP?
Response message:
3.00E-08
:TRIGger:DROPout Commands
:TRIGger:DROPout:COUPling
:TRIGger:DROPout:HLDEVent
:TRIGger:DROPout:HLDTime
:TRIGger:DROPout:HOLDoff
:TRIGger:DROPout:HSTart
:TRIGger:DROPout:LEVel
:TRIGger:DROPout:NREJect
:TRIGger:DROPout:SLOPe
:TRIGger:DROPout:SOURce
:TRIGger:DROPout:TIME
:TRIGger:DROPout:TYPE
:TRIGger:DROPout:COUPling
Command/Query
DESCRIPTION The command sets the coupling mode of the dropout trigger.
<mode>:= {DC|AC|LFREJect|HFREJect}
DC coupling allows dc and ac signals into the trigger path.
AC coupling places a high-pass filter in the trigger path,
removing dc offset voltage from the trigger waveform. Use
AC coupling to get a stable edge trigger when your
waveform has a large dc offset.
HFREJect which is a high-frequency rejection filter adds a
low-pass filter in the trigger path to remove high-frequency
components from the trigger waveform. Use the
high-frequency rejection filter to remove high-frequency
noise, such as AM or FM broadcast stations, from the
trigger path.
LFREJect which is a low frequency rejection filter adds a
high-pass filter in series with the trigger waveform to
remove any unwanted low frequency components from a
trigger waveform, such as power line frequencies, that can
interfere with proper triggering.
<mode>:= {DC|AC|LFREJect|HFREJect}
Command message:
:TRIGger:DROPout:COUPling DC
TRIG:DROP:COUP DC
Query message:
TRIG:DROP:COUP?
Response message:
DC
:TRIGger:DROPout:HLDEVent
Command/Query
DESCRIPTION This command sets the number of holdoff events of the dropout
trigger.
Command message:
:TRIGger:DROPout:HLDEVent 3
TRIG:DROP:HLDEV 3
Query message:
TRIG:DROP:HLDEV?
Response message:
3
:TRIGger:DROPout:HLDTime
Command/Query
DESCRIPTION This This command sets the holdoff time of the dropout trigger.
The query returns the current holdoff time of the dropout trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS5000X
SDS2000X Plus
SDS6000 Pro
[8.00E-09, 3.00E+01]
SDS6000A
SDS6000L
SDS2000X HD
EXAMPLE The following command sets the holdoff time of the dropout
trigger to 15 ns.
Command message:
:TRIGger:DROPout:HLDTime 1.50E-08
:TRIG:DROP:HLDT 1.50E-08
Query message:
TRIG:DROP:HLDT?
Response message:
1.50E-08
:TRIGger:DROPout:HOLDoff
Command/Query
DESCRIPTION The command selects the holdoff type of the dropout trigger.
<holdoff_type>:= {OFF|EVENts|TIME}
OFF means to turn off the holdoff.
EVENts means the amount of events that the oscilloscope
counts before re-arming the trigger circuitry.
TIME means the amount of time that the oscilloscope waits
before re-arming the trigger circuitry.
EXAMPLE The following command turns off the holdoff of the dropout
trigger.
Command message:
:TRIGger:DROPout:HOLDoff OFF
TRIG:DROP:HOLD OFF
Query message:
TRIG:DROP:HOLD?
Response message:
OFF
:TRIGger:DROPout:HSTart
Command/Query
DESCRIPTION The command sets the start holdoff mode of the dropout
trigger.
The query returns the current start holdoff mode of the dropout
trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
LAST_TRIG means the initial position of holdoff is the first
time point satisfying the trigger condition.
ACQ_START means the initial position of holdoff is the
time of the last trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
EXAMPLE The following command sets the start hold off mode to
LAST_TRIG (last trigger).
Command message:
:TRIGger:DROPout:HSTart LAST_TRIG
TRIG:DROP:HST LAST_TRIG
Query message:
TRIG:DROP:HST?
Response message:
LAST_TRIG
:TRIGger:DROPout:LEVel
Command/Query
DESCRIPTION The command sets the trigger level of the dropout trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the trigger level of the dropout
trigger to 0.5 V.
Command message:
:TRIGger:DROPout:LEVel 5.00E-1
TRIG:DROP:LEV 5.00E-1
Query message:
TRIG:DROP:LEV?
Response message:
5.00E-01
:TRIGger:DROPout:NREJect
Command/Query
<state>:= {OFF|ON}
<state>:= {OFF|ON}
Command message:
:TRIGger:DROPout:NREJect ON
TRIG:DROP:NREJ ON
Query message:
TRIG:DROP:NREJ?
Response message:
ON
:TRIGger:DROPout:SLOPe
Command/Query
<slope_type>:= {RISing|FALLing}
<slope_type>:= {RISing|FALLing}
EXAMPLE The following command sets the rising slope of the dropout
trigger.
Command message:
:TRIGger:DROPout:SLOPe RISing
TRIG:DROP:SLOP RIS
Query message:
TRIG:DROP:SLOP?
Response message:
RISing
:TRIGger:DROPout:SOURce
Command/Query
DESCRIPTION The command sets the trigger source of the dropout trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the trigger source of the dropout
trigger to channel 2.
Command message:
:TRIGger:DROPout:SOURce C2
TRIG:DROP:SOUR C2
Query message:
TRIG:DROP:SOUR?
Response message:
C2
:TRIGger:DROPout:TIME
Command/Query
DESCRIPTION The command sets the dropout time of the dropout trigger.
EXAMPLE The following command sets the time of the dropout trigger to
10 ns.
Command message:
:TRIGger:DROPout:TIME 1.00E-08
TRIG:DROP:TIME 1.00E-08
Query message:
TRIG:DROP:TIME?
Response message:
1.00E-08
:TRIGger:DROPout:TYPE
Command/Query
DESCRIPTION The command sets the over time type of the dropout trigger.
The query returns the current over time type of the dropout
trigger.
<type>:= {EDGE|STATe}
<type>:= {EDGE|STATe}
EXAMPLE The following command sets the over time type of the dropout
trigger to EDGE.
Command message:
:TRIGger:DROPout:TYPE EDGE
TRIG:DROP:TYPE EDGE
Query message:
TRIG:DROP:TYPE?
Response message:
EDGE
:TRIGger:RUNT Commands
:TRIGger:RUNT:COUPling
:TRIGger:RUNT:HLDEVent
:TRIGger:RUNT:HLDTime
:TRIGger:RUNT:HLEVel
:TRIGger:RUNT:HOLDoff
:TRIGger:RUNT:HSTart
:TRIGger:RUNT:LIMit
:TRIGger:RUNT:LLEVel
:TRIGger:RUNT:NREJect
:TRIGger:RUNT:POLarity
:TRIGger:RUNT:SOURce
:TRIGger:RUNT:TLOWer
:TRIGger:RUNT:TUPPer
:TRIGger:RUNT:COUPling
Command/Query
DESCRIPTION The command sets the coupling mode of the runt trigger.
The query returns the current coupling mode of the runt trigger.
<mode>:= {DC|AC|LFREJect|HFREJect}
DC coupling allows dc and ac signals into the trigger path.
AC coupling places a high-pass filter in the trigger path,
removing dc offset voltage from the trigger waveform. Use
AC coupling to get a stable edge trigger when your
waveform has a large dc offset.
HFREJect which is a high-frequency rejection filter adds a
low-pass filter in the trigger path to remove high frequency
components from the trigger waveform. Use the
high-frequency reject filter to remove high-frequency
noise, such as AM or FM broadcast stations, from the
trigger path.
LFREJect which is a low frequency rejection filter adds a
high-pass filter in series with the trigger waveform to
remove any unwanted low frequency components from a
trigger waveform, such as power line frequencies, that can
interfere with proper triggering.
<mode>:= {DC|AC|LFREJect|HFREJect}
EXAMPLE The following command sets coupling mode of the runt trigger
to DC.
Command message:
:TRIGger:RUNT:COUPling DC
TRIG:RUNT:COUP DC
Query message:
TRIG:RUNT:COUP?
Response message:
DC
:TRIGger:RUNT:HLDEVent
Command/Query
DESCRIPTION This command sets the number of holdoff events of the runt
trigger.
EXAMPLE The following command sets the number of holdoff events of the
runt trigger to 3.
Command message:
:TRIGger:RUNT:HLDEVent 3
TRIG:RUNT:HLDEV 3
Query message:
TRIG:RUNT:HLDEV?
Response message:
3
:TRIGger:RUNT:HLDTime
Command/Query
DESCRIPTION This This command sets the holdoff time of the runt trigger.
The query returns the current holdoff time of the runt trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS5000X
SDS2000X Plus
SDS6000 Pro
[8.00E-09, 3.00E+01]
SDS6000A
SDS6000L
SDS2000X HD
EXAMPLE The following command sets the holdoff time of the runt trigger
to 15 ns.
Command message:
:TRIGger:RUNT:HLDTime 1.50E-08
TRIG:RUNT:HLDT 1.50E-08
Query message:
TRIG:RUNT:HLDT?
Response message:
1.50E-08
:TRIGger:RUNT:HLEVel
Command/Query
DESCRIPTION The command sets the high trigger level of the runt trigger.
The query returns the current high trigger level of the runt
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The high level value cannot be less than the low level value
using by the command :TRIGger:RUNT:LLEVel.
EXAMPLE The following command sets the high trigger level of the runt
trigger to 0.5 V.
Command message:
:TRIGger:RUNT:HLEVel 5.00E-01
TRIG:RUNT:HLEV 5.00E-01
Query message:
TRIG:RUNT:HLEV?
Response message:
5.00E-01
:TRIGger:RUNT:HOLDoff
Command/Query
DESCRIPTION The command selects the holdoff type of the runt trigger.
The query returns the current holdoff type of the runt trigger.
<holdoff_type>:= {OFF|EVENts|TIME}
OFF means to turn off the holdoff.
EVENts means the amount of events that the oscilloscope
counts before re-arming the trigger circuitry.
TIME means the amount of time that the oscilloscope waits
before re-arming the trigger circuitry.
EXAMPLE The following command turns off the holdoff of the runt trigger.
Command message:
:TRIGger:RUNT:HOLDoff OFF
TRIG:RUNT:HOLD OFF
Query message:
TRIG:RUNT:HOLD?
Response message:
OFF
:TRIGger:RUNT:HSTart
Command/Query
DESCRIPTION The command sets the start holdoff mode of the runt trigger.
The query returns the current start holdoff mode of the runt
trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
LAST_TRIG means the initial position of holdoff is the first
time point satisfying the trigger condition.
ACQ_START means the initial position of holdoff is the
time of the last trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
Command message:
:TRIGger:RUNT:HSTart LAST_TRIG
TRIG:RUNT:HST LAST_TRIG
Query message:
TRIG:RUNT:HST?
Response message:
LAST_TRIG
:TRIGger:RUNT:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the runt trigger.
The query returns the current limit range type of the runt trigger.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the limit of the runt trigger to
LESSthan.
Command message:
:TRIGger:RUNT:LIMit LESSthan
TRIG:RUNT:LIM LESS
Query message:
TRIG:RUNT:LIM?
Response message:
LESSthan
:TRIGger:RUNT:LLEVel
Command/Query
DESCRIPTION The command sets the low trigger level of the runt trigger.
The query returns the current low trigger level of the runt
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset,
SDS6000L 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Note:
The low level value cannot be greater than the high level value
using by the command :TRIGger:RUNT:HLEVel.
EXAMPLE The following command sets the low trigger level of the runt
trigger to -0.5 V.
Command message:
:TRIGger:RUNT:LLEVel - 5.00E-01
TRIG:RUNT:LLEV - 5.00E-01
Query message:
TRIG:RUNT:LLEV?
Response message:
-5.00E-01
:TRIGger:RUNT:NREJect
Command/Query
<state>:= {OFF|ON}
<state>:= {OFF|ON}
Command message:
:TRIGger:RUNT:NREJect ON
TRIG:RUNT:NREJ ON
Query message:
TRIG:RUNT:NREJ?
Response message:
ON
:TRIGger:RUNT:POLarity
Command/Query
<polarity_type>:= {POSitive|NEGative}
<polarity_type>:= {POSitive|NEGative}
EXAMPLE The following command sets the polarity of the runt trigger to
POSitive.
Command message:
:TRIGger:RUNT:POLarity POSitive
TRIG:RUNT:POL POS
Query message:
TRIG:RUNT:POL?
Response message:
POSitive
:TRIGger:RUNT:SOURce
Command/Query
DESCRIPTION The command sets the trigger source of the runt trigger.
The query returns the current trigger source of the runt trigger.
<source>:= {C<x>}
<source>:= {C<x>}
EXAMPLE The following command sets the trigger source of the runt
trigger to channel 2
Command message:
:TRIGger:RUNT:SOURce C2
TRIG:RUNT:SOUR C2
Query message:
TRIG:RUNT:SOUR?
Response message:
C2
:TRIGger:RUNT:TLOWer
Command/Query
DESCRIPTION The command sets the lower value of the runt trigger limit type.
The query returns the current lower value of the runt trigger
limit type.
Note:
• The lower value cannot be greater than the upper value
using by the command :TRIGger:RUNT:TUPPer.
• The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the lower time of the runt trigger
to 10 ns.
Command message:
:TRIGger:RUNT:TLOWer 1.00E-08
TRIG:RUNT:TLOW 1.00E-08
Query message:
TRIG:RUNT:TLOW?
Response message:
1.00E-08
:TRIGger:RUNT:TUPPer
Command/Query
DESCRIPTION The command sets the upper value of the runt trigger limit type.
The query returns the current upper value of the runt trigger
limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :TRIGger:RUNT:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the upper time of the runt trigger
to 30 ns.
Command message:
:TRIGger:RUNT:TUPPer 3.00E-08
TRIG:RUNT:TUPP 3.00E-08
Query message:
TRIG:RUNT:TUPP?
Response message:
3.00E-08
:TRIGger:PATTern Commands
:TRIGger:PATTern:HLDEVent
:TRIGger:PATTern:HLDTime
:TRIGger:PATTern:HOLDoff
:TRIGger:PATTern:HSTart
:TRIGger:PATTern:INPut
:TRIGger:PATTern:LEVel
:TRIGger:PATTern:LIMit
:TRIGger:PATTern:LOGic
:TRIGger:PATTern:TLOWer
:TRIGger:PATTern:TUPPer
:TRIGger:PATTern:HLDEVent
Command/Query
DESCRIPTION This command sets the number of holdoff events of the pattern
trigger.
EXAMPLE The following command sets the number of holdoff events of the
pattern trigger to 3.
Command message:
:TRIGger:PATTern:HLDEVent 3
TRIG:PATT:HLDEV 3
Query message:
TRIG:PATT:HLDEV?
Response message:
3
:TRIGger:PATTern:HLDTime
Command/Query
DESCRIPTION This This command sets the holdoff time of the pattern trigger.
The query returns the current holdoff time of the pattern trigger.
The range of the value varies by model, see the table below for
details.
Mode value
SDS5000X
SDS2000X Plus
SDS6000 Pro
[8.00E-09, 3.00E+01]
SDS6000A
SDS6000L
SDS2000X HD
SHS800X/SHS1000X [80.00E-09, 1.50E+00]
EXAMPLE The following command sets the holdoff time of the pattern
trigger to 15 ns.
Command message:
:TRIGger:PATTern:HLDTime 1.50E-08
TRIG:PATT:HLDT 1.50E-08
Query message:
TRIG:PATT:HLDT?
Response message:
1.50E-08
:TRIGger:PATTern:HOLDoff
Command/Query
DESCRIPTION The command selects the holdoff type of the pattern trigger.
The query returns the current holdoff type of the pattern trigger.
<holdoff_type>:= {OFF|EVENts|TIME}
OFF means to turn off the holdoff
EVENts means the amount of events that the oscilloscope
counts before re-arming the trigger circuitry
TIME means the amount of time that the oscilloscope waits
before re-arming the trigger circuitry
EXAMPLE The following command turns off the holdoff of the pattern
trigger.
Command message:
:TRIGger:PATTern:HOLDoff OFF
TRIG:PATT:HOLD OFF
Query message:
TRIG:PATT:HOLD?
Response message:
OFF
:TRIGger:PATTern:HSTart
Command/Query
DESCRIPTION The command sets the start holdoff mode of the pattern trigger.
The query returns the current start holdoff mode of the pattern
trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
LAST_TRIG means the initial position of holdoff is the first
time point satisfying the trigger condition.
ACQ_START means the initial position of holdoff is the
time of the last trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
Command message:
:TRIGger:PATTern:HSTart LAST_TRIG
TRIG:PATT:HST LAST_TRIG
Query message:
TRIG:PATT:HST?
Response message:
LAST_TRIG
:TRIGger:PATTern:INPut
Command/Query
DESCRIPTION The command specifies the logical input condition for the
channel (Cx) and digital channel (Dx) of the pattern trigger.
<logic>:= {X|L|H}
X means the "don't care" state.
H means the logic high state.
L means the logic low state.
Note:
Parameters are configured to corresponding sources in the order
of C1-C<n>, D0-D15.
<input>:= {X|L|H}
EXAMPLE The following command sets the logic input for channel 1 to H,
for channel 2 to H, for channel 3 to L, for channel 4 to X and for
all digital channel to X.
Command message:
:TRIGger:PATTern:INPut
H,H,L,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X
TRIG:PATT:INP H,H,L,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X
Query message:
TRIG:PATT:INP?
Response message:
H,H,L,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X
:TRIGger:PATTern:LEVel
Command/Query
DESCRIPTION The command sets the trigger level of source in the pattern
trigger.
<source>:= {C<x>}
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
<source>:= {C<x>}
<source>:= {C<x>}
EXAMPLE The following command sets the pattern trigger level to 0.5 V.
Command message:
:TRIGger:PATTern:LEVel C2,5.00E-01
TRIG:PATT:LEV C2,5.00E-01
Query message:
TRIG:PATT:LEV? C2
Response message:
C2,5.00E-01
:TRIGger:PATTern:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the pattern trigger
when the logic combination is AND or NOR.
The query returns the current limit range type of the pattern
trigger.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
Command message:
:TRIGger:PATTern:LIMit LESSthan
TRIG:PATT:LIM LESS
Query message:
TRIG:PATT:LIM?
Response message:
LESSthan
:TRIGger:PATTern:LOGic
Command/Query
<type>:= {AND|OR|NAND|NOR}
<logic_type>:= {AND|OR|NAND|NOR}
EXAMPLE The following command sets the logic mode of the pattern
trigger to AND.
Command message:
:TRIGger:PATTern:LOGic AND
TRIG:PATT:LOG AND
Query message:
TRIG:PATT:LOG?
Response message:
AND
:TRIGger:PATTern:TLOWer
Command/Query
DESCRIPTION The command sets the lower value of the pattern trigger limit
type when the logic combination is AND or NOR.
The query returns the current lower value of the pattern trigger
limit type.
Note:
The lower value cannot be greater than the upper value
using by the command :TRIGger:PATTern:TUPPer.
The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the lower time of the pattern
trigger to 10 ns.
Command message:
:TRIGger:PATTern:TLOWer 1.00E-08
TRIG:PATT:TLOW 1.00E-08
Query message:
TRIG:PATT:TLOW?
Response message:
1.00E-08
:TRIGger:PATTern:TUPPer
Command/Query
DESCRIPTION The command sets the upper value of the pattern trigger limit
type when the logic combination is AND or NOR.
The query returns the current upper value of the pattern trigger
limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :TRIGger:PATTern:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the upper time of the pattern
trigger to 30 ns.
Command message:
:TRIGger:PATTern:TUPPer 3.00E-08
TRIG:PATT:TUPP 3.00E-08
Query message:
TRIG:PATT:TUPP?
Response message:
3.00E-08
:TRIGger:QUALified Commands
:TRIGger:QUALified:ELEVel
:TRIGger:QUALified:ESLope
:TRIGger:QUALified:ESource
:TRIGger:QUALified:LIMit
:TRIGger:QUALified:QLEVel
:TRIGger:QUALified:QSource
:TRIGger:QUALified:TLOWer
:TRIGger:QUALified:TUPPer
:TRIGger:QUALified:TYPE
:TRIGger:QUALified:ELEVel
Command/Query
DESCRIPTION The command sets the edge trigger level of the edge source in
the qualified trigger.
The query returns the current edge trigger level in the qualified
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset
SDS6000A
, 4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
QUERY SYNTAX :TRIGger:QUALified:ELEVel?
EXAMPLE The following command sets the edge trigger level value of the
qualified trigger to 0.5 V.
Command message:
:TRIGger:QUALified:ELEVel 5.00E-01
TRIG:QUAL:ELEV 5.00E-01
Query message:
TRIG:QUAL:ELEV?
Response message:
5.00E-01
:TRIGger:QUALified:ESLope
Command/Query
DESCRIPTION The command sets the edge trigger slope in the qualified
trigger.
The query returns the current edge trigger slope in the qualified
trigger.
<type>:= {RISing|FALLing}
<type>:= {RISing|FALLing}
EXAMPLE The following command sets the edge trigger slope in the
qualified trigger to RISing.
Command message:
:TRIGger:QUALified:ESLope RISing
TRIG:QUAL:ESL RIS
Query message:
TRIG:QUAL:ESL?
Response message:
RISing
:TRIGger:QUALified:ESource
Command/Query
DESCRIPTION The command sets the edge trigger source in the qualified
trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the edge trigger source of the
qualified trigger to channel 1.
Command message:
:TRIGger:QUALified:ESource C1
TRIG:QUAL:ES C1
Query message:
TRIG:QUAL:ES?
Response message:
C1
:TRIGger:QUALified:LIMit
Command/Query
DESCRIPTION The command sets the limit range type when the qualified type
is “State with Delay” or “Edge with Delay” in the qualified
trigger.
The query returns the current limit range type in the qualified
trigger.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the limit range type to LESSthan
in the qualified trigger.
Command message:
:TRIGger:QUALified:LIMit LESSthan
TRIG:QUAL:LIM LESS
Query message:
TRIG:QUAL:LIM?
Response message:
LESSthan
:TRIGger:QUALified:QLEVel
Command/Query
DESCRIPTION The command sets the level of the qualify source in the
qualified trigger.
The query returns the current level of the qualify source in the
qualified trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the level of the qualify source in
the qualified trigger to 0.5 V.
Command message:
:TRIGger:QUALified:QLEVel 5.00E-01
TRIG:QUAL:QLEV 5.00E-01
Query message:
TRIG:QUAL:QLEV?
Response message:
5.00E-01
:TRIGger:QUALified:QSource
Command/Query
DESCRIPTION The command sets the qualify source of the qualified trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the qualify source of the qualified
trigger as channel 1.
Command message:
:TRIGger:QUALified:QSource C1
TRIG:QUAL:QS C1
Query message:
TRIG:QUAL:QS?
Response message:
C1
:TRIGger:QUALified:TLOWer
Command/Query
DESCRIPTION The command sets the limit lower value when the qualified type
is “Edge with Delay” or “State with Delay” in the qualified
trigger.
The query returns the current delay lower value in the qualified
trigger.
Note:
• The lower value cannot be greater than the upper value
using by the command :TRIGger:QUALified:TUPPer.
• The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the lower time of the qualified
trigger to 10 ns.
Command message:
:TRIGger:QUALified:TLOWer 1.00E-08
TRIG:QUAL:TLOW 1.00E-08
Query message:
TRIG:QUAL:TLOW?
Response message:
1.00E-08
:TRIGger:QUALified:TUPPer
Command/Query
DESCRIPTION The command sets limit upper value when the qualified type is
“Edge with Delay” or “State with Delay” in the qualified trigger.
The query returns the current delay upper value in the qualified
trigger.
Note:
• The upper value cannot be less than the lower value using
by the command :TRIGger:QUALified:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the delay upper value of the
qualified trigger to 30 ns.
Command message:
:TRIGger:QUALified:TUPPer 3.00E-08
TRIG:QUAL:TUPP 3.00E-08
Query message:
TRIG:QUAL:TUPP?
Response message:
3.00E-08
:TRIGger:QUALified:TYPE
Command/Query
DESCRIPTION The command sets the qualified type of the qualified trigger.
<type>:= {STATe|STATE_DLY|EDGE|EDGE_DLY}
<type>:= {STATe|STATE_DLY|EDGE|EDGE_DLY}
EXAMPLE The following command sets the qualified type of the qualified
trigger to edge.
Command message:
:TRIGger:QUALified:TYPE EDGE
TRIG:QUAL:TYPE EDGE
Query message:
TRIG:QUAL:TYPE?
Response message:
EDGE
:TRIGger:DELay Commands
:TRIGger:DELay:COUPling
:TRIGger:DELay:SOURce
:TRIGger:DELay:SOURce2
:TRIGger:DELay:SLOPe
:TRIGger:DELay:SLOPe2
:TRIGger:DELay:LEVel
:TRIGger:DELay:LEVel2
:TRIGger:DELay:LIMit
:TRIGger:DELay:TUPPer
:TRIGger:DELay:TLOWer
:TRIGger:DELay:COUPling
Command/Query
DESCRIPTION The command sets the coupling mode of the delay trigger.
<mode>:= {DC|AC|LFREJect|HFREJect}
DC coupling allows dc and ac signals into the trigger path.
AC coupling places a high-pass filter in the trigger path,
removing dc offset voltage from the trigger waveform. Use
AC coupling to get a stable edge trigger when your
waveform has a large dc offset.
HFREJect which is a high-frequency rejection filter that
adds a low-pass filter in the trigger path to remove
high-frequency components from the trigger waveform.
Use the high-frequency rejection filter to remove
high-frequency noise, such as AM or FM broadcast
stations, from the trigger path.
LFREJect which is a low frequency rejection filter adds a
high-pass filter in series with the trigger waveform to
remove any unwanted low-frequency components from a
trigger waveform, such as power line frequencies, that can
interfere with proper triggering.
<mode>:= {DC|AC|LFREJect|HFREJect}
EXAMPLE The following command sets the coupling mode of the delay
trigger to DC.
Command message:
:TRIGger:DELay:COUPling DC
TRIG:DEL:COUP DC
Query message:
TRIG:DEL:COUP?
Response message:
DC
:TRIGger:DELay:SOURce
Command/Query
DESCRIPTION The command sets the level state of trigger source A in the
delay trigger.
<state>:= {X|L|H}
X means the "don't care" state.
H means the logic high state.
L means the logic low state.
Note:
Parameters are configured to corresponding sources in the
order of C1-C<n>, D0-D15.
<state>:= {X|L|H}
EXAMPLE The following command sets the logic input for channel 1 to H,
for channel 2 to L, for channel 3 to L, for channel 4 to X and for
all digital channel to X.
Command message:
:TRIGger:DELay:SOURce
H,L,L,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X
TRIG:DEL:SOUR H,L,L,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X
Query message:
TRIG:DEL:SOUR?
Response message:
H,L,L,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X
:TRIGger:DELay:SOURce2
Command/Query
DESCRIPTION The command sets the trigger source B in the delay trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
Command message:
:TRIGger:DELay:SOURce2 C2
TRIG:DEL:SOUR2 C2
Query message:
TRIG:DEL:SOUR2?
Response message:
C2
:TRIGger:DELay:SLOPe
Command/Query
DESCRIPTION The command sets the slope of source A in the delay trigger.
<slope_type>:= {RISing|FALLing}
<slope_type>:= {RISing|FALLing}
EXAMPLE The following command sets the rising slope of source A in the
delay trigger.
Command message:
:TRIGger:DELay:SLOPe RISing
TRIG:DEL:SLOP RIS
Query message:
TRIG:DEL:SLOP?
Response message:
RISing
:TRIGger:DELay:SLOPe2
Command/Query
DESCRIPTION The command sets the slope of source B in the delay trigger.
<slope_type>:= {RISing|FALLing}
<slope_type>:= {RISing|FALLing}
EXAMPLE The following command sets the rising slope of source B in the
delay trigger.
Command message:
:TRIGger:DELay:SLOPe2 RISing
TRIG:DEL:SLOP2 RIS
Query message:
TRIG:DEL:SLOP2?
Response message:
RISing
:TRIGger:DELay:LEVel
Command/Query
DESCRIPTION The command sets the level of source A in the delay trigger.
<source>:= {C<x>}
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X [-4.1*vertical_scale-vertical_offset,
SDS2000X HD 4.1*vertical_scale-vertical_offset]
QUERY SYNTAX :TRIGger:DELay:LEVel? <source>
<source>:= {C<x>}
<source>:= {C<x>}
Command message:
:TRIGger:DELay:LEVel C2,5.00E-01
TRIG:DEL:LEV C2,5.00E-01
Query message:
TRIG:DEL:LEV? C2
Response message:
C2,5.00E-01
:TRIGger:DELay:LEVel2
Command/Query
DESCRIPTION The command sets the trigger level of source B in the delay
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X [-4.1*vertical_scale-vertical_offset,
SDS2000X HD 4.1*vertical_scale-vertical_offset]
EXAMPLE The following command sets source B level of the delay trigger
to 0.5 V
Command message:
:TRIGger:DELay:LEVel2 5.00E-01
TRIG:DEL:LEV2 5.00E-01
Query message:
TRIG:DEL:LEV2?
Response message:
5.00E-01
:TRIGger:DELay:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the delay trigger.
The query returns the current limit range type of the delay
trigger.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the limit of the delay trigger to
LESSthan.
Command message:
:TRIGger:DELay:LIMit LESSthan
TRIG:DEL:LIM LESS
Query message:
TRIG:DEL:LIM?
Response message:
LESSthan
:TRIGger:DELay:TUPPer
Command/Query
DESCRIPTION The command sets the limit upper value of the delay trigger
limit type.
The query returns the current limit upper value of the delay
trigger limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :TRIGger:DELay:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the upper value of the delay
trigger to 30 ns, when the limit range type is OUTer.
Command message:
:TRIGger:DELay:TUPPer 3.00E-08
TRIG:DEL:TUPP 3.00E-08
Query message:
TRIG:DEL:TUPP?
Response message:
3.00E-08
:TRIGger:DELay:TLOWer
Command/Query
DESCRIPTION The command sets the limit lower value of the delay trigger limit
type.
The query returns the current limit lower value of the delay
trigger limit type.
Note:
• The lower value cannot be greater than the upper value
using by the command :TRIGger:DELay:TUPPer.
• The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the lower time of the delay trigger
to 10 ns.
Command message:
:TRIGger:DELay:TLOWer 1.00E-08
TRIG:DEL:TLOW 1.00E-08
Query message:
TRIG:DEL:TLOW?
Response message:
1.00E-08
:TRIGger:NEDGe Commands
:TRIGger:NEDGe:SOURce
:TRIGger:NEDGe:SLOPe
:TRIGger:NEDGe:IDLE
:TRIGger:NEDGe:EDGE
:TRIGger:NEDGe:LEVel
:TRIGger:NEDGe:HOLDoff
:TRIGger:NEDGe:HLDTime
:TRIGger:NEDGe:HLDEVent
:TRIGger:NEDGe:HSTart
:TRIGger:NEDGe:NREJect
:TRIGger:NEDGe:SOURce
Command/Query
DESCRIPTION The command sets the trigger source of the Nth edge trigger.
The query returns the current trigger source of the Nth edge
trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the trigger source of the Nth edge
trigger as C1.
Command message:
:TRIGger:NEDGe:SOURce C1
TRIG:NEDG:SOUR C1
Query message:
TRIG:NEDG:SOUR?
Response message:
C1
:TRIGger:NEDGe:SLOPe
Command/Query
DESCRIPTION The command sets the slope of the Nth edge trigger.
The query returns the current slope setting of the Nth edge
trigger.
<slope_type>:= {RISing|FALLing}
<slope_type>:= {RISing|FALLing}
EXAMPLE The following command sets the rising slope of the Nth edge
trigger.
Command message:
:TRIGger:NEDGe:SLOPe RISing
TRIG:NEDG:SLOP RIS
Query message:
TRIG:NEDG:SLOP?
Response message:
RISing
:TRIGger:NEDGe:IDLE
Command/Query
DESCRIPTION The command sets the idle time of the Nth edge trigger.
The query returns the current idle time of the Nth edge trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS5000X
SDS6000 Pro
SDS6000A [8.00E-09, 2.00E+01]
SDS6000L
SDS2000X HD
EXAMPLE The following command sets the idle time of the Nth edge
trigger to 15 ns.
Command message:
:TRIGger:NEDGe:IDLE 1.50E-08
TRIG:NEDG:IDLE 1.50E-08
Query message:
TRIG:NEDG:IDLE?
Response message:
1.50E-08
:TRIGger:NEDGe:EDGE
Command/Query
DESCRIPTION This command sets the edge num of the Nth edge trigger.
The query returns the current edge num of the Nth edge trigger.
EXAMPLE The following command sets the edge num of the Nth edge
trigger to 3.
Command message:
:TRIGger:NEDGe:EDGE 3
TRIG:NEDG:EDGE 3
Query message:
TRIG:NEDG:EDGE?
Response message:
3
:TRIGger:NEDGe:LEVel
Command/Query
DESCRIPTION The command sets the trigger level of the Nth edge trigger.
The query returns the current trigger level value of the Nth edge
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X [-4.1*vertical_scale-vertical_offset,
SDS2000X HD 4.1*vertical_scale-vertical_offset]
QUERY SYNTAX :TRIGger:NEDGe:LEVel?
EXAMPLE The following command sets the trigger level of the Nth edge
trigger to 0.5 V.
Command message:
:TRIGger:NEDGe:LEVel 5.00E-01
TRIG:NEDG:LEV 5.00E-01
Query message:
TRIG:NEDG:LEV?
Response message:
5.00E-01
:TRIGger:NEDGe:HOLDoff
Command/Query
DESCRIPTION The command selects the holdoff type of the Nth edge trigger.
The query returns the current holdoff type of the Nth edge
trigger.
<holdoff_type>:= {OFF|EVENts|TIME}
OFF means to turn off the holdoff.
EVENts means the number of trigger events that the
oscilloscope counts before re-arming the trigger circuitry.
TIME means the amount of time that the oscilloscope waits
before re-arming the trigger circuitry.
<holdoff_type>:= {OFF|EVENts|TIME}
EXAMPLE The following command turns off the holdoff of the Nth edge
trigger.
Command message:
:TRIGger:NEDGe:HOLDoff OFF
TRIG:NEDG:HOLD OFF
Query message:
TRIG:NEDG:HOLD?
Response message:
OFF
:TRIGger:NEDGe:HLDTime
Command/Query
DESCRIPTION The command sets the holdoff time of the Nth edge trigger.
The query returns the current holdoff time of the Nth edge
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS5000X
SDS6000 Pro
SDS6000A [8.00E-09, 3.00E+01]
SDS6000L
SDS2000X HD
EXAMPLE The following command sets the holdoff time of the Nth edge
trigger to 15 ns.
Command message:
:TRIGger:NEDGe:HLDTime 1.50E-08
TRIG:NEDG:HLDT 1.50E-08
Query message:
TRIG:NEDG:HLDT?
Response message:
1.50E-08
:TRIGger:NEDGe:HLDEVent
Command/Query
DESCRIPTION This command sets the number of holdoff events of the Nth
edge trigger.
Command message:
:TRIGger:NEDGe:HLDEVent 3
TRIG:NEDG:HLDEV 3
Query message:
TRIG:NEDG:HLDEV?
Response message:
3
:TRIGger:NEDGe:HSTart
Command/Query
DESCRIPTION The command defines the initial position of the Nth edge trigger
holdoff.
The query returns the initial position of the Nth edge trigger
holdoff.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
LAST_TRIG means the initial position of holdoff is the first
time point satisfying the trigger condition.
ACQ_START means the initial position of holdoff is the
time of the last trigger.
<start_holdoff>:= {LAST_TRIG|ACQ_START}
EXAMPLE The following command sets the start holdoff mode to last
trigger.
Command message:
:TRIGger:NEDGe:HSTart LAST_TRIG
TRIG:NEDG:HST LAST_TRIG
Query message:
TRIG:NEDG:HST?
Response message:
LAST_TRIG
:TRIGger:NEDGe:NREJect
Command/Query
<state>:= {OFF|ON}
<state>:= {OFF|ON}
Command message:
:TRIGger:NEDGe:NREJect ON
TRIG:NEDG:NREJ ON
Query message:
TRIG:NEDG:NREJ?
Response message:
ON
:TRIGger:SHOLd Commands
:TRIGger:SHOLd:TYPE
:TRIGger:SHOLd:CSource
:TRIGger:SHOLd:CTHReshold
:TRIGger:SHOLd:SLOPe
:TRIGger:SHOLd:DSource
:TRIGger:SHOLd:DTHReshold
:TRIGger:SHOLd:LEVel
:TRIGger:SHOLd:LIMit
:TRIGger:SHOLd:TUPPer
:TRIGger:SHOLd:TLOWer
:TRIGger:SHOLd:TYPE
Command/Query
DESCRIPTION The command sets the trigger type of the setup/hold trigger.
The query returns the current the trigger type of the setup/hold
trigger.
<type>:= {SETup|HOLD}
<slope>:= {SETup|HOLD}
EXAMPLE The following command sets the setup type of the setup/hold
trigger.
Command message:
:TRIGger:SHOLd:TYPE SETup
TRIG:SHOL:TYPE SET
Query message:
TRIG:SHOL:TYPE?
Response message:
SETup
:TRIGger:SHOLd:CSource
Command/Query
DESCRIPTION The command sets the clock source of the setup/hold trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the clock source of the setup/hold
trigger as C1.
Command message:
:TRIGger:SHOLd:CSource C1
TRIG:SHOL:CS C1
Query message:
TRIG:SHOL:CS?
Response message:
C1
:TRIGger:SHOLd:CTHReshold
Command/Query
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X [-4.1*vertical_scale-vertical_offset,
SDS2000X HD 4.1*vertical_scale-vertical_offset]
Command message:
:TRIGger:SHOLd:CTHReshold 1.50E+00
TRIG:SHOL:CTHR 1.50E+00
Query message:
TRIG:SHOL:CTHR?
Response message:
1.50E+00
:TRIGger:SHOLd:SLOPe
Command/Query
DESCRIPTION The command sets the clock slope of the setup/hold trigger.
The query returns the current the clock slope of the setup/hold
trigger.
<slope_type>:= {RISing|FALLing}
<slope_type>:= {RISing|FALLing}
EXAMPLE The following command sets the clock slope of the setup/hold
trigger to rising.
Command message:
:TRIGger:SHOLd:SLOPe RISing
TRIG:SHOL:SLOP RIS
Query message:
TRIG:SHOL:SLOP?
Response message:
RISing
:TRIGger:SHOLd:DSource
Command/Query
DESCRIPTION The command sets the data source of the setup/hold trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the data source of the setup/hold
trigger as C1.
Command message:
:TRIGger:SHOLd:DSource C1
TRIG:SHOL:DS C1
Query message:
TRIG:SHOL:DS?
Response message:
C1
:TRIGger:SHOLd:DTHReshold
Command/Query
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X [-4.1*vertical_scale-vertical_offset,
SDS2000X HD 4.1*vertical_scale-vertical_offset]
Command message:
:TRIGger:SHOLd:DTHReshold 1.50E+00
TRIG:SHOL:DTHR 1.50E+00
Query message:
TRIG:SHOL:DTHR?
Response message:
1.50E+00
:TRIGger:SHOLd:LEVel
Command/Query
DESCRIPTION The command sets the level state of data source of the
setup/hold trigger.
The query returns the current level state of data source of the
setup/hold trigger.
<level_value>:= {LOW|HIGH}
<level_value>:= {LOW|HIGH}
EXAMPLE The following command sets the high level of data source of
the setup/hold trigger.
Command message:
:TRIGger:SHOLd:LEVel HIGH
TRIG:SHOL:LEV HIGH
Query message:
TRIG:SHOL:LEV?
Response message:
HIGH
:TRIGger:SHOLd:LIMit
Command/Query
DESCRIPTION The command sets the limit range type of the setup/hold
trigger.
The query returns the current limit range type of the setup/hold
trigger.
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
<type>:= {LESSthan|GREATerthan|INNer|OUTer}
EXAMPLE The following command sets the limit of the setup/hold trigger
to LESSthan.
Command message:
:TRIGger:SHOLd:LIMit LESSthan
TRIG:SHOL:LIM LESS
Query message:
TRIG:SHOL:LIM?
Response message:
LESSthan
:TRIGger:SHOLd:TUPPer
Command/Query
DESCRIPTION The command sets the upper value of the setup/hold trigger
limit type.
Note:
• The upper value cannot be less than the lower value using
by the command :TRIGger:SHOLd:TLOWer.
• The command is not valid when the limit range type is
GREATerthan.
EXAMPLE The following command sets the upper value of the setup/hold
trigger to 30 ns, when the limit range type is OUTer.
Command message:
:TRIGger:SHOLd:TUPPer 3.00E-08
TRIG:SHOL:TUPP 3.00E-08
Query message:
TRIG:SHOL:TUPP?
Response message:
3.00E-08
:TRIGger:SHOLd:TLOWer
Command/Query
DESCRIPTION The command sets the lower value of the setup/hold trigger
limit type.
Note:
The lower value cannot be greater than the upper value using
by the command :TRIGger:SHOLd:TUPPer.
The command is not valid when the limit range type is
LESSthan.
EXAMPLE The following command sets the lower time of the setup/hold
trigger to 10 ns.
Command message:
:TRIGger:SHOLd:TLOWer 1.00E-08
TRIG:SHOL:TLOW 1.00E-08
Query message:
TRIG:SHOL:TLOW?
Response message:
1.00E-08
:TRIGger:IIC Commands
The :TRIGGER:IIC subsystem commands control the IIC bus trigger parameters.
:TRIGger:IIC:ADDRess
:TRIGger:IIC:ALENgth
:TRIGger:IIC:CONDition
:TRIGger:IIC:DAT2
:TRIGger:IIC:DATA
:TRIGger:IIC:DLENgth
:TRIGger:IIC:LIMit
:TRIGger:IIC:RWBit
:TRIGger:IIC:SCLSource
:TRIGger:IIC:SCLThreshold
:TRIGger:IIC:SDASource
:TRIGger:IIC:SDAThreshold
:TRIGger:IIC:ADDRess
Command/Query
DESCRIPTION The command sets the address of the IIC bus trigger.
The query returns the current address of the IIC bus trigger.
EXAMPLE The following command sets the address of the IIC bus trigger
to 0x0a.
Command message:
:TRIGger:IIC:ADDRess 10
TRIG:IIC:ADDR 10
Query message:
TRIG:IIC:ADDR?
Response message:
10
:TRIGger:IIC:ALENgth
Command/Query
DESCRIPTION The command sets the length of address of the IIC bus trigger.
The query returns the current length of address of the IIC bus
trigger.
<length>:= {7BIT|10BIT}
<addr_length>:= {7BIT|10BIT}
EXAMPLE The following command sets the length of address of the IIC bus
trigger to 10 bit.
Command message:
:TRIGger:IIC:ALENgth 10BIT
TRIG:IIC:ALEN 10BIT
Query message:
TRIG:IIC:ALEN?
Response message:
10BIT
:TRIGger:IIC:CONDition
Command/Query
DESCRIPTION The command sets the trigger condition of the IIC bus.
The query returns the current trigger condition of the IIC bus.
<condition>:=
{STARt|STOP|RESTart|NACK|EEPRom|7ADDRess|10ADDRe
ss|DLENgth}
<condition>:=
{STARt|STOP|RESTart|NACK|EEPRom|7ADDRess|10ADDRe
ss|DLENgth}
EXAMPLE The following command sets the condition of the IIC bus trigger
to STOP.
Command message:
:TRIGger:IIC:CONDition STOP
TRIG:IIC:COND STOP
Query message:
TRIG:IIC:COND?
Response message:
STOP
:TRIGger:IIC:DAT2
Command/Query
DESCRIPTION The command sets the data2 of the IIC bus trigger.
The query returns the current data2 of the IIC bus trigger.
Note:
Use the don’t care data (256) to ignore the data2 value.
EXAMPLE The following command sets the data2 of the IIC bus trigger to
0x0b.
Command message:
:TRIGger:IIC:DAT2 11
TRIG:IIC:DAT2 11
Query message:
TRIG:IIC:DAT2?
Response message:
11
:TRIGger:IIC:DATA
Command/Query
DESCRIPTION The command sets the data of the IIC bus trigger.
The query returns the current data of the IIC bus trigger.
Note:
Use the don’t care data (256) to ignore the data value.
EXAMPLE The following command sets the data of the IIC bus trigger to
0x2A.
Command message:
:TRIGger:IIC:DATA 42
TRIG:IIC:DATA 42
Query message:
TRIG:IIC:DATA?
Response message:
42
:TRIGger:IIC:DLENgth
Command/Query
DESCRIPTION The command sets the data length of the IIC bus trigger.
The query returns the current data length of the IIC bus trigger.
EXAMPLE The following command sets the data length of the IIC bus
trigger to 10 bytes.
Command message:
:TRIGger:IIC:DLENgth 10
TRIG:IIC:DLEN 10
Query message:
TRIG:IIC:DLEN?
Response message:
10
:TRIGger:IIC:LIMit
Command/Query
DESCRIPTION The command sets the data comparison type when the trigger
condition is EEPROM on the IIC bus trigger.
The query returns the current the limit range type when the
trigger condition is EEPROM.
<limit_type>:= {EQUal|GREaterthan|LESSthan}
<limit_type>:= {EQUal|GREaterthan|LESSthan}
EXAMPLE The following command sets the limit range type when the
trigger condition is EEPROM to LESSthan.
Command message:
:TRIGger:IIC:LIMit LESSthan
TRIG:IIC:LIM LESS
Query message:
TRIG:IIC:LIM?
Response message:
LESSthan
:TRIGger:IIC:RWBit
Command/Query
DESCRIPTION The command sets whether the trigger frame is read address
or write address when the IIC trigger condition is 7 or 10
ADDR&DATA.
The query returns the current read write bit of the IIC bus
trigger.
<type>:= {WRITe|READ|ANY}
<type>:= {WRITe|READ|ANY}
Command message:
:TRIGger:IIC:RWBit READ
TRIG:IIC:RWB READ
Query message:
TRIG:IIC:RWB?
Response message:
READ
:TRIGger:IIC:SCLSource
Command/Query
DESCRIPTION The command selects the SCL source of the IIC bus trigger.
This query returns the current SCL source of the IIC bus trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command selects the SCL source of the IIC bus
trigger as channel 2.
Command message:
:TRIGger:IIC:SCLSource C2
TRIG:IIC:SCLS C2
Query message:
TRIG:IIC:SCLS?
Response message:
C2
:TRIGger:IIC:SCLThreshold
Command/Query
DESCRIPTION The command sets the threshold of the SCL on IIC bus trigger.
This query returns the current threshold of the SCL on IIC bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the SCL on IIC bus
trigger to 1.5 V.
Command message:
:TRIGger:IIC:SCLThreshold 1.50E+00
TRIG:IIC:SCLT 1.50E+00
Query message:
TRIG:IIC:SCLT?
Response message:
1.50E+00
:TRIGger:IIC:SDASource
Command/Query
DESCRIPTION The command selects the SDA source of the IIC bus trigger.
This query returns the current SDA source of the IIC bus trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command selects the SDA source of the IIC bus
trigger as channel 2.
Command message:
:TRIGger:IIC:SDASource C2
TRIG:IIC:SDAS C2
Query message:
TRIG:IIC:SDAS?
Response message:
C2
:TRIGger:IIC:SDAThreshold
Command/Query
DESCRIPTION The command sets the threshold of the SDA on IIC bus trigger.
This query returns the current threshold of the SDA on IIC bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset,
SDS6000L 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
QUERY SYNTAX :TRIGger:IIC:SDAThreshold?
EXAMPLE The following command sets the threshold of the SDA on IIC bus
trigger to 1.5 V.
Command message:
:TRIGger:IIC:SDAThreshold 1.50E+00
TRIG:IIC:SDAT 1.50E+00
Query message:
TRIG:IIC:SDAT?
Response message:
1.50E+00
:TRIGger:SPI Commands
The :TRIGGER:SPI subsystem commands control the SPI bus trigger modes and parameters.
:TRIGger:SPI:BITorder
:TRIGger:SPI:CLKSource
:TRIGger:SPI:CLKThreshold
:TRIGger:SPI:CSSource
:TRIGger:SPI:CSThreshold
:TRIGger:SPI:CSTYpe
:TRIGger:SPI:DATA
:TRIGger:SPI:DLENgth
:TRIGger:SPI:LATChedge
:TRIGger:SPI:MISOSource
:TRIGger:SPI:MISOThreshold
:TRIGger:SPI:MOSISource
:TRIGger:SPI:MOSIThreshold
:TRIGger:SPI:NCSSource
:TRIGger:SPI:NCSThreshold
:TRIGger:SPI:TTYPe
:TRIGger:SPI:BITorder
Command/Query
DESCRIPTION The command sets the bit order of the SPI bus trigger.
The query returns the current bit order of the SPI bus trigger.
<bit_order>:= {LSM|MSB}
<bit_order>:= {LSM|MSB}
EXAMPLE The following command sets the bit order of the SPI bus trigger
to LSB.
Command message:
:TRIGger:SPI:BITorder LSB
TRIG:SPI:BIT LSB
Query message:
TRIG:SPI:BIT?
Response message:
LSB
:TRIGger:SPI:CLKSource
Command/Query
DESCRIPTION The command selects the CLK source of the SPI bus trigger.
This query returns the current CLK source of the SPI bus trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command selects the CLK source of the SPI bus
trigger as channel 2.
Command message:
:TRIGger:SPI:CLKSource C2
TRIG:SPI:CLKS C2
Query message:
TRIG:SPI:CLKS?
Response message:
C2
:TRIGger:SPI:CLKThreshold
Command/Query
DESCRIPTION The command sets the threshold of the CLK on SPI bus trigger.
This query returns the current threshold of the CLK on SPI bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the CLK on SPI bus
trigger to 1.5 V.
Command message:
:TRIGger:SPI:CLKThreshold 1.50E+00
TRIG:SPI:CLKT 1.50E+00
Query message:
TRIG:SPI:CLKT?
Response message:
1.50E+00
:TRIGger:SPI:CSSource
Command/Query
DESCRIPTION The command sets the CS source of the SPI bus trigger.
The query returns the current CS source of the SPI bus trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
<x>:= 1 to (# analog channels) in NR1 format, including an
integer and no decimal point, like 1.
EXAMPLE The following command selects the CS source of the SPI bus
trigger as channel 2.
Command message:
:TRIGger:SPI:CSSource C2
TRIG:SPI:CSS C2
Query message:
TRIG:SPI:CSS?
Response message:
C2
:TRIGger:SPI:CSThreshold
Command/Query
DESCRIPTION The command sets the threshold of the CS on SPI bus trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
QUERY SYNTAX :TRIGger:SPI:CSThreshold?
EXAMPLE The following command sets the threshold of the CS on SPI bus
trigger to 1.5 V.
Command message:
:TRIGger:SPI:CSThreshold 1.50E+00
TRIG:SPI:CST 1.50E+00
Query message:
TRIG:SPI:CST?
Response message:
1.50E+00
:TRIGger:SPI:CSTYpe
Command/Query
DESCRIPTION The command sets the chip selection type of the SPI bus trigger.
This query returns the current chip selection type of the SPI bus
trigger.
<type>:= {NCS|CS|TIMeout[,<time>]}
CS means set to chip select state
NCS means set to non-chip select state
TIMeout indicates set to clock timeout status
<type>:= {NCS|CS|TIMeout[,<time>]}
EXAMPLE The following command sets the chip selection type of the SPI bus
trigger to CS.
Command message:
:TRIGger:SPI:CSTYpe CS
TRIG:SPI:CSTY CS
Query message:
TRIG:SPI:CSTY?
Response message:
CS
:TRIGger:SPI:DATA
Command
DESCRIPTION The command sets the data of the SPI bus trigger.
<data>:= {0|1|X}
Note:
• The number of parameters should be consistent with the
data length using by the
command :TRIGger:SPI:DLENgth.
• Parameters are assigned to each bit in order from high to
low.
EXAMPLE The following command sets the data of the SPI bus trigger to
0x82 when the data length is 8.
Command message:
:TRIGger:SPI:DATA 1,0,0,0,0,0,1,0
TRIG:SPI:DATA 1,0,0,0,0,0,1,0
:TRIGger:SPI:DLENgth
Command/Query
DESCRIPTION The command sets the data length of the SPI bus trigger.
The query returns the current data length of the SPI bus trigger.
EXAMPLE The following command sets the data length of the SPI bus
trigger to 10 bit.
Command message:
:TRIGger:SPI:DLENgth 10
TRIG:SPI:DLEN 10
Query message:
TRIG:SPI:DLEN?
Response message:
10
:TRIGger:SPI:LATChedge
Command/Query
DESCRIPTION The command selects the sampling edge of CLK on SPI bus
trigger.
<slope>:= {RISing|FALLing}
<slope>:= {RISing|FALLing}
Command message:
:TRIGger:SPI:LATChedge RISing
:TRIG:SPI:LATC RIS
Query message:
:TRIG:SPI:LATC?
Response message:
RISing
:TRIGger:SPI:MISOSource
Command/Query
DESCRIPTION The command selects the MISO source of the SPI bus trigger.
This query returns the current MISO source of the SPI bus
trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command selects the MISO source of the SPI bus
trigger as channel 2.
Command message:
:TRIGger:SPI:MISOSource C2
TRIG:SPI:MISOS C2
Query message:
TRIG:SPI:MISOS?
Response message:
C2
:TRIGger:SPI:MISOThreshold
Command/Query
DESCRIPTION The command sets the threshold of the MISO on SPI bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the MISO on SPI
bus trigger to 1.5 V.
Command message:
:TRIGger:SPI:MISOThreshold 1.50E+00
TRIG:SPI:MISOT 1.50E+00
Query message:
TRIG:SPI:MISOT?
Response message:
1.50E+00
:TRIGger:SPI:MOSISource
Command/Query
DESCRIPTION The command selects the MOSI source of the SPI bus trigger.
This query returns the current MOSI source of the SPI bus
trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command selects the MOSI source of the SPI bus
trigger as channel 2.
Command message:
:TRIGger:SPI:MOSISource C2
TRIG:SPI:MOSIS C2
Query message:
TRIG:SPI:MOSIS?
Response message:
C2
:TRIGger:SPI:MOSIThreshold
Command/Query
DESCRIPTION The command sets the threshold of the MOSI on SPI bus
trigger.
The query returns the current threshold of the MOSI on SPI bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset,
SDS6000L 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the MOSI on SPI
bus trigger to 1.5 V.
Command message:
:TRIGger:SPI:MOSIThreshold 1.50E+00
TRIG:SPI:MOSIT 1.50E+00
Query message:
TRIG:SPI:MOSIT?
Response message:
1.50E+00
:TRIGger:SPI:NCSSource
Command/Query
DESCRIPTION The command sets the NCS source of the SPI bus trigger.
The query returns the current NCS source of the SPI bus
trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command selects the NCS source of the SPI bus
trigger as D0.
Command message:
:TRIGger:SPI:NCSSource D0
:TRIG:SPI:NCSS D0
Query message:
:TRIG:SPI:NCSS?
Response message:
D0
:TRIGger:SPI:NCSThreshold
Command/Query
DESCRIPTION The command sets the threshold of the NCS on SPI bus
trigger.
This query returns the current threshold of the NCS on SPI bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the NCS on IIC
bus trigger to 1.5 V.
Command message:
:TRIGger:SPI:NCSThreshold 1.50E+00
TRIG:SPI:NCST 1.50E+00
Query message:
TRIG:SPI:NCST?
Response message:
1.50E+00
:TRIGger:SPI:TTYPe
Command/Query
DESCRIPTION The command sets the trigger type of the SPI bus trigger.
The query returns the current trigger type of the SPI bus trigger.
<trigger_type>:= {MISO|MOSI}
<trigger_type>:= {MISO|MOSI}
EXAMPLE The following command sets the trigger type of the SPI bus
trigger to MOSI.
Command message:
:TRIGger:SPI:TTYPe MOSI
TRIG:SPI:TTYP MOSI
Query message:
TRIG:SPI:TTYP?
Response message:
MOSI
:TRIGger:UART Commands
The :TRIGGER:UART subsystem commands control the UART bus trigger parameters.
:TRIGger:UART:BAUD
:TRIGger:UART:BITorder
:TRIGger:UART:CONDition
:TRIGger:UART:DATA
:TRIGger:UART:DLENgth
:TRIGger:UART:IDLE
:TRIGger:UART:LIMit
:TRIGger:UART:PARity
:TRIGger:UART:RXSource
:TRIGger:UART:RXThreshold
:TRIGger:UART:STOP
:TRIGger:UART:TTYPe
:TRIGger:UART:TXSource
:TRIGger:UART:TXThreshold
:TRIGger:UART:BAUD
Command/Query
DESCRIPTION The command sets the baud rate of the UART bus trigger.
The query returns the current baud rate of the UART bus
trigger.
<baud>:=
{600bps|1200bps|2400bps|4800bps|9600bps|19200bps|38400
bps|57600bps|115200bps|CUSTom[,<value>]}
<baud>:=
{600bps|1200bps|2400bps|4800bps|9600bps|19200bps|38400
bps|57600bps|115200bps|CUSTom[,<value>]}
EXAMPLE The following command sets the baud rate of the UART bus
trigger to 9600bps.
Command message:
:TRIGger:UART:BAUD 9600bps
TRIG:UART:BAUD 9600bps
Query message:
TRIG:UART:BAUD?
Response message:
9600bps
:TRIGger:UART:BITorder
Command/Query
DESCRIPTION The command sets the bit order of the UART trigger.
The query returns the current bit order of the UART trigger.
<order>:= {LSM|MSB}
<order>:= {LSM|MSB}
Command message:
:TRIGger:UART:BITorder LSB
TRIG:UART:BIT LSB
Query message:
TRIG:UART:BIT?
Response message:
LSB
:TRIGger:UART:CONDition
Command/Query
DESCRIPTION The command sets the condition of the UART bus trigger.
<condition>:= {STARt|STOP|DATA|ERRor}
<condition>:= {STARt|STOP|DATA|ERRor}
EXAMPLE The following command sets the condition of the UART bus
trigger to STOP.
Command message:
:TRIGger:UART:CONDition STOP
TRIG:UART:COND STOP
Query message:
TRIG:UART:COND?
Response message:
STOP
:TRIGger:UART:DATA
Command/Query
DESCRIPTION The command sets the data of the UART bus trigger.
The query returns the current data of the UART bus trigger.
Note:
• The range of the value is related to data length by using
the command :TRIGger:UART:DLENgth.
• Use the don’t care data (256, data length is 8) to ignore the
data value.
EXAMPLE The following command sets the data of the UART bus trigger
to 0x53.
Command message:
:TRIGger:UART:DATA 83
TRIG:UART:DATA 83
Query message:
TRIG:UART:DATA?
Response message:
83
:TRIGger:UART:DLENgth
Command/Query
DESCRIPTION The command sets the data length of the UART bus trigger.
The query returns the current data length of the UART bus
trigger.
EXAMPLE The following command sets the data length of the UART bus
trigger to 8.
Command message:
:TRIGger:UART:DLENgth 8
TRIG:UART:DLEN 8
Query message:
TRIG:UART:DLEN?
Response message:
8
:TRIGger:UART:IDLE
Command/Query
DESCRIPTION The command sets the idle level of the UART bus trigger.
The query returns the current idle level of the UART bus trigger.
<idle>:= {LOW|HIGH}
<idle>:= {LOW|HIGH}
EXAMPLE The following command sets the idle level of the UART bus
trigger as LOW.
Command message:
:TRIGger:UART:IDLE LOW
TRIG:UART:IDLE LOW
Query message:
TRIG:UART:IDLE?
Response message:
LOW
:TRIGger:UART:LIMit
Command/Query
DESCRIPTION The command sets the data comparison type of the UART bus
trigger when the trigger condition is Data.
<limit_type>:= {EQUal|GREaterthan|LESSthan}
<limit_type>:= {EQUal|GREaterthan|LESSthan}
EXAMPLE The following command sets the limit of the UART bus trigger
to LESSthan.
Command message:
:TRIGger:UART:LIMit LESSthan
TRIG:UART:LIM LESS
Query message:
TRIG:UART:LIM?
Response message:
LESSthan
:TRIGger:UART:PARity
Command/Query
DESCRIPTION The command sets the parity check of the UART bus trigger.
The query returns the current parity check of the UART bus
trigger.
<parity>:= {NONE|ODD|EVEN|MARK|SPACe}
<parity_check>:= {NONE|ODD|EVEN|MARK|SPACe}
EXAMPLE The following command sets the parity check of the UART bus
trigger to odd.
Command message:
:TRIGger:UART:PARity ODD
TRIG:UART:PAR ODD
Query message:
TRIG:UART:PAR?
Response message:
ODD
:TRIGger:UART:RXSource
Command/Query
DESCRIPTION The command sets the RX source of the UART bus trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
Command message:
:TRIGger:UART:RXSource C2
TRIG:UART:RXS C2
Query message:
TRIG:UART:RXS?
Response message:
C2
:TRIGger:UART:RXThreshold
Command/Query
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
QUERY SYNTAX :TRIGger:UART:RXThreshold?
Command message:
:TRIGger:UART:RXThreshold 1.50E+00
TRIG:UART:RXT 1.50E+00
Query message:
TRIG:UART:RXT?
Response message:
1.50E+00
:TRIGger:UART:STOP
Command/Query
DESCRIPTION The command sets the length of the stop bit on UART bus
trigger.
The query returns the current length of the stop bit on UART
bus trigger.
<bit>:= {1|1.5|2}
<bit>:= {1|1.5|2}
EXAMPLE The following command sets the length of the stop bit on UART
bus trigger to 1 bit.
Command message:
:TRIGger:UART:STOP 1
TRIG:UART:STOP 1
Query message:
TRIG:UART:STOP?
Response message:
1
:TRIGger:UART:TTYPe
Command/Query
DESCRIPTION The command sets the trigger type of the UART bus trigger.
The query returns the current trigger type of the UART bus
trigger.
<trigger_type>:= {RX|TX}
<trigger_type>:= {RX|TX}
EXAMPLE The following command sets the trigger type of the UART bus
trigger to RX.
Command message:
:TRIGger:UART:TTYPe RX
TRIG:UART:TTYP RX
Query message:
TRIG:UART:TTYP?
Response message:
RX
:TRIGger:UART:TXSource
Command/Query
DESCRIPTION The command sets the TX source of the UART bus trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the TX source of the UART bus
trigger as channel 2.
Command message:
:TRIGger:UART:TXSource C2
TRIG:UART:TXS C2
Query message:
TRIG:UART:TXS?
Response message:
C2
:TRIGger:UART:TXThreshold
Command/Query
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset,
SDS6000L 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:TRIGger:UART:TXThreshold 1.50E+00
TRIG:UART:TXT 1.50E+00
Query message:
TRIG:UART:TXT?
Response message:
1.50E+00
:TRIGger:CAN Commands
The :TRIGGER:CAN subsystem commands control the CAN bus trigger parameters.
:TRIGger:CAN:BAUD
:TRIGger:CAN:CONDition
:TRIGger:CAN:DAT2
:TRIGger:CAN:DATA
:TRIGger:CAN:ID
:TRIGger:CAN:IDLength
:TRIGger:CAN:SOURce
:TRIGger:CAN:THReshold
:TRIGger:CAN:BAUD
Command/Query
DESCRIPTION The command sets the baud rate of the CAN bus trigger.
The command query returns the baud rate of the CAN bus
trigger.
<baud>:=
{5kbps|10kbps|20kbps|50kbps|100kbps|125kbps|250kbps|500
kbps|800kbps|1Mbps|CUSTom[,<value>]}
<baud>:=
{5kbps|10kbps|20kbps|50kbps|100kbps|125kbps|250kbps|500
kbps|800kbps|1Mbps|CUSTom[,<value>]}
EXAMPLE This command sets the baud rate of the CAN bus trigger to
20kbps.
Command message:
:TRIGger:CAN:BAUD 20kbps
TRIG:CAN:BAUD 20kbps
Query message:
TRIG:CAN:BAUD?
Response message:
20kbps
:TRIGger:CAN:CONDition
Command/Query
DESCRIPTION The command sets the trigger condition for the CAN bus
trigger.
The query returns the current trigger condition for the CAN bus
trigger.
<condition>:= {STARt|REMote|ID|ID_AND_DATA|ERRor}
<condition>:= {STARt|REMote|ID|ID_AND_DATA|ERRor}
EXAMPLE The following command sets the trigger condition for the CAN
bus trigger to start.
Command message:
:TRIGger:CAN:CONDition STARt
TRIG:CAN:COND STAR
Query message:
TRIG:CAN:COND?
Response message:
STARt
:TRIGger:CAN:DAT2
Command/Query
DESCRIPTION The command sets the data2 of the CAN bus trigger.
The query returns the current data2 of the CAN bus trigger.
Note:
Use the don’t care data (256) to ignore the data2 value.
EXAMPLE The following command sets the CAN bus triggered data 2 to
0x49.
Command message:
:TRIGger:CAN:DAT2 73
TRIG:CAN:DAT2 73
Query message:
TRIG:CAN:DAT2?
Response message:
73
:TRIGger:CAN:DATA
Command/Query
DESCRIPTION The command sets the data of the CAN bus trigger.
The query returns the current data of the CAN bus trigger.
Note:
Use the don’t care data (256) to ignore the data value.
EXAMPLE The following command sets the data of the CAN bus triggered
to 0x43.
Command message:
:TRIGger:CAN:DATA 67
TRIG:CAN:DATA 67
Query message:
TRIG:CAN:DATA?
Response message:
67
:TRIGger:CAN:ID
Command/Query
Note:
Use the don’t care data (536870912, ID length is 29 bits) to
ignore the ID value.
EXAMPLE The following command sets the ID of the CAN bus trigger to
0x7819F51.
Command message:
:TRIGger:CAN:ID 125935441
TRIG:CAN:ID 125935441
Query message:
TRIG:CAN:ID?
Response message:
125935441
:TRIGger:CAN:IDLength
Command/Query
DESCRIPTION The command sets the ID length of the CAN bus trigger when
the trigger condition is Remote, ID or ID+Data.
The query returns the current ID length of the CAN bus trigger.
<id_length>:= {11BITS|29BITS}
<id_length>:= {11BITS|29BITS}
EXAMPLE The following command sets the ID length of the CAN trigger to
29BITS.
Command message:
:TRIGger:CAN:IDLength 29BITS
TRIG:CAN:IDL 29BITS
Query message:
TRIG:CAN:IDL?
Response message:
29BITS
:TRIGger:CAN:SOURce
Command/Query
DESCRIPTION The command selects the source of the CAN bus trigger.
The query returns the current source of the CAN bus trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE This following command sets the source of the CAN bus trigger
to C2.
Command message:
:TRIGger:CAN:SOURce C2
TRIG:CAN:SOUR C2
Query message:
TRIG:CAN:SOUR?
Response message:
C2
:TRIGger:CAN:THReshold
Command/Query
DESCRIPTION The command sets the threshold of the source on CAN bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset,
SDS6000L 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
Command message:
:TRIGger:CAN:THReshold 1.50E+00
TRIG:CAN:THR 1.50E+00
Query message:
TRIG:CAN:THR?
Response message:
1.50E+00
:TRIGger:LIN Commands
The :TRIGGER:LIN subsystem commands control the LIN bus trigger parameters.
:TRIGger:LIN:BAUD
:TRIGger:LIN:CONDition
:TRIGger:LIN:DAT2
:TRIGger:LIN:DATA
:TRIGger:LIN:ERRor:CHECksum
:TRIGger:LIN:ERRor:DLENgth
:TRIGger:LIN:ERRor:ID
:TRIGger:LIN:ERRor:PARity
:TRIGger:LIN:ERRor:SYNC
:TRIGger:LIN:ID
:TRIGger:LIN:SOURce
:TRIGger:LIN:STANdard
:TRIGger:LIN:THReshold
:TRIGger:LIN:BAUD
Command/Query
DESCRIPTION The command sets the baud rate of the LIN bus trigger.
The query returns the current baud rate of the LIN bus trigger.
<baud>:=
{600bps|1200bps|2400bps|4800bps|9600bps|19200bps|CUST
om[,<value>]}
<baud>:=
{600bps|1200bps|2400bps|4800bps|9600bps|19200bps|CUST
om[,<value>]}
EXAMPLE The following command sets the baud rate of the LIN bus
trigger to 9600bps.
Command message:
:TRIGger:LIN:BAUD 9600bps
:TRIG:LIN:BAUD 9600bps
Query message:
:TRIG:LIN:BAUD?
Response message:
9600bps
:TRIGger:LIN:CONDition
Command/Query
DESCRIPTION The command sets the trigger condition of the LIN bus.
The query returns the current trigger condition of the LIN bus.
<condition>:= {BReak|ID|ID_AND_DATA|DATA_ERROR}
<condition>:= {BReak|ID|ID_AND_DATA|DATA_ERROR}
EXAMPLE The following command sets the condition of the LIN bus
trigger to ID_AND_DATA.
Command message:
:TRIGger:LIN:CONDition ID_AND_DATA
TRIG:LIN:COND ID_AND_DATA
Query message:
TRIG:LIN:COND?
Response message:
ID_AND_DATA
:TRIGger:LIN:DAT2
Command/Query
DESCRIPTION The command sets the data2 of the LIN bus trigger when the
trigger condition is ID+Data.
The query returns the current data2 of the LIN bus trigger.
Note:
Use the don’t care data (256) to ignore the data2 value.
EXAMPLE The following command sets the data2 of the LIN bus trigger to
0x4C.
Command message:
:TRIGger:LIN:DAT2 76
TRIG:LIN:DAT2 76
Query message:
TRIG:LIN:DAT2?
Response message:
76
:TRIGger:LIN:DATA
Command/Query
DESCRIPTION The command sets the data of the LIN bus trigger when the
trigger condition is ID+Data.
The query returns the current data1 of the LIN bus trigger.
Note:
Use the don’t care data (256) to ignore the data value.
EXAMPLE The following command sets the data1 of the LIN bus trigger to
0x45.
Command message:
:TRIGger:LIN:DATA 69
TRIG:LIN:DATA 69
Query message:
TRIG:LIN:DATA?
Response message:
69
:TRIGger:LIN:ERRor:CHECksum
Command/Query
DESCRIPTION The command sets the checksum error state of the LIN bus
trigger when the trigger condition is Error.
The query returns the current checksum error state of the LIN
bus trigger.
<state>:= {0|1}
0 means OFF
1 means ON
<state>:= {0|1}
Command message:
:TRIGger:LIN:ERRor:CHECksum 1
TRIG:LIN:ERR:CHEC 1
Query message:
TRIG:LIN:ERR:CHEC?
Response message:
1
:TRIGger:LIN:ERRor:DLENgth
Command/Query
DESCRIPTION The command sets the data length of the error frame when the
trigger condition is Error and the checksum error state is on.
The query returns the current data length of the error frame on
LIN bus.
EXAMPLE The following command sets the data length of the error frame
on LIN bus to 4 bytes.
Command message:
:TRIGger:LIN:ERRor:DLENgth 4
TRIG:LIN:ERR:DLEN 4
Query message:
TRIG:LIN:ERR:DLEN?
Response message:
4
:TRIGger:LIN:ERRor:ID
Command/Query
DESCRIPTION The command sets the error frame ID of the LIN bus when the
trigger condition is Error and the checksum error state is on.
The query returns the current error frame ID of the LIN bus.
EXAMPLE The following command sets the error frame ID of the LIN bus
trigger to 0x2A.
Command message:
:TRIGger:LIN:ERRor:ID 42
TRIG:LIN:ERR:ID 42
Query message:
TRIG:LIN:ERR:ID?
Response message:
42
:TRIGger:LIN:ERRor:PARity
Command/Query
DESCRIPTION The command sets the header parity error state of the LIN bus
trigger when the trigger condition is Error.
The query returns the header parity error state of the LIN bus
trigger.
<state>:= {0|1}
0 means OFF
1 means ON
<state>:= {0|1}
Command message:
:TRIGger:LIN:ERRor:PARity 1
TRIG:LIN:ERR:PAR 1
Query message:
TRIG:LIN:ERR:PAR?
Response message:
1
:TRIGger:LIN:ERRor:SYNC
Command/Query
DESCRIPTION The command sets the sync byte error state of the LIN bus
trigger.
The query returns the current sync byte error state of the LIN
bus trigger.
<state>:= {0|1}
<state>:= {0|1}
EXAMPLE The following command sets to trigger when a sync byte error
occurs.
Command message:
:TRIGger:LIN:ERRor:SYNC 1
TRIG:LIN:ERR:SYNC 1
Query message:
TRIG:LIN:ERR:SYNC?
Response message:
1
:TRIGger:LIN:ID
Command/Query
DESCRIPTION The command sets the ID of the LIN bus when the trigger
condition is ID.
Note:
Use the don’t care data (64) to ignore the ID value.
EXAMPLE The following command sets the ID of the LIN bus trigger to
0x2B.
Command message:
:TRIGger:LIN:ID 43
TRIG:LIN:ID 43
Query message:
TRIG:LIN:ID?
Response message:
43
:TRIGger:LIN:SOURce
Command/Query
DESCRIPTION The command selects the trigger source of the LIN bus.
The query returns the current trigger source of the LIN bus.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the trigger source of the LIN bus
as channel 2.
Command message:
:TRIGger:LIN:SOURce C2
TRIG:LIN:SOUR C2
Query message:
TRIG:LIN:SOUR?
Response message:
C2
:TRIGger:LIN:STANdard
Command/Query
DESCRIPTION The command sets the LIN protocol standard when the trigger
condition is Error and the checksum error state is on.
The query returns the current protocol standard of the LIN bus.
<version>:= {0|1}
0 means Rev1.3
1 means Rev2.x
<version>:= {0|1}
Command message:
:TRIGger:LIN:STANdard 0
TRIG:LIN:STAN 0
Query message:
TRIG:LIN:STAN?
Response message:
0
:TRIGger:LIN:THReshold
Command/Query
DESCRIPTION The command sets the threshold of the source on LIN bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
SDS6000A [-4.5*vertical_scale-vertical_offset
SDS6000L , 4.5*vertical_scale-vertical_offset]
SHS800X/SHS1000X
SDS5000X
[-4.1*vertical_scale-vertical_offset
SDS2000X Plus
, 4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the source on LIN
bus trigger to 1.5 V.
Command message:
:TRIGger:LIN:THReshold 1.50E+00
TRIG:LIN:THR 1.50E+00
Query message:
TRIG:LIN:THR?
Response message:
1.50E+00
The :TRIGGER:FLEXray subsystem commands control the FlexRay bus trigger parameters.
:TRIGger:FLEXray:BAUD
:TRIGger:FLEXray:CONDition
:TRIGger:FLEXray:FRAMe:COMPare
:TRIGger:FLEXray:FRAMe:CYCLe
:TRIGger:FLEXray:FRAMe:ID
:TRIGger:FLEXray:FRAMe:REPetition
:TRIGger:FLEXray:SOURce
:TRIGger:FLEXray:THReshold
:TRIGger:FLEXray:BAUD
Command/Query
DESCRIPTION The command sets the baud rate of the Flexray bus trigger.
The query returns the current baud rate of the Flexray bus
trigger.
<baud>:= {2500kbps|5Mbps|10Mbps|CUSTom[,<value>]}
<baud>:= {2500kbps|5Mbps|10Mbps|CUSTom[,<value>]}
EXAMPLE The following command sets the baud rate of the Flexray bus
trigger to 2500kbps.
Command message:
:TRIGger:FLEXray:BAUD 2500kbps
TRIG:FLEX:BAUD 2500kbps
Query message:
TRIG:FLEX:BAUD?
Response message:
2500kbps
:TRIGger:FLEXray:CONDition
Command/Query
<condition>:= {TSS|FRAMe|SYMBol|ERRor}
<condition>:= {TSS|FRAMe|SYMBol|ERRor}
Command message:
:TRIGger:FLEXray:CONDition SYMBol
TRIG:FLEX:COND SYMB
Query message:
TRIG:FLEX:COND?
Response message:
SYMBol
:TRIGger:FLEXray:FRAMe:COMPare
Command/Query
DESCRIPTION The command sets the frame cycle compare type of FLEXray
bus trigger.
EXAMPLE The following command sets the frame cycle compare type of
FLEXray bus trigger to LESSthan.
Command message:
:TRIGger:FLEXray:FRAMe:COMPare LESSthan
TRIG:FLEX:FRAM:COMP LESS
Query message:
TRIG:FLEX:FRAM:COMP?
Response message:
LESSthan
:TRIGger:FLEXray:FRAMe:CYCLe
Command/Query
DESCRIPTION The command sets the frame cycle of FLEXray bus trigger.
EXAMPLE The following command sets the frame cycle of FLEXray bus
trigger to 2.
Command message:
:TRIGger:FLEXray:FRAMe:CYCLe 2
TRIG:FLEX:FRAM:CYCL 2
Query message:
TRIG:FLEX:FRAM:CYCL?
Response message:
2
:TRIGger:FLEXray:FRAMe:ID
Command/Query
Note:
Use the don’t care data (2048) to ignore the ID value.
Command message:
:TRIGger:FLEXray:FRAMe:ID 1793
TRIG:FLEX:FRAM:ID 1793
Query message:
TRIG:FLEX:FRAM:ID?
Response message:
1793
:TRIGger:FLEXray:FRAMe:REPetition
Command/Query
DESCRIPTION The command sets the cycle repetition of FLEXray bus trigger
when the cycle compare type is Equal
<times>:= {1|2|4|8|16|32|64}
<times>:= {1|2|4|8|16|32|64}
Command message:
:TRIGger:FLEXray:FRAMe:REPetition 8
TRIG:FLEX:FRAM:REP 8
Query message:
TRIG:FLEX:FRAM:REP?
Response message:
8
:TRIGger:FLEXray:SOURce
Command/Query
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the source of FLEXray bus trigger
as channel 2.
Command message:
:TRIGger:FLEXray:SOURce C2
TRIG:FLEX:SOUR C2
Query message:
TRIG:FLEX:SOUR?
Response message:
C2
:TRIGger:FLEXray:THReshold
Command/Query
DESCRIPTION The command sets the threshold of the source on FLEXray bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
QUERY SYNTAX :TRIGger:FLEXray:THReshold?
Command message:
:TRIGger:FLEXray:THReshold 1.50E+00
TRIG:FLEX:THR 1.50E+00
Query message:
TRIG:FLEX:THR?
Response message:
1.50E+00
The :TRIGGER:CANFd subsystem commands control the CAN FD bus trigger parameters.
:TRIGger:CANFd:BAUDData
:TRIGger:CANFd:BAUDNominal
:TRIGger:CANFd:CONDition
:TRIGger:CANFd:DAT2
:TRIGger:CANFd:DATA
:TRIGger:CANFd:FTYPe
:TRIGger:CANFd:ID
:TRIGger:CANFd:IDLength
:TRIGger:CANFd:SOURce
:TRIGger:CANFd:THReshold
:TRIGger:CANFd:BAUDData
Command/Query
DESCRIPTION The command sets the data baud rate of the CAN FD bus
trigger when the frame type is Both or CAN FD.
The query returns the current data baud rate of the CAN FD
bus trigger.
<baud>:=
{500kbps|1Mbps|2Mbps|5Mbps|8Mbps|10Mbps|CUSTom[,<val
ue>]}
<baud>:=
{500kbps|1Mbps|2Mbps|5Mbps|8Mbps|10Mbps|CUSTom[,<val
ue>]}
EXAMPLE The following command sets the data baud rate of the CAN FD
bus trigger to 500kbps.
Command message:
:TRIGger:CANFd:BAUDData 500kbps
TRIG:CANF:BAUDD 500kbps
Query message:
TRIG:CANF:BAUDD?
Response message:
500kbps
:TRIGger:CANFd:BAUDNominal
Command/Query
DESCRIPTION The command sets the nominal baud rate of the CAN FD bus
trigger.
The query returns the current nominal baud rate of the CAN FD
bus trigger.
<baud>:=
{10kbps|25kbps|50kbps|100kbps|250kbps|1Mbps|CUSTom[,<v
alue>]}
<baud>:=
{10kbps|25kbps|50kbps|100kbps|250kbps|1Mbps|CUSTom[,<v
alue>]}
EXAMPLE The following command sets the nominal baud of the CAN FD
bus trigger to 10kbps.
Command message:
:TRIGger:CANFd:BAUDNominal 10kbps
TRIG:CANF:BAUDN 10kbps
Query message:
TRIG:CANF:BAUDN?
Response message:
10kbps
:TRIGger:CANFd:CONDition
Command/Query
DESCRIPTION The command sets the trigger condition for the CAN FD bus
trigger.
The query returns the current trigger condition for the CAN FD
bus trigger.
<condition>:= {STARt|REMote|ID|ID_AND_DATA|ERRor}
<condition>:= {STARt|REMote|ID|ID_AND_DATA|ERRor}
EXAMPLE The following command sets the condition of the CAN FD bus
trigger to ID_AND_DATA.
Command message:
:TRIGger:CANFd:CONDition ID_AND_DATA
TRIG:CANF:COND ID_AND_DATA
Query message:
TRIG:CANF:COND?
Response message:
ID_AND_DATA
:TRIGger:CANFd:DAT2
Command/Query
DESCRIPTION The command sets the data2 of the CAN FD bus when the
trigger condition is ID+Data.
The query returns the current data2 of the CAN FD bus trigger.
Note:
Use the don’t care data (256) to ignore the data2 value.
EXAMPLE The following command sets the data2 of the CAN FD bus
trigger to 0x3F.
Command message:
TRIGger:CANFd:DAT2 63
TRIG:CANF:DAT2 63
Query message:
TRIG:CANF:DAT2?
Response message:
63
:TRIGger:CANFd:DATA
Command/Query
The query returns the current data of the CAN FD bus trigger.
Note:
Use the don’t care data (256) to ignore the data value.
EXAMPLE The following command sets the data1 of the CAN FD bus
trigger to 0x2E.
Command message:
:TRIGger:CANFd:DATA 46
TRIG:CANF:DATA 46
Query message:
TRIG:CANF:DATA?
Response message:
46
:TRIGger:CANFd:FTYPe
Command/Query
DESCRIPTION This command sets the frame type of the CAN FD bus trigger.
The query returns the current frame type of the CAN FD bus
trigger.
<frame_type>:= {BOTH|CAN|CANFd}
<frame_type>:= {BOTH|CAN|CANFd}
EXAMPLE The following command sets the frame type of the CAN FD bus
trigger to CANFd.
Command message:
:TRIGger:CANFd:FTYPe CANFd
TRIG:CANF:FTYP CANF
Query message:
TRIG:CANF:FTYP?
Response message:
CANFd
:TRIGger:CANFd:ID
Command/Query
DESCRIPTION The command sets the ID of the CAN FD bus trigger when the
trigger condition is Remote, ID or ID+Data.
Note:
Use the don’t care data (536870912, ID length is 29) to ignore
the data value.
Command message:
:TRIGger:CANFd:ID 90861836
TRIG:CANF:ID 90861836
Query message:
TRIG:CANF:ID?
Response message:
90861836
:TRIGger:CANFd:IDLength
Command/Query
DESCRIPTION The command sets the ID length of the CAN FD bus trigger.
<length>:= {11BITS|29BITS}
<length>:= {11BITS|29BITS}
EXAMPLE The following command sets the ID length of the CAN FD bus
trigger to 29BITS.
Command message:
:TRIGger:CANFd:IDLength 29BITS
TRIG:CANF:IDL 29BITS
Query message:
TRIG:CANF:IDL?
Response message:
29BITS
:TRIGger:CANFd:SOURce
Command/Query
DESCRIPTION The command selects the source of the CAN FD bus trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the source of the CAN FD bus
trigger as channel 2.
Command message:
:TRIGger:CANFd:SOURce C2
TRIG:CANF:SOUR C2
Query message:
TRIG:CANF:SOUR?
Response message:
C2
:TRIGger:CANFd:THReshold
Command/Query
DESCRIPTION The command sets the threshold of the source on CAN FD bus
triggering.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
QUERY SYNTAX :TRIGger:CANFd:THReshold?
Command message:
:TRIGger:CANFd:THReshold 1.50E+00
TRIG:CANF:THR 1.50E+00
Query message:
TRIG:CANF:THR?
Response message:
1.50E+00
The :TRIGGER:IIS subsystem commands control the IIS bus trigger parameters.
:TRIGger:IIS:AVARiant
:TRIGger:IIS:BCLKSource
:TRIGger:IIS:BCLKThreshold
:TRIGger:IIS:BITorder
:TRIGger:IIS:CHANnel
:TRIGger:IIS:COMPare
:TRIGger:IIS:CONDition
:TRIGger:IIS:DLENgth
:TRIGger:IIS:DSource
:TRIGger:IIS:DTHReshold
:TRIGger:IIS:LATChedge
:TRIGger:IIS:LCH
:TRIGger:IIS:VALue
:TRIGger:IIS:WSSource
:TRIGger:IIS:WSTHreshold
:TRIGger:IIS:AVARiant
Command/Query
DESCRIPTION The command sets the audio variant of the IIS bus trigger.
The query returns the current audio variant of the IIS bus
trigger.
<type>:= {IIS|LJ|RJ}
<type>:= {IIS|LJ|RJ}
EXAMPLE The following command sets the audio variant of the IIS bus
trigger to IIS.
Command message:
:TRIGger:IIS:AVARiant IIS
TRIG:IIS:AVAR IIS
Query message:
TRIG:IIS:AVAR?
Response message:
IIS
:TRIGger:IIS:BCLKSource
Command/Query
DESCRIPTION The command selects the BCLK source of the IIS bus trigger.
The query returns the current BCLK source of the IIS bus
trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the BCLK source of the IIS bus
trigger as channel 2.
Command message:
:TRIGger:IIS:BCLKSource C2
TRIG:IIS:BCLKS C2
Query message:
TRIG:IIS:BCLKS?
Response message:
C2
:TRIGger:IIS:BCLKThreshold
Command/Query
DESCRIPTION The command sets the threshold of the BCLK on LIN bus
trigger.
The query returns the current threshold of the BCLK on LIN bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the BCLK on LIN
bus trigger to 1.5 V.
Command message:
:TRIGger:IIS:BCLKThreshold 1.50E+00
TRIG:IIS:BCLKT 1.50+00
Query message:
TRIG:IIS:BCLKT?
Response message:
1.50E+00
:TRIGger:IIS:BITorder
Command/Query
DESCRIPTION The command sets the bit order of the IIS bus trigger.
The query returns the current bit order of the IIS bus trigger.
<order>:= {LSM|MSB}
<order>:= {LSM|MSB}
EXAMPLE The following command sets the bit order of the IIS bus trigger
to MSB.
Command message:
:TRIGger:IIS:BITorder MSB
TRIG:IIS:BIT MSB
Query message:
TRIG:IIS:BIT?
Response message:
MSB
:TRIGger:IIS:CHANnel
Command/Query
DESCRIPTION The command sets the channel of the IIS bus trigger.
The query returns the current channel of the IIS bus trigger
<channel>:= {LEFT|RIGHT}
<channel>:= {LEFT|RIGHT}
Command message:
:TRIGger:IIS:CHANnel RIGHT
TRIG:IIS:CHAN RIGHT
Query message:
TRIG:IIS:CHAN?
Response message:
RIGHT
:TRIGger:IIS:COMPare
Command/Query
DESCRIPTION The command sets the data compare type of the IIS bus
trigger.
The query returns the current data compare type of the IIS bus
trigger.
<type>:= {EQUal|GREaterthan|LESSthan}
<type>:= {EQUal|GREaterthan|LESSthan}
EXAMPLE The following command sets the data compare type of the IIS
bus trigger to LESSthan.
Command message:
:TRIGger:IIS:COMPare LESSthan
TRIG:IIS:COMP LESS
Query message:
TRIG:IIS:COMP?
Response message:
LESSthan
:TRIGger:IIS:CONDition
Command/Query
DESCRIPTION The command sets the trigger condition of the IIS bus.
The query returns the current trigger condition of the IIS bus.
<condition>:= {DATA|MUTE|CLIP|GLITch|RISing|FALLing}
<condition>:= {DATA|MUTE|CLIP|GLITch|RISing|FALLing}
EXAMPLE The following command sets the trigger condition of the IIS bus
to DATA.
Command message:
:TRIGger:IIS:CONDition DATA
TRIG:IIS:COND DATA
Query message:
TRIG:IIS:COND?
Response message:
DATA
:TRIGger:IIS:DLENgth
Command/Query
DESCRIPTION The command sets the data bits of the IIS bus trigger.
The query returns the current data bits of the IIS bus trigger.
Note:
The range of the value is related to the channel bits and the
start bits. If the channel bits are 32 and the start bit is 2, the
range is [1,30]
EXAMPLE The following command sets the data bits of the IIS bus trigger
to 10.
Command message:
:TRIGger:IIS:DLENgth 10
TRIG:IIS:DLEN 10
Query message:
TRIG:IIS:DLEN?
Response message:
10
:TRIGger:IIS:DSource
Command/Query
DESCRIPTION The command selects the data source of the IIS bus trigger.
The query returns the current data source of the IIS bus trigger
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the data source of the IIS bus
trigger as C2.
Command message:
:TRIGger:IIS:DSource C2
TRIG:IIS:DS C2
Query message:
TRIG:IIS:DS?
Response message:
C2
:TRIGger:IIS:DTHReshold
Command/Query
DESCRIPTION The command sets the threshold of the data source on IIS bus
trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the data source
on IIS bus trigger to 1.5 V.
Command message:
TRIGger:IIS:DTHReshold 1.50E+00
TRIG:IIS:DTHR 1.50E+00
Query message:
TRIG:IIS:DTHR?
Response message:
1.50E+00
:TRIGger:IIS:LATChedge
Command/Query
DESCRIPTION The command selects the sampling edge of BCLK on IIS bus
trigger.
<slope>:= {RISing|FALLing}
<slope>:= {RISing|FALLing}
EXAMPLE The following command sets the sampling edge of BCLK on IIS
bus trigger to RISing.
Command message:
:TRIGger:IIS:BCLK:EDGE RISing
TRIG:IIS:BCLK:EDGE RIS
Query message:
TRIG:IIS:BCLK:EDGE?
Response message:
RISing
:TRIGger:IIS:LCH
Command/Query
DESCRIPTION The command selects the level of the left channel on IIS bus
trigger.
The query returns the current level of the left channel on IIS
bus trigger.
<level>:= {LOW|HIGH}
<level>:= {LOW|HIGH}
EXAMPLE The following command sets the level of the left channel on IIS
bus trigger to HIGH.
Command message:
:TRIGger:IIS:LCH HIGH
TRIG:IIS:LCH HIGH
Query message:
TRIG:IIS:LCH?
Response message:
HIGH
:TRIGger:IIS:VALue
Command/Query
DESCRIPTION The command sets the value of the IIS bus trigger.
The query returns the current value of the IIS bus trigger.
Note:
• The range of the value is related to data length by using
the command :TRIGger:IIS:DLENgth.
• Use the don’t care data (256, data length is 8) to ignore the
data value.
EXAMPLE The following command sets the value of the IIS bus trigger to
0x56 when the data length is 8.
Command message:
:TRIGger:IIS:VALue 86
TRIG:IIS:VAL 86
Query message:
TRIG:IIS:VAL?
Response message:
86
:TRIGger:IIS:WSSource
Command/Query
DESCRIPTION The command selects the WS source of the IIS bus trigger.
The query returns the current WS source of the IIS bus trigger.
<source>:= {C<x>|D<n>}
<source>:= {C<x>|D<n>}
EXAMPLE The following command sets the WS source of the IIS bus trigger
as channel 2.
Command message:
:TRIGger:IIS:WSSource C2
TRIG:IIS:WSS C2
Query message:
TRIG:IIS:WSS?
Response message:
C2
:TRIGger:IIS:WSTHreshold
Command/Query
DESCRIPTION The command sets the threshold of the WS on IIS bus trigger.
The range of the value varies by model, see the table below for
details.
Model Value Range
SDS6000 Pro
[-4.5*vertical_scale-vertical_offset,
SDS6000A
4.5*vertical_scale-vertical_offset]
SDS6000L
SDS5000X
[-4.1*vertical_scale-vertical_offset,
SDS2000X Plus
4.1*vertical_scale-vertical_offset]
SDS2000X HD
EXAMPLE The following command sets the threshold of the WS on IIS bus
trigger to 1.5 V.
Command message:
:TRIGger:IIS:WSThreshold 1.50E+00
TRIG:IIS:WST 1.50E+00
Query message:
TRIG:IIS:WST?
Response message:
1.50E+00
WAVeform Commands
The WAVEFORM subsystem is used to transfer data to a controller from the oscilloscope waveform
memory.
The waveform record is actually contained in two portions: the preamble and waveform data. The
waveform record must be read from the oscilloscope by the controller using two separate commands.
The waveform data is the actual data acquired for each point in the specified source. The preamble
contains the information for interpreting the waveform data.
:WAVeform:DATA
:WAVeform:INTerval
:WAVeform:MAXPoint
:WAVeform:POINt
:WAVeform:PREamble
:WAVeform:SEQuence
:WAVeform:SOURce
:WAVeform:STARt
:WAVeform:WIDTh
:WAVeform:SOURce
Command/Query
<source>:= {C<x>|F<x>|D<m>}
C denotes an analog input channel. For example, C1 is
analog input 1.
F denotes a math function. For example, F1 is math function
1. All operators including FFT.
D denotes a digital waveform. For example, D1 denotes
digital input 1.
<source>:= {C<x>|F<x>|D<m>}
Command message:
:WAVeform:SOURce C2
WAV:SOUR C2
Query message:
WAV:SOUR?
Response message:
C2
:WAVeform:STARt
Command/Query
DESCRIPTION The command specifies the starting data point for waveform
transfer using the query :WAVeform:DATA?.
The query returns the starting data point for waveform transfer.
Note:
The value range is related to the current waveform point and
the value set by the command :WAVeform:POINt.
EXAMPLE The following command sets the start point to 1000 when the
current waveform point is 400 kpts.
Command message:
:WAVeform:STARt 1000
WAV:STAR 1000
Query message:
WAV:STAR?
Response message:
1000
:WAVeform:INTerval
Command/Query
DESCRIPTION The command sets the interval between data points for
waveform transfer using the query :WAVeform:DATA?
Note:
The value range is related to the values set by the
command :WAVeform:POINt and :WAVeform:STARt.
EXAMPLE The following command sets the interval between data points
for waveform transfer to 200.
Command message:
:WAVeform:INTerval 200
WAV:INT 200
Query message:
WAV:INT?
Response message:
200
:WAVeform:POINt
Command/Query
Note:
The value range is related to the current waveform point.
Command message:
:WAVeform:POINt 20000
WAV:POIN 20000
Query message:
WAV:POIN?
Response message:
20000
:WAVeform:MAXPoint
Query
DESCRIPTION The query returns the maximum points of one piece, when it
needs to read the waveform data in pieces.
Query message:
:WAV:MAXPoint?
Response message:
10000000
:WAVeform:WIDTh
Command/Query
DESCRIPTION The command sets the current output format for the transfer of
waveform data.
The query returns the current output format for the transfer of
waveform data.
<type>:= {BYTE|WORD}
WORD formatted data transfers 16-bit data as two bytes, and
the upper byte is transmitted first.
BYTE formatted data is transferred as 8-bit bytes.
Note:
When the vertical resolution is set to 10 bit or the ADC bit is
more than 8bit, it must to use the command to set to WORD
before transferring waveform data.
<type>:= {BYTE|WORD}
EXAMPLE The following command sets the current output format for the
transfer of waveform data to BYTE.
Command message:
:WAVeform:WIDTh BYTE
WAV:WIDT BYTE
Query message:
WAV:WIDT?
Response message:
BYTE
:WAVeform:PREamble
Query
DESCRIPTION The query returns the parameters of the source using by the
command :WAVeform:SOURce.
0 200E-12 20 1E-3
1 500E-12 21 2E-3
2 1E-9 22 5E-3
3 2E-9 23 10E-3
4 5E-9 24 20E-3
5 10E-9 25 50E-3
6 20E-9 26 100E-3
7 50E-9 27 200E-3
8 100E-9 28 500E-3
9 200E-0 29 1
10 500E-9 30 2
11 1E-6 31 5
12 2E-6 32 10
13 5E-6 33 20
14 10E-6 34 50
15 20E-6 35 100
16 50E-6 36 200
17 100E-6 37 500
18 200E-6 38 1000
19 500E-6
:WAVeform:DATA
Query
DESCRIPTION The query returns the waveform data of the source using by the
command :WAVeform:SOURce to be transferred from the
oscilloscope.
EXAMPLE For SDS5000X series, the following steps show how to use the
command to reconstitute the display of waveform.
For analog channel waveform and math waveform (except for FFT):
Response message:
The header is “#9000001000” which nine ASCII integers are used to give the number of the
waveform data points (1000 pts). After the header of block, is beginning of the wave data, and the
last two bytes “0A 0A” means the end of data.
For parameter parsing, see the section of the query. Through the query, we can get the vertical scale
is 10 V/div, the vertical offset is 14.5 V, the timebase is 20E-9 s, the trigger delay is 1.72E-8 s, and the
sampling interval is 2E-10 s.
Use python to reconstruct the waveform: (See the code in Read Waveform Data Example)
:WAVeform:SOURce D0
:WAVeform:DATA?
Response message:
The header is “#9000002500” which nine ASCII integers are used to give the number of the
waveform data points (2500 pts). After the header of block, is beginning of the wave data. For digital,
one bit represents a data point, if the number of points is not an integer multiple of 8, the byte less
than 8 bits will be filled with 0. So there are 313 bytes. The last two bytes “0A 0A” means the end of
data.
For parameter parsing, see the section of the query. Through the query, we can get the timabase is
2E-7 s, the trigger delay is -2E-7 s, and the sampling interval is 2E-10 s.
Step 3: Covert to the high (1) and low (0) corresponding to the data point.
According to the wave data, we can know the first eight points of waveform is the 17th byte “FF”,
convert to binary is “11111111” (Hexadecimal converted to binary (LSB)).
Use python to reconstruct the waveform: (See the code in Read Waveform Data of Digital Example)
For an example of FFT waveform, please refer to Read Waveform Data of FFT Example.
:WAVeform:SEQuence
Command/Query
Note:
• When sequence is enabled, <value1> will be set to 1 by
default;when sequence and history are enabled, <value1>
will be set to the current frame by default. In other cases,
<value1> is set to 4294967295 by default.
• The value range is related to the current sequence number.
Command message:
:WAVeform:SEQuence 0,1
WAV:SEQ 0,1
Query message:
WAV:SEQ?
Response message:
0,1
See the python code in Read Sequence Waveform Data Example for reference.
WGEN Commands
When the oscilloscope supports the function generator module (built-in waveform generator or
SAG1021I) and is licensed (Option FG), you can output sine, square, ramp, pulse, DC, noise,
exponential rise, exponential fall, cardiac, gaussian pulse and arbitrary waveforms. The WGEN
commands are used to select the waveform function and parameters.
The WGEN commands are the same as that of Siglent SDG series, so the format is not consistent
with other groups. Refer to SDG programming guide for details.
ARbWaVe
BaSic_WaVe
OUTPut
SToreList
SYNC
VOLTPRT
ARbWaVe
Command/Query
<channel>:ARbWaVe NAME,<name>
Note:
This table is just an example, the index depends on the specific
model. The “STL?” query can be used to get the accurate
mapping relationship between the index and name.
<channel>:= {C1}
INDEX,<index>,NAME,<name>
Return:
C1:ARWV INDEX,2,NAME,StairUp
BaSic_WaVe
Command/Query
<channel>:= {C1}
Return:
C1:BSWV
WVTP,SINE,FRQ,100HZ,PERI,0.01S,AMP,2V,OFST,0V,HLEV,
1V,LLEV,-1V,PHSE,0
OUTPut
Command/Query
<state>:= {ON|OFF}
<state>:= {ON|OFF}
<load>:= {50|HZ}
Return:
C1:OUTP ON,LOAD,HZ,PLRT,NOR
SToreList
Query
DESCRIPTION This query is used to read the stored waveforms list with
indexes and names. If the store unit is empty, the command will
return “EMPTY” string.
<location>:= {BUILDIN|USER}
EXAMPLE Read all arbitrary data saved in the built-in waveform generator
in SDS2000X Plus.
STL?
Return:
STL M10, ExpFal, M100, ECG14, M101, ECG15, M102,
LFPulse, M103, Tens1, M104, Tens2, M105, Tens3, M106,
Airy, M107, Besselj, M108, Bessely, M109, Dirichlet, M11,
ExpRise, M110, Erf, M111, Erfc, M112, ErfcInv, M113, ErfInv,
M114, Laguerre, M115, Legend, M116, Versiera, M117,
Weibull, M118, LogNormal, M119, Laplace, M12, LogFall,
M120, Maxwell, M121, Rayleigh, M122, Cauchy, M123, CosH,
M124, CosInt, M125, CotH, M126, CscH, M127, SecH, M128,
SinH, M129, SinInt, M13, LogRise, M130, TanH, M131,
ACosH, M132, ASecH, M133, ASinH, M134, ATanH, M135,
ACsch, M136, ACoth, M137, Bartlett, M138, BohmanWin,
M139, ChebWin, M14, Sqrt, M140, FlattopWin, M141,
ParzenWin, M142, TaylorWin, M143, TukeyWin, M144, Duty01,
M145, Duty02, M146, Duty04, M147, Duty06, M148, Duty08,
M149, Duty10, M15, Root3, M150, Duty12, M151, Duty14,
M152, Duty16, M153, Duty18, M154, Duty20, M155, Duty22,
M156, Duty24, M157, Duty26, M158, Duty28, M159, Duty30,
M16, X^2, M160, Duty32, M161, Duty34, M162, Duty36, M163,
Duty38, M164, Duty40, M165, Duty42, M166, Duty44, M167,
Duty46, M168, Duty48, M169, Duty50, M17, X^3, M170,
Duty52, M171, Duty54, M172, Duty56, M173, Duty58, M174,
Duty60, M175, Duty62, M176, Duty64, M177, Duty66, M178,
Duty68, M179, Duty70, M18, Sinc, M180, Duty72, M181,
Duty74, M182, Duty76, M183, Duty78, M184, Duty80, M185,
Duty82, M186, Duty84, M187, Duty86, M188, Duty88, M189,
Duty90, M19, Gaussian, M190, Duty92, M191, Duty94, M192,
Duty96, M193, Duty98, M194, Duty99, M195, demo1_375,
M196, demo1_16k, M197, demo2_3k, M198, demo2_16k, M2,
StairUp, M20, Dlorentz, M21, Haversine, M22, Lorentz, M23,
Gauspuls, M24, Gmonopuls, M25, Tripuls, M26, Cardiac, M27,
Quake, M28, Chirp, M29, Twotone, M3, StairDn, M30, SNR,
M31, Hamming, M32, Hanning, M33, kaiser, M34, Blackman,
M35, Gausswin, M36, Triangle, M37, BlackmanH, M38,
Bartlett-Hann, M39, Tan, M4, StairUD, M40, Cot, M41, Sec,
M42, Csc, M43, Asin, M44, Acos, M45, Atan, M46, Acot, M47,
Square, M48, SineTra, M49, SineVer, M5, Ppulse, M50,
AmpALT, M51, AttALT, M52, RoundHalf, M53, RoundsPM,
M54, BlaseiWave, M55, DampedOsc, M56, SwingOsc, M57,
Discharge, M58, Pahcur, M59, Combin, M6, Npulse, M60,
SCR, M61, Butterworth, M62, Chebyshev1, M63, Chebyshev2,
M64, TV, M65, Voice, M66, Surge, M67, Radar, M68, Ripple,
PFM, M8, Upramp, M80, PM, M81, PWM, M82, EOG, M83,
EEG, M84, EMG, M85, Pulseilogram, M86, ResSpeed, M87,
ECG1, M88, ECG2, M89, ECG3, M9, Dnramp, M90, ECG4,
M91, ECG5, M92, ECG6, M93, ECG7, M94, ECG8, M95,
ECG9, M96, ECG10, M97, ECG11, M98, ECG12, M99, ECG13
SYNC
Command/Query
<state>:= {ON|OFF}
<channel>:= {C1}
<channel>:= {C1}
<state>:= {ON|OFF}
Return:
C1:SYNC ON,TYPE,CH1
VOLTPRT
Command/Query
<state>:= {ON|OFF}
METEr Commands
The meter system commands are only for the multimeter functions of SHS800X/SHS1000X
handheld digital oscilloscope. Support for configuration and measurement.
MMETerMMETer
READ
CONFigure Commands
MEASure Commands
SENSe Commands
MMETer
Command
<switch>:= {ON|OFF}
Command message:
MMETer ON
READ
Query
Command message:
READ?
Response message:
MM_VALUE 0.00V
CONFigure Commands
The CONFigure commands are the most concise way to configure measurements. These
commands use default measurement configuration values. However, these commands do not
automatically start measurements, so you can modify measurement attributes before initiating the
measurement.
CONFigure
CONFigure:CAPacitance
CONFigure:CONTinuity
CONFigure:CURRent:AC
CONFigure:CURRent:DC
CONFigure:DIODe
CONFigure:RESistance
CONFigure[:VOLTage]:AC
CONFigure[:VOLTage]:DC
CONFigure
Query
DESCRIPTION Returns the present function and measured value. The present
function name is returned in short format, such as ACV.
<func>:= {DCV|ACV|RES|DIODE|CONTINUITY|CAP|DCI|ACI}
Command message:
CONFigure?
Response message:
DCV -04.mV
CONFigure:CONTinuity
Command
Command message:
CONF:CONT
READ?
Response message:
Overload
CONFigure:CURRent:AC
Command/Query
<range>:= {60mA|600mA|6A|10A|AUTO|MIN|MAX|DEF}
Default: AUTO
Command message:
CONF:CURR:AC 6A
READ?
Response message:
+4.32133675E-04
CONFigure:CURRent:DC
Command/Query
<range>:= {60mA|600mA|6A|10A|AUTO|MIN|MAX|DEF}
Default: AUTO
Command message:
CONF:CURR:DC 6A
READ?
Response message:
+4.32133675E-04
CONFigure:DIODe
Command
Command message:
CONF:DIOD
READ?
Response message:
Overload
CONFigure:RESistance
Command
<range>:= {600|6k|60k|600k|6M|60M|AUTO|MIN|MAX|DEF}
Default: AUTO
Command message:
CONF:RES 600
READ?
Response message:
+6.71881065E+01
CONFigure[:VOLTage]:AC
Command
Model <range>
{60mV|600mV|6V|60V|600V|AUTO
SHS800X
|MIN|MAX|DEF}
{60mV|600mV|6V|60V|600V|750V|
SHS1000X
AUTO|MIN|MAX|DEF}
Default: AUTO
Command message:
CONF:VOLT:AC 60
READ?
Response message:
+2.43186951E-02
CONFigure[:VOLTage]:DC
Command
Model <range>
{60mV|600mV|6V|60V|600V|AUTO|
SHS800X
MIN|MAX|DEF}
{60mV|600mV|6V|60V|600V|1000V|
SHS1000X
AUTO|MIN|MAX|DEF}
Default: AUTO
Command message:
CONF:VOLT:DC 60
READ?
Response message:
+2.43186951E-02
CONFigure:CAPacitance
Command
Command message:
CONF:CAP
READ?
Response message:
+7.26141264E-10
MEASure Commands
The MEASure queries are the easiest way to program measurements because they always use
default measurement parameters. You set the function, range in one command, but you cannot
change other parameters from their default values. The results are sent directly to the instrument's
output buffer.
MEASure:CONTinuity
MEASure:CURRent:AC
MEASure:CURRent:DC
MEASure:DIODe
MEASure:RESistance
MEASure[:VOLTage]:AC
MEASure[:VOLTage]:DC
MEASure[:VOLTage]:AC
MEASure:CAPacitance
MEASure:CONTinuity
Query
Command message:
MEAS:CONT?
Response message:
+9.84739065E+02
MEASure:CURRent:AC
Query
<range>:={60mA|600mA|6A|10A|AUTO}
Default: AUTO
Command message:
MEAS:CURR:AC? 6
Response message:
+4.32133675E-04
MEASure:CURRent:DC
Query
<range>:={60mA|600mA|6A|10A|AUTO}
Default: AUTO
Command message:
MEAS:CURR:DC? 6
Response message:
+4.32133675E-04
MEASure:DIODe
Query
The range and resolution are fixed for diode tests: the
range is 2 VDC.
The READ? and MEASure:DIODe? queries return the
measured voltage. If the voltage is greater than 2V, the
instrument displays the word overload on front panel and
returns "Overload" from the remote interface.
Response message:
+9.84733701E-01
MEASure:RESistance
Query
<range>:={600|6k|60k|600k|6M|60M}
Default: AUTO
Command message:
MEAS:RES? 600
Response message:
+6.71881065E+01
MEASure[:VOLTage]:AC
Query
Model <range>
SHS800X {60mV|600mV|6V|60V|600V }
{60mV|600
SHS1000X
mV|6V|60V|600V|1000V(DC)/750V(AC)}
Default: AUTO
Command message:
MEAS:VOLT:AC? 600
Response message:
+2.43186951E-02
MEASure[:VOLTage]:DC
Query
Model <range>
SHS800X {60mV|600mV|6V|60V|600V }
{60mV|600
SHS1000X mV|6V|60V|600V|1000V(DC)/750V(
DC)}
Default: AUTO
Command message:
MEAS:VOLT:DC? 600
Response message:
+2.43186951E-02
MEASure:CAPacitance
Query
Response message:
+7.26141264E-10
SENSe Commands
[SENSe:]CAPacitance:NULL
[SENSe:]CURRent:AC:NULL
[SENSe:]CURRent:AC:SELEct
[SENSe:]CURRent:DC:NULL
[SENSe:]CURRent:DC:SELEct
[SENSe:]RESistance:NULL
[SENSe:]VOLTage:AC:NULL
[SENSe:]VOLTage:AC:SELEct
[SENSe:]VOLTage:DC:NULL
[SENSe:]VOLTage:DC:SELEct
[SENSe:]CURRent:AC:NULL
Command
<state>:={ON|OFF}
Default: OFF
Response message:
MM_VALUE 0.00V
[SENSe:]CURRent:DC:NULL
Command
<state>:={ON|OFF}
Default: OFF
Response message:
MM_VALUE 0.00V
[SENSe:]CURRent:AC:SELEct
Command
<unit>:={MA|A}
EXAMPLE CONF:CURR:AC
CURR:AC:SELE MA
[SENSe:]CURRent:DC:SELEct
Command
<unit>:={MA|A}
EXAMPLE CONF:CURR:DC
CURR:DC:SELE MA
[SENSe:]RESistance:NULL
Commend
<state>:={ON|OFF}
Default: OFF
Command message:
CONF:RES
RES:NULL ON
READ?
Response message:
0
[SENSe:]VOLTage:AC:NULL
Commend
<state>:={ON|OFF}
Default:OFF
Command message:
CONF:VOLT:AC
VOLT:AC:NULL ON
READ?
Response message:
MM_VALUE 00.04V
[SENSe:]VOLTage:DC:NULL
Commend
<state>:={ON|OFF}
Default: OFF
Command message:
CONF:VOLT:DC
VOLT:DC:NULL ON
READ?
Response message:
MM_VALUE 00.04V
[SENSe:]VOLTage:AC:SELEct
Commend
<unit>:={MV|V}
EXAMPLE CONF:VOLT:AC
VOLT:AC:SELE V
[SENSe:]VOLTage:DC:SELEct
Commend
<unit>:={MV|V}
EXAMPLE CONF:VOLT:DC
VOLT:DC:SELE V
[SENSe:]CAPacitance:NULL
Commend
<state>:={ON|OFF}
Default: OFF
Command message:
CONF:CAP
CAP:NULL ON
READ?
Response message:
MM_VALUE 0.00nF
Programming Examples
This chapter gives some examples for the programmer. In these examples you can see how to use
VISA or sockets, in combination with the commands described above to control the oscilloscope. By
following these examples, you can develop many more applications.
VISA Examples
VC++ Example
VB Example
MATLAB Example
LabVIEW Example
C# Example
Python Example
C Example
VISA Examples
VC++ Example
2. Set the project environment to use the NI-VISA library. There are two ways to use NI-VISA, static
or automatic:
a) Static:
Find the files visa.h, visatype.h, visa32.lib in the NI-VISA installation path, copy them to your
project, and add them into the project. In the projectname.cpp file, add the follow two lines:
#include "visa.h"
#pragma comment(lib,"visa32.lib")
b) Automatic:
Set the .h file include directory, the NI-VISA install path, in our computer we set the path is:
C:\Program Files\IVI Foundation \VISA\WinNT\include. Set this path to:
project->properties->C/C++->General->Additional Include Directories.
See the picture:
3. Coding:
a) USBTMC:
Int Usbtmc_test()
{
/* This code demonstrates sending synchronous read & write commands */
/* to an USB Test & Measurement Class (USBTMC) instrument using */
/* NI-VISA */
/* The example writes the "*IDN?\n" string to all the USBTMC */
/* devices connected to the system and attempts to read back */
/* results using the write and read functions. */
/* The general flow of the code is */
/* Open Resource Manager */
/* Open VISA Session to an Instrument */
/* Write the Identification Query Using viPrintf */
/* Try to Read a Response With viScanf */
/* Close the VISA Session */
/***********************************************************/
ViSession defaultRM;
ViSession instr;
ViUInt32 numInstrs;
ViFindList findList;
ViUInt32 retCount;
ViUInt32 writeCount;
ViStatus status;
char instrResourceString[VI_FIND_BUFLEN];
unsigned char buffer[100];
char stringinput[512];
int i;
/** First we must call viOpenDefaultRM to get the manager
* handle. We will store this handle in defaultRM.*/
status= ViOpenDefaultRM (&defaultRM);
if (status<VI_SUCCESS)
{
printf ("Could not open a session to the VISA Resource Manager!\n");
return status;
}
/* Find all the USB TMC VISA resources in our system and store the number of resources
in the system in numInstrs. */
status = viFindRsrc (defaultRM, "USB?*INSTR", &findList, &numInstrs,
instrResourceString);
if (status<VI_SUCCESS)
{
printf ("An error occurred while finding resources.\nHit enter to continue.");
fflush(stdin);
getchar();
viClose (defaultRM);
return status;
}
/** Now we will open VISA sessions to all USB TMC instruments.
* We must use the handle from viOpenDefaultRM and we must
* also use a string that indicates which instrument to open. This
* is called the instrument descriptor. The format for this string
* can be found in the function panel by right clicking on the
* descriptor parameter. After opening a session to the
* device, we will get a handle to the instrument which we
* will use in later VISA functions. The AccessMode and Timeout
* parameters in this function are reserved for future
* functionality. These two parameters are given the value VI_NULL.*/
for (i= 0; i<numInstrs; i++)
{
if (i> 0)
{
viFindNext (findList, instrResourceString);
}
status = viOpen (defaultRM, instrResourceString, VI_NULL, VI_NULL, &instr);
if (status<VI_SUCCESS)
{
printf ("Cannot open a session to the device %d.\n", i+1);
continue;
}
/* * At this point we now have a session open to the USB TMC instrument.
* We will now use the viPrintf function to send the device the string "*IDN?\n",
* asking for the device's identification. */
char * cmmand ="*IDN?\n";
status = viPrintf (instr, cmmand);
if (status<VI_SUCCESS)
{
printf ("Error writing to the device %d.\n", i+1);
status = viClose (instr);
continue;
}
/** Now we will attempt to read back a response from the device to
* the identification query that was sent. We will use the viScanf
* function to acquire the data.
* After the data has been read the response is displayed.*/
status = viScanf(instr, "%t", buffer);
if (status<VI_SUCCESS)
{
printf ("Error reading a response from the device %d.\n", i+1);
}
else
{
printf ("\nDevice %d: %*s\n", i+1,retCount, buffer);
}
status = viClose (instr);
}
/** Now we will close the session to the instrument using
* viClose. This operation frees all system resources. */
status = viClose (defaultRM);
printf("Press 'Enter' to exit.");
fflush(stdin);
getchar();
return 0;
}
b) TCP/IP:
int TCP_IP_Test(char *pIP)
{
char outputBuffer[VI_FIND_BUFLEN];
ViSession defaultRM, instr;
ViStatus status;
ViUInt32 count;
ViUInt16 portNo;
/* First we will need to open the default resource manager. */
status = viOpenDefaultRM (&defaultRM);
if (status<VI_SUCCESS)
{
printf("Could not open a session to the VISA Resource Manager!\n");
}
/* Now we will open a session via TCP/IP device */
VB Example
2. Set the project environment to use the NI-VISA lib: Click the Existing tab of Project->Add Module,
search the visa32.bas file in the “include” folder under the NI-VISA installation path and add the
file, as shown in the figure below:
3. Coding:
a) USBTMC:
Private Function Usbtmc_test() As Long
' This code demonstrates sending synchronous read & write commands
' to an USB Test & Measurement Class (USBTMC) instrument using
' NI-VISA
' The example writes the "*IDN?\n" string to all the USBTMC
' devices connected to the system and attempts to read back
' results using the write and read functions.
' The general flow of the code is
' Open Resource Manager
' Open VISA Session to an Instrument
' Write the Identification Query Using viWrite
' Try to Read a Response With viRead
' Find all the USB TMC VISA resources in our system and store the
' number of resources in the system in numInstrs.
status= ViFindRsrc(defaultRM,"USB?*INSTR",findList,numlnstrs,instrResourceString)
If (status < VI_SUCCESS) Then
Debug.Print "An error occurred while finding resources."
viClose (defaultRM)
Usbtmc_test = status
Exit Function
End If
' Now we will open VISA sessions to all USB TMC instruments.
' We must use the handle from viOpenDefaultRM and we must
' also use a string that indicates which instrument to open. This
' is called the instrument descriptor. The format for this string
' can be found in the function panel by right clicking on the
' descriptor parameter. After opening a session to the
' At this point we now have a session open to the USB TMC instrument.
' We will now use the viWrite function to send the device the string "*IDN?",
' asking for the device's identification.
status = viWrite(instrsesn, "*IDN?", 5, retCount)
If (status < VI_SUCCESS) Then
Debug.Print "Error writing to the device."
status = viClose(instrsesn)
GoTo NextFind
End If
' Now we will attempt to read back a response from the device to
' the identification query that was sent. We will use the viRead
' function to acquire the data.
' After the data has been read the response is displayed.
status = viRead(instrsesn, buffer, MAX_CNT, retCount)
If (status < VI_SUCCESS) Then
Debug.Print "Error reading a response from the device.", i + 1
Else
Debug.Print i + 1, retCount, buffer
End If
status = viClose(instrsesn)
Next i
b) TCP/IP:
Private Function TCP_IP_Test(ip As String) As Long
Dim outputBuffer As String * VI_FIND_BUFLEN
Dim defaultRM As Long
Dim instrsesn As Long
Dim status As Long
Dim count As Long
Else
Debug.Print "read from device:", outputBuffer
End If
status = viClose(instrsesn)
status = viClose(defaultRM)
TCP_IP_Test = 0
End Function
MATLAB Example
3. Coding:
a) USBTMC:
function USBTMC_test()
% This code demonstrates sending synchronous read & write commands
% to an USB Test & Measurement Class (USBTMC) instrument using
% NI-VISA
end
b) TCP/IP:
end
LabVIEW Example
2. Add controls. Right-click in the Front Panel interface, select and add VISA resource name,
error in, error out and some indicators from the Controls column.
3. Open the Block Diagram interface. Right-click on the VISA resource name and you can select
and add the following functions from VISA Palette from the pop-up menu: VISA Write, VISA
Read, VISA Open and VISA Close.
5. Select the device resource from the VISA Resource Name list box and run the program.
In this example, the VI opens a VISA session to a USBTMC device, writes a command to the
device, and reads back the response. After all communication is complete, the VI closes the
VISA session.
6. Communicating with the device via TCP/IP is similar to USBTMC. But you need to change VISA
Write and VISA Read Function to Synchronous I/O. The LabVIEW default is asynchronous I/O.
Right-click the node and select Synchronous I/O Mod>>Synchronous from the shortcut menu to
write or read data synchronously.
C# Example
Add references
based on VisaNS in
Visual Studio 2008
Add references
based on
NI-VISA.NET in
Visual Studio 2010
5. Code on VisaNS:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using NationalInstruments.VisaNS;
namespace TestVisa
{
class Program
{
static void Main(string[] args)
{
// Find all the USBTMC resources
string[]
usbRsrcStrings=ResourceManager.GetLocalManager().FindResources("USB?*INSTR");
if (usbRsrcStrings.Length <= 0)
{
Console.WriteLine("Cannot find USBTMC Device!");
return;
}
6. Code on Visa.NET:
using System;
using System.Collections.Generic;
using System.Linq;
using NationalInstruments.Visa;
using Ivi.Visa;
namespace test_visa_csharp
{
static class Program
{
static void Main()
{
TcpipSession section = new TcpipSession("TCPIP::10.12.255.135::inst0::INSTR");
IMessageBasedFormattedIO io = section.FormattedIO;
io.WriteLine("*IDN?");
string result = io.ReadLine();
section.Dispose();
Console.WriteLine(result);
}
}
}
This method is a two-way communication between the instrument and the computer through a fixed
port number.
Note that SCPI strings are terminated with a “\n” (new line) character.
Python Example
Python has a low-level networking module that provides access to the socket interface. Python
scripts can be written for sockets to do a variety of test and measurement tasks.
#!/usr/bin/env python
#-*- coding:utf-8 –*-
#-----------------------------------------------------------------------------
# The short script is a example that open a socket, sends a query,
# print the return message and closes the socket.
#-----------------------------------------------------------------------------
import socket # for sockets
import sys # for exit
import time # for sleep
#-----------------------------------------------------------------------------
remote_ip = "10.12.255.209" # should match the instrument’s IP address
port = 5025 # the port number of the instrument service
count = 0
def SocketConnect():
try:
#create an AF_INET, STREAM socket (TCP)
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
except socket.error:
print ('Failed to create socket.')
sys.exit();
try:
#Connect to remote server
s.connect((remote_ip , port))
except socket.error:
print ('failed to connect to ip ' + remote_ip)
return s
def SocketClose(Sock):
#close the socket
Sock.close()
time.sleep(.300)
def main():
global remote_ip
global port
global count
# Body: send the SCPI commands *IDN? 10 times and print the return message
s = SocketConnect()
for i in range(10):
qStr = SocketQuery(s, b'*IDN?')
print (str(count) + ":: " + str(qStr))
count = count + 1
SocketClose(s)
input('Press "Enter" to exit')
if __name__ == '__main__':
proc = main()
C Example
int MySocket;
if((MySocket=socket(PF_INET,SOCK_STREAM,0))==-1)
{
exit(1);
}
struct in_addr
{
unsigned long s_addr;
};
struct sockaddr_in
{
short int sin_family; // Address family
unsigned short int sin_port; // Port number
struct in_addr sin_addr; // Internet address
unsigned char sin_zero[8]; // Padding
};
struct sockaddr_in MyAddress;
// Read response
char buffer[200];
int actual;
if((actual=recv(MySocket,&buffer[0],200,0))==-1)
{
exit(1);
}
buffer[actual]= 0; // Add zero character (C string)
printf(d zero character (C string)],2
// Close socket
if(close(MySocket)==-1)
{
exit(1);
}
Note:
When using the visa library, you should pay attention to the following settings:
I.E. For the command “:WAVeform:DATA?”, the read buffer size depends on the number of
waveform points. When it needs to read in segments, the size of each segment is vary from the
models.
"""The following code realizes the process of waveform reconstruction with slice"""
def main_desc(recv):
WAVE_ARRAY_1 = recv[0x3c:0x3f + 1]
wave_array_count = recv[0x74:0x77 + 1]
first_point = recv[0x84:0x87 + 1]
sp = recv[0x88:0x8b + 1]
v_scale = recv[0x9c:0x9f + 1]
v_offset = recv[0xa0:0xa3 + 1]
interval = recv[0xb0:0xb3 + 1]
code_per_div = recv[0xa4:0Xa7 + 1]
adc_bit = recv[0xac:0Xad + 1]
delay = recv[0xb4:0xbb + 1]
tdiv = recv[0x144:0x145 + 1]
probe = recv[0x148:0x14b + 1]
def main_wf_data():
_rm = visa.ResourceManager()
sds = _rm.open_resource(SDS_RSC)
sds.timeout = 30000 # default value is 2000(2s)
sds.chunk_size = 20 * 1024 * 1024 # default value is 20*1024(20k bytes)
sds.write(":WAVeform:STARt 0")
sds.write("WAV:SOUR {}".format(CHANNEL))
sds.write("WAV:PREamble?")
recv_all = sds.read_raw()
recv = recv_all[recv_all.find(b'#') + 11:]
print(len(recv))
vdiv, ofst, interval, trdl, tdiv, vcode_per, adc_bit = main_desc(recv)
print(vdiv, ofst, interval, trdl, tdiv,vcode_per,adc_bit)
points = sds.query(":ACQuire:POINts?").strip()
points = float(sds.query(":ACQuire:POINts?").strip())
one_piece_num = float(sds.query(":WAVeform:MAXPoint?").strip())
if points > one_piece_num:
sds.write(":WAVeform:POINt {}".format(one_piece_num))
if adc_bit > 8:
sds.write(":WAVeform:WIDTh WORD")
convert_data = []
if adc_bit > 8:
for i in range(0, int(len(recv_all) / 2)):
data = recv_all[2 * i + 1] * 256 + recv_all[2 * i]
convert_data.append(data)
else:
convert_data = recv_all
volt_value = []
for data in convert_data:
if data > pow(2, adc_bit - 1) - 1:
data = data - pow(2, adc_bit)
else:
pass
volt_value.append(data)
del recv, recv_all, convert_data
gc.collect()
time_value = []
for idx in range(0, len(volt_value)):
volt_value[idx] = volt_value[idx] / vcode_per * float(vdiv) - float(ofst)
time_data = - (float(tdiv) * HORI_NUM / 2) + idx * interval + float(trdl)
time_value.append(time_data)
print(len(volt_value))
pl.figure(figsize=(7, 5))
pl.plot(time_value, volt_value, markersize=2, label=u"Y-T")
pl.legend()
pl.grid()
pl.show()
if __name__=='__main__':
main_wf_data()
def get_char_bit(char,n):
return (char >> n) & 1
def main_desc(recv):
first_point = recv[0x84:0x87+1]
sp = recv[0x88:0x8b+1]
interval = recv[0xb0:0xb3+1]
delay = recv[0xb4:0xbb+1]
tdiv = recv[0x144:0x145+1]
tdiv_enum=[200e-12,500e-12,\
1e-9,2e-9,5e-9,10e-9,20e-9,50e-9,100e-9,200e-9,500e-9,\
1e-6,2e-6,5e-6,10e-6,20e-6,50e-6,100e-6,200e-6,500e-6,\
1e-3,2e-3,5e-3,10e-3,20e-3,50e-3,100e-3,200e-3,500e-3,\
1,2,5,10,20,50,100,200,500,1000]
fp = struct.unpack('i',first_point)[0]
sp = struct.unpack('i',sp)[0]
interval = struct.unpack('f',interval)[0]
delay = struct.unpack('d',delay)[0]
tdiv_index = struct.unpack('h',tdiv)[0]
tdiv = tdiv_enum[tdiv_index]
return interval,delay,tdiv
def main_new_scpi():
_rm = visa.ResourceManager()
sds = _rm.open_resource("TCPIP0::10.12.255.209::inst0::INSTR")
sds.write("WAV:SOUR D0")
sds.write("WAV:PREamble?")
recv_all = sds.read_raw()
recv = recv_all[recv_all.find(b'#')+11:]
interval,trdl,tdiv = main_desc(recv)
sds.write("WAV:DATA?")
recv_rtn = sds.read_raw().rstrip()
block_start = recv_rtn.find(b'#')
data_digit = int(recv_rtn[block_start + 1:block_start + 2])
data_start = block_start + 2 + data_digit
recv = list(recv_rtn[data_start:])
volt_value = []
data =bytearray(recv)
time_value.append(time_data)
pl.figure(figsize=(7,5))
pl.ylim(-1,2)
pl.plot(time_value,volt_value,markersize=2,label=u"Y-T")
pl.legend()
pl.grid()
pl.show()
if __name__=='__main__':
main_new_scpi()
def main_desc(recv):
interval = recv[0xb0:0xb3 + 1]
interval = struct.unpack('f', interval)[0]
return interval
def main_fft_data():
_rm = visa.ResourceManager()
sds = _rm.open_resource(SDS_RSC)
sds.write("WAV:SOUR F1")
sds.write("WAV:PREamble?")
recv_all = sds.read_raw()
recv = recv_all[recv_all.find(b'#') + 11:]
interval = main_desc(recv)
unit = sds.query("{}:FFT:UNIT?".format(FUNC)).strip()
if unit == "DBm":
load = float(sds.query("{}:FFT:LOAD?".format(FUNC)).strip())
mode = sds.query("{}:FFT:MODE?".format(FUNC)).strip()
sds.write("WAV:DATA?")
recv_all = sds.read_raw().rstrip()
block_start = recv_all.find(b'#')
data_digit = int(recv_all[block_start + 1:block_start + 2])
data_start = block_start + 2 + data_digit
recv = recv_all[data_start:]
print(len(recv))
volt_value = []
freq_value = []
len_data = int(len(recv) / 8)
print(len_data)
for i in range(0, len_data):
data_rel = struct.unpack("f", recv[8 * i:8 * i + 4])
data_imag = struct.unpack("f", recv[8 * i + 4:8 * i + 8])
data_rel = list(data_rel)[0]
data_imag = list(data_imag)[0]
if mode == "NORMal":
data_float = math.sqrt(pow(float(data_rel), 2) + pow(float(data_imag), 2))
else:
data_float = float(data_rel)
if unit == "DBVrms":
data_float = 20*math.log10(data_float)
elif unit == "DBm":
data_float = 10 * math.log10(data_float*data_float/load/1E-3)
volt_value.append(data_float)
freq_value.append(i*interval)
pl.figure(figsize=(7, 5))
pl.plot(freq_value, volt_value, markersize=2)
pl.legend()
pl.grid()
pl.show()
if __name__ == '__main__':
main_fft_data()
def main_wf_desc(recv):
data_width = recv[0x20:0x21+1]#01-16bit,00-8bit
data_order = recv[0x22:0x23+1]#01-MSB,00-LSB
WAVE_ARRAY_1 = recv[0x3c:0x3f+1]
wave_array_count = recv[0x74:0x77+1]
first_point = recv[0x84:0x87+1]
sp = recv[0x88:0x8b+1]
one_fram_pts = recv[0x74:0x77+1]#pts of single frame,maybe bigger than 12.5M
read_frame = recv[0x90:0x93+1]#all sequence frames number return by this command
sum_frame = recv[0x94:0x97+1]#all sequence frames number acquired
v_scale = recv[0x9c:0x9f+1]
v_offset = recv[0xa0:0xa3+1]
code_per_div = recv[0xa4:0Xa7 + 1]
adc_bit = recv[0xac:0Xad + 1]
sn = recv[0xae:0xaf+1]
interval = recv[0xb0:0xb3+1]
delay = recv[0xb4:0xbb+1]
tdiv = recv[0x144:0x145+1]
probe = recv[0x148:0x14b+1]
width = struct.unpack('h',data_width)[0]
order = struct.unpack('h',data_order)[0]
data_bytes = struct.unpack('i',WAVE_ARRAY_1)[0]
point_num = struct.unpack('i',wave_array_count)[0]
fp = struct.unpack('i',first_point)[0]
sp = struct.unpack('i',sp)[0]
sn = struct.unpack('h',sn)[0]
one_fram_pts = struct.unpack('i',one_fram_pts)[0]
read_frame = struct.unpack('i',read_frame)[0]
sum_frame = struct.unpack('i',sum_frame)[0]
interval = struct.unpack('f',interval)[0]
delay = struct.unpack('d',delay)[0]
tdiv_index = struct.unpack('h',tdiv)[0]
probe = struct.unpack('f',probe)[0]
vdiv = struct.unpack('f',v_scale)[0]*probe
offset = struct.unpack('f',v_offset)[0]*probe
code = struct.unpack('f', code_per_div)[0]
if ADC_BIT>8:
code = code/16
adc_bit = struct.unpack('h', adc_bit)[0]
tdiv = TDIV_ENUM[tdiv_index]
print("data_bytes=",data_bytes)
print("point_num=",point_num)
print("fp=",fp)
print("sp=",sp)
print("sn=",sn)
print("vdiv=",vdiv)
print("offset=",offset)
print("interval=",interval)
print("delay=",delay)
print("tdiv=",tdiv)
print("probe=",probe)
print("data_width=",width)
print("data_order=",order)
print("code=", code)
print("adc_bit=", adc_bit)
print("one_fram_pts=", one_fram_pts)
print("read_frame=", read_frame)
print("sum_frame=", sum_frame)
return vdiv,offset,interval,delay,tdiv,code,one_fram_pts,read_frame,sum_frame
def main_time_stamp_deal(time):
seconds = time[0x00:0x08] # type:long double
minutes = time[0x08:0x09] # type:char
hours = time[0x09:0x0a] # type:char
days = time[0x0a:0x0b] # type:char
months = time[0x0b:0x0c] # type:char
year = time[0x0c:0x0e] # type:short
seconds = struct.unpack('d',seconds)[0]
minutes = struct.unpack('c', minutes)[0]
hours = struct.unpack('c', hours)[0]
days = struct.unpack('c', days)[0]
months = struct.unpack('c', months)[0]
year = struct.unpack('h', year)[0]
months = int.from_bytes(months, byteorder='big', signed=False)
days = int.from_bytes(days, byteorder='big', signed=False)
hours = int.from_bytes(hours, byteorder='big', signed=False)
minutes = int.from_bytes(minutes, byteorder='big', signed=False)
print("{}/{}/{},{}:{}:{}".format(year,months,days,hours,minutes,seconds))
'''
Read data of all sequence frame.
PS.when total points num (single_frame_pts * frame_num) is bigger than 12.5Mpts, you have to
read more than one time.
Frames number and points number readed this time will saved in the head parameter, see
main_wf_desc.
'''
def main_all_frame(sds):
sds.write(":WAVeform:SOURce C2")
sds.write(":WAVeform:STARt 0")
sds.write(":WAVeform:POINt 0")
sds.write(":WAVeform:SEQUence 0,0")
sds.write(":WAVeform:PREamble?")
recv_all = sds.read_raw()
recv = recv_all[recv_all.find(b'#')+11:]
print(len(recv))
vdiv, ofst, interval, delay, tdiv, code, one_frame_pts, read_frame, sum_frame =
main_wf_desc(recv)
read_times = math.ceil(sum_frame/read_frame)
print("read_times=",read_times)
one_piece_num = float(sds.query(":WAVeform:MAXPoint?").strip())
for i in range(0,read_times):
sds.write(":WAVeform:SEQUence {},{}".format(0,read_frame*i+1))
if i+1 == read_times:#frame num of last read time
read_frame = sum_frame -(read_times-1)*read_frame
sds.write(":WAVeform:PREamble?")
recv_rtn = sds.read_raw()
recv_desc = recv_rtn[recv_rtn.find(b'#')+11:]
time_stamp = recv_desc[346:]
if ADC_BIT > 8:
sds.write(":WAVeform:WIDTh WORD")
sds.write(":WAVeform:DATA?")
recv_rtn = sds.read_raw().rstrip()
block_start = recv_rtn.find(b'#')
data_digit = int(recv_rtn[block_start + 1:block_start + 2])
data_start = block_start + 2 + data_digit
recv = list(recv_rtn[data_start:])
for j in range(0,read_frame):
time = time_stamp[16*j:16*(j+1)]#timestamp spends 16 bytes
main_time_stamp_deal(time)
if ADC_BIT > 8:
start = int(j * one_frame_pts*2)
end = int((j + 1) * one_frame_pts*2)
data_recv = recv[start:end]
convert_data = []
for k in range(0, int(len(data_recv) / 2)):
data_16bit = data_recv[2 * k + 1] * 256 + data_recv[2 * k]
data = data_16bit >> (16 - ADC_BIT)
convert_data.append(data)
else:
start = int(j*one_frame_pts)
end = int((j+1)*one_frame_pts)
convert_data = recv[start:end]
volt_value = []
'''
Read data of single frame.
'''
def main_specify_frame(sds,frame_num):
sds.write(":WAVeform:SOURce C2")
sds.write(":WAVeform:STARt 0")
sds.write(":WAVeform:POINt 0")
sds.write(":WAVeform:SEQUence {},{}".format(frame_num,0))
sds.timeout = 2000 # default value is 2000(2s)
sds.chunk_size = 20 * 1024 * 1024 # default value is 20*1024(20k bytes)
sds.write(":WAVeform:PREamble?")
recv_all = sds.read_raw()
recv = recv_all[recv_all.find(b'#')+11:]
time_stamp = recv[346:]
main_time_stamp_deal(time_stamp)
vdiv, ofst, interval, delay, tdiv, code,one_frame_pts, read_frame, sum_frame =
main_wf_desc(recv)
one_piece_num = float(sds.query(":WAVeform:MAXPoint?").strip())
if one_frame_pts > one_piece_num:
sds.write(":WAVeform:POINt {}".format(one_piece_num))
if ADC_BIT > 8:
sds.write(":WAVeform:WIDTh WORD")
data_recv += recv_piece
print("len(data_recv)=", len(data_recv))
convert_data = []
if ADC_BIT > 8:
for i in range(0, int(len(data_recv) / 2)):
data_16bit = data_recv[2 * i + 1] * 256 + data_recv[2 * i]
data = data_16bit >> (16 - ADC_BIT)
convert_data.append(data)
else:
convert_data = data_recv
volt_value = []
for data in convert_data:
if data > pow(2, ADC_BIT-1) - 1: # 12bit-2047,8bit-127
data = data - pow(2, ADC_BIT)
else:
pass
volt_value.append(data)
time_value = []
for idx in range(0, len(volt_value)):
volt_value[idx] = volt_value[idx] / code * float(vdiv) - float(ofst)
time_data = -(float(tdiv) * HORI_NUM / 2) + idx * interval - delay # calc ch timestamp
time_value.append(time_data)
if __name__=='__main__':
HORI_NUM = 10
_rm = visa.ResourceManager()
sds = _rm.open_resource("TCPIP0::10.12.255.135::inst0::INSTR")
main_all_frame(sds)
# main_specify_frame(sds, 5)
sds.close()
def main():
_rm = visa.ResourceManager()
sds = _rm.open_resource("USB0::0xF4EC::0xEE38::0123456789::INSTR")
sds.chunk_size = 20*1024*1024 #default value is 20*1024(20k bytes)
file_name = "F:\\SCDP.bmp"
sds.write("PRIN? BMP")
result_str = sds.read_raw()
f = open(file_name,'wb')
f.write(result_str)
f.flush()
f.close()
if __name__=='__main__':
main()
About SIGLENT
Headquarters:
SIGLENT Technologies Co., Ltd
Add: Bldg No.4 & No.5, Antongda Industrial
Zone, 3rd Liuxian Road, Bao'an District,
Shenzhen, 518101, China
Tel: + 86 755 3688 7876
Fax: + 86 755 3359 1582
Email: [email protected]
Website: int.siglent.com
North America:
SIGLENT Technologies America, Inc
6557 Cochran Rd Solon, Ohio 44139
Tel: 440-398-5800
Toll Free: 877-515-5551
Fax: 440-399-1211
Email: [email protected]
Website: www.siglentna.com
Follow us on
Facebook: SiglentTech
Europe:
SIGLENT Technologies Germany GmbH
Add: Staetzlinger Str. 70
86165 Augsburg, Germany
Tel: +49(0)-821-666 0 111 0
Fax: +49(0)-821-666 0 111 22
Email: [email protected]
Website: www.siglenteu.com