Rigol DSG5000 Series Operating instructions

Guaranty and Declaration
Copyright
© 2022 RIGOL TECHNOLOGIES CO., LTD. All Rights Reserved.
Trademark Information
RIGOL®is the trademark of RIGOL TECHNOLOGIES CO., LTD.
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: ser[email protected]
Website:
http://www.rigol.com

Section Description Page
1 Document Overview...................................................................................................................1
2 SCPI Command Overview.........................................................................................................3
3 Command System........................................................................................................................6
3.1 :SOURce Commands........................................................................................................... 6
3.1.1 [:SOURce][:RF]:FREQuency Commands................................................................ 6
3.1.1.1 [:SOURce][:RF]:FREQuency................................................................................6
3.1.1.2 [:SOURce][:RF]:FREQuency:OFFSet.................................................................7
3.1.2 [:SOURce][:RF]:LEVel Commands............................................................................ 8
3.1.2.1 [:SOURce][:RF]:LEVel............................................................................................8
3.1.2.2 [:SOURce][:RF]:LEVel:LIMit.................................................................................9
3.1.2.3 [:SOURce][:RF]:LEVel:OFFSet.......................................................................... 10
3.1.3 [:SOURce][:RF]:PHASe Commands.......................................................................11
3.1.3.1 [:SOURce][:RF]:PHASe...................................................................................... 11
3.1.3.2 [:SOURce][:RF]:PHASe:RESet..........................................................................12
3.1.4 [:SOURce][:RF]:CORRection Commands.............................................................13
3.1.4.1 [:SOURce][:RF]:CORRection:FLATness[:STATe].......................................... 13
3.1.4.2 [:SOURce][:RF]:CORRection:FLATness:COUNt..........................................13
3.1.4.3 [:SOURce][:RF]:CORRection:FLATness:LIST................................................14
3.1.4.4 [:SOURce][:RF]:CORRection:FLATness:DELete.......................................... 15
3.1.4.5 [:SOURce][:RF]:CORRection:FLATness:PAIR............................................... 16
3.1.4.6 [:SOURce][:RF]:CORRection:FLATness:LOAD.............................................16
3.1.4.7 [:SOURce][:RF]:CORRection:FLATness:SAVe.............................................. 17
3.1.5 [:SOURce][:RF]:Sweep Commands....................................................................... 18
3.1.5.1 [:SOURce][:RF]:SWEep:DIRection..................................................................18
3.1.5.2 [:SOURce][:RF]:SWEep:EXECute.................................................................... 18
3.1.5.3 [:SOURce][:RF]:SWEep:LIST:ADDList............................................................19
3.1.5.4 [:SOURce][:RF]:SWEep:LIST:CPOint..............................................................20
3.1.5.5 [:SOURce][:RF]:SWEep:LIST:DELete..............................................................21
3.1.5.6 [:SOURce][:RF]:SWEep:LIST:LIST....................................................................21
3.1.5.7 [:SOURce][:RF]:SWEep:LIST:INITialize:FSTep.............................................22
3.1.5.8 [:SOURce][:RF]:SWEep:LIST:INITialize:PRESet...........................................23
3.1.5.9 [:SOURce][:RF]:SWEep:LIST:LOAD................................................................ 24
3.1.5.10 [:SOURce][:RF]:SWEep:LIST:SAVe..................................................................24
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. I

3.1.5.11 [:SOURce][:RF]:SWEep:STATe..........................................................................25
3.1.5.12 [:SOURce][:RF]:SWEep:TYPE........................................................................... 26
3.1.5.13 [:SOURce][:RF]:SWEep:MODE........................................................................26
3.1.5.14 [:SOURce][:RF]:SWEep:RESet[:ALL]...............................................................27
3.1.5.15 [:SOURce][:RF]:SWEep:POINt:TRIGger:TYPE.............................................28
3.1.5.16 [:SOURce][:RF]:SWEep:SWEep:TRIGger:TYPE...........................................29
3.1.5.17 [:SOURce][:RF]:SWEep:STEP:DWELl............................................................. 31
3.1.5.18 [:SOURce][:RF]:SWEep:STEP:POINts............................................................ 31
3.1.5.19 [:SOURce][:RF]:SWEep:STEP:STARt:FREQuency....................................... 32
3.1.5.20 [:SOURce][:RF]:SWEep:STEP:STARt:LEVel................................................... 33
3.1.5.21 [:SOURce][:RF]:SWEep:STEP:STOP:FREQuency........................................ 34
3.1.5.22 [:SOURce][:RF]:SWEep:STEP:STOP:LEVel.................................................... 35
3.1.5.23 [:SOURce][:RF]:SWEep:STEP:SHAPe.............................................................36
3.1.5.24 [:SOURce][:RF]:SWEep:STEP:SPACing..........................................................37
3.1.6 [:SOURce][:RF]:AM Commands............................................................................. 38
3.1.6.1 [:SOURce][:RF]:AM:DEPTh...............................................................................38
3.1.6.2 [:SOURce][:RF]:AM:FREQuency..................................................................... 38
3.1.6.3 [:SOURce][:RF]:AM:WAVEform...................................................................... 39
3.1.6.4 [:SOURce][:RF]:AM:STATe................................................................................ 40
3.1.6.5 [:SOURce][:RF]:AM:SOURce............................................................................41
3.1.6.6 [:SOURce][:RF]:AM:EQUal:LEVel.................................................................... 42
3.1.6.7 [:SOURce]:AM:EXT:COUP................................................................................ 42
3.1.6.8 [:SOURce]:AM:EXT:IMP.................................................................................... 43
3.1.7 [:SOURce][:RF]:FM Commands..............................................................................44
3.1.7.1 [:SOURce][:RF]:FM:DEViation.........................................................................44
3.1.7.2 [:SOURce][:RF]:FM:FREQuency...................................................................... 45
3.1.7.3 [:SOURce][:RF]:FM:WAVEform.......................................................................46
3.1.7.4 [:SOURce][:RF]:FM:STATe................................................................................. 46
3.1.7.5 [:SOURce][:RF]:FM:SOURce.............................................................................47
3.1.7.6 [:SOURce]:FM:EXT:COUP.................................................................................48
3.1.7.7 [:SOURce]:FM:EXT:IMP.....................................................................................49
3.1.8 [:SOURce][:RF]:PM Commands..............................................................................50
3.1.8.1 [:SOURce][RF]:PM:DEViation..........................................................................50
3.1.8.2 [:SOURce][:RF]:PM:FREQuency......................................................................50
3.1.8.3 [:SOURce][:RF]:PM:WAVEform.......................................................................51
3.1.8.4 [:SOURce][:RF]:PM:STATe.................................................................................52
3.1.8.5 [:SOURce][:RF]:PM:SOURce............................................................................ 53
II Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

3.1.8.6 [:SOURce]:PM:EXT:COUP.................................................................................54
3.1.8.7 [:SOURce]:PM:EXT:IMP.....................................................................................54
3.1.9 [:SOURce][:RF]:PULM Commands........................................................................ 55
3.1.9.1 [:SOURce][:RF]:PULM:MODE..........................................................................55
3.1.9.2 [:SOURce][:RF]:PULM:OUT:STATe..................................................................56
3.1.9.3 [:SOURce][:RF]:PULM:PERiod.........................................................................57
3.1.9.4 [:SOURce][:RF]:PULM:POLarity...................................................................... 58
3.1.9.5 [:SOURce][:RF]:PULM:SOURce.......................................................................58
3.1.9.6 [:SOURce][:RF]:PULM:STATe............................................................................59
3.1.9.7 [:SOURce][:RF]:PULM:TRAin:LIST:COUNt...................................................60
3.1.9.8 [:SOURce][:RF]:PULM:TRAin:LIST:INSErt.....................................................61
3.1.9.9 [:SOURce][:RF]:PULM:TRAin:LIST:DELete................................................... 61
3.1.9.10 [:SOURce][:RF]:PULM:TRAin:LIST:GET......................................................... 62
3.1.9.11 [:SOURce][:RF]:PULM:TRAin:LIST:RUN........................................................63
3.1.9.12 [:SOURce][:RF]:PULM:TRAin:LIST:LOAD......................................................63
3.1.9.13 [:SOURce][:RF]:PULM:TRAin:LIST:SAVe....................................................... 64
3.1.9.14 [:SOURce][:RF]:PULM:TRIGger:DELay..........................................................65
3.1.9.15 [:SOURce][:RF]:PULM:TRIGger:EXTernal:GATE:POLarity........................65
3.1.9.16 [:SOURce][:RF]:PULM:TRIGger:EXTernal:SLOPe....................................... 66
3.1.9.17 [:SOURce][:RF]:PULM:TRIGger:MODE.........................................................67
3.1.9.18 [:SOURce][:RF]:PULM:WIDTh..........................................................................69
3.1.10 [:SOURce][:RF]:OUTPut Commands.....................................................................70
3.1.10.1 [:SOURce][:RF]:OUTPut[:STATe]..................................................................... 70
3.1.10.2 [:SOURce]:RFALl:OUTPut[:STATe]..................................................................70
3.1.11 [:SOURce][:RF]:MODulation Commands............................................................71
3.1.11.1 [:SOURce][:RF]:MODulation:STATe...............................................................71
3.1.11.2 [:SOURce]:RFALl:MODulation:STATe............................................................72
3.1.12 :SOURce:ROSCillator:HCLock Commands.........................................................72
3.1.12.1 :SOURce:ROSCillator:HCLock:OUTPut:STATe........................................... 72
3.1.12.2 :SOURce:ROSCillator:HCLock:TYPE............................................................. 73
3.1.13 [:SOURce][:RF]:INPut:TRIGger:SLOPe.................................................................. 74
3.2 :TRIGger Commands.........................................................................................................74
3.2.1 :TRIGger[:RF]:PULM[:IMMediate]..........................................................................75
3.2.2 :TRIGger:RFALl:PULM[:IMMediate]...................................................................... 75
3.2.3 :TRIGger[:RF][:SWEep][:IMMediate].....................................................................76
3.2.4 :TRIGger:RFALl[:SWEep][:IMMediate]................................................................. 76
3.2.5 :TRIGger[:RF]:PULM:KEY...........................................................................................77
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. III

3.2.6 :TRIGger:RFALl:PULM:KEY....................................................................................... 77
3.2.7 :TRIGger[:RF][:SWEep]:KEY......................................................................................78
3.2.8 :TRIGger:RFALl[:SWEep]:KEY.................................................................................. 78
3.3 :UNIT Command.................................................................................................................79
3.3.1 :UNIT[:RF]:POWer.......................................................................................................79
3.4 :SYSTem Commands......................................................................................................... 79
3.4.1 :SYSTem:COMMunication:LAN:DHCP................................................................. 80
3.4.2 :SYSTem:COMMunication:LAN:IP:ADDress.......................................................80
3.4.3 :SYSTem:COMMunication:LAN:IP:AUTO.............................................................81
3.4.4 :SYSTem:COMMunication:LAN:IP:GATeway...................................................... 82
3.4.5 :SYSTem:COMMunication:LAN:IP:MANual........................................................83
3.4.6 :SYSTem:COMMunication:LAN:IP:SET.................................................................84
3.4.7 :SYSTem:COMMunication:LAN:IP:SUBnet:MASK............................................ 84
3.4.8 :SYSTem:COMMunication:LAN:RESet..................................................................85
3.4.9 :SYSTem:COMMunication:LAN[:SELF]:PREFerred............................................85
3.4.10 :SYSTem:COMMunication:LAN:MDNS................................................................86
3.4.11 :SYSTem:COMMunication:LAN:HOST:NAME....................................................87
3.4.12 :SYSTem:COMMunication:LAN:MAC...................................................................87
3.4.13 :SYSTem:PRESet.......................................................................................................... 88
3.4.14 :SYSTem:PRESet:TYPE............................................................................................... 88
3.4.15 :SYSTem:PRESet:SAVE...............................................................................................89
3.4.16 :SYSTem:FSWitch:STATe............................................................................................89
3.4.17 :SYSTem:LANGuage...................................................................................................90
3.4.18 :SYSTem:DATE..............................................................................................................91
3.4.19 :SYSTem:TIME..............................................................................................................92
3.4.20 :SYSTem:STIMe............................................................................................................92
3.4.21 :SYSTem:CLEar.............................................................................................................93
3.4.22 :SYSTem:DISPlay:UPDate[:STATe]..........................................................................94
3.4.23 :SYSTem:LKEY.............................................................................................................. 94
3.4.24 :SYSTem:LKEY:DELete................................................................................................95
3.4.25 :SYSTem:OPTion:LIST?.............................................................................................. 96
3.4.26 :SYSTem:CONFigure:INFormation?......................................................................96
3.5 :MMEMory Commands....................................................................................................97
3.5.1 :MMEMory:CATalog.................................................................................................. 97
3.5.2 :MMEMory:CATalog:LENGth.................................................................................. 97
3.5.3 :MMEMory:COPY....................................................................................................... 98
3.5.4 :MMEMory:DELete.....................................................................................................99
IV Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

3.5.5 :MMEMory:DISK:FORMat..................................................................................... 100
3.5.6 :MMEMory:DISK:INFormation............................................................................ 100
3.5.7 :MMEMory:FILEtype............................................................................................... 101
3.5.8 :MMEMory:CHANnel:SELect................................................................................101
3.5.9 :MMEMory:LDISk:SPACe.......................................................................................102
3.5.10 :MMEMory:LOAD.....................................................................................................103
3.5.11 :MMEMory:MDIRectory........................................................................................ 103
3.5.12 :MMEMory:MOVE................................................................................................... 104
3.5.13 :MMEMory:PNAMe:EDIT.......................................................................................105
3.5.14 :MMEMory:PNAMe:STATe.................................................................................... 105
3.5.15 :MMEMory:SAVe......................................................................................................106
3.6 IEEE488.2 Common Commands.................................................................................107
3.6.1 *CLS..............................................................................................................................107
3.6.2 *ESE..............................................................................................................................107
3.6.3 *IDN?........................................................................................................................... 108
3.6.4 *PSC............................................................................................................................. 109
3.6.5 *RST..............................................................................................................................109
3.6.6 *SRE..............................................................................................................................110
3.6.7 *STB?............................................................................................................................110
3.6.8 *TRG.............................................................................................................................111
3.6.9 *WAI.............................................................................................................................111
3.7 :STATus Commands.........................................................................................................112
3.7.1 :STATus:OPERation:ENABle...................................................................................113
3.7.2 :STATus:OPERation[:EVENt].................................................................................. 113
4 Application Examples............................................................................................................ 115
4.1 To Output the RF Signal................................................................................................115
4.2 To Output the RF Sweep Signal..................................................................................115
5 Programming Examples........................................................................................................117
5.1 Programming Preparations..........................................................................................117
5.2 Excel Programming Examples.....................................................................................118
5.3 Matlab Programming Example...................................................................................122
5.4 LabVIEW Programming Example...............................................................................123
5.5 Visual C++ Programming Example...........................................................................128
6 Appendix....................................................................................................................................133
6.1 Appendix A: Factory Setting........................................................................................133
6.2 Appendix B: Warranty.................................................................................................... 135
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. V

VI Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

1Document Overview
This manual is your guide to programming the DSG5000 series microwave signal
generator by using SCPI commands through remote interface.
TIP
For the latest version of this manual, download it from the official website of RIGOL ( http://
www.rigol.com ).
Publication Number
PGG04100-1110
Software Version
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.
Format Conventions in this Manual
1. Menu
The menu item is denoted by the format of "Menu Name (Bold) + Character
Shading" in the manual. For example, Freq indicates clicking or tapping the "Freq"
menu to enter the "Freq" setting configuration menu.
2. Operation Procedures
">" denotes the next step of operation. For example, Interface > LAN indicates
that first clicking/tapping Interface and then clicking/taping LAN.
3. Connector
The connectors on the front or rear panel are usually denoted by the format of
"Connector Name (Bold) + Square Brackets (Bold)". For example, [RF 50Ω].
Content Conventions in this Manual
The DSG5000 series includes the following models. Unless otherwise specified, this
manual takes DSG5208 as an example to illustrate how to use the DSG5000 series.
Model Frequency Range No. of Channels
DSG5202 9 kHz to 20 GHz 2
DSG5204 9 kHz to 20 GHz 4
DSG5206 9 kHz to 20 GHz 6
DSG5208 9 kHz to 20 GHz 8
Document Overview
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. 1

Model Frequency Range No. of Channels
DSG5122 9 kHz to 12 GHz 2
DSG5124 9 kHz to 12 GHz 4
DSG5126 9 kHz to 12 GHz 6
DSG5128 9 kHz to 12 GHz 8
Manuals of this Product
The manuals of this product mainly include the quick guide, user guide, programming
guide, data sheet, and etc. For the latest version of this manual, download it from the
official website of RIGOL ( http://www.rigol.com ).
Document Overview
2Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

2SCPI 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). 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.
Syntax
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 quotation mark indicates querying a certain function and returns the
query results. The keywords of the command and the first parameter are separated by
a space. For example,
:SYSTem:COMMunication:LAN:IP:ADDress <
value >
SYSTem is the root keyword of the command, COMMunication is the second-level
keyword, LAN, IP, ADDress are the second-level, third-level, forth-level and fifth-
level keywords respectively. The command line starts with a colon, and different levels
of keywords are also separated by colons. < value > indicates a settable parameter.
The command ending with a quotation mark "?" indicates querying. The command
keywords :SYSTem:COMMunication:LAN:IP:ADDress and the parameter <
value >
are separated by a space.
In some commands with parameters, "," is often used to separate multiple
parameters. For example,
[:SOURce][:RF<
channel >]:SWEep:LIST:ADDList < freq >,< level >,< time >
Symbol Description
The following symbols are not sent with the commands.
1. Braces { }
The parameters enclosed in the braces are optional. You do not have to set it, also
you can set for one or more times.
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,
:SYSTem:LANGuage <
type >
Wherein, < type > can be set to CHINese|ENGLish.
3. Square Brackets [ ]
SCPI Command Overview
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. 3

The contents 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 command
[:SOURce]:RFALl:OUTPut[:STATe]?
sending any of the four commands below can generate the same effect:
:SOURce:RFALl:OUTPut:STATe?
:SOURce:RFALl:OUTPut?
:RFALl:OUTPut:STATe?
:RFALl:OUTPut?
4. Angle Brackets < >
The parameter enclosed in the angle brackets must be replaced by an effective
value. For example,
:FREQuency
4 MHz is the correct command form for sending the command
[:SOURce][:RF< channel >]:FREQuency < freq >[< unit >].
Parameter Type
The command parameters introduced in this manual include 5 types: bool, discrete,
integer, real number, and ASCII string.
1. Bool
The parameter can be set to ON, OFF, 1, or 0. For example,
:SYSTem:COMMunication:LAN:MDNS <
bool >
:SYSTem:COMMunication:LAN:MDNS?
Wherein, <
bool > can be set to 1|ON|0|OFF. The query returns 1 or 0.
2. Discrete
The parameter can be any of the values listed. For example,
:SYSTem:LANGuage <
type >
:SYSTem:LANGuage?
Wherein, < type > can be set to CHINese|ENGLish. The query returns an abbreviated
form: CHIN or ENGL.
3. Integer
Unless otherwise specified, the parameter can be any integer (NR1 format) within
the effective value range.
CAUTION
Do not set the parameter to a decimal, otherwise, errors will occur.
For example,
SCPI Command Overview
4Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

:SYSTem:BRIGhtness < value >
:SYSTem:BRIGhtness?
Wherein, < value > can be set to an integer ranging from 0 to 7. The query returns
an integer ranging from 0 to 7.
4. Real
The parameter can be any real number within the effective value range, and this
command accepts parameter input in decimal (NR2 format) and scientific notation
(NR3 format). For example,
[:SOURce][:RF<
channel >]:FREQuency < freq >[< unit >]
[:SOURce][:RF<
channel >]:FREQuency?
Wherein, < freq > can be set to a real number ranging from 9 kHz to 20 GHz.
5. ASCII String
The parameter can be the combinations of ASCII characters. For example,
:MMEMory:SAVe <
File_name >
Wherein, < File_name > is the filename of the file to be saved and can include
Chinese characters (one Chinese character occupies two bytes), English characters
and numbers. The filename cannot exceed 28 bytes.
Command Abbreviation
All the commands are case-insensitive. They can all be in upper case or in lower case.
If abbreviation is used, you must input all the capital letters in the command. For
example,
:SYSTem:COMMunication:LAN:IP:SET
can be abbreviated to
:SYST:COMM:LAN:IP:SET.
SCPI Command Overview
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. 5

3Command System
This chapter introduces the syntax, function, parameters, and usage of each
command.
3.1 :SOURce Commands
The:SOURce commands are used to set the related parameters of the main functions
of the microwave signal generator, including the frequency, level, phase, flatness
correction, Pulse, SWEEP, and so on.
3.1.1 [:SOURce][:RF]:FREQuency Commands
3.1.1.1 [:SOURce][:RF]:FREQuency
Syntax
[:SOURce][:RF< channel >]:FREQuency < freq >[< unit >]
[:SOURce][:RF<
channel >]:FREQuency?
Description
Sets the RF frequency of the specified channel.
Queries the RF frequency of the specified channel.
Parameter
Name Type Range Default
<channel> Discrete 1|2|3|4|5|6|7|8 1
<freq> Real 9 kHz to 20 GHz 20 GHz
<unit> Discrete Hz|kHz|MHz|GHz Hz
Remarks
•When <freq> is set in "Number" form, the default unit is Hz. For example,
4000000. Besides, <freq> can also be set in "Number + Unit" form, For
example, 4MHz.
•The default unit of the return value is Hz.
•When the frequency offset is 0 Hz, the frequency displayed in the interface
(namely the setting frequency) is equal to the actual output frequency.
Command System
6Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

•When the frequency offset is not 0 Hz, the output frequency is determined by
the setting frequency and frequency offset. The three parameters satisfy the
equation: setting frequency (display frequency) = output frequency + frequency
offset. You can query or set the RF frequency offset by using the [:SOURce]
[:RF]:FREQuency:OFFSet command.
Return Format
The query returns the RF frequency of the specified channel.
Example
:RF2:FREQ 4MHz /*Sets the RF frequency of CH2 to 4MHz.*/
:RF2:OFFS? /*The query returns 4000000Hz.*/
3.1.1.2 [:SOURce][:RF]:FREQuency:OFFSet
Syntax
[:SOURce][:RF< channel >]:FREQuency:OFFSet < freq >[< unit >]
[:SOURce][:RF<
channel >]:FREQuency:OFFSet?
Description
Sets the RF frequency offset of the specified channel.
Queries the RF frequency offset of the specified channel.
Parameter
Name Type Range Default
<channel> Discrete 1|2|3|4|5|6|7|8 1
<freq> Real -49 GHz to 49 GHz 0 Hz
<unit> Discrete Hz|kHz|MHz|GHz Hz
Remarks
•When <freq> is set in "Number" form, the default unit is Hz. For example,
20000. Besides, <freq> can also be set in "Number + Unit" form, For example,
20kHz.
•The default unit of the return value is Hz.
Command System
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. 7

•When the frequency offset is 0 Hz, the frequency displayed in the interface
(namely the setting frequency) is equal to the actual output frequency.
•When the frequency offset is not 0 Hz, the output frequency is determined by
the setting frequency and frequency offset. The three parameters satisfy the
equation: setting frequency (display frequency) = output frequency + frequency
offset. You can query or set the RF frequency by using the [:SOURce]
[:RF]:FREQuency command.
Return Format
The query returns the RF frequency offset of the specified channel.
Example
:RF2:FREQ:OFFS 20kHz /*Sets the RF frequency offset of CH2 to
20kHz*/
:RF2:FREQ:OFFS? /*The query returns 20000Hz.*/
3.1.2 [:SOURce][:RF]:LEVel Commands
3.1.2.1 [:SOURce][:RF]:LEVel
Syntax
[:SOURce][:RF< channel >]:LEVel < level >[< unit >]
[:SOURce][:RF<
channel >]:LEVel?
Description
Sets the RF output amplitude of the specified channel.
Queries the RF output amplitude of the specified channel.
Parameter
Name Type Range Default
<channel> Discrete 1|2|3|4|5|6|7|8 1
<level> Real -30 dBm to +25 dBm -30 dBm
<unit> Discrete dBm|V|W|dBmV|dBuV dBm
Command System
8Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

Remarks
•When < value> is set in "Number" form (for example, 2), the default unit is
dBm. When set in "Number + Unit" form (for example, 2dBm), the level
displayed in the interface of the microwave signal generator is related to the
setting of the level unit.
-When the level unit is "dBm", 2.00dBm is displayed.
-When the level unit is "dBmV", 48.99dBmV is displayed.
-When the level unit is "dBuV", 108.99dBuV is displayed.
-When the level unit is "Volts", 281.50mV is displayed.
-When the level unit is "Watts", 1.58mW is displayed.
•The default unit of the return value is dBm.
•When the amplitude offset is 0 dB, the display amplitude (namely the setting
amplitude) is equal to the actual output amplitude.
•When the amplitude offset is not 0 dB, the output amplitude is determined by
the setting amplitude and amplitude offset. The three parameters satisfy the
equation: setting amplitude (display amplitude) = output amplitude +
amplitude offset. You can query or set the RF amplitude offset by using the
[:SOURce][:RF]:LEVel:OFFSet command.
Return Format
The query returns the RF output amplitude of the specified channel.
Example
:LEV 2dBm /*Sets the RF output amplitude of CH1 to 2dBm (by
default, CH1 is selected).*/
:LEV? /*The query returns 2.00.*/
3.1.2.2 [:SOURce][:RF]:LEVel:LIMit
Syntax
[:SOURce][:RF< channel >]:LEVel:LIMit < value >[< unit >]
[:SOURce][:RF<
channel >]:LEVel:LIMit?
Description
Sets the limit of the RF output amplitude for the specified channel.
Command System
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. 9

Queries the limit of the RF output amplitude for the specified channel.
Parameter
Name Type Range Default
<channel> Discrete 1|2|3|4|5|6|7|8 1
<value> Real -30 dBm to 25 dBm 25 dBm
<unit> Discrete dBm|V|W|dBmV|dBuV dBm
Remarks
•When < value> is set in "Number" form (for example, 2), the default unit is
dBm. When set in "Number + Unit" form (for example, 2dBm), the level
displayed in the interface of the microwave signal generator is related to the
setting of the level unit.
-When the level unit is "dBm", 2.00dBm is displayed.
-When the level unit is "dBmV", 48.99dBmV is displayed.
-When the level unit is "dBuV", 108.99dBuV is displayed.
-When the level unit is "Volts", 281.50mV is displayed.
-When the level unit is "Watts", 1.58mW is displayed.
•The default unit of the return value is dBm.
Return Format
The query returns the limit of the RF output amplitude for the specified channel.
Example
:LEV:LIM 5.6 /*Sets the limit of the RF output amplitude of CH1 to
5.6dBm (by default, CH1 is selected).*/
:LEV:LIM? /*The query returns 5.60.*/
3.1.2.3 [:SOURce][:RF]:LEVel:OFFSet
Syntax
[:SOURce][:RF< channel >]:LEVel:OFFSet < value >
[:SOURce][:RF<
channel >]:LEVel:OFFSet?
Description
Sets the amplitude offset of the RF output for the specified channel.
Command System
10 Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

Queries the amplitude offset of the RF output for the specified channel.
Parameter
Name Type Range Default
<channel> Discrete 1|2|3|4|5|6|7|8 1
<value> Real -200 dB to 200 dB 0 dB
Remarks
•When <value> is set in "Number" form, the default unit is dB. Besides, <value>
can also be set in "Number + Unit" form. For example, 10dB.
•The default unit of the return value is dB.
•When the amplitude offset is 0 dB, the display amplitude (namely the setting
amplitude) is equal to the actual output amplitude.
•When the amplitude offset is not 0 dB, the output amplitude is determined by
the setting amplitude and amplitude offset. The three parameters satisfy the
equation: setting amplitude (display amplitude) = output amplitude +
amplitude offset. You can query or set the RF amplitude by using the [:SOURce]
[:RF]:LEVel command.
Return Format
The query returns the amplitude offset of the RF output for the specified channel.
Example
:LEV:OFFS 10 /*Sets the amplitude offset of the RF output of CH1
to 10dB (by default, CH1 is selected).*/
:LEV:OFFS? /*The query returns 10.00.*/
3.1.3 [:SOURce][:RF]:PHASe Commands
3.1.3.1 [:SOURce][:RF]:PHASe
Syntax
[:SOURce][:RF< channel >]:PHASe < value >
[:SOURce][:RF<
channel >]:PHASe?
Description
Sets the phase deviation of the RF output for the specified channel.
Command System
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. 11

Queries the phase deviation of the RF output for the specified channel.
Parameter
Name Type Range Default
<channel> Discrete 1|2|3|4|5|6|7|8 1
<value> Real -720 deg to 720 deg 0 deg
Remarks
•When <value> is set in "Number" form, the default unit is deg. Besides,
<value> can also be set in "Number + Unit" form. For example, 35deg.
•The default unit of the return value is deg.
Return Format
The query returns the phase deviation of the RF output for the specified channel.
Example
:PHAS 35 /*Sets the phase deviation of the RF output of CH1 to
35deg (by default, CH1 is selected).*/
:PHAS? /*The query returns 35.00.*/
3.1.3.2 [:SOURce][:RF]:PHASe:RESet
Syntax
[:SOURce][:RF< channel >]:PHASe:RESet
Description
Resets the current phase deviation to 0deg for the specified channel.
Parameter
Name Type Range Default
<channel> Discrete 1|2|3|4|5|6|7|8 1
Remarks
N/A
Return Format
N/A
Example
N/A
Command System
12 Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.