Rigol DM3061, DM3062, DM3063, DM3064, DM3051 Programming Guide

Programming Guide RIGOL

Publication Number: PGC01107-1110 Apr. 2009

DM3000 Series Digital Multimeter

DM3061/2/3/4

DM3051/2/3/4

RIGOL

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.

Programming Guide for DM3000 Series

RIGOL

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.

Programming Guide for DM3000 Series

RIGOL

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

Programming Guide for DM3000 Series

RIGOL

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

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.

Programming Guide for DM3000 Series

RIGOL

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.

Programming Guide for DM3000 Series

RIGOL

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.

Programming Guide for DM3000 Series

RIGOL

1-5

Name

Type

Range of values

Default

Digital parameter

Discrete

{RIGOL|AGILENT|FLUKE}

RIGOL

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:

Remarks：

If you don’t want to send this commands when strating machine, the default will be ROGOL.

Programming Guide for DM3000 Series

RIGOL

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

2-2

Common Commands

This commands are used to query equipment state and perform some basic operations.

The commands mainly include:

 *IDN？  *RST

Programming Guide for DM3000 Series

RIGOL

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.

Programming Guide for DM3000 Series

RIGOL

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

Programming Guide for DM3000 Series

RIGOL

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：

Programming Guide for DM3000 Series

RIGOL

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.

Programming Guide for DM3000 Series

RIGOL

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

Programming Guide for DM3000 Series

RIGOL

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

Programming Guide for DM3000 Series

RIGOL

2-9

Measure Commands

The commands are used to set measure function further which equal to select measure function buttons in DM3000 front panel.

The commands mainly include：

 :measure?  :measure  :measure:voltage:DC?  :measure:voltage:DC  :measure:voltage:DC:range?  :measure:voltage:DC:impedance  :measure:voltage:DC:digit  :measure:voltage:DC:ratio  :measure:voltage:DC:ratio:digit  :measure:voltage:AC?  :measure:voltage:AC  :measure:voltage:AC:range?  :measure:voltage:AC:filter  :measure:voltage:AC:digit  :measure:voltage:AC:freq?  :measure:voltage:AC:freq:display  :measure:voltage:AC:freq:hide  :measure:voltage:AC:freq:state?  :measure:current:DC?  :measure:current:DC  :measure:current:DC:range?  :measure:current:DC:digit  :measure:current:AC?  :measure:current:AC  :measure:current:AC:range?  :measure:current:AC:digit  :measure:current:AC:freq?

 :measure:current:AC:freq:display  :measure:current:AC:freq:hide  :measure:current:AC:freq:state?  :measure:resistance?  :measure:resistance  :measure:resistance:range?  :measure:resistance:digit  :measure:fresistance?  :measure:fresistance  :measure:fresistance:range  :measure:fresistance:digit  :measure:frequency?  :measure:frequency  :measure:frequency:range?  :measure:frequency:digit  :measure:period?  :measure:period  :measure:period:range?  :measure:period:digit  :measure:continuity?  :measure:continuity  :measure:diode  :measure:diode:digit  :measure:capacitance?  :measure:capacitance  :measure:capacitance:range?  :measure:capacitance:digit

Programming Guide for DM3000 Series

RIGOL

2-10

1. :measure? Syntax：

:measure?

Function： The command queries whether the current measure have been completed.

Explanations：

To query whether the current measure have been completed or not. If “complete” returns “ture”, or else “false”.

Return Format： The query returns true or false.

2. :measure

Syntax： :measure□{AUTO|MANU}

Function：

The command sets measure mode as auto or manual.

Example：

To set as manual: :measure□MANU

3. :measure:voltage:DC?

Syntax：

:measure:voltage:DC?

Function：

The command queries DC voltage.

Return Format：

The query returns the current DC voltage in the form of scientific countity, for example:

8.492853e-05, unit is V

Programming Guide for DM3000 Series

RIGOL

2-11

Name

Type

Range of values

Default

<

range

>

discrete

{0|1|2|3|4}

2

Parameter

DC Voltage Range

Resolution

0

200mV

100 nV

1

2V

1 μV

2

20V

10 μV

3

200V

100 μV

4

1000V

1 mV

MIN

200mV

100 nV

MAX

1000V

1 mV

DEF

20V

10 μV

4. :measure:voltage:DC

Syntax：

:measure:voltage:DC□{<

range

>|MIN|MAX|DEF}

Function：

The command sets the measure range of DC voltage and resolution.

Parameters：

Explanations：

To set the DC voltage range and the resolution at the same time. The measure mode will be changed into manual when setting range Table 2- 1 incdicates the parameters and the resolutions.

Table 2- 1 The DC voltage range and the resolution

Examples：

To set the DC voltage range as 200.0V. :measure:voltage:DC□3

To set the DC voltage range as minimum. :measure:voltage:DC□MIN or :measure:voltage:DC□0

5. :measure:voltage:DC:range?

Syntax：

:measure:voltage:DC:range?

Programming Guide for DM3000 Series

RIGOL

2-12

Function：

The command queries DC voltage range.

Remark：

Please make sure the DC voltage measure must be set at least one time before using this command

Return Format：

The query returns the current range parameter: 0,1,2,3 or 4(see Table 2- 1).

6. :measure:voltage:DC:impedance

Syntax：

:measure:voltage:DC:impedance? :measure:voltage:DC:impedance□{10M|10G}

Function：

The command queries and sets DC voltage impedance.

Explanations：：

:measure:voltage:DC:impedance? returns 10M or 10G(>10G). :measure:voltage:DC:impedance□{10M|10G} sets the DC voltage impedance as 10MΩ or >10GΩ.

Remark：“>10G” is available only in 200mV，2V，20V of the DC voltage range.

Example：

To set the DC voltage impedance as 10GΩ： :measure:voltage:DC:impedance□10G

7. :measure:voltage:DC:digit

Syntax：

:measure:voltage:DC:digit? :measure:voltage:DC:digit□{INC|DEC|5|6|7}

Function：

The command queries and sets the digit of DC voltage.

Programming Guide for DM3000 Series

RIGOL

2-13

Parameter

Meaning

INC

increase digit

DEC

decrease digit

5

the digit is 5

6

the digit is 6

7

the digit is 7

Explanations：

:measure:voltage:DC:digit? queries the digit of the DC voltage. :measure:voltage:DC:digit□{INC|DEC|5|6|7} set the digit of DC voltage. Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC invalid. The table 2-2 indicates the meanings of the digit.

Table 2- 2 The meanings of the digit

Return Format:

:measure:voltage:DC:digit? returns the current digit: 5、6 or 7.

Examples：

To set the digit of the DC voltage as 7: :measure:voltage:DC:digit□7

To decease the digit to 5, please send the following command two times: :measure:voltage:DC:digit□DEC

8. :measure:voltage:DC:ratio

Syntax: :measure:voltage:DC:ratio?

Function:

The command queries the ratio of DC voltages in two circuits.

Remark： At the same time the DC voltages in two circuits should be input in the multimeter.

Return Format:

The query returns the current ratio in the form of 4.656613e-05(for example).

Programming Guide for DM3000 Series

RIGOL

2-14

9. :measure:voltage:DC:ratio:digit

Syntax：

:measure:voltage:DC:ratio:digit? :measure:voltage:DC:ratio:digit□{INC|DEC|5|6|7}

Function：

The command queryies and sets the digit of the ratio of DC voltages in two circuits.

Explanations：

:measure:voltage:DC:ratio:digit? queries the digit of the ratio of the DC voltages in two circuits. :measure:voltage:DC:ratio:digit□

<value>

sets the digit of the ratio of the DC voltages in two circuits. The Table 2- 2 indicates the parameters and their meanings. Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC invalid.

Return Format:

:measure:voltage:DC:ratio:digit? returns the current digit: 5、6 or 7.

Examples：

To set the digit of the ratio as 6: :measure:voltage:DC:ratio:digit□6

To increase the digit to 7: :measure:voltage:DC:ratio:digit□INC

10. :measure:voltage:AC?

Syntax:

:measure:voltage:AC?

Function:

The command queries AC voltage.

Return Format:

The query returns the current AC voltage in the form of 3.941713e-01, unit is V(for example).

Programming Guide for DM3000 Series

RIGOL

2-15

Name

Type

Range of Value

default

<

range>

discrete

{0|1|2|3|4}

2

Parameter

Range

0

200mV

1

2.0V

2

20.0V

3

200.0V

4

750.0V

MIN

200mV

MAX

750V

DEF

20.0V

11. :measure:voltage:AC

Syntax:

:measure:voltage:AC□{<

range>

|MIN|MAX|DEF}

Function:

The command sets the measure range of AC voltage.

Parameters:

Explanations:

The Table 2- 3 lists the parameters and the ranges.

Table 2- 3 The range of AC voltage

Example：

To set the AC voltage range as 750.0V: :measure:voltage:AC□MAX or :measure:voltage:AC□4

12. :measure:voltage:AC:range?

Syntax: :measure:voltage:AC:range?

Function:

The command queries the measure range of AC voltage.

Return Format:

Programming Guide for DM3000 Series

RIGOL

2-16

The query returns the range parameter: 0、1、2、3 or 4(see Table 2- 3).

13. :measure:voltage:AC:filter

Syntax:

:measure:voltage:AC:filter? :measure:voltage:AC:filter□{SLOW|MID|FAST}

Function:

The command queries and sets the speed of AC voltage filter.

Explanations:

:measure:voltage:AC:filter? queries the filter speed. :measure:voltage:AC:filter□{SLOW|MID|FAST} sets the filter speed as “slow”,

“middle”, or “fast”, and the default is “fast”.

Return Format:

:measure:voltage:AC:filter? returns the current filter speed: slow，mid or fast.

Example:

To set the filter speed as “middle”: :measure:voltage:AC:filter□MID

14. :measure:voltage:AC:digit

Syntax:

:measure:voltage:AC:digit? :measure:voltage:AC:digit□{INC|DEC|5|6|7}

Function:

The command queries and sets the digit of AC voltage.

Explanations:

:measure:voltage:AC:digit? queries the digit of the AC voltage. :measure:voltage:AC:digit□{INC|DEC|5|6|7} sets the digit of the AC voltage. The Table 2- 2 indicates the parameters and their meanings. Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC invalid.

Programming Guide for DM3000 Series

RIGOL

2-17

Return Format: :measure:voltage:AC:digit? returns the current digit of the AC voltage: 5、6 or 7.

Example:

To set the digit as 7: :measure:voltage:AC:digit□7

15. :measure:voltage:AC:freq?

Syntax: :measure:voltage:AC:freq?

Function:

The command queries AC voltage frequency.

Remarks:

Before sending the command, please turn on AC voltage measure function.

Return Format:

The query returns the current frequency in the form of 5.000000e+01, and unit is Hz. (for example)

16. :measure:voltage:AC:freq:display

Syntax: :measure:voltage:AC:freq:display

Function:

The command displays frequency on the secondary screen while measuring the AC voltage.

17. :measure:voltage:AC:freq:hide

Syntax: :measure:voltage:AC:freq:hide

Function:

The command hides frequency on the secondary screen while measuring AC voltage.

Programming Guide for DM3000 Series

RIGOL

2-18

Name

Type

Range of Value

Default

< range >

discrete

{0|1|2|3|4 }

0

Remarks: When the frequency display is on in measuring AC voltage, the command is invalid.

18. :measure:voltage:AC:freq:state?

Syntax:

:measure:voltage:AC:freq:state?

Function:

The command queries whether the frequncy displays on the secondary screen in measuring AC voltage.

Return Format:

The query returns the current state: display or hide.

19. :measure:current:DC?

Syntax:

:measure:current:DC?

Function:

The command queries DC current.

Return Format:

The query returns the DC current in the form of 9.674418e-05, and unit is A.

20. :measure:current:DC

Syntax:

:measure:current:DC□{<

range

>|MIN|MAX|DEF}

Function:

The command sets the measure range of DC current.

Parameters:

Programming Guide for DM3000 Series

Rigol DM3061, DM3062, DM3063, DM3064, DM3051 Programming Guide

Specifications and Main Features

Frequently Asked Questions

User Manual