Programming Guide RIGOL Publication Number: PGC01107-1110 Apr. 2009 DM3000 Series Digital Multimeter DM3061/2/3/4 DM3051/2/3/4 © 2008 RIGOL Technologies, Inc. All Rights Reserved.
RIGOL © 2008 RIGOL Technologies, Inc. All Rights Reserved. RIGOL products are protected by patent laws in and outside of the P.R. China. Information in this publication replaces all previous corresponding material. RIGOL Technologies, Inc. reserves the right to modify or change part of or all the specifications and pricing policies at company’s sole decision. NOTE: RIGOL is registered trademark of RIGOL Technologies, Inc. © 2008 RIGOL Technologies, Inc.
RIGOL Summary This manual provides the guidance for remote control programming of DM3000 series digital multimeters. Users can carry on remote control to a multimeter or do the further development according to this manual. We believe that this manual’s readers have read the detailed RIGOL DM3000 series multimeter user guide, and been familiar with the RIGOL DM3000 series multimeter’s operation.
RIGOL Contents Chapter 1 Introduction .......................................................................... 1-1 Programming Introduction ......................................................................... 1-2 Symbol Instruction .................................................................................... 1-3 Parameter Types ....................................................................................... 1-4 Commands Introduction......................................................
RIGOL Chapter 1 Introduction This chapter provides the guidance for user to use a RIGOL DM3000 series digital multimeter for remote control programming correctly, and to achieve a long-distance measuring operation. This chapter includes: Programming Introduction Symbol Instruction Parameter Types Commands Introduction © 2008 RIGOL Technologies, Inc.
RIGOL Programming Introduction This part intrduces the basic programming operations.These programming commands provide the methods for remote control to a multimeter. The Basic operations that you can do with a computer and a multimeter include: Setup a multimeter. Measure. Receive data (equipment working condition or measurement results) from a multimeter. A computer can communicate with a multimeter by sending and receiving messages over an I/O port, such as USB, GPIB port or a RS-232 port.
RIGOL Symbol Instruction 1. Colon : Commands usually begin with a colon (:). A colon (:) is used to separate a command keyword from a lower-level keyword. It shows the operation that a multimeter will implement. 2. Blank Space □ A Blank space is used to separate commands from the program data. If your command does not need any program data, the blank space is not needed. 3. Interrogation ? A query is formed by adding an interrogation (?) to the end of the commands.
RIGOL Parameter Types 1. Consecutive Integer Parameter The parameters can be any integer only in effective range. Note that do not set the parameters for decimal format, or else abnormal. For example, setting screen brightness command ": system: display: bright", the parameter range is from 0 to 255. 2. Consecutive Real Number Parameter In effective value range, the parameters can be random value according to precision (usually the default precision takes six effective digits behind decimal point).
RIGOL Commands Introduction To meet the needs of different users, DM3000 provides RIGOL commands and another two commands that are compatible with the related products. RIGOL DM3000 commands The commands compatible with Agilent The commands compatible with Fluke Send CMDSET command to change the commands type. For the usage please see the follows: Syntax: CMDSET□{RIGOL|AGILENT|FULUKE} CMDSET? Function: The command sets and queries command types.
RIGOL Chapter 2 DM3000 Commands Systerm In RIGOL DM3000 series digital multimeter commands, all the command parameters and the returned values are ASCII characters. All the commands do not distinguish the letter size.
RIGOL Common Commands This commands are used to query equipment state and perform some basic operations. The commands mainly include: *IDN? *RST 2-2 © 2008 RIGOL Technologies, Inc.
RIGOL 1. *IDN? Syntax: *IDN? Function: The command queries equipment ID, and returns 35 characters at least. Return Format: The query returns a character string, and it shows the equipment ID. 2. *RST Syntax: *RST Function: The command resets the equipment state, and makes it the factory default. © 2008 RIGOL Technologies, Inc.
RIGOL Function Commands The commands are used to set the basic measurement functions, and they equal to select the measure function buttons in DM3000 front panel.
RIGOL 1. :function Syntax: :function? Function: The command queries the kinds of measure functions. Return Format: The query returns the current DM3000 measure function’s shortening. The possible returned values are: DCV, ACV, DCI, ACI, RESISTANCE, CAPACITANCE, CONTINUITY, FRESISTANCE, DIODE, FREQUENCY, PERIOD, RATIO. 2. :function:voltage:DC:ratio Syntax: :function:voltage:DC:ratio Function: The command turns on DC voltage ratio measure function.
RIGOL :function:voltage:AC Function: The command turns on AC voltage measure function. Remark: In “:function?” , this function is corresponding to the returned value “ACV”. 5. :function:current:DC Syntax: :function:current:DC Function: The command turns on DC current measure function. Remark: In “:function?” , this function is corresponding to the returned value “DCI”. 6. :function:current:AC Syntax: :function:current:AC Function: The command turns on AC current measure function.
RIGOL Remark: In “:function?” , this function is corresponding to the returned value “RESISTANCE”. 8. :function:fresistance Syntax: :function:fresistance Function: The command turns on fresistance measure function. Remark: In “:function?” , this function is corresponding to the returned value “FRESISTANCE”. 9. :function:frequency Syntax: :function:frequency Function: The command turns on frequency measure function.
RIGOL Syntax: :function:continuity Function: The command turns on continuity measure function. Remark: In “:function?” , this function is corresponding to the returned value “CONTINUITY”. 12. :function:diode Syntax: :function:diode Function: The command turns on diode measure function. Remark: In “:function?” , this function is corresponding to the returned value “DIODE”. 13. :function:capacitance Syntax: :function:capacitance Function: The command turns on capacitance measure function.
RIGOL Measure Commands The commands are used to set measure function further which equal to select measure function buttons in DM3000 front panel.
RIGOL 1. :measure? Syntax: :measure? Function: The command queries whether the current measure have been completed. Explanations: To query whether the current measure have been completed or not. If “complete” returns “ture”, or else “false”. Return Format: The query returns true or false. 2. :measure Syntax: :measure□{AUTO|MANU} Function: The command sets measure mode as auto or manual. Example: To set as manual: :measure□MANU 3.
RIGOL 4. :measure:voltage:DC Syntax: :measure:voltage:DC□{|MIN|MAX|DEF} Function: The command sets the measure range of DC voltage and resolution. Parameters: Name Type Range of values Default discrete {0|1|2|3|4} 2 Explanations: To set the DC voltage range and the resolution at the same time. The measure mode will be changed into manual when setting range Table 2- 1 incdicates the parameters and the resolutions.
RIGOL Function: The command queries DC voltage range. Remark: Please make sure the DC voltage measure must be set at least one time before using this command Return Format: The query returns the current range parameter: 0,1,2,3 or 4(see Table 2- 1). 6. :measure:voltage:DC:impedance Syntax: :measure:voltage:DC:impedance? :measure:voltage:DC:impedance□{10M|10G} Function: The command queries and sets DC voltage impedance. Explanations:: :measure:voltage:DC:impedance? returns 10M or 10G(>10G).
RIGOL Explanations: :measure:voltage:DC:digit? queries the digit of the DC voltage. :measure:voltage:DC:digit□{INC|DEC|5|6|7} set the digit of DC voltage. Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC invalid. The table 2-2 indicates the meanings of the digit.
RIGOL 9. :measure:voltage:DC:ratio:digit Syntax: :measure:voltage:DC:ratio:digit? :measure:voltage:DC:ratio:digit□{INC|DEC|5|6|7} Function: The command queryies and sets the digit of the ratio of DC voltages in two circuits. Explanations: :measure:voltage:DC:ratio:digit? queries the digit of the ratio of the DC voltages in two circuits. :measure:voltage:DC:ratio:digit□ sets the digit of the ratio of the DC voltages in two circuits. The Table 2- 2 indicates the parameters and their meanings.
RIGOL 11. :measure:voltage:AC Syntax: :measure:voltage:AC□{|MIN|MAX|DEF} Function: The command sets the measure range of AC voltage. Parameters: Name Type Range of Value default discrete {0|1|2|3|4} 2 Explanations: The Table 2- 3 lists the parameters and the ranges. Table 2- 3 The range of AC voltage Parameter Range 0 200mV 1 2.0V 2 20.0V 3 200.0V 4 750.0V MIN 200mV MAX 750V DEF 20.0V Example: To set the AC voltage range as 750.
RIGOL The query returns the range parameter: 0、1、2、3 or 4(see Table 2- 3). 13. :measure:voltage:AC:filter Syntax: :measure:voltage:AC:filter? :measure:voltage:AC:filter□{SLOW|MID|FAST} Function: The command queries and sets the speed of AC voltage filter. Explanations: :measure:voltage:AC:filter? queries the filter speed. :measure:voltage:AC:filter□{SLOW|MID|FAST} sets the filter speed as “slow”, “middle”, or “fast”, and the default is “fast”.
RIGOL Return Format: :measure:voltage:AC:digit? returns the current digit of the AC voltage: 5、6 or 7. Example: To set the digit as 7: :measure:voltage:AC:digit□7 15. :measure:voltage:AC:freq? Syntax: :measure:voltage:AC:freq? Function: The command queries AC voltage frequency. Remarks: Before sending the command, please turn on AC voltage measure function. Return Format: The query returns the current frequency in the form of 5.000000e+01, and unit is Hz. (for example) 16.
RIGOL Remarks: When the frequency display is on in measuring AC voltage, the command is invalid. 18. :measure:voltage:AC:freq:state? Syntax: :measure:voltage:AC:freq:state? Function: The command queries whether the frequncy displays on the secondary screen in measuring AC voltage. Return Format: The query returns the current state: display or hide. 19. :measure:current:DC? Syntax: :measure:current:DC? Function: The command queries DC current.
RIGOL Explanations: To set the measurement range of DC current and the resolution at the same time. The measure mode will be changed into manual when setting range. The table 2-4 indicates the current ranges and the resolutions. Table 2- 4 The DC current ranges and their resolutions Parameter Current Resolution 0 2mA 1 nA 1 20mA 10nA 2 200mA 100nA 3 1A 1μA 4 10A 10μA MIN 2mA 1 nA MAX 10A 10μA DEF 200mA 100nA Example: To set the DC current range as 10.
RIGOL The command queries and sets the digit of DC current. Explanations: :measure:current:DC:digit? queries the digit of the DC current. :measure:current:DC:digit□{INC|DEC|5|6|7} sets the digit of the DC current. The Table 2- 2 indicates the meanings of the digit. Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC invalid. Return Format: :measure:current:DC:digit? returns the current digit : 5, 6 or 7. Example: To set the digit as 6: :measure:current:DC:digit□6 23.
RIGOL discrete {0|1|2|3} 2 Explanations: :measure:current:AC? queries the AC current. Before sending the command, please turn on AC current measure function. :measure:current:AC□ sets the AC current range. At the same time the manual mode is set. The Table 2- 5 indicates the parameters and their meanings. Table 2- 5 The AC current parameters and their meanings Parameter Range 0 20mA 1 200mA 2 2A 3 10A MIN 20mA MAX 10A DEF 200mA Example: To set the AC current range as 10.
RIGOL 26. :measure:current:AC:digit Syntax: :measure:current:AC:digit? :measure:current:AC:digit□{INC|DEC|5|6|7} Function: The command queries and sets the digit of AC current. Explanations: :measure:current:AC:digit? queries the digit of the AC current. Before sending the command, please turn on AC current measure function. :measure:current:AC:digit□{INC|DEC|5|6|7} sets the digit of the AC current. The Table 2- 2 indicates the parameters and their meanings.
RIGOL :measure:current:AC:freq:display Function: The command displays AC current frequency on the secondary screen. Remark: Please turn on AC current measure function before sending command. 29. :measure:current:AC:freq:hide Syntax: :measure:current:AC:freq:hide Function: The command hides AC current frequency on the secondary screen. Remark: Please turn on AC current measure function before sending command. 30.
RIGOL Function: The commad queries two circuits resistance. Return Format: The query returns the current resistance in the form of 8.366031e-05, and unit is Ω. (for example) 32. :measure:resistance Syntax: :measure:resistance□{|MIN|MAX|DEF} Function: The command sets the measure range of two circuits resistance. Parameters : Name Type Range Default discrete {0|1|2|3|4|5|6} 3 Explanations: The table 2-6 indicates the parameters and the range.
RIGOL 33. :measure:resistance:range? Syntax: :measure:resistance:range? Function: The command queries the measure range of two circuits resistance. Return Format: The query returns the current range parameter: 0, 1, 2, 3, 4, 5 or 6.(see Table 2- 6) 34. :measure:resistance:digit Syntax: :measure:resistance:digit? :measure:resistance:digit□{INC|DEC|5|6|7} Function: The command queries and sets the digit of two circuits resistance.
RIGOL Function: The command queries four circuits resistance. Return Format: The query returns the current four circuits resistsnce in the form of 8.822946e-05, and unit is Ω. (for eample) 36. :measure:fresistance Syntax: :measure:fresistance□{|MIN|MAX|DEF} Function: The command sets the measure range of four circuits resistance. Parameters: Name Type Range Default discrete {0|1|2|3|4|5|6 } 3 Explanation: The Table 2- 6 indicates the parameters and their meanings.
RIGOL Table 2- 6) 38. :measure:fresistance:digit Syntax: :measure:fresistance:digit? :measure:fresistance:digit□{INC|DEC|5|6|7} Function: The command queries and sets the digit of four circuits resistance. Explanations: :measure:fresistance:digit? queries the digit of the four circuits resistance. :measure:fresistance:digit□{INC|DEC|5|6|7} sets the digit of the four circuits resistance. Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC invalid.
RIGOL 40. :measure:frequency Syntax: :measure:frequency□{|MIN|MAX|DEF} Function: The command sets input voltage range in measuring frequency. Parameters: Name Type Range Default discrete {0|1|2|3|4} 2 Explanations: The frequency range is 3Hz~300kHz.The Table 2- 3 indicates the parameters and the ranges. Example: To set the voltage range as 20V: :measure:frequency□DEF 41.
RIGOL :measure:frequency:digit? :measure:frequency:digit□{INC|DEC|5|6|7} Function: The command queries and sets the digit of frequency. Explanations: :measure:frequency:digit? queries the digit of the frequency. Before sending the command, please turn on frequency measure function. :measure:frequency:digit□{INC|DEC|5|6|7} sets the digit of the frequency. The Table 2- 2 indicates the meanings of the digit. Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC invalid.
RIGOL Function: The command sets input voltage range in measuring period. Parameters: Name Type Range Default Discrete {0|1|2|3|4} 2 Explanations: The period range is 3.3us~0.33s. The Table 2- 3 indicates the parameters and their ranges. Example: To set the input voltage range as 20V: :measure:period□DEF or :measure:period□2 45. :measure:period:range? Syntax: :measure:period:range? Function: The command queries AC voltage range in measuring period.
RIGOL Explanations: :measure:period:digit? queries the digit of the period. Before sending the command, please turn on period measure function. :measure:period:digit□{INC|DEC|5|6|7} sets the digit of the period. The Table 2- 2 indicates the parameters and the ranges. Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC invalid. Return Format: :measure:period:digit? returns the current digit: 5、6 or 7. Example: To set the digit as 6: :measure:period:digit□6 47.
RIGOL Remarks: The resistance range is a consecutive Integer among 1Ω~2000Ω. The default resistance is 10Ω. MAX denotes the maximum is 2000Ω. MIN denotes the minimum is 1Ω. DEF denotes the default is 10Ω. Example: To set the limit resistance as 1KΩ: :measure:continuity□1000 49. :measure:diode? Syntax: :measure:diode? Function: The command queries diode voltage at both ends. Remarks: In measuring diode, the beep condition is 0.1V≤Vmeasured≤2.4 V.
RIGOL Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC invalid. Return Format: :measure:diode:digit? returns the current digit: 5、6 or 7. Example: To set the digit as 6: :measure:diode:digit□6 51. :measure:capacitance? Syntax: :measure:capacitance? Function: The command queries capacitance. Return Format: The query returns the current capacitance in the form of 8.889030e-05, and unit is F. (for examole) 52.
RIGOL Table 2- 7 The parameters and the ranges Parameter Range 0 2nF 1 20nF 2 200nF 3 2uF 4 20uF 5 200uF MIN 2nF MAX 200uF DEF 200nF Example: To set the capacitance range as 2uF: :measure: capacitance□3 53. :measure:capacitance:range? Syntax: :measure:capacitance:range? Function: The command queries the measure range of capacitance. Return Format: The query returns the current range parameter: 0、1、2、3、4 or 5.(see Table 2- 7) 54.
RIGOL :measure:capacitance:digit? queries the digit of the capacitance. :measure:capacitance:digit□{INC|DEC|5|6|7} sets the digit of the capacitance. The Table 2- 2 indicates the parameters and their meanings. Return Format: :measure:capacitance:digit? returns the current digit: 5、6 or 7. © 2008 RIGOL Technologies, Inc.
RIGOL Precision Commands The commands are used to set the measure precision for a multimeter. The commands mainly includes: 2-36 :resolution:voltage:DC :resolution:voltage:DC:ratio :resolution:voltage:AC :resolution:current:DC :resolution:current:AC :resolution:resistance :resolution:fresistance :resolution:capacitance © 2008 RIGOL Technologies, Inc.
RIGOL 1. :resolution:voltage:DC Syntax: :resolution:voltage:DC? :resolution:voltage:DC□{|MIN|MAX|DEF} Function: The command queries and sets the measure precision of DC voltage. Parameters: Name Type Range Default discrete {0|1|2} 2 Explanations: :resolution:voltage:DC? queries the measure precision of the DC voltage. Before sending the command, please turn on DC voltage measure function. :resolution:voltage:DC□{|MIN|MAX|DEF} sets the measure precision of the DC voltage.
RIGOL Syntax: :resolution:voltage:DC:ratio? :resolution:voltage:DC:ratio□{|MIN|MAX|DEF} Function: The command queries and sets the measure precision of DC voltage ratio. Parameters: Name Type Range Default Discrete {0|1|2} 2 Explanations: :resolution:voltage:DC:ratio? queries the measure precision of the DC voltage ratio. Before sending the command, please turn on DC voltage ratio measure function.
RIGOL Explanations: :resolution:voltage: AC? queries the measure precision of the AC voltage. Before sending the command, please turn on AC voltage measure function. :resolution:voltage: AC□{|MIN|MAX|DEF} sets the measure precision of the AC voltage. The Table 2- 9 indicates the parameters and their meanings.
RIGOL sending the command, please turn on DC current measure function. :resolution:current:DC□{|MIN|MAX|DEF} sets the measurement precision of the DC current. The Table 2- 8 indicates the parameters and their meanings. Return Format: :resolution:current:DC? returns the current parameter: 0、1 or 2.(see Table 2- 8) Example: To set the measure precision of the DC current as 5 ½ : :resolution:current:DC□1 5.
RIGOL 6. :resolution:resistance Syntax: :resolution:resistance? :resolution:resistance□{|MIN|MAX|DEF} Function: The command queries and sets the measure precision of two circuits resistance. Parameters: Name Type Range Default discrete {0|1|2} 2 Explanations: :resolution:resistance? queries the measure precision of the two circuits resistance. Before sending the command, please turn on two circuit resistance measure function.
RIGOL Parameters: Name Type Range Default < range > discrete {0|1|2} 2 Explanations: :resolution:fresistance? queries the measure precision of the four circuit resistance. Before sending the command, please turn on four circuits resistance measure function. :resolution:fresistance□{|MIN|MAX|DEF} sets the measure precision of the four circuit resistance. The Table 2- 8 indicates the parameters and their meanings. Return Format: :resolution:fresistance? returns the current parameter: 0、1 or 2.
RIGOL Return Format: :resolution:capacitance? returns the current parameter: 0、1 or 2.(see Table 2- 8) Example: To set the capacitance measure precision as 5 ½ : :resolution: capacitance□1 © 2008 RIGOL Technologies, Inc.
RIGOL System Commands The commands are used to set the system parameters.
RIGOL 1. :system:beeper Syntax: :system:beeper Function: The command tests the beeper. Remarks: The beeper is beeping only one time When testing. Before sending the command, please do open the beeper. 2. :system:beeper:state Syntax: :system:beeper:state? :system:beeper:state□ Function: The command queries and sets the beeper state. Parameters: Name Type Range Default Boolean {ON|OFF} ON Explanations: :system:beeper:state? queries whether the beeper is on.
RIGOL 3. :system:configure:poweron Syntax: :system:configure:poweron□ Function: The command sets system parameters on power. Parameters: Name Type Range Default Discrete {LAST|DEFAULT} DEFAULT Explanations: The command is used to set the system parameters as the last setting or the system default when powering on. “LAST” means to read the last setting, and “DEFAULT” means the system default. 4.
RIGOL Name Type Range Default discrete {CHINESE|ENGLISH} CHINESE Explanations: :system:language? queries the system language category. :system:language□ sets the system language category. “CHINESE” means the system language is chinese, “ENGLISH” means english. Return Format: :system:language? returns the current system language: CHINESE or ENGLISH. 6.
RIGOL The command queries and sets system date. Parameters: Name Type Range Default ASCII string {xxxx-xx-xx} --- Explanations: :system:clock:date? queries the system date. :system:clock:date□ sets the system date. The format is {year-month-day}. Return Format: :system:clock:date? returns the current system date in the form of xxxx-xx-xx. 8. :system:clock:time Syntax: :system:clock:time? :system:clock:time□ Function: The command queries and sets system time.
RIGOL :system:format:decimal□ Function: The command queries and sets radix point format used in system. Parameters: Name Type Range Default Discrete {COMMA | DOT} DOT Explanations: :system:format:decimal? queries the radix point format. :system:format:decimal□ sets the radix point format. “COMMA” means to use “,” as a radix point, and at the same time the former “,” is changed into “.”. “DOT” means to use “·” as a radix point, meanwhile the former “.” is changed into “,”.
RIGOL Return Format: :system:format:separate? returns the current data seperator format:ON、NONE or SPACE。 11. :system:display:bright Syntax: :system:display:bright? :system:display:bright□ Function: The command queries and sets display brightness. Parameters: Name Type Range Default Consecutive Integer 0~255 168 Explanations: :system:display:bright? queries the display brightness. :system:display:bright□ sets the display brightness.
RIGOL Parameters: Name Type Range Default Consecutive Integer 0~255 152 Explanations: :system:display:contrast? queries the display contrast. :system:display:contrast□ sets the display contrast. The contrast is an integer among 0~255. 0 is the minimum, and 255 is maximum. Return Format: :system:display:contrast? returns the current display contrast, and the range is 0~255. 13. :system:display:invert Syntax: :system:display:invert Function: The command inverts the display color.
RIGOL 15. :system:macaddr Syntax: :system: macaddr? Function: The command queries MAC address. Explanation: To query the MAC address for network communication setting. Return Format: The query returns the current MAC address in the form of XX-XX-XX-XX-XX-XX. For example, 00-01-02-03-04-05. 16. :system:lanserial Syntax: :system:lanserial? Function: The command queries the module state of interface. Explanation: To query the interface module state for the instrument.
RIGOL To query the number of start-up. Return Format: The query returns the current number of start-up. © 2008 RIGOL Technologies, Inc.
RIGOL Utility Commands The commands are used to set communication control and self-inspection. Before controlling communication, please make sure that communication interface has been connected stably, otherwise it possiblely to be abnormal or wrong.
RIGOL 1. :utility:interface:LAN:dhcp Syntax: :utility:interface:LAN:dhcp? :utility:interface:LAN:dhcp□ Function: The command queries and sets the state of DHCP for LAN connection. Parameters: Name Type Range Default Boolean {ON|OFF} ON Explanations: :utility:interface:LAN:dhcp? queries whether the DHCP is on. :utility:interface:LAN:dhcp□ sets the DHCP state. “ON” denotes DHCP is on, and “OFF” denotes DHCP is off.
RIGOL Return Format: :utility:interface:LAN:host? returns the current HOST name. 3. :utility:interface:LAN:domain Syntax: :utility:interface:LAN:domain? :utility:interface:LAN:domain□ Function: The command queries and sets domain name for LAN connection. Parameters: Name Type Range Default character string self-definition RIGOL Explanations: :utility:interface:LAN:domain? queries the equipment domain name. :utility:interface:LAN:domain□ sets the equipment domain name.
RIGOL :utility:interface:LAN:ip? queries the IP address. :utility:interface:LAN:ip□ sets the IP address. The parameter is the user-defined character string. Return Format: :utility:interface:LAN:ip? returns the current IP address. 5. :utility:interface:LAN:mask Syntax: :utility:interface:LAN:mask? :utility:interface:LAN:mask□ Function: The command queries and sets IP mask for LAN connection. Parameters: Name Type Range Default character string self-definition 255.255.255.
RIGOL Parameters: Name Type Range Default character string self-definition 172.16.3.1 Explanations: :utility:interface:LAN:gateway? queries the gateway. :utility:interface:LAN:gateway□ sets the gateway. The parameter is the user-defined character string. Return Format: :utility:interface:LAN:gateway? returns the current gateway. 7.
RIGOL Function: The command queries and sets GPIB address. Parameters: Name Type Range Default Consecutive Integer 1~30 7 Explanations: :utility:interface:GPIB:address? queries the GPIB address. :utility:interface:GPIB:address□ sets the GPIB address. Return Format: :utility:interface:GPIB:address? returns the current GPIB address. 9.
RIGOL :utility:interface:RS232:parity? :utility:interface:RS232:parity□ Function: The command queries and sets communication parity bit of serial interface(RS232). Parameters: Name Type Range Default discrete {none8bits|odd7bits|even7bits} none8bits Explanations: :utility:interface:RS232:parity? queries the RS232 parity bit. :utility:interface:RS232:parity□ sets the RS232 parity bit. Return Format: :utility:interface:RS232:parity? returns the current parity bit.
RIGOL Trigger Commands The commands are used to set the tigger system parameters. The commands mainly include: :trigger:source :trigger:auto:interval :trigger:auto:hold :trigger:single:triggered :trigger:ext :trigger:vmcomplete:polar :trigger:vmcomplete:pulsewidth © 2008 RIGOL Technologies, Inc.
RIGOL 1. :trigger:source Syntax: :trigger:source? :trigger:source□ Function: The command queries and sets trigger mode in measuring. Parameters: Name Type Range Default discrete {AUTO|SINGLE|EXT} AUTO Return Format: :trigger:source? returns the current trigger mode: auto、single or ext, and they respectively denotes “automatic trigger”,“single trigger”, and “exterior trigger”. 2.
RIGOL 30~2000ms, and the default is 30ms; the resolution is 4½ , 200~2000ms, and the default is 200ms; the resolution is 5½ , 400~2000ms, and the default is 400ms. 3. :trigger:auto:hold Syntax: :trigger:auto:hold? :trigger:auto:hold□ Function: The command queries and sets auto trigger delay state. Parameters: Name Type Range Default Boolean {ON|OFF} OFF Return Format: :trigger:auto:hold? returns the current auto trigger delay state. “ON” means the delay is on, and “OFF”means off.
RIGOL Table 2- 10 The sensitivity parameters and their meanings Parameter sensitivity 0 0.01% 1 0.1% 2 1% 3 10% Return Format: :trigger:auto:hold:sensitivity? returns the current sensitivity parameter: 0,1,2 or 3.(see Table 2- 10) 5. :trigger:single Syntax: :trigger:single? :trigger:single□ Function: The command queries and sets sampling times in single trigger.
RIGOL 7. :trigger:ext Syntax: :trigger:ext? :trigger:ext□ Function: The command queries and sets exterior trigger mode. Parameters: Name Type Range Default discrete {RISE|FALL|HIGH|LOW} RISE Explanations: :trigger:ext? queries the exterior trigger mode, and the default is the rise edge trigger. :trigger:ext□ sets the exterior trigger mode. The parameters include {RISE|FALL|HIGH|LOW}, and respectively means “rise edge trigger.”,“fall edge trigger.
RIGOL Return Format: :trigger:vmcomplete:polar? returns the current VMC output polar. 9. :trigger:vmcomplete:pulsewidth Syntax: :trigger:vmcomplete:pulsewidth? :trigger:vmcomplete:pulsewidth□ Function: The command queries and sets VMC output pulsewidth. Parameters: Name Type consecutive integer Range 4½ 5½ 6½ 1~30ms 1~200ms 1~400ms Default 30ms 100ms 100ms Explanations: :trigger:vmcomplete:pulsewidth? queries the VMC output pulsewidth.
RIGOL Calculate Commands The commands are used to set the calculate system parameters for instrument. The commands mainly include: :calculate:function :calculate:statistic:min :calculate:statistic:max :calculate:statistic:average :calculate:statistic:count :calculate:NULL:offset :calculate:DB :calculate:DB:reference :calculate:DBM :calculate:limit:lower :calculate:limit:upper © 2008 RIGOL Technologies, Inc.
RIGOL 1. :calculate:function Syntax: :calculate:function? :calculate:function□ Function: The command queries and sets math calculation function. Parameters: Name Type Range Dedault discrete {NONE|NULL|DB|DBM|MIN|MAX |AVERAGE|TOTAL|LIMIT} NONE Explanations: :calculate:function? queries the math calculation function. The default is NONE (turning off math calculation). :calculate:function□ sets the math calculation function.
RIGOL Function: The command queries statistic minimum. Remark: Only when MIN calculation is available, the command should be available. Return Format: The query returns the current statistic minimum. 3. :calculate:statistic:max Syntax: :calculate:statistic:max? Function: The command queries statistic maximum. Remark: When MAX calculation is available, the command is just available. Return Format: The query returns the current statistic maximum. 4.
RIGOL 5. :calculate:statistic:count Syntax: :calculate:statistic:count? Function: The command queries measure number in calculation. Remark: The command is available to the current measure operation. Return Format: The query returns the current measure number. 6. :calculate:NULL:offset Syntax: :calculate:NULL:offset? :calculate:NULL:offset□ Function: The command queries and sets NULL calculation offset.
RIGOL Table 2- 12 The range of NULL calculation offset Measurement Range DEF Unit DC voltage ± 1200 0 V AC voltage ± 900 0 V DC current ± 12 0 A AC current ± 12 0 A resistance ± 1.2e+08 0 Ω capacitance ± 2.4e-04 0 F frequency ± 3.6e+05 0 HZ Return Format: :calculate:NULL:offset? returns the current NULL calculation offset. 7. :calculate:DB Syntax: :calculate:DB? Function: The command queries dB value. Return Format: The query returns the current dB value. 8.
RIGOL :calculate:DB:reference? queries the dB reference value. :calculate:DB:reference□ sets the dB reference value. When setting dB reference value, the value is an integer, and the range is between +120dB and -120dB. MIN denotes -120dB, MAX denotes +120dB, and DEF denotes 0. Return Format: :calculate:DB:reference? returns the current dB reference value. 9. :calculate:DBM Syntax: :calculate:DBM? Function: The command queries dBm value. Return Format: The query returns the current dBm value. 10.
RIGOL Return Format: :calculate:DBM:reference? returns the current dBm reference resistance. 11. :calculate:limit Syntax: :calculate:limit? Function: The command queries limit calculation. Remark: When the measure value is between min and max, the command returns pass, or else fail. Return Format: The query returns whether the limit calculation have passed: pass or fail. 12.
RIGOL Table 2- 13 Upper and lower limit Measurement Range DEF Unit DC voltage -1200 ~ +1200 0 V AC voltage 0 ~ 900 0 V DC current -12 ~ +12 0 A AC current 0 ~ 12 0 A Resistance 0 ~ 1.2e+08 0 Ω Capacitance 0 ~ 2.4e-04 0 F Frequency 3 ~ 3.0e+05 0 HZ Period 3.0e-06 ~ 3.0e-01 0 s Ratio -1.0e+09 ~ 1.0e+09 0 dB -120 ~ +120 0 Return Format: :calculate:limit:lower? returns the current lower value. 13.
RIGOL Return Format: :calculate:limit:upper? returns the current upper value. © 2008 RIGOL Technologies, Inc.
RIGOL Datalog Commands The commands are used to set the datalog system parameters for instrument.
RIGOL 1. :datalog Syntax: :datalog? Function: The command queries whether the datalog function is on. Explanation: Befroe the datalog function is on, please configure the datalog settings. Return Format: The return value “Run” and “Stop” respectively denote that the datalog system runs or stops. 2. :datalog:configure:function Syntax: :datalog:configure:function? :datalog:configure:function□, Function: The command queries and sets the datalog function.
RIGOL 3. :datalog:configure:startmode Syntax: :datalog:configure:startmode? Function: The command queries the startmode of the scan function. Return Format: :datalog:configure:startmode? returns the startmode name: Auto or Extern. The delay startmode is considered as Auto, and by quering the delay time, you can be sure whether the delay startmode is on. 4. :datalog:configure:startmode:auto Syntax: :datalog:configure:startmode:auto Function: The command sets the datalog startmode as auto.
RIGOL 6. :datalog:configure:startmode:delaytime Syntax: :datalog:configure:startmode:delaytime? :datalog:configure:startmode:delaytime□ Function: The command queries and sets the delay time of auto startmode. Explanations: :datalog:configure:startmode:delaytime? queries the delay time of auto startmode. :datalog:configure:startmode:delaytime□ sets the delay time of auto startmode. The value is the delay time you will set, the default unit is s. The range of the value is 0 ~ 3600s.
RIGOL Function: The command queries and sets the stop time of datalog function. Explanations: :datalog:configure:stopmode:time? queries the stop time of datalog function. :datalog:configure:stopmode:time□ sets the time every datalog funtion lasts for. At the same time the stopmode sets as time. The value is the time the every datalog function lasts for. Return Format: :datalog:configure:stopmode:time? returns the time every datalog function lasts for. 9.
RIGOL The command queries and sets the sample rate of datalog function. Explanations: :datalog:configure:rate? queries the sample rate of datalog function. :datalog:configure:rate□ sets the sample rate of datalog function, the range is 1~13, respectively showing the sample rate is 1/10min, 1/5min, 1/min, 1/10s, 1/s, 10/s, 50/s, 100/s, 833/s, 1K/s, 5K/s, 10K/s, 50K/s. Return Format: :datalog:configure:rate?returns the range of the current sample rate : 1~13. 11.
RIGOL Explanations: :datalog:fetchdata□ fetches the data the datalog system acquire. The instrument can storage data for 2097152, and the command can acquire a data packet every time, including 512 sampling data and occuping the storage space for 2K. The value is the serial number of the data packet, the range is 1 ~ 4096. Every datalog starts storaging from the first packet.
RIGOL Scan Commands The commands are used to set the scan system parameters for instrument. The commands mainly include: :scan:create :scan:addtask :scan:deletetask :scan:intervaltime :scan:run :scan:run:cycle :scan:stop :scan:list:task :scan:list:project :scan:current:cycle :scan:current:projname :scan:fetchdata :scan:saveproj :scan:loadproj :scan:deleteproj :scan:cardID NOTE:DM3000 series Digital Multimeter that the version is or later than 03.03.00.03 .02. 00.
RIGOL 1. :scan:create Syntax: :scan:create□ Function: The command creates the project. Explanation: :scan:create□ creates the project. The value is the project name. You may not set the project name, but you must use the command for the initialization. Or else the system can not runs the latter operation, and returns the wrong sign. 2. :scan:addtask Syntax: :scan:addtask□,,…... , Function: The command adds the task for the scan project.
RIGOL *1Note: the scan channel includes 1~16, the channel 1~12 is connected for measuring DCV, ACV, DCI, ACI, 2WR, FREQ, PERI, CAP, DIODE. The channel 13~16 is connected for measuring DCV, ACV, DCI, ACI and 2WR.
RIGOL the interval time you will set, and the unit is s. When the project cycle number is greater than 1, the command sets the interval time between the close project cycles. 5. :scan:run Syntax: :scan:run Function: The command circulates the current project one time. 6. :scan:run:cycle Syntax: :scan:run:cycle□ Function: The command sets the project cycle number, and runs the current project. Explanations: :scan:run:cycle□ sets the project cycle number, and runs the current project.
RIGOL Explanations: :scan:list:task□ lists the task table of the setting project. The value is the project number. If don’t set the project number, the command lists the task table of the current project. Return Format: :scan:list:task□ returns the task table of the setting project in the form of : :channel, range, precision, sampling number and function. 9.
RIGOL 12. :scan:fetchdata Syntax: :scan:fetchdata□ Function: The command fetches the data. Explanation: :scan:fetchdata□ has the same usage with :datalog:fetchdata□. 13. :scan:saveproj Syntax: :scan:saveproj□ Function: The command saves the setting project. Explanation: :scan:saveproj□ saves the setting project in DM3000 local. The value is the number of the file location. DM3000 can save up to 10 projects, if exceeded, and return the wrong sign. 14.
RIGOL Function: The command deletes the set project. Explanation: :scan:deleteproj□ deletes the set project, the value is the number of the file location. 16. :scan:cardID Syntax: :scan:cardID? Function: The command queries the hardware version of scan card. Return Format: :scan:cardID? returns the hardware version of scan card. After the scan operation runs at least a time, the command just can query. If wrong, return 0. © 2008 RIGOL Technologies, Inc.
RIGOL Chapter 3 DM3000 Compatible Commands The DM3000 series digital multimeter not only supports RIGOL commands system, but also have been compatible with Agilent and Fluke multimeter’s some remote control commands. If users have been familiar with Agilent and Fluke’s commands, you can operate RIGOL DM3000 conveniently. This chapter lists Agilent and Fluke’s some commands that RIGOL DM3000 series digital multimeter supports, and it makes easy to find commands for users.
RIGOL Agilent Commands The following table lists the commands of Agilent supported byRIGOL DM3000 series digital multimeter. Before using the commands, to send CMDSET command, that is: CMDSET□AGILENT. For the details, please refer to the “Commands Introduction” in page 1-5.
RIGOL :RESistance [:VOLTage] :AC [:DC] CAPacitance :NULL [:STATe] [:STATe]? :VALue :VALue? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? CURRent :AC :BANDwidth :BANDwidth? :NULL [:STATe] [:STATe]? :VALue :VALue? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? [:DC] :APERture :APERture? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALue? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? © 2008 RIGOL Technologies, Inc.
RIGOL [:UPPer] [:UPPer]? :RESolution :RESolution? DATA :COPY :DATA? :DELete :LAST? :POINts? :REMove? FETCh ? :CURRent :AC :PTPeak? [:DC] :PEAK :MAXimum? :MINmum? :PTPeak? :VOLTage :AC :PTPeak? [:DC] :PEAK :MAXimum? :MINmum? :PTPeak? FREQuency :APERture :APERture? :NULL [:STATe] [:STATe]? :VALue :VALue? :RANGe :LOWer :LOWer? :VOLTage :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? FRESistance :APERture :APERture? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue 3-4 © 2008 RIGOL Technologies, I
RIGOL :VALue? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution :RESolution? FUNCtion [:ON] [:ON]? *IDN? MEASure :CAPacitance? :CONTinuity? :CURRent :AC? [:DC]? :DIODe? :FREQuency? :FRESistance? :PERiod? :RESistance? [:VOLTage] :AC? [:DC]? MEMory :NSTates? :STATe :CATalog? :DELete :DELete :ALL :NAME :NAME? :RECall :AUTO :RECall :AUTO? :SELect :SELect? :VALid? OUTPut :TRIGger PERiod :APERture :SLOPe :APERture? :NULL [:STATe] [:STATe]? :VALue © 2008 RIGOL Technologies, Inc.
RIGOL :VALue? :RANGe :LOWer :LOWer? :VOLTage :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? *RCL *RST RESistance :APERture :APERture? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALue? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution :RESolution? *SAV SAMPle :SOURce :SOURce? :TIMer :TIMer? [SENSe:] CAPacitance :NULL [:STATe] [:STATe]? :VALue :VALue? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? CURRent :AC :BANDwidth :BANDwidth? 3-6 © 2008 RIGOL Technologies, Inc.
RIGOL :NULL [:STATe] [:STATe]? :VALue :VALuE? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? [:DC] :APERture :APERture? :APERture :ENABled? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALuE? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution :RESolution? :ZERO :AUTO :AUTO? FREQuency :APERture :APERture? :NULL [:STATe] [:STATe]? :VALue :VALue? :RANGe :LOWer :LOWer? :VOLTage :RANGe © 2008 RIGOL Technologies, Inc.
RIGOL :AUTO? [:UPPer] [:UPPer]? FRESistance :APERture :APERture? :APERture :ENABled? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALue? :OCOMpensated :OCOMpensated? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution FUNCtion :RESolution? [:ON] PERiod [:ON]? :APERture :APERture? :NULL [:STATe] [:STATe]? :VALue :VALue? :RANGe :LOWer :LOWer? :VOLTage :RANGe :AUTO :AUTO? [:UPPer] RESistance [:UPPer]? :APERture :APERture? :APERture :ENABled? :NPLC 3-8 © 2008 RIGOL Technologies, Inc.
RIGOL :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALue? :OCOMpensated :OCOMpensated? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution :RESolution? :ZERO VOLTage :AUTO :AUTO? :AC :BANDwidth :BANDwidth? :NULL [:STATe] [:STATe]? :VALue :VALue? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? [:DC] :APERture :APERture? :APERture :ENABled? :IMPedance :AUTO :AUTO? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALue? © 2008 RIGOL Technologies, Inc.
RIGOL :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution :RESolution? SYStem :BEEPer :ZERO :AUTO :AUTO? :COMMunicate :STATe :STATe? :ENABle :ENABle? :GPIB [:SELF] :ADDRess :ADDRess? :LAN :BSTatus? :CONTrol? :DDNS :DDNS? :DHCP :DHCP? :DNS :DNS? :DOMain :DOMain? :GATEway :GATEway? :HOSTname :HOSTname? :IPADdress :IPADdress? :MAC? :LANGuage :SMASk :LANGuage? :SMASk? :VERSion? *TRG TRIGger 3-10 :COUNt © 2008 RIGOL Technologies, Inc.
RIGOL :COUNt? :DELay :DELay? :DELay :SLOPe :AUTO :SLOPe? :AUTO? :SOURce :SOURce? VOLTage :AC :BANDwidth :BANDwidth? :NULL [:STATe] [:STATe]? :VALue :VALue? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:DC] [:UPPer] [:UPPer]? :APERture :APERture? :IMPedance :AUTO :AUTO? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALue? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:UPPer] © 2008 RIGOL Technologies, Inc.
RIGOL [:UPPer]? :RESolution :RESolution? 3-12 © 2008 RIGOL Technologies, Inc.
RIGOL Fluke Commands The following table lists the Fluke commands which supported by RIGOL DM3000 series digital multimeter. Before using the commands, to send CMDSET command, that is: CMDSET□FLUKE. For the detailsl please refer to the “Commands Introduction” in page 1-5. Fluke Commands AAC ADC AUTO AUTO? COMP COMP? COMPCLR COMPHI COMPLO CONT DB DBCLR DBREF? DBREF DIODE FIXED FREQ FREQ2 FUNC1? FUNC2? HOLD HOLDCLR HOLDTHRESH? HOLDTHRESH MAX MAXSET MEAS? MEAS1? © 2008 RIGOL Technologies, Inc.
RIGOL MEAS2? MIN MINSET MMCLR MOD? OHMS RANGE RANGE1? RATE RATE? REL RELCLR RELSET? RELSET VAC VAL? VAL1? VAL2? VDC 3-14 © 2008 RIGOL Technologies, Inc.
RIGOL Chapter 4 DM3000 Commands Examples This chapter lists some application examples of RIGOL DM3000 commands. Users can refer and deepen the understanding to the commands. In order to explain easily, the serial number before every command is used to mark current command but not be the content of command. The contents between “ / * ” and “ * / ” after every command are explanations which can help users to understand. Before operating, please connect the related test equipment and the tested device.
RIGOL Example 1 : Reading Statistic Purpose: To achieve the maximum statistic. In maximum statistic calculation, the first reading is regarded as the maximum. If continuing measuring, the multimeter is updating the readings. Until catching the maximum, the multimeter is beeping(the beeper must be on).
RIGOL Example 2 : Elimination of test impedance error Purpose: To eliminate impedance error of test down-lead In measuring the smaller resistance, the impedance of test down-lead leads to error. So uses should eliminate the impedance error of test down-lead before measuring.
RIGOL Example 3 : dBm Measurement Purpose: To achieve dBm measurement. dBm is a commonly measure units which widely used in electrical, radio, mechanics, shock and vibration, mechanical power and acoustics, and other fields, and dBm caluation is usually used for RF signal measurement.
RIGOL Index DM3000 Command Quick Reference *IDN? 2-3 F *RST 2-3 :function 2-5 :function:voltage:DC:ratio 2-5 C :function:voltage:DC 2-5 :calculate:function 2-68 :function:voltage:AC 2-5 :calculate:statistic:min 2-68 :function:current:DC 2-6 :calculate:statistic:max 2-69 :function:current:AC 2-6 :calculate:statistic:average 2-69 :function:resistance 2-6 :calculate:statistic:count 2-70 :function:fresistance 2-7 :calculate:NULL:offset 2-70 :function:frequency 2-7 :calculate:DB 2-71 :funct
RIGOL :measure:current:DC 2-18 :resolution:voltage:AC 2-38 :measure:current:DC:range? 2-19 :resolution:current:DC 2-39 :measure:current:DC:digit 2-19 :resolution:current:AC 2-40 :measure:current:AC? 2-20 :resolution:resistance 2-41 :measure:current:AC 2-20 :resolution:fresistance 2-41 :measure:current:AC:range? 2-21 :resolution:capacitance 2-42 :measure:current:AC:digit 2-22 :measure:current:AC:freq? 2-22 S :measure:current:AC:freq:display 2-22 :scan:create 2-84 :measure:current:AC:freq:hide
RIGOL :system:lanserial 2-52 U :system:opentimes?2-52 :utility:interface:LAN:dhcp 2-55 :utility:interface:LAN:host 2-55 T :utility:interface:LAN:domain 2-56 :trigger:source 2-62 :utility:interface:LAN:ip 2-56 :trigger:auto:interval 2-62 :utility:interface:LAN:mask 2-57 :trigger:auto:hold 2-63 :utility:interface:LAN:gateway 2-57 :trigger:auto:hold:sensitivity 2-63 :utility:interface:LAN:dns 2-58 :trigger:single 2-64 :utility:interface:GPIB:address 2-58 :trigger:single:triggered 2-64 :utility