Rigol DS7034 User Programming Manual

Rigol DS7034 User Programming Manual

Mso7000 series; ds7000 series; digital oscilloscope
Hide thumbs Also See for DS7034:
Table of Contents

Advertisement

Quick Links

RIGOL
Programming Guide
MSO7000/DS7000 Series Digital
Oscilloscope
Apr. 2018
RIGOL TECHNOLOGIES, INC.

Advertisement

Table of Contents
loading

Summary of Contents for Rigol DS7034

  • Page 1 RIGOL Programming Guide MSO7000/DS7000 Series Digital Oscilloscope Apr. 2018 RIGOL TECHNOLOGIES, INC.
  • Page 3: Guaranty And Declaration

    Notices RIGOL products are covered by P.R.C. and foreign patents, issued and pending.  RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at  the company’s sole decision. Information in this publication replaces all previously released materials.
  • Page 4: Document Overview

    This chapter illustrates how to control the MSO7000/DS7000 series digital oscilloscope by programming in Excel, LabVIEW, Visual Basic, and Visual C++. For the latest version of this manual, download it from the official website of RIGOL (www.rigol.com). Format Conventions in this Manual: The key on the front panel is denoted by the format of "Key Name (Bold) + Text Box"...
  • Page 5: Table Of Contents

    Contents RIGOL Contents Guaranty and Declaration ......................I Document Overview ......................... II Chapter 1 SCPI Command Overview .................. 1-1 Syntax ..........................1-1 Symbol Description ......................1-1 Parameter Type ........................1-2 Command Abbreviation ......................1-2 Chapter 2 Command System ....................2-1 :AUToscale ..........................
  • Page 6 Contents RIGOL :CHANnel<n>:PROBe:DELay ..................2-43 :CHANnel<n>:PROBe:BIAS ...................2-44 :CHANnel<n>:UNITs.....................2-44 :CHANnel<n>:VERNier ....................2-44 :COUNter Commands ......................2-46 :COUNter:CURRent? .....................2-46 :COUNter:CURRent? .....................2-46 :COUNter:ENABle ......................2-46 :COUNter:SOURce ......................2-46 :COUNter:MODE ......................2-47 :COUNter:NDIGits ......................2-47 :COUNter:TOTalize:ENABle ....................2-47 :COUNter:TOTalize:CLEar ....................2-48 :CURSor Commands ......................2-49 :CURSor:MODE ......................2-50 :CURSor:MANual ......................2-51 :CURSor:TRACk ......................2-57 :CURSor:XY .........................2-62 :DISPlay Commands ......................2-65 :DISPlay:CLEar ......................2-65...
  • Page 7 Contents RIGOL :LA:STATe ........................2-78 :LA:ACTive ........................2-79 :LA:AUTOsort ....................... 2-79 :LA:DELete ........................2-79 :LA:DIGital<n>:DISPlay ....................2-80 :LA:DIGital<n>:POSition ....................2-80 :LA:DIGital<n>:LABel ....................2-81 :LA:POD<n>:DISPlay ....................2-81 :LA:DISPlay ......................... 2-81 :LA:POD<n>:THReshold ....................2-82 :LA:SIZE ........................2-82 :LA:TCALibrate ......................2-83 :LA:GROup<n>:APPend ....................2-83 :LAN Commands .........................
  • Page 8 Contents RIGOL :MATH<n>:FFT:FREQuency:END .................. 2-101 :MATH<n>:FFT:SEARch:ENABle ................... 2-101 :MATH<n>:FFT:SEARch:NUM ..................2-102 :MATH<n>:FFT:SEARch:THReshold ................2-102 :MATH<n>:FFT:SEARch:EXCursion ................2-102 :MATH<n>:FFT:SEARch:ORDer ..................2-103 :MATH<n>:FILTer:TYPE ....................2-103 :MATH<n>:FILTer:W1 ....................2-104 :MATH<n>:FILTer:W2 ....................2-104 :MATH<n>:SENSitivity ....................2-105 :MATH<n>:DISTance ....................2-105 :MATH<n>:THReshold1 ....................2-105 :MATH<n>:THReshold2 ....................2-106 :MEASure Commands ......................
  • Page 9 Contents RIGOL :REFerence:VSCale ..................... 2-124 :REFerence:VOFFset ....................2-124 :REFerence:RESet....................... 2-125 :REFerence:CURRent ....................2-125 :REFerence:SAVE ......................2-125 :REFerence:COLor ...................... 2-125 :REFerence:LABel:ENABle .................... 2-126 :REFerence:LABel:CONTent ..................2-126 :SAVE and :Load Commands ....................2-127 :SAVE:CSV ......................... 2-127 :SAVE:CSV:LENGth ..................... 2-127 :SAVE:FORMat ......................2-128 :SAVE:IMAGe ......................
  • Page 10 Contents RIGOL [:SOURce[<n>]]:OUTPut[<n>][:STATe] ............... 2-147 [:SOURce[<n>]]:OUTPut[<n>]:IMPedance ..............2-147 :SYSTem Commands ......................2-148 :SYSTem:AOUTput ...................... 2-149 :SYSTem:AUTOscale ....................2-149 :SYSTem:BEEPer ......................2-150 :SYSTem:DATE ......................2-150 :SYSTem:ERRor[:NEXT]? ..................... 2-150 :SYSTem:GAMount? ....................2-150 :SYSTem:GPIB ......................2-151 :SYSTem:KEY:PRESs ....................2-151 :SYSTem:KEY:INCRease ....................2-152 :SYSTem:KEY:DECRease ....................2-152 :SYSTem:LANGuage ....................
  • Page 11 Contents RIGOL :TRIGger:SPI (Option) ....................2-208 :TRIGger:FLEXray (Option) ..................2-213 :TRIGger:IIS (Option) ....................2-215 :TRIGger:LIN (Option) ....................2-219 :TRIGger:M1553 (Option) .................... 2-222 :WAVeform Commands ...................... 2-224 :WAVeform:SOURce ....................2-225 :WAVeform:MODE ...................... 2-225 :WAVeform:FORMat ....................2-226 :WAVeform:DATA? ...................... 2-226 :WAVeform:XINCrement? .................... 2-227 :WAVeform:XORigin? ....................
  • Page 13: Chapter 1 Scpi Command Overview

    Chapter 1 SCPI Command Overview RIGOL Chapter 1 SCPI Command Overview SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming language that is built upon the existing standard IEEE 488.1 and IEEE 488.2 and conforms to various standards, such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character set for information interchange (equivalent to ASCII programming).
  • Page 14: Parameter Type

    Chapter 1 SCPI Command Overview RIGOL Parameter Type Bool The parameter can be set to ON, OFF, 1, or 0. For example, :SYSTem:BEEPer <bool> :SYSTem:BEEPer? Wherein, <bool> can be set to {{1|ON}|{0|OFF}}. The query returns 1 or 0. Discrete The parameter can be any of the values listed. For example, :ACQuire:TYPE <type>...
  • Page 15: Chapter 2 Command System

    Chapter 2 Command System RIGOL Chapter 2 Command System This chapter introduces the syntax, functions, parameters, and usage of each MSO7000/DS7000 command. Contents in this chapter: :AUToscale  :CLEar  :RUN  :STOP  :SINGle  :TFORce  :ACQuire Commands ...
  • Page 16: Autoscale

    Chapter 2 Command System RIGOL Note: Unless otherwise specified, the descriptions in this manual all take MSO7054 as an example. Unless otherwise specified, the descriptions about the digital channels and the commands in this manual are only available for the MSO7000 series.
  • Page 17: Single

    Chapter 2 Command System RIGOL :SINGle Syntax :SINGle Description Sets the trigger mode of the oscilloscope to "Single". This command functions the same as either of the following two operation: press SINGLE on the front panel; or send :TRIGger:SWEep SINGle command.
  • Page 18: Acquire Commands

    Chapter 2 Command System RIGOL :ACQuire Commands The :ACQuire commands are used to set the memory depth of the oscilloscope, the acquisition mode, the average times, as well as query the current sample rate. Command List :ACQuire:AVERages  :ACQuire:MDEPth ...
  • Page 19: Acquire:type

    Chapter 2 Command System RIGOL Remarks When "AUTO" is selected, the oscilloscope selects the memory depth automatically  according to the current sample rate. The maximum memory depth for the single channel is 500 M; the maximum memory  depth for the dual-channel is 250 M; and the maximum memory depth for the four-channel is 125 M.
  • Page 20: Acquire:la:srate

    Chapter 2 Command System RIGOL length is obtained by multiplying the horizontal time base (set by :TIMebase[:MAIN]:SCALe command) by the number of grids in the horizontal direction. For MSO7000/DS7000, the number of grids in the horizontal direction is 10. Return The query returns the sample rate in scientific notation.
  • Page 21: Bus Commands

    Chapter 2 Command System RIGOL :BUS<n> Commands The : BUS<n> commands are used to execute the decoding-related settings and operations. Command List: :BUS<n>:MODE  :BUS<n>:DISPlay  :BUS<n>:FORMat  :BUS<n>:EVENt  :BUS<n>:EVENt:FORMat  :BUS<n>:EVENt:VIEW  :BUS<n>:LABel  :BUS<n>:DATA?  :BUS<n>:EEXPort ...
  • Page 22: Bus:Display

    Chapter 2 Command System RIGOL :BUS<n>:DISPlay Syntax :BUS<n>:DISPlay <bool> :BUS<n>:DISPlay? Description Enables or disables the specified decoding bus; or queries the on/off display status of the specified decoding bus. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <bool> Bool...
  • Page 23: Bus:Event:format

    Chapter 2 Command System RIGOL :BUS<n>:EVENt:FORMat Syntax :BUS<n>:EVENt:FORMat <format> :BUS<n>:EVENt:FORMat? Description Sets or queries the display format of the specified decoding bus event table. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <format> Discrete {HEX|ASCii|DEC|BIN} ASCii Remarks HEX indicates Hexadecimal; DEC indicates Decimal; BIN indicates Binary.
  • Page 24: Bus:Data

    Chapter 2 Command System RIGOL Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Remarks Before using the command, enable the specified decoding bus. Return The query returns 1 or 0. Format Example :BUS1:EVENt ON /*Enables the label of the specified decoding bus.*/ :BUS1:EVENt? /*The query returns 1.*/...
  • Page 25: Bus:Position

    Chapter 2 Command System RIGOL :BUS<n>:POSition Syntax :BUS<n>:POSition <pos> :BUS<n>:POSition? Description Sets or queries the vertical position of the bus on the screen. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— Related to the <pos> Integer -167 to +217...
  • Page 26: Bus:Parallel

    Chapter 2 Command System RIGOL :BUS<n>:PARallel The :BUS<n>:PARallel commands are used to set relevant parameters for Parallel decoding. Command List: :BUS<n>:PARallel:CLK  :BUS<n>:PARallel:SLOPe  :BUS<n>:PARallel:WIDTh  :BUS<n>:PARallel:BITX  :BUS<n>:PARallel:SOURce  :BUS<n>:PARallel:POLarity  :BUS<n>:PARallel:NREJect  :BUS<n>:PARallel:NRTime  :BUS<n>:PARallel:CLK Syntax :BUS<n>:PARallel:CLK <source>...
  • Page 27 Chapter 2 Command System RIGOL Example :BUS1:PARallel:SLOPe BOTH /*Sets the Parallel decoding to sample on any edge of the clock channel.*/ :BUS1:PARallel:SLOPe? /*The query returns BOTH.*/ :BUS<n>:PARallel:WIDTh Syntax :BUS<n>:PARallel:WIDTh <wid> :BUS<n>:PARallel:WIDTh? Description Sets or queries the data width of the parallel bus, i.g. the number of bits per frame.
  • Page 28 Chapter 2 Command System RIGOL :BUS<n>:PARallel:SOURce Syntax :BUS<n>:PARallel:SOURce <src> :BUS<n>:PARallel:SOURce? Description Sets or queries the channel source of the currently selected data bit. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— {D0|D1|D2|D3|D4|D5|D6|D7|D8| Related to the <src> Discrete D9|D10|D11|D12|D13|D14|D15| selected bit...
  • Page 29 Chapter 2 Command System RIGOL Remarks Noise rejection can remove the data that last not enough time on the bus and  eliminate the burst glitch in the actual circuit. When the noise rejection is enabled, send the :BUS<n>:PARallel:NRTime ...
  • Page 30: Bus:Rs232 (Option)

    Chapter 2 Command System RIGOL :BUS<n>:RS232 (Option) The :BUS<n>:RS232 commands are used to set relevant parameters for RS232 decoding. Command List: :BUS<n>:RS232:TX  :BUS<n>:RS232:RX  :BUS<n>:RS232:POLarity  :BUS<n>:RS232:ENDian  :BUS<n>:RS232:BAUD  :BUS<n>:RS232:DBITs  :BUS<n>:RS232:SBITs  :BUS<n>:RS232:PARity  :BUS<n>:RS232:PACKet  :BUS<n>:RS232:PEND ...
  • Page 31 Chapter 2 Command System RIGOL Format D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF. Example :BUS1:RS232:RX D0 /*Sets the RX channel source of RS232 decoding to D0.*/ :BUS1:RS232:RX? /*The query returns D0.*/ :BUS<n>:RS232:POLarity Syntax :BUS<n>:RS232:POLarity <pol> :BUS<n>:RS232:POLarity? Description Sets or queries the polarity of RS232 decoding.
  • Page 32 Chapter 2 Command System RIGOL :BUS<n>:RS232:BAUD Syntax :BUS<n>:RS232:BAUD <baud> :BUS<n>:RS232:BAUD? Description Sets or queries the baud rate of data transmission in RS232 decoding. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <baud> Integer 1 bps to 20 Mbps 9600 bps Remarks If the baud rate is set to a value with "M", then "A"...
  • Page 33 Chapter 2 Command System RIGOL :BUS<n>:RS232:PARity Syntax :BUS<n>:RS232:PARity <parity> :BUS<n>:RS232:PARity? Description Sets or queries the odd-even check mode of data transmission in RS232 decoding. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <parity> Discrete {NONE|ODD|EVEN} NONE Remarks None: indicates that there is no parity bit in data transmission.
  • Page 34 Chapter 2 Command System RIGOL :BUS<n>:RS232:PEND Syntax :BUS<n>:RS232:PEND <package end> :BUS<n>:RS232:PEND? Description Sets or queries the packet end type during data transmission. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <package end> Discrete {NULL|LF|CR|SP} NULL Remarks The parameters are represented in hexadecimal as follows:...
  • Page 35: Bus:Iic (Option)

    Chapter 2 Command System RIGOL :BUS<n>:IIC (Option) The :BUS<n>:IIC commands are used to set relevant parameters for I2C decoding. Command List: :BUS<n>:IIC:SCLK:SOURce  :BUS<n>:IIC:SDA:SOURce  :BUS<n>:IIC:ADDRess  :BUS<n>:IIC:SCLK:SOURce Syntax :BUS<n>:IIC:SCLK:SOURce <source> :BUS<n>:IIC:SCLK:SOURce? Description Sets or queries the clock source of I2C decoding.
  • Page 36 Chapter 2 Command System RIGOL :BUS<n>:IIC:ADDRess Syntax :BUS<n>:IIC:ADDRess <addr> :BUS<n>:IIC:ADDRess? Description Sets or queries the address mode of I2C decoding. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <addr> Discrete {NORMal|RW} NORMal Remarks NORMal: indicates that the address width does not include the R/W bit.
  • Page 37: Bus:Spi (Option)

    Chapter 2 Command System RIGOL :BUS<n>:SPI (Option) The :BUS<n>:SPI commands are used to set relevant parameters for SPI decoding. Command List: :BUS<n>:SPI:SCLK:SOURce  :BUS<n>:SPI:SCLK:SLOPe  :BUS<n>:SPI:MISO:SOURce  :BUS<n>:SPI:MISO:POLarity  :BUS<n>:SPI:MOSI:SOURce  :BUS<n>:SPI:MOSI:POLarity  :BUS<n>:SPI:DBITs  :BUS<n>:SPI:ENDian  :BUS<n>:SPI:MODE  :BUS<n>:SPI:TIMeout:TIME ...
  • Page 38 Chapter 2 Command System RIGOL :BUS<n>:SPI:SCLK:SLOPe Syntax :BUS<n>:SPI:SCLK:SLOPe <slope> :BUS<n>:SPI:SCLK:SLOPe? Description Sets or queries the clock edge type of SPI decoding. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <slope> Discrete {POSitive|NEGative} POSitive Return The query returns POS or NEG.
  • Page 39 Chapter 2 Command System RIGOL :BUS<n>:SPI:MOSI:SOURce Syntax :BUS<n>:SPI:MOSI:SOURce <source> :BUS<n>:SPI:MOSI:SOURce? Description Sets or queries the MOSI data source of SPI decoding. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11| <source> Discrete D12|D13|D14|D15|CHANnel1|CHANnel2|CHANn el3|CHANnel4|OFF} Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
  • Page 40 Chapter 2 Command System RIGOL :BUS<n>:SPI:ENDian Syntax :BUS<n>:SPI:ENDian <endian> :BUS<n>:SPI:ENDian? Description Sets or queries the endian of data transmission of SPI decoding. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <endian> Discrete {MSB|LSB} Remarks MSB: indicates Most Significant Bit transmission sequence, i.g. the highest bit of ...
  • Page 41 Chapter 2 Command System RIGOL :BUS<n>:SPI:TIMeout:TIME Syntax :BUS<n>:SPI:TIMeout:TIME <time> :BUS<n>:SPI:TIMeout:TIME? Description Sets or queries the timeout value of SPI decoding. The default unit is s. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <time> Real 8 ns to 10 s 1 μs...
  • Page 42 Chapter 2 Command System RIGOL :BUS<n>:SPI:SS:POLarity Syntax :BUS<n>:SPI:SS:POLarity <polarity> :BUS<n>:SPI:SS:POLarity? Description Sets or queries the polarity of CS line of SPI decoding. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <polarity> Discrete {HIGH|LOW} Remarks HIGH: indicates that the oscilloscope samples data of the source channel of data ...
  • Page 43: Bus:Can (Option)

    Chapter 2 Command System RIGOL :BUS<n>:CAN (Option) The :BUS<n>:CAN commands are used to set relevant parameters for CAN decoding. Command List: :BUS<n>:CAN:SOURce  :BUS<n>:CAN:STYPe  :BUS<n>:CAN:BAUD  :BUS<n>:CAN:SPOint  :BUS<n>:CAN:SOURce Syntax :BUS<n>:CAN:SOURce <source> :BUS<n>:CAN:SOURce? Description Sets or queries the source channel of CAN decoding.
  • Page 44 Chapter 2 Command System RIGOL :BUS<n>:CAN:BAUD Syntax :BUS<n>:CAN:BAUD <baud> :BUS<n>:CAN:BAUD? Description Sets or queries the signal rate of CAN decoding. The default unit is bps. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <baud> Integer 10 kbps to 5 Mbps...
  • Page 45: Bus:Flexray (Option)

    Chapter 2 Command System RIGOL :BUS<n>:FLEXray (Option) The :BUS<n>:FLEXray commands are used to set the relevant parameters for FLEXray decoding. Command List: :BUS<n>:FLEXray:BAUD  :BUS<n>:FLEXray:SOURce  :BUS<n>:FLEXray:SPOint  :BUS<n>:FLEXray:STYPe  :BUS<n>:FLEXray:BAUD Syntax :BUS<n>:FLEXray:BAUD <baud> :BUS<n>:FLEXray:BAUD? Description Sets or queries the signal rate of FlexRay decoding. The default unit is bps.
  • Page 46 Chapter 2 Command System RIGOL :BUS<n>:FLEXray:SPOint Syntax :BUS<n>:FLEXray:SPOint <spoint> :BUS<n>:FLEXray:SPOint? Description Sets or queries the sample point position of FlexRay decoding (expressed in %). Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <spoint> Integer 10 to 90 Remarks Sample point is a point within a bit’s time. The oscilloscope samples the bit level at this point.
  • Page 47: Bus:Lin (Option)

    Chapter 2 Command System RIGOL :BUS<n>:LIN (Option) The :BUS<n>:LIN commands are used to set relevant parameters for LIN decoding. Command List: :BUS<n>:LIN:BAUD  :BUS<n>:LIN:POLarity  :BUS<n>:LIN:SOURce  :BUS<n>:LIN:STANdard  :BUS<n>:LIN:BAUD Syntax :BUS<n>:LIN:BAUD <baud> :BUS<n>:LIN:BAUD? Description Sets or queries the baud rate of LIN decoding. The default unit is bps。...
  • Page 48 Chapter 2 Command System RIGOL :BUS<n>:LIN:SOURce Syntax :BUS<n>:LIN:SOURce <source> :BUS<n>:LIN:SOURce? Description Sets or queries the source of LIN bus. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— {D0|D1|D2|D3|D4|D5|D6|D7|D8| <source> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel1 CHANnel1|CHANnel2|CHANnel3|CHANnel4} Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format D15, CHAN1, CHAN2, CHAN3, or CHAN4.
  • Page 49: Bus:Iis (Option)

    Chapter 2 Command System RIGOL :BUS<n>:IIS (Option) The :BUS<n>:IIC commands are used to set relevant parameters for I2S decoding. Command List: :BUS<n>:IIS:SOURce:CLOCk  :BUS<n>:IIS:SOURce:DATA  :BUS<n>:IIS:SOURce:WSELect  :BUS<n>:IIS:ALIGnment  :BUS<n>:IIS:CLOCk:SLOPe  :BUS<n>:IIS:RWIDth  :BUS<n>:IIS:SOURce:CLOCk Syntax :BUS<n>:IIS:SOURce:CLOCk <source> :BUS<n>:IIS:SOURce:CLOCk? Description Sets or queries the clock source of the I2S decoding.
  • Page 50 Chapter 2 Command System RIGOL :BUS<n>:IIS:SOURce:WSELect Syntax :BUS<n>:IIS:SOURce:WSELect <source> :BUS<n>:IIS:SOURce:WSELect? Description Sets or queries the audio channel of the I2S trigger. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D1 <source> Discrete 1|D12|D13|D14|D15|CHANnel1|CHANnel2|C CHANnel1 HANnel3|CHANnel4} Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format D15, CHAN1, CHAN2, CHAN3, or CHAN4.
  • Page 51 Chapter 2 Command System RIGOL :BUS<n>:IIS:RWIDth Syntax :BUS<n>:IIS:RWIDth <val> :BUS<n>:IIS:RWIDth? Description Sets or queries the word size of the I2S decoding. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <val> Integer 4 to 32 Return The query returns an integer ranging from 4 to 32.
  • Page 52: Bus:M1553 (Option)

    Chapter 2 Command System RIGOL :BUS<n>:M1553 (Option) The :BUS<n>:M1553 commands are used to set relevant parameters for the M1553 decoding. Command List: :BUS<n>:M1553:SOURce  :BUS<n>:M1553:SOURce Syntax :BUS<n>:M1553:SOURce <source> :BUS<n>:M1553:SOURce? Description Sets or queries the source of the M1553 decoding. Parameter...
  • Page 53: Channel Commands

    Remarks Remarks The range of <type> is related to the instrument model.  MSO7054/DS7054/MSO7034/DS7034: {20M|250M|OFF} MSO7024/DS7024/MSO7014/DS7014: {20M|OFF} 20M, 250M: When you enable the bandwidth limit and limit it to 20 MHz or 250 MHz,  the high frequency components found in the signal under test that are greater than 20 MHz or 250 MHz are attenuated.
  • Page 54: Channel:Coupling

    Chapter 2 Command System RIGOL :CHANnel<n>:COUPling Syntax :CHANnel<n>:COUPling <coupling> :CHANnel<n>:COUPling? Description Sets or queries the coupling mode of the specified channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <coupling> Discrete {AC|DC} Remarks AC: the DC components of the signal under test are blocked.
  • Page 55: Channel:Offset

    Chapter 2 Command System RIGOL Example :CHANnel1:INVert ON /*Enables the waveform invert for CH1.*/ :CHANnel1:INVert? /*The query returns 1.*/ :CHANnel<n>:OFFSet Syntax :CHANnel<n>:OFFSet <offset> :CHANnel<n>:OFFSet? Description Sets or queries the vertical offset of the specified channel. The default unit is V.
  • Page 56: Channel:Scale

    Chapter 2 Command System RIGOL :CHANnel<n>:SCALe Syntax :CHANnel<n>:SCALe <scale> :CHANnel<n>:SCALe? Description Sets or queries the vertical scale of the specified channel. The default unit is V. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— Related to input impedance and probe ratio: when the input impedance is 1 MΩ, the...
  • Page 57: Channel:Cstart

    Chapter 2 Command System RIGOL :CHANnel<n>:CSTart Syntax :CHANnel<n>:CSTart Description Starts calibration for the active probe currently connected to the specified analog channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— Remarks This command is only valid when an active probe is correctly connected.
  • Page 58: Channel:Probe:bias

    Chapter 2 Command System RIGOL :CHANnel<n>:PROBe:BIAS Syntax :CHANnel<n>:PROBe:BIAS <bias> :CHANnel<n>:PROBe:BIAS? Description Sets or queries the probe bias voltage of the specified channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <bias> Real -12 V to 12 V Remarks This function is used to adjust the signal under test that exceeds the input dynamic ...
  • Page 59 Chapter 2 Command System RIGOL Return The query returns 1 or 0. Format Example :CHANnel1:VERNier ON /*Enables the fine adjustment of the vertical scale of CH1.*/ :CHANnel1:VERNier? /*The query returns 1.*/ MSO7000/DS7000 Programming Guide 2-45...
  • Page 60: Counter Commands

    Chapter 2 Command System RIGOL :COUNter Commands Command List: :COUNter:CURRent?  :COUNter:ENABle  :COUNter:SOURce  :COUNter:MODE  :COUNter:NDIGits  :COUNter:TOTalize:ENABle  :COUNter:TOTalize:CLEar  :COUNter:CURRent? Syntax :COUNter:CURRent? Description Queries the measurement value of the frequency counter. Return The query returns 1.000006E+3.
  • Page 61: Counter:mode

    Chapter 2 Command System RIGOL Example :COUNter:SOURce CHANnel2 /*Sets the source of the frequency counter to CH2.*/ :COUNter:SOURce? /*The query returns CHAN2.*/ :COUNter:MODE Syntax :COUNter:MODE <mode> :COUNter:MODE? Description Sets or queries the mode of the frequency counter. Parameter Name Type...
  • Page 62: Counter:totalize:clear

    Chapter 2 Command System RIGOL Example :COUNter:TOTalize:ENABle ON /*Enables the statistical function of the frequency counter.*/ :COUNter:TOTalize:ENABle? /*The query returns 1.*/ :COUNter:TOTalize:CLEar Syntax :COUNter:TOTalize:CLEar Description Clears the total count. Description Available when "Totalize" is selected under "Measure". 2-48 MSO7000/DS7000 Programming Guide...
  • Page 63: Cursor Commands

    Chapter 2 Command System RIGOL :CURSor Commands The :CURSor commands are used to measure the X axis values (e.g. Time) and Y axis values (e.g. Voltage) of the waveform on the screen. Command List: :CURSor:MODE  :CURSor:MANual  :CURSor:TRACk ...
  • Page 64: Cursor:mode

    Chapter 2 Command System RIGOL :CURSor:MODE Syntax :CURSor:MODE <mode> :CURSor:MODE? Description Sets or queries the mode of the cursor measurement. Parameter Name Type Range Default <mode> Discrete {OFF|MANual|TRACk|XY} Remarks OFF: disables the cursor measurement function.  MANual: enables the manual mode of cursor measurement.
  • Page 65: Cursor:manual

    Chapter 2 Command System RIGOL :CURSor:MANual Command List: :CURSor:MANual:TYPE  :CURSor:MANual:SOURce  :CURSor:MANual:TUNit  :CURSor:MANual:VUNit  :CURSor:MANual:CAX  :CURSor:MANual:CBX  :CURSor:MANual:CAY  :CURSor:MANual:CBY  :CURSor:MANual:AXValue?  :CURSor:MANual:AYValue?  :CURSor:MANual:BXValue?  :CURSor:TRACk:BYValue?  :CURSor:MANual:XDELta?  :CURSor:MANual:IXDELta?  :CURSor:MANual:YDELta?  :CURSor:MANual:TYPE Syntax :CURSor:MANual:TYPE <type>...
  • Page 66 Chapter 2 Command System RIGOL :CURSor:MANual:SOURce Syntax :CURSor:MANual:SOURce <source> :CURSor:MANual:SOURce? Description Sets or queries the channel source of the manual mode of cursor measurement. Parameter Name Type Range Default {CHANnel1|CHANnel2|CHANnel3|CHANnel4| <source> Discrete CHANnel1 MATH1|MATH2|MATH3|MATH4|LA|NONE} Remarks Only the currently enabled channel can be selected as the channel source.
  • Page 67 Chapter 2 Command System RIGOL :CURSor:MANual:VUNit Syntax :CURSor:MANual:VUNit <unit> :CURSor:MANual:VUNit? Description Sets or queries the vertical unit in the manual mode of cursor measurement. Parameter Name Type Range Default <unit> Discrete SOUR {SOURce|PERCent} Remarks SOURce: in the measurement results, the unit of AY, BY, and △ Y are automatically ...
  • Page 68 Chapter 2 Command System RIGOL :CURSor:MANual:CBX Syntax :CURSor:MANual:CBX <bx> :CURSor:MANual:CBX? Description Sets or queries the horizontal position of Cursor B in the manual mode of cursor measurement. Parameter Name Type Range Default <bx> Integer 0 to 999 Remarks The horizontal and vertical position of the cursor is defined by the screen pixel coordinate.
  • Page 69 Chapter 2 Command System RIGOL :CURSor:MANual:CBY Syntax :CURSor:MANual:CBY <by> :CURSor:MANual:CBY? Description Sets or queries the vertical position of Cursor B in the manual mode of cursor measurement. Parameter Name Type Range Default <by> Integer 0 to 479 Remarks The horizontal and vertical position of the cursor is defined by the screen pixel ...
  • Page 70 Chapter 2 Command System RIGOL :CURSor:MANual:BYValue? Syntax :CURSor:MANual:BYValue? Description Queries the Y value at Cursor B in the manual mode of cursor measurement. The unit is determined by the currently selected vertical unit. Return When the channel source is CHANnel1, CHANnel2, CHANnel3, CHANnel4, MATH1, ...
  • Page 71: Cursor:track

    Chapter 2 Command System RIGOL :CURSor:TRACk Command List: :CURSor:TRACk:SOURce1  :CURSor:TRACk:SOURce2  :CURSor:TRACk:CAX  :CURSor:TRACk:CBX  :CURSor:TRACk:CAY?  :CURSor:TRACk:CBY?  :CURSor:TRACk:AXValue?  :CURSor:TRACk:AYValue?  :CURSor:TRACk:BXValue?  :CURSor:TRACk:BYValue?  :CURSor:TRACk:XDELta?  :CURSor:TRACk:YDELta?  :CURSor:TRACk:IXDELTA?  :CURSor:TRACk:SOURce1 Syntax :CURSor:TRACk:SOURce1 <source> :CURSor:TRACk:SOURce1? Description Sets or queries the channel source of Cursor A in the track mode of cursor measurement.
  • Page 72 Chapter 2 Command System RIGOL :CURSor:TRACk:SOURce2 Syntax :CURSor:TRACk:SOURce2 <source> :CURSor:TRACk:SOURce2? Description Sets or queries the channel source of Cursor B in the track mode of cursor measurement. Parameter Name Type Range Default {CHANnel1|CHANnel2|CHANnel3|CHANnel4| <source> Discrete CHANnel1 MATH1|MATH2|MATH3|MATH4|NONE} Remarks Only the currently enabled channel can be selected as the channel source.
  • Page 73 Chapter 2 Command System RIGOL :CURSor:TRACk:CBX Syntax :CURSor:TRACk:CBX <bx> :CURSor:TRACk:CBX? Description Sets or queries the horizontal position of Cursor B in the track mode of cursor measurement. Parameter Name Type Range Default <bx> Integer 0 to 999 Remarks The horizontal and vertical position of the cursor is defined by the screen pixel coordinate.
  • Page 74 Chapter 2 Command System RIGOL :CURSor:TRACk:AXValue? Syntax :CURSor:TRACk:AXValue? Description 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. Return Format The query returns the X value at Cursor A in scientific notation.
  • Page 75 Chapter 2 Command System RIGOL :CURSor:TRACk:IXDELTA? Syntax :CURSor:TRACk:IXDELTA? Description 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 Return The query returns 1/△...
  • Page 76: Cursor:xy

    Chapter 2 Command System RIGOL :CURSor:XY The :CURSor:XY command is only available when the horizontal time base mode is set to XY. Command List: :CURSor:XY:AX  :CURSor:XY:BX  :CURSor:XY:AY  :CURSor:XY:BY  :CURSor:XY:AXValue?  :CURSor:XY:AYValue?  :CURSor:XY:BXValue?  :CURSor:XY:BYValue? ...
  • Page 77 Chapter 2 Command System RIGOL :CURSor:XY:BX Syntax :CURSor:XY:BX <x> :CURSor:XY:BX? Description Sets or queries the horizontal position of Cursor B in the XY cursor measurement mode. Parameter Name Type Range Default <x> Integer 0 to 479 Remarks 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.
  • Page 78 Chapter 2 Command System RIGOL :CURSor:XY:BY Syntax :CURSor:XY:BY <y> :CURSor:XY:BY? Description Sets or queries the vertical position of Cursor B in the XY cursor measurement mode. Parameter Name Type Range Default <y> Integer 0 to 479 Remarks 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.
  • Page 79: Display Commands

    Chapter 2 Command System RIGOL :DISPlay Commands The :DISPlay commands can be used to set the displayed type of the waveform, persistence time, intensity, grid type, grid brightness, etc. Command List: :DISPlay:CLEar  :DISPlay:TYPE  :DISPlay:GRADing:TIME  :DISPlay:WBRightness  :DISPlay:GRID ...
  • Page 80: Display:grading:time

    Chapter 2 Command System RIGOL :DISPlay:GRADing:TIME Syntax :DISPlay:GRADing:TIME <time> :DISPlay:GRADing:TIME? Description Sets or queries the persistence time. The default unit is s. Parameter Name Type Range Default <time> Discrete {MIN|0.1|0.2|0.5|1|2|5|10|INFinite} Remarks MIN: sets the persistence time to its minimum value to view how the waveform ...
  • Page 81: Display:gbrightness

    Chapter 2 Command System RIGOL is 140 mV. Return The query returns FULL, HALF, NONE, or IRE. Format Example :DISPlay:GRID NONE /*Turns off the background grid and coordinates.*/ :DISPlay:GRID? /*The query returns NONE.*/ :DISPlay:GBRightness Syntax :DISPlay:GBRightness <brightness> :DISPlay:GBRightness? Description Sets or queries the brightness of the screen grid, expressed in percentage.
  • Page 82: Display:color

    Chapter 2 Command System RIGOL :DISPlay:COLor Syntax :DISPlay:COLor <val> :DISPlay:COLor? Description Enables or disables the color grade display; or queries the on/off status of the color grade display. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Return The query returns 1 or 0.
  • Page 83: Dvm Commands

    Chapter 2 Command System RIGOL :DVM Commands Command List: :DVM:CURRent?  :DVM:ENABle  :DVM:SOURce  :DVM:MODE  :DVM:CURRent? Syntax DVM:CURRent? Description Queries the current voltage value under test. :DVM:ENABle Syntax :DVM:ENABle <bool> :DVM:ENABle? Description Enables or disables the digital voltmeter; or queries the on/off status of the digital voltmeter.
  • Page 84: Dvm:mode

    Chapter 2 Command System RIGOL :DVM:MODE Syntax :DVM:MODE <mode> :DVM:MODE? Description Sets or queries the mode of the digital voltmeter. Parameter Name Type Range Default {ACRMs|DC|DCRMs} <mode> Discrete ACRMs Description ACRMs: displays the root-mean-square value of the acquired data, with the DC ...
  • Page 85: Histogram Commands

    Chapter 2 Command System RIGOL :HISTogram Commands Command List: :HISTogram:DISPlay  :HISTogram:TYPE  :HISTogram:SOURce  :HISTogram:SIZE  :HISTogram:STATic  :HISTogram:RESet  :HISTogram:BLIMit  :HISTogram:LLIMit  :HISTogram:RLIMit  :HISTogram:TLIMit  :HISTogram:DISPlay Syntax :HISTogram:DISPlay <bool> :HISTogram:DISPlay? Description Enables or disables the histogram function; or queries the status of the histogram.
  • Page 86: Histogram:source

    Chapter 2 Command System RIGOL :HISTogram:SOURce Syntax :HISTogram:SOURce <source> :HISTogram:SOURce? Description Sets or queries the source of the histogram. Parameter Name Type Range Default {CHANnel1|CHANnel2|CHANnel3|CHA <source> Discrete Nnel4|MATH1|MATH2|MATH3|MATH4| OFF} Return The query returns CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, Format MATH4, or OFF.
  • Page 87: Histogram:blimit

    Chapter 2 Command System RIGOL :HISTogram:BLIMit Syntax :HISTogram:BLIMit <y> :HISTogram:BLIMit? Description Sets or queries the histogram's bottom boundary limit. Parameter Name Type Range Default -4× VerticalScale to 4× VerticalScale <y> Real (vertical scale of the channel source of the histogram) Return The query returns the histogram's bottom boundary limit in scientific notation.
  • Page 88: Histogram:tlimit

    Chapter 2 Command System RIGOL :HISTogram:TLIMit Syntax :HISTogram:TLIMit <y> :HISTogram:TLIMit? Description Sets or queries the histogram's top boundary limit. Parameter Name Type Range Default (-4× VerticalScale) to (4× VerticalScale) <y> Real (vertical scale of the channel source of the histogram) Return The query returns the histogram's top boundary limit in scientific notation.
  • Page 89: Ieee488.2 Common Commands

    Chapter 2 Command System RIGOL IEEE488.2 Common Commands The IEEE488.2 common commands are used to query the basic information of the instrument or executing basic operations. These commands usually start with "*", and the keywords in a command contain 3 characters.
  • Page 90: Idn

    *IDN? Syntax *IDN? Description Queries the instrument information. Return The query returns RIGOL TECHNOLOGIES,<model>,<serial number>,<software Format version>. Wherein, <model>: indicates the model number of the instrument. <serial number>: indicates the serial number of the instrument. <software version>: indicates the software version of the instrument.
  • Page 91: Sre

    Chapter 2 Command System RIGOL *SRE Syntax *SRE <maskargument> *SRE? Description Sets or queries the enable register of the status byte register set. Parameter Name Type Range Default <maskargument> Integer 0 to 255 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.
  • Page 92: La Commands

    Chapter 2 Command System RIGOL :LA Commands The :LA commands are used to perform relevant operations on the digital channels. The commands are only available for the MSO7000 series. Command List: :LA:STATe  :LA:ACTive  :LA:AUTOsort  :LA:DELete  :LA:DIGital<n>:DISPlay ...
  • Page 93: La:active

    Chapter 2 Command System RIGOL :LA:ACTive Syntax :LA:ACTive {<digital>|NONE} :LA:ACTive? Description Sets or queries the current active channel or channel group. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7| <digital> Discrete —— D8|D9|D10|D11|D12|D13|D14|D15|NONE} Remarks The parameter <digital> can be any of the digital channels (D0-D15). The ...
  • Page 94: La:digital:Display

    Chapter 2 Command System RIGOL :LA:DIGital<n>:DISPlay Syntax :LA:DIGital:DISPlay <digital>,<bool> :LA:DIGital:DISPlay? <digital> Description Turns on or off the specified digital channel; or queries the on/off status of the specified digital channel. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7| <digital> Integer —— D8|D9|D10|D11|D12|D13|D14|D15} <bool>...
  • Page 95: La:digital:Label

    Chapter 2 Command System RIGOL :LA:DIGital<n>:LABel Syntax :LA:DIGital:LABel <digital>,<label> :LA:DIGital:LABel? <digital> Description Sets or queries the label of the specified digital channel. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7| <digital> Integer —— D8|D9|D10|D11|D12|D13|D14|D15} ASCII The label can contain English letters and <label>...
  • Page 96: La:pod:Threshold

    Chapter 2 Command System RIGOL specified user-defined channel group. 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 ...
  • Page 97: La:tcalibrate

    Chapter 2 Command System RIGOL :LA:TCALibrate Syntax :LA:TCALibrate <tcal> :LA:TCALibrate? Description Sets or queries the delay calibration time of the digital channel. The default unit is s. Parameter Name Type Range Default <tcal> Real -1000 ns to 100 ns 0.00 s...
  • Page 98: Lan Commands

    Chapter 2 Command System RIGOL :LAN Commands The :LAN commands are used to set and query the LAN parameters. :LAN:DHCP  :LAN:AUToip  :LAN:GATeway  :LAN:DNS  :LAN:MAC?  :LAN:DSErver?  :LAN:MANual  :LAN:IPADdress  :LAN:SMASk  :LAN:STATus?  :LAN:VISA? ...
  • Page 99: Lan:autoip

    Chapter 2 Command System RIGOL :LAN:AUToip Syntax :LAN:AUToip <bool> :LAN:AUToip? Description Turns on or off the Auto IP configuration mode; or queries the on/off status of the current Auto IP configuration mode. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}}...
  • Page 100: Lan:mac

    Chapter 2 Command System RIGOL Return The query returns the current DNS address in strings. Format Example :LAN:DNS 192.168.1.1 /*Sets the DNS address to 192.168.1.1.*/ :LAN:DNS? /*The query returns the current DNS address.*/ :LAN:MAC? Syntax :LAN:MAC? Description Queries the MAC address of the instrument.
  • Page 101: Lan:ipaddress

    Chapter 2 Command System RIGOL :LAN:IPADdress Syntax :LAN:IPADdress <string> :LAN:IPADdress? Description Sets or queries the IP address of the instrument. Parameter Name Type Range Default <string> ASCII String Refer to Remarks —— Remarks The format of <string> is nnn,nnn,nnn,nnn. The range of the first section of ...
  • Page 102: Lan:visa

    Chapter 2 Command System RIGOL DHCPFAILED: the DHCP configuration has failed. INVALIDIP: invalid IP. IPLOSE: IP lost. :LAN:VISA? Syntax :LAN:VISA? Description Queries the VISA address of the instrument. Return Format The query returns the VISA address in strings. :LAN:MDNS Syntax :LAN:MDNS <bool>...
  • Page 103: Lan:apply

    Chapter 2 Command System RIGOL :LAN:APPLy Syntax :LAN:APPLy Description Applies the network configuration. MSO7000/DS7000 Programming Guide 2-89...
  • Page 104: Mask Commands

    Chapter 2 Command System RIGOL :MASK Commands The :MASK commands are used to set or query the relevant parameters of the pass/fail test. Command List: :MASK:ENABle  :MASK:SOURce  :MASK:OPERate  :MASK:MDISplay  :MASK:X  :MASK:Y  :MASK:CREate  :MASK:RESet ...
  • Page 105: Mask:operate

    Chapter 2 Command System RIGOL :MASK:OPERate Syntax :MASK:OPERate <oper> :MASK:OPERate? Description Runs or stops the pass/fail test; or queries the operating status of the pass/fail test. Parameter Name Type Range Default <oper> Discrete {RUN|STOP} STOP Description Before running this command, send the...
  • Page 106: Mask:x

    Chapter 2 Command System RIGOL :MASK:X Syntax :MASK:X <x> :MASK:X? Description Sets or queries the horizontal adjustment parameter of the pass/fail test mask. The default unit is div. Parameter Name Type Range Default <x> Real 0.01 div to 2 div 0.24 div...
  • Page 107: Math Commands

    Chapter 2 Command System RIGOL :MATH<n> Commands The :MATH<n> commands are used to set various math operation function of the waveform between channels. Note: The math operations include the following types:  arithmetic operations: A+B, A-B, A× B, A/B spectrum operation: FFT Logic operation: A&&B, A||B, A^B, !A...
  • Page 108: Math:Display

    Chapter 2 Command System RIGOL :MATH<n>:FILTer:TYPE  :MATH<n>:FILTer:W1  :MATH<n>:FILTer:W2  :MATH<n>:SENSitivity  :MATH<n>:DISTance  :MATH<n>:THReshold1  :MATH<n>:THReshold2  :MATH<n>:DISPlay Syntax :MATH<n>:DISPlay <bool> :MATH<n>:DISPlay? Description Enables or disables the math operation function; or queries the status of the math operation function.
  • Page 109: Math:Source1

    Chapter 2 Command System RIGOL :MATH<n>:SOURce1 Syntax :MATH<n>:SOURce1 <src> :MATH<n>:SOURce1? Description Sets or queries the source or Source A of arithmetic operation and function operation. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <src> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Remarks For arithmetic operation, this command is used to set Source A.
  • Page 110: Math:Lsource2

    Chapter 2 Command System RIGOL Example :MATH1:LSOUrce1 D3 /*Sets Source A of the logic operation to D3.*/ :MATH1:LSOUrce1? /*The query returns D3.*/ :MATH<n>:LSOUrce2 Syntax :MATH<n>:LSOUrce2 <src> :MATH<n>:LSOUrce2? Description Sets or queries Source B of the logic operation. Parameter Name Type...
  • Page 111: Math:Offset

    Chapter 2 Command System RIGOL :MATH<n>:OFFSet Syntax :MATH<n>:OFFSet <offset> :MATH<n>:OFFSet? Description Sets or queries the vertical offset of the operation results. The unit is related to the currently selected operator and the unit selected by the source. Parameter Name Type...
  • Page 112: Math:Fft:source

    Chapter 2 Command System RIGOL :MATH<n>:FFT:SOURce Syntax :MATH<n>:FFT:SOURce <src> :MATH<n>:FFT:SOURce? Description Sets or queries the channel source of FFT operation/filter. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <src> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|} CHANnel1 Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
  • Page 113: Math:Fft:unit

    Chapter 2 Command System RIGOL You can view the time-domain and frequency-domain signals clearly. OFF: the source channel and the FFT operation results are displayed in the same  window (on the full screen) to view the frequency spectrum more clearly and to perform more precise measurement.
  • Page 114: Math:Fft:offset

    Chapter 2 Command System RIGOL :MATH<n>:FFT:OFFSet Syntax :MATH<n>:FFT:OFFSet <offset> :MATH<n>:FFT:OFFSet? Description Sets or queries the vertical offset of FFT operation results. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <offset> Real -1 GdB to 1 GdB 0 dB Return The query returns the current vertical offset in scientific notation.
  • Page 115: Math:Fft:frequency:start

    Chapter 2 Command System RIGOL :MATH<n>:FFT:FREQuency:STARt Syntax :MATH<n>:FFT:FREQuency:STARt <value> :MATH<n>:FFT:FREQuency:STARt? Description Sets or queries the start frequency of FFT operation results. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <value> Real -2.5 GHz to 2.5 GHz 0 Hz Return The query returns the start frequency of the operation results in scientific notation.
  • Page 116: Math:Fft:search:num

    Chapter 2 Command System RIGOL :MATH<n>:FFT:SEARch:NUM Syntax :MATH<n>:FFT:SEARch:NUM <num> :MATH<n>:FFT:SEARch:NUM? Description Sets or queries the maximum number of the FFT peak search. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <num> Integer 1 to 15 Return The query returns an integer ranging from 1 to 15.
  • Page 117: Math:Fft:search:order

    Chapter 2 Command System RIGOL :MATH<n>:FFT:SEARch:ORDer Syntax :MATH<n>:FFT:SEARch:ORDer <order> :MATH<n>:FFT:SEARch:ORDer? Description Sets or queries the sequence of the FFT peak search results. Parameter Name Type Range Default <n> Discrete {1|2|3|4} —— <order> Discrete {AMPorder|FREQOrder} AMPorder Return The query returns AMPO or FREQ.
  • Page 118: Math:Filter:w1

    Chapter 2 Command System RIGOL :MATH<n>:FILTer:W1 Syntax :MATH<n>:FILTer:W1 <freq1> :MATH<n>:FILTer:W1? Description Sets or queries the cut-off frequency (ωc1) of Low Pass Filter/High Pass Filter; or the cut-off frequency 1 (ωc1) of Band Pass Filter/Band Stop Filter. The default unit is Hz.
  • Page 119: Math:Sensitivity

    Chapter 2 Command System RIGOL Example :MATH1:FILTer:W2 1500000 /*Sets the cut-off frequency 2 of Band Pass Filter to 1.5 MHz.*/ :MATH1:FILTer:W2? /*The query returns 1.500000E+6.*/ :MATH<n>:SENSitivity Syntax :MATH<n>:SENSitivity <sens> :MATH<n>:SENSitivity? Description Sets or queries the sensitivity of the logic opearation. The default unit is div.
  • Page 120: Math:Threshold2

    Chapter 2 Command System RIGOL VerticalOffset indicates the vertical offset of the current Source A. The step value is VerticalScale/10. Return The query returns the threshold level of the current Source A in scientific notation. Format Example :MATH1:THReshold1 0.8 /*Sets the threshold level of Source A in logic operation to 800 mV.*/...
  • Page 121: Measure Commands

    Chapter 2 Command System RIGOL :MEASure Commands The :MEASure commands are used to set and query the relevant parameters for measurement. Command List: :MEASure:SOURce  :MEASure:COUNter:ENABle  :MEASure:COUNter:SOURce  :MEASure:COUNter:VALue?  :MEASure:CLEar  :MEASure:THReshold:SOURce  :MEASure:THReshold:DEFault  :MEASure:MODE  :MEASure:AMSource ...
  • Page 122: Measure:counter:enable

    Chapter 2 Command System RIGOL Remarks Only the currently enabled channels can be selected. Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format D15, CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, or MATH4.
  • Page 123: Measure:clear

    Chapter 2 Command System RIGOL :MEASure:CLEar Syntax :MEASure:CLEar <item> Description Clears any one or all of the 10 measurement items that have been turned on. Parameter Name Type Range Default {ITEM1|ITEM2|ITEM3|ITEM4|ITEM5|ITEM6|I <item> Discrete —— TEM7|ITEM8|ITEM9|ITEM10|ALL} Remarks Run the :MEASure:ITEM command to open one of the 41 parameters that is required to be measured.
  • Page 124: Measure:amsource

    Chapter 2 Command System RIGOL :MEASure:AMSource Syntax :MEASure:AMSource <chan> :MEASure:AMSource? Description Sets the source and displays all measurement values of the set source; or queries the channel source (s) of the all measurement function. Parameter Name Type Range Default <chan>...
  • Page 125: Measure:setup:min

    Chapter 2 Command System RIGOL Return The query returns an integer. Format Example :MEASure:SETup:MID 89 /*Sets the middle value of the threshold level to 89%.*/ :MEASure:SETup:MID? /*The query returns 89.*/ :MEASure:SETup:MIN Syntax :MEASure:SETup:MIN <value> :MEASure:SETup:MIN? Description Sets or queries the threshold level lower limit of the analog channel in auto measurement.
  • Page 126: Measure:setup:psb

    Chapter 2 Command System RIGOL :MEASure:SETup:PSB Syntax :MEASure:SETup:PSB <source> :MEASure:SETup:PSB? Description Sets or queries Source B in the phase or delay measurement. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D <source> Discrete 12|D13|D14|D15|CHANnel1|CHANnel2|CHANnel CHANnel2 3|CHANnel4|MATH1|MATH2|MATH3|MATH4} Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format D15, CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, or MATH4.
  • Page 127: Measure:statistic:display

    Chapter 2 Command System RIGOL :MEASure:STATistic:DISPlay Syntax :MEASure:STATistic:DISPlay <bool> :MEASure:STATistic:DISPlay? Description Enables or disables the statistical function; or queries the status of the statistical function. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Remarks When the statistical function is enabled, the instrument makes statistics of the measurement results for at most 10 measurement items that are turned on last time and displays the statistical results.
  • Page 128: Measure:item

    Chapter 2 Command System RIGOL HANnel2|CHANnel3|CHANnel4|MATH1|MATH2|MATH3|MATH4}. If the measurement parameter is a single source, you only need to set one  source. If this parameter is omitted, then the source is by default, selected by :MEASure:SOURce command. If the measurement parameter is a dual channel source, then the command sent ...
  • Page 129: Measure:area

    Chapter 2 Command System RIGOL :MEASure:AREA Syntax :MEASure:AREA <area> :MEASure:AREA? Description Sets or queries the type of the measurement range. Parameter Name Type Range Default <area> Discrete {MAIN|ZOOM|CURSor} MAIN Remarks MAIN: indicates that the measurement range is within the main time base region.
  • Page 130: Measure:cregion:cbx

    Chapter 2 Command System RIGOL :MEASure:CREGion:CBX Syntax :MEASure:CREGion:CBX <cbx> :MEASure:CREGion:CBX? Description Sets or queries the position of Cursor B when the measurement range is the "cursor region". Parameter Name Type Range Default <cbx> Integer 0 to 1,000 Remarks The position of the cursor is defined by the pixel coordinate of the screen. The ...
  • Page 131: Power Commands

    Chapter 2 Command System RIGOL :POWer Commands Command List: :POWer:TYPE  :POWer:CURRentsource  :POWer:VOLTagesource  :POWer:QUALity:FREQREFerence  :POWer:REFLevel:METHod  :POWer:REFLevel:PERCent:HIGH  :POWer:REFLevel:PERCent:LOW  :POWer:REFLevel:PERCent:MID  :POWer:TYPE Syntax :POWer:TYPE <type> :POWer:TYPE? Description Sets or queries the power analysis type. Parameter Name...
  • Page 132: Power:voltagesource

    Chapter 2 Command System RIGOL :POWer:VOLTagesource Syntax :POWer:VOLTagesource <source> :POWer:VOLTagesource? Description Sets or queries the voltage source of power quality. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. Format Example :POWer:VOLTagesource CHANnel2 /*Sets the voltage source to CH2.*/...
  • Page 133: Power:reflevel:percent:high

    Chapter 2 Command System RIGOL :POWer:REFLevel:PERCent:HIGH Syntax :POWer:REFLevel:PERCent:HIGH <value> :POWer:REFLevel:PERCent:HIGH? Description Sets or queries the reference level percentage upper limit of power quality. Parameter Name Type Range Default <value> Integer (median+1) to 100 Remarks upper limit>median>lower limit Return The query returns an integer ranging from (median+1) to 100.
  • Page 134: Quick Commands

    Chapter 2 Command System RIGOL :Quick Commands The :Quick commands are used to set and query the relevant parameters for shortcut keys. Command List: :Quick:OPERation  :Quick:OPERation Syntax :Quick:OPERation <type> :Quick:OPERation? Description Sets or queries the type of the shortcut keys.
  • Page 135: Record Commands

    Chapter 2 Command System RIGOL :RECord Commands Command List: :RECord:ENABle  :RECord:STARt  :RECord:PLAY  :RECord:CURRent  :RECord:FRAMes  :RECord:ENABle Syntax :RECord:ENABle <bool> :RECord:ENABle? Description Enables or disables the waveform recording function; or queries the on/off status of the waveform recording function.
  • Page 136: Record:play

    Chapter 2 Command System RIGOL :RECord:PLAY Syntax :RECord:PLAY <bool> :RECord:PLAY? Description Enables or disables the waveform playing function; or queries the on/off status of the waveform playing function. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Return The query returns 1 or 0.
  • Page 137: Reference Commands

    Chapter 2 Command System RIGOL :REFerence Commands The :REFerence commands are used to set relevant parameters for reference waveforms. Command List: :REFerence:DISPlay  :REFerence:SOURce  :REFerence:VSCale  :REFerence:VOFFset  :REFerence:RESet  :REFerence:CURRent  :REFerence:SAVE  :REFerence:COLor  :REFerence:LABel:ENABle  :REFerence:LABel:CONTent ...
  • Page 138: Reference:vscale

    Chapter 2 Command System RIGOL Format D15, CHAN1, CHAN2, CHAN3, CHAN4, MATH1, MATH2, MATH3, or MATH4. Example :REFerence:SOURce 1,CHANnel1 /*Sets the source of the reference channel 1 to CH1.*/ :REFerence1:SOURce? 1 /*The query returns CHAN1.*/ :REFerence:VSCale Syntax :REFerence:VSCale <ref>,<scale> :REFerence:VSCale? <ref>...
  • Page 139: Reference:reset

    Chapter 2 Command System RIGOL :REFerence:RESet Syntax :REFerence:RESet <ref> Description Resets the vertical scale and vertical offset of the specified reference channel to the defaults. Parameter Name Type Range Default <ref> Discrete {1|2|3|4|5|6|7|8|9|10} —— :REFerence:CURRent Syntax :REFerence:CURRent <ref> Description Selects the specified reference channel.
  • Page 140: Reference:label:enable

    Chapter 2 Command System RIGOL :REFerence:LABel:ENABle Syntax :REFerence:LABel:ENABle <bool> :REFerence:LABel:ENABle? Description Enables or disables the display of all the labels; or queries the on/off display of all the labels. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Return Format The query returns 1 or 0.
  • Page 141: Save And :Load Commands

    Chapter 2 Command System RIGOL :SAVE and :Load Commands Command List: :SAVE:CSV  :SAVE:CSV:LENGth  :SAVE:FORMat  :SAVE:IMAGe  :SAVE:IMAGe:TYPE  :SAVE:IMAGe:INVert  :SAVE:IMAGe:COLor  :SAVE:SETup  :SAVE:WAVeform  :SAVE:STATus?  :LOAD:SETup  :SAVE:CSV Syntax :SAVE:CSV<path> Description Saves the waveform data displayed on the screen to the internal or external memory in "*.csv"...
  • Page 142: Save:format

    Chapter 2 Command System RIGOL Example :SAVE:CSV:LENGth MAXimum /*Sets the data length type to MAXimum.*/ :SAVE:CSV:LENGth? /*The query returns MAX.*/ :SAVE:FORMat Syntax :SAVE:FORMat <format> :SAVE:FORMat? Description Sets or queries the storage format. Parameter Name Type Range Default <format> Discrete {TRACe|WAVeform|SETup|PICTure|CSV}...
  • Page 143: Save:image:color

    Chapter 2 Command System RIGOL Description Enables or disables the invert function when saving the image; or queries whether the invert function is enabled when saving the image. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Return The query returns 1 or 0.
  • Page 144: Save:waveform

    Chapter 2 Command System RIGOL :SAVE:WAVeform Syntax :SAVE:WAVeform<path> Description Saves the waveform data to the internal or external memory. Parameter Name Type Range Default Refer to Remarks <path> ASCII String —— Remarks <path> includes the file storage location and the filename with a suffix. By default, its suffix is in ".bin"...
  • Page 145: Search Commands

    Chapter 2 Command System RIGOL :SEARch Commands Command List: :SEARch:STATe  :SEARch:MODE  :SEARch:EVENt  :SEARch:EDGE:SLOPe  :SEARch:EDGE:SOURce  :SEARch:PULSe:POLarity  :SEARch:PULSe:QUALifier  :SEARch:PULSe:SOURce  :SEARch:RUNT:POLarity  :SEARch:RUNT:QUALifier  :SEARch:RUNT:SOURce  :SEARch:SLOPe:POLarity  :SEARch:SLOPe:QUALifier  :SEARch:SLOPe:SOURce  :SEARch:STATe Syntax :SEARch:STATe <bool>...
  • Page 146: Search:mode

    Chapter 2 Command System RIGOL :SEARch:MODE Syntax :SEARch:MODE <value> :SEARch:MODE? Description Sets the search type. Parameter Name Type Range Default <value> Bool {EDGE|PULSe|RUNT|SLOPe|RS232|I2C|SPI} EDGE Remarks EDGE: selects "Edge" as the search type.  PULSe: selects "Pulse" as the search type.
  • Page 147: Search:edge:source

    Chapter 2 Command System RIGOL Return The query returns POS, NEG, or EITH. Format Example :SEARch:EDGE:SLOPe NEGative /*Sets the edge type to "NEGative".*/ :SEARch:EDGE:SLOPe? /*The query returns NEG.*/ :SEARch:EDGE:SOURce Syntax :SEARch:EDGE:SOURce <source> :SEARch:EDGE:SOURce? Description Sets or queries the source for the "Edge" search type.
  • Page 148: Search:pulse:source

    Chapter 2 Command System RIGOL 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. Return The query returns GRE, LESS, or GLES.
  • Page 149: Search:runt:source

    Chapter 2 Command System RIGOL GREater: triggers when the runt pulse width is greater than the lower limit of pulse  width. LESS: triggers when the runt pulse width is smaller than the upper limit of pulse  width. GLESs: triggers when the runt pulse width is greater than the lower limit and smaller ...
  • Page 150: Search:slope:qualifier

    Chapter 2 Command System RIGOL :SEARch:SLOPe:QUALifier Syntax :SEARch:SLOPe:QUALifier <qualifier> :SEARch:SLOPe:QUALifier? Description Sets or queries the search condition for "Slope" search type. Parameter Name Type Range Default <qualifier> Discrete {GREater|LESS|GLESs} GREater Remarks GReater: the positive slope time of the input signal is greater than the specified time.
  • Page 151: [:Source[]] Commands

    Chapter 2 Command System RIGOL [:SOURce[<n>]] Commands The [:SOURce[<n>]] commands are used to set the relevant parameters of the built-in function/arbitrary waveform generator. <n> can set to 1 or 2, which indicates the corresponding built-in function/arbitrary waveform generator channel. When <n> or :SOURce[<n>] is omitted, by default, the operations are carried out on AWG GI.
  • Page 152: [:Source[]]:Frequency[:Fixed]

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:FREQuency[:FIXed] Syntax [:SOURce[<n>]]:FREQuency[:FIXed] <frequency> [:SOURce[<n>]]:FREQuency[:FIXed]? Description 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. If modulation is enabled for the...
  • Page 153: [:Source[]]:Phase:initiate

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:PHASe:INITiate Syntax [:SOURce[<n>]]:PHASe:INITiate Description Performs the "align phase" operation. Parameter Name Type Range Default When omitted, by default, the operations are [<n>] Discrete {1|2} carried out on GI. Remarks When you perform the "align phase" operation, the instrument will re-configure the two channels to output according to the preset frequency and phase.
  • Page 154: [:Source[]]:Function:ramp:symmetry

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry Syntax [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry <val> [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry? Description Sets or queries the symmetry of the Ramp waveforms output from the specified function/arbitrary waveform generator channel. Parameter Name Type Range Default When omitted, by default, the [<n>] Discrete {1|2} operations are carried out on GI.
  • Page 155: [:Source[]]:Voltage[:Level][:Immediate]:Offset

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:OFFSet Syntax [:SOURce[<n>]]:VOLTage[:LEVel] [:IMMediate]:OFFSet <offset> [:SOURce[<n>]]:VOLTage[:LEVel] [:IMMediate]:OFFSet? Description Sets or query the DC offset of the signal output from the specified function/arbitrary waveform generator channel. By default, the unit is V Parameter Name Type Range...
  • Page 156: [:Source[]]:Mod:type

    Chapter 2 Command System RIGOL Return The query returns the current duty cycle in scientific notation. Format Example :PULSe:DCYCle 50 /*Sets the duty cycle of GI pulse to 50%.*/ :PULSe:DCYCle? /*The query returns 5.000000E+1.*/ [:SOURce[<n>]]:MOD:TYPE Syntax [:SOURce[<n>]]:MOD:TYPE <type> [:SOURce[<n>]]:MOD:TYPE? Description Sets or queries the modulation type of the specified function/arbitrary waveform generator channel.
  • Page 157: [:Source[]]:Mod:am:internal:frequency

    Chapter 2 Command System RIGOL When the modulation depth is greater than 100%, envelop distortion will occur.  This should be avoided in actual circuit. At this time, the output of the instrument will not exceed 5 Vpp (the load is 50 Ω).
  • Page 158: [:Source[]]:Mod:am:internal:function

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion [:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion Syntax [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion <wave> [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion? [:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion <wave> [:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion? Description Sets or queries the modulating waveform of AM or FM of the specified function/arbitrary waveform generator channel. Parameter Name Type Range Default When omitted, by default, [<n>]...
  • Page 159: [:Source[]]:Apply

    Chapter 2 Command System RIGOL When the modulating waveform amplitude reaches the maximum value, the  frequency of the carrier is increased by "frequency offset". When the modulating waveform amplitude reaches the minimum value, the frequency of the carrier is decreased by "frequency offset".
  • Page 160 Chapter 2 Command System RIGOL Sine: 0.1 Hz to 25 MHz Square: 0.1 Hz to 15 MHz <freq> Real Pulse: 0.1 Hz to 1 MHz 1kHz Ramp: 0.1 Hz to 100 kHz Arb: 0.1 Hz to 10 MHz Related to the currently set output impedance <amp>...
  • Page 161: [:Source[]]:Output[][:State]

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:OUTPut[<n>][:STATe] Syntax [:SOURce[<n>]]:OUTPut[<n>][:STATe] <bool> [:SOURce[<n>]]:OUTPut[<n>][:STATe]? Description 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. Parameter Name Type Range Default When omitted, by default, the [<n>]...
  • Page 162: System Commands

    Chapter 2 Command System RIGOL :SYSTem Commands The :SYSTem commands are used to set sound, language, and other relevant system settings. Command List: :SYSTem:AOUTput  :SYSTem:AUTOscale  :SYSTem:BEEPer  :SYSTem:DATE  :SYSTem:ERRor[:NEXT]?  :SYSTem:GAMount?  :SYSTem:GPIB  :SYSTem:KEY:PRESs  :SYSTem:KEY:INCRease ...
  • Page 163: System:aoutput

    Chapter 2 Command System RIGOL :SYSTem:AOUTput Syntax :SYSTem:AOUTput <aux output> :SYSTem:AOUTput? Description Sets or queries the type of the signal output from the [TRIG OUT] connector on the rear panel. Parameter Name Type Range Default <aux output> Discrete {TOUT|PFAil} TOUT...
  • Page 164: System:beeper

    Chapter 2 Command System RIGOL :SYSTem:BEEPer Syntax :SYSTem:BEEPer <bool> :SYSTem:BEEPer? Description Turns on or off the beeper; or queries the on/off status of the beeper. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Return The query returns 1 or 0.
  • Page 165: System:gpib

    Chapter 2 Command System RIGOL :SYSTem:GPIB Syntax :SYSTem:GPIB <adr> :SYSTem:GPIB? Description Sets or queries the GPIB address. Parameter Name Type Range Default <adr> Integer 1 to 30 Return The query returns an integer ranging from 1 to 30. Format Example :SYSTem:GPIB 2 /*Sets the GPIB address to 2.*/...
  • Page 166: System:key:increase

    Chapter 2 Command System RIGOL VSCale3: press down the vertical scale knob of CH3, i.g. switch the vertical scale of  CH3 to "Coarse" or "Fine". VSCale4: press down the vertical scale knob of CH4, i.g. switch the vertical scale of ...
  • Page 167: System:language

    Chapter 2 Command System RIGOL TLEVel: the trigger level adjustment knob. WVOLt: the vertical scale adjustment knob for the waveform. WPOSition: the vertical position adjustment knob for the waveform. The parameter <val> defines the specified rotation times of the knob. By default, ...
  • Page 168: System:pstatus

    To install the option, first purchase the required option to obtain the key, and then  use the key to obtain the option license according to the following steps. Log in to the RIGOL official website (www.rigol.com), click License  Activation to enter the "Registered product license code" interface.
  • Page 169: System:option:status

    Chapter 2 Command System RIGOL :SYSTem:OPTion:STATus? Syntax :SYSTem:OPTion:STATus? <type> Description Queries the status of the options of the oscilloscope. Parameter Name Type Range Default {BW12|BW13|BW15|BW23|BW2 5|BW35|MSO|RL2|RL5|BND|CO MP|EMBD|AUTO|AUDIO|SENSO <type> Discrete —— R|AERO|ARINC|DG|JITTer|MAS K|PWR|DVM|CTR|EDK} Return The query returns 0 or 1. Format 0: indicates that the option is not installed.
  • Page 170: System:ssaver:time

    Chapter 2 Command System RIGOL :SYSTem:SSAVEr:TIME Syntax :SYSTem:SSAVEr:TIME <time> :SYSTem:SSAVEr:TIME? Description Sets or queries the screen saver time. The default unit for the value is minute. Parameter Name Type Range Default 1 to 999 <time> Integer Remarks When the oscilloscope enters the idle state and holds for a specified time, the screen saver program will be enabled.
  • Page 171: System:modules

    Chapter 2 Command System RIGOL :SYSTem:MODules? Syntax :SYSTem:MODules? Description Queries the hardware modules. Return The query returns 1,0,0,0,0. The first figure indicates LA; the second figure indicates DG; Format and the others are not defined currently. 1 indicates not null, and 0 indicates null.
  • Page 172: Timebase Commands

    Chapter 2 Command System RIGOL :TIMebase Commands The :TIMebase commands are used to set the horizontal system. For example, enable the delayed sweep, set the horizontal time base mode, etc. Command List: :TIMebase:DELay:ENABle  :TIMebase:DELay:OFFSet  :TIMebase:DELay:SCALe  :TIMebase[:MAIN]:OFFSet ...
  • Page 173: Timebase:delay:scale

    Chapter 2 Command System RIGOL scale. Return The query returns the offset of the delayed time base in scientific notation. Format Example :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.*/...
  • Page 174: Timebase[:Main]:Scale

    The range of <scale> is related to the current horizontal time base mode of the oscilloscope and its model. YT mode  MSO7054/DS7054: 1 ns to 1000 s MSO7034/DS7034: 1 ns to 1000 s MSO7024/DS7024: 2 ns to 1000 s MSO7014/DS7014: 5 ns to 1000 s Roll mode ...
  • Page 175: Timebase:hreference:position

    Chapter 2 Command System RIGOL LB: when the horizontal time base is modified, the waveform displayed will be  expanded or compressed relative to the left border of the screen. RB: when the horizontal time base is modified, the waveform displayed will be ...
  • Page 176: Trigger Commands

    Chapter 2 Command System RIGOL :TRIGger Commands The :TRIGger commands are used to set the trigger system of the oscilloscope. Command List: :TRIGger:MODE  :TRIGger:COUPling  :TRIGger:STATus?  :TRIGger:SWEep  :TRIGger:HOLDoff  :TRIGger:NREJect  :TRIGger:EDGE  :TRIGger:PULSe  :TRIGger:SLOPe ...
  • Page 177: Trigger:mode

    Chapter 2 Command System RIGOL :TRIGger:MODE Syntax :TRIGger:MODE <mode> :TRIGger:MODE? Description Selects or queries the trigger type. Parameter Name Type Range Default {EDGE|PULSe|SLOPe|VIDeo|PATTern|DURation| <mode> Discrete TIMeout|RUNT|WINDow|DELay|SETup|NEDGe| EDGE RS232|IIC|SPI|CAN|FLEXray|LIN|IIS|M1553 Return The query returns EDGE, PULS, SLOP, VID, PATT, DUR, TIM, RUNT, WIND, DEL, SET, Format NEDG, RS232, IIC, SPI, CAN, CANF, FLEX, LIN, IIS, or M1553.
  • Page 178: Trigger:sweep

    Chapter 2 Command System RIGOL :TRIGger:SWEep Syntax :TRIGger:SWEep <sweep> :TRIGger:SWEep? Description Sets or queries the trigger mode. Parameter Name Type Range Default <sweep> Discrete {AUTO|NORMal|SINGle} AUTO Remarks AUTO: Auto trigger. The waveforms are displayed no matter whether the trigger ...
  • Page 179: Trigger:nreject

    Chapter 2 Command System RIGOL :TRIGger:NREJect Syntax :TRIGger:NREJect <bool> :TRIGger:NREJect? Description Turns on or off noise rejection; or queries the on/off status of noise rejection. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Remarks Noise rejection reduces the possibility of the Noise trigger.
  • Page 180 Chapter 2 Command System RIGOL Remarks POSitive: indicates the rising edge.  NEGative: indicates the falling edge.  RFALl: indicates the rising or falling edge.  Return The query returns POS, NEG, or RFAL. Format Example :TRIGger:EDGE:SLOPe NEGative /*Sets the edge type to Falling Edge.*/ :TRIGger:EDGE:SLOPe? /*The query returns NEG.*/...
  • Page 181: Trigger:pulse

    Chapter 2 Command System RIGOL :TRIGger:PULSe Command List: :TRIGger:PULSe:SOURce  :TRIGger:PULSe:WHEN  :TRIGger:PULSe:UWIDth  :TRIGger:PULSe:LWIDth  :TRIGger:PULSe:LEVel  :TRIGger:PULSe:SOURce Syntax :TRIGger:PULSe:SOURce <source> :TRIGger:PULSe:SOURce? Description Sets or queries the trigger source of Pulse trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11| <source>...
  • Page 182 Chapter 2 Command System RIGOL :TRIGger:PULSe:UWIDth Syntax :TRIGger:PULSe:UWIDth <width> :TRIGger:PULSe:UWIDth? Description Sets or queries the pulse upper limit of the Pulse trigger. The default unit is s. Parameter Name Type Range Default <width> Real Pulse lower limit to 10 s 2 μs...
  • Page 183: Trigger:slope

    Chapter 2 Command System RIGOL :TRIGger:SLOPe Command List: :TRIGger:SLOPe:SOURce  :TRIGger:SLOPe:WHEN  :TRIGger:SLOPe:TUPPer  :TRIGger:SLOPe:TLOWer  :TRIGger:SLOPe:WINDow  :TRIGger:SLOPe:ALEVel  :TRIGger:SLOPe:BLEVel  :TRIGger:SLOPe:SOURce Syntax :TRIGger:SLOPe:SOURce < channel > :TRIGger:SLOPe:SOURce? Description Sets or queries the trigger source of Slope trigger. Parameter...
  • Page 184 Chapter 2 Command System RIGOL :TRIGger:SLOPe:TUPPer Syntax :TRIGger:SLOPe:TUPPer <time> :TRIGger:SLOPe:TUPPer? Description Sets or queries the upper time limit value of the Slope trigger. The default unit is s. Parameter Name Type Range Default <time> Real Lower limit to 10 s 1 μs...
  • Page 185 Chapter 2 Command System RIGOL :TRIGger:SLOPe:ALEVel Syntax :TRIGger:SLOPe:ALEVel <level> :TRIGger:SLOPe:ALEVel? Description Sets or queries the upper limit of the trigger level of Slope trigger. The unit is the same as that of the current amplitude. Parameter Name Type Range Default Lower limit of the trigger level to <level>...
  • Page 186: Trigger:video

    Chapter 2 Command System RIGOL :TRIGger:VIDeo Command List: :TRIGger:VIDeo:SOURce  :TRIGger:VIDeo:POLarity  :TRIGger:VIDeo:MODE  :TRIGger:VIDeo:LINE  :TRIGger:VIDeo:STANdard  :TRIGger:VIDeo:LEVel  :TRIGger:VIDeo:SOURce Syntax :TRIGger:VIDeo:SOURce <channel> :TRIGger:VIDeo:SOURce? Description Sets or queries the trigger source of Video trigger. Parameter Name Type Range Default <source>...
  • Page 187 Chapter 2 Command System RIGOL :TRIGger:VIDeo:MODE Syntax :TRIGger:VIDeo:MODE <mode> :TRIGger:VIDeo:MODE? Description Sets or queries the sync type of Video trigger. Parameter Name Type Range Default <mode> Discrete {ODDField|EVENfield|LINE|ALINes} ALINes Remarks ODDField: indicates the odd field. The oscilloscope triggers on the rising edge of ...
  • Page 188 Chapter 2 Command System RIGOL :TRIGger:VIDeo:STANdard Syntax :TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard? Description Sets or queries the video standard of Video trigger. Parameter Name Type Range Default <standard> Discrete {PALSecam|NTSC|480P|576P} NTSC Remarks PALSecam:  PAL: indicates that the frame frequency is 25 frames per second. The TV scan line is 625, with the odd field going first and the even field following behind.
  • Page 189: Trigger:pattern

    Chapter 2 Command System RIGOL :TRIGger:PATTern Command List: :TRIGger:PATTern:PATTern  :TRIGger:PATTern:LEVel  :TRIGger:PATTern:SOURce  :TRIGger:PATTern:PATTern Syntax :TRIGger:PATTern:PATTern <pch1>[,<pch2>[,<pch3>[,<pch4>,<pla0>[,<pla1>[,<pla2>[,<pla3>[,<pla4>[,<p la5>[,<pla6>[,<pla7>[,<pla8>[,<pla9>[,<pla10>[,<pla11>[,<pla12>[,<pla13>[,< pla14>[,<pla15>]]]]]]]]]]]]]]]]]]]] :TRIGger:PATTern:PATTern? Description Sets or queries the channel pattern of Pattern trigger. Parameter Name Type Range Default <pch1> Discrete {H|L|X|R|F} <pch2>...
  • Page 190 Chapter 2 Command System RIGOL :TRIGger:PATTern:LEVel Syntax :TRIGger:PATTern:LEVel <source>,<level> :TRIGger:PATTern:LEVel? <source> Description Sets or queries the trigger level of the specified channel in Pattern trigger. The unit is the same as that of the current amplitude. Parameter Name Type Range...
  • Page 191: Trigger:duration

    Chapter 2 Command System RIGOL :TRIGger:DURATion Command List: :TRIGger:DURATion:SOURce  :TRIGger:DURATion:TYPE  :TRIGger:DURATion:WHEN  :TRIGger:DURATion:TUPPer  :TRIGger:DURATion:TLOWer  :TRIGger:DURation:LEVel  :TRIGger:DURATion:SOURce Syntax :TRIGger:DURATion:SOURce <source> :TRIGger:DURATion:SOURce? Description Sets or queries the trigger source of Duration trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D <source>...
  • Page 192 Chapter 2 Command System RIGOL channels "D0 to D15". In the parameter range, H indicates high level (higher than the threshold level of  the channel), L indicates low level (lower than the threshold level of the channel), and X indicates omitting the channel (This channel is not used as a part of the pattern.
  • Page 193 Chapter 2 Command System RIGOL :TRIGger:DURATion:TLOWer Syntax :TRIGger:DURATion:TLOWer <time> :TRIGger:DURATion:TLOWer? Description Sets or queries the lower limit of the duration time of Duration trigger. The default unit is s. Parameter Name Type Range Default <time> Real 800 ps to 10 s 1 μs...
  • Page 194: Trigger:timeout

    Chapter 2 Command System RIGOL :TRIGger:TIMeout Command List: :TRIGger:TIMeout:SOURce  :TRIGger:TIMeout:SLOPe  :TRIGger:TIMeout:TIME  :TRIGger:TIMeout:LEVel  :TRIGger:TIMeout:SOURce Syntax :TRIGger:TIMeout:SOURce <source> :TRIGger:TIMeout:SOURce? Description Sets or queries the trigger source of Timeout trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <source> Discrete D9|D10|D11|D12|D13|D14|D15|...
  • Page 195 Chapter 2 Command System RIGOL :TRIGger:TIMeout:TIME Syntax :TRIGger:TIMeout:TIME <time> :TRIGger:TIMeout:TIME? Description Sets or queries the timeout value of Timeout trigger. The default unit is s. Parameter Name Type Range Default <time> Real 16 ns to 1 s 1 μs Return The query returns the timeout value in scientific notation.
  • Page 196: Trigger:runt

    Chapter 2 Command System RIGOL :TRIGger:RUNT Command List: :TRIGger:RUNT:SOURce  :TRIGger:RUNT:POLarity  :TRIGger:RUNT:WHEN  :TRIGger:RUNT:WUPPer  :TRIGger:RUNT:WLOWer  :TRIGger:RUNT:ALEVel  :TRIGger:RUNT:BLEVel  :TRIGger:RUNT:SOURce Syntax :TRIGger:RUNT:SOURce <source> :TRIGger:RUNT:SOURce? Description Sets or queries the trigger source of Runt trigger. Parameter Name Type...
  • Page 197 Chapter 2 Command System RIGOL :TRIGger:RUNT:WHEN Syntax :TRIGger:RUNT:WHEN <when> :TRIGger:RUNT:WHEN? Description Sets or queries the qualifier of Runt trigger. Parameter Name Type Range Default <when> Discrete {NONE|GREater|LESS|GLESs} NONE Remarks NONE: indicates not setting the trigger condition of Runt trigger. ...
  • Page 198 Chapter 2 Command System RIGOL :TRIGger:RUNT:WLOWer Syntax :TRIGger:RUNT:WLOWer <width> :TRIGger:RUNT:WLOWer? Description Sets or queries the lower limit of the pulse width of Runt trigger. The default unit is s. Parameter Name Type Range Default <width> 8 ns to 9.9 s...
  • Page 199: Trigger:windows

    Chapter 2 Command System RIGOL :TRIGger:WINDows Command List: :TRIGger:WINDows:SOURce  :TRIGger:WINDows:SLOPe  :TRIGger:WINDows:POSition  :TRIGger:WINDows:TIME  :TRIGger:WINDows:ALEVel  :TRIGger:WINDows:BLEVel  :TRIGger:WINDows:SOURce Syntax :TRIGger:WINDows:SOURce <source> :TRIGger:WINDows:SOURce? Description Sets or queries the trigger source of Window trigger. Parameter Name Type Range Default <source>...
  • Page 200 Chapter 2 Command System RIGOL :TRIGger:WINDows:POSition Syntax :TRIGger:WINDows:POSition <pos> :TRIGger:WINDows:POSition? Description Sets or queries the trigger position of Window trigger. Parameter Name Type Range Default <type> Discrete {EXIT|ENTER|TIME} ENTER Remarks EXIT: triggers when the input signal exits the specified trigger level range.
  • Page 201 Chapter 2 Command System RIGOL :TRIGger:WINDows:BLEVel Syntax :TRIGger:WINDows:BLEVel <level> :TRIGger:WINDows:BLEVel? Description Sets or queries the lower limit of the trigger level of Window trigger. The unit is the same as that of the current amplitude. Parameter Name Type Range Default <level>...
  • Page 202: Trigger:delay

    Chapter 2 Command System RIGOL :TRIGger:DELay Command List: :TRIGger:DELay:SA  :TRIGger:DELay:SLOPa  :TRIGger:DELay:SB  :TRIGger:DELay:SLOPb  :TRIGger:DELay:TYPE  :TRIGger:DELay:TUPPer  :TRIGger:DELay:TLOWer  :TRIGger:DELay:ALEVel  :TRIGger:DELay:BLEVel  :TRIGger:DELay:SA Syntax :TRIGger:DELay:SA <Source> :TRIGger:DELay:SA? Description Sets or queries the trigger source of Source A in Delay trigger.
  • Page 203 Chapter 2 Command System RIGOL :TRIGger:DELay:SB Syntax :TRIGger:DELay:SB <source> :TRIGger:DELay:SB? Description Sets or queries the trigger source of Source B in Delay trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| <source> Discrete D11|D12|D13|D14|D15|CHANnel1|CHANn CHANnel2 el2|CHANnel3|CHANnel4} Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format D15, CHAN1, CHAN2, CHAN3, or CHAN4.
  • Page 204 Chapter 2 Command System RIGOL Return The query returns GRE, LESS, GLES, or GOUT. Format Example :TRIGger:DELay:TYPE GOUT /*Sets the delay type to "><".*/ :TRIGger:DELay:TYPE? /*The query returns GOUT.*/ :TRIGger:DELay:TUPPer Syntax :TRIGger:DELay:TUPPer <time> :TRIGger:DELay:TUPPer? Description Sets or queries the upper limit of delay time of the Delay trigger. The default unit is...
  • Page 205 Chapter 2 Command System RIGOL Return Format The query returns the upper limit of the trigger level in scientific notation. Example :TRIGger:DELay:ALEVel 0.16 /*Sets the upper limit of the trigger level to 160 mV.*/ :TRIGger:DELay:ALEVel? /*The query returns 1.600000E-1.*/ :TRIGger:DELay:BLEVel Syntax :TRIGger:DELay:BLEVel <level>...
  • Page 206: Trigger:shold

    Chapter 2 Command System RIGOL :TRIGger:SHOLd Command List: :TRIGger:SHOLd:DSrc  :TRIGger:SHOLd:CSRC  :TRIGger:SHOLd:SLOPe  :TRIGger:SHOLd:PATTern  :TRIGger:SHOLd:TYPE  :TRIGger:SHOLd:STIMe  :TRIGger:SHOLd:HTIMe  :TRIGger:SHOLd:DLEVel  :TRIGger:SHOLd:CLEVel  :TRIGger:SHOLd:DSrc Syntax :TRIGger:SHOLd:DSRC <source> :TRIGger:SHOLd:DSRC? Description Sets or queries the data source of Setup&Hold trigger.
  • Page 207 Chapter 2 Command System RIGOL :TRIGger:SHOLd:SLOPe Syntax :TRIGger:SHOLd:SLOPe <slope> :TRIGger:SHOLd:SLOPe? Description Sets or queries the edge type of Setup&Hold trigger. Parameter Name Type Range Default <slope> Discrete {POSitive|NEGative} POSitive Return The query returns POS or NEG. Format Example :TRIGger:SHOLd:SLOPe NEGative /*Sets the edge type to NEGative.*/...
  • Page 208 Chapter 2 Command System RIGOL :TRIGger:SHOLd:STIMe Syntax :TRIGger:SHOLd:STIMe <time> :TRIGger:SHOLd:STIMe? Description Sets or queries the setup time of Setup&Hold trigger. The default unit is s. Parameter Name Type Range Default <time> Real 8 ns to 1 s 1 μs Remarks Setup time indicates the time that the data remain stable and unchanged before ...
  • Page 209 Chapter 2 Command System RIGOL :TRIGger:SHOLd:CLEVel Syntax :TRIGger:SHOLd:CLEVel <level> :TRIGger:SHOLd:CLEVel? Description Sets or queries the trigger level of the clock source. The unit is the same as that of the current amplitude. Parameter Name Type Range Default (-5 × VerticalScale - OFFSet) to <level>...
  • Page 210: Trigger:nedge

    Chapter 2 Command System RIGOL :TRIGger:NEDGe Command List: :TRIGger:NEDGe:SOURce  :TRIGger:NEDGe:SLOPe  :TRIGger:NEDGe:IDLE  :TRIGger:NEDGe:EDGE  :TRIGger:NEDGe:LEVel  :TRIGger:NEDGe:SOURce Syntax :TRIGger:NEDGe:SOURce <source> :TRIGger:NEDGe:SOURce? Description Sets or queries the trigger source of the Nth Edge trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D <source>...
  • Page 211 Chapter 2 Command System RIGOL :TRIGger:NEDGe:IDLE Syntax :TRIGger:NEDGe:IDLE <time> :TRIGger:NEDGe:IDLE? Description Sets or queries the idle time of the Nth Edge trigger. The default unit is s. Parameter Name Type Range Default <time> Real 16 ns to 1 s 1 μs Return The query returns the idle time in scientific notation.
  • Page 212: Trigger:rs232 (Option)

    Chapter 2 Command System RIGOL :TRIGger:RS232 (Option) Command List: :TRIGger:RS232:SOURce  :TRIGger:RS232:WHEN  :TRIGger:RS232:PARity  :TRIGger:RS232:STOP  :TRIGger:RS232:DATA  :TRIGger:RS232:WIDTh  :TRIGger:RS232:BAUD  :TRIGger:RS232:LEVel  :TRIGger:RS232:SOURce Syntax :TRIGger:RS232:SOURce <source> :TRIGger:RS232:SOURce? Description Sets or queries the trigger source of RS232 trigger.
  • Page 213 Chapter 2 Command System RIGOL :TRIGger:RS232:PARity Syntax :TRIGger:RS232:PARity <parity> :TRIGger:RS232:PARity? Description Sets or queries the check mode of RS232 trigger. Parameter Name Type Range Default <parity> Discrete {EVEN|ODD|NONE} NONE Return Format The query returns EVEN, ODD, or NONe. Example :TRIGger:RS232:PARity EVEN /*Sets the check mode to Even.*/...
  • Page 214 Chapter 2 Command System RIGOL :TRIGger:RS232:WIDTh Syntax :TRIGger:RS232:WIDTh <width> :TRIGger:RS232:WIDTh? Description Sets or queries the data width of RS232 trigger when the trigger condition is "Data". Parameter Name Type Range Default <width> Discrete {5|6|7|8} Return Format The query returns 5, 6, 7, or 8.
  • Page 215: Trigger:iic (Option)

    Chapter 2 Command System RIGOL :TRIGger:IIC (Option) Command List: :TRIGger:IIC:SCL  :TRIGger:IIC:SDA  :TRIGger:IIC:WHEN  :TRIGger:IIC:AWIDth  :TRIGger:IIC:ADDRess  :TRIGger:IIC:DIRection  :TRIGger:IIC:DATA  :TRIGger:IIC:CLEVel  :TRIGger:IIC:DLEVel  :TRIGger:IIC:SCL Syntax :TRIGger:IIC:SCL <source> :TRIGger:IIC:SCL? Description Sets or queries the source channel of the clock line of I2C trigger.
  • Page 216 Chapter 2 Command System RIGOL :TRIGger:IIC:WHEN Syntax :TRIGger:IIC:WHEN <when> :TRIGger:IIC:WHEN? Description Sets or queries the trigger condition of I2C trigger. Parameter Name Type Range Default {STARt|RESTart|STOP|NACKnowledge|ADD <when> Discrete STARt Ress|DATA|ADATa} Remarks STARt: indicates that the oscilloscope triggers when SCL is high level and SDA ...
  • Page 217 Chapter 2 Command System RIGOL :TRIGger:IIC:ADDRess Syntax :TRIGger:IIC:ADDRess <address> :TRIGger:IIC:ADDRess? Description Sets or queries the address of I2C trigger when the trigger condition is "ADDRess" or "ADATa". Parameter Name Type Range Default <adr> Integer 0 to 2 - 1: 0 to 127, 0 to 255, or 0 to 1,023...
  • Page 218 Chapter 2 Command System RIGOL :TRIGger:IIC:CLEVel Syntax :TRIGger:IIC:CLEVel <level> :TRIGger:IIC:CLEVel? Description Sets or queries the trigger level of the clock line in I2C trigger. The unit is the same as that of the current amplitude. Parameter Name Type Range Default (-5 ×...
  • Page 219: Trigger:can (Option)

    Chapter 2 Command System RIGOL :TRIGger:CAN (Option) Command List: :TRIGger:CAN:BAUD  :TRIGger:CAN:SOURce  :TRIGger:CAN:STYPe  :TRIGger:CAN:WHEN  :TRIGger:CAN:SPOint  :TRIGger:CAN:LEVel  :TRIGger:CAN:BAUD Syntax :TRIGger:CAN:BAUD <baud> :TRIGger:CAN:BAUD? Description Sets or queries the signal rate of CAN trigger. The unit is bps.
  • Page 220 Chapter 2 Command System RIGOL :TRIGger:CAN:STYPe Syntax :TRIGger:CAN:STYPe <stype> :TRIGger:CAN:STYPe? Description Sets or queries the signal type of CAN trigger. Parameter Name Type Range Default <stype> Discrete {H|L|RXTX|DIFFerential} Return The query returns H, L, RXTX, or DIFF. Format Remarks H: indicates the actual CAN_H differential bus signal.
  • Page 221 Chapter 2 Command System RIGOL :TRIGger:CAN:SPOint Syntax :TRIGger:CAN:SPOint <spoint> :TRIGger:CAN:SPOint? Description Sets or queries the sample point position of CAN trigger (expressed in %). Parameter Name Type Range Default <spoint> Integer 10 to 90 Remarks Sample point is a point within a bit’s time. The oscilloscope samples the bit level at this point.
  • Page 222: Trigger:spi (Option)

    Chapter 2 Command System RIGOL :TRIGger:SPI (Option) Command List: :TRIGger:SPI:SCL  :TRIGger:SPI:SDA  :TRIGger:SPI:WHEN  :TRIGger:SPI:WIDTh  :TRIGger:SPI:DATA  :TRIGger:SPI:TIMeout  :TRIGger:SPI:SLOPe  :TRIGger:SPI:CLEVel  :TRIGger:SPI:DLEVel  :TRIGger:SPI:SLEVel  :TRIGger:SPI:MODE  :TRIGger:SPI:CS  :TRIGger:SPI:SCL Syntax :TRIGger:SPI:SCL <source> :TRIGger:SPI:SCL? Description Sets or queries the channel source of the clock line of SPI trigger.
  • Page 223 Chapter 2 Command System RIGOL :TRIGger:SPI:WHEN Syntax :TRIGger:SPI:WHEN <when> :TRIGger:SPI:WHEN? Description Sets or queries the trigger condition of SPI trigger. Parameter Name Type Range Default <when> Discrete {CS|TIMeout} Remarks When the trigger condition is "TIMeout", you can run the :TRIGger:SPI:TIMeout command to set the timeout value.
  • Page 224 Chapter 2 Command System RIGOL :TRIGger:SPI:TIMeout Syntax :TRIGger:SPI:TIMeout <time> :TRIGger:SPI:TIMeout? Description Sets or queries the timeout value when the trigger condition of SPI trigger is "Timeout". The default unit is s. Parameter Name Type Range Default <time_value> Real 16 ns to 1 s 1 μs...
  • Page 225 Chapter 2 Command System RIGOL :TRIGger:SPI:DLEVel Syntax :TRIGger:SPI:DLEVel <level> :TRIGger:SPI:DLEVel? Description Sets or queries the trigger level of the data channel of SPI trigger. The unit is the same as that of the current amplitude. Parameter Name Type Range Default (-5 ×...
  • Page 226 Chapter 2 Command System RIGOL :TRIGger:SPI:CS Syntax :TRIGger:SPI:CS <source> :TRIGger:SPI:CS? Description Sets or queries the source channel of the CS line when the trigger condition of SPI is set to CS. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D <source> Discrete 11|D12|D13|D14|D15|CHANnel1|CHANnel2...
  • Page 227: Trigger:flexray (Option)

    Chapter 2 Command System RIGOL :TRIGger:FLEXray (Option) Command List: :TRIGger:FLEXray:BAUD  :TRIGger:FLEXray:LEVel  :TRIGger:FLEXray:SOURce  :TRIGger:FLEXray:WHEN  :TRIGger:FLEXray:BAUD Syntax :TRIGger:FLEXray:BAUD <baud> :TRIGger:FLEXray:BAUD? Description Sets or queries the signal rate of FlexRay trigger. The default unit is bps. Parameter Name Type...
  • Page 228 Chapter 2 Command System RIGOL :TRIGger:FLEXray:SOURce Syntax :TRIGger:FLEXray:SOURce <source> :TRIGger:FLEXray:SOURce? Description Sets or queries the trigger source of FlexRay trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D <source> Discrete 11|D12|D13|D14|D15|CHANnel1|CHANnel2 CHANnel1 |CHANnel3|CHANnel4} Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format D15, CHAN1, CHAN2, CHAN3, or CHAN4.
  • Page 229: Trigger:iis (Option)

    Chapter 2 Command System RIGOL :TRIGger:IIS (Option) Command List: :TRIGger:IIS:ALIGnment  :TRIGger:IIS:CLOCk:SLOPe  :TRIGger:IIS:SOURce:CLOCk  :TRIGger:IIS:SOURce:DATA  :TRIGger:IIS:SOURce:WSELect  :TRIGger:IIS:WHEN  :TRIGger:IIS:AUDio  :TRIGger:IIS:DATA  :TRIGger:IIS:ALIGnment Syntax :TRIGger:IIS:ALIGnment <setting> :TRIGger:IIS:ALIGnment? Description Sets or queries the alignment mode of the I2S trigger.
  • Page 230 Chapter 2 Command System RIGOL :TRIGger:IIS:SOURce:CLOCk Syntax :TRIGger:IIS:SOURce:CLOCk <source> :TRIGger:IIS:SOURce:CLOCk? Description Sets or queries the clock source of the I2S trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D <source> Discrete 10|D11|D12|D13|D14|D15|CHANnel1| CHANnel1 CHANnel2|CHANnel3|CHANnel4|EXT} Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, Format D14, D15, CHAN1, CHAN2, CHAN3, CHAN4, or EXT.
  • Page 231 Chapter 2 Command System RIGOL :TRIGger:IIS:WHEN Syntax :TRIGger:IIS:WHEN <operator> :TRIGger:IIS:WHEN? Description Sets or queries the trigger condition of I2S trigger. Parameter Name Type Range Default {EQUal|NOTequal|LESSthan|GREaterthan| <operator> Discrete EQUal INRange|OUTRange} Description EQUal: triggers on when the channel's data value equals the set value.
  • Page 232 Chapter 2 Command System RIGOL :TRIGger:IIS:DATA Syntax :TRIGger:IIS:DATA <data> :TRIGger:IIS:DATA? Description Sets or queries the data value of the I2S trigger. Parameter Name Type Range Default 0 to 2 <data> Integer Description The settable range of <data> is affected by the byte length. The maximum byte length can be set to 4, i.g.
  • Page 233: Trigger:lin (Option)

    Chapter 2 Command System RIGOL :TRIGger:LIN (Option) Command List: :TRIGger:LIN:SOURce  :TRIGger:LIN:ID  :TRIGger:LIN:BAUD  :TRIGger:LIN:STANdard  :TRIGger:LIN:SAMPlepoint  :TRIGger:LIN:WHEN  :TRIGger:LIN:LEVel  :TRIGger:LIN:SOURce Syntax :TRIGger:LIN:SOURce <source> :TRIGger:LIN:SOURce? Description Sets or queries the trigger source of LIN trigger. Parameter Name...
  • Page 234 Chapter 2 Command System RIGOL :TRIGger:LIN:BAUD Syntax :TRIGger:LIN:BAUD <baud> :TRIGger:LIN:BAUD? Description Sets or queries the baud rate of LIN trigger. The default unit is bps. Parameter Name Type Range Default <baud> Integer 1 kbps to 20 Mbps 9600 bps Remarks If the baud rate is set to a value with "M", then "A"...
  • Page 235 Chapter 2 Command System RIGOL :TRIGger:LIN:WHEN Syntax :TRIGger:LIN:WHEN <when> :TRIGger:LIN:WHEN? Description Sets or queries the trigger condition of LIN trigger. Parameter Name Type Range Default {SYNCbreak|ID|DATA|IDData|SLEep|WAKeup| <when> Discrete ERRor} Description SYNCbreak: triggers on the last bit of the sync field.
  • Page 236: Trigger:m1553 (Option)

    Chapter 2 Command System RIGOL :TRIGger:M1553 (Option) Command List: :TRIGger:M1553:SOURce  :TRIGger:M1553:WHEN  :TRIGger:M1553:POLarity  :TRIGger:M1553:ALEVel  :TRIGger:M1553:BLEVel  :TRIGger:M1553:SOURce Syntax :TRIGger:M1553:SOURce <source> :TRIGger:M1553:SOURce? Description Sets or queries the trigger source of M1553 trigger. Parameter Name Type Range Default <source>...
  • Page 237 Chapter 2 Command System RIGOL :TRIGger:M1553:POLarity Syntax :TRIGger:M1553:POLarity <polarity> :TRIGger:M1553:POLarity? Description Sets or queries the polarity of M1553 trigger. Parameter Name Type Range Default <polarity> Discrete {POSitive|NEGative} POSitive Return The query returns POS or NEG. Format Example :TRIGger:M1553:POLarity POSitive /*Sets the polarity of M1553 trigger to POSitive.*/...
  • Page 238: Waveform Commands

    Chapter 2 Command System RIGOL :WAVeform Commands The :WAVeform commands are used to read waveform data and relevant settings. The:WAVeform:MODE command is used to set the reading mode of waveform data. In different modes, the definitions for the parameters are different, as shown in Figure 2-1 and 2-2.
  • Page 239: Waveform:source

    Chapter 2 Command System RIGOL :WAVeform:MODE  :WAVeform:FORMat  :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 <source> :WAVeform:SOURce? Description Sets or queries the source channel of waveform data reading.
  • Page 240: Waveform:format

    Chapter 2 Command System RIGOL Remarks NORMal: reads the waveform data currently displayed on the screen.  MAXimum: reads the waveform data displayed on the screen when the oscilloscope  is in the Run state; reads the waveform data in the internal memory when the oscilloscope is in the Stop state.
  • Page 241: Waveform:xincrement

    Chapter 2 Command System RIGOL S2. :WAV:MODE RAW Sets the waveform reading mode to RAW. S3. :WAV:FORM BYTE Sets the return format of the waveform data to BYTE. S4. :WAVeform:POINts 10000 Reads the number of memory waveform points to 10000.
  • Page 242: Waveform:xreference

    Chapter 2 Command System RIGOL In NORMal mode, the query returns the start time of the waveform data displayed on the screen. In RAW mode, the query returns the start time of the waveform data in the internal memory. In MAX mode, the query returns the start time of the waveform data displayed on the screen when the instrument is in the RUN state;...
  • Page 243: Waveform:yreference

    Chapter 2 Command System RIGOL :WAVeform:YREFerence? Syntax :WAVeform:YREFerence? Description Queries the vertical reference position of the currently selected channel source in the Y direction. Remarks The returned value is related to the current data reading mode. In NORMal mode, YREFerence is a fixed value 128 (screen bottom is 0 and screen top is 255).
  • Page 244: Waveform:preamble

    Chapter 2 Command System RIGOL the start point and stop point of a reading operation are related to the memory depth of the oscilloscope and the return format of the waveform data currently selected. Return The query returns an integer.
  • Page 245: Chapter 3 Programming Examples

    Chapter 3 Programming Examples RIGOL Chapter 3 Programming Examples This chapter illustrates how to control the MSO7000/DS7000 series digital oscilloscope by programming in Excel, LabVIEW, Visual Basic, and Visual C++. These instances are programmed based on Virtual Instrument Software Architecture (VISA) library.
  • Page 246: 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.
  • Page 247: Excel Programming Example

    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. Open a new Macro-enabled Excel file and name it "MSO7000_Demo_Excel.xlsm".
  • Page 248 Chapter 3 Programming Examples RIGOL 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.
  • Page 249 Chapter 3 Programming Examples 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"...
  • Page 250 Chapter 3 Programming Examples RIGOL 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?". Click the "*IDN?" button to send request and read data. The returned value is in CELLS(2,2) of SHEET1.
  • Page 251: Labview Programming Example

    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. Run LabVIEW, create a VI file and name it as MSO7000_Demo. Add controls and create the front panel as shown in the figure below.
  • Page 252 Chapter 3 Programming Examples RIGOL The data format is TMC header + waveform data points + terminator. The TMC header is in #NXXXXXX format, wherein, # is the TMC header denoter, N represents that there are N bytes following. The length of the waveform data points is described in ASCII character, and the terminator represents the ending of the communication.
  • Page 253 Chapter 3 Programming Examples RIGOL Used to obtain the waveform data length bytes. Used to delete the terminator at the end of the waveform data. Used to transfer waveform data strings to the byte group. The complete program block diagram is as shown in the figure below.
  • Page 254: Visual Basic Programming Example

    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.
  • Page 255 Chapter 3 Programming Examples RIGOL Dim defrm As Long Dim vi As Long Dim strRes As String * 200 Dim list As Long Dim nmatches As Long Dim matches As String * 200 ' Reserve the obtained device number Dim s32Disp As Integer...
  • Page 256: Visual C++ Programming Example

    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.
  • Page 257 Chapter 3 Programming Examples RIGOL Click Tools  Options to open the Options dialog box. Then, click the Directories tab. Select Include files from the drop-down list under Show directories for. Double click the empty space under Directories to enter the specified path of Include files: C:\Program Files\IVI Foundation\VISA\WinNT\include.
  • Page 258 Chapter 3 Programming Examples RIGOL Add the variables m_combox and m_receive to the Combo Box and Edit Box controls respectively. Add codes. Double-click Send and Read to enter the programming environment. Declare the #include <visa.h> of the VISA library in the header file and then add the following codes: ViSession defaultRM, vi;...
  • Page 259 Chapter 3 Programming Examples RIGOL viOpenDefaultRM (&defaultRM); //Acquire the USB resource of VISA viFindRsrc(defaultRM, "USB?*", &list,&nmatches, matches); viOpen (defaultRM,matches,VI_NULL,VI_NULL,&vi); //Send the command received m_combox.GetLBText(m_combox.GetCurSel(),strTemp); strTemp = strTemp + "\n"; stringTemp = (char*)(LPCTSTR)strTemp; viPrintf (vi,stringTemp); //Read the results viScanf (vi, "%t\n", &buf);...

This manual is also suitable for:

Ds7054Ds7024Ds7014Mso7034Mso7024Mso7014 ... Show all

Table of Contents