Rigol Dg4000 series Operating instructions

RIGOL

Programming Guide

DG4000 Series Function/Arbitrary

Waveform Generator



This manual introduces how to program and control RIGOL DG4000 series

function/arbitrary waveform generator using SCPI commands through remote

interfaces (USB or LAN).

Main topics in this manual:

SCPI Overview

Command System

Programming Demos

Command Quick Reference



Software Version:



00.01.12

Software upgrade might change or add product features. Please acquire the

latest version of the manual from RIGOL website or contact RIGOL to upgrade

the software.

Notice:

RIGOL products are covered by P.R.C. and foreign patents, issued and pending.

RIGOL reserves the right to modify or change parts of or all the speciﬁcations

and pricing policies at company’s sole decision.

Information in this publication replaces all previously corresponding material.

Information in this publication is subject to change without notice.

RIGOL shall not be liable for either incidental or consequential losses in

connection with the furnishing, use or performance of this manual as well as any

information contained.

Any part of this document is forbidden to be copied, photocopied or rearranged

without prior written approval of RIGOL.



If you have any problem or requirement when using our products or this manual,

please contact RIGOL.

E-mail: [email protected]

Websites: www.rigol.com



Aug. 2015

Publication Number: PGB04108-1110



SCPI Overview

SCPI (Standard Commands for Programmable Instrument) is a standard

command set for programmable instrument based on IEEE 488.2.

Topics of this chapter:

Syntax

Symbol Description

Parameter Type

Command Abbreviation

Syntax



SCPI commands present a hierarchical tree structure and contain multiple sub-

systems, each of which is made up of a root keyword and one or more sub-

keywords. The command string usually starts with ":", the keywords are

separated by ":" and are followed by the parameter settings available, "?" is

added at the end of the command string to indicate query and the command

and parameter are separated by "space".



For example,

:COUPling:AMPL:DEViation <deviation>

:COUPling:AMPL:DEViation?



COUPling is the root keyword of the command. AMPL and DEViation are the

second-level and third-level keywords respectively. The command string starts

with ":" which separates the multiple-level keywords. <deviation> represents

the parameter available for setting, "?" represents query and the command

:COUPling:AMPL:DEViation and parameter <deviation> are separated by

"space".



"," is generally used for separating diﬀerent parameters contained in the same

command, for example,

:MMEMory:COPY <directory_name>,<ﬁle_name>

Symbol Description



The following four symbols are not the content of SCPI commands and will not

be sent with the commands, but are usually used to describe the parameters in

the commands.



Braces { }

The parameters enclosed in braces are optional and can be ignored or set for

one or more times. For example,

In the [:TRACe]:DATA[:DATA] VOLATILE,<value>{,<value>} command, the

ﬂoating point voltage in {,<value>} can be omitted or be set to one or more

values.



Vertical Bar |

The vertical bar is used to separate multiple parameters and one of the

parameters must be selected when sending the command. For example,

In the :DISPlay:SAVer[:STATe] ON|OFF command, the command parameters

available are "ON" and "OFF".



Triangle Brackets < >

The parameter enclosed in the triangle brackets must be replaced by an

eﬀective value. For example,

Send the :DISPlay:BRIGhtness <brightness>|MINimum|MAXimum command in

:DISPlay:BRIGhtness 10 format.



Square Brackets [ ]

The content (parameter or keyword) enclosed in the square brackets can be

omitted. When the parameter is omitted, the instrument will set the parameter

to its default. For example,

for the [:SOURce<n>]:MOD[:STATe]? command,

sending any of the four commands below can generate the same eﬀect:

:MOD?

:MOD:STATe?

:SOURce1:MOD?

:SOURce1:MOD:STATe?



Parameter Type



The command parameters introduced in this manual include 6 types: Bool,

Keyword, Integer, Consecutive Real Number, Discrete and ASCII Character

String.



Bool

The parameter could be "ON" or "OFF". For example,

:DISPlay:SAVer[:STATe] ON|OFF



Keyword

The parameter could be any of the values listed. For example,

[:SOURce<n>]:BURSt:GATE:POLarity NORMal|INVerted

The parameter could be "NORMal" or "INVerted".



Integer

Unless otherwise noted, the parameter can be any integer within the eﬀective

value range. Note that do not set the parameter to a decimal, otherwise errors

will occur. For example,

:OUTPut[<n>]:LOAD <ohms>|INFinity|MINimum|MAXimum

<ohms> can be set to any integer between 1 and 10000.



Consecutive Real Number

The parameter could be any value within the eﬀective value range according to

the accuracy requirement (the default accuracy contains up to 6 digits after the

decimal points). For example,

[:SOURce<n>]:MOD:AM[:DEPTh] <depth>|MINimum|MAXimum

<depth> can be set to any real number between 0 and 120.



Discrete

The parameter could only be one of the speciﬁed values and these values are

discontinuous. For example,

[:SOURce<n>]:MOD[:STATe] ON|OFF

<n> could only be set to 1 or 2.



ASCII Character String

The parameter should be the combinations of ASCII characters. For example,

:MMEMory:MDIRectory <dir_name>

<dir_name> is a character string.



Explanation: in DG4000 command system, some commands contain the

MAXimum and MINimum parameters. For example,

[:SOURce<n>]:MOD:ASKey:AMPLitude <amplitude>|MINimum|MAXimum

[:SOURce<n>]:MOD:ASKey:AMPLitude? [MINimum|MAXimum]



1. If MAXimum is used as the parameter for a setup command, the speciﬁed

generator parameter will be set to the maximum.

2. If MINimum is used as the parameter for a setup command, the speciﬁed

generator parameter will be set to the minimum.

3. If MAXimum is used as the parameter for a query command, the command

will query the maximum of the speciﬁed generator parameter.

4. If MINimum is used as the parameter for a query command, the command

will query the minimum of the speciﬁed generator parameter.

Command Abbreviation

Since all commands are case-insensitive, you can use any of them. But if

abbreviation is used, all the capital letters in the command must be written

completely. For example,

:SYSTem:COMMunicate:USB:INFormation?

can be abbreviated to

:SYST:COMM:USB:INF?

Command System
 
 
In this chapter, the DG4000 series command subsystems are introduced in
alphabetical order (from A to Z).
COUNter Command Subsystem
COUPling Command Subsystem
DISPlay Command Subsystem
:HCOPy:SDUMp:DATA?
IEEE 488.2 Common Commands
MEMory Command Subsystem
MMEMory Command Subsystem
OUTPut Command Subsystem
PA Command Subsystem
SOURce Command Subsystem
SYSTem Command Subsystem
TRACe Command Subsystem

 
Explanation: in this command set, commands relating to some parameter (such as
frequency and amplitude) settings can be sent with units. The units supported by
these parameters and the default units are as listed in the table below.




Parameter Units

Supported

Default Unit

Frequency MHZ/KHZ/HZ/UHZ HZ

Amplitude VPP/MVPP/VRMS

/MVRMS/DBM

VPP/VRMS/DBM

(depend on the parameter

currently to be set)

Oﬀset/High Level/Low

Level

V/MV V

Time MS/KS/S/US/NS S

Phase ° °

Duty Cycle/Modulation

Depth etc.

% %

● MHZ is equivalent to mHz.

● MVPP is equivalent to mVpp, MVRMS is equivalent to mVrms, MV is equivalent to

mV.

● MS is equivalent to ms.



Note: this manual takes DG4162 as an example to illustrate the ranges of

parameters in the commands.



COUNter Command Subsystem
 
 
:COUNter:ATTenuation 1X|10X 
:COUNter:ATTenuation?
:COUNter:AUTO
:COUNter:COUPing AC|DC 
:COUNter:COUPing?
:COUNter:GATEtime AUTO|USER1|USER2|USER3|USER4|USER5|USER6 
:COUNter:GATEtime?
:COUNter:HF ON|OFF
:COUNter:HF?
:COUNter:IMPedance 50|1M 
:COUNter:IMPedance?
:COUNter:LEVE <value>|MINimum|MAXimum 
:COUNter:LEVE? [MINimum|MAXimum]
:COUNter:MEASure?
:COUNter:SENSitive <value>|MINimum|MAXimum 
:COUNter:SENSitive? [MINimum|MAXimum]
:COUNter[:STATe] ON|OFF 
:COUNter[:STATe]?
:COUNter:STATIstics:CLEAr 
:COUNter:STATIstics:DISPlay DIGITAL|CURVE 
:COUNter:STATIstics:DISPlay?
:COUNter:STATIstics[:STATe] ON|OFF 
:COUNter:STATIstics[:STATe]? 