Rigol DS4000E Series Digital Oscilloscope Programming Guide

RIGOL
Programming Guide
DS4000E Series Digital Oscilloscope
Aug. 2016
RIGOL TECHNOLOGIES, INC.
RIGOL
Copyright
© 2016 RIGOL TECHNOLOGIES, INC. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL TEC H NO LOGI ES, 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 ma terials. Information in this publication is subject to change without notice. RIGOL shall no t 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 par t 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 n ational 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: service@rigol.com Website: www.rigol.com
DS4000E Programming Guide I
RIGOL
Tip
RIGOL

Document Overview

This manual is your guide to programming RIGOL DS4000E series digital os cilloscope.
For the newest version of this manual, please download it from
official website (www.rigol.com).
Main Topics in this Manual:
Chapter 1 SCPI Command Overview
This chapter introduces the syntax, symbols, paramet ers, and abbreviation rules of the SCPI commands.
Chapter 2 Command System
This chapter introduce s the syntax, function, parameters, and usage of each command.
Chapter 3 Programming Examples
This chapter illustrates how t o control the DS400 0E series digital oscilloscope by programming i n 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 manua l takes DS4024E as an example to make a detailed introduction about the commands of DS4000E series.
Model
DS4024E DS4014E
Bandwidth
200 MHz 100 MHz
No. of Channels
4 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, paramet ers, 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 consis ts 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 ro ot k ey word of th e c ommand. ADVanced is th e secon d-level keyword, and EXPRession is the third-level keyword. The command line starts with a colon, a nd 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 quer y 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 <yea r>,<month >, <da y >.

Symbol Description

1. Braces { }
The contents enclosed in the br aces are par ameter 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 wit hi n the effective value r an ge. Do no t set the parameter to a decimal or in scientific notation, otherwise, errors will occur. For example,
:DISPlay:GBRightne ss <br i ght> :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 scientif ic 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.0000 001 and 10; or any real numbe r 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 ra nge 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
DS4000E Programming Guide 2-1
.
command is invalid.
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 d ata will be displ ayed. front panel.
This command functions the same as the CLEAR key on the
: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 "Singl e". This command func tions the same as the Single key on the front panel.
Remarks
In the single trigger mode, the oscilloscope performs a single tr ig g er when the trigger conditions are If the oscilloscope is in a single trigger mode, you can use the :RUN command to set the trigger mode If the oscilloscope is in a single trigger mode and in WAIT state, you can use the :STOP command to
2-2 DS4000E Programming Guide
met and then it stops. You can use the :TFORce command to generate a trigger by force. of the oscillosc ope to "Auto", and keep the os cilloscope in the "Run" state. set the trigger mode of the oscilloscope to "Auto", and keep the oscilloscope in the "Stop" state.
Chapter 2 Command System RIGOL

:TFORce

Syntax
:TFORce
Description
Generates a trigger signal forcefully. This com mand is only applicable to the normal and single trigger modes, refer to the :TRIGger:SWEep the trigger contro l area of the front p anel.
command. This command functions the same as the FORCE key in

: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
Name
Type
Range
Default

:ACQuire Commands

Command List
:ACQuire:AALias :ACQuire:AVERages :ACQuire:MDEPth :ACQuire:SRATe? :ACQuire:TYPE
[1]
Note
omitted. You can refer to the complete introdu ctions of the c o m ma n ds in th e body of the t ext b a s ed o n t h e key w o r ds listed here.
: In the "Command List" in this manual, the query commands and the parameters in the setting commands are

: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
[1]
:
<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
Remarks
In the average acquisition mode, the oscilloscope will acquire the waveform samples for several times, then make an average o n th e w av ef o rms, so as to lo wer th e ran dom no is es of th e inpu t sign als and incr ease 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 a n integer.
<count> Integer 2n (n indicates an integer between 1 and 13). 2
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 th at can be stored through sampling in a single trigger). The default unit is pts (points).
Parameter
Remarks
The formula below describes the relationship among memory depth, sample rate, and waveform length: Wherein, waveform length = horizontal time base x number of grids in the horiz ontal direction on t he
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 a n integer.
Name
<mdep> Discrete AUTO|7000|70000|700000|7000000 AUTO
Type Range Default
memory depth = sample rate x waveform length

: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 s cientific notation.

:ACQuire:TYPE

Syntax
:ACQuire:TYPE <type> :ACQuire:TYPE?
Description
Sets or queries the data acquisition mode of the oscilloscope.
Parameter
Remarks
NORMa l: In this mode, the oscilloscope samples the signal at the same interval to reconstruct the AVERages: In this mode, the oscilloscope will acquire the waveform samples for several times, then
DS4000E Programming Guide 2-5
Name Type Range Default <type> Discrete {NORMal|AVERages|PEAK|HRESolution} NORMal
waveform. For most of the waveforms, this mode can realize the best display effects.
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 av erages 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.
HRE Solution: 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
Name
Type
Range
Default
<n>
Discrete
{1|2}
--

: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 (Opti on) :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
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 t he 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) "*.csv" file and view the data in the form of a list.
as the
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
Return Format
The query returns 1 or 0.
Name Type Range Default <n> Discrete {1|2} -­<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

:BUS<n>:EEXPort

Name
Type Range Default
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
<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
Remarks
Before using the command, enable the display of the specified decodi ng bus (refer to the :BUS<n>:DISPlay command).
Return Format The query returns 1 or 0.
Name Type Range Default <n> Discrete {1|2} -­<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
2-8 DS4000E Programming Guide
Chapter 2 Command System RIGOL

:BUS<n>:FORMat

Syntax
:BUS<n>:FORMat <form at> :BUS<n>:FORMat?
Description
Sets or queries the display format of decoding data of the specified decoding bus.
Parameter
Name
<n> Discrete {1|2} -­<format> Discrete {HEX|DEC|BIN|ASCii} HEX
Return Format
The query returns HEX, DEC, BIN, or ASC.
Type Range Default

:BUS<n>:MODE

Syntax
:BUS<n>:MODE <mod e> :BUS<n>:MODE?
Description Sets or queries the decoding type of the specified decoding bus.
Parameter
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.
Name
<n> Discrete {1|2} -­<mode> Discrete {PARallel|RS232|IIC|SPI|CAN|FLEXray} PARallel
Type Range Default
DS4000E Programming Guide 2-9
RIGOL Chapter 2 Command System
<baud>
Discrete
{100000|125000|250000|400000|500000|800000|1000000|USER}
500000

:BUS<n>:CAN (Opti o n )

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>:CA N: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
<n> Discrete {1|2} --
Type Range Default
Remarks
When <baud> is set to "U S E R ", 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>:CA N:B USe r <ba u d> :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
Return Format
The query returns an integer between 10000 and 1000000.
Name
<n> Discrete {1|2} -­<baud> Integer 10000 to 1000000 500000
Type Range Default
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
Remarks
Before using the command, enable the display of the specified decoding bus (refer to The range of <val> is related to the screen display mode and the on/off status of the statistic function
When the data line that displays the decoding is located in the middle part of the screen, <val > is 0;
Return Format
The query returns a n integer.
Name
<n> Discrete {1|2} -­<val> Integer Refer to Remarks 0
the :BUS<n>:DISPlay command). (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 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.
Type Range Default
:BUS<n>:CAN:SOURce
Syntax
:BUS<n>:CAN:SO UR ce <s ourc e > :BUS<n>:CAN:SOURce?
Description Sets or queries the source channel of CAN decoding on the specified bus.
Parameter
Name
<n> Discrete {1|2} -­<source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1
Type Range Default
Return Format
The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
DS4000E Programming Guide 2-11
RIGOL Chapter 2 Command System
Name
Type
Range
Default
<stype>
Discrete
{RX|TX|CANH|CANL|DIFFerential}
RX
: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
<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.
Type Range Default
:BUS<n>:CAN:STYPe
Syntax
:BUS<n>:CAN:S TYPe <stype> :BUS<n>:CAN:STYPe?
Description
Sets or queries the signal type of CAN decoding on the specified bus.
Parameter
<n> Discrete {1|2} --
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, a nd 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
Name
Type
Range
Default
--
:BUS<n>:CAN:THReshold
Syntax
:BUS<n>:CAN:THR eshold <thre> :BUS<n>:CAN:THReshold?
Description
Sets or queries the threshold of the current source channel of CAN decoding on the specified bus.
Parameter
<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
Return Format
The query returns the threshold level in scientific notation.
refer to the :CHANnel<n>:SCALe command; Offset is the vertical position of the source channel, refer to t he :CHANnel<n>:OFFSet command.
0
DS4000E Programming Guide 2-13
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Remarks

: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
Return Format
The query returns 2500000, 5000000, or 10000000.
:BUS<n>:FLEXray:OFFSet
Syntax
:BUS<n>:FLEXra y :OF F Set <val> :BUS<n>:FLEXray:OFFSet?
Description
Sets or queries the vertical position of FlexRay decoding on the specified bus.
Parameter
Remarks
Before using the command, enable the display of the specified decoding bus (refer to The range of <val> is related to the screen display mode and the on/off status of the statistic function
When the data line that displays the decoding is located in the middle part of the screen, <val > is 0;
Name
<n> Discrete {1|2} -­<baud> Discrete {2500000|5000000|10000000} 10000000
Type Range Default
<n> Discrete {1|2} -­<val> Integer Refer to
the :BUS<n>:DISPlay command). (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 it is located above the middle part of the screen, <val> is a positive value; when it is located
0
2-14 DS4000E Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
below the middle part of the screen, <val> is a negative value.
Return Format
The query returns a n integer.
:BUS<n>:FLEXray:SOURce
Syntax
:BUS<n>:FLEXra y :SO UR ce <source> :BUS<n>:FLEXray:SOURce?
Description
Sets or queries the source channel of FlexRay decoding on the specified bus.
Parameter
Return Format
The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
<n> Discrete {1|2} -­<source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1
:BUS<n>:FLEXray:SPoint
Syntax
:BUS<n>:FLEXray:SPoint <spo> :BUS<n>:FLEXray:SPoint?
Description
Sets or queries the sample point position of FlexRa y decoding on the specified bus (expressed in %).
Parameter
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 poi nt" to "bit time", in %.
Return Format
The query returns an integer between 5 and 95.
Name
<n> Discrete {1|2} -­<spo> Integer 5 to 95 50
Type Range Default
: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
Name
Type
Range
Default
<n>
Discrete
{1|2}
--
<type>
Discrete
{BP|BM|RT}
BP
Name
Type
Range
Default
(-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset)
Parameter
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 speci fi ed bus.
Parameter
<n> Discrete {1|2}
--
Wherein, VerticalScale is the vertical scale of the source
<thre> Real
Return Format
The query returns the threshold level in scientific notation.
channel, refer to the :CHANnel<n>:SCALe command; Offset is the vertical position of the source channel, refer to the :CHANnel<n>:OFFSet command.
0
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:OFF Set <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 a n 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
Name
Type
Range
Default
<n>
Discrete
{1|2}
--
<source>
Discrete
{CHANnel1|CHANnel2|CHANnel3|CHANnel4}
CHANnel1
(-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset)
Name
Type
Range
Default
<n>
Discrete
{1|2}
--
Parameter
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}
--
Wherein, VerticalScale is the vertical scale of the clock line source
<thre> Real
Return Format
The query returns the threshold level in scientific notation.
channel, refer to the :CHANnel<n>:SCALe command; Offset is the vertical position of the clock line source channel, refer to the :CHANnel<n>:OFFSet command.
0
:BUS<n>:IIC:SDA:SOURce
Syntax
:BUS<n>:IIC:S DA :SO UR ce <s o urce> :BUS<n>:IIC:SDA:SOURce?
Description
Sets or queries the source channel of the data line of IIC decoding on the specified bus.
Parameter
Return Format
The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
<source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel2
2-18 DS4000E Programming Guide
Loading...
+ 248 hidden pages