SIGLENT SDS1000 Series Manual

SDS1000 Series

Remote Control
Manual SDS1000
Series
Oscilloscopes

RC01011-E02B

SIGLENT TECHNOLOGIES CO., LTD

SDS-RCM 1

SDS1000 Series

catalogue

Using Status Registers ..................................................................................................... 3

About these Commands & Queries ................................................................................. 3

How they are listed? .................................................................................................... 3

How they are described?.............................................................................................. 3

When can they be used? .............................................................................................. 4

Command Notation .......................................................................................................... 4

Table of Commands & Queries....................................................................................... 5

Commands & Queries....................................................................................................11

Index..............................................................................................................................130

2 SDS-RCM

SDS1000 Series

Using Status Registers

A wide range of status registers allows the oscilloscope’s internal processing status to be
determined quickly at any time. These registers and the instrument’s status reporting system are
designed to comply with IEEE 488.2 recommendations. Following an overview, starting this
page, each of the registers and their roles are described.

Related functions are grouped together in c ommon status registers. Some, such as the Status
Byte Register (STB) or the Standard Event Status Register (ESR), are required by the IEEE

488.2 Standard. Other registers are device-specific, and include the Command Error Register
(CMR) and Execution Error Register (EXR). Those commands associated with IEEE 488.2
mandatory status registers are preceded by an asterisk <*>.

About these Commands & Queries

This section lists and describes the remote control commands and queries recognized by the
instrument. All commands and queries can be executed in either local or remote state.

The description for each command or query, with syntax and other information, begins on a new
page. The name (header) is given in both long and short form at the top of the page, and the
subject is indicated as a command or query or both. Queries perform actions such as obtaining
information, and are recognized by the question mark (?) following the header.

How they are listed?

The descriptions are listed in alphabetical order according to their long form. Thus the
description of ATTENUATION, whose short form is ATTN, is listed before that of AUTO
SETUP, whose short form is ASET.

How they are described?

In the descriptions themselves, a brief explanation of the function performed is given. This is
followed by a presentation of the formal syntax, with the header given in Upper-and-Lower-

SDS-RCM 3

SDS1000 Series

Case characters and the short form derived from it in ALL UPPER-CASE characters. Where
applicable, the syntax of the query is given with the format of its response.

When can they be used?

The commands and queries listed here can be used with SDS1000 Series digital instruments.

Command Notation

The following notation is used in the commands:
< > Angular brackets enclose words that are used as placeholders, of

which there are two types: the header path and the data parameter
of a command.

: = A colon followed by an equals sign separates a placeholder from

the description of the type and range of values that may be used in

a command instead of the placeholder.
{} Braces enclose a list of choices, one of which one must be made.
[ ] Square brackets enclose optional items.
… An ellipsis indicates that the items both to its left and right may be

repeated 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 5 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 t he data parameter specifying
the desired vertical gain value. The second line indicates that one of four channels must be
chosen for t he header path. And the third explains that the actual vertical gain can be set to any
value between 2 mV and 5 V.

4 SDS-RCM

SDS1000 Series

Table of Commands & Queries

Short Form Long Form Subsystem

ALST? ALL_STATUS? STATUS

ARM ARM_ACQUISITION ACQUISITION

ATTN ATTENUATION ACQUISITION

ACAL AUTO_CALIBRATE MISCELLANEOUS

ASET AUTO_SETUP ACQUISITION

AUTTS AUTO_TYPESET ACQUISITION

AVGA AVERAGE_ACQUIRE ACQUISITION

BWL BANDWIDTH_LIMIT ACQUISITION

BUZZ BUZZER MISCELLANEOUS

*CAL? *CAL? MISCELLANEOUS

CHDR COMM_HEADER COMMUNICATION

*CLS *CLS STATUS

CMR? CMR? STATUS

CONET COMM_NET COMMUNICATION

CPL COUPLING ACQUISITION

What the Command or

Query Does

Reads and clears
the contents of all
status registers.
Changes acquisition state
from “stopped” to
“single”.
Selects the vertical
attenuation factor of the
probe
Enables or disables
automatic calibration.
Adjusts vertical, time base
and trigger parameters.
Selects the display type of

automatic setup.
Selects the average times
of average acquisition.
Enables/disables the
bandwidth-limiting low­pass filter.
Controls the built-in
piezo-electric buzzer.
Performs complete
internal calibration of the
instrument.
Controls formatting of
query responses.
Clears all status data
registers.
Reads and clears the
Command error Register
(CMR).
Specifies network
addresses of scope and
printers.
Selects the specified input
channel’s coupling mode.

SDS-RCM 5

SDS1000 Series

CRMS CURSOR_MEASURE CURSOR

CRST? CURSOR_SET? CURSOR

CRVA? CURSOR_VALUE? CURSOR

CRAU CURSOR_AUTO CURSOR

CSVS CSV_SAVE SAVE/RECALL

COUN COUNTER FUNCTION

CYMT CYMOMETER FUNCTION

DATE DATE MISCELLANEOUS

DDR? DDR? STATUS

DEF DEFINE? FUNCTION

DELF DELETE_FILE MASS STORAGE

DIR DIRECTORY MASS STORAGE

DTJN DOT_JOIN DISPLAY

*ESE *ESE STATUS

*ESR? *ESR? STATUS

EXR? EXR? STATUS

FLNM FILENAME MASS STORAGE

FRTR FORCE_TRIGGER ACQUISITION

Specifies the type of
cursor/parameter
measurement.
Allows positioning of any
one of eight cursors.
Returns trace values
measured by specified
cursors.
Changes the cursor mode
to auto mode.
Saves specified waveform
data of CSV format to
USB device.
Enables or disables the
cymometer to display on
the screen.
Returns the current
cymometer value which
displaying on the screen.
Changes the date/time of
the internal real-time
clock.
Clears the Device
Dependent Register
(DDR).
Specifies math expression
for function evaluation.
Deletes files from mass
storage.
Creates and deletes file
directories.
Controls the interpolation
lines between data points.
Sets the Standard Event
Status Enable register
(ESE).
Reads, clears the Event
Status Register (ESR).
Reads, clears the
Execution error Register
(EXR).
Changes default
filenames.
Forces the instrument to
make one acquisition.

6 SDS-RCM

SDS1000 Series

FVDISK FORMAT_VDISK MASS STORAGE

FILT FILTER FUNCTION

FILTS FILT_SET FUNCTION

FFTW FFT_WINDOW FUNCTION

FFTZ FFT_ZOOM FUNCTION

FFTS FFT_SCALE FUNCTION

FFTF FFT_FULLSCREEN FUNCTION

GRDS GRID_DISPLAY DISPLAY Selects the type of grid

GCSV GET_CSV WAVEFORMTRANS

HMAG HOR_MAGNIFY DISPLAY

HPOS HOR_POSITION DISPLAY

HCSU HARDCOPY_SETUP HARD COPY

*IDN? *IDN? MISCELLANEOUS

INTS INTENSITY DISPLAY

ILVD INTERLEAVED ACQUISITION

INR? INR? STATUS

INVS INVERT_SET DISPLAY

LOCK LOCK MISCELLANEOUS Lock keyboard

MENU MENU DISPLAY

MTVP MATH_VERT_POS ACQUISITION

Reads the capability of the
USB device.
Enables or disables the
filter of specified source.
Selects the type of filter,
and sets the limit value of
filter.
Selects the window of
FFT.
Selects the zoom in/out
times of FFT trace.
Selects the vertical scale
of FFT trace.
Enables or disables to
display the FFT trace full
screen.

Specifies waveform data
of format to controller.
Horizontally expands the
selected expansion trace.
Horizontally positions
intensified zone’s center.
Configures the hard-copy
driver.
For identification
purposes.
Sets the grid or trace/text
intensity level.
Enables/disables random
interleaved sampling
(RIS).
Reads, clears INternal
state change Register
(INR).
Invert the trace or the
math waveform of
specified source.

Enables or disables to
display the current menu.
Controls the vertical
position of math
waveform of specified
source.

SDS-RCM 7

SDS1000 Series

MTVD MATH_VERT_DIV ACQUISITION

MEAD MEASURE_DELY FUNCTION

OFST OFFSET ACQUISITION

*OPC *OPC STATUS

*OPT? *OPT? MISCELLANEOUS

PACL PARAMETER_CLR CURSOR

PACU

PAVA?

PDET PEAK_DETECT ACQUISITION

PERS PERSIST DISPLAY

PESU PERSIST_SETUP DISPLAY

PNSU PANEL_SETUP SAVE/RECALL

PFDS PF_DISPLAY FUNCTION

PFST PF_SET FUNCTION

PFSL PF_SAVELOAD SAVE/RECALL

PFCT PF_CONTROL FUNCTION

PFCM PF_CREATEM FUNCTION

PFDD PF_DATEDIS FUNCTION

PARAMETER_CUSTO
M
PARAMETER_VALU
E?

CURSOR

CURSOR

Controls the vertical
sensitivity of math
waveform of specified
source.
Selects the type of delay
measure.
Allows output channel
vertical offset adjustment.
Sets the OPC bit in the
Event Status Register
(ESR).
Identifies oscilloscope
options.
Clears all current
parameters in Custom,
Pass/Fail.
Controls parameters with
customizable qualifiers.
Returns current parameter,
mask test values.
Switches the peak detector
ON and OFF.
Enables or disables the
persistence display mode.
Selects display persistence
duration.
Complements the
*SAV/*RST commands.
Enables or disables to
display the test and the
message options of
pass/fail.
Sets the X mask and the Y
mask.
Saves or recalls the
created mask setting.
Selects the “operate”,
“output” and the “stop on
output” which are the
options of pass/fail.
Creates the mask of the
pass/fail.
Return the number of the
pass/fail monitor which
can be displayed on the
screen.

8 SDS-RCM

*RCL *RCL SAVE/RECALL

REC RECALL WAVEFORMTRANS

RCPN RECALL_PANEL SAVE/REC ALL

*RST *RST SAVE/RECALL

REFS REF_SET FUNCTION

*SAV *SAV SAVE/RECALL

SCDP SCREEN_DUMP HARD COPY

SCSV SCREEN_SAVE DISPLAY

*SRE *SRE STATUS

*STB? *STB? STATUS

STOP STOP ACQUISITION

STO STORE WAVEFORMTRANS

STPN STORE_PANEL SAVE/RECALL

STST STORE_SETUP WAVEFORMTRANS

SAST SAMPLE_STATUS ACQUISITION

SARA SAMPLE_RATE ACQUISITION

SANU SAMPLE_NUM ACQUISITION

SKEW SKEW ACQUISITION

SET50 SETTO%50 FUNCTION

SXSA SINXX_SAMPLE ACQUISITION

TDIV TIME_DIV ACQUISITION

SDS1000 Series

Recalls one of five non­volatile panel setups.
Recalls a file from mass
storage to internal
memory.
Recalls a front-panel setup
from mass storage.
The *RST command
initiates a device reset.
Sets the reference
waveform and its options.
Stores current state in non­volatile internal memory.
Causes a screen dump to
controller.
Controls the automatic
screen saver.
Sets the Service Request
Enable register (SRE).
Reads the contents of
IEEE 488.
Immediately stops signal
acquisition.
Stores a trace in internal
memory or mass storage.
Stores front-panel setup to
mass storage.
Controls the way in which
traces are stored.
Return the acquisition
status of the scope
Return the sample rate of
the scope
Return the number of
sampled points available
from last acquisition and
the trigger position
Sets the skew of specified
trace.
Sets the trigger level of the
trigger source to the centre
of the signal amplitude.
Sets the type of the
interpolation.
Modifies the time base
setting.

SDS-RCM 9

SDS1000 Series

TMPL TEMPLATE

TRA TRACE DISPLAY

*TRG *TRG ACQUISITION

TRCP TRIG_COUPLING ACQUISITION

TRDL TRIG_DELAY ACQUISITION

TRLV TRIG_LEVEL ACQUISITION

TRMD TRIG_MODE ACQUISITION the trigger mode.

TRSE TRIG_SELECT ACQUISITION

TRSL TRIG_SLOPE ACQUISITION

UNIT UNIT ACQUISITION

VPOS VERT_POSITION DISPLAY

VDIV VOLT_DIV ACQUISITION

VTCL VERTICAL ACQUISITION

WF WAVEFORM WAVEFORMTRANS

WFSU WAVEFORM_SETUP WAVEFORMTRANS

WAIT WAIT ACQUISITION

XYDS XY_DISPLAY DISPLAY

WAVEFORM
TRANSFER

Produces a complete
waveform template copy.
Enables or disables the
display of a trace.
Executes an ARM
command.
Sets the coupling mode of
the specified trigger
source.
Sets the time at which the
trigger is to occur.
Adjusts the trigger level of
the specified trigger
source.

Selects the condition that
will trigger acquisition.
Sets the trigger slope of
the specified trigger
source.
Sets the unit of specified
trace.
Adjusts the vertical
position of the FFT trace.
Sets the vertical
sensitivity.
Controls the vertical
position of the slope
trigger line.
Gets the waveform from
the instrument.
Specifies amount of
waveform data to go to
controller.
Prevents new analysis
until current has been
completed.
Enables or disables to
display the XY format

10 SDS-RCM

SDS1000 Series

STATUS

ALL_STATUS?, ALST?

Query

Commands & Queries

DESCRIPTION The ALL_STATUS? Query reads and clears the

QUERY SYNTAX ALl_STatus?

RESPONSE FORMAT ALl_STatus

EXAMPLE The following instruction reads the contents of all the

ALST?

RELATED COMMANDS *CLS, CMR? , DDR? ,*ESR? , EXR ? , *STB? , URR?

contents of all status registers: STB, ESR, INR,
DDR, CMR, EXR and URR except for the
MAV bit (bit 6) of the STB register. For an
interpretation of the contents of each register,
refer to the appropriate status register.

The ALL_STATUS? Query is useful in a complete
overview of the state of the instrument.

STB,<value>,ESR,<value>,INR,<value>,DDR,<valu
e>,CMR,<value>,EXR,<value>,URR,<value>

<value> : = 0 to 65535

status registers:

Command message:

Response message:
ALST STB, 0, ESR, 52, INR, 5, DDR, 0, CMR, 4,
EXR, 24, URR, 0

SDS-RCM

11

SDS1000 Series

ACQUISITION

ARM_ACQUISITION, ARM

Command

DESCRIPTION The ARM_ACQUISITION command enables the

signal acquisition process by changing the
acquisition state (trigger mode) from “stopped” to
“single”.

COMMAND SYNTAX ARM acquisition

EXAMPLE The following command enables signal acquisition:

Command message:

ARM

RELATED COMMANDS STOP, *TRG, TRIG_MODE, WAIT

12 SDS-RCM

SDS1000 Series

ACQUISITION

ATTENUATION, ATTN

Command

/

Query

DESCRIPTION The ATTENUATION command selects the vertical

attenuation factor of the probe. Values of 1, 5, 10, 50,
100, 500, and 1000 may be specified.

The ATTENUATION? Query returns the

attenuation factor of the specified channel.

COMMAND SYNTAX <channel>: ATTeNuation <attenuation>

<channel> : = {C1, C2, C3, C4}

<attenuation>：= {1, 5, 10, 50, 100, 500, 1000}

QUERY SYNTAX <channel>: ATTeNuation?

RESPONSE FORMAT <channel>: ATTeNuation <attenuation>

EXAMPLE The following command sets to 100 the

attenuation factor of Channel 1:

Command message:

C1:ATTN 100

SDS-RCM

13

SDS1000 Series

S

AUTO_CALIBRATE, ACAL

Command

Query

/

DESCRIPTION The AUTO_CALIBRATE command is used to enable

or disable the quick calibration of the instrument.

The quick calibration may be disabled by issuing the
command ACAL OFF. Whenever it is convenient, a
*CAL? Query may be issued to fully calibrate the
oscilloscope.

The response to the AUTO_CAL IBRATE?
Query indicates whether quick -calibration is enabled.

The command is only used in the CFL series
instrument.

COMMAND SYNTAX Auto_CALibrate <state>

<state> : = {ON, OFF}

QUERY SYNTAX Auto_CALibrate?

RESPONSE FORMAT Auto_CALibrate <state>

EXAMPLE The following instruction disables quick-calibration:

Command message:

ACAL OFF

RELATED COMMANDS *CAL?

14 SDS-RCM

SDS1000 Series

ACQUISITION

AUTO_SETUP, ASET

Command

DESCRIPTION The AUTO_SETUP command attempts to identify

the waveform type and automatically adjusts controls
to produce a usable display of the input signal.

COMMAND SYNTAX AUTO_SETUP

EXAMPLE The following command instructs the oscilloscope

to perform an auto-setup:

Command message:
ASET

RELATED COMMANDS AUTTS

SDS-RCM

15

SDS1000 Series

ACQUISITION

AUTO_

TYPESET

, AUTTS

Command

Query

/

DESCRIPTION The AUTO_TYPESET command selects the

specified type of automatically adjusting which is
used to display.

COMMAND SYNTAX AUTO_TYPESET <type>

<type> : = {SP,MP,RS,DRP,RC}

SP means only one period to be displayed, MP means
multiple periods to be displayed, RS means the
waveform is triggered on the rise side, DRP means
the waveform is triggered on the drop side, and RC
means to go back to the state before auto set.

QUERY SYNTAX AUTO_TYPESET?

RESPONSE FORMAT AUTO_TYPESET <type>

EXAMPLE The following command sets the type of automatic

adjustment to multiple periods:

Command message:
AUTTS MP

RELATED COMMANDS ASET

16 SDS-RCM

SDS1000 Series

ACQUISITION

AVERAGE_ACQUIRE

,

AVGA

Command

Query

/

DESCRIPTION The AVERAGE_ACQUIRE command selects the

average times of average acquisition.

The response to the AVERAGE_ACQUIRE query

indicates the times of average acquisition.

COMMAND SYNTAX AVERAGE_ACQUIRE <time>

<time> : = {4, 16, 32, 64,128,256}

QUERY SYNTAX AVERAGE_ACQUIRE?

RESPONSE FORMAT AVERAGE_ACQUIRE <time>

EXAMPLE The following turns the average times of average

acquisition 16:

Command message:

AVGA 16

SDS-RCM

17

SDS1000 Series

ACQUISITION

BANDWIDTH

_LIMIT, BWL

Command

Query

/

DESCRIPTION BANDWIDTH_LIMIT enables or disables the

bandwidth-limiting low-pass filter. If the bandwidth

filters are on, it will limit the bandwidth to reduce
display noise. When you turn Bandwidth Limit ON,
the Bandwidth Limit value is set to 20 MHz. It also
filters the signal to reduce noise and other unwanted
high frequency components.

The response to the BANDWIDTH_LIMIT? Query
indicates whether the bandwidth filters are on or off.

COMMAND SYNTAX BandWidth_Limit <channel>, <mode>

[, <channel>, <mode> [, <channel>, <mode>

[, <channel>, <mode>]]]

<channel> : = {C1, C2, C3, C4}
<mode>：= {ON, OFF}

QUERY SYNTAX BandWidth_Limit?

RESPONSE FORMAT BandWidth_Limit <channel>, <mode> [, <channel>,

<mode> [, <channel>, <mode> [, <channel>,
<mode>]]]

EXAMPLE The following turns on the bandwidth filter for all

channels, when Global_BWL is on (as it is by default

The following turns the bandwidth filter on for
Channel 1only:

Command message:

BWL C1, ON

18 SDS-RCM

SDS1000 Series

MISCELLANEOUS

BUZZER, BUZZ

Command

Query

/

DESCRIPTION The BUZZER command enables or disables sound

switch.

The response to the BUZZER? query indicates

whether the sound switch is enabled.

COMMAND SYNTAX BUZZer <state>

<state>：= {ON, OFF}

QUERY SYNTAX BUZZER?

RESPONSE FORMAT BUZZER <state>

EXAMPLE Sending the following code will let the oscilloscope

turn on the sound switch.

Command message:
BUZZ ON

SDS-RCM

19

SDS1000 Series

MISCELLANEOUS

*CAL?

Query

DESCRIPTION The *CAL? query cause the oscilloscope to perform

an internal self-calibration and generates a response.

QUERY SYNTAX *CAL?

RESPONSE FORMAT *CAL <diagnostics>

<diagnostics> : = 0
0 = Calibration successful

EXAMPLE The following instruction forces a self-calibration:

Command message:

*CAL?

Response message:
*CAL 0

RELATED COMMANDS AUTO_CALIBRATE

20 SDS-RCM

SDS1000 Series

COMM_HEADER, C

HDR

Command

/

Query

DESCRIPTION The COMM_HEADER command controls the way

the oscilloscope formats responses to queries. There
are three response formats: LONG, in which
responses start with the long form of the header word;
SHORT, where responses start with the short form of
the header word; and OFF, for which headers are
omitted from the response and units in numbers are
suppressed.

Unless you request otherwise, the SHORT response
format is used.

This command does not affect the interpretation of
messages sent to the oscilloscope. Headers can be
sent in their long or short form regardless of the
COMM_HEADER setting.

Querying the vertical sensitivity of Channel 1 may
result in one of the following responses:

COMM_HEADER RESPONSE
LONG C1:VOLT_DIV 200E-3 V
SHORT C1:VDIV 200E-3 V
OFF 200E-3

COMMAND SYNTAX Comm_HeaDeR <mode>

<mode> : = {SHORT, LONG, OFF}

QUERY SYNTAX Comm_HeaDeR?

RESPONSE FORMAT Comm_HeaDeR <mode>
EXAMPLE The following code sets the response header format

to SHORT:

Command message:

CHDR SHORT

SDS-RCM

21

SDS1000 Series

STATUS

*CLS

Command

DESCRIPTION The *CLS command clears all the status data

registers.

COMMAND SYNTAX *CLS

EXAMPLE The following command causes all the status data

registers to be cleared:

Command message:
*CLS

RELATED COMMANDS ALL_STATUS, CMR, DDR, *ESR, EXR, *STB, URR

22 SDS-RCM

SDS1000 Series

CMR?

Query

DESCRIPTION The CMR? Query reads and clears the contents of

the Command error Register (CMR) see table
next page---which specifies the last syntax error
type detected by the instrument.

QUERY SYNTAX CMR?

RESPONSE FORMAT CMR <value>

<value> : = 0 to 14

EXAMPLE The following instruction reads the contents of

the CMR register:

Command message:

CMR?

Response message:

CMR 0

RELATED COMMANDS ALL_STATUS? ,*CLS

SDS-RCM

23

SDS1000 Series

ADDITIONAL INFORMATION

Command Error Status Register Structure (CMR)
Command Error Status Register Structure (CMR)

Value Description

1 Unrecognized command/query header
2 Invalid character
3 Invalid separator
4 Missing parameter
5 Unrecognized keyword
6 String error
7 Parameter cannot allowed
8 Command String Too Long

9 Query cannot allowed
10 Missing Query mask
11 Invalid parameter
12 Parameter syntax error
13 Filename too long

24 SDS-RCM

SDS1000 Series

MISCELLANEOUS

COMM_NET

, C

ONET

Command

Query

/

DESCRIPTION The COMM_NET command changes the IP

address of the oscilloscope’s internal network
interface.

The COMM_NET? query returns the IP address
of the oscilloscope’s internal net work interface.

COMMAND SYNTAX COMM_NET <ip_add0>, <ip_add1>,

<ip_add2>, <ip_add3>

< ip_add >:= 0 to 255

QUERY SYNTAX COMM_NET?

RESPONSE FORMAT COMM_NET <ip_add0>, <ip_add1>,

<ip_add2>, <ip_add3>

EXAMPLE This instruction will change the IP address to

10.11.0.230:

Command message:
CONET 10,11,0,230

SDS-RCM

25

SDS1000 Series

ACQUISITION

COUPLING, CPL

Command

Query

/

DESCRIPTION The COUPLING command selects the

coupling mode of the specified input channel.

The COUPLING? query returns the coupling
mode of the specified channel.

COMMAND SYNTAX <channel>: CouPLing <coupling>

<channel> : = {C1, C2, C3, C4}
<coupling> : = {A1M, A50, D1M, D50, GND}
The A of the <coupling> is alternating current.
The D of the <coupling> is direct current.1M
and 50 is the impedance of input. Some series
(CML) couldn’t have the set of input
impedance.

QUERY SYNTAX <channel>: CouPLing?

RESPONSE FORMAT <channel>: CouPLing <coupling>

EXAMPLE The following command sets the coupling of

Channel 2 to 50 ΩDC:

Command message:
C2: CPL D50

26 SDS-RCM

SDS1000 Series

CURSOR_MEASURE, CRMS

Command

Query

/

DESCRIPTION The CURSOR_MEASURE command

specifies the type of cursor or parameter
measurement to be displayed

The CURSOR_MEASURE? query indicates
which cursors or parameter measurements are
currently displayed.

Notation

HREL Selected tract-cursor mode

VREL Selected manual-cursor mode and set to voltage type

AUTO Selected auto mode

OFF Cursors and parameters off

COMMAND SYNTAX CuRsor_MeaSure <mode>

<mode>={ OFF,HREL,VREL,AUTO}

QUERY SYNTAX CuRsor_MeaSure?

RESPONSE FORMAT CuRsor_MeaSure <mode>

EXAMPLE The following command determines cursor

function is turned off:

Command message:
CRMS OFF

RELATED COMMANDS CURSOR_VALUE, PARAMETER_VALUE

SDS-RCM

27

SDS1000 Series

CURSOR

CURSOR_SET, CRST

Command

Query

/

DESCRIPTION The CURSOR_SET command allows the user

to position any one of the eight independent
cursors at a given screen location. The
positions of the cursors can be modified or
queried even if the required cursor is not
currently displayed on the screen. When
setting a cursor position, a trace must be
specified, relative to which the cursor will be
positioned.

The CURSOR_SET? Query indicates the
current position of the cursor(s). The values
returned depend on the grid type selected.

Notation

HREF The time value of curA under Track cursor mode
HDIF The time value of curB under Track cursor mode
VREF The volt-value of curA under manual cursor mode
VDIF The volt -value of curB under manual cursor mode
TREF The time value of curA under manual cursor mode
TDIF The time value of curB under manual cursor mode

COMMANDSYNTAX

<trace>:CuRsor_SeT<cursor>,<position>[,<c
ursor>,<position>,<cursor> ,<position>]

< trace > : = {C1, C2, C3, C4}
<cursor> :
={HREF,HDIF,VREF,VDIF,TREF,TDIF}
<position> ： = 0.1 to 11.9(or 17.9) DIV

(horizontal of track, the range of the

value is related to the size of the
screen)

<position>：= -4 to 4 DIV (vertical)
<position>：= -6(or -9) to 6 DIV (horizontal

of manual, the range of the value is

related to the size of the screen)

28 SDS-RCM

SDS1000 Series

QUERY SYNTAX <trace>: CuRsor_SeT? [<cursor>, …<cursor>]

<cursor> :={ HREF, HDIF, VREF, VDIF,

TREF, TDIF}

RESPONSE FORMAT <trace>:CuRsor_SeT <cursor>, <position> [,

<cursor>, <position>, <cursor>, <position>]

EXAMPLE The following command positions the VREF

and VDIF cursors at +3 DIV and −1 DIV
respectively, using C1 as a reference:

Command message:
C1: CRST VREF, 3DIV, VDIF, −1DIV

RELATED COMMANDS CURSOR_MEASURE, CURSOR_VALUE,

PARAMETER_VALUE

SDS-RCM

29

SDS1000 Series

CURSOR

CURSOR_VALUE?, CRVA?

Query

DESCRIPTION The CURSOR_VALUE? Query returns the

values measured by the specified cursors for a
given trace. (The PARAMETER_VALUE?
query is used to obtain measured waveform
parameter values.)

Notation

HREL the cursor value under track cursor mode
VREL the dalta volt-value under manual cursor mode

QUERY SYNTAX <trace>: CuRsor_Value? [<mode>,…<mode>]

<trace> : = { C1, C2, C3, C4}
<mode> : = { HREL, VREL }

RESPONSE FORMAT <trace> : CuRsor_Value HREL,

<B->T - A->T>,<B->V - A->V>,<A->T>,
<B->T>,
<(B->V - A->V)/(B->T - A->T)>
<trace> : CuRsor_Value VREL,<delta_vert>

EXAMPLE The following query reads the dalta volt value

under manual cursor mode (VREL) on
Channel 2:

Command message:
C2:CRVA? VREL

Response message:
C2:CuRsor_Value VREL 1.00V

RELATED COMMANDS CURSOR_SET, PARAMETER_VALUE

30 SDS-RCM