Rigol DG800 Series Programming Manual
  1. Manuals
  2. Brands
  3. Rigol Manuals
  4. Pulse Generator
  5. DG800 Series
  6. Programming manual

Rigol DG800 Series Programming Manual

Function/arbitrary waveform generator
Hide thumbs Also See for DG800 Series:
Table of Contents

Advertisement

Quick Links

RIGOL
Programming Guide
DG800 Series
Function/Arbitrary Waveform Generator
Jul. 2018
RIGOL (SUZHOU) TECHNOLOGIES INC.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the DG800 Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Rigol DG800 Series

Summary of Contents for Rigol DG800 Series

  • Page 1 RIGOL Programming Guide DG800 Series Function/Arbitrary Waveform Generator Jul. 2018 RIGOL (SUZHOU) TECHNOLOGIES INC.

  • Page 3: Guaranty And Declaration

    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.

  • Page 4: Document Overview

    Utility on the front panel, and then tap the System Setting menu label. Content Conventions in this Manual: DG800 series function/arbitrary waveform generator includes the following models: Unless otherwise specified, this manual takes DG832 as an example to introduce each command of the DG800 series. DG800 Programming Guide...
  • Page 5 RIGOL Model No. of Channels Max. Output Frequency DG812 10 MHz DG822 25 MHz DG832 35 MHz DG811 10 MHz DG821 25 MHz DG831 35 MHz DG800 Programming Guide...

  • Page 6: Table Of Contents

    RIGOL Contents Contents Guaranty and Declaration ......................I Document Overview ......................... II Chapter 1 Programming Overview ..................1-1 Build Remote Communication ....................1-2 Remote Control Method ......................1-4 SCPI Command Overview ......................1-4 Syntax ..........................1-4 Symbol Description ......................1-5 Parameter Type ........................
  • Page 7 RIGOL Contents To Output Sweep Waveform ...................... 3-4 To Output Burst Waveform ......................3-5 To Use the Frequency Counter ....................3-5 Chapter 4 Programming Examples ..................4-1 Programming Preparations ......................4-2 Excel Programming Examples ....................4-3 Matlab Programming Example ....................4-6 LabVIEW Programming Example ....................

  • Page 9: Chapter 1 Programming Overview

    RIGOL Chapter 1 Programming Overview Chapter 1 Programming Overview This chapter introduces how to build the remote communication between the signal generator and the PC; how to control the signal generator remotely. It also introduces the syntax, symbols, parameter types, and abbreviation rules of the SCPI commands.

  • Page 10: Build Remote Communication

    (extended from the USB HOST interface by using the USB-GPIB interface converter). Operation Procedures: Install Ultra Sigma (PC) software Download the Ultra Sigma common PC software from www.rigol.com and install it according to the instructions. Connect the analyzer to the PC and configure the interface parameters for the instrument...
  • Page 11 RIGOL Chapter 1 Programming Overview Check whether the connection is successful Run Ultra Sigma, and then search for the resources and right-click the resource name. Select "SCPI Panel Control" to open the SCPI command control panel. Input a correct command in the pop-up SCPI...

  • Page 12: Remote Control Method

    Chapter 4 "Programming Examples". Send SCPI commands via the PC software You can use the PC software to send commands to control the signal generator remotely. RIGOL Ultra Sigma is recommended. You can download the software from RIGOL official website (www.rigol.com).

  • Page 13: Symbol Description

    RIGOL Chapter 1 Programming Overview Symbol Description The following four symbols are not part of the SCPI command, and they are not sent with the commands, but taken as delimiters to better describe the parameters in the command. Braces { } The contents enclosed in the braces can contain multiple parameter options;...

  • Page 14: Command Abbreviation

    RIGOL Chapter 1 Programming Overview For example, MINimum and MAXimum in the :DISPlay:BRIGhtness {<brightness>|MINimum|MAXimum} command are used to set the brightness to the minimum or maximum. Command Abbreviation The letters in the commands are case-insensitive. The commands can be input all in uppercase letters or in lowercase letters.

  • Page 15: Chapter 2 Command System

    RIGOL Chapter 2 Command System Chapter 2 Command System This chapter introduces the syntax, function, parameters, and usages of each DG800 command in A-Z order. Contents in this chapter: :COUNter Commands  :COUPling Commands  :DISPlay Commands  :HCOPy Commands ...

  • Page 16: Counter Commands

    RIGOL Chapter 2 Command System :COUNter Commands The :COUNter commands are used to enable or disable the frequency counter; set the related information of the frequency counter. Command List :COUNter:AUTO  :COUNter:COUPling  :COUNter:GATEtime  :COUNter:HF  :COUNter:LEVEl  :COUNter:MEASure? ...
  • Page 17 RIGOL Chapter 2 Command System :COUNter:AUTO Syntax :COUNter:AUTO Description The instrument will select a proper gate time automatically according to the characteristics of the signal under test after sending this command. Remarks You can also send the :COUNter:GATEtime command to set the desired gate time.
  • Page 18 RIGOL Chapter 2 Command System according to the characteristics of the signal under test. During this process, "AUTO" is displayed in the gate time area in the frequency counter interface. The gate time currently selected by the instrument will be displayed in the gate time area in the frequency counter interface after the instrument selects a proper gate time.
  • Page 19 RIGOL Chapter 2 Command System Parameter Name Type Range Default <value> Real -2.5 V to 2.5 V Remarks The frequency counter starts measuring when the input signal reaches the specified trigger level.  The minimum resolution is 6 mV. ...
  • Page 20 RIGOL Chapter 2 Command System Parameter Name Type Range Default {LOW|HIGh} Real LOW|HIGh Remarks A higher sensitivity is recommended for the signal with a small amplitude; a low sensitivity is recommended for a low-frequency signal with a large amplitude or a signal with a slow rising edge to ensure the accuracy of the measurement result.
  • Page 21 RIGOL Chapter 2 Command System :COUN? /*Queries the status of the frequency counter and the query returns OFF.*/ :COUN 1 /*Enables the frequency counter function.*/ :COUN? /*Queries the status of the frequency counter and the query returns RUN (the default operating status).*/...

  • Page 22: Coupling Commands

    RIGOL Chapter 2 Command System :COUPling Commands The :COUPling commands are used to set the related information of the channel frequency coupling, amplitude coupling, and phase coupling; enable and disable the three coupling functions. Command List: :COUPling[<n>]:AMPL:DEViation  :COUPling[<n>]:AMPL:MODE ...
  • Page 23 RIGOL Chapter 2 Command System :COUPling[<n>]:AMPL:DEViation Syntax :COUPling[<n>]:AMPL:DEViation <deviation> :COUPling[<n>]:AMPL:DEViation? Description Sets the amplitude deviation in the amplitude coupling of the specified channel. Queries the amplitude deviation in the amplitude coupling of the specified channel. Parameter Name Type Range Default [<n>]...
  • Page 24 RIGOL Chapter 2 Command System amplitude deviation. Amplitude ratio mode: the amplitudes of CH1 and CH2 have a certain ratio relation. The parameter  relations are A (the reference source is CH1); A (the reference source is Ratio Ratio CH2). Wherein, A...
  • Page 25 RIGOL Chapter 2 Command System :COUPling[<n>]:AMPL[:STATe] Syntax :COUPling[<n>]:AMPL[:STATe] {ON|1|OFF|0} :COUPling[<n>]:AMPL[:STATe]? Description Enables or disables the amplitude coupling function of the specified channel. Queries the on/off status of the amplitude coupling function of the specified channel. Parameter Name Type Range Default [<n>]...
  • Page 26 RIGOL Chapter 2 Command System frequency coupling mode and frequency deviation/ratio after the frequency coupling function is enabled. When the frequency coupling function is disabled, if the current frequency coupling mode is frequency  deviation, sending this command can set the frequency deviation; if the current frequency coupling mode is frequency ratio, sending this command can set the frequency coupling mode to frequency deviation and set the frequency deviation.
  • Page 27 RIGOL Chapter 2 Command System Example :COUP1:FREQ:MODE OFFS /*Sets the frequency coupling mode of CH1 to frequency deviation.*/ :COUP1:FREQ:MODE? /*Queries the selected frequency coupling mode and the query returns OFFS.*/ :COUPling[<n>]:FREQuency:RATio Syntax :COUPling[<n>]:FREQuency:RATio {<value>|MINimum|MAXimum} :COUPling[<n>]:FREQuency:RATio? Description Sets the frequency ratio in the frequency coupling of the specified channel.
  • Page 28 RIGOL Chapter 2 Command System Parameter Name Type Range Default [<n>] Discrete {ON|1|OFF|0} Bool ON|1|OFF|0 Remarks When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.  Select the desired frequency coupling mode and set the corresponding frequency deviation or ...
  • Page 29 RIGOL Chapter 2 Command System Return Format The query returns the phase deviation in scientific notation. The returned value contains 7 effective digits, for example, 9.000000E+01 (the phase deviation is 90°). Example :COUP1:PHAS:DEV 90 /*Sets the phase deviation in the phase coupling of CH1 to 90°.*/...
  • Page 30 RIGOL Chapter 2 Command System :COUPling[<n>]:PHASe:RATio Syntax :COUPling[<n>]:PHASe:RATio {<value>|MINimum|MAXimum} :COUPling[<n>]:PHASe:RATio? Description Sets the phase ratio in the phase coupling of the specified channel. Queries the phase ratio in the phase coupling of the specified channel. Parameter Name Type Range Default [<n>]...
  • Page 31 RIGOL Chapter 2 Command System phase deviation (:COUPling[<n>]:PHASe:DEViation) or phase ratio (:COUPling[<n>]:PHASe:RATio) before enabling the phase coupling function. You cannot set the phase coupling mode and phase deviation/ratio after the phase coupling function is enabled. Select the desired phase coupling mode and set the corresponding phase deviation or phase ratio ...
  • Page 32 RIGOL Chapter 2 Command System :COUPling[<n>]:TRIgger[:STATe] Syntax :COUPling[<n>]:TRIgger [:STATe] {ON|1|OFF|0} :COUPling[<n>]:TRIgger [:STATe]? Description Enables or disables the trigger coupling function of the specified channel. Queries the on/off status of the trigger coupling function of the specified channel. Parameter Name Type...

  • Page 33: Display Commands

    RIGOL Chapter 2 Command System :DISPlay Commands The :DISPlay commands are used to set the display-related information, display the specified characters on the screen, and clear the characters displayed on the screen. Command List: :DISPlay:BRIGhtness  :DISPlay:SAVer:IMMediate  :DISPlay:SAVer[:STATe] ...
  • Page 34 RIGOL Chapter 2 Command System :DISPlay:SAVer[:STATe] Syntax :DISPlay:SAVer[:STATe] {ON|1|OFF|0} :DISPlay:SAVer[:STATe]? Description Enables or disables the screen saver function. Queries the on/off status of the screen saver function. Parameter Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 Remarks When the screen saver function is enabled, the instrument enters the screen saver mode automatically when you stop operating the instrument for more than 15 minutes and the screen stays black automatically after another 30 minutes.

  • Page 35: Hcopy Commands

    RIGOL Chapter 2 Command System :HCOPy Commands The :HCOPy commands are used to set and query the format of the returned image of the screenshot and execute the screenshot operation. Command List: :HCOPy:SDUMp:DATA?  :HCOPy:SDUMp:DATA:FORMat  :HCOPy:SDUMp:DATA? Syntax :HCOPy:SDUMp:DATA? Description Queries the image of the front panel screen (screenshot).

  • Page 36: Ieee488.2 Common Commands

    RIGOL Chapter 2 Command System IEEE488.2 Common Commands The IEEE488.2 standard defines a series of common commands that can be used to execute various functions, such as the reset, self-test, and status operations. Command List: *CLS  *ESE  *ESR? ...
  • Page 37 The query returns the ID string of the instrument. The returned value consists of 4 parts separated by commas. For example, Rigol Technologies,DG832,DG80000000001,00.01.05.00.03; wherein, the first part is the manufacturer name, the second part is the instrument model, the third part is the instrument serial number, and the forth part is the version number.
  • Page 38 RIGOL Chapter 2 Command System Remarks "operation complete" refers to that all the previous commands that have been sent, including the *OPC  command, are executed completely. You can also use the *OPC (operation complete) or *OPC? (operation complete query) command to set ...
  • Page 39 RIGOL Chapter 2 Command System *PSC Syntax *PSC {0|1} *PSC? Description Enables or disables clearing of the status byte enable register and standard event enable register at power-on. Queries whether to clear the status byte enable register and standard event enable register at power-on.
  • Page 40 RIGOL Chapter 2 Command System *RST Syntax *RST Description Restores the instrument to its factory default state. Remarks Restores the instrument to its factory default state (please refer to "Factory Setting") and it is not  affected by the :MEMory:STATe:RECall:AUTO command.
  • Page 41 RIGOL Chapter 2 Command System enabled in the status byte register. The selected bits are summarized in the "master summary" bit (bit6) of the status byte register. If any of the selected bits change from 0 to 1, the instrument generates a Service Request signal.
  • Page 42 RIGOL Chapter 2 Command System *WAI Syntax *WAI Description Executes any other command via the interface after all the pending operations are completed. Remarks This command is only applicable to the triggered sweep mode or triggered burst mode, and is used to ensure synchronization.

  • Page 43: License Commands

    Order an option (e.g. single-dual channel upgrade option, with the order No. DG800-DCH) to acquire the key. Log in to the RIGOL official website (www.rigol.com), click License Activation to enter the "Registered product license code" interface. Input the correct key, serial number, (press Utility  System Info to acquire the serial number of the instrument) and verification code.
  • Page 44 English letters and numbers. Each instrument corresponds to an option license. If you need to use this option, please order this  option to acquire the key. Then, visit the website of RIGOL to obtain the option license. Example :LICense:INSTall...

  • Page 45: Memory Commands

    RIGOL Chapter 2 Command System :MEMory Commands The :MEMory commands are used to query the storage capacity and the state files stored in the internal non-volatile memory of the instrument; query whether the state file is stored in the specified storage location;...
  • Page 46 RIGOL Chapter 2 Command System :MEMory:STATe:DELete Syntax :MEMory:STATe:DELete {0|1|2|3|4|5} Description Deletes the state file stored in the specified location of the internal non-volatile memory of the instrument. Parameter Name Type Range Default {0|1|2|3|4|5} Discrete 0|1|2|3|4|5 None Remarks The internal non-volatile memory of the instrument provides 6 storage locations for state files. 0 to 5 ...
  • Page 47 RIGOL Chapter 2 Command System :MEM:STAT:NAME? 2 /*Queries the filename of the state file stored in storage location 2 of the internal non-volatile memory of the instrument. The query returns "123.RSF".*/ :MEMory:STATe:RECall:AUTO Syntax :MEMory:STATe:RECall:AUTO {ON|1|OFF|0} :MEMory:STATe:RECall:AUTO? Description Recalls the configuration of the instrument to last (ON or 1) or default (OFF or 0) at next power-on.

  • Page 48: Mmemory Commands

    Remarks The parameter <folder> is a valid directory in the internal or external memory. It is a string enclosed by double quotation marks. For example, "C:\" and "D:\Rigol". Return Format The query returns a string in the following format: space used,space available,"size,property,name",……;...
  • Page 49 28672 bytes and the space available is 4102361088 bytes; it contains 1 folder (Rigol) and the folder contains 2 files or folders; it contains 2 files, of which the size of the arbitrary waveform file (Rigol1.RAF) is 80 bytes and the size of the state file (Rigol0.RSF) is 1360 bytes.
  • Page 50 Remarks The parameter <directory_name> is a valid directory in the internal or external memory. It is a string enclosed by double quotation marks. For example, "C:\" and "D:\Rigol". Return Format The query returns a string enclosed by double quotation marks and the content in the double quotation marks is the current directory.
  • Page 51 For example, "C:\" and "D:\Rigol". Example Assume that the current directory is D:\. :MMEM:COPY "D:\Rigol","Rigol1.RAF" /*Copies the file Rigol1.RAF from the external memory directory to "D:\Rigol" (i.g. the Rigol folder in Disk D).*/ :MMEMory:DELete Syntax :MMEMory:DELete <file_name>...
  • Page 52  specified directory and it is a string enclosed by double quotation marks. For example, "Rigol4.RAF". Example Assume that the current directory is D:\Rigol. :MMEM:LOAD:DATA "Rigol4.RAF" /*Loads the arbitrary waveform file Rigol4.RAF in the current directory (D:\Rigol) into the current channel.*/...
  • Page 53 RIGOL Chapter 2 Command System :MMEMory:LOAD:STATe Syntax :MMEMory:LOAD:STATe <file_name> Description Loads the specified state file from the current directory. Parameter Name Type Range Default The filename of the state file in <file_name> ASCII String None the current directory Remarks The parameter <file_name> is the filename of the state file in the current directory and it is a string enclosed by double quotation marks.
  • Page 54 For example, "C:\" and "D:\Rigol". Example Assume that the current directory is D:\. :MMEM:MOVE "D:\Rigol.RSF","D:\Rigol" /*Moves the file Rigol.RSF from the external memory directory to "D:\Rigol" (i.g. the Rigol folder in Disk D).*/ :MMEMory:RDIRectory? Syntax :MMEMory:RDIRectory? Description Queries the available disk drive.
  • Page 55 RIGOL Chapter 2 Command System :MMEMory:STORe[:ALL] Syntax :MMEMory:STORe[:ALL] <file_name> Description Stores the current instrument state or the arbitrary waveform data of the current channel into the current directory in state file or arbitrary waveform file form with the specified name.
  • Page 56 RIGOL Chapter 2 Command System :MMEMory:STORe:STATe Syntax :MMEMory:STORe:STATe <file_name> Description Stores the current instrument state into the current directory in state file form with the specified filename. Parameter Name Type Range Default <file_name> ASCII String Refer to "Remarks". None Remarks The parameter <file_name>...

  • Page 57: Output Commands

    RIGOL Chapter 2 Command System :OUTPut Commands The :OUTPut commands is used to set and query the information related to the channel output and sync signal, including setting and querying the channel output state, output polarity, output impedance, output mode and gate polarity as well as setting and querying the output state, output polarity and delay time of the sync signal.
  • Page 58 RIGOL Chapter 2 Command System Example :OUTP1:IMP INF /*Sets the output impedance of the output connector of CH1 to HighZ.*/ :OUTP1:IMP? /*Queries the output impedance of the output connector of CH1 and the query returns 9.900000E+37.*/ :OUTP1:LOAD 100 /*Sets the output impedance of the output connector of CH1 to 100 Ω.*/...
  • Page 59 RIGOL Chapter 2 Command System Return Format The query returns ON or OFF. Example :OUTP1? /*Queries the output status of CH1 and the query returns OFF.*/ :OUTP1 ON /*Enables the output of CH1.*/ :OUTP1? /*Queries the output status of CH1 and the query returns ON.*/ :OUTPut[<n>]:SYNC:POLarity...
  • Page 60 RIGOL Chapter 2 Command System Parameter Name Type Range Default [<n>] Discrete {ON|1|OFF|0} Bool ON|1|OFF|0 Remarks DG800 can output the basic waveforms (except Noise), arb waveforms, harmonics, sweep waveforms,  burst waveforms, and the sync signal of the modulated waveforms from a single channel or the dual channels at the same time.
  • Page 61 RIGOL Chapter 2 Command System :OUTPut[<n>]:VOLLimit:LOW Syntax :OUTPut[<n>]:VOLLimit:LOW <amp> :OUTPut[<n>]:VOLLimit:LOW? Description Sets the low level amplitude of voltage limit. Queries the low level amplitude of voltage limit. Parameter Name Type Range Default [<n>] Discrete Refer to "Remarks". <amp> Real Remarks When [<n>] is omitted, the commands set and query the related parameters of CH1 by default.

  • Page 62: Roscillator Commands

    RIGOL Chapter 2 Command System :ROSCillator Commands The :ROSCillator commands are used to set the system clock source and query the currently selected system clock source. Command List: :ROSCillator:SOURce  :ROSCillator:SOURce:CURRent?  :ROSCillator:SOURce Syntax :ROSCillator:SOURce {INTernal|EXTernal} Description Sets the system clock source to internal source (INTernal) or external source (EXTernal).
  • Page 63 RIGOL Chapter 2 Command System :ROSCillator:SOURce:CURRent? Syntax :ROSCillator:SOURce:CURRent? Description Queries the currently selected system clock source. Remarks You can send the :ROSCillator:SOURce command to set the system clock source to Internal or External. Return Format The query returns INT or EXT.

  • Page 64: Source Commands

    The frequency ranges available for different models and different waveforms of DG800 series are as shown in the table below.

  • Page 65: Source:apply

    RIGOL Chapter 2 Command System :SOURce:TRACe  :SOURce:TRACK  :SOURce:VOLTage  :SOURce:APPLy Command List: [:SOURce[<n>]]:APPLy?  [:SOURce[<n>]]:APPLy:DC  [:SOURce[<n>]]:APPLy:DUALTone  [:SOURce[<n>]]:APPLy:HARMonic  [:SOURce[<n>]]:APPLy:NOISe  [:SOURce[<n>]]:APPLy:PRBS  [:SOURce[<n>]]:APPLy:PULSe  [:SOURce[<n>]]:APPLy:RAMP  [:SOURce[<n>]]:APPLy:RS232  [:SOURce[<n>]]:APPLy:SEQuence  [:SOURce[<n>]]:APPLy:SINusoid  [:SOURce[<n>]]:APPLy:SQUare  [:SOURce[<n>]]:APPLy:USER ...
  • Page 66 RIGOL Chapter 2 Command System digits and the default units are Hz, Vpp, V and ° respectively; the absent item is replaced by DEF) of the waveform of the specified channel respectively. For example, "SQU,1.000000E+03,2.000000E+00,3.000000E+00,4.000000E+00" denotes that the current waveform is Square, the frequency is 1 kHz, the amplitude is 2 Vpp, the offset is 3 V , and the start phase is 4°.
  • Page 67 RIGOL Chapter 2 Command System "Impedance" and "Amplitude/High Level" settings. Example :SOUR1:APPL:DUALTone 100,1,2 /*Sets the waveform of CH1 to Dual-tone, with 100 Hz frequency, 1 Vpp amplitude, and 2 V offset.*/ [:SOURce[<n>]]:APPLy:HARMonic Syntax [:SOURce[<n>]]:APPLy:HARMonic [<freq>|DEFault|MINimum|MAXimum[,<amp>|DEFault|MINimum|MAXimum[,<offset>|DEFault|MINimu m|MAXimum[,<phase>|DEFault|MINimum|MAXimum]]]] Description Enables the harmonic function of the specified channel and sets the fundamental waveform (Sine) parameters (frequency, amplitude, offset, and phase).
  • Page 68 RIGOL Chapter 2 Command System Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  The range of <amp> is limited by the "Impedance" (:OUTPut[<n>]:IMPedance  or :OUTPut[<n>]:LOAD) setting. The range of <offset> is limited by the "Impedance" and "Amplitude/High Level"...
  • Page 69 RIGOL Chapter 2 Command System Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  The range of <amp> is limited by the "Impedance" (:OUTPut[<n>]:IMPedance  or :OUTPut[<n>]:LOAD) and "Frequency/Period" settings. The range of <offset> is limited by the "Impedance"...
  • Page 70 RIGOL Chapter 2 Command System Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  The range of <amp> is limited by the "Impedance" (:OUTPut[<n>]:IMPedance  or :OUTPut[<n>]:LOAD) and "Frequency/Period" settings. The range of <offset> is limited by the "Impedance"...
  • Page 71 RIGOL Chapter 2 Command System <amp> Real Refer to "Remarks". 5 Vpp Refer to "Remarks". <offset> Real <phase> Real 0° to 360° 0° Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.

  • Page 72: Source:burst

    RIGOL Chapter 2 Command System Parameter Name Type Range Default [<n>] Discrete <freq> Real 1 μHz to 10 MHz 1 kHz Refer to "Remarks". <amp> Real 5 Vpp Refer to "Remarks". <offset> Real <phase> Real 0° to 360° 0° Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.
  • Page 73 RIGOL Chapter 2 Command System Parameter Name Type Range Default [<n>] Discrete {NORMal|INVerted} Discrete NORMal|INVerted NORMal Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  The gate polarity is only applicable to the gated burst mode ([:SOURce[<n>]]:BURSt:MODE). The ...
  • Page 74 RIGOL Chapter 2 Command System Return Format The query returns the burst period in scientific notation, with 7 effective digits. For example, 1.000000E-01 (the burst period is 0.1 s). Example :SOUR1:BURS:INT:PER 0.1 /*Sets the internal burst period of the N cycle burst of CH1 to 0.1 s.*/...
  • Page 75 RIGOL Chapter 2 Command System [:SOURce[<n>]]:BURSt:NCYCles Syntax [:SOURce[<n>]]:BURSt:NCYCles {<cycles>|MINimum|MAXimum} [:SOURce[<n>]]:BURSt:NCYCles? [MINimum|MAXimum] Description Sets the number of cycles in the N cycle burst of the specified channel. Queries the number of cycles in the N cycle burst of the specified channel.
  • Page 76 RIGOL Chapter 2 Command System [:SOURce[<n>]]:BURSt[:STATe] Syntax [:SOURce[<n>]]:BURSt[:STATe] {ON|1|OFF|0} [:SOURce[<n>]]:BURSt[:STATe]? Description Enables or disables the burst function of the specified channel. Queries the on/off status of the burst function of the specified channel. Parameter Name Type Range Default [<n>] Discrete...
  • Page 77 RIGOL Chapter 2 Command System Wherein, ——burst period; burst ——waveform period (i.g. the period of the burst function (Sine, Square, etc.)); waveform ——number of the burst cycles. cycle When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.
  • Page 78 RIGOL Chapter 2 Command System ([:SOURce[<n>]]:BURSt:TRIGger:SOURce). In the External trigger, the signal generator receives the trigger signal input from the rear-panel [Sync/Ext Mod/Trig/FSK] connector. Once it receives a TTL pulse with a specified polarity, a burst output (N cycle, Infinite, or Gated) is initiated.
  • Page 79 RIGOL Chapter 2 Command System Example :SOUR1:BURS:TRIG:SOUR EXT /*Sets the trigger source of the burst mode of CH1 to External.*/ :SOUR1:BURS:TRIG:SOUR? /*Queries the trigger source of the burst mode of CH1 and the query returns EXT.*/ [:SOURce[<n>]]:BURSt:TRIGger:TRIGOut Syntax [:SOURce[<n>]]:BURSt:TRIGger:TRIGOut {POSitive|NEGative|OFF} [:SOURce[<n>]]:BURSt:TRIGger:TRIGOut?

  • Page 80: Source:frequency

    RIGOL Chapter 2 Command System Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default. Return Format The query returns FPT, TOP, CENTER, BOTTOM; or returns the user-defined idle level position in integer.
  • Page 81 RIGOL Chapter 2 Command System When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  The start frequency, stop frequency, center frequency and frequency span fulfills the following  equations. − center start...
  • Page 82 RIGOL Chapter 2 Command System You can also send the :COUPling[<n>]:FREQuency:MODE command to set and query the frequency  coupling mode. Return Format The query returns OFFS or RAT. Example :FREQ:COUP:MODE OFFS /*Sets the frequency coupling mode of CH1 to Frequency Deviation.*/ :FREQ:COUP:MODE? /*Queries the frequency coupling mode and the query returns OFFS.*/...
  • Page 83 RIGOL Chapter 2 Command System Queries the frequency ratio in the frequency coupling. Parameter Name Type Range Default [<n>] Discrete <ratio> Real 0.000 001 to 1 000 000 Remarks Select the desired frequency coupling mode ([:SOURce[<n>]]:FREQuency:COUPle:MODE) and set the ...
  • Page 84 RIGOL Chapter 2 Command System status of the frequency coupling function. Return Format The query returns ON or OFF. Example :FREQ:COUP ON /*Enables the frequency coupling function.*/ :FREQ:COUP? /*Queries the on/off status of the frequency coupling function and the query returns ON.*/...
  • Page 85 RIGOL Chapter 2 Command System Parameter Name Type Range Default [<n>] Discrete Frequency range of the current <frequency> Real 900 Hz waveform of the specified channel Remarks You can set the sweep boundaries via the center frequency and frequency span ...
  • Page 86 RIGOL Chapter 2 Command System Remarks Start frequency and stop frequency ([:SOURce[<n>]]:FREQuency:STOP) are the upper and lower  limits of the frequency for frequency sweep. The generator always sweeps from the start frequency to the stop frequency, and then returns back to the start frequency. When the start frequency is smaller than the stop frequency, the signal generator sweeps from the low frequency to high frequency;...

  • Page 87: Source:function

    RIGOL Chapter 2 Command System frequency to low frequency. When the start frequency is equal to the stop frequency, the signal generator outputs at the fixed frequency. When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.
  • Page 88 RIGOL Chapter 2 Command System [:SOURce[<n>]]:FUNCtion:RS232:STOPBit  [:SOURce[<n>]]:FUNCtion:SEQuence:EDGETime  [:SOURce[<n>]]:FUNCtion:SEQuence:FILTer  [:SOURce[<n>]]:FUNCtion:SEQuence:PERiod  [:SOURce[<n>]]:FUNCtion:SEQuence:SRATe  [:SOURce[<n>]]:FUNCtion:SEQuence[:STATe]  [:SOURce[<n>]]:FUNCtion:SEQuence:WAVE  [:SOURce[<n>]]:FUNCtion[:SHAPe]  [:SOURce[<n>]]:FUNCtion:SQUare:DCYCle  [:SOURce[<n>]]:FUNCtion:SQUare:PERiod  [:SOURce[<n>]]:FUNCtion:DUALTone:CENTERFreq Syntax [:SOURce[<n>]]:FUNCtion:DUALTone:CENTERFreq {<frequency>|MINimum|MAXimum} [:SOURce[<n>]]:FUNCtion:DUALTone:CENTERFreq? Description Sets the center frequency of the dual-tone signal of the specified channel.
  • Page 89 RIGOL Chapter 2 Command System [:SOURce[<n>]]:FUNCtion:DUALTone:FREQ1 Syntax [:SOURce[<n>]]:FUNCtion:DUALTone:FREQ1 {<frequency>|MINimum|MAXimum} [:SOURce[<n>]]:FUNCtion:DUALTone:FREQ1? Description Sets Frequency 1 of the dual-tone signal of the specified channel. Queries Frequency 1 of the dual-tone signal of the specified channel. Parameter Name Type Range Default [<n>] Discrete <frequency>...
  • Page 90 RIGOL Chapter 2 Command System [:SOURce[<n>]]:FUNCtion:DUALTone:OFFSETFreq Syntax [:SOURce[<n>]]:FUNCtion:DUALTone:OFFSETFreq {<frequency>|MINimum|MAXimum} [:SOURce[<n>]]:FUNCtion:DUALTone:OFFSETFreq? Description Sets the offset frequency of the dual-tone signal of the specified channel. Queries the offset frequency of the dual-tone signal of the specified channel. Parameter Name Type Range Default [<n>]...
  • Page 91 RIGOL Chapter 2 Command System Example :SOUR1:FUNC:PRBS:BRAT 3000 /*Sets the PRBS bit rate of CH1 to 3 kbps.*/ :SOUR1:FUNC:PRBS:BRAT? /*Queries the PRBS bit rate of CH1 and the query returns 3.000000E+03.*/ [:SOURce[<n>]]:FUNCtion:PRBS:DATA Syntax [:SOURce[<n>]]:FUNCtion:PRBS:DATA {PN7|PN9|PN11} [:SOURce[<n>]]:FUNCtion:PRBS:DATA? Description Sets the PRBS data type of the specified channel.
  • Page 92 RIGOL Chapter 2 Command System ——pulse duty cycle; dcycle ——minimum pulse width; ——pulse period. pulse When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  Return Format The query returns the pulse duty cycle in scientific notation, with 7 effective digits. For example, 4.500000E+01 (the pulse duty cycle is 45%).
  • Page 93 RIGOL Chapter 2 Command System Parameter Name Type Range Default [<n>] Discrete <seconds> Real 10 ns to (0.625×pulse width) 20 ns Remarks The rise time is defined as the time required for the pulse amplitude to rise from 10% to 90%; the fall ...
  • Page 94 RIGOL Chapter 2 Command System Queries the pulse fall time of the specified channel. Parameter Name Type Range Default [<n>] Discrete <seconds> Real 10 ns to (0.625×pulse width) 20 ns Remarks The fall time is defined as the time required for the pulse amplitude to fall from 90% to 10%.
  • Page 95 RIGOL Chapter 2 Command System Example :SOUR1:FUNC:PULS:WIDT 0.01 /*Sets the pulse width of CH1 to 10 ms (i.g. 0.01 s).*/ :SOUR1:FUNC:PULS:WIDT? /*Queries the pulse width of CH1 and the query returns 1.000000E-02.*/ [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry Syntax [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry {<symmetry>|MINimum|MAXimum} [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry? [MINimum|MAXimum] Description Sets the Ramp symmetry of the specified channel.
  • Page 96 RIGOL Chapter 2 Command System Example :SOUR1:FUNC:RS232:BAUD 9600 /*Sets the RS232 baud rate of CH1 to 9600.*/ :SOUR1:FUNC:RS232:BAUD? /*Queries the RS232 baud rate of CH1 and the query returns 9600.*/ [:SOURce[<n>]]:FUNCtion:RS232:CHECKBit Syntax [:SOURce[<n>]]:FUNCtion:RS232:CHECKBit {NONE|ODD|EVEN} [:SOURce[<n>]]:FUNCtion:RS232:CHECKBit? Description Sets the RS232 check bit of the specified channel.
  • Page 97 RIGOL Chapter 2 Command System [:SOURce[<n>]]:FUNCtion:RS232:DATABit Syntax [:SOURce[<n>]]:FUNCtion:RS232:DATABit {7|8} [:SOURce[<n>]]:FUNCtion:RS232:DATABit? Description Sets the RS232 data bits of the specified channel. Queries the RS232 data bits of the specified channel. Parameter Name Type Range Default [<n>] Discrete {7|8} Discrete Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.
  • Page 98 RIGOL Chapter 2 Command System [:SOURce[<n>]]:FUNCtion:SEQuence:EDGETime Syntax [:SOURce[<n>]]:FUNCtion:SEQuence:EDGETime <seconds> [:SOURce[<n>]]:FUNCtion:SEQuence:EDGETime? Description Sets the edge time of the sequence waveform of the specified channel. Queries the edge time of the sequence waveform of the specified channel. Parameter Name Type Range Default [<n>]...
  • Page 99 RIGOL Chapter 2 Command System [:SOURce[<n>]]:FUNCtion:SEQuence:PERiod Syntax [:SOURce[<n>]]:FUNCtion:SEQuence:PERiod <num>|1|2|3|4|5|6|7|8 <value>|MINimum|MAXimum [:SOURce[<n>]]:FUNCtion:SEQuence:PERiod? {1|2|3|4|5|6|7|8} Description Sets the waveform period of the specified number in Sequence of the specified channel. Queries the waveform period of the specified number in Sequence of the specified channel.
  • Page 100 RIGOL Chapter 2 Command System [:SOURce[<n>]]:FUNCtion:SEQuence[:STATe] Syntax [:SOURce[<n>]]:FUNCtion:SEQuence[:STATe] {ON|1|OFF|0} [:SOURce[<n>]]:FUNCtion:SEQuence[:STATe]? Description Enables or disables the Sequence of the specified channel. Queries the on/off status of the Sequence of the specified channel. Parameter Name Type Range Default [<n>] Discrete {ON|1|OFF|0} Bool...
  • Page 101 RIGOL Chapter 2 Command System N|CWPUSLE|LFPULSE|LFMPULSE|EOG|EEG|EMG|PULSILOGRAM|TENS1|TENS2|TENS3|SURGE|DAMP EDOSC|SWINGOSC|RADAR|THREEAM|THREEFM|THREEPM|THREEPWM|THREEPFM|RESSPEED|MCN OSIE|PAHCUR|RIPPLE|ISO76372TP1|ISO76372TP2A|ISO76372TP2B|ISO76372TP3A|ISO76372TP3B |ISO76372TP4|ISO76372TP5A|ISO76372TP5B|ISO167502SP|ISO167502VR|SRC|IGNITION|NIMHDI SCHARGE|GATEVIBR. Return Format The query returns a string. For example, SQU. Example :SOUR1:FUNC:SEQ:WAVE 1,SQU /*Sets the waveform type of the number 1 in Sequence of CH1 to Square.*/ :SOUR1:FUNC:SEQ:WAVE? 1 /*Queries the waveform type of the number 1 in Sequence of CH1 and the query returns SQU.*/...
  • Page 102 RIGOL Chapter 2 Command System Example :SOUR1:FUNC SQU /*Sets the waveform type of CH1 to Square.*/ :SOUR1:FUNC? /*Queries the waveform type of CH1 and the query returns SQU.*/ [:SOURce[<n>]]:FUNCtion:SQUare:DCYCle Syntax [:SOURce[<n>]]:FUNCtion:SQUare:DCYCle {<percent>|MINimum|MAXimum} [:SOURce[<n>]]:FUNCtion:SQUare:DCYCle? [MINimum|MAXimum] Description Sets the Square duty cycle of the specified channel.

  • Page 103: Source:harmonic

    RIGOL Chapter 2 Command System Return Format The query returns the Square period in scientific notation, with 7 effective digits. For example, 1.000000E+00 (the Square period is 1 s). Example :SOUR1:FUNC:SQU:PER 1 /*Sets the Square period of CH1 to 1 s.*/ :SOUR1:FUNC:SQU:PER? /*Queries the Square period of CH1 and the query returns 1.000000E+00.*/...
  • Page 104 RIGOL Chapter 2 Command System [:SOURce[<n>]]:HARMonic:ORDEr Syntax [:SOURce[<n>]]:HARMonic:ORDEr {<value>|MINimum|MAXimum} [:SOURce[<n>]]:HARMonic:ORDEr? [MINimum|MAXimum] Description Sets the highest order of harmonic that can be output in the harmonic function of the specified channel. Queries the highest order of harmonic that can be outputted in the harmonic function of the specified channel.
  • Page 105 RIGOL Chapter 2 Command System Example :SOUR1:HARM:PHAS 5,10 /*Sets the phase of the fifth order of harmonic of CH1 to 10°.*/ :SOUR1:HARM:PHAS? 5 /*Queries the phase of the fifth order of harmonic of CH1 and the query returns 1.000000E+01.*/ [:SOURce[<n>]]:HARMonic[:STATe] Syntax [:SOURce[<n>]]:HARMonic[:STATe] {ON|1|OFF|0}...
  • Page 106 RIGOL Chapter 2 Command System All harmonic (ALL): the instrument outputs the fundamental waveform and all the orders of harmonics.  User-defined harmonic (USER): users can define the output orders of the harmonics, and the highest  order is 8.

  • Page 107: Source:marker

    RIGOL Chapter 2 Command System :SOURce:MARKer Command List: [:SOURce[<n>]]:MARKer:FREQuency  [:SOURce[<n>]]:MARKer[:STATe]  [:SOURce[<n>]]:MARKer:FREQuency Syntax [:SOURce[<n>]]:MARKer:FREQuency {<frequency>|MINimum|MAXimum} [:SOURce[<n>]]:MARKer:FREQuency? [MINimum|MAXimum] Description Sets the marker frequency of the specified channel. Queries the marker frequency of the specified channel. Parameter Name Type Range Default [<n>]...

  • Page 108: Source[:Mod]:Am

    RIGOL Chapter 2 Command System [:SOURce[<n>]]:MARKer[:STATe] Syntax [:SOURce[<n>]]:MARKer[:STATe] {ON|1|OFF|0} [:SOURce[<n>]]:MARKer[:STATe]? Description Enables or disables the frequency mark function of the specified channel. Queries the on/off status of the frequency mark function of the specified channel. Parameter Name Type Range Default [<n>]...
  • Page 109 RIGOL Chapter 2 Command System [:SOURce[<n>]][:MOD]:AM[:DEPTh] Syntax [:SOURce[<n>]][:MOD]:AM[:DEPTh] {<depth>|MINimum|MAXimum} [:SOURce[<n>]][:MOD]:AM[:DEPTh]? [MINimum|MAXimum] Description Sets the AM modulation depth of the specified channel. Queries the AM modulation depth of the specified channel. Parameter Name Type Range Default [<n>] Discrete <depth> Real 0% to 120%...
  • Page 110 RIGOL Chapter 2 Command System the carrier waveform components are suppressed on the basis of the normal amplitude modulation. At this time, the modulated waveforms all carry information. This method is called double sideband suppressed carrier modulation. When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.
  • Page 111 RIGOL Chapter 2 Command System [:SOURce[<n>]][:MOD]:AM:INTernal:FUNCtion Syntax [:SOURce[<n>]][:MOD]:AM:INTernal:FUNCtion {SINusoid|SQUare|TRIangle|RAMP|NRAMp|NOISe|USER} [:SOURce[<n>]][:MOD]:AM:INTernal:FUNCtion? Description Sets the AM modulation waveform of the specified channel. Queries the AM modulation waveform of the specified channel. Parameter Name Type Range Default [<n>] Discrete {SINusoid|SQUare|TRIangle|RAMP|NRA SINusoid|SQUare|TRIangle|RAM Discrete SINusoid...
  • Page 112 RIGOL Chapter 2 Command System Return Format The query returns INT or EXT. Example :SOUR1:AM:SOUR EXT /*Sets the AM modulation source of CH1 to external modulation source.*/ :SOUR1:AM:SOUR? /*Queries the AM modulation source of CH1 and the query returns EXT.*/ [:SOURce[<n>]][:MOD]:AM:STATe...

  • Page 113: Source[:Mod]:Askey

    RIGOL Chapter 2 Command System :SOURce[:MOD]:ASKey Command List: [:SOURce[<n>]][:MOD]:ASKey:AMPLitude  [:SOURce[<n>]][:MOD]:ASKey:INTernal[:RATE]  [:SOURce[<n>]][:MOD]:ASKey:POLarity  [:SOURce[<n>]][:MOD]:ASKey:SOURce  [:SOURce[<n>]][:MOD]:ASKey:STATe  [:SOURce[<n>]][:MOD]:ASKey:AMPLitude Syntax [:SOURce[<n>]][:MOD]:ASKey:AMPLitude {<amplitude>|MINimum|MAXimum} [:SOURce[<n>]][:MOD]:ASKey:AMPLitude? [MINimum|MAXimum] Description Sets the ASK modulation amplitude of the specified channel. Queries the ASK modulation amplitude of the specified channel.
  • Page 114 RIGOL Chapter 2 Command System Remarks This command is only applicable to the internal modulation source. The ASK modulation rate refers to  the frequency at which the output amplitude "shifts" between the carrier amplitude and modulation amplitude. When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.
  • Page 115 RIGOL Chapter 2 Command System [:SOURce[<n>]][:MOD]:ASKey:SOURce Syntax [:SOURce[<n>]][:MOD]:ASKey:SOURce {INTernal|EXTernal} [:SOURce[<n>]][:MOD]:ASKey:SOURce? Description Sets the ASK modulation source of the specified channel to internal (INTernal) or external (EXTernal) modulation source. Queries the ASK modulation source of the specified channel. Parameter Name Type...

  • Page 116: Source[:Mod]:Fm

    RIGOL Chapter 2 Command System modulated waveform. When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  If the sweep function ([:SOURce[<n>]]:SWEep:STATe) or burst function  ([:SOURce[<n>]]:BURSt[:STATe]) is currently enabled, it will be disabled automatically when the modulation function is enabled.
  • Page 117 RIGOL Chapter 2 Command System Mod/Trig/FSK] connector. Positive signal level corresponds to frequency increase, and negative signal level corresponds to frequency decrease. Lower signal levels produce less deviation. For example, if the frequency deviation is set to 1 kHz, +5 V signal level corresponds to a 1 kHz increase in frequency and -5 V signal level corresponds to a 1 kHz decrease in frequency.
  • Page 118 RIGOL Chapter 2 Command System [:SOURce[<n>]][:MOD]:FM:INTernal:FUNCtion Syntax [:SOURce[<n>]][:MOD]:FM:INTernal:FUNCtion {SINusoid|SQUare|TRIangle|RAMP|NRAMp|NOISe|USER} [:SOURce[<n>]][:MOD]:FM:INTernal:FUNCtion? Description Sets the FM modulation waveform of the specified channel. Queries the FM modulation waveform of the specified channel. Parameter Name Type Range Default [<n>] Discrete {SINusoid|SQUare|TRIangle|RAMP|NRA SINusoid|SQUare|TRIangle|RAM Discrete SINusoid...
  • Page 119 RIGOL Chapter 2 Command System When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  Return Format The query returns INT or EXT. Example :SOUR1:FM:SOUR EXT /*Sets the FM modulation source of CH1 to external modulation source.*/ :SOUR1:FM:SOUR? /*Queries the FM modulation source of CH1 and the query returns EXT.*/...

  • Page 120: Source[:Mod]:Fskey

    RIGOL Chapter 2 Command System :SOURce[:MOD]:FSKey Command List: [:SOURce[<n>]][:MOD]:FSKey[:FREQuency]  [:SOURce[<n>]][:MOD]:FSKey:INTernal:RATE  [:SOURce[<n>]][:MOD]:FSKey:POLarity  [:SOURce[<n>]][:MOD]:FSKey:SOURce  [:SOURce[<n>]][:MOD]:FSKey:STATe  [:SOURce[<n>]][:MOD]:FSKey[:FREQuency] Syntax [:SOURce[<n>]][:MOD]:FSKey[:FREQuency] {<frequency>|MINimum|MAXimum} [:SOURce[<n>]][:MOD]:FSKey[:FREQuency]? [MINimum|MAXimum] Description Sets the FSK hop frequency of the specified channel. Queries the FSK hop frequency of the specified channel.
  • Page 121 RIGOL Chapter 2 Command System Remarks This command is only applicable to the internal modulation source  ([:SOURce[<n>]][:MOD]:FSKey:SOURce). The FSK modulation rate refers to the frequency at which the output frequency "shifts" between the carrier frequency and the hop frequency ([:SOURce[<n>]][:MOD]:FSKey[:FREQuency]).
  • Page 122 RIGOL Chapter 2 Command System [:SOURce[<n>]][:MOD]:FSKey:SOURce Syntax [:SOURce[<n>]][:MOD]:FSKey:SOURce {INTernal|EXTernal} [:SOURce[<n>]][:MOD]:FSKey:SOURce? Description Sets the FSK modulation source of the specified channel to internal (INTernal) or external (EXTernal) modulation source. Queries the FSK modulation source of the specified channel. Parameter Name Type...

  • Page 123: Source[:Mod]:Pm

    RIGOL Chapter 2 Command System modulated waveform. When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  If the sweep function ([:SOURce[<n>]]:SWEep:STATe) or burst function  ([:SOURce[<n>]]:BURSt[:STATe]) is currently enabled, it will be disabled automatically when the modulation function is enabled.
  • Page 124 RIGOL Chapter 2 Command System Example :SOUR1:PM 50 /*Sets the PM phase deviation of CH1 to 50°.*/ :SOUR1:PM? /*Queries the PM phase deviation of CH1 and the query returns 5.000000E+01.*/ [:SOURce[<n>]][:MOD]:PM:INTernal:FREQuency Syntax [:SOURce[<n>]][:MOD]:PM:INTernal:FREQuency {<frequency>|MINimum|MAXimum} [:SOURce[<n>]][:MOD]:PM:INTernal:FREQuency? [MINimum|MAXimum] Description Sets the PM modulation frequency of the specified channel.
  • Page 125 RIGOL Chapter 2 Command System Return Format The query returns SIN, SQU, TRI, RAMP, NRAM, NOIS, or USER. Example :SOUR1:PM:INT:FUNC SQU /*Sets the PM modulation waveform of CH1 to Square.*/ :SOUR1:PM:INT:FUNC? /*Queries the PM modulation waveform of CH1 and the query returns SQU.*/ [:SOURce[<n>]][:MOD]:PM:SOURce...

  • Page 126: Source[:Mod]:Pskey

    RIGOL Chapter 2 Command System [:SOURce[<n>]][:MOD]:PM:STATe Syntax [:SOURce[<n>]][:MOD]:PM:STATe {ON|1|OFF|0} [:SOURce[<n>]][:MOD]:PM:STATe? Description Enables or disables the PM modulation function of the specified channel. Queries the on/off status of the PM modulation function of the specified channel. Parameter Name Type Range Default [<n>]...
  • Page 127 RIGOL Chapter 2 Command System [:SOURce[<n>]][:MOD]:PSKey:INTernal:RATE Syntax [:SOURce[<n>]][:MOD]:PSKey:INTernal:RATE {<rate>|MINimum|MAXimum} [:SOURce[<n>]][:MOD]:PSKey:INTernal:RATE? [MINimum|MAXimum] Description Sets the PSK modulation rate of the specified channel. Queries the PSK modulation rate of the specified channel. Parameter Name Type Range Default [<n>] Discrete <frequency> Real 2 mHz to 1 MHz...
  • Page 128 RIGOL Chapter 2 Command System Example :SOUR1:PSK:PHAS 90 /*Sets the PSK modulation phase of CH1 to 90°.*/ :SOUR1:PSK:PHAS? /*Queries the PSK modulation phase of CH1 and the query returns 9.000000E+01.*/ [:SOURce[<n>]][:MOD]:PSKey:POLarity Syntax [:SOURce[<n>]][:MOD]:PSKey:POLarity {POSitive|NEGative} [:SOURce[<n>]][:MOD]:PSKey:POLarity? Description Sets the PSK modulation polarity of the specified channel to Positive (POSitive) or Negative (NEGative).
  • Page 129 RIGOL Chapter 2 Command System Remarks DG800 can receive modulating waveform from the internal or external modulation source.  When the internal source is selected, the modulating waveform is set as a Square with 50% duty cycle.  At this time, the rate at which the output phase "shifts" between "carrier phase" and "modulating phase"...

  • Page 130: Source[:Mod]:Pwm

    RIGOL Chapter 2 Command System :SOURce[:MOD]:PWM Command List: [:SOURce[<n>]][:MOD]:PWM[:DEViation]:DCYCle  [:SOURce[<n>]][:MOD]:PWM[:DEViation][:WIDTh]  [:SOURce[<n>]][:MOD]:PWM:INTernal:FREQuency  [:SOURce[<n>]][:MOD]:PWM:INTernal:FUNCtion  [:SOURce[<n>]][:MOD]:PWM:SOURce  [:SOURce[<n>]][:MOD]:PWM:STATe  [:SOURce[<n>]][:MOD]:PWM[:DEViation]:DCYCle Syntax [:SOURce[<n>]][:MOD]:PWM[:DEViation]:DCYCle {<percent>|MINimum|MAXimum} [:SOURce[<n>]][:MOD]:PWM[:DEViation]:DCYCle? [MINimum|MAXimum] Description Sets the PWM duty cycle deviation of the specified channel. Queries the PWM duty cycle deviation of the specified channel.
  • Page 131 RIGOL Chapter 2 Command System [:SOURce[<n>]][:MOD]:PWM[:DEViation][:WIDTh] Syntax [:SOURce[<n>]][:MOD]:PWM[:DEViation][:WIDTh] {<deviation>|MINimum|MAXimum} [:SOURce[<n>]][:MOD]:PWM[:DEViation][:WIDTh]? [MINimum|MAXimum] Description Sets the PWM width deviation of the specified channel. Queries the PWM width deviation of the specified channel. Parameter Name Type Range Default [<n>] Discrete <deviation> Real Refer to "Remarks".
  • Page 132 RIGOL Chapter 2 Command System Return Format The query returns the PWM modulation frequency in scientific notation, with 7 effective digits. For example, 1.500000E+02 (the PWM modulation frequency is 150 Hz). Example :SOUR1:PWM:INT:FREQ 150 /*Sets the PWM modulation frequency of CH1 to 150 Hz.*/...
  • Page 133 RIGOL Chapter 2 Command System Parameter Name Type Range Default [<n>] Discrete {INTernal|EXTernal} Discrete INTernal|EXTernal INTernal Remarks DG800 can receive modulating waveform from the internal or external modulation source.  When the internal modulation source is selected, the modulation waveform can be SINusoid, SQUare, ...

  • Page 134: Source:mod

    RIGOL Chapter 2 Command System Example Assume that the current waveform of CH1 is pulse, :SOUR1:PWM:STAT ON /*Enables the PWM modulation function of CH1.*/ :SOUR1:PWM:STAT? /*Queries the on/off status of the PWM modulation function of CH1 and the query returns ON.*/...
  • Page 135 RIGOL Chapter 2 Command System [:SOURce[<n>]]:MOD:TYPe Syntax [:SOURce[<n>]]:MOD:TYPe {AM|FM|PM|ASK|FSK|PSK|PWM} [:SOURce[<n>]]:MOD:TYPe? Description Sets the modulation type of the specified channel. Queries the modulation type of the specified channel. Parameter Name Type Range Default [<n>] Discrete {AM|FM|PM|ASK|FSK|PSK|PWM} Discrete AM|FM|PM|ASK|FSK|PSK|PWM Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.

  • Page 136: Source:period

    The period and frequency are the reciprocal of each other. For the frequency ranges of different  models and different waveforms of DG800 series, refer to Table 2-1. If the period in the command is smaller than the corresponding period lower limit, the system sets the ...

  • Page 137: Source:phase

    [<n>] Discrete Remarks DG800 series dual-channel function/arbitrary waveform generator enables you to align the phases of  the two channels. When you perform the "align phase" operation, the instrument will re-configure the two channels to output according to the preset frequency and phase.

  • Page 138: Source:pulse

    RIGOL Chapter 2 Command System When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  Example :SOUR1:PHAS:INIT /*Executes an align phase operation on CH1.*/ :SOUR2:PHAS:SYNC /*Executes an align phase operation on CH2.*/ :SOURce:PULSe Command List: [:SOURce[<n>]]:PULSe:DCYCle...
  • Page 139 RIGOL Chapter 2 Command System [:SOURce[<n>]]:PULSe:TRANsition[:LEADing] Syntax [:SOURce[<n>]]:PULSe:TRANsition[:LEADing] {<seconds>|MINimum|MAXimum} [:SOURce[<n>]]:PULSe:TRANsition[:LEADing]? [MINimum|MAXimum] Description Sets the pulse rise time of the specified channel. Queries the pulse rise time of the specified channel. Parameter Name Type Range Default [<n>] Discrete <seconds> Real 8 ns to (0.625×pulse width)

  • Page 140: Source:sum

    RIGOL Chapter 2 Command System Example :SOUR1:PULS:TRAN:TRA 0.000000035 /*Sets the pulse fall time of CH1 to 35 ns.*/ :SOUR1:PULS:TRAN:TRA? /*Queries the pulse fall time of CH1 and the query returns 3.500000E-08.*/ [:SOURce[<n>]]:PULSe:WIDTh Syntax [:SOURce[<n>]]:PULSe:WIDTh {<seconds>|MINimum|MAXimum} [:SOURce[<n>]]:PULSe:WIDTh? [MINimum|MAXimum] Description Sets the pulse width of the specified channel.
  • Page 141 RIGOL Chapter 2 Command System [:SOURce[<n>]]:SUM:AMPLitude Syntax [:SOURce[<n>]]:SUM:AMPLitude {<amplitude>|MINimum|MAXimum} [:SOURce[<n>]]:SUM:AMPLitude? [MINimum|MAXimum] Description Sets the sum ratio of the waveform combine function of the specified channel. Queries the sum ratio of the waveform combine function of the specified channel. Parameter Name...
  • Page 142 RIGOL Chapter 2 Command System [:SOURce[<n>]]:SUM:INTernal:FUNCtion Syntax [:SOURce[<n>]]:SUM:INTernal:FUNCtion {SIN|SQU|RAMP|NOISe|ARB} [:SOURce[<n>]]:SUM:INTernal:FUNCtion? Description Sets the sum source of the waveform combine function of the specified channel. Queries the sum source of the waveform combine function of the specified channel. Parameter Name Type...

  • Page 143: Source:sweep

    RIGOL Chapter 2 Command System :SOURce:SWEep Command List: [:SOURce[<n>]]:SWEep:HTIMe:STARt  [:SOURce[<n>]]:SWEep:HTIMe[:STOP]  [:SOURce[<n>]]:SWEep:RTIMe  [:SOURce[<n>]]:SWEep:SPACing  [:SOURce[<n>]]:SWEep:STATe  [:SOURce[<n>]]:SWEep:STEP  [:SOURce[<n>]]:SWEep:TIME  [:SOURce[<n>]]:SWEep:TRIGger[:IMMediate]  [:SOURce[<n>]]:SWEep:TRIGger:SLOPe  [:SOURce[<n>]]:SWEep:TRIGger:SOURce  [:SOURce[<n>]]:SWEep:HTIMe:STARt Syntax [:SOURce[<n>]]:SWEep:HTIMe:STARt {<seconds>|MINimum|MAXimum} [:SOURce[<n>]]:SWEep:HTIMe:STARt? [MINimum|MAXimum] Description Sets the start hold time of the sweep function of the specified channel.
  • Page 144 RIGOL Chapter 2 Command System [:SOURce[<n>]]:SWEep:HTIMe[:STOP] Syntax [:SOURce[<n>]]:SWEep:HTIMe[:STOP] {<seconds>|MINimum|MAXimum} [:SOURce[<n>]]:SWEep:HTIMe[:STOP]? [MINimum|MAXimum] Description Sets the stop hold time of the sweep function of the specified channel. Queries the stop hold time of the sweep function of the specified channel. Parameter Name...
  • Page 145 RIGOL Chapter 2 Command System Return Format The query returns the return time in scientific notation, with 7 effective digits. For example, 1.000000E+00 (the return time is 1 s). Example :SOUR1:SWE:RTIM 1 /*Sets the return time of the sweep function of CH1 to 1 s.*/...
  • Page 146 RIGOL Chapter 2 Command System [:SOURce[<n>]]:SWEep:STATe Syntax [:SOURce[<n>]]:SWEep:STATe {ON|1|OFF|0} [:SOURce[<n>]]:SWEep:STATe? Description Enables or disables the sweep function of the specified channel. Queries the on/off status of the sweep function of the specified channel. Parameter Name Type Range Default [<n>] Discrete...
  • Page 147 RIGOL Chapter 2 Command System stop frequency ([:SOURce[<n>]]:FREQuency:STOP). It is only available in step sweep ([:SOURce[<n>]]:SWEep:SPACing). When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  Return Format The query returns the number of steps in scientific notation, with 7 effective digits. For example, 5.000000E+00 (the number of steps is 5).
  • Page 148 RIGOL Chapter 2 Command System [:SOURce[<n>]]:SWEep:TRIGger[:IMMediate] Syntax [:SOURce[<n>]]:SWEep:TRIGger[:IMMediate] Description Triggers a sweep immediately on the specified channel. Parameter Name Type Range Default [<n>] Discrete Remarks This command is only applicable to manual trigger ([:SOURce[<n>]]:SWEep:TRIGger:SOURce) and is  only valid when the output of the corresponding channel (:OUTPut[<n>][:STATe]) is enabled.
  • Page 149 RIGOL Chapter 2 Command System [:SOURce[<n>]]:SWEep:TRIGger:SOURce Syntax [:SOURce[<n>]]:SWEep:TRIGger:SOURce {INTernal|EXTernal|MANual} [:SOURce[<n>]]:SWEep:TRIGger:SOURce? Description Sets the sweep trigger source of the specified channel to Internal (INTernal), External (EXTernal), or Manual (MANual). Queries the trigger source of the sweep of the specified channel. Parameter...

  • Page 150: Source:trace

    RIGOL Chapter 2 Command System :SOURce:TRACe Command List: [:SOURce[<n>]][:TRACe]:DATA:DAC16  [:SOURce[<n>]][:TRACe]:DATA:DAC16 Syntax [:SOURce[<n>]][:TRACe]:DATA:DAC16 VOLATILE,<flag>,<data> Description Downloads waveform table to the DDRIII internal memory. Parameter Name Type Range Default [<n>] Discrete <flag> Refer to "Remarks". ASCII String None <data> Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.

  • Page 151: Source:track

    RIGOL Chapter 2 Command System :SOURce:TRACK Command List: [:SOURce[<n>]]:TRACK  [:SOURce[<n>]]:TRACK Syntax [:SOURce[<n>]]:TRACK {ON|OFF|INVerted} [:SOURce[<n>]]:TRACK? Description Sets the state of the track function of the specified channel to ON, OFF, or INVerted. Queries the state of the track function of the specified channel.
  • Page 152 RIGOL Chapter 2 Command System [:SOURce[<n>]]:VOLTage:COUPle[:STATe] Syntax [:SOURce[<n>]]:VOLTage:COUPle[:STATe] {ON|1|OFF|0} [:SOURce[<n>]]:VOLTage:COUPle[:STATe]? Description Enables or disables the amplitude coupling function. Queries the on/off status of the amplitude coupling function. Parameter Name Type Range Default [<n>] Discrete {ON|1|OFF|0} Bool ON|1|OFF|0 Remarks After the amplitude coupling function is enabled, CH1 and CH2 take each other as the reference source.
  • Page 153 RIGOL Chapter 2 Command System use this amplitude; otherwise, the instrument would display a prompt message and set the amplitude to the amplitude upper limit of the new configuration automatically. You can also use "High Level" or "Low Level" to set the amplitude and offset.
  • Page 154 RIGOL Chapter 2 Command System Parameter Name Type Range Default [<n>] Discrete Refer to "Remarks". <voltage> Real -2.5 Vpp Remarks When [:SOURce[<n>]] or [<n>] is omitted, the system sets the related parameters of CH1 by default.  You can also use the "Amplitude" ([:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]) and ...
  • Page 155 RIGOL Chapter 2 Command System [:SOURce[<n>]]:VOLTage:UNIT Syntax [:SOURce[<n>]]:VOLTage:UNIT {VPP|VRMS|DBM} [:SOURce[<n>]]:VOLTage:UNIT? Description Sets the amplitude unit of the specified channel to Vpp (VPP), Vrms (VRMS), or dBm (DBM). Queries the amplitude unit of the specified channel. Parameter Name Type Range Default [<n>]...

  • Page 156: System Commands

    RIGOL Chapter 2 Command System :SYSTem Commands The :SYSTem commands are used to set the beeper state, query the number of channels of the instrument and the current channel, set the various interface (GPIB, LAN, and USB) parameters and states, execute the channel copy operation, query the error queue, lock the front panel, set the system language and power-on status, set the clock source as well as query the system version.
  • Page 157 RIGOL Chapter 2 Command System :SYSTem:BEEPer[:IMMediate] Syntax :SYSTem:BEEPer[:IMMediate] Description The beeper sounds immediately. Remarks The current on/off status of the beeper is ignored by this command. The beeper will sound immediately when you send this command, even if the beeper is currently disabled.
  • Page 158 RIGOL Chapter 2 Command System Example :SYST:CHAN:CUR CH2 /*Selects CH2 as the current channel.*/ :SYST:CHAN:CUR? /*Queries the current channel and the query returns CH2.*/ :SYSTem:CHANnel:NUMber? Syntax :SYSTem:CHANnel:NUMber? Description Queries the number of the output channels of the instrument. Return Format The query returns an integer.
  • Page 159 RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN:APPLy Syntax :SYSTem:COMMunicate:LAN:APPLy Description Applies the currently set network parameters. Remarks After setting the LAN parameters, the new settings will only take effect when this command is executed. :SYSTem:COMMunicate:LAN:AUTOip[:STATe] Syntax :SYSTem:COMMunicate:LAN:AUTOip[:STATe] {ON|1|OFF|0} :SYSTem:COMMunicate:LAN:AUTOip[:STATe]? Description Enables or disables the AutoIP configuration mode.
  • Page 160 RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN:CONTrol? Syntax :SYSTem:COMMunicate:LAN:CONTrol? Description Reads the port number of the initial control connecting port for socket communication. Return Format The query returns 5555. If the interface does not support the socket, the query returns 0.
  • Page 161 RIGOL Chapter 2 Command System Parameter Name Type Range Default Refer to "Remarks". <address> ASCII String None Remarks This command is only valid when the ManualIP configuration mode  (:SYSTem:COMMunicate:LAN:STATic[:STATe]) is enabled. The format of <address> is "nnn.nnn.nnn.nnn". The range for the first segment (nnn) of the address ...
  • Page 162 RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN:IPADdress Syntax :SYSTem:COMMunicate:LAN:IPADdress <ip_address> :SYSTem:COMMunicate:LAN:IPADdress? Description Sets the IP address. Queries the IP address. Parameter Name Type Range Default <ip_address> ASCII String Refer to "Remarks". None Remarks This command is only valid when the ManualIP configuration mode ...
  • Page 163 RIGOL Chapter 2 Command System Return Format The query returns a string. For example, 255.255.255.0. Example :SYST:COMM:LAN:SMAS 255.255.255.0 /*Sets the subnet mask to 255.255.255.0.*/ :SYST:COMM:LAN:SMAS? /*Queries the subnet mask and the query returns 255.255.255.0.*/ :SYSTem:COMMunicate:LAN:STATic[:STATe] Syntax :SYSTem:COMMunicate:LAN:STATic[:STATe] {ON|1|OFF|0} :SYSTem:COMMunicate:LAN:STATic[:STATe]? Description Enables or disables the manual IP configuration mode.
  • Page 164 RIGOL Chapter 2 Command System :SYSTem:CSCopy Syntax :SYSTem:CSCopy <name>,<name> Description Copies all parameters and states (except the channel output state) and arbitrary waveform data of one channel to the other one. Parameter Name Type Range Default <name> Discrete CH1|CH2 None Remarks The two parameters <name>...
  • Page 165 RIGOL Chapter 2 Command System Parameter Name Type Range Default <key> Discrete Refer to "Remarks". None {ON|1|OFF|0} Bool ON|1|OFF|0 Remarks The parameter <key> indicates a specified key, and its range is as follows:  HOME|MENU|PRESET|STORE|UTILITY|HELP| /*Function keys*/ LOCK|TRIG| LEFT|RIGHT|KNOB| /*Direction keys and knob*/...
  • Page 166 RIGOL Chapter 2 Command System :SYSTem:LOG:[:STATE] Syntax :SYSTem:LOG:[:STATE] {ON|1|OFF|0} :SYSTem:LOG:[:STATE]? Description Enables or disables the system log. Queries the on/off status of the system log. Parameter Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 Return Format The query returns ON or OFF.
  • Page 167 RIGOL Chapter 2 Command System :SYSTem:PRESet:DELete Syntax :SYSTem:PRESet:DELete {USER1|USER2|USER3|USER4|USER5|USER6|USER7|USER8|USER9|USER10} Description Deletes the specified user-stored state file (USER1 to USER10) in the internal memory of the instrument. Parameter Name Type Range Default {USER1|USER2|USER3|USER4| USER1|USER2|USER3|USER4| USER5|USER6|USER7|USER8| Discrete USER5|USER6|USER7|USER8| None USER9|USER10} USER9|USER10 Remarks USER1 to USER10 denotes the files stored in the state file storage locations 1 to 10 in the internal memory of the instrument respectively.
  • Page 168 RIGOL Chapter 2 Command System :SYSTem:PRESet:SAVe Syntax :SYSTem:PRESet:SAVe {USER1|USER2|USER3|USER4|USER5|USER6|USER7|USER8|USER9|USER10} Description Saves the current system status to the specified user storage location (USER1 to USER10) in the internal memory of the instrument. Parameter Name Type Range Default {USER1|USER2|USER3|USER4| USER1|USER2|USER3|USER4| USER5|USER6|USER7|USER8| Discrete...
  • Page 169 RIGOL Chapter 2 Command System Connect the [10MHz In/Out] connector of Generator A ("Internal" clock) to the [10MHz In/Out] connector of Generator B ("External" clock) and set the output frequencies of A and B to a same value to realize synchronization between two instruments.

  • Page 170: Trigger Commands

    RIGOL Chapter 2 Command System :TRIGger Commands The :TRIGger commands are used to set the trigger source type, trigger input edge type and trigger delay as well as generate a trigger event. Command List: :TRIGger[<n>]:DELay  :TRIGger[<n>][:IMMediate]  :TRIGger[<n>]:SLOPe ...
  • Page 171 RIGOL Chapter 2 Command System :TRIGger[<n>][:IMMediate] Syntax :TRIGger[<n>] [:IMMediate] Description Generates a trigger on the specified channel. Parameter Name Type Range Default [<n>] Discrete Remarks This command is only applicable to the burst output ([:SOURce[<n>]]:BURSt[:STATe]) or sweep  output ([:SOURce[<n>]]:SWEep:STATe) in manual trigger (:TRIGger[<n>]:SOURce).
  • Page 172 RIGOL Chapter 2 Command System :TRIGger[<n>]:SOURce Syntax :TRIGger[<n>]:SOURce {INTernal|EXTernal|BUS} :TRIGger[<n>]:SOURce? Description Sets the trigger source of the specified channel to Internal (INTernal), External (EXTernal), or Manual (BUS). Queries the trigger source of the specified channel. Parameter Name Type Range Default [<n>]...

  • Page 173: Chapter 3 Application Instances

    RIGOL Chapter 3 Application Instances Chapter 3 Application Instances This chapter provides the application instances of the SCPI commands. The main functions of the signal generator can be realized through a series of SCPI commands. Note: The instances in this chapter take DG832 as an example. The range of certain parameters for other models may be different.

  • Page 174: To Output Basic Waveforms

    RIGOL Chapter 3 Application Instances To Output Basic Waveforms Requirement Use the SCPI commands to realize the following functions: This section mainly introduces how to output Sine waveforms (frequency 500 Hz, amplitude 2.5 Vpp, offset , start phase 90°) from the front-panel [CH1] output connector.

  • Page 175: To Output Harmonic

    RIGOL Chapter 3 Application Instances To Output Harmonic Requirement Use the SCPI commands to realize the following functions: Output harmonic waveform from the front panel output connector of CH1; the fundamental waveform (Sine) parameters are 1 kHz frequency, 5 Vpp amplitude, 0 Vdc offset voltage, and 0° start phase; set the highest order of harmonic to 4, the harmonic type to even, the amplitude and phase of the second order of harmonic to 2 Vpp and 30°, the amplitude and phase of the fourth order of harmonic to 1 Vpp and 50°.

  • Page 176: To Output Fsk Modulated Waveform

    RIGOL Chapter 3 Application Instances To Output FSK Modulated Waveform Requirement Use the SCPI commands to realize the following functions: Output FSK modulated waveform from the front-panel output connector of CH1; set the carrier waveform to Sine (1 kHz frequency, 5 Vpp amplitude, 0 Vdc offset voltage, and 0° start phase); select external modulation source;...

  • Page 177: To Output Burst Waveform

    RIGOL Chapter 3 Application Instances :SOUR1:SWE:TRIG:TRIGO POS /*Sets the edge type of the trigger output signal of CH1 to Rising edge.*/ :OUTP1 ON /*Enables the output of CH1.*/ :SOUR1:SWE:TRIG /*Triggers a sweep immediately on the specified channel.*/ To Output Burst Waveform...
  • Page 178 RIGOL Chapter 3 Application Instances :COUN:SENS HIG /*Sets the trigger sensitivity of the frequency counter to High.*/ :COUN:LEVE 0.1 /*Sets the trigger level of the frequency counter to 0.1 V.*/ :COUN:COUP AC /*Sets the coupling mode of the input signal to AC.*/...

  • Page 179: Chapter 4 Programming Examples

    RIGOL Chapter 4 Programming Examples Chapter 4 Programming Examples This chapter illustrates how to program the signal generator with SCPI commands based on NI-VISA in Excel, Matlab, LabVIEW, Visual Basic, and Visual C++. NI-VISA (National Instrument-Virtual Instrument Software Architecture), developed by NI (National Instrument), provides an advanced programming interface to communicate with various instruments through their bus lines.

  • Page 180: Programming Preparations

    Before programming, you need to prepare the following tasks: Install Ultra Sigma (PC) software. You can log in to the RIGOL official website (www.rigol.com) to download the software. Then install the software according to the installation wizard. After Ultra Sigma is installed successfully, NI-VISA library will be completely installed automatically.

  • Page 181: Excel Programming Examples

    RIGOL Chapter 4 Programming Examples Excel Programming Examples Program used in this instance: Microsoft Excel 2007 Function realized in this example: send the *IDN? command and read the instrument information. Create a new Excel file that enables the Macros and name it "DG800_Demo_Excel.xlsm".
  • Page 182 RIGOL Chapter 4 Programming Examples Remarks: If you cannot find VISA Library in the left section of the above dialog box, please follow the method below to find it. (1) Make sure that your PC has installed the NI-VISA library.
  • Page 183 RIGOL Chapter 4 Programming Examples Add the button control. Click Insert under the Developer menu, and select a button control under the Form Controls menu item and put it into the Excel cell. At this time, the Assign Macro dialog box is displayed, select "Sheet1.QueryIdn"...

  • Page 184: Matlab Programming Example

    RIGOL Chapter 4 Programming Examples Matlab Programming Example Program used in this example: MATLAB R2009a Function realized in this example: query the current waveform type as well as the waveform frequency, amplitude, offset, and phase of CH1. Run the Matlab software and modify the current path (Current Directory). In this example, modify the current path to E:\DG800_Demo_Matlab.
  • Page 185 RIGOL Chapter 4 Programming Examples DG800 Programming Guide...

  • Page 186: Labview Programming Example

    RIGOL Chapter 4 Programming Examples LabVIEW Programming Example Program used in this example: LabVIEW 2009 Function realized in this example: search for the instrument address, connect to the instrument, send and read commands. Run LabVIEW 2009, and then create a VI file named DG800_Demo_LABVIEW.
  • Page 187 RIGOL Chapter 4 Programming Examples Add the events (including connecting to the instrument, write operation, read operation, and exit) (1) Connect (including error correction advice): DG800 Programming Guide...
  • Page 188 RIGOL Chapter 4 Programming Examples 4-10 DG800 Programming Guide...
  • Page 189 RIGOL Chapter 4 Programming Examples (2) Write operation (including error confirmation): DG800 Programming Guide 4-11...
  • Page 190 RIGOL Chapter 4 Programming Examples (3) Read operation (including error processing): 4-12 DG800 Programming Guide...
  • Page 191 RIGOL Chapter 4 Programming Examples (4) Exit: Run the program, and then the following interface is displayed below. Click the VISA resource name from the drop-down list under Address, and click Connect to connect the instrument. Then, input DG800 Programming Guide...
  • Page 192 RIGOL Chapter 4 Programming Examples *IDN? in the Command field. Click Write to write the command to the instrument. If it is a query command, click Read, and then the query result will be displayed in the Return field. 4-14...

  • Page 193: Visual Basic Programming Example

    RIGOL Chapter 4 Programming Examples Visual Basic Programming Example Program used in this example: Visual Basic 6.0 Function realized in this example: enable the two channels of the signal generator and show the corresponding colors of the channels. Run Visual Basic 6.0, and build a standard application program project (Standard EXE), and name it "DG800_Demo_VB".
  • Page 194 RIGOL Chapter 4 Programming Examples Double-click CH1 to enter the programming environment. Add the following codes to control CH1 and CH2. The codes of CH1 are as shown below; the codes of CH2 are similar. Dim defrm As Long Dim vi As Long...
  • Page 195 RIGOL Chapter 4 Programming Examples ' Close the resource Call viClose(vi) Call viClose(defrm) Run and view the results, as shown in the figure below. Click the CH1 button to enable CH1, and the label above CH1 turns red; Click the CH2 button to enable CH2, and the label above CH2 turns blue;...

  • Page 196: Visual C++ Programming Example

    RIGOL Chapter 4 Programming Examples Visual C++ Programming Example Program used in this example: Microsoft Visual C++ 6.0 Function realized in this example: search for the instrument address, connect to the instrument, send and read commands. Run Microsoft Visual C++ 6.0. Create a MFC project based on a dialog box and name it "DG800_Demo_VC".
  • Page 197 RIGOL Chapter 4 Programming Examples Click ToolsOptions. Add the Include and Lib paths in the Directories tab in the pop-up interface. Note: The two paths added here are related to the installation path of NI-VISA on your PC. By default, NI-VISA is installed under C:\Program Files\IVI Foundation\VISA.
  • Page 198 RIGOL Chapter 4 Programming Examples Select Library files from the drop-down list under Show directories for. Double click the empty space under Directories to enter the specified path of Library files: C:\Program Files\IVI Foundation\VISA\WinNT\lib\msc. Click OK to close the dialog box.
  • Page 199 RIGOL Chapter 4 Programming Examples Click ViewClassWizard and add the control variables in the Member Variables tab in the pop-up interface. Instrument address: CString m_strInstrAddr Command CString m_strCommand Returned value CString m_strResult Encapsulate the read and write operations of VISA.
  • Page 200 RIGOL Chapter 4 Programming Examples return false; status = viOpen(defaultRM, SendAddr, VI_NULL, VI_NULL, &instr); //write command to the instrument status = viWrite(instr, (unsigned char *)SendBuf, strlen(SendBuf), &retCount); //close the instrument status = viClose(instr); status = viClose(defaultRM); return bWriteOK; Encapsulate the read operation of VISA for easier operation.
  • Page 201 RIGOL Chapter 4 Programming Examples Connect to the instrument void CDG800_Demo_VCDlg::OnConnect() // TODO: Add your control notification handler code here ViStatus status; ViSession defaultRM; ViString expr = "?*"; ViPFindList findList = new unsigned long; ViPUInt32 retcnt = new unsigned long;...
  • Page 202 RIGOL Chapter 4 Programming Examples // TODO: Add your control notification handler code here UpdateData(true); if (m_strInstrAddr.IsEmpty()) MessageBox("Please connect to the instrument first!"); InstrWrite(m_strInstrAddr,m_strCommand); m_strResult.Empty(); UpdateData(false); Read Operation void CDG800_Demo_VCDlg::OnRead() // TODO: Add your control notification handler code here UpdateData(true);...
  • Page 203 RIGOL Chapter 4 Programming Examples DG800 Programming Guide 4-25...

  • Page 205: Chapter 5 Appendix

    RIGOL Chapter 5 Appendix Chapter 5 Appendix Appendix A: Factory Setting The factory settings are as shown in the table below. Note that the item with "*" is the factory default value, and its value is related to the user setting during its usage but not affected by the reset operation.
  • Page 206 RIGOL Chapter 5 Appendix Harmonic Amplitude (7) 1.2647 Vpp User X0000000 DC Offset Built-in Arbitrary Waveforms Sinc Advanced Waveform Amplitude 5 Vpp Offset PRBS Bit Rate 2 kbps PRBS Data PRBS7 RS232 Baud Rate 9600 RS232 Data Bits RS232 Stop Bits...
  • Page 207 RIGOL Chapter 5 Appendix Width Deviation 200 μs Duty Deviation Sweep Sweep Time Return Time 0 ms Start Freq 100 Hz Stop Freq 1 kHz Center Frequency 550 Hz Frequency Span 900 Hz Start Hold Time 0 ms Stop Hold Time...
  • Page 208 RIGOL Chapter 5 Appendix Screen Saver Brightness* 100% Print Setting Location USB Storage Device Format* Interface GPIB* DHCP* On (default setting in LAN) Auto IP* On (default setting in LAN) Manual IP* Off (default setting in LAN) DG800 Programming Guide...

  • Page 209: Appendix B: Warranty

    There is no other warranty, expressed or implied, except such as is expressly set forth herein or other applicable warranty card. There is no implied warranty of merchantability or fitness for a particular purpose. Under no circumstances shall RIGOL be liable for any consequential, indirect, ensuing, or special damages for any breach of warranty in any case.

This manual is also suitable for:

Dg812Dg822Dg832Dg811Dg821Dg831

Table of Contents