SVA1000X Spectrum Analyzer Programming Guide PG0701X-E01A
SIGLENT Contents 1. Programming Overview ...........................................................3 1.1 Remotely Operating the Analyzer ......................................................... 3 1.2 Build Communication ............................................................................ 5 1.3 Remote Control Capabilities ................................................................. 8 2. SCPI Overview ........................................................................12 2.
SIGLENT 1.Programming Overview The Siglent SVA1000X series 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.2Build 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.3Remote 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.System Commands This chapter introduces the Siglent Technologies SVA1000X SCPI commands, include: IEEE Common Commands 3.1 System Subsystem 3.2 Instrument Subsystem 3.3 Initiate Subsystem 3.4 Sense Subsystem 3.5 Calculate Subsystem 3.6 Measurement Subsystem 3.7 Trigger Subsystem 3.8 TG Subsystem 3.9 Demod Subsystem 3.10 Memory Subsystem 3.11 3.1 IEEE Common Commands 3.1.1 Command Format Instruction Menu Example 3.1.2 Command Format Instruction Menu Example 3.1.
SIGLENT Menu Example 3.1.4 Command Format Instruction Menu Example 3.1.5 Command Format Instruction Menu Example 3.1.6 Command Format Instruction Menu Example 3.1.7 Command Format Instruction Menu Example 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.
SIGLENT 3.1.8 Command Format Instruction Menu Example 3.1.9 Command Format Instruction Menu Example Status Byte Query (*STB) *STB This query is used by some instruments for a self test. None *STB Wait-to-Continue (*WAI) *WAI This command causes the instrument to wait until all pending commands are completed before executing any additional commands. There is no query form to the command. None *WAI 3.1.
SIGLENT Parameter Type Parameter Range Return Default Menu Example String year(four digits), month(1~12), date(1~31) String None System > date&time Sets System date: :SYSTem:DATE 20050101 Gets System date: :SYSTem:DATE? 3.2.3 IP Address (:SYSTem:COMMunicate:LAN:IPADdress) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.2.4 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :SYSTem:COMMunicate:LAN:IPADdress <“xxx.xxx.xxx.
SIGLENT Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.2.6 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.2.7 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.2.8 Command Format :SYSTem:COMMunicate:LAN:CONFig:APPLy :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.
SIGLENT Instruction Parameter Type Parameter Range Return Default Menu Example 3.2.9 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example Uses command to set analyzer to power on in default, user, or last state. Gets power on type. Enumeration DFT: Default LAST: Last USER: Custom Configuration Enumeration DFT System > Pwr/Preset > Power On SYSTem:PON:TYPE DFT System Preset (:SYSTem:PRESet) :SYSTem:PRESet Use this command to preset the instrument.
SIGLENT Menu Example System > Pwr/Preset > Preset :SYSTem:PRESet:TYPE DFT 3.2.12 Factory ReSet (:SYSTem:FDEFault) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :SYSTem:FDEFault Sets both the measure and setting parameters to factory preset parameters. None None None None System > Pwr/Preset > Factory Reset :SYSTem:FDEFault 3.2.
SIGLENT Range Return Default Menu Example None None None :SYSTem:POWer:OFF 3.2.16 System Info (:SYSTem:CONFigure:SYSTem?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :SYSTem:CONFigure:SYSTem? Use this command to query the system message of the instrument. None None String None System > System Info :SYSTem:CONFigure:SYSTem? 3.3 Instrument Subsystem 3.3.1 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.3.
SIGLENT Return Default Menu Example SPECtrogram: Spectrogram Monitor TOI: Third-order Intercept Point Enumeration OFF Measure :INSTrument:MEASure ACPR 3.4 Initiate Subsystem 3.4.1 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example Single Sweep (:INITiate[:IMMediate]) :INITiate[:IMMediate] Sets single sweep. None None None None Sweep > Single :INITiate:IMMediate 3.4.
SIGLENT Parameter Type Parameter Range Return Default Menu Example Gets the center frequency. Float, unit: Hz, KHz, MHz, GHz 50 Hz~1.499999950 GHz Zero Span: 0~1.5 GHz Float, unit: Hz 750 MHz Frequency > Center Frequency :FREQuency:CENTer 0.2 GHz 3.5.1.2 Start Frequency ([:SENSe]:FREQuency:STARt) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:FREQuency:STARt [:SENSe]:FREQuency:STARt? Sets the start frequency of the spectrum analyzer.
SIGLENT Default Menu Example 150 MHz Frequency > Freq Step :FREQuency:CENTer:STEP 2 MHz 3.5.1.5 Center Frequency Step Mode ([:SENSe]:FREQuency:CENTer:STEP:AUTO) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [: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 3.5.1.8 Full Span ([:SENSe]:FREQuency:SPAN:FULL) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:FREQuency:SPAN:FULL Sets the frequency span to full scale. None None None None Span > Full Span :FREQuency:SPAN:FULL 3.5.1.9 Zero Span ([:SENSe]:FREQuency:SPAN:ZERO) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:FREQuency:SPAN:ZERO Sets the frequency span to zero span.
SIGLENT Default Menu Example None Span> Zoom In :FREQuency:SPAN:HALF 3.5.1.12 Zoom Out ([:SENSe]:FREQuency:SPAN:DOUBle) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.5.2 [:SENSe]:FREQuency:SPAN:DOUBle Sets the frequency span to double the previous span setting. None None None None Span> Zoom Out :FREQuency:SPAN:DOUBle Auto Tune Subsection 3.5.2.
SIGLENT Return Default Menu Example Float, unit: dBm 0 dBm Amplitude > Ref Level :DISPlay:WINDow:TRACe:Y:RLEVel 20 DBM 3.5.3.2 Input Attenuator ([:SENSe]:POWer[:RF]:ATTenuation) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:POWer[:RF]:ATTenuation [:SENSe]:POWer[:RF]:ATTenuation? Sets the input attenuator of the spectrum analyzer. Gets the input attenuator. Integer 0 dB ~ 31 dB Integer, unit: dB 20 dB Amplitude > Attenuator :POWer:ATTenuation 10 3.
SIGLENT 3.5.3.5 Amplitude OffSets (:DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet ) Command Format Instruction :DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet :DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet? Sets reference offsets. Gets reference offsets. Parameter Type Parameter Range Return Default Menu Example Float -300dB~300dB Float, unit: dB 0dB Amplitude > Ref OffSets :DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet 2 3.5.3.
SIGLENT Format Instruction Parameter Type Parameter Range Return Default Menu Example :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision? This command sets the per-division display scaling for the y-axis when scale type of Y axis is set to Log. Gets Scale/Div when scale type of Y axis is set to Log. Float 1 dB ~ 10 dB Float, unit: dB 10 dB Amplitude > Scale/Div :DISPlay:WINDow:TRACe:Y:PDIVision 10 dB 3.5.3.
SIGLENT Parameter Type Parameter Range Return Default Menu Example Gets the amplitude correction function state. None None 0|1 OFF Amplitude > Corrections > Correction1|2|3|4 :CORRection:CSET2:OFF 3.5.3.12 Set Correction Data ([:SENSe]:CORRection:CSET[1]|2|3|4:DATA) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:CORRection:CSET[1]|2|3|4:DATA [:SENSe]:CORRection:CSET[1]|2|3|4:DATA? Set correction X data 1|2|3|4 Read correction X data.
SIGLENT Parameter Type Parameter Range Return Default Menu Example Discrete 1Hz, 3Hz, 10 Hz, 30 Hz, 100 Hz, 300 Hz, 1 KHz, 3 KHz, 10 KHz, 30 KHz, 100 KHz, 300 KHz, 1 MHz Float, unit: Hz 1 MHz BW > RBW :BWIDth 1 KHz 3.5.4.2 Resolution Bandwidth Auto Mode ([:SENSe]:BWIDth[:RESolution]:AUTO) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:BWIDth[:RESolution]:AUTO OFF|ON|0|1 [:SENSe]:BWIDth[:RESolution]:AUTO? Turns on/off auto resolution bandwidth state.
SIGLENT 3.5.4.5 Video to Resolution Bandwidth Ratio ([:SENSe]:BWIDth:VIDeo:RATio) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:BWIDth:VIDeo:RATio [:SENSe]:BWIDth:VIDeo:RATio? Specifies the ratio of the video bandwidth to the resolution bandwidth. Discrete, Float 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 Float 1.0 BW > VBW/RBW :BWIDth:VIDeo:RATio 30 3.5.4.
SIGLENT Instruction Parameter Type Parameter Range Return Default Menu Example Selects the display mode for the selected trace. Enumeration WRITe: puts the trace in the normal mode, updating the data. MAXHold: displays the highest measured trace value for all the data that has been measured since the function was turned on. MINHold: displays the lowest measured trace value for all the data that has been measured since the function was turned on.
SIGLENT Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.5.7 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. Enumeration NEGative: Negative peak detection displays the lowest sample taken during the interval being displayed.
SIGLENT Parameter Type Parameter Range Return Default Menu Example Integer 1 ~ 999 Integer 1 Trace > Avg Times :AVERage:TRACe1:COUNt 10 3.5.7.3 Average Restart ([:SENSe]:AVERage:TRACe[1]|2|3|4:CLEar) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.5.8 [:SENSe]:AVERage:TRACe[1]|2|3|4:CLEar Restarts the trace average. This command is only available when average is on. None None None None None :AVERage:TRAC1:CLEar Sweep Subsection 3.5.8.
SIGLENT Parameter Range Return Default Menu Example 450us ~ 1500 s Float, unit: s 312.416ms(216.288ms, 192.256ms, 168.224ms, 120.160ms) Sweep > Sweep Time :SWEep:TIME 5s 3.5.8.3 Sweep Time State ([:SENSe]:SWEep:TIME:AUTO) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:SWEep:TIME:AUTO OFF|ON|0|1 [:SENSe]:SWEep:TIME:AUTO? This command turns on/off auto sweep time state. Boolean OFF|ON|0|1 0|1 ON Sweep > Sweep Time :SWEep:TIME:AUTO ON 3.5.8.
SIGLENT 3.5.8.6 QPD Time([:SENSe]:QPD:DWELl:TIME) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.5.9 [:SENSe]:QPD:DWELl:TIME < time > [:SENSe]:QPD:DWELl:TIME? Sets QPD Time Gets QPD Time Float,unit: s、ms、us 0us ~ 10s(qusai-peak: 900us ~ 30ks) Float,unit: s 50ms Sweep > QPD Time :QPD:DWELl:TIME 10s Display Subsection 3.5.9.
SIGLENT 3.5.9.3 Display Line (:DISPlay:WINDow:TRACe:Y:DLINe) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :DISPlay:WINDow:TRACe:Y:DLINe :DISPlay:WINDow:TRACe:Y:DLINe? Sets the amplitude value for the display line. Gets the amplitude value for the display line. Float, unit: dBm Ref Level ~ Ref Level - 100 dBm Float, unit: dBm 0 dBm Display > Display Line :DISPlay:WINDow:TRACe:Y:DLINe -10 3.6 Calculate Subsystem 3.6.1 Marker Subsection 3.6.1.
SIGLENT 3.6.1.3 Marker Mode (:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :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. Enumeration POSition: selects a normal marker that can be positioned on a trace and from which trace information will be generated.
SIGLENT Example :CALCulate:MARKer1:RELative:TO:MARK 3 3.6.1.6 Marker X Value (:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8:X :CALCulate:MARKer[1]|2|3|4|5|6|7|8:X? This command positions the designated marker on its assigned trace at the specified trace X value. The value is in the X-axis units, which can be a frequency or time.
SIGLENT Parameter Type Parameter Range Return Default Menu Example Boolean ON|OFF|0|1 0|1 0 Marker > Marker Table :CALCulate:MARKer:TABLe ON 3.6.1.9 Marker to Start Frequency (:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:START) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:START Sets the start frequency to the value of the specified marker frequency. This command is not available in zero span.
SIGLENT Parameter Type Parameter Range Return Default Menu Example None None None None Marker > M→CF :CALCulate:MARKer1:CENTer 3.6.1.12 Marker to Center Frequency Step (:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STEP) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STEP This command sets the center frequency step equal to the specified marker frequency. This command is not available in zero span.
SIGLENT Parameter Range Return Default Menu Example None None None Marker > △ M→Span :CALCulate:MARKer2:DELTa:SPAN 3.6.1.15 Marker Delta to Center Frequency (:CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:SET]:CENTer) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:SET]:CENTer This command sets the center frequency equal to the specified delta marker frequency.
SIGLENT Type Parameter Range Return Default Menu Example -200.0 dBm~ 200.0 dBm Float, unit: dBm -160.0 dBm Peak > Search Config > Peak Threshold :CALCulate:MARKer:PEAK:THReshold -50 3.6.1.
SIGLENT Example :CALCulate:MARKer1:CPEak ON 3.6.1.21 Peak Search (:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum Performs a peak search based on the search mode settings.
SIGLENT Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer:PEAK:SEARch:MODE :CALCulate:MARKer:PEAK:THReshold :CALCulate:MARKer:PEAK: EXCursion) None None None None Peak > Next Left Peak :CALCulate:MARKer1:MAXimum:LEFT 3.6.1.
SIGLENT Format Instruction Parameter Type Parameter Range Return Default Menu Example :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 OFF: refers to the normal function. FCOunt: refers to the frequency counter function. NOISe: refers to the noise measurement function. NDB: refers to the N dB bandwith function.
SIGLENT Parameter Range Return Default Menu Example None Float None Marker Fn > N dB BW :CALCulate:MARK1:BANDwidth:RESult? 3.6.1.30 N dB Bandwidth Reference Value (:CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:NDB?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :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 measurement.
SIGLENT Return Default Menu Example None None Limit > Test :CALCulate:LLINe:TEST:STARt 3.6.2.2 Limit Test Stop (:CALCulate:LLINe:TEST:STOP) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:LLINe:TEST:STOP Sets limit test stop. None None None None Limit > Test :CALCulate:LLINe:TEST:STOP 3.6.2.
SIGLENT Instruction Parameter Type Parameter Range Return Default Menu Example 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. Enumeration UPPer|LOWer Enumeration The default setting of LINe1 is UPPer, the default setting of LINe2 is LOWer Limit > Limit1|2 Edit > Type :CALCulate:LLINe1: TYPE LOWer 3.6.2.
SIGLENT Return Default Menu Example X-axis: Float Amplitude: Float X-axis: -1Hz Amplitude: 0 dBm Limit > Limit1|2 Edit :CALC:LLINe1:DATA 10000000,-20,20000000,-30 3.6.2.9 Add Limit Point Data (:CALCulate:LLINe[1]|2:DATA) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:LLINe[1]|2:ADD , Add limit point data X-axis: Float Amplitude: Float X-axis: 0~1.
SIGLENT 3.6.2.12 Limit X-axis Unit (:CALCulate:LLINe:CONTrol:DOMain) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :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. Enumeration FREQuency|TIME Enumeration FREQuency Limit > Setup > X Axis :CALCulate:LLINe:CONTrol:DOMain FREQuency 3.6.2.
SIGLENT Type Parameter Range Return Default Menu Example OFF|ON|0|1 0|1 OFF Limit > Setup > Fail to stop :CALCulate:LLINe:FAIL:STOP OFF 3.7 Measurement Subsystem 3.7.1 ACPR Subsection 3.7.1.1 Main Channel ([:SENSe]:ACPRatio:BWIDth:INTegration) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:ACPRatio:BWIDth:INTegration [:SENSe]:ACPRatio:BWIDth:INTegration? Specifies the range of integration used in calculating the power in the main channel.
SIGLENT Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:ACPRatio:OFFSet[:FREQuency]? Sets the space value between the center frequency of main channel power and that of the adjacent channel power. Gets adjacent channel space Float, unit: Hz, KHz, MHz, GHz 100 Hz~700 MHz Float, unit: Hz 3MHz Meas > ACPR > Meas Setup > Adj Chn Space :ACPRatio:OFFSets 20 MHz 3.7.1.
SIGLENT Return Default Menu Example Float, unit: dBm None Meas > ACPR :MEASure:ACPRatio:LOWer? 3.7.1.7 Query Upper Adjacent Channel Power (:MEASure:ACPRatio:UPPer:POWer?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :MEASure:ACPRatio:UPPer:POWer? Return the upper adjacent channel power of ACPR measurement. None None Float, unit: dBm None Meas > ACPR :MEASure:ACPRatio:UPPer:POWer? 3.7.1.
SIGLENT 3.7.2.2 Channel Span ([:SENSe]:CHPower:FREQuency:SPAN:POWer) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:CHPower:FREQuency:SPAN:POWer Sets the analyzer span for the channel power measurement. Be sure the span is set larger than the integration bandwidth. None None None None Meas > Ch Power > Meas Setup > Span :CHPower:FREQuency:SPAN:POWer 3.7.2.
SIGLENT Instruction Parameter Type Parameter Range Return Default Menu Example 3.7.3 This command returns the value of the channel power density in dBm/Hz. None None Float None Meas > Ch Power :MEASure:CHPower:DENSity? OBW Subsection 3.7.3.
SIGLENT Parameter Type Parameter Range Return Default Menu Example span. Gets dBc value. Float 0.1~100 Float 26 Meas > Occupied BW > Meas Setup > dBc :OBWidth:XDB 3 3.7.3.4 Query OBW and Centroid (:MEASure:OBWidth?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :MEASure:OBWidth? Use this command to query the occupied bandwidth and bandwidth centroid according to the method you set. None None Float, unit: Hz None Meas > Occupied BW :MEASure:OBW? 3.7.3.
SIGLENT Default Menu Example None Meas > Occupied BW : MEASure:OBW:CENTroid? 3.7.3.7 Query Transmit Frequency Error (:MEASure:OBWidth:OBWidth:FERRor?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.7.4 :MEASure:OBWidth:OBWidth:FERRor? Uses this command to query transmit frequency error. None None Float, unit: Hz None Meas > Occupied BW :MEASure:OBWidth:OBWidth:FERRor? SubsectionT-power(T-Power) 3.7.4.
SIGLENT 3.7.4.3 T-power Stop Line ([:SENSe]:TPOWer:RLIMit) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:TPOWer:RLIMit
SIGLENT Parameter Type Parameter Range Return Default Menu Example 3.7.6 None None None None Meas > Spectrum Monitor > Meas Setup > Restart :SPECtrogram:RESTart Third-order Intercept Point(TOI) 3.7.6.1 Query Third-order Intercept Point result(:MEASure:TOI?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :MEASure:TOI? Gets the result of Third-order Intercept Point None None Float None Meas > TOI :MEASure:TOI? 3.7.6.
SIGLENT Parameter Range Return Default Menu Example IMMediate: free-run triggering. VIDeo: triggers on the video signal level. EXTernal: allows you to connect an external trigger source. Enumeration IMMediate Trigger :TRIGger:SOURce IMMediate 3.8.
SIGLENT 3.9 TG Subsystem 3.9.1 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example TG On-off (:OUTPut[:STATe]) :OUTPut[:STATe] OFF|ON|0|1 :OUTPut[:STATe]? Sets TG on-off. Gets TG state. Boolean OFF|ON|0|1 0|1 0 TG > TG :OUTPut ON 3.9.2 TG Level (:SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.9.3 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.
SIGLENT Instruction Parameter Type Parameter Range Return Default Menu Example Sets TG normalize on-off. Gets TG normalize state. Boolean OFF|ON|0|1 0|1 0 TG > Normalize > Normalize :CALCulate:NTData ON 3.9.5 TG Normalize Reference Level (:DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel :DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel? Sets TG normalize reference level.
SIGLENT Return Default Menu Example 0|1 0 TG > Normalize > Ref Trace :DISPlay:WINDow:NTTRace ON 3.10 Demod Subsystem 3.10.1 Demod Mode ([:SENSe]:DEMod) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:DEMod AM|FM|OFF [:SENSe]:DEMod? Sets demod mode. Gets demod mode. Enumeration AM|FM|OFF Enumeration OFF Demod :DEMod AM 3.10.
SIGLENT 3.10.4 Volume ([:SENSe]:DEMod:VOLume) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:DEMod:VOLume [:SENSe]:DEMod:VOLume? Sets volume value. Gets volume value. Integer 0 ~ 10 Integer 6 Demod > Volume :DEMod:EPHone ON 3.11 Memory Subsystem 3.11.
SIGLENT Parameter Type Parameter Range Return Default Menu Example String None None None File > Operate > Delete :MMEMory:DELete ABC.
SIGLENT 4.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. 4.1Examples of Using VISA 4.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 4.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 4.2Examples of Using Sockets/Telnet 4.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: 4.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.