Instructions

ManualsBrandsRigol ManualsLaboratory EquipmentRigol MSO7054 Digital 500 MHz 10 GSa/s 500 Mpts Mixed signal (MSO), Multimeter functions

RIGOL

Programming Guide

MSO7000/DS7000 Series Digital

Oscilloscope

Apr. 2018

RIGOL TECHNOLOGIES, INC.

Summary of content (259 pages)

PAGE 1
RIGOL Programming Guide MSO7000/DS7000 Series Digital Oscilloscope Apr. 2018 RIGOL TECHNOLOGIES, INC.
PAGE 2
PAGE 3
RIGOL Guaranty and Declaration Copyright © 2018 RIGOL TECHNOLOGIES, INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL TECHNOLOGIES, INC. Publication Number PGA22101-1110 Software Version 00.01.01.SP5 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.
PAGE 4
RIGOL Document Overview This manual is your guide to programming RIGOL MSO7000/DS7000 series digital oscilloscope. MSO7000/DS7000 series can communicate with the PC via the USB, LAN, or GPIB (requiring to work with RIGOL's USB-GPIB interface converter) interface. Main Topics in this Manual: Chapter 1 SCPI Command Overview This chapter introduces the syntax, symbols, parameters, and abbreviation rules of the SCPI commands.
PAGE 5
Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 SCPI Command Overview ..................................................................................1-1 Syntax .............................................................................................
PAGE 6
RIGOL Contents :CHANnel:PROBe:DELay .........................................................................................2-43 :CHANnel:PROBe:BIAS ...........................................................................................2-44 :CHANnel:UNITs.....................................................................................................2-44 :CHANnel:VERNier ..................................................................................................
PAGE 7
Contents RIGOL :LA:STATe .................................................................................................................... 2-78 :LA:ACTive................................................................................................................... 2-79 :LA:AUTOsort ............................................................................................................... 2-79 :LA:DELete ...........................................................................................
PAGE 8
RIGOL Contents :MATH:FFT:FREQuency:END .................................................................................. 2-101 :MATH:FFT:SEARch:ENABle ................................................................................... 2-101 :MATH:FFT:SEARch:NUM ...................................................................................... 2-102 :MATH:FFT:SEARch:THReshold ..............................................................................
PAGE 9
Contents RIGOL :REFerence:VSCale ..................................................................................................... 2-124 :REFerence:VOFFset ................................................................................................... 2-124 :REFerence:RESet....................................................................................................... 2-125 :REFerence:CURRent ..................................................................................................
PAGE 10
RIGOL Contents [:SOURce[]]:OUTPut[][:STATe] ....................................................................... 2-147 [:SOURce[]]:OUTPut[]:IMPedance ................................................................... 2-147 :SYSTem Commands ......................................................................................................... 2-148 :SYSTem:AOUTput ......................................................................................................
PAGE 11
Contents RIGOL :TRIGger:SPI (Option) ................................................................................................ 2-208 :TRIGger:FLEXray (Option) .......................................................................................... 2-213 :TRIGger:IIS (Option) ................................................................................................. 2-215 :TRIGger:LIN (Option) ................................................................................................
PAGE 12
PAGE 13
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).
PAGE 14
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 :SYSTem:BEEPer? Wherein, 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 :ACQuire:TYPE? Wherein, can be set to NORMal, AVERages, or PEAK. The query returns NORM, AVER, or PEAK. 3.
PAGE 15
Chapter 2 Command System RIGOL Chapter 2 Command System This chapter introduces the syntax, functions, parameters, and usage of each MSO7000/DS7000 command. Contents in this chapter:  :AUToscale  :CLEar  :RUN  :STOP  :SINGle  :TFORce  :ACQuire Commands  :BUS Commands  :CHANnel Commands  :COUNter Commands  :CURSor Commands  :DISPlay Commands  :DVM Commands  :HISTogram Commands  IEEE488.
PAGE 16
Chapter 2 Command System RIGOL Note: 1. Unless otherwise specified, the descriptions in this manual all take MSO7054 as an example. 2. Unless otherwise specified, the descriptions about the digital channels and the commands in this manual are only available for the MSO7000 series. 3. For the parameter setting command (time, frequency, amplitude, etc.), the digital oscilloscope can only recognize the numbers, unable to recognize the unit sent together with them. The unit of the parameter is a default one.
PAGE 17
Chapter 2 Command System RIGOL :SINGle Syntax Description Remarks :SINGle Sets the trigger mode of the oscilloscope to "Single". This command functions the same as either of the following two operation: press SINGLE on the front panel; or send the :TRIGger:SWEep SINGle command.  In the single trigger mode, the oscilloscope performs a single trigger when the trigger conditions are met and then it stops.
PAGE 18
Chapter 2 Command System RIGOL :ACQuire Commands The :ACQuire commands are used to set the memory depth of the oscilloscope, the acquisition mode, the average times, as well as query the current sample rate. Command List[1]:  :ACQuire:AVERages  :ACQuire:MDEPth  :ACQuire:TYPE  :ACQuire:SRATe?  :ACQuire:LA:SRATe?  :ACQuire:AALias Note[1]: In the "Command List" in this manual, the query commands and the parameters in the setting commands are omitted.
PAGE 19
Chapter 2 Command System Remarks Return Format Example RIGOL  When "AUTO" is selected, the oscilloscope selects the memory depth automatically according to the current sample rate.  The maximum memory depth for the single channel is 500 M; the maximum memory depth for the dual-channel is 250 M; and the maximum memory depth for the four-channel is 125 M.
PAGE 20
Chapter 2 Command System RIGOL length is obtained by multiplying the horizontal time base (set by the :TIMebase[:MAIN]:SCALe command) by the number of grids in the horizontal direction. For MSO7000/DS7000, the number of grids in the horizontal direction is 10. Return Format Example The query returns the sample rate in scientific notation. :ACQuire:SRATe? /*The query returns 2.500000E+9.*/ :ACQuire:LA:SRATe? Syntax Description Return Format Example :ACQuire:LA:SRATe? Queries the current LA sample rate.
PAGE 21
Chapter 2 Command System RIGOL :BUS Commands The : BUS commands are used to execute the decoding-related settings and operations.
PAGE 22
Chapter 2 Command System RIGOL :BUS:DISPlay Syntax :BUS:DISPlay :BUS:DISPlay? Description Parameter Return Format Example Enables or disables the specified decoding bus; or queries the on/off display status of the specified decoding bus. Name Type Range Default Discrete {1|2|3|4} —— Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0. :BUS1:DISPlay ON :BUS1:DISPlay? /*Enables the decoding bus.*/ /*The query returns 1.
PAGE 23
Chapter 2 Command System RIGOL :BUS:EVENt:FORMat Syntax :BUS:EVENt:FORMat :BUS:EVENt:FORMat? Description Parameter Remarks Return Format Example Sets or queries the display format of the specified decoding bus event table. Name Type Range Default Discrete {1|2|3|4} —— Discrete {HEX|ASCii|DEC|BIN} ASCii HEX indicates Hexadecimal; DEC indicates Decimal; BIN indicates Binary. The query returns HEX, ASC, DEC, or BIN.
PAGE 24
Chapter 2 Command System RIGOL Parameter Remarks Return Format Example Name Type Range Default Discrete {1|2|3|4} —— Bool {{1|ON}|{0|OFF}} 0|OFF Before using the command, enable the specified decoding bus. The query returns 1 or 0. :BUS1:EVENt ON :BUS1:EVENt? /*Enables the label of the specified decoding bus.*/ /*The query returns 1.*/ :BUS:DATA? Syntax Description Parameter Return Format :BUS:DATA? Reads the data in the decoding event table.
PAGE 25
Chapter 2 Command System RIGOL :BUS:POSition Syntax :BUS:POSition :BUS:POSition? Description Sets or queries the vertical position of the bus on the screen. Parameter Return Format Example Name Type Range Default Discrete {1|2|3|4} —— Integer -167 to +217 Related to the channel offset The query returns an integer ranging from -167 to +217. :BUS1:POSition 200 :BUS1:POSition? /*Sets the vertical position of the bus to 200.*/ /*The query returns 200.
PAGE 26
Chapter 2 Command System RIGOL :BUS:PARallel The :BUS:PARallel commands are used to set relevant parameters for Parallel decoding.
PAGE 27
Chapter 2 Command System Example RIGOL :BUS1:PARallel:SLOPe BOTH /*Sets the Parallel decoding to sample on any edge of the clock channel.*/ :BUS1:PARallel:SLOPe? /*The query returns BOTH.*/ :BUS:PARallel:WIDTh Syntax :BUS:PARallel:WIDTh :BUS:PARallel:WIDTh? Description Parameter Remarks Return Format Example Sets or queries the data width of the parallel bus, i.g. the number of bits per frame.
PAGE 28
Chapter 2 Command System RIGOL :BUS:PARallel:SOURce Syntax :BUS:PARallel:SOURce :BUS:PARallel:SOURce? Description Parameter Remarks Return Format Example Sets or queries the channel source of the currently selected data bit.
PAGE 29
Chapter 2 Command System Remarks Return Format Example RIGOL  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 :BUS:PARallel:NRTime command to set the required rejection time. The query returns 1 or 0. :BUS1:PARallel:NREJect ON :BUS1:PARallel:NREJect? /*Enables the noise rejection function.*/ /*The query returns 1.
PAGE 30
Chapter 2 Command System RIGOL :BUS:RS232 (Option) The :BUS:RS232 commands are used to set relevant parameters for RS232 decoding.
PAGE 31
Chapter 2 Command System Format Example RIGOL D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF. :BUS1:RS232:RX D0 :BUS1:RS232:RX? /*Sets the RX channel source of RS232 decoding to D0.*/ /*The query returns D0.*/ :BUS:RS232:POLarity Syntax :BUS:RS232:POLarity :BUS:RS232:POLarity? Description Parameter Remarks Sets or queries the polarity of RS232 decoding.
PAGE 32
Chapter 2 Command System RIGOL :BUS:RS232:BAUD Syntax :BUS:RS232:BAUD :BUS:RS232:BAUD? Description Parameter Remarks Return Format Example Sets or queries the baud rate of data transmission in RS232 decoding. Name Type Range Default Discrete {1|2|3|4} —— Integer 1 bps to 20 Mbps 9600 bps If the baud rate is set to a value with "M", then "A" should be added at the end of the value. For example, if you send 5 M, you need to send 5 MA.
PAGE 33
Chapter 2 Command System RIGOL :BUS:RS232:PARity Syntax :BUS:RS232:PARity :BUS:RS232:PARity? Description Parameter Remarks Return Format Example Sets or queries the odd-even check mode of data transmission in RS232 decoding. Name Type Range Default Discrete {1|2|3|4} —— Discrete {NONE|ODD|EVEN} NONE  None: indicates that there is no parity bit in data transmission.  ODD: indicates the odd parity bit.
PAGE 34
Chapter 2 Command System RIGOL :BUS:RS232:PEND Syntax :BUS:RS232:PEND :BUS:RS232:PEND? Description Parameter Remarks Return Format Example 2-20 Sets or queries the packet end type during data transmission. Name Type Range Default Discrete {1|2|3|4} —— Discrete {NULL|LF|CR|SP} NULL The parameters are represented in hexadecimal as follows: NULL: 00 LF: 0A CR: 0D SP: 20 The query returns NULL, LF, CR, or SP.
PAGE 35
Chapter 2 Command System RIGOL :BUS:IIC (Option) The :BUS:IIC commands are used to set relevant parameters for I2C decoding. Command List:  :BUS:IIC:SCLK:SOURce  :BUS:IIC:SDA:SOURce  :BUS:IIC:ADDRess :BUS:IIC:SCLK:SOURce Syntax :BUS:IIC:SCLK:SOURce :BUS:IIC:SCLK:SOURce? Description Parameter Return Format Example Sets or queries the clock source of I2C decoding.
PAGE 36
Chapter 2 Command System RIGOL :BUS:IIC:ADDRess Syntax :BUS:IIC:ADDRess :BUS:IIC:ADDRess? Description Parameter Remarks Return Format Example 2-22 Sets or queries the address mode of I2C decoding. Name Type Range Default Discrete {1|2|3|4} —— Discrete {NORMal|RW} NORMal  NORMal: indicates that the address width does not include the R/W bit.  RW: indicates that the address width includes the R/W bit. The query returns NORM or RW.
PAGE 37
Chapter 2 Command System RIGOL :BUS:SPI (Option) The :BUS:SPI commands are used to set relevant parameters for SPI decoding.
PAGE 38
Chapter 2 Command System RIGOL :BUS:SPI:SCLK:SLOPe Syntax :BUS:SPI:SCLK:SLOPe :BUS:SPI:SCLK:SLOPe? Description Sets or queries the clock edge type of SPI decoding. Parameter Return Format Example Name Type Range Default Discrete {1|2|3|4} —— Discrete {POSitive|NEGative} POSitive The query returns POS or NEG. :BUS1:SPI:SCLK:SLOPe NEGative :BUS1:SPI:SCLK:SLOPe? /*Sets the clock edge type of SPI decoding to NEGative.*/ /*The query returns NEG.
PAGE 39
Chapter 2 Command System RIGOL :BUS:SPI:MOSI:SOURce Syntax :BUS:SPI:MOSI:SOURce :BUS:SPI:MOSI:SOURce? Description Parameter Return Format Example Sets or queries the MOSI data source of SPI decoding.
PAGE 40
Chapter 2 Command System RIGOL :BUS:SPI:ENDian Syntax :BUS:SPI:ENDian :BUS:SPI:ENDian? Description Parameter Remarks Return Format Example Sets or queries the endian of data transmission of SPI decoding. Name Type Range Default Discrete {1|2|3|4} —— Discrete {MSB|LSB} MSB  MSB: indicates Most Significant Bit transmission sequence, i.g. the highest bit of the data is transmitted first.  LSB: indicates Least Significant Bit transmission sequence, i.g.
PAGE 41
Chapter 2 Command System RIGOL :BUS:SPI:TIMeout:TIME Syntax :BUS:SPI:TIMeout:TIME :BUS:SPI:TIMeout:TIME? Description Parameter Remarks Return Format Example Sets or queries the timeout value of SPI decoding. The default unit is s. Name Type Range Default Discrete {1|2|3|4} —— Real 8 ns to 10 s 1 μs  The timeout must be greater than the maximum clock pulse width and less than the idle time between frames.  This setting command is only valid in timeout mode.
PAGE 42
Chapter 2 Command System RIGOL :BUS:SPI:SS:POLarity Syntax :BUS:SPI:SS:POLarity :BUS:SPI:SS:POLarity? Description Parameter Remarks Return Format Example 2-28 Sets or queries the polarity of CS line of SPI decoding. Name Type Range Default Discrete {1|2|3|4} —— Discrete {HIGH|LOW} LOW  HIGH: indicates that the oscilloscope samples data of the source channel of data line on the specified edge of the clock signal when the CS signal is high level.
PAGE 43
Chapter 2 Command System RIGOL :BUS:CAN (Option) The :BUS:CAN commands are used to set relevant parameters for CAN decoding. Command List:  :BUS:CAN:SOURce  :BUS:CAN:STYPe  :BUS:CAN:BAUD  :BUS:CAN:SPOint :BUS:CAN:SOURce Syntax :BUS:CAN:SOURce :BUS:CAN:SOURce? Description Parameter Return Format Example Sets or queries the source channel of CAN decoding.
PAGE 44
Chapter 2 Command System RIGOL :BUS:CAN:BAUD Syntax :BUS:CAN:BAUD :BUS:CAN:BAUD? Description Parameter Remarks Return Format Example Sets or queries the signal rate of CAN decoding. The default unit is bps. Name Type Range Default Discrete {1|2|3|4} —— Integer 10 kbps to 5 Mbps 1 Mbps If the baud rate is set to a value with "M", then "A" should be added at the end of the value. For example, if you send 5 M, you need to send 5 MA.
PAGE 45
Chapter 2 Command System RIGOL :BUS:FLEXray (Option) The :BUS:FLEXray commands are used to set the relevant parameters for FLEXray decoding. Command List:  :BUS:FLEXray:BAUD  :BUS:FLEXray:SOURce  :BUS:FLEXray:SPOint  :BUS:FLEXray:STYPe :BUS:FLEXray:BAUD Syntax :BUS:FLEXray:BAUD :BUS:FLEXray:BAUD? Description Parameter Return Format Example Sets or queries the signal rate of FlexRay decoding. The default unit is bps.
PAGE 46
Chapter 2 Command System RIGOL :BUS:FLEXray:SPOint Syntax :BUS:FLEXray:SPOint :BUS:FLEXray:SPOint? Description Parameter Remarks Return Format Example Sets or queries the sample point position of FlexRay decoding (expressed in %). Name Type Range Default Discrete {1|2|3|4} —— Integer 10 to 90 50 Sample point is a point within a bit’s time. The oscilloscope samples the bit level at this point.
PAGE 47
Chapter 2 Command System RIGOL :BUS:LIN (Option) The :BUS:LIN commands are used to set relevant parameters for LIN decoding. Command List:  :BUS:LIN:BAUD  :BUS:LIN:POLarity  :BUS:LIN:SOURce  :BUS:LIN:STANdard :BUS:LIN:BAUD Syntax :BUS:LIN:BAUD :BUS:LIN:BAUD? Description Parameter Remarks Return Format Example Sets or queries the baud rate of LIN decoding.
PAGE 48
Chapter 2 Command System RIGOL :BUS:LIN:SOURce Syntax :BUS:LIN:SOURce :BUS:LIN:SOURce? Description Parameter Return Format Example Sets or queries the source of LIN bus. Name Type Range Default Discrete {1|2|3|4} —— Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8| D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, CHAN3, or CHAN4.
PAGE 49
Chapter 2 Command System RIGOL :BUS:IIS (Option) The :BUS:IIC commands are used to set relevant parameters for I2S decoding. Command List:  :BUS:IIS:SOURce:CLOCk  :BUS:IIS:SOURce:DATA  :BUS:IIS:SOURce:WSELect  :BUS:IIS:ALIGnment  :BUS:IIS:CLOCk:SLOPe  :BUS:IIS:RWIDth :BUS:IIS:SOURce:CLOCk Syntax :BUS:IIS:SOURce:CLOCk :BUS:IIS:SOURce:CLOCk? Description Parameter Return Format Example Sets or queries the clock source of the I2S decoding.
PAGE 50
Chapter 2 Command System RIGOL :BUS:IIS:SOURce:WSELect Syntax :BUS:IIS:SOURce:WSELect :BUS:IIS:SOURce:WSELect? Description Parameter Return Format Example Sets or queries the audio channel of the I2S trigger.
PAGE 51
Chapter 2 Command System RIGOL :BUS:IIS:RWIDth Syntax :BUS:IIS:RWIDth :BUS:IIS:RWIDth? Description Parameter Return Format Example Sets or queries the word size of the I2S decoding. Name Type Range Default Discrete {1|2|3|4} —— Integer 4 to 32 8 The query returns an integer ranging from 4 to 32. :BUS1:IIS:RWIDth 5 :BUS1:IIS:RWIDth? MSO7000/DS7000 Programming Guide /*Sets the word size of I2S decoding to 5.*/ /*The query returns 5.
PAGE 52
Chapter 2 Command System RIGOL :BUS:M1553 (Option) The :BUS:M1553 commands are used to set relevant parameters for the M1553 decoding. Command List: :BUS:M1553:SOURce  :BUS:M1553:SOURce Syntax :BUS:M1553:SOURce :BUS:M1553:SOURce? Description Parameter Return Format Example 2-38 Sets or queries the source of the M1553 decoding.
PAGE 53
Chapter 2 Command System RIGOL :CHANnel Commands The :CHANnel commands are used to set or query the bandwidth limit, coupling, vertical scale, vertical offset, and other vertical system parameters of the analog channel.
PAGE 54
Chapter 2 Command System RIGOL :CHANnel:COUPling Syntax :CHANnel:COUPling :CHANnel:COUPling? Description Sets or queries the coupling mode of the specified channel. Parameter Remarks Return Format Example Name Type Range Default Discrete {1|2|3|4} —— Discrete {AC|DC} DC  AC: the DC components of the signal under test are blocked.  DC: both DC and AC components of the signal under test can pass through the channel. The query returns AC or DC.
PAGE 55
Chapter 2 Command System Example RIGOL :CHANnel1:INVert ON :CHANnel1:INVert? /*Enables the waveform invert for CH1.*/ /*The query returns 1.*/ :CHANnel:OFFSet Syntax :CHANnel:OFFSet :CHANnel:OFFSet? Description Parameter Sets or queries the vertical offset of the specified channel. The default unit is V.
PAGE 56
Chapter 2 Command System RIGOL :CHANnel:SCALe Syntax :CHANnel:SCALe :CHANnel:SCALe? Description Parameter Sets or queries the vertical scale of the specified channel. The default unit is V.
PAGE 57
Chapter 2 Command System RIGOL :CHANnel:CSTart Syntax Description Parameter Remarks :CHANnel:CSTart Starts calibration for the active probe currently connected to the specified analog channel. Name Type Range Default Discrete {1|2|3|4} —— This command is only valid when an active probe is correctly connected.
PAGE 58
Chapter 2 Command System RIGOL :CHANnel:PROBe:BIAS Syntax :CHANnel:PROBe:BIAS :CHANnel:PROBe:BIAS? Description Parameter Remarks Return Sets or queries the probe bias voltage of the specified channel. Name Type Range Default Discrete {1|2|3|4} —— Real -12 V to 12 V 0V  This function is used to adjust the signal under test that exceeds the input dynamic range of the probe amplifier to an appropriate range to ensure the signal integrity.
PAGE 59
Chapter 2 Command System Return Format Example RIGOL The query returns 1 or 0. :CHANnel1:VERNier ON :CHANnel1:VERNier? MSO7000/DS7000 Programming Guide /*Enables the fine adjustment of the vertical scale of CH1.*/ /*The query returns 1.
PAGE 60
Chapter 2 Command System RIGOL :COUNter Commands Command List:  :COUNter:CURRent?  :COUNter:ENABle  :COUNter:SOURce  :COUNter:MODE  :COUNter:NDIGits  :COUNter:TOTalize:ENABle  :COUNter:TOTalize:CLEar :COUNter:CURRent? Syntax Description Return Format :COUNter:CURRent? Queries the measurement value of the frequency counter. The query returns 1.000006E+3.
PAGE 61
Chapter 2 Command System Example RIGOL :COUNter:SOURce CHANnel2 /*Sets the source of the frequency counter to CH2.*/ :COUNter:SOURce? /*The query returns CHAN2.*/ :COUNter:MODE Syntax :COUNter:MODE :COUNter:MODE? Description Parameter Return Format Example Sets or queries the mode of the frequency counter. Name Type Range Default Discrete {FREQuency|PERiod|TOTalize} FREQuency The query returns FREQ, PER, or TOT.
PAGE 62
Chapter 2 Command System RIGOL Example :COUNter:TOTalize:ENABle ON /*Enables the statistical function of the frequency counter.*/ :COUNter:TOTalize:ENABle? /*The query returns 1.*/ :COUNter:TOTalize:CLEar Syntax :COUNter:TOTalize:CLEar Description Clears the total count. Description Available when "Totalize" is selected under "Measure".
PAGE 63
Chapter 2 Command System RIGOL :CURSor Commands The :CURSor commands are used to measure the X axis values (e.g. Time) and Y axis values (e.g. Voltage) of the waveform on the screen.
PAGE 64
Chapter 2 Command System RIGOL :CURSor:MODE Syntax :CURSor:MODE :CURSor:MODE? Description Parameter Remarks Return Format Example 2-50 Sets or queries the mode of the cursor measurement. Name Type Range Default Discrete {OFF|MANual|TRACk|XY} OFF  OFF: disables the cursor measurement function.  MANual: enables the manual mode of cursor measurement.  TRACk: enables the track cursor mode.  XY: enables the XY cursor measurement mode.
PAGE 65
Chapter 2 Command System RIGOL :CURSor:MANual Command List:  :CURSor:MANual:TYPE  :CURSor:MANual:SOURce  :CURSor:MANual:TUNit  :CURSor:MANual:VUNit  :CURSor:MANual:CAX  :CURSor:MANual:CBX  :CURSor:MANual:CAY  :CURSor:MANual:CBY  :CURSor:MANual:AXValue?  :CURSor:MANual:AYValue?  :CURSor:MANual:BXValue?  :CURSor:TRACk:BYValue?  :CURSor:MANual:XDELta?  :CURSor:MANual:IXDELta?  :CURSor:MANual:YDELta? :CURSor:MANual:TYPE Syntax :CURSor:MANual:TYPE :CURSor:MA
PAGE 66
Chapter 2 Command System RIGOL :CURSor:MANual:SOURce Syntax :CURSor:MANual:SOURce :CURSor:MANual:SOURce? Description Parameter Remarks Return Format Example Sets or queries the channel source of the manual mode of cursor measurement. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4| MATH1|MATH2|MATH3|MATH4|LA|NONE} CHANnel1  Only the currently enabled channel can be selected as the channel source.
PAGE 67
Chapter 2 Command System RIGOL :CURSor:MANual:VUNit Syntax :CURSor:MANual:VUNit :CURSor:MANual:VUNit? Description Parameter Remarks Return Format Example Sets or queries the vertical unit in the manual mode of cursor measurement. Name Type Range Default Discrete {SOURce|PERCent} SOUR  SOURce: in the measurement results, the unit of AY, BY, and △ Y are automatically set to the unit of the current source.
PAGE 68
Chapter 2 Command System RIGOL :CURSor:MANual:CBX Syntax :CURSor:MANual:CBX :CURSor:MANual:CBX? Description Parameter Remarks Return Format Example Sets or queries the horizontal position of Cursor B in the manual mode of cursor measurement. Name Type Range Default Integer 0 to 999 600 The horizontal and vertical position of the cursor is defined by the screen pixel coordinate. The range of the screen pixel coordinate is from (0,0) to (999,479).
PAGE 69
Chapter 2 Command System RIGOL :CURSor:MANual:CBY Syntax :CURSor:MANual:CBY :CURSor:MANual:CBY? Description Parameter Remarks Return Format Example Sets or queries the vertical position of Cursor B in the manual mode of cursor measurement. Name Type Range Default Integer 0 to 479 300  The horizontal and vertical position of the cursor is defined by the screen pixel coordinate. The range of the screen pixel coordinate is from (0,0) to (1000,480).
PAGE 70
Chapter 2 Command System RIGOL :CURSor:MANual:BYValue? Syntax Description Return Format Example :CURSor:MANual:BYValue? Queries the Y value at Cursor B in the manual mode of cursor measurement. The unit is determined by the currently selected vertical unit.  When the channel source is CHANnel1, CHANnel2, CHANnel3, CHANnel4, MATH1, MATH2, MATH3, or MATH4, the query returns the Y value at Cursor B in scientific notation.
PAGE 71
Chapter 2 Command System RIGOL :CURSor:TRACk Command List:  :CURSor:TRACk:SOURce1  :CURSor:TRACk:SOURce2  :CURSor:TRACk:CAX  :CURSor:TRACk:CBX  :CURSor:TRACk:CAY?  :CURSor:TRACk:CBY?  :CURSor:TRACk:AXValue?  :CURSor:TRACk:AYValue?  :CURSor:TRACk:BXValue?  :CURSor:TRACk:BYValue?  :CURSor:TRACk:XDELta?  :CURSor:TRACk:YDELta?  :CURSor:TRACk:IXDELTA? :CURSor:TRACk:SOURce1 Syntax :CURSor:TRACk:SOURce1 :CURSor:TRACk:SOURce1? Description Parameter Remarks Return
PAGE 72
Chapter 2 Command System RIGOL :CURSor:TRACk:SOURce2 Syntax :CURSor:TRACk:SOURce2 :CURSor:TRACk:SOURce2? Description Parameter Remarks Return Format Example Sets or queries the channel source of Cursor B in the track mode of cursor measurement. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4| MATH1|MATH2|MATH3|MATH4|NONE} CHANnel1 Only the currently enabled channel can be selected as the channel source.
PAGE 73
Chapter 2 Command System RIGOL :CURSor:TRACk:CBX Syntax :CURSor:TRACk:CBX :CURSor:TRACk:CBX? Description Parameter Remarks Return Format Example Sets or queries the horizontal position of Cursor B in the track mode of cursor measurement. Name Type Range Default Integer 0 to 999 600 The horizontal and vertical position of the cursor is defined by the screen pixel coordinate. The range of the screen pixel coordinate is from (0,0) to (999,479).
PAGE 74
Chapter 2 Command System RIGOL :CURSor:TRACk:AXValue? Syntax Description Return Format :CURSor:TRACk:AXValue? Queries the X value at Cursor A in the track mode of cursor measurement. The unit is determined by the amplitude unit selected for the currently corresponding channel. The query returns the X value at Cursor A in scientific notation. :CURSor:TRACk:AYValue? Syntax Description Return Format :CURSor:TRACk:AYValue? Queries the Y value at Cursor A in the track mode of cursor measurement.
PAGE 75
Chapter 2 Command System RIGOL :CURSor:TRACk:IXDELTA? Syntax Description Return Format :CURSor:TRACk:IXDELTA? Queries the reciprocal (1/△ X) of the absolute difference between the X value at Cursor A and the X value at Cursor B in the track mode of cursor measurement. The default unit is Hz. The query returns 1/△ X in scientific notation.
PAGE 76
Chapter 2 Command System RIGOL :CURSor:XY The :CURSor:XY command is only available when the horizontal time base mode is set to XY.
PAGE 77
Chapter 2 Command System RIGOL :CURSor:XY:BX Syntax :CURSor:XY:BX :CURSor:XY:BX? Description Parameter Remarks Return Format Example Sets or queries the horizontal position of Cursor B in the XY cursor measurement mode. Name Type Range Default Integer 0 to 479 300 In the XY time base mode, the horizontal and vertical position of the cursor is defined by the pixel coordinate in the XY display region. The range of the screen pixel coordinate is from (0,0) to (479,479).
PAGE 78
Chapter 2 Command System RIGOL :CURSor:XY:BY Syntax :CURSor:XY:BY :CURSor:XY:BY? Description Parameter Remarks Return Format Example Sets or queries the vertical position of Cursor B in the XY cursor measurement mode. Name Type Range Default Integer 0 to 479 300 In the XY time base mode, the horizontal and vertical position of the cursor is defined by the pixel coordinate in the XY display region. The range of the screen pixel coordinate is from (0,0) to (479,479).
PAGE 79
Chapter 2 Command System RIGOL :DISPlay Commands The :DISPlay commands can be used to set the displayed type of the waveform, persistence time, intensity, grid type, grid brightness, etc. Command List:  :DISPlay:CLEar  :DISPlay:TYPE  :DISPlay:GRADing:TIME  :DISPlay:WBRightness  :DISPlay:GRID  :DISPlay:GBRightness  :DISPlay:DATA?  :DISPlay:RULers  :DISPlay:COLor :DISPlay:CLEar Syntax Description Remarks :DISPlay:CLEar Clears all the waveforms on the screen.
PAGE 80
Chapter 2 Command System RIGOL :DISPlay:GRADing:TIME Syntax :DISPlay:GRADing:TIME :DISPlay:GRADing:TIME? Description Parameter Remarks Return Format Example Sets or queries the persistence time. The default unit is s. Name Type Range Default Discrete {MIN|0.1|0.2|0.5|1|2|5|10|INFinite} MIN  MIN: sets the persistence time to its minimum value to view how the waveform changes at a high refresh rate.  specified value (e.g. 0.1, 0.2, 0.
PAGE 81
Chapter 2 Command System RIGOL is 140 mV. Return Format Example The query returns FULL, HALF, NONE, or IRE. :DISPlay:GRID NONE :DISPlay:GRID? /*Turns off the background grid and coordinates.*/ /*The query returns NONE.*/ :DISPlay:GBRightness Syntax :DISPlay:GBRightness :DISPlay:GBRightness? Description Parameter Return Format Example Sets or queries the brightness of the screen grid, expressed in percentage.
PAGE 82
Chapter 2 Command System RIGOL :DISPlay:COLor Syntax :DISPlay:COLor :DISPlay:COLor? Description Parameter Return Format Example 2-68 Enables or disables the color grade display; or queries the on/off status of the color grade display. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0. :DISPlay:COLor ON :DISPlay:COLor? /*Enables the color grade display.*/ /*The query returns 1.
PAGE 83
Chapter 2 Command System RIGOL :DVM Commands Command List:  :DVM:CURRent?  :DVM:ENABle  :DVM:SOURce  :DVM:MODE :DVM:CURRent? Syntax Description DVM:CURRent? Queries the current voltage value under test. :DVM:ENABle Syntax :DVM:ENABle :DVM:ENABle? Description Parameter Return Format Example Enables or disables the digital voltmeter; or queries the on/off status of the digital voltmeter. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0.
PAGE 84
Chapter 2 Command System RIGOL :DVM:MODE Syntax :DVM:MODE :DVM:MODE? Description Parameter Description Return Format Example 2-70 Sets or queries the mode of the digital voltmeter. Name Type Range Default Discrete {ACRMs|DC|DCRMs} ACRMs  ACRMs: displays the root-mean-square value of the acquired data, with the DC component removed.  DC: displays the average value of the acquired data.  DCRMs: displays the root-mean-square value of the acquired data.
PAGE 85
Chapter 2 Command System RIGOL :HISTogram Commands Command List:  :HISTogram:DISPlay  :HISTogram:TYPE  :HISTogram:SOURce  :HISTogram:SIZE  :HISTogram:STATic  :HISTogram:RESet  :HISTogram:BLIMit  :HISTogram:LLIMit  :HISTogram:RLIMit  :HISTogram:TLIMit :HISTogram:DISPlay Syntax :HISTogram:DISPlay :HISTogram:DISPlay? Description Parameter Return Format Example Enables or disables the histogram function; or queries the status of the histogram.
PAGE 86
Chapter 2 Command System RIGOL :HISTogram:SOURce Syntax :HISTogram:SOURce :HISTogram:SOURce? Description Parameter Return Format Example Sets or queries the source of the histogram. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHA Nnel4|MATH1|MATH2|MATH3|MATH4| OFF} OFF The query returns CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, MATH4, or OFF. :HISTogram:SOURce CHANnel2 /*Sets the source of the histogram to CH2.
PAGE 87
Chapter 2 Command System RIGOL :HISTogram:BLIMit Syntax :HISTogram:BLIMit :HISTogram:BLIMit? Description Parameter Sets or queries the histogram's bottom boundary limit. Name Return Format Example Type Range Default Real -4× VerticalScale to 4× VerticalScale (vertical scale of the channel source of the histogram) 0V The query returns the histogram's bottom boundary limit in scientific notation.
PAGE 88
Chapter 2 Command System RIGOL :HISTogram:TLIMit Syntax :HISTogram:TLIMit :HISTogram:TLIMit? Description Parameter Sets or queries the histogram's top boundary limit. Name Return Format Example 2-74 Type Range Default Real (-4× VerticalScale) to (4× VerticalScale) (vertical scale of the channel source of the histogram) 0V The query returns the histogram's top boundary limit in scientific notation.
PAGE 89
Chapter 2 Command System RIGOL IEEE488.2 Common Commands The IEEE488.2 common commands are used to query the basic information of the instrument or executing basic operations. These commands usually start with "*", and the keywords in a command contain 3 characters. Command List:  *CLS  *ESE  *ESR?  *IDN?  *OPC  *SAV  *RCL  *RST  *SRE  *STB?  *TST?  *WAI *CLS Syntax Description *CLS Clears all the event registers, and also clears the error queue.
PAGE 90
Chapter 2 Command System RIGOL as 0; therefore, the range of the returned value is a decimal number corresponding to a binary number X0XXXX0X (X is 1 or 0). Return Format The query returns an integer. The integer equals to the binary-weighted sum of all the bits set in the register. *IDN? Syntax Description Return Format *IDN? Queries the instrument information. The query returns RIGOL TECHNOLOGIES,,,.
PAGE 91
Chapter 2 Command System RIGOL *SRE Syntax *SRE *SRE? Description Parameter Sets or queries the enable register of the status byte register set. Name Type Range Default Integer 0 to 255 0 Remarks This command queries the standard event enable register value. Bit 3 and Bit 6 in the standard event status register are not used and are always treated as 0. Therefore, the range of is a decimal that corresponds to a binary number X0XXXX0X (X is 1 or 0).
PAGE 92
Chapter 2 Command System RIGOL :LA Commands The :LA commands are used to perform relevant operations on the digital channels. The commands are only available for the MSO7000 series.
PAGE 93
Chapter 2 Command System RIGOL :LA:ACTive Syntax :LA:ACTive {|NONE} :LA:ACTive? Description Sets or queries the current active channel or channel group. Parameter Remarks Return Format Example Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7| D8|D9|D10|D11|D12|D13|D14|D15|NONE} ——  The parameter can be any of the digital channels (D0-D15). The channel label and waveform of the selected channel are displayed in red.
PAGE 94
Chapter 2 Command System RIGOL :LA:DIGital:DISPlay Syntax :LA:DIGital:DISPlay , :LA:DIGital:DISPlay? Description Parameter Remarks Return Format Example Turns on or off the specified digital channel; or queries the on/off status of the specified digital channel.
PAGE 95
Chapter 2 Command System RIGOL :LA:DIGital:LABel Syntax :LA:DIGital:LABel , :LA:DIGital:LABel? Description Parameter Return Format Example Sets or queries the label of the specified digital channel. Name Type Range Default Integer {D0|D1|D2|D3|D4|D5|D6|D7| D8|D9|D10|D11|D12|D13|D14|D15} —— ASCII String The label can contain English letters and numbers, as well as some symbols.
PAGE 96
Chapter 2 Command System RIGOL specified user-defined channel group. Return Format Example  The currently enabled channel or user-defined channel group can be selected as the active channel or the channel group by sending the :LA:ACTive command.  POD1: D0 to D7; POD2: D8 to D15 The query returns 1 or 0. :LA:DISPlay D0,ON :LA:DISPlay? D0 /*Enables D0.*/ /*The query returns 1.
PAGE 97
Chapter 2 Command System RIGOL :LA:TCALibrate Syntax :LA:TCALibrate :LA:TCALibrate? Description Parameter Remarks Return Format Example Sets or queries the delay calibration time of the digital channel. The default unit is s. Name Type Range Default Real -1000 ns to 100 ns 0.00 s When you use an oscilloscope to make actual measurements, the transmission delay of the probe cable may bring relatively greater errors (zero offset).
PAGE 98
Chapter 2 Command System RIGOL :LAN Commands The :LAN commands are used to set and query the LAN parameters.
PAGE 99
Chapter 2 Command System RIGOL :LAN:AUToip Syntax :LAN:AUToip :LAN:AUToip? Description Parameter Remarks Return Format Example Turns on or off the Auto IP configuration mode; or queries the on/off status of the current Auto IP configuration mode. Name Type Range Default Bool {{1|ON}|{0|OFF}} 1|ON When the auto IP mode is valid, disable DHCP manually. You can self-define the gateway and DNS address for the oscilloscope. The query returns 1 or 0.
PAGE 100
Chapter 2 Command System RIGOL Return Format Example The query returns the current DNS address in strings. :LAN:DNS 192.168.1.1 :LAN:DNS? /*Sets the DNS address to 192.168.1.1.*/ /*The query returns the current DNS address.*/ :LAN:MAC? Syntax Description Return Format :LAN:MAC? Queries the MAC address of the instrument. The query returns the MAC address in strings. For example, 00:19:AF:00:11:22. :LAN:DSErver? Syntax Description Return Format :LAN:DSErver? Queries the address of the DHCP server.
PAGE 101
Chapter 2 Command System RIGOL :LAN:IPADdress Syntax :LAN:IPADdress :LAN:IPADdress? Description Parameter Remarks Return Format Example Sets or queries the IP address of the instrument. Name Type Range Default ASCII String Refer to Remarks ——  The format of is nnn,nnn,nnn,nnn. The range of the first section of "nnn" is from 0 to 223 (except 127), and the ranges of the other three sections of "nnn" are from 0 to 255.
PAGE 102
Chapter 2 Command System RIGOL DHCPFAILED: the DHCP configuration has failed. INVALIDIP: invalid IP. IPLOSE: IP lost. :LAN:VISA? Syntax Description Return Format :LAN:VISA? Queries the VISA address of the instrument. The query returns the VISA address in strings. :LAN:MDNS Syntax :LAN:MDNS :LAN:MDNS? Description Parameter Return Format Example Enables or disables MDNS; or queries the MDNS status. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0.
PAGE 103
Chapter 2 Command System RIGOL :LAN:APPLy Syntax Description :LAN:APPLy Applies the network configuration.
PAGE 104
Chapter 2 Command System RIGOL :MASK Commands The :MASK commands are used to set or query the relevant parameters of the pass/fail test. Command List:  :MASK:ENABle  :MASK:SOURce  :MASK:OPERate  :MASK:MDISplay  :MASK:X  :MASK:Y  :MASK:CREate  :MASK:RESet :MASK:ENABle Syntax :MASK:ENABle :MASK:ENABle? Description Parameter Remarks Return Format Example Enables or disables the pass/fail test function; or queries the on/off status of the pass/fail test function.
PAGE 105
Chapter 2 Command System RIGOL :MASK:OPERate Syntax :MASK:OPERate :MASK:OPERate? Description Parameter Description Return Format Example Runs or stops the pass/fail test; or queries the operating status of the pass/fail test. Name Type Range Default Discrete {RUN|STOP} STOP Before running this command, send the :MASK:ENABle command to enable the pass/fail test function. The query returns RUN or STOP. :MASK:OPERate RUN :MASK:OPERate? /*Runs the pass/fail test function.
PAGE 106
Chapter 2 Command System RIGOL :MASK:X Syntax :MASK:X :MASK:X? Description Parameter Return Format Example Sets or queries the horizontal adjustment parameter of the pass/fail test mask. The default unit is div. Name Type Range Default Real 0.01 div to 2 div 0.24 div The query returns the current horizontal adjustment parameter in scientific notation. :MASK:X 0.28 :MASK:X? /*Sets the horizontal adjustment parameter to 0.28 div.*/ /*The query returns 2.800000E-1.
PAGE 107
Chapter 2 Command System RIGOL :MATH Commands The :MATH commands are used to set various math operation function of the waveform between channels.
PAGE 108
Chapter 2 Command System RIGOL  :MATH:FILTer:TYPE  :MATH:FILTer:W1  :MATH:FILTer:W2  :MATH:SENSitivity  :MATH:DISTance  :MATH:THReshold1  :MATH:THReshold2 :MATH:DISPlay Syntax :MATH:DISPlay :MATH:DISPlay? Description Parameter Return Format Example Enables or disables the math operation function; or queries the status of the math operation function.
PAGE 109
Chapter 2 Command System RIGOL :MATH:SOURce1 Syntax :MATH:SOURce1 :MATH:SOURce1? Description Parameter Remarks Return Format Example Sets or queries the source or Source A of arithmetic operation and function operation. Name Type Range Default Discrete {1|2|3|4} —— Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1  For arithmetic operation, this command is used to set Source A.  For function operation, use this command only to set the source.
PAGE 110
Chapter 2 Command System RIGOL Example :MATH1:LSOUrce1 D3 /*Sets Source A of the logic operation to D3.*/ :MATH1:LSOUrce1? /*The query returns D3.*/ :MATH:LSOUrce2 Syntax :MATH:LSOUrce2 :MATH:LSOUrce2? Description Parameter Remarks Return Format Example Sets or queries Source B of the logic operation.
PAGE 111
Chapter 2 Command System RIGOL :MATH:OFFSet Syntax :MATH:OFFSet :MATH:OFFSet? Description Parameter Return Format Example Sets or queries the vertical offset of the operation results. The unit is related to the currently selected operator and the unit selected by the source. Name Type Range Default Discrete {1|2|3|4} —— Real -1 GV to +1 GV 0.00 V The query returns the vertical offset of the current operation results in scientific notation.
PAGE 112
Chapter 2 Command System RIGOL :MATH:FFT:SOURce Syntax :MATH:FFT:SOURce :MATH:FFT:SOURce? Description Parameter Return Format Example Sets or queries the channel source of FFT operation/filter. Name Type Range Default Discrete {1|2|3|4} —— Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|} CHANnel1 The query returns CHAN1, CHAN2, CHAN3, or CHAN4. :MATH1:FFT:SOURce CHANnel3 /*Sets the channel source of FFT operation to CH3.
PAGE 113
Chapter 2 Command System RIGOL You can view the time-domain and frequency-domain signals clearly.  Return Format Example OFF: the source channel and the FFT operation results are displayed in the same window (on the full screen) to view the frequency spectrum more clearly and to perform more precise measurement. The query returns 1 or 0. :MATH1:FFT:SPLit OFF :MATH1:FFT:SPLit? /*Disables the half-screen display.*/ /*The query returns 0.
PAGE 114
Chapter 2 Command System RIGOL :MATH:FFT:OFFSet Syntax :MATH:FFT:OFFSet :MATH:FFT:OFFSet? Description Parameter Return Format Example Sets or queries the vertical offset of FFT operation results. Name Type Range Default Discrete {1|2|3|4} —— Real -1 GdB to 1 GdB 0 dB The query returns the current vertical offset in scientific notation. :MATH1:FFT:OFFSet 0.
PAGE 115
Chapter 2 Command System RIGOL :MATH:FFT:FREQuency:STARt Syntax :MATH:FFT:FREQuency:STARt :MATH:FFT:FREQuency:STARt? Description Parameter Return Format Example Sets or queries the start frequency of FFT operation results. Name Type Range Default Discrete {1|2|3|4} —— Real -2.5 GHz to 2.5 GHz 0 Hz The query returns the start frequency of the operation results in scientific notation.
PAGE 116
Chapter 2 Command System RIGOL :MATH:FFT:SEARch:NUM Syntax :MATH:FFT:SEARch:NUM :MATH:FFT:SEARch:NUM? Description Parameter Return Format Example Sets or queries the maximum number of the FFT peak search. Name Type Range Default Discrete {1|2|3|4} —— Integer 1 to 15 5 The query returns an integer ranging from 1 to 15. :MATH1:FFT:SEARch:NUM 10 :MATH1:FFT:SEARch:NUM? /*Sets the maximum number of the FFT peak search to 10.*/ /*The query returns 10.
PAGE 117
Chapter 2 Command System RIGOL :MATH:FFT:SEARch:ORDer Syntax :MATH:FFT:SEARch:ORDer :MATH:FFT:SEARch:ORDer? Description Parameter Return Format Example Sets or queries the sequence of the FFT peak search results. Name Type Range Default Discrete {1|2|3|4} —— Discrete {AMPorder|FREQOrder} AMPorder The query returns AMPO or FREQ. :MATH1:FFT:SEARch:ORDer AMPorder :MATH1:FFT:SEARch:ORDer? /*Sets the sequence of the FFT peak search results to AMPorder.
PAGE 118
Chapter 2 Command System RIGOL :MATH:FILTer:W1 Syntax :MATH:FILTer:W1 :MATH:FILTer:W1? Description Parameter Remarks Return Format Example Sets or queries the cut-off frequency (ωc1) of Low Pass Filter/High Pass Filter; or the cut-off frequency 1 (ωc1) of Band Pass Filter/Band Stop Filter. The default unit is Hz. Name Type Range Default Discrete {1|2|3|4} —— Real Refer to Remarks Related to the filter type LPASs|BPASs|BSTOP: 0.005× screen sample rate HPASs: 0.
PAGE 119
Chapter 2 Command System Example RIGOL :MATH1:FILTer:W2 1500000 /*Sets the cut-off frequency 2 of Band Pass Filter to 1.5 MHz.*/ :MATH1:FILTer:W2? /*The query returns 1.500000E+6.*/ :MATH:SENSitivity Syntax :MATH:SENSitivity :MATH:SENSitivity? Description Sets or queries the sensitivity of the logic opearation. The default unit is div.
PAGE 120
Chapter 2 Command System RIGOL VerticalOffset indicates the vertical offset of the current Source A. The step value is VerticalScale/10. Return Format Example The query returns the threshold level of the current Source A in scientific notation. :MATH1:THReshold1 0.8 /*Sets the threshold level of Source A in logic operation to 800 mV.*/ :MATH1:THReshold1? /*The query returns 8.000000E-1.
PAGE 121
Chapter 2 Command System RIGOL :MEASure Commands The :MEASure commands are used to set and query the relevant parameters for measurement.
PAGE 122
Chapter 2 Command System RIGOL Remarks Only the currently enabled channels can be selected. Return Format The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, or MATH4. Example :MEASure:SOURce CHANnel2 /*Sets the channel source for the parameter to CH2.*/ :MEASure:SOURce? /*The query returns CHAN2.
PAGE 123
Chapter 2 Command System RIGOL :MEASure:CLEar Syntax Description Parameter :MEASure:CLEar Clears any one or all of the 10 measurement items that have been turned on. Name Type Range Default Discrete {ITEM1|ITEM2|ITEM3|ITEM4|ITEM5|ITEM6|I TEM7|ITEM8|ITEM9|ITEM10|ALL} —— Remarks Run the :MEASure:ITEM command to open one of the 41 parameters that is required to be measured.
PAGE 124
Chapter 2 Command System RIGOL :MEASure:AMSource Syntax :MEASure:AMSource :MEASure:AMSource? Description Parameter Return Format Example Sets the source and displays all measurement values of the set source; or queries the channel source (s) of the all measurement function. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF} OFF The query returns CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, MATH4, or OFF. They are separated by commas.
PAGE 125
Chapter 2 Command System Return Format Example RIGOL The query returns an integer. :MEASure:SETup:MID 89 :MEASure:SETup:MID? /*Sets the middle value of the threshold level to 89%.*/ /*The query returns 89.*/ :MEASure:SETup:MIN Syntax :MEASure:SETup:MIN :MEASure:SETup:MIN? Description Parameter Description Return Format Example Sets or queries the threshold level lower limit of the analog channel in auto measurement.
PAGE 126
Chapter 2 Command System RIGOL :MEASure:SETup:PSB Syntax :MEASure:SETup:PSB :MEASure:SETup:PSB? Description Parameter Return Format Example Sets or queries Source B in the phase or delay measurement.
PAGE 127
Chapter 2 Command System RIGOL :MEASure:STATistic:DISPlay Syntax :MEASure:STATistic:DISPlay :MEASure:STATistic:DISPlay? Description Parameter Remarks Return Format Example Enables or disables the statistical function; or queries the status of the statistical function.
PAGE 128
Chapter 2 Command System RIGOL HANnel2|CHANnel3|CHANnel4|MATH1|MATH2|MATH3|MATH4}. Return Format Example  If the measurement parameter is a single source, you only need to set one source. If this parameter is omitted, then the source is by default, selected by the :MEASure:SOURce command.  If the measurement parameter is a dual channel source, then the command sent must contain two sources. Otherwise, the command is invalid. The query returns the statistical results in scientific notation.
PAGE 129
Chapter 2 Command System RIGOL :MEASure:AREA Syntax :MEASure:AREA :MEASure:AREA? Description Parameter Remarks Return Format Example Sets or queries the type of the measurement range. Name Type Range Default Discrete {MAIN|ZOOM|CURSor} MAIN  MAIN: indicates that the measurement range is within the main time base region.  ZOOM: indicates that the measurement range is within the zoomed time base region.
PAGE 130
Chapter 2 Command System RIGOL :MEASure:CREGion:CBX Syntax :MEASure:CREGion:CBX :MEASure:CREGion:CBX? Description Parameter Remarks Return Format Example Sets or queries the position of Cursor B when the measurement range is the "cursor region". Name Type Range Default Integer 0 to 1,000 600  The position of the cursor is defined by the pixel coordinate of the screen. The range of the pixel coordinate on the screen horizontally is from 0 to 1,000 (from left to right).
PAGE 131
Chapter 2 Command System RIGOL :POWer Commands Command List:  :POWer:TYPE  :POWer:CURRentsource  :POWer:VOLTagesource  :POWer:QUALity:FREQREFerence  :POWer:REFLevel:METHod  :POWer:REFLevel:PERCent:HIGH  :POWer:REFLevel:PERCent:LOW  :POWer:REFLevel:PERCent:MID :POWer:TYPE Syntax :POWer:TYPE :POWer:TYPE? Description Parameter Description Return Format Example Sets or queries the power analysis type.
PAGE 132
Chapter 2 Command System RIGOL :POWer:VOLTagesource Syntax :POWer:VOLTagesource :POWer:VOLTagesource? Description Parameter Return Format Example Sets or queries the voltage source of power quality. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 The query returns CHAN1, CHAN2, CHAN3, or CHAN4. :POWer:VOLTagesource CHANnel2 :POWer:VOLTagesource? /*Sets the voltage source to CH2.*/ /*The query returns CHAN2.
PAGE 133
Chapter 2 Command System RIGOL :POWer:REFLevel:PERCent:HIGH Syntax :POWer:REFLevel:PERCent:HIGH :POWer:REFLevel:PERCent:HIGH? Description Parameter Remarks Sets or queries the reference level percentage upper limit of power quality. Name Type Range Default Integer (median+1) to 100 0 upper limit>median>lower limit Return Format The query returns an integer ranging from (median+1) to 100.
PAGE 134
Chapter 2 Command System RIGOL :Quick Commands The :Quick commands are used to set and query the relevant parameters for shortcut keys. Command List:  :Quick:OPERation :Quick:OPERation Syntax :Quick:OPERation :Quick:OPERation? Description Parameter Remarks Sets or queries the type of the shortcut keys. Name Type Range Default Discrete {SIMage|SWAVe|SSETup|AMEasure|SRESet} SIMage SIMage: indicates the screen image. SWAVe: indicates the waveform saving.
PAGE 135
Chapter 2 Command System RIGOL :RECord Commands Command List:  :RECord:ENABle  :RECord:STARt  :RECord:PLAY  :RECord:CURRent  :RECord:FRAMes :RECord:ENABle Syntax :RECord:ENABle :RECord:ENABle? Description Parameter Return Format Example Enables or disables the waveform recording function; or queries the on/off status of the waveform recording function. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0.
PAGE 136
Chapter 2 Command System RIGOL :RECord:PLAY Syntax :RECord:PLAY :RECord:PLAY? Description Parameter Return Format Example Enables or disables the waveform playing function; or queries the on/off status of the waveform playing function. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0. :RECord:PLAY ON :RECord:PLAY? /*Sets to play the waveforms.*/ /*The query returns 1.
PAGE 137
Chapter 2 Command System RIGOL :REFerence Commands The :REFerence commands are used to set relevant parameters for reference waveforms.
PAGE 138
Chapter 2 Command System RIGOL Format Example D15, CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, or MATH4. :REFerence:SOURce 1,CHANnel1 /*Sets the source of the reference channel 1 to CH1.*/ :REFerence1:SOURce? 1 /*The query returns CHAN1.*/ :REFerence:VSCale Syntax :REFerence:VSCale , :REFerence:VSCale? Description Parameter Sets or queries the vertical scale of the specified reference channel. The unit is the same as that of the current source.
PAGE 139
Chapter 2 Command System RIGOL :REFerence:RESet Syntax Description Parameter :REFerence:RESet Resets the vertical scale and vertical offset of the specified reference channel to the defaults. Name Type Range Default Discrete {1|2|3|4|5|6|7|8|9|10} —— :REFerence:CURRent Syntax Description Parameter Remarks :REFerence:CURRent Selects the specified reference channel.
PAGE 140
Chapter 2 Command System RIGOL :REFerence:LABel:ENABle Syntax :REFerence:LABel:ENABle :REFerence:LABel:ENABle? Description Parameter Return Format Example Enables or disables the display of all the labels; or queries the on/off display of all the labels. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0. :REFerence:LABel:ENABle ON :REFerence:LABel:ENABle? /*Enables the display of all the labels.*/ /*The query returns 1.
PAGE 141
Chapter 2 Command System RIGOL :SAVE and :Load Commands Command List:  :SAVE:CSV  :SAVE:CSV:LENGth  :SAVE:FORMat  :SAVE:IMAGe  :SAVE:IMAGe:TYPE  :SAVE:IMAGe:INVert  :SAVE:IMAGe:COLor  :SAVE:SETup  :SAVE:WAVeform  :SAVE:STATus?  :LOAD:SETup :SAVE:CSV Syntax Description Parameter Remarks Example :SAVE:CSV Saves the waveform data displayed on the screen to the internal or external memory in "*.csv" format.
PAGE 142
Chapter 2 Command System RIGOL Example :SAVE:CSV:LENGth MAXimum :SAVE:CSV:LENGth? /*Sets the data length type to MAXimum.*/ /*The query returns MAX.*/ :SAVE:FORMat Syntax :SAVE:FORMat :SAVE:FORMat? Description Parameter Return Format Example Sets or queries the storage format. Name Type Range Default Discrete {TRACe|WAVeform|SETup|PICTure|CSV} PICTure The query returns TRAC, WAV, SET, PICT, or CSV. :SAVE:FORMat TRACe :SAVE:FORMat? /*Sets the storage format to TRACe.
PAGE 143
Chapter 2 Command System Description Parameter RIGOL Enables or disables the invert function when saving the image; or queries whether the invert function is enabled when saving the image. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF Return Format The query returns 1 or 0. Example :SAVE:IMAGe:INVert ON :SAVE:IMAGe:INVert? /*Enables the invert function when saving the image.*/ /*The query returns 1.
PAGE 144
Chapter 2 Command System RIGOL :SAVE:WAVeform Syntax Description Parameter :SAVE:WAVeform Saves the waveform data to the internal or external memory. Name Type Range Default ASCII String Refer to Remarks —— Remarks includes the file storage location and the filename with a suffix. By default, its suffix is in ".bin" format. The filename suffixed with ".csv" and ".wfm" are also supported.
PAGE 145
Chapter 2 Command System RIGOL :SEARch Commands Command List:  :SEARch:STATe  :SEARch:MODE  :SEARch:EVENt  :SEARch:EDGE:SLOPe  :SEARch:EDGE:SOURce  :SEARch:PULSe:POLarity  :SEARch:PULSe:QUALifier  :SEARch:PULSe:SOURce  :SEARch:RUNT:POLarity  :SEARch:RUNT:QUALifier  :SEARch:RUNT:SOURce  :SEARch:SLOPe:POLarity  :SEARch:SLOPe:QUALifier  :SEARch:SLOPe:SOURce :SEARch:STATe Syntax :SEARch:STATe :SEARch:STATe? Description Parameter Return Format Example Enable
PAGE 146
Chapter 2 Command System RIGOL :SEARch:MODE Syntax :SEARch:MODE :SEARch:MODE? Description Sets the search type. Parameter Remarks Return Format Example Name Type Range Default Bool {EDGE|PULSe|RUNT|SLOPe|RS232|I2C|SPI} EDGE  EDGE: selects "Edge" as the search type.  PULSe: selects "Pulse" as the search type.  RUNT: selects "Runt" as the search type.  SLOPe: selects "Slope" as the search type.  RS232: selects "RS232" as the search type.
PAGE 147
Chapter 2 Command System Return Format Example RIGOL The query returns POS, NEG, or EITH. :SEARch:EDGE:SLOPe NEGative :SEARch:EDGE:SLOPe? /*Sets the edge type to "NEGative".*/ /*The query returns NEG.*/ :SEARch:EDGE:SOURce Syntax :SEARch:EDGE:SOURce :SEARch:EDGE:SOURce? Description Parameter Return Format Example Sets or queries the source for the "Edge" search type.
PAGE 148
Chapter 2 Command System RIGOL  Return Format Example GLESs: the positive/negative pulse width of the input signal is greater than the specified lower limit of pulse width and smaller than the specified upper limit of pulse width. The query returns GRE, LESS, or GLES. :SEARch:PULSe:QUALifier LESS :SEARch:PULSe:QUALifier? /*Sets the search condition for "Pulse" search type to LESS.*/ /*The query returns LESS.
PAGE 149
Chapter 2 Command System Return Format Example RIGOL  GREater: triggers when the runt pulse width is greater than the lower limit of pulse width.  LESS: triggers when the runt pulse width is smaller than the upper limit of pulse width.  GLESs: triggers when the runt pulse width is greater than the lower limit and smaller than the upper limit of pulse width. Note: The lower limit of the pulse width must be smaller than the upper limit. The query returns NONE, GRE, LESS, or GLES.
PAGE 150
Chapter 2 Command System RIGOL :SEARch:SLOPe:QUALifier Syntax :SEARch:SLOPe:QUALifier :SEARch:SLOPe:QUALifier? Description Parameter Remarks Return Format Example Sets or queries the search condition for "Slope" search type. Name Type Range Default Discrete {GREater|LESS|GLESs} GREater  GReater: the positive slope time of the input signal is greater than the specified time.  LESS: the positive slope time of the input signal is smaller than the specified time.
PAGE 151
Chapter 2 Command System RIGOL [:SOURce[]] Commands The [:SOURce[]] commands are used to set the relevant parameters of the built-in function/arbitrary waveform generator. can set to 1 or 2, which indicates the corresponding built-in function/arbitrary waveform generator channel. When or :SOURce[] is omitted, by default, the operations are carried out on AWG GI. The commands are only available for the MSO7000 model installed with the function/arbitrary waveform generator option.
PAGE 152
Chapter 2 Command System RIGOL [:SOURce[]]:FREQuency[:FIXed] Syntax [:SOURce[]]:FREQuency[:FIXed] [:SOURce[]]:FREQuency[:FIXed]? Description Parameter If modulation is not enabled for the specified function/arbitrary waveform generator channel, this command is used to set or query the output frequency of the specified function/arbitrary waveform generator channel.
PAGE 153
Chapter 2 Command System RIGOL [:SOURce[]]:PHASe:INITiate Syntax Description Parameter Remarks [:SOURce[]]:PHASe:INITiate Performs the "align phase" operation. Name Type Range Default [] Discrete {1|2} When omitted, by default, the operations are carried out on GI. When you perform the "align phase" operation, the instrument will re-configure the two channels to output according to the preset frequency and phase.
PAGE 154
Chapter 2 Command System RIGOL [:SOURce[]]:FUNCtion:RAMP:SYMMetry Syntax [:SOURce[]]:FUNCtion:RAMP:SYMMetry [:SOURce[]]:FUNCtion:RAMP:SYMMetry? Description Parameter Remarks Sets or queries the symmetry of the Ramp waveforms output from the specified function/arbitrary waveform generator channel. Name Type Range Default [] Discrete {1|2} When omitted, by default, the operations are carried out on GI.
PAGE 155
Chapter 2 Command System RIGOL [:SOURce[]]:VOLTage[:LEVel][:IMMediate]:OFFSet Syntax [:SOURce[]]:VOLTage[:LEVel] [:IMMediate]:OFFSet [:SOURce[]]:VOLTage[:LEVel] [:IMMediate]:OFFSet? Description Parameter Sets or query the DC offset of the signal output from the specified function/arbitrary waveform generator channel. By default, the unit is VDC. Name Type Range Default [] Discrete {1|2} When omitted, by default, the operations are carried out on GI.
PAGE 156
Chapter 2 Command System RIGOL Return Format Example The query returns the current duty cycle in scientific notation. :PULSe:DCYCle 50 :PULSe:DCYCle? /*Sets the duty cycle of GI pulse to 50%.*/ /*The query returns 5.000000E+1.*/ [:SOURce[]]:MOD:TYPE Syntax [:SOURce[]]:MOD:TYPE [:SOURce[]]:MOD:TYPE? Description Parameter Remarks Return Format Example Sets or queries the modulation type of the specified function/arbitrary waveform generator channel.
PAGE 157
Chapter 2 Command System  Return Format Example RIGOL When the modulation depth is greater than 100%, envelop distortion will occur. This should be avoided in actual circuit. At this time, the output of the instrument will not exceed 5 Vpp (the load is 50 Ω). The query returns an integer ranging from 0 to 120. :MOD:AM 80 :MOD:AM? /*Sets the AM modulation depth of GI to 80%.*/ /*The query returns 80.
PAGE 158
Chapter 2 Command System RIGOL [:SOURce[]]:MOD:AM:INTernal:FUNCtion [:SOURce[]]:MOD:FM:INTernal:FUNCtion Syntax [:SOURce[]]:MOD:AM:INTernal:FUNCtion [:SOURce[]]:MOD:AM:INTernal:FUNCtion? [:SOURce[]]:MOD:FM:INTernal:FUNCtion [:SOURce[]]:MOD:FM:INTernal:FUNCtion? Description Parameter Remarks Return Format Example Sets or queries the modulating waveform of AM or FM of the specified function/arbitrary waveform generator channel.
PAGE 159
Chapter 2 Command System Return Format Example RIGOL  When the modulating waveform amplitude reaches the maximum value, the frequency of the carrier is increased by "frequency offset". When the modulating waveform amplitude reaches the minimum value, the frequency of the carrier is decreased by "frequency offset".  Only when FM is selected for the specified function/arbitrary waveform generator channel, can the frequency offset of FM be set.
PAGE 160
Chapter 2 Command System RIGOL Real Sine: 0.1 Hz to 25 MHz Square: 0.1 Hz to 15 MHz Pulse: 0.1 Hz to 1 MHz Ramp: 0.1 Hz to 100 kHz Arb: 0.1 Hz to 10 MHz 1kHz Real Related to the currently set output impedance HighZ: 20 mVpp to 5 Vpp 50Ω: 10 mVpp to 2.5 Vpp 5Vpp Real Related to the current input impedance and amplitude HighZ: (-2.5V + current amplitude/2) to (2.5V current amplitude/2) 50Ω: (-1.25V + current amplitude/2) to (1.
PAGE 161
Chapter 2 Command System RIGOL [:SOURce[]]:OUTPut[][:STATe] Syntax [:SOURce[]]:OUTPut[][:STATe] [:SOURce[]]:OUTPut[][:STATe]? Description Parameter Remarks Return Format Example Enables or disables the output of the specified function/arbitrary waveform generator channel; or queries the output status of the specified function/arbitrary waveform generator channel.
PAGE 162
RIGOL Chapter 2 Command System :SYSTem Commands The :SYSTem commands are used to set sound, language, and other relevant system settings.
PAGE 163
Chapter 2 Command System RIGOL :SYSTem:AOUTput Syntax :SYSTem:AOUTput :SYSTem:AOUTput? Description Parameter Remarks Return Format Example Sets or queries the type of the signal output from the [TRIG OUT] connector on the rear panel.
PAGE 164
Chapter 2 Command System RIGOL :SYSTem:BEEPer Syntax :SYSTem:BEEPer :SYSTem:BEEPer? Description Parameter Return Format Example Turns on or off the beeper; or queries the on/off status of the beeper. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0. :SYSTem:BEEPer ON :SYSTem:BEEPer? /*Enables the beeper.*/ /*The query returns 1.*/ :SYSTem:DATE Syntax :SYSTem:DATE ,,.
PAGE 165
Chapter 2 Command System RIGOL :SYSTem:GPIB Syntax :SYSTem:GPIB :SYSTem:GPIB? Description Parameter Return Format Example Sets or queries the GPIB address. Name Type Range Default Integer 1 to 30 1 The query returns an integer ranging from 1 to 30. :SYSTem:GPIB 2 :SYSTem:GPIB? /*Sets the GPIB address to 2.*/ /*The query returns 2.*/ :SYSTem:KEY:PRESs Syntax Description Parameter Remarks :SYSTem:KEY:PRESs Press down the specified key on the front panel of the oscilloscope.
PAGE 166
Chapter 2 Command System RIGOL Example  VSCale3: press down the vertical scale knob of CH3, i.g. switch the vertical scale of CH3 to "Coarse" or "Fine".  VSCale4: press down the vertical scale knob of CH4, i.g. switch the vertical scale of CH4 to "Coarse" or "Fine".  WSCale: press down the vertical scale knob in the waveform control area.  WPOSition: press down the vertical position knob in the waveform control area.  HSCale: press down the horizontal time base adjustment knob, i.g.
PAGE 167
Chapter 2 Command System RIGOL TLEVel: the trigger level adjustment knob. WVOLt: the vertical scale adjustment knob for the waveform. WPOSition: the vertical position adjustment knob for the waveform.  Example The parameter defines the specified rotation times of the knob. By default, it is 1. :SYSTem:KEY:INCRease VOFFset2 /*Rotates the vertical offset adjustment knob of CH2 clockwise.
PAGE 168
Chapter 2 Command System RIGOL :SYSTem:PSTatus Syntax :SYSTem:PSTatus :SYSTem:PSTatus? Description Parameter Remarks Return Format Example Sets or queries the power status of the oscilloscope. Name Type Range Default Discrete {DEFault|OPEN} OPEN  DEFault: after the oscilloscope is powered on, you need to press the Power key on the front panel to start the oscilloscope.  OPEN: after the oscilloscope is powered on, it starts directly. You do not have to press the Power key.
PAGE 169
Chapter 2 Command System RIGOL :SYSTem:OPTion:STATus? Syntax Description Parameter Return Format :SYSTem:OPTion:STATus? Queries the status of the options of the oscilloscope. Name Type Discrete Range {BW12|BW13|BW15|BW23|BW2 5|BW35|MSO|RL2|RL5|BND|CO MP|EMBD|AUTO|AUDIO|SENSO R|AERO|ARINC|DG|JITTer|MAS K|PWR|DVM|CTR|EDK} Default —— The query returns 0 or 1. 0: indicates that the option is not installed. 1: indicates that the official option has been installed.
PAGE 170
Chapter 2 Command System RIGOL :SYSTem:SSAVEr:TIME Syntax :SYSTem:SSAVEr:TIME :SYSTem:SSAVEr:TIME? Description Parameter Remarks Return Format Example Sets or queries the screen saver time. The default unit for the value is minute. Name Type Range Default Integer 1 to 999 30 When the oscilloscope enters the idle state and holds for a specified time, the screen saver program will be enabled. The query returns an integer ranging from 1 to 999.
PAGE 171
Chapter 2 Command System RIGOL :SYSTem:MODules? Syntax Description Return Format :SYSTem:MODules? Queries the hardware modules. The query returns 1,0,0,0,0. The first figure indicates LA; the second figure indicates DG; and the others are not defined currently. 1 indicates not null, and 0 indicates null.
PAGE 172
Chapter 2 Command System RIGOL :TIMebase Commands The :TIMebase commands are used to set the horizontal system. For example, enable the delayed sweep, set the horizontal time base mode, etc.
PAGE 173
Chapter 2 Command System RIGOL scale. Return Format Example The query returns the offset of the delayed time base in scientific notation. :TIMebase:DELay:OFFSet 0.000002 /*Sets the offset of the delayed time base to 2 μs.*/ :TIMebase:DELay:OFFSet? /*The query returns 2.000000E-6.*/ :TIMebase:DELay:SCALe Syntax :TIMebase:DELay:SCALe :TIMebase:DELay:SCALe? Description Parameter Remarks Return Format Example Sets or queries the scale of the delayed time base. The default unit is s/div.
PAGE 174
Chapter 2 Command System RIGOL :TIMebase[:MAIN]:SCALe Syntax :TIMebase[:MAIN]:SCALe :TIMebase[:MAIN]:SCALe? Description Parameter Remarks Sets or queries the scale of the main time base. Name Type Range Default Real Refer to Remarks 1 μs/div The range of is related to the current horizontal time base mode of the oscilloscope and its model.
PAGE 175
Chapter 2 Command System Return Format Example RIGOL  LB: when the horizontal time base is modified, the waveform displayed will be expanded or compressed relative to the left border of the screen.  RB: when the horizontal time base is modified, the waveform displayed will be expanded or compressed relative to the right border of the screen.  TRIG: when the horizontal time base is modified, the waveform displayed will be expanded or compressed horizontally relative to the trigger position.
PAGE 176
Chapter 2 Command System RIGOL :TRIGger Commands The :TRIGger commands are used to set the trigger system of the oscilloscope.
PAGE 177
Chapter 2 Command System RIGOL :TRIGger:MODE Syntax :TRIGger:MODE :TRIGger:MODE? Description Parameter Return Format Example Selects or queries the trigger type. Name Type Range Default Discrete {EDGE|PULSe|SLOPe|VIDeo|PATTern|DURation| TIMeout|RUNT|WINDow|DELay|SETup|NEDGe| RS232|IIC|SPI|CAN|FLEXray|LIN|IIS|M1553 EDGE The query returns EDGE, PULS, SLOP, VID, PATT, DUR, TIM, RUNT, WIND, DEL, SET, NEDG, RS232, IIC, SPI, CAN, CANF, FLEX, LIN, IIS, or M1553.
PAGE 178
Chapter 2 Command System RIGOL :TRIGger:SWEep Syntax :TRIGger:SWEep :TRIGger:SWEep? Description Parameter Remarks Return Format Example Sets or queries the trigger mode. Name Type Range Default Discrete {AUTO|NORMal|SINGle} AUTO  AUTO: Auto trigger. The waveforms are displayed no matter whether the trigger conditions are met.  NORMal: normal trigger. The waveforms are displayed when trigger conditions are met.
PAGE 179
Chapter 2 Command System RIGOL :TRIGger:NREJect Syntax :TRIGger:NREJect :TRIGger:NREJect? Description Parameter Remarks Return Format Example Turns on or off noise rejection; or queries the on/off status of noise rejection. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF  Noise rejection reduces the possibility of the Noise trigger.  This command is only available for the External trigger in which the analog channel is selected as the source. The query returns 1 or 0.
PAGE 180
Chapter 2 Command System RIGOL Remarks Return Format Example  POSitive: indicates the rising edge.  NEGative: indicates the falling edge.  RFALl: indicates the rising or falling edge. The query returns POS, NEG, or RFAL. :TRIGger:EDGE:SLOPe NEGative :TRIGger:EDGE:SLOPe? /*Sets the edge type to Falling Edge.*/ /*The query returns NEG.
PAGE 181
Chapter 2 Command System RIGOL :TRIGger:PULSe Command List:  :TRIGger:PULSe:SOURce  :TRIGger:PULSe:WHEN  :TRIGger:PULSe:UWIDth  :TRIGger:PULSe:LWIDth  :TRIGger:PULSe:LEVel :TRIGger:PULSe:SOURce Syntax :TRIGger:PULSe:SOURce :TRIGger:PULSe:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of Pulse trigger.
PAGE 182
Chapter 2 Command System RIGOL :TRIGger:PULSe:UWIDth Syntax :TRIGger:PULSe:UWIDth :TRIGger:PULSe:UWIDth? Description Sets or queries the pulse upper limit of the Pulse trigger. The default unit is s. Parameter Remarks Return Format Example Name Type Range Default Real Pulse lower limit to 10 s 2 μs The set upper limit cannot be smaller than the lower limit, otherwise, the lower limit will be automatically changed.
PAGE 183
Chapter 2 Command System RIGOL :TRIGger:SLOPe Command List:  :TRIGger:SLOPe:SOURce  :TRIGger:SLOPe:WHEN  :TRIGger:SLOPe:TUPPer  :TRIGger:SLOPe:TLOWer  :TRIGger:SLOPe:WINDow  :TRIGger:SLOPe:ALEVel  :TRIGger:SLOPe:BLEVel :TRIGger:SLOPe:SOURce Syntax :TRIGger:SLOPe:SOURce < channel > :TRIGger:SLOPe:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of Slope trigger.
PAGE 184
Chapter 2 Command System RIGOL :TRIGger:SLOPe:TUPPer Syntax :TRIGger:SLOPe:TUPPer :TRIGger:SLOPe:TUPPer? Description Parameter Remarks Return Format Example Sets or queries the upper time limit value of the Slope trigger. The default unit is s. Name Type Range Default Real Lower limit to 10 s 1 μs The set upper limit cannot be smaller than the lower limit, otherwise, the lower limit will be automatically changed. The query returns the upper time limit in scientific notation.
PAGE 185
Chapter 2 Command System RIGOL :TRIGger:SLOPe:ALEVel Syntax :TRIGger:SLOPe:ALEVel :TRIGger:SLOPe:ALEVel? Description Parameter Remarks Return Format Example Sets or queries the upper limit of the trigger level of Slope trigger. The unit is the same as that of the current amplitude.
PAGE 186
Chapter 2 Command System RIGOL :TRIGger:VIDeo Command List:  :TRIGger:VIDeo:SOURce  :TRIGger:VIDeo:POLarity  :TRIGger:VIDeo:MODE  :TRIGger:VIDeo:LINE  :TRIGger:VIDeo:STANdard  :TRIGger:VIDeo:LEVel :TRIGger:VIDeo:SOURce Syntax :TRIGger:VIDeo:SOURce :TRIGger:VIDeo:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of Video trigger.
PAGE 187
Chapter 2 Command System RIGOL :TRIGger:VIDeo:MODE Syntax :TRIGger:VIDeo:MODE :TRIGger:VIDeo:MODE? Description Parameter Remarks Return Format Example Sets or queries the sync type of Video trigger. Name Type Range Default Discrete {ODDField|EVENfield|LINE|ALINes} ALINes  ODDField: indicates the odd field. The oscilloscope triggers on the rising edge of the first ramp waveform in the odd field. It is available when the video standard is NTSC or PAL/SECAM.
PAGE 188
Chapter 2 Command System RIGOL :TRIGger:VIDeo:STANdard Syntax :TRIGger:VIDeo:STANdard :TRIGger:VIDeo:STANdard? Description Parameter Remarks Return Format Example Sets or queries the video standard of Video trigger. Name Type Range Default Discrete {PALSecam|NTSC|480P|576P} NTSC  PALSecam: PAL: indicates that the frame frequency is 25 frames per second. The TV scan line is 625, with the odd field going first and the even field following behind.
PAGE 189
Chapter 2 Command System RIGOL :TRIGger:PATTern Command List:  :TRIGger:PATTern:PATTern  :TRIGger:PATTern:LEVel  :TRIGger:PATTern:SOURce :TRIGger:PATTern:PATTern Syntax :TRIGger:PATTern:PATTern [,[,[,,[,[,[,[,[,
[,[,[,[,[,[,[,[,[,< pla14>[,]]]]]]]]]]]]]]]]]]]] :TRIGger:PATTern:PATTern? Description Parameter Remarks Return Format Example Sets or queries the channel pattern of
PAGE 190
Chapter 2 Command System RIGOL :TRIGger:PATTern:LEVel Syntax :TRIGger:PATTern:LEVel , :TRIGger:PATTern:LEVel? Description Parameter Remarks Return Format Example Sets or queries the trigger level of the specified channel in Pattern trigger. The unit is the same as that of the current amplitude.
PAGE 191
Chapter 2 Command System RIGOL :TRIGger:DURATion Command List:  :TRIGger:DURATion:SOURce  :TRIGger:DURATion:TYPE  :TRIGger:DURATion:WHEN  :TRIGger:DURATion:TUPPer  :TRIGger:DURATion:TLOWer  :TRIGger:DURation:LEVel :TRIGger:DURATion:SOURce Syntax :TRIGger:DURATion:SOURce :TRIGger:DURATion:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of Duration trigger.
PAGE 192
Chapter 2 Command System RIGOL channels "D0 to D15".  Return Format Example In the parameter range, H indicates high level (higher than the threshold level of the channel), L indicates low level (lower than the threshold level of the channel), and X indicates omitting the channel (This channel is not used as a part of the pattern. When all the channels are set to X, the oscilloscope will not trigger.) The query returns the currently set pattern of all the channels.
PAGE 193
Chapter 2 Command System RIGOL :TRIGger:DURATion:TLOWer Syntax :TRIGger:DURATion:TLOWer :TRIGger:DURATion:TLOWer? Description Parameter Remarks Return Format Example Sets or queries the lower limit of the duration time of Duration trigger. The default unit is s. Name Type Range Default Real 800 ps to 10 s 1 μs This command is only available when the trigger conditions are GREater and GLESs. The query returns the lower limit of the duration time in scientific notation.
PAGE 194
Chapter 2 Command System RIGOL :TRIGger:TIMeout Command List:  :TRIGger:TIMeout:SOURce  :TRIGger:TIMeout:SLOPe  :TRIGger:TIMeout:TIME  :TRIGger:TIMeout:LEVel :TRIGger:TIMeout:SOURce Syntax :TRIGger:TIMeout:SOURce :TRIGger:TIMeout:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of Timeout trigger.
PAGE 195
Chapter 2 Command System RIGOL :TRIGger:TIMeout:TIME Syntax :TRIGger:TIMeout:TIME :TRIGger:TIMeout:TIME? Description Parameter Return Format Example Sets or queries the timeout value of Timeout trigger. The default unit is s. Name Type Range Default Real 16 ns to 1 s 1 μs The query returns the timeout value in scientific notation. :TRIGger:TIMeout:TIME 0.002 :TRIGger:TIMeout:TIME? /*Sets the timeout value to 2 ms.*/ /*The query returns 2.000000E-3.
PAGE 196
Chapter 2 Command System RIGOL :TRIGger:RUNT Command List:  :TRIGger:RUNT:SOURce  :TRIGger:RUNT:POLarity  :TRIGger:RUNT:WHEN  :TRIGger:RUNT:WUPPer  :TRIGger:RUNT:WLOWer  :TRIGger:RUNT:ALEVel  :TRIGger:RUNT:BLEVel :TRIGger:RUNT:SOURce Syntax :TRIGger:RUNT:SOURce :TRIGger:RUNT:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of Runt trigger.
PAGE 197
Chapter 2 Command System RIGOL :TRIGger:RUNT:WHEN Syntax :TRIGger:RUNT:WHEN :TRIGger:RUNT:WHEN? Description Parameter Remarks Return Format Example Sets or queries the qualifier of Runt trigger. Name Type Range Default Discrete {NONE|GREater|LESS|GLESs} NONE  NONE: indicates not setting the trigger condition of Runt trigger.  GREater: triggers when the Runt pulse width is greater than the set lower limit of pulse width.
PAGE 198
Chapter 2 Command System RIGOL :TRIGger:RUNT:WLOWer Syntax :TRIGger:RUNT:WLOWer :TRIGger:RUNT:WLOWer? Description Parameter Remarks Return Format Example Sets or queries the lower limit of the pulse width of Runt trigger. The default unit is s. Name Type Range Default Real 8 ns to 9.9 s 8 ns  This command is only available when the qualifier is set to GREater or GLESs.
PAGE 199
Chapter 2 Command System RIGOL :TRIGger:WINDows Command List:  :TRIGger:WINDows:SOURce  :TRIGger:WINDows:SLOPe  :TRIGger:WINDows:POSition  :TRIGger:WINDows:TIME  :TRIGger:WINDows:ALEVel  :TRIGger:WINDows:BLEVel :TRIGger:WINDows:SOURce Syntax :TRIGger:WINDows:SOURce :TRIGger:WINDows:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of Window trigger.
PAGE 200
Chapter 2 Command System RIGOL :TRIGger:WINDows:POSition Syntax :TRIGger:WINDows:POSition :TRIGger:WINDows:POSition? Description Parameter Remarks Return Format Example Sets or queries the trigger position of Window trigger. Name Type Range Default Discrete {EXIT|ENTER|TIME} ENTER  EXIT: triggers when the input signal exits the specified trigger level range.  ENTER: triggers when the input signal enters the specified trigger level range.
PAGE 201
Chapter 2 Command System RIGOL :TRIGger:WINDows:BLEVel Syntax :TRIGger:WINDows:BLEVel :TRIGger:WINDows:BLEVel? Description Parameter Remarks Return Format Example Sets or queries the lower limit of the trigger level of Window trigger. The unit is the same as that of the current amplitude. Name Type Range Default Real (-5 × VerticalScale - OFFSet) to upper limit 0V For VerticalScale, refer to the :CHANnel:SCALe command; for OFFSet, refer to the :CHANnel:OFFSet command.
PAGE 202
Chapter 2 Command System RIGOL :TRIGger:DELay Command List:  :TRIGger:DELay:SA  :TRIGger:DELay:SLOPa  :TRIGger:DELay:SB  :TRIGger:DELay:SLOPb  :TRIGger:DELay:TYPE  :TRIGger:DELay:TUPPer  :TRIGger:DELay:TLOWer  :TRIGger:DELay:ALEVel  :TRIGger:DELay:BLEVel :TRIGger:DELay:SA Syntax :TRIGger:DELay:SA :TRIGger:DELay:SA? Description Parameter Return Format Example Sets or queries the trigger source of Source A in Delay trigger.
PAGE 203
Chapter 2 Command System RIGOL :TRIGger:DELay:SB Syntax :TRIGger:DELay:SB :TRIGger:DELay:SB? Description Parameter Return Format Example Sets or queries the trigger source of Source B in Delay trigger. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1|CHANn el2|CHANnel3|CHANnel4} CHANnel2 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, CHAN3, or CHAN4.
PAGE 204
Chapter 2 Command System RIGOL Return Format Example The query returns GRE, LESS, GLES, or GOUT. :TRIGger:DELay:TYPE GOUT :TRIGger:DELay:TYPE? /*Sets the delay type to "><".*/ /*The query returns GOUT.*/ :TRIGger:DELay:TUPPer Syntax :TRIGger:DELay:TUPPer :TRIGger:DELay:TUPPer? Description Parameter Remarks Return Format Example Sets or queries the upper limit of delay time of the Delay trigger. The default unit is s. Name Type Range Default Real 8.
PAGE 205
Chapter 2 Command System Return Format Example RIGOL The query returns the upper limit of the trigger level in scientific notation. :TRIGger:DELay:ALEVel 0.16 :TRIGger:DELay:ALEVel? /*Sets the upper limit of the trigger level to 160 mV.*/ /*The query returns 1.600000E-1.*/ :TRIGger:DELay:BLEVel Syntax :TRIGger:DELay:BLEVel :TRIGger:DELay:BLEVel? Description Parameter Remarks Return Format Example Sets or queries the lower limit of the trigger level of Delay trigger.
PAGE 206
Chapter 2 Command System RIGOL :TRIGger:SHOLd Command List:  :TRIGger:SHOLd:DSrc  :TRIGger:SHOLd:CSRC  :TRIGger:SHOLd:SLOPe  :TRIGger:SHOLd:PATTern  :TRIGger:SHOLd:TYPE  :TRIGger:SHOLd:STIMe  :TRIGger:SHOLd:HTIMe  :TRIGger:SHOLd:DLEVel  :TRIGger:SHOLd:CLEVel :TRIGger:SHOLd:DSrc Syntax :TRIGger:SHOLd:DSRC :TRIGger:SHOLd:DSRC? Description Parameter Return Format Example Sets or queries the data source of Setup&Hold trigger.
PAGE 207
Chapter 2 Command System RIGOL :TRIGger:SHOLd:SLOPe Syntax :TRIGger:SHOLd:SLOPe :TRIGger:SHOLd:SLOPe? Description Parameter Return Format Example Sets or queries the edge type of Setup&Hold trigger. Name Type Range Default Discrete {POSitive|NEGative} POSitive The query returns POS or NEG. :TRIGger:SHOLd:SLOPe NEGative :TRIGger:SHOLd:SLOPe? /*Sets the edge type to NEGative.*/ /*The query returns NEG.
PAGE 208
Chapter 2 Command System RIGOL :TRIGger:SHOLd:STIMe Syntax :TRIGger:SHOLd:STIMe :TRIGger:SHOLd:STIMe? Description Parameter Remarks Return Format Example Sets or queries the setup time of Setup&Hold trigger. The default unit is s. Name Type Range Default Real 8 ns to 1 s 1 μs  Setup time indicates the time that the data remain stable and unchanged before the clock signal of the trigger comes.  This command is only available when the hold type is SETup or SETHOld.
PAGE 209
Chapter 2 Command System RIGOL :TRIGger:SHOLd:CLEVel Syntax :TRIGger:SHOLd:CLEVel :TRIGger:SHOLd:CLEVel? Description Parameter Remarks Return Format Example Sets or queries the trigger level of the clock source. The unit is the same as that of the current amplitude. Name Type Range Default Real (-5 × VerticalScale - OFFSet) to (5 × VerticalScale - OFFSet) 0V For VerticalScale, refer to the :CHANnel:SCALe command; for OFFSet, refer to the :CHANnel:OFFSet command.
PAGE 210
Chapter 2 Command System RIGOL :TRIGger:NEDGe Command List:  :TRIGger:NEDGe:SOURce  :TRIGger:NEDGe:SLOPe  :TRIGger:NEDGe:IDLE  :TRIGger:NEDGe:EDGE  :TRIGger:NEDGe:LEVel :TRIGger:NEDGe:SOURce Syntax :TRIGger:NEDGe:SOURce :TRIGger:NEDGe:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of the Nth Edge trigger.
PAGE 211
Chapter 2 Command System RIGOL :TRIGger:NEDGe:IDLE Syntax :TRIGger:NEDGe:IDLE :TRIGger:NEDGe:IDLE? Description Parameter Return Format Example Sets or queries the idle time of the Nth Edge trigger. The default unit is s. Name Type Range Default Real 16 ns to 1 s 1 μs The query returns the idle time in scientific notation. :TRIGger:NEDGe:IDLE 0.002 :TRIGger:NEDGe:IDLE? /*Sets the idle time to 2 ms.*/ /*The query returns 2.000000E-3.
PAGE 212
Chapter 2 Command System RIGOL :TRIGger:RS232 (Option) Command List:  :TRIGger:RS232:SOURce  :TRIGger:RS232:WHEN  :TRIGger:RS232:PARity  :TRIGger:RS232:STOP  :TRIGger:RS232:DATA  :TRIGger:RS232:WIDTh  :TRIGger:RS232:BAUD  :TRIGger:RS232:LEVel :TRIGger:RS232:SOURce Syntax :TRIGger:RS232:SOURce :TRIGger:RS232:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of RS232 trigger.
PAGE 213
Chapter 2 Command System RIGOL :TRIGger:RS232:PARity Syntax :TRIGger:RS232:PARity :TRIGger:RS232:PARity? Description Parameter Return Format Example Sets or queries the check mode of RS232 trigger. Name Type Range Default Discrete {EVEN|ODD|NONE} NONE The query returns EVEN, ODD, or NONe. :TRIGger:RS232:PARity EVEN :TRIGger:RS232:PARity? /*Sets the check mode to Even.*/ /*The query returns EVEN.
PAGE 214
Chapter 2 Command System RIGOL :TRIGger:RS232:WIDTh Syntax :TRIGger:RS232:WIDTh :TRIGger:RS232:WIDTh? Description Parameter Return Format Example Sets or queries the data width of RS232 trigger when the trigger condition is "Data". Name Type Range Default Discrete {5|6|7|8} 8 The query returns 5, 6, 7, or 8. :TRIGger:RS232:WIDTh 6 :TRIGger:RS232:WIDTh? /*Sets the data width to 6.*/ /*The query returns 6.
PAGE 215
Chapter 2 Command System RIGOL :TRIGger:IIC (Option) Command List:  :TRIGger:IIC:SCL  :TRIGger:IIC:SDA  :TRIGger:IIC:WHEN  :TRIGger:IIC:AWIDth  :TRIGger:IIC:ADDRess  :TRIGger:IIC:DIRection  :TRIGger:IIC:DATA  :TRIGger:IIC:CLEVel  :TRIGger:IIC:DLEVel :TRIGger:IIC:SCL Syntax :TRIGger:IIC:SCL :TRIGger:IIC:SCL? Description Parameter Return Format Example Sets or queries the source channel of the clock line of I2C trigger.
PAGE 216
Chapter 2 Command System RIGOL :TRIGger:IIC:WHEN Syntax :TRIGger:IIC:WHEN :TRIGger:IIC:WHEN? Description Parameter Remarks Return Format Example Sets or queries the trigger condition of I2C trigger. Name Type Range Default Discrete {STARt|RESTart|STOP|NACKnowledge|ADD Ress|DATA|ADATa} STARt  STARt: indicates that the oscilloscope triggers when SCL is high level and SDA transitions from high level to low level.
PAGE 217
Chapter 2 Command System RIGOL :TRIGger:IIC:ADDRess Syntax :TRIGger:IIC:ADDRess
:TRIGger:IIC:ADDRess? Description Parameter Remarks Return Format Example Sets or queries the address of I2C trigger when the trigger condition is "ADDRess" or "ADATa". Name Type Range Default Integer 0 to 2n - 1: 0 to 127, 0 to 255, or 0 to 1,023 0 n In the expression 2 -1, n indicates the current address width. The query returns an integer.
PAGE 218
Chapter 2 Command System RIGOL :TRIGger:IIC:CLEVel Syntax :TRIGger:IIC:CLEVel :TRIGger:IIC:CLEVel? Description Parameter Remarks Return Format Example Sets or queries the trigger level of the clock line in I2C trigger. The unit is the same as that of the current amplitude. Name Type Range Default Real (-5 × VerticalScale - OFFSet) to (5 × VerticalScale - OFFSet) 0V For VerticalScale, refer to the :CHANnel:SCALe command; for OFFSet, refer to the :CHANnel:OFFSet command.
PAGE 219
Chapter 2 Command System RIGOL :TRIGger:CAN (Option) Command List:  :TRIGger:CAN:BAUD  :TRIGger:CAN:SOURce  :TRIGger:CAN:STYPe  :TRIGger:CAN:WHEN  :TRIGger:CAN:SPOint  :TRIGger:CAN:LEVel :TRIGger:CAN:BAUD Syntax :TRIGger:CAN:BAUD :TRIGger:CAN:BAUD? Description Parameter Remarks Return Format Example Sets or queries the signal rate of CAN trigger. The unit is bps.
PAGE 220
Chapter 2 Command System RIGOL :TRIGger:CAN:STYPe Syntax :TRIGger:CAN:STYPe :TRIGger:CAN:STYPe? Description Parameter Return Format Remarks Example Sets or queries the signal type of CAN trigger. Name Type Range Default Discrete {H|L|RXTX|DIFFerential} H The query returns H, L, RXTX, or DIFF.  H: indicates the actual CAN_H differential bus signal.  L: indicates the actual CAN_L differential bus signal.
PAGE 221
Chapter 2 Command System RIGOL :TRIGger:CAN:SPOint Syntax :TRIGger:CAN:SPOint :TRIGger:CAN:SPOint? Description Parameter Remarks Return Format Example Sets or queries the sample point position of CAN trigger (expressed in %). Name Type Range Default Integer 10 to 90 50 Sample point is a point within a bit’s time. The oscilloscope samples the bit level at this point.
PAGE 222
Chapter 2 Command System RIGOL :TRIGger:SPI (Option) Command List:  :TRIGger:SPI:SCL  :TRIGger:SPI:SDA  :TRIGger:SPI:WHEN  :TRIGger:SPI:WIDTh  :TRIGger:SPI:DATA  :TRIGger:SPI:TIMeout  :TRIGger:SPI:SLOPe  :TRIGger:SPI:CLEVel  :TRIGger:SPI:DLEVel  :TRIGger:SPI:SLEVel  :TRIGger:SPI:MODE  :TRIGger:SPI:CS :TRIGger:SPI:SCL Syntax :TRIGger:SPI:SCL :TRIGger:SPI:SCL? Description Parameter Return Format Example Sets or queries the channel source of the clock line of
PAGE 223
Chapter 2 Command System RIGOL :TRIGger:SPI:WHEN Syntax :TRIGger:SPI:WHEN :TRIGger:SPI:WHEN? Description Parameter Remarks Sets or queries the trigger condition of SPI trigger. Name Type Range Default Discrete {CS|TIMeout} CS When the trigger condition is "TIMeout", you can run the :TRIGger:SPI:TIMeout command to set the timeout value. Return Format The query returns CS or TIM. Example :TRIGger:SPI:WHEN TIMeout :TRIGger:SPI:WHEN? /*Sets the trigger condition to TIMeout.
PAGE 224
Chapter 2 Command System RIGOL :TRIGger:SPI:TIMeout Syntax :TRIGger:SPI:TIMeout :TRIGger:SPI:TIMeout? Description Parameter Return Format Example Sets or queries the timeout value when the trigger condition of SPI trigger is "Timeout". The default unit is s. Name Type Range Default Real 16 ns to 1 s 1 μs The query returns the timeout value in scientific notation. :TRIGger:SPI:TIMeout 0.001 :TRIGger:SPI:TIMeout? /*Sets the timeout value to 1 ms.*/ /*The query returns 1.
PAGE 225
Chapter 2 Command System RIGOL :TRIGger:SPI:DLEVel Syntax :TRIGger:SPI:DLEVel :TRIGger:SPI:DLEVel? Description Parameter Remarks Return Format Example Sets or queries the trigger level of the data channel of SPI trigger. The unit is the same as that of the current amplitude. Name Type Range Default Real (-5 × VerticalScale - OFFSet) to (7 × VerticalScale - OFFSet) 0V For VerticalScale, refer to the :CHANnel:SCALe command; for OFFSet, refer to the :CHANnel:OFFSet command.
PAGE 226
Chapter 2 Command System RIGOL :TRIGger:SPI:CS Syntax :TRIGger:SPI:CS :TRIGger:SPI:CS? Description Parameter Return Format Example Sets or queries the source channel of the CS line when the trigger condition of SPI is set to CS.
PAGE 227
Chapter 2 Command System RIGOL :TRIGger:FLEXray (Option) Command List:  :TRIGger:FLEXray:BAUD  :TRIGger:FLEXray:LEVel  :TRIGger:FLEXray:SOURce  :TRIGger:FLEXray:WHEN :TRIGger:FLEXray:BAUD Syntax :TRIGger:FLEXray:BAUD :TRIGger:FLEXray:BAUD? Description Parameter Return Format Example Sets or queries the signal rate of FlexRay trigger. The default unit is bps.
PAGE 228
Chapter 2 Command System RIGOL :TRIGger:FLEXray:SOURce Syntax :TRIGger:FLEXray:SOURce :TRIGger:FLEXray:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of FlexRay trigger. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D 11|D12|D13|D14|D15|CHANnel1|CHANnel2 |CHANnel3|CHANnel4} CHANnel1 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, CHAN3, or CHAN4.
PAGE 229
Chapter 2 Command System RIGOL :TRIGger:IIS (Option) Command List:  :TRIGger:IIS:ALIGnment  :TRIGger:IIS:CLOCk:SLOPe  :TRIGger:IIS:SOURce:CLOCk  :TRIGger:IIS:SOURce:DATA  :TRIGger:IIS:SOURce:WSELect  :TRIGger:IIS:WHEN  :TRIGger:IIS:AUDio  :TRIGger:IIS:DATA :TRIGger:IIS:ALIGnment Syntax :TRIGger:IIS:ALIGnment :TRIGger:IIS:ALIGnment? Description Parameter Description Return Format Example Sets or queries the alignment mode of the I2S trigger.
PAGE 230
Chapter 2 Command System RIGOL :TRIGger:IIS:SOURce:CLOCk Syntax :TRIGger:IIS:SOURce:CLOCk :TRIGger:IIS:SOURce:CLOCk? Description Parameter Return Format Example Sets or queries the clock source of the I2S trigger. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D 10|D11|D12|D13|D14|D15|CHANnel1| CHANnel2|CHANnel3|CHANnel4|EXT} CHANnel1 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, CHAN3, CHAN4, or EXT.
PAGE 231
Chapter 2 Command System RIGOL :TRIGger:IIS:WHEN Syntax :TRIGger:IIS:WHEN :TRIGger:IIS:WHEN? Description Parameter Description Return Format Example Sets or queries the trigger condition of I2S trigger. Name Type Discrete Range {EQUal|NOTequal|LESSthan|GREaterthan| INRange|OUTRange} Default EQUal  EQUal: triggers on when the channel's data value equals the set value.  NOTequal: triggers on when the channel's data value does not equal the set value.
PAGE 232
Chapter 2 Command System RIGOL :TRIGger:IIS:DATA Syntax :TRIGger:IIS:DATA :TRIGger:IIS:DATA? Description Parameter Sets or queries the data value of the I2S trigger. Name Description Return Format Example 2-218 Type Integer Range Default 32 0 to 2 -1 The settable range of is affected by the byte length. The maximum byte length can be set to 4, i.g. 32-bit binary data. Therefore, the range of is from 0 to 232 - 1.
PAGE 233
Chapter 2 Command System RIGOL :TRIGger:LIN (Option) Command List:  :TRIGger:LIN:SOURce  :TRIGger:LIN:ID  :TRIGger:LIN:BAUD  :TRIGger:LIN:STANdard  :TRIGger:LIN:SAMPlepoint  :TRIGger:LIN:WHEN  :TRIGger:LIN:LEVel :TRIGger:LIN:SOURce Syntax :TRIGger:LIN:SOURce :TRIGger:LIN:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of LIN trigger.
PAGE 234
Chapter 2 Command System RIGOL :TRIGger:LIN:BAUD Syntax :TRIGger:LIN:BAUD :TRIGger:LIN:BAUD? Description Sets or queries the baud rate of LIN trigger. The default unit is bps. Parameter Remarks Return Format Example Name Type Range Default Integer 1 kbps to 20 Mbps 9600 bps If the baud rate is set to a value with "M", then "A" should be added at the end of the value. For example, if you send 5 M, you need to send 5 MA.
PAGE 235
Chapter 2 Command System RIGOL :TRIGger:LIN:WHEN Syntax :TRIGger:LIN:WHEN :TRIGger:LIN:WHEN? Description Parameter Description Return Format Example Sets or queries the trigger condition of LIN trigger. Name Type Range Default Discrete {SYNCbreak|ID|DATA|IDData|SLEep|WAKeup| ERRor} ID  SYNCbreak: triggers on the last bit of the sync field.  ID: triggers when the frames with the specified ID are found.
PAGE 236
Chapter 2 Command System RIGOL :TRIGger:M1553 (Option) Command List:  :TRIGger:M1553:SOURce  :TRIGger:M1553:WHEN  :TRIGger:M1553:POLarity  :TRIGger:M1553:ALEVel  :TRIGger:M1553:BLEVel :TRIGger:M1553:SOURce Syntax :TRIGger:M1553:SOURce :TRIGger:M1553:SOURce? Description Parameter Return Format Example Sets or queries the trigger source of M1553 trigger.
PAGE 237
Chapter 2 Command System RIGOL :TRIGger:M1553:POLarity Syntax :TRIGger:M1553:POLarity :TRIGger:M1553:POLarity? Description Parameter Return Format Example Sets or queries the polarity of M1553 trigger. Name Type Range Default Discrete {POSitive|NEGative} POSitive The query returns POS or NEG. :TRIGger:M1553:POLarity POSitive /*Sets the polarity of M1553 trigger to POSitive.*/ :TRIGger:M1553:POLarity? /*The query returns POS.
PAGE 238
Chapter 2 Command System RIGOL :WAVeform Commands The :WAVeform commands are used to read waveform data and relevant settings. The:WAVeform:MODE command is used to set the reading mode of waveform data. In different modes, the definitions for the parameters are different, as shown in Figure 2-1 and 2-2.
PAGE 239
Chapter 2 Command System  :WAVeform:MODE  :WAVeform:FORMat  :WAVeform:DATA?  :WAVeform:XINCrement?  :WAVeform:XORigin?  :WAVeform:XREFerence?  :WAVeform:YINCrement?  :WAVeform:YORigin?  :WAVeform:YREFerence?  :WAVeform:STARt  :WAVeform:STOP  :WAVeform:PREamble? RIGOL :WAVeform:SOURce Syntax :WAVeform:SOURce :WAVeform:SOURce? Description Parameter Sets or queries the source channel of waveform data reading.
PAGE 240
Chapter 2 Command System RIGOL Remarks Return Format Example  NORMal: reads the waveform data currently displayed on the screen.  MAXimum: reads the waveform data displayed on the screen when the oscilloscope is in the Run state; reads the waveform data in the internal memory when the oscilloscope is in the Stop state.  RAW: reads the waveform data in the internal memory. Note: The data in the internal memory can only be read when the oscilloscope is in the Stop state.
PAGE 241
Chapter 2 Command System S2. :WAV:MODE RAW Sets the waveform reading mode to RAW. S3. :WAV:FORM BYTE Sets the return format of the waveform data to BYTE. Reads the number of memory waveform points to 10000. Reads the waveform data from the internal memory. S4. :WAVeform:POINts 10000 S5. :WAV:DATA? Return Format RIGOL  The return format is related to the return format of the currently selected waveform data.
PAGE 242
Chapter 2 Command System RIGOL In NORMal mode, the query returns the start time of the waveform data displayed on the screen. In RAW mode, the query returns the start time of the waveform data in the internal memory. In MAX mode, the query returns the start time of the waveform data displayed on the screen when the instrument is in the RUN state; the query returns the start time of the waveform data in the internal memory when the instrument is in the Stop state.
PAGE 243
Chapter 2 Command System RIGOL :WAVeform:YREFerence? Syntax :WAVeform:YREFerence? Description Queries the vertical reference position of the currently selected channel source in the Y direction. Remarks The returned value is related to the current data reading mode. In NORMal mode, YREFerence is a fixed value 128 (screen bottom is 0 and screen top is 255). In RAW mode, YREFerence is related to the VerticalScale of the memory waveforms and the currently selected VerticalScale.
PAGE 244
Chapter 2 Command System RIGOL the start point and stop point of a reading operation are related to the memory depth of the oscilloscope and the return format of the waveform data currently selected. Return Format Example The query returns an integer. :WAVeform:STOP 500 :WAVeform:STOP? /*Sets the stop point to 500.*/ /*The query returns 500.*/ :WAVeform:PREamble? Syntax Description Return Format :WAVeform:PREamble? Queries all the waveform parameters.
PAGE 245
Chapter 3 Programming Examples RIGOL Chapter 3 Programming Examples This chapter illustrates how to control the MSO7000/DS7000 series digital oscilloscope by programming in Excel, LabVIEW, Visual Basic, and Visual C++. These instances are programmed based on Virtual Instrument Software Architecture (VISA) library.
PAGE 246
RIGOL Chapter 3 Programming Examples Programming Preparations Before programming, you need to prepare the following tasks: Install Ultra Sigma (PC) software. You can log in to the RIGOL official website (www.rigol.com) to download the software. Then install the software according to the installation wizard. After Ultra Sigma is installed successfully, NI-VISA library will be completely installed automatically. In this manual, the default installation path is C:\Program Files\IVI Foundation\VISA.
PAGE 247
Chapter 3 Programming Examples RIGOL Excel Programming Example Program used in this instance: Microsoft Excel 2007 Function realized in this example: send the *IDN? command and read the instrument information. 1. Open a new Macro-enabled Excel file and name it "MSO7000_Demo_Excel.xlsm". 2. Run the MSO7000_Demo_Excel.xlsm file. Click FileOptions at the upper-left corner of the Excel file to open the interface as shown in the figure below.
PAGE 248
RIGOL 4. Chapter 3 Programming Examples Click Tools(T) in the Microsoft Visual Basic menu bar and select References. In the displayed dialog box, select VISA Library, and click OK to refer to VISA Library. Remarks: If you cannot find VISA Library in the left section of the above dialog box, please follow the method below to find it. (1) Make sure that your PC has installed the NI-VISA library. (2) Click Browse... at the right section to search visa32.
PAGE 249
Chapter 3 Programming Examples 5. RIGOL Click View Code under Developer menu to enter the interface of Microsoft Visual Basic. Add the following codes and save it. Note: If the Excel file created in Step 2 does not enable the Macros, a prompt message "The following features cannot be saved in macro-free workbooks" will be displayed. In this case, please save the file as a macro-enabled file type (filename with a suffix of ".xlsm").
PAGE 250
RIGOL Chapter 3 Programming Examples The default name of the button is "Button1". Right-click the button and select Edit Text in the pop-up menu to change the button name to "*IDN?". 7. 3-6 Click the "*IDN?" button to send request and read data. The returned value is in CELLS(2,2) of SHEET1.
PAGE 251
Chapter 3 Programming Examples RIGOL LabVIEW Programming Example Program used in this instance: LabVIEW2010 Function realized in this example: read the waveform data of CH1 on the screen. 1. Run LabVIEW, create a VI file and name it as MSO7000_Demo. 2. Add controls and create the front panel as shown in the figure below. 3. Open the Block Diagram interface. Click Instrument I/O  VISA. Add the following functions: VISA Open, VISA Read, VISA Write, and VISA Close. 4.
PAGE 252
Chapter 3 Programming Examples RIGOL 6. The data format is TMC header + waveform data points + terminator. The TMC header is in #NXXXXXX format, wherein, # is the TMC header denoter, N represents that there are N bytes following. The length of the waveform data points is described in ASCII character, and the terminator represents the ending of the communication.
PAGE 253
Chapter 3 Programming Examples RIGOL Used to obtain the waveform data length bytes. Used to delete the terminator at the end of the waveform data. Used to transfer waveform data strings to the byte group. 7. The complete program block diagram is as shown in the figure below. 8. Select the device resource from the VISA Resource Name list box and run the program.
PAGE 254
RIGOL Chapter 3 Programming Examples Visual Basic Programming Example Program used in this example: Visual Basic 6.0 Function realized in this example: control the on/off state of any channel. Enter the Visual Basic 6.0 programming environment, and perform the following procedures. 1. Build a standard application program project (Standard EXE), and name it "Demo". 2. Click Project  Add Module to open the Add Module dialog box. In the dialog box, click the Existing tab to search for the visa32.
PAGE 255
Chapter 3 Programming Examples RIGOL Dim defrm As Long Dim vi As Long Dim strRes As String * 200 Dim list As Long Dim nmatches As Long Dim matches As String * 200 ' Reserve the obtained device number Dim s32Disp As Integer ' Obtain the usb resource of visa Call viOpenDefaultRM(defrm) Call viFindRsrc(defrm, "USB?*", list, nmatches, matches) ' Turn on the instrument Call viOpen(defrm, matches, 0, 0, vi) ' Send a command to query the status of CH1 Call viVPrintf(vi, ":CHAN1:DISP?" + Chr$(10), 0) ' Obtain the
PAGE 256
RIGOL Chapter 3 Programming Examples Visual C++ Programming Example Program used in this example: Visual C++6.0 Function realized in this example: search for the instrument address, connect to the instrument, send and read commands. Enter the Visual C++6.0 programming environment, and perform the following procedures. 1. Create a MFC project based on a dialog box. 2. Click Project  Settings to open the Project Setting dialog box.
PAGE 257
Chapter 3 Programming Examples 4. RIGOL Click Tools  Options to open the Options dialog box. Then, click the Directories tab. Select Include files from the drop-down list under Show directories for. Double click the empty space under Directories to enter the specified path of Include files: C:\Program Files\IVI Foundation\VISA\WinNT\include. Click OK to close the dialog box. Select Library files from the drop-down list under Show directories for.
PAGE 258
RIGOL Chapter 3 Programming Examples 7. Add the variables m_combox and m_receive to the Combo Box and Edit Box controls respectively. 8. Add codes. Double-click Send and Read to enter the programming environment. Declare the #include
PAGE 259
Chapter 3 Programming Examples RIGOL viOpenDefaultRM (&defaultRM); //Acquire the USB resource of VISA viFindRsrc(defaultRM, "USB?*", &list,&nmatches, matches); viOpen (defaultRM,matches,VI_NULL,VI_NULL,&vi); //Send the command received m_combox.GetLBText(m_combox.