Rigol MSO5104, MSO5072, MSO5102, MSO5354, MSO5204 Programming Guide
...
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
Loading...