Rigol DM3000 Series Operating instructions

Programming Guide RIGOL
Publication Number: PGC01107-1110
Apr. 2009
DM3000 Series Digital Multimeter
DM3061/2/3/4
DM3051/2/3/4
© 2008 RIGOL Technologies, Inc. All Rights Reserved.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
I
© 2008 RIGOL Technologies, Inc. All Rights Reserved.
RIGOL products are protected by patent laws in and outside of the P.R. China.
Information in this publication replaces all previous corresponding material.
RIGOL Technologies, Inc. reserves the right to modify or change part of or all the
specifications and pricing policies at company’s sole decision.
NOTE: RIGOL is registered trademark of RIGOL Technologies, Inc.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
II
Summary
This manual provides the guidance for remote control programming of DM3000 series
digital multimeters. 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 DM3000 series multimeter user guide, and been
familiar with the RIGOL DM3000 series multimeter’s operation.
The manual contains four chapters:
Chapter 1
Generalize the methods of using commands;
Chapter 2
Introduce the detailed commands according to the functions of RIGOL DM3000
series digital multimeter;
Chapter 3
List other commands that the RIGOL DM3000 series digital multimeter are
compatible with;
Chapter 4
The application examples of the RIGOL DM3000 series digital multimeter commands.
Index lists all the commands of the RIGOL DM3000 series digital multimeter, and
makes it easier for users to quickly find.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
III
Contents
Chapter 1 Introduction..........................................................................1-1
Programming Introduction .........................................................................1-2
Symbol Instruction ....................................................................................1-3
Parameter Types .......................................................................................1-4
Commands Introduction.............................................................................1-5
Chapter 2 DM3000 Commands Systerm................................................2-1
Common Commands .................................................................................2-2
Function Commands ..................................................................................2-4
Measure Commands ..................................................................................2-9
Precision Commands................................................................................ 2-36
System Commands.................................................................................. 2-44
Utility Commands .................................................................................... 2-54
Trigger Commands .................................................................................. 2-61
Calculate Commands ............................................................................... 2-67
Datalog Commands ................................................................................. 2-76
Scan Commands ..................................................................................... 2-83
Chapter 3 DM3000 Compatible Commands...........................................3-1
Agilent Commands ....................................................................................3-2
Fluke Commands..................................................................................... 3-13
Chapter 4 DM3000 Commands Examples..............................................4-1
Example 1 : Reading Statistic .....................................................................4-2
Example 2 : Elimination of test impedance error ..........................................4-3
Example 3 : dBm Measurement ..................................................................4-4
Index DM3000 Command Quick Reference ...............................................I

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
1-1
Chapter 1 Introduction
This chapter provides the guidance for user to use a RIGOL DM3000 series digital
multimeter for remote control programming correctly, and to achieve a long-distance
measuring operation.
This chapter includes:
Programming Introduction
Symbol Instruction
Parameter Types
Commands Introduction

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
1-2
Programming Introduction
This part intrduces the basic programming operations.These programming commands
provide the methods for remote control to a multimeter.
The Basic operations that you can do with a computer and a multimeter include:
Setup a multimeter.
Measure.
Receive data (equipment working condition or measurement results) from a
multimeter.
A computer can communicate with a multimeter by sending and receiving messages
over an I/O port, such as USB, GPIB port or a RS-232 port. The commands appear as
ASCII strings embedded inside the output statements of a “host” language available
on your computer, so users can control and do the secondary development. Please
refer to the user guide about the connection methods of communication interface.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
1-3
Symbol Instruction
1. Colon :
Commands usually begin with a colon (:). A colon (:) is used to separate a command
keyword from a lower-level keyword. It shows the operation that a multimeter will
implement.
2. Blank Space □
A Blank space is used to separate commands from the program data. If your
command does not need any program data, the blank space is not needed.
3. Interrogation ?
A query is formed by adding an interrogation (?) to the end of the commands. The
query commands usually include different data, and both of them usually divided by a
space □. But some commands don’t include data.
4. 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.
5. Triangle Brackets < >
A item enclosed in < > should be replaced by a numerical value or character string.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
1-4
Parameter Types
1. Consecutive Integer Parameter
The parameters can be any integer only in effective range. Note that do not set the
parameters for decimal format, or else abnormal. For example, setting screen
brightness command ": system: display: bright", the parameter range is from 0 to
255.
2. Consecutive Real Number Parameter
In effective value range, the parameters can be random value according to precision
(usually the default precision takes six effective digits behind decimal point). For
example, setting NULL offset command ": calculate: NULL: offset",the parameters
meet the range of the real number Table 2- 12 indicated.
3. Discrete Parameters
The parameters can only be the cited value. For example, setting AC voltage measure
range command ": measure: voltage: AC", the parameter can only be 0, 1, 2 or 3,
but not other values.
4. Boolean Parameters
The parameters can only be ON or OFF. For example, setting beeper state command
“:system:beeper:state”, the parameter can only be ON or OFF.
5. ASCII Character string
The parameter should be composed of ASCII character string. For example, setting
date command ":system:clock:date”, the parameter can be a character string of
date format.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
1-5
Commands Introduction
To meet the needs of different users, DM3000 provides RIGOL commands and
another two commands that are compatible with the related products.
RIGOL DM3000 commands
The commands compatible with Agilent
The commands compatible with Fluke
Send CMDSET command to change the commands type. For the usage please see
the follows:
Syntax:
CMDSET□{RIGOL|AGILENT|FULUKE}
CMDSET？
Function:
The command sets and queries command types.
The first command parameters include RIGOL，AGILENT and FLUKE, and it means
choosing the corresponding commands.
The second command queries the current commands, and returns the
commands’name.
Parameters:
Name
Type
Range of values
Default
Digital parameter
Discrete
{RIGOL|AGILENT|FLUKE}
RIGOL
Remarks：
If you don’t want to send this commands when strating machine, the default will be
ROGOL.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
2-1
Chapter 2 DM3000 Commands Systerm
In RIGOL DM3000 series digital multimeter commands, all the command parameters
and the returned values are ASCII characters. All the commands do not distinguish the
letter size.
RIGOL DM3000 series digital multimeter includes the following commands
subsystems:
Common Commands
Function Commands
Measure Commands
Precision Commands
System Commands
Utility Commands
Trigger Commands
Calculate Commands
Datalog Commands
Scan Commands

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
2-2
Common Commands
This commands are used to query equipment state and perform some basic
operations.
The commands mainly include:
*IDN？
*RST

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
2-3
1. *IDN？
Syntax:
*IDN？
Function：
The command queries equipment ID, and returns 35 characters at least.
Return Format：
The query returns a character string, and it shows the equipment ID.
2. *RST
Syntax:
*RST
Function:
The command resets the equipment state, and makes it the factory default.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
2-4
Function Commands
The commands are used to set the basic measurement functions, and they equal to
select the measure function buttons in DM3000 front panel.
The commands mainly include：
:function
:function:voltage:DC:ratio
: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

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
2-5
1. :function
Syntax：
:function?
Function：
The command queries the kinds of measure functions.
Return Format：
The query returns the current DM3000 measure function’s shortening. The possible
returned values are: DCV, ACV, DCI, ACI, RESISTANCE, CAPACITANCE, CONTINUITY,
FRESISTANCE, DIODE, FREQUENCY, PERIOD, RATIO.
2. :function:voltage:DC:ratio
Syntax：
:function:voltage:DC:ratio
Function：
The command turns on DC voltage ratio measure function.
Remark：
In “:function?”, this function is corresponding to the returned value“RATIO”.
3. :function:voltage:DC
Syntax：
:function:voltage:DC
Function：
The command turns on DC voltage measure function.
Remark：
In “:function?”, this function is corresponding to the returned value“DCV”.
4. :function:voltage:AC
Syntax：

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
2-6
:function:voltage:AC
Function：
The command turns on AC voltage measure function.
Remark：
In “:function?”, this function is corresponding to the returned value “ACV”.
5. :function:current:DC
Syntax：
:function:current:DC
Function：
The command turns on DC current measure function.
Remark：
In “:function?”, this function is corresponding to the returned value “DCI”.
6. :function:current:AC
Syntax：
:function:current:AC
Function：
The command turns on AC current measure function.
Remark：
In “:function?”, this function is corresponding to the returned value “ACI”.
7. :function:resistance
Syntax：
:function:resistance
Function：
The command turns on resistance measure function.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
2-7
Remark：
In “:function?”, this function is corresponding to the returned value “RESISTANCE”.
8. :function:fresistance
Syntax：
:function:fresistance
Function：
The command turns on fresistance measure function.
Remark：
In “:function?”, this function is corresponding to the returned value “FRESISTANCE”.
9. :function:frequency
Syntax：
:function:frequency
Function：
The command turns on frequency measure function.
Remark：
In “:function?”, this function is corresponding to the returned value “FREQUENCY”.
10. :function:period
Syntax：
:function:period
Function：
The command turns on period measure function.
Remark：
In “:function?”, this function is corresponding to the returned value “PERIOD”.
11. :function:continuity

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DM3000 Series
2-8
Syntax：
:function:continuity
Function：
The command turns on continuity measure function.
Remark：
In “:function?”, this function is corresponding to the returned value “CONTINUITY”.
12. :function:diode
Syntax：
:function:diode
Function：
The command turns on diode measure function.
Remark：
In “:function?”, this function is corresponding to the returned value “DIODE”.
13. :function:capacitance
Syntax：
:function:capacitance
Function：
The command turns on capacitance measure function.
Remarks：
In “:function?”, this function is corresponding to the returned value “CAPACITANCE”.