Rigol DSG800 Programming Guide

Page 1
RIGOL
Programming Guide
DSG800 Series RF Signal Generator
July 2015
RIGOL Technologies, Inc.
Page 2
Page 3
RIGOL

Guaranty and Declaration

Copyright
© 2015 RIGOL Technologies, Inc. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL Technologies, Inc.
Publication Number
PGG02102-1110
Software Version
00.01.02 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
company’s sole decision.
Information in this publication replaces all previously corresponding material. 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 thi s document is forbidden to be copied, photocopied or rearranged without prior written
approval of RIGOL.
Product Certification
RIGOL guarantees this product conforms to the national and industrial standards in China as well as the ISO9001:2008 standard and the IS O14001:2004 standard. Other international standard conformance certification is 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
Page 4
RIGOL

Safety Requirement

General Safety Summary

Please review the following safety precautions carefully before putting the instrument into operation so as to avoid any personal injury or damage to the i nstrument and any product connected to it. To prevent potential hazards, please use the instrument only specified by this manual.
Use Proper Power Cord.
Only the power cord designed for the instrument and authorized for use within the loc al country could be used.
Ground the Instrument.
The instrument is grounded through the Protective Earth lead of the power cord. To avoid electric shock, it is essential to connect the earth terminal of the power cord to the Protective Earth terminal before connecting any inputs or outputs.
Connect the Probe Correctly.
If a probe is used, do not connect the ground lead to high volta ge since it has isobaric electric potential as the ground.
Observe All Terminal Ratings.
To avoid fire or shock hazard, observe all ratings and markers on the instrument and check your manual for more information about ratings before connecting the instrument.
Use Proper Overvoltage Protection.
Make sure that no overvoltage (such as that caused by a thunderstorm) can reach the product, or else the operator might be exposed to the danger of electric al shock.
Do Not Operate Without Covers.
Do not operate the instrument with covers or panels removed.
Do Not Insert Anything Into the Holes of Fan.
Do not insert anything into the holes of the fan to avoid damaging the ins trument.
Use Proper Fuse.
Please use the specif ied fuses.
Avoid Circuit or Wire Exposure.
Do not touch exposed junctions and components when the unit is powered.
Do Not Operate With Suspected Failures.
If you suspect damage occurs to the instrument, have it inspected by RIGOL authorized personnel before further operations. Any maintenance, adjustment or replacement especially to circuits or accessories must be performed by RIGOL authorized personnel.
Keep Well Ventilation.
Inadequate ventilation may cause an increase of instrument temperature which would cause damage to the instrument. So please keep the instrument well ventilated and inspect the intake and fan regularly.
Do Not Operate in Wet Conditions.
In order to avoid short circuiting to the interior of the device or electric shock, please do not operate the instrument in a humid environment.
Page 5
RIGOL
Do Not Operate in an Explosive Atmosphere.
In order to avoid damage to the device or personal injuries, it is important to operate the device away from an explosive atmosphere.
Keep Product Surfaces Clean and Dry.
To avoid the influence of dust and/or moisture in the air, please keep the surface of the device clean and dry.
Electrostatic Prevention.
Operate the instrument in an electrostatic disc ha r g e protective environment to avoid damage induced by static discharges. Always ground both the internal and external conductors of cables to release static before making connections.
Proper Use of Battery.
If a battery is supplied, it must not be exposed to high temperature or in contact with fire. Keep it out of the reach of children. Improper change of battery (note: lithium battery) may cause explosion. Use RIGOL specified battery only.
Handling Sa f ety.
Please handle with care during transportation to avoid damage to keys, knob interfaces and other parts on the panels.
DSG800 Programming Guide III
Page 6
RIGOL
WARNING
CAUTION
product or other property.
DANGER
It calls attention to an operation, if not correctly performed, could result in injury or hazard immediately.
WARNING
It calls attention to an operation, if not correctly performed, could result in potential injury or hazard.
CAUTION
It calls attention to an operation, if not correctly performed, could result in damage to the product or other devices connected to the pr oduct.
Hazardous
Safety
Protective Terminal
Chassis
Test

Safety Terms and Symbols

Terms Used in this Manual. These terms may appear in this manual:
Warning statements indicate conditions or practices that could result in injury or loss of life.
Caution statements indicate conditions or practices that could result in damage to this
Terms Used on the Product. These terms may appear on the product:
Symbols Used on the Product. These symbols may appear on the product:
Voltage
Warning
Earth
Ground
Ground
IV DSG800 Programming Guide
Page 7
RIGOL

Allgemeine Sicherheits Informationen

Überprüfen Sie diefolgenden Sicherheitshinweise sorgfältigumPersonenschädenoderSchäden am Gerätundan damit verbundenen weiteren Gerätenzu vermeiden. Zur Vermeidung vonGefahren, nutzen Sie bitte das Gerät nur so, wi ein diesem Handb uchangegeben.
Um Feuer oder Verletzungen zu vermeiden, verwenden Sie ein ordnungsgemäßes Netzkabel.
Verwenden Sie für dieses Gerät nur das für ihr Land zugelassene und genehmigte Netzkabel.
Erden des Gerätes.
Das Gerät ist durch den Schutzleiter im Netzkabel geerde t. Um Gefahren durch elektrischen Schlag zu vermeiden, ist es u nerlässlich, die Erdung durchzuführen. Erst dann dürfen weitere Ein- oder Ausgänge verbunden werden.
Anschluss einesTastkopfes.
Die Erdungsklemmen der Sonden sindauf dem gleichen Spannungspegel des Instruments geerdet. SchließenSie die Erdungsklemmen an keine hohe Spannung an.
Beachten Sie alle Anschlüsse.
Zur Vermeidung von Feuer oder Stromschlag, beachten Sie alle Bemerkungen und Markierungen auf dem Instrument. Befolgen Sie die Bedienungsanleitung für weitere Informationen, bevor Sie weitere Anschlüsse an das Instrument legen.
Verwenden Sie einen geeigneten Überspannungsschutz.
Stellen Sie sicher, daß keinerlei Überspannung (wie z.B. durch Gewitter verursacht) das Gerät erreichen kann. Andernfallsbestehtfür den Anwender die GefahreinesStromschlages.
Nicht ohne Abdeckung einschalten.
Betreiben Sie das Gerät nicht mit entfernten Gehäuse-Abdeckungen.
Betreiben Sie das Gerät nicht geöffnet.
Der Betrieb mit offenen oder entfernten Gehäuseteilen ist nicht zulässig. Nichts in entsprechende Öffnungen stecken (Lüfter z.B.)
Passende Sicherung verwenden.
Setzen Sie nur die sp ezifikationsgemäßen Sicherungen ein.
Vermeiden Sie ungesc hützte Verbindunge n.
Berühren Sie keine unisolierten Verbindungen oder Baugruppen, während das Gerät in Betrieb ist.
Betreiben Sie das Gerät nicht im Fehlerfall.
Wenn Sie am Gerät einen Defekt vermuten, sorgen Sie dafür, bevor Sie das Gerät wieder betreiben, dass eine Untersuchung durch RIGOL autorisiertem Personal durchgeführt wird. Jedwede Wartung, Einstellarbeiten oder Austausch von Teilen am Gerät, sowie am Zubehör dürfen nur von RIGOL autorisiertem Personal durchgeführt werden.
Belüftung sicherstellen.
Unzureichende Belüftung kann zu Temperaturanstiegen und somit zu thermischen Schäden am Gerät führen. Stellen Sie deswegen die Belüftung sicher und kontrollieren regelmäßig Lüfter und Belüftungsöffnungen.
Nicht in feuchter Umgebung betreiben.
Zur V ermeidung v on Ku rzschluß im Gerätei nneren un d Stromsch lag betreiben Sie das Gerät bi tte niemals in feuchter Umgebung.
Nicht in explosiver Atmosphäre betreiben.
Zur Vermeidung von Personen- und Sachschäden i st es unumgänglich, das Gerät ausschließlich fernab
DSG800 Programming Guide V
Page 8
RIGOL
jedweder explosiven Atmosphäre zu betreiben.
Geräteoberflächen sauber und trocken halten.
Um den Einfluß von Sta ub und Feuchtigkeit aus der Luft auszuschließen, halten Sie bitte die Geräteoberflächen sauber und trocken.
Schutz gegen elektrostatische Entladung (ESD).
Sorgen Sie für eine elektrostatisch geschützte Umgebung , um somit Schäden und Funktionsstörungen durch ESD zu vermeiden. Erden Sie vor dem Anschluß immer Innen- und Außenleite r der Verbindungsleitung, um statische Aufladung zu entladen.
Die richtige Verwendung desAkku.
Wenneine Batterieverwendet wird, vermeiden Sie hohe Temperaturen bzw. Feuer ausgesetzt werden. Bewahren Sie es außerhalbder Reichweitevon Kindern auf. UnsachgemäßeÄnderung derBatterie (Anmerkung: Lithium-Batterie) kann zu einer Explosion führen. VerwendenSie nur von RIGOL angegebenenAkkus.
Sicherer Transport.
Transportieren Sie das Gerät sorgfältig (Verpackung!), um Schäden an Bedienelementen, Anschlüssen und anderen Teilen zu vermeiden.
VI DSG800 Programming Guide
Page 9

Sicherheits Begriffe und Symbole

WARNING
Tod von Personen zur Folge haben könne n.
CAUTION
hervorrufen können.
DANGER
weist auf eine Verletzung oder Gefährdung hin, die sofort geschehen kann.
WARNING
weist auf eine Verletzung oder Gefährdung hin, die möglicherweise nicht sofort geschehen.
CAUTION
weist auf eine Verletzung oder Gefährdung hin und bedeutet, dass eine mögliche Beschädigung des Instruments oder anderer Gegenstände auftreten kann.
Begriffe in diesem Guide. Diese Begriffe können in diesem Handbuch auftauchen:
Die Kennzeichnung WARNING beschreibt Gefahrenquellen die leibliche Schäden oder den
Die Kennzeichnung Cautio n (Vorsicht) beschreibt Gefahrenquel len die Schäden am Gerät
Begriffe auf dem Produkt. Diese Bedingungen können auf dem Produkt erscheinen:
Symbole auf dem Produkt. Diese Symbole können auf dem Produkt erscheinen:
RIGOL
Gefährliche Spannung
Sicherheits­Hinweis
Schutz-erde Gehäusemasse Erde
DSG800 Programming Guide VII
Page 10
RIGOL
Tip
The latest version of this manual can be downloaded from www.rigol.com.

Document Overview

This manual introduces how to program the RF signal generator over the remote interfaces in details.
Main Topics in this Manual:
Chapter 1 Programming Overview
This chapter outlines how to build the remote co mmunication between the RF signal generator and PC and how to control the RF signal generator remotely. Besides, it also provides a brief introduction of t he SCPI commands.
Chapter 2 Command System
This chapter introduces the syntax, function, parameter and using instruction of each DSG800 command in alphabetical order (from A to Z).
Chapter 3 Application Examples
This chapter provides the application examples of the main functions of the RF signal generator. In the application examples, a series of commands are combined to realize the basic functions of the RF signal generator.
Chapter 4 Programming Demos
This chapter introduces how to program and control DSG800 using development tools, such as Visual C++, Visual Basic and LabVIEW.
Chapter 5 Appendix
This chapter provides various information, such as the command list and factory setting list.
Format Conventions in this Manual:
1. Key
The key at the fron t panel is denoted by th e format of "Key Name (Bold) + T ex t Box" in the manual. For example, FREQ denotes the FREQ key.
2. Menu
The menu item is denoted by the format of "Menu Word (Bold) + Character Shading" in the manual. For example, LF denotes the "LF" menu item under FREQ.
3. Operation Step
The next step of operation is denoted by an arrow "" in the manual. For example, FREQ LF denotes pressing FREQ at the front panel and then pressing LF.
Content Conventions in this Manual:
DSG800 series RF signal generator includes DSG830 and DSG815. The introductions of the DSG800 series commands in this manual are based on DSG830, unless otherwise noted.
Page 11
Contents RIGOL
Contents
Guaranty and Declaration ......................................................................................................... I
Safety Requirement .................................................................................................................. II
General Safety Summary ............................................................................................................. II
Safety Terms and Symbols .......................................................................................................... IV
Allgemeine Sicherheits Informationen ........................................................................................... V
Sicherheits Begri ffe und Symbole ............................................................................................... VII
Document Overview ............................................................................................................. VIII
Chapter 1 Programming Overview...................................................................................... 1-1
To Build Remote Communication ............................................................................................... 1-2
Remote Control Methods ........................................................................................................... 1-3
SCPI Command Overview .......................................................................................................... 1-4
Syntax ............................................................................................................................... 1-4
Symbol Description ............................................................................................................ 1-4
Parameter Type .................................................................................................................. 1-5
Command Abbreviation ...................................................................................................... 1-5
Chapter 2 Command System ............................................................................................... 2-1
IEEE488.2 Common Commands ................................................................................................. 2-2
*IDN? ............................................................................................................................... 2-2
*TRG ................................................................................................................................ 2-2
:MMEMory Commands .............................................................................................................. 2-3
:MMEMory:CATalog ............................................................................................................ 2-3
:MMEMory:CATalog:LENGth ................................................................................................ 2-4
:MMEMory:COPY ................................................................................................................ 2-4
:MMEMory:DELete .............................................................................................................. 2-4
:MMEMory:DISK:FORMat .................................................................................................... 2-5
:MMEMory:DISK:INFormation ............................................................................................. 2-5
:MMEMory:FILEtype ........................................................................................................... 2-5
:MMEMory:LDISk:SPACe ..................................................................................................... 2-6
:MMEMory:LOAD ................................................................................................................ 2-6
:MMEMory:MDIRectory ....................................................................................................... 2-6
:MMEMory:MOVE ............................................................................................................... 2-7
:MMEMory:PNAMe:EDIT ..................................................................................................... 2-7
:MMEMory:PNAMe:STATe .................................................................................................... 2-8
:MMEMory:SAVe ................................................................................................................. 2-8
:OUTPut Command ................................................................................................................... 2-9
:OUTPut[:STATe] ................................................................................................................ 2-9
:SOURce Commands ............................................................................................................... 2-10
[:SOURce]:AM Command Subsystem................................................................................. 2-10
[:SOURce]:CORRection Command Subsystem .................................................................... 2-16
[:SOURce]:FM Command Subsystem ................................................................................. 2-18
[:SOURce]:FMPM:TYPE..................................................................................................... 2-23
[:SOURce]:FREQuency Command Subs ystem .................................................................... 2-24
[:SOURce]:INPut:TRIGger:SLOPe ...................................................................................... 2-25
[:SOURce]:LEVel Command Subsystem ............................................................................. 2-26
[:SOURce]:LFOutput Command Subsystem........................................................................ 2-28
[:SOURce]:MODulation:STATe ........................................................................................... 2-30
[:SOURce]:PM Command Subsystem ................................................................................. 2-31
[:SOURce]:PULM Command Subsyst em ............................................................................. 2-36
[:SOURce]:SWEep Command Subsystem ........................................................................... 2-46
:STATus Commands ................................................................................................................ 2-63
:STATus:OPERation:CONDition .......................................................................................... 2-66
:STATus:OPERation:ENABle ............................................................................................... 2-66
DSG800 Programming Guide IX
Page 12
RIGOL Contents
:STATus:OPERation[:EVENt] .............................................................................................. 2-66
:STATus:QUEStionable:CALibration:CONDition .................................................................... 2-67
:STATus:QUEStionable:CALibration:ENABle ......................................................................... 2-68
:STATus:QUEStionable:CALibration[:EVENt] ........................................................................ 2-68
:STATus:QUEStionable:CONDition ...................................................................................... 2-68
:STATus:QUEStionable:CONNect:CONDition ........................................................................ 2-69
:STATus:QUEStionable:CONNect:ENABle ............................................................................ 2-70
:STATus:QUEStionable:CONNect[:EVENt] ........................................................................... 2-70
:STATus:QUEStionable:ENABle........................................................................................... 2-70
:STATus:QUEStionable[:EVENt].......................................................................................... 2-71
:STATus:QUEStionable:FREQuency:CONDition .................................................................... 2-72
:STATus:QUEStionable:FREQuency:ENABle ......................................................................... 2-73
:STATus:QUEStionable:FREQuency[:EVENt] ........................................................................ 2-73
:STATus:QUEStionable:MODulation:CONDition .................................................................... 2-74
:STATus:QUEStionable:MODulation:ENABle ........................................................................ 2-75
:STATus:QUEStionable:MODulation[:EVENt] ....................................................................... 2-75
:STATus:QUEStionable:POWer:CONDition ........................................................................... 2-76
:STATus:QUEStionable:POWer:ENABle ............................................................................... 2-77
:STATus:QUEStionable:POWer[:EVENt] .............................................................................. 2-77
:STATus:QUEStionable:SELFtest:CONDition ........................................................................ 2-78
:STATus:QUEStionable:SELFtest:ENABle ............................................................................. 2-79
:STATus:QUEStionable:SELFtest[:EVENt] ............................................................................ 2-79
:STATus:QUEStionable:TEMP:CONDition ............................................................................. 2-80
:STATus:QUEStionable:TEMP:ENABle ................................................................................. 2-81
:STATus:QUEStionable:TEMP[:EVENt] ................................................................................ 2-81
:SYSTem Commands ............................................................................................................... 2-82
:SYSTem:BRIGhtness ........................................................................................................ 2-83
:SYSTem:CLEar ................................................................................................................ 2-83
:SYSTem:COMMunication:INTerface ................................................................................... 2-83
:SYSTem:COMMunication:LAN:DHCP .................................................................................. 2-84
:SYSTem:COMMunication:LAN:IP:ADDress ......................................................................... 2-84
:SYSTem:COMMunication:LAN:IP:AUTO ............................................................................. 2-85
:SYSTem:COMMunication:LAN:IP:GATeway ........................................................................ 2-85
:SYSTem:COMMunication:LAN:IP:MANual .......................................................................... 2-86
:SYSTem:COMMunication:LAN:IP:SET ................................................................................ 2-86
:SYSTem:COMMunication:LAN:IP:SUBnet:MASK ................................................................. 2-87
:SYSTem:COMMunication:LAN:RESet ................................................................................. 2-87
:SYSTem:COMMunication:LAN[:SELF]:PREFerred ................................................................ 2-87
:SYSTem:DATE ................................................................................................................. 2-88
:SYSTem:DISPlay:UPDate[:STATe] ..................................................................................... 2-88
:SYSTem:FSWitch:STATe ................................................................................................... 2-89
:SYSTem:LANGuage .......................................................................................................... 2-89
:SYSTem:LKEY ................................................................................................................. 2-90
:SYSTem:POWer:ON:TYPE ................................................................................................ 2-90
:SYSTem:PRESet .............................................................................................................. 2-91
:SYSTem:PRESet:TYPE ...................................................................................................... 2-91
:SYSTem:PRESet:SAVE ...................................................................................................... 2-91
:SYSTem:TIME ................................................................................................................. 2-92
:SYSTem:TIME:STATe ....................................................................................................... 2-92
:TRIGger Commands ............................................................................................................... 2-93
:TRIGger:PULSe[:IMMediate] ............................................................................................ 2-93
:TRIGger[:SWEep][:IMMediate] ........................................................................................ 2-93
:UNIT Command ..................................................................................................................... 2-94
:UNIT:POWer ................................................................................................................... 2-94
Chapter 3 Application Examples ........................................................................................ 3-1
To Output RF signal ................................................................................................................... 3-2
To Output RF Sweep Signal ........................................................................................................ 3-2
Page 13
Contents RIGOL
To Output RF Modulated Signal.................................................................................................. 3-3
Chapter 4 Programming Demos .......................................................................................... 4-1
Programming Preparations ........................................................................................................ 4-2
Excel Programming Demo ......................................................................................................... 4-3
Matlab Programming Demo ....................................................................................................... 4-7
LabVIEW Programming Demo.................................................................................................... 4-8
Visual Basic Programming Demo .............................................................................................. 4-12
Visual C++ Programming Demo .............................................................................................. 4-15
Chapter 5 Appendix ............................................................................................................ 5-1
Appendix A: Command List ....................................................................................................... 5-1
Appendix B: Factory Setting ...................................................................................................... 5-6
Appendix C: Warranty ............................................................................................................... 5-8
DSG800 Programming Guide XI
Page 14
Page 15
Chapter 1 Programming Overview RIGOL

Chapter 1 Programming Overview

This chapter introduces how to build the remote communication between the instrument and PC and provides an overview of the syntax, abbreviation rules and status system of the SCPI commands.
Main topics of this chapter:
To Build Remote Communication Remote Control MethodsSCPI Command Overview
Page 16
RIGOL Chapter 1 Programming Overview

To Build Remote Communication

You can build the remote communication between DSG800 and the PC via USB or LAN interface.
Operating Steps:
1. Install the Ultra Sigma common PC software
Acquire the Ultra Sigma common PC software from www.rigol.com or the resource CD in the standard accessories; then, install it according to the instructions.
2. Connect the instrument and PC and configure the interface parameters of the instrument
DSG800 supports USB and LAN communication interfaces, as shown in the figure below.
LAN USB DEVICE
Figure 1-1 DSG800 Communication Interfaces
(1) Use the USB interface:
Connect the USB DEVICE interface at th e rear panel of DSG800 and the USB HOST interface of the
PC using a USB cable .
(2) Use the LAN interface:
Make sure that your PC is connected to the local network. Check whether your l ocal network supports DHCP or auto IP mode. If not, you need to
acquire the network interface parameters available, including the IP address, subnet mask, gateway and DNS.
Connect DSG800 to the local network using a network cable.  Press SystI/O ConfigLAN to configure the IP address, subnet mask, gateway and
DNS of the instrument.
3. Check whether the connection is successful
Start-up Ultra Sigma, sea rch for the RF signal generator resource, right-click the resource name and select "SCPI Panel Contro l" from the pop-up menu. Enter the correct command in the pop-up SCPI control panel and click Send Command, Read Response or Send&Read to check whether the connection is successful, as shown in the figure on the next page (take the USB interface as an example).
Page 17
Chapter 1 Programming Overview RIGOL

Remote Control Methods

1. User-defined programming
You can program and control DSG800 usi ng the SCPI (Standard Commands for Programmable Instruments) commands listed in chapter 2 (such as Visual C++, Visual Basic and LabVIEW). For the details, refer to the introductions in chapter 4
Programming Demos.
2. Send SCPI commands via PC software
You can use the PC software Ultra Sigma (provided by RIGOL) to send SCPI commands to control the RF signal generator remotely.
DSG800 Programming Guide 1-3
Command System in various development environments
Page 18
RIGOL Chapter 1 Programming Overview

SCPI Command Overview

SCPI (Standard Comm ands for Programmable Instruments) is a standardized instrument programming language that is based on the standard IEEE488.1 and IEEE488.2 and conforms to various standards (such as the floating point operation rule in IEEE754 standard, ISO646 7-bit coded character for information interchange (equivalent to ASCll programming)). This chapter describes the syntax, symbols, parameters and abbreviation rules of the SCPI commands.

Syntax

SCPI commands present a hierarchical tree structure and have multiple sub-systems, each of which contains a root keyword and one or more sub-keywords. The command string usually begins with ":"; the keywords are separted by ":" and are followed by the parameter settings available; "?" is added at the end of the command string to indicate query; space is used to separate the command and parameter.
For example, :SYSTem:COMMunication:LAN:IP:ADDress <value> :SYSTem:COMMunication:LAN:IP:ADDress?
SYSTem is the root keyword of the command above. COMMunication, LAN, IP and ADDress are the second-level, third-level, forth-level and fifth-level keywords respectively . The command string begins with ":" which is also used to separate the multi-level keywords. <value> denotes the parameter available for setting. "?" denotes query and the RF signal ge nerator returns the response information (the output value or internal setting value of the instrument ) when receiving a query command. The command :SYSTem:COMMunication:LAN:IP:ADDress and prarameter <value> are separated by a space.
"," is generally used for separating different parameters contained in the same command; for example, [:SOURce]:SWEep:LIST:LIST? <Start>,<Count>

Symbol Description

The following four symbols are not the content of SCPI commands and will not be sent with the command; but, they are usually used to describe the parameters in the commands.
1. Braces { } Multiple optional parameters are enclosed in the braces and one of the parameters must be selected when sending the co mmand.
2. Vertical Bar | The vartical bar is used to separate multiple parameters. When you send a command, one of the parameters must be selected. For example, the :SYSTem:LANGuage CHINese|ENGLish command.
3. Square Brackets [ ] The contents (command keywords) enclosed in the square brackets are optional and will be executed no matter whether they are omitted or not. For example, for the [:SOURce]:AM[:DEPTh]? command, sending any of the four commands below can generate the same effect. :AM? :AM:DEPTh? :SOURce:AM? :SOURce:AM:DEPTh?
4. Triangle Brackets < > The parameter enclosed in the triangle brack ets must be replaced by an effective value. For example, send the [:SOURce ] :FR EQ u enc y <value > command in :FREQuency 4MHz form.
Page 19
Chapter 1 Programming Overview RIGOL

Parameter Type

The parameters of the commands introduced in this manual contains 5 types: bool, integer, real number, discrete and ASCII string.
1. Bool The parameter could be OFF, ON, 0 or 1. For example, [:SOURce]:AM:STATe ON|OFF|1|0.
2. Integer Unless otherwise noted, the parameter can be any integer within the effective value range. Note that do not set the parameter to a decimal; otherwise, errors will occur. For example, in the :SYSTem:BRIGhtness <value> command, <value> can be any integer from 1 to 8.
3. Real Number
Unless otherwise noted, the parameter can be any value within the effective value range. For example, <value> in the [:SOURce]:AM:FREQuency <value> command can be any real number from 10Hz to 100 kHz.
4. Discrete The parameter could only be one of the specified values or characters. For example, in the [:SOURce]:AM:WAVEform SINE|SQUA command, the parameter can only be SINE or SQUA.
5. ASCII String The parameter should be the combinations of ASCII characters. For example, in the :MMEMory:SAVe <file_name> command, <file_name> is the filename of the file to be saved and can include Chinese characters (a Chinese character occupies two bytes), English characters and numbers. The filename cannot exceed 28 bytes.

Command Abb r eviation

All the commands are case-insensitive and you can use any of them. If abbreviation is used, all the capital letters in the command must be written completely. For example, the :MMEMory:DISK:FORMat command can be abbreviated to :MMEM:DISK:FORM.
DSG800 Programming Guide 1-5
Page 20
Page 21
Chapter 2 Command System RIGOL

Chapter 2 Command System

This chapter introduces the syntax, function, parameter and using instruction of each DSG800 command in alphabetical (A to Z) order.
Main topics of this chapter:
IEEE488.2 Common Commands:MMEMory Commands :OUTPut Command:SOURce Commands :STATus Commands :SYSTem Commands :TRIGger Commands :UNIT Command
Page 22
RIGOL Chapter 2 Command System
Description
Query the ID string of the instrument.
Technologies,DSG830,DSG8A170200001,00.01.01.

IEEE488.2 Common Commands

The IEEE488.2 common commands are used to q uery the basic information about the instrument or execute common operations. These commands usually begin with "*", contain a 3-charac ter command keyword and relate to the status register.
[1]
Command List
 *IDN?  *TRG

*IDN?

Syntax *IDN?
Return Format The query returns the ID string of the instrument. For example, Rigol

*TRG

:
Syntax *TRG
Description Trigger a pulse modulation or RF sweep immediately.
Related
Commands
[1]
Note
not included and you can refer to the complete introductions of the commands in the text according to the keywords.
: In the "Command List" in this manual, the parameters in the setting commands and the query commands are
:TRIGger:PULSe[:IMMediate] :TRIGger[:SWEep][:IMMediate]
Page 23
Chapter 2 Command System RIGOL
Name
Type
Range
Default
<path>.
Example
:MMEM:CAT? D:

:MMEMory Commands

The :MMEMory c ommands are used to store files to the internal or external memory of the instrument, read or delete the specified file as well as query the disk information.
Command List:
:MMEMory:CATalog :MMEMory:CATalog:LENGth :MMEMory:COPY:MMEMory:DELete:MMEMory:DISK:FORMat:MMEMory:DISK:INFormation:MMEMory:FILEtype:MMEMory:LDISk:SPACe:MMEMory:LOAD:MMEMory:MDIRectory:MMEMory:MOVE:MMEMory:PNAMe:EDIT:MMEMory:PNAMe:STATe :MMEMory:SAVe

:MMEMory:CATalog

Syntax :MMEMory:CATalog? <path>
Description Query all the files and folders under the specified path.
Parameter
<path> ASCII string Valid path --
Explanation <path>: the local memory (D disk), external memory (E disk; when a USB
storage device is detected by the USB HOST interface at the rear panel) or the subdirectory unde r the D or E disk.
The query returns a list of all the files and folders under the path specified by
Return Format NO.1 File Name: Rigol
NO.2 File Name: 4.STA
DSG800 Programming Guide 2-3
Page 24
RIGOL Chapter 2 Command System
Name
Type
Range
Default
<path>
ASCII string
Valid path
--
subdirectory unde r the D or E disk.
D disk*/
Syntax
:MMEMory:COPY <file_source>,<file_destination>
by <file_destination>.
be copied
operation fails.
Example
:MMEM:COPY D:\1.STA,D:\
Syntax
:MMEMory:DELete <file_name>
Description
Delete the specified file or folder under the specified operation path.
Name
Type
Range
Default
be deleted
example, :MMEM:DEL D:\NEW\8.STA.
path*/

:MMEMory:CATalog:LENGth

Syntax :MMEMory:CATalog:LENGth? <path>
Description Query the number of files and folders under the specified path.
Parameter
Explanation <path> can be the local memory (D disk), external memory (E disk; when a USB
storage device is detected by the USB HOST interface at the rear panel) or the
Return Format The query returns an integer. For example, 2.
Example
:MMEM:CAT:LENG? D: /*Query and return the number of files and folders in the

:MMEMory:COPY

Description Copy the file or folder specified by <file_source> to the destination path specified
Parameter
Explanation <file_source> denotes the file or folder to be copied. The file or folder name
If the file or folder specified by <file_source> does not exist, the operation
If the destination path specified by <file_destination> does not exist, the copy
Name Type Range Default
<file_source> ASCII string
The name of the file or folder to
<file_destination> ASCII string Valid destination path --
must contain the path. <file_destination> denotes the destination path and does not include the filename.
fails.
--

:MMEMory:DELete

Parameter
<file_name> ASCII string
Explanation This command is valid only when the specified file or folder exists under the
current operation path or the specified path.
<file_name> can be the name of a file or folder under the current operation
path or a file or folder name containing the specified path. For
Example :MMEM:DEL 8.STA /*Delete the file named "8.STA" under the current operation
The name of the file or folder to
--
Page 25
Chapter 2 Command System RIGOL
Syntax
:MMEMory:DISK :IN Format i on? <Disk>
Name
Type
Range
Default
Free:0.99 GB
:MMEMory:FILEtype?
Name
Type
Range
Default
STATE*/

:MMEMory:DISK:FORMat

Syntax :MMEMory:DISK:FORMat
Description Format the local disk ( D disk).

:MMEMory:DISK:INFormation

Description Query the information of the local disk.
Parameter
<Disk> ASCII string D: (or LOCAL) D: (or LOCAL)
Return Format The query returns the information of the local disk, including the disk name, file
system, total space, used space and free space. For example, Disk:D: (or Disk:LOCAL) File Sys:FAT32 Total:1.0 GB Used:512 KB
Example :MMEM:DISK:INF? D: /*The query returns the information of D disk*/

:MMEMory:FILEtype

Syntax :MMEMory:FILEtype ALL|STATe|FLACsv|SWPCsv|TRNCsv
Description Set the file type.
Query the current file type.
Parameter
ALL|STATe|FLACsv|
SWPCsv|TRNCsv
Discrete
Explanation The file types available are all, state, flatness csv, sweep csv and train csv.
After selecting the corresponding file type, you can view all the files of this file
type or save a new file of this file type.
Return Format The query returns ALL, STATE, FLACSV, SWPCSV or TRNCSV.
ALL|STATe|FLACsv|
SWPCsv|TRNCsv
ALL
Example
:MMEM:FILE S TATe /*Set the file type to "State"*/ :MMEM:FILE? /*Query the current file type and the query returns
DSG800 Programming Guide 2-5
Page 26
RIGOL Chapter 2 Command System
space". For example, Used:512 k,Free:1048064 k.
Syntax
:MMEMory:LOAD <file_name>
Name
Type
Range
Default
string
read
name containing the specified path. For example, MMEM:LOAD D:\NEW\2.STA.
path*/
Syntax
:MMEMory:MDIRect or y <di re ct ory_ na me >
Name
Type
Range
Default
created
specified pa th; for example, :MMEM:MDIR D:\1\NEW).
path*/

:MMEMory:LDISk:SPACe

Syntax :MMEMory:LDISk:SPACe?
Description Query the space information of the local disk (D disk).
Return Format
The query returns the D disk sp ace information i ncluding the "Used space" an d "Free

:MMEMory:LOAD

Description Read the specified file in the specified operation path.
Parameter
<file_name>
ASCII
The name of the file to be
Explanation This command is valid only when the specified file exists under the current
operation path or the specified path.
<file_name> can be the name of a file under the current operation path or a file
Example :MMEM:LOAD 2.STA /*Read the file named "2.STA" under the current operation

:MMEMory:MDIRectory

--
Description Create a new folder under the specified operation path.
Parameter
<directory_name> ASCII string
The name of the folder to be
Explanation The folder name can include Chinese characters (a Chinese character occupies
two bytes), English characters or numbers. The folder name cannot exceed 28 bytes.
If the name of the folder to be created already exists, this operation is invalid. At
this point, "The filename already exists" is displayed in the user interface.
<directory_name> can be a new folder name that does not contain the path
(denote creating a folder under the current o peration path) or a folder name that contains the specified path (denote creating a new folder under the
Example :MMEM:MDIR NEW /*Create a folder named "NEW" under the current operation
--
Page 27
Chapter 2 Command System RIGOL
Name
Type
Range
Default
<file_destination>
exists under the current path, the rename operation fails.
Example
:MMEM:MOVE D:\1.STA, D:\2.STA
:MMEMory:PNAMe:EDIT?
Name
Type
Range
Default
<pre_name>
ASCII string
The filename prefix to be edited
--
Command

:MMEMory:MOVE

Syntax :MMEMory:MOVE <file_source>,<file_destination>
Description Rename the file or folder specified by <file_source> as the destination file or folder
name specified by <file_destination>.
Parameter
<file_source>
ASCII string Valid file or folder name --
Explanation The file or folder names s pecified by <file_source> and <file_destination>
must contain the path.
If the file or folder specified by <file_source> does not exist, the rename
operation fails.
If the destination file or folder name specified by <file_destination> already

:MMEMory:PNAMe:EDIT

Syntax :MME Mo r y:P NA Me :ED I T <p re _nam e>
Description Edit and save the filename prefix.
Query the filename prefix saved.
Parameter
Explanation You can edit any filename prefix.
Return Format The query returns the filename prefix. For example, N.
Example :MMEM:PNAM:EDIT N /*Edit the filename pref ix as N*/
:MMEM:PNAM:EDIT? /*The query returns N*/
Related
:MMEMory:PNAMe:STATe
DSG800 Programming Guide 2-7
Page 28
RIGOL Chapter 2 Command System
ON|OFF|1|0
Bool
ON|OFF|1|0
OFF|0
filename input box automatically when saving a file.
Syntax
:MMEMory:SAVe <File_name>
Description
Save the file with the specified filename under the current ope ration path.
Name
Type
Range
Default
command will directly overwrite the original file.
"SET.STA" under the current operation path*/

:MMEMory:PNAMe:STATe

Syntax :MMEMory:PNAMe:STATe ON|OFF|1|0
:MMEMory:PNAMe:STATe?
Description Turn on or off the filename prefix.
Query the current on/off state of the filename prefix.
Parameter
Name Type Range Default
Explanation ON|1: turn on the filename prefix edited.
OFF|0: turn off the filename prefix edited. If the f ilename prefix is turned on, the prefix edited will be added to the
Return Format The query returns 0 or 1.
Example :MMEM:PNAM:STATe ON
:MMEM:PNAM:STAT?
Related
:MMEMory:PNAMe:EDIT
Command

:MMEMory:SAVe

Parameter
<file_name> ASCII string The name of the file to be saved --
Explanation The filename can include Chinese characters (a Chinese character occupies two
bytes), English characters or numbers. The filename cannot exceed 28 bytes.
When the curr ent path already contains a file with the same name, this
Example :MMEM:SAV SET.STA /*Save the current instrument state with the filename
Page 29
Chapter 2 Command System RIGOL
:OUTPut[:STATe]?

:OUTPut Command

Command List:
 :OUTPut

:OUTPut[:STATe]

Syntax :OUTPut[:STATe] ON|OFF|1|0
Description Turn on or off the RF output.
Query the on/off state of the RF output.
Parameter
Explanation
Name Type Range Default
ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0
ON|1: turn on the RF output. At this point, the backlight of RF/on goes on.
OFF|0: turn off the R F output. At this point, the backlight of RF/on goes off.
Return Format The query returns 1 or 0.
Example :OUTP ON /*Turn on the RF output */
:OUTP? /*The query returns 1*/
DSG800 Programming Guide 2-9
Page 30
RIGOL Chapter 2 Command System

:SOURce Commands

The :SOURce commands are used to set the related parameters of the main functions of the RF signal generator including the frequency, level, flatness calibration, AM, FM/ØM, Pulse, SWEEP, LF o utput and so on.
Command List:
[:SOURce]:AM Command Subsystem [:SOURce]:CORRection Command Subsystem [:SOURce]:FM Command Subsystem [:SOURce]:FMPM:TYPE [:SOURce]:FREQuency Command Subsystem [:SOURce]:INPut:TRIGger:SLOPe [:SOURce]:LEVel Command Subsystem [:SOURce]:LFOutput Command Subsystem [:SOURce]:MODulation:STATe [:SOURce]:PM Command Subsystem [:SOURce]:PULM Command Subsystem[:SOURce]:SWEep Command Subsystem

[:SOURce]:AM Command Subsystem

Command List:
[:SOURce]:AM[:DEPTh] [:SOURce]:AM[:DEPTh]:STEP[:INCRement] [:SOURce]:AM:EXT:COUP[:SOURce]:AM:EXT:IMP[:SOURce]:AM:FREQuency[:SOURce]:AM:FREQuency:STEP[:INCRement] [:SOURce]:AM:SOURce[:SOURce]:AM:STATe [:SOURce]:AM:WAVEform
Page 31
Chapter 2 Command System RIGOL
[:SOURce]:AM[:DEPTh]?
<value>
Real
0 to 100
50
a
m
sb
ΔP
asb
mΔP lg206 =
using the [:SOURce]:AM[:DEPTh]:STEP[:INCRement] command.
:AM:DEPT?
Command
Name
Type
Range
Default
modulation depth using the [:SOURce]:AM[:DEPTh] command.
Command
[:SOURce]:AM[:DEPTh]
Syntax [:SOURce]:AM[:DEPTh] <value>
Description Set the AM modulation depth.
Query the AM modulation depth.
Parameter
Explanation
When "Int" modulation source is selected, the AM modulation depth (
Name Type Range Default
amplitude difference ( following relation:
) between the carrier and sidebands satisfy the
.
<value> can also be expressed as percentage. For example, 80%. After the modulation depth is set, you can rotate the knob to modify the
modulation depth at the current step. You can set and query the current step
Return Format The query returns the modulation depth. For example, 80.00.
Example
Related
:AM:DEPT 80
[:SOURce]:AM[:DEPTh]:STEP[:INCRement]
[:SOURce]:AM[:DEPTh]:STEP[:INCRement]
Syntax [:SOURce]:AM[:DEPTh]:STEP[:INCRement] <value>
) and
[:SOURce]:AM[:DEPTh]:STEP[:INCRement]?
Description Set the AM modulation depth step.
Query the AM modulation depth step.
Parameter
<value> Real 0.1 to 50 10
Explanation <value> can also be expressed as percentage. For example, 0.2%.
After the modulation depth step is set, you can rotate the knob to modify the
modulation depth at the current step. At this point, you can query or set the
Return Format The query returns the modulation depth st ep. For example, 0.20.
Example AM:DEPT:STEP:INCR 0.2
AM:DEPT:STEP:INCR?
Related
[:SOURce]:AM[:DEPTh]
DSG800 Programming Guide 2-11
Page 32
RIGOL Chapter 2 Command System
[:SOURce]:AM:EXT:COUP?
Name
Type
Range
Default
AC|DC
Discrete
AC|DC
AC
Return Format
The query returns AC or DC.
:AM:EXT:COUP?
Command
Command
[:SOURce]:AM:EXT:COUP
Syntax [:SOURce]:AM:EXT:COUP AC|DC
Description Set the coupling mode of AM external modulation.
Query the coupling mode of AM external modulation.
Parameter
Explanation AC: set the coupling mode of AM external modulation to "AC".
DC: set the coupling mode of AM external modulation to "DC".
When the modulation source of AM is set to "Int", this command is invalid.
Example :AM:EXT:COUP AC
Related
[:SOURce]:AM:SOURce
[:SOURce]:AM:EXT:IMP
Syntax [:SOURce]:AM:EXT:IMP 50|600|100k
[:SOURce]:AM:EXT:IMP?
Description Set the impedance of AM external modulation.
Query the impedance of AM external modulation.
Parameter
Explanation 50: set the impedance of AM external modulation to "50ohm".
600: set the impedance of AM external modulation to "600ohm". 100k: set the impedance of AM external modulation to "100kohm". When the modulation source of A M is set to "Int", this command is invalid.
Return Format The query returns 50, 600 or 100k.
Example :AM:EXT:IMP 600
Name Type Range Default
50|600|100k Discrete 50|600|100k 100k
Related
:AM:EXT:IMP?
[:SOURce]:AM:SOURce
Page 33
Chapter 2 Command System RIGOL
[:SOURce]:AM:FREQuency?
Name
Type
Range
Default
(Square)
When the modulation source of AM is set to "Ext", this command is invalid.
:AM:FREQ?
[:SOURce]:AM:SOURce
[:SOURce]:AM:FREQuency:STEP[:INCRement]?
Name
Type
Range
Default
the modulation frequency using the [:SOURce]:AM:FREQuency command.
:AM:FREQ:STEP?
Command
[:SOURce]:AM:FREQuency
Syntax [:SOURce] :AM :F RE Que n cy < value>
Description Set the AM modulation frequency.
Query the AM modulation frequency.
Parameter
<value> Real
10Hz to 100kHz (Sine)/10Hz to 20kHz
Explanation When <value> is set in "Number" form, the default unit is Hz; for example,
20000. In addition, <value> can a lso be set in "Number + Unit" form; for example, 20kHz.
After the modulation frequency is set, you can rotate the knob to modify the
modulation frequency at the current step. You can set and query the current step using the
[:SOURce]:AM:FREQuency:STEP[:INCRement] command.
Return Format The query returns the AM modulation frequency. For example, 20.00000kHz.
Example
Related
:AM:FREQ 20kHz
[:SOURce]:AM:FREQuency:STEP[:INCRement]
Commands
[:SOURce]:AM:FREQuency:STEP[:INCRement]
Syntax [:SOURce]:AM:FREQuency:STEP[:INCRement] <value>
10kHz
Description Set the AM modulation frequency step.
Query the AM modulation frequency step.
Parameter
<value> Real 1Hz to 50kHz 1kHz
Explanation When <value> is set in "Number" form, the default unit is Hz. In addition,
<value> can also be set in "Number + Unit" form; for example, 3.55kHz.
After the modulation frequency step is set, you can rotate the knob to modify
the modulation frequency at the current step. At this point, you can query or set
Return Format The query returns the AM modulation frequency step. For example, 3.55000kHz.
Example
Related
:AM:FREQ:STEP 3.55kHz
[:SOURce]:AM:FREQuency
DSG800 Programming Guide 2-13
Page 34
RIGOL Chapter 2 Command System
[:SOURce]:AM:SOURce?
Name
Type
Range
Default
modulation waveform of the modulating signal.
[:SOURce]:AM:WAVEform
[:SOURce]:AM:STATe?
[:SOURce]:AM:SOURce
Syntax [:SOURce]:AM:SOURce EXTernal|INTernal
Description Set the AM modulation source.
Query the AM modulation source.
Parameter
EXTernal|INTernal Discrete EXTernal|INTernal INTernal
Explanation EXTernal: set the modulation source to "Ext". At this point, the external
modulating signal is input from the [EXT MOD IN] connector.
INTernal: set the modulation source to "Int". At this point, the instrument
provides the modulati ng signal and you can set the modulation frequency and
Return Format The query returns the AM modulation source. For example, EXT.
Example :AM:SOUR EXT
:AM:SOUR?
Related
[:SOURce]:AM:FREQuency
Commands
[:SOURce]:AM:STATe
Syntax [:SOURce]:AM:STATe ON|OFF|1|0
Description Set the state of the AM switch.
Query the state of the AM switch.
Parameter
Explanation ON|1: turn on the AM switch to enable the AM function.
OFF|0: turn off the AM switch to disable the AM function.
Return Format The query returns 1 or 0.
Example :AM:STAT ON /*Turn on the AM switch*/
:AM:STAT? /*The query returns 1*/
Name Type Range Default
ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0
Page 35
Chapter 2 Command System RIGOL
[:SOURce]:AM:WAVEform?
Name
Type
Range
Default
:AM:WAVE?
Command
[:SOURce]:AM:WAVEform
Syntax [:SOURce]:AM:WAVEform SINE|SQUA
Description Set the AM modulation waveform.
Query the AM modulation waveform.
Parameter
SINE|SQUA Discrete SINE|SQUA SINE
Explanation SINE: set the AM modulation waveform to "Sine".
SQUA: set the AM modulation waveform to "Square". When the modulation source of AM is set to "Ext", this command is invalid.
Return Format The query returns SINE or SQUA.
Example
Related
:AM:WAVE SQUA
[:SOURce]:AM:SOURce
DSG800 Programming Guide 2-15
Page 36
RIGOL Chapter 2 Command System
example, 5.
Syntax
[:SOURce]:CORRection:FLATness:LIST? <Start>,<Count>
Name
Type
Range
Default
<Count>
Integer
1 to the total number of rows in the current list
--
from the 2nd row of the flatness calibration list*/
Command

[:SOURce]:CORRection Command Subsystem

Command List:
[:SOURce]:CORRection:FLATness:COUNt[:SOURce]:CORRection:FLATness:LIST[:SOURce]:CORRection:FLATness[:STATe]
[:SOURce]:CORRection:FLATness:COUNt
Syntax [:SOURce]:CORRection:FLATness:COUNt?
Description Query the number of points in the current flatness calibration list.
Return Format
The query returns the number of points in the flatness calibration list in integer. For
[:SOURce]:CORRection:FLATness:LIST
Description Query the flatness calibration list data within the specified range.
Parameter
<Start> Integer 1 to the total number of rows in the current list --
Explanation <Start>: the number of the start row of the data to be acquired.
<Count>: the total number of rows of the data to be acquired.
Return Format The query returns the flatness calibration list data acquired. For example,
NO.1:3040000 00. 00 00 00 , 7.4 50000 NO.2:8000000 00. 00 00 00 , -17.799999
Example
:CORR:FLAT:LIST? 2,2 /*Query and return two rows of calibration data starting
Related
[:SOURce]:CORRection:FLATness:COUNt
Page 37
Chapter 2 Command System RIGOL
[:SOURce]:CORRection:FLATness[:STATe]?
ON|OFF|1|0
Bool
ON|OFF|1|0
OFF|0
[:SOURce]:CORRection:FLATness[:STATe]
Syntax [:SOURce]:CORRection:FLATness[:STATe] ON|OFF|1|0
Description Turn on or off the flatness calibration switch.
Query the state of the flatness calibration switch.
Parameter
Name Type Range Default
Explanation ON|1: turn on the flatness calibration switch.
OFF|0: turn off the flatness calibration switch.
Return Format The query returns 1 or 0.
Example :CORR:FLAT ON /*Turn on the flatness calibration switch*/
:CORR:FLAT? /*The query returns 1*/
DSG800 Programming Guide 2-17
Page 38
RIGOL Chapter 2 Command System
[:SOURce]:FM[:DEViation]?
Name
Type
Range
Default
1MHz
[:SOURce]:FM[:DEViation]:STEP[:INCRement] command.
Return Format
The query returns the FM frequency deviation. For example, 20.00000kHz.
:FM:DEV?
Command

[:SOURce]:FM Command Subsystem

Command List:
[:SOURce]:FM[:DEViation] [:SOURce]:FM[:DEViation]:STEP[:INCRement] [:SOURce]:FM:EXT:COUP [:SOURce]:FM:EXT:IMP [:SOURce]:FM:FREQuency[:SOURce]:FM:FREQuency:STEP[:INCRement][:SOURce]:FM:SOURce[:SOURce]:FM:STATe [:SOURce]:FM:WAVEform
[:SOURce]:FM[:DEViation]
Syntax [:SOURce]:FM[:DEViation] <value>
Description Set the FM frequency deviation.
Query the FM frequency deviation.
Parameter
<value> Real
100mHz to
10kHz
Explanation When <value> is set in "Number" form, the default unit is Hz; for example,
20000. In addition, <value> can a lso be set in "Number + Unit" form; for example, 20kHz.
After the frequency deviation is set, you can rotate the knob to modify the
deviation at the current step. You can set and query the current step using the
Example :FM:DEV 20kHz
Related
[:SOURce]:FM[:DEViation]:STEP[:INCRement]
Page 39
Chapter 2 Command System RIGOL
[:SOURce]:FM[:DEViation]:STEP[:INCRement]?
Name
Type
Range
Default
frequency deviation using t he [:SOURce]:FM[:DEViation] command.
:FM:STEP:INCR?
Command
[:SOURce]:FM:EXT:COUP?
Name
Type
Range
Default
Command
[:SOURce]:FM[:DEViation]:STEP[:INCRement]
Syntax [:SOURce]:FM[:DEViation]:STEP[:INCRement] <value>
Description Set the FM frequency deviation step.
Query the FM frequency deviation step.
Parameter
<value> Real 10mHz to 500kHz 1kHz
Explanation When <value> is set in "Number" form, the default unit is Hz; for example,
5000. In addition, <value> can also be set in "Number + Unit" form; for example, 5kHz.
After the frequency deviation step is set, you can rotate th e kn ob to modif y the
deviation at the current step. At this point, You can query or set the current
Return Format The query returns the FM frequency deviation step. For example, 5.00000kHz.
Example
Related
:FM:STEP:INCR 5kHz
[:SOURce]:FM[:DEViation]
[:SOURce]:FM:EXT:COUP
Syntax [:SOURce]:FM:EXT:COUP AC|DC
Description Set the coupling mode of FM external modulation.
Query the coupling mode of FM external modulation.
Parameter
Explanation AC: set the coupling mode of FM external modulation to "AC".
DC: set the coupling mode of FM external modulation to "DC". When the modulation source of FM is set to "Int", this command is invalid.
Return Format The query returns AC or DC.
AC|DC Discrete AC|DC AC
Example :FM:EXT:COUP AC
:FM:EXT:COUP?
Related
[:SOURce]:FM:SOURce
DSG800 Programming Guide 2-19
Page 40
RIGOL Chapter 2 Command System
[:SOURce]:FM:EXT:IMP?
Name
Type
Range
Default
50|600|100k
Discrete
50|600|100k
100k
Return Format
The query returns 50, 600 or 100k.
:FM:EXT:IMP?
Command
[:SOURce]:FM:FREQuency?
Name
Type
Range
Default
(Square)
When the modulation source of FM is set to "Ext", this command is invalid.
Return Format
The query returns the FM modulation frequency. For example, 20.00000kHz.
:FM:FREQ?
[:SOURce]:FM:SOURce
[:SOURce]:FM:EXT:IMP
Syntax [:SOURce]:FM:EXT:IMP 50|600|100k
Description Set the impedance of FM external modulation.
Query the impedance of FM external modulation.
Parameter
Explanation 50: set the impedance of FM external modulation to "50ohm".
600: set the impedance of FM external modulation to "600ohm". 100k: set the impedance of FM external modulation to "100 kohm". When the modulation source of FM is set to "Int", this command is invalid.
Example :FM:EXT:IMP 600
Related
[:SOURce]:FM:SOURce
[:SOURce]:FM:FREQuency
Syntax [:SOURce]:FM:FREQuency < value>
Description Set the FM modulation frequency.
Query the FM modulation frequency.
Parameter
<value> Real
Explanation When <value> is set in "Number" form, the default unit is Hz; for example,
20000. In addition, <value> can also be set in "Number + Unit" form; for example, 20kHz.
After the modulation frequency is set, you can rotate the knob to modify the
modulation frequency at the current step. At this point, you can set and query the current step using the command.
10Hz to 100kHz (Sine)/10Hz to 20kHz
[:SOURce]:FM:FREQuency:STEP[:INCRement]
10kHz
Example :FM:FREQ 20kHz
Related
[:SOURce]:FM:FREQuency:STEP[:INCRement]
Commands
Page 41
Chapter 2 Command System RIGOL
[:SOURce]:FM:FREQuency:STEP[:INCRement]?
Name
Type
Range
Default
the modulation frequency using the [:SOURce]:FM:FREQuency command.
:FM:FREQ:STEP?
Command
[:SOURce]:FM:SOURce?
Name
Type
Range
Default
EXTernal|INTernal
Discrete
EXTernal|INTernal
INTernal
modulation waveform of the modulating signal.
Return Format
The query returns the FM modulation source. For example, INT.
:FM:SOUR?
[:SOURce]:FM:WAVEform
[:SOURce]:FM:FREQuency:STEP[:INCRement]
Syntax [ :SOUR ce ]:FM :FR EQ ue nc y: STEP [:I NCReme nt] < value>
Description Set the FM modulation frequency step.
Query the FM modulation frequency step.
Parameter
<value> Real 1Hz to 50kHz 1kHz
Explanation When <value> is set in "Number" form, the default unit is Hz; for example,
5000. In addition, <value> can also be set in "Number + Unit" form; for example, 5kHz.
After the modulation frequency step is set, you can rotate the knob to modify
the modulation frequency at the current step. At this point, you can query or set
Return Format The query returns the FM modulation frequency step. For example, 5.00000kHz.
Example
Related
:FM:FREQ:STEP 5kHz
[:SOURce]:FM:FREQuency
[:SOURce]:FM:SOURce
Syntax [:SOURce]:FM:SOURce EXTernal|INTernal
Description Set the FM modulation source.
Query the FM modulation source.
Parameter
Explanation EXTernal: set the modulation source to "Ext". At this point, the external
modulating signal is input from the [EXT MOD IN] connector.
INTernal: set the modulation source to "Int". At this point, the instrument
provides the modulati ng signal and you can set the modulation frequency and
Example :FM:SOUR INT
Related
Commands
[:SOURce]:FM:FREQuency
DSG800 Programming Guide 2-21
Page 42
RIGOL Chapter 2 Command System
[:SOURce]:FM:STATe?
Name
Type
Range
Default
ON|OFF|1|0
Bool
ON|OFF|1|0
OFF|0
Name
Type
Range
Default
:FM:WAVE?
Command
[:SOURce]:FM:STATe
Syntax [:SOURce]:FM:STATe ON|OFF|1|0
Description Set the state of the FM switch.
Query the state of the FM switch.
Parameter
Explanation ON|1: turn on the FM switch to enable the FM function.
OFF|0: turn off the FM switch to disa ble the FM function.
Return Format The query returns 1 or 0.
Example :FM:STAT ON /*Turn on the FM switch*/
:FM:STAT? /*The query re turns 1*/
[:SOURce]:FM:WAVEform
Syntax [:SOURce]:FM:WAVEform SINE | SQ UA
[:SOURce]:FM:WAVEform?
Description Set the FM modulation waveform.
Query the FM modulation waveform.
Parameter
SINE|SQUA Discrete SINE|SQUA SINE
Explanation SINE: set t he FM modulation waveform to "Sine".
SQUA: set the FM modulation waveform to "Square". When the modulation source of FM is set to "Ext", this command is invalid.
Return Format The query returns SINE or SQUA.
Example
Related
:FM:WAVE SQUA
[:SOURce]:FM:SOURce
Page 43
Chapter 2 Command System RIGOL
[:SOURce]:FMPM:TYPE?
Name
Type
Range
Default
Return Format
The query returns FM or PM.
:FMPM:TYPE?

[:SOURce]:FMPM:TYPE

Syntax [:SOURce]:FMPM:TYPE FM|PM
Description Set the current modulation type to FM or ØM.
Query the current modulation type.
Parameter
FM|PM Discrete FM|PM PM
Explanation FM: set the current modulation type to "FM".
PM: set the curr ent modulation type to "ØM".
Example :FMPM:TYPE FM
DSG800 Programming Guide 2-23
Page 44
RIGOL Chapter 2 Command System
Name
Type
Range
Default
the [:SOURce]:FREQuency:STEP command.
Command

[:SOURce]:FREQuency Command Subsystem

Command List:
 [:SOURce]:FREQuency  [:SOURce]:FREQuency:STEP
[:SOURce]:FREQuency
Syntax [:SOURce]:FREQuency <value>
[:SOURce]:FREQuency?
Description Set the frequency of the RF signal.
Query the frequenc y of the RF signal.
Parameter
<value> Real 9kHz to 3GHz 3GHz
Explanation When <value> is set in "Number" form, the default unit is Hz; for example,
4000000. In addition, <value> can also be set in "Number + Unit" form; for example, 4MHz.
After the RF frequency is set, you can rotate the knob to modify the frequency
at the current step. At this point, you can set and query the current step using
Return Format The query returns the frequency of the RF signal. For example, 4.00000000MHz.
Example :FREQ 4MHz
:FREQ?
Related
[:SOURce]:FREQuency:STEP
Page 45
Chapter 2 Command System RIGOL
[:SOURce]:FREQuency:STEP?
<value>
Real
10mHz to 1GHz
100MHz
using the [:SOURce]:FREQuency command.
Return Format
The query returns the RF frequency step. For example, 3.00000kHz.
Command
rear panel.
[:SOURce]:FREQuency:STEP
Syntax [:SOURce]:FREQuency:STEP <value>
Description Set the RF frequency step.
Query the RF frequency step.
Parameter
Name Type Range Default
Explanation When <value> is set in "Number" form, the default unit is Hz; for example,
3000. In addition, <value> can also be set in "Number + Unit" form; for example, 3kHz.
After the RF frequency step is set, you can rotate the knob to modify the
frequency at the current step. At this point, you can query or set the frequency
Example :FREQ:STEP 3kHz
:FREQ:STEP?
Related
[:SOURce]:FREQuency

[:SOURce]:INPut:TRIGger:SLOPe

Syntax [:SOURce]:INPut:TRIGger:SLOPe POSitive|NEGative
[:SOURce]:INPut:TRIGger:SLOPe?
Description Set the polarity of the external trigger input signal.
Query the polarity of the external trigger input signal.
Parameter
Explanation
This command is valid only when the trigger mode of SWEEP is set to "Ext".
Name Type Range Default
POSitive|NEGative Discrete POSitive|NEGative POSitive
The external trigger signal is input from the [TRIGGER IN] connector at the
Return Format The query returns POS or NEG.
Example :INP:TRIG:SLOP POS
:INP:TRIG:SLOP?
DSG800 Programming Guide 2-25
Page 46
RIGOL Chapter 2 Command System
Name
Type
Range
Default
step using the [:SOURce]:LEVel:STEP command.

[:SOURce]:LEVel Command Subsystem

Command List:
 [:SOURce]:LEVel  [:SOURce]:LEVel:STEP
[:SOURce]:LEVel
Syntax [:SOURce]:LEVel <value>
[:SOURce]:LEVel?
Description Set the RF output amplitude.
Query the RF output amplitude.
Parameter
<value> Real -110dBm to 20dBm -110dBm
Explanation When <value> is set in "Number" form (for example, 2), the default unit is
dBm. In addition, <value> can also be set in "Number + Unit" form (for example, 2dBm); at this point, the amplitude displayed in the RF signal generator interface is related to the setting of 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 uni t of the return value is dBm. After the RF output amplitude is set, you can rotate the knob to modify the
amplitude at the current s tep. At this point, you can set and query the current
Return Format The query returns the RF output amplitude. For example, 2.00.
Example :LEV 2dBm /*Set the amplitude of the RF signal to 2dBm*/
:LEV? /*Query the amplitude of the RF sig nal and the query returns 2.00*/
Related
[:SOURce]:LEVel:STEP
Command
Page 47
Chapter 2 Command System RIGOL
[:SOURce]:LEVel:STEP?
<value>
Real
0.01dB to 100dB
10dB
output amplitude us ing the [:SOURce]:LEVel command.
:LEV:STEP?
Command
[:SOURce]:LEVel:STEP
Syntax [:SOURce]:LEVel:STEP <value>
Description Set the RF output amplit ude step.
Query the RF outp ut amplitude step.
Parameter
Name Type Range Default
Explanation When <value> is set in "Number" form, the def ault unit is dB. Besides, <value>
can also be set in "Number + Unit" form; for example, 20dB.
The default uni t of the return value is dB. After the output amplitude step is set, you can rotate the knob to modify the
output amplitude at the current step. At this point, you can query or set the
Return Format The query returns the RF output amplitude step. For example, 20.00.
Example
Related
:LEV:STEP 20
[:SOURce]:LEVel
DSG800 Programming Guide 2-27
Page 48
RIGOL Chapter 2 Command System
Name
Type
Range
Default
:LFO:FREQ?
[:SOURce]:LFOutput:LEVel?
Name
Type
Range
Default
<value>
Real
0V to 3V
500mV
:LFO:LEV?

[:SOURce]:LFOutput Command Subsystem

Command List:
[:SOURce]:LFOutput:FREQuency[:SOURce]:LFOutput:LEVel [:SOURce]:LFOutput:SHAPe [:SOURce]:LFOutput[:STATe]
[:SOURce]:LFOutput:FREQuency
Syntax [:SOURce]:LFOutput:FREQuency <value>
[:SOURce]:LFOutput:FREQuency?
Description Set the frequency of the LF output signal.
Query the frequenc y of the LF output sig nal.
Parameter
<value> Real 0Hz to 200kHz (Sine)/ 0Hz to 20kHz (Square) 1kHz
Explanation When <value> is set in "Number" form, the default unit is Hz. Besides, <value> can
also be set in "Number + Unit" form; for example, 2kHz.
Return Format The query returns the frequency of the LF output signal. For example, 2.00000kHz.
Example
:LFO:FREQ 2kHz
[:SOURce]:LFOutput:LEVel
Syntax [:SOURce]:LFOutput:LEVel <value>
Description Set the amplitude of the LF output signal.
Query the amplit ude of the LF output signal.
Parameter
Explanation When <value> is set in "Number" form, the default unit is V. Besides, <value>
can also be set in "Number + Unit" form; for example, 2V.
The default uni t of the return value is V.
Return Format The query returns the amplitude of the LF output signal. For example, 2.00.
Example
:LFO:LEV 2
Page 49
Chapter 2 Command System RIGOL
[:SOURce]:LFOutput:SHAPe?
Name
Type
Range
Default
SINE|SQUare
Discrete
SINE|SQUare
SINE
:LFO:SHAP?
[:SOURce]:LFOutput[:STATe]?
Name
Type
Range
Default
[:SOURce]:LFOutput:SHAPe
Syntax [:SOURce]:LFOutput:SHAPe SINE|SQUare
Description Set the waveform of the LF output signal.
Query the waveform of the LF output signal.
Parameter
Explanation SINE: set the waveform of the LF output signal to "Sine".
SQUare: set the waveform of the LF output signal to "Square".
Return Format The query returns SINE|SQU.
Example
:LFO:SHAP SINE
[:SOURce]:LFOutput[:STATe]
Syntax [:SOURce]:LFOutput[:STATe] ON|OFF|1|0
Description Turn on or off the LF output switch.
Query the state of the LF output switch.
Parameter
ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0
Explanation ON|1: turn on the LF output switch.
OFF|0: turn off the LF output switch.
Return Format The query returns 1 or 0.
Example :LFO:STAT ON /*Turn on the LF output switch*/
:LFO:STAT? /*The query returns 1*/
DSG800 Programming Guide 2-29
Page 50
RIGOL Chapter 2 Command System
[:SOURce]:MODulation:STATe?
Name
Type
Range
Default
ON|OFF|1|0
Bool
ON|OFF|1|0
OFF|0
OFF|0: turn off all the modulation outputs. The backlight of Mod/on goes off.

[:SOURce]:MODulation:STATe

Syntax [:SOURce]:MODulation:STATe ON|OFF|1|0
Description Turn on or off the switch of all the modulation outputs.
Query the on/off state of the switch of all the modulation outputs.
Parameter
Explanation
ON|1: turn on all the modulati on outputs. The backlig ht of Mod/on g oes on.
Return Format The query returns 1 or 0.
Example :MOD:STAT ON /*Turn on the switch of all the modulation outputs*/
:MOD:STAT? /*The query returns 1*/
Page 51
Chapter 2 Command System RIGOL
Name
Type
Range
Default
step using the [:SOURce]:PM[:DEViation]:STEP[:INCRement] command.
:PM:DEV?
Command

[:SOURce]:PM Command Subsystem

Command List:
[:SOURce]:PM[:DEViation] [:SOURce]:PM[:DEViation]:STEP[:INCRement] [:SOURce]:PM:EXT:COUP [:SOURce]:PM:EXT:IMP [:SOURce]:PM:FREQuency[:SOURce]:PM:FREQuency:STEP[:INCRement] [:SOURce]:PM:SOURce [:SOURce]:PM:STATe [:SOURce]:PM:WAVEform
[:SOURce]:PM[:DEViation]
Syntax [:SOURce]:PM[:DEViation] <value>
[:SOURce]:PM[:DEViation]?
Description Set the phase deviation of ØM.
Query the phase deviation of ØM.
Parameter
<value> Real 0rad to 5rad 5rad
Explanation When <value> is set in "Number" form, the default unit is rad. Besides,
<value> can also be set in "Number + Unit" form; for example, 2rad.
The default unit of the return value is rad.
After the phase deviation is set, you can rotate the knob to modify the phase
deviation at the current step. At this point, you can query and set the current
Return Format The query returns the phase deviation of ØM. For example, 2.000000.
Example
Related
:PM:DEV 2
[:SOURce]:PM[:DEViation]:STEP[:INCRement]
DSG800 Programming Guide 2-31
Page 52
RIGOL Chapter 2 Command System
[:SOURce]:PM[:DEViation]:STEP[:INCRement]?
Name
Type
Range
Default
<value>
Real
0.01rad to 2.5rad
1rad
phase deviation using the [:SOURce]:PM[:DEViation] command.
AC|DC
Discrete
AC|DC
AC
:PM:EXT:COUP?
Command
[:SOURce]:PM[:DEViation]:STEP[:INCRement]
Syntax [:SOURce]:PM[:DEViation]:STEP[:INCRement] <value>
Description Set the phase deviation step of ØM.
Query the phase deviation step of ØM.
Parameter
Explanation When <value> is set in "Number" form, the default unit is rad. Besides,
<value> can also be set in "Number + Unit" form; for example, 1rad.
The default uni t of the return value is rad. After the phase deviation step is set, you can rotate the knob to modify the
phase deviation at the current step. At this point, you can query or set the
Return Format The query returns the phase deviation step. For example, 1.000000.
Example :PM:DEV:STEP 1
:PM:DEV:STEP?
Related
[:SOURce]:PM[:DEViation]
Command
[:SOURce]:PM:EXT:COUP
Syntax [:SOURce]:PM:EXT:COUP AC|DC
[:SOURce]:PM:EXT:COUP?
Description Set the coupling mode of ØM external modulation.
Query the coupling mode of ØM external modulation.
Parameter
Explanation AC: set the coupling mode of ØM external modulation to "AC".
DC: set the coupling mode of ØM external modulat i on to "DC". When the modulation source of ØM is set to "Int", this command is invalid.
Return Format The query returns AC or DC.
Example
:PM:EXT:COUP AC
Name Type Range Default
Related
[:SOURce]:PM:SOURce
Page 53
Chapter 2 Command System RIGOL
[:SOURce]:PM:EXT:IMP?
Return Format
The query returns 50, 600 or 100k.
:PM:EXT:IMP?
Command
Name
Type
Range
Default
(Square)
This command is invalid when the ØM mod ulation source is set to "Ext".
:PM:FREQ?
[:SOURce]:PM:SOURce
[:SOURce]:PM:EXT:IMP
Syntax [:SOURce]:PM:EXT:IMP 50|600|100k
Description Set the impedance of ØM external modulation.
Query the impedance of ØM external modulation.
Parameter
Name Type Range Default
50|600|100k Discrete 50|600|100k 100k
Explanation 50: set the impedance of ØM external modulation to "50ohm".
600: set the impedance of ØM external modulation to "600ohm". 100k: set the impedance of ØM external modulation to "100kohm". When the modulation source of ØM is set to "Int", this command is invalid.
Example :PM:EXT:IMP 600
Related
[:SOURce]:PM:SOURce
[:SOURce]:PM:FREQuency
Syntax [:SOURce]:PM:FREQuency <value>
[:SOURce]:PM:FREQuency?
Description Set the modulation frequency of ØM.
Query the modulation frequency of ØM.
Parameter
<value> Real
10Hz to 100kHz (Sine)/10Hz to 20kHz
Explanation When <value> is set in "Number" form, the default unit is Hz. Besides, <value>
can also be set in "Number + Unit" form; for example, 20kHz.
After the modulation frequency is set, you can rotate the knob to modify the
modulation frequency at the current step. At this point, you can query or set the current step using the
[:SOURce]:PM:FREQuency:STEP[:INCRement]
command.
Return Format The query returns the ØM mod ulation frequency. For example, 20.00000kHz.
Example
Related
:PM:FREQ 20kHz
[:SOURce]:PM:FREQuency:STEP[:INCRement]
Commands
10kHz
DSG800 Programming Guide 2-33
Page 54
RIGOL Chapter 2 Command System
[:SOURce]:PM:FREQuency:STEP[:INCRement]?
Name
Type
Range
Default
the modulation freq uency using the [:SOURce]:PM:FREQuency command.
:PM:FREQ:STEP?
Command
[:SOURce]:PM:SOURce?
EXTernal|INTernal
Discrete
EXTernal|INTernal
INTernal
modulation waveform of the modulating signal.
:PM:SOUR?
[:SOURce]:PM:WAVEform
[:SOURce]:PM:FREQuency:STEP[:INCRement]
Syntax [:SOURce]:PM:FREQuency:STEP[:INCRement] <value>
Description Set the modulation frequency step of ØM.
Query the modulation frequency step of ØM.
Parameter
<value> Real 1Hz to 50kHz 1kHz
Explanation When <value> is set in "Number" form, the default unit is Hz. Besides, <value>
can also be set in "Number + Unit" form; for example, 5kHz.
After the modulation frequency step is set, you can rot ate the knob to modify
the modulation frequency at the current step. At this point, you can query or set
Return Format The query returns the modulation frequency step of ØM. For example, 5.00000kHz.
Example
Related
:PM:FREQ:STEP 5kHz
[:SOURce]:PM:FREQuency
[:SOURce]:PM:SOURce
Syntax [:SOURce]:PM:SOURce EXTernal|INTernal
Description Set the ØM modulation source.
Query the ØM modulation source.
Parameter
Name Type Range Default
Explanation EXTernal: select "Ext" modulation source. At this point, the external modulating
signal is input from the [EXT MOD IN] connector.
INTernal: select "Int" modulation source. At this point, the instrument provides
the modulating signal and you can set the modulation frequency and
Return Format The query returns the ØM modulation source. For example, INT.
Example
Related
Commands
:PM:SOUR INT
[:SOURce]:PM:FREQuency
Page 55
Chapter 2 Command System RIGOL
[:SOURce]:PM:STATe?
Name
Type
Range
Default
ON|OFF|1|0
Bool
ON|OFF|1|0
OFF|0
[:SOURce]:PM:WAVEform?
Name
Type
Range
Default
SINE|SQUA
Discrete
SINE|SQUA
SINE
:PM:WAVE?
Command
[:SOURce]:PM:STATe
Syntax [:SOURce]:PM:STATe ON|OFF|1|0
Description Turn on or off the ØM switch.
Query the state of the ØM switch.
Parameter
Explanation ON|1: turn on the ØM switch and enable the ØM function.
OFF|0: turn off the ØM switch and disable the ØM function.
Return Format The query returns 1 or 0.
Example :PM:STAT ON /*Turn on the ØM switch*/
:PM:STAT? /*The query returns 1*/
[:SOURce]:PM:WAVEform
Syntax [:SOURce]:PM:WAVEform SINE|SQUA
Description Set the modulation waveform of ØM.
Query the modulation waveform of ØM.
Parameter
Explanation SINE: set the m odulation waveform of ØM to "Sine".
SQUA: set the modulation waveform of ØM to "Square". This command is invalid when the ØM mod ulation source is set to "Ext".
Return Format The query returns SINE or SQUA.
Example
Related
:PM:WAVE SQUA
[:SOURce]:PM:SOURce
DSG800 Programming Guide 2-35
Page 56
RIGOL Chapter 2 Command System
Name
Type
Range
Default
When "Ext" modulation source is selected, this command is invalid.
:PULM:MODE?
Command

[:SOURce]:PULM Command Subsystem

Command List
[:SOURce]:PULM:MODE[:SOURce]:PULM:OUT:STATe[:SOURce]:PULM:PERiod[:SOURce]:PULM:PERiod:STEP[:SOURce]:PULM:POLarity[:SOURce]:PULM:SOURce [:SOURce]:PULM:STATe[:SOURce]:PULM:TRAin:LIST:COUNt[:SOURce]:PULM:TRAin:LIST:GET[:SOURce]:PULM:TRIGger:DELay[:SOURce]:PULM:TRIGger:DELay:STEP[:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity
[3]
:
[:SOURce]:PULM:TRIGger:EXTernal:SLOPe [:SOURce]:PULM:TRIGger:MODE[:SOURce]:PULM:WIDTh[:SOURce]:PULM:WIDTh:STEP
[:SOURce]:PULM:MODE
Syntax [:SOURce]:PULM:MODE SINGle|TRAin
[:SOURce]:PULM:MODE?
Description Set the pulse modulation mode.
Query the pulse modulation mode.
Parameter
SINGle|TRAin Discrete SINGle|TRAin SINGle
Explanation SINGle: set the pulse type to "single " a nd enable the single pulse modulation
mode.
TRAIn: set the pulse type to "Train" and enable the train pulse modulation
mode.
Return Format The query returns SINGLE or TRAIN.
Example
Related
[3]
Note
DSG800-PUM option; to use the related commands of "Train", you need to install the DSG800-PUG option; otherwise, the command settings are invalid. For the installation methods of the option, refer to
: To use the commands related to "Pulse Modulation" and "Pulse Generator", you need to install the
:PULM:MODE SING
[:SOURce]:PULM:SOURce
DSG800 User's Guide
.
Page 57
Chapter 2 Command System RIGOL
[:SOURce]:PULM:OUT:STATe?
Name
Type
Range
Default
When "Ext" modulation source is selected, this command is invalid.
[:SOURce]:PULM:SOURce
[:SOURce]:PULM:PERiod?
<value>
Real
40ns to 170s
1ms
this command is invalid.
:PULM:PER?
[:SOURce]:PULM:OUT:STATe
Syntax [:SOURce]:PULM:OUT:STATe ON|OFF|0|1
Description Turn on or off the pulse output switch.
Query the state of the pulse output switch.
Parameter
ON|OFF|0|1 Bool ON|OFF|0|1 OFF|0
Explanation ON|1: turn on the pulse output switch. At this point, the RF signal generator can
output the pulse signal generated by the i nternal pulse generator from the [PULSE IN/OUT] connector at the rear panel. Note that t his output signal is related to the pulse "Mode" setting.
OFF|0: turn off the pulse output swit ch.
Return Format The query returns 1 or 0.
Example :PULM:OUT:STAT ON /*Turn on the pulse output switch*/
:PULM:O UT: STAT ? / *The query returns 1*/
Related
[:SOURce]:PULM:MODE
Commands
[:SOURce]:PULM:PERiod
Syntax [:SOURce]:PULM:PERiod <value>
Description Set the period of pulse modulation.
Query the period of pulse modulation.
Parameter
Explanation When <value> is set in "Number" form, the default unit is s. Besides, <value>
After the pulse period is set, you can rotate the knob to modify the period at the
When the modulation source is set to "Ext" or the pul se mode is set to "Train",
Name Type Range Default
can also be set in "Number + Unit" form; for example, 1000ms.
current step. At this poi nt, you can query and set the current step using the
[:SOURce]:PULM:PERiod:STEP command.
Return Format The query returns the period of pulse modulation. For example, 1.000000000s.
Example
Related
Commands
:PULM:PER 1000ms
[:SOURce]:PULM:PERiod:STEP [:SOURce]:PULM:SOURce [:SOURce]:PULM:MODE
DSG800 Programming Guide 2-37
Page 58
RIGOL Chapter 2 Command System
[:SOURce]:PULM:PERiod:STEP?
Name
Type
Range
Default
<value>
Real
10ns to 10s
100us
[:SOURce]:PULM:PERiod command.
:PULM:PER:STEP?
Command
[:SOURce]:PULM:POLarity?
Name
Type
Range
Default
:PULM:POL?
[:SOURce]:PULM:PERiod:STEP
Syntax [:SOURce]:PULM:PERiod:STEP <value>
Description Set the step of the pulse modulation period.
Query the step of the pulse modulation period.
Parameter
Explanation When <value> is set in "Number" form, the default unit is s. Besides, <value>
can also be set in "Number + Unit" form; for example, 5000ms.
After the pulse period step is set, you can rotate th e knob to modify the period at
the current step. At this point, you can query and set the pulse period using the
Return Format The query returns the step of the pulse modulation period. For example,
5.000000000s.
Example
Related
:PULM:PER:STEP 5000ms
[:SOURce]:PULM:PERiod
[:SOURce]:PULM:POLarity
Syntax [:SOURce]:PULM:POLarity NORMal|INVerse
Description Set the polarity of pulse modulation.
Query the polarity of pulse modulation.
Parameter
NORMal|INVerse Discrete NORMal|INVerse NORMal
Explanation NORMal: set the polarity of the current pulse modulating signal to "Normal".
INVerse: set the polarity of the current pulse modulating signal to "Inverse".
Return Format The query returns NORMAL or INVERSE.
Example
:PULM:POL INV
Page 59
Chapter 2 Command System RIGOL
[:SOURce]:PULM:SOURce?
Name
Type
Range
Default
INTernal|EXTernal
Discrete
INTernal|EXTernal
INTernal
connector at the rear panel.
:PULM:SOUR?
Command
function.
1*/
example, 2.
[:SOURce]:PULM:SOURce
Syntax [:SOURce]:PULM:SOURce INTernal|EXTernal
Description Set the pulse modulation source.
Query the pulse modulation source.
Parameter
Explanation INTernal: select "Int" modulation source. At this point, the internal pulse
generator of the instrument provides the modulating signal. When the "Pulse Out" is turned on, the RF signal generator can output the pulse signal generated by the internal pulse generator from the [PULSE IN/OUT] connector at the rear panel.
EXTernal: select "Ext" modulation source. At this point, the RF signal generator
receives the external pulse modulating signal input from the [PULSE IN/OUT]
Return Format The query returns the pulse modulation source (INT or EXT).
Example
Related
:PULM:SOUR EXT
[:SOURce]:PULM:OUT:STATe
[:SOURce]:PULM:STATe
Syntax [:SOURce]:PULM:STATe ON|OFF|1|0
[:SOURce]:PULM:STATe?
Description Set the state of pulse modulation.
Query the state of pulse modulation.
Parameter
Explanation ON|1: turn on the pulse modulation switch to enable the pulse modulation
OFF|0: turn off the pulse modulation switch to disable the pulse modulation
Return Format The query returns 1 or 0.
Name Type Range Default
ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0
function.
Example
[:SOURce]:PULM:TRAin:LIST:COUNt
Description Acquire the total number of rows in the current train list.
Return Format
DSG800 Programming Guide 2-39
:PULM:STAT ON /*Turn on the pulse modulation s witch*/ :PULM:STAT? /*Query the state of pulse modulation and the query returns
Syntax [:SOURce]:PULM:TRAin:LIST:COUNt?
The query returns the total number of rows in the current train list in integer. For
Page 60
RIGOL Chapter 2 Command System
Syntax
[:SOURce]:PULM:TRAin:LIST:GET? <Start>,<Count>
Name
Type
Range
Default
train list
second row of the train list*/
Command
[:SOURce]:PULM:TRIGger:DELay?
<value>
Real
10ns to 170s
100us
After the trigger delay is set, y ou can ro tate the knob to mo dify th e trigger delay the [:SOURce]:PULM:TRIGger:DELay:STEP command.
[:SOURce]:PULM:TRIGger:MODE
[:SOURce]:PULM:TRAin:LIST:GET
Description Acquire the train list date within the specified range.
Parameter
<Start> Integer
<Count> Integer
1 to the total number of rows in the current
1 to the total numbe r of rows in the current
train list
Explanation <Start>: the number of the start row of the train list data to be acquired.
<Count>: the total number of rows of the train list data to be acquired.
Return Format The query returns the train list date newly acquired. For example,
SN.2:2.00 ms , 4.00 ms, 2, 12.00 ms SN.3:15.55 ms , 100.50 us, 2, 31.30 ms
Example
Related
:PULM:TRA:LIST:GET? 2,2 /*Acquire 2 rows of train data starting from the
[:SOURce]:PULM:TRAin:LIST:COUNt
[:SOURce]:PULM:TRIGger:DELay
Syntax [:SOURce]:PULM:TRIGger:DELay <value >
--
--
Description Set the pulse trigger delay.
Query the pulse trigger delay.
Parameter
Name Type Range Default
Explanation When the modulation source is set to "Int" and the trigger mode is set to "Ext",
you can use this command to set the delay from when the pulse modulating signal receives the external trigger signal to the start o f the #1 pulse of the pulse modulating signal.
When <value> is set in "Number" form, the default unit is s. Besides, <value>
can also be set in "Number + Unit" form; for example, 30ns.
at the current step. At this point, you can query and set the current step using
Return Format The query returns the trigger delay. For example, 3.000000000s.
Example :PULM:TRIG:DEL 3 /*Set the trigger delay to 3s*/
:PULM:TRIG:DEL?
Related
Commands
[:SOURce]:PULM:SOURce [:SOURce]:PULM:TRIGger:DELay:STEP
Page 61
Chapter 2 Command System RIGOL
[:SOURce]:PULM:TRIGger:DELay:STEP?
Name
Type
Range
Default
<value>
Real
10ns to 170s
100us
using the [:SOURce]:PULM:TRIGger:DELay command.
Return Format
The query returns the trigger delay step. For example, 5.000000000s.
:PULM:TRIG:DEL:STEP?
Command
[:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity?
When the modulation source is set to "Ext", this command is invalid.
:PULM:TRIG:EXT:GATE:POL?
[:SOURce]:PULM:TRIGger:DELay:STEP
Syntax [:SOURce]:PULM:TRIGger:DELay:STEP <value>
Description Set the step of pulse trigg er delay.
Query the step of pulse trigger delay.
Parameter
Explanation When <value> is set in "Number" form, the default unit is s. Besides, <value>
can also be set in "Number + Unit" form; for example, 50ms.
After the trigger delay step is set, you c an ro tate the knob to mod ify the tri gger
delay at the current step. At this point, you can query and set the trigger delay
Example :PULM:TRIG:DEL:STEP 5 /*Set the trigger delay step to 5s*/
Related
[:SOURce]:PULM:TRIGger:DELay
[:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity
Syntax [:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity NORMal|INVerse
Description Set the polar ity of the external gated signal.
Query the polarity of the external gated signal.
Parameter
Explanation When the trigger mode of pulse modulation is set to "Ext Gate", the RF signal
NORMal: set the polarity of the external gated signal to "Normal". INVerse: set the polarity of the external gated signal to "Inverse".
Name Type Range Default
NORMal|INVerse Discrete NORMal|INVerse NORMal
generator receives the external gated signal input from the [TRIGGER IN] connector at the rear panel. At this point, you can set the polarity of the external gated signal using this command.
Return Format The query returns NORMAL or INVERSE.
Example
Related
Commands
:PULM:TRIG:EXT:GATE:POL INV
[:SOURce]:PULM:TRIGger:MODE [:SOURce]:PULM:SOURce
DSG800 Programming Guide 2-41
Page 62
RIGOL Chapter 2 Command System
[:SOURce]:PULM:TRIGger:EXTernal:SLOPe?
Name
Type
Range
Default
When the modulation source is set to "Ext", this command is invalid.
[:SOURce]:PULM:SOURce
[:SOURce]:PULM:TRIGger:EXTernal:SLOPe
Syntax [:SOURce]:PULM:TRIGger:EXTernal:SLOPe POSitive|NEGative
Description Set the polarity of the effective edge of the external trigger pulse.
Query the polarity of the effective edge of the external trigger pulse.
Parameter
POSitive|NEGative Discrete POSitive|NEGative POSitive
Explanation When the trigger mode of pulse modulation is set to "Ext Trig", the RF signal
generator receives the external trigger signal input from the [TRIGGER IN] connector at the rear panel. At this point, you can use this command to set the trigger edge of the external trigger signal.
POSitive: set the polarity of the effective edge of the external trigger pulse to
"Pos".
NEGative: set the polarity of the effective edge of the external trigger pulse to
"Neg".
Return Format The query returns POSITIVE or NEGATIVE.
Example :PULM:TRIG:EXT:SLOP NEG
:PULM:TRIG:EXT:SLOP?
Related
[:SOURce]:PULM:TRIGger:MODE
Commands
Page 63
Chapter 2 Command System RIGOL
[:SOURce]:PULM:TRIGger:MODE?
|KEY|BUS
|KEY|BUS
When the modulation source is set to "Ext", this command is invalid.
:PULM:TRIG:MODE?
:TRIGger:PULSe[:IMMediate]
[:SOURce]:PULM:TRIGger:MODE
Syntax [:SOURce]:PULM:TRIGger:MODE AUTO|EXTernal|EGATe|KEY|BUS
Description Set the trigger mode of pulse modulation.
Query the trigger mode of pulse modulation.
Parameter
AUTO|EXTernal|EGATe
Name Type Range Default
AUTO|EXTernal|EGATe
Discrete
AUTO
Explanation AUTO: select "Auto" trigger mode. At this point, the RF signal generator meets
the trigger condition at any time and will start the pulse modulation once the pulse modulation function is turned on.
EXTernal: select "Ext" trigger mode. At this point, the RF signal generator
receives the external trigger signal input from the [TRIGGER IN] connector at the rear panel. The instrument starts a pulse modulation each time a TTL pulse with the specified polarity is received. To specify the polarity of the TTL pulse, use the
[:SOURce]:PULM:TRIGger:EXTernal:SLOPe command to select "Pos" or
"Neg".
EGATe: select "Ext Gate" trigger mode. At this point, the RF signal generat or
receives the external gated signal input from the [TRIGGER IN] connector at the rear panel. The instrument starts a pulse modulat ion within the valid level range each time a gated signal with the specified polarity is received. To specify the polarity of the external gated signal, use the
[:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity command to select
"Normal" or "Inverse".
KEY: select "Key" trigger mode. At this point, the instrument starts a pulse
modulation each time Key Trig is pressed.
BUS: select "Bu s" trig g er mode. At this point, the instrument starts a pulse
modulation each time the
*TRG or :TRIGger:PULSe[:IMMediate] command is
sent.
Return Format The query returns the trigger mode of pulse modulation. For example, EGAT.
Example
Related
Commands
:PULM:TRIG:MODE EGAT
[:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity [:SOURce]:PULM:TRIGger:EXTernal:SLOPe [:SOURce]:PULM:SOURce *TRG
DSG800 Programming Guide 2-43
Page 64
RIGOL Chapter 2 Command System
[:SOURce]:PULM:WIDTh?
Name
Type
Range
Default
Pulse Width Pulse Period - 10 ns
2.000000000s.
[:SOURce]:PULM:WIDTh
Syntax [:SOURce]:PULM:WIDTh <value>
Description Set the width of the pulse modulating signa l.
Query the width of the pulse modulating signal.
Parameter
<value> Real 10ns to 170s - 10ns 500us
Explanation When <value> is set in "Number" form, the default unit is s. Besides, <value>
can also be set in "Number + Unit" form; for example, 2000ms.
When the modulation source is set to "Int" and the pulse mode is set to
"Single", you can use this command to set the width of the single pulse; otherwise, this command is invalid.
After the pulse width is set, you can rotate the knob to modify the pulse width
at the current step. At this point, you can query and set the current step using
[:SOURce]:PULM:WIDTh:STEP command.
the
The single pulse width is lim ited by the minimum puls e widt h and pulse period
and they fulfill the following relations.
Pulse Width Minimum Pulse Width
Return Format The query returns the width of the pulse modulating signal. For exampl e,
Example :PULM:WIDT 2
:PULM:WIDT?
Related
Commands
[:SOURce]:PULM:MODE [:SOURce]:PULM:PERiod [:SOURce]:PULM:SOURce [:SOURce]:PULM:WIDTh:STEP
Page 65
Chapter 2 Command System RIGOL
[:SOURce]:PULM:WIDTh:STEP?
<value>
Real
10ns to 10s
100us
using the [:SOURce]:PULM:WIDTh command.
3.000000000s.
:PULM:WIDT:STEP?
Command
[:SOURce]:PULM:WIDTh:STEP
Syntax [:SOURce]:PULM:WIDTh:STEP <value>
Description Set the step of the width of the pulse modulating signal.
Query the step of the width of the pulse modulating signal.
Parameter
Name Type Range Default
Explanation When <value> is set in "Number" form, the default unit is s. Besides, <value>
can also be set in "Number + Unit" form; for example, 3000ms.
After the pulse width step is set, you can rotate the knob to modify the pulse
width at the current step. At this point, you can query or set the pulse width
Return Format The query returns the step of the width of the pulse modulating signal. For example,
Example :PULM:WIDT:STEP 3
Related
[:SOURce]:PULM:WIDTh
DSG800 Programming Guide 2-45
Page 66
RIGOL Chapter 2 Command System

[:SOURce]:SWEep Command Subsystem

Command List:
[:SOURce]:SWEep:DIRection[:SOURce]:SWEep:EXECute[:SOURce]:SWEep:LIST:CPOint [:SOURce]:SWEep:LIST:INITialize:FSTep [:SOURce]:SWEep:LIST:INITialize:PRESet [:SOURce]:SWEep:LIST:LIST [:SOURce]:SWEep:MODE[:SOURce]:SWEep:POINt:TRIGger:TYPE [:SOURce]:SWEep:RESet[:ALL][:SOURce]:SWEep:STATe [:SOURce]:SWEep:STEP:DWELl[:SOURce]:SWEep:STEP:DWELl:STEP[:SOURce]:SWEep:STEP:POINts [:SOURce]:SWEep:STEP:POINts:STEP [:SOURce]:SWEep:STEP:SHAPe[:SOURce]:SWEep:STEP:SPACing[:SOURce]:SWEep:STEP:STARt:FREQuency [:SOURce]:SWEep:STEP:STARt:FREQuency:STEP[:SOURce]:SWEep:STEP:STARt:LEVel[:SOURce]:SWEep:STEP:STARt:LEVel:STEP[:SOURce]:SWEep:STEP:STOP:FREQuency[:SOURce]:SWEep:STEP:STOP:FREQuency:STEP[:SOURce]:SWEep:STEP:STOP:LEVel[:SOURce]:SWEep:STEP:STOP:LEVel:STEP[:SOURce]:SWEep:SWEep:TRIGger:TYPE[:SOURce]:SWEep:TYPE
Page 67
Chapter 2 Command System RIGOL
[:SOURce]:SWEep:DIRection?
Query the sweep direction.
Name
Type
Range
Default
FWD|REV
Discrete
FWD|REV
FWD
level.
Return Format
The query returns FWD or REV.
trigger condition is met after sending this command.
Syntax
[:SOURce]:SWEep:LIST:CPOint?
Return Format
The query returns the total nu mber of sweep points in the sweep li st. For example, 5.
[:SOURce]:SWEep:DIRection
Syntax [:SOURce]:SWEep:DIRection FWD|REV
Description Set the sweep direction.
Parameter
Explanation FWD: select "Fwd" sweep direction. At this point, the RF signal generator
sweeps from the start frequency or start level to the stop frequency or stop level.
REV: select "Down" sweep direction. At this point, the RF signal generator
sweeps from the stop frequency or stop level to the start frequency or stop
Example :SWE:DIR FWD /*Set the sweep direction to " F wd"*/
:SWE:DIR? /*The query returns FWD*/
[:SOURce]:SWEep:EXECute
Syntax [:SOURce]:SWEep:EXECute
Description Execute a sweep.
Explanation If the current sweep mode is "Cont", sending this command will change the
sweep mode to "Single". The instrument starts a sweep if the trigger condition is currently met.
If the current sweep mode is "Single", the instrument starts a sweep if the
Related
[:SOURce]:SWEep:MODE
Command
[:SOURce]:SWEep:LIST:CPOint
Description Query the tota l number of points in the current sweep list.
DSG800 Programming Guide 2-47
Page 68
RIGOL Chapter 2 Command System
Syntax
[:SOURce]:SWEep:LIST:INITialize:FSTep
list.
[:SOURce]:SWEep:STEP:STOP:LEVel
contains one frequency point (3GHz) and level point (-20dBm).
Syntax
[:SOURce]:SWEe p :LIST:LIST? <Start >, <Co u nt>
Name
Type
Range
Default
current list
current list
row in the sweep list*/
[:SOURce]:SWEep:LIST:INITialize:FSTep
Description Recalculate the data points set in the current step sweep to generate a new sweep
Explanation In the new sweep list, "SN" depends on the "Points" of step sweep.
"Freq" depends on the "Start Freq" and "Stop Freq" of step sweep. "Level" dep ends on the "start Lev" and "Stop Lev" of step sweep. "Time" depends on the "Dwell Time" of step sweep.
Related
Commands
[:SOURce]:SWEep:STEP:DWELl [:SOURce]:SWEep:STEP:POINts [:SOURce]:SWEep:STEP:STARt:FREQuency [:SOURce]:SWEep:STEP:STARt:LEVel [:SOURce]:SWEep:STEP:STOP:FREQuency
[:SOURce]:SWEep:LIST:INITialize:PRESet
Syntax [:SOURce]:SWEep:LIST:INITialize:PRESet
Description Reset the sweep list t o t he factory setting.
Explanation
After resetting the sweep list to the default using this command, the sweep list only
[:SOURce]:SWEep:LIST:LIST
Description Acquire the sweep data within the specified range of the sweep list.
Parameter
<Start> Integer
<Count> Integer
1 to the total number of rows in the
1 to the total number of rows in the
--
--
Explanation <Start>: denote the number of the start row of the sweep data to be acquired.
<Count>: denote the total number of rows of the sweep data to be acquired.
Return Format The query returns the sweep data newly acquired. For example,
SN.2:2994152687 , -50.000000, 0.500000 SN.3:2888000000 , -60.849998, 0.500000 SN.4:2550000000 , -75.750000, 0.500000
Example
:SWE:LIST:LIST? 2,3 /*Acquire 3 rows of sweep data starting from the second
Page 69
Chapter 2 Command System RIGOL
[:SOURce]:SWEep:MODE?
Query the sweep mode.
Name
Type
Range
Default
CONTinue|SINGle
Discrete
CONTinue|SINGle
CONTinue
met.
Return Format
The query returns the sweep mode (CONT or SING).
:SWE:MODE?
[:SOURce]:SWEep:MODE
Syntax [:SOURce]:SWEep:MODE CONTinue|SINGle
Description Set the sweep mode.
Parameter
Explanation CONTinue: select "Cont" sweep mode. The instrument sweeps continuously
according to the curre nt setting when the trigger condition is met.
SINGle: select "Single" sweep mode. The instrument performs a sweep
according to the curre nt setting and then stops when the trigger condition is
Example :SWE:MODE CONT
DSG800 Programming Guide 2-49
Page 70
RIGOL Chapter 2 Command System
[:SOURce]:SWEep:POINt:TRIGger:TYPE?
Name
Type
Range
Default
single sweep  trigger mode  point trigger mode.
:SWE:POIN:TRIG:TYPE?
:TRIGger[:SWEep][:IMMediate]
[:SOURce]:SWEep:POINt:TRIGger:TYPE
Syntax [:SOURce]:SWEep:POINt:TRIGger:TYPE AUTO|KEY|BUS|EXT
Description Set the point trigger mode of the sweep.
Query the point trigger mode of the sweep.
Parameter
AUTO|KEY|BUS|EXT Discrete AUTO|KEY|BUS|EXT AUTO
Explanation AUTO: select "Auto" trigger mode. If the sweep mode is set to "Cont", the
instrument will start sweeping each sweep point continuously within a sweep period once a sweep manner is selected. If the sweep mode is set to "Single", you need to send the sweep condition; after that, the instrumen t starts to sweep and then sto ps after the sweep period expires.
KEY: select "Key" trigger mode. If the sweep mode is set to "Cont", the
instrument starts to sweep a point each time Key Trig is pressed; if the sweep mode is set to "Single", you need to send the command to meet the single sweep cond ition and after that, the instrument starts to sweep a point and then stops after th e sweep period exp ires each tim e Key Trig is pressed.
[:SOURce]:SWEep:EXECute command to meet the single
[:SOURce]:SWEep:EXECute
BUS: select "Bus" trigger mode. If the sweep mode is set to "Cont", the
instrument starts to sweep a point each time the
:TRIGger[:SWEep][:IMMediate] command is sent; if the sweep mode is set
or to "Single", you need to send the
[:SOURce]:SWEep:EXECute com mand to
*TRG
meet the single sweep condition and after that, the instrument starts to sweep a point and then stops after the sweep period expires each time the
:TRIGger[:SWEep][:IMMediate] command is sent.
or
EXT: select "Ext" trigger mode. The RF signal generator receives the trigger
signal input from the [TRIGGER IN] connector at the rear panel. If the sweep mode is set to "Cont", the instrument starts to sweep a point each time a TTL pulse signal with the specified polarity is received. If the sweep mode is set to "Single", you need to send the
[:SOURce]:SWEep:EXECute com mand to meet
the single sweep condition; after that, the instrument starts to sweep a point and then stops after th e sweep period expires each time a TTL pulse signal with the specified polarity is received.
Note: The above descriptions are valid when the trigger mode of the corresponding sweep period is met.
When executing the sweep operation, the priority of the required conditions is:
Return Format The query returns the point trigger mode. For example, AUTO.
Example :SWE:POIN:TRIG:TYPE AUTO
*TRG
Related
Commands
[:SOURce]:SWEep:EXECute [:SOURce]:SWEep:MODE [:SOURce]:SWEep:SWEep:TRIGger:TYPE *TRG
Page 71
Chapter 2 Command System RIGOL
Syntax
[:SOURce]:SWEep:RESet[:ALL]
command.
Command
[:SOURce]:SWEep:STATe?
Name
Type
Range
Default
LEVel[,FREQuency]
LEVel,FREQuency
time.
:SWE:STAT?
[:SOURce]:SWEep:RESet[:ALL]
Description Reset all the sweep s to the start point.
Explanation If the current sweep direction is "Fwd", the instrument will stop the current
sweep and sweep from the start frequency or start level after sending this command.
If the current sweep direction is "Down", the instrument will stop the current
sweep and sweep from the stop frequency or stop level after sending this
Related
[:SOURce]:SWEep:DIRection
[:SOURce]:SWEep:STATe
Syntax [:SOURce]:SWEep:STATe OFF|FREQuency|LEVel[,FREQuency]
Description Set the sweep manner.
Query the sweep manner.
Parameter
OFF|FREQuency|
Discrete
Explanation OFF: turn off the sweep function.
FREQuenc y: enable the frequency sweep function. LEVel: enable the level sweep function. LEVel,FREQuency: enable the frequency and level sweep functions at the same
Return Format The query returns the sweep manner. For example, FREQ.
OFF|FREQuency|LEVel|
OFF
Example
:SWE:STAT FREQ
DSG800 Programming Guide 2-51
Page 72
RIGOL Chapter 2 Command System
[:SOURce]:SWEep:STEP:DWELl?
Name
Type
Range
Default
<value>
Real
20ms to 100s
100ms
[:SOURce]:SWEep:STEP:DWELl:STEP command.
Return Format
The query returns the dwell time of step sweep. For example, 3.000000000s.
Command
Name
Type
Range
Default
[:SOURce]:SWEep:STEP:DWELl command.
:SWE:STEP:DWEL:STEP?
Command
[:SOURce]:SWEep:STEP:DWELl
Syntax [:SOURce]:SWEep:STEP:DWELl <value>
Description Set the dwell time of step sweep.
Query the dwell time of step sweep.
Parameter
Explanation When <value> is set in "Number" form, the default unit is s. Besides, <value>
can also be set in "Number + Unit" form; for example, 3000ms.
After the dwell time is set, you can rotate the knob to modify the dwell time at
the current step. At this point, you can query and set the current step using the
Example :SWE:STEP:DWEL 3
:SWE:STEP:DWEL?
Related
[:SOURce]:SWEep:STEP:DWELl:STEP
[:SOURce]:SWEep:STEP:DWELl:STEP
Syntax [:SOURce]:SWEep:STEP:DWELl:STE P <value>
[:SOURce]:SWEep:STEP:DWELl:STEP?
Description Set the dwell time step.
Query the dwell time step.
Parameter
<value> Real 10ms to 10s 10ms
Explanation When <value> is set in "Number" form, the default unit is s. Besides, <value>
can also be set in "Number + Unit" form; for example, 3000ms.
After the dwell time step is set, you can rotate the knob to modi fy the dwell ti me
at the current step. At this point, you can query or set the dwell t ime using the
Return Format The query returns the dwell time step. For example, 3.000000000s.
Example
:SWE:STEP:DWEL:STEP 3
Related
[:SOURce]:SWEep:STEP:DWELl
Page 73
Chapter 2 Command System RIGOL
[:SOURce]:SWEep:STEP:POINts?
<value>
Integer
2 to 65535
91
the current step using the [:SOURce]:SWEep:STEP:POINts:STEP command.
:SWE:STEP:POIN?
Command
command.
[:SOURce]:SWEep:STEP:POINts
Syntax [:SOURce]:SWEep:STEP:POINts <value>
Description Set the number of points of step sweep.
Query the number of points of step sweep.
Parameter
Name Type Range Default
Explanation The number of sweep points decides the time interv al between two neighboring
sweep points.
After the number of sweep points is set, you can rotate the knob to modify the
number of sweep points at the current step. At this point, you can query or set
Return Format The query returns the number of sweep points. For example, 5.
Example
Related
:SWE:STEP:POIN 5
[:SOURce]:SWEep:STEP:POINts:STEP
[:SOURce]:SWEep:STEP:POINts:STEP
Syntax [:SOURce]:SWEep:STEP:POINts:STEP <value>
[:SOURce]:SWEep:STEP:POINts:STEP?
Description Set the step of the number of sweep points.
Query the step of the number of sweep points.
Parameter
Name Type Range Default
<value> Integer 1 to 10000 1
Explanation After the step of the number of sweep points is set, you can rotate the knob to
modify the number of sweep points at the current step. At this point, you can query or set the number of sweep points using the
[:SOURce]:SWEep:STEP:POINts
Return Format The query returns the step of the number of sweep points. For example, 2.
Example :SWE:STEP:POIN:STEP 2
:SWE:STEP:POIN:STEP?
Related
[:SOURce]:SWEep:STEP:POINts
Command
DSG800 Programming Guide 2-53
Page 74
RIGOL Chapter 2 Command System
[:SOURce]:SWEep:STEP:SHAPe?
Name
Type
Range
Default
TRIangle|RAMP
Discrete
TRIangle|RAMP
RAMP
direction is "Fwd").
:SWE:STEP:SHAP?
Command
[:SOURce]:SWEep:STEP:SPACing?
Name
Type
Range
Default
LINear|LOGarithmic
Discrete
LINear|LOGarithmic
LINear
LOGarithmic: set the sweep spacing to "Log".
Return Format
The query returns LIN or LOG.
:SWE:STEP:SPAC?
[:SOURce]:SWEep:STEP:SHAPe
Syntax [:SOURce]:SWEep:STEP:SHAPe TRIangle|RAMP
Description Set the step sweep shape.
Query the step sweep shape.
Parameter
Explanation The sweep shape decides the cycle mode of multiple sweeps.
TRIangle: select "Triangle" waveform. The sweep period always starts from the
start frequency or start level to the stop frequ ency or stop level and then returns back to the start frequency or start level (when the sweep direction is "Fwd").
RAMP: select "Ramp" waveform. The sweep period always starts from the start
frequency or start level to the stop frequency or stop level (when the sweep
Return Format The query returns TRI or RAMP.
Example
Related
:SWE:STEP:SHAP TRI
[:SOURce]:SWEep:DIRection
[:SOURce]:SWEep:STEP:SPACing
Syntax [:SOURce]:SWEep:STEP:SPACing LINear|LOGarithmic
Description Set the step sweep spacing.
Query the step sweep spacing.
Parameter
Explanation The sweep spacing refers to the variation mode from one frequency or level to
another frequency or level within a step.
LINear: set the sweep spacing to "Lin". Note that level sweep only supports "Lin"
sweep spacing.
Example :SWE: STE P :SPAC LIN
Page 75
Chapter 2 Command System RIGOL
[:SOURce]:SWEep:STEP:STARt:FREQuency?
Name
Type
Range
Default
using the [:SOURce]:SWEep:STEP:STARt:FREQuency:STEP command.
:SWE:STEP:STAR:FREQ?
Command
<value>
Real
10mHz to 1GHz
100MHz
frequency using the [:SOURce]:SWEep:STEP:STARt:FREQuency command.
[:SOURce]:SWEep:STEP:STARt:FREQuency
Syntax [:SOURce]:SWEep:STEP:STARt:FREQuency <value>
Description Set the start frequency of the sweep.
Query the start frequency of the sweep.
Parameter
<value> Real 9kHz to 3GHz 100MHz
Explanation When <value> is set in "Number" form, the default unit is Hz. Besides, <value>
can also be set in "Number + Unit" form; for example, 4MHz.
After the start frequency is set, you can rotate the knob to modify the start
frequency at the current step. At this point, you can query or set the current step
Return Format The query returns the start frequency of the sweep. For example, 4.00000000MHz.
Example
Related
:SWE:STEP:STAR:FREQ 4MHz
[:SOURce]:SWEep:STEP:STARt:FREQuency:STEP
[:SOURce]:SWEep:STEP:STARt:FREQuency:STEP
Syntax [:SOURce]:SWEep:STEP:STARt:FREQuency:STEP <value>
[:SOURce]:SWEep:STEP:STARt:FREQuency:STEP?
Description Set the start frequency step of the sweep.
Query the start frequency step of the sweep.
Parameter
Explanation When <value> is set in "Number" form, the default unit is Hz. Besides, <value>
After the start frequency step is set, you can rotate the knob to modify the start
Name Type Range Default
can also be set in "Number + Unit" form; for example, 3kHz.
frequency at the current step. At this point, you can query or set the start
Return Format The query returns the start frequency step of the sweep. For example, 3.00000kHz.
Example :SWE:STEP:STAR:FREQ:STEP 3kHz
:SWE:STEP:STAR:FREQ:STEP?
Related
[:SOURce]:SWEep:STEP:STARt:FREQuency
Command
DSG800 Programming Guide 2-55
Page 76
RIGOL Chapter 2 Command System
[:SOURce]:SWEep:STEP:STARt:LEVel?
<value>
Real
-110dBm to 20dBm
-10dBm
[:SOURce]:SWEep:STEP:STARt:LEVel:STEP command.
:SWE:STEP:STAR:LEV?
[:SOURce]:SWEep:STEP:STARt:LEVel
Syntax [:SOURce]:SWEep:STEP:STARt:LEVel <value>
Description Set the start level of the sweep.
Query the start level of the sweep.
Parameter
Name Type Range Default
Explanation When <value> is set in "Number" form (for example, 2), the default unit is dBm.
When <value> is set in "Number + Unit" form (for example, 2dBm), the start level displayed in the interface of the RF signal generator is related to the setting of 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 uni t of the return value is dBm . After the start level is set, you can rotate the knob to modify the start level at
the current step. At thi s point, you can query or set the current step using the
Return Format The query returns the start level of the sweep. For example, 2.00.
Example
:SWE:STEP:STAR:LEV 2dBm
Related
[:SOURce]:SWEep:STEP:STARt:LEVel:STEP
Command
Page 77
Chapter 2 Command System RIGOL
[:SOURce]:SWEep:STEP:STARt:LEVel:STEP?
<value>
Real
0.01dB to 100dB
1dB
[:SOURce]:SWEep:STEP:STARt:LEVel command.
:SWE:STEP:STAR:LEV:STEP?
Command
<value>
Real
9kHz to 3GHz
1GHz
step using the [:SOURce]:SWEep:STEP:STOP:FREQuency:STEP command.
Return Format
The query returns the stop frequency of the sweep. For example, 4.00000000MHz.
:SWE:STEP:STOP:FREQ?
Command
[:SOURce]:SWEep:STEP:STARt:LEVel:STEP
Syntax [:SOURce]:SWEep :STEP:STARt:LEVel:STEP <value>
Description Set the start level step of the sweep.
Query the start level step of the sweep.
Parameter
Name Type Range Default
Explanation When <value> is set in "Number" form, the default unit is dB. Besides, <value>
can also be set in "Number + Unit" form; for exam ple , 20dB .
The default uni t of the return value is dB. After the start level step is set, you can rotate th e kn ob to mod ify the start level
at the current step. At this point, you can query or set the start level using the
Return Format The query returns the start level step of the sweep. For example, 20.00.
Example
Related
:SWE:STEP:STAR:LEV:STEP 20
[:SOURce]:SWEep:STEP:STARt:LEVel
[:SOURce]:SWEep:STEP:STOP:FREQuency
Syntax [:SOURce]:SWEep:STE P:S TOP:FR E Que n cy < value>
[:SOURce]:SWEep:STEP:STOP:FREQuency?
Description Set the stop frequency of the sweep.
Query the stop frequency of the sweep.
Parameter
Name Type Range Default
Explanation When <value> is set in "Number" form, the default unit is Hz. Besides, <value>
can also be set in "Number + Unit" form; for example, 4MHz.
After the stop frequency is set, you can rotate the knob to modify the stop
frequency at the current step. At this point, you can query or set the current
Example :SWE:STEP:STOP:FREQ 4MHz
Related
[:SOURce]:SWEep:STEP:STOP:FREQuency:STEP
DSG800 Programming Guide 2-57
Page 78
RIGOL Chapter 2 Command System
[:SOURce]:SWEep:STEP:STOP:FREQuency:STEP?
Name
Type
Range
Default
<value>
Real
10mHz to 1GHz
100MHz
frequency using the [:SOURce]:SWEep:STEP:STOP:FREQuency command.
:SWE:STEP:STOP:FREQ:STEP?
Command
[:SOURce]:SWEep:STEP:STOP:FREQuency:STEP
Syntax [:SOURce]:SWEep:STEP:STOP:FREQuency:STEP <value>
Description Set the stop frequency step of the sweep.
Query the stop frequency step of the sweep.
Parameter
Explanation When <value> is set in "Number" form, the default unit is Hz. Besides, <value>
can also be set in "Number + Unit" form, for example, 3kHz.
After the stop frequency step is set, you can rotate the knob to modif y th e stop
frequency at the current step. At this point, you can query or set the stop
Return Format The query returns the stop frequency step of the sweep. For example, 3.00000kHz.
Example
Related
:SWE:STEP:STOP:FREQ:STEP 3kHz
[:SOURce]:SWEep:STEP:STOP:FREQuency
Page 79
Chapter 2 Command System RIGOL
[:SOURce]:SWEep:STEP:STOP:LEVel?
Name
Type
Range
Default
[:SOURce]:SWEep:STEP:STOP:LEVel:STEP command.
:SWE:STEP:STOP:LEV?
[:SOURce]:SWEep:STEP:STOP:LEVel
Syntax [:SOURce]:SWEep:STEP:STOP:LEVel <value>
Description Set the stop level of the sweep.
Query the stop level of the sweep.
Parameter
<value> Real -110dBm to 20dBm -20dBm
Explanation When <value> i s set in "Number" form (fo r example, 2), the def ault unit is dBm.
When <value> is set in "Number + Unit" form (for example, 2dBm), the stop level displayed in the interface of the RF sign al generator is related to th e setting of 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 uni t of the return value is dBm . After the stop level is set, you can rotate th e knob to modify th e stop level at the
current step. At this poi nt, you can query or set the current step using the
Return Format The query returns the stop level of the sweep. For example, 2.000000.
Example
Related
:SWE:STEP:STOP:LEV 2dBm
[:SOURce]:SWEep:STEP:STOP:LEVel:STEP
Command
DSG800 Programming Guide 2-59
Page 80
RIGOL Chapter 2 Command System
[:SOURce]:SWEep:STEP:STOP:LEVel:STEP?
After the stop level step is set, you can rotate the knob to modify the stop level
:SWE:STEP:STOP:LEV:STEP?
Command
[:SOURce]:SWEep:STEP:STOP:LEVel:STEP
Syntax [:SOURce]:SWEep:STEP:STOP:LEVel:STEP <value>
Description Set the stop level step of the sweep.
Query the stop level step of the sweep.
Parameter
Name Type Range Default
<value> Real 0.01dB to 100dB 1dB
Explanation When <value> is set in "Number" form, the default unit is dB. Besides, <value>
can also be set in "Number + Unit" form; for example, 20dB.
The default uni t of the return value is dB.
at the current step. At this point, you can query or set the stop level using the
[:SOURce]:SWEep:STEP:STOP:LEVel command.
Return Format The query returns the stop level step of the sweep. For example, 20.000000.
Example
Related
:SWE:STEP:STOP:LEV:STEP 20
[:SOURce]:SWEep:STEP:STOP:LEVel
Page 81
Chapter 2 Command System RIGOL
[:SOURce]:SWEep:SWEep:TRIGger:TYPE?
single sweep trigger mode point trigger mode.
:SWE:SWE:TRIG:TYPE?
:TRIGger[:SWEep][:IMMediate]
[:SOURce]:SWEep:SWEep:TRIGger:TYPE
Syntax [:SOURce]:SWEep:SWEep:TRIGger:TYPE AUTO|KEY|BUS|EXT
Description Set the trigger mode of the sweep period.
Query the trigger mode of the sweep period.
Parameter
Name Type Range Default
AUTO|KEY|BUS|EXT Discrete AUTO|KEY|BUS|EXT AUTO
Explanation AUTO: select "Auto" trigger mode. If the sweep mode is set to "Cont", the
instrument will start sweeping once a sweep manner is selected. If the sweep mode is set to "Single", you need to send the
[:SOURce]:SWEep:EXECute
command to meet the single sweep condition; after that, the instrument will start a sweep and then stops.
KEY: select "Key" trigger mode. If the sweep mode is set to "Cont", the
instrument starts a sweep each time Key Trig is pressed; if the sweep mode is set to "Single", you need to se nd the
[:SOURce]:SWEep:EXECute command to
meet the single sweep condition and after that, the instrument starts a sweep and then stops each time Key Trig is pressed.
BUS: select "Bus" trigger mode. If the sweep mode is set to "Cont", the
instrument starts a sweep each time the
:TRIGger[:SWEep][:IMMediate] command is sent; if the sweep mode i s set to
or "Single", you need to send the
[:SOURce]:SWEep:EXECute command to meet
*TRG
the single sweep condition and after that, the instrument starts a sweep and then stops each tim e the
*TRG or :TRIGger[:SWEep][:IMMediate] command is
sent.
EXT: select "Ext" trigger mode. The RF signal generator receives the trigger
signal input from the [TRIGGER IN] connector at the rear panel. If th e sweep mode is set to "Cont", the instrument starts a sweep each time a TTL pulse signal with the specified polarity is received. If the sweep mode is set to "Single", you need to send the
[:SOURce]:SWEep:EXECute com mand to meet
the single sweep condition; after that, the instrument starts a sweep and then stops each time a TTL pulse signal with the specified polarity is received.
Note: The above explanations are only valid when the trigger mode of each sweep point within the sweep period is met.
When executing the sweep operation, the priority of the required conditions is:
Return Format The query returns the trigger mode of the sweep. For example, AUTO.
Example
Related
Commands
:SWE:SWE:TRIG:TYPE AUTO
[:SOURce]:SWEep:EXECute [:SOURce]:SWEep:MODE [:SOURce]:SWEep:POINt:TRIGger:TYPE *TRG
DSG800 Programming Guide 2-61
Page 82
RIGOL Chapter 2 Command System
[:SOURce]:SWEep:TYPE?
LIST|STEP
Discrete
LIST|STEP
STEP
step sweep according the current setting.
Return Format
The query returns the sweep type (LIST or STEP).
[:SOURce]:SWEep:TYPE
Syntax [:SOURce]:SWEep:TYPE LIST|S TEP
Description Set the sweep type.
Query the sweep type.
Parameter
Name Type Range Default
Explanation LIST: select "List" sweep type. At this point, the RF signal generator sweeps
according to the sweep list currently loaded.
STEP: select "Step" sweep type. At this point, the RF signal generator performs
Example :SWE:TYPE STEP
:SWE:TYPE?
Page 83
Chapter 2 Command System RIGOL
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
0
1
2
3
4
5
6
7
8
9 10 11 12 13 14 15
0
1
2
3
4
5
6
7
0 1 2 3 4 5 6 7
Operation Status Register
Standard Event Status Register
Questionable Status Register
Status Byte Register
Error
/Event Queue
+
+
+
FREQuency
POWer
MODulation
TEMPerature
CALibration
SELFtest
CONNect
SWEeping
SETTing
Waiting for TRIGger
SWEep Calculation
Operation Complete
Command Error
Query Error
Device Dependent Error
Execution Error
Power On

:STATus Commands

The :ST ATus commands and IEEE488.2 common commands are mainly us ed to oper ate or query t he status register. The structure of the status register is as shown in the figure below. It includes the questionable status register, operation status register, standard event status register, status byte register and error queue. The STATus commands are used to set and query the questionable status register and operation status register; the IEEE488.2 common commands are used to perform operations on the standard event status register and status byte register.
DSG800 Programming Guide 2-63
Page 84
RIGOL Chapter 2 Command System
Bit
Value
Definition
0 0 Not Used
1 0 Not Used
2 0 Not Used
3 8 Power
4
16
Temperature
5
32
Frequency
6 0 Not Used
7
128
Modulation
8
256
Calibration
9
512
Selftest
10
1024
Connect
11 0 Not Used
12 0 Not Used
13 0 Not Used
14 0 Not Used
15 0 Not Used
Bit
Value
Definition
0 0 Not Used
1 2 Setting
2 0 Not Used
3 8 Sweeping
4 0 Not Used
5
32
Waiting for Trigger
6 0 Not Used
7 0 Not Used
8
256
Sweep Calculation
9 0 Not Used
10 0 Not Used
11 0 Not Used
12 0 Not Used
13 0 Not Used
14 0 Not Used
15 0 Not Used
The definitions of the questionable status register are as shown in the table below. Wherein, bit 0 to bit 2, bit 6 and bit 11 to bit 15 are not used and will be always treated as 0.
The definitions of the operation status register are as shown in the table below. Wherein, bit 0, bit 2, bit 4, bit 6, bit 7 and bit 9 to bit 15 are not used and will always be treated as 0.
Page 85
Chapter 2 Command System RIGOL
Command List:
:STATus:OPERation:CONDition :STATus:OPERation:ENABle :STATus:OPERation[:EVENt] :STATus:QUEStionable:CALibration:CONDition :STATus:QUEStionable:CALibration:ENABle :STATus:QUEStionable:CALibration[:EVENt] :STATus:QUEStionable:CONDition :STATus:QUEStionable:CONNect:CONDition :STATus:QUEStionable:CONNect:ENABle :STATus:QUEStionable:CONNect[:EVENt] :STATus:QUEStionable:ENABle :STATus:QUEStionable[:EVENt] :STATus:QUEStionable:FREQuency:CONDition :STATus:QUEStionable:FREQuency:ENABle :STATus:QUEStionable:FREQuency[:EVENt] :STATus:QUEStionable:MODulation:CONDition :STATus:QUEStionable:MODulation:ENABle :STATus:QUEStionable:MODulation[:EVENt] :STATus:QUEStionable:POWer:CONDition :STATus:QUEStionable:POWer:ENABle :STATus:QUEStionable:POWer[:EVENt] :STATus:QUEStionable:SELFtest:CONDition :STATus:QUEStionable:SELFtest:ENABle :STATus:QUEStionable:SELFtest[:EVENt] :STATus:QUEStionable:TEMP:CONDition :STATus:QUEStionable:TEMP:ENABle :STATus:QUEStionable:TEMP[:EVENt]
DSG800 Programming Guide 2-65
Page 86
RIGOL Chapter 2 Command System
decimal) and of whi ch the bit 0, bit 2, bit 4, bit 6, bit 7 and bit 9 to bit 15 are 0.
:STATus:OPERation:ENABle?
Name
Type
Range
Default
decimal).
The query returns the v al ue of th e enable regi ster of the op er atio n statu s reg ist er in integer.
:STAT:OPER:ENAB?
and of which the bit 0, bit 2, bit 4, bit 6, bit 7 and bit 9 to bit 15 are 0.

:STATus:OPERation:CONDition

Syntax :STATus:OPERation:CONDition?
Description Query the value of the condition register for the operation status register.
Explanation
Return Format The query returns the value of the condition register in integer. For example, 0.
The bit 0, bit 2, bit 4, bit 6, bit 7 and bit 9 to bit 15 of the operation status register are not used and wil l always be treated as 0; therefore, th e range of the return v alue of the command are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in decimal) to 1111111111111111 (32767 in

:STATus:OPERation:ENABle

Syntax :STATus:OPERation:ENABle <value>
Description Set the value of the enable register for the operation status register.
Query the value of the enable register for the operation status register.
Parameter
<value> Integer Refer to the "Explanation" 0
Explanation The range of <value> are the decimal numbers correspond ing to the binary numbers
ranging from 0000000000000000 (0 in decimal) to 1111111111111111 (32767 in
Return Format
Example :STAT:OPER:ENAB 100

:STATus:OPERation[:EVENt]

Syntax :STATus:OPERation[:EVENt]?
Description Query the value of the event register for the operation status register.
Explanation
Return Format The query returns the value of the event register in integer. For example, 0.
The bit 0, bit 2, bit 4 , bit 6, bit 7 and bit 9 to bit 15 of the oper ation status register are not used and will always be treated as 0; therefore, the range of the return valu e of the command are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in decimal) to 1111111111111111 (32767 in deci mal)
Page 87
Chapter 2 Command System RIGOL
Syntax
:STATus:QUEStionable:CALibration:CONDition?
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Questionable Status Register
+
FREQuency
POWer
MODulation
TEMPerature
CALibration
SELFtest
CONNect
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Calibration Status Register
+
FM/PM External Modulation
LF
PM
Frequency Reference
AM
ALC
FM
AM External Modulation
To Status Byte,
Bit 3
Bit
Value
Definition
0 1 Not Used
1 2 AM
2 4 FM
3 8 LF
4
16
ØM
5
32
FM/ØM External Modulation
6
64
AM External Modulation
7 0 Not Used
8
256
Frequency Reference
9 0 Not Used
10 0 Not Used
11 0 Not Used
12 0 Not Used
13 0 Not Used
14 0 Not Used
15 0 Not Used
Format
status register in integer. For example, 24.

:STATus:QUEStionable:CALibration:CONDition

Description Query the value of the condition register for the questionable calibration status register.
Explanation The relation between the calibration status register and questionable status register
is as shown in the figure below.
The definitions of the questionable calibration status register are as shown in the
table below. Wherein, bit 0 and bit 9 to bit 15 are not used and will be always treated as 0. The range of the retu rn v alue ar e th e dec imal nu mbers co rres pondi ng to the binary numbers ranging from 0000000000000000 (0 in decimal) to 1111111111111111 (32767 in decimal) and of which the bit 0 and bit 9 to bit 15 are 0 (bit 2 and bit 4 cannot be 1 at the same time).
Return
DSG800 Programming Guide 2-67
The query returns the value of the condition register of the questionable calibration
Page 88
RIGOL Chapter 2 Command System
in decimal) to 1111111111111111 (32767 in decimal).
status register in integer.
:STAT:QUES:CAL:ENAB?
9 to bit 15 are 0 (bit 2 and bit 4 cannot be 1 at the same time).
status register in integer. For example, 24.
Syntax
:STATus:QUEStionable:CONDition?
which the bit 0 to bit 2, bit 6 and bit 11 to bit 15 are 0.
register in integer. For example, 0.

:STATus:QUEStionable:CALibration:ENABle

Syntax :STATus:QUEStionable :CALibration:ENABle <value>
:STATus:QUEStionable:CALibration:ENABle?
Description Set the value of the enable register for the questionable calibration status register.
Query the value of the enable register for the questionable calibration status register.
Parameter
Explanation In the questionable calibration status register, the range of <value> are the decimal
Return Format Th e query returns the value of the enable register of the questionable calibration
Example :STAT:QUES:CAL:ENAB 100
Name Type Range Default
<value> Integer Refer to the "Explanation" 0
numbers corresponding to the binary numb ers ranging from 0000000000000000 (0

:STATus:QUEStionable:CALibration[:EVENt]

Syntax :STATus:QUEStionable:CALibration[:EVENt]?
Description Query the value of the event register for the questionable calibration status register.
Explanation
The bit 0 and bit 9 to bit 15 of the questionable calibration status register are not used and will be always treated as 0. The range of the return value are the decimal numbers corresponding to the binary numb ers ranging from 0000000000000000 (0 in decimal) to 1111111111111111 (32767 in decimal) and of which the bit 0 and bit
Return Format The query returns the value of the event register of the questionable calibration

:STATus:QUEStionable:CONDition

Description Query the value of the condition register for the questionable status register.
Explanation
Return Format The query returns the value of the condition register of the questionable status
The bit 0 to bit 2, bit 6 and bit 11 to bit 15 of the questionable status register are not used and are always treated as 0; therefore, the range of the return value are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in decimal) to 1111111111111111 (32767 in decimal) and of
Page 89
Chapter 2 Command System RIGOL
Syntax
:STATus:QUEStionable:CONNect:CONDition?
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Questionable Status Register
+
FREQuency
POWer
MODulation
TEMPerature
CALibration
SELFtest
CONNect
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Connect Status Register
+
Device Connection State
To Status Byte,
Bit 3
Bit
Value
Definition
0 1 Device Connection State
1 0 Not Used
2 0 Not Used
3 0 Not Used
4 0 Not Used
5 0 Not Used
6 0 Not Used
7 0 Not Used
8 0 Not Used
9 0 Not Used
10 0 Not Used
11 0 Not Used
12 0 Not Used
13 0 Not Used
14 0 Not Used
15 0 Not Used
Format
register in integer. For example, 0.

:STATus:QUEStionable:CONNect:CONDition

Description Query the value of the condition register for the questionable connect status register.
Explanation The relation between the connect status register and questionable status register is
as shown in the figure below.
The definitions of the questionable connect status register are as shown in the table
below. Wherein, bit 1 to bit 15 are not used and will be always treated as 0. The range of the return value are the decimal numbers co rresponding to the b inary numbers ranging from 0000000000000000 (0 in decimal) to 0000000000000001 (1 in decimal).
Return
DSG800 Programming Guide 2-69
The query returns the value of the condition register of the questionable connect status
Page 90
RIGOL Chapter 2 Command System
:STATus:QUEStionable:CONNect:ENABle?
Name
Type
Range
Default
in decimal) to 1111111111111111 (32767 in decimal).
register in integer.
:STAT:QUES:CONN:ENAB?
Syntax
:STATus:QUEStionable:CONNect[:EVENt]?
decimal) to 0000000000000001 (1 in decimal).
register in integer.
:STATus:QUEStionable:ENABle?
Query the value of the enable register for the questionable status register.
Name
Type
Range
Default
<value>
Integer
Refer to the "Explanation"
0
decimal).
The query returns th e v alue of the enable regi ster of the qu estion able status register in integer.
:STAT:QUES:ENAB?

:STATus:QUEStionable:CONNect:ENABle

Syntax :STATus:QUE Sti o nab le :CON Nect :E NA Bl e < value >
Description Set the value of the enable register for the questionable connect status register.
Query the value of the enable register for the questionable connect status register.
Parameter
<value> Integer Refer to the "Explanation" 0
Explanation In the questionable connect status register, the range of <value> are the decimal
numbers corresponding to the binary numb ers ranging from 0000000000000000 (0
Return Format The query returns the v alue of the en able register o f the questionable connect status
Example :STAT:QUES:CONN:ENAB 1

:STATus:QUEStionable:CONNect[:EVENt]

Description Query the value of the event register for the questionable connect status registe r.
Explanation
The bit 1 to bit 15 of the questionable connect status register are not used and will be always treated as 0. The range of the return value are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in
Return Format The query retu rns th e value of the event regi ster of the questionable connect status

:STATus:QUEStionable:ENABle

Syntax :STATus:QUEStionable :ENABle <value>
Description Set the value of the enable register for the questionable status register.
Parameter
Explanation The range of <value> are the decimal numbers corresponding to the binary numbers
ranging from 0000000000000000 (0 in decimal) to 1111111111111111 (32767 in
Return Format
Example :STAT:QUES:ENAB 100
Page 91
Chapter 2 Command System RIGOL
Syntax
:STATus:QUEStionable[:EVENt]?
which the bit 0 to bit 2, bit 6 and bit 11 to bit 15 are 0.
in integer. For example, 0.

:STATus:QUEStionable[:EVENt]

Description Query the value of the event register for the questionable status register.
Explanation
Return Format The query returns the value of the event register of the questionable status register
The bit 0 to bit 2, bit 6 and bit 11 to bit 15 of the questionable status register are not used and are always treated as 0; therefore, the range of the return value are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in decimal) to 1111111111111111 (32767 in decimal) and of
DSG800 Programming Guide 2-71
Page 92
RIGOL Chapter 2 Command System
Syntax
:STATus:QUEStionable:FREQuency:CONDition?
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Questionable Status Register
+
FREQuency
POWer
MODulation
TEMPerature
CALibration
SELFtest CONNect
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Frequency Status Register
+
PLL Unlocked
To Status Byte,
Bit 3
Bit
Value
Definition
0 1 PLL Unlocked
1 0 Not Used
2 0 Not Used
3 0 Not Used
4 0 Not Used
5 0 Not Used
6 0 Not Used
7 0 Not Used
8 0 Not Used
9 0 Not Used
10 0 Not Used
11 0 Not Used
12 0 Not Used
13 0 Not Used
14 0 Not Used
15 0 Not Used
Format
status register in integer.

:STATus:QUEStionable:FREQuency:CONDition

Description Query the value of the condition register for the questionable frequency status register.
Explanation The relation between the frequency status register and questionable status register
is as shown in the figure below.
The definitions of the questionable frequency status register are as shown in the
table below. Wherein, bit 1 to bit 15 are not used and will be always treated as 0. The range of the return value are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in decimal) to 0000000000000001 (1 in decimal).
Return
The query returns the value of the condition register of the questionable frequency
Page 93
Chapter 2 Command System RIGOL
:STATus:QUEStionable:FREQuency:ENABle?
Name
Type
Range
Default
<value>
Integer
Refer to the "Explanation"
0
in decimal) to 1111111111111111 (32767 in decimal).
status register in integer.
Syntax
:STATus:QUEStionable:FREQuency[:EVENt]?
decimal) to 0000000000000001 (1 in decimal).
status register in integer.

:STATus:QUEStionable:FREQuency:ENABle

Syntax :STATus:QUE Stio na ble :FREQuency:ENABle <value>
Description Set the value of the enable register for the questionable frequency status register.
Query the value of the enable register for the questi onable frequency status register.
Parameter
Explanation In the questionable frequency status register, the range of <value> are the decimal
numbers corresponding to the binary numb ers ranging from 0000000000000000 (0
Return Format The query returns the value of the enable register of the questionable frequency
Example :STAT:QUES:FREQ:ENAB 1
:STAT:QUES:FREQ:ENAB?

:STATus:QUEStionable:FREQuency[:EVENt]

Description Query the value of the event register for the questionable frequency status register.
Explanation
The bit 1 to bit 15 of the questionable frequency status register are not used and will be always treated as 0. The range of the return value are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in
Return Format The query returns the value of the event register of the questionable frequency
DSG800 Programming Guide 2-73
Page 94
RIGOL Chapter 2 Command System
Syntax
:STATus:QUEStionable:MODulation:CONDition?
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Questionable Status Register
+
FREQuency
POWer
MODulation
TEMPerature
CALibration
SELFtest CONNect
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Modulation Status Register
+
AM Overmodulation
To Status Byte,
Bit 3
he range of the retu rn value are the decimal nu mbers c orrespo nding to the bin ary
Bit
Value
Definition
0 1 AM Overmodulation
1 0 Not Used
2 0 Not Used
3 0 Not Used
4 0 Not Used
5 0 Not Used
6 0 Not Used
7 0 Not Used
8 0 Not Used
9 0 Not Used
10 0 Not Used
11 0 Not Used
12 0 Not Used
13 0 Not Used
14 0 Not Used
15 0 Not Used
Format
status register in integer.

:STATus:QUEStionable:MODulation:CONDition

Description Query the value of the condition register for the questionable modulation status register.
Explanation The relation between the modulation status register and questionable status
register is as shown in the figure below.
The definitions of the questionable modulation status register are as shown in the
table below. Wherein, bit 1 to bit 15 are not used and will be always treated as 0. T numbers ranging from 0000000000000000 (0 in decimal) to 0000000000000001 (1 in decimal).
Return
The query returns the value of the condition register of the questionable modulation
Page 95
Chapter 2 Command System RIGOL
:STATus:QUEStionable:MODulation:ENABle?
register.
Name
Type
Range
Default
<value>
Integer
Refer to the "Explanation"
0
in decimal) to 1111111111111111 (32767 in decimal).
status register in integer.
:STAT:QUES:MOD:ENAB?
decimal) to 0000000000000001 (1 in decimal).
status register in integer.

:STATus:QUEStionable:MODulation:ENABle

Syntax :STATus:QUEStionable:MODulation:ENABle <value>
Description Set the value of the enable register for the questionable modulation status register.
Query the value of the enable register for the questionable modulation status
Parameter
Explanation In the questionable modulation status register, the range of <value> are the decimal
numbers corresponding to the binary numb ers ranging from 0000000000000000 (0
Return Format The query returns the value of the enable register of the questionable modulation
Example :STAT:QUES:MOD:ENAB 1

:STATus:QUEStionable:MODulation[:EVENt]

Syntax :STATus:QUEStionable:MODulation[:EVENt]?
Description Query the value of the event register for the questionable modulation status register .
Explanation
The bit 1 to bit 15 of the questionable modulation status register are not used and will be always treated as 0. The range of the return value are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in
Return Format The query returns the value of the event register of the questionable modulation
DSG800 Programming Guide 2-75
Page 96
RIGOL Chapter 2 Command System
Syntax
:STATus:QUEStionable:POWer:CONDition?
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Questionable Status Register
+
FREQuency
POWer
MODulation
TEMPerature
CALibration
SELFtest
CONNect
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Power Status Register
+
ALC Unlocked
To Status Byte,
Bit 3
Output Power Protection
ALC Heater Detector
Bit
Value
Definition
0 1 ALC Unlocke d
1 2 Output Power Protection
2 4 ALC Heater Detector, 30 min
3 0 Not Used
4 0 Not Used
5 0 Not Used
6 0 Not Used
7 0 Not Used
8 0 Not Used
9 0 Not Used
10 0 Not Used
11 0 Not Used
12 0 Not Used
13 0 Not Used
14 0 Not Used
15 0 Not Used

:STATus:QUEStionable:POWer:CONDition

Description Query the value of the condition register for the questionable power status register.
Explanation The relation between the power status register and questionable status register is as
shown in the figure below.
The definitions of the questionable power status register are as shown in the table
below. Wherein, bit 3 to bit 15 are not used and will be always treated as 0. The range of the return value are the decimal numbers co rresponding to the b inary numbers ranging from 0000000000000000 (0 in decimal) to 1111111111111111 (32767 in decimal) and of which the bit 3 to bit 15 are 0.
Format
Return
The query returns the value of the condition register of the questionable power status register in integer.
Page 97
Chapter 2 Command System RIGOL
in decimal) to 1111111111111111 (32767 in decimal).
Syntax
:STATus:QUEStionable:POWer[:EVENt]?
are 0.
register in integer.

:STATus:QUEStionable:POWer:ENABle

Syntax :STATus:QUEStionable:POWer:ENABle <value>
:STATus:QUEStionable:POWer:ENABle?
Description Set the value of the enable register for the questionable power status register.
Query the value of the enable register for the questionable power status register.
Parameter
Name Type Range Default
<value> Integer Refer to the "Explanati on" 0
Explanation In the questionable power status register, the range of <value> are the decimal
numbers corresponding to the binary numb ers ranging from 0000000000000000 (0
Return Format The query returns the value of the enable register of the questionable power status
register in integer.
Example :STAT:QUES:POW:ENAB 6
:STAT:QUES:POW:ENAB?

:STATus:QUEStionable:POWer[:EVENt]

Description Query the value of the event register for the questionable power status register.
Explanation
The bit 3 to bit 15 of the questionable power status register are not used and will be always treated as 0. The range of the return value are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in decimal) to 1111111111111111 (32767 in decimal) and of which the bit 3 to bit 15
Return Format The query returns the value of the event register of the questionable power status
DSG800 Programming Guide 2-77
Page 98
RIGOL Chapter 2 Command System
Syntax
:STATus:QUEStionable:SELFtest:CONDition?
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Questionable Status Register
+
FREQuency
POWer
MODulation
TEMPerature
CALibration
SELFtest CONNect
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Selftest Status Register
+
Boot Process Initialization Error
To Status Byte
,
Bit 3
Bit
Value
Definition
0 1 Boot Process Initialization Error
1 0 Not Used
2 0 Not Used
3 0 Not Used
4 0 Not Used
5 0 Not Used
6 0 Not Used
7 0 Not Used
8 0 Not Used
9 0 Not Used
10 0 Not Used
11 0 Not Used
12 0 Not Used
13 0 Not Used
14 0 Not Used
15 0 Not Used
Format
register in integer.

:STATus:QUEStionable:SELFtest:CONDition

Description Query the value of the condition register for the questionable selftest status register.
Explanation The relation between the selftest status register and questionable status register is
as shown in the figure below.
The definitions of the questionable selftest status register are as shown in the table
below. Wherein, bit 1 to bit 15 are not used and will be always treated as 0. The range of the return value are the decimal numbers co rresponding to the b inary numbers ranging from 0000000000000000 (0 in decimal) to 0000000000000001 (1 in decimal).
Return
The query returns the value of the condition register of the questionable selftest status
Page 99
Chapter 2 Command System RIGOL
Name
Type
Range
Default
in decimal) to 1111111111111111 (32767 in decimal).
register in integer.
:STAT:QUES:SELF:ENAB?
Syntax
:STATus:QUEStionable:SELFtest[:EVENt]?
decimal) to 0000000000000001 (1 in decimal).
register in integer.

:STATus:QUEStionable:SELFtest:ENABle

Syntax :STATus:QUESti onable:SELFtest:ENABle <value>
:STATus:QUEStionable:SELFtest:ENABle?
Description Set the value of the enable register for the questionable selftest status register.
Query the value of the enable register for the questionable selftest status register.
Parameter
<value> Integer Refer to the "Explanation" 0
Explanation In the questionable selftest status register, the range of <value> are the decimal
numbers corresponding to the binary numb ers ranging from 0000000000000000 (0
Return Format The query retu rn s th e value of the enable regis ter o f th e questionable selftest status
Example :STAT:QUES:SELF:ENAB 1

:STATus:QUEStionable:SELFtest[:EVENt]

Description Query the value of the event register for the questionable selftest status register.
Explanation
The bit 1 to bit 15 of the questionable selftest status register are not used and will be always treated as 0. The range of the return value are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in
Return Format The query returns the value of the event register of the questionable selftest status
DSG800 Programming Guide 2-79
Page 100
RIGOL Chapter 2 Command System
Syntax
:STATus:QUEStionable:TEMP:CONDition?
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Questionable Status Register
+
FREQuency
POWer
MODulation
TEMPerature
CALibration
SELFtest
CONNect
0 1 2 3 4 5 6 7 8
9 10 11 12 13 14 15
Temperature Status Register
+
Mainboard or RF Board Overheating
To Status Byte,
Bit 3
Bit
Value
Definition
0 1 Mainboard or RF Board Overheating
1 0 Not Used
2 0 Not Used
3 0 Not Used
4 0 Not Used
5 0 Not Used
6 0 Not Used
7 0 Not Used
8 0 Not Used
9 0 Not Used
10 0 Not Used
11 0 Not Used
12 0 Not Used
13 0 Not Used
14 0 Not Used
15 0 Not Used
Format
status register in integer.

:STATus:QUEStionable:TEMP:CONDition

Description Query the value of the condition register for the questionable temperature status register.
Explanation The relation between the temperature status register and questionable status
register is as shown in the figure below.
The definitions of the questionable temperature status register are as shown in the
table below. Wherein, bit 1 to bit 15 are not used and will be always treated as 0. The range of the return value are the decimal numbers corresponding to the binary numbers ranging from 0000000000000000 (0 in decimal ) to 0000000000000001 (1 in decimal).
Return
The query returns the value of the condition register of the questionable temperature
Loading...