Rigol DSA1000A Series Programming Manual Download Page 16

Page: 16 / 174

RIGOL

Chapter 2 Command Systems

Programming Guide for DSA1000A series

2-2

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.



























Summary of Contents for DSA1000A Series

Page 1: ...RIGOL Programming Guide DSA1000A Series Spectrum Analyzer May 2011 RIGOL Technologies Inc...

Page 2: ......

Page 3: ...al 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 o...

Page 4: ...GOL DSA1000A Series Spectrum Analyzer carefully and gotten familiar with usage of the analyzer The manual contains the following topics Chapter 1 summarizes the remote command programming and lists so...

Page 5: ...ion 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...

Page 6: ...RIGOL Programming Guide for DSA1000A series IV 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...

Page 7: ...s 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...

Page 8: ...ied method of application refer to the User s 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 c...

Page 9: ...defined by IEEE 488 2 and must be executed as well as both the syntax and semanteme of it follows the application of IEEE 488 2 The common command works independently of measurement and is used for co...

Page 10: ...nd 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 BAN...

Page 11: ...r 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 ca...

Page 12: ...here 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 4 Consecutive Real Number The paramet...

Page 13: ...es 1 7 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...

Page 14: ......

Page 15: ...2 ABORt CALCulate CALibration CONFigure COUPle DISPlay FETCh FORMat HCOPy INITiate INPut MMEMory OUTPut READ SENSe SOURce STATus SYSTem TRACe TRIGer UNIT NOTE In this command system a query will retur...

Page 16: ...s 2 2 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 ch...

Page 17: ...00000000 0 and 11111111 255 Remark Double quotation marks would t be returned after a query unless where noted in this manual 3 ESR Syntax ESR Function Queries the standard event status register The...

Page 18: ...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 8 STB Syntax ST...

Page 19: ...Chapter 2 Command Systems RIGOL Programming Guide for DSA1000A series 2 5 ABORt ABORt 1 ABORt Syntax ABORt Function Aborts the current operation and sweeps all over again...

Page 20: ...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 FC...

Page 21: ...Ker 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 C...

Page 22: ...such as 80000000 Explanations The query returns if the returned value is unavailable Front Panel Marker Fctn N dB BW 3 CALCulate LLINe ALL DELete Syntax CALCulate LLINe ALL DELete Function Deletes the...

Page 23: ...req Interp Log Line 6 CALCulate LLINe n STATe Syntax CALCulate LLINe n STATe OFF ON 0 1 CALCulate LLINe n STATe Function Turns on or off the upper lower limit line The query returns 0 or 1 Explanation...

Page 24: ...2 DATA MERG 250 200 1 300 250 1 Explanations Refer to CALCulate LLINe n DATA to get explanation of the parameters in this command 9 CALCulate LLINe n DELete Syntax CALCulate LLINe n DELete Function De...

Page 25: ...earch The query returns 0 or 1 Explanations n is 1 2 3 or 4 The command turns on Marker 1 automatically if none is enabled Default OFF 0 Front Panel Peak Cont Peak On Off 15 CALCulate MARKer n DELTa S...

Page 26: ...z to 100 kHz 1Hz 10Hz 100Hz 1kHz 10kHz 100kHz Sending CALCulate MARKer FCOunt RESolution AUTO can set the resolution mode to Auto Default 1000 1kHz Front Panel Marker Fctn Freq Count Resolution Manual...

Page 27: ...on Function Selects a measurement type for the specified marker The query returns NDB NOIS or OFF Explanations n is 1 2 3 or 4 NDB N dB BW measurement NOISe Noise measurement OFF turns off all measure...

Page 28: ...an or the resolution bandwidth will be ignored When no desired peak is found the system will show No peak found Front Panel Peak Next Peak 25 CALCulate MARKer n MAXimum RIGHt Syntax CALCulate MARKer n...

Page 29: ...3 or 4 POSition Normal DELTa Delta BAND Delta Pair SPAN Span Pair Default POSition Front Panel Marker Normal Delta Delta Pair Span Pair 28 CALCulate MARKer n PEAK EXCursion Syntax CALCulate MARKer n...

Page 30: ...ulate MARKer n PEAK SET CF Syntax CALCulate MARKer n PEAK SET CF Function Executes a peak search and sets the frequency of the current peak to the center frequency of the analyzer Explanations n is 1...

Page 31: ...the reference level of the analyzer according to the current marker amplitude Explanations n is 1 2 3 or 4 In Normal marker mode the reference level is the amplitude at which the marker is located In...

Page 32: ...Step 37 CALCulate MARKer n SET STOP Syntax CALCulate MARKer n SET STOP Function Sets the stop frequency of the analyzer according to the current marker frequency Explanations n is 1 2 3 or 4 In Norma...

Page 33: ...s 1 Explanations 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 Default 1 Front Panel Marker Mkr Trac...

Page 34: ...t 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...

Page 35: ...POSition integer CALCulate MARKer n X POSition Function Sets the position of the Normal marker on the trace such as CALC MARK1 X POSition 100 The query returns 100 Explanations n is 1 2 3 or 4 For the...

Page 36: ...n is 1 2 3 or 4 For the range of param refer to SENSe SWEep POINts 49 CALCulate MARKer n X POSition STOP Syntax CALCulate MARKer n X POSition STOP param CALCulate MARKer n X POSition STOP Function Se...

Page 37: ...d unit input of s default us ms or ks is available Front Panel Marker Span Pair Span 52 CALCulate MARKer n X STARt Syntax CALCulate MARKer n X STARt param CALCulate MARKer n X STARt Function Sets the...

Page 38: ...ncy 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 defa...

Page 39: ...Calibrates immediately Front Panel System Calibrate Cal Now 2 CALibration AUTO Syntax CALibration AUTO OFF ON 0 1 CALibration AUTO Function Enables or disables the Auto calibration The query returns...

Page 40: ...Programming Guide for DSA1000A series 2 26 CONFigure CONFigure ACPower CONFigure CHPower CONFigure CNRatio CONFigure EBWidth CONFigure HDISt CONFigure OBWidth CONFigure PF CONFigure SANalyzer CONFigur...

Page 41: ...hannel Power measurement Explanations The command first restores the system parameters to factory defaults The command interrupts the current measurement and restores the analyzer to the defaults of s...

Page 42: ...igure HDISt Function Enables the Harmonic Distortion measurement Explanations The command first restores the system parameters to factory defaults The command interrupts the current measurement and re...

Page 43: ...nt Panel Preset Meas Meas Fctn Pass Fail 8 CONFigure SANalyzer Syntax CONFigure SANalyzer Function Disables the current measurement and enables the Sweep mode of the anlyzer Explanations The command f...

Page 44: ...on Enables the Time domain Power measurement Explanations The command first restores the system parameters to factory defaults The command interrupts the current measurement and restores the analyzer...

Page 45: ...ax COUPle ALL NONE COUPle Function Sets all related parameters on the basis of their own coupling relation The query returns ALL or NONE Explanations Following parameters are involved CF Step Attenuat...

Page 46: ...NU 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 PDIVi...

Page 47: ...CLOCk STATe Function Sets the clock status The query returns 0 or 1 Explanations This setting is persistent even throuth a power cycle Default ON 1 Front Panel System Time Date Time Date On Off 3 DISP...

Page 48: ...nel Display Menu Hold 3s 5s 10s 20s Infinite 7 DISPlay MSGswitch STATe Syntax DISPlay MSGswitch STATe OFF ON 0 1 DISPlay MSGswitch STATe Function Enabls or disables the message display The query retur...

Page 49: ...en display line the default unit is dBm such as DISP WIN TRAC Y DLIN 10 The query returns 1 000000E 01 Explanations ampl ranges from 100 dBm to 30 dBm Default 0 dBm Front Panel Display Display Line 12...

Page 50: ...Ndow TRACe Y SCALe RLEVel OFFSet rel_ampl DISPlay WINdow TRACe Y SCALe RLEVel OFFSet Function Sets the reference level offset such as DISP WIN TRAC Y SCAL RLEV OFFS 10 The query returns 1 000000E 01 E...

Page 51: ...urce Normalize Norm Ref Lvl 18 DISPlay WINdow TRACe Y SCALe NRPosition Syntax DISPlay WINdow TRACe Y SCALe NRPosition integer DISPlay WINdow TRACe Y SCALe NRPosition Function Sets the reference positi...

Page 52: ...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 H...

Page 53: ...Such as 5 150423E 01 5 173441E 01 2 301865E 01 5 142665E 01 7 757568E 02 2 FETCh ACPower LOWer Syntax FETCh ACPower LOWer Function The query returns the lower channel power Explanations The power unit...

Page 54: ...nsmits the data from the latest measurement to the ouput buffer Return Value Such as 1 599480E 01 7 900511E 01 6 FETCh CHPower CHPower Syntax FETCh CHPower CHPower Function The query returns the chann...

Page 55: ...s 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 FETCh CNRatio CNRatio Function The...

Page 56: ...ut buffer Return Value Such as 1 692102E 01 6 458423E 01 7 509421E 01 7 924328E 01 7 847027E 01 7 885457E 01 7 882358E 01 7 921457E 01 7 923057E 01 7 915358E 01 14 FETCh HARMonics AMPLitude n Syntax F...

Page 57: ...the frequency of specified harmonic in Hz such as FETC HARM FREQ 1 Explanations 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...

Page 58: ...ept Function 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...

Page 59: ...as 8 131735E 01 24 FETCh TPOWer Syntax FETCh TPOWer Function The query returns the Time domain Power measurement result Explanations The unit of the returned value is the same as the unit of Y axis Th...

Page 60: ...FORMat BORDer NORMal SWAPped FORMat BORDer Function Specifies the transmission order of the binary data The query returns NORM or SWAP Default NORMal 2 FORMat TRACe DATA Syntax FORMat TRACe DATA ASCi...

Page 61: ...ming Guide for DSA1000A series 2 47 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 PA...

Page 62: ...lor 3 HCOPy IMAGe INVert Syntax HCOPy IMAGe INVert OFF ON 0 1 HCOPy IMAGe INVert Function Sets if to use inverse print The query returns 0 or 1 Default OFF 0 Front Panel Print Setup Inverted On Off 4...

Page 63: ...tax HCOPy PAGE ORIentation LANDscape PORTrait HCOPy PAGE ORIentation Function Specifies the paper orientation you want to print The query returns LAND or PORT Default LANDscape Front Panel Print Setup...

Page 64: ...series 2 50 The query returns DEF A4 A5 A6 or B5 Default DEFault depends on the printer being used Front Panel Print Setup Page Size Default A4 A5 A6 B5 11 HCOPy RESume Syntax HCOPy RESume Function R...

Page 65: ...Chapter 2 Command Systems RIGOL Programming Guide for DSA1000A series 2 51 INITiate INITiate CONTinuous INITiate IMMediate INITiate PAUSe INITiate RESTart INITiate RESume...

Page 66: ...t in progress Triggers a measurement when measurement is in progress Explanations The analyzer must be in Single measurement mode The command will be ignored if ON is specified by command INITiate CON...

Page 67: ...and Systems RIGOL Programming Guide for DSA1000A series 2 53 Function Switches the instrument from Pause to Wait For Trigger Explanations The command is valid only when a measurement is open Front Pan...

Page 68: ...nce 50 75 INPut IMPedance Function Sets the input impedance for voltage to power conversions Explanations To measure a 75 device you should use a 75 to 50 adapter supplied by RIGOL to connect the anal...

Page 69: ...Formation 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 STO...

Page 70: ...and is invalid if the file you specify does not exist Example MMEM MOVE D 1 csv D 2 csv Front Panel Storage Rename 4 MMEMory LOAD LIMit Syntax MMEMory LOAD LIMit file_name Function Loads the edited li...

Page 71: ...ns Recall 8 MMEMory LOAD STATe Syntax MMEMory LOAD STATe 1 file_name Function Loads the specified status file sta into the analyzer Explanations file_name must contain a valid path The command is inva...

Page 72: ...ified file name bmp Explanations file_name must contain a valid path If the file name specified already exists it will be overwritten Example MMEM STOR SCR E screen bmp Front Panel Print 13 MMEMory ST...

Page 73: ...fied file name csv Explanations file_name must contain a valid path If the file name specified already exists it will be overwritten Example MMEM STOR RES E ACP csv Front Panel Storage File Type Measu...

Page 74: ...eak Table Save 19 MMEMory STORe LIMit Syntax MMEMory STORe LIMit file_name Function Saves the current edited limit line with a specified file name trc or csv Explanations file_name must contain a vali...

Page 75: ...ing Guide for DSA1000A series 2 61 OUTPut OUTPut STATe 1 OUTPut STATe Syntax OUTPut STATe OFF ON 0 1 OUTPut STATe Function Enables or disables the tracking generator output The query returns 0 or 1 De...

Page 76: ...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...

Page 77: ...n Value such as 5 150423E 01 5 173441E 01 2 301865E 01 5 142665E 01 7 757568E 02 2 READ ACPower LOWer Syntax READ ACPower LOWer Function The command executes a measurement and returns the lower channe...

Page 78: ...ectral density Explanations 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 599...

Page 79: ...n Value Such as 6 048788E 01 6 186192E 01 1 374039E 00 9 READ CNRatio CARRier Syntax READ CNRatio CARRier Function The command executes a measurement and returns the carrier power Explanations The pow...

Page 80: ...a measurement and returns the amplitude value of the first ten harmonics at comma intervals and having the same unit as the current amplitude Explanations If there are less than ten harmonics to measr...

Page 81: ...and returns the first ten harmonic frequency values at comma intervals and in Hz The first harmonic is the fundamental wave Explanations The command returns 0 for those unmeasured harmonics if less th...

Page 82: ...s The command transmits the data from the latest measurement to the ouput buffer Return Value Such as 1860000 40000 20 READ OBWidth OBWidth Syntax READ OBWidth OBWidth Function The command executes a...

Page 83: ...735E 01 1500450000 8 131735E 01 8 131735E 01 1500450000 8 131735E 01 8 131735E 01 23 READ TOIntercept IP3 Syntax READ TOIntercept IP3 Function The command executes a measurement and returns the smalle...

Page 84: ...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...

Page 85: ...e 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 CNRati...

Page 86: ...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 SEN...

Page 87: ...Auto function of Resolution bandwidth The query returns 0 or 1 Explanations In Auto mode the resolution bandwidth decreases with the decreasing span The Auto function is invalid in Zero span mode Defa...

Page 88: ...STATe Syntax SENSe CORRection CSET ALL STATe OFF ON 0 1 SENSe CORRection CSET ALL STATe Function Enables or disables the amplitude correction function Only the opened correction factors can be enabled...

Page 89: ...e refer to SENSe CORRection CSET n DATA 10 SENSe CORRection CSET n DELete Syntax SENSe CORRection CSET n DELete Function Deletes the correction settings Explanations n is 1 Antenna 2 Cable 3 Other or...

Page 90: ...tion Turns on or off the correction table The query returns 0 or 1 Default OFF 0 Front Panel AMPT Corrections Corr Table On Off 14 SENSe DEMod Syntax SENSe DEMod AM FM OFF SENSe DEMod Function Sets th...

Page 91: ...FREQuency CENTer freq SENSe FREQuency CENTer Function Sets the center frequency the default unit is Hz such as FREQ CENT 1000000 or FREQ CENT 1MHZ The query returns 1000000 Explanations freq ranges fr...

Page 92: ...CENTer DOWN Syntax SENSe FREQuency CENTer DOWN Function Decreases the center frequency by the specified CF step Front Panel FREQ Channel Reverse 24 SENSe FREQuency SPAN Syntax SENSe FREQuency SPAN fre...

Page 93: ...rrent value Front Panel SPAN Zoom Out 29 SENSe FREQuency STARt Syntax SENSe FREQuency STARt freq SENSe FREQuency STARt Function Sets the start frequency the default unit is Hz such as FREQ STAR 10000...

Page 94: ...Auto function of the attenuator The query returns 0 or 1 Default ON 1 Front Panel AMPT Input Atten Auto Manual 33 SENSe POWer RF GAIN STATe Syntax SENSe POWer RF GAIN STATe OFF ON 0 1 SENSe POWer RF G...

Page 95: ...and amplitude for displaying these signals Front Panel Auto Tune 38 SENSe SWEep POINts Syntax SENSe SWEep POINts number of points SENSe SWEep POINts Function Sets the points obtained in each sweep su...

Page 96: ...ns 1 000000E 01 Explanations time ranges from 20 us to 3000 s Default 10 ms Front Panel Sweep Time 42 SENSe SWEep TIME AUTO Syntax SENSe SWEep TIME AUTO OFF ON 0 1 SENSe SWEep TIME AUTO Function Turns...

Page 97: ...F 0 Front Panel Meas ACP Meas Setup Avg Num On Off 46 SENSe ACPower AVERage TCONtrol Syntax SENSe ACPower AVERage TCONtrol EXPonential REPeat SENSe ACPower AVERage TCONtrol Function Sets the average m...

Page 98: ...ch as ACP BAND ACH 1000000 or ACP BAND ACH 1MHZ The query returns 1000000 Explanations freq ranges from 33 Hz to 1 GHz Default 2 MHz Front Panel Meas ACP Meas Setup Adj CH BW 49 SENSe ACPower CSPacing...

Page 99: ...CONtrol Syntax SENSe CHPower AVERage TCONtrol EXPonential REPeat SENSe CHPower AVERage TCONtrol Function Sets the average mode of the channel power measurement The query returns EXP or REP Explanation...

Page 100: ...000000 or CHP FREQ SPAN 3MHZ The query returns 3000000 Explanations freq ranges from 100 Hz to 3 GHz Default 3 MHz Front Panel Meas Chan Pwr Meas Setup CH Pwr Span 55 SENSe CNRatio AVERage COUNt Synta...

Page 101: ...NSe CNRatio AVERage COUNt measurements Default EXPonential Front Panel Meas C N Ratio Meas Setup Avg Mode Exp Repeat 58 SENSe CNRatio BANDwidth INTegration Syntax SENSe CNRatio BANDwidth INTegration f...

Page 102: ...Setup Offset Freq 61 SENSe EBWidth AVERage COUNt Syntax SENSe EBWidth AVERage COUNt integer SENSe EBWidth AVERage COUNt Function Sets the number of averages of the Emission Bandwidth measurement resul...

Page 103: ...EXPonential Front Panel Meas EBW Meas Setup Avg Mode Exp Repeat 64 SENSe EBWidth MAXHold STATe Syntax SENSe EBWidth MAXHold STATe OFF ON 0 1 SENSe EBWidth MAXHold STATe Function Turns on or off the Ma...

Page 104: ...Explanations integer ranges from 1 to 1000 Default 10 Front Panel Meas Harmo Dist Meas Setup Avg Num 68 SENSe HDISt AVERage STATe Syntax SENSe HDISt AVERage STATe OFF ON 0 1 SENSe HDISt AVERage STATe...

Page 105: ...ry returns 5 Explanations integer ranges from 2 to 10 Default 10 Front Panel Meas Harmo Dist Meas Setup NO of Harmo 71 SENSe HDISt TIME Syntax SENSe HDISt TIME time SENSe HDISt TIME Function Sets the...

Page 106: ...STATe OFF ON 0 1 SENSe OBWidth AVERage STATe Function Turns on or off the average function of the Occupied Bandwidth measurement The query returns 0 or 1 Default OFF 0 Front Panel Meas OBW Meas Setup...

Page 107: ...yntax SENSe OBWidth FREQuency SPAN freq SENSe OBWidth FREQuency SPAN Function Sets the span of the Occupied Bandwidth measurement the default unit is Hz such as OBW FREQ SPAN 1000000 or OBW FREQ SPAN...

Page 108: ...ections Syntax SENSe STATus CORRections Function Quires the correction status Front Panel System Status Corrections 82 SENSe STATus DEMod Syntax SENSe STATus DEMod Function Quires the setting status o...

Page 109: ...ENSe TOI AVERage TCONtrol Function Selects an average mode of the TOI measurement from EXP or REP The query returns EXP or REP Explanations In Exp mode the result is from the exponent average calculat...

Page 110: ...TATe OFF ON 0 1 SENSe TPOWer AVERage STATe Function Turns on or off the average function of the Time domain Power measurement The query returns 0 or 1 Default OFF 0 Front Panel Meas T Power Meas Setup...

Page 111: ...NSe TPOWer LLIMit Function 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 Explanations time ranges from 0 to Righ...

Page 112: ...Guide for DSA1000A series 2 98 SOURce SOURce CORRection OFFSet SOURce FREQuency OFFSet SOURce POWer LEVel IMMediate AMPLitude SOURce POWer MODE SOURce POWer SPAN SOURce POWer STARt SOURce POWer SWEep...

Page 113: ...fault unit is Hz such as SOUR FREQ OFFS 1000000 The query returns 1000000 Explanations freq ranges from 300 MHz to 300 MHz Default 0Hz Front Panel Source Freq Offset 3 SOURce POWer LEVel IMMediate AMP...

Page 114: ...0 dB to 20 dB Default 0 dB Front Panel Source Power Sweep Off Power Range 6 SOURce POWer STARt Syntax SOURce POWer STARt ample SOURce POWer STARt Function Sets the output power of the tracking source...

Page 115: ...urce Power Sweep On Power Range 8 SOURce TRACe STORref Syntax SOURce TRACe STORref Function Save the normalized trace Front Panel Source Normalize Stor Ref 9 SOURce TRACe REF STATe Syntax SOURce TRACe...

Page 116: ...tems Programming Guide for DSA1000A series 2 102 STATus STATus OPERation CONDition STATus OPERation ENABle STATus OPERation EVENt STATus PRESet STATus QUEStionable CONDition STATus QUEStionable ENABle...

Page 117: ...ister such as STAT OPER ENAB 100 The query returns 100 Explanations 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...

Page 118: ...ble ENABle Function Sets the enable register value in the questionable status register such as STAT QUES ENAB 100 The query returns 100 Explanations Bit 15 and bits 12 9 are not used in the Questionab...

Page 119: ...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 S...

Page 120: ...ations integer is an integer within 0 and 30 Default 18 Front Panel System I O Setting GPIB 3 SYSTem COMMunicate LAN SELF RESet Syntax SYSTem COMMunicate LAN SELF RESet Function Resets the LXI and all...

Page 121: ...anations 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 Front Panel System I O Setting LAN Manual IP On IP IP Ad...

Page 122: ...nges from 0 to 223 except 127 and the others range from 0 to 255 Front Panel System I O Setting LAN DNS 11 SYSTem COMMunicate USB SELF ADDRess Syntax SYSTem COMMunicate USB SELF ADDRess Function Views...

Page 123: ...12 29 Explanations year is a four digit figure month is an integer within 01 and 12 day is an integer within 01 and 31 Front Panel System Time Date Set Date 16 SYSTem ERRor NEXT Syntax SYSTem ERRor N...

Page 124: ...option license key Note each option has an unique license key and can only be used in one analyzer Front Panel System License Active 20 SYSTem OPTions Syntax SYSTem OPTions Function The query returns...

Page 125: ...reset Type User Save Preset 25 SYSTem PROBe STATe Syntax SYSTem PROBe STATe OFF ON 0 1 SYSTem PROBe STATe Function Sets the probe status The query returns 0 or 1 Default OFF 0 26 SYSTem SPEaker STATe...

Page 126: ...n Sets the real time of the analyzer clock such as SYSTem TIME 15 50 00 The query returns 15 50 00 Explanations hour is an integer within 00 and 23 minute is an integer within 00 and 59 second is an i...

Page 127: ...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 TR...

Page 128: ...imit line data and lower limit line data respectively when the Pass Fail function is On 2 TRACe MATH PEAK DATA Syntax TRACe MATH PEAK DATA Function Queries the frequency Hz and amplitude has the same...

Page 129: ...isplaying 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 Lin...

Page 130: ...query returns 1 000000E 01 Explanations integer ranges from 300 dB to 300 dB Default 0 dB 11 TRACe MATH TYPE Syntax TRACe MATH TYPE A B A CONST A CONST TRACe MATH TYPE Function Sets the computational...

Page 131: ...rages of the trace such as TRAC AVER COUN 10 The query returns 10 Explanations integer ranges from 1 to 1000 Default 100 Front Panel Trace Avg Num 15 TRACe AVERage COUNt CURRent Syntax TRACe AVERage C...

Page 132: ...ter 2 Command Systems Programming Guide for DSA1000A series 2 118 17 TRACe CLEar ALL Syntax TRACe CLEar ALL Function Clears all traces that is set the type of all traces to BLANK Off Front Panel Trace...

Page 133: ...e 2 TRIGger SEQuence SOURce Syntax TRIGger SEQuence SOURce IMMediate VIDeo EXTernal TRIGger SEQuence SOURce Function Ses the trigger type The query returns IMM VID or EXT Default IMMediate Front Panel...

Page 134: ...120 UNIT UNIT POWer 1 UNIT POWer Syntax UNIT POWer DBM DBMV DBUV V W UNIT POWer Function Sets the unit of the input output and the displayed amplitude The query returns DBM DBMV DBUV V or W Default L...

Page 135: ...chitecture VISA is an API Application Programming Interface for controlling instruments It is convenient for users to develop testing applications which are independent of the types of instrument and...

Page 136: ...tem please refer to Linux Programming Example First make sure your computer has installed VISA library of NI see http www ni com Here we install it in the default path C Program Files IVI Foundation V...

Page 137: ...Chapter 3 Programming Examples RIGOL Programming Guide for DSA1000A series 3 3...

Page 138: ...ly add the file visa32 lib in the Object library modules 3 Choose Tools Options Directories Select Include files in Show directories for and then dblclick the blank in Directories to add the path of I...

Page 139: ...ibrary has been added successfully 4 Add controls Text Edit and Button See figure below 5 Add control variables Open View ClassWizard Member Variables and add the following three variables Instrument...

Page 140: ...ddress 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 strCont...

Page 141: ...r 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 strAd...

Page 142: ...ment void CDemoForDSADlg OnBtConnectInstr Connect to the instrument TODO Add your control notification handler code here ViStatus status ViSession defaultRM ViString expr ViPFindList findList new unsi...

Page 143: ...rInstr 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...

Page 144: ...alse 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 r...

Page 145: ...eps 1 Create a Standard EXE project 2 Choose Project Add File and add the file visa32 bas that contains all VISA functions and constant statements Then add Declare Sub Sleep Lib kernel32 ByVal dwMilli...

Page 146: ...esn 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...

Page 147: ...ing 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...

Page 148: ...ent 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 Strin...

Page 149: ...t 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...

Page 150: ...trument 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...

Page 151: ...IGOL Programming Guide for DSA1000A series 3 17 Program in LabVIEW 8 6 Enter the Labview 8 6 and take the following steps 1 Create the event structure 2 Add the events contain read and write operation...

Page 152: ...RIGOL Chapter 3 Programming Examples Programming Guide for DSA1000A series 3 18 3 Instrument connection codes 4 Write the operation codes contain error judging...

Page 153: ...Chapter 3 Programming Examples RIGOL Programming Guide for DSA1000A series 3 19 5 Read operation codes contain error processing...

Page 154: ...RIGOL Chapter 3 Programming Examples Programming Guide for DSA1000A series 3 20 6 Exit code...

Page 155: ...Chapter 3 Programming Examples RIGOL Programming Guide for DSA1000A series 3 21 7 Execute results...

Page 156: ...i com If not install it following the steps below First download the VISA library NI VISA 4 4 0 ISO from NI website Create a new directory mkdir NI_VISA Mount the iso file mount o loop t iso9660 NI VI...

Page 157: ...e 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 sh...

Page 158: ...RIGOL Chapter 3 Programming Examples Programming Guide for DSA1000A series 3 24...

Page 159: ...t variable LD_LIBRARY_PATH Operation method add the library file path usr local lib to the LD_LIBRARY_PATH viarable in the etc profile file as shown in the figure below Method 2 add the search path of...

Page 160: ...d 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 incl...

Page 161: ...strResult string m_strCommand void makeupper string instr endif 2 Edit the DemoForDSA cpp file to realize various operations of the instrument include visa h include DemoForDSA h DemoForDSA DemoForDSA...

Page 162: ...tRM 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 instr...

Page 163: ...ntent 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 a...

Page 164: ...Addr 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...

Page 165: ...etCount 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 fo...

Page 166: ...ress 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_strCom...

Page 167: ...mand 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 brea...

Page 168: ...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 f...

Page 169: ...r 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 CALCul...

Page 170: ...ACe 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 DISPlay WINdow TRACe Y S...

Page 171: ...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 R...

Page 172: ...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...

Page 173: ...CP 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 SEL...

Page 174: ...k Reference A Z Programming Guide for DSA1000A series 6 TRACe AVERage COUNt CURRent TRACe n AVERage TYPE TRACe CLEar ALL TRIGger SEQuence EXTernal SLOPe TRIGger SEQuence SOURce TRIGger SEQuence VIDeo...

Search results

Summary of Contents for DSA1000A Series

Reviews:

Related manuals for DSA1000A Series

Brands by name

Popular brands

Rigol DSA1000A Series, Programming Manual

Search results

Summary of Contents for DSA1000A Series

Reviews:

Related manuals for DSA1000A Series

Brands by name

Popular brands