Rigol DG2072, DG2102, DG2052 Programming Guide
Programming Guide
DG2000 Series
Function/Arb itrary Waveform Generator
Aug. 2019
RIGOL (SUZHOU) TECHNOLOGIES INC.
RIGOL
Guaranty and Declaration
Copyright
© 2019 RIGOL (SUZHOU) TECHNOLOGIES INC. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC.
Publication Number
PGB12100-1110
Software Version
00.02.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 relea sed 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 a nd 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: service@rigol.com
Website: www.rigol.com
DG2000 Programming Guide I
RIGOL
Tip
For the latest version of this manual, download it from the official website of RIGOL (www.rigol.com).
Model
No. of Channels
Max. Output Frequency
DG2052
2
50 MHz
DG2072
2
70 MHz
DG2102
2
100 MHz
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, a nd usages of each DG2000 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 realiz e the basic functions of the signal generator.
Chapter 4 Programming Examples
This chapter illustrates how to control DG2000 by programming in the d evelopment environments such as
Visual C++, Visual Basic, and LabVIEW.
Chapter 5 Appendix
This chapter provides the command list and the factory settings.
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, Pulse/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, when the backlight of the Shift key is
illuminated, pressing Pulse/Utility System Setting denotes that first press Pulse/Utility on
the front panel, and then tap the System Setting menu label.
Content Conventions in this Manual:
DG2000 series function/arbitrary waveform generator includes the following models: Unless otherwise
specified, this manual takes DG2102 as an example to introduce each command of the DG2000 series.
II DG2000 Programming Guide
Contents RIGOL
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
:LXI Commands ......................................................................................................................... 2-28
:MEMory Commands .................................................................................................................. 2-29
:MMEMory Commands ................................................................................................................ 2-32
:OUTPut Commands ................................................................................................................... 2-41
:ROSCillator Commands.............................................................................................................. 2-46
:SOURce Commands .................................................................................................................. 2-48
:SOURce:APPLy ...................................................................................................................... 2-49
:SOURce:BURSt ...................................................................................................................... 2-56
:SOURce:FREQuency .............................................................................................................. 2-64
:SOURce:FUNCtion ................................................................................................................. 2-72
:SOURce:HARMonic ................................................................................................................ 2-87
:SOURce:MARKer .................................................................................................................... 2-92
:SOURce[:MOD]:AM ................................................................................................................ 2-94
:SOURce[:MOD]:ASKey ........................................................................................................... 2-98
:SOURce[:MOD]:FM .............................................................................................................. 2-101
:SOURce[:MOD]:FSKey ......................................................................................................... 2-104
:SOURce[:MOD]:PM .............................................................................................................. 2-108
:SOURce[:MOD]:PSKey ......................................................................................................... 2-111
:SOURce[:MOD]:PWM ........................................................................................................... 2-114
:SOURce:MOD ...................................................................................................................... 2-118
:SOURce:PERiod ................................................................................................................... 2-120
:SOURce:PHASe ................................................................................................................... 2-121
:SOURce:PULSe .................................................................................................................... 2-122
:SOURce:SUM ...................................................................................................................... 2-124
:SOURce:SWEep ................................................................................................................... 2-127
:SOURce:TRACe ................................................................................................................... 2-134
:SOURce:TRACK ................................................................................................................... 2-135
:SOURce:VOLTage ................................................................................................................ 2-135
:SYSTem Commands ................................................................................................................ 2-140
:TRIGger Commands ................................................................................................................ 2-155
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
To Output Burst Waveform ........................................................................................................... 3-5
To Use the Frequency Counter ...................................................................................................... 3-5
DG2000 Programming Guide III
RIGOL Contents
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
IV DG2000 Programming Guide
Chapter 1 Programming Overview RIGOL
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
DG2000 Programming Guide 1-1
RIGOL Chapter 1 Programming Overview
USB DEVICE
LAN
Build Remote Communication
Yo u c an build the remote co mmu nicati on between DG2000 and the PC via the USB (USB DEVICE), LAN, or
GPIB interface (extended from the USB HOST interface by using the US B-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
DG2000 supports the USB, LAN, 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 DG2000 C ommunication Interface
1) Use the USB interface: connect the USB DEVICE interface on the rear panel of DG2000 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 T est and Measurement Device (IVI)" according to
the instructions (refer to "Remote Control via U SB" in Chapter 3 "R emote Control" in
).
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.
Use the network cable to have DG2000 get access to the local area network.
When the Shift key is illuminated, press Pulse/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 front panel of DG2000
by using the USB-GPIB interface converter.
Use the GPIB cable to connect the instrument to your PC.
When the Shift key is illuminated, press Pulse/Utility Interface GPIB to set the
GPIB address of the instrument.
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
DG2000 User
1-2 DG2000 P rogra mming Guide
control panel and click
and in sequence or directly click
Chapter 1 Programming Overview RIGOL
to check whether the connection is successful, as shown in the figure below (t he
USB interface is taken as an example).
DG2000 Programming Guide 1-3
RIGOL Chapter 1 Programming Overview
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, a nd 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 t he 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]]
1-4 DG2000 P rogra mming Guide
Chapter 1 Programming Overview RIGOL
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 multipl e parameter option s. 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, <bri ghtness> 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.
DG2000 Programming Guide 1-5
RIGOL Chapter 1 Programming Overview
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 Abb r eviation
The letters in the commands are case-insensi tive. The commands can be inpu t all in uppercase let ters 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?.
1-6 DG2000 P rogra mming Guide
Chapter 2 Command System RIGOL
Vpp/Vrms/dBm (Relates to the current
amplitude unit to be set.)
Duty Cycle/Modulation
Depth/Brightness/
Chapter 2 Command System
This chapter introduces the syntax, function, parameters, a nd usages of each DG2000 command in A-Z
order.
Contents in this chapter:
:COUNter Commands
:COUPling Commands
:DISPlay Commands
:HCOPy Commands
IEEE488.2 Common Commands
:LXI 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 d efault u nit 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
Offset Vdc/mV
High Level /Low Level V/mV V
Time Ms/ks/s/ms/us/ns s
Phase ° °
Impedance Ω Ω
Note:
In this manual, the range of the parameter in the command takes DG2102 as an example.
As all the commands are case-insensitive, for DG2000, 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 in terpreted as millivo lt (peak -peak value), millivolt (effective
value), millivolt (DC), millivolt, and millisecond respectively.
When the output impedance is HighZ, the amplitude unit dBm is invalid.
Vdc
dc
% %
DG2000 Programming Guide 2-1
RIGOL Chapter 2 Command System
:COUNter Commands
The :COUNter commands are used to enable or disable the frequency counter; set the related information
of the frequency counter.
[1]
Command List
:COUNter:AUTO
:COUNter:COUPling
:COUNter:GATEtime
:COUNter:HF
:COUNter:LEVEl
:COUNter:MEASure?
:COUNter:SENSitive
:COUNter[:STATe]
:COUNter:STATIstics:CLEAr
:COUNter:STATIstics[:STATe]
[1]
Note
: In the "Command Lis t" 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.
:
2-2 DG2000 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
{AC|DC}
Discrete
AC|DC
AC
Name
Type
Range
Default
{USER1|USER2|USER3|
USER4|USER5|USER6}
{USER1|USER2|USER3|USER4|
USER5|USER6}
USER1
USER2
USER3
USER4
USER5
USER6
1.048ms
8.389 ms
134.218 ms
1.074 s
8.590 s
>8.590 s
: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
Return Format
The query returns AC or DC.
Example
:COUN:COUP DC /*Sets t he 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 {USE R1|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
Discrete
Remarks
The gate time represented by USER1 through USER6 are as shown in the table below.
USER1
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
DG2000 Programming Guide 2-3
:COUNter:AUTO command and the instrument will select a proper gate time automatically
RIGOL Chapter 2 Command System
Name
Type
Range
Default
{ON|1|OFF|0}
Bool
ON|1|OFF|0
OFF
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 t he gate time area in the frequen cy counter inter face after th e instrument select s 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
the instrument to select a proper gate time automatically, then during thi s process, the quer y returns
"AUTO"; and returns USER1, USER2 , USER3 , USER4 , USER5, o r USER6 af ter a proper g ate time i s selec ted
by the instrument.
Example
:COUN:GATE USER2 /*Sets the gate time of the measurement system to USER2 (10.48 ms).*/
:COUN:GA TE? /*Queries the gate time o f the measur ement system an d the query retu rns USER2.* /
:COUNter:AUTO command to enable
: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
Remarks
Enable the high frequency rejection when low-frequency signal with less than 150 kHz fre quency is
measured to filter out the high-frequency noise interference and improve the measurement accuracy.
Disable the high freq uency rejection when high-frequency signal with greater than 150 kHz freq uency 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 frequen cy 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.
2-4 DG2000 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
<value>
Real
-2.5 V to 2.5 V
0V
Parameter
Remarks
The frequency counte r starts measuri ng when the input s ignal reaches the specified trigger le vel.
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 / *S ets 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 "R UN" 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
scientif ic 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 se nsitivity of the frequency counter.
Queries the trigger sensitivity of the frequency counter.
DG2000 Programming Guide 2-5
RIGOL Chapter 2 Command System
Name
Type
Range
Default
{LOW|HIGh}
Real
LOW|HIGh
LOW
Name
Type
Range
Default
{ON|1|OFF|0|RUN|STOP|SINGLE}
Discrete
ON|1|OFF|0|RUN|STOP|SINGLE
OFF
Parameter
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 t he frequency counter.
Queries the status of the frequency counter.
Parameter
Remarks
"ON" and "1" denote enabling the freque ncy counter function; "OFF" and "0" denote disabling the
frequency counter funct io n; "RUN", "S TOP", and "SINGLE" denote setting the runn ing status of the
frequency counter to "run", "sto p", 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 enab led, 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 me asurement, 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" statu s to stop th e measuremen t each ti me y ou 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.*/
2-6 DG2000 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
{ON|1|OFF|0}
Bool
ON|1|OFF|0
OFF
: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 counte r 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 stati stical function of the measurement results of the frequency counter.
Parameter
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.*/
DG2000 Programming Guide 2-7
RIGOL Chapter 2 Command System
: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).
2-8 DG2000 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
<deviation>
Real
-19.998 Vpp to 19.998 Vpp
0 Vpp
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
{OFFSet|RATio}
Discrete
OFFSet|RATio
RATio
:COUPling[<n>]:AMPL:DEViation
Syntax
:COUPling[<n>]:AMPL:DEViation <deviation>
:COUPling[<n>]:AMPL:DEViation?
Description
Sets the amplitude deviation in the amplitude coupling of the specified channel.
Queries the amplitude deviation in the amplitude coupling of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired amplitu de coupling mode (
amplitude deviation or amplitude ratio (
coupling function (
:COUPling[<n>]:AMPL[:STATe]). You cannot set the amplitude coupling mode and
:COUPling[<n>]:AMPL:MODE) and set the corresponding
:COUPling[<n>]:AMPL:RATio) before enabling the amplitude
amplitude deviation/ratio after the amplitude coupling function is enabled.
When the amplitude coupling function is disabled, if the current amplitude coupling mode is amplitude
deviation, sending this command can set the amplitude devi ation; if the current amplitude coupling
mode is amplitude ratio, sending this command can set the amplitude coupling mode to amplitude
deviation and set the amplitude deviation.
Return Format
The query returns the amplitude deviation in scientific notation. The returned value contains 7 effective
digits, for example, 1.000000E+00 (the amplitude deviation is 1 Vpp).
Example
:COUP1:AMPL:DEV 1 /*Sets the amplitude deviation in the amp litude coupling of CH1 to 1 Vpp.*/
:COUP1:AMPL:DEV? /*Queries the amplitude deviation in the am plitude coupling of CH1 and the
query returns 1.000000E+00.*/
:COUPling[<n>]:AMPL:MODE
Syntax
:COUPling[<n>]:AMPL:MODE {OFFSet|RATio}
:COUPling[<n>]:AMPL:MODE?
Description
Sets the amplitude coupling mode of the specified channel to OFFSet (amplitude deviation) or RATio
(amplitude ratio).
Queries the selected amplitude coupling mode of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Amplitude deviation mode: the amplitudes of CH1 and CH2 have a certain deviation relation. The
parameter relations are A
source is CH2). Wherein, A
DG2000 Programming Guide 2-9
CH2=ACH1+ADev
is the amplitude of CH1, A
CH1
(the reference source is CH1); A
is the amplitude of CH2 and A
CH2
CH1=ACH2-ADev
(the reference
is the set
Dev
RIGOL Chapter 2 Command System
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
<value>
Real
0.001 to 1000
1
amplitude deviation.
Amplitude ratio mode: the amplitudes of CH1 and CH2 have a certain ratio relation. The parameter
relations are A
CH2=ACH1*ARatio
CH2). Wherein, A
(the reference source is CH1); A
is the amplitude of CH1, A
CH1
CH1=ACH2/ARatio
is the amplitude of CH2, and A
CH2
(the reference source is
is the set
Ratio
amplitude ratio.
If the amplitude of CH1 or CH2 exceeds the amplitu de upper limit or lower lim it of the channel af ter the
channel coupling, the instrument will automatically adjust the amplitude upper limit or lower limit of
the other channel to avoid parameter over-range.
Select the desired amplitude coupling mode and set the corresponding amplitude deviation
:COUPling[<n>]:AMPL:DEViation) or amplitude ratio (:COUPling[<n>]:AMPL:RATio) before enabling
(
the amplitude coup ling function (
:COUPling[<n>]:AMPL[:STATe]). You cannot set the amplitude
coupling mode and amplitude deviation/ratio after the amplitude coupling function is enabled.
Return Format
The query returns OFFS or RAT.
Example
:COUP1:AMPL:MO D E OFFS /*Sets the amplitude coupling mode of CH1 to amplitude deviation.*/
:COUP1:AMPL:MODE? /*Queries the selected amplitude coupling mode of CH1 and the query
returns OFFS.*/
:COUPling[<n>]:AMPL:RATio
Syntax
:COUPling[<n>]:AMPL:RATio {<value>|MINimum|MAXimum}
:COUPling[<n>]:AMPL:RATio?
Description
Sets the amplitude ratio in the amplitude coupling of the specified channel.
Queries the amplitude ratio in the amplitude coupling of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired amplitu de coupling mode (
amplitude deviation (
amplitude coupling function (
:COUPling[<n>]:AMPL:DEViation) or amplitude ratio before enabling the
:COUPling[<n>]:AMPL[:STATe]). You cannot set the amplitude coupling
:COUPling[<n>]:AMPL:MODE) and set the corresponding
mode and amplitude deviation/ratio after the amplitude coupling function is enabled.
When the amplitude coupling function is disabled, if the current amplitude coupling mode is amplitude
ratio, sending this command can set the amplitude ratio; if the current amplitude coupling mode is
amplitude deviation, sending this command can set the amplitude coupling mode to am plitude ratio
and set the amplitude ratio.
Return Format
The query returns the amplitude ratio in scientific notation. The returned value conta ins 7 effective digits,
for example, 1.123000E+00 (the amplitude ratio is 1.123).
Example
:COUP1:AMPL:RAT 1.123 /*Sets the amplitude ratio in the amplitude coupling of CH1 to 1.123.*/
:COUP1:AMPL:RAT? /*Queries the amplitude ratio in the amplitude coupling of CH1 and the query
returns 1.123000E+00.*/
2-10 DG2000 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
{ON|1|OFF|0}
Bool
ON|1|OFF|0
OFF
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
<deviation>
Real
-99.999 999 999 9 MHz to 99.999 999 999 9 MHz
0Hz
:COUPling[<n>]:AMPL[:STATe]
Syntax
:COUPling[<n>]:AMPL[:STATe] {ON|1|OFF|0}
:COUPling[<n>]:AMPL[:STATe]?
Description
Enables or disables the amplitude coupling function of the specified channel.
Queries the on/off status of the amplitude coupling function of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
After the amplitude coupling functi on is enabled, CH1 and CH2 take each other as the ref erence source.
When the amplitude of one channel (thi s channel is taken as the reference source) is modified, the
amplitude of the other channel is automatically modified accordingly and always keeps the specified
amplitude deviation or ratio with that of the reference channel.
Select the desired amplitu de coupling mode (
amplitude deviation (
:COUPling[<n>]:AMPL:RATio) before enabling the amplitude coupling function. You cannot set
ratio(
the amplitude coupling mode and amplitude deviat ion/ratio after the amplitude coupling function is
enabled.
You can also send the
on/off status of the amplitude coupling function.
Return Format
The query returns ON or OFF.
Example
:COUP1:AMPL ON /*Enables the amplitude coupling function of CH1.*/
:COUP1:AMPL? /*Queries the on/off status of the amplitude coupling function and the query returns ON.*/
:COUPling[<n>]:AMPL:DEViation) or amplitude
[:SOURce[<n>]]:VOLTage:COUPle[:STATe] command to set and query the
:COUPling[<n>]:AMPL:MODE) and set the corresponding
:COUPling[<n>]:FREQuency:DEViation
Syntax
:COUPling[<n>]:FREQ uen c y:DEV ia ti on <de via ti on >
:COUPling[<n>]:FREQuency:DEViation?
Description
Sets the frequency deviation in the frequency coupling of the specified channel .
Queries the frequency deviation in the frequency coupling of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired frequency coupling mode (
corresponding frequency deviation or frequency ratio (
enabling the frequency coupling function (
DG2000 Programming Guide 2-11
:COUPling[<n>]:FREQuency:MODE) and set the
:COUPling[<n>]:FREQuency:RATio) before
:COUPling[<n>]:FREQuency[:STATe]). You cannot set the
RIGOL Chapter 2 Command System
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
{OFFSet|RATio}
Discrete
OFFSet|RATio
RATio
frequency coupling mode and frequency deviation/ratio after the frequency coupling function is
enabled.
When the frequency coupling function is disabled, if the current frequency coupling mode is frequency
deviation, sending this command can s et the frequency de viation; if the current frequency coupling
mode is frequency ratio, sending this command can set the freque ncy coupling mode to frequency
deviation and set the frequency deviation.
You can also send the
[:SOURce[<n>]]:FREQuency:COUPle:OFFSet command to set and query the
frequency deviation in the frequency coupling.
Return Format
The query returns the frequency deviati on in scientific notation. The returned value contains 7 effective
digits, for example, 1.000000E +02 (the frequency deviation is 100 Hz).
Example
:COUP1:FREQ:DEV 100 /*Set the frequency deviation in the frequency coupling of CH1 to 100 Hz.*/
:COUP1:FREQ:DEV? /*Queries the frequency deviation in the frequency coupling of CH1 and the
query returns 1.000000E+02.*/
:COUPling[<n>]:FREQuency:MODE
Syntax
:COUPling[<n>]:FREQuency:MODE {OFFSet|RATio}
:COUPling[<n>]:FREQuency:MODE?
Description
Sets the frequency coupling mode to frequency deviation (OFFSet) or frequency ratio (RATio).
Queries the selected frequency coupling mode of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Frequency deviation mode: the frequencies of CH1 and CH2 have a certain deviation relation. The
parameter relations are F
source is CH2). Wherein, F
CH2=FCH1+FDev
is the frequency of CH1, F
CH1
(the reference source is CH1); F
CH1=FCH2-FDev
is the frequency of CH2, and F
CH2
(the reference
is the
Dev
frequency deviation .
Frequency ratio mode: the frequencies of CH1 and CH2 have a certain ratio relation. The parameter
relations are F
CH2=FCH1*FRatio
CH2). Wherein, F
(the reference source is CH1); F
is the frequency of CH1, F
CH1
CH1=FCH2/FRatio
is the frequency of CH2, and F
CH2
(the reference source is
is the set
Ratio
frequency ratio.
If the frequency of CH 1 or CH2 exceeds the f requency upper limit or lower limit of the channel after the
channel coupling, the instrument will automatically adjust the frequency upper limit or lower limit of
the other channel to avoid parameter over-range.
Select the desired frequency coupling mode and set the corresponding frequency deviation
:COUPling[<n>]:FREQuency:DEViation) or frequency ratio (:COUPling[<n>]:FREQuency:RATio)
(
before enabling the fre quency coupling function (
:COUPling[<n>]:FREQuency[:STATe]). You cannot
set the frequency coupling mode and frequency deviation/ratio after the frequency coupling function is
enabled.
You can also send the
[:SOURce[<n>]]:FREQuency:COUPle:MODE command to set and query the
frequency coupling mode of the specified channel.
Return Format
The query returns OFFS or RAT.
2-12 DG2000 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
<value>
Real
0.000 001 to 1 000 000
1
Example
:COUP1:FREQ:MODE OFFS /*Sets the frequency coupling mode of CH1 to frequency deviation.*/
:COUP1:FREQ:MODE? /*Queries the selected frequency coupling mode and the query returns OFF S. */
:COUPling[<n>]:FREQuency:RATio
Syntax
:COUPling[<n>]:FREQuency:RATio {<value>|MINimum|MAXimum}
:COUPling[<n>]:FREQuency:RATio?
Description
Sets the frequency ratio in the frequency coupling of the specified channel.
Queries the frequency ratio in the frequency coupling of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired frequency coupling mode (
corresponding frequency deviation (
enabling the frequency coupling function (
frequency coupling mode and frequency deviation/ratio after the frequency coupling function is
enabled.
When the frequency coupling function is disabled, if the current frequency coupling mode is frequency
ratio, sending this command can set the frequency ratio; if the current frequency coupling mode is
frequency deviation, sending this command can set the frequency coupling m ode to frequency ratio
and set the frequency ratio.
You can also send the
frequency ratio in the frequency coupling.
Return Format
The query returns the frequency ratio in scientific notation. The returned value contains 7 effective digits,
for example, 1.001230E+02 (the frequency ratio is 100.123).
Example
:COUP1:FREQ:RAT 100.123 / *S ets the frequency ratio in the frequency coupling of CH1 to 100.123.*/
:COUP1:FREQ:RAT? /*Queries the frequency ratio in the frequency coupling of CH1 and the query
returns 1.001230E+02.*/
[:SOURce[<n>]]:FREQuency:COUPle:RATio command to set and query the
:COUPling[<n>]:FREQuency:DEViation) or frequency ratio before
:COUPling[<n>]:FREQuency:MODE) and set the
:COUPling[<n>]:FREQuency[:STATe]). You cannot set the
:COUPling[<n>]:FREQuency[:STATe]
Syntax
:COUPling[<n>]:FREQuency[:STATe] {ON|1|OFF|0}
:COUPling[<n>]:FREQuency[:STATe]?
Description
Enables or disables the frequency coupling function of the specified channel.
Queries the on/off status of the frequency coupling function o f the specified channel.
DG2000 Programming Guide 2-13
RIGOL Chapter 2 Command System
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
{ON|1|OFF|0}
Bool
ON|1|OFF|0
OFF
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
<deviation>
Real
-360° to 360°
0
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired frequency coupling mode and set the corresponding frequency deviation or
frequency ratio when the frequency coupling function is disabled. After the frequency coupling
function is enabled, CH1 and CH2 take each other as the r eference source. When the frequency of one
channel (this channel is taken as the reference source) is modified, the frequency of the other channel
is automatically modified accordingly and always keeps the specified frequency deviation or ratio with
that of the reference channel.
Select the desired frequency coupling mode (
corresponding frequency deviation (
:COUPling[<n>]:FREQuency:RATio) before enabling the frequency coupling function. You cannot set
(
:COUPling[<n>]:FREQuency:DEViation) or frequency ratio
:COUPling[<n>]:FREQuency:MODE) and set the
the frequency coupling mode and frequency deviation/ratio after the frequency coupling function is
enabled.
You can also send the
[:SOURce[<n>]]:FREQuency:COUPle[:STATe] command to set and query the
on/off status of the frequency coupling function.
Return Format
The query returns ON or OFF.
Example
:COUP1:FREQ ON /*Enables the frequency coupling function of CH1.*/
:COUP1:FREQ? /*Quer ies the on/off status of the frequency coupl ing function of CH1 and the query
returns ON.*/
:COUPling[<n>]:PHASe:DEViation
Syntax
:COUPling[<n>]:PHASe:DEViation <deviation>
:COUPling[<n>]:PHASe:DEViation?
Description
Sets the phase deviation in the phase coupling of the specified channel.
Queries the phase deviation in the phase coupling of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired phase coupling mode (
phase deviation or phase ratio (
function (
:COUPling[<n>]:PHASe[:STATe]). You cannot set the phase coupling mode and phase
:COUPling[<n>]:PHASe:RATio) before enabling the phase coupling
:COUPling[<n>]:PHASe:MODE) and set the corre sponding
deviation/ratio after the phase coupling function is enabled.
When the phase coupling function is disabled, if the current phase coupling mode is phase deviation,
sending this command can set the phase deviation; if the current phase coupling mode is phase ratio,
sending this command can set the phase coupling mod e to phase deviation and set the phase
deviation.
2-14 DG2000 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
{OFFSet|RATio}
Discrete
OFFSet|RATio
RATio
Return Format
The query returns the phase deviation in scientific notation. The returned value contains 7 effective digits,
for example, 9.000000E+01 (the phase deviation is 90°).
Example
:COUP1:PHAS:DEV 90 /*Sets the phase deviation in the phase coupling of CH1 to 90°.*/
:COUP1:PHAS:DEV? /*Queries the phase deviation in the phase coupling of CH1 and the query returns
9.000000E+01.*/
:COUPling[<n>]:PHASe:MODE
Syntax
:COUPling[<n>]:PHASe:MODE {OFFSet|RATio}
:COUPling[<n>]:PHASe:MODE?
Description
Sets the phase coupling mode of the specified channel to phase deviation (OFFSet) or phase ratio (RATio).
Queries the selected phase coupling mode of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Phase deviation mode: the phases of CH1 and CH2 have a certain deviation relation. The parameter
relations are P
CH2=PCH1+PDev
CH2). Wherein, P
(the reference source is CH1); P
is the phase of CH1, P
CH1
CH1=PCH2-PDev
is the phase of CH2, and P
CH2
(the reference source is
is the set phase deviation.
Dev
Phase ratio mode: the phases of CH1 and CH2 have a certain ratio relation. The parameter relations
are P
CH2=PCH1*PRatio
Wherein, P
(the reference source is CH1); P
is the phase of CH1, P
CH1
CH1=PCH2/PRatio
is the phase of CH2, and P
CH2
(the reference source is CH2).
is the set phase ratio.
Ratio
If the phase of CH1 or CH2 exceeds the phase upper limit or lower limit of the channel after the
channel coupling, the instrument will automatically adjust the phase upper limit or lower limit of the
other channel to avoid parameter over-range.
Select the desired phase coupling mode and set the corresponding phase deviation
:COUPling[<n>]:PHASe:DEViation) or phase ratio (:COUPling[<n>]:AMPL:RATio) before enabling the
(
phase coupling function (
:COUPling[<n>]:PHASe[:STATe]). You cannot set the phase coupling mode
and phase deviation/ratio after the phase coupling function i s enabled.
Return Format
The query returns OFFS or RAT.
Example
:COUP1:PHAS:MODE O FFS /*Sets the phase coupling mode of CH1 to phase deviation.*/
:COUP1:PHAS:MODE? /*Queries the phase coupling mode of CH1 and the query returns
OFFS.*/
DG2000 Programming Guide 2-15
RIGOL Chapter 2 Command System
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
<value>
Real
0.01 to 100
1
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
{ON|1|OFF|0}
Bool
ON|1|OFF|0
OFF
:COUPling[<n>]:PHASe:RATio
Syntax
:COUPling[<n>]:PHASe:RATio {<value>|MINimum|MAXimum}
:COUPling[<n>]:PHASe:RATio?
Description
Sets the phase ratio in the phase coupling of the specified channel.
Queries the phase ratio in the phase coupling of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired phase coupling mode (
phase deviation or phase ratio (
function (
deviation/ratio after the phase coupling function is enabled.
When the phase coupling function is disabled, if the current phase coupling mode is phase ratio,
sending this command can set the phase ratio; if the current phase coupling mode is phase deviation,
sending this command can set the phase coupling mod e to phase ratio and set t he phase ratio.
Return Format
The query returns the phase ratio in scientific notation. The returned value contains 7 effective digits, for
example, 1.120000E+00 (the phase ratio is 1.12).
Example
:COUP1:PHAS:RAT 1.12 /*Sets t he phase ratio in the phase coupling of CH1 to 1.12.*/
:COUP1:PHAS:RAT? /*Queries the phase ratio in the phase coupling of CH1 and the query return s
1.120000E+00.*/
:COUPling[<n>]:PHASe[:STATe]). You cannot set the phase coupling mode and phase
:COUPling[<n>]:PHASe:RATio) before enabling the phase coupling
:COUPling[<n>]:PHASe:MODE) and set the corresponding
:COUPling[<n>]:PHASe[:STATe]
Syntax
:COUPling[<n>]:PHASe[:STATe] {ON|1|OFF|0}
:COUPling[<n>]:PHASe[:STATe]?
Description
Enables or disables the phase coupling function of the specified channel.
Queries the on/off status of the phase coupling function of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
After the phase coup ling function is enabled, CH1 and CH2 take each other as the reference source.
When the phase of one channel (this channel is taken as the ref er enc e so u rce) is modi fied, the phase
of the other channel is automatically modified accordingly and always keeps the specified phase
deviation or ratio with that of the reference channel.
Select the desired phase coupling mode (
2-16 DG2000 Programming Guide
:COUPling[<n>]:PHASe:MODE) and set the corresponding
Chapter 2 Command System RIGOL
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
{ON|1|OFF|0}
Bool
ON|1|OFF|0
OFF
phase deviation (:COUPling[<n>]:PHASe:DEViation) or phase ratio (:COUPling[<n>]:PHASe:RATio)
before enabling the phase coupling function. You cannot set the phase coupling mode and phase
deviation/ratio after the phase coupling function is enabled.
Select the desired phase coupling mode and set the co rresponding phase deviation or phase ratio
when the phase coupling function is disabled.
Return Format
The query returns ON or OFF.
Example
:COUP1:PHAS ON /*Enables the phase coupling function of CH1.*/
:COUP1:PHAS? /*Queries the on/off status of the phase coupling function of CH1 and the query
returns ON.*/
:COUPling[<n>][:STATe]
Syntax
:COUPling[<n>][:STATe] {ON|1|OFF|0}
:COUPling[<n>][:STATe]?
Description
Enables or disables the frequency coupling, phase coupling, and amplitude coupling of the specified
channel at the same time.
Queries the on/off status of the frequency coupling, phase coupling, and amplitude coupling of the
specified chan nel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
DG2000 supports frequency, amplitude, and phase coupling functions. When the corresponding
coupling functions are enabled, CH1 and CH2 are mutual base sources. When the frequency , amplitude,
or phase of one channel (as the base source) is changed, the corresponding parameter of the other
channel will be changed automatically and always keeps the specified frequency deviation (ratio),
amplitude deviation (ratio), or phase deviation (ratio) relative to the base channel.
You can also enable or disable the frequency coupling function (
phase coupling function (
:COUPling[<n>]:AMPL[:STATe]) respectively.
(
Return Format
The query returns a string consisting of 3 parts (representing the on/off status of the frequency coupling,
phase coupling, and amplitude coupling functions in sequence) separated by commas, for example,
FREQ:ON,PHASE:OFF,AMPL:OFF.
Example
:COUP1 ON /*Enables the frequency coupling, phase coupling, and amplitude coupling of CH1 at the
same time.*/
:COUP1? /*Queries the on/off status of the frequency coupling, phase coupling, and amplitude
coupling of CH 1 and the query returns FREQ:ON,PHASE:ON,AMPL:ON.*/
:COUPling[<n>]:PHASe[:STATe]), and amplitude coupling function
:COUPling[<n>]:FREQuency[:STATe]),
DG2000 Programming Guide 2-17
RIGOL Chapter 2 Command System
Name
Type
Range
Default
[<n>]
Discrete
1|2
1
{ON|1|OFF|0}
Bool
ON|1|OFF|0
OFF
:COUPling[<n>]:TRIgger[:STATe]
Syntax
:COUPling[<n>]:TRIgger [:STATe] {ON|1|OFF|0}
:COUPling[<n>]:TRIgger [:STATe]?
Description
Enables or disables the trigger coupling function of the specified channel.
Queries the on/off status of the trigger coupling functio n of the specified channel.
Parameter
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
After the trigger coupling function is enabled, CH1 and CH2 take each other as the reference source.
When one channel (this channel is taken as the reference source) initiates the trigger, the other
channel is automatically triggered.
Return Format
The query returns ON or OFF.
Example
:COUP1:TRI ON /*Enables the trigger coupling function of CH1.*/
:COUP1:TRI? /*Queries the on/off status of the trigger coupling function of CH1 and the query
returns ON.*/
2-18 DG2000 Programming Guide
Loading...