Rigol DM3058 Programming Manual
  1. Manuals
  2. Brands
  3. Rigol Manuals
  4. Multimeter
  5. DM3058
  6. Programming manual

Rigol DM3058 Programming Manual

Hide thumbs Also See for DM3058:
Table of Contents

Advertisement

Quick Links

See also: User Manual , Quick Manual
Programming Guide
RIGOL
Publication Number: PGC03100-1110
Dec. 2008
DM3058 Digital Multimeter
© 2008 RIGOL Technologies, Inc. All Rights Reserved.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the DM3058 and is the answer not in the manual?

Questions and answers

Related Manuals for Rigol DM3058

Summary of Contents for Rigol DM3058

  • Page 1 Programming Guide RIGOL Publication Number: PGC03100-1110 Dec. 2008 DM3058 Digital Multimeter © 2008 RIGOL Technologies, Inc. All Rights Reserved.
  • Page 3  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 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: Table Of Contents

    Chapter 2 General Commands System ............. 2-1 IEEE488 Commands .................. 2-2 Status Commands ..................2-7 Error Commands ..................2-12 Chapter 3 DM3058 Commands System ............ 3-1 Function Commands .................. 3-2 Measure Commands .................. 3-7 Rate Commands ..................3-27 System Commands .................. 3-32 Utility Commands ..................
  • Page 6 Sample Commands .................. 5-42 Sense Commands ..................5-45 System Commands .................. 5-90 Trigger Commands .................. 5-99 Chapter 6 DM3058 Compatibility Mode ........... 6-1 Compatible Agilent Commands ..............6-2 Incompatible Agilent Commands .............. 6-13 Compatible Fluke Commands ..............6-16 Chapter 7 Application Examples .............. 7-1 Example 1: Reading Statistic ..............

  • Page 7: Chapter 1 Introduction

    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 ...

  • Page 8: Programming Introduction

    ASCII strings embedded inside the output statements of a ―host‖ language available on your computer, so you can control it easily and do the secondary development. About the connection methods of communication interface please refer to the user guide. Programming Guide for DM3058...

  • Page 9: Symbol Instruction

    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 (:). 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.

  • Page 10: Parameter Types

    “:system:beeper:state”, the parameter can only be ON or OFF. ASCII Character String The parameter should be composed of ASCII character string. For example, setting querying IP address command ":utility:interface:LAN:ip”, the parameter can be a self-defined character string. Programming Guide for DM3058...

  • Page 11: Commands Introduction

    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 ...

  • Page 13: Chapter 2 General Commands System

    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...

  • Page 14: 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  Programming Guide for DM3058...
  • Page 15 *ESE□<value>: Set the enable value of Event Status Register. *ESE?: Query the enable value of Event Status Register. <enable_value>: The range is from 0 to 189. Return Format: The query returns the enable value of ESR. Programming Guide for DM3058...
  • Page 16 *PSC?: Query the value of ―power-on status clear‖. Return Format: The querry returns 0 or 1. ―0‖ denotes that the register will not been cleared when power-on; ―1‖ denotes the register will be cleared when power-on. *SRE Command Format: *SRE□<enable_value> *SRE? Programming Guide for DM3058...
  • Page 17 The command queries the condition value of Status Byte Register (STB). Return Format: The query returns the condition value of STB. *CLS Command Format: *CLS Function: The command clears the value from all the Event Registers and the Error Queue information. *OPC Command Format: *OPC *OPC? Programming Guide for DM3058...
  • Page 18 The command saves current instrument status to the selected location. The information have been saved in this location before will be covered (no error). Totally 10 locations are provided for users to save their status information. Programming Guide for DM3058...

  • Page 19: Status Commands

    Questionable Status Register and Operation Status Register in Status Register. About the detailed operation of IEEE488 commands to Event Status Register and Status Byte Register as well as Output Queue and Error Queue, please refer to IEEE488 commands in Chapter2. Programming Guide for DM3058...
  • Page 20 RIGOL Figure 2-1 Schematic diagram of Status Register Programming Guide for DM3058...
  • Page 21 <enable_value>: The range is from 0 to 1841. [:]status:operation:enable?: Query the value of Enable Register from Operation Status Register. Return Format: The query returns the value of Enable Register from Operation Status Register. [:]status:operation[:event]? Command Format: [:]status:operation[:event]? Programming Guide for DM3058...
  • Page 22 The command queries the value of Condition Register from Questionable Status Register. Return Format: The query returns the value of Condition Register from Questionable Status Register. [:]status:questionable:enable Command Format: [:]status:questionable:enable□<enable_value> [:]status:questionable:enable? Function: The command queries the value of Enable Register from Questionable Status 2-10 Programming Guide for DM3058...
  • Page 23 The query returns the value of Enable Register from Questionable Status Register [:]status:questionable[:event]? Command Format: [:]status:questionable[:event]? Function: The command queries the value of Event Register from Questionable Status Register. Return Format: The query returns the value of Event Register from Questionable Status Register. 2-11 Programming Guide for DM3058...

  • Page 24: Error Commands

    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: system:error?  2-12 Programming Guide for DM3058...
  • Page 25 RIGOL 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. 2-13 Programming Guide for DM3058...

  • Page 27: Chapter 3 Dm3058 Commands System

    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. RIGOL DM3058 digital multimeter includes the following commands subsystems: Function Commands ...

  • Page 28: Function Commands

    The commands sets the basic measuring functions which equal to the related selector button of Measure Function in front panel. Which mainly include: :function?  :function:voltage:DC  :function:voltage:AC  :function:current:DC  :function:current:AC  :function:resistance  :function:fresistance  :function:frequency  :function:period  :function:continuity  :function:diode  :function:capacitance  Programming Guide for DM3058...
  • Page 29 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.
  • Page 30 In ―:function?‖, this function is corresponding to the return value ―ACI‖. :function:resistance Command Format: :function:resistance Function: The command enables 2-wire resistance measuring function. Explanation: In ―:function?‖, this function is corresponding to the return value ―RESISTANCE‖. :function:fresistance Command Format: Programming Guide for DM3058...
  • Page 31 In ―:function?‖, this function is corresponding to the return value ―FREQUENCY‖. :function:period Command Format: :function:period Function: The command enables period measuring function. Explanation: In ―:function?‖, this function is corresponding to the return value ―PERIOD‖. 10. :function:continuity Command Format: :function:continuity Function: Programming Guide for DM3058...
  • Page 32 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. Explanation: In ―:function?‖, this function is corresponding to the return value ―CAPACITANCE‖. Programming Guide for DM3058...

  • Page 33: Measure Commands

    RIGOL Measure Commands The commands are used to set measuring function further which equals to select measuring function buttons in DM3058 front panel. Which mainly include: :measure?  :measure  :measure:voltage:DC?  :measure:voltage:DC  :measure:voltage:DC:range?  :measure:voltage:DC:impedance  :measure:voltage:DC:filter:state ...
  • Page 34 RIGOL :measure:diode?  :measure:capacitance?  :measure:capacitance  :measure:capacitance:range?  Programming Guide for DM3058...
  • Page 35 Set measure mode as Manual: :measure□MANU :measure:voltage:DC? Command Format: :measure:voltage:DC? Function: The command queries DC voltage. Explanation: The command is invalid for Dual Display. Return Format: The query returns current DC voltage in the form of scientific notation, for Programming Guide for DM3058...
  • Page 36 100 nV 1000 V 1 mV 20 V 10 μV Examples: To set the measuring range of DC voltage as 200.0 V: :measure:voltage:DC□3 To set the measuring range of DC voltage as minimum. :measure:voltage:DC□MIN or :measure:voltage:DC□0 3-10 Programming Guide for DM3058...
  • Page 37 :measure:voltage:DC:impedance□{10M|10G}: Set the DC voltage impedance as 10 MΩ or >10 GΩ. Remarks: ―>10G‖ is available only when the range of DC is in 200 mV or 2 V. Example： To set the DC voltage impedance as 10 GΩ： :measure:voltage:DC:impedance□10G :measure:voltage:DC:filter:state 3-11 Programming Guide for DM3058...
  • Page 38 :measure:voltage:AC? Function: The command queries AC voltage. Explanation: This command is invalide for Dual Display. Return Format: The query returns the current AC voltage in the form of 3.941713e-01, unit is V. :measure:voltage:AC Command Format: 3-12 Programming Guide for DM3058...
  • Page 39 :measure:voltage:AC□MAX or :measure:voltage:AC□4 10. :measure:voltage:AC:range? Command Format: :measure:voltage:AC:range? Function: The command queries the measuring range of AC voltage. Return Format: The query returns the parameter related to current range: 0, 1, 2, 3 or 4 (see 3-13 Programming Guide for DM3058...
  • Page 40 To set the measuring range of DC current and the resolution at the same time. The measure mode will be changed into manual when setting range. The table 3-3 indicates the current ranges and the resolutions. 3-14 Programming Guide for DM3058...
  • Page 41 The command queries the measuring range of DC current. Return Format: The query returns the parameter related to current range : 0, 1, 2, 3 or 4 (see Table 3-3). 14. :measure:current:AC? Command Format: :measure:current:AC? Function: The command queries AC current. 3-15 Programming Guide for DM3058...
  • Page 42 Table 3-4 The AC current parameters and their meanings Parameter Range 20 mA 200 mA 10 A 20 mA 10 A 200 mA Example: To set the measuring range of AC current as 10.0 A: 3-16 Programming Guide for DM3058...
  • Page 43 The commad queries 2-wire resistance. Explanation: This command is invalide for Dual Display. Return Format: The query returns the current resistance in the form of 8.366031e-05, and unit is Ω. 18. :measure:resistance Command Format: :measure:resistance□{<range>|MIN|MAX|DEF} 3-17 Programming Guide for DM3058...
  • Page 44 19. :measure:resistance:range? Command Format: :measure:resistance:range? Function: The command queries the measuring range of 2-wire resistance. Return Format: The query returns the parameter related to current range : 0, 1, 2, 3, 4, 5 or 6 3-18 Programming Guide for DM3058...
  • Page 45 Parameters: Name Type Range of Values Default <range> discrete {0|1|2|3|4|5|6 } Explanation: The Table 3-5 indicates the parameters and their meanings. Example: Set the measuring range of 4-wire resistance as 200.0 Ω: :measure:fresistance□MIN or :measure:fresistance□0 3-19 Programming Guide for DM3058...
  • Page 46 Display Return Format: The query returns the current frequency in the form of 8.485240e-05, and unit is 24. :measure:frequency Command Format: :measure:frequency□{<range>|MIN|MAX|DEF} Function: The command sets the measuring range of input voltage in frequency measurement. 3-20 Programming Guide for DM3058...
  • Page 47 The range is the same as the measuring range of DC 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). 26. :measure:period? Command Format: :measure:period? Function: The command queries period. 3-21 Programming Guide for DM3058...
  • Page 48 The Table 3-2 indicates the parameters and their ranges. Example: To set the measuring range of input voltage as 20 V: :measure:period□DEF or :measure:period□2 28. :measure:period:range? Command Format: :measure:period:range? Function: The command queries the measuring range of AC voltage in period measurement. 3-22 Programming Guide for DM3058...
  • Page 49 The range is a consecutive Integer among 1 Ω~2000 Ω. The default resistance is 10 Ω. MAX denotes the maximum is 2000 Ω. MIN denotes the minimum is 1 Ω. DEF denotes the default is 10 Ω. 3-23 Programming Guide for DM3058...
  • Page 50 :measure:capacitance? Function: The command queries capacitance. Explanation: This command is invalide for Dual Display. Return Format: The query returns the current capacitance in the form of 8.889030e-05, and unit is F. 33. :measure:capacitance Command Format: 3-24 Programming Guide for DM3058...
  • Page 51 2 nF 200 μF 200 nF Example: To set the measuring range of capacitance as 2 μF: :measure: capacitance□3 34. :measure:capacitance:range? Command Format: :measure:capacitance:range? Function: The command queries the measuring range of capacitance. Return Format: 3-25 Programming Guide for DM3058...
  • Page 52 RIGOL The query returns the parameter related to current range: 0, 1, 2, 3, 4 or 5 (see Table 3-6). 3-26 Programming Guide for DM3058...

  • Page 53: Rate Commands

    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  3-27 Programming Guide for DM3058...
  • Page 54 The query returns the parameter related to current measuring rate: fast, medium or slow. Example: Set the measuring rate of DC voltage as Medium. :rate:voltage:DC□medium :rate:voltage:AC Command Format: :rate:voltage:AC? :rate:voltage:AC□{fast|medium|slow} Function: The command queries or sets the measuring rate of AC voltage. 3-28 Programming Guide for DM3058...
  • Page 55 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 DC current as Medium. :rate:current:DC□medium 3-29 Programming Guide for DM3058...
  • Page 56 :rate:resistance?: Query current measuring rate of 2-wire resistance. 2WR function has to be enabled before execute this command. :rate:resistance□{fast|medium|slow}: Set current measruing rate of 2-wire resistance as Medium. For the range and explanation of parameters please refer 3-30 Programming Guide for DM3058...
  • Page 57 Medium. For the range and 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 measruing rate of 4-wire resistance as Medium. :rate:fresistance□medium 3-31 Programming Guide for DM3058...

  • Page 58: System Commands

    RIGOL System Commands The commands set the system parameters. Which mainly include: :system:beeper  :system:beeper:state  :system:configure:poweron  :system:configure:default  :system:language  :system:format:decimal  :system:format:separate  :system:display:bright  :system:display:contrast  :system:display:invert  3-32 Programming Guide for DM3058...
  • Page 59 ―ON‖ means turn on the beeper, ―OFF‖ means turn off. If the beeper was off by using ―OFF‖, ―:system:beeper‖ is invalid when next test. Return Format: The query returns the beeper state. ―ON‖ returns 1, or else returns 0. Example: To turn on the beeper: :system:beeper:state□ON :system:configure:poweron Command Format: 3-33 Programming Guide for DM3058...
  • Page 60 :system:language□{CHINESE|ENGLISH}: Set the category of system language . ―CHINESE‖ means the system language is chinese, ―ENGLISH‖ means english. Return Format: The query returns chinese or english, denoting respectively current system language is Chinese or English. 3-34 Programming Guide for DM3058...
  • Page 61 :system:format:separate?: Query the format of system data separator. :system:format:separate□{ON | NONE | SPACE}: Set the format of system data separator. ―ON‖ denotes ―,‖ represents the seperator, ―NONE‖ denotes not displaying the spererator, and ―SPACE‖ denotes that a space represents the separator. 3-35 Programming Guide for DM3058...
  • Page 62 The query returns the current bright, and the range is 0~32. :system:display:contrast Command Format: :system:displaycontrast? :system:displaycontrast□<value> Function: The command queries and sets display contrast. Parameters: Name Type Range of Values Default <value> Consecutive Integer 0~32 3-36 Programming Guide for DM3058...
  • Page 63 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. 3-37 Programming Guide for DM3058...

  • Page 64: Utility Commands

    Which mainly include: :utility:interface:LAN:dhcp  :utility:interface:LAN:ip  :utility:interface:LAN:mask  :utility:interface:LAN:gateway  :utility:interface:LAN:dns  :utility:interface:GPIB:address  :utility:interface:RS232:baud  :utility:interface:RS232:parity  3-38 Programming Guide for DM3058...
  • Page 65 Range of Values Default <string> character string self-defined 168.254.0.238 Explanations: :utility:interface:LAN:ip?: Query the IP address. :utility:interface:LAN:ip□<string>: Set the IP address. The parameter <string> is the user-defined character string. Return Format: The query returns the current IP address. 3-39 Programming Guide for DM3058...
  • Page 66 :utility:interface:LAN:gateway? :utility:interface:LAN:gateway□<string> Function: The command queries and sets gateway for LAN connection. Parameters: Name Type Range of Values Default <string> character string self-defined 172.16.3.1 Explanations: :utility:interface:LAN:gateway?: Query the gateway. :utility:interface:LAN:gateway□<string>: Set the gateway. The parameter 3-40 Programming Guide for DM3058...
  • Page 67 :utility:interface:LAN:dns□<string>: Set the DNS address. The parameter <string> is the user-defined DNS address. Return Format: The query returns the current DNS address. :utility:interface:GPIB:address Command Format: :utility:interface:GPIB:address? :utility:interface:GPIB:address□<value> Function: The command queries and sets GPIB address. 3-41 Programming Guide for DM3058...
  • Page 68 Name Type Range of Values <value> discrete {1200|2400|4800|9600|19200|38400|57600|115200} Explanations: :utility:interface:RS232:baud?: Query the RS232 baud rate. :utility:interface:RS232:baud□<value>: Set the RS232 baud rate. Return Format: The query returns the current RS232 baud rate. :utility:interface:RS232:parity Command Format: :utility:interface:RS232:baud? 3-42 Programming Guide for DM3058...
  • Page 69 The query returns the current parity bit: none8bits, odd7bits or even7bits. The range of the return value is the same as the setting parameter. It respectively means ―none parity, 8 bits‖，―odd, 7 bits‖, and ―even, 7 bits‖. 3-43 Programming Guide for DM3058...

  • Page 70: Trigger Commands

    Trigger Commands The commands are used to set the parameters of tigger system . Which mainly include: :trigger:source  :trigger:auto:interval  :trigger:auto:hold  :trigger:auto:hold:sensitivity  :trigger:single  :trigger:single:triggered  :trigger:ext  :trigger:vmcomplete:polar  :trigger:vmcomplete:pulsewidth  3-44 Programming Guide for DM3058...
  • Page 71 400 ms and 2000 ms. The default measuring rate is Slow, so the default is 400 ms. Return Format: The query returns the current interval for auto trigger (the unit is ms). 3-45 Programming Guide for DM3058...
  • Page 72 :trigger:auto:hold:sensitivity?: Query the sensitivity of auto trigger delay. :trigger:auto:hold:sensitivity□{0|1|2|3}: Set the sensitivity of auto trigger delay. The table 3-8 indicates the parameters and the sensitivities. Table 3-8 The auto trigger delay sensitivities Parameter Sensitivity 0.01% 0.1% 3-46 Programming Guide for DM3058...
  • Page 73 Return Format: The query returns the current sampling times. :trigger:single:triggered Command Format: :trigger:single:triggered Function: The command carries out the function of single trigger. Explanation: The command equals to doing a single trigger by manual operation. 3-47 Programming Guide for DM3058...
  • Page 74 :trigger:vmcomplete:polar?: Query the VMC output polar, and the default is positive. :trigger:vmcomplete:polar□{POS|NEG}: Set the VMC output polar. The parameters respectively means ―positive polar‖ and ―negative polar‖. Return Format: The query returns the current VMC output polar: pos or neg. 3-48 Programming Guide for DM3058...
  • Page 75 When the sample is S, the range is 1ms~400ms; when the sample is M, the range is 1ms~200ms; when the sample is F, the range is 1ms~30ms. Return Format: The query returns the current VMC output pulsewidth. 3-49 Programming Guide for DM3058...

  • Page 76: Calculate Commands

     :calculate:statistic:min?  :calculate:statistic:max?  :calculate:statistic:average?  :calculate:statistic:count?  :calculate:statistic:state  :calculate:REL:offset  :calculate:REL:state  :calculate:DB?  :calculate:DB:reference  :calculate:DB:state  :calculate:DBM?  :calculate:DBM:reference  :calculate:DBM:state  :calculate:limit?  :calculate:limit:lower  :calculate:limit:upper  :calculate:limit:state  3-50 Programming Guide for DM3058...
  • Page 77 AVERAGE average calculation TOTAL total calculation LIMIT limit calculation Return Format: The query returns the parameter related to current function of math calculation. See Table 3-9. :calculate:statistic:min? Command Format: :calculate:statistic:min? Function: 3-51 Programming Guide for DM3058...
  • Page 78 The query returns current statistic maximum. :calculate:statistic:average? Command Format: :calculate:statistic:average? Function: The command queries statistic average. Explanation: Only when the AVERAGE calculation is available, the command is just available. Return Format: The query returns current statistic average. 3-52 Programming Guide for DM3058...
  • Page 79 :calculate:statistic:state?: Query the enable state of Stat. operation. :calculate:statistic:state□{ON|OFF}: Enable or disable Stat. operation. Return Format: The query returns the enable state of Stat. Operation: ON or OFF. Example: Disable the Stat. operation. :calculate:statistic:state□OFF :calculate:REL:offset 3-53 Programming Guide for DM3058...
  • Page 80 ± 1200 AC Voltage ± 900 DC Current ± 12 AC Current ± 12 Resistance ± 1.2e+08 Ω Capacitance ± 1.2e-02 Frequency ± 1.2e+06 Return Format: The query returns current offset of NULL calculation. :calculate:REL:state 3-54 Programming Guide for DM3058...
  • Page 81 Command Format: :calculate:DB? Function: The command queries dB value. Explanations: This command is available only when dB operation is on. Return Format: The query returns current dB value. 10. :calculate:DB:reference Command Format: :calculate:DB:reference? :calculate:DB:reference□{<range>|MIN|MAX|DEF} Function: 3-55 Programming Guide for DM3058...
  • Page 82 The command queries or sets the enable state of dB operation. Explanations: :calculate:DB:state?: Query the enable state of dB operation. :calculate:DB:state□{ON|OFF}: Enable or disable dB operation. Return Format: The query returns the enable state of dB operation: ON or OFF. Example: Disable dB operation: :calculate:DB:state□OFF 3-56 Programming Guide for DM3058...
  • Page 83 <value> should be an integer between 2 and 8000, and the unit is Ω. MIN denotes 2Ω, MAX denotes 8000Ω, and DEF denotes 600Ω. Return Format: The query returns current dBm reference resistance. 3-57 Programming Guide for DM3058...
  • Page 84 The command queries the result of P/F calculation. Explanation: When the measuring value is between min and max, the command returns pass, or else fail. Return Format: The query returns whether P/F calculation have passed: PASS or FAIL. 3-58 Programming Guide for DM3058...
  • Page 85 DC Voltage ± 1200 AC Voltage 0~900 DC Current ± 12 AC Current 0~12 Resistance 0~1.2e+08 Ω Capacitance 0~1.2e-02 Frequency 0~1.2e+06 Return Format: The query returns current lower value. 17. :calculate:limit:upper Command Format: :calculate:limit:upper? :calculate:limit:upper□<value> 3-59 Programming Guide for DM3058...
  • Page 86 :calculate: limit:state□{ON|OFF}: Set the state of P/F operation. Return Format: The query returns the enable state of P/F operation: ON or OFF that denotes turning P/F operation on or off. Example: Disable P/F operation: :calculate:limit:state□OFF 3-60 Programming Guide for DM3058...

  • Page 87: Double-Display Commands

    The commands set or query the related parameter for Double Display function. Which mainly include: :function2?  :function2:value1?  :function2:value2?  :function2:voltage:DC  :function2:voltage:AC  :function2:current:DC  :function2:current:AC  :function2:frequency  :function2:period  :function2:resistance  :function2:capacitance  3-61 Programming Guide for DM3058...
  • Page 88 This command is available only when Double Display is on. Return Format: The query returns the measuring value of main display. :function2:value2? Command Format: :function2:value2? Function: This command queries the measuring value of vice display. 3-62 Programming Guide for DM3058...
  • Page 89 The command sets the measuring function of vice display as ACV function. Explanation: Here, the measuring function of main display should be DCV, DCI, ACV, ACI, FREQUENCY or PERIOD only. :function2:current:DC Command Format: :function2:curent:DC Function: 3-63 Programming Guide for DM3058...
  • Page 90 Command Format: :function2:frequency Function: The command sets the measuring function of vice display as Frequency function. Explanation: Here, the measuring function of main display should be ACV, FREQUENCY or PERIOD only. :function2:period Command Format: :function2:period Function: 3-64 Programming Guide for DM3058...
  • Page 91 Here, the measuring function of main display should be RESISTANCE or FRESISTANCE only. 11. :function2:capacitance Command Format: :function2: capacitance Function: The command sets the measuring function of vice display as Capacitance function. Explanation: Here, the measuring function of main display should be CAPACITANCE only. 3-65 Programming Guide for DM3058...

  • Page 93: Chapter 4 Compatible Fluke Commands

    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. The compatible commands mainly include: Function Commands ...

  • Page 94: Function Commands

    The commands enable the basic measuring funtion of the instrument, which similar to the related funciton button in front panel. Which mainly include:   CLR2  CONT  DIODE  FREQ  FUNC  OHMS  WIRE    Programming Guide for DM3058...
  • Page 95 ADC: Enable the DC Current measuring function of main display. ADC2: Enable the DC Current measuring function of vice display. CLR2 Command Format: CLR2 Function: The command clears the measuring value while the measuring function of vice display is enabled. CONT Programming Guide for DM3058...
  • Page 96 FREQ: Enable the Frequency measuring function of main display. FREQ2: Enable the Frequency measuring function of vice display. FUNC Command Format: FUNC1? FUNC2? Function: The command queries the mnemonic of selected funtion on the main or vice Programming Guide for DM3058...
  • Page 97 OHMS: Enable the Resistance measuring function of main display. OHMS2: Enable the Resistance measuring function of vice display. WIRE Command Format: WIRE2 WIRE4 Function: The command switches 2-wire and 4-wire resistance measuring function each other when measuring. Programming Guide for DM3058...
  • Page 98 VDC2 Function: The command enables the DC Voltage measuring function in main and vice display. Explanations: VDC: Enable the DC Voltage measuring function in main display. VDC2: Enable the DC Voltage measuring function in vice display. Programming Guide for DM3058...

  • Page 99: Function Regulator Commands

    Which mainly include:  DBCLR  DBPOWER  DBREF  HOLD  HOLDCLR  HOLDTHRESH   MAXSET   MINSET  MNMX  MNMXSET  MMCLR  MOD?   RELCLR  RELSET  Programming Guide for DM3058...
  • Page 100 2, 4, 8 or 16 ohms and Voltage function has been enabled, or else a execution error will be occur. The unit of readings shown on the main display is W in dB mode. Here is the formula of power: (Volts is measuring value) Volts  Power Programming Guide for DM3058...
  • Page 101 Table 4-1 Reference Resistance Parameter References Parameter References 1000 1200 8000 Return Format: The query returns the selected reference value (see table 4-1). HOLD Command Format HOLD Function: The command enables Touch Hold function of the instrument. Programming Guide for DM3058...
  • Page 102 1%, 10%), any other value will lead an execution error. HOLDTHRESH?: Query the <threshold>. Return Format: The query returns the value of HOLD such as 1, 2, 3 or 4 (0.01%, 0.1%, 1%, 10%). Command Format: 4-10 Programming Guide for DM3058...
  • Page 103 The command enables the MIN mode and set the current reading as minimum. Explanations: If the instrument has already been in this mode, a minimum will be shown directly. In MIN mode, auto range may be forbidden. Auto range may be forbidden. 11. MINSET 4-11 Programming Guide for DM3058...
  • Page 104 In MIN MAX mode, the minimum or maximum could be switched each other and never lose. 13. MNMXSET Command Format: MNMXSET□<numeric1, numeric2> Function: The command enables the MIN MAX mode and separately sets the<numeric1>as minimum or <numeric2> as maximum. Explanations: 4-12 Programming Guide for DM3058...
  • Page 105 If no adjuster is selected, the query returns 0. For example: if selected dB or REL, the return is 40. Returns Format: The query returns the value related to current mode. 16. REL Command Format: 4-13 Programming Guide for DM3058...
  • Page 106 <relative base> could be a signed integer, a signed real number without exponent, or a signed real number with exponent. If <relative base>exceeds the range, an execution error may be occur. Return Format: The query returns the <relative base> in REL mode. 4-14 Programming Guide for DM3058...

  • Page 107: Range And Velocity Commands

    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. Which mainly include: AUTO  FIXED  RANGE  RATE  4-15 Programming Guide for DM3058...
  • Page 108 The current range is to be the selected range. RANGE Command Format: RANGE□<value range> RANGE1? RANGE2? Function: RANGE□<value range>: Set the range of main display as <value range>. These range are related to the range of Function (Current, Voltage, Resistance, and 4-16 Programming Guide for DM3058...
  • Page 109 M (20 readings/s) or F (120 readings/s). The the input state is insensitive, any of other characters will lead to execution error. Return Format: The query returns the character stand for velocity: S (2.5 readings/s), M (20 readings/s) or F (120 readings/s). 4-17 Programming Guide for DM3058...

  • Page 110: Measuring Commands

    RIGOL Measuring Commands The commands query the measuring results and show them on the main or vice display. Which mainly include: MEAS   4-18 Programming Guide for DM3058...
  • Page 111 VAL1?: The command returns the measuring value of main display. If the main 4-19 Programming Guide for DM3058...
  • Page 112 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. 4-20 Programming Guide for DM3058...

  • Page 113: Compare Commands

    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  4-21 Programming Guide for DM3058...
  • Page 114 If Touch Hold mode selected, also exit. COMPHI Command Format: COMPHI□<high value> Function: The command sets the upper limit (HI) of COMP as <high value>. Explanation: <high value> could be either a signed integer or a signed real number. 4-22 Programming Guide for DM3058...
  • Page 115 Explanation: <low value> could be either a signed integer or a signed real number. HOLDCLR Command Format: HOLDCLR Function: The command disables the Touch Hold but except for COMP function and back to normal work. 4-23 Programming Guide for DM3058...

  • Page 117: Chapter 5 Compatible Agilent Commands

    Agilent commands RIGOL DM3058 compatible with mainly include the following commands subsystems: Calculate Commands ...

  • Page 118: Calculate Commands

    The commands are used to set calculation function to do math operation, statistic operation and limit operation. Which mainly include: CALCulate:FUNCtion  CALCulate:STATe  CALCulate:LIMit:LOWer  CALCulate:LIMit:UPPer  CALCulate:DB:REFerence  CALCulate:DBM:REFerence  CALCulate:NULL:OFFSet  CALCulate:AVERage:AVERage?  CALCulate:AVERage:CLEar  CALCulate:AVERage:COUNt?  CALCulate:AVERage:MAXimum?  CALCulate:AVERage:MINimum?  CALCulate:AVERage:PTPeak?  CALCulate:AVERage:SDEViation?  Programming Guide for DM3058...
  • Page 119 The query returns the calcaulation identifier: NULL, DB, DBM, AVERage or LIMit. CALCulate:STATe Command Format: CALCulate:STATe□{OFF | ON} CALCulate:STATe? Function: The command sets or queries the enable state of calculate function. Explanations: CALCulate:STATe□{OFF | ON}: Enable or disable calculation function. Programming Guide for DM3058...
  • Page 120 MIN is -120% max range of current function, MAX is 120% max range of current function, DEF = 0. Return Format: The query returns the lower limit of current calculation function. CALCulate:LIMit:UPPer Command Format: CALCulate:LIMit:UPPer□{<value> | MINimum | MAXimum} Programming Guide for DM3058...
  • Page 121 CALCulate:DB:REFerence Command Format: CALCulate:DB:REFerence□{<value> | MINimum | MAXimum} CALCulate:DB:REFerence?□{MINimum | MAXimum} Function: The command sets or queries the reference value of dB. Parameters: Name Type Range of Values Default <value> Consecutive Real -120 dB~+120 dB Number Programming Guide for DM3058...
  • Page 122 CALCulate:DB:REFerence□{<value> | MINimum | MAXimum}: Set the reference value of dBm. CALCulate:DB:REFerence?□{MINimum | MAXimum}: Query the reference value of dBm. MIN = 2 ohms, MAX = 8000 ohms, DEF = 600 ohms. Return Format: The query returns the reference value of dBm. Programming Guide for DM3058...
  • Page 123 Function: The command queries the average of all statistical data. Explanations: Firstly, do enable calculation function (CALCulate:STATe□ON) and select limit function (CALCulate:FUNCtion□AVERage) to run the command. The average can be queried at any time. Return Format: Programming Guide for DM3058...
  • Page 124 Firstly, do enable calculation function (CALCulate:STATe□ON) and select limit function (CALCulate:FUNCtion□AVERage) to run the command. The number of statistical data can be queried at any time. Return Format: The query returns the number of statistical data. 11. CALCulate:AVERage:MAXimum? Command Format: Programming Guide for DM3058...
  • Page 125 The minimum of statistical data can be queried at any time. Return Format: The query returns the minimum of statistical data. 13. CALCulate:AVERage:PTPeak? Command Format: CALCulate:AVERage:PTPeak? Function: The command queries the peak-to-peak value of statistical data. Programming Guide for DM3058...
  • Page 126 Firstly, do enable calculation function (CALCulate:STATe□ON) and select limit function (CALCulate:FUNCtion□AVERage) to run the command. The standard deviation of statistical data can be queried at any time. Return Format: The query returns the standard deviation of statistical data. 5-10 Programming Guide for DM3058...

  • Page 127: Configure Commands

    The commands are used to set basic measuring functions and related parameters, such as range and accuracy. Which mainly include: CONFigure?  CONFigure:CAPacitance  CONFigure:CONTinuity  CONFigure:CURRent:AC  CONFigure:CURRent[:DC]  CONFigure:DIODe  CONFigure:FREQuency  CONFigure:FRESistance  CONFigure:PERiod  CONFigure:RESistance  CONFigure[:VOLTage]:AC  CONFigure[:VOLTage][:DC]  5-11 Programming Guide for DM3058...
  • Page 128 <range> may be 2 nF (MIN), 20 nF, 200 nF, 2 μF, 20 μF, 200 μF, 10000 μF (MAX), AUTO (autorange) (unit is F). MAX = 0.01, MIN = 0.000 000 002, DEF=0.000 002. <resolution> (unit is F); in default setting, the rate is medium. 5-12 Programming Guide for DM3058...
  • Page 129 <range> may be 20 mA (MIN), 200 mA, 2 A, 10 A (MAX), AUTO (autorange) (unit is A). MAX = 10, MIN = 0. 02. <resolution> (unit is A); in default setting, the rate is medium. CONFigure:CURRent[:DC] Command Format: CONFigure:CURRent[:DC]□ [{<range>|AUTO|MIN|MAX|DEF} [,{<resolution>|MIN|MAX|DEF}]] 5-13 Programming Guide for DM3058...
  • Page 130 The command resets all the diode measuring parameters and trigger parameters as defaults, and sets diode measuring function. CONFigure:FREQuency Command Format: CONFigure:FREQuency□ [{<range>|MIN|MAX|DEF} [,{<resolution>|MIN|MAX|DEF}]] Function: The command resets all the frequency measuring parameters and trigger parameters as defaults, and sets frequency measuring function. 5-14 Programming Guide for DM3058...
  • Page 131 <range> may be 200 Ω (MIN), 2 kΩ, 20 kΩ, 200 kΩ, 2 MΩ, 10 MΩ, 100 MΩ (MAX), AUTO (autorange) (unit is Ω). MAX = 100 000 000, MIN = 200. <resolution> (unit is Ω); in default setting, the rate is medium. CONFigure:PERiod Command Format: CONFigure:PERiod□[{<range>|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF 5-15 Programming Guide for DM3058...
  • Page 132 <range> may be 200 Ω (MIN), 2 kΩ, 20 kΩ, 200 kΩ, 2 MΩ, 10 MΩ, 100 MΩ (MAX), AUTO (autorange) (unit is Ω). MAX = 100 000 000, MIN = 200. <resolution> (unit is Ω); in default setting, the rate is medium. 5-16 Programming Guide for DM3058...
  • Page 133 DC voltage measuring function. Parameters: Name Type Range of Values Default <range> Discrete {200 mV | 2 V | 20 V 20 V | 200 V | 1000 V} <resolution> Discrete {MIN|MAX|DEF} Rate: medium Explanations: 5-17 Programming Guide for DM3058...
  • Page 134 <range> may be 200 mV (MIN), 2 V, 20 V, 200 V, 1000 V (MAX), AUTO (autorange) (unit is V). MAX = 1000, MIN = 0. 2. <resolution> (unit is V); in default setting, the rate is medium. 5-18 Programming Guide for DM3058...

  • Page 135: Data Commands

    RIGOL Data Commands The commands are used to read the data from non-volatile memory, and do quering and deletion. Which mainly include: DATA:DATA?□NVMEM  DATA:DELete□NVMEM  DATA:LAST?  DATA:POINts?□NVMEM  DATA:REMove?  5-19 Programming Guide for DM3058...
  • Page 136 Function: The command deletes the data from non-volatile memory. DATA:LAST? Command Format: DATA:LAST? Function: The command queries the last test result. Return Format: The query returns the last test result. DATA:POINts?□NVMEM Command Format: DATA:POINts?□NVMEM Function: 5-20 Programming Guide for DM3058...
  • Page 137 ―points‖. parameter Explanations: <num_readings> must be set in the command, and can‘t greater than the return value of DATA:POINts?□NVMEM, or be a error. Return Format: The query returns the specified number of data in memory. 5-21 Programming Guide for DM3058...

  • Page 138: Fetch Commands

    Fetch Commands The commands are used to read the data from output buffer of multimeter. Which mainly include: FETCh?  FETCh:CURRent:AC:PTPeak?  FETCh:CURRent[:DC]:PEAK:MAXimum?  FETCh:CURRent[:DC]:PEAK:MINimum?  FETCh:CURRent[:DC]:PTPeak?  FETCh:VOLTage:AC:PTPeak?  FETCh:VOLTage[:DC]:PEAK:MAXimum?  FETCh:VOLTage[:DC]:PEAK:MINimum?  FETCh:VOLTage[:DC]:PTPeak?  5-22 Programming Guide for DM3058...
  • Page 139 Before sending the command, please enable the AC current measuring function, and enble ACI peak-to-peak measuring function with the command ―[SENSe:] CURRent:AC:PEAK:STATe□ON‖. Return Format: The query returns the peak-to-peak value in ACI measurement. FETCh:CURRent[:DC]:PEAK:MAXimum? Command Format: FETCh:CURRent[:DC]:PEAK:MAXimum? Function: 5-23 Programming Guide for DM3058...
  • Page 140 DCI peak-to-peak measuring function with the command ―[SENSe:] CURRent[:DC]:PEAK:STATe□ON‖. Return Format: The query returns min transient current in DCI measurement. FETCh:CURRent[:DC]:PTPeak? Command Format: FETCh:CURRent[:DC]:PTPeak? Function: The command queries the difference between the highest and lowest DC transient current. Explanations: 5-24 Programming Guide for DM3058...
  • Page 141 Command Format: FETCh:VOLTage[:DC]:PEAK:MAXimum? Function: The command queries max transient voltage in DCV measurement. Explanations: Before sending the command, please enable DC voltage measuring function, and enable DCV peak-to-peak measuring function with the command ―[SENSe:] VOLTage[:DC]:PEAK:STATe□ON‖. 5-25 Programming Guide for DM3058...
  • Page 142 Explanations: Before sending the command, please enable DC voltage measuring function, and enable DCV peak-to-peak measuring function with the command ―[SENSe:] VOLTage[:DC]:PEAK:STATe□ON‖. Return Format: The query returns the peak-to-peak value in DCV measurement. 5-26 Programming Guide for DM3058...

  • Page 143: Measure Commands

    The commands are used to enable basic measuring function, and have the same function with the selection keys in front panel. Which mainly include: MEASure:CAPacitance?  MEASure:CONTinuity?  MEASure:CURRent:AC?  MEASure:CURRent[:DC]?  MEASure:DIODe?  MEASure:FREQuency?  MEASure:FRESistance?  MEASure:PERiod?  MEASure:RESistance?  MEASure[:VOLTage]:AC?  MEASure[:VOLTage][:DC]?  5-27 Programming Guide for DM3058...
  • Page 144 The command resets all the continuity measuring parameters and trigger parameters as defaults, and sets continuity measuring function, get the measuring results and send them to output buffer of instrument. Explanations: Enable continuity measuring function, and set the range as 2 kΩ. 5-28 Programming Guide for DM3058...
  • Page 145 The query returns the data in output buffer. MEASure:CURRent[:DC]? Command Format: MEASure:CURRent[:DC]?□ [{<range>|AUTO|MIN|MAX|DEF} [,{<resolution>|MIN|MAX|DEF}]] Function: The command resets all the DC current measuring parameters and trigger parameters as defaults, and sets DC current measuring function, gets the 5-29 Programming Guide for DM3058...
  • Page 146 Return Format: The query returns the data in output buffer. MEASure:FREQuency? Command Format: MEASure:FREQuency?□ [{<range>|MIN|MAX|DEF} [,{<resolution>|MIN|MAX|DEF}]] Function: 5-30 Programming Guide for DM3058...
  • Page 147 2 kΩ | 2 MΩ | 10 MΩ | 100 MΩ} <resolution> Discrete {MIN|MAX|DEF} Rate: medium Explanations: <range> may be 200 Ω (MIN), 2 kΩ, 20 kΩ, 200 kΩ, 2 MΩ, 10 MΩ, 100 MΩ 5-31 Programming Guide for DM3058...
  • Page 148 <range> may be 1 μs~50 ms (unit is s). MAX = 0.05, MIN = 0.000001, DEF = 0.05. <resolution> (unit is A); in default setting, the rate is medium. Return Format: The query returns the data in output buffer. MEASure:RESistance? Command Format: MEASure:RESistance?□ [{<range>|AUTO|MIN|MAX|DEF} [,{<resolution>|MIN|MAX|DEF}]] 5-32 Programming Guide for DM3058...
  • Page 149 Parameters: Name Type Range of Values Default <range> Discrete { 200 mV | 2 V | 20 V 20 V | 200 V | 750 V } <resolution> Discrete {MIN|MAX|DEF} Rate: medium Explanations: 5-33 Programming Guide for DM3058...
  • Page 150 <range> may be 200 mV (MIN), 2 V, 20 V, 200 V, 1000 V (MAX), AUTO (autorange) (unit is V). MAX = 1000, MIN = 0. 2. <resolution> (unit is V); in default setting, the rate is medium. Return Format: The query returns the data in output buffer. 5-34 Programming Guide for DM3058...

  • Page 151: Memory Commands

    Memory Commands The commands are used to access the data in memory, and do quering and deletion. Which mainly include: MEMory:NSTates?  MEMory:STATe:CATalog?  MEMory:STATe:DELete  MEMory:STATe:DELete:ALL  MEMory:STATe:NAME  MEMory:STATe:RECall:AUTO  MEMory:STATe:RECall:SELect  MEMory:STATe:VALid  5-35 Programming Guide for DM3058...
  • Page 152 The command deletes the data from the selected memory location. Explanations: The factory setting can‘t be deleted. If the data in the selected memory location have been deleted, it will lead to a error for trying to restore the data. MEMory:STATe:DELete:ALL 5-36 Programming Guide for DM3058...
  • Page 153 ―STATE_location‖ (location is the serial number of memory location; for example, for the first memory location, the default name is ―STATE_1‖). MEMory:STATe:NAME? □ {1|2|3|4|5}: Query the name of specified memory location. Return Format: The query returns the name of specified memory location. 5-37 Programming Guide for DM3058...
  • Page 154 Before sending the command, do enable automatic recall function (MEMory: STATe:RECall:AUTO□ON). MEMory:STATe:RECall:SELect □ {1|2|3|4|5}: Select the instrument state in specified memory. MEMory:STATe:RECall:SELect?: Query the serial number of memory the selected instrument state is stored in. 5-38 Programming Guide for DM3058...
  • Page 155 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‖. 5-39 Programming Guide for DM3058...

  • Page 156: Output Commands

    RIGOL Output Commands The commands are used to set trigger mode for output signal as rising edge or falling edge. Which mainly includes: OUTPut:TRIGger:SLOPe  5-40 Programming Guide for DM3058...
  • Page 157 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. 5-41 Programming Guide for DM3058...

  • Page 158: Sample Commands

    RIGOL Sample Commands The commands are used to set trigger parameters, such as sample times, delayed time. Which mainly include: SAMPle:SOURce  SAMPle:TIMer  5-42 Programming Guide for DM3058...
  • Page 159 SAMPle:TIMer□{<interval>|MIN|MAX} SAMPle:TIMer?□[{MIN|MAX}] Function: The command sets or queries the sample interval time. Parameters: Name Type Range of Values Default <interval> Consecutive 0.4~3600 Required Real Number parameter Explanations: SAMPle:TIMer□{<interval>|MIN|MAX}: Set the sample interval time. MAX = 5-43 Programming Guide for DM3058...
  • Page 160 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. 5-44 Programming Guide for DM3058...

  • Page 161: Sense Commands

     [SENSe:]CURRent[:DC]:NULL:VALue  [SENSe:]CURRent[:DC]:PEAK:STATe  [SENSe:]CURRent[:DC]:RANGe:AUTO  [SENSe:]CURRent[:DC]:RANGe[:UPPer]  [SENSe:]CURRent[:DC]:RESolution  [SENSe:]CURRent[:DC]:ZERO:AUTO  [SENSe:]VOLTage:AC:NULL[:STATe]  [SENSe:]VOLTage:AC:NULL:VALue  [SENSe:]VOLTage:AC:PEAK:STATe  [SENSe:]VOLTage:AC:RANGe:AUTO  [SENSe:]VOLTage:AC:RANGe[:UPPer]  [SENSe:]VOLTage[:DC]:APERture  [SENSe:]VOLTage[:DC]:APERture:ENABled  [SENSe:]VOLTage[:DC]:IMPedance:AUTO  [SENSe:]VOLTage[:DC]:NPLC  [SENSe:]VOLTage[:DC]:NULL[:STATe]  [SENSe:]VOLTage[:DC]:NULL:VALue  5-45 Programming Guide for DM3058...
  • Page 162  [SENSe:]FRESistance:APERture:ENABled  [SENSe:]FRESistance:NPLC  [SENSe:]FRESistance:NULL[:STATe]  [SENSe:]FRESistance:NULL:VALue  [SENSe:]FRESistance:OCOMpensated  [SENSe:]FRESistance:RANGe:AUTO  [SENSe:]FRESistance:RANGe[:UPPer]  [SENSe:]FRESistance:RESolution  [SENSe:]FREQuency:APERture  [SENSe:]FREQuency:NULL[:STATe]  [SENSe:]FREQuency:NULL:VALue  [SENSe:]FREQuency:VOLTage:RANGe:AUTO  [SENSe:]FREQuency:VOLTage:RANGe[:UPPer]  [SENSe:]PERiod:APERture  [SENSe:]PERiod:NULL[:STATe]  [SENSe:]PERiod:NULL:VALue  [SENSe:]PERiod:VOLTage:RANGe:AUTO  5-46 Programming Guide for DM3058...
  • Page 163 RIGOL [SENSe:]PERiod:VOLTage:RANGe[:UPPer]  [SENSe:]CAPacitance:NULL[:STATe]  [SENSe:]CAPacitance:NULL:VALue  [SENSe:]CAPacitance:RANGe:AUTO  [SENSe:]CAPacitance:RANGe[:UPPer]  5-47 Programming Guide for DM3058...
  • Page 164 Parameter Meaning Parameter Meaning 'volt:dc' 'cap' capacitance 'volt:ac' 'res' 'curr:ac' 'fres' 'curr:dc' 'cont' Continuity 'freq' Frequency 'diod' Diode 'per' Period Return Format: The query returns the parameter related to current measuring function. [SENSe:]CURRent:AC:NULL[:STATe] Command Format: 5-48 Programming Guide for DM3058...
  • Page 165 ± 120% max range Explanations: [SENSe:]CURRent:AC:NULL:VALue□{<value>|MIN|MAX}: Set the NULL value of ACI measurement. MIN is -120% max range of current function, MAX is 120% max range of current function, DEF = 0. [SENSe:]CURRent:AC:NULL:VALue?□[{MIN|MAX}]: Query the NULL value of 5-49 Programming Guide for DM3058...
  • Page 166 The command ―[SENSe:]CURRent:AC:NULL:VALue‖ can be used to set the ACI peak-to-peak value. Return Format: The command returns the enable state of ACI peak-to-peak measuring function. [SENSe:]CURRent:AC:RANGe:AUTO Command Format: [SENSe:]CURRent:AC:RANGe:AUTO□{ON|OFF} [SENSe:]CURRent:AC:RANGe:AUTO? Function: The command sets or queries the enable state of ACI autorange function. 5-50 Programming Guide for DM3058...
  • Page 167 20 mA, MAX = 10 A. Unit is A, so ―200 mA‖ should be input in form of 0.2. [SENSe:]CURRent:AC:RANGe[:UPPer]?□[{MIN|MAX}]: Query the range of ACI measurement. Return Format: The query returns current range of ACI measurement. [SENSe:]CURRent[:DC]:APERture Command Format: [SENSe:]CURRent[:DC]:APERture□{<seconds>|MIN|MAX|DEF} 5-51 Programming Guide for DM3058...
  • Page 168 Explanations: [SENSe:]CURRent[:DC]:APERture:ENABled□{ON|OFF}: Enable or disable DCI interval time function. [SENSe:]CURRent[:DC]:APERture:ENABled?: Query the enable state of DCI interval time function. The commands ―CONFigure:CURRent:DC‖, ―MEASure:CURRent:DC?‖, ―[SENSe:] CURRent[:DC]:NPLC‖ ―[SENSe:]CURRent[:DC]:RESolution‖ used together to disable DCI interval time function (OFF). 5-52 Programming Guide for DM3058...
  • Page 169 Return Format: The query returns the interval time of DCI measurement which is multiples of PLC. 10. [SENSe:]CURRent[:DC]:NULL[:STATe] Command Format: [SENSe:]CURRent[:DC]:NULL[:STATe]□{ON|OFF} [SENSe:]CURRent[:DC]:NULL[:STATe]? Function: The command sets or queries the enable state of DCI NULL function. 5-53 Programming Guide for DM3058...
  • Page 170 120% max range of current function, DEF = 0. [SENSe:]CURRent[:DC]:NULL:VALue?□[{MIN|MAX}]: Query the NULL value of DCI measurement. Before sending the command, do run the command ―[SENSe:]CURRent[:DC]: NULL[:STATe]□ON‖ to enable NULL function. Return Format: The query returns the NULL value of DCI measurement. 5-54 Programming Guide for DM3058...
  • Page 171 [SENSe:]CURRent[:DC]:RANGe:AUTO □ {ON|OFF}: Enable or disable DCI autorange function. If DCI autorange function is ON, the measuring range will be selected automatically according to input signal. [SENSe:]CURRent[:DC]:RANGe:AUTO?: Query the enable state of DCI autorange function. Return Format: 5-55 Programming Guide for DM3058...
  • Page 172 [SENSe:]CURRent[:DC]:RANGe[:UPPer]?□[{MIN|MAX}]: Query the range of DCI measuring function. Return Format: The query returns current range of DCI measuring function. 15. [SENSe:]CURRent[:DC]:RESolution Command Format: [SENSe:]CURRent[:DC]:RESolution□{<resolution>|MIN|MAX|DEF} [SENSe:]CURRent[:DC]:RESolution?□[{MIN|MAX}] Function: The command sets or queries the resolution of DCI measurement. 5-56 Programming Guide for DM3058...
  • Page 173 Explanations: [SENSe:]CURRent[:DC]:ZERO:AUTO□{ON|OFF}: Enable or disable DCI autozero function. [SENSe:]CURRent[:DC]:ZERO:AUTO?: Query the enable state of DCI autozero function. Return Format: The query returns the enable state of DCI autozero function. 17. [SENSe:]VOLTage:AC:NULL[:STATe] Command Format: [SENSe:]VOLTage:AC:NULL[:STATe]□{ON|OFF} [SENSe:]VOLTage:AC:NULL[:STATe]? 5-57 Programming Guide for DM3058...
  • Page 174 ACV measurement. MIN is -120% max range of current function, MAX is 120% max function of current function, DEF = 0. [SENSe:]VOLTage:AC:NULL:VALue?□[{MIN|MAX}]: Query the NULL value of ACV measurement. Before sending the command, do run the command ―[SENSe:]VOLTage:AC:NULL [:STATe]□ON‖ to enable NULL function. 5-58 Programming Guide for DM3058...
  • Page 175 The command sets or queries the enable state of ACV autorange function. Explanations: [SENSe:]VOLTage:AC:RANGe:AUTO □ {ON|OFF}: Enable disable autorange function. If ACV autorange function is ON, the measuring range will be selected according to input signal. 5-59 Programming Guide for DM3058...
  • Page 176 MIN = 200 mV, MAX = 750 V. Unit is V, so ―200 mV‖ should be input in form of 0.2. [SENSe:]VOLTage:AC:RANGe[:UPPer]?□[{MIN|MAX}]: Query the range of ACV measurement. The max range of ACV measurement is 750 V. Return Format: The query returns curent range of ACV measurement. 22. [SENSe:]VOLTage[:DC]:APERture Command Format: [SENSe:]VOLTage[:DC]:APERture□{<seconds>|MIN|MAX|DEF} [SENSe:]VOLTage[:DC]:APERture?□[{MIN|MAX}] 5-60 Programming Guide for DM3058...
  • Page 177 [SENSe:]VOLTage[:DC]:APERture:ENABled□{ON|OFF}: Enable oe disable DCV interval time measuring function. [SENSe:]VOLTage[:DC]:APERture:ENABled?: Query the enable state of DCV interval time measuring function. The command ―CONFigure:VOLTage:DC‖, ―MEASure:VOLTage:DC?‖, ―[SENSe:] VOLTage[:DC]:NPLC‖ and ―[SENSe:]VOLTage[:DC]:RESolution‖ can be used to disable interval time measuring function (OFF). 5-61 Programming Guide for DM3058...
  • Page 178 (OFF). Return Format: The query returns the enable state of DCV input impedance measuring function. 25. [SENSe:]VOLTage[:DC]:NPLC Command Format: [SENSe:]VOLTage[:DC]:NPLC□{<PLCs>|MIN|MAX|DEF} [SENSe:]VOLTage[:DC]:NPLC?□[{MIN|MAX}] Function: The command sets or queries the interval time of DCV measurement which is 5-62 Programming Guide for DM3058...
  • Page 179 [SENSe:]VOLTage[:DC]:NULL[:STATe]?: Query the enable state of DCV NULL function. The command ―[SENSe:]VOLTage[:DC]:NULL:VALue‖ can be used to set NULL value. The commands ―CONFigure:VOLTage:DC‖ and ―MEASure:VOLTage:DC?‖ can be used to disable NULL function (OFF). Return Format: 5-63 Programming Guide for DM3058...
  • Page 180 NULL[:STATe]□ON‖ to enable NULL function. Return Format: The query returns the NULL value of DCV measurement. 28. [SENSe:]VOLTage[:DC]:PEAK:STATe Command Format: [SENSe:]VOLTage[:DC]:PEAK:STATe□{ON|OFF} [SENSe:]VOLTage[:DC]:PEAK:STATe? Function: The command sets or queries the enable state of DCV peak-to-peak measuring function. 5-64 Programming Guide for DM3058...
  • Page 181 [SENSe:]VOLTage[:DC]:RANGe:AUTO?: Query the enable state of DCV autorange measuring function. Return Format: The query returns the enable state of DCV autorange measuring function. 30. [SENSe:]VOLTage[:DC]:RANGe[:UPPer] Command Format: [SENSe:]VOLTage[:DC]:RANGe[:UPPer]□{<range>|MIN|MAX|DEF} [SENSe:]VOLTage[:DC]:RANGe[:UPPer]?□[{MIN|MAX}] 5-65 Programming Guide for DM3058...
  • Page 182 Name Type Range of Values Default <resolution> Discrete {MIN|MAX|DEF} Rate:medium Explanations: [SENSe:]VOLTage[:DC]:RESolution □ {<resolution>|MIN|MAX|DEF}: Set the resolution of DCV measurement. In default setting of <resolution>, the rate is medium. [SENSe:]VOLTage[:DC]:RESolution?□[{MIN|MAX}]: Query the resolution of DCV 5-66 Programming Guide for DM3058...
  • Page 183 Return Format: The query returns the enable state of DCV auto zero measuring function. 33. [SENSe:]RESistance:APERture Command Format: [SENSe:]RESistance:APERture□{<seconds>|MIN|MAX|DEF} [SENSe:]RESistance:APERture?□[{MIN|MAX}] Function: The command sets or queries the interval time of 2-wire resistance measurement. 5-67 Programming Guide for DM3058...
  • Page 184 RESistance:NPLC‖ and ―[SENSe:]RESistance:RESolution‖ can be used to disable interval time measuring function (OFF). 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. 5-68 Programming Guide for DM3058...
  • Page 185 2WR and 4WR will have influence over the setting of resistance. Return Format: The query returns the interval time of 2-wire resistance measurement, return value is multiples of PLC. 36. [SENSe:]RESistance:NULL[:STATe] Command Format: [SENSe:]RESistance:NULL[:STATe]□{ON|OFF} [SENSe:]RESistance:NULL[:STATe]? Function: 5-69 Programming Guide for DM3058...
  • Page 186 2WR measurement. MIN is -120% max range of current function, MAX is 120% max range of current function, DEF = 0. [SENSe:]RESistance:NULL:VALue?□[{MIN|MAX}]: Query the NULL value of 2WR measurement. Before sending the command, do run the command ―[SENSe:]RESistance:NULL [:STATe]□ON‖ to enable NULL function. 5-70 Programming Guide for DM3058...
  • Page 187 2WR and 4WR will have influence over the setting of resistance. Return Format: The query returns the enable state of 2WR offset compensated function. 39. [SENSe:]RESistance:RANGe:AUTO Command Format: [SENSe:]RESistance:RANGe:AUTO□{ON|OFF} [SENSe:]RESistance:RANGe:AUTO? Function: The command sets or queries the enable state of 2WR autorange measuring function. 5-71 Programming Guide for DM3058...
  • Page 188 [SENSe:]RESistance:RANGe[:UPPer]?□[{MIN|MAX}]: Query the range of 2WR 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: 5-72 Programming Guide for DM3058...
  • Page 189 2WR and 4WR will have influence over the setting of resistance. Return Format: The query returns the resolution of 2WR measurement. 42. [SENSe:]RESistance:ZERO:AUTO Command Format: [SENSe:]RESistance:ZERO:AUTO□{ON|OFF} [SENSe:]RESistance:ZERO:AUTO? Function: The command sets or queries the enable state of 2WR autozero measuring function. Explanations: 5-73 Programming Guide for DM3058...
  • Page 190 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 interval time of 4WR measurement. 44. [SENSe:]FRESistance:APERture:ENABled Command Format: 5-74 Programming Guide for DM3058...
  • Page 191 The command sets or queries the interval time of 4WR measurement, input value and returned value are both multiples of PLC. Parameters: Name Type Range of Values Default <PLCs> Discrete {0.006|0.02|0.06|0.2|1|2|10|100} 1 PLC Explanations: [SENSe:]FRESistance:NPLC□{<PLCs>|MIN|MAX|DEF}: Set the interval time of 5-75 Programming Guide for DM3058...
  • Page 192 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 NULL measuring function. 5-76 Programming Guide for DM3058...
  • Page 193 2WR and 4WR will have influence over the setting of resistance. Return Format: The query returns the NULL value of 4WR measurement. 48. [SENSe:]FRESistance:OCOMpensated Command Format: [SENSe:]FRESistance:OCOMpensated□{ON|OFF} [SENSe:]FRESistance:OCOMpensated? Function: The command sets or queries the enable state of 4WR offset compensated function. Explanations: 5-77 Programming Guide for DM3058...
  • Page 194 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 autorange measuring function. 50. [SENSe:]FRESistance:RANGe[:UPPer] Command Format: 5-78 Programming Guide for DM3058...
  • Page 195 The query returns the range of 4WR measurement. 51. [SENSe:]FRESistance:RESolution Command Format: [SENSe:]FRESistance:RESolution□{<resolution>|MIN|MAX|DEF} [SENSe:]FRESistance:RESolution?□[{MIN|MAX}] Function: The command sets or queries the resolution of 4WR measurement. Parameters: Name Type Range of Values Default <resolution> Discrete {MIN|MAX|DEF} Rate: medium 5-79 Programming Guide for DM3058...
  • Page 196 Unit is s, so ―400 ms‖ should be input in form of 0.4. [SENSe:]FREQuency:APERture? □ [{MIN|MAX}]: Query the interval time of frequency measurement. Return Format: The query returns the interval time of frequency measurement. 53. [SENSe:]FREQuency:NULL[:STATe] 5-80 Programming Guide for DM3058...
  • Page 197 The command sets or queries the NULL value of frequency measurement. Parameters: Name Type Range of Values Default <value> Discrete ± 120% max range Explanations: [SENSe:]FREQuency:NULL:VALue□{<value>|MIN|MAX}: Set the NULL value of frequency measurement. MIN is -120% max range of current function, MAX is 5-81 Programming Guide for DM3058...
  • Page 198 The max range of AC voltage is 750 V (rms), voltage RMS is determined by waveform. Return Format: The query returns the enable state of voltage autorange measuring function in frequency measurement. 56. [SENSe:]FREQuency:VOLTage:RANGe[:UPPer] Command Format: [SENSe:]FREQuency:VOLTage:RANGe[:UPPer]□{<range>|MIN|MAX|DEF} [SENSe:]FREQuency:VOLTage:RANGe[:UPPer]?□[{MIN|MAX}] 5-82 Programming Guide for DM3058...
  • Page 199 [SENSe:]PERiod:APERture?□[{MIN|MAX}] Function: The command sets or queries the interval time of period measurement. Parameters: Name Type Range of Values Default <seconds> Consecutive 400 ms~2 s 400 ms Real Number Explanations: [SENSe:]PERiod:APERture□{<seconds>|MIN|MAX|DEF}: Set the interval time 5-83 Programming Guide for DM3058...
  • Page 200 The command ―[SENSe:]PERiod:NULL:VALue‖ can be used to set NULL value. The commands ―CONFigure:PERiod‖ and ―MEASure:PERiod?‖ can be used to disable NULL function (OFF). Return Format: The command returns the enable state of period NULL measuring function. 59. [SENSe:]PERiod:NULL:VALue Command Format: [SENSe:]PERiod:NULL:VALue□{<value>|MIN|MAX} [SENSe:]PERiod:NULL:VALue?□[{MIN|MAX}] Function: 5-84 Programming Guide for DM3058...
  • Page 201 [SENSe:]PERiod:VOLTage:RANGe:AUTO?: Query the enable state of voltage autorange measuring function in period measurement. The max range of AC voltage is 750 V (rms), voltage RMS is determined by waveform. Return Format: 5-85 Programming Guide for DM3058...
  • Page 202 The max range of AC voltage is 750 V (rms), voltage RMS is determined by waveform. Return Format: The query returns the voltage range of period measurement. 62. [SENSe:]CAPacitance:NULL[:STATe] Command Format: [SENSe:]CAPacitance:NULL[:STATe]□{ON|OFF} [SENSe:]CAPacitance:NULL[:STATe]? 5-86 Programming Guide for DM3058...
  • Page 203 MIN is -120% max range of current function, MAX is 120% max range of current function, DEF = 0. [SENSe:]CAPacitance:NULL:VALue?□[{MIN|MAX}]: Query the NULL value of capacitance measurement. Before sending the command, do run the command ―[SENSe:]CAPacitance:NULL 5-87 Programming Guide for DM3058...
  • Page 204 The command ―[SENSe:]CAPacitance:RANGe[:UPPer]‖ can be used to disable autorange function. Return Format: The query returns the enable state of capacitance autorange measuring function. 65. [SENSe:]CAPacitance:RANGe[:UPPer] Command Format: [SENSe:]CAPacitance:RANGe[:UPPer]□{<range>|MIN|MAX|DEF} [SENSe:]CAPacitance:RANGe[:UPPer]?□[{MIN|MAX}] Function: The command sets or queries the range of capacitance measurement. 5-88 Programming Guide for DM3058...
  • Page 205 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. Return Format: The query returns the range of capacitance measurement. 5-89 Programming Guide for DM3058...

  • Page 206: System Commands

    The commands are used to set communication ports and their parameters. Which mainly include: SYStem:BEEPer:STATe  SYSTem:COMMunicate:GPIB[:SELF]:ADDRess  SYSTem:COMMunicate:LAN:BSTatus?  SYSTem:COMMunicate:LAN:CONTrol?  SYSTem:COMMunicate:LAN:DDNS  SYSTem:COMMunicate:LAN:DHCP  SYSTem:COMMunicate:LAN:DNS  SYSTem:COMMunicate:LAN:DOMain  SYSTem:COMMunicate:LAN:GATEway  SYSTem:COMMunicate:LAN:HOSTname  SYSTem:COMMunicate:LAN:IPADdress  SYSTem:COMMunicate:LAN:MAC?  SYSTem:COMMunicate:LAN:SMASk  SYSTem:VERSion?  5-90 Programming Guide for DM3058...
  • Page 207 The command sets or queries the GPIB address. Parameters: Name Type Range of Values Default <address> Discrete 0~30 Explanations: SYSTem:COMMunicate:GPIB[:SELF]:ADDRess □ {<address>}: Set the GPIB address. SYSTem:COMMunicate:GPIB[:SELF]:ADDRess?: Query the GPIB address. Return Format: The query returns the GPIB address. 5-91 Programming Guide for DM3058...
  • Page 208 The command queries the number of Sockets control connection port. Return Format: The query returns the number of Sockets control connection port. SYSTem:COMMunicate:LAN:DDNS Command Format: SYSTem:COMMunicate:LAN:DDNS□{ON|OFF} SYSTem:COMMunicate:LAN:DDNS? Function: The command sets or queries the switch state of dynamic DNS (Domain Name Server). 5-92 Programming Guide for DM3058...
  • Page 209 Gateway to the instrument. When DHCP is OFF, the multimeter will use the static IP address, Subnet Mask, and Default Gateway during power-on. Return Format: The query returns the enable state of DHCP. SYSTem:COMMunicate:LAN:DNS Command Format: SYSTem:COMMunicate:LAN:DNS□"<address>" SYSTem:COMMunicate:LAN:DNS?□[{CURRent|STATic}] 5-93 Programming Guide for DM3058...
  • Page 210 When DHCP is OFF, the multimeter will use the static IP address, Subnet Mask, and Default Gateway during power-on. Return Format: The query returns the static DNS address. SYSTem:COMMunicate:LAN:DOMain Command Format: SYSTem:COMMunicate:LAN:DOMain□"<name>" SYSTem:COMMunicate:LAN:DOMain?□[{CURRent|STATic}] Function: The command sets or queries current domian name of instrument. 5-94 Programming Guide for DM3058...
  • Page 211 SYSTem:COMMunicate:LAN:GATEway□"<address>": Set the default gateway of instrument. SYSTem:COMMunicate:LAN:GATEway? □ [{CURRent|STATic}]: Query default gateway of instrument. ―CURRent‖ denotes the current gateway; ―STATic‖ denotes static gateway. If DHCP is ON, the gateway set by manual is invalid. 5-95 Programming Guide for DM3058...
  • Page 212 SYSTem:COMMunicate:LAN:HOSTname□"<name>": Set the host name. SYSTem:COMMunicate:LAN:HOSTname?□[{CURRent|STATic}]: Query the host name. ―CURRent‖ denotes current host name; ―STATic‖ denotes static host name. Return Format: The command returns current host name of instrument. 11. SYSTem:COMMunicate:LAN:IPADdress Command Format: SYSTem:COMMunicate:LAN:IPADdress□"<address>" SYSTem:COMMunicate:LAN:IPADdress?□[{CURRent|STATic}] Function: 5-96 Programming Guide for DM3058...
  • Page 213 The command queries MAC (Media Access Control) address, that is link layer address. Explanations: SYSTem:COMMunicate:LAN:MAC?: Query the MAC address. The MAC address can be changed. Return Format: The query returns the MAC address in form of XX-XX-XX-XX-XX-XX. For example: 00-01-02-03-04-05. 5-97 Programming Guide for DM3058...
  • Page 214 Default Gateway during power-on. Return Format: The query returns current mask. 14. SYSTem:VERSion? Command Format: SYSTem:VERSion? Function: The commanf queries the SCPI version of instrument. Return Format: The query returns the SCPI version of instrument. For example, ―2007.7‖. 5-98 Programming Guide for DM3058...

  • Page 215: Trigger Commands

    RANGe:AUTO OFF‖ should be used to disable autorange function, the commands ―SENSe:<function>:RANGe, CONFigure‖ or ―MEASure?‖ be used to set range by manual. Which mainly include: TRIGger:COUNt  TRIGger:DELay  TRIGger:DELay:AUTO  TRIGger:SLOPe  TRIGger:SOURce  5-99 Programming Guide for DM3058...
  • Page 216 ―CONFigure‖ or ―MEASure?‖ be used to set range by manual. Return Format: The query returns the trigger times used in multimeter. TRIGger:DELay Command Format: TRIGger:DELay□{<seconds>|MIN|MAX|DEF} TRIGger:DELay?□[{MIN|MAX}] Function: The command sets or queries the delay time between trigger signal and starting measurement. 5-100 Programming Guide for DM3058...
  • Page 217 Explanations: TRIGger:DELay:AUTO□{ON|OFF}: Enable or disable trigger autodelay function. TRIGger:DELay:AUTO?: Query the enable state of trigger autodelay function. The command ―TRIGger:DELay‖ can be used to set delay time as well as disable auto delay function (TRIGger:DELay:AUTO). 5-101 Programming Guide for DM3058...
  • Page 218 ―SENSe:<function>: RANGe‖, ―CONFigure‖ or ―MEASure?‖ be uesd to set range by manual. Return Format: The query returns the external trigger type. TRIGger:SOURce Command Format: TRIGger:SOURce□{IMMediate|EXTernal|BUS} TRIGger:SOURce? Function: 5-102 Programming Guide for DM3058...
  • Page 219 It is suggested that the command ―SENSe:<function>:RANGe:AUTO□OFF‖ should be used to disable autorange function, the command ―SENSe:<function>: RANGe‖, ―CONFigure‖ or ―MEASure?‖ be uesd to set range by manual. Return Format: The query returns current trigger source. 5-103 Programming Guide for DM3058...

  • Page 221: Chapter 6 Dm3058 Compatibility Mode

    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.

  • Page 222: Compatible Agilent Commands

    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. Compatible Agilent Commands...
  • Page 223 :VALue? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? CURRent :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...
  • Page 224 :PEAK :MAXimum? :MINimum? :PTPeak? :VOLTage :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]? Programming Guide for DM3058...
  • Page 225 :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 :SLOPe PERiod :APERture :APERture? :NULL [:STATe] [:STATe]? Programming Guide for DM3058...
  • Page 226 *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]? Programming Guide for DM3058...
  • Page 227 [:UPPer]? [:DC] :APERture :APERture? :APERture :ENABled? :NPLC :NPLC? :NULL [:STATe] [:STATe]? :VALue :VALuE? :PEAK :STATe :STATe? :RANGe :AUTO :AUTO? [:UPPer] [:UPPer]? :RESolution :RESolution? :ZERO :AUTO :AUTO? FREQuency :APERture :APERture? :NULL [:STATe] [:STATe]? :VALue :VALue? :RANGe :LOWer Programming Guide for DM3058...
  • Page 228 [: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? Programming Guide for DM3058...
  • Page 229 [:UPPer] [:UPPer]? :RESolution :RESolution? :ZERO :AUTO :AUTO? VOLTage :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...
  • Page 230 :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 :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]? 6-11 Programming Guide for DM3058...
  • Page 232 RIGOL :RESolution :RESolution? 6-12 Programming Guide for DM3058...

  • Page 233: Incompatible Agilent Commands

    RIGOL Incompatible Agilent Commands The following Agilent commands are not supported by RIGOL DM3058 digital multimeter. Incompatible Agilent Commands ABORt INITiate [:IMMediate] [<max_count>] READ? ROUTe :TERMinals? UNIT :TEMPerature :TEMPerature? CALibration [:ALL]? :ADC? :COUNt? :LFRequency? :LFRequency :ACTual? :SECure :CODE :STATe :STATe?
  • Page 234 :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 Programming Guide for DM3058...
  • Page 235 RIGOL :MEDiasense? :NETBios :NETBios? :TELNet :PROMpt :PROMpt? :WMESsage :WMESsage? TRIGger :LEVel :LEVel? :SOURce INTernal NOTE: [1] Not supports the INTernal trigger mode. 6-15 Programming Guide for DM3058...

  • Page 236: Compatible Fluke Commands

    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. Compatible Fluke Commands...
  • Page 237 RIGOL MAXSET MEAS? MEAS1? MEAS2? MINSET MMCLR MNMX MNMXSET MOD? OHMS OHMS2 RANGE RANGE1? RANGE2? RATE RATE? RELCLR RELSET? RELSET VAC2 VAL? VAL1? VAL2? VDC2 WIRE2 WIRE4 6-17 Programming Guide for DM3058...

  • Page 239: Chapter 7 Application Examples

    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. Programming Guide for DM3058...

  • Page 240: Example 1: Reading Statistic

    /*Reset the instrument for preparing measurement*/ cmdset□rigol /*Select RIGOL commands*/ *IDN? /*Query equipment ID to confirm if the instrument works normally*/ /*Return: RIGOL Technoligies, DM3058, DM3A020080808, 99.00.00.00.00.00*/ :function:voltage:DC /*Enable DC voltage measuring function*/ :measure□AUTO /*Select automatic measurement*/ :calculate:function□max /*Enable maximum statistic calculation function*/...
  • Page 241 /*Select Agilent commands*/ *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.00*/ conf:volt:dc□auto /*Set DC voltage measuring function, auto mode*/ calc:stat□on /*Enable math operation function*/ calc:func□aver /*Set statistic fucntion*/...

  • Page 242: Example 2: Elimination Of Test Impedance Error

    /*Reset the instrument for preparing measurement*/ cmdset□rigol /*Select RIGOL commands*/ *IDN? /*Query equipment ID to confirm if the instrument works normally*/ /*Return: RIGOL Technoligies, DM3058, DM3A020080808, 99.00.00.00.00.00*/ :function:resistance /*Enable resistance measuring function*/ :measure:resistance□MIN /*Set the measuring range of 2-wire resistance to 200 Ω*/...
  • Page 243 *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.00*/ conf:res□min /*Set resistance measure function*/ /*Short-circuit the red and black test lead which are used for resistance measurement*/ calc:stat□on...

  • Page 244: Example 3: Dbm Measurement

    /*Reset the instrument for preparing measurement*/ cmdset□rigol /*Select RIGOL commands*/ *IDN? /*Query equipment ID to confirm if the instrument works normally*/ /*Return: RIGOL Technoligies, DM3058, DM3A020080808, 99.00.00.00.00.00*/ :function:resistance /*Enable resistance measuring function*/ :measure□AUTO /*Set the measuring range to ―AUTO‖*/ :measure:resistance?
  • Page 245 /*Query the measured result*/ 10 /*get return value*/ Remarks: Before sending line 3 command , the instrument should be connected under resistance measure mode. Parameter in command line 9 is the return value in line 3. Programming Guide for DM3058...

  • Page 246: Example 4: Db Measurement

    /*Connect the test leads under AC voltage measure mode*/ :function:voltage:AC /*Enable AC voltage measuring function*/ :measure:voltage:AC□<range> /*Set the measuring range*/ :calculate:function□DB /*Enable dB measuering function*/ :calculate:DB:reference□<value> /*Set the ―dB setting‖ value*/ :calculate:DB? /*Query the measured value*/ /*Return value*/ Programming Guide for DM3058...
  • Page 247 The return value of line 8 command is the ―dB setting‖, not the dB measured result. Users needing a dB measured result are suggested to use RIGOL commands. Programming Guide for DM3058...

  • Page 248: Example 5: P/F Test

    The return value of line 9 command is ―PASS‖ when the input voltage is within the scope of the upper and lower limits, else ―FAIL‖ is returned and a beep is generated (the beeper must be on) . 7-10 Programming Guide for DM3058...
  • Page 249 (the beeper must be on) and no value is returned . Users needing a returned value in P/F test are suggested to use RIGOL commands.

  • Page 250: Example 6: Reading Hold

    /*Set the holding range as ―0.1%‖*/ Remarks: When setting the holding range in line 7 command , multiple thresholds can be set to meet different requirements (refers to the corresponding commands in chapter 3: Trigger subsystem). 7-12 Programming Guide for DM3058...

  • Page 251: Example 7: Store And Racall The Presetting

    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. The programming steps——RIGOL Commands: *RST /*Reset the instrument for preparing measurement*/ cmdset□rigol...
  • Page 252 In line 9 command , input 20 (or any real number between 2~20), thus the range is set as 20V. The second parameter ―max‖ denotes the maximum resolution. The resolution and the measuring rate are relevant, so the rate is set to low. 7-14 Programming Guide for DM3058...

  • Page 253: Example 8: Query The Status Register

    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 44 :trigger:single:triggered /*Execute a single trigger*/ 45 *STB? 46 Return: 0 47 :status:questionable:condition? 48 Return: 0 49 :status:operation:condition? 50 Return: 256 51 *ESR? 52 Return: 0 53 :status:questionable? 54 Return: 0 55 :status:operation? 56 Return: 288 7-16 Programming Guide for DM3058...
  • Page 255 ―*ESR‖, ―:status:questionable?‖ and ―:status:operation?‖ query each event register. The event register will be cleared after each time you query it. The first colon ―:‖ in ―:status:operation?‖ command can be omited for being compatible with RIGOL and Agilent commands. 7-17 Programming Guide for DM3058...

  • Page 256: Example 9: Query The Error Information

    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 For line 10, when run the ―*cls‖ command, a ―*‖ character before the command may cause a ― synax error‖ error. It is a syntax error. For line 16, the parameters should be {RIGOL|AGILENT|FLUKE}, ―abc‖ is invalid, so a ―illegal parameter‖ error generates. It is a execution error.

  • Page 259: Quick Find Index A-Z

    :function:voltage:AC 3-3 :measure:frequency:range? 3-21 :function:current:DC 3-4 :measure:period? 3-21 :function:current:AC 3-4 :measure:period 3-22 :function:resistance 3-4 :measure:period:range? 3-22 :function:fresistance 3-4 :measure:continuity? 3-23 :function:frequency 3-5 :measure:continuity 3-23 :function:period 3-5 :measure:diode? 3-24 :function:continuity 3-5 :measure:capacitance? 3-24 :function:diode 3-6 :measure:capacitance 3-24 Programming Guide for DM3058...

  • Page 260: Compatible Fluke Commands

    Compatible Fluke Commands :trigger:auto:hold:sensitivity 3-46 :trigger:single 3-47 AAC 4-3 :trigger:single:triggered 3-47 ADC 4-3 :trigger:ext 3-48 CLR2 4-3 :trigger:vmcomplete:polar 3-48 CONT 4-3 :trigger:vmcomplete:pulsewidth 3-49 DIODE 4-4 :calculate:function 3-51 FREQ 4-4 :calculate:statistic:min? 3-51 FUNC 4-4 :calculate:statistic:max? 3-52 OHMS 4-5 Programming Guide for DM3058...

  • Page 261: Compatible Agilent Command

    COMPCLR 4-22 FETCh:CURRent:AC:PTPeak? 5-23 COMPHI 4-22 FETCh:CURRent[:DC]:PEAK:MAXimum? COMPLO 4-23 5-23 HOLDCLR 4-23 FETCh:CURRent[:DC]:PEAK:MINimum? 5-24 FETCh:CURRent[:DC]:PTPeak? 5-24 Compatible Agilent Command FETCh:VOLTage:AC:PTPeak? 5-25 CALCulate:FUNCtion 5-3 FETCh:VOLTage[:DC]:PEAK:MAXimum? CALCulate:STATe 5-3 5-25 CALCulate:LIMit:LOWer 5-4 FETCh:VOLTage[:DC]:PEAK:MINimum? CALCulate:LIMit:UPPer 5-4 5-26 CALCulate:DB:REFerence 5-5 FETCh:VOLTage[:DC]:PTPeak? 5-26 Programming Guide for DM3058...
  • Page 262 [SENSe:]VOLTage[:DC]:APERture:ENABl [SENSe:]CURRent:AC:NULL[:STATe] ed 5-61 5-48 [SENSe:]VOLTage[:DC]:IMPedance:AUT [SENSe:]CURRent:AC:NULL:VALue 5-49 O 5-62 [SENSe:]CURRent:AC:PEAK:STATe 5-50 [SENSe:]VOLTage[:DC]:NPLC 5-62 [SENSe:]CURRent:AC:RANGe:AUTO [SENSe:]VOLTage[:DC]:NULL[:STATe] 5-50 5-63 [SENSe:]CURRent:AC:RANGe[:UPPer] [SENSe:]VOLTage[:DC]:NULL:VALue 5-51 5-64 [SENSe:]CURRent[:DC]:APERture 5-51 [SENSe:]VOLTage[:DC]:PEAK:STATe [SENSe:]CURRent[:DC]:APERture:ENABl 5-64 ed 5-52 [SENSe:]VOLTage[:DC]:RANGe:AUTO [SENSe:]CURRent[:DC]:NPLC 5-53 5-65 [SENSe:]CURRent[:DC]:NULL[:STATe] [SENSe:]VOLTage[:DC]:RANGe[:UPPer] 5-65 Programming Guide for DM3058...
  • Page 263 SYSTem:COMMunicate:LAN:DHCP 5-93 [SENSe:]FRESistance:OCOMpensated SYSTem:COMMunicate:LAN:DNS 5-93 5-77 SYSTem:COMMunicate:LAN:DOMain [SENSe:]FRESistance:RANGe:AUTO 5-94 5-78 SYSTem:COMMunicate:LAN:GATEway [SENSe:]FRESistance:RANGe[:UPPer] 5-95 5-78 SYSTem:COMMunicate:LAN:HOSTname [SENSe:]FRESistance:RESolution 5-79 5-96 [SENSe:]FREQuency:APERture 5-80 SYSTem:COMMunicate:LAN:IPADdress [SENSe:]FREQuency:NULL[:STATe] 5-96 5-80 SYSTem:COMMunicate:LAN:MAC? 5-97 [SENSe:]FREQuency:NULL:VALue 5-81 SYSTem:COMMunicate:LAN:SMASk [SENSe:]FREQuency:VOLTage:RANGe:AU 5-98 TO 5-82 SYSTem:VERSion? 5-98 TRIGger:COUNt 5-100 Programming Guide for DM3058...
  • Page 264 RIGOL TRIGger:DELay 5-100 TRIGger:SLOPe 5-102 TRIGger:DELay:AUTO 5-101 TRIGger:SOURce 5-102 Programming Guide for DM3058...

Table of Contents