DSA1000A ProgrammingGuide PDF
DSA1000A ProgrammingGuide PDF
DSA1000A ProgrammingGuide PDF
Programming Guide
RIGOL
Trademark Information
RIGOL is a registered trademark of RIGOL Technologies, Inc.
Publication Number
PGD01104-1110
Notices
RIGOL products are protected by patent law in and outside of P.R.C. RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at companys sole decision. Information in this publication replaces all previously corresponding material. RIGOL shall not be liable for losses caused by either incidental or consequential in connection with the furnishing, use or performance of this manual as well as any information contained. Any part of this document is forbidden to copy or photocopy or rearrange without prior written approval of RIGOL.
Product Certification
RIGOL guarantees this product conforms to the standards of national and industrial.
Meanwhile, the related standards conform to other ISO will get further. At present, DSA1000A Series has passed CE, cTUVus, PictBridge and LXI certification.
Contact Us
If you have any problem or requirement when using our products, please contact RIGOL Technologies, Inc. or your local distributors, or visit: www.rigol.com
RIGOL
II
RIGOL
Contents
Guaranty and Declaration .......................................................................... I Chapter 1 Overview ............................................................................. 1-1 Programming Introduction........................................................................ 1-2 SCPI Commands Introduction ................................................................... 1-3 Syntax ............................................................................................. 1-4 Symbol Description ........................................................................... 1-5 Parameter Type ................................................................................ 1-6 Command Abbreviation ............................................................................ 1-7 Chapter 2 Command Systems .............................................................. 2-1 IEEE 488.2 ............................................................................................. 2-2 :ABORt ................................................................................................... 2-5 :CALCulate.............................................................................................. 2-6 :CALibration .......................................................................................... 2-25 :CONFigure ........................................................................................... 2-26 :COUPle ............................................................................................... 2-31 :DISPlay ............................................................................................... 2-32 :FETCh ................................................................................................. 2-38 :FORMat ............................................................................................... 2-46 :HCOPy ................................................................................................ 2-47 :INITiate .............................................................................................. 2-51 :INPut .................................................................................................. 2-54 :MMEMory ............................................................................................ 2-55 :OUTPut ............................................................................................... 2-61 :READ .................................................................................................. 2-62 [:SENSe] .............................................................................................. 2-70 :SOURce............................................................................................... 2-98 :STATus ............................................................................................... 2-102 :SYSTem.............................................................................................. 2-105 :TRACe................................................................................................ 2-113 :TRIGer ............................................................................................... 2-119 :UNIT.................................................................................................. 2-120 Chapter 3 Programming Examples ...................................................... 3-1 Prepare for Programming ......................................................................... 3-2 Program in Visual C++ 6.0 ....................................................................... 3-4 Program in Visual Basic 6.0 .................................................................... 3-11
Programming Guide for DSA1000A series III
RIGOL
Program in LabVIEW 8.6 ......................................................................... 3-17 Linux Programming Example ................................................................... 3-22 Prepare for Programming ................................................................. 3-22 Linux Programming Guide................................................................. 3-25 Command Quick Reference A-Z ................................................................. 1
IV
Chapter 1 Overview
RIGOL
Chapter 1 Overview
This chapter introduces you the remote command programming and some relevant provisions of the SCPI (Standard Commands for Programmable Instruments) commands, which mainly includes: Programming Introduction SCPI Commands Introduction Syntax Symbol Description Parameter Type Command Abbreviation
1-1
RIGOL
Chapter 1 Overview
Programming Introduction
DSA1000A provides two kinds of interfaces for connecting with a computer: USB and GPIB. For the specified method of application, refer to the Users Guide of this product. While you program using commands, all command words are transmitted and identified as ASCII string that enable users to control and carry out secondary development. By programming, you can: Setup the analyzer. Make a measurement. Obtain data from the analyzer (such as the working status of the analyzer and the measurement results).
1-2
Chapter 1 Overview
RIGOL
1-3
RIGOL
Chapter 1 Overview
Syntax
SCPI commands present a hierarchical tree structure and have more sub-systems. Each sub-system contains a root keyword and one or more sub-keywords. A command line usually begins with a : which is also used to separate different keywords; parameters are permitted to follow the keyword; ? appeared following a command line denotes to query; space is used to separate the command and parameter. For example: :CALCulate:BANDwidth:NDB <rel_ampl> :CALCulate:BANDwidth:NDB? CALCulate is the root keyword of the command above. BANDwidth and NDB are the second and third keyword separately. The command line begins with a : and uses : to separate each keyword; <rel_ampl> denotes a assignable parameter; ? denotes to query; command :CALCulate:BANDwidth:NDB and prarameter <rel_ampl> are separated by a space. , is generally used for separating different parameters contained in the same command, such as: :SYSTem:DATE <year>,<month>,<day>
1-4
Chapter 1 Overview
RIGOL
Symbol Description
The following four symbols are not the content of SCPI commands but usually used in instances of the parameters from Explanation commands. 1. Braces { } The parameters enclosed in braces are optional and can be ignored or set one or more times, such as: [:SENSe]:CORRection:CSET<n>:DATA <freq>,<rel_ampl>{,<freq>,<rel_ampl>} In the command above, you can ignore parameters {,<freq>,<rel_ampl>} or assign them one or more values. Vertical Bar | The vartical bar separates two or more optional parameters. When you send a command, at least one of the parameters should be selected, such as :DISPlay:MENU:STATe OFF|ON|0|1 In the command above, you can select OFF, ON, 0 or 1. Square Brackets [ ] The contents such as keywords enclosed in square brackets could be omitted, but all of them would be executed regardless whether they were omitted such as: [:SENSe]:CORRection:OFFSet[:MAGNitude]? The following three commands serve a similar purpose: :CORRection:OFFSet? :CORRection:OFFSet:MAGNitude? :SENSe:CORRection:OFFSet? Triangle Brackets < > The parameter enclosed in triangle brackets must be an effective value such as: :DISPlay:BRIGtness <integer> :DISPlay:BRIGtness 10
2.
3.
4.
1-5
RIGOL
Chapter 1 Overview
Parameter Type
The commands presented in this manual contains 6 kinds of parameters and different parameters has different setting methods. 1. Boolean The parameter should be OFF, ON, 0 or 1, such as :DISPlay:MENU:STATe OFF|ON|0|1 Keywords The parameter should be an option listed in the command, such as :DISPlay:AFUnction:POSition BOTTom|CENTer|TOP The parameter is BOTTom, CENTer or TOP. Integer The parameter can be any integer within valid range unless where noted. Please do not use decimal for the parameter, or errors may occur, such as :DISPlay:BRIGtness <integer> Parameter <integer> can be any integer within 0 and 255. Consecutive Real Number The parameters can be any value within valid range (the default accuracy contains up to 6 digits after the decimal points), such as :CALCulate:BANDwidth:NDB <rel_ampl> Parameter <rel_ampl> can be any real number within -100 and 100. Discrete The parameters are discontinuous and should be a specified value, such as :CALCulate:MARKer<n>:MAXimum:MAX Parameter <n> can only be 1, 2, 3 or 4. ASCII Character String The parameter should be a composition of ASCII characters, such as :SYSTem:DATE <year>,<month>,<day> Parameters above should be a date string.
2.
3.
4.
5.
6.
1-6
Chapter 1 Overview
RIGOL
Command Abbreviation
Since all commands are case-insensitive, you can use any kind of them. But if use an abbreviation, the capital letters specified in the command must be written completely. For example: :CALCulate:BANDwidth:NDB? also could be: :CALC:BAND:NDB?
1-7
RIGOL
NOTE: In this command system, a query will return N/A (without double quotation marks) if the function to be queried is an uninstalled option or ERR (without double quotation marks) if the function is OFF or does not match unless where noted in this manual.
2-1
RIGOL
IEEE 488.2
IEEE standard defines some common commands for users to check basic information about the instrument and execute common operations. These commands begin with a * and have a keywords 3 characters length. *CLS *ESE *ESE? *ESR? *IDN? *OPC *OPC? *RST *SRE *SRE? *STB? *TRG *WAI
2-2
RIGOL
1.
*CLS *CLS Clears all event registers and the error queue as well as the input queue.
Syntax Function
2.
*ESE *ESE <value> *ESE? Sets the enable value of a standard event, such as *ESE 0 The query returns 0*. Bit 1 and bit 6 are not used in the Standard Event Register and always regarded as 0, thereinto <value> is a decimal number that relates to any binary number whose bits of 6 and 1 are both 0 within 00000000 (0) and 11111111 (255).
Syntax Function
Explanations
*Remark: Double quotation marks wouldt be returned after a query unless where noted in this manual.
3.
*ESR? *ESR? Queries the standard event status register. The query returns a decimal number that relates to any binary number whose bits of 6 and 1 are both 0 within 00000000 (0) and 11111111 (255).
Syntax Function
4.
*IDN? *IDN? Queries the instrument ID and returns a string with the length at least 35 characters.
Syntax Function
5.
*OPC *OPC *OPC? *OPC: sets the Operation Complete (bit 0) of the standard event status register to 1 after the current operation. *OPC?: queries if the current operation has been finished or not, and returns 1 if successful; otherwise returns 0.
Syntax Function
2-3
RIGOL
6.
Syntax Function
*SRE <value> *SRE? Sets the service request enable value, such as *SRE 0 The query returns 0. Bit 0 and bit 1 are not used in the Status Byte Register and always regarded as 0, thereinto <value> a decimal number that relates to any binary number whose bits of 0 and 1 are both 0 within 00000000 (0) and 11111111 (255).
Explanations
8.
*STB? *STB? Read Status Byte Query. The query returns a decimal number that relates to any binary number whose bits of 0 and 1 are both 0 within 00000000 (0) and 11111111 (255).
Syntax Function
9.
2-4
RIGOL
:ABORt
:ABORt
1.
:ABORt :ABORt Aborts the current operation and sweeps all over again.
Syntax Function
2-5
RIGOL
:CALCulate
2-6
:CALCulate:BANDwidth:NDB :CALCulate:BANDwidth:RESult? :CALCulate:LLINe:ALL:DELete :CALCulate:LLINe:CONTrol:DOMain :CALCulate:LLINe<n>:CONTrol:INTerpolate:TYPE :CALCulate:LLINe<n>:STATe :CALCulate:LLINe<n>:DATA :CALCulate:LLINe<n>:DATA:MERGe :CALCulate:LLINe<n>:DELete :CALCulate:LLINe:FAIL? :CALCulate:LLINe:FAIL:STOP:STATe :CALCulate:LLINe:FAIL:RATIo? :CALCulate:MARKer:AOFF :CALCulate:MARKer<n>:CPEak[:STATe] :CALCulate:MARKer<n>:DELTa[:SET]:CENTer :CALCulate:MARKer<n>:DELTa[:SET]:SPAN :CALCulate:MARKer:FCOunt:RESolution :CALCulate:MARKer:FCOunt:RESolution:AUTO :CALCulate:MARKer:FCOunt[:STATe] :CALCulate:MARKer:FCOunt:X? :CALCulate:MARKer<n>:FUNCtion :CALCulate:MARKer<n>:MAXimum:MAX :CALCulate:MARKer<n>:MAXimum:LEFT :CALCulate:MARKer<n>:MAXimum:NEXT :CALCulate:MARKer<n>:MAXimum:RIGHt :CALCulate:MARKer<n>:MINimum :CALCulate:MARKer<n>:MODE :CALCulate:MARKer<n>:PEAK:EXCursion :CALCulate:MARKer<n>:PEAK:SEARch:MODE :CALCulate:MARKer<n>:PEAK[:SET]:CF :CALCulate:MARKer<n>:PEAK:THReshold :CALCulate:MARKer<n>:PTPeak :CALCulate:MARKer<n>[:SET]:CENTer :CALCulate:MARKer<n>[:SET]:RLEVel :CALCulate:MARKer<n>[:SET]:STARt
Programming Guide for DSA1000A series
RIGOL
:CALCulate:MARKer<n>[:SET]:STEP :CALCulate:MARKer<n>[:SET]:STOP :CALCulate:MARKer<n>:STATe :CALCulate:MARKer:TABLe:STATe :CALCulate:MARKer<n>:TRACe :CALCulate:MARKer<n>:TRACe :AUTO :CALCulate:MARKer:TRCKing[:STATe] :CALCulate:MARKer<n>:X :CALCulate:MARKer<n>:X:CENTer :CALCulate:MARKer<n>:X:POSition :CALCulate:MARKer<n>:X:POSition:CENTer :CALCulate:MARKer<n>:X:POSition:SPAN :CALCulate:MARKer<n>:X:POSition:STARt :CALCulate:MARKer<n>:X:POSition:STOP :CALCulate:MARKer<n>:X:READout :CALCulate:MARKer<n>:X:SPAN :CALCulate:MARKer<n>:X:STARt :CALCulate:MARKer<n>:X:STOP :CALCulate:MARKer<n>:Y? :CALCulate:NTData[:STATe]
2-7
RIGOL
1.
:CALCulate:BANDwidth:NDB :CALCulate:BANDwidth:NDB <rel_ampl> :CALCulate:BANDwidth:NDB? Sets the N value of the N dB BW measurement, such as :CALC:BAND:NDB -4 The query returns -4.000000E+00. <rel_ampl> ranges from -100 dB to 100 dB. -3 dB Marker Fctn, N dB BW
Syntax Function
:CALCulate:BANDwidth:RESult? :CALCulate:BANDwidth:RESult? The query returns the measured bandwidth (in Hz) according to the N value specified by command :CALCulate:BANDwidth:NDB, such as 80000000. The query returns --- if the returned value is unavailable. Marker Fctn, N dB BW
Syntax Function
:CALCulate:LLINe:ALL:DELete :CALCulate:LLINe:ALL:DELete Deletes the current edited limit line. Meas, Pass/Fail Meas Setup, Limit, Upper, Del Limit Meas Setup, Limit, Lower, Del Limit
4.
:CALCulate:LLINe:CONTrol:DOMain :CALCulate:LLINe:CONTrol:DOMain FREQuency|TIME :CALCulate:LLINe:CONTrol:DOMain? Specifies the unit of Frequency or Time as the unit of X-axis. The query returns FREQ or TIME. The command works for both upper and lower limit. Changes in unit of X-axis may delete all edited points under the current limit line.
2-8
RIGOL
5.
:CALCulate:LLINe<n>:CONTrol:INTerpolate:TYPE :CALCulate:LLINe<n>:CONTrol:INTerpolate:TYPE LOGarithmic|LINear :CALCulate:LLINe<n>:CONTrol:INTerpolate:TYPE? Sets the type of frequency interpolation. The query returns LOG or LIN. <n> is 1 (lower limit line) or 2 (upper limit line). In Log mode, both frequency and amplitude use Log for an interpolation operation. In Line mode, the frequency uses Lin and the amplitude uses Log for an interpolation operation.
Syntax
Function Explanations
6.
:CALCulate:LLINe<n>:STATe :CALCulate:LLINe<n>:STATe OFF|ON|0|1 :CALCulate:LLINe<n>:STATe? Turns on or off the upper/lower limit line. The query returns 0 or 1. <n> is 1 (lower limit line) or 2 (upper limit line). OFF|0 Meas, Pass/Fail Meas Setup, Limit, Upper/Lower, Test, On/Off
7.
:CALCulate:LLINe<n>:DATA :CALCulate:LLINe<n>:DATA <x-axis>,<ampl>,<connected>{,<x-axis>,<ampl>,<connected>} :CALCulate:LLINe<n>:DATA? Creates a limit line, take the case of three points: :CALC:LLIN2:DATA 50,100,0,100,150,1,200,200,1 The query returns: 50,100.000000,0,100,150.000000,1,200,200.000000,1 <n>: denotes the limit line to be edited, which can be 1 (lower limit line) or 2 (upper limit line). <x-axis>: denotes the frequency (in Hz) or time (in us) of selected point.
Syntax
Function
Explanations
2-9
RIGOL
Front Panel
<ampl>: denotes the amplitude (in dBm) of selected point. <connected>: denotes if to connect the points of current with the last one, which can be 1(connect) or 0 (disconnect). Each limit line allows no more than 200 points. The query returns NULL if none of points are created for the specified limit line.
8.
:CALCulate:LLINe<n>:DATA:MERGe :CALCulate:LLINe<n>:DATA:MERGe <x-axis>,<ampl>,<connected>{,<x-axis>,<ampl>,<connected>} Adds extra points to the limit line, such as :CALC:LLIN2:DATA:MERG 250,200,1,300,250,1 Refer to :CALCulate:LLINe<n>:DATA to get explanation of the parameters in this command.
9.
:CALCulate:LLINe<n>:DELete :CALCulate:LLINe<n>:DELete Deletes the limit line you are editing. <n> is 1 (lower limit) or 2 (upper limit). Meas, Pass/Fail Meas Setup, Limit, Upper, Del Limit Meas Setup, Limit, Lower, Del Limit
10. :CALCulate:LLINe:FAIL? Syntax Function :CALCulate:LLINe:FAIL? Queries the Pass/Fail test result. The query returns PASS or FAIL, or UNMEAS if the measurement is unfinished.
:CALCulate:LLINe:FAIL:STOP:STATe OFF|ON|0|1 :CALCulate:LLINe:FAIL:STOP:STATe? Sets whether to continue a new sweep or not. The query returns 0 or 1. ON|1 Meas, Pass/Fail
Programming Guide for DSA1000A series
RIGOL
Meas Setup, Fail Stop, On/Off 12. :CALCulate:LLINe:FAIL:RATIo? Syntax Function :CALCulate:LLINe:FAIL:RATIo? The query returns the failure rate from the test results, such as 0.000000E+00.
13. :CALCulate:MARKer:AOFF Syntax Function Front Panel :CALCulate:MARKer:AOFF Turns off all markers and functions based upon markers. Marker, All Off
14. :CALCulate:MARKer<n>:CPEak[:STATe] Syntax Function Explanations :CALCulate:MARKer<n>:CPEak[:STATe] OFF|ON|0|1 :CALCulate:MARKer<n>:CPEak[:STATe]? Turns on or off the Cont Peak Search. The query returns 0 or 1. <n> is 1, 2, 3 or 4. The command turns on Marker 1 automatically if none is enabled.
15. :CALCulate:MARKer<n>:DELTa[:SET]:CENTer Syntax Function Explanations :CALCulate:MARKer<n>:DELTa[:SET]:CENTer Sets the center frequency to the frequency difference between the two markers in Delta, Delta Pair or Span Pair marker. Front Panel <n> is 1, 2, 3 or 4. Sending :CALCulate:MARKer<n>:MODE selects a marker type from Delta, Delta Pair or Span Pair. The command is invalid in Zero-span mode.
16. :CALCulate:MARKer<n>:DELTa[:SET]:SPAN Syntax Function :CALCulate:MARKer<n>:DELTa[:SET]:SPAN Sets the analyzer span to the frequency difference between the two
2-11
RIGOL
markers in Delta, Delta Pair and Span Pair marker. Explanations Front Panel <n> is is 1, 2, 3 or 4. Sending :CALCulate:MARKer<n>:MODE selects a marker type from Delta, Delta Pair or Span Pair. The command is invalid in Zero-span mode.
17. :CALCulate:MARKer:FCOunt:RESolution Syntax Function :CALCulate:MARKer:FCOunt:RESolution <freq> :CALCulate:MARKer:FCOunt:RESolution? Sets the frequency counter resolution, the default unit is Hz, such as :CALC:MARK:FCO:RES 1000 or :CALC:MARK:FCO:RES 1KHZ The query returns 1000. Default Front Panel <freq> ranges from 1 Hz to 100 kHz (1Hz, 10Hz, 100Hz, 1kHz, 10kHz, 100kHz) Sending :CALCulate:MARKer:FCOunt:RESolution:AUTO can set the resolution mode to Auto.
Explanations
18. :CALCulate:MARKer:FCOunt:RESolution:AUTO Syntax Function :CALCulate:MARKer:FCOunt:RESolution:AUTO OFF|ON|0|1 :CALCulate:MARKer:FCOunt:RESolution:AUTO? Set the resolution mode of frequency counter to Auto in order to get a faster and accurately counting in connection with specified span. The query returns 0 or 1. ON|1 Marker Fctn, Freq Count, Resolution, Auto
19. :CALCulate:MARKer:FCOunt[:STATe] Syntax Function Explanations :CALCulate:MARKer:FCOunt[:STATe] OFF|ON|0|1 :CALCulate:MARKer:FCOunt[:STATe]? Turns on or off the frequency counter. The query returns 0 or 1. Sending :CALCulate:MARKer:FCOunt:X? queries the readout of the frequency counter.
2-12
RIGOL
The command will refers all activated markers on condition that the frequency counter is enabled.
20. :CALCulate:MARKer:FCOunt:X? Syntax Function Explanations :CALCulate:MARKer:FCOunt:X? The query returns the readout of the frequency counter, such as 1500335500, (in Hz). The query returns 9000000000000000 (9e15) when the frequency counter is disabled.
21. :CALCulate:MARKer<n>:FUNCtion Syntax Function Explanations :CALCulate:MARKer<n>:FUNCtion NDB|NOISe|OFF :CALCulate:MARKer<n>:FUNCtion? Selects a measurement type for the specified marker. The query returns NDB, NOIS or OFF. <n> is 1, 2, 3 or 4. NDB: N dB BW measurement. NOISe: Noise measurement. OFF: turns off all measurements.
22. :CALCulate:MARKer<n>:MAXimum:MAX Syntax Function Explanations Front Panel :CALCulate:MARKer<n>:MAXimum:MAX Executes a peak search according to the mode selected by :CALCulate:MARKer<n>:PEAK:SEARch:MODE. <n> is 1, 2, 3 or 4. Peak, Search Para, Peak Search, Max
23. :CALCulate:MARKer<n>:MAXimum:LEFT Syntax Function :CALCulate:MARKer<n>:MAXimum:LEFT Searches the nearest peak located to the left side of the current peak and meets the searching condition. The peak is then identified with a marker. <n> is 1, 2, 3 or 4.
2-13
Explanations
RIGOL
Front Panel
The peak which has a smaller frequency compared with 1% of span or the resolution bandwidth will be ignored. When no desired peak is found, the system will show No peak found.
24. :CALCulate:MARKer<n>:MAXimum:NEXT Syntax Function :CALCulate:MARKer<n>:MAXimum:NEXT Searches the peak whose amplitude is the closest to the current peaks and meets the searching condition. The peak is then identified with a marker Front Panel <n> is 1, 2, 3 or 4. The peak which has a smaller frequency compared with 1% of span or the resolution bandwidth will be ignored. When no desired peak is found, the system will show No peak found.
Explanations
25. :CALCulate:MARKer<n>:MAXimum:RIGHt Syntax Function :CALCulate:MARKer<n>:MAXimum:RIGHt Searches the nearest peak located to the right side of the current peak and meets the searching condition. The peak is then identified with a marker. Front Panel <n> is 1, 2, 3 or 4. The peak which has a smaller frequency compared with 1% of span or the resolution bandwidth will be ignored. When no desired peak is found, the system will show No peak found.
Explanations
26. :CALCulate:MARKer<n>:MINimum Syntax Function Explanations :CALCulate:MARKer<n>:MINimum Searches the peak with the minimum amplitude on the trace and identifies it with a marker. <n> is 1, 2, 3 or 4.
2-14
RIGOL
Front Panel
The peak which has a smaller frequency compared with 1% of span or the resolution bandwidth will be ignored. When no desired peak is found, the system will show No peak found.
27. :CALCulate:MARKer<n>:MODE Syntax Function :CALCulate:MARKer<n>:MODE POSition|DELTa|BAND|SPAN :CALCulate:MARKer<n>:MODE? Sets the mode of the selected marker. Queries the specified marker mode and returns POS, DELT, BAND or SPAN. <n> is 1, 2, 3 or 4. POSition: Normal DELTa: Delta BAND: Delta Pair SPAN: Span Pair
Explanations
28. :CALCulate:MARKer<n>:PEAK:EXCursion Syntax Function :CALCulate:MARKer<n>:PEAK:EXCursion <rel_ampl> :CALCulate:MARKer<n>:PEAK:EXCursion? Sets the excursion between the specified peak and the minimum amplitude on both sides of it in dB, such as :CALC:MARK1:PEAK:EXC 12 The query returns 1.200000E+01. <n> is 1, 2, 3 or 4. <rel_ampl> ranges from 0 to 200 dB.
29. :CALCulate:MARKer<n>:PEAK:SEARch:MODE Syntax :CALCulate:MARKer<n>:PEAK:SEARch:MODE PARameter|MAXimum :CALCulate:MARKer<n>:PEAK:SEARch:MODE? Sets the mode of Peak Search.
Function
2-15
RIGOL
The query returns PAR or MAX. Explanations <n> is 1, 2, 3 or 4. PARameter: searches the peak that meets the condition of Search Para and identifies it with a marker. MAXimum: searches the miximum on the trace and identifies it with a marker. An error message may generate if no desired peak is found. The command has meaning only for the peak search which will be executed when pressing the Peak key on the front panel regardless of Next Peak, Peak Right, Peak Left and Min Search.
30. :CALCulate:MARKer<n>:PEAK[:SET]:CF Syntax Function Explanations Front Panel :CALCulate:MARKer<n>:PEAK[:SET]:CF Executes a peak search and sets the frequency of the current peak to the center frequency of the analyzer. <n> is 1, 2, 3 or 4. FREQ, Peak->CF
31. :CALCulate:MARKer<n>:PEAK:THReshold Syntax Function :CALCulate:MARKer<n>:PEAK:THReshold <ampl> :CALCulate:MARKer<n>:PEAK:THReshold? Sets the peak limit, the default unit is dBm, such as :CALC:MARK1:PEAK:THR -100 The query returns -1.000000E+02. <n> is 1, 2, 3 or 4. <ampl> ranges from -200 dBm to 0 dBm. A real peak should be greater than the peak limit.
Explanations
32. :CALCulate:MARKer<n>:PTPeak Syntax Function Explanations :CALCulate:MARKer<n>:PTPeak Executes the peak search. <n> is 1, 2, 3 or 4. Sending this command automatically changes the marker from
Programming Guide for DSA1000A series
2-16
RIGOL
33. :CALCulate:MARKer<n>[:SET]:CENTer Syntax Function Explanations :CALCulate:MARKer<n>[:SET]:CENTer Sets the center frequency based upon the curren marker frequency. Front Panel <n> is 1, 2, 3 or 4. In Normal marker mode, the center frequency is the frequency at which the marker is located. In Delta marker mode, the center frequency is the frequency at which the delta marker is located.
34. :CALCulate:MARKer<n>[:SET]:RLEVel Syntax Function Explanations :CALCulate:MARKer<n>[:SET]:RLEVel Sets the reference level of the analyzer according to the current marker amplitude. Front Panel <n> is 1, 2, 3 or 4. In Normal marker mode, the reference level is the amplitude at which the marker is located. In Delta marker mode, the reference level is the amplitude at which the delta marker is located.
35. :CALCulate:MARKer<n>[:SET]:STARt Syntax Function Explanations :CALCulate:MARKer<n>[:SET]:STARt Sets the start frequency of the analyzer according to the current marker frequency. Front Panel <n> is 1, 2, 3 or 4. In Normal marker mode, the start frequency is the frequency at which the marker is located. In Delta marker mode, the start frequency is the frequency at which the delta marker is located. The command is invalid in Zero-span mode.
36. :CALCulate:MARKer<n>[:SET]:STEP
Programming Guide for DSA1000A series 2-17
RIGOL
:CALCulate:MARKer<n>[:SET]:STEP Sets the center frequency step of the analyzer according to the current marker frequency. <n> is 1, 2, 3 or 4. In Normal marker mode, the center frequency is the frequency at which the marker is located. In Delta marker mode, the center frequency step is the frequency at which the delta marker is located. The command can also be used to get the information about the next harmonic when in harmonic measurement. The command is invalid in Zero-span mode.
Front Panel
37. :CALCulate:MARKer<n>[:SET]:STOP Syntax Function Explanations :CALCulate:MARKer<n>[:SET]:STOP Sets the stop frequency of the analyzer according to the current marker frequency. Front Panel <n> is 1, 2, 3 or 4. In Normal marker mode, the stop frequency is the frequency at which the marker is located. In Delta marker mode, the stop frequency is the frequency at which the delta marker is located. The command is invalid in Zero-span mode.
38. :CALCulate:MARKer<n>:STATe Syntax Function Explanations :CALCulate:MARKer<n>:STATe OFF|ON|0|1 :CALCulate:MARKer<n>:STATe? Turns on or off the selected marker. The query returns 0 or 1. <n> is 1, 2, 3 or 4. If there is no opened marker, turnning on a marker uses the POSition (Normal mode) as the default.
2-18
RIGOL
39. :CALCulate:MARKer:TABLe:STATe Syntax Function Default Front Panel :CALCulate:MARKer:TABLe:STATe OFF|ON|0|1 :CALCulate:MARKer:TABLe:STATe? Turns on or off the marker table. The query returns 0 or 1. OFF|0 Marker, Mkr Table, On/Off
40. :CALCulate:MARKer<n>:TRACe Syntax Function :CALCulate:MARKer<n>:TRACe <integer> :CALCulate:MARKer<n>:TRACe? Assigns a trace for the specified marker from Trace 1, Trace 2, Trace 3 or Trace 4 (math trace), such as :CALC:MARK1:TRAC 1 The query returns 1. Default Front Panel 1 Marker, Mkr Trace, 1/2/3/Math <n> is 1, 2, 3 or 4. <integer> is 1, 2, 3 or 4 (math trace). The trace specified here must be On. The query returns the trace number if the trace mode is Auto.
Explanations
41. :CALCulate:MARKer<n>:TRACe :AUTO Syntax Function Explanations :CALCulate:MARKer<n>:TRACe:AUTO OFF|ON|0|1 :CALCulate:MARKer<n>:TRACe:AUTO? Turns on or off the auto trace function for the specified marker. The query returns 0 or 1. <n> is 1, 2, 3 or 4. The current marker stands on the corresponding trace if Auto is disabled.
42. :CALCulate:MARKer:TRCKing[:STATe] Syntax Function :CALCulate:MARKer:TRCKing[:STATe] OFF|ON|0|1 :CALCulate:MARKer:TRCKing[:STATe]? Turns on or off the signal track function.
2-19
RIGOL
The query returns 0 or 1. Explanations When the signal track function is On, the analyzer executes a peak search, sets the current peak frequency to the center frequency after each sweep and holds the signal at the center of screen all the time. OFF|0 FREQ, Signal Track, State, On/Off
43. :CALCulate:MARKer<n>:X Syntax Function :CALCulate:MARKer<n>:X <param> :CALCulate:MARKer<n>:X? Sets the X-axis value at which the marker is located, the default unit is Hz, such as :CALC:MARK1:X 15000000 or :CALC:MARK1:X 1.5GHZ The query returns 15000000. <n> is 1, 2, 3 or 4. <param> is within the range of X: If current readout mode is Frequency, the range cannot exceed the sweep frequency and unit input of Hz (default), kHz, MHz or GHz is available. If current readout mode is time, the range cannot exceed the sweep time and unit input of s (default), us, ms or ks is available. In Normal marker mode, the command sets the X value at which the current marker is located. In Delta marker mode, the command sets the X value of the current delta marker according to the reference marker. In Delta Pair marker mode, the command sets the X value of the reference marker or the delta marker according to the current menu status. In Span Pair marker mode, the command sets the X value of the span between or center of the reference marker and delta marker according to the current menu status.
Explanations
Corresponds with the trace unit of the current marker. Marker, Normal Marker, Delta Marker, Delta Pair, Ref/Delta
2-20
RIGOL
Marker, Span Pair, Span/Center 44. :CALCulate:MARKer<n>:X:CENTer Syntax Function :CALCulate:MARKer<n>:X:CENTer <param> :CALCulate:MARKer<n>:X:CENTer? Sets the X value at the center of the reference marker and the delta marker in Span Pair marker mode, the default unit is Hz, such as :CALC:MARK1:X:CENT 405000000 or :CALC:MARK1:X:CENT 405MHZ The query returns 405000000. <n> is 1, 2, 3 or 4. <param> is within the range of X.
45. :CALCulate:MARKer<n>:X:POSition Syntax Function :CALCulate:MARKer<n>:X:POSition <integer> :CALCulate:MARKer<n>:X:POSition? Sets the position of the Normal marker on the trace, such as :CALC:MARK1:X:POSition 100 The query returns 100. <n> is 1, 2, 3 or 4. For the range of <integer>, refer to [:SENSe]:SWEep:POINts.
Explanations
46. :CALCulate:MARKer<n>:X:POSition:CENTer Syntax Function :CALCulate:MARKer<n>:X:POSition:CENTer <param> :CALCulate:MARKer<n>:X:POSition:CENTer? Sets the position of the center frequency of Span Pair marker on the trace, such as :CALC:MARK1:X:POS:CENTer 200 The query returns 200. <n> is 1, 2, 3 or 4. For the range of <param>, refer to [:SENSe]:SWEep:POINts.
Explanations
47. :CALCulate:MARKer<n>:X:POSition:SPAN Syntax Function :CALCulate:MARKer<n>:X:POSition:SPAN <param> :CALCulate:MARKer<n>:X:POSition:SPAN? Sets the number of points on the trace. The trace is limited by the
2-21
RIGOL
reference marker and the delta marker in Span Pair marker mode. Such as :CALC:MARK1:X:POS:SPAN 150 The query returns 150. Explanations <n> is 1, 2, 3 or 4. For the range of <param>, refer to [:SENSe]:SWEep:POINts.
48. :CALCulate:MARKer<n>:X:POSition:STARt Syntax Function :CALCulate:MARKer<n>:X:POSition:STARt <param> :CALCulate:MARKer<n>:X:POSition:STARt? Sets the position of the reference marker on the related trace in Delta Pair marker mode, such as :CALC:MARK1:X:POS:STARt 10 The query returns 10. <n> is 1, 2, 3 or 4. For the range of <param>, refer to [:SENSe]:SWEep:POINts.
Explanations
49. :CALCulate:MARKer<n>:X:POSition:STOP Syntax Function :CALCulate:MARKer<n>:X:POSition:STOP <param> :CALCulate:MARKer<n>:X:POSition:STOP? Sets the position of the delta marker on the related trace in Delta Pair marker mode, such as :CALC:MARK1:X:POS:STOP 600 The query returns 600. <n> is 1, 2, 3 or 4. For the range of <param>, refer to [:SENSe]:SWEep:POINts.
Explanations
50. :CALCulate:MARKer<n>:X:READout Syntax :CALCulate:MARKer<n>:X:READout FREQuency|TIME|ITIMe|PERiod :CALCulate:MARKer<n>:X:READout? Sets the marker readout type on X-axis. The query returns FREQ, TIME, ITIM or PER. <n> is 1, 2, 3 or 4. FREQuency Marker, Readout, Frequency/Period/ Time/ 1/time
51. :CALCulate:MARKer<n>:X:SPAN
2-22
RIGOL
Syntax Function
:CALCulate:MARKer<n>:X:SPAN <param> :CALCulate:MARKer<n>:X:SPAN? Sets the X value of the marker span on the related trace in Span Pair marker mode. The unit of X value corresponds to the unit of the current marker trace. Such as :CALC:MARK1:X:SPAN 500000000 The query returns 500000000. <n> is 1, 2, 3 or 4. <param> is within the range of X. If current readout mode is Frequency, the range cannot exceed the sweep frequency and unit input of Hz (default), kHz, MHz or GHz is available. If current readout mode is time, the range cannot exceed the sweep time and unit input of s (default), us, ms or ks is available.
Explanations
Front Panel
52. :CALCulate:MARKer<n>:X:STARt Syntax Function :CALCulate:MARKer<n>:X:STARt <param> :CALCulate:MARKer<n>:X:STARt? Sets the X value of the reference marker on related trace in Delta Pair marker mode. The unit of X value corresponds to the unit of the current marker trace. Such as :CALC:MARK1:X:STARt 1320000000 The query returns 1320000000. <n> is 1, 2, 3 or 4. <param> is within the range of X. If current readout mode is Frequency, the range cannot exceed the sweep frequency and unit input of Hz (default), kHz, MHz or GHz is available. If current readout mode is time, the range cannot exceed the sweep time and unit input of s (default), us, ms or ks is available. Front Panel Marker, Delta Pair, Ref
Explanations
2-23
RIGOL
:CALCulate:MARKer<n>:X:STOP? Function Sets the X value of the delta marker on related trace in Delta Pair. The unit of the X value corresponds to the unit of the current marker trace. Such as :CALC:MARK1:X:STOP 1820000000 The query returns 1820000000. <n> is 1, 2, 3 or 4. <param> is within the range of X. If current readout mode is Frequency, the range cannot exceed the sweep frequency and unit input of Hz (default), kHz, MHz or GHz is available. If current readout mode is time, the range cannot exceed the sweep time and unit input of s (default), us, ms or ks is available. Front Panel Marker, Delta Pair, Delta
Explanations
54. :CALCulate:MARKer<n>:Y? Syntax Function :CALCulate:MARKer<n>:Y? The query returns the Y-axis readout of the specified marker, the default unit is dBm, such as -2.697830E-01.
55. :CALCulate:NTData[:STATe] Syntax Function Default :CALCulate:NTData[:STATe] OFF|ON|0|1 :CALCulate:NTData[:STATe]? Turns on or off the Normalization function. The query returns 0 or 1. OFF|0
2-24
RIGOL
:CALibration
:CALibration:[ALL] :CALibration:AUTO
1.
:CALibration:AUTO :CALibration:AUTO OFF|ON|0|1 :CALibration:AUTO? Enables or disables the Auto calibration. The query returns 0 or 1. ON|1 (NOTE: The Auto calibration is set to On as default and will always hold the setting before a power circle.) System, Calibrate, Self-Cal, On/Off
Front Panel
2-25
RIGOL
:CONFigure
:CONFigure:ACPower :CONFigure:CHPower :CONFigure:CNRatio :CONFigure:EBWidth :CONFigure:HDISt :CONFigure:OBWidth :CONFigure:PF :CONFigure:SANalyzer :CONFigure:TOI :CONFigure:TPOWer :CONFigure?
2-26
RIGOL
1.
:CONFigure:ACPower :CONFigure:ACPower Enables the Adjacent Channel Power measurement. The command first restores the system parameters to factory defaults. The command interrupts the current measurement and restores the analyzer to the defaults of specified measurement function. You can use READ command to initialize a measurement function without any further settings of Default.
Front Panel
2.
:CONFigure:CHPower :CONFigure:CHPower Enables the Channel Power measurement. The command first restores the system parameters to factory defaults. The command interrupts the current measurement and restores the analyzer to the defaults of specified measurement function. You can use READ command to initialize a measurement function without any further settings of Default.
Front Panel
3.
:CONFigure:CNRatio :CONFigure:CNRatio Enables the C/N Ratio measurement. The command first restores the system parameters to factory defaults. The command interrupts the current measurement and restores the analyzer to the defaults of specified measurement function. You can use READ command to initialize a measurement function without any further settings of Default.
Front Panel
Preset
2-27
RIGOL
Meas, Meas Fctn, C/N Ratio 4. :CONFigure:EBWidth :CONFigure:EBWidth Enables the Emission BandWidth measurement. The command first restores the system parameters to factory defaults. The command interrupts the current measurement and restores the analyzer to the defaults of specified measurement function. You can use READ command to initialize a measurement function without any further settings of Default.
Front Panel
5.
:CONFigure:HDISt :CONFigure:HDISt Enables the Harmonic Distortion measurement. The command first restores the system parameters to factory defaults. The command interrupts the current measurement and restores the analyzer to the defaults of specified measurement function. You can use READ command to initialize a measurement function without any further settings of Default.
Front Panel
6.
:CONFigure:OBWidth :CONFigure:OBWidth Enables the Occupied BandWidth measurement. The command first restores the system parameters to factory defaults. The command interrupts the current measurement and restores the analyzer to the defaults of specified measurement function. You can use READ command to initialize a measurement
2-28
RIGOL
function without any further settings of Default. Front Panel Preset Meas, Meas Fctn, OBW
7.
:CONFigure:PF :CONFigure:PF Enables the Pass/Fail measurement. The command first restores the system parameters to factory defaults. The command interrupts the current measurement and restores the analyzer to the defaults of specified measurement function. You can use READ command to initialize a measurement function without any further settings of Default.
Front Panel
8.
:CONFigure:SANalyzer :CONFigure:SANalyzer Disables the current measurement and enables the Sweep mode of the anlyzer. The command first restores the system parameters to factory defaults. The command interrupts the current measurement and restores the analyzer to the defaults of specified measurement function. You can use READ command to initialize a measurement function without any further settings of Default.
Front Panel
9.
:CONFigure:TOI :CONFigure:TOI Enables the Third Order Intermodulation measurement. The command first restores the system parameters to factory defaults. The command interrupts the current measurement and
2-29
RIGOL
Front Panel
restores the analyzer to the defaults of specified measurement function. You can use READ command to initialize a measurement function without any further settings of Default.
10. :CONFigure:TPOWer Syntax Function Explanations :CONFigure:TPOWer Enables the Time-domain Power measurement. The command first restores the system parameters to factory defaults. The command interrupts the current measurement and restores the analyzer to the defaults of specified measurement function. You can use READ command to initialize a measurement function without any further settings of Default.
Front Panel
11. :CONFigure? Syntax Function Return Value :CONFigure? Queries the current measurement. The query returns OFF, TPOW, ACP, CHP, OBW, EBW, CNR, HD, TOI or PF.
2-30
RIGOL
:COUPle
1. :COUPle :COUPle :COUPle ALL|NONE :COUPle? Sets all related parameters on the basis of their own coupling relation. The query returns ALL or NONE. Following parameters are involved: CF Step Attenuator RBW (Resolution BandWidth) VBW (Video BandWidth) Sweep Time ALL System, Coupl Param
Syntax Function
Explanations
2-31
RIGOL
:DISPlay
:DISPlay:AFUnction:POSition :DISPlay:ANNotation:CLOCk :DISPlay:BRIGtness :DISPlay:ENABle :DISPlay:MENU:STATe :DISPlay:MENU:HTIMe :DISPlay:MSGswitch:STATe :DISPlay:SKIN :DISPlay:SSAVer:TIME :DISPlay:WINdow:TRACe:GRATicule:GRID :DISPlay:WINdow:TRACe:Y:DLINe :DISPlay:WINdow:TRACe:Y:DLINe:STATe :DISPlay:WINdow:TRACe:Y:SCALe:PDIVision :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFFSet :DISPlay:WINdow:TRACe:Y:SCALe:SPACing :DISPlay:WINdow:TRACe:Y:SCALe:NRLevel :DISPlay:WINdow:TRACe:Y:SCALe:NRPosition
2-32
RIGOL
1.
:DISPlay:AFUnction:POSition :DISPlay:AFUnction:POSition BOTTom|CENTer|TOP :DISPlay:AFUnction:POSition? Sets the position of active function area. The query returns BOTT, CENT or TOP. This setting is persistent even throuth a power cycle. TOP Display, Active Fctn, Top/Center/Bottom
:DISPlay:ANNotation:CLOCk :DISPlay:ANNotation:CLOCk[:STATe] OFF|ON|0|1 :DISPlay:ANNotation:CLOCk[:STATe]? Sets the clock status. The query returns 0 or 1. This setting is persistent even throuth a power cycle. ON|1 System, Time/Date, Time/Date, On/Off
:DISPlay:BRIGtness :DISPlay:BRIGtness <integer> :DISPlay:BRIGtness? Sets the screen brightness, such as :DISP:BRIG 6 The query returns 6. <integer> ranges from 0 to 7. 6 Display, Brightness
Syntax Function
:DISPlay:ENABle :DISPlay:ENABle OFF|ON|0|1 :DISPlay:ENABle? Enables or disables the screen display. The refresh will be stopped when screen display is disabled, pressing ESC to unlock. The query returns 0 or 1. ON|1 Display, Scr State, On/Off
Syntax Function
2-33
RIGOL
5.
:DISPlay:MENU:STATe :DISPlay:MENU:STATe OFF|ON|0|1 :DISPlay:MENU:STATe? Turns on or off the menu hold function. The query returns 0 or 1. ON|1
:DISPlay:MENU:HTIMe :DISPlay:MENU:HTIMe 3s|5s|10s|20s|INFinite :DISPlay:MENU:HTIMe? Sets the menu hold time. The query returns 3S, 5S, 10S, 20S or INF. INFinite Display, Menu Hold, 3s/5s/10s/20s/Infinite
:DISPlay:MSGswitch:STATe :DISPlay:MSGswitch:STATe OFF|ON|0|1 :DISPlay:MSGswitch:STATe? Enabls or disables the message display. The query returns 0 or 1. ON|1 Display, Msg Switch, On/Off
:DISPlay:SKIN :DISPlay:SKIN CLASsic|MODErn :DISPlay:SKIN? Specifies the screen skin. The query returns CLAS or MODE. CLASsic Display, Skin, Classic/Modern
:DISPlay:SSAVer:TIME :DISPlay:SSAVer:TIME 1m|15m|30m|1h|OFF :DISPlay:SSAVer:TIME? Sets the screen saver duration. The query returns 1M, 15M, 30M, 1H or OFF. OFF
Programming Guide for DSA1000A series
RIGOL
Front Panel
10. :DISPlay:WINdow:TRACe:GRATicule:GRID Syntax Function :DISPlay:WINdow:TRACe:GRATicule:GRID <integer> :DISPlay:WINdow:TRACe:GRATicule:GRID? Sets the grid brightness, such as :DISP:WIN:TRAC:GRAT:GRID 6 The query returns 6. <integer> ranges from 0 to 10. 5 Display, Graticule
11. :DISPlay:WINdow:TRACe:Y:DLINe Syntax Function :DISPlay:WINdow:TRACe:Y:DLINe <ampl> :DISPlay:WINdow:TRACe:Y:DLINe? Sets the screen display line, the default unit is dBm, such as :DISP:WIN:TRAC:Y:DLIN -10 The query returns -1.000000E+01. <ampl> ranges from -100 dBm to 30 dBm. 0 dBm Display, Display Line
12. :DISPlay:WINdow:TRACe:Y:DLINe:STATe Syntax Function Default Front Panel :DISPlay:WINdow:TRACe:Y:DLINe:STATe OFF|ON|0|1 :DISPlay:WINdow:TRACe:Y:DLINe:STATe? Enables or disables the display line. The query returns 0 or 1. OFF|0 Display, Display Line, On/Off
13. :DISPlay:WINdow:TRACe:Y:SCALe:PDIVision Syntax Function :DISPlay:WINdow:TRACe:Y:SCALe:PDIVision <rel_ampl> :DISPlay:WINdow:TRACe:Y:SCALe:PDIVision? Specifies the scale magnitude of Y-axis, such as :DISP:WIN:TRAC:Y:SCAL:PDIV 10 The query returns 1.000000E+01. <rel_ampl> ranges from 0.1 dB to 20.0 dB.
2-35
Explanations
RIGOL
10 dB AMPT, Scale/Div
14. :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel Syntax Function :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel <ampl> :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel? Sets the reference level, such as :DISP:WIN:TRAC:Y:SCAL:RLEV -10 The query returns -1.000000E+01. <ampl> ranges from -100 dBm to 30 dBm. The command may have an influence on the attenuator.
15. :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFFSet Syntax Function :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFFSet <rel_ampl> :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFFSet? Sets the reference level offset, such as :DISP:WIN:TRAC:Y:SCAL:RLEV:OFFS 10 The query returns 1.000000E+01. -300 dB to 300 dB 0 dB AMPT, Ref Offset
16. :DISPlay:WINdow:TRACe:Y:SCALe:SPACing Syntax Function Default Front Panel :DISPlay:WINdow:TRACe:Y:SCALe:SPACing LINear|LOGarithmic :DISPlay:WINdow:TRACe:Y:SCALe:SPACing? Sets the scale type. The query returns LIN or LOG. LOGarithmic AMPT, Scale Type, Log/Lin
17. :DISPlay:WINdow:TRACe:Y:SCALe:NRLevel Syntax Function :DISPlay:WINdow:TRACe:Y:SCALe:NRLevel <rel_ampl> :DISPlay:WINdow:TRACe:Y:SCALe:NRLevel? Sets the reference level of the normalization, such as :DISP:WIN:TRAC:Y:SCAL:NRL -20
Programming Guide for DSA1000A series
2-36
RIGOL
The query returns -2.000000E+01. Explanations Default Front Panel <rel_ampl> ranges from -200 dBm to 200 dBm. 0 dBm Source, Normalize, Norm Ref Lvl
18. :DISPlay:WINdow:TRACe:Y:SCALe:NRPosition Syntax Function :DISPlay:WINdow:TRACe:Y:SCALe:NRPosition <integer> :DISPlay:WINdow:TRACe:Y:SCALe:NRPosition? Sets the reference position of the normalization, such as :DISP:WIN:TRAC:Y:SCAL:NRP 50 The query returns 5.000000E+01. <integer> ranges from 0 to 100. 100 Source, Normalize, Norm Ref Pos
2-37
RIGOL
:FETCh
:FETCh:ACPower? :FETCh:ACPower:LOWer? :FETCh:ACPower:UPPer? :FETCh:ACPower:MAIN? :FETCh:CHPower? :FETCh:CHPower:CHPower? :FETCh:CHPower:DENSity? :FETCh:CNRatio? :FETCh:CNRatio:CARRier? :FETCh:CNRatio:CNRatio? :FETCh:CNRatio:NOISe? :FETCh:EBWidth? :FETCh:HARMonics:AMPLitude:ALL? :FETCh:HARMonics:AMPLitude? <n> :FETCh:HARMonics[:DISTortion]? :FETCh:HARMonics:FREQuency:ALL? :FETCh:HARMonics:FREQuency? <n> :FETCh:HARMonics:FUNDamental? :FETCh:OBWidth? :FETCh:OBWidth:OBWidth? :FETCh:OBWidth:OBWidth:FERRor? :FETCh:TOIntercept? :FETCh:TOIntercept:IP3? :FETCh:TPOWer?
2-38
RIGOL
1.
:FETCh:ACPower? :FETCh:ACPower? The query returns 5 values at comma intervals: Main channel power Upper channel power, Power difference between upper and main channel (dBc) Lower channel power, Power difference between lower and main channel (dBc) The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Syntax Function
Explanations
Return Value
2.
:FETCh:ACPower:LOWer? :FETCh:ACPower:LOWer? The query returns the lower channel power. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value 3.
Such as -5.142665E+01
:FETCh:ACPower:UPPer? :FETCh:ACPower:UPPer? The query returns upper channel power. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value 4.
Such as -5.173441E+01
:FETCh:ACPower:MAIN? :FETCh:ACPower:MAIN?
Syntax
2-39
RIGOL
Function Explanations
The query returns the main channel power. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value 5.
Such as -5.150423E+01
:FETCh:CHPower? :FETCh:CHPower? The query returns 2 values at comma intervals: channel power and power spectral density. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value 6.
Such as -1.599480E+01,-7.900511E+01
:FETCh:CHPower:CHPower? :FETCh:CHPower:CHPower? The query returns the channel power. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value 7.
Such as -1.599480E+01
:FETCh:CHPower:DENSity? :FETCh:CHPower:DENSity? The query returns the channel power spectral density. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value 8.
Such as -7.900511E+01
:FETCh:CNRatio? :FETCh:CNRatio?
Programming Guide for DSA1000A series
Syntax
2-40
RIGOL
Function Explanations
The query returns 3 values at comma intervals: carrier power, noise power and carrier-to-noise ratio (dB). The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value 9.
Such as -6.048788E+01,-6.186192E+01,1.374039E+00
:FETCh:CNRatio:CARRier? :FETCh:CNRatio:CARRier? The query returns the carrier power. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value
Such as -1.484203E+01
10. :FETCh:CNRatio:CNRatio? Syntax Function Explanations Return Value :FETCh:CNRatio:CNRatio? The query returns the C/N Ratio in dB. The command transmits the data from the latest measurement to the ouput buffer. Such as 8.956909E-02
11. :FETCh:CNRatio:NOISe? Syntax Function Explanations :FETCh:CNRatio:NOISe? The query returns the noise power. Return Value The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Such as -1.442294E+01
12. :FETCh:EBWidth? Syntax Function :FETCh:EBWidth? The query returns the measurement result of emission bandwidth in Hz.
2-41
RIGOL
The command transmits the data from the latest measurement to the ouput buffer. Such as 50000
13. :FETCh:HARMonics:AMPLitude:ALL? Syntax Function Explanations :FETCh:HARMonics:AMPLitude:ALL? The query returns the amplitude value of the first ten harmonics at comma intervals and in the same unit of the current amplitude. Return Value If there are less than ten harmonics to measrure, the query returns nothing for those unmeasured harmonics. The unit of the returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
14. :FETCh:HARMonics:AMPLitude? <n> Syntax Function Explanations :FETCh:HARMonics:AMPLitude? <n> The query returns the specified harmonic amplitude, such as :FETC:HARM:AMPL? 1 <n> is an integer wthin 1 and 10. The unit of the returned value is the same as the unit of Y-axis. The query returns --- if the harmonic to be read has no data. The command transmits the data from the latest measurement to the ouput buffer.
Return Value
Such as -1.692102E+01
15. :FETCh:HARMonics[:DISTortion]? Syntax Function Explanations Return Value :FETCh:HARMonics[:DISTortion]? The query returns the percentage of THD (total harmonic distortion). The command transmits the data from the latest measurement to the ouput buffer. Such as 2.490393E+02
2-42
RIGOL
16. :FETCh:HARMonics:FREQuency:ALL? Syntax Function Explanations :FETCh:HARMonics:FREQuency:ALL? The query returns the frequency of 10 harmonics at comma intervals in Hz. The first harmonic is the fundamental wave. Return Value The command returns 0 for those unmeasured harmonics if less than 10 harmonics to measrure. The command transmits the data from the latest measurement to the ouput buffer.
17. :FETCh:HARMonics:FREQuency? <n> Syntax Function Explanations :FETCh:HARMonics:FREQuency? <n> Queries the frequency of specified harmonic in Hz, such as :FETC:HARM:FREQ? 1 <n> is an integer wthin 1 and 10. The query returns --- if the harmonic to be read has no data. The command transmits the data from the latest measurement to the ouput buffer.
Return Value
Such as 45500000
18. :FETCh:HARMonics:FUNDamental? Syntax Function Explanations :FETCh:HARMonics:FUNDamental? The query returns the fundamental wave freuqncy in Hz. Return Value The commands is the same as :FETCh:HARMonics:FREQuency? 1 The command transmits the data from the latest measurement to the ouput buffer.
Such as 45500000
19. :FETCh:OBWidth? Syntax Function Explanations Return Value :FETCh:OBWidth? The query returns 2 values at comma intervals: Occupied BandWidth (Hz) and Transmit Freq Error (Hz). The command transmits the data from the latest measurement to the ouput buffer. Such as 1860000,40000
2-43
RIGOL
20. :FETCh:OBWidth:OBWidth? Syntax Function Explanations Return Value :FETCh:OBWidth:OBWidth? The query returns the bandwidth of the carrier signal in Hz. The command transmits the data from the latest measurement to the ouput buffer. Such as 1860000
21. :FETCh:OBWidth:OBWidth:FERRor? Syntax Function Explanations Return Value :FETCh:OBWidth:OBWidth:FERRor? The query returns the frequency transmission error in Hz. The command transmits the data from the latest measurement to the ouput buffer. Such as 40000
22. :FETCh:TOIntercept? Syntax Function :FETCh:TOIntercept? The query returns the following values at comma intervals: Frequency of Base Lower (Hz), Amplitude Frequency of Base Upper (Hz), Amplitude Frequency of 3rd Order Lower (Hz), Amplitude and Intercept of TOI Frequency of 3rd Order Upper (Hz), Amplitude and Intercept of TOI Return Value The amplitude unit of the returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Explanations
:FETCh:TOIntercept:IP3? The query returns the smaller TOI intercept between the 3rd Order Lower and the 3rd Order Upper. The command transmits the data from the latest measurement to
Programming Guide for DSA1000A series
RIGOL
24. :FETCh:TPOWer? Syntax Function Explanations :FETCh:TPOWer? The query returns the Time-domain Power measurement result. The unit of the returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value
Such as -1.658941E+01
2-45
RIGOL
:FORMat
:FORMat:BORDer :FORMat[:TRACe][:DATA]
1.
:FORMat:BORDer :FORMat:BORDer NORMal|SWAPped :FORMat:BORDer? Specifies the transmission order of the binary data. The query returns NORM or SWAP. NORMal
:FORMat[:TRACe][:DATA] :FORMat[:TRACe][:DATA] ASCii|REAL[,32] :FORMat[:TRACe][:DATA]? Specifies the input/output format of a trace data. The query returns ASCII or REAL,32. ASCii
2-46
RIGOL
:HCOPy
:HCOPy:ABORt :HCOPy:IMAGe:COLor[:STATe] :HCOPy:IMAGe:INVert :HCOPy:IMAGe:PTIMe :HCOPy:IMAGe:QUALity :HCOPy:IMAGe:FTYPe :HCOPy[:IMMediate] :HCOPy:PAGE:ORIentation :HCOPy:PAGE:PRINts :HCOPy:PAGE:SIZE :HCOPy:RESume
2-47
RIGOL
1.
:HCOPy:IMAGe:COLor[:STATe] :HCOPy:IMAGe:COLor[:STATe] OFF|ON|0|1 :HCOPy:IMAGe:COLor[:STATe]? Sets the print color to Grey (OFF|0) or Color (ON|1). The query returns 0 or 1. This setting is persistent even throuth a power cycle. OFF|0 (Grey) Print Setup, Palette, Gray/Color
:HCOPy:IMAGe:INVert :HCOPy:IMAGe:INVert OFF|ON|0|1 :HCOPy:IMAGe:INVert? Sets if to use inverse print. The query returns 0 or 1. OFF|0 Print Setup, Inverted, On/Off
:HCOPy:IMAGe:PTIMe :HCOPy:IMAGe:PTIMe OFF|ON|0|1 :HCOPy:IMAGe:PTIMe? Sets if to print with date. The query returns 0 or 1. OFF|0 Print Setup, Date Prints, On/Off
:HCOPy:IMAGe:QUALity :HCOPy:IMAGe:QUALity DEFault|NORMal|DRAFt|FINE :HCOPy:IMAGe:QUALity? Specifies the print quality. The query returns DEF, NORM, DRAF or FINE. DEFault (depends on the printer being used) Print Setup, Qualities, Default/Normal/Draft/Fine
Programming Guide for DSA1000A series
RIGOL
6.
:HCOPy:IMAGe:FTYPe :HCOPy:IMAGe:FTYPe DEFault|EXIFjpeg :HCOPy:IMAGe:FTYPe? Specifies the image type you want to print. The query returns DEF or EXIF. DEFault (depends on the printer being used) Print Setup, File Type, Default or Exif/JPEG
:HCOPy:PAGE:ORIentation :HCOPy:PAGE:ORIentation LANDscape|PORTrait :HCOPy:PAGE:ORIentation? Specifies the paper orientation you want to print. The query returns LAND or PORT. LANDscape Print Setup, Orientation, Portr/Portr
:HCOPy:PAGE:PRINts :HCOPy:PAGE:PRINts <integer> :HCOPy:PAGE:PRINts? Specifies the number of copies you want to print, such as :HCOP:PAGE:PRIN 10 The query returns 10. 1 Print Setup, Copies <integer> ranges from 1 to 999. This setting is persistent even throuth a power cycle.
Syntax Function
10. :HCOPy:PAGE:SIZE Syntax Function :HCOPy:PAGE:SIZE DEFault|A4|A5|A6|B5 :HCOPy:PAGE:SIZE? Selects a page size from Default, A4, A5, A6 or B5.
2-49
RIGOL
The query returns DEF, A4, A5, A6 or B5. Default Front Panel DEFault (depends on the printer being used) Print Setup, Page Size, Default/A4/A5/A6/B5
11. :HCOPy:RESume Syntax Function Front Panel :HCOPy:RESume Resumes the suspended print job. Print Setup, Resume
2-50
RIGOL
:INITiate
:INITiate:CONTinuous :INITiate[:IMMediate] :INITiate:PAUSe :INITiate:RESTart :INITiate:RESume
2-51
RIGOL
1.
:INITiate:CONTinuous :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Selects Continue (ON|1) or Single (OFF|0) sweep when measurement is not in progress. Selects Continue (ON|1) or Single (OFF|0) measurement when measurement is in progress. The query returns 0 or 1. ON|1 Sweep, Mode, Single/Cont Meas, Meas Fctn, any Meas Fctn, Meas Mode, Single/Cont
Syntax Function
2.
:INITiate[:IMMediate] :INITiate[:IMMediate] Initalizes a sweep when measurement is not in progress. Triggers a measurement when measurement is in progress. The analyzer must be in Single measurement mode. The command will be ignored if ON is specified by command :INITiate:CONTinuous. Sending :FETCh? command transimits measurement results from the internal memory to the output buffer.
Front Panel 3.
Single
:INITiate:PAUSe :INITiate:PAUSe Switches the instrument from Wait For Trigger to Pause. The command is valid only when a measurement is open. Meas, Off
:INITiate:RESTart :INITiate:RESTart Restarts the current measurement in Idle state. The command is valid only when a measurement is open. Meas, Restart
:INITiate:RESume :INITiate:RESume
Programming Guide for DSA1000A series
Syntax
2-52
RIGOL
Switches the instrument from Pause to Wait For Trigger. The command is valid only when a measurement is open. Meas, Resume
2-53
RIGOL
:INPut
:INPut:IMPedance
1.
:INPut:IMPedance :INPut:IMPedance 50|75 :INPut:IMPedance? Sets the input impedance for voltage-to-power conversions. To measure a 75 device, you should use a 75 to 50 adapter supplied by RIGOL to connect the analyzer with the system under test and then set the correspongding menu on the front panel to 75. 50 AMPT, Input, 50/75
2-54
RIGOL
:MMEMory
:MMEMory:DELete :MMEMory:DISK:FORMat :MMEMory:DISK:INFormation? :MMEMory:MOVE :MMEMory:LOAD:LIMit :MMEMory:LOAD:MTABle :MMEMory:LOAD:CORRection :MMEMory:LOAD:STATe :MMEMory:LOAD:TRACe :MMEMory:LOAD:SETUp :MMEMory:STORe:CORRection :MMEMory:STORe:SCReen :MMEMory:STORe:STATe :MMEMory:STORe:TRACe :MMEMory:STORe:SETUp :MMEMory:STORe:RESults :MMEMory:STORe:MTABle :MMEMory:STORe:PTABle :MMEMory:STORe:LIMit
2-55
RIGOL
1.
:MMEMory:DISK:FORMat :MMEMory:DISK:FORMat Formats the local disk. Storage, Disk Mgr, Format (D:)
:MMEMory:DISK:INFormation? :MMEMory:DISK:INFormation? The query returns the current disk name, disk type, file system, used space and total capacity. Storage, Disk Mgr, Disk Info
:MMEMory:MOVE :MMEMory:MOVE <file_name1>,<file_name2> Renames the file that specified by <file_name1> to <file_name2>. <file_name1> and <file_name2> must contain a valid path. The command is invalid if the file you specify does not exist.
:MMEMory:LOAD:LIMit :MMEMory:LOAD:LIMit <file_name> Loads the edited limit line file (.lim) into the analyzer. <file_name> must contain a valid path. The command is invalid if the file you specify does not exist.
:MMEMory:LOAD:MTABle :MMEMory:LOAD:MTABle <file_name> Loads the stored marker file (.mkr or .csv) into the analyzer. <file_name> must contain a valid path. The command is invalid if the file you specify does not exist.
Syntax
2-56
RIGOL
Deletes the specified file. <file_name> must contain a valid path. The command is invalid if the file you specify does not exist.
:MMEMory:LOAD:CORRection :MMEMory:LOAD:CORRection ANTenna|CABLe|OTHer|USER,<file_name> Loads the data from specified file (.cbl) to make an amplitude correction. <file_name> must contain a valid path. The command is invalid if the file you specify does not exist.
:MMEMory:LOAD:STATe :MMEMory:LOAD:STATe 1,<file_name> Loads the specified status file (.sta) into the analyzer. <file_name> must contain a valid path. The command is invalid if the file you specify does not exist.
:MMEMory:LOAD:TRACe :MMEMory:LOAD:TRACe <file_name> Loads the specified file (.trc) into the trace. <file_name> must contain a valid path. The command is invalid if the file you specify does not exist.
10. :MMEMory:LOAD:SETUp Syntax Function Explanations :MMEMory:LOAD:SETUp <file_name> Loads the specified setting file (.set). <file_name> must contain a valid path. The command is invalid if the file you specify does not exist.
2-57
RIGOL
11. :MMEMory:STORe:CORRection Syntax Function Explanations Example Front Panel :MMEMory:STORe:CORRection ANTenna|CABLe|OTHer|USER,<file_name> Saves the amplitude corrections with a specified file name (.cbl). <file_name> must contain a valid path. If the file name specified already exists, it will be overwritten.
12. :MMEMory:STORe:SCReen Syntax Function Explanations Example Front Panel :MMEMory:STORe:SCReen <file_name> Saves the current screen into the local disk or a USB flash device with a specified file name (.bmp). <file_name> must contain a valid path. If the file name specified already exists, it will be overwritten.
13. :MMEMory:STORe:STATe Syntax Function Explanations :MMEMory:STORe:STATe 1,<file_name> Saves the current status into the internal memory of the anlyzer with specified file name (.sta). <file_name> must contain a valid path. If the file name specified already exists, it will be overwritten. This file can only be read by the analyzer.
14. :MMEMory:STORe:TRACe Syntax Function Explanations :MMEMory:STORe:TRACe <label>,<file_name> Specifies the trace with a specified file name (.trc). <file_name> must contain a valid path. <label> can be: TRACE1|TRACE2|TRACE3|ALL. If the file name specified already exists, it will be overwritten.
Programming Guide for DSA1000A series
2-58
RIGOL
15. :MMEMory:STORe:SETUp Syntax Function Explanations Example Front Panel :MMEMory:STORe:SETUp <file_name> Saves the current settings by specified file (.set). <file_name> must contain a valid path. If the file name specified already exists, it will be overwritten.
16. :MMEMory:STORe:RESults Syntax Function Explanations Example Front Panel :MMEMory:STORe:RESults <file_name> Saves the current measurement results into a USB flash device with a specified file name (.csv). <file_name> must contain a valid path. If the file name specified already exists, it will be overwritten.
17. :MMEMory:STORe:MTABle Syntax Function Explanations Example Front Panel :MMEMory:STORe:MTABle <file_name> Saves the marker table into a USB flash device with a specified file name (.csv). <file_name> must contain a valid path. If the file name specified already exists, it will be overwritten.
18. :MMEMory:STORe:PTABle Syntax Function Explanations Example :MMEMory:STORe:PTABle <file_name> Saves the peak table into a USB flash device with a specified file name (.csv). <file_name> must contain a valid path. If the file name specified already exists, it will be overwritten.
:MMEM:STOR:PTAB E:\peaktable.csv
2-59
RIGOL
Front Panel
19. :MMEMory:STORe:LIMit Syntax Function Explanations Example :MMEMory:STORe:LIMit <file_name> Saves the current edited limit line with a specified file name (.trc or .csv). <file_name> must contain a valid path. If the file name specified already exists, it will be overwritten.
:MMEM:STOR:LIM E:\limit.csv
2-60
RIGOL
:OUTPut
:OUTPut[:STATe]
1.
:OUTPut[:STATe] :OUTPut[:STATe] OFF|ON|0|1 :OUTPut[:STATe]? Enables or disables the tracking generator output. The query returns 0 or 1. OFF|0 Source, TG, On/Off
2-61
RIGOL
:READ
In the command system, both Read and Fetch command can be used to get measurement results. The difference is that a Fetch command can get measurement results immediately and a Read command always starts a measurement and then read the results. :READ:ACPower? :READ:ACPower:LOWer? :READ:ACPower:UPPer? :READ:ACPower:MAIN? :READ:CHPower? :READ:CHPower:CHPower? :READ:CHPower:DENSity? :READ:CNRatio? :READ:CNRatio:CARRier? :READ:CNRatio:CNRatio? :READ:CNRatio:NOISe? :READ:EBWidth? :READ:HARMonics:AMPLitude:ALL? :READ:HARMonics:AMPLitude? <n> :READ:HARMonics[:DISTortion]? :READ:HARMonics:FREQuency:ALL? :READ:HARMonics:FREQuency? <n> :READ:HARMonics:FUNDamental? :READ:OBWidth? :READ:OBWidth:OBWidth? :READ:OBWidth:OBWidth:FERRor? :READ:TOIntercept? :READ:TOIntercept:IP3? :READ:TPOWer?
2-62
RIGOL
1.
:READ:ACPower? :READ:ACPower? The command executes a measurement and returns 5 values at comma intervals: Main channel power Upper channel power, Power difference between upper and main channel (dBc) Lower channel power, Power difference between lower and main channel (dBc) The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Syntax Function
Explanations
Return Value
2.
:READ:ACPower:LOWer? :READ:ACPower:LOWer? The command executes a measurement and returns the lower channel power. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value 3.
Such as -5.142665E+01
:READ:ACPower:UPPer? :READ:ACPower:UPPer? The command executes a measurement and returns the upper channel power. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value
Such as -5.173441E+01
2-63
RIGOL
4.
:READ:ACPower:MAIN? :READ:ACPower:MAIN? The command executes a measurement and returns the main channel power. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value 5.
Such as -5.150423E+01
:READ:CHPower? :READ:CHPower? The command executes a measurement and returns 2 values at comma intervals: the channel power and the power spectral density. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Syntax Function
Explanations
Return Value 6.
Such as -1.599480E+01,-7.900511E+01
:READ:CHPower:CHPower? :READ:CHPower:CHPower? The command executes a measurement and returns the channel power. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value 7.
Such as -1.599480E+01
:READ:CHPower:DENSity? :READ:CHPower:DENSity? The command executes a measurement and returns the power spectral density. The power unit of returned value is the same as the unit of
Programming Guide for DSA1000A series
RIGOL
Return Value 8.
Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Such as -7.900511E+01
:READ:CNRatio? :READ:CNRatio? The command executes a measurement and returns 3 values at comma intervals: the carrier power, the noise power and carrier-to-noise ratio (dB). The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Syntax Function
Explanations
Return Value 9.
Such as -6.048788E+01,-6.186192E+01,1.374039E+00
:READ:CNRatio:CARRier? :READ:CNRatio:CARRier? The command executes a measurement and returns the carrier power. The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Return Value
Such as -1.484203E+01
10. :READ:CNRatio:CNRatio? Syntax Function Explanations Return Value :READ:CNRatio:CNRatio? The command executes a measurement and returns the noise ratio in dB. The command transmits the data from the latest measurement to the ouput buffer. Such as 8.956909E-02
11. :READ:CNRatio:NOISe? Syntax Function :READ:CNRatio:NOISe? The command executes a measurement and returns the noise
2-65
RIGOL
power. Explanations Return Value The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Such as -1.442294E+01
12. :READ:EBWidth? Syntax Function Explanations Return Value :READ:EBWidth? The command executes a measurement and returns the measurement result of emission bandwidth in Hz. The command transmits the data from the latest measurement to the ouput buffer. Such as 50000
13. :READ:HARMonics:AMPLitude:ALL? Syntax Function :READ:HARMonics:AMPLitude:ALL? The command executes a measurement and returns the amplitude value of the first ten harmonics at comma intervals and having the same unit as the current amplitude. Return Value If there are less than ten harmonics to measrure, the query returns nothing for those unmeasured harmonics. The unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Explanations
14. :READ:HARMonics:AMPLitude? <n> Syntax Function :READ:HARMonics:AMPLitude? <n> The command executes a measurement and returns the specified harmonic amplitude, such as :READ:HARM:AMPL? 1 <n> is an integer wthin 1 and 10. The unit of returned value is the same as the unit of Y-axis.
Explanations
2-66
RIGOL
Return Value
The query returns --- if the harmonic to be read has no data. The command transmits the data from the latest measurement to the ouput buffer.
Such as -1.692102E+01
15. :READ:HARMonics[:DISTortion]? Syntax Function Explanations Return Value :READ:HARMonics[:DISTortion]? The command executes a measurement and returns the percentage of THD (total harmonic distortion). The command transmits the data from the latest measurement to the ouput buffer. Such as 2.490393E+02
16. :READ:HARMonics:FREQuency:ALL? Syntax Function :READ:HARMonics:FREQuency:ALL? The command executes a measurement and returns the first ten harmonic frequency values at comma intervals and in Hz. The first harmonic is the fundamental wave. Return Value The command returns 0 for those unmeasured harmonics if less than 10 harmonics to measrure. The command transmits the data from the latest measurement to the ouput buffer.
Explanations
17. :READ:HARMonics:FREQuency? <n> Syntax Function :READ:HARMonics:FREQuency? <n> The command executes a measurement and returns the specified harmonic frequency in Hz, such as :READ:HARM:FREQ? 1 <n> is an integer wthin 1 and 10. The query returns --- if the harmonic to be read has no data. The command transmits the data from the latest measurement to the ouput buffer.
Explanations
Return Value
Such as 45500000
18. :READ:HARMonics:FUNDamental?
Programming Guide for DSA1000A series 2-67
RIGOL
:READ:HARMonics:FUNDamental? The command executes a measurement and returns the fundamental wave frequency in Hz. The command is the same as :READ:HARMonics:FREQuency? 1 The command transmits the data from the latest measurement to the ouput buffer.
Return Value
Such as 45500000
19. :READ:OBWidth? Syntax Function :READ:OBWidth? The command executes a measurement and returns 2 values at comma intervals: the occupied bandwidth (Hz) and the ransmit frequency error (Hz). The command transmits the data from the latest measurement to the ouput buffer. Such as 1860000,40000
20. :READ:OBWidth:OBWidth? Syntax Function Explanations Return Value :READ:OBWidth:OBWidth? The command executes a measurement and returns the carrier signal bandwidth in Hz. The command transmits the data from the latest measurement to the ouput buffer. Such as 1860000
21. :READ:OBWidth:OBWidth:FERRor? Syntax Function Explanations Return Value :READ:OBWidth:OBWidth:FERRor? The command executes a measurement and returns the transmit frequency error in Hz. The command transmits the data from the latest measurement to the ouput buffer. Such as 40000
RIGOL
values at comma intervals: Frequency of Base Lower (Hz), Amplitude Frequency of Base Upper (Hz), Amplitude Frequency of 3rd Order Lower (Hz), Amplitude and Intercept of TOI Frequency of 3rd Order Upper (Hz), Amplitude and Intercept of TOI Explanations Return Value The amplitude unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
23. :READ:TOIntercept:IP3? Syntax Function :READ:TOIntercept:IP3? The command executes a measurement and returns the smaller of the TOI intercept between the 3rd Order Lower and the 3rd Order Upper. The command transmits the data from the latest measurement to the ouput buffer. Such as -8.131735E+01
24. :READ:TPOWer? Syntax Function Explanations :READ:TPOWer? The command executes a measurement and returns the Time-domain power measurement result. Return Value The power unit of returned value is the same as the unit of Y-axis. The command transmits the data from the latest measurement to the ouput buffer.
Such as -1.658941E+01
2-69
RIGOL
[:SENSe]
2-70
[:SENSe]:BANDwidth:RESolution [:SENSe]:BANDwidth:RESolution:AUTO [:SENSe]:BANDwidth:VIDeo [:SENSe]:BANDwidth:VIDeo:AUTO [:SENSe]:BANDwidth:VIDeo:RATio [:SENSe]:CORRection:CSET:ALL:DELete [:SENSe]:CORRection:CSET:ALL[:STATe] [:SENSe]:CORRection:CSET<n>:DATA [:SENSe]:CORRection:CSET<n>:DATA:MERGe [:SENSe]:CORRection:CSET<n>:DELete [:SENSe]:CORRection:CSET<n>:X:SPACing [:SENSe]:CORRection:CSET<n>[:STATe] [:SENSe]:CORRection:CSET:TABLe:STATe [:SENSe]:DEMod [:SENSe]:DEMod:STATe [:SENSe]:DEMod:TIME [:SENSe]:DETector[:FUNCtion] [:SENSe]:FREQuency:CENTer [:SENSe]:FREQuency:CENTer:SET:STEP [:SENSe]:FREQuency:CENTer:STEP:AUTO [:SENSe]:FREQuency:CENTer:STEP[:INCRement] [:SENSe]:FREQuency:CENTer:UP [:SENSe]:FREQuency:CENTer:DOWN [:SENSe]:FREQuency:SPAN [:SENSe]:FREQuency:SPAN:FULL [:SENSe]:FREQuency:SPAN:PREVious [:SENSe]:FREQuency:SPAN:ZIN [:SENSe]:FREQuency:SPAN:ZOUT [:SENSe]:FREQuency:STARt [:SENSe]:FREQuency:STOP [:SENSe]:POWer[:RF]:ATTenuation [:SENSe]:POWer[:RF]:ATTenuation:AUTO [:SENSe]:POWer[:RF]:GAIN[:STATe] [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer] [:SENSe]:POWer:ASCale
Programming Guide for DSA1000A series
RIGOL
[:SENSe]:POWer:ARANge [:SENSe]:POWer:ATUNe [:SENSe]:SWEep:POINts [:SENSe]:SWEep:COUNt [:SENSe]:SWEep:COUNt:CURRent? [:SENSe]:SWEep:TIME [:SENSe]:SWEep:TIME:AUTO [:SENSe]:SWEep:TIME:AUTO:RULes [:SENSe]:ACPower:AVERage:COUNt [:SENSe]:ACPower:AVERage[:STATe] [:SENSe]:ACPower:AVERage:TCONtrol [:SENSe]:ACPower:BANDwidth:INTegration [:SENSe]:ACPower:BANDwidth:ACHannel [:SENSe]:ACPower:CSPacing [:SENSe]:CHPower:AVERage:COUNt [:SENSe]:CHPower:AVERage[:STATe] [:SENSe]:CHPower:AVERage:TCONtrol [:SENSe]:CHPower:BANDwidth:INTegration [:SENSe]:CHPower:FREQuency:SPAN [:SENSe]:CNRatio:AVERage:COUNt [:SENSe]:CNRatio:AVERage[:STATe] [:SENSe]:CNRatio:AVERage:TCONtrol [:SENSe]:CNRatio:BANDwidth:INTegration [:SENSe]:CNRatio:BANDwidth:NOISe [:SENSe]:CNRatio:OFFSet [:SENSe]:EBWidth:AVERage:COUNt [:SENSe]:EBWidth:AVERage[:STATe] [:SENSe]:EBWidth:AVERage:TCONtrol [:SENSe]:EBWidth:MAXHold:STATe [:SENSe]:EBWidth:FREQuency:SPAN [:SENSe]:EBWidth:XDB [:SENSe]:HDISt:AVERage:COUNt [:SENSe]:HDISt:AVERage[:STATe] [:SENSe]:HDISt:AVERage:TCONtrol [:SENSe]:HDISt:NUMBers [:SENSe]:HDISt:TIME [:SENSe]:HDISt:TIME:AUTO[:STATe] [:SENSe]:OBWidth:AVERage:COUNt
2-71
RIGOL
[:SENSe]:OBWidth:AVERage [:STATe] [:SENSe]:OBWidth:AVERage:TCONtrol [:SENSe]:OBWidth:MAXHold:STATe [:SENSe]:OBWidth:FREQuency:SPAN [:SENSe]:OBWidth:PERCent [:SENSe]:ROSCillator:SOURce [:SENSe]:STATus:ANALyzer? [:SENSe]:STATus:CORRections? [:SENSe]:STATus:DEMod? [:SENSe]:STATus:POWer? [:SENSe]:STATus:TG? [:SENSe]:TOI:AVERage:COUNt [:SENSe]:TOI:AVERage[:STATe] [:SENSe]:TOI:AVERage:TCONtrol [:SENSe]:TOI:FREQuency:SPAN [:SENSe]:TPOWer:AVERage:COUNt [:SENSe]:TPOWer:AVERage[:STATe] [:SENSe]:TPOWer:AVERage:TCONtrol [:SENSe]:TPOWer:MODE [:SENSe]:TPOWer:LLIMit [:SENSe]:TPOWer:RLIMit
2-72
RIGOL
1.
[:SENSe]:BANDwidth:RESolution [:SENSe]:BANDwidth:RESolution <freq> [:SENSe]:BANDwidth:RESolution? Sets the resolution bandwidth, the default unit is Hz, such as :BAND:RES 1000 or :BAND:RES 1KHZ The query returns 1000. <freq> ranges from 10 Hz to 1 MHz. 1 MHz BW, RBW
Syntax Function
[:SENSe]:BANDwidth:RESolution:AUTO [:SENSe]:BANDwidth:RESolution:AUTO OFF|ON|0|1 [:SENSe]:BANDwidth:RESolution:AUTO? Enables or disables the Auto function of Resolution bandwidth. The query returns 0 or 1. In Auto mode, the resolution bandwidth decreases with the decreasing span. The Auto function is invalid in Zero-span mode.
[:SENSe]:BANDwidth:VIDeo [:SENSe]:BANDwidth:VIDeo <freq> [:SENSe]:BANDwidth:VIDeo? Sets the video bandwidth, the default unit is Hz, such as :BAND:VID 1000 or :BAND:VID 1KHZ The query returns 1000. <freq> ranges from 1 Hz to 3 MHz. 1 MHz BW, VBW
Syntax Function
[:SENSe]:BANDwidth:VIDeo:AUTO [:SENSe]:BANDwidth:VIDeo:AUTO OFF|ON|0|1 [:SENSe]:BANDwidth:VIDeo:AUTO? Enables or disables the Auto function of Video bandwidth. The query returns 0 or 1. ON|1
2-73
RIGOL
Front Panel 5.
[:SENSe]:BANDwidth:VIDeo:RATio [:SENSe]:BANDwidth:VIDeo:RATio <number> [:SENSe]:BANDwidth:VIDeo:RATio? Sets the ratio of VBW to RBW, such as :BAND:VID:RAT 0.01 The query returns 1.000000E-02. <number> ranges from 0.000001 to 300000. 1 BW, V/R Ratio
Syntax Function
[:SENSe]:CORRection:CSET:ALL:DELete [:SENSe]:CORRection:CSET:ALL:DELete Deletes all amplitude correction data. AMPT, Corrections, Delete
[:SENSe]:CORRection:CSET:ALL[:STATe] [:SENSe]:CORRection:CSET:ALL[:STATe] OFF|ON|0|1 [:SENSe]:CORRection:CSET:ALL[:STATe]? Enables or disables the amplitude correction function. Only the opened correction factors can be enabled when the correction function is On. All correction factors are disabled when the correction function is Off. The query returns 0 or 1. To turn on or off a single correction factor, see command below: [:SENSe]:CORRection:CSET<n>[:STATe] OFF|0 AMPT, Corrections, Select, Off/Antenna/Cable/Other/User
Syntax Function
[:SENSe]:CORRection:CSET<n>:DATA [:SENSe]:CORRection:CSET<n>:DATA <freq>,<rel_ampl>{,<freq>,<rel_ampl>} [:SENSe]:CORRection:CSET<n>:DATA? Creates an amplitude correction curve on the basis of current data, such as :CORR:CSET1:DATA 900E6,0.3,1.0E9,0.35,1.3E9,0.2
Programming Guide for DSA1000A series
Syntax
Function
2-74
RIGOL
The query returns 900000000,0.300000,1000000000,0.350000, 1300000000,0.200000. Explanations <n> is 1 (Antenna), 2 (Cable), 3 (Other) or 4 (User). <freq> is related to the current analyzer model, the unit is Hz. <rel_ampl> ranges from -120 dB to 100 dB. The editable numbers of points range from 1 to 200.
Front Panel
9.
[:SENSe]:CORRection:CSET<n>:DATA:MERGe [:SENSe]:CORRection:CSET<n>:DATA:MERGe <freq>,<rel_ampl>{,<freq>,<rel_ampl>} Adds new correction data upon the current correction curve. For detailed parameter information, please refer to [:SENSe]:CORRection:CSET<n>:DATA.
10. [:SENSe]:CORRection:CSET<n>:DELete Syntax Function Explanations Front Panel [:SENSe]:CORRection:CSET<n>:DELete Deletes the correction settings. <n> is 1 (Antenna), 2 (Cable), 3 (Other) or 4 (User). AMPT, Corrections, Select, Off/Antenna/Cable/Other/User, Delete
11. [:SENSe]:CORRection:CSET<n>:X:SPACing Syntax Function Explanations [:SENSe]:CORRection:CSET<n>:X:SPACing LINear|LOGarithmic [:SENSe]:CORRection:CSET<n>:X:SPACing? Sets the amplitude correction mode to Lin or Log. Default Front Panel <n> is 1 (Antenna), 2 (Cable), 3 (Other) or 4 (User). In Lin mode, the frequency uses linear and the amplitude uses logarithm as the unit to make an interpolation operation. In Log mode, both the frequency and amplitude use logarithm as the unit to make an interpolation operation.
RIGOL
[:SENSe]:CORRection:CSET<n>[:STATe]? Function Explanations Default Front Panel Truns on or off the specified amplitude correction. The query returns 0 or 1. <n> is 1 (Antenna), 2 (Cable), 3 (Other) or 4 (User). OFF|0 AMPT, Corrections, Select, Antenna/Cable/Other/User, Correction, On/Off
13. [:SENSe]:CORRection:CSET:TABLe:STATe Syntax Function Default Front Panel [:SENSe]:CORRection:CSET:TABLe:STATe OFF|ON|0|1 [:SENSe]:CORRection:CSET:TABLe:STATe? Turns on or off the correction table. The query returns 0 or 1. OFF|0 AMPT, Corrections, Corr Table, On/Off
14. [:SENSe]:DEMod Syntax Function Front Panel [:SENSe]:DEMod AM|FM|OFF [:SENSe]:DEMod? Sets the demodulation type. The query returns AM, FM or OFF. Demod, Demod, AM/FM
15. [:SENSe]:DEMod:STATe Syntax Function Default Front Panel [:SENSe]:DEMod:STATe OFF|ON|0|1 [:SENSe]:DEMod:STATe? Turns on or off the demodulation. The query returns 0 or 1. OFF|0 Demod, Demod, AM/FM/Off
16. [:SENSe]:DEMod:TIME Syntax Function [:SENSe]:DEMod:TIME <time> [:SENSe]:DEMod:TIME? Sets the demodulating time, the default unit is s, such as DEM:TIME 0.5 or DEM:TIME 500ms The query returns 5.000000E-01.
Programming Guide for DSA1000A series
2-76
RIGOL
<time> ranges from 5 ms to 1000000 s. 100 ms Demod, Demod, AM/FM, Demod Setup, Demod Time
17. [:SENSe]:DETector[:FUNCtion] Syntax [:SENSe]:DETector[:FUNCtion] NEGative|NORMal|POSitive|RMS|SAMPle|VAVerage [:SENSe]:DETector[:FUNCtion]? Sets the detection type. The query returns NEG, NORM, POS, RMS, SAMP or VAV. POSitive Detector, Pos Peak/Neg Peak/Sample/Normal/RMS Avg/Voltage Avg
18. [:SENSe]:FREQuency:CENTer Syntax Function [:SENSe]:FREQuency:CENTer <freq> [:SENSe]:FREQuency:CENTer? Sets the center frequency, the default unit is Hz, such as :FREQ:CENT 1000000 or :FREQ:CENT 1MHZ The query returns 1000000. <freq> ranges from 0 Hz to 3 GHz. 1.5 GHz FREQ, Center Freq
19. [:SENSe]:FREQuency:CENTer:SET:STEP Syntax Function Front Panel [:SENSe]:FREQuency:CENTer:SET:STEP Sets the current center frequency step to the center frequency. FREQ, CF->Step
20. [:SENSe]:FREQuency:CENTer:STEP:AUTO Syntax Function Default Front Panel [:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1 [:SENSe]:FREQuency:CENTer:STEP:AUTO? Enables or disables the Auto function of CF step. The query returns 0 or 1. ON|1 FREQ, CF Step, Auto/Manual
21. [:SENSe]:FREQuency:CENTer:STEP[:INCRement]
Programming Guide for DSA1000A series 2-77
RIGOL
Syntax Function
[:SENSe]:FREQuency:CENTer:STEP[:INCRement] <freq> [:SENSe]:FREQuency:CENTer:STEP[:INCRement]? Sets the CF step, the default unit is Hz, such as :FREQ:CENT:STEP 100000 or :FREQ:CENT:STEP 100KHZ The query returns 100000. <freq> ranges from 1Hz to 3GHz. Span/10 FREQ, CF Step
22. [:SENSe]:FREQuency:CENTer:UP Syntax Function Front Panel [:SENSe]:FREQuency:CENTer:UP Increases the center frequency by the specified CF step. FREQ, Channel, Forward
23. [:SENSe]:FREQuency:CENTer:DOWN Syntax Function Front Panel [:SENSe]:FREQuency:CENTer:DOWN Decreases the center frequency by the specified CF step. FREQ, Channel, Reverse
24. [:SENSe]:FREQuency:SPAN Syntax Function [:SENSe]:FREQuency:SPAN <freq> [:SENSe]:FREQuency:SPAN? Sets the span, the default unit is Hz, such as :FREQ:SPAN 20000000 or :FREQ:SPAN 20MHZ The query returns 200000000. <freq> ranges from 0 Hz to 3 GHz. When the span is set to 0, the analyzer goes into the Zero-span mode, the X-axis changes from Frequency into Time and only the signal that has the same freqeuency as the center frequency would be displayed.
Explanations
RIGOL
26. [:SENSe]:FREQuency:SPAN:PREVious Syntax Function Front Panel [:SENSe]:FREQuency:SPAN:PREVious Recalls the last span setting. SPAN, Last Span
27. [:SENSe]:FREQuency:SPAN:ZIN Syntax Function Front Panel [:SENSe]:FREQuency:SPAN:ZIN Sets the span to the half of its current value. SPAN, Zoom In
28. [:SENSe]:FREQuency:SPAN:ZOUT Syntax Function Front Panel [:SENSe]:FREQuency:SPAN:ZOUT Sets the span to twice the current value. SPAN, Zoom Out
29. [:SENSe]:FREQuency:STARt Syntax Function [:SENSe]:FREQuency:STARt <freq> [:SENSe]:FREQuency:STARt? Sets the start frequency, the default unit is Hz, such as :FREQ:STAR 10000 or :FREQ:STAR 10KHZ The query returns 10000. <freq> ranges from 0 Hz to 3 GHz. 0 Hz FREQ, Start Freq
30. [:SENSe]:FREQuency:STOP Syntax Function [:SENSe]:FREQuency:STOP <freq> [:SENSe]:FREQuency:STOP? Sets the stop frequency, the default unit is Hz, such as :FREQ:STOP 100000000 or :FREQ:STOP 100MHZ The query returns 100000000. <freq> ranges from 0 Hz to 3 GHz. 3 GHz FREQ, Stop Freq
31. [:SENSe]:POWer[:RF]:ATTenuation
Programming Guide for DSA1000A series 2-79
RIGOL
Syntax Function
[:SENSe]:POWer[:RF]:ATTenuation <rel_ampl> [:SENSe]:POWer[:RF]:ATTenuation? Sets the attenuator of the front RF in dB, such as :POW:ATT 20 The query returns 20. <rel_ampl> ranges from 0 dB to 50 dB. 10 dB AMPT, Input Atten
32. [:SENSe]:POWer[:RF]:ATTenuation:AUTO Syntax Function Default Front Panel [:SENSe]:POWer[:RF]:ATTenuation:AUTO OFF|ON|0|1 [:SENSe]:POWer[:RF]:ATTenuation:AUTO? Enables or disables the Auto function of the attenuator. The query returns 0 or 1. ON|1 AMPT, Input Atten, Auto/Manual
33. [:SENSe]:POWer[:RF]:GAIN[:STATe] Syntax Function Default Front Panel [:SENSe]:POWer[:RF]:GAIN[:STATe] OFF|ON|0|1 [:SENSe]:POWer[:RF]:GAIN[:STATe]? Turns on or off the preamplifier. The query returns 0 or 1. OFF|0 AMPT, RF Preamp, On/Off
34. [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer] Syntax Function [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer] <ampl> [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer]? Sets the maximim power of the input mixer, the default unit is dBm, such as :POW:MIX:RANG -20 The query returns -2.000000E+01. <ampl> ranges from -50 dBm to 0 dBm. -10 dBm AMPT, MaxMixL
35. [:SENSe]:POWer:ASCale
2-80 Programming Guide for DSA1000A series
RIGOL
[:SENSe]:POWer:ASCale Adjusts the reference level and the scale automatically. AMPT, Auto Scale
36. [:SENSe]:POWer:ARANge Syntax Function Front Panel [:SENSe]:POWer:ARANge Adjusts the parameters related to the amplitude within the current span range in order to make signal easier to observe. AMPT, Auto Range
37. [:SENSe]:POWer:ATUNe Syntax Function Front Panel [:SENSe]:POWer:ATUNe Searches signals within full range and adjusts the analyzer to the best frequency and amplitude for displaying these signals. Auto Tune
38. [:SENSe]:SWEep:POINts Syntax Function [:SENSe]:SWEep:POINts <number of points> [:SENSe]:SWEep:POINts? Sets the points obtained in each sweep, such as :SWE:POIN 1000 The query returns 1000. <number of points> ranges from 101 to 3001. The sweep points will automatically change to the maximum (3001) and can not be modified by user in Video trigger type (See :TRIGger:SEQuence:SOURce).
Explanations
39. [:SENSe]:SWEep:COUNt Syntax Function [:SENSe]:SWEep:COUNt <integer> [:SENSe]:SWEep:COUNt? Specifies the numbers of sweeps in Single sweep mode, such as :SWE:COUN 10 The query returns 10. <integer> ranges from 1 to 9999. 1
2-81
Explanations Default
RIGOL
Front Panel
Sweep, Numbers
40. [:SENSe]:SWEep:COUNt:CURRent? Syntax Function [:SENSe]:SWEep:COUNt:CURRent? The query returns the current number of sweeps in Single sweep mode, such as 8.
41. [:SENSe]:SWEep:TIME Syntax Function [:SENSe]:SWEep:TIME <time> [:SENSe]:SWEep:TIME? Sets the sweep time of the analyzer within specified span range, the default unit is s, such as :SWEep:TIME 0.1 The query returns 1.000000E-01. <time> ranges from 20 us to 3000 s. 10 ms Sweep, Time
42. [:SENSe]:SWEep:TIME:AUTO Syntax Function Default Front Panel [:SENSe]:SWEep:TIME:AUTO OFF|ON|0|1 [:SENSe]:SWEep:TIME:AUTO? Turns on or off the Auto function of the sweep time. The query returns 0 or 1. ON|1 Sweep, Time, Auto/Manual
43. [:SENSe]:SWEep:TIME:AUTO:RULes Syntax Function Default Front Panel :SENSe:SWEep:TIME:AUTO:RULes NORMal|ACCuracy :SENSe:SWEep:TIME:AUTO:RULes? Sets the auto mode of the sweep time. The query returns NORM or ACC. NORMal Sweep, Auto SWT
2-82
RIGOL
Function
Specifies the number of averages of the adjacent channel power measurement results, such as :ACP:AVER:COUN 100 The query returns 100. <integer> ranges from 1 to 1000. 10 Meas, ACP Meas Setup, Avg Num
45. [:SENSe]:ACPower:AVERage[:STATe] Syntax Function [:SENSe]:ACPower:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:ACPower:AVERage[:STATe]? Turns on or off the Average function of the adjacent channel power measurement. The query returns 0 or 1. OFF|0 Meas, ACP Meas Setup, Avg Num, On/Off
46. [:SENSe]:ACPower:AVERage:TCONtrol Syntax Function Explanations [:SENSe]:ACPower:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:ACPower:AVERage:TCONtrol? Sets the average mode of the adjacent channel power measurement. The query returns EXP or REP. In Exp mode, the result is from the exponent average calculation of the current N (specified by [:SENSe]:ACPower:AVERage:COUNt) measurements. In REP mode, the result is the arithmetic average of the current N (specified by [:SENSe]:ACPower:AVERage:COUNt) measurements.
2-83
RIGOL
Function
Sets the bandwidth of the main channels, the default unit is Hz, such as :ACP:BAND:INT 1000000 or :ACP:BAND:INT 1MHZ The query returns 1000000. <freq> ranges from 33 Hz to 1 GHz. 2 MHz Meas, ACP Meas Setup, Main CH BW
48. [:SENSe]:ACPower:BANDwidth:ACHannel Syntax Function [:SENSe]:ACPower:BANDwidth:ACHannel <freq> [:SENSe]:ACPower:BANDwidth:ACHannel? Sets the bandwidth of the adjacent channel, the default unit is Hz, such as :ACP:BAND:ACH 1000000 or :ACP:BAND:ACH 1MHZ The query returns 1000000. <freq> ranges from 33 Hz to 1 GHz. 2 MHz Meas, ACP Meas Setup, Adj CH BW
49. [:SENSe]:ACPower:CSPacing Syntax Function [:SENSe]:ACPower:CSPacing <freq> [:SENSe]:ACPower:CSPacing? Sets the center frequency difference between the main and adjacent channels, the default unit is Hz, such as :ACP:BAND:CSP 1000000 or :ACP:BAND:CSP 1MHZ The query returns 1000000. <freq> ranges from 33 Hz to 1 GHz. 2 MHz Meas, ACP Meas Setup, CH Spacing
50. [:SENSe]:CHPower:AVERage:COUNt Syntax Function [:SENSe]:CHPower:AVERage:COUNt <integer> [:SENSe]:CHPower:AVERage:COUNt? Sets the number of averages of the channel power measurement
Programming Guide for DSA1000A series
2-84
RIGOL
results, such as :CHP:AVER:COUN 100 The query returns 100. Explanations Default Front Panel <integer> ranges from 1 to 1000. 10 Meas, Chan Pwr Meas Setup, Avg Num
51. [:SENSe]:CHPower:AVERage[:STATe] Syntax Function [:SENSe]:CHPower:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:CHPower:AVERage[:STATe]? Turns on or off the average function of the channel power measurement. The query returns 0 or 1. OFF|0 Meas, Chan Pwr Meas Setup, Avg Num, On/Off
52. [:SENSe]:CHPower:AVERage:TCONtrol Syntax Function Explanations [:SENSe]:CHPower:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:CHPower:AVERage:TCONtrol? Sets the average mode of the channel power measurement. The query returns EXP or REP. In Exp mode, the result is from the exponent average calculation of the current N (specified by [:SENSe]:CHPower:AVERage:COUNt measurements. In REP mode, the result is the arithmetic average of the current N (specified by [:SENSe]:CHPower:AVERage:COUNt) measurements.
53. [:SENSe]:CHPower:BANDwidth:INTegration Syntax Function [:SENSe]:CHPower:BANDwidth:INTegration <freq> [:SENSe]:CHPower:BANDwidth:INTegration? Sets the integration bandwidth for the channel power measurement,
2-85
RIGOL
the default unit is Hz, such as :CHP:BAND:INT 1000000 or :CHP:BAND:INT 1MHZ The query returns 1000000. Explanations Default Front Panel <freq> ranges from 100 Hz to 3 GHz. 2 MHz Meas, Chan Pwr Meas Setup, Integ BW
54. [:SENSe]:CHPower:FREQuency:SPAN Syntax Function [:SENSe]:CHPower:FREQuency:SPAN <freq> [:SENSe]:CHPower:FREQuency:SPAN? Sets the channel span for the channel power measurement, the default unit is Hz, such as :CHP:FREQ:SPAN 3000000 or :CHP:FREQ:SPAN 3MHZ The query returns 3000000. <freq> ranges from 100 Hz to 3 GHz. 3 MHz Meas, Chan Pwr Meas Setup, CH Pwr Span
55. [:SENSe]:CNRatio:AVERage:COUNt Syntax Function [:SENSe]:CNRatio:AVERage:COUNt <integer> [:SENSe]:CNRatio:AVERage:COUNt? Sets the number of averages rof the C/N Ratio measurement results, such as :CNR:AVER:COUN 100 The query returns 100. <integer> ranges from 1 to 1000. 10 Meas, C/N Ratio Meas Setup, Avg Num
56. [:SENSe]:CNRatio:AVERage[:STATe] Syntax Function [:SENSe]:CNRatio:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:CNRatio:AVERage[:STATe]? Turns on or off the average function of the C/N Ratio measurement. The query returns 0 or 1.
Programming Guide for DSA1000A series
2-86
RIGOL
57. [:SENSe]:CNRatio:AVERage:TCONtrol Syntax Function Explanations [:SENSe]:CNRatio:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:CNRatio:AVERage:TCONtrol? Sets the average mode of the C/N Ratio measurement. The query returns EXP or REP. In Exp mode, the result is from the exponent average calculation of the current N (specified by [:SENSe]:CNRatio:AVERage:COUNt) measurements. In REP mode, the result is the arithmetic average of the current N (specified by [:SENSe]:CNRatio:AVERage:COUNt) measurements.
58. [:SENSe]:CNRatio:BANDwidth:INTegration Syntax Function [:SENSe]:CNRatio:BANDwidth:INTegration <freq> [:SENSe]:CNRatio:BANDwidth:INTegration? Sets the carrier bandwidth, the default unit is Hz, such as :CNR:BAND:INT 1000000 or :CNR:BAND:INT 1MHZ The query returns 1000000. <freq> ranges from 33 Hz to 1 GHz. 2 MHz Meas, C/N Ratio Meas Setup, Carrier BW
59. [:SENSe]:CNRatio:BANDwidth:NOISe Syntax Function [:SENSe]:CNRatio:BANDwidth:NOISe <freq> [:SENSe]:CNRatio:BANDwidth:NOISe? Sets the noise bandwidth, the default unit is Hz, such as :CNR:BAND:NOIS 1000000 or :CNR:BAND:NOIS 1MHZ The query returns 1000000. <freq> ranges from 33 Hz to 1 GHz. 2 MHz
2-87
Explanations Default
RIGOL
Front Panel
60. [:SENSe]:CNRatio:OFFSet Syntax Function [:SENSe]:CNRatio:OFFSet <freq> [:SENSe]:CNRatio:OFFSet? Sets the center frequency offset between the carrier and noise, the default unit is Hz, such as :CNR:OFFS 1000000 or :CNR:OFFS 1MHZ The query returns 1000000. <freq> ranges from 33 Hz to 1 GHz. 2 MHz Meas, C/N Ratio Meas Setup, Offset Freq
61. [:SENSe]:EBWidth:AVERage:COUNt Syntax Function [:SENSe]:EBWidth:AVERage:COUNt <integer> [:SENSe]:EBWidth:AVERage:COUNt? Sets the number of averages of the Emission Bandwidth measurement results, such as :EBW:AVER:COUN 100 The query returns 100. <integer> ranges from 1 to 1000. 10 Meas, EBW Meas Setup, Avg Num
62. [:SENSe]:EBWidth:AVERage[:STATe] Syntax Function [:SENSe]:EBWidth:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:EBWidth:AVERage[:STATe]? Turns on or off the average function of the Emission Bandwidth measurement. The query returns 0 or 1. OFF|0 Meas, EBW Meas Setup, Avg Num, On/Off
63. [:SENSe]:EBWidth:AVERage:TCONtrol
2-88 Programming Guide for DSA1000A series
RIGOL
[:SENSe]:EBWidth:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:EBWidth:AVERage:TCONtrol? Sets the average mode of the Emission Bandwidth measurement. The query returns EXP or REP. In Exp mode, the result is from the exponent average calculation of the current N (specified by [:SENSe]:EBWidth:AVERage:COUNt) measurements. In REP mode, the result is the arithmetic average of the current N (specified by [:SENSe]:EBWidth:AVERage:COUNt) measurements. EXPonential
64. [:SENSe]:EBWidth:MAXHold:STATe Syntax Function Default Front Panel [:SENSe]:EBWidth:MAXHold:STATe OFF|ON|0|1 [:SENSe]:EBWidth:MAXHold:STATe? Turns on or off the Max Hold function. The query returns 0 or 1. OFF|0 Meas, EBW Meas Setup, Max Hold, On/Off
65. [:SENSe]:EBWidth:FREQuency:SPAN Syntax Function [:SENSe]:EBWidth:FREQuency:SPAN <freq> [:SENSe]:EBWidth:FREQuency:SPAN? Sets the span of the Emission Bandwidth measurement, the default unit is Hz, such as :EBW:FREQ:SPAN 1000000 or :EBW:FREQ:SPAN 1MHZ The query returns 1000000. <freq> ranges from 100 Hz to 3 GHz. 2 MHz Meas, EBW Meas Setup, Span
2-89
RIGOL
Function
Sets the value of X dB to calculate the emission bandwidth, such as :EBWidth:XDB -20 The query returns -2.000000E+01. <real_amp> ranges from -100 dB to -0.1 dB. -10 dB Meas, EBW Meas Setup, X dB
67. [:SENSe]:HDISt:AVERage:COUNt Syntax Function [:SENSe]:HDISt:AVERage:COUNt <integer> [:SENSe]:HDISt:AVERage:COUNt? Sets the number of averages of the Harmonic Distortion measurement results, such as :HDIS:AVER:COUN 100 The query returns 100. <integer> ranges from 1 to 1000. 10 Meas, Harmo Dist Meas Setup, Avg Num
68. [:SENSe]:HDISt:AVERage[:STATe] Syntax Function [:SENSe]:HDISt:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:HDISt:AVERage[:STATe]? Turns on or off the average function of the Harmonic Distortion measurement. The query returns 0 or 1. OFF|0 Meas, Harmo Dist Meas Setup, Avg Num, On/Off
69. [:SENSe]:HDISt:AVERage:TCONtrol Syntax Function Explanations [:SENSe]:HDISt:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:HDISt:AVERage:TCONtrol? Sets the average mode of the Harmonic Distortion measurement. The query returns EXP or REP. In Exp mode, the result is from the exponent average calculation of the current N (specified by [:SENSe]:HDISt:AVERage:COUNt)
Programming Guide for DSA1000A series
2-90
RIGOL
measurements. In REP mode, the result is the arithmetic average of the current N (specified by [:SENSe]:HDISt:AVERage:COUNt) measurements. EXPonential
70. [:SENSe]:HDISt:NUMBers Syntax Function [:SENSe]:HDISt:NUMBers <integer> [:SENSe]:HDISt:NUMBers? Sets the number of harmonics for carrier measurement, such as :HDIS:NUMB 5 The query returns 5. <integer> ranges from 2 to 10. 10 Meas, Harmo Dist Meas Setup, NO.of Harmo
71. [:SENSe]:HDISt:TIME Syntax Function [:SENSe]:HDISt:TIME <time> [:SENSe]:HDISt:TIME? Sets the sweep time of the Harmonic measurement, the default unit is s, such as HDIS:TIME 0.01 The query returns 1.000000E-02. <time> ranges from 20 us to 3 ks. 10 ms Meas, Harmo Dist Meas Setup, Sweep Time
72. [:SENSe]:HDISt:TIME:AUTO[:STATe] Syntax Function [:SENSe]:HDISt:TIME:AUTO[:STATe] OFF|ON|0|1 [:SENSe]:HDISt:TIME:AUTO[:STATe]? Turns on or off the Auto function of sweep time for the harmonic measurement. The query returns 0 or 1. ON|1
2-91
Default
RIGOL
Front Panel
73. [:SENSe]:OBWidth:AVERage:COUNt Syntax Function [:SENSe]:OBWidth:AVERage:COUNt <integer> [:SENSe]:OBWidth:AVERage:COUNt? Sets the number of averages of the Occupied Bandwidth measurement results, such as :OBW:AVER:COUN 100 The query returns 100. <integer> ranges from 1 to 1000. 10 Meas, OBW Meas Setup, Avg Num
74. [:SENSe]:OBWidth:AVERage [:STATe] Syntax Function [:SENSe]:OBWidth:AVERage [:STATe] OFF|ON|0|1 [:SENSe]:OBWidth:AVERage [:STATe]? Turns on or off the average function of the Occupied Bandwidth measurement. The query returns 0 or 1. OFF|0 Meas, OBW Meas Setup, Avg Num, On/Off
75. [:SENSe]:OBWidth:AVERage:TCONtrol Syntax Function Explanations [:SENSe]:OBWidth:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:OBWidth:AVERage:TCONtrol? Sets the average mode of the Occupied Bandwidth measurement. The query returns EXP or REP. In Exp mode, the result is from the exponent average calculation of the current N (specified by [:SENSe]:OBWidth:AVERage:COUNt) measurements. In REP mode, the result is the arithmetic average of the current N (specified by [:SENSe]:OBWidth:AVERage:COUNt) measurements. EXPonential
Default
2-92
RIGOL
Front Panel
76. [:SENSe]:OBWidth:MAXHold:STATe Syntax Function [:SENSe]:OBWidth:MAXHold:STATe OFF|ON|0|1 [:SENSe]:OBWidth:MAXHold:STATe? Turns on or off the Max Hold function of the Occupied Bandwidth measurement. The query returns 0 or 1. OFF|0 Meas, OBW Meas Setup, Max Hold, On/Off
77. [:SENSe]:OBWidth:FREQuency:SPAN Syntax Function [:SENSe]:OBWidth:FREQuency:SPAN <freq> [:SENSe]:OBWidth:FREQuency:SPAN? Sets the span of the Occupied Bandwidth measurement, the default unit is Hz, such as :OBW:FREQ:SPAN 1000000 or :OBW:FREQ:SPAN 1MHZ The query returns 1000000. <freq> ranges from 100 Hz to 3 GHz. 2MHz Meas, OBW Meas Setup, Span
78. [:SENSe]:OBWidth:PERCent Syntax Function [:SENSe]:OBWidth:PERCent <real> [:SENSe]:OBWidth:PERCent? Sets the percent of the signal power in the whole frequency span power, such as :OBW:PERC 90 The query returns 9.000000E+01. <real> ranges from 1 to 99.99. 99 (99%) Meas, OBW Meas Setup, Power Ratio
2-93
RIGOL
79. [:SENSe]:ROSCillator:SOURce Syntax Function Default Front Panel [:SENSe]:ROSCillator:SOURce INTernal|EXTernal [:SENSe]:ROSCillator:SOURce? Selects the internal or external reference source. The query returns INT or EXT. INTernal System, Ref Source, Int/Ext
80. [:SENSe]:STATus:ANALyzer? Syntax Function Front Panel [:SENSe]:STATus:ANALyzer? Quires the measurement settings of the analyzer. System, Status, Analyzer
81. [:SENSe]:STATus:CORRections? Syntax Function Front Panel [:SENSe]:STATus:CORRections? Quires the correction status. System, Status, Corrections
82. [:SENSe]:STATus:DEMod? Syntax Function Front Panel [:SENSe]:STATus:DEMod? Quires the setting status of the demodulation. System, Status, Demod
83. [:SENSe]:STATus:POWer? Syntax Function Front Panel [:SENSe]:STATus:POWer? Quires the setting status of the power measurement. System, Status, Power
84. [:SENSe]:STATus:TG? Syntax Function Front Panel [:SENSe]:STATus:TG? Quires the setting status of TG (Tracking Generator). System, Status, TG
[:SENSe]:TOI:AVERage:COUNt <integer> [:SENSe]:TOI:AVERage:COUNt? Sets the number of averages of the TOI measurement results, such as
Programming Guide for DSA1000A series
RIGOL
:TOI:AVER:COUN 100 The query returns 100. Explanations Default Front Panel <integer> ranges from 1 to 1000. 10 Meas, TOI Meas Setup, Avg Num
86. [:SENSe]:TOI:AVERage[:STATe] Syntax Function Default Front Panel [:SENSe]:TOI:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:TOI:AVERage[:STATe]? Turns on or off the average function of the TOI measurement. The query returns 0 or 1. OFF|0 Meas, TOI Meas Setup, Avg Num, On/Off
87. [:SENSe]:TOI:AVERage:TCONtrol Syntax Function Explanations [:SENSe]:TOI:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:TOI:AVERage:TCONtrol? Selects an average mode of the TOI measurement from EXP or REP. The query returns EXP or REP. In Exp mode, the result is from the exponent average calculation of the current N (specified by [:SENSe]:TOI:AVERage:COUNt) measurements. In REP mode, the result is the arithmetic average of the current N (specified by [:SENSe]:TOI:AVERage:COUNt) measurements. EXPonential
88. [:SENSe]:TOI:FREQuency:SPAN Syntax Function [:SENSe]:TOI:FREQuency:SPAN <freq> [:SENSe]:TOI:FREQuency:SPAN? Sets the span of the TOI measurement, the default unit is Hz, such as :TOI:FREQ:SPAN 1000000 or :TOI:FREQ:SPAN 1MHZ The query returns 1000000. <freq> ranges from 100 Hz to 3 GHz.
2-95
Explanations
RIGOL
89. [:SENSe]:TPOWer:AVERage:COUNt Syntax Function [:SENSe]:TPOWer:AVERage:COUNt <integer> [:SENSe]:TPOWer:AVERage:COUNt? Sets the number of averages of the T-Power measurement results, such as :TPOW:AVER:COUN 100 The query returns 100. <integer> ranges from 1 to 1000. 10 Meas, T-Power Meas Setup, Avg Num
90. [:SENSe]:TPOWer:AVERage[:STATe] Syntax Function [:SENSe]:TPOWer:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:TPOWer:AVERage[:STATe]? Turns on or off the average function of the Time-domain Power measurement. The query returns 0 or 1. OFF|0 Meas, T-Power Meas Setup, Avg Num, On/Off
91. [:SENSe]:TPOWer:AVERage:TCONtrol Syntax Function Explanations [:SENSe]:TPOWer:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:TPOWer:AVERage:TCONtrol? Sets the average mode of the T-Power measurement. In Exp mode, the result is from the exponent average calculation of the current N (specified by [:SENSe]:TPOWer:AVERage:COUNt) measurements. In REP mode, the result is the arithmetic average of the current N (specified by [:SENSe]:TPOWer:AVERage:COUNt) measurements. EXPonential
Meas, T-Power
Programming Guide for DSA1000A series
2-96
RIGOL
Meas Setup, Avg Mode, Exp/Repeat 92. [:SENSe]:TPOWer:MODE Syntax Function Default Front Panel [:SENSe]:TPOWer:MODE AVERage|PEAK|RMS [:SENSe]:TPOWer:MODE? Sets the type of the Time-domain Power measurement. The query returns AVER, PEAK or RMS. PEAK Meas, T-Power Meas Setup, Peak/Average/RMS
93. [:SENSe]:TPOWer:LLIMit Syntax Function [:SENSe]:TPOWer:LLIMit <time> [:SENSe]:TPOWer:LLIMit? Sets the left limit of the Time-domain Power measurement, the default unit is s, such as :TPOW:LLIM 0.005 The query returns 5.000000E-03. <time> ranges from 0 to Right limit. 0s Meas, T-Power Meas Setup, Start Line
94. [:SENSe]:TPOWer:RLIMit Syntax Function [:SENSe]:TPOWer:RLIMit <time> [:SENSe]:TPOWer:RLIMit? Sets the right limit of the Time-domain Power measurement, the default unit is s, such as :TPOW:RLIM 0.01 The query returns 1.000000E-02. <time> ranges from the left limit to Sweep Time. 100 ms Meas, T-Power Meas Setup, Stop Line
2-97
RIGOL
:SOURce
:SOURce:CORRection:OFFSet :SOURce:FREQuency:OFFSet :SOURce:POWer:LEVel:IMMediate:AMPLitude :SOURce:POWer:MODE :SOURce:POWer:SPAN :SOURce:POWer:STARt :SOURce:POWer:SWEep :SOURce:TRACe:STORref :SOURce:TRACe:REF:STATe
2-98
RIGOL
1.
:SOURce:CORRection:OFFSet :SOURce:CORRection:OFFSet <rel_ampl> :SOURce:CORRection:OFFSet? Sets the output amplitude offset for the tracking source in dB, such as :SOUR:CORR:OFFS 10 The query returns 1.000000E+01. <rel_ampl> ranges from -200 dB to 200 dB. 0 dB Source, TG Lvl Offset
Syntax Function
:SOURce:FREQuency:OFFSet :SOURce:FREQuency:OFFSet <freq> :SOURce:FREQuency:OFFSet? Sets the output frequency offset for the tracking source, the default unit is Hz, such as :SOUR:FREQ:OFFS 1000000 The query returns 1000000. <freq> ranges from -300 MHz to 300 MHz. 0Hz Source, Freq Offset
Syntax Function
:SOURce:POWer:LEVel:IMMediate:AMPLitude :SOURce:POWer:LEVel:IMMediate:AMPLitude <ampl> :SOURce:POWer:LEVel:IMMediate:AMPLitude? Sets the output power of the tracking source when the Power Sweep is off, the default unit is dBm, such as :SOUR:POW:LEV:IMM:AMP -10 The query returns -1.000000E+01. <ampl> ranges from -20 dBm to 0 dBm when the parameter <rel_ampl> in the :SOURce:CORRection:OFFSet command is 0, or else the range should plus the value of <rel_ampl>. 0 dBm Source, Power Sweep, Off, TG Level
Syntax Function
Explanations
Syntax
RIGOL
:SOURce:POWer:MODE? Function Default Front Panel Sets the power output mode. The query returns FIX or SWE. FIXed Power sweep output: Source, Power Sweep, On Fixed sweep output: Source, Power Sweep, Off
5.
:SOURce:POWer:SPAN :SOURce:POWer:SPAN <rel_ampl> :SOURce:POWer:SPAN? Sets the output amplitude range of the tracking source in dB when the Power Sweep is off, such as :SOUR:POW:SPAN 10 The query returns 1.000000E+01. <rel_ampl> ranges from 0 dB to 20 dB. 0 dB Source, Power Sweep, Off, Power Range
Syntax Function
:SOURce:POWer:STARt :SOURce:POWer:STARt <ample> :SOURce:POWer:STARt? Sets the output power of the tracking source when the Power Sweep is on, the default unit is dBm, such as :SOUR:POW:STAR -10 The query returns -1.000000E+01. <ample> ranges from -20 dBm to 0 dBm when the parameter <rel_ampl> in the :SOURce:CORRection:OFFSet command is 0, or else the range should plus the value of <rel_ampl>. 0 dBm Source, Power Sweep, On, TG Level
Syntax Function
Explanations
:SOURce:POWer:SWEep :SOURce:POWer:SWEep <rel_ampl> :SOURce:POWer:SWEep? Sets the output power range of the tracking source in dB when the power Sweep is On, such as :SOUR:POW:SWE 10
Programming Guide for DSA1000A series
Syntax Function
2-100
RIGOL
The query returns 1.000000E+01. Explanations Default Front Panel 8. <rel_ampl> ranges from 0 dB to 20 dB. 0 dB Source, Power Sweep, On, Power Range
:SOURce:TRACe:STORref :SOURce:TRACe:STORref Save the normalized trace. Source, Normalize, Stor Ref
:SOURce:TRACe:REF:STATe :SOURce:TRACe:REF:STATe OFF|ON|0|1 :SOURce:TRACe:REF:STATe? Sets if to display the reference trace. The query returns 0 or 1. OFF|0 Source, Normalize, Ref Trace, View/Blank
2-101
RIGOL
:STATus
:STATus:OPERation:CONDition? :STATus:OPERation:ENABle :STATus:OPERation[:EVENt]? :STATus:PRESet :STATus:QUEStionable:CONDition? :STATus:QUEStionable:ENABle :STATus:QUEStionable[:EVENt]?
2-102
RIGOL
1. :STATus:OPERation:CONDition? Syntax Function Explanations :STATus:OPERation:CONDition? The query returns the condition register status in the operation status register, such as 24. Bit 15 and bits 12-8 are not used in the Standard Operation Register and always regarded as 0, thereinto this command returns a decimal number that relates to any binary number whose bits of 15 and 12-8 are 0 within 0000000000000000 (0) and 1111111111111111 (32767).
2. :STATus:OPERation:ENABle Syntax Function :STATus:OPERation:ENABle <integer> :STATus:OPERation:ENABle? Sets the enable register value in the operation status register, such as: :STAT:OPER:ENAB 100 The query returns 100. Bit 15 and bits 12-8 are not used in the Standard Operation Register and always regarded as 0, thereinto <integer> is a decimal number that relates to any binary number whose bits of 15 and 12-8 are 0 within 0000000000000000 (0) and 1111111111111111 (32767). 0
Explanations
Default
3. :STATus:OPERation[:EVENt]? Syntax Function Explanations :STATus:OPERation[:EVENt]? The query returns the event register value in the operation status register, such as 24. Bit 15 and bits 12-8 are not used in the Standard Operation Register and always regarded as 0, thereinto this command returns a decimal number that relates to any binary number whose bits of 15 and 12-8 are 0 within 0000000000000000 (0) and 1111111111111111 (32767).
4. :STATus:PRESet Syntax Function :STATus:PRESet Clears the enable register value in both the operation status register
2-103
RIGOL
and questionable status register. 5. :STATus:QUEStionable:CONDition? Syntax Function Explanations :STATus:QUEStionable:CONDition? The query returns the condition register value in the questionable status register, such as 0. Bit 15 and bits 12-9 are not used in the Questionable Data Register and always regarded as 0, thereinto this command returns a decimal number that relates to any binary number whose bits of 15 and 12-9 are 0 within 0000000000000000 (0) and 1111111111111111 (32767).
6. :STATus:QUEStionable:ENABle Syntax Function :STATus:QUEStionable:ENABle <integer> :STATus:QUEStionable:ENABle? Sets the enable register value in the questionable status register, such as :STAT:QUES:ENAB 100 The query returns 100. Bit 15 and bits 12-9 are not used in the Questionable Data Register and always regarded as 0, thereinto <integer> is a decimal number that relates to any binary number whose bits of 15 and 12-9 are 0 within 0000000000000000 (0) and 1111111111111111 (32767). 0
Explanations
Default
7. :STATus:QUEStionable[:EVENt]? Syntax Function Explanations :STATus:QUEStionable[:EVENt]? The query returns the event register value in the questionable status register, such as 0. Bit 15 and bits 12-9 are not used in the Questionable Data Register and always regarded as 0, thereinto this command returns a decimal number that relates to any binary number whose bits of 15 and 12-9 are 0 within 0000000000000000 (0) and 1111111111111111 (32767).
2-104
RIGOL
:SYSTem
:SYSTem:COMMunicate:APORt :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess :SYSTem:COMMunicate:LAN[:SELF]:RESet :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe :SYSTem:COMMunicate:LAN[:SELF]:AUToip:STATe :SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe :SYSTem:COMMunicate:LAN[:SELF]:IP:ADDress :SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask :SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer :SYSTem:COMMunicate:USB[:SELF]:ADDRess? :SYSTem:COMMunicate:USB[:SELF]:CLASs :SYSTem:CONFigure:INFomation? :SYSTem:CONFigure:MESSage? :SYSTem:DATE :SYSTem:ERRor[:NEXT]? :SYSTem:FSWItch[:STATe] :SYSTem:LANGuage :SYSTem:LKEY :SYSTem:OPTions? :SYSTem:PON:TYPE :SYSTem:PRESet :SYSTem:PRESet:TYPE :SYSTem:PRESet[:USER]:SAVE :SYSTem:PROBe[:STATe] :SYSTem:SPEaker[:STATe] :SYSTem:SPEaker:VOLume :SYSTem:TIME :SYSTem:VERSion?
2-105
RIGOL
1. :SYSTem:COMMunicate:APORt Syntax Function Default Front Panel :SYSTem:COMMunicate:APORt GPIB|LAN|USB|OFF :SYSTem:COMMunicate:APORt? Selects a communication port. The query returns GPIB, LAN, USB or OFF. OFF System, I/O Setting, Remote I/O, Off/ LAN/USB/GPIB
2. :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess Syntax Function :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess <integer> :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess? Sets the GPIB address, such as :SYST:COMM:GPIB:ADDR 16 The query returns 16. <integer> is an integer within 0 and 30. 18 System, I/O Setting, GPIB
3. :SYSTem:COMMunicate:LAN[:SELF]:RESet Syntax Function Front Panel :SYSTem:COMMunicate:LAN[:SELF]:RESet Resets the LXI and all parameters abouth the LAN. System, I/O Setting, LAN, Reset
4. :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe Syntax Function Default Front Panel :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe OFF|ON|0|1 :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe? Turns on or off the DHCP. The query returns 0 or 1. ON|1 System, I/O Setting, LAN, DHCP, On/Off
:SYSTem:COMMunicate:LAN[:SELF]:AUToip:STATe OFF|ON|0|1 :SYSTem:COMMunicate:LAN[:SELF]:AUToip:STATe? Turns on or off the Auto IP. The query returns 0 or 1. ON|1
Programming Guide for DSA1000A series
RIGOL
Front Panel
6. :SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe Syntax Function Default Front Panel :SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe OFF|ON|0|1 :SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe? Turns on or off the Manual IP. The query returns 0 or 1. OFF|0 System, I/O Setting, LAN, Manual-IP, On/Off
7. :SYSTem:COMMunicate:LAN[:SELF]:IP:ADDress Syntax Function :SYSTem:COMMunicate:LAN[:SELF]:IP:ADDress <ip_address> :SYSTem:COMMunicate:LAN[:SELF]:IP:ADDress? Sets the IP address, such as :SYST:COMM:LAN:IP:ADD 172.16.3.199 The query returns 172.16.3.199. The format of <ip_address >is: nnn.nnn.nnn.nnn, thereinto, the first nnn ranges from 0 to 223 (except 127) and the others range from 0 to 255. System, I/O Setting, LAN, Manual-IP(On), IP, IP Address
Explanations
Front Panel
8. :SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask Syntax Function :SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask <ip_address> :SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask? Sets the submask, such as :SYST:COMM:LAN:IP:SUBM 255.255.255.0 The query returns 255.255.255.0. The format of < ip_address> is: nnn.nnn.nnn.nnn, thereinto, nnn ranges from 0 to 255. System, I/O Setting, LAN, Manual-IP (On), IP, Subnet Mask
9. :SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway Syntax Function :SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway <ip_address> :SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway? Specifies a default gateway, such as :SYST:COMM:LAN:IP:GAT 172.16.3.1 The query returns 172.16.3.1.
2-107
RIGOL
Explanations
The format of <ip_address >is: nnn.nnn.nnn.nnn, thereinto, the first nnn ranges from 0 to 223 (except 127) and the others range from 0 to 255. System, I/O Setting, LAN, Manual-IP(On), IP, Gateway
Front Panel
10. :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer Syntax Function :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer <ip_address> :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer? Sets the DNS server address, such as :SYST:COMM:LAN:IP:DNSS 172.16.2.2 The query returns 172.16.2.2. The format of <ip_address >is: nnn.nnn.nnn.nnn, thereinto, the first nnn ranges from 0 to 223 (except 127) and the others range from 0 to 255. System, I/O Setting, LAN, DNS
Explanations
Front Panel
11. :SYSTem:COMMunicate:USB[:SELF]:ADDRess? Syntax Function Default :SYSTem:COMMunicate:USB[:SELF]:ADDRess? Views the USB device address. 1
12. :SYSTem:COMMunicate:USB[:SELF]:CLASs Syntax Function Default Front Panel :SYSTem:COMMunicate:USB[:SELF]:CLASs TMC|PRINter|AUTO :SYSTem:COMMunicate:USB[:SELF]:CLASs? Sets the USB device type. The query returns TMC, PRIN or AUTO. TMC System, I/O Setting, USB, Dev Class, AutoConfig/TMC/Printer
13. :SYSTem:CONFigure:INFomation? Syntax Function Explanations Front Panel :SYSTem:CONFigure:INFomation? The query returns the same system information as those displayed on the screen of the front panel. The system information involves the software and hardware version and so on. System, Information, System Info
2-108
RIGOL
14. :SYSTem:CONFigure:MESSage? Syntax Function :SYSTem:CONFigure:MESSage? The query returns the system messages that have appeared recently, such as 10|U Disk connected.|2009-12-15 16:08:05 The analyzer can display up to 71 items of history information. System, Information, System Msg
15. :SYSTem:DATE Syntax Function :SYSTem:DATE <year>,<month>,<day> :SYSTem:DATE? Sets the real-time date of the analyzer, such as :SYSTem:DATE 2009,12,29 The query returns 2009,12,29. <year> is a four-digit figure. <month> is an integer within 01 and 12. <day> is an integer within 01 and 31.
Explanations
Front Panel
16. :SYSTem:ERRor[:NEXT]? Syntax Function :SYSTem:ERRor[:NEXT]? The query returns the error item that first entered the error queue and deletes it, such as -410,"Query INTERRUPTED" You can use *CLS command to clear all information in the error queues. If no error exists, the query returns 0, No Error*.
Explanations
17. :SYSTem:FSWItch[:STATe] Syntax Function Default Front Panel :SYSTem:FSWItch[:STATe] OFF|ON|0|1 :SYSTem:FSWItch[:STATe]? Sets if to use the front switch or not. The query returns 0 or 1. ON|1 System, Front Switch, On/Off
18. :SYSTem:LANGuage
Programming Guide for DSA1000A series 2-109
RIGOL
:SYSTem:LANGuage ENGLish|CHINese :SYSTem:LANGuage? Sets the display language. The query returns ENGL or CHIN. ENGLish System, Language, English/Chinese
19. :SYSTem:LKEY Syntax Function :SYSTem:LKEY < option>, < license key> :SYSTem:LKEY? < option> Installs and starts the options of the analyzer, such as :SYST:LKEY 0001,6L38O045P32POOPK The query returns 001,6L38O045P32POOPK. <option> is a four-digit figure, such as 0001. <license key> is the option license key. Note each option has an unique license key and can only be used in one analyzer.
Explanations
Front Panel
20. :SYSTem:OPTions? Syntax Function :SYSTem:OPTions? The query returns the installed option list, including the option number, the license key and the state of activation.
21. :SYSTem:PON:TYPE Syntax Function Explanations Default Front Panel :SYSTem:PON:TYPE PRESet|LAST :SYSTem:PON:TYPE? Specifies a Power-on settings upon rebooting. The query returns PRES or LAST. The presettings contain factory settings and user settings, you can use :SYSTem:PRESet:TYPE to select a desired type. PRESet System, Reset, Power On, Last/Preset
RIGOL
23. :SYSTem:PRESet:TYPE Syntax Function Default Front Panel :SYSTem:PRESet:TYPE FACTory|USER :SYSTem:PRESet:TYPE? Specifies the system preset type. The query returns FACT or USER. Factory System, Reset, Preset Type, Factory/User
24. :SYSTem:PRESet[:USER]:SAVE Syntax Function Front Panel :SYSTem:PRESet[:USER]:SAVE Saves the user settings. System, Reset, Preset Type, User, Save Preset
25. :SYSTem:PROBe[:STATe] Syntax Function Default :SYSTem:PROBe[:STATe] OFF|ON|0|1 :SYSTem:PROBe[:STATe]? Sets the probe status. The query returns 0 or 1. OFF|0
26. :SYSTem:SPEaker[:STATe] Syntax Function Default Front Panel :SYSTem:SPEaker[:STATe] OFF|ON|0|1 :SYSTem:SPEaker[:STATe]? Turns on or off the internal speaker. The query returns 0 or 1. OFF|0 Demod, Demod, AM/FM Demod Setup, Speaker, On/Off
27. :SYSTem:SPEaker:VOLume Syntax Function Explanations Default Front Panel :SYSTem:SPEaker:VOLume <integer> :SYSTem:SPEaker:VOLume? Adjusts the volume of the speaker. <integer> ranges from 0 to 255. 100 Demod, Demod, AM/FM
2-111
RIGOL
Demod Setup, Speaker, On/Off 28. :SYSTem:TIME Syntax Function :SYSTem:TIME <hour>,<minute>,<second> :SYSTem:TIME? Sets the real time of the analyzer clock, such as :SYSTem:TIME 15,50,00 The query returns 15,50,00. <hour> is an integer within 00 and 23. <minute> is an integer within 00 and 59. <second> is an integer within 00 and 59.
Explanations
Front Panel
29. :SYSTem:VERSion? Syntax Function :SYSTem:VERSion? The query returns the SCPI version number of the analyzer: 1999.0.
2-112
RIGOL
:TRACe
:TRACe[:DATA] :TRACe:MATH:PEAK[:DATA]? :TRACe:MATH:PEAK:POINts? :TRACe:MATH:PEAK:SORT :TRACe:MATH:PEAK:TABLe:STATe :TRACe:MATH:PEAK:THReshold :TRACe:MATH:STATe :TRACe:MATH:A :TRACe:MATH:B :TRACe:MATH:CONSt :TRACe:MATH:TYPE :TRACe<n>:MODE :TRACe:AVERage:CLEar :TRACe:AVERage:COUNt :TRACe:AVERage:COUNt:CURRent? :TRACe<n>:AVERage:TYPE :TRACe:CLEar:ALL
2-113
RIGOL
1. :TRACe[:DATA] Syntax :TRACe[:DATA] TRACE1|TRACE2|TRACE3|TRACE4,<definite_length_block> |<comma_separated_ASCII_data> :TRACe[:DATA]? TRACE1|TRACE2|TRACE3|TRACE4 Loads the user data into the specified tarce. The query returns the specified trace data. You can set the user data by sending :FORMat[:TRACe][:DATA]. <definite_length_block>: first executes the command :FORM REAL. <comma_separated_ASCII_data>: first executes the command :FORM ASCii. The query of :TRACe? TRACE2 and :TRACe? TRACE3 will return the upper limit line data and lower limit line data respectively when the Pass/Fail function is On.
Function Explanations
2. :TRACe:MATH:PEAK[:DATA]? Syntax Function :TRACe:MATH:PEAK[:DATA]? Queries the frequency (Hz) and amplitude (has the same unit as Y-axiss) from Peak Table. The query returns 10 paris of frequency and amplitude values at most, such as 43500000,-7.253288E+01,43950000,-7.169086E+01 The command only queries trace 1. You can sort the peaks by using :TRACe:MATH:PEAK:SORT.
Explanations
3. :TRACe:MATH:PEAK:POINts? Syntax Function :TRACe:MATH:PEAK:POINts? Queries the peak readout points from the Peak Table and returns an integer within 0 and 10.
4. :TRACe:MATH:PEAK:SORT Syntax Function Default :TRACe:MATH:PEAK:SORT AMPLitude|FREQuency :TRACe:MATH:PEAK:SORT? Sorts the Peak Table. The query returns AMPL or FREQ. FREQuency
2-114
RIGOL
Front Panel
5. :TRACe:MATH:PEAK:TABLe:STATe Syntax Function Default Front Panel :TRACe:MATH:PEAK:TABLe:STATe OFF|ON|0|1 :TRACe:MATH:PEAK:TABLe:STATe? Turns on or off the Peak Table. The query returns 0 or 1. OFF|0 Peak, Peak Table, State, On/Off
6. :TRACe:MATH:PEAK:THReshold Syntax Function Explanations :TRACe:MATH:PEAK:THReshold NORMal|DLMore|DLLess :TRACe:MATH:PEAK:THReshold? Sets the readout type of the peak from Peak Table. The query returns NORM, DLM or DLL. NORMal: Displaying the first ten qualified peaks in the table. DLMore: Displaying the first ten peaks that not only meet the parameter conditions but also have an amplitude greater than the specified Display Line in the table. DLLess: Displaying the first ten peaks that not only meet the parameter conditions but also have an amplitude smaller than the specified Display Line in the table.
7. :TRACe:MATH:STATe Syntax Function Default Front Panel :TRACe:MATH:STATe OFF|ON|0|1 :TRACe:MATH:STATe? Turns on or off the math trace. The query returns 0 or 1. OFF|0 Trace, Trace Math, Operate, On/Off
8. :TRACe:MATH:A Syntax Function :TRACe:MATH:A T1|T2|T3 :TRACe:MATH:A? Selects a trace as the trace A for the trace math from T1, T2 or T3.
2-115
RIGOL
9. :TRACe:MATH:B Syntax Function Default :TRACe:MATH:B T1|T2|T3 :TRACe:MATH:B? Selects a trace as the trace B for the trace math from T1, T2 or T3. The query returns T1, T2" or T3. T2
10. :TRACe:MATH:CONSt Syntax Function :TRACe:MATH:CONSt <integer> :TRACe:MATH:CONSt? Sets the constant of the trace math in dB, such as :TRAC:MATH:CONS 10 The query returns 1.000000E+01. <integer> ranges from -300 dB to 300 dB. 0 dB
Explanations Default
11. :TRACe:MATH:TYPE Syntax Function Default :TRACe:MATH:TYPE A-B|A+CONST|A-CONST :TRACe:MATH:TYPE? Sets the computational method of the math trace. The query returns A-B, A+CONST or A-CONST. A-B
12. :TRACe<n>:MODE Syntax :TRACe<n>:MODE WRITe|MAXHold|MINHold|VIEW|BLANk|VIDeoavg|POWeravg :TRACe<n>:MODE? Sets the type of specified trace. The query returns WRIT, MAXH, MINH, VIEW, BLANK, VID or POW.
2-116
Function
Explanations
<n> is 1, 2 or 3. All trace data will be erased after you change the sweep points (by using [:SENSe]:SWEep:POINts). The query of :TRACe2:MODE? and :TRACe3:MODE? will
Programming Guide for DSA1000A series
RIGOL
return UPPERL and LOWERL respectively when the Pass/Fail function is On. Default Front Panel WRITe Trace, Trace Type, Clear Write/Max Hold/Min Hold/Video Avg/Power Avg/Freeze
14. :TRACe:AVERage:COUNt Syntax Function :TRACe:AVERage:COUNt <integer> :TRACe:AVERage:COUNt? Sets the number of averages of the trace, such as :TRAC:AVER:COUN 10 The query returns 10. <integer> ranges from 1 to 1000. 100 Trace, Avg Num
15. :TRACe:AVERage:COUNt:CURRent? Syntax Function :TRACe:AVERage:COUNt:CURRent? The query returns the current number of averages of the trace, such as 1.
16. :TRACe<n>:AVERage:TYPE Syntax Function Explanations :TRACe<n>:AVERage:TYPE VIDeo|RMS :TRACe<n>:AVERage:TYPE? Sets the average type of the trace. The query returns VID or RMS. <n> is 1, 2 or 3. The query of :TRACe2:AVERage:TYPE? and :TRACe3:AVERage:TYPE? will return ERR when the Pass/Fail function is On.
2-117
RIGOL
17. :TRACe:CLEar:ALL Syntax Function Front Panel :TRACe:CLEar:ALL Clears all traces, that is, set the type of all traces to BLANK (Off). Trace, Clear All
2-118
RIGOL
:TRIGer
:TRIGger:SEQuence:EXTernal:SLOPe :TRIGger:SEQuence:SOURce :TRIGger:SEQuence:VIDeo:LEVel
1. :TRIGger:SEQuence:EXTernal:SLOPe Syntax Function Default Front Panel :TRIGger:SEQuence:EXTernal:SLOPe POSitive|NEGative :TRIGger:SEQuence:EXTernal:SLOPe? Sets the external trigger edge. The query returns POS or NEG. POSitive Trig, Trig Type, External Trig Setup, Edge, Positive/Negtive
2. :TRIGger:SEQuence:SOURce Syntax Function Default Front Panel :TRIGger:SEQuence:SOURce IMMediate|VIDeo|EXTernal :TRIGger:SEQuence:SOURce? Ses the trigger type. The query returns IMM, VID or EXT. IMMediate Trig, Trig Type, Free Run/Video/External
3. :TRIGger:SEQuence:VIDeo:LEVel Syntax Function :TRIGger:SEQuence:VIDeo:LEVel <ampl> :TRIGger:SEQuence:VIDeo:LEVel? Sets the Video trigger level, the default unit is dBm, such as :TRIG:SEQ:VID:LEV 10 The query returns 1.000000E+01. <ampl> ranges from -300 dBm to50 dBm. Sending :TRIGger:SEQuence:SOURce VIDeo can select the Video trigger.
Explanations
2-119
RIGOL
:UNIT
:UNIT:POWer
1. :UNIT:POWer Syntax Function Default Front Panel :UNIT:POWer DBM|DBMV|DBUV|V|W :UNIT:POWer? Sets the unit of the input, output and the displayed amplitude. The query returns DBM, DBMV, DBUV, V or W. Log unit: dBm Lin unit: V AMPT, Units, dBm/ dBmV/dBuV/Volts/Watts
2-120
RIGOL
3-1
RIGOL
After successful connection, turn on the instrument, a dialog will guide you to install the driver of USB Test and Measurement Device on the PC. See figure below.
3-2
RIGOL
3-3
RIGOL
3.
Choose ToolsOptionsDirectories. Select Include files in Show directories for, and then dblclick the blank in Directories to add the path of Include: C:\Program Files\IVI Foundation\VISA\WinNT\include. Select Library files in Show directories for, and then dblclick the blank in Directories to add the path of Lib: C:\Program Files\IVI Foundation\VISA\WinNT\lib\msc.
3-4
RIGOL
The Blank
Note: At present, VISA library has been added successfully. 4. Add controls: Text, Edit and Button. See figure below.
5.
Add control variables. Open ViewClassWizardMember Variables, and add the following three variables: Instrument address: CString m_strInstrAddr Command: CString m_strCommand Return ValueCString m_strResult
3-5
RIGOL
6.
Encapsulate the read and write operations of VISA. 1) Encapsulate the write to VISA. bool CDemoForDSADlg::InstrWrite(CString strAddr, CString strContent) //Write //operation { ViSession defaultRM,instr; ViStatus status; ViUInt32 retCount; char * SendBuf = NULL; char * SendAddr = NULL; bool bWriteOK = false; CString str; // Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.GetLength()); strcpy(SendAddr,strAddr); strAddr.ReleaseBuffer(); // Change the command's data style from CString to char* SendBuf = strContent.GetBuffer(strContent.GetLength()); strcpy(SendBuf,strContent); strContent.ReleaseBuffer(); //open a VISA resource status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { AfxMessageBox("No VISA resource was opened!"); return false; } status = viOpen(defaultRM, SendAddr, VI_NULL, VI_NULL, &instr); //Write command to the instrument status = viWrite(instr, (unsigned &retCount); //Close the system
char
*)SendBuf,
strlen(SendBuf),
3-6
RIGOL
status = viClose(instr); status = viClose(defaultRM); return bWriteOK; } 2) Encapsulate the read of VISA. bool CDemoForDSADlg::InstrRead(CString strAddr, CString *pstrResult) //Read //operation { ViSession defaultRM,instr; ViStatus status; ViUInt32 retCount; char * SendAddr = NULL; unsigned char RecBuf[MAX_REC_SIZE]; bool bReadOK = false; CString str; // Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.GetLength()); strcpy(SendAddr,strAddr); strAddr.ReleaseBuffer(); memset(RecBuf,0,MAX_REC_SIZE); //Open a VISA resource status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { // Error Initializing VISA...exiting AfxMessageBox("No VISA resource was opened!"); return false; } //Open the instrument status = viOpen(defaultRM, SendAddr, VI_NULL, VI_NULL, &instr); //Read from the instrument
Programming Guide for DSA1000A series 3-7
RIGOL
status = viRead(instr, RecBuf, MAX_REC_SIZE, &retCount); //close the system status = viClose(instr); status = viClose(defaultRM); (*pstrResult).Format("%s",RecBuf); return bReadOK; } 7. Add the control message in order to response to codes. 1) Connect the instrument void CDemoForDSADlg::OnBtConnectInstr() // Connect to the instrument { // TODO: Add your control notification handler code here ViStatus status; ViSession defaultRM; ViString expr = "?*"; ViPFindList findList = new unsigned long; ViPUInt32 retcnt = new unsigned long; ViChar instrDesc[1000]; CString strSrc = ""; CString strInstr = ""; unsigned long i = 0; bool bFindDSA = false; status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { // Error Initializing VISA...exiting MessageBox("No VISA instrument was opened ! "); return ; } memset(instrDesc,0,1000); // Find resource
3-8 Programming Guide for DSA1000A series
RIGOL
status = viFindRsrc(defaultRM,expr,findList, retcnt, instrDesc); for (i = 0;i < (*retcnt);i++) { // Get instrument name strSrc.Format("%s",instrDesc); InstrWrite(strSrc,"*IDN?"); ::Sleep(200); InstrRead(strSrc,&strInstr); // If the instrument(resource) belongs to the DSA series then jump out //from the loop strInstr.MakeUpper(); if (strInstr.Find("DSA") >= 0) { bFindDSA = true; m_strInstrAddr = strSrc; break; } //Find next instrument status = viFindNext(*findList,instrDesc); } if (bFindDSA == false) { MessageBox("Didnt find any DSA!"); } UpdateData(false); } 2) Write operation void CDemoForDSADlg::OnBtWrite() //Write operation { // TODO: Add your control notification handler code here UpdateData(true); if (m_strInstrAddr.IsEmpty()) {
Programming Guide for DSA1000A series 3-9
RIGOL
MessageBox("Please connect to the instrument first!"); } InstrWrite(m_strInstrAddr,m_strCommand); m_strResult.Empty(); UpdateData(false); } 3) Read operation void CDemoForDSADlg::OnBtRead() //Read operation { // TODO: Add your control notification handler code here UpdateData(true); InstrRead(m_strInstrAddr,&m_strResult); UpdateData(false); } 8. Execute results. 1) Click Connect to search the available analyzer. 2) Enter *IDN? in the Command edit box. 3) Click Write to write the command into the analyzer. 4) Click Read to read the Return Value. See figure below:
3-10
RIGOL
Then add Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long) statement into the visa32.bas, or create a new module to declare the Sleep function. 3. Add controls: Text, Edit and Button, see figure below:
3-11
RIGOL
4.
Encapsulate the read and write operations of VISA. 1) Encapsulate the write to VISA. '----------------------------------------------------------'Function NameInstrWrite 'Function Send command to the instrument 'Input rsrcName,instrument(resource) name strCmd,Command '----------------------------------------------------------Public Sub InstrWrite(rsrcName As String, strCmd As String) Dim status As Long Dim dfltRM As Long Dim sesn As Long Dim rSize As Long 'Initialize the system status = viOpenDefaultRM(dfltRM) 'Failed to initialize the system If (status < VI_SUCCESS) Then MsgBox " No VISA resource was opened" Exit Sub End If Open the VISA instrument status = viOpen(dfltRM, rsrcName, VI_NULL, VI_NULL, sesn) 'Failed to open the instrument If (status < VI_SUCCESS) Then MsgBox "Failed to open the instrument" Exit Sub End If 'Write command to the instrument status = viWrite(sesn, strCmd, Len(strCmd), rSize) 'Failed to write to the instrument If (status < VI_SUCCESS) Then MsgBox " Faild to write to the instrument" Exit Sub End If 'Close the system
3-12
RIGOL
status = viClose(sesn) status = viClose(dfltRM) End Sub 2) Encapsulate the read of VISA. '----------------------------------------------------------'Function NameInstrRead 'Function Read the return value from the instrument 'Input rsrcName,Resource name 'ReturnThe string gotten from the instrument '----------------------------------------------------------Public Function InstrRead(rsrcName As String) As String Dim status As Long Dim dfltRM As Long Dim sesn As Long Dim strTemp0 As String * 256 Dim strTemp1 As String Dim rSize As Long 'Begin by initializing the system status = viOpenDefaultRM(dfltRM) 'Initial failed If (status < VI_SUCCESS) Then MsgBox " Failed to open the instrument! " Exit Function End If 'Open the instrument status = viOpen(dfltRM, rsrcName, VI_NULL, VI_NULL, sesn) 'Open instrument failed If (status < VI_SUCCESS) Then MsgBox " Failed to open the instrument! " Exit Function End If ' Read from the instrument stasus = viRead(sesn, strTemp0, 256, rSize) ' Read failed
Programming Guide for DSA1000A series 3-13
RIGOL
If (status < VI_SUCCESS) Then MsgBox " Failed to read from the instrument! " Exit Function End If 'Close the system status = viClose(sesn) status = viClose(dfltRM) ' Remove the space at the end of the string strTemp1 = Left(strTemp0, rSize) InstrRead = strTemp1 End Function 5. Add control event codes 1) Connect the instrument ' Connect to the instrument Private Sub CmdConnect_Click() Const MAX_CNT = 200 Dim status As Long Dim dfltRM As Long Dim sesn As Long Dim fList As Long Dim buffer As String * MAX_CNT, Desc As String * 256 Dim nList As Long, retCount As Long Dim rsrcName(19) As String * VI_FIND_BUFLEN, instrDesc As String * VI_FIND_BUFLEN Dim i, j As Long Dim strRet As String Dim bFindDSA As Boolean Initialize the system status = viOpenDefaultRM(dfltRM) ' Initialize failed If (status < VI_SUCCESS) Then MsgBox " No VISA resource was opened " Exit Sub End If
3-14 Programming Guide for DSA1000A series
RIGOL
' Find instrument resource Call viFindRsrc(dfltRM, "USB?*INSTR", fList, nList, rsrcName(0)) ' Get the list of the instrument(resource) strRet = "" bFindDSA = False For i = 0 To nList - 1 ' Get the instrument name InstrWrite rsrcName(i), "*IDN?" Sleep 200 strRet = InstrRead(rsrcName(i)) ' Continue to switch the resource until find a DSA instrument strRet = UCase(strRet) j = InStr(strRet, "DSA") If (j >= 0) Then bFindDSA = True Exit For End If Call viFindNext(fList + i - 1, rsrcName(i)) Next i 'Dispaly If (bFindDSA = True) Then TxtInsAddr.Text = rsrcName(i) Else TxtInsAddr.Text = "" End If End Sub 2) Write operation 'Write the command to the instrument Private Sub CmdWrite_Click() If (TxtInsAddr.Text = "") Then MsgBox ("Please write the instrument address") End If InstrWrite TxtInsAddr.Text, TxtCommand.Text End Sub
Programming Guide for DSA1000A series 3-15
RIGOL
3) Reas operation 'Read the return value from the instrument Private Sub CmdRead_Click() Dim strTemp As String strTemp = InstrRead(TxtInsAddr.Text) TxtReturn.Text = strTemp End Sub 6. Execute results 1) Click Connect to search the available analyzer. 2) Enter *IDN? in the Command edit box. 3) Click Write to write the command into the analyzer. 4) Click Read to read the Return Value. See figure below:
3-16
RIGOL
2. Add the events (contain read and write operation, instrument connection and exit)
3-17
RIGOL
3-18
RIGOL
3-19
RIGOL
6. Exit code
3-20
RIGOL
7. Execute results
3-21
RIGOL
2.
3.
3-22
RIGOL
After the analyzer is correctly connected with the PC, configure the network address of the analyzer so that the address is in the same network segment with the PC network address. For example, the PC network address and DNS are set as follows, therefore, the network address of the analyzer should be set to: IP Address: 172.16.3.X* Gateway Address: 172.16.3.1 Subnet Mask: 255.255.255.0 DSN: 172.16.2.2
Note : X can be any value that has not been used between 2 and 254.
*
3-23
RIGOL
3-24
RIGOL
Method 2: add the search path of the library to the /etc/ld.so.conf file. Adding method: #echo /usr/local/lib >> /etc/ld.so.conf, as shown in the figure below. After setting the search path of the library in /etc/ld.so.conf, execute the /sbin/ldconfig command to update /etc/ld.so.cache (this command must have root right) so as to locate the library when executing the program.
3-25
RIGOL
Programming Steps 1. Edit the DemoForDSA.h head file and declare a category so as to encapsulate the operation and nature of the instrument. #ifndef DEMO_FOR_DSA_H #define DEMO_FOR_DSA_H #include <stdio.h> #include <string.h> #include <stdlib.h> #include <iostream> //#include <syswait.h> using namespace std; #define MAX_SEND_BUF_SIZE #define MAX_REC_SIZE class DemoForDSA { // Construction public: DemoForDSA();
3-26 Programming Guide for DSA1000A series
50 300
RIGOL
bool InstrRead(string strAddr, string & pstrResult); bool InstrWrite(string strAddr, string strContent); bool ConnectInstr(); string string string }; void makeupper(string & instr); #endif 2. Edit the DemoForDSA.cpp file to realize various operations of the instrument. #include "visa.h" #include "DemoForDSA.h" m_strInstrAddr; m_strResult; m_strCommand;
bool DemoForDSA::ConnectInstr() { ViUInt32 retCount; ViStatus status; ViSession defaultRM; ViString expr = "?*"; ViPFindList findList = new unsigned long; ViPUInt32 retcnt = new unsigned long; string strSrc = "";
Programming Guide for DSA1000A series 3-27
RIGOL
string strInstr = ""; ViChar instrDesc[1000]; unsigned long i = 0; bool bFindDSA = false; memset(instrDesc,0,1000); //Open the VISA device status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { cout<<" No VISA equipment!"<<endl; return false; } //Search for resource status = viFindRsrc(defaultRM,expr,findList, retcnt, instrDesc); for (i = 0;i < (*retcnt);i++) { //Get the instrument name strSrc=instrDesc; InstrWrite(strSrc,"*IDN?"); usleep(200); InstrRead(strSrc,strInstr); //If it is a DSA series instrument, the program exits after finding the instrument makeupper(strInstr); if (strInstr.find("DSA",0) > 0) { bFindDSA = true; m_strInstrAddr = strSrc; break; }
3-28
RIGOL
//Get the next device status = viFindNext(*findList,instrDesc); } if (bFindDSA == false) { printf("DSA device not found!\n"); return false; } return true; } bool DemoForDSA::InstrWrite(string strAddr, string strContent) //Write operation { ViSession defaultRM,instr; ViStatus status; ViUInt32 retCount; char * SendBuf = NULL; char * SendAddr = NULL; bool bWriteOK = false; string str; //Address conversion, convert strig address to char* address SendAddr = const_cast<char*>(strAddr.c_str()); //Address conversion, convert strig address to char* address SendBuf = const_cast<char*>(strContent.c_str()); //Open the specific device status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { cout<<"No VISA equipment!"<<endl; return false; }
3-29
RIGOL
status = viOpen(defaultRM, SendAddr, VI_NULL, VI_NULL, &instr); //Write command to the device status = viWrite(instr, (unsigned char *)SendBuf, strlen(SendBuf), &retCount); //Close the device status = viClose(instr); status = viClose(defaultRM); return bWriteOK; } bool DemoForDSA::InstrRead(string strAddr, string & pstrResult) //Instrument Reads { ViSession defaultRM,instr; ViStatus status; ViUInt32 retCount; char* SendAddr = NULL; char * result = NULL; bool bReadOK = false; unsigned char RecBuf[MAX_REC_SIZE]; string str; memset(RecBuf,0,MAX_REC_SIZE); result=(char*)malloc(MAX_REC_SIZE*sizeof(char)); memset(result,0,MAX_REC_SIZE); //Address conversion, convert strig address to char* address SendAddr=const_cast<char*>(strAddr.c_str()); //Open the VISA device status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { // Error Initializing VISA...exiting cout<<"No VISA equipment!"<<endl; return false; }
3-30 Programming Guide for DSA1000A series
RIGOL
//Open the specific device status = viOpen(defaultRM, SendAddr, VI_NULL, VI_NULL, &instr); //Read the device status = viRead(instr, RecBuf, MAX_REC_SIZE, &retCount); //Close the device status = viClose(instr); status = viClose(defaultRM); sprintf(result,"%s",RecBuf); pstrResult = result; free(result); return bReadOK; } void makeupper( string &instr) { string outstr = ""; if(instr == "") { exit(0); } for(int i = 0;i < instr.length();i++) { instr[i] = toupper(instr[i]); } } 3. Edit the function file mainloop.cpp and finish the flow control. #include "DemoForDSA.h" void menudisplay() { cout<<"\t\t Please operate the instrument:\n quit"<<endl;
Programming Guide for DSA1000A series
read write
3-31
RIGOL
} int main() { DemoForDSA demo; char temp[50]; if(!demo.ConnectInstr()) { cout<<"can not connect the equipment!"<<endl; return 0; } else { cout<<"\n connect equipment success!"<<endl; cout<<" the equipment address is :"<<demo.m_strInstrAddr<<endl; } while(1) { menudisplay(); //cin>>demo.m_strCommand; cin.getline(temp,50); demo.m_strCommand=temp; if(demo.m_strCommand[0]=='r' && demo.m_strCommand[1]=='e' && demo.m_strCommand[2]=='a' && demo.m_strCommand[3]=='d') { //demo.InstrWrite(demo.m_strInstrAddr,"*IDN?"); //demo.InstrRead(demo.m_strInstrAddr,demo.m_strResult); cout<<"read result:"<<demo.m_strResult<<endl; demo.m_strResult=""; } else if (demo.m_strCommand[0]=='w' && demo.m_strCommand[1]=='r' && demo.m_strCommand[2]=='i' && demo.m_strCommand[3]=='t'
3-32 Programming Guide for DSA1000A series
RIGOL
&& demo.m_strCommand[4]=='e') { if (demo.m_strInstrAddr=="") { cout<<"Please connect the instrument\n"; } demo.InstrWrite(demo.m_strInstrAddr,demo.m_strCommand.substr(5,40)); usleep(200); //Read the instrument demo.InstrRead(demo.m_strInstrAddr,demo.m_strResult); } else if (demo.m_strCommand[0] == 'q' && demo.m_strCommand[1] == 'u' && demo.m_strCommand[2] == 'i' && demo.m_strCommand[3] == 't') { break; } else if(demo.m_strCommand != "") { cout<<"Bad command!"<<endl; } } return 1; } 4. makefile file src = DemoForDSA.cpp mainloop.cpp DemoForDSA.h obj = DemoForDSA.o mainloop.o INCLUDE= -I/usr/local/vxipnp/linux/include LIB= -lvisa -lc -lpthread
Programming Guide for DSA1000A series 3-33
RIGOL
CC=g++ demo : $(obj) $(CC) $(INCLUDE) $(LIB) -o demo $(obj) mainloop.o : mainloop.cpp DemoForDSA.h $(CC) -c $< -o $@ DemoForDSA.o: DemoForDSA.cpp DemoForDSA.h $(CC) -c $< -o $@ .PHONY : clean clean: rm demo $(obj) 5. Execute results 1) #make 2) ./demo 3) Execute the program and connect the instrument automatically. If no instrument is found, No VISA equipment! is displayed and the program exits. If an instrument is found and successfully connected, the interface as shown in the figure below is displayed. 4) Input write<command> to write the command into the analyzer. For example, write<*IDN?>. 5) Input read to read the return value as shown in the figure below.
3-34
RIGOL
RIGOL :CALCulate:MARKer<n>:X:STARt :CALCulate:MARKer<n>:X:STOP :CALCulate:MARKer<n>:Y? :CALCulate:NTData[:STATe] :CALibration:[ALL] :CALibration:AUTO :CONFigure:ACPower :CONFigure:CHPower :CONFigure:CNRatio :CONFigure:EBWidth :CONFigure:HDISt :CONFigure:OBWidth :CONFigure:PF :CONFigure:SANalyzer :CONFigure:TOI :CONFigure:TPOWer :CONFigure? :COUPle D :DISPlay:AFUnction:POSition :DISPlay:ANNotation:CLOCk :DISPlay:BRIGtness :DISPlay:ENABle :DISPlay:MENU:STATe :DISPlay:MENU:HTIMe :DISPlay:MSGswitch:STATe :DISPlay:SKIN :DISPlay:SSAVer:TIME :DISPlay:WINdow:TRACe:GRATicule:GRID :DISPlay:WINdow:TRACe:Y:DLINe :DISPlay:WINdow:TRACe:Y:DLINe:STATe :DISPlay:WINdow:TRACe:Y:SCALe:PDIVision :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFF Set :DISPlay:WINdow:TRACe:Y:SCALe:SPACing :DISPlay:WINdow:TRACe:Y:SCALe:NRLevel H :HCOPy:ABORt F
:FETCh:ACPower? :FETCh:ACPower:LOWer? :FETCh:ACPower:UPPer? :FETCh:ACPower:MAIN? :FETCh:CHPower? :FETCh:CHPower:CHPower? :FETCh:CHPower:DENSity? :FETCh:CNRatio? :FETCh:CNRatio:CARRier? :FETCh:CNRatio:CNRatio? :FETCh:CNRatio:NOISe? :FETCh:EBWidth? :FETCh:HARMonics:AMPLitude:ALL? :FETCh:HARMonics:AMPLitude? <n> :FETCh:HARMonics[:DISTortion]? :FETCh:HARMonics:FREQuency:ALL? :FETCh:HARMonics:FREQuency? <n> :FETCh:HARMonics:FUNDamental? :FETCh:OBWidth? :FETCh:OBWidth:OBWidth? :FETCh:OBWidth:OBWidth:FERRor? :FETCh:TOIntercept? :FETCh:TOIntercept:IP3? :FETCh:TPOWer? :FORMat:BORDer :FORMat[:TRACe][:DATA]
:HCOPy:IMAGe:COLor[:STATe] :HCOPy:IMAGe:INVert :HCOPy:IMAGe:PTIMe :HCOPy:IMAGe:QUALity :HCOPy:IMAGe:FTYPe :HCOPy[:IMMediate] Programming Guide for DSA1000A series
Command Quick Reference A-Z :HCOPy:PAGE:ORIentation :HCOPy:PAGE:PRINts :HCOPy:PAGE:SIZE :HCOPy:RESume I :INITiate:CONTinuous :INITiate[:IMMediate] :INITiate:PAUSe :INITiate:RESTart :INITiate:RESume :INPut:IMPedance M :MMEMory:DELete :MMEMory:DISK:FORMat :MMEMory:DISK:INFormation? :MMEMory:MOVE :MMEMory:LOAD:LIMit :MMEMory:LOAD:MTABle :MMEMory:LOAD:CORRection :MMEMory:LOAD:STATe :MMEMory:LOAD:TRACe :MMEMory:LOAD:SETUp :MMEMory:STORe:CORRection :MMEMory:STORe:SCReen :MMEMory:STORe:STATe :MMEMory:STORe:TRACe :MMEMory:STORe:SETUp :MMEMory:STORe:RESults :MMEMory:STORe:MTABle :MMEMory:STORe:PTABle :MMEMory:STORe:LIMit O :OUTPut[:STATe] R Programming Guide for DSA1000A series S [:SENSe]:BANDwidth:RESolution :READ:ACPower? :READ:ACPower:LOWer? :READ:ACPower:UPPer? :READ:ACPower:MAIN? :READ:CHPower? :READ:CHPower:CHPower? :READ:CHPower:DENSity? :READ:CNRatio? :READ:CNRatio:CARRier? :READ:CNRatio:CNRatio? :READ:CNRatio:NOISe? :READ:EBWidth? :READ:HARMonics:AMPLitude:ALL? :READ:HARMonics:AMPLitude? <n> :READ:HARMonics[:DISTortion]? :READ:HARMonics:FREQuency:ALL? :READ:HARMonics:FREQuency? <n> :READ:HARMonics:FUNDamental? :READ:OBWidth? :READ:OBWidth:OBWidth? :READ:OBWidth:OBWidth:FERRor? :READ:TOIntercept? :READ:TOIntercept:IP3? :READ:TPOWer?
RIGOL
[:SENSe]:BANDwidth:RESolution:AUTO [:SENSe]:BANDwidth:VIDeo [:SENSe]:BANDwidth:VIDeo:AUTO [:SENSe]:BANDwidth:VIDeo:RATio [:SENSe]:CORRection:CSET:ALL:DELete [:SENSe]:CORRection:CSET:ALL[:STATe] [:SENSe]:CORRection:CSET<n>:DATA [:SENSe]:CORRection:CSET<n>:DATA:MERGe [:SENSe]:CORRection:CSET<n>:DELete [:SENSe]:CORRection:CSET<n>:X:SPACing [:SENSe]:CORRection:CSET<n>[:STATe] 3
RIGOL [:SENSe]:CORRection:CSET:TABLe:STATe [:SENSe]:DEMod [:SENSe]:DEMod:STATe :SYSTem:SPEaker:VOLume [:SENSe]:DEMod:TIME [:SENSe]:DETector[:FUNCtion] [:SENSe]:FREQuency:CENTer [:SENSe]:FREQuency:CENTer:SET:STEP [:SENSe]:FREQuency:CENTer:STEP:AUTO [:SENSe]:FREQuency:CENTer:STEP[:INCReme nt] [:SENSe]:FREQuency:CENTer:UP [:SENSe]:FREQuency:CENTer:DOWN [:SENSe]:FREQuency:SPAN [:SENSe]:FREQuency:SPAN:FULL [:SENSe]:FREQuency:SPAN:PREVious [:SENSe]:FREQuency:SPAN:ZIN [:SENSe]:FREQuency:SPAN:ZOUT [:SENSe]:FREQuency:STARt [:SENSe]:FREQuency:STOP [:SENSe]:POWer[:RF]:ATTenuation [:SENSe]:POWer[:RF]:ATTenuation:AUTO [:SENSe]:POWer[:RF]:GAIN[:STATe] [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer] [:SENSe]:POWer:ASCale [:SENSe]:POWer:ARANge [:SENSe]:POWer:ATUNe [:SENSe]:SWEep:POINts [:SENSe]:SWEep:COUNt [:SENSe]:SWEep:COUNt:CURRent? [:SENSe]:SWEep:TIME [:SENSe]:SWEep:TIME:AUTO [:SENSe]:SWEep:TIME:AUTO:RULes [:SENSe]:ACPower:AVERage:COUNt [:SENSe]:ACPower:AVERage[:STATe] [:SENSe]:ACPower:AVERage:TCONtrol [:SENSe]:ACPower:BANDwidth:INTegration [:SENSe]:ACPower:BANDwidth:ACHannel
Command Quick Reference A-Z [:SENSe]:ACPower:CSPacing [:SENSe]:CHPower:AVERage:COUNt [:SENSe]:CHPower:AVERage[:STATe] [:SENSe]:CHPower:AVERage:TCONtrol [:SENSe]:CHPower:BANDwidth:INTegration [:SENSe]:CHPower:FREQuency:SPAN [:SENSe]:CNRatio:AVERage:COUNt [:SENSe]:CNRatio:AVERage[:STATe] [:SENSe]:CNRatio:AVERage:TCONtrol [:SENSe]:CNRatio:BANDwidth:INTegration [:SENSe]:CNRatio:BANDwidth:NOISe [:SENSe]:CNRatio:OFFSet [:SENSe]:EBWidth:AVERage:COUNt [:SENSe]:EBWidth:AVERage[:STATe] [:SENSe]:EBWidth:AVERage:TCONtrol [:SENSe]:EBWidth:MAXHold:STATe [:SENSe]:EBWidth:FREQuency:SPAN [:SENSe]:EBWidth:XDB [:SENSe]:HDISt:AVERage:COUNt [:SENSe]:HDISt:AVERage[:STATe] [:SENSe]:HDISt:AVERage:TCONtrol [:SENSe]:HDISt:NUMBers [:SENSe]:HDISt:TIME [:SENSe]:HDISt:TIME:AUTO[:STATe] [:SENSe]:OBWidth:AVERage:COUNt [:SENSe]:OBWidth:AVERage [:STATe] [:SENSe]:OBWidth:AVERage:TCONtrol [:SENSe]:OBWidth:MAXHold:STATe [:SENSe]:OBWidth:FREQuency:SPAN [:SENSe]:OBWidth:PERCent [:SENSe]:STATus:ANALyzer? [:SENSe]:STATus:CORRections? [:SENSe]:STATus:DEMod? [:SENSe]:STATus:POWer? [:SENSe]:STATus:TG? [:SENSe]:TOI:AVERage:COUNt [:SENSe]:TOI:AVERage[:STATe] [:SENSe]:TOI:AVERage:TCONtrol Programming Guide for DSA1000A series
Command Quick Reference A-Z [:SENSe]:TOI:FREQuency:SPAN [:SENSe]:TPOWer:AVERage:COUNt [:SENSe]:TPOWer:AVERage[:STATe] [:SENSe]:TPOWer:AVERage:TCONtrol [:SENSe]:TPOWer:MODE [:SENSe]:TPOWer:LLIMit [:SENSe]:TPOWer:RLIMit :SOURce:CORRection:OFFSet :SOURce:FREQuency:OFFSet :SOURce:POWer:LEVel:IMMediate:AMPLitude :SOURce:POWer:MODE :SOURce:POWer:SPAN :SOURce:POWer:STARt :SOURce:POWer:SWEep :SOURce:TRACe:STORref :SOURce:TRACe:REF:STATe :STATus:OPERation:CONDition? :STATus:OPERation:ENABle :STATus:OPERation[:EVENt]? :STATus:PRESet :STATus:QUEStionable:CONDition? :STATus:QUEStionable:ENABle :STATus:QUEStionable[:EVENt]? :SYSTem:COMMunicate:APORt :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess :SYSTem:COMMunicate:LAN[:SELF]:RESet :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STA Te :SYSTem:COMMunicate:LAN[:SELF]:AUToip:ST ATe :SYSTem:COMMunicate:LAN[:SELF]:MANuip:S TATe :SYSTem:COMMunicate:LAN[:SELF]:IP:ADDres s :SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMa sk :SYSTem:COMMunicate:LAN[:SELF]:IP:GATew ay Programming Guide for DSA1000A series T :TRACe[:DATA] :TRACe:MATH:PEAK[:DATA]? :TRACe:MATH:PEAK:POINts? :TRACe:MATH:PEAK:SORT :TRACe:MATH:PEAK:TABLe:STATe :TRACe:MATH:PEAK:THReshold :TRACe:MATH:STATe :TRACe:MATH:A :TRACe:MATH:B :TRACe:MATH:CONSt :TRACe:MATH:TYPE :TRACe<n>:MODE :TRACe:AVERage:CLEar :TRACe:AVERage:COUNt
RIGOL :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSSer ver :SYSTem:COMMunicate:USB[:SELF]:ADDRess :SYSTem:COMMunicate:USB[:SELF]:CLASs :SYSTem:COMMunicate:USB[:SELF]:ADDRess? :SYSTem:COMMunicate:USB[:SELF]:CLASs :SYSTem:CONFigure:INFomation? :SYSTem:CONFigure:MESSage? :SYSTem:DATE :SYSTem:ERRor[:NEXT]? :SYSTem:FSWItch[:STATe] :SYSTem:LANGuage :SYSTem:LKEY :SYSTem:OPTions? :SYSTem:PON:TYPE :SYSTem:PRESet :SYSTem:PRESet:TYPE :SYSTem:PRESet[:USER]:SAVE :SYSTem:PROBe[:STATe] :SYSTem:SPEaker[:STATe] :SYSTem:TIME :SYSTem:VERSion?