Rigol DG800 Series Operating instructions

RIGOL
Programming Guide
DG800 Series
Function/Arbitrary Waveform Generator
Jul. 2018
RIGOL (SUZHOU) TECHNOLOGIES INC.

RIGOL
DG800 Programming Guide I
Guaranty and Declaration
Copyright
© 2018 RIGOL (SUZHOU) TECHNOLOGIES INC. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC.
Publication Number
PGB11100-1110
Software Version
00.00.01
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.
Notices
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 specifications and pricing policies at
the company’s sole decision.
Information in this publication replaces all previously released materials.
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.
Product Certification
RIGOL guarantees that this product conforms to the national and industrial standards in China as well as
the ISO9001:2015 standard and the ISO14001:2015 standard. Other international standard conformance
certifications are in progress.
Contact Us
If you have any problem or requirement when using our products or this manual, please contact RIGOL.
E-mail: [e-mail]
Website: www.rigol.com

RIGOL
II DG800 Programming Guide
Document Overview
This manual introduces how to program the signal generator over the remote interfaces in details.
Main Topics in this Manual:
Chapter 1 Programming Overview
This chapter introduces how to build the remote communication between the signal generator and the PC;
how to control the signal generator remotely. It also introduces the syntax, symbols, parameter types, and
abbreviation rules of the SCPI commands.
Chapter 2 Command System
This chapter introduces the syntax, function, parameters, and usages of each DG800 command in A-Z
order.
Chapter 3 Application Instances
This chapter provides the application examples of the main functions of the signal generator. In the
examples, a series of commands are combined to realize the basic functions of the signal generator.
Chapter 4 Programming Examples
This chapter illustrates how to control DG800 by programming in the development environments such as
Visual C++, Visual Basic, and LabVIEW.
Chapter 5 Appendix
This chapter provides the command list and the factory settings.
Tip
For the latest version of this manual, download it from the official website of RIGOL (www.rigol.com).
Format Conventions in this Manual:
1. Keys:
The keys on the front panel are usually denoted by the format of "Key Name (Bold) + Text Box". For
example, Utility denotes the Utility key.
2. Menu Labels:
The menu labels are usually denoted by the format of "Menu Word (Bold) + Character Shading". For
example, System Setting.
3. Operation Procedures:
"" represents the next step of operation. For example, Utility System Setting denotes that first
press Utility on the front panel, and then tap the System Setting menu label.
Content Conventions in this Manual:
DG800 series function/arbitrary waveform generator includes the following models: Unless otherwise
specified, this manual takes DG832 as an example to introduce each command of the DG800 series.

RIGOL
DG800 Programming Guide III
Model
No. of Channels
Max. Output Frequency
DG812
2
10 MHz
DG822
2
25 MHz
DG832
2
35 MHz
DG811
1
10 MHz
DG821
1
25 MHz
DG831
1
35 MHz

RIGOL Contents
IV DG800 Programming Guide
Contents
Guaranty and Declaration.......................................................................................................... I
Document Overview .................................................................................................................II
Chapter 1 Programming Overview..................................................................................... 1-1
Build Remote Communication ....................................................................................................1-2
Remote Control Method.............................................................................................................1-4
SCPI Command Overview..........................................................................................................1-4
Syntax ...............................................................................................................................1-4
Symbol Description.............................................................................................................1-5
Parameter Type..................................................................................................................1-5
Command Abbreviation.......................................................................................................1-6
Chapter 2 Command System.............................................................................................. 2-1
:COUNter Commands ................................................................................................................2-2
:COUPling Commands ...............................................................................................................2-8
:DISPlay Commands................................................................................................................2-19
:HCOPy Commands.................................................................................................................2-21
IEEE488.2 Common Commands...............................................................................................2-22
:LICense Commands ...............................................................................................................2-29
:MEMory Commands ...............................................................................................................2-31
:MMEMory Commands.............................................................................................................2-34
:OUTPut Commands................................................................................................................2-43
:ROSCillator Commands...........................................................................................................2-48
:SOURce Commands ...............................................................................................................2-50
:SOURce:APPLy................................................................................................................2-51
:SOURce:BURSt................................................................................................................2-58
:SOURce:FREQuency ........................................................................................................2-66
:SOURce:FUNCtion ...........................................................................................................2-73
:SOURce:HARMonic..........................................................................................................2-89
:SOURce:MARKer .............................................................................................................2-93
:SOURce[:MOD]:AM .........................................................................................................2-94
:SOURce[:MOD]:ASKey.....................................................................................................2-99
:SOURce[:MOD]:FM........................................................................................................2-102
:SOURce[:MOD]:FSKey...................................................................................................2-106
:SOURce[:MOD]:PM........................................................................................................2-109
:SOURce[:MOD]:PSKey...................................................................................................2-112
:SOURce[:MOD]:PWM.....................................................................................................2-116
:SOURce:MOD................................................................................................................2-120
:SOURce:PERiod.............................................................................................................2-122
:SOURce:PHASe .............................................................................................................2-123
:SOURce:PULSe..............................................................................................................2-124
:SOURce:SUM ................................................................................................................2-126
:SOURce:SWEep.............................................................................................................2-129
:SOURce:TRACe.............................................................................................................2-136
:SOURce:TRACK.............................................................................................................2-137
:SOURce:VOLTage ..........................................................................................................2-137
:SYSTem Commands .............................................................................................................2-142
:TRIGger Commands.............................................................................................................2-156
Chapter 3 Application Instances........................................................................................ 3-1
To Output Basic Waveforms.......................................................................................................3-2
To Output the Arbitrary Waveform..............................................................................................3-2
To Output Harmonic..................................................................................................................3-3
To Output AM Modulated Waveform ...........................................................................................3-3
To Output FSK Modulated Waveform ..........................................................................................3-4

Contents RIGOL
DG800 Programming Guide V
To Output Sweep Waveform......................................................................................................3-4
To Output Burst Waveform........................................................................................................3-5
To Use the Frequency Counter...................................................................................................3-5
Chapter 4 Programming Examples .....................................................................................4-1
Programming Preparations ........................................................................................................4-2
Excel Programming Examples....................................................................................................4-3
Matlab Programming Example ...................................................................................................4-6
LabVIEW Programming Example................................................................................................4-8
Visual Basic Programming Example.......................................................................................... 4-15
Visual C++ Programming Example........................................................................................... 4-18
Chapter 5 Appendix ............................................................................................................5-1
Appendix A: Factory Setting ......................................................................................................5-1
Appendix B: Warranty...............................................................................................................5-5

Chapter 1 Programming Overview RIGOL
DG800 Programming Guide 1-1
Chapter 1 Programming Overview
This chapter introduces how to build the remote communication between the signal generator and the PC;
how to control the signal generator remotely. It also introduces the syntax, symbols, parameter types, and
abbreviation rules of the SCPI commands.
Contents in this chapter:
Build Remote Communication
Remote Control Method
SCPI Command Overview

RIGOL Chapter 1 Programming Overview
1-2 DG800 Programming Guide
Build Remote Communication
You can build the remote communication between DG800 and the PC via the USB (USB DEVICE), LAN
(extended from the USB HOST interface by using the USB-LAN interface converter) or GPIB interface
(extended from the USB HOST interface by using the USB-GPIB interface converter).
Operation Procedures:
1. Install Ultra Sigma (PC) software
Download the Ultra Sigma common PC software from www.rigol.com and install it according to the
instructions.
2. Connect the analyzer to the PC and configure the interface parameters for the instrument
DG800 supports the USB, LAN (extended from the USB HOST interface by using the USB-LAN interface
converter), and GPIB (extended from the USB HOST interface by using the USB-GPIB interface
converter) communication interfaces, as shown in the figure below.
Figure 1-1 DG800 Communication Interface
1) Use the USB interface: connect the USB DEVICE interface on the rear panel of DG800 and the USB
HOST interface of the PC by using a USB cable. The "Found New Hardware Wizard" dialog box will
be displayed and please install the "USB Test and Measurement Device (IVI)" according to the
instructions (refer to "Remote Control via USB" in Chapter 3 "Remote Control" in
DG800 User’s
Guide
).
2) Use the LAN interface:
Make sure that your PC has been accessed to the local area network.
Check whether the local area network where your PC resides supports DHCP or auto IP mode.
If not, you need to acquire the network interface parameters available, such as the IP
address, subnet mask, default gateway, and DNS.
Extend a LAN interface by connecting the USB HOST interface on the rear panel of DG800 by
using the USB-LAN interface converter.
Use the network cable to have DG800 get access to the local area network.
Press Utility Interface LAN to configure the IP address, subnet mask, default
gateway, and DNS.
3) Use the GPIB interface:
Extend a GPIB interface by connecting the USB HOST interface on the rear panel of DG800
by using the USB-GPIB interface converter.
Use the GPIB cable to connect the instrument to your PC.
Press Utility Interface GPIB to set the GPIB address of the instrument.
USB DEVICE
USB HOST