Digital Oscilloscopes
Programming Guide
PG01-E02D

Digital Oscilloscope Series Programming Guide

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 atcompany’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 thepermission of SIGLENT.
Product Certification
SIGLENT guarantees this product conforms to the national and industrial stands in China and otherinternational 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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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 thecommands 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 thefunctional modules.



Removed incorrect instructions, added instructions for WGEN and DIGITAL modules.



Add two new communication features: Telnet and Socket, visible in “Programming OverviewRemote 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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Programming Overview
This chapter introduces how to build communication between the instrument and the PC. It also
introduces how to configure a system for remote instrument control.
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 candownload 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 tocontrol and test remotely connected devices. The Run-Time Engine is recommended, as it is a muchsmaller 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-visa5.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 isused 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 thecontrolling computer):a. Double click the visa540_full.exe, dialog shown as below:

7
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

b. Click Unzip, the installation process will automatically launch after unzipping files. If your computer
needs to install .NET Framework 4, it may auto start.

c. The NI-VISA installing dialog is shown above. Click Next to start the installation process.

8
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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 throughthe USB or LAN interface.

10
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Remote Control
User-defined Programming
Users can use SCPI commands via a computer to program and control the digital oscilloscope. For
details, refer to the introductions in "Programming Examples".

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, andSerial 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 commandsequences. 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 withthe 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 telnet.
3. Press the Enter key. The Telnet display screen will be displayed.

12
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

4. At the Telnet command line, type:open XXX.XXX.XXX.XXX 5024
Where XXX.XXX.XXX.XXX is the instrument’s IP address and 5024 is the port. You should see a
response similar to the following:

5. At the SCPI> prompt, input the SCPI commands such as *IDN? to return the company name,model number, serial number, and firmware version number.

13
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

6. To exit the SCPI> session, press the Ctrl+] keys simultaneously.
7. Type quit at the prompt or close the Telnet window to close the connection to the instrument andexit Telnet.

Using SCPI with Sockets
Socket API can be used to control the SDS1000X-E series via LAN without installing any otherlibraries. This can reduce the complexity of programming.
SOCKET ADDRESSIP ADDRESSPORT NUMBER

IP address + port number
SDS IP address
5025

Please see section "Examples of Using Sockets" for the details.

14
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Introduction to the SCPI Language
About Commands & QueriesThis 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 isindicated 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 apresentation 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 asshown below. Models are arranged according to their initial release dates.
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
15
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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 andcolor 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: theheader path and the data parameter of a command.
:= A colon followed by an equals sign separates a placeholder from the description of the type andrange 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 desiredvertical 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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Commands & QueriesThis chapter introduces each command subsystem of the SIGLENTs Digital Oscilloscope Seriescommand 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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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 thecommand key length is 3 characters.
*IDN? (Identification Number)*OPC (Operation Complete)

*RST (Reset)

18
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

COMMON (*)

*IDN?
Query

DESCRIPTIONThe *IDN? query identifies the instrument type andsoftware version. The response consists of four different
fields providing information on the manufacturer, thescope model, the serial number and the firmware revision.

QUERY SYNTAX*IDN?

RESPONSE FORMAT

Siglent
number>,<firmware>Technologies,<model>,<serial<model>:= the model number of the instrument<serial number>:= A 14-digit decimal code.
<firmware>:= the software revision of the instrument
EXAMPLEThe query identifies the instrument type and software
version.
Command message:*IDN?
Response message:

Siglent
Technologies,SDS1204XE,SDS1EBAC0L0098,7.6.1.15

19
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

COMMON (*)*OPCCommand/QueryDESCRIPTIONThe *OPC command sets the operation complete bit in theStandard 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. Theinterface hangs until this query returns.

COMMAND SYNTAX*OPCQUERY SYNTAX*OPC?

RESPONSE FORMAT*OPC 1

20
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

COMMON (*)*RSTCommand

DESCRIPTIONThe *RST command initiates a device reset. This is thesame as pressing Default on the front panel.

COMMAND SYNTAX*RSTEXAMPLEThis example resets the oscilloscope.
Command message:

*RST

21
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

COMM_HEADER Commands


CHDR

22
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

COMM_HEADER

COMM_HEADER | CHDR
Command/QueryDESCRIPTION

The COMM_HEADER command controls the way theoscilloscope formats response to queries. This command
does not affect the interpretation of messages sent to theoscilloscope. Headers can be sent in their long or shortform regardless of the CHDR setting.
Examples of the three response formats to “C1:VDIV?”:

COMMAND SYNTAXCHDRRESPONSE

LONG

C1:VOLT_DIV 1.00E+01V

SHORT

C1:VDIV 1.00E+01V

OFF

1.00E+01

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 innumbers are suppressed.
Note:
Default is the SHORT response format.

QUERY SYNTAXCOMM_HEADER?

RESPONSE FORMAT

COMM_HEADER <mode>

EXAMPLEThe following command sets the response header format
to SHORT.
Command message:

CHDR SHORT23
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ACQUIRE

ARM_ACQUISITION | ARM
Command

DESCRIPTION

The ARM_ACQUISITION command starts a new signal
acquisition.

COMMAND SYNTAXARM_ACQUISITION

EXAMPLEThe 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 thestate 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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

INR 8193
RELATED COMMANDS

STOP
TRMD
INR?

26
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ACQUIRESTOP
Command

DESCRIPTIONThe STOP command stops the acquisition. This is thesame as pressing the Stop key on the front panel.

COMMAND SYNTAXSTOPEXAMPLEThe following command stops the acquisition process.
Command message:

STOP
RELATED COMMANDS

ARM
TRMD

27
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ACQUIREACQUIRE_WAY | ACQW
Command/QueryDESCRIPTION

The ACQUIRE_WAY command specifies the acquisition
mode.
The

ACQUIRE_WAY?

query

returns

thecurrent

acquisition mode.
COMMAND SYNTAXACQUIRE_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 peakdetect mode.
AVERAGE — sets the oscilloscope in the averaging
mode.
HIGH_RES — sets the oscilloscope in the enhanced
resolution mode (also known as smoothing). This isessentially a digital boxcar filter and is used to reducenoise at slower sweep speeds.
Note:The [HIGH_RES] option is valid for SPO models. Seemodels on page 15.
<time>:={4,16,32,64,128,256,512,…} when <mode> =AVERAGE.
Options vary from models. See the data sheet or theacquire menu of the oscilloscope.

QUERY SYNTAXACQUIRE_WAY?

28
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideRESPONSE FORMATACQUIRE_WAY <mode>[,<time>]

EXAMPLEThe 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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ACQUIREAVERAGE_ACQUIRE | AVGA
Command/QueryDESCRIPTION

The AVERAGE_ACQUIRE command selects the averagetimes of average acquisition.
The AVERAGE_ACQUIRE? query returns the currently
selected count value for average mode.

COMMAND SYNTAXAVERAGE_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 SYNTAXAVERAGE_ACQUIRE?

RESPONSE FORMATAVERAGE_ACQUIRE <time>

EXAMPLEThe following command turns the average times of
average acquisition to 16.
Command message:

AVGA 16
RELATED COMMANDS

ACQW

30
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ACQUIREMEMORY_SIZE | MSIZ
Command/QueryDESCRIPTION

The MEMORY_SIZE command sets the maximum depthof memory.
The MEMORY_SIZE? query returns the maximum depthof memory.

COMMAND SYNTAXMEMORY_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}

forinterleave

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 SYNTAXMEMORY_SIZE?

RESPONSE FORMATMEMORY_SIZE <size>

EXAMPLEThe following command sets the maximum depth ofmemory to 14M in interleave mode.
Command message:

MSIZ 14M

31
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ACQUIRESAMPLE_STATUS? | SAST?
Query

DESCRIPTIONThe SAST? query returns the acquisition status of thescope.

QUERY SYNTAXSAST?

RESPONSE FORMAT

SAST <status>

EXAMPLEThe following query returns the acquisition status of thescope.
Query message:

SAST?
Response message:

SAST Trig'd

32
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ACQUIRESAMPLE_RATE? | SARA?
Query

DESCRIPTIONThe SARA? query returns the sample rate of the scope.

QUERY SYNTAXSARA?
DI:SARA?
DI — digital.

RESPONSE FORMATSARA <value>
DI:SARA <value>
Model

Format of <value>

SDS1000X-E/

Numerical value in E-notation with

SDS2000X-E/

SI unit, such as 5.00E+08Sa/s.

SDS1000X-U
othersNumerical 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 digitalchannel.
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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Model

Valid?

SDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

34
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ACQUIRESAMPLE_NUM? | SANU?
Query

DESCRIPTIONThe SANU? query returns the number of data points thatthe 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 bedirectly set.

QUERY SYNTAXSANU? <channel><channel>:={C1,C2,C3,C4}RESPONSE FORMATSANU <value>
Model

Format of <value>

SDS1000X-E/

Numerical value in E-notation with

SDS2000X-E/

SI unit, such as 7.00E+05pts.

SDS1000X-U
SDS2000/2000X

Numerical value with measurement/1000X/1000X+

unit and physical unit, such as
28Mpts.

others

EXAMPLE

Numerical value, such as 1600.

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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ACQUIRESINXX_SAMPLE | SXSACommand/QueryDESCRIPTIONTheSINXX_SAMPLE

command

sets

the

way

of

returns

the

way

of

interpolation.
The

SINXX_SAMPLE?

query

interpolation.
COMMAND SYNTAXSINXX_SAMPLE <state><state>:={ON,OFF}ON — sine interpolation.
OFF — linear interpolation.

QUERY SYNTAXSINXX_SAMPLE?

RESPONSE FORMATSINXX_SAMPLE <state>

EXAMPLEThe following command sets the way of the interpolation
to sine interpolation.
Command message:SXSA ON

36
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ACQUIRE

XY_DISPLAY | XYDS
Command/QueryDESCRIPTIONThe XY_DISPLAY command enables or disables thedisplay of XY mode. XY mode plots the voltage data ofboth 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 SYNTAXXY_DISPLAY <state><state>:={ON,OFF}QUERY SYNTAXXY_DISPLAY?

RESPONSE FORMATXY_DISPLAY <state>

EXAMPLEThe following command enables the XY format.
Command message:

XYDS ON

37
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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 SYNTAXAUTO_SETUP

EXAMPLEThe following command instructs the oscilloscope toperform an auto-setup.
Command message:

ASET

39
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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 thecommand.


ATTN



BWL



CPL



OFST



SKEW



TRA



UNIT



VDIV



INVS

40
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CHANNELATTENUATION | ATTN
Command/QueryDESCRIPTION

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 theoscilloscope. It changes the reference constants for
scalingthedisplayfactors,formakingautomatic

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>

EXAMPLEThe following command sets the attenuation factor of
Channel 1 to 100:1. To ensure the data matches the truesignal voltage values, the physical probe attenuation mustmatch the scope attenuation values for that input channel.
Command message:

C1:ATTN 100
RELATED COMMANDS

VDIV
OFST

41
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CHANNELBANDWIDTH_LIMIT | BWL
Command/QueryDESCRIPTIONBANDWIDTH_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 turnBandwidth Limit ON, the Bandwidth Limit value is set to 20
MHz. It also filters the signal to reduce noise and otherunwanted high frequency components.
The BANDWIDTH_LIMIT? query returns whether the
bandwidth filters are on.

COMMAND SYNTAXBANDWIDTH_LIMIT<channel>,<mode>[,<channel>,<mode>[,<channel>,<mode>[, <channel>,<mode>]]]<channel>:={C1,C2,C3,C4}<mode>:={ON,OFF}QUERY SYNTAXBANDWIDTH_LIMIT?

RESPONSE FORMATBANDWIDTH_LIMIT<channel>,<mode>[,<channel>,<mode>[,<channel>,<mode>[,<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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CHANNEL

COUPLING | CPL
Command/QueryDESCRIPTION

The COUPLING command selects the coupling mode of
the specified input channel.
The COUPLING? query returns the coupling mode of thespecified 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>

EXAMPLEThe following command sets the coupling of Channel 2 to50 Ω, DC.
Command message:

C2:CPL D50

43
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CHANNELOFFSET | OFST
Command/QueryDESCRIPTIONThe OFFSET command allows adjustment of the verticaloffset of the specified input channel. The maximum ranges
depend on the fixed sensitivity setting.
The OFFSET? query returns the offset value of thespecified 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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Command message:

C1:OFST -50mV
RELATED COMMANDS

VDIV
ATTN

45
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CHANNEL

SKEW
Command/QueryDESCRIPTIONThe SKEW command sets the channel-to-channel skew
factor for the specified channel. Each analog channel canbe 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 /Numerical value in E-notation with

SDS2000X-E/

SI unit, such as 9.99E-08S.

SDS1000X-U
othersNumerical value with measurement
unit and physical unit, such as
0.00ns.

EXAMPLEThe following command sets skew value of Channel 1 to
3ns.
Command message:

C1:SKEW 3NS

46
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CHANNEL

TRACE | TRA
Command/QueryDESCRIPTIONThe TRACE command turns the display of the specified
channel on or off.
The TRACE? query returns the current display setting forthe specified channel.

COMMAND SYNTAX<trace>:TRACE <mode><trace>:={C1,C2,C3,C4}<mode>:={ON,OFF}QUERY SYNTAX<trace>:TRACE?

RESPONSE FORMAT<trace>:TRACE <mode>

EXAMPLEThe following command displays Channel 1.
Command message:

C1:TRA ON

47
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CHANNEL

UNIT
Command /QueryDESCRIPTIONThe 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>

EXAMPLEThe following command sets the unit of Channel 1 to V.
Command message:

C1:UNIT V

48
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CHANNEL

VOLT_DIV | VDIVCommand /QueryDESCRIPTION

The VOLT_DIV command sets the vertical sensitivity in
Volts/div.
If the probe attenuation is changed, the scale value ismultiplied by the probe's attenuation factor.
The VOLT_DIV? query returns the vertical sensitivity ofthe 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.

EXAMPLEThe following command sets the vertical sensitivity of
Channel 1 to 50 mV/div.
Command message:

C1:VDIV 50mVRELATED COMMANDS

ATTN

49
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CHANNEL

INVERTSET | INVS
Command/QueryDESCRIPTION

The INVERTSET command mathematically inverts the
specified traces or the math waveform.
The INVERTSET? query returns the current state of thechannel inversion.

COMMAND SYNTAX<trace>:INVERTSET <state><trace>:={C1,C2,C3,C4,MATH}<state>:= {ON,OFF}QUERY SYNTAX<trace>:INVERTSET?

RESPONSE FORMAT<trace>:INVERTSET <state>

EXAMPLEThe following command inverts the trace of Channel 1.
Command message:

C1:INVS ON

50
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CURSORCURSOR_MEASURE | CRMS
Command/QueryDESCRIPTION

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 SYNTAXCURSOR_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 SYNTAXCURSOR_MEASURE?

RESPONSE FORMATCURSOR_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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

on SDS1000X.
Command message:

CRMS ON
RELATED COMMANDS

CRVA?
CRST

Format in Each Oscilloscope Series
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

53
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CURSORCURSOR_SET | CRST
Command/QueryDESCRIPTION

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 bepositioned.
The CURSOR_SET? query returns the current position of
the cursor(s). The values

returned depend on the gridtype 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 manualmode.
VDIF — The voltage-value of Y2 (curB) under manualmode.
TREF — The time value of X1 (curA) under manualmode.
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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Note:The horizontal position range is related to the size ofscreen.
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, thecursor mode is manual, the following command sets theX1 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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CURSORCURSOR_TYPE | CRTY
Command/QueryDESCRIPTION

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 SYNTAXCURSOR_TYPE <type><mode>:={X,Y,X-Y}QUERY SYNTAXCURSOR_TYPE?

RESPONSE FORMATCURSOR_TYPE <type>

EXAMPLEThe following command sets cursor type to Y.
Command message:

CRTY YRELATED COMMANDS

CRMS

56
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CURSORCURSOR_VALUE? | CRVA?
Query

DESCRIPTIONTheCURSOR_VALUE?

query

returns

thevaluesmeasured 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 deltatime 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 undermanual mode. See models on page 15.

RESPONSE FORMAT<trace>:CURSOR_VALUE
HREL,<delta>,<1/delta>,<value1>,<value2><trace>:CURSOR_VALUE
VREL,<delta>,<value1>,<value2>

EXAMPLEWhen the cursor mode is manual, and the cursor type isY, the following query returns the vertical value on channel
1.

57
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Query message:

C1:CRVA? VREL
Response message:

C1:CRVA VREL,-5.00E+00V,2.50E+00V,-2.50E+00V
RELATED COMMANDS

CRMS

58
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

59
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DECODE

DCST
Command/QueryDESCRIPTION

The DCST command is used to set the state of decode.
The DCST? query returns the state of decode.

COMMAND SYNTAXDCST <state><state>:={OFF,ON}

QUERY SYNTAXDCST?

RESPONSE FORMATDCST <state>

EXAMPLEThe following command sets Decode function on.
Command message:

DCST ON

60
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DECODE

DCPA
Command

DESCRIPTION

The DCPA command is used to set the common
parameters of serial decode bus.

COMMAND SYNTAXDCPA <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 toselect 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 fromtrigger, and set DC_TO_TR to copy to trigger.
LSSC— List scroll.
LSNM— List lines.
EXAMPLEThe following command sets the current decode bus tobus1 separately.
Command message:

DCPA BUS,B1
The following command sets the current decode bus tobus2, 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,561
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DECODE

B<n>:DCIC
Command

DESCRIPTION

The B<n>:DCIC command is used to set the parametersof 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 theaddress. Set on to include and set off to not include.
Note:You need add the volt unit (V) to the value. If there is nounit 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 thesource.
EXAMPLEThe following command sets the threshold of SCL source
62
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guidefor 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, andincludes the R/W bit in the address.
Command message:

B1:DCIC DIS,ON,SCL,D0,SDA,D1,RW,ON

63
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DECODE

B<n>:DCSP
Command

DESCRIPTION

The B<n>:DCSP command is used to set the parametersof 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 unitEDGE

{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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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 thevalue. 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 verticalscale 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:DCSPDIS,ON,CLK,D0,MOSI,D1,CSTP,TIMEOUT,TIM,2uS,BIT,MSB,DLEN,32

65
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DECODE

B<n>:DCUT
Command

DESCRIPTION

The B<n>:DCUT command is used to set the parametersof 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}

RXTvalue 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 8PAR{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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Note:
You need add the volt unit (V) to the value. If there is nounit 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 thesource.
EXAMPLEThe following command sets the threshold of RX sourcefor 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:DCUTDIS,ON,RX,D0,BAUD,9600,PAR,ODD,STOP,2POL,HIG
H,BIT,MSB

67
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DECODE

B<n>:DCCN
Command

DESCRIPTION

The B<n>:DCCN command is used to set the parametersof 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 nounit 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 thesource.

68
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DECODE

B<n>:DCLN
Command

DESCRIPTION

The B<n>:DCLN command is used to set the parametersof 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 nounit 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 thesource.
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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Command message:

B1:DCCN DIS,ON,SRC,D0,BAUD,9600

71
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

yes

SDS1000X

yes

SDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

no72
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DIGITAL

DIGITAL_CHANNEL | DGCH
Command/QueryDESCRIPTION

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>

EXAMPLEFor SDS1000X+ series, the following command sets D8
display on.
Command message:

D8:DGCH ON
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

noSDS2000X-E

no73
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DIGITAL

DIGITAL_STATE | DGST
Command/QueryDESCRIPTION

The DIGITAL_STATE command is used to set the state ofdigital.
The DIGITAL_STATE? query returns the state of digital.

COMMAND SYNTAXDIGITAL_STATE <state><state>:={OFF,ON}

QUERY SYNTAXDIGITAL_STATE?

RESPONSE FORMATDIGITAL_STATE <state>

EXAMPLEFor SDS1000X+ series, the following command sets
Digital function on.
Command message:

DGST ONNote:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

noSDS2000X-E

no74
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DIGITAL

DIGITAL_THR | DGTH
Command/QueryDESCRIPTION

The DIGITAL_THR command sets the threshold for the
specified group of channels. The threshold is used fortriggering purposes and for displaying the digital data ashigh (above the threshold) or low (below the threshold).
The DIGITAL_THR? query returns the threshold value forthe 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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

noSDS2000X-E

no76
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DIGITAL

DI:SWITCH | DI:SW
Command/QueryDESCRIPTIONThe SWITCH command is used to set the state of digital.
The SWITCH? query returns the state of digital.

COMMAND SYNTAXDI:SWITCH <state><state>:={OFF,ON}

QUERY SYNTAXDI:SWITCH?

RESPONSE FORMAT

DI:SWITCH <state>

EXAMPLEFor SDS1000X-E series, the following command sets
Digital function on.
Command message:

DI:SWITCH ON
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

77
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DIGITAL

TRACE | TRA
Command/QueryDESCRIPTIONThe 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>

EXAMPLEFor SDS1000X-E series, the following command sets D8
display on.
Command message:

D8:TRACE ON
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

78
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DIGITALTHRESHOLD_MODE | TSM
Command/QueryDESCRIPTIONThe THRESHOLD_MODE command sets the thresholdtype for the specified group of channels. The threshold isused for triggering purposes and for displaying the digital
data as high (above the threshold) or low (below thethreshold).
The THRESHOLD_MODE? query returns the thresholdtype 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>

EXAMPLEFor 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
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes
79
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

DIGITALCUSTOM | CUS
Command/QueryDESCRIPTION

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 bycustomer 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>

EXAMPLEFor 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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

81
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideDISPLAY Commands
The DISPLAY subsystem is used to control how waveforms, and the graticules are displayed on thescreen.


DTJN



GRDS



INTS



MENU



PESU

82
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideDISPLAYDOT_JOIN | DTJN
Command/QueryDESCRIPTION

The DOT_JOIN command sets the interpolation lines
between data points.

COMMAND SYNTAXDOT_JOIN <state><state>:={ON,OFF}ON — dots. This mode displays data more quickly thanvector mode but does not draw lines between sample
points.
OFF — vectors. This is the default mode and draws lines
between points.

QUERY SYNTAXDOT_JOIN?

RESPONSE FORMATDOT_JOIN <state>

EXAMPLEThe following command turns off the interpolation lines.
Command message:

DTJN ON

83
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideDISPLAY

GRID_DISPLAY | GRDS
Command/QueryDESCRIPTIONThe 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 SYNTAXGRID_DISPLAY <type>< type >:={FULL,HALF,OFF}QUERY SYNTAXGRID_DISPLAY?

RESPONSE FORMATGRID_DISPLAY <type>

EXAMPLEThe following command changes the type of grid to full
grid.
Command message:

GRDS FULL

84
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideDISPLAY

INTENSITY | INTS
Command/QueryDESCRIPTION

The INTENSITY command sets the intensity level of thegrid or the trace.
The INTENSITY? query returns the grid and trace intensity
levels.

COMMAND SYNTAXINTENSITY GRID,<value>,TRACE,<value><value>:= 0 (or 30) to 100
Note:
You can also set the intensity level of the grid or traceusing a key-value pair alone, see the example for details.

QUERY SYNTAXINTENSITY?

RESPONSE FORMATINTENSITY TRACE,<value>,GRID,<value>

EXAMPLEThe following command changes the grid intensity level to75%.
Command message:

INTS GRID,75

85
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideDISPLAY

MENU
Command/QueryDESCRIPTION

The MENU command enables or disables to display themenu.
The MENU? query returns whether the menu is displayed.

COMMAND SYNTAXMENU <state><state>:={ON,OFF}QUERY SYNTAXMENU?

RESPONSE FORMATMENU <state>

EXAMPLEThe following command enables the display of the menu.
Command message:

MENU ON

86
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideDISPLAYPERSIST_SETUP | PESU
Command/QueryDESCRIPTION

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 SYNTAXPERSIST_SETUP <time>
Models<time>:=

SDS1000X-E/{OFF,INFINITE,1,5,10,30}

SDS2000X-E/
SDS1000X-U
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 sheetor the display menu of the oscilloscope for details.
QUERY SYNTAXPERSIST_SETUP?

RESPONSE FORMATPERSIST_SETUP <time>

EXAMPLEThe following command sets the variable persistence at 5
seconds.
Command message:

PESU 587
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

HISTORY Commands
The HISTORY subsystem commands control the waveform recording function and the history
waveform play function.


FRAM



FTIM?



HSMD



HSLST

88
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

HISTORY

FRAME_SET | FRAM
Command/QueryDESCRIPTION

The FRAME_SET command is used to set history current
frame number.
The FRAME_SET? query returns the current frame
number.

COMMAND SYNTAXFRAM <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 firsttime.

QUERY SYNTAXFRAM?

RESPONSE FORMATFRAM <frame_num>
Note:
The query is only valid for SDS1000X-E series.

EXAMPLEWhen the history function is on, the following commandsets current frame number to 50. Then you can see theresponse on the screen as shown below.

89
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Command message:

FRAM 5090
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

HISTORY

FRAME_TIME? | FTIM?
Query

DESCRIPTION

The FRAME_TIME query returns the acquire timestamp of
the current frame.

QUERY SYNTAXFTIM?

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 ineach oscilloscope series.

EXAMPLEFor the SDS1000X-E series, when the history function is
on, the following query returns the acquire time of thecurrent frame.
Query message:

FTIM?
Response message:

FTIM 00: 05: 12. 650814
Format in Each Oscilloscope Series
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

91
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

HISTORYHISTORY_MODE | HSMD
Command/QueryDESCRIPTION

The HISTORY_MODE command is used to set the stateof history mode.
The HISTORY_MODE? query returns the current state ofhistory mode.

COMMAND SYNTAXHSMD <state><state>:={ON,OFF}QUERY SYNTAXHSMD?

RESPONSE FORMATHSMD <state>

EXAMPLEThe following command sets the state of history mode toON.
Command message:

HSMD ONNote:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

92
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

HISTORYHISTORY_LIST | HSLST
Command/QueryDESCRIPTION

The HISTORY_LIST command is used to set the state ofhistory list.
The HISTORY_LIST? query returns the current state ofhistory list.

COMMAND SYNTAXHSLST <state><state>:={ON,OFF}
Note:
This command can only be used when History function isturned on.

QUERY SYNTAXHSLST?

RESPONSE FORMATHSLST <state>

EXAMPLEWhen History function is on, the following command sets
the state of history list to ON.
Command message:

HSLST ON
RELATED COMMANDS

HSMD

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL/CML /CNL/DL

no

SDS1000CML+/CNL+/DL+/E+/F+

noSDS1000Ano

SDS2000X

noSDS1000X

no93
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

94
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

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
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

DEFINE | DEF
Command/QueryDESCRIPTION

The DEFINE command sets the desired waveform mathoperation.
The DEFINE? query returns the current operation for theselected function.

COMMAND SYNTAXDEFINE EQN,’<equation>’Note:<equation>

is

the

mathematicalexpression,

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 SYNTAXDEFINE?

RESPONSE FORMATDEFINE EQN,’<equation>’

EXAMPLEWhen the Math function is on, and both Channel 1 andChannel 2 are on, the following command sets the mathoperation to Multiplication, source1 to C1, source2 to C2.
96
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Command message:

DEFINE EQN,’C1*C2’
When the Math function is on, and Channel 1 is on, thefollowingcommand

sets

the

math

operationtoDifferentiator, source to C1.
Command message:

DEFINE EQN,’DIFFC1’

97
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

INVERTSET | INVS
Command/QueryDESCRIPTION

The INVERTSET command inverts the math waveform.
The INVERTSET? query returns whether the mathwaveform is inverted or not.
Note:
This command is only valid in add, subtract, multiply anddivide operation.

COMMAND SYNTAX<trace>:INVERTSET <state><trace>:={MATH}<state>:= {ON,OFF}QUERY SYNTAX<trace>:INVERTSET?

RESPONSE FORMAT<trace>:INVERTSET <state>

EXAMPLEWhen the Math function is on, and the operation is Add,
the following command inverts the math waveform.
Command message:

MATH:INVS ON

98
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

MATH_VERT_DIV | MTVD
Command/QueryDESCRIPTION

The MATH_VERT_DIV command sets the vertical scale ofthe selected math operation. This command is only valid inadd, subtract, multiply and divide operation.
The MATH_VERT_DIV? query returns the current scalevalue for the selected operation.

COMMAND SYNTAXMATH_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 SYNTAXMATH_VERT_DIV?

RESPONSE FORMAT

MATH_VERT_DIV <scale>
Model

Format of <scale>

SDS1000X-E/

Numerical

value

in E-notation

with

99
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SDS2000X-E/

SI unit, such as 5.00E-01V.

SDS1000X-U
OthersNumerical value with measurement unit
and physical unit, such as 500mV.

EXAMPLEWhen the Math function is on, and the operator is Add, thefollowing command changes the vertical scale of the mathwaveform to 1 V.
Command message:

MTVD 1V

100
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

MATH_VERT_POS | MTVP
Command/QueryDESCRIPTION

The MATH_VERT_POS command sets the vertical
position of the math waveform with specified source.
The FFT waveform isn’t included, but we have anothercommand which called FFTP to set vertical position.
The MATH_VERT_POS? query returns the vertical
position of the math waveform.

COMMAND SYNTAXMATH_VERT_POS <point><point>:= -255 to 255.
Note:
The point represents the screen pixels and is related tothe screen center. For example, if the point is 50. The
math waveform will be displayed 1 grid above the verticalcenter of the screen. Namely one grid is 50.

QUERY SYNTAXMATH_VERT_POS?

RESPONSE FORMAT

MATH_VERT_POS <point>

EXAMPLEWhen the Math function is on, the following command sets
the vertical position of the math waveform to 1 grid above
the screen vertical center.
Command message:

MTVP 50
RELATED COMMANDS

FFTP

101
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

FFT_CENTER | FFTC
Command/QueryDESCRIPTION

The FFT_CENTER command sets the center frequency
when FFT (Fast Fourier Transform) is selected.
The FFT_CENTER? query returns the current center
frequency of FFT waveform.

COMMAND SYNTAXFFT_CENTER <center><center>:= frequency value with unit (MHz/ kHz/ Hz).
Note:
If you set the center to a value outside of the legal range,
the center value is automatically set to the nearest legal
value. Legal values are affected by the Hz/div setting.
The range for center is related to the horizontal scale of
FFT and varied by models. See the math menu ofoscilloscope as shown below for details.

QUERY SYNTAXFFT_CENTER?

RESPONSE FORMATFFT_CENTER <center>

EXAMPLEWhen the Math function is on, the operator is FFT, and thehorizontal scale is 100 MHz, the following command sets
the center frequency of FFT to 58 MHz.
102
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Command message:

FFTC 58MHzRELATED COMMANDS

FFTT?

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

103
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

FFT_FULLSCREEN | FFTF
Command/QueryDESCRIPTION

The FFT_FULLSCREEN command sets the display modeof FFT waveform.
The FFT_FULLSCREEN? query returns whether the FFT
waveform is full screen displayed.

COMMAND SYNTAXFFT_FULLSCREEN <state><state>:= {OFF,ON,EXCLU}OFF — Split Screen.
ON — Full Screen.
EXCLU — Exclusive.

QUERY SYNTAXFFT_FULLSCREEN?

RESPONSE FORMATFFT_FULLSCREEN <state>

EXAMPLEWhen the Math function is on, and the operator is FFT, thefollowing command sets the display mode of FFT
waveform to Full Screen.
Command message:

FFTF ON

104
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

FFT_POSITION | FFTP
Command/QueryDESCRIPTION

The FFT_POSITION command sets the vertical offset of
FFT waveform. The unit is related to the vertical scale typeof the current FFT and the unit of the channel.
The FFT_POSITION? query returns the current verticaloffset of the FFT waveform.
Note:
This command is only valid when the scale type is Vrms.

COMMAND SYNTAXFFT_POSITION <offset><offset>:= -24.4*DIV to 15.6*DIV.
Note:
If there is no unit (V/mV/uV) added, it defaults to volts(V).
If you set the offset to a value outside of the legal range,
the center value is automatically set to the nearest legal
value. Legal values are affected by the Scale setting.

QUERY SYNTAXFFT_POSITION?

RESPONSE FORMATFFT_POSITION <offset><offset>:= Numerical value in E-notation with SI unit.

EXAMPLEWhen the Math function is on, the operator is FFT, andthe scale is 10 mV, the following steps set the offset of
FFT waveform to 28 mV.
Step 1: Send command to set the scale unit to Vrms.
Command message:

FFTU VRMS
105
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Step 2: Send command to set the offset to 28 mV.
Command message:

FFTP 28mVWhen the Math function is on, the operator is FFT, andthe scale is 5 V, the following steps set the offset of FFT
waveform to -13.5 V.
Step 1: Send command to set the scale unit to Vrms.
Command message:

FFTU VRMS
Step 2: Send command to set the offset to -13.5 V.
Command message:

FFTP -13.5V
RELATED COMMANDS

FFTS
FFTU

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

106
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

FFT_SCALE | FFTS
Command/QueryDESCRIPTION

The FFT_SCALE command sets the vertical scale of FFT
waveform. The unit is related to the vertical scale type ofthe current FFT and the unit of the channel.
The FFT_SCALE? query returns the current vertical scaleof FFT waveform.

COMMAND SYNTAXFFT_SCALE <scale><scale>:={0.1,0.2,0.5,1,2,5,10,20} when scale type isdBVrms or dBm.
<scale>:={0.001,0.002,0.005,0.01,0.02,0.05,0.1,0. 2,0.5,1,
2,5,10,20} when scale type is Vrms.

QUERY SYNTAXFFT_SCALE?

RESPONSE FORMATFFT_SCALE <scale><scale>:= Numerical value in E-notation with SI unit.

EXAMPLEWhen the Math function is on, and the operator is FFT,the following steps set the vertical scale of FFT to 5
dBVrms.
Step 1: Send command to set the scale unit to dBVrms.
Command message:

FFTU DBVRMS
Step 2: Send command to set the scale to 5.
Command message:

FFTS 5
When the Math function is on, and the operator is FFT,the following steps set the vertical scale of FFT to 100
107
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuidemVrms.
Step 1: Send command to set the scale unit to Vrms.
Command message:

FFTU VRMS
Step 2: Send command to set the scale to 0.1.
Command message:

FFTS 0.1
RELATED COMMANDS

UNIT
FFTU
FFTP

108
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

FFT_TDIV? | FFTT?
Query

DESCRIPTION

The FFT_TDIV? query returns current horizontal scale of
FFT waveform.

QUERY SYNTAXFFT_TDIV?

RESPONSE FORMATFFT_TDIV <value><value>:= Numerical value with measurement unit andphysical unit.

EXAMPLEThe following query returns the horizontal scale unit of
FFT.
Query message:

FFTT?
Response message:

FFTT 100.00MHz
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

109
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

FFT_UNIT | FFTU
Command/QueryDESCRIPTION

The FFT_UNIT command sets the vertical scale type of
FFT (Fast Fourier Transform algorithm).
The FFT_UNIT? query returns the current vertical scale
type of FFT waveform.

COMMAND SYNTAXFFT_UNIT <unit><unit>:={VRMS,DBM,DBVRMS}QUERY SYNTAXFFT_UNIT?

RESPONSE FORMATFFT_ UNIT <unit>

EXAMPLEFor SDS1000X-E series, when the Math function is on,
and the operator is FFT, the following command sets thevertical scale unit of FFT to dBVrms.
Command message:

FFTU DBVRMSRELATED COMMANDS

FFTS
FFTP

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

110
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATH

FFT_WINDOW | FFTW
Command/QueryDESCRIPTION

The FFT_WINDOW command allows the selection of fivedifferent windowing transforms or operations for the FFT(Fast Fourier Transform) function. Each window is usefulfor certain classes of input signals.
The FFT_WINDOW? query returns the current window of
FFT.

COMMAND SYNTAXFFT_WINDOW <window><window>:={RECT,BLAC,HANN,HAMM,FLATTOP}RECT — Rectangle is useful for transient signals, andsignals where there are an integral number of cycles in thetime record.
BLAC — Blackman reduces time resolution compared to
the rectangular window, but it improves the capacity todetect smaller impulses due to lower secondary lobes(provides minimal spectral leakage).
HANN — Hanning is useful for frequency resolution andgeneral purpose use. It is good for resolving two
frequencies that are close together, or for making
frequency measurements.
HAMM — Hamming.
FLATTOP — Flattop is the best for making accurate
amplitude measurements of frequency peaks.

QUERY SYNTAXFFT_WINDOW?

RESPONSE FORMATFFT_WINDOW <window>

EXAMPLEWhen the Math function is on, and the operator is FFT, thefollowing command sets the FFT window to Hamming.
Command message:
111
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

FFTW HAMM

112
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MEASURE Commands
The commands in the MEASURE subsystem are used to make parametric measurements on
displayed waveforms.
To make a measurement, the portion of the waveform required for that measurement must be
displayed on the oscilloscope screen.


CYMT?



MEAD



PACU



PAVA?



PASTAT



MEACL



MEGS



MEGA



MEGB

113
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MEASURECYMOMETER? | CYMT?
Query

DESCRIPTION

The CYMOMETER? query measures and returns thefrequency counter of the specified source. The countermeasurement counts the trigger level crossings at the
selected trigger slope and displays the results in
MHz/kHz/Hz.
In the following picture, the content of the red box is themeasured value of the cymometer.

QUERY SYNTAXCYMOMETER?

RESPONSE FORMATCYMOMETER <freq>
Model

Format of <freq>

SDS1000X-E/

Numerical value in E-notation with

SDS2000X-E/

SI unit, such as 1.00E+03Hz.

SDS1000X-U
OthersNumerical value with measurement
unit

and

physical

unit,

such

as

1.00001 kHz.
Note:
When the signal frequency is less than 10 Hz, it returns“10 Hz” or “<10Hz”.
114
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

EXAMPLEWhen the frequency of input signal is l Hz, the following
returns the value of cymometer which displaying on thescreen of the instrument.
Response message:CYMT 10Hz
When the frequency of input signal is 25.000137 MHz,the following returns the value of cymometer whichdisplaying on the screen of the instrument.
Response message:CYMT 2.50E+07Hz

115
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MEASUREMEASURE_DELAY | MEAD
Command/QueryDESCRIPTION

The MEASURE_DELY command places the instrument in
the continuous measurement mode and starts a type ofdelay measurement.
The MEASURE_DELY? query returns the measured valueof delay type.

COMMAND SYNTAXMEASURE_DELAY <type>,<sourceA-sourceB><sourceA-sourceB>:={C1-C2,C1-C3,C1-C4,C2-C3,C2C4,C3-C4}<type>:={PHA,FRR,FRF,FFR,FFF,LRR,LRF,LFR,LFF,SK
EW}
Type

Description
The

phase

difference

betweentwochannels.

PHA(rising edge - rising edge)
Delay between two channels.

FRR(first rising edge - first rising edge)
Delay between two channels.

FRF(first rising edge - first falling edge)
Delay between two channels.

FFR(first falling edge - first rising edge)
Delay between two channels.

FFF(first falling edge - first falling edge)
Delay between two channels.

LRR(first rising edge - last rising edge)
Delay between two channels.

LRF(first rising edge - last falling edge)
Delay between two channels.

LFR(first falling edge - last rising edge)
Delay between two channels.

LFF
116

WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide(first falling edge - last falling edge)
SKEW

Delay between two channels.
(edge – edge of the same type)QUERY SYNTAX<sourceA-sourceB>:MEASURE_DELY? <type>RESPONSE FORMAT<sourceA-sourceB>:MEAD <type>,<value>
Model

Format of <value>

SDS1000X-E/

Numerical

SDS2000X-E/

SI unit, such as 1.24E-04S. Except for

SDS1000X-U

PHA, it returns as “44.65degree”.

OthersNumerical

value

value

in E-notationin E-notation

with

with

SI unit, such as 2.06E+01degree.

EXAMPLEThe following steps show how to get the measured valueof phase between C2 and C4.
Step 1: Send the message to set the measurement toPhase between C2 and C4, and then there displays aphase measurement on the screen.
Command message:

MEAD PHA,C2-C4

Step 2: Send the message to get the measured value ofphase.
117
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Command message:

C2-C4:MEAD? PHA
Response message:

C2-C4:MEAD PHA,-89.46degree

118
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MEASUREPARAMETER_CUSTOM | PACU
Command

DESCRIPTIONThePARAMETER_CUSTOM

commandinstallsameasurement and starts the specified measurement of thespecified source.
See the command PAVA? to get the measured value of
specified measurement.
See the command MEADto install the measurement of
delay class.
COMMAND SYNTAXPARAMETER_CUSTOM <parameter>,<source><source>:= {C1,C2,C3,C4}<parameter>:={PKPK,MAX,MIN,AMPL,TOP,BASE,CMEA
N,MEAN,STDEV,VSTD,RMS,CRMS,OVSN,FPRE,OVSP,RPRE,LEVELX,DELAY,TIMEL,PER,FREQ,PWID,NWID,R
ISE,FALL,WID,DUTY,NDUTY,ALL}
Description of Parameter
Parameter

Description

PKPK

vertical peak-to-peakMAXmaximum vertical value

MIN

minimum vertical value

AMPL

vertical amplitudeTOP

waveform top value

BASE

waveform base value

CMEAN

average value in the first cycle

MEAN

average value

STDEV

standard deviation of the data

VSTD

standard deviation of the data in the first
cycle

RMS

RMS valueCRMS

RMS value in the first cycle
119
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

OVSN

overshoot of a falling edge

FPRE

preshoot of a falling edge

OVSP

overshoot of a rising edge

RPRE

preshoot of a rising edge

LEVELX

Level measured at trigger position

PER

periodFREQ

frequency

PWID

positive pulse width

NWID

negative pulse width

RISE

rise-timeFALL

fall-time

WID

Burst width

DUTY

positive duty cycle

NDUTY

negative duty cycle

DELAY

time from the trigger to the first transitionat the 50% crossing

TIMEL

time from the trigger to each rising edge
at the 50% crossingALL

All measurements snapshot, equal to turnon the switch of all measure

EXAMPLEThe following command sets the type of measure to
PKPK of Channel 1. Command message:

PACU PKPK,C1
Then, you can see the measurement on the screen.

120
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

The following command sets the type of measure to ALL
of Channel 2. Command message:

PACU ALL,C2
Then, you can see a snapshot of all measurements on thescreen.

RELATED COMMANDS

PAVA?
MEAD
MEACL

121
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MEASUREPARAMETER_VALUE? | PAVA?
Query

DESCRIPTION

The PARAMETER_VALUE query measures and returns
the specified measurement value present on the selected
waveform.
There are three uses for this command:
Usage

Description

Usage1

Specify the source and the measurement.
See the command “MEAD?” to get themeasured value of delay measurement.

QUERY SYNTAXUsage 2

Use “PAVA? CUST<x>” to get customized.

Usage 3

Use “PAVA? STAT<x>” to get statistics.

 Usage 1<source>:PARAMETER_VALUE? <parameter><source>:= {C1,C2,C3,C4}<parameter>:={PKPK,MAX,MIN,AMPL,TOP,BASE,CMEA
N,MEAN,STDEV,VSTD,RMS,CRMS,OVSN,FPRE,OVSP,RPRE,LEVELX,PER,FREQ,PWID,NWID,RISE,FALL,WID,
DUTY,NDUTY,DELAY,TIMEL,ALL}
See the table Description of Parameter for details.

RESPONSE FORMAT<source>:PARAMETER_VALUE <parameter>,<value><value>:= Numerical value in E-notation with SI unit.

QUERY SYNTAX

 Usage 2
PARAMETER_VALUE? CUST<x><x>:= 1 to 5, and ALL
CustomDescription

Parameters
122
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CUST1

The first measure parameter specified by“PACU”

CUST2

The

secondmeasureparameter

specified by “PACU”
CUST3

The third measure parameter specified
by “PACU”

CUST4

The fourth measure parameter specified
by “PACU”

CUST5

The fifth measure parameter specified by“PACU”CUSTALL

All measure parameters specified by“PACU”

Note:
Installing the measurement as CUST<x> by usingcommand “PACU”, before using usage 2.
When the number of installed measurements is less than
5 and you send the command “PAVA? CUSTALL”, it will
return OFF as value for remaining custom parameters.
RESPONSE FORMATPARAMETER_VALUECUST<x>:<source>,<parameter>,<value><value>:= Numerical value in E-notation with SI unit.

QUERY SYNTAX

 Usage 3
PARAMETER_VALUE? STAT<x><x>:= 1 to 5
CustomDescription

Parameters
STAT1

Statistics

of

the

first

measureparameter specified by “PACU”
STAT2

Statistics

of

the

secondmeasureparameter specified by “PACU”
STAT3

Statistics

of

the

third

measure123
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

parameter specified by “PACU”
STAT4

Statistics

of

the

fourthmeasureparameter specified by “PACU”
STAT5

Statistics

of

the

fifth

measureparameter specified by “PACU”
Note:Installing the statistics of the measurement as STAT<x>by using command “PACU” and turn on the statistics byusing the command “PASTAT” before using usage 3.
RESPONSE FORMATPARAMETER_VALUE

STAT<x><source><parameter>:cur,<value1>,mean,<value2>,min,<value3>,max,<value4>,std-dev,<value5>,count,<value6>
Parameter

Description

curCurrent value of measurement

mean

Mean value of measurementmin

Minimum value of measurementmax

Maximum value of measurement

std-dev

Standard deviation of measurement

count

Measurement count<value>:= Numerical value in E-notation with SI unit.
EXAMPLEThe following query returns the rise time of Channel 2.
Query message:

C2:PAVA? RISE
Response message:

C2:PAVA RISE,3.6E-9S
The following query returns all measurement of Channel
1.
Query message:

C1:PAVA? ALL
Response message:
124
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

C1:PAVA

MAX,2.04E+00V,MIN,-

2.16E+00V,PKPK,4.20E+00V,TOP,2.00E+00V,BASE,2.08E+00V,AMPL,4.08E+00V,MEAN,-1.95E02V,CMEAN,-6.30E03V,STDEV,1.46E+00V,VSTD,1.46E+00V,RMS,1.46E+00
V,CRMS,1.46E+00V,OVSN,1.96%,FPRE,0.98%,OVSP,0.
98%,RPRE,0.00%,LEVELX,0.00E+00V,PER,4.00E08S,F
REQ,2.50E+07Hz,PWID,****,NWID,****,RISE,4.29E01S,FALL,1.14E-08S,WID,9.99E08S,DUTY,****,NDUTY,****,DELAY,-6.01E08S,TIMEL,3.97E-08S
The following steps show how the user customize themeasurement parameters and get the measured value.
Step 1: Send the command to set the measurement
parameter.
Command message:

PACU PKPK,C1
Step 2: Send the query to get the measured value.
Query message:

PAVA? CUST1
Response message:

PAVA CUST1:C1,PKPK,4.08E+00V
Step 3: You can also send the query to get the measured
value.
Command message:

PAVA? CUSTALL
Response message:PAVA
CUST1:C1,PKPK,4.08E+00V;CUST2:OFF;CUST3:OFF;C
UST4:OFF;CUST5:OFF
The following steps show how to get the statistical valuesof user defined measurement parameters.
Step 1: Send the command to set the measurement
parameter as the first customized parameter.
125
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Command message:

PACU FREQ,C3
Step 2: Send the command to turn on the statistics.
Command message:

PASTAT ON
Step 3: Send the query to get the statistical values of thefirst customized parameter.
Query message:

PAVA? STAT1
Response message:

PAVA

STAT1

C3

FREQ:cur,1.00E+06Hz,mean,1.00E+06Hz,min,9.97E+05
Hz,max,1.00E+06Hz,std-dev,1.41E+03Hz,count,171
RELATED COMMANDS

PACU
MEAD
PASTAT

126
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MEASUREPASTAT
Command/QueryDESCRIPTION

The PASTAT command controls the operation and displayof measurement statistics.
The PASTAT? query return the state of measurement
statistics.

COMMAND SYNTAXPASTAT <state><state>:={OFF, ON, RESET}
OFF — turn off the measurement statistics.
ON — turn on the measurement statistics.
RESET — reset the measurement statistics.

QUERY SYNTAXPASTAT?

RESPONSE FORMATPASTAT <state><state>:={OFF, ON}

EXAMPLEWhen the measurement item is turned on, the following
command turn on the measurement statistics.
Command message:

PASTAT ON
If you want to clear all of the statistics accumulated for all
periodic measurements, the following command shows.
Command message:

PASTAT RESET
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000A

no127
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes, but query not support

SDS1000X-U

yes, but query not support

128
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MEASUREMEASURE_CLEAR | MEACL
Command

DESCRIPTION

The MEACL command removes all user specified
measurements.

COMMAND SYNTAXMEACLEXAMPLEWhen measurement items are turned on, the following
command remove all displayed measurement items.
Command message:MEACL
RELATED COMMANDS

PACU

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

129
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MEASUREMEASURE_GATE_SWITCH | MEGS
Command

DESCRIPTION

The MEGS command controls the switch of the gatemeasurement. When the gate is turned on, only the
waveform within the threshold will be measured.
The MEGS? query return the switch of the gate.

COMMAND SYNTAXMEGS <state><state>:={OFF, ON}
OFF — turn off the gate measurement.
ON — turn on the gate measurement.

EXAMPLEWhen the measure is turned on, the following command
turn on the gate measurement.
Command message:

MEGS ONNote:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

130
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MEASUREMEASURE_GATEA | MEGA
Command

DESCRIPTION

The MEGA command specifies the position of themeasurement gateA.

COMMAND SYNTAXMEGA <value><value>:= value with unit.
Note:You need add the time unit (s/ms/us/ns) to the position. If
there is no unit added, it defaults to be S.
The range of the value is related to the timebase andhorizontal position.
The value of gateA must not be greater than the value ofgateB, otherwise it will be automatically set to the value ofgateB.

EXAMPLEWhen the gate switch is on, the following command set
the position of gateA to 20us.
Command message:

MEGA 20us
RELATED COMMANDS

MEGS
MEGB

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes
131
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SDS1000X-U

yes

132
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MEASUREMEASURE_GATEB | MEGB
Command

DESCRIPTION

The MEGB command specifies the position of themeasurement gate B.

COMMAND SYNTAXMEGB <value><value>:= value with unit.
Note:You need add the time unit (s/ms/us/ns) to the position. If
there is no unit added, it defaults to be S.
The range of the value is related to the timebase andhorizontal position.
The value of gateB must not be less than the value ofgateA, otherwise it will be automatically set to the value ofgateA.

EXAMPLEWhen the gate switch is on, the following command set
the position of gateB to 1.68 ms.
Command message:

MEGB 1.68ms
RELATED COMMANDS

MEGS
MEGA

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes
133
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SDS2000X-E

yes

SDS1000X-U

yes

134
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL Commands
The PASS/FAIL subsystem commands and queries control the mask test features.


PACL



PFBF



PFCM



PFDD?



PFDS



PFEN



PFFS



PFOP



PFSC



PFST

135
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL

PARAMETER_CLR | PACL
Command

DESCRIPTION

The PARAMETER_CLR command resets the P/F test
statistics.

COMMAND SYNTAXPARAMETER_CLR

RELATED COMMANDS

PFDD?

136
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL

PF_BUFFER | PFBF
Command/QueryDESCRIPTION

The PF_BUFFER command sets the output mode when
the test fails. This is the same as pressing the “Output”
button on the menu of PASS/FAIL on the front panel.
The PF_BUFFER? query returns the current output modeof the pass/fail.

COMMAND SYNTAXPF_BUFFER <state><state>:={ON,OFF}ON — The statistical result is displayed when the failed
waveform is detected, and the buzzer alarm. (not related
to the state of the sound switch)
OFF — The statistical result is displayed when the failed
waveform is detected, but the buzzer does not alarm.

QUERY SYNTAXPF_BUFFER?

RESPONSE FORMATPF_BUFFER <state>

EXAMPLEWhen the PASS/FAIL function is on, the following
command sets “output” to “ON”.
Command message:

PFBF ONNote:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

no137
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

138
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL

PF_CREATEM | PFCM
Command

DESCRIPTION

The PF_CREATEM command creates a Pass/Fail test rulearound the current selected channel, using the horizontal
adjustment parameters and the vertical adjustment
parameters defined by the PFST commands.
Note:This command is valid only if the Pass/Fail test function
has been opened (PFEN) and is not in operation (PFOP).

COMMAND SYNTAXPF_ CREATEM

EXAMPLEThe following steps create the mask of the Pass/Fail.
Step 1: Send command to set the Pass/Fail test enable.
Command message:

PFEN ON
Step 2: Send command to stop the operation.
Command message:

PFOP OFF
Step 3: Send command to create the rule.
Command message:

PFCM
RELATED COMMANDS

PFST
PFSC
PFEN
PFOP

139
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL

PF_DATADIS? | PFDD?
Query

DESCRIPTION

The PF_DATADIS? query returns the number of the failed
frames, passed frames and total frames which are shownon screen.

COMMAND SYNTAXPF_ DATADIS?

RESPONSE FORMATPF_DATADIS FAIL,<num>,PASS,<num>,TOTAL,<num>

EXAMPLEThe following query returns the number of the message
display of the pass/fail.
Query message:

PFDD?
Response message:

PFDD FAIL,0,PASS,0,TOTAL,0140
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL

PF_DISPLAY | PFDS
Command/QueryDESCRIPTION

The PF_DISPLAY command displays information in
Pass/Fail test features.
The PF_DISPLAY? query returns whether the message ofPass/Fail is displayed.

COMMAND SYNTAXPF_DISPLAY <state><state>:={ON,OFF}QUERY SYNTAXPF_DISPLAY?

RESPONSE FORMAT

PF_DISPLAY <state>

EXAMPLThe following steps display the message of Pass/Fail.
Step 1: Send command to set the Pass/Fail test enable.
Command message:

PFEN ON
Step 2: Send command to display the message ofPass/Fail.
Command message:

PFDS ON
RELATED COMMANDS

PFEN

141
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL

PF_ENABLE | PFEN
Command /QueryDESCRIPTION

The PF_ENABLE command enables or disables the
Pass/Fail test features.
The PF_ENABLE? query returns the current state of mask
test features.

COMMAND SYNTAXPF_ENABLE <state><state>:= {ON,OFF}ON — Enable the mask test features.
OFF — Disable the mask test features.

QUERY SYNTAXPF_ENABLE?

RESPONSE FORMATPF_ENABLE <state>

EXAMPLThe following command enables mask test features.
Command message:

PFEN ONNote:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

142
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL

PF_FAIL_STOP | PFFS
Command/QueryDESCRIPTION

The PF_FAIL_STOP command sets the switch of the “stopon fail” function. This is the same as pressing the “Stop on
Fail” button on the menu of Pass/Fail on the front panel.
The PF_FAIL_STOP? query returns the state of the “stopon fail” function.

COMMAND SYNTAXPF_FAIL_STOP <state><state>:={ON,OFF}ON — To monitor the failure waveform, the oscilloscope
stops testing and enters the "STOP" state. At this point,
the screen displays the last statistical result.(if the display
is already open)
OFF — To monitor the failure waveform, the oscilloscope
will continue to test and update the statistics on the screen
immediately.

QUERY SYNTAXPF_FAIL_STOP?

RESPONSE FORMAT

PF_FAIL_STOP <state>

EXAMPLEThe following command sets “stop on fail” to “off”.
Command message:

PFFS OFFNote:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

no143
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

144
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL

PF_OPERATION | PFOP
Command/QueryDESCRIPTION

The PF_OPERATION command controls to run or stop
Pass/Fail test.
The PF_OPERATION? query returns the operation stateof Pass/Fail test.

COMMAND SYNTAXPF_OPERATION <state><state>:={ON,OFF}QUERY SYNTAXPF_OPERATION?

RESPONSE FORMAT

PF_OPERATION <state>

EXAMPLEThe following command controls to run Pass/Fail test.
Command message:

PFOP ON
RELATED COMMANDS

PFEN

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

145
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL

PF_SOURCE | PFSC
Command/QueryDESCRIPTION

The PF_SOURCE command sets measurement sources
for Pass/Fail test.
The PF_SOURCE? query returns the measurement
source for Pass/Fail test.

COMMAND SYNTAXPF_SOURCE <trace><trace>:={C1,C2,C3,C4}QUERY SYNTAXPF_SOURCE?

RESPONSE FORMAT

PF_SOURCE <trace>

EXAMPLEThe following command sets the measurement source toChannel 1 when Channel 1 is on.
Command message:

PFSC C1Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

146
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PASS/FAIL

PF_SET | PFST
Command/QueryDESCRIPTION

The PF_SET command sets the tolerance in the X/Y
direction around the selected waveform defined by PFSC
for the Pass/Fail feature. The value of the tolerance will be
added and subtracted to horizontal/Vertical values of the
waveform to determine the boundaries of the mask.
The PF_ SET? query returns the current setting of the ΔX
tolerance and ΔY tolerance for Pass/Fail.

COMMAND SYNTAXPF_ SET XMASK,<div>,YMASK,<div><div>:= 0.04 to 4.0.
Note:
Step value is 0.04.

QUERY SYNTAXPF_ SET?

RESPONSE FORMATPF_ SET XMASK,<div>,YMASK,<div>

EXAMPLEThe following command sets the X mask to 0.4 and the Y
mask to 0.52.
Command message:

PFST XMASK,0.4,YMASK,0.52
RELATED COMMANDS

PFSC

147
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PRINT Commands


SCDP

148
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PRINT

SCREEN_DUMP | SCDP
Query

DESCRIPTIONThe SCREEN_DUMP command captures the screen andreturns the data of bmp file.

QUERY SYNTAXSCREEN_DUMPRESPONSE FORMAT<bmp header><bmp screen data>
Note:
You only need to save the returned information in a BMP
format file.

EXAMPLEThe following step shows how to transfers the screen
information as a file named screen.bmp in a Python shell.
Step 1: Send the query to get the bmp data.
Query message:

SCDP
Step 2: Create a new bmp file named “screen.bmp”.
Step 3: Write the data to the file.
Step 4: Close the file.

(See the code in Screen Dump (SCDP) Example)

149
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

RECALL Commands
Recall previously saved oscilloscope setups and reference waveforms.


*RCL



RCPN

150
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

RECALL*RCL
Command

DESCRIPTIONThe *RCL command recalls the complete front-panel
setup of the instrument from internal memory, using one of
the twenty non-volatile panel setups. This command is
opposite to the command *SAV.
See the command RCPN for recalling the setup fromexternal.

COMMAND SYNTAX*RCL <num><num>:= 0 to 20.
Note:When num is 0, it will recall the default panel setup.
As shown below, when the progress is finished, there will
be a prompt message.

EXAMPLEWhen you have stored the instrument setup in No.3, thefollowing command recalls the setup 3.
Command message:*RCL 3
RELATED COMMANDS

RCPN
*SAV
151
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

RECALL

RECALL_PANEL | RCPN
Command

DESCRIPTION

The RECALL_PANEL command recalls a front-panel
setup from the specified-DOS path directory in an external
memory device.
See the command “*RCL” for recalling from internal.

COMMAND SYNTAXRECALL_PANEL DISK,<device>,FILE,‘<filename>’<device>:= {UDSK}<filename>:= A waveform file under a legal DOS path.
ModelsDescription

SDS1000X-E/

The filename string is up to eight

SDS2000X-E/

characters, with the extension “.xml”.

SDS1000X-U
Others

The filename string is up to eightcharacters, with the extension “.set”.

Note:See models on page 15.
For SDS1000X-E series, the ‘/’ character to define theroot directory is not supported.
As shown below, when the progress is finished, there will
be a prompt message.

152
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideAs shown below, if the filename is wrong, there will be a
prompt message.

EXAMPLEFor SDS1000X-E series, when you plug in an U-disk to
the oscilloscope, the following command recalls the frontpanel setup from a file called “TEST.xml” in root directoryof the USB memory device.
Command message:

RCPN DISK,UDSK,FILE,‘TEST.xml’For SDS1000X-E series, when you plug in an U-disk to
the oscilloscope, the following command recalls the frontpanel setup from a file called “TEST.xml” in specifieddirectory of the USB memory device.
Command message:

RCPN DISK,UDSK,FILE,’/SAVE/TEST.xml’
RELATED COMMANDS

STPN
*RCL

153
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

REFERENCE Commands
The REFERENCE system controls the reference waveforms.


REFCL



REFDS



REFLA



REFPO



REFSA



REFSC



REFSR

154
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

REFERENCE

REF_CLOSE | REFCL
Command

DESCRIPTIONThe

REF_CLOSE

commandclosestheReference

function.
COMMAND SYNTAXREF_CLOSE

EXAMPLEThe following command closes the Reference function.
Command message:

REFCL

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

155
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

REFERENCE

REF_DISPLAY | REFDS
Command/QueryDESCRIPTION

The REF_DISPLAY command enables or disables thecurrent reference channel shown on the screen.
The REF_DISPLAY? query returns whether the current
reference channel shows on the screen.

COMMAND SYNTAXREF_ DISPLAY <state><state>:= {ON,OFF}
Note:
Only used when the current reference channel has been
stored, and the Reference function is enable.

QUERY SYNTAXREF_ DISPLAY?

RESPONSE FORMATREF_ DISPLAY <state>

EXAMPLEThe following command displays the waveform of thecurrent reference channel.
Command message:

REFDS ON
RELATED COMMANDS

REFCL

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

no156
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

157
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

REFERENCEREF_LOCATION | REFLA
Command/QueryDESCRIPTION

The REF_LOCATION command selects the current
reference channel.
The REF_LOCATION? query returns the current reference
channel.

COMMAND SYNTAXREF_LOCATION <location><location>:= {REFA,REFB,REFC,REFD}QUERY SYNTAXREF_LOCATION?

RESPONSE FORMATREF_LOCATION <location>

EXAMPLEThe following command selects REFA as the current
reference channel.
Command message:

REFLA REFANote:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

158
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

REFERENCE

REF_POSITION | REFPOCommand/QueryDESCRIPTION

The REF_POSITION command sets the vertical offset ofthe current reference channel. This command is only used
when the current reference channel has been saved, andthe display state is on.
The REF_POSITION? query returns the vertical offset ofthe current reference channel.

COMMAND SYNTAXREF_ POSITION <offset><offset>:= vertical offset value with unit.
Note:If there is no unit (V/mV/uV) added, it defaults to be V.
The range of legal offset varies with the value set by the
REFSC command. If you set the offset to a value outsideof the legal range, the offset value is automatically set to
the nearest legal value.

QUERY SYNTAXREF_ POSITION?

RESPONSE FORMATREF_ POSITION <offset><offset>:= Numerical value in E-notation with SI unit.

EXAMPLEWhen the Reference function is on, REFB has been saved
and the scale is 2 V, the following command sets thecurrent reference channel vertical offset to 0.2 V.
Command message:

REFPO 0.2V
RELATED COMMANDS

REFSC

Note:
159
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

160
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

REFERENCEREF_SAVE | REFSA
Command

DESCRIPTION

The REF_SAVE command saves the waveform (screen
range) of the specified source as the reference waveformof the current reference channel to the memory anddisplays it on the screen.

COMMAND SYNTAXREF_SAVE

EXAMPLEWhen the Reference function is on, the REF source isChannel 2, and the REF location is REFA, the following
command saves Channel 2 as REFA and displays REFA
on screen.
Command message:

REFSA
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

161
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

REFERENCEREF_SCALE | REFSC
Command/QueryDESCRIPTION

The REF_SCALE command sets the vertical scale of thecurrent reference channel. This command is only used
when the current reference channel has been stored, andthe display state is on.
The REF_SCALE? query returns the vertical scale of thecurrent reference channel.

COMMAND SYNTAXREF_ SCALE <scale><scale>:= 500uV to 10V.
Note:
If there is no unit (V/mV/uV) added, it defaults to be V.

QUERY SYNTAXREF_ SCALE?

RESPONSE FORMATREF_ SCALE <scale><scale>:= Numerical value in E-notation with SI unit.

EXAMPLEWhen the Reference function is on, and REFA has beensaved, the following command sets the vertical scale of
REFA to 100 mV.
Command message:

REFSC 100mVNote:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

no162
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

163
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

REFERENCEREF_SOURCE | REFSR
Command /QueryDESCRIPTIONTheREF_SOURCE

commandsets

thereference

waveform source.
The REF_SOURCE? query returns the source of thecurrent reference channel.
COMMAND SYNTAXREF_SOURCE <source><source>:= {C1,C2,C3,C4,MATH}QUERY SYNTAXREF_SOURCE?

RESPONSE FORMATREF_SOURCE <source>

EXAMPLEWhen Channel 1 is on, the following command selects
Channel 1 as the source of current reference channel.
Command message:

REFSR C1Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

164
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SAVE Commands
Save oscilloscope setups and waveform data.


*SAV



PNSU



STPN

165
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SAVE

*SAV
Command

DESCRIPTIONThe *SAV command stores the complete front-panel setupof the instrument in internal memory.
This instruction does not support storing to external
temporarily. See the command STPN for external storage.

COMMAND SYNTAX*SAV <setup_num><setup_num>:= 1 to 20.
Note:
If there is already a file in the specified location, it will
overwrite the original file.

EXAMPLEWhen you want to save the current setup in panel asshown below, the following command saves it to setup
No.3.

Command message:*SAV 3
If you want to recall this setup, send the following
command.
Command message:
166
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide*RCL 3
RELATED COMMANDS

STPN
*RCL

167
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideSAVE

PANEL_SETUP | PNSU
Command/QueryDESCRIPTION

The PANEL_SETUP command use the data get from“PNSU?” to set the panel setup.
The PNSU? query return the data of panel setup fromscope.
There are two types of formats for returned data: binary
and xml. See the table below for details.
FormatDescription

BinaryThe returned data is binary, cannot becompatible between versions.
Applicable models:
SDS1000CFL
SDS1000A
SDS1000CML+/CNL+/DL+/E+/F+
SDS2000X
SDS1000X
SDS1000X-E (2ch, 4ch for V6.1.33 andearlier)

Xml

The returned data is in XML form andcompatible between versions.
Applicable models:
SDS1000X-E (4ch for V6.1.33R2 and later)
SDS2000X-E
SDS1000X-U

Note:
The query will take time and return a long data, so it isnecessary to set the timeout value and the buffer size
before query from the scope:

Set the I/O buffer size
The data length is related to the current panel setup.
It is recommended to set the read buffer size to 500k
168
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

bytes or more.
Set the timeout value
The timeout value is related to the network speed or
USB transmission speed. The initial value is generally
2s. It is recommended to set the value to 10s or more.

COMMAND SYNTAXPANEL_SETUP <header><setup data><header>:= Characters in the format of “#9<9-Digits>” isused to describe the length of <setup data>, which isreturned by the query PNSU?
<setup data>:= A setup previously returned by the queryPNSU?

QUERY SYNTAXPANEL_SETUP?

RESPONSE FORMATPANEL_SETUP <header><setup data>

EXAMPLEThe following steps show how to use the query andcommand to set the panel setup.
Step 1: Send the command to set the response format.
Command message:

CHDR OFF
Step 2: Send the query to get the binary data of setup.
Command message:

PNSU?
Response message:<header><setup data>
Step 3: Change the panel setup, and then send thecommand to restore setup get from step2.
Command message:

PNSU <header><setup data>
Step 4: You can also save the data in step 2 to a file andmake it easier to recall later. Store the file of format
according to the returned data. The following program is169
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

used as a reference for SDS1004X-E(V6.1.33R2).

170
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideSAVESTORE_PANEL | STPN
Command

DESCRIPTIONThe STORE_PANEL command stores the complete frontpanel setup of the instrument into a file on the specifiedDOS path directory in a USB memory device.
See the command “*SAV” for internal storage.

COMMAND SYNTAXSTORE_PANEL DISK,<device>,FILE,‘<filename>’<device>:= {UDSK}<filename>:= A waveform file under a legal DOS path.
ModelsDescription

SDS1000X-E/

The filename string is up to eight

SDS2000X-E/

characters,

SDS1000X-U“.xml”.

Others

The filename string is up to eightcharacters,

with

with

the

the

extension

extension“.set”.
Note:
See models on page 15.
For SDS1000X-E series, the ‘/’ character to define theroot directory is not supported.
As shown below, during the execution of the command, aprogress bar will appear on the interface. When the
progress is finished, there will be a prompt message.

171
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

EXAMPLEFor SDS1000X-E series, the following command saves
the current setup to root directory of the USB memory
device in a file called “TEST.xml”. Then you can see thefile on PC.
Command message:

STPN DISK,UDSK,FILE,’TEST.xml’For SDS1000X-E series, the following command saves
the current setup to specified-directory of the USB
memory device in a file called “TEST.xml”. Then you can
172
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

see the file on PC.
Command message:

STPN DISK,UDSK,FILE,’/SAVE/TEST.xml’

RELATED COMMANDS

*SAV
RCPN

173
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

STATUS Commands
IEEE 488.2 defines data structures, commands, and common bit definitions for status reporting.
There are also instrument-defined structures and bits.
An overview of the oscilloscope's status reporting structure is shown in the following commands.


INR?

174
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

STATUSINR?
Query

DESCRIPTION

The INR? query reads and clears the contents of INternal
state change Register (INR). The INR register records thecompletion of various internal operations and statetransitions.

QUERY SYNTAXINR?

RESPONSE FORMATINR <value><value>:= 0 to 65535.
Note :
This query only returns 0 bit and 13 bit.
See the table INternal State Register (INR) Structure asshown below for details.

EXAMPLEThe following steps show the change of INR.
Step 1: When the trigger mode is single, and there is no
signal input, send the query.
Response message:

INR 0
Step 2: Now, input a signal to trigger. The acquisitionmode is Stop. Then, send the query.
Response message:

INR 1
Step 3: Now, change the trigger mode to Auto. Then, send
the query.
Response message:

INR 8193
Step 4: Now, change the trigger mode to Single. The
acquisition mode changes to be Stop. And then, send thequery.
175
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Response message:

INR 8193
Step 5: After sending the query in step 4, send the query
again.
Response message:

INR 0
Step 6: After step 2, not to input the signal, change thetrigger mode to single. And then, send the query.
Response message:

INR 8192

INternal State Register (INR) Structure
Bit

Bit

Description

value
15

---

Not used (always 0)

14

---

Not used (always 0)

13

8192

Trigger is ready

12

4096

Pass/Fail test detected desired outcome

11

2048

Waveform processing has terminated in Trace D

10

1024

Waveform processing has terminated in Trace C

9512

Waveform processing has terminated in Trace B

8256

Waveform processing has terminated in Trace A

7

128

A memory card, floppy or hard disk exchange has been detected

664Memory card, floppy or hard disk has become full in “AutoStore Fill” mode5---

Not use(always 0)

4

16

A segment of a sequence waveform has been acquired3

8

A time-out has occurred in a data block transfer

2

4

A return to the local state is detected1

2

A screen dump has terminated0

1

A new signal has been acquired

176
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SYSTEM Commands
The SYSTEM subsystem commands control basic system functions of the oscilloscope.


*CAL?



BUZZ



CONET



SCSV



EMOD

177
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SYSTEM

*CAL?
Query

DESCRIPTIONThe *CAL? query starts the user calibration procedure andreturn a response.
The user calibration can quickly make the oscilloscopeachieve the best working state, in order to obtain the mostaccurate measurement value.
All function keys have been disabled during the selfcalibration process.
Before starting the user calibration procedure, you must
disconnect anything from inputs.

QUERY SYNTAX*CAL?

RESPONSE FORMAT*CAL 00 — Calibration successful.

EXAMPLEThe following query starts a self-calibration.
Query message:*CAL?
Response message:*CAL 0178
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SYSTEMBUZZER | BUZZ
Command/QueryDESCRIPTION

The BUZZER command enables or disables the buzzer.
The BUZZER? query returns the switch state of thebuzzer.

COMMAND SYNTAXBUZZER <state><state>:= {ON,OFF}QUERY SYNTAXBUZZER?

RESPONSE FORMATBUZZER <state>

EXAMPLEThe following command enables the oscilloscope buzzer.
Command message:

BUZZ ON

179
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SYSTEM

COMM_NET | CONET
Command/QueryDESCRIPTION

The COMM_NET command sets the IP address of theoscilloscope’s internal network interface.
When using this command, DHCP should be off.
The COMM_NET? query returns the IP address of theoscilloscope’s internal network interface.

COMMAND SYNTAXCOMM_NET <ip_add0>,<ip_add1>,<ip_add2>,<ip_add3>< ip_add0 >:= 1 to 223(except 127).
< ip_add1 >:= 0 to 255.
< ip_add2 >:= 0 to 255.
< ip_add3 >:= 0 to 255.

QUERY SYNTAXCOMM_NET?

RESPONSE FORMAT

COMM_NET<ip_add0>,<ip_add1>,<ip_add2>,<ip_add3>

EXAMPLEThe

followingcommand

sets

the

IP

address

to10.11.0.230.
Command message:

CONET 10,11,0,230

180
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SYSTEM

SCREEN_SAVE | SCSVCommand/QueryDESCRIPTIONThe SCREEN_SAVE command controls the automatic
screensaver, which automatically shuts down the internal
color monitor after a preset time.
The

SCREEN_SAVE?

query

returns

whethertheautomatic screensaver feature is on.
Note:
When the screensaver is enabled, the oscilloscope is still
fully functional.
COMMAND SYNTAXSCREEN_SAVE <time><time>:={OFF,1MIN,5MIN,10MIN,30MIN,60MIN}
OFF — Do not use screensaver.
Others — When the oscilloscope enters the idle state andholds for the specified time, screensaver will be enabled.

QUERY SYNTAXSCREEN_SAVE?

RESPONSE FORMATSCREEN_SAVE <time>

EXAMPLEThe following command sets the automatic screensaver to
10 minutes.
Command message:SCSV 10MIN

181
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SYSTEM

EduMode | EMOD
Command/QueryDESCRIPTION

The command sets the education mode (locks ofautosetup, measure and cursors) of the oscilloscope.
The query returns the education mode of the oscilloscope.

COMMAND SYNTAX

EduMode <func>,<lock><func>:={AutoSetup, Measure, Cursors}<lock>:={ON, OFF}QUERY SYNTAXON — Enable the function

OFF — Disable the function.

EduMode? <func><func>:={AutoSetup, Measure, Cursors}
Note:
The query without parameters will return the lock status of
all functions.

RESPONSE FORMAT

Query with the parameter “AutoSetup”:
EduMode AutoSetup,ON;
Query with no parameters:
EduModeAutoSetup,<lock>;Measure,<lock>;Cursors,<lock>;

EXAMPLEThe following command disables the Autosetup function.
Command message:

EMOD AutoSetup,OFF
Query message:

EMOD?
Response message:

AutoSetup,OFF;Measure,ON;Cursors,ON;
182
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TIMEBASE Commands
The TIMEBASE subsystem commands control the horizontal (X-axis) functions. The time per division,delay, and reference can be controlled for the main and window (zoomed) time bases.


TDIV



TRDL



HMAG



HPOS

183
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TIMEBASE

TIME_DIV | TDIV
Command/QueryDESCRIPTIONThe TIME_DIV command sets the horizontal scale perdivision for the main window.
The TIME_DIV? query returns the current horizontal scalesetting in seconds per division for the main window.

COMMAND SYNTAXTIME_DIV <value><value>:={1NS,2NS,5NS,10NS,20NS,50NS,100NS,200N
S,500NS,1US,2US,5US,10US,20US,50US,100US,200US,
500US,1MS,2MS,5MS,10MS,20MS,50MS,100MS,200MS,
500MS,1S,2S,5S,10S,20S,50S,100S}
NS — for nanoseconds.
US — for microseconds.
MS — for milliseconds.
S — for seconds.
Note:
The range of value varies from the models. See the data
sheet for details.

QUERY SYNTAXTIME_DIV?

RESPONSE FORMATTIME_DIV <value><value>:= Numerical value in E-notation with SI unit.

EXAMPLEThe command sets the horizontal scale to 500 μs.
Command message:

TDIV 500US
RELATED COMMANDS

TRDL
HMAG
HPOS
184
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TIMEBASE

TRIG_DELAY | TRDL
Command/QueryDESCRIPTIONThe TRIG_DELAY command sets the time interval
between the trigger event and the horizontal center pointon the screen. The maximum position value depends on
the time/division settings.
Pre-trigger acquisition — Data acquired before the trigger
occurs. Negative trigger delays must be given in seconds.
Post-trigger acquisition — Data acquired after the trigger
has occurred.
The TRIG_DELAY? query returns the current time fromthe trigger to the horizontal center point in seconds.

COMMAND SYNTAXTRIG_DELAY <delay><delay>:= time value with unit.
Note:The range of delay is related to the time base. See thedata sheet for details.
If you set the delay to a value outside of the legal range,
the delay value is automatically set to the nearest legal
value.

QUERY SYNTAXTRIG_DELAY?

RESPONSE FORMATTRIG_DELAY <value>
Model

Format of <skew>

SDS1000X-E/

Numerical value in E-notation with

SDS2000X-E/

SI unit, such as 1.00E-04 s.

SDS1000X-U
OthersNumerical value with measurement
185
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

unit and physical unit, such as 3.58 ns.

EXAMPLEWhen the time base is 1us/div, the following commandsets the trigger delay to -4.8 us (pre trigger).
Command message:

TRDL -4.8US
RELATED COMMANDS

TDIV

186
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TIMEBASE

HOR_MAGNIFY | HMAG
Command/QueryDESCRIPTIONThe

HOR_MAGNIFY

commandsets

thezoomed(delayed) window horizontal scale (seconds/div). The main
sweep scale determines the range for this command. The
maximum value is the TDIV value.
The HOR_MAGNIFY? query returns the current zoomed
window scale setting.
COMMAND SYNTAXFormat 1:
HOR_MAGNIFY <value><value >:={1NS,2NS,5NS,10NS,20NS,50NS,100NS,200N
S,500NS,1US,2US,5US,10US,20US,50US,100US,200US,
500US,1MS,2MS,5MS,10MS,20MS}
The range of value is related to the current time base. It isfrom 1NS to the current time base.
Format 2:
HOR_MAGNIFY <factor><factor>:= 1 to 2,000,000.
The range of <factor> is related to the current time baseand the range of the time base.
Note:
The table on next page shows the available format in each
oscilloscope series.

QUERY SYNTAXHOR_MAGNIFY?

RESPONSE FORMATHOR_MAGNIFY <value><value>:= Numerical value in E-notation with SI unit.
187
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

HOR_MAGNIFY <factor>
EXAMPLEFor SDS1000X-E series, when the time base is 1ms/div,
and Zoom function is on, the following command sets thezoomed (delayed) window horizontal scale to 1 us.
Command message:

HMAG 1USRELATED COMMANDSTDIV

Format in Each Oscilloscope Series
Model

Command Format

SDS1000CFL

Format 2

SDS1000A

Format 2

SDS1000CML+/CNL+/DL+/E+/F+

Format 2

SDS2000X

Format 2

SDS1000X

Format 2

SDS1000X-E

Format 1

SDS2000X-E

Format 1

SDS1000X-U

Format 1

188
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TIMEBASE

HOR_POSITION | HPOS
Command/QueryDESCRIPTION

The HOR_POSITION command sets the horizontal
position in the zoomed (delayed) view of the main sweep.
The main sweep range and the main sweep horizontal
position determine the range for this command. The value
for this command must keep the zoomed view window
within the main sweep range.
The HOR_POSITION? query the current horizontal
window position setting in the zoomed view.

COMMAND SYNTAXFormat 1:
HOR_POSITION <position><position>:= time value with unit.
Note:You need add the time unit (s/ms/us/ns) to the position. If
there is no unit added, it defaults to be S.
The range of position is related to the main sweep range
and the main sweep horizontal position. The range after
magnifying which beyond the screen could display, and it
will be adjusted to the proper value.
Format 2:
HOR_POSITION <factor_div>< factor_div>:= the factor of zoomed time base.
Note:
The table on next page shows the available format in each
oscilloscope series.

189
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideQUERY SYNTAXHOR_POSITION?

RESPONSE FORMAT

HOR_POSITION <position><position>:= Numerical value in E-notation with SI unit.
HOR_POSITION <factor_div>

EXAMPLEFor SDS1000X-E series, when the time base is 10 us/div,
the horizontal position is 0, Zoom function is on, and thezoomed scale is 5 us. The range of zoom position is from 35 us to 35 us. The following command sets the zoom
position to 100 ns.
Command message:

HPOS 100ns
RELATED COMMANDS

HMAG
TDIV
TRDL

Format in Each Oscilloscope Series
Model

Command Format

SDS1000CFL

Format 2

SDS1000A

Format 2

SDS1000CML+/CNL+/DL+/E+/F+

Format 2

SDS2000X

Format 2

SDS1000X

Format 2

SDS1000X-E

Format 1

SDS2000X-E

Format 1

SDS1000X-U

Format 1

190
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRIGGER Commands
The TRIGGER subsystem controls the trigger modes and parameters for each trigger type.


SET50



TRCP



TRLV



TRLV2



TRMD



TRPA



TRSE



TRSL



TRWI

191
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRIGGER

SET50
Command

DESCRIPTIONThe SET50 command automatically sets the trigger levels
to center of the trigger source waveform.
When High and Low (dual) trigger levels are used (asRunt triggers, for example), this command has no effect.

COMMAND SYNTAXSET50EXAMPLEWhen the trigger type is edge and the trigger source isChannel 1, the following command sets the trigger level tothe center of Channel 1.
Command message:

SET50
RELATED COMMANDS

TRLV

192
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRIGGER

TRIG_COUPLING | TRCP
Command/QueryDESCRIPTIONThe TRIG_COUPLING command sets the input coupling
for the selected trigger sources.
The TRIG_COUPLING? query returns the trigger couplingof the selected source.

COMMAND SYNTAX<trig_source>:TRIG_COUPLING <trig_coupling><trig_source>:={C1,C2,C3,C4,EX,EX5}<trig_coupling>:={AC,DC,HFREJ,LFREJ}
AC — AC coupling block DC component in the trigger
path, removing dc offset voltage from the trigger
waveform. Use AC coupling to get a stable edge trigger
when your waveform has a large dc offset.
DC — DC coupling allows dc and ac signals into thetrigger path.
HFREJ — HFREJ coupling places a low-pass filter in thetrigger path.
LFREJ — LFREJ coupling places a high-pass filter in thetrigger path.

QUERY SYNTAX<trig_source>:TRIG_COUPLING?

RESPONSE FORMAT<trig_source>:TRIG_COUPLING <trig_coupling>

EXAMPLEThe following command sets the coupling mode of thetrigger source Channel 2 to AC.
Command message:

C2:TRCP AC
RELATED COMMANDSTRSE

TRIGGER

TRIG_LEVEL | TRLV
193
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Command/QueryDESCRIPTIONThe TRIG_LEVEL command sets the trigger level voltage
for the active trigger source.
When there are two trigger levels to set, this command isused to set the higher trigger level voltage for the specified
source. TRLV2 is used to set the lower trigger level
voltage.
The TRIG_LEVEL? query returns the trigger level of thecurrent trigger source.

COMMAND SYNTAX<trig_source>:TRIG_LEVEL <trig_level><trig_source>:={C1,C2,C3,C4,EX,EX5}<trig_level>:= -4.5*DIV to 4.5*DIV for internal triggers.
<trig_level>:= -3*DIV to 3*DIV for external triggers.
Note:You need to add the volt unit (V/mV) to the trig_level. If
there is no unit added, it defaults to volts (V).
An out-of-range value will be adjusted to the closest legal
value.

QUERY SYNTAX<trig_source>:TRIG_LEVEL?

RESPONSE FORMAT<trig_source>:TRIG_LEVEL <trig_level><trig_level>:=Numerical value in E-notation with SI unit.

EXAMPLEWhen the vertical scale of Channel 3 is 200 mV, and thetrigger source is Channel 3, the following command sets
the trigger level of Channel 3 to 52.00 mV.
Command message:

C3:TRLV 52mV

194
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

RELATED COMMANDS

TRSE
TRLV2

195
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRIGGER

TRIG_LEVEL2 | TRLV2
Command/QueryDESCRIPTIONThe TRIG_LEVEL2 command sets the lower trigger level
voltage for the specified source.
Higher and lower trigger levels are used with runt /slope
triggers.
The TRIG_LEVEL2? query returns the lower trigger level
voltage for the specified source.

COMMAND SYNTAX<trig_source>:TRIG_LEVEL2 <trig_level><trig_source>:= {C1,C2,C3,C4}<trig_level>:= -4.5*DIV to 4.5*DIV.
Note:You need add the volt unit (V/mV) to the trig_level. If
there is no unit added, it defaults to volts (V).
An out-of-range value will be adjusted to the closest legal
value.

QUERY SYNTAX<trig_source>:TRIG_LEVEL2?

RESPONSE FORMAT<trig_source>:TRIG_LEVEL2 <trig_level><trig_level>:=Numerical value in E-notation with SI unit.

EXAMPLEWhen the trigger type is slope, the following steps set thehigh trigger level of Channel 2 to 3.5 V, and the low trigger
level of Channel 2 to 800 mV.
Step 1: Send the command to set high trigger level.
Command message:

C2:TRLV 3.5V
Step 2: Send the command to set low trigger level.
196
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Command message:

C2:TRLV2 800mVRELATED COMMANDS

TRSE
TRLV

197
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRIGGER

TRIG_MODE | TRMD
Command/QueryDESCRIPTIONThe TRIG_MODE command selects the trigger sweep
mode.
The TRIG_MODE? query returns the current trigger sweep
mode.

COMMAND SYNTAXTRIG_MODE <mode><mode>:= {AUTO,NORM,SINGLE,STOP}AUTO — When AUTO sweep mode is selected, theoscilloscope begins to search for the trigger signal thatmeets the conditions.
If the trigger signal is satisfied, the running state on the top
left corner of the user interface shows Trig'd, and theinterface shows stable waveform.
Otherwise, the running state always shows Auto, and theinterface shows unstable waveform.
NORM — When NORMAL sweep mode is selected, theoscilloscope enters the wait trigger state and begins tosearch for trigger signals that meet the conditions.
If the trigger signal is satisfied, the running state shows
Trig'd, and the interface shows stable waveform.
Otherwise, the running state shows Ready, and theinterface displays the last triggered waveform (previous
trigger) or does not display the waveform (no previous
trigger).
SINGLE — When SINGLE sweep mode is selected, thebacklight of SINGLE key lights up, the oscilloscope enters
the waiting trigger state and begins to search for thetrigger signal that meets the conditions.
If the trigger signal is satisfied, the running state shows
198
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Trig'd, and the interface shows stable waveform. Then, theoscilloscope stops scanning, the RUN/STOP key is red
light, and the running status shows Stop.
Otherwise, the running state shows Ready, and theinterface does not display the waveform.
STOP — STOP is a part of the option of this command,
but not a trigger mode of the oscilloscope.
QUERY SYNTAXTRIG_MODE?

RESPONSE FORMATTRIG_MODE <mode>

EXAMPLEThe following command sets the trigger mode to Normal.
Command message:

TRMD NORMRELATED COMMANDS

ARM
STOP

199
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRIGGER

TRIG_PATTERN | TRPA
Command/QueryDESCRIPTIONThe TRIG_PATTERN command specifies the channel
values to be used in the pattern trigger and sets thecondition of the pattern trigger.
The TRIG_PATTERN? query returns channel values andthe condition of the pattern trigger.

COMMAND SYNTAXTRIG_PATTERN<source>,<status>[,<source>,<status>[,<source>,<status>[,<source>,<status>]]],STATE,<condition>< source >:={C1,C2,C3,C4}<status>:={X,L,H}< condition >:={AND,OR,NAND,OR}X — Ignore this channel. When all channels are set to X,
the oscilloscope will not trigger.
L — Low level.(lower than the threshold level of thechannel)H — High level.(higher than the threshold level of thechannel)Note:
The status of source can only be set when the source ison.

QUERY SYNTAXTRIG_PATTERN?

RESPONSE FORMATTRIG_PATTERN<source>,<status>,<source>,<status>,<source>,<status>,<source>,<status>,STATE,<condition>

EXAMPLEWhen the trigger type is Pattern, and Channel 2 &Channel 3 are on, the following command sets the200
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Channel 2 and Channel 3 to low and the condition to AND.
Command message:

TRPA C2,L,C3,L,STATE,AND

201
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRIGGER

TRIG_SELECT | TRSE
Command/QueryDESCRIPTIONThe TRIG_SELECT command selects the condition thatwill trigger the acquisition of waveforms.
Depending on the trigger type, additional parameters mustbe specified. These additional parameters are grouped inpairs. The first in the pair names the variable to bemodified, while the second gives the new value to be
assigned. Pairs may be given in any order and restricted
to those variables to be changed.
The TRIG_SELECT? query returns the current trigger
condition.
Parameter description
SLEW

Slope

IL

Interval larger

GLIT

Glitch/IS

Interval smaller

Pulse
INTV

Interval

I2

Interval in range

DROP

Dropout

I1

Interval out of range

SR

SourcePL

Pulse larger

TI

Time

PS

Pulse smaller

HT

Hold

P2

Pulse in range

P1

Pulse out of range

type/
Limit
range
HV

Hold
value/
Limit
value

COMMAND SYNTAXTRIG_SELECT(FOR ALL BUT TV)<trig_type>,SR,<source>,HT,<hold_type>,HV,<hold_value
1>[,HV2,<hold_value2>]
202
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide<trig_type>:={EDGE,SLEW,GLIT,INTV,RUNT,DROP}<source>:={C1,C2,C3,C4,LINE,EX,EX5}
Note:LINE/EX/EX5 can only be selected when the trigger typeis Edge.
<hold_type>:={TI,OFF} for EDGE trigger.
<hold_type>:={TI} for DROP trigger.
<hold_type>:={PS,PL,P2,P1}for GLIT/RUNT trigger.
<hold_type>:={IS,IL,I2,I1} for SLEW/INTV trigger.
<hold_value1>:= a time value with unit.
<hold_value2>:= a time value with unit.
Note:If there is no unit (S/mS/uS/nS) added, it defaults to be S.
The range of hold_values varies from trigger types.
[80nS, 1.5S] for Edge trigger, and [2nS, 4.2S] for others.
QUERY SYNTAXTRIG_SELECT?

RESPONSE FORMATTRIG_SELECT<trig_type>,SR,<source>,HT,<hold_type>,HV,<hold_value
1>[,HV2,<hold_value2>]

EXAMPLEWhen you want to set trigger type to Edge, trigger source
to Channel 1, hold type to TIME, and the time value to
1.43uS, the following comes true.
Command message:

TRSE EDGE,SR,C1,HT,TI,HV,1.43uS
When you want to set trigger type to Pulse, trigger source
to Channel 2, limit range to [5nS, 1uS], the following
comes true.
Command message:
203
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRSE GLIT,SR,C2,HT,P2,HV,5nS,HV2,1uS
When you want to set trigger type to Dropout, trigger
source to Channel 4, overtime value to 2.8 ms, thefollowing comes true.
Command message:

TRSE DROP,SR,C4,HT,TI,HV,2.8mS
TV COMMAND SYNTAXTRIG_SELECT<trig_type>,SR,<source>,STAN,<standard>,SYNC,<sync_type>[,LINE,<line>[,FLD,<field>]]
Parameter description
STAN

Standard

FLD

field

CUST

Custom<trig_type>:= {TV}<source>:={C1,C2,C3,C4}<standard>:={NTSC,PAL,720P/50,720P/60,1080P/50,108
0P/60,1080I/50,1080I/60, CUST}<line>:= allow triggering on a specific line of video. Theline number limits vary with the standard and mode, as
shown in the following table.
TV Trigger Line Number Limits
standard

Mode
Line

Field1

Field2

NTSC

1~263

1 to 262

PAL

1 to 313

1 to 312

1080I/50

1 to 563

1 to 562

1080I/60

1 to 563

1 to 562

720P/50

1 to 750

720P/60

1 to 750

1080P/50

1- 1125

1080P/60

1- 1125

204
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

CUST

1 to number of Lines<field>:= [1,2] for NTSC/PAL/1080I/50/1080I/60<field>:=1 to <field_count>for CUST.
<field_count>:=1 to 8 depending on the interlace.
Note:
Field can only be selected when the standard is
NTSC/PAL/1080I/50/1080I/60/CUST.
TV QUERY SYNTAXTRIG_SELECT?

TV RESPONSE FORMATTRIG_SELECT<trig_type>,SR,<source>,STAN,<standard>,SYNC,<sync_type>[,LINE,<line>[,FLD,<field>]]

TV EXAMPLE

When you want to set trigger type to Video, trigger
source to Channel 1, standard to NTSC, and SYNC to
ANY, the following comes true.
Command message:

TRSE TV,SR,C1,STAN,NTSC,SYNC,ANY
When you want to set trigger type to Video, trigger
source to Channel 1, standard to PAL, Line to 300, andField to 2, the following comes true.
Command message:

TRSE
TV,SR,C1,STAN,PAL,SYNC,SELECT,LINE,300,FLD,2
When you want to set trigger type to Video, trigger
source to Channel 2, standard to 1080P/50, and Line to200, the following comes true.
Command message:

TRSE
TV,SR,C2,STAN,1080P/50,SYNC,SELECT,LINE,200

205
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

206
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRIGGER

TRIG_SLOPE | TRSL
Command/QueryDESCRIPTIONThe TRIG_SLOPE command sets the trigger slope of thespecified trigger source.
The TRIG_SLOPE? query returns the trigger slope of theselected source.

COMMAND SYNTAX<trig_source>:TRIG_SLOPE <trig_slope><trig_source>:={C1,C2,C3,C4,EX,EX5}<trig_slope>:={NEG,POS,WINDOW} for edge trigger.
<trig_slope>:={NEG,POS} for other trigger.
NEG — falling edg.
POS — rising edge.
WINDOW — altering edge.

QUERY SYNTAX<trig_source>:TRIG_SLOPE?

RESPONSE FORMAT<trig_source>:TRIG_SLOPE <trig_slope>

EXAMPLEThe following command sets the trigger slope of Channel
2 to negative.
Command message:

C2:TRSL NEG
RELATED COMMANDS

TRSE

207
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRIGGER

TRIG_WINDOW | TRWI
Command/QueryDESCRIPTIONThe TRIG_WINDOW command sets the relative height of
the two trigger line of the trigger window type.
Note:
This command is only valid when the window type isrelative.
The TRIG_WINDOW? query returns relative height of thetwo trigger line of the trigger window type.

COMMAND SYNTAXTRIG_WINDOW <value><value>:= 0 to 9*DIV when the center level is 0.
Note:You need add the volt unit (V/mV) to the value. If there isno unit added, it defaults to be V.
The range of value is related to the center value of thelevel.

QUERY SYNTAXTRIG_WINDOW?

RESPONSE FORMATTRIG_WINDOW <value><value>:= Numerical value in E-notation with SI unit.

EXAMPLEWhen the window type is relative, and the center level is 1
V, the following command sets the relative height of thetwo trigger line to 2 V.
Command message:

TRWI 2V
RELATED COMMANDS

TRLV
TRLV2
208
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER Commands
To set up a serial trigger, set the trigger type to Serial using the command TRSE SERIAL. Then set
the appropriate trigger criteria according to serial trigger type (using TRIIC:CON, etc.)
These commands are used for the following serial bus protocols: I2C, SPI, UART, CAN, and LIN.
TRIIC:SCL

TRIIC:SDA

TRIIC:CON



TRIIC:ADDR

TRIIC:DATA

TRIIC:DAT2



TRIIC:QUAL

TRIIC:RW

TRIIC:ALEN



TRIIC:DLEN

TRSPI:CLK

TRSPI:CLK:EDGETRSPI:CLK:TIM

TRSPI:MOSITRSPI:MISOTRSPI:CSTP

TRSPI:CS

TRSPI:NCSTRSPI:TRTYTRSPI:DATATRSPI:DLEN

TRSPI:BIT

TRUART:RX

TRUART:TX

TRUART:TRTY

TRUART:CON

TRUART:QUAL

TRUART:DATA
209
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideTRUART:BAUD

TRUART:DLEN

TRUART:PAR

TRUART:POL

TRUART:STOP

TRUART:BIT

TRCAN:CANH



TRCAN:CON

TRCAN:ID

TRCAN:IDL

TRCAN:DATATRCAN:DAT2



TRCAN:BAUD

TRLIN:SRC



TRLIN:CON

TRLIN:ID

TRLIN:DATATRLIN:DAT2



TRLIN:BAUD

Availability of Serial Trigger Commands in Each Oscilloscope Series
Model

Valid?

SDS1000CFL

no

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

noSDS1000X

noSDS1000X-E

yes

SDS2000X-E

yes

SDS1000X-U

yes

210
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRIIC:SCL
Command/QueryDESCRIPTIONThe TRIIC:SCL command sets the source and thresholdfor the serial clock (SCL) of IIC trigger.
The TRIIC:SCL? query returns the source and thresholdfor the serial clock (SCL) of IIC trigger.

COMMAND SYNTAXTRIG_IIC:SCL <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the threshold. If
there is no unit added, it defaults to be V.
The range of threshold is related to the vertical scale ofthe source.

QUERY SYNTAXTRIIC:SCL?

RESPONSE FORMATTRIIC:SCL <source>[,<threshold>]<threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is IIC, the following commandsets the source of SCL to channel3 and the threshold to
200 mV.
Command message:

TRIIC:SCL C3,0.2V
RELATED COMMANDSTRIIC:SDA

211
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRIIC:SDA
Command/QueryDESCRIPTIONThe TRIIC:SDA command sets the source and thresholdfor the serial data input channel (SDA) of IIC trigger.
The TRIIC:SDA? query returns the source and thresholdfor the serial data input channel (SDA) of IIC trigger.

COMMAND SYNTAXTRIG_IIC:SDA <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the threshold. If
there is no unit added, it defaults to be V.
The range of threshold is related to the vertical scale ofthe source.

QUERY SYNTAXTRIIC:SDA?

RESPONSE FORMATTRIIC:SDA <source>[,<threshold>]<threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is IIC, the following commandsets the source of SDA to channel3 and the threshold to
200 mV.
Command message:

TRIIC:SDA C3,0.2V
RELATED COMMANDSTRIIC:SCL

212
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRIIC:CON
Command/QueryDESCRIPTIONThe TRIIC:CON command sets the trigger condition of IIC
trigger.
The TRIIC:CON? query returns the trigger condition of IIC
trigger.

COMMAND SYNTAXTRIG_IIC:CON <condition><condition>:={START,STOP,RESTART,NOACK,EEPRO
M,7ADDA,10ADDA,DALENTH}
START— Start condition.
STOP— Stop condition.
RESTART—Another start condition occurs before a stop
condition.
NOACK— Missing acknowledge.
EEPROM— EEPROM frame containing (Start:Control
byte:R:Ack:Data).
7ADDA—

7-bit

address

frame

containing(Start:Address7:R/W:Ack:Data:Data2).
10ADDA—10-bit

address

frame

containing(Start:Address10:R/W:Ack:Data:Data2).
DALENTH— specifie a search based on address lengthand data length.
QUERY SYNTAXTRIIC:CON?

RESPONSE FORMATTRIIC:CON <condition>

EXAMPLEWhen the serial protocol is IIC, the following commandsets the trigger condition to 7 ADD&Data.
Command message:

TRIIC:CON 7ADDA
213
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

RELATED COMMANDSTRIIC:ADDR
TRIIC:DATA
TRIIC:DAT2214
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRIIC:ADDR
Command/QueryDESCRIPTIONThe TRIIC:ADDR command sets the address value used
for the IIC trigger when the trigger condition is set to
7ADDA or 10ADDA.
The TRIIC:ADDR? query returns the address value when
the trigger condition is set to 7ADDA or 10ADDA.

COMMAND SYNTAXTRIIC:ADDR <value><value>:= 0 to 2^n when n is the address length(7 or 10)
Note:
Use the don't care data (128) to ignore the address value
when trigger condition is 7ADDA.
Use the don't care data (1024) to ignore the address
value when trigger condition is 10ADDA.

QUERY SYNTAXTRIIC:ADDR?

RESPONSE FORMATTRIIC:ADDR <value>

EXAMPLEWhen the serial protocol is IIC and the trigger condition is
10ADD&Data, the following command sets the address
value to 0x122.
Command message:

TRIIC:ADDR 290
When the serial protocol is IIC and the trigger condition is
10ADD&Data, the following command ignore the address
value.
Command message:

TRIIC:ADDR 1024

215
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

RELATED COMMANDSTRIIC:CON

216
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRIIC:DATA
Command/QueryDESCRIPTIONThe TRIIC:DATA command sets the data1 value used for
IIC trigger when the trigger condition is set to 7ADDA,
10ADDA or EEPROM.
The TRIIC:DATA? query returns the data1 value used for
IIC trigger when the trigger condition is set to 7ADDA,
10ADDA or EEPROM.

COMMAND SYNTAXTRIIC:DATA <value><value>:= 0 to 256
Note:
Use the don't care data (256) to ignore the data value.

QUERY SYNTAXTRIIC:DATA?

RESPONSE FORMATTRIIC:DATA <value>

EXAMPLEWhen the serial protocol is IIC and the trigger condition is
10ADD&Data, the following command sets the data1
value to 0x29.
Command message:

TRIIC:DATA 41
When the serial protocol is IIC and the trigger condition is
10ADD&Data, the following command ignore the data
value.
Command message:

TRIIC:DATA 256
RELATED COMMANDSTRIIC:CON
TRIIC:DAT2
217
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRIIC:ADDR

218
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRIIC:DAT2
Command/QueryDESCRIPTIONThe TRIIC:DAT2 command sets the data2 value used for
IIC trigger when the trigger condition is set to 7ADDA or
10ADDA.
The TRIIC:DAT2? query returns the data2 value used for
IIC trigger when the trigger condition is set to 7ADDA or
10ADDA.

COMMAND SYNTAXTRIIC:DAT2 <value><value>:= 0 to 256
Note:
Use the don't care data (256) to ignore the data value.

QUERY SYNTAXTRIIC:DAT2?

RESPONSE FORMATTRIIC:DAT2 <value>

EXAMPLEWhen the serial protocol is IIC and the trigger condition is
10ADD&Data, the following command sets the data2
value to 0x29.
Command message:

TRIIC:DAT2 41
When the serial protocol is IIC and the trigger condition is
10ADD&Data, the following command ignore the data2
value.
Command message:

TRIIC:DAT2 256
RELATED COMMANDSTRIIC:CON
TRIIC:DATA
TRIIC:ADDR
219
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRIIC:QUAL
Command/QueryDESCRIPTIONThe TRIIC:QUAL command sets the IIC data qualifier
when the trigger condition is set to EEPROM.
The TRIIC:QUAL? query returns the data qualifier used
for the IIC trigger is set to EEPROM.

COMMAND SYNTAXTRIIC:QUAL <value><value>:= {EQUAL,MORE,LESS}EQUAL— sets the IIC data qualifier to equal.
MORE— sets the IIC data qualifier to greater than.
LESS— sets the IIC data qualifier to less than.

QUERY SYNTAXTRIIC:QUAL?

RESPONSE FORMATTRIIC:QUAL <value>

EXAMPLEWhen the serial protocol is IIC and the trigger condition is
EEPROM, the following command sets the data qualifier
to equal.
Command message:

TRIIC:QUAL EQUAL
RELATED COMMANDSTRIIC:CON
TRIIC:DATA
TRIIC:ADDR

220
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRIIC:RW
Command/QueryDESCRIPTIONThe TRIIC:RW command sets the IIC trigger type to bevalid on a Read, Write, or Either condition. Read or write isindicated by the R/W bit in the IIC protocol.
The TRIIC:RW? query returns the condition on the R/W
bit used for the IIC trigger.

COMMAND SYNTAXTRIIC:RW <value><value>:= {READ,WRITE,DONT_CARE}
READ— sets read as the data direction.
WRITE— sets write as the data direction.
DONT_CARE— sets either as the data direction.

QUERY SYNTAXTRIIC:RW?

RESPONSE FORMATTRIIC:RW <value>

EXAMPLEWhen the serial protocol is IIC and the trigger condition is
10ADD&Data, the following command sets the data
direction to write.
Command message:

TRIIC:RW WRITERELATED COMMANDSTRIIC:CON
TRIIC:ADDR

221
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRIIC:ALEN
Command/QueryDESCRIPTIONThe TRIIC:ALEN command sets the IIC address typewhen the trigger condition is set to Data Length.
The TRIIC:ALEN? query returns

the IIC address typewhen the trigger condition is set to Data Length.
COMMAND SYNTAXTRIIC:ALEN <value><value>:= {7BIT,10BIT}QUERY SYNTAXTRIIC:ALEN?

RESPONSE FORMATTRIIC:ALEN <value>

EXAMPLEWhen the serial protocol is IIC and the trigger condition is
Data Length, the following command sets the address
type to 7 bit.
Command message:

TRIIC:ALEN 7BIT
RELATED COMMANDSTRIIC:CON
TRIIC:ADDR

222
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRIIC:DLEN
Command/QueryDESCRIPTIONThe TRIIC:DLEN command sets the length of the data inbytes to be used for IIC trigger if the trigger condition is
Data length.
The TRIIC:DLEN? query returns the length of the data inbytes.

COMMAND SYNTAXTRIIC:DLEN <value><value>:= 1 to 12

QUERY SYNTAXTRIIC:DLEN?

RESPONSE FORMATTRIIC:DLEN <value>

EXAMPLEWhen the serial protocol is IIC and the trigger condition is
Data Length, the following command sets the length of thedata bytes to 8.
Command message:

TRIIC:DLEN 8
RELATED COMMANDSTRIIC:CON
TRIIC:ADDR

223
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:CLK
Command/QueryDESCRIPTIONThe TRSPI:CLK command sets the source and thresholdfor the serial clock of SPI trigger.
The TRSPI:CLK? query returns the source and thresholdfor the serial clock of SPI trigger.

COMMAND SYNTAXTRSPI:CLK <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the threshold. If
there is no unit added, it defaults to be V.
The range of threshold is related to the vertical scale ofthe source.

QUERY SYNTAXTRSPI:CLK?

RESPONSE FORMATTRSPI:CLK <source>[,<threshold>]<threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is SPI, the following commandsets the source of CLK to channel3 and the threshold to
200 mV.
Command message:

TRSPI:CLK C3,0.2V
RELATED COMMANDSTRSPI:MISOTRSPI:MOSI
224
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:CLK:EDGE
Command/QueryDESCRIPTIONThe TRSPI:CLK:EDGE command selects the edge of theclock that data latched on.
The TRSPI:CLK:EDGE? query returns the edge of theclock that data latched on.

COMMAND SYNTAXTRSPI:CLK:EDGE <edge><edge>:= {RISING,FALLING}QUERY SYNTAXTRSPI:CLK:EDGE?

RESPONSE FORMATTRSPI:CLK:EDGE <edge>

EXAMPLEWhen the serial protocol is SPI, the following commandsets the edge of the clock to rising.
Command message:

TRSPI:CLK:EDGE RISINGRELATED COMMANDSTRSPI:CLK

225
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:CLK:TIM
Command/QueryDESCRIPTIONThe TRSPI:CLK:TIM command sets the timeout value forthe clock of SPI trigger when the CS type is set to CLK
Timeout.
The TRSPI:CLK:TIM? query returns the timeout value forthe clock of SPI trigger when the CS type is set to CLK
Timeout.

COMMAND SYNTAXTRSPI:CLK:TIM <value><value>:= value with unit, 100ns to 5ms
Note:
If there is no unit (s/ms/us/ns) added, it defaults to be S.

QUERY SYNTAXTRSPI:CLK:TIM?

RESPONSE FORMATTRSPI:CLK:TIM <value><threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is SPI and the CS type is CLK
Timeout, the following command sets the timeout value forthe clock to 2us.
Command message:

TRSPI:CLK:TIM 2us
RELATED COMMANDSTRSPI:CSTP

226
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:MOSI
Command/QueryDESCRIPTIONThe TRSPI:MOSI command sets the source and thresholdfor MOSI of SPI trigger.
The TRSPI:MOSI? query returns the source and thresholdfor MOSI of SPI trigger.

COMMAND SYNTAXTRSPI:MOSI <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the threshold. If
there is no unit added, it defaults to be V.
The range of threshold is related to the vertical scale ofthe source.

QUERY SYNTAXTRSPI:MOSI?

RESPONSE FORMATTRSPI:MOSI <source>[,<threshold>]<threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is SPI, the following commandsets the source of MOSI to channel3 and the threshold to
200 mV.
Command message:

TRSPI:MOSI C3,0.2V
RELATED COMMANDSTRSPI:MISO

227
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:MISO
Command/QueryDESCRIPTIONThe TRSPI:MISO command sets the source and thresholdfor MISO of SPI trigger.
The TRSPI:MISO? query returns the source and thresholdfor MISO of SPI trigger.

COMMAND SYNTAXTRSPI:MISO <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the threshold. If
there is no unit added, it defaults to be V.
The range of threshold is related to the vertical scale ofthe source.

QUERY SYNTAXTRSPI:MISO?

RESPONSE FORMATTRSPI:MISO <source>[,<threshold>]<threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is SPI, the following commandsets the source of MISO to channel3 and the threshold to
200 mV.
Command message:

TRSPI:MISO C3,0.2V
RELATED COMMANDSTRSPI:MOSI

228
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:CSTP
Command /QueryDESCRIPTIONThe TRSPI:CSTP command sets the serial chip selection
type of SPI trigger.
The TRSPI:CSTP? query returns the serial chip selection
type of SPI trigger.

COMMAND SYNTAXTRSPI:CSTP <type><type>:= {CS,NCS,TIMEOUT}QUERY SYNTAXTRSPI:CSTP?

RESPONSE FORMATTRSPI:CSTP <type>

EXAMPLEWhen the serial protocol is SPI, the following commandsets the CS type to CS.
Command message:

TRSPI:CSTP CS
RELATED COMMANDSTRSPI:CSTRSPI:NCS
TRSPI:CLK:TIM

229
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:CS
Command/QueryDESCRIPTIONThe TRSPI:CS command sets the source and thresholdfor CS signal of SPI trigger when the CS type is CS.
The TRSPI:CS? query returns the source and thresholdfor CS signal of SPI trigger when the CS type is CS.

COMMAND SYNTAXTRSPI:CS <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the threshold. If
there is no unit added, it defaults to be V.
The range of threshold is related to the vertical scale ofthe source.

QUERY SYNTAXTRSPI:CS?

RESPONSE FORMATTRSPI:CS <source>[,<threshold>]<threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is SPI and the CS type is CS, thefollowing command sets the source of CS to channel3 andthe threshold to 200 mV.
Command message:

TRSPI:CS C3,0.2V
RELATED COMMANDSTRSPI:CSTP

230
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:NCS
Command/QueryDESCRIPTIONThe TRSPI:NCS command sets the source and thresholdfor ~CS signal of SPI trigger when the CS type is ~CS.
The TRSPI:NCS? query returns the source and thresholdfor ~CS signal of SPI trigger when the CS type is ~CS.

COMMAND SYNTAXTRSPI:NCS <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the threshold. If
there is no unit added, it defaults to be V.
The range of threshold is related to the vertical scale ofthe source.

QUERY SYNTAXTRSPI:NCS?

RESPONSE FORMATTRSPI:NCS <source>[,<threshold>]<threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is SPI and the CS type is ~CS,
the following command sets the source of ~CS tochannel3 and the threshold to 200 mV.
Command message:

TRSPI:NCS C3,0.2V
RELATED COMMANDSTRSPI:CSTP

231
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:TRTY
Command/QueryDESCRIPTIONThe TRSPI:TRTY command sets the trigger source for
SPI trigger.
The TRSPI:TRTY? query returns the trigger source for SPI
trigger.

COMMAND SYNTAXTRSPI:TRTY <source><source>:= {MOSI,MISO}QUERY SYNTAXTRSPI:TRTY?

RESPONSE FORMATTRSPI:TRTY <source>

EXAMPLEWhen the serial protocol is SPI, the following commandsets the trigger source to MOSI.
Command message:

TRSPI:TRTY MOSI

232
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:DATA
Command

DESCRIPTIONThe TRSPI:DATA command sets the data value of every
bit used for SPI trigger.

COMMAND SYNTAXTRSPI:DATA <value1>[,<value2>[,..[,<value>]]]<value>:= {0,1,X}

EXAMPLEWhen the serial protocol is SPI and the data length is 4,
the following command sets data value to 1011.
Command message:

TRSPI:DATA 1,0,1,1
When the serial protocol is SPI and the data length is 4,
the following command ignore the data value.
Command message:

TRSPI:DATA X,X,X,X
RELATED COMMANDSTRSPI:DLEN

233
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:DLEN
Command/QueryDESCRIPTIONThe TRSPI:DLEN command sets the length of data for
SPI trigger.
The TRSPI:DLEN? query returns the length of data for SPI
trigger.

COMMAND SYNTAXTRSPI:DLEN <value><value>:= 4 to 96

QUERY SYNTAXTRSPI:DLEN?

RESPONSE FORMATTRSPI:DLEN <value>

EXAMPLEWhen the serial protocol is SPI, the following commandsets the trigger data length to 8.
Command message:

TRSPI:DLEN 8
RELATED COMMANDSTRSPI:DATA

234
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRSPI:BIT
Command/QueryDESCRIPTIONThe TRSPI:BIT command sets the bit order for SPI trigger.
The TRSPI:BIT? query returns the bit order for SPI trigger.

COMMAND SYNTAXTRSPI:BIT <order><order>:= {MSB,LSB}QUERY SYNTAXTRSPI:BIT?

RESPONSE FORMATTRSPI:BIT <order>

EXAMPLEWhen the serial protocol is SPI, the following commandsets the bit order to MSB.
Command message:

TRSPI:BIT MSB

235
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:RX
Command/QueryDESCRIPTIONThe TRUART:RX command sets the source and thresholdfor RX of UART trigger.
The TRUART:RX? query returns the source and thresholdfor RX of UART trigger.

COMMAND SYNTAXTRUART:RX <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the threshold. If
there is no unit added, it defaults to be V.
The range of threshold is related to the vertical scale ofthe source.

QUERY SYNTAXTRUART:RX?

RESPONSE FORMATTRUART:RX <source>[,<threshold>]<threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is UART, the following commandsets the source of RX to channel3 and the threshold to
200 mV.
Command message:

TRUART:RX C3,0.2V
RELATED COMMANDSTRUART:TX

236
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:TX
Command/QueryDESCRIPTIONThe TRUART:TX command sets the source and thresholdfor TX of UART trigger.
The TRUART:TX? query returns the source and thresholdfor TX of UART trigger.

COMMAND SYNTAXTRIG_UART:TX <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the threshold. If
there is no unit added, it defaults to be V.
The range of threshold is related to the vertical scale ofthe source.

QUERY SYNTAXTRUART:TX?

RESPONSE FORMATTRUART:TX <source>[,<threshold>]<threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is UART, the following commandsets the source of TX to channel3 and the threshold to 200
mV.
Command message:

TRUART:TX C3,0.2V
RELATED COMMANDSTRUART:RX

237
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:TRTY
Command/QueryDESCRIPTIONThe TRUART:TRTY command sets the trigger source for
UART trigger.
The TRUART:TRTY? query returns the trigger source for
UART trigger.

COMMAND SYNTAXTRUART:TRTY <source><source>:= {RX,TX}QUERY SYNTAXTRUART:TRTY?

RESPONSE FORMATTRUART:TRTY <source>

EXAMPLEWhen the serial protocol is UART, the following commandsets the trigger source to TX.
Command message:

TRUART:TRTY TX
RELATED COMMANDSTRUART:RX
TRUART:TX
TRSPI:DLEN

238
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:CON
Command/QueryDESCRIPTIONThe TRUART:CON command sets the trigger condition of
UART trigger.
The TRUART:CON? query returns the trigger condition of
UART trigger.

COMMAND SYNTAXTRUART:CON <condition><condition>:= {START,STOP,DATA,ERROR}START— Start condition.
STOP— Stop condition.
DATA— Specify a search based on data.
ERROR— Error condition.

QUERY SYNTAXTRUART:CON?

RESPONSE FORMATTRUART:CON <condition>

EXAMPLEWhen the serial protocol is UART, the following commandsets the trigger condition to START.
Command message:

TRUART:CON START

239
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:QUAL
Command/QueryDESCRIPTIONThe TRUART:QUAL command sets the UART data
qualifier when the trigger condition is set to DATA.
The TRUART:QUAL? query returns the UART data
qualifier when the trigger condition is set to DATA.

COMMAND SYNTAXTRUART:QUAL <condition><condition>:= {EQUAL,MORE,LESS }EQUAL— sets the UART data qualifier to equal.
MORE— sets the UART data qualifier to greater than.
LESS— sets the UART data qualifier to less than.

QUERY SYNTAXTRUART:QUAL?

RESPONSE FORMATTRUART:QUAL <condition>

EXAMPLEWhen the serial protocol is UART and the trigger condition
is DATA, the following command sets the data qualifier to
EQUAL.
Command message:

TRUART:QUAL EQUAL
RELATED COMMANDSTRUART:CON

240
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:DATA
Command/QueryDESCRIPTIONThe TRUART:DATA command sets the data value used
for UART trigger when the trigger condition is set to DATA.
The TRUART:DATA? query returns the data1 value used
for UART trigger when the trigger condition is set to DATA.

COMMAND SYNTAXTRUART:DATA <value><value>:= 0 to 256
Note:
Use the don't care data (256) to ignore the data value.

QUERY SYNTAXTRUART:DATA?

RESPONSE FORMATTRUART:DATA <value>

EXAMPLEWhen the serial protocol is UART and the trigger
condition is DATA, the following command sets the data
value to 0x29.
Command message:

TRUART:DATA 41
When the serial protocol is UART and the trigger
condition is DATA the following command ignore the data
value.
Command message:

TRUART:DATA 256
RELATED COMMANDSTRUART:CON

241
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:BAUD
Command/QueryDESCRIPTIONThe TRUART:BAUD command sets the baud rate value
used for UART trigger.
The TRUART:BAUD? query returns the baud rate value
used for UART trigger.

COMMAND SYNTAXTRUART:BAUD <value1>[,<value2>]<value1>:={600,1200,2400,4800,9600,19200,38400,5760
0,115200,CUSTOM}<value2>:= 300 to 5000000 When the value1 is CUSTOM.

QUERY SYNTAXTRUART:BAUD?

RESPONSE FORMATTRUART:BAUD <value>[,<value2>]

EXAMPLEWhen the serial protocol is UART the following commandsets the baud rate value to 9600 bit/s.
Command message:

TRUART:BAUD 9600
When the serial protocol is UART the following commandsets the baud rate value to 2000 bit/s.
Command message:

TRUART:BAUD CUSTOM,2000

242
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:DLEN
Command/QueryDESCRIPTIONThe TRUART:DLEN command sets the data length value
used for UART trigger.
The TRUART:DLEN? query returns the data length value
used for UART trigger.

COMMAND SYNTAXTRUART:DLEN <value><value>:= 5 to 8

QUERY SYNTAXTRUART:DLEN?

RESPONSE FORMATTRUART:DLEN <value>

EXAMPLEWhen the serial protocol is UART, the following commandsets data length value to 6.
Command message:

TRUART:DLEN 6

243
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:PAR
Command/QueryDESCRIPTIONThe TRUART:PAR command sets the parity check used
for UART trigger.
The TRUART:PAR? query returns the parity check used
for UART trigger.

COMMAND SYNTAXTRUART:PAR <value><value>:= {NONE,ODD,EVEN}QUERY SYNTAXTRUART:PAR?

RESPONSE FORMATTRUART:PAR <value>

EXAMPLEWhen the serial protocol is UART, the following commandsets parity check to odd.
Command message:

TRUART:PAR ODD

244
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:POL
Command/QueryDESCRIPTIONThe TRUART:POL command sets the idle level used for
UART trigger.
The TRUART:POL? query returns the idle level used for
UART trigger.

COMMAND SYNTAXTRUART:POL <value><value>:= {LOW,HIGH}QUERY SYNTAXTRUART:POL?

RESPONSE FORMATTRUART:POL <value>

EXAMPLEWhen the serial protocol is UART, the following commandsets idle level to low.
Command message:

TRUART:POL LOW

245
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:STOP
Command/QueryDESCRIPTIONThe TRUART:STOP command sets the length of stop bit
for UART trigger.
The TRUART:STOP? query returns the length of stop bit
for UART trigger.

COMMAND SYNTAXTRUART:STOP <value><value>:= {1,1.5,2}

QUERY SYNTAXTRUART:STOP?

RESPONSE FORMATTRUART:STOP <value>

EXAMPLEWhen the serial protocol is UART, the following commandsets the length of stop bit to 1.
Command message:

TRUART:STOP 1

246
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRUART:BIT
Command/QueryDESCRIPTIONThe TRUART:BIT command sets the bit order for UART
trigger.
The TRUART:BIT? query returns the bit order for UART
trigger.

COMMAND SYNTAXTRIG_UART:BIT <value><value>:= {LSB,MSB}QUERY SYNTAXTRUART:BIT?

RESPONSE FORMATTRUART:BIT <value>

EXAMPLEWhen the serial protocol is UART, the following commandsets the bit order to MSB.
Command message:

TRUART:BIT MSB

247
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRCAN:CANH
Command/QueryDESCRIPTIONThe TRCAN:CANH command sets the source andthreshold for source of CAN trigger.
The TRCAN:CANH? query returns the source andthreshold CANH of CAN trigger.

COMMAND SYNTAXTRCAN:CANH <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the threshold. If
there is no unit added, it defaults to be V.
The range of threshold is related to the vertical scale ofthe source.

QUERY SYNTAXTRCAN:CANH?

RESPONSE FORMATTRCAN:CANH <source>[,<threshold>]

EXAMPLEWhen the serial protocol is CAN, the following commandsets the source to channel3 and the threshold to 200 mV.
Command message:

TRCAN:CANH C3,0.2V

248
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRCAN:CON
Command/QueryDESCRIPTIONThe TRCAN:CON command sets the trigger condition of
CAN trigger.
The TRCAN:CON? query returns the trigger condition of
CAN trigger.

COMMAND SYNTAXTRCAN:CON <condition><condition>:={START,REMOTE,ID,ID_AND_DATA,ERROR}START— Start condition.
REMOTE— Remote frameID— Specifies a search based on ID bits and ID.
ID_AND_DATA— Specify a search based on ID bits, ID
and data.
ERROR— Error frame.

QUERY SYNTAXTRCAN:CON?

RESPONSE FORMATTRCAN:CON <condition>

EXAMPLEWhen the serial protocol is CAN, the following commandsets the trigger condition to START.
Command message:

TRCAN:CON START
RELATED COMMANDSTRCAN:ID
TRCAN:DATATRCAN:DAT2

249
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRCAN:ID
Command/QueryDESCRIPTIONThe TRCAN:ID command sets the ID value for CAN
trigger when the trigger condition is set to ID or
ID_AND_DATA.
The TRCAN:ID? query returns

the ID value for CAN

trigger when the trigger condition is set to ID or
ID_AND_DATA.
COMMAND SYNTAXTRCAN:ID <value><value>:= 0 to 2^n when n is the ID bits (11 or 29)
Note:
Use the don't care data (2048) to ignore the address
value when trigger condition is ID or ID_AND_DATA, andthe ID length is 11.
Use the don't care data (536870912) to ignore theaddress

value

when

trigger

condition

is

ID

or

ID_AND_DATA, and the ID length is 29.
QUERY SYNTAXTRCAN:ID?

RESPONSE FORMATTRCAN:ID <value>

EXAMPLEWhen the serial protocol is CAN and the trigger condition
is ID, the following command sets the ID value to 0x29.
Command message:

TRCAN:ID 41
When the serial protocol is CAN, the trigger condition isID, and the address length is 11, the following command
ignore the ID value.
Command message:
250
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRCAN:ID 2048
RELATED COMMANDSTRCAN:CON
TRCAN:IDL

251
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRCAN:IDL
Command/QueryDESCRIPTIONThe TRCAN:IDL command sets the ID length for CAN
trigger when the trigger condition is set to ID or
ID_AND_DATA.
The TRCAN:IDL? query returns the ID length for CAN
trigger when the trigger condition is set to ID or
ID_AND_DATA.

COMMAND SYNTAXTRCAN:IDL <value><value>:= {11BITS,29BITS}QUERY SYNTAXTRCAN:IDL?

RESPONSE FORMATTRCAN:IDL <value>

EXAMPLEWhen the serial protocol is CAN and the trigger condition
is ID, the following command sets the ID length value to11bits.
Command message:

TRCAN:IDL 11BITS
RELATED COMMANDSTRCAN:CON

252
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRCAN:DATA
Command/QueryDESCRIPTIONThe TRCAN:DATA command sets the data1 value used
for CAN trigger when the trigger condition is set to
ID_AND_DATA.
The TRCAN:DATA? query returns

the data1 value for

CAN trigger when the trigger condition is set to
ID_AND_DATA.
COMMAND SYNTAXTRCAN:DATA <value><value>:= 0 to 256
Note:
Use the don't care data (256) to ignore the data value.

QUERY SYNTAXTRCAN:DATA?

RESPONSE FORMATTRCAN:DATA <value>

EXAMPLEWhen the serial protocol is CAN and the trigger condition
is ID_AND_DATA, the following command sets the data1
value to 0x29.
Command message:

TRCAN:DATA 41
When the serial protocol is CAN and the trigger condition
is ID_AND_DATA, the following command ignore thedata1 value.
Command message:

TRCAN:DATA 256
RELATED COMMANDSTRCAN:CON
TRCAN:DAT2253
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRCAN:DAT2
Command/QueryDESCRIPTIONThe TRCAN:DAT2 command sets the data2 value used
for CAN trigger when the trigger condition is set to
ID_AND_DATA.
The TRCAN:DAT2? query returns the data2 value used
for CAN trigger when the trigger condition is set to
ID_AND_DATA.

COMMAND SYNTAXTRCAN:DAT2 <value><value>:= 0 to 256
Note:
Use the don't care data (256) to ignore the data value.

QUERY SYNTAXTRCAN:DAT2?

RESPONSE FORMATTRCAN:DAT2 <value>

EXAMPLEWhen the serial protocol is CAN and the trigger condition
is ID_AND_DATA, the following command sets the data1
value to 0x29.
Command message:

TRCAN:DAT2 41
When the serial protocol is CAN and the trigger condition
is ID_AND_DATA, the following command ignore thedata2 value.
Command message:

TRCAN:DAT2 256
RELATED COMMANDSTRCAN:CON
TRCAN:DATA

254
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRCAN:BAUD
Command/QueryDESCRIPTIONThe TRCAN:BAUD command sets the baud rate for CAN
trigger.
The TRCAN:BAUD? query returns the baud rate for CAN
trigger.

COMMAND SYNTAXTRCAN:BAUD <value1>[,<value2>]<value1>:={5k,10k,20k,59k,100k,125k,250,500k,800k,1M,
CUSTOM}<value2>:= 5000 to 1000000 When the value1 is
CUSTOM.

QUERY SYNTAXTRCAN:BAUD?

RESPONSE FORMATTRCAN:BAUD <value1>[,<value2>]

EXAMPLEWhen the serial protocol is CAN the following commandsets the baud rate to 5 kbit/s.
Command message:

TRCAN:BAUD 5k
When the serial protocol is CAN the following commandsets the baud rate to 100000 bit/s.
Command message:

TRCAN:BAUD CUSTOM,100000

255
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRLIN:SRC
Command/QueryDESCRIPTIONThe TRLIN:SRC command sets the source and thresholdfor the source of LIN trigger.
The TRLIN:SRC? query returns the source and thresholdfor the source of LIN trigger.

COMMAND SYNTAXTRLIN:SRC <source>[,<threshold>]<source>:={C1,C2,C3,C4,D0,D1,D2,D3,D4,D5,D6,D7,D8,
D9,D10,D11,D12,D13,D14,D15}<threshold>:= value with unit. It is necessary to set when
the source is analog channel.
Note:
You need add the volt unit (V/mV) to the value. If there isno unit added, it defaults to be V.
The range of value is related to the vertical scale of thesource.

QUERY SYNTAXTRLIN:SRC?

RESPONSE FORMATTRLIN:SRC <source>[,<threshold>]<threshold>:= numerical value in E-notation with SI unit.

EXAMPLEWhen the serial protocol is LIN, the following commandsets the source to channel3 and the threshold to 200 mV.
Command message:

TRLIN:SRC C3,0.2V

256
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRLIN:CON
Command/QueryDESCRIPTIONThe TRLIN:CON command sets the trigger condition of
LIN trigger.
The TRLIN:CON? query returns the trigger condition of
LIN trigger.

COMMAND SYNTAXTRIG_LIN:CON <condition><condition>:= {BREAK,ID,ID_AND_DATA,DATA_ERROR}
BREAK— Break condition.
ID— Specify a search based on ID.
ID_AND_DATA—Specify a search based on ID and data.
DATA_ERROR— Error frame.

QUERY SYNTAXTRLIN:CON?

RESPONSE FORMATTRLIN:CON <condition>

EXAMPLEWhen the serial protocol is LIN, the following commandsets the trigger condition to break.
Command message:

TRLIN:CON BREAKRELATED COMMANDSTRLIN:ID
TRLIN:DATA
TRLIN:DAT2

257
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRLIN:ID
Command/QueryDESCRIPTIONThe TRLIN:ID command sets the ID value for LIN trigger
when the trigger condition is set to ID or ID_AND_DATA.
The TRLIN:ID? query returns the ID value for LIN trigger
when the trigger condition is set to ID or ID_AND_DATA.

COMMAND SYNTAXTRLIN:ID <value>

QUERY SYNTAXTRLIN:ID?

RESPONSE FORMATTRLIN:ID <value><value>:= 0 to 64.
Note:
Use the don't care data (64) to ignore the ID value.

EXAMPLEWhen the serial protocol is LIN and the trigger condition
is ID, the following command sets the data1 value to 0x29.
Command message:

TRLIN:ID 41
When the serial protocol is LIN and the trigger condition
is ID, the following command ignores the ID value.
Command message:

TRLIN:ID 64
RELATED COMMANDSTRLIN:CON

258
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRLIN:DATA
Command/QueryDESCRIPTIONThe TRLIN:DATA command sets the data1 value used for
LIN

trigger when

the trigger conditionis set to

ID_AND_DATA.
The TRLIN:DATA? query returns the data1 value used for
LIN

trigger when

the trigger conditionis set to

ID_AND_DATA.
COMMAND SYNTAXTRIG_LIN:DATA <value><value>:= 0 to 256
Note:
Use the don't care data (256) to ignore the data value.

QUERY SYNTAXTRLIN:DATA?

RESPONSE FORMATTRLIN:DATA <value>

EXAMPLEWhen the serial protocol is LIN and the trigger condition
is ID_AND_DATA, the following command sets the data1
value to 0x29.
Command message:

TRLIN:DATA 41
When the serial protocol is LIN and the trigger condition
is ID_AND_DATA, the following command ignores thedata1 value.
Command message:

TRLIN:DATA 256
RELATED COMMANDSTRLIN:CON
TRLIN:DAT2

259
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRLIN:DAT2
Command/QueryDESCRIPTIONThe TRLIN:DAT2 command sets the data2 value used for
LIN

trigger when

the trigger conditionis set to

ID_AND_DATA.
The TRLIN:DAT2? query returns the data2 value used for
LIN

trigger when

the trigger conditionis set to

ID_AND_DATA.
COMMAND SYNTAXTRLIN:DAT2 <value><value>:= 0 to 256.
Note:
Use the don't care data (256) to ignore the data value.

QUERY SYNTAXTRLIN:DAT2?

RESPONSE FORMATTRLIN:DAT2 <value>

EXAMPLEWhen the serial protocol is LIN and the trigger condition
is ID_AND_DATA, the following command sets the data2
value to 0x29.
Command message:

TRLIN:DAT2 41
When the serial protocol is LIN and the trigger condition
is ID_AND_DATA, the following command ignore thedata2 value.
Command message:

TRLIN:DAT2 256
RELATED COMMANDSTRLIN:CON
TRLIN:DATA

260
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SERIAL TRIGGER

TRLIN:BAUD
Command/QueryDESCRIPTIONThe TRLIN:BAUD command sets the baud rate for LIN
trigger.
The TRLIN:BAUD? query returns the baud rate value for
LIN trigger.

COMMAND SYNTAXTRLIN:BAUD <value1>[,<value2>]<value1>:= {600,1200,2400,4800,9600,19200,CUSTOM}<value2>:= 300 to 20000 When the value1 is CUSTOM.

QUERY SYNTAXTRCAN:BAUD?

RESPONSE FORMATTRLIN:BAUD <value1>[,<value2>]

EXAMPLEWhen the serial protocol is LIN, the following commandsets the baud rate value to 9600 bit/s.
Command message:

TRLIN:BAUD 9600
When the serial protocol is LIN, the following commandsets the baud rate value to 500 bit/s.
Command message:

TRLIN:BAUD CUSTOM,500

261
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WAVEFORM Commands
The WAVEFORM subsystem is used to transfer data to a controller from the oscilloscope waveform
memory.
The waveform record is actually contained in two portions: the preamble and waveform data. The
waveform record must be read from the oscilloscope by the controller using two separate commands.
The waveform data is the actual data acquired for each point in the specified source. The preamble
contains the information for interpreting the waveform data.


WF?



WFSU

262
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WAVEFORM

WAVEFORM? | WF?
Query

DESCRIPTION

The WAVEFORM? query transfers a waveform from theoscilloscope to the controller.
Note:
The format of the waveform data depends on the current
settings specified by the last WFSU command.
When using the visa library, you should pay attention to
the following settings:


Set the I/O buffer size
The read buffer size depends on the number ofwaveform points. When it needs to read in segments,
the size of each segment is vary from the models.



Set the timeout value
The timeout value is related to the network speed orUSBtransmission

speed.

Pleaseevaluatebyyourself. The initial value is generally 2s.
QUERY SYNTAX<trace>:WAVEFORM? <section><trace>:={C1,C2,C3,C4,MATH,D0,D1,D2,D3,D4,D5,D6,D
7,D8,D9,D10,D11,D12,D13,D14,D15}
C[X] — Analog channel.
D[X] — Digital channel. Only valid for SDS1000X-E andSDS2000X-E series.
MATH — Valid except for the FFT waveform and only
valid for SDS1000X-E series.
<section>:={DAT2}
DAT2 — Return the main data include the head, thewave data and the ending flag. The length of data iscurrent memory depth.

RESPONSE FORMAT<trace>:WAVEFORM <data block>
263
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

RELATED COMMANDSWFSU

EXAMPLEFor SDS1000X-E series, the following steps show how to
use the command to reconstitute the display of waveform.
For analog channel waveform:

Step 1: Send the query to get the data of waveform.
Query message:

C1:WF? DAT2
Response message:
The head of message: C1:WF DAT2. These are followed by the string #9000000070, the beginning ofa binary block in which nine ASCII integers are used to give the length of the block (70 bytes). Afterthe length of block, is beginning of the wave data. “0A 0A” means the end of data.

264
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Step 2: Calculate the voltage value corresponding to the data point.
Using the formula: voltage value (V) = code value *(vdiv /25) - voffset.
code value: The decimal of wave data.
(Note: If the decimal is greater than “127”, it should minus 256.Then the value is code value. Such as
the wave data is “FC” convert to decimal is “252”. So the code value is 252-256 = -4.)
vdiv: The Volts/div value.
voffset: The voltage position value.
The picture above as an example:
Send command C1:VDIV?
Return C1:VDIV 5.00E-01V.
Get the current Volts/div values: vdiv = 0.5V.
Send command C1:OFST?
Return C1:OFST -5.00E-01V.
Get the current voltage position values: voffset = -0.5V.
According to the wave data, we can know the first point of waveform is the 23th data “02”, convert todecimal is “2” (Hexadecimal converted to decimal).
The first point of wave data voltage value = 2*(0.5/25)-(-0.5) = 0.54V.
Step 3: Calculate the time value of the data point.
Using the formula: time value(S) = -(timebase*grid/2).
timebase: The timebase value.
grid: The grid numbers in horizontal direction.
The picture above as an example:
Send command TDIV?
Return TDIV 5.00E-09S.
Get the current timebase: timebase = 5.00E-09S.
Send command SARA?
Return SARA 1.00E+09Sa/s.
Get the current sampling rate: sampling rate= 1.00GSa/s.
265
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

The time interval: time inter = 1/ sampling rate = 1ns.
The time value of the first data point: time value = - (5.00E-09*14/2) = -35.00E-09(s) = -35(ns).
The time value of the second data point: value = -35ns+1ns = -34ns.
The following are two ways of waveform reconstruction:
Use Excel to reconstruct the waveform:Use python to reconstruct the waveform: (See the code in Read Waveform Data (WF) Example)

Note: If you want the command return the “numerical” data type only (i.e. return as “1.00E+09” whensend the command “SARA?”), send the command “CHDR OFF” at the first. See CHDR for details.

266
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

For digital channel waveform:

Step 1: Send the query to get the data of waveform.
267
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Query message:

D0:WF? DAT2
Response message:
The head of message: D0:WF DAT2. These are followed by the string #9000000700, the beginningof a binary block in which nine ASCII integers are used to give the length of the data (700 points). For
digital, one bit represents a data point, so there are 88 bytes. After the length of block, is beginning of
the wave data. “0A 0A” means the end of data.

Step 2: Covert to the high (1) and low (0) corresponding to the data point.
According to the wave data, we can know the first eight points of waveform is the 22th byte “00”,convert to binary is “00000000” (Hexadecimal converted to binary (LSB)).
Step 3: Calculate the time value of the data point.
Using the formula: time value(S) = - (timebase*grid/2).
timebase: The timebase value.
grid: The grid numbers in horizontal direction.
The picture above as an example:
Send command TDIV?
Return TDIV 5.00E-08S.
Get the current timebase: timebase = 5.00E-08s.
Send command DI:SARA?
Return DI:SARA 1.00E+09Sa/s.
Get the current sampling rate: sampling rate= 1GSa/s.
The time interval: time inter = 1/ sampling rate = 1ns.
The time value of the first data point: time value = - (5.00E-08*14/2) = -3.50E-07(s) = -350(ns).
The time value of the second data point: value = -350ns+1ns = -349ns.
268
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Use python to reconstruct the waveform: (See the code in Read Waveform Data of Digital Example)

For math (except for FFT) waveform:

269
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Step 1: Send the query to get the data of waveform.
Query message:

MATH:WF? DAT2
Response message:
The head of message: MATH:WF DAT2. These are followed by the string #9000001400, thebeginning of a binary block in which nine ASCII integers are used to give the length of the block (1400
bytes). The point number is 1400 with interpolation. After the length of block, is beginning of the wave
data. “0A 0A” means the end of data.

Step 2: Calculate the voltage value corresponding to the data point.
Using the formula: voltage value (V) = code value *(vdiv /25) - voffset
code value: The decimal of wave data.
(Note: If the decimal is greater than “127”, it should minus 256.Then the value is code value. Such as
the wave data is “FC” convert to decimal is “252”. So the code value is 252-256 = -4.)
vdiv: The Volts/div value of math.
voffset: The voltage position value.
The picture above as an example:
Send command MTVD?
Return MTVD 5.00E+00V.
Get the current Volts/div value: vdiv = 5V.
Send command MTVP?
Return MTVP 100.
Get the current position value: voffset = mtvp/50*vdiv=100/50*5=10V.
According to the wave data, we can know the first point of waveform is the 25th data “17”, convert todecimal is “23” (Hexadecimal converted to decimal).
The first point of wave data voltage value = 23*(5/25)-10 = -5.4V.
270
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Step 3: Calculate the time value of the data point.
Using the formula: time value(S) = - (timebase*grid/2).
timebase: The timebase value.
grid: The grid numbers in horizontal direction.
The picture above as an example:
Send command TDIV?
Return TDIV 2.00E-08S.
Get the current timebase: timebase = 20E-09s.
Send command SARA?
Return SARA 1.00E+09Sa/s.
Get the current sampling rate: sampling rate= 1GSa/s.
Send command SANU? C1Return SANU 2.80E+02pts.
Get the number of sampling points: point number = 280pts.
The interpolation multiplier: interpolation multiplier = length of the block/points number = 1400/280 = 5
The time interval: time inter = 1/sampling rate/interpolation multiplier = 0.2ns.
The time value of the first data point: time value = - (2.00E-08*14/2) = -1.40E-07(s) = -140(ns).
The time value of the second data point: value = -140ns+0.2ns = -139.8ns.

Use python to reconstruct the waveform:

271
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

272
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WAVEFORM

WAVEFORM_SETUP |WFSU
Command/QueryDESCRIPTION

The WAVEFORM_SETUP command specifies the amountof data in a waveform to be transmitted to the controller.
The WAVEFORM_SETUP? query returns the transfer
parameters currently in use.

COMMAND SYNTAXWAVEFORM_SETUP
SP,<sparsing>,NP,<number>,FP,<point>SP — Sparse point. It defines the interval between data
points.
For example:
SP = 0 sends all data points.
SP = 1 sends all data points.
SP = 4 sends every 4th data point
NP — Number of points. It indicates how many points
should be transmitted.
For example:
NP = 0 sends all data points.
NP = 50 sends a maximum of 50 data points.
FP — First point. It specifies the address of the first data
point to be sent.
For example:
FP = 0 corresponds to the first data point.
FP = 1 corresponds to the second data point.
Note:
You can set the sparse point or number of points or the
first point using key-value pairs alone. See the example fordetails.
After power on, SP is set to 0, NP is set to 0, and FP is273
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

set to 0.
QUERY SYNTAXWAVEFORM_SETUP?

RESPONSE FORMATWAVEFORM_SETUP
SP,<sparsing>,NP,<number>,FP,<point>

EXAMPLEThe following command specifies that every 3th data point(SP=3) starting at the 200th point should be transferred.
Command message:

WFSU SP,3,FP,200
RELATED COMMANDS

WF?

274
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN Commands for SDS1000X/SDS2000X
When the built-in waveform generator is licensed (Option AWG), you can use it to output sine, square,ramp, pulse, DC, noise, exponential rise, exponential fall, cardiac, Gaussian pulse and arbitrary
waveforms. The WGEN commands are used to select the waveform function and parameters.


ARWV



PROD?



STL?



WGEN



WVPR?

Note:
These commands are only valid for SDS1000X and SDS20000X installed AWG option.

275
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN

ARBWAVE | ARWV
Command

DESCRIPTION

The ARBWAVE command sets the basic waveform type.

COMMAND SYNTAXARBWAVE INDEX,<index><index>:= {0,1,2,3,4,5,6,7,8,9}.

EXAMPLEFor SDS2000X series, when the AWG option is installed,
the following command set the index of waveform type to3.
Command message:

ARWV INDEX,3276
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN

PRODUCT? | PROD?
Query

DESCRIPTION

The PRODUCT? query returns the product model or theupper limit of frequency of the output signal.

QUERY SYNTAXPRODUCT? <parameter><parameter>:={MODEL,BAND}
MODEL — return the product model.
BAND — return the upper limit of frequency of the output
signal.

RESPONSE FORMATPRODUCT <parameter>,<value>

EXAMPLEFor SDS2000X series, when the AWG option is installed,
the following query returns the upper limit of frequency ofthe output signal.
Query message:

PROD? BAND
Response message:

PROD BAND,25MHz

277
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN

STORELIST? | STL?
Query

DESCRIPTIONThe STORELIST? query returns the stored arbitrary
waveforms list with indexes and names. If the store unit isempty, the command will return “EMPTY” string.

QUERY SYNTAXSTORELIST? <type><type>:={DEBUG,RELEASE}DEBUG — return built-in waveforms. (include sine, noise,
cardiac,gaus_pulse,

exp_rise,

exp_fall,

and

four

waveforms defined by user)
RELEASE — return four waveforms defined by user.
RESPONSE FORMATSTORELIST <list>

EXAMPLEFor SDS2000X series, when the AWG option is installed,
the following query returns the waveform storage list.
Query message:

STL? DEBUG
Response message:

STL
M0,SINE,M1,NOISE,M2,CARDIAC,M3,GAUS_PULSE,M4,EXP_RISE,M5,EXP_FALL,M6,EMPTY,M7,EMPTY,M8,E
MPTY,M9,EMPTY

278
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN

WAVEGENERATOR | WGEN
Command/QueryDESCRIPTION

The WAVEGENERATOR command sets parameters ofbasic waveform.
The WAVEGENERATOR? query returns the waveform
parameters.

COMMAND SYNTAXWAVEGENERATOR <parameter>,<value><parameter>:= {a parameter from the table below}.
<value>:={value of the corresponding parameter}.

Parameters

Value

Description:=

OUTP<state>{ON,OFF}{SINE,SQUARE,RAMP,PULSE,DC,NOISE,CARDIAC,GAUS_

WVTP<type>PULSE,EXP_RISE,EXP_FALL,ARB1,ARB2,ARB3,ARB4}
If the command doesn’t set basic waveform type, WVPT will
be set to the current waveform.
0.000001 Hz to 25000000 Hz. Not valid when WVTP is

FREQ<frequency>

AMPL<amplitude>

0.004V to 6 V. Not valid when WVTP is NOISE or DC.

OFST<offset>-(6-AMP)/2 to (6-AMP)/2 (V). Not valid when WVTP is NOISE.

DCOFST<dc_offset>-3 to 3 V. Only valid when WVTP is DC.

DUTY<duty>

SYMM

<sym>

WIDTH

<width>

STDEV

<std>

MEAN

<mean>

LOAD<load>NOISE or DC.

20% to 80%.
Only valid when WVTP is SQUARE.
0 to 100%.
Only valid when WVTP is RAMP.
0.000000048 to 0.001 s. Only valid when WVTP is PULSE.
0.0003V to 0.45V.
Only valid when WVTP is NOISE.
-(0.45-STD)*(20/3)-(0.45-STD)*(20/3) (V).
Only valid when WVTP is NOISE.
{ HZ, 50}.

279
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideQUERY SYNTAXWAVEGENERATOR? <parameter><parameter>:={OUTP,WVTP,FREQ,AMPL,OFST,DCOFS
T,DUTY,SYMM,WIDTH,STDEV,MEAN,LOAD,ALL}RESPONSE FORMATWAVEGENERATOR <parameter>,<value>

EXAMPLEFor SDS2000X series, when the AWG option is installed,
the following command set the type to square, amplitude
to 2.5 V, frequency to 10 kHz and duty to 45%.
Command message:

WGEN
TYPE,SQUARE,FREQ,10000Hz,AMPL,2.5V,DUTY,45%
For SDS2000X series, when the AWG option is installed,
the following command set the type to noise, stdev to 0.2
V, mean to 1 V.
Command message:

WGEN TYPE,NOISE,STDEV,0.2V,MEAN,1V
For SDS2000X series, when the AWG option is installed,
the following command set the output to off.
Command message:

WGEN OUTP,OFF

280
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN

WAVE_PARA? | WVPR?
Query

DESCRIPTION

The WAVE_PARA? query returns the location, name,frequency,

amplitudeandoffsetoffourarbitrary

waveforms.
QUERY SYNTAXWAVE_PARA? <index>

RESPONSE FORMAT

WAVE_PARA
POS,<index>,WVNM,<name>,FREQ,<freq>,AMPL,<ampl>,OFST,<ofst>

EXAMPLEFor SDS2000X series, when the AWG option is installed,
the following query returns the parameters of M0.
Query message:

WVPR? M0
Response message:

WVPR
POS,M0,WVNM,SINE,FREQ,1.000000e+03,AMPL,6.0000
00e+00,OFST,0.000000e+00
RELATED COMMANDS

STL?

281
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN Commands for SDS1000X-E/SDS2000X-E
When the oscilloscope supports the function generator module (SAG1021I) and is licensed (OptionFG), you can output basic wave, such as sine, square, ramp, pulse, DC, noise. At present, it does notsupport the instruction of setting built-in waveform and arbitrary waveform.
The WGEN commands are the same as that of Siglent SDG series, so the format is not consistent
with other groups. Refer to SDG programming guide for details.


ARbWaVe

BaSic_WaVe

OUTPutSYNC

VOLTPRT

Note:
These commands are only valid for SDS1000X-E and SDS2000X-E installed AWG option.

282
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN

ARbWaVe
Command/QueryDESCRIPTIONThis command sets or gets the basic wave parameters.

COMMAND SYNTAX<channel>:ARbWaVe INDEX,<index><channel>:ARbWaVe NAME,<name><channel>:={C1}, SAG1021I only supports one output
channel.
<index>:= the index of the arbitrary waveform from thetable below.
<name>:= the name of the arbitrary waveform from thetable below.
Note:This table is just an example, the index depends on thespecific model. The “STL?” query can be used to get theaccurate mapping relationship between the index and
name.

Index

Name

Index

Name

Index

Name

Index

Name

0

Sine

12

Logfall24

Gmonopuls

36

Triang

1

Noise

13

Logrise25

Tripuls

37

Harris2

StairUp

14

Sqrt

26

Cardiac38

Bartlett

3

StairDn

15

Root3

27

Quake

39

Tan

4

Stairud

16

X^2

28

Chirp

40

Cot

5

Ppulse

17

X^3

29

Twotone

41

Sec

6

Npulse

18

Sinc

30

Snr

42

Csc

7

Trapezia

19

Gaussian

31

Hamming

43

Asin

8

Upramp20

Dlorentz

32

Hanning

44

Acos

9

Dnramp21

Haversine

33

Kaiser

45

Atan

10

Exp_fall22

Lorentz

34

Blackman

46

Acot

11

Exp_rise23

Gauspuls

35

Gausswin

47

Square283
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideQUERY SYNTAX<channel>:ARbWaVe?
<channel>:= {C1}RESPONSE FORMAT<channel>:ARWV INDEX,<index>,NAME,<name>

EXAMPLE

Set CH1 current waveform by index 2:

C1:ARWV INDEX,2
Read CH1 current waveform:

C1:ARWV?
Return:C1:ARWV INDEX,2,NAME,StairUp
Set CH1 current waveform to wave_1 by name.

C1:ARWV NAME,wave_1
RELATED COMMANDS

STL?

284
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN

BaSic_WaVe
Command/QueryDESCRIPTIONThis command sets or gets the basic wave parameters.

COMMAND SYNTAX<channel>:BaSic_WaVe <parameter>,<value><channel>:={C1}, SAG1021I only support one output
channel.
<parameter>:= a parameter from the table below.
<value>:= value of the corresponding parameter.

Parameters

Value

Description:= {SINE, SQUARE, RAMP, PULSE, NOISE, ARB, DC,

WVTP<type>

PRBS, IQ}. If the command doesn’t set basic waveform
type, WVPT will be set to the current waveform.
:= frequency. The unit is Hertz “Hz”. Refer to the data

FRQ

<frequency>

sheet for the range of valid values. Not valid when
WVTP is NOISE or DC.
:= period. The unit is seconds "s". Refer to the data

PERI

<period>

sheet for the range of valid values. Not valid when
WVTP is NOISE or DC.
:= amplitude. The unit is volts, peak-to-peak "Vpp". Refer

AMP<amplitude>

to the data sheet for the range of valid values. Not valid
when WVTP is NOISE or DC.
:= offset. The unit is volts "V". Refer to the data sheet for

OFST<offset>the range of valid values. Not valid when WVTP isNOISE.

SYM<symmetry>:= {0 to 100}. Symmetry of RAMP. The unit is "%". Only
settable when WVTP is RAMP.
:= {0 to 100}. Duty cycle. The unit is "%". Value depends

DUTY<duty>

on frequency. Only settable when WVTP is SQUARE or
PULSE.

STDEV<stdev>:= standard deviation of NOISE. The unit is volts "V".
285
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Refer to the data sheet for the range of valid values.
Only settable when WVTP is NOISE.
:= mean of NOISE. The unit is volts "V". Refer to the
MEAN<mean>

data sheet for the range of valid values. Only settable
when WVTP is NOISE.
:= positive pulse width. The unit is seconds "s". Refer to

WIDTH<width>the data sheet for the range of valid values. Only
settable when WVTP is PULSE.

QUERY SYNTAX<channel>:BaSic_WaVe?
<channel>:= {C1}RESPONSE FORMAT<channel>:BSWV <parameter><parameter>:= All the parameters of the current basic
waveform.

EXAMPLE

Change the waveform type of C1 to Ramp:

C1:BSWV WVTP,RAMP
Change the frequency of C1 to 2000 Hz:

C1:BSWV FRQ,2000
Set the amplitude of C1 to 3 Vpp:

C1:BSWV AMP,3
Return parameters of C1 from the device:

C1:BSWV?
Return:

C1:BSWV
WVTP,SINE,FRQ,100HZ,PERI,0.01S,AMP,2V,OFST,0V,HLEV,1V,LLEV,-1V,PHSE,0286
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN

OUTPutCommand/QueryDESCRIPTIONThis command enables or disables the output port(s) at
the front panel. The query returns “ON” or “OFF” and“LOAD”, “PLRT”, “RATIO” parameters.

COMMAND SYNTAX<channel>:OUTPut <state>,LOAD,<load><channel>:= {C1}, SAG1021I only support one output
channel.
<state>:= {ON, OFF}<load>:= {50, HZ}. The unit is ohm.

QUERY SYNTAX<channel>:OUTPut?

RESPONSE FORMAT<channel>:OUTP<state>,LOAD,<load>,PLRT,<polarity><state>:= {ON, OFF}<load>:= {50, HZ}<polarity>:= {NOR, INVT}, in which NOR refers tonormal, and INVT refers to invert. SAG and the built-in
waveform generator only support to set to NOR.

EXAMPLE

Turn on CH1:

C1:OUTP ON
Read CH1 output state:

C1:OUTP?
Return:C1:OUTP ON,LOAD,HZ,PLRT,NOR
287
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Set the load of CH1 to 50 ohm:

C1:OUTP LOAD,50
Set the load of CH1 to HiZ:

C1:OUTP LOAD,HZ

288
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN

SYNC
Command/QueryDESCRIPTIONThis command sets or gets the synchronization signal.

COMMAND SYNTAX<channel>:SYNC <state><channel>:= {C1}, SAG1021I only support one output
channel.
<state>:= {ON, OFF}QUERY SYNTAX<channel>:SYNC?
<channel>:= {C1}RESPONSE FORMAT<channel>:SYNC <state>,TYPE,<TYPE><channel>:= {C1}<state>:= {ON, OFF}<TYPE>:={CH1}, SAG1021I only support one output
channel, so it can only be CH1.

EXAMPLE

Turn on sync output:

C1:SYNC ON
Read state of CH1 sync.

C1:SYNC?
Return:C1:SYNC ON,TYPE,CH1

289
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WGEN

VOLTPRT
Command/QueryDESCRIPTIONThis commend sets or gets the state of over-voltage
protection.

COMMAND SYNTAXVOLTPRT <state><state>:= {ON, OFF}QUERY SYNTAXVOLTPRT?

RESPONSE FORMAT

VOLTPRT <state>

290
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete Commands for Old Models
Obsolete commands are older forms of commands that are provided to reduce customer rework forexisting systems and programs.
Generally, these commands are mapped onto some of the commands, but may not strictly have thesame behavior as the new command.
None of the obsolete commands are guaranteed to remain functional in future products. New systems
and programs should use the new commands.
Obsolete

Current

Command

Behavior Differences

commandEquivalent

ACAL

none

AUTTS

none

COUN

none

CRAU

none

CSVS

none

DATE

none

FFTZ

FFTT?

FILT

none

FILTS

none

PDET

ACQW

The instructions are merged into one.

PERS

PESU

The instructions are merged into one.

PFCT

PFSC|PFBF|PFOP|

Split one command into multiple commands.

Modify the instruction name and usage.

PFFS
REC

none

REFS

REFSR|REFLA|RE

Split one command into multiple commands.

FDS|REFSA
VPOS

FFTP

Modify the instruction name and usage

291
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

AUTO_CALIBRATE | ACAL
Command/QueryDESCRIPTION

The AUTO_CALIBRATE command is used to enable ordisable the quick calibration of the instrument.
The quick calibration can be disabled by sending thecommand “ACAL OFF”. The query “*CAL?” can be set to
fully calibrate the oscilloscope.
The AUTO_CALIBRATE? query returns whether quickcalibration is enabled.

COMMAND SYNTAXAUTO_CALIBRATE <state><state>:={ON,OFF}QUERY SYNTAXAUTO_CALIBRATE?

RESPONSE FORMAT

AUTO_CALIBRATE <state>

EXAMPLEThe following command disables a quick calibration.
Command message:

ACAL OFFRELATED COMMANDS

*CAL?

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

yes

SDS1000X

noSDS1000X-E

no292
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

AUTO_TYPESET | AUTTS
Command/QueryDESCRIPTION

The AUTO_TYPESET command selects the specified typeof automatically adjusting which is used to display.

COMMAND SYNTAXAUTO_TYPESET <type><type>:={SP,MP,RS,DRP,RC}SP — only one period to be displayed.
MP — multiple periods to be displayed.
RS — the waveform is triggered on the rise side.
DRP — the waveform is triggered on the drop side.
RC — go back to the state before auto set.

QUERY SYNTAXAUTO_TYPESET?

RESPONSE FORMAT

AUTO_TYPESET <type>

EXAMPLEThe following command sets the type of automatic
adjustment to multiple periods.
Command message:
AUTTS MPRELATED COMMANDS

ASET

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

no293
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

COUNTER | COUN
Command/QueryDESCRIPTION

The COUNTER command enables or disables thecymometer display on the screen of instrument.
The COUNTER? query returns whether the cymometer isdisplayed on the screen of instrument.

COMMAND SYNTAXCOUNTER <state>< state >:={ON,OFF}QUERY SYNTAXCOUNTER?

RESPONSE FORMAT

COUNTER <state>

EXAMPLEThe following command enables the cymometer display.
Command message:

COUN ONNote:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

noSDS1000X

noSDS1000X-E

no294
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

CURSOR_AUTO | CRAU
Command

DESCRIPTION

The CURSOR_AUTO command sets the cursor mode to
Auto.

COMMAND SYNTAXCRAUEXAMPLEThe following command changes the cursor mode to Auto.
Command message:

CRAU
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

noSDS1000X

noSDS1000X-E

no295
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

SAVE

CSV_SAVE | CSVS
Command/QueryDESCRIPTION

The CSV_SAVE command enables or disables to save theparameter when storing CSV format waveform.
The CSV_SAVE? query returns the current state of saving
the parameter when storing waveform data of CSV format.

COMMAND SYNTAXFormat 1:
CSV_SAVE <state><state>:={OFF,ON}ON — The file contains the oscilloscope model, serial
number, software version number, and the current
parameter configuration of the oscilloscope as shown
below.
OFF — The file only contains the waveform data as
shown below.
State is ON:

State is OFF:

296
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Format 2:
CSV_SAVE SAVE,<state><state>:={OFF,ON}
Format 3:
CSV_SAVE DD,<DD>,SAVE,<state><DD>:={MAX,DIS}MAX — save as the maximum data depth.
DIS — save as the date depth which is displayed on thescreen.
<state>:={OFF,ON}
Note:
The table below shows the available format in each
oscilloscope series.
QUERY SYNTAXCSV_SAVE?

RESPONSE FORMATCSV_SAVE <state>

EXAMPLEFor SDS1000X-E series, the following command sets
“Param save” to off.
Command message:

CSVS OFF
297
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Format in Each Oscilloscope Series
Model

Command Format

SDS1000CFL

Format 3

SDS1000A

Format 3

SDS1000CML+/CNL+/DL+/E+/F+

Format 3

SDS2000X

Format 2

SDS1000X

Format 2

SDS1000X-E

Format 1

298
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

DATE
Command/QueryDESCRIPTION

The DATE command changes the date/time of theoscilloscope’s internal real-time clock. Validity checking is
performed to ensure that the date and the time are valid.

COMMAND SYNTAXDATE <day>,<month>,<year>,<hour>,<min>,<second><day>:= 1 to 31.
<month>:={JAN,FEB,MAR,APR,MAY,JUN,JUL,AUG,SEP,
OCT,NOV,DEC}<year>:= 1990 to 2089.
<hour>:= 0 to 23.
<min>:= 0 to 59.
<second>:= 0 to 59.

QUERY SYNTAXDATE?

RESPONSE FORMATDATE <day>,<month>,<year>,<hour>,<min>,<second>

EXAMPLEThis following command sets the date to NOV. 1, 2017
and the time to 14:38:16.
Command message:

DATE 1,NOV,2017,14,38,16
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000Ano

SDS1000CML+/CNL+/DL+/E+/F+

noSDS2000X

yes

SDS1000X

noSDS1000X-E

no299
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

FFT_ZOOM | FFTZ
Command/QueryDESCRIPTION

The FFT_ZOOM command selects the specified zoom of
FFT.
The FFT_ZOOM? query returns the current zoom in/out of
FFT.

COMMAND SYNTAXFFT_ZOOM <zoom><zoom>:={1,2,5,10}

QUERY SYNTAXFFT_ZOOM?

RESPONSE FORMATFFT_ZOOM <zoom>

EXAMPLEThe following command sets the zoom factor of FFT to 1X.
Command message:

FFTZ 1RELATED COMMANDS

FFTT?

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

no300
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

FILTER | FILT
Command/QueryDESCRIPTION

The FILTER command enables or disables filter of thespecified trace.
The FILTER? query returns whether the filter of specified
trace is enabled.

COMMAND SYNTAX<channel>:FILTER <state><channel>:={C1,C2,C3,C4}<state>:={ON,OFF}QUERY SYNTAX<channel>:FILTER?

RESPONSE FORMAT<channel>:FILTER <state>

EXAMPLEThe following command enables the filter of Channel 1.
Command message.

C1:FILT ON
RELATED COMMANDS

FILTS

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

noSDS1000X

noSDS1000X-E

no301
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

FILT_SET | FILTS
Command/QueryDESCRIPTION

The FILT_SET command selects the specified type offilter, and sets the limit value of filter.
The FILT_SET? query returns current parameter of thefilter.

COMMAND SYNTAX<channel>:FILT_SET TYPE,<type>,<limit>,<limit_value><channel>:={C1,C2,C3,C4}<type>:={LP,HP,BP,BR}
LP — low-pass.
HP — high-pass.
BP — band-pass.
BR — band-reject.
<limit>:={UPPLIMIT,LOWLIMIT}
Note:
If selected the <limit>, the <type> must be related.

QUERY SYNTAX<channel>:FILT_SET?

RESPONSE FORMAT<channel>:FILTER TYPE,<type>,<limit>,<limit_value>

EXAMPLEThe following command changes the type of filter to bandpass, and sets the up-limit to 200 kHz and the low-limit to
100 kHz.
Command message:

C1:FILTS
TYPE,BP,UPPLIMIT,200KHz,LOWLIMIT,100KHz
RELATED COMMANDS

FILT

Note:
The table below shows the availability of command in each oscilloscope series.
302
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

noSDS1000X

noSDS1000X-E

no303
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

PEAK_DETECT | PDET
Command/QueryDESCRIPTION

The PEAK_DETECT command set the switch of Peak
Detect acquisition.
The PEAK_DETECT? query returns the current status ofPeak Detect acquisition.

COMMAND SYNTAXPEAK_DETECT <state><state>:={ON,OFF}QUERY SYNTAXPEAK_DETECT?

RESPONSE FORMATPEAK_DETECT <state>

EXAMPLEThe following command set Peak Detect acquisition on.
Command message:

PDET ON
RELATED COMMANDS

ACQW

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

no304
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

PF_CONTROL | PFCT
Command/QueryDESCRIPTION

The PF_CONTROL command controls the Pass/Failcontrolling options “operate”, “output” and the “stop on
output”.
See instrument’s Operator Manual for these options.
The PF_CONTROL? query returns the controlling optionsof the pass/fail.

COMMAND SYNTAXPF_CONTROLTRACE,<trace>,CONTROL,<control>,OUTPUT,<output>,
OUTPUTSTOP,<state><trace>:={C1,C2,C3,C4}<control>:={START,STOP}<output>:={FAIL,PASS}<state>:={ON,OFF}QUERY SYNTAXPF_ CONTROL?

RESPONSE FORMAT

PF_CONTROLTRACE,<trace>,CONTROL,<control>,OUTPUT,<output>,
OUTPUTSTOP,<state>

EXAMPLEThe following command sets source to Channel 1,“operate” to “start”, “output” to “pass” and “stop on output”
to “off”.
Command message:

PFCTTRACE,C1,CONTROL,START,OUTPUT,PASS,OUTPUT
STOP,OFFRELATED COMMANDS

PFSC
305
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PFBF
PFOP
PFFS
Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

no306
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

ObsoletePERSIST | PERS
Command/QueryDESCRIPTIONThePERSIST

commandenablesor

disablesthepersistence display mode.
COMMAND SYNTAXPERSIST <mode><mode>:={ON,OFF}QUERY SYNTAXPERSIST?

RESPONSE FORMATPERSIST <mode>

EXAMPLEThe following command turns the persistence to ON.
Command message:

PERS ON
RELATED COMMANDS

PESU

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

no307
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

RECALL | REC
Command

DESCRIPTION

The RECALL command recalls a waveform file from thecurrent directory on mass storage into any or all of theinternal memories M1 to M10 (or M20 in the CFL series).

COMMAND SYNTAX<memory>:RECALL DISK,<device>,FILE, ‘<filename>’<memory>:={M1~M10} (M1~M20 for CFL series)<device>:={UDSK}<filename>:= A waveform file under a legal DOS path. A
filename-string of up to eight characters, with theextension “.DAV”.(It can include the “/” character to define
the root directory)

EXAMPLEThe following command recalls a waveform file called“C1WF.DAV” from u-disk into Memory M1.
Command message:

M1:REC DISK,UDSK,FILE,‘C1WF.DAV’RELATED COMMANDS

*RCL

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

no308
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

REF_SET | REFS
Command/QueryDESCRIPTION

The REF_SET command sets the reference waveform andits options.
The REF_ SET? query returns the settings of reference
waveform.

COMMAND SYNTAXREF_SET
TRACE,<trace>,REF,<ref>,STATE,<state>[,SAVE,DO]<trace>:={C1,C2,C3,C4,MATH}<ref>:={RA,RB,RC,RD}. Rx(x=A, B, C, D) is the reference
waveform which can be stored or displayed.
<state>:={ON,OFF}The state enables or disables to display the specified
reference waveform.
Note:
If the command syntax include ‘SAVE, DO’, the specified
trace will be saved to the specified reference waveform.

QUERY SYNTAXREF_SET? REF,<ref>

RESPONSE FORMATREF_SET REF,<ref>,STATE,<state>

EXAMPLEThe following command saves the Channel 1 waveform to
REFA, and display REFA on screen.
Command message:

REFS TRACE,C1,REF,RA,STATE,ON,SAVE,DO
RELATED COMMANDS

REFSR
REFLA
REFDS
REFSA
309
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Note:
The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

no310
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Obsolete

VERT_POSITION | VPOS
Command/QueryDESCRIPTION

The VERT_POSITION command adjusts the vertical
position of the specified FFT trace on the screen. It does
not affect the original offset value obtained at acquisition
time.
The VERT_POSITION? query returns the current vertical
position of the specified FFT trace.

COMMAND SYNTAX<trace>:VERT_POSITION <offset><trace>:={TA,TB,TC,TD}<offset>:= -20*DIV to 20*DIV.
Note:
If there is no unit (V/mV/uV) added, it defaults to be V.
If you set the offset to a value outside of the legal range,
the center value is automatically set to the nearest legal
value. Legal values are affected by the Scale setting.

QUERY SYNTAX<trace>:VERT_POSITION?

RESPONSE FORMAT<trace>:VERT_POSITION <offset>

EXAMPLEThe following command shifts FFT Trace A (TA) upwards
by +3 divisions relative to the position. When the scale of
FFT is 1 V.
Command message:

TA:VPOS 3V
RELATED COMMANDS

FFTP

Note:
311
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

The table below shows the availability of command in each oscilloscope series.
Model

Valid?

SDS1000CFL

yes

SDS1000A

yes

SDS1000CML+/CNL+/DL+/E+/F+

yes

SDS2000X

yes

SDS1000X

yes

SDS1000X-E

no312
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Programming Examples
This chapter gives some examples for the programmer. In these examples you can see how to use
VISA or sockets, in combination with the commands described above to control the oscilloscope. By
following these examples, you can develop many more applications.
 VISA Examples
 VC++ Example
 VB Example
 MATLAB Example
 LabVIEW Example
 C# Example
 Examples of Using Sockets
 Python Example
 C Example
 Common Command Examples
 Read Waveform Data (WF) Example
 Screen Dump (SCDP) Example

313
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

VISA Examples
VC++ Example
Environment: Win7 32-bit, Visual Studio.
Description: Use National Instruments VISA to control the device with USBTMC or TCP/IP access.
Perform a write and read operation.
Steps:
1.

Open Visual Studio, create a new VC++ win32 project.

2.

Set the project environment to use the NI-VISA library. There are two ways to use NI-VISA, static
or automatic:a.

Static:Find the files visa.h, visatype.h, visa32.lib in the NI-VISA installation path, copy them to yourproject, and add them into the project. In the projectname.cpp file, add the follow two lines:#include "visa.h"#pragma comment(lib,"visa32.lib")b.

Automatic:

Set the .h file include directory, the NI-VISA install path, in our computer we set the path is:
C:\Program Files\IVI Foundation \VISA\WinNT\include. Set this path to: project->properties>C/C++ ->General->Additional Include Directories. See the picture below:

Set lib path and set lib file:
314
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Set lib path: the NI-VISA install path, in our computer we set the path is: C:\Program Files\IVI
Foundation\VISA\WinNT\lib\msc.

Set

this

path

to

project->properties->Linker->General->Additional Library Directories: as shown in the pictures below.

Set lib file:project->properties->Linker->Command Line->Additional Options: visa32.lib

Include visa.h file in the projectname.cpp file:#include <visa.h>
315
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

3.

Coding:a.

USBTMC:IntUsbtmc_test(){/* This code demonstrates sending synchronous read & write commands *//* to an USB Test & Measurement Class (USBTMC) instrument using/* NI-VISA*/*//* The example writes the "*IDN?\n" string to all the USBTMC*//* devices connected to the system and attempts to read back*//* results using the write and read functions.

*//* The general flow of the code is *//*Open Resource Manager*//*

Open VISA Session to an Instrument/*

Write the Identification Query Using viPrintf/*

Try to Read a Response With viScanf *//*Close the VISA Session

*/
*/

*/

/***********************************************************/ViSession defaultRM;
ViSession instr;
ViUInt32 numInstrs;
ViFindList findList;
ViUInt32 retCount;
ViUInt32 writeCount;
ViStatus status;
Char instrResourceString[VI_FIND_BUFLEN];
Unsignedcharbuffer[100];
Charstringinput[512];
Int i;/** First we must call viOpenDefaultRM to get the manager* handle. We will store this handle in defaultRM.*/
status=viOpenDefaultRM (&defaultRM);
if (status<VI_SUCCESS){
printf ("Could not open a session to the VISA Resource Manager!\n");returnstatus;
316
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide}/* Find all the USB TMC VISA resources in our system and store the number of resources in thesystem in numInstrs.

*/

status = viFindRsrc (defaultRM, "USB?*INSTR", &findList, &numInstrs, instrResourceString);
if (status<VI_SUCCESS){
printf ("An error occurred while finding resources.\nHit enter to continue.");fflush(stdin);getchar();viClose (defaultRM);
returnstatus;}/** Now we will open VISA sessions to all USB TMC instruments.
* We must use the handle from viOpenDefaultRM and we must
* also use a string that indicates which instrument to open. This
* is called the instrument descriptor. The format for this string* can be found in the function panel by right clicking on the* descriptor parameter. After opening a session to the* device, we will get a handle to the instrument which we* will use in later VISA functions. The AccessMode and Timeout* parameters in this function are reserved for future* functionality. These two parameters are given the value VI_NULL.*/
for (i=0; i<numInstrs; i++){
if (i> 0){
viFindNext (findList, instrResourceString);}
status = viOpen (defaultRM, instrResourceString, VI_NULL, VI_NULL, &instr);
if (status<VI_SUCCESS){
printf ("Cannot open a session to the device %d.\n", i+1);
continue;}/* * At this point we now have a session open to the USB TMC instrument.
* We will now use the viPrintf function to send the device the string "*IDN?\n",317
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide* asking for the device's identification. */char * cmmand ="*IDN?\n";status = viPrintf (instr, cmmand);if (status<VI_SUCCESS){
printf ("Error writing to the device %d.\n", i+1);
status = viClose (instr);
continue;}/** Now we will attempt to read back a response from the device to* the identification query that was sent. We will use the viScanf* function to acquire the data.
* After the data has been read the response is displayed.*/status = viScanf(instr, "%t", buffer);
if (status<VI_SUCCESS){
printf ("Error reading a response from the device %d.\n", i+1);}
else{
printf ("\nDevice %d: %*s\n", i+1,retCount, buffer);}status = viClose (instr);}/** Now we will close the session to the instrument using* viClose. This operation frees all system resources.

*/

status = viClose (defaultRM);
printf("Press 'Enter' to exit.");fflush(stdin);getchar();return 0;}b.

TCP/IP:

intTCP_IP_Test(char *pIP){
318
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

char outputBuffer[VI_FIND_BUFLEN];
ViSession defaultRM, instr;
ViStatus status;
ViUInt32 count;
ViUInt16 portNo;/* First we will need to open the default resource manager. */status = viOpenDefaultRM (&defaultRM);
if (status<VI_SUCCESS){
printf("Could not open a session to the VISA Resource Manager!\n");}/* Now we will open a session via TCP/IP device */charhead[256] ="TCPIP0::";chartail[] ="::INSTR";
charresource [256];
strcat(head,pIP);
strcat(head,tail);
status = viOpen (defaultRM, head, VI_LOAD_CONFIG, VI_NULL, &instr);
if (status<VI_SUCCESS){
printf ("An error occurred opening the session\n");viClose(defaultRM);}
status = viPrintf(instr, "*idn?\n");status = viScanf(instr, "%t", outputBuffer);
if (status<VI_SUCCESS){
printf("viRead failed with error code: %x \n",status);
viClose(defaultRM);}
else{
printf ("\ndata read from device: %*s\n", 0,outputBuffer);}status = viClose (instr);
status = viClose (defaultRM);
319
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

printf("Press 'Enter' to exit.");fflush(stdin);getchar();return 0;}320
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

VB Example
Environment: Windows7 32-bit, Microsoft Visual Basic 6.0
Description: The function of this example: Use the NI-VISA, to control the device with USBTMC and
TCP/IP access to do a write and read.
Steps:
1. Open Visual Basic, and build a standard application program project.
2. Set the project environment to use the NI-VISA lib: Click the Existing tab of Project->Add Module,
search the visa32.bas file in the “include” folder under the NI-VISA installation path and add thefile, as shown in the figure below:

3.

Coding:a.

USBTMC:Private Function Usbtmc_test() As Long
' This code demonstrates sending synchronous read & write commands' to an USB Test & Measurement Class (USBTMC) instrument using' NI-VISA' The example writes the "*IDN?\n" string to all the USBTMC' devices connected to the system and attempts to read back' results using the write and read functions.
' The general flow of the code is'Open Resource Manager
321
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide'

Open VISA Session to an Instrument'

Write the Identification Query Using viWrite'

Try to Read a Response With viRead'

Close the VISA Session

Const MAX_CNT = 200
Dim defaultRM As Long
Dim instrsesn As Long
Dim numlnstrs As Long
Dim findList As Long
Dim retCount As Long
Dim writeCount As Long
Dim status As Long
Dim instrResourceString As String * VI_FIND_BUFLEN
Dim buffer As String * MAX_CNT
Dim i As Integer' First we must call viOpenDefaultRM to get the manager' handle. We will store this handle in defaultRM.
status = viOpenDefaultRM(defaultRM)
If (status < VI_SUCCESS) Then
Debug.Print "Could not open a session to the VISA Resource Manager!"
Usbtmc_test = status
ExitFunction
End If' Find all the USB TMC VISA resources in our system and store the' number of resources in the system in numInstrs.
status=viFindRsrc(defaultRM,"USB?*INSTR",findList,numlnstrs,instrResourceString)If (status < VI_SUCCESS) Then
Debug.Print "An error occurred while finding resources."
viClose (defaultRM)
Usbtmc_test = status
Exit Function
End If' Now we will open VISA sessions to all USB TMC instruments.
322
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide' We must use the handle from viOpenDefaultRM and we must
' also use a string that indicates which instrument to open. This
' is called the instrument descriptor. The format for this string' can be found in the function panel by right clicking on the' descriptor parameter. After opening a session to the' device, we will get a handle to the instrument which we' will use in later VISA functions. The AccessMode and Timeout' parameters in this function are reserved for future' functionality. These two parameters are given the value VI_NULL.
For i = 0 To numInstrs
If (i > 0) Thenstatus = viFindNext(findList, instrResourceString)
End Ifstatus = viOpen(defaultRM, instrResourceString, VI_NULL, VI_NULL, instrsesn)
If (status < VI_SUCCESS) Then
Debug.Print "Cannot open a session to the device ", i + 1
GoTo NextFind
End If' At this point we now have a session open to the USB TMC instrument.
' We will now use the viWrite function to send the device the string "*IDN?",' asking for the device's identification.
status = viWrite(instrsesn, "*IDN?", 5, retCount)
If (status < VI_SUCCESS) Then
Debug.Print "Error writing to the device."
status = viClose(instrsesn)
GoTo NextFind
End If' Now we will attempt to read back a response from the device to' the identification query that was sent. We will use the viRead' function to acquire the data.
' After the data has been read the response is displayed.
status = viRead(instrsesn, buffer, MAX_CNT, retCount)
If (status < VI_SUCCESS) Then
Debug.Print "Error reading a response from the device.", i + 1
323
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Else
Debug.Print i + 1, retCount, buffer
End Ifstatus = viClose(instrsesn)
Next i' Now we will close the session to the instrument using' viClose. This operation frees all system resources.
status = viClose(defaultRM)
Usbtmc_test = 0
End Functionb.

TCP/IP:

Private Function TCP_IP_Test(ip As String) As Long
Dim outputBuffer As String * VI_FIND_BUFLEN
Dim defaultRM As Long
Dim instrsesn As Long
Dim status As Long
Dim count As Long
' First we will need to open the default resource manager.
status = viOpenDefaultRM (defaultRM)
If (status < VI_SUCCESS) Then
Debug.Print "Could not open a session to the VISA Resource Manager!"
TCP_IP_Test = status
Exit Function
End If' Now we will open a session via TCP/IP device
status = viOpen(defaultRM, "TCPIP0::" + ip + "::INSTR", VI_LOAD_CONFIG, VI_NULL, instrsesn)
If (status < VI_SUCCESS) Then
Debug.Print "An error occurred opening the session"viClose (defaultRM)
TCP_IP_Test = status
Exit Function
324
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

End Ifstatus = viWrite(instrsesn, "*IDN?", 5, count)
If (status < VI_SUCCESS) Then
Debug.Print "Error writing to the device."
End Ifstatus = viRead(instrsesn, outputBuffer, VI_FIND_BUFLEN, count)
If (status < VI_SUCCESS) Then
Debug.Print "Error reading a response from the device.", i + 1
Else
Debug.Print "read from device:", outputBuffer
End Ifstatus = viClose(instrsesn)
status = viClose(defaultRM)
TCP_IP_Test = 0
End Function

325
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

MATLAB Example
Environment: Windows7 32-bit, MATLAB R2010b
Description: The function of this example: Use the NI-VISA, to control the device with USBTMC or
TCP/IP access to do a write and read.
Steps:
1. Open MATLAB, and modify the current directory. In this demo, the current directory is modified to
D:\USBTMC_TCPIP_Demo.
2.

Click File->New->Script in the Matlab interface to create an empty M file.

3.

Coding:a.

USBTMC:

function USBTMC_test()% This code demonstrates sending synchronous read & write commands% to an USB Test & Measurement Class (USBTMC) instrument using% NI-VISA%Create a VISA-USB object connected to a USB instrument
vu = visa('ni','USB0::0xF4EC::0xEE38::0123456789::INSTR');%Open the VISA object createdfopen(vu);%Send the string "*IDN?",asking for the device's identification.
fprintf(vu,'*IDN?');%Request the data
outputbuffer = fscanf(vu);disp(outputbuffer);%Close the VISA object
fclose(vu);delete(vu);clear vu;
end

326
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guideb.

TCP/IP:

function TCP_IP_test( IPstr )% This code demonstrates sending synchronous read & write commands% to an TCP/IP instrument using NI-VISA%Create a VISA-TCPIP object connected to an instrument%configured with IP address.
vt = visa('ni',['TCPIP0::',IPstr,'::INSTR']);%Open the VISA object createdfopen(vt);%Send the string "*IDN?",asking for the device's identification.
fprintf(vt,'*IDN?');%Request the data
outputbuffer = fscanf(vt);disp(outputbuffer);%Close the VISA object
fclose(vt);delete(vt);clear vt;
end

327
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming GuideLabVIEW Example
Environment: Windows7 32-bit, LabVIEW 2011
Description: The functions of this example: use the NI-VISA, to control the device with USBTMC and
TCP/IP access to do a write and read.
Steps:
1.

Open LabVIEW, create a VI file.

2.

Add controls. Right-click in the Front Panel interface, select and add VISA resource name, error
in, error out and some indicators from the Controls column.

3.

Open the Block Diagram interface. Right-click on the VISA resource name and you can selectand add the following functions from VISA Palette from the pop-up menu: VISA Write, VISA
Read, VISA Open and VISA Close.

4.

The connection is as shown in the figure below:

5.

Select the device resource from the VISA Resource Name list box and run the program.

328
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

In this example, the VI opens a VISA session to a USBTMC device, writes a command to the device,
and reads back the response. After all communication is complete, the VI closes the VISA session.
6.

Communicating with the device via TCP/IP is similar to USBTMC. But you need to change VISA
Write and VISA Read Function to Synchronous I/O. The LabVIEW default is asynchronous I/O.
Right-click the node and select Synchronous I/O Mod>>Synchronous from the shortcut menu towrite or read data synchronously.

7.

The connection is as shown in the figure below:

8.

Input the IP address and run the program.

329
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

330
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

C# Example
Environment: Windows7 32-bit, Visual Studio
Description: The functions of this example: use the NI-VISA, to control the device with USBTMC or
TCP/IP access to do a write and read.
Steps:
1.

Open Visual Studio, create a new C# project.

2.

Add References. Add NationalInstruments.Common.dll and NationalInstruments.VisaNS.dll tothe project. (Notice: you must install the .NET Framework 3.5/4.0/4.5 Languages support when
you install the NI-VISA.)

3.

Coding:using System;
using System.Collections.Generic;using System.Linq;
using System.Text;
using NationalInstruments.VisaNS;
namespace TestVisa{
class Program{
331
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

static void Main(string[] args){// Find all the USBTMC resources
string[]usbRsrcStrings=ResourceManager.GetLocalManager().FindResources("USB?*INSTR");
if (usbRsrcStrings.Length <= 0){
Console.WriteLine("Can not find USBTMC Device!");return;}//Choose the first resource string to connect the device.
//You can input the address manually//USBTMC://MessageBasedSession
mbSession=(MessageBasedSession)ResourceManager.GetLocalManager().Open("
USB0::0xF4EC::0xEE38::0123456789::INSTR");/TCP IP://MessageBasedSession
mbSession=(MessageBasedSession)ResourceManager.GetLocalManager().Open("
TCPIP0::192.168.1.100::INSTR");
MessageBasedSession
mbSession=(MessageBasedSession)ResourceManager.GetLocalManager().Open(usbRsrcStrings[0]);mbSession.Write("*IDN?");string result = mbSession.ReadString();
mbSession.Dispose();
Console.WriteLine(result);
}
}
}

332
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Examples of Using Sockets
Socket communication is a basic communication technology in computer network. It allows
applications to communicate through the standard network protocol mechanism built by network
hardware and operation system.
This method is a two-way communication between the instrument and the computer through a fixed
port number.
Note that SCPI strings are terminated with a “\n” (new line) character.

Python Example
Python has a low-level networking module that provides access to the socket interface. Python scripts
can be written for sockets to do a variety of test and measurement tasks.
Environment: Windows 7 32-bit, Python v2.7.5
Description: Open a socket, send a query, and repeat this loop for 10 times, finally close the socket.
Below is the code of the script:#!/usr/bin/env python#-*- coding:utf-8 –*#----------------------------------------------------------------------------# The short script is a example that open a socket, sends a query,# print the return message and closes the socket.
#----------------------------------------------------------------------------import socket # for sockets
import sys # for exit
import time # for sleep#----------------------------------------------------------------------------remote_ip = "10.11.13.32" # should match the instrument’s IP address
port = 5025 # the port number of the instrument service
count = 0
def SocketConnect():333
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guidetry:#create an AF_INET, STREAM socket (TCP)s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
except socket.error:
print ('Failed to create socket.')sys.exit();try:#Connect to remote servers.connect((remote_ip , port))
info = s.recv(4096)
print (info)
except socket.error:
print ('failed to connect to ip ' + remote_ip)
return s
def SocketQuery(Sock, cmd):
try :#Send cmd string
Sock.sendall(cmd)time.sleep(1)except socket.error:#Send failed
print ('Send failed')
sys.exit()
reply = Sock.recv(4096)
return reply
def SocketClose(Sock):#close the socket
Sock.close()time.sleep(.300)
def main():global remote_ip
global port
global count
334
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide# Body: send the SCPI commands *IDN? 10 times and print the return message
s = SocketConnect()for i in range(10):qStr = SocketQuery(s, b'*IDN?')
print (str(count) + ":: " + str(qStr))count = count + 1
SocketClose(s)input('Press "Enter" to exit')
if __name__ == '__main__':proc = main()

335
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

C Example
int MySocket;
if((MySocket=socket(PF_INET,SOCK_STREAM,0))==-1){
exit(1);}struct in_addr{
unsigned long s_addr;};
struct sockaddr_in{
short int sin_family; // Address family
unsigned short int sin_port; // Port number
struct in_addr sin_addr; // Internet addressunsigned char sin_zero[8]; // Padding};
struct sockaddr_in MyAddress;// Initialize the whole structure to zeromemset(&MyAddress,0,sizeof(struct sockaddr_in));// Then set the individual fields
MyAddress.sin_family=PF_INET; // IPv4
MyAddress.sin_port=htons(5025); // Port number used by most instruments
MyAddress.sin_addr.s_addr=inet_addr(“169.254.9.80”); // IP Address// Establish TCP connection
if(connect(MySocket,(struct sockaddr*)&MyAddress,sizeof(struct sockaddr_in))==-1){
exit(1);}// Send SCPI commandif(send(MySocket,”*IDN?\n”,6,0)==-1){
336
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guideexit(1);}// Read responsechar buffer[200];
int actual;if((actual=recv(MySocket,&buffer[0],200,0))==-1){
exit(1);}
buffer[actual]=0; // Add zero character (C string)
printf(“Instrument ID: %s\n”,buffer);// Close socket
if(close(MySocket)==-1){
exit(1);}

337
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Common Command Examples
This section lists the programming instances of common commands.
Environment: Windows 7 32-bit, Python v3.4.3, pyvisa-1.7, Matplotlib-1.5.1

Note:
When using the visa library, you should pay attention to the following settings:
1.

Set the I/O buffer size.

I.E. For the command “WF”, the read buffer size depends on the number of waveform points.
When it needs to read in segments, the size of each segment is vary from the models.
2.

Set the timeout value.

The timeout value is related to the network speed or USB transmission speed. Please evaluate by
yourself. The initial value is generally 2s.

Read Waveform Data (WF) Example
import visa
import pylab as pldef main():_rm = visa.ResourceManager()sds = _rm.open_resource("USB0::0xF4EC::0xEE38::0123456789::INSTR")
sds.write("chdr off")
vdiv = sds.query("c1:vdiv?")
ofst = sds.query("c1:ofst?")tdiv = sds.query("tdiv?")
sara = sds.query("sara?")sara_unit = {'G':1E9,'M':1E6,'k':1E3}
for unit in sara_unit.keys():
338
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

if sara.find(unit)!=-1:
sara = sara.split(unit)
sara = float(sara[0])*sara_unit[unit]
breaksara = float(sara)
sds.timeout = 30000 #default value is 2000(2s)sds.chunk_size = 20*1024*1024 #default value is 20*1024(20k bytes)
sds.write("c1:wf? dat2")
recv = list(sds.read_raw())[15:]recv.pop()
recv.pop()
volt_value = []for data in recv:
if data > 127:
data = data - 256
else:
pass
volt_value.append(data)
time_value = []for idx in range(0,len(volt_value)):
volt_value[idx] = volt_value[idx]/25*float(vdiv)-float(ofst)
time_data = -(float(tdiv)*14/2)+idx*(1/sara)
time_value.append(time_data)
pl.figure(figsize=(7,5))
pl.plot(time_value,volt_value,markersize=2,label=u"Y-T")
pl.legend()
pl.grid()pl.show()
if __name__=='__main__':main()

Read Waveform Data of Digital Example
import visa
339
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

import pylab as pldef get_char_bit(char,n):
return (char >> n) & 1
def main():_rm = visa.ResourceManager()sds = _rm.open_resource("USB0::0xF4EC::0xEE38::0123456789::INSTR")
sds.write("chdr off")
tdiv = sds.query("tdiv?")
sara = sds.query("di:sara?")sara_unit = {'G':1E9,'M':1E6,'k':1E3}
for unit in sara_unit.keys():if sara.find(unit)!=-1:
sara = sara.split(unit)
sara = float(sara[0])*sara_unit[unit]
breaksara = float(sara)
sds.timeout = 30000 #default value is 2000(2s)sds.chunk_size = 20*1024*1024 #default value is 20*1024(20k bytes)
sds.write("d0:wf? dat2")
recv = list(sds.read_raw())[16:]recv.pop()
recv.pop()
volt_value = []data =bytearray(recv)
for char in data:for i in range(0,8):
volt_value.append(get_char_bit(char,i))
print(len(volt_value))
time_value = []for idx in range(0,len(volt_value)):
time_data = -(float(tdiv)*14/2)+idx*(1/sara)
time_value.append(time_data)
340
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

pl.figure(figsize=(7,5))
pl.ylim(-1,2)
pl.plot(time_value,volt_value,markersize=2,label=u"Y-T")
pl.legend()
pl.grid()pl.show()
if __name__=='__main__':main()

Screen Dump (SCDP) Example
import visa
def main():_rm = visa.ResourceManager()sds = _rm.open_resource("USB0::0xF4EC::0xEE38::0123456789::INSTR")
sds.chunk_size = 20*1024*1024 #default value is 20*1024(20k bytes)
sds.timeout = 30000 #default value is 2000(2s)file_name = "F:\\SCDP.bmp"
sds.write("SCDP")
result_str = sds.read_raw()
f = open(file_name,'wb')
f.write(result_str)
f.flush()f.close()if __name__=='__main__':main()

Then you can open the file as shown below:

341
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

342
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Index
A
ACQUIRE_WAY, ACQW, Command/Query, 28
ARBWAVE, ARWV, Command, 276
ARM_ACQUISITION, ARM, Command, 25
ATTENUATION, ATTN, Command/Query, 41
AUTO_CALIBRATE, ACAL, Command/Query, 292
AUTO_SETUP, ASET, Command, 39
AUTO_TYPESET, AUTTS, Command/Query, 293
AVERAGE_ACQUIRE, AVGA, Command/Query, 30
B
BANDWIDTH_LIMIT, BWL, Command/Query, 42
BUZZER, BUZZ, Command/ Query, 179
B<n>:DCCN, Command, 68
B<n>:DCIC, Command, 62
B<n>:DCLN, Command, 70
B<n>:DCSP, Command, 64
B<n>:DCUT, Command, 66
C
CAL?, Query, 178
COMM_HEADER, CHDR, Command/Query, 23
COMM_NET, CONET, Command/Query, 180
COUNTER, COUN, Command/Query, 294
COUPLING, CPL, Command/Query, 43
CURSOR_AUTO, CRAU, Command, 295
CURSOR_MEASURE, CRMS, Command/Query, 52
CURSOR_SET, CRST, Command/Query, 54
CURSOR_TYPE, CRTY, Command/Query, 56
CURSOR_VALUE?, CRVA?,Query, 57
CUSTOM, CUS, Command/Query, 80
CSV_SAVE, CSVS, Command/Query, 296
CYMOMETER, CYMT, Query, 114
343
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

D
DATE, Command/Query, 299
DCPA, Command, 61
DCST, Command/Query, 60
DEFINE, DEF, Command/Query, 96
DIGITAL_CHANNEL, DGCH, Command/Query, 73
DIGITAL_STATE, DGST, Command/Query, 74
DIGITAL_THR, DGTH, Command/Query, 75
DI:SWITCH, DI:SW, Command/Query, 77
DOT_JOIN, DTJN, Command/Query, 83
E
EduMode, EMOD, Command/Query, 182
F
FFT_CENTER, FFTC, Command/Query, 102
FFT_FULLSCREEN, FFTF, Command/Query, 104
FFT_POSITION, FFTP, Command/Query, 105
FFT_SCALE, FFTS, Command/Query, 107
FFT_TDIV?, FFTT?, Query, 109
FFT_UNIT, FFTU, Command/Query, 110
FFT_WINDOW, FFTW, Command/Query, 111
FFT_ZOOM, FFTZ, Command/Query, 300
FILTER, FILT, Command/Query, 301
FILT_SET, FILTS, Command/Query, 302
FRAME_SET, FRAM, Command, 89
FRAME_TIME?, FTIM?, Query, 91
G
GRID_DISPLAY, GRDS, Command/Query, 84
H
HOR_MAGNIFY, HMAG, Command/Query, 187
HOR_POSITION, HPOS, Command/Query, 189
HISTORY_LIST, HLST, Command/Query, 93
344
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

HISTORY_MODE, HSMD, Command/Query, 92
I
IDN?, Query, 19
INTENSITY, INTS, Command/Query, 85
INR?, Query, 175
INVERT_SET, INVS, Command/Query, 50/98
M
MEASURE_DELY, MEAD, Command/Query, 116
MEASURE_CLEAR, MEACL, Command, 129
MEASURE_GATEA, MEGA, Command, 131
MEASURE_GATEB, MEGB, Command, 133
MEASURE_GATE_SWITCH, MEGS, Command, 130
MENU, MENU, Command/Query, 86
MEMORY_SIZE, MSIZ, Command/Query, 31
MATH_VERT_DIV, MTVD, Command/Query, 99
MATH_VERT_POS, MTVP, Command/Query, 101O
OFFSET, OFST, Command/Query, 44
OPC, Command, 20
P
PANEL_SETUP, PNSU, Command/Query, 168
PARAMETER_CLR, PACL, Command, 136
PARAMETER_CUSTOM, PACU, Command, 119
PARAMETER_VALUE?, PAVA?, Query, 122
PASTAT, Command/Query, 127
PEAK_DETECT, PDET, Command/Query, 304
PERSIST, PERS, Command/Query, 307
PERSIST_SETUP, PESU, Command/Query, 87
PF_BUFFER, PFBF, Command/Query, 137
PF_CONTROL, PFCT, Command/Query, 305
PF_CREATEM, PFCM, Command, 139
PF_DATEDIS?, PFDD?, Query, 140
345
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

PF_DISPLAY, PFDS, Command/Query, 141
PF_ENABLE, PFEN, Command/Query, 142
PF_FAIL_STOP, PFFS, Command/Query, 143
PF_OPERATION, PFOP, Command/Query, 145
PF_SET, PFST, Command/Query, 147
PF_SOURCE, PFSC, Command/Query, 146
PRODUCT?, PROD?, Query, 277
R
RCL, Command, 151
RECALL, REC, Command, 308
RECALL_PANEL, RCPN, Command, 152
REF_CLOSE, REFCL, Command, 155
REF_DISPALY, REFDS, Command/Query, 156
REF_LOCATION, REFLA, Command/Query, 158
REF_POISITION, REFPO, Command/Query, 159
REF_SAVE, REFSA, Command, 161
REF_SCLALE, REFSC, Command/Query, 162
REF_SET, REFS, Command/Query, 309
REF_SOURCE, REFSR, Command/Query, 164
RST, Command, 21
S
SAMPLE_NUM?, SANU?, Query, 35
SAMPLE_RATE?, SARA?, Query, 33
SAMPLE_STATUS?, SAST?, Query, 32
SAV, Command, 166
SCREEN_DUMP, SCDP, Query, 149
SCREEN_SAVE, SCSV, Command/Query, 181
SET50, Command, 192
SINXX_SAMPLE, SXSA, Command/Query, 36
SKEW, Command, 46
STORELIST?, STL?, Query, 278
STOP, Command, 27
STORE_PANEL, STPN, Command, 171
346
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

T
THRESHOLD_MODE, TSM, Command/Query, 79
TIME_DIV, TDIV, Command/Query, 184
TRACE, TRA, Command/Query, 47/78
TRCAN:BAUD, Command/Query, 255
TRCAN:CANH, Command/Query, 248
TRCAN:CON, Command/Query, 249
TRCAN:DAT, Command/Query, 254
TRCAN:DATA, Command/Query, 253
TRCAN:ID, Command/Query, 250
TRCAN:IDL, Command/Query, 252
TRIIC:ADDR, Command/Query, 215
TRIIC:ALEN, Command/Query, 222
TRIIC:CON, Command/Query, 213
TRIIC:DAT2, Command/Query, 219
TRIIC:DATA, Command/Query, 217
TRIIC:DLEN, Command/Query, 223
TRIIC:RW, Command/Query, 221
TRIIC:QUAL, Command/Query, 220
TRIIC:SCL, Command/Query, 211
TRIIC:SDA, Command/Query, 212
TRIG_COUPLING, TRCP, Command/Query, 193
TRIG_DELAY, TRDL, Command/Query, 185
TRIG_LEVEL, TRLV, Command/Query, 193
TRIG_LEVEL2, TRLV2, Command/Query, 196
TRIG_MODE, TRMD, Command/Query, 198
TRIG_PATTERN, TRPA, Command/Query,200
TRIG_SELECT, TRSE, Command/Query, 202
TRIG_SLOPE, TRSL, Command/Query, 207
TRIG_WINDOW, TRWI, Command/Query, 208
TRLIN:BAUD, Command/Query, 261
TRLIN:CON, Command/Query, 257
TRLIN:DAT2, Command/Query, 260
TRLIN:DATA, Command/Query, 259
TRLIN:ID, Command/Query, 258
TRLIN:SRC, Command/Query, 256
347
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

TRSPI:BIT, Command/Query, 235
TRSPI:CLK, Command/Query, 224
TRSPI:CLK:EDGE, Command/Query, 225
TRSPI:CLK:TIM, Command/Query, 226
TRSPI:CS, Command/Query, 230
TRSPI:CSTP, Command/Query, 229
TRSPI:DATA, Command, 233
TRSPI:DLEN, Command/Query, 234
TRSPI:MOSI, Command/Query, 227
TRSPI:MISO, Command/Query, 228
TRSPI:NCS, Command/Query, 231
TRSPI:TRTY, Command/Query, 232
TRUART:BAUD, Command/Query, 242
TRUART:BIT, Command/Query, 247
TRUART:CON, Command/Query, 239
TRUART:DATA, Command/Query, 241
TRUART:DLEN, Command/Query, 243
TRUART:QUAL, Command/Query, 240
TRUART:PAR, Command/Query, 244
TRUART:POL, Command/Query, 245
TRUART:RX, Command/Query, 236
TRUART:TRTY, Command/Query, 238
TRUART:TX, Command/Query, 237
TRUART:STOP, Command/Query, 246
U
UNIT, UNIT, Command/Query, 48
V
VOLT_DIV, VDIV, Command/Query, 49
VERT_POSITION, VPOS, Command/Query, 311
W
WAVEFORM?, WF?, Query, 263
WAVEFORM_SETUP, WFSU, Command/Query, 273
WAVEGENERATOR, WGEN, Command/Query, 279
348
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

WAVE_PARA?, WVPR?, Query,281
X
XY_DISPLAY, XYDS, Command/Query, 37

349
WWW.SIGLENT.COM

Digital Oscilloscope Series Programming Guide

Digital Series
Oscilloscope

350
WWW.SIGLENT.COM