RIGOL RIGOL MSO8204 Programming Guide

Download

RIGOL

Programming Guide

MSO8000 Series Dig ital Oscilloscope

Jul. 2019

RIGOL (SUZHOU) TECHNOLOGIES INC.

RIGOL

Guaranty and Declaration

Trademark Information

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

Publication Number

PGA26103-1110

Software Version

00.00.00.04.00 Software upgrade might change or add product features. Please acquire the latest version of the manual from RIGOL website or contact RIGOL to upgrade the software.

Notices

 RIGOL products are covered by P.R.C. and foreign patents, issued and pending.  RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at

the company’s sole decision.

 Information in this publication replaces all previously relea sed materials.  Information in this publication is subject to change without notice.  RIGOL shall not be liable for either incidental or consequential losses in connection with the furnishing,

use, or performance of this manual, as well as any information contained.

 Any part of this document is forbidden to be copied, photocopied, or rearranged without prior written

approval of RIGOL.

Product Certification

RIGOL guarantees that this product conforms to the national and industrial standards in China as well as the ISO9001:2015 standard a nd the ISO14001:2015 standard. Other international standard conformance certifications are in progress.

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

MSO8000 Programming Guide I

RIGOL

Max.

Bandwidth

No. of

Channels

No. of Function/Arbitrary

Channels

16 (Required to purchase the probe)

Tip

RIGOL

Document Overview

This manual is your guide to programming RIGOL MSO8000 series digital oscilloscope. MSO8000 series can communicate with the PC via the USB, LAN, or GPIB (requiring to work with RIGOL's US B -GPIB interface converter) interface.

Main Topics in this Manual:

Chapter 1 SCPI Command Overview

This chapter introduces the syntax, symbols, paramet ers, and abbreviation rules of the SCPI commands.

Chapter 2 Command System

This chapter introduces the syntax, function, parameters, and descriptions of each command.

Chapter 3 Programming Examples

This chapter illustrates how to control the MSO8000 series digital oscilloscope by programming in Excel, LabVIEW, Visual Basic, and Visual C+ +.

For the latest version of this manual, download it from the official website of

(www.rigol.com).

Format Conventions in this Manual:

1. Key

The key on the front panel is denoted by the format of "Key Name (Bold) + Text Box" in the manual. For example, Utility denotes the "Utility" key.

2. Menu

The menu items are denoted by the format of "Menu Wo rd (Bold) + Char acter Shading". F or example,

System denotes the "System" menu item under Utility.

3. Operation Procedures:

"" denotes the next step of operation. For example, Utility  System denotes that first press Utility, and then press the System softkey.

Content Conventions in this Manual:

MSO8000 series includes the following models. Unless otherw ise specified, this manual takes MSO8104 as an example to illustrate the functions and operation methods of MSO8000 series.

Model

Analog

Waveform Generator

No. of Digital Channels

MSO8064 600 MHz 4 2 (Opt.)

MSO8104 1 GHz 4 2 (Opt.)

MSO8204 2 GHz 4 2 (Opt.)

II MSO8000 Programming Guide

Contents RIGOL

Contents

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

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

Chapter 1 SCPI Command Overview .................................................................................. 1-1

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

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

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

Command Abbreviation ............................................................................................................. 1-2

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

:AUTOscale .............................................................................................................................. 2-2

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

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

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

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

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

:ACQuire Commands ................................................................................................................. 2-4

:ACQuire:AVERages ............................................................................................................ 2-4

:ACQuire:MDEPth ............................................................................................................... 2-4

:ACQuire:TYPE ................................................................................................................... 2-5

:ACQuire:SRATe? ................................................................................................................ 2-6

:ACQuire:LA:SRATe? ........................................................................................................... 2-6

:ACQuire:LA:MDEPth? ........................................................................................................ 2-6

:ACQuire:AALias ................................................................................................................. 2-6

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

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

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

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

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

:BUS<n>:EVENt:FORMat .................................................................................................... 2-9

:BUS<n>:EVENt:VIEW ....................................................................................................... 2-9

:BUS<n>:LABel ................................................................................................................. 2-9

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

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

:BUS<n>:POSition ........................................................................................................... 2-11

:BUS<n>:THReshold ........................................................................................................ 2-11

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

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

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

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

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

:BUS<n>:FLEXray (Option) .............................................................................................. 2-31

:BUS<n>:LIN (Option) ..................................................................................................... 2-33

:BUS<n>:IIS (Opt ion) ...................................................................................................... 2-35

:BUS<n>:M1553 (Option) ................................................................................................ 2-38

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

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

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

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

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

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

:CHANnel<n>:TCALibrate ................................................................................................. 2-41

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

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

:CHANnel<n>:CSTart ....................................................................................................... 2-43

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

MSO8000 Programming Guide III

RIGOL Contents

:CHANnel<n>:PROBe:DELay ............................................................................................. 2-43

:CHANnel<n>:PROBe:BIAS ............................................................................................... 2-44

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

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

:CLOCk Commands ................................................................................................................. 2-46

:CLOCk:METHod ............................................................................................................... 2-46

:CLOCk:TYPE.................................................................................................................... 2-46

:CLOCk:RATE ................................................................................................................... 2-47

:CLOCk:PLL:ORDer ........................................................................................................... 2-47

:CLOCk:PLL:BW ................................................................................................................ 2-47

:CLOCk:EXTChan .............................................................................................................. 2-48

:COUNter Commands .............................................................................................................. 2-49

:COUNter:CURRent? ......................................................................................................... 2-49

:COUNter:ENABle ............................................................................................................. 2-49

:COUNter:SOURce ............................................................................................................ 2-49

:COUNter:MODE ............................................................................................................... 2-50

:COUNter:NDIGits............................................................................................................. 2-50

:COUNter:TOTalize:ENABle ................................................................................................ 2-50

:COUNter:TOTalize:CLEar .................................................................................................. 2-51

:CURSor Commands ................................................................................................................ 2-52

:CURSor:MODE ................................................................................................................ 2-53

:CURSor:MANual .............................................................................................................. 2-54

:CURSor:TRACk ................................................................................................................ 2-60

:CURSor:XY ...................................................................................................................... 2-65

:DISPlay Commands ................................................................................................................ 2-68

:DISPlay:CLEar ................................................................................................................. 2-68

:DISPlay:TYPE .................................................................................................................. 2-68

:DISPlay:GRADing:TIME ................................................................................................... 2-69

:DISPlay:WBRightness ...................................................................................................... 2-69

:DISPlay:GRID ................................................................................................................. 2-69

:DISPlay:GBRightness ....................................................................................................... 2-70

:DISPlay:DATA? ................................................................................................................ 2-70

:DISPlay:RULers ............................................................................................................... 2-70

:DISPlay:COLor ................................................................................................................ 2-71

:DVM Commands .................................................................................................................... 2-72

:DVM:CURRent? ............................................................................................................... 2-72

:DVM:ENABle ................................................................................................................... 2-72

:DVM:SOURce .................................................................................................................. 2-72

:DVM:MODE ..................................................................................................................... 2-73

:EYE Commands ..................................................................................................................... 2-74

:EYE:ENABle .................................................................................................................... 2-74

:EYE:SOURce ................................................................................................................... 2-74

:EYE:MEASure:ENABle ...................................................................................................... 2-75

:EYE:MEASure:ITEM ......................................................................................................... 2-75

:HISTogram Commands ........................................................................................................... 2-76

:HISTogram:DISPlay ......................................................................................................... 2-76

:HISTogram:TYPE ............................................................................................................. 2-76

:HISTogram:SOURce ......................................................................................................... 2-77

:HISTogram:SIZE.............................................................................................................. 2-77

:HISTogram:STATic ........................................................................................................... 2-77

:HISTogram:RESet ............................................................................................................ 2-78

:HISTogram:BLIMit ........................................................................................................... 2-78

:HISTogram:LLIMit ........................................................................................................... 2-78

:HISTogram:RLIMit........................................................................................................... 2-78

:HISTogram:TLIMit ........................................................................................................... 2-79

IEEE488.2 Common Commands ............................................................................................... 2-80

*CLS ................................................................................................................................ 2-80

IV MSO8000 Programming Guide

Contents RIGOL

*ESE ............................................................................................................................... 2-80

*ESR? ............................................................................................................................. 2-80

*IDN? ............................................................................................................................. 2-81

*OPC ............................................................................................................................... 2-81

*SAV ............................................................................................................................... 2-81

*RCL ............................................................................................................................... 2-81

*RST ............................................................................................................................... 2-81

*SRE ............................................................................................................................... 2-82

*STB? ............................................................................................................................. 2-82

*TST? ............................................................................................................................. 2-82

*WAI ............................................................................................................................... 2-82

:JITTer Commands .................................................................................................................. 2-83

:JITTer:ENABle ................................................................................................................. 2-83

:JITTer:SOURce ............................................................................................................... 2-83

:JITTer:HISTogram:APPLy ................................................................................................. 2-84

:JITTer:TRENd:APPLy ....................................................................................................... 2-84

:JITTer:MEASure:TYPE ..................................................................................................... 2-84

:JITTer:MEASure:ITEM ..................................................................................................... 2-85

:JITTer:MEASure:STATistic:ITEM ....................................................................................... 2-85

:JITTer:MEASure:ENABle .................................................................................................. 2-85

:JITTer:SLOPe .................................................................................................................. 2-86

:LA Commands ....................................................................................................................... 2-87

:LA:STATe ........................................................................................................................ 2-87

:LA:ACTive....................................................................................................................... 2-88

:LA:AUTOsort ................................................................................................................... 2-88

:LA:DELete ...................................................................................................................... 2-88

:LA:DIGital:DISPlay .......................................................................................................... 2-89

:LA:DIGital:POSition ......................................................................................................... 2-89

:LA:DIGital:LABel ............................................................................................................. 2-90

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

:LA:DISPlay ..................................................................................................................... 2-90

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

:LA:SIZE .......................................................................................................................... 2-91

:LA:TCALibrate ................................................................................................................. 2-92

:LA:GROup:APPend .......................................................................................................... 2-92

:LAN Commands ..................................................................................................................... 2-93

:LAN:DHCP ...................................................................................................................... 2-93

:LAN:AUToip .................................................................................................................... 2-94

:LAN:GATeway ................................................................................................................. 2-94

:LAN:DNS ........................................................................................................................ 2-94

:LAN:MAC? ...................................................................................................................... 2-95

:LAN:DSErver? ................................................................................................................. 2-95

:LAN:MANual ................................................................................................................... 2-95

:LAN:IPADdress ............................................................................................................... 2-96

:LAN:SMASk .................................................................................................................... 2-96

:LAN:STATus? .................................................................................................................. 2-96

:LAN:VISA? ...................................................................................................................... 2-97

:LAN:MDNS ..................................................................................................................... 2-97

:LAN:HOST:NAME ............................................................................................................ 2-97

:LAN:DESCription ............................................................................................................. 2-97

:LAN:APPLy ...................................................................................................................... 2-98

:MASK Commands .................................................................................................................. 2-99

:MASK:ENABle ................................................................................................................. 2-99

:MASK:SOURce ................................................................................................................ 2-99

:MASK:OPERate ............................................................................................................. 2-100

:MASK:MDISplay ............................................................................................................ 2-100

:MASK:X ........................................................................................................................ 2-101

:MASK:Y ........................................................................................................................ 2-101

MSO8000 Programming Guide V

RIGOL Contents

:MASK:CREate ................................................................................................................ 2-101

:MASK:RESet .................................................................................................................. 2-101

:MATH<n> Commands .......................................................................................................... 2-102

:MATH<n>:DISPlay ........................................................................................................ 2-103

:MATH<n>:OPERator ..................................................................................................... 2-103

:MATH<n>:SOURce1 ...................................................................................................... 2-104

:MATH<n>:SOURce2 ...................................................................................................... 2-104

:MATH<n>:LSOUrce1 ..................................................................................................... 2-104

:MATH<n>:LSOUrce2 ..................................................................................................... 2-105

:MATH<n>:SCALe .......................................................................................................... 2-105

:MATH<n>:OFFSet ......................................................................................................... 2-106

:MATH<n>:INVert .......................................................................................................... 2-106

:MATH<n>:RESet ........................................................................................................... 2-106

:MATH<n>:FFT:SOURce ................................................................................................. 2-107

:MATH<n>:FFT:WINDow ................................................................................................ 2-107

:MATH<n>:FFT:UNIT ..................................................................................................... 2-107

:MATH<n>:FFT:SCALe .................................................................................................... 2-108

:MATH<n>:FFT:OFFSet .................................................................................................. 2-108

:MATH<n>:FFT:HSCale ................................................................................................... 2-108

:MATH<n>:FFT:HCENter ................................................................................................. 2-109

:MATH<n>:FFT:FREQuency:STARt .................................................................................. 2-109

:MATH<n>:FFT:FREQuency:END ..................................................................................... 2-109

:MATH<n>:FFT:SEARch:ENABle ...................................................................................... 2-110

:MATH<n>:FFT:SEARch:NUM .......................................................................................... 2-110

:MATH<n>:FFT:SEARch:THReshold ................................................................................. 2-110

:MATH<n>:FFT:SEARch:EXCursion .................................................................................. 2-111

:MATH<n>:FFT:SEARch:ORDer ....................................................................................... 2-111

:MATH<n>:FILTer:TYPE .................................................................................................. 2-111

:MATH<n>:FILTer:W1 .................................................................................................... 2-112

:MATH<n>:FILTer:W2 .................................................................................................... 2-113

:MATH<n>:SENSitivity .................................................................................................... 2-113

:MATH<n>:DISTance...................................................................................................... 2-113

:MATH<n>:THReshold1 .................................................................................................. 2-114

:MATH<n>:THReshold2 .................................................................................................. 2-114

:MATH<n>:THReshold3 .................................................................................................. 2-115

:MATH<n>:THReshold4 .................................................................................................. 2-115

:MEASure Commands ............................................................................................................ 2-116

:MEASure:SOURce .......................................................................................................... 2-116

:MEASure:COUNter:ENABle ............................................................................................. 2-117

:MEASure:COUNter:SOURce ............................................................................................ 2-117

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

:MEASure:CLEar ............................................................................................................. 2-118

:MEASure:THReshold:SOURce ......................................................................................... 2-118

:MEASure:THReshold:DEFault ......................................................................................... 2-118

:MEASure:MODE ............................................................................................................ 2-118

:MEASure:AMSource ....................................................................................................... 2-119

:MEASure:SETup:MAX ..................................................................................................... 2-119

:MEASure:SETup:MID ..................................................................................................... 2-120

:MEASure:SETup:MIN ..................................................................................................... 2-120

:MEASure:SETup:PSA ...................................................................................................... 2-120

:MEASure:SETup:PSB ...................................................................................................... 2-121

:MEASure:SETup:DSA ..................................................................................................... 2-121

:MEASure:SETup:DSB ..................................................................................................... 2-122

:MEASure:STATistic:DISPlay ............................................................................................ 2-122

:MEASure:STATistic:RESet ............................................................................................... 2-122

:MEASure:STATistic:ITEM ................................................................................................ 2-122

:MEASure:ITEM .............................................................................................................. 2-123

:MEASure:AREA .............................................................................................................. 2-124

VI MSO8000 Programming Guide

Contents RIGOL

:MEASure:CREGion:CAX ................................................................................................. 2-124

:MEASure:CREGion:CBX ................................................................................................. 2-125

:MEASure:CATegory ....................................................................................................... 2-125

:POWer Commands ............................................................................................................... 2-126

:POWer:TYPE ................................................................................................................. 2-126

:POWer:CURRentsource.................................................................................................. 2-126

:POWer:VOLTagesource .................................................................................................. 2-127

:POWer:QUALity:FREQREFerence .................................................................................... 2-127

:POWer:REFLevel:METHod ............................................................................................. 2-127

:POWer:REFLevel:PERCent:HIGH .................................................................................... 2-128

:POWer:REFLevel:PERCent:LOW ..................................................................................... 2-128

:POWer:REFLevel:PERCent:MID ...................................................................................... 2-128

:Quick Command .................................................................................................................. 2-129

:Quick:OPERation ........................................................................................................... 2-129

:RECord Commands .............................................................................................................. 2-130

:RECord:ENABle ............................................................................................................. 2-130

:RECord:STARt ............................................................................................................... 2-130

:RECord:PLAY ................................................................................................................ 2-131

:RECord:CURRent .......................................................................................................... 2-131

:RECord:FRAMes ............................................................................................................ 2-131

:REFerence Commands ......................................................................................................... 2-132

:REFerence:DISPlay ....................................................................................................... 2-132

:REFerence:SOURce ....................................................................................................... 2-132

:REFerence:VSCale ......................................................................................................... 2-133

:REFerence:VOFFset ....................................................................................................... 2-133

:REFerence:RESet .......................................................................................................... 2-134

:REFerence:CURRent ...................................................................................................... 2-134

:REFerence:SAVE ........................................................................................................... 2-134

:REFerence:COLor .......................................................................................................... 2-134

:REFerence:LABel:ENABle ............................................................................................... 2-135

:REFerence:LABel:CONTent ............................................................................................. 2-135

:SAVE and :Load Commands ................................................................................................. 2-136

:SAVE:CSV ..................................................................................................................... 2-136

:SAVE:CSV:LENGth ......................................................................................................... 2-136

:SAVE:FORMat ............................................................................................................... 2-137

:SAVE:IMAGe ................................................................................................................. 2-137

:SAVE:IMAGe:TYPE ........................................................................................................ 2-137

:SAVE:IMAGe:INVert ...................................................................................................... 2-138

:SAVE:IMAGe:COLor ....................................................................................................... 2-138

:SAVE:SETup.................................................................................................................. 2-138

:SAVE:WAVeform ........................................................................................................... 2-139

:SAVE:STATus? .............................................................................................................. 2-139

:LOAD:SETup ................................................................................................................. 2-139

:SEARch Commands ............................................................................................................. 2-140

:SEARch:STATe .............................................................................................................. 2-140

:SEARch:MODE .............................................................................................................. 2-141

:SEARch:EVENt .............................................................................................................. 2-141

:SEARch:EDGE:SLOPe .................................................................................................... 2-141

:SEARch:EDGE:SOURce .................................................................................................. 2-142

:SEARch:PULSe:POLarity ................................................................................................ 2-142

:SEARch:PULSe:QUALifier ............................................................................................... 2-142

:SEARch:PULSe:SOURce ................................................................................................. 2-143

:SEARch:RUNT:POLarity ................................................................................................. 2-143

:SEARch:RUNT:QUALifier ................................................................................................ 2-143

:SEARch:RUNT:SOURce .................................................................................................. 2-144

:SEARch:SLOPe:POLarity ................................................................................................ 2-144

:SEARch:SLOPe:QUALifier ............................................................................................... 2-145

:SEARch:SLOPe:SOURce ................................................................................................. 2-145

MSO8000 Programming Guide VII

RIGOL Contents

[:SOURce[<n>]] Commands ................................................................................................. 2-146

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

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

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

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

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

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

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

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

[:SOURce[<n>]]:MOD:TYPE ........................................................................................... 2-151

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

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

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

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

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

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

[:SOURce[<n>]]:SWEep:TYPE ........................................................................................ 2-154

[:SOURce[<n>]]:SWEep:STIMe ...................................................................................... 2-155

[:SOURce[<n>]]:SWEep:BTIMe ...................................................................................... 2-155

[:SOURce[<n>]]:BURSt:TYPE ......................................................................................... 2-155

[:SOURce[<n>]]:BURSt:CYCLes ...................................................................................... 2-156

[:SOURce[<n>]]:BURSt:DELay........................................................................................ 2-156

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

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

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

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

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

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

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

[:SOURce[<n>]]:OUTPut[<n>][:STATe] .......................................................................... 2-158

[:SOURce[<n>]]:OUTPut[<n>]:IMPedance ..................................................................... 2-159

:SYSTem Commands ............................................................................................................. 2-160

:SYSTem:AOUTput .......................................................................................................... 2-161

:SYSTem:AUTClear ......................................................................................................... 2-161

:SYSTem:AUTOscale ....................................................................................................... 2-161

:SYSTem:BEEPer ............................................................................................................ 2-162

:SYSTem:DATE ............................................................................................................... 2-162

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

:SYSTem:GAMount? ........................................................................................................ 2-162

:SYSTem:RCLock ............................................................................................................ 2-163

:SYSTem:GPIB ................................................................................................................ 2-163

:SYSTem:KEY:PRESs ....................................................................................................... 2-163

:SYSTem:KEY:INCRease .................................................................................................. 2-165

:SYSTem:KEY:DECRease ................................................................................................. 2-165

:SYSTem:LANGuage ........................................................................................................ 2-165

:SYSTem:PON ................................................................................................................ 2-166

:SYSTem:PSTatus ........................................................................................................... 2-166

:SYSTem:OPTion:INSTall ................................................................................................. 2-166

:SYSTem:OPTion:UNINstall ............................................................................................. 2-167

:SYSTem:OPTion:STATus? ............................................................................................... 2-167

:SYSTem:PWDClear ........................................................................................................ 2-168

:SYSTem:RAMount? ........................................................................................................ 2-168

:SYSTem:RESet .............................................................................................................. 2-168

:SYSTem:SETup .............................................................................................................. 2-168

:SYSTem:SSAVEr:TIME ................................................................................................... 2-168

:SYSTem:TIME ............................................................................................................... 2-169

:SYSTem:LOCKed ........................................................................................................... 2-169

:SYSTem:MODules? ........................................................................................................ 2-169

VIII MSO8000 Programming Guide

Contents RIGOL

:TIMebase Commands .......................................................................................................... 2-170

:TIMebase:DELay:ENABle ............................................................................................... 2-170

:TIMebase:DELay:OFFSet ............................................................................................... 2-170

:TIMebase:DELay:SCALe ................................................................................................ 2-171

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

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

:TIMebase:MODE ........................................................................................................... 2-172

:TIMebase:HREFerence:MODE ........................................................................................ 2-172

:TIMebase:HREFerence:POSition ..................................................................................... 2-173

:TIMebase:VERNier ........................................................................................................ 2-173

:TRIGger Commands ............................................................................................................ 2-174

:TRIGger:MODE ............................................................................................................. 2-175

:TRIGger:COUPling ........................................................................................................ 2-175

:TRIGger:STATus? .......................................................................................................... 2-175

:TRIGger:SWEep ............................................................................................................ 2-176

:TRIGger:HOLDoff ......................................................................................................... 2-176

:TRIGger:NREJect .......................................................................................................... 2-177

:TRIGger:EDGE .............................................................................................................. 2-177

:TRIGger:PULSe ............................................................................................................. 2-179

:TRIGger:SLOPe ............................................................................................................. 2-181

:TRIGger:VIDeo ............................................................................................................. 2-184

:TRIGger:PATTern .......................................................................................................... 2-187

:TRIGger:DURation ........................................................................................................ 2-189

:TRIGger:TIMeout .......................................................................................................... 2-192

:TRIGger:RUNT ............................................................................................................. 2-194

:TRIGger:WINDows ....................................................................................................... 2-197

:TRIGger:DELay ............................................................................................................. 2-200

:TRIGger:SHOLd ............................................................................................................ 2-204

:TRIGger:NEDGe ............................................................................................................ 2-208

:TRIGger:RS232 (Option) ............................................................................................... 2-210

:TRIGger:IIC (Option) .................................................................................................... 2-213

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

:TRIGger:SPI (Option) .................................................................................................... 2-220

:TRIGger:FLEXray (Option) ............................................................................................. 2-225

:TRIGger:IIS (Option) .................................................................................................... 2-227

:TRIGger:LIN (Option) ................................................................................................... 2-231

:TRIGger:M15 53 (Option) ............................................................................................... 2-234

:WAVeform Commands ......................................................................................................... 2-236

:WAVeform:SOURce ....................................................................................................... 2-237

:WAVeform:MODE .......................................................................................................... 2-238

:WAVeform:FORMat ....................................................................................................... 2-238

:WAVeform:POINts ......................................................................................................... 2-239

:WAVeform:DATA?.......................................................................................................... 2-239

:WAVeform:XINCrement? ............................................................................................... 2-240

:WAVeform:XORigin? ...................................................................................................... 2-240

:WAVeform:XREFerence? ................................................................................................ 2-240

:WAVeform:YINCrement? ............................................................................................... 2-241

:WAVeform:YORigin? ...................................................................................................... 2-241

:WAVeform:YREFerence? ................................................................................................ 2-241

:WAVeform:STARt .......................................................................................................... 2-242

:WAVeform:STOP ........................................................................................................... 2-242

:WAVeform:PREamble? ................................................................................................... 2-242

Chapter 3 Programming Examples ..................................................................................... 3-1

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

Excel Programming Example...................................................................................................... 3-3

LabVIEW Programming Example ................................................................................................ 3-7

Visual Basic Programming Example .......................................................................................... 3-11

Visual C++ Programming Example ........................................................................................... 3-13

MSO8000 Programming Guide IX

Chapter 1 SCPI Command Overview RIGOL

Chapter 1 SCPI Command Overview

SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming language that is built upon the existing standard IEEE 488.1 and IEEE 488.2 and conforms to various standards, such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character set for information interchange (equivalent to ASCII programming). The SCPI commands provide a hierarchical tree structure, and consist of multiple subsystems. Each command subsystem consists of one root keyword and one or more sub-keywords.

Contents in this cha pter:

 Syntax  Symbol Description  Parameter Type  Command Abbreviation

Syntax

The command line usually starts with a colon; the keywords are separated by colons, and following the keywords are the parameter settings available. The command endi ng with a quotation mark indicates querying a certain function. The keywords of the command and the first parameter is separated by a space.

For example, :ACQuire:TYPE <type> :ACQuire:TYPE?

ACQuire is the root keyword of the command, and TYPE is the second-level keyword. The command line starts with a colon, and different levels of keywords are also separated by colons. <type> indicates a settable parameter. The command ending with a quotation mark indicates querying a certain function. The command keywords ":ACQuire:TYPE" and the parameter <type> are separated by a space.

In some commands with parameters, "," is often used to separate multiple parameters. For example, :SYSTem:DATE <year>,<month>,<day>.

Symbol Description

The following symbols are not sent with the commands.

1. Braces { } The contents enclosed in the braces are parameter options. Parameters are usually separated by the vertical bar "|". When using the command, you must select one of the parameters.

2. Vertical Bar | The vertical bar is used to separate multiple parameters. When using the command, you must select one of the parameters.

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

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

MSO8000 Programming Guide 1-1

RIGOL Chapter 1 SCPI Command Overview

Parameter Type

1. Bool

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

2. Discrete

The parameter can be any of the values listed. For example, :ACQuire:TYPE <type> :ACQuire:TYPE? Wherein, <type> can be set to NORMal, AVERages, or PEAK. The query returns NORM, AVER, or PEAK.

3. Integer

Unless otherwise specified, the parameter can be any integer (NR1 format) within the effective value range. Note: Do not set the parameter to a decimal, otherwise, errors will occur. For example, :DISPlay:GBRig htnes s <bri g htne ss > :DISPlay:GBRightness? Wherein, <brightness> can be set to an integer ranging from 1 to 100. The query returns a n i nteger ranging from 1 to 100.

4. Real

The parameter can be any real number within the effective value range, and this command accepts parameter input in decimal (NR2 format) and scientific notation (NR3 format). For example, :TRIGger:TIMeout:TIME <time> :TRIGger:TIMeout:TIME? Wherein, <time> can be set to any real number ranging from 1.6E-8 (i.g. 16 ns) to 1E+1 (i.g. 10 s). The query returns a real number in scientific notation.

5. ASCII String

The parameter can be the combinations of ASCII characters. For example, :SYSTem:OPTion:INSTall <license> Wherein, <license> can be set to MSO8000-PWR@3AEBC07E6C31F82B78A1C401DC2E3AC2CC9431B57F60D1E1CB712F8682C93609A6 05F8577BFDE920373062BE226289A27C134E2C91BF80CB00F8011AC181FD40.

Command Abbreviation

All the commands are case-insensitive. They can all be in upper case or in lower case. If abbreviation is used, you must input a ll the capital letters in the command. For example, :DISPlay:GBRightness? can be abbreviated as :DISP:GBR?

1-2 MSO8000 Programming Guide

Chapter 2 Command System RIGOL

Chapter 2 Command System

This chapter introduces the syntax, functions, parameters, and usage of each MSO8000 command. For this oscilloscope, only CH1 is enabled by default.

Contents in this chapter:

 :AUToscale  :CLEar  :RUN  :STOP  :SINGle  :TFORce  :ACQuire Commands  :BUS<n> Commands  :CHANnel<n> Commands  :CLOCk Commands  :COUNter Commands  :CURSor Commands  :DISPlay Commands  :DVM Commands  :EYE Commands  :HISTogram Commands  IEEE488.2 Common Commands  :JITTer Commands  :LA Commands  :LAN Commands  :MASK Commands  :MATH<n> Commands  :MEASure Commands  :POWer Commands  :Quick Command  :RECord Commands  :REFerence Commands  :SAVE and :Load Commands  :SEARch Commands  [:SOURce[<n>]] Commands  :SYSTem Commands  :TIMebase Commands  :TRIGger Commands

MSO8000 Programming Guide 2-1

RIGOL Chapter 2 Command System

Syntax

:AUToscale

the front panel.

forced to be disabled.

Syntax

:CLEar

key on the front panel.

:STOP

panel.

is disabled.

 :WAVeform Commands

Note:

1. Unless otherwise specified, the descriptions in this manual all take MSO8104 as an example.

2. For the par ameter setting command (tim e, frequency, amplitude, etc.), the digital osci lloscope can only recognize the numbers, unable to recognize the unit sent together with them. The unit of the parameter is a default o ne. F or the default units of v arious parameters, r efer to the d escriptions f or the specified command.

:AUToscale

Description Enables the wavef orm auto setting function. The oscilloscope will automatically adjust the

vertical scale, horizontal time base, and trigg er mode according to the input signal to realize optimal waveform display . This command functions the same as the AUTO key on

Remarks  When the AUTO function is disabled, this command is invalid. For details, refer

to :SYSTem:AUToscale.

 When the pass/fail test is enabled, the AUTO function runs normally , but the pass/fail

test function is forced to be disabled.

 When the waveform recording function is enabled or the recorded waveforms are

played back, the AUTO function runs normally, but the recording or playing function is

:CLEar

Description

Clears all the wavef or ms on the s creen . This command functions the same as the CLEAR

:RUN :STOP

Syntax :RUN

Description The :RUN command starts the oscilloscope and the :STOP command stops the

oscilloscope. This command functions the sam e as the RUN/STOP key on the front

Remarks

When the waveform r ecording function is enabled, the RUN/STOP key on the front panel

2-2 MSO8000 Programming Guide

Chapter 2 Command System RIGOL

Syntax

:SINGle

the :TRIGger:SWEep SINGle command.

force.

Syntax

:TFORce

the same as the FORCE key in the trigger control area of the front panel.

:SINGle

Description Sets the trigger mode of the oscilloscope to "Single". This command functions the same as

either of the following two operation: press SINGLE on the front panel; or send

Remarks  In the single trigger mode, the oscilloscope performs a single trigger when the trigger

conditions are met and then it stops.

 When the waveform recording function is enabled or the recorded waveforms are

played back, this command is invalid.

 For the single trigger, you can use the

:TFORce command to generate one trigger by

:TFORce

Description Generates a trigger signal forcibly. This command is only applicable to the normal and

single trigger modes (refer to the

:TRIGger:SWEep command). This command functions

MSO8000 Programming Guide 2-3

RIGOL Chapter 2 Command System

:ACQuire:AVERages?

Description

Sets or queries the number of averages in the average acquisition mode.

Name

Type

Range

Default

<count>

Integer

2n (n is an integer, and its range is from 1 to 16)

waveform to the waveform changes.

Format

:ACQuire:AVERages? /*The query returns 128.*/

:ACQuire:MDEPth?

points that can be stored through the sampling in a single trigger). The default unit is pts.

Name

Type

Range

Default

6|1e7|2.5e7|5e7|1e8|1.25e8|2.5e8|5e8}

:ACQuire Commands

The :ACQuire commands are used to set the memory depth of the oscilloscope, the acquisition mode, the average times, as well as query the current sample rate.

Command List

 :ACQuire:AVERages  :ACQuire:MDEPth  :ACQuire:TYPE  :ACQuire:SRATe?  :ACQuire:LA:SRATe?  :ACQuire:AALias

[1]

Note

omitted. You can refer to the complete introductions of the commands in the body of the text based on the keywords listed here.

: In the "Command List" in this manual, the query commands and the parameters in the setting commands are

:ACQuire:AVERages

[1]

Syntax :ACQuire:AVERages <c ount>

Parameter

Remarks  You can send the :ACQuire:TYPE command to set the acquisition mode.

 In the average acquisition mode, greater number of averages can lower the noise

and increase the vertical resolution; but will also slow the response of the displayed

Return

Example

The query returns a n i nteger ranging from 2 to 65536.

:ACQuire:AVERages 128 /*Sets the average times to 128.*/

:ACQuire:MDEPth

Syntax :ACQuire:MDEPth <mdep>

Description Sets or queries the memory depth of the oscilloscope (i.g. the number of waveform

Parameter

<mdep>

{AUTO|1k|10k|100k|1M|10M|25M|50M|100M|1 25M|250M|500M|1000|10000|100000|1000000|

Discrete

10000000|25000000|50000000|100000000|125 000000|250000000|500000000|1e3|1e4|1e5|1e

2-4 MSO8000 Programming Guide

AUTO

Chapter 2 Command System RIGOL

four-channel is 125 M.

Format

:ACQuire:MDEPth? /*The query returns 1.000000E+6.*/

:ACQuire:TYPE?

Description

Sets or queries the acquisition mode of the oscilloscope.

Name

Type

Range

Default

<type>

Discrete

{NORMal|AVERages|PEAK|HRESolution}

NORMal

resolution. Greater nu mber o f a verages can lower the nois e an d in c rease th e vertical

digital converter is greater than the storage rate of the sample storage.

Format

:ACQuire:TYPE? /*The query returns AVER.*/

Remarks  When "AUTO" is selected, the oscilloscope selects the memory depth automatically

according to the current sample rate.

 The maximum memory depth for the single c hannel is 50 0 M; the maxi mum memory

depth for the dual-channel is 250 M; and the maximum memory depth for the

Return

Example

The query returns the memory depth in scientific notation.

:ACQuire:MDEPth 1M /*Sets the memory depth to 1M.*/

:ACQuire:TYPE

Syntax :ACQuire:TYPE <type>

Parameter

Remarks  NORMal: In this mode, the oscilloscope samples the signal at a specified fixed time

interval to rebuild the waveform. For most of the waveforms, using this mode can produce the optimal display effects.

 AVERages: In this mode, the oscilloscope averages the waveforms from multiple

samples to reduce the random noise of the input signal and improve the vertical resolution; while at the same time, it will slow the response of the displayed

waveform to the waveform changes.

 PEAK: indicates the peak detection. In this mode, the oscilloscope samples the

maximum and minimum value of the signal at the fixed sampling interval to acquire the signal envelope or the narrow pulses that might be lost. In this mode, signal aliasing can be prevented, but the noise displayed would be larger.

 HRESolution: the oscillo scope averages the neighbouring points of the sampled

waveform to reduce the random noise on the input signal and display smoother waveform on the screen. This mode is usually used when the sample rate of the

Return

Example

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

:ACQuire:TYPE AVERages /*Sets the acquisition mode to AVERages.*/

MSO8000 Programming Guide 2-5

RIGOL Chapter 2 Command System

Syntax

:ACQuire:SRATe?

Description

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

The formula below des cribes the relations hip among sample rate, memory depth, and

direction. For MSO8000, the number of grids in the hor izontal direction is 10.

Format

Example

:ACQuire:SRATe? /*The query returns 2.500000E+9.*/

Syntax

:ACQuire:LA:SRATe?

Description

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

Format

Example

:ACQuire:LA:SRATe? /*The query returns 1.250000E+9.*/

Syntax

:ACQuire:LA:MDEPth?

Description

Queries the current LA memory depth.

Format

Example

:ACQuire:LA:MDEPth? /*The query returns 1.250000E+4.*/

:ACQuire:AALias?

status of the anti-aliasing function.

Name

Type

Range

Default

<bool>

Bool

{{1|ON}|{0|OFF}}

0|OFF

Format

:ACQuire:AALias? /*The query returns 1.*/

:ACQuire:SRATe?

Remarks  Sample rate indicates the frequency of the signal sampling, i.g. the number of

waveform points sampled per second.



waveform length: memory depth = sample rate x waveform length Wherein, the memory dep th is set by the length is obtained by multiplying the horizontal time base (set by

:TIMebase[:MAIN]:SCALe command) by the number of grids in the horizontal

the

:ACQuire:MDEPth command. The wav eform

Return

The query returns the sample rate in scientific notation.

:ACQuire:LA:SRATe?

Return

The query returns the sample rate in scientific notation.

:ACQuire:LA:MDEPth?

Return

The query returns the memory depth in scientific notation.

:ACQuire:AALias

Syntax :ACQuire:AALias <bool>

Description Enables or disables the anti-aliasing function of the oscilloscope; or queries the on/off

Parameter

Return

Example

2-6 MSO8000 Programming Guide

The query returns 1 or 0.

:ACQuire:AALias ON /*Enables the anti-aliasing function.*/

Chapter 2 Command System RIGOL

:BUS<n>:MODE?

Description

Sets or queries the decoding type of the specified decoding bus.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

FLEXray|M1553}

installed, can the command is available.

Format

:BUS1:MODE? /*The query returns SPI.*/

:BUS<n> Commands

The : BUS<n> commands are used to execute the decoding-related settings and operations.

Command List:

 :BUS<n>:MODE  :BUS<n>:DISPlay  :BUS<n>:FORMat  :BUS<n>:EVENt  :BUS<n>:EVENt:FORMat  :BUS<n>:EVENt:VIEW  :BUS<n>:LABel  :BUS<n>:DATA?  :BUS<n>:EEXPort  :BUS<n>:POSition  :BUS<n>:THReshold  :BUS<n>:PARallel  :BUS<n>:RS232 (Option)  :BUS<n>:IIC (Option)  :BUS<n>:SPI (Option)  :BUS<n>:CAN (Option)  :BUS<n>:FLEXray (Option)  :BUS<n>:LIN (Option)  :BUS<n>:IIS (Option)  :BUS<n>:M1553 (Option)

:BUS<n>:MODE

Syntax :BUS<n>:MODE <mode>

Parameter

<mode> Discrete

{PARallel|RS232|SPI|IIC|IIS|LIN|CAN|

Remarks Except P ARallel, all the other decodings are options. Only when the specified option is

Return

Example

MSO8000 Programming Guide 2-7

The query returns PAR, RS232, SPI, IIC, IIS, LIN , CAN, FLEX, or M1553.

:BUS1:MODE SPI /*Se ts the type of the decod ing bus to SPI.*/

PARallel

RIGOL Chapter 2 Command System

:BUS<n>:DISPlay?

the specified decoding bus.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

<bool>

Bool

{{1|ON}|{0|OFF}}

0|OFF

Format

:BUS1:DISPlay? /*The query returns 1.*/

:BUS<n>:FORMat?

Description

Sets or queries the display format of decoding data of the specified decoding bus.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

<fmt>

Discrete

{HEX|ASCii|DEC|BIN}

ASCii

Remarks

HEX indicates Hexadecimal; DEC indicates Decima l; BIN indicates Binary.

Format

:BUS1:FORMat? /*The query returns HEX.*/

:BUS<n>:EVENt?

status of the specified decoding bus event table.

Name

Type

Range

Default

<bool>

Bool

{{1|ON}|{0|OFF}}

0|OFF

Remarks

Before using the command, enable the specified decoding bus.

Format

:BUS1:EVENt? /*The query returns 1.*/

:BUS<n>:DISPlay

Syntax :BUS<n>:DISPlay <bool>

Description Enables or disables the specified decoding b us; or queries the on/off display status of

Parameter

Return

Example

The query returns 1 or 0.

:BUS1:DISPlay ON /*Enables the decoding bus.*/

:BUS<n>:FORMat

Syntax :BUS<n>:FORMat <fmt>

Parameter

Return

Example

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

:BUS1:FORMat HEX /*Sets the display format of the bus to HEX.*/

:BUS<n>:EVENt

Syntax :BUS<n>:EVENt <bool>

Description Enables or disables the event table of the specified decoding bus; or queries the on/off

Parameter

<n> Discrete {1|2|3|4} ——

Return

Example

2-8 MSO8000 Programming Guide

The query returns 1 or 0.

:BUS1:EVENt ON /*Enables the event table of the specified decoding bus.*/

Chapter 2 Command System RIGOL

:BUS<n>:EVENt:FORMat?

Description

Sets or queries the display format of the specified decoding bus event table.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

Discrete

{HEX|ASCii|DEC|BIN}

ASCii

Remarks

HEX indicates Hexadecimal; DEC indicates Decima l; BIN indicates Binary.

Format

:BUS1:EVENt:FORMat? /*The query returns HEX.*/

:BUS<n>:EVENt:VIEW?

Description

Sets or queries the data page of the specified decoding bus event table.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

Discrete

{PACKets|DETails|PAYLoad}

PACKets

changed accordingly.

Format

:BUS1:EVENt:VIEW? /*The query returns DET.*/

:BUS<n>:LABel?

of the label of the specified decoding bus.

:BUS<n>:EVENt:FORMat

Syntax :BUS<n>:EVENt:FORMat <format>

Parameter

Return

Example

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

:BUS1:EVENt:FORMat HEX /*Sets the display format of the specified decoding bus event table to HEX.*/

:BUS<n>:EVENt:VIEW

Syntax :BUS<n>:EVENt:VIEW <packet>

Parameter

Remarks

 PACKets: displays time, data, and error information in the specified event table.  DETails: displays the detailed data of the specified row in the event table.  PAYLoad: displays all the data of the specified column in the event table.

 When different views are selected, the export format of the data list will be

Return

Example

The query returns PACK, DET, or PAYL.

:BUS1:EVENt:VIEW DETails /*Sets the data page of the decoding bus event table

to DETails.*/

:BUS<n>:LABel

Syntax :BUS<n>:LABel <bool>

Description Enables or disables the label of the specified decoding bus; or queries the on/off status

MSO8000 Programming Guide 2-9

RIGOL Chapter 2 Command System

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

<bool>

Bool

{{1|ON}|{0|OFF}}

0|OFF Remarks

Before using the command, enable the specified decoding bus.

Format

:BUS1:LABel? /*The query returns 1.*/

Syntax

:BUS<n>:DATA?

Description

Reads the data in the decoding event table.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

list.

Syntax

:BUS<n>:EEXPort

Description

Exports the decoding information in the specified decoding bus event table in CSV form.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

with the filename 123.csv.*/

Parameter

Return

Example

The query returns 1 or 0.

:BUS1:LABel ON /*Enables the label of the specified decoding bus.*/

:BUS<n>:DATA?

Parameter

Return

Format

The query returns the data in the decoding event table with the following formats . #9000000072PAL, Time,Data,,

-1us,0,,

-990.3ns,1,,

-503.2ns,0,,

9.2ns,1,,

497.2ns,0, Wherein, "#9000000072" is the TMC data block header, which is followed by the data

in the event table. The 9-digit data following #9 in the data block header indicates the number of bytes of the effective data. "PAL" indicates the decoding type. The available decoding type can also be RS232, I2C, SPI, or CAN. The data are sep arated by commas, and will automatically go to the next l ine according to the line length limit in the decoding list. The data value is related to the numeral system that you have set.

Note: You can save all the data (except TMC data block header and decoding type,

e.g. #9000000072PAL)

as the "*.csv" file and view the data in the form of a

:BUS<n>:EEXPort

Parameter

Example :BUS1:EEXPort C:/123.csv

/*Exports the decoding information in the bus event table to the local Disk C,

2-10 MSO8000 Programming Guide

Chapter 2 Command System RIGOL

:BUS<n>:POSition?

Description

Sets or queries the vertical position of the bus on the screen.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

channel offset

Format

:BUS1:POSition? /*The query returns 200.*/

:BUS<n>:THReshold? <typ e >

Description

Sets or queries the threshold of the specified decoding source.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

(5×VerticalScale–OFFSet)

SI|LIN|CAN|CANSub1}

 For SPI decoding, only when the MOSI source is enabled, can you set the threshold.

Format

:BUS1:THReshold? PAL /*The query returns 2.400000E0.*/

:BUS<n>:POSition

Syntax :BUS<n>:POSition <pos>

Parameter

Related to the

Return

Example

<pos> Integer -167 to +217

The query returns a n i nteger ranging from -1 67 to +217.

:BUS1:POSition 200 /*Se ts the vertical position of the bus to 200.*/

:BUS<n>:THReshold

Syntax :BUS<n>:THReshold <value>,<type>

Parameter

<value> Real

<type> Discrete

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

:CHANnel<n>:OFFSet command.

the

(-5×VerticalScale–OFFSet) to

{PAL|TX|RX|SCL|SDA|CS|CLK|MISO|MO

——

 For RS232 decoding, only when the Rx source is enabled, can you set the threshold.

Return

The query returns the threshold of t he specified decod ing source in scient ific notation.

Example :BUS1:THReshold 2.4,PAL /*Sets the threshold of the PAL decoding source to 2.4 V.*/

MSO8000 Programming Guide 2-11

RIGOL Chapter 2 Command System

:BUS<n>:PARallel:CLK?

Description

Sets or queries the clock source of the Parallel decoding.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

OFF}

Format

D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.

:BUS1:PARallel:CLK? /*The query returns D0.*/

:BUS<n>:PARallel:SLOPe?

decoding on the data channel.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

<slope>

Discrete

{POSitive|NEGative|BOTH}

POSitive

jumps during the de coding.

Format

:BUS<n>:PARallel

The :BUS<n>:PARallel commands are used to set relevant parameters for Parallel decoding.

Command List:

 :BUS<n>:PARallel:CLK  :BUS<n>:PARallel:SLOPe  :BUS<n>:PARallel:WIDTh  :BUS<n>:PARallel:BITX  :BUS<n>:PARallel:SOURce  :BUS<n>:PARallel:POLarity  :BUS<n>:PARallel:NREJect  :BUS<n>:PARallel:NRTime

:BUS<n>:PARallel:CLK

Syntax :BUS<n>:PARallel:CLK <source>

Parameter

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

OFF

Return

<source> Discrete

The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,

Example :BUS1:PARallel:CLK D0 /*Sets the clo ck source of the Parallel decoding to D0.*/

:BUS<n>:PARallel:SLOPe

Syntax :BUS<n>:PARallel:SLOPe <slope>

Description Sets or queries the edge type of the clock channel when being sampled by Parallel

Parameter

Remarks If no clock channel is selected, the instrument will sample when the channel data

Return

2-12 MSO8000 Programming Guide

The query returns POS, NEG, or BOTH.

Chapter 2 Command System RIGOL

:BUS1:PARallel:SLOPe? /*The query returns BOTH.*/

:BUS<n>:PARallel:WIDTh?

Description

Sets or queries the data width of the parallel bus, i.g. the number of bits per frame.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

<wid>

Integer

0 to 20

 Only when the bus source is set to User, can this command be valid.

Format

:BUS1:PARallel:WIDTh? /*The query returns 16.*/

:BUS<n>:PARallel:BITX?

Description

Sets or queries the data bit that the parallel bus requires to set for the channel source.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

<bit>

Integer

0 to (data width - 1)

 The data bit should be smaller than or equal to the data width.

Format

:BUS1:PARallel:BITX? /*The query returns 2.*/

Example :BUS1:PARallel:SLOPe BOTH /*Sets the Parallel decoding to sample on any edge

of the clock channel.*/

:BUS<n>:PARallel:WIDTh

Syntax :BUS<n>:PARallel:WIDTh <wid>

Parameter

Remarks  After you send this command to set the data width of the bus, send

:BUS<n>:PARallel:BITX and :BUS<n>:PARallel:SOURce command to select

the the bit respectively and set the channel source for the bit.

Return

Example

The query returns a n i nteger ranging from 0 to 20.

:BUS1:PARallel:WIDTh 16 /*Sets the data width of Parallel decoding to 16.*/

:BUS<n>:PARallel:BITX

Syntax :BUS<n>:PARallel:BITX <bit>

Parameter

Remarks  The data width is set by the :BUS<n>:PARallel:WIDTh command.

Return

 After selecting the desired bit, send the

set the channel source for the bit.

The query returns the current data bits in integer. Its unit is Hz.

:BUS<n>:PARallel:SOURce command to

Example

:BUS1:PARallel:BITX 2 /*Sets the current bi t to 2.*/

MSO8000 Programming Guide 2-13

RIGOL Chapter 2 Command System

:BUS<n>:PARallel:SOURce?

Description

Sets or queries the channel source of the currently selected data bit.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

CHANnel1|CHANnel2|CHANnel3|CHANnel4}

the desired data bit.

Format

D15, CHAN1, CHAN2, CHAN3, or CHAN4.

:BUS1:PARallel:SOURce? /*The query returns CHAN2.*/

:BUS<n>:PARallel:POLarity?

Description

Sets or queries the data polarity of Parallel decoding.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

<pol>

Discrete

{NEGative|POSitive}

POSitive

 POSitive: indicates the positive polarity.

Format

:BUS1:PARallel:POLarity? /*The query returns NEG.*/

:BUS<n>:PARallel:NREJect?

status of the noise rejection function of Parallel decoding.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

<bool>

Bool

{{1|ON}|{0|OFF}}

0|OFF

:BUS<n>:PARallel:SOURce

Syntax :BUS<n>:PARallel:SOURce <src>

Parameter

<src> Discrete

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

Related to the selected bit

Remarks Before sending this command, send the :BUS<n>:PARallel:BITX command to select

Return

The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,

Example :BUS1:PARallel:SOURce CHANnel2 /*Sets the channel source of the current bi t to

CHANnel2.*/

:BUS<n>:PARallel:POLarity

Syntax :BUS<n>:PARalle l:POLarity <pol>

Parameter

Remarks  NEGative: indicates the nega tive polarity.

Return

Example

The query returns NEG or POS.

:BUS1:PARallel:POLar it y NEGative /*Sets the data polarity of Parallel decoding to

NEGative.*/

:BUS<n>:PARallel:NREJect

Syntax :BUS<n>:PARallel:NREJect <bool>

Description Enables or disables the noise rejection function of Parallel decoding; or queries the

Parameter

2-14 MSO8000 Programming Guide

Chapter 2 Command System RIGOL

command to set the required rejection time.

Format

:BUS1:PARallel:NREJect? /*The query returns 1.*/

:BUS<n>:PARallel:NRTime?

Description

Sets or queries the noise rejection time of Parallel decoding. The default unit is s.

<n>

Discrete

{1|2|3|4}

——

<time>

Real

0 ns to 1 s

0.00 s

Format

:BUS1:PARallel:NRTime? /*The query returns 1.000000E-2.*/

Remarks  Noise rejection can remove the data that last not enough time on the bus and

eliminate the burst glitch in the actual circuit.

 When the noise rejection is enabled, send the

Return

Example

The query returns 1 or 0.

:BUS1:PARallel:NREJect ON /*Enables the noise rejection function.*/

:BUS<n>:PARallel:NRTime

Syntax :BUS<n>:PARallel:NRTime <time>

Parameter

Return

Example

Name Type Range Default

The query returns the noise rejection time in scientific notation.

:BUS1:PARallel:NRTime 0.01 /*Sets the noise rejection time to 10 ms.*/

:BUS<n>:PARallel:NRTime

MSO8000 Programming Guide 2-15

RIGOL Chapter 2 Command System

:BUS<n>:RS232:TX?

Description

Sets or queries the TX channel source of RS232 decoding.

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF}

Format

D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.

:BUS1:RS232:TX? /*The query returns D0.*/

:BUS<n>:RS232:RX?

Description

Sets or queries the RX channel source of RS232 decoding .

Name

Type

Range

Default

<n>

Discrete

{1|2|3|4}

——

CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF}

Return

The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,

:BUS<n>:RS232 (Option)

The :BUS<n>:RS232 commands are used to set relevant parameters for RS232 decoding.

Command List:

 :BUS<n>:RS232:TX  :BUS<n>:RS232:RX  :BUS<n>:RS232:POLarity  :BUS<n>:RS232:ENDian  :BUS<n>:RS232:BAUD  :BUS<n>:RS232:DBITs  :BUS<n>:RS232:SBITs  :BUS<n>:RS232:PARity  :BUS<n>:RS232:PACKet  :BUS<n>:RS232:PEND

:BUS<n>:RS232:TX

Syntax :BUS<n>:RS 232 : TX <so urc e >

Parameter

{D0|D1|D2|D3|D4|D5|D6|D7|D8|

Return

<source> Discrete

The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,

D9|D10|D11|D12|D13|D14|D15|

Example :BUS1:RS232:TX D0 /*Sets the TX channel source of RS232 decoding to D0.*/

:BUS<n>:RS232:RX

Syntax :BUS<n>:RS 232 :RX <so ur ce >

Parameter

OFF

{D0|D1|D2|D3|D4|D5|D6|D7|D8|

<source> Discrete

2-16 MSO8000 Programming Guide

D9|D10|D11|D12|D13|D14|D15|

OFF

+ 244 hidden pages

RIGOL RIGOL MSO8204 Programming Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

Guaranty and Declaration

Document Overview

Chapter 1 SCPI Command Overview

Syntax

Symbol Description

Parameter Type

Command Abbreviation

Chapter 2 Command System

:AUToscale

:CLEar

:STOP

Syntax :RUN

:SINGle

:TFORce

:ACQuire Commands

:ACQuire:AVERages

:ACQuire:MDEPth

:ACQuire:TYPE

:ACQuire:SRATe?

:ACQuire:LA:SRATe?

:ACQuire:LA:MDEPth?

:ACQuire:AALias

:BUS<n> Commands

:BUS<n>:MODE

:BUS<n>:DISPlay

:BUS<n>:FORMat

:BUS<n>:EVENt

:BUS<n>:EVENt:FORMat

:BUS<n>:EVENt:VIEW

:BUS<n>:LABel

:BUS<n>:DATA?

:BUS<n>:EEXPort

:BUS<n>:POSition

:BUS<n>:THReshold

:BUS<n>:PARallel

:BUS<n>:PARallel:CLK

:BUS<n>:PARallel:SLOPe

:BUS<n>:PARallel:WIDTh

:BUS<n>:PARallel:BITX

:BUS<n>:PARallel:SOURce

:BUS<n>:PARallel:POLarity

:BUS<n>:PARallel:NREJect

:BUS<n>:PARallel:NRTime

:BUS<n>:RS232 (Option)

:BUS<n>:RS232:TX

:BUS<n>:RS232:RX