Siglent SDS2352X-E Programming Guide

Digital Oscilloscopes
Programming Guide
PG01-E02D
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM

Copyright and Declaration

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 Tel400-878-0807 E-mailsales@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
CONTENT ................................................................................................................................................ 5
PROGRAMMING OVERVIEW .................................................................................................................. 7
ESTABLISHING COMMUNICATIONS .................................................................................................................. 7
Install NI-VISA ......................................................................................................................................... 7
Connect the Instrument ......................................................................................................................... 10
REMOTE CONTROL ...................................................................................................................................... 12
User-defined Programming ................................................................................................................... 12
Send SCPI Commands via NI-MAX ...................................................................................................... 12
Using SCPI with Telnet ......................................................................................................................... 12
Using SCPI with Sockets....................................................................................................................... 14
INTRODUCTION TO THE SCPI LANGUAGE ......................................................................................... 15
ABOUT COMMANDS & QUERIES .................................................................................................................... 15
DESCRIPTION .............................................................................................................................................. 15
USAGE ........................................................................................................................................................ 15
COMMAND NOTATION .................................................................................................................................. 16
COMMANDS & QUERIES ....................................................................................................................... 17
COMMON (*) COMMANDS .......................................................................................................................... 18
COMM_HEADER COMMANDS ................................................................................................................... 22
ACQUIRE COMMANDS ............................................................................................................................... 24
AUTOSET COMMANDS ............................................................................................................................... 38
CHANNEL COMMANDS............................................................................................................................... 40
CURSOR COMMANDS ................................................................................................................................ 51
DECODE COMMANDS ................................................................................................................................ 59
DIGITAL COMMANDS .................................................................................................................................. 72
DISPLAY COMMANDS................................................................................................................................. 82
HISTORY COMMANDS ................................................................................................................................ 88
MATH COMMANDS ...................................................................................................................................... 95
MEASURE COMMANDS ............................................................................................................................ 113
5
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
PASS/FAIL COMMANDS............................................................................................................................ 135
PRINT COMMANDS ................................................................................................................................... 148
RECALL COMMANDS ................................................................................................................................ 150
REFERENCE COMMANDS ....................................................................................................................... 154
SAVE COMMANDS .................................................................................................................................... 165
STATUS COMMANDS................................................................................................................................ 174
SYSTEM COMMANDS ............................................................................................................................... 177
TIMEBASE COMMANDS............................................................................................................................ 183
TRIGGER COMMANDS ............................................................................................................................. 191
SERIAL TRIGGER COMMANDS ................................................................................................................ 209
WAVEFORM COMMANDS ........................................................................................................................ 262
WGEN COMMANDS ................................................................................................................................... 275
OBSOLETE COMMANDS FOR OLD MODELS .................................................................................................. 291
PROGRAMMING EXAMPLES .............................................................................................................. 313
VISA EXAMPLES ....................................................................................................................................... 314
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
INDEX................................................................................................................................................... 343
6
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM

Programming Overview

This chapter introduces how to build communication between the instrument and the PC. It also introduces how to configure a system for remote instrument control.
By using USB and LAN interfaces, in combination with NI-VISA and programming languages, users can remotely control the instruments. Through LAN interface, VXI-11, Sockets and Telnet protocols can be used to communicate with the instruments.

Establishing Communications

Install NI-VISA

Before programming, you need to install the National Instruments NI-VISA library, which you can download from the National Instruments web site.
Currently, NI-VISA is packaged in two versions: a full version and a Run-Time Engine version. The full version includes the NI device drivers and a tool named NI MAX which is a user interface to control and test remotely connected devices. The Run-Time Engine is recommended, as it is a much smaller download than the full version and includes the necessary tools for basic communication to instruments.
For example, you can get the NI-VISA 5.4 full version from: http://www.ni.com/download/ni-visa-
5.4/4230/en/.
You also can download NI-VISA Run-Time Engine 5.4 to your PC and install it as the default selection. Its installation process is similar with the full version.
After you downloaded the file, follow these steps to install NI-VISA (The full version of NI-VISA 5.4 is used in this example. Newer versions are likely, and should be compatible with 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.
*IDN? (Identification Number) *OPC (Operation Complete) *RST (Reset)
18
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
COMMON (*)
*IDN?
Query
DESCRIPTION
The *IDN? query identifies the instrument type and software version. The response consists of four different fields providing information on the manufacturer, the scope model, the serial number and the firmware revision.
QUERY SYNTAX
*IDN?
RESPONSE FORMAT
Siglent Technologies,<model>,<serial number>,<firmware>
<model>:= the model number of the instrument <serial number>:= A 14-digit decimal code. <firmware>:= the software revision of the instrument
EXAMPLE
The query identifies the instrument type and software version. Command message:
*IDN?
Response message:
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.
ARM STOP ACQW AVGA MSIZ SAST? SARA? SANU? SXSA XYDS
24
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
ACQUIRE
ARM_ACQUISITION | ARM
Command
DESCRIPTION
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.
COMMAND SYNTAX
ACQUIRE_WAY <mode>[,<time>]
<mode>:={SAMPLING,PEAK_DETECT,AVERAGE,HIGH_ RES} <time>:={4,16,32,64,128,256,512,}
SAMPLING sets the oscilloscope in the normal mode. PEAK_DETECT sets the oscilloscope in the peak
detect mode. AVERAGE sets the oscilloscope in the averaging mode. HIGH_RES sets the oscilloscope in the enhanced resolution mode (also known as smoothing). This is essentially a digital boxcar filter and is used to reduce noise at slower sweep speeds.
Note: The [HIGH_RES] option is valid for 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.
COMMAND SYNTAX
<channel>:ATTENUATION <attenuation>
<channel>:={C1,C2,C3,C4} <attenuation>:={0.1,0.2,0.5,1,2,5,10,20,50,100,200,500,10 00,2000,5000,10000}
QUERY SYNTAX
<channel>:ATTENUATION?
RESPONSE FORMAT
<channel>:ATTENUATION <attenuation>
EXAMPLE
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 bandwidth­limiting low-pass filter. If the bandwidth filters are on, it will limit the bandwidth to reduce display noise. When you turn Bandwidth Limit ON, the Bandwidth Limit value is set to 20 MHz. It also filters the signal to reduce noise and other unwanted high frequency components.
The BANDWIDTH_LIMIT? query returns whether the bandwidth filters are on.
COMMAND SYNTAX
BANDWIDTH_LIMIT <channel>,<mode>[,<channel>,<mode>[,<channel>,<mod e>[, <channel>,<mode>]]]
<channel>:={C1,C2,C3,C4} <mode>:={ON,OFF}
QUERY SYNTAX
BANDWIDTH_LIMIT?
RESPONSE FORMAT
BANDWIDTH_LIMIT <channel>,<mode>[,<channel>,<mode>[,<channel>,<mod e>[,<channel>,<mode>]]]
EXAMPLE
The following command turns on the bandwidth filter for all channels. Command message:
BWL C1,ON,C2,ON,C3,ON,C4,ON
The following command turns the bandwidth filter on for Channel 1 only. Command message:
BWL C1,ON
42
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
CHANNEL
COUPLING | CPL
Command/Query
DESCRIPTION
The COUPLING command selects the coupling mode of the specified input channel.
The COUPLING? query returns the coupling mode of the specified channel.
COMMAND SYNTAX
<channel>:COUPLING <coupling>
<channel>:={C1,C2,C3,C4} <coupling>:={A1M,A50,D1M,D50,GND}
A alternating current. D direct current. 1M 1MΩ input impedance. 50 50Ω input impedance.
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.
COMMAND SYNTAX
<trace>:CURSOR_SET <cursor>,<position>[,<cursor>,<position>[,<cursor>,<positi on>[,<cursor>,<position>]]]
<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.
QUERY SYNTAX
<trace>:CURSOR_SET? <cursor>[,<cursor>[,<cursor>[,<cursor>]]]
<cursor>:={VREF,VDIF,TREF,TDIF,HREF,HDIF}
RESPONSE FORMAT
<trace>:CURSOR_SET <cursor>,<position>[,<cursor>,<position>[,<cursor>,<positi on>[,<cursor>,<position>]]]
EXAMPLE
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.
RESPONSE FORMAT
<trace>:CURSOR_VALUE HREL,<delta>,<1/delta>,<value1>,<value2>
<trace>:CURSOR_VALUE VREL,<delta>,<value1>,<value2>
EXAMPLE
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.
DCST DCPA B<n>:DCIC B<n>:DCSP B<n>:DCUT B<n>:DCCN B<n>:DCLN
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.
COMMAND SYNTAX
B<n>:DCIC <param>,<value>[,<param>,<value>[,..]]
<n>:={1,2}
<param>
<value>
DIS
{OFF,ON}
SCL
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D 7,D8,D9,D10,D11,D12,D13,D14,D15}
SCLT
value with unit
SDA
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D 7,D8,D9,D10,D11,D12,D13,D14,D15}
SDAT
value with unit
RW
{OFF,ON}
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.
COMMAND SYNTAX
B<n>:DCSP <param>,<value>[,<param>,<value>[,..]]
<n>:={1,2}
<param>
<value>
DIS
{OFF,ON}
CLK
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7, D8,D9,D10,D11,D12,D13,D14,D15}
CLKT
value with unit
EDGE
{RISING,FALLING}
MISO
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7, D8,D9,D10,D11,D12,D13,D14,D15}
MISOT
value with unit
MOSI
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7, D8,D9,D10,D11,D12,D13,D14,D15}
MOSIT
value with unit
CSTP
{CS,NCS,TIMEOUT}
CS
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7, D8,D9,D10,D11,D12,D13,D14,D15}
CST
value with unit
NCS
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7, D8,D9,D10,D11,D12,D13,D14,D15}
NCST
value with unit
TIM
value with unit
BIT
{MSB,LSB}
DLEN
4 to 32
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. NCSSet 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:
B1:DCSP DIS,ON,CLK,D0,MOSI,D1,CSTP,TIMEOUT,TIM,2uS,BIT, MSB,DLEN,32
65
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DECODE
B<n>:DCUT
Command
DESCRIPTION
The B<n>:DCUT command is used to set the parameters of UART decode bus.
COMMAND SYNTAX
B<n>:DCUT <param>,<value>[,<param>,<value>[,..]]
<n>:={1,2}
<param>
<value>
DIS
{OFF,ON}
RX
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D 7,D8,D9,D10,D11,D12,D13,D14,D15}
RXT
value with unit
TX
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D 7,D8,D9,D10,D11,D12,D13,D14,D15}
TXT
value with unit
BAUD
value without unit, 300 to 50000000
DLEN
5 to 8
PAR
{NONE,EVEN,ODD}
STOP
{1,1.5,2}
POL
{LOW,HIGH}
BIT
{MSB,LSB}
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:
B1:DCUT DIS,ON,RX,D0,BAUD,9600,PAR,ODD,STOP,2POL,HIG H,BIT,MSB
67
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DECODE
B<n>:DCCN
Command
DESCRIPTION
The B<n>:DCCN command is used to set the parameters of CAN decode bus.
COMMAND SYNTAX
B<n>:DCCN <param>,<value>[,<param>,<value>[..]]
<n>:={1,2}
<param>
<value>
DIS
{OFF,ON}
CANH
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D 8,D9,D10,D11,D12,D13,D14,D15}
CANHT
value with unit
CANL
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D 8,D9,D10,D11,D12,D13,D14,D15}
CANLT
value with unit
SRC
{CAN_H,CAN_L,SUB_L}
BAUD
5000 to 1000000
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.
COMMAND SYNTAX
B<n>:DCLN <param>,<value>[,<param>,<value>[,..]]
<n>:={1,2}
<param>
<value>
DIS
{OFF,ON}
SRC
{C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7, D8,D9,D10,D11,D12,D13,D14,D15}
SRCT
value with unit
BAUD
300 to 2000
DIS Display the current bus. SRC Set the source for the LIN bus. SRCT Set the threshold of the Source. BAUD Set the baud rate for the LIN 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.
EXAMPLE
The following command sets the threshold of source for LIN bus2 to 200mV separately. Command message:
B2:DCLN SRCT,0.2V
The following command sets LIN bus1 to display, sets the decode source to D0 and the baud rate to 9600 bit/s.
70
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Command message:
B1:DCCN DIS,ON,SRC,D0,BAUD,9600
71
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
Model
Valid?
SDS1000CFL
no
SDS1000A
no
SDS1000CML+/CNL+/DL+/E+/F+
no
SDS2000X
yes
SDS1000X
yes
SDS1000X-E
yes
SDS2000X-E
yes
SDS1000X-U
no

DIGITAL Commands

The DIGITAL subsystem commands control the viewing of digital channels. They also control threshold settings for groups of digital channels.
DGCH DGST DGTH DI:SW TRA TSM CUS
Note: These commands are only valid for models which have installed the MSO option.
Availability of Digital Commands in Each Oscilloscope Series
72
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
DIGITAL
DIGITAL_CHANNEL | DGCH
Command/Query
DESCRIPTION
The DIGITAL_CHANNEL command turns digital display on or off for the specified channel.
The DIGITAL_CHANNEL? query returns the current digital display setting for the specified channel.
COMMAND SYNTAX
<digital>:DIGITAL_STATE <state>
<digital>:={D0,D1,D2,D3,D4,D5,D6,D7,D8,D9,D10,D11,D 12,D13,D14,D15}
<state>:={OFF,ON}
QUERY SYNTAX
<digital>:DIGITAL_STATE?
RESPONSE FORMAT
<digital>:DIGITAL_STATE <state>
EXAMPLE
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.
COMMAND SYNTAX
<digital>:TRACE <state>
<digital>:={D0,D1,D2,D3,D4,D5,D6,D7,D8,D9,D10,D11,D 12,D13,D14,D15} <state>:={OFF,ON}
QUERY SYNTAX
<digital>:TRACE?
RESPONSE FORMAT
<digital>:TRACE <state>
EXAMPLE
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.
Transforms: DIFF, Integrate, FFT, SQRT.
DEF INVS MTVD MTVP FFTC FFTF FFTP FFTS FFTT? FFTU FFTW
95
Digital Oscilloscope Series Programming Guide
WWW.SIGLENT.COM
MATH
DEFINE | DEF
Command/Query
DESCRIPTION
The DEFINE command sets the desired waveform math operation.
The DEFINE? query returns the current operation for the selected function.
COMMAND SYNTAX
DEFINE EQN,’<equation>’
Note: <equation> is the mathematical expression, enclosed by single or double quotation marks.
Function Equations
<source1> + <source2>
Addition
<source1> - <source2>
Subtraction
<source1>*<source2>
Multiplication
<source1>/<source2>
Ratio
FFT<source>
FFT
INTG<source>
Integral
DIFF<source>
Differentiator
SQRT<source>
Square Root
<source>:={C1,C2,C3,C4} <source1>:={C1,C2,C3,C4} <source2>:={C1,C2,C3,C4}
QUERY SYNTAX
DEFINE?
RESPONSE FORMAT
DEFINE EQN,’<equation>’
EXAMPLE
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...