Rigol DS7034 Owner's manual

RIGOL
Programming Guide
MSO7000/DS7000 Series Digital
Oscilloscope
Apr. 2018
RIGOL TECHNOLOGIES, INC.

RIGOL
MSO7000/DS7000 Programming Guide I
Guaranty and Declaration
Copyright
© 2018 RIGOL TECHNOLOGIES, INC. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL TECHNOLOGIES, INC.
Publication Number
PGA22101-1110
Software Version
00.01.01.SP5
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 of or all 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

RIGOL
II MSO7000/DS7000 Programming Guide
Document Overview
This manual is your guide to programming RIGOL MSO7000/DS7000 series digital oscilloscope.
MSO7000/DS7000 series can communicate with the PC via the USB, LAN, or GPIB (requiring to work with
RIGOL's USB-GPIB interface converter) interface.
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 descriptions of each command.
Chapter 3 Programming Examples
This chapter illustrates how to control the MSO7000/DS7000 series digital oscilloscope by programming in
Excel, LabVIEW, Visual Basic, and Visual C++.
Format Conventions in this Manual:
1. 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
The menu items are denoted by the format of "Menu Word (Bold) + Character Shading". For example,
System denotes the "System" menu item under Utility.
3. Operation Procedures:
"" denotes the next step of operation. For example, Utility System denotes that first press
Utility, and then press the System softkey.
Content Conventions in this Manual:
MSO7000/DS7000 series includes the following models. Unless otherwise specified, this manual takes
MSO7054 as an example to illustrate the functions and operation methods of MSO7000/DS7000 series.
Model
Analog
Bandwidth
No. of Analog
Channels
No. of Channels of
Function/AWG
No. of Digital
Channels
DS7054
500 MHz
4
——
——
DS7034
350 MHz
4
——
——
DS7024
200 MHz
4
——
——
DS7014
100 MHz
4
——
——
MSO7054
500 MHz
4
2, Opt.
16
MSO7034
350 MHz
4
2, Opt.
16
MSO7024
200 MHz
4
2, Opt.
16
MSO7014
100 MHz
4
2, Opt.
16
Tip
For the latest version of this manual, download it from the official website of RIGOL (www.rigol.com).

Contents RIGOL
MSO7000/DS7000 Programming Guide III
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-2
:CLEar ................................................................................................................................ 2-2
:RUN .................................................................................................................................. 2-2
:STOP................................................................................................................................. 2-2
:SINGle............................................................................................................................... 2-3
:TFORce ............................................................................................................................. 2-3
:ACQuire Commands ............................................................................................................ 2-4
:ACQuire:AVERages ....................................................................................................... 2-4
:ACQuire:MDEPth .......................................................................................................... 2-4
:ACQuire:TYPE .............................................................................................................. 2-5
:ACQuire:SRATe? ........................................................................................................... 2-5
:ACQuire:LA:SRATe? ...................................................................................................... 2-6
:ACQuire:LA:MDEPth? .................................................................................................... 2-6
:ACQuire:AALias ............................................................................................................ 2-6
:BUS<n> Commands ........................................................................................................... 2-7
:BUS<n>:MODE............................................................................................................ 2-7
:BUS<n>:DISPlay.......................................................................................................... 2-8
:BUS<n>:FORMat ......................................................................................................... 2-8
:BUS<n>:EVENt............................................................................................................ 2-8
:BUS<n>:EVENt:FORMat ............................................................................................... 2-9
:BUS<n>:EVENt:VIEW ................................................................................................... 2-9
:BUS<n>:LABel............................................................................................................. 2-9
:BUS<n>:DATA? ..........................................................................................................2-10
:BUS<n>:EEXPort ........................................................................................................2-10
:BUS<n>:POSition........................................................................................................2-11
:BUS<n>:THReshold ....................................................................................................2-11
:BUS<n>:PARallel ........................................................................................................2-12
:BUS<n>:RS232 (Option)..............................................................................................2-16
:BUS<n>:IIC (Option) ..................................................................................................2-21
:BUS<n>:SPI (Option) ..................................................................................................2-23
:BUS<n>:CAN (Option).................................................................................................2-29
:BUS<n>:FLEXray (Option) ...........................................................................................2-31
:BUS<n>:LIN (Option)..................................................................................................2-33
:BUS<n>:IIS (Option) ..................................................................................................2-35
:BUS<n>:M1553 (Option) .............................................................................................2-38
:CHANnel<n> Commands....................................................................................................2-39
:CHANnel<n>:BWLimit .................................................................................................2-39
:CHANnel<n>:COUPling ................................................................................................2-40
:CHANnel<n>:DISPlay ..................................................................................................2-40
:CHANnel<n>:INVert ....................................................................................................2-40
:CHANnel<n>:OFFSet...................................................................................................2-41
:CHANnel<n>:TCALibrate..............................................................................................2-41
:CHANnel<n>:SCALe ....................................................................................................2-42
:CHANnel<n>:IMPedance .............................................................................................2-42
:CHANnel<n>:CSTart....................................................................................................2-43
:CHANnel<n>:PROBe ...................................................................................................2-43

RIGOL Contents
IV MSO7000/DS7000 Programming Guide
:CHANnel<n>:PROBe:DELay .........................................................................................2-43
:CHANnel<n>:PROBe:BIAS ...........................................................................................2-44
:CHANnel<n>:UNITs.....................................................................................................2-44
:CHANnel<n>:VERNier..................................................................................................2-44
:COUNter Commands ..........................................................................................................2-46
:COUNter:CURRent? .....................................................................................................2-46
:COUNter:CURRent? .....................................................................................................2-46
:COUNter:ENABle .........................................................................................................2-46
:COUNter:SOURce ........................................................................................................2-46
:COUNter:MODE...........................................................................................................2-47
:COUNter:NDIGits.........................................................................................................2-47
:COUNter:TOTalize:ENABle ............................................................................................2-47
:COUNter:TOTalize:CLEar ..............................................................................................2-48
:CURSor Commands ............................................................................................................2-49
:CURSor:MODE ............................................................................................................2-50
:CURSor:MANual ..........................................................................................................2-51
:CURSor:TRACk............................................................................................................2-57
:CURSor:XY .................................................................................................................2-62
:DISPlay Commands............................................................................................................2-65
:DISPlay:CLEar.............................................................................................................2-65
:DISPlay:TYPE..............................................................................................................2-65
:DISPlay:GRADing:TIME ................................................................................................2-66
:DISPlay:WBRightness ..................................................................................................2-66
:DISPlay:GRID .............................................................................................................2-66
:DISPlay:GBRightness ...................................................................................................2-67
:DISPlay:DATA?............................................................................................................2-67
:DISPlay:RULers ...........................................................................................................2-67
:DISPlay:COLor ............................................................................................................2-68
:DVM Commands ................................................................................................................2-69
:DVM:CURRent? ...........................................................................................................2-69
:DVM:ENABle ...............................................................................................................2-69
:DVM:SOURce ..............................................................................................................2-69
:DVM:MODE.................................................................................................................2-70
:HISTogram Commands .......................................................................................................2-71
:HISTogram:DISPlay .....................................................................................................2-71
:HISTogram:TYPE .........................................................................................................2-71
:HISTogram:SOURce.....................................................................................................2-72
:HISTogram:SIZE..........................................................................................................2-72
:HISTogram:STATic.......................................................................................................2-72
:HISTogram:RESet........................................................................................................2-72
:HISTogram:BLIMit.......................................................................................................2-73
:HISTogram:LLIMit .......................................................................................................2-73
:HISTogram:RLIMit.......................................................................................................2-73
:HISTogram:TLIMit.......................................................................................................2-74
IEEE488.2 Common Commands............................................................................................2-75
*CLS ...........................................................................................................................2-75
*ESE ...........................................................................................................................2-75
*ESR? .........................................................................................................................2-75
*IDN? .........................................................................................................................2-76
*OPC ..........................................................................................................................2-76
*SAV...........................................................................................................................2-76
*RCL...........................................................................................................................2-76
*RST...........................................................................................................................2-76
*SRE...........................................................................................................................2-77
*STB? .........................................................................................................................2-77
*TST? .........................................................................................................................2-77
*WAI ..........................................................................................................................2-77
:LA Commands ...................................................................................................................2-78

Contents RIGOL
MSO7000/DS7000 Programming Guide V
:LA:STATe ....................................................................................................................2-78
:LA:ACTive...................................................................................................................2-79
:LA:AUTOsort...............................................................................................................2-79
:LA:DELete ..................................................................................................................2-79
:LA:DIGital<n>:DISPlay ................................................................................................2-80
:LA:DIGital<n>:POSition ...............................................................................................2-80
:LA:DIGital<n>:LABel ...................................................................................................2-81
:LA:POD<n>:DISPlay....................................................................................................2-81
:LA:DISPlay .................................................................................................................2-81
:LA:POD<n>:THReshold ...............................................................................................2-82
:LA:SIZE......................................................................................................................2-82
:LA:TCALibrate .............................................................................................................2-83
:LA:GROup<n>:APPend ................................................................................................2-83
:LAN Commands .................................................................................................................2-84
:LAN:DHCP ..................................................................................................................2-84
:LAN:AUToip ................................................................................................................2-85
:LAN:GATeway .............................................................................................................2-85
:LAN:DNS ....................................................................................................................2-85
:LAN:MAC? ..................................................................................................................2-86
:LAN:DSErver? .............................................................................................................2-86
:LAN:MANual ...............................................................................................................2-86
:LAN:IPADdress............................................................................................................2-87
:LAN:SMASk.................................................................................................................2-87
:LAN:STATus?...............................................................................................................2-87
:LAN:VISA?..................................................................................................................2-88
:LAN:MDNS..................................................................................................................2-88
:LAN:HOST:NAME .........................................................................................................2-88
:LAN:DESCription .........................................................................................................2-88
:LAN:APPLy..................................................................................................................2-89
:MASK Commands ..............................................................................................................2-90
:MASK:ENABle .............................................................................................................2-90
:MASK:SOURce ............................................................................................................2-90
:MASK:OPERate ...........................................................................................................2-91
:MASK:MDISplay ..........................................................................................................2-91
:MASK:X......................................................................................................................2-92
:MASK:Y......................................................................................................................2-92
:MASK:CREate..............................................................................................................2-92
:MASK:RESet ...............................................................................................................2-92
:MATH<n> Commands........................................................................................................2-93
:MATH<n>:DISPlay ......................................................................................................2-94
:MATH<n>:OPERator....................................................................................................2-94
:MATH<n>:SOURce1 ....................................................................................................2-95
:MATH<n>:SOURce2 ....................................................................................................2-95
:MATH<n>:LSOUrce1 ...................................................................................................2-95
:MATH<n>:LSOUrce2 ...................................................................................................2-96
:MATH<n>:SCALe ........................................................................................................2-96
:MATH<n>:OFFSet.......................................................................................................2-97
:MATH<n>:INVert ........................................................................................................2-97
:MATH<n>:RESet.........................................................................................................2-97
:MATH<n>:FFT:SOURce................................................................................................2-98
:MATH<n>:FFT:WINDow ..............................................................................................2-98
:MATH<n>:FFT:SPLit ....................................................................................................2-98
:MATH<n>:FFT:UNIT....................................................................................................2-99
:MATH<n>:FFT:SCALe ..................................................................................................2-99
:MATH<n>:FFT:OFFSet............................................................................................... 2-100
:MATH<n>:FFT:HSCale ............................................................................................... 2-100
:MATH<n>:FFT:HCENter .............................................................................................2-100
:MATH<n>:FFT:FREQuency:STARt ............................................................................... 2-101

RIGOL Contents
VI MSO7000/DS7000 Programming Guide
:MATH<n>:FFT:FREQuency:END..................................................................................2-101
:MATH<n>:FFT:SEARch:ENABle ...................................................................................2-101
:MATH<n>:FFT:SEARch:NUM ......................................................................................2-102
:MATH<n>:FFT:SEARch:THReshold ..............................................................................2-102
:MATH<n>:FFT:SEARch:EXCursion...............................................................................2-102
:MATH<n>:FFT:SEARch:ORDer ....................................................................................2-103
:MATH<n>:FILTer:TYPE ..............................................................................................2-103
:MATH<n>:FILTer:W1.................................................................................................2-104
:MATH<n>:FILTer:W2.................................................................................................2-104
:MATH<n>:SENSitivity ................................................................................................2-105
:MATH<n>:DISTance..................................................................................................2-105
:MATH<n>:THReshold1 ..............................................................................................2-105
:MATH<n>:THReshold2 ..............................................................................................2-106
:MEASure Commands ........................................................................................................2-107
:MEASure:SOURce ......................................................................................................2-107
:MEASure:COUNter:ENABle..........................................................................................2-108
:MEASure:COUNter:SOURce ........................................................................................2-108
:MEASure:COUNter:VALue? .........................................................................................2-108
:MEASure:CLEar .........................................................................................................2-109
:MEASure:THReshold:SOURce......................................................................................2-109
:MEASure:THReshold:DEFault ......................................................................................2-109
:MEASure:MODE ........................................................................................................2-109
:MEASure:AMSource ...................................................................................................2-110
:MEASure:SETup:MAX .................................................................................................2-110
:MEASure:SETup:MID..................................................................................................2-110
:MEASure:SETup:MIN..................................................................................................2-111
:MEASure:SETup:PSA ..................................................................................................2-111
:MEASure:SETup:PSB ..................................................................................................2-112
:MEASure:SETup:DSA .................................................................................................2-112
:MEASure:SETup:DSB..................................................................................................2-112
:MEASure:STATistic:DISPlay.........................................................................................2-113
:MEASure:STATistic:RESet ...........................................................................................2-113
:MEASure:STATistic:ITEM ............................................................................................2-113
:MEASure:ITEM ..........................................................................................................2-114
:MEASure:AREA..........................................................................................................2-115
:MEASure:CREGion:CAX ..............................................................................................2-115
:MEASure:CREGion:CBX ..............................................................................................2-116
:MEASure:CATegory ....................................................................................................2-116
:POWer Commands ...........................................................................................................2-117
:POWer:TYPE .............................................................................................................2-117
:POWer:CURRentsource ..............................................................................................2-117
:POWer:VOLTagesource...............................................................................................2-118
:POWer:QUALity:FREQREFerence .................................................................................2-118
:POWer:REFLevel:METHod ..........................................................................................2-118
:POWer:REFLevel:PERCent:HIGH .................................................................................2-119
:POWer:REFLevel:PERCent:LOW ..................................................................................2-119
:POWer:REFLevel:PERCent:MID ...................................................................................2-119
:Quick Commands.............................................................................................................2-120
:Quick:OPERation .......................................................................................................2-120
:RECord Commands ..........................................................................................................2-121
:RECord:ENABle .........................................................................................................2-121
:RECord:STARt ...........................................................................................................2-121
:RECord:PLAY ............................................................................................................2-122
:RECord:CURRent .......................................................................................................2-122
:RECord:FRAMes ........................................................................................................2-122
:REFerence Commands......................................................................................................2-123
:REFerence:DISPlay ....................................................................................................2-123
:REFerence:SOURce....................................................................................................2-123

Contents RIGOL
MSO7000/DS7000 Programming Guide VII
:REFerence:VSCale .....................................................................................................2-124
:REFerence:VOFFset ................................................................................................... 2-124
:REFerence:RESet....................................................................................................... 2-125
:REFerence:CURRent ..................................................................................................2-125
:REFerence:SAVE........................................................................................................ 2-125
:REFerence:COLor ......................................................................................................2-125
:REFerence:LABel:ENABle............................................................................................2-126
:REFerence:LABel:CONTent.......................................................................................... 2-126
:SAVE and :Load Commands ..............................................................................................2-127
:SAVE:CSV................................................................................................................. 2-127
:SAVE:CSV:LENGth .....................................................................................................2-127
:SAVE:FORMat ........................................................................................................... 2-128
:SAVE:IMAGe .............................................................................................................2-128
:SAVE:IMAGe:TYPE..................................................................................................... 2-128
:SAVE:IMAGe:INVert ...................................................................................................2-128
:SAVE:IMAGe:COLor ...................................................................................................2-129
:SAVE:SETup..............................................................................................................2-129
:SAVE:WAVeform........................................................................................................2-130
:SAVE:STATus? ..........................................................................................................2-130
:LOAD:SETup............................................................................................................. 2-130
:SEARch Commands..........................................................................................................2-131
:SEARch:STATe...........................................................................................................2-131
:SEARch:MODE .......................................................................................................... 2-132
:SEARch:EVENt .......................................................................................................... 2-132
:SEARch:EDGE:SLOPe .................................................................................................2-132
:SEARch:EDGE:SOURce............................................................................................... 2-133
:SEARch:PULSe:POLarity .............................................................................................2-133
:SEARch:PULSe:QUALifier ...........................................................................................2-133
:SEARch:PULSe:SOURce..............................................................................................2-134
:SEARch:RUNT:POLarity ..............................................................................................2-134
:SEARch:RUNT:QUALifier.............................................................................................2-134
:SEARch:RUNT:SOURce...............................................................................................2-135
:SEARch:SLOPe:POLarity .............................................................................................2-135
:SEARch:SLOPe:QUALifier ...........................................................................................2-136
:SEARch:SLOPe:SOURce.............................................................................................. 2-136
[:SOURce[<n>]] Commands..............................................................................................2-137
[:SOURce[<n>]]:FREQuency[:FIXed] ...........................................................................2-138
[:SOURce[<n>]]:PHASe[:ADJust] ................................................................................2-138
[:SOURce[<n>]]:PHASe:INITiate .................................................................................2-139
[:SOURce[<n>]]:FUNCtion[:SHAPe] .............................................................................2-139
[:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry .................................................................2-140
[:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] ...........................................2-140
[:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:OFFSet ..................................................2-141
[:SOURce[<n>]]:PULSe:DCYCle...................................................................................2-141
[:SOURce[<n>]]:MOD:TYPE........................................................................................2-142
[:SOURce[<n>]]:MOD:AM[:DEPTh]..............................................................................2-142
[:SOURce[<n>]]:MOD:AM:INTernal:FREQuency ............................................................2-143
[:SOURce[<n>]]:MOD:FM:INTernal:FREQuency.............................................................2-143
[:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion ............................................................... 2-144
[:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion ............................................................... 2-144
[:SOURce[<n>]]:MOD:FM[:DEVIation] .........................................................................2-144
[:SOURce[<n>]]:APPLy? .............................................................................................2-145
[:SOURce[<n>]]:APPLy:NOISe ....................................................................................2-145
[:SOURce[<n>]]:APPLy:PULSe ....................................................................................2-145
[:SOURce[<n>]]:APPLy:RAMP .....................................................................................2-145
[:SOURce[<n>]]:APPLy:SINusoid ................................................................................. 2-145
[:SOURce[<n>]]:APPLy:SQUare................................................................................... 2-145
[:SOURce[<n>]]:APPLy:USER...................................................................................... 2-145

RIGOL Contents
VIII MSO7000/DS7000 Programming Guide
[:SOURce[<n>]]:OUTPut[<n>][:STATe] .......................................................................2-147
[:SOURce[<n>]]:OUTPut[<n>]:IMPedance...................................................................2-147
:SYSTem Commands .........................................................................................................2-148
:SYSTem:AOUTput......................................................................................................2-149
:SYSTem:AUTOscale ...................................................................................................2-149
:SYSTem:BEEPer ........................................................................................................2-150
:SYSTem:DATE...........................................................................................................2-150
:SYSTem:ERRor[:NEXT]? .............................................................................................2-150
:SYSTem:GAMount? ....................................................................................................2-150
:SYSTem:GPIB ...........................................................................................................2-151
:SYSTem:KEY:PRESs ...................................................................................................2-151
:SYSTem:KEY:INCRease ..............................................................................................2-152
:SYSTem:KEY:DECRease..............................................................................................2-152
:SYSTem:LANGuage....................................................................................................2-153
:SYSTem:PON ............................................................................................................2-153
:SYSTem:PSTatus .......................................................................................................2-154
:SYSTem:OPTion:INSTall .............................................................................................2-154
:SYSTem:OPTion:UNINSTall .........................................................................................2-154
:SYSTem:OPTion:STATus?............................................................................................2-155
:SYSTem:RAMount? ....................................................................................................2-155
:SYSTem:RESet ..........................................................................................................2-155
:SYSTem:SETup..........................................................................................................2-155
:SYSTem:SSAVEr:TIME................................................................................................2-156
:SYSTem:TIME ...........................................................................................................2-156
:SYSTem:LOCKed .......................................................................................................2-156
:SYSTem:MODules? ....................................................................................................2-157
:TIMebase Commands.......................................................................................................2-158
:TIMebase:DELay:ENABle ............................................................................................2-158
:TIMebase:DELay:OFFSet ............................................................................................2-158
:TIMebase:DELay:SCALe .............................................................................................2-159
:TIMebase[:MAIN]:OFFSet...........................................................................................2-159
:TIMebase[:MAIN]:SCALe............................................................................................2-160
:TIMebase:MODE .......................................................................................................2-160
:TIMebase:HREFerence:MODE .....................................................................................2-160
:TIMebase:HREFerence:POSition ..................................................................................2-161
:TIMebase:VERNier.....................................................................................................2-161
:TRIGger Commands.........................................................................................................2-162
:TRIGger:MODE .........................................................................................................2-163
:TRIGger:COUPling .....................................................................................................2-163
:TRIGger:STATus? ......................................................................................................2-163
:TRIGger:SWEep ........................................................................................................2-164
:TRIGger:HOLDoff ......................................................................................................2-164
:TRIGger:NREJect ......................................................................................................2-165
:TRIGger:EDGE ..........................................................................................................2-165
:TRIGger:PULSe .........................................................................................................2-167
:TRIGger:SLOPe .........................................................................................................2-169
:TRIGger:VIDeo .........................................................................................................2-172
:TRIGger:PATTern.......................................................................................................2-175
:TRIGger:DURATion ....................................................................................................2-177
:TRIGger:TIMeout ......................................................................................................2-180
:TRIGger:RUNT ..........................................................................................................2-182
:TRIGger:WINDows ....................................................................................................2-185
:TRIGger:DELay .........................................................................................................2-188
:TRIGger:SHOLd ........................................................................................................2-192
:TRIGger:NEDGe ........................................................................................................2-196
:TRIGger:RS232 (Option) ............................................................................................2-198
:TRIGger:IIC (Option) .................................................................................................2-201
:TRIGger:CAN (Option) ...............................................................................................2-205

Contents RIGOL
MSO7000/DS7000 Programming Guide IX
:TRIGger:SPI (Option) ................................................................................................ 2-208
:TRIGger:FLEXray (Option)..........................................................................................2-213
:TRIGger:IIS (Option) ................................................................................................. 2-215
:TRIGger:LIN (Option) ................................................................................................ 2-219
:TRIGger:M1553 (Option)............................................................................................ 2-222
:WAVeform Commands...................................................................................................... 2-224
:WAVeform:SOURce.................................................................................................... 2-225
:WAVeform:MODE ...................................................................................................... 2-225
:WAVeform:FORMat .................................................................................................... 2-226
:WAVeform:DATA? ...................................................................................................... 2-226
:WAVeform:XINCrement? ............................................................................................ 2-227
:WAVeform:XORigin? ..................................................................................................2-227
:WAVeform:XREFerence?.............................................................................................2-228
:WAVeform:YINCrement? ............................................................................................ 2-228
:WAVeform:YORigin? ..................................................................................................2-228
:WAVeform:YREFerence?.............................................................................................2-229
:WAVeform:STARt....................................................................................................... 2-229
:WAVeform:STOP .......................................................................................................2-229
:WAVeform:PREamble? ...............................................................................................2-230
Chapter 3 Programming Examples .....................................................................................3-1
Programming Preparations .................................................................................................... 3-2
Excel Programming Example ................................................................................................. 3-3
LabVIEW Programming Example............................................................................................ 3-7
Visual Basic Programming Example .......................................................................................3-10
Visual C++ Programming Example........................................................................................3-12

Chapter 1 SCPI Command Overview RIGOL
MSO7000/DS7000 Programming Guide 1-1
Chapter 1 SCPI Command Overview
SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming
language that is built upon the existing standard IEEE 488.1 and IEEE 488.2 and conforms to various
standards, such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character set
for information interchange (equivalent to ASCII programming). 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.
Contents in this chapter:
Syntax
Symbol Description
Parameter Type
Command Abbreviation
Syntax
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 quotation mark indicates
querying a certain function. The keywords of the command and the first parameter is separated by a space.
For example,
:ACQuire:TYPE <type>
:ACQuire:TYPE?
ACQuire is the root keyword of the command, and TYPE is the second-level keyword. The command line
starts with a colon, and different levels of keywords are also separated by colons. <type> indicates a
settable parameter. The command ending with a quotation mark indicates querying a certain function. The
command keywords ":ACQuire:TYPE" and the parameter <type> are separated by a space.
In some commands with parameters, "," is often used to separate multiple parameters. For example,
:SYSTem:DATE <year>,<month>,<day>.
Symbol Description
The following symbols are not sent with the commands.
1. Braces { }
The contents enclosed in the braces are parameter options, Parameters are usually separated by the
vertical bar "|". When using the command, you must select one of the parameters.
2. Vertical Bar |
The vertical bar is used to separate multiple parameters. When using the command, you must select
one of the parameters.
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.

RIGOL Chapter 1 SCPI Command Overview
1-2 MSO7000/DS7000 Programming Guide
Parameter Type
1. Bool
The parameter can be set to ON, OFF, 1, or 0. For example,
:SYSTem:BEEPer <bool>
:SYSTem:BEEPer?
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, or PEAK.
The query returns NORM, AVER, or PEAK.
3. Integer
Unless otherwise specified, the parameter can be any integer (NR1 format) within the effective value
range.
Note: Do not set the parameter to a decimal, otherwise, errors will occur.
For example,
:DISPlay:GBRightness <brightness>
:DISPlay:GBRightness?
Wherein, <brightness> can be set to an integer ranging from 1 to 100.
The query returns an integer ranging from 1 to 100.
4. Real
The parameter can be any real number within the effective value range, and this command accepts
parameter input in decimal (NR2 format) and scientific notation (NR3 format). For example,
:TRIGger:TIMeout:TIME <time>
:TRIGger:TIMeout:TIME?
Wherein, <time> can be set to any real number ranging from 1.6E-8 (i.g. 16 ns) to 1E+1 (i.g. 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,
:SYSTem:OPTion:INSTall <license>
Wherein, <license> can be set to
DS7000-PWR@3AEBC07E6C31F82B78A1C401DC2E3AC2CC9431B57F60D1E1CB712F8682C93609A60
5F8577BFDE920373062BE226289A27C134E2C91BF80CB00F8011AC181FD40.
Command Abbreviation
All the commands are case-insensitive. They can all be in upper case or in lower case. If abbreviation is
used, you must input all the capital letters in the command. For example,
:DISPlay:GBRightness?
can be abbreviated as
:DISP:GBR?

Chapter 2 Command System RIGOL
MSO7000/DS7000 Programming Guide 2-1
Chapter 2 Command System
This chapter introduces the syntax, functions, parameters, and usage of each MSO7000/DS7000 command.
Contents in this chapter:
:AUToscale
:CLEar
:RUN
:STOP
:SINGle
:TFORce
:ACQuire Commands
:BUS<n> Commands
:CHANnel<n> Commands
:COUNter Commands
:CURSor Commands
:DISPlay Commands
:DVM Commands
:HISTogram Commands
IEEE488.2 Common Commands
:LA Commands
:LAN Commands
:MASK Commands
:MATH<n> Commands
:MEASure Commands
:POWer Commands
:Quick Commands
:RECord Commands
:REFerence Commands
:SAVE and :Load Commands
:SEARch Commands
[:SOURce[<n>]] Commands
:SYSTem Commands
:TIMebase Commands
:TRIGger Commands
:WAVeform Commands

RIGOL Chapter 2 Command System
2-2 MSO7000/DS7000 Programming Guide
Note:
1. Unless otherwise specified, the descriptions in this manual all take MSO7054 as an example.
2. Unless otherwise specified, the descriptions about the digital channels and the commands in this
manual are only available for the MSO7000 series.
3. 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
vertical scale, horizontal time base, and trigger mode according to the input signal to
realize optimal waveform display. This command functions the same as the AUTO key on
the front panel.
Remarks
When the AUTO function is disabled, this command is invalid. For details, refer
to :SYSTem:AUTOscale.
When the pass/fail test is enabled, the AUTO function runs normally, but the pass/fail
test function is forced to be disabled.
When the waveform recording function is enabled or the recorded waveforms are
played back, the AUTO function runs normally, but the recording or playing function is
forced to be disabled.
:CLEar
Syntax
:CLEar
Description
Clears all the waveforms on the screen. 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
When the waveform recording function is enabled, the RUN/STOP key on the front panel
is disabled.

Chapter 2 Command System RIGOL
MSO7000/DS7000 Programming Guide 2-3
:SINGle
Syntax
:SINGle
Description
Sets the trigger mode of the oscilloscope to "Single". This command functions the same as
either of the following two operation: press SINGLE on the front panel; or send
the :TRIGger:SWEep SINGle command.
Remarks
In the single trigger mode, the oscilloscope performs a single trigger when the trigger
conditions are met and then it stops.
When the waveform recording function is enabled or the recorded waveforms are
played back, this command is invalid.
For the single trigger, you can use the :TFORce command to generate one trigger by
force.
: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.

RIGOL Chapter 2 Command System
2-4 MSO7000/DS7000 Programming Guide
:ACQuire Commands
The :ACQuire commands are used to set the memory depth of the oscilloscope, the acquisition mode, the
average times, as well as query the current sample rate.
Command List[1]:
:ACQuire:AVERages
:ACQuire:MDEPth
:ACQuire:TYPE
:ACQuire:SRATe?
:ACQuire:LA:SRATe?
:ACQuire:AALias
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:AVERages
Syntax
:ACQuire:AVERages <count>
:ACQuire:AVERages?
Description
Sets or queries the number of averages in the average acquisition mode.
Parameter
Name
Type
Range
Default
<count>
Integer
2n(n is an integer, and its range is from 1 to 16)
2
Remarks
You can send the :ACQuire:TYPE command to set the acquisition mode.
In the average acquisition mode, greater number of averages can lower the noise
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 ranging from 2 to 65536.
Example
:ACQuire:AVERages 128 /*Sets the average times to 128.*/
:ACQuire:AVERages? /*The query returns 128.*/
:ACQuire:MDEPth
Syntax
:ACQuire:MDEPth <mdep>
:ACQuire:MDEPth?
Description
Sets or queries the memory depth of the oscilloscope (i.g. the number of waveform
points that can be stored through the sampling in a single trigger). The default unit is pts.
Parameter
Name
Type
Range
Default
<mdep>
Discrete
{AUTO|1k|10k|100k|1M|10M|25M|50M|100M|1
25M|250M|500M|1000|10000|100000|1000000|
10000000|25000000|50000000|100000000|125
000000|250000000|500000000|1e3|1e4|1e5|1e
6|1e7|2.5e7|5e7|1e8|1.25e8|2.5e8|5e8}
AUTO

Chapter 2 Command System RIGOL
MSO7000/DS7000 Programming Guide 2-5
Remarks
When "AUTO" is selected, the oscilloscope selects the memory depth automatically
according to the current sample rate.
The maximum memory depth for the single channel is 500 M; the maximum memory
depth for the dual-channel is 250 M; and the maximum memory depth for the
four-channel is 125 M.
Return
Format
The query returns AUTO, 1k, 10k, 100k, 1M, 10M, 25M, 50M, 100M, 125M, 250M, 500M,
1000, 10000, 100000, 1000000, 10000000, 25000000, 50000000, 100000000,
125000000, 250000000, 500000000, 1e3, 1e4, 1e5, 1e6, 1e7, 2.5e7, 5e7, 1e8, 1.25e8,
2.5e8, or 5e8.
Example
:ACQuire:MDEPth 1M /*Sets the memory depth to 1M.*/
:ACQuire:MDEPth? /*The query returns 1M.*/
:ACQuire:TYPE
Syntax
:ACQuire:TYPE <type>
:ACQuire:TYPE?
Description
Sets or queries the acquisition mode of the oscilloscope.
Parameter
Name
Type
Range
Default
<type>
Discrete
{NORMal|AVERages|PEAK|}
NORMal
Remarks
NORMal: In this mode, the oscilloscope samples the signal at a specified fixed time
interval to rebuild the waveform. For most of the waveforms, using this mode can
produce the optimal display effects.
AVERages: In this mode, the oscilloscope averages the waveforms from multiple
samples to reduce the random noise of the input signal and improve the vertical
resolution. Greater number of averages can lower the noise and increase the vertical
resolution; while at the same time, it will slow the response of the displayed
waveform to the waveform changes.
PEAK: indicates the peak detection. In this mode, 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. In this mode, signal
aliasing can be prevented, but the noise displayed would be larger.
Return
Format
The query returns NORM, AVER, or PEAK.
Example
:ACQuire:TYPE AVERages /*Sets the acquisition mode to AVERages.*/
:ACQuire:TYPE? /*The query returns AVER.*/
:ACQuire:SRATe?
Syntax
:ACQuire:SRATe?
Description
Queries the current sample rate. The default unit is Sa/s.
Remarks
Sample rate indicates the frequency of the signal sampling, i.g. the number of
waveform points sampled per second.
The formula below describes the relationship among sample rate, memory depth, and
waveform length:
memory depth = sample rate x waveform length
Wherein, the memory depth is set by the :ACQuire:MDEPth command. The waveform

RIGOL Chapter 2 Command System
2-6 MSO7000/DS7000 Programming Guide
length is obtained by multiplying the horizontal time base (set by
the :TIMebase[:MAIN]:SCALe command) by the number of grids in the horizontal
direction. For MSO7000/DS7000, the number of grids in the horizontal direction is 10.
Return
Format
The query returns the sample rate in scientific notation.
Example
:ACQuire:SRATe? /*The query returns 2.500000E+9.*/
:ACQuire:LA:SRATe?
Syntax
:ACQuire:LA:SRATe?
Description
Queries the current LA sample rate. The default unit is Sa/s.
Return
Format
The query returns the sample rate in scientific notation.
Example
:ACQuire:LA:SRATe? /*The query returns 1.250000E+9.*/
:ACQuire:LA:MDEPth?
Syntax
:ACQuire:LA:MDEPth?
Description
Queries the current LA memory depth.
Return
Format
The query returns the memory depth in scientific notation.
Example
:ACQuire:LA:MDEPth? /*The query returns 1.250000E+4.*/
: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.
Example
:ACQuire:AALias ON /*Enables the anti-aliasing function.*/
:ACQuire:AALias? /*The query returns 1.*/