Specifications

ManualsBrandsRigol ManualsComputer equipmentM300 Series

RIGOL

Programming Guide

M300 Series

Data Acquisition/Switch System

Dec. 2013

RIGOL Technologies, Inc.

Summary of content (336 pages)

PAGE 1
RIGOL Programming Guide M300 Series Data Acquisition/Switch System Dec. 2013 RIGOL Technologies, Inc.
PAGE 2
PAGE 3
RIGOL Guaranty and Declaration Copyright © 2013 RIGOL Technologies, Inc. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL Technologies, Inc. Publication Number PGC07102-1110 Notices  RIGOL products are protected by patent law in and outside of P.R.C.  RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at company’s sole decision.  Information in this publication replaces all previously corresponding material.
PAGE 4
RIGOL Document Overview Main Contents in this Manual: Chapter 1 Programming Overview This chapter introduces how to build the remote communication between the instrument and PC. Besides, it also provides an overview of the syntax, symbol, parameter type and abbreviation rules of the SCPI commands as well as the SCPI status system. Chapter 2 Command System This chapter introduces the syntax, function, parameter and using instruction of each M300 command in A-Z order.
PAGE 5
RIGOL noted, “Multiplexer channels” refers to the MC3120, MC3132, MC3164, MC3232, MC3264 and MC3324 channels.
PAGE 6
RIGOL Contents Contents Guaranty and Declaration.......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 Programming Overview ..................................................................................... 1-1 To Build Remote Communication ...................................................................
PAGE 7
Contents RIGOL Appendix E: Module Schematic Diagram..................................................................................... 5-7 Appendix F: Command List ...................................................................................................... 5-11 Appendix G: Warranty .............................................................................................................
PAGE 8
PAGE 9
Chapter 1 Programming Overview RIGOL Chapter 1 Programming Overview This chapter introduces how to build the remote communication between the PC and instrument and provides an overview of the syntax, symbol, parameter type and abbreviation rules of the SCPI commands as well as the SCPI status system.
PAGE 10
RIGOL Chapter 1 Programming Overview To Build Remote Communication You can build the remote communication between M300 and PC over USB, LAN, RS232 or GPIB (IEEE-488) interface. Operation Steps: 1 Install the Ultra Sigma common PC software Download the Ultra Sigma common PC software from www.rigol.com and install it according to the instructions.
PAGE 11
Chapter 1 Programming Overview  RIGOL cable. Press Utility  I/O  RS232, select Print and then select "No" to deisable the measurement data print function of the RS232 interface. Set interface parameters (baud rate, flow control and etc) which match the PC or terminal equipment. (4) Use the GPIB interface:  Connect the instrument with your PC (GPIB card is installed) using a GPIB cable.  Press Utility  I/O  GPIB to set the GPIB address of the instrument.
PAGE 12
RIGOL Chapter 1 Programming Overview Remote Control Methods 1. Send SCPI Commands via the PC Software You can control the M300 Data Acquisition/Switch System remotely by sending SCPI commands via the PC software (Ultra Sigma) provided by RIGOL. Besides, you can also control the instrument using the “Measurement & Automation Explorer” of NI (National Instruments Corporation) or the “Agilent IO Libraries Suite” of Agilent (Agilent Technologies, Inc.). 2.
PAGE 13
Chapter 1 Programming Overview RIGOL SCPI Command Overview SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming language that is built upon the standard IEEE488.1 and IEEE 488.2 and conforms to various standards (such as the floating point operation rule in IEEE754 standard, ISO646 7-bit coded character for information interchange (equivalent to ASCll programming)).
PAGE 14
RIGOL 4. Chapter 1 Programming Overview Triangle Brackets < > The parameter enclosed in the triangle brackets must be replaced by an effective value. For example, send the SYSTem:UTIlity:DISPlay:BRIGht command in SYSTem:UTIlity:DISPlay:BRIGht 5 form. Parameter Type The parameters of the commands introduced in this manual contains 7 types: Scan list/Channel list/Channel, bool, integer, discrete, numeric, ASCII character string and filename. 1.
PAGE 15
Chapter 1 Programming Overview RIGOL Command Abbreviation All the commands are case-insensitive and you can use any of them. If abbreviation is used, all the capital letters in the command must be written completely. For example, the CALCulate:AVERage:SDEV? (@201) command can be abbreviated to CALC:AVER:SDEV? (@201).
PAGE 16
RIGOL Chapter 1 Programming Overview SCPI Status System This chapter introduces the SCPI status system of M300. M300 status system is shown in Figure 1-2. The five register groups are used to record a variety of conditions and status of the instrument. Each register group contains multiple underlying registers (condition register, event register and enable register).  Condition register The condition register monitors the instrument status continuously and the status of each bit is updated in real time.
PAGE 17
RIGOL Chapter 1 Programming Overview Read the event register from the relative register group (only the corresponding bits in the event register of the relative register group are cleared). The status byte enable register is cleared when:  Send the *SRE 0 command.  The status byte enable register will be cleared when restarting the instrument after sending the *PSC 1 command to set the instrument to clear all the bits in the enable register at power-on.
PAGE 18
PAGE 19
Chapter 2 Command System RIGOL Chapter 2 Command System This chapter introduces the syntax, function, parameter and using instruction of each M300 command in A-Z order. Main topics of this chapter:  ABORt  CALCulate Command Subsystem  CONFigure Command Subsystem  DATA Command Subsystem  DIAGnostic Command Subsystem  DISPlay Command Subsystem  FETCh?  FORMat Command Subsystem  IEEE-488.
PAGE 20
RIGOL Chapter 2 Command System ABORt Syntax ABORt Description Abort the current measurement and stop the scan. Explanation  The instrument stops the current scan when receiving this command and the scan cannot be resumed. All the previous readings will be cleared when you initiate a new scan.  The *RST command will abort the current measurement, clear the scan list, and set all the measurement parameters to their factory settings.
PAGE 21
Chapter 2 Command System RIGOL CALCulate Command Subsystem M300 supports the scaling function and alarm function. You can configure the scaling parameters and alarm parameters for the channels in scan list. The DMM module stores the measurement readings and performs statistical calculations during the scan process. You can query the statistical calculation results at any time (even during a scan).
PAGE 22
RIGOL Chapter 2 Command System CALCulate:AVERage:AVERage? CALCulate:AVERage:MAXimum? CALCulate:AVERage:MINimum? CALCulate:AVERage:PTPeak? CALCulate:AVERage:SDEV? Syntax CALCulate:AVERage:AVERage? [(@)] CALCulate:AVERage:MAXimum? [(@)] CALCulate:AVERage:MINimum? [(@)] CALCulate:AVERage:PTPeak? [(@)] CALCulate:AVERage:SDEV? [(@)] Description Parameters Query the statistical calculation results (average, maximum, minimum, peak to peak and standard deviation) of
PAGE 23
RIGOL Chapter 2 Command System CALCulate:AVERage:CLEar Syntax Description Parameters CALCulate:AVERage:CLEar [(@)] Clear all the statistical calculation results (average, maximum, minimum, peak to peak, standard deviation and count values) of the specified channels.
PAGE 24
RIGOL Chapter 2 Command System CALCulate:AVERage:COUNt? Syntax Description Parameters CALCulate:AVERage:COUNt? [(@)] Query the number of readings taken on each of the specified channels.
PAGE 25
RIGOL Chapter 2 Command System CALCulate:AVERage:MAXimum:TIME? CALCulate:AVERage:MINimum:TIME? Syntax CALCulate:AVERage:MAXimum:TIME? [(@)] CALCulate:AVERage:MINimum:TIME? [(@)] Description Parameters Query the time that the maximum or minimum reading was taken on the specified channels during the scan.
PAGE 26
RIGOL Chapter 2 Command System CALCulate:COMPare:DATA Syntax CALCulate:COMPare:DATA [,(@)] CALCulate:COMPare:DATA? [(@)] Description Parameters Set the alarm value of the input signal of the specified DIO channel.
PAGE 27
RIGOL Chapter 2 Command System CALCulate:COMPare:MASK Syntax CALCulate:COMPare:MASK [,(@)] CALCulate:COMPare:MASK? [(@)] Description Parameters Pattern comparisons can compare just the specified bits and ignore the other bits. This command sets the pattern of the active bits and the bits to be ignored (named the mask value) for the pattern comparison on the specified DIO channel.
PAGE 28
RIGOL Chapter 2 Command System CALCulate:COMPare:STATe Syntax CALCulate:COMPare:STATe [,(@ch_list)] CALCulate:COMPare:STATe? [(@)] Description Parameters This command disables or enables the pattern comparison mode on the specified digital input channels.
PAGE 29
RIGOL Chapter 2 Command System CALCulate:COMPare:TYPE Syntax CALCulate:COMPare:TYPE [,(@)] CALCulate:COMPare:TYPE? [(@)] Description Parameters This command sets the pattern comparison mode for the specified digital input channels. The instrument will generate an alarm when the digital input value is the same as or different from the pattern defined.
PAGE 30
RIGOL Chapter 2 Command System CALCulate:LIMit:LOWer CALCulate:LIMit:UPPer Syntax CALCulate:LIMit:LOWer {|MAX|MIN}[,(@)] CALCulate:LIMit:LOWer? [(@)] CALCulate:LIMit:UPPer {|MAX|MIN}[,(@)] CALCulate:LIMit:UPPer? [(@)] Description Parameters Set the alarm lower and upper limits of the specified channels. Name Type Numeric Range Default Multiplexer channel: any numeric value between MIN and MAX MIN=-1.000000000E+15 MAX=+1.
PAGE 31
RIGOL Chapter 2 Command System Example CALC:LIM:LOW 4.5,(@101) CALC:LIM:LOW? (@101) The query returns +4.500000000E+00. You can replace LOW with UPP to set and query the upper limits of the specified channels.
PAGE 32
RIGOL Chapter 2 Command System CALCulate:SCALe:SQUare CALCulate:SCALe:GAIN CALCulate:SCALe:OFFSet CALCulate:SCALe:CONStant Syntax CALCulate:SCALe:SQUare {|MAX|MIN}[,(@)] CALCulate:SCALe:SQUare? [(@)] CALCulate:SCALe:GAIN {|MAX|MIN}[,(@)] CALCulate:SCALe:GAIN? [(@)] CALCulate:SCALe:OFFSet {|MAX|MIN}[,(@)] CALCulate:SCALe:OFFSet? [(@)] CALCulate:SCALe:CONStant {|MAX|MIN}[,(@)] CALCulate:SCALe:CONStant? [(@
PAGE 33
RIGOL Chapter 2 Command System Return Format Example The query returns the coefficients in scientific notation. Multiple return values are separated by commas. CALC:SCAL:SQU 10,(@101) CALC:SCAL:SQU? (@101) CALC:SCAL:GAIN 25,(@101) CALC:SCAL:GAIN? (@101) CALC:SCAL:OFFS 15,(@101) CALC:SCAL:OFFS? (@101) CALC:SCAL:CONS 5,(@101) CALC:SCAL:CONS? (@101) The query returns +1.000000000E+01 +2.500000000E+01 +1.500000000E+01 +5.
PAGE 34
RIGOL Chapter 2 Command System CALCulate:SCALe:STATe Syntax CALCulate:SCALe:STATe [,(@)] CALCulate:SCALe:STATe? [(@)] Description Parameters Disable or enable the scaling function of the specified channels.
PAGE 35
RIGOL Chapter 2 Command System CALCulate:SCALe:UNIT Syntax CALCulate:SCALe:UNIT [,(@)] CALCulate:SCALe:UNIT? [(@)] Description Parameters Specify the uint of the scaled readings of the specified channels. It will affect the unit of the readings when storing the measurement data.
PAGE 36
RIGOL Related commands Chapter 2 Command System CALCulate:SCALe:SQUare CALCulate:SCALe:GAIN CALCulate:SCALe:OFFSet CALCulate:SCALe:CONStant CALCulate:SCALe:STATe CALCulate:SCALe:OFFSet:NULL 2-18 M300 Programming Guide
PAGE 37
Chapter 2 Command System RIGOL CONFigure Command Subsystem The CONFigure commands are used to configure the measurement function of the specified channel with the specified parameters, but do not start the scan. After finishing the configuration using the CONFigure commands, you can send the INITiate command to start the scan and then send the READ? command to read the measurment value.
PAGE 38
RIGOL Chapter 2 Command System CONFigure? Syntax Description Parameters CONFigure? [(@)] Query the current configuration of the specified channels.
PAGE 39
RIGOL Chapter 2 Command System Example CONF? (@301,305,401) The query returns "DIG OUTP BYTE","TOT RRES","VOLT +2.000000E+01,+6.000000E-05" Related command CONFigure Command Subsystem CONFigure:ANYSensor Syntax Description Parameters CONFigure:ANYSensor [{|DEF},](@) Configure the specified channel as the specified anysensor measurement function, but do not start the scan.
PAGE 40
RIGOL Chapter 2 Command System CONFigure:COPY:CH:CH Syntax Description Parameters CONFigure:COPY:CH:CH (@),(@) Copy the configuration of the source channel (specified by ) to the destination channels (specified by ), namely channel copy.
PAGE 41
RIGOL Chapter 2 Command System The query returns "VOLT +2.000000E+01,+6.000000E-06","VOLT +2.000000E+01,+6.000000E-06". Related command CONFigure Command Subsystem CONFigure:COPY:CH:SLOT Syntax Description Parameters Explanation Example CONFigure:COPY:CH:SLOT (@), Copy the configuration of the source channel (specified by ) to all the channels (of which the type is the same with that of the source channel) of the destination module (specified by ), namely extended copy.
PAGE 42
RIGOL Chapter 2 Command System CONFigure:COPY:SLOT:SLOT Syntax Description Parameters Explanation Example CONFigure:COPY:SLOT:SLOT , Copy the configuration of the source module (specified by ) to the destination module (specified by ), namely module copy. Name Type Range Default Discrete 100/200/300/400/500: the slot number of the source module. None Discrete 100/200/300/400/500: the slot number of the destination module.
PAGE 43
RIGOL Chapter 2 Command System CONFigure:CURRent:AC Syntax Description Parameters CONFigure:CURRent:AC [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],](@) Configure the specified channels to the ACI measurement function with the specified range and resolution, but do not initiate the scan. Name Type Range Default Numeric Any numeric value between MIN and MAX. The final range is decided by the “Principle of setting with greater value”.
PAGE 44
RIGOL Related commands Chapter 2 Command System CONFigure? INITiate READ? 2-26 M300 Programming Guide
PAGE 45
RIGOL Chapter 2 Command System CONFigure:CURRent[:DC] Syntax Description Parameters CONFigure:CURRent[:DC] [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],](@) Configure the specified channels to the DCI measurement function with the specified range and resolution, but do not initiate the scan. Name Type Range Default Numeric Any numeric value between MIN and MAX. The final range is decided by the “Principle of setting with greater value”.
PAGE 46
RIGOL Example Related commands Chapter 2 Command System 100PLC 0.035ppm× 200PLC 0.03ppm× (MIN)  If the input signal is greater than can be measured on the selected range, the instrument gives an overload indication: "OVERLOAD" from the front panel or "±9.9E+37" from the remote interface.  The *RST command will clear the scan list and set all the measurement parameters to their factory settings.
PAGE 47
RIGOL Chapter 2 Command System CONFigure:DIGital:BYTE CONFigure:DIGital:DWORd CONFigure:DIGital:WORD Syntax CONFigure:DIGital:BYTE (@) CONFigure:DIGital:DWORd (@) CONFigure:DIGital:WORD (@) Description Parameters Set the bits of the DIO channels when they are used as the digital input terminals. BYTE represents 8-bit, WORd represents 16-bit and DWORd represents 32-bit. This command does not initiate the scan.
PAGE 48
RIGOL Chapter 2 Command System CONFigure:FREQuency CONFigure:PERiod Syntax CONFigure:FREQuency [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],](@) CONFigure:PERiod [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],](@) Description Parameters Configure the specified channels to the frequency or period measurement function with the specified gate time, but do not initiate the scan. Name Type Range Default Numeric Any numeric value.
PAGE 49
RIGOL Chapter 2 Command System CONFigure:FRESistance CONFigure:RESistance Syntax CONFigure:FRESistance [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],](@) CONFigure:RESistance [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],](@) Description Parameters Configure the specified channels to the 2-wire resistance or 4-wire resistance measurement function with the specified range and resolution, but do not initiate the scan.
PAGE 50
RIGOL Chapter 2 Command System  Example Related commands is related to the current integration time and range (). The relations are as shown in the table below. Integration Time Resolution 0.02PLC 3ppm× (MAX) 0.2PLC 0.7ppm× 1PLC 0.3ppm× (DEF) 2PLC 0.2ppm× 10PLC 0.1ppm× 20PLC 0.06ppm× 100PLC 0.035ppm× 200PLC 0.
PAGE 51
RIGOL Chapter 2 Command System CONFigure:TEMPerature Syntax Description Parameters CONFigure:TEMPerature {|DEF},{|DEF}[,1[,{|MIN|MAX|DEF}]],(@) Configure the specified channels to the temperature measurement function, but do not initiate the scan.
PAGE 52
RIGOL Chapter 2 Command System CONFigure:TOTalize Syntax Description Parameters CONFigure:TOTalize [],(@) Set the reading mode of the TOT channel of the specified channels. This command does not initiate the scan.
PAGE 53
RIGOL Chapter 2 Command System CONFigure:VOLTage:AC Syntax Description Parameters CONFigure:VOLTage:AC [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],](@) Configure the specified channels to the ACV measurement function with the specified range and resolution. This command does not initiate the scan. Name Type Range Default Numeric Any numeric value between MIN and MAX. The final range is decided by the “Principle of setting with greater value”.
PAGE 54
RIGOL Related commands Chapter 2 Command System CONFigure? INITiate READ? 2-36 M300 Programming Guide
PAGE 55
RIGOL Chapter 2 Command System CONFigure:VOLTage[:DC] Syntax Description Parameters CONFigure:VOLTage[:DC] [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],](@) Configure the specified channels to the DCV measurement function with the specified range and resolution. This command does not initiate the scan. Name Type Range Default Numeric Any numeric value between MIN and MAX. The final range is decided by the “Principle of setting with greater value”.
PAGE 56
RIGOL Example Related commands Chapter 2 Command System 100PLC 0.035ppm× 200PLC 0.03ppm× (MIN)  The *RST command will clear the scan list and set all the measurement parameters to their factory settings. The Instrument Preset (the SYSTem:PRESet command) will not clear the scan list; however, this command will clear the data in the reading memory.
PAGE 57
RIGOL Chapter 2 Command System DATA Command Subsystem  DATA:LAST?  DATA:POINts?  DATA:POINts:EVENt:THReshold  DATA:REMove? DATA:LAST? Syntax Description Parameters DATA:LAST? [,](@) Query the most recent reading or readings taken on the specified channel during the scan. Name Type Range Default Integer 1 to the number of readings stored in the internal memory for the specified channel.
PAGE 58
RIGOL Chapter 2 Command System Related commands DATA Command Subsystem FORMat Command Subsystem SYSTem:DATE SYSTem:TIME DATA:POINts? Syntax DATA:POINts? Description Query the total number of readings currently stored in the reading memory. Explanation  You can send this command to query the total number of readings during or after a scan.  During the scan, you can store at most 10,0000 readings and all the readings are automatically time stamped.
PAGE 59
RIGOL Chapter 2 Command System DATA:POINts:EVENt:THReshold Syntax DATA:POINts:EVENt:THReshold DATA:POINts:EVENt:THReshold? Description Parameters Explanation Return Format Example Bit9 in the event register of the standard operation register set is set to 1 when the number of stored readings in the reading memory is greater the specified value (the memory threshold). These commands are used to set and query the memory threshold.
PAGE 60
RIGOL Chapter 2 Command System DATA:REMove? Syntax Description Parameters Explanation Return Format Example DATA:REMove? Read and clear the specified number () of readings (the oldest readings) from the non-volatile memory (refer to Appendix C: Non-volatile Memory). Name Type Range Default Integer 1 to 10,0000 None  If the memory overflows during a scan, the new readings will overwrite the oldest readings stored.
PAGE 61
RIGOL Chapter 2 Command System DIAGnostic Command Subsystem  DIAGnostic:DMM:CYCLes?  DIAGnostic:DMM:CYCLes:CLEar  DIAGnostic:PEEK:SLOT:DATA  DIAGnostic:POKE:SLOT:DATA  DIAGnostic:RELay:CYCLes?  DIAGnostic:RELay:CYCLes:CLEar DIAGnostic:DMM:CYCLes? Syntax DIAGnostic:DMM:CYCLes? Description Query the cycle count of the 6 relays on the DMM module.
PAGE 62
RIGOL Chapter 2 Command System DIAGnostic:PEEK:SLOT:DATA DIAGnostic:POKE:SLOT:DATA Syntax DIAGnostic:PEEK:SLOT:DATA? {100|200|300|400|500} DIAGnostic:POKE:SLOT:DATA {100|200|300|400|500}, Description Parameters Description Return Format Example The POKE command is used to define the labels for the 5 module slots. The PEEK command is used to query the label of the specified slot.
PAGE 63
RIGOL Chapter 2 Command System DIAGnostic:RELay:CYCLes? Syntax Description Parameters DIAGnostic:RELay:CYCLes? (@) Query the cycle count of the relays of the specified channels.
PAGE 64
RIGOL Chapter 2 Command System DIAGnostic:RELay:CYCLes:CLEar Syntax Description Parameters DIAGnostic:RELay:CYCLes:CLEar (@) Reset the cycle count of the specified channel relays.
PAGE 65
RIGOL Chapter 2 Command System DISPlay Command Subsystem  DISPlay  DISPlay:TEXT  DISPlay:TEXT:CLEar DISPlay Syntax DISPlay DISPlay? Description Parameters Explanation Return Format Example Turn on or off the front-panel display. Name Type Range Default Bool {OFF|0|ON|1} ON  When turned off, the entire front-panel display goes dark and all the status icons except Error are disabled.  are disabled when the display is off.
PAGE 66
RIGOL Chapter 2 Command System DISPlay:TEXT Syntax DISPlay:TEXT DISPlay:TEXT? Description Parameters Send the text message to be displayed and the message will be displayed on the front-panel display. Name Explanation Return Format Example Type Range Default ASCII String A string of up to 19 characters enclosed in double quotation marks or single quotation mark. It can contain English letters (a-z, A-Z), numbers (0-9) and special characters (such as @, % and *).
PAGE 67
Chapter 2 Command System RIGOL FETCh? Syntax FETCh? Description Send the readings stored in the non-volatile memory (refer to Appendix C: Non-volatile Memory) to the output buffer of the instrument without clearing the readings stored in memory. Explanation  The FETCh? command will wait until the scan is complete to terminate.  Each time you start a new scan, the instrument clears all the readings (including the alarm data) stored in the reading memory from the previous measurement.
PAGE 68
RIGOL Chapter 2 Command System FORMat Command Subsystem During a scan, the instrument automatically adds a time stamp to all the readings and stores them in the memory. Each reading is also stored with the corresponding information, including the measurement units, time stamp, channel number and alarm status information. You can set return value format of the scan result query commands (the R?, READ?, FETCh? commands and etc.
PAGE 69
RIGOL Chapter 2 Command System FORMat:READing:ALARm Syntax FORMat:READing:ALARm FORMat:READing:ALARm? Description Parameters Explanation Return Format Example Disable or enable the alarm information in the return redings of the scan result query commands (such as the READ? command, the R? command and the FETCh? command). Name Type Range Default Bool OFF|0|ON|1 OFF  The setting applies to all the readings aquired in the scan.
PAGE 70
RIGOL Chapter 2 Command System FORMat:READing:CHANnel Syntax FORMat:READing:CHANnel FORMat:READing:CHANnel? Description Parameters Explanation Return Format Example Disable or enable the channel number in the return redings of the scan result query commands (such as the READ? command, the R? command and the FETCh? command). Name Type Range Default Bool OFF|0|ON|1 OFF  The setting applies to all the readings aquired in the scan.
PAGE 71
RIGOL Chapter 2 Command System FORMat:READing:TIME Syntax FORMat:READing:TIME FORMat:READing:TIME? Description Parameters Explanation Return Format Example Disable or enable the time stamp in the return redings of the scan result query commands (such as the READ? command, the R? command and the FETCh? command). Name Type Range Default Bool {OFF|0|ON|1} OFF  The setting applies to all the readings aquired in the scan. You cannot set the reading format on a per-channel basis.
PAGE 72
RIGOL Chapter 2 Command System FORMat:READing:TIME:TYPE Syntax FORMat:READing:TIME:TYPE FORMat:READing:TIME:TYPE? Description Parameters Explanation Return Format Example Set the time format for the time stamps returned when FORMat:READing:TIME is ON.
PAGE 73
RIGOL Chapter 2 Command System FORMat:READing:UNIT Syntax FORMat:READing:UNIT FORMat:READing:UNIT? Description Parameters Explanation Return Format Example Disable or enable the measurement unit in the return redings of the scan result query commands (such as the READ? command, the R? command and the FETCh? command). Name Type Range Default Bool {OFF|0|ON|1} OFF  The setting applies to all the readings aquired in the scan.
PAGE 74
RIGOL Chapter 2 Command System IEEE-488.2 Common Commands IEEE-488.2 standard defines a set of common commands which are used for the reset, self-test and status operations. These commands usually start with an asterisk (*) and contain three characters as well as one or more parameters. the command keyword and the first parameter are separated by a space.
PAGE 75
RIGOL Chapter 2 Command System *ESE Syntax *ESE *ESE? Description Parameters Explanation Return Format Example Set the enable register for the Standard Event Register set. Name Type Range Default Numeric 0 to 255 0  The definition of each bit in the Standard Event Register is as shown in the table below. Wherein, bit1 and bit6 are not used and are always regarded as 0.
PAGE 76
RIGOL Chapter 2 Command System *ESR? Syntax *ESR? Description Query the event register of the Standard Event Register set. Explanation  The corresponding bits in the event register must be enabled using the *ESE command. This command queries cand clears the event registerof the Standard Event Register set.  The definition of each bit in the Standard Event Register is as shown in the table below. Wherein, bit1 and bit6 are not used and are always regarded as 0.
PAGE 77
RIGOL Chapter 2 Command System *OPC Syntax *OPC *OPC? Description The *OPC command set bit 0 of the enable register of the Standard Event Register to 1 at the end of the current scan. The *OPC? command queries whether the current operation is completed or not. If yes, it returns 1 to the output buffer. Explanation  This command enables you to synchronize your application with the instrument.  Note the difference between the *OPC command and the *OPC? command.
PAGE 78
RIGOL Chapter 2 Command System *SAV *RCL Syntax *SAV {0|1|2|3|4|5} *RCL {0|1|2|3|4|5} Description The *SAV command stores the current measurement configuration to the specified location and overwites any file previously stored in the current storage location (no error is generated). The *RCL command recalls the measurement file stored in the specified location and overwrites the current measurement configuration.
PAGE 79
RIGOL Chapter 2 Command System *SRE Syntax *SRE *SRE? Description Parameters Explanation Return Format Example Set the enable register of the Status Byte Register set. Name Type Range Default Numeric 0 to 255 0  The definition of each bit in the Status Byte Register is as shown in the table below. Wherein, bit0 is not used and is always regarded as 0.
PAGE 80
RIGOL Chapter 2 Command System *STB? Syntax *STB? Description Query the condition register of the Status Byte Register set. Explanation  This command only reads the register, but does not clear it.  The definition of each bit in the Status Byte Register is as shown in the table below. Wherein, bit0 is not used and is always regarded as 0.
PAGE 81
Chapter 2 Command System RIGOL *WAI Syntax *WAI Description Control the instrument to execute other commands on the interface after all the pending operations are completed. Explanation  Function and range changes are considered as pending operations. Therefore, the *WAI command will wait for these changes to complete.  As this command stops the command parser from operating, it is better to use the *OPC for synchronization purposes.
PAGE 82
RIGOL Chapter 2 Command System INITiate Syntax INITiate Description This command changes the state of the triggering system from the "idle" state to the "wait-for-trigger" state. Scan will begin when the specified trigger conditions are satisfied. Readings acquired during the scan are stored in the internal reading memory of the instrument. Note that the INITiate command also clears the previous scan readings from the memory.
PAGE 83
RIGOL Chapter 2 Command System INPut:IMPedance:AUTO Syntax INPut:IMPedance:AUTO [,(@)] INPut:IMPedance:AUTO? [(@)] Description Parameters Enable or disable the impedance automatic input mode for the DCV measurements on the specified channels.
PAGE 84
RIGOL Chapter 2 Command System INSTrument Command Subsystem  INSTrument:DMM  INSTrument:DMM:INSTalled? INSTrument:DMM Syntax INSTrument:DMM INSTrument:DMM? Description Parameters Explanation Return Format Example Enable or disable the DMM module. Name Type Range Default Bool {OFF|0|ON|1} None  When you change the state of the DMM module, the instrument will initiate the current scan list.
PAGE 85
RIGOL Chapter 2 Command System LXI Command Subsystem  LXI:IDENtify[:STATE]  LXI:RESet  LXI:RESTart LXI:IDENtify[:STATE] Syntax LXI:IDENtify[:STATE] LXI:IDENtify[:STATE]? Description Turn the LXI identification indicator on the front panel display on or off. Parameters Explanation Return Format Example Name Type Range Default Bool {OFF|0|ON|1} None  This command is valid only when M300 has been connected to the network using a LAN cable.
PAGE 86
RIGOL Chapter 2 Command System MEASure Command Subsystem  MEASure:ANYSensor?  MEASure:CURR:AC?  MEASure:CURR[:DC]?  MEASure:DIGital:BYTE?  MEASure:DIGital:DWORd?  MEASure:DIGital:WORD?  MEASure:FREQuency?  MEASure:PERiod?  MEASure:FRESistance?  MEASure:RESistance?  MEASure:TEMPerature?  MEASure:TOTalize?  MEASure:VOLTage:AC?  MEASure:VOLTage[:DC]? 2-68 M300 Programming Guide
PAGE 87
RIGOL Chapter 2 Command System MEASure:ANYSensor? Syntax Description Parameters MEASure:ANYSensor? [{|DEF},](@) Configure the specified channels to the specified type of anysensor measurement function, start a scan and read the readings.
PAGE 88
RIGOL Chapter 2 Command System MEASure:CURR:AC? Syntax Description Parameters MEASure:CURR:AC? [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],] (@) Configure the specified channels to the ACI measurement function with the specified range and resolution, start a scan and read the readings. Name Type Range Default Numeric Any numeric value between MIN and MAX. Tthe final range is decided by the “Principle of setting with greater value”.
PAGE 89
RIGOL Chapter 2 Command System MEASure:CURR[:DC]? Syntax Description Parameters MEASure:CURR[:DC]? [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],] (@) Configure the specified channels to the DCI measurement function with the specified range and resolution, start a scan and read the readings. Name Type Range Default Numeric Any numeric value between MIN and MAX. The final range is decided by the “Principle of setting with greater value”.
PAGE 90
RIGOL Return Format Example Chapter 2 Command System 100PLC 0.035ppm× 200PLC 0.03ppm× (MIN)  If the input signal is greater than can be measured on the selected range, the instrument gives an overload indication: "OVERLOAD" from the front panel or "±9.9E+37" from the remote interface.  overwrites the current scan list. The query returns the readings in scientific notation. Multiple return values are separated by commas.
PAGE 91
RIGOL Chapter 2 Command System MEASure:DIGital:BYTE? MEASure:DIGital:DWORd? MEASure:DIGital:WORD? Syntax MEASure:DIGital:BYTE? (@) MEASure:DIGital:DWORd? (@) MEASure:DIGital:WORD? (@) Description Parameters Set the bits of the DIO channels when they are used as the digital input terminals (BYTE represents 8-bit, WORd represents 16-bit and DWORd represents 32-bit), start a scan and read the readings.
PAGE 92
RIGOL Chapter 2 Command System MEASure:FREQuency? MEASure:PERiod? Syntax MEASure:FREQuency? [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],] (@) MEASure:PERiod? [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],] (@) Description Parameters Configure the specified channels to the frequency or period measurement functions with the specified gate time, start a scan and read the readings.
PAGE 93
RIGOL Chapter 2 Command System MEASure:FRESistance? MEASure:RESistance? Syntax MEASure:FRESistance? [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],] (@) MEASure:RESistance? [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],] (@) Description Parameters Configure the specified channels for the 2-wire or 4-wire resistance measurement functions with the specified range and resolution, start a scan and read the readings.
PAGE 94
RIGOL Chapter 2 Command System  Return Format Example Related commands is related to the current integration time and range (). The relations are as shown in the table below. Integration time Resolution (ppm range) 0.02PLC 3ppm× (MAX) 0.2PLC 0.7ppm× 1PLC 0.3ppm× (DEF) 2PLC 0.2ppm× 10PLC 0.1ppm× 20PLC 0.06ppm× 100PLC 0.035ppm× 200PLC 0.
PAGE 95
RIGOL Chapter 2 Command System MEASure:TEMPerature? Syntax Description Parameters MEASure:TEMPerature? {|DEF},{|DEF}[,1[,{|MIN|MAX|DEF}]],(@) Configure the specified channels to the temperature measurement function, start a scan and read the readings.
PAGE 96
RIGOL Chapter 2 Command System MEASure:TOTalize? Syntax Description Parameters MEASure:TOTalize? [],(@) Set the reading mode of the TOT channel to READ (only read the count but do not reset it) or RRESet (Read and Reset), start a scan and read the readings.
PAGE 97
RIGOL Chapter 2 Command System MEASure:VOLTage:AC? Syntax Description Parameters MEASure:VOLTage:AC? [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],] (@) Configure the specified channels to the ACV measurement function with the specified range and resolution, start a scan and read the readings. Name Type Range Default Numeric Any numeric value between MIN and MAX. The final range is decided by the “Principle of setting with greater value”.
PAGE 98
RIGOL Chapter 2 Command System MEASure:VOLTage[:DC]? Syntax Description Parameters MEASure:VOLTage[:DC]? [{|AUTO|MIN|MAX|DEF}[,{|MIN|MAX|DEF}],] (@) Configure the specified channels to the DCV measurement function with the specified range and resolution, start a scan and read the readings. Name Type Range Default Numeric Any numeric value between MIN and MAX. The final range is decided by the “Principle of setting with greater value”.
PAGE 99
RIGOL Chapter 2 Command System Return Format Example 20PLC 0.06ppm× 100PLC 0.035ppm× 200PLC 0.03ppm× (MIN)  If the input signal is greater than can be measured on the selected range, the instrument gives an overload indication: "OVERLOAD" from the front panel or "±9.9E+37" from the remote interface.  overwrites the current scan list. The query returns the readings in scientific notation. Multiple return values are separated by commas.
PAGE 100
RIGOL Chapter 2 Command System MEMory Command Subsystem  MEMory:NSTates?  MEMory:SAVE:SYSTem  MEMory:NAME:SYSTem?  MEMory:RECall:SYSTem  MEMory:SAVE:CONFig  MEMory:NAME:CONFig?  MEMory:RECall:CONFig  MEMory:SAVE:MIRRor  MEMory:NAME:MIRRor?  MEMory:RECall:MIRRor  MEMory:SAVE:DATA  MEMory:NAME:DATA?  MEMory:RECall:DATA  MEMory:STATe:DELete  MEMory:STATe:NAME  MEMory:STATe:RECall  MEMory:STATe:VALid? MEMory:NSTates? Syntax Description Return Format Example
PAGE 101
RIGOL Chapter 2 Command System MEMory:SAVE:SYSTem MEMory:NAME:SYSTem? MEMory:RECall:SYSTem Syntax MEMory:SAVE:SYSTem MEMory:NAME:SYSTem? MEMory:RECall:SYSTem Description Parameters The SAVE command saves the current system configuration with the specified filename to the non-volatile memory (refer to Appendix C: Non-volatile Memory). The NAME command queries the filenames of all the system configuration files in the non-volatile memory.
PAGE 102
RIGOL Chapter 2 Command System MEMory:SAVE:CONFig MEMory:NAME:CONFig? MEMory:RECall:CONFig Syntax MEMory:SAVE:CONFig MEMory:NAME:CONFig? MEMory:RECall:CONFig Description Parameters The SAVE command saves the current measurement configuration with the specified filename to the non-volatile memory (refer to Appendix C: Non-volatile Memory). The NAME command queries the filenames of all the measurement configuration files in the non-volatile memory.
PAGE 103
RIGOL Chapter 2 Command System MEMory:SAVE:MIRRor MEMory:NAME:MIRRor? MEMory:RECall:MIRRor Syntax MEMory:SAVE:MIRRor MEMory:NAME:MIRRor? MEMory:RECall:MIRRor Description Parameters The SAVE command saves the current mirror configuration with the specified filename to the non-volatile memory (refer to Appendix C: Non-volatile Memory). The NAME command queries the filenames of all the mirror configuration files in the non-volatile memory.
PAGE 104
RIGOL Chapter 2 Command System MEMory:SAVE:DATA MEMory:NAME:DATA? MEMory:RECall:DATA Syntax MEMory:SAVE:DATA MEMory:NAME:DATA? MEMory:RECall:DATA Description Parameters The SAVE command saves the current measurement data with the specified filename to the non-volatile memory (refer to Appendix C: Non-volatile Memory). The NAME command queries the filenames of all the measurement data files in the non-volatile memory.
PAGE 105
RIGOL Chapter 2 Command System MEMory:STATe:DELete Syntax Description Parameters Explanation Example Related Commands MEMory:STATe:DELete Delete the contents of the measurement configuration file in the specified storage location.
PAGE 106
RIGOL Chapter 2 Command System MEMory:STATe:NAME Syntax MEMory:STATe:NAME [,] MEMory:STATe:NAME? Description Parameters Rename the measurement configuration file in the specified storage location. Name Type Range Default Discrete {0|1|2|3|4|5} None A unquoted string of up to 12 characters, including English letters (a-z, A-Z), numbers (0-9) or the underscore ("_"). If omitted, the default filename is used for the file in the specified storage location.
PAGE 107
RIGOL Chapter 2 Command System MEMory:STATe:RECall Syntax MEMory:STATe:RECall:AUTO MEMory:STATe:RECall:AUTO? Description Parameters Explanation Enable or disable the automatic recall of the power-down state at power-on. Name Type Range Default Bool {OFF|0|ON|1} OFF  When enabled (ON), the instrument uses the system configuration before the last power-off at power-on.
PAGE 108
RIGOL Chapter 2 Command System MMEMory Command Subsystem  MMEMory:EXPort?  MMEMory:FORMat:READing:CSEParator  MMEMory:FORMat:READing:RLIMit  MMEMory:IMPort:CATalog?  MMEMory:IMPort:CONFig?  MMEMory:LOG[:ENABle] MMEMory:EXPort? Syntax MMEMory:EXPort? Description Export the readings in the reading memory and the current instrument configuration to the default directory in the external USB storage device. Explanation  The default directory is \M300\data\\YYYYMMDD_hhmmss.
PAGE 109
RIGOL Chapter 2 Command System MMEMory:FORMat:READing:CSEParator Syntax MMEMory:FORMat:READing:CSEParator MMEMory:FORMat:READing:CSEParator? Description Parameters Return Format Example Set the filed separator in the exported file. Name Type Range Default Discrete {TAB|COMMa|SEMicolon} COMMa The query returns TAB (space), COMM (comma) or SEM (semicolon). MMEM:FORM:READ:CSEP SEM MMEM:FORM:READ:CSEP? The query returns SEM.
PAGE 110
RIGOL Chapter 2 Command System MMEMory:IMPort:CATalog? Syntax MMEMory:IMPort:CATalog? Description Query the blcfg file list in the root directory of the external memory. Explanation  If the external USB storage device is not inserted or the root directory of the external memory contains no blcfg file, the query returns "".  This command only queries the .blcfg files in the the root directory of the external memory.
PAGE 111
RIGOL Chapter 2 Command System MMEMory:LOG[:ENABle] Syntax MMEMory:LOG[:ENABle] MMEMory:LOG[:ENABle]? Description Parameters Explanation Enable or disable the function to output the scan data to the USB storage device in real-time. Name Type Range Default Bool {OFF|0|ON|1} OFF  This setting is saved in the non-volatile memory (refer to Appendix C: Non-volatile Memory) and will not be affected by the *RST or SYSTem:PRESet command.
PAGE 112
RIGOL Chapter 2 Command System OUTPut Command Subsystem  OUTPut:ALARm:CLEar  OUTPut:ALARm:CLEar:ALL  OUTPut:ALARm:ENABle?  OUTPut:ALARm[]:MODE  OUTPut:ALARm[]:SLOPe  OUTPut:ALARm:SOURce OUTPut:ALARm:CLEar OUTPut:ALARm:CLEar:ALL Syntax OUTPut:ALARm:CLEar OUTPut:ALARm:CLEar:ALL Description Clear the alarm output line of the specified channel. Clear the alarm output lines of all the channels.
PAGE 113
RIGOL Chapter 2 Command System OUTPut:ALARm[]:MODE Syntax OUTPut:ALARm[]:MODE OUTPut:ALARm[]:MODE? Description Parameters Set the output mode of the alarm output line of the specified channel. Name Type Range Default Discrete 1|2|3|4 None[1] Discrete {LATCh|TRACk} LATCh Note[1]: When you omit this parameter, this command sets the output mode of all the alarm output lines.
PAGE 114
RIGOL Chapter 2 Command System OUTPut:ALARm[]:SLOPe Syntax OUTPut:ALARm[]:SLOPe OUTPut:ALARm[]:SLOPe? Description Parameters Set the edge type of the alarm output of the specified alarm channel. Name Type Range Default Discrete 1|2|3|4 None[1] Discrete {NEGative|POSitive} NEGative Note[1]: When you omit this parameter, this command sets the edge types of all the alarm output lines.
PAGE 115
RIGOL Chapter 2 Command System OUTPut:ALARm:SOURce Syntax OUTPut:ALARm:SOURce (@) OUTPut:ALARm:SOURce? Description Parameters Specify the alarm channel used to report the alarm situations on the specified multiplexer, DIO or TOT channels.
PAGE 116
RIGOL Chapter 2 Command System R? Syntax Description Parameters R? [] Read and erase the readings in the volatile memory (refer to Appendix D: Volatile memory). The instrument starts reading from the oldest reading and up to number of readings can be read and erased. This command can be used to clear the reading memory periodically to avoid data overflow (for example, during a scan with an infinite scan count).
PAGE 117
Chapter 2 Command System RIGOL READ? Syntax Description READ? Change the trigger status of the instrument from the "idle" state to the "wait-for-trigger" state. The instrument starts scanning when the specified trigger conditions are satisfied. Readings are sent to the reading memory and output buffer during the scan. This command have to be used with the following modules.
PAGE 118
RIGOL Chapter 2 Command System ROUTe Command Subsystem  ROUTe:CHANnel:ADVance:SOURce  ROUTe:CHANnel:ADVance:EDGE  ROUTe:CHANnel:DELay  ROUTe:CHANnel:DELay:AUTO  ROUTe:CHANnel:FWIRe  ROUTe:CLOSe  ROUTe:CLOSe:EXCLusive  ROUTe:DONE?  ROUTe:MONitor[:CHAN]  ROUTe:MONitor:DATA?  ROUTe:MONitor:DATA:FULL?  ROUTe:MONitor:STATe  ROUTe:OPEN  ROUTe:SCAN  ROUTe:SCAN:SIZE?  ROUTe:SCAN:ADD  ROUTe:SCAN:REMove ROUTe:CHANnel:ADVance:SOURce Syntax ROUTe:CHANnel:ADVance:SOU
PAGE 119
RIGOL Chapter 2 Command System Pin 6: Ext Trig Input/Channel Advance Input Alarms/Ext Trig Interface  BUS (Single): the instrument switches to the next channel when the *TRG command is send via the remote interface. The *TRG command is only valid when M300 is in the "wait-for-trigger" state (refer to the INITiate command). The BUS trigger mode dose not support “BUS (Single)” advanced source.
PAGE 120
RIGOL Chapter 2 Command System ROUTe:CHANnel:ADVance:EDGE Syntax ROUTe:CHANnel:ADVance:EDGE {RISing|FALLing} ROUTe:CHANnel:ADVance:EDGE? Description Parameters Explanation Set the instrument to open the current channel and close the next channel in the scan list on the rising edge or falling edge of the input signal when the advanced source is set to external (EXTernal). This command is only available when external digital multimeter is used.
PAGE 121
RIGOL Chapter 2 Command System ROUTe:CHANnel:DELay Syntax ROUTe:CHANnel:DELay ,(@) ROUTe:CHANnel:DELay? (@) Description Parameters Set the delay between the multiplexer channels in the scan list. Name Type Range Default Numeric A number from 0 to 60, with 1 ms resolution.
PAGE 122
RIGOL Chapter 2 Command System ROUTe:CHANnel:DELay:AUTO Syntax ROUTe:CHANnel:DELay:AUTO [,(@)] ROUTe:CHANnel:DELay:AUTO? [(@)] Description Parameters Enable or disable the automatic delay of the specified multiplexer channels.
PAGE 123
RIGOL Chapter 2 Command System ROUTe:CHANnel:FWIRe Syntax ROUTe:CHANnel:FWIRe [,(@)] ROUTe:CHANnel:FWIRe? [(@)] Description Parameters Enable or disable the 4-wire scan of the specified channels. This setting is only available when the external digital multimeter is used.
PAGE 124
RIGOL Chapter 2 Command System ROUTe:CLOSe Syntax ROUTe:CLOSe (@) ROUTe:CLOSe? (@) Description Parameters Close the specified channels on a multiplexer, actuator or matrix switch module.
PAGE 125
RIGOL Chapter 2 Command System ROUTe:CLOSe:EXCLusive Syntax Description Parameters ROUTe:CLOSe:EXCLusive (@) Close the specified channels after opening all the channels on a multiplexer, actuator or matrix switch.
PAGE 126
RIGOL Chapter 2 Command System ROUTe:MONitor[:CHAN] Syntax ROUTe:MONitor[:CHAN] (@) ROUTe:MONitor[:CHAN]? Description Parameters Add the specified channels into the monitor list.
PAGE 127
Chapter 2 Command System RIGOL ROUTe:MONitor:DATA? Syntax ROUTe:MONitor:DATA? Description Query the measurement values of all the monitored channels. Explanation  It returns the reading only; the units, time stamp, channel number and alarm status information are not returned (not affected by the FORMat Command Subsystem commands).  If the monitor mode is disabled, an error indicating that it is unable to perform the requested operation will be generated when sending this command.
PAGE 128
RIGOL Chapter 2 Command System ROUTe:MONitor:STATe Syntax ROUTe:MONitor:STATe ROUTe:MONitor:STATe? Description Parameters Explanation Return Format Example Enable or disable the monitor function. Name Type Range Default Bool {OFF|0|ON|1} OFF  In the monitor mode, the instrument performs continuous measurements on the specified channels and displays the measurement values on the front panel display.
PAGE 129
RIGOL Chapter 2 Command System ROUTe:OPEN Syntax ROUTe:OPEN (@) ROUTe:OPEN? (@) Description Open the specified channels on a multiplexer, actuator or matrix switch.
PAGE 130
RIGOL Chapter 2 Command System ROUTe:SCAN Syntax ROUTe:SCAN (@) ROUTe:SCAN? Description Parameters Add the specified channels into the scan list.
PAGE 131
Chapter 2 Command System Example RIGOL CONF:VOLT:AC 20,0.001,(@203:205) ROUT:SCAN (@203:205) READ? The query returns +1.092823557E-01,+1.092155667E-01,+1.082497025E-01. ROUT:SCAN? The query returns #214(@203,204,205). Related commands ROUTe Command Subsystem ROUTe:SCAN:SIZE? ROUTe:SCAN:ADD ROUTe:SCAN:REMove INITiate FETCh? READ? ABORt ROUTe:SCAN:SIZE? Syntax ROUTe:SCAN:SIZE? Description Query the number of channels in the scan list.
PAGE 132
RIGOL Chapter 2 Command System ROUTe:SCAN:ADD Syntax Description Parameters ROUTe:SCAN:ADD (@) Add the specified channel into the scan list. Name Type Range Default Channel One channel (for the multiplexer, DIO and TOT channels), the rules are as follows: None (@101): channel 01 on the module in Slot1; Explanation Example This command adds a single channel into the scan list (no matter whether the scan list is empty or not) and will not overwrites the scan list.
PAGE 133
Chapter 2 Command System RIGOL SENSe Command Subsystem  [SENSe:]ANYSensor:FREQuency:RANGe:LOWer  [SENSe:]ANYSensor:FRESistance:APERture  [SENSe:]ANYSensor:RESistance:APERture  [SENSe:]ANYSensor:FRESistance:NPLC  [SENSe:]ANYSensor:RESistance:NPLC  [SENSe:]ANYSensor:FRESistance:OCOMpensated  [SENSe:]ANYSensor:RESistance:OCOMpensated  [SENSe:]ANYSensor:VOLTage:APERture  [SENSe:]ANYSensor:VOLTage:NPLC  [SENSe:]ANYSensor:CURRent:APERture  [SENSe:]ANYSensor:CURRent:NPLC  [SENS
PAGE 134
RIGOL  [SENSe:]FRESistance:APERture  [SENSe:]RESistance:APERture  [SENSe:]FRESistance:NPLC  [SENSe:]RESistance:NPLC  [SENSe:]FRESistance:OCOMpensated  [SENSe:]RESistance:OCOMpensated  [SENSe:]FRESistance:RANGe  [SENSe:]RESistance:RANGe  [SENSe:]FRESistance:RANGe:AUTO  [SENSe:]RESistance:RANGe:AUTO  [SENSe:]FRESistance:RESolution  [SENSe:]RESistance:RESolution  [SENSe:]FUNCtion  [SENSe:]TEMPerature:APERture  [SENSe:]TEMPerature:NPLC  [SENSe:]TEMPerature:RJUNcti
PAGE 135
Chapter 2 Command System  [SENSe:]VOLTage:AC:BANDwidth  [SENSe:]VOLTage:AC:RESolution  [SENSe:]VOLTage[:DC]:APERture  [SENSe:]VOLTage[:DC]:NPLC  [SENSe:]VOLTage[:DC]:RESolution  [SENSe:]ZERO:AUTO RIGOL Note*:  You cannot set any function-specific measurement parameters unless the channel is already configured for that function. For example, you cannot set the AC filter parameters unless that channel is already configured for the ACV, ACI, frequency or period measurements.
PAGE 136
RIGOL Chapter 2 Command System [SENSe:]ANYSensor:FREQuency:RANGe:LOWer Syntax [SENSe:]ANYSensor:FREQuency:RANGe:LOWer {|MIN|MAX}[,(@)] [SENSe:]ANYSensor:FREQuency:RANGe:LOWer? [{(@)|MIN|MAX}] Description Parameters Set the AC filter parameter for the frequency measurements (anysensor function) of the specified channels. Name Type Range Default Numeric Any numeric value between MIN and 1000000.
PAGE 137
RIGOL Chapter 2 Command System [SENSe:]ANYSensor:FRESistance:APERture [SENSe:]ANYSensor:RESistance:APERture Syntax [SENSe:]ANYSensor:FRESistance:APERture {|MIN|MAX}[,(@)] [SENSe:]ANYSensor:FRESistance:APERture? [{(@)|MIN|MAX}] [SENSe:]ANYSensor:RESistance:APERture {|MIN|MAX}[,(@)] [SENSe:]ANYSensor:RESistance:APERture? [{(@)|MIN|MAX}] Description Parameters Set the integration time via the aperture time mode for the 2-wire or 4-wire resistance measurement
PAGE 138
RIGOL Chapter 2 Command System [SENSe:]ANYSensor:FRESistance:NPLC [SENSe:]ANYSensor:RESistance:NPLC Syntax [SENSe:]ANYSensor:FRESistance:NPLC {|MIN|MAX}[,(@)] [SENSe:]ANYSensor:FRESistance:NPLC? [{(@)|MIN|MAX}] [SENSe:]ANYSensor:RESistance:NPLC {|MIN|MAX}[,(@)] [SENSe:]ANYSensor:RESistance:NPLC? [{(@)|MIN|MAX}] Description Parameters Set or query the integration time via the power line cycles mode for the 2-wire or 4-wire resistance measurements (the any
PAGE 139
Chapter 2 Command System Related commands RIGOL SENSe Command Subsystem CONFigure:ANYSensor MEASure:ANYSensor? [SENSe:]ANYSensor:FRESistance:APERture [SENSe:]ANYSensor:RESistance:APERture M300 Programming Guide 2-121
PAGE 140
RIGOL Chapter 2 Command System [SENSe:]ANYSensor:FRESistance:OCOMpensated [SENSe:]ANYSensor:RESistance:OCOMpensated Syntax [SENSe:]ANYSensor:FRESistance:OCOMpensated [,(@)] [SENSe:]ANYSensor:FRESistance:OCOMpensated? [(@)] [SENSe:]ANYSensor:RESistance:OCOMpensated [,(@)] [SENSe:]ANYSensor:RESistance:OCOMpensated? [(@)] Description Parameters Enable or disable the offset compensation function for the 2-wire or 4-wire resistance measurements (the anysenso
PAGE 141
RIGOL Chapter 2 Command System [SENSe:]ANYSensor:VOLTage:APERture Syntax [SENSe:]ANYSensor:VOLTage:APERture {|MIN|MAX}[,(@)] [SENSe:]ANYSensor:VOLTage:APERture? [{(@)|MIN|MAX}] Description Parameters Set the integration time via the aperture time mode for the DCV measurements (the anysensor measurement function) on the specified channels. Name Type Range of Values Default Value Numeric Any numeric value between MIN and MAX. MIN=33 µs, MAX=4 s.
PAGE 142
RIGOL Chapter 2 Command System [SENSe:]ANYSensor:VOLTage:NPLC Syntax [SENSe:]ANYSensor:VOLTage:NPLC {|MIN|MAX}[,(@)] [SENSe:]ANYSensor:VOLTage:NPLC? [{(@)|MIN|MAX}] Description Parameters Set or query the integration time via the power line cycles mode for the DCV measurements (the anysensor measurement function) on the specified channels. Name Explanation Return Format Example Type Range Default Numeric Any numeric value between MIN and MAX.
PAGE 143
RIGOL Chapter 2 Command System [SENSe:]ANYSensor:CURRent:APERture Syntax [SENSe:]ANYSensor:CURRent:APERture {|MIN|MAX}[,(@)] [SENSe:]ANYSensor:CURRent:APERture? [{(@)|MIN|MAX}] Description Parameters Set the integration time via the aperture time mode for the DCI measurements (the anysensor measurement function) on the specified channels. Name Type Range Default Numeric Any numeric value between MIN and MAX. MIN=33 µs, MAX=4 s.
PAGE 144
RIGOL Chapter 2 Command System [SENSe:]ANYSensor:CURRent:NPLC Syntax [SENSe:]ANYSensor:CURRent:NPLC {|MIN|MAX}[,(@)] [SENSe:]ANYSensor:CURRent:NPLC? [{(@)|MIN|MAX}] Description Parameters Set or query the integration time via the power line cycles mode for the DCI measurements (the anysensor measurement function) on the specified channels. Name Type Range of Default Numeric Any numeric value between MIN and MAX.
PAGE 145
RIGOL Chapter 2 Command System [SENSe:]ANYSensor:SEGMent Syntax [SENSe:]ANYSensor:SEGMent {, paraA, paraB, paraC}[,(@)] [SENSe:]ANYSensor:SEGMent? [(@)] Description Parameters Set or query the scaling parameters (including SQUare(A), GAIN(B), CONStant(C), Start(startvalue)) for the anysensor measurements on the specified channels. Name Type paraA paraB Numeric paraC Range Default Any numeric value between MIN and MAX. MIN=-1.000000000E+15 MAX=+1.
PAGE 146
RIGOL Chapter 2 Command System The query returns +1,+1.000000E+00,+2.000000E+00,+3.000000E+00,+4.000000E+00. Related command [SENSe:]ANYSensor:SEGMent:CLEar [SENSe:]ANYSensor:SEGMent:CLEar Syntax Description Parameters [SENSe:]ANYSensor:SEGMent:CLEar [,][(@)] Clear the scaling parameters of the anysensor measurements on the specified channels ( specifies the the segment of the delete operation).
PAGE 147
RIGOL Chapter 2 Command System [SENSe:]ANYSensor:TYPE Syntax [SENSe:]ANYSensor:TYPE [,(@)] [SENSe:]ANYSensor:TYPE? [(@)] Description Parameters Set or query the measurement type of the anysensor measurement on the specified channel.
PAGE 148
RIGOL Chapter 2 Command System [SENSe:]CURRent:AC:BANDwidth Syntax [SENSe:]CURRent:AC:BANDwidth {|MIN|MAX}[,(@)] [SENSe:]CURRent:AC:BANDwidth? [{(@)|MIN|MAX}] Description Parameters Set or query the AC filter parameter of the ACI measurements on the specified channels. Name Type Range Default Numeric Any numeric value between MIN and 1000000. The final AC filter parameter is decided by the “Principle of setting with samller value”.
PAGE 149
RIGOL Chapter 2 Command System [SENSe:]CURRent:AC:RANGe [SENSe:]CURRent[:DC]:RANGe Syntax [SENSe:]CURRent:AC:RANGe {|MIN|MAX}[,(@)] [SENSe:]CURRent:AC:RANGe? [{(@)|MIN|MAX}] [SENSe:]CURRent[:DC]:RANGe:AUTO [,(@)] [SENSe:]CURRent[:DC]:RANGe:AUTO? [(@)] Description Parameters Set or query the measurement range of the ACI and DCI measurements on the specified channels. Name Type Range Default Numeric Any numeric value between MIN and MAX.
PAGE 150
RIGOL Related commands Chapter 2 Command System CONFigure:CURRent:AC CONFigure:CURRent[:DC] MEASure:CURR:AC? MEASure:CURR[:DC]? [SENSe:]CURRent:AC:RANGe:AUTO [SENSe:]CURRent[:DC]:RANGe:AUTO 2-132 M300 Programming Guide
PAGE 151
RIGOL Chapter 2 Command System [SENSe:]CURRent:AC:RANGe:AUTO [SENSe:]CURRent[:DC]:RANGe:AUTO Syntax [SENSe:]CURRent:AC:RANGe:AUTO [,(@)] [SENSe:]CURRent:AC:RANGe:AUTO? [(@)] [SENSe:]CURRent:DC:RANGe:AUTO [,(@)] [SENSe:]CURRent:DC:RANGe:AUTO? [(@)] Description Parameters Disable or enable the autoranging of the ACI and DCI measurements on the specified channels.
PAGE 152
RIGOL Chapter 2 Command System [SENSe:]CURRent:AC:RESolution Syntax [SENSe:]CURRent:AC:RESolution {|MIN|MAX}[,(@)] [SENSe:]CURRent:AC:RESolution? [{(@)|MIN|MAX}] Description Parameters Set or query the resolution of the ACI measurements on the specified channels. Name Type Range Default Numeric Can receive any numeric value, but the resolution is fixed at 61/2 digits.
PAGE 153
RIGOL Chapter 2 Command System [SENSe:]CURRent[:DC]:APERture Syntax [SENSe:]CURRent[:DC]:APERture {|MIN|MAX}[,(@)] [SENSe:]CURRent[:DC]:APERture? [{(@)|MIN|MAX}] Description Parameters Set the integration time via the aperture time mode for the DCI measurements on the specified channels. Name Type Range Default Numeric Any numeric value between MIN and MAX. Wherein: MIN=33 µs, MAX=4 s.
PAGE 154
RIGOL Chapter 2 Command System [SENSe:]CURRent[:DC]:NPLC Syntax Description Parameters [SENSe:]CURRent[:DC]:NPLC {|MIN|MAX}[,(@)] [SENSe:]CURRent[:DC]:NPLC? [{(@)|MIN|MAX}] Set or query the integration time via the power line cycles mode for the DCI measurements on the specified channels. Name Explanation Return Format Example Type Range Default Numeric Any numeric value between MIN and MAX.
PAGE 155
RIGOL Chapter 2 Command System [SENSe:]CURRent[:DC]:RESolution Syntax [SENSe:]CURRent[:DC]:RESolution {|MIN|MAX}[,(@)] [SENSe:]CURRent[:DC]:RESolution? [{(@)|MIN|MAX}] Description Parameters Set or query the resolution of the DCI measurements on the specified channels. Name Type Numeric Range Any numeric value between 0.03ppm× and 3ppm×. The final resolution is decided by the “Principle of setting with smaller value”.
PAGE 156
RIGOL Chapter 2 Command System [SENSe:]CURRent[:DC]:RANGe CONFigure:CURRent[:DC] MEASure:CURR[:DC]? [SENSe:]DIGital:DATA[:BYTE]? [SENSe:]DIGital:DATA:WORD? [SENSe:]DIGital:DATA:DWORd? Syntax [SENSe:]DIGital:DATA[:BYTE]? (@) [SENSe:]DIGital:DATA:WORD? (@) [SENSe:]DIGital:DATA:DWORd? (@) Description Parameters Set the bits of the specified DIO channels when they are used as the digital input terminals and query the digital input values of the specified DIO channels.
PAGE 157
RIGOL Chapter 2 Command System [SENSe:]DIGital:TYPE Syntax [SENSe:]DIGital:TYPE {USER|TTL|CMOS5|CMOS3.3|CMOS2.5},[(@)] [SENSe:]DIGital:TYPE? [(@)] Description Parameters Set the level type of the digital input and output of the specified channels. Name Type Range Default TYPE Discrete {USER|TTL|CMOS5|CMOS3.3|CMOS2.
PAGE 158
RIGOL Chapter 2 Command System [SENSe:]DIGital:LEVel Syntax [SENSe:]DIGital:LEVel ,[(@)] [SENSe:]DIGital:LEVel? [(@)] Description Parameters Set or query the digital output level values of the specified channels (the level type is set to USER). Name Type Range Default Numeric Any numeric value between 2V and 5V.
PAGE 159
RIGOL Chapter 2 Command System [SENSe:]DIGital:THReshold Syntax [SENSe:]DIGital:THReshold ,[(@)] [SENSe:]DIGital:THReshold? [(@)] Description Parameters Set or query the digital output level threshold values of the specified channels (the level type is set to USER). Name Type Range Default Numeric Any numeric value between 0.5V and 3.5V. 2.
PAGE 160
RIGOL Chapter 2 Command System [SENSe:]FREQuency:APERture [SENSe:]PERiod:APERture Syntax [SENSe:]FREQuency:APERture {|MIN|MAX}[,(@)] [SENSe:]FREQuency:APERture? [{(@)|MIN|MAX}] [SENSe:]PERiod:APERture {|MIN|MAX}[,(@)] [SENSe:]PERiod:APERture? [{(@)|MIN|MAX}] Description Parameters Set or query the gate time (also called aperture time) of the frequency or period measurements on the specified channels.
PAGE 161
RIGOL Chapter 2 Command System [SENSe:]FREQuency:RANGe:LOWer [SENSe:]PERiod:RANGe:LOWer Syntax [SENSe:]FREQuency:RANGe:LOWer {|MIN|MAX}[,(@)] [SENSe:]FREQuency:RANGe:LOWer? [{(@)|MIN|MAX}] [SENSe:]PERiod:RANGe:LOWer {|MIN|MAX}[,(@)] [SENSe:]PERiod:RANGe:LOWer? [{(@)|MIN|MAX}] Description Parameters Set or query the AC filter parameter of the frequency or period measurements on the specified channels.
PAGE 162
RIGOL Chapter 2 Command System [SENSe:]FREQuency:VOLTage:RANGe [SENSe:]PERiod:VOLTage:RANGe Syntax [SENSe:]FREQuency:VOLTage:RANGe {|MIN|MAX}[,(@)] [SENSe:]FREQuency:VOLTage:RANGe? [{(@)|MIN|MAX}] [SENSe:]PERiod:VOLTage:RANGe {|MIN|MAX}[,(@)] [SENSe:]PERiod:VOLTage:RANGe? [{(@)|MIN|MAX}] Description Parameters Set or query the voltage ranges of the frequency or period measurements on the specified channels.
PAGE 163
Chapter 2 Command System RIGOL CONFigure:FREQuency MEASure:FREQuency? CONFigure:PERiod MEASure:PERiod? [SENSe:]FUNCtion M300 Programming Guide 2-145
PAGE 164
RIGOL Chapter 2 Command System [SENSe:]FREQuency:VOLTage:RANGe:AUTO [SENSe:]PERiod:VOLTage:RANGe:AUTO Syntax [SENSe:]FREQuency:VOLTage:RANGe:AUTO [,(@)] [SENSe:]FREQuency:VOLTage:RANGe:AUTO? [(@)] [SENSe:]PERiod:VOLTage:RANGe:AUTO [,(@)] [SENSe:]PERiod:VOLTage:RANGe:AUTO? [(@)] Description Parameters Disable or enable the autoranging of the frequency or period measurements on the specified channels.
PAGE 165
RIGOL Chapter 2 Command System [SENSe:]FRESistance:APERture [SENSe:]RESistance:APERture Syntax [SENSe:]FRESistance:APERture {|MIN|MAX}[,(@)] [SENSe:]FRESistance:APERture? [{(@)|MIN|MAX}] [SENSe:]RESistance:APERture {|MIN|MAX}[,(@)] [SENSe:]RESistance:APERture? [{(@)|MIN|MAX}] Description Parameters Set or query the integration time via the aperture time mode for the 2-wire or 4-wire resistance measurements on the specified channels.
PAGE 166
RIGOL Chapter 2 Command System [SENSe:]FRESistance:NPLC [SENSe:]RESistance:NPLC Syntax [SENSe:]FRESistance:NPLC {|MIN|MAX}[,(@)] [SENSe:]FRESistance:NPLC? [{(@)|MIN|MAX}] [SENSe:]RESistance:NPLC {|MIN|MAX}[,(@)] [SENSe:]RESistance:NPLC? [{(@)|MIN|MAX}] Description Parameters Set or query the integration time via the power line cycles mode for the 2-wire or 4-wire resistance measurements on the specified channels.
PAGE 167
Chapter 2 Command System Related commands RIGOL SENSe Command Subsystem CONFigure:FRESistance CONFigure:RESistance MEASure:FRESistance? MEASure:RESistance? [SENSe:]FRESistance:APERture [SENSe:]RESistance:APERture [SENSe:]FRESistance:RESolution [SENSe:]RESistance:RESolution M300 Programming Guide 2-149
PAGE 168
RIGOL Chapter 2 Command System [SENSe:]FRESistance:OCOMpensated [SENSe:]RESistance:OCOMpensated Syntax Description Parameters [SENSe:]FRESistance:OCOMpensated [,(@)] [SENSe:]FRESistance:OCOMpensated? [(@)] [SENSe:]RESistance:OCOMpensated [,(@)] [SENSe:]RESistance:OCOMpensated? [(@)] Enable or disable the offset compensation function for the 2-wire or 4-wire resistance measurements on the specified channels.
PAGE 169
RIGOL Chapter 2 Command System [SENSe:]FRESistance:RANGe [SENSe:]RESistance:RANGe Syntax [SENSe:]FRESistance:RANGe {|MIN|MAX}[,(@)] [SENSe:]FRESistance:RANGe? [{(@)|MIN|MAX}] [SENSe:]RESistance:RANGe {|MIN|MAX}[,(@)] [SENSe:]RESistance:RANGe? [{(@)|MIN|MAX}] Description Parameters Set the measurement range of the 2-wire or 4-wire resistance measurements on the specified channels.
PAGE 170
RIGOL Chapter 2 Command System You can replace FRES with RES to set the measurement range of the 2-wire resistance measurements on the specified channels.
PAGE 171
RIGOL Chapter 2 Command System [SENSe:]FRESistance:RANGe:AUTO [SENSe:]RESistance:RANGe:AUTO Syntax [SENSe:]FRESistance:RANGe:AUTO [,(@)] [SENSe:]FRESistance:RANGe:AUTO? [(@)] [SENSe:]RESistance:RANGe:AUTO [,(@)] [SENSe:]RESistance:RANGe:AUTO? [(@)] Description Parameters Enable or disable the autoranging of the 2-wire or 4-wire resistance measurements on the specified channels.
PAGE 172
RIGOL Chapter 2 Command System [SENSe:]FRESistance:RESolution [SENSe:]RESistance:RESolution Syntax [SENSe:]FRESistance:RESolution {|MIN|MAX}[,(@)] [SENSe:]FRESistance:RESolution? [{(@)|MIN|MAX}] [SENSe:]RESistance:RESolution {|MIN|MAX}[,(@)] [SENSe:]RESistance:RESolution? [{(@)|MIN|MAX}] Description Parameters Set or query the resolution of the 2-wire or 4-wire resistance measurements on the specified channels.
PAGE 173
Chapter 2 Command System RIGOL the *RST command). An Instrument Preset (send the SYSTem:PRESet command) or Card Reset (send the SYSTem:CPON command) does not affect the current resolution. Return Format Example The query returns the resolution in scientific notation for each channel specified. Multiple return values are separated by commas. FRES:RANG 2.0E+5,(@201,212) FRES:RES 0.6,(@201,212) FRES:RES? (@201,212) The query returns +6.00000000E-01, +6.00000000E-01.
PAGE 174
RIGOL Chapter 2 Command System [SENSe:]FUNCtion Syntax [SENSe:]FUNCtion ""[,(@)] [SENSe:]FUNCtion? [(@)] Description Parameters Set or query the measurement functions of the specified channels.
PAGE 175
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:APERture Syntax [SENSe:]TEMPerature:APERture {|MIN|MAX}[,(@)] [SENSe:]TEMPerature:APERture? [{(@)|MIN|MAX}] Description Parameters Set or query the integration time via the aperture time mode for the temperature measurements on the specified channels. Name Type Numeric Range Any numeric value between MIN and MAX. MIN=33 µs, MAX=4 s.
PAGE 176
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:NPLC Syntax [SENSe:]TEMPerature:NPLC {|MIN|MAX}[,(@)] [SENSe:]TEMPerature:NPLC? [{(@)|MIN|MAX}] Description Parameters Set or query the integration time via the power line cycles mode for the temperature measurements on the specified channels. Name Type Range Default Numeric Any numeric value between MIN and MAX. The final integration time is decided by the “Principle of setting with greater value”.
PAGE 177
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:RJUNction? Syntax Description Parameters [SENSe:]TEMPerature:RJUNction? [(@)] Query the temperatures of the internal reference sources of the specified channels.
PAGE 178
RIGOL Chapter 2 Command System [SENSe:]TEMP:TRANsducer:FRTD:OCOMpensated [SENSe:]TEMP:TRANsducer:RTD:OCOMpensated Syntax [SENSe:]TEMP:TRANsducer:FRTD:OCOMpensated [,(@)] [SENSe:]TEMP:TRANsducer:FRTD:OCOMpensated? [(@)] [SENSe:]TEMP:TRANsducer:RTD:OCOMpensated [,(@)] [SENSe:]TEMP:TRANsducer:RTD:OCOMpensated? [(@)] Description Parameters Enable or disable the offset compensation function for the 2-wire or 4-wire thermal resistance temperature measurements
PAGE 179
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence] [SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence] Syntax [SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence] [,(@)] [SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]? [(@)] [SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence] [,(@)] [SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]? [(@)] Description Parameters Set or qu
PAGE 180
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:TRANsducer:FRTD:TYPE [SENSe:]TEMPerature:TRANsducer:RTD:TYPE Syntax [SENSe:]TEMPerature:TRANsducer:FRTD:TYPE [,(@)] [SENSe:]TEMPerature:TRANsducer:FRTD:TYPE? [(@)] [SENSe:]TEMPerature:TRANsducer:RTD:TYPE [,(@)] [SENSe:]TEMPerature:TRANsducer:RTD:TYPE? [(@)] Description Parameters Set or query the thermal resistance type of the 2-wire or 4-wire thermal resistance temperature measurements on the specified c
PAGE 181
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:TRANsducer:TCouple:CHECk Syntax [SENSe:]TEMPerature:TRANsducer:TCouple:CHECk [,(@)] [SENSe:]TEMPerature:TRANsducer:TCouple:CHECk? [(@)] Description Parameters Disable or enable the T/C check function (check whether the thermocouples are properly connected) of the thermalcouple measurements on the specified channels.
PAGE 182
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE Syntax [SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE [,(@)] [SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE? [(@)] Description Parameters Set or query the reference source type of the thermocouple temperature measurements on the specified channels.
PAGE 183
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction Syntax [SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction {|MIN|MAX}[,(@)] [SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction? [MIN|MAX][,(@)] Description Parameters Set or query the reference junction temperature of the thermocouple temperature measurements (fixed reference source) on the specified channels.
PAGE 184
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:TRANsducer:TCouple:TYPE Syntax [SENSe:]TEMPerature:TRANsducer:TCouple:TYPE [,(@)] [SENSe:]TEMPerature:TRANsducer:TCouple:TYPE? [(@)] Description Parameters Set or query the thermocouple type of the thermocouple temperature measurements on the specified channels.
PAGE 185
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE Syntax [SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE [,(@)] [SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE? [(@)] Description Parameters Set or query the thermistor type of the thermistor temperature measurements on the specified channels.
PAGE 186
RIGOL Chapter 2 Command System [SENSe:]TEMPerature:TRANsducer:TYPE Syntax [SENSe:]TEMPerature:TRANsducer:TYPE {TCouple|RTD|FRTD|THERmistor|DEF}[,(@)] [SENSe:]TEMPerature:TRANsducer:TYPE? [(@)] Description Parameters Set or query the sensor type of the temperature measurements on the specified channels.
PAGE 187
RIGOL Chapter 2 Command System [SENSe:]TOTalize:CLEar:IMMediate Syntax Description Parameters [SENSe:]TOTalize:CLEar:IMMediate [(@)] Clear the counts of the specified totalizer channels immediately.
PAGE 188
RIGOL Chapter 2 Command System [SENSe:]TOTalize:DATA? Syntax Description Parameters [SENSe:]TOTalize:DATA? [(@)] Read the counts of the specified totalizer channels.
PAGE 189
RIGOL Chapter 2 Command System [SENSe:]TOTalize:SLOPe Syntax [SENSe:]TOTalize:SLOPe [,(@)] [SENSe:]TOTalize:SLOPe? [(@)] Description Parameters Set the specified totalizer channels to count when the rising edge or falling edge of the input signal passes through the threshold.
PAGE 190
RIGOL Chapter 2 Command System [SENSe:]TOTalize:STARt[:IMMediate] Syntax Description Parameters [SENSe:]TOTalize:STARt[:IMMediate] [(@)] Enable the specified totalizer channels to start counting immediately.
PAGE 191
RIGOL Chapter 2 Command System [SENSe:]TOTalize:STOP[:IMMediate] Syntax Description Parameters [SENSe:]TOTalize:STOP[:IMMediate] [(@)] Enable the specified totalizer channels to stop counting immediately.
PAGE 192
RIGOL Chapter 2 Command System [SENSe:]TOTalize:TYPE Syntax [SENSe:]TOTalize:TYPE [,(@)] [SENSe:]TOTalize:TYPE? [(@)] Description Parameters Set the reading mode for the specified totalizer channels.
PAGE 193
RIGOL Chapter 2 Command System [SENSe:]TOTalize:THReshold Syntax [SENSe:]TOTalize:THReshold [,(@)] [SENSe:]TOTalize:THReshold? [(@)] Description Parameters Set or query the threshold values for the specified TOT channels. Name Type Range Default Numeric Any numeric value between -12V and +12V, the resolution is 0.001 V 2.
PAGE 194
RIGOL Chapter 2 Command System [SENSe:]VOLTage:AC:RANGe [SENSe:]VOLTage[:DC]:RANGe Syntax [SENSe:]VOLTage:AC:RANGe {|MIN|MAX}[,(@)] [SENSe:]VOLTage:AC:RANGe? [{(@)|MIN|MAX}] [SENSe:]VOLTage[:DC]:RANGe {|MIN|MAX}[,(@)] [SENSe:]VOLTage[:DC]:RANGe? [{(@)|MIN|MAX}] Description Parameters Set or query the measurement range of the ACV or DCV measurements on the specified channels.
PAGE 195
Chapter 2 Command System RIGOL specified channels.
PAGE 196
RIGOL Chapter 2 Command System [SENSe:]VOLTage:AC:RANGe:AUTO [SENSe:]VOLTage[:DC]:RANGe:AUTO Syntax [SENSe:]VOLTage:AC:RANGe:AUTO [,(@)] [SENSe:]VOLTage:AC:RANGe:AUTO? [(@)] [SENSe:]VOLTage[:DC]:RANGe:AUTO [,(@)] [SENSe:]VOLTage[:DC]:RANGe:AUTO? [(@)] Description Parameters Enable or disable the autoranging of the ACV or DCV measurements on the specified channels.
PAGE 197
RIGOL Chapter 2 Command System [SENSe:]VOLTage:AC:BANDwidth Syntax [SENSe:]VOLTage:AC:BANDwidth {|MIN|MAX}[,(@)] [SENSe:]VOLTage:AC:BANDwidth? [{(@)|MIN|MAX}] Description Parameters Set or query the AC filter parameter of the ACV measurements on the specified channels. Name Explanation Return Format Example Type Range Default Numeric Any numeric value between MIN and 1000000.
PAGE 198
RIGOL Chapter 2 Command System [SENSe:]VOLTage:AC:RESolution Syntax [SENSe:]VOLTage:AC:RESolution {|MIN|MAX}[,(@)] [SENSe:]VOLTage:AC:RESolution? [{(@)|MIN|MAX}] Description Parameters Set or query the resolution of the ACV measurements on the specified channels. Name Type Range Numeric Can receive any numeric value, but the resolution is fixed at 61/2 digits.
PAGE 199
RIGOL Chapter 2 Command System [SENSe:]VOLTage[:DC]:APERture Syntax [SENSe:]VOLTage[:DC]:APERture {|MIN|MAX}[,(@)] [SENSe:]VOLTage[:DC]:APERture? [{(@)|MIN|MAX}] Description Parameters Set or query the integration time via the aperture time mode for the DCV measurements on the specified channels. Name Type Range Default Numeric Any numeric value between MIN and MAX. MIN=33 µs, MAX=4 s.
PAGE 200
RIGOL Chapter 2 Command System [SENSe:]VOLTage[:DC]:NPLC Syntax [SENSe:]VOLTage[:DC]:NPLC {|MIN|MAX}[,(@)] [SENSe:]VOLTage[:DC]:NPLC? [{(@)|MIN|MAX}] Description Parameters Set or query the integration time via the power line cycles mode for the DCV measurements on the specified channels. Name Explanation Return Format Example Type Range Default Numeric Any numeric value between MIN and MAX.
PAGE 201
RIGOL Chapter 2 Command System [SENSe:]VOLTage[:DC]:RESolution Syntax [SENSe:]VOLTage[:DC]:RESolution {|MIN|MAX}[,(@)] [SENSe:]VOLTage[:DC]:RESolution? [{(@)|MIN|MAX}] Description Parameters Set or query the resolution of the DCV measurements on the specified channels. Name Explanation Return Format Example Type Range Default Numeric Any numeric value between 0.03ppm× and 3ppm×.
PAGE 202
RIGOL Chapter 2 Command System [SENSe:]VOLTage[:DC]:RANGe [SENSe:]VOLTage[:DC]:APERture [SENSe:]VOLTage[:DC]:NPLC CONFigure:VOLTage[:DC] MEASure:VOLTage[:DC]? [SENSe:]ZERO:AUTO Syntax [SENSe:]ZERO:AUTO [,(@)] [SENSe:]ZERO:AUTO? [(@)] Description Parameters Enable or disable the autozero function of the specified channels.
PAGE 203
Chapter 2 Command System RIGOL SOURce Command Subsystem  SOURce:DIGital:DATA[:BYTE]  SOURce:DIGital:DATA:DWORd  SOURce:DIGital:DATA:WORD  SOURce:DIGital:STATe?  SOURce:VOLTage M300 Programming Guide 2-185
PAGE 204
RIGOL Chapter 2 Command System SOURce:DIGital:DATA[:BYTE] SOURce:DIGital:DATA:DWORd SOURce:DIGital:DATA:WORD Syntax SOURce:DIGital:DATA[:BYTE] ,(@) SOURce:DIGital:DATA[:BYTE]? (@) SOURce:DIGital:DATA:DWORd ,(@) SOURce:DIGital:DATA:DWORd? (@) SOURce:DIGital:DATA:WORD ,(@) SOURce:DIGital:DATA:WORD? (@) Description Parameters Set the specified DIO channels to output the specified values in 8-bit (BYTE), 16-bit (WORD) or 32-bit (DWORD)
PAGE 205
RIGOL Chapter 2 Command System SOURce:DIGital:STATe? Syntax Description Parameters SOURce:DIGital:STATe? (@) Query the status (input or output) of the specified DIO channels.
PAGE 206
RIGOL Chapter 2 Command System SOURce:VOLTage Syntax SOURce:VOLTage ,(@) SOURce:VOLTage? (@) Description Parameters Set or query the analog output voltages of the specified DAC channels. Name Type Range Default Numeric Any numeric value between -12V and +12V.
PAGE 207
RIGOL Chapter 2 Command System STATus Command Subsystem  STATus:ALARm:CONDition?  STATus:ALARm:ENABle  STATus:ALARm[:EVENt]?  STATus:OPERation:CONDition?  STATus:OPERation:ENABle  STATus:OPERation[:EVENt]?  STATus:PRESet  STATus:QUEStionable:CONDition?  STATus:QUEStionable:ENABle  STATus:QUEStionable[:EVENt]? Explanation: The M300 status system is as shown in Figure 1-2.
PAGE 208
RIGOL Chapter 2 Command System STATus:ALARm:ENABle Syntax Description Parameters Explanation STATus:ALARm:ENABle STATus:ALARm:ENABle? Set or query the enable register for the Alarm Register set. Name Type Range Default Integer 0 to 65535 None  When the events correspond to the bits that are set to 1 in the register occurs, the bits are then reported to the status byte register.  Sending the STATus:PRESet command will set this register to 0.
PAGE 209
RIGOL Chapter 2 Command System STATus:ALARm[:EVENt]? Syntax STATus:ALARm[:EVENt]? Description Query the event register for the Alarm Register set. Explanation  As the event register is read-only, once a bit is set to 1, it remains set until cleared by the query command (such as the STAT:ALAR:EVENt? command) or the *CLS command.  The bit definitions for the alarm event register are as shown in the table below.
PAGE 210
RIGOL Chapter 2 Command System STATus:OPERation:CONDition? Syntax STATus:OPERation:CONDition? Description Query the condition register for the Operation Status Register set. Explanation  This is a read-only register and the bits are not cleared when you read the register.  Bit 14 (Busy) will be set to 1 while the instrument is executing a time-consuming command, such as the MMEMory:IMPort:CONFig? command.
PAGE 211
RIGOL Chapter 2 Command System STATus:OPERation:ENABle Syntax Description Parameters Explanation STATus:OPERation:ENABle STATus:OPERation:ENABle? inset or query the enable register for the Operation Status Register set. Name Type Range Default Integer 0 to 65535 None  When the events correspond to the bits that are set to 1 in the register occurs, the bits are then reported to the status byte register.
PAGE 212
RIGOL Chapter 2 Command System STATus:OPERation[:EVENt]? Syntax STATus:OPERation[:EVENt]? Description Read and clear the condition register for the Operation Status Register set. Explanation  As the event register is read-only, once a bit is set to 1, it remains set until cleared by the query command (such as the STAT:ALAR:EVENt? command) or the *CLS command.  The bit definitions for the operation status event register are as hown in the table below.
PAGE 213
RIGOL Chapter 2 Command System STATus:PRESet Syntax Description Example STATus:PRESet Clear the alarm enable register, the operation status enable register and the questionable status enable register. STAT:PRES STAT:ALAR:ENAB? The query returns 0. Related commands STATus:ALARm:ENABle STATus:OPERation:ENABle STATus:QUEStionable:ENABle STATus:QUEStionable:CONDition? Syntax STATus:QUEStionable:CONDition? Description Query the condition register for the Questionable Status Register set.
PAGE 214
RIGOL Chapter 2 Command System STATus:QUEStionable:ENABle Syntax Description Parameters Explanation Return Format Example STATus:QUEStionable:ENABle STATus:QUEStionable:ENABle? Set or query the enable register for the Questionable Status Register set. Name Type Range Default Integer 0 to 65535 None  When the events correspond to the bits that are set to 1 in the register occurs, the bits are then reported to the status byte register.
PAGE 215
Chapter 2 Command System RIGOL STATus:QUEStionable[:EVENt]? Syntax STATus:QUEStionable[:EVENt]? Description Read and clear the condition register for the Questionable Status Register set. Explanation  As the event register is read-only, once a bit is set to 1, it remains set until cleared by the query command (such as the STAT:ALAR:EVENt? command) or the *CLS command.  The bit definitions for the questionable status event register are as shown in the table below.
PAGE 216
RIGOL Chapter 2 Command System SYSTem Command Subsystem  SYSTem:ALARm?  SYSTem:COMMunicate:GPIB:ADDRess  SYSTem:COMMunicate:LAN:AUTOip  SYSTem:COMMunicate:LAN:CONTrol?  SYSTem:COMMunicate:LAN:DHCP  SYSTem:COMMunicate:LAN:DNS  SYSTem:COMMunicate:LAN:GATEway  SYSTem:COMMunicate:LAN:IPADdress  SYSTem:COMMunicate:LAN:MAC?  SYSTem:COMMunicate:LAN:MANUip  SYSTem:COMMunicate:LAN:TELNet:PROMpt  SYSTem:COMMunicate:LAN:TELNet:WMESsage  SYSTem:COMMunicate:LAN:SMASk  SYSTem:CO
PAGE 217
RIGOL Chapter 2 Command System  SYSTem:UTIlity:CARDoperation  SYSTem:UTIlity:CONFigure:POWEron  SYSTem:UTIlity:DISPlay:BRIGht  SYSTem:UTIlity:FORMat:DECImal  SYSTem:UTIlity:FORMat:SEPArate  SYSTem:UTIlity:LANGuage  SYSTem:UTIlity:POWEr:SWITch:STATe  SYSTem:UTIlity:SAVEr:STATe  SYSTem:UTIlity:SAVEr:TIME  SYSTem:VERSion? SYSTem:ALARm? Syntax SYSTem:ALARm? Description Query the alarm data from the alarm queue.
PAGE 218
RIGOL Chapter 2 Command System SYSTem:COMMunicate:GPIB:ADDRess Syntax SYSTem:COMMunicate:GPIB:ADDRess <0-30> SYSTem:COMMunicate:GPIB:ADDRess? Description Parameters Explanation Return Format Example Set or query the GPIB address. Name Type Range Default <0-30> Integer 0 to 30. None  Before using the GPIB interface, connect the instrument and PC using a GPIB cable and set the GPIB address.
PAGE 219
RIGOL Chapter 2 Command System SYSTem:COMMunicate:LAN:AUTOip Syntax SYSTem:COMMunicate:LAN:AUTOip SYSTem:COMMunicate:LAN:AUTOip? Description Parameters Explanation Return Format Example Enable or disable the auto IP configuration mode. Name Type Range Default Bool {ON|OFF|0|1} None  In auto IP configuration mode, the instrument acquires the IP address from 169.254.0.1 to 169.254.255.254 and subnet mask 255.255.0.0 according to the current network configuration automatically.
PAGE 220
RIGOL Chapter 2 Command System SYSTem:COMMunicate:LAN:DHCP Syntax Description Parameters Explanation Return Format Example SYSTem:COMMunicate:LAN:DHCP SYSTem:COMMunicate:LAN:DHCP? Disable or enable the DHCP configuration mode. Name Type Range Default Bool {ON|OFF|1|0} None  In DHCP mode, the DHCP server in the current network assigns network parameters (such as the IP address) for the instrument.
PAGE 221
RIGOL Chapter 2 Command System SYSTem:COMMunicate:LAN:DNS Syntax SYSTem:COMMunicate:LAN:DNS "
" SYSTem:COMMunicate:LAN:DNS? [{CURRent|STATic}] Description Parameters Explanation Return Format Example Set or query the DNS (Domain Name Service). Name Type Range Default
ASCII string The format is nnn.nnn.nnn.nnn; the first nnn ranges from 1 to 223 (except 127), the other three range from 0 to 255.
PAGE 222
RIGOL Chapter 2 Command System SYSTem:COMMunicate:LAN:GATEway Syntax SYSTem:COMMunicate:LAN:GATEway "
" SYSTem:COMMunicate:LAN:GATEway? [{CURRent|STATic}] Description Parameters Explanation Return Format Example Set or query the default gateway. Name Type Range Default
ASCII string The format is nnn.nnn.nnn.nnn; the first nnn ranges from 1 to 223 (except 127), the other three range from 0 to 255.
PAGE 223
RIGOL Chapter 2 Command System SYSTem:COMMunicate:LAN:IPADdress Syntax SYSTem:COMMunicate:LAN:IPADdress "
" SYSTem:COMMunicate:LAN:IPADdress? [{CURRent|STATic}] Description Parameters Explanation Return Format Example Set or query the IP address. Name Type Range Default
ASCII string The format is nnn.nnn.nnn.nnn; the first nnn ranges from 1 to 223 (except 127), the other three range from 0 to 255.
PAGE 224
RIGOL Chapter 2 Command System SYSTem:COMMunicate:LAN:MANUip Syntax SYSTem:COMMunicate:LAN:MANUip SYSTem:COMMunicate:LAN:MANUip? Description Parameters Explanation Return Format Example Enable or disable the manual IP configuration mode. Name Type Range Default Bool ON|OFF|0|1 ON  In manual IP configuration mode, users define the network parameters (such as the IP address).
PAGE 225
RIGOL Chapter 2 Command System SYSTem:COMMunicate:LAN:TELNet:PROMpt SYSTem:COMMunicate:LAN:TELNet:WMESsage Syntax SYSTem:COMMunicate:LAN:TELNet:PROMpt "" SYSTem:COMMunicate:LAN:TELNet:PROMpt? SYSTem:COMMunicate:LAN:TELNet:WMESsage "" SYSTem:COMMunicate:LAN:TELNet:WMESsage? Description Parameters Explanation Return Format Example Set the command prompt and welcome message when a Telnet session is used to communicate with the instrument.
PAGE 226
RIGOL Chapter 2 Command System SYSTem:COMMunicate:LAN:SMASk Syntax SYSTem:COMMunicate:LAN:SMASk "" SYSTem:COMMunicate:LAN:SMASk? [{CURRent|STATic}] Description Parameters Explanation Return Format Example Set or query the subnet mask. Name Type Range Default ASCII string The format is nnn.nnn.nnn.nnn; wherein, the range of nnn is from 0 to 255. None  This command is only available when the manual IP configuration mode is enabled.
PAGE 227
RIGOL Chapter 2 Command System SYSTem:COMMunicate:LAN:UPDate Syntax SYSTem:COMMunicate:LAN:UPDate Description Update the LAN parameters. Disconnect all the LAN and Web connections and restart the LAN interface with the current LAN parameters. Explanation  Executing this command updates the settings of the following commands.
PAGE 228
RIGOL Chapter 2 Command System SYSTem:COMMunicate:RS232:FLOWcontrol Syntax SYSTem:COMMunicate:RS232:FLOWcontrol {NONE|XON/XOFF|DTR/DSR|RTS/CTS|MODem} SYSTem:COMMunicate:RS232:FLOWcontrol? Description Parameters Explanation Set or query the flow control mode of the RS232 interface. Name Type Range Default {NONE|XON/XOFF|DTR/DSR |RTS/CTS|MODem} Bool NONE|XON/XOFF|DTR/DSR |RTS/CTS|MODem None  Please select the flow control mode that matches the computer or DTE.
PAGE 229
RIGOL Chapter 2 Command System SYSTem:COMMunicate:RS232:PARIty Syntax SYSTem:COMMunicate:RS232:PARIty {NONE|ODD|EVEN} SYSTem:COMMunicate:RS232:PARIty? Description Parameters Explanation Return Format Example Set the parity mode to “None”, “Odd” or “Even”.
PAGE 230
RIGOL Chapter 2 Command System SYSTem:CPON Syntax Description Parameters Explanation Example Related commands 2-212 SYSTem:CPON Reset the module in the specified slot. Name Type Range Default Discrete {100|200|300|400|500|ALL} None  The effect of this command on different module is follows. Module Effect MC3120 If any channel is configured into the scan list, this command MC3132 has no effect.
PAGE 231
RIGOL Chapter 2 Command System SYSTem:CTYPe? Syntax Description Parameters Explanation Return Format SYSTem:CTYPe? Query the related information (such as the model) of the module in the specified slot. Name Type Range Default Discrete {100|200|300|400|500} None If the specified slot is empty, the command retruns RIGOL TECHNOLOGIES,0,0,0. The query returns strings separated by commas, as shown below. Format expalanation: RIGOL TECHNOLOGIES,MC3132,MM3D000000000,00.01.01.
PAGE 232
RIGOL Chapter 2 Command System SYSTem:EDITion? Syntax Description Return Format Example SYSTem:EDITion? Query the version of the M300 mainframe. The query returns seven numbers separated by commas in the form of "XX.XX.XX.XX.XX.XX.XX". SYST:EDIT? The query returns 07.08.00.01.00.00.20 Related command SYSTem:VERSion? SYSTem:ERRor? Syntax SYSTem:ERRor? Description Read and clear an error from the error queue.
PAGE 233
RIGOL Chapter 2 Command System SYSTem:IDN:USER:DEFine Syntax SYSTem:IDN:USER:DEFine SYSTem:IDN:USER:DEFine? Description Use the user-defined string to reset the ID string of the instrument. Query the current user-defined ID string of the instrument.
PAGE 234
RIGOL Chapter 2 Command System SYSTem:LFRequency? Syntax SYSTem:LFRequency? Description Query the current power-line frequency of the instrument. Explanation When you apply power to the instrument, the instrument automatically detects the power-line frequency and uses this value to calculate the power line cycles (1PLC=1/current power-line frequency). Return Format Example The query returns "+50" (for the frequency outside the range of 55Hz to 66Hz) or "+60" (for 55Hz to 66Hz).
PAGE 235
RIGOL Chapter 2 Command System SYSTem:REMote Syntax SYSTem:REMote Description Place the instrument in the remote mode. Explanation In the remote mode, all the keys (except disabled. Example Related commands , and ) on the front panel are SYST:REM SYSTem:LOCal SYSTem:RWLock SYSTem:RWLock Syntax SYSTem:RWLock Description Place the instrument in the remote locked mode. Explanation In the locked mode, all the keys (except ) on the front panel are disabled.
PAGE 236
RIGOL Chapter 2 Command System SYSTem:TIME Syntax SYSTem:TIME ,, SYSTem:TIME? Description Parameters Explanation Return Format Example Set or query the instrument clock (based on a 24-hour clock). Name Type Range Default Integer Hour, an integer value between 0 and 23. None Integer Minute, an integer value between 0 and 59. None Integer Second, an integer value between 0 and 60. Millisecond, an integer value between 0 and 999.
PAGE 237
RIGOL Chapter 2 Command System SYSTem:TYPE? Syntax Description Return Format Example SYSTem:TYPE? Query the instrument model. The query returns “M300”. SYST:TYPE? The query returns M300. Related commands SYSTem:EDITion? SYSTem:SERIal? SYSTem:UTIlity:BEEPer:STATe Syntax SYSTem:UTIlity:BEEPer:STATe ON|OFF|1|0 SYSTem:UTIlity:BEEPer:STATe? Description Parameters Explanation Return Format Example Enable or disable the beeper.
PAGE 238
RIGOL Chapter 2 Command System SYSTem:UTIlity:CARDoperation Syntax SYSTem:UTIlity:CARDoperation SYSTem:UTIlity:CARDoperation? Description Parameters Explanation Return Format Example All the modules of M300 are not hot-swappable. To avoid damage caused by mis-operations (insert or plug the modules when the instrument is running), you can use this command to set the treatment of the mainframe when the modules are inserted or plugged.
PAGE 239
RIGOL Chapter 2 Command System SYSTem:UTIlity:CONFigure:POWEron Syntax SYSTem:UTIlity:CONFigure:POWEron LAST|DEF SYSTem:UTIlity:CONFigure:POWEron? Description Parameters Explanation Set or query thepower-on value of the instrument. Name Type Range Default {DEFault|LAST} Discrete DEFault|LAST DEFault  LAST: the instrument uses the system configuration before the last power-off at power-on.
PAGE 240
RIGOL Chapter 2 Command System SYSTem:UTIlity:FORMat:DECImal Syntax SYSTem:UTIlity:FORMat:DECImal COMMA|DOT SYSTem:UTIlity:FORMat:DECImal? Description Parameters Explanation Return Format Example Set the display form of the decimal point of the screen data to “.” or “,”. Name Type Range Default {COMMA|DOT} Discrete COMMA|DOT DOT  The decimal pint is set to dot after a Factory Reset (send the *RST command). The query returns COMMA (“,”) or DOT (“.”).
PAGE 241
RIGOL Chapter 2 Command System SYSTem:UTIlity:LANGuage Syntax SYSTem:UTIlity:LANGuage CH|EN SYSTem:UTIlity:LANGuage? Description Parameters Return Format Example Set the system language to English or Chinese. Name Type Range Default {EN|CH} Discrete EN|CH None The query returns English or Chinese. SYST:UTI:LANG EN SYST:UTI:LANG? T he query returns English.
PAGE 242
RIGOL Chapter 2 Command System SYSTem:UTIlity:SAVEr:STATe Syntax SYSTem:UTIlity:SAVEr:STATe SYSTem:UTIlity:SAVEr:STATe? Description Parameters Explanation Return Format Example Enable or disable the screen saver function. Name Type Range Default Bool {ON|OFF|1|0} OFF  The screen saver function will be disabled after a Factory Reset (send the *RST command). The query returns 0 (OFF) or 1 (ON). SYST:UTI:SAVE:STAT ON SYST:UTI:SAVE:STAT? The query returns 1.
PAGE 243
Chapter 2 Command System RIGOL SYSTem:VERSion? Syntax Description Return Format Example SYSTem:VERSion? Query the version of the SCPI command set. The query returns 1999.0 SYST:VERS? The query returns 1999.0.
PAGE 244
RIGOL Chapter 2 Command System TRIGger Command Subsystem  TRIGger:ABSolute  TRIGger:COUNt  TRIGger:EDGE  TRIGger:SOURce  TRIGger:TIMer TRIGger:ABSolute Syntax TRIGger:ABSolute ,
,,, TRIGger:ABSolute? Description Parameters Explanation Return Format Example Set the time at which the instrument starts scanning in the absolute time trigger mode. Name Type Range Default Integer 1 to 12.
PAGE 245
RIGOL Chapter 2 Command System TRIGger:COUNt Syntax Description Parameters Explanation TRIGger:COUNt {|MIN|MAX|INFinity} TRIGger:COUNt? Set the number of scans. Name Type Range Default Integer Any integer from 1 to 50000 (MAX) or INFinity. 1  When the number of scans is set to a specific value, the instrument stops automatically when the specified number of scans are finished.
PAGE 246
RIGOL Chapter 2 Command System TRIGger:EDGE Syntax Description Parameters Explanation Return Format Example TRIGger:EDGE {RISing|FALLing} TRIGger:EDGE? Set the edge type of the external trigger input signal when the instrument initiate a trigger in the external trigger mode.
PAGE 247
RIGOL Chapter 2 Command System TRIGger:SOURce Syntax TRIGger:SOURce TRIGger:SOURce? Description Parameters Explanation Set the trigger mode to auto, manual, external, absolute time or alarm.
PAGE 248
RIGOL Chapter 2 Command System  Return Format Example The trigger mode is set to IMMediate (auto) automatically after a Factory Reset (send the *RST command). An Instrument Preset (send the SYSTem:PRESet command) or Card Reset (send the SYSTem:CPON command) does not affect the setting. The query returns BUS, IMM, EXT, ALAR1, ALAR2, ALAR3, ALAR4 or ABS. TRIG:SOUR ABS TRIG:SOUR? The query returns ABS.
PAGE 249
RIGOL Chapter 2 Command System UNIT Command Subsystem  UNIT:ANYSensor  UNIT:TEMPerature UNIT:ANYSensor Syntax UNIT:ANYSensor [,(@)] UNIT:ANYSensor? [(@)] Description Parameters Select the unit for the specified anysensor measurement channels. Name Type Range Default Discrete {Ω|K|#C|%|#F|#|ASCII String} Wherein, "#" represents the degree symbol (°); a quoted ASCII string of up to three characters.
PAGE 250
RIGOL Chapter 2 Command System UNIT:TEMPerature Syntax UNIT:TEMPerature [,(@)] UNIT:TEMPerature? [(@)] Description Set the unit of the temperature measurement on the specified channels. Query the unit of the temperature measurement on the specified channels.
PAGE 251
Chapter 3 Application Examples RIGOL Chapter 3 Application Examples This chapter provides some application examples of the SCPI commands. A series of SCPI commands are combined to realize the main functions of the Data Acquisition/Switch System. Note: 1 Before using the examples in this chapter, please select the desired communication interface (USB, LAN, RS232 or GPIB) and make correct connections (refer to the introductions in To Build Remote Communication).
PAGE 252
RIGOL Chapter 3 Application Examples Scan List Configuration To Configure the Channels Conditions: MC3324 module MC3132 module MC3534 module MC3065 module MC3648 module in in in in in Slot1 Slot2 Slot3 Slot4 Slot5 Requirements Use the SCPI commands to realize the following functions: Configure the channels as follows and add these channels to the scan list to measure a variety of input signals.
PAGE 253
RIGOL Chapter 3 Application Examples 301 DIN:8bit 303 DIN:16bit 305 TOT:READ 307 TOT:RREse Level type: TTL; Alarm setting: DATA=154, MASK=129, TYPE=EQU, alarm channel (Alarm2) ; Alarm setting: DATA=121, MASK=5, TYPE=NEQU, alarm channel (Alarm3); Level type: USER; Voltage level: 5V; THReshold: 3.5V; Alarm setting: HI=1000, alarm channel (Alarm4); Slop: NEGtive; Slop: POStive; Threshold: 5V; Method 1 1. *IDN? 2. 3. 4. 5. 6.
PAGE 254
RIGOL Chapter 3 Application Examples 41. 42. 43. 44. TEMP:TRAN:FRTD:TYPE 92,(@106) /* Set the FRTD type to 92 for channel 106*/ TEMP:NPLC 200,(@106) /*Set the integration time to 200NPLC for channel 106*/ TEMP:TRAN:FRTD:RES:REF 20,(@106)/*Set R0 to 20Ω for channel 106*/ TEMP:TRAN:FRTD:OCOM ON (@106) /*Enable the offset compensation function for channel 106*/ 45. 46. 47. 48. FUNC “FRES”,(@107,108) FRES:RANG:AUTO ON,(@107,108) FRES:NPLC 0.2,(@107,108) ZERO:AUTO ON,(@107,108) 49. 50. 51. 52. 53. 54.
PAGE 255
RIGOL Chapter 3 Application Examples 91. 92. 93. 94. 95. CALC:LIM:LOW 10,(@119) /*Set the alarm lower limit to 10°C for channel 119*/ CALC:LIM:LOW:STAT ON,(@119) /*Enable the lower limit alarm for channel 119*/ OUTP:ALAR3:SOUR (@119) /*Set the alarm channel to Alarm3 for channel 119*/ TEMP:TRAN:TC:CHEC ON,(@119) /*Enable the T/C Check feature for channel 119*/ TEMP:TRAN:TC:RJUN:TYPE INT,(@119) /*Set the reference source to internal for channel 119*/ 96.
PAGE 256
RIGOL Chapter 3 Application Examples 137. DIG:DATA:WORD? (@303) /*Configure the function to 16-bit DIN for channel 303*/ 138. CALC:COMP:DATA 121,(@303) /* Set the alarm value to121 for channel 303*/ 139. CALC:COMP:MASK 5,(@303) /* Set the alarm mask to 5 for channel 303*/ 140. CALC:COMP:TYPE NEQ,(@303) /* Set the alarm mode to “not equal” for channel 303*/ 141. CALC:COMP:STAT ON,(@303) /*Enable the alarm function for channel 303*/ 142.
PAGE 257
RIGOL Chapter 3 Application Examples 27. 28. 29. 30. 31. 32. 33. CALC:SCAL:OFFS 0.01 /*Set scaling parameter C to 0.01 for channel 105*/ CALC:SCAL:CONS 0.1 /*Set scaling parameter x1 to 0.
PAGE 258
RIGOL Chapter 3 Application Examples 71. CONF:TEMP RTD,91,1,DEF,(@115) /*Configure the function to temperature and set the sensor to RTD,91 for channel 115*/ 72. TEMP:NPLC 20 /*Set the integration time to 20PLC for channel 115*/ 73. TEMP:TRAN:RTD:RES:REF 50 /*Set R0 to 50Ω for channel 115*/ 74. CONF:TEMP TC,K,1,DEF,(@119) 75. 76. 77. 78. 79.
PAGE 259
Chapter 3 Application Examples RIGOL 108. CALC:COMP:TYPE EQU /*Set the alarm mode to “equal” for channel 301*/ 109. CALC:COMP:STAT ON /*Enable the alarm function for channel 301*/ 110. OUTP:ALAR2:SOUR (@301) /*Set the alarm channel to Alarm2 for channel 301*/ 111. DIG:TYPE TTL,(@301) /*Set the level type to TTL for channel 301*/ 112. CONF:DIG:WORD (@303) /*Configure channel 303 to 16-bit digital input and reset the scan list */ 113. CALC:COMP:DATA 121 /*Set the alarm value to 121 for channel 303*/ 114.
PAGE 260
RIGOL Chapter 3 Application Examples To Configure the Scan List Requirements Use the SCPI commands to realize the following functions: Configure the scan list as follows, and initiate the scan. Scan count 10 1 1 1 1 Trigger mode TIMer BUS EXTernal ABSolute ALARm2 Related setting Interval: 0.05s None Edge: Falling Time: 8:00 every day Channel: Alarm2 1. *IDN? /*Query the ID string of M300 to check whether the remote communication is normal*/ 2. TRIG:COUN 10 /*Set the number of scans to 100*/ 3.
PAGE 261
RIGOL Chapter 3 Application Examples Monitor Conditions MC3324 module MC3132 module MC3534 module MC3065 module MC3648 module in in in in in Slot1 Slot2 Slot3 Slot4 Slot5 Requirements Use the SCPI commands to realize the following functions: Configure the channels as follows and monitor these channels. Channel 101:103 121:122 301 305 1.
PAGE 262
RIGOL Chapter 3 Application Examples Store and Recall Store and Recall in Internal Memory Requirements Use the SCPI commands to realize the following functions: Configure the instrument as shown in the table below and save the current system configuration with the filename “sys20130708” to the internal memory. Then, recall the system configuration file and overwrite the current system configuration. Configuration Item sound screen saver decimal point separator power key brightness 1. 2. 3. 4. 5. 6. 7. 8.
PAGE 263
Chapter 3 Application Examples RIGOL To Import the .blcfg File from the USB Storage Device Requirements Use the SCPI commands to realize the following functions: Import the Configure.blcfg file from the USB storage device. 1. 2. 3. *IDN? /*Query the ID string of M300 to check whether the remote communication is normal*/ MMEM:IMP:CAT? /*Query the blcfg file in the root directory of the USB storage device*/ MMEM:IMP:CONF? “Configure.blcfg” /*Import the Configure.
PAGE 264
RIGOL Chapter 3 Application Examples Copy Conditions MC3132 module MC3132 module MC3164 module MC3164 module MC3065 module in in in in in Slot1 Slot2 Slot3 Slot4 Slot5 Channel Copy Requirements Use the SCPI commands to realize the following functions: Channel copy: copy the source channel configuration to the destination channels. The source channel configuration and the destination channels are as follows.
PAGE 265
Chapter 3 Application Examples RIGOL Module Copy Requirements Use the SCPI commands to realize the following functions: Module copy: copy the source module configuration to the destination module.The source module configuration and the destination module are as follows. Sourse Module Configuration Destination module Channel Parameter 301:331 Function: VOLT:DC; MC3164 in Slot4 Range: 20V; Integration time: 100PLC; 332:364 Function: RES; Range: Auto; Integration time: 10PLC; 1. 2. 3. 4. 5.
PAGE 266
RIGOL Chapter 3 Application Examples To Output Digital Signal Conditions MC3534 module in Slot3 Requirements Use the SCPI commands to realize the following functions: Configure channels 301 and 302 as an 8-bit output terminal to output 121; set the level type to COMS5. Configure channel 303 as a 16-bit output terminal to output 25; set the level type to USER, the level value to 4.5V and the level threshold to 2V. 1. 2. 3. 4. 5. 6. 7.
PAGE 267
Chapter 4 Programming Demos RIGOL Chapter 4 Programming Demos This chapter provides the demos for programming and controlling the M300 series Data Acquisition/Switch System using SCPI commands under various environment (such as the Visual Basic and Visual Studio) on the basis of NI-VISA. NI-VISA (National Instrument-Virtual Instrument Software Architecture) is an advanced application programming interface developed by NI (National Instrument) for communicating with various instrument buses.
PAGE 268
RIGOL Chapter 4 Programming Demos Programming Preparations Before programming, you need to make the following preparations: 1 Make sure that your PC has installed the NI-VISA library (can be downloaded from NI website: http://www.ni.com/visa/). Here, the default installation path is C:\Program Files\IVI Foundation\VISA.
PAGE 269
Chapter 4 Programming Demos RIGOL LabVIEW Programming Demo The program used in this Demo: LabVIEW 2009 The functions realized in this Demo: search for the instrument address, connect the instrument, send command and read the return value. 1 Run LabVIEW 2009, create a VI file and name it as M300_Demo_LABVIEW.
PAGE 270
RIGOL 4 Chapter 4 Programming Demos Add button events as follows. (1) Connect the instrument (including error processing) first, then query the module information for the five slots and display the module information in the slot bar.
PAGE 271
Chapter 4 Programming Demos RIGOL (2) The text value of Channel control has changed. (3) Configure the specified channels to the DCV measurement function and overwrite the current scan list.
PAGE 272
RIGOL Chapter 4 Programming Demos (4) Configure the specified channels to the DCI measurement function and overwrite the current scan list. (5) Configure the specified channels to the ACV measurement function and overwrite the current scan list.
PAGE 273
Chapter 4 Programming Demos RIGOL (6) Configure the specified channels to the ACI measurement function and overwrite the current scan list. (7) Configure the specified channels to the 2WR measurement function and overwrite the current scan list.
PAGE 274
RIGOL Chapter 4 Programming Demos (8) Configure the specified channels to the 4WR measurement function and overwrite the current scan list. (9) Configure the specified channels to the Frequency measurement function and overwrite the current scan list.
PAGE 275
Chapter 4 Programming Demos RIGOL (10) Configure the specified channels to the Period measurement function and overwrite the current scan list. (11) Configure the specified channels to the Temperature measurement function and overwrite the current scan list.
PAGE 276
RIGOL Chapter 4 Programming Demos (12) Configure the specified channels to the AnySensor measurement function and overwrite the current scan list.
PAGE 277
Chapter 4 Programming Demos RIGOL (14) Read operation (including error processing): M300 Programming Guide 4-11
PAGE 278
RIGOL Chapter 4 Programming Demos (15) Exit: 4-12 M300 Programming Guide
PAGE 279
Chapter 4 Programming Demos 5 RIGOL Running results. 1) Click the Address dropdown box and select the VISA resource name; click Connect to connect the instrument; enter the command into the Command textbox and click Write to write the command into the instrument. If the command is a query command, click Read and the return value is displayed in the Return textbox. 2) Run the program.
PAGE 280
RIGOL Chapter 4 Programming Demos 3) 4) 5) Click the InitScan button to place the instrument in the "wait-for-trigger" state. Click the Abort Scan button to abort the scan in progress. Click the System Error button to query a system error. Click the Read button to read and clear the error.
PAGE 281
RIGOL Chapter 4 Programming Demos C++ Programming Demo The program used in this Demo: Microsoft Visual Studio 2008 The functions realized in this Demo: search for the instrument address, connect the instrument, send command and read the return value. 1 2 3 4 Run Microsoft Visual Studio 2008, create a MFC project based on dialog box and name it as M300_Demo_VC. Add a visa library by adding the statement as follows to the M300_Demo_VCDlg.cpp file.
PAGE 282
RIGOL rbtnAnysensor cmboxSelAnyType cmboxSelTemType 5 Chapter 4 Programming Demos CButton CComboBox CComboBox m_ctrlrbtnAnysensor m_ctrlcmboxSelAnyType m_ctrlcmboxSelTemType Anysensor measurement Temperature sensor type Anysensor type Initiate the ComboBox items by adding the statement as follows to the OnInitDialog() function. //Initiate the cmboxSelAnyType item m_ctrlcmboxSelAnyType.AddString("VOLT"); m_ctrlcmboxSelAnyType.AddString("CURR"); m_ctrlcmboxSelAnyType.
PAGE 283
Chapter 4 Programming Demos 6 RIGOL Encapsulate the write and read operations of VISA. 1) Encapsulate the write operation of VISA for easier operation. bool CM300_Demo_VCDlg::InstrWrite(CString strContent) //write function { ViSession defaultRM,instr; ViStatus status; ViUInt32 retCount; char * SendBuf = NULL; char * SendAddr = NULL; bool bWriteOK = false; CString str; //Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.
PAGE 284
RIGOL Chapter 4 Programming Demos memset(RecBuf,0,MAX_REC_SIZE); //open the VISA instrument status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { // Error Initializing VISA...
PAGE 285
Chapter 4 Programming Demos RIGOL ViChar instrDesc[1000]; CString strSrc = NULL; CString strInstr = NULL; CString strCommand[5] = {"SYST:CTYP? 100","SYST:CTYP? 200","SYST:CTYP? 300","SYST:CTYP? 400","SYST:CTYP? 500"}; CString strM300InfoTemp = ""; CString strSlot = ""; unsigned long i = 0; bool bFindDP = false; status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { // Error Initializing VISA...
PAGE 286
RIGOL Chapter 4 Programming Demos strM300Info = strM300InfoTemp; UpdateData(false); } 2) Write operation. void CM300_Demo_VCDlg::OnBnClickedbtnsend() { // TODO: Add your control notification handler code here UpdateData(true); if( strM300Info.IsEmpty() ) { MessageBox("Please connect to the instrument first!"); } if( strSendCommand.IsEmpty() ) { MessageBox("Please input the command first!"); } else { InstrWrite(strSendCommand); } UpdateData(false); } 3) Read operation.
PAGE 287
Chapter 4 Programming Demos 8 RIGOL + strChannel + ")"; } else if(strMeasurement == "Anysensor" ) { nIndex = m_ctrlcmboxSelAnyType.GetCurSel(); m_ctrlcmboxSelAnyType.GetLBText(nIndex,strType); strCommand = strCommand +strMeasurement + " " + strType + ",(@" + strChannel + ")"; } else { strCommand = strCommand +strMeasurement + " (@" + strChannel + ")"; } InstrWrite(strCommand); } } UpdateData(false); } 5) Initialize scan list.
PAGE 288
RIGOL Chapter 4 Programming Demos { } else { } strMeasurement = "CURR:DC"; strMeasurement = ""; } 3) Click the rbtnACV radio button. void CM300_Demo_VCDlg::OnBnClickedrbtnacv() { // TODO: Add your control notification handler if (m_ctrlrbtnACV.GetCheck() == 1) { strMeasurement = "VOLT:AC"; } else { strMeasurement = ""; } } 4) Click the rbtnACI radio button. void CM300_Demo_VCDlg::OnBnClickedrbtnaci() { // TODO: Add your control notification handler if (m_ctrlrbtnACI.
PAGE 289
Chapter 4 Programming Demos 9 RIGOL } } 7) Click the rbtnFrequency radio button. void CM300_Demo_VCDlg::OnBnClickedrbtnfrequency() { // TODO: Add your control notification handler code here if (m_ctrlrbtnFrequency.GetCheck() == 1) { strMeasurement = "Frequency"; } else { strMeasurement = ""; } } 8) Click the rbtnPeriod radio button. void CM300_Demo_VCDlg::OnBnClickedrbtnperiod() { // TODO: Add your control notification handler code here if (m_ctrlrbtnPeriod.
PAGE 290
RIGOL Chapter 4 Programming Demos 4) Click Read to read the return value. The running results are as shown in the figure below. 5) You can select the desired measurement functions for the specified channels and click the Configure button to configure the scan list with the current configuration. The channel formats are as follws.
PAGE 291
Chapter 4 Programming Demos RIGOL 6) Send the “CONF?” command to query the configuration of the current scan list. The running results are as shown in the figure below. 7) 8) 9) Click the InitScan button to place the instrument in the "wait-for-trigger" state. Click the Abort Scan button to abort the scan in progress. Click the System Error button to query a system error. Click the read button to read and clear the error.
PAGE 292
RIGOL Chapter 4 Programming Demos C# Programming Demo The program used in this Demo: Microsoft Visual Studio 2008 The functions realized in this Demo: search for the instrument address, connect the instrument, send command and read the return value, configure the scan list etc. 1. Run Microsoft Visual Studio 2008, create a C# project based on Windows Form Application and name it as M300_Demo_CSharp. 2. Add a visa library by adding the statement as follows to Form1.cs. using System.Runtime.
PAGE 293
Chapter 4 Programming Demos RIGOL 3. Add the Text, Edit, Button, CheckBox, ComboBox, Label and GroupBox controls and the layout is as shown in the figure below. 4. Initialize the ComboBox items by adding the statement as follows to the Form1 Load event. private void Form1_Load(object sender, EventArgs e) { //Init the NPLC parameter cmboxNPLC.Items.Add("0.02"); cmboxNPLC.Items.Add("0.2"); cmboxNPLC.Items.Add("1"); cmboxNPLC.Items.Add("2"); cmboxNPLC.Items.Add("10"); cmboxNPLC.Items.Add("20"); cmboxNPLC.
PAGE 294
RIGOL 5. Chapter 4 Programming Demos cmboxTemp.Items.Add("TC,N"); cmboxTemp.Items.Add("TC,R"); cmboxTemp.Items.Add("TC,S"); cmboxTemp.Items.Add("TC,T"); cmboxTemp.Items.Add("THER,2252"); cmboxTemp.Items.Add("THER,3000"); cmboxTemp.Items.Add("THER,5000"); cmboxTemp.Items.Add("THER,10000"); cmboxTemp.Items.Add("THER,30000"); cmboxTemp.Items.Add("RTD,85"); cmboxTemp.Items.Add("RTD,89"); cmboxTemp.Items.Add("RTD,91"); cmboxTemp.Items.Add("RTD,92"); cmboxTemp.Items.Add("FRTD,85"); cmboxTemp.Items.
PAGE 295
RIGOL Chapter 4 Programming Demos strReturn = Encoding.ASCII.GetString(temp); } 6. if (strReturn.IndexOf('\n') != -1) { strReturn = strReturn.Substring(0, strReturn.IndexOf('\n')); } else {} return strReturn; Add the Click event of the button controls. 1) Connect the instrument.
PAGE 296
RIGOL Chapter 4 Programming Demos MessageBox.Show(this, "Din't found any instrument！ ", "Tip", MessageBoxButtons.OK, MessageBoxIcon.Information); txtM300Info.Text = ""; return; } // judge whether the instrument is M300 or not and dispaly M300 Information for (int j = 0; (j < 10) && (DevResource[j] != null); j++) { if (DevResource[j].Substring(22, 4) == "M300") { CurrentDeviceM300 = DevResource[j]; break; } } if (CurrentDeviceM300.
PAGE 297
Chapter 4 Programming Demos RIGOL MessageBox.Show(this, "Not RIGOL M300！ ", "Message", MessageBoxButtons.OK, MessageBoxIcon.Information); } } 2) Configure the specified channels and add them into the scan list.
PAGE 298
RIGOL ")"; Chapter 4 Programming Demos } //configure measurement strCommand = "CONF:" + strMeasurement + " (@" + txtChannels.Text + ")"; Device_Send(strCommand); //configure range if (chkRangeAuto.Checked == true || txtRange.Text != "") { if (chkRangeAuto.Checked == true) { strCommand = strMeasurement + ":RANG:AUTO ON"; } else { strCommand = strMeasurement + ":RANG " + txtRange.Text; } strCommand = strCommand + ",(@" + txtChannels.
PAGE 299
Chapter 4 Programming Demos RIGOL } else { strMeasurement = rbtnACI.Text; } //configure measurement strCommand = "CONF:" + strMeasurement + " (@" + txtChannels.Text + ")"; Device_Send(strCommand); //configure range if (chkRangeAuto.Checked == true || txtRange.Text != "") { if (chkRangeAuto.Checked == true) { strCommand = strMeasurement + ":RANG:AUTO ON"; } else { strCommand = strMeasurement + ":RANG " + txtRange.Text; } strCommand = strCommand + ",(@" + txtChannels.
PAGE 300
RIGOL Chapter 4 Programming Demos strCommand = strCommand + ",(@" + txtChannels.Text + ")"; Device_Send(strCommand); } else { } //configure intergeration time if (cmboxNPLC.Text != "" || txtIntertime.Text != "") { if (cmboxNPLC.Text != "") { strCommand = strMeasurement + ":NPLC " + cmboxNPLC.Text; } else { strCommand = strMeasurement + ":APER " + txtIntertime.Text; } strCommand = strCommand + ",(@" + txtChannels.Text + ")"; Device_Send(strCommand); } else { } //configure auto az if (chkAZ.
PAGE 301
Chapter 4 Programming Demos RIGOL strCommand = strMeasurement + "VOLT:RANG " + txtRange.Text; } strCommand = strCommand + ",(@" + txtChannels.Text + ")"; Device_Send(strCommand); } else { } //configure ACFilter if (coboxACFilter.Text != "") { strCommand = strMeasurement + ":RANG:LOW " + coboxACFilter.Text; strCommand = strCommand + ",(@" + txtChannels.Text + ")"; Device_Send(strCommand); } else { } //configure Gate time if (coboxGateTime.
PAGE 302
RIGOL Chapter 4 Programming Demos } else if (cmboxTemp.Text.Substring(0, 2) == "RT" || cmboxTemp.Text.Substring(0, 2) == "FR") { //configure auto az if (chkAZ.Checked == true) { strCommand = "ZERO:AUTO ON"; strCommand = strCommand + ",(@" + txtChannels.Text + ")"; Device_Send(strCommand); } //configure Ocompensated if (chkOcomp.Checked == true) { strCommand = strMeasurement + ":OCOM ON"; strCommand = strCommand + ",(@" + txtChannels.Text + ")"; Device_Send(strCommand); } } else {} } else { MessageBox.
PAGE 303
RIGOL Chapter 4 Programming Demos { ")"; if (chkAZ.Checked == true) { strCommand = "ZERO:AUTO ON"; strCommand = strCommand + ",(@" + txtChannels.Text + Device_Send(strCommand); } if (cmboxAnySensor.Text == "VOLT") { //configure Input impedance for DCI if (rbtnDCV.Checked == true) { if (chkInputimp.Checked == true) { strCommand = "INP:IMP:AUTO ON," + "(@" + txtChannels.Text + ")"; } "FRES") } } Device_Send(strCommand); } if (cmboxAnySensor.Text == "RES" || cmboxAnySensor.
PAGE 304
RIGOL ")"; ")"; ")"; ")"; Chapter 4 Programming Demos //Configure Scaling if (chkEnableScaling.Checked == true) { // Set the square parameter of scaling strCommand = "CALC:SCAL:SQU " + txtA.Text+ ",(@" + txtChannels.Text + Device_Send(strCommand); // Set the gain parameter of scaling strCommand = "CALC:SCAL:GAIN " + txtB.Text + ",(@" + txtChannels.Text + Device_Send(strCommand); // Set the offset parameter of scaling strCommand = "CALC:SCAL:OFFS " + txtC.Text + ",(@" + txtChannels.
PAGE 305
Chapter 4 Programming Demos RIGOL //Configure Alarm Channel if(cmboxSource.Text != "") { strCommand = "OUTP:" + cmboxSource.Text + ":SOUR " + "(@" + txtChannels.Text + ")"; Device_Send(strCommand); } //Confirm the measurement is same with the specified measurement for all of the specified channels strCommand = "CONF? " + "(@" + txtChannels.Text + ")"; Device_Send(strCommand); Thread.Sleep(500); strReturn = ReadFromDev(); strScanList = strReturn.
PAGE 306
RIGOL Chapter 4 Programming Demos private void btnRemoveChannel_Click(object sender, EventArgs e) { string strCommand = "*IDN?"; string strReturn = ""; //make sure M300 is connected to PC try { Device_Send(strCommand); strReturn = ReadFromDev(); if (strReturn == "") { throw new ArgumentNullException(); } } catch { MessageBox.Show("Please make sure the M300 was connected"); return; } //Remove the specified channelfrom scanlist if (cmboxScanlist.
PAGE 307
Chapter 4 Programming Demos RIGOL MessageBox.Show("Please input command", "Tip", MessageBoxButtons.OK, MessageBoxIcon.Information); } } 5) Initiate a scan. private void btnInitScan_Click(object sender, EventArgs e) { string strCommand = "INIT"; Device_Send(strCommand); } 6) Query the configuration of the scan list.
PAGE 308
RIGOL Chapter 4 Programming Demos strReturn = ReadFromDev(); if (strReturn == "") { throw new ArgumentNullException(); } } catch { MessageBox.Show("Please make sure the M300 was connected"); return; } strCommand = "SYST:ERR?"; Device_Send(strCommand); Thread.Sleep(100); strReturn = ReadFromDev(); txtReadFromM300.Text = strReturn; 7. } 10) Read the return value. private void btnRead_Click(object sender, EventArgs e) { string strReturn = ""; strReturn = ReadFromDev(); txtReadFromM300.
PAGE 309
Chapter 4 Programming Demos RIGOL strScanList = strReturn.Split(','); //Query the scan list size strCommand = "ROUT:SCAN:SIZE?"; Device_Send(strCommand); strReturn = ReadFromDev(); s32SizeofScanlist = int.Parse(strReturn); if (s32SizeofScanlist == 0) { cmboxScanlist.Text = ""; } else { for (int i = 0; i < s32SizeofScanlist; i++) { cmboxScanlist.Items.Add(strScanList[i]); } } 8. } Add the CheckedChanged event of the radio button controls. 1) The checked state of the VOLT:DC radio button has changed.
PAGE 310
RIGOL Chapter 4 Programming Demos if (rbtnDCI.Checked == true) { grpACFilter.Enabled = false; grpGatetime.Enabled = false; chkOcomp.Enabled = false; chkInputimp.Enabled = false; } else { grpACFilter.Enabled = true; grpGatetime.Enabled = true; chkOcomp.Enabled = true; chkInputimp.Enabled = true; } } The checked state of the CURR:AC radio button has changed. private void rbtnACI_CheckedChanged(object sender, EventArgs e) { if (rbtnACI.Checked == true) { grpInterTime.Enabled = false; grpGatetime.
PAGE 311
Chapter 4 Programming Demos } else { 7) 8) 9) RIGOL chkInputimp.Enabled = false; grpACFilter.Enabled = true; grpGatetime.Enabled = true; chkInputimp.Enabled = true; } } The checked state of the Frequency radio button has changed. private void rbtnFrequency_CheckedChanged(object sender, EventArgs e) { if (rbtnFrequency.Checked == true) { grpInterTime.Enabled = false; chkOcomp.Enabled = false; chkAZ.Enabled = false; chkInputimp.Enabled = false; } else { grpInterTime.Enabled = true; chkOcomp.
PAGE 312
RIGOL Chapter 4 Programming Demos chkOcomp.Enabled = false; chkAZ.Enabled = true; } else if (cmboxTemp.Text.Substring(0, 2) == "TH") { chkOcomp.Enabled = false; chkAZ.Enabled = true; } else if (cmboxTemp.Text.Substring(0, 2) == "RT" || cmboxTemp.Text.Substring(0, 2) == "FR") { chkOcomp.Enabled = true; chkAZ.Enabled = false; } else {} } } else { grpRange.Enabled = true; grpACFilter.Enabled = true; chkInputimp.Enabled = true; grpGatetime.Enabled = true; chkOcomp.Enabled = true; chkAZ.
PAGE 313
Chapter 4 Programming Demos RIGOL grpACFilter.Enabled = false; chkInputimp.Enabled = false; } else { 9. } else if (cmboxAnySensor.Text == "FREQ") { grpACFilter.Enabled = true; grpInterTime.Enabled = false; chkInputimp.Enabled = false; chkAZ.Enabled = false; chkOcomp.Enabled = false; } else{ } grpRange.Enabled = true; grpScale.Enabled = true; grpGatetime.Enabled = true; grpACFilter.Enabled = true; grpInterTime.Enabled = true; chkInputimp.Enabled = true; chkAZ.Enabled = true; chkOcomp.
PAGE 314
RIGOL Chapter 4 Programming Demos { if (rbtnAnySensor.Checked == true) { grpRange.Enabled = false; grpScale.Enabled = false; grpGatetime.Enabled = false; } else { if (cmboxAnySensor.Text == "CURR") { grpInterTime.Enabled = true; chkAZ.Enabled = true; grpACFilter.Enabled = false; chkOcomp.Enabled = false; chkInputimp.Enabled = false; } else if (cmboxAnySensor.Text == "VOLT") { grpInterTime.Enabled = true; chkAZ.Enabled = true; chkInputimp.Enabled = true; grpACFilter.Enabled = false; chkOcomp.
PAGE 315
Chapter 4 Programming Demos 4) RIGOL Click Read button to read the return value. The running results are as shown in the figure below. 5) You can select a measurement function and configure the corresponding measurement parameters for the specified channels. You can also set the trigger count, click the Configure channels to scanlist button to make the configuration effective and add the specified channels into the scan list.
PAGE 316
RIGOL Chapter 4 Programming Demos 6) You can select a channel from the scan list (Scanlist combox) and remove it from the scan list by clicking the Remove channel from scanlist button. For example, the current scan list was configured as step 5). Select channel 101 from the Scanlist ComBox, and click the Remove channel from scanlist button to remove channel 101 from the scan list. Query the current scan list configuration by clicking the Query Scanlist button. The running results are as follows.
PAGE 317
RIGOL Chapter 5 Appendix Chapter 5 Appendix Appendix A: Factory settings Parameter Scan Configuration Scan List Reading Memory Max, Min, Average and SDEV Trigger Mode Scan Interval Number of Scans Factory Setting Empty Cleared Cleared Auto 10 s (use the TRIGger:SOURce TIMer command) 1 Measurement Configuration Function Range Integration Time Input Impedance Channel Delay TOT Reading Mode TOT Trigger Mode DCV Auto 1 PLC 10 MΩ Auto READ Rising Scaling Configuration Scaling Configuration A B C x1 Unit O
PAGE 318
RIGOL Chapter 5 Appendix MC3648 MC3724 4 DIO ports: input 4 TOT counts: 0 4 DAC: 0 VDC All channels off S11 and S21 are selected System-related Date Time Language Sound DMM Screen Saver Decimal Point Separator Power-on Power Key Module Plug Brightness Error Queue No change No change No change ON No change OFF .
PAGE 319
RIGOL Chapter 5 Appendix Appendix B: Instrument Preset State Parameter Scan Configuration Scan List Reading Memory Max, Min, Average and SDEV Trigger Mode Scan Interval Number of Scans No change Cleared Cleared No change No change No change Measurement Configuration Function Range Integration Time Input Impedance Channel Delay TOT Reading Mode TOT Trigger Mode No No No No No No No change change change change change change change Scaling Configuration Scaling Configuration A B C x1 Unit No No No No N
PAGE 320
RIGOL Chapter 5 Appendix MC3648 MC3724 All channels off S11 and S21 are selected System Related Date Time Language Sound DMM Screen Saver Decimal Point Separator Power-on Power Key Module Plug Brightness No change No change No change ON No change OFF . None Default OFF No change 8 Note*: Sending the SYSTem:PRESet command can restore the instrument to its preset settings.
PAGE 321
Chapter 5 Appendix RIGOL Appendix C: Non-volatile Memory Information in the non-volatile memory is not lost when the power is turned off.
PAGE 322
RIGOL Chapter 5 Appendix Appendix D: Volatile memory Information in the volatile memory is lost when the power is turned off.
PAGE 323
RIGOL Chapter 5 Appendix Appendix E: Module Schematic Diagram Terminal Box: TB20 01 H 01 L Signals to be Measured Channel Switches Bank Switch L 99 ... 10 .. . H Com 78-Pin Interface H L H L Com H (4W Sense) L 98 11 H 20 L H DMM Source L Backplane Switches H L ... Reference Junction 20 97 H DMM Sense L H L Figure 5-1 MC3120 Schematic Diagram Terminal Blocks: TB32 01 H 01 L .. . Channel Switches Bank Switch L 99 ...
PAGE 324
RIGOL Chapter 5 Appendix Terminal Box: M3TB64 H 01 Channel Switches 01 ... 32 Signals to be Measured .. . Com H 78-Pin Interface Com L 33 Backplane Switches 95 Bank Switch ... 96 H DMM Source L 64 H 64 Reference Junction Com L Figure 5-3 MC3164 Schematic Diagram Terminal Blocks: TB64 01 H Channel Switches 01 ... 32 Signals to be Measured .. . Com H 78-Pin Interface 93 Com L 94 33 ...
PAGE 325
RIGOL Chapter 5 Appendix Terminal Blocks: TB16 NC H 01 L .. . Signals to be Switched 16 01 COM NO 78-Pin Interface ... NC H 16 COM L NO Figure 5-5 MC3416 Schematic Diagram 01 Backplane Switches Channel Switches H L 99 ... Terminal Blocks: TB24 10 Com H 01 L H L H L H Com (4W Sense) L 98 11 78-Pin Interface Signals to be Measured H DMM Source L 20 .. . H Bank Switch H L ...
PAGE 326
RIGOL Chapter 5 Appendix Row 1 H L .. .
PAGE 327
Chapter 5 Appendix RIGOL Appendix F: Command List  ABORt  CALCulate Command Subsystem CALCulate:AVERage:AVERage? CALCulate:AVERage:MAXimum? CALCulate:AVERage:MINimum? CALCulate:AVERage:PTPeak? CALCulate:AVERage:SDEV? CALCulate:AVERage:CLEar CALCulate:AVERage:COUNt? CALCulate:AVERage:MAXimum:TIME? CALCulate:AVERage:MINimum:TIME? CALCulate:COMPare:DATA CALCulate:COMPare:MASK CALCulate:COMPare:STATe CALCulate:COMPare:TYPE CALCulate:LIMit:LOWer CALCulate:LIMit:UPPer CALCulate:LIMit:LOWer:STATe CALCulate:
PAGE 328
RIGOL Chapter 5 Appendix CONFigure:FREQuency CONFigure:PERiod CONFigure:FRESistance CONFigure:RESistance CONFigure:TEMPerature CONFigure:TOTalize CONFigure:VOLTage:AC CONFigure:VOLTage[:DC]  DATA Command Subsystem DATA:LAST? DATA:POINts? DATA:POINts:EVENt:THReshold DATA:REMove?  DIAGnostic Command Subsystem DIAGnostic:DMM:CYCLes? DIAGnostic:DMM:CYCLes:CLEar DIAGnostic:PEEK:SLOT:DATA DIAGnostic:POKE:SLOT:DATA DIAGnostic:RELay:CYCLes? DIAGnostic:RELay:CYCLes:CLEar  DISPlay Command Subsystem DISPlay
PAGE 329
Chapter 5 Appendix RIGOL *SAV *RCL *SRE *STB? *TRG *WAI  INITiate  INPut:IMPedance:AUTO  INSTrument Command Subsystem INSTrument:DMM INSTrument:DMM:INSTalled?  LXI Command Subsystem LXI:IDENtify[:STATE] LXI:RESet LXI:RESTart  MEASure Command Subsystem MEASure:ANYSensor? MEASure:CURR:AC? MEASure:CURR[:DC]? MEASure:DIGital:BYTE? MEASure:DIGital:DWORd? MEASure:DIGital:WORD? MEASure:FREQuency? MEASure:PERiod? MEASure:FRESistance? MEASure:RESistance? MEASure:TEMPerature? MEASure:TOTalize? MEASure
PAGE 330
RIGOL Chapter 5 Appendix MEMory:NAME:MIRRor? MEMory:RECall:MIRRor MEMory:SAVE:DATA MEMory:NAME:DATA? MEMory:RECall:DATA MEMory:STATe:DELete MEMory:STATe:NAME MEMory:STATe:RECall MEMory:STATe:VALid?  MMEMory Command Subsystem MMEMory:EXPort? MMEMory:FORMat:READing:CSEParator MMEMory:FORMat:READing:RLIMit MMEMory:IMPort:CATalog? MMEMory:IMPort:CONFig? MMEMory:LOG[:ENABle]  OUTPut Command Subsystem OUTPut:ALARm:CLEar OUTPut:ALARm:CLEar:ALL OUTPut:ALARm:ENABle? OUTPut:ALARm[]:MODE OUTPut:ALARm[<
PAGE 331
Chapter 5 Appendix RIGOL ROUTe:SCAN ROUTe:SCAN:SIZE? ROUTe:SCAN:ADD ROUTe:SCAN:REMove  SENSe Command Subsystem [SENSe:]ANYSensor:FREQuency:RANGe:LOWer [SENSe:]ANYSensor:FRESistance:APERture [SENSe:]ANYSensor:RESistance:APERture [SENSe:]ANYSensor:FRESistance:NPLC [SENSe:]ANYSensor:RESistance:NPLC [SENSe:]ANYSensor:FRESistance:OCOMpensated [SENSe:]ANYSensor:RESistance:OCOMpensated [SENSe:]ANYSensor:VOLTage:APERture [SENSe:]ANYSensor:VOLTage:NPLC [SENSe:]ANYSensor:CURRent:APERture [SENSe:]ANYSensor:CURRent
PAGE 332
RIGOL Chapter 5 Appendix [SENSe:]PERiod:VOLTage:RANGe [SENSe:]FREQuency:VOLTage:RANGe:AUTO [SENSe:]PERiod:VOLTage:RANGe:AUTO [SENSe:]FRESistance:APERture [SENSe:]RESistance:APERture [SENSe:]FRESistance:NPLC [SENSe:]RESistance:NPLC [SENSe:]FRESistance:OCOMpensated [SENSe:]RESistance:OCOMpensated [SENSe:]FRESistance:RANGe [SENSe:]RESistance:RANGe [SENSe:]FRESistance:RANGe:AUTO [SENSe:]RESistance:RANGe:AUTO [SENSe:]FRESistance:RESolution [SENSe:]RESistance:RESolution [SENSe:]FUNCtion [SENSe:]TEMPerature:APER
PAGE 333
Chapter 5 Appendix RIGOL [SENSe:]VOLTage[:DC]:RANGe [SENSe:]VOLTage:AC:RANGe:AUTO [SENSe:]VOLTage[:DC]:RANGe:AUTO [SENSe:]VOLTage:AC:BANDwidth [SENSe:]VOLTage:AC:RESolution [SENSe:]VOLTage[:DC]:APERture [SENSe:]VOLTage[:DC]:NPLC [SENSe:]VOLTage[:DC]:RESolution [SENSe:]ZERO:AUTO  SOURce Command Subsystem SOURce:DIGital:DATA[:BYTE] SOURce:DIGital:DATA:DWORd SOURce:DIGital:DATA:WORD SOURce:DIGital:STATe? SOURce:VOLTage  STATus Command Subsystem STATus:ALARm:CONDition? STATus:ALARm:ENABle STATus:ALARm[:E
PAGE 334
RIGOL Chapter 5 Appendix SYSTem:COMMunicate:LAN:SMASk SYSTem:COMMunicate:LAN:UPDate SYSTem:COMMunicate:RS232:BAUD SYSTem:COMMunicate:RS232:FLOWcontrol SYSTem:COMMunicate:RS232:PARIty SYSTem:COMMunicate:RS232:PRINt:STATe SYSTem:CPON SYSTem:CTYPe? SYSTem:DATE SYSTem:EDITion? SYSTem:ERRor? SYSTem:IDN:USER:DEFine SYSTem:IDN:DEFault SYSTem:LFRequency? SYSTem:LOCal SYSTem:OPENtimes? SYSTem:PRESet SYSTem:REMote SYSTem:RWLock SYSTem:SECurity[:IMMediate] SYSTem:SERIal? SYSTem:TIME SYSTem:TIME:SCAN? SYSTem:TYPE? SY
PAGE 335
Chapter 5 Appendix RIGOL TRIGger:SOURce TRIGger:TIMer  UNIT Command Subsystem UNIT:ANYSensor UNIT:TEMPerature M300 Programming Guide 5-19
PAGE 336
RIGOL Chapter 5 Appendix Appendix G: Warranty RIGOL warrants that its products mainframe and accessories will be free from defects in materials and workmanship within the warranty period. If a product is proven to be defective within the respective period, RIGOL guarantees the free replacement or repair of products which are approved defective. To get repair service, please contact with your nearest RIGOL sales and service office.