Rigol DM3058 Operating instructions

RIGOL
Programming Guide
DM3058/DM3058E Digital Multimeter
Aug. 2012
RIGOL Technologies, Inc.

RIGOL
Programming Guide for DM3058/DM3058E I
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.

RIGOL
Programming Guide for DM3058/DM3058E
II
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.
Chapter 2 General Commands
Introduce the common commands includes IEEE488 commands, Status subsystem
commands and System commands.
Chapter 3 RIGOL Command System
Introduce the details of each sub-command of RIGOL DM3058/DM3058E digital
multimeter.
Chapter 4 Compatible Agilent Commands
Desrcibe the Agilent commands that are compatible with RIGOL DM3058/DM3058E
digital multimeter in great detail.
Chapter 5 Compatible Fluke Commands
Desrcibe the Fluke commands that are compatible with RIGOL DM3058/DM3058E
digital multimeter in great detail.
Chapter 6 Application Examples
The application examples of RIGOL DM3058/DM3058E digital multimeter commands.
Appendix
List all the incompatible Agilent and Fluke commands.

RIGOL
Programming Guide for DM3058/DM3058E III
Contents
Chapter 1 Introduction ............................................................................1-1
Programming Introduction .........................................................................1-2
Symbol Instruction ....................................................................................1-3
Parameter Types .......................................................................................1-4
Commands in this Manual..........................................................................1-5
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....................................................................................3-45
:SYSTem Commands................................................................................3-51
:TRIGger Commands...............................................................................3-56
:UTILity Commands.................................................................................3-62
Chapter 4 Compatible Agilent Commands ...............................................4-1
CALCulate Commands................................................................................4-2
CONFigure Commands.............................................................................4-10
DATA Commands.....................................................................................4-17
DISPlay Commands.................................................................................4-19
FETCh? Commands..................................................................................4-20
INITiate Commands ................................................................................4-21
INPut Commands....................................................................................4-22
MEASure Commands ...............................................................................4-23
READ? Commands...................................................................................4-28
ROUTe Commands...................................................................................4-29
SENSe Commands...................................................................................4-30
SAMPle Commands..................................................................................4-51

RIGOL
Programming Guide for DM3058/DM3058E
IV
TRIGger Commands................................................................................4-52
Chapter 5 Compatible Fluke Commands.................................................. 5-1
Function Commands..................................................................................5-2
Function Regulation Commands .................................................................5-7
Range and Rate Commands.....................................................................5-14
Measurement Commands.........................................................................5-17
Compare Commands ...............................................................................5-19
Trigger Commands..................................................................................5-22
Format Commands..................................................................................5-23
Reading Commands.................................................................................5-24
Chapter 6 Application Examples.............................................................. 6-1
Example 1: Reading Statistic......................................................................6-2
Example 2: Eliminating the Impedance Errors on Test leads .........................6-4
Example 3: dBm Measurement...................................................................6-7
Example 4: dB Measurement......................................................................6-9
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

RIGOL
Programming Guide for DM3058/DM3058E 1-1
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

RIGOL
Programming Guide for DM3058/DM3058E
1-2
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.
Note*: The GPIB and LAN interfaces are only supported by DM3058.

RIGOL
Programming Guide for DM3058/DM3058E 1-3
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. Braces { }
When several elements separated by a vertical line (|) are enclosed by braces, { },
only one element may be selected. For example, {ON | OFF} indicates that only
ON or OFF may be selected, not both.
4. Triangle Brackets < >
The item enclosed in < > should be replaced by an actual value as a parameter.
5. Square brackets [ ]
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
system will select a default. For example,
[MINimum|MAXimum] can be ignored
in command CALCulate:LIMit:LOWer? [ MINimum|MAXimum] ,while [:EVENt] in
command
STATus:OPERation[:EVENt]? .

RIGOL
Programming Guide for DM3058/DM3058E
1-4
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. Consecutive Real Number Parameter
Under the precision condition, the parameters could be an arbitrary value within
the valid range (usually the default precision takes six effective digits behind the
decimal point). For example, in command :CALCulate:REL:OFFSet,the
parameters meet the range of the real number in Table 3-2.
3. Discrete Parameters
The parameters can only be the cited value. For example, the parameter of
“:MEASure:VOLTage:AC” could only be 0, 1, 2 or 3.
4. Boolean Parameters
The parameters must be ON, OFF, 0 or 1. For example, in command
“SYSTem:BEEPer:STATe”.
5. 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.

RIGOL
Programming Guide for DM3058/DM3058E 1-5
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.
Explanations:
The Agilent commands in this manual refers to Agilent 34401A, and the Fluke
Commands refers to Fluke 45, except where noted.
The RIGOL commands is to be used by default when power-on.

RIGOL
Programming Guide for DM3058/DM3058E
2-2
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

RIGOL
Programming Guide for DM3058/DM3058E 2-3
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

RIGOL
Programming Guide for DM3058/DM3058E
2-4
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 <enable_value>
*ESE?
Function:
The commands set and query the enable value of Event Status Register (ESR).
Explanations:
*ESE <enable_value> - Sets the desired enable value of ESR.
*ESE? - Queries the current enable value of ESR.
<enable_value> - Ranging from 0 to 189.
Return Format:
The query returns the enable value of ESR.
3. *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.

RIGOL
Programming Guide for DM3058/DM3058E 2-5
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.
Return Format:
The query returns “1” , which denotes the current operation has been finished.
6. *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;

RIGOL
Programming Guide for DM3058/DM3058E
2-6
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 <enable_value>
*SRE?
Function:
The commands set and query the enable value of Status Byte Register (STB).
Explanations:
*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.
9. *STB?
Command Format:

RIGOL
Programming Guide for DM3058/DM3058E 2-7
*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. *WAI
Command Format:
*WAI
Function:
The command waits until all pending operations complete.

RIGOL
Programming Guide for DM3058/DM3058E
2-8
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 as well as Output Buffer and Error Queue. The status commands set or query
the 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.

RIGOL
Programming Guide for DM3058/DM3058E 2-9
Figure 2-1 The Status Register diagram
1. STATus:OPERation:CONDition?

RIGOL
Programming Guide for DM3058/DM3058E
2-10
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 <enable_value>
STATus:OPERation:ENABle?
Function:
The commands set or query the value of Enable Register in the Operation Status
Register queue.
Explanations:
STATus:OPERation:ENABle <enable_value> - Sets the value of Enable Register
from Operation Status Register.
<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.
3. STATus:OPERation[:EVENt]?
Command Format:
STATus:OPERation[:EVENt]?

RIGOL
Programming Guide for DM3058/DM3058E 2-11
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. STATus:QUEStionable:CONDition?
Command Format:
STATus:QUEStionable:CONDition?
Function:
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.
6. STATus:QUEStionable:ENABle
Command Format:
STATus:QUEStionable:ENABle <enable value>
STATus:QUEStionable:ENABle?