Programming Guide DG2000 Series Function/Arbitrary Waveform Generator Aug. 2019 RIGOL (SUZHOU) TECHNOLOGIES INC.
RIGOL Guaranty and Declaration Copyright © 2019 RIGOL (SUZHOU) TECHNOLOGIES INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC. Publication Number PGB12100-1110 Software Version 00.02.01 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.
RIGOL Document Overview This manual introduces how to program the signal generator over the remote interfaces in details. Main Topics in this Manual: 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.
Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 Programming Overview......................................................................................1-1 Build Remote Communication .......................................................................
RIGOL Contents Chapter 4 Programming Examples .................................................................................... 4-1 Programming Preparations ............................................................................................................ 4-2 Excel Programming Examples ........................................................................................................ 4-3 Matlab Programming Example ..........................................................................
Chapter 1 Programming Overview RIGOL 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.
RIGOL Chapter 1 Programming Overview Build Remote Communication You can build the remote communication between DG2000 and the PC via the USB (USB DEVICE), LAN, or GPIB interface (extended from the USB HOST interface by using the USB-GPIB interface converter). Operation Procedures: 1. Install Ultra Sigma (PC) software Download the Ultra Sigma common PC software from www.rigol.com and install it according to the instructions. 2.
Chapter 1 Programming Overview RIGOL to check whether the connection is successful, as shown in the figure below (the USB interface is taken as an example).
RIGOL Chapter 1 Programming Overview Remote Control Method 1. User-defined programming You can use the SCPI (Standard Commands for Programmable Instruments) commands listed in Chapter 2 "Command System" of this manual to program and control the instrument in various development environments (e.g. Visual C++, Visual Basic, and LabVIEW). For details, refer to descriptions in Chapter 4 "Programming Examples". 2.
Chapter 1 Programming Overview RIGOL 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. 1. Braces { } The contents enclosed in the braces can contain multiple parameter options; and the vertical bar is used to separate multiple parameter options. When sending the command, you must select one of the parameters.
RIGOL Chapter 1 Programming Overview For example, MINimum and MAXimum in the :DISPlay: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. For abbreviations, you must enter all the uppercase letters that exist in the command syntax.
RIGOL Chapter 2 Command System Chapter 2 Command System This chapter introduces the syntax, function, parameters, and usages of each DG2000 command in A-Z order. Contents in this chapter: :COUNter Commands :COUPling Commands :DISPlay Commands :HCOPy Commands IEEE488.
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.
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. :COUNter:COUPling Syntax :COUNter:COUPling {AC|DC} :COUNter:COUPling? Description Sets the coupling mode of the input signal to AC or DC. Queries the coupling mode of the input signal.
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.
RIGOL Chapter 2 Command System Parameter Name Type Real Range -2.5 V to 2.5 V Default 0V Remarks The frequency counter starts measuring when the input signal reaches the specified trigger level. The minimum resolution is 6 mV. Return Format The query returns the trigger level in scientific notation. The returned value contains 7 effective digits, for example, 1.500000E+00 (the trigger level is 1.5 V). Example :COUN:LEVE 1.
RIGOL Parameter Chapter 2 Command System Name {LOW|HIGh} Type Real Range LOW|HIGh Default LOW 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. Return Format The query returns LOW or HIG. Example :COUN:SENS LOW /*Sets the trigger sensitivity of the frequency counter to LOW.
RIGOL Chapter 2 Command System :COUN? :COUN 1 :COUN? :COUN STOP :COUN? /*Queries the status of the frequency counter and the query returns OFF.*/ /*Enables the frequency counter function.*/ /*Queries the status of the frequency counter and the query returns RUN (the default operating status).*/ /*Sets the operating status of the frequency counter to "STOP".*/ /*Queries the status of the frequency counter and the query returns STOP.
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.
RIGOL Chapter 2 Command System :COUPling[]:AMPL:DEViation Syntax :COUPling[]:AMPL:DEViation :COUPling[]: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 Discrete Real Range 1|2 -19.998 Vpp to 19.
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 ACH2=ACH1*ARatio (the reference source is CH1); ACH1=ACH2/ARatio (the reference source is CH2). Wherein, ACH1 is the amplitude of CH1, ACH2 is the amplitude of CH2, and ARatio is the set amplitude ratio.
RIGOL Chapter 2 Command System :COUPling[]:AMPL[:STATe] Syntax :COUPling[]:AMPL[:STATe] {ON|1|OFF|0} :COUPling[]: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 [] {ON|1|OFF|0} Type Discrete Bool Range 1|2 ON|1|OFF|0 Default 1 OFF Remarks When [] is omitted, the commands set and query the related parameters of CH1 by default.
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.
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[]:FREQuency:RATio Syntax :COUPling[]:FREQuency:RATio {|MINimum|MAXimum} :COUPling[]:FREQuency:RATio? Description Sets the frequency ratio in the frequency coupling of the specified channel.
RIGOL Parameter Name [] {ON|1|OFF|0} Chapter 2 Command System Type Discrete Bool Range 1|2 ON|1|OFF|0 Default 1 OFF Remarks When [] 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 frequency ratio when the frequency coupling function is disabled. After the frequency coupling function is enabled, CH1 and CH2 take each other as the reference source.
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 :COUP1:PHAS:DEV? /*Sets the phase deviation in the phase coupling of CH1 to 90°.*/ /*Queries the phase deviation in the phase coupling of CH1 and the query returns 9.000000E+01.
RIGOL Chapter 2 Command System :COUPling[]:PHASe:RATio Syntax :COUPling[]:PHASe:RATio {|MINimum|MAXimum} :COUPling[]: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 Discrete Real Range 1|2 0.01 to 100 Default 1 1 Remarks When [] is omitted, the commands set and query the related parameters of CH1 by default.
RIGOL Chapter 2 Command System phase deviation (:COUPling[]:PHASe:DEViation) or phase ratio (:COUPling[]: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 when the phase coupling function is disabled. Return Format The query returns ON or OFF.
RIGOL Chapter 2 Command System :COUPling[]:TRIgger[:STATe] Syntax :COUPling[]:TRIgger [:STATe] {ON|1|OFF|0} :COUPling[]: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.
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] :DISPlay:BRIGhtness Syntax :DISPlay:BRIGhtness {|MINimum|MAXimum} :DISPlay:BRIGhtness? [MINimum|MAXimum] Description Sets the screen brightness. Queries the screen brightness.
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.
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). Return Format The query returns a definite-length binary data block that contains the image. The block starts with #.
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? *IDN? *OPC *PSC *RCL *RST *SAV *SRE *STB? *TRG *WAI *CLS Syntax *CLS Description Clears the event registers in all the register sets and clears the error queue.
Chapter 2 Command System RIGOL If you have configured the instrument by using the *PSC 1 command, the enable register of the standard event register will be cleared at the next power-on of the instrument. If you have configured the instrument by using the *PSC 0 command, the enable register of the standard event register will not be cleared at the next power-on of the instrument.
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 the system to output a signal when finishing the sweep or burst. The *OPC command sets the OPC (operation complete) bit in the standard event register to 1 after all the previous commands that have been sent are executed.
RIGOL Chapter 2 Command System *RCL Syntax *RCL {0|1|2|3|4|5} Description Recalls the state file stored in the specified location of the internal non-volatile memory. Parameter Name {0|1|2|3|4|5} Type Discrete Range 0|1|2|3|4|5 Default None Remarks The instrument provides 6 storage locations (No. 0 to 5) in the internal memory for storing the state files. Sending this command can recall the state file stored in the specified storage location of the internal non-volatile memory.
RIGOL Chapter 2 Command System You can send the *RCL command to recall the state file stored in the internal non-volatile memory of the instrument. Example *SAV 1 /*Stores the current instrument state in storage location 1 in the internal non-volatile memory of the instrument with the filename Scpi1.RSF.*/ *SRE Syntax *SRE *SRE? Description Enables the bits in the status byte register to generate the service request. Queries the bits enabled in the status byte register.
Chapter 2 Command System RIGOL *TRG Syntax *TRG Description Triggers a sweep or a burst. Remarks You can only trigger the sweep or burst via the remote interface when the sweep or burst function is currently enabled and the trigger source is set to manual (use the [:SOURce[]]:SWEep:TRIGger:SOURce or [:SOURce[]]:BURSt:TRIGger:SOURce command).
RIGOL Chapter 2 Command System :LXI Commands Command List: :LXI:MDNS:ENABle :LXI:RESet :LXI:RESTart :LXI:MDNS:ENABle Syntax :LXI:MDNS:ENABle {ON|1|OFF|0} :LXI:MDNS:ENABle? Description Enable or disable the multiple DNS system (mDNS). Query the status of the multiple DNS system (mDNS). Parameter Name {ON|1|OFF|0} Type Bool Range ON|1|OFF|0 Default ON Return Format The query returns ON or OFF.
Chapter 2 Command System RIGOL Remarks Several seconds are required for the LAN interface to restart (depending on your network) after sending this command. If the LAN interface or specific LAN service is disabled, you must restart the interface or service separately as well as turn off and restart the instrument to make the LAN works normally.
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 {0|1|2|3|4|5} Type Discrete Range 0|1|2|3|4|5 Default None Remarks The internal non-volatile memory of the instrument provides 6 storage locations for state files. 0 to 5 represents the state files stored in the specified locations respectively.
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. Queries the configuration of the instrument at next power-on.
RIGOL Chapter 2 Command System :MMEMory Commands The :MMEMory commands are used to query and set the related information of the internal and external memory. The internal memory of the instrument is always present, while the external memory is available only when the USB HOST interface of the rear panel detects the USB storage device.
RIGOL Chapter 2 Command System the files and folders in the folder plus 1. For example, 28672,4102361088,"3,DIR,Rigol","80,,Rigol1.RAF","1360,,Rigol0.RSF" denotes that for the current directory, its space used is 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.
RIGOL Chapter 2 Command System 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",……; wherein, the units of the space used and space available are byte, the property of the file is empty and the size is the space that it occupies. For example, 28672,4102361088,"1360,,Rigol0.
RIGOL Chapter 2 Command System Remarks The parameter 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". 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).
RIGOL Chapter 2 Command System :MMEM:DOWN:FNAM "C:\state" :MMEM:DOWN:DATA #15Hello /* Creates a "state" file in the internal memory (Disk C)*/ /* Loads the data "Hello" into the "state" file of the internal memory*/ :MMEMory:LOAD[:ALL] Syntax :MMEMory:LOAD[:ALL] Description Loads the specified state file or arbitrary waveform file under the current path.
RIGOL Chapter 2 Command System :MMEMory:LOAD:STATe Syntax :MMEMory:LOAD:STATe Description Loads the specified state file from the current directory. Parameter Name Type ASCII String Range The filename of the state file in the current directory Default None Remarks The parameter is the filename of the state file in the current directory and it is a string enclosed by double quotation marks. For example, "Rigol0.RSF". Example Assume that the current directory is D:\.
RIGOL Chapter 2 Command System :MMEMory:MOVE Syntax :MMEMory:MOVE , Description Moves file 1 from the current directory to path 2. Parameter Name Type ASCII String ASCII String Range The file in the current directory Valid directory Default None None Remarks The parameter is the filename of the file in the current directory and it is a string enclosed by double quotation marks. For example, "Rigol.RSF".
RIGOL Chapter 2 Command System :MMEMory:STORe[:ALL] Syntax :MMEMory:STORe[:ALL] 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.
RIGOL Chapter 2 Command System :MMEMory:STORe:STATe Syntax :MMEMory:STORe:STATe Description Stores the current instrument state into the current directory in state file form with the specified filename. Parameter Name Type ASCII String Range Refer to "Remarks".
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.
RIGOL Example :OUTP1:IMP INF :OUTP1:IMP? :OUTP1:LOAD 100 :OUTP1:LOAD? Chapter 2 Command System /*Sets the output impedance of the output connector of CH1 to HighZ.*/ /*Queries the output impedance of the output connector of CH1 and the query returns 9.900000E+37.*/ /*Sets the output impedance of the output connector of CH1 to 100 Ω.*/ /*Queries the output impedance of the output connector of CH1 and the query returns 1.000000E+02.
RIGOL Chapter 2 Command System Return Format The query returns ON or OFF. Example :OUTP1? :OUTP1 ON :OUTP1? /*Queries the output status of CH1 and the query returns OFF.*/ /*Enables the output of CH1.*/ /*Queries the output status of CH1 and the query returns ON.
RIGOL Parameter Name [] {ON|1|OFF|0} Chapter 2 Command System Type Discrete Bool Range 1|2 ON|1|OFF|0 Default 1 ON Remarks DG2000 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. The sync signal will be output from the rear-panel [Sync/Ext Mod/Trig/FSK] connector of the corresponding channel.
RIGOL Chapter 2 Command System :OUTPut[]:VOLLimit:LOW Syntax :OUTPut[]:VOLLimit:LOW :OUTPut[]:VOLLimit:LOW? Description Sets the low level amplitude of voltage limit. Queries the low level amplitude of voltage limit. Parameter Name [] Type Discrete Real Range 1|2 Refer to "Remarks". Default 1 0V Remarks When [] is omitted, the commands set and query the related parameters of CH1 by default.
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).
Chapter 2 Command System RIGOL :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. Example :ROSC:SOUR:CURR? /*Queries the currently selected system clock source and the query returns INT.
RIGOL Chapter 2 Command System :SOURce Commands The :SOURce commands are used to set and query the channel parameters, the related parameters of the modulation, sweep, and burst functions, the coupling and waveform combination functions as well as enabling or disabling the corresponding function. The frequency ranges available for different models and different waveforms of DG2000 series are as shown in the table below.
RIGOL Chapter 2 Command System :SOURce:TRACe :SOURce:TRACK :SOURce:VOLTage :SOURce:APPLy Command List: [:SOURce[]]:APPLy? [:SOURce[]]:APPLy:DC [:SOURce[]]:APPLy:DUALTone [:SOURce[]]:APPLy:HARMonic [:SOURce[]]:APPLy:NOISe [:SOURce[]]:APPLy:PRBS [:SOURce[]]:APPLy:PULSe [:SOURce[]]:APPLy:RAMP [:SOURce[]]:APPLy:RS232 [:SOURce[]]:APPLy:SEQuence [:SOURce[]]:APPLy:SINusoid [:SOURce[]]:APPLy:SQUare [:SOURce[]]:AP
RIGOL Chapter 2 Command System digits and the default units are Hz, Vpp, Vdc 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 Vdc, and the start phase is 4°.
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 Vdc offset.
RIGOL Chapter 2 Command System Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. The range of is limited by the "Impedance" (:OUTPut[]:IMPedance or :OUTPut[]:LOAD) setting. The range of is limited by the "Impedance" and "Amplitude/High Level" settings. Example :SOUR1:APPL:NOIS 1,2 /*Sets the waveform of CH1 to Noise with 1 Vpp amplitude and 2 Vdc offset.
RIGOL Chapter 2 Command System Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. The range of is limited by the "Impedance" (:OUTPut[]:IMPedance or :OUTPut[]:LOAD) and "Frequency/Period" settings. The range of is limited by the "Impedance" and "Amplitude/High Level" settings. Example :SOUR1:APPL:PULS 100,3,2,1 /*Sets the waveform of CH1 to Pulse with 100 Hz frequency, 3 Vpp amplitude, 2 Vdc offset, and 1° start phase.
RIGOL Chapter 2 Command System Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. The range of is limited by the "Impedance" (:OUTPut[]:IMPedance or :OUTPut[]:LOAD) and "Frequency/Period" settings. The range of is limited by the "Impedance" and "Amplitude/High Level" settings. Example :SOUR1:APPL:RS232 1,2 /*Sets the waveform of CH1 to RS232 with 1 Vpp amplitude and 2 Vdc offset.
RIGOL Chapter 2 Command System Parameter Name [] Type Discrete Real Real Real Real Range 1|2 1 μHz to 100 MHz Refer to "Remarks". Refer to "Remarks". 0° to 360° Default 1 1 kHz 5 Vpp 0 Vdc 0° Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. The range of is limited by the "Impedance" (:OUTPut[]:IMPedance or :OUTPut[]:LOAD) and "Frequency/Period" settings.
RIGOL Chapter 2 Command System [:SOURce[]]:APPLy:USER Syntax [:SOURce[]]:APPLy:USER [|DEFault|MINimum|MAXimum[,|DEFault|MINimum|MAXimum[,|DEFault|MINimu m|MAXimum[,|DEFault|MINimum|MAXimum]]]] Description Sets the waveform of the specified channel to Arbitrary with the specified frequency, amplitude, offset, and phase. Parameter Name [] Type Discrete Real Real Real Real Range 1|2 1 μHz to 20 MHz Refer to "Remarks". Refer to "Remarks".
RIGOL Chapter 2 Command System [:SOURce[]]:BURSt:GATE:POLarity Syntax [:SOURce[]]:BURSt:GATE:POLarity {NORMal|INVerted} [:SOURce[]]:BURSt:GATE:POLarity? Description Sets the gate polarity of the gated burst of the specified channel to Positive (NORMal) or Negative (INVerted). Queries the gate polarity of the gated burst of the specified channel.
RIGOL Chapter 2 Command System Square)), and the number of cycles of bursts is as follows: Pburst ≥ Pwaveform × N cycle + 2us Wherein, Pburst ——burst period; Pwaveform ——waveform period; N cycle ——number of cycles. If the specified burst period is too small, the signal generator will increase it automatically to ensure the output of the specified number of cycles. Return Format The query returns the burst period in scientific notation, with 7 effective digits. For example, 1.
RIGOL Chapter 2 Command System Example :SOUR1:BURS:MODE TRIG :SOUR1:BURS:MODE? /*Sets the burst type of CH1 to TRIG (N cycle).*/ /*Queries the burst type of CH1 and the query returns TRIG.*/ [:SOURce[]]:BURSt:NCYCles Syntax [:SOURce[]]:BURSt:NCYCles {|MINimum|MAXimum} [:SOURce[]]: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.
RIGOL Chapter 2 Command System Example :SOUR1:BURS:PHAS 10 :SOUR1:BURS:PHAS? /*Sets the start phase of the burst function of CH1 to 10°.*/ /*Queries the start phase of the burst function of CH1 and the query returns 1.000000E+01.*/ [:SOURce[]]:BURSt[:STATe] Syntax [:SOURce[]]:BURSt[:STATe] {ON|1|OFF|0} [:SOURce[]]: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.
RIGOL Chapter 2 Command System it starts to output the N Cycle (or Infinite) burst. For the N cycle burst or Infinite burst in the external trigger or manual trigger mode ([:SOURce[]]:BURSt:TRIGger:SOURce), the range of is 0 s to 100 s. For the N cycle burst in the internal trigger mode, the range of is 0 s to ( Pburst − Pwaveform × N cycle − 2us ) and its range should be smaller than or equal to 100 s. Wherein, ——burst period; Pburst Pwaveform ——waveform period (i.g.
RIGOL Parameter Name [] {POSitive|NEGative} Chapter 2 Command System Type Discrete Discrete Range 1|2 POSitive|NEGative Default 1 POSitive Remarks This command is only applicable to the burst mode (N cycle, Infinite, or Gated) in external trigger ([:SOURce[]]: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.
RIGOL Chapter 2 Command System signal. Return Format The query returns INT, EXT, or MAN. Example :SOUR1:BURS:TRIG:SOUR EXT :SOUR1:BURS:TRIG:SOUR? /*Sets the trigger source of the burst mode of CH1 to External.*/ /*Queries the trigger source of the burst mode of CH1 and the query returns EXT.
RIGOL Parameter Name [] Chapter 2 Command System Type Discrete Integer Range 1|2 0 to 16383 Default 1 FPT Remarks When [:SOURce[]] or [] 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. Example [:SOURce[]]:BURSt:IDLE FPT [:SOURce[]]:BURSt:IDLE? /*Sets the idle level position of the burst mode of CH1 to 1st Point.
RIGOL Chapter 2 Command System is from Fmin to Fmax . The range of the frequency span (defined as Fspan ) is affected by the center frequency. When the center frequency is smaller than Fm , the range of the frequency span is ±2 × ( Fcenter − Fmin ) ; when the center frequency is greater than Fm , the range of the frequency span is ±2 × ( Fmax − Fcenter ) . When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default.
RIGOL Chapter 2 Command System Select the desired frequency coupling mode and set the corresponding frequency deviation ([:SOURce[]]:FREQuency:COUPle:OFFSet) or frequency ratio ([:SOURce[]]:FREQuency:COUPle:RATio) before enabling the frequency coupling function ([:SOURce[]]:FREQuency:COUPle[:STATe]). You cannot set the frequency coupling mode and frequency deviation/ratio after the frequency coupling function is enabled.
RIGOL Chapter 2 Command System [:SOURce[]]:FREQuency:COUPle:RATio Syntax [:SOURce[]]:FREQuency:COUPle:RATio [:SOURce[]]:FREQuency:COUPle:RATio? Description Sets the frequency ratio in the frequency coupling. Queries the frequency ratio in the frequency coupling. Parameter Name [] Type Discrete Real Range 1|2 0.
RIGOL Chapter 2 Command System channel (this channel is taken as the reference source) is modified, the frequency of the other channel is automatically modified accordingly and always keeps the specified frequency deviation or ratio with that of the reference channel.
RIGOL Chapter 2 Command System [:SOURce[]]:FREQuency:SPAN Syntax [:SOURce[]]:FREQuency:SPAN {|MINimum|MAXimum} [:SOURce[]]:FREQuency:SPAN? [MINimum|MAXimum] Description Sets the frequency span of the sweep function of the specified channel. Queries the frequency span of the sweep function of the specified channel.
RIGOL Chapter 2 Command System [:SOURce[]]:FREQuency:STARt Syntax [:SOURce[]]:FREQuency:STARt {|MINimum|MAXimum} [:SOURce[]]:FREQuency:STARt? [MINimum|MAXimum] Description Sets the start frequency of the sweep function of the specified channel. Queries the start frequency of the sweep function of the specified channel.
RIGOL Chapter 2 Command System [:SOURce[]]:FREQuency:STOP Syntax [:SOURce[]]:FREQuency:STOP {|MINimum|MAXimum} [:SOURce[]]:FREQuency:STOP? [MINimum|MAXimum] Description Sets the stop frequency of the sweep function of the specified channel. Queries the stop frequency of the sweep function of the specified channel.
RIGOL Chapter 2 Command System :SOURce:FUNCtion Command List: [:SOURce[]]:FUNCtion:DUALTone:CENTERFreq [:SOURce[]]:FUNCtion:DUALTone:FREQ1 [:SOURce[]]:FUNCtion:DUALTone:FREQ2 [:SOURce[]]:FUNCtion:DUALTone:OFFSETFreq [:SOURce[]]:FUNCtion:PRBS:BRATe [:SOURce[]]:FUNCtion:PRBS:DATA [:SOURce[]]:FUNCtion:PULSe:DCYCle [:SOURce[]]:FUNCtion:PULSe:PERiod [:SOURce[]]:FUNCtion:PULSe:TRANsition[:BOTH] [:SOURce[]]:FUNCtion:PULSe:TRANsition:LEADing
RIGOL Chapter 2 Command System Parameter Name [] Type Discrete Real Range 1|2 Refer to "Remarks". Default 1 1 kHz Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. The center frequency, frequency 1 and frequency 2 satisfy the following relations. Fcenter = (F1 + F 2 ) 2 ; Wherein, ——center frequency; Fcenter F1 ——frequency 1; F2 ——frequency 2.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:DUALTone:FREQ2 Syntax [:SOURce[]]:FUNCtion:DUALTone:FREQ2 {|MINimum|MAXimum} [:SOURce[]]:FUNCtion:DUALTone:FREQ2? Description Sets Frequency 2 of the dual-tone signal of the specified channel. Queries Frequency 2 of the dual-tone signal of the specified channel.
RIGOL Chapter 2 Command System Example :SOUR1:FUNC:DUALT:OFFSETF 2000 /*Sets the offset frequency of the dual-tone signal of CH1 to 2 kHz.*/ :SOUR1:FUNC:DUALT:OFFSETF? /*Queries the offset frequency of the dual-tone signal of CH1 and the query returns 2.000000E+03.*/ [:SOURce[]]:FUNCtion:PRBS:BRATe Syntax [:SOURce[]]:FUNCtion:PRBS:BRATe {|MINimum|MAXimum} [:SOURce[]]:FUNCtion:PRBS:BRATe? [MINimum|MAXimum] Description Sets the PRBS bit rate of the specified channel.
RIGOL Chapter 2 Command System :SOUR1:FUNC:PRBS:DATA? /*Queries the PRBS data type of CH1 and the query returns PN9.*/ [:SOURce[]]:FUNCtion:PULSe:DCYCle Syntax [:SOURce[]]:FUNCtion:PULSe:DCYCle {|MINimum|MAXimum} [:SOURce[]]:FUNCtion:PULSe:DCYCle? [MINimum|MAXimum] Description Sets the pulse duty cycle of the specified channel. Queries the pulse duty cycle of the specified channel. Parameter Name [] Type Discrete Discrete Range 1|2 0.001% to 99.
RIGOL Chapter 2 Command System Parameter Name [] Type Discrete Real Range 1|2 40 ns to 1 Ms Default 1 1 ms Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default.
RIGOL Parameter Name [] Chapter 2 Command System Type Discrete Real Range 1|2 10 ns to (0.625×pulse width) Default 1 20 ns Remarks The rise time is defined as the time required for the pulse amplitude to rise from 10% to 90%. When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. The range of the rise time is limited by the current waveform frequency and pulse width.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:PULSe:WIDTh Syntax [:SOURce[]]:FUNCtion:PULSe:WIDTh {|MINimum|MAXimum} [:SOURce[]]:FUNCtion:PULSe:WIDTh? [MINimum|MAXimum] Description Sets the pulse width of the specified channel. Queries the pulse width of the specified channel. Parameter Name [] Type Discrete Real Range 1|2 16 ns to 999.
RIGOL Chapter 2 Command System When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. Return Format The query returns the symmetry in scientific notation, with 7 effective digits. For example, 5.500000E+01 (the Ramp symmetry is 55%). Example :SOUR1:FUNC:RAMP:SYMM 55 :SOUR1:FUNC:RAMP:SYMM? /*Sets the Ramp symmetry of CH1 to 55%.*/ /*Queries the Ramp symmetry of CH1 and the query returns 5.500000E+01.
RIGOL Chapter 2 Command System Return Format The query returns NONE, ODD or EVEN. Example :SOUR1:FUNC:RS232:CHECKB ODD :SOUR1:FUNC:RS232:CHECKB? /*Sets the RS232 check bit of CH1 to ODD.*/ /*Queries the RS232 check bit of CH1 and the query returns ODD.*/ [:SOURce[]]:FUNCtion:RS232:DATA Syntax [:SOURce[]]:FUNCtion:RS232:DATA {|MINimum|MAXimum} [:SOURce[]]:FUNCtion:RS232:DATA? Description Sets the RS232 data of the specified channel. Queries the RS232 data of the specified channel.
RIGOL Chapter 2 Command System :SOUR1:FUNC:RS232:DATAB? /*Queries the RS232 data bit of CH1 and the query returns 7.*/ [:SOURce[]]:FUNCtion:RS232:STOPBit Syntax [:SOURce[]]:FUNCtion:RS232:STOPBit {1|1.5|2} [:SOURce[]]:FUNCtion:RS232:STOPBit? Description Sets the RS232 stop bits of the specified channel. Queries the RS232 stop bits of the specified channel. Parameter Name [] {1|1.5|2} Type Discrete Discrete Range 1|2 1|1.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:SEQuence:FILTer Syntax [:SOURce[]]:FUNCtion:SEQuence:FILTer {SMOOth|STEP|INSErt} [:SOURce[]]:FUNCtion:SEQuence:FILTer? Description Sets the Sequence filter type of the specified channel. Queries the Sequence filter type of the specified channel.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:SEQuence:SRATe Syntax [:SOURce[]]:FUNCtion:SEQuence:SRATe {|MINimum|MAXimum} [:SOURce[]]:FUNCtion:SEQuence:SRATe? Description Sets the sample rate of the Sequence of the specified channel. Queries the sample rate of the Sequence of the specified channel. Parameter Name [] Type Discrete Real Range 1|2 2 kSa/s to 60 MSa/s Default 1 1 MSa/s Remarks The sampling rate is defined as the number of points per second.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:SEQuence:WAVE Syntax [:SOURce[]]:FUNCtion:SEQuence:WAVE , [:SOURce[]]:FUNCtion:SEQuence:WAVE? {1|2|3|4|5|6|7|8} Description Sets the waveform type of the specified number in Sequence of the specified channel. Queries the waveform type of the specified number in Sequence of the specified channel. Parameter Name [] Type Discrete Discrete Discrete Range 1|2 1|2|3|4|5|6|7|8 Refer to "Remarks".
RIGOL Parameter Name [] Chapter 2 Command System Type Discrete Discrete Range 1|2 Refer to "Remarks". Default 1 None Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. The parameter can be various basic waveforms, harmonics, and arbitrary waveforms.
RIGOL Chapter 2 Command System Return Format The query returns the Square duty cycle in scientific notation, with 7 effective digits. For example, 4.500000E+01 (the Square duty cycle is 45%). Example :SOUR1:FUNC:SQU:DCYC 45 :SOUR1:FUNC:SQU:DCYC? /*Sets the Square duty cycle of CH1 to 45%.*/ /*Queries the Square duty cycle of CH1 and the query returns 4.500000E+01.
RIGOL Chapter 2 Command System [:SOURce[]]:HARMonic:AMPL Syntax [:SOURce[]]:HARMonic:AMPL ,{|MINimum|MAXimum} [:SOURce[]]:HARMonic:AMPL? [,MINimum|MAXimum] Description Sets the amplitude of the specified order of harmonic in the harmonic function of the specified channel. Queries the amplitude of the specified order of harmonic in the harmonic function of the specified channel.
RIGOL Chapter 2 Command System Return Format The query returns the highest order of harmonic in scientific notation, with 7 effective digits. For example, 3.000000E+00 (the highest order of harmonic is 3). Example :SOUR1:HARM:ORDE 3 :SOUR1:HARM:ORDE? /*Sets the highest order of harmonic that CH1 can output to 3.*/ /*Queries the highest order of harmonic that CH1 can output and the query returns 3.000000E+00.
RIGOL Chapter 2 Command System phase ([:SOURce[]]:HARMonic:PHASe). When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. Return Format The query returns ON or OFF. Example :SOUR1:HARM ON :SOUR1:HARM? /*Enables the harmonic function of CH1.*/ /*Queries the on/off status of the harmonic function of CH1 and the query returns ON.
RIGOL Chapter 2 Command System [:SOURce[]]:HARMonic:USER Syntax [:SOURce[]]:HARMonic:USER [:SOURce[]]:HARMonic:USER? Description Sets the user-defined harmonic output of the specified channel. Queries the user-defined harmonic output of the specified channel.
RIGOL Chapter 2 Command System :SOURce:MARKer Command List: [:SOURce[]]:MARKer:FREQuency [:SOURce[]]:MARKer[:STATe] [:SOURce[]]:MARKer:FREQuency Syntax [:SOURce[]]:MARKer:FREQuency {|MINimum|MAXimum} [:SOURce[]]:MARKer:FREQuency? [MINimum|MAXimum] Description Sets the marker frequency of the specified channel. Queries the marker frequency of the specified channel. Parameter Name [] Type Discrete Real Range 1|2 Refer to "Remarks".
RIGOL Chapter 2 Command System Parameter Name [] {ON|1|OFF|0} Type Discrete Bool Range 1|2 ON|1|OFF|0 Default 1 OFF Remarks The sync signal output from the rear-panel [Sync/Ext Mod/Trig/FSK] connector of the corresponding channel always changes from low level to high level at the start of each sweep. When the "Marker" function is disabled, the sync signal will change to low level at the center frequency point.
RIGOL Chapter 2 Command System :SOURce[:MOD]:AM Command List: [:SOURce[]][:MOD]:AM[:DEPTh] [:SOURce[]][:MOD]:AM:DSSC [:SOURce[]][:MOD]:AM:INTernal:FREQuency [:SOURce[]][:MOD]:AM:INTernal:FUNCtion [:SOURce[]][:MOD]:AM:SOURce [:SOURce[]][:MOD]:AM:STATe [:SOURce[]][:MOD]:AM[:DEPTh] Syntax [:SOURce[]][:MOD]:AM[:DEPTh] {|MINimum|MAXimum} [:SOURce[]][:MOD]:AM[:DEPTh]? [MINimum|MAXimum] Description Sets the AM modulation depth of the specified channel.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:AM:DSSC Syntax [:SOURce[]][:MOD]:AM:DSSC {ON|1|OFF|0} [:SOURce[]][:MOD]:AM:DSSC? Description Enables or disables the AM carrier waveform suppression function of the specified channel. Queries the on/off status of the AM carrier waveform suppression function of the specified channel.
RIGOL Chapter 2 Command System Example :SOUR1:AM:INT:FREQ 150 :SOUR1:AM:INT:FREQ? /*Sets the AM modulation frequency of CH1 to 150 Hz.*/ /*Queries the AM modulation frequency of CH1 and the query returns 1.500000E+02.*/ [:SOURce[]][:MOD]:AM:INTernal:FUNCtion Syntax [:SOURce[]][:MOD]:AM:INTernal:FUNCtion {SINusoid|SQUare|TRIangle|RAMP|NRAMp|NOISe|USER} [:SOURce[]][:MOD]:AM:INTernal:FUNCtion? Description Sets the AM modulation waveform of the specified channel.
RIGOL Chapter 2 Command System When the external source is selected, the generator receives the external modulating signal from the rear-panel [Sync/Ext Mod/Trig/FSK] connector. At this time, amplitude of the modulated waveform is controlled by the ±5 V signal level of the connector. For example, if the modulation depth is set to 100%, the output amplitude will be the maximum when the modulating signal is +5 V and the minimum when the modulating signal is -5 V.
RIGOL Chapter 2 Command System :SOURce[:MOD]:ASKey Command List: [:SOURce[]][:MOD]:ASKey:AMPLitude [:SOURce[]][:MOD]:ASKey:INTernal[:RATE] [:SOURce[]][:MOD]:ASKey:POLarity [:SOURce[]][:MOD]:ASKey:SOURce [:SOURce[]][:MOD]:ASKey:STATe [:SOURce[]][:MOD]:ASKey:AMPLitude Syntax [:SOURce[]][:MOD]:ASKey:AMPLitude {|MINimum|MAXimum} [:SOURce[]][:MOD]:ASKey:AMPLitude? [MINimum|MAXimum] Description Sets the ASK modulation amplitude of the specified channel.
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[]] or [] is omitted, the system sets the related parameters of CH1 by default. Return Format The query returns the ASK modulation rate in scientific notation, with 7 effective digits. For example, 1.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:ASKey:SOURce Syntax [:SOURce[]][:MOD]:ASKey:SOURce {INTernal|EXTernal} [:SOURce[]][: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.
RIGOL Chapter 2 Command System modulated waveform. When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. If the sweep function ([:SOURce[]]:SWEep:STATe) or burst function ([:SOURce[]]:BURSt[:STATe]) is currently enabled, it will be disabled automatically when the modulation function is enabled. If the harmonic function is currently enabled ([:SOURce[]]:HARMonic[:STATe]), the modulation function cannot be enabled (i.g.
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. Return Format The query returns the frequency deviation in scientific notation, with 7 effective digits.
RIGOL Chapter 2 Command System Parameter Name [] {SINusoid|SQUare|TRIangle|RAMP|NRA Mp|NOISe|USER} Type Discrete Discrete Range 1|2 SINusoid|SQUare|TRIangle|RAM P|NRAMp|NOISe|USER Default 1 SINusoid Remarks This command is only applicable to the internal modulation source ([:SOURce[]][:MOD]:FM:SOURce). When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:FM:STATe Syntax [:SOURce[]][:MOD]:FM:STATe {ON|1|OFF|0} [:SOURce[]][:MOD]:FM:STATe? Description Enables or disables the FM modulation function of the specified channel. Queries the on/off status of the FM modulation function of the specified channel.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:FSKey[:FREQuency] Syntax [:SOURce[]][:MOD]:FSKey[:FREQuency] {|MINimum|MAXimum} [:SOURce[]][:MOD]:FSKey[:FREQuency]? [MINimum|MAXimum] Description Sets the FSK hop frequency of the specified channel. Queries the FSK hop frequency of the specified channel.
RIGOL Chapter 2 Command System Example :SOUR1:FSK:INT:RATE 150 :SOUR1:FSK:INT:RATE? /*Sets the FSK modulation rate of CH1 to 150 Hz.*/ /*Queries the FSK modulation rate of CH1 and the query returns 1.500000E+02.*/ [:SOURce[]][:MOD]:FSKey:POLarity Syntax [:SOURce[]][:MOD]:FSKey:POLarity {POSitive|NEGative} [:SOURce[]][:MOD]:FSKey:POLarity? Description Sets the FSK modulation polarity of the specified channel to Positive (POSitive) or Negative (NEGative).
RIGOL Chapter 2 Command System Remarks DG2000 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 frequency "shifts" between "carrier frequency" and "hop frequency" ([:SOURce[]][:MOD]:FSKey[:FREQuency]) is determined by the modulation rate ([:SOURce[]][:MOD]:FSKey:INTernal:RATE).
RIGOL Chapter 2 Command System :SOURce[:MOD]:PM Command List: [:SOURce[]][:MOD]:PM[:DEViation] [:SOURce[]][:MOD]:PM:INTernal:FREQuency [:SOURce[]][:MOD]:PM:INTernal:FUNCtion [:SOURce[]][:MOD]:PM:SOURce [:SOURce[]][:MOD]:PM:STATe [:SOURce[]][:MOD]:PM[:DEViation] Syntax [:SOURce[]][:MOD]:PM[:DEViation] {|MINimum|MAXimum} [:SOURce[]][:MOD]:PM[:DEViation]? [MINimum|MAXimum] Description Sets the PM phase deviation of the specified channel.
RIGOL Chapter 2 Command System Parameter Name [] Type Discrete Real Range 1|2 2 mHz to 1 MHz Default 1 100 Hz Remarks This command is only applicable to the internal modulation source ([:SOURce[]][:MOD]:PM:SOURce). When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. Return Format The query returns the PM modulation frequency in scientific notation, with 7 effective digits. For example, 1.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:PM:SOURce Syntax [:SOURce[]][:MOD]:PM:SOURce {INTernal|EXTernal} [:SOURce[]][:MOD]:PM:SOURce? Description Sets the PM modulation source of the specified channel to internal (INTernal) or external (EXTernal) modulation source. Queries the PM modulation source of the specified channel.
RIGOL Chapter 2 Command System waveform. When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. If the sweep function ([:SOURce[]]:SWEep:STATe) or burst function ([:SOURce[]]:BURSt[:STATe]) is currently enabled, it will be disabled automatically when the modulation function is enabled. If the harmonic function is currently enabled ([:SOURce[]]:HARMonic[:STATe]), the modulation function cannot be enabled (i.g. the harmonic cannot be modulated).
RIGOL Chapter 2 Command System Example :SOUR1:PSK:INT:RATE 150 :SOUR1:PSK:INT:RATE? /*Sets the PSK modulation rate of CH1 to 150 Hz.*/ /*Queries the PSK modulation rate of CH1 and the query returns 1.500000E+02.*/ [:SOURce[]][:MOD]:PSKey:PHASe Syntax [:SOURce[]][:MOD]:PSKey:PHASe {|MINimum|MAXimum} [:SOURce[]][:MOD]:PSKey:PHASe? [MINimum|MAXimum] Description Sets the PSK modulation phase of the specified channel. Queries the PSK modulation phase of the specified channel.
RIGOL Chapter 2 Command System set to "Negative". In the external modulation ([:SOURce[]][:MOD]:PSKey:SOURce), set the polarity to "Positive", and the generator will output the carrier phase when the external input signal is a logic low level. It will output the modulating phase ([:SOURce[]][:MOD]:PSKey:PHASe) when the external input signal is a logic high level. The situation is the opposite when the polarity is set to "Negative". Return Format The query returns POS or NEG.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:PSKey:STATe Syntax [:SOURce[]][:MOD]:PSKey:STATe {ON|1|OFF|0} [:SOURce[]][:MOD]:PSKey:STATe? Description Enables or disables the PSK modulation function of the specified channel. Queries the on/off status of the PSK modulation function of the specified channel.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:PWM[:DEViation]:DCYCle Syntax [:SOURce[]][:MOD]:PWM[:DEViation]:DCYCle {|MINimum|MAXimum} [:SOURce[]][: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. Parameter Name [] Type Discrete Real Range 1|2 Refer to "Remarks".
RIGOL Chapter 2 Command System If "Duty" is currently selected in the pulse of the specified channel, "Duty Dev" is displayed in the interface when the PWM modulation function is enabled; if "Width" is currently selected in the pulse of the specified channel, "Width Dev" is displayed in the interface when the PWM modulation function is enabled. Return Format The query returns the PWM width deviation in scientific notation, with 7 effective digits. For example, 1.
RIGOL Chapter 2 Command System Parameter Name [] {SINusoid|SQUare|TRIangle|RAM P|NRAMp|NOISe|USER} Type Discrete Discrete Range 1|2 SINusoid|SQUare|TRIangle|RAMP|NR AMp|NOISe|USER Default 1 SINusoid Remarks This command is only applicable to the internal modulation source ([:SOURce[]][:MOD]:PWM:SOURce). When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:PWM:STATe Syntax [:SOURce[]][:MOD]:PWM:STATe {ON|1|OFF|0} [:SOURce[]][:MOD]:PWM:STATe? Description Enables or disables the PWM modulation function of the specified channel. Queries the on/off status of the PWM modulation function of the specified channel.
RIGOL Chapter 2 Command System Parameter Name [] {ON|1|OFF|0} Type Discrete Bool Range 1|2 ON|1|OFF|0 Default 1 OFF Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. If the sweep function ([:SOURce[]]:SWEep:STATe) or burst function ([:SOURce[]]:BURSt[:STATe]) is currently enabled, it will be disabled automatically when the modulation function is enabled.
RIGOL Chapter 2 Command System Example :SOUR1:MOD:TYPE FM :SOUR1:MOD:TYPE? /*Sets the modulation type of CH1 to FM.*/ /*Queries the modulation type of CH1 and the query returns FM.*/ :SOURce:PERiod Command List: [:SOURce[]]:PERiod[:FIXed] [:SOURce[]]:PERiod[:FIXed] Syntax [:SOURce[]]:PERiod[:FIXed] {|MINimum|MAXimum} [:SOURce[]]:PERiod[:FIXed]? [MINimum|MAXimum] Description Sets the waveform (basic waveforms and arbitrary waveforms) period of the specified channel.
RIGOL Chapter 2 Command System :SOURce:PHASe Command List: [:SOURce[]]:PHASe[:ADJust] [:SOURce[]]:PHASe:INITiate [:SOURce[]]:PHASe:SYNChronize [:SOURce[]]:PHASe[:ADJust] Syntax [:SOURce[]]:PHASe[:ADJust] {|MINimum|MAXimum} [:SOURce[]]:PHASe[:ADJust]? [MINimum|MAXimum] Description Sets the waveform (basic waveforms and arbitrary waveforms) start phase of the specified channel.
RIGOL Chapter 2 Command System When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. Example :SOUR1:PHAS:INIT :SOUR2:PHAS:SYNC /*Executes an align phase operation on CH1.*/ /*Executes an align phase operation on CH2.
RIGOL Chapter 2 Command System [:SOURce[]]:PULSe:TRANsition[:LEADing] Syntax [:SOURce[]]:PULSe:TRANsition[:LEADing] {|MINimum|MAXimum} [:SOURce[]]: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 Discrete Real Range 1|2 8 ns to (0.
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[]]:PULSe:WIDTh Syntax [:SOURce[]]:PULSe:WIDTh {|MINimum|MAXimum} [:SOURce[]]:PULSe:WIDTh? [MINimum|MAXimum] Description Sets the pulse width of the specified channel. Queries the pulse width of the specified channel.
RIGOL Chapter 2 Command System [:SOURce[]]:SUM:AMPLitude Syntax [:SOURce[]]:SUM:AMPLitude {|MINimum|MAXimum} [:SOURce[]]: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.
RIGOL Chapter 2 Command System [:SOURce[]]:SUM:INTernal:FUNCtion Syntax [:SOURce[]]:SUM:INTernal:FUNCtion {SIN|SQU|RAMP|NOISe|ARB} [:SOURce[]]: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.
RIGOL Chapter 2 Command System :SOURce:SWEep Command List: [:SOURce[]]:SWEep:HTIMe:STARt [:SOURce[]]:SWEep:HTIMe[:STOP] [:SOURce[]]:SWEep:RTIMe [:SOURce[]]:SWEep:SPACing [:SOURce[]]:SWEep:STATe [:SOURce[]]:SWEep:STEP [:SOURce[]]:SWEep:TIME [:SOURce[]]:SWEep:TRIGger[:IMMediate] [:SOURce[]]:SWEep:TRIGger:SLOPe [:SOURce[]]:SWEep:TRIGger:SOURce [:SOURce[]]:SWEep:HTIMe:STARt Syntax [:SOURce[]]:SWEep:HTIMe:STARt {|MINimum|MAXim
RIGOL Chapter 2 Command System [:SOURce[]]:SWEep:HTIMe[:STOP] Syntax [:SOURce[]]:SWEep:HTIMe[:STOP] {|MINimum|MAXimum} [:SOURce[]]: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.
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 :SOUR1:SWE:RTIM? /*Sets the return time of the sweep function of CH1 to 1 s.*/ /*Queries the return time of the sweep function of CH1 and the query returns 1.000000E+00.
RIGOL Chapter 2 Command System [:SOURce[]]:SWEep:STATe Syntax [:SOURce[]]:SWEep:STATe {ON|1|OFF|0} [:SOURce[]]: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 [] {ON|1|OFF|0} Type Discrete Bool Range 1|2 ON|1|OFF|0 Default 1 OFF Remarks DG2000 can output sweep waveforms from a single channel or from dual channels at the same time.
RIGOL Chapter 2 Command System stop frequency ([:SOURce[]]:FREQuency:STOP). It is only available in step sweep ([:SOURce[]]:SWEep:SPACing). When [:SOURce[]] or [] 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). Example :SOUR1:SWE:STEP 5 :SOUR1:SWE:STEP? /*Sets the number of steps of the sweep of CH1 to 5.
RIGOL Chapter 2 Command System [:SOURce[]]:SWEep:TRIGger[:IMMediate] Syntax [:SOURce[]]:SWEep:TRIGger[:IMMediate] Description Triggers a sweep immediately on the specified channel. Parameter Name [] Type Discrete Range 1|2 Default 1 Remarks This command is only applicable to manual trigger ([:SOURce[]]:SWEep:TRIGger:SOURce) and is only valid when the output of the corresponding channel (:OUTPut[][:STATe]) is enabled.
RIGOL Chapter 2 Command System [:SOURce[]]:SWEep:TRIGger:SOURce Syntax [:SOURce[]]:SWEep:TRIGger:SOURce {INTernal|EXTernal|MANual} [:SOURce[]]: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.
RIGOL Chapter 2 Command System :SOURce:TRACe Command List: [:SOURce[]][:TRACe]:DATA:DAC16 [:SOURce[]][:TRACe]:DATA:DAC16 Syntax [:SOURce[]][:TRACe]:DATA:DAC16 VOLATILE,, Description Downloads waveform table to the DDRIII internal memory. Parameter Name [] Type Discrete Range 1|2 Default 1 ASCII String Refer to "Remarks". None Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default.
RIGOL Chapter 2 Command System :SOURce:TRACK Command List: [:SOURce[]]:TRACK [:SOURce[]]:TRACK Syntax [:SOURce[]]:TRACK {ON|OFF|INVerted} [:SOURce[]]: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. Parameter Name [] {ON|OFF|INVerted} Type Discrete Discrete Range 1|2 ON|OFF|INVerted Default 1 OFF Remarks On: enables the track function.
RIGOL Chapter 2 Command System [:SOURce[]]:VOLTage:COUPle[:STATe] Syntax [:SOURce[]]:VOLTage:COUPle[:STATe] {ON|1|OFF|0} [:SOURce[]]:VOLTage:COUPle[:STATe]? Description Enables or disables the amplitude coupling function. Queries the on/off status of the amplitude coupling function. Parameter Name [] {ON|1|OFF|0} Type Discrete Bool Range 1|2 ON|1|OFF|0 Default 1 OFF Remarks After the amplitude coupling function is enabled, CH1 and CH2 take each other as the reference source.
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. Amplitude = High Level - Low Level Offset = (High Level + Low Level)/2 Return Format The query returns the waveform amplitude in scientific notation, with 7 effective digits. For example, 5.
RIGOL Parameter Name [] Chapter 2 Command System Type Discrete Real Range 1|2 Refer to "Remarks". Default 1 -2.5 Vpp Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. You can also use the "Amplitude" ([:SOURce[]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]) and "Offset" ([:SOURce[]]:VOLTage[:LEVel][:IMMediate]:OFFSet) to set the high level and low level.
RIGOL Chapter 2 Command System [:SOURce[]]:VOLTage:UNIT Syntax [:SOURce[]]:VOLTage:UNIT {VPP|VRMS|DBM} [:SOURce[]]: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 [] {VPP|VRMS|DBM} Type Discrete Discrete Range 1|2 VPP|VRMS|DBM Default 1 VPP Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default.
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.
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. :SYSTem:BEEPer:STATe Syntax :SYSTem:BEEPer:STATe {ON|1|OFF|0} :SYSTem:BEEPer:STATe? Description Turns on or off the beeper. Queries the on/off status of the beeper.
RIGOL Example :SYST:CHAN:CUR CH2 :SYST:CHAN:CUR? Chapter 2 Command System /*Selects CH2 as the current channel.*/ /*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. Example :SYST:CHAN:NUM? /*Queries the number of the output channels of the instrument and the query returns 2.
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.
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. :SYSTem:COMMunicate:LAN:DHCP[:STATe] Syntax :SYSTem:COMMunicate:LAN:DHCP[:STATe] {ON|1|OFF|0} :SYSTem:COMMunicate:LAN:DHCP[:STATe]? Description Enables or disables the DHCP configuration mode.
RIGOL Chapter 2 Command System Parameter Name
Type ASCII String Range Refer to "Remarks". Default None Remarks This command is only valid when the ManualIP configuration mode (:SYSTem:COMMunicate:LAN:STATic[:STATe]) is enabled. The format of is "nnn.nnn.nnn.nnn". The range for the first segment (nnn) of the address is from 1 to 223 (except 127); and the range for the other three segments is from 0 to 255.RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN:GATEway Syntax :SYSTem:COMMunicate:LAN:GATEway
:SYSTem:COMMunicate:LAN:GATEway? Description Sets the default gateway. Queries the default gateway. Parameter Name Type ASCII String Range Refer to "Remarks". Default None Remarks This command is only valid when the ManualIP configuration mode (:SYSTem:COMMunicate:LAN:STATic[:STATe]) is enabled. The format of is "nnn.nnn.nnn.nnn".RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN:IPADdress Syntax :SYSTem:COMMunicate:LAN:IPADdress :SYSTem:COMMunicate:LAN:IPADdress? Description Sets the IP address. Queries the IP address. Parameter Name Type ASCII String Range Refer to "Remarks". Default None Remarks This command is only valid when the ManualIP configuration mode (:SYSTem:COMMunicate:LAN:STATic[:STATe]) is enabled. The format of is "nnn.nnn.nnn.nnn".
RIGOL Chapter 2 Command System Description Sets the subnet mask. Queries the subnet mask. Parameter Name Type ASCII String Range Refer to "Remarks". Default None Remarks This command is only valid when the ManualIP configuration mode (:SYSTem:COMMunicate:LAN:STATic[:STATe]) is enabled. The format of is "nnn.nnn.nnn.nnn". The range of "nnn" is from 0 to 255. You are recommended to ask your network administrator for a subnet mask available.
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN:UPDate Syntax :SYSTem:COMMunicate:LAN:UPDate Description Store all the modifications of the LAN setting to the non-volatile memory and restart the LAN drive program using the updated setting. Remarks You must send this command after modifying the DHCP, DNS, gateway, host name, IP address and subnet mask settings. Please finish all the modifications of the LAN setting before sending this command.
RIGOL Chapter 2 Command System :SYSTem:ERRor? Syntax :SYSTem:ERRor? Description Queries and clears an error message from the error queue. Remarks The error will be cleared when you read the error queue. You can also clear the error queue by using the *CLS command or the *RST command; or by turning on/off the instrument. Return Format The query returns a string consisting of two parts separated by commas.
RIGOL Chapter 2 Command System :SYSTem:LANGuage Syntax :SYSTem:LANGuage {ENGLish|SCHinese} :SYSTem:LANGuage? Description Sets the system language to English (ENGLish) or Simplified Chinese (SCHinese). Queries the system language. Parameter Name {ENGLish|SCHinese} Type Discrete Range ENGLish|SCHinese Default SCHinese Return Format The query returns ENGL or SCH. Example :SYST:LANG SCH :SYST:LANG? /*Sets the system language to Simplified Chinese.
RIGOL Chapter 2 Command System Remarks DEFault: the instrument recalls the factory defaults (except the parameters (e.g. Language) that will not be affected by factory default settings, refer to "Factory Setting") at power-on. LAST: includes all system parameters and states, except channel output state and clock source. Return Format The query returns DEFAULT or LAST. Example :SYST:POW LAST :SYST:POW? /*Sets the power-on state to Last.*/ /*Queries the power-on state and the query returns LAST.
RIGOL Chapter 2 Command System of the instrument respectively. The state file can only be recalled when the specified storage location in the internal memory contains a state file. Example Assume that a state file is already found in storage location 1 of the internal memory of the instrument.
RIGOL Chapter 2 Command System Remarks DG2000 provides an internal 10 MHz clock source and receives the external clock source from the rear-panel [10MHz In/Out] connector. It can also output clock source from the [10MHz In/Out] connector for other devices. If "External" is selected, the instrument will detect whether a valid external clock signal is input from the rear-panel [10MHz In/Out] connector.
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[]:DELay :TRIGger[][:IMMediate] :TRIGger[]:SLOPe :TRIGger[]:SOURce :TRIGger[]:DELay Syntax :TRIGger[]:DELay {|MINimum|MAXimum} :TRIGger[]:DELay? [MINimum|MAXimum] Description Sets the burst delay of the specified channel.
RIGOL Chapter 2 Command System :TRIGger[][:IMMediate] Syntax :TRIGger[] [:IMMediate] Description Generates a trigger on the specified channel. Parameter Name [] Type Discrete Range 1|2 Default 1 Remarks This command is only applicable to the burst output ([:SOURce[]]:BURSt[:STATe]) or sweep output ([:SOURce[]]:SWEep:STATe) in manual trigger (:TRIGger[]:SOURce). When [] is omitted, the system generates a trigger on CH1 by default.
RIGOL Chapter 2 Command System :TRIGger[]:SOURce Syntax :TRIGger[]:SOURce {INTernal|EXTernal|BUS} :TRIGger[]: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.
Chapter 3 Application Instances RIGOL 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: 1. The instances in this chapter take DG2102 as an example. The range of certain parameters for other models may be different. Therefore, you need to adjust the parameter range for the model that you use if necessary. 2.
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 1 Vdc, start phase 90°) from the front-panel [CH1] output connector. Method 1 1. *IDN? 2. :SOUR1:APPL:SIN 500,2.5,1,90 3. :OUTP1 ON /*Queries the ID string of the signal generator to test whether the remote communication works normally.
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 h
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; set the hop frequency to 2 kHz and the polarity to Positive. Method 1. *IDN? 2. :SOUR1:APPL:SIN 1000,5,0,0 3. 4.
RIGOL Chapter 3 Application Instances 17. 18. :OUTP1 ON :SOUR1:SWE:TRIG edge.*/ /*Enables the output of CH1.*/ /*Triggers a sweep immediately on the specified channel.
RIGOL 6. 7. 8. :COUN:LEVE 0.1 :COUN:COUP AC :COUN:HF ON 9. :COUN RUN 3-6 Chapter 3 Application Instances High.*/ /*Sets the trigger level of the frequency counter to 0.1 V.*/ /*Sets the coupling mode of the input signal to AC.*/ /*Enables the high frequency rejection function of the frequency counter.*/ /*Sets the operating status of the frequency counter to RUN.
Chapter 4 Programming Examples RIGOL 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.
RIGOL Chapter 4 Programming Examples Programming Preparations Before programming, you need to prepare the following tasks: 1. 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. In this manual, the default installation path is C:\Program Files\IVI Foundation\VISA. 2.
Chapter 4 Programming Examples RIGOL 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. 1. Create a new Excel file that enables the Macros and name it "DG2000_Demo_Excel.xlsm". 2. Run the DG2000_Demo_Excel.xlsm file. Click File Options at the upper-left corner of the Excel file to open the interface as shown in the figure below.
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. (2) Click Browse... at the right section to search visa32.dll from C:\WINDOWS\system32, as shown in the figure below. 5. Click View Code under Developer menu to enter the interface of Microsoft Visual Basic.
Chapter 4 Programming Examples 6. RIGOL 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" and click OK. The default name of the button is "Button1". Right-click the button and select Edit Text in the pop-up menu to change the button name to "*IDN?". 7.
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. 1. Run the Matlab software and modify the current path (Current Directory). In this example, modify the current path to E:\DG2000_Demo_Matlab. 2. Click File New Blank M-File in the Matlab interface to create an empty M file. 3.
Chapter 4 Programming Examples DG2000 Programming Guide RIGOL 4-7
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. 1. Run LabVIEW 2009, and then create a VI file named DG2000_Demo_LABVIEW. 2. Add controls to the front panel interface, including the Address field, Command field, and Return field, the Connect button, the Write button, the Read button, and the Exit button.
Chapter 4 Programming Examples 3. RIGOL Click Show Block Diagram under the Window menu to create an event structure.
RIGOL 4.
Chapter 4 Programming Examples DG2000 Programming Guide RIGOL 4-11
RIGOL Chapter 4 Programming Examples (2) Write operation (including error confirmation): (3) Read operation (including error processing): 4-12 DG2000 Programming Guide
Chapter 4 Programming Examples DG2000 Programming Guide RIGOL 4-13
RIGOL Chapter 4 Programming Examples (4) Exit: 5. 4-14 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 *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.
Chapter 4 Programming Examples RIGOL 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. 1. Run Visual Basic 6.0, and build a standard application program project (Standard EXE), and name it "DG2000_Demo_VB". 2. Click ProjectAdd Module to open the Add Module dialog box. In the dialog box, click the Existing tab to search for the visa32.
RIGOL 5. 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.
Chapter 4 Programming Examples RIGOL ' Close the resource Call viClose(vi) Call viClose(defrm) 6. Run and view the results, as shown in the figure below. 1) 2) 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; The running result is as shown in the figure below.
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. 1. Run Microsoft Visual C++ 6.0. Create a MFC project based on a dialog box and name it "DG2000_Demo_VC". 2. Click Project Settings and add visa32.lib in the Link tab in the pop-up interface manually.
Chapter 4 Programming Examples 3. RIGOL Click ToolsOptions. 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. Select Include files from the drop-down list under Show directories for.
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. 4. Add the Text, Edit, and Button controls and the layout is as shown in the figure below.
Chapter 4 Programming Examples RIGOL 5. Click ViewClassWizard 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 6. Encapsulate the read and write operations of VISA. 1) Encapsulate the write operation of VISA for easier operation.
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; 2) Encapsulate the read operation of VISA for easier operation.
Chapter 4 Programming Examples RIGOL 1) Connect to the instrument void CDG2000_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; ViChar instrDesc[1000]; CString strSrc = ""; CString strInstr = ""; unsigned long i = 0; bool bFindDG = false; status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { // Error Initializing VISA...
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); 3) Read Operation void CDG2000_Demo_VCDlg::OnRead() { // TODO: Add your control notification handler code here UpdateData(true); InstrRead(m_strInstrAddr,&m_strResult); UpdateData(false); } 8.
Chapter 4 Programming Examples DG2000 Programming Guide RIGOL 4-25
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.
RIGOL Harmonic Amplitude (7) User DC Offset Built-in Arbitrary Waveforms 1.2647 Vpp X0000000 0 Vdc Sinc Advanced Waveform Amplitude Offset PRBS Bit Rate PRBS Data RS232 Baud Rate RS232 Data Bits RS232 Stop Bits RS232 Parity Bit RS232 Data Sequence Filter Sequence Sample Rate Sequence Phase 5 Vpp 0 Vdc 2 kbps PRBS7 9600 8 1 None 85 Interpolation 1 MSa/s 0° Modulation AM Modulation Source Mod.Wave Mod.Freq Mod.Depth DSSC FM Modulation Source Mod.Wave Mod.Freq Freq.Dev PM Modulation Source Mod.Wave Mod.
RIGOL Chapter 5 Appendix Width Deviation Duty Deviation Sweep Sweep Time Return Time Start Freq Stop Freq Center Frequency Frequency Span Start Hold Time Stop Hold Time Marker Marker Freq Trigger Source Trig In Step Burst Cycles Period Gated Polarity Idle Level Trigger Source Trig Out Trig In Delay 200 μs 20% 1s 0 ms 100 Hz 1 kHz 550 Hz 900 Hz 0 ms 0 ms Off 550 Hz Internal RisEdge 2 1 10 ms Positive 1st Point Internal Off RisEdge 0 ns Interface Focus Items Freq/Period Ampl/HighL Offset/LowL Duty/Width
RIGOL Screen Saver Brightness* Print Setting Location Format* Interface GPIB* DHCP* Auto IP* Manual IP* 5-4 Chapter 5 Appendix Off 100% USB Storage Device PNG 2 On (default setting in LAN) On (default setting in LAN) Off (default setting in LAN) DG2000 Programming Guide
Chapter 5 Appendix RIGOL 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.