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: Programming Manual , User Manual
RIGOL
Programming Guide
DM3058/DM3058E Digital Multimeter
Aug. 2012
RIGOL Technologies, Inc.

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 RIGOL Programming Guide DM3058/DM3058E Digital Multimeter Aug. 2012 RIGOL Technologies, Inc.
  • Page 2  Information in this publication replaces all previous corresponding material.  RIGOL 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 3 Summary This manual provides the guidance for remote control programming of DM3058/DM3058E 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/DM3058E multimeter user guide, and been familiar with the RIGOL DM3058/DM3058E multimeter’s...

  • Page 4: Table Of Contents

    Chapter 2 General Commands ..............2-2 IEEE 488 Commands ................. 2-3 STATus Commands ..................2-8 SYSTem Commands ................. 2-13 Chapter 3 RIGOL Command System ............3-1 :CALCulate Commands ................3-2 :FUNCtion Commands ................3-14 :FUNCtion2 Commands ................3-19 :MEASure Commands ................3-25 :RATE Commands ..................
  • Page 5 Example 5: P/F Testing ................6-11 Example 6: Reading Hold ................. 6-13 Example 7: Querying the Status Register ..........6-14 Example 8: Querying the Error Information ..........6-17 Appendix ...................... 1 Incompatible Agilent Commands ..............1 Incompatible Fluke Commands ..............1 Programming Guide for DM3058/DM3058E...

  • Page 6: Chapter 1 Introduction

    RIGOL Chapter 1 Introduction This chapter gives you an instruction in how to operate RIGOL DM3058/DM3058E digital multimeter correctly using remote control programming in connection with the command symbols and parameters, including: Programming Introduction  Symbol Instruction  Parameter Types ...

  • Page 7: Programming Introduction

    The operations that you can do through the commands: Setup the multimeter.  Make measurements.  Acquire data (instrument working condition or measurement results) from the  multimeter. Note*: The GPIB and LAN interfaces are only supported by DM3058. Programming Guide for DM3058/DM3058E...

  • Page 8: Symbol Instruction

    Some parameters or command keywords are enclosed by square bracket ( [ ] ), indicating that which are optional or could be ignored. If no parameter is set, the [MINimum|MAXimum] system will select a default. For example, can be ignored CALCulate:LIMit:LOWer? MINimum|MAXimum] [:EVENt] in command , while STATus:OPERation[:EVENt]? command Programming Guide for DM3058/DM3058E...

  • Page 9: Parameter Types

    The parameters must be ON, OFF, 0 or 1. For example, in command “SYSTem:BEEPer:STATe”. ASCII String The parameter should be a composition of ASCII strings. For example, the parameter of IP address query command “:UTILity:INTErface:LAN:IP” is a user-defined string. Programming Guide for DM3058/DM3058E...

  • Page 10: Commands In This Manual

    RIGOL Commands in this Manual To meet the needs from different users, DM3058/DM3058E provides three command systems: RIGOL commands  Compatible Agilent commands  Compatible Fluke commands  To switch between commands listed above, use the command shown below: Command Format:...

  • Page 11: Chapter 2 General Commands

    RIGOL Chapter 2 General Commands The system applies to both DM3058/DM3058E commands and other compatible commands of Agilent and Fluke, which mainly include: IEEE 488 Commands  STATus Commands  SYSTem CommandsIEEE 48  Programming Guide for DM3058/DM3058E...

  • Page 12: Ieee 488 Commands

    The commands query the basic equipment imformation or perform some common actions, which mainly include: *CLS  *ESE  *ESR?  *IDN?  *OPC  *PSC  *RST  *SRE  *STB?  *TRG  *TST?  *WAI  Programming Guide for DM3058/DM3058E...
  • Page 13 Return Format: The query returns the enable value of ESR. *ESR? Command Format: *ESR? Function: The command queries the event value of Event Status Register (ESR). Return Format: The query returns the current event value of ESR. Programming Guide for DM3058/DM3058E...
  • Page 14 The query returns “1” , which denotes the current operation has been finished. *PSC Command Format: *PSC {0|1} *PSC? Function: The commands set and query the value of “power-on status clear”. Explanations: *PSC {0|1} - Enables or disables the clear operation of register when power-on; Programming Guide for DM3058/DM3058E...
  • Page 15 *SRE <enable_value> - Sets the desired enable value of STB. *SRE? - Queries the enable value of STB. <enable_value> - ranging from 0 to 188. Return Format: The query returns the current enable value of STB. *STB? Command Format: Programming Guide for DM3058/DM3058E...
  • Page 16 The command queries the self-test result. Return Format: The query returns 0 or 1. Thereinto, 0 denotes pass, and 1 denotes failure. 12. *WAI Command Format: *WAI Function: The command waits until all pending operations complete. Programming Guide for DM3058/DM3058E...

  • Page 17: Status Commands

    Questionable Status Register and Operation Status Register in Status Register. About the detailed operations to the Event Status Register and Status Byte Register as well as Output Queue and Error Queue on the basis of IEEE488 commands, please refer to the above section. Programming Guide for DM3058/DM3058E...
  • Page 18 RIGOL Figure 2-1 The Status Register diagram STATus:OPERation:CONDition? Programming Guide for DM3058/DM3058E...
  • Page 19 <enable_value> - Ranging from 0 to 1841. STATus:OPERation:ENABle? - Queries the value of Enable Register from Operation Status Register. Return Format: The query returns the current value of Enable Register in the Operation Status Register queue. STATus:OPERation[:EVENt]? Command Format: STATus:OPERation[:EVENt]? 2-10 Programming Guide for DM3058/DM3058E...
  • Page 20 The command queries the value of Condition Register in the Questionable Status Register queue. Return Format: The query returns the current value of Condition Register in the Questionable Status Register queue. STATus:QUEStionable:ENABle Command Format: STATus:QUEStionable:ENABle <enable value> STATus:QUEStionable:ENABle? 2-11 Programming Guide for DM3058/DM3058E...
  • Page 21 Command Format: STATus:QUEStionable[:EVENt]? Function: The command queries the value of Event Register in the Questionable Status Register queue. Return Format: The query returns the current value of Event Register in the Questionable Status Register queue. 2-12 Programming Guide for DM3058/DM3058E...

  • Page 22: System Commands

    RIGOL SYSTem Commands The commands query and set the beeper, error messages and SCPI edition, which mainly include: SYSTem:BEEPer  SYSTem:BEEPer:STATe  SYSTem:ERRor?  SYSTem:VERSion?  2-13 Programming Guide for DM3058/DM3058E...
  • Page 23 OFF (0) is for close. If the command “SYSTem:BEEPer:STATe OFF” has been used, SYSTem:BEEPer would be invalid when next use. Return Format: The query returns the current beeper state, 1 denotes ON and 0 denotes OFF. Example Opening the beeper. SYSTem:BEEPer:STATe ON 2-14 Programming Guide for DM3058/DM3058E...
  • Page 24 0,"No error". SYSTem:VERSion? Command Format: SYSTem:VERSion? Function: The command queries the SCPI (Standard Commands for Programmable Instruments) version of the instrument. Return Format: The query returns the current SCPI version of the instrument. For example, “1999.0”. 2-15 Programming Guide for DM3058/DM3058E...

  • Page 26: Chapter 3 Rigol Command System

    RIGOL Chapter 3 RIGOL Command System All the RIGOL commands in connection with the return values are ASCII characters with case-insensitive. The system mainly includes the following command subsystems: :CALCulate Commands  :FUNCtion Commands  :FUNCtion2 Commands  :MEASure Commands ...

  • Page 27: Calculate Commands

    :CALCulate:FUNCtion  :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:PF?  :CALCulate:PF:LOWEr  :CALCulate:PF:UPPEr  :CALCulate:PF:STATe  Programming Guide for DM3058/DM3058E...
  • Page 28 The query returns the current selected operation, such as REL, DB, DBM, MIN, MAX, AVERAGE, TOTAL or PF. If more than one operation are used, the query may return a combination such as REL+PF; if all the operations are disabled, the query returns NONE. Programming Guide for DM3058/DM3058E...
  • Page 29 The command queries the maximum of current statistic. Explanations: The command is valid only when MAX operation is enabled. Return Format: The query returns the calculated maximum. :CALCulate:STATistic:AVERage? Command Format: :CALCulate:STATistic:AVERage? Function: The command queries the average of current statistic. Explanations: Programming Guide for DM3058/DM3058E...
  • Page 30 The commands query and set the statistic state. Explanations: :CALCulate:STATistic:STATe? – Queries the current statistic state. :CALCulate:STATistic:STATe {ON|OFF|1|0} – Sets the desired statistic state. Return Format: The query returns the current statistic state ON (1) or OFF (0). Example: Programming Guide for DM3058/DM3058E...
  • Page 31 Table 3-2 Offset range of REL operation Measurement Range Unit items DC Voltage ±1200 AC Voltage ±900 DC Current ±12 AC Current ±12 Resistance ±1.2e+08 Ω Capacitance ±1.2e-02 Frequency ±1.2e+06 Programming Guide for DM3058/DM3058E...
  • Page 32 :CALCulate:REL:STATe OFF :CALCulate:DB? Command Format: :CALCulate:DB? Function: The command queries the dB value of current measurement. Explanations: The command is valid only when dB operation is enabled. Return Format: The query returns the calculated dB value. Programming Guide for DM3058/DM3058E...
  • Page 33 The query returns the current dB reference value. 11. :CALCulate:DB:STATe Command Format: :CALCulate:DB:STATe? :CALCulate:DB:STATe {ON|OFF|1|0} Function: The commands query and set the dB state. Explanations: :CALCulate:DB:STATe? - Queries the current dB state. :CALCulate:DB:STATe {ON|OFF|1|0} - Sets the desired dB state. Programming Guide for DM3058/DM3058E...
  • Page 34 13. :CALCulate:DBM:REFErence Command Format: :CALCulate:DBM:REFErence? :CALCulate:DBM:REFErence {<range>|MIN|MAX|DEF} Function: The commands query and set the dBm reference resistance. Parameter: Name Type Range Default Consecutive <range> 2~8000 real numbe Explanations: :CALCulate:DBM:REFErence? – Queries the reference resistance of dBm. Programming Guide for DM3058/DM3058E...
  • Page 35 The query returns the current dBm state, ON (1) or OFF (0). Example: Turn off the dBm operation. :CALCulate:DBM:STATe OFF 15. :CALCulate:PF? Command Format: :CALCulate:PF? Function: The command queries the result of current PF operation. 3-10 Programming Guide for DM3058/DM3058E...
  • Page 36 See table below for more details. Table 3-3 Ranges of P/F operation Measurent Range Unit items DC Voltage ±1200 AC Voltage 0~900 DC Current ±12 AC Current 0~12 Resistance 0~1.2e+08 Ω Capacitance 0~1.2e-02 Period 1.0e-06~100 Frequency 0~1.2e+06 3-11 Programming Guide for DM3058/DM3058E...
  • Page 37 For more detail, refer to Table 3-3. Return Format: The query returns the current upper limit. 18. :CALCulate:PF:STATe Command Format: :CALCulate:PF:STATe? :CALCulate:PF:STATe {ON|OFF|1|0} Function: The comands query and set the current P/F state. Explanations: :CALCulate:PF:STATe? – Queries the current P/F state. 3-12 Programming Guide for DM3058/DM3058E...
  • Page 38 RIGOL :CALCulate:PF:STATe {ON|OFF|1|0} – Sets the desired P/F state. Return Format: The query returns the current P/F state: ON (1) or OFF (0). Example: Turn off the P/F function: :CALCulate:PF:STATe OFF 3-13 Programming Guide for DM3058/DM3058E...

  • Page 39: Function Commands

    The commands enable the measurement function to be used, which are equal to the corresponding buttons at the front panel, including: :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  3-14 Programming Guide for DM3058/DM3058E...
  • Page 40 :FUNCtion:VOLTage:DC Function: The command enables the DC voltage measurement. Explanations: The query :FUNCtion? will return DCV. :FUNCtion:VOLTage:AC Command Format: :FUNCtion:VOLTage:AC Function: The command enables the AC voltage measurement. Explanations: The query :FUNCtion? will return ACV. 3-15 Programming Guide for DM3058/DM3058E...
  • Page 41 The command enables the AC current measurement. Explanations: The query :FUNCtion? will return ACI. :FUNCtion:RESistance Command Format: :FUNCtion:RESistance Function: The command enables the 2-wire resistance measurement. Explanations: The query :FUNCtion? will return 2WR. :FUNCtion:FRESistance Command Format: :FUNCtion:FRESistance 3-16 Programming Guide for DM3058/DM3058E...
  • Page 42 The query :FUNCtion? will return FREQ. :FUNCtion:PERiod Command Format: :FUNCtion:PERiod Function: The command enables the period measurement. Explanations: The query :FUNCtion? will return PERI. 10. :FUNCtion:CONTinuity Command Format: :FUNCtion:CONTinuity Function: The command enables the continuity measurement. 3-17 Programming Guide for DM3058/DM3058E...
  • Page 43 Command Format: :FUNCtion:DIODe Function: The command enables the diode measurement. Explanations: The query :FUNCtion? will return DIODE. 12. :FUNCtion:CAPacitance Command Format: :FUNCtion:CAPacitance Function: The command enables the capacitance measurement. Explanations: The query :FUNCtion? will return CAP. 3-18 Programming Guide for DM3058/DM3058E...

  • Page 44: Function2 Commands

    The commands set and query the parameters relate to 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:FRESistance  :FUNCtion2:CAPacitance  :FUNCtion2:ON?  :FUNCtion2:CLEar  3-19 Programming Guide for DM3058/DM3058E...
  • Page 45 Explanations: The command is valid only when vice-display is enabled. Return Format: The command returns the measured value of the main-display. :FUNCtion2:VALUe2? Command Format: :FUNCtion2:VALUe2? Function: The command queries the measured value of the vice-display. 3-20 Programming Guide for DM3058/DM3058E...
  • Page 46 The command sets the vice-display to AC voltage measurement. Explanations: The available measurements to main-display could only be DCV, DCI, ACV, ACI, FREQUENCY, PERIOD after this command. :FUNCtion2:CURRent:DC Command Format: :FUNCtion2:CURRent:DC Function: The command sets the vice-display to DC current measurement. 3-21 Programming Guide for DM3058/DM3058E...
  • Page 47 The command sets the vice-display to frequency measurement. Explanations: The available measurements to main-display could only be ACV, FREQUENCY, PERIOD after this command. :FUNCtion2:PERiod Command Format: :FUNCtion2:PERiod Function: The command sets the vice-display to period measurement. 3-22 Programming Guide for DM3058/DM3058E...
  • Page 48 The command sets the vice-display to 4-wire resistance measurement. Explanations: The available measurements to main-display could only be FRESISTANCE after this command. 12. :FUNCtion2:CAPacitance Command Format: :FUNCtion2:CAPacitance Function: The command sets the vice-display to capacitance measurement. 3-23 Programming Guide for DM3058/DM3058E...
  • Page 49 The available measurements to main-display could only be CAPACITANCE after this command. 13. :FUNCtion2:ON? Command Format: :FUNCtion2:ON? Function: The command queries the current vice-display function. 14. :FUNCtion2:CLEar Command Format: :FUNCtion2:CLEar Function: The command disables the vice-display. 3-24 Programming Guide for DM3058/DM3058E...

  • Page 50: Measure Commands

     :MEASure:CURRent:AC  :MEASure:CURRent:AC:RANGe?  :MEASure:RESistance?  :MEASure:RESistance  :MEASure:RESistance:RANGe?  :MEASure:FRESistance?  :MEASure:FRESistance  :MEASure:FRESistance:RANGe?  :MEASure:FREQuency?  :MEASure:FREQuency  :MEASure:FREQuency:RANGe?  :MEASure:PERiod?  :MEASure:PERiod  :MEASure:PERiod:RANGe?  :MEASure:CONTinuity?  :MEASure:CONTinuity  :MEASure:DIODe?  3-25 Programming Guide for DM3058/DM3058E...
  • Page 51 RIGOL :MEASure:CAPacitance?  :MEASure:CAPacitance  :MEASure:CAPacitance:RANGe?  3-26 Programming Guide for DM3058/DM3058E...
  • Page 52 The command selects the measurement type as Auto or Manual. Example: Sets the measurement type to Manual. :MEASure MANU :MEASure:VOLTage:DC? Command Format: :MEASure:VOLTage:DC? Function: The command queries the current measured DC voltage value. Explanations: The command is unavailable in double-display. Return Format: 3-27 Programming Guide for DM3058/DM3058E...
  • Page 53 100 μV 1000 V 1 mV 200 mV 100 nV 1000 V 1 mV 20 V 10 μV Example: Sets the DC votage range to 200V. :MEASure:VOLTage:DC 3 Sets the DC votage range to the minimum. 3-28 Programming Guide for DM3058/DM3058E...
  • Page 54 10 MΩ or >10 GΩ. Note: “ >10 G” is available only when the DC voltage range is 200mV or 2V. Return Format: The query returns 10M or 10G (that is >10G). Example: Sets the DC impedance to 10GΩ. 3-29 Programming Guide for DM3058/DM3058E...
  • Page 55 The command queries the measured AC current value. Explanations: The command is unavailable in double-display. Return Format: The command queries the measured AC voltage value in scientific notation, such as: 3.941713e-01, the unit is V. 3-30 Programming Guide for DM3058/DM3058E...
  • Page 56 Parameter Range 200 mV 20 V 200 V 750 V 200 mV 750 V 20 V Example: Sets the AC voltage range to 750V. :MEASure:VOLTage:AC MAX or :MEASure:VOLTage:AC 4 10. :MEASure:VOLTage:AC:RANGe? Command Format: :MEASure:VOLTage:AC:RANGe? Function: 3-31 Programming Guide for DM3058/DM3058E...
  • Page 57 The corresponding resultion will be set automatically after you set the range. The measurement type will change into “Manual” automaticlly once you set the range. For the parameter range and the corresponding resolution, see table below. 3-32 Programming Guide for DM3058/DM3058E...
  • Page 58 Return Format: The query returns: 0, 1, 2, 3, 4 or 5 (see Table 3-6). 14. :MEASure:CURRent:DC:FILTer[:STATe] Command Format: :MEASure:CURRent:DC:FILTer[:STATe]? :MEASure:CURRent:DC:FILTer[:STATe] {ON|OFF|1|0} Function: The commands query and set the AC filter state under the DC current 3-33 Programming Guide for DM3058/DM3058E...
  • Page 59 The command queries the measured AC current value in scientific notation, such as: 9.29379e-05, the unit is A. 16. :MEASure:CURRent:AC Command Format: :MEASure:CURRent:AC {<range>|MIN|MAX|DEF} Function: The command sets the AC current range. Parameter: Name Type Range Default 3-34 Programming Guide for DM3058/DM3058E...
  • Page 60 The command queries the AC current range. Explanations: The command is valid only when AC current measurement is enabled. Return Format: The command returns: 0, 1, 2, 3 or 4 (see Table 3-7). 18. :MEASure:RESistance? 3-35 Programming Guide for DM3058/DM3058E...
  • Page 61 Type Range Default <range> Discrete {0|1|2|3|4|5|6} Explanations: For the parameter range, see table below. Table 3-8 2-wire resistance range Parameter Range 200 Ω 2 kΩ 20 kΩ 200 kΩ 1 MΩ 10 MΩ 100 MΩ 3-36 Programming Guide for DM3058/DM3058E...
  • Page 62 The command queries the measured 4-wire resistance value. Explanations: The command is unavailable in double-display. Return Format: The command queries the measured 4-wire resistance value in scientific notation, such as: 8.822946e-05, the unit is Ω. 22. :MEASure:FRESistance Command Format: 3-37 Programming Guide for DM3058/DM3058E...
  • Page 63 The query returns: 0, 1, 2, 3, 4, 5 or 6 (see Table 3-8). 24. :MEASure:FREQuency? Command Format: :MEASure:FREQuency? Function: The command queries the measured frequency value. Explanations: The available frequency range is 20Hz~1MHz. The command is unavailable in double-display. 3-38 Programming Guide for DM3058/DM3058E...
  • Page 64 :MEASure:FREQuency DEF 26. :MEASure:FREQuency:RANGe? Command Format: :MEASure:FREQuency:RANGe? Function: The command queries the AC voltage range used under frequency measurement. Explanations: The range here is the same with the range of AC voltage, see Table 3-5. 3-39 Programming Guide for DM3058/DM3058E...
  • Page 65 Default <range > Discrete {0|1|2|3|4} Explanations: The available period range is 1μs~50ms. For the parameter range, refer to Table 3-5. Example: Sets the voltage range to 20V under period measurement. :MEASure:PERiod DEF or :MEASure:PERiod 2 3-40 Programming Guide for DM3058/DM3058E...
  • Page 66 The command queries the measured resistance value under continuity measurement in scientific notation, such as: 8.888000e+03, the unit is Ω. 31. :MEASure:CONTinuity Command Format: :MEASure:CONTinuity {<range>|MIN|MAX|DEF} Function: The command sets the resistance limit under continuity measurement. Parameter: 3-41 Programming Guide for DM3058/DM3058E...
  • Page 67 The query returns the measured voltage on the diode in scientific notation, such as: 4.492510e-04, the unit is V. 33. :MEASure:CAPacitance? Command Format: :MEASure:CAPacitance? Function: The command queries the measured capacitance value. Explanations: The command is unavailable in double-display. 3-42 Programming Guide for DM3058/DM3058E...
  • Page 68 Table 3-9 Capacitance range Parameter Range 2 nF 20 nF 200 nF 2 μF 200 μF 10000 μF 2 nF 10000 μF 200 nF Example: Sets the capacitance range to 2 μF. :MEASure:CAPacitance 3 35. :MEASure:CAPacitance:RANGe? Command Format: 3-43 Programming Guide for DM3058/DM3058E...
  • Page 69 RIGOL :MEASure:CAPacitance:RANGe? Function: The command queries the capacitance range. Return Format: The query returns: 0, 1, 2, 3, 4 or 5 (see Table 3-9). 3-44 Programming Guide for DM3058/DM3058E...

  • Page 70: Rate Commands

    :RATE Commands The commands sets the desired rate of various measurment to such as Slow, Medium and Fast, which mainly include: :RATE:VOLTage:DC  :RATE:VOLTage:AC  :RATE:CURRent:DC  :RATE:CURRent:AC  :RATE:RESistance  :RATE:FRESistance  :RATE:SENSor  3-45 Programming Guide for DM3058/DM3058E...
  • Page 71 The query returns the parameter related to current rate (see Table 3-10). Example: Sets the rate under DC voltage measurement to Medium. :RATE:VOLTage:DC M :RATE:VOLTage:AC Command Format: :RATE:VOLTage:AC? :RATE:VOLTage:AC {F|M|S} Function: The commands query and set the rate of AC voltage measurement. Explanations: 3-46 Programming Guide for DM3058/DM3058E...
  • Page 72 Table 3-10. Return Format: The query returns the parameter related to current rate (see Table 3-10). Example: Sets the rate under DC current measurement to Medium. :RATE:CURRent:DC M 3-47 Programming Guide for DM3058/DM3058E...
  • Page 73 2-wire resistance function is enabled. :RATE:RESistance {F|M|S} - Sets the desired measuring rate of 2-wire resistance. For the range and the explanation of each parameter, see Table 3-10. Return Format: 3-48 Programming Guide for DM3058/DM3058E...
  • Page 74 Return Format: The query returns the parameter related to current 4-wire resistance rate (see Table 3-10). Example: Sets the rate under 4-wire resistance measurement to Medium. :RATE:FRESistance M :RATE:SENSor Command Format: :RATE:SENSor? :RATE:SENSor {M|S} Function: 3-49 Programming Guide for DM3058/DM3058E...
  • Page 75 Table 3-10. Return Format: The query returns the parameter related to current sensor rate (see Table 3-10). Example: Sets the rate under sensor measurement to Medium. :RATE:SENSor M 3-50 Programming Guide for DM3058/DM3058E...

  • Page 76: System Commands

    RIGOL :SYSTem Commands The commands set the desired system parameters, which mainly include: :SYSTem:CONFigure:POWEron  :SYSTem:CONFigure:DEFault  :SYSTem:LANGuage  :SYSTem:FORMat:DECImal  :SYSTem:FORMat:SEPArate  :SYSTem:DISPlay:BRIGht  :SYSTem:DISPlay:CONTrast  :SYSTem:DISPlay:INVErt  3-51 Programming Guide for DM3058/DM3058E...
  • Page 77 The commands query and set the system language to be used. Explanations: :SYSTem:LANGuage? – Queries the current using system language. :SYSTem:LANGuage {CHINESE|ENGLISH} – Sets the desired system language. Return Format: The query returns the CHINESE or ENGLISH. 3-52 Programming Guide for DM3058/DM3058E...
  • Page 78 :SYSTem:FORMat:SEPArate {ON|NONE|SPACE} - Sets the desired delimiter display format. ON denotes to display as default (“,”); NONE denotes the data will be displayed without delimiter; SPACE denotes to display with a space. Return Format: The query returns ON, NONE or SPACE. 3-53 Programming Guide for DM3058/DM3058E...
  • Page 79 The query returns the current screen brightness. :SYSTem:DISPlay:CONTrast Command Format: :SYSTem:DISPlay:CONTrast? :SYSTem:DISPlay:CONTrast <value> Function: The commands query and set the screen contrast. Parameter: Name Type Range Default Consecutive <value> 0~32 Integer Explanations: :SYSTem:DISPlay:CONTrast? – Queries the current screen contrast. 3-54 Programming Guide for DM3058/DM3058E...
  • Page 80 :SYSTem:DISPlay:CONTrast <value> - Sets the desired screen contrast within 0 and 32. Return Format: The query returns the current screen contrast. :SYSTem:DISPlay:INVErt Command Format: :SYSTem:DISPlay:INVErt Function: The command enables the screen to be displayed inversely. 3-55 Programming Guide for DM3058/DM3058E...

  • Page 81: Trigger Commands

    RIGOL :TRIGger Commands The commands set the parameters relate to 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-56 Programming Guide for DM3058/DM3058E...
  • Page 82 :TRIGger:AUTO:INTErval <value> – Sets the desired interval of auto trigger. Different rate has different intervals: In Fast measruement, the default interval is 8 ms and the available range is within 8 ms and 2000 ms; 3-57 Programming Guide for DM3058/DM3058E...
  • Page 83 :TRIGger:AUTO:HOLD {ON|OFF|1|0} – Sets the desired hold state under auto trigger. Return Format: The query returns the ON (1) or OFF (0). :TRIGger:AUTO:HOLD:SENSitivity Command Format: :TRIGger:AUTO:HOLD:SENSitivity? :TRIGger:AUTO:HOLD:SENSitivity {<value>|MIN|MAX|DEF} Function: The commands query and set the delay sensitive of auto trigger. 3-58 Programming Guide for DM3058/DM3058E...
  • Page 84 :TRIGger:SINGle? – Queries the number of sample under current single trigger. :TRIGger:SINGle {<value>|MIN|MAX|DEF} – Sets the required sample number in single trigger mode. Parameter: Name Type Range Default Consecutive <value> 1~2000 Integer Return Format: The query returns the number of sample under current single trigger. 3-59 Programming Guide for DM3058/DM3058E...
  • Page 85 Return Format: The query returns: RISE, FALL, HIGH or LOW. :TRIGger:VMComplete:POLAr Command Format: :TRIGger:VMComplete:POLAr? :TRIGger:VMComplete:POLAr {POS|NEG} Function: The commands query and set the VMC output polar. 3-60 Programming Guide for DM3058/DM3058E...
  • Page 86 S, the range is 1~399(ms); when the sample rate is M, the range is 1~49(ms); and when the sample rate is F, the range is 1~7(ms). Return Format: The query returns the VMC output pulsewidth time. 3-61 Programming Guide for DM3058/DM3058E...

  • Page 87: Utility Commands

    The commands mainly include: :UTILity:INTErface:LAN:DHCP*  :UTILity:INTErface:LAN:AUTOip*  :UTILity:INTErface:LAN:MANUip*  :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  Note*: The GPIB and LAN interfaces are only supported by DM3058. 3-62 Programming Guide for DM3058/DM3058E...
  • Page 88 The commands query and set the state of Auto IP. Explanations: :UTILity:INTErface:LAN:AUTOip? – Queries if Auto IP is enabled. :UTILity:INTErface:LAN:AUTOip {ON|OFF|1|0} – Sets the state of Auto IP to be used. Return Format: The query returns ON (1) or OFF (0). :UTILity:INTErface:LAN:MANUip Command Format: 3-63 Programming Guide for DM3058/DM3058E...
  • Page 89 String User-defined 168.254.0.238 Explanations: :UTILity:INTErface:LAN:IP? – Queries the current IP address. :UTILity:INTErface:LAN:IP <string> - Sets the IP address of the multimeter. Parameter <ip_address> is for user-defined. Return Format: The query returns the current IP address. 3-64 Programming Guide for DM3058/DM3058E...
  • Page 90 The commands query and set the gateway for LAN connection. Parameter: Name Type Range Default <ip_address> String User-defined 172.16.3.1 Explanations: :UTILity:INTErface:LAN:GATEway? – Queries the current gateway. :UTILity:INTErface:LAN:GATEway <ip_address> – Ses the desired gateway. Parameter <ip_address> is for user-defined. 3-65 Programming Guide for DM3058/DM3058E...
  • Page 91 Parameter <ip_address> is for user-defined. Return Format: The query returns the current DNS server address. :UTILity:INTErface:GPIB:ADDRess Command Format: :UTILity:INTErface:GPIB:ADDRess? :UTILity:INTErface:GPIB:ADDRess <value> Function: The commands query and set the GPIB address. Parameter: Name Type Range Default 3-66 Programming Guide for DM3058/DM3058E...
  • Page 92 <value> Discrete {1200|2400|4800|9600|19200|38400|57600|115200} Explanations: :UTILity:INTErface:RS232:BAUD? – Query the current baud rate. :UTILity:INTErface:RS232:BAUD <value> - Sets the desired interface baud rate Return Format: The query returns the current baud rate. 10. :UTILity:INTErface:RS232:PARIty Command Format: :UTILity:INTErface:RS232:PARIty? :UTILity:INTErface:RS232:PARIty {NONE|ODD|EVEN} 3-67 Programming Guide for DM3058/DM3058E...
  • Page 93 NONE, ODD, EVEN denotes “no even-odd check, 8 digits of data bit”, “odd check, 7 digits of data bit” and “even check, 7 digits of data bit”, separately. Return Format: The query returns: NONE8BITS, ODD7BITS or EVEN7BITS. 3-68 Programming Guide for DM3058/DM3058E...

  • Page 94: Chapter 4 Compatible Agilent Commands

    CONFigure Commands  DATA Commands  DISPlay Commands  FETCh? Commands  INITiate Commands  INPut Commands  MEASure Commands  READ? Commands  ROUTe Commands  SENSe Commands  SAMPle Commands  TRIGger Commands  Programming Guide for DM3058...

  • Page 95: Calculate Commands

    RIGOL CALCulate Commands The commands set the calculation operations, 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:COUNt?  CALCulate:AVERage:MAXimum?  CALCulate:AVERage:MINimum?  Programming Guide for DM3058/DM3058E...
  • Page 96 Average operation LIMIT Limit operation (PF operation) Note: The operation NULL and LIMIT in Agilent commands system is equal to REL and PF operation in DM3058/DM3058E, separately. Return Format: The query returns NULL, DB, DBM, AVER or LIM. CALCulate:STATe Command Format:...
  • Page 97 MIN denotes the minimum range (-120% of MAX range) of current measurement. MAX denotes the maximum range (120% of MAX range) of current measurement. Return Format: The query returns the lower limit of current measurement. CALCulate:LIMit:UPPer Command Format: Programming Guide for DM3058/DM3058E...
  • Page 98 The query returns the upper limit of current measurement. CALCulate:DB:REFerence Command Format: CALCulate:DB:REFerence {<value>|MINimum|MAXimum} CALCulate:DB:REFerence? [MINimum|MAXimum] Function: The command commands set and query the dB reference value. Parameter: Name Type Range Default <value> Consecutive Integer -120 dB~+120 dB Programming Guide for DM3058/DM3058E...
  • Page 99 CALCulate:DB:REFerence {<value>|MINimum|MAXimum} - Sets the desired dBm reference value. CALCulate:DB:REFerence? [MINimum|MAXimum] - Queries the current dBm reference value. MIN = 2Ω; MAX = 8000Ω; DEF = 600Ω. Return Format: The query returns the current dBm reference value. Programming Guide for DM3058/DM3058E...
  • Page 100 The query returns the current NULL offset. CALCulate:AVERage:AVERage? Command Format: CALCulate:AVERage:AVERage? Function: The command queries the average of all data after calculation. Explanations: The command is valid only when the calculation function (CALCulate:FUNCtion AVERage) is enabled under calculation is active (CALCulate:STATe ON). Programming Guide for DM3058/DM3058E...
  • Page 101 The command is valid only when the calculation function (CALCulate:FUNCtion AVERage) is enabled under calculation is active (CALCulate:STATe ON). Note the maximum data could be read any time. Return Format: The query returns the maximum statistic value of current measurement. Programming Guide for DM3058/DM3058E...
  • Page 102 The command is valid only when the calculation function (CALCulate:FUNCtion AVERage) is enabled under calculation is active (CALCulate:STATe ON). Note the minimum data could be read any time. Return Format: The query returns the minimum statistic value of current measurement. Programming Guide for DM3058/DM3058E...

  • Page 103: Configure Commands

    The commands set the basic measurement functions and related parameters, such as range and accuracy, which mainly include: CONFigure:VOLTage:DC  CONFigure:VOLTage:AC  CONFigure:CURRent:DC  CONFigure:CURRent:AC  CONFigure:RESistance  CONFigure:FRESistance  CONFigure:FREQuency  CONFigure:PERiod  CONFigure:CONTinuity  CONFigure:DIODe  CONFigure?  4-10 Programming Guide for DM3058/DM3058E...
  • Page 104 100ppm x range 0.02 NPLC* 10ppm x range 0.2 NPLC 3ppm x range 1 NPLC 1ppm x range 10 NPLC 0.3ppm x range 100 NPLC *Note: 1PLC is equal to 0.02s. CONFigure:VOLTage:AC Command Format: CONFigure:VOLTage:AC {<range>|MIN|MAX|DEF},{<resolution>|MIN|MAX|DEF} Function: Programming Guide for DM3058/DM3058E 4-11...
  • Page 105 Refer to Table 4-2 1ppm x range Explanations: The unit is A. For <range>: MIN = 0. 0002 (200Μa); MAX = 10, DEF=AUTO. <resolution> relates to both the measurement rate and integration time, see Table 4-2. 4-12 Programming Guide for DM3058/DM3058E...
  • Page 106 The command presets the multimeter as specified range and resolution for 2-wire resistance measurement, but does not start the measurement. Parameter: Name Type Range Default <range> Discrete {200 Ω|2 kΩ|20 kΩ|200 kΩ AUTO |2 MΩ|10 MΩ|100 MΩ|AUTO} <resolution> Discrete Refer to Table 4-2 1ppm x range Programming Guide for DM3058/DM3058E 4-13...
  • Page 107 For <range>: MIN = 200; MAX = 100 000 000, DEF=AUTO. <resolution> relates to both the measurement rate and integration time, see Table 4-2. CONFigure:FREQuency Command Format: CONFigure:FREQuency {<range>|MIN|MAX|DEF},{<resolution>|MIN|MAX|DEF} Function: The command presets the multimeter as specified range and resolution for 4-14 Programming Guide for DM3058/DM3058E...
  • Page 108 1ppm x range Explanations: The units is s. The <range> may be 1 μs~50 ms, thereinto, MAX = 0.05, MIN = 0.000001, DEF = 0.05. Note that the multimeter uses one “range” for all inputs between 1μs-50ms. Programming Guide for DM3058/DM3058E 4-15...
  • Page 109 The command queries the current configuration of instrument, but does not start the measurement. Return Format: The query returns a string with quotes, by a composition of <function>, <range> and <resolution>, for example: "VOLT:DC 2.000000E-01,2.000000E-07" 4-16 Programming Guide for DM3058/DM3058E...

  • Page 110: Data Commands

    RIGOL DATA Commands The commands access the data from non-volatile memory, and do some operations such as query and delete, which mainly include: DATA:FEED RDG_STORE, {"CALCulate"|""}  DATA:FEED?  DATA:POINts?  Programming Guide for DM3058/DM3058E 4-17...
  • Page 111 The command queries the storage state of readings, the returned value is "CALC" or "". Note that the query only returns “CALC” as restricted by working principle. DATA:POINts? Command Format: DATA:POINts? Function: The command queries the number of readings in the internal memory of the multimeter. 4-18 Programming Guide for DM3058/DM3058E...

  • Page 112: Display Commands

    Command Format: DISPlay:TEXT:CLEar Function: command clears information shown sending command DISPlay:TEXT <quoted string>. DISPlay Command Format: DISPlay {OFF|ON} DISPlay? Function: DISPlay {OFF|ON} – Enables or disables the display. DISPlay? – Queries the current display state. Programming Guide for DM3058/DM3058E 4-19...

  • Page 113: Fetch? Commands

    RIGOL FETCh? Commands FETCh? Command Format: FETCh? Function: The command transfers the readings stored in internal memory to the output buffer. 4-20 Programming Guide for DM3058/DM3058E...

  • Page 114: Initiate Commands

    The command switches the trigger state “Idle” into “Wait-for-trigger”. When the command is received, the multimeter will start measuring if the trigger condition is met. The readings are stored in internal memory (up to 512 readings). Programming Guide for DM3058/DM3058E 4-21...

  • Page 115: Input Commands

    INPut:IMPedance Command Format: INPut:IMPedance:AUTO {OFF|ON} INPut:IMPedance:AUTO? Function: The command enables or disables the auto resistance function. Explanations: Being restricted by working principle, command INPut:IMPedance:AUTO {OFF|ON} only responsed without practical operation; command INPut:IMPedance:AUTO? Only returns “0”. 4-22 Programming Guide for DM3058/DM3058E...

  • Page 116: Measure Commands

    The query returns the data stored in output buffer. MEASure:VOLTage:DC?  MEASure:VOLTage:AC?  MEASure:CURRent:DC?  MEASure:CURRent:AC?  MEASure:RESistance?  MEASure:FRESistance?  MEASure:FREQuency?  MEASure:PERiod?  MEASure:CONTinuity?  MEASure:DIODe?  Programming Guide for DM3058/DM3058E 4-23...
  • Page 117 AC voltage measurement, and then sends the readings to the output buffer. For the parameter range and other related information, refer to CONFigure:VOLTage:AC. Return Format: The query returns the data stored in output buffer. MEASure:CURRent:DC? Command Format: MEASure:CURRent:DC? {<range>|MIN|MAX|DEF},{<resolution>|MIN|MAX|DEF} Function: 4-24 Programming Guide for DM3058/DM3058E...
  • Page 118 2-wire resistance measurement, and then sends the readings to the output buffer. For the parameter range and other related information, refer to CONFigure:RESistance. Return Format: The query returns the data stored in output buffer. Programming Guide for DM3058/DM3058E 4-25...
  • Page 119 For the parameter range and other related information, refer to CONFigure:FREQuency. Return Format: The query returns the data stored in output buffer. MEASure:PERiod? Command Format: MEASure:PERiod? {<range>|MIN|MAX|DEF},{<resolution>|MIN|MAX|DEF} Function: Presets the multimeter as specified range and resolution and executes period 4-26 Programming Guide for DM3058/DM3058E...
  • Page 120 The query returns the data stored in output buffer. 10. MEASure:DIODe? Command Format: MEASure:DIODe? Function: The command presets and execute the diode measurement and then sends the readings to the output buffer. Return Format: The query returns the data stored in output buffer. Programming Guide for DM3058/DM3058E 4-27...

  • Page 121: Read? Commands

    READ? Function: The command switches the trigger state “Idle” into “Wait-for-trigger”. When the command is received, the multimeter will start measuring if the trigger condition is met. The readings are transfered to the output buffer. 4-28 Programming Guide for DM3058/DM3058E...

  • Page 122: Route Commands

    RIGOL ROUTe Commands ROUTe:TERMinals? Command Format: ROUTe:TERMinals? Function: The command queries the terminal (the port at the front or real panel) under using. Being restricted by the terminal requirements, the query only returns “FRON”. Programming Guide for DM3058/DM3058E 4-29...

  • Page 123: Sense Commands

     [SENSe:]FRESistance:RANGe:AUTO  [SENSe:]FREQuency:VOLTage:RANGe:AUTO  [SENSe:]PERiod:VOLTage:RANGe:AUTO  [SENSe:]VOLTage:DC:RESolution  [SENSe:]VOLTage:AC:RESolution  [SENSe:]CURRent:DC:RESolution  [SENSe:]CURRent:AC:RESolution  [SENSe:]RESistance:RESolution  [SENSe:]FRESistance:RESolution  [SENSe:]VOLTage:DC:NPLC  [SENSe:]CURRent:DC:NPLC  [SENSe:]RESistance:NPLC  [SENSe:]FRESistance:NPLC  [SENSe:]FREQuency:APERture  [SENSe:]PERiod:APERture  [SENSe:]DETector:BANDwidth  [SENSe:]ZERO:AUTO  4-30 Programming Guide for DM3058/DM3058E...
  • Page 124 Period VOLTage:AC AC voltage RESistance CURRent:AC AC current FRESistance CURRent:DC DC current CONTinuity Continuity FREQuency Frequency DIODe Diode Return Format: The query returns the current measurement function. [SENSe:]VOLTage:DC:RANGe Command Format: [SENSe:]VOLTage:DC:RANGe {<range>|MINimum|MAXimum} [SENSe:]VOLTage:DC:RANGe? [MINimum|MAXimum] Function: Programming Guide for DM3058/DM3058E 4-31...
  • Page 125 AC voltage measurement from {200 mV|2 V|20 V|200 V|750 V}; thereinto, MIN = 200 mV, MAX = 750 V and the unit is V. If a 200 mV range is required, enter 0.2 as its parameter. 4-32 Programming Guide for DM3058/DM3058E...
  • Page 126 MIN = 200 µA, MAX = 10 A and the unit is A. If a 200 mA range is required, enter 0.2 as its parameter. [SENSe:]CURRent:DC:RANGe? [MINimum|MAXimum] – Queries the range of DC current measurement. Return Format: The query returns the range of DC current measurement. [SENSe:]CURRent:AC:RANGe Command Format: [SENSe:]CURRent:AC:RANGe {<range>|MINimum|MAXimum} [SENSe:]CURRent:AC:RANGe? [MINimum|MAXimum] Programming Guide for DM3058/DM3058E 4-33...
  • Page 127 2-wire resistance measurement from {200 Ω|2 kΩ|20 kΩ|200 kΩ|2 MΩ|10 MΩ|100 MΩ}; thereinto, MIN = 200 Ω, MAX = 100 MΩ and the unit is Ω. If a 2 kΩ range is required, enter 2000 as its parameter. 4-34 Programming Guide for DM3058/DM3058E...
  • Page 128 Both 2-wire and 4-wire resistance measurements are influenced by this command. All the commands of 2-wire and 4-wire resistance will have influence over the setting of resistance. Return Format: The query returns the range of 4-wire resistance measurement. Programming Guide for DM3058/DM3058E 4-35...
  • Page 129 Return Format: The query returns the voltage range under frequency measurement. [SENSe:]PERiod:VOLTage:RANGe Command Format: [SENSe:]PERiod:VOLTage:RANGe {<range>|MINimum|MAXimum} [SENSe:]PERiod:VOLTage:RANGe? [MINimum|MAXimum] Function: The commands set and query the voltage range under period measurement. 4-36 Programming Guide for DM3058/DM3058E...
  • Page 130 If choose ON, the instrument will select a measurement range according to the signal inputted. [SENSe:]VOLTage:DC:RANGe:AUTO? – Queries the current auto range state of DC voltage measurement. Return Format: The query returns auto range state. Programming Guide for DM3058/DM3058E 4-37...
  • Page 131 If choose ON, the instrument will select a measurement range according to the signal inputted. [SENSe:]CURRent:DC:RANGe:AUTO? – Queries the current auto range state of DC current measurement. Return Format: The query returns the auto range state of DC current measurement. 4-38 Programming Guide for DM3058/DM3058E...
  • Page 132 [SENSe:]RESistance:RANGe:AUTO? – Queries the current auto range state of 2-wire resistance measurement. Both 2-wire and 4-wire resistance measurements are influenced by this command. All the commands of 2-wire and 4-wire resistance will have influence over the setting of resistance. Programming Guide for DM3058/DM3058E 4-39...
  • Page 133 Return Format: The query returns the auto range state of 4-wire resistance measurement. 16. [SENSe:]FREQuency:VOLTage:RANGe:AUTO Command Format: [SENSe:]FREQuency:VOLTage:RANGe:AUTO {ON|OFF} [SENSe:]FREQuency:VOLTage:RANGe:AUTO? Function: The commands set and query the auto range state of voltage for frequency measurement. Explanations: 4-40 Programming Guide for DM3058/DM3058E...
  • Page 134 The maximum range of AC voltage is 750 V (rms) and the virtual value of voltage is decided by waveform. Return Format: The query returns the current auto range state of voltage under period measurement. 18. [SENSe:]VOLTage:DC:RESolution Command Format: [SENSe:]VOLTage:DC:RESolution {<resolution>|MINimum|MAXimum} [SENSe:]VOLTage:DC:RESolution? [MINimum|MAXimum] Programming Guide for DM3058/DM3058E 4-41...
  • Page 135 1ppm x range Explanations: [SENSe:]VOLTage:AC:RESolution {<resolution>|MINimum|MAXimum} – Sets the desired precision of AC voltage measurement. [SENSe:]VOLTage:AC:RESolution? [MINimum|MAXimum] – Queries the current precision of AC voltage measurement. <resolution> relates to measurement rate and integration time, refer to Table 4-42 Programming Guide for DM3058/DM3058E...
  • Page 136 <resolution> relates to measurement rate and integration time, refer to Table 4-2. Return Format: The query returns the current precision of DC current measurement. 21. [SENSe:]CURRent:AC:RESolution Command Format: [SENSe:]CURRent:AC:RESolution {<resolution>|MINimum|MAXimum} [SENSe:]CURRent:AC:RESolution? [MINimum|MAXimum] Function: The commands set and query the precision of AC current measurement. Programming Guide for DM3058/DM3058E 4-43...
  • Page 137 <resolution> relates to measurement rate and integration time, refer to Table 4-2. Both 2-wire and 4-wire resistance measurements are influenced by this command. All the commands of 2-wire and 4-wire resistance will have influence over the 4-44 Programming Guide for DM3058/DM3058E...
  • Page 138 All the commands of 2-wire and 4-wire resistance will have influence over the setting of resistance. Return Format: The query returns current precision of 4-wire resistance measurement. 24. [SENSe:]VOLTage:DC:NPLC Command Format: [SENSe:]VOLTage:DC:NPLC {0.02|0.2|1|10|100|MINimum|MAXimum} [SENSe:]VOLTage:DC:NPLC? [MINimum|MAXimum] Programming Guide for DM3058/DM3058E 4-45...
  • Page 139 [SENSe:]CURRent:DC:NPLC? [MINimum|MAXimum] – Queries the current integration time of DC current measurement. The integration time relates to resolution and measurement rate, refer to Table 4-2. Return Format: The query returns the current integration time of DC current measurement. 4-46 Programming Guide for DM3058/DM3058E...
  • Page 140 The commands set and query the integration time for 4-wire resistance measurement. The inputted and returned values are multiple of PLC. Explanations: [SENSe:]FRESistance:NPLC {0.02|0.2|1|10|100|MINimum|MAXimum} – Sets the desired integration time, MIN = 0.02 PLC, MAX = 100 PLC, and the default is 1 Programming Guide for DM3058/DM3058E 4-47...
  • Page 141 MAX=1s, and the default is 100ms. [SENSe:]FREQuency:APERture? [MINimum|MAXimum] – Queries the aperture time of frequency measurement. Return Format: The query returns the current aperture time of frequency measurement. 29. [SENSe:]PERiod:APERture Command Format: [SENSe:]PERiod:APERture {0.01|0.1|1|MINimum|MAXimum} [SENSe:]PERiod:APERture? [MINimum|MAXimum] 4-48 Programming Guide for DM3058/DM3058E...
  • Page 142 [SENSe:]DETector:BANDwidth {3|20|200|MINimum|MAXimum} – Sets the desired minimum frequency for signals inputted. The unit is Hz, MIN=3Hz, MAX=200Hz. [SENSe:]DETector:BANDwidth? [MINimum|MAXimum]? – Queries the minimum frequency from signals inputted. Return Format: The query returns “3”, “20” or “200”. Programming Guide for DM3058/DM3058E 4-49...
  • Page 143 [SENSe:]ZERO:AUTO {OFF|ONCE|ON} Sets the zero function state to be used. Note that the command is only responsed without practical operation as restricted by working principle. [SENSe:]ZERO:AUTO? – Queries the state of zero function. Note the query only returns “0” as restricted by working principle. 4-50 Programming Guide for DM3058/DM3058E...

  • Page 144: Sample Commands

    Command Format: SAMPle:COUNt {<value>|MINimum|MAXimum} SAMPle:COUNt? [MINimum|MAXimum] Function: The commands set and query the sample number of the multimeter. Explanations: <value> could be 1~2000. MIN=1, MAX=2000. Return Format: The query returns the sample number of the multimeter. Programming Guide for DM3058/DM3058E 4-51...

  • Page 145: Trigger Commands

    Command “SENSe:<function>: RANGe:AUTO OFF” is suggested to be used for disabling auto range function, and the commands “SENSe:<function>:RANGe, CONFigure” or “MEASure?” is for seting range manually. The trigger commands mainly include: TRIGger:COUNt  TRIGger:DELay  TRIGger:DELay:AUTO  TRIGger:SOURce  4-52 Programming Guide for DM3058/DM3058E...
  • Page 146 The commands set and query the delay time from when the trigger signal occured until the start of the measurement. Parameter: Name Type Range of Values Default Consecutive Parameters must <seconds> 0~3600 Integer be set Explanations: Programming Guide for DM3058/DM3058E 4-53...
  • Page 147 The query returns the current state of delay function in auto trigger mode. TRIGger:SOURce Command Format: TRIGger:SOURce {IMMediate|EXTernal|BUS} TRIGger:SOURce? Function: The commands set and query the trigger source used by the instrument. Explanations: TRIGger:SOURce {IMMediate|EXTernal|BUS} – Selects the trigger source to be used. 4-54 Programming Guide for DM3058/DM3058E...
  • Page 148 IMM mode, using command CONFigure or MEASure?. Command “SENSe:<function>:RANGe:AUTO OFF” is suggested to disable auto range function, the command “SENSe:<function>:RANGe”, “CONFigure” or “MEASure?” is for setting the range manually. Return Format: The query returns the current trigger source. Programming Guide for DM3058/DM3058E 4-55...

  • Page 150: Chapter 5 Compatible Fluke Commands

    The system mainly includes the following sub commands: Function Commands  Function Regulation Commands  Range and Rate Commands  Measurement Commands  Compare Commands  Trigger Commands  Format Commands  Reading Commands  Programming Guide for DM3058/DM3058E...

  • Page 151: Function Commands

    The commands enable the basic measurement funtions of the instrument, which are equal to the corresponding buttons at the front panel, including:   CLR2  CONT  DIODE  FREQ  FUNC  OHMS    Programming Guide for DM3058/DM3058E...
  • Page 152 ADC - Enables the DC Current measurement function of main display. ADC2 - Enables the DC Current measurement function of vice display. CLR2 Command Format: CLR2 Function: If the vice display is used, the command clears the measurement value on it and closes the vice display. Programming Guide for DM3058/DM3058E...
  • Page 153 The command enables the Frequency measurement function of both main and vice display. Explanations: FREQ - Enables the frequency measurement function of main display. FREQ2 - Enables the frequency measurement function of vice display. FUNC Command Format: FUNC1? FUNC2? Function: Programming Guide for DM3058/DM3058E...
  • Page 154 OHMS - Enables the resistance measurement function of main display. OHMS2 - Enables the resistance measurement function of vice display. Command Format: VAC2 Function: The command enables the AC voltage measurement of both main and vice display. Programming Guide for DM3058/DM3058E...
  • Page 155 The command enables the DC voltage measurement of both main and vice display. Explanations: VDC - Enables the DC voltage measurement function of main display. VDC2 - Enables the DC voltage measurement function of vice display. Programming Guide for DM3058/DM3058E...

  • Page 156: Function Regulation Commands

    The commands enable the regulator of the multimeter, which are equal to the math function at the front panel, including:  DBCLR  DBREF  HOLD  HOLDCLR  HOLDTHRESH   MAXSET   MINSET  MMCLR  MOD?   RELCLR  RELSET  Programming Guide for DM3058/DM3058E...
  • Page 157 The command disables dB operation. DBREF Command Format: DBREF <value> DBREF? Function: The commands query and set the reference impedance of dB. Explanations: The value should be within the <value> in table 5-1, or else, errors may occur. Programming Guide for DM3058/DM3058E...
  • Page 158 The command enables the multimeter enter Touch Hold mode. Explanations: If the multimeter has been in this mode when you send this command, a reading will be forced to display on the screen. HOLDCLR Command Format: HOLDCLR Function: Programming Guide for DM3058/DM3058E...
  • Page 159 The command enables the multimeter enter MAX operation with current reading as maximum. Explanations: If the multimeter has been in MAX mode, the maximum value will be shown on the screen. Note the auto range function is disabled in this mode. 5-10 Programming Guide for DM3058/DM3058E...
  • Page 160 If the multimeter has been in MIN mode, the minimum value will be shown on the screen. Note the auto range function is disabled in this mode. 10. MINSET Command Format: MINSET <numeric value> Function: The command enables the multimeter enter MIN operation with <numeric value> as minimum. 5-11 Programming Guide for DM3058/DM3058E...
  • Page 161 If no operation is selected, returns 0. For example, if dB and REL are selected, 40 is returned. Return Format: The query returns the numeric value relateds to current operation. 5-12 Programming Guide for DM3058/DM3058E...
  • Page 162 <relative base> could be a signed integer, a signed real number with exponent or a signed real number without exponent. If <numeric value> is overrange, an Execution Error may generate. Return Format: The query returns the relative base of REL operation. 5-13 Programming Guide for DM3058/DM3058E...

  • Page 163: Range And Rate Commands

    Range and Rate Commands The commands set and query the measuring range and the speed, which are equal to the corresponding buttons at the front panel, including: AUTO  FIXED  RANGE  RATE  5-14 Programming Guide for DM3058/DM3058E...
  • Page 164 Manual mode, the current range is selected. RANGE Command Format: RANGE <value range> RANGE1? RANGE2? Function: RANGE <value range> - Sets the range of main display, see table below, thereinto, the ranges relate to the functions (voltage, current, resistance and so 5-15 Programming Guide for DM3058/DM3058E...
  • Page 165 RATE <speed> - Selects the measuring speed to be used from S (2.5 readings/s), M (20 readings/s) and F (123 readings/s), with case-insensitive. Any other letter may generate an Execute error. RATE? – Queries the current measuring speed. Return Format: The query returns S, M or F. 5-16 Programming Guide for DM3058/DM3058E...

  • Page 166: Measurement Commands

    RIGOL Measurement Commands The commands query the measured results shown on the main or vice display, including: MEAS   5-17 Programming Guide for DM3058/DM3058E...
  • Page 167 VAL2? - Queries the measured value from vice display; if the display is empty, the query returns the next trigger value; if the display is disabled, an Execute error may generate. 5-18 Programming Guide for DM3058/DM3058E...

  • Page 168: Compare Commands

    Compare Commands The subcommands campare if the value measured by the multimeter is higher than, lower than or just within the specified range, which mainly include: COMP  COMPCLR  COMPHI  COMPLO  HOLDCLR  5-19 Programming Guide for DM3058/DM3058E...
  • Page 169 If it is active and backs into its normal work. COMPHI Command Format: COMPHI <high value> Function: The command sets the upper limit of the COMP mode. Explanations: <high value> could be a signed integer or a signed real number. 5-20 Programming Guide for DM3058/DM3058E...
  • Page 170 <low value> could be a signed integer or a signed real number. HOLDCLR Command Format: HOLDCLR Function: The command enables the multimeter exit the Touch Hold function and back to its normal work, but not exit COMP mode. 5-21 Programming Guide for DM3058/DM3058E...

  • Page 171: Trigger Commands

    Trigger Commands TRIGGER Command Format: TRIGGER <type> TRIGGER? Function: The commands set and query the trigger type. Explanations: Parameter <type> could only be type 1 and the query returns 1 only as restricted by working principle. 5-22 Programming Guide for DM3058/DM3058E...

  • Page 172: Format Commands

    Table 5-3 Units of format 2 Function Unit DC voltage AC voltage DC current AC current Resistance OHMS Frequency Diode Continuity OHMS Note: Being restricted by working principle, command FORMAT <frmt> and FORMAT? are only responsed without practical operation. 5-23 Programming Guide for DM3058/DM3058E...

  • Page 173: Reading Commands

    RIGOL Reading Commands SERIAL? Command Format: SERIAL? Function: The command reads the serial number of the multimeter. 5-24 Programming Guide for DM3058/DM3058E...

  • Page 174: Chapter 6 Application Examples

    The serial number before each command is used to number the current command, not the content of command. The contents between “/ *” and “* /” after each command are explanations for helping users understand. Before using these examples, connect the related test equipment and the tested device correctly. Programming Guide for DM3058/DM3058E...

  • Page 175: Example 1: Reading Statistic

    When the maximum statistic is enabled, the first reading is regarded as the maximum shown, and then, this value is updating continuously along with readings measured until the maximum value is captured, please perform with following procedures step by step: The programming implementations—— RIGOL Commands *RST /* Reset the instrument*/ cmdset rigol...
  • Page 176 For example, sending “conf:volt:dc:auto,max” to change the rate to “slow”. The command in line 7 returns the current measured maximum of DC voltage. The command in line 9 returns the measured times that have been completed. Programming Guide for DM3058/DM3058E...

  • Page 177: Example 2: Eliminating The Impedance Errors On Test Leads

    The programming implementations——RIGOL Commands *RST /* Reset the instrument */ cmdset rigol /* Select RIGOL commands */ *IDN? /* Query the equipment ID and confirm if the multimeter works normally */ /*Return: RIGOL Technologies,DM3058,DM3A020080808,99.00.00.00.00.00*/...
  • Page 178 RIGOL magnitude comparing with the result in line 9 after the REL operation has been compeleted, so, test succeed. Programming Guide for DM3058/DM3058E...
  • Page 179 *IDN? /* Query the equipment ID and confirm if the multimeter works normally */ /* Return RIGOL Technologies, DM3058, DM3A020080808, 99.00.00.00.00.00*/ conf:res min /* Enable the resistance measurement. */ /* Short connect the red and black test lead pen with each other */...

  • Page 180: Example 3: Dbm Measurement

    /* Select Agilent commands */ *IDN? /* Query the equipment ID and confirm if the multimeter works normally */ /* Return RIGOL Technologies,DM3058,DM3A020080808,99.00.00.00.00.00*/ :function:resistance /* Enable resistance measuring function */ :measure AUTO /* Set the measuring range to “AUTO” */...
  • Page 181 /* Query the measured result */ /* return value */ Explanations: The instrument should be connected under resistance mode before sending the command in line 3. The command parameter in line 9 is the return value of line 3. Programming Guide for DM3058/DM3058E...

  • Page 182: Example 4: Db Measurement

    Purpose: Use commands to perform dB measurement. dB is a common measurement unit, which is frequently used in electrician, wireless, mechanics, oscillatory surge, mechanical power, acoustics and some other fields. The programming implementations ——RIGOL Commands *RST /* Reset the instrument */...
  • Page 183 The return value of command in line 8 is “dB reference value”, not the dB measured result. Use RIGOL commands if both the dB measurement function and returned value are required. 6-10 Programming Guide for DM3058/DM3058E...

  • Page 184: Example 5: P/F Testing

    The programming implementations——RIGOL Commands *RST /* Reset the instrument */ cmdset rigol /* Select RIGOL commands */ *IDN? /* Query the equipment ID and confirm if the multimeter works normally */ /* Connect the test leads for DC voltage measurement */...
  • Page 185 If the parameter input is not within the scope of the upper and lower limits, a beep tone will be emitted ( when the beeper is on). Use RIGOL commands if both the P/F measurement function and returned value are required. 6-12...

  • Page 186: Example 6: Reading Hold

    The programming implementations——RIGOL Commands *RST /* Reset the instrument */ cmdset rigol /* Select RIGOL commands */ *IDN? /* Query the equipment ID and confirm if the multimeter works normally */ /* Connect the test leads for DC voltage measurement */...

  • Page 187: Example 7: Querying The Status Register

    For the detailed commands, refer to Chapter 2. The commands system of status register is in common use in all RIGOL, Fluke and Agilent, take RIGOL commands for example. The programming implementations——RIGOL Commands:...
  • Page 188 /* Clear the status */ 44 :trigger:single:triggered /*Execute the single trigge once*/ 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? 6-15 Programming Guide for DM3058/DM3058E...
  • Page 189 “*ESR”, “:status:questionable?” and “:status:operation?” query the each event register, and the value of them would be cleared every time after the query . The first colon “:” in “:status:operation?” command can be omited for being compatible with RIGOL and Agilent commands. 6-16 Programming Guide for DM3058/DM3058E...

  • Page 190: Example 8: Querying The Error Information

    For the detailed commands, refer to Chapter 2. As the commands system of status register is in common use in all RIGOL, Fluke and Agilent, take RIGOL commands for example. The programming implementations——RIGOL Commands:...
  • Page 191 For line 10, the character “*” attached before the command may cause a “synax error” error. It is a command error. For line 16, the parameters should only be {RIGOL|AGILENT|FLUKE}, so null parameter is invalid, a “Parameter error” is generated. It is an execution error.

  • Page 192: Appendix

    Incompatible Agilent Commands MEASure:VOLTage:DC:RATio {<range>|MIN|MAX|DEF},{<resolution>|MIN|MAX|DEF} CONFigure:VOLTage:DC:RATio {<range>|MIN|MAX|DEF},{<resolution>|MIN|MAX|DEF} [SENSe:]FUNCtion "VOLTage:DC:RATio" CALibration? CALibration:COUNt? CALibration:SECure:CODE <new code> CALibration:SECure:STATe {OFF|ON},<code> CALibration:SECure:STATe? CALibration:STRing <quoted string> CALibration:STRing? CALibration:VALue <value> Incompatible Fluke Commands AACDC* VACDC* DBPOWER DIODE2 ^C (CNTRL C) LOCS LWLS REMS RWLS Programming Guide for DM3058/DM3058E...

This manual is also suitable for:

Dm3058e

Table of Contents