Specifications

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

RIGOL

Programming Guide

DM3058/DM3058E Digital Multimeter

Aug. 2012

RIGOL Technologies, Inc.

Summary of content (192 pages)

PAGE 1
RIGOL Programming Guide DM3058/DM3058E Digital Multimeter Aug. 2012 RIGOL Technologies, Inc.
PAGE 2
RIGOL Copyright Information  © 2008 RIGOL Technologies, Inc. All Rights Reserved.  RIGOL products are protected by patent laws in and outside of the P.R. China.  Information in this publication replaces all previous corresponding material.  RIGOL 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
RIGOL 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 operation. The manual contains following chapters: Chapter 1 Introduction Give a general overview of commands usage.
PAGE 4
RIGOL Contents Chapter 1 Introduction ............................................................................ 1-1 Programming Introduction ......................................................................... 1-2 Symbol Instruction .................................................................................... 1-3 Parameter Types ....................................................................................... 1-4 Commands in this Manual .................................................
PAGE 5
RIGOL TRIGger Commands ................................................................................ 4-52 Chapter 5 Compatible Fluke Commands .................................................. 5-1 Function Commands .................................................................................. 5-2 Function Regulation Commands ................................................................. 5-7 Range and Rate Commands .....................................................................
PAGE 6
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 Commands in this Manual Programming Guide for DM3058/DM3058E 1-1
PAGE 7
RIGOL Programming Introduction The programming system provides an easy way for remote control through corresponding commands, sending and identifying the command word with ASCII strings. Connect a computer with the multimeter through communication interfaces such as USB, GPIB*, LAN* or RS-232 before use. 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.
PAGE 8
RIGOL Symbol Instruction 1. Colon : Commands usually begin with a colon (:), which is used to separate the keyword from lower-level keyword, denoting the beginning of an operation to the multimeter. 2. Interrogation ? A query is formed by adding an interrogation (?) at the end of the command. The query command usually contains different data, and both of them usually divided by a space. 3.
PAGE 9
RIGOL Parameter Types 1. Consecutive Integer Parameter The parameters could be an integer within the valid range. For example, setting the screen brightness from “0~32” through “:SYSTem:DISPlay:BRIGht”. Note do not set the parameters with decimal, or else an unexpected exception may occurred. 2.
PAGE 10
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: CMDSET {RIGOL|AGILENT|FLUKE} CMDSET? Function: The commands set and query the command system.
PAGE 11
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 2-2
PAGE 12
RIGOL 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 2-3
PAGE 13
RIGOL 1. *CLS Command Format: *CLS Function: The command resets the values in all Event Registers and clears the Error Queue information. 2. *ESE Command Format: *ESE *ESE? Function: The commands set and query the enable value of Event Status Register (ESR). Explanations: *ESE - Sets the desired enable value of ESR. *ESE? - Queries the current enable value of ESR. - Ranging from 0 to 189. Return Format: The query returns the enable value of ESR. 3.
PAGE 14
RIGOL 4. *IDN? Command Format: *IDN? Function: The command queries the equipment ID. Return Format: The query returns a string which denotes the instrument ID, and composed of at least 35 characters. 5. *OPC Command Format: *OPC *OPC? Function: *OPC - Sets the “Operation Complete” (bit 0) of Event Status Register to 1 after the current operation has been completed. *OPC? - Queries whether the current operation is finished or not.
PAGE 15
RIGOL thereinto, “*PSC 0” indicates disable - the enable value of each register would be LAST STATE; “*PSC 1” indicates enable - the enable value of each register would be resetted. *PSC? – Queries the value of “power-on status clear”. Return Format: The query returns 0 or 1. 7. *RST Command Format: *RST Function: The command resets the instrument. 8. *SRE Command Format: *SRE *SRE? Function: The commands set and query the enable value of Status Byte Register (STB).
PAGE 16
RIGOL *STB? Function: The command queries the condition value of Status Byte Register (STB). Return Format: The query returns the current condition value of STB. 10. *TRG Command Format: *TRG Function: The command generates a trigger signal when the instrument is in “Wait-for-trigger” state. 11. *TST? Command Format: *TST? Function: The command queries the self-test result. Return Format: The query returns 0 or 1. Thereinto, 0 denotes pass, and 1 denotes failure. 12.
PAGE 17
RIGOL STATus Commands The commands set and query both the Questionable Status Register and Operation Status Register, which mainly include:        STATus:OPERation:CONDition? STATus:OPERation:ENABle STATus:OPERation[:EVENt]? STATus:PRESet STATus:QUEStionable:CONDition? STATus:QUEStionable:ENABle STATus:QUEStionable[:EVENt]? The principle of Status Register is shown in Figure 2-1, which contains Questionable Status Register, Operation Status Register, Event Status Register and Status Byte Register
PAGE 18
RIGOL Figure 2-1 The Status Register diagram 1.
PAGE 19
RIGOL Command Format: STATus:OPERation:CONDition? Function: The command queries the status of Condition Register in the Operation Status Register queue. Return Format: The query returns the current status of Condition Register from Operation Status Register. 2. STATus:OPERation:ENABle Command Format: STATus:OPERation:ENABle STATus:OPERation:ENABle? Function: The commands set or query the value of Enable Register in the Operation Status Register queue.
PAGE 20
RIGOL Function: The command queries the value of Event Register in the Operation Status Register queue. Return Format: The query returns the current value of Event Register in the Operation Status Register queue. 4. STATus:PRESet Command Format: STATus:PRESet Function: The command resets the value of Enable Register in both the Operation Status Register and Questionable Status Register queue. 5.
PAGE 21
RIGOL Function: The commands set and query the value of Enable Register in the Questionable Status queue. Explanations: STATus:QUEStionable:ENABle - Sets the Enable Register value from Questionable Status Register. - Ranging from 0 to 24375. STATus:QUEStionable:ENABle? - Queries the Enable Register value of Questionable Status Register. Return Format: The query returns the current value of Enable Register in the Questionable Status Register queue. 7.
PAGE 22
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? Programming Guide for DM3058/DM3058E 2-13
PAGE 23
RIGOL 1. SYSTem:BEEPer Command Format: SYSTem:BEEPer Function: The command tests the beeper. Explanations: The command issues a single beep immediately from the instrument. Note that the beeper must be opened before using this command. 2. SYSTem:BEEPer:STATe Command Format: SYSTem:BEEPer:STATe? SYSTem:BEEPer:STATe {ON|OFF|1|0} Function: The commands set and query the status of the beeper. Explanations: SYSTem:BEEPer:STATe? – Queries if the beeper is open.
PAGE 24
RIGOL 3. SYSTem:ERRor? Command Format: SYSTem:ERRor? Function: The command queries the errors in the Error queue. Return Format: The query returns the error number in connection with error description. If no error, the query returns: 0,"No error". 4. 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.
PAGE 25
PAGE 26
RIGOL Chapter 3 RIGOL Command System All the RIGOL commands in connection with the return values are ASCII characters with case-insensitive.
PAGE 27
RIGOL :CALCulate Commands The commands set the parameters relate to math operations, which mainly include:                   3-2 :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 :CALCu
PAGE 28
RIGOL 1. :CALCulate:FUNCtion Command Format: :CALCulate:FUNCtion? :CALCulate:FUNCtion {NONE|REL|DB|DBM|MIN|MAX|AVERAGE|TOTAL|PF} Function: The commands set and query the math function. Explanations: :CALCulate:FUNCtion? – Queries the current selected math operation, the default is NONE (Math function is disabled). :CALCulate:FUNCtion {NONE|REL|DB|DBM|MIN|MAX|AVERAGE|TOTAL|PF} – Selects the operation to be used. For the available math operations, see tabe below.
PAGE 29
RIGOL 2. :CALCulate:STATistic:MIN? Command Format: :CALCulate:STATistic:MIN? Function: The command queries the minimum of current statistic. Explanations: The command is valid only when MIN operation is enabled. Return Format: The query returns the calculated minimum. 3. :CALCulate:STATistic:MAX? Command Format: :CALCulate:STATistic:MAX? Function: The command queries the maximum of current statistic. Explanations: The command is valid only when MAX operation is enabled.
PAGE 30
RIGOL The command is valid only when AVERAGE operation is enabled. Return Format: The query returns the calculated average. 5. :CALCulate:STATistic:COUNt? Command Format: :CALCulate:STATistic:COUNt? Function: The command queries the number of current measurement calculated. Explanations: The command is only valid for current measurement. If measurement function is changed, it will restart the counting. Return Format: The command queries the calculated number of measurement. 6.
PAGE 31
RIGOL Turn off the statistic function. :CALCulate:STATistic:STATe OFF 7. :CALCulate:REL:OFFSet Command Format: :CALCulate:REL:OFFSet? :CALCulate:REL:OFFSet {|MIN|MAX|DEF|CURR} Function: The commands query and set the offset of REL operation. Parameter: Name Type Range Default Consecutive real number See Table 3-2 0 Explanations: :CALCulate:REL:OFFSet? – Queries the REL offset of current measurement.
PAGE 32
RIGOL Return Format: The query returns the offset relates to REL operation. 8. :CALCulate:REL:STATe Command Format: :CALCulate:REL:STATe? :CALCulate:REL:STATe {ON|OFF|1|0} Function: The commands query and set the REL state. Explanations: :CALCulate:REL:STATe? – Queries the current REL state. :CALCulate:REL:STATe {ON|OFF|1|0} – Sets the desired REL state. Return Format: The query returns the current REL state, ON (1) or OFF (0). Example: Disables the REL operation. :CALCulate:REL:STATe OFF 9.
PAGE 33
RIGOL 10. :CALCulate:DB:REFErence Command Format: :CALCulate:DB:REFErence? :CALCulate:DB:REFErence {|MIN|MAX|DEF} Function: The commands query and set the dB reference value of current measurement. Parameter: Name Type Range Default Consecutive real numbe -120 dBm~+120 dBm 0 Explanations: :CALCulate:DB:REFErence? – Queries the dB reference value. :CALCulate:DB:REFErence {|MIN|MAX|DEF} – Sets the desired dB reference value.
PAGE 34
RIGOL Return Format: The query returns the current dB state, ON (1) or OFF (0). Example: Turn off the dB operation: :CALCulate:DB:STATe OFF 12. :CALCulate:DBM? Command Format: :CALCulate:DBM? Function: The command queries the dBm value of current measurement. Explanations: The command is valid only when dBm operation is enabled. Return Format: The query returns the calculated dBm value. 13.
PAGE 35
RIGOL :CALCulate:DBM:REFErence {|MIN|MAX|DEF} – Sets the desired reference resistance of dBm. The command is valid only when dBm operation is enabled. The reference resistance should be an integer within 2 and 8000, the unit is Ω. MIN is equal to 2 Ω, MAX is equal to 8000 Ω and DEF is 600 Ω. Return Format: The query returns the current reference resistance of dBm. 14.
PAGE 36
RIGOL Explanations: When the measurement result is within the maximum and minimum, the PF operation is success. Return Format: The query returns the PF operation: PASS, HI or LO. 16. :CALCulate:PF:LOWEr Command Format: :CALCulate:PF:LOWEr? :CALCulate:PF:LOWEr {|MIN|MAX|DEF} Function: The comands query and set the lower limit of P/F operation.
PAGE 37
RIGOL Return Format: The query returns the current lower limit. 17. :CALCulate:PF:UPPEr Command Format: :CALCulate:PF:UPPEr? :CALCulate:PF:UPPEr {|MIN|MAX|DEF} Function: The commands query and set the upper limit of P/F operation. Parameter: Name Type Range Default Consecutive real numbe See Table 3-3 1 Explanations: :CALCulate:PF:UPPEr? – Queries the upper limit of P/F operation. :CALCulate:PF:UPPEr {|MIN|MAX|DEF} – Sets the upper limit of P/F operation.
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).
PAGE 39
RIGOL :FUNCtion Commands The commands enable the measurement function to be used, which are equal to the corresponding buttons at the front panel, including:             3-14 :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/DM3058E
PAGE 40
RIGOL 1. :FUNCtion? Command Format: :FUNCtion? Function: The command queries the current measurement function. If double-display is using, the command queries the function of main display. Return Format: The query returns the current measurement function, such as DCV, ACV, DCI, ACI, RESISTANCE, CAPACITANCE, CONTINUITY, FRESISTANCE, DIODE, FREQUENCY, PERIOD. 2. :FUNCtion:VOLTage:DC Command Format: :FUNCtion:VOLTage:DC Function: The command enables the DC voltage measurement.
PAGE 41
RIGOL 4. :FUNCtion:CURRent:DC Command Format: :FUNCtion:CURRent:DC Function: The command enables the DC current measurement. Explanations: The query :FUNCtion? will return DCI. 5. :FUNCtion:CURRent:AC Command Format: :FUNCtion:CURRent:AC Function: The command enables the AC current measurement. Explanations: The query :FUNCtion? will return ACI. 6. :FUNCtion:RESistance Command Format: :FUNCtion:RESistance Function: The command enables the 2-wire resistance measurement.
PAGE 42
RIGOL Function: The command enables the 4-wire resistance measurement. Explanations: The query :FUNCtion? will return 4WR. 8. :FUNCtion:FREQuency Command Format: :FUNCtion:FREQuency Function: The command enables the frequency measurement. Explanations: The query :FUNCtion? will return FREQ. 9. :FUNCtion:PERiod Command Format: :FUNCtion:PERiod Function: The command enables the period measurement. Explanations: The query :FUNCtion? will return PERI. 10.
PAGE 43
RIGOL Explanations: The query :FUNCtion? will return CONT. 11. :FUNCtion:DIODe 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.
PAGE 44
RIGOL :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 Programming Guide for DM3058/DM3058E 3-19
PAGE 45
RIGOL 1. :FUNCtion2? Command Format: :FUNCtion2? Function: The comand queries the current measurement of vice-display. Explanations: The command is valid only when vice-display is enabled. Return Format: The query returns the current measurement of vice-display, such as DCV, ACV, DCI, ACI, 2WR, CAP, 4WR, FREQ, PERI. 2. :FUNCtion2:VALUe1? Command Format: :FUNCtion2:VALUe1? Function: The command queries the measured value of the main-display.
PAGE 46
RIGOL Explanations: The command is valid only when vice-display is enabled. Return Format: The command returns the measured value of the vice-display. 4. :FUNCtion2:VOLTage:DC Command Format: :FUNCtion2:VOLTage:DC Function: The command sets the vice-display to DC voltage measurement. Explanations: The available measurements to main-display could only be DCV, DCI, ACV or ACI. 5.
PAGE 47
RIGOL Explanations: The available measurements to main-display could only be DCV, DCI, ACV, ACI after this command. 7. :FUNCtion2:CURRent:AC Command Format: :FUNCtion2:CURRent:AC Function: The command sets the vice-display to AC current measurement. Explanations: The available measurements to main-display could only be DCV, DCI, ACV, ACI, FREQUENCY, PERIOD after this command. 8.
PAGE 48
RIGOL Explanations: The available measurements to main-display could only be ACV, FREQUENCY, PERIOD after this command. 10. :FUNCtion2:RESistance Command Format: :FUNCtion2:RESistance Function: The command sets the vice-display to 2-wire resistance measurement. Explanations: The available measurements to main-display could only be RESISTANCE after this command. 11. :FUNCtion2:FRESistance Command Format: :FUNCtion2:FRESistance Function: The command sets the vice-display to 4-wire resistance measurement.
PAGE 49
RIGOL Explanations: 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.
PAGE 50
RIGOL :MEASure Commands The commands set the measurement parameters or query the measured results, including:                                 :MEASure? :MEASure :MEASure:VOLTage:DC? :MEASure:VOLTage:DC :MEASure:VOLTage:DC:RANGe? :MEASure:VOLTage:DC:IMPEdance :MEASure:VOLTage:DC:FILTer[:STATe] :MEASure:VOLTage:AC? :MEASure:VOLTage:AC :MEASure:VOLTage:AC:RANGe? :MEASure:CURRent:DC? :MEASure:CURRent:DC :MEASure:CURRent:DC:RANGe? :MEASure:CURRent:DC:FILTer[:STATe] :MEASure:CURR
PAGE 51
RIGOL    3-26 :MEASure:CAPacitance? :MEASure:CAPacitance :MEASure:CAPacitance:RANGe? Programming Guide for DM3058/DM3058E
PAGE 52
RIGOL 1. :MEASure? Command Format: :MEASure? Function: The command queries if a new data has been acquired under current trigger setting. Return Format: The query returns TRUE or FALSE. Thereinto, TRUE indicates a new data has been acquired. 2. :MEASure Command Format: :MEASure {AUTO|MANU} Function: The command selects the measurement type as Auto or Manual. Example: Sets the measurement type to Manual. :MEASure MANU 3.
PAGE 53
RIGOL The command returns the measured DC voltage value in scientific notation, such as: 8.492853e-05, the unit is V. 4. :MEASure:VOLTage:DC Command Format: :MEASure:VOLTage:DC {|MIN|MAX|DEF} Function: The command sets the range and resolution of DC voltage measurement. Parameter: Name Type Range Default Discrete {0|1|2|3|4} 2 Explanations: The corresponding resultion will be set automatically after you set the range.
PAGE 54
RIGOL :MEASure:VOLTage:DC MIN or :MEASure:VOLTage:DC 0 5. :MEASure:VOLTage:DC:RANGe? Command Format: :MEASure:VOLTage:DC:RANGe? Function: The command queries the current DC voltage range. Explanations: The DC voltage measurement has to be used at least once before using this command. Return Format: The command returns: 0, 1, 2, 3 or 4 (see Table 3-4). 6.
PAGE 55
RIGOL :MEASure:VOLTage:DC:IMPEdance 10G 7. :MEASure:VOLTage:DC:FILTer[:STATe] Command Format: :MEASure:VOLTage:DC:FILTer[:STATe]? :MEASure:VOLTage:DC:FILTer[:STATe] {ON|OFF|1|0} Function: The commands query and set the AC filter state under current DC voltage measurement. Explanations: :MEASure:VOLTage:DC:FILTer[:STATe]? – Queries the filter state. :MEASure:VOLTage:DC:FILTer[:STATe] {ON|OFF} – Opens or closes the filter. Return Format: The query returns ON (1) or OFF (0). Example: Opens the filter.
PAGE 56
RIGOL 9. :MEASure:VOLTage:AC Command Format: :MEASure:VOLTage:AC {|MIN|MAX|DEF} Function: The command sets the range of AC voltage measurement. Parameter: Name Type Discrete Range Default {0|1|2|3|4} 2 Explanations: For the parameter range, see table below. Table 3-5 AC voltage range Parameter Range 0 200 mV 1 2V 2 20 V 3 200 V 4 750 V MIN 200 mV MAX 750 V DEF 20 V Example: Sets the AC voltage range to 750V. :MEASure:VOLTage:AC MAX or :MEASure:VOLTage:AC 4 10.
PAGE 57
RIGOL The command queries the current range of AC voltage measurement. Return Format: The query returns: 0, 1, 2, 3 or 4 (see Table 3-5). 11. :MEASure:CURRent:DC? Command Format: :MEASure:CURRent:DC? Function: The command queries the measured DC current value. Explanations: The command is unavailable in double-display. Return Format: The command queries the measured DC current value in scientific notation, such as: 9.67441e-05, the unit is A. 12.
PAGE 58
RIGOL Table 3-6 DC current range and the corresponding resolution Parameter Range Resolution 0 200 μA 1 nA 1 2 mA 10 nA 2 20 mA 100 nA 3 200 mA 1 μA 4 2A 10 μA 5 10 A 100 μA MIN 200 μA 1 nA MAX 10 A 100 μA DEF 200 mA 1 μA Example: Sets the DC current range to the maximum (10A). :MEASure:CURRent:DC MAX or :MEASure:CURRent:DC 5 13. :MEASure:CURRent:DC:RANGe? Command Format: :MEASure:CURRent:DC:RANGe? Function: The command queries the DC current range.
PAGE 59
RIGOL measurement. Explanations: :MEASure:CURRent:DC:FILTer[:STATe]? – Queries the filter state. :MEASure:CURRent:DC:FILTer[:STATe] {ON|OFF|1|0} – Opens or closes the filter. Return Format: The query returns ON (1) or OFF (0). Example: Opens the filter. :MEASure:CURRent:DC:FILTer ON 15. :MEASure:CURRent:AC? Command Format: :MEASure:CURRent:AC? Function: The command queries the measured AC current value. Explanations: The command is unavailable in double-display.
PAGE 60
RIGOL Discrete {0|1|2|3} 1 Explanations: :MEASure:CURRent:AC - Sets the AC current range. The measurement type will change into “Manual” automatically when you use this command. For the parameter range, see table below. Table 3-7 AC current range Parameter Range 0 20 mA 1 200 mA 2 2A 3 10 A MIN 20 mA MAX 10 A DEF 200 mA Example: Sets the AC current range to the maximum (10A). :MEASure:CURRent:AC MAX or :MEASure:CURRent:AC 3 17.
PAGE 61
RIGOL Command Format: :MEASure:RESistance? Function: The command queries the measured 2-wire resistance value. Explanations: The command is unavailable in double-display. Return Format: The command queries the measured 2-wire resistance value in scientific notation, such as: 8.366031e-05, the unit is Ω. 19. :MEASure:RESistance Command Format: :MEASure:RESistance {|MIN|MAX|DEF} Function: The command sets the desired 2-wire resistance range.
PAGE 62
RIGOL MAX 100 MΩ MIN 200 Ω DEF 200 kΩ Example: Sets the 2-wire resistance range to 200Ω. :MEASure:RESistance MIN or :MEASure:RESistance 0 20. :MEASure:RESistance:RANGe? Command Format: :MEASure:RESistance:RANGe? Function: The command queries the current 2-wire resistance range. Return Format: The query returns: 0, 1, 2, 3, 4, 5 or 6 (see Table 3-8). 21. :MEASure:FRESistance? Command Format: :MEASure:FRESistance? Function: The command queries the measured 4-wire resistance value.
PAGE 63
RIGOL :MEASure:FRESistance {|MIN|MAX|DEF} Function: The command sets the desired 4-wire resistance range. Parameter: Name Type Range Default Discrete {0|1|2|3|4|5|6 } 3 Explanations: For the parameter range, refer to Table 3-8. Example: Sets the 4-wire resistance range to 200Ω. :MEASure:FRESistance MIN or :MEASure:FRESistance 0 23. :MEASure:FRESistance:RANGe? Command Format: :MEASure:FRESistance:RANGe? Function: The command queries the current 4-wire resistance range.
PAGE 64
RIGOL Return Format: The command queries the measured frequency value of AC signal in scientific notation, such as: 8.485240e-05, the unit is Hz. 25. :MEASure:FREQuency Command Format: :MEASure:FREQuency {|MIN|MAX|DEF} Function: The command sets the voltage range of the input signal under frequency measurement. Parameter: Name Type Range Default Discrete {0|1|2|3|4} 2 Explanations: The available frequency range is 20Hz~1MHz. For the parameter range, refer to Table 3-5.
PAGE 65
RIGOL Return Format: The query returns: 0, 1, 2, 3 or 4 (see Table 3-5). 27. :MEASure:PERiod? Command Format: :MEASure:PERiod? Function: The command queries the measured period value. Explanations: The command is unavailable in double-display. Return Format: The command queries the measured period value of AC signal in scientific notation, such as: 9.18543e-05, the unit is s. 28.
PAGE 66
RIGOL 29. :MEASure:PERiod:RANGe? Command Format: :MEASure:PERiod:RANGe? Function: The command queries the AC voltage range used under period measurement. Explanations: The range here is the same with the range of AC voltage, see Table 3-5. Return Format: The query returns: 0, 1, 2, 3 or 4 (see Table 3-5). 30. :MEASure:CONTinuity? Command Format: :MEASure:CONTinuity? Function: The command queries the measured result of continuity.
PAGE 67
RIGOL Name Type Range Default Consecutive Integer 1 Ω~2000 Ω 10 Explanations: The parameter is a consecutive integer ranging form 1 Ω to 2000 Ω. The default resistance is 10 Ω. Example: Sets the resistance limit under continuity measurement to 1kΩ. :MEASure:CONTinuity 1000 32. :MEASure:DIODe? Command Format: :MEASure:DIODe? Function: The command queries the voltage of the ends of diode. Explanations: The beep condition under diode measurement is 1 V≤Vmeasured≤2.4 V by default.
PAGE 68
RIGOL Return Format: The query returns the measured capacitance value in scientific notation, such as: 8.889030e-05, the unit is F. 34. :MEASure:CAPacitance Command Format: :MEASure:CAPacitance {|MIN|MAX|DEF} Function: The command sets the capacitance range. Parameter: Name Type Range Default Discrete {0|1|2|3|4|5} 2 Explanations: For the parameter range, see table below.
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).
PAGE 70
RIGOL :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 Programming Guide for DM3058/DM3058E 3-45
PAGE 71
RIGOL 1. :RATE:VOLTage:DC Command Format: :RATE:VOLTage:DC? :RATE:VOLTage:DC {F|M|S} Function: The commands query and set the rate of DC voltage measurement. Explanations: :RATE:VOLTage:DC? - Queries the current measuring rate of DC voltage. The command is valid only when DCV function is enabled. :RATE:VOLTage:DC {F|M|S} – Sets the desired measuring rate of DC voltage. For the range and the explanation of each parameter, see table below.
PAGE 72
RIGOL :RATE:VOLTage:AC? - Queries the current measuring rate of AC voltage. The command is valid only when ACV function is enabled. :RATE:VOLTage:AC {F|M|S} - Sets the desired measuring rate of AC voltage. For the range and the explanation of each parameter, see Table 3-10. Return Format: The query returns the parameter related to current rate (see Table 3-10). Example: Sets the rate under AC voltage measurement to Medium. :RATE:VOLTage:AC M 3.
PAGE 73
RIGOL 4. :RATE:CURRent:AC Command Format: :RATE:CURRent:AC? :RATE:CURRent:AC {F|M|S} Function: The commands query and set the rate of AC current measurement. Explanations: :RATE:CURRent:AC? - Queries the current measuring rate of AC current. The command is valid only when AC current function is enabled. :RATE:CURRent:AC {F|M|S} - Sets the desired measuring rate of AC current. For the range and the explanation of each parameter, see Table 3-10.
PAGE 74
RIGOL The query returns the parameter related to current 2-wire resistance rate (see Table 3-10). Example: Sets the rate under 2-wire resistance measurement to Medium. :RATE:RESistance M 6. :RATE:FRESistance Command Format: :RATE:FRESistance? :RATE:FRESistance {F|M|S} Function: The commands query and set the rate of 4-wire resistance measurement. Explanations: :RATE:FRESistance? - Queries the current measuring rate of 4-wire resistance.
PAGE 75
RIGOL The commands query and set the rate of sensor measurement. Explanations: :RATE:SENSor? - Queries the current measuring rate of sensor. The command is valid only when sensor function is enabled. :RATE:SENSor {M|S} - Sets the desired measuring rate of sensor. For the range and the explanation of each parameter, see 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.
PAGE 76
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 Programming Guide for DM3058/DM3058E 3-51
PAGE 77
RIGOL 1. :SYSTem:CONFigure:POWEron Command Format: :SYSTem:CONFigure:POWEron {LAST|DEF} Function: The command sets the power-on mode of the system. Explanations: The modes provided are Last and Default. If choose LAST, the configurations before last power cut would be used when the instrument is next started; if choose DEF (DEFAULT), the default configurations would be used. 2.
PAGE 78
RIGOL 4. :SYSTem:FORMat:DECImal Command Format: :SYSTem:FORMat:DECImal? :SYSTem:FORMat:DECImal {COMMA|DOT} Function: The commands query and set the decimal display format of system. Explanations: :SYSTem:FORMat:DECImal? – Queries the current decimal display format of system. :SYSTem:FORMat:DECImal {COMMA|DOT} – Sets the desired decimal format. Note: this command causes easily the format changes of data delimiter, please use it modestly.
PAGE 79
RIGOL 6. :SYSTem:DISPlay:BRIGht Command Format: :SYSTem:DISPlay:BRIGht? :SYSTem:DISPlay:BRIGht Function: The commands query and set the screen brightness. Parameter: Name Type Range Default Consecutive Integer 0~32 22 Explanations: :SYSTem:DISPlay:BRIGht? – Queries the current screen brightness. :SYSTem:DISPlay:BRIGht - Sets the desired screen brightness within 0 and 32. Return Format: The query returns the current screen brightness. 7.
PAGE 80
RIGOL :SYSTem:DISPlay:CONTrast - Sets the desired screen contrast within 0 and 32. Return Format: The query returns the current screen contrast. 8. :SYSTem:DISPlay:INVErt Command Format: :SYSTem:DISPlay:INVErt Function: The command enables the screen to be displayed inversely.
PAGE 81
RIGOL :TRIGger Commands The commands set the parameters relate to tigger system, which mainly include:          3-56 :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 Programming Guide for DM3058/DM3058E
PAGE 82
RIGOL 1. :TRIGger:SOURce Command Format: :TRIGger:SOURce? :TRIGger:SOURce {AUTO|SINGLE|EXT} Function: The commands query and set the trigger source. Explanations: :TRIGger:SOURce? – Queries the trigger source used currently. :TRIGger:SOURce {AUTO|SINGLE|EXT} – Sets the trigger source to be used. The parameter AUTO, SINGLE, EXT denotes Auto trigger, Single trigger and External trigger, separately. Return Format: The query returns: AUTO, SINGLE or EXT. 2.
PAGE 83
RIGOL In Medium measurement, the default interval is 50 ms and the available range is within 50 ms and 2000 ms; In Slow measurement, the default interval is 400 ms and the available range is within 400 ms and 2000 ms. The default measurement rate is Slow, so the default interval of the multimeter is 400 ms. Return Format: The query returns the current interval of auto trigger (the unit is ms). 3.
PAGE 84
RIGOL Explanations: :TRIGger:AUTO:HOLD:SENSitivity? – Queries the current delay sensitive of auto trigger. :TRIGger:AUTO:HOLD:SENSitivity {|MIN|MAX|DEF} Sets the desired delay sensitive of auto trigger. For the parameter range, see table below: Table 3-11 Delay sensitive of auto trigger Parameter Sensitive 0 (MIN) 0.01% 1 0.1% 2 (DEF) 1% 3 (MAX) 10% Return Format: The query returns: 0, 1, 2 or 3 (see table 3-11). 5.
PAGE 85
RIGOL 6. :TRIGger:SINGle:TRIGgered Command Format: :TRIGger:SINGle:TRIGgered Function: The command enables the multimeter trigger once manually. Explanations: The command is equal to execute a single trigger manually through front panel. 7. :TRIGger:EXT Command Format: :TRIGger:EXT? :TRIGger:EXT {RISE|FALL|HIGH|LOW} Function: The commands query and set the external trigger type. Explanations: :TRIGger:EXT? – Queries the current external trigger type, the default is Rise trigger.
PAGE 86
RIGOL Explanations: :TRIGger:VMComplete:POLAr? – Queries the current VMC output polar, the default is POS (positive). :TRIGger:VMComplete:POLAr {POS|NEG} – Sets the VMC output polar to be used. The parameters provided are positive and negative. Return Format: The query returns the current VMC output polar, POS or NEG. 9. :TRIGger:VMComplete:PULSewidth Command Format: :TRIGger:VMComplete:PULSewidth? :TRIGger:VMComplete:PULSewidth Function: The commands query and set the VMC output pulsewidth.
PAGE 87
RIGOL :UTILity Commands The commands set the communication parameters. Please make sure that communication interface has been connected stably to avoid errors or abnormal phenomena.
PAGE 88
RIGOL 1. :UTILity:INTErface:LAN:DHCP Command Format: :UTILity:INTErface:LAN:DHCP? :UTILity:INTErface:LAN:DHCP {ON|OFF|1|0} Function: The commands query and set the DHCP state. Explanations: :UTILity:INTErface:LAN:DHCP? – Queries if the DHCP is opened. :UTILity:INTErface:LAN:DHCP {ON|OFF|1|0} – Sets the DHCP state to be used. Return Format: The query returns ON (1) or OFF (0). 2.
PAGE 89
RIGOL :UTILity:INTErface:LAN:MANUip? :UTILity:INTErface:LAN:MANUip {ON|OFF|1|0} Function: The commands query and set the state of Manual IP. Explanations: :UTILity:INTErface:LAN:MANUip? – Queries if Manual IP is enabled. :UTILity:INTErface:LAN:MANUip {ON|OFF|1|0} – Sets the state of Manual IP to be used. Return Format: The query returns ON (1) or OFF (0). 4.
PAGE 90
RIGOL 5. :UTILity:INTErface:LAN:MASK Command Format: :UTILity:INTErface:LAN:MASK? :UTILity:INTErface:LAN:MASK Function: The commands query and set the IP mask for LAN connection. Parameter: Name Type Range Default String User-defined 255.255.255.0 Explanations: :UTILity:INTErface:LAN:MASK? – Queries the current IP mask. :UTILity:INTErface:LAN:MASK - Sets the IP mask of the multimeter. Parameter is for user-defined.
PAGE 91
RIGOL Return Format: The query returns the current gateway. 7. :UTILity:INTErface:LAN:DNS Command Format: :UTILity:INTErface:LAN:DNS? :UTILity:INTErface:LAN:DNS Function: The commands query and set the DNS server address for LAN connection. Parameter: Name Type Range Default String User-defined 0.0.0.0 Explanations: :UTILity:INTErface:LAN:DNS? – Queries the current DNS server address. :UTILity:INTErface:LAN:DNS - Sets the desired DNS server address.
PAGE 92
RIGOL Consecutive Integer 0~30 7 Explanations: :UTILity:INTErface:GPIB:ADDRess? – Queries the current GPIB address. :UTILity:INTErface:GPIB:ADDRess - Sets the desired GPIB address within 0 and 30. Return Format: The query returns the current GPIB address. 9. :UTILity:INTErface:RS232:BAUD Command Format: :UTILity:INTErface:RS232:BAUD? :UTILity:INTErface:RS232:BAUD Function: The commands query and set the baud rate of RS232 port.
PAGE 93
RIGOL Function: The commands query and set the parity bit. Explanations: :UTILity:INTErface:RS232:PARIty? – Queries the current parity bit setting. :UTILity:INTErface:RS232:PARIty {NONE|ODD|EVEN} – Sets the desired parity bit. 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.
PAGE 94
RIGOL Chapter 4 Compatible Agilent Commands In ths commands system, all the commands and the return format are ASCII characters. Before using them, send the command CMDSET - CMDSET AGILENT firstly to enable the compatible Agilent commands. The system is case insensitive, and supports the key words abbreviation (the abbreviated letters are capitalized to separat from the whole key words).
PAGE 95
RIGOL CALCulate Commands The commands set the calculation operations, which mainly include:            4-2 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
RIGOL 1. CALCulate:FUNCtion Command Format: CALCulate:FUNCtion {NULL|DB|DBM|AVERage|LIMit} CALCulate:FUNCtion? Function: The commands set and query the calculation function. Explanations: The subsystem must be enabled through CALCulate:STATe {OFF|ON} before using this comamnd. CALCulate:FUNCtion {NULL|DB|DBM|AVERage|LIMit} – Selects the calculation function to be used, the default is NULL. CALCulate:FUNCtion? – Queries the current calculation function.
PAGE 97
RIGOL Explanations: CALCulate:STATe {OFF|ON} - Sets the desired calculation state. CALCulate:STATe? - Queries the current calculation state. Return Format: The query returns: 1 (ON) or 0 (OFF). 3. CALCulate:LIMit:LOWer Command Format: CALCulate:LIMit:LOWer {|MINimum|MAXimum} CALCulate:LIMit:LOWer? [MINimum|MAXimum] Function: The commands set and query the lower limit of current measurement.
PAGE 98
RIGOL CALCulate:LIMit:UPPer {|MINimum|MAXimum} CALCulate:LIMit:UPPer? [MINimum|MAXimum] Function: The commands set and query the upper limit of current measurement. Parameter: Name Type Range Default Consecutive Integer ±120% of MAX range 0 Explanations: The command is valid only when the LIMIT function (CALCulate:FUNCtion LIMIT) is enabled under calculation is active (CALCulate:STATe ON).
PAGE 99
RIGOL Explanations: The command is valid only when the dB function (CALCulate:FUNCtion DB) is enabled under calculation is active (CALCulate:STATe ON). CALCulate:DB:REFerence {|MINimum|MAXimum} - Sets the desired dB reference value. CALCulate:DB:REFerence? [MINimum|MAXimum] - Queries the current dB reference value. MIN = -120 dB; MAX = 120 dB; DEF = 0 dB. Return Format: The query returns the dB reference value. 6.
PAGE 100
RIGOL 7. CALCulate:NULL:OFFSet Command Format: CALCulate:NULL:OFFSet {|MINimum|MAXimum} CALCulate:NULL:OFFSet? [MINimum|MAXimum] Function: The command commands set and query the offset of NULL operation. Parameter: Name Type Range Consecutive Integer ±120% of MAX range Explanations: The command is valid only when the NULL function (CALCulate:FUNCtion NULL) is enabled under calculation is active (CALCulate:STATe ON).
PAGE 101
RIGOL Note the average value could be read any time. Return Format: The query returns the average of all data after calculation. 9. CALCulate:AVERage:COUNt? Command Format: CALCulate:AVERage:COUNt? Function: The command queries the number of data calculated. Explanations: The command is valid only when the calculation function (CALCulate:FUNCtion AVERage) is enabled under calculation is active (CALCulate:STATe ON). Note the number of data could be read any time.
PAGE 102
RIGOL 11. CALCulate:AVERage:MINimum? Command Format: CALCulate:AVERage:MINimum? Function: The command queries the minimum statistic value of current measurement. Explanations: 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.
PAGE 103
RIGOL CONFigure Commands The commands set the basic measurement functions and related parameters, such as range and accuracy, which mainly include:            4-10 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? Programming Guide for DM3058/DM3058E
PAGE 104
RIGOL 1. CONFigure:VOLTage:DC Command Format: CONFigure:VOLTage:DC {|MIN|MAX|DEF},{|MIN|MAX|DEF} Function: The command presets the multimeter as specified range and resolution for DC voltage measurement, but does not start the measurement. Parameter: Name Type Range Default Discrete {200 mV|2 V|20 V |200 V|1000 V|AUTO} AUTO Discrete Refer to Table 4-2 1ppm x range Explanations: The unit is V. For : MIN = 0. 2 (200 mV), MAX = 1000, DEF=AUTO.
PAGE 105
RIGOL The command presets the multimeter as specified range and resolution for AC voltage measurement, but does not start the measurement. Parameter: Name Type Range Default Discrete {200 mV|2 V|20 V |200 V|750 V|AUTO} AUTO Discrete Refer to Table 4-2 1ppm x range Explanations: The unit is V. For : MIN = 0. 2 (200 mV), MAX = 750; DEF=AUTO. relates to both the measurement rate and integration time, see Table 4-2. 3.
PAGE 106
RIGOL 4. CONFigure:CURRent:AC Command Format: CONFigure:CURRent:AC {|MIN|MAX|DEF},{|MIN|MAX|DEF} Function: The command presets the multimeter as specified range and resolution for AC current measurement, but does not start the measurement. Parameter: Name Type Range Default Discrete {20 mA|200 mA|2 A|10 A |AUTO} AUTO Discrete Refer to Table 4-2 1ppm x range Explanations: The unit is A. For : MIN = 0. 02 (20mA); MAX = 10, DEF=AUTO.
PAGE 107
RIGOL Explanations: The unit is Ω. For : MIN = 200; MAX = 100 000 000, DEF=AUTO. relates to both the measurement rate and integration time, see Table 4-2. 6. CONFigure:FRESistance Command Format: CONFigure:FRESistance {|MIN|MAX|DEF},{|MIN|MAX|DEF} Function: The command presets the multimeter as specified range and resolution for 4-wire resistance measurement, but does not start the measurement.
PAGE 108
RIGOL frequency measurement, but does not start the measurement. Parameter: Name Type Range Default Consecutive Real Number 20 Hz~1 MHz AUTO Discrete {MIN|MAX|DEF} 1ppm x range Explanations: All the units are Hz. The may be 20 Hz~1 MHz, thereinto, MAX = 1 000 000, MIN = 20, DEF is auto range. Note that the multimeter uses one “range” for all inputs between 20Hz-1MHz. 8.
PAGE 109
RIGOL 9. CONFigure:CONTinuity Command Format: CONFigure:CONTinuity Function: The command presets the multimeter for continuity measurement, but does not start the measurement. Explanations: The range is fixed at 2 kΩ. 10. CONFigure:DIODe Command Format: CONFigure:DIODe Function: The command presets the multimeter for diode measurement, but does not start the measurement. 11.
PAGE 110
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
RIGOL 1. DATA:FEED RDG_STORE, {"CALCulate"|""} Command Format: DATA:FEED RDG_STORE, {"CALCulate"|""} Function: The command selects whether readings taken using the INITiate command are stored in the multimeter’s internal memory (default) or not stored at all. Note that the command does not execute any actual operation as restricted by working principle. 2. DATA:FEED? Command Format: DATA:FEED? Function: The command queries the storage state of readings, the returned value is "CALC" or "".
PAGE 112
RIGOL DISPlay Commands The commands control the screen, including:    DISPlay:TEXT DISPlay:TEXT:CLEar DISPlay 1. DISPlay:TEXT Command Format: DISPlay:TEXT DISPlay:TEXT? Function: The commands display and query the strings specified by . 2. DISPlay:TEXT:CLEar Command Format: DISPlay:TEXT:CLEar Function: The command clears the information DISPlay:TEXT . 3.
PAGE 113
RIGOL FETCh? Commands 1. FETCh? Command Format: FETCh? Function: The command transfers the readings stored in internal memory to the output buffer.
PAGE 114
RIGOL INITiate Commands 1. INITiate Command Format: INITiate 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 stored in internal memory (up to 512 readings).
PAGE 115
RIGOL INPut Commands 1. 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} is only responsed without practical operation; command INPut:IMPedance:AUTO? Only returns “0”.
PAGE 116
RIGOL MEASure Commands Presets the multimeter as specified range and resolution and executes corresponding measurement, and then sends the readings to the output buffer. The query returns the data stored in output buffer.
PAGE 117
RIGOL 1. MEASure:VOLTage:DC? Command Format: MEASure:VOLTage:DC? {|MIN|MAX|DEF},{|MIN|MAX|DEF} Function: The command presets the multimeter as specified range and resolution and executes DC voltage measurement, and then sends the readings to the output buffer. For the parameter range and other related information, refer to CONFigure:VOLTage:DC. Return Format: The query returns the data stored in output buffer. 2.
PAGE 118
RIGOL The command presets the multimeter as specified range and resolution and executes DC current measurement, and then sends the readings to the output buffer. For the parameter range and other related information, refer to CONFigure:CURRent:DC. Return Format: The query returns the data stored in output buffer. 4.
PAGE 119
RIGOL 6. MEASure:FRESistance? Command Format: MEASure:FRESistance? {|MIN|MAX|DEF},{|MIN|MAX|DEF} Function: The command presets the multimeter as specified range and resolution and executes 4-wire resistance measurement, and then sends the readings to the output buffer. For the parameter range and other related information, refer to CONFigure:FRESistance. Return Format: The query returns the data stored in output buffer. 7.
PAGE 120
RIGOL measurement, and then sends the readings to the output buffer. For the parameter range and other related information, refer to CONFigure:PERiod. Return Format: The query returns the data stored in output buffer. 9. MEASure:CONTinuity? Command Format: MEASure:CONTinuity? Function: The command presets and executes the continuity test and then sends the readings to the output buffer. Explanations: Enable the continuity mesurement. The range is 2 kΩ.
PAGE 121
RIGOL READ? Commands 1. READ? Command Format: 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.
PAGE 122
RIGOL ROUTe Commands 1. 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”.
PAGE 123
RIGOL SENSe Commands The commands set the measurement parameters such as measurement function, range, precision, integration time, and the bandwidth of AC filter, including:                                4-30 [SENSe:]FUNCtion [SENSe:]VOLTage:DC:RANGe [SENSe:]VOLTage:AC:RANGe [SENSe:]CURRent:DC:RANGe [SENSe:]CURRent:AC:RANGe [SENSe:]RESistance:RANGe [SENSe:]FRESistance:RANGe [SENSe:]FREQuency:VOLTage:RANGe [SENSe:]PERiod:VOLTage:RANGe [SENSe:]VOLTage:DC:RANGe:AUTO [SENSe:]V
PAGE 124
RIGOL 1. [SENSe:]FUNCtion Command Format: [SENSe:]FUNCtion "" [SENSe:]FUNCtion? Function: The commands set and query the current measurement function. Parameter: Name Type Range Discrete Refer to Table 4-3 Default — Explanations: [SENSe:]FUNCtion "" – Selects the measurement function to be used. Note this comand has no default value and must be set, see table below. [SENSe:]FUNCtion? – Queries the current measurement function.
PAGE 125
RIGOL The commands set and query the range of DC voltage measurement. Parameter: Name Type Range Default Discrete {200 mV|2 V|20 V |200 V|1000 V} 20 V Explanations: [SENSe:]VOLTage:DC:RANGe {|MINimum|MAXimum} - Sets the desired range of DC voltage measurement from {200mV|2V|20V|200V|1000V}; thereinto, MIN = 200 mV, MAX = 1000 V and the unit is V. If a 200 mV range is required, enter 0.2 as its parameter.
PAGE 126
RIGOL [SENSe:]VOLTage:AC:RANGe? [MINimum|MAXimum] – Queries the range of AC voltage measurement. Return Format: The query returns the range of AC voltage measurement. 4.
PAGE 127
RIGOL Function: The commands set and query the range of AC current measurement. Parameter: Name Type Range Default Discrete { 20 mA|200 mA|2 A|10 A } 200 mA Explanations: [SENSe:]CURRent:AC:RANGe {|MINimum|MAXimum} - Sets the desired range of AC current measurement from {20 mA|200 mA|2 A|10 A }; thereinto, MIN = 20 mA, MAX = 10 A and the unit is A. If a 200 mA range is required, enter 0.2 as its parameter.
PAGE 128
RIGOL [SENSe:]RESistance:RANGe? [MINimum|MAXimum] – Queries the current range 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. Return Format: The query returns the range of 2-wire resistance measurement. 7.
PAGE 129
RIGOL 8. [SENSe:]FREQuency:VOLTage:RANGe Command Format: [SENSe:]FREQuency:VOLTage:RANGe {|MINimum|MAXimum} [SENSe:]FREQuency:VOLTage:RANGe? [MINimum|MAXimum] Function: The commands set and query the voltage range under frequency measurement.
PAGE 130
RIGOL Parameter: Name Type Range Default Discrete {200 mV|2 V|20 V |200 V|750 V} 20 V Explanations: [SENSe:]PERiod:VOLTage:RANGe {|MINimum|MAXimum} - Sets the desired voltage range under period 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. [SENSe:]PERiod:VOLTage:RANGe? [MINimum|MAXimum] –Queries the current voltage range under period measurement.
PAGE 131
RIGOL 11. [SENSe:]VOLTage:AC:RANGe:AUTO Command Format: [SENSe:]VOLTage:AC:RANGe:AUTO {ON|OFF} [SENSe:]VOLTage:AC:RANGe:AUTO? Function: The commands set and query the auto range state of AC voltage measurement. Explanations: [SENSe:]VOLTage:AC:RANGe:AUTO {ON|OFF} - Sets the desired auto range state. If choose ON, the instrument will select a measurement range according to the signal inputted.
PAGE 132
RIGOL 13. [SENSe:]CURRent:AC:RANGe:AUTO Command Format: [SENSe:]CURRent:AC:RANGe:AUTO {ON|OFF} [SENSe:]CURRent:AC:RANGe:AUTO? Function: The commands set and query the auto range state of AC current measurement. Explanations: [SENSe:]CURRent:AC:RANGe:AUTO {ON|OFF}} - Sets the desired auto range state. If choose ON, the instrument will select a measurement range according to the signal inputted. [SENSe:]CURRent:AC:RANGe:AUTO? – Queries the current auto range state of AC current measurement.
PAGE 133
RIGOL Return Format: The query returns the auto range state of 2-wire resistance measurement. 15. [SENSe:]FRESistance:RANGe:AUTO Command Format: [SENSe:]FRESistance:RANGe:AUTO {ON|OFF} [SENSe:]FRESistance:RANGe:AUTO? Function: The commands set and query the auto range state of 4-wire resistance measurement. Explanations: [SENSe:]FRESistance:RANGe:AUTO {ON|OFF} - Sets the desired auto range state of 4-wire resistance measurement.
PAGE 134
RIGOL [SENSe:]FREQuency:VOLTage:RANGe:AUTO {ON|OFF} - Sets the desired auto range state of voltage under frequency measurement. [SENSe:]FREQuency:VOLTage:RANGe:AUTO? – Queries the auto range state of voltage under frequency measurement. The maximum range is 750 V and the virtual value of voltage is decided by waveform. Return Format: The query returns the current auto range state of voltage under frequency measurement. 17.
PAGE 135
RIGOL Function: The commands set and query the precision of DC voltage measurement. Parameter: Name Type Range Default Discrete Refer to Table 4-2 1ppm x range Explanations: [SENSe:]VOLTage:DC:RESolution {|MINimum|MAXimum} – Sets the desired precision of DC voltage measurement. [SENSe:]VOLTage:DC:RESolution? [MINimum|MAXimum] – Queries the current precision of DC voltage measurement. relates to measurement rate and integration time, refer to Table 4-2.
PAGE 136
RIGOL 4-2. Return Format: The query returns the current precision of AC voltage measurement. 20. [SENSe:]CURRent:DC:RESolution Command Format: [SENSe:]CURRent:DC:RESolution {|MINimum|MAXimum} [SENSe:]CURRent:DC:RESolution? [MINimum|MAXimum] Function: The commands set and query the precision of DC current measurement.
PAGE 137
RIGOL Parameter: Name Type Range Default Discrete Refer to Table 4-2 1ppm x range Explanations: [SENSe:]CURRent:AC:RESolution {|MINimum|MAXimum} – Sets the desired precision of AC current measurement [SENSe:]CURRent:AC:RESolution? [MINimum|MAXimum] – Queries the current precision of AC current measurement. relates to measurement rate and integration time, refer to Table 4-2. Return Format: The query returns the current precision of AC current measurement. 22.
PAGE 138
RIGOL setting of resistance. Return Format: The query returns the current precision of 2-wire resistance measurement. 23. [SENSe:]FRESistance:RESolution Command Format: [SENSe:]FRESistance:RESolution {|MINimum|MAXimum} [SENSe:]FRESistance:RESolution? [MINimum|MAXimum] Function: The commands set and query the precision of 4-wire resistance measurement.
PAGE 139
RIGOL Function: The commands set and query the integration time for DC voltage measurement. The inputted and returned values are multiple of PLC. Explanations: [SENSe:]VOLTage:DC:NPLC {0.02|0.2|1|10|100|MINimum|MAXimum} – Sets the desired integration timeintegration time, MIN = 0.02 PLC, MAX = 100 PLC, and the default is 1 PLC. [SENSe:]VOLTage:DC:NPLC? [MINimum|MAXimum] – Queries the current integration time. The integration time relates to resolution and measurement rate, refer to Table 4-2.
PAGE 140
RIGOL 26. [SENSe:]RESistance:NPLC Command Format: [SENSe:]RESistance:NPLC {0.02|0.2|1|10|100|MINimum|MAXimum} [SENSe:]RESistance:NPLC? [MINimum|MAXimum] Function: The commands set and query the integration time for 2-wire resistance measurement. The inputted and returned values are multiple of PLC. Explanations: [SENSe:]RESistance: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 PLC.
PAGE 141
RIGOL PLC. [SENSe:]FRESistance:NPLC? [MINimum|MAXimum] – Queries the integration time of 4-wire resistance measurement. The integration time relates to resolution and measurement rate, 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 setting of resistance. Return Format: The query returns the current integration time of 4-wire resistance measurement. 28.
PAGE 142
RIGOL Function: The commands set and query the aperture time of period measurement. Explanations: [SENSe:]PERiod:APERture {0.01|0.1|1|MINimum|MAXimum} – Sets the desired aperture time for period measurement. The unit is s, MIN=10ms, MAX=1s, and the default is 100ms. [SENSe:]PERiod:APERture? [MINimum|MAXimum] – Queries the aperture time of period measurement. Return Format: The query returns the current aperture time of period measurement. 30.
PAGE 143
RIGOL 31. [SENSe:]ZERO:AUTO Command Format: [SENSe:]ZERO:AUTO {OFF|ONCE|ON} [SENSe:]ZERO:AUTO? Function: The commands set and query the state of zero function. Explanations: [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.
PAGE 144
RIGOL SAMPle Commands 1. SAMPle:COUNt Command Format: SAMPle:COUNt {|MINimum|MAXimum} SAMPle:COUNt? [MINimum|MAXimum] Function: The commands set and query the sample number of the multimeter. Explanations: could be 1~2000. MIN=1, MAX=2000. Return Format: The query returns the sample number of the multimeter.
PAGE 145
RIGOL TRIGger Commands The commands set the trigger parameters such as trigger times, delay time and others. Command “SENSe:: RANGe:AUTO OFF” is suggested to be used for disabling auto range function, and the commands “SENSe::RANGe, CONFigure” or “MEASure?” is for seting range manually.
PAGE 146
RIGOL 1. TRIGger:COUNt Command Format: TRIGger:COUNt {|MINimum|MAXimum|INFinite} TRIGger:COUNt? [MINimum|MAXimum] Function: The commands set and query the trigger times used in multimeter. Parameter: Name Type Range of Values Default Consecutive Integer 1~2000 Parameters must be set Explanations: TRIGger:COUNt {|MINimum|MAXimum|INFinite} - Sets the trigger times to be used. TRIGger:COUNt? [MINimum|MAXimum] - Queries the current trigger times.
PAGE 147
RIGOL TRIGger:DELay {|MINimum|MAXimum} - Sets the desired delay time TRIGger:DELay? [MINimum|MAXimum] - Queries the delay time between trigger and measurement. Return Format: The query returns the the delay time between trigger and measurement. 3. TRIGger:DELay:AUTO Command Format: TRIGger:DELay:AUTO {ON|OFF} TRIGger:DELay:AUTO? Function: The commands set and query the state of delay function in auto trigger mode.
PAGE 148
RIGOL TRIGger:SOURce? – Queries the current trigger source. The possible return value is IMMediate, EXTernal and BUS; thereinto, IMMediate denotes the trigger signal will be generated immediately; EXTernal denotes the external trigger source on the rear panel will be used; BUS (software trigger) denotes the command “*TRG” should be used when the instrument is in “waiting trigger”.
PAGE 149
PAGE 150
RIGOL Chapter 5 Compatible Fluke Commands In this system, all the parameters and the returned formats are ASCII characters with case insensitive.
PAGE 151
RIGOL Function Commands The commands enable the basic measurement funtions of the instrument, which are equal to the corresponding buttons at the front panel, including:           5-2 AAC ADC CLR2 CONT DIODE FREQ FUNC OHMS VAC VDC Programming Guide for DM3058/DM3058E
PAGE 152
RIGOL 1. AAC Command Format: AAC AAC2 Function: The commands enable the AC current measurement for both main and vice display. Explanations: AAC - Enables the AC Current measurement function of main display. AAC2 - Enables the AC Current measurement function of vice display. 2. ADC Command Format: ADC ADC2 Function: The commands enable the DC current measurement for both main and vice display. Explanations: ADC - Enables the DC Current measurement function of main display.
PAGE 153
RIGOL 4. CONT Command Format: CONT Function: The command enables the Continuity test of main display. 5. DIODE Command Format: DIODE Function: The command enables the Diode test of main display. 6. FREQ Command Format: FREQ FREQ2 Function: The command enables the Frequency 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. 7.
PAGE 154
RIGOL The command queries the identifiers of selected function on the main or vice display. Explanations: FUNC1? - Queries the current measurement funtion of main display. FUNC2? - Queries the current measurement funtion of vice display. If the vice display is disabled, an error may be generated when using FUNC2?. Return Format: The query returns the identifiers of current measurement. FUNC1? - The query may return: AAC, ADC, CONT, DIODE, FREQ, OHMS, VAC, VDC.
PAGE 155
RIGOL Explanations: VAC - Enables the AC voltage measurement function of main display. VAC2 - Enables the AC voltage measurement function of vice display. 10. VDC Command Format: VDC VDC2 Function: 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.
PAGE 156
RIGOL Function Regulation Commands The commands enable the regulator of the multimeter, which are equal to the math function at the front panel, including:                DB DBCLR DBREF HOLD HOLDCLR HOLDTHRESH MAX MAXSET MIN MINSET MMCLR MOD? REL RELCLR RELSET Programming Guide for DM3058/DM3058E 5-7
PAGE 157
RIGOL 1. DB Command Format: DB Function: The command enables dB operation. Explanations: The unit of the readings shown on the main display is dB. 2. DBCLR Command Format: DBCLR Function: The command disables dB operation. 3. DBREF Command Format: DBREF DBREF? Function: The commands query and set the reference impedance of dB. Explanations: The value should be within the in table 5-1, or else, errors may occur.
PAGE 158
RIGOL Table 5-1 Reference impedance Parameter Reference impedance Parameter Reference impedance 1 2 12 150 2 4 13 250 3 8 14 300 4 16 15 500 5 50 16 600 6 75 17 800 7 93 18 900 8 110 19 1000 9 124 20 1200 10 125 21 8000 11 135 Return Format: The query returns the parameter relates to selected reference impedance. 4. HOLD Command Format: HOLD Function: The command enables the multimeter enter Touch Hold mode.
PAGE 159
RIGOL The command enables the multimeter exit Touch Hold mode and back to its normal state. 6. HOLDTHRESH Command Format: HOLDTHRESH HOLDTHRESH? Function: The commands set and query the threshold for HOLD measurement. Explanations: HOLDTHRESH - Sets the HOLD threshold to , should be 1, 2, 3 or 4 (which are 0.01%, 0.1%, 1%, 10%, respectively), or else errors may occur. HOLDTHRESH? - Queries the threshold of HOLD measurement.
PAGE 160
RIGOL 8. MAXSET Command Format: MAXSET Function: The command enables the multimeter enter MAX operation with as maximum. Explanations: could be a signed integer, a signed real number without exponent, or a signed real number with exponent, and the new value must be greater than last one. IF is overrange, an Execution Error may generate. The auto range function is disabled in this mode. 9.
PAGE 161
RIGOL Explanations: could be a signed integer, a signed real number without exponent, or a signed real number with exponent, and the new value must be less than last one. IF is overrange, an Execution Error may generate. The auto range function is disabled in this mode. 11. MMCLR Command Format: MMCLR Function: The command enables the multimeter exit the MIN MAX mode, meanwhile the stored minimum and maximum are lost.
PAGE 162
RIGOL 13. REL Command Format: REL Function: The command enables the multimeter enter the REL mode, using the value shown on the main display as the relative base. 14. RELCLR Command Format: RELCLR Function: The command enables the multimeter exit the REL mode and backs into ranging mode. The range selected is the one prior to REL. 15.
PAGE 163
RIGOL 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:     5-14 AUTO FIXED RANGE RATE Programming Guide for DM3058/DM3058E
PAGE 164
RIGOL 1. AUTO Command Format: AUTO AUTO? Function: The commands set and query the auto range mode of the multimeter. Explanations: AUTO - Enables the multimeter enter the auto range mode. If the mode is forbidden to be selected (as the Diode and Continuity function are active), an Execute error may generate. AUTO? – Queries if the multimeter is in auto range mode. Return Format: The query returns 1(Yes) or 0 (No). 2.
PAGE 165
RIGOL on) currently used. RANGE1? – Queries the current range selected by main display. RANGE2? – Queries the current range selected by vice display. If the display is disabled, an Execute error will generate. Table 5-2 Range of every function No.
PAGE 166
RIGOL Measurement Commands The commands query the measured results shown on the main or vice display, including:   MEAS VAL Programming Guide for DM3058/DM3058E 5-17
PAGE 167
RIGOL 1. MEAS Command Format: MEAS? MEAS1? MEAS2? Function: MEAS? - Queries the measured value of the multimeter. If both the two displays are opened, the query returns 2 values, or else only the value on main display is returned. MEAS1? - Queries the measured value from main display. MEAS2? - Queries the measured value from vice display. If the display is disabled, an Execute error may generate. 2. VAL Command Format: VAL? VAL1? VAL2? Function: VAL? - Queries the measured value of the multimeter.
PAGE 168
RIGOL 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 Programming Guide for DM3058/DM3058E 5-19
PAGE 169
RIGOL 1. COMP Command Format: COMP COMP? Function: COMP – Enables the multimeter enter COMP mode, the Touch-Hold is enabled automatically (or you can use HOLDCLR command to disable it). COMP? - Queries the last comparison. Return Format: The query returns the last comparison.
PAGE 170
RIGOL 4. COMPLO Command Format: COMPLO Function: The command sets the lower limit of COMP mode. Explanations: could be a signed integer or a signed real number. 5. 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.
PAGE 171
RIGOL Trigger Commands 1. TRIGGER Command Format: TRIGGER TRIGGER? Function: The commands set and query the trigger type. Explanations: Parameter could only be type 1 and the query returns 1 only as restricted by working principle.
PAGE 172
RIGOL Format Commands 1. FORMAT Command Format: FORMAT FORMAT? Function: The commands set and query the output format. Explanations: could be 1 or 2. 1 denotes a measured value without unit, 2 permits the unit following the value.
PAGE 173
RIGOL Reading Commands 1. SERIAL? Command Format: SERIAL? Function: The command reads the serial number of the multimeter.
PAGE 174
RIGOL Chapter 6 Application Examples This chapter gives some measurement examples based on commands, which will help you use the multimeter effectively. These applications assume that you are familiar with the basic operations of the multimeter. 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.
PAGE 175
RIGOL Example 1: Reading Statistic Purpose: To implement the maximum statistic through commands.
PAGE 176
RIGOL The programming implementations——Agilent Commands 0 1 2 cmdset agilent /* Select Agilent commands */ *CLS /* Clear the instrument state */ *IDN? /* Query the equipment ID and confirm if the multimeter works normally */ 3 /*Return Format: RIGOL Technologies,DM3058,DM3A020080808,99.00.00.00.00.
PAGE 177
RIGOL Example 2: Eliminating the Impedance Errors on Test leads Purpose: To eliminate the impedance errors on test leads.
PAGE 178
RIGOL magnitude comparing with the result in line 9 after the REL operation has been compeleted, so, test succeed.
PAGE 179
RIGOL The programming implementations——Agilent Commands 0 cmdset agilent /* Select Agilent commands */ 1 *CLS /* Clear the instrument state */ 2 *IDN? /* Query the equipment ID and confirm if the multimeter works normally */ 3 /* Return RIGOL Technologies, DM3058, DM3A020080808, 99.00.00.00.00.00*/ 4 conf:res min /* Enable the resistance measurement.
PAGE 180
RIGOL Example 3: dBm Measurement Purpose: Execute the dBm measurement through command. dBm is frequently used in Audio signal measurement and analysis. The programming implementations——RIGOL Commands 0 *RST /* Reset the instrument */ 1 cmdset rigol /* Select Agilent commands */ 2 *IDN? /* Query the equipment ID and confirm if the multimeter works normally */ 3 /* Return RIGOL Technologies,DM3058,DM3A020080808,99.00.00.00.00.
PAGE 181
RIGOL The programming implementations——Agilent Commands 0 *cls /* Clear the instrument state */ 1 cmdset agilent /* Select Agilent commands */ 2 *IDN? /* Query the equipment ID and confirm if the multimeter works normally */ 3 meas:res? auto /* Enable the resistance measurement, auto range; and return the measured value */ 4 /* The returned value is used as the reference resistance for dBm measurement */ 5 conf:volt:ac auto /* Enable AC voltage measuring function and use auto range */ 6 calc:stat on /* Ena
PAGE 182
RIGOL 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.
PAGE 183
RIGOL 2. 3. 6-10 not corresponding query command. 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.
PAGE 184
RIGOL Example 5: P/F Testing Purpose: Use commands to perform a P/F test. P/F operation prompts for the over range voltage signal according to upper/lower limits, and gives a beep (if the beeper is open).
PAGE 185
RIGOL The programming implementations——Agilent Commands 0 *CLS /* Clear the instrument state */ 1 cmdset agilent /**Select Agilent commands */ 2 *IDN? /* Query the equipment ID and confirm if the multimeter works normally */ 3 /* Connect the test leads for DC voltage measurement */ 4 conf:volt:dc /* Set the DC voltage measuring function and the range */ 5 calc:stat on /* Enable the math function */ 6 calc:lim:low /* Set the lower limit to value1*/ 7 calc:lim:upp /* Set the upper l
PAGE 186
RIGOL Example 6: Reading Hold “Reading Hold” function can get a stable reading and hold it on the screen even when test lead pens are removed.
PAGE 187
RIGOL Example 7: Querying the Status Register The status register provided enables user to diagnose the current error operation on the basis of its query function, searching the error reason. 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.
PAGE 188
RIGOL operation status register */ 21 Return 256 22 *ESR? /* Query the event register of the event status register */ 23 Return 0 24 :status:questionable? /* Query the event register of the questionable status register */ 25 Return 0 26 :status:operation?/* Query the event register of the operation status register */ 27 Return 256 28 *cls /* Clear the status */ 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 :measure:voltage:dc? /* Enable DC voltage function and make measu
PAGE 189
RIGOL 56 Return 288 /* change status, execute the single trigger once and enter “wait to trigger” status */ Explanations: 1. Commands in line 2, 28 and 43 clear the current status (the value of the event status register and the error queue) of the status register. By using it every time when you query the register status, the interferences by existing information may be suppressed 2. Commands in line 3~6 set the enable register of each register.
PAGE 190
RIGOL Example 8: Querying the Error Information The status register provided enables user to diagnose the current error operation on the basis of its query function, searching the error reason. 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.
PAGE 191
RIGOL 25 Return 4 26 27 28 29 30 31 32 *cls :function:diode :calculate:statistic:min? SYST:ERR? Return “setting unacceptable” *esr? Return 8 /*Beeping*/ Explanations: 1. Commands in line 2, 9, 15, 21 and 26 clear the current status of the status register, the value of the event status register and the error queue. Execute “*cls” every time when you input new command for quering the register status, in order to suppress interference by information existed in register. 2.
PAGE 192
RIGOL Appendix Incompatible Agilent Commands MEASure:VOLTage:DC:RATio {|MIN|MAX|DEF},{|MIN|MAX|DEF} CONFigure:VOLTage:DC:RATio {|MIN|MAX|DEF},{|MIN|MAX|DEF} [SENSe:]FUNCtion "VOLTage:DC:RATio" CALibration? CALibration:COUNt? CALibration:SECure:CODE CALibration:SECure:STATe {OFF|ON}, CALibration:SECure:STATe? CALibration:STRing CALibration:STRing? CALibration:VALue Incompatible Fluke Commands AACDC* VACDC* DBPOWER DIODE2 ^C (CNT