Specifications

ManualsBrandsRIGOL ManualsTest & MeasurementBench multimeter digital CAT II 300 V Display (counts): 200000

Programming Guide RIGOL

Publication Number: PGC03100-1110

Dec. 2008

DM3058 Digital Multimeter

Summary of content (264 pages)

PAGE 2
PAGE 3
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.
PAGE 4
RIGOL Summary This manual provides the guidance for remote control programming of DM3058 digital multimeter. 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 DM3058 multimeter user guide, and been familiar with the RIGOL DM3058 multimeter‘s operation.
PAGE 5
RIGOL Table of Contents Chapter 1 Introduction ............................................................................ 1-1 Programming Introduction ......................................................................... 1-2 Symbol Instruction .................................................................................... 1-3 Parameter Types ....................................................................................... 1-4 Commands Introduction...........................................
PAGE 6
RIGOL Measure Commands ................................................................................ 5-27 Memory Commands ................................................................................. 5-35 Output Commands .................................................................................. 5-40 Sample Commands .................................................................................. 5-42 Sense Commands ............................................................................
PAGE 7
RIGOL Chapter 1 Introduction This chapter gives you a guidance in how to operate RIGOL DM3058 digital multimeter correctly based on Remote control programming and to achieve a long-distance measuring operation, which mainly includes:     Programming Introduction Symbol Instruction Parameter Types Commands Introduction Programming Guide for DM3058 1-1
PAGE 8
RIGOL Programming Introduction This part introduces the basic programming operations. These programming commands provide a medium for remote control to a multimeter. The    Basic operations that you can do with a computer and a multimeter include: Setup the multimeter. Measure. Acquire data (equipment working condition or measuring results) from a multimeter. A computer can communicate with a multimeter by sending or receiving messages over an I/O port, such as USB, GPIB port or a RS-232 port.
PAGE 9
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. RIGOL commands begin with (:). 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 (?) at the end of the commands.
PAGE 10
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).
PAGE 11
RIGOL Commands Introduction To meet the needs from different users, DM3058 not only provide RIGOL commands, but also provide another two commands that are compatible with the related products.    RIGOL DM3058 commands The commands compatible with Agilent The commands compatible with Fluke Send CMDSET command to switch the commands type. For the usage please see the follows: Command Format: CMDSET□{RIGOL|AGILENT|FULUKE} CMDSET？ Function: The command sets and queries the type of commands .
PAGE 12
PAGE 13
RIGOL Chapter 2 General Commands System General Commands System applied to both DM3058 Commands and its compatible commands of Fluke and Agilent, which mainly includes:    IEEE488 Commands Status Commands Error Commands Programming Guide for DM3058 2-1
PAGE 14
RIGOL IEEE488 Commands The commands query the equipment state or perform some basic operations which mainly include:     *IDN? *RST *ESE *ESR？        *PSC *SRE *STB? *CLS *OPC *RCL *SAV 2-2 Programming Guide for DM3058
PAGE 15
RIGOL 1. *IDN? Command Format: *IDN? Function: The command queries equipment ID. Return Format: The query returns the character string that shows the equipment ID within 35 characters at least. 2. *RST Command Format: *RST Function: The command resets the equipment state to the factory default. 3. *ESE Command Format: *ESE□ *ESE? Function: The command sets or queries the enable value of Event Status Register (ESR).
PAGE 16
RIGOL 4. *ESR？ Command Format: *ESR？ Function: The command queries the event value of Event Status Register (ESR). Return Format: The query returns the event value of ESR. 5. *PSC Command Format: *PSC□{0|1} *PSC? Function: The command sets or queries the value of ―power-on status clear (PSC)‖. Explanations: *PSC□{0|1}: Enable or disable the clear operation of register as soon as the instrument is power-on.
PAGE 17
RIGOL Function: The command sets or queries the enable value of Status Byte Register (STB). Explanations: *SRE□: Set the enable value of STB. *SRE?: Query the enable value of STB. : The range is from 0 to 188. Return Format: The query returns the enable value of STB. 7. *STB? Command Format: *STB? Function: The command queries the condition value of Status Byte Register (STB). Return Format: The query returns the condition value of STB. 8.
PAGE 18
RIGOL Function: The command sets the ―Operation Complete‖ (zero bit) from Event Status Register as 1 after finish current operation. *OPC?: Query whether the current operation is finished or not. Return Format: The query returns ―1‖ , which denotes current operation has finished. 10. *RCL Command Format: *RCL□{1|2|3|4|5|6|7|8|9|10} Function: The command recovers the current status of instrument to the status of selected location. If the location is empty or can not been detected, an error may be occur.
PAGE 19
RIGOL Status Commands These commands set or query the related data from both Questionable Status Register and Operation Status Register which mainly include:        [:]status:operation:condition? [:]status:operation:enable [:]status:operation[:event]? [:]status:preset [:]status:questionable:condition? [:]status:questionable:enable [:]status:questionable[:event]? The principle of Status Register is shown in Figure 2-1, which contains Questionable Status Register, Operation Status Register, Event St
PAGE 20
RIGOL Figure 2-1 Schematic diagram of Status Register 2-8 Programming Guide for DM3058
PAGE 21
RIGOL 1. [:]status:operation:condition? Command Format: [:]status:operation:condition? Function: The command queries the state value of Condition Register from Operation Status Register. Return Format: The query returns the state value of Condition Register from Operation Status Register. 2. [:]status:operation:enable Command Format: [:]status:operation:enable□ [:]status:operation:enable? Function: The command sets or queries the value of Enable Register from Operation Status Register.
PAGE 22
RIGOL Function: The command queries the value of Event Register from Operation Status Register. Return Format: The query returns the value of Event Register from Operation Status Register. 4. [:]status:preset Command Format: [:]status:preset Function: The command clears the value of Enable Register from Operation Status Register and Questionable Status Register. 5.
PAGE 23
RIGOL Register. Explanation: [:]status:questionable:enable : Set the value of Enable Register from Questionable Status Register between 0 and 24375. [:]status:questionable:enable?: Query the value of Enable Register from Questionable Status Register Return Format: The query returns the value of Enable Register from Questionable Status Register 7.
PAGE 24
RIGOL Error Commands The commands query the error message to the instrument based on ― first-in first-out ― and return a error message every time, which mainly include:  2-12 system:error? Programming Guide for DM3058
PAGE 25
RIGOL 1. system:error? Command Format: system:error? Function: The command queries the error message in error queue. Return Format: The query returns the character string of error message.
PAGE 26
PAGE 27
RIGOL Chapter 3 DM3058 Commands System In RIGOL DM3058 digital multimeter commands, all the parameters and the return values are ASCII characters. Besides, the input state is insensitive.
PAGE 28
RIGOL Function Commands The commands sets the basic measuring functions which equal to the related selector button of Measure Function in front panel.
PAGE 29
RIGOL 1. :function? Command Format: :function? Function: The command queries the current measuring function. If in Dual Display mode, queries the function of main display. Return Format: The query returns the current DM3058 measuring function‘s shortening. The possible return values are: DCV, ACV, DCI, ACI, RESISTANCE, CAPACITANCE, CONTINUITY, FRESISTANCE, DIODE, FREQUENCY, PERIOD. 2. :function:voltage:DC Command Format: :function:voltage:DC Function: The command enables DC voltage measuring function.
PAGE 30
RIGOL 4. :function:current:DC Command Format: :function:current:DC Function: The command enables DC current measuring function. Explanation: In ―:function?‖, this function is corresponding to the return value ―DCI‖. 5. :function:current:AC Command Format: :function:current:AC Function: The command enables AC current measuring function. Explanation: In ―:function?‖, this function is corresponding to the return value ―ACI‖. 6.
PAGE 31
RIGOL :function:fresistance Function: The command enables 4-wire resistance measuring function. Explanation: In ―:function?‖, this function is corresponding to the return value ―FRESISTANCE‖. 8. :function:frequency Command Format: :function:frequency Function: The command enables frequency measuring function. Explanation: In ―:function?‖, this function is corresponding to the return value ―FREQUENCY‖. 9.
PAGE 32
RIGOL The command enables continuity measuring function. Explanation: In ―:function?‖, this function is corresponding to the return value ―CONTINUITY‖. 11. :function:diode Command Format: :function:diode Function: The command enables diode measuring function. Explanation: In ―:function?‖, this function is corresponding to the return value ―DIODE‖. 12. :function:capacitance Command Format: :function:capacitance Function: The command enables capacitance measuring function.
PAGE 33
RIGOL Measure Commands The commands are used to set measuring function further which equals to select measuring function buttons in DM3058 front panel.
PAGE 34
RIGOL     3-8 :measure:diode? :measure:capacitance? :measure:capacitance :measure:capacitance:range? Programming Guide for DM3058
PAGE 35
RIGOL 1. :measure? Command Format: :measure? Function: The command queries whether a new data is acquired in current trigger setting. Return Format: The query returns true or false. If ―a new data is acquired‖ returns ―ture‖, or else returns ―false‖. 2. :measure Command Format: :measure□{AUTO|MANU} Function: The command sets measure mode as Auto or Manual. Example: Set measure mode as Manual: :measure□MANU 3.
PAGE 36
RIGOL example: 8.492853e-05, unit is V. 4. :measure:voltage:DC Command Format: :measure:voltage:DC□{|MIN|MAX|DEF} Function: The command sets the measuring range of DC voltage and resolution. Parameters: Name Type discrete Range of Values Default {0|1|2|3|4} 0 Explanations: To set the measuring range of DC voltage and the resolution at the same time. The measure mode will be changed into manual when setting range. For the reference ranges and resolutions please refer to table 3-1.
PAGE 37
RIGOL 5. :measure:voltage:DC:range? Command Format :measure:voltage:DC:range? Function: The command queries the measuring range of DC voltage. Explanation: Please make sure the DCV function must has been set at least one time before using this command. Return Format: The query returns the parameter related to current range : 0, 1, 2, 3 or 4 (see Table 3-1). 6.
PAGE 38
RIGOL Command Format: :measure:voltage:DC:filter:state? :measure:voltage:DC:filter:state□{ON|OFF} Function: The command queries and sets the switch state of DC filter. Explanations: :measure:voltage:DC:filter:state?: Query the switch state of DC filter. :measure:voltage:DC:filter:state□{ON|OFF}: Set the switch state of DC filter. Return Format: The query return the switch state of DC filter: ON or OFF that denotes turning DC filter on or off.
PAGE 39
RIGOL :measure:voltage:AC□{|MIN|MAX|DEF} Function: The command sets the measuring range of AC voltage. Parameters: Name Type Range of Values Default discrete {0|1|2|3|4} 2 Explanations: The table 3-2 lists the parameters and the ranges. Table 3-2 The range of AC voltage Parameter Range 0 200 mV 1 2.0 V 2 20.0 V 3 200.0 V 4 750.0 V MIN 200 mV MAX 750 V DEF 20.0 V Example: To set the measuring range of AC voltage as 750.
PAGE 40
RIGOL Table 3-2). 11. :measure:current:DC? Command Format: :measure:current:DC? Function: The command queries DC current. Explanations: This command is invalide for dual display Return Format； The query returns the DC current in the form of 9.674418e-05, and unit is A. 12. :measure:current:DC Command Format: :measure:current:DC□{|MIN|MAX|DEF} Function: The command sets the measuring range of DC current and resolution.
PAGE 41
RIGOL Table 3-3 The DC current ranges and their resolutions Parameter Current Resolution 0 200 μA 1 nA 1 2 mA 10 nA 2 20 mA 100 nA 3 200 mA 1 μA 4 2A 10 μA 5 10 A 100 μA MIN 200 μA 1 nA MAX 10 A 100 μA DEF 200 mA 1 μA Explanation: To set the measuring range of DC current as 10.0 A: :measure:current:DC□MAX or :measure:current:DC□5 13. :measure:current:DC:range? Command Format: :measure:current:DC:range? Function: The command queries the measuring range of DC current.
PAGE 42
RIGOL Explanation: This command is invalide for Dual Display Return Format: The query returns the AC current in the form of 9.293791e-05, and unit is A. 15. :measure:current:AC Command Format: :measure:current:AC□{|MIN|MAX|DEF} Function: The command sets the measuring range of AC current. Parameters: Name Type Range of Values Default discrete {0|1|2|3} 1 Explanations: :measure:current:AC?: Query the measuring range of AC current.
PAGE 43
RIGOL :measure:current:AC□MAX or :measure:current:AC□3 16. :measure:current:AC:range? Command Format: :measure:current:AC:range? Function: The command queries AC current range. Explanation: Before sending the command, please enable AC current measuring function. Return Format: The query returns the parameter related to current range : 0, 1, 2 or 3 (see Table 3-4). 17. :measure:resistance? Command Format: :measure:resistance? Function: The commad queries 2-wire resistance.
PAGE 44
RIGOL Function: The command sets the measuring range of 2-wire resistance. Parameters: Name Type Range of Values Default discrete {0|1|2|3|4|5|6} 3 Explanations: The table 3-5 indicates the parameters and the range. Table 3-5 The two circuits resistance ranges Parameter Range 0 200 Ω 1 2 KΩ 2 20 KΩ 3 200 KΩ 4 1 MΩ 5 10 MΩ 6 100 MΩ MAX 100 MΩ MIN 200 Ω DEF 200 KΩ Example: To set the measuring range of 2-wire resistance as 200.
PAGE 45
RIGOL (see Table 3-5). 20. :measure:fresistance? Command Format: :measure:fresistance? Function: The command queries 4-wire resistance. Explanation: This command is invalide for Dual Display Return Format: The query returns the current 4-wire resistsnce in the form of 8.822946e-05, and unit is Ω. 21. :measure:fresistance Command Format: :measure:fresistance□{|MIN|MAX|DEF} Function: The command sets the measuring range of 4-wire resistance.
PAGE 46
RIGOL 22. :measure:fresistance:range? Command Format: :measure:fresistance:range? Function: The command queries the measuring range of 4-wire resistance. Return Format: The query returns the parameter related to current range : 0, 1, 2, 3, 4, 5 or 6 (see Table 3-5). 23. :measure:frequency? Command Format: :measure:frequency? Function: The command queries frequency. Explanation: The range of frequency is 20 Hz~1 MHz.
PAGE 47
RIGOL Parameters: Name Type Range of Value Default discrete {0|1|2|3|4} 2 Explanations: The frequency range is 20 Hz~1 MHz. The Table 3-2 indicates the parameters and their ranges. Example: To set the measuring range of input voltage as 20 V: :measure:frequency□DEF 25. :measure:frequency:range? Command Format: :measure:frequency:range? Function: The command queries the measuring range of AC voltage in frequency measurement.
PAGE 48
RIGOL Explanation: This command is invalide for Dual Display. Return Format: The query returns the current period in the form of 9.185433e-05, and the unit is s. 27. :measure:period Command Format: :measure:period□{|MIN|MAX|DEF} Function: The command sets the measuring range of input voltage in period measurement. Parameters: Name Type Range of Values Default discrete {0|1|2|3|4} 2 Explanations: The period range is 1 us~50 ms.
PAGE 49
RIGOL Explanations: The range is the same as the measuring range of AC voltage. See Table 3-2. Return Format: The query returns the parameter related to current range: 0, 1, 2, 3 or 4 (see Table 3-2). 29. :measure:continuity? Command Format: :measure:continuity? Function: The command quries resistance in the state of short circuit. Return Format: The query returns the current resistance in the form of 8.888000e+03, and unit is Ω. 30.
PAGE 50
RIGOL Example: To set the limit resistance as 1 kΩ: :measure:continuity□1000 31. :measure:diode? Command Format: :measure:diode? Function: The command queries diode voltage at both ends. Explanation: In measuring diode, the beep condition is 0.1 V≤Vmeasured≤2.4 V. Return Format: The query returns the current diode voltage in the form of 4.492510e-04, and unit is V. 32. :measure:capacitance? Command Format: :measure:capacitance? Function: The command queries capacitance.
PAGE 51
RIGOL :measure:capacitance□{|MIN|MAX|DEF} Function: The command sets the measuring range of capacitance. Parameters: Name Type Range of Values Default discrete {0|1|2|3|4|5 } 2 Explanations: The table 3-6 indicates the parameters and their ranges.
PAGE 52
RIGOL The query returns the parameter related to current range: 0, 1, 2, 3, 4 or 5 (see Table 3-6).
PAGE 53
RIGOL Rate Commands The commands sets the rate of various measuring funtion such as Slow measure, Medium measure and Fast measure which mainly include:       :rate:voltage:DC :rate:voltage:AC :rate:current:DC :rate:current:AC :rate:resistance :rate:fresistance Programming Guide for DM3058 3-27
PAGE 54
RIGOL 1. :rate:voltage:DC Command Format: :rate:voltage:DC? :rate:voltage:DC□{fast|medium|slow} Function: The command sets or queries the measuring rate of DC voltage. Explanations: :rate:voltage:DC?: Query current measuring rate of DC voltage. DCV function has to be enabled before execute this command. :rate:voltage:DC□{fast|medium|slow}: Set current measuring rate of DC voltage.
PAGE 55
RIGOL Explanations: :rate:voltage:AC?: Query current measuring rate of AC voltage. ACV function has to be enabled before execute this command. :rate:voltage:AC□{fast|medium|slow}: Set current measuring rate of AC voltage. For the range and the explanation of parameters please refer to Table 3-7. Return Format: The query returns the parameter related to current measuring rate: fast, medium or slow. Example: Set the measuring rate of AC voltage as Medium. :rate:voltage:AC□medium 3.
PAGE 56
RIGOL 4. :rate:current:AC Command Format: :rate:current:AC? :rate:current:AC□{fast|medium|slow} Function: The command queries or sets the measuring rate of AC current. Explanations: :rate:current:AC?: Query current measuring rate of AC current, ACI function has to be enabled before execute this command. :rate:current:AC□{fast|medium|slow}: Set current measuring rate of DC voltage. For the range and the explanation of parameters please refer to Table 3-7.
PAGE 57
RIGOL to Table 3-7. Return Format: The query returns the parameter related to current measuring rate: fast, medium or slow. Example: Set the measuring rate of 2-wire resistance as Medium. :rate:resistance□medium 6. :rate:fresistance Command Format: :rate:fresistance? :rate:fresistance□{fast|medium|slow} Function: The command queries or sets the measuring rate of 4-wire resistance. Explanations: :rate:fresistance?: Query current measuring rate of 4-wire resistance.
PAGE 58
RIGOL System Commands The commands set the system parameters.
PAGE 59
RIGOL 1. :system:beeper Command Format: :system:beeper Function: The command tests the beeper. Explanations: The command enables the beeper beep only one time when testing. Before sending this command, please do open the beeper. 2. :system:beeper:state Command Format: :system:beeper:state? :system:beeper:state□{ON|OFF} Function: The command queries and sets the switch state of beeper . Explanations: :system:beeper:state?: Query whether the beeper is on.
PAGE 60
RIGOL :system:configure:poweron□{LAST|DEFAULT} Function: The command sets system parameters on power. 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. :system:configure:default Command Format: :system:configure:default Function: The command sets system default. 5.
PAGE 61
RIGOL 6. :system:format:decimal Command Format: :system:format:decimal? :system:format:decimal□{COMMA | DOT} Function: The command queries and sets the format of radix point . Explanations: :system:format:decimal?: Query the format of radix point . :system:format:decimal□{COMMA | DOT}: Set the format of radix point. ―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 ―,‖.
PAGE 62
RIGOL Return Format: The query returns the current format of data seperator: ON, NONE or SPACE. 8. :system:display:bright Command Format: :system:display:bright? :system:display:bright□ Function: The command queries and sets display brightness. Parameters: Name Type Range of Values Default Consecutive Integer 0~32 21 Explanations: :system:display:bright?: Query the display brightness. :system:display:bright□: Set the display brightness.
PAGE 63
RIGOL Explanations: :system:displaycontrast?: Query the display contrast. :system:displaycontrast□: Set the display contrast. The contrast is an integer among 0~32. 0 is the minimum, and 32 is maximum. Return Format: The query returns the current display contrast, and the range is 0~32. 10. :system:display:invert Command Format: :system:display:invert Function: The command inverts the display color.
PAGE 64
RIGOL Utility Commands The commands are used to set communication control and self-inspection. Before, please make sure that communication interface has been connected stably, otherwise it possible to be abnormal or wrong.
PAGE 65
RIGOL 1. :utility:interface:LAN:dhcp Command Format: :utility:interface:LAN:dhcp? :utility:interface:LAN:dhcp□{ON|OFF} Function: The command queries and sets the switch state of DHCP for LAN connection. Explanations: :utility:interface:LAN:dhcp?: Query whether the DHCP is on. :utility:interface:LAN:dhcp□{ON|OFF}: Set the switch state of DHCP. ―ON‖ denotes DHCP is on, and ―OFF‖ denotes DHCP is off. Return Format: The query returns the current switch state of DHCP: ON or OFF. 2.
PAGE 66
RIGOL 3. :utility:interface:LAN:mask Command Format: :utility:interface:LAN:mask? :utility:interface:LAN:mask□ Function: The command queries and sets IP mask for LAN connection. Parameters: Name Type Range of Values Default character string self-defined 255.255.255.0 Explanations: :utility:interface:LAN:mask?: Query the IP mask. :utility:interface:LAN:mask□: Set the IP mask. The parameter is the user-defined character string.
PAGE 67
RIGOL is the user-defined character string. Return Format: The query returns the current gateway. 5. :utility:interface:LAN:dns Command Format: :utility:interface:LAN:dns? :utility:interface:LAN:dns□ Function: The command queries and sets DNS address for LAN connection. Parameters: Name Type Range of Values Default character string self-defined 0.0.0.0 Explanations: :utility:interface:LAN:dns?: Query the DNS address.
PAGE 68
RIGOL Parameters: Name Type Range of Values Default Consecutive Integer 0~30 7 Explanations: :utility:interface:GPIB:address?: Query the GPIB address. :utility:interface:GPIB:address□: Set the GPIB address. Return Format: The query returns the current GPIB address, the range is 0~30. 7.
PAGE 69
RIGOL :utility:interface:RS232:baud□{none8bits|odd7bits|even7bits} Function: The command queries and sets communication parity bit of serial interface (RS232). Explanations: :utility:interface:RS232:baud?: Query the RS232 parity bit. :utility:interface:RS232:baud□{none8bits|odd7bits|even7bits}: Set the RS232 parity bit. Return Format: The query returns the current parity bit: none8bits, odd7bits or even7bits. The range of the return value is the same as the setting parameter.
PAGE 70
RIGOL Trigger Commands The commands are used to set the parameters of tigger system .
PAGE 71
RIGOL 1. :trigger:source Command Format: :trigger:source? :trigger:source□{AUTO|SINGLE|EXT} Function: The command queries and sets trigger souce. Return Format: The query returns current trigger source: auto, single or ext, and they respectively denotes ―automatic trigger‖,―single trigger‖, and ―external trigger‖. 2. :trigger:auto:interval Command Format: :trigger:auto:interval? :trigger:auto:interval□ Function: The command queries and sets the interval time for auto trigger.
PAGE 72
RIGOL 3. :trigger:auto:hold Command Format: :trigger:auto:hold? :trigger:auto:hold□{ON|OFF} Function: The command queries and sets the enable state of auto trigger delay. Explanations: :trigger:auto:hold?: Query the enable state of auto trigger delay. :trigger:auto:hold□{ON|OFF}: Enable or disable auto trigger delay. Return Format: The query returns the current enable state of auto trigger delay. ―ON‖ means the delay is on, and ―OFF‖ means off. 4.
PAGE 73
RIGOL Return Format: The query returns the parameter related to current sensitivity: 0, 1, 2 or 3.(See Table 3-8) 5. :trigger:single Command Format: :trigger:single? :trigger:single□{|MIN|MAX|DEF } Function: The command queries and sets sampling times of single trigger. Explanations: :trigger:single?: Query sampling times of single trigger. :trigger:single□{|MIN|MAX|DEF }: Set sampling times of single trigger.
PAGE 74
RIGOL 7. :trigger:ext Command Format: :trigger:ext? :trigger:ext□{RISE|FALL|HIGH|LOW} Function: The command queries and sets exterior trigger mode. Explanations: :trigger:ext?: Query the exterior trigger mode, and the default is the rise edge trigger. :trigger:ext□{RISE|FALL|HIGH|LOW}: Set the exterior trigger mode. The parameters respectively means ―rise edge trigger‖, ―fall edge trigger‖, ―high level trigger‖ and ―low level trigger‖.
PAGE 75
RIGOL 9. :trigger:vmcomplete:pulsewidth Command Format: :trigger:vmcomplete:pulsewidth? :trigger:vmcomplete:pulsewidth□ Function: The command queries and sets VMC output pulsewidth. Parameters: Name Type Range Default consecutive integer See Explanations 100 Explanations: :trigger:vmcomplete:pulsewidth?: Query the VMC output pulsewidth. The default is 100 ms. :trigger:vmcomplete:pulsewidth□: Set the VMC output pulsewidth.
PAGE 76
RIGOL Calculate Commands The commands are used to set parameters for calculate system.
PAGE 77
RIGOL 1. :calculate:function Command Format: :calculate:function? :calculate:function□{NONE|REL|DB|DBM|MIN|MAX|AVERAGE|TOTAL|LIMIT} Function: The command queries and sets the function of math calculation . Explanations: :calculate:function?: Query current function of math calculation. The default is NONE (turning off math calculation). :calculate:function□{NONE|REL|DB|DBM|MIN|MAX|AVERAGE|TOTAL|LIMIT} : Set the function of math calculation. The table 3-9 indicates the parameters and their meanings.
PAGE 78
RIGOL The command queries statistic minimum. Explanation: Only when MIN calculation is available, the command is just available. Return Format: The query returns current statistic minimum. 3. :calculate:statistic:max? Command Format: :calculate:statistic:max? Function: The command queries statistic maximum. Explanation: Only when MAX calculation is available, the command is just available. Return Format: The query returns current statistic maximum. 4.
PAGE 79
RIGOL 5. :calculate:statistic:count? Command Format: :calculate:statistic:count? Function: The command queries measuring times in calculation. Explanation: The command is available to current measure operation. If shift measuring function, to restart counting. Return Format: The query returns current measuring times. 6. :calculate:statistic:state Command Format: :calculate:statistic:state? :calculate:statistic:state□{ON|OFF} Function: The command queries and sets the enable state of Stat. operation.
PAGE 80
RIGOL Command Format: :calculate:REL:offset? :calculate:REL:offset□{|MIN|MAX|DEF|CURR} Function: The command queries and sets the offset of NULL calculation. Parameters: Name Type Range of Values Default consecutive real number See Table 3-10 0 Explanations: :calculate:REL:offset?: Query the offset of NULL calculation. :calculate:REL:offset□{|MIN|MAX|DEF|CURR}:Set the offset of NULL calculation. The range varies with both measuring type and range (see Table 3-10).
PAGE 81
RIGOL Command Format: :calculate:REL:state? :calculate:REL:state□{ON|OFF} Function: The command queries or sets the enable state of REL operation. Explanations: :calculate:REL:state?: Enable or disable REL operation. :calculate:REL:state□{ON|OFF}: Set the enable state of REL operation. Example: Disable REL operation: :calculate:statistic:state□OFF 9. :calculate:DB? Command Format: :calculate:DB? Function: The command queries dB value. Explanations: This command is available only when dB operation is on.
PAGE 82
RIGOL The command queries and sets dB reference value. Parameters: Name Type Range of Values Default consecutive integer 120 dBm~+120 dBm 0 Explanations: :calculate:DB:reference?: Query the dB reference value. :calculate:DB:reference□{|MIN|MAX|DEF}: Set the dB reference value. This command is available only when dB operation is on. When setting dB reference value, should be an integer between +120dB and -120dB. MIN denotes -120dB, MAX denotes +120dB, and DEF denotes 0.
PAGE 83
RIGOL 12. :calculate:DBM? Command Format: :calculate:DBM? Function: The command queries dBm value. Explanation: This command is available only when dBm operation is on. Return Format: The query returns current dBm value. 13. :calculate:DBM:reference Command Format: :calculate:DBM:reference? :calculate:DBM:reference□{|MIN|MAX|DEF} Function: The command queries and sets dBm reference resistance.
PAGE 84
RIGOL 14. :calculate:DBM:state Command Format: :calculate:DBM:state? :calculate:DBM:state□{ON|OFF} Function: The command queries or sets the enable state of dBm operation. Explanations: :calculate:DBM:state?: Query the enable state of dBm operation. :calculate:DBM:state□{ON|OFF}: Enable or disable dBm operation. Return Format: The query returns the enable state of dBm operation: ON or OFF that denotes turning dBm operation on or off. Example: Disable Stat. Operation: :calculate:DB:state□OFF 15.
PAGE 85
RIGOL 16. :calculate:limit:lower Command Format: :calculate:limit:lower? :calculate:limit:lower□ Function: The command queries and sets lower value of P/F calculation. Parameters: Name Type Range of Value Default consecutive real number See Table 3-11 0 Explanations: :calculate:limit:lower?: Query the lower value of P/F calculation. :calculate:limit:lower□: Set the lower value of P/F calculation. The default range of please refer to table 3-11.
PAGE 86
RIGOL Function: The command queries and sets upper value in P/F calculation. Parameters: Name Type Range of Values Default consecutive real number See table 3-11 0 Explanations: :calculate:limit:upper?: Queriy the upper value of P/F operation. :calculate:limit:upper□: Set the upper value of P/F calculation. The default range of please refer to Table 3-11. Return Format: The query returns current upper value. 18.
PAGE 87
RIGOL Double-Display Commands The commands set or query the related parameter for Double Display function.
PAGE 88
RIGOL 1. :function2? Command Format: :function2? Function: This command queries the measuring function of vice display screen. Explanation: This command is available only when Double Display is on. Return Format: The query returns the identifier related to measuring function of vice display. The return value may be DCV, ACV, DCI, ACI, 2WR, CAP, 4WR, FREQ or PERI. 2. :function2:value1? Command Format: :function2:value1? Function: This command queries the measuring value of main display.
PAGE 89
RIGOL Explanation: This command is available only when Double Display is on. Return Format: The query returns the measuring value of vice display. 4. :function2:voltage:DC Command Format: :function2:voltage:DC Function: The command sets the measuring function of vice display as DCV function. Explanation: Here, the measuring function of main display should be DCV, DCI, ACV or ACI only. 5.
PAGE 90
RIGOL The command sets the measuring function of vice display as DCI function. Explanation: Here, the measuring function of main display should be DCV, DCI, ACV or ACI only. 7. :function2:current:AC Command Format: :function2:current:AC Function: The command sets the measuring function of vice display as ACI function. Explanation: Here, the measuring function of main display should be DCV, DCI, ACV, ACI, FREQUENCY or PERIOD only. 8.
PAGE 91
RIGOL The command sets the measuring function of vice display as Period function. Explanation: Here, the measuring function of main display should be ACV, FREQUENCY or PERIOD only. 10. :function2:resistance Command Format: :function2:resistance Function: The command sets the measuring function of vice display as Resistance function. Explanation: Here, the measuring function of main display should be RESISTANCE or FRESISTANCE only. 11.
PAGE 92
PAGE 93
RIGOL Chapter 4 Compatible Fluke Commands In RIGOL DM3058 digital multimeter commands, all the parameters and return values of Fluke command DM3058 compatible with are ASCII characters. Besides, the input state is insensitive.
PAGE 94
RIGOL Function Commands The commands enable the basic measuring funtion of the instrument, which similar to the related funciton button in front panel.
PAGE 95
RIGOL 1. AAC Command Format: AAC AAC2 Function: The command enables the AC Current measuring function of both main and vice display. Explanations: AAC: Enable the AC Current measuring function of main display. AAC2: Enable the AC Current measuring function of vice display. 2. ADC Command Format: ADC ADC2 Function: Enable the DC Current measuring function of both main and vice display. Explanations: ADC: Enable the DC Current measuring function of main display.
PAGE 96
RIGOL Command Format: CONT Function: The command enables the Continuity test of main display. 5. DIODE Command Format: DIODE Function: The command enables the Diode test of main display. 6. FREQ Command Format: FREQ FREQ2 Function: The command enables the Frequency measuring function of both main and vice display. Explanation: FREQ: Enable the Frequency measuring function of main display. FREQ2: Enable the Frequency measuring function of vice display. 7.
PAGE 97
RIGOL display. Explanations: FUNC1?: Query the measuring funtion of main display. FUNC2?: Query the measuring funtion of vice display. If the vice display is disable, error will occur for FUNC2?. Return Format: The command returns the mnemonic of current measuring function. FUNC1?: The query may returns: AAC2, ADC2, CONT, DIODE, FREQ, OHMS, WIRE2, WIRE4, VAC, VDC. FUNC2?: The query may returns: AAC, ADC, FREQ, OHMS, VAC, VDC. 8.
PAGE 98
RIGOL Explanations: WIRE2: Enable 2-wire resistance measuring function. WIRE4: Enable 4-wire resistance measuring function. Both the resistance measuring function of main and vice display are switched simultaneously when Double Display is on. 10. VAC Command Format: VAC VAC2 Function: The command enables the AC Voltage measuring function in main and vice display. Explanations: VAC: Enable the AC Voltage measuring function in main display. VAC2: Enable the AC Voltage measuring function in vice display.
PAGE 99
RIGOL Function Regulator Commands The commands enable the Regulator of the instrument, which similar to the math operation button on the front panel.
PAGE 100
RIGOL 1. DB Command Format: DB Function: The command enables dB function. Explanation: The units of all the readings from main display are dB. If ACV or DCV function is disable, an execution error will be occur. 2. DBCLR Command Format: DBCLR Function: The command exits dB mode. 3. DBPOWER Command Format: DBPOWER Function: The command enables dB power conditioner when the reference impedance of dbm is 2, 4, 8 or 16 ohms and Voltage function has been enabled, or else a execution error will be occur.
PAGE 101
RIGOL 4. DBREF Command Format: DBREF□ DBREF? Function: The command sets or queries the dB reference resistance. Explanations: The command sets the reference resistance as the listed in table 4-1. If the value you have set are not involved in it, an execution error will be occur.
PAGE 102
RIGOL Explanations: A reading will be force to show on the screen if the instrument has already been in this mode while you send HOLD. 6. HOLDCLR Command Format: HOLDCLR Function: The command disable Touch Hold function and back to normal operation. 7. HOLDTHRESH Command Format: HOLDTHRESH□ HOLDTHRESH? Function: The command sets or queries the threshold of HOLD.
PAGE 103
RIGOL Function: The command enables the MAX adjustor mode and sets the current reading as Maximum. Explanation: If the instrument has already been in this mode, the maximum will be shown directly. In MAX mode, auto range may be forbidden. 9. MAXSET Command Format: MAXSET□ Function: The command enables the MAX mode and sets the as maximum.
PAGE 104
RIGOL Command Format: MINSET□ Function: The command enables the MIN mode and sets the as minimum. Explanations: could be either a signed integer, a signed real number without exponent, or a signed real number with exponent and also the parameter should be smaller than last one. If the exceeds the range, an execution error may be occur. Auto range may be forbidden. 12.
PAGE 105
RIGOL Both and could be a signed integer, a signed real number without exponent, or a signed real number with exponent. If either or exceeds the range, an execution error may be occur. 14. MMCLR Command Format: MMCLR Function: The command disables the MIN MAX mode and meanwhile both the minimum and the maximum are lost. Explanations: Then the instrument back to Range mode and the selected range is the one before MIN MAX mode. 15.
PAGE 106
RIGOL REL Function: The command enables the REL mode and sets the value shown on the main display as its value. 17. RELCLR Command Format: RELCLR Function: The command disables the REL mode and backs to Range mode. The range is the one before REL. 18. RELSET Command Format: RELSET□ RELSET? Function: RELSET□: Enable the REL mode and set as its value. RELSET?: Query the current . If the REL mode is not enables, an execution error may be occur.
PAGE 107
RIGOL Range and Velocity Commands The commands set or query the measuring range and the measuring velocity, which similar to the related range button or digit button.
PAGE 108
RIGOL 1. AUTO Command Format: AUTO AUTO? Function: The command sets or queries the mode of Auto range of the instrument. Explanation: AUTO: Set the mode of range of the instrument as Auto. If this mode can not be selected ( or when Diode or Continuity test is active ), execution error will be occur. AUTO?: Query whether the instrument is in Auto range mode or not. Return Format: The query returns the current mode of range. 1 denotes Auto, 2 denotes Not. 2.
PAGE 109
RIGOL etc.), for the detailed range please refer to table 4-2. RANGE1?: Query the range that has been selected currently on the main display. RANGE2?: Query the range that has been selected currently on the vice display. If the vice display does not been actived, execution error will be occur. Return Format: The query returns the range that has been selected currently on the main or vice display. Table 4-2 Optional ranges of every function No.
PAGE 110
RIGOL Measuring Commands The commands query the measuring results and show them on the main or vice display.
PAGE 111
RIGOL 1. MEAS Command Format: MEAS? MEAS1? MEAS2? Function： MEAS?: Query the measuring value of the instrument. MEAS1?: Query the measuring value of main display. MEAS2?: Query the measuring value of vice display. If the vice display is disable, The execution error wll be occur. Return Format: MEAS?: The command returns the value of both the vice and main display if they are active. If the vice display is disable, the function of ―MEAS?‖ is equal to ―MEAS1?‖.
PAGE 112
RIGOL display is empty, it will return to the value of next trigger. VAL2?: The command returns the measuring value of vice display. If the vice display is empty, it will return to the value of next trigger. If the vice display is disable, the execution error wll be occur.
PAGE 113
RIGOL Compare Commands The commands compare whether the value measured by the instrument is higer or lower or belong to the regulated range, which mainly include:      COMP COMPCLR COMPHI COMPLO HOLDCLR Programming Guide for DM3058 4-21
PAGE 114
RIGOL 1. COMP Command Format： COMP COMP? Function: COMP: Disable the Compare function (COMP). Touch Hold will be actived automaticlly (you can disable it via HOLDCLR command). COMP? Query the result of last comparation. Return Format: The query returns the result of last comparation. If the measuring result is higher than the maximum of range, it returns LO; if belong to the range, it returns PASS; or returns ―—‖ if the measuring has not been finished yet. 2.
PAGE 115
RIGOL 4. COMPLO Command Format: COMPLO□ Function: The command sets the lower limit (LO) of COMP as . Explanation: could be either a signed integer or a signed real number. 5. HOLDCLR Command Format: HOLDCLR Function: The command disables the Touch Hold but except for COMP function and back to normal work.
PAGE 116
PAGE 117
RIGOL Chapter 5 Compatible Agilent Commands In Agilent commands , all the command parameters and the return values are ASCII characters. Before using it, please send the command CMDSET firstly, that is send CMDSET□AGILENT. The system can‘t identify capitalization and lower case, and support the shortening of key words. (The commands are abbreviated in the form of capitalization so as to be viewed more conveniently. The compatible commands must follow syntax strictly.
PAGE 118
RIGOL Calculate Commands The commands are used to set calculation function to do math operation, statistic operation and limit operation.
PAGE 119
RIGOL 1. CALCulate:FUNCtion Command Format: CALCulate:FUNCtion□{NULL | DB | DBM | AVERage | LIMit} CALCulate:FUNCtion? Function: The command sets or queries calculation function. Explanations: Firstly, send the command ―CALCulate:STATe □ {OFF | ON}‖ to enable the calculation subsystem. CALCulate:FUNCtion □ {NULL | DB | DBM | AVERage | LIMit}: Select the calculation function, the default is NULL. CALCulate:FUNCtion?: Query the current calculation function.
PAGE 120
RIGOL CALCulate:STATe?: Query current enable state of calculation function. Return Format: The query returns current enable state: ON or OFF. 3. CALCulate:LIMit:LOWer Command Format: CALCulate:LIMit:LOWer□{ | MINimum | MAXimum} CALCulate:LIMit:LOWer?□{MINimum | MAXimum} Function: The command sets or queries the lower limit of current calculation function.
PAGE 121
RIGOL CALCulate:LIMit:UPPer?□{MINimum | MAXimum} Function: The command sets or queries the upper limit of current calculation function. Parameters: Name Type Range of Values Default Consecutive Real Number ± 120% max range 0 Explanations: Firstly, do enable calculation function (CALCulate:STATe□ON) and select limit function (CALCulate:FUNCtion□LIMIT) to run the command. CALCulate:LIMit:UPPer□{ | MINimum | MAXimum}: Set the upper limit of current calculation function.
PAGE 122
RIGOL Explanations: Firstly, do enable calculation function (CALCulate:STATe□ON) and select limit function (CALCulate:FUNCtion□DB) to run the command. CALCulate:DB:REFerence □ { | MINimum | MAXimum}: Set the reference value of dB. CALCulate:DB:REFerence?□{MINimum | MAXimum}: Query the reference value of dB. MIN = -120 dB, MAX = 120 dB, DEF = 0 dB. Return Format: The query returns the reference value of dB. 6.
PAGE 123
RIGOL 7. CALCulate:NULL:OFFSet Command Format: CALCulate:NULL:OFFSet□{ | MINimum | MAXimum} CALCulate:NULL:OFFSet?□{MINimum | MAXimum} Function: The command sets or queries the Null offset. Parameters: Name Type Range of Values Consecutive Integer ± 120% max range Explanations: Firstly, do enable calculation function (CALCulate:STATe□ON) and select limit function (CALCulate:FUNCtion□NULL) to run the command. CALCulate:NULL:OFFSet□{ | MINimum | MAXimum}: Set the Null offset.
PAGE 124
RIGOL The query returns the average of all the statistical data. 9. CALCulate:AVERage:CLEar Command Format: CALCulate:AVERage:CLEar Function: The command recovers all the settings of calculation function in current measurement to the defaults. Explanations: Firstly, do enable calculation function (CALCulate:STATe□ON) and select limit function (CALCulate:FUNCtion□AVERage) to run the command. The data include minimum, maximum, average, number of data and standard deviation. 10.
PAGE 125
RIGOL CALCulate:AVERage:MAXimum? Function: The command queries the maximum of statistical data. Explanations: Firstly, do enable calculation function (CALCulate:STATe□ON) and select limit function (CALCulate:FUNCtion□AVERage) to run the command. The maximum of statistical data can be queried at any time. Return Format: The query returns the maximum of statistical data. 12. CALCulate:AVERage:MINimum? Command Format: CALCulate:AVERage:MINimum? Function: The command queries the minimum of statistical data.
PAGE 126
RIGOL Explanations: Firstly, do enable calculation function (CALCulate:STATe□ON) and select limit function (CALCulate:FUNCtion□AVERage) to run the command. The peak-to-peak value of statistical data can be queried at any time. Return Format: The query returns the peak-to--peak value of statistical data. 14. CALCulate:AVERage:SDEViation? Command Format: CALCulate:AVERage:SDEViation? Function: The command queries the standard deviation of statistical data.
PAGE 127
RIGOL Configure Commands The commands are used to set basic measuring functions and related parameters, such as range and accuracy.
PAGE 128
RIGOL 1. CONFigure? Command Format: CONFigure? Function: The command queries the current configuration of instrument. Return Format: The query returns the character string of instrument configuration. And it consist of three parts: , , . For example: VOLT:DC 0.200000 1000.000000. may be ―VOLT:DC‖, ―VOLT:AC‖, ―CURR:DC‖, ―CURR:AC‖, ―RES‖, ―FRES‖, ―CAP‖, ―CONT‖, ―DIODE‖, ―FREQ‖, ―PER‖. 2.
PAGE 129
RIGOL 3. CONFigure:CONTinuity Command Format: CONFigure:CONTinuity Function: The command resets all the continuity measuring parameters and trigger parameter as defaults, and sets continuity measuring function. Explanations: Enable continuity test, and set the range as 2 kΩ. 4.
PAGE 130
RIGOL Function: The command resets all the DC current measuring parameters and trigger parameters as defaults, and sets DC current measuring function. Parameters: Name Type Range of Values Default Discrete { 200 µA | 2 mA | 20 mA | 200 mA | 2 A | 10 A } 200 mA Discrete {MIN|MAX|DEF} Rate: medium Explanations: may be 200 μA (MIN), 2 mA, 20 mA, 200 mA, 2 A, 10 A (MAX), AUTO (autorange) (unit is A). MAX = 10, MIN = 0. 000 2.
PAGE 131
RIGOL Parameters: Name Type Range of Values Default Consecutive Integer 20 Hz~1 MHz switching to autorange Discrete {MIN|MAX|DEF} Rate: medium Explanations: may be 20 Hz~1 MHz (unit is Hz). MAX = 1 000 000, MIN = 20, DEF is autorange. (unit is Hz); in default setting, the rate is medium. 8.
PAGE 132
RIGOL Function: The command resets all the period measuring parameters and trigger parameters as defaults, and sets period measuring function. Parameters: Name Type Range of Vaules Default Consecutive Integer 1 μs~50 ms 50 ms Discrete {MIN|MAX|DEF} Rate: medium Explanations: may be 1 μs~50 ms (unit is s). MAX = 0.05, MIN = 0.000001, DEF = 0.05. (unit is Hz); in default setting, the rate is medium. 10.
PAGE 133
RIGOL 11. CONFigure[:VOLTage]:AC Command Format: CONFigure[:VOLTage]:AC□ [{|AUTO|MIN|MAX|DEF} [,{|MIN|MAX|DEF}]] Function: The command resets all the AC voltage measuring parameters and trigger parameters as defaults, and sets AC voltage measuring function.
PAGE 134
RIGOL may be 200 mV (MIN), 2 V, 20 V, 200 V, 1000 V (MAX), AUTO (autorange) (unit is V). MAX = 1000, MIN = 0. 2. (unit is V); in default setting, the rate is medium.
PAGE 135
RIGOL Data Commands The commands are used to read the data from non-volatile memory, and do quering and deletion.
PAGE 136
RIGOL 1. DATA:DATA?□NVMEM Command Format: DATA:DATA?□NVMEM Function: The command queries the data in non-volatile memory. Return Format: The query returns the data in non-volatile memory. 2. DATA:DELete□NVMEM Command Format: DATA:DELete□NVMEM Function: The command deletes the data from non-volatile memory. 3. DATA:LAST? Command Format: DATA:LAST? Function: The command queries the last test result. Return Format: The query returns the last test result. 4.
PAGE 137
RIGOL The command queries the number of data saved in non-volatile memory. Return Format: The query returns the number of data saved in non-volatile memory. 5. DATA:REMove? Command Format: DATA:REMove?□ Function: The command reads and removes the specified number of data from memory. Parameters: Name Type Range of Values Default Discrete The specified number, not beyond ―points‖.
PAGE 138
RIGOL Fetch Commands The commands are used to read the data from output buffer of multimeter.
PAGE 139
RIGOL 1. FETCh? Command Format: FETCh? Function: The command queries the data in output buffer, and reads them for computer. Explanation: The command will stop the operation until the completion of measuring command. Return Format: The query returns the data in output buffer. 2. FETCh:CURRent:AC:PTPeak? Command Format: FETCh:CURRent:AC:PTPeak? Function: The command queries the difference between the highest and lowest AC transient current.
PAGE 140
RIGOL The command queries max transient current in DCI measurement. Explanations: Before sending the command, please enable DC current measuring function, and enble DCI peak-to-peak measuring function with the command ―[SENSe:] CURRent[:DC]:PEAK:STATe□ON‖. Return Format: The query returns max transient current in DCI measurement. 4. FETCh:CURRent[:DC]:PEAK:MINimum? Command Format: FETCh:CURRent[:DC]:PEAK:MINimum? Function: The command queries min transient current in DCI measurement.
PAGE 141
RIGOL Before sending the command, please enable DC current measuring function, and enble DCI peak-to-peak measuring function with the command ―[SENSe:] CURRent[:DC]:PEAK:STATe□ON‖. Return Format: The query returns the peak-to-peak value in DCI measurement. 6. FETCh:VOLTage:AC:PTPeak? Command Format: FETCh:VOLTage:AC:PTPeak? Function: The command queries the difference between the highest and lowest AC transient voltage.
PAGE 142
RIGOL Return Format: The query returns max transient voltage in DCV measurement. 8. FETCh:VOLTage[:DC]:PEAK:MINimum? Command Format: FETCh:VOLTage[:DC]:PEAK:MINimum? Function: The command queries min transient voltage in DCV measurement. Explanations: Before sending the command, please enable DC voltage measuring function, and enble DCV peak-peak measuring function with the command ―[SENSe:] VOLTage[:DC]:PEAK:STATe□ON‖. Return Format: The query returns min transient voltage in DCV measurement. 9.
PAGE 143
RIGOL Measure Commands The commands are used to enable basic measuring function, and have the same function with the selection keys in front panel.
PAGE 144
RIGOL 1. MEASure:CAPacitance? Command Format: MEASure:CAPacitance?□ [{|AUTO|MIN|MAX|DEF} [,{|MIN|MAX|DEF}]] Function: The command resets all the capacitance measuring parameters and trigger parameters as defaults, and sets capacitance measuring function, gets the measuring results and sends them to output buffer of instrument.
PAGE 145
RIGOL Return Format: The query returns the data in ouput buffer. 3. MEASure:CURRent:AC? Command Format: MEASure:CURRent:AC?□ [{|AUTO|MIN|MAX|DEF} [,{|MIN|MAX|DEF}]] Function: The command resets all the AC current measuring parameters and trigger parameters as defaults, and sets AC current measuring function, get the measuring results and send them to output buffer of instrument.
PAGE 146
RIGOL measuring results and sends them to output buffer of instrument. Parameters: Name Type Range of Values Default Discrete { 200 µA | 2 mA | 20 mA | 200 mA | 2 A | 10 A } 200 mA Discrete {MIN|MAX|DEF} Rate: medium Explanations: may be 200 μA (MIN), 2 mA, 20 mA, 200 mA, 1 A, 10 A (MAX), AUTO (autorange) (unit is A). MAX = 10, MIN = 0. 000 2. (unit is A); in default setting, the rate is medium.
PAGE 147
RIGOL The command resets all the frequency measuring parameters and trigger parameters as defaults, and sets frequency measuring function, gets the measuring results and sends them to output buffer of instrument. Parameters: Name Type Range of Values Default Consecutive Integer 20 Hz~1 MHz 20 Hz Discrete {MIN|MAX|DEF} Rate: medium Explanations: may be 20 Hz~1 MHz (unit is Hz). MAX = 1 000 000, MIN = 20, DEF = 20.
PAGE 148
RIGOL (MAX), AUTO (autorange) (unit is Ω). MAX = 100 000 000, MIN = 200. (unit is Ω); in default setting, the rate is medium. Return Format: The query returns the data in output buffer. 8.
PAGE 149
RIGOL Function: The command resets all the 2-wire resistance measuring parameters and trigger parameters as defaults, and sets 2-wire resistance measuring function, get the measuring results and send them to output buffer of instrument.
PAGE 150
RIGOL may be 200 mV (MIN), 2 V, 20 V, 200 V, 750 V (MAX), AUTO (autorange) (unit is V). MAX = 750, MIN = 0. 2. (unit is V); in default setting, the rate is medium. Return Format: The query returns the data in output buffer. 11.
PAGE 151
RIGOL Memory Commands The commands are used to access the data in memory, and do quering and deletion.
PAGE 152
RIGOL 1. MEMory:NSTates? Command Format: MEMory:NSTates? Function: The command queries the number of available memory location. Return Format: The query returns the number of available memory location. 2. MEMory:STATe:CATalog? Command Format: MEMory:STATe:CATalog? Function: The command queries the name of memory location (1 to 5). Return Format: The query returns the name of memory location (1 to 5). 3.
PAGE 153
RIGOL Command Format: MEMory:STATe:DELete:ALL Function: The command deletes the data of all memory location. Explanations: The factory setting can‘t be deleted, it can be restored after re-power on. If the data in the selected memory location have been deleted, it will lead to a error for trying to restore the data. 5. MEMory:STATe:NAME Command Format: MEMory:STATe:NAME□{1|2|3|4|5} [,] MEMory:STATe:NAME?□{1|2|3|4|5} Function: The command sets or queries the name of specified memory location.
PAGE 154
RIGOL 6. MEMory:STATe:RECall:AUTO Command Format: MEMory:STATe:RECall:AUTO□{ON|OFF} MEMory:STATe:RECall:AUTO? Function: The command sets or queries the enable state of automatic recall of a specific stored instrument state when power is on. Explanations: MEMory:STATe:RECall:AUTO□{ON|OFF}: Enable or disable the automatic recall function. MEMory:STATe:RECall:AUTO?: Query the enable state of the automatic recall function. Return Format: The query returns the enable state of automatic recall function. 7.
PAGE 155
RIGOL Return Format: The query returns the serial number of memory the selected instrument state is stored in. 8. MEMory:STATe:VALid Command Format: MEMory:STATe:VALid?□{1|2|3|4|5} Function: The command queries if the available state information can be stored in specified memory location. Explanation: The command “*RCL” can be used to query if the specified memory location has data. Return Format: The query returns 1 or 0, 1 denotes ―valid‖; 0 denotes ―invalid‖.
PAGE 156
RIGOL Output Commands The commands are used to set trigger mode for output signal as rising edge or falling edge.
PAGE 157
RIGOL 1. OUTPut:TRIGger:SLOPe Command Format: OUTPut:TRIGger:SLOPe□{POSitive|NEGative} OUTPut:TRIGger:SLOPe? Function: The command sets or queries the trigger mode for ouput signal. Explanations: OUTPut:TRIGger:SLOPe□{POSitive|NEGative}: Set the trigger mode for ouput signal as rising edge (POSitive) or falling edge (NEGative). OUTPut:TRIGger:SLOPe?: Query the trigger mode for ouput signal. Return Format: The query returns the parameter related to trigger mode: POSitive or NEGative.
PAGE 158
RIGOL Sample Commands The commands are used to set trigger parameters, such as sample times, delayed time.
PAGE 159
RIGOL 1. SAMPle:SOURce Command Format: SAMPle:SOURce□{IMMediate|TIMer} SAMPle:SOURce? Function: The command sets or queries the trigger type for sampling. Explanations: The command ―SAMPle:SOURce□{IMMediate|TIMer}‖ should be used together with the command ―TRIGger:DELay‖ and ―SAMPle:TIMer‖. When sample numbers are greater than 1, sample time can be determined; when sample number is 1, the command is invalid.
PAGE 160
RIGOL 3600 s, MIN is determined by measuring function. In DC measurement, MIN is almost 20 μs; in AC measurement, MIN is determined by bandwidth. SAMPle:TIMer?□[{MIN|MAX}]: Query the sample interval time. It is suggested that accurate range should be set by manual not by auto in all trigger command. Return Foramt: The query returns the sample interval time.
PAGE 161
RIGOL Sense Commands The commands are used to set parameters of measuring functions, such as NULL value, range, accuracy, interval time, and enable state of measuring function.
PAGE 162
RIGOL      [SENSe:]VOLTage[:DC]:PEAK:STATe [SENSe:]VOLTage[:DC]:RANGe:AUTO [SENSe:]VOLTage[:DC]:RANGe[:UPPer] [SENSe:]VOLTage[:DC]:RESolution [SENSe:]VOLTage[:DC]:ZERO:AUTO           [SENSe:]RESistance:APERture [SENSe:]RESistance:APERture:ENABled [SENSe:]RESistance:NPLC [SENSe:]RESistance:NULL[:STATe] [SENSe:]RESistance:NULL:VALue [SENSe:]RESistance:OCOMpensated [SENSe:]RESistance:RANGe:AUTO [SENSe:]RESistance:RANGe[:UPPer] [SENSe:]RESistance:RESolution [SENSe:]RESistance:ZERO:AUTO   
PAGE 163
RIGOL  [SENSe:]PERiod:VOLTage:RANGe[:UPPer]     [SENSe:]CAPacitance:NULL[:STATe] [SENSe:]CAPacitance:NULL:VALue [SENSe:]CAPacitance:RANGe:AUTO [SENSe:]CAPacitance:RANGe[:UPPer] Programming Guide for DM3058 5-47
PAGE 164
RIGOL 1. [SENSe:]FUNCtion[:ON] Command Format: [SENSe:]FUNCtion[:ON]□"" [SENSe:]FUNCtion[:ON]? Function: The command selects or queries measuring function.
PAGE 165
RIGOL [SENSe:]CURRent:AC:NULL[:STATe]□{ON|OFF} [SENSe:]CURRent:AC:NULL[:STATe]? Function: The command sets or queries the enable state of ACI NULL function. Explanations: [SENSe:]CURRent:AC:NULL[:STATe]□{ON|OFF}: Enable or disable ACI NULL function. [SENSe:]CURRent:AC:NULL[:STATe]?: Query the enable state of ACI NULL function. The command ―[SENSe:]CURRent:AC:NULL:VALue‖ can be used to set NULL value. The commands ―CONFigure:CURRent:AC‖ and ―MEASure:CURRent:AC?‖ can disable NULL function (OFF).
PAGE 166
RIGOL ACI measurement. Before sending the command, run the command ―[SENSe:]CURRent:AC:NULL [:STATe]□ON‖ to enable NULL function. Return Format: The query returns the NULL value of ACI measurement. 4. [SENSe:]CURRent:AC:PEAK:STATe Command Format: [SENSe:]CURRent:AC:PEAK:STATe□{ON|OFF} [SENSe:]CURRent:AC:PEAK:STATe? Function: The command sets or queries the enable state of ACI peak-to-peak measuring function.
PAGE 167
RIGOL Explanations: [SENSe:]CURRent:AC:RANGe:AUTO □ {ON|OFF}: Enable or disable ACI autorange function. If autorange function is ON, the measuring range will be selected automatically according to input signal. [SENSe:]CURRent:AC:RANGe:AUTO?: Query the enable state of ACI autorange function. Return Format: The query returns the enable state of ACI autorange function. 6.
PAGE 168
RIGOL [SENSe:]CURRent[:DC]:APERture?□[{MIN|MAX}] Function: The command sets or queries the interval time of DCI measurement. Parameters: Name Type Range of Values Default Consecutive Integer MIN = 400 mS, MAX = 2 s 400 ms Explanations: [SENSe:]CURRent[:DC]:APERture □ {|MIN|MAX|DEF}: Set the interval time of DCI measurement. Unit is s, so ―400‖ ms should be input in form of 0.4. [SENSe:]CURRent[:DC]:APERture?□[{MIN|MAX}]: Query the interval time of DCI measurement.
PAGE 169
RIGOL Return Format: The query returns the enable state of DCI interval time function. 9. [SENSe:]CURRent[:DC]:NPLC Command Format: [SENSe:]CURRent[:DC]:NPLC□{|MIN|MAX|DEF} [SENSe:]CURRent[:DC]:NPLC?□[{MIN|MAX}] Function: The command sets or queries the interval time of DCI measurement, input values and returned values are both multiples of PLC. Parameters: Name Type Range of Values Default Discrete {0.006|0.02|0.06|0.
PAGE 170
RIGOL Explanations: [SENSe:]CURRent[:DC]:NULL[:STATe]□{ON|OFF}: Enable or disable DCI NULL function. [SENSe:]CURRent[:DC]:NULL[:STATe]?: Query the enable state of DCI NULL function. The command ―[SENSe:]CURRent[:DC]:NULL:VALue‖ can be used to set NULL value. The commands ―CONFigure:CURRent:DC‖ and ―MEASure:CURRent:DC?‖ can disable NULL function (OFF). Return Format: The query returns the enable state of DCI NULL function. 11.
PAGE 171
RIGOL 12. [SENSe:]CURRent[:DC]:PEAK:STATe Command Format: [SENSe:]CURRent[:DC]:PEAK:STATe□{ON|OFF} [SENSe:]CURRent[:DC]:PEAK:STATe? Function: The command sets or queries the enable state of DCI peak-to-peak measuring function. Explanations: [SENSe:]CURRent[:DC]:PEAK:STATe □ {ON|OFF}: Enable or disable DCI peak-to-peak measuring function. [SENSe:]CURRent[:DC]:PEAK:STATe?: Query the enable state of DCI peak-to-peak measuring function.
PAGE 172
RIGOL The command returns the enable state of DCI autorange function. 14. [SENSe:]CURRent[:DC]:RANGe[:UPPer] Command Format: [SENSe:]CURRent[:DC]:RANGe[:UPPer]□{|MIN|MAX|DEF} [SENSe:]CURRent[:DC]:RANGe[:UPPer]?□[{MIN|MAX}] Function: The command sets or queries the range of DCI measuring function.
PAGE 173
RIGOL Parameters: Name Type Range of Values Default Discrete {MIN|MAX|DEF} Rate: medium Explanations: [SENSe:]CURRent[:DC]:RESolution □ {|MIN|MAX|DEF}: Set the resolution of DCI measurement. In default setting of , the rate is medium. [SENSe:]CURRent[:DC]:RESolution?□[{MIN|MAX}]: Query the resolution of DCI measurement. Return Format: The query returns current resolution of DCI measurement. 16.
PAGE 174
RIGOL Function: The command sets or queries the enable state of ACV NULL function. Explanations: [SENSe:]VOLTage:AC:NULL[:STATe]□{ON|OFF}: Enable or disable ACV NULL function. [SENSe:]VOLTage:AC:NULL[:STATe]?: Query the enable state of ACV NULL function. The command ―[SENSe:]VOLTage:AC:NULL:VALue‖ can be used to set NULL value. The commands ―CONFigure:CURRent:AC‖ and ―MEASure:CURRent:AC?‖ can be used to disable NULL function. Return Format: The command returns the enable state of ACV NULL function. 18.
PAGE 175
RIGOL Return Format: The query returns the NULL value of ACV measurement. 19. [SENSe:]VOLTage:AC:PEAK:STATe Command Format: [SENSe:]VOLTage:AC:PEAK:STATe□{ON|OFF} [SENSe:]VOLTage:AC:PEAK:STATe? Function: The command sets or queries the enable state of ACV peak-to-peak measuring function. Explanations: [SENSe:]VOLTage:AC:PEAK:STATe □ {ON|OFF}: Enable or disable ACV peak-to-peak measuring function. [SENSe:]VOLTage:AC:PEAK:STATe?: Query the enable state of ACV peak-to-peak measuring function.
PAGE 176
RIGOL [SENSe:]VOLTage:AC:RANGe:AUTO?: Query the enable state of ACV autorange function. The max range of ACV measurement is 750 V. Return Format: The query returns the enable state of ACV autorange function. 21. [SENSe:]VOLTage:AC:RANGe[:UPPer] Command Format: [SENSe:]VOLTage:AC:RANGe[:UPPer]□{|MIN|MAX|DEF} [SENSe:]VOLTage:AC:RANGe[:UPPer]?□[{MIN|MAX}] Function: The command sets or queries the range of ACV measurement.
PAGE 177
RIGOL Function: The command sets or queries the interval time of DCV measurement. Parameters: Name Type Range of Values Default Consecutive Real Number 400 ms~2 s 400 ms Explanations: [SENSe:]VOLTage[:DC]:APERture□{|MIN|MAX|DEF}: Set the interval time of DCV measurement. Unit is s, so ―400 ms‖ should be input in the form of 0.4. [SENSe:]VOLTage[:DC]:APERture?□[{MIN|MAX}]: Query the interval time of DCV measurement.
PAGE 178
RIGOL Return Format: The query returns the enable state of DCV interval time measuring function. 24. [SENSe:]VOLTage[:DC]:IMPedance:AUTO Command Format: [SENSe:]VOLTage[:DC]:IMPedance:AUTO□{ON|OFF} [SENSe:]VOLTage[:DC]:IMPedance:AUTO? Function: The command sets or queries the enable state of DCV input impedance measuring function. Explanations: [SENSe:]VOLTage[:DC]:IMPedance:AUTO □ {ON|OFF}: Enable or disable DCV input impedance measuring function. The default is OFF.
PAGE 179
RIGOL multiples of PLC. Parameters: Name Type Range of Values Default Discrete {0.006|0.02|0.06|0.2|1|2|10|100} 1 PLC Explanations: [SENSe:]VOLTage[:DC]:NPLC□{|MIN|MAX|DEF}: Set the interval time of DCV measurement, input value is multiples of PLC. may be 0.006, 0.02, 0.06, 0.2, 1, 2, 10 or 100, MIN = 0.006 PLC, MAX = 100 PLC. [SENSe:]VOLTage[:DC]:NPLC?□[{MIN|MAX}]: Query the interval time of DCV measurement, return value is multiples of PLC.
PAGE 180
RIGOL The query returns the enable state of DCV NULL function. 27. [SENSe:]VOLTage[:DC]:NULL:VALue Command Format: [SENSe:]VOLTage[:DC]:NULL:VALue□{|MIN|MAX} [SENSe:]VOLTage[:DC]:NULL:VALue?□[{MIN|MAX}] Function: The command sets or queries the NULL value of DCV measurement. Parameters: Name Type Range of Values Default Discrete ± 120% max range 0 Explanations: [SENSe:]VOLTage[:DC]:NULL:VALue□{|MIN|MAX}: Set the NULL value of DCV measurement.
PAGE 181
RIGOL Explanations: [SENSe:]VOLTage[:DC]:PEAK:STATe □ {ON|OFF}: Enable or disable DCV peak-to-peak measuring function. [SENSe:]VOLTage[:DC]:PEAK:STATe?: Query the enable state of DCV peak-to-peak measuring function. The command ―[SENSe:]VOLTage[:DC]:NULL:VALue‖ can be uesd to set DCV peak-to-peak value. Return Format: The query returns the enable state of DCV peak-to-peak measuring function. 29.
PAGE 182
RIGOL Function: The command sets or queries the range of DCV measurement. Parameters: Name Type Range of Values Default Discrete {200 mV | 2 V | 20 V | 200 V | 1000 V} 20 V Explanations: [SENSe:]VOLTage[:DC]:RANGe[:UPPer] □ {|MIN|MAX|DEF}: Set the range of DCV measurement. may be 200 mV, 2 V, 20 V, 200 V, 1000 V, MIN = 200 mV, MAX = 1000 V. Unit is V, so ―200 mV‖ should be input in form of 0.2.
PAGE 183
RIGOL measurement. Return Format: The query returns the resolution of DCV measurement. 32. [SENSe:]VOLTage[:DC]:ZERO:AUTO Command Format: [SENSe:]VOLTage[:DC]:ZERO:AUTO□{ON|OFF} [SENSe:]VOLTage[:DC]:ZERO:AUTO? Function: The command sets or queries the enable state of DCV auto zero measuring function. Explanations: [SENSe:]VOLTage[:DC]:ZERO:AUTO□{ON|OFF}: Enable or disable DCV auto zero measuring function. [SENSe:]VOLTage[:DC]:ZERO:AUTO?: Query the enable state of DCV auto zero measuring function.
PAGE 184
RIGOL Parameters: Name Type Range of Values Default Consecutive Real Number 400 ms~2 s 400 ms Explanations: [SENSe:]RESistance:APERture □ {|MIN|MAX|DEF}: Set the interval time of 2-wire resistance measurement. Unit is s, so ―400 ms‖ should be input in form of 0.4. [SENSe:]RESistance:APERture?□[{MIN|MAX}]: Query the interval time of 2-wire resistance measurement. 2-wire and 4-wire resistance function both are influenced by the command.
PAGE 185
RIGOL Return Format: The query returns the enable state of 2WR interval time measuring function. 35. [SENSe:]RESistance:NPLC Command Format: [SENSe:]RESistance:NPLC□{|MIN|MAX|DEF} [SENSe:]RESistance:NPLC?□[{MIN|MAX}] Function: The command sets or queries the interval time of 2-wire resistance measurement, input value is multiples of PLC. Parameters: Name Type Range of Values Default Discrete {0.006|0.02|0.06|0.
PAGE 186
RIGOL The command sets or queries the enable state of 2WR NULL measuring function. Explanations: [SENSe:]RESistance:NULL[:STATe]□{ON|OFF}: Enable or disable 2WR NULL measuring function. [SENSe:]RESistance:NULL[:STATe]?: Query the enable state of 2WR NULL measuring function. The command ―[SENSe:]RESistance:NULL:VALue‖ can be used to set NULL value. The commands ―CONFigure:RESistance‖ and ―MEASure:RESistance?‖ can be used to disable NULL function (OFF).
PAGE 187
RIGOL 2-wire and 4-wire resistance function both are influenced by the command. All the command of 2WR and 4WR will have influence over the setting of resistance. Return Format: The query returns the NULL value of 2WR measurement. 38. [SENSe:]RESistance:OCOMpensated Command Format: [SENSe:]RESistance:OCOMpensated□{ON|OFF} [SENSe:]RESistance:OCOMpensated? Function: The command sets or queries the enable state of 2WR offset compensated function.
PAGE 188
RIGOL Explanations: [SENSe:]RESistance:RANGe:AUTO □ {ON|OFF}: Enable or disable 2WR autorange measuring function. If 2WR autorange function is ON, the measuring range will be selected according to input signal. [SENSe:]RESistance:RANGe:AUTO?: Query the enable state of 2WR autorange measuring function. 2-wire and 4-wire resistance function both are influenced by the command. All the command of 2WR and 4WR will have influence over the setting of resistance.
PAGE 189
RIGOL The query returns the range of 2WR measurement. 41. [SENSe:]RESistance:RESolution Command Format: [SENSe:]RESistance:RESolution□{|MIN|MAX|DEF} [SENSe:]RESistance:RESolution?□[{MIN|MAX}] Function: The command sets or queries the resolution of 2WR measurement. Parameters: Name Type Range of Value Default Discrete {MIN|MAX|DEF} Rate: medium Explanations: [SENSe:]RESistance:RESolution □ {|MIN|MAX|DEF}: Set the resolution of 2WR measurement.
PAGE 190
RIGOL [SENSe:]RESistance:ZERO:AUTO□{ON|OFF}: Enable or disable 2WR autozero measuring function. [SENSe:]RESistance:ZERO:AUTO?: Query the enable state of 2WR autozero measuring function. Return Format: The query returns the enable state of 2WR autozero measuring function. 43. [SENSe:]FRESistance:APERture Command Format: [SENSe:]FRESistance:APERture□{|MIN|MAX|DEF} [SENSe:]FRESistance:APERture?□[{MIN|MAX}] Function: The command sets or queries the interval time of 4WR measurement.
PAGE 191
RIGOL [SENSe:]FRESistance:APERture:ENABled□{ON|OFF} [SENSe:]FRESistance:APERture:ENABled? Function: The command sets or queries the enable state of 4WR interval time measuring function. Explanations: [SENSe:]FRESistance:APERture:ENABled □ {ON|OFF}: Enable or disable 4WR interval time measuring function. [SENSe:]FRESistance:APERture:ENABled?: Query the enable state of 4WR interval time measuring function.
PAGE 192
RIGOL 4WR measurement, input value is multiples of PLC. may be 0.006, 0.02, 0.06, 0.2, 1, 2, 10 or 100, MIN = 0.006 PLC, MAX = 100 PLC. [SENSe:]FRESistance:NPLC?□[{MIN|MAX}]: Query the interval time of 4WR measurement, returned value is multiples of PLC. 2-wire and 4-wire resistance function both are influenced by the command. All the command of 2WR and 4WR will have influence over the setting of resistance.
PAGE 193
RIGOL 47. [SENSe:]FRESistance:NULL:VALue Command Format: [SENSe:]FRESistance:NULL:VALue□{|MIN|MAX} [SENSe:]FRESistance:NULL:VALue?□[{MIN|MAX}] Function: The command sets or queries the NULL value of 4WR measurement. Parameters: Name Type Range of Values Default Discrete ± 120% max range 0 Explanations: [SENSe:]FRESistance:NULL:VALue□{|MIN|MAX}: Set the NULL value of 4WR measurement. MIN is -120% max range of current function, MAX is 120% max range of current function, DEF = 0.
PAGE 194
RIGOL [SENSe:]FRESistance:OCOMpensated□{ON|OFF}: Enable or disable 4WR offset compensated function. [SENSe:]FRESistance:OCOMpensated?: Query the enable state of 4WR offset compensated function. The command is available only for the range: 100 Ω, 1 kΩ and 10 kΩ. 2-wire and 4-wire resistance function both are influenced by the command. All the command of 2WR and 4WR will have influence over the setting of resistance. Return Format: The query returns the enable state of 4WR offset compensated function. 49.
PAGE 195
RIGOL [SENSe:]FRESistance:RANGe[:UPPer]□{|MIN|MAX|DEF} [SENSe:]FRESistance:RANGe[:UPPer]? [{MIN|MAX}] Function: The command sets or queries the range of 4WR measurement. Parameters: Name Type Range of Values Default Discrete {200 Ω | 2 kΩ | 20 kΩ | 200 kΩ | 2 MΩ | 10 MΩ | 100 MΩ} 200 kΩ Explanations: [SENSe:]FRESistance:RANGe[:UPPer] □ {|MIN|MAX|DEF}: Set the range of 4WR measurement.
PAGE 196
RIGOL Explanations: [SENSe:]FRESistance:RESolution □ {|MIN|MAX|DEF}: Set the resolution of 4WR measurement. In default of , the rate is medium. [SENSe:]FRESistance:RESolution?□[{MIN|MAX}: Query the resolution of 4WR measurement. 2-wire and 4-wire resistance function both are influenced by the command. All the command of 2WR and 4WR will have influence over the setting of resistance. Return Format: The query returns the resolution of 4WR measurement. 52.
PAGE 197
RIGOL Command Format: [SENSe:]FREQuency:NULL[:STATe]□{ON|OFF} [SENSe:]FREQuency:NULL[:STATe]? Function: The command sets or queries the enable state of frequency NULL measuring function. Explanations: [SENSe:]FREQuency:NULL[:STATe] □ {ON|OFF}: Enable or disable frequency NULL measuring function. [SENSe:]FREQuency:NULL[:STATe]?: Query the enable state of frequency NULL measuring function. The command ―[SENSe:]FREQuency:NULL:VALue‖ can be used to set NULL value.
PAGE 198
RIGOL 120%max range of current function, DEF = 0. [SENSe:]FREQuency:NULL:VALue? □ [{MIN|MAX}]: Query the NULL value of frequency measurement. Before sending the command, do run the command ―[SENSe:]FREQuency:NULL [:STATe]□ON‖ to enable NULL function. Return Format: The query returns the NULL value of frequency measurement. 55.
PAGE 199
RIGOL Function: The command sets or queries the voltage range in frequency measurement. Parameters: Name Type Range of Values Default Discrete {200 mV | 2 V | 20 V | 200 V | 750 V} 20 V Explanations: [SENSe:]FREQuency:VOLTage:RANGe[:UPPer] □ {|MIN|MAX|DEF}: Set the voltage range in frequency measurement. may be 200 mV, 2 V, 20 V, 200 V, 750 V, MIN = 200 mA, MAX = 750 V. Unit is V, so 200 mA should be input in form of 0.2.
PAGE 200
RIGOL of period measurement. Unit is s, so ―400 ms‖ should be input in form of 0.4. [SENSe:]PERiod:APERture?□[{MIN|MAX}]: Query the interval time of period measurement. Return Format: The query returns the interval time of period measurement. 58. [SENSe:]PERiod:NULL[:STATe] Command Format: [SENSe:]PERiod:NULL[:STATe]□{ON|OFF} [SENSe:]PERiod:NULL[:STATe]? Function: The command sets or queries the enable state of period NULL measuring function.
PAGE 201
RIGOL The command sets or queries the NULL value of period measurement. Parameters: Name Type Range of Values Default Discrete ± 120% max range 0 Explanations: [SENSe:]PERiod:NULL:VALue □ {|MIN|MAX}: Set the NULL value of period measurement. MIN is -120% max range of current function, MAX is max range of current function, DEF = 0. [SENSe:]PERiod:NULL:VALue?□[{MIN|MAX}]: Query the NULL value of period measurement.
PAGE 202
RIGOL The query returns the enable state of voltage autorange measuring function in period measurement. 61. [SENSe:]PERiod:VOLTage:RANGe[:UPPer] Command Format: [SENSe:]PERiod:VOLTage:RANGe[:UPPer]□{|MIN|MAX|DEF} [SENSe:]PERiod:VOLTage:RANGe[:UPPer]?□[{MIN|MAX}] Function: The command sets or queries the voltage range of period measurement.
PAGE 203
RIGOL Function: The command sets or queries the enable state of capacitance NULL measuring function. Explanations: [SENSe:]CAPacitance:NULL[:STATe]□{ON|OFF}: Enable or disable capacitance NULL measuring function. [SENSe:]CAPacitance:NULL[:STATe]?: Query the enable state of capacitance NULL measuring function. The command ―[SENSe:]CAPacitance:NULL:VALue‖ can be used to set NULL value. The commands ―CONFigure:CAPacitance‖ and ―MEASure:CAPacitance?‖ can be used to disable NULL function (OFF).
PAGE 204
RIGOL [:STATe]□ON‖ to enable NULL function. Return Format: The query returns the NULL value of capacitance measurement. 64. [SENSe:]CAPacitance:RANGe:AUTO Command Format: [SENSe:]CAPacitance:RANGe:AUTO□{ON|OFF} [SENSe:]CAPacitance:RANGe:AUTO? Function: The command sets or queries the enable state of capacitance autorange measuring function. Explanations: [SENSe:]CAPacitance:RANGe:AUTO□{ON|OFF}: Enable or disable capacitance autorange measuring function.
PAGE 205
RIGOL Parameters: Name Type Range of Values Default Discrete {2 nF | 20 nF | 200 nF | 2 µF | 200 µF| 10000 µF} 200 nF Explanations: [SENSe:]CAPacitance:RANGe[:UPPer] □ {|MIN|MAX|DEF}: Set the range of capacitance measurement. may be 2 nF, 20 nF, 200 nF, 2 µF, 200 µF or 10000 µF, MIN = 2 nF, MAX = 200 µF. Unit is F, so 200µF should be input in form of 0.0002. [SENSe:]CAPacitance:RANGe[:UPPer]? □ [{MIN|MAX}]: Query the range of capacitance measurement.
PAGE 206
RIGOL System Commands The commands are used to set communication ports and their parameters.
PAGE 207
RIGOL 1. SYStem:BEEPer:STATe Command Format: SYStem:BEEPer:STATe□{ON|OFF} SYStem:BEEPer:STATe? Function: The command sets or queries the switch state of beeper. Explanations: SYStem:BEEPer:STATe□{ON|OFF}: Turn beeper on or off. SYStem:BEEPer:STATe?: Query the switch state of beeper. Return Format: The query returns the switch state of beeper. 2.
PAGE 208
RIGOL 3. SYSTem:COMMunicate:LAN:BSTatus? Command Format: SYSTem:COMMunicate:LAN:BSTatus? Function: The command queries the script state of LAN . Explanations: SYSTem:COMMunicate:LAN:BSTatus?: Query the script state of LAN. The possible return value: ―LAN_DHCP‖ and ―LAN_STATIC‖. ―LAN_DHCP‖ denotes LAN script is DHCP address; ―LAN_STATIC‖ denotes LAN script is static IP address. Return Format: The query returns the script state of LAN. 4.
PAGE 209
RIGOL Explanations: SYSTem:COMMunicate:LAN:DDNS□{ON|OFF}: Turn dynamic DNS(DDNS) on or off. SYSTem:COMMunicate:LAN:DDNS?: Query the switch state of dynamic DNS. If the setting of DDNS is changed, the new configuration will be effective when power is on. Return Format: The query returns the switch state of DDNS. 6.
PAGE 210
RIGOL Function: The command sets or queries the static DNS address. Parameters: Name Type Range of Values Default
ASCII character string ―nnn.nnn.nnn.nnn‖ The range of ―nnn‖ is 0~255. ―0.0.0.0‖ Explanations: SYSTem:COMMunicate:LAN:DNS□"
": Set the static DNS address. SYSTem:COMMunicate:LAN:DNS?□[{CURRent|STATic}]: Query the static DNS address. ―CURRent‖ denotes current DNS address, ―STATic‖ denotes static DNS address.
PAGE 211
RIGOL Parameter: Name Type Range of Values Default ASCII character string Self – defined, 20 characters at most RIGOL Explanations: SYSTem:COMMunicate:LAN:DOMain□"": Set the domian name. SYSTem:COMMunicate:LAN:DOMain? □ [{CURRent|STATic}]: Query current domain name. ―CURRent‖ denotes current domain name; ―STATic‖ denotes the static domain name. Return Format: The command returns current domain name. 9.
PAGE 212
RIGOL If DHCP is OFF, the multimeter will use the static IP address, Subnet Mask, and Default Gateway during power-on. Return Format: The query returns current default gateway. 10. SYSTem:COMMunicate:LAN:HOSTname Command Format: SYSTem:COMMunicate:LAN:HOSTname□"" SYSTem:COMMunicate:LAN:HOSTname?□[{CURRent|STATic}] Function: The command sets or queries the host name of instrument.
PAGE 213
RIGOL The command sets or queries the IP address of instrument. Parameters: Name Type Range of Values Default
ASCII character string ―nnn.nnn.nnn.nnn‖ The range of ―nnn‖ is 0~255 ―168.254.0.238‖ Explanations: SYSTem:COMMunicate:LAN:IPADdress□"
": Set the IP address. SYSTem:COMMunicate:LAN:IPADdress?□[{CURRent|STATic}]: Query current IP address. ―CURRent‖ denotes current IP address; ―STATic‖ denotes static IP address. If DHCP is ON, the IP address set by manual is invalid.
PAGE 214
RIGOL 13. SYSTem:COMMunicate:LAN:SMASk Command Format: SYSTem:COMMunicate:LAN:SMASk□"" SYSTem:COMMunicate:LAN:SMASk?□[{CURRent|STATic}] Function: The command sets or queries the mask of instrument. Parameters: Name Type Range of Values Default ASCII character string ―nnn.nnn.nnn.nnn‖ The range of ―nnn‖ is 0~255 ―255.255.255.0‖ Explanations: SYSTem:COMMunicate:LAN:SMASk□"": Set the mask of instrument. SYSTem:COMMunicate:LAN:SMASk?□[{CURRent|STATic}]: Query the mask of instrument.
PAGE 215
RIGOL Trigger Commands The commands are used to set trigger parameters, such as trigger times, trigger delayed time and so on. It is suggested that the command ―SENSe:: RANGe:AUTO OFF‖ should be used to disable autorange function, the commands ―SENSe::RANGe, CONFigure‖ or ―MEASure?‖ be used to set range by manual.
PAGE 216
RIGOL 1. TRIGger:COUNt Command Format: TRIGger:COUNt□{|MIN|MAX|DEF|INFinity} TRIGger:COUNt?□[{MIN|MAX}] Function: The command sets or queries the trigger times used in multimeter. Parameters: Name Type Range of Values Default Consecutive Integer 1~50000 Required parameter Explanations: TRIGger:COUNt□{|MIN|MAX|DEF}: Set the trigger times. TRIGger:COUNt?□[{MIN|MAX}]: Query the trigger times. The command is only available for remote operation, not for front panel operation.
PAGE 217
RIGOL Parameters: Name Type Range of Values Default Consecutive Integer 0~3600 Required parameter Explanations: TRIGger:DELay□{|MIN|MAX|DEF}: Set the delay time. TRIGger:DELay?□[{MIN|MAX}]: Queries the delay time between trigger signal and starting measurement. In continuity test and diode test, delay time is not set. For AC measurement, the delay time is affected by bandwidth. The command ―CONFigure‖ or ―MEASure?‖ can be used to set automatically delay time.
PAGE 218
RIGOL The command ―CONFigure‖ or ―MEASure?‖ can be used to set delay time. It is suggested that the command ―SENSe::RANGe:AUTO□OFF‖ should be used to disable autorange function, the command ―SENSe:: RANGe‖, ―CONFigure‖ or ―MEASure?‖ be uesd to set range by manual. Return Format: The query returns the enable state of trigger autodelay function. 4.
PAGE 219
RIGOL The command sets or queries trigger source. Explanations: TRIGger:SOURce□{IMMediate|EXTernal|BUS}: Select the trigger source. TRIGger:SOURce?: Query the trigger source. The possible return value is IMMediate, EXTernal and BUS, IMMediate denotes trigger signal will be generated immediately; EXTernal denotes external trigger source on rear panel will be used; BUS (software trigger) denotes the command ―*TRG‖ will be trigger source.
PAGE 220
PAGE 221
RIGOL Chapter 6 DM3058 Compatibility Mode Besides RIGOL commands system, DM3058 is also compatible with some of remote control commands from Agilent and Fluke multimeter. If users have been familiar with Agilent and Fluke‘s commands, you can operate DM3058 conveniently. This chapter lists the compatible and incompatible commands for your reference. For the detailed meaning and operation method of each command, please refer to related companies‘ commands introduction.
PAGE 222
RIGOL Compatible Agilent Commands The following table lists the Agilent commands supported by RIGOL DM3058 digital multimeter. Before using the commands, you should send the CMDSET command (refer to Page 1-5): CMDSET□AGILENT to select Agilent command system.
PAGE 223
RIGOL :FRESistance :PERiod :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 Programming Guide for DM3058 6-3
PAGE 224
RIGOL :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution :RESolution? DATA :DATA? :DELete :LAST? :REMove? FETCh ? :CURRent :AC :PTPeak? [:DC] :PEAK :MAXimum? :MINimum? :PTPeak? :VOLTage :AC :PTPeak? [:DC] :PEAK :MAXimum? :MINimum? :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]? 6-4 Programming Guide for DM3058
PAGE 225
RIGOL :VALue :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]? Programming Guide for DM3058 6-5
PAGE 226
RIGOL :VALue :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]? 6-6 Programming Guide for DM3058
PAGE 227
RIGOL CURRent :AC :BANDwidth :BANDwidth? :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 Programming Guide for DM3058 :LOWer 6-7
PAGE 228
RIGOL :LOWer? :VOLTage :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? FRESistance :APERture :APERture :ENABled? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALue? :OCOMpensated :OCOMpensated? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution :RESolution? FUNCtion [:ON] [:ON]? PERiod :APERture :APERture? :NULL [:STATe] [:STATe]? :VALue :VALue? :RANGe :LOWer :LOWer? :VOLTage :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? RESistance :APERture :APERture? 6-8 Programming Guide for DM3058
PAGE 229
RIGOL :APERture :ENABled? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALue? :OCOMpensated :OCOMpensated? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution :RESolution? :ZERO :AUTO :AUTO? VOLTage :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]? Programming Guide for DM3058 6-9
PAGE 230
RIGOL :VALue :VALue? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution :RESolution? :ZERO :AUTO :AUTO? SYStem :BEEPer :STATe :STATe? :COMMunicate :GPIB [:SELF] :ADDRess :ADDRess? :LAN :BSTatus? :CONTrol? :DDNS :DDNS? :DHCP :DHCP? :DNS :DNS? :DOMain :DOMain? :GATEway :GATEway? :HOSTname :HOSTname? :IPADdress :IPADdress? :MAC? :SMASk :SMASk? :VERSion? *TRG 6-10 Programming Guide for DM3058
PAGE 231
RIGOL TRIGger :COUNt :COUNt? :DELay :DELay? :DELay :AUTO :AUTO? :SLOPe :SLOPe? :SOURce :SOURce? VOLTage :AC :BANDwidth :BANDwidth? :NULL [:STATe] [:STATe]? :VALue :VALue? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? [:DC] :APERture :APERture? :IMPedance :AUTO :AUTO? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALue? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? Programming Guide for DM3058 6-11
PAGE 232
RIGOL :RESolution :RESolution? 6-12 Programming Guide for DM3058
PAGE 233
RIGOL Incompatible Agilent Commands The following Agilent commands are not supported by RIGOL DM3058 digital multimeter.
PAGE 234
RIGOL [:DATA]? :WINDow2 :TEXT :FEED :FEED? FORMat :BORDer :BORDer? [:DATA] [:DATA]? *TRG *TST? *WAI MEASure :TEMPerature? SAMPle :COUNt :PRETrigger :PRETrigger? :SOURce :SOURce? SYSTem :BEEPer [:IMMediate] :HELP? :LANGuage :LANGuage? :LFRequency? :LFRequency :ACTual? :LOCK :NAME? :OWNer? :RELease :REQuest? :PRESet :SECurity :IMMediate :COMMunicate :ENABle :ENABle? :LAN :AUTOip [:STATe] [:STATe]? :HISTory? :HISTory :CLEar :KEEPalive :KEEPalive? :LIPaddress? :MEDiasense 6-14 Program
PAGE 235
RIGOL :MEDiasense? :NETBios :NETBios? :TELNet :PROMpt :PROMpt? :WMESsage :WMESsage? TRIGger :LEVel :LEVel? :SOURce INTernal[1] NOTE: [1] Not supports the INTernal trigger mode.
PAGE 236
RIGOL Compatible Fluke Commands The following table lists the Fluke commands supported by RIGOL DM3058 digital multimeter. Before using the commands, you should send the CMDSET command (refer to Page 1-5): CMDSET□FLUKE to select Agilent command system.
PAGE 237
RIGOL MAX MAXSET MEAS? MEAS1? MEAS2? MIN MINSET MMCLR MNMX MNMXSET MOD? OHMS OHMS2 RANGE RANGE1? RANGE2? RATE RATE? REL RELCLR RELSET? RELSET VAC VAC2 VAL? VAL1? VAL2? VDC VDC2 WIRE2 WIRE4 Programming Guide for DM3058 6-17
PAGE 238
PAGE 239
RIGOL Chapter 7 Application Examples This chapter introduces how to use the commands to realize the measurements. Users can refer and deepen the understanding to the commands. In order to explain easily, the serial number before each command is used to mark current command but not be the content of command. The contents between ― / * ‖ and ― * / ‖ after each command are explanations which can help users to understand. Before operating, please connect the related test equipment and the tested device.
PAGE 240
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. The multimeter will give a beep (the beeper must be on) when catching the maximum.
PAGE 241
RIGOL The programming steps——Agilent Commands: 0 cmdset□agilent /*Select Agilent commands*/ 1 2 3 4 5 6 *CLS /*Clear the instrument state*/ *IDN? /*Query equipment ID to confirm if the instrument works normally*/ /*Return: RIGOL Technoligies, DM3058, DM3A020080808, 99.00.00.00.00.
PAGE 242
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. The programming steps——RIGOL Commands: 0 1 *RST cmdset□rigol 2 *IDN? /*Query equipment ID to confirm if the instrument works normally*/ /*Return: RIGOL Technoligies, DM3058, DM3A020080808, 99.00.00.00.00.
PAGE 243
RIGOL The programming steps——Agilent Commands: 0 cmdset□agilent /*Select Agilent commands*/ 1 2 3 4 5 6 7 *CLS /*Clear the instrument state*/ *IDN? /*Query equipment ID to confirm if the instrument works normally*/ /*Return: RIGOL Technoligies, DM3058, DM3A020080808, 99.00.00.00.00.
PAGE 244
RIGOL Example 3: dBm Measurement Purpose: Use commands to perform dBm measurement. dBm measurement is frequently used in signal measurement and analysis. The programming steps——RIGOL Commands: 0 1 *RST cmdset□rigol 2 3 4 5 *IDN? /*Query equipment ID to confirm if the instrument works normally*/ /*Return: RIGOL Technoligies, DM3058, DM3A020080808, 99.00.00.00.00.
PAGE 245
RIGOL The programming steps——Agilent Commands: 0 1 *cls cmdset□agilent /*Clear the instrument state*/ /*Select Agilent commands*/ 2 /*Query 3 *IDN? instrument works normally*/ meas:res?□auto 4 5 range; return the measured value*/ /*The returned value is used as the reference resistance for dBm measurement*/ conf:volt:ac□auto /*Enable AC voltage measuring function and use 6 7 8 auto range*/ calc:stat□on calc:func□dbm calc:dbm:ref□ 9 calc:dbm:ref? 10 /*get return value*/ equipment ID to
PAGE 246
RIGOL Example 4: dB Measurement Purpose: Use commands to perform dB measurement. dB measurement unit which is frequently used in electrician, wireless, mechanics, oscillatory surge, mechanical power, acoustics and some other fields.
PAGE 247
RIGOL The programming steps——Agilent Commands: 0 1 *CLS cmdset□agilent /*Clear the instrument state*/ /*Select Agilent commands*/ 2 3 4 *IDN? /*Query equipment ID to confirm if the instrument works normally*/ /*Connect the test leads under AC voltage measure mode*/ conf:volt:ac□ /*Enable AC voltage measuring function and set 5 6 7 the range*/ calc:stat□on calc:func□db calc:db:ref□ 8 9 calc:db:ref? /*Return value*/ /*Enable math operation function*/ /*Enable dB measurement function*/
PAGE 248
RIGOL Example 5: P/F Test Purpose: Use commands to perform a P/F test. P/F operation prompts for the over range voltage signal according to upper/lower limits, and give a beep (the beeper must be on) at the same time.
PAGE 249
RIGOL The programming steps——Agilent Commands: 0 1 *CLS cmdset□agilent /*clear the instrument state*/ /*Select Agilent commands*/ 2 3 4 *IDN? /*Query equipment ID to confirm if the instrument works normally*/ /*Connect the test leads under DC voltage measure mode*/ conf:volt:dc□ /*Set the DC voltage measuring function and the 5 6 7 8 9 range*/ calc:stat□on calc:lim:low□ calc:lim:upp□ calc:func□lim calc:stat□OFF /*Enable math operation function*/ /*Set the lower limit*/ /*Set t
PAGE 250
RIGOL Example 6: Reading Hold ―Reading Hold‖ function can get a stable reading and hold it on the screen even when you remove the test leads.
PAGE 251
RIGOL Example 7: Store and Racall the Presetting Users store current operation state (active function, range, measuring rate and so on) to the storage of DM3058, and recall the state at the next time.
PAGE 252
RIGOL The programming steps——Agilent Commands: 0 1 *CLS cmdset□agilent /*Clear the instrument state*/ /*Select Agilent commands*/ 2 3 4 *IDN? /*Query equipment ID to confirm if the instrument works normally*/ /*Connect the test leads under resistance measurement mode*/ conf:res□20000,2 /*Enable resistance measuring function, set 5 6 7 8 9 range as 20 kΩ, measuring rate as medium*/ calc:stat□on /*Enable math operation function*/ calc:func□aver /*Enable average calculation function*/ *sav□1 /*Store cur
PAGE 253
RIGOL Example 8: Query the Status Register Users can judge current operation error by querying the status register. All the commands about the status register have been discussed in chapter 2. For RIGOL, Fluke and Agilent commands, commands about the status register are available, here we will take RIGOL commands for example.
PAGE 254
RIGOL 23 Return: 0 24 :status:questionable? questionable status register*/ 25 Return: 0 26 :status:operation? status register*/ 27 Return: 256 28 *cls 29 :measure:voltage:dc? measure*/ 30 Return: -1.
PAGE 255
RIGOL /*change the status, execute a single trigger and enter ―wait to trigger‖ status.‖*/ Remarks: 1. Line 2, 28 and 43 clear current status (the value of the event status register and the error queue) of the status register. Sending the ―*cls‖ command before a new command which is used to query the register status can clear then the interferences Existing in the register. 2. Line 3~6 set the enable register of each register.
PAGE 256
RIGOL Example 9: Query the Error Information Users can judge current operation error by querying the status register. All the commands about the status register have been discussed in chapter 2. For RIGOL, Fluke and Agilent commands, commands about the status register are available, here we will take RIGOL commands for example.
PAGE 257
RIGOL 24 Return: Query Unterminated 25 *esr? 26 Return: 4 27 28 29 30 31 32 33 *cls :function:diode :calculate:statistic:min? SYST:ERR? Return: setting unacceptable *esr? Return: 8 /*Beep to alarm*/ Remarks: 1. Line 2, 9, 15, 21 and 27 clear current status (the value of the event status register and the error queue) of the status register. Sending the ―*cls‖ command before a new command which is used to query the status register can clear then the interferences existing in the register. 2.
PAGE 258
PAGE 259
RIGOL Quick Find Index A-Z Common Command System *IDN? 2-3 :function:capacitance :measure? 3-6 3-9 *RST 2-3 :measure 3-9 *ESE 2-3 :measure:voltage:DC? 3-9 :measure:voltage:DC 3-10 *ESR？ 2-4 *PSC 2-4 :measure:voltage:DC:range? *SRE 2-4 :measure:voltage:DC:impedance 3-11 :measure:voltage:DC:filter:state 3-11 *STB? 2-5 *CLS 2-5 :measure:voltage:AC? *OPC 2-5 :measure:voltage:AC *RCL 2-6 :measure:voltage:AC:range? *SAV 2-6 :measure:current:DC? [:]status:operation:condition
PAGE 260
RIGOL :measure:capacitance:range? 3-25 :calculate:statistic:average? :rate:voltage:DC 3-28 :calculate:statistic:count? :rate:voltage:AC 3-28 :calculate:statistic:state :rate:current:DC 3-29 :calculate:REL:offset :rate:current:AC 3-30 :calculate:REL:state :rate:resistance 3-30 :calculate:DB? :rate:fresistance :system:beeper 3-31 :system:beeper:state :system:configure:default :system:language 3-33 :system:display:bright 3-35 3-35 3-36 :system:display:contrast :system:display:invert
PAGE 261
RIGOL WIRE 4-5 CALCulate:DBM:REFerence 5-6 VAC 4-6 CALCulate:NULL:OFFSet 5-7 VDC 4-6 CALCulate:AVERage:AVERage? DB 4-8 CALCulate:AVERage:CLEar 5-7 5-8 DBCLR 4-8 CALCulate:AVERage:COUNt? DBREF 4-9 CALCulate:AVERage:MAXimum? 5-8 CALCulate:AVERage:MINimum? 5-9 HOLD 4-9 HOLDCLR 4-10 HOLDTHRESH MAX MIN 4-10 CONFigure? CONFigure:CURRent:AC 4-12 MNMXSET 5-13 CONFigure:CURRent[:DC] 4-12 CONFigure:DIODe 4-13 MOD? 5-12 CONFigure:CONTinuity 5-13 4-11 MMCLR 4-13 5-14 CONFig
PAGE 262
RIGOL MEASure:CAPacitance? 5-28 MEASure:CONTinuity? 5-28 MEASure:CURRent:AC? 5-29 [SENSe:]CURRent[:DC]:PEAK:STATe 5-55 5-30 MEASure:FRESistance? [SENSe:]CURRent[:DC]:RANGe:AUTO 5-31 5-55 5-32 MEASure:RESistance? [SENSe:]CURRent[:DC]:RANGe[:UPPer] 5-32 MEASure[:VOLTage]:AC? 5-56 5-33 MEASure[:VOLTage][:DC]? MEMory:NSTates? 5-54 5-30 MEASure:FREQuency? MEASure:PERiod? [SENSe:]CURRent[:DC]:NULL:VALue 5-29 MEASure:CURRent[:DC]? MEASure:DIODe? 5-53 [SENSe:]CURRent[:DC]:RESolution 5-34
PAGE 263
RIGOL [SENSe:]VOLTage[:DC]:RESolution [SENSe:]FREQuency:VOLTage:RANGe[:U 5-66 PPer] [SENSe:]VOLTage[:DC]:ZERO:AUTO [SENSe:]PERiod:APERture 5-67 [SENSe:]PERiod:NULL[:STATe] [SENSe:]RESistance:APERture 5-67 5-82 5-83 [SENSe:]PERiod:NULL:VALue 5-84 5-84 [SENSe:]RESistance:APERture:ENABled [SENSe:]PERiod:VOLTage:RANGe:AUTO 5-68 5-85 [SENSe:]RESistance:NPLC 5-69 [SENSe:]PERiod:VOLTage:RANGe[:UPPer] [SENSe:]RESistance:NULL[:STATe] 5-86 5-69 [SENSe:]CAPacitance:NULL[:STATe] [SENSe:]RESistan
PAGE 264
RIGOL TRIGger:DELay 5-100 TRIGger:DELay:AUTO VI TRIGger:SLOPe 5-101 TRIGger:SOURce 5-102 5-102 Programming Guide for DM3058