Programming Guide MSO5000-E Series Digital Oscilloscope Sept. 2019 RIGOL (SUZHOU) TECHNOLOGIES INC.
RIGOL Guaranty and Declaration Copyright © 2019 RIGOL (SUZHOU) TECHNOLOGIES INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC. Publication Number PGA28101-1110 Software Version 00.01.01.00.03 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.
RIGOL Document Overview This manual is your guide to programming RIGOL MSO5000-E series digital oscilloscope. MSO5000-E 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.
Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 SCPI Command Overview ..................................................................................1-1 Syntax .............................................................................................
RIGOL Contents :COUNter Commands .............................................................................................................. 2-43 :COUNter:CURRent? ......................................................................................................... 2-43 :COUNter:CURRent? ......................................................................................................... 2-43 :COUNter:ENABle .......................................................................................
Contents RIGOL :LA:DIGital:DISPlay .......................................................................................................... 2-76 :LA:DIGital:POSition ......................................................................................................... 2-76 :LA:DIGital:LABel ............................................................................................................. 2-77 :LA:POD:DISPlay ...............................................................................
RIGOL Contents :MATH:FFT:SEARch:ORDer ......................................................................................... 2-98 :MATH:FILTer:TYPE .................................................................................................... 2-98 :MATH:FILTer:W1 ...................................................................................................... 2-99 :MATH:FILTer:W2 ....................................................................................................
Contents RIGOL :REFerence:COLor .......................................................................................................... 2-121 :REFerence:LABel:ENABle ............................................................................................... 2-122 :REFerence:LABel:CONTent ............................................................................................. 2-122 :SAVE and :Load Commands .........................................................................................
RIGOL Contents [:SOURce[]]:APPLy:USER ......................................................................................... 2-142 [:SOURce[]]:OUTPut[][:STATe] .......................................................................... 2-144 [:SOURce[]]:OUTPut[]:IMPedance ..................................................................... 2-144 :SYSTem Commands .............................................................................................................
Contents RIGOL :TRIGger:FLEXray (Option) ............................................................................................. 2-209 :TRIGger:IIS (Option) .................................................................................................... 2-211 :TRIGger:LIN (Option) ................................................................................................... 2-215 :TRIGger:M1553 (Option) ........................................................................................
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).
RIGOL Chapter 1 SCPI Command Overview Syntax The command line usually starts with a colon; the keywords are separated by colons, and following the keywords are the parameter settings available. The command ending with a quotation mark indicates querying a certain function. The keywords of the command and the first parameter is separated by a space. For example, :ACQuire:TYPE :ACQuire:TYPE? ACQuire is the root keyword of the command, and TYPE is the second-level keyword.
Chapter 1 SCPI Command Overview RIGOL 3. Integer Unless otherwise specified, the parameter can be any integer (NR1 format) within the effective value range. Note: Do not set the parameter to a decimal, otherwise, errors will occur. For example, :DISPlay:GBRightness :DISPlay:GBRightness? Wherein, can be set to an integer ranging from 1 to 100. The query returns an integer ranging from 1 to 100. 4.
Chapter 2 Command System RIGOL Chapter 2 Command System This chapter introduces the syntax, functions, parameters, and usage of each MSO5000-E 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.
RIGOL Chapter 2 Command System Note: 1. Unless otherwise specified, the descriptions in this manual all take MSO5152-E as an example. 2. For the parameter setting command (time, frequency, amplitude, etc.), the digital oscilloscope can only recognize the numbers, unable to recognize the unit sent together with them. The unit of the parameter is a default one. For the default units of various parameters, refer to the descriptions for the specified command.
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.
RIGOL Chapter 2 Command System :ACQuire Commands The :ACQuire commands are used to set the memory depth of the oscilloscope, the acquisition mode, the average times, as well as query the current sample rate. Command List[1]: :ACQuire:AVERages :ACQuire:MDEPth :ACQuire:TYPE :ACQuire:SRATe? :ACQuire:LA:SRATe? :ACQuire:AALias Note[1]: In the "Command List" in this manual, the query commands and the parameters in the setting commands are omitted.
RIGOL Chapter 2 Command System depth for the all-channel is 50 M. Return Format Example The query returns AUTO, 1k, 10k, 100k, 1M, 10M, 25M, 50M, or 100M. :ACQuire:MDEPth 1M :ACQuire:MDEPth? /*Sets the memory depth to 1M.*/ /*The query returns 1M.*/ :ACQuire:TYPE Syntax :ACQuire:TYPE :ACQuire:TYPE? Description Sets or queries the acquisition mode of the oscilloscope.
RIGOL Return Format Example Chapter 2 Command System 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. The default unit is Sa/s. The query returns the sample rate in scientific notation. :ACQuire:LA:SRATe? /*The query returns 1.250000E+9.
RIGOL Chapter 2 Command System :BUS Commands The : BUS commands are used to execute the decoding-related settings and operations.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :BUS:LABel Syntax :BUS:LABel :BUS:LABel? Description Parameter Remarks Return Format Example Enables or disables the label of the specified decoding bus; or queries the on/off status of the label of the specified decoding bus. 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.
RIGOL Chapter 2 Command System :BUS:EEXPort Syntax Description Parameter Example :BUS:EEXPort Exports the decoding information in the specified decoding bus event table in CSV form. Name Type Range Default Discrete {1|2|3|4} —— :BUS1:EEXPort C:/123.csv /*Exports the decoding information in the bus event table to the local Disk C, with the filename 123.csv.
RIGOL Chapter 2 Command System :BUS:PARallel The :BUS:PARallel commands are used to set relevant parameters for Parallel decoding.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System Remarks Return Format Example 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.
RIGOL Chapter 2 Command System :BUS:RS232 (Option) The :BUS:RS232 commands are used to set relevant parameters for RS232 decoding.
RIGOL Chapter 2 Command System :BUS:RS232:POLarity Syntax :BUS:RS232:POLarity :BUS:RS232:POLarity? Description Parameter Remarks Sets or queries the polarity of RS232 decoding. Name Type Range Default Discrete {1|2|3|4} —— Discrete {POSitive|NEGative} NEGative The RS232 standard uses "Negative Logic", i.g. high level is Logic 0 and low level is Logic 1.
RIGOL Chapter 2 Command System Parameter Remarks Return Format Example 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. The query returns an integer ranging from 1 bps to 20 Mbps. :BUS1:RS232:BAUD 4800 /*Sets the baud rate of data transmission in RS232 decoding to 4800 bps.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :BUS:SPI (Option) The :BUS:SPI commands are used to set relevant parameters for SPI decoding.
RIGOL Chapter 2 Command System Example :BUS1:SPI:SCLK:SLOPe NEGative :BUS1:SPI:SCLK:SLOPe? /*Sets the clock edge type of SPI decoding to NEGative.*/ /*The query returns NEG.*/ :BUS:SPI:MISO:SOURce Syntax :BUS:SPI:MISO:SOURce
RIGOL Chapter 2 Command System Return Format Example The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, or OFF. :BUS1:SPI:MOSI:SOURce D0 :BUS1:SPI:MOSI:SOURce? /*Sets the MOSI data source of SPI decoding to D0.*/ /*The query returns D0.*/ :BUS:SPI:MOSI:POLarity Syntax :BUS:SPI:MOSI:POLarity :BUS:SPI:MOSI:POLarity? Description Parameter Remarks Return Format Example Sets or queries the polarity of MOSI data line of SPI decoding.
RIGOL Chapter 2 Command System the data is transmitted first. Return Format Example LSB: indicates Least Significant Bit transmission sequence, i.g. the lowest bit of the data is transmitted first. The query returns MSB or LSB. :BUS1:SPI:ENDian LSB /*Sets the endian of data transmission of SPI decoding to LSB.*/ :BUS1:SPI:ENDian? /*The query returns LSB.
RIGOL Chapter 2 Command System :BUS:SPI:SS:SOURce Syntax :BUS:SPI:SS:SOURce
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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} CHANnel1 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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. Name Type Range Default Discrete {1|2|3|4} —— Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D1 1|D12|D13|D14|D15|CHANnel1|CHANnel2} CHANnel1 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.
RIGOL Chapter 2 Command System :BUS:IIS:RWIDth Syntax :BUS:IIS:RWIDth :BUS:IIS:RWIDth? Description Parameter Return Format Example 2-36 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? /*Sets the word size of I2S decoding to 5.*/ /*The query returns 5.
RIGOL Chapter 2 Command System :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 Sets or queries the source of the M1553 decoding. Name Type Range Default Discrete {1|2|3|4} —— Discrete {CHANnel1|CHANnel2} CHANnel1 The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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} 1 Discrete {AC|DC|GND} 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.
RIGOL Chapter 2 Command System Return Format The query returns 1 or 0. Example :CHANnel1:INVert ON :CHANnel1:INVert? /*Enables the waveform invert for CH1.*/ /*The query returns 1.*/ :CHANnel:OFFSet Syntax :CHANnel:OFFSet :CHANnel:OFFSet? Description Parameter Return Format Example Sets or queries the vertical offset of the specified channel. The default unit is V. Name Type Range Default Discrete 1 Real {1|2} ±1 V (1 mV/div to 50 mV/div).
RIGOL Chapter 2 Command System :CHANnel:SCALe Syntax :CHANnel:SCALe :CHANnel:SCALe? Description Parameter Remarks Return Format Example Sets or queries the vertical scale of the specified channel. The default unit is V. Name Type Range Default Discrete {1|2} 1 Real The probe ratio is 1X: 500µV to 10 V 100 mV You can use the :CHANnel:VERNier command to enable or disable the fine adjustment setting for the vertical scale of the specified channel.
RIGOL Chapter 2 Command System :CHANnel:UNITs Syntax :CHANnel:UNITs :CHANnel:UNITs? Description Parameter Return Format Example Sets or queries the amplitude display unit of the specified analog channel. Name Type Range Default Discrete {1|2} 1 Discrete {VOLTage|WATT|AMPere|UNKNown} VOLTage The query returns VOLT, WATT, AMP, or UNKN. :CHANnel1:UNITs VOLTage :CHANnel1:UNITs? /*Sets the amplitude display unit of CH1 to VOLTage.*/ /*The query returns VOLT.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System Example :COUNter:SOURce CHANnel2 /*Sets the source of the frequency counter to CHANnel2.*/ :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.
RIGOL Chapter 2 Command System 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".
RIGOL Chapter 2 Command System :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. Command List: :CURSor:MODE :CURSor:MANual :CURSor:TRACk :CURSor:XY :CURSor:MODE Syntax :CURSor:MODE :CURSor:MODE? Description Parameter Remarks Return Format Example 2-46 Sets or queries the mode of the cursor measurement.
RIGOL Chapter 2 Command System :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
RIGOL Chapter 2 Command System :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|MATH1|MATH2|MATH3 |MATH4|LA|NONE} CHANnel1 Only the currently enabled channel can be selected as the channel source.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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).
RIGOL Chapter 2 Command System :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).
RIGOL Chapter 2 Command System :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, MATH1, MATH2, MATH3, or MATH4, the query returns the Y value at Cursor B in scientific notation.
RIGOL Chapter 2 Command System :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
RIGOL Chapter 2 Command System :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|MATH1|MATH2|MATH3 |MATH4|NONE} CHANnel1 Only the currently enabled channel can be selected as the channel source. The query returns CHAN1, CHAN2, MATH1, MATH2, MATH3, MATH4, or NONE.
RIGOL Chapter 2 Command System :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).
RIGOL Chapter 2 Command System :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.
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.
RIGOL Chapter 2 Command System :CURSor:XY The :CURSor:XY command is only available when the horizontal time base mode is set to XY.
RIGOL Chapter 2 Command System :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).
RIGOL Chapter 2 Command System :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).
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :DISPlay:GRADing:TIME Syntax :DISPlay:GRADing:TIME
RIGOL Chapter 2 Command System scale 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.
RIGOL Chapter 2 Command System :DISPlay:COLor Syntax :DISPlay:COLor :DISPlay:COLor? Description Parameter Return Format Example 2-64 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :DVM:MODE Syntax :DVM:MODE :DVM:MODE? Description Parameter Description Return Format Example 2-66 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :HISTogram:SOURce Syntax :HISTogram:SOURce :HISTogram:SOURce? Description Parameter Return Format Example Sets or queries the source of the histogram. Name Type Discrete Range Default {CHANnel1|CHANnel2|MATH1|MATH2| MATH3|MATH4|OFF} OFF The query returns CHAN1, CHAN2, MATH1, MATH2, MATH3, MATH4, or OFF. :HISTogram:SOURce CHANnel2 /*Sets the source of the histogram to CHANnel2.*/ :HISTogram:SOURce? /*The query returns CHAN2.
RIGOL Chapter 2 Command System :HISTogram:RESet Syntax Description :HISTogram:RESet Resets the statistics. :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.
RIGOL Chapter 2 Command System :HISTogram:TLIMit Syntax :HISTogram:TLIMit :HISTogram:TLIMit? Description Parameter Sets or queries the histogram's top boundary limit. Name Return Format Example 2-70 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.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System *ESR? Syntax Description *ESR? Queries and clears the event register of the standard event status register. Remarks Bit 1 and Bit 6 in the standard event status register are not used and are always treated 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.
RIGOL Chapter 2 Command System *RST Syntax Description *RST Restores the instrument to its factory default settings. *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.
RIGOL Chapter 2 Command System :LA Commands The :LA commands are used to perform relevant operations on the digital channels. PLA2216 active logic probe option is required to be ordered.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :LA:DIGital:LABel Syntax :LA:DIGital:LABel ,
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System :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).
RIGOL Chapter 2 Command System :LAN Commands The :LAN commands are used to set and query the LAN parameters.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System 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.
Chapter 2 Command System RIGOL :LAN:APPLy Syntax Description :LAN:APPLy Applies the network configuration.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System /*Sets the measurement source of the pass/fail test to CHANnel2.*/ :MASK:SOURce? /*The query returns CHAN2.*/ :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.
RIGOL Chapter 2 Command System :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.
Chapter 2 Command System RIGOL :MATH Commands The :MATH commands are used to set various math operation function of the waveform between channels.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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} CHANnel1 For arithmetic operation, this command is used to set Source A. For function operation, use this command only to set the source.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System Parameter Return Format Example 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. :MATH1:OFFSet 8 :MATH1:OFFSet? /*Sets the vertical offset to 8 V.*/ /*The query returns 8.000000E0.
RIGOL Chapter 2 Command System :MATH:FFT:WINDow Syntax :MATH:FFT:WINDow :MATH:FFT:WINDow? Description Parameter Remarks Return Format Example Sets or queries the window function of FFT operation. Name Type Range Default Discrete {1|2|3|4} —— Discrete {RECTangle|BLACkman|HANNing|HAMMing| FLATtop|TRIangle} RECTangle Spectral leakage can be considerably decreased when a window function is used.
RIGOL Chapter 2 Command System Example :MATH1:FFT:SCALe 0.3 /*Sets the vertical scale of the FFT operation results to 300 mdB.*/ :MATH1:FFT:SCALe? /*The query returns 3.000000E-1.*/ :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.
RIGOL Chapter 2 Command System Return Format Example The query returns the current center frequency in scientific notation. :MATH1:FFT:HCENter 10000000 :MATH1:FFT:HCENter? /*Sets the center frequency of the FFT operation results to 10 MHz.*/ /*The query returns 1.000000E+7.*/ :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.
RIGOL Chapter 2 Command System :MATH:FFT:SEARch:ENABle Syntax :MATH:FFT:SEARch:ENABle :MATH:FFT:SEARch:ENABle? Description Parameter Return Format Example Enables or disables the FFT peak search; or queries the on/off status of the FFT peak search function. Name Type Range Default Discrete {1|2|3|4} —— Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0. :MATH1:FFT:SEARch:ENABle ON :MATH1:FFT:SEARch:ENABle? /*Enables the FFT peak search.
RIGOL Chapter 2 Command System :MATH:FFT:SEARch:EXCursion Syntax :MATH:FFT:SEARch:EXCursion :MATH:FFT:SEARch:EXCursion? Description Parameter Remarks Return Format Example Sets or queries the excursion of the FFT peak search. Name Type Range Default Discrete {1|2|3|4} —— Real 0 to (8xVerticalScale) 1.8 dB VerticalScale indicates the vertical scale of the current source. The query returns the excursion of the FFT peak search in scientific notation.
RIGOL Chapter 2 Command System are smaller than the current cut-off frequency to pass. Return Format Example HPASs: indicates high pass filter, which only allows the signals whose frequencies are greater than the current cut-off frequency to pass. BPASs: indicates band pass filter, which only allows the signals whose frequencies are greater than the current cut-off frequency 1 and smaller than the current cut-off frequency 2 to pass.
RIGOL Chapter 2 Command System :MATH:FILTer:W2 Syntax :MATH:FILTer:W2 :MATH:FILTer:W2? Description Parameter Remarks Return Format Example Sets or queries the cut-off frequency 2 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 0.1×screen sample rate When the filter type is set to BPASs (Band Pass Filter) or BSTop (Band Stop Filter), you need to set two cut-off frequencies.
RIGOL Chapter 2 Command System Return Format Example The query returns an integer ranging from 5 to 10000. :MATH1:DISTance 20/*Sets the smoothing window width of differential operation to 20.*/ :MATH1:DISTance? /*The query returns 20.*/ :MATH:THReshold1 Syntax :MATH:THReshold1 :MATH:THReshold1? Description Parameter Description Return Format Example Sets or queries threshold level of Analog Channel 1 in the logic operation. The default unit is V.
RIGOL Example 2-102 Chapter 2 Command System :MATH1:THReshold2 0.8 /*Sets the threshold level of Analog Channel 2 in logic operation to 800 mV.*/ :MATH1:THReshold2? /*The query returns 8.000000E-1.
RIGOL Chapter 2 Command System :MEASure Commands The :MEASure commands are used to set and query the relevant parameters for measurement.
RIGOL Chapter 2 Command System Return Format Example The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, MATH1, MATH2, MATH3, or MATH4. :MEASure:SOURce CHANnel2 /*Sets the channel source for the parameter to CHANnel2.*/ :MEASure:SOURce? /*The query returns CHAN2.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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|OFF} OFF The query returns CHAN1, CHAN2, or OFF. :MEASure:AMSource CHANnel1 :MEASure:AMSource? /*Sets the source to CHANnel1.*/ /*The query returns CHAN1.
RIGOL Chapter 2 Command System Format Example :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.
RIGOL Chapter 2 Command System :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. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D 12|D13|D14|D15|CHANnel1|CHANnel2|MATH1| MATH2|MATH3|MATH4} CHANnel2 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, MATH1, MATH2, MATH3, or MATH4.
RIGOL Chapter 2 Command System Return Format Example The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, MATH1, MATH2, MATH3, or MATH4. :MEASure:SETup:DSB CHANnel2 /*Sets Source B of the delay measurement to CHANnel2.*/ :MEASure:SETup:DSB? /*The query returns CHAN2.
RIGOL Chapter 2 Command System Remarks Return Format Example Discrete {MAXimum|MINimum|CURRent|AVERages |DEViation|CNT} —— The parameter [,[,]] is used to set the source of the parameter under measurement.
RIGOL Chapter 2 Command System must contain two sources. Otherwise, the command is invalid. Return Format Example The query returns the current measurement value in scientific notation. :MEASure:ITEM OVERshoot,CHANnel2 :MEASure:ITEM? OVERshoot,CHANnel2 /*Enables the overshoot measurement of CH2.*/ /*The query returns 8.888889E-3.*/ :MEASure:AREA Syntax :MEASure:AREA :MEASure:AREA? Description Parameter Remarks Return Format Example Sets or queries the type of the measurement range.
RIGOL Chapter 2 Command System :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).
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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} CHANnel1 The query returns CHAN1 or CHAN2. :POWer:VOLTagesource CHANnel2 :POWer:VOLTagesource? /*Sets the voltage source to CHANnel2.*/ /*The query returns CHAN2.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :Quick Command The :Quick command is 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 Return Format Example 2-116 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :REFerence Commands The :REFerence commands are used to set relevant parameters for reference waveforms.
RIGOL Chapter 2 Command System Example :REFerence:SOURce 1,CHANnel1 /*Sets the source of the reference channel 1 to CHANnel1.*/ :REFerence: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.]
RIGOL Chapter 2 Command System :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.]
RIGOL Chapter 2 Command System :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 [ Discrete {1|2|3|4|5|6|7|8|9|10} —— Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0. :REFerence:LABel:ENABle 1,ON /*Enables the display of all the labels.]
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System :SAVE:IMAGe:INVert Syntax :SAVE:IMAGe:INVert :SAVE:IMAGe:INVert? Description Parameter 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.
RIGOL Chapter 2 Command System :SAVE:WAVeform Syntax Description Parameter :SAVE:WAVeform Saves the waveform data to the internal or external memory as a file. 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.
RIGOL Chapter 2 Command System :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
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System Return Format Example 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. Name Type Range Default Discrete {CHANnel1|CHANnel2} CHANnel1 The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System Return Format Example 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.
RIGOL Chapter 2 Command System :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.
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. The commands are only available for the model installed with the MSO5000-E-AWG option.
RIGOL Chapter 2 Command System [: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.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion[:SHAPe] Syntax [:SOURce[]]:FUNCtion[:SHAPe] [:SOURce[]]:FUNCtion[:SHAPe]? Description Parameter If modulation is not enabled for the specified function/arbitrary waveform generator channel, this command is used to select or query the output signal waveform. If modulation is enabled for the specified function/arbitrary waveform generator channel, this command is used to select or query the modulated carrier waveform.
RIGOL Chapter 2 Command System [:SOURce[]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] Syntax [:SOURce[]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] [:SOURce[]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]? Description Parameter Remarks Return Format Example Sets or queries the amplitude of the signal output from the specified function/arbitrary waveform generator channel. By default, the unit is Vpp.
RIGOL Chapter 2 Command System [:SOURce[]]:PULSe:DCYCle Syntax [:SOURce[]]:PULSe:DCYCle [:SOURce[]]:PULSe:DCYCle? Description Parameter Remarks Sets or queries the duty cycle of the pulse output from the specified function/arbitrary waveform generator channel, i.g. the ratio of high level to a pulse period.
RIGOL Chapter 2 Command System [:SOURce[]]:MOD:AM[:DEPTh] Syntax [:SOURce[]]:MOD:AM[:DEPTh] [:SOURce[]]:MOD:AM[:DEPTh]? Description Parameter Remarks Return Format Example Sets or queries the depth of AM of the specified function/arbitrary waveform generator channel. The modulation depth refers to the strength of the AM and is expressed in percentage.
RIGOL Chapter 2 Command System :MOD:AM:INTernal:FREQuency? /*The query returns 100.
RIGOL Chapter 2 Command System Return Format Example 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.
RIGOL Chapter 2 Command System [:SOURce[]]:SWEep:BTIMe Syntax Description Parameter Remarks Return Format Example [:SOURce[]]:SWEep:BTIMe [:SOURce[]]:SWEep:BTIMe? Sets or queries the return time of the specified signal source channel.
RIGOL Chapter 2 Command System [:SOURce[]]:BURSt:DELay Syntax Description Parameter Remarks Return Format Example [:SOURce[]]:BURSt:DELay [:SOURce[]]:BURSt:DELay? Sets or queries the burst delay time of the specified signal source channel. Name Type Range Default [] Discrete {1} 1 Integer Refer to Remarks 0s Burst delay indicates the time from when receiving the trigger signal to starting to output N Cycle of bursts or Infinite burst.
RIGOL Chapter 2 Command System Parameter Name Type Range Default [] Discrete {1} 1 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 1 kHz Real Related to the currently set output impedance HighZ: 20 mVpp to 5 Vpp 50Ω: 10 mVpp to 2.5 Vpp 5 Vpp Real Related to the current output impedance and amplitude HighZ: (-2.5V + current amplitude/2) to (2.5V current amplitude/2) 50Ω: (-1.
RIGOL Chapter 2 Command System [: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.
Chapter 2 Command System RIGOL :SYSTem Commands The :SYSTem commands are used to set sound, language, and other relevant system settings.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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 ,,.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System Example KFUNction: press down the multifunction knob. TLEVel: press down the trigger level adjustment knob, i.g. set the trigger level to 50% of the peak-peak value. TMENu: press the MENU key in the trigger control area. TMODe: press the MODE key in the trigger control area. RSTop: press the RUN/STOP key. :SYSTem:KEY:PRESs /*Press the CH1 key on the front panel of the oscilloscope.
RIGOL Chapter 2 Command System Remarks Return Format Example The language settings are not affected by factory default settings (send the *RST command). The query returns SCH, TCH, KOR, JAP, ENGL, GERM, PORT, POL, FREN, RUSS, SPAN, THAI, or IND. :SYSTem:LANGuage ENGLish :SYSTem:LANGuage? /*Sets the system language to ENGLish.*/ /*The query returns ENGL.
RIGOL Chapter 2 Command System :SYSTem:OPTion:UNINSTall Syntax Description Remarks :SYSTem:OPTion:UNINSTall Uninstalls all the official options. After the option has been uninstalled, you need to restart the instrument. :SYSTem:OPTion:STATus? Syntax Description Parameter 说明 :SYSTem:OPTion:STATus? Queries the status of the options of the oscilloscope. Name Type Discrete Range {RL1|BND|COMP|EMBD|AUTO|FLEX|AUDI O|AERO|AWG|PWR} Default —— RL1: memory depth option.
RIGOL Chapter 2 Command System :SYSTem:SETup Syntax :SYSTem:SETup :SYSTem:SETup? Description Parameter Remarks Sends or reads the data stream of the system setup file. Name Type Range Default ASCII String Refer to Remarks —— is a binary data block, which consists of the TMC data block header and setup data. The format of the TMC data block header is #NX…X. Wherein, # is the start identifier of the data stream; the N-digit data "X...
RIGOL Chapter 2 Command System Remarks Return Format Example There is a certain delay between the return time value and the set time value due to the command response time and other factors. The query returns the system time in strings. :SYSTem:TIME 16,10,17 :SYSTem:TIME? /*Sets the system time to 16:10:17.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System Return Format Example 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.
RIGOL Chapter 2 Command System :TRIGger Commands The :TRIGger commands are used to set the trigger system of the oscilloscope.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System Return Format Example 1080P24: 1 to 1125 1080I60: 1 to 1125 1080I50: 1 to 1125 The query returns an integer. :TRIGger:VIDeo:LINE 100 :TRIGger:VIDeo:LINE? /*Sets the line number to 100.*/ /*The query returns 100.*/ :TRIGger:VIDeo:STANdard Syntax :TRIGger:VIDeo:STANdard :TRIGger:VIDeo:STANdard? Description Parameter Sets or queries the video standard of Video trigger.
RIGOL Chapter 2 Command System Parameter Remarks Return Format Example 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. The query returns the trigger level in scientific notation. :TRIGger:VIDeo:LEVel 0.16 :TRIGger:VIDeo:LEVel? /*Sets the trigger level to 160 mV.*/ /*The query returns 1.600000E-1.
RIGOL Chapter 2 Command System Example :TRIGger:PATTern:PATTern H,R /*Sets the patterns of "CH1 to CH2" to H,R. Other channel pattern remains unchanged.*/ :TRIGger:PATTern:PATTern? /*The query returns H,R,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X.*/ :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System pattern. When all the channels are set to X, the oscilloscope will not trigger.) Return Format Example The query returns the currently set pattern of all the channels. The channels are separated by commas. :TRIGger:DURATion:TYPE L,X :TRIGger:DURATion:TYPE? /*Sets the patterns of "CH1 to CH2" to L,X. Other channel pattern remains unchanged.*/ /*The query returns L,X, X,X,X,X,X,X,X,X,X,X,X,X,X,X,X,X.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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 10 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :TRIGger:DELay Command List: :TRIGger:DELay:ALEVel :TRIGger:DELay:BLEVel :TRIGger:DELay:SA :TRIGger:DELay:SLOPa :TRIGger:DELay:SB :TRIGger:DELay:SLOPb :TRIGger:DELay:TYPE :TRIGger:DELay:TUPPer :TRIGger:DELay:TLOWer :TRIGger:DELay:ALEVel Syntax :TRIGger:DELay:ALEVel :TRIGger:DELay:ALEVel? Description Parameter Remarks Return Format Example Sets or queries the trigger level of Source A in Delay trigger.
RIGOL Chapter 2 Command System :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. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D1 1|D12|D13|D14|D15|CHANnel1|CHANnel2} CHANnel1 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.
RIGOL Chapter 2 Command System :TRIGger:DELay:SLOPb Syntax :TRIGger:DELay:SLOPb :TRIGger:DELay:SLOPb? Description Parameter Return Format Example Sets or queries the edge type of Edge B in Delay trigger. Name Type Range Default Discrete {POSitive|NEGative} POSitive The query returns POS or NEG. :TRIGger:DELay:SLOPb NEGative :TRIGger:DELay:SLOPb? /*Sets the type of Edge B to NEGative.*/ /*The query returns NEG.
RIGOL Chapter 2 Command System Remarks Return Format Example This command is available when the delay type is LESS, GOUT, or GLESs. The query returns the upper limit of delay time in scientific notation. :TRIGger:DELay:TUPPer 0.002 :TRIGger:DELay:TUPPer? /*Sets the upper limit of delay time to 2 ms.*/ /*The query returns 2.000000E-3.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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 10 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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
RIGOL Chapter 2 Command System Example :TRIGger:SPI:SDA CHANnel2 /*Sets the channel source of the data line to CHANnel2.*/ :TRIGger:SPI:SDA? /*The query returns CHAN2.*/ :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.
RIGOL Chapter 2 Command System :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 8 ns to 10 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D1 1|D12|D13|D14|D15|CHANnel1|CHANnel2} CHANnel2 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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|D1 1|D12|D13|D14|D15|CHANnel1|CHANnel2} CHANnel1 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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} CHANnel1 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, or CHAN2.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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-214 Type Integer Range 32 0 to 2 -1 Default 0 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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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. Name Type Range Default Discrete {CHANnel1|CHANnel2} CHANnel1 The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System Command List: :WAVeform:SOURce :WAVeform:MODE :WAVeform:FORMat :WAVeform:POINts :WAVeform:DATA? :WAVeform:XINCrement? :WAVeform:XORigin? :WAVeform:XREFerence? :WAVeform:YINCrement? :WAVeform:YORigin? :WAVeform:YREFerence? :WAVeform:STARt :WAVeform:STOP :WAVeform:PREamble? :WAVeform:SOURce Syntax :WAVeform:SOURce :WAVeform:SOURce? Description Parameter Remarks Return Format Example Sets or queries the sourc
RIGOL Chapter 2 Command System :WAVeform:MODE Syntax :WAVeform:MODE :WAVeform:MODE? Description Parameter Remarks Return Format Example Sets or queries the mode of the :WAVeform:DATA? command in reading data. Name Type Range Default Discrete {NORMal|MAXimum|RAW} RAW NORMal: reads the waveform data currently displayed on the screen.
RIGOL Chapter 2 Command System :WAVeform:POINts Syntax :WAVeform:POINts :WAVeform:POINts? Description Sets or queries the number of the waveform points to be read. Parameter Remarks Return Format Name Type Range Default Integer Refer to Remarks —— The range of is related to the current reading mode of the waveform data.
RIGOL Chapter 2 Command System the command reads the memory waveform data, it returns the signal status of the channel group where the currently selected channel sources reside. 1 byte represents the status of one group of digital signals. When the waveform data in the internal memory are read in batches, the waveform data returned each time might be the data in one area of the internal memory. In "WORD" or "BYTE" return format, each returned data in blocks contain the TMC data block header.
Chapter 2 Command System RIGOL :WAVeform:YINCrement? Syntax :WAVeform:YINCrement? Description Queries the unit voltage of the current channel in the Y axis. Its unit is the same as that of the current amplitude. Remarks The returned value is related to the current data reading mode: In NORMal mode, YINCrement = VerticalScale/25. In RAW mode, YINCrement and VerticalScale of the memory waveforms are related to the currently selected VerticalScale.
RIGOL Chapter 2 Command System :WAVeform:STARt Syntax :WAVeform:STARt :WAVeform:STARt? Description Parameter Sets or queries the start position of waveform data reading.
Chapter 2 Command System RIGOL :WAVeform:PREamble? Syntax Description Return Format :WAVeform:PREamble? Queries all the waveform parameters. The query returns 10 waveform parameters, separated by commas. ,,,,,,,,, Wherein, : indicates 0 (BYTE), 1 (WORD), or 2 (ASC). : indicates 0 (NORMal), 1 (MAXimum), or 2 (RAW).
Chapter 3 Programming Examples RIGOL Chapter 3 Programming Examples This chapter illustrates how to control the MSO5000-E 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.
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.
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 "MSO5000-E_Demo_Excel.xlsm". 2. Run the MSO5000-E_Demo_Excel.xlsm file. Click FileOptions at the upper-left corner of the Excel file to open the interface as shown in the figure below.
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.
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").
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.
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 MSO5000-E_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.
RIGOL Chapter 3 Programming Examples 5. Connect the VISA resource name with the VISA Open. Then, connect the VISA resource name outputs of all the functions with the VISA resource name and connect the error output with the error input, as shown in the figure below. 6. Add string constant in the write buffer areas of the VISA Write function and input the following instructions in the figure below.
Chapter 3 Programming Examples RIGOL Used to obtain the TMC header"#N". After obtaining the number of bytes that the TMC header occupies, ignore the data header to obtain the waveform data strings. 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. 8. The complete program block diagram is as shown in the figure below. 9.
RIGOL 3-10 Chapter 3 Programming Examples MSO5000-E Programming Guide
Chapter 3 Programming Examples RIGOL 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.
RIGOL Chapter 3 Programming Examples 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
Chapter 3 Programming Examples RIGOL 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.
RIGOL 4. Chapter 3 Programming Examples 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.
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
RIGOL Chapter 3 Programming Examples 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.