Rigol DG2072, DG2102, DG2052 Programming Guide
Programming Guide
DG2000 Series
Function/Arbitrary 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 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: service@rigol.com
Website: www.rigol.com
DG2000 Programming Guide |
I |
RIGOL
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 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 realize the basic functions of the signal generator.
Chapter 4 Programming Examples
This chapter illustrates how to control DG2000 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, 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.
Model |
No. of Channels |
Max. Output Frequency |
DG2052 |
2 |
50 MHz |
DG2072 |
2 |
70 MHz |
DG2102 |
2 |
100 MHz |
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 |
Build Remote Communication
You can build the remote communication between DG2000 and the PC via the USB (USB DEVICE), LAN, 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
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.
USB DEVICE LAN
Figure 1-1 DG2000 Communication 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 Test and Measurement Device (IVI)" according to the instructions (refer to "Remote Control via USB" in Chapter 3 "Remote Control" in DG2000 User 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 control panel and click 
and 
in sequence or directly click
1-2 |
DG2000 Programming Guide |
Chapter 1 Programming Overview |
RIGOL |
to check whether the connection is successful, as shown in the figure below (the 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, 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]]
1-4 |
DG2000 Programming 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 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.
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 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?.
1-6 |
DG2000 Programming Guide |
Chapter 2 Command System |
RIGOL |
Chapter 2 Command System
This chapter introduces the syntax, function, parameters, and 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 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 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 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.
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.
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.
2-2 |
DG2000 Programming Guide |
Chapter 2 Command System |
RIGOL |
: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| |
Discrete |
{USER1|USER2|USER3|USER4| |
USER1 |
|
USER4|USER5|USER6} |
USER5|USER6} |
|||
|
|
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
DG2000 Programming Guide |
2-3 |
RIGOL |
Chapter 2 Command System |
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.
2-4 |
DG2000 Programming Guide |
|
Chapter 2 Command System |
|
|
|
RIGOL |
|
|
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.
DG2000 Programming Guide |
2-5 |
|
RIGOL |
|
|
Chapter 2 Command System |
||
|
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.*/ |
2-6 |
DG2000 Programming Guide |
Chapter 2 Command System |
RIGOL |
|
: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.*/ |
|
|
|||
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 |
: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
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
<deviation> |
Real |
-19.998 Vpp to 19.998 Vpp |
0 Vpp |
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired amplitude coupling mode (:COUPling[<n>]:AMPL:MODE) and set the corresponding amplitude deviation or amplitude ratio (:COUPling[<n>]:AMPL:RATio) before enabling the amplitude coupling function (:COUPling[<n>]:AMPL[:STATe]). You cannot set the amplitude coupling 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 deviation, sending this command can set the amplitude deviation; 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 amplitude coupling of CH1 to 1 Vpp.*/ :COUP1:AMPL:DEV? /*Queries the amplitude deviation in the amplitude 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
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
{OFFSet|RATio} |
Discrete |
OFFSet|RATio |
RATio |
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 ACH2=ACH1+ADev (the reference source is CH1); ACH1=ACH2-ADev (the reference source is CH2). Wherein, ACH1 is the amplitude of CH1, ACH2 is the amplitude of CH2 and ADev is the set
DG2000 Programming Guide |
2-9 |
RIGOL |
Chapter 2 Command System |
amplitude deviation.
Amplitude ratio mode: the amplitudes of CH1 and CH2 have a certain ratio relation. The parameter
relations are ACH2=ACH1*ARatio (the reference source is CH1); ACH1=ACH2/ARatio (the reference source is CH2). Wherein, ACH1 is the amplitude of CH1, ACH2 is the amplitude of CH2, and ARatio is the set amplitude ratio.
If the amplitude of CH1 or CH2 exceeds the amplitude upper limit or lower limit of the channel after 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 coupling 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:MODE 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
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
<value> |
Real |
0.001 to 1000 |
1 |
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired amplitude coupling mode (:COUPling[<n>]:AMPL:MODE) and set the corresponding amplitude deviation (:COUPling[<n>]:AMPL:DEViation) or amplitude ratio before enabling the amplitude coupling function (:COUPling[<n>]:AMPL[:STATe]). You cannot set the amplitude coupling 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 amplitude ratio and set the amplitude ratio.
Return Format
The query returns the amplitude ratio in scientific notation. The returned value contains 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 |
: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
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
{ON|1|OFF|0} |
Bool |
ON|1|OFF|0 |
OFF |
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
After the amplitude coupling function is enabled, CH1 and CH2 take each other as the reference source. When the amplitude of one channel (this 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 amplitude coupling mode (:COUPling[<n>]:AMPL:MODE) and set the corresponding amplitude deviation (:COUPling[<n>]:AMPL:DEViation) or amplitude ratio(:COUPling[<n>]:AMPL:RATio) before enabling the amplitude coupling function. You cannot set the amplitude coupling mode and amplitude deviation/ratio after the amplitude coupling function is enabled.
You can also send the [:SOURce[<n>]]:VOLTage:COUPle[:STATe] command to set and query 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>]:FREQuency:DEViation
Syntax
:COUPling[<n>]:FREQuency:DEViation <deviation> :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
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 |
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired frequency coupling mode (:COUPling[<n>]:FREQuency:MODE) and set the corresponding frequency deviation or frequency ratio (:COUPling[<n>]:FREQuency:RATio) before enabling the frequency coupling function (:COUPling[<n>]:FREQuency[:STATe]). You cannot set the
DG2000 Programming Guide |
2-11 |
RIGOL |
Chapter 2 Command System |
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 set the frequency deviation; if the current frequency coupling mode is frequency ratio, sending this command can set the frequency 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 deviation 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
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
{OFFSet|RATio} |
Discrete |
OFFSet|RATio |
RATio |
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 FCH2=FCH1+FDev (the reference source is CH1); FCH1=FCH2-FDev (the reference source is CH2). Wherein, FCH1 is the frequency of CH1, FCH2 is the frequency of CH2, and FDev is the frequency deviation.
Frequency ratio mode: the frequencies of CH1 and CH2 have a certain ratio relation. The parameter
relations are FCH2=FCH1*FRatio (the reference source is CH1); FCH1=FCH2/FRatio (the reference source is CH2). Wherein, FCH1 is the frequency of CH1, FCH2 is the frequency of CH2, and FRatio is the set frequency ratio.
If the frequency of CH1 or CH2 exceeds the frequency 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 frequency 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 |
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 OFFS.*/
: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
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
<value> |
Real |
0.000 001 to 1 000 000 |
1 |
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired frequency coupling mode (:COUPling[<n>]:FREQuency:MODE) and set the corresponding frequency deviation (:COUPling[<n>]:FREQuency:DEViation) or frequency ratio before enabling the frequency coupling function (:COUPling[<n>]:FREQuency[:STATe]). You cannot set the 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 mode to frequency ratio and set the frequency ratio.
You can also send the [:SOURce[<n>]]:FREQuency:COUPle:RATio command to set and query 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 /*Sets 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.*/
: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 of the specified channel.
DG2000 Programming Guide |
2-13 |
|
RIGOL |
|
|
Chapter 2 Command System |
|
|
Parameter |
|
|
|
|
|
Name |
Type |
Range |
Default |
|
|
[<n>] |
Discrete |
1|2 |
1 |
|
|
{ON|1|OFF|0} |
Bool |
ON|1|OFF|0 |
OFF |
|
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 reference 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 (:COUPling[<n>]:FREQuency:MODE) and set the corresponding frequency deviation (:COUPling[<n>]:FREQuency:DEViation) or frequency ratio (:COUPling[<n>]:FREQuency:RATio) before enabling the frequency coupling function. 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[: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? |
/*Queries the on/off status of the frequency coupling 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
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
<deviation> |
Real |
-360° to 360° |
0 |
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired phase coupling mode (:COUPling[<n>]:PHASe:MODE) and set the corresponding phase deviation or phase ratio (:COUPling[<n>]:PHASe: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 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 mode to phase deviation and set the phase deviation.
2-14 |
DG2000 Programming Guide |
Chapter 2 Command System |
RIGOL |
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
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
{OFFSet|RATio} |
Discrete |
OFFSet|RATio |
RATio |
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 PCH2=PCH1+PDev (the reference source is CH1); PCH1=PCH2-PDev (the reference source is CH2). Wherein, PCH1 is the phase of CH1, PCH2 is the phase of CH2, and PDev is the set phase deviation.
Phase ratio mode: the phases of CH1 and CH2 have a certain ratio relation. The parameter relations
are PCH2=PCH1*PRatio (the reference source is CH1); PCH1=PCH2/PRatio (the reference source is CH2). Wherein, PCH1 is the phase of CH1, PCH2 is the phase of CH2, and PRatio is the set phase 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 is enabled.
Return Format
The query returns OFFS or RAT.
Example |
|
:COUP1:PHAS:MODE OFFS |
/*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 |
: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
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
<value> |
Real |
0.01 to 100 |
1 |
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
Select the desired phase coupling mode (:COUPling[<n>]:PHASe:MODE) and set the corresponding phase deviation or phase ratio (:COUPling[<n>]:PHASe: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 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 mode to phase ratio and set the 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 the 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 returns
1.120000E+00.*/
: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
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
{ON|1|OFF|0} |
Bool |
ON|1|OFF|0 |
OFF |
Remarks
When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.
After the phase coupling 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 reference source) is modified, 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 (:COUPling[<n>]:PHASe:MODE) and set the corresponding
2-16 |
DG2000 Programming Guide |
Chapter 2 Command System |
RIGOL |
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 corresponding 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 channel.
Parameter
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
{ON|1|OFF|0} |
Bool |
ON|1|OFF|0 |
OFF |
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 (:COUPling[<n>]:FREQuency[:STATe]), phase coupling function (:COUPling[<n>]:PHASe[:STATe]), and amplitude 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 CH1 and the query returns FREQ:ON,PHASE:ON,AMPL:ON.*/ |
DG2000 Programming Guide |
2-17 |
RIGOL |
Chapter 2 Command System |
: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 function of the specified channel.
Parameter
Name |
Type |
Range |
Default |
[<n>] |
Discrete |
1|2 |
1 |
{ON|1|OFF|0} |
Bool |
ON|1|OFF|0 |
OFF |
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...