RIGOL RIGOL DS2102A Programming Guide

Download

RIGOL

Programming Guide

MSO2000A/DS2000A Series

Digital Oscilloscope

May 2019

RIGOL (SUZHOU) TECHNOLOGIES INC.

RIGOL

Guaranty and Declaration

Trademark Information

RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC.

Publication Number

PGA18106-1110

Software Version

00.03.04.SP2 Software upgrad e might change o r add pro duct f eatu res . Pl ease ac qu ire th e l atest v ers ion of th e manu al

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 r eserves the right to m odify or chan ge 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 cons equential losses in connection with the

furnishi ng , 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 conf ormance certifications are in progress.

If you have any pro blem or requirement when using our products or this manual, please contact RIGOL. E-mail: service@rigol.com Website: www.rigol.com

MSO2000A/DS2000A Programming Guide I

RIGOL

Document Overview

This manual provides guidance on how to use the SCPI commands in programming to realize remote control of RIGOL MSO2000A/DS2000A series digital oscilloscope through the remote interface. MSO2000A/DS2000A can communicate with a PC through the USB, LAN, or GPI B (with the USB-GPIB interface converter provided by RIGOL) interface.

Main Topics in this Manual:

 SCPI Overview  Command System  Programming Demos

Content Conventions in this Manual :

MSO2000A/DS2000A series includes the following models. Unless otherwise noted, this manual takes MSO2302A-S as an example to illustrate the functions and using method of the command system of MSO2000A/DS2000A series.

Model

MSO2102A 100MHz 2 -- 16 MSO2102A-S 100MHz 2 2 16 MSO2202A 200MHz 2 -- 16 MSO2202A-S 200MHz 2 2 16 MSO2302A 300MHz 2 -- 16 MSO2302A-S 300MHz 2 2 16 DS2102A 100MHz 2 -- -DS2202A 200MHz 2 -- -DS2302A 300MHz 2 -- --

Analog Bandwidth

Number of Analog Channels

Number of Signal Source Channels

Number of Digital Channels

II MSO2000A/DS2000A Programming Guide

Contents RIGOL

III

Contents

Guaranty and Declaration ......................................................................................................... I

Document Overview ................................................................................................................. II

1 SCPI Overview ..................................................................................................................... 1-1

Syntax ..................................................................................................................................... 1-1

Symbol Description ................................................................................................................... 1-2

Parameter Type ........................................................................................................................ 1-2

Command Abbreviation ............................................................................................................. 1-3

2 Command System ................................................................................................................ 2-1

:AUToscale ............................................................................................................................... 2-2

:CLEar...................................................................................................................................... 2-2

:RUN ........................................................................................................................................ 2-2

:STOP ...................................................................................................................................... 2-2

:SINGle .................................................................................................................................... 2-3

:TFORce ................................................................................................................................... 2-3

:TLHAlf .................................................................................................................................... 2-3

IEEE 488.2 Common Commands................................................................................................ 2-4

*CLS ................................................................................................................................. 2-4

*ESE ................................................................................................................................. 2-5

*ESR? ............................................................................................................................... 2-6

*IDN? ............................................................................................................................... 2-6

*OPC ................................................................................................................................. 2-7

*RST ................................................................................................................................. 2-7

*SRE ................................................................................................................................. 2-8

*STB? ............................................................................................................................... 2-9

*TST? ............................................................................................................................. 2-10

:ACQuire Commands ............................................................................................................... 2-11

:ACQuire:AVERages .......................................................................................................... 2-11

:ACQuire:MDEPth ............................................................................................................. 2-12

:ACQuire:SRATe? .............................................................................................................. 2-12

:ACQuire:TYPE ................................................................................................................. 2-13

:ACQuire:AALias ............................................................................................................... 2-14

:BUS<n> Commands .............................................................................................................. 2-15

:BUS<n>:MODE .............................................................................................................. 2-15

:BUS<n>:DISPlay ............................................................................................................ 2-16

:BUS<n>:FORMat ............................................................................................................ 2-16

:BUS<n>:EVENt .............................................................................................................. 2-17

:BUS<n>:EEXPort ............................................................................................................ 2-17

:BUS<n>:DATA? .............................................................................................................. 2-18

:BUS<n>:PARallel ............................................................................................................ 2-19

:BUS<n>:RS232 (Option) ................................................................................................. 2-24

MSO2000A/DS2000A Programming Guide

RIGOL Contents

:BUS<n>:IIC (Option) ...................................................................................................... 2-32

:BUS<n>:SPI (Option) ...................................................................................................... 2-36

:BUS<n>:CAN (Option) .................................................................................................... 2-46

:CALCulate Commands ............................................................................................................ 2-51

:CALCulate:MODE ............................................................................................................. 2-51

:CALCulate:ADD ............................................................................................................... 2-52

:CALCulate:SUB ................................................................................................................ 2-55

:CALCulate:MULTiply ......................................................................................................... 2-58

:CALCulate:DIVision .......................................................................................................... 2-61

:CALCulate:FFT ................................................................................................................ 2-64

:CALCulate:LOGic ............................................................................................................. 2-72

:CALCulate:ADVanced ....................................................................................................... 2-76

:CALibrate Commands ............................................................................................................. 2-80

:CALibrate:DATE? ............................................................................................................. 2-80

:CALibrate:STARt .............................................................................................................. 2-80

:CALibrate:TIME? ............................................................................................................. 2-81

:CALibrate:QUIT ............................................................................................................... 2-81

:CHANnel<n> Commands........................................................................................................ 2-82

:CHANnel<n>:BWLimit ..................................................................................................... 2-82

:CHANnel<n>:COUPling ................................................................................................... 2-83

:CHANnel<n>:DISPlay ...................................................................................................... 2-83

:CHANnel<n>:INVert ........................................................................................................ 2-84

:CHANnel<n>:IMPedance ................................................................................................. 2-84

:CHANnel<n>:OFFSet....................................................................................................... 2-85

:CHANnel<n>:SCALe ........................................................................................................ 2-86

:CHANnel<n>:PROBe ....................................................................................................... 2-87

:CHANnel<n>:UNITs ........................................................................................................ 2-87

:CHANnel<n>:VERNier ..................................................................................................... 2-88

:CHANnel<n>:TCAL ......................................................................................................... 2-89

:CURSor Commands ................................................................................................................ 2-90

:CURSor:MODE ................................................................................................................ 2-90

:CURSor:MANual .............................................................................................................. 2-91

:CURSor:TRACk ................................................................................................................ 2-99

:DISPlay Commands .............................................................................................................. 2-104

:DISPlay:CLEar ............................................................................................................... 2-104

:DISPlay:TYPE ................................................................................................................ 2-105

:DISPlay:GRADing:TIME ................................................................................................. 2-106

:DISPlay:WBRightness .................................................................................................... 2-106

:DISPlay:GRID ............................................................................................................... 2-107

:DISPlay:GBRightness ..................................................................................................... 2-107

:DISPlay:MPERsistence ................................................................................................... 2-108

:DISPlay:DATA? ............................................................................................................. 2-109

:FUNCtion Commands ........................................................................................................... 2-111

:FUNCtion:WRMode ........................................................................................................ 2-111

IV MSO2000A/DS2000A Programming Guide

Contents RIGOL

:FUNCtion:WRECord ....................................................................................................... 2-112

:FUNCtion:WREPlay ........................................................................................................ 2-115

:FUNCtion:WANalyze ...................................................................................................... 2-120

:LA Commands (For MSO2000A/MSO2000A-S) ....................................................................... 2-128

:LA:STATe ..................................................................................................................... 2-128

:LA:ACTive .................................................................................................................... 2-129

:LA:DISPlay ................................................................................................................... 2-130

:LA:AUTosort ................................................................................................................. 2-130

:LA:DELete .................................................................................................................... 2-131

:LA:SIZE ........................................................................................................................ 2-131

:LA:DIGital<n>:DISPlay ................................................................................................. 2-132

:LA:DIGital<n>:POSition ................................................................................................ 2-132

:LA:DIGital<n>:LABel .................................................................................................... 2-133

:LA:POD<n>:DISPlay ..................................................................................................... 2-133

:LA:POD<n>:THReshold ................................................................................................. 2-134

:LA:GROup<n>:APPend ................................................................................................. 2-134

:LA:BUS<n>:CURRent .................................................................................................... 2-135

:LA:BUS<n>:DISPlay ..................................................................................................... 2-135

:LA:BUS<n>:CHANnel .................................................................................................... 2-136

:LA:BUS<n>:FORMat ..................................................................................................... 2-136

:LAN Commands ................................................................................................................... 2-137

:LAN:DHCP .................................................................................................................... 2-137

:LAN:AUToip .................................................................................................................. 2-138

:LAN:GATeway ............................................................................................................... 2-139

:LAN:DNS ...................................................................................................................... 2-139

:LAN:MAC? .................................................................................................................... 2-140

:LAN:MANual ................................................................................................................. 2-140

:LAN:INITiate ................................................................................................................ 2-141

:LAN:IPADdress ............................................................................................................. 2-141

:LAN:SMASk .................................................................................................................. 2-142

:LAN:STATus? ................................................................................................................ 2-142

:LAN:VISA? .................................................................................................................... 2-143

:LAN:APPLy .................................................................................................................... 2-143

:MASK Commands ................................................................................................................ 2-144

:MASK:ENABle ............................................................................................................... 2-144

:MASK:SOURce .............................................................................................................. 2-145

:MASK:OPERate ............................................................................................................. 2-145

:MASK:MDISplay ............................................................................................................ 2-146

:MASK:SOOutput ........................................................................................................... 2-146

:MASK:OUTPut............................................................................................................... 2-147

:MASK:X ........................................................................................................................ 2-148

:MASK:Y ........................................................................................................................ 2-148

:MASK:CREate ............................................................................................................... 2-148

:MASK:PASSed? ............................................................................................................. 2-149

MSO2000A/DS2000A Programming Guide

RIGOL Contents

:MASK:FAILed? ............................................................................................................... 2-149

:MASK:TOTal? ................................................................................................................ 2-149

:MASK:RESet .................................................................................................................. 2-150

:MASK:DATA .................................................................................................................. 2-150

:MEASure Commands ............................................................................................................ 2-151

:MEASure:SOURce .......................................................................................................... 2-152

:MEASure:COUNter:SOURce ............................................................................................ 2-153

:MEASure:COUNter:VALue? ............................................................................................. 2-153

:MEASure:CLEar ............................................................................................................. 2-154

:MEASure:RECover ......................................................................................................... 2-154

:MEASure:ADISplay ........................................................................................................ 2-155

:MEASure:AMSource ....................................................................................................... 2-155

:MEASure:STATistic:DISPlay ............................................................................................ 2-156

:MEASure:STATistic:MODE .............................................................................................. 2-156

:MEASure:STATistic:RESet ............................................................................................... 2-157

:MEASure:SETup:TYPE ................................................................................................... 2-157

:MEASure:SETup:MAX ..................................................................................................... 2-158

:MEASure:SETup:MID ..................................................................................................... 2-158

:MEASure:SETup:MIN ..................................................................................................... 2-158

:MEASure:SETup:PSA ...................................................................................................... 2-159

:MEASure:SETup:PSB ...................................................................................................... 2-159

:MEASure:SETup:DSA ..................................................................................................... 2-160

:MEASure:SETup:DSB ..................................................................................................... 2-160

:MEASure:AREA .............................................................................................................. 2-161

:MEASure:CREGion:CAX .................................................................................................. 2-162

:MEASure:CREGion:CBX .................................................................................................. 2-162

:MEASure:HISTory:DISPlay ............................................................................................. 2-163

:MEASure:HISTory:DMODe .............................................................................................. 2-163

:MEASure:FDELay ........................................................................................................... 2-164

:MEASure:F2RDelay ........................................................................................................ 2-166

:MEASure:FPHase ........................................................................................................... 2-168

:MEASure:F2RPhase ....................................................................................................... 2-170

:MEASure:FREQuency ..................................................................................................... 2-172

:MEASure:FTIMe ............................................................................................................ 2-174

:MEASure:NDUTy ............................................................................................................ 2-176

:MEASure:NWIDth .......................................................................................................... 2-178

:MEASure:OVERshoot ..................................................................................................... 2-180

:MEASure:PDUTy ............................................................................................................ 2-182

:MEASure:PERiod ........................................................................................................... 2-184

:MEASure:PREShoot ....................................................................................................... 2-186

:MEASure:PWIDth .......................................................................................................... 2-188

:MEASure:RTIMe ............................................................................................................ 2-190

:MEASure:RDELay .......................................................................................................... 2-192

:MEASure:R2FDelay ........................................................................................................ 2-194

VI MSO2000A/DS2000A Programming Guide

Contents RIGOL

VII

:MEASure:RPHase .......................................................................................................... 2-196

:MEASure:R2FPhase ....................................................................................................... 2-198

:MEASure:VAMP ............................................................................................................. 2-200

:MEASure:VAVG ............................................................................................................. 2-202

:MEASure:VBASe ............................................................................................................ 2-204

:MEASure:VMAX ............................................................................................................. 2-206

:MEASure:VMIN ............................................................................................................. 2-208

:MEASure:VPP ............................................................................................................... 2-210

:MEASure:VRMS ............................................................................................................. 2-212

:MEASure:PVRMs ........................................................................................................... 2-214

:MEASure:VTOP ............................................................................................................. 2-216

:MEASure:MARea ........................................................................................................... 2-218

:MEASure:MPARea ......................................................................................................... 2-220

:OUTPut<n> Commands (For MSO2000A-S) .......................................................................... 2-222

:OUTPut[<n>][:STATe] .................................................................................................. 2-222

:OUTPut[<n>]:IMPedance .............................................................................................. 2-223

:RECall Commands ............................................................................................................... 2-224

:RECall:SETup ................................................................................................................ 2-224

:RECall:TRACe ............................................................................................................... 2-225

:RECall:WAVeform ......................................................................................................... 2-225

:REFerence Commands ......................................................................................................... 2-226

:REFerence<n>:CURRent ............................................................................................... 2-226

:REFerence<n>:ENABle ................................................................................................. 2-227

:REFerence:COLor .......................................................................................................... 2-227

:REFerence:CURRent? .................................................................................................... 2-228

:REFerence:DISPlay ....................................................................................................... 2-228

:REFerence:RESet .......................................................................................................... 2-228

:REFerence:SAVe ........................................................................................................... 2-229

:REFerence:SOURce ....................................................................................................... 2-229

:REFerence:VSCale ......................................................................................................... 2-230

:REFerence:VOFFset ...................................................................................................... 2-231

:SAVE Commands ................................................................................................................. 2-232

:SAVE:CSV[:STARt] ........................................................................................................ 2-233

:SAVE:CSV:FACTors ....................................................................................................... 2-234

:SAVE:CSV:LENGth......................................................................................................... 2-234

:SAVE:FORMat ............................................................................................................... 2-235

:SAVE:IMAGe[:STARt] .................................................................................................... 2-235

:SAVE:IMAGe:TYPE ........................................................................................................ 2-236

:SAVE:IMAGe:FACTors ................................................................................................... 2-236

:SAVE:SETup[:STARt] .................................................................................................... 2-237

:SAVE:TRACe[:STARt] .................................................................................................... 2-238

:SAVE:WAVeform[:STARt] .............................................................................................. 2-238

:SAVE:REFerence[:STARt] .............................................................................................. 2-239

:SAVE:MTESt[:STARt] .................................................................................................... 2-240

MSO2000A/DS2000A Programming Guide

RIGOL Contents

:SAVE:ARB[:STARt] ........................................................................................................ 2-241

:SOURce<n> Commands (For MSO2000A-S) .......................................................................... 2-242

[:SOURce<n>]:FREQuency[:FIXed] ................................................................................. 2-243

[:SOURce<n>]:PHASe[:ADJust] ...................................................................................... 2-243

[:SOURce<n>]:PHASe:INITiate ....................................................................................... 2-244

[:SOURce<n>]:FUNCtion[:SHAPe] ................................................................................... 2-245

[:SOURce<n>]:FUNCtion:RAMP:SYMMetry ...................................................................... 2-246

[:SOURce<n>]:VOLTage[:LEVel][:IMMediate][:AMPLitude] ............................................... 2-247

[:SOURce<n>]:VOLTage[:LEVel][:IMMediate]:OFFSet....................................................... 2-248

[:SOURce<n>]:PULSe:DCYCle ........................................................................................ 2-249

[:SOURce<n>]:MOD[:STATe] .......................................................................................... 2-250

[:SOURce<n>]:MOD:TYPe .............................................................................................. 2-251

[:SOURce<n>]:MOD:AM[:DEPTh] ................................................................................... 2-251

[:SOURce<n>]:MOD:AM:INTernal:FREQuency ................................................................. 2-252

[:SOURce<n>]:MOD:AM:INTernal:FUNCtion .................................................................... 2-252

[:SOURce<n>]:MOD:FM[:DEVIation] ............................................................................... 2-253

[:SOURce<n>]:MOD:FM:INTernal:FREQuency ................................................................. 2-253

[:SOURce<n>]:MOD:FM:INTernal:FUNCtion .................................................................... 2-254

[:SOURce<n>]:APPLy:NOISe .......................................................................................... 2-255

[:SOURce<n>]:APPLy:PULSe .......................................................................................... 2-255

[:SOURce<n>]:APPLy:RAMP ........................................................................................... 2-255

[:SOURce<n>]:APPLy:SINusoid....................................................................................... 2-255

[:SOURce<n>]:APPLy:SQUare......................................................................................... 2-255

[:SOURce<n>]:APPLy:USER ............................................................................................ 2-255

[:SOURce<n>]:APPLy? ................................................................................................... 2-257

:SYSTem Commands ............................................................................................................. 2-258

:SYSTem:AOUTput ......................................................................................................... 2-259

:SYSTem:AUToscale ........................................................................................................ 2-259

:SYSTem:BEEPer ............................................................................................................ 2-260

:SYSTem:DATE ............................................................................................................... 2-260

:SYSTem:ERRor[:NEXT]? ................................................................................................. 2-261

:SYSTem:EXPand ............................................................................................................ 2-261

:SYSTem:GAMount? ........................................................................................................ 2-262

:SYSTem:GPIB ............................................................................................................... 2-262

:SYSTem:KEY:PRESs ....................................................................................................... 2-263

:SYSTem:KEY:INCRease .................................................................................................. 2-265

:SYSTem:KEY:DECRease ................................................................................................. 2-265

:SYSTem:LANGuage ........................................................................................................ 2-266

:SYSTem:OPTion:INSTall ................................................................................................ 2-267

:SYSTem:OPTion:UNINSTall ............................................................................................ 2-267

:SYSTem:OPTion:VALid? ................................................................................................. 2-268

:SYSTem:PON ................................................................................................................ 2-268

:SYSTem:PSTatus ........................................................................................................... 2-269

:SYSTem:RAMount? ........................................................................................................ 2-269

VIII MSO2000A/DS2000A Programming Guide

Contents RIGOL

:SYSTem:RESet .............................................................................................................. 2-269

:SYSTem:SSAVer:TIME ................................................................................................... 2-270

:SYSTem:SETup ............................................................................................................. 2-270

:SYSTem:TIME .............................................................................................................. 2-271

:SYSTem:UDEVice .......................................................................................................... 2-271

:SYSTem:VERSion? ........................................................................................................ 2-272

:TIMebase Commands .......................................................................................................... 2-273

:TIMebase:DELay:ENABle ............................................................................................... 2-273

:TIMebase:DELay:OFFSet ............................................................................................... 2-274

:TIMebase:DELay:SCALe ................................................................................................ 2-274

:TIMebase[:MAIN]:OFFSet.............................................................................................. 2-275

:TIMebase[:MAIN]:SCALe ............................................................................................... 2-276

:TIMebase:HREF:MODE .................................................................................................. 2-277

:TIMebase:HREF:POSition .............................................................................................. 2-277

:TIMebase:MODE ........................................................................................................... 2-278

:TIMebase:VERNier ........................................................................................................ 2-278

:TRACe<n> Commands (For MSO2000A-S) ............................................................................ 2-279

[:TRACe<n>]:DATA ....................................................................................................... 2-279

[:TRACe<n>]:DATA:DAC16 ............................................................................................ 2-280

[:TRACe<n>]:DATA:DAC ................................................................................................ 2-281

[:TRACe<n>]:DATA:LOAD? ............................................................................................ 2-282

[:TRACe<n>]:DATA:POINts ............................................................................................ 2-282

[:TRACe<n>]:DATA:POINts:INTerpolate .......................................................................... 2-283

[:TRACe<n>]:DATA:VALue ............................................................................................. 2-284

:TRIGger Commands ............................................................................................................ 2-285

:TRIGger:COUPling ........................................................................................................ 2-286

:TRIGger:HOLDoff ......................................................................................................... 2-286

:TRIGger:MODE ............................................................................................................. 2-287

:TRIGger:NREJect .......................................................................................................... 2-287

:TRIGger:STATus? .......................................................................................................... 2-288

:TRIGger:SWEep ............................................................................................................ 2-289

:TRIGger:CAN (Option) .................................................................................................. 2-290

:TRIGger:DELay (Option) ............................................................................................... 2-295

:TRIGger:DURATion (Option) .......................................................................................... 2-298

:TRIGger:EDGe .............................................................................................................. 2-302

:TRIGger:IIC ................................................................................................................. 2-304

:TRIGger:NEDGe (Option) .............................................................................................. 2-310

:TRIGger:PATTern .......................................................................................................... 2-313

:TRIGger:PULSe ............................................................................................................. 2-316

:TRIGger:RS232............................................................................................................. 2-320

:TRIGger:RUNT ............................................................................................................. 2-326

:TRIGger:SHOLd ............................................................................................................ 2-330

:TRIGger:SLOPe ............................................................................................................. 2-334

:TRIGger:SPI ................................................................................................................. 2-339

MSO2000A/DS2000A Programming Guide

RIGOL Contents

:TRIGger:TIMeout (Option) ............................................................................................. 2-346

:TRIGger:USB (Option) ................................................................................................... 2-348

:TRIGger:VIDeo (HDTV Option)....................................................................................... 2-351

:TRIGger:WINDows (Option)........................................................................................... 2-356

:WAVeform Commands .......................................................................................................... 2-359

:WAVeform:SOURce ....................................................................................................... 2-361

:WAVeform:MODE .......................................................................................................... 2-362

:WAVeform:FORMat ........................................................................................................ 2-363

:WAVeform:POINts ......................................................................................................... 2-363

:WAVeform:DATA? .......................................................................................................... 2-364

:WAVeform:XINCrement? ................................................................................................ 2-368

:WAVeform:XORigin? ...................................................................................................... 2-369

:WAVeform:XREFerence? ................................................................................................ 2-369

:WAVeform:YINCrement? ................................................................................................ 2-370

:WAVeform:YORigin? ...................................................................................................... 2-370

:WAVeform:YREFerence? ................................................................................................ 2-370

:WAVeform:STARt ........................................................................................................... 2-371

:WAVeform:STOP ........................................................................................................... 2-372

:WAVeform:BEGin ........................................................................................................... 2-372

:WAVeform:END ............................................................................................................. 2-373

:WAVeform:RESet ........................................................................................................... 2-373

:WAVeform:PREamble? ................................................................................................... 2-374

:WAVeform:STATus? ....................................................................................................... 2-375

3 Programming Demos .......................................................................................................... 3-1

Programming Preparations ......................................................................................................... 3-2

Excel Programming Demo .......................................................................................................... 3-3

LabVIEW Programming Demo .................................................................................................... 3-7

MATLAB Programming Demo ................................................................................................... 3-11

Visual Basic 6.0 Programming Demo ........................................................................................ 3-13

Visual C++ 6.0 Programming Demo ......................................................................................... 3-15

X MSO2000A/DS2000A Programming Guide

1 SCPI Overview RIGOL

1 SCPI Overview

SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming language that is built upon the standard IEEE 488.1 and IEEE 488.2 and conforms to various standards (such as the float ing point operation rule in IEEE 754 standard, ISO 646 7-bit coded character 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 a root keyword and one or more sub-keywords.

The topics of this chapter:

 Syntax  Symbol Description  Parameter Type  Command Abbreviation

Syntax

The command string usually starts with ":"; the keywords are separated by ":" and are followed by the parameter settings available; "?" is added at the end of the command string to indicate query or execute the corresponding function and then make query (for example, *TST?); the command keywords and the first parameter are separated by a space.

For example, :CALCulate:ADVanced:EXPRession <expression> :CALCulate:ADVanced:EXPRession?

CALCulate is the root keyword of the command. ADVanced and EXPRession are the second-level and third-level keywords respectively. The command string starts with ":" which is also used to separate the multiple-level keywords. <expression> represents the parameters available for setting. "?" represents query. The command keywords :CALCulate:ADVanced:EXPRession and parameter <expression> are separated by a space.

"," is generally used for separating multiple parameters contained in the same command, for example, :SYSTem:DATE <yea r>,<month >, <da y >

MSO2000A/DS2000A Programming Guide 1-1

RIGOL 1 SCPI Overview

Symbol Description

The following symbols will not be sent with the commands.

1. Braces {} The parameters enclo sed in the b races are optio nal and are u sually separ ated by th e v ertical bar "|". When you use the command, one of the parameters must be selected.

2. Vertical Bar | The vertical bar is used to separate mu ltiple paramet ers and one of the parameters must be selected when you use the command.

3. Square Brackets [] The content in the square brackets can be omitted.

4. Triangle Brackets <> The parameter enclosed in the triangle brackets must be replaced by an effective value.

Parameter Type

1. Bool

The parameter could be ON, OFF, 1 or 0. For example, :MEASure:ADISplay <bool > :MEASure:ADISplay? Wherein, <bool> can be set to {{1|ON}|{0|OFF}}. The query returns 1 or 0.

2. Discrete The parameter could be any of the values listed. For example, :ACQuire:TYPE <type> :ACQuire:TYPE? Wherein, <type> can be set to NORMal|AVERages|PEAK|HRESolution. The query returns the abbreviations (NORM, AVER, PEAK or HRES).

3. Integer Unless otherwise noted, the parameter can be any integer within the effec tive value range. Note that do not set the parameter to a decimal, otherwise errors will occur. For example, :DISPlay:GBRightne ss <br i ghtne ss > :DISPlay:GBRightness? Wherein, <brightness> can be set to any integer between 0 and 100. The query returns an integer between 0 and 100.

1-2 MSO2000A/DS2000A Programming Guide

1 SCPI Overview RIGOL

1-3

4. Real The parameter can be any real number within the effective value range and this command accepts decimal and scientific notation parameter input. For example, :FUNCtion:WREPlay:INTerval <interval> :FUNCtion:WREPlay:INTerval? Wherein, <interval> can be set to any real number between 0.0000001 (or 1e-07, namely 100ns) to 10 (or 1e+01, namely 10s). The query returns a real number in scientific notation.

5. ASCII String

The parameter should be the combinations of ASCII characters. For example, :CALCulate:ADVanced:EXPRession <expression> :CALCulate:ADVanced:EXPRession? Wherein, <expression> can be set to CH1+CH2 The query returns a n ASCII string.

Command Abbreviation

All the co mmands are case-insensitive and you can use any of them. If abbreviation is used, all the capital English letters and numbers in the command must be written completely. For example, :CALCulate:ADVanced:VARiable1? can be abbreviated to :CALC:ADV:VAR1?

MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2 Command System

This chapter introduces the command subsystems of MSO2000A/DS2000A command set.

The topics of this chapter:

 :AUToscale  :CLEar  :RUN  :STOP  :SINGle  :TFORce  :TLHAlf  IEEE 488.2 Common Commands  :ACQuire Commands  :BUS<n> Commands  :CALCulate Commands  :CALibrate Commands  :CHANnel<n> Commands  :CURSor Commands  :DISPlay Commands  :FUNCtion Commands  :LA Commands (Fo r MSO2000A/MSO2000A-S)  :LAN Commands  :MASK Commands  :MEASure Commands  :OUTPut<n> Commands (For MSO2000A-S)  :RECall Commands  :REFerence Commands  :SAVE Commands  :SOURce<n> Commands (For MSO2000A-S)  :SYSTem Commands  :TIMebase Commands  :TRACe<n> Commands (For MSO2000A-S)  :TRIGger Commands  :WAVeform Commands

Note:

1. Unless otherwise noted, the introductions and parameter ranges in this manual are based on MSO2302A-S.

2. For parameter set ting c ommands (such as time, frequenc y and amplitud e), the oscilloscope can only accept numbers and set the parameters using the default units ; it cannot recognize the units sent with the parameters. For the default unit of each parameter, please refer to the description in each command in the following introductions.

MSO2000A/DS2000A Programming Guide 2-1

RIGOL 2 Command System

:AUToscale

Syntax

:AUToscale

Description

Enable the waveform auto setting function. The oscilloscope adjusts the vertical scale, horizontal time base and trigger mode according to the input signal automatically to realize optimum waveform display. The function of this command is the same with that of AUTO on the front panel.

Explanation

 This command is invalid when the AUTO function is disabled. For the details, please refer

:SYSTem:AUToscale.

 When the current status of the pass/fail function is "Enable Test", this command is not available. For

the details, please refer to

:MASK:ENABle.

:CLEar

Syntax

:CLEar

Description

Clear all the waveforms on the screen. New waveforms will still be displayed if the oscilloscope is in RUN state. The function of this command is the same with that of CLEAR on the front panel.

:RUN :STOP

Syntax

:RUN :STOP

Description

The :RUN c ommand starts the oscilloscope and the :STOP command stops the oscilloscope. The functions of these commands are the same with those of RUN/STOP on the front panel.

Explanation

These commands are invalid when waveform recording or waveform playback is turned on.

2-2 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-3

:SINGle

Syntax

:SINGle

Description Set the oscilloscope to single trigger mode.

Explanation

 In single trigger mode, the oscilloscope triggers once the trigger conditions are met and then stops.  In single trigger mode, using the  You can use the

state respectively.

:RUN and :STOP command to set the oscilloscope to Auto trigger mode and STOP

:TFORce command can generate a trigger signal forcefully.

:TFORce

Syntax

:TFORce

Description

Generate a trigger signal forcefully. The function of this command is the same with that of FORCE in the trigger control area on the front panel.

:TLHAlf

Syntax

:TLHAlf

Description

Set the trigger level to the vertical midpoint of the trigger signal amplitude.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

IEEE 488.2 Common Commands

The IEEE 488 .2 standard defines some common commands used for querying the basic i nformation of the instrument or executing basic operations. These commands usually start with "*" and the keyword of the command is usually 3-character long.

 *CLS  *ESE  *ESR?  *IDN?  *OPC  *RST  *SRE  *STB?  *TST?

*CLS

Syntax

*CLS

Description

Clear all the event registers and clear the error queue.

2-4 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-5

*ESE

Syntax

*ESE <mask> *ESE?

Description Set or query the enable register for the standard event status register set.

Parameter

Name Type Range Default

<mask> Integer 0 to 255 0

Explanation  <mask> is the sum of the binary weights (expressed in decimal) of all the bits between bit 0 and bit

7 that have already been set. If the bit has already been set, the corresponding binary bit is 1; otherwise, it is 0.

 Definit ions of the bits in ESE register:

Bit Weights Name Enable 7 128 PON Power On 6 64 URQ User Request 5 32 CME Command Error 4 16 EXE Execution Error 3 8 DDE Dev. Dependent Error 2 4 QYE Query Error 1 2 RQL Request Contro l 0 1 OPC Operation Complete

Return Format

The query returns an integer between 0 and 255 which equals the sum of the binary weights (expressed in decimal) of all the bits that have already been set in the register. For example, the query returns 144 if bit 4 (16 in decimal) and bit 7 (128 in decimal) are enabled.

Example

*ESE 16 /*Bit 4 is enabled*/ *ESE? /*The query retur ns 16*/

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

*ESR?

Syntax

*ESR?

Description Query the event status register for the standard event register set.

Explanation Definit ions of the bits of ESE register:

Return Format The query returns an integer between 0 and 255 which equals the sum of the binary weights (expressed in decimal) of all the bits that have already been set in the register. For example, the query returns 144 if bit 4 (16 in decimal) and bit 7 (128 in decimal) are enabled.

*IDN?

Syntax

*IDN?

Description Query the current device information.

Return Format The query returns R IGOL TECHNOLO GI ES ,<model>,<serial number>,<software version>. Wherein, <model> is the model number of the instrument. <serial numb er> is th e serial number of the instrument. <software version> is the softw are version of the instrument.

2-6 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-7

*OPC

Syntax

*OPC *OPC?

Description Set the Operation Complete bit (bit 0) in the standard event status register to 1 after the current operation is finished. Query whether the current operation is finished.

Return Format The query returns 1 if the current operation is finished ; otherwise, returns 0.

*RST

Syntax

*RST

Description Restore the instrument to the factory setting.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

*SRE

Syntax

*SRE <mask> *SRE?

Description Set or query the enable register for the state byte register set.

Parameter

Name Type Range Default

<mask> Integer 0 to 255 0

Explanation  <mask> is the sum of the binary weights (expressed in decimal) of all the bits between bit 0 and bit

7 that have already been set. If the bit has already been set, the corresponding binary bit is 1; otherwise, it is 0.

 Definit ions of the bits of SRE register:

Bit Weights Name Enable 7 128 OPER Operation Status Reg 6 64 -- Not used 5 32 ESB Event Stat us Bit 4 16 MAV Message Available 3 8 -- Not used 2 4 MSG Message 1 2 USR User 0 1 TRG Trigger

Return Format The query returns an integer between 0 and 255 which equals the sum of the binary weights (expressed in decimal) of all the bits that have already been set in the register. For example, the query retu rns 144 if bit 4 (16 in decimal) and bit 7 (128 in decimal) are enabled.

Example *SRE 16 /*Bit 4 is enabled*/ *SRE? /*The query returns 16*/

2-8 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-9

*STB?

Syntax

*STB?

Description Query the condition register for the state byte register set.

Explanation

Definit ions of the bits of SRE register:

Bit Weights Name Enable 7 128 OPER Operation Status Reg 6 64 -- Not used 5 32 ESB Event Status Bit 4 16 MAV Message Available 3 8 -- Not used 2 4 MSG Message 1 2 USR User 0 1 TRG Trigger

Return Format The query returns an integer between 0 and 255 which equals the sum of the binary weights (expressed in decimal) of all the bits that have already been set in the register. For example, the query retu rns 144 if bit 4 (16 in decimal) and bit 7 (128 in decimal) are enabled.

Example *STB? /*The query returns 24 (bit 3 and bit 4 are enabled)*/

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

*TST?

Syntax

*TST?

Description

Perform a self-test and query the result .

Explanation

The self-test result is denoted by a 32-bit binary number. If the corresponding binary bit is 0, the self-test item passes the test; while 1 indicates a failure. The return value is the decimal integer corresponding t o the binary number. The self-test item represented by each bit is as shown below. The bit that is not used is always 0. bit0: system voltage bit1: analog voltage bit2: storage system bit3: digital core bit4: digital IO bit9: fan 1 bit10: fan 2 bit12: inlet temperature bit13: outlet temperature bit16: real-time clock

Return Format

The query returns a decimal integer.

Example *TST? /*The query returns 0 (namely the 32 bits of the binary number are all 0*/

2-10 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-11

:ACQuire Commands

 :ACQuire:AVERages  :ACQuire:MDEPth  :ACQuire:SRATe?  :ACQuire:TYPE  :ACQuire:AALias

:ACQuire:AVERages

Syntax

:ACQuire:AVERages <count> :ACQuire:AVERages?

Description Set or query the number of averages in average acquisition mode.

Parameter

Name Type Range Default

<count> Discrete 2n (n is an integer from 1 to 13) 2

Explanation You can use the oscilloscope averages the waveforms from multiple samples to reduce the random noise on 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 slower the response of the displayed wavefor m t o the waveform changes.

Return Format The query returns the number of averages in average acquisition mode in integer.

:ACQuire:TYPE command to select the average acquisition mode. In this mode, the

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:ACQuire:MDEPth

Syntax

:ACQuire:MDEPth <mdep> :ACQuire:MDEPth?

Description

Set or query the memory depth of the oscilloscope; namely the number of waveform points that can be stored in a single trigger sample. The default unit is pts (points).

Parameter

Name Type Range Default <mdep> Discrete Refer to Explanation AUTO

Explanation

Interweave: AUTO|14000|140000|1400000|14000000|56000000 (option). Non-interweave: AUTO|7000|70000|700000|7000000|28000000 (option).

Return Format

The query returns the memory depth of the oscilloscope in integer.

:ACQuire:SRATe?

Syntax

:ACQuire:SRATe?

Description

Query the current sample rate. The default unit is Sa/s.

Return Format

The query returns the current sample rate in scientific notation. For example, 1.00000e+09; name ly

1.000GSa/s.

2-12 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-13

:ACQuire:TYPE

Syntax

:ACQuire:TYPE <type> :ACQuire:TYPE?

Description Set or query the acquisition mode of the sample.

Parameter

Name Type Range Default

<type> Discrete {NORMal|AVERages|PEAK|HRESolution} NORMal

Explanation  NORMal: the oscilloscope samples the signal at equal time interval. For most of waveforms, this

mode can ensure the optimum display effect.

 AVERages: the oscilloscope averages the waveforms from multiple samples to reduce the random

noise on the input signal and increase the vertical resolution. In this mode, you can use the

:ACQuire:AVERages command to set the number of averages.

 PEAK: the oscilloscope samples the maximum and minimum values of the signal within the sample

interval to acquire the envelop of the signal and narrow pulses that might be lost. But in this mode, the display noise is relatively larger.

 HRESolution: the oscilloscope averages the neighbouring points of the sampled waveform. This

mode is usually used when the sample r ate of the digital con verter is greater th an the storage r ate of the sample storage.

Return Format The query returns NORM, AVER, PEAK, or HRES.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:ACQuire:AALias

Syntax

:ACQuire:AALias <bool> :ACQuire:AALias?

Description Enable or disable the antialiasing function of the oscilloscope; or query the current state of the antialiasing function of the oscilloscope.

Parameter

Name Type Range Default

<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Return Format The query returns 1 or 0.

2-14 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-15

:BUS<n> Commands

 :BUS<n>:MODE  :BUS<n>:DISPlay  :BUS<n>:FORMat  :BUS<n>:EVENt  :BUS<n>:EEXPort  :BUS<n>:DATA?  :BUS<n>:PARallel  :BUS<n>:RS232 (Option)  :BUS<n>:IIC (Option)  :BUS<n>:SPI (Option)  :BUS<n>:CAN (Option)

:BUS<n>:MODE

Syntax

:BUS<n>:MODE <mode> :BUS<n>:MODE?

Description Set or query the decoding mode of the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<mode> Discrete {PARallel|RS232|IIC|SPI|CAN} PARallel

Explanation

RS232 decoding, I2C decoding, SPI decoding and CAN decoding are options and this command is only valid when the corresponding options are installed.

Return Format The query returns PAR, RS232, IIC, SPI, or CAN.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:DISPlay

Syntax

:BUS<n>:DISPlay <bool> :BUS<n>:DISPlay?

Description Enable or disable the display of the specified bus; or query the current display status of the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Return Format The query returns 1 or 0.

:BUS<n>:FORMat

Syntax

:BUS<n>:FORMat <form at> :BUS<n>:FORMat?

Description Set or query the display format of the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<format> Discrete {HEX|DEC|BIN|ASCii} HEX

Explanation

 HEX: hexadecimal;  DEC: decimal;  BIN: binary;  ASCii: ASCII.

Return Format The query returns HEX, DEC, BIN, or ASC.

2-16 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-17

:BUS<n>:EVENt

Syntax

:BUS<n>:EVENt <bool> :BUS<n>:EVENt?

Description Enable or disable the even t table of the specified bus; or query the current status of the event table of the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Explanation

This command is only available when t he displayof the specified bus is enabled (

Return Format The query returns 1 or 0.

:BUS<n>:DISPlay).

:BUS<n>:EEXPort

Syntax

:BUS<n>:EEXPort

Description Export the event table of the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} --

Explanation The data list can be exported to an external USB storage device in CSV f ormat if an USB storage device is currently connecte d.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:DATA?

Syntax

:BUS<n>:DATA?

Description Read the decoding event table data.

Parameter

Name Type Range Default

<n> Discrete {1|2} --

Return Format

The query returns the decoding event table data in the following format. #9000000141RS232 Time,TX,TX ERR,

-6.1352322E-03,*,,

-4.0554402E-03,R,,

-1.9756482E-03,I,,

1.0414385E-04,G,,

2.1839839E-03,O,,

4.2637759E-03,L,,

Wherein, #9000000141 is the TMC data block header following which is the data in the event table. The figure behind #9 denotes the number of bytes of th e effective data. RS232 denotes the decoding mode (it can also be Parallel, I2C, SPI or CAN). The data are se parated by commas and will be displayed in different lines automatically according to the li nes in the decoding table. The data value is relate d to the specified format (

Note: You can save the data (except the TMC data block header and the decoding type; for example, #9000000141RS232) as a *.csv file and view the data in table form.

:BUS<n>:FORMat).

2-18 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-19

:BUS<n>:PARallel

 :BUS<n>:PARallel:CLK  :BUS<n>:PARallel:SLOPe  :BUS<n>:PARallel:BSET  :BUS<n>:PARallel:THReshold  :BUS<n>:PARallel:OFFSet

:BUS<n>:PARallel:CLK

Syntax

:BUS<n>:PARallel:CLK <sour> :BUS<n>:PARallel:CLK?

Description Set or query the cl ock channel source of parallel decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<sour> Discrete

Explanation When OFF is selected, no clock channel is set and the oscilloscope samples data once the channel data jumps. At this point, the edge set by the

Return Format The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, or OFF.

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11| D12|D13|D14|D15|CHANnel1|CHANnel2|OFF}

:BUS<n>:PARallel:SLOPe command can be ignored.

CHANnel1

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:PARallel:SLOPe

Syntax

:BUS<n>:PARallel:SLOPe <pos> :BUS<n>:PARallel:SLOPe?

Description Set or query the edge of the clock on which the oscilloscope samples the channel data.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<pos> Discrete {POSitive|NEGative|BOTH} POSitive

Explanation  POSitive: rising edge

NEGative: falling edge BOTH: rising/falling edge

 When no clock cha nnel is set (refer to the

samples data once the channel data jumps and the edge set by this command will be ignored.

Return Format The query returns POS, NEG, or BOTH

:BUS<n>:PARallel:CLK command), the oscilloscope

2-20 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-21

:BUS<n>:PARallel:BSET

Syntax

:BUS<n>:PARallel:BSET <b0>[,<b1>[,<b2>…[,<b17>]]] :BUS<n>:PARallel:BSET?

Description Set the data width of parallel decoding on the specified bus and the channel source for each bit; or query the channel source of each bit.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<b0> Discrete …… …… …… …… <b15> Discrete

<b16> Discrete

<b17> Discrete

Explanation

This command sets the bus data width and the setting sequence of the bits is LSB. For example, when the parameter is set to CHAN2,CHAN1, the bus data width is set to 2, bit 0 is CHAN2 and bit 1 is CHAN1.

Return Format The query returns the channel source of each bit in the current data channel. The number of the channel sources is determined by the current data width and multiple channels are separated by commas.

Example :BUS1:PARallel:BSET CHAN nel1,CHANnel2,D0,D1

:BUS1:PARallel:BSET? /*The query returns CHAN1,CHAN2,D0,D1*/

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2}

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2} {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2}

/*Set the data width to 4 and the channel sources of the bits are

CH1,CH2,D0,D1 respectively*/

D15

CHANnel1

CHANnel2

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:PARallel:THReshold

Syntax

:BUS<n>:PARallel:THReshold <sour>,<thre> :BUS<n>:PARallel:THReshold? <sour>

Description Set or query the ana log cha nnel threshold of parallel decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<sour> Discrete {CHANnel1|CHANnel2} -<thre> Real (-5 x VerticalScale - OFFSet) to (+5 x VerticalScale - OFFSet) 0

Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the

:CHANnel<n>:OFFSet command.

Return Format The query returns the analog channel threshold of parallel decoding on the specified bus in scientific notation.

2-22 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-23

[1]

:BUS<n>:PARallel:OFFSet

Syntax

:BUS<n>:PARallel:OFFSet <val> :BUS<n>:PARallel:OFFSet?

Description Set or query the vertical offset of parallel decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} --

Normal

<val> Integer

Statistic Half screen

[1]

Note

the

Note

command).

Note

commands).

: The screen display is normal and the statistic function is not enabled (refer to

:MEASure:STATistic:DISPlay command).

[2]

: The screen display is normal and the statistic function is enabled (refer to the :MEASure:STATistic:DISPlay

[3]

: The screen is divided into two windows (refer to the :TIMebase:DELay:ENABle and :CALCulate:FFT:SPLit

Explanation

 Before using this command, enable the bus display (refer to the  When the data line is located in the middle of the screen, <val> is 0; when it is located above the

middle of the screen, <val> is positive; when it is located below the middle of the screen, <val> is negative.

Return Format The query returns t he ve rt i ca l offset of parallel decoding on the specified bus in integer.

: -166 to 148

[2]

: -163 to 143

[3]

: -103 to 52

:BUS<n>:DISPlay command).

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:RS232 (Option)

 :BUS<n>:RS232:TX  :BUS<n>:RS232:RX  :BUS<n>:RS232:POLarity  :BUS<n>:RS232:ENDian  :BUS<n>:RS232:BAUD  :BUS<n>:RS232:BUSer  :BUS<n>:RS232:DBITs  :BUS<n>:RS232:SBITs  :BUS<n>:RS232:PARity  :BUS<n>:RS232:PACKet  :BUS<n>:RS232:PEND  :BUS<n>:RS232:TTHReshold  :BUS<n>:RS232:RTHReshold  :BUS<n>:RS232:OFFSet

:BUS<n>:RS232:TX

Syntax

:BUS<n>:RS232 : TX <so urc e > :BUS<n>:RS232:TX?

Description Set or query the TX channel source of RS232 decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<source> Discrete

Explanation

When OFF is selected, no TX channel source will be set. The TX channel source and RX channel source cannot both be set to OFF.

Return Format The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, or OFF.

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11| D12|D13|D14|D15|CHANnel1|CHANnel2|OFF}

CHANnel1

2-24 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-25

:BUS<n>:RS232:RX

Syntax

:BUS<n>:RS232:RX <source> :BUS<n>:RS232:RX?

Description Set or query the RX channel source of RS232 decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<source> Discrete

Explanation

When OFF is selected, no RX channel source will be set. The TX channel source and RX channel source cannot both be set to OFF.

Return Format The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, or OFF.

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2|OFF}

OFF

:BUS<n>:RS232:POLarity

Syntax

:BUS<n>:RS232 :PO La rity <pol> :BUS<n>:RS232:POLarity?

Description Set or query the pola rit y of R S23 2 decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<pol> Discrete {POSitive|NEGative} NEGative

Explanation

The RS232 standard uses negative logic; namely high level is 0 and low level is 1. Therefore, when <pol> is set to NEGative, the polar ity is set to negative logic (namely "Normal" polarity); when <pol> is set to POSitive, the polarity is set to positive polarity (namely "Invert" polarity).

Return Format The query returns POS or NEG.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:RS232:ENDian

Syntax

:BUS<n>:RS232 :EN Di an < endian> :BUS<n>:RS232:ENDian?

Description Set or query the endian of data transmission of RS232 decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<endian> Discrete {MSB|LSB} LSB

Return Format The query returns MSB or LSB.

:BUS<n>:RS232:BAUD

Syntax

:BUS<n>:RS232 :BAUD <baud> :BUS<n>:RS232:BAUD?

Description Set or query the baud rate of data transmission of RS232 decoding on the specified bus. The default unit is bps.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<baud> Discrete

Note: When the baud rate is set to USER, you can set a specific baud rate using the :BUS<n>:RS232:BUSer command.

Return Format The query returns the baud rate of data transmission of RS232 decoding on the specified bus in integer or returns USER.

{2400|4800|9600|19200|38400|57600|115200| 230400|460800|921600|1000000|USER}

9600

2-26 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-27

:BUS<n>:RS232:BUSer

Syntax

:BUS<n>:RS232:BUSer <baud> :BUS<n>:RS232:BUSer?

Description Set or q uery the user -defined baud rate of data transmission of RS232 decoding on the specified bus. The default unit is bps.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<baud> Integer 110 to 20000000 9600

Return Format The query returns the user-defined baud rate of data transmission of RS232 decoding on the specified bus in integer.

:BUS<n>:RS232:DBITs

Syntax

:BUS<n>:RS232:DBITs <bits> :BUS<n>:RS232:DBITs?

Description Set or query the number of bits of data of RS232 decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<bits> Discrete {5|6|7|8|9} 8

Return Format The query returns 5, 6, 7, 8, or 9.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:RS232:SBITs

Syntax

:BUS<n>:RS232:SBITs <stop bits> :BUS<n>:RS232:SBITs?

Description Set or query the stop bit after each frame of data of RS232 decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<stop bits> Discrete {1|1.5|2} 1

Return Format The query returns 1, 1.5, or 2.

:BUS<n>:RS232:PARity

Syntax

:BUS<n>:RS232 :PA Ri ty <parity> :BUS<n>:RS232:PARity?

Description Set or query the even-odd check mode of data transmission of RS232 decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<parity> Discrete {NONE|ODD|EVEN} NONE

Return Format The query returns NONE, ODD, or EVEN.

2-28 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-29

:BUS<n>:RS232:PACKet

Syntax

:BUS<n>:RS232:PACKet <bool> :BUS<n>:RS232:PACKet?

Description Enable or disable the packet end in data transmission; or query the current status of the packet end in data transmission.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Explanation

When the packet end is enabled, several data blocks are combined according to the packet end.

Return Format The query returns 1 or 0.

:BUS<n>:RS232:PEND

Syntax

:BUS<n>:RS232:PEND <package end> :BUS<n>:RS232:PEND?

Description Set or query the packet end of data transmission.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<package end> Discrete {NULL|LF|CR|SP|FF} NULL

Explanation The hexadecimal numbers corresponding to the parameters are as follows. NULL: 00 LF: 0A CR: 0D SP: 20 FF: FF

Return Format The query returns NULL, LF, CR, SP, or FF.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:RS232:TTHReshold

Syntax

:BUS<n>:RS232:TTHReshold <tthre> :BUS<n>:RS232:TTHReshold?

Description Set or query

the TX channel threshold of R232 decoding on the spe cified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<tthre> Real (-5 x VerticalScale - OFFSet) to (+5 x VerticalScale - OFFSet) 0

Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the

:CHANnel<n>:OFFSet command.

Explanation

This command is only available when the TX channel source is CH1 or CH2.

Return Format The query returns the TX channel threshold of R232 decoding on the specified bus in scientific notation.

:BUS<n>:RS232:RTHReshold

Syntax

:BUS<n>:RS232:RTHReshold <rthre> :BUS<n>:RS232:RTHReshold?

Description Set or query

Parameter

Name Type Range Default

<n> Discrete {1|2} -<rthre> Real (-5 x VerticalScale - OFFSet) to (+5 x VerticalScale - OFFSet) 0

Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the

:CHANnel<n>:OFFSet command.

Explanation

This command is only available when the RX channe l source is CH1 or CH2.

Return Format The query returns the RX channel threshold of R232 decoding on the specified bus in scientific notation.

the RX channel threshold of R232 decoding on the specified bus.

2-30 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-31

[1]

:BUS<n>:RS232:OFFSet

Syntax

:BUS<n>:RS232 :OF FSe t <va l> :BUS<n>:RS232:OFFSet?

Description Set or query the vertical offset of RS232 decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} --

Normal

<val> Integer

Statistic Half screen

[1]

Note

the

Note

command).

Note

commands).

: The screen display is normal and the statistic function is not enabled (refer to

:MEASure:STATistic:DISPlay command).

[2]

: The screen display is normal and the statistic function is enabled (refer to the :MEASure:STATistic:DISPlay

[3]

: The screen is divided into two windows (refer to the :TIMebase:DELay:ENABle and :CALCulate:FFT:SPLit

Explanation

 Before using this command, enable the bus display (refer to the  When the data line is located in the middle of the screen, <val> is 0; when it is located above the

middle of the screen, <val> is positi ve; when it is loca ted be low the middle of t he screen, <val> is negative.

Return Format The query returns the vertical offset of RS232 decoding on the specified bus in integer.

: -166 to 148

[2]

: -163 to 143

[3]

: -103 to 52

:BUS<n>:DISPlay command).

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:IIC (Option)

 :BUS<n>:IIC:SCLK:SOURce  :BUS<n>:IIC:SCLK:THReshold  :BUS<n>:IIC:SDA:SOURce  :BUS<n>:IIC:SDA:THReshold  :BUS<n>:IIC:OFFSet

:BUS<n>:IIC:SCLK:SOURce

Syntax

:BUS<n>:IIC:SCLK:SOURce <sour> :BUS<n>:IIC:SCLK:SOURce?

Description Set or query the clock channel s ource of I2C decoding on the specified b us.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<sour> Discrete

Return Format The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2}

CHANnel1

2-32 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-33

:BUS<n>:IIC:SCLK:THReshold

Syntax

:BUS<n>:IIC:SCLK:THReshold <thre> :BUS<n>:IIC:SCLK:THReshold?

Description Set or query the clock channel thres hold of I2C decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<thre> Real (-5 x VerticalScale - OFFSet) to (+5 x VerticalScale - OFFSet) 0

Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the

:CHANnel<n>:OFFSet command.

Explanation

This command is only available when the clock channel source is CH1 or CH2.

Return Format The query returns the clock channel threshold of I2C decoding on the specified bus in scientific notation.

:BUS<n>:IIC:SDA:SOURce

Syntax

:BUS<n>:IIC:S DA :SO UR ce <s o ur> :BUS<n>:IIC:SDA:SOURce?

Description Set or query the data channel source of I2C decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<sour> Discrete

Return Format The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2}

CHANnel2

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:IIC:SDA:THReshold

Syntax

:BUS<n>:IIC:SDA:THReshold <thre> :BUS<n>:IIC:SDA:THReshold?

Description Set or query the data channel threshold of I2C decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<thre> Real (-5 x VerticalScale - OFFSet) to (+5 x VerticalScale - OFFSet) 0

Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the

:CHANnel<n>:OFFSet command.

Explanation

This command is only available w hen the data channel source is CH1 or CH2.

Return Format The query returns the data channel thres hold of I2C decoding on the specified bus in scientific notation.

2-34 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-35

[1]

:BUS<n>:IIC:OFFSet

Syntax

:BUS<n>:IIC:OFF Set <val> :BUS<n>:IIC:OFFSet?

Description Set or query the vertical offset of I2C decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} --

Normal

<val> Integer

Statistic Half screen

[1]

Note

the

Note

command).

Note

commands).

: The screen display is normal and the statistic function is not enabled (refer to

:MEASure:STATistic:DISPlay command).

[2]

: The screen display is normal and the statistic function is enabled (refer to the :MEASure:STATistic:DISPlay

[3]

: The screen is divided into two windows (refer to the :TIMebase:DELay:ENABle and :CALCulate:FFT:SPLit

Explanation

 Before using this command, enable the bus display (refer to the  When the data line is located in the middle of the screen, <val> is 0; when it is located above the

middle of the screen, <val> is positive; when it is located be low the middle of the screen, <val> is negative.

Return Format The query returns the vertical offset of I2C decoding on the specified bus in integer.

: -166 to 148

[2]

: -163 to 143

[3]

: -103 to 52

:BUS<n>:DISPlay command).

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:SPI (Option)

 :BUS<n>:SPI:SCLK:SOURce  :BUS<n>:SPI:SCLK:SLOPe  :BUS<n>:SPI:SCLK:THReshold  :BUS<n>:SPI:SDA:SOURce  :BUS<n>:SPI:SDA:POLarity  :BUS<n>:SPI:SDA:THReshold  :BUS<n>:SPI:DBITs  :BUS<n>:SPI:ENDian  :BUS<n>:SPI:OFFSet  :BUS<n>:SPI:MODE  :BUS<n>:SPI:TIMeout:TIME  :BUS<n>:SPI:SS:SOURce  :BUS<n>:SPI:SS:POLarity  :BUS<n>:SPI:SS:THReshold

:BUS<n>:SPI:SCLK:SOURce

Syntax

:BUS<n>:SPI:SCLK:SOURce <sour> :BUS<n>:SPI:SCLK:SOURce?

Description Set or query the clock channel so urce of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<sour> Discrete

Return Format The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2}

CHANnel1

2-36 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-37

:BUS<n>:SPI:SCLK:SLOPe

Syntax

:BUS<n>:SPI:SC LK : SLOP e <pos> :BUS<n>:SPI:SCLK:SLOPe?

Description Set or query the clock edge type of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<pos> Discrete {POSitive|NEGative} POSitive

Return Format The query returns POS or NEG.

:BUS<n>:SPI:SCLK:THReshold

Syntax

:BUS<n>:SPI:SCLK :THR e s hold <t hre> :BUS<n>:SPI:SCLK:THReshold?

Description Set or query the clock channel thres hold of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<thre> Real (-5 x VerticalScale - OFFSet) to (+5 x VerticalScale - OFFSet) 0

Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the

:CHANnel<n>:OFFSet command.

Explanation

This command is only available when the clock channel source is C H 1 or CH2.

Return Format The query returns the clock channel threshold of SPI decoding on the specified bus in scientific notation.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:SPI:SDA:SOURce

Syntax

:BUS<n>:SPI:SDA:SOURce <s our> :BUS<n>:SPI:SDA:SOURce?

Description Set or query the data channel source of SPI decodi ng on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<sour> Discrete

Return Format The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2}

CHANnel2

:BUS<n>:SPI:SDA:POLarity

Syntax

:BUS<n>:SPI:SDA:POLarity <pos> :BUS<n>:SPI:SDA:POLarity?

Description Set or query the polarity of the SDA dat a line of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<pos> Discrete {HIGH|LOW} HIGH

Explanation

HIGH: low level is 0; high le vel is 1. LOW: high level is 0; low level is 1.

Return Format The query returns HIGH or LOW.

2-38 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-39

:BUS<n>:SPI:SDA:THReshold

Syntax

:BUS<n>:SPI:SDA:THReshold <thre> :BUS<n>:SPI:SDA:THReshold?

Description Set or query the data channel threshold of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<thre> Real (-5 x VerticalScale - OFFSet) to (+5 x VerticalScale - OFFSet) 0

Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the

:CHANnel<n>:OFFSet command.

Explanation

This command is only available when the data channel source is CH 1 or CH2.

Return Format The query returns the data channel threshold of SPI decoding on the specified bus in scientific notation.

:BUS<n>:SPI:DBITs

Syntax

:BUS<n>:SPI:DBITs <width> :BUS<n>:SPI:DBITs?

Description Set or query the number o f bits of data of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<width> Integer 4 to 32 8

Return Format The query returns an integer between 4 and 32.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:SPI:ENDian

Syntax

:BUS<n>:SPI:EN Dian <endian> :BUS<n>:SPI:ENDian?

Description Set or query the endian of data transmission of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<endian> Discrete {MSB|LSB} MSB

Return Format The query returns MSB or LSB.

2-40 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-41

[1]

:BUS<n>:SPI:OFFSet

Syntax

:BUS<n>:SPI:OF FSet <val> :BUS<n>:SPI:OFFSet?

Description Set or query the vertical offset of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} --

Normal

<val> Integer

Statistic Half screen

[1]

Note

the

Note

command).

Note

commands).

: The screen display is normal and the statistic function is not enabled (refer to

:MEASure:STATistic:DISPlay command).

[2]

: The screen display is normal and the statistic function is enabled (refer to the :MEASure:STATistic:DISPlay

[3]

: The screen is divided into two windows (refer to the :TIMebase:DELay:ENABle and :CALCulate:FFT:SPLit

Explanation

 Before using this command, enable the bus display (refer to the  When the data line is locat ed in the middle of the screen, <val> is 0; when it is located above the

middle of the screen, <val> is positi ve; when it is loc ate d below t he middle o f the screen, <val> is negative.

Return Format The query returns the vertical offset of SPI decoding on the specified bus in integer.

: -166 to 148

[2]

: -163 to 143

[3]

: -103 to 52

:BUS<n>:DISPlay command).

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:SPI:MODE

Syntax

:BUS<n>:SPI:MODE <m od e > :BUS<n>:SPI:MODE?

Description

Set or query the decoding mode of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> <mode> Discrete {CS|TIMeout} TIMeout

Explanation

 CS: It indicates that the oscilloscope samples the data of the data line source channel on the

specified edge of the clock signal when the chip select (CS) signal is the specified level.

 TIMeout: It indicates tha t the oscilloscope samples the data of the data line source channel on the

specified edge of the clock signal when the clock signal is in the idle state for a specified period of time.

Discrete

{1|2}

Return Format

The query returns CS or TIM.

Related Commands

:BUS<n>:SPI:SS:SOURce :BUS<n>:SPI:SS:POLarity :BUS<n>:SPI:SS:THReshold :BUS<n>:SPI:TIMeout:TIME

2-42 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-43

:BUS<n>:SPI:TIMeout:TIME

Syntax

:BUS<n>:SPI:TIMeout:TIME <val> :BUS<n>:SPI:TIMeout:TIME?

Description

Set or query the timeout time of SPI decoding on the sp ecified bus. The default unit is s.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<val> Real 100ns to 1s 1us

Return Format

The query returns the timeout time of SPI decoding on the specified bus in s cie nt ific notation.

:BUS<n>:SPI:SS:SOURce

Syntax

:BUS<n>:SPI:SS: SOUR ce <so ur ce> :BUS<n>:SPI:SS:SOURce?

Description

Set or query the source channel of the chip select line of SPI decoding on the spe cified bus.

Parameter

Name Type Range Default

<n> <source> Discrete

Discrete

{1|2} {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2}

CHANnel2

Return Format

The query retur ns D0 , D1, D2, D3, D4, D 5, D6 , D7, D8, D9, D10, D 11, D12, D13 , D14, D 15 , CHAN1, or CHAN2.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:SPI:SS:POLarity

Syntax

:BUS<n>:SPI:S S:P OLa ri t y <pol> :BUS<n>:SPI:SS:POLarity?

Description

Set or query the polarity of the chip select line of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> <pol> Discrete {HIGH|LOW} LOW

Explanation  HIGH: set the oscilloscope to sample the data of the data line source channel on the specified edge

of the clock signal when the chip select signal is "High Level".

 LOW: set the oscilloscope to sample the data of the data line source channel on the specified edge of

the clock signal when the chip select signal is "Low Level".

Return Format

The query returns HIGH or LOW.

Discrete

{1|2}

2-44 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-45

:BUS<n>:SPI:SS:THReshold

Syntax

:BUS<n>:SPI:SS:THReshold <thre> :BUS<n>:SPI:SS:THReshold?

Description

Set or query the threshold of the source channel of the chip select line of SPI decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<thre> Real (-5 x VerticalScale - OFFSet) to (+5 x VerticalScale - OFFSet) 0

Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the

:CHANnel<n>:OFFSet command.

Explanation This command is only available w hen the source channel of the chip select line of SPI decod ing on the specified bus is CH1 or CH2.

Return Format

The query returns the threshold of t he so urce cha n nel o f the chip select line of SPI decoding on the specified bus in scientific notation.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:CAN (Option)

 :BUS<n>:CAN:SOURce  :BUS<n>:CAN:STYPe  :BUS<n>:CAN:BAUD  :BUS<n>:CAN:BUSer  :BUS<n>:CAN:SPOint  :BUS<n>:CAN:THReshold  :BUS<n>:CAN:OFFSet

:BUS<n>:CAN:SOURce

Syntax

:BUS<n>:CAN:SOURce <sour> :BUS<n>:CAN:SOURce?

Description Set or query the channel source of CAN decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<sour> Discrete

Return Format The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2}

CHANnel1

2-46 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-47

:BUS<n>:CAN:STYPe

Syntax

:BUS<n>:CAN:STYPe <stype> :BUS<n>:CAN:STYPe?

Description Set or query the signal type of CAN decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<stype> Discrete {TX|RX|CANH|CANL|DIFFerential} RX

Return Format The query returns TX, RX, CANH, CANL, or DIFF.

:BUS<n>:CAN:BAUD

Syntax

:BUS<n>:CAN:BAUD <baud> :BUS<n>:CAN:BAUD?

Description Set or query the signal rate of CAN decoding on the specified bus. The default unit is b/s.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<baud> Discrete {100000|125000|250000|400000|500000|800000|1000000|USER} 500000

Note: When the signal rate is set to USER, you can use the :BUS<n>:CAN:BUSer command to set a user-defined signal rate.

Return Format The query returns the signal rate of CAN decoding on the specified bus in integer or returns USER.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:BUS<n>:CAN:BUSer

Syntax

:BUS<n>:CAN:BUSer <baud> :BUS<n>:CAN:BUSer?

Description Set or query the user-defined signal rate of CAN decoding on the specified bus. The default unit is b/s.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<baud> Integer 10000 to 1000000 500000

Return Format The query returns the user-de fined signal rate of CAN decoding on the specified bus in integer.

:BUS<n>:CAN:SPOint

Syntax

:BUS<n>:CAN:SPOint <spo> :BUS<n>:CAN:SPOint?

Description Set or query the sample position (expressed in percentage) of CAN decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<spo> Integer 5 to 95 50

Return Format The query returns the sample position of CAN decoding on the specified bus i n integer.

2-48 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-49

:BUS<n>:CAN:THReshold

Syntax

:BUS<n>:CAN:THR eshold <thre> :BUS<n>:CAN:THReshold?

Description Set ro query the threshold of CAN decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<thre> Real (-5 x VerticalScale - OFFSet) to (+5 x VerticalScale - OFFSet) 0

Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the

:CHANnel<n>:OFFSet command.

Explanation

This command is only available when the cha nnel source is CH1 or CH2.

Return Format The query returns the threshold of CAN decoding on the specified bus in scientific notation.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

[1]

:BUS<n>:CAN:OFFSet

Syntax

:BUS<n>:CAN:OFFSet <val> :BUS<n>:CAN:OFFSet?

Description Set or query the vertical offset of CAN decoding on the specified bus.

Parameter

Name Type Range Default

<n> Discrete {1|2} --

Normal

<val> Integer

Statistic Half screen

[1]

Note

the

Note

command).

Note

commands).

: The screen display is normal and the statistic function is not enabled (refer to

:MEASure:STATistic:DISPlay command).

[2]

: The screen display is normal and the statistic function is enabled (refer to the :MEASure:STATistic:DISPlay

[3]

: The screen is divided into two windows (refer to the :TIMebase:DELay:ENABle and :CALCulate:FFT:SPLit

Explanation

 Before using this command, enable the bus display (refer to the  When the data line is located in the middle of the screen, <val> is 0; when it is located above the

middle of the screen, <val> is positi ve; when it is located below the m iddle of the screen, <val> is negative.

Return Format The query returns the vertical offset of CAN decoding on the specified bus in integer.

: -166 to 148

[2]

: -163 to 143

[3]

: -103 to 52

:BUS<n>:DISPlay command).

2-50 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-51

:CALCulate Commands

 :CALCulate:MODE  :CALCulate:ADD  :CALCulate:SUB  :CALCulate:MULTiply  :CALCulate:DIVision  :CALCulate:FFT  :CALCulate:LOGic  :CALCulate:ADVanced

:CALCulate:MODE

Syntax

:CALCulate:MODE <m od > :CALCulate:MODE?

Description Set or query the math operation type.

Parameter

Name Type Range Default

<mod> Discrete {ADD|SUB|MULTiply|DIVision|FFT|LOGic|ADVanced|OFF} OFF

Return Format The query returns ADD, SUB, MULT, DIV, FFT, LOG, ADV, or OFF.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:ADD

 :CALCulate:ADD:SA  :CALCulate:ADD:SB  :CALCulate:ADD:INVert  :CALCulate:ADD:VSCale  :CALCulate:ADD:VOFFset

:CALCulate:ADD:SA :CALCulate:ADD:SB

Syntax

:CALCulate:ADD :SA <so urc e > :CALCulate:ADD:SA? :CALCulate:ADD:SB <source> :CALCulate:ADD:SB?

Description Set or query the channel source of source A in the addition operation. Set or query the channel source of source B in the addition operation.

Parameter

Name Type Range Default

<source> Discrete {CHANnel1|CHANnel2} CHANnel1

Return Format The query returns CHAN1 or CHAN2.

2-52 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-53

:CALCulate:ADD:INVert

Syntax

:CALCulate:ADD:INVert <bool> :CALCulate:ADD:INVert?

Description Enable or disable the inverted display of the addition operation result; or query the current status of the inverted display of the addition operation result.

Parameter

Name Type Range Default

<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Return Format The query returns 1 or 0.

:CALCulate:ADD:VSCale

Syntax

:CALCulate:ADD:VSCale <scale> :CALCulate:ADD:VSCale?

Description Set or query the vertical scale of the addition operation result. The unit is related to the amplitude unit of the signal source channel .

Parameter

Name Type Range Default

The default range is from 0.02 to 500.

<scale> Real

Note: For the channel vertical scale, refer to the :CHANnel<n>:SCALe command.

Return Format

The query returns the vertical scale of the addition ope r ation result in scientific notation.

The actual range is related to the vertical scal e of the signal source channel.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:ADD:VOFFset

Syntax

:CALCulate:ADD:VOFFset <offs> :CALCulate:ADD:VOFFset?

Description Set or query the vertical offset of the addition operation result. The unit is related to the amplitude unit of the signal source channel .

Parameter

Name Type Range Default

<offs> Real (-40 x VScale) to (40 x VScale) 0

Note: For the VScale (the vertical scale of MATH), refer to the :CALCulate:ADD:VSCale command.

Return Format

The query returns the vertical offset of the addition ope r ation result in scientific notation.

2-54 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-55

:CALCulate:SUB

 :CALCulate:SUB:SA  :CALCulate:SUB:SB  :CALCulate:SUB:INVert  :CALCulate:SUB:VSCale  :CALCulate:SUB:VOFFset

:CALCulate:SUB:SA :CALCulate:SUB:SB

Syntax

:CALCulate:SUB:SA <source> :CALCulate:SUB:SA? :CALCulate:SUB:SB <source> :CALCulate:SUB:SB?

Description Set or query the channel source of source A in the subtraction operation. Set or query the channel source of source B in the subtraction operation.

Parameter

Name Type Range Default

<source> Discrete {CHANnel1|CHANnel2} CHANnel1

Return Format The query returns CHAN1 or CHAN2.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:SUB:INVert

Syntax

:CALCulate:S UB:INVert <bool> :CALCulate:SUB:INVert?

Description Enable or disable the inverted display of the subtraction operation result; or query the current status of the inverted display of the subtraction operation result.

Parameter

Name Type Range Default

<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Return Format The query returns 1 or 0.

:CALCulate:SUB:VSCale

Syntax

:CALCulate:SUB:VSCale <scal e> :CALCulate:SUB:VSCale?

Description Set or query the vertical scale of th e subtraction operation result. T he unit is related to the amplitude unit of the signal source cha nnel.

Parameter

Name Type Range Default

The default range is from 1p to 200.

<scale> Real

Note: For the channel vertical scale, refer to the :CHANnel<n>:SCALe command.

Return Format

The query returns the vertical scale of the subtraction operation result in scientific notation.

The actual range is related to the vertical scale o f the signal source channel.

2-56 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-57

:CALCulate:SUB:VOFFset

Syntax

:CALCulate:SUB:VOFFset <offs> :CALCulate:SUB:VOFFset?

Description Set or query the vertical offset of the subtraction operation result. The unit is related to the amplitude unit of the signal source channel.

Parameter

Name Type Range Default

<offs> Real (-40 x VScale) to (40 x VScale) 0

Note: For the VScale (the vertical scale of MATH), refer to the :CALCulate:SUB:VSCale command.

Return Format

The query returns the vertical offset of the subtraction operation result in scientific notation.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:MULTiply

 :CALCulate:MULTiply:SA  :CALCulate:MULTiply:SB  :CALCulate:MULTiply:INVert  :CALCulate:MULTiply:VSCale  :CALCulate:MULTiply:VOFFset

:CALCulate:MULTiply:SA :CALCulate:MULTiply:SB

Syntax

:CALCulate:MU LTi ply :SA <s our ce > :CALCulate:MULTiply:SA? :CALCulate:MULTiply:SB <source> :CALCulate:MULTiply:SB?

Description Set or query the channel source of source A in the multiplication operation. Set or query the channel source of source B in the multiplication operation.

Parameter

Name Type Range Default

<source> Discrete {CHANnel1|CHANnel2} CHANnel1

Return Format The query returns CHAN1 or CHAN2.

2-58 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-59

:CALCulate:MULTiply:INVert

Syntax

:CALCulate:MULTiply:INVert <bool> :CALCulate:MULTiply:INVert?

Description Enable or disable the inverted display of the multiplication operation result; or qu ery the current status of the inverted display of the multiplication operation result.

Parameter

Name Type Range Default

<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Return Format The query returns 1 or 0.

:CALCulate:MULTiply:VSCale

Syntax

:CALCulate:MULTiply:VSCale <scale> :CALCulate:MULTiply:VSCale?

Description Set or query the vertical scale of the multiplication operation result.

Parameter

Name Type Range Default

The default range is from 50nU to 10MU.

<scale> Real

Note: For the channel vertical scale, refer to the :CHANnel<n>:SCALe command.

Return Format

The query returns the vertical scale of the multiplication operation resul t in scientific notation.

The actual range is related to the vertical scale of the signal source channel.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:MULTiply:VOFFset

Syntax

:CALCulate:MULTiply:VOFFset <offs> :CALCulate:MULTiply:VOFFset?

Description Set or query the vertical offset of the multiplication operation result.

Parameter

Name Type Range Default

<offs> Real (-40 x VScale) to (40 x VScale) 0

Note: For the VScale (the vertical scale of MATH), refer to the :CALCulate:MULTiply:VSCale command.

Return Format

The query returns t he ve rt i ca l of fset of the multiplication operation result in scientific notation.

2-60 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-61

:CALCulate:DIVision

 :CALCulate:DIVision:SA  :CALCulate:DIVision:SB  :CALCulate:DIVision:INVert  :CALCulate:DIVision:VSCale  :CALCulate:DIVision:VOFFset

:CALCulate:DIVision:SA :CALCulate:DIVision:SB

Syntax

:CALCulate:DIVision:SA <source> :CALCulate:DIVision:SA? :CALCulate:DIVision:SB <source> :CALCulate:DIVision:SB?

Description Set or query the channel source of source A in the division operation. Set or query the channel source of source B in the division operation.

Parameter

Name Type Range Default

<source> Discrete {CHANnel1|CHANnel2} CHANnel1

Return Format The query returns CHAN1 or CHAN2.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:DIVision:INVert

Syntax

:CALCulate:DIVision:INVert <bool> :CALCulate:DIVision:INVert?

Description Enable or disable the inverted display of the division operation result; or query the current status of the inverted display of the division operation result.

Parameter

Name Type Range Default

<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Return Format The query returns 1 or 0.

:CALCulate:DIVision:VSCale

Syntax

:CALCulate:DIVision:VSCale <scale> :CALCulate:DIVision:VSCale?

Description Set or query the vertical scale of the division operation result.

Parameter

Name Type Range Default

The default range is from 50nU to 50MU.

<scale> Real

Note: For the channel vertical scale, refer to the :CHANnel<n>:SCALe command.

Return Format

The query returns the vertical scale of the division operat ion result in scientific notation.

The actual range is related to the vertical scale of the signal source channel.

2-62 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-63

:CALCulate:DIVision:VOFFset

Syntax

:CALCulate:DIVision:VOFFset <offs> :CALCulate:DIVision:VOFFset?

Description Set or query the vertical offset of the division operation result.

Parameter

Name Type Range Default

<offs> Real (-40 x VScale) to (40 x VScale) 0

Note: For the VScale (the vertical scale of MATH), refer to the :CALCulate:DIVision:VSCale command.

Return Format

The query returns the vertical offset of the division operation result in scienti fic notat ion.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:FFT

 :CALCulate:FFT:SOURce  :CALCulate:FFT:WINDow  :CALCulate:FFT:SPLit  :CALCulate:FFT:VSMode  :CALCulate:FFT:VSCale  :CALCulate:FFT:VOFFset  :CALCulate:FFT:HSCale  :CALCulate:FFT:HOFFset  :CALCulate:FFT:HSPan  :CALCulate:FFT:HCENter

:CALCulate:FFT:SOURce

Syntax

:CALCulate:FFT:SOURce <source> :CALCulate:FFT:SOURce?

Description Set or query the signal source of FFT operation.

Parameter

Name Type Range Default

<source> Discrete {CHANnel1|CHANnel2} CHANnel1

Return Format The query returns CHAN1 or CHAN2.

2-64 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-65

:CALCulate:FFT:WINDow

Syntax

:CALCulate:FF T:W IN Dow < window> :CALCulate:FFT:WINDow?

Description Set or query the wi ndow function of the FFT operation.

Parameter

Name Type Range Default

<window> Discrete {RECTangle|HANNing|HAMMing|BLACkman} RECTangle

Explanation

 The window function can effectively reduce the spectrum leakage effect.  Different window function is suitable for measuring different waveform; therefore, please select the

desired window function according to the waveform to be measured and its cha racteristics.

Return Format The query returns RECT, HANN, HAMM, or BLAC.

:CALCulate:FFT:SPLit

Syntax

:CALCulate:FF T:SP Lit <bo ol> :CALCulate:FFT:SPLit?

Description Enable or disable the split display of the FFT operation; or query the current status of the split display of the FFT operation.

Parameter

Name Type Range Default

<bool> Bool {{1|ON}|{0|OFF}} 1|ON

Explanation

 ON: the signal source channel waveform and the FFT operation results are displayed separately. The

time domain and frequency domain signals are displayed clearly.

 OFF (Full Screen): the signal source channel waveform and the FFT operation results are displayed in

the same window to view the frequency spectrum more clearly and to perform more precise measurement.

Return Format The query returns 1 or 0.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:FFT:VSMode

Syntax

:CALCulate:FF T:V SMo de <vmode> :CALCulate:FFT:VSMode?

Description Set or query the vertical scale type of the FFT operation result.

Parameter

Name Type Range Default

<vmode> Discrete {VRMS|DB} DB

Return Format The query returns VRMS or DB.

:CALCulate:FFT:VSCale

Syntax

:CALCulate:FFT:VSCale <vscale> :CALCulate:FFT:VSCale?

Description Set or query the vertical scale of the FFT operation result. The unit is related to the current vertical scale type of FFT operation and the amplitude unit of the signal source channel.

Parameter

Name Type Range Default

Related to the current vertical scale type of FFT operation:

<vscale> Real

Note: For the vertical scale type of FFT operation, refer to the :CALCulate:FFT:VSMode command. For the channel vertical scale, refer to the <vscale> will be changed only after the MATH channel is re-activated.

Return Format The query returns the vertical scale of the FFT operation result in scientific notation.

dB: 1 to 100 Vrms: the default range is from 0.01 to 200. The actual range is

20dBV/div

related to the vertical scale of the signal source channel.

:CHANnel<n>:SCALe command. Once you change the channel vertical scale, the range of

2-66 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-67

:CALCulate:FFT:VOFFset

Syntax

:CALCulate:FF T:V O FFse t < off s> :CALCulate:FFT:VOFFset?

Description Set or query the vertical offset of the FFT operation result. The unit is related to the current vertical scale type of FFT operation and the amplitude unit of the signal source channel.

Parameter

Name Type Range Default

<offs> Real (-40 x VScale) to (40 x VScale) 60dBV

Note: For the VScale (the vertical scale of MATH), refer to the :CALCulate:FFT:VSCale command.

Return Format

The query returns the vertical offset of the FFT operation result in scientifc notation.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:FFT:HSCale

Syntax

:CALCulate:FFT:HSCale <hscale> :CALCulate:FFT:HSCale?

Description Set or query the horizontal coefficient of FFT operation. This command indirectly sets the horizontal scale of FFT operation.

Parameter

Name Type Range Default

<hscale> Discrete {1|2|3|4} 2

Note: You can use the :CALCulate:FFT:HSPan command to set the horizontal scale of FFT operation directly.

Explanation

 The FFT horizontal c oefficient represents the relationship between the FFT horizontal scale (Hspan)

and the current FFT sample rate of the screen (Sa). 1: Hspan=Sa/20 2: Hspan=Sa/40 3: Hspan=Sa/100 4: Hspan=Sa/200

 The current FFT sample rate of the screen=the number of pixels per grid horizontally/the horizontal

timebase. The number of pixels per grid horizontally is related to the on/off status of the aunti-aliasing function; it is 50 when the anti-aliasing function is disa bled and 100 when the anti-aliasing function is enabled. For the horizontal timebase, refer to the command.

Return Format The query returns 1, 2, 3, or 4.

:TIMebase[:MAIN]:SCALe

2-68 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-69

:CALCulate:FFT:HOFFset

Syntax

:CALCulate:FFT:HOFFset <offs> :CALCulate:FFT:HOFFset?

Description Set or query the h orizontal offset of the FFT operation result. The unit is Hz.

Parameter

Name Type Range Default <offs> Real Refer to Explanation 0

Explanation

 The range of <offs> is related to the on/off status of the anti-aliasing function, the current FFT

sample rate of the screen (Sa) and the curr ent FFT horizontal scale (Hspan). When the anti-aliasing function is disabled: max{-0.5 x Sa, -14 x Hspan} to 0.5 x Sa When the anti-aliasing function is enabled: max{-0.4 x Sa, -14 x Hspan} to 0.4 x Sa

Note: max{A, B} means using the larger one of A and B.

 The current FFT sample rate of the screen=the number of pixels per grid horizontally/the horizontal

timebase. The number of pixels per grid horizontally is related to the on/off status of the FFT anti-aliasing function; it is 50 when the ainti -aliasing function is disabled and 100 when the anti-aliasing function is enabled. For the horizontal timebase, refer to the command.

 The FFT horizontal scale is related to the current FFT sample rate of the screen and the FF T

horizontal coefficient. Please refer to the

:CALCulate:FFT:HSPan command.

Return Format The query returns the horizontal of fs et of the FFT operation result in scientific notation.

:TIMebase[:MAIN]:SCALe

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:FFT:HSPan

Syntax

:CALCulate:FF T:H SPa n <span> :CALCulate:FFT:HSPan?

Description Set or query the horizontal scale of the FFT operation result. T he unit is Hz/div.

Parameter

Name Type Range Default <span> Discrete Refer to Explanation 1.25MHz/div

Explanation

 The FFT horizontal scale is related to the current FFT sample rate of the sc reen (Sa). It can be Sa/20,

Sa/40, Sa/100, and Sa/200.

 The current FFT sample rate of the sc reen = the number of pix els per grid horizontally/the horizontal

timebase. The number of pixels per grid horizontally is related to the on/off status of the FFT anti-aliasing function; it is 50 when the ainti-aliasing function is disabled and 100 when the anti-aliasing function is enabled. For the horizontal timebase, refer to the command.

 You can set the horizontal scale of FFT operation indirectly by setting the FFT horizontal coefficient

(:CALCulate:FFT:HSCale

Return Format The query returns the horizontal scale of the FFT operation result in scientific notation.

:TIMebase[:MAIN]:SCALe

2-70 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-71

:CALCulate:FFT:HCENter

Syntax

:CALCulate:FFT:HCENter <center> :CALCulate:FFT:HCENter?

Description Set or query the center frequency of the FFT operation result. The unit is Hz.

Parameter

Name Type Range Default

<center> Real

Note: For the horizontal offset, refer to the :CALCulate:FFT:HOFFset command; for the horizontal scale, refer to the

:CALCulate:FFT:HSCale and :CALCulate:FFT:HSPan commands.

Return Format The query returns the center frequency of the FFT operation result in scientific notation.

Horizontal offset of the operation result + 7 x (the current horizontal scale)

8.75MHz

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:LOGic

 :CALCulate:LOGic:SA  :CALCulate:LOGic:SB  :CALCulate:LOGic:INVert  :CALCulate:LOGic:VSCale  :CALCulate:LOGic:VOFFset  :CALCulate:LOGic:OPERator  :CALCulate:LOGic:ATHReshold  :CALCulate:LOGic:BTHReshold

:CALCulate:LOGic:SA :CALCulate:LOGic:SB

Syntax

:CALCulate:LO Gic: SA <sou r ce > :CALCulate:LOGic:SA? :CALCulate:LOGic:SB <source> :CALCulate:LOGic:SB?

Description Set or query the channel source of source A in the logic operation. Set or query the channel source of source B in the logic operation.

Parameter

Name Type Range Default

<source> Discrete

Explanation If the current logic operation type is NOT, only use the :CALCulate:LOGic:SA command t o specify the channel source of signal source A.

Return Format The query returns D 0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.

{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANnel2}

CHANnel1

2-72 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-73

:CALCulate:LOGic:INVert

Syntax

:CALCulate:LOGic:INVert <bo ol> :CALCulate:LOGic:INVert?

Description Enable or disable the inverted display of the logic operation result; or query the current status of the inverted display of the logic operation result.

Parameter

Name Type Range Default

<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Return Format The query returns 1 or 0.

:CALCulate:LOGic:VSCale

Syntax

:CALCulate:LOGic:VSCale <sc ale> :CALCulate:LOGic:VSCale?

Description Set or query the vertical scale of the logic operation result.

Parameter

Name Type Range Default

<scale> Real 0.05U to 100U 1U

Return Format The query returns the vertical scale of the logic operation result in scientific notation.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:LOGic:VOFFset

Syntax

:CALCulate:LOGic:VOFFset <of fs > :CALCulate:LOGic:VOFFset?

Description Set or query the vertical offset of the logic operation re sult.

Parameter

Name Type Range Default

<offs> Real (-40 x VScale) to (40 x VScale) 0

Note: For the VScale (the vertical scale of MATH), refer to the :CALCulate:LOGic:VSCale command.

Return Format

The query returns the vertical offset of the logic operation result in scientifc notation.

:CALCulate:LOGic:OPERator

Syntax

:CALCulate:LOGic:OPERator <oper> :CALCulate:LOGic:OPERator?

Description Set or query the operator of logic operation.

Parameter

Name Type Range Default

<oper> Discrete {AND|OR|NOT|XOR} AND

Return Format The query returns AND, OR, NOT, or XOR.

2-74 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-75

:CALCulate:LOGic:ATHReshold :CALCulate:LOGic:BTHReshold

Syntax

:CALCulate:LOGic:ATHReshold <thre> :CALCulate:LOGic:ATHReshold? :CALCulate:LOGic:BTHReshold <thre> :CALCulate:LOGic:BTHReshold?

Description Set or query the threshold of source A in the logic operation. Set or query the threshold of source B in the logic operation.

Parameter

Name Type Range Default

<thre> Real (-4 x VerticalScale - OFFSet) to (4 x VerticalScale - OFFSet) 0

Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the

:CHANnel<n>:OFFSet command.

Explanation

 This command is only available when source A or B is CH1 or CH2.  If the current logic operation type is NOT, you only need to set the threshol d of source A.

Return Format The query returns the threshold of source A or B of logic operation in scientific notation.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:ADVanced

 :CALCulate:ADVanced:EXPRession  :CALCulate:ADVanced:INVert  :CALCulate:ADVanced:VARiable1  :CALCulate:ADVanced:VARiable2  :CALCulate:ADVanced:VSCale  :CALCulate:ADVanced:VOFFset

:CALCulate:ADVanced:EXPRession

Syntax

:CALCulate:ADVanced:EXPRession <expression> :CALCulate:ADVanced:EXPRession?

Description Set or query the expression of advanced operation.

Parameter

Name Type Range Default <expression> ASCII string Refer to Explanation CH1+CH2

Explanation

Input valid expressions using the characters as shown in the figure below.

Note: The length of t he expression should be no greater than 64 bytes.

Return Format

The query returns the current expression in string.

2-76 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-77

:CALCulate:ADVanced:INVert

Syntax

:CALCulate:ADVanced:INVert <bool> :CALCulate:ADVanced:INVert?

Description Enable or disable the inverted display of the advanced operation result; or query the current status of the inverted display of the advanced operation result.

Parameter

Name Type Range Default

<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Return Format The query returns 1 or 0.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALCulate:ADVanced:VARiable1 :CALCulate:ADVanced:VARiable2

Syntax

:CALCulate:ADVanced:VARiable1 <numeric_value> :CALCulate:ADVanced:VARiable1? :CALCulate:ADVanced:VARiable2 <numeric_value> :CALCulate:ADVanced:VARiable2?

Description Set or query the variable1 in the advanced operation expression. Set or query the variable2 in the advanced operation expressi on.

Parameter

Name Type Range Default <numeric_value> Real Refer to Explanation 0

Explanation

 The format of <numeric_value> is AeB. The range of A (mantissa) is from -9.9999 to 9.9999 (the

minimum step is 0.0001; namely the number can contain at most 4 decimal places). B (exponent, its base is 10) is an integer from -9 to 9. For example, 1.2037e5 denot es setting the viariable to

1.2037×10 that in AeB format.

 This command sets the value of variable1 or variab le2 which might be used in

the

:CALCulate:ADVanced:EXPRession command.

Return Format The query returns the value of variable1 or variable2 in the advanced operation expression in scientific notation.

. <numeric_value> can also be expressed in decimal format; its range corresponds to

2-78 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-79

:CALCulate:ADVanced:VSCale

Syntax

:CALCulate:ADVanced:VSCale <numeric_value> :CALCulate:ADVanced:VSCale?

Description Set or query the vertical scale of the advanced operation result. The unit is related to the advanced operation expression.

Parameter

Name Type Range Default

The default range is from 0.02 to 500.

<numeric_value> Real

The actual range is related to the advanced

operation expression.

Note: For the advanced operation expression, refer to the :CALCulate:ADVanced:EXPRession command. The expression might include CH1 or CH2; at this point, the actual range of <numeric_value> ia also related to the channel vertical scale. For the channel vertical scale, refer to the

:CHANnel<n>:SCALe command.

Return Format The query returns the vertical scale of the advanced operation result in scientific notation.

:CALCulate:ADVanced:VOFFset

Syntax

:CALCulate:ADVanced:VOFFset <offs> :CALCulate:ADVanced:VOFFset?

Description Set or query the vertical offset of the advanced operation result. The unit is related to the advanced operation expression.

Parameter

Name Type Range Default

<offs> Real (-40 x VScale) to (40 x VScale) 0

Note: For the VScale (the vertical scale of MATH), refer to the :CALCulate:ADVanced:VSCale command.

Return Format

The query returns the vertical offset of the advanced operation result in scientific notation.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CALibrate Commands

 :CALibrate:DATE?  :CALibrate:STARt  :CALibrate:TIME?  :CALibrate:QUIT

:CALibrate:DATE?

Syntax

:CALibrate:DATE?

Description Query the date of the last calibration.

Return Format The query returns the date in <year>,<month>,<day> format. Wherein, <day> and <month> are double-digit figures, and <year> is a f our-digit figure. For example, 2013,10,27.

:CALibrate:STARt

Syntax

:CALibrate:STARt

Description The oscilloscope starts to execute self-calibration.

Explanation  The self-calibration can make the oscilloscope quickly reach its optimum working state to obtain the

most accurate measurement values.

 The functions of most of the keys are disabled during the self-calibration.

2-80 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-81

:CALibrate:TIME?

Syntax

:CALibrate:TIME?

Description Query the time of the last calibration.

Return Format The query returns the time in <hours>,<minutes>,<seconds> format. Wherein, <hours>, <minutes>, and <seconds> are all double-digit figures. For example, 15,19,25.

:CALibrate:QUIT

Syntax

:CALibrate:QUIT

Description Exit the self-calibration at any time.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CHANnel<n> Commands

 :CHANnel<n>:BWLimit  :CHANnel<n>:COUPling  :CHANnel<n>:DISPlay  :CHANnel<n>:INVert  :CHANnel<n>:IMPedance  :CHANnel<n>:OFFSet  :CHANnel<n>:SCALe  :CHANnel<n>:PROBe  :CHANnel<n>:UNITs  :CHANnel<n>:VERNier  :CHANnel<n>:TCAL

:CHANnel<n>:BWLimit

Syntax

:CHANnel<n>:BWLimit <type> :CHANnel<n>:BWLimit?

Description Set or query bandwidth lim it of the specified analog channel.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<type> Discrete {20M|100M|OFF} OFF

Note: For 100MHz and 70MHz oscilloscopes, the bandwidth limit can only be 20MHz.

Return Format

The query returns 20M, 100M, or OFF.

2-82 MSO2000A/DS2000A Programming Guide

2 Command System RIGOL

2-83

:CHANnel<n>:COUPling

Syntax

:CHANnel<n>:COUPling <coupling> :CHANnel<n>:COUPling?

Description Set or query the coupling mode of the specified analog channel.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<coupling> Discrete {AC|DC|GND} DC

Explanation

 AC: the DC components of the signal under test are blocked.  DC: the DC and AC com ponents of the signal under test can both pass the channel.  GND: the DC and A C components of the signal under tes t are both blocked.

Return Format The query returns AC, DC, or GND.

:CHANnel<n>:DISPlay

Syntax

:CHANnel<n>:DISPlay <bool> :CHANnel<n>:DISPlay?

Description Enable or disable the specified analog channel; or q uery the current status of the specified analog channel.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<bool> Bool {{1|ON}|{0|OFF}} 1|ON

Return Format The query returns 1 or 0.

MSO2000A/DS2000A Programming Guide

RIGOL 2 Command System

:CHANnel<n>:INVert

Syntax

:CHANnel<n>:INVert <bool> :CHANnel<n>:INVert?

Description Enable or disable the inverted display of the speci fied analog channel; or query the current status of the inverted display of the specified analog channel.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<bool> Bool {{1|ON}|{0|OFF}} 0|OFF

Return Format The query returns 1 or 0.

:CHANnel<n>:IMPedance

Syntax

:CHANnel<n>:IMPedance <impedance> :CHANnel<n>:IMPedance?

Description Set or query the input impedance of the specified analo g channel. The default unit is Ω.

Parameter

Name Type Range Default

<n> Discrete {1|2} -<type> Discrete {OMEG|FIFTy} OMEG

Explanation

OMEG: 1MΩ; FIFTy: 50Ω

Return Format The query returns OMEG or FIFT.

2-84 MSO2000A/DS2000A Programming Guide

RIGOL RIGOL DS2102A Programming Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

Guaranty and Declaration

Document Overview

Syntax

Symbol Description

Parameter Type

Command Abbreviation

:AUToscale

:CLEar

:SINGle

:TFORce

:TLHAlf

IEEE 488.2 Common Commands

*CLS

*ESE

*ESR?

*IDN?

*OPC

*RST

*SRE

*STB?

*TST?

:ACQuire Commands

:ACQuire:AVERages

:ACQuire:MDEPth

:ACQuire:SRATe?

:ACQuire:TYPE

:ACQuire:AALias

:BUS<n> Commands

:BUS<n>:MODE

:BUS<n>:DISPlay

:BUS<n>:FORMat

:BUS<n>:EVENt

:BUS<n>:EEXPort

:BUS<n>:DATA?

:BUS<n>:PARallel

:BUS<n>:PARallel:CLK

:BUS<n>:PARallel:SLOPe

:BUS<n>:PARallel:BSET

:BUS<n>:PARallel:THReshold

:BUS<n>:PARallel:OFFSet

:BUS<n>:RS232 (Option)

:BUS<n>:RS232:TX

:BUS<n>:RS232:RX

:BUS<n>:RS232:POLarity

:BUS<n>:RS232:ENDian

:BUS<n>:RS232:BAUD

:BUS<n>:RS232:BUSer

:BUS<n>:RS232:DBITs

:BUS<n>:RS232:SBITs

:BUS<n>:RS232:PARity

:BUS<n>:RS232:PACKet

:BUS<n>:RS232:PEND

:BUS<n>:RS232:TTHReshold

:BUS<n>:RS232:RTHReshold

:BUS<n>:RS232:OFFSet

:BUS<n>:IIC (Option)

:BUS<n>:IIC:SCLK:SOURce

:BUS<n>:IIC:SCLK:THReshold

:BUS<n>:IIC:SDA:SOURce

:BUS<n>:IIC:SDA:THReshold

:BUS<n>:IIC:OFFSet

:BUS<n>:SPI (Option)

:BUS<n>:SPI:SCLK:SOURce

:BUS<n>:SPI:SCLK:SLOPe

:BUS<n>:SPI:SCLK:THReshold

:BUS<n>:SPI:SDA:SOURce

:BUS<n>:SPI:SDA:POLarity

:BUS<n>:SPI:SDA:THReshold

:BUS<n>:SPI:DBITs

:BUS<n>:SPI:ENDian

:BUS<n>:SPI:OFFSet

:BUS<n>:SPI:MODE

:BUS<n>:SPI:TIMeout:TIME

:BUS<n>:SPI:SS:SOURce

:BUS<n>:SPI:SS:POLarity

:BUS<n>:SPI:SS:THReshold