User manual

ManualsBrandsRIGOL ManualsLaboratory Test EquipmentFunction Generator, Frequency Generator

RIGOL

Programming Guide

DG1022 Function/Arbitrary

Waveform Generator

August 2009

RIGOL Technologies, Inc.

Summary of content (100 pages)

PAGE 1
RIGOL Programming Guide DG1022 Function/Arbitrary Waveform Generator August 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 DG1022 generator using commands and how to input the commands in right format. Chapter 2 DG1022 Commands System This chapter gives detailed information on each command supported by DG1022, 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 Wave ........................................................ 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 DG1022 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 DG1022 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
DG1022 Commands System RIGOL Chapter 2 DG1022 Commands System This chapter gives detailed information on each command supported by DG1022, including command format, function description, using considerations as well as some application examples. DG1022 contains following subcommands systems:                     IEEE 488.
PAGE 14
DG1022 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. DG1022 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
DG1022 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. DG1022 supports following APPLy commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16.
PAGE 16
DG1022 Commands System RIGOL The detailed information of each command are: 1. APPLy:SINusoid Command Format APPLy:SINusoid [[,[,]]] Function Generate a sine wave with specific frequency, amplitude and DC offset via CH1. Explanations   Example 2. If the parameters you set are less than three, the sequence would be: , , . The default units of , , are: Hz, Vpp, VDC. APPL:SIN 1000,5.0,-1.
PAGE 17
DG1022 Commands System 4. RIGOL APPLy:PULSe Command Format APPLy:PULSe [[,[,]]] Function Generate a pulse wave with specific frequency, amplitude and DC offset via CH1. Explanations   Example 5. If the parameters you set are less than three, the sequence would be: , , . The default units of , , are: Hz, Vpp, VDC. APPL:PULS 1000,5.0,-1.
PAGE 18
DG1022 Commands System RIGOL 7. APPLy:USER Command Format APPLy:USER [[,[,]]] Function Generate an arbitrary wave selected by FUNCtion:USER command with specific frequency, amplitude and DC offset. Explanations   Example 8. If the parameters you set are less than three, the sequence would be: , , . The default units of , , are: Hz, Vpp, VDC. APPL:USER 1000,5.0,-1.
PAGE 19
DG1022 Commands System RIGOL 50% automaticly. Explanations   Example If the parameters you set are less than three, the sequence would be: , , . The default units of , , are: Hz, Vpp, VDC. APPL:SQU:CH2 1000,5.0,-1 11.
PAGE 20
DG1022 Commands System RIGOL   Example 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:CH2 DEF, 5.0, 0.5 14. APPLy:DC:CH2 Command Format APPLy:DC:CH2[[,|DEFault>[,< offset>]]] Function Generate a DC with electrical level specified by parameter via CH2.
PAGE 21
DG1022 Commands System RIGOL Explanations The query returns a character string with double quotation marks, including function, frequency, amplitude and offset. Example CH2:"SIN,1.000000e+03,5.000000e+00,-1.
PAGE 22
RIGOL DG1022 Commands System 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. DG1022 supports following FUNCtion commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16.
PAGE 23
DG1022 Commands System RIGOL The detailed information of each command are: 1. FUNCtion Command Format FUNCtion {SINusoid|SQUare|RAMP|PULSe|NOISe|DC|USER} Function Select the output function for CH1. Explanations If send FUNC DC and then FUNC USER, the output is still DC. Example FUNC SIN 2. FUNCtion? Command Format FUNCtion? Function Query the output function from CH1. Explanations The query always returns CH1:ARB after sending FUNC DC or FUNC USER.
PAGE 24
DG1022 Commands System RIGOL   Example 4. Others: Roundpm/DC Send FUNC DC command when use DC. Abbreviation is invalid. FUNC:USER VOLATILE FUNCtion:USER? Command Format FUNCtion:USER? Function Query the name of arbitrary wave generated from CH1. 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. 5.
PAGE 25
DG1022 Commands System 8. RIGOL FUNCtion:RAMP:SYMMetry? Command Format FUNCtion:RAMP:SYMMetry? [MINimum|MAXimum] Function Query the symmetry of ramp wave from CH1. Return Value The query returns current symmetry settings with the format of percent, such as 50.000000. 9. FUNCtion:CH2 Command Format FUNCtion:CH2 {SINusoid|SQUare|RAMP|PULSe|NOISe|DC|USER} Function Select the output function form CH2. Explanations If send FUNC:CH2 DC and then FUNC:CH2 USER, the output is still DC.
PAGE 26
DG1022 Commands System RIGOL   Example Lorentz/Dirichlet/GaussPulse/Airy Project: Cardiac/Quake/Gamma/Voice/TV/Combin/BandLimited/ Stepresponse/Butterworth/Chebyshev1/ Chebyshev2 Window Function: Boxcar/Barlett/triang/Blackman/Hamming/Hanning/Kaiser Others: Roundpm/DC Send FUNC:CH2 DC command when use DC. Abbreviation is invalid. FUNC:USER:CH2 SINC 12. FUNCtion:USER:CH2? Command Format FUNCtion:USER:CH2? Function Query the name of arbitrary wave generated from CH2.
PAGE 27
DG1022 Commands System RIGOL Format Function Explanations Set the symmetry of ramp wave for CH2. is the selected percent of symmetry; MIN＝0％, MAX＝ 100％. Example FUNC:RAMP:SYMM:CH2 50 16. FUNCtion:RAMP:SYMMetry:CH2? Command Format FUNCtion:RAMP:SYMMetry:CH2? [MINimum|MAXimum] Function Query the symmetry of ramp wave from CH2. Return Value The query returns current symmetry settings with the format of percent, such as 50.000000.
PAGE 28
RIGOL DG1022 Commands System FREQuency FREQuency commands are used for setting: the frequency of output function from dual channels; the start/stop frequency, the center/span frequency in sweep mode, the carrier frequency in modulation. Sweep and modulation are only valid for CH1. DG1022 supports following FREQuency commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12.
PAGE 29
DG1022 Commands System RIGOL The detailed information of each command are: 1. FREQuency Command Format FREQuency {|MINimum|MAXimum} Function Set the frequency of output function for CH1. 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 MIN 2.
PAGE 30
DG1022 Commands System RIGOL Function Set the start frequency (used in conjunction with the stop frequency) in sweep mode. Example FREQ:STAR MIN 6. FREQuency:STARt? Command Format FREQuency:STARt? [MINimum|MAXimum] Function Query the start frequency in sweep mode. Return Value The query returns the start frequency that has been set in the form of scientific notation in Hz, such as: 1.000000e-06. 7.
PAGE 31
DG1022 Commands System RIGOL form of scientific notation in Hz, such as: 1.000000e+07. 11. FREQuency:SPAN Command Format FREQuency:SPAN {|MINimum|MAXimum} Function Set the span frequency (used in conjunction with center frequency) in sweep mode. Example FREQ:SPAN MAX 12. FREQuency:SPAN? Command Format FREQuency:SPAN? [MINimum|MAXimum] Function Query the span frequency in sweep mode.
PAGE 32
RIGOL DG1022 Commands System VOLTage VOLTage commands are used for setting the voltage amplitude, offset, high level, low level, or setting the voltage unit for each channel. DG1022 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 33
DG1022 Commands System RIGOL The detailed information of each command are: 1. VOLTage Command Format VOLTage {|MINimum|MAXimum} Function Set the amplitude from CH1 in Vpp. Explanations MIN selects the minimum amplitude. MAX selects the maximum amplitude for the selected function. Unit 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. Example VOLT MIN 2.
PAGE 34
DG1022 Commands System RIGOL Format Function Set the low level of waves from CH1 in V. Explanations is the low level for user to set. MIN selects the minimum low level. MAX selects the maximum low level. Example VOLT:LOW MIN 6. VOLTage:LOW? Command Format VOLTage:LOW? Function Query the low level of waves from CH1. Return Value The query returns the low level that has been set in the form of scientific notation such as: -1.000000e+01. 7.
PAGE 35
DG1022 Commands System Command Format VOLTage:UNIT? Function Query the unit of voltage from CH1. Return Value The query returns VPP, VRMS or DBM. RIGOL 11. VOLTage:CH2 Command Format VOLTage:CH2 {|MINimum|MAXimum} Function Set the amplitude of CH2 in Vpp. Explanations MIN selects the minimum amplitude. MAX selects the maximum amplitude for the selected function. Example VPP, VRMS or DBM. Note that DBM could be used only in non-high resistance.
PAGE 36
DG1022 Commands System RIGOL scientific notation such as: 1.500000e+00. 15. VOLTage:LOW:CH2 Command Format VOLTage:LOW:CH2 {|MINimum|MAXimum} Function Set the low level of waves from CH2 in V. Explanations is the low level for user to set. MIN selects the minimum low level. MAX selects the maximum low level. Example VOLT:LOW:CH2 MIN 16. VOLTage:LOW:CH2? Command Format VOLTage:LOW:CH2? Function Query the low level of waves from CH2.
PAGE 37
DG1022 Commands System Explanations DBM could be used only in non-high resistance. Example VOLT:UNIT:CH2 VPP RIGOL 20. VOLTage:UNIT:CH2? Command Format VOLTage:UNIT:CH2? Function Query the unit of voltage from CH2. Return Value The query returns VPP, VRMS or DBM.
PAGE 38
RIGOL DG1022 Commands System 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. DG1022 supports following OUTPut commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18.
PAGE 39
DG1022 Commands System RIGOL The detailed information of each command are: 1. OUTPut Command Format OUTPut {OFF|ON} Function Disable or enable the [Output] connector of CH1. The default is “OFF”. Example OUTP ON 2. OUTPut? Command Format OUTPut? Function Query the state of the [Output] connector of CH1. 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.
PAGE 40
DG1022 Commands System RIGOL 6. OUTPut:POLarity? Command Format OUTPut:POLarity? Function Query the polarity of waveform from CH1. Return Value The query returns NORM or INV. 7. OUTPut:SYNC Command Format OUTPut:SYNC {OFF|ON} Function Disable or enable the rear panel [Output] connector of CH1. The default is “OFF”. Explanations The signal could be output synchronously only from CH1. Example OUTP:SYNC OFF 8.
PAGE 41
DG1022 Commands System Function Query the edge of “tirgger output”. Return Value The query returns POSITIVE or NEGATIVE. RIGOL 11. OUTPut:TRIGger Command Format OUTPut:TRIGger {OFF|ON} Function Disable or enable the [Ext Trig/FSK/Burst] connector on rear panel. Example OUTP:TRIG OFF 12. OUTPut:TRIGger? Command Format OUTPut: TRIGger? Function Query the state of the [Ext Trig/FSK/Burst] connector on rear panel. Return Value The query returns OFF or ON. 13.
PAGE 42
DG1022 Commands System RIGOL Command Format OUTPut:LOAD:CH2? [MINimum|MAXimum] Function Query the current load settings of CH2. Return Value The query returns the current load setting in ohms or returns “Infinity”. 17. OUTPut:POLarity:CH2 Command Format OUTPut:POLarity:CH2 {NORMal|INVerted} Function Set the polarity of waveform from CH2. Example OUTP:POL:CH2 NORM 18. OUTPut:POLarity:CH2? Command Format OUTPut:POLarity:CH2? Function Query the polarity of waveform from CH2.
PAGE 43
DG1022 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% Rise Time 10% Period Fall Time DG1022 supports following PULSe commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12.
PAGE 44
DG1022 Commands System RIGOL The detailed information of each command are: 1. PULSe:PERiod Command Format PULSe:PERiod {|MINimum|MAXimum} Function Set the period of pulse from CH1 in seconds. Example PULS:PER 0.01 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.
PAGE 45
DG1022 Commands System RIGOL Function Query the duty cycle of pulse from CH1. Return Value The qurey returns the percent of duty cycle of pulse in the form of scientific notation such as: 5.000000e+01. 7. PULSe:PERiod:CH2 Command Format PULSe:PERiod:CH2 {|MINimum|MAXimum} Function Set the period of pulse for CH2 in seconds. Example PULS:PER:CH2 0.01 8. PULSe:PERiod:CH2? Command Format PULSe:PERiod:CH2? [MINimum|MAXimum] Function Query the period of pulse from CH2.
PAGE 46
DG1022 Commands System RIGOL Command Format PULSe:DCYCle:CH2? [MINimum|MAXimum] Function Query the duty cycle of pulse from CH2. Return Value The qurey returns the percent of duty cycle in the form of scientific notationn, such as: 5.000000e+01.
PAGE 47
DG1022 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. DG1022 supports following AM commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 48
DG1022 Commands System RIGOL The detailed information of each command are: 1. AM:SOURce Command Format AM:SOURce {INTernal|EXTernal} Function Select internal or external modulation source, the default is INT. Example AM:SOUR EXT 2. AM:SOURce? Command Format AM:SOURce? Function Query the modulation source of AM. Return Value The query returns INT or EXT. 3.
PAGE 49
DG1022 Commands System RIGOL Command Format AM:INTernal:FREQuency? Function Query the frequency of internal modulation of AM. Return Value The query returns the percent of the frequency of AM internal modulation in the form of scientific notation, such as: 2.000000e+02. 7. AM:DEPTh Command Format AM:DEPTh {|MINimum|MAXimum} Function Explanations Set the depth of internal modulation of AM in percent. Depth range: 0%～120% Example AM:DEPT 70 8.
PAGE 50
RIGOL DG1022 Commands System 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. DG1022 supports following FM commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 51
DG1022 Commands System RIGOL The detailed information of each command are: 1. FM:SOURce Command Format FM:SOURce {INTernal|EXTernal} Function Select internal or external modulation source, the default is INT. Example FM:SOUR EXT 2. FM:SOURce? Command Format FM:SOURce? Function Query the modulation source of FM. Return Value The query returns INT or EXT. 3.
PAGE 52
DG1022 Commands System RIGOL Command Format FM:INTernal:FREQuency? Function Query the frequency of internal modulation of FM. Return Value The query returns the percent of the frequency of FM internal modulation in the form of scientific notation, such as: 2.000000e+02 7. FM:DEViation Command Format FM:DEViation{ |MINimum|MAXimum} Function Set the frequency deviation of peak value of FM in Hz. Example FM:DEV 100 8.
PAGE 53
DG1022 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. DG1022 supports following PM commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 54
DG1022 Commands System RIGOL The detailed information of each command are: 1. PM:SOURce Command Format PM:SOURce {INTernal|EXTernal} Function Select internal or external modulation source, the default is INT. Example PM:SOUR EXT 2. PM:SOURce? Command Format PM:SOURce? Function Query the modulation source of PM. Return Value The query returns INT or EXT. 3.
PAGE 55
DG1022 Commands System RIGOL Command Format PM:INTernal:FREQuency? Function Query the frequency of internal modulation of PM. Return Value The query returns the internal modulation frequency of PM in the form of scientific notation, such as: 2.000000e+02. 7. PM:DEViation Command Format PM:DEViation {|MINimum|MAXimum} Function Explanations Set the phase deviation of PM and in degree. Phase deviation range: 0°～360° Example PM:DEV 180 8.
PAGE 56
RIGOL DG1022 Commands System 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 57
DG1022 Commands System RIGOL The detailed information of each command are: 1. FSK:SOURce Command Format FSK:SOURce {INTernal|EXTernal} Function Select internal or external modulation source, the default is INT. Example FSK:SOUR EXT 2. FSK:SOURce? Command Format FSK:SOURce? Function Query the modulation source of FSK. Return Value The query returns INT or EXT. 3. FSK:FREQuency Command Format FSK:FREQuency {|MINimum|MAXimum} Function Set the hop frequency of FSK in Hz.
PAGE 58
DG1022 Commands System RIGOL Format Function Query the rate of FSK. Return Value The query returns the rate of FSK in the form of scientific notation, such as: 1.000000e+02. 7. FSK:STATe Command Format FSK:STATe {OFF|ON} Function Disable or enable FSK function. Example FSK:STAT OFF 8. FSK:STATe? Command Format FSK:STATe? Function Query the modulation state of FSK. Return Value The query returns OFF or ON.
PAGE 59
DG1022 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 60
DG1022 Commands System RIGOL The detailed information of each command are: 1. SWEep:SPACing Command Format SWEep:SPACing {LINear|LOGarithmic} Function Select linear or logarithmic spacing for the sweep, the default is Linear. Example SWE:SPAC LIN 2. SWEep:SPACing? Command Format SWEep:SPACing? Function Query current sweep mode. Return Value The query returns LINEAR or LOG. 3.
PAGE 61
DG1022 Commands System 6. RIGOL SWEep:STATe? Command Format SWEep:STATe? Function Query the sweep state. Return Value The query returns OFF or ON.
PAGE 62
RIGOL DG1022 Commands System TRIGger TRIGger commands are available in Sweep and Burst mode for CH1 only. DG1022 supports following TRIGger commands: 1. 2. 3. 4. 5. 6.
PAGE 63
DG1022 Commands System RIGOL The detailed information of each command are: 1. TRIGger:SOURce Command Format TRIGger:SOURce {IMMediate|EXTernal|BUS} Function Select the trigger source for generator, such as: internal trigger (IMM), external trigger (EXT) from the [Ext Trig/FSK/Burst] connector on the rear panel, or manual trigger (BUS). The default is IMM. Example TRIG:SOUR EXT 2. TRIGger:SOURce? Command Format TRIGger:SOURce? Function Query the trigger source of generator.
PAGE 64
DG1022 Commands System RIGOL Function Set the trigger delay in seconds. Note: this command is only applied to Burst mode. Example TRIG:DEL 0.000005 6. TRIGger:DELay? Command Format TRIGger:DELay? Function Query the trigger delay. Return Value The query returns the selected delay time in the form of scientific notation in seconds, such as: 5.000000e-06.
PAGE 65
DG1022 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, pulse or arbitrary waves. DG1022 supports following BURSt commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12.
PAGE 66
DG1022 Commands System RIGOL The detailed information of each command are: 1. BURSt:MODE Command Format BURSt:MODE {TRIGgered|GATed} Function Select the burst mode. Explanations    Example 2. In TRIG mode, the generator outputs a wave with specified cycle number once receive an assigned trigger via sending TRIGger:SOURce. In GAT mode, the output state of waves (“ON” or “OFF”) depends on the external level used by [Ext Trig/FSK/Burst] connector on the rear panel.
PAGE 67
DG1022 Commands System RIGOL 5. BURSt:INTernal:PERiod BURSt:INTernal:PERiod {<秒>|MINimum|MAXimum} Command Format Function Set the period of burst in internal trigger mode. Explanations   Example BURS:INT:PER 10 6. is the burst period for user to set, the unit is s. MIN=1μs, MAX=500s. BURSt:INTernal:PERiod? Command Format BURSt:INTernal:PERiod? [MINimum|MAXimum] Function Query the period of burst in internal trigger mode.
PAGE 68
DG1022 Commands System RIGOL Command Format BURSt:STATe? Function Query the state of burst mode. Return Value The query returns OFF or ON. 11. BURSt:GATE:POLarity Command Format BURSt:GATE:POLarity {NORMal|INVerted} Function Set the polarity of external gating signal from [Ext Trig/FSK/Burst] conncetor on the rear panel, the default is NORMal. Example BURS:GATE:POL INV 12.
PAGE 69
DG1022 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). DG1022 supports following DATA commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 70
DG1022 Commands System RIGOL The detailed information of each command are: 1. DATA Command Format DATA VOLATILE,, , . . . Function Load the floating point numbers between -1 and 1 into volatile memory. Explanations  DATA 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 71
DG1022 Commands System RIGOL to memory. Example 3. DATA:DAC VOLATILE,8192,16383,8192,0 DATA:COPY Command Format DATA:COPY < destination arb name >[,VOLATILE] Function Copy the waveform from volatile memory to the specified non-volatile memory. Explanations  The arb name may contain up to 12 characters. The first character must be a letter (A-Z or a-z), the remaining characters can be numbers (0-9) or the underscore character (“_”). Blank space is invalid.
PAGE 72
DG1022 Commands System RIGOL "CARDIAC","A","B","C","D","E","F","G","H","I","J". 6. DATA:RENAME Command Format DATA:RENAME , Function Rename an arbitrary wave. Example DATA:RENAME old, new 7. DATA:NVOLatile:CATalog? Command Format DATA:NVOLatile:CATalog? Function Query the names of all user-defined arbitrary waveforms downloaded to non-volatile memory.
PAGE 73
DG1022 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 1 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. DG1022 supports following MEMory commands: 1. 2. 3. 4. 5. 6. 7.
PAGE 74
DG1022 Commands System RIGOL The detailed information of each command are: 1. MEMory:STATe:NAME Command Format MEMory:STATe:NAME {0|1|2|3|4|5|6|7|8|9|10} [,] Function Assign an user-defined name for specified memory location. Example MEM:STAT:NAME 1,A1 2. MEMory:STATe:NAME? Command Format MEMory:STATe:NAME? {0|1|2|3|4|5|6|7|8|9|10} Function Query the name of specified memory location. Return Value The query returns the name of specified memory location such as A1.
PAGE 75
DG1022 Commands System RIGOL Command Format MEMory:STATe:VALid? {0|1|2|3|4|5|6|7|8|9|10} Function Query the specified storage location to determine if a valid state has already been stored in that location. Return Value Return “0” if no state has been stored or if it has been deleted. or else return “1”. 7. MEMory:NSTates? Command Format MEMory:NSTates? Function Query the total number of memory locations available for state storage.
PAGE 76
RIGOL DG1022 Commands System 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. DG1022 supports following SYSTem commands: 1. 2. 3. 4. 5. 6. 7. 8. 9.
PAGE 77
DG1022 Commands System RIGOL The detailed information of each command are: 1. SYSTem:ERRor? Command Format SYSTem:ERRor? Function Read and clear an error from error queues. Return Value The query returns an error information with following format: -118,"Invalid parameter" 2. SYSTem:VERSion? Command Format SYSTem:VERSion? Function Query current edition of the instrument. Return Value The query returns the character string with following format: 00.01.00.04.00.02.03 3.
PAGE 78
DG1022 Commands System RIGOL Format Function 7. Activate remote state with locking function and display R-LOCK indicator and lock the keyboard. (including Local button) SYSTem:REMote Command Format SYSTem:REMote Function Activate remote state and display RMT indicator and lock the keyboard. (except for Local button) 8. SYSTem:CLKSRC Command Format SYSTem:CLKSRC {EXT|INT} Function Select the system clock source as internal or external, the default is INT.
PAGE 79
DG1022 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. DG1022 supports following PHASe commands: 1. 2. 3. 4. 5.
PAGE 80
DG1022 Commands System RIGOL The detailed information of each command are: 1. PHASe Command Format PHASe {|MINimum|MAXimum} Function Set the initial phase of signals from CH1. Explanations is the phase for user to set, the unit is degree. MIN=-180°, MAX=180°。 Return Value PHAS 90 2. PHASe? Command Format PHASe? [MINimum|MAXimum] Function Query the initial phase of signals from CH1. Return Value The query returns any numerical value between -180 and 180, such as: 90.000. 3.
PAGE 81
DG1022 Commands System RIGOL DISPlay DISPlay commands are used for controlling the display of front panel. DG1022 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 82
RIGOL DG1022 Commands System COUPling COUPling commands are used for channel coupling or copying. DG1022 supports following COUPling commands: 1. 2. 3. 4. 5. 6. 7. 8. 9.
PAGE 83
DG1022 Commands System RIGOL The detailed information of each command are: 1. COUPling Command Format COUPling {OFF|ON} Function Enable or disable coupling function. Example COUP OFF 2. COUPling? Command Format COUPling? Function Query the coupling state. Return Value The query returns OFF or ON. 3. COUPling:BASEdchannel Command Format COUPling:BASEdchannel{:CH1|:CH2} Function Select the base channel while coupling channels. Example COUP:BASE:CH1 4.
PAGE 84
DG1022 Commands System RIGOL Return Value 7. The query returns the phase deviation in the form of scientific notation, such as: 1.000000e+01. COUPling:FREQDEViation Command Format COUPling:FREQDEViation Function Set the frequency deviation in Hz. Explanations : 0Hz~20MHz Example COUP:FREQDEV 100 8. COUPling:FREQDEViation? Command Format COUPling:FREQDEViation? Function Query the frequency deviation.
PAGE 85
Application Examples RIGOL Chapter 3 Application Examples This chapter shows you how to realize the examples in《DG1022 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 86
Application Examples RIGOL Example 1: To Generate a Sine Wave 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 87
Application Examples RIGOL Example 2: To Generate a Built-in Arbitrary Wave 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 88
Application Examples RIGOL Example 3: To Generate an User-defined Arbitrary Wave 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 ① μs 10 -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 89
Application Examples RIGOL /*Load the 4 decimal numbers to volatile memory */ FUNC:USER VOLATILE OUTP ON panel */ /*Output the waves in volatile memory */ /* Enable the [Output] connector of CH1 at front Programming Guide for DG1022 3-5 7 8
PAGE 90
Application Examples RIGOL Example 4: To Generate a FSK Wave Target: Generate a FSK wave with: 10 kHz, 5 Vpp, 0 VDC of carrier wave, internal modulation source, 800 Hz of hop frequency and 200 Hz of FSK rate.
PAGE 91
Application Examples RIGOL Example 5: To Generate a Linear Sweep Wave 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 92
Application Examples RIGOL Example 6: To Generate a Burst Wave 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 93
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 94
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 95
Application Examples RIGOL Example 9: Channel Copy Target: Output a sine wave with 1kHz, 5Vpp, 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 *IDN? /* Query ID to check the operating state */ VOLT:UNIT VPP /* Set the amplitude unit of CH1*/ APPL:SIN 1000,5,0.
PAGE 96
PAGE 97
Appendix: Commands Reference A-Z RIGOL Appendix: Commands Reference A-Z *IDN? 2-2 A AM:SOURce 2-36 AM:SOURce? 2-36 AM:INTernal:FUNCtion 2-36 AM:INTernal:FUNCtion? 2-36 AM:INTernal:FREQuency 2-36 AM:INTernal:FREQuency? 2-36 AM:DEPTh 2-37 AM:DEPTh? 2-37 AM:STATe 2-37 AM:STATe? 2-37 APPLy:SINusoid 2-4 APPLy:SQUare 2-4 APPLy:RAMP 2-4 APPLy:PULSe 2-5 APPLy:NOISe 2-5 APPLy:DC 2-5 APPLy:USER 2-6 APPLy? 2-6 APPLy:SINusoid:CH2 2-6 APPLy:SQUare:CH2 2-6 APPLy:RAMP:CH2 2-7 APPLy:PULSe:CH2 2-7 APPLy:NOISe:CH2 2-7 AP
PAGE 98
RIGOL DISPlay:CONTRAST 2-69 DISPlay:LUMInance 2-69 F FM:SOURce 2-39 FM:SOURce? 2-39 FM:INTernal:FUNCtion 2-39 FM:INTernal:FUNCtion? 2-39 FM:INTernal:FREQuency 2-39 FM:INTernal:FREQuency? 2-39 FM:DEViation 2-40 FM:DEViation? 2-40 FM:STATe 2-40 FM:STATe? 2-40 FREQuency 2-17 FREQuency? 2-17 FREQuency:CH2 2-17 FREQuency:CH2? 2-17 FREQuency:STARt 2-17 FREQuency:STARt? 2-18 FREQuency:STOP 2-18 FREQuency:STOP? 2-18 FREQuency:CENTer 2-18 FREQuency:CENTer? 2-18 FREQuency:SPAN 2-19 FREQuency:SPAN? 2-19 FSK:SOURce 2-
PAGE 99
Appendix: Commands Reference A-Z OUTPut:LOAD:CH2? 2-29 OUTPut:POLarity:CH2 2-30 OUTPut:POLarity:CH2? 2-30 P PHASe 2-68 PHASe? 2-68 PHASe:CH2 2-68 PHASe:CH2? 2-68 PHASe:ALIGN 2-68 PM:SOURce 2-42 PM:SOURce? 2-42 PM:INTernal:FUNCtion 2-42 PM:INTernal:FUNCtion? 2-42 PM:INTernal:FREQuency 2-42 PM:INTernal:FREQuency? 2-42 PM:DEViation 2-43 PM:DEViation? 2-43 PM:STATe 2-43 PM:STATe? 2-43 PULSe:PERiod 2-32 PULSe:PERiod? 2-32 PULSe:WIDTh 2-32 PULSe:WIDTh? 2-32 PULSe:DCYCle 2-32 PULSe:DCYCle? 2-32 PULSe:PERiod:CH2 2
PAGE 100
RIGOL VOLTage:OFFSet:CH2? 2-24 VOLTage:UNIT:CH2 2-24 4 Appendix: Commands Reference A-Z VOLTage:UNIT:CH2? 2-25 Programming Guide for DG1022