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
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++.
Tip
For the latest version of this manual, download it from the official website of RIGOL (www.rigol.com).
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.
|
|
|
|
Analog |
|
|
No. of |
|
|
No. of Function/Arbitrary |
|
|
No. of Digital |
|
|
|
|
|
|
|
|
|
|||||||
|
Model |
|
|
|
|
Analog |
|
|
Waveform Generator |
|
|
|
||
|
|
|
Bandwidth |
|
|
|
|
|
|
Channels |
|
|||
|
|
|
|
|
|
Channels |
|
|
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 |
|
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 |
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
Syntax :AUTOscale
Description Enables the waveform auto setting function. The oscilloscope will automatically adjust the vertical scale, horizontal time base, and trigger mode according to the input signal to realize optimal waveform display. This command functions the same as the AUTO key on the front panel.
Remarks When the AUTO function is disabled, this command is invalid. For details, refer to :SYSTem:AUTOscale.
When the pass/fail test is enabled, the AUTO function runs normally, but the pass/fail test function is forced to be disabled.
When the waveform recording function is enabled or the recorded waveforms are played back, the AUTO function runs normally, but the recording or playing function is forced to be disabled.
:CLEar
Syntax :CLEar
Description Clears all the waveforms on the screen. This command functions the same as the CLEAR key on the front panel.
:RUN
:STOP
Syntax :RUN :STOP
Description The :RUN command starts the oscilloscope and the :STOP command stops the oscilloscope. This command functions the same as the RUN/STOP key on the front panel.
Remarks When the waveform recording function is enabled, the RUN/STOP key on the front panel is disabled.
2-2 |
MSO5000 Programming Guide |
Chapter 2 Command System |
RIGOL |
:SINGle
Syntax :SINGle
Description Sets the trigger mode of the oscilloscope to "Single". This command functions the same as either of the following two operation: press SINGLE on the front panel; or send
the :TRIGger:SWEep SINGle command.
Remarks In the single trigger mode, the oscilloscope performs a single trigger when the trigger conditions are met and then it stops.
When the waveform recording function is enabled or the recorded waveforms are played back, this command is invalid.
For the single trigger, you can use the :TFORce command to generate one trigger by force.
:TFORce
Syntax :TFORce
Description Generates a trigger signal forcefully. This command is only applicable to the normal and single trigger modes (refer to the :TRIGger:SWEep command). This command functions the same as the FORCE key in the trigger control area of the front panel.
MSO5000 Programming Guide |
2-3 |
RIGOL |
Chapter 2 Command System |
:ACQuire Commands
The :ACQuire commands are used to set the memory depth of the oscilloscope, the acquisition mode, the average times, as well as query the current sample rate.
Command List[1]:
:ACQuire:AVERages
:ACQuire:MDEPth
:ACQuire:TYPE
:ACQuire:SRATe?
:ACQuire:LA:SRATe?
:ACQuire:AALias
Note[1]: In the "Command List" in this manual, the query commands and the parameters in the setting commands are omitted. You can refer to the complete introductions of the commands in the body of the text based on the keywords listed here.
:ACQuire:AVERages
Syntax :ACQuire:AVERages <count> :ACQuire:AVERages?
Description Sets or queries the number of averages in the average acquisition mode.
Parameter |
Name |
Type |
Range |
Default |
|
|
|
<count> |
Integer |
2n (n is an integer, and its range is from 1 to 16) |
2 |
Remarks |
You can send the :ACQuire:TYPE command to set the acquisition mode. |
In the average acquisition mode, greater number of averages can lower the noise and increase the vertical resolution; but will also slow the response of the displayed waveform to the waveform changes.
Return The query returns an integer ranging from 2 to 65536.
Format
Example :ACQuire:AVERages 128 |
/*Sets the average times to 128.*/ |
:ACQuire:AVERages? |
/*The query returns 128.*/ |
:ACQuire:MDEPth
Syntax :ACQuire:MDEPth <mdep> :ACQuire:MDEPth?
Description Sets or queries the memory depth of the oscilloscope (i.g. the number of waveform points that can be stored through the sampling in a single trigger). The default unit is pts.
Parameter |
|
Name |
|
|
Type |
|
|
Range |
|
|
Default |
|
|
|
|
|
<mdep> |
|
|
Discrete |
|
|
{AUTO|1k|10k|100k|1M|10M|25M|50M|100M| |
|
|
AUTO |
|
|
|
|
|
|
|
|
200M} |
|
|
|
|||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Remarks |
When "AUTO" is selected, the oscilloscope selects the memory depth automatically |
|
|||||||||||
|
|
|
according to the current sample rate. |
|
|
|
|
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 The query returns AUTO, 1k, 10k, 100k, 1M, 10M, 25M, 50M, 100M or 200M.
Format
Example :ACQuire:MDEPth 1M |
/*Sets the memory depth to 1M.*/ |
:ACQuire:MDEPth? |
/*The query returns 1M.*/ |
:ACQuire:TYPE
Syntax |
:ACQuire:TYPE <type> |
|
|
|||
|
|
:ACQuire:TYPE? |
|
|
|
|
Description |
Sets or queries the acquisition mode of the oscilloscope. |
|
||||
Parameter |
Name |
|
Type |
Range |
Default |
|
|
|
<type> |
|
Discrete |
{NORMal|AVERages|PEAK|} |
NORMal |
Remarks |
NORMal: In this mode, the oscilloscope samples the signal at a specified fixed time |
|||||
|
|
interval to rebuild the waveform. For most of the waveforms, using this mode can |
||||
|
|
produce the optimal display effects. |
|
AVERages: In this mode, the oscilloscope averages the waveforms from multiple samples to reduce the random noise of the input signal and improve the vertical resolution. Greater number of averages can lower the noise and increase the vertical resolution; while at the same time, it will slow the response of the displayed waveform to the waveform changes.
PEAK: indicates the peak detection. In this mode, the oscilloscope samples the maximum and minimum value of the signal at the fixed sampling interval to acquire the signal envelope or the narrow pulses that might be lost. In this mode, signal aliasing can be prevented, but the noise displayed would be larger.
Return The query returns NORM, AVER, or PEAK.
Format
Example :ACQuire:TYPE AVERages |
/*Sets the acquisition mode to AVERages.*/ |
:ACQuire:TYPE? |
/*The query returns AVER.*/ |
:ACQuire:SRATe?
Syntax |
:ACQuire:SRATe? |
Description Queries the current sample rate. The default unit is Sa/s. |
|
Remarks |
Sample rate indicates the frequency of the signal sampling, i.g. the number of |
|
waveform points sampled per second. |
|
The formula below describes the relationship among sample rate, memory depth, and |
|
waveform length: |
|
memory depth = sample rate x waveform length |
|
Wherein, the memory depth is set by the :ACQuire:MDEPth command. The waveform |
|
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.
MSO5000 Programming Guide |
2-5 |
RIGOL Chapter 2 Command System
Format |
|
Example |
:ACQuire:SRATe? /*The query returns 2.500000E+9.*/ |
:ACQuire:LA:SRATe?
Syntax |
:ACQuire:LA:SRATe? |
|
Description |
Queries the current LA sample rate. The default unit is Sa/s. |
|
Return |
The query returns the sample rate in scientific notation. |
|
Format |
|
|
Example |
:ACQuire:LA:SRATe? |
/*The query returns 1.250000E+9.*/ |
:ACQuire:LA:MDEPth?
Syntax |
:ACQuire:LA:MDEPth? |
|
Description |
Queries the current LA memory depth. |
|
Return |
The query returns the memory depth in scientific notation. |
|
Format |
|
|
Example |
:ACQuire:LA:MDEPth? |
/*The query returns 1.250000E+4.*/ |
:ACQuire:AALias
Syntax :ACQuire:AALias <bool> :ACQuire:AALias?
Description Enables or disables the anti-aliasing function of the oscilloscope; or queries the on/off status of the anti-aliasing function.
Parameter |
Name |
Type |
Range |
Default |
|
|
|
<bool> |
Bool |
{{1|ON}|{0|OFF}} |
0|OFF |
Return |
The query returns 1 or 0. |
|
|||
Format |
|
|
|
|
|
Example |
:ACQuire:AALias ON |
/*Enables the anti-aliasing function.*/ |
|
||
|
|
:ACQuire:AALias? |
/*The query returns 1.*/ |
|
2-6 |
MSO5000 Programming Guide |
Chapter 2 Command System |
RIGOL |
: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
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| |
|
|
PARallel |
|
|
|
|
|
|
|
|
FLEXray|M1553} |
|
|
|
|||
|
|
|
|
|
|
|
|
|
|
|
|
|
Remarks Except PARallel, all the other decodings are options. Only when the specified option is installed, can the command is available.
Return The query returns PAR, RS232, SPI, IIC, IIS, LIN, CAN, FLEX, or M1553.
Format
Example :BUS1:MODE SPI |
/*Sets the type of the decoding bus to SPI.*/ |
:BUS1:MODE? |
/*The query returns SPI.*/ |
MSO5000 Programming Guide |
2-7 |
RIGOL |
Chapter 2 Command System |
:BUS<n>:DISPlay
Syntax :BUS<n>:DISPlay <bool> :BUS<n>:DISPlay?
Description Enables or disables the 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 The query returns 1 or 0.
Format
Example :BUS1:DISPlay ON |
/*Enables the decoding bus.*/ |
:BUS1:DISPlay? |
/*The query returns 1.*/ |
:BUS<n>:FORMat
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 The query returns HEX, ASC, DEC, or BIN.
Format
Example :BUS1:FORMat HEX |
/*Sets the display format of the bus to HEX.*/ |
:BUS1:FORMat? |
/*The query returns HEX.*/ |
:BUS<n>:EVENt
Syntax :BUS<n>:EVENt <bool> :BUS<n>:EVENt?
Description Enables or disables the event table of the specified decoding bus; or queries the on/off status of the specified decoding bus event table.
Parameter |
Name |
Type |
Range |
|
Default |
|
|
|
<n> |
Discrete |
{1|2|3|4} |
|
—— |
|
|
<bool> |
Bool |
{{1|ON}|{0|OFF}} |
|
0|OFF |
Remarks Before using the command, enable the specified decoding bus.
Return The query returns 1 or 0.
Format
Example :BUS1:EVENt ON |
/*Enables the event table of the specified decoding bus.*/ |
:BUS1:EVENt? |
/*The query returns 1.*/ |
2-8 |
MSO5000 Programming Guide |
Chapter 2 Command System |
RIGOL |
:BUS<n>:EVENt:FORMat
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 The query returns HEX, ASC, DEC, or BIN.
Format
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.*/
:BUS<n>:EVENt:VIEW
Syntax
Description
Parameter
Remarks
Return
Format
Example
:BUS<n>:EVENt:VIEW <packet> :BUS<n>:EVENt:VIEW?
Sets or queries the data page of the specified decoding bus event table.
Name |
Type |
Range |
Default |
<n> |
Discrete |
{1|2|3|4} |
—— |
<packet> |
Discrete |
{PACKets|DETails|PAYLoad} |
PACKets |
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.
The query returns PACK, DET, or PAYL.
:BUS1:EVENt:VIEW DETails |
/*Sets the data page of the decoding bus event table |
|
to DETails.*/ |
:BUS1:EVENt:VIEW? |
/*The query returns DET.*/ |
MSO5000 Programming Guide |
2-9 |
RIGOL |
Chapter 2 Command System |
:BUS<n>:LABel
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 The query returns 1 or 0.
Format
Example :BUS1:LABel ON |
/*Enables the label of the specified decoding bus.*/ |
:BUS1:LABel? |
/*The query returns 1.*/ |
:BUS<n>:DATA?
Syntax |
:BUS<n>:DATA? |
|
|
|
||
Description |
Reads the data in the decoding event table. |
|
|
|||
Parameter |
Name |
Type |
Range |
|
Default |
|
|
|
<n> |
Discrete |
{1|2|3|4} |
|
—— |
Return Returns the data in the decoding event table with the following formats. Format #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.
2-10 |
MSO5000 Programming Guide |
Chapter 2 Command System RIGOL
:BUS<n>:EEXPort
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.*/ |
|
:BUS<n>:POSition
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 The query returns an integer ranging from -167 to +217.
Format
Example :BUS1:POSition 200 |
/*Sets the vertical position of the bus to 200.*/ |
:BUS1:POSition? |
/*The query returns 200.*/ |
:BUS<n>:THReshold
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 |
|
0 |
|
|
|
|
|
|
|
|
|
|
(5× VerticalScale–OFFSet) |
|
|
|
||||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<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 The query returns the threshold of the specified decoding source in scientific notation.
Format
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.*/ |
MSO5000 Programming Guide |
2-11 |
RIGOL |
Chapter 2 Command System |
: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
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} |
|
|
—— |
|
|
|
|
|
|
|
|
|
|
{D0|D1|D2|D3|D4|D5|D6|D7|D8| |
|
|
|
|
|
|
|
<source> |
|
|
Discrete |
|
D9|D10|D11|D12|D13|D14|D15| |
|
|
OFF |
|
|
|
|
|
|
|
CHANnel1|CHANnel2|CHANnel3|CHANnel4| |
|
|
|
|||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OFF} |
|
|
|
|
Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format 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.*/ |
:BUS<n>:PARallel:SLOPe
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 The query returns POS, NEG, or BOTH.
Format
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.*/ |
:BUS<n>:PARallel:WIDTh
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 |
The query returns an integer ranging from 0 to 20. |
|
||||
Format |
|
|
|
|
|
|
Example |
:BUS1:PARallel:WIDTh 16 |
/*Sets the data width of Parallel decoding to 16.*/ |
||||
|
|
:BUS1:PARallel:WIDTh? |
/*The query returns 16.*/ |
|
:BUS<n>:PARallel:BITX
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 The query returns the current data bits in integer. Its unit is Hz.
Format
Example :BUS1:PARallel:BITX 2 |
/*Sets the current bit to 2.*/ |
:BUS1:PARallel:BITX? |
/*The query returns 2.*/ |
MSO5000 Programming Guide |
2-13 |
RIGOL |
Chapter 2 Command System |
:BUS<n>:PARallel:SOURce
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} |
|
|
—— |
|
|
|
|
|
|
|
|
|
|
|
{D0|D1|D2|D3|D4|D5|D6|D7|D8| |
|
|
Related to the |
|
|
|
|
<src> |
|
|
Discrete |
|
|
D9|D10|D11|D12|D13|D14|D15| |
|
|
|
|
|
|
|
|
|
|
|
|
|
selected bit |
|
|||
|
|
|
|
|
|
|
|
|
CHANnel1|CHANnel2|CHANnel3|CHANnel4} |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Remarks Before sending this command, send the :BUS<n>:PARallel:BITX command to select the desired data bit.
Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format 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.*/ |
:BUS<n>:PARallel:POLarity
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 |
The query returns NEG or POS. |
|
|
||||
Format |
|
|
|
|
|
|
|
Example |
:BUS1:PARallel:POLarity NEGative |
/*Sets the data polarity of Parallel decoding to |
|||||
|
|
|
|
|
|
NEGative.*/ |
|
|
|
:BUS1:PARallel:POLarity? |
|
/*The query returns NEG.*/ |
|
:BUS<n>:PARallel:NREJect
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 |
2-14 |
MSO5000 Programming Guide |