SSA3000X Plus Spectrum Analyzer Programming Guide PG0703P_E01A
SIGLENT Contents 1. Programming Overview ...........................................................4 1.1 Remotely Operating the Analyzer ......................................................... 4 1.2 Build Communication ............................................................................ 6 1.3 Remote Control Capabilities ................................................................. 9 2. SCPI Overview ........................................................................13 2.
SIGLENT 5.4 Sweep Subsection................................................................................ 92 5.5 Trace Subsection.................................................................................. 93 5.6 Marker Subsection ............................................................................... 96 5.7 Measurement Subsystem .................................................................... 99 5.8 Trigger Subsection ...........................................................
SIGLENT 1.Programming Overview The Siglent spectrum analyzers features LAN, USB Device, and SIGLENT GPIB_USB module interfaces. By using a computer with these interfaces, and a suitable programming language (and/or NI-VISA software), users can remotely control the analyzer based on SCPI (Standard Commands for Programmable Instruments) command set, Labview and IVI (Interchangeable Virtual Instrument), to interoperate with other programmable instruments.
SIGLENT Figure 1-2 LAN 3. Switch on the analyzer 4. Press button on the front panel System →Interface→LAN to enter the LAN Config function menu. 5. Select the IP Config between Static and DHCP DHCP: the DHCP server in the current network will assign the network parameters automatically (IP address, subnet mask, gate way) for the analyzer. Static: you can set the IP address, subnet mask, gate way manually. Press Apply.
SIGLENT 1.2 Build Communication 1.2.1 Build Communication Using VISA NI-VISA includes a Run-Time Engine version and a Full version. The Run-Time Engine version provides NI device drivers such as USB-TMC, VXI, GPIB, etc. The full version includes the Run-Time Engine and a software tool named NI MAX that provides a user interface to control the device. You can get NI-VISA full version from: http://www.ni.com/download/. After download you can follow the steps below to install it: a.
SIGLENT Set the install path, default path is “C:\Program Files\National Instruments\”, you can change it. Click Next, dialog shown as above. d.Click Next twice, in the License Agreement dialog, select the “ I accept the above 2 License Agreement(s).” ,and click Next, dialog shown as below: e.Click Next to run installation.
SIGLENT Now the installation is complete, reboot your PC. 1.2.2 Build Communication Using Sockets/Telnet Through the LAN interface, VXI-11, Sockets and Telnet protocols can be used to communicate with the spectrum analyzer. VXI-11 is provided in NI-VISA, while Sockets and Telnet are commonly included in PC’s OS initially. Socket LAN is a method used to communicate with the spectrum analyzer over the LAN interface using the Transmission Control Protocol/Internet Protocol (TCP/IP).
SIGLENT 1.3 Remote Control Capabilities 1.3.1 User-defined Programming Users can use SCPI commands to program and control the spectrum analyzer. For details, refer to the introductions in “Programming Examples”. 1.3.2 Send SCPI Commands via NI MAX Users can control the spectrum analyzer remotely by sending SCPI commands via NI-MAX software. NI_MAX is National Instruments Measurement and Automation Explorer.
SIGLENT Run NI MAX software. 1.Click “Device and interface” at the upper left corner of the software; 2.Find the “Network Devices” symbol , click “Add Network Devices”; 3.Select Manual Entry of LAN instrument, select Next, and enter the IP address as shown. Click Finish to establish the connection: NOTE: Leave the LAN Device Name BLANK or the connection will fail. 4.
SIGLENT 5.Right-click on the product and select Open NI-VISA Test Panel: 6.Click “Input/Output” option button and click “Query” option button. If everything is OK, you will see the Read operation information returned as shown below. 1.3.3 EasySpectrum Software Users can control the spectrum analyzer remotely by EasySpectrum. PC software EasySpectrum is an easy-to-use, PC-Windows-based remote control tool for Siglent’s spectrum analyzer. You can download it from Siglent’s website.
SIGLENT 1.3.4 Web Control With the embedded web server, the analyzer can be controlled through LAN from a web browser* on PC and mobile terminals, without any extra driver be installed. This provides remote controlling and monitoring capabilities. Screenshot and firmware update are also supported. *Web browser with HTML5 supported like Google Chrome or Firefox are recommended.
SIGLENT 2.SCPI Overview 2.1 Command Format SCPI commands present a hierarchical tree structure containing multiple subsystems, each of the subsystems is made up of a root keyword and several subkeywords. The command string usually starts with “:”, the keywords are separated by “:” and the followed parameter settings are separated by space. Query commands add “?” at the end of the string.
SIGLENT In the “[:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1” command, the parameters available are “OFF”, “ON”, “0” or “1”. 4. Braces { } The parameters in the braces are optional which can be ignored or set for one or more times. For example: :CALCulate:LLINe[1]|2:DATA ,{,, }, in the command, the {,, } parameters can be ignored or set for one or more times. 2.
SIGLENT 6. Discrete The parameter could only be one of the specified values and these values are discontinuous. For example: [:SENSe]:BWIDth:VIDeo:RATio The parameter could only be one of 0.001, 0.003, 0.01, 0.03, 0.1, 0.3, 1.0, 3.0, 10.0, 30.0, 100.0, 300.0, 1000.0. 2.4 Command Abbreviation All of the commands are not case sensitive, so you can use any of them. But if abbreviation is used, all the capital letters in the command must be written completely.
SIGLENT 3.Commands that are Common to All Modes 3.1 IEEE Common Commands ...................................... 错误!未定义书签。 3.2 System Subsystem .................................................. 错误!未定义书签。 3.3 Memory Subsystem ................................................. 错误!未定义书签。 3.4 Display Subsection .................................................. 错误!未定义书签。 3.5 Mode Subsection...................................................... 错误!未定义书签。 3.
SIGLENT Menu None Example *RST Command Format Instruction *CLS Menu Clears the status byte register. It does this by emptying the error queue and clearing all bits in all of the event registers. The status byte register summarizes the states of the other registers. It is also responsible for generating service requests. None Example *CLS Command Format Instruction Menu *ESE *ESE? Set the bits in the standard event status enable register.
SIGLENT Example *OPC? Command Format Instruction Menu *SRE *SRE? This command enables the desired bits of the service request enable register. The query returns the value of the register, indicating which bits are currently enabled. The default value is 255. None Example *SRE 1 Command Format Instruction *STB Menu None Example *STB Command Format Instruction *WAI This query is used by some instruments for a self test.
SIGLENT 3.
SIGLENT Format :SYSTem:DATE? Instruction Sets system date. Gets system date. String Parameter Type Parameter Range Return year(four digits), month(1~12), date(1~31) String Default None Menu System > date&time Example Sets System date: :SYSTem:DATE 20050101 Gets System date: :SYSTem:DATE? Command Format Instruction :SYSTem:COMMunicate:LAN:IPADdress <“xxx.xxx.xxx.xxx”> :SYSTem:COMMunicate:LAN:IPADdress? Sets a host name for the analyzer in network.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return :SYSTem:COMMunicate:LAN:SMASk <“xxx.xxx.xxx.xxx”> :SYSTem:COMMunicate:LAN:SMASk? Sets the subnet mask according to the PC network Settings. The subnet mask will be set automatically if the IP assignment is set to DHCP. Subnet Mask commands will be effective after using this “APPLy” command. Gets Subnet Mask.
SIGLENT :SYSTem:LANGuage? Command Format Instruction Parameter Type Parameter Range :SYSTem:PON:TYPE DFT|LAST|USER :SYSTem:PON:TYPE? Uses command to set analyzer to power on in default, user, or last state. Gets power on type.
SIGLENT Command Format Instruction Parameter Type Parameter Range :SYSTem:PRESet:TYPE DFT|LAST|USER :SYSTem:PRESet:TYPE? Uses this command to preset the analyzer to default, user, or last state. Gets preset type.
SIGLENT Instruction Sets both the measure and setting parameters to factory preset parameters. Parameter Type Parameter Range Return None Default None Menu System > Pwr/Preset > Factory Reset Example :SYSTem:FDEFault Command Format Instruction :SYSTem:LKEY <“option”>,<“license key”> None None Parameter Type Parameter Range Return Use this command to enable the specified option with the license key, please restart the instrument to make license active.
SIGLENT Range Return None Default None Menu None Example :SYSTem:POWer:OFF Command Format Instruction :SYSTem:CONFigure:SYSTem? Parameter Type Parameter Range Return None Default None Menu System > System Info Example :SYSTem:CONFigure:SYSTem? Use this command to query the system message of the instrument. None String 3.
SIGLENT Instruction Load file Parameter Type Parameter Range Return String Default None Menu File > Open/Load Example :MMEMory:LOAD STA, ”ABC.sta” Command Format Instruction :MMEMory:DELete ”” Parameter Type Parameter Range Return String Default None Menu File > Operate > Delete Example :MMEMory:DELete ”ABC.sta” None None Delete file or folder None None 3.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return :DISPlay:WINDow:TRACe:Y:DLINe:STATe OFF|ON|0|1 :DISPlay:WINDow:TRACe:Y:DLINe:STATe? Toggles the display line between on and off. Gets the display line state. Enumeration OFF|ON|0|1 0|1 Default OFF Menu Display > Display Line Example :DISPlay:WINDow:TRACe:Y:DLINe:STATe ON Command Format Instruction :DISPlay:WINDow:TRACe:Y:DLINe :DISPlay:WINDow:TRACe:Y:DLINe? Sets the amplitude value for the display line.
SIGLENT 4.Spectrum Analyzer 4.1 Frequency Subsection ............................................. 错误!未定义书签。 4.2 Amplitude Subsection ............................................. 错误!未定义书签。 4.3 Sweep Subsection.................................................... 错误!未定义书签。 4.4 Trigger Subsystem ................................................... 错误!未定义书签。 4.5 Bandwidth Subsection ............................................. 错误!未定义书签。 4.6 Trace Subsection..........................................
SIGLENT Parameter Type Parameter Range Return Float, unit: Hz, kHz, MHz, GHz Default 1.6 GHz Menu Frequency > Center Freq Example :FREQuency:CENTer 0.2 GHz Command Format Instruction [:SENSe]:FREQuency:STARt [:SENSe]:FREQuency:STARt? Sets the start frequency of the spectrum analyzer. Gets the start Frequency. Float, unit: Hz, kHz, MHz, GHz Parameter Type Parameter Range Return 50 Hz~3.199999950 GHz Zero Span: 0~3.2 GHz Float, unit: Hz 50 Hz~3.199999950 GHz Zero Span: 0~3.
SIGLENT Return Float, unit: Hz Default 320 MHz Menu Frequency > Freq Step Example :FREQuency:CENTer:STEP 2 MHz Command Format Instruction [:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1 [:SENSe]:FREQuency:CENTer:STEP:AUTO? Specifies whether the step size is set automatically based on the span. Gets center frequency step mode.
SIGLENT Example :FREQuency:OFFSet 1 GHz Command Format Instruction [:SENSe]:FREQuency:SPAN [:SENSe]:FREQuency:SPAN? Sets the frequency span. Setting the span to 0 Hz puts the analyzer into zero span. Gets span value. Float, unit: Hz, kHz, MHz, GHz Parameter Type Parameter Range Return 0 Hz, 100 Hz ~ 3.2GHz Float, unit: Hz Default 1.
SIGLENT Command Format Instruction [:SENSe]:FREQuency:SPAN:PREVious Parameter Type Parameter Range Return None Default None Menu Span > Last Span Example :FREQuency:SPAN:PREVious Command Format Instruction [:SENSe]:FREQuency:SPAN:HALF Parameter Type Parameter Range Return None Default None Menu Span> Zoom In Example :FREQuency:SPAN:HALF Command Format Instruction [:SENSe]:FREQuency:SPAN:DOUBle Parameter Type Parameter Range Return None Default None Menu Span> Zoom Out Example :
SIGLENT [:SENSe]:POWer[:RF]:ATTenuation:AUTO [:SENSe]:POWer[:RF]:GAIN[:STATe] :DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet :UNIT:POWer :DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision [:SENSe]:CORRection:OFF [:SENSe]:CORRection:CSET:ALL[:STATe] [:SENSe]:CORRection:CSET[1]|2|3|4[:STATe] [:SENSe]:CORRection:CSET[1]|2|3|4:ADD [:SENSe]:CORRection:CSET[1]|2|3|4:DELete [:SENSe]:CORRection:CSET[1]|2|3|4:ALL:DELete [:SENSe]:CORRection:CSET[1]|2|3|4:DATA [:SENSe]:CORRection:IMPedance[
SIGLENT Default 20 dB Menu Amplitude > Attenuator Example :POWer:ATTenuation 10 Command Format Instruction [:SENSe]:POWer[:RF]:ATTenuation:AUTO OFF|ON|0|1 [:SENSe]:POWer[:RF]:ATTenuation:AUTO? This command turns on/off auto input port attenuator state. Gets input port attenuator state.
SIGLENT Example :DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet 2 Command Format Instruction :UNIT:POWer DBM|DBMV|DBUV|V|W :UNIT:POWer? Specifies amplitude units for the input, output and display. Gets amplitude units.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return [:SENSe]:CORRection:OFF Turn off the amplitude correction function off and all of the correction sets are off. None None None Default None Menu None Example :SENSe:CORRection:OFF Command Format Instruction [:SENSe]:CORRection:CSET:ALL[:STATe] OFF|ON|0|1 [:SENSe]:CORRection:CSET:ALL[:STATe]? Turns on or off the amplitude corrections. When turned on, only the correction sets that were turned on are enabled.
SIGLENT Command Format Instruction [:SENSe]:CORRection:CSET[1]|2|3|4:ADD Parameter Type Parameter Range Return String Default None Menu Amplitude > Corrections > CorrectionX > Add Point Example :CORRection:CSET2:ADD 10000000,-10,15000000,-12 Command Format Instruction [:SENSe]:CORRection:CSET[1]|2|3|4:DELete Parameter Type Parameter Range Return Serial number of Correction Points Default None Menu Amplitude > Corrections > Correc
SIGLENT Instruction Parameter Type Parameter Range Return Set correction X data 1|2|3|4 Read correction X data. None None String Default None Menu None Example :CORRection:CSET2:DATA? Command Format [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] |OHM75 [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]? Set the input impedance for voltage-to-power conversions. Get the input impedance.
SIGLENT Instruction Parameter Type Parameter Range Return Sets sweep mode. Gets sweep mode. Enumeration AUTO|FFT|SWEep Enumeration Default SWEep Menu Sweep Example :SWEep:MODE SWEep Command Format Instruction [:SENSe]:SWEep:TIME
SIGLENT Parameter Range Return ACCUracy|NORMal Default NORMal Menu Sweep > Sweep Rule Example :SWEep: SPEed NORMal Command Format Instruction [:SENSe]:SWEep:COUNt [:SENSe]:SWEep:COUNt? Sets sweep numbers, when single sweep on. Gets sweep numbers, when single sweep on.
SIGLENT Default None Menu Example :INITiate:IMMediate Command Format Instruction :INITiate:RESTart Parameter Type Parameter Range Return Default Restart the current sweep. :INITiate:RESTart and :INITiate:IMMediate perform exactly the same function. None None None None Menu Example :INITiate:RESTart Command Format Instruction :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Sets continuous sweep mode on-off. Gets continuous sweep mode state.
SIGLENT Parameter Type Parameter Range Return None Default None Menu None Default ABORt None None 4.4 Trigger Subsystem :TRIGger[:SEQuence]:SOURce :TRIGger[:SEQuence]:VIDeo:LEVel :TRIGger[:SEQuence]:RFBurst:SLOPe Command Format Instruction Parameter Type Parameter Range :TRIGger[:SEQuence]:SOURce IMMediate|VIDeo|EXTernal :TRIGger[:SEQuence]:SOURce? Specifies the source (or type) of triggering used to start a measurement. Gets trigger type. Enumeration Return IMMediate: free-run triggering.
SIGLENT Example :TRIGger:VIDeo:LEVel 0.5 dBm Command Format Instruction :TRIGger[:SEQuence]:RFBurst:SLOPe POSitive|NEGative :TRIGger[:SEQuence]:RFBurst:SLOPe? This command activates the trigger condition that allows the next sweep to start when the external voltage (connected to EXT TRIG IN connector) passes through approximately 1.5 volts. The external trigger signal must be a 0V to +5V TTL signal. This function only controls the trigger polarity (for positive or negative-going signals).
SIGLENT Command Format Instruction [:SENSe]:BWIDth[:RESolution]:AUTO OFF|ON|0|1 [:SENSe]:BWIDth[:RESolution]:AUTO? Turns on/off auto resolution bandwidth state. Parameter Type Parameter Range Return Boolean Default ON Menu BW > RBW Example :BWID:AUTO On Command Format Instruction [:SENSe]:BWIDth:VIDeo [:SENSe]:BWIDth:VIDeo? Specifies the video bandwidth.
SIGLENT Instruction Specifies the ratio of the video bandwidth to the resolution bandwidth. Parameter Type Parameter Range Return Discrete, Float Default 1.
SIGLENT :CALCulate[:SELected]:MATH:FUNCtion :TRACe:MATH:X :TRACe:MATH:Y :TRACe:MATH:Z :TRACe:MATH:OFFSet [:SENSe]:FREQuency:TUNE:IMMediate [:SENSe]:DETector:TRACe[1]|2|3|4[:FUNCtion] [:SENSe]:AVERage:TYPE [:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt [:SENSe]:AVERage:TRACe[1]|2|3|4:CLEar Command Format Instruction Parameter Type Parameter Range :TRACe[1]|2|3|4:MODE WRITe|MAXHold|MINHold|VIEW|BLANk|AVERage :TRACe[1]|2|3|4:MODE? Selects the display mode for the selected trace.
SIGLENT Example :TRACe:DATA? 1 Command Format Instruction :FORMat[:TRACe][:DATA] ASCii|REAL :FORMat[:TRACe][:DATA]? Sets trace data type. Gets trace data type.
SIGLENT Example :TRACe:MATH:X A Command Format Instruction :TRACe:MATH:Y A|B|C|D :TRACe:MATH:Y? Sets trace math input Y Gets trace math input Y Enumeration Parameter Type Parameter Range Return A|B|C|D 或 TRACE1|TRACE2|TRACE3|TRACE4 Enumeration Default A Menu Trace > Math > Input Y Example :TRACe:MATH:Y A Command Format Instruction :TRACe:MATH:Z A|B|C|D :TRACe:MATH:Z? Sets trace math Output Z Gets trace math Output Z Enumeration Parameter Type Parameter Range Return A|B|C|D 或 TRACE1|TRACE2|TRA
SIGLENT Command Format Instruction [:SENSe]:FREQuency:TUNE:IMMediate Parameter Type Parameter Range Return None Default None Menu Auto Tune Example :FREQuency:TUNE:IMMediate Command Format [:SENSe]:DETector:TRACe[1]|2|3|4[:FUNCtion] NEGative|POSitive|SAMPle|AVERage|NORMAL|QUASi [:SENSe]:DETector:TRACe[1]|2|3|4[:FUNCtion]? Specifies the detection mode. For each trace interval (bucket), average detection displays the average of all the samples within the interval.
SIGLENT Parameter Type Parameter Range Return Enumeration Default LOGPower Menu BW > Avg Type Example AVERage:TYPE VOLTage Command Format Instruction [:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt [:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt? Specifies the number of measurements that are combined.
SIGLENT :CALCulate:MARKer[1]|2|3|4|5|6|7|8:RELative:TO:MARKer :CALCulate:MARKer[1]|2|3|4|5|6|7|8:X :CALCulate:MARKer[1]|2|3|4|5|6|7|8:Y? :CALCulate:MARKer:TABLe :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:START :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STOP :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:CENTer :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STEP :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:RLEVel :CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:SET]:SPAN :CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:SET]:CENTer :CALCulate
SIGLENT Parameter Type Parameter Range Return Boolean Default OFF Menu Marker Example :CALCulate:MARK1:STATe ON Command Format Instruction :CALCulate:MARKer:AOFF Parameter Type Parameter Range Return None Default None Menu None Example :CALCulate:MARKer:AOFF Command Format Instruction :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE POSition|DELTa|BAND|OFF :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE? Selects the type of markers that you want to activate. Gets the type of markers.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return :CALCulate:MARKer[1]|2|3|4|5|6|7|8:TRACe 1|2|3|4 :CALCulate:MARKer[1]|2|3|4|5|6|7|8:TRACe? This command assigns the specified marker to the designated trace 1, 2, 3 or 4. Gets the specified marker to which trace.
SIGLENT Menu Marker > Normal Example :CALCulate:MARKer4:X 0.4 GHz :CALCulate:MARKer4:X 200 ms :CALCulate:MARKer4:X? Command Format Instruction :CALCulate:MARKer[1]|2|3|4|5|6|7|8:Y? Parameter Type Parameter Range Return This command reads the current Y value for the designated marker. This command can be used to read the results of noise marker.
SIGLENT Default None Menu Marker > M→Start Freq Example :CALCulate:MARKer1:START Command Format Instruction :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STOP Parameter Type Parameter Range Return Sets the stop frequency to the value of the specified marker frequency. This command is not available in zero span . This command is valid when the Marker is on.
SIGLENT Default None Menu Marker > M→CF Step Example :CALCulate:MARKer1:STEP Command Format Instruction :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:RLEVel Parameter Type Parameter Range Return This command sets the reference level equal to the specified marker frequency. This command is valid when the Marker is on.
SIGLENT Default None Menu Marker > △ M→CF Example :CALCulate:MARKer3:DELTa:CENTer Command Format Instruction :CALCulate:MARKer:PEAK:SEARch:MODE MAXimum|MINimum :CALCulate:MARKer:PEAK:SEARch:MODE? This is for the analyzer’s internal peak identification routine to recognize a signal as a peak.
SIGLENT Default -160.0 dBm Menu Peak > Search Config > Peak Threshold Example :CALCulate:MARKer:PEAK:THReshold -50 Command Format Instruction :CALCulate:MARKer:PEAK:EXCursion :CALCulate:MARKer:PEAK:EXCursion? Specifies the minimum signal excursion above the threshold for the internal peak identification routine to recognize a signal as a peak. Float, unit: dB Parameter Type Parameter Range Return 0 ~ 200.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return :CALCulate:MARKer[1]|2|3|4|5|6|7|8:CPEak[:STATe] OFF|ON|0|1 :CALCulate:MARKer[1]|2|3|4|5|6|7|8:CPEak[:STATe]? Toggles the continuous peak search function between on and off. Gets the continuous peak search function state.
SIGLENT Default None Menu Peak > Next Peak Example :CALCulate:MARKer1:MAXimum:NEXT Command Format Instruction :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum:LEFT Parameter Type Parameter Range Return Places the selected marker on the next highest signal peak to the left of the current marked peak.
SIGLENT Parameter Type Parameter Range Return None Default None Menu Peak > Peak Peak Example :CALCulate:MARKer1:CPSearch Command Format Instruction :CALCulate:MARKer[1]|2|3|4|5|6|7|8:FUNCtion OFF|FCOunt|NOISe|NDB :CALCulate:MARKer[1]|2|3|4|5|6|7|8:FUNCtion? This command selects the marker function for the designated marker. Gets the selected marker function for the designated marker. Enumeration Parameter Type Parameter Range None None Return OFF: refers to the normal function.
SIGLENT Parameter Range Return None Default None Menu Marker Fn > Freq Counter Example :CALCulate:MARK:FCOunt:X? Command Format Instruction :CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:RESult? Parameter Type Parameter Range Return None Default None Menu Marker Fn > N dB BW Example :CALCulate:MARK1:BANDwidth:RESult? Command Format Instruction :CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:NDB :CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:NDB? Sets the reference value of N dB bandwidth
SIGLENT Default FREQuency Menu Marker Fn > Read Out Example :CALCulate:MARKer1:X:READout FREQuency Command Format Instruction :CALCulate:MARKer:TRCKing[:STATe] OFF|ON|0|1 :CALCulate:MARKer:TRCKing[:STATe]? This command turns on/off signal track state. Gets signal track state. Boolean Parameter Type Parameter Range Return OFF|ON|0|1 0|1 Default ON Menu Frequency > Signal Track Example :CALCulate:MARKer:TRCKing on 4.
SIGLENT Instruction Sets limit test start.
SIGLENT Range Return 0|1 Default OFF Menu Limit > Limit1|2 Example :CALCulate:LLINe1:STATe OFF Command Format Instruction :CALCulate:LLINe[1]|2:TYPE UPPer|LOWer :CALCulate:LLINe[1]|2:TYPE? Mode sets a limit line to be either an upper or lower type limit line. An upper line will be used as the maximum allowable value when comparing with the data. Gets limit type.
SIGLENT Range Return Float Default 0dBm Menu Limit > Limit1|2 Edit > Amplitude Example :CALCulate:LLINe1:Y 5dBm Command Format Instruction Menu :CALCulate:LLINe[1]|2:DATA ,{,, } :CALCulate:LLINe[1]|2:DATA? Use this command to define the limit points. Gets the defined limit points. X-axis: Float Amplitude: Float X-axis: 0~1.
SIGLENT Default None Menu Limit > Limit1|2 Edit > Del Point Example :CALCulate:LLINe1:DELete 2 Command Format Instruction :CALCulate:LLINe[1]|2:ALL:DELete Parameter Type Parameter Range Return None Default None Menu Limit > Limit1|2 Edit > Del All Example :CALCulate:LLINe2:ALL:DELete Command Format Instruction :CALCulate:LLINe:CONTrol:DOMain FREQuency|TIME :CALCulate:LLINe:CONTrol:DOMain? Toggles the limit X-axis value between frequency and time. Gets the limit X-axis unit.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return :CALCulate:LLINe:FAIL? This query returns the limits pass/failed result. If the test result fails, this command will get result FAIL. If the test result passes, it will get result PASS. None None PASS|FAIL Default None Menu None Example :CALCulate:LLINe:FAIL? Command Format Instruction :CALCulate:LLINe:FAIL:STOP OFF|ON|0|1 :CALCulate:LLINe:FAIL:STOP? Sets whether to stop the test if the test fails.
SIGLENT Command Format Instruction Parameter Type Parameter Range :INSTrument:MEASure OFF|ACPR|CHPower|OBW|TPOWer |SPECtrogram|TOI :INSTrument:MEASure? Sets measure mode. Gets measure mode. Enumeration Return OFF: measure off ACPR: ACPR CHPower: Channel Power OBW: Occupied BW TPOWer: T-POWer SPECtrogram: Spectrogram Monitor TOI: Third-order Intercept Point HARMonics: Harmonic analysis CNR: Carrier Noise Ratio Enumeration Default OFF Menu Measure Example :INSTrument:MEASure ACPR 4.9.
SIGLENT Example INSTrument:MEASure ACPR :ACPRatio:BWIDth:INTegration 20 MHz Command Format Instruction [:SENSe]:ACPRatio:OFFSet:BWIDth[:INTegration] [:SENSe]:ACPRatio:OFFSet:BWIDth[:INTegration]? Specifies the bandwidth used in calculating the power in the adjacent channel. Gets the bandwidth used in calculating the power in the adjacent channel. Float, unit: Hz, kHz, MHz, GHz Parameter Type Parameter Range Return 100 Hz~1.
SIGLENT Command Format Instruction :MEASure:ACPRatio:LOWer:POWer? Parameter Type Parameter Range Return None Default None Menu Meas > ACPR Example :MEASure:ACPRatio:LOWer:POWer? Command Format Instruction :MEASure:ACPRatio:LOWer? Parameter Type Parameter Range Return None Default None Menu Meas > ACPR Example :MEASure:ACPRatio:LOWer? Command Format Instruction :MEASure:ACPRatio:UPPer:POWer? Parameter Type Parameter Range Return None Default None Menu Meas > ACPR Example :MEASur
SIGLENT Instruction Return the upper adjacent channel power to main channel power ratio. Parameter Type Parameter Range Return None Default None Menu Meas > ACPR Example :MEASure:ACPRatio:UPPer? 4.9.
SIGLENT Example :CHPower:FREQuency:SPAN:POWer Command Format Instruction :MEASure:CHPower? Parameter Type Parameter Range Return This command returns scalar results of main channel power, and power density.
SIGLENT 4.9.3 OBW Subsection [:SENSe]:OBWidth:METHod [:SENSe]:OBWidth:PERCent [:SENSe]:OBWidth:XDB :MEASure:OBWidth? :MEASure:OBWidth:OBWidth? :MEASure:OBWidth:CENTroid? :MEASure:OBWidth:OBWidth:FERRor? Command Format Instruction Parameter Type Parameter Range Return [:SENSe]:OBWidth:METHod PERCent|DBC [:SENSe]:OBWidth:METHod? This command toggles the method of OBW measurement between percent and dBc. Gets the method of OBW measurement.
SIGLENT Parameter Type Parameter Range Return bandwidth span. Gets dBc value. Float 0.1~100 Float Default 26 Menu Meas > Occupied BW > Meas Setup > dBc Example :OBWidth:XDB 3 Command Format Instruction :MEASure:OBWidth? Parameter Type Parameter Range Return Use this command to query the occupied bandwidth and bandwidth centroid according to the method you set.
SIGLENT Parameter Type Parameter Range Return None Default None Menu Meas > Occupied BW Example : MEASure:OBW:CENTroid? Command Format Instruction :MEASure:OBWidth:OBWidth:FERRor? Parameter Type Parameter Range Return None Default None Menu Meas > Occupied BW Example :MEASure:OBWidth:OBWidth:FERRor? 4.9.4 None Float, unit: Hz Uses this command to query transmit frequency error.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return [:SENSe]:TPOWer:LLIMit
SIGLENT Command Format Instruction Parameter Type Parameter Range Return [:SENSe]:SPECtrogram:STATe RUN|PAUSe [:SENSe]:SPECtrogram:STATe? Sets spectrogram state. Gets spectrogram state.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return :MEASure:TOI:IP3? Gets the min intercept of the Lower TOI(Lower 3rd) and the Upper TOI(Upper 3rd). None None Float Default None Menu Meas > TOI Example :MEASure:TOI:IP3? 4.9.
SIGLENT Return Float, Unit: Hz Default 3 MHz Menu Meas > CNR > Noise BW Example :CNRatio:BANDwidth:NOISe 1 MHz Command Format Instruction [:SENSe]:CNRatio:OFFSet [:SENSe]:CNRatio:OFFSet? Sets Freq Offset Gets Freq Offset Float, Unit: Hz, kHz, MHz, GHz Parameter Type Parameter Range Return -3.1999999 GHz ~ 3.
SIGLENT Menu Meas > CNR Example :MEASure:CNRatio:CARRier? Command Format Instruction :MEASure:CNRatio:NOISe? Parameter Type Parameter Range Return None Default None Menu Meas > CNR Example :MEASure:CNRatio:NOISe? 4.9.
SIGLENT Instruction Parameter Type Parameter Range Return Set Frequency Step Get Frequency Step Float, Unit: Hz, kHz, MHz, GHz 10M Hz ~ 3.
SIGLENT Parameter Range Return 2 ~ 10 Default 10 Menu Meas > Harmonics > Harmonic Num Example :HARMonics:NUMBer 2 Command Format Instruction [:SENSe]:HARMonics:SELect [:SENSe]:HARMonics:SELect? Sets the Harmonic to be selected. Gets the Harmonic which is selected. Integer It will set select all Harmonics when the parameter is 0 0 ~ 10 Parameter Type Parameter Range Return Integer Integer Default 0 Menu Meas > Harmonics > Select Harmonic Example :HARMonics:SELect 4 4.
SIGLENT Example :OUTPut ON Command Format Instruction :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude] :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]? Sets TG level. Gets TG level. Float, unit: dBm Parameter Type Parameter Range Return 0 dBm ~ -20 dBm Float Default 0 dBm Menu TG > TG Level Example :SOURce:POWer -20 Command Format Instruction :SOURce:CORRection:OFFSet :SOURce:CORRection:OFFSet? Sets TG level offsets. Gets TG level offsets.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return :DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel :DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel? Sets TG normalize reference level. Gets TG normalize reference level.
SIGLENT [:SENSe]:DEMod:TIME [:SENSe]:DEMod:EPHone [:SENSe]:DEMod:VOLume Command Format Instruction Parameter Type Parameter Range Return [:SENSe]:DEMod AM|FM|OFF [:SENSe]:DEMod? Sets demod mode. Gets demod mode. Enumeration AM|FM|OFF Enumeration Default OFF Menu Demod Example :DEMod AM Command Format Instruction [:SENSe]:DEMod:TIME [:SENSe]:DEMod:TIME? Sets demod time. Gets demod time.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return [:SENSe]:DEMod:VOLume [:SENSe]:DEMod:VOLume? Sets volume value. Gets volume value.
SIGLENT 5.Modulation Analyzer 7.1 Frequency Subsection ............................................. 错误!未定义书签。 7.2 Amplitude Subsection ............................................. 错误!未定义书签。 7.3 BW Subsection ......................................................... 错误!未定义书签。 7.4 Sweep Subsection.................................................... 错误!未定义书签。 7.5 Trace Subsection...................................................... 错误!未定义书签。 7.6 Marker Subsection ................................
SIGLENT Range Return Float, unit: Hz Default 10 kHz Menu Frequency > Freq Step Example [:SENSe]:FREQuency:CENTer:STEP[:INCRement] 20 MHz Command Format Instruction [:SENSe]:FREQuency:SPAN? Parameter Type Parameter Range Return Query span The span of modulation analyzer mode is determined by multiple measurement parameters, and can not be set directly. None None Float, unit: Hz Default 31.25 kHz Menu Span > Span Example [:SENSe]:FREQuency:SPAN? 5.
SIGLENT Command Format Instruction Parameter Type Parameter Range Return [:SENSe]:POWer[:RF]:ATTenuation:AUTO OFF|ON|0|1 [:SENSe]:POWer[:RF]:ATTenuation:AUTO? Sets the input attenuator Gets the input attenuator Boolean OFF|ON|0|1 0|1 Default 0 Menu Amplitude > Attenuator Example [:SENSe]:POWer[:RF]:ATTenuation:AUTO ON Command Format Instruction :TRACe1|2|3|4:Y[:SCALe]:RLEVel :TRACe1|2|3|4:Y[:SCALe]:RLEVel? This command sets the reference level for the Y-axis. Gets reference level.
SIGLENT Parameter Range Return Float Default Menu Amplitude > Scale/Div Example :TRACe4:Y:PDIVision 2 Command Format Instruction :TRACe1|2|3|4[:Y]:AUToscale Parameter Type Parameter Range Return None Default None Menu Amplitude > Auto Scale Example :TRACe2:AUToscale Sets auto scale None None 5.
SIGLENT Parameter Type Parameter Range Return Enumeration RECTangular HAMMing : HANNing FLATtop BLACkman None Default Enumeration RECT HAMM HANN FLAT BLAC 100 kHz Menu BW > Window Example :DDEMod:FFT:WINDow:TYPE BLAC 5.4 Sweep Subsection :INITiat[:IMMediate] :INITiate:CONTinuous ABORt Command Format Instruction Parameter Type Parameter Range Return Default :INITiat[:IMMediate] Restart the current sweep. :INITiate:RESTart and :INITiate:IMMediate perform exactly the same function.
SIGLENT Default ON Menu Sweep > Sweep Example :INITiate:CONTinuous OFF Command Format Instruction ABORt This command is used to stop the current measurement. It aborts the currentmeasurement as quickly as possible, resets the sweep and trigger systems, and puts the measurement into an "idle" state. If the analyzer is set for Continuous measurement, it sets up the measurement and initiates a new data measurement sequence with a new data acquisition (sweep)taken once the trigger condition is met.
SIGLENT Return Default 1 Menu Trace > Num of Traces Example :CALCulate:PARameter:COUNt 4 Command Format Instruction :DISPlay:LAYout Parameter Type Parameter Range Return Sets trace layout on screen Currently, one row, two columns are not supported (1, 2) Integer (rows, columns) rows 1 ~ 2 columns 1 ~ 2 Default two rows, two columns Menu Trace > Layout Example :DISPlay:LAYout 2,2 Command Format Instruction :TRACe[1]|2|3|4:DATA:NAME :TRACe[1]|2|3|4:DATA:NAME? Sets trace form
SIGLENT SYMSerrs: Syms/Errs Return Enumeration Default Menu Trace > Format Example :TRACe:DATA:NAME SYMS Command Format Instruction :TRACe[1]|2|3|4:FORMat[:Y] :TRACe[1]|2|3|4:FORMat[:Y]? Sets trace format Gets trace format Enumeration Parameter Type Parameter Range Return MLOG: Log Mag MLINear: Lin Mag REAL: Real IMAGinary: Imag IQ: I-Q CONStln: Constellation IEYE: I-Eye QEYE: Q-Eye WPHAse: Wrap Phase UWPHase: Unwrap Phase TRELlis: Trellis-Eye MLOG MLIN REAL IMAG IQ CONS IEYE QEYE WPHA UWPH TREL
SIGLENT Default None Menu Trace > Copy To Example :TRACe:COPY A,B :TRACe:COPY TRACE1,TRACE2 Command Format Instruction :TRACe:DEMod:EYE:LENGth :TRACe:DEMod:EYE:LENGth? Sets eye length Gets eye length Integer Parameter Type Parameter Range Return 2 ~ 40 Integer Default 2 Menu Trace > Properties Example :TRACe:DEMod:EYE:LENGth 4 Command Format Instruction :TRACe:DEMod:TABLe:FORMat :TRACe:DEMod:TABLe:FORMat? Display format of Symbol Table data Parameter Type Parameter Range Return
SIGLENT Command Format Instruction Parameter Type Parameter Range Return :TRACe[1]|2|3|4:MARKer[1]|2|3|4:ENABle OFF|ON|0|1 :TRACe[1]|2|3|4:MARKer[1]|2|3|4:ENABle? Sets marker state Gets marker state Boolean OFF|ON|0|1 0|1 Default OFF Menu Marker Example :TRACe1:MARKer1:ENABle ON Command Format Instruction :TRACe[1]|2|3|4:MARKer[1]|2|3|4:TYPE POSition|DELTa|OFF :TRACe[1]|2|3|4:MARKer[1]|2|3|4:TYPE? Sets marker mode.
SIGLENT Instruction Gets marker Y value Parameter Type Parameter Range Return None Default None Menu None Example :TRACe:MARKer:Y? Command Format Instruction :TRACe[1]|2|3|4:MARKer[1]|2|3|4:REFerence :TRACe[1]|2|3|4:MARKer[1]|2|3|4:REFerence? Sets reference marker . Gets reference marker Cannot set the current marker to the reference marker.
SIGLENT Parameter Range Return None Default None Menu Marker > All Off Example :CALCulate:MARKer:AOFF None 5.
SIGLENT Return QAM51 QAM10 FSK2 FSK4 FSK8 FSK16 Enumeration Default QAM16 Menu Meas Example :DDEMod:MODulation FSK8 Command Format Instruction [:SENSe]:ADEMod:STYLe [:SENSe]:ADEMod:STYLe? Sets Analog Modulation Type Gets Analog Modulation Type Enumeration Parameter Type Parameter Range Return AM FM Enumeration: AM|FM Default AM Menu Meas Example :ADEMod:STYLe AM Command Format Instruction :DDEMod[:FORMat]:SRATe :DDEMod[:FORMat]:SRATe? Sets Symbol Rate Gets Symbol Rate Integer
SIGLENT Parameter Range Return 4, 6, 8, 10, 12, 14, 16 Default Discrete 4 Menu Meas > Points/Symbol Example DDEMod:SYMBol:POINts 14 Command Format Instruction [:SENSe]:DDEMod[:FORMat]:RLENgth [:SENSe]:DDEMod[:FORMat]:RLENgth? Sets meas length Gets meas length Integer Parameter Type Parameter Range Return 16 ~ 4096 Integer Default 128 Menu Meas > Meas Length Example :DDEMod:RLENgth 200 Command Format Instruction [:SENSe]:DDEMod:FILTer[:MEASurement] [:SENSe]:DDEMod:FILTer[:MEASure
SIGLENT Parameter Range Return Default OFF RRCosine: Root Raised Cosine RCOSine : Raised Cosine GAUSsian HSIN:Half Sine Enumeration Menu ASK, FSK, PSK, QAM Default is RRC MSK Default is GAUS Meas > Ref Filter Example :DDEMod:FILTer:REFerence OFF Command Format Instruction [:SENSe]:STATistic:STATe [:SENSe]:STATistic:STATe? Sets Meas Statistic State Gets Meas Statistic State Boolean Parameter Type Parameter Range Return OFF|ON|0|1 Enumeration Default OFF Menu Meas > Statistic > Statistic Exampl
SIGLENT Parameter Range Return 1 ~ 1000 Default 10 Menu Meas> Statistic > Avg Example :AVERage:COUNt 20 Command Format Instruction :CALCulate:RESTart Parameter Type Parameter Range Return None Default None Menu Meas > Statistic > Restart Meas Example :CALCulate:RESTart Command Format Instruction :READ:DDEMod? Integer Restart measurements None None Read digital demod result If demod type is ASK it will return: 1.ASK err rms (% rms) 2.ASK err peak (% pk) 3.
SIGLENT Parameter Type Parameter Range Return Default 10. frequency error (Hz) 11. IQ offset 12. SNR(MER) (dB) 13. quadrature error (deg) 14. gain imbalance (dB) None None String None Menu Example :READ:DDEMod? 5.
SIGLENT Default 0 dBm Menu Trigger > RF Trigger Example :TRIGger:RF:LEVel 0.
SIGLENT 6.Programming Examples This chapter gives some examples for the programmer. In these examples you can see how to use the VISA or sockets, in combination with the commands have been described above to control the spectrum analyzer. By following these examples, you can develop many more applications. 6.1 Examples of Using VISA 6.1.
SIGLENT Set lib file:project---properties---Linker---Command Line---Additional Options: visa32.lib Include visa.h file: In the projectname.cpp file: #include 3、 Add codes: 1) USBTMC access code: Write a function Usbtmc_test: int Usbtmc_test() { /* This code demonstrates sending synchronous read & write commands */ /* to an USB Test & Measurement Class (USBTMC) instrument using */ /* NI-VISA */ /* The example writes the "*IDN?\n" string to all the USBTMC */ /* devices connected to the system and a
SIGLENT /* Find all the USB TMC VISA resources in our system and store the number of resources in the system in numInstrs.*/ status = viFindRsrc (defaultRM, "USB?*INSTR", &findList, &numInstrs, instrResourceString); if (status
SIGLENT 2) TCP/IP access code: Write a function TCP_IP_Test: int TCP_IP_Test(char *pIP) { char outputBuffer[VI_FIND_BUFLEN]; ViSessiondefaultRM, instr; ViStatusstatus; /* First we will need to open the default resource manager. */ status = viOpenDefaultRM (&defaultRM); if (status
SIGLENT Existing Item. Search for the visa32.bas file in the include folder under the NI-VISA installation path and add the file. This allows the VISA functions and VISA data types to be used in a program. 3、 Add codes: 1) USBTMC access code: Write a function Usbtmc_test: Private Function Usbtmc_test() As Long ' This code demonstrates sending synchronous read & write commands ' to an USB Test & Measurement Class (USBTMC) instrument using ' NI-VISA ' The example writes the "*IDN?\n" string to all the USBTMC
SIGLENT status = viFindRsrc(defaultRM, "USB?*INSTR", findList, numlnstrs, instrResourceString) If (status < VI_SUCCESS) Then resultTxt.Text = "An error occurred while finding resources." viClose (defaultRM) Usbtmc_test = status Exit Function End If ' Now we will open VISA sessions to all USB TMC instruments. ' We must use the handle from viOpenDefaultRM and we must ' also use a string that indicates which instrument to open. This ' is called the instrument descriptor.
SIGLENT Dim count As Long ' First we will need to open the default resource manager. status = viOpenDefaultRM (defaultRM) If (status < VI_SUCCESS) Then resultTxt.Text = "Could not open a session to the VISA Resource Manager!" TCP_IP_Test = status Exit Function End If ' Now we will open a session via TCP/IP device status = viOpen(defaultRM, "TCPIP0::" + ip + "::INSTR", VI_LOAD_CONFIG, VI_NULL, instrsesn) If (status < VI_SUCCESS) Then resultTxt.
SIGLENT modified to D:\USBTMC_TCPIP_Demo. 2、 Click File>>New>>Script in the Matlab interface to create an empty M file 3、 Add codes: 1) USBTMC access code : Write a function Usbtmc_test.
SIGLENT 6.1.4 Example of LabVIEW Environment: Win7 32bit system, LabVIEW 2011 The functions of this example: use the NI-VISA, to control the device with USBTMC and TCP/IP access to do a write and read. Follow the steps to complete the example: 1、 Open LabVIEW, create a VI file. 2、 Add controls. Right-click in the Front Panel interface, select and add VISA resource name, error in, error out and some indicators from the Controls column. 3、 Open the Block Diagram interface.
SIGLENT 7、 Connect them as shown in the figure below 8、 Input the IP address and run the program.
SIGLENT 6.2 Examples of Using Sockets/Telnet 6.2.1 Example of Python Python is an interpreted programming language that lets you work quickly and is very portable.Python has a low-level networking module that provides access to the socket interface.Python scripts can be written for sockets to do a variety of test and measurements tasks. Environment: Win7 32bit system, Python v2.7.5 The functions of this example: Open a socket, sends a query, and closes the socket. It does this loop 10 times.
SIGLENT time.sleep(.300) def main(): global remote_ip global port global count # Body: send the SCPI commands *IDN? 10 times and print the return message s = SocketConnect() for i in range(10): qStr = SocketQuery(s, b'*IDN?') print (str(count) + ":: " + str(qStr)) count = count + 1 SocketClose(s) input('Press "Enter" to exit') if __name__ == '__main__': proc = main() Run result: 6.2.
SIGLENT Type single SCPI commands. Press Enter to send the command. To exit the telnet window click X in the upper-right corner. To get a normal telnet prompt, press Ctrl ] (closing bracket). To get SCPI prompt again, type open 5024. Press Enter: To close the normal telnet window, type Quit and press Enter.