Rigol DSA710, DSA705 Programming Guide

RIGOL
Programming Guide
DSA700 Series Spectrum Analyzer
Aug. 2016
RIGOL TECHNOLOGIES, INC.
RIGOL

Guaranty and Declaration

Copyright
© 2016 RIGOL TECHNOLOGIES, INC. All Rights Reserved.
Trademark Information
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
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
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 Guide III
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
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 Guide V
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.
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
Sicherheits­Hinweis
Schutz-erde Gehäusemasse Erde
DSA700 Programming Guide VII
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
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
Chapter 1 SCPI Overview .................................................................................................... 1-1
Syntax ..................................................................................................................................... 1-2
Symbol Description ................................................................................................................... 1-2
Parameter Type ........................................................................................................................ 1-3
Command Abbreviation ............................................................................................................. 1-3
Chapter 2 Command System ............................................................................................... 2-1
:ABORt..................................................................................................................................... 2-2
:CALCulate Subsystem .............................................................................................................. 2-2
:CALCulate:BANDwidth:NDB ............................................................................................... 2-4
:CALCulate:BANDwidth:RESult?........................................................................................... 2-4
:CALCulate:LLINe:ALL:DELete ............................................................................................. 2-4
:CALCulate:LLINe:CONTrol:DOMain ..................................................................................... 2-5
:CALCulate:LLINe:FAIL? ...................................................................................................... 2-5
:CALCulate:LLINe:FAIL:RATIo?............................................................................................ 2-6
:CALCulate:LLINe:FAIL:STOP:STATe .................................................................................... 2-6
:CALCulate:LLINe<n>:CONTrol:INTerpolate:TYPE ................................................................ 2-7
:CALCulate:LLINe<n>:DATA ............................................................................................... 2-7
:CALCulate:LLINe<n>:DATA:MERGe ................................................................................... 2-8
:CALCulate:LLINe<n>:DELete ............................................................................................ 2-9
:CALCulate:LLINe<n>:RELAmpt[:STATe] ............................................................................. 2-9
:CALCulate:LLINe<n>:RELFreq[:STATe] ............................................................................ 2-10
:CALCulate:LLINe<n>:STATe ............................................................................................ 2-10
:CALCulate:MARKer:AOFF ................................................................................................. 2-11
:CALCulate:MARKer:FCOunt:RESolution ............................................................................. 2-11
:CALCulate:MARKer:FCOunt:RESolution:AUTO ................................................................... 2-12
:CALCulate:MARKer:FCOunt:X? ......................................................................................... 2-12
:CALCulate:MARKer:FCOunt[:STATe] ................................................................................. 2-13
:CALCulate:MARKer<n>:CPEak[:STATe] ............................................................................ 2-13
:CALCulate:MARKer<n>:DELTa[:SET]:CENTer .................................................................... 2-14
:CALCulate:MARKer<n>:DELTa[:SET]:SPAN ....................................................................... 2-14
:CALCulate:MARKer<n>:FUNCtion .................................................................................... 2-15
:CALCulate:MARKer<n>:MAXimum:LEFT ........................................................................... 2-15
:CALCulate:MARKer<n>:MAXimum:MAX ............................................................................ 2-16
:CALCulate:MARKer<n>:MAXimum:NEXT .......................................................................... 2-16
:CALCulate:MARKer<n>:MAXimum:RIGHt ......................................................................... 2-16
:CALCulate:MARKer<n>:MINimum .................................................................................... 2-17
:CALCulate:MARKer<n>:MODE ......................................................................................... 2-17
:CALCulate:MARKer<n>:PEAK:EXCursion .......................................................................... 2-18
:CALCulate:MARKer<n>:PEAK:SEARch:MODE .................................................................... 2-18
:CALCulate:MARKer<n>:PEAK[:SET]:CF ............................................................................ 2-19
:CALCulate:MARKer<n>:PEAK:THReshold ......................................................................... 2-19
:CALCulate:MARKer<n>:PTPeak ....................................................................................... 2-20
:CALCulate:MARKer<n>[:SET]:CENTer .............................................................................. 2-20
:CALCulate:MARKer<n>[:SET]:RLEVel ............................................................................... 2-21
:CALCulate:MARKer<n>[:SET]:STARt ................................................................................ 2-21
:CALCulate:MARKer<n>[:SET]:STEP ................................................................................. 2-22
RIGOL Contents
:CALCulate:MARKer<n>[:SET]:STOP ................................................................................. 2-22
:CALCulate:MARKer<n>:STATe .......................................................................................... 2-23
:CALCulate:MARKer<n>:TRACe ......................................................................................... 2-23
:CALCulate:MARKer<n>:TRACe:AUTO ............................................................................... 2-24
:CALCulate:MARKer<n>:X ................................................................................................ 2-25
:CALCulate:MARKer<n>:X:CENTer ..................................................................................... 2-26
:CALCulate:MARKer<n>:X:POSition ................................................................................... 2-27
:CALCulate:MARKer<n>:X:POSition:CENTer ....................................................................... 2-27
:CALCulate:MARKer<n>:X:POSition:SPAN .......................................................................... 2-28
:CALCulate:MARKer<n>:X:POSition:STARt ......................................................................... 2-28
:CALCulate:MARKer<n>:X:POSition:STOP .......................................................................... 2-29
:CALCulate:MARKer<n>:X:READout .................................................................................. 2-29
:CALCulate:MARKer<n>:X:SPAN ....................................................................................... 2-30
:CALCulate:MARKer<n>:X:STARt....................................................................................... 2-30
:CALCulate:MARKer<n>:X:STOP ....................................................................................... 2-31
:CALCulate:MARKer<n>:Y? ............................................................................................... 2-32
:CALCulate:MARKer:TABLe:STATe ...................................................................................... 2-32
:CALCulate:MARKer:TRACking:STATe ................................................................................. 2-33
:CALibration Subsystem ........................................................................................................... 2-34
:CALibration:[ALL] ............................................................................................................ 2-34
:CALibration:AUTO ............................................................................................................ 2-34
:CONFigure Subsystem ............................................................................................................ 2-35
:CONFigure? ..................................................................................................................... 2-35
:CONFigure:ACPower ........................................................................................................ 2-35
:CONFigure:CHPower ........................................................................................................ 2-36
:CONFigure:CNRatio ......................................................................................................... 2-36
:CONFigure:EBWidth......................................................................................................... 2-36
:CONFigure:HDISt ............................................................................................................ 2-37
:CONFigure:OBWidth ........................................................................................................ 2-37
:CONFigure:PF ................................................................................................................. 2-37
:CONFigure:SANalyzer ...................................................................................................... 2-37
:CONFigure:TOI ............................................................................................................... 2-38
:CONFigure:TPOWer ......................................................................................................... 2-38
:COUPle Subsystem ................................................................................................................. 2-39
:COUPle ........................................................................................................................... 2-39
:DISPlay Subsystem ................................................................................................................ 2-40
:DISPlay:AFUnction:POSition ............................................................................................. 2-41
:DISPlay:ANNotation:CLOCk[:STATe] ................................................................................. 2-41
:DISPlay:BRIGhtness ........................................................................................................ 2-42
:DISPlay:ENABle ............................................................................................................... 2-42
:DISPlay:MSGswitch:STATe ............................................................................................... 2-43
:DISPlay:UKEY:STATe ........................................................................................................ 2-43
:DISPlay:WINdow:TRACe:GRATicule:GRID ......................................................................... 2-44
:DISPlay:WINdow:TRACe:X[:SCALe]:SPACing .................................................................... 2-44
:DISPlay:WINdow:TRACe:Y:DLINe ..................................................................................... 2-45
:DISPlay:WINdow:TRACe:Y:DLINe:STATe ........................................................................... 2-45
:DISPlay:WINdow:TRACe:Y[:SCALe]:PDIVision .................................................................. 2-46
:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel....................................................................... 2-46
:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel:OFFSet ........................................................... 2-47
:DISPlay:WINdow:TRACe:Y[:SCALe]:SPACing .................................................................... 2-47
:FETCh Subsystem .................................................................................................................. 2-48
:FETCh:ACPower? ............................................................................................................. 2-49
:FETCh:ACPower:LOWer? .................................................................................................. 2-49
:FETCh:ACPower:MAIN? ................................................................................................... 2-50
:FETCh:ACPower:UPPer? ................................................................................................... 2-50
:FETCh:CHPower? ............................................................................................................ 2-51
:FETCh:CHPower:CHPower? .............................................................................................. 2-51
:FETCh:CHPower:DENSity? ................................................................................................ 2-52
X DSA700 Programming Guide
Contents RIGOL
:FETCh:CNRatio? .............................................................................................................. 2-52
:FETCh:CNRatio:CARRier?................................................................................................. 2-53
:FETCh:CNRatio:CNRatio? ................................................................................................. 2-53
:FETCh:CNRatio:NOISe? ................................................................................................... 2-54
:FETCh:EBWidth? ............................................................................................................. 2-54
:FETCh:HARMonics:AMPLitude:ALL? .................................................................................. 2-55
:FETCh:HARMonics :AMP L it ude ? <n > ................................................................................. 2-55
:FETCh:HARMonics[:DISTortion]? ...................................................................................... 2-56
:FETCh:HARMonics:FREQuency:ALL? ................................................................................. 2-56
:FETCh:HARMonics :FRE Q ue ncy ? <n > ............................................................................... 2-57
:FETCh:HARMonics:FUNDamental? .................................................................................... 2-57
:FETCh:OBWidth? ............................................................................................................ 2-58
:FETCh:OBWidth:OBWidth? .............................................................................................. 2-58
:FETCh:OBWidth:OBWidth:FERRor? .................................................................................. 2-59
:FETCh:TOIntercept? ........................................................................................................ 2-59
:FETCh:TOIntercept:IP3? .................................................................................................. 2-60
:FETCh:TPOWer? ............................................................................................................. 2-60
:FORMat Subsystem................................................................................................................ 2-61
:FORMat:BORDer ............................................................................................................. 2-61
:FORMat[:TRACe][:DATA] ................................................................................................. 2-62
:HCOPy Subsystem ................................................................................................................. 2-63
:HCOPy:ABORt ................................................................................................................. 2-63
:HCOPy:IMAGe:COLor[:STATe] .......................................................................................... 2-63
:HCOPy:IMAGe:FTYPe ...................................................................................................... 2-64
:HCOPy:IMAGe:INVert ...................................................................................................... 2-64
:HCOPy:IMAGe:PTIMe ...................................................................................................... 2-65
:HCOPy:IMAGe:QUALity ................................................................................................... 2-65
:HCOPy[:IMMediate] ........................................................................................................ 2-66
:HCOPy:PAGE:ORIentation ............................................................................................... 2-66
:HCOPy:PAGE:PRINts ....................................................................................................... 2-67
:HCOPy:PAGE:SIZE .......................................................................................................... 2-67
:HCOPy:RESume .............................................................................................................. 2-68
IEEE 488.2 Common Commands.............................................................................................. 2-69
*CLS ............................................................................................................................... 2-69
*ESE ............................................................................................................................... 2-69
*ESR? ............................................................................................................................. 2-70
*IDN? ............................................................................................................................. 2-70
*OPC ............................................................................................................................... 2-71
*RST ............................................................................................................................... 2-71
*SRE ............................................................................................................................... 2-71
*STB? ............................................................................................................................. 2-72
*TRG .............................................................................................................................. 2-72
*TST? ............................................................................................................................. 2-72
*WAI ............................................................................................................................... 2-72
:INITiate Subsystem ............................................................................................................... 2-73
:INITiate:CONTinuous ...................................................................................................... 2-73
:INITiate[:IMMediate] ...................................................................................................... 2-74
:INITiate:PAUSe ............................................................................................................... 2-74
:INITiate:RESTart ............................................................................................................. 2-74
:INITiate:RESume ............................................................................................................ 2-74
:INPut Subsystem ................................................................................................................... 2-75
:INPut:IMPedance ............................................................................................................ 2-75
:MMEMory Subsystem ............................................................................................................. 2-76
:MMEMory:DELete ............................................................................................................ 2-76
:MMEMory:DISK:INFormation? .......................................................................................... 2-77
:MMEMory:LOAD:CORRection ........................................................................................... 2-77
:MMEMory:LOAD:LIMit ..................................................................................................... 2-78
:MMEMory:LOAD:MTABle .................................................................................................. 2-78
DSA700 Programming Guide XI
RIGOL Contents
:MMEMory:LOAD:SETUp ................................................................................................... 2-79
:MMEMory:LOAD:STATe .................................................................................................... 2-79
:MMEMory:LOAD:TRACe ................................................................................................... 2-80
:MMEMory:MOVE .............................................................................................................. 2-80
:MMEMory:STORe:CORRection .......................................................................................... 2-81
:MMEMory:STORe:LIMit .................................................................................................... 2-81
:MMEMory:STORe:MTABle................................................................................................. 2-82
:MMEMory:STORe:PTABle ................................................................................................. 2-82
:MMEMory:STORe:RESults ................................................................................................ 2-83
:MMEMory:STORe:SCReen ................................................................................................ 2-83
:MMEMory:STORe:SETUp .................................................................................................. 2-84
:MMEMory:STORe:STATe ................................................................................................... 2-84
:MMEMory:STORe:TRACe .................................................................................................. 2-85
:READ Subsystem ................................................................................................................... 2-86
:READ:ACPower? .............................................................................................................. 2-87
:READ:ACPower:LOWer? ................................................................................................... 2-87
:READ:ACPower:MAIN? ..................................................................................................... 2-87
:READ:ACPower:UPPer? .................................................................................................... 2-88
:READ:CHPower? .............................................................................................................. 2-88
:READ:CHPower:CHPower? ............................................................................................... 2-88
:READ:CHPower:DENSity? ................................................................................................. 2-89
:READ:CNRatio? ............................................................................................................... 2-89
:READ:CNRatio:CARRier? .................................................................................................. 2-89
:READ:CNRatio:CNRatio? .................................................................................................. 2-90
:READ:CNRatio:NOISe?..................................................................................................... 2-90
:READ:EBWidth? .............................................................................................................. 2-90
:READ:HARMonics:AMPLitude:ALL? ................................................................................... 2-91
:READ:HARMonics:AMPLitude? <n> .................................................................................. 2-91
:READ:HARMonics[:DISTortion]? ....................................................................................... 2-92
:READ:HARMonics:FREQuency:ALL? .................................................................................. 2-92
:READ:HARMonics:FREQuency? <n > ................................................................................. 2-93
:READ:HARMonics:FUNDamental? ..................................................................................... 2-93
:READ:OBWidth? .............................................................................................................. 2-93
:READ:OBWidth:OBWidth? ................................................................................................ 2-94
:READ:OBWidth:OBWidth:FERRor? .................................................................................... 2-94
:READ:TOIntercept? ......................................................................................................... 2-94
:READ:TOIntercept:IP3? ................................................................................................... 2-95
:READ:TPOWer? ............................................................................................................... 2-95
[:SENSe] Subsystem ............................................................................................................... 2-96
[:SENSe]:ACPower:AVERage:COUNt .................................................................................. 2-99
[:SENSe]:ACPower:AVERage[:STATe] ................................................................................. 2-99
[:SENSe]:ACPower:AVERage:TCONtrol ............................................................................. 2-100
[:SENSe]:ACPower:BANDwidth:ACHannel ........................................................................ 2-100
[:SENSe]:ACPower:BANDwidth:INTegration...................................................................... 2-101
[:SENSe]:ACPower:CSPacing ........................................................................................... 2-102
[:SENSe]:BANDwidth:EMIFilter:STATe .............................................................................. 2-102
[:SENSe]:BANDwidth[:RESolution]................................................................................... 2-103
[:SENSe]:BANDwidth[:RESolution]:AUTO ......................................................................... 2-103
[:SENSe]:BANDwidth:VIDeo ............................................................................................ 2-104
[:SENSe]:BANDwidth:VIDeo:AUTO .................................................................................. 2-104
[:SENSe]:BANDwidth:VIDeo:RATio .................................................................................. 2-105
[:SENSe]:CHPower:AVERage:COUNt ................................................................................ 2-105
[:SENSe]:CHPower:AVERage[:STATe] .............................................................................. 2-106
[:SENSe]:CHPower:AVERage:TCONtrol ............................................................................ 2-106
[:SENSe]:CHPower:BANDwidth:INTegration ..................................................................... 2-107
[:SENSe]:CHPower:FREQuency:SPAN .............................................................................. 2-107
[:SENSe]:CNRatio:AVERage:COUNt ................................................................................. 2-108
[:SENSe]:CNRatio:AVERage[:STATe] ................................................................................ 2-109
Contents RIGOL
[:SENSe]:CNRatio:AVERage:TCONtrol .............................................................................. 2-109
[:SENSe]:CNRatio:BANDwidth:INTegration ...................................................................... 2-110
[:SENSe]:CNRatio:BANDwidth:NOISe .............................................................................. 2-111
[:SENSe]:CNRatio:OFFSet ............................................................................................... 2-111
[:SENSe]:CORRection:CSET:ALL:DELete .......................................................................... 2-112
[:SENSe]:CORRection:CSET:ALL[:STATe] ......................................................................... 2-112
[:SENSe]:CORRection:CSET<n>:DATA ............................................................................ 2-113
[:SENSe]:CORRection:CSET<n>:DATA:MERGe ................................................................. 2-113
[:SENSe]:CORRection:CSET<n>:DELete .......................................................................... 2-114
[:SENSe]:CORRection:CSET<n>[:STATe] ......................................................................... 2-114
[:SENSe]:CORRection:CSET<n>:X:SPACing ..................................................................... 2-115
[:SENSe]:CORRection:CSET:TABLe:STATe ........................................................................ 2-115
[:SENSe]:DEMod ............................................................................................................ 2-116
[:SENSe]:DEMod:GAIN:AUTO ......................................................................................... 2-116
[:SENSe]:DEMod:GAIN:INCRement ................................................................................. 2-117
[:SENSe]:DEMod:STATe .................................................................................................. 2-117
[:SENSe]:DEMod:TIME ................................................................................................... 2-118
[:SENSe]:DETector[:FUNCtion] ....................................................................................... 2-118
[:SENSe]:EBWidth:AVERage:COUNt ................................................................................ 2-119
[:SENSe]:EBWidth:AVERage[:STATe] ............................................................................... 2-120
[:SENSe]:EBWidth:AVERage:TCONtrol ............................................................................. 2-120
[:SENSe]:EBWidth:FREQuency:SPAN ............................................................................... 2-121
[:SENSe]:EBWidth:MAXHold:STATe ................................................................................. 2-122
[:SENSe]:EBWidth:XDB .................................................................................................. 2-122
[:SENSe]:EXTRef[:STATe]? ............................................................................................. 2-123
[:SENSe]:FREQuency:CENTer.......................................................................................... 2-123
[:SENSe]:FREQuency:CENTer:DOWN .............................................................................. 2-124
[:SENSe]:FREQuency:CENTer:SET:STEP .......................................................................... 2-124
[:SENSe]:FREQuency:CENTer:STEP:AUTO ....................................................................... 2-124
[:SENSe]:FREQuency:CENTer:STEP[:INCRement] ............................................................ 2-125
[:SENSe]:FREQuency:CENTer:UP .................................................................................... 2-125
[:SENSe]:FREQuency:OFFSet .......................................................................................... 2-125
[:SENSe]:FREQuency:SPAN ............................................................................................ 2-126
[:SENSe]:FREQuency:SPAN:FULL .................................................................................... 2-126
[:SENSe]:FREQuency:SPAN:PREVious ............................................................................. 2-127
[:SENSe]:FREQuency:SPAN:ZIN ...................................................................................... 2-127
[:SENSe]:FREQuency:SPAN:ZOUT ................................................................................... 2-127
[:SENSe]:FREQuency:STARt ........................................................................................... 2-127
[:SENSe]:FREQuency:STOP ............................................................................................ 2-128
[:SENSe]:HDISt:AVERage:COUNt .................................................................................... 2-128
[:SENSe]:HDISt:AVERage[:STATe] .................................................................................. 2-129
[:SENSe]:HDISt:AVERage:TCONtrol ................................................................................. 2-129
[:SENSe]:HDISt:NUMBers ............................................................................................... 2-130
[:SENSe]:HDISt:TIME ..................................................................................................... 2-131
[:SENSe]:HDISt:TIME:AUTO[:STATe] .............................................................................. 2-131
[:SENSe]:OBWidth:AVERage:COUNt ................................................................................ 2-132
[:SENSe]:OBWidth:AVERage[:STATe] .............................................................................. 2-132
[:SENSe]:OBWidth:AVERage:TCONtrol ............................................................................ 2-133
[:SENSe]:OBWidth:FREQuency:SPAN .............................................................................. 2-133
[:SENSe]:OBWidth:MAXHold:STATe ................................................................................. 2-134
[:SENSe]:OBWidth:PERCent ........................................................................................... 2-135
[:SENSe]:POWer:ARANge ............................................................................................... 2-135
[:SENSe]:POWer:ASCale ................................................................................................. 2-135
[:SENSe]:POWer:ATUNe ................................................................................................. 2-136
[:SENSe]:POWer[:RF]:ATTenuation ................................................................................. 2-136
[:SENSe]:POWer[:RF]:ATTenuation:AUTO ........................................................................ 2-137
[:SENSe]:POWer[:RF]:GAIN[:STATe] ............................................................................... 2-137
[:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer] ................................................................... 2-138
DSA700 Programming Guide XIII
RIGOL Contents
[:SENSe]:SIGCapture[:STATe] ......................................................................................... 2-138
[:SENSe]:SIGCapture:SIGC[:STATe] ................................................................................. 2-139
[:SENSe]:SIGCapture:MAXHold[:STATe] ........................................................................... 2-139
[:SENSe]:SIGCapture:RESet ............................................................................................ 2-140
[:SENSe]:SIGCapture:2FSK[:STATe] ................................................................................. 2-140
[:SENSe]:SIGCapture:2FSK:RESet ................................................................................... 2-140
[:SENSe]:SIGCapture:2FSK:MAXHold[:STATe] .................................................................. 2-141
[:SENSe]:SIGCapture:2FSK:PFSWitch .............................................................................. 2-141
[:SENSe]:SIGCapture:2FSK:SIGNal .................................................................................. 2-142
[:SENSe]:SIGCapture:2FSK:AMPUp.................................................................................. 2-142
[:SENSe]:SIGCapture:2FSK:AMPDown ............................................................................. 2-143
[:SENSe]:SIGCapture:2FSK:MARK1[:FREQ] ...................................................................... 2-143
[:SENSe]:SIGCapture:2FSK:MARK1:Switch[:STATe] .......................................................... 2-144
[:SENSe]:SIGCapture:2FSK:MARK2[:FREQ] ...................................................................... 2-144
[:SENSe]:SIGCapture:2FSK:MARK2:Switch[:STATe] .......................................................... 2-145
[:SENSe]:SWEep:COUNt ................................................................................................. 2-145
[:SENSe]:SWEep:COUNt:CURRent? ................................................................................. 2-146
[:SENSe]:SWEep:TIME ................................................................................................... 2-146
[:SENSe]:SWEep:TIME:AUTO .......................................................................................... 2-147
[:SENSe]:SWEep:TIME:AUTO:RULes ............................................................................... 2-147
[:SENSe]:TOI:AVERage:COUNt ........................................................................................ 2-148
[:SENSe]:TOI:AVERage[:STATe] ...................................................................................... 2-148
[:SENSe]:TOI:AVERage:TCONtrol .................................................................................... 2-149
[:SENSe]:TOI:FREQuency:SPAN ...................................................................................... 2-149
[:SENSe]:TPOWer:AVERage:COUNt ................................................................................. 2-150
[:SENSe]:TPOWer:AVERage[:STATe] ................................................................................ 2-150
[:SENSe]:TPOWer:AVERage:TCONtrol .............................................................................. 2-151
[:SENSe]:TPOWer:LLIMit ................................................................................................ 2-151
[:SENSe]:TPOWer:MODE ................................................................................................ 2-152
[:SENSe]:TPOWer:RLIMit ................................................................................................ 2-153
:STATus Subsystem ............................................................................................................... 2-154
:STATus:OPERation:CONDition? ....................................................................................... 2-155
:STATus:OPERation:ENABle ............................................................................................. 2-155
:STATus:OPERation[:EVENt]? .......................................................................................... 2-156
:STATus:PRESet .............................................................................................................. 2-156
:STATus:QUEStionable:CONDition? .................................................................................. 2-156
:STATus:QUEStionable:ENABle......................................................................................... 2-157
:STATus:QUEStionable[:EVENt]? ...................................................................................... 2-157
:SYSTem Subsystem .............................................................................................................. 2-158
:SYSTem:BEEPer:STATe .................................................................................................. 2-159
:SYSTem:CLEar .............................................................................................................. 2-159
:SYSTem:COMMunicate:APORt ........................................................................................ 2-160
:SYSTem:COMMunicate:BRMT ......................................................................................... 2-160
:SYSTem:COMMunicate:GPIB[:SELF]:ADDRess ................................................................. 2-161
:SYSTem:COMMunicate:LAN[:SELF]:AUToip:STATe ............................................................ 2-161
:SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe ............................................................. 2-162
:SYSTem:COMMunicate:LAN[:SELF]:IP:ADDress ............................................................... 2-162
:SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer ............................................................ 2-163
:SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway .............................................................. 2-163
:SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask .............................................................. 2-164
:SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe........................................................... 2-164
:SYSTem:COMMunicate:LAN[:SELF]:RESet ....................................................................... 2-165
:SYSTem:COMMunicate:USB[:SELF]:ADDRess? ................................................................. 2-165
:SYSTem:COMMunicate:USB[:SELF]:CLASs ....................................................................... 2-165
:SYSTem:CONFigure:INFormation? .................................................................................. 2-166
:SYSTem:CONFigure:MESSage? ....................................................................................... 2-166
:SYSTem:DATE ............................................................................................................... 2-167
:SYSTem:ERRor[:NEXT]? ................................................................................................. 2-167
XIV DSA700 Programming Guide
Contents RIGOL
:SYSTem:FSWItch[:STATe].............................................................................................. 2-168
:SYSTem:KLOCk ............................................................................................................. 2-168
:SYSTem:LANGuage ....................................................................................................... 2-169
:SYSTem:LINemod:STATe?.............................................................................................. 2-169
:SYSTem:LINemod:TYPe ................................................................................................. 2-170
:SYSTem:LKEY ............................................................................................................... 2-170
:SYSTem:OPTions? ......................................................................................................... 2-171
:SYSTem:PON:TYPE ....................................................................................................... 2-171
:SYSTem:PRESet ............................................................................................................ 2-172
:SYSTem:PRESet:SAVE ................................................................................................... 2-172
:SYSTem:PRESet:TYPE ................................................................................................... 2-172
:SYSTem:SPEaker[:STATe] .............................................................................................. 2-173
:SYSTem:SPEaker:VOLume ............................................................................................. 2-173
:SYSTem:TIME ............................................................................................................... 2-174
:SYSTem:TX:STATe? ....................................................................................................... 2-174
:SYSTem:TX:SWset ........................................................................................................ 2-175
:SYSTem:TX:SWSTa? ...................................................................................................... 2-175
:SYSTem:USERkey:CONFirm ........................................................................................... 2-176
:SYSTem:USERkey:KEYCmd ............................................................................................ 2-176
:SYSTem:USERkey:STATe ............................................................................................... 2-177
:SYSTem:VERSion? ......................................................................................................... 2-177
:TRACe Subsystem ............................................................................................................... 2-178
:TRACe:AVERage:CLEar .................................................................................................. 2-178
:TRACe:AVERage:COUNt ................................................................................................ 2-178
:TRACe:AVERage:COUNt:CURRent?................................................................................. 2-179
:TRACe:AVERage:RESet ................................................................................................. 2-179
:TRACe:CLEar:ALL ......................................................................................................... 2-179
:TRACe[:DATA] .............................................................................................................. 2-180
:TRACe:MATH:A ............................................................................................................. 2-181
:TRACe:MATH:B ............................................................................................................. 2-181
:TRACe:MATH:CONSt ..................................................................................................... 2-182
:TRACe:MATH:PEAK[:DATA]? .......................................................................................... 2-182
:TRACe:MATH:PEAK:POINts? .......................................................................................... 2-183
:TRACe:MATH:PEAK:SORT .............................................................................................. 2-183
:TRACe:MATH:PEAK:TABLe:STATe ................................................................................... 2-183
:TRACe:MATH:PEAK:THReshold ...................................................................................... 2-184
:TRACe:MATH:STATe ...................................................................................................... 2-184
:TRACe:MATH:TYPE ....................................................................................................... 2-185
:TRACe<n>:AVERage:TYPE ............................................................................................ 2-185
:TRACe<n>:MODE ......................................................................................................... 2-186
:TRIGger Subsystem ............................................................................................................. 2-187
:TRIGger:SEQuence:EXTernal:READy? ............................................................................. 2-187
:TRIGger:SEQuence:EXTernal:SLOPe ............................................................................... 2-187
:TRIGger:SEQuence:SOURce .......................................................................................... 2-188
:TRIGger:SEQuence:VIDeo:LEVel .................................................................................... 2-189
:UNIT Subsystem.................................................................................................................. 2-190
:UNIT:POWer ................................................................................................................. 2-190
Chapter 3 Programming Demos .......................................................................................... 3-1
Programming Instructions ......................................................................................................... 3-2
Programming Preparations ........................................................................................................ 3-2
Visual C++ 6.0 Programming Demo ........................................................................................... 3-5
Visual Basic 6.0 Programming Demo ........................................................................................ 3-13
LabVIEW 8.6 Programming Demo ............................................................................................ 3-17
Linux Programming Demo ....................................................................................................... 3-21
Linux Programming Preparations ....................................................................................... 3-21
Linux Programming Procedures ......................................................................................... 3-24
DSA700 Programming Guide XV

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:
SyntaxSymbol Description Parameter Type Command Abbreviation
DSA700 Programming Guide 1-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 Guide 1-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).
Main topics of this chapter:
:ABORt:CALCulate Subsystem:CALibration Subsystem :CONFigure Subsystem :COUPle Subsystem :DISPlay Subsystem :FETCh Subsystem :FORMat Subsystem :HCOPy Subsystem IEEE 488.2 Common Commands:INITiate Subsystem :INPut Subsystem :MMEMory Subsystem :READ Subsystem[:SENSe] Subsystem :STATus Subsystem :SYSTem Subsystem :TRACe Subsystem :TRIGger Subsystem :UNIT Subsystem
Explanation:
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 Guide 2-1
RIGOL Chapter 2 Command System
:ABORt
Syntax

:ABORt

Description
Give up the current operation and restart the sweep.

:CALCulate Subsystem

Command List:
:CALCulate:BANDwidth:NDB :CALCulate:BANDwidth:RESult? :CALCulate:LLINe:ALL:DELete:CALCulate:LLINe:CONTrol:DOMain:CALCulate:LLINe:FAIL?:CALCulate:LLINe:FAIL:RATIo?:CALCulate:LLINe:FAIL:STOP:STATe :CALCulate:LLINe<n>:CONTrol:INTerpolate:TYPE :CALCulate:LLINe<n>:DATA :CALCulate:LLINe<n>:DATA:MERGe :CALCulate:LLINe<n>:DELete:CALCulate:LLINe<n>:RELAmpt[:STATe] :CALCulate:LLINe<n>:RELFreq[:STATe] :CALCulate:LLINe<n>:STATe :CALCulate:MARKer:AOFF :CALCulate:MARKer:FCOunt:RESolution:CALCulate:MARKer:FCOunt:RESolution:AUTO:CALCulate:MARKer:FCOunt:X?:CALCulate:MARKer:FCOunt[:STATe] :CALCulate:MARKer<n>:CPEak[:STATe] :CALCulate:MARKer<n>:DELTa[:SET]:CENTer :CALCulate:MARKer<n>:DELTa[:SET]:SPAN :CALCulate:MARKer<n>:FUNCtion :CALCulate:MARKer<n>:MAXimum:LEFT :CALCulate:MARKer<n>:MAXimum:MAX :CALCulate:MARKer<n>:MAXimum:NEXT :CALCulate:MARKer<n>:MAXimum:RIGHt :CALCulate:MARKer<n>:MINimum:CALCulate:MARKer<n>:MODE
2-2 DSA700 Programming Guide
Chapter 2 Command System RIGOL
:CALCulate:MARKer<n>:PEAK:EXCursion :CALCulate:MARKer<n>:PEAK:SEARch:MODE :CALCulate:MARKer<n>:PEAK[:SET]:CF :CALCulate:MARKer<n>:PEAK:THReshold :CALCulate:MARKer<n>:PTPeak:CALCulate:MARKer<n>[:SET]:CENTer :CALCulate:MARKer<n>[:SET]:RLEVel :CALCulate:MARKer<n>[:SET]:STARt :CALCulate:MARKer<n>[:SET]:STEP:CALCulate:MARKer<n>[:SET]:STOP :CALCulate:MARKer<n>:STATe :CALCulate:MARKer<n>:TRACe :CALCulate:MARKer<n>:TRACe:AUTO :CALCulate:MARKer<n>:X:CALCulate:MARKer<n>:X:CENTer :CALCulate:MARKer<n>:X:POSition :CALCulate:MARKer<n>:X:POSition:CENTer :CALCulate:MARKer<n>:X:POSition:SPAN :CALCulate:MARKer<n>:X:POSition:STARt :CALCulate:MARKer<n>:X:POSition:STOP :CALCulate:MARKer<n>:X:READout :CALCulate:MARKer<n>:X:SPAN :CALCulate:MARKer<n>:X:STARt :CALCulate:MARKer<n>:X:STOP :CALCulate:MARKer<n>:Y?:CALCulate:MARKer:TABLe:STATe :CALCulate:MARKer:TRACking:STATe
DSA700 Programming Guide 2-3
RIGOL Chapter 2 Command System
Name
Type
Range
Default

:CALCulate:BANDwidth:NDB

Syntax
:CALCulate:BANDwidth:NDB <rel_ampl> :CALCulate:BANDwidth:NDB?
Description
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 ----.

:CALCulate:LLINe:ALL:DELete

Syntax
:CALCulate:LLINe:ALL:DELete
Description
Delete the limit line currently edited.
2-4 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default

:CALCulate:LLINe:CONTrol:DOMain

Syntax
:CALCulate:LLINe:CONTrol:DOMain FREQuency|TIME :CALCulate:LLINe:CONTrol:DOMain?
Description
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 Guide 2-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?

:CALCulate:LLINe:FAIL:STOP:STATe

Syntax
:CALCulate:LLINe:FAIL:STOP:STATe OFF|ON|0|1 :CALCulate:LLINe:FAIL:STOP:STATe?
Description
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?
2-6 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
--
Keyword
LOGarithmic|LINear
LINear
Name
Type
Range
Default
<n>
Discrete
1|2
2
Consecutive
0 Hz to 1 GHz (the X axis denotes frequency)

:CALCulate:LLINe<n>:CONTrol:INTerpolate:TYPE

Syntax
:CALCulate:LLINe<n>:CONTrol :INTerpolate:TYPE LOGarithmic|LINear :CALCulate:LLINe<n>:CONTrol:INTerpolate:TYPE?
Description
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?
<n> Discrete 1|2 --

:CALCulate:LLINe<n>:DATA

Syntax
:CALCulate:LLINe<n>:DATA <x-axis>,<ampl>,<connected>{,<x-axis>,<ampl>,<connected>} :CALCulate:LLINe<n>:DATA?
Description
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 Guide 2-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?

:CALCulate:LLINe<n>:DATA:MERGe

Syntax
:CALCulate:LLINe<n>:DATA:MERGe <x-axis>,<ampl>,<connected>{,<x-axis>,<ampl>,<connected>}
Description
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
<n> Discrete 1|2 --

:CALCulate:LLINe<n>:RELAmpt[:STATe]

Syntax
:CALCulate:LLINe<n>:RELAmpt[:STATe] OFF|ON|0|1 :CALCulate:LLINe<n>:RELAmpt?
Description
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?
DSA700 Programming Guide 2-9
RIGOL Chapter 2 Command System
Name Type
Range
Default

:CALCulate:LLINe<n>:RELFreq[:STATe]

Syntax
:CALCulate:LLINe<n>:RELFreq[:STATe] OFF|ON|0|1 :CALCulate:LLINe<n>:RELFreq?
Description
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?

:CALCulate:LLINe<n>:STATe

Syntax
:CALCulate:LLINe<n>:STATe OFF|ON|0|1 :CALCulate:LLINe<n>:STATe?
Description
Enable or disable the upper/lower limit line. Query the status of the limit lines.
Parameter
Explanation
<n> denotes the lower limit line (1) or upper limit line (2).
Return Format
The query returns 0 or 1.
Name Type Range Default
<n> Discrete 1|2 --
-- Bool OFF|ON|0|1 OFF|0
2-10 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
Example
The command below enables the upper limit line. :CALCulate:LLI Ne2 :S TA Te ON or :CALCulate:LLINe2:STATe 1
The query below returns 1. :CALCulate:LLINe2:STATe?

:CALCulate:MARKer:AOFF

Syntax
:CALCulate:MARKer:AOFF
Description
Disable all the markers currently enabled as well as all the functions based on the markers.

:CALCulate:MARKer:FCOunt:RESolution

Syntax
:CALCulate:MARKer:FCOunt:RESolution <freq> :CALCulate:MARKer:FCOunt:RESolution?
Description
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?
<freq> Discrete 1 Hz|10 Hz|100 Hz|1 kHz |10 kHz|100 kHz 1 kHz
:CALCulate:MARKer:FCOunt:RESolution:AUTO command to set the resolution setting to auto
DSA700 Programming Guide 2-11
RIGOL Chapter 2 Command System

:CALCulate:MARKer:FCOunt:RESolution:AUTO

Syntax
:CALCulate:MARKer:FCOunt:RESolution:AUTO OFF|ON|0|1 :CALCulate:MARKer:FCOunt:RESolution:AUTO?
Description
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.
2-12 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
Name Type
Range
Default

:CALCulate:MARKer:FCOunt[:STATe]

Syntax
:CALCulate:MARKer:FCOunt[:STATe] OFF|ON|0|1 :CALCulate:MARKer:FCOunt[:STATe]?
Description
Enable or disable the frequency counter. Query the status of the frequency counter.
Parameter
Explanation
Use the
Return Format
The query returns 0 or 1.
Example
The command below enables the freque ncy counter. :CALCulate:MARKer:FCOunt:STATe ON or :CALCulate:MARKer:FCOunt:STATe 1
The query below returns 1. :CALCulate:MARKer:FCOunt:STATe?
-- Bool OFF|ON|0|1 OFF|0
:CALCulate:MARKer:FCOunt:X? command to query the reading of the frequency counter.

:CALCulate:MARKer<n>:CPEak[:STATe]

Syntax
:CALCulate:MARKer<n>:CPEak[:STATe] OFF|ON|0|1 :CALCulate:MARKer<n>:CPEak[:STATe]?
Description
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 Guide 2-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.
Type Range Default
2-14 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
<n>
Discrete
1|2|3|4
--

:CALCulate:MARKer<n>:FUNCtion

Syntax
:CALCulate:MARKer<n>:FUNCtion NDB|NOISe|OFF :CALCulate:MARKer<n>:FUNCtion?
Description
Select special measurement type for the specified marker. Query the special measurement type of the specified marker.
Parameter
<n> Discrete 1|2|3|4 --
-- Keyword NDB|NOISe|OFF OFF
Explanation
NDB: N dB bandwidth. NOISe: noise marker. OFF: disable all the measurements.
Return Format
The query returns NDB, NOIS or OFF.
Example
The command below sets the measurement type of marker 1 to N dB bandwidth. :CALCulate:MARKer1:FUNCtion NDB
The query below returns NDB. :CALCulate:MARKer1:FUNCtion?

:CALCulate:MARKer<n>:MAXimum:LEFT

Syntax
:CALCulate:MARKer<n>:MAXimum:LEFT
Description
Search and mark the nearest peak which is located at the left side of the current peak on the trace and meets the peak search condition.
Parameter
Name
Type Range Default
Explanation
When no peak is fo und, "No peak found" is di splayed on the screen.
DSA700 Programming Guide 2-15
RIGOL Chapter 2 Command System
Name Type
Range
Default
Name
Type
Range
Default
Name
Type
Range
Default

:CALCulate:MARKer<n>:MAXimum:MAX

Syntax
:CALCulate:MARKer<n>:MAXimum:MAX Description
Execute a peak search according to the search mode set by
:CALCulate:MARKer<n>:PEAK:SEARch:MODE command and mark the peak using the specified marker.
the Parameter
<n> Discrete 1|2|3|4 --
Example The command below executes a peak search and marks the peak using marker 2. :CALCulate:MARKer2:MAXimum:MAX

:CALCulate:MARKer<n>:MAXimum:NEXT

Syntax
:CALCulate:MARKer<n>:MAXimum:NEXT
Description
Search and mark the peak whose amplitu de is closest to that of the current peak and which meet s the peak search condition.
Parameter
<n> Discrete 1|2|3|4 --
Explanation
When no peak is found, "No peak found" is displayed on the screen.

:CALCulate:MARKer<n>:MAXimum:RIGHt

Syntax
:CALCulate:MARKer<n>:MAXimum:RIGHt
Description
Search and mark the nearest peak which is located at the right side of the current peak and meets t he peak search condition.
Parameter
<n> Discrete 1|2|3|4 --
Explanation
When no peak is fo und, "No peak found" is di splayed on the screen.
2-16 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
--
Keyword
POSition|DELTa|BAND|SPAN
POSition

:CALCulate:MARKer<n>:MINimum

Syntax
:CALCulate:MARKer<n>:MINimum
Description
Search and mark the peak on the trace with the minimum amplitude.
Parameter
<n> Discrete 1|2|3|4 --
Explanation
When no peak is fo und, "No peak found" is displayed on the screen.

:CALCulate:MARKer<n>:MODE

Syntax
:CALCulate:MARKer<n>:MODE POSition|DELTa|BAND|SPAN :CALCulate:MARKer<n>:MODE?
Description
Set the type of the specified marker. Query the type of the specified marker.
Parameter
Name
<n> Discrete 1|2|3|4 --
Type Range Default
Explanation
POSition: Normal DELTa: Delta BAND: Delta Pair SPAN: Span Pair
Return Format
The query returns POS, DELT, BAND or SPAN.
Example
The command below sets the type of marker 1 to Normal. :CALCulate:MARKer1:MODE POSition
The query below returns POS. :CALCulate:MARKer1:MODE?
DSA700 Programming Guide 2-17
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Name
Type
Range
Default
<n>
Discrete
1|2|3|4
--
--
Keyword
PARameter|MAXimum
MAXimum

:CALCulate:MARKer<n>:PEAK:EXCursion

Syntax
:CALCulate:MARKer<n>:PEAK:EXCursion <rel_ampl> :CALCulate:MARKer<n>:PEAK:EXCursion?
Description
Set the peak excurs ion and the unit is dB . Query the peak excursion.
Parameter
<n> Discrete 1|2|3|4 --
<rel_ampl> Consecutive Real Number 0 dB to 200 dB 10 dB
Return Format
The query returns the peak excursion in scientific notation.
Example
The command below sets the peak excursion to 12 dB. :CALCulate:MARKer1:PEAK:EXCursion 12
The query below returns 1.200000E+01. :CALCulate:MARKer1:PEAK:EXCursion?

:CALCulate:MARKer<n>:PEAK:SEARch:MODE

Syntax
:CALCulate:MARKer<n>:PEAK:SEARch:MODE PARameter|MAXimum :CALCulate:MARKer<n>:PEAK:SEARch:MODE?
Description
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

:CALCulate:MARKer<n>:PEAK:THReshold

Syntax
:CALCulate:MARKer<n>:PEAK:THReshold <ampl> :CALCulate:MARKer<n>:PEAK:THReshold?
Description
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 Guide 2-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 Guide 2-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
2-22 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
<n>
Discrete
1|2|3|4
--
<integer>
Discrete
1|2|3|4
1

:CALCulate:MARKer<n>:STATe

Syntax
:CALCulate:MARKer<n>:STATe OFF|ON|0|1 :CALCulate:MARKer<n>:STATe?
Description
Enable or disable the specified marker. Query the status of the specified marker.
Parameter
<n> Discrete 1|2|3|4 --
-- Bool OFF|ON|0|1 OFF|0
Explanation
If the specified marker is not enabled currently, it will be set to Normal marker (POSition) when this command is sent to enable it.
Return Format
The query returns 0 or 1.
Example
The command below enables marker 1. :CALCulate:MARKer1:STATe ON or :CALCulate:MARKer1:STATe 1
The query below returns 1. :CALCulate:MARKer1:STATe?

:CALCulate:MARKer<n>:TRACe

Syntax
:CALCulate:MARKer<n>:TRACe <integer> :CALCulate:MARKer<n>:TRACe?
Description
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 Guide 2-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?

:CALCulate:MARKer<n>:TRACe:AUTO

Syntax
:CALCulate:MARKer<n>:TRACe:AUTO OFF|ON|0|1 :CALCulate:MARKer<n>:TRACe:AUTO?
Description
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
The query returns 15000000. :CALCulate:MARKer1:X?
DSA700 Programming Guide 2-25
RIGOL Chapter 2 Command System
Name Type Range
Default
<param>
Consecutive Real Number
Refer to Explanation
--

:CALCulate:MARKer<n>:X:CENTer

Syntax
:CALCulate:MARKer<n>:X:CENTer <param> :CALCulate:MARKer<n>:X:CENTer?
Description
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?
2-26 DSA700 Programming Guide
Chapter 2 Command System RIGOL

:CALCulate:MARKer<n>:X:POSition

Syntax
:CALCulate:MARKer<n>:X:POSition <integer> :CALCulate:MARKer<n>:X:POSition?
Description
Set the position of the specified Normal marker. Query the position of the specified Normal marker.
Parameter
Name
<n> Discrete 1|2|3|4 --
<integer> Integer 0 to 600 300
Return Format
The query returns t he position of the marker in integer.
Type Range Default
Example
The command below sets the position of marker 1 (Normal marker) to 100. :CALCulate:MARKer1:X:POSition 100
The query below returns 100. :CALCulate:MARKer1:X:POSition?

:CALCulate:MARKer<n>:X:POSition:CENTer

Syntax
:CALCulate:MARKer<n>:X:POSition:CENTer <param> :CALCulate:MARKer<n>:X:POSition:CENTer?
Description
Set the center position of the specified Span Pair marker. Query the center position of the specified Span Pair marker.
Parameter
Name
<n> Discrete 1|2|3|4 --
<param> Integer 0 to 600 300
Return Format
The query returns the center position of the specified marker in integer.
Example
The command below sets the center position of marker 1 (Span Pair marker) to 200. :CALCulate:MARKer1:X:POSition:CENTer 200
The query below returns 200. :CALCulate:MARKer1:X:POSition:CENTer?
Type Range Default
DSA700 Programming Guide 2-27
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Name
Type
Range
Default

:CALCulate:MARKer<n>:X:POSition:SPAN

Syntax
:CALCulate:MARKer<n>:X:POSition:SPAN <param> :CALCulate:MARKer<n>:X:POSition:SPAN?
Description
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?

:CALCulate:MARKer<n>:X:POSition:STARt

Syntax
:CALCulate:MARKer<n>:X:POSition:STARt <param> :CALCulate:MARKer<n>:X:POSition:STARt?
Description
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?
2-28 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type Range
Default

:CALCulate:MARKer<n>:X:POSition:STOP

Syntax
:CALCulate:MARKer<n>:X:POSition:STOP <param> :CALCulate:MARKer<n>:X:POSition:STOP?
Description
Set the position of the delta marker of the specified Delta Pair marker. Query the position of the delta 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 delta marker in integer.
Example
The command below sets the position of the delta marker of marker 1 (Delta Pair marker) to 300. :CALCulate:MARKer1:X:POSition:STOP 300
The query below returns 300. :CALCulate:MARKer1:X:POSition:STOP?

:CALCulate:MARKer<n>:X:READout

Syntax
:CALCulate:MARKer<n>:X:READout FREQuency|TIME|ITIMe|PERiod :CALCulate:MARKer<n>:X:READout?
Description
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?
Type Range Default
-- Keyword FREQuency|TIME|ITIMe|PERiod Refer to Explanation
DSA700 Programming Guide 2-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 Explanation 0
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?

:CALCulate:MARKer<n>:X:STARt

Syntax
:CALCulate:MARKer<n>:X:STARt <param> :CALCulate:MARKer<n>:X:STARt?
Description
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?

:CALCulate:MARKer<n>:X:STOP

Syntax
:CALCulate:MARKer<n>:X:STOP <param> :CALCulate:MARKer<n>:X:STOP?
Description
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?
Type Range Default
DSA700 Programming Guide 2-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?

:CALCulate:MARKer:TABLe:STATe

Syntax
:CALCulate:MARKer:TABLe:STATe OFF|ON|0|1 :CALCulate:MARKer:TABLe:STATe?
Description
Enable or disable the marker table. Query the status of the marker table.
Parameter
Return Format
The query returns 0 or 1.
Example
The command below disables the marker table. :CALCulate:MARKer:TABLe:STATe OFF or :C ALCulate:MARKer:TABLe:STATe 0
The query below returns 0. :CALCulate:MARKer:TABLe:STATe?
2-32 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name Type
Range
Default

:CALCulate:MARKer:TRACking:STATe

Syntax
:CALCulate:MARKer:TRACking:STATe OFF|ON|0|1 :CALCulate:MARKer:TRACking:STATe?
Description
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 Guide 2-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
The query below returns 1. :CALibration:AUTO?
-- Bool OFF|ON|0|1 ON|1
2-34 DSA700 Programming Guide
Chapter 2 Command System RIGOL

:CONFigure Subsystem

Command List:
:CONFigure?:CONFigure:ACPower:CONFigure:CHPower* :CONFigure:CNRatio* :CONFigure:EBWidth* :CONFigure:HDISt* :CONFigure:OBWidth* :CONFigure:PF:CONFigure:SANalyzer:CONFigure:TOI* :CONFigure:TPOWer*
Explanation:
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 Guide 2-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 Guide 2-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
The query below returns NONE. :COUPle?
DSA700 Programming Guide 2-39
RIGOL Chapter 2 Command System

:DISPlay Subsystem

Command List:
:DISPlay:AFUnction:POSition :DISPlay:ANNotation:CLOCk[:STATe] :DISPlay:BRIGhtness:DISPlay:ENABle:DISPlay:MSGswitch:STATe :DISPlay:UKEY:STATe :DISPlay:WINdow:TRACe:GRATicule:GRID :DISPlay:WINdow:TRACe:X[:SCALe]:SPACing:DISPlay:WINdow:TRACe:Y:DLINe :DISPlay:WINdow:TRACe:Y:DLINe:STATe :DISPlay:WINdow:TRACe:Y[:SCALe]:PDIVision :DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel:OFFSet:DISPlay:WINdow:TRACe:Y[:SCALe]:SPACing
2-40 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type Range
Default
Name
Type Range
Default

:DISPlay:AFUnction:POSition

Syntax
:DISPlay:AFUnction:POSition BOTTom|CENTer|TOP :DISPlay:AFUnction:POSition?
Description
Set the position of the active function area on the screen. Query the position of the active function area on the screen.
Parameter
-- Keyword BOTTom|CENTer|TOP TOP
Explanation
BOTTom: bottom CENTer: center TOP: top
Return Format
The query returns BOTT, CENT or TOP.
Example
The command below sets the position of the active function area to the screen center. :DISPlay:AFUnction:POSition CEN Ter
The query below returns CENT. :DISPlay:AFUnction:POSition?

:DISPlay:ANNotation:CLOCk[:STATe]

Syntax
:DISPlay:ANNotation:CLOCk[:STATe] OFF|ON|0|1 :DISPlay:ANNotation:CLOCk[:STATe]?
Description
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 Guide 2-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
The query below returns 0. :DISPlay:ENABle?
2-42 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
Name
Type
Range
Default
--
Bool
OFF|ON|0|1
ON|1

:DISPlay:MSGswitch:STATe

Syntax
:DISPlay:MSGswitch:STATe OFF|ON|0|1 :DISPlay:MSGswitch:STATe?
Description
Enable or disable the message display. Query the status of message display.
Parameter
-- Bool OFF|ON|0|1 ON|1
Return Format
The query returns 0 or 1.
Example
The command below disables the message display. :DISPlay:MSGswitch:STATe OFF or :DISPlay:MSGswitch:STATe 0
The query below returns 0. :DISPlay:MSGswitch:STATe?

:DISPlay:UKEY:STATe

Syntax
:DISPlay:UKEY:STATe OFF|ON|0|1 :DISPlay:UKEY:STATe?
Description
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 Guide 2-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?

:DISPlay:WINdow:TRACe:X[:SCALe]:SPACing

Syntax
:DISPlay:WINdow:TRACe:X[:SCALe]:SPACing LINear|LOGarithmic :DISPlay:WINdow:TRACe:X[:SCALe]:SPACing?
Description Set the scale type of X-axis. Query the scale type of X-axis.
Parameter
Explanation
LINear: linear LOGarithmic: log
Return Format
The query returns LIN or LOG. Example
The command below sets the scale type of X-axis to LOG. :DISPlay:WINdow:TRACe:X:SCALe:SPACing LOGarithmic
The query below returns LOG. :DISPlay:WINdow:TRACe:X:SCALe:SPACing?
2-44 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
Name
Type
Range
Default

:DISPlay:WINdow:TRACe:Y:DLINe

Syntax
:DISPlay:WINdow : TR ACe :Y:DLINe <ampl> :DISPlay:WINdow:TRACe:Y:DLINe?
Description
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?
DSA700 Programming Guide 2-45
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Name
Type
Range
Default
<rel_ampl>
Consecutive Real Number
-100 dBm to 20 dBm
0 dBm

:DISPlay:WINdow:TRACe:Y[:SCALe]:PDIVision

Syntax
:DISPlay:WINdow:TRACe:Y[:SCALe]:PDIVision <rel_ampl> :DISPlay:WINdow:TRACe:Y[:SCALe]:PDIVision?
Description
Set the Y-axis scale. Query the Y-axis scale.
Parameter
<rel_ampl> Consecutive Real Number 0.1 dB to 20 dB 10 dB
Return Format
The query returns the Y-axis scale in scientific notation.
Example
The command below sets the Y-axis scale to 15 dB. :DISPlay:WINdow:TRACe:Y:SCALe:PDIVision 15
The query below returns 1.500000E+01. :DISPlay:WINdow:TRACe:Y:SCALe:PDIVision?

:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel

Syntax
:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel <ampl> :DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel?
Description
Set the reference level. Query the reference level.
Parameter
Return Format
The query returns the reference l evel in scientific notation.
Example
The command below sets the reference level to -10 dBm. :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel -10
The query below returns -1.000000E+01. :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel?
2-46 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
Name
Type
Range
Default

:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel:OFFSet

Syntax
:DISPlay:WINdow : TR ACe :Y [ :SCA Le]:RLEVel:OFFSet <rel_ampl > :DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel:OFFSet?
Description
Set the offset of the reference level. Query the offset of the reference level.
Parameter
<rel_ampl> Consecutive Real Number -300 dB to 300 dB 0 dB
Explanation
The offset of the referenc e level modifies the referenc e level and amplitude readou t of the marker; but does not change the position of the curve.
Return Format
The query returns the offset of the reference level in scientific notation.
Example
The command below sets the offset of the reference level to 10 dB. :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFFSet 10
The query below returns 1.000000E+01. :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFFSet?

:DISPlay:WINdow:TRACe:Y[:SCALe]:SPACing

Syntax
:DISPlay:WINdow:TRACe:Y[:SCALe]:SPACing LINear|LOGarithmic :DISPlay:WINdow:TRACe:Y[:SCALe]:SPACing?
Description
Set the scale type of Y-axis. Query the scale type of Y-axis.
Parameter
-- Keyword LINear|LOGarithmic LOGarithmic
Explanation
LINear: linear LOGarithmic: log
Return Format
The query returns LIN or LOG.
Example
The command below sets the scale type of Y-axis to log. :DISPlay:WINdow:TRACe:Y:SCALe:SPACing LOGarithmic
The query below returns LOG. :DISPlay:WINdow:TRACe:Y:SCALe:SPACing?
DSA700 Programming Guide 2-47
RIGOL Chapter 2 Command System

:FETCh Subsystem

Command List:
:FETCh:ACPower?:FETCh:ACPower:LOWer?:FETCh:ACPower:MAIN?:FETCh:ACPower:UPPer?:FETCh:CHPower?:FETCh:CHPower:CHPower?:FETCh:CHPower:DENSity?:FETCh:CNRatio?:FETCh:CNRatio:CARRier?:FETCh:CNRatio:CNRatio?:FETCh:CNRatio:NOISe?:FETCh:EBWidth?:FETCh:HARMonics:AMPLitude:ALL?:FETCh:HARMonics:AMPLi tud e? <n > :FETCh:HARMonics[:DISTortion]? :FETCh:HARMonics:FREQuency:ALL?:FETCh:HARMonics:FREQuency? <n>:FETCh:HARMonics:FUNDamental?:FETCh:OBWidth? :FETCh:OBWidth:OBWidth? :FETCh:OBWidth:OBWidth:FERRor? :FETCh:TOIntercept? :FETCh:TOIntercept:IP3? :FETCh:TPOWer?
Explanation:
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 Guide 2-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 Guide 2-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 Guide 2-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.
Example
The query below returns
-1.692102E+01,-6.458423E+01,-7.509421E+01,-7.924328E+01,-7.847027E+01,-7.885457E+01,-7.8823
58E+01,-7.921457E+01,-7.923057E+01,-7.915358E+01. :FETCh:HARMonics:AMPLitude:ALL?

:FETCh:HARMonics:AMPLitude? <n>

Syntax
:FETCh:HARMoni cs :A MP Litude? <n>
Description
Query the amplitude of the specified harmonic.
Parameter
<n> Integer 1 to 10 --
Explanation
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 Guide 2-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 Guide 2-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 Guide 2-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
The query below returns NORM. :FORMat:BORDer?
DSA700 Programming Guide 2-61
RIGOL Chapter 2 Command System
Name
Type Range
Default

:FORMat[:TRACe][:DATA]

Syntax
:FORMat[:TRACe][:DATA] ASCii|REAL[,32] :FORMat[:TRACe][:DATA]?
Description
Set the input/output format of the trace data. Query the input/output format of the trace data.
Parameter
Explanation
ASCii: the data points are ASCII characters separated by commas. REAL[,32]: the data points are a 32 bit binary number.
Return Format
The query returns ASCII or REAL,32.
Example
The command below sets the input/output format of the trace data to REAL,32. :FORMat:TRACe:DATA REAL,32
The query below returns REAL,32. :FORMat:TRACe:DATA?
-- Keyword ASCii|REAL[,32] ASCii
2-62 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default

:HCOPy Subsystem

Command List:
:HCOPy:ABORt:HCOPy:IMAGe:COLor[:STATe] :HCOPy:IMAGe:FTYPe:HCOPy:IMAGe:INVert:HCOPy:IMAGe:PTIMe:HCOPy:IMAGe:QUALity:HCOPy[:IMMediate]:HCOPy:PAGE:ORIentation :HCOPy:PAGE:PRINts :HCOPy:PAGE:SIZE:HCOPy:RESume

:HCOPy:ABORt

Syntax
:HCOPy:ABORt
Description
Cancel the current print operation.

:HCOPy:IMAGe:COLor[:STATe]

Syntax
:HCOPy:IMAGe:COLor[:STATe] OFF|ON|0|1 :HCOPy:IMAGe:COLor[:STATe]?
Description
Set the print color to gray or color. Query the print color.
Parameter
Explanation
OFF|0: gray ON|1: color
Return Format
The query returns 0 or 1.
Example
The command below sets the print color to gray. :HCOPy:IMAGe:COLor:STATe OFF or :HCOPy:IMAGe:COLor:STATe 0
-- Bool OFF|ON|0|1 OFF|0
The query below returns 0. :HCOPy:IMAGe:COLor:STATe?
DSA700 Programming Guide 2-63
RIGOL Chapter 2 Command System
Name
Type Range
Default
Name
Type
Range
Default
--
Bool
OFF|ON|0|1
OFF|0

:HCOPy:IMAGe:FTYPe

Syntax
:HCOPy:IMAGe:FTYPe DEFault|EXIFjpeg :HCOPy:IMAGe:FTYPe?
Description
Set the image type of the print to default or Exif/JPEG.
Parameter
-- Keyword DEFault|EXIFjpeg DEFault
Return Format
The query returns DEF or EXIF.
Example
The command below sets the image type of the print to Exif/JPEG. :HCOPy:IMAGe :FTYPe EXIFjpeg
The query below returns EXIF. :HCOPy:IMAGe:FTYPe?

:HCOPy:IMAGe:INVert

Syntax
:HCOPy:IMAGe:INVert OFF|ON|0|1 :HCOPy:IMAGe:INVert?
Description
Enable or disable inverted print. Query the status of inverted print.
Parameter
Explanation
OFF|0: disable inverted print. ON|1: enable inverted print.
Return Format
The query returns 0 or 1.
Example
The command below enables inverted print. :HCOPy:IMAGe:INVert ON or :HCOPy:IMAGe:INVert 1
The query below returns 1. :HCOPy:IMAGe:INVert?
2-64 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
Name
Type
Range
Default

:HCOPy:IMAGe:PTIMe

Syntax
:HCOPy:IMAGe:PTIMe OFF|ON|0|1 :HCOPy:IMAGe:PTIMe?
Description
Enable or disable date print. Query the status of date print.
Parameter
-- Bool OFF|ON|0|1 OFF|0
Explanation
OFF|0: disable date print. ON|1: enable date print.
Return Format
The query returns 0 or 1.
Example
The command below enables date print. :HCOPy:IMAGe :PTIMe ON or :HCOPy:IMAGe:PTIM e 1
The query below returns 1. :HCOPy:IMAGe:PTIMe?

:HCOPy:IMAGe:QUALity

Syntax
:HCOPy:IMAGe:QUALity DEFault|NORMal|DRAFt|FINE :HCOPy:IMAGe:QUALity?
Description
Set the print quali ty. Query the print quality.
Parameter
-- Keyword DEFault|NORMal|DRAFt|FINE DEFault
Explanation
DEFault: default NORMal: normal DRAFt: draft FINE: fine
Return Format
The query returns DEF, NORM, DRAF or FINE.
DSA700 Programming Guide 2-65
RIGOL Chapter 2 Command System
Name
Type
Range
Default
Example
The command below sets the print quality to draft. :HCOPy:IMAGe :Q UALi ty DRAFt
The query below returns DRAF. :HCOPy:IMAGe:QUALity?

:HCOPy[:IMMediate]

Syntax
:HCOPy[:IMMediate]
Description
Execute the print operation.

:HCOPy:PAGE:ORIentation

Syntax
:HCOPy:PAGE:ORIentation LANDscape|PORTrait :HCOPy:PAGE:ORIentation?
Description
Set the print orientation to landscape or portrait. Query the print orientation.
Parameter
-- Keyword LANDscape|PORTrait LANDscape
Explanation
LANDscape: landscape PORTrait: portrait
Return Format
The query returns LAND or PORT.
Example
The command below sets the print orientation to portrait. :HCOPy:PAGE:ORIentation PORTrait
The query below returns PORT. :HCOPy:PAGE:ORIentation?
2-66 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type Range
Default
Name
Type
Range
Default
--
Keyword
DEFault|A4|A5|A6|B5
DEFault

:HCOPy:PAGE:PRINts

Syntax
:HCOPy:PAGE:PRINts <integer> :HCOPy:PAGE:PRINts?
Description
Set the print copies. Query the print copies.
Parameter
<integer> Integer 1 to 999 1
Return Format
The query returns the print copies in integer.
Example
The command below sets the print copies to 10. :HCOPy:PAGE:PRINts 10
The query below returns 10. :HCOPy:PAGE:PRINts?

:HCOPy:PAGE:SIZE

Syntax
:HCOPy:PAGE:SIZE DEFault|A4|A5|A6|B5 :HCOPy:PAGE:SIZE?
Description
Set the page size of the print. Query the page size of the print.
Parameter
Return Format
The query returns DEF, A4, A5, A6 or B5.
Example
The command below sets the page size of the print to A5. :HCOPy:PAGE:SIZE A5
The query below returns A5. :HCOPy:PAGE:SIZE?
DSA700 Programming Guide 2-67
RIGOL Chapter 2 Command System

:HCOPy:RESume

Syntax
:HCOPy:RESume
Description
Resume the paused print task.
2-68 DSA700 Programming Guide
Chapter 2 Command System RIGOL
Name
Type
Range
Default
<value>
Integer
Refer to Explanation
0

IEEE 488.2 Common Commands

IEEE 488.2 common commands are used to operate or query the status registers. About the structure of the status registers, please refer to
Command List:
*CLS*ESE*ESR?*IDN?*OPC*RST*SRE*STB?*TRG*TST?
:STATus Subsystem.
*WAI

*CLS

Syntax
*CLS
Description
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 Guide 2-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 Guide 2-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.

*WAI

Syntax
*WAI
Description
Wait for the operation to finish.
2-72 DSA700 Programming Guide
Chapter 2 Command System RIGOL

:INITiate Subsystem

Command List:
:INITiate:CONTinuous:INITiate[:IMMediate] :INITiate:PAUSe:INITiate:RESTart* :INITiate:RESume*
Explanation:
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?
Type Range Default
DSA700 Programming Guide 2-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
The query below returns 75. :INPut:IMPedance?
DSA700 Programming Guide 2-75
RIGOL Chapter 2 Command System

:MMEMory Subsystem

Command List:
:MMEMory:DELete:MMEMory:DISK:INFormation?:MMEMory:LOAD:CORRection:MMEMory:LOAD:LIMit:MMEMory:LOAD:MTABle :MMEMory:LOAD:SETUp:MMEMory:LOAD:STATe :MMEMory:LOAD:TRACe:MMEMory:MOVE:MMEMory:STORe:CORRection:MMEMory:STORe:LIMit:MMEMory:STORe:MTABle :MMEMory:STORe:PTABle :MMEMory:STORe:RESults:MMEMory:STORe:SCReen:MMEMory:STORe:SETUp:MMEMory:STORe:STATe :MMEMory:STORe:TRACe

:MMEMory:DELete

Syntax
:MMEMory:DELete <file_name>
Description
Delete the file with the specified filename.
Parameter
Name Type Range Default
<file_name> ASCII String -- --
Explanation
<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
:MMEMory:DISK:INFormation?

:MMEMory:LOAD:CORRection

Syntax
:MMEMory:LOAD:CORRection ANTenna|CABLe|OTHer|USER,<file_name>
Description
Load the data of the specified file (.cbl) and execute amplitude correction.
Parameter
<file_name>
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 the 123.cbl file in the D disk and executes amplitude correction. :MMEMory:LOAD:CORRection ANT,D:\Corr0:123.cbl
-- Keyword ANTenna|CABLe|OTHer|USER -­ASCII String -- --
DSA700 Programming Guide 2-77
RIGOL Chapter 2 Command System
Name
Type Range
Default
Name
Type
Range
Default
<file_name>
ASCII String
--
--

:MMEMory:LOAD:LIMit

Syntax
:MMEMory:LOAD: LI Mit <fil e _nam e>
Description
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...