Specifications

ManualsBrandsRigol ManualsPortable GeneratorDG10X2 Series

RIGOL

Programming Guide

DG10X2 Function/Arbitrary

Waveform Generator

DG1012: 15MHz

DG1022: 20MHz

Feb. 2009

RIGOL Technologies, Inc.

Summary of content (92 pages)

PAGE 1
RIGOL Programming Guide DG10X2 Function/Arbitrary Waveform Generator DG1012: 15MHz DG1022: 20MHz Feb. 2009 RIGOL Technologies, Inc.
PAGE 2
PAGE 3
RIGOL Copyright © 2009 RIGOL Technologies, Inc. All Rights Reserved. Trademark Information RIGOL is registered trademark of RIGOL Technologies, Inc. Notices RIGOL products are protected by patent law in and outside of P.R. China. RIGOL Technologies, Inc. reserves the right to modify or change part of or all the specifications and pricing policies at company’s sole decision. Information in this publication replaces all previously corresponding material.
PAGE 4
RIGOL Structure of this Document Chapter 1 Programming Overview This chapter introduces you how to programme DG10X2 generator using commands and how to input the commands in right format. Chapter 2 DG10X2 Commands System This chapter gives detailed information on each command supported by DG10X2, including command format, function description, considerations when using command as well as some application examples.
PAGE 5
RIGOL Table of Contents Chapter 1 Programming Overview ........................................................... 1-1 Communication Interfaces.......................................................................... 1-2 Commands Introduction............................................................................. 1-3 Commands Format.............................................................................. 1-3 Symbol Instruction .....................................................................
PAGE 6
RIGOL Example Example Example Example 6: 7: 8: 9: To generate a burst via CH1 ..................................................... 3-8 To output waves via dual channels ............................................ 3-9 Channel Coupling ................................................................... 3-10 Channel Copy ........................................................................ 3-11 Appendix: Commands Reference A-Z ..........................................................
PAGE 7
Programming Overview RIGOL Chapter 1 Programming Overview This chapter introduces you how to programme DG10X2 generator using commands and how to input commands in right format.
PAGE 8
RIGOL Programming Overview Communication Interfaces Computers communicate with the generator by sending and receiving messages over an USB interface. Command word is sended and identified in the form of ASCII character strings for users to easily control and do user-defined development. Operations that you can do with a computer and a generator include:  Set the generator.  Output waveforms from the generator.
PAGE 9
Programming Overview RIGOL Commands Introduction Commands Format The commands system of DG10X2 is a tree structure, and each of sub-system is consists of a “root” keyword and multilayered keywords. The keywords are separated by “:” and aoptional parameters are permitted to follow; “?” appeared following a command line denotes to query this function; besides, “space” is used to divide command and parameter.
PAGE 10
RIGOL Programming Overview Symbol Instruction Following symbols are not included in commands, but whichi are usually used to assist to explain the parameters containd in a command line. 1. Braces { } The parameters or contents enclosed in a { } are reqired. Only one content or parameter could be selected every time, and all the options are separated by “|”. For example: {ON|OFF} indicateds that ON or OFF can be selected. 2.
PAGE 11
Programming Overview RIGOL Parameter Types The commands contain 5 kinds of parameters, different parameters have different setting methods. 1. Boolean Parameters The parameters could be “OFF”, “ON” or “0”, “1”, for example: AM:STATE {OFF|ON} “OFF” denotes disable AM function. “On” denotes enable. 2. Consecutive Integer Parameters The parameters could be a consecutive integer, for example: DISPlay:CONTRAST could be an integer between 0 and 31(including 0 and 31). 3.
PAGE 12
RIGOL Programming Overview Commands Abbreviation All the comands are case-insensitive, so you can use any kind of them. But if use abbreviation, the capital letters specified in commands must be written completely.
PAGE 13
DG10X2 Commands System RIGOL Chapter 2 DG10X2 Commands System This chapter gives detailed information on each command supported by DG10X2, including command format, function description, using considerations as well as some application examples. DG10X2 contains following subcommands systems:                     IEEE 488.
PAGE 14
DG10X2 Commands System RIGOL IEEE 488.2 IEEE standard has some common commands for querying some basic information about instrument or executing, which usually begins with “*” and holds 3-character long command keyword. DG10X2 supports following IEEE488.2 commands: 1. 1. *IDN? *IDN? Command Format *IDN? Function Query ID character string of instrument, including a field separated by 4 “,”, manufactory, model, serial number and the edition number that consists of numbers and separated by “.” .
PAGE 15
DG10X2 Commands System RIGOL APPLy APPLy commands provide the most straightforward method to program the generator over remote interface. Among following commands, the instrument could set and output waveforms if OUTPUT function is enable. DG10X2 supports following APPLy commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16.
PAGE 16
DG10X2 Commands System RIGOL 2. APPLy:SQUare Command Format APPLy:SQUare [[,[,]]] Function Generate a square wave with specific frequency, amplitude and DC offset via CH1 and cover the current duty cycle settings and select 50% automaticly. Explanations   Example 3. If the parameters you set are less than three, the sequence would be: , , . The default units of , , are: Hz, Vpp, VDC. APPL:SQU 1000,5.
PAGE 17
DG10X2 Commands System RIGOL Format Function Generate Gaussian noise with specific amplitude and DC offset. Explanations    Example 6. Although the frequency parameter made no impression on this command, a value or “DEFault” must be specified. (noise function has 5MHz of bandwidth) If the parameters you set are less than three, the sequence would be: , , . The default units of , , are: Hz, Vpp, VDC. APPL:NOIS DEF,5.0,2.
PAGE 18
DG10X2 Commands System RIGOL Command Format APPLy? Function Query the current configuration of CH1 and the type of waves outputted. Explanations The query returns a character string with double quotation marks, including function, frequency, amplitude and offset. Example CH1:"SIN,1.000000e+03,5.000000e+00,-1.500000e+00" 9.
PAGE 19
DG10X2 Commands System Explanations   Example RIGOL If the parameters you set are less than three, the sequence would be: , , . The default units of , , are: Hz, Vpp, VDC. APPL:RAMP:CH2 1000,5.0,0.5 12. APPLy:PULSe:CH2 Command Format APPLy:PULSe:CH2 [[,[,]]] Function Generate a pulse wave with specific frequency, amplitude and DC offset via CH2.
PAGE 20
DG10X2 Commands System RIGOL   Example impression on this command, a value or “DEFault” must be specified. If the parameters you set are less than three, the sequence would be: , , . The default units of , , are: Hz, Vpp, VDC. APPL:DC:CH2 DEF,DEF,1.5 15.
PAGE 21
DG10X2 Commands System RIGOL FUNCtion FUNCtion commands are used for setting the output function and their parameters; selecting carrier wave function in modulation mode; choosing any one from 48 built-in arbitrary waveforms and 10 user-defined waveforms, or the waveform downloaded to volatile memory currently. DG10X2 supports following FUNCtion commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16.
PAGE 22
DG10X2 Commands System RIGOL Function Query the output function from CH1. Explanations The query always returns CH1:ARB after sending FUNC DC or FUNC USER. Example The query returns CH1:SIN, CH1:SQU, CH1:RAMP, CH1:PULS, CH1:NOIS or CH1:ARB, the default is CH1:SIN. 3.
PAGE 23
DG10X2 Commands System RIGOL user-defined wave in nonvolatile memory. The default is EXP_RISE. 5. FUNCtion:SQUare:DCYCle Command Format FUNCtion:SQUare:DCYCle {|MINimum|MAXimum} Function Set the duty cycle of square wave for CH1. Explanations is the percent of duty cycle selected, MIN is the minimum duty cycle and MAX is the maximum. Example FUNC:SQU:DCYC 50 6.
PAGE 24
DG10X2 Commands System RIGOL still DC. Example FUNC:CH2 SIN 10. FUNCtion:CH2? Command Format FUNCtion:CH2? Function Query the output function from CH2. Explanations The query always returns CH2:ARB after sending FUNC:CH2 DC or FUNC:CH2 USER. Example The query returns CH2:SIN, CH2:SQU, CH2:RAMP, CH2:PULS, CH2:NOIS or CH2:ARB, the default is CH2:SIN. 11.
PAGE 25
DG10X2 Commands System RIGOL 12. FUNCtion:USER:CH2? Command Format FUNCtion:USER:CH2? Function Query the name of arbitrary wave generated from CH2. Return Value The query returns the name of built-in arbitrary wave that has been selected. (such as EXP_RISE), VOLATILE or returns any name of user-defined wave in nonvolatile memory. The default is EXP_RISE. 13.
PAGE 26
DG10X2 Commands System RIGOL FREQuency FREQuency commands are used for setting: the frequency of output function from dual channels; the start frequency, the center frequency or the span frequency in sweep mode, the carrier frequency in modulation. Sweep and modulation are only valid for CH1. DG10X2 supports following FREQuency commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12.
PAGE 27
DG10X2 Commands System Return Value 3. RIGOL The query returns the frequency value that has been set in the form of scientific notation in Hz, such as: 1.000000e-06. FREQuency:CH2 Command Format FREQuency:CH2 {|MINimum|MAXimum} Function Set the frequency of output function for CH2. Explanations is the frequency value set by user, the default unit is Hz. MIN is the minimum frequency permitted by specified function, MAX is the maxmum. Example FREQ:CH2 MIN 4.
PAGE 28
DG10X2 Commands System RIGOL in sweep mode. Example 8. FREQ:STOP MAX FREQuency:STOP? Command Format FREQuency:STOP? [MINimum|MAXimum] Function Query the stop frequency in sweep mode. Return Value The query returns the stop frequency that has been set in the form of scientific notation in Hz, such as: 2.000000e+07. 9. FREQuency:CENTer Command Format FREQuency:CENTer {|MINimum|MAXimum} Function Set the center frequency (used in conjunction with span frequency) in sweep mode.
PAGE 29
DG10X2 Commands System RIGOL VOLTage VOLTage commands are used for setting the voltage amplitude, offset, high level, low level, or setting the voltage unit for each channel. DG10X2 supports following VOLTage commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20.
PAGE 30
DG10X2 Commands System RIGOL VOLTage:UNIT. Example 2. VOLT MIN VOLTage? Command Format VOLTage? Function Query the amplitude from CH1. Return Value The query returns the amplitude that has been set in the form of scientific notation such as: 4.000000e-03. 3. VOLTage:HIGH Command Format VOLTage:HIGH {|MINimum|MAXimum} Function Set the high level of waves from CH1 in Vpp. Explanations is the high level for user to set. MIN selects the minimum high level.
PAGE 31
DG10X2 Commands System Return Value 7. RIGOL The query returns the low level that has been set in the form of scientific notation such as: -1.000000e+01. VOLTage:OFFSet Command Format VOLTage:OFFSet {|MINimum|MAXimum} Function Set the offset voltage of CH1 in VDC. Explanations < offset >is the offset voltage for user to set. MIN selects the minimum DC offset voltage for specified function and amplitude. MAX selects the maximum value. Example VOLT:OFFS MIN 8.
PAGE 32
DG10X2 Commands System RIGOL amplitude for the selected function. Example VPP, VRMS or DBM. Note that DBM could be used only in non-high resistance. The unit of voltage could be changed via sending VOLTage:UNIT:CH2. Command Format VOLT:CH2 MIN 12. VOLTage:CH2? Command Format VOLTage:CH2? Function Query the amplitude of CH2. Return Value The query returns the amplitude that has been set in the form of scientific notation such as: CH2: 4.000000e-03. 13.
PAGE 33
DG10X2 Commands System RIGOL 16. VOLTage:LOW:CH2? Command Format VOLTage:LOW:CH2? Function Query the low level of waves from CH2. Return Value The query returns the low leve that has been set in the form of scientific notation such as: -1.500000e+00. 17. VOLTage:OFFSet:CH2 Command Format VOLTage:OFFSet:CH2 {|MINimum|MAXimum} Function Set the offset voltage from CH2 in VDC. Explanations is the offset voltage for user to set.
PAGE 34
DG10X2 Commands System RIGOL OUTPut OUTPut commands are used for setting the output parameters, such as: the output switch, the output loads, the polarity of the waveform, the synchronous output signal and the trigger output from CH1. DG10X2 supports following OUTPut commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18.
PAGE 35
DG10X2 Commands System RIGOL Format Function Query the state of the [Output] connector on the front panel. Return Value The query returns OFF or ON. 3. OUTPut:LOAD Command Format OUTPut:LOAD {|INFinity|MINimum|MAXimum} Function Select the desired output termination of CH1. The specified value is only used for amplitude and offset voltage. Explanations   Example OUTP:LOAD 50 4. Ω is the unit of , the default is 50Ω. “INFinity” sets the output terminal as “High Z”.
PAGE 36
DG10X2 Commands System RIGOL Explanations The signal could be output synchronously only from CH1. Example OUTP:SYNC OFF 8. OUTPut:SYNC? Command Format OUTPut:SYNC? Function Query the state of the [Sync Out] connector of CH1 on the rear panel. The default is “OFF”. Return Value The query returns SYNC OFF or SYNC ON. 9. OUTPut:TRIGger:SLOPe Command Format OUTPut:TRIGger:SLOPe {POSitive|NEGative} Function Select the edge of “tirgger output”.
PAGE 37
DG10X2 Commands System RIGOL Format Function Query the state of the [Ext Trig/FSK/Burst] connector on rear panel. Return Value The query returns OFF or ON. 13. OUTPut:CH2 Command Format OUTPut:CH2 {OFF|ON} Function Disable or enable the front-panel [Output] connector of CH2. Example OUTP:CH2 ON 14. OUTPut:CH2? Command Format OUTPut:CH2? Function Query the state of front-panel [Output] connector of CH2. Return Value The query returns OFF or ON. 15.
PAGE 38
DG10X2 Commands System RIGOL 18. OUTPut:POLarity:CH2? Command Format OUTPut:POLarity:CH2? Function Query the polarity of waveform from CH2. Return Value The query returns NORM or INV.
PAGE 39
DG10X2 Commands System RIGOL PULSe PULSe commands are used for configuring the parameters of pulse waves from dual channels such as: period, pulse width, duty cycle and others. Following figure is going to help you comprehend the parameters about pulse wave. 90% 90% 50% 50% Pulse Width 10% 10% Rise Time Period Fall Time DG10X2 supports following PULSe commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12.
PAGE 40
DG10X2 Commands System RIGOL 2. PULSe:PERiod? Command Format PULSe:PERiod? [MINimum|MAXimum] Function Query the period of pulse from CH1. Return Value The query returns the period of pulse in the form of scientific notation and in seconds, such as: 1.000000e-02. 3. PULSe:WIDTh Command Format PULSe:WIDTh {|MINimum|MAXimum} Function Set the width of pulse for CH1 in seconds. Example PULS:WIDT 0.005 4.
PAGE 41
DG10X2 Commands System Example 8. RIGOL PULS:PER:CH2 0.01 PULSe:PERiod:CH2? Command Format PULSe:PERiod:CH2? [MINimum|MAXimum] Function Query the period of pulse from CH2. Return Value The qurey returns the period of pulse in the form of scientific notation and in seconds, such as: 1.000000e-02. 9. PULSe:WIDTh:CH2 Command Format PULSe:WIDTh:CH2 {|MINimum|MAXimum} Function Set the pulse width for CH2 in seconds. Example PULS:WIDT:CH2 0.005 10.
PAGE 42
DG10X2 Commands System RIGOL AM In AM, the amplitude of carrier is varies with the instantaneous voltage of the modulation waveform. Among CH1, the generator can generate AM modulation waves. In addition, AM commands could be used for these settings: modulation source, modulation waveform, modulation frequency, modulation depth and AM modulation state. DG10X2 supports following AM commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 43
DG10X2 Commands System RIGOL Format {SINusoid|SQUare|RAMP|NRAMp|TRIangle|NOISe|USER} Function Select the internal modulation source of AM. Explanations In internal modulation source mode, the modulation wave could be sine, square, ramp, negative ramp, triangle, noise or arbitrary wave, the default is sine. Example AM:INT:FUNC SQU 4. AM:INTernal:FUNCtion? Command Format AM:INTernal:FUNCtion? Function Query the internal modulation wave of AM that has been selected.
PAGE 44
DG10X2 Commands System RIGOL Format Function Query the depth of internal modulation of AM. Return Value The qurey returns the percent of the depth of AM internal modulation in the form of scientific notation, such as: 7.000000e+01. 9. AM:STATe Command Format AM:STATe {OFF|ON} Function Disable or enable AM function. Example AM:STAT OFF 10. AM:STATe? Command Format AM:STATe? Function Query the modulation state of AM. Return Value The query returns OFF or ON.
PAGE 45
DG10X2 Commands System RIGOL FM In FM, the frequency of carrier is varies with the instantaneous voltage of the modulation waveform. Among CH1, the generator can generate FM modulated waves. In addition, FM commands could be used for these settings: modulation source, modulation waveform, modulation frequency, frequency deviation of peak value and FM modulation state. DG10X2 supports following FM commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 46
DG10X2 Commands System RIGOL Format {SINusoid|SQUare|RAMP|NRAMp|TRIangle|NOISe|USER} Function Select the internal modulation wave of FM. Explanations In internal modulation source mode, the modulation wave could be sine, square, ramp, negative ramp, triangle, noise or arbitrary wave, the default is sine. Example FM:INT:FUNC SQU 4. FM:INTernal:FUNCtion? Command Format FM:INTernal:FUNCtion? Function Query the internal modulation wave of FM that has been selected.
PAGE 47
DG10X2 Commands System RIGOL Function Query the frequency deviation of peak value of FM. Return Value The query returns the frequency deviation of peak value of FM in the form of scientific notation and in Hz, such as: 1.000000e+02 9. FM:STATe Command Format FM:STATe {OFF|ON} Function Disable or enable FM function. Example FM:STAT OFF 10. FM:STATe? Command Format FM:STATe? Function Query the modulation state of FM. Return Value The query returns OFF or ON.
PAGE 48
DG10X2 Commands System RIGOL PM In PM, the phase of carrier is varies with the instantaneous voltage of the modulation waveform. Among CH1, the generator can generate PM modulation waves. In addition, PM commands could be used for these settings: modulation source, modulation waveform, modulation frequency, phase deviation and PM modulation state. DG10X2 supports following PM commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 49
DG10X2 Commands System RIGOL Function Select the internal modulation wave of PM. Explanations In internal modulation source mode, the modulation wave could be sine, square, ramp, negative ramp, triangle, noise or arbitrary wave, the default is sine. Example PM:INT:FUNC SQU 4. PM:INTernal:FUNCtion? Command Format PM:INTernal:FUNCtion? Function Query the internal modulation wave of PM that has been selected. Return Value The query returns SIN, SQU, RAMP, NRAM, TRI, NOIS or USER. 5.
PAGE 50
DG10X2 Commands System RIGOL Return Value 9. The query returns the phase deviation of PM in the form of scientific notation in degree, such as: 1.800000e+02. PM:STATe Command Format PM:STATe {OFF|ON} Function Disable or enable PM function. Example PM:STAT OFF 10. PM:STATe? Command Format PM:STATe? Function Query the modulation state of PM. Return Value The query returns OFF or ON.
PAGE 51
DG10X2 Commands System RIGOL FSKey In FSK modulation, you can configure the generator to “shift” its output frequency between two preset frequencies (called the “carrier frequency” and the “hop frequency”) from CH1. The output frequency that shifts from the carrier frequency to the hop frequency is called “FSK rate”. FSK rate is determined by internal frequency generator or signal level which is inputted from the [Ext Trig/FSK/Burst] connector on the rear panel.
PAGE 52
DG10X2 Commands System RIGOL 3. FSK:FREQuency Command Format FSK:FREQuency {|MINimum|MAXimum} Function Set the hop frequency of FSK in Hz. Example FSK:FREQ 10 4. FSK:FREQuency? Command Format FSK:FREQuency? Function Query the frequency hopping rate of FSK. Return Value The query returns the frequency hopping rate of FSK in the form of scientific notation, such as: 1.000000e+01. 5.
PAGE 53
DG10X2 Commands System RIGOL Format Function Query the modulation state of FSK. Return Value The query returns OFF or ON.
PAGE 54
DG10X2 Commands System RIGOL SWEep In frequency sweep mode, the generator “steps” from the start frequency to the stop frequency at a sweep rate that you specified. You can sweep up or down in frequency, and with either linear or logarithmic spacing. In addition, you can configure the generator to output a single sweep (one pass from start frequency to stop frequency) by applying an external or manual trigger.
PAGE 55
DG10X2 Commands System RIGOL Function Set the sweep time expected from the start frequency to the stop frequency, the default time is 1 s. Explanations is the sweep time, the unit is s. MIN=1ms, MAX 500s Example SWE:TIME 10 4. SWEep:TIME? Command Format SWEep:TIME? Function Query the sweep time expected from the start frequency to the stop frequency. Return Value The query returns the sweep time in the form of scientific notation in seconds such as: 1.000000e+01. 5.
PAGE 56
DG10X2 Commands System RIGOL TRIGger TRIGger commands are available in Sweep and Burst mode for CH1 only. DG10X2 supports following TRIGger commands: 1. 2. 3. 4. 5. 6. TRIGger:SOURce TRIGger:SOURce? TRIGger:SLOPe TRIGger:SLOPe? TRIGger:DELay TRIGger:DELay? The detailed information of each command are: 1.
PAGE 57
DG10X2 Commands System RIGOL Explanations This command could be used only when OUTPut:TRIGger is enabled. Example TRIG:SLOP POS 4. TRIGger:SLOPe? Command Format TRIGger:SLOPe? Function Query the edge of trigger signal that has been selected. Return Value The query returns POSITIVE or NEGATIVE. 5. TRIGger:DELay Command Format TRIGger:DELay {|MINimum|MAXimum} Function Set the trigger delay in seconds. Note: this command is only applied to Burst mode. Example TRIG:DEL 0.000005 6.
PAGE 58
DG10X2 Commands System RIGOL BURSt BURSt commands are used for setting the generator to output pulse sequence(called burst) with specified cycles. Among CH1, burst could be generated based on sine, square, ramp, burst or arbitrary waves. DG10X2 supports following BURSt commands:DG10X2: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12.
PAGE 59
DG10X2 Commands System RIGOL Format Function Query the burst mode. Return Value The query returns TRIG or GAT. 3. BURSt:NCYCles Command Format BURSt:NCYCles {|INFinity|MINimum|MAXimum} Function Set the cycle number of burst (only used in TRIG mode). Explanations   Example BURS:NCYC 100 4. is the cycle number for user to set. MIN=1 cycle, MAX=50,000 cycles, INF is infinite number of cycles.
PAGE 60
DG10X2 Commands System RIGOL Format Function Set the initial phase of burst. Explanations   Example BURS:PHAS 150 8. is the phase for user to set, the unit is degree. MIN=-180°, MAX=180°. BURSt:PHASe? Command Format BURSt:PHASe? [MINimum|MAXimum] Function Query the initial phase of burst. Return Value The query returns the initial phase of burst in the form of scientific notation in degree such as: 1.500000e+02. 9.
PAGE 61
DG10X2 Commands System RIGOL DATA DATA commands are usd for editing or saving arbitrary waves and outputing those waves via CH1. You can store ten user-defined waveforms at most in non-volatile memory in addition to one in volatile memory. Each waveform can contain data points within 1 and 524,288 (512k). DG10X2 supports following DATA commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 62
DG10X2 Commands System RIGOL to memory. Example 2. DATA VOLATILE,1,0.67,0.33,0,-0.33,-0.67,-1 DATA:DAC Command Format DATA:DAC VOLATILE,, , . . . Function Download decimal integer values from 0 to 16383 into volatile memory. Explanations  DATA:DAC command may cover a previous waveform in volatile memory ( does not generate error).  Use DATA:COPY command to copy the waveform to non-volatile memory.
PAGE 63
DG10X2 Commands System RIGOL stored in volatile and non-volatile memory. Example 4. DATA:COPY a1,VOLATILE DATA:DELete Command Format DATA:DELete Function Delete the specified arbitrary waveform from either volatile memory or non-volatile memory. Example DATA:DEL a1 5. DATA:CATalog? Command Format DATA:CATalog? Function Query the names of all waveforms currently available for selection.
PAGE 64
DG10X2 Commands System RIGOL Format Function Query the number of non-volatile memory that is available for saving user-defined waveforms. Return Value The query returns 0 (denotes full memory), 1, 2, 3, 4, 5, 6, 7, 8, 9, 10. 9. DATA:ATTRibute:POINts? Command Format DATA:ATTRibute:POINts? Function Query the number of points in the specified arbitrary waveform. Return Value The query return a value within 0~524,288, such as 4096. 10.
PAGE 65
DG10X2 Commands System RIGOL MEMory The generator has 10 storage locations in non-volatile memory (STATE1~ STATE10) to store instrument states. The locations are numbered from 0 to 10. The generator automatically uses location “0” to hold the state of the instrument when power down. You can also assign a user-defined name to each of the locations (1 through 10) from the front panel. DG10X2 supports following MEMory commands: 1. 2. 3. 4. 5. 6. 7.
PAGE 66
DG10X2 Commands System RIGOL Example 4. MEM:STAT:DEL 1 MEMory:STATe:RECall:AUTO Command Format MEMory:STATe:RECall:AUTO {OFF| ON} Function Disable or enable the automatic recall of the power-down state from storage location “0” when power on. Select “ON” to automatically recall power-down state when power on and select “OFF” (default) to issue a reset. Example MEM:STAT:REC:AUTO OFF 5.
PAGE 67
DG10X2 Commands System RIGOL SYSTem SYSTem commands provide information about state storage, power-down recall, error state and screen control of the front panel and other information about the instrument. DG10X2 supports following SYSTem commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. SYSTem:ERRor? SYSTem:VERSion? SYSTem:BEEPer:STATe SYSTem:BEEPer:STATe? SYSTem:LOCal SYSTem:RWLock SYSTem:REMote SYSTem:CLKSRC SYSTem:LANGuage The detailed information of each command are: 1.
PAGE 68
DG10X2 Commands System RIGOL Function Enable or disable the beep when error occurs on front panel or remote interface. Example SYST:BEEP:STAT OFF 4. SYSTem:BEEPer:STATe? Command Format SYSTem:BEEPer:STATe? Function Query the state of beeper. Return Value The query returns 0 (OFF) or 1 (ON). 5. SYSTem:LOCal Command Format SYSTem:LOCal Function Activate local state and delete RMT indicator and unlock the front panel. 6.
PAGE 69
DG10X2 Commands System 9. RIGOL SYSTem:LANGuage Command Format SYSTem:LANGuage {CHINESE|ENGLISH} Function Select the system language as Chinese or English.
PAGE 70
DG10X2 Commands System RIGOL PHASe PHASe commands are used for setting the initial phase of signals from each channel and controlling the dual channels phase output synchronously. DG10X2 supports following PHASe commands: 1. 2. 3. 4. 5. PHASe PHASe? PHASe:CH2 PHASe:CH2? PHASe:ALIGN The detailed information of each command are: 1. PHASe Command Format PHASe {|MINimum|MAXimum} Function Set the initial phase of signals from CH1.
PAGE 71
DG10X2 Commands System 4. RIGOL PHASe:CH2? Command Format PHASe:CH2? [MINimum|MAXimum] Function Query the initial phase of signals from CH2. Return Value The query returns any numerical value between -180 and 180, such as: 90.000. 5. PHASe:ALIGN Command Format PHASe:ALIGN Function Enable the dual channels output phase synchronously.
PAGE 72
DG10X2 Commands System RIGOL DISPlay DISPlay commands are used for controlling the display of front panel. DG10X2 supports following DISPlay commands: 1. 2. 3. 4. DISPlay DISPlay? DISPlay:CONTRAST DISPlay:LUMInance The detailed information of each command are: 1. DISPlay Command Format DISPlay {OFF|ON} Function Enable or disable the display function of front panel. Example DISP OFF 2. DISPlay? Command Format DISPlay? Function Query the state of screen.
PAGE 73
DG10X2 Commands System RIGOL COUPling COUPling commands are used for channel coupling or copying. DG10X2 supports following COUPling commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. COUPling COUPling? COUPling:BASEdchannel COUPling:BASEdchannel? COUPling:PHASEDEViation COUPling:PHASEDEViation? COUPling:FREQDEViation COUPling:FREQDEViation? COUPling:CHANNCopy The detailed information of each command are: 1. COUPling Command Format COUPling {OFF|ON} Function Enable or disable coupling function.
PAGE 74
DG10X2 Commands System RIGOL Command Format COUPling:BASEdchannel? Function Query the base channe that has been selected. Return Value The query returns CH1 or CH2. 5. COUPling:PHASEDEViation Command Format COUPling:PHASEDEViation Function Set the phase deviation, the unit is degree. Explanations : -180°~180° Example COUP:PHASEDEV 10 6. COUPling:PHASEDEViation? Command Format COUPling:PHASEDEViation? Function Query the phase deviation.
PAGE 75
DG10X2 Commands System Example RIGOL COUP:CHANNC 1>2 Programming Guide for DG10X2 2-63
PAGE 76
PAGE 77
Application Examples RIGOL Chapter 3 Application Examples This chapter shows you how to realize the examples in DG10X2 User’s Guide via command lines, you can compare with the user’s Guide and get deeper understand for the usage of commands. The numbers before every command line in these examples are not the contents of command, also for the contents enclosed in “ / * ” and “ * / ” behind every command line, which are used to assist user to understand the command well.
PAGE 78
RIGOL Application Examples Example 1: To generate a sine wave via CH1 Target: Generate a sine wave with 20 kHz of frequency, 2.5 Vpp of amplitude, 500mVDC offset and 10 of phase via CH1. How to realize via commands? Method1: 0 1 2 3 4 *IDN? VOLT:UNIT VPP APPL:SIN 20000,2.5,0.
PAGE 79
Application Examples RIGOL Example 2: To generate a built-in arbitrary wave via CH1 Target: Generate an ExpRise wave with 2MHz of frequency, 5VRMS of amplitude, 10mVDC offset and 60° of phase via CH1. How to realize via commands? 0 1 2 3 4 5 6 7 *IDN? FUNC:USER EXP_RISE FREQ 2000000 VOLT:UNIT VRMS VOLT 5 VOLT:OFFS 0.
PAGE 80
Application Examples RIGOL Example 3: To generate an user-defined arbitrary wave via CH1 Target: Generate a ramp wave with 10μs of period, 4V of high level and -4V of low level. Vpp 4 2 0 2.5 5 7.5 10 μs -2 -4 The vertical resolution of user-defined arbitrary wave is 14 bits, the value from 0 to 16383 separately corresponds to the minmum and maximum amplitude, that is: -4 V corresponds to 0, 0 V corresponds to 8192 and 4 V corresponds to 16383. So, edit the points in following table is enough.
PAGE 81
Application Examples RIGOL /*Load the 4 decimal numbers to volatile 7 8 memory */ FUNC:USER VOLATILE OUTP ON panel */ Programming Guide for DG10X2 /*Output the waves in volatile memory */ /* Enable the [Output] connector of CH1 at front 3-5
PAGE 82
RIGOL Application Examples Example 4: To generate a FSK wave via CH1 Target: Generate a FSK wave with: 10 kHz, 5 Vpp, 0 VDC of carrier, internal modulation source, 800 Hz of hop frequency and 200 Hz of FSK rate. How to realize via commands? 0 1 2 3 4 5 6 7 8 9 10 3-6 *IDN? FUNC SIN FREQ 10000 VOLT:UNIT VPP VOLT 2.
PAGE 83
Application Examples RIGOL Example 5: To generate a linear sweep wave via CH1 Target: Generate a sweep sine wave with: 100 Hz ~ 10 kHz of frequency range, internal trigger, linear mode and 1 s of sweep time.
PAGE 84
Application Examples RIGOL Example 6: To generate a burst via CH1 Target: Generate a burst with: 3-cycle of square, 0° of initial phase, 10 ms of burst period and adopt internal trigger. How to realize via commands? 0 1 2 3 4 5 6 7 8 3-8 *IDN? FUNC SQU BURS:STAT ON BURS:MODE TRIG BURS:NCYC 3 BURS:PHAS 0 BURS:INT:PER 0.
PAGE 85
Application Examples RIGOL Example 7: To output waves via dual channels Target: Output a sine wave with 1kHz, 2.5Vpp, 500mVDC, 10° via CH1 and a ramp wave with 1.5kHz, 5Vpp, 1 VDC, 20° via CH2. How to realize via commands? 0 1 2 3 4 5 6 7 8 9 *IDN? VOLT:UNIT VPP APPL:SIN 1000,2.5,0.
PAGE 86
Application Examples RIGOL Example 8: Channel Coupling Target: Output a sine wave with 1kHz, 5Vpp, 0VDC, 0° via CH1 and a ramp wave with 1.5kHz, 5Vpp, 0 VDC, 0° via CH2, and then, take CH1 as the base channel and Set the phase deviation as 10°, finally, observe the phase of wave from CH2 after coupling.
PAGE 87
Application Examples RIGOL Example 9: Channel Copy Target: Output a sine wave with 1kHz, 500mVDC, 10° via CH1 and a ramp wave with 1.5kHz, 2Vpp, 0 VDC, 0° via CH2, and then observe the parameters of wave from CH2 after copying CH1 to CH2. How to realize via commands? 0 1 2 3 4 5 6 7 8 9 10 11 12 *IDN? VOLT:UNIT VPP APPL:SIN 1000,5,0.
PAGE 88
PAGE 89
Appendix: Commands Reference A-Z RIGOL Appendix: Commands Reference A-Z *IDN? 2-2 A AM:SOURce 2-30 AM:SOURce? 2-30 AM:INTernal:FUNCtion 2-30 AM:INTernal:FUNCtion? 2-31 AM:INTernal:FREQuency 2-31 AM:INTernal:FREQuency? 2-31 AM:DEPTh 2-31 AM:DEPTh? 2-31 AM:STATe 2-32 AM:STATe? 2-32 APPLy:SINusoid 2-3 APPLy:SQUare 2-4 APPLy:RAMP 2-4 APPLy:PULSe 2-4 APPLy:NOISe 2-4 APPLy:DC 2-5 APPLy:USER 2-5 APPLy? 2-5 APPLy:SINusoid:CH2 2-5 APPLy:SQUare:CH2 2-5 APPLy:RAMP:CH2 2-6 APPLy:PULSe:CH2 2-6 APPLy:NOISe:CH2 2-6 AP
PAGE 90
RIGOL DISPlay:CONTRAST 2-60 DISPlay:LUMInance 2-60 F FM:SOURce 2-33 FM:SOURce? 2-33 FM:INTernal:FUNCtion 2-33 FM:INTernal:FUNCtion? 2-34 FM:INTernal:FREQuency 2-34 FM:INTernal:FREQuency? 2-34 FM:DEViation 2-34 FM:DEViation? 2-34 FM:STATe 2-35 FM:STATe? 2-35 FREQuency 2-14 FREQuency? 2-14 FREQuency:CH2 2-15 FREQuency:CH2? 2-15 FREQuency:STARt 2-15 FREQuency:STARt? 2-15 FREQuency:STOP 2-15 FREQuency:STOP? 2-16 FREQuency:CENTer 2-16 FREQuency:CENTer? 2-16 FREQuency:SPAN 2-16 FREQuency:SPAN? 2-16 FSK:SOURce 2-
PAGE 91
Appendix: Commands Reference A-Z OUTPut:LOAD:CH2? 2-25 OUTPut:POLarity:CH2 2-25 OUTPut:POLarity:CH2? 2-26 P PHASe 2-58 PHASe? 2-58 PHASe:CH2 2-58 PHASe:CH2? 2-59 PHASe:ALIGN 2-59 PM:SOURce 2-36 PM:SOURce? 2-36 PM:INTernal:FUNCtion 2-36 PM:INTernal:FUNCtion? 2-37 PM:INTernal:FREQuency 2-37 PM:INTernal:FREQuency? 2-37 PM:DEViation 2-37 PM:DEViation? 2-37 PM:STATe 2-38 PM:STATe? 2-38 PULSe:PERiod 2-27 PULSe:PERiod? 2-28 PULSe:WIDTh 2-28 PULSe:WIDTh? 2-28 PULSe:DCYCle 2-28 PULSe:DCYCle? 2-28 PULSe:PERiod:CH2 2
PAGE 92
RIGOL VOLTage:OFFSet:CH2? 2-21 VOLTage:UNIT:CH2 2-21 4 Appendix: Commands Reference A-Z VOLTage:UNIT:CH2? 2-21 Programming Guide for DG10X2