Instructions

ManualsBrandsRigol ManualsFunction GeneratorsRigol DSG836 Mains-powered 9 kHz - 3.6 GHz

RIGOL

Programming Guide

DSG800 Series RF Signal Generator

Sept. 2018

RIGOL (SUZHOU) TECHNOLOGIES, INC.

Summary of content (158 pages)

PAGE 1
RIGOL Programming Guide DSG800 Series RF Signal Generator Sept. 2018 RIGOL (SUZHOU) TECHNOLOGIES, INC.
PAGE 2
PAGE 3
RIGOL Guaranty and Declaration Copyright © 2015 RIGOL (SUZHOU) TECHNOLOGIES, INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES, INC. Publication Number PGG02104-1110 Software Version 00.01.07 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.
PAGE 4
RIGOL Safety Requirement General Safety Summary Please review the following safety precautions carefully before putting the instrument into operation so as to avoid any personal injury or damage to the 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.
PAGE 5
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.
PAGE 6
RIGOL 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 WARNING CAUTION It calls attention to an operation, if not correctly performed, could result in injury or hazard immediately.
PAGE 7
RIGOL Allgemeine Sicherheits Informationen Überprüfen Sie diefolgenden Sicherheitshinweise sorgfältigumPersonenschädenoderSchäden am Gerätundan damit verbundenen weiteren Gerätenzu vermeiden. Zur Vermeidung vonGefahren, nutzen Sie bitte das Gerät nur so, 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.
PAGE 8
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 Innen- und Außenleiter der Verbindungsleitung, um statische Aufladung zu entladen.
PAGE 9
RIGOL 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 WARNING CAUTION weist auf eine Verletzung oder Gefährdung hin, die sofort geschehen kann.
PAGE 10
RIGOL Document Overview This manual introduces how to program the RF signal generator over the remote interfaces in details. Main Topics in this Manual: Chapter 1 Programming Overview This chapter outlines how to build the remote communication between the RF signal generator and PC and how to control the RF signal generator remotely. Besides, it also provides a brief introduction of the SCPI commands.
PAGE 11
Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Safety Requirement .................................................................................................................. II General Safety Summary ............................................................................................................. II Safety Notices and Symbols .....................................................
PAGE 12
RIGOL Contents :STATus Commands ................................................................................................................. 2-78 :STATus:OPERation:CONDition........................................................................................... 2-81 :STATus:OPERation:ENABle ............................................................................................... 2-81 :STATus:OPERation[:EVENt] ...................................................................................
PAGE 13
Contents RIGOL Chapter 3 Application Examples .........................................................................................3-1 To Output RF signal .................................................................................................................. 3-2 To Output RF Sweep Signal ....................................................................................................... 3-2 To Output RF Modulated Signal.....................................................................
PAGE 14
PAGE 15
Chapter 1 Programming Overview RIGOL Chapter 1 Programming Overview This chapter introduces how to build the remote communication between the instrument and PC and provides an overview of the syntax, abbreviation rules and status system of the SCPI commands.
PAGE 16
RIGOL Chapter 1 Programming Overview To Build Remote Communication You can build the remote communication between DSG800 and the PC via USB or LAN interface. Operating Steps: 1. Install the Ultra Sigma common PC software Acquire the Ultra Sigma common PC software from www.rigol.com; then, install it according to the instructions. 2. Connect the instrument and PC and configure the interface parameters of the instrument DSG800 supports USB and LAN communication interfaces, as shown in the figure below.
PAGE 17
Chapter 1 Programming Overview RIGOL Remote Control Methods 1. User-defined programming You can program and control DSG800 using the SCPI (Standard Commands for Programmable Instruments) commands listed in chapter 2 Command System in various development environments (such as Visual C++, Visual Basic and LabVIEW). For the details, refer to the introductions in chapter 4 Programming Demos. 2.
PAGE 18
RIGOL Chapter 1 Programming Overview SCPI Command Overview SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming language that is based on the standard IEEE488.1 and IEEE488.2 and conforms to various standards (such as the floating point operation rule in IEEE754 standard, ISO646 7-bit coded character for information interchange (equivalent to ASCll programming)). This chapter describes the syntax, symbols, parameters and abbreviation rules of the SCPI commands.
PAGE 19
Chapter 1 Programming Overview RIGOL Parameter Type The parameters of the commands introduced in this manual contains 5 types: bool, integer, real number, discrete and ASCII string. 1. Bool The parameter could be OFF, ON, 0 or 1. For example, [:SOURce]:AM:STATe ON|OFF|1|0. 2. Integer Unless otherwise noted, the parameter can be any integer within the effective value range. Note that do not set the parameter to a decimal; otherwise, errors will occur.
PAGE 20
PAGE 21
Chapter 2 Command System RIGOL Chapter 2 Command System This chapter introduces the syntax, function, parameter and using instruction of each DSG800 command in alphabetical (A to Z) order. Main topics of this chapter:  IEEE488.
PAGE 22
RIGOL Chapter 2 Command System IEEE488.2 Common Commands The IEEE488.2 common commands are used to query the basic information about the instrument or execute common operations. These commands usually begin with "*", contain a 3-character command keyword and relate to the status register. Command List[1] :  *IDN?  *TRG *IDN? Syntax Description Return Format *IDN? Query the ID string of the instrument. The query returns the ID string of the instrument.
PAGE 23
RIGOL Chapter 2 Command System :MMEMory Commands The :MMEMory commands are used to store files to the internal or external memory of the instrument, read or delete the specified file as well as query the disk information.
PAGE 24
RIGOL Chapter 2 Command System :MMEMory:CATalog:LENGth Syntax Description :MMEMory:CATalog:LENGth? Query the number of files and folders under the specified path. Parameter Explanation Return Format Example Name Type Range Default ASCII string Valid path -- can be the local memory (D disk), external memory (E disk; when a USB storage device is detected by the USB HOST interface at the rear panel) or the subdirectory under the D or E disk. The query returns an integer.
PAGE 25
RIGOL Chapter 2 Command System :MMEMory:DATA:IQ Syntax Description :MMEMory:DATA:IQ ,,{,,…,} Save and download IQ waveform data to the instrument. Parameter Explanation Example Name Type ASCII string Discrete {,,… ,} Integer Decimal number Explanation The name of the wavetable file downloaded into the instrument. When the IQ data file exceeds 64kB, you should download the file packets separately.
PAGE 26
RIGOL Chapter 2 Command System :MMEMory:DELete Syntax Description :MMEMory:DELete Delete the specified file or folder under the specified operation path. Parameter Explanation Example Name Type Range Default ASCII string The name of the file or folder to be deleted --  This command is valid only when the specified file or folder exists under the current operation path or the specified path.
PAGE 27
RIGOL Chapter 2 Command System :MMEMory:FILEtype Syntax :MMEMory:FILEtype ALL|STATe|ARB|FLACsv|SWPCsv|TRNCsv|SEGMent|SEQList|SEQCsv :MMEMory:FILEtype? Description Set the file type. Query the current file type.
PAGE 28
RIGOL Chapter 2 Command System :MMEMory:MDIRectory Syntax Description :MMEMory:MDIRectory Create a new folder under the specified operation path. Parameter Explanation Example Name Type Range Default ASCII string The name of the folder to be created --  The folder name can include Chinese characters (a Chinese character occupies two bytes), English characters or numbers. The folder name cannot exceed 28 bytes.
PAGE 29
RIGOL Chapter 2 Command System :MMEMory:PNAMe:EDIT Syntax :MMEMory:PNAMe:EDIT :MMEMory:PNAMe:EDIT? Description Edit and save the filename prefix. Query the filename prefix saved. Parameter Explanation Return Format Example Related Command Name Type Range Default ASCII string The filename prefix to be edited -- You can edit any filename prefix. The query returns the filename prefix. For example, N.
PAGE 30
RIGOL Chapter 2 Command System :MMEMory:SAVe Syntax Description :MMEMory:SAVe Save the file with the specified filename under the current operation path. Parameter Explanation Example 2-10 Name Type Range Default ASCII string The name of the file to be saved --  The filename can include Chinese characters (a Chinese character occupies two bytes), English characters or numbers. The filename cannot exceed 28 bytes.
PAGE 31
RIGOL Chapter 2 Command System :OUTPut Command Command List:  :OUTPut :OUTPut[:STATe] Syntax :OUTPut[:STATe] ON|OFF|1|0 :OUTPut[:STATe]? Description Turn on or off the RF output. Query the on/off state of the RF output. Parameter Explanation Return Format Example Name Type Range Default ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0  ON|1: turn on the RF output. At this point, the backlight of RF/on goes on.  OFF|0: turn off the RF output. At this point, the backlight of RF/on goes off.
PAGE 32
RIGOL Chapter 2 Command System :SOURce Commands The :SOURce commands are used to set the related parameters of the main functions of the RF signal generator including the frequency, level, flatness calibration, AM, FM/ØM, Pulse, SWEEP, LF output and so on.
PAGE 33
RIGOL Chapter 2 Command System [:SOURce]:AM[:DEPTh] Syntax [:SOURce]:AM[:DEPTh] [:SOURce]:AM[:DEPTh]? Description Set the AM modulation depth. Query the AM modulation depth. Parameter Explanation  Name Type Range Default Real 0 to 100 50 When "Int" modulation source is selected, the AM modulation depth ( ma ) and amplitude difference ( ΔPsb ) between the carrier and sidebands satisfy the following relation: Return Format Example ΔPsb = 6 − 20 lg ma .
PAGE 34
RIGOL Chapter 2 Command System [:SOURce]:AM:EXT:COUP Syntax [:SOURce]:AM:EXT:COUP AC|DC [:SOURce]:AM:EXT:COUP? Description Set the coupling mode of AM external modulation. Query the coupling mode of AM external modulation. Parameter Explanation Return Format Example Name Type Range Default AC|DC Discrete AC|DC AC  AC: set the coupling mode of AM external modulation to "AC".  DC: set the coupling mode of AM external modulation to "DC".
PAGE 35
RIGOL Chapter 2 Command System [:SOURce]:AM:FREQuency Syntax [:SOURce]:AM:FREQuency [:SOURce]:AM:FREQuency? Description Set the AM modulation frequency. Query the AM modulation frequency. Parameter Explanation Return Format Example Name Type Range Default Real 10Hz to 100kHz (Sine)/10Hz to 20kHz (Square) 10kHz  When is set in "Number" form, the default unit is Hz; for example, 20000. In addition, can also be set in "Number + Unit" form; for example, 20kHz.
PAGE 36
RIGOL Chapter 2 Command System [:SOURce]:AM:SOURce Syntax [:SOURce]:AM:SOURce EXTernal|INTernal [:SOURce]:AM:SOURce? Description Set the AM modulation source. Query the AM modulation source. Parameter Explanation Return Format Example Name Type Range Default EXTernal|INTernal Discrete EXTernal|INTernal INTernal  EXTernal: set the modulation source to "Ext". At this point, the external modulating signal is input from the [EXT MOD IN] connector.
PAGE 37
RIGOL Chapter 2 Command System [:SOURce]:AM:WAVEform Syntax [:SOURce]:AM:WAVEform SINE|SQUA [:SOURce]:AM:WAVEform? Description Set the AM modulation waveform. Query the AM modulation waveform. Parameter Explanation Return Format Example Name Type Range Default SINE|SQUA Discrete SINE|SQUA SINE  SINE: set the AM modulation waveform to "Sine".  SQUA: set the AM modulation waveform to "Square".  When the modulation source of AM is set to "Ext", this command is invalid.
PAGE 38
RIGOL Chapter 2 Command System [:SOURce]:CORRection Command Subsystem Command List:  [:SOURce]:CORRection:FLATness:COUNt  [:SOURce]:CORRection:FLATness:LIST  [:SOURce]:CORRection:FLATness[:STATe] [:SOURce]:CORRection:FLATness:COUNt Syntax Description Return Format [:SOURce]:CORRection:FLATness:COUNt? Query the number of points in the current flatness calibration list. The query returns the number of points in the flatness calibration list in integer. For example, 5.
PAGE 39
RIGOL Chapter 2 Command System [:SOURce]:CORRection:FLATness[:STATe] Syntax [:SOURce]:CORRection:FLATness[:STATe] ON|OFF|1|0 [:SOURce]:CORRection:FLATness[:STATe]? Description Turn on or off the flatness calibration switch. Query the state of the flatness calibration switch. Parameter Explanation Return Format Example Name Type Range Default ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0  ON|1: turn on the flatness calibration switch.  OFF|0: turn off the flatness calibration switch.
PAGE 40
RIGOL Chapter 2 Command System [:SOURce]:FM Command Subsystem Command List:  [:SOURce]:FM[:DEViation]  [:SOURce]:FM[:DEViation]:STEP[:INCRement]  [:SOURce]:FM:EXT:COUP  [:SOURce]:FM:EXT:IMP  [:SOURce]:FM:FREQuency  [:SOURce]:FM:FREQuency:STEP[:INCRement]  [:SOURce]:FM:SOURce  [:SOURce]:FM:STATe  [:SOURce]:FM:WAVEform [:SOURce]:FM[:DEViation] Syntax [:SOURce]:FM[:DEViation] [:SOURce]:FM[:DEViation]? Description Set the FM frequency deviation.
PAGE 41
RIGOL Chapter 2 Command System [:SOURce]:FM[:DEViation]:STEP[:INCRement] Syntax [:SOURce]:FM[:DEViation]:STEP[:INCRement] [:SOURce]:FM[:DEViation]:STEP[:INCRement]? Description Set the FM frequency deviation step. Query the FM frequency deviation step. Parameter Explanation Return Format Example Name Type Range Default Real 10mHz to 500kHz 1kHz  When is set in "Number" form, the default unit is Hz; for example, 5000.
PAGE 42
RIGOL Chapter 2 Command System [:SOURce]:FM:EXT:IMP Syntax [:SOURce]:FM:EXT:IMP 50|600|100k [:SOURce]:FM:EXT:IMP? Description Set the impedance of FM external modulation. Query the impedance of FM external modulation. Parameter Explanation Return Format Example Name Type Range Default 50|600|100k Discrete 50|600|100k 100k  50: set the impedance of FM external modulation to "50ohm".  600: set the impedance of FM external modulation to "600ohm".
PAGE 43
RIGOL Chapter 2 Command System [:SOURce]:FM:FREQuency:STEP[:INCRement] Syntax [:SOURce]:FM:FREQuency:STEP[:INCRement] [:SOURce]:FM:FREQuency:STEP[:INCRement]? Description Set the FM modulation frequency step. Query the FM modulation frequency step. Parameter Explanation Return Format Example Name Type Range Default Real 1Hz to 50kHz 1kHz  When is set in "Number" form, the default unit is Hz; for example, 5000.
PAGE 44
RIGOL Chapter 2 Command System [:SOURce]:FM:STATe Syntax [:SOURce]:FM:STATe ON|OFF|1|0 [:SOURce]:FM:STATe? Description Set the state of the FM switch. Query the state of the FM switch. Parameter Explanation Return Format Example Name Type Range Default ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0  ON|1: turn on the FM switch to enable the FM function.  OFF|0: turn off the FM switch to disable the FM function. The query returns 1 or 0.
PAGE 45
RIGOL Chapter 2 Command System [:SOURce]:FMPM:TYPE Syntax [:SOURce]:FMPM:TYPE FM|PM [:SOURce]:FMPM:TYPE? Description Set the current modulation type to FM or ØM. Query the current modulation type. Parameter Explanation Return Format Example Name Type Range Default FM|PM Discrete FM|PM PM  FM: set the current modulation type to "FM".  PM: set the current modulation type to "ØM". The query returns FM or PM.
PAGE 46
RIGOL Chapter 2 Command System [:SOURce]:FREQuency Command Subsystem Command List:  [:SOURce]:FREQuency  [:SOURce]:FREQuency:STEP [:SOURce]:FREQuency Syntax [:SOURce]:FREQuency [:SOURce]:FREQuency? Description Set the frequency of the RF signal. Query the frequency of the RF signal. Parameter Explanation Return Format Example Name Type Range Default Real 9kHz to 3GHz 3GHz  When is set in "Number" form, the default unit is Hz; for example, 4000000.
PAGE 47
RIGOL Chapter 2 Command System [:SOURce]:FREQuency:STEP Syntax [:SOURce]:FREQuency:STEP [:SOURce]:FREQuency:STEP? Description Set the RF frequency step. Query the RF frequency step. Parameter Explanation Return Format Example Name Type Range Default Real 10mHz to 1GHz 100MHz  When is set in "Number" form, the default unit is Hz; for example, 3000. In addition, can also be set in "Number + Unit" form; for example, 3kHz.
PAGE 48
RIGOL Chapter 2 Command System [:SOURce]:IQ Command Subsystem Command List[2]:  [:SOURce]:IQ:BASeout:LEVel  [:SOURce]:IQ:BASeout:LEVel:STEP  [:SOURce]:IQ:BASeout:STATe  [:SOURce]:IQ:MODe  [:SOURce]:IQ:MODe:STATe  [:SOURce]:IQ:SAMPle  [:SOURce]:IQ:SAMPle:STEP  [:SOURce]:IQ:TRIGger:ARB  [:SOURce]:IQ:TRIGger:DELay  [:SOURce]:IQ:TRIGger:DELay:STEP  [:SOURce]:IQ:TRIGger:DURation  [:SOURce]:IQ:TRIGger:DURation:STEP  [:SOURce]:IQ:TRIGger:DURation:UNIT  [:SOURce]:IQ:TRIGge
PAGE 49
RIGOL Chapter 2 Command System [:SOURce]:IQ:BASeout:LEVel Syntax [:SOURce]:IQ:BASeout:LEVel [:SOURce]:IQ:BASeout:LEVel? Description Set the baseband output amplitude. Query the baseband output amplitude. Parameter Explanation Return Format Example Name Type Range Default Real 20mV to 1.5V 1V  When is set in "Number" form, the default unit is V. Besides, can also be set in "Number + Unit" form; for example, 1.1V.
PAGE 50
RIGOL Chapter 2 Command System [:SOURce]:IQ:BASeout:STATe Syntax [:SOURce]:IQ:BASeout:STATe ON|OFF|1|0 [:SOURce]:IQ:BASeout:STATe? Description Set the state of the baseband output switch. Query the state of the baseband output switch. Parameter Explanation Return Format Example Name Type Range Default ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0  ON|1: turn on the baseband output switch.  OFF|0: turn off the baseband output switch. The query returns 1 or 0.
PAGE 51
RIGOL Chapter 2 Command System [:SOURce]:IQ:MODe:STATe Syntax [:SOURce]:IQ:MODe:STATe ON|OFF|1|0 [:SOURce]:IQ:MODe:STATe? Description Set the state of the IQ modulation switch. Query the state of the IQ modulation switch. Parameter Explanation Return Format Example Name Type Range Default ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0  ON|1: enable the IQ modulation function.  OFF|0: disable the IQ modulation function. The query returns 1 or 0.
PAGE 52
RIGOL Chapter 2 Command System [:SOURce]:IQ:SAMPle:STEP Syntax [:SOURce]:IQ:SAMPle:STEP [:SOURce]:IQ:SAMPle:STEP? Description Set the sample rate step of the IQ wavetable output. Query the sample rate step of the IQ wavetable output. Parameter Explanation Return Format Example Name Type Range Default Real 1Hz to 10MHz 1MHz  When is set in "Number" form, the default unit is Hz; for example, 3000.
PAGE 53
RIGOL Chapter 2 Command System [:SOURce]:IQ:TRIGger:DELay Syntax [:SOURce]:IQ:TRIGger:DELay [:SOURce]:IQ:TRIGger:DELay? Description Set the external trigger delay of the IQ modulation baseband signal. Query the external trigger delay of the IQ modulation baseband signal. Parameter Explanation Name Type Range Default Integer 0 to 65535 0  The external delay refers to the delay of the response to a trigger when the external trigger signal is received.
PAGE 54
RIGOL Chapter 2 Command System [:SOURce]:IQ:TRIGger:DURation Syntax [:SOURce]:IQ:TRIGger:DURation [:SOURce]:IQ:TRIGger:DURation? Description Set the duration of the signal in single trigger. Query the duration of the signal in single trigger. Parameter Explanation  Name Type Range Default Integer 1 to 65535 1 This command is valid only when "Single" operation mode is selected. Wherein, describes the number of points ( N r ).
PAGE 55
RIGOL Chapter 2 Command System [:SOURce]:IQ:TRIGger:DURation:UNIT Syntax [:SOURce]:IQ:TRIGger:DURation:UNIT SEQUENCE|SAMPLES [:SOURce]:IQ:TRIGger:DURation:UNIT? Description Set the duration unit of the IQ wavetable in "Single" trigger. Query the duration unit of the IQ wavetable in "Single" trigger. Parameter Explanation Return Format Example Name Type Range Default SEQUENCE|SAMPLES Discrete SEQUENCE|SAMPLES SAMPLES  SEQUENCE: trigger by the waveform segment.
PAGE 56
RIGOL Chapter 2 Command System [:SOURce]:IQ:TRIGger:INHibit:STEP Syntax [:SOURce]:IQ:TRIGger:INHibit:STEP [:SOURce]:IQ:TRIGger:INHibit:STEP? Description Set the trigger inhibit step. Query the trigger inhibit step. Parameter Explanation Return Format Example Name Type Range Default Integer 1 to 10000 1 After the trigger inhibit step is set, you can rotate the knob to modify the trigger inhibit at the current step.
PAGE 57
RIGOL Chapter 2 Command System [:SOURce]:IQ:TRIGger:MODe Syntax [:SOURce]:IQ:TRIGger:MODe AUTO|KEY|BUS|EXT [:SOURce]:IQ:TRIGger:MODe? Description Set the trigger mode of the IQ modulation baseband output. Query the trigger mode of the IQ modulation baseband output. Parameter Explanation Return Format Example Name Type Range Default AUTO|KEY|BUS|EXT Discrete AUTO|KEY|BUS|EXT AUTO  AUTO: select "Auto" trigger mode.
PAGE 58
RIGOL Chapter 2 Command System [:SOURce]:IQ:TRIGger:OPTMode Syntax [:SOURce]:IQ:TRIGger:OPTMode RETRig|AMDAuto|AMDRetrig|SINGle [:SOURce]:IQ:TRIGger:OPTMode? Description Set the operation mode after the IQ modulation baseband signal is triggered. Query the operation mode after the IQ modulation baseband signal is triggered.
PAGE 59
RIGOL Chapter 2 Command System [:SOURce]:IQ:TRIGger:SEGMent:MODE Syntax [:SOURce]:IQ:TRIGger:SEGMent:MODE SAME|NEXT|SEAMLESS|SEQUENCER [:SOURce]:IQ:TRIGger:SEGMent:MODE? Description Set the trigger mode of the IQ data segment. Query the trigger mode of the IQ data segment. Parameter Name SAME|NEXT|SEAMLESS |SEQUENCER Explanation Return Format Example Type Discrete Range SAME|NEXT|SEAMLESS |SEQUENCER Default SAME  SAME: select the "Same Seg" mode.
PAGE 60
RIGOL Chapter 2 Command System [:SOURce]:IQ:TRIGger:SEGMent:NEXT Syntax [:SOURce]:IQ:TRIGger:SEGMent:NEXT [:SOURce]:IQ:TRIGger:SEGMent:NEXT? Description Set the number of the next segment of the wavetable. Query the number of the next segment of the wavetable. Parameter Explanation Return Format Example Name Type Range Default Integer 0 to 63 0  The upper limit of is determined by the total number of wavetable segments of the "Segment" file currently loaded.
PAGE 61
RIGOL Chapter 2 Command System [:SOURce]:LEVel Command Subsystem Command List:  [:SOURce]:LEVel  [:SOURce]:LEVel:STEP [:SOURce]:LEVel Syntax [:SOURce]:LEVel [:SOURce]:LEVel? Description Set the RF output amplitude. Query the RF output amplitude. Parameter Explanation Return Format Example  Type Range Default Real -110dBm to 20dBm -110dBm When is set in "Number" form (for example, 2), the default unit is dBm.
PAGE 62
RIGOL Chapter 2 Command System [:SOURce]:LEVel:STEP Syntax [:SOURce]:LEVel:STEP [:SOURce]:LEVel:STEP? Description Set the RF output amplitude step. Query the RF output amplitude step. Parameter Explanation Return Format Example Name Type Range Default Real 0.01dB to 100dB 10dB  When is set in "Number" form, the default unit is dB. Besides, can also be set in "Number + Unit" form; for example, 20dB.  The default unit of the return value is dB.
PAGE 63
RIGOL Chapter 2 Command System [:SOURce]:LFOutput Command Subsystem Command List:  [:SOURce]:LFOutput:FREQuency  [:SOURce]:LFOutput:LEVel  [:SOURce]:LFOutput:SHAPe  [:SOURce]:LFOutput[:STATe] [:SOURce]:LFOutput:FREQuency Syntax [:SOURce]:LFOutput:FREQuency [:SOURce]:LFOutput:FREQuency? Description Set the frequency of the LF output signal. Query the frequency of the LF output signal.
PAGE 64
RIGOL Chapter 2 Command System [:SOURce]:LFOutput:SHAPe Syntax [:SOURce]:LFOutput:SHAPe SINE|SQUare [:SOURce]:LFOutput:SHAPe? Description Set the waveform of the LF output signal. Query the waveform of the LF output signal. Parameter Explanation Return Format Example Name Type Range Default SINE|SQUare Discrete SINE|SQUare SINE  SINE: set the waveform of the LF output signal to "Sine".  SQUare: set the waveform of the LF output signal to "Square". The query returns SINE|SQU.
PAGE 65
RIGOL Chapter 2 Command System [:SOURce]:MODulation:STATe Syntax [:SOURce]:MODulation:STATe ON|OFF|1|0 [:SOURce]:MODulation:STATe? Description Turn on or off the switch of all the modulation outputs. Query the on/off state of the switch of all the modulation outputs. Parameter Explanation Return Format Example Name Type Range Default ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0  ON|1: turn on all the modulation outputs. The backlight of Mod/on goes on.  OFF|0: turn off all the modulation outputs.
PAGE 66
RIGOL Chapter 2 Command System [:SOURce]:PM Command Subsystem Command List:  [:SOURce]:PM[:DEViation]  [:SOURce]:PM[:DEViation]:STEP[:INCRement]  [:SOURce]:PM:EXT:COUP  [:SOURce]:PM:EXT:IMP  [:SOURce]:PM:FREQuency  [:SOURce]:PM:FREQuency:STEP[:INCRement]  [:SOURce]:PM:SOURce  [:SOURce]:PM:STATe  [:SOURce]:PM:WAVEform [:SOURce]:PM[:DEViation] Syntax [:SOURce]:PM[:DEViation] [:SOURce]:PM[:DEViation]? Description Set the phase deviation of ØM.
PAGE 67
RIGOL Chapter 2 Command System [:SOURce]:PM[:DEViation]:STEP[:INCRement] Syntax [:SOURce]:PM[:DEViation]:STEP[:INCRement] [:SOURce]:PM[:DEViation]:STEP[:INCRement]? Description Set the phase deviation step of ØM. Query the phase deviation step of ØM. Parameter Explanation Return Format Example Name Type Range Default Real 0.01rad to 2.5rad 1rad  When is set in "Number" form, the default unit is rad.
PAGE 68
RIGOL Chapter 2 Command System [:SOURce]:PM:EXT:IMP Syntax [:SOURce]:PM:EXT:IMP 50|600|100k [:SOURce]:PM:EXT:IMP? Description Set the impedance of ØM external modulation. Query the impedance of ØM external modulation. Parameter Explanation Return Format Example Name Type Range Default 50|600|100k Discrete 50|600|100k 100k  50: set the impedance of ØM external modulation to "50ohm".  600: set the impedance of ØM external modulation to "600ohm".
PAGE 69
RIGOL Chapter 2 Command System [:SOURce]:PM:FREQuency:STEP[:INCRement] Syntax [:SOURce]:PM:FREQuency:STEP[:INCRement] [:SOURce]:PM:FREQuency:STEP[:INCRement]? Description Set the modulation frequency step of ØM. Query the modulation frequency step of ØM. Parameter Explanation Return Format Example Name Type Range Default Real 1Hz to 50kHz 1kHz  When is set in "Number" form, the default unit is Hz.
PAGE 70
RIGOL Chapter 2 Command System [:SOURce]:PM:STATe Syntax [:SOURce]:PM:STATe ON|OFF|1|0 [:SOURce]:PM:STATe? Description Turn on or off the ØM switch. Query the state of the ØM switch. Parameter Explanation Return Format Example Name Type Range Default ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0  ON|1: turn on the ØM switch and enable the ØM function.  OFF|0: turn off the ØM switch and disable the ØM function. The query returns 1 or 0.
PAGE 71
RIGOL Chapter 2 Command System [:SOURce]:PULM Command Subsystem Command List[3]:  [:SOURce]:PULM:MODE  [:SOURce]:PULM:OUT:STATe  [:SOURce]:PULM:PERiod  [:SOURce]:PULM:PERiod:STEP  [:SOURce]:PULM:POLarity  [:SOURce]:PULM:SOURce  [:SOURce]:PULM:STATe  [:SOURce]:PULM:TRAin:LIST:COUNt  [:SOURce]:PULM:TRAin:LIST:GET  [:SOURce]:PULM:TRIGger:DELay  [:SOURce]:PULM:TRIGger:DELay:STEP  [:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity  [:SOURce]:PULM:TRIGger:EXTernal:SLOPe  [:SO
PAGE 72
RIGOL Chapter 2 Command System [:SOURce]:PULM:OUT:STATe Syntax [:SOURce]:PULM:OUT:STATe ON|OFF|0|1 [:SOURce]:PULM:OUT:STATe? Description Turn on or off the pulse output switch. Query the state of the pulse output switch. Parameter Explanation Return Format Example Related Commands Name Type Range Default ON|OFF|0|1 Bool ON|OFF|0|1 OFF|0  ON|1: turn on the pulse output switch.
PAGE 73
RIGOL Chapter 2 Command System [:SOURce]:PULM:PERiod:STEP Syntax [:SOURce]:PULM:PERiod:STEP [:SOURce]:PULM:PERiod:STEP? Description Set the step of the pulse modulation period. Query the step of the pulse modulation period. Parameter Explanation Return Format Example Name Type Range Default Real 10ns to 10s 100us  When is set in "Number" form, the default unit is s. Besides, can also be set in "Number + Unit" form; for example, 5000ms.
PAGE 74
RIGOL Chapter 2 Command System [:SOURce]:PULM:SOURce Syntax [:SOURce]:PULM:SOURce INTernal|EXTernal [:SOURce]:PULM:SOURce? Description Set the pulse modulation source. Query the pulse modulation source. Parameter Explanation Return Format Example Name Type Range Default INTernal|EXTernal Discrete INTernal|EXTernal INTernal  INTernal: select "Int" modulation source. At this point, the internal pulse generator of the instrument provides the modulating signal.
PAGE 75
RIGOL Chapter 2 Command System [:SOURce]:PULM:TRAin:LIST:GET Syntax Description [:SOURce]:PULM:TRAin:LIST:GET? , Acquire the train list date within the specified range. Parameter Explanation Return Format Name Type Range Default Integer 1 to the total number of rows in the current train list -- Integer 1 to the total number of rows in the current train list --  : the number of the start row of the train list data to be acquired.
PAGE 76
RIGOL Chapter 2 Command System [:SOURce]:PULM:TRIGger:DELay:STEP Syntax [:SOURce]:PULM:TRIGger:DELay:STEP [:SOURce]:PULM:TRIGger:DELay:STEP? Description Set the step of pulse trigger delay. Query the step of pulse trigger delay. Parameter Explanation Return Format Example Name Type Range Default Real 10ns to 170s 100us  When is set in "Number" form, the default unit is s. Besides, can also be set in "Number + Unit" form; for example, 50ms.
PAGE 77
RIGOL Chapter 2 Command System [:SOURce]:PULM:TRIGger:EXTernal:SLOPe Syntax [:SOURce]:PULM:TRIGger:EXTernal:SLOPe POSitive|NEGative [:SOURce]:PULM:TRIGger:EXTernal:SLOPe? Description Set the polarity of the effective edge of the external trigger pulse. Query the polarity of the effective edge of the external trigger pulse.
PAGE 78
RIGOL Chapter 2 Command System [:SOURce]:PULM:TRIGger:MODE Syntax [:SOURce]:PULM:TRIGger:MODE AUTO|EXTernal|EGATe|KEY|BUS [:SOURce]:PULM:TRIGger:MODE? Description Set the trigger mode of pulse modulation. Query the trigger mode of pulse modulation. Parameter Name AUTO|EXTernal|EGATe |KEY|BUS Explanation Return Format Example Type Discrete Range AUTO|EXTernal|EGATe |KEY|BUS Default AUTO  AUTO: select "Auto" trigger mode.
PAGE 79
RIGOL Chapter 2 Command System [:SOURce]:PULM:WIDTh Syntax [:SOURce]:PULM:WIDTh [:SOURce]:PULM:WIDTh? Description Set the width of the pulse modulating signal. Query the width of the pulse modulating signal. Parameter Explanation Return Format Example Name Type Range Default Real 10ns to 170s - 10ns 500us  When is set in "Number" form, the default unit is s. Besides, can also be set in "Number + Unit" form; for example, 2000ms.
PAGE 80
RIGOL Chapter 2 Command System [:SOURce]:PULM:WIDTh:STEP Syntax [:SOURce]:PULM:WIDTh:STEP [:SOURce]:PULM:WIDTh:STEP? Description Set the step of the width of the pulse modulating signal. Query the step of the width of the pulse modulating signal. Parameter Explanation Return Format Example Name Type Range Default Real 10ns to 10s 100us  When is set in "Number" form, the default unit is s.
PAGE 81
Chapter 2 Command System RIGOL [:SOURce]:SWEep Command Subsystem Command List:  [:SOURce]:SWEep:DIRection  [:SOURce]:SWEep:EXECute  [:SOURce]:SWEep:LIST:CPOint  [:SOURce]:SWEep:LIST:INITialize:FSTep  [:SOURce]:SWEep:LIST:INITialize:PRESet  [:SOURce]:SWEep:LIST:LIST  [:SOURce]:SWEep:MODE  [:SOURce]:SWEep:POINt:TRIGger:TYPE  [:SOURce]:SWEep:RESet[:ALL]  [:SOURce]:SWEep:STATe  [:SOURce]:SWEep:STEP:DWELl  [:SOURce]:SWEep:STEP:DWELl:STEP  [:SOURce]:SWEep:STEP:POINts  [:
PAGE 82
RIGOL Chapter 2 Command System [:SOURce]:SWEep:DIRection Syntax [:SOURce]:SWEep:DIRection FWD|REV [:SOURce]:SWEep:DIRection? Description Set the sweep direction. Query the sweep direction. Parameter Explanation Return Format Example Name Type Range Default FWD|REV Discrete FWD|REV FWD  FWD: select "Fwd" sweep direction. At this point, the RF signal generator sweeps from the start frequency or start level to the stop frequency or stop level.  REV: select "Down" sweep direction.
PAGE 83
RIGOL Chapter 2 Command System [:SOURce]:SWEep:LIST:INITialize:FSTep Syntax [:SOURce]:SWEep:LIST:INITialize:FSTep Description Recalculate the data points set in the current step sweep to generate a new sweep list. Explanation  In the new sweep list, "SN" depends on the "Points" of step sweep.  "Freq" depends on the "Start Freq" and "Stop Freq" of step sweep.  "Level" depends on the "start Lev" and "Stop Lev" of step sweep.  "Time" depends on the "Dwell Time" of step sweep.
PAGE 84
RIGOL Chapter 2 Command System [:SOURce]:SWEep:MODE Syntax [:SOURce]:SWEep:MODE CONTinue|SINGle [:SOURce]:SWEep:MODE? Description Set the sweep mode. Query the sweep mode. Parameter Explanation Return Format Example Name Type Range Default CONTinue|SINGle Discrete CONTinue|SINGle CONTinue  CONTinue: select "Cont" sweep mode. The instrument sweeps continuously according to the current setting when the trigger condition is met.  SINGle: select "Single" sweep mode.
PAGE 85
RIGOL Chapter 2 Command System [:SOURce]:SWEep:POINt:TRIGger:TYPE Syntax [:SOURce]:SWEep:POINt:TRIGger:TYPE AUTO|KEY|BUS|EXT [:SOURce]:SWEep:POINt:TRIGger:TYPE? Description Set the point trigger mode of the sweep. Query the point trigger mode of the sweep. Parameter Explanation Name Type Range Default AUTO|KEY|BUS|EXT Discrete AUTO|KEY|BUS|EXT AUTO  AUTO: select "Auto" trigger mode.
PAGE 86
RIGOL Chapter 2 Command System [:SOURce]:SWEep:RESet[:ALL] Syntax [:SOURce]:SWEep:RESet[:ALL] Description Reset all the sweeps to the start point. Explanation  If the current sweep direction is "Fwd", the instrument will stop the current sweep and sweep from the start frequency or start level after sending this command.  If the current sweep direction is "Down", the instrument will stop the current sweep and sweep from the stop frequency or stop level after sending this command.
PAGE 87
RIGOL Chapter 2 Command System [:SOURce]:SWEep:STEP:DWELl Syntax [:SOURce]:SWEep:STEP:DWELl [:SOURce]:SWEep:STEP:DWELl? Description Set the dwell time of step sweep. Query the dwell time of step sweep. Parameter Explanation Return Format Example Name Type Range Default Real 20ms to 100s 100ms  When is set in "Number" form, the default unit is s. Besides, can also be set in "Number + Unit" form; for example, 3000ms.
PAGE 88
RIGOL Chapter 2 Command System [:SOURce]:SWEep:STEP:POINts Syntax [:SOURce]:SWEep:STEP:POINts [:SOURce]:SWEep:STEP:POINts? Description Set the number of points of step sweep. Query the number of points of step sweep. Parameter Explanation Return Format Example Name Type Range Default Integer 2 to 65535 91  The number of sweep points decides the time interval between two neighboring sweep points.
PAGE 89
RIGOL Chapter 2 Command System [:SOURce]:SWEep:STEP:SHAPe Syntax [:SOURce]:SWEep:STEP:SHAPe TRIangle|RAMP [:SOURce]:SWEep:STEP:SHAPe? Description Set the step sweep shape. Query the step sweep shape. Parameter Explanation Return Format Example Name Type Range Default TRIangle|RAMP Discrete TRIangle|RAMP RAMP  The sweep shape decides the cycle mode of multiple sweeps.  TRIangle: select "Triangle" waveform.
PAGE 90
RIGOL Chapter 2 Command System [:SOURce]:SWEep:STEP:STARt:FREQuency Syntax [:SOURce]:SWEep:STEP:STARt:FREQuency [:SOURce]:SWEep:STEP:STARt:FREQuency? Description Set the start frequency of the sweep. Query the start frequency of the sweep. Parameter Explanation Return Format Example Name Type Range Default Real 9kHz to 3GHz 100MHz  When is set in "Number" form, the default unit is Hz. Besides, can also be set in "Number + Unit" form; for example, 4MHz.
PAGE 91
RIGOL Chapter 2 Command System [:SOURce]:SWEep:STEP:STARt:LEVel Syntax [:SOURce]:SWEep:STEP:STARt:LEVel [:SOURce]:SWEep:STEP:STARt:LEVel? Description Set the start level of the sweep. Query the start level of the sweep. Parameter Explanation Return Format Example  Name Type Range Default Real -110dBm to 20dBm -10dBm When is set in "Number" form (for example, 2), the default unit is dBm.
PAGE 92
RIGOL Chapter 2 Command System [:SOURce]:SWEep:STEP:STARt:LEVel:STEP Syntax [:SOURce]:SWEep:STEP:STARt:LEVel:STEP [:SOURce]:SWEep:STEP:STARt:LEVel:STEP? Description Set the start level step of the sweep. Query the start level step of the sweep. Parameter Explanation Return Format Example Name Type Range Default Real 0.01dB to 100dB 1dB  When is set in "Number" form, the default unit is dB. Besides, can also be set in "Number + Unit" form; for example, 20dB.
PAGE 93
RIGOL Chapter 2 Command System [:SOURce]:SWEep:STEP:STOP:FREQuency:STEP Syntax [:SOURce]:SWEep:STEP:STOP:FREQuency:STEP [:SOURce]:SWEep:STEP:STOP:FREQuency:STEP? Description Set the stop frequency step of the sweep. Query the stop frequency step of the sweep. Parameter Explanation Return Format Example Name Type Range Default Real 10mHz to 1GHz 100MHz  When is set in "Number" form, the default unit is Hz.
PAGE 94
RIGOL Chapter 2 Command System [:SOURce]:SWEep:STEP:STOP:LEVel Syntax [:SOURce]:SWEep:STEP:STOP:LEVel [:SOURce]:SWEep:STEP:STOP:LEVel? Description Set the stop level of the sweep. Query the stop level of the sweep. Parameter Explanation Return Format Example  Name Type Range Default Real -110dBm to 20dBm -20dBm When is set in "Number" form (for example, 2), the default unit is dBm.
PAGE 95
RIGOL Chapter 2 Command System [:SOURce]:SWEep:STEP:STOP:LEVel:STEP Syntax [:SOURce]:SWEep:STEP:STOP:LEVel:STEP [:SOURce]:SWEep:STEP:STOP:LEVel:STEP? Description Set the stop level step of the sweep. Query the stop level step of the sweep. Parameter Explanation Return Format Example Name Type Range Default Real 0.01dB to 100dB 1dB  When is set in "Number" form, the default unit is dB. Besides, can also be set in "Number + Unit" form; for example, 20dB.
PAGE 96
RIGOL Chapter 2 Command System [:SOURce]:SWEep:SWEep:TRIGger:TYPE Syntax [:SOURce]:SWEep:SWEep:TRIGger:TYPE AUTO|KEY|BUS|EXT [:SOURce]:SWEep:SWEep:TRIGger:TYPE? Description Set the trigger mode of the sweep period. Query the trigger mode of the sweep period. Parameter Explanation Name Type Range Default AUTO|KEY|BUS|EXT Discrete AUTO|KEY|BUS|EXT AUTO  AUTO: select "Auto" trigger mode. If the sweep mode is set to "Cont", the instrument will start sweeping once a sweep manner is selected.
PAGE 97
RIGOL Chapter 2 Command System [:SOURce]:SWEep:TYPE Syntax [:SOURce]:SWEep:TYPE LIST|STEP [:SOURce]:SWEep:TYPE? Description Set the sweep type. Query the sweep type. Parameter Explanation Return Format Example Name Type Range Default LIST|STEP Discrete LIST|STEP STEP  LIST: select "List" sweep type. At this point, the RF signal generator sweeps according to the sweep list currently loaded.  STEP: select "Step" sweep type.
PAGE 98
RIGOL Chapter 2 Command System :STATus Commands The :STATus commands and IEEE488.2 common commands are mainly used to operate or query the status register. The structure of the status register is as shown in the figure below. It includes the questionable status register, operation status register, standard event status register, status byte register and error queue. The STATus commands are used to set and query the questionable status register and operation status register; the IEEE488.
PAGE 99
RIGOL Chapter 2 Command System The definitions of the questionable status register are as shown in the table below. Wherein, bit 0 to bit 2, bit 6 and bit 11 to bit 15 are not used and will be always treated as 0.
PAGE 100
RIGOL Chapter 2 Command System Command List:  :STATus:OPERation:CONDition  :STATus:OPERation:ENABle  :STATus:OPERation[:EVENt]  :STATus:QUEStionable:CALibration:CONDition  :STATus:QUEStionable:CALibration:ENABle  :STATus:QUEStionable:CALibration[:EVENt]  :STATus:QUEStionable:CONDition  :STATus:QUEStionable:CONNect:CONDition  :STATus:QUEStionable:CONNect:ENABle  :STATus:QUEStionable:CONNect[:EVENt]  :STATus:QUEStionable:ENABle  :STATus:QUEStionable[:EVENt]  :STATus:QUE
PAGE 101
RIGOL Chapter 2 Command System :STATus:OPERation:CONDition Syntax :STATus:OPERation:CONDition? Description Query the value of the condition register for the operation status register.
PAGE 102
RIGOL Chapter 2 Command System :STATus:QUEStionable:CALibration:CONDition Syntax :STATus:QUEStionable:CALibration:CONDition? Description Query the value of the condition register for the questionable calibration status register. Explanation  The relation between the calibration status register and questionable status register is as shown in the figure below.
PAGE 103
RIGOL Chapter 2 Command System :STATus:QUEStionable:CALibration:ENABle Syntax :STATus:QUEStionable:CALibration:ENABle :STATus:QUEStionable:CALibration:ENABle? Description Set the value of the enable register for the questionable calibration status register. Query the value of the enable register for the questionable calibration status register.
PAGE 104
RIGOL Chapter 2 Command System :STATus:QUEStionable:CONNect:CONDition Syntax :STATus:QUEStionable:CONNect:CONDition? Description Query the value of the condition register for the questionable connect status register. Explanation  The relation between the connect status register and questionable status register is as shown in the figure below.
PAGE 105
RIGOL Chapter 2 Command System :STATus:QUEStionable:CONNect:ENABle Syntax :STATus:QUEStionable:CONNect:ENABle :STATus:QUEStionable:CONNect:ENABle? Description Set the value of the enable register for the questionable connect status register. Query the value of the enable register for the questionable connect status register.
PAGE 106
RIGOL Chapter 2 Command System :STATus:QUEStionable[:EVENt] Syntax :STATus:QUEStionable[:EVENt]? Description Query the value of the event register for the questionable status register.
PAGE 107
RIGOL Chapter 2 Command System :STATus:QUEStionable:FREQuency:CONDition Syntax :STATus:QUEStionable:FREQuency:CONDition? Description Query the value of the condition register for the questionable frequency status register. Explanation  The relation between the frequency status register and questionable status register is as shown in the figure below.
PAGE 108
RIGOL Chapter 2 Command System :STATus:QUEStionable:FREQuency:ENABle Syntax :STATus:QUEStionable:FREQuency:ENABle :STATus:QUEStionable:FREQuency:ENABle? Description Set the value of the enable register for the questionable frequency status register. Query the value of the enable register for the questionable frequency status register.
PAGE 109
RIGOL Chapter 2 Command System :STATus:QUEStionable:MODulation:CONDition Syntax :STATus:QUEStionable:MODulation:CONDition? Description Query the value of the condition register for the questionable modulation status register. Explanation  The relation between the modulation status register and questionable status register is as shown in the figure below.
PAGE 110
RIGOL Chapter 2 Command System :STATus:QUEStionable:MODulation:ENABle Syntax :STATus:QUEStionable:MODulation:ENABle :STATus:QUEStionable:MODulation:ENABle? Description Set the value of the enable register for the questionable modulation status register. Query the value of the enable register for the questionable modulation status register.
PAGE 111
RIGOL Chapter 2 Command System :STATus:QUEStionable:POWer:CONDition Syntax :STATus:QUEStionable:POWer:CONDition? Description Query the value of the condition register for the questionable power status register. Explanation  The relation between the power status register and questionable status register is as shown in the figure below.
PAGE 112
RIGOL Chapter 2 Command System :STATus:QUEStionable:POWer:ENABle Syntax :STATus:QUEStionable:POWer:ENABle :STATus:QUEStionable:POWer:ENABle? Description Set the value of the enable register for the questionable power status register. Query the value of the enable register for the questionable power status register.
PAGE 113
RIGOL Chapter 2 Command System :STATus:QUEStionable:SELFtest:CONDition Syntax :STATus:QUEStionable:SELFtest:CONDition? Description Query the value of the condition register for the questionable selftest status register. Explanation  The relation between the selftest status register and questionable status register is as shown in the figure below.
PAGE 114
RIGOL Chapter 2 Command System :STATus:QUEStionable:SELFtest:ENABle Syntax :STATus:QUEStionable:SELFtest:ENABle :STATus:QUEStionable:SELFtest:ENABle? Description Set the value of the enable register for the questionable selftest status register. Query the value of the enable register for the questionable selftest status register.
PAGE 115
RIGOL Chapter 2 Command System :STATus:QUEStionable:TEMP:CONDition Syntax :STATus:QUEStionable:TEMP:CONDition? Description Query the value of the condition register for the questionable temperature status register. Explanation  The relation between the temperature status register and questionable status register is as shown in the figure below.
PAGE 116
RIGOL Chapter 2 Command System :STATus:QUEStionable:TEMP:ENABle Syntax :STATus:QUEStionable:TEMP:ENABle :STATus:QUEStionable:TEMP:ENABle? Description Set the value of the enable register for the questionable temperature status register. Query the value of the enable register for the questionable temperature status register.
PAGE 117
Chapter 2 Command System RIGOL :SYSTem Commands The :SYSTem commands are used to set a series of parameters relating to the system and the settings of these parameters do not affect the output signal of the RF signal generator.
PAGE 118
RIGOL Chapter 2 Command System :SYSTem:BRIGhtness Syntax :SYSTem:BRIGhtness :SYSTem:BRIGhtness? Description Set the brightness of the LCD. Query the brightness of the LCD. Parameter Explanation Return Format Example Name Type Range Default Integer 1 to 8 -- The "Brightness" setting will not be affected by factory reset. The query returns an integer. For example, 3. :SYST:BRIG 3 :SYST:BRIG? :SYSTem:CLEar Syntax :SYSTem:CLEar Description Clear all the user-defined data.
PAGE 119
RIGOL Chapter 2 Command System :SYSTem:COMMunication:LAN:DHCP Syntax :SYSTem:COMMunication:LAN:DHCP ON|OFF|1|0 :SYSTem:COMMunication:LAN:DHCP? Description Turn on or off the DHCP mode. Query the state of the DHCP mode. Parameter Explanation Return Format Example Name Type Range Default ON|OFF|1|0 Bool ON|OFF|1|0 ON|1  In DHCP mode, the DHCP server in the current network distributes network parameters (such as the IP address) for the instrument.
PAGE 120
RIGOL Chapter 2 Command System :SYSTem:COMMunication:LAN:IP:AUTO Syntax :SYSTem:COMMunication:LAN:IP:AUTO ON|OFF|1|0 :SYSTem:COMMunication:LAN:IP:AUTO? Description Turn on or off the Auto-IP configuration mode. Query the state of the Auto-IP configuration mode. Parameter Explanation Return Format Example Name Type Range Default ON|OFF|1|0 Bool ON|OFF|1|0 ON|1  In the Auto-IP configuration mode, the instrument acquires an IP address within 169.254.0.1 and 169.254.255.
PAGE 121
RIGOL Chapter 2 Command System :SYSTem:COMMunication:LAN:IP:MANual Syntax :SYSTem:COMMunication:LAN:IP:MANual ON|OFF|1|0 :SYSTem:COMMunication:LAN:IP:MANual? Description Turn on or off the Manual-IP configuration mode. Query the status of the Manual-IP configuration mode. Parameter Explanation Return Format Example Name Type Range Default ON|OFF|1|0 Bool ON|OFF|1|0 OFF|0  In the Manual-IP configuration mode, the network parameters (such as the IP address) are defined by users.
PAGE 122
RIGOL Chapter 2 Command System :SYSTem:COMMunication:LAN:IP:SUBnet:MASK Syntax :SYSTem:COMMunication:LAN:IP:SUBnet:MASK :SYSTem:COMMunication:LAN:IP:SUBnet:MASK? Description Set the subnet mask. Query the current subnet mask. Parameter Explanation Return Format Example Name Type Range Default ASCII string The format is nnn.nnn.nnn.nnn and the range of the nnn is from 0 to 255. --  This command is only valid when the Manual-IP configuration mode is turned on.
PAGE 123
RIGOL Chapter 2 Command System :SYSTem:DATE Syntax :SYSTem:DATE ,, :SYSTem:DATE? Description Set the date of the instrument. Query the date of the instrument. Parameter Return Format Example Name Type Range Default ASCII string 2000 to 2099 -- ASCII string 01 to 12 -- ASCII string 01 to 31 -- The query returns the current date in "YYYY,MM,DD" format. For example, 2015,04,21.
PAGE 124
RIGOL Chapter 2 Command System :SYSTem:FSWitch:STATe Syntax :SYSTem:FSWitch:STATe OPEN|DEFault :SYSTem:FSWitch:STATe? Description Set the power status of the RF signal generator after power-on. Query the power status of the RF signal generator after power-on. Parameter Explanation Return Format Example Name Type Range Default OPEN|DEFault Discrete OPEN|DEFault --  OPEN: select "Open" state. The RF signal generator starts automatically after power-on.  DEFault: select "Default" state.
PAGE 125
RIGOL Chapter 2 Command System :SYSTem:LKEY Syntax :SYSTem:LKEY :SYSTem:LKEY?
PAGE 126
RIGOL Chapter 2 Command System :SYSTem:PRESet Syntax :SYSTem:PRESet Description Reset the instrument to the preset state (the settings (FACtory or USER) defined by the :SYSTem:PRESet:TYPE command). Explanation Sending this command is equivalent to pressing Preset at the front panel, namely recalling the default values or user-preset values related to this key.
PAGE 127
RIGOL Chapter 2 Command System :SYSTem:TIME Syntax :SYSTem:TIME ,, :SYSTem:TIME? Description Set the time of the instrument. Query the time of the instrument. Parameter Return Format Example Name Type Range Default ASCII string 00 to 23 -- ASCII string 00 to 59 -- ASCII string 00 to 59 -- The query returns the current time in "hh,mm,ss" format. For example, 16,40,30.
PAGE 128
RIGOL Chapter 2 Command System :TRIGger Commands Command List:  :TRIGger:IQ[:IMMediate]  :TRIGger:PULSe[:IMMediate]  :TRIGger[:SWEep][:IMMediate] :TRIGger:IQ[:IMMediate] Syntax :TRIGger:IQ[:IMMediate] Description Trigger an IQ wavetable output immediately. Explanation When the "Trig Mode" of IQ wavetable is set to "Bus", the instrument starts outputting an IQ baseband signal each time this command is sent.
PAGE 129
RIGOL Chapter 2 Command System :UNIT Command Command List:  :UNIT:POWer :UNIT:POWer Syntax :UNIT:POWer DBM|DBMV|DBUV|V|W :UNIT:POWer? Description Set the output and display unit of the amplitude. Query the output and display unit of the amplitude. Parameter Return Format Example Name Type Range Default DBM|DBMV|DBUV|V|W Discrete DBM|DBMV|DBUV|V|W DBM The query returns DBM, DBMV, DBUV, V or W.
PAGE 130
PAGE 131
Chapter 3 Application Examples RIGOL Chapter 3 Application Examples This chapter provides some application examples of the SCPI commands. A series of SCPI commands are combined to realize the main functions of the RF signal generator. Note: 1. The examples in this chapter are based on DSG830. For other models, the ranges of some parameters might be different. When using the commands, please make proper adjustment according to the model of your instrument. 2.
PAGE 132
RIGOL Chapter 3 Application Examples To Output RF signal Requirement Use the SCPI commands to realize the following functions: Output a RF signal with 1GHz frequency and -20dBm amplitude from the [RF OUTPUT 50Ω] connector. Method 1. *IDN? 2. 3. 4. 5. 6.
PAGE 133
RIGOL Chapter 3 Application Examples To Output RF Modulated Signal Requirement Use the SCPI commands to realize the following functions: Output an AM modulated signal. Set the carrier frequency to 800MHz, the carrier amplitude to -20dBm, the AM modulation depth to 60% and the modulation frequency to 20kHz. Method 1. *IDN? 2. 3. :SYST:PRES:TYPE FAC :SYST:PRES 4. 5. 6. 7. 8. 9. 10.
PAGE 134
PAGE 135
Chapter 4 Programming Demos RIGOL Chapter 4 Programming Demos This chapter provides the demos for programming and controlling the RF signal generator using SCPI commands under Excel, Matlab, LabVIEW, Visual Basic and Visual C++ environment on the basis of NI-VISA. NI-VISA (National Instrument-Virtual Instrument Software Architecture) is an advanced application programming interface developed by NI (National Instrument) for communicating with various instrument buses.
PAGE 136
RIGOL Chapter 4 Programming Demos Programming Preparations Before programming, you need to make the following preparations. 1. Make sure that your PC has been installed with the NI-VISA library (can be downloaded from the NI website: http://www.ni.com/visa). Here, the default installation path is C:\Program Files\IVI Foundation\VISA. 2.
PAGE 137
Chapter 4 Programming Demos RIGOL Excel Programming Demo The program used in this demo: Microsoft Excel 2010 The functions realized in this demo: send the *IDN? Command to read the device information. 1. Create a new Excel file that enables the Macro. In this example, the file is named as DSG800_Demo_Excel.xlsm. 2. Run DSG800_Demo_Excel.xlsm. Click File  Options at the upper-left corner of the Excel file to open the interface as shown in the figure below.
PAGE 138
RIGOL 4. Chapter 4 Programming Demos Select Tools in the Microsoft Visual Basic menu bar and click References. Select VISA Library in the pop-up dialog box and click OK to refer to the VISA Library. Explanation: If you cannot find the VISA Library in the left list in the figure above, please try to find it using the following method. (1) Make sure that you have installed the NI-VISA library on your PC.
PAGE 139
Chapter 4 Programming Demos 5. RIGOL Click View Code in the Developer menu to enter the Microsoft Visual Basic interface. Add the following codes and save the file. Note: If the Excel file created at step 2 does not enable the Macros, at this point, the prompt message "The following features cannot be saved in macro-free workbooks" will be displayed. In this situation, please save the Excel file as a file using the Macros.
PAGE 140
RIGOL Chapter 4 Programming Demos menu to change the button name to "*IDN?". 7. 4-6 Click the "*IDN?" button to run the program. The device information of the RF signal generator is as shown in the figure below.
PAGE 141
RIGOL Chapter 4 Programming Demos Matlab Programming Demo The program used in this demo: MATLAB R2009a The functions realized in this demo: read the current frequency and amplitude of the RF signal generator. 1. Run Matlab and modify the current directory (namely modify the Current Directory at the top of the software). In this example, the current directory is changed to D:\DSG800_Demo. 2. Click File  New  Blank M-File in the Matlab interface to create a blank M file. 3.
PAGE 142
RIGOL Chapter 4 Programming Demos LabVIEW Programming Demo The program used in this demo: LabVIEW 2009 The functions realized in this demo: search for the instrument address, connect the instrument, send command and read the return value. 1. Run LabVIEW 2009. Create a new VI file and name it as DSG800_Demo_LABVIEW. 2. Add controls in the front panel interface, including the address bar, command bar and return bar as well as the Connect, Write, Read and Exit buttons. 3.
PAGE 143
Chapter 4 Programming Demos 4. RIGOL Add events, including connect the instrument, write operation, read operation and exit. (1) Connect the instrument (include error processing). (2) Write operation (include error judgment).
PAGE 144
RIGOL Chapter 4 Programming Demos (3) Read operation (include error processing).
PAGE 145
Chapter 4 Programming Demos RIGOL (4) Exit. 5. Run the program and the interface as shown below is displayed. Click the Address dropdown box and select the VISA resource name. Click Connect to connect the instrument, input the command in the Command text box and click Write to write the command into the instrument. If the command is a query command (for example, :FREQ?), you need to first click Write to write the command into the instrument and then click Read. The return value 1.
PAGE 146
RIGOL Chapter 4 Programming Demos Visual Basic Programming Demo The program used in this demo: Visual Basic 6.0 The functions realized in this demo: turn on the LF, MOD and RF output switches respectively and use yellow label to indicate that the output is turned on. 1. Build a standard application program project (Standard EXE) and name it as DSG800_Demo_VB. 2. Click the Existing tab under Project  Add Module. Find the visa32.
PAGE 147
Chapter 4 Programming Demos RIGOL Dim list As Long Dim nmatches As Long Dim matches As String * 200 'Keep the device number acquired 'Acquire the usb resource of visa Call viOpenDefaultRM(defrm) Call viFindRsrc(defrm, "USB?*", list, nmatches, matches) 'Turn on the device Call viOpen(defrm, matches, 0, 0, vi) 'Send command to query the status of the LF switch Call viVPrintf(vi, ":LFO?" + Chr$(10), 0) 'Acquire the status of LF Call viVScanf(vi, "%t", strRes) If strRes = 1 Then 'Send the setting command Call
PAGE 148
RIGOL Chapter 4 Programming Demos 2) Click "MOD" to turn on the modulation output and the control above the MOD button turns yellow (as shown in the figure below). At this point, the RF signal generator can output the RF modulated signal via the [RF OUTPUT 50Ω] connector if the RF output is turned on. Click "MOD" again to turn off the modulation output and the control above the MOD button turns gray.
PAGE 149
Chapter 4 Programming Demos RIGOL Visual C++ Programming Demo The program used in this demo: Microsoft Visual C++ 6.0 The functions realized in this demo: search for the instrument address, connect the instrument, send command and read the return value. 1. Run Microsoft Visual C++ 6.0. Create a new MFC project based on dialog box and name it as DSG800_DEMO_VC. 2. Click Project  Settings and add visa32.lib under the Link tab in the pop-up interface manually. 3.
PAGE 150
RIGOL Chapter 4 Programming Demos 4. Add the Text, Edit and Button controls. The layout is as shown in the figure below. 5. Click View  ClassWizard and add the control variables under the Member Variables tab in the pop-up interface.
PAGE 151
RIGOL Chapter 4 Programming Demos 6. Encapsulate the read and write operations of VISA. 1) Encapsulate the write operation of VISA for easier operation. bool CDSG800_DEMO_VCDlg::InstrWrite(CString strAddr, CString strContent) { ViSession defaultRM,instr; ViStatus status; ViUInt32 retCount; char * SendBuf = NULL; char * SendAddr = NULL; bool bWriteOK = false; CString str; //write function //Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.
PAGE 152
RIGOL Chapter 4 Programming Demos //Close the instrument status = viClose(instr); status = viClose(defaultRM); } return bWriteOK; 2) Encapsulate the read operation of VISA for easier operation.
PAGE 153
Chapter 4 Programming Demos RIGOL ViPFindList findList = new unsigned long; ViPUInt32 retcnt = new unsigned long; ViChar instrDesc[1000]; CString strSrc = ""; CString strInstr = ""; unsigned long i = 0; bool bFindDSG = false; status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { //Error Initializing VISA...
PAGE 154
RIGOL } Chapter 4 Programming Demos InstrWrite(m_strInstrAddr,m_strCommand); m_strResult.Empty(); UpdateData(false); 3) Read operation void CDSG800_DEMO_VCDlg::OnRead() { //TODO: Add your control notification handler code here UpdateData(true); InstrRead(m_strInstrAddr,&m_strResult); UpdateData(false); } 8. Execution Results 1) Click "Connect" to find and connect the RF signal generator.
PAGE 155
RIGOL Chapter 5 Appendix Chapter 5 Appendix Appendix A: Factory Setting Parameter FREQ Frequency Factory Value DSG830: 3GHz DSG815: 1.
PAGE 156
RIGOL Chapter 5 Appendix Frequency Deviation Modulation Rate Modulation Waveform External Coupling Input Impedance 10kHz 10kHz Sine AC 100kohm ØM Switch Modulation Source Phase Deviation Modulation Rate Modulation Waveform External Coupling Input Impedance Off Int 5rad 10kHz Sine AC 100kohm Pulse Mod Switch Modulation Source Pulse Mode Period Pulse Width Trigger Mode Pulse Output Trigger Delay Modulation Polarity External Gated Polarity External Trigger Polarity Off Int Single 1ms 500us Auto Off 100u
PAGE 157
RIGOL Chapter 5 Appendix Brightness Time/Date Power Status 4 Off Open Save[1] File Type IME Prefix Switch All Number Off Note[1]: Not affected by the preset setting.
PAGE 158
RIGOL Chapter 5 Appendix Appendix B: Warranty RIGOL (SUZHOU) TECHNOLOGIES, INC. (hereinafter referred to as RIGOL) warrants that the product will be free from defects in materials and workmanship within the warranty period. If a product proves defective within the warranty period, RIGOL guarantees free replacement or repair for the defective product. To get repair service, please contact with your nearest RIGOL sales or service office.