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
DSG800 Programming Guide I
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.
II DSG800 Programming Guide
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
SicherheitsHinweis
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, FREQLF
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.
VIII DSG800 Programming Guide
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
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 Methods
SCPI Command Overview
DSG800 Programming Guide 1-1
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 Syst I/O Config LAN 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).
1-2 DSG800 Programming Guide
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.
1-4 DSG800 Programming Guide
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.
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
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.
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
2-8 DSG800 Programming Guide
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.
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
2-12 DSG800 Programming Guide
: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.
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
2-20 DSG800 Programming Guide
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.
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
2-26 DSG800 Programming Guide
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.
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
2-32 DSG800 Programming Guide
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.
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
2-36 DSG800 Programming Guide
: 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.
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
2-38 DSG800 Programming Guide
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*/
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.
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
2-42 DSG800 Programming Guide
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.
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.
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.
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.
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
2-52 DSG800 Programming Guide
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
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
2-56 DSG800 Programming Guide
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.
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
2-58 DSG800 Programming Guide
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
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.
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?
2-62 DSG800 Programming Guide
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.
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)
2-66 DSG800 Programming Guide
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.
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
2-68 DSG800 Programming Guide
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
2-70 DSG800 Programming Guide
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).
2-72 DSG800 Programming Guide
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).
2-74 DSG800 Programming Guide
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).
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
2-76 DSG800 Programming Guide
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
2-78 DSG800 Programming Guide
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).
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
2-80 DSG800 Programming Guide
The query returns the value of the condition register of the questionable temperature
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.