Rigol DG972 Operating instructions

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

RIGOL
DG900 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
PGB10100-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 DG900 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 DG900 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 DG900 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:
DG900 series function/arbitrary waveform generator includes the following models: Unless otherwise
specified, this manual takes DG992 as an example to introduce each command of the DG900 series.
Model
No. of Channels
Max. Output Frequency
DG952
2
50 MHz
DG972
2
70 MHz
DG992
2
100 MHz

RIGOL Contents
III DG900 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
:MEMory Commands............................................................................................................... 2-28
:MMEMory Commands ............................................................................................................ 2-31
:OUTPut Commands ............................................................................................................... 2-40
:ROSCillator Commands.......................................................................................................... 2-45
:SOURce Commands............................................................................................................... 2-47
:SOURce:APPLy................................................................................................................ 2-48
:SOURce:BURSt ............................................................................................................... 2-55
:SOURce:FREQuency........................................................................................................ 2-63
:SOURce:FUNCtion........................................................................................................... 2-70
:SOURce:HARMonic.......................................................................................................... 2-86
:SOURce:MARKer............................................................................................................. 2-90
:SOURce[:MOD]:AM......................................................................................................... 2-91
:SOURce[:MOD]:ASKey .................................................................................................... 2-96
:SOURce[:MOD]:FM ......................................................................................................... 2-99
:SOURce[:MOD]:FSKey................................................................................................... 2-103
:SOURce[:MOD]:PM ....................................................................................................... 2-106
:SOURce[:MOD]:PSKey................................................................................................... 2-109
:SOURce[:MOD]:PWM .................................................................................................... 2-113
:SOURce:MOD ............................................................................................................... 2-117
:SOURce:PERiod ............................................................................................................ 2-119
:SOURce:PHASe............................................................................................................. 2-120
:SOURce:PULSe............................................................................................................. 2-121
:SOURce:SUM................................................................................................................ 2-123
:SOURce:SWEep............................................................................................................ 2-126
:SOURce:TRACe............................................................................................................. 2-133
:SOURce:TRACK ............................................................................................................ 2-134
:SOURce:VOLTage.......................................................................................................... 2-134
:SYSTem Commands............................................................................................................. 2-139
:TRIGger Commands ............................................................................................................ 2-153
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
To Output Sweep Waveform......................................................................................................3-4

RIGOL Contents
IV DG900 Programming Guide
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
DG900 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 DG900 Programming Guide
Build Remote Communication
You can build the remote communication between DG900 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
DG900 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 DG900 Communication Interface
1) Use the USB interface: connect the USB DEVICE interface on the rear panel of DG900 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
DG900 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 DG900 by
using the USB-LAN interface converter.
Use the network cable to have DG900 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 DG900
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

Chapter 1 Programming Overview RIGOL
DG900 Programming Guide 1-3
3. Check whether the connection is successful
Run Ultra Sigma, and then search for the resources and right-click the resource name. Select "SCPI
Panel Control" to open the SCPI command control panel. Input a correct command in the pop-up SCPI
control panel and click and in sequence or directly click
to check whether the connection is successful, as shown in the figure below (the
USB interface is taken as an example).

RIGOL Chapter 1 Programming Overview
1-4 DG900 Programming Guide
Remote Control Method
1. User-defined programming
You can use the SCPI (Standard Commands for Programmable Instruments) commands listed in
Chapter 2 "Command System"of this manual to program and control the instrument in various
development environments (e.g. Visual C++, Visual Basic, and LabVIEW). For details, refer to
descriptions in Chapter 4 "Programming Examples".
2. Send SCPI commands via the PC software
You can use the PC software to send commands to control the signal generator remotely. RIGOL Ultra
Sigma is recommended. You can download the software from RIGOL official website
(www.rigol.com).
SCPI Command Overview
SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming
language that is built upon the existing standard IEEE 488.1 and IEEE 488.2 and conforms to various
standards, such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character set
for information interchange (equivalent to ASCII programming). This chapter introduces the syntax,
symbols, parameters, and abbreviation rules of the SCPI commands.
Syntax
The SCPI commands provide a hierarchical tree structure, and consist of multiple subsystems. Each
command subsystem consists of one root keyword and one or more sub-keywords. The command line
usually starts with a colon; the keywords are separated by colons, and following the keywords are the
parameter settings available. The command ending with a question mark indicates querying a certain
function. The keywords of the command and the first parameter is separated by a space.
For example,
:SYSTem:COMMunicate:LAN:IPADdress <ip_address>
:SYSTem:COMMunicate:LAN:IPADdress?
SYSTem is the root keyword of the command. COMMunicate, LAN, and IPADdress are the second-level,
third-level, and forth-level keywords respectively. The command string starts with ":" which is also used to
separate the multiple-level keywords. <ip_address> represents the parameters available for setting. "?"
represents query; the instrument returns the corresponding information (the input value or internal setting
value of the instrument) when receiving the query command. The
command :SYSTem:COMMunicate:LAN:IPADdress and the parameter <ip_address> are separated by a
space.
In some commands with parameters, "," is often used to separate multiple parameters. For example,
:DISPlay:TEXT[:SET] <string>[,x[,y]]

Chapter 1 Programming Overview RIGOL
DG900 Programming Guide 1-5
Symbol Description
The following four symbols are not part of the SCPI command, and they are not sent with the commands,
but taken as delimiters to better describe the parameters in the command.
1. Braces { }
The contents enclosed in the braces can contain multiple parameter options; and the vertical bar is
used to separate multiple parameter options. When sending the command, you must select one of the
parameters. For example, :COUPling[<n>]:PHASe:MODE {OFFSet|RATio}.
2. Vertical Bar |
The vertical bar is used to separate multiple parameters. When using the command, you must select
one of the parameters. For example, :COUPling[<n>]:PHASe:MODE {OFFSet|RATio}.
3. Square Brackets []
The contents (command keywords or parameters) in the square brackets can be omitted. If the
parameter is omitted, the instrument will set the parameter to its default. For example, for
the :COUNter:STATIstics[:STATe]? command, send any of the following two commands can achieve
the same effect.
:COUNter:STATIstics?
:COUNter:STATIstics:STATe?
4. Triangle Brackets <>
The parameter enclosed in the angle brackets must be replaced by an effective value. For example,
sending the :COUNter:LEVEl <value> command in :COUNter:LEVEl 1.5 form.
Parameter Type
The command parameters introduced in this manual include 5 types: Bool, Integer, Real, Discrete, and
ASCII String.
1. Bool
The parameter can be set to "ON (1)" or "OFF (0)". For example, :COUNter:HF {ON|1|OFF|0}.
2. Integer
Unless otherwise specified, the parameter can be any integer within the effective value range. Note:
Do not set the parameter to a decimal, otherwise, errors will occur. For example, in
the :DISPlay:BRIGhtness <brightness> command, <brightness> can be any integer from 0 to 100.
3. Real
Unless otherwise noted, the parameter can be any number within the effective value range.
For example, the range of <value> in the :COUNter:LEVEl <value> command is from -2.5 V to 2.5 V.
4. Discrete
The parameters can only be the specified numerical values or characters. For example, in
the :COUPling[<n>]:PHASe:MODE {OFFSet|RATio} command, the parameter can only be OFFSet or
RATio.
5. ASCII String
The parameter can be the combinations of ASCII characters. For example, in
the :MMEMory:LOAD:STATe <filename> command,
<filename> is the filename of the state file to be loaded under the current directory of the external
memory and it can include English characters and numbers.
Besides, you can replace the parameters in many commands with MINimum or MAXimum to set the
parameters to their minimum or maximum value.

RIGOL Chapter 1 Programming Overview
1-6 DG900 Programming Guide
For example, MINimum and MAXimum in the :DISPlay:BRIGhtness {<brightness>|MINimum|MAXimum}
command are used to set the brightness to the minimum or maximum.
Command Abbreviation
The letters in the commands are case-insensitive. The commands can be input all in uppercase letters or in
lowercase letters. For abbreviations, you must enter all the uppercase letters that exist in the command
syntax. For example, the :COUNter:COUPling? command can be abbreviated as :COUN:COUP?.

Chapter 2 Command System RIGOL
DG900 Programming Guide 2-1
Chapter 2 Command System
This chapter introduces the syntax, function, parameters, and usages of each DG900 command in A-Z
order.
Contents in this chapter:
:COUNter Commands
:COUPling Commands
:DISPlay Commands
:HCOPy Commands
IEEE488.2 Common Commands
:MEMory Commands
:MMEMory Commands
:OUTPut Commands
:ROSCillator Commands
:SOURce Commands
:SYSTem Commands
:TRIGger Commands
Remarks: In this command system, setting commands relating to the frequency and amplitude
parameters can be sent with units. The units available and the default unit of each parameter are as shown
in the table below.
Parameter Type Units Available Default Unit
Frequency MHz/kHz/Hz/uHz Hz
Sample Rate MSa/s, kSa/s, Sa/s, uSa/s Sa/s
Amplitude Vpp/mVpp/Vrms/mVrms/dBm
Vpp/Vrms/dBm (Relates to the current
amplitude unit to be set.)
Offset Vdc/mVdc Vdc
High Level/Low Level V/mV V
Time Ms/ks/s/ms/us/ns s
Phase °°
Duty Cycle/Modulation
Depth/Brightness/
%%
Impedance ΩΩ
Note:
In this manual, the range of the parameter in the command takes DG992 as an example.
As all the commands are case-insensitive, for DG900, MHZ (mhz) and MSA/S (msa/s) are interpreted
as megahertz and mega points per second respectively; whereas MVPP (mvpp), MVRMS (mvrms),
MVDC (mvdc), MV (mv), and MS (ms) are interpreted as millivolt (peak-peak value), millivolt (effective
value), millivolt (DC), millivolt, and millisecond respectively.
When the output impedance is HighZ, the amplitude unit dBm is invalid.

RIGOL Chapter 2 Command System
2-2 DG900 Programming Guide
:COUNter Commands
The :COUNter commands are used to enable or disable the frequency counter; set the related information
of the frequency counter.
Command List[1]:
:COUNter:AUTO
:COUNter:COUPling
:COUNter:GATEtime
:COUNter:HF
:COUNter:LEVEl
:COUNter:MEASure?
:COUNter:SENSitive
:COUNter[:STATe]
:COUNter:STATIstics:CLEAr
:COUNter:STATIstics[:STATe]
Note[1]:In the "Command List" in this manual, the parameters in the setting commands and the query
commands are not included and you can refer to the complete introductions of the commands in the text
according to the keywords.

Chapter 2 Command System RIGOL
DG900 Programming Guide 2-3
:COUNter:AUTO
Syntax
:COUNter:AUTO
Description
The instrument will select a proper gate time automatically according to the characteristics of the signal
under test after sending this command.
Remarks
You can also send the :COUNter:GATEtime command to set the desired gate time.
:COUNter:COUPling
Syntax
:COUNter:COUPling {AC|DC}
:COUNter:COUPling?
Description
Sets the coupling mode of the input signal to AC or DC.
Queries the coupling mode of the input signal.
Parameter
Name
Type
Range
Default
{AC|DC}
Discrete
AC|DC
AC
Return Format
The query returns AC or DC.
Example
:COUN:COUP DC /*Sets the coupling mode of the input signal to DC.*/
:COUN:COUP? /*Queries the coupling mode of the input signal and the query returns DC.*/
:COUNter:GATEtime
Syntax
:COUNter:GATEtime {USER1|USER2|USER3|USER4|USER5|USER6}
:COUNter:GATEtime?
Description
Selects the gate time of the measurement system.
Queries the gate time of the measurement system.
Parameter
Name
Type
Range
Default
{USER1|USER2|USER3|
USER4|USER5|USER6}
Discrete
{USER1|USER2|USER3|USER4|
USER5|USER6}
USER1
Remarks
The gate time represented by USER1 through USER6 are as shown in the table below.
USER1
USER2
USER3
USER4
USER5
USER6
1.048ms
8.389 ms
134.218 ms
1.074 s
8.590 s
>8.590 s
For low-frequency signals (for example, the frequency is lower than 5 Hz), you are recommended to
set the gate time to USER6.
Send the :COUNter:AUTO command and the instrument will select a proper gate time automatically

RIGOL Chapter 2 Command System
2-4 DG900 Programming Guide
according to the characteristics of the signal under test. During this process, "AUTO" is displayed in the gate
time area in the frequency counter interface. The gate time currently selected by the instrument will be
displayed in the gate time area in the frequency counter interface after the instrument selects a proper gate
time.
Return Format
If you have currently selected a gate time, the query returns USER1, USER2, USER3, USER4, USER5, or
USER6 that corresponds to the specified gate time. If you send the :COUNter:AUTO command to enable
the instrument to select a proper gate time automatically, then during this process, the query returns
"AUTO"; and returns USER1, USER2, USER3, USER4, USER5, or USER6 after a proper gate time is selected
by the instrument.
Example
:COUN:GATE USER2 /*Sets the gate time of the measurement system to USER2 (10.48 ms).*/
:COUN:GATE? /*Queries the gate time of the measurement system and the query returns USER2.*/
:COUNter:HF
Syntax
:COUNter:HF {ON|1|OFF|0}
:COUNter:HF?
Description
Enables or disables the high frequency rejection function of the frequency counter.
Queries the on/off status of the high frequency rejection function of the frequency counter.
Parameter
Name
Type
Range
Default
{ON|1|OFF|0}
Bool
ON|1|OFF|0
OFF
Remarks
Enable the high frequency rejection when low-frequency signal with less than 150 kHz frequency is
measured to filter out the high-frequency noise interference and improve the measurement accuracy.
Disable the high frequency rejection when high-frequency signal with greater than 150 kHz frequency is
measured. At this time, the maximum input frequency can be 240 MHz.
Return Format
The query returns ON or OFF.
Example
:COUN:HF ON /*Enables the high frequency rejection function of the frequency counter.*/
:COUN:HF? /*Queries the on/off status of the high frequency rejection function of the frequency
counter and the query returns ON.*/
:COUNter:LEVEl
Syntax
:COUNter:LEVEl {<value>|MINimum|MAXimum}
:COUNter:LEVEl? [MINimum|MAXimum]
Description
Sets the trigger level of the frequency counter.
Queries the trigger level of the frequency counter.

Chapter 2 Command System RIGOL
DG900 Programming Guide 2-5
Parameter
Name
Type
Range
Default
<value>
Real
-2.5 V to 2.5 V
0V
Remarks
The frequency counter starts measuring when the input signal reaches the specified trigger level.
The minimum resolution is 6 mV.
Return Format
The query returns the trigger level in scientific notation. The returned value contains 7 effective digits, for
example, 1.500000E+00 (the trigger level is 1.5 V).
Example
:COUN:LEVE 1.5 /*Sets the trigger level of the frequency counter to 1.5 V.*/
:COUN:LEVE? /*Queries the trigger level of the frequency counter and the query returns
1.500000E+00.*/
:COUNter:MEASure?
Syntax
:COUNter:MEASure?
Description
Queries the measurement results of the frequency counter.
Remarks
When the frequency counter is in the "RUN" or "SINGLE" state, send this command to query the
measurement values. When the frequency counter is in the "STOP" state, send this command to query the
measurement values of the last measurement.
Return Format
The query returns a string consisting of 5 parts (representing the frequency, period, duty cycle, positive
pulse width, and negative pulse width respectively), separated by commas. Each part is expressed in
scientific notation and contains 10 effective digits, for example,
2.000000000E+03,5.000000000E-04,4.760800000E+01,2.380415000E-04,
2.619585000E-04 (representing the measurement result: 2 kHz frequency, 500 us period, 47.608% duty
cycle, 238.0415 us positive pulse width, and 261.9585 us negative pulse width).
When the frequency counter function is disabled, the query returns 0.000000000E+00,0.000000000E+00,
0.000000000E+00,0.000000000E+00,0.000000000E+00.
Example
:COUN:MEAS? /*Queries the measurement results of the frequency counter and the query returns
2.000000000E+03,5.000000000E-04,
4.760800000E+01,2.380415000E-04,2.619585000E-04.*/
:COUNter:SENSitive
Syntax
:COUNter:SENSitive {LOW|HIGh}
:COUNter:SENSitive? [LOW|HIGh]
Description
Sets the trigger sensitivity of the frequency counter.
Queries the trigger sensitivity of the frequency counter.

RIGOL Chapter 2 Command System
2-6 DG900 Programming Guide
Parameter
Name
Type
Range
Default
{LOW|HIGh}
Real
LOW|HIGh
LOW
Remarks
A higher sensitivity is recommended for the signal with a small amplitude; a low sensitivity is recommended
for a low-frequency signal with a large amplitude or a signal with a slow rising edge to ensure the accuracy
of the measurement result.
Return Format
The query returns LOW or HIG.
Example
:COUN:SENS LOW /*Sets the trigger sensitivity of the frequency counter to LOW.*/
:COUN:SENS? /*Queries the trigger sensitivity of the frequency counter and the query returns LOW.*/
:COUNter[:STATe]
Syntax
:COUNter[:STATe] {ON|1|OFF|0|RUN|STOP|SINGLE}
:COUNter[:STATe]?
Description
Sets the status of the frequency counter.
Queries the status of the frequency counter.
Parameter
Name
Type
Range
Default
{ON|1|OFF|0|RUN|STOP|SINGLE}
Discrete
ON|1|OFF|0|RUN|STOP|SINGLE
OFF
Remarks
"ON" and "1" denote enabling the frequency counter function; "OFF" and "0" denote disabling the
frequency counter function; "RUN", "STOP", and "SINGLE" denote setting the running status of the
frequency counter to "run", "stop", and "single" respectively.
The command for setting the operating status (the parameter is RUN, STOP, or SINGLE) is only valid
when the frequency counter function is enabled.
When the frequency counter function is enabled, the sync output of CH2 will be disabled.
In the "RUN" status, the frequency counter measures the input signal continuously according to the
current configuration. In the "SINGLE" status, the frequency counter executes a measurement, then
enters the "STOP" status, and then stops measurement. In the "STOP" status, the frequency counter
stops measuring.
When the frequency counter is enabled, the default operating status is "RUN", and the instrument
measures the input signal continuously according to the current configuration. At this point, if you
send the :COUNter:STATe SINGLE command, the frequency counter enters the "Single" status,
finishes the current measurement, and then stops; if you send the :COUNter:STATe STOP command,
the frequency counter enters the "STOP" state immediately.
When the frequency counter is in the "STOP" status, the frequency counter performs a measurement
and then enters the "STOP" status to stop the measurement each time you send the :COUNter:STATe
SINGLE command.
Return Format
When the frequency counter function is enabled, the query returns the current operating status (RUN, STOP,
or SINGLE); when the frequency counter function is disabled, the query returns OFF.
Example
:COUN OFF /*Disables the frequency counter function.*/

Chapter 2 Command System RIGOL
DG900 Programming Guide 2-7
:COUN? /*Queries the status of the frequency counter and the query returns OFF.*/
:COUN 1 /*Enables the frequency counter function.*/
:COUN? /*Queries the status of the frequency counter and the query returns RUN (the default
operating status).*/
:COUN STOP /*Sets the operating status of the frequency counter to "STOP".*/
:COUN? /*Queries the status of the frequency counter and the query returns STOP.*/
:COUNter:STATIstics:CLEAr
Syntax
:COUNter:STATIstics:CLEAr
Description
Clears the statistics results.
Remarks
This command is only valid when the statistical function of the frequency counter is enabled
(:COUNter:STATIstics[:STATe]).
The statistics results are cleared automatically when the statistical function of the frequency counter is
disabled.
:COUNter:STATIstics[:STATe]
Syntax
:COUNter:STATIstics[:STATe] {ON|1|OFF|0}
:COUNter:STATIstics[:STATe]?
Description
Enables or disables the statistical function of the measurement results of the frequency counter.
Queries the on/off status of the statistical function of the measurement results of the frequency counter.
Parameter
Name
Type
Range
Default
{ON|1|OFF|0}
Bool
ON|1|OFF|0
OFF
Return Format
The query returns ON or OFF.
Example
:COUN:STATI ON /*Enables the statistical function of the measurement results of the frequency
counter.*/
:COUN:STATI? /*Queries the on/off status of the statistical function of the measurement results of the
frequency counter and the query returns ON.*/

RIGOL Chapter 2 Command System
2-8 DG900 Programming Guide
:COUPling Commands
The :COUPling commands are used to set the related information of the channel frequency coupling,
amplitude coupling, and phase coupling; enable and disable the three coupling functions.
Command List:
:COUPling[<n>]:AMPL:DEViation
:COUPling[<n>]:AMPL:MODE
:COUPling[<n>]:AMPL:RATio
:COUPling[<n>]:AMPL[:STATe]
:COUPling[<n>]:FREQuency:DEViation
:COUPling[<n>]:FREQuency:MODE
:COUPling[<n>]:FREQuency:RATio
:COUPling[<n>]:FREQuency[:STATe]
:COUPling[<n>]:PHASe:DEViation
:COUPling[<n>]:PHASe:MODE
:COUPling[<n>]:PHASe:RATio
:COUPling[<n>]:PHASe[:STATe]
:COUPling[<n>][:STATe]
:COUPling[<n>]:TRIgger[:STATe]
Note: The coupling function is only available when both the waveforms of the two channels are basic
waveforms (Sine, Square, Ramp, or Arbitrary waveform).