DG1000Z Programming Guide EN
DG1000Z_ProgrammingGuide_EN
User Manual:
Open the PDF directly: View PDF .
Page Count: 264
Download | |
Open PDF In Browser | View PDF |
RIGOL Programming Guide DG1000Z Series Function/Arbitrary Waveform Generator Oct. 2016 RIGOL TECHNOLOGIES, INC. RIGOL Guaranty and Declaration Copyright © 2014 RIGOL TECHNOLOGIES, INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL TECHNOLOGIES, INC. Publication Number PGB09106-1110 Notices RIGOL products are covered by P.R.C. and foreign patents, issued and pending. RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at Information in this publication replaces all previously corresponding material. Information in this publication is subject to change without notice. RIGOL shall not be liable for losses caused by either incidental or consequential in connection with Any part of this document is forbidden to be copied or photocopied or rearranged without prior written company’s sole decision. the furnishing, use or performance of this manual as well as any information contained. approval of RIGOL. Product Certification RIGOL guarantees this product conforms to the national and industrial standards in China as well as the ISO9001:2008 standard and the ISO14001:2004 standard. Other international standard conformance certification is in progress. Contact Us If you have any problem or requirement when using our products or this manual, please contact RIGOL. E-mail: service@rigol.com Website: www.rigol.com DG1000Z Programming Guide I RIGOL Document Overview This manual introduces how to program the signal generator over the remote interfaces in details. Main Topics in this Manual: Chapter 1 Programming Overview This chapter introduces how to build the remote communication between the signal generator and PC and how to control the signal generator remotely. It also introduces the syntax, symbols, parameter types and abbreviation rules of the SCPI commands. Chapter 2 Command System This chapter introduces the syntax, function, parameters and using instructions of each DG1000Z command in A-Z order. Chapter 3 Application Examples This chapter provides the application examples of the main functions of the signal generator. In the examples, a series of commands are combined to realize the basic functions of the signal generator. Chapter 4 Programming Demos This chapter introduces how to program and control DG1000Z using various development tools, such as Visual C++, Visual Basic and LabVIEW. Chapter 5 Appendix This chapter provides the command list and the factory settings. Tip For the newest version of this manual, download it from www.rigol.com. Format Conventions in this Manual: 1. Button The function key at the front panel is denoted by the format of “Button Name (Bold) + Text Box” in the manual, for example, Utility denotes the “Utility” key. 2. Menu The menu item is denoted by the format of “Menu Word (Bold) + Character Shading” in the manual, for example, System denotes the “System” item under Utility. 3. Operation Step The next step of the operation is denoted by an arrow “” in the manual. For example, Utility System denotes pressing Utility at the front panel and then pressing System. Content Conventions in this Manual: DG1000Z series function/arbitrary waveform generator includes the following models. Unless otherwise noted in this manual, DG1062Z is taken as an example to introduce each command of the DG1000Z series. Model Channels Max. Output Frequency II DG1062Z 2 60MHz DG1032Z 2 30MHz DG1022Z 2 25MHz DG1000Z Programming Guide Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 Programming Overview......................................................................................1-1 To Build Remote Communication ............................................................................................... 1-2 Remote Control Methods ........................................................................................................... 1-4 SCPI Command Overview .......................................................................................................... 1-4 Syntax ............................................................................................................................... 1-4 Symbol Description ............................................................................................................ 1-5 Parameter Type .................................................................................................................. 1-5 Command Abbreviation ...................................................................................................... 1-6 Chapter 2 Command System ...............................................................................................2-1 :COUNter Commands ................................................................................................................ 2-3 :COUPling Commands ............................................................................................................... 2-9 :DISPlay Commands ............................................................................................................... 2-23 :HCOPy Commands................................................................................................................. 2-28 IEEE488.2 Common Commands............................................................................................... 2-29 :LICense Command ................................................................................................................ 2-37 :LXI Commands ...................................................................................................................... 2-38 :MEMory Commands ............................................................................................................... 2-41 :MMEMory Commands ............................................................................................................ 2-46 :OUTPut Commands ............................................................................................................... 2-55 :PA Commands ....................................................................................................................... 2-62 :ROSCillator Commands .......................................................................................................... 2-65 :SOURce Commands ............................................................................................................... 2-67 :SOURce:APPLy Commands .............................................................................................. 2-72 :SOURce:BURSt Commands .............................................................................................. 2-82 :SOURce:FREQuency Commands ...................................................................................... 2-92 :SOURce:FUNCtion Commands ....................................................................................... 2-101 :SOURce:HARMonic Commands ...................................................................................... 2-111 :SOURce:MARKer Commands.......................................................................................... 2-116 :SOURce[:MOD]:AM Commands...................................................................................... 2-118 :SOURce[:MOD]:ASKey Commands ................................................................................. 2-123 :SOURce[:MOD]:FM Commands ...................................................................................... 2-127 :SOURce[:MOD]:FSKey Commands ................................................................................. 2-132 :SOURce[:MOD]:PM Commands ...................................................................................... 2-137 :SOURce[:MOD]:PSKey Commands ................................................................................. 2-142 :SOURce[:MOD]:PWM Commands ................................................................................... 2-146 :SOURce:MOD Commands .............................................................................................. 2-152 :SOURce:PERiod Command ............................................................................................ 2-154 :SOURce:PHASe Commands ........................................................................................... 2-155 :SOURce:PULSe Commands ............................................................................................ 2-156 :SOURce:SUM Commands .............................................................................................. 2-160 :SOURce:SWEep Commands ........................................................................................... 2-163 :SOURce:TRACe Commands ........................................................................................... 2-173 :SOURce:TRACK Command............................................................................................. 2-180 :SOURce:VOLTage Comamnds ........................................................................................ 2-181 :SYSTem Commands ............................................................................................................. 2-188 :TRIGger Commands ............................................................................................................ 2-205 Chapter 3 Application Examples .........................................................................................3-1 To Output Basic Waveform ........................................................................................................ 3-2 To Output Arbitrary Waveform ................................................................................................... 3-2 To Output Harmonic Waveform .................................................................................................. 3-3 DG1000Z Programming Guide III RIGOL Contents To To To To To Output AM Modulated Waveform ........................................................................................... 3-3 Output FSK Modulated Waveform .......................................................................................... 3-4 Output Sweep Waveform ...................................................................................................... 3-5 Output Burst Waveform ........................................................................................................ 3-6 Use the Frequency Counter Function...................................................................................... 3-6 Chapter 4 Programming Demos ......................................................................................... 4-1 Programming Preparations ......................................................................................................... 4-2 Excel Programming Demo .......................................................................................................... 4-3 Matlab Programming Demo........................................................................................................ 4-6 LabVIEW Programming Demo .................................................................................................... 4-7 Visual Basic Programming Demo .............................................................................................. 4-14 Visual C++ Programming Demo ............................................................................................... 4-17 Chapter 5 Appendix............................................................................................................ 5-1 Appendix A: Command List ........................................................................................................ 5-1 Appendix B: Factory Setting ..................................................................................................... 5-10 Appendix C: Warranty ............................................................................................................. 5-14 IV DG1000Z Programming Guide Chapter 1 Programming Overview RIGOL Chapter 1 Programming Overview This chapter introduces how to build the remote communication between the signal generator and PC and how to control the signal generator remotely. It also introduces the syntax, symbols, parameter types and abbreviation rules of the SCPI commands. Main topics of this chapter: To Build Remote Communication Remote Control Methods SCPI Command Overview DG1000Z Programming Guide 1-1 RIGOL Chapter 1 Programming Overview To Build Remote Communication You can build the remote communication between DG1000Z and the PC via the USB (USB Device), LAN or GPIB interface (option, extended from the USB Host interface using the USB-GPIB interface converter). Operation Steps: 1. Install the Ultra Sigma common PC software Download the Ultra Sigma common PC software from www.rigol.com and install it according to the instructions. 2. Connect the instrument and PC and configure the interface parameters of the instrument DG1000Z supports the USB, LAN and GPIB (option, extended from the USB Host interface using the USB-GPIB interface converter) communication interfaces, as shown in the figure below. LAN USB Device (a) USB Host (b) Figure 1-1 DG1000Z Communication Interfaces 1-2 1) Use the USB interface: connect the USB Device interface at the rear panel of DG1000Z and the USB Host interface of the PC using a USB cable. The “Found New Hardware Wizard” dialog box will be displayed and please install the “USB Test and Measurement Device (IVI)” according to the instructions (refer to “Remote Control via USB” in Chapter 3 “Remote Control” in DG1000Z User’s Guide). 2) Use the LAN interface: Make sure that your PC is connected to the local network. Check whether your local network supports the DHCP or auto IP mode. If not, you need to DG1000Z Programming Guide RIGOL Chapter 1 Programming Overview 3) 3. acquire the network interface parameters available, such as the IP address, subnet mask, default gateway and DNS service. Connect DG1000Z to the local network using a network cable. Press Utility I/O Config LAN to configure the IP address, subnet mask, default gateway and DNS service. Use the GPIB interface: Extend a GPIB interface by connecting the USB Host interface at the front panel of DG1000Z using the USB-GPIB interface converter. Connect the instrument and PC using a GPIB cable. Press Utility I/O Config GPIB to set the GPIB address of the instrument. Check whether the connection is successful Start up the Ultra Sigma and the software will automatically search for the instrument resources currently connected to the PC. Right click the resource name and select “SCPI Panel Control”. Input a correct command in the pop-up SCPI control panel and click and subsequentially or directly click to check whether the connection is successful, as shown in the figure below (the USB interface is taken as an example). DG1000Z Programming Guide 1-3 RIGOL Chapter 1 Programming Overview Remote Control Methods 1. User-defined Programming Users can use the SCPI (Standard Commands for Programmable Instruments) commands listed in chapter 2 “Command System” of this manual to program and control the instrument in various development environments (such as Visual C++, Visual Basic, LabVIEW and so on). For details, refer to the introductions in chapter 4 “Programming Demos”. 2. Send SCPI Commands via the PC Software You can control the signal generator remotely by sending the SCPI commands via the PC software (Ultra Sigma) provided by RIGOL. Besides, you can also control the instrument using the “Measurement & Automation Explorer” of NI (National Instruments Corporation) or the “Agilent IO Libraries Suite” of Agilent (Agilent Technologies, Inc.). SCPI Command Overview SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming language that is built upon the standard IEEE488.1 and IEEE 488.2 and conforms to various standards (such as the floating point operation rule in IEEE754 standard, ISO646 7-bit coded character for information interchange (equivalent to ASCll programming)). This section introduces the syntax, symbols, parameters and abbreviation rules of the SCPI commands. Syntax The SCPI commands provide a hierarchical tree structure and include multiple subsystems. Each command subsystem consists of a root keyword and one or more sub-keywords.The command string usually starts with ":"; 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; the command and parameter are separated by space. For example, :SYSTem:COMMunicate:LAN:IPADdress:SYSTem:COMMunicate:LAN:IPADdress? SYSTem is the root keyword of the command. COMMunicate, LAN and IPADdress are the second-level, third-level and forth-level keywords respectively. The command string starts with ":" which is also used to separate the multiple-level keywords. represents the parameters available for setting. "?" represents query; the instrument returns the corresponding information (the input value or internal setting value of the instrument) when recieving the query command. The command :SYSTem:COMMunicate:LAN:IPADdress and parameter are separated by space. "," is generally used for separating multiple parameters contained in the same command, for example, :DISPlay:TEXT[:SET] [,x[,y]] 1-4 DG1000Z Programming Guide Chapter 1 Programming Overview RIGOL Symbol Description The following symbols are not the content of the SCPI commands and will not be sent with the commands. They are usually used to describe the parameters in the commands. 1. Braces {} Multiple optional parameters are enclosed in the braces and one of the parameters must be selected when sending the command. For example, :DISPlay:MODE {DPV|DGV|SV}. 2. Vertical Bar | The vertical bar is used to separate multiple parameters and one of the parameters must be selected when sending the command. For example, :DISPlay:MODE {DPV|DGV|SV}. 3. Square Brackets [] The content (command keyword or parameter) in the square brackets can be omitted. If the parameter is omitted, the instrument will set the parameter to its default. For example, for the :COUNter:STATIstics[:STATe]? command, send any of the following two commands can achieve the same effect. :COUNter:STATIstics? :COUNter:STATIstics:STATe? 4. Triangle Brackets <> The parameter enclosed in the triangle brackets must be replaced by an effective value. For example, sending the :COUNter:LEVEl command in :COUNter:LEVEl 1 form. Parameter Type The parameters of the commands introduced in this manual contain the following 5 types: bool, integer, real number, discrete and ASCII string. 1 Bool The parameter could be ON (1) or OFF (0). For example, :COUNter:HF {ON|1|OFF|0}. 2 Integer Unless otherwise noted, the parameter can be any integer within the effective value range. Note that do not set the parameter to a decimal; otherwise, errors will occur. For example, in the :DISPlay:BRIGhtness command, can be any integer from 0 to 100. 3 Real Number Unless otherwise noted, the parameter can be any real number within the effective value range. For example, the range of in the :COUNter:LEVEl command is from -2.5V to 2.5V. 4 Discrete The parameter could only be one of the specified values or characters. For example, in the :DISPlay:MODE {DPV|DGV|SV} command, the parameter can only be DPV, DGV or SV. 5 ASCII String The parameter should be the combinations of ASCII characters. For example, in the :MMEMory:LOAD:STATe command, is the filename of the state file to be loaded under the current directory of the external memory and can include English characters and numbers. Besides, you can replace the parameters in many commands with MINimum or MAXimum to set the parameters to their minimum or maximum value. For example, MINimum and MAXimum in the :DISPlay:BRIGhtness { |MINimum|MAXimum} command are used to set the brightness to the minimum or maximum. DG1000Z Programming Guide 1-5 RIGOL Chapter 1 Programming Overview Command Abbreviation All the commands are case-insensitive and you can use any of them. If abbreviation is used, all the capital letters in the command must be written completely. For example, the :COUNter:COUPling? command can be abbreviated to :COUN:COUP?. 1-6 DG1000Z Programming Guide RIGOL Chapter 2 Command System Chapter 2 Command System This chapter introduces the syntax, function, parameter and using instruction of each DG1000Z command in A-Z order. Main topics of this chapter: :COUNter Commands :COUPling Commands :DISPlay Commands :HCOPy Commands IEEE488.2 Common Commands :LICense Command :LXI Commands :MEMory Commands :MMEMory Commands :OUTPut Commands :PA Commands :ROSCillator Commands :SOURce Commands :SYSTem Commands :TRIGger Commands Explanation: In this command system, setting commands relating to the frequency and amplitude parameters can be sent with units. The units available and the default unit of each parameter are as shown in the table below. Parameter Type Units Available Default Unit Frequency MHz/kHz/Hz/uHz Hz Sample Rate MSa/s、kSa/s、Sa/s、uSa/s Sa/s Amplitude Vpp/mVpp/Vrms/mVrms/dBm Vpp/Vrms/dBm (depend on the parameter to be set) Offset VDC/mVDC VDC High Level/Low Level V/mV V Time s/ms/us/ns s Phase ° ° Duty Cycle/ Modulation Depth/ Brightness/ Contrast % % Impedance Ω Ω DG1000Z Programming Guide 2-1 RIGOL Chapter 2 Command System Note: In this manual, the range of the parameter in the command is based on DG1062Z. As all the commands are case-insensitive, for DG1000Z, MHZ (mhz) and MSA/S (msa/s) are interpreted as megahertz and mega points per second respectively; while MVPP (mvpp), MVRMS (mvrms), MVDC (mvdc), MV (mv) and MS (ms) are interpreted as millivolt (peak-peak value), millivolt (effective value), millivolt (DC), millivolt and millisecond respectively. When the output impedance is HighZ, the amplitude unit dBm is invalid. 2-2 DG1000Z Programming Guide RIGOL Chapter 2 Command System :COUNter Commands The :COUNter commands are used to turn on or off the frequency counter and set the related information of the frequency counter. Command List[1]: :COUNter:AUTO :COUNter:COUPling :COUNter:GATEtime :COUNter:HF :COUNter:LEVEl :COUNter:MEASure? :COUNter:SENSitive :COUNter[:STATe] :COUNter:STATIstics:CLEAr :COUNter:STATIstics:DISPlay :COUNter:STATIstics[:STATe] :COUNter:AUTO Syntax :COUNter:AUTO Description The instrument will select a proper gate time automatically according to the characteristics of the signal under test after sending this command. Explanation You can also send the :COUNter:GATEtime command to set the desired gate time. Related Command :COUNter:GATEtime :COUNter:COUPling Syntax :COUNter:COUPling {AC|DC} :COUNter:COUPling? Description Set the coupling mode of the input signal to AC or DC. Query the coupling mode of the input signal. Parameter Return Format Example Name Type Range Default {AC|DC} Discrete AC|DC AC The query returns AC or DC. :COUN:COUP DC /*Set the coupling mode of the input signal to DC*/ :COUN:COUP? /*Query the coupling mode of the input signal and the query returns DC*/ Note[1]: In the “Command List” in this manual, the parameters in the setting commands and the query commands are not included and you can refer to the complete introductions of the commands in the text according to the keywords. DG1000Z Programming Guide 2-3 RIGOL Chapter 2 Command System :COUNter:GATEtime Syntax :COUNter:GATEtime {USER1|USER2|USER3|USER4|USER5|USER6} :COUNter:GATEtime? Description Select the gate time of the measurement system. Query the gate time of the measurement system. Parameter Explanation Return Format Example Related Command 2-4 Name Type Range Default {USER1|USER2|USER3| USER4|USER5|USER6} Discrete USER1|USER2|USER3| USER4|USER5|USER6 USER1 The gate times represented by USER1 to USER6 are as shown in the table below. USER1 USER2 USER3 USER4 USER5 USER6 1.310ms 10.48ms 166.7ms 1.342s 10.73s >10s For low-frequency signals (for example, the frequency is lower than 5Hz), you are recommended to set the gate time to USER6. Send the :COUNter:AUTO command and the instrument will select a proper gate time automatically according to the characteristics of the signal under test. During this process, “AUTO” is displayed in the gate time area in the frequency counter interface. The gate time currently selected by the instrument will be displayed in the gate time area in the frequency counter interface after the instrument selects a proper gate time. If users have currently selected a gate time, the query returns USER1, USER2, USER3, USER4, USER5 or USER6. If users send the :COUNter:AUTO command to let the instrument select a proper gate time automatically, the query returns “AUTO” during this process and returns USER1, USER2, USER3, USER4, USER5 or USER6 after a proper gate time is selected by the instrument. :COUN:GATE USER2 /*Set the gate time of the measurement system to USER2 (10.48ms)*/ :COUN:GATE? /*Query the gate time of the measurement system and the query returns USER2*/ :COUNter:AUTO DG1000Z Programming Guide RIGOL Chapter 2 Command System :COUNter:HF Syntax :COUNter:HF {ON|1|OFF|0} :COUNter:HF? Description Enable or disable the high-frequency rejection function of the frequency counter. Query the on/off status of the high-frequency rejection function of the frequency counter. Parameter Explanation Return Format Example Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 OFF Enable the high-frequency rejection when measuring low-frequency signal with lower than 250kHz frequency to filter out the high-frequency noise and improve the measurement accuracy. Disable the high-frequency rejection when measuring high-frequency signal with greater than 250kHz frequency; at this point, the maximum input frequency is 200MHz. The query returns ON or OFF. :COUN:HF ON /*Enable the high-frequency rejection function of the frequency counter*/ :COUN:HF? /*Query the on/off status of the high-frequency rejection function of the frequency counter and the query returns ON*/ :COUNter:LEVEl Syntax :COUNter:LEVEl { |MINimum|MAXimum} :COUNter:LEVEl? [MINimum|MAXimum] Description Set the trigger level of the frequency counter. Query the trigger level of the frequency counter. Parameter Explanation Return Format Example Name Type Range Default Real -2.5V to 2.5V 0V The frequency counter starts measuring when the input signal reaches the specified trigger level. The minimum resolution is 6mV. The query returns the trigger level in scientific notation. The return value contains 7 effective digits, for example, 1.500000E+00 (the trigger level is 1.5V). :COUN:LEVE 1.5 /*Set the trigger level of the frequency counter to 1.5V*/ :COUN:LEVE? /*Query the trigger level of the frequency counter and the query returns 1.500000E+00*/ DG1000Z Programming Guide 2-5 RIGOL Chapter 2 Command System :COUNter:MEASure? Syntax :COUNter:MEASure? Description Query the measurement results of the frequency counter. Explanation When the frequency counter is in the “RUN” or “SINGLE” state, send this command to query the measurement values. When the frequency counter is in the “STOP” state, send this command to query the measurement values of the last measurement. Return Format The query returns a string consisting of 5 parts (represent the frequency, period, duty cycle, positive pulse width and negative pulse width respectively) separated by commas. Each part is expressed in scientific notation and contains 10 effective bits, for example, 2.000000000E+03,5.000000000E-04,4.760800000E+01,2.380415000E-04, 2.619585000E-04 (represents the measurement result is 2kHz frequency, 500us period, 47.608% duty cycle, 238.0415us positive pulse width and 261.9585us negative pulse width). When the frequency counter function is disabled, the query returns 0.000000000E+00,0.000000000E+00, 0.000000000E+00,0.000000000E+00,0.000000000E+00. Example :COUN:MEAS? /*Query the measurement results of the frequency counter and the query returns 2.000000000E+03,5.000000000E-04, 4.760800000E+01,2.380415000E-04,2.619585000E-04*/ :COUNter:SENSitive Syntax :COUNter:SENSitive { |MINimum|MAXimum} :COUNter:SENSitive? [MINimum|MAXimum] Description Set the trigger sensitivity of the frequency counter. Query the trigger sensitivity of the frequency counter. Parameter Explanation Return Format Example 2-6 Name Type Range Default Real 0% to 100% 25% Relatively higher sensitivity is recommended for signal with small amplitude; low sensitivity is recommended for low-frequency signal with large amplitude or signal with slow rising edge to ensure more accurate measurement result. The query returns the trigger sensitivity in scientific notation. The return value contains 7 effective digits, for example, 3.000000E+01 (the trigger sensitivity of the frequency counter is 30%). :COUN:SENS 30 /*Set the trigger sensitivity of the frequency counter to 30%*/ :COUN:SENS? /*Query the trigger sensitivity of the frequency counter and the query returns 3.000000E+01*/ DG1000Z Programming Guide RIGOL Chapter 2 Command System :COUNter[:STATe] Syntax :COUNter[:STATe] {ON|1|OFF|0|RUN|STOP|SINGLE} :COUNter[:STATe]? Description Set the status of the frequency counter. Query the status of the frequency counter. Parameter Name {ON|1|OFF|0|RUN|STOP| SINGLE} Explanation Return Format Example Type Discrete Range ON|1|OFF|0|RUN|STOP| SINGLE Default OFF “ON” and “1” denote enabling the frequency counter function; “OFF” and “0” denote disabling the frequency counter function; “RUN”, “STOP” and “SINGLE” denote setting the running status of the frequency counter to “run”, “stop” and “single” respectively. The command for setting the running status (the parameter is RUN, STOP or SINGLE) is only valid when the frequency counter function is enabled. When the frequency counter function is enabled, the sync output of CH2 will be disabled. In the “RUN” status, the frequency counter measures the input signal continuously according to the current configuration. In the “SINGLE” status, the frequency counter executes a measurement and then stops. In the “STOP” status, the frequency counter stops measuring. When the frequency counter is enabled, the default running status is “run” and the instrument measures the input signal continuously according to the current configuration. At this point, if you send the :COUNter:STATe SINGLE command, the frequency counter enters the “single” status, finishes the current measurement and then stops; if you send the :COUNter:STATe STOP command, the frequency counter enters the “STOP” state immediately. When the frequency counter is in the “STOP” status, the frequency counter performs a measurement and then enters the “STOP” status each time you send the :COUNter:STATe SINGLE command. When the frequency counter function is enabled, the query returns the current running status (RUN, STOP or SINGLE); when the frequency counter function is disabled, the query returns OFF. :COUN OFF /*Disable the frequency counter function*/ :COUN? /*Query the status of the frequency counter and the query returns OFF*/ :COUN 1 /*Enable the frequency counter function*/ :COUN? /*Query the status of the frequency counter and the query returns RUN (the default running status)*/ :COUN STOP /*Set the running status of the frequency counter to “STOP”*/ :COUN? /*Query the status of the frequency counter and the query returns STOP*/ DG1000Z Programming Guide 2-7 RIGOL Chapter 2 Command System :COUNter:STATIstics:CLEAr Syntax :COUNter:STATIstics:CLEAr Description Clear the statistic results. Explanation This command is only valid when the statistic function of the frequency counter is enabled (:COUNter:STATIstics[:STATe]). The statistic results are cleared automatically when the statistic function of the frequency counter is disabled. Related Command :COUNter:STATIstics[:STATe] :COUNter:STATIstics:DISPlay Syntax :COUNter:STATIstics:DISPlay {DIGITAL|CURVE} :COUNter:STATIstics:DISPlay? Description Set the display format of the statistic results of the measurement values of the frequency counter to DIGITAL or CURVE. Query the display format of the statistic results of the measurement values of the frequency counter. Parameter Return Format Example Name Type Range Default {DIGITAL|CURVE} Discrete DIGITAL|CURVE DIGITAL The query returns DIGITAL or CURVE. :COUN:STATI:DISP CURVE :COUN:STATI:DISP? /*Set the display format of the statistic results of the measurement values of the frequency counter to CURVE*/ /*Query the display format of the statistic results of the measurement values of the frequency counter and the query returns CURVE*/ :COUNter:STATIstics[:STATe] Syntax :COUNter:STATIstics[:STATe] {ON|1|OFF|0} :COUNter:STATIstics[:STATe]? Description Enable or disable the statistic function of the measurement values of the frequency counter. Query the on/off status of the statistic function of the measurement values of the frequency counter. Parameter Return Format Example 2-8 Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 OFF The query returns ON or OFF. :COUN:STATI ON /*Enable the statistic function of the measurement values of the frequency counter*/ :COUN:STATI? /*Query the on/off status of the statistic function of the measurement values of the frequency counter and the query returns ON*/ DG1000Z Programming Guide Chapter 2 Command System RIGOL :COUPling Commands The :COUPling commands are used to set the related information of the channel frequency coupling, amplitude coupling and phase coupling as well as enable and disable the three coupling functions. Command List: :COUPling:AMPL:DEViation :COUPling:AMPL:MODE :COUPling:AMPL:RATio :COUPling:AMPL[:STATe] :COUPling:FREQuency:DEViation :COUPling:FREQuency:MODE :COUPling:FREQuency:RATio :COUPling:FREQuency[:STATe] :COUPling:PHASe:DEViation :COUPling:PHASe:MODE :COUPling:PHASe:RATio :COUPling:PHASe[:STATe] :COUPling[:STATe] Note: The coupling function is only valid when both the two channels are in the basic waveform (Sine, Square, Ramp) or arbitrary waveform (except DC) mode. DG1000Z Programming Guide 2-9 RIGOL Chapter 2 Command System :COUPling:AMPL:DEViation Syntax :COUPling:AMPL:DEViation :COUPling:AMPL:DEViation? Description Set the amplitude deviation in the amplitude coupling. Query the amplitude deviation in the amplitude coupling. Parameter Explanation Return Format Example Related Commands Name Type Range Default Real -19.998Vpp to 19.998Vpp 0Vpp Select the desired amplitude coupling mode (:COUPling:AMPL:MODE) and set the corresponding amplitude deviation or amplitude ratio (:COUPling:AMPL:RATio) before enabling the amplitude coupling function (:COUPling:AMPL[:STATe]). You cannot set the amplitude coupling mode and amplitude deviation/ratio after the amplitude coupling function is enabled. When the amplitude coupling function is disabled, if the current amplitude coupling mode is amplitude deviation, send this command can set the amplitude deviation; if the current amplitude coupling mode is amplitude ratio, send this command can set the amplitude coupling mode to amplitude deviation and set the amplitude deviation. The query returns the amplitude deviation in scientific notation. The return value contains 7 effective digits, for example, 1.000000E+00 (the amplitude deviation is 1Vpp). :COUP:AMPL:DEV 1 /*Set the amplitude deviation in the amplitude coupling to 1Vpp*/ :COUP:AMPL:DEV? /*Query the amplitude deviation in the amplitude coupling and the query returns 1.000000E+00*/ :COUPling:AMPL:MODE :COUPling:AMPL:RATio :COUPling:AMPL[:STATe] 2-10 DG1000Z Programming Guide RIGOL Chapter 2 Command System :COUPling:AMPL:MODE Syntax :COUPling:AMPL:MODE {OFFSet|RATio} :COUPling:AMPL:MODE? Description Set the amplitude coupling mode to amplitude deviation (OFFSet) or amplitude ratio (RATio). Query the selected amplitude coupling mode. Parameter Explanation Return Format Example Related Commands Name Type Range Default {OFFSet|RATio} Discrete OFFSet|RATio RATio Amplitude deviation mode: the amplitudes of CH1 and CH2 have certain deviation relation. The parameter relations are ACH2=ACH1+ADev (the reference source is CH1); ACH1=ACH2-ADev (the reference source is CH2). Wherein, ACH1 is the amplitude of CH1, ACH2 is the amplitude of CH2 and ADev is the amplitude deviation. Amplitude ratio mode: the amplitudes of CH1 and CH2 have certain ratio relation. The parameter relations are ACH2=ACH1*ARatio (the reference source is CH1); ACH1=ACH2/ARatio (the reference source is CH2). Wherein, ACH1 is the amplitude of CH1, ACH2 is the amplitude of CH2 and ARatio is the amplitude ratio. If the amplitude of CH1 or CH2 exceeds the amplitude upper limit or lower limit of the channel after the channel coupling, the instrument will automatically adjust the amplitude upper limit or lower limit of the other channel to avoid parameter overrange. Select the desired amplitude coupling mode and set the corresponding amplitude deviation (:COUPling:AMPL:DEViation) or amplitude ratio (:COUPling:AMPL:RATio) before enabling the amplitude coupling function (:COUPling:AMPL[:STATe]). You cannot set the amplitude coupling mode and amplitude deviation/ratio after the amplitude coupling function is enabled. The query returns OFFSET or RATIO. :COUP:AMPL:MODE OFFS /*Set the amplitude coupling mode to amplitude deviation*/ :COUP:AMPL:MODE? /*Query the amplitude coupling mode and the query returns OFFSET*/ :COUPling:AMPL:DEViation :COUPling:AMPL:RATio :COUPling:AMPL[:STATe] DG1000Z Programming Guide 2-11 RIGOL Chapter 2 Command System :COUPling:AMPL:RATio Syntax :COUPling:AMPL:RATio { |MINimum|MAXimum} :COUPling:AMPL:RATio? Description Set the amplitude ratio in the amplitude coupling. Query the amplitude ratio in the amplitude coupling. Parameter Explanation Return Format Example Name Type Range Default Real 0.001 to 1000 1 Select the desired amplitude coupling mode (:COUPling:AMPL:MODE) and set the corresponding amplitude deviation (:COUPling:AMPL:DEViation) or amplitude ratio before enabling the amplitude coupling function (:COUPling:AMPL[:STATe]). You cannot set the amplitude coupling mode and amplitude deviation/ratio after the amplitude coupling function is enabled. When the amplitude coupling function is disabled, if the current amplitude coupling mode is amplitude ratio, send this command can set the amplitude ratio; if the current amplitude coupling mode is amplitude deviation, send this command can set the amplitude coupling mode to amplitude ratio and set the amplitude ratio. The query returns the amplitude ratio in scientific notation. The return value contains 7 effective digits, for example, 1.123000E+00 (the amplitude ratio is 1.123). :COUP:AMPL:RAT 1.123 :COUP:AMPL:RAT? Related Commands /*Set the amplitude ratio in the amplitude coupling to 1.123*/ /*Query the amplitude ratio in the amplitude coupling and the query returns 1.123000E+00*/ :COUPling:AMPL:DEViation :COUPling:AMPL:MODE :COUPling:AMPL[:STATe] 2-12 DG1000Z Programming Guide RIGOL Chapter 2 Command System :COUPling:AMPL[:STATe] Syntax :COUPling:AMPL[:STATe] {ON|1|OFF|0} :COUPling:AMPL[:STATe]? Description Enable or disable the amplitude coupling function. Query the on/off status of the amplitude coupling function. Parameter Explanation Return Format Example Related Commands Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 OFF After the amplitude coupling function is enabled, CH1 and CH2 take each other as the reference source. When the amplitude of a channel (this channel is the reference source) is changed, the amplitude of the other channel changes accordingly automatically and always keeps the specified amplitude deviation or ratio with that of the reference channel. Select the desired amplitude coupling mode (:COUPling:AMPL:MODE) and set the corresponding amplitude deviation (:COUPling:AMPL:DEViation) or amplitude ratio (:COUPling:AMPL:RATio) before enabling the amplitude coupling function. You cannot set the amplitude coupling mode and amplitude deviation/ratio after the amplitude coupling function is enabled. You can also send the [:SOURce[ ]]:VOLTage:COUPle[:STATe] command to set or query the on/off status of the amplitude coupling function. The query returns ON or OFF. :COUP:AMPL ON /*Enable the amplitude coupling function*/ :COUP:AMPL? /*Query the on/off status of the amplitude coupling function and the query returns ON*/ :COUPling:AMPL:DEViation :COUPling:AMPL:MODE :COUPling:AMPL:RATio [:SOURce[ ]]:VOLTage:COUPle[:STATe] DG1000Z Programming Guide 2-13 RIGOL Chapter 2 Command System :COUPling:FREQuency:DEViation Syntax :COUPling:FREQuency:DEViation :COUPling:FREQuency:DEViation? Description Set the frequency deviation in the frequency coupling. Query the frequency deviation in the frequency coupling. Parameter Explanation Return Format Example Related Commands Name Type Range Default Real -59.999 999 999 999MHz to 59.999 999 999 999MHz 0Hz Select the desired frequency coupling mode (:COUPling:FREQuency:MODE) and set the corresponding frequency deviation or frequency ratio (:COUPling:FREQuency:RATio) before enabling the frequency coupling function (:COUPling:FREQuency[:STATe]). You cannot set the frequency coupling mode and frequency deviation/ratio after the frequency coupling function is enabled. When the frequency coupling function is disabled, if the current frequency coupling mode is frequency deviation, send this command can set the frequency deviation; if the current frequency coupling mode is frequency ratio, send this command can set the frequency coupling mode to frequency deviation and set the frequency deviation. You can also send the [:SOURce[ ]]:FREQuency:COUPle:OFFSet command to set or query the frequency deviation in the frequency coupling. The query returns the frequency deviation in scientific notation. The return value contains 7 effective digits, for example, 1.000000E+02 (the frequency deviation is 100Hz). :COUP:FREQ:DEV 100 /*Set the frequency deviation in the frequency coupling to 100Hz*/ :COUP:FREQ:DEV? /*Query the frequency deviation in the frequency coupling and the query returns 1.000000E+02*/ :COUPling:FREQuency:MODE :COUPling:FREQuency:RATio :COUPling:FREQuency[:STATe] [:SOURce[ ]]:FREQuency:COUPle:OFFSet 2-14 DG1000Z Programming Guide RIGOL Chapter 2 Command System :COUPling:FREQuency:MODE Syntax :COUPling:FREQuency:MODE {OFFSet|RATio} :COUPling:FREQuency:MODE? Description Set the frequency coupling mode to frequency deviation (OFFSet) or frequency ratio (RATio). Query the selected frequency coupling mode. Parameter Explanation Return Format Example Related Commands Name Type Range Default {OFFSet|RATio} Discrete OFFSet|RATio RATio Frequency deviation mode: the frequencies of CH1 and CH2 have certain deviation relation. The parameter relations are FCH2=FCH1+FDev (the reference source is CH1); FCH1=FCH2-FDev (the reference source is CH2). Wherein, FCH1 is the frequency of CH1, FCH2 is the frequency of CH2 and FDev is the frequency deviation. Frequency ratio mode: the frequencies of CH1 and CH2 have certain ratio relation. The parameter relations are FCH2=FCH1*FRatio (the reference source is CH1); FCH1=FCH2/FRatio (the reference source is CH2). Wherein, FCH1 is the frequency of CH1, FCH2 is the frequency of CH2 and FRatio is the frequency ratio. If the frequency of CH1 or CH2 exceeds the frequency upper limit or lower limit of the channel after the channel coupling, the instrument will automatically adjust the frequency upper limit or lower limit of the other channel to avoid parameter overrange. Select the desired frequency coupling mode and set the corresponding frequency deviation (:COUPling:FREQuency:DEViation) or frequency ratio (:COUPling:FREQuency:RATio) before enabling the frequency coupling function (:COUPling:FREQuency[:STATe]). You cannot set the frequency coupling mode and frequency deviation/ratio after the frequency coupling function is enabled. You can also send the [:SOURce[ ]]:FREQuency:COUPle:MODE command to set or query the frequency couplimg mode of the specified channel. The query returns OFFSET or RATIO. :COUP:FREQ:MODE OFFS deviation*/ /*Set the frequency coupling mode to frequency :COUP:FREQ:MODE? /*Query the selected frequency coupling mode and the query returns OFFSET*/ :COUPling:FREQuency:DEViation :COUPling:FREQuency:RATio :COUPling:FREQuency[:STATe] [:SOURce[ ]]:FREQuency:COUPle:MODE DG1000Z Programming Guide 2-15 RIGOL Chapter 2 Command System :COUPling:FREQuency:RATio Syntax :COUPling:FREQuency:RATio { |MINimum|MAXimum} :COUPling:FREQuency:RATio? Description Set the frequency ratio in the frequency coupling. Query the frequency ratio in the frequency coupling. Parameter Explanation Return Format Example Related Commands Name Type Range Default Real 0.000 001 to 1 000 000 1 Select the desired frequency coupling mode (:COUPling:FREQuency:MODE) and set the corresponding frequency deviation (:COUPling:FREQuency:DEViation) or frequency ratio before enabling the frequency coupling function (:COUPling:FREQuency[:STATe]). You cannot set the frequency coupling mode and frequency deviation/ratio after the frequency coupling function is enabled. When the frequency coupling function is disabled, if the current frequency coupling mode is frequency ratio, send this command can set the frequency ratio; if the current frequency coupling mode is frequency deviation, send this command can set the frequency coupling mode to frequency ratio and set the frequency ratio. You can also send the [:SOURce[ ]]:FREQuency:COUPle:RATio command to set or query the frequency ratio in the frequency coupling. The query returns the frequency ratio in scientific notation. The return value contains 7 effective digits, for example, 1.001230E+02 (the frequency ratio is 100.123). :COUP:FREQ:RAT 100.123 /*Set the frequency ratio in the frequency coupling to 100.123*/ :COUP:FREQ:RAT? /*Query the frequency ratio in the frequency coupling and the query returns 1.001230E+02*/ :COUPling:FREQuency:MODE :COUPling:FREQuency:DEViation :COUPling:FREQuency[:STATe] [:SOURce[ ]]:FREQuency:COUPle:RATio 2-16 DG1000Z Programming Guide RIGOL Chapter 2 Command System :COUPling:FREQuency[:STATe] Syntax :COUPling:FREQuency[:STATe] {ON|1|OFF|0} :COUPling:FREQuency[:STATe]? Description Enable or disable the frequency coupling function. Query the on/off status of the frequency coupling function. Parameter Explanation Return Format Example Related Commands Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 OFF When the frequency coupling mode is disabled, you can select the frequency coupling mode and set the corresponding frequency deviation or frequency ratio. After the frequency coupling function is enabled, CH1 and CH2 take each other as the reference source. When the frequency of a channel (this channel is the reference source) is changed, the frequency of the other channel changes accordingly automatically and always keeps the specified frequency deviation or ratio with that of the reference channel. Select the desired frequency coupling mode (:COUPling:FREQuency:MODE) and set the corresponding frequency deviation (:COUPling:FREQuency:DEViation) or frequency ratio (:COUPling:FREQuency:RATio) before enabling the frequency coupling function. You cannot set the frequency coupling mode and frequency deviation/ratio after the frequency coupling function is enabled. You can also send the [:SOURce[ ]]:FREQuency:COUPle[:STATe] command to set or query the status of the frequency counter function. The query returns ON or OFF. :COUP:FREQ ON /*Enable the frequency coupling function*/ :COUP:FREQ? /*Query the on/off status of the frequency coupling function and the query returns ON*/ :COUPling:FREQuency:DEViation :COUPling:FREQuency:MODE :COUPling:FREQuency:RATio [:SOURce[ ]]:FREQuency:COUPle[:STATe] DG1000Z Programming Guide 2-17 RIGOL Chapter 2 Command System :COUPling:PHASe:DEViation Syntax :COUPling:PHASe:DEViation :COUPling:PHASe:DEViation? Description Set the phase deviation in the phase coupling. Query the phase deviation in the phase coupling. Parameter Explanation Return Format Example Related Commands Name Type Range Default Real -360° to 360° 0 Select the desired phase coupling mode (:COUPling:PHASe:MODE) and set the corresponding phase deviation or phase ratio (:COUPling:PHASe:RATio) before enabling the phase coupling function (:COUPling:PHASe[:STATe]). You cannot set the phase coupling mode and phase deviation/ratio after the phase coupling function is enabled. When the phase coupling function is disabled, if the current phase coupling mode is phase deviation, send this command can set the phase deviation; if the current phase coupling mode is phase ratio, send this command can set the phase coupling mode to phase deviation and set the phase deviation. The query returns the phase deviation in scientific notation. The return value contains 7 effective digits, for example, 9.000000E+01 (the phase deviation is 90°). :COUP:PHAS:DEV 90 /*Set the phase deviation in the phase coupling to 90°*/ :COUP:PHAS:DEV? /*Query the phase deviation in the phase coupling and the query returns 9.000000E+01*/ :COUPling:PHASe:MODE :COUPling:PHASe:RATio :COUPling:PHASe[:STATe] 2-18 DG1000Z Programming Guide RIGOL Chapter 2 Command System :COUPling:PHASe:MODE Syntax :COUPling:PHASe:MODE {OFFSet|RATio} :COUPling:PHASe:MODE? Description Set the phase coupling mode to phase deviation (OFFSet) or phase ratio (RATio). Query the selected phase coupling mode. Parameter Explanation Return Format Example Related Commands Name Type Range Default {OFFSet|RATio} Discrete OFFSet|RATio RATio Phase deviation mode: the phase of CH1 and CH2 have certain deviation relation. The parameter relations are PCH2=PCH1+PDev (the reference source is CH1); PCH1=PCH2-PDev (the reference source is CH2). Wherein, PCH1 is the phase of CH1, PCH2 is the phase of CH2 and PDev is the phase deviation. Phase ratio mode: the phase of CH1 and CH2 have certain ratio relation. The parameter relations are PCH2=PCH1*PRatio (the reference source is CH1); PCH1=PCH2/PRatio (the reference source is CH2). Wherein, PCH1 is the phase of CH1, PCH2 is the phase of CH2 and PRatio is the phase ratio. If the phase of CH1 or CH2 exceeds the phase upper limit or lower limit of the channel after the channel coupling, the instrument will automatically adjust the phase upper limit or lower limit of the other channel to avoid parameter overrange. Select the desired phase coupling mode and set the corresponding phase deviation (:COUPling:PHASe:DEViation) or phase ratio (:COUPling:PHASe:RATio) before enabling the phase coupling function (:COUPling:PHASe[:STATe]). You cannot set the phase coupling mode and phase deviation/ratio after the phase coupling function is enabled. The query returns OFFSET or RATIO. :COUP:PHAS:MODE OFFS /*Set the phase coupling mode to phase deviation*/ :COUP:PHAS:MODE? /*Query the phase coupling mode and the query returns OFFSET*/ :COUPling:PHASe:DEViation :COUPling:AMPL:RATio :COUPling:PHASe[:STATe] DG1000Z Programming Guide 2-19 RIGOL Chapter 2 Command System :COUPling:PHASe:RATio Syntax :COUPling:PHASe:RATio { |MINimum|MAXimum} :COUPling:PHASe:RATio? Description Set the phase ratio in the phase coupling. Query the phase ratio in the phase coupling. Parameter Explanation Return Format Example Related Commands Name Type Range Default Real 0.01 to 100 1 Select the desired phase coupling mode (:COUPling:PHASe:MODE) and set the corresponding phase deviation or phase ratio (:COUPling:PHASe:RATio) before enabling the phase coupling function (:COUPling:PHASe[:STATe]). You cannot set the phase coupling mode and phase deviation/ratio after the phase coupling function is enabled. When the phase coupling function is disabled, if the current phase coupling mode is phase ratio, send this command can set the phase ratio; if the current phase coupling mode is phase deviation, send this command can set the phase coupling mode to phase ratio and set the phase ratio. The query returns the phase ratio in scientific notation. The return value contains 7 effective digits, for example, 1.120000E+00 (the phase ratio is 1.12). :COUP:PHAS:RAT 1.12 /*Set the phase ratio in the phase coupling to 1.12*/ :COUP:PHAS:RAT? /*Query the phase ratio in the phase coupling and the query returns 1.120000E+00*/ :COUPling:PHASe:MODE :COUPling:PHASe:RATio :COUPling:PHASe[:STATe] 2-20 DG1000Z Programming Guide RIGOL Chapter 2 Command System :COUPling:PHASe[:STATe] Syntax :COUPling:PHASe[:STATe] {ON|1|OFF|0} :COUPling:PHASe[:STATe]? Description Enable or disable the phase coupling function. Query the on/off status of the phase coupling function. Parameter Explanation Return Format Example Related Commands Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 OFF After the phase coupling function is enabled, CH1 and CH2 take each other as the reference source. When the phase of a channel (this channel is the reference source) is changed, the phase of the other channel changes accordingly automatically and always keeps the specified phase deviation or ratio with that of the reference channel. Select the desired phase coupling mode (:COUPling:PHASe:MODE) and set the corresponding phase deviation (:COUPling:PHASe:DEViation) or phase ratio (:COUPling:PHASe:RATio) before enabling the phase coupling function. You cannot set the phase coupling mode and phase deviation/ratio after the phase coupling function is enabled. When the phase coupling function is disabled, you can select the phase coupling mode and set the corresponding phase deviation or ratio. The query returns ON or OFF. :COUP:PHAS ON /*Enable the phase coupling function*/ :COUP:PHAS? /*Query the on/off status of the phase coupling function and the query returns ON*/ :COUPling:PHASe:DEViation :COUPling:PHASe:MODE :COUPling:PHASe:RATio DG1000Z Programming Guide 2-21 RIGOL Chapter 2 Command System :COUPling[:STATe] Syntax :COUPling[:STATe] {ON|1|OFF|0} :COUPling[:STATe]? Description Enable or disable the frequency coupling, phase coupling and amplitude coupling of the channel at the same time. Query the on/off states of the frequency coupling, phase coupling and amplitude coupling of the channel. Parameter Explanation Return Format Example Related Commands Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 OFF DG1000Z supports the frequency, amplitude and phase coupling functions. After the coupling functions are enabled, CH1 and CH2 take each other as the reference source. When the frequency, amplitude or phase of a channel (this channel is the reference source) is changed, the frequency, amplitude or phase of the other channel changes accordingly automatically and always keeps the specified frequency deviation/ratio, amplitude deviation/ratio or phase deviation/ratio with that of the reference channel. You can also enable or disable the frequency coupling function (:COUPling:FREQuency[:STATe]), phase coupling function (:COUPling:PHASe[:STATe]) and amplitude coupling function (:COUPling:AMPL[:STATe]) respectively. The query returns a string consisting of 3 parts (represent the on/off states of the frequency coupling, phase coupling and amplitude coupling functions in order) separated by commas, for example, FREQ:ON,PHASE:OFF,AMPL:OFF. :COUP ON /*Enable the frequency coupling, phase coupling and amplitude coupling of the channel at the same time*/ :COUP? /*Query the on/off states of the frequency coupling, phase coupling and amplitude coupling of the channel and the query returns FREQ:ON,PHASE:ON,AMPL:ON*/ :COUPling:AMPL[:STATe] :COUPling:FREQuency[:STATe] :COUPling:PHASe[:STATe] 2-22 DG1000Z Programming Guide RIGOL Chapter 2 Command System :DISPlay Commands The :DISPlay commands are used to set the display-related information, display the specified characters on the screen and clear the characters displayed on the screen. Command List: :DISPlay:BRIGhtness :DISPlay:CONTrast :DISPlay:DATA? :DISPlay:MODE :DISPlay:SAVer:IMMediate :DISPlay:SAVer[:STATe] :DISPlay[:STATe] :DISPlay:TEXT? :DISPlay:TEXT:CLEar :DISPlay:TEXT[:SET] :DISPlay:BRIGhtness Syntax :DISPlay:BRIGhtness { |MINimum|MAXimum} :DISPlay:BRIGhtness? [MINimum|MAXimum] Description Set the screen brightness. Query the screen brightness. Parameter Return Format Example Name Type Range Default Integer 1% to 100% 50% The query returns the screen brightness in scientific notation. The return value contains 7 effective digits, for example, 5.100000E+01 (the screen brightness is 51%). :DISP:BRIG 51 /*Set the screen brightness to 51%*/ :DISP:BRIG? /*Query the screen brightness and the query returns 5.100000E+01*/ DG1000Z Programming Guide 2-23 RIGOL Chapter 2 Command System :DISPlay:CONTrast Syntax :DISPlay:CONTrast { |MINimum|MAXimum} :DISPlay:CONTrast? [MINimum|MAXimum] Description Set the screen contrast. Query the screen contrast. Parameter Return Format Name Type Range Default Integer 1% to 100% 25% The query returns the screen contrast in scientific notation. The return value contains 7 effective digits, for example, 2.800000E+01 (the screen contrast is 28%). Example :DISP:CONT 28 /*Set the screen contrast to 28%*/ :DISP:CONT? 2.800000E+01*/ /*Query the screen contrast and the query returns :DISPlay:DATA? Syntax :DISPlay:DATA? Description Query the image of the front panel screen (screenshot). Explanation You can also send the :HCOPy:SDUMp:DATA? to query the image of the front panel screen. Return Format The query returns a definite-length binary data block containing the image. The block starts with #. For example, #9000230456BM6\x84\x03\x00......; wherein, “9” following “#” denotes that the 9 characters following (000230456) are used to denote the data length. Related Command 2-24 :HCOPy:SDUMp:DATA? DG1000Z Programming Guide RIGOL Chapter 2 Command System :DISPlay:MODE Syntax :DISPlay:MODE {DPV|DGV|SV} :DISPlay:MODE? Description Set the display mode to dual-channel parameters (DPV), dual-channel graph (DGV) or single-channel (SV) display mode. Query the display mode. Parameter Explanation Return Format Example Name Type Range Default {DPV|DGV|SV} Discrete DPV|DGV|SV DPV Dual-channel parameters (DPV): display the parameters and waveforms of the two channels in both the digital and graph forms. Dual-channel graph (DGV): display the waveforms of the two channels in graph form. Single-channel (SV): display the parameters and waveform of the channel currently selected in both the digital and graph forms. The query returns DPV, DGV or SV. :DISP:MODE DGV /*Set the display mode to dual-channel graph*/ :DISP:MODE? /*Query the display mode and the query returns DGV*/ :DISPlay:SAVer:IMMediate Syntax Description :DISPlay:SAVer:IMMediate Enable the screen saver immediately without waiting. :DISPlay:SAVer[:STATe] Syntax :DISPlay:SAVer[:STATe] {ON|1|OFF|0} :DISPlay:SAVer[:STATe]? Description Enable or disable the screen saver function. Query the on/off status of the screen saver function. Parameter Explanation Return Format Example Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 ON When the screen saver function is enabled, the instrument enters the screen saver mode automatically when you stop operating the instrument for more than 15 minutes and it enters the black screen state automatically after another 30 minutes. The query returns ON or OFF. :DISP:SAV OFF /*Disable the screen saver function*/ :DISP:SAV? /*Query the on/off status of the screen saver function and the query returns OFF*/ :DISP:SAV 1 /*Enable the screen saver function*/ :DISP:SAV? /*Query the on/off status of the screen saver function and the query returns ON*/ DG1000Z Programming Guide 2-25 RIGOL Chapter 2 Command System :DISPlay[:STATe] Syntax :DISPlay[:STATe] {ON|1|OFF|0} :DISPlay[:STATe]? Description Enable or disable the screen display. Query the status of the screen display. Parameter Explanation Return Format Example Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 ON The disabling the screen display function is only valid when the instrument is in the remote mode. When the instrument returns to the local mode, the screen display is enabled automatically. Press Help at the front panel to make the instrument return to the local mode from the remote mode. The query returns ON or OFF. :DISP OFF /*Disable the screen display*/ :DISP? /*Query the status of the screen display and the query returns OFF*/ :DISP 1 /*Enable the screen display*/ :DISP? /*Query the status of the screen display and the query returns ON*/ :DISPlay:TEXT? Syntax :DISPlay:TEXT? Description Query the string currently displayed on the screen. Explanation You can send the :DISPlay:TEXT:CLEar command to clear the string currently displayed on the screen. Return Format Example Related Command The query returns a string enclosed in double quotation marks and the content in the double quotation marks is the content currently displayed on the screen (the double quotation marks at the outermost of the string are not displayed on the screen), for example, ”RIGOL”. :DISP:TEXT "RIGOL",25,35 screen*/ /*Display the string RIGOL from (25,35) on the :DISP:TEXT? /*Query the string currently displayed on the screen and the query returns ”RIGOL”*/ :DISPlay:TEXT:CLEar :DISPlay:TEXT:CLEar Syntax Description Clear the string currently displayed on the screen. Explanation You can send the :DISPlay:TEXT? command to query the string currently displayed on the screen. Related Command 2-26 :DISPlay:TEXT:CLEar :DISPlay:TEXT? DG1000Z Programming Guide RIGOL Chapter 2 Command System :DISPlay:TEXT[:SET] Syntax Description :DISPlay:TEXT[:SET] [,x[,y]] Display the specified string from the specified coordinate on the screen. Parameter Explanation Return Format Example Related Commands Name Type Range Default ASCII string Refer to the “Explanation” None x Integer 2 to 319 2 y Integer 2 to 239 2 is a string enclosed in double quotation marks (note that the double quotation marks at the outermost of the string are not displayed on the screen), for example, ”RIGOL”. The specified string can contain up to 45 characters and the command is invalid when the specified string exceeds 45 characters. The specified string will be truncated when it cannot be displayed in a single row. The x and y in [,x[,y]] denotes the coordinate setting values of the X axis (the horizontal axis) and Y axis (the vertical axis) respectively (the coordinate values set are the coordinate values of the upper-left corner of the string displayed on the screen). When only one coordinate value is specified, the instrument treated it as the horizontal axis value (x) by default. When the parameters are omitted, the instrument displays the specified string from the last effective coordinate (if no coordinate has been set after power-on, the default coordinate will be used). You can send the :DISPlay:TEXT? command to query the string currently displayed on the screen or send the :DISPlay:TEXT:CLEar command to clear the string currently displayed on the screen. The query returns a string enclosed in double quotation marks and the content in the double quotation marks is the content currently displayed on the screen (the double quotation marks at the outermost of the string are not displayed on the screen), for example, ”RIGOL”. :DISP:TEXT "RIGOL",25,35 /*Display the string RIGOL from (25,35) on the screen*/ :DISPlay:TEXT? :DISPlay:TEXT:CLEar DG1000Z Programming Guide 2-27 RIGOL Chapter 2 Command System :HCOPy Commands The :HCOPy commands are used to set or query the format of the image returned of the screenshot operation and execute the screenshot operation. Command List: :HCOPy:SDUMp:DATA? :HCOPy:SDUMp:DATA:FORMat :HCOPy:SDUMp:DATA? Syntax :HCOPy:SDUMp:DATA? Description Query the image displayed on the front panel screen (screenshot). Explanation You can also send the :DISPlay:DATA? command to query the image displayed on the front panel screen. Return Format The query returns a definite-length binary data block containing the image. The block starts with #. For example, #9000230456BM6\x84\x03\x00......; wherein, “9” following “#” denotes that the 9 characters following (000230456) are used to denote the data length. Related Command :DISPlay:DATA? :HCOPy:SDUMp:DATA:FORMat Syntax :HCOPy:SDUMp:DATA:FORMat BMP :HCOPy:SDUMp:DATA:FORMat? Description Set the format of the image returned of the screenshot operation to BMP. Query the format of the image returned of the screenshot operation. Return Format Example 2-28 The query returns BMP. :HCOP:SDUM:DATA:FORM BMP /*Set the format of the image returned of the screenshot operation to BMP*/ :HCOP:SDUM:DATA:FORM? /*Query the format of the image returned of the screenshot operation and the query returns BMP*/ DG1000Z Programming Guide Chapter 2 Command System RIGOL IEEE488.2 Common Commands The IEEE488.2 standard defines a series of common commands used to execute various functions, such as the reset, self-test and status operations. Command List: *CLS *ESE *ESR? *IDN? *OPC *OPT? *PSC *RCL *RST *SAV *SRE *STB? *TRG *WAI *CLS Syntax Description *CLS Clear the event registers of all the register sets and the error queue. DG1000Z Programming Guide 2-29 RIGOL Chapter 2 Command System *ESE Syntax *ESE *ESE? Description Enable the bits to be reported to the status byte register in the standard event register. Query the bits enabled in the standard event register. Parameter Explanation Return Format Related Command Name Type Range Default Integer Refer to the “Explanation” None is a decimal value corresponding to the sum of the binary weights of the bits to be reported to the status byte register in the standard event register. When is set to 0, executing this command will clear the enable register of the standard even register. If you have configured the instrument using the *PSC 1 command, the enable register of the standard event register will be cleared at the next power-on of the instrument; if you have configured the instrument using the *PSC 0 command, the enable register of the standard event register will not be cleared at the next power-on of the instrument. The query returns a decimal value corresponding to the sum of the binary weights of the bits enabled in the standard event register. *PSC *ESR? Syntax *ESR? Description Query the event register of the standard event register. Explanation The event register of the standard event register is read-only. Its bits are latched and the event register will be cleared when you query it. Once a bit is set, the later occurred events corresponding to that bit will be ignored until the register is cleared by the query command or the *CLS command (used to clear the status). Return Format The query returns a decimal value corresponding to the sum of the binary weights of all the bits in the event register of the standard event register. Related Command *CLS *IDN? Syntax Description Return Format 2-30 *IDN? Query the ID string of the instrument. The query returns the ID string of the instrument. The return value consists of 4 parts separated by commas, for example, Rigol Technologies,DG1062Z,DG1ZA000000001,00.01.03; wherein, the first part is the manufacturer name, the second part is the instrument model, the third part is the instrument serial number and the forth part is the digital board version number. DG1000Z Programming Guide RIGOL Chapter 2 Command System *OPC Syntax *OPC *OPC? Description Set the OPC (operation complete) bit in the standard event register after all the previous commands that have been sent are executed. Query whether all the previous commands that have been sent are executed. If yes, return 1 to the output buffer. Explanation Return Format Example Here, “operation complete” refers to that all the previous commands that have been sent, including the *OPC command, are executed. You can also use the *OPC (operation complete) or *OPC? (operation complete query) command to set the system to output signal when finishing the sweep or burst. The *OPC commands sets the OPC (operation complete) bit in the standard event register after all the previous commands that have been sent are executed; when the bus is used to trigger the sweep or burst, the system can execute other commands before this bit is set. The *OPC? command returns 1 to the output buffer after all the previous commands that have been sent are executed and the system cannot execute any other command before this command is completed. Sending the *OPC? command (query command) and reading the result can ensure synchronization. When setting the instrument by programming (by executing command strings), taking the *OPC command as the last command of the command queue can determine when the command queue is completed (the OPC (operation complete) bit in the standard event register is set after the command queue is completed). The query returns 1 or 0. *OPC /*Configure the instrument to set the OPC (operation complete) bit in the standard event register after all the previous commands that have been sent are executed*/ *OPC? /*Query whether all the previous commands that have been sent are executed. If yes, return 1 to the output buffer*/ *OPT? Syntax Description Return Format *OPT? Query whether the 16M internal memory option (Arb 16M) has been installed. The query returns OFFICAL (the 16M internal memory option has been installed) or UNINSTALL (the 16M internal memory option is not installed). DG1000Z Programming Guide 2-31 RIGOL Chapter 2 Command System *PSC Syntax *PSC {0|1} *PSC? Description Enable or disable the function to clear the status byte enable register and standard event enable register at power-on. Query whether to clear the status byte enable register and standard event enable register at power-on. Parameter Explanation Return Format Example Related Commands 2-32 Name Type Range Default {0|1} Discrete 0|1 1 The *PSC 1 command means clearing the status byte enable register and standard event enable register at power-on. The *PSC 0 command means the status byte enable register and standard event enable register will not be affected at power-on. You can also send the *SRE 0 and *ESE 0 commands to clear the status byte enable register and standard event enable register respectively. The query returns 0 or 1. *PSC 1 /*Enable the function to clear the status byte enable register and standard event enable register at power-on*/ *PSC? /*Query the status clear setting at power-on and the query returns 1*/ *ESE *SRE DG1000Z Programming Guide RIGOL Chapter 2 Command System *RCL Syntax Description *RCL {USER1|USER2|USER3|USER4|USER5|USER6|USER7|USER8|USER9|USER10| ARB1|ARB2|ARB3|ARB4|ARB5|ARB6|ARB7|ARB8|ARB9|ARB10} Recall the state file (USER) or arbitrary waveform file (ARB) stored in the specified location in the internal non-volatile memory. Parameter Name {USER1|USER2|USER3| USER4|USER5|USER6| USER7|USER8|USER9| USER10|ARB1|ARB2|ARB3| ARB4|ARB5|ARB6|ARB7| ARB8|ARB9|ARB10} Explanation Type Range Default Discrete USER1|USER2|USER3| USER4|USER5|USER6| USER7|USER8|USER9| USER10|ARB1|ARB2|ARB3| ARB4|ARB5|ARB6|ARB7| ARB8|ARB9|ARB10 None The instrument provides 10 storage locations (numbered 1 to 10) in the internal memory for storing the state files and arbitrary waveform files respectively. Sending this command can recall the state file or arbitrary waveform file stored in the specified storage location in the internal non-volatile memory. Select number 1 to 10 to recall the state file or arbitrary waveform file stored in the corresponding storage location respectively. This command is only valid when an effective state file or arbitrary waveform file is stored in the specified storage location in the internal non-volatile memory. The state file stored includes the waveforms, frequencies, amplitudes, offsets, duty cycles, symmetries, phases, the modulation, sweep, burst parameters, the frequency counter parameters of the two channels as well as the utility parameters and system parameters under the Utility menu. The arbitrary waveform file stores the voltage corresponding to each waveform point in binary data form. In the sample rate editing mode, there are only Sa points if the number of points is set to Sa and the voltage of each point is the voltage set by users. In the period editing mode, if the number of points is set to Sa, the voltages of the first Sa points is the voltages set by users and the voltages of the (Sa+1)th point to 8192nd point are low level. The voltage of each point occupies 2 bytes (namely 16 bits); wherein, the 14 low-order bits denote the voltage and the 2 high-order bits are not used. Therefore, the format of the binary data is 0x0000 to 0x3FFF; wherein, 0x0000 corresponds to the low level of the arbitrary waveform and 0x3FFF corresponds to the high level of the arbitrary waveform. DG1000Z Programming Guide 2-33 RIGOL Chapter 2 Command System *RST Syntax *RST Description Restore the instrument to its factory state. Explanation Restore the instrument to its factory state (please refer to “Appendix B: Factory Setting”) and it is not affected by the :MEMory:STATe:RECall:AUTO command. This command will stop the sweep or burst in progress in an abnormal way and the screen display will be turned on if it is previously turned off (using the :DISPlay[:STATe] command). Related Commands :DISPlay[:STATe] :MEMory:STATe:RECall:AUTO *SAV Syntax Description *SAV {USER1|USER2|USER3|USER4|USER5|USER6|USER7|USER8|USER9|USER10| ARB1|ARB2|ARB3|ARB4|ARB5|ARB6|ARB7|ARB8|ARB9|ARB10} Store the current instrument state (USER) or arbitrary waveform data (ARB) in the specified storage location in the internal non-volatile memory with the default name. Parameter Name {USER1|USER2|USER3| USER4|USER5|USER6| USER7|USER8|USER9| USER10|ARB1|ARB2|ARB3| ARB4|ARB5|ARB6|ARB7| ARB8|ARB9|ARB10} Explanation Example Related Commands 2-34 Type Range Default Discrete USER1|USER2|USER3| USER4|USER5|USER6| USER7|USER8|USER9| USER10|ARB1|ARB2| ARB3|ARB4|ARB5|ARB6| ARB7|ARB8|ARB9|ARB10 None The internal memory of the instrument provides 10 storage locations (numbered 1 to 10) for the instrument state and arbitrary waveform data respectively. The default sate file name is Scpin.RSF and the default arbitrary waveform file name is Scpin.RAF; wherein, n corresponds to the number of the storage location. If the specified storage location already contains a file, this command will store the current instrument state or arbitrary waveform data in the specified storage location and directly overwrite the original file. If the original state file in the specified storage location is locked (:MEMory:STATe:LOCK), this command is invalid (do not overwrite the original file). For the introductions of the state file and arbitrary waveform file, please refer to the “Explanation” under the *RCL command. You can send the *RCL command to recall the state file and arbitrary waveform file stored in the internal non-volatile memory of the instrument. *SAV USER1 /*Store the current instrument state in storage location 1 in the internal non-volatile memory of the instrument with the filename Scpi1.RSF*/ :MEMory:STATe:LOCK *RCL DG1000Z Programming Guide RIGOL Chapter 2 Command System *SRE Syntax *SRE *SRE? Description Enable the bits in the status byte register to generate service request. Query the bits enabled in the status byte register. Parameter Explanation Return Format Related Command Name Type Range Default Integer Refer to the “Explanation” None is a decimal value corresponding to the sum of the binary weights of the bits enabled in the status byte register. The bits selected are accumulated on bit6 (main accumulation bit) of the status byte register and service request will be generated if any of the bits selected changes from 0 to 1. When is set to 0, executing this command will clear the enable register of the status byte register. If you have configured the instrument using the *PSC 1 command, the enable register of the status byte register will be cleared at the next power-on of the instrument; if you have configured the instrument using the *PSC 0 command, the enable register of the status byte register will not be cleared at the next power-on of the instrument. The query returns a decimal value corresponding to the sum of the binary weights of the bits enabled in the status byte register. *PSC *STB? Syntax *STB? Description Query the status register of the status byte register. Explanation This command cannot clear the service request. Bit6 (main accumulation bit) of the status byte register will not be cleared as long as the condition that generates the service request is still in effect. Return Format The query returns a decimal value corresponding to the sum of the binary weights of all the bits in the status register of the status byte register. DG1000Z Programming Guide 2-35 RIGOL Chapter 2 Command System *TRG Syntax *TRG Description Trigger a sweep or burst. Explanation You can only trigger the sweep or burst via the remote interface when the sweep or burst function is currently enabled and the trigger source is set to manual (use the [:SOURce[ ]]:SWEep:TRIGger:SOURce or [:SOURce[ ]]:BURSt:TRIGger:SOURce command). You can also send the [:SOURce[ ]]:SWEep:TRIGger[:IMMediate] or [:SOURce[ ]]:BURSt:TRIGger[:IMMediate] command to trigger a sweep or burst when the sweep or burst function is currently enabled and the trigger source is set to manual. Related Commands [:SOURce[ ]]:BURSt:TRIGger[:IMMediate] [:SOURce[ ]]:BURSt:TRIGger:SOURce [:SOURce[ ]]:SWEep:TRIGger[:IMMediate] [:SOURce[ ]]:SWEep:TRIGger:SOURce *WAI Syntax 2-36 *WAI Description Execute any other command via the interface after all the pending operations are completed. Explanation This command is only applicable to the triggered sweep mode or triggered burst mode, and is used to ensure synchronization. DG1000Z Programming Guide RIGOL Chapter 2 Command System :LICense Command The :LICense command is used to install the 16M internal memory option (used to expand the memory depth of the arbitrary waveform). Before installing the option, you need to acquire the option license through the following method. 1. Order this option (its ordering number is Arb16M-DG1000Z) to acquire the key. 2. Vist the website of RIGOL (www.rigol.com) and click Customer Center License Generate to enter the license generation interface. 3. Input the correct Key, Sn (series number of the instrument and can be acquired by pressing Utility System Info) and Identifying Code and click Generate to generate the option license. Command List: :LICense:INSTall :LICense:SET :LICense:INSTall :LICense:SET Syntax :LICense:INSTall :LICense:SET Description Install the 16M internal memory option. Parameter Explanation Example Name Type Range Default ASCII string Refer to the “Explanation” None , namely the option license (removing the hyphens), is a string of 28 bytes. It can include uppercase English letters and numbers. Each instrument corresponds to an option license. If you need to use this option, please order this option to acquire the key. Then, visit the website of RIGOL to generate the option license. :LICense:INSTall SM9KD3YPMWNP2AQMST8J5H592EQT DG1000Z Programming Guide 2-37 RIGOL Chapter 2 Command System :LXI Commands Command List: :LXI:IDENtify[:STATE] :LXI:MDNS:ENABle :LXI:MDNS:HNAMe :LXI:MDNS:SNAMe:DESired :LXI:MDNS:SNAMe[:RESolved]? :LXI:RESet :LXI:RESTart :LXI:IDENtify[:STATE] Syntax :LXI:IDENtify[:STATE] {ON|1|OFF|0} :LXI:IDENtify[:STATE]? Description Turn on or off the LXI Identify indicator on the screen. Query the on/off status of the LXI Identify indicator on the screen. Parameter Explanation Return Format Example Related Command 2-38 Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 OFF The LXI Identify indicator can help you to identify the device related to the LAN address. Sending the *RST command will turn off the LXI Identify indicator. The query returns ON or OFF. :LXI:IDEN ON /*Turn on the LXI Identify indicator on the screen*/ :LXI:IDEN? /*Query the on/off status of the LXI Identify indicator on the screen and the query returns ON*/ *RST DG1000Z Programming Guide RIGOL Chapter 2 Command System :LXI:MDNS:ENABle Syntax :LXI:MDNS:ENABle {ON|1|OFF|0} :LXI:MDNS:ENABle? Description Enable or disable the multiple DNS system (mDNS). Query the status of the multiple DNS system (mDNS). Parameter Return Format Example Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 ON The query returns ON or OFF. :LXI:MDNS:ENAB ON /*Enable the multiple DNS system*/ :LXI:MDNS:ENAB? /*Query the status of the multiple DNS system and the query returns ON*/ :LXI:MDNS:HNAMe Syntax Description :LXI:MDNS:HNAMe[:RESolved]? Query the host name of the mDNS analyzed. :LXI:MDNS:SNAMe:DESired Syntax :LXI:MDNS:SNAMe:DESired :LXI:MDNS:SNAMe:DESired? Description Set the service name of mDNS. Query the service name of mDNS. Parameter Explanation Return Format Example Name Type Range Default ASCII string Refer to the “Explanation” rigollan is a string and can include English letters and numbers. This setting is stored in the non-volatile memory and will not change when the instrument is turned off and then turned on again or when the *RST command is sent. Sending the :SYSTem:SECurity:IMMediate command will set the service name of mDNS to its default. The query returns a string, for example, RIGOL1. :LXI:MDNS:SNAM:DES RIGOL1 LXI:MDNS:SNAM:DES? Related Command /*Set the service name of mDNS to RIGOL1*/ /*Query the service name of mDNS and the query returns RIGOL1*/ :SYSTem:SECurity:IMMediate DG1000Z Programming Guide 2-39 RIGOL Chapter 2 Command System :LXI:MDNS:SNAMe[:RESolved]? Syntax Description :LXI:MDNS:SNAMe[:RESolved]? Query the service name of mDNS analyzed. :LXI:RESet Syntax :LXI:RESet Description Reset the LAN setting to the known operation state, beginning from DHCP. If DHCP fails, AutoIP will be used. Explanation Several seconds are required for the LAN interface to restart (depending on your network) after sending this command. If the LAN interface or specific LAN service is disabled, you must restart the interface or service separately as well as turn off and restart the instrument to make the LAN works normally. :LXI:RESTart Syntax 2-40 :LXI:RESTart Description Restart the LAN according to the current setting. Explanation Several seconds are required for the LAN interface to restart (depending on your network) after sending this command. If the LAN interface or specific LAN service is disabled, you must restart the interface or service separately as well as turn off and restart the instrument to make the LAN works normally. DG1000Z Programming Guide Chapter 2 Command System RIGOL :MEMory Commands The :MEMory commands are used to query the storage locations and the state files stored in the internal non-volatile memory of the instrument, query whether state file is stored in the specified storage location, delete, lock and unlock the state files in the internal memory, query and modify the filenames of the state files stored as well as set the power-on configuration. Command List: :MEMory:NSTates? :MEMory:STATe:CATalog? :MEMory:STATe:DELete :MEMory:STATe:LOCK :MEMory:STATe:NAME :MEMory:STATe:RECall:AUTO :MEMory:STATe:VALid? :MEMory:NSTates? Syntax Description Return Format :MEMory:NSTates? Query the number of storage locations for the state files in the non-volatile memory of the internal memory of the instrument. The query returns 10. :MEMory:STATe:CATalog? Syntax :MEMory:STATe:CATalog? Description Query the state files stored in the internal non-volatile memory of the instrument. Explanation The internal non-volatile memory of the instrument provides 10 state file storage locations. Return Format The query returns a string consisting of 10 parts (represent the filenames of the files stored in locations 1 to 10 respectively) separated by commas, for example, "Scpi1.RSF","Scpi2.RSF","0.RSF","1.RSF","012.RSF","","33.RSF","","",""; wherein, the contents in the double quotation marks are the filenames of the files stored in the corresponding locations; the query only returns a pair of double quotation marks if no file is stored in the corresponding location. DG1000Z Programming Guide 2-41 RIGOL Chapter 2 Command System :MEMory:STATe:DELete Syntax :MEMory:STATe:DELete {USER1|USER2|USER3|USER4|USER5|USER6|USER7|USER8|USER9|USER10} Description Delete the state file stored in the specified location in the internal non-volatile memory of the instrument. Parameter Name {USER1|USER2|USER3| USER4|USER5|USER6| USER7|USER8|USER9| USER10} Explanation Example Related Command 2-42 Type Range Default Discrete USER1|USER2|USER3| USER4|USER5|USER6| USER7|USER8|USER9| USER10 None The internal non-volatile memory of the instrument provides 10 state file storage locations numbered USER1 to USER10 which representing the state files stored in the specified locations respectively. This command is valid only when the specified storage location contains a state file and the file is not locked (:MEMory:STATe:LOCK). If the file stored in the specified storage location is locked, please first unlock the file. :MEM:STAT:DEL USER1 /*Delete the state file stored in the location 1 in the internal non-volatile memory of the instrument */ :MEMory:STATe:LOCK DG1000Z Programming Guide RIGOL Chapter 2 Command System :MEMory:STATe:LOCK Syntax :MEMory:STATe:LOCK {USER1|USER2|USER3|USER4|USER5|USER|6USER7|USER8|USER9|USER10}, {ON|1|OFF|0} :MEMory:STATe:LOCK? {USER1|USER2|USER3|USER4|USER5|USER|6USER7|USER8|USER9|USER10} Description Lock or unlock the state file stored in the specified storage location in the internal non-volatile memory of the instrument. Query whether the state file stored in the specified storage location in the internal non-volatile memory of the instrument is locked. Parameter Explanation Return Format Example Related Commands Name Type {USER1|USER2|USER3| USER4|USER5|USER6| USER7|USER8|USER9| USER10} Discrete {ON|1|OFF|0} Bool Range Default USER1|USER2|USER3| USER4|USER5|USER6| USER7|USER8|USER9| USER10 ON|1|OFF|0 None OFF The internal non-volatile memory of the instrument provides 10 state file storage locations numbered USER1 to USER10 which representing the state files stored in the specified locations respectively. You can modify the filename of the locked file in the internal non-volatile memory of the instrument (:MEMory:STATe:NAME) but you cannot delete the locked file (:MEMory:STATe:LOCK). To delete the locked file, please first unlock it. The query returns ON or OFF. Assume that storage location 1 in the internal non-volatile memory of the instrument contains a state file. :MEM:STAT:LOCK USER1,ON /*Lock the state file stored in storage location 1 in the internal non-volatile memory of the instrument*/ :MEM:STAT:LOCK? USER1 /*Query whether the state file stored in storage location 1 in the internal non-volatile memory of the instrument is locked and the query returns ON*/ :MEMory:STATe:NAME :MEMory:STATe:LOCK DG1000Z Programming Guide 2-43 RIGOL Chapter 2 Command System :MEMory:STATe:NAME Syntax :MEMory:STATe:NAME {0|1|2|3|4|5|6|7|8|9}[, ] :MEMory:STATe:NAME? {0|1|2|3|4|5|6|7|8|9} Description Modify the filename of the state file stored in the specified storage location of the internal non-volatile memory of the instrument. Query the filename of the state file stored in the specified storage location of the internal non-volatile memory of the instrument. Parameter Explanation Return Format Example Related Command 2-44 Name Type Range Default {0|1|2|3|4|5|6|7|8|9} Discrete 0|1|2|3|4|5|6|7|8|9 None ASCII string Refer to the “Explanation” NULL The internal non-volatile memory of the instrument provides 10 state file storage locations. The parameters 0 to 9 represent the state files in storage locations 1 to 10 respectively. is the specified filename and cannot exceed 9 characters. It can contain Chinese characters, English uppercase characters and numbers; wherein, a Chinese character occupies 2 characters. If the parameter is omitted, the filename is empty. This command is valid only when the specified storage location contains a state file (:MEMory:STATe:VALid?). The query returns a string enclosed in double quotation marks, for example, "123.RSF"; wherein, 123 is the filename and .RSF is the filename suffix of the state file. :MEM:STAT:VAL? USER2 /*Query whether storage location 2 in the internal non-volatile memory of the instrument contains a state file and the query returns 1*/ :MEM:STAT:NAME 1,123 /* Modify the filename of the state file stored in storage location 2 of the internal non-volatile memory of the instrument to 123.RSF*/ :MEM:STAT:NAME? 1 /*Query the filename of the state file stored in storage location 2 of the internal non-volatile memory of the instrument and the query returns "123.RSF"*/ :MEMory:STATe:VALid? DG1000Z Programming Guide RIGOL Chapter 2 Command System :MEMory:STATe:RECall:AUTO Syntax :MEMory:STATe:RECall:AUTO {ON|1|OFF|0} :MEMory:STATe:RECall:AUTO? Description Set the instrument configuration to be used at the next power-on to last (ON or 1) or default (OFF or 0). Query the instrument configuration to be used at the next power-on. Parameter Explanation Return Format Example Name Type Range Default { ON|1|OFF|0} Bool ON|1|OFF|0 OFF Last (ON or 1): the instrument uses the system configuration (include all the system parameters and states except the channel on/off state) used before the last power-off. Default (OFF or 0): the instrument uses the factory default at power-on except the parameters that will not be affected by a factory reset (refer to “Appendix B: Factory Setting”). The query returns ON or OFF. :MEM:STAT:RECall:AUTO ON /*Set the instrument configuration to be used at the next power-on to last*/ :MEM:STAT:RECall:AUTO? /*Query the instrument configuration to be used at the next power-on and the query returns ON*/ :MEMory:STATe:VALid? Syntax Description :MEMory:STATe:VALid? {USER1|USER2|USER3|USER4|USER5|USER|6USER7|USER8|USER9|USER10} Query whether the specified storage location in the internal non-volatile memory of the instrument contains a state file. Parameter Name {USER1|USER2|USER3| USER4|USER5|USER6| USER7|USER8|USER9| USER10} Explanation Return Format Type Range Default Discrete USER1|USER2|USER3| USER4|USER5|USER6| USER7|USER8|USER9| USER10 None The internal non-volatile memory of the instrument provides 10 state file storage locations numbered USER1 to USER10 which representing the state files stored in the specified locations respectively. The query returns 1 or 0; wherein, 1 denotes that the specified storage location contains a state file and 0 denotes that the specified storage location does not contain a state file. DG1000Z Programming Guide 2-45 RIGOL Chapter 2 Command System :MMEMory Commands The :MMEMory commands are used to query and set the related information of the external memory, including querying the files and folders in the external memory, setting the current directory, copying the file in the current directory to the specified directory, loading the file in the external memory, creating a new folder and storing a file in the external memory. Command List: :MMEMory:CATalog[:ALL]? :MMEMory:CATalog:DATA:ARBitrary? :MMEMory:CATalog:STATe? :MMEMory:CDIRectory :MMEMory:COPY :MMEMory:DELete :MMEMory:LOAD[:ALL] :MMEMory:LOAD:DATA :MMEMory:LOAD:STATe :MMEMory:MDIRectory :MMEMory:RDIRectory? :MMEMory:RDIRectory :MMEMory:STORe[:ALL] :MMEMory:STORe:DATA :MMEMory:STORe:STATe 2-46 DG1000Z Programming Guide RIGOL Chapter 2 Command System :MMEMory:CATalog[:ALL]? Syntax Description :MMEMory:CATalog[:ALL]? [ ] Query all the files and folders in the current directory. Parameter Explanation Return Format Example Name Type Range Default ASCII string Valid directory in the external memory "D:\" This command is only applicable to the external memory. is a valid directory in the external memory, including the D disk and the folders in the D disk. It is a string enclosed in double quotation marks, for example, "D:\" and "D:\Rigol". The query returns a string in the following format: space used,space available,"size,property,name",……; wherein, the units of the space used and space available are byte, the property of the file is empty and the size is the space that it occupies, the property of the folder is DIR and the size is the sum of the number of the files and folders in the folder plus 1. For example, 28672,4102361088,"3,DIR,Rigol","80,,Rigol1.RAF","1360,,Rigol0.RSF" denotes that for the external memory currently connected to the instrument, its space used is 28672 bytes and the space available is 4102361088 bytes; it contains 1 folder (Rigol) and the folder contains 2 files or folders; it contains 2 files of which the size of the arbitrary waveform file (Rigol1.RAF) is 80 bytes and the size of the state file (Rigol0.RSF) is 1360 bytes. Assume that the current directory is D:\. :MMEM:CAT? DG1000Z Programming Guide /*Query all the files and folders in the external memory and the query returns 28672,4102361088,"3,DIR,Rigol","80,,Rigol1.RAF","1360,,Rigol 0.RSF"*/ 2-47 RIGOL Chapter 2 Command System :MMEMory:CATalog:DATA:ARBitrary? Syntax Description :MMEMory:CATalog:DATA:ARBitrary? [ ] Query the arbitrary waveform file under the current operation directory. Parameter Explanation Return Format Example Name Type Range Default ASCII string Valid directory in the external memory "D:\" This command is only applicable to the external memory. is a valid directory in the external memory, including the D disk and the folders in the D disk. It is a string enclosed in double quotation marks, for example, "D:\" and "D:\Rigol". The query returns a string in the following format: space used,space available, "size,property,name",……; wherein, the units of the space used and space available are byte, the property of the file is empty and the size is the space it occupies. For example, 28672,4102361088,"80,,Rigol1.RAF" denotes that for the external memory currently connected to the instrument, its space used is 28672 bytes and the space available is 4102361088 bytes; it contains an arbitrary waveform file (Rigol1.RAF) and its size is 80 bytes. Assume that the current directory is D:\, :MMEM:CAT:DATA:ARB? /*Query the arbitrary waveform file in the external memory directory and the query returns 28672,4102361088,"80,,Rigol1.RAF"*/ :MMEMory:CATalog:STATe? Syntax Description :MMEMory:CATalog:STATe? [ ] Query the state file under the current operation directory. Parameter Explanation Return Format Example Name Type Range Default ASCII string Valid directory in the external memory "D:\" This command is only applicable to the external memory. is a valid directory in the external memory, including the D disk and the folders in the D disk. It is a string enclosed in double quotation marks, for example, "D:\" and "D:\Rigol". The query returns a string in the following format: space used,space available, "size,property,name",……; wherein, the units of the space used and space available are byte, the property of the file is empty and the size is the space it occupies. For example, 28672,4102361088,"1360,,Rigol0.RSF" denotes that for the external memory currently connected to the instrument, its space used is 28672 bytes and the space available is 4102361088 bytes; it contains an state file (Rigol0.RSF) and its size is 1360 bytes. Assume that the current directory is D:\. :MMEM:CAT:STAT? 2-48 /*Query the state file in the external memory directory and the query returns 28672,4102361088,"1360,,Rigol0.RSF"*/ DG1000Z Programming Guide RIGOL Chapter 2 Command System :MMEMory:CDIRectory Syntax :MMEMory:CDIRectory :MMEMory:CDIRectory? Description Set the current directory. Query the current directory. Parameter Explanation Return Format Example Name Type Range Default ASCII string Valid directory in the external memory "D:\" This command is only applicable to the external memory. is a valid directory in the external memory, including the D disk and the folders in the D disk. It is a string enclosed in double quotation marks, for example, "D:\" and "D:\Rigol". The query returns a string enclosed in double quotation marks and the content in the double quotation marks is the current directory, for example, "D:\". :MMEM:CDIR "D:\" /*Set the current directory to the D disk (external memory)*/ :MMEM:CDIR? /*Query the current directory and the query returns "D:\"*/ :MMEMory:COPY Syntax Description :MMEMory:COPY , Copy the file under the current directory in the external memory to the specified directory in the external memory (not the current directory). Parameter Explanation Example Name Type Range Default ASCII string Valid directory in the external memory None ASCII string Filename of the file under the current directory of the external memory None This command is only applicable to the external memory. is a valid directory in the external memory, including the D disk and the folders in the D disk. It is a string enclosed in double quotation marks, for example, "D:\" and "D:\Rigol". Assume that the current directory is D:\, :MMEM:COPY "D:\Rigol","Rigol1.RAF" DG1000Z Programming Guide /*Copy the file Rigol1.RAF under the external memory directory to "D:\Rigol" (the Rigol folder in D disk)*/ 2-49 RIGOL Chapter 2 Command System :MMEMory:DELete Syntax Description :MMEMory:DELete Delete the specified file or empty folder in the current directory of the external memory. Parameter Name Return Format Example Type Range Default ASCII string The filename of the file or the folder name of the empty folder in the current directory of the external memory None This command is only applicable to the external memory. is the filename of the file or the folder name of the empty folder in the current directory of the external memory and it is a string enclosed in double quotation marks, for example, "Rigol1.RAF". Assume that the current directory is D:\, :MMEM:DEL "Rigol1.RAF" /*Delete the file Rigol1.RAF in the external memory (D:\)*/ :MMEMory:LOAD[:ALL] Syntax Description :MMEMory:LOAD[:ALL] Load the specified state file or arbitrary waveform file in the current directory of the external memory. Parameter Name Explanation Example Type Range Default ASCII string The filename of the state file or the arbitrary waveform file in the current directory of the external memory None This command is only applicable to the external memory. is the filename of the state file or the arbitrary waveform file in the current directory of the external memory and it is a string enclosed in double quotation marks, for example, "Rigol0.RSF". If the file to be loaded is arbitrary waveform file, it will be loaded into the current channel. Assume that the current directory is D:\. :MMEM:LOAD "Rigol0.RSF" 2-50 /*Load the file Rigol0.RSF in the external memory (D:\)*/ DG1000Z Programming Guide RIGOL Chapter 2 Command System :MMEMory:LOAD:DATA Syntax Description :MMEMory:LOAD:DATA[1|2] Load the specified arbitrary waveform file in the current directory of the external memory into the specified channel. Parameter Name Type Range Default [1|2] Discrete 1|2 1 ASCII string The filename of the arbitrary waveform file in the current directory of the external memory None Explanation Example This command is only applicable to the external memory. [1|2] denotes the channel (CH1 or CH2) into which will the specified arbitrary waveform file in the current directory of the external memory be loaded. When it is omitted, the file will be loaded into CH1. is the filename of the arbitrary waveform file in the specified directory of the external memory and it is a string enclosed in double quotation marks, for example, "Rigol4.RAF". Assume that the current directory is D:\Rigol, :MMEM:LOAD:DATA "Rigol4.RAF" /*Load the arbitrary waveform file Rigol4.RAF in the current directory of the external memory (D:\Rigol) into the current channel*/ :MMEMory:LOAD:STATe Syntax Description :MMEMory:LOAD:STATe Load the specified state file in the current directory of the external memory. Parameter Explanation Example Name Type Range Default ASCII string The filename of the state file in the current directory of the external memory None This command is only applicable to the external memory. is the filename of the state file in the current directory of the external memory and it is a string enclosed in double quotation marks, for example, "Rigol0.RSF". Assume that the current directory is D:\. :MMEM:LOAD "Rigol0.RSF" DG1000Z Programming Guide /*Load the state file Rigol0.RSF in the external memory (D:\)*/ 2-51 RIGOL Chapter 2 Command System :MMEMory:MDIRectory Syntax Description :MMEMory:MDIRectory Create a folder in the current directory of the external memory with the specified name. Parameter Explanation Example Name Type Range Default ASCII string Refer to the “Explanation” None This command is only applicable to the external memory. is a string enclosed in double quotation marks. The content in the double quotation marks is the name of the folder to be created and cannot exceed 9 characters (can be Chinese characters, English uppercase characters and numbers; wherein, a Chinese character occupies 2 characters). If D disk already contains a folder with the same name, the system prompts a remote command error. Assume that the current directory is D:\, :MMEM:MDIR "RIGOL1" /*Create a folder named “RIGOL1” in D disk*/ :MMEMory:RDIRectory? Syntax Description Return Format :MMEMory:RDIRectory? Query the disk drive available. The query returns a string in the form of "the number of disk drives available,"the names of the disk drives available:"", for example, "1,"D:"" which denotes that there is a disk drive available named D:. If there is no disk drive available currently, the query returns "0,"NULL"". :MMEMory:RDIRectory Syntax Description Parameter Example :MMEMory:RDIRectory Delete the specified directory (empty folder) in the external memory. Name Type Range Default ASCII string Folder name of the empty folder in the external memory None Assume that the external memory contains an empty folder named 111, :MMEM:RDIR "111" 2-52 /*Delete the empty folder 111 in the external memory*/ DG1000Z Programming Guide RIGOL Chapter 2 Command System :MMEMory:STORe[:ALL] Syntax Description :MMEMory:STORe[:ALL] Store the current instrument state or the arbitrary waveform data of the current channel into the current directory of the external memory in state file or arbitrary waveform file form with the specified name. Parameter Explanation Example Name Type Range Default ASCII string Filename of the specified state file or arbitrary waveform file None This command is only applicable to the external memory. is a string enclosed in double quotation marks and the content in the double quotation marks is the filename of the specified state file or arbitrary waveform file (include the file type suffix .RSF or .RAF). The filename cannot exceed 9 characters and can be Chinese characters, English characters and numbers; wherein, a Chinese character occupies 2 characters. Assume that the current directory is D:\, :MMEM:STOR "R00.RSF" /*Store the current instrument state into D disk in the state file form with the filename R00.RSF*/ :MMEMory:STORe:DATA Syntax Description :MMEMory:STORe:DATA[1|2] Store the arbitrary waveform data of the specified channel into the current directory of the external memory in arbitrary waveform file form with the specified filename. Parameter Explanation Example Name Type Range Default [1|2] Discrete 1|2 1 ASCII string Filename of the specified arbitrary waveform file None This command is only applicable to the external memory. is a string enclosed in double quotation marks and the content in the double quotation marks is the filename of the specified arbitrary waveform file (include the file type suffix .RAF). The filename cannot exceed 9 characters and can be Chinese characters, English characters and numbers; wherein, a Chinese character occupies 2 characters. Assume that the current directory is D:\, :MMEM:STOR:DATA "R11.RAF" DG1000Z Programming Guide /*Store the arbitrary waveform data of the current channel into D disk in arbitrary waveform file form with the filename R11.RAF*/ 2-53 RIGOL Chapter 2 Command System :MMEMory:STORe:STATe Syntax Description :MMEMory:STORe:STATe Store the current instrument state into the current directory of the external memory in state file form with the specified filename. Parameter Explanation Example Name Type Range Default ASCII string Refer to the “Explanation" None This command is only applicable to the external memory. is a string enclosed in double quotation marks and the content in the double quotation marks is the filename of the specified state file (include the file type suffix .RSF). The filename cannot exceed 9 characters and can be Chinese characters, English characters and numbers; wherein, a Chinese character occupies 2 characters. Assume that the current directory is D:\, :MMEM:STOR:STAT "R22.RSF" 2-54 /*Store the current instrument state into D disk in state file form with the filename R22.RSF*/ DG1000Z Programming Guide RIGOL Chapter 2 Command System :OUTPut Commands The :OUTPut commands is used to set and query the information related to the channel output and sync signal, including setting and querying the channel output state, output polarity, output impedance, output mode and gate polarity as well as setting and querying the output state, output polarity and delay time of the sync signal. Command List: :OUTPut[ ]:GATe:POLarity :OUTPut[ ]:IMPedance :OUTPut[ ]:LOAD :OUTPut[ ]:MODE :OUTPut[ ]:POLarity :OUTPut[ ][:STATe] :OUTPut[ ]:SYNC:DELay :OUTPut[ ]:SYNC:POLarity :OUTPut[ ]:SYNC[:STATe] :OUTPut[ ]:GATe:POLarity Syntax :OUTPut[ ]:GATe:POLarity {POSitive|NEGative} :OUTPut[ ]:GATe:POLarity? Description Set the gate polarity of the specified channel in the gated mode to POSitive or NEGative. Query the gate polarity of the specified channel in the gated mode. Parameter Explanation Return Format Example Related Command Name Type Range Default [ ] Discrete 1|2 1 {POSitive|NEGative} Discrete POSitive|NEGative POSitive When [ ] is omitted, the commands set and query the related parameters of CH1 by default. In the gated mode (:OUTPut[ ]:MODE), the output state of the output connector of the specified channel is controlled by the gated signal received by the [Mod/Trig/FSK/Sync] connector of the corresponding channel at the rear panel. Positive: when the gated signal is high level, the channel output connector outputs signal. Negative: when the gated signal is low level, the channel output connector outputs signal. The query returns POSITIVE or NEGATIVE. :OUTP1:GAT:POL NEG /*Set the gate polarity of CH1 in the gated mode to negative*/ :OUTP1:GAT:POL? /*Query the gate polarity of CH1 in the gated mode and the query returns NEGATIVE*/ :OUTPut[ ]:MODE DG1000Z Programming Guide 2-55 RIGOL Chapter 2 Command System :OUTPut[ ]:IMPedance :OUTPut[ ]:LOAD Syntax :OUTPut[ ]:IMPedance { |INFinity|MINimum|MAXimum} :OUTPut[ ]:LOAD { |INFinity|MINimum|MAXimum} :OUTPut[ ]:IMPedance? [MINimum|MAXimum] :OUTPut[ ]:LOAD? [MINimum|MAXimum] Description Set the output impedance of the output connector of the specified channel. Query the output impedance of the output connector of the specified channel. Parameter Explanation Return Format Example 2-56 Name Type Range Default [ ] Discrete 1|2 1 Integer 1Ω to 10kΩ 50Ω When [ ] is omitted, the commands set and query the related parameters of CH1 by default. denotes setting the output impedance of the output connector of the specified channel to a specified value within the range available; INFinity denotes setting the output impedance of the output connector of the specified channel to HighZ. The output impedance setting affects the output amplitude and DC offset. If the actual load is different from the specified value, the voltage level displayed will not match the voltage level of the item under test. To ensure correct voltage level, make sure that the load impedance setting matches the actual load. The query returns the output impedance in scientific notation with 7 effective digits, for example, 1.000000E+02 which denotes that the output impedance is 100Ω. If the output impedance of the output connector of the specified channel is set to INFinity, the query returns 9.900000E+37. :OUTP1:IMP INF /*Set the output impedance of the output connector of CH1 to HighZ*/ :OUTP1:IMP? /*Query the output impedance of the output connector of CH1 and the query returns 9.900000E+37*/ :OUTP1:LOAD 100 /*Set the output impedance of the output connector of CH1 to 100Ω*/ :OUTP1:LOAD? /*Query the output impedance of the output connector of CH1 and the query returns 1.000000E+02*/ DG1000Z Programming Guide RIGOL Chapter 2 Command System :OUTPut[ ]:MODE Syntax :OUTPut[ ]:MODE {NORMal|GATed} :OUTPut[ ]:MODE? Description Set the output mode of the output connector of the specified channel to normal (NORMal) or gated (GATed). Query the output mode of the output connector of the specified channel. Parameter Explanation Return Format Example Related Command Name Type Range Default [ ] Discrete 1|2 1 {NORMal|GATed} Discrete NORMal|GATed NORMal When [ ] is omitted, the commands set and query the related parameters of CH1 by default. In the gated mode, the output state of the output connector of the specified channel is controlled by the gated signal received by the [Mod/Trig/FSK/Sync] connector of the corresponding channel at the rear panel. You can send the :OUTPut[ ]:GATe:POLarity command to set the gate polarity to “Positive” or “Negative”. Positive: when the gated signal is high level, the channel output connector outputs signal. Negative: when the gated signal is low level, the channel output connector outputs signal. The query returns NORMAL or GATED. :OUTP1:MODE GAT /*Set the output mode of the output connector of CH1 to gated*/ :OUTP1:MODE? /*Query the output mode of the output connector of CH1 and the query returns GATED*/ :OUTPut[ ]:GATe:POLarity DG1000Z Programming Guide 2-57 RIGOL Chapter 2 Command System :OUTPut[ ]:POLarity Syntax :OUTPut[ ]:POLarity {NORMal|INVerted} :OUTPut[ ]:POLarity? Description Set the output polarity of the specified channel to normal (NORMal) or inverted (INVerted). Query the output polarity of the specified channel. Parameter Explanation Return Format Example Name Type Range Default [ ] Discrete 1|2 1 {NORMal|INVerted} Discrete NORMal|INVerted NORMal When [ ] is omitted, the commands set and query the related parameters of CH1 by default. The output polarity of the channel refers to that the signal on the output connector of the channel is normal (NORMal) output or inverted (INVerted) output. In the normal mode, the instrument outputs normal waveform and in the inverted mode, the waveform is inverted and then outputted. The waveform is inverted relative to the offset voltage. After the waveform is inverted, the offset voltage remains unchanged and the sync signal related to the waveform is not inverted. The query returns NORMAL or INVERTED. :OUTP1:POL NORM /*Set the output polarity of CH1 to normal*/ :OUTP1:POL? /*Query the output polarity of CH1 and the query returns NORMAL*/ :OUTPut[ ][:STATe] Syntax :OUTPut[ ][:STATe] {ON|1|OFF|0} :OUTPut[ ][:STATe]? Description Turn on or off the output of the specified channel. Query the output status of the specified channel. Parameter Explanation Return Format Example 2-58 Name Type Range Default [ ] Discrete 1|2 1 {ON|1|OFF|0} Bool ON|1|OFF|0 OFF When [ ] is omitted, the commands set and query the related parameters of CH1 by default. The query returns ON or OFF. :OUTP1? /*Query the output status of CH1 and the query returns OFF*/ :OUTP1 ON /*Turn on the output of CH1*/ :OUTP1? /*Query the output status of CH1 and the query returns ON*/ DG1000Z Programming Guide RIGOL Chapter 2 Command System :OUTPut[ ]:SYNC:DELay Syntax :OUTPut[ ]:SYNC:DELay { |MINimum|MAXimum} :OUTPut[ ]:SYNC:DELay? [MINimum|MAXimum] Description Set the output delay time of the sync signal on the [Mod/Trig/FSK/Sync] connector of the specified channel at the rear panel. Parameter Explanation Return Format Example Related Commands Name Type Range Default [ ] Discrete 1|2 1 Real 0s to the carrier period 0s The output delay time of the sync signal refers to the output delay time of the sync signal on the [Mod/Trig/FSK/Sync] connector of the specified channel at the rear panel relative to the output signal of the output connector at the front panel. When [ ] is omitted, the commands set and query the related parameters of CH1 by default. When the modulation ([:SOURce[ ]]:MOD[:STATe]), sweep ([:SOURce[ ]]:SWEep:STATe) or burst ([:SOURce[ ]]:BURSt[:STATe]) function is enabled, the delay setting is invalid. The query returns the delay time of the sync signal in scientific notation with 7 effective digits, for example, 1.000000E-03 which denotes that the delay time of the sync signal is 1ms (namely 0.001s). :OUTP1:SYNC:DEL 0.001 /*Set the output delay time of the sync signal on the [Mod/Trig/FSK/Sync] connector of CH1 at the rear panel to 1ms (namely 0.001s)*/ :OUTP1:SYNC:DEL? /*Query the output delay time of the sync signal on the [Mod/Trig/FSK/Sync] connector of CH1 at the rear panel and the query returns 1.000000E-03*/ [:SOURce[ ]]:BURSt[:STATe] [:SOURce[ ]]:MOD[:STATe] [:SOURce[ ]]:SWEep:STATe DG1000Z Programming Guide 2-59 RIGOL Chapter 2 Command System :OUTPut[ ]:SYNC:POLarity Syntax :OUTPut[ ]:SYNC:POLarity {POSitive|NEGative} :OUTPut[ ]:SYNC:POLarity? Description Set the output polarity of the sync signal on the [Mod/Trig/FSK/Sync] connector of the specified channel at the rear panel to normal (POSitive) or inverted (NEGative). Query the output polarity of the sync signal on the [Mod/Trig/FSK/Sync] connector of the specified channel at the rear panel. Parameter Explanation Return Format Example Related Command 2-60 Name Type Range Default [ ] Discrete 1|2 1 {POSitive|NEGative} Discrete POSitive|NEGative POSitive When [ ] is omitted, the commands set and query the related parameters of CH1 by default. The output polarity of the sync signal refers to that the sync signal on the [Mod/Trig/FSK/Sync] connector of the channel at the rear panel is normal (POSitive) output or inverted (NEGative) output. In the normal mode, the instrument outputs the sync signal normally and in the inverted mode, the sync signal is inverted and then outputted. After the waveform is inverted (:OUTPut[ ]:POLarity), the sync signal related to the waveform will not be inverted. The query returns POS or NEG. :OUTP1:SYNC:POL POS /*Set the output polarity of the sync signal on the [Mod/Trig/FSK/Sync] connector of CH1 at the rear panel to normal */ :OUTP1:SYNC:POL? /*Query the output polarity of the sync signal on the [Mod/Trig/FSK/Sync] connector of CH1 at the rear panel and the query returns POS*/ :OUTPut[ ]:POLarity DG1000Z Programming Guide RIGOL Chapter 2 Command System :OUTPut[ ]:SYNC[:STATe] Syntax :OUTPut[ ]:SYNC[:STATe] {ON|1|OFF|0} :OUTPut[ ]:SYNC[:STATe]? Description Enable or disable the sync signal outputted from the [Mod/Trig/FSK/Sync] connector of the specified channel at the rear panel. Query the output status of the sync signal outputted from the [Mod/Trig/FSK/Sync] connector of the specified channel at the rear panel. Parameter Explanation Return Format Example Name Type Range Default [ ] Discrete 1|2 1 {ON|1|OFF|0} Bool ON|1|OFF|0 ON DG1000Z can output the sync signals of the basic waveform (except noise), arbitrary waveform (except DC), harmonic, sweep waveform, burst and modulated waveform from a single channel or both of the two channels at the same time. The sync signals are outputted from the [Mod/Trig/FSK/Sync] connector of the corresponding channel at the rear panel. When [ ] is omitted, the commands set and query the related parameters of CH1 by default. When the carrier frequency is greater than 30MHz, the sync signal will be outputted in frequency dividing output mode. If the sync signal is disabled, the mark signal used in the sweep will also be disabled. The query returns ON or OFF. :OUTP1:SYNC 1 /*Enable the sync signal outputted from the [Mod/Trig/FSK/Sync] connector of CH1 at the rear panel*/ :OUTP1:SYNC? /*Query the output status of the sync signal outputted from the [Mod/Trig/FSK/Sync] connector of CH1 at the rear panel and the query returns ON*/ :OUTP1:SYNC OFF /*Disable the sync signal outputted from the [Mod/Trig/FSK/Sync] connector of CH1 at the rear panel*/ :OUTP1:SYNC? /*Query the output status of the sync signal outputted from the [Mod/Trig/FSK/Sync] connector of CH1 at the rear panel and the query returns OFF*/ DG1000Z Programming Guide 2-61 RIGOL Chapter 2 Command System :PA Commands The :PA commands are used to set and query the related information when the external power amplifier (PA) is used, including setting and querying the on/off status, gain, output polarity and offset of the PA as well as saving the working status of the PA to the internal memory of the instrument. Command List: :PA:GAIN :PA:OFFSet[:STATe] :PA:OFFSet:VALUe :PA:OUTPut:POLarity :PA:SAVE :PA[:STATe] :PA:GAIN Syntax :PA:GAIN {1X|10X} :PA:GAIN? Description Set the gain of the signal amplification at the output terminal of the PA to 1X or 10X. Query the gain of the signal amplification at the output terminal of the PA. Parameter Explanation Return Format Example 2-62 Name Type Range Default {1X|10X} Discrete 1X|10X 1X 1X denotes outputting the signal without any gain. 10X denotes amplifying the signal for 10 times and then outputting it. The query returns 1X or 10X. :PA:GAIN 10X /*Set the gain of the signal amplification at the output terminal of the PA to 10X*/ :PA:GAIN? /*Query the gain of the signal amplification at the output terminal of the PA and the query returns 10X*/ DG1000Z Programming Guide RIGOL Chapter 2 Command System :PA:OFFSet[:STATe] Syntax :PA:OFFSet[:STATe] {ON|1|OFF|0} :PA:OFFSet[:STATe]? Description Turn on or off the output offset at the output terminal of the PA. Query the on/off status of the output offset at the output terminal of the PA. Parameter Explanation Return Format Example Related Command Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 OFF You can send the :PA:OFFSet:VALUe command to set the output offset at the output terminal of the PA. The query returns ON or OFF. :PA:OFFS ON /*Turn on the output offset at the output terminal of the PA*/ :PA:OFFS? /*Query the on/off status of the output offset at the output terminal of the PA and the query returns ON*/ :PA:OFFSet:VALUe :PA:OFFSet:VALUe Syntax :PA:OFFSet:VALUe { |MINimum|MAXimum} :PA:OFFSet:VALUe? [MINimum|MAXimum] Description Set the output offset at the output terminal of the PA. Query the output offset at the output terminal of the PA. Parameter Name Type Range Default Real -12V to 12V 0V Explanation You can send the :PA:OFFSet[:STATe] command to turn on or off the output offset at the output terminal of the PA. Return Format The query returns the output offset in scientific notation with 7 effective digits, for example, 1.234500E+00 (the output offset is 1.2345V). Example Related Command :PA:OFFS:VALU 1.2345 /*Set the output offset at the output terminal of the PA to 1.2345V*/ :PA:OFFS:VALU? /*Query the output offset at the output terminal of the PA and the query returns 1.234500E+00*/ :PA:OFFSet[:STATe] DG1000Z Programming Guide 2-63 RIGOL Chapter 2 Command System :PA:OUTPut:POLarity Syntax :PA:OUTPut:POLarity {NORMal|INVerted} :PA:OUTPut:POLarity? Description Set the output polarity of the signal at the output terminal of the PA to normal (NORMal) or inverted (INVerted). Query the output polarity of the signal at the output terminal of the PA. Parameter Explanation Return Format Example Name Type Range Default {NORMal|INVerted} Discrete NORMal|INVerted NORMal The output polarity of the signal at the output terminal of the PA refers to whether the signal at the output terminal of the PA is outputted in normal (NORMal) mode or inverted (INVerted) mode. In the normal mode, the signal is outputted normally; in the inverted mode, the signal is inverted and then outputted. The query returns NORMAL or INVERTED. :PA:OUTP:POL NORM /*Set the output polarity of the signal at the output terminal of the PA to NORMal*/ :PA:OUTP:POL? /*Query the output polarity of the signal at the output terminal of the PA and the query returns NORMAL*/ :PA:SAVE Syntax :PA:SAVE Description Save the current working state of the PA into the internal memory of the instrument. Explanation The instrument will load the working state stored automatically when the PA is turned on the next time. :PA[:STATe] Syntax :PA[:STATe] {ON|1|OFF|0} :PA[:STATe]? Description Turn on or off the external power amplifier. Query the on/off status of the external power amplifier. Parameter Explanation Return Format Example 2-64 Name Type Range Default {ON|1|OFF|0} Bool ON|1|OFF|0 OFF When the external power amplifier is turned on, the PA amplifies the input signal (namely the output signal of the signal generator) and then outputs the signal. When it is turned off, there is no output from the PA. The query returns ON or OFF. :PA ON /*Turn on the external power amplifier*/ :PA? /*Query the on/off status of the external power amplifier and the query returns ON*/ DG1000Z Programming Guide RIGOL Chapter 2 Command System :ROSCillator Commands The :ROSCillator commands are used to set the system clock source and the query the system clock source currently selected. Command List: :ROSCillator:SOURce :ROSCillator:SOURce:CURRent? :ROSCillator:SOURce Syntax Description :ROSCillator:SOURce {INTernal|EXTernal} Set the system clock source to internal source (INTernal) or external source (EXTernal). Parameter Explanation Example Related Commands Name Type Range Default {INTernal|EXTernal} Discrete INTernal|EXTernal INTernal DG1000Z provides a 10MHz internal clock source and can also receive the external clock source inputted from the [10MHz In/Out] connector at the rear panel. Besides, it can also output clock source for other devices via the [10MHz In/Out] connector. When the external clock source (EXTernal) is selected, the system detects whether there is valid external clock signal inputted from the [10MHz In/Out] connector at the rear panel. If not, the prompt message “Not detect a valid external clock!” will be displayed and the system will switch to internal clock source automatically. You can send the :ROSCillator:SOURce:CURRent? command to query the clock source currently selected. You can use the clock source to realize the synchronization of two or more instruments. When two instruments are synchronized, the “Align Phase” function is not available (the “Align Phase” function is used to adjust the phase relation between two output channels of the same instrument and cannot change the phase relation between the output channels of two instruments). You can change the phase relation between two instruments by changing the start phase of each output channel ([:SOURce[ ]]:PHASe[:ADJust]). :ROSC:SOUR INT /*Set the system clock source to internal source*/ :ROSCillator:SOURce:CURRent? [:SOURce[ ]]:PHASe[:ADJust] DG1000Z Programming Guide 2-65 RIGOL Chapter 2 Command System :ROSCillator:SOURce:CURRent? Syntax Description Query the system clock source currently selected. Explanation You can send the :ROSCillator:SOURce command to set the system clock source to internal or external. Return Format 2-66 :ROSCillator:SOURce:CURRent? The query returns INT or EXT. Example :ROSC:SOUR:CURR? Related Command :ROSCillator:SOURce /*Query the system clock source currently selected and the query returns INT*/ DG1000Z Programming Guide RIGOL Chapter 2 Command System :SOURce Commands The :SOURce commands are used to set and query the channel parameters, the related parameters of the modulation, sweep and burst functions, the coupling and waveform summing functions as well as turn on and off the corresponding function. The frequency ranges available for the different models and different waveforms of DG1000Z series are as shown in the table below. Table 2-1 Frequency ranges available for the different models and different waveforms of DG1000Z series Frequency DG1022Z DG1032Z DG1062Z Characteristic Sine 1μHz to 25MHz 1μHz to 30MHz 1μHz to 60MHz Square 1μHz to 25MHz 1μHz to 25MHz 1μHz to 25MHz Ramp 1μHz to 500kHz 1μHz to 500kHz 1μHz to 1MHz Pulse 1μHz to 15MHz 1μHz to 15MHz 1μHz to 25MHz Harmonic 1μHz to 10MHz 1μHz to 10MHz 1μHz to 20MHz Noise (-3dB) 25MHz bandwidth 30MHz bandwidth 60MHz bandwidth Arbitrary Waveform 1μHz to 10MHz 1μHz to 10MHz 1μHz to 20MHz Command List: :SOURce:APPLy Commands [:SOURce[ ]]:APPLy? [:SOURce[ ]]:APPLy:ARBitrary [:SOURce[ ]]:APPLy:DC [:SOURce[ ]]:APPLy:HARMonic [:SOURce[ ]]:APPLy:NOISe [:SOURce[ ]]:APPLy:PULSe [:SOURce[ ]]:APPLy:RAMP [:SOURce[ ]]:APPLy:SINusoid [:SOURce[ ]]:APPLy:SQUare [:SOURce[ ]]:APPLy:TRIangle [:SOURce[ ]]:APPLy:USER :SOURce:BURSt Commands [:SOURce[ ]]:BURSt:GATE:POLarity [:SOURce[ ]]:BURSt:INTernal:PERiod [:SOURce[ ]]:BURSt:MODE [:SOURce[ ]]:BURSt:NCYCles [:SOURce[ ]]:BURSt:PHASe [:SOURce[ ]]:BURSt[:STATe] [:SOURce[ ]]:BURSt:TDELay [:SOURce[ ]]:BURSt:TRIGger[:IMMediate] DG1000Z Programming Guide 2-67 RIGOL Chapter 2 Command System [:SOURce[ ]]:BURSt:TRIGger:SLOPe [:SOURce[ ]]:BURSt:TRIGger:SOURce [:SOURce[ ]]:BURSt:TRIGger:TRIGOut [:SOURce[ ]]:BURSt: IDLE :SOURce:FREQuency Commands [:SOURce[ ]]:FREQuency:CENTer [:SOURce[ ]]:FREQuency:COUPle:MODE [:SOURce[ ]]:FREQuency:COUPle:OFFSet [:SOURce[ ]]:FREQuency:COUPle:RATio [:SOURce[ ]]:FREQuency:COUPle[:STATe] [:SOURce[ ]]:FREQuency[:FIXed] [:SOURce[ ]]:FREQuency:SPAN [:SOURce[ ]]:FREQuency:STARt [:SOURce[ ]]:FREQuency:STOP :SOURce:FUNCtion Commands [:SOURce[ ]]:FUNCtion:ARBitrary:MODE [:SOURce[ ]]:FUNCtion:ARBitrary:SRATe [:SOURce[ ]]:FUNCtion:PULSe:DCYCle [:SOURce[ ]]:FUNCtion:PULSe:HOLD [:SOURce[ ]]:FUNCtion:PULSe:PERiod [:SOURce[ ]]:FUNCtion:PULSe:TRANsition[:BOTH] [:SOURce[ ]]:FUNCtion:PULSe:TRANsition:LEADing [:SOURce[ ]]:FUNCtion:PULSe:TRANsition:TRAiling [:SOURce[ ]]:FUNCtion:PULSe:WIDTh [:SOURce[ ]]:FUNCtion:RAMP:SYMMetry [:SOURce[ ]]:FUNCtion[:SHAPe] [:SOURce[ ]]:FUNCtion:SQUare:DCYCle [:SOURce[ ]]:FUNCtion:SQUare:PERiod :SOURce:HARMonic Commands 2-68 [:SOURce[ ]]:HARMonic:AMPL [:SOURce[ ]]:HARMonic:ORDEr [:SOURce[ ]]:HARMonic:PHASe [:SOURce[ ]]:HARMonic[:STATe] [:SOURce[ ]]:HARMonic:TYPe [:SOURce[ ]]:HARMonic:USER DG1000Z Programming Guide Chapter 2 Command System RIGOL :SOURce:MARKer Commands [:SOURce[ ]]:MARKer:FREQuency [:SOURce[ ]]:MARKer[:STATe] :SOURce[:MOD]:AM Commands [:SOURce[ ]][:MOD]:AM[:DEPTh] [:SOURce[ ]][:MOD]:AM:DSSC [:SOURce[ ]][:MOD]:AM:INTernal:FREQuency [:SOURce[ ]][:MOD]:AM:INTernal:FUNCtion [:SOURce[ ]][:MOD]:AM:SOURce [:SOURce[ ]][:MOD]:AM:STATe :SOURce[:MOD]:ASKey Commands [:SOURce[ ]][:MOD]:ASKey:AMPLitude [:SOURce[ ]][:MOD]:ASKey:INTernal[:RATE] [:SOURce[ ]][:MOD]:ASKey:POLarity [:SOURce[ ]][:MOD]:ASKey:SOURce [:SOURce[