RIGOL
Programming Guide
DSA700 Series Spectrum Analyzer
Aug. 2016
RIGOL TECHNOLOGIES, INC.
RIGOL
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 this document is forbidden to be copied, photocopied or rearranged without prior written approval of RIGOL.
Product Certification
RIGOL guarantees that this product conforms to the national and industrial standards in China as well as the ISO9001:2008 standard and the ISO14001:2004 standard. Other international standard conformance certifications are in progress.
Contact Us
If you have any problem or requirement when using our products or this manual, please contact RIGOL. E-mail: service@rigol.com
Website: www.rigol.com
DSA700 Programming Guide |
I |
RIGOL
Please review the following safety precautions carefully before putting the instrument into operation so as to avoid any personal injury or damage to the instrument 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 overvoltage (such as that caused by a bolt of lightning) can reach the product. Otherwise, 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 Outlet.
Do not insert objects into the air outlet, as doing so may cause damage to the instrument.
Use Proper Fuse.
Please use the specified fuses.
Avoid Circuit or Wire Exposure.
Do not touch exposed junctions and components when the unit is powered on.
Do Not Operate With Suspected Failures.
If you suspect damage occurs to the instrument, have it inspected by RIGOL authorized personnel before further operations. Any maintenance, adjustment or replacement especially to circuits or accessories must be performed by RIGOL authorized personnel.
Provide Adequate Ventilation.
Inadequate ventilation may cause an increase of temperature in the instrument, which would cause damage to the instrument. So please keep the instrument well ventilated and inspect the air outlet and the fan regularly.
Do Not Operate in Wet Conditions.
To avoid short circuit inside the instrument or electric shock, never operate the instrument in a humid
II |
DSA700 Programming Guide |
RIGOL
environment.
Do Not Operate in an Explosive Atmosphere.
To avoid personal injuries or damage to the instrument, never operate the instrument in an explosive atmosphere.
Keep Instrument Surfaces Clean and Dry.
To avoid dust or moisture from affecting the performance of the instrument, keep the surfaces of the instrument clean and dry.
Prevent Electrostatic Impact.
Operate the instrument in an electrostatic discharge 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
Safety Notices in this Manual:
WARNING
Indicates a potentially hazardous situation or practice which, if not avoided, will result in serious injury or death.
CAUTION
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:
DANGER
WARNING
CAUTION
Safety Symbols on the Product:
Hazardous |
Safety |
Protective |
Chassis |
Test |
Voltage |
Warning |
Earth |
Ground |
Ground |
|
|
Terminal |
|
|
IV |
DSA700 Programming Guide |
RIGOL
Ü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, wiein diesem Handbuchangegeben.
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 geerdet. Um Gefahren durch elektrischen Schlag zu vermeiden, ist es unerlässlich, die Erdung durchzuführen. Erst dann dürfen weitere Einoder 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 ungeschützte Verbindungen.
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 Vermeidung von Kurzschluß im Geräteinneren und Stromschlag betreiben Sie das Gerät bitte niemals in feuchter Umgebung.
Nicht in explosiver Atmosphäre betreiben.
Zur Vermeidung von Personenund 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 Staub 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 Innenund Außenleiter der Verbindungsleitung, um statische Aufladung zu entladen.
Die richtige Verwendung desAkku.
Wenneine Batterieverwendet wird, vermeiden Sie hohe Temperaturen bzw. Feuer ausgesetzt werden. Bewahren Sie es außerhalbder Reichweitevon Kindern auf. UnsachgemäßeÄnderung derBatterie (Anmerkung: Lithium-Batterie) kann zu einer Explosion führen. VerwendenSie nur von RIGOL angegebenenAkkus.
Sicherer Transport.
Transportieren Sie das Gerät sorgfältig (Verpackung!), um Schäden an Bedienelementen, Anschlüssen und anderen Teilen zu vermeiden.
VI |
DSA700 Programming Guide |
RIGOL
Begriffe in diesem Guide:
WARNING
Die Kennzeichnung WARNING beschreibt Gefahrenquellen die leibliche Schäden oder den Tod von Personen zur Folge haben können.
CAUTION
Die Kennzeichnung Caution (Vorsicht) beschreibt Gefahrenquellen die Schäden am Gerät hervorrufen können.
Begriffe auf dem Produkt:
DANGER weist auf eine Verletzung oder Gefährdung hin, die sofort geschehen kann. WARNING weist auf eine Verletzung oder Gefährdung hin, die möglicherweise nicht sofort
geschehen.
CAUTION weist auf eine Verletzung oder Gefährdung hin und bedeutet, dass eine mögliche
Beschädigung des Instruments oder anderer Gegenstände auftreten kann.
Symbole auf dem Produkt:
Gefährliche |
Sicherheits- |
Schutz-erde |
Gehäusemasse |
Erde |
|
Spannung |
Hinweis |
||||
|
|
|
DSA700 Programming Guide |
VII |
RIGOL
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 denoted by the format of "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 step is denoted by an arrow "" in the manual. For example, FREQ Center Freq denotes that you first press FREQ on the front panel and then press Center Freq.
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.
Model |
Frequency Range |
Tracking Generator |
DSA705 |
100 kHz to 500 MHz |
None |
DSA710 |
100 kHz to 1 GHz |
None |
VIII |
DSA700 Programming Guide |
Contents RIGOL
Contents
Guaranty and Declaration ......................................................................................................... |
I |
|
Safety Requirement.................................................................................................................. |
II |
|
General Safety Summary............................................................................................................. |
II |
|
Safety Notices and Symbols......................................................................................................... |
IV |
|
Allgemeine Sicherheits Informationen ........................................................................................... |
V |
|
Sicherheits Begriffe 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 |
DSA700 |
IX |
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:AMPLitude? <n>................................................................................. |
2-55 |
:FETCh:HARMonics[:DISTortion]?...................................................................................... |
2-56 |
:FETCh:HARMonics:FREQuency:ALL?................................................................................. |
2-56 |
:FETCh:HARMonics:FREQuency? <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 |
XII |
DSA700 Programming Guide |
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 based on the standard IEEE488.1 and IEEE 488.2 and conforms to various stardards (such as the floating point operation rule in IEEE754 stardard, ISO646 7-bit coded character for information interchange (equivalent to ASCll programming).
Main topics of this chapter:
Syntax
Symbol Description
Parameter Type
Command Abbreviation
DSA700 Programming Guide |
1-1 |
RIGOL |
Chapter 1 SCPI Overview |
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 available, "?" 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 root keyword of the command. BANDwidth and NDB are the second-level and third-level keywords respectively. The command string starts with ":" which separates 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 <year>,<month>,<day>
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 used to separate multiple parameters and one of the parameters must be selected when sending the command. For example,
In the :DISPlay:ANNotation:CLOCk[:STATe] OFF|ON|0|1 command, the command parameters available 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 |
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 can be any integer within the effective value range. Note that do not set the parameter to a decimal; otherwise errors will occur. For example,
:DISPlay:BRIGhtness <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 only be one of the specified values and these values are discontinuous. For example, :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.
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 command 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 the corresponding function 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 |
Syntax
:ABORt
Description
Give up the current operation and restart the sweep.
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 |
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
Name |
Type |
Range |
Default |
<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?
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 ----.
Syntax
:CALCulate:LLINe:ALL:DELete
Description
Delete the limit line currently edited.
2-4 |
DSA700 Programming Guide |
Chapter 2 Command System |
RIGOL |
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
Name |
Type |
Range |
Default |
-- |
Keyword |
FREQuency|TIME |
FREQuency |
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:LLINe:CONTrol:DOMain TIME
The query below returns TIME. :CALCulate:LLINe:CONTrol:DOMain?
Syntax
:CALCulate:LLINe:FAIL?
Description
Query the result of the Pass/Fail test.
Return Format
The query returns PASS or FAIL. The query returns UNMEAS if the test is not finished.
DSA700 Programming Guide |
2-5 |
RIGOL |
Chapter 2 Command System |
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?
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
Name |
Type |
Range |
Default |
-- |
Bool |
OFF|ON|0|1 |
ON|1 |
Explanation
If the parameter is set to ON or 1, the test stops when the test fails and the test continues 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 :CALCulate:LLINe:FAIL:STOP:STATe 1
The query below returns 1. :CALCulate:LLINe:FAIL:STOP:STATe?
2-6 |
DSA700 Programming Guide |
Chapter 2 Command System |
RIGOL |
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
Name |
Type |
Range |
Default |
<n> |
Discrete |
1|2 |
-- |
-- |
Keyword |
LOGarithmic|LINear |
LINear |
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?
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
Name |
Type |
Range |
Default |
|
<n> |
Discrete |
1|2 |
2 |
|
<x-axis> |
Consecutive |
0 Hz to 1 GHz (the X axis denotes frequency) |
-- |
|
Real Number |
0 us to 1 ks (the X axis denotes time) |
|||
|
|
|||
<ampl> |
Consecutive |
-400 dBm to 320 dBm |
-- |
|
Real Number |
||||
|
|
|
||
<connected> |
Discrete |
0|1 |
0 |
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 |
RIGOL |
Chapter 2 Command System |
<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 with 3 points. :CALCulate:LLINe2:DATA 50,100,0,100,150,1,200,200,1
The query below returns 50,100.000000,0,100,150.000000,1,200,200.000000,1. :CALCulate:LLINe2:DATA?
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
Name |
|
Type |
Range |
Default |
<n> |
|
Discrete |
1|2 |
2 |
<x-axis> |
|
Consecutive |
0 Hz to 1 GHz (X axis denotes frequency) |
-- |
|
Real Number |
0 us to 1 ks (X axis denotes time) |
||
|
|
|
||
<ampl> |
|
Consecutive |
-400 dBm to 320 dBm |
-- |
|
Real Number |
|||
|
|
|
|
|
<connected> |
|
Discrete |
0|1 |
0 |
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,300,250,1
2-8 |
DSA700 Programming Guide |