RIGOL Programming Guide DG900 Series Function/Arbitrary Waveform Generator Aug. 2018 RIGOL (SUZHOU) TECHNOLOGIES INC.
RIGOL Guaranty and Declaration Copyright © 2018 RIGOL (SUZHOU) TECHNOLOGIES INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC. Publication Number PGB10100-1110 Software Version 00.00.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.
RIGOL Contents Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 Programming Overview......................................................................................1-1 Build Remote Communication .......................................................................
RIGOL Contents To Output Burst Waveform ........................................................................................................ 3-5 To Use the Frequency Counter ................................................................................................... 3-5 Chapter 4 Programming Examples .................................................................................... 4-1 Programming Preparations ...................................................................................
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 DG900 and the PC via the USB (USB DEVICE), LAN (extended from the USB HOST interface by using the USB-LAN interface converter) 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.
RIGOL Chapter 1 Programming Overview 3. 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 control panel and click and in sequence or directly click 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 DG900 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 :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; delete, lock, and unlock the state files in the internal memory; query and modify the filenames of the state files stored as well as set the power-on configuration.
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 :MEM:STAT:NAME? 2 Chapter 2 Command System /*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 Chapter 2 Command System Example :OUTP1:IMP INF :OUTP1:IMP? :OUTP1:LOAD 100 :OUTP1:LOAD? /*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 Chapter 2 Command System Parameter Name [] {ON|1|OFF|0} Type Discrete Bool Range 1|2 ON|1|OFF|0 Default 1 ON Remarks DG900 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).
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. Example :ROSC:SOUR:CURR? 2-46 /*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 DG900 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 Real Real Real Refer to "Remarks". Refer to "Remarks". 0° to 360° 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. The range of is limited by the "Impedance" and "Amplitude/High Level" settings.
RIGOL Chapter 2 Command System Parameter Name [] Type Discrete Real Real Real Real Range 1|2 1 μHz to 20 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. This command only selects and sets the arbitrary waveform parameters of the channel and does not set the arbitrary waveform type. The default arbitrary waveform is Sinc.
RIGOL Chapter 2 Command System Parameter Name [] {NORMal|INVerted} Type Discrete Discrete Range 1|2 NORMal|INVerted Default 1 NORMal Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. The gate polarity is only applicable to the gated burst mode ([:SOURce[]]:BURSt:MODE). The signal generator controls the burst output according to the level of the external signal (i.g.
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 :SOUR1:BURS:INT:PER? /*Sets the internal burst period of the N cycle burst of CH1 to 0.1 s.*/ /*Queries the internal burst period of the N cycle burst of CH1 and the query returns 1.000000E-01.
RIGOL Chapter 2 Command System [: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 [: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 Wherein, ——burst period; Pburst Pwaveform ——waveform period (i.g. the period of the burst function (Sine, Square, etc.)); N cycle ——number of the burst cycles. When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. Return Format The query returns the burst delay in scientific notation, with 7 effective digits. For example, 1.000000E-01 (the burst delay is 0.1 s). Example :SOUR1:BURS:TDEL 0.
RIGOL Chapter 2 Command System ([: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. Once it receives a TTL pulse with a specified polarity, a burst output (N cycle, Infinite, or Gated) is initiated. When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. Return Format The query returns POS or NEG.
RIGOL :SOUR1:BURS:TRIG:SOUR? Chapter 2 Command System /*Queries the trigger source of the burst mode of CH1 and the query returns EXT.*/ [:SOURce[]]:BURSt:TRIGger:TRIGOut Syntax [:SOURce[]]:BURSt:TRIGger:TRIGOut {POSitive|NEGative|OFF} [:SOURce[]]:BURSt:TRIGger:TRIGOut? Description Sets the edge type of the trigger output signal in the burst mode of the specified channel to Rising (POSitive) or Falling (NEGative) or disable the trigger output signal.
RIGOL Chapter 2 Command System 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.*/ /*Queries the idle level position of the burst mode of CH1 and the query returns FPT.
RIGOL Chapter 2 Command System equations. Fcenter = (| Fstart + Fstop |) ; Fspan = (| Fstop − Fstart |) Wherein, ——center frequency; Fcenter Fspan ——frequency span; Fstart ——start frequency; Fstop ——stop frequency. The generator will restart to sweep and output from the specified "Start Frequency" after the "center frequency" is modified. In large-scale sweep, the amplitude characteristic of the output signal might change.
RIGOL Chapter 2 Command System Return Format The query returns OFFS or RAT. Example :FREQ:COUP:MODE OFFS :FREQ:COUP:MODE? /*Sets the frequency coupling mode of CH1 to Frequency Deviation.*/ /*Queries the frequency coupling mode and the query returns OFFS.*/ [:SOURce[]]:FREQuency:COUPle:OFFSet Syntax [:SOURce[]]:FREQuency:COUPle:OFFSet [:SOURce[]]:FREQuency:COUPle:OFFSet? Description Sets the frequency deviation in the frequency coupling.
RIGOL Parameter Name [] Chapter 2 Command System Type Discrete Real Range 1|2 0.000 001 to 1 000 000 Default 1 1 Remarks Select the desired frequency coupling mode ([:SOURce[]]:FREQuency:COUPle:MODE) and set the corresponding frequency deviation ([:SOURce[]]:FREQuency:COUPle:OFFSet) or frequency ratio before enabling the frequency coupling function ([:SOURce[]]:FREQuency:COUPle[:STATe]).
RIGOL Chapter 2 Command System Return Format The query returns ON or OFF. Example :FREQ:COUP ON :FREQ:COUP? /*Enables the frequency coupling function.*/ /*Queries the on/off status of the frequency coupling function and the query returns ON.*/ [:SOURce[]]:FREQuency[:FIXed] Syntax [:SOURce[]]:FREQuency[:FIXed] {|MINimum|MAXimum} [:SOURce[]]:FREQuency[:FIXed]? [MINimum|MAXimum] Description Sets the frequency of the waveform of the specified channel.
RIGOL Chapter 2 Command System Parameter Name [] Type Discrete Real Range 1|2 Frequency range of the current waveform of the specified channel Default 1 900 Hz Remarks You can set the sweep boundaries via the center frequency and frequency span ([:SOURce[]]:FREQuency:SPAN). Different sweep waveforms correspond to different center frequency and frequency span ranges. Besides, the center frequency and frequency span are mutually affected.
RIGOL Chapter 2 Command System Remarks Start frequency and stop frequency ([:SOURce[]]: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.
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[]] or [] is omitted, the system sets the related parameters of CH1 by default. The Sine, Square, Ramp, and Arbitrary waveform can generate the sweep output. The range of the stop frequency differs for different sweep waveforms.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:RS232:STOPBit [:SOURce[]]:FUNCtion:SEQuence:EDGETime [:SOURce[]]:FUNCtion:SEQuence:FILTer [:SOURce[]]:FUNCtion:SEQuence:PERiod [:SOURce[]]:FUNCtion:SEQuence:SRATe [:SOURce[]]:FUNCtion:SEQuence[:STATe] [:SOURce[]]:FUNCtion:SEQuence:WAVE [:SOURce[]]:FUNCtion[:SHAPe] [:SOURce[]]:FUNCtion:SQUare:DCYCle [:SOURce[]]:FUNCtion:SQUare:PERiod [:SOURce[]]:FUNCtion:DUALTone:CENTERFreq Syntax [:
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:DUALTone:FREQ1 Syntax [:SOURce[]]:FUNCtion:DUALTone:FREQ1 {|MINimum|MAXimum} [:SOURce[]]: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.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:DUALTone:OFFSETFreq Syntax [:SOURce[]]:FUNCtion:DUALTone:OFFSETFreq {|MINimum|MAXimum} [:SOURce[]]: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 Discrete Real Range 1|2 Refer to "Remarks".
RIGOL Chapter 2 Command System Example :SOUR1:FUNC:PRBS:BRAT 3000 :SOUR1:FUNC:PRBS:BRAT? /*Sets the PRBS bit rate of CH1 to 3 kbps.*/ /*Queries the PRBS bit rate of CH1 and the query returns 3.000000E+03.*/ [:SOURce[]]:FUNCtion:PRBS:DATA Syntax [:SOURce[]]:FUNCtion:PRBS:DATA {PN7|PN9|PN11} [:SOURce[]]:FUNCtion:PRBS:DATA? Description Sets the PRBS data type of the specified channel. Queries the PRBS data type of the specified channel.
RIGOL Chapter 2 Command System Pdcycle ——pulse duty cycle; Pw min ——minimum pulse width; Ppulse ——pulse period. When [:SOURce[]] or [] 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%). Example :SOUR1:FUNC:PULS:DCYC 45 :SOUR1:FUNC:PULS:DCYC? /*Sets the pulse duty cycle of CH1 to 45%.
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%; the fall time is defined as the time required for the pulse amplitude to fall from 90% to 10%. When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default.
RIGOL Chapter 2 Command System Queries the pulse fall time of the specified channel. Parameter Name [] Type Discrete Real Range 1|2 10 ns to (0.625×pulse width) Default 1 20 ns Remarks The fall time is defined as the time required for the pulse amplitude to fall from 90% to 10%. When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. The range of the fall time is limited by the current waveform frequency and pulse width.
RIGOL Chapter 2 Command System Example :SOUR1:FUNC:PULS:WIDT 0.01 :SOUR1:FUNC:PULS:WIDT? /*Sets the pulse width of CH1 to 10 ms (i.g. 0.01 s).*/ /*Queries the pulse width of CH1 and the query returns 1.000000E-02.*/ [:SOURce[]]:FUNCtion:RAMP:SYMMetry Syntax [:SOURce[]]:FUNCtion:RAMP:SYMMetry {|MINimum|MAXimum} [:SOURce[]]:FUNCtion:RAMP:SYMMetry? [MINimum|MAXimum] Description Sets the Ramp symmetry of the specified channel. Queries the Ramp symmetry of the specified channel.
RIGOL Chapter 2 Command System Example :SOUR1:FUNC:RS232:BAUD 9600 :SOUR1:FUNC:RS232:BAUD? /*Sets the RS232 baud rate of CH1 to 9600.*/ /*Queries the RS232 baud rate of CH1 and the query returns 9600.*/ [:SOURce[]]:FUNCtion:RS232:CHECKBit Syntax [:SOURce[]]:FUNCtion:RS232:CHECKBit {NONE|ODD|EVEN} [:SOURce[]]:FUNCtion:RS232:CHECKBit? Description Sets the RS232 check bit of the specified channel. Queries the RS232 check bit of the specified channel.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:RS232:DATABit Syntax [:SOURce[]]:FUNCtion:RS232:DATABit {7|8} [:SOURce[]]:FUNCtion:RS232:DATABit? Description Sets the RS232 data bits of the specified channel. Queries the RS232 data bits of the specified channel. Parameter Name [] {7|8} Type Discrete Discrete Range 1|2 7|8 Default 1 7 Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default. Return Format The query returns 7 or 8.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:SEQuence:EDGETime Syntax [:SOURce[]]:FUNCtion:SEQuence:EDGETime [:SOURce[]]: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 Discrete Real Range 1|2 8 ns to (1/sample rate)/1.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:SEQuence:PERiod Syntax [:SOURce[]]:FUNCtion:SEQuence:PERiod |1|2|3|4|5|6|7|8 |MINimum|MAXimum [:SOURce[]]: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.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:SEQuence[:STATe] Syntax [:SOURce[]]:FUNCtion:SEQuence[:STATe] {ON|1|OFF|0} [:SOURce[]]: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.
RIGOL Chapter 2 Command System ACKMANH|BOHMANWIN|CHEBWIN|FLATTOPWIN|NUTTALLWIN|PARZENWIN|TAYLORWIN|TUKEYWI 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.
RIGOL Chapter 2 Command System Return Format The query returns a string. For example, SQU. Example :SOUR1:FUNC SQU :SOUR1:FUNC? /*Sets the waveform type of CH1 to Square.*/ /*Queries the waveform type of CH1 and the query returns SQU.*/ [:SOURce[]]:FUNCtion:SQUare:DCYCle Syntax [:SOURce[]]:FUNCtion:SQUare:DCYCle {|MINimum|MAXimum} [:SOURce[]]:FUNCtion:SQUare:DCYCle? [MINimum|MAXimum] Description Sets the Square duty cycle of the specified channel.
RIGOL Chapter 2 Command System displays a prompt message and sets the period to the period lower limit of the new waveform type automatically if the period is invalid for the new waveform type. 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 :SOUR1:FUNC:SQU:PER? /*Sets the Square period of CH1 to 1 s.*/ /*Queries the Square period of CH1 and the query returns 1.
RIGOL Chapter 2 Command System [:SOURce[]]:HARMonic:ORDEr Syntax [:SOURce[]]:HARMonic:ORDEr {|MINimum|MAXimum} [:SOURce[]]: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.
RIGOL Example :SOUR1:HARM:PHAS 5,10 :SOUR1:HARM:PHAS? 5 Chapter 2 Command System /*Sets the phase of the fifth order of harmonic of CH1 to 10°.*/ /*Queries the phase of the fifth order of harmonic of CH1 and the query returns 1.000000E+01.*/ [:SOURce[]]:HARMonic[:STATe] Syntax [:SOURce[]]:HARMonic[:STATe] {ON|1|OFF|0} [:SOURce[]]:HARMonic[:STATe]? Description Enables or disables the harmonic function of the specified channel.
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. The output states of the 8 orders of harmonics are represented by 8-bit binary data. The leftmost bit represents the fundamental waveform; it is a fixed X and cannot be modified.
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 [:SOURce[]]:MARKer[:STATe] Syntax [:SOURce[]]:MARKer[:STATe] {ON|1|OFF|0} [:SOURce[]]: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.
RIGOL Chapter 2 Command System [: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. Queries the AM modulation depth of the specified channel. Parameter Name [] Type Discrete Real Range 1|2 0% to 120% Default 1 100% Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default.
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[]] or [] is omitted, the system sets the related parameters of CH1 by default. Return Format The query returns ON or OFF. Example :SOUR1:AM:DSSC ON :SOUR1:AM:DSSC? /*Enables the AM carrier waveform suppression function of CH1.
RIGOL Chapter 2 Command System [: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. Queries the AM modulation waveform of the specified channel.
RIGOL Chapter 2 Command System Return Format The query returns INT or EXT. Example :SOUR1:AM:SOUR EXT :SOUR1:AM:SOUR? /*Sets the AM modulation source of CH1 to external modulation source.*/ /*Queries the AM modulation source of CH1 and the query returns EXT.*/ [:SOURce[]][:MOD]:AM:STATe Syntax [:SOURce[]][:MOD]:AM:STATe {ON|1|OFF|0} [:SOURce[]][:MOD]:AM:STATe? Description Enables or disables the AM modulation function of the specified channel.
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 [:SOURce[]][:MOD]:FM:INTernal:FUNCtion Syntax [:SOURce[]][:MOD]:FM:INTernal:FUNCtion {SINusoid|SQUare|TRIangle|RAMP|NRAMp|NOISe|USER} [:SOURce[]][:MOD]:FM:INTernal:FUNCtion? Description Sets the FM modulation waveform of the specified channel. Queries the FM modulation waveform of the specified channel.
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 INT or EXT. Example :SOUR1:FM:SOUR EXT :SOUR1:FM:SOUR? /*Sets the FM modulation source of CH1 to external modulation source.*/ /*Queries the FM modulation source of CH1 and the query returns EXT.
RIGOL Chapter 2 Command System :SOURce[:MOD]:FSKey Command List: [:SOURce[]][:MOD]:FSKey[:FREQuency] [:SOURce[]][:MOD]:FSKey:INTernal:RATE [:SOURce[]][:MOD]:FSKey:POLarity [:SOURce[]][:MOD]:FSKey:SOURce [:SOURce[]][:MOD]:FSKey:STATe [: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.
RIGOL Chapter 2 Command System Remarks This command is only applicable to the internal modulation source ([:SOURce[]][: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[]][:MOD]:FSKey[:FREQuency]). When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:FSKey:SOURce Syntax [:SOURce[]][:MOD]:FSKey:SOURce {INTernal|EXTernal} [:SOURce[]][: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.
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 Example :SOUR1:PM 50 :SOUR1:PM? /*Sets the PM phase deviation of CH1 to 50°.*/ /*Queries the PM phase deviation of CH1 and the query returns 5.000000E+01.*/ [:SOURce[]][:MOD]:PM:INTernal:FREQuency Syntax [:SOURce[]][:MOD]:PM:INTernal:FREQuency {|MINimum|MAXimum} [:SOURce[]][:MOD]:PM:INTernal:FREQuency? [MINimum|MAXimum] Description Sets the PM modulation frequency of the specified channel. Queries the PM modulation frequency of the specified channel.
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.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:PM:STATe Syntax [:SOURce[]][:MOD]:PM:STATe {ON|1|OFF|0} [:SOURce[]][: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.
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:PSKey:INTernal:RATE Syntax [:SOURce[]][:MOD]:PSKey:INTernal:RATE {|MINimum|MAXimum} [:SOURce[]][: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.
RIGOL Chapter 2 Command System Example :SOUR1:PSK:PHAS 90 :SOUR1:PSK:PHAS? /*Sets the PSK modulation phase of CH1 to 90°.*/ /*Queries the PSK modulation phase of CH1 and the query returns 9.000000E+01.*/ [:SOURce[]][:MOD]:PSKey:POLarity Syntax [:SOURce[]][:MOD]:PSKey:POLarity {POSitive|NEGative} [:SOURce[]][:MOD]:PSKey:POLarity? Description Sets the PSK modulation polarity of the specified channel to Positive (POSitive) or Negative (NEGative).
RIGOL Chapter 2 Command System Remarks DG900 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" ([:SOURce[]][:MOD]:PSKey:PHASe) is determined by the modulation rate ([:SOURce[]][:MOD]:PSKey:INTernal:RATE).
RIGOL Chapter 2 Command System :SOURce[:MOD]:PWM Command List: [:SOURce[]][:MOD]:PWM[:DEViation]:DCYCle [:SOURce[]][:MOD]:PWM[:DEViation][:WIDTh] [:SOURce[]][:MOD]:PWM:INTernal:FREQuency [:SOURce[]][:MOD]:PWM:INTernal:FUNCtion [:SOURce[]][:MOD]:PWM:SOURce [:SOURce[]][:MOD]:PWM:STATe [:SOURce[]][:MOD]:PWM[:DEViation]:DCYCle Syntax [:SOURce[]][:MOD]:PWM[:DEViation]:DCYCle {|MINimum|MAXimum} [:SOURce[]][:MOD]:PWM[:DEViation]:DCYCle? [MINimum|MAXimum
RIGOL Chapter 2 Command System [:SOURce[]][:MOD]:PWM[:DEViation][:WIDTh] Syntax [:SOURce[]][:MOD]:PWM[:DEViation][:WIDTh] {|MINimum|MAXimum} [:SOURce[]][: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 Discrete Real Range 1|2 Refer to "Remarks".
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 :SOUR1:PWM:INT:FREQ? /*Sets the PWM modulation frequency of CH1 to 150 Hz.*/ /*Queries the PWM modulation frequency of CH1 and the query returns 1.500000E+02.
RIGOL Chapter 2 Command System Parameter Name [] {INTernal|EXTernal} Type Discrete Discrete Range 1|2 INTernal|EXTernal Default 1 INTernal Remarks DG900 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, TRIangle, RAMP, NRAMp, NOISe, or USER. The default is SINusoid. NOISe can be used as the modulation waveform but cannot be used as carrier waveform.
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.
RIGOL Chapter 2 Command System [:SOURce[]]:MOD:TYPe Syntax [:SOURce[]]:MOD:TYPe {AM|FM|PM|ASK|FSK|PSK|PWM} [:SOURce[]]:MOD:TYPe? Description Sets the modulation type of the specified channel. Queries the modulation type of the specified channel. Parameter Name [] {AM|FM|PM|ASK|FSK|PSK|PWM} Type Discrete Discrete Range 1|2 AM|FM|PM|ASK|FSK|PSK|PWM Default 1 AM Remarks When [:SOURce[]] or [] is omitted, the system sets the related parameters of CH1 by default.
RIGOL Chapter 2 Command System :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. Queries 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 DG900 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 Chapter 2 Command System Parameter Name [] 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.
Chapter 2 Command System RIGOL :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 Chapter 2 Command System Example :SYST:CHAN:CUR CH2 :SYST:CHAN:CUR? /*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 Parameter Name
Chapter 2 Command System 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: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 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.
RIGOL Chapter 2 Command System :SYSTem:CSCopy Syntax :SYSTem:CSCopy , 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 Discrete Range CH1|CH2 Default None Remarks The two parameters cannot be the same. That is, , can be set to CH1,CH2 or CH2,CH1.
RIGOL Chapter 2 Command System Parameter Name {ON|1|OFF|0} Type Discrete Bool Range Refer to "Remarks".
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 {ON|1|OFF|0} Type Bool Range ON|1|OFF|0 Default ON Return Format The query returns ON or OFF. Example :SYST:LOG 1 :SYST:LOG? /*Enables the system log.
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.
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.
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.
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 DG992 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 "DG900_Demo_Excel.xlsm". 2. Run the DG900_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:\DG900_Demo_Matlab. 2. Click File New Blank M-File in the Matlab interface to create an empty M file. 3.
Chapter 4 Programming Examples DG900 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 DG900_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 DG900 Programming Guide RIGOL 4-11
RIGOL Chapter 4 Programming Examples (2) Write operation (including error confirmation): (3) Read operation (including error processing): 4-12 DG900 Programming Guide
Chapter 4 Programming Examples DG900 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 "DG900_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 "DG900_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 } 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 void CDG900_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 CDG900_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 DG900 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) DG900 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.
