Specifications

ManualsBrandsRigol ManualsConsumer electronicsDG1000 Series

RIGOL

Programming Guide

DG1000 Series Dual-Channel

Function/Arbitrary

Waveform Generator

Jan. 2014

RIGOL Technologies, Inc.

Summary of content (100 pages)

PAGE 1
RIGOL Programming Guide DG1000 Series Dual-Channel Function/Arbitrary Waveform Generator Jan. 2014 RIGOL Technologies, Inc.
PAGE 2
PAGE 3
RIGOL Guaranty and Declaration Copyright ©2009 RIGOL Technologies, Inc. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL Technologies, Inc. Publication Number PGB06109-1110 Notices      RIGOL products are protected by patent law in and outside of P.R. China. RIGOL 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 how to programme DG1000 generator using commands and how to input the commands in right format. Chapter 2 DG1000 Command System This chapter gives detailed information of each command supported by DG1000, including command syntax, function description, considerations when using command as well as some application examples.
PAGE 5
RIGOL Table of Contents Guaranty and Declaration .......................................................................... I Chapter 1 Programming Overview ......................................................... 1-1 Communication Interfaces ........................................................................ 1-2 Commands Introduction ........................................................................... 1-3 Command Syntax..........................................................................
PAGE 6
RIGOL Example Example Example Example Example Example 4: 5: 6: 7: 8: 9: To Generate a FSK Wave......................................................... 3-6 To Generate a Linear Sweep Wave ........................................... 3-7 To Generate a Burst Wave....................................................... 3-8 To Output Waves via Dual Channels ......................................... 3-9 Channel Coupling .................................................................. 3-10 Channel Copy .......
PAGE 7
Programming Overview RIGOL Chapter 1 Programming Overview This chapter introduces how to programme DG1000 series Dual-channel function/arbitrary waveform 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 commands over USB interface. Command is sended and identified in the form of ASCII character strings for users to easily control the generator 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 Command Syntax The command systems of DG1000 present a hierarchy structure (tree system) and each command consists of a “Root” keyword and one or multiple sub-keywords. The keywords are separated by ":" and are followed by the parameter settings available, "?" is added at the end of the command string to indicate query and the command and parameter are separated by "space".
PAGE 10
RIGOL Programming Overview Symbol Description Following symbols are usually used to assist to explain the parameters containd in a command. 1. Braces { } The options enclosed in a { } are parameters available in the command. Only one option 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 Type The commands contain 5 kinds of parameters, different parameters have different setting methods. 1. Boolean Parameters The parameters could be “OFF” or “ON” (“0” or “1”), for example, AM:STATE {OFF|ON} “OFF” denotes disabling AM function. “On” denotes enabling AM function. 2. Consecutive Integer Parameters The parameters could be a consecutive integer, for example, DISPlay:CONTRAST could be any integer between 0 and 31(including 0 and 31). 3.
PAGE 12
RIGOL Programming Overview Command Abbreviation All the commands are case-insensitive, so you can use any kind of them. But if abbreviation is used, all the capital letters specified in commands must be written completely.
PAGE 13
DG1000 Command System RIGOL Chapter 2 DG1000 Command System This chapter gives detailed information of each command supported by DG1000, including command syntax, function description, using considerations as well as some application examples. DG1000 contains following command sub-systems:                      IEEE 488.
PAGE 14
RIGOL DG1000 Command System IEEE 488.2 IEEE standard defines some common commands for querying basic instrument information or executing basic operations. These commands usually begin with “*” and hold 3-character long command keyword. DG1000 supports following IEEE488.2 commands: 1. 1. *IDN? *IDN? Syntax *IDN? Function Query ID character string of instrument.
PAGE 15
DG1000 Command System RIGOL APPLy APPLy commands are used to quickly set the output waveforms of DG1000 and provide the most straightforward method to program the generator over remote interface. DG1000 supports following APPLy commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16.
PAGE 16
RIGOL DG1000 Command System Detailed information of each command: 1. APPLy:SINusoid Syntax 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 , and are Hz, Vpp and VDC respectively. APPL:SIN 1000,5.0,-1.
PAGE 17
DG1000 Command System RIGOL offset via CH1. Explanations   Example 5. If the parameters you set are less than three, the sequence would be: , , . The default units of , and are Hz, Vpp and VDC respectively. APPL:PULS 1000,5.0,-1.5 APPLy:NOISe Syntax APPLy:NOISe [[,[,]]] Function Generate a Gaussian noise with specific amplitude and DC offset via CH1. Explanations    Example 6.
PAGE 18
RIGOL DG1000 Command System DC offset) selected by the FUNCtion:USER command via CH1. Explanations   Example 8. If the parameters you set are less than three, the sequence would be: , , . The default units of , and are Hz, Vpp and VDC respectively. APPL:USER 1000,5.0,-1.5 APPLy? Syntax APPLy? Function Query the current configuration of CH1 and the type of wave outputted.
PAGE 19
DG1000 Command System RIGOL Syntax APPLy:RAMP:CH2 [[,[,]]] Function Generate a ramp wave with specific frequency, amplitude and DC offset via CH2. This command would overwrite the current symmetry setting and select 50% automatically. Explanations   Example If the parameters you set are less than three, the sequence would be: , , . The default units of , and are Hz, Vpp and VDC respectively.
PAGE 20
RIGOL DG1000 Command System CH2. Explanations    Example Although the frequency and amplitude parameters make no 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 , and are Hz, Vpp and VDC respectively. APPL:DC:CH2 DEF,DEF,1.5 15.
PAGE 21
DG1000 Command 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. DG1000 supports following FUNCtion commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16.
PAGE 22
RIGOL DG1000 Command System Detailed information of each command: 1. FUNCtion Syntax FUNCtion {SINusoid|SQUare|RAMP|PULSe|NOISe|DC|USER} Function Select the output function for CH1. Explanation If FUNC DC is sent first and then FUNC USER, the output is still DC. Example FUNC SIN 2. FUNCtion? Syntax FUNCtion? Function Query the output function of CH1. Explanation The query always returns CH1:ARB after sending FUNC DC or FUNC USER.
PAGE 23
DG1000 Command System  Example 4. RIGOL Send the FUNC DC command to select DC. FUNC:USER VOLATILE FUNCtion:USER? Syntax FUNCtion:USER? Function Query the name of arbitrary wave generated from CH1. Explanation This command is invalid when DC is selected. Return Value The query returns the name of built-in arbitrary wave selected (such as EXP_RISE), VOLATILE or the name of any of the user-defined waves in nonvolatile memory. The default is EXP_RISE. 5.
PAGE 24
RIGOL Value 9. DG1000 Command System 50.000000. FUNCtion:CH2 Syntax FUNCtion:CH2 {SINusoid|SQUare|RAMP|PULSe|NOISe|DC|USER} Function Select the output function of CH2. Explanation If FUNC:CH2 DC is sent first and then FUNC:CH2 USER, the output is still DC. Example FUNC:CH2 SIN 10. FUNCtion:CH2? Syntax FUNCtion:CH2? Function Query the output function of CH2. Explanation The query always returns CH2:ARB after sending FUNC:CH2 DC or FUNC:CH2 USER.
PAGE 25
DG1000 Command System  Example RIGOL Send the FUNC:CH2 DC command when DC is used. FUNC:USER:CH2 SINC 12. FUNCtion:USER:CH2? Syntax FUNCtion:USER:CH2? Function Query the name of arbitrary wave generated from CH2. Explanation This command is invalid when DC is selected. Return Value The query returns the name of built-in arbitrary wave selected (such as EXP_RISE), VOLATILE or the name of any of the user-defined waves in nonvolatile memory. The default is EXP_RISE. 13.
PAGE 26
RIGOL Value 2-14 DG1000 Command System 50.000000.
PAGE 27
DG1000 Command System RIGOL FREQuency FREQuency commands are used for setting the frequencies of output functions of 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. DG1000 supports following FREQuency commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12.
PAGE 28
RIGOL DG1000 Command System Detailed information of each command: 1. FREQuency Syntax FREQuency {|MINimum|MAXimum} Function Set the frequency of output function for CH1. Explanation is the frequency set by user, the default unit is Hz. MIN is the minimum frequency available for the specified function, MAX is the maximum. Example FREQ MIN 2. FREQuency? Syntax FREQuency? [MINimum|MAXimum] Function Query the frequency of output function of CH1.
PAGE 29
DG1000 Command System RIGOL Syntax FREQuency:STARt? [MINimum|MAXimum] Function Query the start frequency in sweep mode. Return Value The query returns the start frequency set in scientific notation and in Hz, such as: 1.000000e-06. 7. FREQuency:STOP Syntax FREQuency:STOP {|MINimum|MAXimum} Function Set the stop frequency (used in conjunction with start frequency) in sweep mode. Example FREQ:STOP MAX 8.
PAGE 30
RIGOL DG1000 Command System Function Query the frequency span in sweep mode. Return Value The query returns the frequency span set in scientific notation and in Hz, such as: 2.000000e+07.
PAGE 31
DG1000 Command System RIGOL VOLTage VOLTage commands are used for setting the voltage amplitude, offset voltage, high level, low level, or the voltage unit for each channel. DG1000 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 32
RIGOL DG1000 Command System Detailed information of each command: 1. VOLTage Syntax VOLTage {|MINimum|MAXimum} Function Set the output amplitude of CH1 and the default unit is Vpp. Explanation is the amplitude set by users. MIN selects the minimum amplitude of the selected function and MAX selects the maximum amplitude. 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.
PAGE 33
DG1000 Command System RIGOL V. Explanation is the low level set by users. MIN selects the minimum low level available and MAX selects the maximum low level available. Example VOLT:LOW MIN 6. VOLTage:LOW? Syntax VOLTage:LOW? Function Query the low level of waves output from CH1. Return Value The query returns the low level set in scientific notation, such as: -1.000000e+01. 7.
PAGE 34
RIGOL DG1000 Command System 11. VOLTage:CH2 Syntax VOLTage:CH2 {|MINimum|MAXimum} Function Set the output amplitude of CH2 and the default unit is Vpp. Explanation is the amplitude set by users. MIN selects the minimum amplitude of the specified function and MAX selects the maximum amplitude. 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:CH2. Example VOLT:CH2 MIN 12.
PAGE 35
DG1000 Command System RIGOL low level available and MAX selects the maximum low level available. Example VOLT:LOW:CH2 MIN 16. VOLTage:LOW:CH2? Syntax VOLTage:LOW:CH2? Function Query the low level of waves output from CH2. Return Value The query returns the low leve set in scientific notation such as: -1.500000e+00. 17. VOLTage:OFFSet:CH2 Syntax VOLTage:OFFSet:CH2 {|MINimum|MAXimum} Function Set the offset voltage of CH2 in VDC. Explanation is the offset voltage set by users.
PAGE 36
RIGOL DG1000 Command 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 sync output signal and the trigger output of CH1. DG1000 supports following OUTPut commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18.
PAGE 37
DG1000 Command System RIGOL Detailed information of each command: 1. OUTPut Syntax OUTPut {OFF|ON} Function Disable or enable the [Output] connector of CH1 at the front panel. The default is “OFF”. Example OUTP ON 2. OUTPut? Syntax OUTPut? Function Query the state of the [Output] connector of CH1 at the front panel. Return Value The query returns OFF or ON. 3. OUTPut:LOAD Syntax OUTPut:LOAD {|INFinity|MINimum|MAXimum} Function Select the desired output termination of CH1.
PAGE 38
RIGOL 7. DG1000 Command System OUTPut:SYNC Syntax OUTPut:SYNC {OFF|ON} Function Disable or enable the rear panel [Sync Output] connector of CH1. Explanation Only CH1 provides sync signal output. Example OUTP:SYNC OFF 8. OUTPut:SYNC? Syntax OUTPut:SYNC? Function Query the state of the [Sync Out] connector of CH1 on the rear panel. Return Value The query returns SYNC OFF or SYNC ON. 9.
PAGE 39
DG1000 Command System RIGOL panel. Return Value The query returns OFF or ON. 13. OUTPut:CH2 Syntax OUTPut:CH2 {OFF|ON} Function Disable or enable the front-panel [Output] connector of CH2. The default is OFF. Example OUTP:CH2 ON 14. OUTPut:CH2? Syntax OUTPut:CH2? Function Query the state of front-panel [Output] connector of CH2. Return Value The query returns OFF or ON. 15.
PAGE 40
RIGOL DG1000 Command System 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 DG1000 supports following PULSe commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12.
PAGE 41
DG1000 Command System RIGOL Detailed information of each command: 1. PULSe:PERiod Syntax PULSe:PERiod {|MINimum|MAXimum} Function Set the period of pulse output from CH1 in seconds. Example PULS:PER 0.01 2. PULSe:PERiod? Syntax PULSe:PERiod? [MINimum|MAXimum] Function Query the period of pulse output from CH1. Return Value The query returns the pulse period in scientific notation and in seconds, such as: 1.000000e-02. 3.
PAGE 42
RIGOL DG1000 Command System Function Set the period of pulse for CH2 in seconds. Example PULS:PER:CH2 0.01 8. PULSe:PERiod:CH2? Syntax PULSe:PERiod:CH2? [MINimum|MAXimum] Function Query the period of pulse output from CH2. Return Value The qurey returns the period of pulse in scientific notation and in seconds, such as: 1.000000e-02. 9. PULSe:WIDTh:CH2 Syntax PULSe:WIDTh:CH2 {|MINimum|MAXimum} Function Set the pulse width for CH2 in seconds. Example PULS:WIDT:CH2 0.005 10.
PAGE 43
DG1000 Command System RIGOL AM In AM, the amplitude of carrier varies with the instantaneous voltage of the modulating waveform. For DG1000, CH1 can output AM modulated waveform. AM commands could be used for these settings: modulation source, modulating waveform, modulating frequency, modulation depth and AM modulation state. DG1000 supports following AM commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 44
RIGOL DG1000 Command System Detailed information of each command: 1. AM:SOURce Syntax AM:SOURce {INTernal|EXTernal} Function Select internal or external modulation source, the default is INT. Example AM:SOUR EXT 2. AM:SOURce? Syntax AM:SOURce? Function Query the modulation source of AM. Return Value The query returns INT or EXT. 3. AM:INTernal:FUNCtion Syntax AM:INTernal:FUNCtion {SINusoid|SQUare|RAMP|NRAMp|TRIangle|NOISe|USER} Function Select the internal modulating wave of AM.
PAGE 45
DG1000 Command System RIGOL 2.000000e+02. 7. AM:DEPTh Syntax AM:DEPTh {|MINimum|MAXimum} Function Set the depth of AM internal modulation in percent. Explanation Depth range: 0% to 120% Example AM:DEPT 70 8. AM:DEPTh? Syntax AM:DEPTh? [MINimum|MAXimum] Function Query the depth of AM internal modulation. Return Value The qurey returns the percent of the depth of AM internal modulation in scientific notation, such as: 7.000000e+01. 9.
PAGE 46
RIGOL DG1000 Command System FM In FM, the frequency of carrier varies with the instantaneous voltage of the modulating waveform. For DG1000, CH1 can output FM modulated waveform. FM commands could be used for these settings: modulation source, modulating waveform, modulating frequency, frequency deviation and FM modulation state. DG1000 supports following FM commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 47
DG1000 Command System RIGOL Detailed information of each command: 1. FM:SOURce Syntax FM:SOURce {INTernal|EXTernal} Function Select internal or external modulation source, the default is INT. Example FM:SOUR EXT 2. FM:SOURce? Syntax FM:SOURce? Function Query the modulation source of FM. Return Value The query returns INT or EXT. 3. FM:INTernal:FUNCtion Syntax FM:INTernal:FUNCtion {SINusoid|SQUare|RAMP|NRAMp|TRIangle|NOISe|USER} Function Select the internal modulating wave of FM.
PAGE 48
RIGOL DG1000 Command System 2.000000e+02. 7. FM:DEViation Syntax FM:DEViation{ |MINimum|MAXimum} Function Set the frequency deviation of FM in Hz. Example FM:DEV 100 8. FM:DEViation? Syntax FM:DEViation? [MINimum|MAXimum] Function Query the frequency deviation of FM. Return Value The query returns the frequency deviation of FM in the scientific notation and in Hz, such as: 1.000000e+02 9. FM:STATe Syntax FM:STATe {OFF|ON} Function Disable or enable FM function.
PAGE 49
DG1000 Command System RIGOL PM In PM, the phase of carrier varies with the instantaneous voltage of the modulating waveform. For DG1000, CH1 can output PM modulated waveform. PM commands could be used for these settings: modulation source, modulating waveform, modulating frequency, phase deviation and PM modulation state. DG1000 supports following PM commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 50
RIGOL DG1000 Command System Detailed information of each command: 1. PM:SOURce Syntax PM:SOURce {INTernal|EXTernal} Function Select internal or external modulation source, the default is INT. Example PM:SOUR EXT 2. PM:SOURce? Syntax PM:SOURce? Function Query the modulation source of PM. Return Value The query returns INT or EXT. 3. PM:INTernal:FUNCtion Syntax PM:INTernal:FUNCtion {SINusoid|SQUare|RAMP|NRAMp|TRIangle|NOISe|USER} Function Select the internal modulating wave of PM.
PAGE 51
DG1000 Command System RIGOL 2.000000e+02. 7. PM:DEViation Syntax PM:DEViation {|MINimum|MAXimum} Function Set the phase deviation of PM in degree. Explanation Phase deviation range: 0° to 360° Example PM:DEV 180 8. PM:DEViation? Syntax PM:DEViation? [MINimum|MAXimum] Function Query the phase deviation of PM. Return Value The query returns the phase deviation of PM in scientific notation and in degree, such as: 1.800000e+02. 9.
PAGE 52
RIGOL DG1000 Command 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”). The frequency at which the output frequency shifts between the carrier frequency and the hop frequency is called “FSK rate”. FSK rate is determined by internal modulating frequency or signal level at the [Ext Trig/FSK/Burst] connector on the rear panel. For DG1000, CH1 can output FSK modulated waveform.
PAGE 53
DG1000 Command System RIGOL Detailed information of each command: 1. FSK:SOURce Syntax FSK:SOURce {INTernal|EXTernal} Function Select internal or external modulation source, the default is INT. Example FSK:SOUR EXT 2. FSK:SOURce? Syntax FSK:SOURce? Function Query the modulation source of FSK. Return Value The query returns INT or EXT. 3. FSK:FREQuency Syntax FSK:FREQuency {|MINimum|MAXimum} Function Set the hop frequency of FSK in Hz. Example FSK:FREQ 10 4.
PAGE 54
RIGOL DG1000 Command System Syntax FSK:STATe {OFF|ON} Function Disable or enable FSK function. Example FSK:STAT OFF 8. FSK:STATe? Syntax FSK:STATe? Function Query the modulation state of FSK. Return Value The query returns OFF or ON.
PAGE 55
DG1000 Command System RIGOL SWEep In frequency sweep mode, the generator “steps” from the start frequency to the stop frequency at the specified sweep rate. You can sweep up or down in frequency with either linear or logarithmic spacing. In addition, you can configure the generator to output a single sweep (sweep from start frequency to stop frequency) by applying an external or manual trigger.
PAGE 56
RIGOL DG1000 Command System Detailed information of each command: 1. SWEep:SPACing Syntax SWEep:SPACing {LINear|LOGarithmic} Function Select linear or logarithmic spacing for the sweep, the default is Linear. Example SWE:SPAC LIN 2. SWEep:SPACing? Syntax SWEep:SPACing? Function Query the current sweep mode. Return Value The query returns LINEAR or LOG. 3.
PAGE 57
DG1000 Command System RIGOL TRIGger TRIGger commands are only available in Sweep and Burst mode. As only CH1 supports sweep and burst modes, TRIGger commands are only applicable to CH1. DG1000 supports following TRIGger commands: 1. 2. 3. 4. 5. 6.
PAGE 58
RIGOL DG1000 Command System Detailed information of each command: 1. TRIGger:SOURce Syntax TRIGger:SOURce {IMMediate|EXTernal|BUS} Function Select the trigger source for generator, including internal trigger (IMM), external trigger (EXT) from the [Ext Trig/FSK/Burst] connector on the rear panel and manual trigger (BUS). The default is IMM. Example TRIG:SOUR EXT 2. TRIGger:SOURce? Syntax TRIGger:SOURce? Function Query the trigger source of generator.
PAGE 59
DG1000 Command System RIGOL Function Query the trigger delay. Return Value The query returns the selected delay time in scientific notation and in seconds, such as: 5.000000e-06.
PAGE 60
RIGOL DG1000 Command System BURSt BURSt commands are used for setting the generator to output waveforms (called burst) with specified cycles. DG1000 can generate burst using sine, square, ramp, pulse or arbitrary waveform and output it from CH1. DG1000 supports following BURSt commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12.
PAGE 61
DG1000 Command System RIGOL Detailed information of each command: 1. BURSt:MODE Syntax BURSt:MODE {TRIGgered|GATed} Function Set the burst mode to trigger (TRIGgered) or gated (GATed). Explanations    Example 2. In trigger mode, the generator outputs a wave with specified number of cycles once it receives a trigger from the specified trigger source (via sending TRIGger:SOURce).
PAGE 62
RIGOL DG1000 Command System  Example 6. MIN=0.000001, MAX=500. BURS:INT:PER 10 BURSt:INTernal:PERiod? Syntax BURSt:INTernal:PERiod? [MINimum|MAXimum] Function Query the period of burst in internal trigger mode. Return Value The query returns the burst period in scientific notation and the default unit is s, such as: 1.000000e+01. 7. BURSt:PHASe Syntax BURSt:PHASe {|MINimum|MAXimum} Function Set the initial phase of burst. Explanations   Example BURS:PHAS 150 8.
PAGE 63
DG1000 Command System Example RIGOL BURS:GATE:POL INV 12. BURSt:GATE:POLarity? Syntax BURSt:GATE:POLarity? Function Query the polarity of external gated signal from the rear panel. Return Value The query returns NORM or INV.
PAGE 64
RIGOL DG1000 Command System DATA DATA commands are used 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 1 to 524,288 data points. DG1000 supports following DATA commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
PAGE 65
DG1000 Command System RIGOL Detailed information of each command: 1. DATA Syntax DATA VOLATILE,, , . . . Function Load the floating point numbers between -1 and 1 into volatile memory. Explanations  The DATA command would overwrite the previous waveform in volatile memory (does not generate error).  Use the DATA:COPY command to copy the waveform to non-volatile memory.
PAGE 66
RIGOL Example 3. DG1000 Command System DATA:DAC VOLATILE,8192,16383,8192,0 DATA:COPY Syntax 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.  The VOLATILE parameter is optional and can be omitted.
PAGE 67
DG1000 Command System RIGOL Function Rename user-defined arbitrary waves in non-volatile memory. Example DATA:RENAME A, new 7. DATA:NVOLatile:CATalog? Syntax DATA:NVOLatile:CATalog? Function Query the names of all user-defined arbitrary waveforms downloaded to non-volatile memory. Return Value The query returns the names (enclosed in quotation marks) of up to 10 waveforms, such as: "A","B","C","D","E","F","G","H","I","J". 8.
PAGE 68
RIGOL DG1000 Command System MEMory The generator has 10 storage locations (STATE1 to STATE10) in non-volatile memory to store instrument states. The locations are numbered from 1 to 10. Location 0 is volatile memory and the generator automatically uses location “0” to hold the state of the instrument at power-down. MEMory commands can be used to read the location names, delete the stored instrument states, automatically recall instrument state and query the available storage locations.
PAGE 69
DG1000 Command System RIGOL Detailed information of each command: 1. MEMory:STATe:NAME Syntax MEMory:STATe:NAME {0|1|2|3|4|5|6|7|8|9|10} [,] Function Assign a user-defined name for specified memory location. Example MEM:STAT:NAME 1,A1 2. MEMory:STATe:NAME? Syntax 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. If no name was assigned, the return is empty.
PAGE 70
RIGOL 7. DG1000 Command System MEMory:NSTates? Syntax MEMory:NSTates? Function Query the total number of memory locations available for state storage. Return Value Always return “11” (including memory location “0”).
PAGE 71
DG1000 Command System RIGOL SYSTem SYSTem commands provide information about state storage, power-down recall, error state and screen control of the front panel as well as other information about the instrument. DG1000 supports following SYSTem commands: 1. 2. 3. 4. 5. 6. 7. 8. 9.
PAGE 72
RIGOL DG1000 Command System Detailed information of each command: 1. SYSTem:ERRor? Syntax SYSTem:ERRor? Function Read and clear an error from error queue. Return Value The query returns an error information in following format: -118,"Invalid parameter" 2. SYSTem:VERSion? Syntax SYSTem:VERSion? Function Query the current edition number of the instrument. Return Value The query returns a character string in following format: 00.02.00.06.00.02.06 3.
PAGE 73
DG1000 Command System Function 8. RIGOL Activate remote state, display RMT indicator and lock the front panel (except the Local button) . SYSTem:CLKSRC Syntax SYSTem:CLKSRC {EXT|INT} Function Select the system clock source as internal or external, the default is INT. Explanation When external clock source is activated, the system accepts the clock source from [10 MHz In] connector on the rear panel. Example SYST:CLKSRC EXT 9.
PAGE 74
RIGOL DG1000 Command System PHASe PHASe commands are used for setting the initial phase of signals from each channel and setting the align phase output of dual channels. DG1000 supports following PHASe commands: 1. 2. 3. 4. 5.
PAGE 75
DG1000 Command System RIGOL Detailed information of each command: 1. PHASe Syntax PHASe {|MINimum|MAXimum} Function Set the initial phase of signals output from CH1. Explanation is the phase set by users, the default unit is degree. MIN=-180°, MAX=180°。 Return Value PHAS 90 2. PHASe? Syntax PHASe? [MINimum|MAXimum] Function Query the initial phase of signals output from CH1. Return Value The query returns any numerical value between -180 and 180, such as: 90.000. 3.
PAGE 76
RIGOL DG1000 Command System DISPlay DISPlay commands are used for controlling the display of front panel. DG1000 supports following DISPlay commands: 1. 2. 3. DISPlay DISPlay:CONTRAST DISPlay:LUMINANCEDISPlay:LUMINANCE Detailed information of each command: 1. DISPlay Syntax DISPlay {OFF|ON} Function Enable or disable the display function of front panel. Example DISP OFF 2. DISPlay:CONTRAST Syntax DISPlay:CONTRAST Function Set the contrast of display within 0 and 31.
PAGE 77
DG1000 Command System RIGOL COUPling COUPling commands are used for channel coupling or copying. DG1000 supports following COUPling commands: 1. 2. 3. 4. 5. 6. 7. 8. 9.
PAGE 78
RIGOL DG1000 Command System Detailed information of each command: 1. COUPling Syntax COUPling {OFF|ON} Function Enable or disable coupling function. Example COUP OFF 2. COUPling? Syntax COUPling? Function Query the coupling state. Return Value The query returns OFF or ON. 3. COUPling:BASEdchannel Syntax COUPling:BASEdchannel{:CH1|:CH2} Function Select the base channel of channel coupling. Example COUP:BASE:CH1 4.
PAGE 79
DG1000 Command System RIGOL Function Set the frequency deviation of channel coupling and the default unit is Hz. Explanation : 0Hz to 20MHz Example COUP:FREQDEV 100 8. COUPling:FREQDEViation? Syntax COUPling:FREQDEViation? Function Query the frequency deviation. Return Value The query returns the frequency deviation in scientific notation and the default unit is Hz, such as: 1.000000e+02. 9.
PAGE 80
RIGOL DG1000 Command System COUNter COUNter commands are used to enable the counter and set or query related parameters. DG1000 supports following COUNter commands: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14.
PAGE 81
DG1000 Command System RIGOL Detailed information of each command: 1. COUNter Syntax COUNter {OFF|ON} Function Disable or enable the counter. Example COUN ON 2. COUNter:COUPling Syntax COUNter:COUPling {AC|DC} Function Set the coupling mode to AC or DC. Example COUN:COUP AC 3. COUNter:COUPling? Syntax COUNter:COUPling? Function Query the coupling mode selected. Return Value The query returns AC or DC. 4.
PAGE 82
RIGOL DG1000 Command System 7. COUNter:TLEVel? Syntax COUNter:TLEVel? Function Query the trigger level set. Return Value The query returns the trigger level currently set in decimal format, such as: 62.000000. 8. COUNter:HFRS Syntax COUNter:HFRSl {ON|OFF} Function Enable or disable high-frequency reject.
PAGE 83
DG1000 Command System RIGOL 12. COUNter:DCYCle? Syntax COUNter:DCYCle? Function Query the duty cycle measurement value of the counter. Return Value The query returns the duty cycle in percentage, such as: 50.0%. 13. COUNter:POSWidth? Syntax COUNter:POSWidth? Function Query the positive pulse width measurement value of the counter. Return Value The query returns the positive pulse width in scientific notation and in seconds, such as: 5.00358e-04. 14.
PAGE 84
PAGE 85
Application Examples RIGOL Chapter 3 Application Examples This chapter shows you how to realize the examples in DG1000 User’s Guide via commands, you can compare it with the introduction in User’s Guide to get deeper understanding of the usage of commands. The number before every command in these examples is not the content of command. The content enclosed in “ / * ” and “ * / ” behind every command is note (not a part of the command) which is used to assist user to understand the command well.
PAGE 86
RIGOL Application Examples Example 1: To Generate a Sine Wave Target: Generate a sine wave with 20 kHz frequency, 2.5 Vpp amplitude, 500mVDC offset and 10°phase via CH1. How to realize via commands? Method1: 0 1 2 *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 frequency, 5VRMS amplitude, 10mVDC offset and 60°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
RIGOL Application Examples Example 3: To Generate an User-defined Arbitrary Wave Target: Generate a user-defined arbitrary ramp wave with 10μs period, 4V high level and -4V 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, 0 and 16383 separately correspond to the minmum and maximum amplitudes, that is: -4 V corresponds to 0 and 4 V corresponds to 16383.
PAGE 89
Application Examples 7 8 FUNC:USER VOLATILE OUTP ON Programming Guide for DG1000 RIGOL /*Load the 4 decimal numbers to volatile memory */ /*Output the waves in volatile memory */ /* Enable the [Output] connector of CH1 at the front panel */ 3-5
PAGE 90
RIGOL Application Examples Example 4: To Generate a FSK Wave Target: Generate a FSK wave with 10 kHz, 5 Vpp, 0 VDC carrier wave (Sine), internal modulation source, 800 Hz hop frequency and 200 Hz FSK rate.
PAGE 91
RIGOL Application Examples Example 5: To Generate a Linear Sweep Wave Target: Generate a sweep sine wave with 100 Hz to 10 kHz frequency, internal trigger, linear mode and 1 s sweep time.
PAGE 92
RIGOL Application Examples Example 6: To Generate a Burst Wave Target: Generate a burst: 3-cycle square, 0°initial phase, 10 ms burst period and 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
RIGOL Application Examples Example 7: To Output Waves via Dual Channels Target: Output a 1kHz, 2.5Vpp, 500mVDC, 10° sine wave, via CH1 and a 1.5kHz, 5Vpp, 1 VDC, 20° ramp wave via CH2. How to realize via commands? 0 1 2 *IDN? VOLT:UNIT VPP APPL:SIN 1000,2.5,0.
PAGE 94
RIGOL Application Examples Example 8: Channel Coupling Target: Output a 1kHz, 5Vpp, 0VDC, 0° sine wave via CH1 and a 1.5kHz, 5Vpp, 0 VDC, 0° ramp wave via CH2, and then, take CH1 as the base channel and set the phase deviation as 10°, finally, observe the phase of wave output from CH2 after coupling.
PAGE 95
RIGOL Application Examples Example 9: Channel Copy Target: Output a 1kHz, 5Vpp, 500mVDC, 10° sine wave via CH1 and a 1.5kHz, 2Vpp, 0 VDC, 0° ramp wave 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? VOLT:UNIT VPP APPL:SIN 1000,5,0.
PAGE 96
PAGE 97
RIGOL Appendix: Commands Reference A-Z Appendix: Commands Reference A-Z *IDN? 2-2 A AM:SOURce 2-32 AM:SOURce? 2-32 AM:INTernal:FUNCtion 2-32 AM:INTernal:FUNCtion? 2-32 AM:INTernal:FREQuency 2-32 AM:INTernal:FREQuency? 2-32 AM:DEPTh 2-33 AM:DEPTh? 2-33 AM:STATe 2-33 AM:STATe? 2-33 APPLy:SINusoid 2-4 APPLy:SQUare 2-4 APPLy:RAMP 2-4 APPLy:PULSe 2-4 APPLy:NOISe 2-5 APPLy:DC 2-5 APPLy:USER 2-5 APPLy? 2-6 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 APPL
PAGE 98
RIGOL D DATA 2-53 DATA:DAC 2-53 DATA:COPY 2-54 DATA:DELete 2-54 DATA:CATalog? 2-54 DATA:RENAME 2-54 DATA:NVOLatile:CATalog? 2-55 DATA:NVOLatile:FREE? 2-55 DATA:ATTRibute:POINts? 2-55 DATA:LOAD 2-55 DISPlay 2-64 DISPlay:CONTRAST 2-64 DISPlay:LUMINANCE 2-64 F FM:SOURce 2-35 FM:SOURce? 2-35 FM:INTernal:FUNCtion 2-35 FM:INTernal:FUNCtion? 2-35 FM:INTernal:FREQuency 2-35 FM:INTernal:FREQuency? 2-35 FM:DEViation 2-36 FM:DEViation? 2-36 FM:STATe 2-36 FM:STATe? 2-36 FREQuency 2-16 FREQuency? 2-16 FREQuency:CH2 2-1
PAGE 99
RIGOL Appendix: Commands Reference A-Z OUTPut:LOAD 2-25 OUTPut:LOAD? 2-25 OUTPut:POLarity 2-25 OUTPut:POLarity? 2-25 OUTPut:SYNC 2-26 OUTPut:SYNC? 2-26 OUTPut:TRIGger:SLOPe 2-26 OUTPut:TRIGger:SLOPe? 2-26 OUTPut:TRIGger 2-26 OUTPut:TRIGger? 2-26 OUTPut:CH2 2-27 OUTPut:CH2? 2-27 OUTPut:LOAD:CH2 2-27 OUTPut:LOAD:CH2? 2-27 OUTPut:POLarity:CH2 2-27 OUTPut:POLarity:CH2? 2-27 P PHASe 2-63 PHASe? 2-63 PHASe:CH2 2-63 PHASe:CH2? 2-63 PHASe:ALIGN 2-63 PM:SOURce 2-38 PM:SOURce? 2-38 PM:INTernal:FUNCtion 2-38 PM:INTe
PAGE 100
RIGOL VOLTage:LOW 2-20 VOLTage:LOW? 2-21 VOLTage:OFFSet 2-21 VOLTage:OFFSet? 2-21 VOLTage:UNIT 2-21 VOLTage:UNIT? 2-21 VOLTage:CH2 2-21 VOLTage:CH2? 2-21 4 Appendix: Commands Reference A-Z VOLTage:HIGH:CH2 2-22 VOLTage:HIGH:CH2? 2-22 VOLTage:LOW:CH2 2-22 VOLTage:LOW:CH2? 2-23 VOLTage:OFFSet:CH2 2-23 VOLTage:OFFSet:CH2? 2-23 VOLTage:UNIT:CH2 2-23 VOLTage:UNIT:CH2? 2-23 Programming Guide for DG1000