Rigol MSO1104Z-S, MSO1074Z-S, MSO1104Z, MSO1074Z, DS1104Z-S Plus Programming Guide

...
RIGOL
Programming Guide
MSO1000Z/DS1000Z Series
Digital Oscilloscope
Dec. 2015
RIGOL TECHNOLOGIES, INC.

Guaranty and Declaration

Copyright
© 2014 RIGOL TECHNOLOGIES, INC. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL TECHNOLOGIES, INC.
Publication Number
PGA19108-1110
Software Version
00.04.03.SP2 Software upgrade might change or add product features. Please acquire the latest version of the manual from RIGOL website or contact RIGOL to upgrade the software.
Notices
RIGOL products are covered by P.R.C. and foreign patents, issued and pending. RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at
the company’s sole decision.
Information in this publication replaces all previously released materials. Information in this publication is subject to change without notice. RIGOL shall not be liable for either incidental or consequential losses in connection with the furnishing,
use, or performance of this manual, as well as any information contained.
Any part of this document is forbidden to be copied, photocopied, or rearranged without prior written
approval of RIGOL.
Product Certification
RIGOL guarantees that this product conforms to the national and industrial standards in China as well as the ISO9001:2008 standard and the ISO14001: 2004 standard. Other international standard conformance certifications are in progress.
Contact Us
If you have any problem or requirement when using our products or this manual, pleas e contact RIGOL. E-mail: service@rigol.com Website: www.rigol.com
MSO1000Z/DS1000Z Programming Guide I
RIGOL
Tip
RIGOL
Number of Channels
Number of Channels
MSO1104Z-S
100 MHz
4 2 16
MSO1074Z-S
70 MHz
4 2 16
MSO1104Z
100 MHz
4
--
16
MSO1074Z
70 MHz
4
--
16
DS1104Z-S Plus
100 MHz
4 2 16
[1]
DS1074Z-S Plus
70 MHz
4 2 16
[1]
DS1104Z Plus
100 MHz
4
--
16
[1]
DS1074Z Plus
70 MHz
4
--
16
[1]
DS1054Z
50 MHz
4
--
--

Document Overview

This manual provides guidance on how to use the SC PI commands in programming to realize remote control of RIGOL MSO1000Z/DS1000Z series digital oscilloscope through the remote interface. MSO1000Z/DS1000Z can communicate with a PC through the USB or the LAN bus.
Main Topics in this Manual:
Chapter 1 Programming Overview
This chapter introduces how to build the remote communication between MSO1000Z/DS1000Z series digital oscilloscope and the PC. It also introduces the remote control methods as well as the syntax, symbols, parameters and abbreviation rules of the SCPI commands.
Chapter 2 Command System
This chapter introduces the syntax, function, parameter and us ing instruction of each command.
Chapter 3 Programming Demos
This chapter lists some programming demos to illustrate how to use comm ands to realize the common functions of the oscilloscope in the development environments of Excel, Matlab, LabVIEW, Visual Basic 6.0 and Visual C++ 6.0.
For the newest version of this manual, please download it from
official website (www.rigol.com).
Format Conventions in this Manual:
1. Key
The function key at the front panel is denoted by the format of "Key Name (Bold) + Text Box" in the manual. For example, Utility denotes the "Utility" key at the front panel.
2. Menu
The menu item is denoted by the format of "Menu Word (Bold) + Character Shading" in the manual. For example, System denotes the "System" item under Utility.
3. Operation Step
The next step of the operation is denoted by an arrow "" in the manual. For example, Utility System denotes pressing Utility at the front panel and then pressing System.
Content Conventions in this Manual:
MSO1000Z/DS1000Z series includes the following models. Unless otherwise noted, this manual takes MSO1104Z-S as an example to illustrate the command system of MSO1000Z/DS1000Z series.
Model Analog Bandwidth
Analog
Signal Source
Number of Digital Channels
[1]
Note
II MSO1000Z/DS1000Z Programming Guide
: Need to be upgraded to MSO using the MSO upgrade option.
Contents RIGOL
Contents
Guaranty and Declaration ......................................................................................................... I
Document Overview ................................................................................................................. II
Chapter 1 Programming Overview...................................................................................... 1-1
To Build Remote Communication ............................................................................................... 1-2
Remote Control Methods ........................................................................................................... 1-4
SCPI Command Overview .......................................................................................................... 1-5
Syntax ............................................................................................................................... 1-5
Symbol Description ............................................................................................................ 1-5
Parameter Type .................................................................................................................. 1-5
Command Abbreviation ...................................................................................................... 1-6
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-5
:ACQuire:TYPE ................................................................................................................... 2-6
:ACQuire:SRATe? ................................................................................................................ 2-7
:CALibrate Commands ............................................................................................................... 2-8
:CALibrate:QUIT ................................................................................................................ 2-8
:CALibrate:STARt ............................................................................................................... 2-8
:CHANnel<n> Commands ......................................................................................................... 2-9
:CHANnel<n>:BWLimit ....................................................................................................... 2-9
:CHANnel<n>:COUPling ................................................................................................... 2-10
:CHANnel<n>:DISPlay ..................................................................................................... 2-10
:CHANnel<n>:INVert ....................................................................................................... 2-11
:CHANnel<n>:OFFSet ...................................................................................................... 2-11
:CHANnel<n>:RANGe ...................................................................................................... 2-12
:CHANnel<n>:TCAL ......................................................................................................... 2-13
:CHANnel<n>:SCALe ....................................................................................................... 2-14
:CHANnel<n>:PROBe ....................................................................................................... 2-14
:CHANnel<n>:UNITs ........................................................................................................ 2-15
:CHANnel<n>:VERNier ..................................................................................................... 2-15
:CURSor Commands ............................................................................................................... 2-16
:CURSor:MODE ................................................................................................................ 2-16
:CURSor:MANual .............................................................................................................. 2-17
:CURSor:TRACk ............................................................................................................... 2-24
:CURSor:AUTO ................................................................................................................. 2-29
:CURSor:XY ..................................................................................................................... 2-33
:DECoder Commands .............................................................................................................. 2-37
:DECoder<n>:MODE ........................................................................................................ 2-37
:DECoder<n>:DISPlay ..................................................................................................... 2-38
:DECoder<n>:FORMat ..................................................................................................... 2-38
:DECoder<n>:POSition .................................................................................................... 2-39
:DECoder<n>:THREshold:CHANnel1 ................................................................................. 2-40
:DECoder<n>:THREshold:CHANnel2 ................................................................................. 2-40
:DECoder<n>:THREshold:CHANnel3 ................................................................................. 2-40
:DECoder<n>:THREshold:CHANnel4 ................................................................................. 2-40
:DECoder<n>:THREshold:AUTO ....................................................................................... 2-41
:DECoder<n>:CONFig:LABel ............................................................................................. 2-41
MSO1000Z/DS1000Z Programming Guide III
RIGOL Contents
:DECoder<n>:CONFig:LINE .............................................................................................. 2-42
:DECoder<n>:CONFig:FORMat.......................................................................................... 2-42
:DECoder<n>:CONFig:ENDian .......................................................................................... 2-43
:DECoder<n>:CONFig:WIDth ............................................................................................ 2-43
:DECoder<n>:CONFig:SRATe? .......................................................................................... 2-43
:DECoder<n>:UART (Option) ............................................................................................ 2-44
:DECoder<n>:IIC (Option) ............................................................................................... 2-48
:DECoder<n>:SPI (Option) ............................................................................................... 2-50
:DECoder<n>:PARallel ...................................................................................................... 2-56
:DISPlay Commands ................................................................................................................ 2-62
:DISPlay:CLEar ................................................................................................................. 2-62
:DISPlay:DATA? ................................................................................................................ 2-63
:DISPlay:TYPE .................................................................................................................. 2-64
:DISPlay:GRADing:TIME ................................................................................................... 2-65
:DISPlay:WBRightness ...................................................................................................... 2-65
:DISPlay:GRID ................................................................................................................. 2-66
:DISPlay:GBRightness ....................................................................................................... 2-66
:ETABle Commands ................................................................................................................. 2-67
:ETABle<n>:DISP ............................................................................................................. 2-67
:ETABle<n>:FORMat ........................................................................................................ 2-67
:ETABle<n>:VIEW ............................................................................................................ 2-68
:ETABle<n>:COLumn ....................................................................................................... 2-68
:ETABle<n>:ROW ............................................................................................................ 2-69
:ETABle<n>:SORT ............................................................................................................ 2-69
:ETABle<n>:DATA? .......................................................................................................... 2-70
:FUNCtion Commands (Option) ................................................................................................ 2-71
:FUNCtion:WRECord:FEND ................................................................................................ 2-71
:FUNCtion:WRECord:FMAX? .............................................................................................. 2-72
:FUNCtion:WRECord:FINTerval .......................................................................................... 2-72
:FUNCtion:WRECord:PROMpt ............................................................................................ 2-72
:FUNCtion:WRECord:OPERate ........................................................................................... 2-73
:FUNCtion:WRECord:ENABle ............................................................................................. 2-73
:FUNCtion:WREPlay:FSTart ................................................................................................ 2-74
:FUNCtion:WREPlay:FEND ................................................................................................. 2-75
:FUNCtion:WREPlay:FMAX? ............................................................................................... 2-75
:FUNCtion:WREPlay:FINTerval ........................................................................................... 2-76
:FUNCtion:WREPlay:MODE ................................................................................................ 2-76
:FUNCtion:WREPlay:DIRection .......................................................................................... 2-77
:FUNCtion:WREPlay:OPERate ............................................................................................ 2-77
:FUNCtion:WREPlay:FCURrent ........................................................................................... 2-78
IEEE488.2 Common Commands ............................................................................................... 2-79
*CLS ................................................................................................................................ 2-79
*ESE ................................................................................................................................ 2-79
*ESR? .............................................................................................................................. 2-80
*IDN? .............................................................................................................................. 2-80
*OPC ............................................................................................................................... 2-80
*RST ............................................................................................................................... 2-80
*SRE ............................................................................................................................... 2-81
*STB? .............................................................................................................................. 2-81
*TST? .............................................................................................................................. 2-81
*WAI ............................................................................................................................... 2-81
:LA Commands ....................................................................................................................... 2-82
:LA:ACTive ....................................................................................................................... 2-82
:LA:AUTosort .................................................................................................................... 2-83
:LA:DIGital<n>:DISPlay .................................................................................................... 2-83
:LA:DIGital<n>:POSition ................................................................................................... 2-84
:LA:DIGital<n>:LABel ....................................................................................................... 2-84
:LA:DISPlay ...................................................................................................................... 2-85
IV MSO1000Z/DS1000Z Programming Guide
Contents RIGOL
:LA:POD<n>:DISPlay ....................................................................................................... 2-86
:LA:POD<n>:THReshold ................................................................................................... 2-86
:LA:SIZE .......................................................................................................................... 2-87
:LA:STATe ........................................................................................................................ 2-87
:LA:TCALibrate ................................................................................................................. 2-88
:MATH Commands .................................................................................................................. 2-89
:MATH:DISPlay ................................................................................................................ 2-90
:MATH:OPERator .............................................................................................................. 2-90
:MATH:SOURce1 .............................................................................................................. 2-91
:MATH:SOURce2 .............................................................................................................. 2-92
:MATH:LSOUrce1 ............................................................................................................. 2-92
:MATH:LSOUrce2 ............................................................................................................. 2-93
:MATH:SCALe .................................................................................................................. 2-93
:MATH:OFFSet ................................................................................................................. 2-94
:MATH:INVert .................................................................................................................. 2-94
:MATH:RESet ................................................................................................................... 2-95
:MATH:FFT:SOURce.......................................................................................................... 2-95
:MATH:FFT:WINDow ........................................................................................................ 2-95
:MATH:FFT:SPLit .............................................................................................................. 2-96
:MATH:FFT:UNIT .............................................................................................................. 2-96
:MATH:FFT:HSCale ........................................................................................................... 2-97
:MATH:FFT:HCENter ......................................................................................................... 2-98
:MATH:FFT:MODE ............................................................................................................ 2-98
:MATH:FILTer:TYPE .......................................................................................................... 2-99
:MATH:FILTer:W1 ........................................................................................................... 2-100
:MATH:FILTer:W2 ........................................................................................................... 2-101
:MATH:OPTion:STARt ..................................................................................................... 2-101
:MATH:OPTion:END........................................................................................................ 2-102
:MATH:OPTion:INVert .................................................................................................... 2-102
:MATH:OPTion:SENSitivity .............................................................................................. 2-103
:MATH:OPTion:DIStance ................................................................................................ 2-103
:MATH:OPTion:ASCale .................................................................................................... 2-104
:MATH:OPTion:THReshold1 ............................................................................................ 2-104
:MATH:OPTion:THReshold2 ............................................................................................ 2-105
:MATH:OPTion:FX:SOURce1 ........................................................................................... 2-105
:MATH:OPTion:FX:SOURce2 ........................................................................................... 2-106
:MATH:OPTion:FX:OPERator ........................................................................................... 2-106
:MASK Commands ................................................................................................................ 2-107
:MASK:ENABle ............................................................................................................... 2-107
:MASK:SOURce .............................................................................................................. 2-108
:MASK:OPERate ............................................................................................................. 2-108
:MASK:MDISplay ............................................................................................................ 2-109
:MASK:SOOutput ........................................................................................................... 2-109
:MASK:OUTPut............................................................................................................... 2-110
:MASK:X ........................................................................................................................ 2-110
:MASK:Y ........................................................................................................................ 2-110
:MASK:CREate ............................................................................................................... 2-111
:MASK:PASSed? ............................................................................................................. 2-111
:MASK:FAILed? .............................................................................................................. 2-111
:MASK:TOTal? ................................................................................................................ 2-111
:MASK:RESet ................................................................................................................. 2-111
:MEASure Commands ............................................................................................................ 2-112
:MEASure:SOURce ......................................................................................................... 2-116
:MEASure:COUNter:SOURce ........................................................................................... 2-116
:MEASure:COUNter:VALue? ............................................................................................ 2-117
:MEASure:CLEar ............................................................................................................. 2-117
:MEASure:RECover ......................................................................................................... 2-117
:MEASure:ADISplay ........................................................................................................ 2-118
MSO1000Z/DS1000Z Programming Guide V
RIGOL Contents
:MEASure:AMSource ....................................................................................................... 2-118
:MEASure:SETup:MAX ..................................................................................................... 2-119
:MEASure:SETup:MID ..................................................................................................... 2-119
: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:MODE .............................................................................................. 2-123
:MEASure:STATistic:RESet ............................................................................................... 2-123
:MEASure:STATistic:ITEM ................................................................................................ 2-124
:MEASure:ITEM .............................................................................................................. 2-125
:REFerence Commands .......................................................................................................... 2-126
:REFerence:DISPlay ........................................................................................................ 2-126
:REFerence<n>:ENABle .................................................................................................. 2-126
:REFerence<n>:SOURce ................................................................................................. 2-127
:REFerence<n>:VSCale .................................................................................................. 2-127
:REFerence<n>:VOFFset ................................................................................................ 2-128
:REFerence<n>:RESet .................................................................................................... 2-128
:REFerence<n>:CURRent ............................................................................................... 2-128
:REFerence<n>:SAVe ..................................................................................................... 2-129
:REFerence<n>:COLor ................................................................................................... 2-129
[:SOURce[<n>]] Commands ................................................................................................. 2-130
[:SOURce[<n>]]:OUTPut[<n>][:STATe] .......................................................................... 2-131
[:SOURce[<n>]]:OUTPut[<n>]:IMPedance ..................................................................... 2-131
[:SOURce[<n>]]:FREQuency[:FIXed] .............................................................................. 2-132
[:SOURce[<n>]]:PHASe[:ADJust] .................................................................................... 2-132
[:SOURce[<n>]]:PHASe:INITiate .................................................................................... 2-133
[:SOURce[<n>]]:FUNCtion[:SHAPe] ................................................................................ 2-133
[:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry .................................................................... 2-134
[:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] ............................................. 2-134
[:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:OFFSet .................................................... 2-135
[:SOURce[<n>]]:PULSe:DCYCle ...................................................................................... 2-135
[:SOURce[<n>]]:MOD[:STATe] ....................................................................................... 2-136
[:SOURce[<n>]]:MOD:TYPe ........................................................................................... 2-136
[:SOURce[<n>]]:MOD:AM[:DEPTh] ................................................................................. 2-137
[:SOURce[<n>]]:MOD:AM:INTernal:FREQuency ............................................................... 2-137
[:SOURce[<n>]]:MOD:FM:INTernal:FREQuency ............................................................... 2-137
[:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion .................................................................. 2-138
[:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion .................................................................. 2-138
[:SOURce[<n>]]:MOD:FM[:DEVIation] ............................................................................ 2-139
[:SOURce[<n>]]:APPLy? ................................................................................................. 2-139
[:SOURce[<n>]]:APPLy:NOISe ........................................................................................ 2-140
[:SOURce[<n>]]:APPLy:PULSe ........................................................................................ 2-140
[:SOURce[<n>]]:APPLy:RAMP ......................................................................................... 2-140
[:SOURce[<n>]]:APPLy:SINusoid .................................................................................... 2-140
[:SOURce[<n>]]:APPLy:SQUare ...................................................................................... 2-140
[:SOURce[<n>]]:APPLy:USER ......................................................................................... 2-140
:STORage Commands ............................................................................................................ 2-142
:STORage:IMAGe:TYPE ................................................................................................... 2-142
:STORage:IMAGe:INVERT ............................................................................................... 2-142
:STORage:IMAGe:COLor ................................................................................................. 2-143
:SYSTem Commands ............................................................................................................. 2-144
:SYSTem:AUToscale ........................................................................................................ 2-144
:SYSTem:BEEPer ............................................................................................................ 2-145
:SYSTem:ERRor[:NEXT]? ................................................................................................. 2-145
:SYSTem:GAM? .............................................................................................................. 2-145
VI MSO1000Z/DS1000Z Programming Guide
Contents RIGOL
:SYSTem:LANGuage ....................................................................................................... 2-145
:SYSTem:LOCKed ........................................................................................................... 2-146
:SYSTem:PON ................................................................................................................ 2-146
:SYSTem:OPTion:INSTall ................................................................................................ 2-146
:SYSTem:OPTion:UNINSTall ............................................................................................ 2-147
:SYSTem:RAM? .............................................................................................................. 2-147
:SYSTem:SETup ............................................................................................................. 2-147
[:TRACe[<n>]] Commands ................................................................................................... 2-148
[:TRACe[<n>]]:DATA ..................................................................................................... 2-148
[:TRACe[<n>]]:DATA:DAC16 .......................................................................................... 2-149
[:TRACe[<n>]]:DATA:DAC ............................................................................................. 2-150
[:TRACe[<n>]]:DATA:POINts ......................................................................................... 2-151
[:TRACe[<n>]]:DATA:POINts:INTerpolate ....................................................................... 2-151
[:TRACe[<n>]]:DATA:VALue .......................................................................................... 2-152
[:TRACe[<n>]]:DATA:LOAD? .......................................................................................... 2-152
:TIMebase Commands .......................................................................................................... 2-153
:TIMebase:DELay:ENABle ............................................................................................... 2-153
:TIMebase:DELay:OFFSet ............................................................................................... 2-154
:TIMebase:DELay:SCALe ................................................................................................ 2-155
:TIMebase[:MAIN]:OFFSet.............................................................................................. 2-156
:TIMebase[:MAIN]:SCALe ............................................................................................... 2-157
:TIMebase:MODE ........................................................................................................... 2-157
:TRIGger Commands ............................................................................................................ 2-158
:TRIGger:MODE ............................................................................................................. 2-158
:TRIGger:COUPling ........................................................................................................ 2-159
:TRIGger:STATus? .......................................................................................................... 2-159
:TRIGger:SWEep ............................................................................................................ 2-159
:TRIGger:HOLDoff ......................................................................................................... 2-160
:TRIGger:NREJect .......................................................................................................... 2-160
:TRIGger:POSition? ........................................................................................................ 2-161
:TRIGger:EDGe .............................................................................................................. 2-162
:TRIGger:PULSe ............................................................................................................. 2-164
:TRIGger:SLOPe ............................................................................................................. 2-168
:TRIGger:VIDeo ............................................................................................................. 2-173
:TRIGger:PATTern .......................................................................................................... 2-176
:TRIGger:DURATion ....................................................................................................... 2-179
:TRIGger:TIMeout (Option) ............................................................................................ 2-183
:TRIGger:RUNT (Option) ................................................................................................ 2-185
:TRIGger:WINDows (Option) .......................................................................................... 2-189
:TRIGger:DELay (Option) ............................................................................................... 2-192
:TRIGger:SHOLd (Option) ............................................................................................... 2-196
:TRIGger:NEDGe (Option) .............................................................................................. 2-199
:TRIGger:RS232 (Option) ............................................................................................... 2-201
:TRIGger:IIC (Option) .................................................................................................... 2-206
:TRIGger:SPI (Option) .................................................................................................... 2-210
:WAVeform Commands ......................................................................................................... 2-216
:WAVeform:SOURce ....................................................................................................... 2-217
:WAVeform:MODE .......................................................................................................... 2-218
:WAVeform:FORMat ....................................................................................................... 2-218
:WAVeform:DATA?.......................................................................................................... 2-219
:WAVeform:XINCrement? ............................................................................................... 2-222
:WAVeform:XORigin? ...................................................................................................... 2-222
:WAVeform:XREFerence? ................................................................................................ 2-223
:WAVeform:YINCrement? ............................................................................................... 2-223
:WAVeform:YORigin? ...................................................................................................... 2-223
:WAVeform:YREFerence? ................................................................................................ 2-224
:WAVeform:STARt .......................................................................................................... 2-224
:WAVeform:STOP ........................................................................................................... 2-225
MSO1000Z/DS1000Z Programming Guide VII
RIGOL Contents
:WAVeform:PREamble? ................................................................................................... 2-226
Chapter 3 Programming Demos ......................................................................................... 3-1
Programming Preparations ......................................................................................................... 3-2
Excel Programming Demo .......................................................................................................... 3-3
Matlab Programming Demo........................................................................................................ 3-7
LabVIEW Programming Demo .................................................................................................... 3-9
Visual Basic Programming Demo .............................................................................................. 3-13
Visual C++ Programming Demo ............................................................................................... 3-15
VIII MSO1000Z/DS1000Z Programming Guide
Chapter 1 Programming Overview RIGOL

Chapter 1 Programming Overview

This chapter introduces how to build the remote communication between MSO1000Z/DS1000Z series digital oscilloscope and the PC. It also introduces the remote control methods as well as the syntax, symbols, parameters and abbreviation rules of the SCPI commands.
Main topics of this chapter:
To Build Remote Communication Remote Control MethodsSCPI Command Overview
MSO1000Z/DS1000Z Programming Guide 1-1
RIGOL Chapter 1 Programming Overview
1
2

To Build Remote Communication

This oscilloscope can communicate with a PC through the USB or the LAN bus. This section introduces how to control the oscilloscope remotely through the USB interface using Ultra Sigma in details.
Operation Steps:
1. Install the Ultra Sigma common PC software
Download the Ultra Sigma common PC software from RIGOL official website ( install it according to the instructions.
2. Connect the instrument and PC and configure the interface parameters of the instrument
MSO1000Z/DS1000Z can communicate with a PC through the USB or the LAN bus. This manual takes the USB interface as an example.
(1) Connect the devices
Connect the USB Device interface at the real pan el of th e osc illoscope and the USB H ost in terf ace of the PC using a USB ca bl e .
(2) Install the USB driver
This oscilloscope is a USB-TMC device. After you connect the oscilloscope to the PC and turn both on for the first time (the oscilloscope is automatically configured to the USB interface; at the same time, make sure that Utility IO Setting USB Device is set to "Computer"), the Found New Hardware Wizard as shown in the figure below is displayed on the PC. Please install the "USB Test and Measurement D evice (IVI)" driver following the directions in the wizard. The steps are as follows.
www.rigol.com) and
1-2 MSO1000Z/DS1000Z Programming Guide
Chapter 1 Programming Overview RIGOL
3 4 5
6
MSO1000Z/DS1000Z Programming Guide 1-3
RIGOL Chapter 1 Programming Overview
7
(3) Search for device resource
Start up the Ultra Sigma and the software will automatically search for the instrument resources currently connected to the PC. You can also click
(4) View the device res o ur ces
The resources found will appear under the "RIGOL Online Resource" directory and the model number and USB interface information of the instrument will also be displayed. For example, MSO1104Z (USB0::0x1AB1::0x04CE::DS1ZD170800001::INSTR).
(5) Control the instrument remotely
Right click the resource name "MSO1104Z (USB0::0x1AB1::0x04CE::DS1ZD170800001::INSTR)" and select "SCPI Panel Control" to turn on the remote command control panel through which you can send commands and read data.
to search for the resources.

Remote Control Methods

1. User-defined Programming
Users can use SCPI (Standard Commands for Programmable Instruments) commands to program and control the oscilloscope. For details, refer to the introductions in "Chapter 3 Programming Demos".
2. Send SCPI Commands via PC Software
You can control the oscilloscope remotely by sending SCPI commands via PC software. Ultra Sigma provided by RIGOL is recommended
.
1-4 MSO1000Z/DS1000Z Programming Guide
Chapter 1 Programming Overview RIGOL

SCPI Command Overview

SCPI (Standard Comm ands 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 intercha nge (equivalent to ASCII programming)). The SCPI commands provide a hierarchical tree structure and consist of multiple subsystems. Each com mand subsystem consists of a root keyword and one or more sub-keywords.

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; the command keywords and the first parameter are separated by space.
For example, :ACQuire:TYPE <type> :ACQuire:TYPE? ACQuire is the root keyword of the command. TYPE is the second-level keyword. The command string starts with ":" which is also used t o separate the multiple-level keywords. <type> represents the parameters available for setting. "?" represents query. The command keywords :ACQuire:TYPE and parameter <type> are separated by a space.
"," is generally used for separating multiple parameters contained in the same command, for example, [:TRACe[<n>]]:DATA:VALue volatile,<points>,<data>

Symbol Description

The following symbols will not be sent with the commands.
1. Braces {} The parameters enclosed in the braces are optional and are usually separated by the vertical bar "|". When using the command, one of the parameters must be selected.
2. Vertical Bar | The vertical bar is used to separate multiple parameters and one of the parameters must be selected when using 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}}.
MSO1000Z/DS1000Z Programming Guide 1-5
RIGOL Chapter 1 Programming Overview
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 (NR1 format) within the effective 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.
4. Real
The parameter can be any real number within the effective value range and this command accepts
decimal (NR2 format) and scientific notation (NR3 format) parameter input. For example, :TRIGger:TIMeout:TIMe <NR3> :TRIGger:TIMeout:TIMe? Wherein, <NR3> can be set to any real number between 1.6e-08 (namely 16ns) to 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, :SYSTem:OPTion:INSTall <license> Wherein, <license> can be set to PDUY9N9QTS9PQSWPLAETRD3UJHYA.

Command Abbreviation

All the commands are case-insensitive and you can use any of them. If abbreviation is used, all the capital letters in the command must be written completely. For example, :MEASure:ADISplay? can be abbreviated to :MEAS:ADIS?.
1-6 MSO1000Z/DS1000Z Programming Guide
Chapter 2 Command System RIGOL

Chapter 2 Command System

This chapter introduces the syntax, function, parameter, and using instruction of each MSO1000Z/DS1000Z command.
Main topics of this chapter:
:AUToscale :CLEar:RUN:STOP:SINGle:TFORce:ACQuire Commands:CALibrate Commands :CHANnel<n> Commands :CURSor Commands :DECoder Commands:DISPlay Commands :ETABle Commands :FUNCtion Commands (Option) IEEE488.2 Common Commands:LA Commands :MATH Commands :MASK Commands :MEASure Commands :REFerence Commands [:SOURce[<n>]] Commands :STORage Commands :SYSTem Commands [:TRACe[<n>]] Commands :TIMebase Commands :TRIGger Commands :WAVeform Commands
Note:
1. Unless otherwise noted, this manual takes MSO1104Z-S as an example to introduce the commands.
2. Unless otherwise noted, the descriptions and commands related to the digital channels in this manual are only applicable to MSO1000Z and DS1000Z Plus with the MSO upgrade option.
3. For parameter setting commands (for example, the time, frequency, and amplitude), 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 def ault unit of each parameter, please refer to the descr iption in each command in the following introductions.
MSO1000Z/DS1000Z Programming Guide 2-1
RIGOL Chapter 2 Command System
Syntax

:AUToscale

at the front panel.
recorded waveform, this command is invalid.
Syntax

:CLEar

panel.
Command

:STOP

waveform, these commands are invalid.
:AUToscale
Description Enable the waveform auto setting function. The oscilloscope will automatically adjust the
vertical scale, horizontal timebase, and trigger mode according to the input signal to realize optimum waveform display . This command is equivalent to pressing the AUTO key
Explanation Theoretically, wav eform auto setting function requires that the frequency of sine is no
lower than 41Hz; the duty cycle should be greater than 1% and the amplitude must be at least 20mVpp for square (the probe ratio is 1X).
When the pass/fail function is enabled (see the
this command, the oscilloscope will disable the pass/fail function firstly and then execute the waveform auto setting function.
When the waveform record function is enabled or during the playback of the
:MASK:ENABle command), if you sent
:CLEar
Description Clear all the waveforms on the screen. If the oscilloscope is in the RUN state, waveform
will still be displayed. This command is equivalent to pressing the CLEAR key at the front
Related
:DISPlay:CLEar
:RUN :STOP

Syntax :RUN

Description The :RUN command starts the oscilloscope and the :STOP command stops the
oscilloscope. These commands are equivalent to pressing the RUN/STOP key at the front panel.
Explanation When the waveform record function is ena bled or during the playback of the recorded
2-2 MSO1000Z/DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Syntax

:SINGle

the :TRIGger:SWEep SINGle command.
recorded waveform, this command is invalid.
:STOP
Syntax

:TFORce

the FORCE key in the trigger control area at the front panel.
:SINGle
Description Set the oscilloscope to the single trigger mode. This command is equivalent to any of the
following two operations: pressing the SINGLE key at the front panel and sending
Explanation In the single trigger mode, the oscilloscope triggers once when the trigger conditions
are met and then stops.
When the waveform record function is enabled or during the playback of the
Related
Commands
:TFORce :RUN
:TFORce
Description Generate a trigger signal forcefully. This command is only applicable to the normal and
single trigger modes (see the
:TRIGger:SWEep command) and is equivalent to pressing
MSO1000Z/DS1000Z Programming Guide 2-3
RIGOL Chapter 2 Command System
:ACQuire:AVERages?
Description
Set or query the number of averages under the average acquisition mode.
Name
Type
Range
Default
waveform to the waveform changes.
:ACQuire:AVERages? /*The query returns 128*/

:ACQuire Commands

The :ACQuire commands are used to set and qu ery the memory depth, acquisition mode and the number of averages as well as query the current sample rate of the oscilloscope.
Command List
:ACQuire:AVERages:ACQuire:MDEPth:ACQuire:TYPE :ACQuire:SRATe?
[1]
Note
not included and you can refer to the complete introducti ons of the command s in t he text according to the keywords.
: In the "Command List" in this manual, the parameters in the setting commands and the query commands are

:ACQuire:AVERages

Syntax :ACQuire:AVERages <c ount>
[1]
:
Parameter
<count> Integer 2n (n is an integer from 1 to 10) 2
Explanation You can sent 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
The query returns an integer between 2 and 1024.
Format
Example
:ACQuire:AVERages 12 8 /*Set the number of averages to 128*/
2-4 MSO1000Z/DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:ACQuire:MDEPth?
Name
Type
Range
Default
according to the current sample rate.
Format
:ACQuire:MDEPth? /*The query returns 12000*/
Command

:ACQuire:MDEPth

Syntax :ACQuire:MDEPth <mdep>
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
<mdep>
Discrete Refer to Explanation
Explanation For the analog channel:
When a single channel is enabled, the range of <mdep> is {AUTO|12000|
120000|1200000|12000000|24000000}. Wherein, 24000000 (pts) is an optional memory depth.
When dual channels are enabled, the range of <mdep> is {AUTO|6000|60000|
600000|6000000|12000000}. Wherein, 12000000 (pts) is an optional memory depth.
When three/four channels are enabled, the range of <mdep> is {AUTO|3000|
30000|300000|3000000|6000000}. Wherein, 6000000 (pts) is an optional memory depth.
For the digital channel: When 8 channels are enabled, the range of <mdep> is {AUTO|12000|120000|
1200000|1200 0000|24000000} . Wherein, 24000000 (pts) is an optional memory depth.
When 16 chan nels are enabled, the range of <mdep> is {AUTO|6000|60000|
600000|60000 00|12000000} . Wherein, 12000000 (pts) is an optional memory depth.
The following equation des cribes the relationship among memory depth, sample
rate, and waveform length: Memory Depth = Sample Rate x Waveform Length Wherein, the Waveform Length is the product of the horizontal timebase (set by
:TIMebase[:MAIN]:SCALe command) times the number of grids in the horizontal
the direction on the screen (12 for MSO1000Z/DS1000Z). When AUTO is selected, the oscilloscope will select the memory depth automatically
AUTO
Return
Example
Related
The query returns the actual number of points (integer) or AUTO.
:ACQuire:MDEPth 12000 /*Set the memory depth to 12000pts*/
:ACQuire:SRATe?
MSO1000Z/DS1000Z Programming Guide 2-5
RIGOL Chapter 2 Command System
:ACQuire:TYPE?
Description
Set or query the acquisition mode of the oscilloscope.
Name
Type
Range
Default
<type>
Discrete
{NORMal|AVERages|PEAK|HRESolution}
NORMal
storage rate of the acquisition memory.
Format
:ACQuire:TYPE? /*The query returns AVER*/

:ACQuire:TYPE

Syntax :ACQuire:TYPE <type>
Parameter
Explanation
Return
Example
NORMal
: in this mode, the oscilloscope samples the signal at equal time interval to
rebuild the waveform. For most of the waveforms, the best display effect can be obtained using this mode.
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. The number of av er ages can be s et by th e
:ACQuire:AVERages command.
Greater number of av erages can lower the noise and increase the vertical resolution, but will also slow the response of the displayed wa v ef orm to th e wav eform changes.
PEAK (Peak Detect): in this mode, the oscilloscope acquires the maximum and
minimum values of the signal within the sample interval to get the envelope of the signal or the narrow pulse of the signal that might be lost. In this mode, signal confusion can be prevented but the noise displayed would be larger.
HRESolution (High Resolution): this mode uses a kind of ultra-sample technique to
average the neighboring points of the sample waveform to reduce the random noise on the input signal and generate much smoother waveforms on the screen. This is generally used when the sample rate of the digital converter is higher than the
The query returns NORM, AVER, PEAK, or HRES.
:ACQuire:TYPE AVERages /*Select the average acquisition mode*/
2-6 MSO1000Z/DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Syntax

:ACQuire:SRATe?

Description
Query the current sample rate. The default unit is Sa/s.
(12 for MSO1000Z/DS1000Z).
Format
Example
:ACQuire:SRATe? /*The query returns 2.000000e+09*/
:ACQuire:SRATe?
Explanation Sample rate is the sample frequency of the oscilloscope, namel y the wavef orm points
sampled per second.
The foll owing equation describes the relationship among memory depth, sample
rate, and waveform length: Memory Depth = Sample Rate x Waveform Length Wherein, the Memory Depth can be set us ing the the Waveform Length is the product of the horizontal timebase (set by
:TIMebase[:MAIN]:SCALe command) times the number of the horizontal scales
the
:ACQuire:MDEPth command, and
Return
The query returns the sample rate in scientific nota tion.
MSO1000Z/DS1000Z Programming Guide 2-7
RIGOL Chapter 2 Command System
Syntax

:CALibrate:QUIT

Description
Exit the self-calibration at any time.
Command
Syntax

:CALibrate:STARt

send the :CALibrate:QUIT command to quit the self-calibration.

:CALibrate Commands

Command List:
 :CALibrate:QUIT  :CALibrate:STARt
:CALibrate:QUIT
Related
:CALibrate:STARt
:CALibrate:STARt
Description The oscilloscope starts to execute self-calibration.
Explanation The self-calibration operation can make the oscilloscope quickly reach its optimum
working state to obtain the most accurate measurement values.
During the self-calibration, all the channels of the oscilloscope must be disconnected
from the inputs.
The functions of most of the keys are disabled during the self-calibration. You can
2-8 MSO1000Z/DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:CHANnel<n>:BWLimit?
Description
Set or query the bandwidth limit p arameter of the specified channel .
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
--
Discrete
OFF
frequency components .
Format
:CHANnel1:BWLimit? /*The query returns 20M*/

:CHANnel<n> Commands

The :CHANnel<n> commands are used to set or query the vertical system parameters of the analog channels, such as the bandwidth limit, coupling, vertical scale, and vertical offset.
Command List:
:CHANnel<n>:BWLimit:CHANnel<n>:COUPling :CHANnel<n>:DISPlay :CHANnel<n>:INVert:CHANnel<n>:OFFSet :CHANnel<n>:RANGe:CHANnel<n>:TCAL:CHANnel<n>:SCALe:CHANnel<n>:PROBe:CHANnel<n>:UNITs :CHANnel<n>:VERNier

:CHANnel<n>:BWLimit

Syntax :CHANnel<n>:BWLimit <type>
Parameter
<type>
{20M|OFF}
Explanation OFF: disable the bandwidth limit and the high frequency components of the signal
under test can pass the channel. 20M: enable the bandwidth limit and the high frequency components of the signal under test that exceed 20 MHz are attenuated.
Enabling the bandwidth limit can reduce the no ise, but can also attenuate the high
Return
Example
The query returns 20M or OFF.
:CHANnel1:BWLimit 20M /*Enable the 20MHz bandwidth limit*/
MSO1000Z/DS1000Z Programming Guide 2-9
RIGOL Chapter 2 Command System
:CHANnel<n>:COUPling?
Description
Set or query the coupling mode of the specified channel.
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
--
<coupling>
Discrete
{AC|DC|GND}
DC
GND: the DC and AC components of the signal under test a re both blocked.
Format
:CHANnel1:COUPling? /*The query returns AC*/
:CHANnel<n>:DISPlay?
Description
Enable or disable the specified channel or query the status of the specified channel.
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
--
CH2 to CH4: 0|OFF
Format
:CHANnel1:DISPlay? /*The query returns 1*/

:CHANnel<n>:COUPling

Syntax :CHANnel<n>:COUPling <coupling>
Parameter
Explanation AC: the DC components of the signal under test are blocked.
DC: t he DC and AC components of the signal under test can both pass the channel.
Return
Example
The query returns AC, DC, or GND.
:CHANnel1:COUPling AC /*Select the AC coupling mode*/

:CHANnel<n>:DISPlay

Syntax :CHANnel<n>:DISPlay <bool>
Parameter
<bool> Bool {{1|ON}|{0|OFF}}
Return
Example
The query returns 1 or 0.
:CHANnel1:DISPlay ON /*Enable CH1*/
CH1: 1|ON
2-10 MSO1000Z/DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:CHANnel<n>:INVert?
Name
Type
Range
Default
<bool>
Bool
{{1|ON}|{0|OFF}}
0|OFF
invert is turned on, the waveform voltage values are inverted.
Format
:CHANnel1:INVert? /*The query returns 1*/
:CHANnel<n>:OFFSet?
Description
Set or query the vertical offset of the specified channel. The default unit is V.
Name
Type
Range
Default
vertical scale<5V/div: -20V to +20V
Format
:CHANnel1:OFFSet? /*The query returns 1.000000e-02*/

:CHANnel<n>:INVert

Syntax :CHANnel<n>:INVert <bool>
Description Enable or disable the waveform invert of the specified channel or query the sta tus of the
waveform invert of the specified channel.
Parameter
<n> Discrete {1|2|3|4} --
Explanation When waveform invert is turned off, the wave form display is normal; when waveform
Return
Example
The query returns 1 or 0.
:CHANnel1:INVert ON /*Enable the waveform invert of CH1*/

:CHANnel<n>:OFFSet

Syntax :CHANnel<n>:OFFSet <offset>
Parameter
<n> Discrete {1|2|3|4} --
<offset> Real
Related to the current vertical scale and probe ratio When the probe ratio is 1X, vertical scale500mV/div: -100V to +100V vertical scale<500mV/div: -2V to +2V When the probe ratio is 10X, vertical scale≥5V/div: -1000V to +1000V
0V (the probe ratio is 10X)
Return
Example
The query returns the vertical offset in scientific notation.
:CHANnel1:OFFSet 0.01 /*Set the vertical offset of CH1 to 10mV*/
MSO1000Z/DS1000Z Programming Guide 2-11
RIGOL Chapter 2 Command System
:CHANnel<n>:RANGe?
Description
Set or query the vertical range of the specified channel. The default unit is V.
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
--
When the probe ratio is 10X: 80mV to 800V
= Vertical Range/8). The vertical scale can be set by the :CHANnel<n>:SCALe command.
Format
:CHANnel1:RANGe? /*The query returns 8.000000e+00*/

:CHANnel<n>:RANGe

Syntax :CHANnel<n>:RANGe <range>
Parameter
<range> Real
Related to the probe ratio When the probe ratio is 1X: 8mV to 80V
8V (the probe ratio is 10X)
Explanation This command indirectly modifies the vertical scale of the specified channel (Vertical Scale
Return
Example
The query returns the vertical range in scientific notation.
:CHANnel1:RANGe 8 /*Set the vertical range of CH1 to 8V*/
2-12 MSO1000Z/DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:CHANnel<n>:TCAL?
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
--
Horizontal Timebase
Step of the Delay Calibration Time
5ns
100ps
20ns
400ps
50ns
1ns
100ns
2ns
500ns
10ns
1μs to 10μs
20ns
calibration time cannot be adjusted.
Format
:CHANnel1:TCAL? /*The query returns 2.000000e-08*/

:CHANnel<n>:TCAL

Syntax :CHANnel<n>:TCAL <val>
Description Set or query the delay calibration time of the specified channel to calibrate the zer o off set
of the corresponding channel. The default unit is s.
Parameter
<val> Real -100ns to 100ns 0.00s
Explanation <val> can only be set to the specific values in the specified step. If the parameter you
sent is not one of the specific values, the parameter will be set to the nearest specific values automatically. The step varies with the horizontal timebase (set by
:TIMebase[:MAIN]:SCALe command), as shown in the table below.
the
10ns 200ps
Return
Example
200ns 4ns
Note: When the horizontal timebase is equal to or greater than 10μs, the delay
The query returns t he delay calibration time in scientific notation.
:CHANnel1:TCAL 0.00000002 /*Set the delay calibration time to 20ns*/
MSO1000Z/DS1000Z Programming Guide 2-13
RIGOL Chapter 2 Command System
:CHANnel<n>:SCALe?
Description
Set or query the vertical scale of the specified channel. The default unit is V.
Name
Type
Range
Default
100V
of the waveform to view the signal details.
Format
:CHANnel1:SCALe? /*The query retur ns 1.000000e+00*/
:CHANnel<n>:PROBe?
Description
Set or query the probe ratio of the specified channel.
Name
Type
Range
Default
100|200|500|1000}
Setting the probe ratio will affect the range of the vertical scale.
Format
:CHANnel1:PROBe? /*The query returns 1.000000e+01*/

:CHANnel<n>:SCALe

Syntax :CHANnel<n>:SCALe < scale>
Parameter
<n> Discrete {1|2|3|4} --
Related to the current probe ratio
<scale> Real
When the probe ratio is 1X: 1mV to 10V When the probe ratio is 10X (default): 10mV to
Explanation The range of the vertical scale is related to the current probe ratio (set by
:CHANnel<n>:PROBe command).
the
1V (the probe ratio is 10X)
You can use the
adjustment of the vertical scale. By default, the fine adjustment is off. At this point, you can only set the vertical scale in 1-2-5 step, namely 10mV, 20mV, 50mV, 100mV, …, 100V (the probe ratio is 10X). When the fine adjustment is on, you can further adjust the vertical scale within a relatively smaller range to improve the vertical resolution. If the amplitude of the input waveform is a little bit greater than the full scale under the current scale and the amplitude would be a little bit lower if the next scale is used, fine adjustment can be used to improve the display amplitude
Return
Example
The query returns the vertical scale in scientific notation.
:CHANnel1:SCALe 1 /*Set the vertic al scale of CH1 to 1V*/

:CHANnel<n>:PROBe

Syntax :CHANnel<n>:PROBe <atten>
Parameter
<n> Discrete {1|2|3|4} --
:CHANnel<n>:VERNier command to enable or disable the fine
<atten> Discrete
{0.01|0.02|0.05|0.1|0.2|0.5|1|2|5|10|20|50|
Explanation Setting the probe ratio refers to multiply the signal sample d with the specif ied ratio
and then display the result (the actual amplitude of the signal will not be affected).
Return
Example
Related
The query returns the probe ratio in scientific notation.
:CHANnel1:PROBe 10 /*Set the probe ratio of CH1 to 10X*/
:CHANnel<n>:SCALe
Command
2-14 MSO1000Z/DS1000Z Programming Guide
10
Loading...
+ 230 hidden pages