Copyright
SIGLENT TECHNOLOGIES CO., LTD. All Rights Reserved.
Trademark Information
SIGLENT is the registered trademark of SIGLENT TECHNOLOGIES CO., LTD.
Declaration
SIGLENT products are protected by patent law in and outside of P.R.C.
SIGLENT reserves the right to modify or change parts of or all the specifications or pricing policies at
company’s sole decision.
Information in this publication replaces all previously corresponding material.
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 stands in China and other
international stands conformance certification is in progress.
Contact Us
If you have any problem or requirement when using our products, please contact
SIGLENTTECHNOLOGIES CO., LTD
Add:3//F, Bldg No.4, Antongda Industrial Zone, 3rd Liuxian Road, Bao’an District, Shenzhen,
518101,P.R.China
Tel:400-878-0807
E-mail:sales@siglent.com
http://www.siglent.com
2
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Version Declaration
This chapter declares the modifications of command in the most recent release of the programming
guide version.
Version E02A at Introduction
This version, as the second new version, regulates all the currently available commands. Some of the
commands vary between series, and these will be annotated in the description of command.
The following are the main revisions:
Delete the Table of Commands & Queries, and all the instructions are classified according to the
functional modules.
Removed incorrect instructions, added instructions for WGEN and DIGITAL modules.
Add two new communication features: Telnet and Socket, visible in “Programming Overview-
Remote Control”.
Detailed programming instances for instructions (WF?/SCDP) to make it easier to understand.
Support obtaining waveform data of Digital channel and Math.
For comparison with the previous programming guide, differences have been listed in “Obsolete
Commands for Old Models”.
Version E02B at Introduction
The following are the main revisions:
Adding commands for serial trigger and decode.
Corrected the error description in the document.
Version E02C at Introduction
The following are the main revisions:
3
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Update the description and example of PNSU.
Update the notes on WF.
Increase the spacing between instruction keywords and parameters.
Add measurement commands, such as statistics and gate measurement.
Add education mode command, and classify it under system function.
Corrected the error description in the document.
Version E02D at Introduction
The following are the main revisions:
Make a distinction between different models of AWG commands.
Update the example of WF command.
4
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Content
COPYRIGHT AND DECLARATION........................................................................................................... 2
VERSION DECLARATION ........................................................................................................................ 3
VERSION E02A AT INTRODUCTION ................................................................................................................. 3
VERSION E02B AT INTRODUCTION ................................................................................................................. 3
Connect the Instrument ......................................................................................................................... 10
REMOTE CONTROL ...................................................................................................................................... 12
VC++ Example .................................................................................................................................... 314
VB Example ......................................................................................................................................... 321
MATLAB Example ............................................................................................................................... 326
LabVIEW Example .............................................................................................................................. 328
C# Example ......................................................................................................................................... 331
EXAMPLES OF USING SOCKETS .................................................................................................................. 333
Python Example .................................................................................................................................. 333
C Example ........................................................................................................................................... 336
COMMON COMMAND EXAMPLES ................................................................................................................. 338
Read Waveform Data (WF) Example .................................................................................................. 338
Read Waveform Data of Digital Example ............................................................................................ 339
Screen Dump (SCDP) Example .......................................................................................................... 341
This chapter introduces how to build communication between the instrument and the PC. It also
introduces how to configure a system for remote instrument control.
By using USB and LAN interfaces, in combination with NI-VISA and programming languages, users
can remotely control the instruments. Through LAN interface, VXI-11, Sockets and Telnet protocols
can be used to communicate with the instruments.
Establishing Communications
Install NI-VISA
Before programming, you need to install the National Instruments NI-VISA library, which you can
download from the National Instruments web site.
Currently, NI-VISA is packaged in two versions: a full version and a Run-Time Engine version. The
full version includes the NI device drivers and a tool named NI MAX which is a user interface to
control and test remotely connected devices. The Run-Time Engine is recommended, as it is a much
smaller download than the full version and includes the necessary tools for basic communication to
instruments.
For example, you can get the NI-VISA 5.4 full version from: http://www.ni.com/download/ni-visa-
5.4/4230/en/.
You also can download NI-VISA Run-Time Engine 5.4 to your PC and install it as the default
selection. Its installation process is similar with the full version.
After you downloaded the file, follow these steps to install NI-VISA (The full version of NI-VISA 5.4 is
used in this example. Newer versions are likely, and should be compatible with SIGLENT
instrumentation. Download the latest version available for the operating system being used by the
controlling computer):
a. Double click the visa540_full.exe, dialog shown as below:
7
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
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.
8
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
d. Set the install path, default path is “C:\Program Files\National Instruments\”, you can change it.
Click Next, dialog shown as above.
e. Click Next twice, in the License Agreement dialog, select the “I accept the above 2 License
Agreement(s).”,and click Next, dialog shown as below:
9
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
f. Click Next to begin installation.
g. Now the installation is complete. Reboot your PC.
Connect the Instrument
Depending on the specific model, your oscilloscope may be able to communicate with a PC through
the USB or LAN interface.
10
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
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.
11
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Remote Control
User-defined Programming
Users can use SCPI commands via a computer to program and control the digital oscilloscope. For
details, refer to the introductions in "Programming Examples".
Send SCPI Commands via NI-MAX
NI-Measurement and Automation eXplorer (NI-MAX) is a program created and maintained by
National Instruments. It provides a basic remote control interface for VXI, LAN, USB, GPIB, and
Serial communications. It is a utility that enables you to send commands one-at-a-time and also
retrieve data from connected devices. It is a great tool for troubleshooting and testing command
sequences. The oscilloscopes can be controlled remotely by sending SCPI commands via NI-MAX.
Using SCPI with Telnet
Telnet provides a means of communicating with the oscilloscopes over a LAN connection. The Telnet
protocol sends SCPI commands to the oscilloscopes from a PC and is similar to communicating with
the oscilloscopes over USB. It sends and receives information interactively: one command at a time.
Windows operating systems use a command prompt style interface for the Telnet client. The steps
are as follows:
1. On your PC, click Start > All Programs > Accessories > Command Prompt.
2. At the command prompt, type in
3. Press the Enter key. The Telnet display screen will be displayed.
telnet
.
12
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
4. At the Telnet command line, type:
open XXX.XXX.XXX.XXX 5024
Where
response similar to the following:
XXX.XXX.XXX.XXX
is the instrument’s IP address and 5024 is the port. You should see a
5. At the SCPI> prompt, input the SCPI commands such as
model number, serial number, and firmware version number.
*IDN?
to return the company name,
13
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
6. To exit the SCPI> session, press the Ctrl+] keys simultaneously.
7. Type
exit Telnet.
quit
at the prompt or close the Telnet window to close the connection to the instrument and
Using SCPI with Sockets
Socket API can be used to control the SDS1000X-E series via LAN without installing any other
libraries. This can reduce the complexity of programming.
SOCKET ADDRESS IP address + port number
IP ADDRESS SDS IP address
PORT NUMBER 5025
Please see section "Examples of Using Sockets" for the details.
14
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Applicable to the following models
SDS1000CFL
non-SPO model
SDS1000A
non-SPO model
SDS1000CML+/CNL+/DL+/E+/F+
non-SPO model
SDS2000/2000X
SPO model
SDS1000X/1000X+
SPO model
SDS1000X-E/X-C
SPO model
Introduction to the SCPI Language
About Commands & Queries
This section lists and describes the remote control commands and queries recognized by the
instrument. All commands and queries can be executed in either local or remote state.
The description for each command or query, with syntax and other information, begins on a new page.
The name (header) is given in both long and short form at the top of the page, and the subject is
indicated as a command or query or both.
The commands are given in long format for the “COMMAND SYNTAX” and “QUERY SYNTAX”
sections and they are used in a short form for the “EXAMPLE”.
Queries perform actions such as obtaining information, and are recognized by the question mark (?)
following the header.
Description
In the description, a brief explanation of the function performed is given. This is followed by a
presentation of the formal syntax, with the header given in upper case characters and the short form
derived from it. Where applicable, the syntax of the query is given with the format of its response.
Usage
The commands and queries listed here can be used for SIGLENTs Digital Oscilloscope Series as
shown below. Models are arranged according to their initial release dates.
15
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
SDS2000X-E
SPO model
SDS1000X-U
SPO model
What is an SPO model?
Oscilloscope models that have the SPO designation use SIGLENTs innovative waveform acquisition
and graphics processing engine which supports high capture rate, multi-level intensity grading and
color temperature display. SPO models also come with deep memory storage and the use of new
digital trigger technology that supports rich precise trigger types.
Command Notation
The following notations are used in the commands:
< > Angular brackets enclose words that are used as placeholders, of which there are two types: the
header path and the data parameter of a command.
:= A colon followed by an equals sign separates a placeholder from the description of the type and
range of values that may be used in a command instead of the placeholder.
{ } Braces enclose a list of choices, one of which one must be made.
[ ] Square brackets enclose optional items.
An ellipsis indicates that the items both to its left and right may be repeated for a number of times.
As an example, consider the syntax notation for the command to set the vertical input sensitivity:
<channel>:VOLT_DIV <v_gain>
<channel>:={C1,C2,C3,C4}
<v_gain>:= 2 mV to 10 V
The first line shows the formal appearance of the command, with <channel> denoting the placeholder
for the header path and <v_gain> the placeholder for the data parameter specifying the desired
vertical gain value. The second line indicates that one of four channels must be chosen for the header
path. And the third explains that the actual vertical gain can be set to any value between 2 mV and 10
V.
16
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Commands & Queries
This chapter introduces each command subsystem of the SIGLENTs Digital Oscilloscope Series
command set. The contents of this chapter are shown as below:
COMMON (*) Commands
COMM_HEADER Commands
ACQUIRE Commands
AUTOSET Commands
CHANNEL Commands
CURSOR Commands
DIGITAL Commands
DISPLAY Commands
HISTORY Commands
MATH Commands
MEASURE Commands
PASS/FAIL Commands
PRINT Commands
RECALL Commands
REFERENCE Commands
SAVE Commands
STATUS Commands
SYSTEM Commands
TIMEBASE Commands
TRIGGER Commands
SERIAL TRIGGER Commands
WGEN Commands
Obsolete Commands for Old Models
17
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
COMMON (*) Commands
The IEEE 488.2 standard defines some general commands for querying the basic information of an
instrument or performing common basic operations. These commands usually start with *, and the
command key length is 3 characters.
The *IDN? query identifies the instrument type and
software version. The response consists of four different
fields providing information on the manufacturer, the
scope model, the serial number and the firmware revision.
<model>:= the model number of the instrument
<serial number>:= A 14-digit decimal code.
<firmware>:= the software revision of the instrument
EXAMPLE
The query identifies the instrument type and software
version.
Command message:
*IDN?
Response message:
Siglent
Technologies,SDS1204X-
E,SDS1EBAC0L0098,7.6.1.15
19
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
COMMON (*)
*OPC
Command/Query
DESCRIPTION
The *OPC command sets the operation complete bit in the
Standard Event Status Register when all pending device
operations have finished.
The *OPC? query places an ASCII "1" in the output queue
when all pending device operations have completed. The
interface hangs until this query returns.
COMMAND SYNTAX
*OPC
QUERY SYNTAX
*OPC?
RESPONSE FORMAT
*OPC 1
20
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
COMMON (*)
*RST
Command
DESCRIPTION
The *RST command initiates a device reset. This is the
same as pressing Default on the front panel.
COMMAND SYNTAX
*RST
EXAMPLE
This example resets the oscilloscope.
Command message:
*RST
21
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
COMM_HEADER Commands
CHDR
22
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
COMM_HEADER
COMM_HEADER | CHDR
Command/Query
DESCRIPTION
The COMM_HEADER command controls the way the
oscilloscope formats response to queries. This command
does not affect the interpretation of messages sent to the
oscilloscope. Headers can be sent in their long or short
form regardless of the CHDR setting.
Examples of the three response formats to “C1:VDIV?”:
CHDR
RESPONSE
LONG
C1:VOLT_DIV 1.00E+01V
SHORT
C1:VDIV 1.00E+01V
OFF
1.00E+01
COMMAND SYNTAX
COMM_HEADER <mode>
<mode>:= {SHORT,LONG,OFF}
SHORT— response with the short form of the header
word.
LONG— response with the long form of the header word.
OFF— header is omitted from the response and units in
numbers are suppressed.
Note:
Default is the SHORT response format.
QUERY SYNTAX
COMM_HEADER?
RESPONSE FORMAT
COMM_HEADER <mode>
EXAMPLE
The following command sets the response header format
to SHORT.
Command message:
CHDR SHORT
23
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE Commands
The ACQUIRE subsystem controls the way in which waveforms are acquired. These commands set
the parameters for acquiring and storing data.
The ARM_ACQUISITION command starts a new signal
acquisition.
COMMAND SYNTAX
ARM_ACQUISITION
EXAMPLE
The following steps show the effect of ARM.
Note:
INR bit 13 (8192) = Trigger is ready.
INR bit 0 (1) = New Signal Acquired.
Step 1: Set the trigger mode to single, and input a signal
which can be triggered. Once triggered, you can see the
state of acquisition changes to stop. Send the query.
Query message:
INR?
Response message:
INR 8193
(trigger ready)
Step 2: Send the query again to clear the register.
Query message:
INR?
Response message:
INR 0
Step 3: Now, send the command to start a new signal
acquisition.
Command message:
ARM
Step 4: Send the query to see the effect of ARM.
Query message:
INR?
Response message:
25
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
INR 8193
RELATED COMMANDS
STOP
TRMD
INR?
26
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE
STOP
Command
DESCRIPTION
The STOP command stops the acquisition. This is the
same as pressing the Stop key on the front panel.
COMMAND SYNTAX
STOP
EXAMPLE
The following command stops the acquisition process.
Command message:
STOP
RELATED COMMANDS
ARM
TRMD
27
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE
ACQUIRE_WAY | ACQW
Command/Query
DESCRIPTION
The ACQUIRE_WAY command specifies the acquisition
mode.
The ACQUIRE_WAY? query returns the current
acquisition mode.
SAMPLING — sets the oscilloscope in the normal mode.
PEAK_DETECT — sets the oscilloscope in the peak
detect mode.
AVERAGE — sets the oscilloscope in the averaging
mode.
HIGH_RES — sets the oscilloscope in the enhanced
resolution mode (also known as smoothing). This is
essentially a digital boxcar filter and is used to reduce
noise at slower sweep speeds.
Note:
The [HIGH_RES] option is valid for SPO models. See
models on page 15.
<time>:={4,16,32,64,128,256,512,…} when <mode> =
AVERAGE.
Options vary from models. See the data sheet or the
acquire menu of the oscilloscope.
QUERY SYNTAX
ACQUIRE_WAY?
28
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
RESPONSE FORMAT
ACQUIRE_WAY <mode>[,<time>]
EXAMPLE
The following command sets the acquisition mode to
average mode and also sets the average time to 16.
Command message:
ACQW AVERAGE,16
RELATED COMMANDS
AVGA
29
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE
AVERAGE_ACQUIRE | AVGA
Command/Query
DESCRIPTION
The AVERAGE_ACQUIRE command selects the average
times of average acquisition.
The AVERAGE_ACQUIRE? query returns the currently
selected count value for average mode.
COMMAND SYNTAX
AVERAGE_ACQUIRE <time>
<time>:= {4,16,32,64,128,256,…}
Note:
Options of <time> vary from models. See the data sheet or
the acquire menu of the oscilloscope for details.
QUERY SYNTAX
AVERAGE_ACQUIRE?
RESPONSE FORMAT
AVERAGE_ACQUIRE <time>
EXAMPLE
The following command turns the average times of
average acquisition to 16.
Command message:
AVGA 16
RELATED COMMANDS
ACQW
30
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE
MEMORY_SIZE | MSIZ
Command/Query
DESCRIPTION
The MEMORY_SIZE command sets the maximum depth
of memory.
The MEMORY_SIZE? query returns the maximum depth
of memory.
COMMAND SYNTAX
MEMORY_SIZE <size>
<size>:={7K,70K,700K,7M} for non-interleaved mode.
Non-interleaved means a single channel is active per A/D
converter. Most oscilloscopes feature two channels per
A/D converter.
<size>:={14K,140K,1.4M,14M} for interleave mode.
Interleave mode means multiple active channels per A/D
converter.
Note:
Options of <size> vary from models. See the data sheet or
the acquire menu of the oscilloscope for details.
QUERY SYNTAX
MEMORY_SIZE?
RESPONSE FORMAT
MEMORY_SIZE <size>
EXAMPLE
The following command sets the maximum depth of
memory to 14M in interleave mode.
Command message:
MSIZ 14M
31
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE
SAMPLE_STATUS? | SAST?
Query
DESCRIPTION
The SAST? query returns the acquisition status of the
scope.
QUERY SYNTAX
SAST?
RESPONSE FORMAT
SAST <status>
EXAMPLE
The following query returns the acquisition status of the
scope.
Query message:
SAST?
Response message:
SAST Trig'd
32
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE
SAMPLE_RATE? | SARA?
Query
DESCRIPTION
The SARA? query returns the sample rate of the scope.
QUERY SYNTAX
SARA?
DI:SARA?
DI — digital.
RESPONSE FORMAT
SARA <value>
DI:SARA <value>
Model
Format of <value>
SDS1000X-E/
SDS2000X-E/
SDS1000X-U
Numerical value in E-notation with
SI unit, such as 5.00E+08Sa/s.
others
Numerical value with measurement
unit and physical unit, such as 1.00
GSa/s.
EXAMPLE
The following query returns the sample rate of the analog
channel.
Query message:
SARA?
Response message:
SARA 5.00E+05Sa/s
The following query returns the sample rate of the digital
channel.
Query message:
DI:SARA?
Response message:
DI:SARA 5.00E+05Sa/s
Note:
The table shows the availability of “DI:SARA?” in each digital oscilloscope series.
33
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Model
Valid?
SDS2000X
no
SDS1000X
no
SDS1000X-E
yes
SDS2000X-E
yes
34
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE
SAMPLE_NUM? | SANU?
Query
DESCRIPTION
The SANU? query returns the number of data points that
the hardware will acquire from the input signal. The
number of points acquired is based on the horizontal scale
and memory/acquisition depth selections and cannot be
directly set.
QUERY SYNTAX
SANU? <channel>
<channel>:={C1,C2,C3,C4}
RESPONSE FORMAT
SANU <value>
Model
Format of <value>
SDS1000X-E/
SDS2000X-E/
SDS1000X-U
Numerical value in E-notation with
SI unit, such as 7.00E+05pts.
SDS2000/2000X
/1000X/1000X+
Numerical value with measurement
unit and physical unit, such as
28Mpts.
others
Numerical value, such as 1600.
EXAMPLE
The following query returns the number of sampled points
available from last acquisition from Channel 2.
Query message:
SANU? C2
Response message:
SANU 7.00E+05pts
35
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE
SINXX_SAMPLE | SXSA
Command/Query
DESCRIPTION
The SINXX_SAMPLE command sets the way of
interpolation.
The SINXX_SAMPLE? query returns the way of
interpolation.
COMMAND SYNTAX
SINXX_SAMPLE <state>
<state>:={ON,OFF}
ON — sine interpolation.
OFF — linear interpolation.
QUERY SYNTAX
SINXX_SAMPLE?
RESPONSE FORMAT
SINXX_SAMPLE <state>
EXAMPLE
The following command sets the way of the interpolation
to sine interpolation.
Command message:
SXSA ON
36
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE
XY_DISPLAY | XYDS
Command/Query
DESCRIPTION
The XY_DISPLAY command enables or disables the
display of XY mode. XY mode plots the voltage data of
both channels with respect to one-another. For example,
channel 1 vs. channel 2. This can be used to create
lissajous curves. The standard display mode plots voltage
data vs. time.
The XY_DISPLAY? query returns whether the XY format
display is enabled.
COMMAND SYNTAX
XY_DISPLAY <state>
<state>:={ON,OFF}
QUERY SYNTAX
XY_DISPLAY?
RESPONSE FORMAT
XY_DISPLAY <state>
EXAMPLE
The following command enables the XY format.
Command message:
XYDS ON
37
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
AUTOSET Commands
The AUTOSET subsystem commands control the function of automatic waveform setting. The
oscilloscope will automatically adjust the vertical position, the horizontal time base and the trigger
mode according to the input signal to make the waveform display to the best state.
ASET
38
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
AUTOSET
AUTO_SETUP | ASET
Command
DESCRIPTION
The AUTO_SETUP command attempts to identify the
waveform type and automatically adjusts controls to
produce a usable display of the input signal.
COMMAND SYNTAX
AUTO_SETUP
EXAMPLE
The following command instructs the oscilloscope to
perform an auto-setup.
Command message:
ASET
39
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CHANNEL Commands
The CHANNEL subsystem commands control the analog channels. Channels are independently
programmable for offset, probe, coupling, bandwidth limit, inversion, and more functions. The channel
index (1, 2, 3, or 4) specified in the command selects the analog channel that is affected by the
command.
ATTN
BWL
CPL
OFST
SKEW
TRA
UNIT
VDIV
INVS
40
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CHANNEL
ATTENUATION | ATTN
Command/Query
DESCRIPTION
The ATTENUATION command specifies the probe
attenuation factor for the selected channel. The probe
attenuation factor may be 0.1 to 10000.This command
does not change the actual input sensitivity of the
oscilloscope. It changes the reference constants for
scaling the display factors, for making automatic
measurements, and for setting trigger levels.
The ATTENUATION? query returns the current probe
attenuation factor for the selected channel.
The following command sets the attenuation factor of
Channel 1 to 100:1. To ensure the data matches the true
signal voltage values, the physical probe attenuation must
match the scope attenuation values for that input channel.
Command message:
C1:ATTN 100
RELATED COMMANDS
VDIV
OFST
41
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CHANNEL
BANDWIDTH_LIMIT | BWL
Command/Query
DESCRIPTION
BANDWIDTH_LIMIT enables or disables the bandwidthlimiting low-pass filter. If the bandwidth filters are on, it will
limit the bandwidth to reduce display noise. When you turn
Bandwidth Limit ON, the Bandwidth Limit value is set to 20
MHz. It also filters the signal to reduce noise and other
unwanted high frequency components.
The BANDWIDTH_LIMIT? query returns whether the
bandwidth filters are on.
Note:
Options of <coupling> vary from models. See the data
sheet or the channel menu of oscilloscope for details.
QUERY SYNTAX
<channel>:COUPLING?
RESPONSE FORMAT
<channel>:COUPLING <coupling>
EXAMPLE
The following command sets the coupling of Channel 2 to
50 Ω, DC.
Command message:
C2:CPL D50
43
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CHANNEL
OFFSET | OFST
Command/Query
DESCRIPTION
The OFFSET command allows adjustment of the vertical
offset of the specified input channel. The maximum ranges
depend on the fixed sensitivity setting.
The OFFSET? query returns the offset value of the
specified channel.
COMMAND SYNTAX
<channel>:OFFSET <offset>
<channel>:={C1,C2,C3,C4}
<offset>:= vertical offset value with unit, see the data
sheet for details.
Note:
If there is no unit (V/mV/uV) added, it defaults to volts
(V).
If you set the offset to a value outside of the legal range,
the offset value is automatically set to the nearest legal
value. Legal values are affected by the probe attenuation
setting.
QUERY SYNTAX
<channel>:OFFSET?
RESPONSE FORMAT
<channel>:OFFSET <offset>
<offset>:= Numerical value in E-notation with SI unit.
EXAMPLE
The following command sets the offset of Channel 2 to -3
V.
Command message:
C2:OFST -3V
The following command sets the offset of Channel 1 to 50 mV.
44
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Command message:
C1:OFST -50mV
RELATED COMMANDS
VDIV
ATTN
45
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CHANNEL
SKEW
Command/Query
DESCRIPTION
The SKEW command sets the channel-to-channel skew
factor for the specified channel. Each analog channel can
be adjusted + or -100 ns for a total of 200 ns difference
between channels. You can use the oscilloscope's skew
control to remove cable-delay errors between channels.
The SKEW? query returns the skew value of the specified
trace.
COMMAND SYNTAX
<trace>:SKEW <skew>
<trace>:={C1,C2,C3,C4}
<skew>:= -100 ns to +100 ns.
QUERY SYNTAX
<trace>:SKEW?
RESPONSE FORMAT
<trace>:SKEW <skew>
Model
Format of <skew>
SDS1000X-E /
SDS2000X-E/
SDS1000X-U
Numerical value in E-notation with
SI unit, such as 9.99E-08S.
others
Numerical value with measurement
unit and physical unit, such as
0.00ns.
EXAMPLE
The following command sets skew value of Channel 1 to
3ns.
Command message:
C1:SKEW 3NS
46
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CHANNEL
TRACE | TRA
Command/Query
DESCRIPTION
The TRACE command turns the display of the specified
channel on or off.
The TRACE? query returns the current display setting for
the specified channel.
COMMAND SYNTAX
<trace>:TRACE <mode>
<trace>:={C1,C2,C3,C4}
<mode>:={ON,OFF}
QUERY SYNTAX
<trace>:TRACE?
RESPONSE FORMAT
<trace>:TRACE <mode>
EXAMPLE
The following command displays Channel 1.
Command message:
C1:TRA ON
47
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CHANNEL
UNIT
Command /Query
DESCRIPTION
The UNIT command sets the unit of the specified trace.
Measurement results, channel sensitivity, and trigger level
will reflect the measurement units you select.
The UNIT? query returns the unit of the specified trace.
COMMAND SYNTAX
<channel>:UNIT <type>
<channel>:={C1,C2,C3,C4}
<type>:={V,A}
QUERY SYNTAX
<channel>:UNIT?
RESPONSE FORMAT
<channel>:UNIT <type>
EXAMPLE
The following command sets the unit of Channel 1 to V.
Command message:
C1:UNIT V
48
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CHANNEL
VOLT_DIV | VDIV
Command /Query
DESCRIPTION
The VOLT_DIV command sets the vertical sensitivity in
Volts/div.
If the probe attenuation is changed, the scale value is
multiplied by the probe's attenuation factor.
The VOLT_DIV? query returns the vertical sensitivity of
the specified channel.
COMMAND SYNTAX
<channel>:VOLT_DIV <v_gain>
<channel>:={C1,C2,C3,C4}
<v_gain>:= 500uV to 10V.
Note:
If there is no unit (V/mV/uV) added, it defaults to volts (V).
QUERY SYNTAX
<channel>:VOLT_DIV?
RESPONSE FORMAT
<channel>:VOLT_DIV <v_gain>
<v_gain>:= Numerical value in E-notation with SI unit.
EXAMPLE
The following command sets the vertical sensitivity of
Channel 1 to 50 mV/div.
Command message:
C1:VDIV 50mV
RELATED COMMANDS
ATTN
49
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CHANNEL
INVERTSET | INVS
Command/Query
DESCRIPTION
The INVERTSET command mathematically inverts the
specified traces or the math waveform.
The INVERTSET? query returns the current state of the
channel inversion.
COMMAND SYNTAX
<trace>:INVERTSET <state>
<trace>:={C1,C2,C3,C4,MATH}
<state>:= {ON,OFF}
QUERY SYNTAX
<trace>:INVERTSET?
RESPONSE FORMAT
<trace>:INVERTSET <state>
EXAMPLE
The following command inverts the trace of Channel 1.
Command message:
C1:INVS ON
50
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CURSOR Commands
The CURSOR subsystem commands set and query the settings of X-axis markers(X1 and X2 cursors)
and the Y-axis markers (Y1 and Y2 cursors). You can set and query the marker mode and source,
the position of X and Y cursors, and query delta X and delta Y cursor values.
CRMS
CRST
CRTY
CRVA?
51
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CURSOR
CURSOR_MEASURE | CRMS
Command/Query
DESCRIPTION
The CURSOR_MEASURE command specifies the type of
cursor or parameter measurement to be displayed
The CURSOR_MEASURE? query returns which cursors
or parameter measurements are currently displayed.
COMMAND SYNTAX
CURSOR_MEASURE <mode>
Format 1:
<mode>:={OFF,ON}
OFF — manual mode.
ON — track mode.
Format 2:
<mode>:={OFF,MANUAL,TRACK}
OFF — close the cursors.
MANUAL — manual mode.
TRACK — track mode.
Note:
The table on next page shows the available command
format in each oscilloscope series.
QUERY SYNTAX
CURSOR_MEASURE?
RESPONSE FORMAT
CURSOR_MEASURE <mode>
EXAMPLE
The following command sets cursor function off on
SDS1000X-E.
Command message:
CRMS OFF
The following command sets cursor mode to track mode
52
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
on SDS1000X.
Command message:
CRMS ON
RELATED COMMANDS
CRVA?
CRST
Model
Command Format
SDS1000CFL
Format 1
SDS1000A
Format 1
SDS1000CML+/CNL+/DL+/E+/F+
Format 1
SDS2000X
Format 1
SDS1000X
Format 1
SDS1000X-E
Format 2
SDS2000X-E
Format 2
SDS1000X-U
Format 2
Format in Each Oscilloscope Series
53
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CURSOR
CURSOR_SET | CRST
Command/Query
DESCRIPTION
The CURSOR_SET command allows the user to position
any one of the four independent cursors at a given screen
location. The positions of the cursors can be modified or
queried even if the required cursor is not currently
displayed on the screen. When setting a cursor position, a
trace must be specified, relative to which the cursor will be
positioned.
The CURSOR_SET? query returns the current position of
the cursor(s). The values returned depend on the grid
type selected.
<trace>:={C1,C2,C3,C4}
<cursor>:={VREF,VDIF,TREF,TDIF,HRDF,HDIF}
VREF — The voltage-value of Y1 (curA) under manual
mode.
VDIF — The voltage-value of Y2 (curB) under manual
mode.
TREF — The time value of X1 (curA) under manual
mode.
TDIF — The time value of X2 (curB) under manual mode.
HREF — The time value of X1 (curA) under track mode.
HDIF — The time value of X2 (curB) under track mode.
<position>:= -(grid/2)*DIV to (grid/2)*DIV when <cursor>=
{TREF,TDIF, HRDF, HDIF} (horizontal)
grid: The grid numbers in horizontal direction.
<position>:= -4*DIV to 4*DIV when <cursor>=
{VREF,VDIF} (vertical)
54
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Note:
The horizontal position range is related to the size of
screen.
You need to add the unit to the position value.
When the current time base is 1 us, vdiv is 500 mV, the
cursor mode is manual, the following command sets the
X1 positions to -3 DIV, Y2 position to −1 DIV, using
Channel 1 as a reference.
Command message:
C1:CRST TREF,-3us,VDIF,-500mV
When the current time base is 1 us, the cursor mode is
track, the following command sets the X1 positions to -1
DIV, X2 position to 2 DIV, using Channel 1 as a reference.
Command message:
C1:CRST HREF,-1us,HDIF,2us
RELATED COMMANDS
CRMS
CRVA?
55
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CURSOR
CURSOR_TYPE | CRTY
Command/Query
DESCRIPTION
The CURSOR_TYPE command specifies the type of
cursor to be displayed when the cursor mode is manual.
The CURSOR_TYPE query returns the current type of
cursor.
COMMAND SYNTAX
CURSOR_TYPE <type>
<mode>:={X,Y,X-Y}
QUERY SYNTAX
CURSOR_TYPE?
RESPONSE FORMAT
CURSOR_TYPE <type>
EXAMPLE
The following command sets cursor type to Y.
Command message:
CRTY Y
RELATED COMMANDS
CRMS
56
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CURSOR
CURSOR_VALUE? | CRVA?
Query
DESCRIPTION
The CURSOR_VALUE? query returns the values
measured by the specified cursors for a given trace.
QUERY SYNTAX
<trace>:CURSOR_VALUE? <mode>
<trace>:= {C1,C2,C3,C4}
<mode>:= {HREL,VREL}
HREL — return the delta time value,reciprocal of delta
time value, X1 (curA) time value and X2 (curB) time value.
VREL — return the delta volt value, Y1 (curA) volt value
and Y2 (curB) volt value under manual mode.
Note:
For non-SPO models, VREL is the delta volt value under
manual mode. See models on page 15.
When the cursor mode is manual, and the cursor type is
Y, the following query returns the vertical value on channel
1.
57
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Query message:
C1:CRVA? VREL
Response message:
C1:CRVA VREL,-5.00E+00V,2.50E+00V,-2.50E+00V
RELATED COMMANDS
CRMS
58
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Model
Valid?
SDS1000CFL
no
SDS1000A
no
SDS1000CML+/CNL+/DL+/E+/F+
no
SDS2000X
no
SDS1000X
no
SDS1000X-E
yes
SDS2000X-E
yes
SDS1000X-U
yes
DECODE Commands
The DECODE subsystem commands control the serial protocols and parameters for each serial bus
decode. They control the serial decode bus viewing, and other options.
Availability of Decode Commands in Each Oscilloscope Series
59
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DECODE
DCST
Command/Query
DESCRIPTION
The DCST command is used to set the state of decode.
The DCST? query returns the state of decode.
COMMAND SYNTAX
DCST <state>
<state>:={OFF,ON}
QUERY SYNTAX
DCST?
RESPONSE FORMAT
DCST <state>
EXAMPLE
The following command sets Decode function on.
Command message:
DCST ON
60
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DECODE
DCPA
Command
DESCRIPTION
The DCPA command is used to set the common
parameters of serial decode bus.
COMMAND SYNTAX
DCPA <param>,<value>[,<param>,<value>[,..]]
<param>
<value>
BUS
{B1,B2}
LIST
{OFF,D1,D2}
FOMT
{BIN,DEC,HEX}
LINK
{TR_TO_DC,DC_TO_TR}
LSSC
1 to lines of list
LSNM
1 to 7
BUS— Decode bus, set B1 as BUS1 and B2 as BUS2.
LIST— Decode list, set OFF to turn off the list, set D1 to
select the list of bus1 and set D2 to select the list of bus2.
FOMT— Format of the decode data.
LINK— Copy setting, set TR_TO_DC to copy from
trigger, and set DC_TO_TR to copy to trigger.
LSSC— List scroll.
LSNM— List lines.
EXAMPLE
The following command sets the current decode bus to
bus1 separately.
Command message:
DCPA BUS,B1
The following command sets the current decode bus to
bus2, set format of bus2 data to hex, select the list of bus2
and set the list lines to 5.
Command message:
DCPA BUS,B2,LIST,D2,FOMT,HEX,LSNM,5
61
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DECODE
B<n>:DCIC
Command
DESCRIPTION
The B<n>:DCIC command is used to set the parameters
of IIC decode bus.
DIS— Display the current bus.
SCL— Set the SCL source for the IIC bus.
SCLT— Set the threshold of the SCL.
SDA— Set the SDA source for the IIC bus.
SDAT— Set the threshold of the SDA.
RW— Set whether the read/write bit is included in the
address. Set on to include and set off to not include.
Note:
You need add the volt unit (V) to the value. If there is no
unit added, it defaults to be V.
Only international unit (V) is supported at present.
The range of value is related to the vertical scale of the
source.
EXAMPLE
The following command sets the threshold of SCL source
62
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
for IIC bus2 to 200mv separately.
Command message:
B2:DCIC SCLT,0.2V
The following command sets IIC bus1 to display, sets the
SCL source to D0, sets the SDA source to D1, and
includes the R/W bit in the address.
Command message:
B1:DCIC DIS,ON,SCL,D0,SDA,D1,RW,ON
63
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DECODE
B<n>:DCSP
Command
DESCRIPTION
The B<n>:DCSP command is used to set the parameters
of SPI decode bus.
DIS— Display the current bus.
CLK— Set the CLK source for the SPI bus.
CLK— Set the threshold of the CLK.
64
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
EDGE— Set the edge of the clock that data latched on.
MISO— Set the MISO source for the SPI bus.
MISOT— Set the threshold of the MISO.
MOSI— Sets the MISO source for the SPI bus.
MOSIT— Set the threshold of the MISO.
CSTP— Set the chip selection type for the SPI bus.
CS— Set the CS source for the SPI bus.
CST— Set the threshold of the CS.
NCS—Set the ~CS source for the SPI bus.
NCST— Set the threshold of the ~CS.
TIM— Set the timeout value when the CS type is CLK
Timeout.
BIT— Set the bit order for the SPI bus.
DLEN— Set the data length for the SPI bus.
Note:
You need add the volt unit (V) or time unit (S) to the
value. If there is no unit added, it defaults to be V or S.
Only international unit (V/S) is supported at present.
The range of threshold value is related to the vertical
scale of the source.
EXAMPLE
The following command sets the threshold of CLK source
for SPI bus2 to 200mV separately.
Command message:
B2:DCSP CLKT,0.2V
The following command sets SPI bus1 to display, sets
the CLK source to D0, sets the MOSI source to D1, sets
the CS type to TIMEOUT and the timeout value to 2us,
sets the bit order to MSB, and set the data length to 32.
Command message:
DIS— Display the current bus.
RX— Set the RX source for the UART bus.
RXT— Set the threshold of the RX.
TX— Set the TX source for the UART bus.
TXT— Set the threshold of the TX.
BAUD— Set the baud rate for the UART bus.
DLEN— Set the data length for the UART bus.
PAR— Set the parity check for the UART bus.
STOP— Set the length of stop bit for the UART bus.
POL— Set the idle level for the UART bus.
BIT— Sets the bit order for the UART bus.
66
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Note:
You need add the volt unit (V) to the value. If there is no
unit added, it defaults to be V.
Only international unit (V) is supported at present.
The range of value is related to the vertical scale of the
source.
EXAMPLE
The following command sets the threshold of RX source
for UART bus2 to 200mV separately.
Command message:
B2:DCUT RX,0.2V
The following command sets UART bus1 to display, sets
the RX source to D0, sets the baud rate to 9600 bit/s, sets
the parity check to ODD, sets the stop bit length to 2, sets
the idle level to HIGH and the bit order to MSB.
Command message:
DIS— Display the current bus.
CANH— Set the CANH source for the CAN bus.
CANHT— Set the threshold of the CANH.
CANL— Set the CANL source for the CAN bus.
CANLT— Set the threshold of the CANL.
SRC— Set the decode source for the CAN bus.
BAUD— Set the baud rate for the CAN bus.
Note:
You need add the volt unit (V) to the value. If there is no
unit added, it defaults to be V.
Only international unit (V) is supported at present.
The range of value is related to the vertical scale of the
source.
68
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
EXAMPLE
The following command sets the threshold of CANH
source for CAN bus2 to 200mV separately.
Command message:
B2:DCCN CANH,0.2V
The following command sets CAN bus1 to display, sets
the CANH source to D0, sets the decode source to CANH
and the baud rate to 9600 bit/s.
Command message:
B1:DCCN DIS,ON,CANH,D0,SRC,CANH,BAUD,9600
69
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DECODE
B<n>:DCLN
Command
DESCRIPTION
The B<n>:DCLN command is used to set the parameters
of LIN decode bus.
For SDS1000X+ series, the following command sets D8
display on.
Command message:
D8:DGCH ON
Model
Valid?
SDS2000X
yes
SDS1000X
yes
SDS1000X-E
no
SDS2000X-E
no
Note:
The table below shows the availability of command in each oscilloscope series.
73
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DIGITAL
DIGITAL_STATE | DGST
Command/Query
DESCRIPTION
The DIGITAL_STATE command is used to set the state of
digital.
The DIGITAL_STATE? query returns the state of digital.
COMMAND SYNTAX
DIGITAL_STATE <state>
<state>:={OFF,ON}
QUERY SYNTAX
DIGITAL_STATE?
RESPONSE FORMAT
DIGITAL_STATE <state>
EXAMPLE
For SDS1000X+ series, the following command sets
Digital function on.
Command message:
DGST ON
Model
Valid?
SDS2000X
yes
SDS1000X
yes
SDS1000X-E
no
SDS2000X-E
no
Note:
The table below shows the availability of command in each oscilloscope series.
74
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DIGITAL
DIGITAL_THR | DGTH
Command/Query
DESCRIPTION
The DIGITAL_THR command sets the threshold for the
specified group of channels. The threshold is used for
triggering purposes and for displaying the digital data as
high (above the threshold) or low (below the threshold).
The DIGITAL_THR? query returns the threshold value for
the specified group of channels.
COMMAND SYNTAX
<group>:DIGITAL_THR <type>[,<level>]
<group>:={C1,C2}
C1 — D0-D7.
C2 — D8-D15.
<type>:={TTL,CMOS,CMOS3.3,CMOS2.5,CUSTOM}
<level>:= -5V to 5V when <type> is CUSTOM.
Note:
If there is no unit (V) added to <level>, it defaults to be V.
If you set the threshold to a value outside of the legal
range, the threshold is automatically set to the nearest
legal value.
QUERY SYNTAX
<group>:DIGITAL_THR?
RESPONSE FORMAT
Format 1:
DIGITAL_THR <type>
Format 2:
DIGITAL_THR <group>,<level>
<type>
Response Format
TTL/CMOS/CMOS3.3/CMOS2.5
Format 1
CUSTOM
Format 2
75
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
EXAMPLE
For SDS1000X+ series, when the Digital function is on,
the following command sets the threshold of D0-D7 to
LVLCMOS3.3.
Command message:
C1:DGTH CMOS3.3
For SDS1000X+ series, when the Digital function is on,
the following command sets the threshold of D8-D15 to 3
V.
Command message:
C2:DGTH CUSTOM,3V
Model
Valid?
SDS2000X
yes
SDS1000X
yes
SDS1000X-E
no
SDS2000X-E
no
Note:
The table below shows the availability of command in each oscilloscope series.
76
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DIGITAL
DI:SWITCH | DI:SW
Command/Query
DESCRIPTION
The SWITCH command is used to set the state of digital.
The SWITCH? query returns the state of digital.
COMMAND SYNTAX
DI:SWITCH <state>
<state>:={OFF,ON}
QUERY SYNTAX
DI:SWITCH?
RESPONSE FORMAT
DI:SWITCH <state>
EXAMPLE
For SDS1000X-E series, the following command sets
Digital function on.
Command message:
DI:SWITCH ON
Model
Valid?
SDS2000X
no
SDS1000X
no
SDS1000X-E
yes
SDS2000X-E
yes
Note:
The table below shows the availability of command in each oscilloscope series.
77
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DIGITAL
TRACE | TRA
Command/Query
DESCRIPTION
The TRACE command turns digital display on or off for the
specified channel.
The TRACE? query returns the current digital display
setting for the specified channel.
For SDS1000X-E series, the following command sets D8
display on.
Command message:
D8:TRACE ON
Model
Valid?
SDS2000X
no
SDS1000X
no
SDS1000X-E
yes
SDS2000X-E
yes
Note:
The table below shows the availability of command in each oscilloscope series.
78
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DIGITAL
THRESHOLD_MODE | TSM
Command/Query
DESCRIPTION
The THRESHOLD_MODE command sets the threshold
type for the specified group of channels. The threshold is
used for triggering purposes and for displaying the digital
data as high (above the threshold) or low (below the
threshold).
The THRESHOLD_MODE? query returns the threshold
type for the specified group of channels.
COMMAND SYNTAX
<group>:THRESHOLD_MODE <type>
<group>:={H8,L8}
H8 — D8-D15.
L8 — D0-D7.
<type>:={TTL,CMOS,LVCMOS33,LVCMOS25,CUSTOM}
QUERY SYNTAX
<group>:THRESHOLD_MODE?
RESPONSE FORMAT
<group>:THRESHOLD_MODE <type>
EXAMPLE
For SDS1000X-E series, when the Digital function is on,
the following command sets the threshold of D0-D7 to
LVLCMOS3.3.
Command message:
L8:TSM LVCMOS33
Model
Valid?
SDS2000X
no
SDS1000X
no
SDS1000X-E
yes
SDS2000X-E
yes
Note:
The table below shows the availability of command in each oscilloscope series.
79
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DIGITAL
CUSTOM | CUS
Command/Query
DESCRIPTION
The CUSTOM command sets the threshold value by
customer for the specified group of channels. The
threshold is used for triggering purposes and for displaying
the digital data as high (above the threshold) or low (below
the threshold).
The CUSTOM? query returns the threshold value set by
customer for the specified group of channels.
COMMAND SYNTAX
<group>:CUSTOM <value>
<group>:={H8,L8}
H8 — D8-D15.
L8 — D0-D7.
<value>:= volt value with unit.
Note:
You need to add the volt unit (V/mV) to the value. If there
is no unit added, it defaults to volts (V).
The range of value varies from models. See the data
sheet for details.
An out-of-range value will be adjusted to the closest legal
value.
QUERY SYNTAX
<group>:CUSTOM?
RESPONSE FORMAT
<group>:CUSTOM <value>
EXAMPLE
For SDS1000X-E series, when the Digital function is on,
the following command sets the threshold value of D8-D15
to 5 V.
Command message:
L8:CUSTOM 5V
80
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Model
Valid?
SDS2000X
no
SDS1000X
no
SDS1000X-E
yes
SDS2000X-E
yes
Note:
The table below shows the availability of command in each oscilloscope series.
81
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DISPLAY Commands
The DISPLAY subsystem is used to control how waveforms, and the graticules are displayed on the
screen.
DTJN
GRDS
INTS
MENU
PESU
82
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DISPLAY
DOT_JOIN | DTJN
Command/Query
DESCRIPTION
The DOT_JOIN command sets the interpolation lines
between data points.
COMMAND SYNTAX
DOT_JOIN <state>
<state>:={ON,OFF}
ON — dots. This mode displays data more quickly than
vector mode but does not draw lines between sample
points.
OFF — vectors. This is the default mode and draws lines
between points.
QUERY SYNTAX
DOT_JOIN?
RESPONSE FORMAT
DOT_JOIN <state>
EXAMPLE
The following command turns off the interpolation lines.
Command message:
DTJN ON
83
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DISPLAY
GRID_DISPLAY | GRDS
Command/Query
DESCRIPTION
The GRID_DISPLAY command selects the type of the grid
which is used to display.
The GRID_DISPLAY? query returns the current type of
grid.
COMMAND SYNTAX
GRID_DISPLAY <type>
< type >:={FULL,HALF,OFF}
QUERY SYNTAX
GRID_DISPLAY?
RESPONSE FORMAT
GRID_DISPLAY <type>
EXAMPLE
The following command changes the type of grid to full
grid.
Command message:
GRDS FULL
84
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DISPLAY
INTENSITY | INTS
Command/Query
DESCRIPTION
The INTENSITY command sets the intensity level of the
grid or the trace.
The INTENSITY? query returns the grid and trace intensity
levels.
COMMAND SYNTAX
INTENSITY GRID,<value>,TRACE,<value>
<value>:= 0 (or 30) to 100
Note:
You can also set the intensity level of the grid or trace
using a key-value pair alone, see the example for details.
QUERY SYNTAX
INTENSITY?
RESPONSE FORMAT
INTENSITY TRACE,<value>,GRID,<value>
EXAMPLE
The following command changes the grid intensity level to
75%.
Command message:
INTS GRID,75
85
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DISPLAY
MENU
Command/Query
DESCRIPTION
The MENU command enables or disables to display the
menu.
The MENU? query returns whether the menu is displayed.
COMMAND SYNTAX
MENU <state>
<state>:={ON,OFF}
QUERY SYNTAX
MENU?
RESPONSE FORMAT
MENU <state>
EXAMPLE
The following command enables the display of the menu.
Command message:
MENU ON
86
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DISPLAY
PERSIST_SETUP | PESU
Command/Query
DESCRIPTION
The PERSIST_SETUP command selects the persistence
duration of the display, in seconds, in persistence mode.
The PERSIST_SETUP? query returns the current status of
the persistence.
COMMAND SYNTAX
PERSIST_SETUP <time>
Models
<time>:=
SDS1000X-E/
SDS2000X-E/
SDS1000X-U
{OFF,INFINITE,1,5,10,30}
Others
{INFINITE,1,5,10,30}
Note:
See models on page 15.
See the command PERS in Obsolete Commands for Old
Models to set persist off.
Options of <time> vary from models. See the data sheet
or the display menu of the oscilloscope for details.
QUERY SYNTAX
PERSIST_SETUP?
RESPONSE FORMAT
PERSIST_SETUP <time>
EXAMPLE
The following command sets the variable persistence at 5
seconds.
Command message:
PESU 5
87
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
HISTORY Commands
The HISTORY subsystem commands control the waveform recording function and the history
waveform play function.
FRAM
FTIM?
HSMD
HSLST
88
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
HISTORY
FRAME_SET | FRAM
Command/Query
DESCRIPTION
The FRAME_SET command is used to set history current
frame number.
The FRAME_SET? query returns the current frame
number.
COMMAND SYNTAX
FRAM <frame_num>
<frame_num>:= 0 to the max frame number.
Note:
You can send the query FRAM? to get the max frame
number when the history function is turned on for the first
time.
QUERY SYNTAX
FRAM?
RESPONSE FORMAT
FRAM <frame_num>
Note:
The query is only valid for SDS1000X-E series.
EXAMPLE
When the history function is on, the following command
sets current frame number to 50. Then you can see the
response on the screen as shown below.
89
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Command message:
FRAM 50
90
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
HISTORY
FRAME_TIME? | FTIM?
Query
DESCRIPTION
The FRAME_TIME query returns the acquire timestamp of
the current frame.
QUERY SYNTAX
FTIM?
RESPONSE FORMAT
Format 1:
FTIM hour: minute: second. micro-second
Format 2:
\xFF\x0F\x03\x01&\xD5\x02\x00
Note:
Format 2 is binary data and has no key word.
The table below shows the available response format in
each oscilloscope series.
EXAMPLE
For the SDS1000X-E series, when the history function is
on, the following query returns the acquire time of the
current frame.
Query message:
FTIM?
Response message:
FTIM 00: 05: 12. 650814
Model
Response Format
SDS1000CFL
Format 2
SDS1000A
Format 2
SDS1000CML+/CNL+/DL+/E+/F+
Format 2
SDS2000X
Format 2
SDS1000X
Format 2
SDS1000X-E/2000X-E/1000X-U
Format 1
Format in Each Oscilloscope Series
91
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
HISTORY
HISTORY_MODE | HSMD
Command/Query
DESCRIPTION
The HISTORY_MODE command is used to set the state
of history mode.
The HISTORY_MODE? query returns the current state of
history mode.
COMMAND SYNTAX
HSMD <state>
<state>:={ON,OFF}
QUERY SYNTAX
HSMD?
RESPONSE FORMAT
HSMD <state>
EXAMPLE
The following command sets the state of history mode to
ON.
Command message:
HSMD ON
Model
Valid?
SDS1000CFL
no
SDS1000A
no
SDS1000CML+/CNL+/DL+/E+/F+
no
SDS2000X
no
SDS1000X
no
SDS1000X-E
yes
SDS2000X-E
yes
SDS1000X-U
yes
Note:
The table below shows the availability of command in each oscilloscope series.
92
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
HISTORY
HISTORY_LIST | HSLST
Command/Query
DESCRIPTION
The HISTORY_LIST command is used to set the state of
history list.
The HISTORY_LIST? query returns the current state of
history list.
COMMAND SYNTAX
HSLST <state>
<state>:={ON,OFF}
Note:
This command can only be used when History function is
turned on.
QUERY SYNTAX
HSLST?
RESPONSE FORMAT
HSLST <state>
EXAMPLE
When History function is on, the following command sets
the state of history list to ON.
Command message:
HSLST ON
RELATED COMMANDS
HSMD
Model
Valid?
SDS1000CFL/CML /CNL/DL
no
SDS1000CML+/CNL+/DL+/E+/F+
no
SDS1000A
no
SDS2000X
no
SDS1000X
no
Note:
The table below shows the availability of command in each oscilloscope series.
93
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
SDS1000X-E
yes
SDS2000X-E
yes
SDS1000X-U
yes
94
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
MATH Commands
The MATH subsystem controls the math functions in the oscilloscope. As selected by the DEF
command, these math functions are available:
Operators: Add, Subtract, Multiply, Divide. Operators perform their function on two analog channel
sources.
When the Math function is on, and both Channel 1 and
Channel 2 are on, the following command sets the math
operation to Multiplication, source1 to C1, source2 to C2.
96
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Command message:
DEFINE EQN,’C1*C2’
When the Math function is on, and Channel 1 is on, the
following command sets the math operation to
Differentiator, source to C1.
Command message:
DEFINE EQN,’DIFFC1’
97
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
MATH
INVERTSET | INVS
Command/Query
DESCRIPTION
The INVERTSET command inverts the math waveform.
The INVERTSET? query returns whether the math
waveform is inverted or not.
Note:
This command is only valid in add, subtract, multiply and
divide operation.
COMMAND SYNTAX
<trace>:INVERTSET <state>
<trace>:={MATH}
<state>:= {ON,OFF}
QUERY SYNTAX
<trace>:INVERTSET?
RESPONSE FORMAT
<trace>:INVERTSET <state>
EXAMPLE
When the Math function is on, and the operation is Add,
the following command inverts the math waveform.
Command message:
MATH:INVS ON
98
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
MATH
MATH_VERT_DIV | MTVD
Command/Query
DESCRIPTION
The MATH_VERT_DIV command sets the vertical scale of
the selected math operation. This command is only valid in
add, subtract, multiply and divide operation.
The MATH_VERT_DIV? query returns the current scale
value for the selected operation.
COMMAND SYNTAX
MATH_VERT_DIV <scale>
<scale>:={500uV,1mV,2mV,5mV,10mV,20mV,
50mV,100mV,200mV,500mV,1V,2V,5V,10V,20V,50V,100
V} (for add, subtract, multiply and divide)
Note:
Legal values for the scale depend on the selected
operation. For details, please refer to the math menu of
the oscilloscope as shown below.
QUERY SYNTAX
MATH_VERT_DIV?
RESPONSE FORMAT
MATH_VERT_DIV <scale>
Model
Format of <scale>
SDS1000X-E/
Numerical value in E-notation with
99
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
SDS2000X-E/
SDS1000X-U
SI unit, such as 5.00E-01V.
Others
Numerical value with measurement unit
and physical unit, such as 500mV.
EXAMPLE
When the Math function is on, and the operator is Add, the
following command changes the vertical scale of the math
waveform to 1 V.
Command message:
MTVD 1V
100
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.