RIGOL is a registered trademark of RIGOL TECHNOLOGIES, INC.
Publication Number
PGD18101-1110
Software Version
DSA705/DSA710:00.01.17
Software upgrade might change or add product features. Please acquire the latest version of the manual
from RIGOL website or contact RIGOL to upgrade the software.
Notices
RIGOL products are covered by P.R.C. and foreign patents, issued and pending.
RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at
the company’s sole decision.
Information in this publication replaces all previously released materials.
Information in this publication is subject to change without notice.
RIGOL shall not be liable for either incidental or consequential losses in connection with the furnishing,
use or performance of this manual as well as any information contained .
Any part of thi s document is forbidden to be copied, photocopied or rearranged without prior written
approval of RIGOL.
Product Certification
RIGOL guarantees that this product conforms to the national and industrial sta ndards in China as well as
the ISO9001:2008 standard and the ISO14001:2004 standard. Other international standard conformance
certifications are in progress.
Contact Us
If you have any problem or requirement when using our products or this manual, please contact RIGOL.
E-mail: service@rigol.com
Website: www.rigol.com
DSA700 Programming GuideI
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 follow the instructions specified in this manual to use the instrument properly.
Use Proper Power Cord.
Only the exclusive power cord designed for the instrument and authorized for use within the local country
could be used.
Ground the Instrument.
The instrument is grounded through the Protective Earth lead of the power cord. To avoid electric shock,
connect the earth terminal of the power cord to the Protective Earth terminal before connecting any input
or output terminals.
Connect the Probe Correctly.
If a probe is used, the probe ground lead must be connected to earth ground. Do not connect the ground
lead to high voltage. Improper way of connection could result in dangerous voltages being present on the
connectors, controls or other surfaces of the oscilloscope and probes, which will cause potential hazards for
operators.
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.
Ensure that no overvolta ge (such as that caused by a bolt of lightning) can reach the product. Otherwi se,
the operator might be exposed to the danger of an electric shock.
Do Not Operate Without Covers.
Do not operate the instrument with covers or panels removed.
Do Not Insert Objects Into the Air Ou tlet.
Do not insert objects into the air outlet, as doing so may cause damage to the instrument.
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 on.
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.
Provide Adequate Ventilation.
Inadequate ventilation may cause an increase of temperature in the instrument, which would cause
damage to the instrument. So please keep the instrument well ventilated and inspect the air outlet and the
fan regularly.
Do Not Operate in Wet Conditions.
To avoid short circuit inside the instrument or electric shock, never operate the instrument in a humid
II DSA700 Programming Guide
RIGOL
environment.
Do Not Operate in an Explosive Atmosphere.
To avoid personal injuries or damage to the instrument, never operate the instrument in an explosive
atmosphere.
Keep Instrument Surfaces Clean and Dry.
To avoid dust or moisture from affecting the performance of the instrument, keep the surfaces of the
instrument clean and dry.
Prevent Electrostatic Impact.
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.
Use the Battery Properly.
Do not expose the battery (if available) to high temperature or fire.
Keep it out of the reach of children. Improper change of a battery (lithium battery) may cause an explosion.
Use the RIGOL specified battery only.
Handle with Caution.
Please handle with care during transportation to avoid damage to keys, knobs, interfaces and other parts
on the panels.
DSA700 Programming GuideIII
RIGOL
WARNING
CAUTION
DANGER
It calls attention to an operation, if not correctly performed, could result in injury or
WARNING
CAUTION
Hazardous
Safety
Protective
Chassis
Test
Safety Notices and Symbols
Safety Notices in this Manual:
Indicates a potentially hazardous situation or practice which, if not avoided, will result in
serious injury or death.
Indicates a potentially hazardous situation or practice which, if not avoided, could result
in damage to the product or loss of important data.
Safety Terms on the Product:
hazard immediately.
It calls attention to an operation, if not correctly performed, could result in potential
injury or hazard.
It calls attention to an operation, if not correctly performed, could result in damage
to the product or other devices connected to the product.
Safety Symbols on the Product:
Voltage
Warning
Earth
Terminal
Ground
Ground
IV DSA700 Programming Guide
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 spezifikationsgemäß en Sicherungen ein.
Vermeiden Sie ungesc h ü tzt e V er bindungen.
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 ist es unumgänglich, das Gerät ausschließlich fernab
DSA700 Programming GuideV
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ßenleiter 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 DSA700 Programming Guide
RIGOL
CAUTION
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
CAUTION
weist auf eine Verletzung oder Gefährdung hin und bedeutet, dass eine mögliche
Sicherheits Begriffe und Symbole
Begriffe in diesem Guide:
WARNING
Die Kennzeichnung WARNING beschreibt Gefahrenquellen die leibliche Schäden oder den
Tod von Personen zur Folge haben können.
Die Kennzeichnung Cautio n (Vorsicht) beschreibt Gefahrenquel len die Schäden am Gerät
hervorrufen können.
Begriffe auf dem Produkt:
geschehen.
Beschädigung des Instruments oder anderer Gegenstände auftreten kann.
Symbole auf dem Produkt:
Gefährliche
Spannung
SicherheitsHinweis
Schutz-erde Gehäusemasse Erde
DSA700 Programming GuideVII
RIGOL
Model
Frequency Range
Tracking Generator
Document Overview
This manual introduces how to program and control RIGOL DSA700 series spectrum analyzer using SCPI
commands through USB, LAN or GPIB (via USB-GPIB interface converter) interface.
Main Topics in this Manual:
Chapter 1 SCPI Overview
This chapter provides a brief introduction of the SCPI commands.
Chapter 2 Command System
This chapter introduces the syntax, function, parameter and using instruction of each DSA700 command in
alphabetical order (from A to Z).
Chapter 3 Programming Demos
This chapter introduces how to program and control DSA700 using development tools, such as Visual C++,
Visual Basic and LabVIEW.
Tip
The latest version of this manual can be downloaded from www.rigol.com.
Format Conventions in this Manual:
1. Key:
The key at the front panel is deno ted by the format o f "Key Name (Bold) +Text Box" in the manual. For
example, FREQ denotes the FREQ key.
2. Menu:
The menu is denoted by the format of "Menu Word (Bold) + Character Shading" in the manual. For
example, Center Freq denotes the center frequency menu item under the FREQ function key.
3. Connector:
The connector at the front or rear panel is denoted by the format of "Connector Name (Bold) + Square
Brackets (Bold)" in the manual. For example, [GEN OUTPUT 50Ω].
4. Operation step:
The operation for the next ste p is denoted by an arrow "" in t he manual. For example, FREQ
Center Freq denotes that you first press FREQ on the front panel and then press Ce nt er Fr e q.
Content Conventions in this Manual:
DSA700 series spectrum analyzer includes the following two models. The introductions of the DSA700
series commands in this manual are based on DSA710, unless otherwise noted.
DSA705 100 kHz to 500 MHz None
DSA710 100 kHz to 1 GHz None
VIII DSA700 Programming Guide
Contents RIGOL
Contents
Guaranty and Declaration ......................................................................................................... I
Safety Requirement .................................................................................................................. II
General Safety Summary ............................................................................................................. II
Safety Notices and Symbols ......................................................................................................... IV
Allgemeine Sicherheits Informationen ........................................................................................... V
Sicherheits Begri ffe und Symbole ............................................................................................... VII
Document Overview ............................................................................................................. VIII
Linux Programming Demo ....................................................................................................... 3-21
Linux Programming Preparations ....................................................................................... 3-21
Linux Programming Procedures ......................................................................................... 3-24
DSA700 Programming GuideXV
Chapter 1 SCPI Overview RIGOL
Chapter 1 SCPI Overview
SCPI (Standard Commands for Programmable Instruments) is standardized instrument programming
language that is bas ed on the stan dard IEEE48 8.1 and IEEE 4 88.2 and conform s to v arious stard ards (such
as the floating point operation rule in IEEE754 stardard, ISO646 7-bit coded character for information
interchange (equivalent to ASCll programming).
Main topics of this chapter:
Syntax
Symbol Description
Parameter Type
Command Abbreviation
DSA700 Programming Guide1-1
RIGOL Chapter 1 SCPI Overview
Syntax
SCPI commands present a hierarchical tree structure and contain multiple sub-systems, each of which is
made up of a root keyword and one or more sub-keywords. The command string usually starts with ":", the
keywords are separated by ":" and are followed by the parameter settings availab le, "?" is added at the end
of the command string to indicate query and the command and parameter are separated by a space.
For example,
:CALCulate:BANDwidth:NDB <rel_ampl>
:CALCulate:BANDwidth:NDB?
CALCulate is the r oot keyword of the command. BANDwidth and NDB are the second-level and
third-level keywords respectively. The command string starts with ":" which separate s the multiple-level
keywords. <rel_ampl> represents the parameter available for setting, "?" represents query and the
command :CALCulate:BANDwidth:NDB and parameter <rel_ampl> are separated by a space.
"," is generally used for separating different parameters contained in the same command, for example,
:SYSTem:DATE <yea r>,<month>, <d a y >
Symbol Description
The following four symbols are not the content of SCPI commands and will not be sent with the commands,
but are usually used to describe the parameters in the commands.
Braces { }
The parameters enclosed in the braces are optional and can be ignored or set for one or more times. For
example,
In the [:SENSe]:CORRection:CSET<n>:DATA <freq>,<rel_ampl>{,<freq>,<rel_ampl>} command, the
frequency and amplitude in {,<freq>,<rel_ampl>} can be omitted or be set to one or more values.
Vertical Bar |
The vertical bar is u sed to separ ate multip le par ameter s and o ne of the par ameters mu st be selec ted when
sending the command. For example,
In the :DISPlay:ANNotation:CLOCk[:STATe] OFF|ON|0|1 command, the command parameters a vailabl e are
"OFF", "ON", "0" or "1".
Square Brackets [ ]
The content (command keyword) enclosed in the square brackets can be omitted. For example,
for the [:SENSe]:POWer[:RF]:ATTenuation? command, sending any of the four commands below can
generate the same effect:
:POWer:ATTenuation?
:POWer:RF:ATTenuation?
:SENSe:POWer:ATTenuation?
:SENSe:POWer:RF:ATTenuation?
Triangle Brackets < >
The parameter enclosed in the triangle brackets must be replaced by an effective value. For example,
send the :DISPlay:BRIGhtness <integer> command in :DISPlay:BRIGhtness 5 format.
1-2 DSA700 Programming Guide
Chapter 1 SCPI Overview RIGOL
Parameter Type
The command parameters introduced in this manual include 6 types: Bool, Keyword, Integer, Consecutive
Real Number, Discrete and ASCII String.
Bool
The parameter could be "OFF", "ON", "0" or "1". For example,
:DISPlay:ANNotation:CLOCk[:STATe] OFF|ON|0|1
Keyword
The parameter could be any of the values listed. For example,
:DISPlay:AFUnction:POSition BOTTom|CENTer|TOP
The parameter could be "BOTTom", "CENTer" or "TOP".
Integer
Unless otherwise noted, the parameter c an be any integer within the effective value range. Note that do not
set the parameter to a decimal; otherwise errors will occur. For example,
:DISPlay:BRIGhtnes s <integer>
<integer> can be set to any integer between 0 and 10.
Consecutive Real Number
The parameter could be any value within the effective value range according to the accuracy requirement
(by default, there are 6 digits after the decimal points). For example,
:CALCulate:BANDwidth:NDB <rel_ampl>
<rel_ampl> can be set to any real number between -100 and 100.
Discrete
The parameter could on ly be one of th e specified values and these v alues are di scon tinu ous. F o r ex ample,
:CALCulate:MARKer<n>:MAXimum:MAX
<n> could only be set to 1, 2, 3 or 4.
ASCII String
The parameter should be the combinations of ASCII characters. For example,
:SYSTem:DATE <year>,<month>,<day>
The parameter is a string in the specified date format.
Command Abbreviation
Since all the commands are case-insensitive, you can use any of them. But if abbreviation is used, all the
capital letters in the command must be written completely. For example,
:CALCulate:BANDwidth:NDB? can be abbreviated to :CALC:BAND:NDB?
DSA700 Programming Guide1-3
Chapter 2 Command System RIGOL
Chapter 2 Command System
In this chapter, the DSA700 series spectrum analyzer comm and subsystems are introduced in alphabetical
order (from A to Z).
1. In this command set, commands relating to Quasi-peak detector, EMI filter, advanced measurement,
Sig Capture and TX1000 are only applicable to DSA700 installed with the corresponding options. For
the details, refer to the explanation in each command subsystem.
2. In this command set, unless otherwise noted, the query returns "N/A" (quotation marks excluded) if
the corresponding option is not installed and returns "ERR" (quotation marks excluded) if th e
corresponding fu nction is not enabled or the type does not match.
3. In this manual, the parameter ranges of the commands are based on DSA710.
DSA700 Programming Guide2-1
RIGOL Chapter 2 Command System
:ABORt
Syntax
:ABORt
Description
Give up the current operation and restart the sweep.
Set the value of N in N dB bandwidth measurement.
Query the value of N in N dB bandwidth measurement.
Parameter
<rel_ampl> Consecutive Real Number -100 dB to 100 dB -3 dB
Return Format
The query returns the value of N in scientific notation.
Example
The command below sets N to -4.
:CALCulate:BANDwidth:NDB -4
The query below returns -4.000000E+00.
:CALCulate:BANDwidth:NDB?
:CALCulate:BANDwidth:RESult?
Syntax
:CALCulate:BANDwidth:RESult?
Description
Query the measurement result of N dB bandwidth and the unit is Hz.
Return Format
The query returns the bandwidth in integer (in Hz).
If points that are located on both sides of the current marker and with N dB fall or rise in amplitude are not
found, the query returns ----.
Set the X axis to denote frequency or time in the Pass/Fail test.
Query the type of the X axis in the Pass/Fail test.
Parameter
Explanation
This setting is applicable to both the upper and lower limit lines.
All the points of the current limit line will be deleted when the X axis type is changed.
Return Format
The query returns FREQ or TIME.
Example
The command below sets the X axis to time.
:CALCulate:LLI Ne: C ON Tro l : DOM ai n TIME
The query below returns TIME.
:CALCulate:LLINe:CONTrol:DOMain?
-- Keyword FREQuency|TIME FREQuency
:CALCulate:LLINe:FAIL?
Syntax
:CALCulate:LLINe:FAIL?
Description
Query the result of the Pass/Fail test.
Return Format
The query returns PASS or FAIL. The quer y returns UNMEAS if the test is not finis hed.
DSA700 Programming Guide2-5
RIGOL Chapter 2 Command System
Name
Type
Range
Default
--
Bool
OFF|ON|0|1
ON|1
:CALCulate:LLINe:FAIL:RATIo?
Syntax
:CALCulate:LLINe:FAIL:RATIo?
Description
Query the fail ratio of the Pass/Fail test.
Return Format
The query returns the fail ratio in scientific notation.Example
The query below returns 5.490000E+00.
:CALCulate:LLINe:FAIL:RATIo?
Set whether to stop the test if the test fails.
Query whether to stop the test if the test fails.
Parameter
Explanation
If the parameter is set to ON or 1, the test sto ps when the test fail s and the test continu es if the parameter
is set to OFF or 0.
Return Format
The query returns 0 or 1.
Example
The command below sets the instrument to stop the test when the test fails.
:CALCulate:LLINe:FAIL:STOP:STATe ON or :CALCu la t e:LLI Ne : FAI L :S TOP: STATe 1
The query below returns 1.
:CALCulate:LLINe:FAIL:STOP:STATe?
Set the frequency interpolation mode in the Pass/Fail test to log or linear.
Query the frequency interpolation mode.
Parameter
Explanation
<n> denotes the lower limit line (1) or upper limit line (2).
In log mode, both the frequency and amplitude use log unit to make interpolation operation.
In linear mode, the frequency uses a linear unit and the amplitude uses a log unit for interpolation
operation.
Return Format
The query returns LOG or LIN.
Example
The command below sets the frequency interpolation mode of the lower limit line to log.
:CALCulate:LLINe1:CONTrol:INTerpolate:TYPE LOGarithmic
The query below returns LOG.
:CALCulate:LLINe1:CONTrol:INTerpolate:TYPE?
Create a limit line of the Pass/Fail test.
Query the limit line information.
Parameter
<x-axis>
<ampl>
<connected>
Explanation
<n>: denote the lower limit line (1) or upper limit line (2).
<x-axis>: the frequency or time (depend on the X axis type) of the point being edited.
<ampl>: the amplitude of the point being edited.
DSA700 Programming Guide2-7
Real Number
Consecutive
Real Number
Discrete 0|1 0
0 us to 1 ks (the X axis denotes time)
-400 dBm to 320 dBm --
--
RIGOL Chapter 2 Command System
Name Type
Range
Default
<connected>
Discrete
0|1
0
<connected>: whether to connect the current point with the previous one. 1 denotes yes and 0 denotes no.
Note that for the first point, only 0 is available.
Up to 200 points can be edited for each limit line.
Return Format
The query returns the specified limit line information in
<x-axis>,<ampl>,<connected>{,<x-axis>,<ampl>,<connected>} format.
If no point is edited of the specified limit line, the query returns NULL.
Example
The command below creates an upper limit line wit h 3 points.
:CALCulate:LLI Ne2 :DATA 50,100,0,10 0,1 50 ,1, 20 0, 20 0, 1
The query below returns 50,100.000000,0,100,150.000000,1,200,200.000000,1.
:CALCulate:LLINe2:DATA?
In the Pass/Fail test, add points onto the limit line being edited.
Parameter
<n> Discrete 1|2 2
<x-axis>
<ampl>
Consecutive
Real Number
Consecutive
Real Number
0 Hz to 1 GHz (X axis denotes frequency)
0 us to 1 ks (X axis denotes time)
-400 dBm to 320 dBm --
--
Explanation
<n>: denote the lower limit line (1) or upper limit line (2).
<x-axis>: the frequency or time (depend on the X axis type) of the point being edited.
<ampl>: the amplitude of the point being edited.
<connected>: whether to connect the current point with the previous one. 1 denotes yes and 0 denotes no.
Note that for the first point, only 0 is available.
Up to 200 points can be edited for each limit line.
Example
The command below adds two points onto the upper limit line.
:CALCulate:LLINe2:DATA:MERG 250,200,1,30 0,250,1
2-8 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
Name
Type
Range
Default
<n>
Discrete
1|2
--
--
Bool
OFF|ON|0|1
OFF|0
:CALCulate:LLINe<n>:DELete
Syntax
:CALCulate:LLINe<n>:DELete
Description
Delete the specified limit line of the Pass/Fail test.
Parameter
Explanation
<n> denotes the lower limit line (1) or the upper limit line (2).
Example
The command below deletes the lower limit line.
:CALCulate:LLINe1:DELete
Enable or disable the REL Amplitude.
Query the status of the REL Amplitude.
Parameter
Explanation
<n> denotes the lower limit line (1) or upper limit line (2).
When the REL Amplitude is enabled, the amplitude set is the difference between the amplitude of the
current point and the current reference level.
Return Format
The query returns 0 or 1.
Example
The command below enables the REL Amplitude.
:CALCulate:LLINe1:RELAmpt:STATe ON or :CALCulate:LLINe1:RELAmpt:STATe 1
The query below returns 1.
:CALCulate:LLINe1:RELAmpt?
Enable or disable the REL Frequency.
Query the status of the REL Frequency.
Parameter
<n> Discrete 1|2 --
-- Bool OFF|ON|0|1 OFF|0
Explanation
<n> denotes the lower limit line (1) or upper limit line (2).
When the REL Frequency is enabled, the frequency set is the difference between the frequency of the
current point and the current center fr equency.
Return Format
The query returns 0 or 1.
Example
The command below enables the REL Frequency.
:CALCulate:LLINe1:RELFreq:STATe ON or :CALCulate:LLINe1:RELFreq:STATe 1
The query below returns 1.
:CALCulate:LLINe1:RELFreq?
Set the resolution of the frequency counter.
Query the resolution of the frequency counter.
Parameter
Explanation
When <freq> is set in "Number" format, the default unit is Hz. It can also be set in "Number+Unit" format;
for example, 1 kHz.
Use the
mode.
Return Format
The query returns the resolution in integer and the unit is Hz.
Example
The command below sets the resolution of the frequency counter to 1 kHz.
:CALCulate:MARKer:FCOunt:RESolution 1000 or :CALCulate:MARKer:FCOunt:RE So luti on 1kHz
The query below r eturns 1000.
:CALCulate:MARKer:FCOunt:RESolution?
Set the resolution of the frequency counter automatically.
Query the status of the auto setting of the resolution of the frequency counter.
Parameter
Name Type Range Default
-- Bool OFF|ON|0|1 ON|1
Return Format
The query returns 0 or 1.
Example
The command below disables the auto setting of the resolution of the frequency counter.
:CALCulate:MARKer:FCOunt:RESolution:AUTO OFF or :CALCulate:MARKer:FCOunt:RESolution:AUTO 0
The query below returns 0.
:CALCulate:MARKer:FCOunt:RESolution:AUTO?
:CALCulate:MARKer:FCOunt:X?
Syntax
:CALCulate:MARKer:FCOunt:X?
Description
Query the reading o f the frequency counter.
Return Format
The query returns the reading in integer and the unit is Hz.
The query returns 9000000000000000 when the frequency counter is disabled.
Enable continuous p eak search and mark the peak using the s pecified marker or disable continuous peak
search.
Query the status of continuous peak search.
Parameter
Return Format
The query returns 0 or 1.
Example
The command below enables continuous peak search and marks the peak using marker 2.
:CALCulate:MARKer2:CPEak:STATe ON or :CALCulate:MARKer2:CPEak:STATe 1
The query below returns 1.
:CALCulate:MARKer2:CPEak:STATe?
<n> Discrete 1|2|3|4 1
-- Bool OFF|ON|0|1 OFF|0
DSA700 Programming Guide2-13
RIGOL Chapter 2 Command System
Name
Type
Range
Default
:CALCulate:MARKer<n>:DELTa[:SET]:CENTer
Syntax
:CALCulate:MARKer<n>:DELTa[:SET]:CENTer
Description
Set the center frequency of the s pec tru m anal yz er to the fr equ ency diff erence of the spec if i ed D elta, Del ta
Pair or Span Pair marker.
Parameter
Explanation
Use the :CALCulate:MARKer<n>:MODE command to select Delta, Delta Pair or Span Pair marker.
This function is invalid in zero span mode.
Example
The command below sets the cen ter frequency to the f requency difference of marker 1 (Delta Pair mark er).
:CALCulate:MARKer1:DELTa:SET:CENTer
<n> Discrete 1|2|3|4 --
:CALCulate:MARKer<n>:DELTa[:SET]:SPAN
Syntax
:CALCulate:MARKer<n>:DELTa[:SET]:SPAN
Description
Set the span of the spectrum analyzer to the frequency diff erence of the specified Delta, Delta Pair or Span
Pair marker.
Parameter
Explanation
Use the
This function is not available in zero span mode.
Example
The command below sets the span of the spectrum analy zer to the fr equency difference of marker 1 (Delta
Pair marker).
:CALCulate:MARKer1:DELTa:SET:SPAN
Name
<n> Discrete 1|2|3|4 --
:CALCulate:MARKer<n>:MODE command to select Delta, Delta Pair or Span Pair marker.
Set the peak search mode.
Query the peak search mode.
Parameter
Explanation
PARameter: parameter. Search and mark the peak which meets the search parameter conditions (peak
excursion and peak threshold).
MAXimum: maximum. Search and mark the maximum on the trace.
This command applies only to the peak search executed by sending
:CALCulate:MARKer<n>:MAXimum:MAX command, while other searches (Next Peak, Peak Right, Peak
the
Left and Min Search) are not limited by it.
Return Format
The query returns PAR or MAX.
2-18 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
<n>
Discrete
1|2|3|4
--
Name
Type
Range
Default
Example
The command below sets the peak search mode of trace 1 to parameter an d marks the peak usi ng marker
1.
:CALCulate:MARKer1:PEAK:SEARch:MODE PARameter
The query below returns PAR.
:CALCulate:MARKer1:PEAK:SEARch:MODE?
:CALCulate:MARKer<n>:PEAK[:SET]:CF
Syntax
:CALCulate:MARKer<n>:PEAK[:SET]:CF
Description
Execute a peak search (mark the peak using the specified marker) and set the center frequency of the
spectrum analyzer to the frequency of the current peak.
Parameter
Example
The command below executes a peak search (marks the peak using marker 1) and sets the center
frequency of the spectrum analyzer to the frequency of the current peak.
:CALCulate:MARKer1:PEAK:SET:CF
Set the peak threshold and the unit is dBm.
Query the peak threshold.
Parameter
<n> Discrete 1|2|3|4 --
<ampl> Consecutive Real Number -200 dBm to 0 dBm -90 dBm
Return Format
The query returns the peak threshold in scientific notation.
Example
The command below sets the peak threshold of marker 1 to -100 dBm.
:CALCulate:MARKer1:PEAK:THReshold -100
The query below returns -1.000000E+02.
:CALCulate:MARKer1:PEAK:THReshold?
DSA700 Programming Guide2-19
RIGOL Chapter 2 Command System
Name
Type Range
Default
Name
Type
Range
Default
<n>
Discrete
1|2|3|4
--
:CALCulate:MARKer<n>:PTPeak
Syntax
:CALCulate:MARKer<n>:PTPeak
Description
Execute peak-peak search and mark the peak using the specified marker.
Parameter
<n> Discrete 1|2|3|4 --
Explanation
The marker type of the specified marker will a utom atically change to Delta Pair after executing this
command. The reference marker and delta marker are used to mark the peak-peak positions respectively.
Example
The command below executes peak-peak search. The reference marker 1R and delta marker 1 mark the
peak-peak positions respectively.
:CALCulate:MARKer1:PTPeak
:CALCulate:MARKer<n>[:SET]:CENTer
Syntax
:CALCulate:MARKer<n>[:SET]:CENTer
Description
Set the center frequency of the spectrum analyzer to the frequency of the specified marker.
Parameter
Explanation
If the specified marker is Normal marker, the center frequency will be set to the frequency of the marker.
If the specified marker is Delta, Delta Pair or Span Pair marker, the center frequency will be set to the
frequency of the delta marker.
This command is only available when the specified marker is enabled.
This function is invalid in zero span mode.
Example
The command below sets the center frequency of the spectrum analyze to the frequency of marker 1
(Normal marker).
:CALCulate:MARKer1:SET:CENTer
2-20 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
:CALCulate:MARKer<n>[:SET]:RLEVel
Syntax
:CALCulate:MARKer<n>[:SET]:RLEVel
Description
Set the reference level of the spectrum analyzer to the amplitude of the specified marker.
Parameter
Name
<n> Discrete 1|2|3|4 --
Explanation
If the specified marker is Normal marker, the reference level will be set to the amplitude of the marker.
If the specified marker is Delta, Delta Pair or Span Pair marker, the reference level will be set to the
amplitude of the delta marker.
This command is only available when the specified marker is enabled.
Example
The command below sets the reference level of the spectrum analyzer to the amplitude of marker 2
(Normal marker).
:CALCulate:MARKer2:SET:RLEVel
Type Range Default
:CALCulate:MARKer<n>[:SET]:STARt
Syntax
:CALCulate:MARKer<n>[:SET]:STARt
Description
Set the start frequency of the spectrum analyzer to the frequency of the specified marker.
Parameter
<n> Discrete 1|2|3|4 --
Explanation
If the specified marker is Normal marker, the start frequency will be set to the frequency of the marker.
If the specified marker is Delta, Delta Pair or Span Pair marker, the start frequency will be set to the
frequency of the delta marker.
This command is only available when the specified marker is enabled.
This function is invalid in zero span mode.
Example
The command below sets the start frequency of the spectrum analyzer to the frequency of marker 3
(Normal marker).
:CALCulate:MARKer3:SET:STARt
DSA700 Programming Guide2-21
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Name
Type
Range
Default
:CALCulate:MARKer<n>[:SET]:STEP
Syntax
:CALCulate:MARKer<n>[:SET]:STEP
Description
Set the center frequency step of the spectrum analyzer to the frequency of the specified marker.
Parameter
<n> Discrete 1|2|3|4 --
Explanation
If the specified marker is Normal marker, the center frequency step will be set to the frequency of the
marker.
If the specified marker is Delta, Delta Pair or Span Pair marker, the center frequency step wil l be set to the
frequency of the delta marker.
This command is only available when the specified marker is enabled.
This function is invalid in zero span mode.
Example
The command below sets the c enter f requency step of the spec trum an alyzer to the fr equency of marker 4
(Normal marker).
:CALCulate:MARKer4:SET:STEP
:CALCulate:MARKer<n>[:SET]:STOP
Syntax
:CALCulate:MARKer<n>[:SET]:STOP
Description
Set the stop frequency of the spectrum analyzer to the frequency of the specified marker.
Parameter
<n> Discrete 1|2|3|4 --
Explanation
If the specified marker is Normal marker, the stop frequency will be set to the frequency of the marker.
If the specified marker is Delta, Delta Pa ir or Spa n Pair marker, the stop frequency will be set to the
frequency of the delta marker.
This command is only available when the specified marker is enabled.
This function is invalid in zero span mode.
Example
The command below sets the stop frequency of the spectrum analyzer to the frequency of marker 2
(Normal marker).
:CALCulate:MARKer2:SET:STOP
Set the trace to be marked by the specified marker.
Query the marker trace of the specified marker.
Parameter
Name
Type Range Default
Explanation
<integer> denotes the trace selected and can be tr ace 1 , trace 2 , trac e 3 or tr ace 4 (math trace). The tr ace
selected must have been enabled.
You can also use the
specified marker to Auto.
Return Format
The query returns 1, 2, 3 or 4.
If the marker trace is set to Auto, the query returns the number of the trace marked by the marker.
DSA700 Programming Guide2-23
:CALCulate:MARKer<n>:TRACe:AUTO command to set the marker trace of the
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Example
The command below sets the marker trace of marker 1 to trace 2.
:CALCulate:MARKer1:TRACe 2
The query below returns 2.
:CALCulate:MARKer1:TRACe?
Set the marker trace of the specified marker to Auto.
Query whether the marker trace is set to Auto.
Parameter
<n> Discrete 1|2|3|4 --
-- Bool OFF|ON|0|1 ON|1
Explanation
When AUTO is disabled, the current marker will hold on the corresponding trace.
Return Format
The query returns 0 or 1.
Example
The command below sets the marker trace of marker 1 to Auto.
:CALCulate:MARKer1:TRACe:AUTO ON or :CALCulate:MARKer1:TRACe:AUTO 1
The query below returns 1.
:CALCulate:MARKer1:TRACe:AUTO?
2-24 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
<param>
Consecutive Real Number
Refer to Explanation
--
:CALCulate:MARKer<n>:X
Syntax
:CALCulate:MAR Ker<n >: X <pa ra m>
:CALCulate:MARKer<n>:X?
Description
Set the X-axis value of the specified ma r ker and the default unit is Hz.
Query the X-axis value of the specified marker.
Parameter
<n> Discrete 1|2|3|4 --
Explanation
<param> can be any value within the range currently available of the X axis.
If the readout mode is frequency, it cannot exceed the frequency range of the sweep and the units
available are Hz (default), kHz, MHz and GHz.
If the readout mode is time, it cannot exceed the time range of the sweep and the units available are s
(default), us, ms and ks.
If the specified marker type is Normal, this command sets the X value of the marker.
If the specified marker type is Delta, this command sets the X value of the delta marker relative to the
reference marker.
If the specified marker type is Delta Pair, this command sets the X value of the reference or delta marker
according to the current menu state.
If the specified marker type is Span Pair, this command sets the X value of the span or center of the
reference marker and delta marker according to the current menu state.
Return Format
When the readout mode is frequency or the reciprocal of time, the query returns the X-axis value of the
marker in integer.
When the readout mode is time or period, the query returns the X-axis value of the marker in scientific
notation.
Example
The command below sets the X-axis value of marker 1 to 150 MHz (the readout mode is frequency).
:CALCulate:MARKer1:X 15000000
Set the X-axis center value of the specified Span Pair marker.
Query the X-axis center value of the specified Span Pair marker.
Parameter
<n> Discrete 1|2|3|4 --
Explanation
<param> can be any value within the range currently available of the X axis.
If the readout mode is frequency, it cannot exceed the frequency range of the sweep and the units
available are Hz (default), kHz, MHz and GHz.
If the readout mode is time, it cannot exceed the time range of the sweep and the units available are s
(default), us, ms and ks.
Return Format
When the readout mode is frequency, the query returns the X-axi s center value of the mark er in integer and
the unit is Hz.
When the readout mode is time or period, the query returns the X-axis center value of the marker in
scientific notation and the unit is s.
Example
The command below sets the X-axis center value of marker 1 (Span Pair marker) to 1500000000 Hz (the
readout mode is frequency).
:CALCulate:MARKe1:X:CENTer 1500000000 or :CALCulate:MARKe1:X:CENTer 1.5GHZ
The query below returns 1500000000.
:CALCulate:MARKe1:X:CENTer?
Set the number of points corresponding to the span of the specified Span Pair marker.
Query the number of points corresponding to the span of the specified Span Pair marker.
Parameter
<n> Discrete 1|2|3|4 --
<param> Integer 0 to 600 0
Return Format
The query returns the number of points corresponding to t he span of the specified Span Pair marker in
integer.
Example
The command below sets the number of points corresponding to the span of marker 1 (Span Pair marker)
to 150.
:CALCulate:MARKer1:X:POSition:SPAN 150
The query below returns 150.
:CALCulate:MARKer1:X:POSition:SPAN?
Set the position of the reference marker of the specified Delta Pair marker.
Query the position of the reference marker of the specified Delta Pair marker.
Parameter
<n> Discrete 1|2|3|4 --
<param> Integer 0 to 600 300
Return Format
The query returns the position of the reference marker in integer.
Example
The command below sets the position of the reference marker of marker 1 (Delta Pair marker) to 100.
:CALCulate:MARKer1:X:POSition:STARt 100
The query below returns 100.
:CALCulate:MARKer1:X:POSition:STARt?
Set the readout mode of the X axis of the specified marker.
Query the readout mode of the X axis of the specified marker.
Parameter
Name
<n> Discrete 1|2|3|4 --
Explanation
FREQuency: frequency. The default readout mode in non-zero span mode.
TIME: time. The default readout mode in zero span mode.
ITIMe: the reciprocal of time. Only available in zero span mode when Delta Pair marker is used.
PERiod: period. Not available in zero span mode.
Return Format
The query returns FREQ, TIME, ITIM or PER.
Example
The command below sets the readout mode of the X axis of marker 1 to time.
:CALCulate:MARKer1:X:READout TIME
The query below returns TIME.
:CALCulate:MARKer1:X:READout?
TypeRangeDefault
-- Keyword FREQuency|TIME|ITIMe|PERiod Refer to Explanation
DSA700 Programming Guide2-29
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Name
Type
Range
Default
<n>
Discrete
1|2|3|4
--
:CALCulate:MARKer<n>:X:SPAN
Syntax
:CALCulate:M AR Ker<n >: X: SPAN <pa ram >
:CALCulate:MARKer<n>:X:SPAN?
Description
Set the X value corresponding to the span of the specified Span Pair marker.
Query the X value corresponding to the span of the specified Span Pair marker.
Parameter
<n> Discrete 1|2|3|4 --
<param> Consecutive Real Number Refer to Explanation0
Explanation
<param> can be any value within the range currently available of the X axis.
If the current readout mo de is f requen cy, it c annot exceed th e frequ ency ran ge of the sweep and the u nits
available are Hz (default), kHz, MHz and GHz.
If the current readout mode is time, it cannot exceed the time range of the sweep and the units available
are s (default), us, ms and ks.
Return Format
When the readout mode is frequency, the query returns the X value of the span of the marker in integer
and the unit is Hz.
When the readout mode is time or period, the query returns the X value of the span of the marker in
scientific notation and the unit is s.
Example
The command below sets the X value of the span of marker 1 (Span Pair marker) to 500 MHz (the readou t
mode is frequency).
:CALCulate:MARKer1:X:SPAN 500000000
The query below returns 500000000.
:CALCulate:MARKer1:X:SPAN?
Set the X value of the reference marker of the specified Delta Pair marker.
Query the X value of the reference marker of the specified Delta Pair marker.
Parameter
<param> Consecutive Real Number Refer to Explanation --
Explanation
<param> can be any value within the range currently available of the X axis.
2-30 DSA700 Programming Guide
Chapter 2 Command System RIGOL
If the current readout mo de is f requen cy, it c annot exceed th e frequ ency ran ge of the sweep and the u nits
available are Hz (default), kHz, MHz and GHz.
If the current readout mode is time. it cannot exceed the time range of the sweep and the units available
are s (default), us, ms and ks.
Return Format
When the readout mode is frequ ency, th e query retu rns the X v alue of th e reference marker in in teger and
the unit is Hz.
When the readout mode is time or period, th e query returns the X value of the reference mark er in scientific
notation and the unit is s.
Example
The command below sets the X value of the reference marker of mark er 1 (Delta Pair mark er) to 750 MHz
(the readout mode is frequency).
:CALCulate:MARKer1:X:STARt 750000000
The query below returns 750000000.
:CALCulate:MARKer1:X:STARt?
Set the X value of the delta marker of the specified Delta Pair marker.
Query the X value of the delta marker of the specified Delta Pair marker.
Parameter
Name
<n> Discrete 1|2|3|4 --
<param> Consecutive Real Number Refer to Explanation--
Explanation
<param> can be any value within the range currently available of the X axis.
If the current readout mo de is f requen cy, it c annot exceed th e frequ ency ran ge of the sweep and the u nits
available are Hz (default), kHz, MHz and GHz.
If the current readout mode is time, it cannot exceed the time range of the sweep and the units available
are s (default), us, ms and ks.
Return Format
When the readout mode is frequency, th e query retu rns the X valu e of th e delta marker in integer and th e
unit is Hz.
When the readout mode is time or period, the query returns the X value of the delta marker in s cientific
notation and the unit is s.
Example
The command below sets the X v alu e of th e del ta marker o f mark er 1 (Del ta Pair mark er) to 350 MHz (the
readout mode is frequency).
:CALCulate:MARKer1:X:STOP 350000000
The query below returns 350000000.
:CALCulate:MARKer1:X:STOP?
TypeRangeDefault
DSA700 Programming Guide2-31
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Name
Type
Range
Default
--
Bool
OFF|ON|0|1
OFF|0
:CALCulate:MARKer<n>:Y?
Syntax
:CALCulate:MARKer<n>:Y?
Description
Query the Y-axis value of the specified marker and the default unit is dBm.
Parameter
<n> Discrete 1|2|3|4 --
Explanation
If the specified marker is normal marker, query the Y value of the marker.
If the specified marker is Delta, Delta Pair or Span Pair marker, query the Y-axis difference between the
reference marker and the delta marker.
Return Format
The query returns the Y-axis value in scientific notation.
Example
The query below r eturns 5.960000E+00.
:CALCulate:MARKer1:Y?
Enable or disable the signal track.
Query the status of the signal track.
Parameter
-- Bool OFF|ON|0|1 OFF|0
Explanation
When signal track is enabled, the instrument wil l execute a peak search after each sweep and set the cen ter
frequency to the frequency of the current peak to hold the signal at the center of the screen.
Return Format
The query returns 0 or 1.
Example
The command below enables the signal track.
:CALCulate:MARKer:TRACKing:STATe ON or :CALCulate:MARKer:TRACKing:STATe 1
The query below returns 1.
:CALCulate:MARKer:TRACKing:STATe?
DSA700 Programming Guide2-33
RIGOL Chapter 2 Command System
Name Type
Range
Default
:CALibration Subsystem
Command List:
:CALibration:[ALL]
:CALibration:AUTO
:CALibration:[ALL]
Syntax
:CALibration:[ALL]
Description
Execute self-calibration immediately.
Example
The command below makes the instrument execute self-calibration immediately.
:CALibration:ALL
:CALibration:AUTO
Syntax
:CALibration:AUTO OFF|ON|0|1
:CALibration:AUTO?
Description
Enable or disable auto calibration.
Query the status of auto calibration.
Parameter
Explanation
By default, auto calibration is enabled. But the instrument w ill use the last setting at the next power-on if
users change this setting.
Return Format
The query returns 0 or 1.
Example
The command below enables auto calibration.
:CALibration:AUTO ON or :CALibration:AUTO 1
Commands marked with "*" are only available for DSA700 installed with the advanced measurement kit
(option).
*
*
:CONFigure?
Syntax
:CONFigure?
Description
Query the current measurement function.
Return Format
The query returns OFF, TPOW, ACP, CHP, OBW, EBW, CNR, HD, TOI or PF.
:CONFigure:ACPower
Syntax
:CONFigure:ACPower
Description
Set the spectrum analyzer to the adjacent channel power measurement state.
Explanation
This command stops the current measurem ent and sets the instr ument to the def ault state of the specified
measurement.
When any of the measuremen t settin gs is changed, use the
without restoring it to the default value.
:READ command to in itiali ze the measu rement
DSA700 Programming Guide2-35
RIGOL Chapter 2 Command System
:CONFigure:CHPower
Syntax
:CONFigure:CHPower
Description
Set the spectrum analyzer to the channel power measurement state.
Explanation
This command stops the current measurem ent and sets the instr ument to the def ault state of the specified
measurement.
When any of the measurement settings is changed, use the
without restoring it to the default value.
:READ command to in itialize t he measur ement
:CONFigure:CNRatio
Syntax
:CONFigure:CNRatio
Description
Set the spectrum analyzer to the C/N ratio measurement state.
Explanation
This command stops the current measuremen t and sets the instru ment to the default s tate of the specified
measurement.
When any of the measurement settings is changed, use the
without restoring it to the default value.
:READ command to in itiali ze the measu rement
:CONFigure:EBWidth
Syntax
:CONFigure:EBWidth
Description
Set the spectrum analyzer to the emission bandwidth measurement state.
Explanation
This command stops the current measurem ent and sets the instr ument to the def ault state of the specified
measurement.
When any of the measurement settings is changed, use the
without restoring it to the default value.
:READ command to in itiali ze the measu rement
2-36 DSA700 Programming Guide
Chapter 2 Command System RIGOL
:CONFigure:HDISt
Syntax
:CONFigure:HDISt
Description
Set the spectrum analyzer to the harmonic distortion measurement state.
Explanation
This command stops the current measurem ent and sets the instr ument to the def ault state of the specified
measurement.
When any of the measurement settings is changed, use the
without restoring it to the default value.
:READ command to in itiali ze the measu rement
:CONFigure:OBWidth
Syntax
:CONFigure:OBWidth
Description
Set the spectrum analyzer to the occupied bandwidth measurement state.
Explanation
This command stops the current measurement and sets the instrument to the default st ate of the specified
measurement.
When any of the measurement settings is changed, use the
without restoring it to the default value.
:READ command to in itialize th e measuremen t
:CONFigure:PF
Syntax
:CONFigure:PF
Description
Enable the Pass/Fail test function.
:CONFigure:SANalyzer
Syntax
:CONFigure:SANalyzer
Description
This command will disable the current measurement function and set the spectrum analyzer to sweep
mode.
DSA700 Programming Guide2-37
RIGOL Chapter 2 Command System
:CONFigure:TOI
Syntax
:CONFigure:TOI
Description
Set the spectrum analyzer to the TOI measurement state.
Explanation
This command stops the current measurem ent and sets the instr ument to the def ault state of the specified
measurement.
When any of the measurement settings is changed, use the
without restoring it to the default value.
:READ command to in itiali ze the measu rement
:CONFigure:TPOWer
Syntax
:CONFigure:TPOWer
Description
Set the spectrum analyzer to the T-power measurement state.
Explanation
This command stops the current measurem ent and sets the instr ument to the def ault state of the specified
measurement.
When any of the measurement settings is changed, use the
without restoring it to the default value.
:READ command to in itiali ze the measu rement
2-38 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
--
Keyword
ALL|NONE
ALL
:COUPle Subsystem
Command List:
:COUPle
:COUPle
Syntax
:COUPle ALL|NONE
:COUPle?
Description
Set all the related parameters automatically according to the coupling relationship.
Query the status of the coupling linked setting.
Parameter
Explanation
The following parameters have coupling relationships.
CF step
Reference level
Input attenuation
Resolution bandwidth (RBW)
Video bandwidth (VBW)
Sweep time
Return Format
The query returns AL L or NONE.
Example
The command below disables the linked setting of parameters that have coupling relationships.
:COUPle NONE
Enable or disable the display of the time and date.
Query the status of the display of the time and date.
Parameter
-- Bool OFF|ON|0|1 ON|1
Return Format
The query returns 0 or 1.
Example
The command below enables the display of the time and date.
:DISPlay:ANNotation:CLOCk:STATe ON or :DISPlay:ANNotation:CLOCk:STATe 1
The query below returns 1.
:DISPlay:ANNotation:CLOCk:STATe?
DSA700 Programming Guide2-41
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Name
Type
Range
Default
--
Bool
OFF|ON|0|1
ON|1
:DISPlay:BRIGhtness
Syntax
:DISPlay:BRIGhtnes s <integer>
:DISPlay:BRIGhtness?
Description
Set the screen brightness.
Query the screen bri ghtness.
Parameter
<integer> Integer 0 to 7 2
Return Format
The query returns the brightness in integer.
Example
The command below sets the brightness to 6.
:DISPlay:BRIGhtness 6
The query below returns 6.
:DISPlay:BRIGhtness?
:DISPlay:ENABle
Syntax
:DISPlay:ENABle OFF|ON|0|1
:DISPlay:ENABle?
Description
Set the on/off state of the screen.
Query the on/off state of the screen.
Parameter
Explanation
When OFF|0 is selected, the screen is locked. At this point, the screen stops refreshing and the
measurement speed is improved. You can press Esc to unlock the screen.
Return Format
The query returns 0 or 1.
Example
The command below locks the screen.
:DISPlay:ENABle OFF or :DISPlay:ENABle 0
Enable or disable the display of the UserKey definition in the user interface.
Query whether the UserKey definition is displayed in the user interface.
Parameter
Return Format
The query returns 0 or 1.
Example
The command below enables the display of the UserKey definition in the user interface.
:DISPlay:UKEY:STATe ON or :DISPlay:UKEY:STATe 1
The query below returns 1.
:DISPlay:UKEY:STATe?
DSA700 Programming Guide2-43
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Name
Type
Range
Default
--
Keyword
LINear|LOGarithmic
LINear
:DISPlay:WINdow:TRACe:GRATicule:GRID
Syntax
:DISPlay:WINdow: TRA Ce :G R ATicule:GRID <integer>
:DISPlay:WINdow:TRACe:GRATicule:GRID?
Description
Set the brightness of the screen grid .
Query the brightness of the screen grid.
Parameter
<integer> Integer 0 to 10 3
Return Format
The query returns the brightness of the screen grid in integer.
Example
The command below sets the screen grid brightness to 2.
:DISPlay:WINdow:TRACe:GRATicule:GRID 2
The query below returns 2.
:DISPlay:WINdow:TRACe:GRATicule:GRID?
Set the position of the display line on the screen and the de fault unit is dBm.
Query the position of the display line.
Parameter
<ampl> Consecutive Real Number The current ampli tude range 0 dBm
Explanation
By default, the display line is disabled. When the display line is enabled for the first time, its position is 0
dBm. This parameter is not affected by the preset setting and always uses the last setting.
Return Format
The query returns the position of the display line in scientific notation.
Example
The command below sets the position of the display line to -10 dBm.
:DISPlay:WINdow:TRACe:Y:DLINe -10
The query below returns -1.000000E+01.
:DISPlay:WINdow:TRACe:Y:DLINe?
:DISPlay:WINdow:TRACe:Y:DLINe:STATe
Syntax
:DISPlay:WINdow:TRACe:Y:DLINe:STATe O F F |ON|0|1
:DISPlay:WINdow:TRACe:Y:DLINe:STATe?
Description
Enable or disable the display line.
Query the status of the display line.
Parameter
-- Bool OFF|ON|0|1 OFF|0
Return Format
The query returns 0 or 1.
Example
The command below enables the display line.
:DISPlay:WINdow:TRACe:Y:DLI Ne:STATe ON or :DISPlay:WINdow:TRACe:Y:DLINe:STATe 1
The query below returns 1.
:DISPlay:WINdow:TRACe:Y:DLINe:STATe?
The :FETCh commands are only available for DSA700 installed with the advanced measurement kit
(option).
2-48 DSA700 Programming Guide
Chapter 2 Command System RIGOL
:FETCh:ACPower?
Syntax
:FETCh:ACPower?
Description
Query the results of adjacent channel po wer measurement.
Explanation
This command is only available when the adjacent channel power measurement is enabled.
The power unit of the return values is the same with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns 5 values (main channel power, upper channel power as well as the power difference
between the upper channel and main channel (in dBc), the lower channel power as well as the power
difference between the lower channel and the main channel (in dBc)) in scientific notation (separated by
commas).
Example
The query below returns -5.150423E+01,-5.173441E+01, -2.301865E-01,-5.142665E+01,7.757568E-02.
:FETCh:ACPower?
:FETCh:ACPower:LOWer?
Syntax
:FETCh:ACPower:LOWer?
Description
Query the lower channel power of adjacent channel power measurement.
Explanation
This command is only available when the adjacent channel power measurement is enabled.
The power unit of the return value is the same with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the lower channel pow er in scientific notation.
Example
The query below returns -5.142665E+01.
:FETCh:ACPower:LOWer?
DSA700 Programming Guide2-49
RIGOL Chapter 2 Command System
:FETCh:ACPower:MAIN?
Syntax
:FETCh:ACPower:MAIN?
Description
Query the main channel power of adjacent channel power measurement.
Explanation
This command is only available when the adjacent channel power measurement is enabled.
The power unit of the return value is the same with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the main channel power in scientific notation.
Example
The query below returns -5.150423E+01.
:FETCh:ACPower:MAIN?
:FETCh:ACPower:UPPer?
Syntax
:FETCh:ACPower:UPPer?
Description
Query the upper channel power of adjacent channel power measurement.
Explanation
This command is only available when the adjacent channel power measurement is enabled.
The power unit of the return value is the s ame with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the upper channel power in scientific notation.
Example
The query below returns -5.173441E+01.
:FETCh:ACPower:UPPer?
2-50 DSA700 Programming Guide
Chapter 2 Command System RIGOL
:FETCh:CHPower?
Syntax
:FETCh:CHPower?
Description
Query the results of channel power measurement.
Explanation
This command is only available when the channel power measurement is enabled.
The power unit of the return values is the s ame with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the channel power and the power spectral density in scientific notation (separated by
comma).
Example
The query below returns -1.599480E+01,-7.900511E+01.
:FETCh:CHPower?
:FETCh:CHPower:CHPower?
Syntax
:FETCh:CHPower:CHPower?
Description
Query the channel p ower.
Explanation
This command is only available when the channel power measurement is enabled.
The power unit of the return value is the same with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the channel power in scientific notation.
Example
The query below returns -1.599480E+01.
:FETCh:CHPower:CHPower?
DSA700 Programming Guide2-51
RIGOL Chapter 2 Command System
:FETCh:CHPower:DENSity?
Syntax
:FETCh:CHPower:DENSity?
Description
Query the channel power spectral density.
Explanation
This command is only available when the channel power measurement is enabled.
The power unit of the return value is the same with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the channel power spectral density in scientific notation.
Example
The query below returns -7.900511E+01.
:FETCh:CHPower:DENSity?
:FETCh:CNRatio?
Syntax
:FETCh:CNRatio?
Description
Query the results of C/N ratio measurement.
Explanation
This command is only available when the C/N ratio measurement is enabled.
The power unit of the return values is the s ame with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the carrier power, noise power and C/N ratio (in dB) in scientific notation (separated by
commas).
Example
The query below returns -6.048788E+01,-6.186192E+01,1.374039E+00.
:FETCh:CNRatio?
2-52 DSA700 Programming Guide
Chapter 2 Command System RIGOL
:FETCh:CNRatio:CARRier?
Syntax
:FETCh:CNRatio:CARRier?
Description
Query the carrier power.
Explanation
This command is only available when the C/N ratio measurement is enabled.
The power unit of the return value is the same with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the carrier power in scientific notation.
Example
The query below returns -1.484203E+01.
:FETCh:CNRatio:CARRier?
:FETCh:CNRatio:CNRatio?
Syntax
:FETCh:CNRatio:CNRatio?
Description
Query the C/N ratio.
Explanation
This command is only available when the C/N ratio measurement is enabled.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the C/N ratio in scientific notation.
Example
The query below returns 8.956909E-02.
:FETCh:CNRatio:CNRatio?
DSA700 Programming Guide2-53
RIGOL Chapter 2 Command System
:FETCh:CNRatio:NOISe?
Syntax
:FETCh:CNRatio:NOISe?
Description
Query the noise power.
Explanation
This command is only available when the C/N ratio measurement is enabled.
The power unit of the return value is the same with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the noise power in scientific notation.
Example
The query below returns -1.442294E+01.
:FETCh:CNRatio:NOISe?
:FETCh:EBWidth?
Syntax
:FETCh:EBWidth?
Description
Query the result of emission bandwidth measurement.
Explanation
This command is only available when the emission bandwidth measurement is enabled.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the emission bandwidth in integer and the unit is Hz.
Example
The query below returns 50000.
:FETCh:EBWidth?
2-54 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
:FETCh:HARMonics:AMPLitude:ALL?
Syntax
:FETCh:HARMonics:AMPLitude:ALL?
Description
Query the amplitudes of the first 10 harmonics and the first harmonic is the fundamental waveform.
Explanation
This command is only available when the harmonic distortion measurement is enabled.
The amplitude unit of the return values is the same with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the amplitudes of the first 10 harmonics in scientific notation (separated by commas).
If the number of harmonics under measurement is less than 10, the harmonics that are not measured do
not have return va lues.
This command is only available when the harmonic distortion measurement is enabled.
The amplitude unit of the return value is the same with the current Y-axis unit.
The query returns --- when the harmonic read does not have data.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the amplitude of the specified harmonic in scientific notation.
Example
The query below returns -1.692102E+01.
:FETCh:HARMonics:AMPLitude? 1
DSA700 Programming Guide2-55
RIGOL Chapter 2 Command System
:FETCh:HARMonics[:DISTortion]?
Syntax
:FETCh:HARMonics[:DISTortion]?
Description
Query the percentage of the total harmonic distortion.
Explanation
This command is only available when the harmonic distortion measurement is enabled.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the percentage of the total harmonic distortion in scientific notation.
Example
The query below returns 2.490393E+02.
:FETCh:HARMonics:DISTortion?
:FETCh:HARMonics:FREQuency:ALL?
Syntax
:FETCh:HARMonics:FREQuency:ALL?
Description
Query the frequencies of the first 10 harmonics and the first harmonic is the fundamental waveform.
Explanation
This command is only available when the harmonic distortion measurement is enabled.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the frequencies of the first 10 h armonics in integ er (separated by commas ) and the unit
is Hz.
If the number of harmonics under measurement is less than 10, the harmonics that are not measured do
not have return va lues.
Example
The query below returns
45500000,91000000,136500000,182000000,227500000,273000000,318500000,364000000,409500000,4
55000000.
:FETCh:HARMonics:FREQuency:ALL?
2-56 DSA700 Programming Guide
Chapter 2 Command System RIGOL
:FETCh:HARMonics:FREQuency? <n>
Syntax
:FETCh:HARMonics:FREQuency? <n>
Description
Query the frequency of the specified harmonic.
Parameter
Name
<n> Integer 1 to 10 --
Explanation
This command is only available when the harmonic distortion measurement is enabled.
The query returns --- when the harmonic read does not have data.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the frequency of the specified harmonic in integer and the unit is Hz.
Example
The query below returns 45500000.
:FETCh:HARMonics:FREQuency? 1
Type Range Default
:FETCh:HARMonics:FUNDamental?
Syntax
:FETCh:HARMonics:FUNDamental?
Description
Query the frequency of the fundamental waveform.
Explanation
This command is only available when the harmonic distortion measurement is enabled.
This command is equivalent to the :FETCh:HARM oni cs: FR EQ uenc y? 1 command.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the frequency of the fundamental waveform in integer and the unit is Hz.
Example
The query below r eturns 45500000.
:FETCh:HARMonics:FUNDamental?
DSA700 Programming Guide2-57
RIGOL Chapter 2 Command System
:FETCh:OBWidth?
Syntax
:FETCh:OBWidth?
Description
Query the results of occupied bandwidth measurement.
Explanation
This command is only available when the occupied bandwidth measurement is enabled.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the occupied bandwidth (Hz) and the transmit frequency error (Hz) in integer (separated
by comma).
Example
The query below r eturns 1860000,20000.
:FETCh:OBWidth?
:FETCh:OBWidth:OBWidth?
Syntax
:FETCh:OBWidth:OBWidth?
Description
Query the occupied bandwidth.
Explanation
This command is only available when the occupied bandwidth measurement is enabled.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the occupied bandwidth in integer and the unit is Hz.
Example
The query below r eturns 1860000.
:FETCh:OBWidth:OBWidth?
2-58 DSA700 Programming Guide
Chapter 2 Command System RIGOL
:FETCh:OBWidth:OBWidth:FERRor?
Syntax
:FETCh:OBWidth:OBWidth:FERRor?
Description
Query the transmit frequency error.
Explanation
This command is only available when the occupied bandwidth measurement is enabled.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the transmit frequency error in integer and the unit is Hz.
Example
The query below r eturns 20000.
:FETCh:OBWidth:OBWidth:FERRor?
:FETCh:TOIntercept?
Syntax
:FETCh:TOIntercept?
Description
Query the results of TOI measurement.
Explanation
This command is only available when the TOI measurement is enabled.
The amplitude unit of the return values is the same with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the measurement results of TOI in the following format:
the Base Lower frequency (Hz), amplitu de, the Base Upper frequency (Hz), amplitude, the 3rd Order Lower
frequency (Hz), amplitude, intercept, the 3rd Order Upper frequency (Hz), amplitude, intercept.
Example
The query below returns
1500450000,-8.131735E+01,1500450000,-8.131735E+01,1500450000,-8.131735E+01,-8.131735E+01,1
500450000,-8.131735E+01,-8.131735E+01.
:FETCh:TOIntercept?
DSA700 Programming Guide2-59
RIGOL Chapter 2 Command System
:FETCh:TOIntercept:IP3?
Syntax
:FETCh:TOIntercept:IP3?
Description
Query the minor one of the intercepts of the Third Order Lower and the Third Order Upper.
Explanation
This command is only available when the TOI measurement is enabled.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the minor one in scient ific notation.
Example
The query below returns -8.131735E+01.
:FETCh:TOIntercept:IP3?
:FETCh:TPOWer?
Syntax
:FETCh:TPOWer?
Description
Query the result of T-power measurement.
Explanation
This command is only available when the T-power measurement is enabled.
The power unit of the return value is the same with the current Y-axis unit.
This command will select data from the latest measurement results and transmit the data to the output
buffer.
Return Format
The query returns the T-power measurement result in scientific notation.
Example
The query below returns -1.658941E+01.
:FETCh:TPOWer?
2-60 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
:FORMat Subsystem
Command List:
:FORMat:BORDer
:FORMat[:TRACe][:DATA]
:FORMat:BORDer
Syntax
:FORMat:BORDer NORMal|SWAPped
:FORMat:BORDer?
Description
Set the byte order of binary data transmission.
Query the byte order of binary data transmission.
Parameter
-- Keyword NORMal|SWAPped NORMal
Explanation
NORMal: the transmission starts with the MSB (Most Significant Byte) and ends with the LSB (Least
Significant Byte).
SWAPped: the transmission starts with the LSB (Least Significant Byte) and ends with the MSB (Most
Significant Byte).
Return Format
The query returns NORM or SWAP.
Example
The command below sets the byte order of binary data transmission to NORMal.
:FORMat:BORDer NORMal
Clear all the event registers and clear the error queue.
*ESE
Syntax
*ESE <value>
*ESE?
Description
Set the enable register for the standard event status register.
Query the enable register for the standard event status register.
Parameter
Explanation
The bit 2, bit 3, bit 4 and bit 7 are reserved; you can set their values but they will not affect the instrument.
The bit 1 and bit 6 are not used and are always treated as 0; therefore, the range of <value> are the
decimal numbers corresponding to the binary numbers ranging from 00000000 (0 in decimal) to 11111111
(255 in decimal) and of which the b it 1 and bit 6 are 0.
DSA700 Programming Guide2-69
RIGOL Chapter 2 Command System
Return Format
The query returns an integer which equals the sum of the weights of all the bits that have already been set
in the register. For example, the query returns 144 if bit 4 (16 in decimal) and bit 7 (128 in decimal) are
enabled.
Example
The command below sets the enable register of the standard event status register to 16.
*ESE 16
The query below returns 16.
*ESE?
*ESR?
Syntax
*ESR?
Description
Query and clear the event register for the standard event status register.
Explanation
The bit 1 and bi t 6 of the standard eve nt status register are not used and are al ways treated as 0; theref ore,
the range of <value> are the decimal numbers corresponding to the binary numbers ranging from
00000000 (0 in decimal) to 11111111 (255 in decimal) and of which the bit 1 and bit 6 are 0.
Return Format
The query returns an integer which equals the sum of the weights of all the bits that have already been set
in the register. For example, the query returns 144 if bit 4 (16 in decimal) and bit 7 (128 in decimal) are
enabled.
Example
The query below returns 24 (bit 3 and bit 4 have already been set).
*ESR?
*IDN?
Syntax
*IDN?
Description
Query the ID string of the instrument.
Return Format
The query returns the ID string in the format below.
Rigol Technologies,<mo del>,<serial number>,XX.XX.XX.XX.XX
<model>: instrument model
<serial number>: serial number of the instrument
XX.XX.XX.XX.XX: software vers i on of the instrument
Example
The query below returns Rigol Technologies,DSA710,DSA8A134400008,00.01.16.00.03.
*IDN?
2-70 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
*OPC
Syntax
*OPC
*OPC?
Description
The *OPC command sets bit 0 of the standard event status register to 1 after the current operation is
finished.
The *OPC? command queries whether the current operation is finished.
Return Format
The query returns 1 if the current operation is finished, otherwise returns 0.
*RST
Syntax
*RST
Description
Restore the instrument to its default state.
*SRE
Syntax
*SRE <value>
*SRE?
Description
Set the enable register for the status byte register.
Query the enable register for the status byte register.
Parameter
<value> Integer Refer to Explanation 0
Explanation
The bit 0 and bit 1 of the status byte register are not used and are always treated as 0; therefore, the range
of <value> are the d ecimal numbers corresponding to the binary numbers ranging from 00000000 (0 in
decimal) to 11111111 (255 in de c imal) and of which the bit 0 and bi t 1 are 0.
Return Format
The query returns an integer which equals the sum of the weights of all the bits that have already been set
in the register. For example, the query returns 144 if bit 4 (16 in decimal) and bit 7 (128 in decimal) are
enabled.
Example
The command below sets the enable register of the status byte register to 16.
*SRE 16
The query below returns 16.
*SRE?
DSA700 Programming Guide2-71
RIGOL Chapter 2 Command System
*STB?
Syntax
*STB?
Description
Query the event register for the status byte register.
Explanation
The bit 0 and bit 1 of the status byte register are not used and are always treated as 0; therefore, the query
returns the decimal numbers corresponding to the binary numbers ranging from 00000000 (0 in decimal) to
11111111 (255 in decimal) and of which the bit 0 and bit 1 are 0.
Return Format
The query returns a n integer which equals the sum of the weights of all the bits set in the register. For
example, the query returns 144 if bit 4 (16 in decimal) and bit 7 (128 in decimal) are enabled.
Example
The query below returns 24 (bit 3 and bit 4 have already been set).
*STB?
*TRG
Syntax
*TRG
Description
Trigger a sweep or measurement immediately.
*TST?
Syntax
*TST?
Description
Query whether the self-check operation is finished.
Commands marked with "*" are only available for DSA700 installed with the advanced measurement kit
(option).
*
:INITiate:CONTinuous
Syntax
:INITiate:CONTinuo us OFF|ON|0|1
:INITiate:CONTinuous?
Description
In non-measurement state, select continuous (ON|1) or single (OFF|0) sweep. In measurement state,
select continuous (ON|1) or single (OFF|0) measurement.
Query the sweep or measurement mode.
Parameter
Name
-- Bool OFF|ON|0|1 ON|1
Return Format
The query returns 0 or 1.
Example
The command below sets the instrument to sweep continuously (the instrument is in non-measurement
state).
:INITiate:CONTi nuous ON or :INITiate:CONTinuous 1
The query below returns 1.
:INITiate:CONTinuous?
TypeRangeDefault
DSA700 Programming Guide2-73
RIGOL Chapter 2 Command System
:INITiate[:IMMediate]
Syntax
:INITiate[:IMMediate]
Description
In non-measurement state, initialize a sweep.
In measurement state, trigger a measurement.
Explanation
The instrument must be in single measurement mode. This command will be ignored if
the
Use the
buffer.
:INITiate:CONTinuous command is set to ON or 1.
:FETCh? command to transmit a measurement result from the internal memory to the output
:INITiate:PAUSe
Syntax
:INITiate:PAUSe
Description
Switch the measurement state of the instrument from "Wait for Trigger" to "Pause".
Explanation
This command is only available when the measurement function is enabled and continuous measurement
mode is selected.
:INITiate:RESTart
Syntax
:INITiate:RESTart
Description
Restart the current measurement when the instrument is in idle state.
Explanation
This command is only available when the measurement function is enabled.
:INITiate:RESume
Syntax
:INITiate:RESume
Description
Restore the measurement state of the instrument from "Pause" to "Wait for Trigger".
Explanation
This command is only available when the measurement function is enabled and continuous measurement
mode is selected.
2-74 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
--
Discrete
50|75
50
:INPut Subsystem
Command List:
:INPut:IMPedance
:INPut:IMPedance
Syntax
:INPut:IMPedance 50|75
:INPut:IMPedance?
Description
Set the input impedance for the voltage-to-power conversion and the unit is Ω.
Query the input impe dance for the voltage-to-power conversion.
Parameter
Explanation
If the output impedance of the system under measurement is 75 Ω, you should use a 75 Ω to 50 Ω adapter
(option) supplied by RIGOL to connect the spectrum analyzer with the system under test and then set the
input impedance of the spectrum analyzer to 75 Ω.
Return Format
The query returns 50 or 75.
Example
The command below sets the input impedance to 75 Ω.
:INPut:IMPedance 75
<file_name> shoul d contain the path and the filename; for example, E:\Rigol\Trace1.trc.
This operation fails if the file with the specified filena me does not exist.
Example
The command below deletes the Trace1.trc file under the Rigol folder in the USB storage device.
:MMEMory:DELete E:\Rigol\Trace1.trc
2-76 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name Type Range
Default
:MMEMory:DISK:INFormation?
Syntax
:MMEMory:DISK:INFormation?
Description
Query the disk information of the current USB storage device.Return Format
The query returns the disk information (include the disk name, type, file system, space used and total
capacity) in string.
Example
The return values of the query below are as follows.
Disk Name: E
Type: Mobile Disk
File System: FAT32
Space Used: 2.15 MB
Total Capacity: 3.73 GB
Load the edited limit line file (.lim) into the instrument.
Parameter
<file_name> ASCII String -- --
Explanation
<file_name> shoul d contain the path and the filename.
This operation fails when the specified file does not exist.
Example
The command below loads t he limit line file upp1.lim in the D disk into the instrument.
:MMEM:LOAD:LIM D:\Limit1:upp1.lim
:MMEMory:LOAD:MTABle
Syntax
:MMEMory:LOAD:MTABle <file_name>
Description
Load the stored marker table file (.mkr) into the instrument.
Parameter
Explanation
<file_name> shoul d contain the path and the filename.
The marker table file can only be stored in external memory and can only be loaded into the instrument
from external memory.
This operation fails if the specified file does not exist.
Example
The command below loads the marker table file Mark.mkr in the USB storage device into the instrument.
:MMEMory:LOAD:MTABle E:\Mak.mkr
2-78 DSA700 Programming Guide
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.