RIGOL
Programming Guide
MSO5000 Series Digital Oscilloscope
Oct. 2018
RIGOL (SUZHOU) TECHNOLOGIES INC.
RIGOL
Guaranty and Declaration
Copyright
© 2018 RIGOL (SUZHOU) TECHNOLOGIES INC. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC.
Publication Number
PGA25100-1110
Software Version
00.00.00.SP1
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:2015 standard and the ISO14001:2015 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
MSO5000 Programming Guide I
RIGOL
Model
Analog
Bandwidth
No. of
Analog
Channels
No. of Function/Arbitrary
Waveform Generator
Channels
No. of Digital
Channels
MSO5072
70 MHz
2
2, Opt.
16
MSO5074
70 MHz
4
2, Opt.
16
MSO5102
100 MHz
2
2, Opt.
16
MSO5104
100 MHz
4
2, Opt.
16
MSO5204
200 MHz
4
2, Opt.
16
MSO5354
350 MHz
4
2, Opt.
16
Tip
For the latest version of this manual, download it from the official website of RIGOL (www.rigol.com).
Document Overview
This manual is your guide to programming RIGOL MSO5000 series digital oscilloscope. MSO5000 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 MSO5000 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:
MSO5000 series includes the following models. Unless otherwise specified, this manual takes MSO5354 as
an example to illustrate the functions and operation methods of MSO5000 series.
II MSO5000 Programming Guide
Contents RIGOL
Contents
Guaranty and Declaration ......................................................................................................... I
Document Overview ................................................................................................................. II
Chapter 1 SCPI Command Overview .................................................................................. 1-1
Syntax ..................................................................................................................................... 1-2
Symbol Description ................................................................................................................... 1-2
Parameter Type ........................................................................................................................ 1-2
Command Abbreviation ............................................................................................................. 1-3
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-10
:BUS<n>:DATA? .............................................................................................................. 2-10
:BUS<n>:EEXPort ............................................................................................................ 2-11
: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>:PROBe ....................................................................................................... 2-42
:CHANnel<n>:UNITs ........................................................................................................ 2-43
:CHANnel<n>:VERNier ..................................................................................................... 2-43
MSO5000 Programming Guide III
RIGOL Contents
:COUNter Commands .............................................................................................................. 2-44
:COUNter:CURRent? ......................................................................................................... 2-44
:COUNter:CURRent? ......................................................................................................... 2-44
:COUNter:ENABle ............................................................................................................. 2-44
:COUNter:SOURce ............................................................................................................ 2-44
:COUNter:MODE ............................................................................................................... 2-45
:COUNter:NDIGits............................................................................................................. 2-45
:COUNter:TOTalize:ENABle ................................................................................................ 2-45
:COUNter:TOTalize:CLEar .................................................................................................. 2-46
:CURSor Commands ................................................................................................................ 2-47
:CURSor:MODE ................................................................................................................ 2-47
:CURSor:MANual .............................................................................................................. 2-48
:CURSor:TRACk ................................................................................................................ 2-54
:CURSor:XY ...................................................................................................................... 2-59
:DISPlay Commands ................................................................................................................ 2-62
:DISPlay:CLEar ................................................................................................................. 2-62
:DISPlay:TYPE .................................................................................................................. 2-62
:DISPlay:GRADing:TIME ................................................................................................... 2-63
:DISPlay:WBRightness ...................................................................................................... 2-63
:DISPlay:GRID ................................................................................................................. 2-63
:DISPlay:GBRightness ....................................................................................................... 2-64
:DISPlay:DATA? ................................................................................................................ 2-64
:DISPlay:RULers ............................................................................................................... 2-64
:DISPlay:COLor ................................................................................................................ 2-64
:DVM Commands .................................................................................................................... 2-66
:DVM:CURRent? ............................................................................................................... 2-66
:DVM:ENABle ................................................................................................................... 2-66
:DVM:SOURce .................................................................................................................. 2-66
:DVM:MODE ..................................................................................................................... 2-67
:HISTogram Commands ........................................................................................................... 2-68
:HISTogram:DISPlay ......................................................................................................... 2-68
:HISTogram:TYPE ............................................................................................................. 2-68
:HISTogram:SOURce ......................................................................................................... 2-69
:HISTogram:SIZE.............................................................................................................. 2-69
:HISTogram:STATic ........................................................................................................... 2-69
:HISTogram:RESet ............................................................................................................ 2-70
:HISTogram:BLIMit ........................................................................................................... 2-70
:HISTogram:LLIMit ........................................................................................................... 2-70
:HISTogram:RLIMit........................................................................................................... 2-70
:HISTogram:TLIMit ........................................................................................................... 2-71
IEEE488.2 Common Commands ............................................................................................... 2-72
*CLS ................................................................................................................................ 2-72
*ESE ................................................................................................................................ 2-72
*ESR? .............................................................................................................................. 2-73
*IDN? .............................................................................................................................. 2-73
*OPC ............................................................................................................................... 2-73
*SAV ............................................................................................................................... 2-73
*RCL ............................................................................................................................... 2-73
*RST ............................................................................................................................... 2-74
*SRE ............................................................................................................................... 2-74
*STB? .............................................................................................................................. 2-74
*TST? .............................................................................................................................. 2-74
*WAI ............................................................................................................................... 2-74
:LA Commands ....................................................................................................................... 2-75
:LA:STATe ........................................................................................................................ 2-75
:LA:ACTive ....................................................................................................................... 2-76
:LA:AUTOsort ................................................................................................................... 2-76
:LA:DELete ....................................................................................................................... 2-76
IV MSO5000 Programming Guide
Contents RIGOL
:LA:DIGital:DISPlay .......................................................................................................... 2-77
:LA:DIGital:POSition ......................................................................................................... 2-77
:LA:DIGital:LABel ............................................................................................................. 2-78
:LA:POD<n>:DISPlay ....................................................................................................... 2-78
:LA:DISPlay ..................................................................................................................... 2-78
:LA:POD<n>:THReshold ................................................................................................... 2-79
:LA:SIZE .......................................................................................................................... 2-79
:LA:TCALibrate ................................................................................................................. 2-80
:LA:GROup:APPend .......................................................................................................... 2-80
:LAN Commands ..................................................................................................................... 2-81
:LAN:DHCP ...................................................................................................................... 2-81
:LAN:AUToip .................................................................................................................... 2-82
:LAN:GATeway ................................................................................................................. 2-82
:LAN:DNS ........................................................................................................................ 2-82
:LAN:MAC? ...................................................................................................................... 2-83
:LAN:DSErver? ................................................................................................................. 2-83
:LAN:MANual ................................................................................................................... 2-83
:LAN:IPADdress ............................................................................................................... 2-84
:LAN:SMASk .................................................................................................................... 2-84
:LAN:STATus? .................................................................................................................. 2-84
:LAN:VISA? ...................................................................................................................... 2-85
:LAN:MDNS ..................................................................................................................... 2-85
:LAN:HOST:NAME ............................................................................................................ 2-85
:LAN:DESCription ............................................................................................................. 2-85
:LAN:APPLy ...................................................................................................................... 2-86
:MASK Commands .................................................................................................................. 2-87
:MASK:ENABle ................................................................................................................. 2-87
:MASK:SOURce ................................................................................................................ 2-87
:MASK:OPERate ............................................................................................................... 2-88
:MASK:MDISplay .............................................................................................................. 2-88
:MASK:X .......................................................................................................................... 2-89
:MASK:Y .......................................................................................................................... 2-89
:MASK:CREate ................................................................................................................. 2-89
:MASK:RESet ................................................................................................................... 2-89
:MATH<n> Commands ........................................................................................................... 2-90
:MATH<n>:DISPlay .......................................................................................................... 2-91
:MATH<n>:OPERator ....................................................................................................... 2-91
:MATH<n>:SOURce1 ....................................................................................................... 2-92
:MATH<n>:SOURce2 ....................................................................................................... 2-92
:MATH<n>:LSOUrce1 ....................................................................................................... 2-92
:MATH<n>:LSOUrce2 ....................................................................................................... 2-93
:MATH<n>:SCALe ............................................................................................................ 2-93
:MATH<n>:OFFSet .......................................................................................................... 2-94
:MATH<n>:INVert............................................................................................................ 2-94
:MATH<n>:RESet ............................................................................................................ 2-94
:MATH<n>:FFT:SOURce ................................................................................................... 2-95
:MATH<n>:FFT:WINDow .................................................................................................. 2-95
:MATH<n>:FFT:SPLit ....................................................................................................... 2-95
:MATH<n>:FFT:UNIT ....................................................................................................... 2-96
:MATH<n>:FFT:SCALe ..................................................................................................... 2-96
:MATH<n>:FFT:OFFSet .................................................................................................... 2-97
:MATH<n>:FFT:HSCale .................................................................................................... 2-97
:MATH<n>:FFT:HCENter .................................................................................................. 2-97
:MATH<n>:FFT:FREQuency:STARt .................................................................................... 2-98
:MATH<n>:FFT:FREQuency:END ...................................................................................... 2-98
:MATH<n>:FFT:SEARch:ENABle ........................................................................................ 2-98
:MATH<n>:FFT:SEARch:NUM ........................................................................................... 2-99
:MATH<n>:FFT:SEARch:THReshold .................................................................................. 2-99
MSO5000 Programming Guide V
RIGOL Contents
:MATH<n>:FFT:SEARch:EXCursion .................................................................................... 2-99
:MATH<n>:FFT:SEARch:ORDer ....................................................................................... 2-100
:MATH<n>:FILTer:TYPE .................................................................................................. 2-100
:MATH<n>:FILTer:W1 .................................................................................................... 2-101
:MATH<n>:FILTer:W2 .................................................................................................... 2-101
:MATH<n>:SENSitivity .................................................................................................... 2-102
:MATH<n>:DISTance...................................................................................................... 2-102
:MATH<n>:THReshold1 .................................................................................................. 2-102
:MATH<n>:THReshold2 .................................................................................................. 2-103
:MEASure Commands ............................................................................................................ 2-104
:MEASure:SOURce .......................................................................................................... 2-104
:MEASure:COUNter:ENABle ............................................................................................. 2-105
:MEASure:COUNter:SOURce ............................................................................................ 2-105
:MEASure:COUNter:VALue? ............................................................................................. 2-105
:MEASure:CLEar ............................................................................................................. 2-106
:MEASure:THReshold:SOURce ......................................................................................... 2-106
:MEASure:THReshold:DEFault ......................................................................................... 2-106
:MEASure:MODE ............................................................................................................ 2-106
:MEASure:AMSource ....................................................................................................... 2-107
:MEASure:SETup:MAX ..................................................................................................... 2-107
:MEASure:SETup:MID ..................................................................................................... 2-107
:MEASure:SETup:MIN ..................................................................................................... 2-108
:MEASure:SETup:PSA ...................................................................................................... 2-108
:MEASure:SETup:PSB ...................................................................................................... 2-109
:MEASure:SETup:DSA ..................................................................................................... 2-109
:MEASure:SETup:DSB ..................................................................................................... 2-109
:MEASure:STATistic:DISPlay ............................................................................................ 2-110
:MEASure:STATistic:RESet ............................................................................................... 2-110
:MEASure:STATistic:ITEM ................................................................................................ 2-110
:MEASure:ITEM .............................................................................................................. 2-111
:MEASure:AREA .............................................................................................................. 2-112
:MEASure:CREGion:CAX .................................................................................................. 2-112
:MEASure:CREGion:CBX .................................................................................................. 2-113
:MEASure:CATegory ........................................................................................................ 2-113
:POWer Commands ............................................................................................................... 2-114
:POWer:TYPE ................................................................................................................. 2-114
:POWer:CURRentsource .................................................................................................. 2-114
:POWer:VOLTagesource .................................................................................................. 2-115
:POWer:QUALity:FREQREFerence .................................................................................... 2-115
:POWer:REFLevel:METHod .............................................................................................. 2-115
:POWer:REFLevel:PERCent:HIGH ..................................................................................... 2-116
:POWer:REFLevel:PERCent:LOW...................................................................................... 2-116
:POWer:REFLevel:PERCent:MID ...................................................................................... 2-116
:Quick Command .................................................................................................................. 2-117
:Quick:OPERation ........................................................................................................... 2-117
:RECord Commands .............................................................................................................. 2-118
:RECord:ENABle ............................................................................................................. 2-118
:RECord:STARt ............................................................................................................... 2-118
:RECord:PLAY ................................................................................................................. 2-119
:RECord:CURRent ........................................................................................................... 2-119
:RECord:FRAMes ............................................................................................................ 2-119
:REFerence Commands .......................................................................................................... 2-120
:REFerence:DISPlay ........................................................................................................ 2-120
:REFerence:SOURce ....................................................................................................... 2-120
:REFerence:VSCale ......................................................................................................... 2-121
:REFerence:VOFFset ....................................................................................................... 2-121
:REFerence:RESet........................................................................................................... 2-122
:REFerence:CURRent ...................................................................................................... 2-122
VI MSO5000 Programming Guide
Contents RIGOL
:REFerence:SAVE ........................................................................................................... 2-122
:REFerence:COLor .......................................................................................................... 2-122
:REFerence:LABel:ENABle ............................................................................................... 2-123
:REFerence:LABel:CONTent ............................................................................................. 2-123
:SAVE and :Load Commands ................................................................................................. 2-124
:SAVE:CSV ..................................................................................................................... 2-124
:SAVE:CSV:LENGth ......................................................................................................... 2-124
:SAVE:FORMat ............................................................................................................... 2-125
:SAVE:IMAGe ................................................................................................................. 2-125
:SAVE:IMAGe:TYPE ........................................................................................................ 2-125
:SAVE:IMAGe:INVert ...................................................................................................... 2-126
:SAVE:IMAGe:COLor ....................................................................................................... 2-126
:SAVE:SETup.................................................................................................................. 2-126
:SAVE:WAVeform ........................................................................................................... 2-127
:SAVE:STATus? .............................................................................................................. 2-127
:LOAD:SETup ................................................................................................................. 2-127
:SEARch Commands ............................................................................................................. 2-128
:SEARch:STATe .............................................................................................................. 2-128
:SEARch:MODE .............................................................................................................. 2-129
:SEARch:EVENt .............................................................................................................. 2-129
:SEARch:EDGE:SLOPe .................................................................................................... 2-129
:SEARch:EDGE:SOURce .................................................................................................. 2-130
:SEARch:PULSe:POLarity ................................................................................................ 2-130
:SEARch:PULSe:QUALifier ............................................................................................... 2-130
:SEARch:PULSe:SOURce ................................................................................................. 2-131
:SEARch:RUNT:POLarity ................................................................................................. 2-131
:SEARch:RUNT:QUALifier ................................................................................................ 2-131
:SEARch:RUNT:SOURce .................................................................................................. 2-132
:SEARch:SLOPe:POLarity ................................................................................................ 2-132
:SEARch:SLOPe:QUALifier ............................................................................................... 2-133
:SEARch:SLOPe:SOURce ................................................................................................. 2-133
[:SOURce[<n>]] Commands ................................................................................................. 2-134
[:SOURce[<n>]]:FREQuency[:FIXed] .............................................................................. 2-135
[:SOURce[<n>]]:PHASe[:ADJust] ................................................................................... 2-135
[:SOURce[<n>]]:PHASe:INITiate .................................................................................... 2-136
[:SOURce[<n>]]:FUNCtion[:SHAPe] ................................................................................ 2-136
[:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry ................................................................... 2-137
[:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] ............................................ 2-137
[:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:OFFSet.................................................... 2-138
[:SOURce[<n>]]:PULSe:DCYCle ..................................................................................... 2-138
[:SOURce[<n>]]:MOD:TYPE ........................................................................................... 2-139
[:SOURce[<n>]]:MOD:AM[:DEPTh] ................................................................................ 2-140
[:SOURce[<n>]]:MOD:AM:INTernal:FREQuency .............................................................. 2-140
[:SOURce[<n>]]:MOD:FM:INTernal:FREQuency .............................................................. 2-140
[:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion ................................................................. 2-141
[:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion ................................................................. 2-141
[:SOURce[<n>]]:MOD:FM[:DEVIation] ............................................................................ 2-142
[:SOURce[<n>]]:SWEep:TYPE ........................................................................................ 2-142
[:SOURce[<n>]]:SWEep:STIMe ...................................................................................... 2-143
[:SOURce[<n>]]:SWEep:BTIMe ...................................................................................... 2-143
[:SOURce[<n>]]:BURSt:TYPE ......................................................................................... 2-143
[:SOURce[<n>]]:BURSt:CYCLes ..................................................................................... 2-144
[:SOURce[<n>]]:BURSt:DELay ....................................................................................... 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
MSO5000 Programming Guide VII
RIGOL Contents
[:SOURce[<n>]]:APPLy:SQUare ...................................................................................... 2-145
[:SOURce[<n>]]:APPLy:USER ......................................................................................... 2-145
[:SOURce[<n>]]:OUTPut[<n>][:STATe] .......................................................................... 2-146
[: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:OPTion:INSTall ................................................................................................. 2-154
:SYSTem:OPTion:UNINSTall ............................................................................................ 2-154
:SYSTem:OPTion:STATus? ............................................................................................... 2-154
:SYSTem:RAMount? ........................................................................................................ 2-155
:SYSTem:RESet .............................................................................................................. 2-155
:SYSTem:SETup .............................................................................................................. 2-155
:SYSTem:SSAVEr:TIME ................................................................................................... 2-155
:SYSTem:TIME ............................................................................................................... 2-156
:SYSTem:LOCKed ........................................................................................................... 2-156
:SYSTem:MODules? ........................................................................................................ 2-156
:TIMebase Commands ........................................................................................................... 2-157
:TIMebase:DELay:ENABle ............................................................................................... 2-157
:TIMebase:DELay:OFFSet ............................................................................................... 2-157
:TIMebase:DELay:SCALe ................................................................................................. 2-158
:TIMebase[:MAIN]:OFFSet .............................................................................................. 2-158
:TIMebase[:MAIN]:SCALe ............................................................................................... 2-159
:TIMebase:MODE ........................................................................................................... 2-159
:TIMebase:HREFerence:MODE ........................................................................................ 2-159
:TIMebase:HREFerence:POSition ..................................................................................... 2-160
:TIMebase:VERNier ........................................................................................................ 2-160
:TRIGger Commands ............................................................................................................. 2-161
:TRIGger:MODE ............................................................................................................. 2-162
:TRIGger:COUPling ......................................................................................................... 2-162
:TRIGger:STATus? .......................................................................................................... 2-162
:TRIGger:SWEep ............................................................................................................ 2-163
:TRIGger:HOLDoff .......................................................................................................... 2-163
:TRIGger:NREJect .......................................................................................................... 2-164
:TRIGger:EDGE .............................................................................................................. 2-164
:TRIGger:PULSe ............................................................................................................. 2-166
:TRIGger:SLOPe ............................................................................................................. 2-168
:TRIGger:VIDeo ............................................................................................................. 2-171
:TRIGger:PATTern ........................................................................................................... 2-174
:TRIGger:DURATion ........................................................................................................ 2-176
:TRIGger:TIMeout .......................................................................................................... 2-179
:TRIGger:RUNT .............................................................................................................. 2-181
:TRIGger:WINDows ........................................................................................................ 2-184
:TRIGger:DELay ............................................................................................................. 2-187
:TRIGger:SHOLd ............................................................................................................ 2-191
:TRIGger:NEDGe ............................................................................................................ 2-195
:TRIGger:RS232 (Option) ................................................................................................ 2-197
:TRIGger:IIC (Option)..................................................................................................... 2-200
VIII MSO5000 Programming Guide
Contents RIGOL
:TRIGger:CAN (Option) .................................................................................................. 2-204
:TRIGger:SPI (Option) .................................................................................................... 2-207
:TRIGger:FLEXray (Option) ............................................................................................. 2-212
:TRIGger:IIS (Option) .................................................................................................... 2-214
:TRIGger:LIN (Option) ................................................................................................... 2-218
:TRIGger:M1553 (Option) ............................................................................................... 2-221
:WAVeform Commands ......................................................................................................... 2-223
:WAVeform:SOURce ....................................................................................................... 2-224
:WAVeform:MODE .......................................................................................................... 2-225
:WAVeform:FORMat ....................................................................................................... 2-225
:WAVeform:POINts ......................................................................................................... 2-226
:WAVeform:DATA?.......................................................................................................... 2-226
:WAVeform:XINCrement? ............................................................................................... 2-227
:WAVeform:XORigin? ...................................................................................................... 2-227
:WAVeform:XREFerence? ................................................................................................ 2-227
:WAVeform:YINCrement? ............................................................................................... 2-228
:WAVeform:YORigin? ...................................................................................................... 2-228
:WAVeform:YREFerence? ................................................................................................ 2-228
: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-11
Visual C++ Programming Example ........................................................................................... 3-13
MSO5000 Programming Guide IX
Chapter 1 SCPI Command Overview RIGOL
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
MSO5000 Programming Guide 1-1
RIGOL Chapter 1 SCPI Command Overview
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.
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.
1-2 MSO5000 Programming Guide
Chapter 1 SCPI Command Overview RIGOL
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
MSO5000-PWR@3AEBC07E6C31F82B78A1C401DC2E3AC2CC9431B57F60D1E1CB712F8682C93609A6
05F8577BFDE920373062BE226289A27C134E2C91BF80CB00F8011AC181FD40.
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?
MSO5000 Programming Guide 1-3
Chapter 2 Command System RIGOL
Chapter 2 Command System
This chapter introduces the syntax, functions, parameters, and usage of each MSO5000 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 Command
:RECord Commands
:REFerence Commands
:SAVE and :Load Commands
:SEARch Commands
[:SOURce[<n>]] Commands
:SYSTem Commands
:TIMebase Commands
:TRIGger Commands
:WAVeform Commands
MSO5000 Programming Guide 2-1
RIGOL Chapter 2 Command System
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.
Syntax
:CLEar
Description
Clears all the waveforms on the screen. This command functions the same as the CLEAR
key on the front panel.
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.
Note:
1. Unless otherwise specified, the descriptions in this manual all take MSO5354 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
:CLEar
:RUN
:STOP
2-2 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
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.
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.
:SINGle
:TFORce
MSO5000 Programming Guide 2-3
RIGOL Chapter 2 Command System
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.*/
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|
200M}
AUTO
Remarks
When "AUTO" is selected, the oscilloscope selects the memory depth automatically
according to the current sample rate.
: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
:ACQuire:AVERages
:ACQuire:MDEPth
:ACQuire:TYPE
:ACQuire:SRATe?
:ACQuire:LA:SRATe?
:ACQuire:AALias
[1]
Note
omitted. You can refer to the complete introductions of the commands in the body of the text based on the keywords
listed here.
: In the "Command List" in this manual, the query commands and the parameters in the setting commands are
:ACQuire:AVERages
[1]
:
:ACQuire:MDEPth
2-4 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
The maximum memory depth for the single channel is 200 M; the maximum memory
depth for the half-channel is 100 M; and the maximum memory depth for the
all-channel is 50 M.
Return
Format
The query returns AUTO, 1k, 10k, 100k, 1M, 10M, 25M, 50M, 100M or 200M.
Example
:ACQuire:MDEPth 1M /*Sets the memory depth to 1M.*/
:ACQuire:MDEPth? /*The query returns 1M.*/
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.*/
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
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 MSO5000, the number of grids in the horizontal direction is 10.
Return
The query returns the sample rate in scientific notation.
:ACQuire:TYPE
:ACQuire:SRATe?
MSO5000 Programming Guide 2-5
RIGOL Chapter 2 Command System
Format
Example
:ACQuire:SRATe? /*The query returns 2.500000E+9.*/
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.*/
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.*/
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.*/
:ACQuire:LA:SRATe?
:ACQuire:LA:MDEPth?
:ACQuire:AALias
2-6 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:MODE <mode>
:BUS<n>:MODE?
Description
Sets or queries the decoding type of the specified decoding bus.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<mode>
Discrete
{PARallel|RS232|SPI|IIC|IIS|LIN|CAN|
FLEXray|M1553}
PARallel
Remarks
Except PARallel, all the other decodings are options. Only when the specified option is
installed, can the command is available.
Return
Format
The query returns PAR, RS232, SPI, IIC, IIS, LIN, CAN, FLEX, or M1553.
Example
:BUS1:MODE SPI /*Sets the type of the decoding bus to SPI.*/
:BUS1:MODE? /*The query returns SPI.*/
:BUS<n> Commands
The : BUS<n> commands are used to execute the decoding-related settings and operations.
Command List:
:BUS<n>:MODE
:BUS<n>:DISPlay
:BUS<n>:FORMat
:BUS<n>:EVENt
:BUS<n>:EVENt:FORMat
:BUS<n>:EVENt:VIEW
:BUS<n>:LABel
:BUS<n>:DATA?
:BUS<n>:EEXPort
:BUS<n>:POSition
:BUS<n>:THReshold
:BUS<n>:PARallel
:BUS<n>:RS232 (Option)
:BUS<n>:IIC (Option)
:BUS<n>:SPI (Option)
:BUS<n>:CAN (Option)
:BUS<n>:FLEXray (Option)
:BUS<n>:LIN (Option)
:BUS<n>:IIS (Option)
:BUS<n>:M1553 (Option)
:BUS<n>:MODE
MSO5000 Programming Guide 2-7
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:DISPlay <bool>
:BUS<n>:DISPlay?
Description
Enables or disables the specified decoding bus; or queries the on/off display status of
the specified decoding bus.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Return
Format
The query returns 1 or 0.
Example
:BUS1:DISPlay ON /*Enables the decoding bus.*/
:BUS1:DISPlay? /*The query returns 1.*/
Syntax
:BUS<n>:FORMat <fmt>
:BUS<n>:FORMat?
Description
Sets or queries the display format of decoding data of the specified decoding bus.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<fmt>
Discrete
{HEX|ASCii|DEC|BIN}
ASCii
Remarks
HEX indicates Hexadecimal; DEC indicates Decimal; BIN indicates Binary.
Return
Format
The query returns HEX, ASC, DEC, or BIN.
Example
:BUS1:FORMat HEX /*Sets the display format of the bus to HEX.*/
:BUS1:FORMat? /*The query returns HEX.*/
Syntax
:BUS<n>:EVENt <bool>
:BUS<n>:EVENt?
Description
Enables or disables the event table of the specified decoding bus; or queries the on/off
status of the specified decoding bus event table.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Remarks
Before using the command, enable the specified decoding bus.
Return
Format
The query returns 1 or 0.
Example
:BUS1:EVENt ON /*Enables the event table of the specified decoding bus.*/
:BUS1:EVENt? /*The query returns 1.*/
:BUS<n>:DISPlay
:BUS<n>:FORMat
:BUS<n>:EVENt
2-8 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:EVENt:FORMat <format>
:BUS<n>:EVENt:FORMat?
Description
Sets or queries the display format of the specified decoding bus event table.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<format>
Discrete
{HEX|ASCii|DEC|BIN}
ASCii
Remarks
HEX indicates Hexadecimal; DEC indicates Decimal; BIN indicates Binary.
Return
Format
The query returns HEX, ASC, DEC, or BIN.
Example
:BUS1:EVENt:FORMat HEX
/*Sets the display format of the specified decoding bus event table to HEX.*/
:BUS1:EVENt:FORMat? /*The query returns HEX.*/
Syntax
:BUS<n>:EVENt:VIEW <packet>
:BUS<n>:EVENt:VIEW?
Description
Sets or queries the data page of the specified decoding bus event table.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<packet>
Discrete
{PACKets|DETails|PAYLoad}
PACKets
Remarks
PACKets: displays time, data, and error information in the specified event table.
DETails: displays the detailed data of the specified row in the event table.
PAYLoad: displays all the data of the specified column in the event table.
When different views are selected, the export format of the data list will be
changed accordingly.
Return
Format
The query returns PACK, DET, or PAYL.
Example
:BUS1:EVENt:VIEW DETails /*Sets the data page of the decoding bus event table
to DETails.*/
:BUS1:EVENt:VIEW? /*The query returns DET.*/
:BUS<n>:EVENt:FORMat
:BUS<n>:EVENt:VIEW
MSO5000 Programming Guide 2-9
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:LABel <bool>
:BUS<n>:LABel?
Description
Enables or disables the label of the specified decoding bus; or queries the on/off status
of the label of the specified decoding bus.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Remarks
Before using the command, enable the specified decoding bus.
Return
Format
The query returns 1 or 0.
Example
:BUS1:LABel ON /*Enables the label of the specified decoding bus.*/
:BUS1:LABel? /*The query returns 1.*/
Syntax
:BUS<n>:DATA?
Description
Reads the data in the decoding event table.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
Return
Format
Returns the data in the decoding event table with the following formats.
#9000000072PAL,
Time,Data,,
-1us,0,,
-990.3ns,1,,
-503.2ns,0,,
9.2ns,1,,
497.2ns,0,
Wherein, "#9000000072" is the TMC data block header, which is followed by the data
in the event table. The 9-digit data following #9 in the data block header indicates
the number of bytes of the effective data. "PAL" indicates the decoding type. The
available decoding type can also be RS232, I2C, SPI, or CAN. The data are separated
by commas, and will automatically go to the next line according to the line length
limit in the decoding list. The data value is related to the numeral system that you
have set.
Note: You can save all the data (except TMC data block header and decoding type,
e.g. #9000000072PAL) as the "*.csv" file and view the data in the form of a
list.
:BUS<n>:LABel
:BUS<n>:DATA?
2-10 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:EEXPort
Description
Exports the decoding information in the specified decoding bus event table in CSV form.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
Example
:BUS1:EEXPort C:/123.csv
/*Exports the decoding information in the bus event table to the local Disk C,
with the filename 123.csv.*/
Syntax
:BUS<n>:POSition <pos>
:BUS<n>:POSition?
Description
Sets or queries the vertical position of the bus on the screen.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<pos>
Integer
-167 to +217
Related to the
channel offset
Return
Format
The query returns an integer ranging from -167 to +217.
Example
:BUS1:POSition 200 /*Sets the vertical position of the bus to 200.*/
:BUS1:POSition? /*The query returns 200.*/
Syntax
:BUS<n>:THReshold <value>,<type>
:BUS<n>:THReshold? <type>
Description
Sets or queries the threshold of the specified decoding source.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<value>
Real
(-5× VerticalScale–OFFSet) to
(5× VerticalScale–OFFSet)
0
<type>
Discrete
{PAL|TX|RX|SCL|SDA|CS|CLK|MISO|MO
SI|LIN|CAN|CANSub1}
——
Remarks
For VerticalScale, refer to the :CHANnel<n>:SCALe command. For OFFSet, refer to
the :CHANnel<n>:OFFSet command.
For RS232 decoding, only when the Rx source is enabled, can you set the threshold.
For SPI decoding, only when the MOSI source is enabled, can you set the threshold.
Return
Format
The query returns the threshold of the specified decoding source in scientific notation.
Example
:BUS1:THReshold 2.4,PAL /*Sets the threshold of the PAL decoding source to 2.4 V.*/
:BUS1:THReshold? PAL /*The query returns 2.400000E0.*/
:BUS<n>:EEXPort
:BUS<n>:POSition
:BUS<n>:THReshold
MSO5000 Programming Guide 2-11
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:PARallel:CLK <source>
:BUS<n>:PARallel:CLK?
Description
Sets or queries the clock source of the Parallel decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|CHANnel4|
OFF}
OFF
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
Example
:BUS1:PARallel:CLK D0 /*Sets the clock source of the Parallel decoding to D0.*/
:BUS1:PARallel:CLK? /*The query returns D0.*/
Syntax
:BUS<n>:PARallel:SLOPe <slope>
:BUS<n>:PARallel:SLOPe?
Description
Sets or queries the edge type of the clock channel when being sampled by Parallel
decoding on the data channel.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<slope>
Discrete
{POSitive|NEGative|BOTH}
POSitive
Remarks
If no clock channel is selected, the instrument will sample when the channel data
jumps during the decoding.
Return
Format
The query returns POS, NEG, or BOTH.
:BUS<n>:PARallel
The :BUS<n>:PARallel commands are used to set relevant parameters for Parallel decoding.
Command List:
:BUS<n>:PARallel:CLK
:BUS<n>:PARallel:SLOPe
:BUS<n>:PARallel:WIDTh
:BUS<n>:PARallel:BITX
:BUS<n>:PARallel:SOURce
:BUS<n>:PARallel:POLarity
:BUS<n>:PARallel:NREJect
:BUS<n>:PARallel:NRTime
:BUS<n>:PARallel:CLK
:BUS<n>:PARallel:SLOPe
2-12 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Example
:BUS1:PARallel:SLOPe BOTH /*Sets the Parallel decoding to sample on any edge
of the clock channel.*/
:BUS1:PARallel:SLOPe? /*The query returns BOTH.*/
Syntax
:BUS<n>:PARallel:WIDTh <wid>
:BUS<n>:PARallel:WIDTh?
Description
Sets or queries the data width of the parallel bus, i.g. the number of bits per frame.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<wid>
Integer
0 to 20
1
Remarks
After you send this command to set the data width of the bus, send
the :BUS<n>:PARallel:BITX and :BUS<n>:PARallel:SOURce command to select
the bit respectively and set the channel source for the bit.
Only when the bus source is set to User, can this command be valid.
Return
Format
The query returns an integer ranging from 0 to 20.
Example
:BUS1:PARallel:WIDTh 16 /*Sets the data width of Parallel decoding to 16.*/
:BUS1:PARallel:WIDTh? /*The query returns 16.*/
Syntax
:BUS<n>:PARallel:BITX <bit>
:BUS<n>:PARallel:BITX?
Description
Sets or queries the data bit that the parallel bus requires to set for the channel source.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<bit>
Integer
0 to (data width - 1)
0
Remarks
The data width is set by the :BUS<n>:PARallel:WIDTh command.
After selecting the desired bit, send the :BUS<n>:PARallel:SOURce command to
set the channel source for the bit.
The data bit should be smaller than or equal to the data width.
Return
Format
The query returns the current data bits in integer. Its unit is Hz.
Example
:BUS1:PARallel:BITX 2 /*Sets the current bit to 2.*/
:BUS1:PARallel:BITX? /*The query returns 2.*/
:BUS<n>:PARallel:WIDTh
:BUS<n>:PARallel:BITX
MSO5000 Programming Guide 2-13
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:PARallel:SOURce <src>
:BUS<n>:PARallel:SOURce?
Description
Sets or queries the channel source of the currently selected data bit.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<src>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|CHANnel4}
Related to the
selected bit
Remarks
Before sending this command, send the :BUS<n>:PARallel:BITX command to select
the desired data bit.
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:PARallel:SOURce CHANnel2 /*Sets the channel source of the current bit to
CHANnel2.*/
:BUS1:PARallel:SOURce? /*The query returns CHAN2.*/
Syntax
:BUS<n>:PARallel:POLarity <pol>
:BUS<n>:PARallel:POLarity?
Description
Sets or queries the data polarity of Parallel decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<pol>
Discrete
{NEGative|POSitive}
POSitive
Remarks
NEGative: indicates the negative polarity.
POSitive: indicates the positive polarity.
Return
Format
The query returns NEG or POS.
Example
:BUS1:PARallel:POLarity NEGative /*Sets the data polarity of Parallel decoding to
NEGative.*/
:BUS1:PARallel:POLarity? /*The query returns NEG.*/
Syntax
:BUS<n>:PARallel:NREJect <bool>
:BUS<n>:PARallel:NREJect?
Description
Enables or disables the noise rejection function of Parallel decoding; or queries the
status of the noise rejection function of Parallel decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
:BUS<n>:PARallel:SOURce
:BUS<n>:PARallel:POLarity
:BUS<n>:PARallel:NREJect
2-14 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Remarks
Noise rejection can remove the data that last not enough time on the bus and
eliminate the burst glitch in the actual circuit.
When the noise rejection is enabled, send the :BUS<n>:PARallel:NRTime
command to set the required rejection time.
Return
Format
The query returns 1 or 0.
Example
:BUS1:PARallel:NREJect ON /*Enables the noise rejection function.*/
:BUS1:PARallel:NREJect? /*The query returns 1.*/
Syntax
:BUS<n>:PARallel:NRTime <time>
:BUS<n>:PARallel:NRTime?
Description
Sets or queries the noise rejection time of Parallel decoding. The default unit is s.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<time>
Real
0 ns to 1 s
0.00 s
Return
Format
The query returns the noise rejection time in scientific notation.
Example
:BUS1:PARallel:NRTime 0.01 /*Sets the noise rejection time to 10 ms.*/
:BUS1:PARallel:NRTime? /*The query returns 1.000000E-2.*/
:BUS<n>:PARallel:NRTime
MSO5000 Programming Guide 2-15
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:RS232:TX <source>
:BUS<n>:RS232:TX?
Description
Sets or queries the TX channel source of RS232 decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF}
OFF Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
Example
:BUS1:RS232:TX D0 /*Sets the TX channel source of RS232 decoding to D0.*/
:BUS1:RS232:TX? /*The query returns D0.*/
Syntax
:BUS<n>:RS232:RX <source>
:BUS<n>:RS232:RX?
Description
Sets or queries the RX channel source of RS232 decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF}
OFF
Return
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
:BUS<n>:RS232 (Option)
The :BUS<n>:RS232 commands are used to set relevant parameters for RS232 decoding.
Command List:
:BUS<n>:RS232:TX
:BUS<n>:RS232:RX
:BUS<n>:RS232:POLarity
:BUS<n>:RS232:ENDian
:BUS<n>:RS232:BAUD
:BUS<n>:RS232:DBITs
:BUS<n>:RS232:SBITs
:BUS<n>:RS232:PARity
:BUS<n>:RS232:PACKet
:BUS<n>:RS232:PEND
:BUS<n>:RS232:TX
:BUS<n>:RS232:RX
2-16 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Format
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
Example
:BUS1:RS232:RX D0 /*Sets the RX channel source of RS232 decoding to D0.*/
:BUS1:RS232:RX? /*The query returns D0.*/
Syntax
:BUS<n>:RS232:POLarity <pol>
:BUS<n>:RS232:POLarity?
Description
Sets or queries the polarity of RS232 decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<pol>
Discrete
{POSitive|NEGative}
NEGative
Remarks
The RS232 standard uses "Negative Logic", i.g. high level is Logic 0 and low level is
Logic 1. Therefore, when the parameter <pol> is set to NEGative, it indicates that
the polarity is set to negative logic, i.g. Normal polarity. When the parameter <pol>
is set to POSitive, it indicates that the polarity is set to positive logic, i.g. Inverted
polarity.
In the RS232 decoding, the start bit of data packet indicates when to start data
transmission. It is determined by the polarity. When <pol> is set to "POSitive", the
start bit is 0; when "NEGative", the start bit is 1.
Return
Format
The query returns POS or NEG.
Example
:BUS1:RS232:POLarity POSitive /*Sets the polarity of RS232 decoding to POSitive.*/
:BUS1:RS232:POLarity? /*The query returns POS.*/
Syntax
:BUS<n>:RS232:ENDian <endian>
:BUS<n>:RS232:ENDian?
Description
Sets or queries the endian of data transmission in RS232 decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<endian>
Discrete
{MSB|LSB}
LSB
Remarks
LSB: indicates Least Significant Bit transmission sequence, i.g. the lowest bit of the
data is transmitted first.
MSB: indicates Most Significant Bit transmission sequence, i.g. the highest bit of the
data is transmitted first.
Return
Format
The query returns LSB or MSB.
Example
:BUS1:RS232:ENDian MSB /*Sets the transmission order of RS232 decoding to MSB.*/
:BUS1:RS232:ENDian? /*The query returns MSB.*/
:BUS<n>:RS232:POLarity
:BUS<n>:RS232:ENDian
MSO5000 Programming Guide 2-17
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:RS232:BAUD <baud>
:BUS<n>:RS232:BAUD?
Description
Sets or queries the baud rate of data transmission in RS232 decoding. The default unit
is bps.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<baud>
Integer
1 bps to 20 Mbps
9600 bps
Remarks
If the baud rate is set to a value with "M", then "A" should be added at the end of the
value. For example, if you send 5 M, you need to send 5 MA.
Return
Format
The query returns an integer ranging from 1 bps to 20 Mbps.
Example
:BUS1:RS232:BAUD 4800 /*Sets the baud rate of data transmission in RS232
decoding to 4800 bps.*/
:BUS1:RS232:BAUD? /*The query returns 4800.*/
Syntax
:BUS<n>:RS232:DBITs <bits>
:BUS<n>:RS232:DBITs?
Description
Sets or queries the data width of RS232 decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<bits>
Discrete
{5|6|7|8|9}
8
Return
Format
The query returns 5, 6, 7, 8, or 9.
Example
:BUS1:RS232:DBITs 7 /*Sets the data width of RS232 decoding to 7.*/
:BUS1:RS232:DBITs? /*The query returns 7.*/
Syntax
:BUS<n>:RS232:SBITs <stop bits>
:BUS<n>:RS232:SBITs?
Description
Sets or queries the stop bits of each frame of data in RS232 decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<stop bits>
Discrete
{1|1.5|2}
1
Return
Format
The query returns 1, 1.5, or 2.
Example
:BUS1:RS232:SBITs 2 /*Sets the stop bits of RS232 decoding to 2.*/
:BUS1:RS232:SBITs? /*The query returns 2.*/
:BUS<n>:RS232:BAUD
:BUS<n>:RS232:DBITs
:BUS<n>:RS232:SBITs
2-18 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:RS232:PARity <parity>
:BUS<n>:RS232:PARity?
Description
Sets or queries the odd-even check mode of data transmission in RS232 decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<parity>
Discrete
{NONE|ODD|EVEN}
NONE
Remarks
None: indicates that there is no parity bit in data transmission.
ODD: indicates the odd parity bit. The total count of occurrences of 1 in the data bit
and check bit is an odd number. For example, when 0x55 (01010101) is sent, "1"
should be added to the check bit.
Even: indicates the even parity bit. The total count of occurrences of 1 in the data
bit and check bit is an even number. For example, when 0x55 (01010101) is sent,
"0" should be added to the check bit.
Return
Format
The query returns NONE, ODD, or EVEN.
Example
:BUS1:RS232:PARity ODD /*Sets the odd-even check mode of data
transmission in RS232 decoding to ODD.*/
:BUS1:RS232:PARity? /*The query returns ODD.*/
Syntax
:BUS<n>:RS232:PACKet <bool>
:BUS<n>:RS232:PACKet?
Description
Enables or disables the packet end during data transmission; or queries the status of
packet end during data transmission.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Remarks
When enabled, several data blocks will be combined based on the packet end.
Return
Format
The query returns 1 or 0.
Example
:BUS1:RS232:PACKet ON /*Enables the packet end during data transmission.*/
:BUS1:RS232:PACKet? /*The query returns 1.*/
:BUS<n>:RS232:PARity
:BUS<n>:RS232:PACKet
MSO5000 Programming Guide 2-19
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:RS232:PEND <package end>
:BUS<n>:RS232:PEND?
Description
Sets or queries the packet end type during data transmission.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<package end>
Discrete
{NULL|LF|CR|SP}
NULL
Remarks
The parameters are represented in hexadecimal as follows:
NULL: 00
LF: 0A
CR: 0D
SP: 20
Return
Format
The query returns NULL, LF, CR, or SP.
Example
:BUS1:RS232:PEND LF /*Sets the packet end to 0A.*/
:BUS1:RS232:PEND? /*The query returns LF.*/
:BUS<n>:RS232:PEND
2-20 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:IIC:SCLK:SOURce <source>
:BUS<n>:IIC:SCLK:SOURce?
Description
Sets or queries the clock source of I2C decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D1
1|D12|D13|D14|D15|CHANnel1|CHANnel2|C
HANnel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:IIC:SCLK:SOURce D0 /*Sets the clock source of I2C decoding to D0.*/
:BUS1:IIC:SCLK:SOURce? /*The query returns D0.*/
Syntax
:BUS<n>:IIC:SDA:SOURce <source>
:BUS<n>:IIC:SDA:SOURce?
Description
Sets or queries the data channel source of I2C decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D1
1|D12|D13|D14|D15|CHANnel1|CHANnel2|C
HANnel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:IIC:SDA:SOURce D0 /*Sets the data channel source of I2C decoding to D0.*/
:BUS1:IIC:SDA:SOURce? /*The query returns D0.*/
:BUS<n>:IIC (Option)
The :BUS<n>:IIC commands are used to set relevant parameters for I2C decoding.
Command List:
:BUS<n>:IIC:SCLK:SOURce
:BUS<n>:IIC:SDA:SOURce
:BUS<n>:IIC:ADDRess
:BUS<n>:IIC:SCLK:SOURce
:BUS<n>:IIC:SDA:SOURce
MSO5000 Programming Guide 2-21
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:IIC:ADDRess <addr>
:BUS<n>:IIC:ADDRess?
Description
Sets or queries the address mode of I2C decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<addr>
Discrete
{NORMal|RW}
NORMal
Remarks
NORMal: indicates that the address width does not include the R/W bit.
RW: indicates that the address width includes the R/W bit.
Return
Format
The query returns NORM or RW.
Example
:BUS1:IIC:ADDRess RW /*Sets the address of I2C decoding to include the R/W bit.*/
:BUS1:IIC:ADDRess? /*The query returns RW.*/
:BUS<n>:IIC:ADDRess
2-22 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:SPI:SCLK:SOURce <source>
:BUS<n>:SPI:SCLK:SOURce?
Description
Sets or queries the clock source of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|
D12|D13|D14|D15|CHANnel1|CHANnel2|CHAN
nel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:SPI:SCLK:SOURce D0 /*Sets the clock source of SPI decoding to D0.*/
:BUS1:SPI:SCLK:SOURce? /*The query returns D0.*/
:BUS<n>:SPI (Option)
The :BUS<n>:SPI commands are used to set relevant parameters for SPI decoding.
Command List:
:BUS<n>:SPI:SCLK:SOURce
:BUS<n>:SPI:SCLK:SLOPe
:BUS<n>:SPI:MISO:SOURce
:BUS<n>:SPI:MISO:POLarity
:BUS<n>:SPI:MOSI:SOURce
:BUS<n>:SPI:MOSI:POLarity
:BUS<n>:SPI:DBITs
:BUS<n>:SPI:ENDian
:BUS<n>:SPI:MODE
:BUS<n>:SPI:TIMeout:TIME
:BUS<n>:SPI:SS:SOURce
:BUS<n>:SPI:SS:POLarity
:BUS<n>:SPI:SCLK:SOURce
MSO5000 Programming Guide 2-23
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:SPI:SCLK:SLOPe <slope>
:BUS<n>:SPI:SCLK:SLOPe?
Description
Sets or queries the clock edge type of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return
Format
The query returns POS or NEG.
Example
:BUS1:SPI:SCLK:SLOPe NEGative /*Sets the clock edge type of SPI decoding to
NEGative.*/
:BUS1:SPI:SCLK:SLOPe? /*The query returns NEG.*/
Syntax
:BUS<n>:SPI:MISO:SOURce <source>
:BUS<n>:SPI:MISO:SOURce?
Description
Sets or queries the MISO data source of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D
12|D13|D14|D15|CHANnel1|CHANnel2|CHANnel
3|CHANnel4|OFF}
OFF
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
Example
:BUS1:SPI:MISO:SOURce D0 /*Sets the MISO data source of SPI decoding to D0.*/
:BUS1:SPI:MISO:SOURce? /*The query returns D0.*/
Syntax
:BUS<n>:SPI:MISO:POLarity <polarity>
:BUS<n>:SPI:MISO:POLarity?
Description
Sets or queries the polarity of MISO data line of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<polarity>
Discrete
{HIGH|LOW}
LOW
Remarks
High: indicates that low level is 1, and high level is 0.
Low: indicates that high level is 1, and low level is 0.
Return
Format
The query returns HIGH or LOW.
Example
:BUS1:SPI:MISO:POLarity HIGH /*Sets the polarity of MISO data line to HIGH.*/
:BUS1:SPI:MISO:POLarity? /*The query returns HIGH.*/
:BUS<n>:SPI:SCLK:SLOPe
:BUS<n>:SPI:MISO:SOURce
:BUS<n>:SPI:MISO:POLarity
2-24 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:SPI:MOSI:SOURce <source>
:BUS<n>:SPI:MOSI:SOURce?
Description
Sets or queries the MOSI data source of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|
D12|D13|D14|D15|CHANnel1|CHANnel2|CHANn
el3|CHANnel4|OFF}
OFF
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
Example
:BUS1:SPI:MOSI:SOURce D0 /*Sets the MOSI data source of SPI decoding to D0.*/
:BUS1:SPI:MOSI:SOURce? /*The query returns D0.*/
Syntax
:BUS<n>:SPI:MOSI:POLarity <polarity>
:BUS<n>:SPI:MOSI:POLarity?
Description
Sets or queries the polarity of MOSI data line of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<polarity>
Discrete
{HIGH|LOW}
LOW
Remarks
High: indicates that low level is 1, and high level is 0.
Low: indicates that high level is 1, and low level is 0.
Return
Format
The query returns HIGH or LOW.
Example
:BUS1:SPI:MOSI:POLarity HIGH /*Sets the polarity of MOSI data line to HIGH.*/
:BUS1:SPI:MOSI:POLarity? /*The query returns HIGH.*/
Syntax
:BUS<n>:SPI:DBITs <width>
:BUS<n>:SPI:DBITs?
Description
Sets or queries the data width of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<width>
Integer
4 to 32
8
Return
Format
The query returns an integer ranging from 4 to 32.
Example
:BUS1:SPI:DBITs 10 /*Sets the data width of SPI decoding to 10.*/
:BUS1:SPI:DBITs? /*The query returns 10.*/
:BUS<n>:SPI:MOSI:SOURce
:BUS<n>:SPI:MOSI:POLarity
:BUS<n>:SPI:DBITs
MSO5000 Programming Guide 2-25
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:SPI:ENDian <endian>
:BUS<n>:SPI:ENDian?
Description
Sets or queries the endian of data transmission of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<endian>
Discrete
{MSB|LSB}
MSB
Remarks
MSB: indicates Most Significant Bit transmission sequence, i.g. the highest bit of
the data is transmitted first.
LSB: indicates Least Significant Bit transmission sequence, i.g. the lowest bit of
the data is transmitted first.
Return
Format
The query returns MSB or LSB.
Example
:BUS1:SPI:ENDian LSB /*Sets the endian of data transmission of SPI decoding
to LSB.*/
:BUS1:SPI:ENDian? /*The query returns LSB.*/
Syntax
:BUS<n>:SPI:MODE <mode>
:BUS<n>:SPI:MODE?
Description
Sets or queries the decode mode of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<mode>
Discrete
{CS|TIMeout}
TIMeout
Remarks
CS: indicates chip select. CS: contains a chip select line (CS). You can perform
frame synchronization according to CS.
TIMeout: indicates timed out. You can perform frame synchronization according to
the timeout. At this time, you can send the :BUS<n>:SPI:TIMeout:TIME
command to set the timeout value.
Return
Format
The query returns CS or TIM.
Example
:BUS1:SPI:MODE CS /*Sets the decode mode of SPI decoding to CS.*/
:BUS1:SPI:MODE? /*The query returns CS.*/
:BUS<n>:SPI:ENDian
:BUS<n>:SPI:MODE
2-26 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:SPI:TIMeout:TIME <time>
:BUS<n>:SPI:TIMeout:TIME?
Description
Sets or queries the timeout value of SPI decoding. The default unit is s.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<time>
Real
8 ns to 10 s
1 μs
Remarks
The timeout must be greater than the maximum clock pulse width and less than
the idle time between frames.
This setting command is only valid in timeout mode.
Return
Format
The query returns the timeout value in scientific notation.
Example
:BUS1:SPI:TIMeout:TIME 0.000005 /*Sets the timeout value to 5 μs.*/
:BUS1:SPI:TIMeout:TIME? /*The query returns 5.000000E-6.*/
Syntax
:BUS<n>:SPI:SS:SOURce <source>
:BUS<n>:SPI:SS:SOURce?
Description
Sets or queries the source channel of the CS line of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Real
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|
D12|D13|D14|D15|CHANnel1|CHANnel2|CHAN
nel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:SPI:SS:SOURce D0 /*Sets the source channel of CS line of SPI decoding to
D0.*/
:BUS1:SPI:SS:SOURce? /*The query returns D0.*/
:BUS<n>:SPI:TIMeout:TIME
:BUS<n>:SPI:SS:SOURce
MSO5000 Programming Guide 2-27
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:SPI:SS:POLarity <polarity>
:BUS<n>:SPI:SS:POLarity?
Description
Sets or queries the polarity of CS line of SPI decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<polarity>
Discrete
{HIGH|LOW}
LOW
Remarks
HIGH: indicates that the oscilloscope samples data of the source channel of data
line on the specified edge of the clock signal when the CS signal is high level.
LOW: indicates that the oscilloscope samples data of the source channel of data
line on the specified edge of the clock signal when the CS signal is low level.
Return
Format
The query returns HIGH or LOW.
Example
:BUS1:SPI:SS:POLarity HIGH /*Sets the polarity of CS line of SPI decoding to HIGH.*/
:BUS1:SPI:SS:POLarity? /*The query returns HIGH.*/
:BUS<n>:SPI:SS:POLarity
2-28 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:CAN:SOURce <source>
:BUS<n>:CAN:SOURce?
Description
Sets or queries the source channel of CAN decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|
D12|D13|D14|D15|CHANnel1|CHANnel2|CHAN
nel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:CAN:SOURce D0 /*Sets the source channel of CAN decoding to D0.*/
:BUS1:CAN:SOURce? /*The query returns D0.*/
Syntax
:BUS<n>:CAN:STYPe <stype>
:BUS<n>:CAN:STYPe?
Description
Sets or queries the signal type of CAN decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<stype>
Discrete
{TX|RX|CANH|CANL|DIFFerential}
RX
Remarks
TX: indicates the Transmit signal from the CAN bus transceiver.
RX: indicates the Receive 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. Connect the differential probe's positive lead
to the CAN_H bus signal and connect the negative lead to the CAN_L bus signal.
Return
Format
The query returns TX, RX, CANH, CANL, or DIFF.
Example
:BUS1:CAN:STYPe TX /*Sets the signal type of CAN decoding to TX.*/
:BUS1:CAN:STYPe? /*The query returns TX.*/
:BUS<n>:CAN (Option)
The :BUS<n>:CAN commands are used to set relevant parameters for CAN decoding.
Command List:
:BUS<n>:CAN:SOURce
:BUS<n>:CAN:STYPe
:BUS<n>:CAN:BAUD
:BUS<n>:CAN:SPOint
:BUS<n>:CAN:SOURce
:BUS<n>:CAN:STYPe
MSO5000 Programming Guide 2-29
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:CAN:BAUD <baud>
:BUS<n>:CAN:BAUD?
Description
Sets or queries the signal rate of CAN decoding. The default unit is bps.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<baud>
Integer
10 kbps to 5 Mbps
1 Mbps
Remarks
If the baud rate is set to a value with "M", then "A" should be added at the end of the
value. For example, if you send 5 M, you need to send 5 MA.
Return
Format
The query returns an integer ranging from 10 kbps to 5 Mbps.
Example
:BUS1:CAN:BAUD 120000 /*Sets the signal rate of CAN decoding to 120000 bps.*/
:BUS1:CAN:BAUD? /*The query returns 120000.*/
Syntax
:BUS<n>:CAN:SPOint <spoint>
:BUS<n>:CAN:SPOint?
Description
Sets or queries the sample point position of CAN decoding (expressed in %).
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<spoint>
Integer
10 to 90
50
Remarks
Sample point is a point within a bit’s time. The oscilloscope samples the bit level at this
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 ranging from 10 to 90.
Example
:BUS1:CAN:SPOint 70 /*Sets the sample point position of CAN decoding to 70%.*/
:BUS1:CAN:SPOint? /*The query returns 70.*/
:BUS<n>:CAN:BAUD
:BUS<n>:CAN:SPOint
2-30 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:FLEXray:BAUD <baud>
:BUS<n>:FLEXray:BAUD?
Description
Sets or queries the signal rate of FlexRay decoding. The default unit is bps.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<baud>
Discrete
{2500000|5000000|10000000}
10000000
Return
Format
The query returns 2500000, 5000000, or 10000000.
Example
:BUS1:FLEXray:BAUD 2500000 /*Sets the signal rate of FlexRay decoding to
2500000 bps.*/
:BUS1:FLEXray:BAUD? /*The query returns 2500000.*/
Syntax
:BUS<n>:FLEXray:SOURce <source>
:BUS<n>:FLEXray:SOURce?
Description
Sets or queries the source channel of FlexRay decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|
D12|D13|D14|D15|CHANnel1|CHANnel2|CHAN
nel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:FlexRay:SOURce D0 /*Sets the source channel of FlexRay decoding to D0.*/
:BUS1:FlexRay:SOURce? /*The query returns D0.*/
:BUS<n>:FLEXray (Option)
The :BUS<n>:FLEXray commands are used to set the relevant parameters for FLEXray decoding.
Command List:
:BUS<n>:FLEXray:BAUD
:BUS<n>:FLEXray:SOURce
:BUS<n>:FLEXray:SPOint
:BUS<n>:FLEXray:STYPe
:BUS<n>:FLEXray:BAUD
:BUS<n>:FLEXray:SOURce
MSO5000 Programming Guide 2-31
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:FLEXray:SPOint <spoint>
:BUS<n>:FLEXray:SPOint?
Description
Sets or queries the sample point position of FlexRay decoding (expressed in %).
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<spoint>
Integer
10 to 90
50
Remarks
Sample point is a point within a bit’s time. The oscilloscope samples the bit level at this
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 ranging from 10 to 90.
Example
:BUS1:FLEXray:SPOint 70 /*Sets the sample point position of FlexRay decoding to
70%.*/
:BUS1:FLEXray:SPOint? /*The query returns 70.*/
Syntax
:BUS<n>:FLEXray:STYPe <stype>
:BUS<n>:FLEXray:STYPe?
Description
Sets or queries the signal type of FlexRay decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<stype>
Discrete
{BP|BM|RT}
BP
Return
Format
The query returns BP, BM, or RT.
Example
:BUS1:FLEXray:STYPe BM /*Sets the signal type of FlexRay decoding to BM.*/
:BUS1:FLEXray:STYPe? /*The query returns BM.*/
:BUS<n>:FLEXray:SPOint
:BUS<n>:FLEXray:STYPe
2-32 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:LIN:BAUD <baud>
:BUS<n>:LIN:BAUD?
Description
Sets or queries the baud rate of LIN decoding. The default unit is bps。
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<baud>
Integer
2.4 kbps to 20 Mbps
19200 bps
Remarks
If the baud rate is set to a value with "M", then "A" should be added at the end of the
value. For example, if you send 5 M, you need to send 5 MA.
Return
Format
The query returns an integer ranging from 2.4 kbps to 20 Mbps.
Example
:BUS1:LIN:BAUD 9600 /*Sets the baud rate of LIN decoding to 9600 bps.*/
:BUS1:LIN:BAUD? /*The query returns 9600.*/
Syntax
:BUS<n>:LIN:POLarity <bool>
:BUS<n>:LIN:POLarity?
Description
Sets or queries the parity bit of LIN decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Return
Format
The query returns 0 or 1.
Example
:BUS1:LIN:POLarity ON /*Sets the parity bit to be included in LIN decoding.*/
:BUS1:LIN:POLarity? /*The query returns 1.*/
:BUS<n>:LIN (Option)
The :BUS<n>:LIN commands are used to set relevant parameters for LIN decoding.
Command List:
:BUS<n>:LIN:BAUD
:BUS<n>:LIN:POLarity
:BUS<n>:LIN:SOURce
:BUS<n>:LIN:STANdard
:BUS<n>:LIN:BAUD
:BUS<n>:LIN:POLarity
MSO5000 Programming Guide 2-33
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:LIN:SOURce <source>
:BUS<n>:LIN:SOURce?
Description
Sets or queries the source of LIN bus.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:LIN:SOURce D0 /*Sets the source of LIN bus to D0.*/
:BUS1:LIN:SOURce? /*The query returns D0.*/
Syntax
:BUS<n>:LIN:STANdard <value>
:BUS<n>:LIN:STANdard?
Description
Sets or queries the version of LIN bus.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<value>
Discrete
{V1X|V2X|MIXed}
V1X
Return
Format
The query returns V1X, V2X, or MIX.
Example
:BUS1:LIN:STANdard V2X /*Sets the version of LIN bus to V2X.*/
:BUS1:LIN:STANdard? /*The query returns V2X.*/
:BUS<n>:LIN:SOURce
:BUS<n>:LIN:STANdard
2-34 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:IIS:SOURce:CLOCk <source>
:BUS<n>:IIS:SOURce:CLOCk?
Description
Sets or queries the clock source of the I2S decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D
11|D12|D13|D14|D15|CHANnel1|CHANnel2
|CHANnel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:IIS:SOURce:CLOCk D0 /*Sets the clock source of the I2S decoding to D0.*/
:BUS1:IIS:SOURce:CLOCk? /*The query returns D0.*/
Syntax
:BUS<n>:IIS:SOURce:DATA<source>
:BUS<n>:IIS:SOURce:DATA?
Description
Sets or queries the data source of the I2S decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D
11|D12|D13|D14|D15|CHANnel1|CHANnel2
|CHANnel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:IIS:SOURce:DATA D0 /*Sets the data source of the I2S decoding to D0.*/
:BUS1:IIS:SOURce:DATA? /*The query returns D0.*/
:BUS<n>:IIS (Option)
The :BUS<n>:IIC commands are used to set relevant parameters for I2S decoding. The commands are
only available for the MSO5XX4 model or the model installed with the MSO5000-4CH option.
Command List:
:BUS<n>:IIS:SOURce:CLOCk
:BUS<n>:IIS:SOURce:DATA
:BUS<n>:IIS:SOURce:WSELect
:BUS<n>:IIS:ALIGnment
:BUS<n>:IIS:CLOCk:SLOPe
:BUS<n>:IIS:RWIDth
:BUS<n>:IIS:SOURce:CLOCk
:BUS<n>:IIS:SOURce:DATA
MSO5000 Programming Guide 2-35
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:IIS:SOURce:WSELect <source>
:BUS<n>:IIS:SOURce:WSELect?
Description
Sets or queries the audio channel of the I2S trigger.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D1
1|D12|D13|D14|D15|CHANnel1|CHANnel2|C
HANnel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:IIS:SOURce:WSELect CHANnel2 /*Sets the audio channel to CHANnel2.*/
:BUS1:IIS:SOURce:WSELect? /*The query returns CHAN2.*/
Syntax
:BUS<n>:IIS:ALIGnment <align>
:BUS<n>:IIS:ALIGnment?
Description
Sets or queries the alignment mode of the I2S decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<align>
Discrete
{IIS|RJ|LJ}
IIS
Remarks
IIS: first sends MSB of each sample data and then sends LSB.
RJ: data transmission (MSB first) is right-justified to the WS transition.
LJ: data transmission (MSB first) begins at the edge of the WS transition.
Return
Format
The query returns IIS, RJ, or LJ.
Example
:BUS1:IIS:ALIGnment RJ /*Sets the alignment mode of the I2S decoding to RJ.*/
:BUS1:IIS:ALIGnment? /*The query returns RJ.*/
Syntax
:BUS<n>:IIS:CLOCk:SLOPe <slope>
:BUS<n>:IIS:CLOCk:SLOPe?
Description
Sets or queries the clock edge type of I2S decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<slope>
Discrete
{NEGative|POSitive}
POSitive
Return
Format
The query returns POS or NEG.
Example
:BUS1:IIS:CLOCk:SLOPe NEGative /*Sets the clock edge of I2S decoding to
NEGative.*/
:BUS1:IIS:CLOCk:SLOPe? /*The query returns NEG.*/
:BUS<n>:IIS:SOURce:WSELect
:BUS<n>:IIS:ALIGnment
:BUS<n>:IIS:CLOCk:SLOPe
2-36 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:BUS<n>:IIS:RWIDth <val>
:BUS<n>:IIS:RWIDth?
Description
Sets or queries the word size of the I2S decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<val>
Integer
4 to 32
8
Return
Format
The query returns an integer ranging from 4 to 32.
Example
:BUS1:IIS:RWIDth 5 /*Sets the word size of I2S decoding to 5.*/
:BUS1:IIS:RWIDth? /*The query returns 5.*/
:BUS<n>:IIS:RWIDth
MSO5000 Programming Guide 2-37
RIGOL Chapter 2 Command System
Syntax
:BUS<n>:M1553:SOURce <source>
:BUS<n>:M1553:SOURce?
Description
Sets or queries the source of the M1553 decoding.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
——
<source>
Discrete
{CHANnel1|CHANnel2|CHANnel3|CHANnel4}
CHANnel1
Return
Format
The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:M1553:SOURce CHANnel2
/* Sets the source of the M1553 decoding to CHANnel2.*/
:BUS1:M1553:SOURce?
/*The query returns CHAN2.*/
:BUS<n>:M1553 (Option)
The :BUS<n>:M1553 commands are used to set relevant parameters for the M1553 decoding.
Command List:
:BUS<n>:M1553:SOURce
:BUS<n>:M1553:SOURce
2-38 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CHANnel<n>:BWLimit <type>
:CHANnel<n>:BWLimit?
Description
Sets or queries the bandwidth limit of the specified channel.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
1
<type>
Discrete
Refer to Remarks
OFF
Remarks
The range of <type> is related to the instrument model.
MSO5354: {20M|100M|200M|OFF}
MSO5204: {20M|100M|OFF}
MSO5072/MSO5074/MSO5102/MSO5104: {20M|OFF}
20M, 100M, or 200M: When you enable the bandwidth limit and limit it to 20 MHz,
100 MHz, or 200 MHz, the high frequency components found in the signal under test
that are greater than 20 MHz, 100 MHz, or 200 MHz are attenuated.
OFF: disables the bandwidth limit function. The high-frequency components in the
signal under test can pass through the channel.
Return
Format
The query returns 20M, 100M, 200M, or OFF.
Example
:CHANnel1:BWLimit 20M /*Enables the 20 MHz bandwidth limit.*/
:CHANnel1:BWLimit? /*The query returns 20M.*/
:CHANnel<n> Commands
The :CHANnel<n> commands are used to set or query the bandwidth limit, coupling, vertical scale, vertical
offset, and other vertical system parameters of the analog channel.
Command List:
:CHANnel<n>:BWLimit
:CHANnel<n>:COUPling
:CHANnel<n>:DISPlay
:CHANnel<n>:INVert
:CHANnel<n>:OFFSet
:CHANnel<n>:TCALibrate
:CHANnel<n>:SCALe
:CHANnel<n>:PROBe
:CHANnel<n>:UNITs
:CHANnel<n>:VERNier
:CHANnel<n>:BWLimit
MSO5000 Programming Guide 2-39
RIGOL Chapter 2 Command System
Syntax
:CHANnel<n>:COUPling <coupling>
:CHANnel<n>:COUPling?
Description
Sets or queries the coupling mode of the specified channel.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
1
<coupling>
Discrete
{AC|DC}
DC
Remarks
AC: the DC components of the signal under test are blocked.
DC: both DC and AC components of the signal under test can pass through the
channel.
Return
Format
The query returns AC or DC.
Example
:CHANnel1:COUPling AC /*Selects the AC coupling mode.*/
:CHANnel1:COUPling? /*The query returns AC.*/
Syntax
:CHANnel<n>:DISPlay <bool>
:CHANnel<n>:DISPlay?
Description
Turns on or off the specified channel; or queries the on/off status of the specified
channel.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
1
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Return
Format
The query returns 1 or 0.
Example
:CHANnel1:DISPlay ON /*Enables CH1.*/
:CHANnel1:DISPlay? /*The query returns 1.*/
Syntax
:CHANnel<n>:INVert <bool>
:CHANnel<n>:INVert?
Description
Turns on or off the waveform invert for the specified channel; or queries the on/off
status of the waveform invert for the specified channel.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
1
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Remarks
When the waveform invert is turned off, the waveform is displayed normally; when
the waveform invert is turned on, the voltage values of the displayed waveform are
inverted.
Return Format
The query returns 1 or 0.
:CHANnel<n>:COUPling
:CHANnel<n>:DISPlay
:CHANnel<n>:INVert
2-40 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Example
:CHANnel1:INVert ON /*Enables the waveform invert for CH1.*/
:CHANnel1:INVert? /*The query returns 1.*/
Syntax
:CHANnel<n>:OFFSet <offset>
:CHANnel<n>:OFFSet?
Description
Sets or queries the vertical offset of the specified channel. The default unit is V.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
1
<offset>
Real
± 1 V (1 mV/div to 50 mV/div).
± 30 V (51 mV/div to 260 mV/div)
± 100 V (265 mV/div to 1 V/div)
0 V
Return
Format
The query returns the vertical offset in scientific notation.
Example
:CHANnel1:OFFSet 0.01 /*Sets the vertical offset of CH1 to 10 mV.*/
:CHANnel1:OFFSet? /*The query returns 1E-2.*/
Syntax
:CHANnel<n>:TCALibrate <val>
:CHANnel<n>:TCALibrate?
Description
Sets or queries the delay calibration time (used to calibrate the zero offset of the
corresponding channel) of the specified channel. The default unit is s.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
1
<val>
Real
-100 ns to 100 ns
0 s
Remarks
Set the parameter <val> to a specific value at a specified step. If the parameter value
is not within the settable range, select the value that is closest to the range
automatically. In different horizontal time bases, the step values for the parameter are
different.
When the horizontal time base is greater than 10 μs, the parameter <val> cannot be
set.
Return
Format
The query returns the delay calibration time in scientific notation.
Example
:CHANnel1:TCALibrate 0.00000002 /*Sets the delay calibration time to 20 ns.*/
:CHANnel1:TCALibrate? /*The query returns 2.000000E-8.*/
:CHANnel<n>:OFFSet
:CHANnel<n>:TCALibrate
MSO5000 Programming Guide 2-41
RIGOL Chapter 2 Command System
Syntax
:CHANnel<n>:SCALe <scale>
:CHANnel<n>:SCALe?
Description
Sets or queries the vertical scale of the specified channel. The default unit is V.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
1
<scale>
Real
The input impedance is 1 MΩ and the
probe ratio is 1X: 1 mV to 10 V
100 mV
Remarks
You can use the :CHANnel<n>:VERNier command to enable or disable the fine
adjustment setting for the vertical scale of the specif ied channel. By default, the fine
adjustment is Off. At this time, you can set the vertical scale at 1-2-5 step, i.g. 10 mV, 20
mV, 50 mV…100 V. When the fine adjustment is enabled, you can further adjust the
vertical scale within a relatively smaller range to improve vertical resolution. If the
amplitude of the input waveform is a little bit greater than the full scale under the current
scale and the amplitude would be a little bit lower if the next scale is used, fine
adjustment can be used to improve the amplitude of waveform display to view signal
details.
Return
Format
The query returns the vertical scale in scientific notation.
Example
:CHANnel1:SCALe 1 /*Sets the vertical scale of CH1 to 1 V.*/
:CHANnel1:SCALe? /*The query returns 1.*/
Syntax
:CHANnel<n>:PROBe <atten>
:CHANnel<n>:PROBe?
Description
Sets or queries the probe ratio of the specified channel.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
1
<atten>
Discrete
{0.01|0.02|0.05|0.1|0.2|0.5|1|2|5|10|20|50|
100|200|500|1000|2000|5000|10000|20000|
50000}
1
Remarks
Sets the probe ratio. That is, multiply the acquired signal by a specified number (not
affect the actual amplitude of the signal).
The set probe ratio affects the settable range of the current vertical scale.
Return
Format
The query returns 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, 100, 200, 500, 1000,
2000, 5000, 10000, 20000, or 50000.
Example
:CHANnel1:PROBe 10 /*Sets the probe ratio of CH1 to 10X.*/
:CHANnel1:PROBe? /*The query returns 10.*/
:CHANnel<n>:SCALe
:CHANnel<n>:PROBe
2-42 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CHANnel<n>:UNITs <units>
:CHANnel<n>:UNITs?
Description
Sets or queries the amplitude display unit of the specified analog channel.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
1
<units>
Discrete
{VOLTage|WATT|AMPere|UNKNown}
VOLTage
Return
Format
The query returns VOLT, WATT, AMP, or UNKN.
Example
:CHANnel1:UNITs VOLTage /*Sets the amplitude display unit of CH1 to VOLTage.*/
:CHANnel1:UNITs? /*The query returns VOLT.*/
Syntax
:CHANnel<n>:VERNier <bool>
:CHANnel<n>:VERNier?
Description
Enables or disables the fine adjustment of the vertical scale of the specified analog
channel; or queries the on/off status of the fine adjustment function of the vertical scale
of the specified analog channel.
Parameter
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
1
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Remarks
By default, the fine adjustment is Off. At this time, you can set the vertical scale at 1-2-5
step, i.g. 10 mV, 20 mV, 50 mV, 100 mV…100 V. When the fine adjustment is enabled, you
can further adjust the vertical scale within a relatively smaller range to improve vertical
resolution. If the amplitude of the input waveform is a little bit greater than the full scale
under the current scale and the amplitude would be a little bit lower if the next scale is
used, fine adjustment can be used to improve the amplitude of waveform display to view
signal details.
Return
Format
The query returns 1 or 0.
Example
:CHANnel1:VERNier ON /*Enables the fine adjustment of the vertical scale of CH1.*/
:CHANnel1:VERNier? /*The query returns 1.*/
:CHANnel<n>:UNITs
:CHANnel<n>:VERNier
MSO5000 Programming Guide 2-43
RIGOL Chapter 2 Command System
Syntax
:COUNter:CURRent?
Description
Queries the measurement value of the frequency counter.
Return
Format
The query returns 1.000006E+3.
Syntax
:COUNter:ENABle <bool>
:COUNter:ENABle?
Description
Enables or disables the frequency counter; or queries the on/off status of
the frequency counter.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Return
Format
The query returns 1 or 0.
Example
:COUNter:ENABle ON /*Enables the frequency counter.*/
:COUNter:ENABle? /*The query returns 1.*/
Syntax
:COUNter:SOURce <source>
:COUNter:SOURce?
Description
Sets or queries the source of the frequency counter.
Parameter
Name
Type
Range
Default
<source>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|
D8|D9|D10|D11|D12|D13|D14
|D15|CHANnel1|CHANnel2|CH
ANnel3|CHANnel4}
CHANnel1
Return
Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12,
D13, D14, D15, CHAN1, CHAN2, CHAN3, or CHAN4.
:COUNter Commands
Command List:
:COUNter:CURRent?
:COUNter:ENABle
:COUNter:SOURce
:COUNter:MODE
:COUNter:NDIGits
:COUNter:TOTalize:ENABle
:COUNter:TOTalize:CLEar
:COUNter:CURRent?
:COUNter:ENABle
:COUNter:SOURce
2-44 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Example
:COUNter:SOURce CHANnel2 /*Sets the source of the frequency
counter to CHANnel2.*/
:COUNter:SOURce? /*The query returns CHAN2.*/
Syntax
:COUNter:MODE <mode>
:COUNter:MODE?
Description
Sets or queries the mode of the frequency counter.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{FREQuency|PERiod|TOTalize}
FREQuency
Return
Format
The query returns FREQ, PER, or TOT.
Example
:COUNter:MODE PERiod /*Sets the mode of the frequency counter to
PERiod.*/
:COUNter:MODE? /*The query returns PER.*/
Syntax
:COUNter:NDIGits <val>
:COUNter:NDIGits?
Description
Sets or queries the resolution of the frequency counter.
Parameter
Name
Type
Range
Default
<val>
Integer
3-6
5
Remarks
The resolution setting is only available for "Period" and "Frequency", and
unavailable for "Totalize".
Return
Format
The query returns an integer ranging from 3 to 6.
Example
:COUNter:NDIGits 4 /*Sets the resolution of the frequency
counter to 4.*/
:COUNter:NDIGits? /*The query returns 4.*/
Syntax
:COUNter:TOTalize:ENABle <bool>
:COUNter:TOTalize:ENABle?
Description
Enables or disables the statistical function of the frequency counter; or
queries the on/off status of the statistical function of the frequency counter.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Remarks
Not available for "Period" and "Frequency".
Return
Format
The query returns 1 or 0.
:COUNter:MODE
:COUNter:NDIGits
:COUNter:TOTalize:ENABle
MSO5000 Programming Guide 2-45
RIGOL Chapter 2 Command System
Example
:COUNter:TOTalize:ENABle ON /*Enables the statistical function of the
frequency counter.*/
:COUNter:TOTalize:ENABle? /*The query returns 1.*/
Syntax
:COUNter:TOTalize:CLEar
Description
Clears the total count.
Description
Available when "Totalize" is selected under "Measure".
:COUNter:TOTalize:CLEar
2-46 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CURSor:MODE <mode>
:CURSor:MODE?
Description
Sets or queries the mode of the cursor measurement.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{OFF|MANual|TRACk|XY}
OFF
Remarks
OFF: disables the cursor measurement function.
MANual: enables the manual mode of cursor measurement.
TRACk: enables the track cursor mode.
XY: enables the XY cursor measurement mode. This mode is valid when you select
"XY" for the horizontal time base.
Return
Format
The query returns OFF, MAN, TRAC, or XY.
Example
:CURSor:MODE MANual /*Selects the manual cursor measurement mode.*/
:CURSor:MODE? /*The query returns MAN.*/
:CURSor Commands
The :CURSor commands are used to measure the X axis values (e.g. Time) and Y axis values (e.g. Voltage)
of the waveform on the screen.
Command List:
:CURSor:MODE
:CURSor:MANual
:CURSor:TRACk
:CURSor:XY
:CURSor:MODE
MSO5000 Programming Guide 2-47
RIGOL Chapter 2 Command System
Syntax
:CURSor:MANual:TYPE <type>
:CURSor:MANual:TYPE?
Description
Sets or queries the cursor type in the manual mode of cursor measurement.
Parameter
Name
Type
Range
Default
<type>
Discrete
{TIME|AMPLitude}
TIME
Remarks
TIME: indicates X cursor, which is often used to measure the time parameters.
AMPLitude: indicates Y cursor, which is often used to measure the voltage
parameters.
Return
Format
The query returns TIME or AMPL.
Example
:CURSor:MANual:TYPE AMPLitude /*Sets the cursor type to AMPLitude.*/
:CURSor:MANual:TYPE? /*The query returns AMPL.*/
:CURSor:MANual
Command List:
:CURSor:MANual:TYPE
:CURSor:MANual:SOURce
:CURSor:MANual:TUNit
:CURSor:MANual:VUNit
:CURSor:MANual:CAX
:CURSor:MANual:CBX
:CURSor:MANual:CAY
:CURSor:MANual:CBY
:CURSor:MANual:AXValue?
:CURSor:MANual:AYValue?
:CURSor:MANual:BXValue?
:CURSor:TRACk:BYValue?
:CURSor:MANual:XDELta?
:CURSor:MANual:IXDELta?
:CURSor:MANual:YDELta?
:CURSor:MANual:TYPE
2-48 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CURSor:MANual:SOURce <source>
:CURSor:MANual:SOURce?
Description
Sets or queries the channel source of the manual mode of cursor measurement.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|CHANnel3|CHANnel4|
MATH1|MATH2|MATH3|MATH4|LA|NONE}
CHANnel1
Remarks
Only the currently enabled channel can be selected as the channel source.
When LA is selected, the cursor type cannot be set to Y (:CURSor:MANual:TYPE).
Return
Format
The query returns CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, MATH4,
LA, or NONE.
Example
:CURSor:MANual:SOURce CHANnel2 /*Sets the channel source to CHANnel2.*/
:CURSor:MANual:SOURce? /*The query returns CHAN2.*/
Syntax
:CURSor:MANual:TUNit <unit>
:CURSor:MANual:TUNit?
Description
Sets or queries the horizontal unit in the manual mode of cursor measurement.
Parameter
Name
Type
Range
Default
<unit>
Discrete
{SECond|HZ|DEGRee|PERCent}
SECond
Remarks
SECond: in the measurement results, AX, BX, and △ X are expressed in "s"; 1/△X in
"Hz".
HZ: in the measurement results, AX, BX, and △ X are expressed in "Hz"; 1/△X in
"s".
DEGRee: in the measurement results, AX, BX, and △ X are expressed in "°".
PERCent: in the measurement results, AX, BX, and △ X are expressed in
percentage.
Return
Format
The query returns SEC, HZ, DEGR, or PERC.
Example
:CURSor:MANual:TUNit DEGRee /*Sets the horizontal unit to DEGRee.*/
:CURSor:MANual:TUNit? /*The query returns DEGR.*/
:CURSor:MANual:SOURce
:CURSor:MANual:TUNit
MSO5000 Programming Guide 2-49
RIGOL Chapter 2 Command System
Syntax
:CURSor:MANual:VUNit <unit>
:CURSor:MANual:VUNit?
Description
Sets or queries the vertical unit in the manual mode of cursor measurement.
Parameter
Name
Type
Range
Default
<unit>
Discrete
{SOURce|PERCent}
SOUR
Remarks
SOURce: in the measurement results, the unit of AY, BY, and △ Y are automatically
set to the unit of the current source.
PERCent: in the measurement results, the unit of AY, BY, and △Y are expressed in
percentage.
Return
Format
The query returns SOUR or PERC.
Example
:CURSor:MANual:VUNit PERCent /*Sets AY, BY, and △ Y to be expressed in percentage in
the measurement results.*/
:CURSor:MANual:VUNit? /*The query returns PERC.*/
Syntax
:CURSor:MANual:CAX <ax>
:CURSor:MANual:CAX?
Description
Sets or queries the horizontal position of Cursor A in the manual mode of cursor
measurement.
Parameter
Name
Type
Range
Default
<ax>
Integer
0 to 999
400
Remarks
The horizontal and vertical position of the cursor is defined by the screen pixel coordinate.
The range of the screen pixel coordinate is from (0,0) to (999,479). Wherein, (0,0) is a
location at the upper-left corner of the screen, and (999,479) is a location at the
lower-right corner of the screen. The pixel range in the horizontal direction is from 0 to
999, and the pixel range in the vertical direction is from 0 to 479.
Return
Format
The query returns an integer ranging from 0 to 999.
Example
:CURSor:MANual:CAX 200 /*Sets the horizontal position of Cursor A to 200.*/
:CURSor:MANual:CAX? /*The query returns 200.*/
:CURSor:MANual:VUNit
:CURSor:MANual:CAX
2-50 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CURSor:MANual:CBX <bx>
:CURSor:MANual:CBX?
Description
Sets or queries the horizontal position of Cursor B in the manual mode of cursor
measurement.
Parameter
Name
Type
Range
Default
<bx>
Integer
0 to 999
600
Remarks
The horizontal and vertical position of the cursor is defined by the screen pixel coordinate.
The range of the screen pixel coordinate is from (0,0) to (999,479). Wherein, (0,0) is a
location at the upper-left corner of the screen, and (999,479) is a location at the
lower-right corner of the screen. The pixel range in the horizontal direction is from 0 to
999, and the pixel range in the vertical direction is from 0 to 479.
Return
Format
The query returns an integer ranging from 0 to 999.
Example
:CURSor:MANual:CBX 200 /*Sets the horizontal position of Cursor B to 200.*/
:CURSor:MANual:CBX? /*The query returns 200.*/
Syntax
:CURSor:MANual:CAY <ay>
:CURSor:MANual:CAY?
Description
Sets or queries the vertical position of Cursor A in the manual mode of cursor
measurement.
Parameter
Name
Type
Range
Default
<ay>
Integer
0 to 479
180
Remarks
The horizontal and vertical position of the cursor is defined by the screen pixel
coordinate. The range of the screen pixel coordinate is from (0,0) to (999,479).
Wherein, (0,0) is a location at the upper-left corner of the screen, and (999,479) is
a location at the lower-right corner of the screen. The pixel range in the horizontal
direction is from 0 to 999, and the pixel range in the vertical direction is from 0 to
479.
When you select LA as the channel source in the manual mode of cursor
measurement, this command is invalid.
Return
Format
The query returns an integer ranging from 0 to 479.
Example
:CURSor:MANual:CAY 200 /*Sets the vertical position of Cursor A to 200.*/
:CURSor:MANual:CAY? /*The query returns 200.*/
:CURSor:MANual:CBX
:CURSor:MANual:CAY
MSO5000 Programming Guide 2-51
RIGOL Chapter 2 Command System
Syntax
:CURSor:MANual:CBY <by>
:CURSor:MANual:CBY?
Description
Sets or queries the vertical position of Cursor B in the manual mode of cursor
measurement.
Parameter
Name
Type
Range
Default
<by>
Integer
0 to 479
300
Remarks
The horizontal and vertical position of the cursor is defined by the screen pixel
coordinate. The range of the screen pixel coordinate is from (0,0) to (1000,480).
Wherein, (0,0) is a location at the upper-left corner of the screen, and (1000,480)
is a location at the lower-right corner of the screen. The pixel range in the
horizontal direction is from 0 to 1000, and the pixel range in the vertical direction
is from 0 to 480.
When you select LA as the channel source in the manual mode of cursor
measurement, this command is invalid.
Return
Format
The query returns an integer ranging from 0 to 479.
Example
:CURSor:MANual:CBY 200 /*Sets the vertical position of Cursor B to 200.*/
:CURSor:MANual:CBY? /*The query returns 200.*/
Syntax
:CURSor:MANual:AXValue?
Description
Queries the X value at Cursor A in the manual mode of cursor measurement. The unit is
determined by the currently selected horizontal unit.
Return
Format
The query returns the X value at Cursor A in scientific notation.
Syntax
:CURSor:MANual:AYValue?
Description
Queries the Y value at Cursor A in the manual mode of cursor measurement. The unit is
determined by the currently selected vertical unit.
Return
Format
When the channel source is CHANnel1, CHANnel2, CHANnel3, CHANnel4, MATH1,
MATH2, MATH3, or MATH4, the query returns the Y value at Cursor A in scientific
notation.
When the channel source is LA, the query returns a decimal integer that
corresponds to the binary or hex weighted sum of the bits (D15-D0) at Cursor A.
For the disabled channel, the query returns 0 by default.
Syntax
:CURSor:MANual:BXValue?
Description
Queries the X value at Cursor B in the manual mode of cursor measurement. The unit
is determined by the currently selected horizontal unit.
Return Format
The query returns the X value at Cursor B in scientific notation.
:CURSor:MANual:CBY
:CURSor:MANual:AXValue?
:CURSor:MANual:AYValue?
:CURSor:MANual:BXValue?
2-52 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CURSor:MANual:BYValue?
Description
Queries the Y value at Cursor B in the manual mode of cursor measurement. The unit is
determined by the currently selected vertical unit.
Return
Format
When the channel source is CHANnel1, CHANnel2, CHANnel3, CHANnel4, MATH1,
MATH2, MATH3, or MATH4, the query returns the Y value at Cursor B in scientific
notation.
When the channel source is LA, the query returns a decimal integer that corresponds
to the binary or hex weighted sum of the bits (D15-D0) at Cursor B. For the disabled
channel, the query returns 0 by default.
Example
:CURSor:MANual:BYValue? /*The query returns -2.000000E+0.*/
Syntax
:CURSor:MANual:XDELta?
Description
Queries the difference (△ X) between the X value at Cursor A and the X value at Cursor B
in the manual mode of cursor measurement. The unit is determined by the currently
selected horizontal unit.
Return
Format
The query returns the current difference in scientific notation.
Syntax
:CURSor:MANual:IXDELta?
Description
Queries the reciprocal (1/△ X) of the absolute difference between the X value at Cursor A
and the X value at Cursor B in the manual mode of cursor measurement. The unit is
determined by the currently selected horizontal unit.
Return
Format
The query returns 1/△ X in scientific notation.
Syntax
:CURSor:MANual:YDELta?
Description
Queries the difference (△ Y) between the Y value at Cursor A and the Y value at Cursor B
in the manual mode of cursor measurement. The unit is determined by the currently
selected vertical unit.
Return
Format
The query returns the current difference value in scientific notation.
:CURSor:MANual:BYValue?
:CURSor:MANual:XDELta?
:CURSor:MANual:IXDELta?
:CURSor:MANual:YDELta?
MSO5000 Programming Guide 2-53
RIGOL Chapter 2 Command System
Syntax
:CURSor:TRACk:SOURce1 <source>
:CURSor:TRACk:SOURce1?
Description
Sets or queries the channel source of Cursor A in the track mode of cursor measurement.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|CHANnel3|CHANnel4|
MATH1|MATH2|MATH3|MATH4|NONE}
CHANnel1
Remarks
Only the currently enabled channel can be selected as the channel source.
Return
Format
The query returns CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, MATH4, or
NONE.
Example
:CURSor:TRACk:SOURce1 CHANnel2 /*Sets the channel source to CHANnel2.*/
:CURSor:TRACk:SOURce1? /*The query returns CHAN2.*/
:CURSor:TRACk
Command List:
:CURSor:TRACk:SOURce1
:CURSor:TRACk:SOURce2
:CURSor:TRACk:CAX
:CURSor:TRACk:CBX
:CURSor:TRACk:CAY?
:CURSor:TRACk:CBY?
:CURSor:TRACk:AXValue?
:CURSor:TRACk:AYValue?
:CURSor:TRACk:BXValue?
:CURSor:TRACk:BYValue?
:CURSor:TRACk:XDELta?
:CURSor:TRACk:YDELta?
:CURSor:TRACk:IXDELTA?
:CURSor:TRACk:SOURce1
2-54 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CURSor:TRACk:SOURce2 <source>
:CURSor:TRACk:SOURce2?
Description
Sets or queries the channel source of Cursor B in the track mode of cursor measurement.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|CHANnel3|CHANnel4|
MATH1|MATH2|MATH3|MATH4|NONE}
CHANnel1
Remarks
Only the currently enabled channel can be selected as the channel source.
Return
Format
The query returns CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, MATH4, or
NONE.
Example
:CURSor:TRACk:SOURce2 CHANnel2 /*Sets the channel source to CHANnel2.*/
:CURSor:TRACk:SOURce2? /*The query returns CHAN2.*/
Syntax
:CURSor:TRACk:CAX <ax>
:CURSor:TRACk:CAX?
Description
Sets or queries the horizontal position of Cursor A in the track mode of cursor
measurement.
Parameter
Name
Type
Range
Default
<ax>
Integer
0 to 999
400
Remarks
The horizontal and vertical position of the cursor is def ined by the screen pixel
coordinate. The range of the screen pixel coordinate is from (0,0) to (999,479).
Wherein, (0,0) is a location at the upper-left corner of the screen, and (999,479) is a
location at the lower-right corner of the screen. The pixel range in the horizontal
direction is from 0 to 999, and the pixel range in the vertical direction is from 0 to 479.
Return
Format
The query returns an integer ranging from 0 to 999.
Example
:CURSor:TRACk:CAX 200 /*Sets the horizontal position of Cursor A to 200.*/
:CURSor:TRACk:CAX? /*The query returns 200.*/
:CURSor:TRACk:SOURce2
:CURSor:TRACk:CAX
MSO5000 Programming Guide 2-55
RIGOL Chapter 2 Command System
Syntax
:CURSor:TRACk:CBX <bx>
:CURSor:TRACk:CBX?
Description
Sets or queries the horizontal position of Cursor B in the track mode of cursor
measurement.
Parameter
Name
Type
Range
Default
<bx>
Integer
0 to 999
600
Remarks
The horizontal and vertical position of the cursor is def ined by the screen pixel
coordinate. The range of the screen pixel coordinate is from (0,0) to (999,479).
Wherein, (0,0) is a location at the upper-left corner of the screen, and (999,479) is a
location at the lower-right corner of the screen. The pixel range in the horizontal
direction is from 0 to 999, and the pixel range in the vertical direction is from 0 to 479.
Return
Format
The query returns an integer ranging from 0 to 999.
Example
:CURSor:TRACk:CBX 200 /*Sets the horizontal position of Cursor B to 200.*/
:CURSor:TRACk:CBX? /*The query returns 200.*/
Syntax
:CURSor:TRACk:CAY?
Description
Queries the vertical position of Cursor A in the track mode of cursor measurement.
Remarks
The horizontal and vertical position of the cursor is defined by the screen pixel
coordinate. The range of the screen pixel coordinate is from (0,0) to (999,479).
Wherein, (0,0) is a location at the upper-left corner of the screen, and (999,479) is a
location at the lower-right corner of the screen. The pixel range in the horizontal
direction is from 0 to 999, and the pixel range in the vertical direction is from 0 to 479.
Return
Format
The query returns an integer.
Syntax
:CURSor:TRACk:CBY?
Description
Queries the vertical position of Cursor B in the track mode of cursor measurement.
Remarks
The horizontal and vertical position of the cursor is def ined by the screen pixel
coordinate. The range of the screen pixel coordinate is from (0,0) to (999,479).
Wherein, (0,0) is a location at the upper-left corner of the screen, and (999,479) is a
location at the lower-right corner of the screen. The pixel range in the horizontal
direction is from 0 to 999, and the pixel range in the vertical direction is from 0 to 479.
Return
Format
The query returns an integer.
Example
:CURSor:TRACk:CBY? /*The query returns 200.*/
:CURSor:TRACk:CBX
:CURSor:TRACk:CAY?
:CURSor:TRACk:CBY?
2-56 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CURSor:TRACk:AXValue?
Description
Queries the X value at Cursor A in the track mode of cursor measurement. The unit is
determined by the amplitude unit selected for the currently corresponding channel.
Return Format
The query returns the X value at Cursor A in scientific notation.
Syntax
:CURSor:TRACk:AYValue?
Description
Queries the Y value at Cursor A in the track mode of cursor measurement. The unit is
the same as that selected for the current channel.
Return Format
The query returns the Y value at Cursor A in scientific notation.
Syntax
:CURSor:TRACk:BXValue?
Description
Queries the X value at Cursor B in the track mode of cursor measurement. The unit is
determined by the amplitude unit selected for the currently corresponding channel.
Return Format
The query returns the X value at Cursor B in scientific notation.
Syntax
:CURSor:TRACk:BYValue?
Description
Queries the Y value at Cursor B in the track mode of cursor measurement. The unit is
the same as that selected for the current channel.
Return Format
The query returns the Y value at Cursor B in scientific notation.
Syntax
:CURSor:TRACk:XDELta?
Description
Queries the difference (△ X) between the X value at Cursor A and the X value at Cursor
B in the track mode of cursor measurement. The default unit is s.
Return Format
The query returns the current difference in scientific notation.
Syntax
:CURSor:TRACk:YDELta?
Description
Queries the difference (△ Y) between the Y value at Cursor A and the Y value at Cursor
B in the track mode of cursor measurement. The unit is the same as that selected for
the current channel.
Return Format
The query returns the current difference in scientific notation.
:CURSor:TRACk:AXValue?
:CURSor:TRACk:AYValue?
:CURSor:TRACk:BXValue?
:CURSor:TRACk:BYValue?
:CURSor:TRACk:XDELta?
:CURSor:TRACk:YDELta?
MSO5000 Programming Guide 2-57
RIGOL Chapter 2 Command System
Syntax
:CURSor:TRACk:IXDELTA?
Description
Queries the reciprocal (1/△ X) of the absolute difference between the X value at Cursor A
and the X value at Cursor B in the track mode of cursor measurement. The default unit is
Hz.
Return
Format
The query returns 1/△ X in scientific notation.
:CURSor:TRACk:IXDELTA?
2-58 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CURSor:XY:AX <x>
:CURSor:XY:AX?
Description
Sets or queries the horizontal position of Cursor A in the XY cursor measurement mode.
Parameter
Name
Type
Range
Default
<x>
Integer
0 to 479
100
Remarks
In the XY time base mode, the horizontal and vertical position of the cursor is defined
by the pixel coordinate in the XY display region. The range of the screen pixel
coordinate is from (0,0) to (479,479). Wherein, (0,0) is a location at the upper-right
corner of the screen, and (479,479) is a located the lower-left corner of the screen. The
pixel range in the horizontal and vertical direction is from 0 to 479.
Return
Format
The query returns an integer ranging from 0 to 479.
Example
:CURSor:XY:AX 200 /*Sets the horizontal position of Cursor A to 200.*/
:CURSor:XY:AX? /*The query returns 200.*/
:CURSor:XY
The :CURSor:XY command is only available when the horizontal time base mode is set to XY.
Command List:
:CURSor:XY:AX
:CURSor:XY:BX
:CURSor:XY:AY
:CURSor:XY:BY
:CURSor:XY:AXValue?
:CURSor:XY:AYValue?
:CURSor:XY:BXValue?
:CURSor:XY:BYValue?
:CURSor:XY:AX
MSO5000 Programming Guide 2-59
RIGOL Chapter 2 Command System
Syntax
:CURSor:XY:BX <x>
:CURSor:XY:BX?
Description
Sets or queries the horizontal position of Cursor B in the XY cursor measurement
mode.
Parameter
Name
Type
Range
Default
<x>
Integer
0 to 479
300
Remarks
In the XY time base mode, the horizontal and vertical position of the cursor is defined
by the pixel coordinate in the XY display region. The range of the screen pixel
coordinate is from (0,0) to (479,479). Wherein, (0,0) is a location at the upper-right
corner of the screen, and (479,479) is a located the lower-left corner of the screen.
The pixel range in the horizontal and vertical direction is from 0 to 479.
Return
Format
The query returns an integer ranging from 0 to 479.
Example
:CURSor:XY:BX 200 /*Sets the horizontal position of Cursor B to 200.*/
:CURSor:XY:BX? /*The query returns 200.*/
Syntax
:CURSor:XY:AY <y>
:CURSor:XY:AY?
Description
Sets or queries the vertical position of Cursor A in the XY cursor measurement mode.
Parameter
Name
Type
Range
Default
<y>
Integer
0 to 479
100
Remarks
In the XY time base mode, the horizontal and vertical position of the cursor is defined
by the pixel coordinate in the XY display region. The range of the screen pixel
coordinate is from (0,0) to (479,479). Wherein, (0,0) is a location at the upper-right
corner of the screen, and (479,479) is a located the lower-left corner of the screen.
The pixel range in the horizontal and vertical direction is from 0 to 479.
Return
Format
The query returns an integer ranging from 0 to 479.
Example
:CURSor:XY:AY 200 /*Sets the vertical position of Cursor A to 200.*/
:CURSor:XY:AY? /*The query returns 200.*/
:CURSor:XY:BX
:CURSor:XY:AY
2-60 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CURSor:XY:BY <y>
:CURSor:XY:BY?
Description
Sets or queries the vertical position of Cursor B in the XY cursor measurement mode.
Parameter
Name
Type
Range
Default
<y>
Integer
0 to 479
300
Remarks
In the XY time base mode, the horizontal and vertical position of the cursor is defined
by the pixel coordinate in the XY display region. The range of the screen pixel
coordinate is from (0,0) to (479,479). Wherein, (0,0) is a location at the upper-right
corner of the screen, and (479,479) is a located the lower-left corner of the screen.
The pixel range in the horizontal and vertical direction is from 0 to 479.
Return Format
The query returns an integer ranging from 0 to 479.
Example
:CURSor:XY:BY 200 /*Sets the vertical position of Cursor B to 200.*/
:CURSor:XY:BY? /*The query returns 200.*/
Syntax
:CURSor:XY:AXValue?
Description
Queries the X value at Cursor A in the XY cursor measurement mode. The unit is
determined by the amplitude unit selected for the currently corresponding channel.
Return Format
The query returns the X value at Cursor A in scientific notation.
Syntax
:CURSor:XY:AYValue?
Description
Queries the X value at Cursor A in the XY cursor measurement mode. The unit is
determined by the amplitude unit selected for the currently corresponding channel.
Return Format
The query returns the Y value at Cursor A in scientific notation.
Syntax
:CURSor:XY:BXValue?
Description
Queries the X value at Cursor B in the XY cursor measurement mode. The unit is
determined by the amplitude unit selected for the currently corresponding channel.
Return Format
The query returns the X value at Cursor B in scientific notation.
Syntax
:CURSor:XY:BYValue?
Description
Queries the Y value at Cursor B in the XY cursor measurement mode. The unit is
determined by the amplitude unit selected for the currently corresponding channel.
Return Format
The query returns the Y value at Cursor B in scientific notation.
:CURSor:XY:BY
:CURSor:XY:AXValue?
:CURSor:XY:AYValue?
:CURSor:XY:BXValue?
:CURSor:XY:BYValue?
MSO5000 Programming Guide 2-61
RIGOL Chapter 2 Command System
Syntax
:DISPlay:CLEar
Description
Clears all the waveforms on the screen.
Remarks
If the oscilloscope is in the "RUN" state, new waveforms will continue being
displayed after being cleared.
This command functions the same as the CLEAR key on the front panel. You can
also send the :CLEar command to clear all the waveforms on the screen.
Syntax
:DISPlay:TYPE <type>
:DISPlay:TYPE?
Description
Sets or queries the display type of the waveforms on the screen.
Parameter
Name
Type
Range
Default
<type>
Discrete
{VECTors|DOTS}
VECTors
Remarks
VECTors: The sample points are connected by lines and displayed. In most cases,
this mode can provide the most vivid waveform for you to view the steep edge of
the waveform (such as square waveform)
DOTS: displays the sample points directly. You can directly view each sample point
and use the cursor to measure the X and Y values of the sample point.
Return
Format
The query returns VECT or DOTS.
Example
:DISPlay:TYPE DOTS /*Selects the dots display mode.*/
:DISPlay:TYPE? /*The query returns DOTS.*/
:DISPlay Commands
The :DISPlay commands can be used to set the displayed type of the waveform, persistence time, intensity,
grid type, grid brightness, etc.
Command List:
:DISPlay:CLEar
:DISPlay:TYPE
:DISPlay:GRADing:TIME
:DISPlay:WBRightness
:DISPlay:GRID
:DISPlay:GBRightness
:DISPlay:DATA?
:DISPlay:RULers
:DISPlay:COLor
:DISPlay:CLEar
:DISPlay:TYPE
2-62 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:DISPlay:GRADing:TIME <time>
:DISPlay:GRADing:TIME?
Description
Sets or queries the persistence time. The default unit is s.
Parameter
Name
Type
Range
Default
<time>
Discrete
{MIN|0.1|0.2|0.5|1|2|5|10|INFinite}
MIN
Remarks
MIN: sets the persistence time to its minimum value to view how the waveform
changes at a high refresh rate.
specified value (e.g. 0.1, 0.2, 0.5, 1, 2, 5, 10): sets the persistence time to any of
the above specific value to observe glitch that changes relatively slowly or glitch
with low occurrence probability.
INFinite: In this mode, the oscilloscope displays the waveform newly acquired
without clearing the waveforms acquired formerly. It can be used to measure
noise and jitter and to capture incidental events.
Return
Format
The query returns MIN, 0.1, 0.2, 0.5, 1, 2, 5, 10, or INF.
Example
:DISPlay:GRADing:TIME 0.1 /*Sets the persistence time to 0.1 s.*/
:DISPlay:GRADing:TIME? /*The query returns 0.1.*/
Syntax
:DISPlay:WBRightness <time>
:DISPlay:WBRightness?
Description
Sets or queries the brightness of the waveforms on the screen, expressed in
percentage.
Parameter
Name
Type
Range
Default
<time>
Integer
1 to 100
60
Return
Format
The query returns an integer ranging from 1 to 100.
Example
:DISPlay:WBRightness 50 /*Sets the waveform brightness to 50%.*/
:DISPlay:WBRightness? /*The query returns 50.*/
Syntax
:DISPlay:GRID <grid>
:DISPlay:GRID?
Description
Sets or queries the display type of the screen grid.
Parameter
Name
Type
Range
Default
<grid>
Discrete
{FULL|HALF|NONE|IRE}
FULL
Remarks
FULL: turns on the background grid and coordinates.
HALF: turns the background grid off and turns the coordinate on.
NONE: turns the background grid and coordinate off.
IRE: the IRE command is only valid when the trigger type is Video trigger and the
:DISPlay:GRADing:TIME
:DISPlay:WBRightness
:DISPlay:GRID
MSO5000 Programming Guide 2-63
RIGOL Chapter 2 Command System
scale is 140 mV.
Return
Format
The query returns FULL, HALF, NONE, or IRE.
Example
:DISPlay:GRID NONE /*Turns off the background grid and coordinates.*/
:DISPlay:GRID? /*The query returns NONE.*/
Syntax
:DISPlay:GBRightness <brightness>
:DISPlay:GBRightness?
Description
Sets or queries the brightness of the screen grid, expressed in percentage.
Parameter
Name
Type
Range
Default
<brightness>
Integer
1 to 100
50 Return Format
The query returns an integer ranging from 1 to 100.
Example
:DISPlay:GBRightness 60 /*Sets the screen grid brightness to 60%.*/
:DISPlay:GBRightness? /*The query returns 60.*/
Syntax
:DISPlay:DATA?
Description
Queries the bitmap data stream of the currently displayed image.
Return Format
The query returns the binary data stream of the screenshot in ".bmp" format.
Syntax
:DISPlay:RULers <bool>
:DISPlay:RULers?
Description
Enables or disables the ruler display; or queries the on/off status of the ruler.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Return Format
The query returns 1 or 0.
Example
:DISPlay:RULers ON /*Enables the display of the ruler.*/
:DISPlay:RULers? /*The query returns 1.*/
Syntax
:DISPlay:COLor <val>
:DISPlay:COLor?
Description
Enables or disables the color grade display; or queries the on/off status of the
color grade display.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
:DISPlay:GBRightness
:DISPlay:DATA?
:DISPlay:RULers
:DISPlay:COLor
2-64 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Return Format
The query returns 1 or 0.
Example
:DISPlay:COLor ON /*Enables the color grade display.*/
:DISPlay:COLor? /*The query returns 1.*/
MSO5000 Programming Guide 2-65
RIGOL Chapter 2 Command System
Syntax
DVM:CURRent?
Description
Queries the current voltage value under test.
Syntax
:DVM:ENABle <bool>
:DVM:ENABle?
Description
Enables or disables the digital voltmeter; or queries the on/off status of the digital
voltmeter.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Return
Format
The query returns 1 or 0.
Example
:DVM:ENABle ON /*Enables the digital voltmeter.*/
:DVM:ENABle? /*The query returns 1.*/
Syntax
:DVM:SOURce <source>
:DVM:SOURce?
Description
Sets or queries the source of the digital voltmeter.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|CHANnel3|CHANnel4}
CHANnel1
Return
Format
The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:DVM:SOURce CHANnel1 /*Sets the source of DVM to CHANnel1.*/
:DVM:SOURce? /*The query returns CHAN1.*/
:DVM Commands
Command List:
:DVM:CURRent?
:DVM:ENABle
:DVM:SOURce
:DVM:MODE
:DVM:CURRent?
:DVM:ENABle
:DVM:SOURce
2-66 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:DVM:MODE <mode>
:DVM:MODE?
Description
Sets or queries the mode of the digital voltmeter.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{ACRMs|DC|DCRMs}
ACRMs
Description
ACRMs: displays the root-mean-square value of the acquired data, with the DC
component removed.
DC: displays the average value of the acquired data.
DCRMs: displays the root-mean-square value of the acquired data.
Return
Format
The query returns ACRM, DC, or DCRM.
Example
:DVM:MODE DC /*Sets the mode of the digital voltmeter to DC.*/
:DVM:MODE? /*The query returns DC.*/
:DVM:MODE
MSO5000 Programming Guide 2-67
RIGOL Chapter 2 Command System
Syntax
:HISTogram:DISPlay <bool>
:HISTogram:DISPlay?
Description
Enables or disables the histogram function; or queries the status of the
histogram.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Return
Format
The query returns 1 or 0.
Example
:HISTogram:DISPlay ON /*Enables the histogram.*/
:HISTogram:DISPlay? /*The query returns 1.*/
Syntax
:HISTogram:TYPE <type>
:HISTogram:TYPE?
Description
Sets or queries the type of the histogram.
Parameter
Name
Type
Range
Default
<type>
Discrete
{HORizontal|VERTical|MEAS}
HORizontal
Return
Format
The query returns HOR, VERT, or MEAS.
Example
:HISTogram:TYPE VERTical /*Sets the type of the histogram to
VERTical.*/
:HISTogram:TYPE? /*The query returns VERT.*/
:HISTogram Commands
Command List:
:HISTogram:DISPlay
:HISTogram:TYPE
:HISTogram:SOURce
:HISTogram:SIZE
:HISTogram:STATic
:HISTogram:RESet
:HISTogram:BLIMit
:HISTogram:LLIMit
:HISTogram:RLIMit
:HISTogram:TLIMit
:HISTogram:DISPlay
:HISTogram:TYPE
2-68 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:HISTogram:SOURce <source>
:HISTogram:SOURce?
Description
Sets or queries the source of the histogram.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|CHANnel3|CHANn
el4|MATH1|MATH2|MATH3|MATH4|OFF}
OFF
Return
Format
The query returns CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3,
MATH4, or OFF.
Example
:HISTogram:SOURce CHANnel2
/*Sets the source of the histogram to CHANnel2.*/
:HISTogram:SOURce?
/*The query returns CHAN2.*/
Syntax
:HISTogram:SIZE <size>
:HISTogram:SIZE?
Description
Sets or queries the height of the histogram.
Parameter
Name
Type
Range
Default
<size>
Integer
1 to 4
1
Return
Format
The query returns an integer ranging from 1 to 4.
Example
:HISTogram:SIZE 2 /*Sets the height of the histogram to 2.*/
:HISTogram:SIZE? /*The query returns 2.*/
Syntax
:HISTogram:STATic <bool>
:HISTogram:STATic?
Description
Enables or disables the statistical function; or queries the status of the
statistical function.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Return
Format
The query returns 1 or 0.
Example
:HISTogram:STATic ON /*Enables the statistical function.*/
:HISTogram:STATic? /*The query returns 1.*/
:HISTogram:SOURce
:HISTogram:SIZE
:HISTogram:STATic
MSO5000 Programming Guide 2-69
RIGOL Chapter 2 Command System
Syntax
:HISTogram:RESet
Description
Resets the statistics.
Syntax
:HISTogram:BLIMit <y>
:HISTogram:BLIMit?
Description
Sets or queries the histogram's bottom boundary limit.
Parameter
Name
Type
Range
Default
<y>
Real
(-4× VerticalScale) to
(4× VerticalScale)
(vertical scale of the channel
source of the histogram)
0 V
Return
Format
The query returns the histogram's bottom boundary limit in scientific notation.
Example
:HISTogram:BLIMit -2 /*Sets the histogram's bottom boundary limit to -2 mV.*/
:HISTogram:BLIMit? /*The query returns -2.000000E0.*/
Syntax
:HISTogram:LLIMit <x>
:HISTogram:LLIMit?
Description
Sets or queries the histogram's left boundary limit.
Parameter
Name
Type
Range
Default
<x>
Real
(-5× Horizontal Time Base) to
(5× Horizontal Time Base)
0 V
Return
Format
The query returns the histogram's left boundary limit in scientific notation.
Example
:HISTogram:LLIMit -2 /*Sets the histogram's left boundary limit to -2 mV.*/
:HISTogram:LLIMit? /*The query returns -2.000000E0.*/
Syntax
:HISTogram:RLIMit <x>
:HISTogram:RLIMit?
Description
Sets or queries the histogram's right boundary limit.
Parameter
Name
Type
Range
Default
<x>
Real
(-5× Horizontal Scale) to
(5× Horizontal Scale)
0 V
Return
Format
The query returns the histogram's right boundary limit in scientific notation.
Example
:HISTogram:RLIMit -2 /*Sets the histogram's right boundary limit to -2 mV.*/
:HISTogram:RLIMit? /*The query returns -2.000000E0.*/
:HISTogram:RESet
:HISTogram:BLIMit
:HISTogram:LLIMit
:HISTogram:RLIMit
2-70 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:HISTogram:TLIMit <y>
:HISTogram:TLIMit?
Description
Sets or queries the histogram's top boundary limit.
Parameter
Name
Type
Range
Default
<y>
Real
(-4× VerticalScale) to
(4× VerticalScale)
(vertical scale of the channel
source of the histogram)
0 V
Return
Format
The query returns the histogram's top boundary limit in scientific notation.
Example
:HISTogram:TLIMit -2 /*Sets the histogram's top boundary limit to -2 mV.*/
:HISTogram:TLIMit? /*The query returns -2.000000E0.*/
:HISTogram:TLIMit
MSO5000 Programming Guide 2-71
RIGOL Chapter 2 Command System
Syntax
*CLS
Description
Clears all the event registers, and also clears the error queue.
Syntax
*ESE <maskargument>
*ESE?
Description
Sets or queries the enable register bit of the standard event register set.
Parameter
Name
Type
Range
Default
<maskargument>
Integer
0 to 255
0
Return
Format
The query returns an integer. The integer equals to the binary-weighted sum of all the
bits set in the register.
Example
*ESE 16 /*Enable the bit 4 (16 in decimal) in the register.*/
*ESE? /*The query returns the enable value of the register 16.*/
IEEE488.2 Common Commands
The IEEE488.2 common commands are used to query the basic information of the instrument or executing
basic operations. These commands usually start with "*", and the keywords in a command contain 3
characters.
Command List:
*CLS
*ESE
*ESR?
*IDN?
*OPC
*SAV
*RCL
*RST
*SRE
*STB?
*TST?
*WAI
*CLS
*ESE
2-72 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
*ESR?
Description
Queries and clears the event register of the standard event status register.
Remarks
Bit 1 and Bit 6 in the standard event status register are not used and are always treated
as 0; therefore, the range of the returned value is a decimal number corresponding to a
binary number X0XXXX0X (X is 1 or 0).
Return
Format
The query returns an integer. The integer equals to the binary-weighted sum of all the
bits set in the register.
Syntax
*IDN?
Description
Queries the ID string of the instrument.
Return
Format
The query returns RIGOL TECHNOLOGIES,<model>,<serial number>,<software
version>.
Wherein,
<model>: indicates the model number of the instrument.
<serial number>: indicates the serial number of the instrument.
<software version>: indicates the software version of the instrument.
Syntax
*OPC
*OPC?
Description
The *OPC command sets bit 0 (Operation Complete, OPC) in the standard event status
register to 1 after the current operation is finished. The OPC? command queries
whether the current operation is finished.
Return
Format
The query returns 1 after the current operation is finished; otherwise, the query returns
0.
Syntax
*SAV <value>
Description
Saves the current instrument state to the selected register.
Parameter
Name
Type
Range
Default
<value>
Integer
0 to 49
0
Example
*SAV 1 /*Saves the current instrument state to Register 1.*/
Syntax
*RCL
Description
Recalls the instrument state in the specified location.
*ESR?
*IDN?
*OPC
*SAV
*RCL
MSO5000 Programming Guide 2-73
RIGOL Chapter 2 Command System
Syntax
*RST
Description
Restores the instrument to its factory default settings.
Syntax
*SRE <maskargument>
*SRE?
Description
Sets or queries the enable register of the status byte register set.
Parameter
Name
Type
Range
Default
<maskargument>
Integer
0 to 255
0
Remarks
This command queries the standard event enable register value. Bit 3 and Bit 6 in the
standard event status register are not used and are always treated as 0. Therefore, the
range of <maskargument> is a decimal that corresponds to a binary number
X0XX0XXX (X is 1 or 0).
Return
Format
The query returns an integer. The integer equals to the binary-weighted sum of all the
bits set in the register.
Example
*SRE 16 /*Enables the bit 4 (16 in decimal) in the register.*/
*SRE? /*The query returns the enable value of the register 16.*/
Syntax
*STB?
Description
Queries the event register for the status byte register. After executing the command, the
value in the status byte register is cleared.
Remarks
Bit 0 and Bit 1 in the status byte register are not used and are always treated as 0;
therefore, the range of the returned value is a decimal number corresponding to a binary
number X0XXXX0X (X is 1 or 0).
Return
Format
The query returns an integer. The integer equals to the binary-weighted sum of all the bits
set in the register.
Syntax
*TST?
Description
Performs a self-test and queries the self-test result.
Return
Format
The query returns a decimal integer.
Syntax
*WAI
Description
Waits for all the pending operations to complete before executing any additional
commands.
Remarks
This operation command does not have any functions, only to be compatible with other
devices.
*RST
*SRE
*STB?
*TST?
*WAI
2-74 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:LA:STATe <bool>
:LA:STATe?
Description
Enables or disables LA function; or queries the on/off status of LA function.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Return
Format
The query returns 1 or 0.
Example
:LA:STATe ON /*Enables LA function.*/
:LA:STATe? /*The query returns 1.*/
:LA Commands
The :LA commands are used to perform relevant operations on the digital channels. PLA2216 active logic
probe option is required to be ordered.
Command List:
:LA:STATe
:LA:ACTive
:LA:AUTOsort
:LA:DELete
:LA:DIGital:DISPlay
:LA:DIGital:POSition
:LA:DIGital:LABel
:LA:POD<n>:DISPlay
:LA:DISPlay
:LA:POD<n>:THReshold
:LA:SIZE
:LA:TCALibrate
:LA:GROup:APPend
:LA:STATe
MSO5000 Programming Guide 2-75
RIGOL Chapter 2 Command System
Syntax
:LA:ACTive {<digital>|NONE}
:LA:ACTive?
Description
Sets or queries the current active channel or channel group.
Parameter
Name
Type
Range
Default
<digital>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|
D8|D9|D10|D11|D12|D13|D14|D15|NONE}
——
Remarks
The parameter <digital> can be any of the digital channels (D0-D15). The
channel label and waveform of the selected channel are displayed in red.
When you send the parameter NONE, it means that no channel is selected.
Only the currently enabled digital channel can be selected. Please refer to
the :LA:DIGital:DISPlay command or the :LA:DISPlay command to enable the
desired channel.
Return
Format
The query returns the current active channel (D0, D1, ...D15) or NONE.
Example
:LA:ACTive D3 /*Sets the current active channel to D3.*/
:LA:ACTive? /*The query returns D3.*/
Syntax
:LA:AUTOsort <n>
Description
Sets the auto sorting mode for the waveforms of the currently selected channels on the
screen.
Parameter
Name
Type
Range
Default
<n>
Discrete
{0|1}
1
Remarks
<n> = 0: the waveforms on the screen are D0-D15 in sequence from top to
bottom.
<n> = 1: the waveforms on the screen are D15-D0 in sequence from top to
bottom.
Syntax
:LA:DELete <group>
Description
Cancels the group setting for the 16 digital channels, or cancels the group settings for
the channel groups (GROUP1-GROUP4).
Parameter
Name
Type
Range
Default
<group>
Discrete
{GROUP1|GROUP2|GROUP3|GROUP4}
——
Remarks
This command only performs the canceling operation for digital channels or
user-defined channel group that have been group set.
:LA:ACTive
:LA:AUTOsort
:LA:DELete
2-76 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:LA:DIGital:DISPlay <digital>,<bool>
:LA:DIGital:DISPlay? <digital>
Description
Turns on or off the specified digital channel; or queries the on/off status of the
specified digital channel.
Parameter
Name
Type
Range
Default
<digital>
Integer
{D0|D1|D2|D3|D4|D5|D6|D7|
D8|D9|D10|D11|D12|D13|D14|D15}
——
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Remarks
The currently enabled channel can be selected as the active channel by sending
the :LA:ACTive command.
Return
Format
The query returns 1 or 0.
Example
:LA:DIGital:DISPlay D3 ON /*Enables D3.*/
:LA:DIGital:DISPlay? D3 /*The query returns 1.*/
Syntax
:LA:DIGital:POSition <digital>,<position>
:LA:DIGital:POSition? <digital>
Description
Sets or queries the position of the displayed waveforms of the specified digital channel
on the screen.
Parameter
Name
Type
Range
Default
<digital>
Integer
{D0|D1|D2|D3|D4|D5|D6|D7|
D8|D9|D10|D11|D12|D13|D14|D15}
——
<position>
Integer
When the waveform display size is
Small: 0 to 31
When the waveform display size is
Medium: 0 to 15
When the waveform display size is
Large: 0 to 7
——
Remarks
The value of the parameter <position> indicates the position of the waveforms
displayed on the screen.
This setting command is only valid when the specified digital channel is currently
enabled.
Return
Format
The query returns an integer ranging from 0 to 31, 0 to 15, or from 0 to 7.
Example
:LA:DIGital:POSition D1,3 /*Sets the displayed position of D1 to 3.*/
:LA:DIGital:POSition? D1 /*The query returns 3.*/
:LA:DIGital:DISPlay
:LA:DIGital:POSition
MSO5000 Programming Guide 2-77
RIGOL Chapter 2 Command System
Syntax
:LA:DIGital:LABel <digital>,<label>
:LA:DIGital:LABel? <digital>
Description
Sets or queries the label of the specified digital channel.
Parameter
Name
Type
Range
Default
<digital>
Integer
{D0|D1|D2|D3|D4|D5|D6|D7|
D8|D9|D10|D11|D12|D13|D14|D15}
——
<label>
ASCII
String
The label can contain English letters and
numbers, as well as some symbols.
——
Return
Format
The query returns the label of the specified digital channel in ASCII strings.
Example
:LA:DIGital:LABel D0,ACK /*Sets the label of D0 to ACK.*/
:LA:DIGital:LABel? D0 /*The query returns ACK.*/
Syntax
:LA:POD<n>:DISPlay <bool>
:LA:POD<n>:DISPlay?
Description
Enables or disables the specified default channel group; or queries the on/off status of the
specified default channel group.
Parameter
Name
Type
Range
Default
<n>
Integer
1 to 2
——
<bool>
Bool
{{1|ON}|{0|OFF}}
——
Remarks
2 default channel groups: POD1 (D0 to D7) and POD2 (D8 to D15).
Return
Format
The query returns 1 or 0.
Example
:LA:POD1:DISPlay 1 /*Enables POD1 (D0 to D7).*/
:LA:POD1:DISPlay? /*The query returns 1.*/
Syntax
:LA:DISPlay <channel>,<bool>
:LA:DISPlay? <channel>
Description
Turns on or off the specified digital channel, user-defined channel group, or the default
channel group; or queries the on/off status of the specified digital channel,
user-defined channel group, or the default channel group.
Parameter
Name
Type
Range
Default
<channel>
Discrete
{D0|D1|D2|D3|D4|D5|D6|D7|
D8|D9|D10|D11|D12|D13|D14|D15|GROup1|
GROup2|GROup3|GROup4|POD1|POD2}
——
<bool>
Bool
{{1|ON}|{0|OFF}}
——
Remarks
You can set the digital channels contained in the specified user-defined channel
group. Note that any one of the digital channels can only belong to one of the
:LA:DIGital:LABel
:LA:POD<n>:DISPlay
:LA:DISPlay
2-78 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
specified user-defined channel group.
The currently enabled channel or user-defined channel group can be selected as
the active channel or the channel group by sending the :LA:ACTive command.
POD1: D0 to D7; POD2: D8 to D15
Return
Format
The query returns 1 or 0.
Example
:LA:DISPlay D0,ON /*Enables D0.*/
:LA:DISPlay? D0 /*The query returns 1.*/
Syntax
:LA:POD<n>:THReshold <thre>
:LA:POD<n>:THReshold?
Description
Sets or queries the threshold of the specified default channel group. The default unit is
V.
Parameter
Name
Type
Range
Default
<n>
Integer
1 to 2
——
<thre>
Real
-20.0 V to +20.0 V
1.40V
Remarks
2 default channel groups: POD1 (D0 to D7) or POD2 (D8 to D15).
Return
Format
The query returns the current threshold of the specified channel group in scientific
notation.
Example
:LA:POD1:THReshold 3.3 /*Sets the threshold of POD1 (D0 to D7) to 3.3 V.*/
:LA:POD1:THReshold? /*The query returns 3.300000E0.*/
Syntax
:LA:SIZE <size>
:LA:SIZE?
Description
Sets or queries the size of the waveforms of the enabled channel on the screen.
Parameter
Name
Type
Range
Default
<size>
Discrete
{SMALl|LARGe|MEDium}
MEDium
Remarks
L (large) can only be used when the number of the currently enabled channels is no
more than 8.
Return
Format
The query returns SMAL, LARG, or MED.
Example
:LA:SIZE SMALl /*Sets the waveform display size to SMALl.*/
:LA:SIZE? /*The query returns SMAL.*/
:LA:POD<n>:THReshold
:LA:SIZE
MSO5000 Programming Guide 2-79
RIGOL Chapter 2 Command System
Syntax
:LA:TCALibrate <tcal>
:LA:TCALibrate?
Description
Sets or queries the delay calibration time of the digital channel. The default unit is s.
Parameter
Name
Type
Range
Default
<tcal>
Real
-1000 ns to 100 ns
0.00 s
Remarks
When you use an oscilloscope to make actual measurements, the transmission delay
of the probe cable may bring relatively greater errors (zero offset). Zero offset is
defined as the offset of the crossing point (between the waveforms and the threshold
level) from the trigger position. You can set a delay time for calibrating the zero offset
of the corresponding channel.
Return
Format
The query returns the delay calibration time in scientific notation.
Example
:LA:TCALibrate 0.00000002 /*Sets the delay calibration time to 20 ns.*/
:LA:TCALibrate? /*The query returns 2.000000E-8.*/
Syntax
:LA:GROup:APPend
<group>,<digital0>[,<digital1>[,<digital2>[,<digita3>[,<digital4>[,<digital5>[,<di
gital6>[,<digital7>[,<digital8>[,<digital9>[,<digital10>[,<digital11>[,<digital12>[,
<digital13>[,<digital14>[,<digital15>]]]]]]]]]]]]]]]
Description
Adds a channel to the specified user-defined group.
Parameter
Name
Type
Range
Default
<group>
Discrete
{GROup1|GROup2|
GROup3|GROup4}
——
<digital0>/<digital1>/
<digital2>/<digita3>/
<digital4>/<digital5>/
<digital6>/<digital7>/
<digital8>/<digital9>/
<digital10>/<digital11>/
<digital12>/<digital13>/
<digital14>/<digital15>]
Discrete
{D0|D1|D2|D3|D4|
D5|D6|D7|D8|D9|D
10|D11|D12|D13|D
14|D15}
——
Example
:LA:GROup:APPend GROup2,D0,D1 /*Adds D0 and D1 to Group2.*/
:LA:TCALibrate
:LA:GROup:APPend
2-80 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Syntax
:LAN:DHCP <bool>
:LAN:DHCP?
Description
Turns on or off the DHCP configuration mode; or queries the on/off status of the
current DHCP configuration mode.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
1|ON
Remarks
When the three IP configuration types (DHCP, Auto IP, and Static IP) are all
turned on, the priority of the parameter configuration from high to low is
"DHCP", "Auto IP", and "Static IP". The three IP configuration types cannot be
all turned off at the same time.
When DHPC is valid, the DHCP server in the current network will assign the
network parameters (such as the IP address) for the oscilloscope.
After the :LAN:APPLy command is executed, the configuration type can take
effect immediately.
Return
Format
The query returns 1 or 0.
Example
:LAN:DHCP OFF /*Disables DHCP configuration mode.*/
:LAN:DHCP? /*The query returns 0.*/
:LAN Commands
The :LAN commands are used to set and query the LAN parameters.
:LAN:DHCP
:LAN:AUToip
:LAN:GATeway
:LAN:DNS
:LAN:MAC?
:LAN:DSErver?
:LAN:MANual
:LAN:IPADdress
:LAN:SMASk
:LAN:STATus?
:LAN:VISA?
:LAN:MDNS
:LAN:HOST:NAME
:LAN:DESCription
:LAN:APPLy
:LAN:DHCP
MSO5000 Programming Guide 2-81
RIGOL Chapter 2 Command System
Syntax
:LAN:AUToip <bool>
:LAN:AUToip?
Description
Turns on or off the Auto IP configuration mode; or queries the on/off status of the
current Auto IP configuration mode.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
1|ON
Remarks
When the auto IP mode is valid, disable DHCP manually. You can self-define the
gateway and DNS address for the oscilloscope.
Return
Format
The query returns 1 or 0.
Example
:LAN:AUToip OFF /*Disables the Auto IP configuration mode.*/
:LAN:AUToip? /*The query returns 0.*/
Syntax
:LAN:GATeway <string>
:LAN:GATeway?
Description
Sets or queries the default gateway.
Parameter
Name
Type
Range
Default
<string>
ASCII String
Refer to Remarks
——
Remarks
The format of <string> is nnn,nnn,nnn,nnn. The range of the first section of
"nnn" is from 0 to 223 (except 127), and the ranges of the other three sections of
"nnn" are from 0 to 255.
When you use this command, the IP configuration mode should be Auto IP or
Static IP mode.
Return
Format
The query returns the current gateway in strings.
Example
:LAN:GATeway 192.168.1.1 /*Sets the default gateway to 192.168.1.1.*/
:LAN:GATeway? /*The query returns the current gateway.*/
Syntax
:LAN:DNS <string>
:LAN:DNS?
Description
Sets or queries the DNS address.
Parameter
Name
Type
Range
Default
<string>
ASCII String
Refer to Remarks
——
Remarks
The format of <string> is nnn,nnn,nnn,nnn. The range of the first section of
"nnn" is from 0 to 223 (except 127), and the ranges of the other three sections of
"nnn" are from 0 to 255.
When you use this command, the IP configuration mode should be Auto IP or
Static IP mode.
:LAN:AUToip
:LAN:GATeway
:LAN:DNS
2-82 MSO5000 Programming Guide
Chapter 2 Command System RIGOL
Return
Format
The query returns the current DNS address in strings.
Example
:LAN:DNS 192.168.1.1 /*Sets the DNS address to 192.168.1.1.*/
:LAN:DNS? /*The query returns the current DNS address.*/
Syntax
:LAN:MAC?
Description
Queries the MAC address of the instrument.
Return
Format
The query returns the MAC address in strings. For example, 00:19:AF:00:11:22.
Syntax
:LAN:DSErver?
Description
Queries the address of the DHCP server.
Return
Format
The query returns the address of the DHCP server in strings.
Syntax
:LAN:MANual <bool>
:LAN:MANual?
Description
Turns on or off the static IP configuration mode; or queries the on/off status of the
static IP configuration mode.
Parameter
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
Remarks
When the static IP mode is valid, disable DHCP and Auto IP manually. You can
self-define the network parameters of the oscilloscope, such as IP address, subnet
mask, gateway, and DNS address. For the setting of the IP address, refer to
the :LAN:IPADdress command. For the setting of the subnet mask, refer to
the :LAN:SMASk command. For the setting of the gateway, refer to the :LAN:GATeway
command. For the setting of DNS, refer to the :LAN:DNS command.
Return
Format
The query returns 1 or 0.
Example
:LAN:MANual ON /*Enables the static IP configuration mode.*/
:LAN:MANual? /*The query returns 1.*/
:LAN:MAC?
:LAN:DSErver?
:LAN:MANual
MSO5000 Programming Guide 2-83
RIGOL Chapter 2 Command System
Syntax
:LAN:IPADdress <string>
:LAN:IPADdress?
Description
Sets or queries the IP address of the instrument.
Parameter
Name
Type
Range
Default
<string>
ASCII String
Refer to Remarks
——
Remarks
The format of <string> is nnn,nnn,nnn,nnn. The range of the first section of
"nnn" is from 0 to 223 (except 127), and the ranges of the other three sections of
"nnn" are from 0 to 255.
When you use the command, the IP configuration mode should be static IP.
Besides, the DHCP and auto IP should be disabled.
Return
Format
The query returns the current IP address in strings.
Example
:LAN:IPADdress 192.168.1.10 /*Sets the IP address to 192.168.1.10.*/
:LAN:IPADdress? /*The query returns the current IP address.*/
Syntax
:LAN:SMASk <string>
:LAN:SMASk?
Description
Sets or queries the subnet mask.
Parameter
Name
Type
Range
Default
<string>
ASCII String
Refer to Remarks
——
Remarks
The format of <string> is nnn,nnn,nnn,nnn. The range of the section "nnn" is
from 0 to 255.
When you use the command, the IP configuration mode should be static IP. The
DHCP and auto IP should be disabled.
Return
Format
The query returns the current subnet mask in strings.
Example
:LAN:SMASk 255.255.255.0 /*Sets the subnet mask to 255.255.255.0*/
:LAN:SMASk? /*The query returns the current subnet mask.*/
Syntax
:LAN:STATus?
Description
Queries the current network configuration status.
Return
Format
The query returns UNLINK, CONNECTED, INIT, IPCONFLICT, BUSY, CONFIGURED,
DHCPFAILED, INVALIDIP, or IPLOSE.
UNLINK: not connected.
CONNECTED: the network is successfully connected.
INIT: the instrument is acquiring an IP address.
IPCONFLICT: there is an IP address conflict.
BUSY: please waiting…
CONFIGURED: the network configuration has been successfully configured.
:LAN:IPADdress
:LAN:SMASk
:LAN:STATus?
2-84 MSO5000 Programming Guide
Loading...