Rigol DS4000E Series Digital Oscilloscope Programming Guide

RIGOL

Programming Guide

DS4000E Series Digital Oscilloscope

Aug. 2016

RIGOL TECHNOLOGIES, INC.

RIGOL

Guaranty and Declaration

Copyright

© 2016 RIGOL TECHNOLOGIES, INC. All Rights Reserved.

Trademark Information

RIGOL is a registered trademark of RIGOL TECHNOLOGIES, INC.

Publication Number

PGA21101-1110

Software Version

00.02.03

Software upgrade might change or add product features. Please acquire the latest version of the manual from RIGOL website or contact RIGOL to upgrade the software.

Notices

RIGOL products are covered by P.R.C. and foreign patents, issued and pending.

RIGOL reserves the right to modify or change parts or all of the specifications and pricing policies at the company's sole decision.

Information in this publication replaces all previously released materials.

Information in this publication is subject to change without notice.

RIGOL shall not be liable for either incidental or consequential losses in connection with the furnishing, use, or performance of this manual as well as any information contained.

Any part of this document is forbidden to be copied, photocopied, or rearranged without prior written approval of RIGOL.

Product Certification

RIGOL guarantees that this product conforms to the national and industrial standards in China as well as the ISO9001:2008 standard and the ISO14001:2004 standard. Other international standard conformance certifications are in progress.

Contact Us

If you have any problem or requirement when using our products or this manual, please contact RIGOL. E-mail: [e-mail]

Website: www.rigol.com

DS4000E Programming Guide

I

RIGOL

Document Overview

This manual is your guide to programming RIGOL DS4000E series digital oscilloscope.

Tip

For the newest version of this manual, please download it from RIGOL official website (www.rigol.com).

Main Topics in this Manual:

Chapter 1 SCPI Command Overview

This chapter introduces the syntax, symbols, parameters, and abbreviation rules of the SCPI commands.

Chapter 2 Command System

This chapter introduces the syntax, function, parameters, and usage of each command.

Chapter 3 Programming Examples

This chapter illustrates how to control the DS4000E series digital oscilloscope by programming in Excel, LabVIEW, MATLAB, Visual Basic 6.0, and Visual C++ 6.0.

Format Conventions in this Manual:

1.Function Key

The key on the front panel is denoted by the format of “Key Name (Bold) + Text Box” in the manual. For example, Utility denotes the "Utility" key.

2.Menu Softkey

The menu softkey is denoted by the format of "Menu Name (Bold) + Character Shading" in the manual. For example, System denotes the "System" softkey under Utility.

3.Operation Procedures

The next step is denoted by the arrow key (""). For example, Utility  System denotes that first press Utility, and then press the System softkey.

Content Conventions in this Manual:

DS4000E series includes the following models. Unless otherwise specified, this manual takes DS4024E as an example to make a detailed introduction about the commands of DS4000E series.

Model	Bandwidth	No. of Channels
DS4024E	200 MHz	4
DS4014E	100 MHz	4

II	DS4000E Programming Guide

Contents	RIGOL
Contents
Guaranty and Declaration .........................................................................................................	I
Document Overview .................................................................................................................	II
Chapter 1 SCPI Command Overview ..................................................................................	1-1
Syntax .....................................................................................................................................	1-1
Symbol Description ...................................................................................................................	1-1
Parameter Type ........................................................................................................................	1-2
Command Abbreviation .............................................................................................................	1-2
Chapter 2 Command System...............................................................................................	2-1
:AUToscale ...............................................................................................................................	2-1
:CLEar......................................................................................................................................	2-2
:RUN........................................................................................................................................	2-2
:STOP ......................................................................................................................................	2-2
:SINGle ....................................................................................................................................	2-2
:TFORce...................................................................................................................................	2-3
:TLHAlf ....................................................................................................................................	2-3
:ACQuire Commands.................................................................................................................	2-4
:ACQuire:AALias.................................................................................................................	2-4
:ACQuire:AVERages............................................................................................................	2-4
:ACQuire:MDEPth...............................................................................................................	2-5
:ACQuire:SRATe?................................................................................................................	2-5
:ACQuire:TYPE...................................................................................................................	2-5
:BUS<n> Commands ................................................................................................................	2-7
:BUS<n>:DATA? ................................................................................................................	2-7
:BUS<n>:DISPlay ..............................................................................................................	2-8
:BUS<n>:EEXPort ..............................................................................................................	2-8
:BUS<n>:EVENt ................................................................................................................	2-8
:BUS<n>:FORMat..............................................................................................................	2-9
:BUS<n>:MODE ................................................................................................................	2-9
:BUS<n>:CAN (Option) ....................................................................................................	2-10
:BUS<n>:FLEXray (Option) ..............................................................................................	2-14
:BUS<n>:IIC (Option)......................................................................................................	2-17
:BUS<n>:PARallel............................................................................................................	2-20
:BUS<n>:RS232 (Option).................................................................................................	2-23
:BUS<n>:SPI (Option) .....................................................................................................	2-30
:CALCulate Commands............................................................................................................	2-38
:CALCulate:MODE ............................................................................................................	2-38
:CALCulate:ADD...............................................................................................................	2-39
:CALCulate:ADVanced ......................................................................................................	2-41
:CALCulate:DIVision .........................................................................................................	2-44
:CALCulate:FFT................................................................................................................	2-46
:CALCulate:LOGic.............................................................................................................	2-51
:CALCulate:MULTiply ........................................................................................................	2-54
:CALCulate:SUB ...............................................................................................................	2-56
:CALibrate Commands.............................................................................................................	2-58
:CALibrate:DATE?.............................................................................................................	2-58
:CALibrate:QUIT ..............................................................................................................	2-58
:CALibrate:STARt .............................................................................................................	2-58
:CALibrate:TIME? .............................................................................................................	2-59
:CHANnel<n> Commands .......................................................................................................	2-60
:CHANnel<n>:BVOLtage ..................................................................................................	2-60
:CHANnel<n>:BWLimit.....................................................................................................	2-60
:CHANnel<n>:COUPling ...................................................................................................	2-61
:CHANnel<n>:CSTart .......................................................................................................	2-61

DS4000E Programming Guide

III

RIGOL	Contents
:CHANnel<n>:DISPlay......................................................................................................	2-62
:CHANnel<n>:IMPedance .................................................................................................	2-62
:CHANnel<n>:INVert........................................................................................................	2-62
:CHANnel<n>:OFFSet.......................................................................................................	2-63
:CHANnel<n>:PEND.........................................................................................................	2-63
:CHANnel<n>:PROBe .......................................................................................................	2-64
:CHANnel<n>:SCALe........................................................................................................	2-64
:CHANnel<n>:TCALibrate .................................................................................................	2-65
:CHANnel<n>:TYPE? ........................................................................................................	2-65
:CHANnel<n>:UNITs ........................................................................................................	2-65
:CHANnel<n>:VERNier .....................................................................................................	2-66
:CURSor Commands ................................................................................................................	2-67
:CURSor:MODE ................................................................................................................	2-68
:CURSor:MANual ..............................................................................................................	2-69
:CURSor:TRACk................................................................................................................	2-75
:DISPlay Commands................................................................................................................	2-81
:DISPlay:CLEar.................................................................................................................	2-81
:DISPlay:DATA?................................................................................................................	2-81
:DISPlay:GBRightness.......................................................................................................	2-82
:DISPlay:GRADing:TIME ...................................................................................................	2-82
:DISPlay:GRID .................................................................................................................	2-83
:DISPlay:MPERsistence .....................................................................................................	2-83
:DISPlay:TYPE..................................................................................................................	2-84
:DISPlay:WBRightness ......................................................................................................	2-84
:EXT Commands .....................................................................................................................	2-85
:EXT:PEND .......................................................................................................................	2-85
:EXT:CSTart......................................................................................................................	2-85
:FUNCtion Commands .............................................................................................................	2-86
:FUNCtion:WRMode..........................................................................................................	2-86
:FUNCtion:WRECord .........................................................................................................	2-87
:FUNCtion:WREPlay ..........................................................................................................	2-89
:FUNCtion:WANalyze ........................................................................................................	2-93
IEEE 488.2 Common Commands ............................................................................................	2-100
*CLS..............................................................................................................................	2-100
*ESE..............................................................................................................................	2-100
*ESR?............................................................................................................................	2-101
*IDN?............................................................................................................................	2-101
*OPC .............................................................................................................................	2-101
*OPC? ...........................................................................................................................	2-101
*RST .............................................................................................................................	2-102
*SRE .............................................................................................................................	2-102
*STB?............................................................................................................................	2-102
*TST?............................................................................................................................	2-103
:LAN Commands ...................................................................................................................	2-104
:LAN:APPLy ....................................................................................................................	2-104
:LAN:AUToip...................................................................................................................	2-104
:LAN:DHCP ....................................................................................................................	2-105
:LAN:DNS ......................................................................................................................	2-105
:LAN:GATeway................................................................................................................	2-106
:LAN:INITiate.................................................................................................................	2-106
:LAN:IPADdress..............................................................................................................	2-106
:LAN:MAC?.....................................................................................................................	2-107
:LAN:MANual..................................................................................................................	2-107
:LAN:SMASk...................................................................................................................	2-108
:LAN:STATus?.................................................................................................................	2-108
:LAN:VISA? ....................................................................................................................	2-108
:MASK Commands.................................................................................................................	2-109
:MASK:CREate................................................................................................................	2-109

IV	DS4000E Programming Guide

Contents	RIGOL
:MASK:DATA ..................................................................................................................	2-109
:MASK:ENABle ...............................................................................................................	2-110
:MASK:FAILed? ..............................................................................................................	2-110
:MASK:MDISplay............................................................................................................	2-110
:MASK:OPERate .............................................................................................................	2-111
:MASK:OUTPut...............................................................................................................	2-111
:MASK:PASSed? .............................................................................................................	2-112
:MASK:RESet .................................................................................................................	2-112
:MASK:SOOutput ...........................................................................................................	2-112
:MASK:SOURce ..............................................................................................................	2-113
:MASK:TOTal? ................................................................................................................	2-113
:MASK:X........................................................................................................................	2-113
:MASK:Y ........................................................................................................................	2-114
:MEASure Commands............................................................................................................	2-115
:MEASure:ADISplay........................................................................................................	2-116
:MEASure:AMSource.......................................................................................................	2-116
:MEASure:AREA .............................................................................................................	2-117
:MEASure:CLEar.............................................................................................................	2-117
:MEASure:COUNter:SOURce ...........................................................................................	2-118
:MEASure:COUNter:VALue? ............................................................................................	2-118
:MEASure:CREGion:CAX .................................................................................................	2-118
:MEASure:CREGion:CBX .................................................................................................	2-119
:MEASure:FDELay ..........................................................................................................	2-119
:MEASure:F2RDelay .......................................................................................................	2-121
:MEASure:FPHase ..........................................................................................................	2-122
:MEASure:F2RPhase.......................................................................................................	2-124
:MEASure:FREQuency ....................................................................................................	2-125
:MEASure:FTIMe............................................................................................................	2-126
:MEASure:HISTory:DISPlay .............................................................................................	2-128
:MEASure:HISTory:DMODe .............................................................................................	2-128
:MEASure:MARea ...........................................................................................................	2-129
:MEASure:MPARea .........................................................................................................	2-130
:MEASure:NDUTy ...........................................................................................................	2-132
:MEASure:NWIDth .........................................................................................................	2-133
:MEASure:OVERshoot.....................................................................................................	2-134
:MEASure:PDUTy............................................................................................................	2-136
:MEASure:PERiod ...........................................................................................................	2-137
:MEASure:PREShoot.......................................................................................................	2-138
:MEASure:PVRMs ...........................................................................................................	2-140
:MEASure:PWIDth..........................................................................................................	2-141
:MEASure:RECover.........................................................................................................	2-143
:MEASure:RDELay..........................................................................................................	2-143
:MEASure:R2FDelay .......................................................................................................	2-145
:MEASure:RPHase ..........................................................................................................	2-146
:MEASure:R2FPhase.......................................................................................................	2-148
:MEASure:RTIMe............................................................................................................	2-149
:MEASure:SETup:DSA.....................................................................................................	2-151
:MEASure:SETup:DSB.....................................................................................................	2-151
:MEASure:SETup:MAX ....................................................................................................	2-151
:MEASure:SETup:MID.....................................................................................................	2-151
:MEASure:SETup:MIN.....................................................................................................	2-151
:MEASure:SETup:PSA .....................................................................................................	2-152
:MEASure:SETup:PSB .....................................................................................................	2-152
:MEASure:SETup:TYPE ...................................................................................................	2-153
:MEASure:STATistic:DISPlay............................................................................................	2-153
:MEASure:STATistic:MODE..............................................................................................	2-153
:MEASure:STATistic:RESet ..............................................................................................	2-154
:MEASure:SOURce .........................................................................................................	2-154

DS4000E Programming Guide

V

RIGOL	Contents
:MEASure:VAMP .............................................................................................................	2-155
:MEASure:VAVG..............................................................................................................	2-156
:MEASure:VBASe ............................................................................................................	2-158
:MEASure:VMAX .............................................................................................................	2-159
:MEASure:VMIN..............................................................................................................	2-161
:MEASure:VPP................................................................................................................	2-162
:MEASure:VRMS .............................................................................................................	2-164
:MEASure:VTOP..............................................................................................................	2-165
:RECall Commands................................................................................................................	2-167
:RECall:MTESt ................................................................................................................	2-167
:RECall:REFerence ..........................................................................................................	2-167
:RECall:SETup ................................................................................................................	2-168
:RECall:TRACe................................................................................................................	2-168
:RECall:WAVeform ..........................................................................................................	2-169
:REFerence Commands..........................................................................................................	2-170
:REFerence:COLor ..........................................................................................................	2-170
:REFerence:CURRent?.....................................................................................................	2-170
:REFerence:DISPlay........................................................................................................	2-171
:REFerence:RESet...........................................................................................................	2-171
:REFerence:SAVe............................................................................................................	2-171
:REFerence:SOURce .......................................................................................................	2-172
:REFerence:VOFFset .......................................................................................................	2-172
:REFerence:VSCale .........................................................................................................	2-172
:REFerence<n>:CURRent ...............................................................................................	2-173
:REFerence<n>:ENABle..................................................................................................	2-173
:SAVE Commands .................................................................................................................	2-174
:SAVE:CSV[:STARt].........................................................................................................	2-174
:SAVE:CSV:FACTors ........................................................................................................	2-174
:SAVE:CSV:LENGth .........................................................................................................	2-175
:SAVE:FORMat ...............................................................................................................	2-175
:SAVE:IMAGe[:STARt].....................................................................................................	2-176
:SAVE:IMAGe:TYPE.........................................................................................................	2-176
:SAVE:IMAGe:FACTors ....................................................................................................	2-176
:SAVE:SETup[:STARt] .....................................................................................................	2-177
:SAVE:TRACe[:STARt].....................................................................................................	2-177
:SAVE:WAVeform[:STARt] ...............................................................................................	2-178
:SAVE:REFerence[:STARt] ...............................................................................................	2-178
:SAVE:MTESt[:STARt] .....................................................................................................	2-179
:SYSTem Commands .............................................................................................................	2-180
:SYSTem:AOUTput..........................................................................................................	2-180
:SYSTem:AUToscale ........................................................................................................	2-181
:SYSTem:BEEPer ............................................................................................................	2-181
:SYSTem:DATE ...............................................................................................................	2-182
:SYSTem:ERRor[:NEXT]?.................................................................................................	2-182
:SYSTem:ETIMpedence...................................................................................................	2-182
:SYSTem:EXPand............................................................................................................	2-183
:SYSTem:GAMount?........................................................................................................	2-183
:SYSTem:GPIB................................................................................................................	2-183
:SYSTem:LANGuage........................................................................................................	2-184
:SYSTem:OPTion:INSTall.................................................................................................	2-184
:SYSTem:OPTion:UNINSTall ............................................................................................	2-184
:SYSTem:PON ................................................................................................................	2-185
:SYSTem:PSTatus ...........................................................................................................	2-185
:SYSTem:RAMount? ........................................................................................................	2-185
:SYSTem:RCLOck............................................................................................................	2-186
:SYSTem:RESet ..............................................................................................................	2-186
:SYSTem:SETup..............................................................................................................	2-186
:SYSTem:SSAVer:TIME....................................................................................................	2-187

VI	DS4000E Programming Guide

Contents	RIGOL
:SYSTem:TIME...............................................................................................................	2-187
:SYSTem:UDEVice ..........................................................................................................	2-188
:SYSTem:VERSion?.........................................................................................................	2-188
:TIMebase Commands ..........................................................................................................	2-189
:TIMebase:DELay:ENABle...............................................................................................	2-189
:TIMebase:DELay:OFFSet ...............................................................................................	2-189
:TIMebase:DELay:SCALe ................................................................................................	2-190
:TIMebase:HREF:MODE..................................................................................................	2-190
:TIMebase:HREF:POSition ..............................................................................................	2-191
:TIMebase:MODE...........................................................................................................	2-191
:TIMebase:VERNier ........................................................................................................	2-191
:TIMebase:XY1:DISPlay..................................................................................................	2-192
:TIMebase:XY2:DISPlay..................................................................................................	2-192
:TIMebase[:MAIN]:OFFSet..............................................................................................	2-192
:TIMebase[:MAIN]:SCALe...............................................................................................	2-193
:TRIGger Commands ............................................................................................................	2-194
:TRIGger:COUPling ........................................................................................................	2-194
:TRIGger:HOLDoff .........................................................................................................	2-195
:TRIGger:MODE.............................................................................................................	2-195
:TRIGger:STATus?..........................................................................................................	2-195
:TRIGger:SWEep............................................................................................................	2-196
:TRIGger:NREJect ..........................................................................................................	2-196
:TRIGger:CAN................................................................................................................	2-197
:TRIGger:EDGe..............................................................................................................	2-201
:TRIGger:IIC .................................................................................................................	2-203
:TRIGger:PATTern ..........................................................................................................	2-207
:TRIGger:PULSe.............................................................................................................	2-209
:TRIGger:RUNT .............................................................................................................	2-212
:TRIGger:NEDGe............................................................................................................	2-216
:TRIGger:RS232.............................................................................................................	2-218
:TRIGger:SLOPe.............................................................................................................	2-222
:TRIGger:SPI .................................................................................................................	2-226
:TRIGger:USB ................................................................................................................	2-231
:TRIGger:VIDeo.............................................................................................................	2-234
:TRIGger:FLEXray ..........................................................................................................	2-237
:WAVeform Commands .........................................................................................................	2-239
:WAVeform:BEGin ..........................................................................................................	2-240
:WAVeform:DATA?..........................................................................................................	2-240
:WAVeform:END.............................................................................................................	2-242
:WAVeform:FORMat .......................................................................................................	2-242
:WAVeform:MODE..........................................................................................................	2-243
:WAVeform:POINts.........................................................................................................	2-243
:WAVeform:PREamble?...................................................................................................	2-244
:WAVeform:RESet ..........................................................................................................	2-244
:WAVeform:SOURce .......................................................................................................	2-245
:WAVeform:STARt ..........................................................................................................	2-245
:WAVeform:STATus? .......................................................................................................	2-246
:WAVeform:STOP ...........................................................................................................	2-246
:WAVeform:XINCrement? ...............................................................................................	2-246
:WAVeform:XORigin?......................................................................................................	2-247
:WAVeform:XREFerence? ................................................................................................	2-247
:WAVeform:YINCrement? ...............................................................................................	2-247
:WAVeform:YORigin?......................................................................................................	2-248
:WAVeform:YREFerence? ................................................................................................	2-248
Chapter 3 Programming Examples .....................................................................................	3-1
Programming Preparations ........................................................................................................	3-1
Excel Programming Example......................................................................................................	3-2

DS4000E Programming Guide

VII

RIGOL	Contents
LabVIEW Programming Example ................................................................................................	3-7
MATLAB Programming Example................................................................................................	3-11
Visual Basic 6.0 Programming Example.....................................................................................	3-13
Visual C++ 6.0 Programming Example .....................................................................................	3-15

VIII	DS4000E Programming Guide

Chapter 1 SCPI Command Overview

RIGOL

Chapter 1 SCPI Command Overview

This chapter introduces the syntax, symbols, parameters, and abbreviation rules of the SCPI commands.

Contents in this chapter:

Syntax

Symbol Description

Parameter Type

Command Abbreviation

Syntax

The SCPI commands provide a hierarchical tree structure, and consist of multiple subsystems. Each command subsystem consists of one root keyword and one or more sub-keywords. The command line usually starts with a colon; the keywords are separated by colons, and following the keywords are the parameter settings available. The command ending with a question mark indicates querying a certain function. The keywords of the command and the first parameter is separated by a space.

For example, :CALCulate:ADVanced:EXPRession <str> :CALCulate:ADVanced:EXPRession?

CALCulate is the root keyword of the command. ADVanced is the second-level keyword, and EXPRession is the third-level keyword. The command line starts with a colon, and a colon is also used to separate the multiple-level keywords. <str> represents the parameters available for setting. The command line ending with a question mark indicates that it is a query command.

The command :CALCulate:ADVanced:EXPRession and the parameter <str> are separated by a space.

In some commands with multiple parameters, commas are often used to separate these parameters. For example,

:SYSTem:DATE <year>,<month>,<day>.

Symbol Description

1.Braces { }

The contents enclosed in the braces are parameter options, which are usually separated by the vertical bar "|". When using the command, you must select one of the parameter options.

2.Vertical Bar |

The vertical bar is used to separate multiple parameter options. When using the command, you must select one of the parameter options.

3.Square Brackets [ ]

The contents in the square brackets can be omitted.

4.Angle Brackets < >

The parameter enclosed in the angle brackets must be replaced by an effective value.

DS4000E Programming Guide

1-1

RIGOL

Chapter 1 SCPI Command Overview

Parameter Type

1.Bool

The available values for the parameter is 1 (ON) or 0 (OFF). For example, :MEASure:ADISplay <bool>

:MEASure:ADISplay?

Wherein, <bool> can be set to {{1|ON}|{0|OFF}}. The query returns 1 or 0.

2.Discrete

The parameter can be any of the values listed. For example, :ACQuire:TYPE <type>

:ACQuire:TYPE?

Wherein, <type> can be set to NORMal, AVERages, PEAK, or HRESolution. The query returns NORM, AVER, PEAK, or HRES.

3.Integer

Unless otherwise specified, the parameter can be any integer within the effective value range. Do not set the parameter to a decimal or in scientific notation, otherwise, errors will occur. For example, :DISPlay:GBRightness <bright>

:DISPlay:GBRightness?

Wherein, <brightness> can be set to an integer between 0 and 100. The query returns an integer between 0 and 100.

4.Real

The parameter can be any real-value (in decimal form or in scientific notation) within the effective value range. For example,

:FUNCtion:WREPlay:INTerval <interval> :FUNCtion:WREPlay:INTerval?

Wherein, <interval> can be set to any real number between 0.0000001 and 10; or any real number between (1.000000e-07, namely 100 ns) and (0.1e+02, namely 10 s).

The query returns a real number in scientific notation.

5.ASCII String

The parameter can be the combinations of ASCII characters. For example, :CALCulate:ADVanced:EXPRession <str> :CALCulate:ADVanced:EXPRession?

Wherein, <str> can be set to a legitimate expression that consists of any combinations of CH1, CH2, CH3, CH4, and operators. For example, CH1+CH2.

The query returns in strings.

Command Abbreviation

All the commands are case-insensitive. The commands can be all input in uppercase letters or in lowercase letters. For abbreviations, you must enter all the uppercase letters that exist in the command syntax.

For example, :MEASure:ADISplay? can be abbreviated to :MEAS:ADIS?

1-2	DS4000E Programming Guide

Chapter 2 Command System

RIGOL

Chapter 2 Command System

This chapter introduces the syntax, function, parameters, and usage of each DS4000E command.

Contents in this chapter:

:AUToscale

:CLEar

:RUN

:STOP

:SINGle

:TFORce

:TLHAlf

:ACQuire Commands

:BUS<n> Commands

:CALCulate Commands

:CALibrate Commands

:CHANnel<n> Commands

:CURSor Commands

:DISPlay Commands

:EXT Commands

:FUNCtion Commands

IEEE 488.2 Common Commands

:LAN Commands

:MASK Commands

:MEASure Commands

:RECall Commands

:REFerence Commands

:SAVE Commands

:SYSTem Commands

:TIMebase Commands

:TRIGger Commands

:WAVeform Commands

Note:

1.Unless otherwise specified, the descriptions and parameter range in this manual all take DS4024E as an example.

2.For the parameter setting command (time, frequency, amplitude, etc.), the digital oscilloscope can only recognize the numbers, unable to recognize the unit sent together with them. The unit of the parameter is a default one. For the default units of various parameters, refer to the descriptions for the specified command.

:AUToscale

Syntax

:AUToscale

Description

Enables the waveform auto setting function. The oscilloscope will automatically adjust the parameters such as vertical scale, horizontal time base, and trigger mode according to the input signal to realize an optimum

waveform display. This command functions the same as the AUTO key on the front panel.

Remarks

When the waveform auto setting function is disabled (refer to the :SYSTem:AUToscale command), this command is invalid.

DS4000E Programming Guide

2-1

RIGOL

Chapter 2 Command System

When the pass/fail test function is enabled (refer to the :MASK:ENABle command), this command is invalid.

The waveform auto setting function requires that the frequency of sine waveform is no less than 20 Hz, the duty cycle is greater than 1%, and the amplitude is at least 20 mVpp. Otherwise, the waveform auto setting function may be invalid.

:CLEar

Syntax

:CLEar

Description

Clears all the waveforms on the screen. If the oscilloscope is in the RUN state, after the waveform data is cleared, new waveform data will be displayed. This command functions the same as the CLEAR key on the front panel.

:RUN

:STOP

Syntax

:RUN

:STOP

Description

The :RUN command starts the oscilloscope and the :STOP command stops the oscilloscope. This command functions the same as the Run/Stop key on the front panel.

Remarks

If the oscilloscope is in a single trigger mode (refer to the :SINGle command), you can use the :RUN command to set the trigger mode of the oscilloscope to "Auto", and keep the oscilloscope in the "Run" state. If the oscilloscope is in a single trigger mode (refer to the :SINGle command) and in WAIT state, you can use the :STOP command to set the trigger mode of the oscilloscope to "Auto", and keep the oscilloscope in the "Stop" state.

:SINGle

Syntax

:SINGle

Description

Sets the trigger mode of the oscilloscope to "Single". This command functions the same as the Single key on the front panel.

Remarks

In the single trigger mode, the oscilloscope performs a single trigger when the trigger conditions are met and then it stops. You can use the :TFORce command to generate a trigger by force.

If the oscilloscope is in a single trigger mode, you can use the :RUN command to set the trigger mode of the oscilloscope to "Auto", and keep the oscilloscope in the "Run" state.

If the oscilloscope is in a single trigger mode and in WAIT state, you can use the :STOP command to set the trigger mode of the oscilloscope to "Auto", and keep the oscilloscope in the "Stop" state.

2-2	DS4000E Programming Guide

Chapter 2 Command System

RIGOL

:TFORce

Syntax

:TFORce

Description

Generates a trigger signal forcefully. This command is only applicable to the normal and single trigger modes, refer to the :TRIGger:SWEep command. This command functions the same as the FORCE key in the trigger control area of the front panel.

:TLHAlf

Syntax

:TLHAlf

Description

Sets the trigger level to the vertical midpoint of the amplitude of a trigger signal. This command functions the same as the 50% key in the trigger control area of the front panel.

DS4000E Programming Guide

2-3

RIGOL

Chapter 2 Command System

:ACQuire Commands

Command List[1]:

:ACQuire:AALias

:ACQuire:AVERages

:ACQuire:MDEPth

:ACQuire:SRATe?

:ACQuire:TYPE

Note[1]: In the "Command List" in this manual, the query commands and the parameters in the setting commands are omitted. You can refer to the complete introductions of the commands in the body of the text based on the keywords listed here.

:ACQuire:AALias

Syntax

:ACQuire:AALias <bool> :ACQuire:AALias?

Description

Enables or disables the anti-aliasing function of the oscilloscope; or queries the on/off status of the anti-aliasing function.

Parameter
Name		Type	Range	Default
<bool>		Bool	{{1|ON}|{0|OFF}}	0|OFF

Return Format

The query returns 1 or 0.

:ACQuire:AVERages

Syntax

:ACQuire:AVERages <count> :ACQuire:AVERages?

Description

Sets or queries the number of averages in the average acquisition mode (refer to the :ACQuire:TYPE command).

Parameter
Name		Type	Range	Default
<count>		Integer	2n (n indicates an integer between 1 and 13).	2

Remarks

In the average acquisition mode, the oscilloscope will acquire the waveform samples for several times, then make an average on the waveforms, so as to lower the random noises of the input signals and increase its vertical resolution. Greater number of averages can lower the noises and increase the vertical resolution, but will also slow the response of the displayed waveform to the waveform changes.

Return Format

The query returns an integer.

2-4	DS4000E Programming Guide

Chapter 2 Command System

RIGOL

:ACQuire:MDEPth

Syntax

:ACQuire:MDEPth <mdep> :ACQuire:MDEPth?

Description

Sets or queries the memory depth of the oscilloscope (namely the number of waveform points that can be stored through sampling in a single trigger). The default unit is pts (points).

Parameter
Name	Type	Range	Default
<mdep>	Discrete	AUTO|7000|70000|700000|7000000	AUTO

Remarks

The formula below describes the relationship among memory depth, sample rate, and waveform length: memory depth = sample rate x waveform length

Wherein, waveform length = horizontal time base x number of grids in the horizontal direction on the screen. For DS4000E, the number of grids in the horizontal direction on the screen is a fixed value 14. When <mdep> is set to "AUTO", the oscilloscope will select the memory depth automatically according to the current sample rate and horizontal time base (refer to the :TIMebase[:MAIN]:SCALe command).

Return Format

The query returns an integer.

:ACQuire:SRATe?

Syntax

:ACQuire:SRATe?

Description

Queries the current sample rate of the oscilloscope. The default unit is Sa/s.

Return Format

The query returns the sample rate in scientific notation.

:ACQuire:TYPE

Syntax

:ACQuire:TYPE <type> :ACQuire:TYPE?

Description

Sets or queries the data acquisition mode of the oscilloscope.

Parameter
Name	Type	Range	Default
<type>	Discrete	{NORMal|AVERages|PEAK|HRESolution}	NORMal

Remarks

NORMal: In this mode, the oscilloscope samples the signal at the same interval to reconstruct the waveform. For most of the waveforms, this mode can realize the best display effects.

AVERages: In this mode, the oscilloscope will acquire the waveform samples for several times, then

DS4000E Programming Guide

2-5

RIGOL

Chapter 2 Command System

make an average on the waveforms, so as to lower the random noises of the input signals and increase its vertical resolution. You can use the :ACQuire:AVERages command to set the number of averages in this mode.

PEAK: The oscilloscope samples the maximum and minimum value of the signal at the fixed sampling interval to acquire the signal envelope or the narrow pulses that might be lost. This mode can avoid the signal aliasing, but produces greater noises.

HRESolution: The oscilloscope will average the adjacent sample points of the sample waveform to lower the random noises of the input signals and display much more smoother waveforms. If the sample rate of the digital convertor is greater than the storage rate of the acquisition memory, this mode is often adopted.

Return Format

The query returns NORM, AVER, PEAK, or HRES.

2-6	DS4000E Programming Guide

Chapter 2 Command System

RIGOL

:BUS<n> Commands

Command List:

:BUS<n>:DATA?

:BUS<n>:DISPlay

:BUS<n>:EEXPort

:BUS<n>:EVENt

:BUS<n>:FORMat

:BUS<n>:MODE

:BUS<n>:CAN (Option)

:BUS<n>:FLEXray (Option)

:BUS<n>:IIC (Option)

:BUS<n>:PARallel

:BUS<n>:RS232 (Option)

:BUS<n>:SPI (Option)

:BUS<n>:DATA?

Syntax

:BUS<n>:DATA?

Description

Reads the data in the decoding event table.

Parameter
Name		Type	Range	Default
<n>		Discrete	{1|2}	--

Return Format

Returns the data in the decoding event table with the following formats. #9000000077Parallel

Time,Data, -9.3508796E-04,1, 6.5072008E-05,1, 1.0636000E-03,1,

Wherein, "#9000000077" is the TMC data block header, which is followed by the data in the event table. The 9-digit data following #9 in the data block header indicates the number of bytes of the effective data. "Parallel" indicates the decoding type. The available decoding type can also be RS232, I2C, SPI, CAN, or Flex. The data are separated by colons, and will automatically switch to the next line according to the line length limit in the decoding list. The data value is related to the set numeral system.

Note: You can save all the data except TMC data block header (#9) and decoding type (Parallel) as the "*.csv" file and view the data in the form of a list.

DS4000E Programming Guide

2-7

RIGOL

Chapter 2 Command System

:BUS<n>:DISPlay

Syntax

:BUS<n>:DISPlay <bool> :BUS<n>:DISPlay?

Description

Enables or disables the display of the specified decoding bus; or queries the on/off display status of the specified decoding bus.

Parameter
Name		Type	Range	Default
<n>		Discrete	{1|2}	--
<bool>		Bool	{{1|ON}|{0|OFF}}	0|OFF

Return Format

The query returns 1 or 0.

:BUS<n>:EEXPort

Syntax

:BUS<n>:EEXPort

Description

Exports the decoding information in the specified decoding bus event table to the external USB storage device (if detected) in CSV form.

Parameter
Name	Type	Range	Default
<n>	Discrete	{1|2}	--

:BUS<n>:EVENt

Syntax

:BUS<n>:EVENt <bool> :BUS<n>:EVENt?

Description

Enables or disables the event table of the specified decoding bus; or queries the on/off status of the specified decoding bus event table.

Parameter

Name		Type	Range	Default
<n>		Discrete	{1|2}	--
<bool>		Bool	{{1|ON}|{0|OFF}}	0|OFF

Remarks

Before using the command, enable the display of the specified decoding bus (refer to the :BUS<n>:DISPlay command).

Return Format

The query returns 1 or 0.

2-8	DS4000E Programming Guide

Chapter 2 Command System

RIGOL

:BUS<n>:FORMat

Syntax

:BUS<n>:FORMat <format> :BUS<n>:FORMat?

Description

Sets or queries the display format of decoding data of the specified decoding bus.

Parameter
Name	Type	Range	Default
<n>	Discrete	{1|2}	--
<format>	Discrete	{HEX|DEC|BIN|ASCii}	HEX

Return Format

The query returns HEX, DEC, BIN, or ASC.

:BUS<n>:MODE

Syntax

:BUS<n>:MODE <mode> :BUS<n>:MODE?

Description

Sets or queries the decoding type of the specified decoding bus.

Parameter
Name		Type	Range	Default
<n>		Discrete	{1|2}	--
<mode>		Discrete	{PARallel|RS232|IIC|SPI|CAN|FLEXray}	PARallel

Remarks

RS232 decoding, IIC decoding, SPI decoding, CAN decoding, and FlexRay decoding are optional functions. This command can be used only when you have installed these options.

Return Format

The query returns PAR, RS232, IIC, SPI, CAN, or FLEX.

DS4000E Programming Guide

2-9

RIGOL

Chapter 2 Command System

:BUS<n>:CAN (Option)

Command List:

:BUS<n>:CAN:BAUD

:BUS<n>:CAN:BUSer

:BUS<n>:CAN:OFFSet

:BUS<n>:CAN:SOURce

:BUS<n>:CAN:SPOint

:BUS<n>:CAN:STYPe

:BUS<n>:CAN:THReshold

:BUS<n>:CAN:BAUD

Syntax

:BUS<n>:CAN:BAUD <baud> :BUS<n>:CAN:BAUD?

Description

Sets or queries the signal rate of CAN decoding on the specified bus. The default unit is b/s.

Parameter
Name			Type	Range	Default
<n>			Discrete	{1|2}	--
<baud>			Discrete	{100000|125000|250000|400000|500000|800000|1000000|USER}	500000

Remarks

When <baud> is set to "USER", you can use the :BUS<n>:CAN:BUSer command to self-define the signal rate of CAN decoding on the specified bus.

Return Format

The query returns 100000, 125000, 250000, 400000, 500000, 800000, 1000000, or USER.

:BUS<n>:CAN:BUSer

Syntax

:BUS<n>:CAN:BUSer <baud> :BUS<n>:CAN:BUSer?

Description

Sets or queries the user-defined signal rate of CAN decoding on the specified bus. The default unit is b/s.

Parameter
Name			Type	Range	Default
<n>			Discrete	{1|2}	--
<baud>			Integer	10000 to 1000000	500000

Return Format

The query returns an integer between 10000 and 1000000.

2-10	DS4000E Programming Guide

Chapter 2 Command System

RIGOL

:BUS<n>:CAN:OFFSet

Syntax

:BUS<n>:CAN:OFFSet <val> :BUS<n>:CAN:OFFSet?

Description

Sets or queries the vertical position of CAN decoding data line on the specified bus.

Parameter
Name		Type	Range	Default
<n>		Discrete	{1|2}	--
<val>		Integer	Refer to Remarks	0

Remarks

Before using the command, enable the display of the specified decoding bus (refer to the :BUS<n>:DISPlay command).

The range of <val> is related to the screen display mode and the on/off status of the statistic function (refer to the :MEASure:STATistic:DISPlay command).

When the display mode is "Full Screen" and the statistics function is disabled, the <val> parameter ranges from -166 to +148.

When the display mode is "Full Screen" and the statistics function is enabled, the <val> parameter ranges from -163 to +143.

When the display mode is "Split" (refer to the :TIMebase:DELay:ENABle and :CALCulate:FFT:SPLit command), the <val> parameter ranges from -103 to +52.

When the data line that displays the decoding is located in the middle part of the screen, <val> is 0; when it is located above the middle part of the screen, <val> is a positive value; when it is located below the middle part of the screen, <val> is a negative value.

Return Format

The query returns an integer.

:BUS<n>:CAN:SOURce

Syntax

:BUS<n>:CAN:SOURce <source> :BUS<n>:CAN:SOURce?

Description

Sets or queries the source channel of CAN decoding on the specified bus.

Parameter
Name	Type	Range	Default
<n>	Discrete	{1|2}	--
<source>	Discrete	{CHANnel1|CHANnel2|CHANnel3|CHANnel4}	CHANnel1

Return Format

The query returns CHAN1, CHAN2, CHAN3, or CHAN4.

DS4000E Programming Guide

2-11

RIGOL

Chapter 2 Command System

:BUS<n>:CAN:SPOint

Syntax

:BUS<n>:CAN:SPOint <spo> :BUS<n>:CAN:SPOint?

Description

Sets or queries the sample point position of CAN decoding on the specified bus (expressed in %).

Parameter
Name	Type	Range	Default
<n>	Discrete	{1|2}	--
<spo>	Integer	5 to 95	50

Remarks

The sample point is within the range of the bit time. The oscilloscope samples the bit level at the sample point. The sample point position is expressed as the ratio of "time from the bit start to the sample point" to "bit time", in %.

Return Format

The query returns an integer between 5 and 95.

:BUS<n>:CAN:STYPe

Syntax

:BUS<n>:CAN:STYPe <stype> :BUS<n>:CAN:STYPe?

Description

Sets or queries the signal type of CAN decoding on the specified bus.

Parameter
Name		Type	Range	Default
<n>		Discrete	{1|2}	--
<stype>		Discrete	{RX|TX|CANH|CANL|DIFFerential}	RX

Remarks

RX: indicates the Receive signal from the CAN bus transceiver.

TX: indicates the Transmit signal from the CAN bus transceiver.

CANH: indicates the actual CAN_H differential bus signal.

CANL: indicates the actual CAN_L differential bus signal.

DIFFerential: indicates the CAN differential bus signal connected to an analog channel by using a differential probe. The positive polarity of the differential probe connects the CAN_H bus signal, and the negative polarity connects the CAN_L bus signal.

Return Format

The query returns RX, TX, CANH, CANL, or DIFF.

2-12	DS4000E Programming Guide

Chapter 2 Command System

RIGOL

:BUS<n>:CAN:THReshold

Syntax

:BUS<n>:CAN:THReshold <thre> :BUS<n>:CAN:THReshold?

Description

Sets or queries the threshold of the current source channel of CAN decoding on the specified bus.

Parameter

Name		Type	Range	Default
<n>		Discrete	{1|2}	--
			(-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset)
			Wherein, VerticalScale is the vertical scale of the source channel,
<thre>		Real	refer to the :CHANnel<n>:SCALe command; Offset is the vertical	0
			position of the source channel, refer to the :CHANnel<n>:OFFSet
			command.

Return Format

The query returns the threshold level in scientific notation.

DS4000E Programming Guide

2-13

RIGOL

Chapter 2 Command System

:BUS<n>:FLEXray (Option)

Command List:

:BUS<n>:FLEXray:BAUD

:BUS<n>:FLEXray:OFFSet

:BUS<n>:FLEXray:SOURce

:BUS<n>:FLEXray:SPoint

:BUS<n>:FLEXray:STYPe

:BUS<n>:FLEXray:THReshold

:BUS<n>:FLEXray:BAUD

Syntax

:BUS<n>:FLEXray:BAUD <baud> :BUS<n>:FLEXray:BAUD?

Description

Sets or queries the signal rate of FlexRay decoding on the specified bus. The default unit is b/s.

Parameter
Name	Type	Range	Default
<n>	Discrete	{1|2}	--
<baud>	Discrete	{2500000|5000000|10000000}	10000000

Return Format

The query returns 2500000, 5000000, or 10000000.

:BUS<n>:FLEXray:OFFSet

Syntax

:BUS<n>:FLEXray:OFFSet <val> :BUS<n>:FLEXray:OFFSet?

Description

Sets or queries the vertical position of FlexRay decoding on the specified bus.

Parameter
Name	Type	Range	Default
<n>	Discrete	{1|2}	--
<val>	Integer	Refer to Remarks	0

Remarks

Before using the command, enable the display of the specified decoding bus (refer to the :BUS<n>:DISPlay command).

The range of <val> is related to the screen display mode and the on/off status of the statistic function (refer to the :MEASure:STATistic:DISPlay command).

When the display mode is "Full Screen" and the statistics function is disabled, the <val> parameter ranges from -166 to +148.

When the display mode is "Full Screen" and the statistics function is enabled, the <val> parameter ranges from -163 to +143.

When the display mode is "Split" (refer to the :TIMebase:DELay:ENABle and :CALCulate:FFT:SPLit command), the <val> parameter ranges from -103 to +52.

When the data line that displays the decoding is located in the middle part of the screen, <val> is 0; when it is located above the middle part of the screen, <val> is a positive value; when it is located

2-14	DS4000E Programming Guide

Chapter 2 Command System

RIGOL

below the middle part of the screen, <val> is a negative value.

Return Format

The query returns an integer.

:BUS<n>:FLEXray:SOURce

Syntax

:BUS<n>:FLEXray:SOURce <source> :BUS<n>:FLEXray:SOURce?

Description

Sets or queries the source channel of FlexRay decoding on the specified bus.

Parameter

Name		Type	Range	Default
<n>		Discrete	{1|2}	--
<source>		Discrete	{CHANnel1|CHANnel2|CHANnel3|CHANnel4}	CHANnel1

Return Format

The query returns CHAN1, CHAN2, CHAN3, or CHAN4.

:BUS<n>:FLEXray:SPoint

Syntax

:BUS<n>:FLEXray:SPoint <spo> :BUS<n>:FLEXray:SPoint?

Description

Sets or queries the sample point position of FlexRay decoding on the specified bus (expressed in %).

Parameter
Name	Type	Range	Default
<n>	Discrete	{1|2}	--
<spo>	Integer	5 to 95	50

Remarks

The sample point is within the range of the bit time. The oscilloscope samples the bit level at the sample point. The sample point position is expressed as the ratio of "time from the bit start to the sample point" to "bit time", in %.

Return Format

The query returns an integer between 5 and 95.

:BUS<n>:FLEXray:STYPe

Syntax

:BUS<n>:FLEXray:STYPe <type> :BUS<n>:FLEXray:STYPe?

Description

Sets or queries the signal type of FlexRay decoding on the specified bus.

DS4000E Programming Guide

2-15

RIGOL						Chapter 2 Command System
Parameter
	Name		Type		Range			Default
	<n>		Discrete		{1|2}	--
	<type>		Discrete		{BP|BM|RT}			BP

Return Format

The query returns BP, BM, or RT.

:BUS<n>:FLEXray:THReshold

Syntax

:BUS<n>:FLEXray:THReshold <thre> :BUS<n>:FLEXray:THReshold?

Description

Sets or queries the threshold of the current source channel of FlexRay decoding on the specified bus.

Parameter
Name		Type	Range	Default
<n>		Discrete	{1|2}	--
			(-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset)
<thre>		Real	Wherein, VerticalScale is the vertical scale of the source
			channel, refer to the :CHANnel<n>:SCALe command;	0
			Offset is the vertical position of the source channel, refer
			to the :CHANnel<n>:OFFSet command.

Return Format

The query returns the threshold level in scientific notation.

2-16	DS4000E Programming Guide

Chapter 2 Command System

RIGOL

:BUS<n>:IIC (Option)

Command List:

:BUS<n>:IIC:OFFSet

:BUS<n>:IIC:SCLK:SOURce

:BUS<n>:IIC:SCLK:THReshold

:BUS<n>:IIC:SDA:SOURce

:BUS<n>:IIC:SDA:THReshold

:BUS<n>:IIC:OFFSet

Syntax

:BUS<n>:IIC:OFFSet <val> :BUS<n>:IIC:OFFSet?

Description

Sets or queries the vertical position of IIC decoding on the specified bus.

Parameter
Name		Type	Range	Default
<n>		Discrete	{1|2}	--
<val>		Integer	Refer to Remarks	0

Remarks

Before using the command, enable the display of the specified decoding bus (refer to the :BUS<n>:DISPlay command).

The range of <val> is related to the screen display mode and the on/off status of the statistic function (refer to the :MEASure:STATistic:DISPlay command).

When the display mode is "Full Screen" and the statistics function is disabled, the <val> parameter ranges from -166 to +148.

When the display mode is "Full Screen" and the statistics function is enabled, the <val> parameter ranges from -163 to +143.

When the display mode is "Split" (refer to the :TIMebase:DELay:ENABle and :CALCulate:FFT:SPLit command), the <val> parameter ranges from -103 to +52.

When the data line that displays the decoding is located in the middle part of the screen, <val> is 0; when it is located above the middle part of the screen, <val> is a positive value; when it is located below the middle part of the screen, <val> is a negative value.

Return Format

The query returns an integer.

:BUS<n>:IIC:SCLK:SOURce

Syntax

:BUS<n>:IIC:SCLK:SOURce <source> :BUS<n>:IIC:SCLK:SOURce?

Description

Sets or queries the source channel of the clock line of IIC decoding on the specified bus.

DS4000E Programming Guide

2-17

	RIGOL			Chapter 2 Command System
	Parameter
	Name	Type	Range		Default
	<n>	Discrete	{1|2}		--
	<source>	Discrete	{CHANnel1|CHANnel2|CHANnel3|CHANnel4}		CHANnel1

Return Format

The query returns CHAN1, CHAN2, CHAN3, or CHAN4.

:BUS<n>:IIC:SCLK:THReshold

Syntax

:BUS<n>:IIC:SCLK:THReshold <thre> :BUS<n>:IIC:SCLK:THReshold?

Description

Sets or queries the threshold of the current clock line source channel of IIC decoding on the specified bus. The default unit is V.

Parameter
Name			Type		Range	Default
<n>			Discrete	{1|2}		--
					(-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset)
<thre>			Real		Wherein, VerticalScale is the vertical scale of the clock line source
					channel, refer to the :CHANnel<n>:SCALe command; Offset is the	0
					vertical position of the clock line source channel, refer to
					the :CHANnel<n>:OFFSet command.
Return Format
The query returns the threshold level in scientific notation.

:BUS<n>:IIC:SDA:SOURce

Syntax

:BUS<n>:IIC:SDA:SOURce <source> :BUS<n>:IIC:SDA:SOURce?

Description

Sets or queries the source channel of the data line of IIC decoding on the specified bus.

Parameter
Name		Type	Range	Default
<n>		Discrete	{1|2}	--
<source>		Discrete	{CHANnel1|CHANnel2|CHANnel3|CHANnel4}	CHANnel2

Return Format

The query returns CHAN1, CHAN2, CHAN3, or CHAN4.

2-18	DS4000E Programming Guide