Rigol DSA800E Series Operating instructions

RIGOL
DSA800E Programming Guide I
Guaranty and Declaration
Copyright
© 2016 RIGOL TECHNOLOGIES, INC. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL TECHNOLOGIES, INC.
Publication Number
PGD17100-1110
Software Version
DSA832E:00.01.02
Software upgrade might change or add product features. Please acquire the latest version of the manual
from RIGOL website or contact RIGOL to upgrade the software.
Notices
RIGOL products are covered by P.R.C. and foreign patents, issued and pending.
RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at
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: servi[email protected]
Website: www.rigol.com

RIGOL
II DSA800E Programming Guide
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 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

RIGOL
DSA800E Programming Guide III
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.

RIGOL
IV DSA800E Programming Guide
Safety Notices and Symbols
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
It calls attention to an operation, if not correctly performed, could result in injury or
hazard immediately.
WARNING
It calls attention to an operation, if not correctly performed, could result in
potential
injury or hazard.
CAUTION
It calls attention to an operation, if not correctly performed, could result in
damage
to the product or other devices connected to the product.
Safety Symbols on the Product:
Hazardous
Voltage
Safety
Warning
Protective
Earth
Terminal
Chassis
Ground
Test
Ground

RIGOL
DSA800E Programming Guide V
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, 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 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 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 Personen- und Sachschäden ist es unumgänglich, das Gerät ausschließlich fernab

RIGOL
VI DSA800E Programming Guide
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 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
DSA800E Programming Guide VII
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.
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
Spannung Sicherheits- Hinweis Schutz-erde Gehäusemasse Erde

RIGOL
VIII DSA800E Programming Guide
Document Overview
This manual introduces how to program and control RIGOL DSA800E 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 DSA800E command
in alphabetical order (from A to Z).
Chapter 3 Programming Demos
This chapter introduces how to program and control DSA800E 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:
DSA800E series spectrum analyzer includes the following two models.
Model
Frequency Range
Tracking Generator
DSA832E
9 kHz to 3.2 GHz
None
DSA832E-TG
9 kHz to 3.2 GHz
3.2 GHz

Contents RIGOL
DSA800E Programming Guide IX
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

RIGOL Contents
X DSA800E Programming Guide
:CALCulate:MARKer<n>[:SET]:STEP .................................................................................2-22
: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>:VSRefl? .......................................................................................2-25
:CALCulate:MARKer<n>:VSValue?.....................................................................................2-25
:CALCulate:MARKer<n>:X ................................................................................................2-26
:CALCulate:MARKer<n>:X:CENTer.....................................................................................2-27
:CALCulate:MARKer<n>:X:POSition...................................................................................2-28
:CALCulate:MARKer<n>:X:POSition:CENTer .......................................................................2-28
:CALCulate:MARKer<n>:X:POSition:SPAN..........................................................................2-29
:CALCulate:MARKer<n>:X:POSition:STARt.........................................................................2-29
:CALCulate:MARKer<n>:X:POSition:STOP..........................................................................2-30
:CALCulate:MARKer<n>:X:READout ..................................................................................2-30
:CALCulate:MARKer<n>:X:SPAN .......................................................................................2-31
:CALCulate:MARKer<n>:X:STARt.......................................................................................2-31
:CALCulate:MARKer<n>:X:STOP .......................................................................................2-32
:CALCulate:MARKer<n>:Y?...............................................................................................2-33
:CALCulate:MARKer:TABLe:STATe......................................................................................2-33
:CALCulate:MARKer:TRACking:STATe.................................................................................2-34
:CALCulate:NTData[:STATe] ..............................................................................................2-34
:CALibration Subsystem...........................................................................................................2-35
:CALibration:[ALL] ............................................................................................................2-35
:CALibration:AUTO............................................................................................................2-35
:CONFigure Subsystem............................................................................................................2-36
:CONFigure?.....................................................................................................................2-36
:CONFigure:ACPower........................................................................................................2-36
:CONFigure:CHPower........................................................................................................2-37
:CONFigure:CNRatio .........................................................................................................2-37
:CONFigure:EBWidth.........................................................................................................2-37
:CONFigure:HDISt ............................................................................................................2-38
:CONFigure:OBWidth........................................................................................................2-38
:CONFigure:PF .................................................................................................................2-38
:CONFigure:SANalyzer ......................................................................................................2-38
:CONFigure:TOI ...............................................................................................................2-39
:CONFigure:TPOWer.........................................................................................................2-39
:COUPle Subsystem.................................................................................................................2-40
:COUPle...........................................................................................................................2-40
:DISPlay Subsystem ................................................................................................................2-41
:DISPlay:AFUnction:POSition.............................................................................................2-42
:DISPlay:ANNotation:CLOCk[:STATe] .................................................................................2-42
:DISPlay:BRIGhtness ........................................................................................................2-43
:DISPlay:ENABle...............................................................................................................2-43
:DISPlay:MSGswitch:STATe ...............................................................................................2-44
:DISPlay:UKEY:STATe........................................................................................................2-44
:DISPlay:WINdow:TRACe:GRATicule:GRID.........................................................................2-45
:DISPlay:WINdow:TRACe:X[:SCALe]:SPACing ....................................................................2-45
:DISPlay:WINdow:TRACe:Y:DLINe.....................................................................................2-46
:DISPlay:WINdow:TRACe:Y:DLINe:STATe...........................................................................2-46
:DISPlay:WINdow:TRACe:Y[:SCALe]:NRLevel.....................................................................2-47
:DISPlay:WINdow:TRACe:Y[:SCALe]:NRPosition.................................................................2-47
:DISPlay:WINdow:TRACe:Y[:SCALe]:PDIVision ..................................................................2-48
:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel.......................................................................2-48
:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel:OFFSet...........................................................2-49
:DISPlay:WINdow:TRACe:Y[:SCALe]:SPACing ....................................................................2-49
:FETCh Subsystem ..................................................................................................................2-50
:FETCh:ACPower?.............................................................................................................2-51

Contents RIGOL
DSA800E Programming Guide XI
:FETCh:ACPower:LOWer? ................................................................................................. 2-51
:FETCh:ACPower:MAIN?................................................................................................... 2-52
:FETCh:ACPower:UPPer? .................................................................................................. 2-52
:FETCh:CHPower?............................................................................................................ 2-53
:FETCh:CHPower:CHPower?.............................................................................................. 2-53
:FETCh:CHPower:DENSity?............................................................................................... 2-54
:FETCh:CNRatio?.............................................................................................................. 2-54
:FETCh:CNRatio:CARRier?................................................................................................. 2-55
:FETCh:CNRatio:CNRatio?................................................................................................. 2-55
:FETCh:CNRatio:NOISe?................................................................................................... 2-56
:FETCh:EBWidth?............................................................................................................. 2-56
:FETCh:HARMonics:AMPLitude:ALL?.................................................................................. 2-57
:FETCh:HARMonics:AMPLitude? <n>................................................................................. 2-57
:FETCh:HARMonics[:DISTortion]?...................................................................................... 2-58
:FETCh:HARMonics:FREQuency:ALL?................................................................................. 2-58
:FETCh:HARMonics:FREQuency? <n> ............................................................................... 2-59
:FETCh:HARMonics:FUNDamental?.................................................................................... 2-59
:FETCh:OBWidth? ............................................................................................................ 2-60
:FETCh:OBWidth:OBWidth? .............................................................................................. 2-60
:FETCh:OBWidth:OBWidth:FERRor? .................................................................................. 2-61
:FETCh:TOIntercept?........................................................................................................ 2-61
:FETCh:TOIntercept:IP3?.................................................................................................. 2-62
:FETCh:TPOWer? ............................................................................................................. 2-62
:FORMat Subsystem................................................................................................................ 2-63
:FORMat:BORDer............................................................................................................. 2-63
:FORMat[:TRACe][:DATA]................................................................................................. 2-64
:HCOPy Subsystem................................................................................................................. 2-65
:HCOPy:ABORt................................................................................................................. 2-65
:HCOPy:IMAGe:COLor[:STATe].......................................................................................... 2-65
:HCOPy:IMAGe:FTYPe ...................................................................................................... 2-66
:HCOPy:IMAGe:INVert...................................................................................................... 2-66
:HCOPy:IMAGe:PTIMe...................................................................................................... 2-67
:HCOPy:IMAGe:QUALity ................................................................................................... 2-67
:HCOPy[:IMMediate] ........................................................................................................ 2-68
:HCOPy:PAGE:ORIentation ............................................................................................... 2-68
:HCOPy:PAGE:PRINts....................................................................................................... 2-69
:HCOPy:PAGE:SIZE .......................................................................................................... 2-69
:HCOPy:RESume.............................................................................................................. 2-70
IEEE 488.2 Common Commands.............................................................................................. 2-71
*CLS ............................................................................................................................... 2-71
*ESE ............................................................................................................................... 2-71
*ESR? ............................................................................................................................. 2-72
*IDN? ............................................................................................................................. 2-72
*OPC............................................................................................................................... 2-73
*RST............................................................................................................................... 2-73
*SRE............................................................................................................................... 2-73
*STB? ............................................................................................................................. 2-74
*TRG .............................................................................................................................. 2-74
*TST? ............................................................................................................................. 2-74
*WAI............................................................................................................................... 2-74
:INITiate Subsystem............................................................................................................... 2-75
:INITiate:CONTinuous...................................................................................................... 2-75
:INITiate[:IMMediate] ...................................................................................................... 2-76
:INITiate:PAUSe............................................................................................................... 2-76
:INITiate:RESTart............................................................................................................. 2-76
:INITiate:RESume............................................................................................................ 2-76
:INPut Subsystem................................................................................................................... 2-77
:INPut:IMPedance............................................................................................................ 2-77

RIGOL Contents
XII DSA800E Programming Guide
:MMEMory Subsystem .............................................................................................................2-78
:MMEMory:DELete............................................................................................................2-78
:MMEMory:DISK:INFormation?..........................................................................................2-79
:MMEMory:LOAD:CORRection............................................................................................2-79
:MMEMory:LOAD:LIMit......................................................................................................2-80
:MMEMory:LOAD:MTABle ..................................................................................................2-80
:MMEMory:LOAD:SETUp ...................................................................................................2-81
:MMEMory:LOAD:STATe ....................................................................................................2-81
:MMEMory:LOAD:TRACe ...................................................................................................2-82
:MMEMory:MOVE..............................................................................................................2-82
:MMEMory:STORe:CORRection..........................................................................................2-83
:MMEMory:STORe:LIMit....................................................................................................2-83
:MMEMory:STORe:MTABle.................................................................................................2-84
:MMEMory:STORe:PTABle .................................................................................................2-84
:MMEMory:STORe:RESults ................................................................................................2-85
:MMEMory:STORe:SCReen ................................................................................................2-85
:MMEMory:STORe:SETUp..................................................................................................2-86
:MMEMory:STORe:STATe...................................................................................................2-86
:MMEMory:STORe:TRACe..................................................................................................2-87
:OUTPut Subsystem ................................................................................................................2-88
:OUTPut[:STATe]..............................................................................................................2-88
:READ Subsystem ...................................................................................................................2-89
:READ:ACPower?..............................................................................................................2-90
:READ:ACPower:LOWer?...................................................................................................2-90
:READ:ACPower:MAIN?.....................................................................................................2-90
:READ:ACPower:UPPer?....................................................................................................2-91
:READ:CHPower?..............................................................................................................2-91
:READ:CHPower:CHPower? ...............................................................................................2-91
:READ:CHPower:DENSity?.................................................................................................2-92
:READ:CNRatio? ...............................................................................................................2-92
:READ:CNRatio:CARRier?..................................................................................................2-92
:READ:CNRatio:CNRatio? ..................................................................................................2-93
:READ:CNRatio:NOISe?.....................................................................................................2-93
:READ:EBWidth? ..............................................................................................................2-93
:READ:HARMonics:AMPLitude:ALL? ...................................................................................2-94
:READ:HARMonics:AMPLitude? <n> ..................................................................................2-94
:READ:HARMonics[:DISTortion]? .......................................................................................2-95
:READ:HARMonics:FREQuency:ALL? ..................................................................................2-95
:READ:HARMonics:FREQuency? <n>.................................................................................2-96
:READ:HARMonics:FUNDamental?.....................................................................................2-96
:READ:OBWidth?..............................................................................................................2-96
:READ:OBWidth:OBWidth?................................................................................................2-97
:READ:OBWidth:OBWidth:FERRor?....................................................................................2-97
:READ:TOIntercept? .........................................................................................................2-97
:READ:TOIntercept:IP3?...................................................................................................2-98
:READ:TPOWer?...............................................................................................................2-98
[:SENSe] Subsystem ...............................................................................................................2-99
[:SENSe]:ACPower:AVERage:COUNt................................................................................2-102
[:SENSe]:ACPower:AVERage[:STATe]...............................................................................2-102
[:SENSe]:ACPower:AVERage:TCONtrol.............................................................................2-103
[:SENSe]:ACPower:BANDwidth:ACHannel ........................................................................2-103
[:SENSe]:ACPower:BANDwidth:INTegration......................................................................2-104
[:SENSe]:ACPower:CSPacing...........................................................................................2-105
[:SENSe]:BANDwidth:EMIFilter:STATe..............................................................................2-105
[:SENSe]:BANDwidth[:RESolution]...................................................................................2-106
[:SENSe]:BANDwidth[:RESolution]:AUTO.........................................................................2-106
[:SENSe]:BANDwidth:VIDeo............................................................................................2-107
[:SENSe]:BANDwidth:VIDeo:AUTO ..................................................................................2-107

Contents RIGOL
DSA800E Programming Guide XIII
[:SENSe]:BANDwidth:VIDeo:RATio.................................................................................. 2-108
[:SENSe]:CHPower:AVERage:COUNt ............................................................................... 2-108
[:SENSe]:CHPower:AVERage[:STATe].............................................................................. 2-109
[:SENSe]:CHPower:AVERage:TCONtrol............................................................................ 2-109
[:SENSe]:CHPower:BANDwidth:INTegration..................................................................... 2-110
[:SENSe]:CHPower:FREQuency:SPAN.............................................................................. 2-110
[:SENSe]:CNRatio:AVERage:COUNt................................................................................. 2-111
[:SENSe]:CNRatio:AVERage[:STATe]................................................................................ 2-112
[:SENSe]:CNRatio:AVERage:TCONtrol.............................................................................. 2-112
[:SENSe]:CNRatio:BANDwidth:INTegration ...................................................................... 2-113
[:SENSe]:CNRatio:BANDwidth:NOISe .............................................................................. 2-114
[:SENSe]:CNRatio:OFFSet............................................................................................... 2-114
[:SENSe]:CORRection:CSET:ALL:DELete .......................................................................... 2-115
[:SENSe]:CORRection:CSET:ALL[:STATe] ......................................................................... 2-115
[:SENSe]:CORRection:CSET<n>:DATA ............................................................................ 2-116
[:SENSe]:CORRection:CSET<n>:DATA:MERGe................................................................. 2-116
[:SENSe]:CORRection:CSET<n>:DELete.......................................................................... 2-117
[:SENSe]:CORRection:CSET<n>[:STATe]......................................................................... 2-117
[:SENSe]:CORRection:CSET<n>:X:SPACing..................................................................... 2-118
[:SENSe]:CORRection:CSET:TABLe:STATe........................................................................ 2-118
[:SENSe]:DEMod............................................................................................................ 2-119
[:SENSe]:DEMod:GAIN:AUTO ......................................................................................... 2-119
[:SENSe]:DEMod:GAIN:INCRement................................................................................. 2-120
[:SENSe]:DEMod:STATe.................................................................................................. 2-121
[:SENSe]:DEMod:TIME................................................................................................... 2-121
[:SENSe]:DETector[:FUNCtion] ....................................................................................... 2-122
[:SENSe]:EBWidth:AVERage:COUNt ................................................................................ 2-122
[:SENSe]:EBWidth:AVERage[:STATe]............................................................................... 2-123
[:SENSe]:EBWidth:AVERage:TCONtrol............................................................................. 2-123
[:SENSe]:EBWidth:FREQuency:SPAN............................................................................... 2-124
[:SENSe]:EBWidth:MAXHold:STATe ................................................................................. 2-125
[:SENSe]:EBWidth:XDB .................................................................................................. 2-125
[:SENSe]:EXTRef[:STATe]? ............................................................................................. 2-126
[:SENSe]:FREQuency:CENTer.......................................................................................... 2-126
[:SENSe]:FREQuency:CENTer:DOWN .............................................................................. 2-127
[:SENSe]:FREQuency:CENTer:SET:STEP .......................................................................... 2-127
[:SENSe]:FREQuency:CENTer:STEP:AUTO ....................................................................... 2-127
[:SENSe]:FREQuency:CENTer:STEP[:INCRement] ............................................................ 2-128
[:SENSe]:FREQuency:CENTer:UP .................................................................................... 2-128
[:SENSe]:FREQuency:OFFSet.......................................................................................... 2-128
[:SENSe]:FREQuency:SPAN ............................................................................................ 2-129
[:SENSe]:FREQuency:SPAN:FULL.................................................................................... 2-129
[:SENSe]:FREQuency:SPAN:PREVious ............................................................................. 2-130
[:SENSe]:FREQuency:SPAN:ZIN...................................................................................... 2-130
[:SENSe]:FREQuency:SPAN:ZOUT................................................................................... 2-130
[:SENSe]:FREQuency:STARt ........................................................................................... 2-130
[:SENSe]:FREQuency:STOP ............................................................................................ 2-131
[:SENSe]:HDISt:AVERage:COUNt.................................................................................... 2-131
[:SENSe]:HDISt:AVERage[:STATe] .................................................................................. 2-132
[:SENSe]:HDISt:AVERage:TCONtrol................................................................................. 2-132
[:SENSe]:HDISt:NUMBers............................................................................................... 2-133
[:SENSe]:HDISt:TIME..................................................................................................... 2-134
[:SENSe]:HDISt:TIME:AUTO[:STATe] .............................................................................. 2-134
[:SENSe]:OBWidth:AVERage:COUNt................................................................................ 2-135
[:SENSe]:OBWidth:AVERage[:STATe] .............................................................................. 2-135
[:SENSe]:OBWidth:AVERage:TCONtrol ............................................................................ 2-136
[:SENSe]:OBWidth:FREQuency:SPAN .............................................................................. 2-136
[:SENSe]:OBWidth:MAXHold:STATe................................................................................. 2-137

RIGOL Contents
XIV DSA800E Programming Guide
[:SENSe]:OBWidth:PERCent............................................................................................2-138
[:SENSe]:POWer:ARANge ...............................................................................................2-138
[:SENSe]:POWer:ASCale.................................................................................................2-138
[:SENSe]:POWer:ATUNe .................................................................................................2-139
[:SENSe]:POWer[:RF]:ATTenuation..................................................................................2-139
[:SENSe]:POWer[:RF]:ATTenuation:AUTO ........................................................................2-140
[:SENSe]:POWer[:RF]:GAIN[:STATe]................................................................................2-140
[:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer] ...................................................................2-141
[:SENSe]:SWEep:COUNt .................................................................................................2-141
[:SENSe]:SWEep:COUNt:CURRent? .................................................................................2-142
[:SENSe]:SWEep:POINts.................................................................................................2-142
[:SENSe]:SWEep:TIME ...................................................................................................2-143
[:SENSe]:SWEep:TIME:AUTO..........................................................................................2-143
[:SENSe]:SWEep:TIME:AUTO:RULes ...............................................................................2-144
[:SENSe]:TOI:AVERage:COUNt........................................................................................2-144
[:SENSe]:TOI:AVERage[:STATe] ......................................................................................2-145
[:SENSe]:TOI:AVERage:TCONtrol ....................................................................................2-145
[:SENSe]:TOI:FREQuency:SPAN......................................................................................2-146
[:SENSe]:TPOWer:AVERage:COUNt.................................................................................2-147
[:SENSe]:TPOWer:AVERage[:STATe]................................................................................2-147
[:SENSe]:TPOWer:AVERage:TCONtrol..............................................................................2-148
[:SENSe]:TPOWer:LLIMit ................................................................................................2-148
[:SENSe]:TPOWer:MODE ................................................................................................2-149
[:SENSe]:TPOWer:RLIMit................................................................................................2-150
[:SENSe]:VSWR:FREFlect................................................................................................2-150
[:SENSe]:VSWR:NREFlect ...............................................................................................2-150
[:SENSe]:VSWR:RESet....................................................................................................2-151
[:SENSe]:VSWR:STATe....................................................................................................2-151
:SOURce Subsystem..............................................................................................................2-152
:SOURce:CORRection:OFFSet..........................................................................................2-152
:SOURce:POWer:LEVel:IMMediate:AMPLitude...................................................................2-153
:SOURce:TRACe:REF:STATe ............................................................................................2-153
:SOURce:TRACe:STORref................................................................................................2-154
:STATus Subsystem...............................................................................................................2-155
:STATus:OPERation:CONDition?.......................................................................................2-156
:STATus:OPERation:ENABle.............................................................................................2-156
:STATus:OPERation[:EVENt]? ..........................................................................................2-157
:STATus:PRESet..............................................................................................................2-157
:STATus:QUEStionable:CONDition? ..................................................................................2-157
:STATus:QUEStionable:ENABle.........................................................................................2-158
:STATus:QUEStionable[:EVENt]?......................................................................................2-158
:SYSTem Subsystem..............................................................................................................2-159
:SYSTem:BEEPer:STATe ..................................................................................................2-160
:SYSTem:CLEar ..............................................................................................................2-160
:SYSTem:COMMunicate:APORt........................................................................................2-161
:SYSTem:COMMunicate:GPIB[:SELF]:ADDRess.................................................................2-161
:SYSTem:COMMunicate:LAN[:SELF]:AUToip:STATe............................................................2-162
:SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe .............................................................2-162
:SYSTem:COMMunicate:LAN[:SELF]:IP:ADDress...............................................................2-163
:SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer............................................................2-163
:SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway ..............................................................2-164
:SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask..............................................................2-164
:SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe...........................................................2-165
:SYSTem:COMMunicate:LAN[:SELF]:RESet.......................................................................2-165
:SYSTem:COMMunicate:USB[:SELF]:ADDRess?.................................................................2-165
:SYSTem:COMMunicate:USB[:SELF]:CLASs.......................................................................2-166
:SYSTem:CONFigure:INFormation? ..................................................................................2-166
:SYSTem:CONFigure:MESSage?.......................................................................................2-167

Contents RIGOL
DSA800E Programming Guide XV
:SYSTem:DATE............................................................................................................... 2-167
:SYSTem:ERRor[:NEXT]? ................................................................................................ 2-168
:SYSTem:FSWItch[:STATe].............................................................................................. 2-168
:SYSTem:KLOCk............................................................................................................. 2-169
:SYSTem:LANGuage ....................................................................................................... 2-170
:SYSTem:LINemod:STATe?.............................................................................................. 2-170
:SYSTem:LINemod:TYPe................................................................................................. 2-171
:SYSTem:LKEY............................................................................................................... 2-171
:SYSTem:OPTions?......................................................................................................... 2-172
:SYSTem:PON:TYPE ....................................................................................................... 2-172
:SYSTem:PRESet............................................................................................................ 2-173
:SYSTem:PRESet:SAVE................................................................................................... 2-173
:SYSTem:PRESet:TYPE ................................................................................................... 2-173
:SYSTem:SPEaker[:STATe].............................................................................................. 2-174
:SYSTem:SPEaker:VOLume............................................................................................. 2-174
:SYSTem:TIME............................................................................................................... 2-175
:SYSTem:TX:STATe? ....................................................................................................... 2-175
:SYSTem:TX:SWset........................................................................................................ 2-176
:SYSTem:TX:SWSTa?...................................................................................................... 2-176
:SYSTem:USERkey:CONFirm ........................................................................................... 2-177
:SYSTem:USERkey:KEYCmd............................................................................................ 2-177
:SYSTem:USERkey:STATe ............................................................................................... 2-178
:SYSTem:VERSion?......................................................................................................... 2-178
:TRACe Subsystem ............................................................................................................... 2-179
:TRACe:AVERage:CLEar.................................................................................................. 2-179
:TRACe:AVERage:COUNt ................................................................................................ 2-179
:TRACe:AVERage:COUNt:CURRent?................................................................................. 2-180
:TRACe:AVERage:RESet ................................................................................................. 2-180
:TRACe:CLEar:ALL ......................................................................................................... 2-180
:TRACe[:DATA].............................................................................................................. 2-181
:TRACe:MATH:A............................................................................................................. 2-182
:TRACe:MATH:B............................................................................................................. 2-183
:TRACe:MATH:CONSt ..................................................................................................... 2-183
:TRACe:MATH:PEAK[:DATA]?.......................................................................................... 2-184
:TRACe:MATH:PEAK:POINts?.......................................................................................... 2-184
:TRACe:MATH:PEAK:SORT.............................................................................................. 2-184
:TRACe:MATH:PEAK:TABLe:STATe................................................................................... 2-185
:TRACe:MATH:PEAK:THReshold...................................................................................... 2-185
:TRACe:MATH:STATe...................................................................................................... 2-186
:TRACe:MATH:TYPE ....................................................................................................... 2-186
:TRACe<n>:AVERage:TYPE............................................................................................ 2-187
:TRACe<n>:MODE......................................................................................................... 2-188
:TRIGger Subsystem............................................................................................................. 2-189
:TRIGger:SEQuence:EXTernal:READy?............................................................................. 2-189
:TRIGger:SEQuence:EXTernal:SLOPe............................................................................... 2-189
:TRIGger:SEQuence:SOURce.......................................................................................... 2-190
:TRIGger:SEQuence:VIDeo:LEVel.................................................................................... 2-191
:UNIT Subsystem.................................................................................................................. 2-192
:UNIT:POWer................................................................................................................. 2-192
Chapter 3 Programming Demos..........................................................................................3-1
Programming Instructions .........................................................................................................3-2
Programming Preparations ........................................................................................................3-2
Visual C++ 6.0 Programming Demo...........................................................................................3-4
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

RIGOL Contents
XVI DSA800E Programming Guide
Linux Programming Procedures .........................................................................................3-24

Chapter 1 SCPI Overview RIGOL
DSA800E Programming Guide 1-1
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

RIGOL Chapter 1 SCPI Overview
1-2 DSA800E Programming Guide
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 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>
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 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.