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.
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 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.
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.
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.
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:
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”.
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
: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).
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).
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.
To set the measurement range of DC current and the resolution at the same time.
The measure mode will be changed into manual when setting range.
The table 2-4 indicates the current ranges and the resolutions.
Table 2- 4 The DC current ranges and their resolutions
Example:
To set the DC current range as 10.0A:
:measure:current:DC□MAX or :measure:current:DC□4
21. :measure:current:DC:range?
Syntax:
:measure:current:DC:range?
Function:
The command queries the measure range of DC current.
Return Format:
The query returns the current range parameter: 0、1、2、3 or 4.(see Table 2- 4)
The command queries and sets the digit of DC current.
Explanations:
:measure:current:DC:digit? queries the digit of the DC current.
:measure:current:DC:digit□{INC|DEC|5|6|7} sets the digit of the DC current.
The Table 2- 2 indicates the meanings of the digit.
Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC
invalid.
Return Format:
:measure:current:DC:digit? returns the current digit : 5, 6 or 7.
Example:
To set the digit as 6:
:measure:current:DC:digit□6
23. :measure:current:AC?
Syntax:
:measure:current:AC?
Function:
The command queries AC current.
Return Format:
The query returns the current in the form of 9.293791e-05, and unit is A. (For
example)
The command queries and sets the digit of AC current.
Explanations:
:measure:current:AC:digit? queries the digit of the AC current. Before sending the
command, please turn on AC current measure function.
:measure:current:AC:digit□{INC|DEC|5|6|7} sets the digit of the AC current.
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:current:AC:digit? returns the current digit: 5、6 or 7.
Example:
To set the digit as 7:
:measure:current:AC:digit□7
27. :measure:current:AC:freq?
Syntax:
:measure:current:AC:freq?
Function:
The command queries the measure frequency of AC current.
Return Format:
The query returns the current frequency in the form of 5.000000e+01, and unit is Hz.
(for example)
The command queries and sets the digit of two circuits resistance.
Explanations:
:measure:resistance:digit? queries the digit of the two circuits resistance.
:measure:resistance:digit□{INC|DEC|5|6|7} sets the digit of the two circuits
resistance.
Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC
invalid.
Return Format:
:measure:resistance:digit? returns the digit of the current resistance: 5、6 or 7.
Example:
To set the digit as 6:
:measure:resistance:digit□6
The command queries and sets the digit of four circuits resistance.
Explanations:
:measure:fresistance:digit? queries the digit of the four circuits resistance.
:measure:fresistance:digit□{INC|DEC|5|6|7} sets the digit of the four circuits
resistance.
Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC
invalid.
Return Format:
:measure:fresistance:digit? returns the current digit. The Table 2- 2 indicates the
meanings.
Example:
To set the digit as 6:
:measure:resistance:digit□6
39. :measure:frequency?
Syntax:
:measure:frequency?
Function:
The command queries frequency.
Remark:
The range of frequency is 3Hz~300kHz.
Return Format:
The query returns the current frequency in the form of 8.485240e-05, and unit is Hz.
(for example)
The command queries and sets the digit of frequency.
Explanations:
:measure:frequency:digit? queries the digit of the frequency. Before sending the
command, please turn on frequency measure function.
:measure:frequency:digit□{INC|DEC|5|6|7} sets the digit of the frequency. The
Table 2- 2 indicates the meanings of the digit.
Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC
invalid.
Return Format:
:measure:frequency:digit? returns the current digit: 5、6 or 7.
Example:
To set the digit as 6:
:measure:frequency:digit□6
43. :measure:period?
Syntax:
:measure:period?
Function:
The command queries period.
Return Format:
The query returns the current AC period in the form of 9.185433e-05, and unit is s.
(for example)
:measure:period:digit? queries the digit of the period. Before sending the command,
please turn on period measure function.
:measure:period:digit□{INC|DEC|5|6|7} sets the digit of the period. The Table 2- 2
indicates the parameters and the ranges.
Remarks: If the showing digit reachs 5, DEC command will be invalid. If 7,INC
invalid.
Return Format:
:measure:period:digit? returns the current digit: 5、6 or 7.
Example:
To set the digit as 6:
:measure:period:digit□6
47. :measure:continuity?
Syntax:
:measure:continuity?
Function:
The command qureies resistance in the state of short circuit.
Return Format:
The query returns the current resistance in the form of 8.888000e+03, and unit is Ω.
(For example)
48. :measure:continuity
Syntax:
:measure:continuity□{
<range>
|MIN|MAX|DEF}
Function:
The command sets the limit resistance in measuring short circurt.
The resistance range is a consecutive Integer among 1Ω~2000Ω.
The default resistance is 10Ω. MAX denotes the maximum is 2000Ω. MIN denotes the
minimum is 1Ω. DEF denotes the default is 10Ω.
Example:
To set the limit resistance as 1KΩ:
:measure:continuity□1000
49. :measure:diode?
Syntax:
:measure:diode?
Function:
The command queries diode voltage at both ends.
Remarks:
In measuring diode, the beep condition is 0.1V≤V
measured
≤2.4 V.
Return Format:
The query returns the current diode voltage in the form of 4.492510e-04, and unit is V.
(for examole)
:measure:capacitance:digit? queries the digit of the capacitance.
:measure:capacitance:digit□{INC|DEC|5|6|7} sets the digit of the capacitance.
The Table 2- 2 indicates the parameters and their meanings.
Return Format:
:measure:capacitance:digit? returns the current digit: 5、6 or 7.
The command queries and sets the measure precision of DC voltage.
Parameters:
Explanations:
:resolution:voltage:DC? queries the measure precision of the DC voltage. Before
sending the command, please turn on DC voltage measure function.
:resolution:voltage:DC□{
<range>
|MIN|MAX|DEF} sets the measure precision of the
DC voltage.
The Table 2- 8 indicates the parameters and their meanings.
Table 2- 8 The DC parameters and their meanings
Return Format:
:resolution:voltage:DC? returns the current precision parameter: 0、1 or 2.(see Table
2- 8)
Example:
To set the measure precision of the DC voltage as 5 ½ :
:resolution:voltage:DC□1
The command queries and sets the measure precision of DC voltage ratio.
Parameters:
Explanations:
:resolution:voltage:DC:ratio? queries the measure precision of the DC voltage ratio.
Before sending the command, please turn on DC voltage ratio measure function.
:resolution:voltage:DC:ratio□{
<range>
|MIN|MAX|DEF} sets the measure precision
of the DC voltage ratio.
The Table 2- 8 indicates the parameters and their meanings.
Return Format:
:resolution:voltage:DC:ratio? returns the current parameter: 0、1 or 2.(see Table 2- 8)
Example:
To set the measurement precision of the DC voltage ratio as 5 ½ :
:resolution:voltage:DC:ratio□1
:resolution:voltage: AC? queries the measure precision of the AC voltage. Before
sending the command, please turn on AC voltage measure function.
:resolution:voltage: AC□{
<range>
|MIN|MAX|DEF} sets the measure precision of the
AC voltage.
The Table 2- 9 indicates the parameters and their meanings.
Table 2- 9 The AC parameters and their meanings
Return Format:
:resolution:voltage: AC? returns the current parameter: 0、1 or 2.(see Table 2- 8)
Example:
To set the measurement precision of the AC voltage as 5 ½ :
:resolution:voltage:AC□2
4. :resolution:current:DC
Syntax:
:resolution:current:DC?
:resolution:current:DC□{
Function:
The command queries and sets the measure precision of DC current.
Parameters:
Explanations:
:resolution:current:DC? queries the measure precision of the DC current. Before
sending the command, please turn on DC current measure function.
:resolution:current:DC□{
<range>
|MIN|MAX|DEF} sets the measurement precision
of the DC current.
The Table 2- 8 indicates the parameters and their meanings.
Return Format:
:resolution:current:DC? returns the current parameter: 0、1 or 2.(see Table 2- 8)
Example:
To set the measure precision of the DC current as 5 ½ :
:resolution:current:DC□1
5. :resolution:current:AC
Syntax:
:resolution:current:AC?
:resolution:current:AC□{
<range>
|MIN|MAX|DEF}
Function:
The command queries and sets the measure precision of AC current.
Parameters:
Explanations:
:resolution:current:AC? queries the measure precision of the AC current. Before
sending the command, please turn on AC current measure function.
:resolution:current:AC□{
<range>
|MIN|MAX|DEF} sets the measure precision of the
AC current.
The Table 2- 9 indicates the parameters and their meanings.
Return Format:
:resolution:current:AC? returns the current parameter: 0、1 or 2.(see Table 2- 9)
Example:
To sets the measure precision of the AC current as 5 ½ :
:resolution: current:AC□2
The command queries and sets the measure precision of two circuits resistance.
Parameters:
Explanations:
:resolution:resistance? queries the measure precision of the two circuits resistance.
Before sending the command, please turn on two circuit resistance measure function.
:resolution:resistance□{
<range>
|MIN|MAX|DEF} sets the measure precision of the
two circuits resistance.
The Table 2- 8 indicates the parameters and their meanings.
Return Format:
:resolution:resistance? returns the current parameter: 0、1 or 2.(see Table 2- 8)
Example:
To set the measure precision of the two circuits resistance as 5 ½ :
:resolution:resistance□1
:resolution:fresistance? queries the measure precision of the four circuit resistance.
Before sending the command, please turn on four circuits resistance measure
function.
:resolution:fresistance□{
<range>
|MIN|MAX|DEF} sets the measure precision of the
four circuit resistance.
The Table 2- 8 indicates the parameters and their meanings.
Return Format:
:resolution:fresistance? returns the current parameter: 0、1 or 2.(see Table 2- 8)
Example:
To set the measure precision of the four circuit resistance as 5 ½ :
:resolution:fresistance□1
The command queries and sets the measure precision of capacitance.
Parameters:
Explanations:
:resolution:capacitance? queries the capacitance measure precision. Before sending
the command, please turn on capacitance measure function.
:resolution:capacitance□{
<range>
|MIN|MAX|DEF} sets the capacitance measure
precision.The Table 2- 8 indicates the parameters and their meanings.
The command is used to set the system parameters as the last setting or the system
default when powering on. “LAST” means to read the last setting, and “DEFAULT”
means the system default.
4. :system:configure:default
Syntax:
:system:configure:default
Function:
The command sets system default.
Explanation:
The command sets the system setting as default.
5. :system:language
Syntax:
:system:language?
:system:language□
<value>
Function:
The command queries and sets system language category.
The command queries and sets radix point format used in system.
Parameters:
Explanations:
:system:format:decimal? queries the radix point format.
:system:format:decimal□
<value>
sets the radix point format. “COMMA” means to
use “,” as a radix point, and at the same time the former “,” is changed into “.”. “DOT”
means to use “·” as a radix point, meanwhile the former “.” is changed into “,”. Remarks: As it is easier to change the format of data separator by using this
commond, so please do it carefully.
Return Format:
:system:format:decimal? returns the current radix point format.: COMMA or DOT.
10. :system:format:separate
Syntax:
:system:format:separate?
:system:format:separate□
<value>
Function:
The command queries and sets the format of system separator.
Parameters:
Explanations:
:system:format:separate? queries the system data separator format.
:system:format:separate□
<value>
sets the system data separator format.
“ON” denotes displaying the seperator, “NONE” denotes not displaying the spererator,
and “SPACE” denotes that a space replaces the separator.
The commands are used to set communication control and self-inspection. Before
controlling communication, please make sure that communication interface has been
connected stably, otherwise it possiblely to be abnormal or wrong.
The command queries and sets communication parity bit of serial interface(RS232).
Parameters:
Explanations:
:utility:interface:RS232:parity? queries the RS232 parity bit.
:utility:interface:RS232:parity□
<value>
sets the RS232 parity bit.
Return Format:
:utility:interface:RS232:parity? returns the current parity bit. The range of the
returned value is the same as the setting parameter. It respectively means “none
parity, 8 bits”,“odd, 7bits”, and “even, 7bits”.
The command queries and sets trigger mode in measuring.
Parameters:
Return Format:
:trigger:source? returns the current trigger mode: auto、single or ext, and they
respectively denotes “automatic trigger”,“single trigger”, and “exterior trigger”.
2. :trigger:auto:interval
Syntax:
:trigger:auto:interval?
:trigger:auto:interval□
<value>
Function:
The command queries and sets display interval.
Parameters:
Return Format:
:trigger:auto:interval? returns the current display interval.
:trigger:auto:interval□
<value>
sets the display interval. The range of value: the
resolution is 4½ , 30~2000ms, and the default is 30ms; the resolution is 5½ ,
200~2000ms, and the default is 200ms; the resolution is 6½ , 400~2000ms, and the
default is 400ms.
Remarks: For ACV and ACI measurement, the range of value: the resolution is 3½ ,
30~2000ms, and the default is 30ms; the resolution is 4½ , 200~2000ms, and the
default is 200ms; the resolution is 5½ , 400~2000ms, and the default is 400ms.
3. :trigger:auto:hold
Syntax:
:trigger:auto:hold?
:trigger:auto:hold□
<value>
Function:
The command queries and sets auto trigger delay state.
Parameters:
Return Format:
:trigger:auto:hold? returns the current auto trigger delay state. “ON” means the delay
is on, and “OFF”means off.
:trigger:vmcomplete:polar? queries the VMC output polar, and the default is positive.
:trigger:vmcomplete:polar□
include {POS|NEG}, and respectively means “positive polar” and “negative polar”.
The command queries and sets VMC output pulsewidth.
Parameters:
Explanations:
:trigger:vmcomplete:pulsewidth? queries the VMC output pulsewidth.
:trigger:vmcomplete:pulsewidth□
<value>
sets the VMC output pulsewidth. The
range of value: the resolution is 4½ , 1~30ms, and the default is 30ms; the resolution
is 5½ , 1~200ms, and the default is 100ms; the resolution is 6½ , 1~400ms, and the
default is 100ms.
Remarks: For ACV and ACI measurement, the range of value: the resolution is 3½ ,
1~30ms, and the default is 30ms; the resolution is 4½ , 1~200ms, and the default is
100ms; the resolution is 5½ , 1~400ms, and the default is 100ms.
Return Format:
:trigger:vmcomplete:pulsewidth? returns the current VMC output pulsewidth.
The command queries measure number in calculation.
Remark:
The command is available to the current measure operation.
Return Format:
The query returns the current measure number.
6. :calculate:NULL:offset
Syntax:
:calculate:NULL:offset?
:calculate:NULL:offset□
<value>
Function:
The command queries and sets NULL calculation offset.
Parameters:
Explanations:
:calculate:NULL:offset? queries the NULL calculation offset.
:calculate:NULL:offset□
For the parameter range please see the follows:
<range>
varies with the measurement. See Table 2- 12. All the values can be set
7digits after a demical point. MAX denotes the maximum, and MIN denotes the
minimum. All the value is just available to the corresponding measurement.
:calculate:DB:reference? queries the dB reference value.
:calculate:DB:reference□
<value>
sets the dB reference value.
When setting dB reference value, the value is an integer, and the range is between
+120dB and -120dB. MIN denotes -120dB, MAX denotes +120dB, and DEF denotes 0.
Return Format:
:calculate:DB:reference? returns the current dB reference value.
The command queries and sets dBm reference resistance.
Parameters:
Explanations:
:calculate:DBM:reference? queries the dBm reference resistance.
:calculate:DBM:reference□
<value>
sets the dBm reference resistance.
When setting dBm reference resistance, the value should be an integer, and the range
is between 2 and 8000, unit is Ω. MIN denotes 2Ω, MAX denotes 8000Ω, and DEF
denotes 600Ω.
The command queries and sets the datalog function.
Explanations:
:configure:function? queries the current datalog function.
:configure:function□
<DCV,DCI,2WR,4WR>,< range>
sets the datalog function. The
first parameter including DCV,DCI,2WR and 4WR shows the datalog type.; the second
paramater shows the correspanding range.
Remarks: the auto range is unavailable for the datalog function. The lower level of
the range is 1; and the upper level is related with the set function. The upper level of
DCV range is 5; the upper level of DCI is 5; the upper level of 2WR is 7; and the upper
level of 4WR is 7.
Return Format:
:datalog:configure:function? returns the corresponding range parameters of
DCV,DCI,2WR or 4WR.
The command queries the startmode of the scan function.
Return Format:
:datalog:configure:startmode? returns the startmode name: Auto or Extern. The
delay startmode is considered as Auto, and by quering the delay time, you can be sure
whether the delay startmode is on.
4. :datalog:configure:startmode:auto
Syntax:
:datalog:configure:startmode:auto
Function:
The command sets the datalog startmode as auto.
Explanation:
If you have set the delay time, the datalog system starts automatically when the delay
time is reached. If not, the datalog system starts the datalog function when the
command is received.
5. :datalog:configure:startmode:extern
Syntax:
:datalog:configure:startmode:extern
Function:
The command sets the scan startmode as extern.
Explanations:
After receiving this order, if not acquire the trigger signal, the system will be in wait
state. Until the advent of triggering signals, datalog system starts. Please refer to the
manual about the setting and requirement of the trigger signal.
The command queries and sets the delay time of auto startmode.
Explanations:
:datalog:configure:startmode:delaytime? queries the delay time of auto startmode.
:datalog:configure:startmode:delaytime□
<value>
sets the delay time of auto
startmode. The value is the delay time you will set, the default unit is s. The range of
the value is 0 ~ 3600s.
Return Format:
:datalog:configure:startmode:delaytime? returns the delay time in auto startmode,
and the default unit is s.
7. :datalog:configure:stopmode?
Syntax:
:datalog:configure:stopmode?
Function:
The command queries the stop condition of datalog function.
Explanation:
:datalog:configure:stopmode? queries the stop condition of datalog function.
Return Format:
:datalog:configure:startmode:delaytime? returns “Time” or “Number”, respectively
showing the datalog system stops according to the set time or the datalog number.
The command queries and sets the sample rate of datalog function.
Explanations:
:datalog:configure:rate? queries the sample rate of datalog function.
:datalog:configure:rate□
<range>
sets the sample rate of datalog function, the range
is 1~13, respectively showing the sample rate is 1/10min, 1/5min, 1/min, 1/10s, 1/s,
10/s, 50/s, 100/s, 833/s, 1K/s, 5K/s, 10K/s, 50K/s.
Return Format:
:datalog:configure:rate?returns the range of the current sample rate : 1~13.
11. :datalog:run
Syntax:
:datalog:run
Function:
The command runs the datalog function according to the startmode。
Explanation:
Before sending the command, you should send “:datalog:configure” to set the datalog
function and range. Or else the system will not run, and return the wrong sign.
12. :datalog:stop
Syntax:
:datalog:stop
Function:
The command stops the datalog function.
13. :datalog:fetchdata
Syntax:
:datalog:fetchdata□
<value>
Function:
The command fetches the data the datalog system acquire.(32 digits binary format
data)
fetches the data the datalog system acquire. The
instrument can storage data for 2097152, and the command can acquire a data
packet every time, including 512 sampling data and occuping the storage space for 2K.
The value is the serial number of the data packet, the range is 1 ~ 4096. Every datalog
starts storaging from the first packet. The sencondary developmant of the PC
programm needs RIGOL drive programm and dynamic link library to change the
obtained 32 digits binary data into floating-point-type data, and calculates the
numbers of the effective data and pick up. Please refer to RIGOL Demo programm
about the use methods of the programm.
Return Format:
:datalog:fetchdata□
<value>
returns the data packet in the form of 32digits binary
:scan:create□
not set the project name, but you must use the command for the initialization. Or else
the system can not runs the latter operation, and returns the wrong sign.
2. :scan:addtask
Syntax:
:scan:addtask□
<value>
<value>
creates the project. The value is the project name. You may
<value1>,<value2>,
…...
,<value7>
Function:
The command adds the task for the scan project.
Explanations:
:scan:addtask□
including task number, channel, function, precision, sampling number and delay time.
Their parameter ranges are shown in Table 2- 14. You only can add the task in number
order. If the two task have the same number, the previous setting will be changed.
<value>
Table 2- 14 The Task Parameter and Their Range
adds a scan task, the value are the new task’s parameters,
*1Note: the scan channel includes 1~16, the channel 1~12 is connected
for measuring DCV, ACV, DCI, ACI, 2WR, FREQ, PERI, CAP, DIODE. The
channel 13~16 is connected for measuring DCV, ACV, DCI, ACI and 2WR.
*2Note: the different measure function have the different range, thereinto:
When DCV measurement, range parameters can be 0, 1, 2, 3 or 4;
When ACV measurement, range parameters can be 0, 1, 2, 3 or 4;
When DCI measurement, range parameters can be 0, 1, 2, 3 or 4;
When ACI measurement, range parameters can be 0, 1, 2 or 3;
When 2WR measurement, range parameters can be 0, 1, 2, 3, 4, 5 or 6;
When FREQ measurement, range parameters can be 0, 1, 2, 3 or 4;
When PERI measurement, range parameters can be 0, 1, 2, 3 or 4;
When CAP measurement, range parameters can be 0, 1, 2, 3, 4 or 5.
*3Note: ultimeter respectively shows the range as 4 ½ , 5 ½ ,6 ½ ; for 5 ½ digits
multimeter respectively shows the range as 3 ½ , 4 ½ ,5 ½ .
*4Note: Delay Time can be integer or decimal within 0~3600, please follow the
rules of rounding if using decimal format.
3. :scan:deletetask
Syntax:
:scan:deletetask□
<value>
Function:
The command deletes the added task.
Explanations:
:scan:deletetask□
<value>
deletes the added task, the value is the deleted task
number, and the range is 0~99. If the middle task is deleted, the latter task moves
forward in order.
4. :scan:intervaltime
Syntax:
:scan:intervaltime□
Function:
The command sets the interval time of the project cycle.
Explanations:
:scan:intervaltime□
<value>
<value>
sets the interval time of the project cycle. The value is
the interval time you will set, and the unit is s. When the project cycle number is
greater than 1, the command sets the interval time between the close project cycles.
5. :scan:run
Syntax:
:scan:run
Function:
The command circulates the current project one time.
6. :scan:run:cycle
Syntax:
:scan:run:cycle□
<value>
Function:
The command sets the project cycle number, and runs the current project.
Explanations:
:scan:run:cycle□
<value>
sets the project cycle number, and runs the current project.
The value is the cycle number.
7. :scan:stop
Syntax:
:scan:stop
Function:
The command forces to stop the scan task in operating.
8. :scan:list:task
Syntax:
:scan:list:task□
<value>
Function:
The command lists all the task of the setting project.
lists the task table of the setting project. The value is the
project number. If don’t set the project number, the command lists the task table of
the current project.
Return Format:
:scan:list:task□
<value>
returns the task table of the setting project in the form of :
<task number>:channel, range, precision, sampling number and function.
9. :scan:list:project
Syntax:
:scan:list:project
Function:
The command returns the table of all the project names in DM3000 local storage.
10. :scan:current:cycle
Syntax:
:scan:current:cycle?
Function:
The command queries the cycle number completed.
Return Format:
:scan:current:cycle? returns the cycle number completed.
11. :scan:current:projname
Syntax:
:scan:current:projname?
Function:
The command queries the project name in current cache.
Return Format:
:scan:current:projname? queries the project name in current cache. If there is not any
project in cache, return the right sign “R”.