Rigol DG800 Series - Page 27

Chapter 2 Command System RIGOL
DG800 Programming Guide 2-13
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.