SIGLENT Contents Programming Overview ............3 Build Communication ................3 Remote Control Capabilities ..............6 SCPI Overview ................7 Command Format ................... 7 Symbol Instruction ................. 7 Parameter Type ..................8 Command Abbreviation ................. 8 System Commands ..............9 IEEE Common Commands ..............9 System Subsystem ................
SIGLENT 1. Programming Overview SSA3000X Series Spectrum Analyzer support both USB and LAN interfaces. By using these interfaces, in combination with NI-VISA and programming languages, users can remotely control the spectrum analyzer. Through LAN interface, VXI-11, Sockets and Telnet protocols can be used to communicate with the spectrum analyzer. This chapter introduces how to build communication between the spectrum analyzer and the PC.
Page 4
SIGLENT c. The NI-VISA installing dialog is shown above. Click Next to start the installation process. 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).”...
Page 5
SIGLENT e. Click Next to run installation. Now the installation is complete, reboot your PC. 2、 Connect the Instrument Depending on your specific model your spectrum analyzer may be able to communicate with a PC through the USB or LAN interface. This manual takes the USB as an example. (For instructions to communicate with a PC through the LAN interface see the User Manual.) a.
SIGLENT 1.1.2 Build Communication Using Sockets Sockets LAN is a method used to communicate with the spectrum analyzer over the LAN interface using the Transmission Control Protocol/Internet Protocol (TCP/IP). A socket is a fundamental technology used for computer networking and allows applications to communicate using standard mechanisms built into network hardware and operating systems.
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.
SIGLENT 2.3 Parameter Type The parameters in the commands introduced in this manual include 6 types: boolean, enumeration, integer, float, discrete and string. 1, Boolean The parameters in the commands could be “OFF”, “ON”, “0” or “1”. For example : [:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1 Enumeration The parameter could be any of the values listed.
SIGLENT 3. System Commands This chapter introduces the Siglent Technologies SSA3000X SCPI commands, include: IEEE Common Commands System Subsystem Instrument Subsystem Initiate Subsystem Sense Subsystem Calculate Subsystem Measurement Subsystem Trigger Subsystem TG Subsystem Demod Subsystem 3.10 Calibration Subsystem 3.11 3.1 IEEE Common Commands 3.1.1...
Page 10
SIGLENT Instruction 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.
SIGLENT 3.1.8 Status Byte Query (*STB) Command *STB Format Instruction This query is used by some instruments for a self test. Menu None Example *STB 3.1.9 Wait-to-Continue (*WAI) Command *WAI Format Instruction This command causes the instrument to wait until all pending commands are completed before executing any additional commands.
Page 12
SIGLENT Gets System time: :SYSTem:TIME? 3.2.2 System Date (:SYSTem:DATE) Command :SYSTem:DATE <yyyymmdd> Format :SYSTem:DATE? Instruction Sets system date. Gets system date. Parameter String Type Parameter year(four digits), month(1~12), date(1~31) Range Return String Default None Menu System > date&time Example Sets System date: :SYSTem:DATE 20050101 Gets System date: :SYSTem:DATE?
Page 13
SIGLENT 3.2.5 Subnet Mask (:SYSTem:COMMunicate:LAN:SMASk) Command :SYSTem:COMMunicate:LAN:SMASk <“xxx.xxx.xxx.xxx”> Format :SYSTem:COMMunicate:LAN:SMASk? Instruction 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. Parameter String Type Parameter Conform to the IP standard (0-255:0-255:0-255:0-255) Range Return...
Page 14
SIGLENT 3.2.8 Power On Type (:SYSTem:PON:TYPE) Command :SYSTem:PON:TYPE DFT|LAST|USER Format :SYSTem:PON:TYPE? Instruction Uses command to set analyzer to power on in default, user, or last state. Gets power on type. Parameter Enumeration Type Parameter DFT: Default Range LAST: Last USER: Custom Configuration Return Enumeration Default...
Page 15
Use this command to enable the specified option with the license key. Parameter “option”: Enumeration Type “ license key”: String Parameter “option”: Meas|EMI|CAT|TG Range “ license key”: provided by Siglent Technologies, 16 bits String. Return None Default None Menu System > System Info > Load Option Example :SYSTem:LKEY EMI,fjbdajffnklmgwno 3.2.13 Installed Options Query (:SYSTem:OPTions?)
SIGLENT Parameter None Type Parameter None Range Return String Default None Menu System > System Info Example :SYSTem:CONFigure:SYSTem? 3.3 Instrument Subsystem 3.3.1 Instrument Mode (:INSTrument[:SELect]) Command :INSTrument[:SELect] SA|EMI|CAT Format :INSTrument[:SELect]? Instruction Sets instrument mode. Parameter Enumeration Type Parameter SA: Spec Analyzer Range EMI: EMI CAT: Reflection Meas...
SIGLENT 3.4 Initiate Subsystem Single Sweep (:INITiate[:IMMediate]) 3.4.1 Command :INITiate[:IMMediate] Format Instruction Sets single sweep. Parameter None Type Parameter None Range Return None Default None Menu Sweep > Single Example :INITiate:IMMediate 3.4.2 Continuous or Single Sweep (:INITiate:CONTinuous) Command :INITiate:CONTinuous OFF|ON|0|1 Format :INITiate:CONTinuous? Instruction...
Page 18
SIGLENT Default 1.6 GHz(1.5 GHz, 1.05 GHz, 0.9 GHz, 0.75 GHz, 0.5 GHz) Menu Frequency > Center Frequency Example :FREQuency:CENTer 0.2 GHz 3.5.1.2 Start Frequency ([:SENSe]:FREQuency:STARt) Command [:SENSe]:FREQuency:STARt <freq> Format [:SENSe]:FREQuency:STARt? Instruction Sets the start frequency of the spectrum analyzer. Gets the start Frequency.
Page 19
SIGLENT 3.5.1.5 Center Frequency Step Mode ([:SENSe]:FREQuency:CENTer:STEP:AUTO) Command [:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1 Format [:SENSe]:FREQuency:CENTer:STEP:AUTO? Instruction Specifies whether the step size is set automatically based on the span. Gets center frequency step mode. Parameter Boolean Type Parameter OFF|ON|0|1 Range Return Default Menu Frequency > Freq Step Example :FREQuency:CENTer:STEP:AUTO OFF 3.5.1.6 Sets CF→Step ([:SENSe]:FREQuency:CENTer:SET:STEP)
Page 20
SIGLENT Type Parameter None Range Return None Default None Menu Span > Full Span Example :FREQuency:SPAN:FULL 3.5.1.9 Zero Span ([:SENSe]:FREQuency:SPAN:ZERO) Command [:SENSe]:FREQuency:SPAN:ZERO Format Instruction Sets the frequency span to zero span. Parameter None Type Parameter None Range Return None Default None Menu Span >...
Page 21
SIGLENT 3.5.1.12 Zoom Out ([:SENSe]:FREQuency:SPAN:HALF) Command [:SENSe]:FREQuency:SPAN:HALF Format Instruction Sets the frequency span to double the previous span setting. Parameter None Type Parameter None Range Return None Default None Menu Span> Zoom Out Example :FREQuency:SPAN:HALF Auto Tune Subsection 3.5.2 3.5.2.1 Auto Tune ([:SENSe]:FREQuency:TUNE:IMMediate) Command [:SENSe]:FREQuency:TUNE:IMMediate Format...
Page 22
SIGLENT 3.5.3.2 Input Attenuator ([:SENSe]:POWer[:RF]:ATTenuation) Command [:SENSe]:POWer[:RF]:ATTenuation <value> Format [:SENSe]:POWer[:RF]:ATTenuation? Instruction Sets the input attenuator of the spectrum analyzer. Gets the input attenuator. Parameter Integer Type Parameter 0 dB ~ 51 dB Range Return Integer, unit: dB Default 20 dB Menu Amplitude >...
Page 23
SIGLENT Instruction Sets reference offsets. Gets reference offsets. Parameter Float Type Parameter -300dB~300dB Range Return Float, unit: dB Default Menu Amplitude > Ref OffSets Example :DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet 2 3.5.3.6 Amplitude Units (:UNIT:POWer) Command :UNIT:POWer DBM|DBMV|DBUV|V|W Format :UNIT:POWer? Instruction Specifies amplitude units for the input, output and display. Gets amplitude units.
Page 24
SIGLENT Parameter 1 dB ~ 10 dB Range Return Float, unit: dB Default 10 dB Menu Amplitude > Scale/Div Example :DISPlay:WINDow:TRACe:Y:PDIVision 10 dB 3.5.3.9 Correction Off ([:SENSe]:CORRection:OFF) Command [:SENSe]:CORRection:OFF Format Instruction Turn off the amplitude correction function off and all of the correction sets are off.
Page 25
SIGLENT Default Menu Amplitude > Corrections > Correction1|2|3|4 Example :CORRection:CSET2:OFF 3.5.3.12 Set Correction Data ([:SENSe]:CORRection:CSET[1]|2|3|4:DATA) Command [:SENSe]:CORRection:CSET[1]|2|3|4:DATA <x1,y1,x2,y2;…> Format [:SENSe]:CORRection:CSET[1]|2|3|4:DATA? Instruction Set correction X data 1|2|3|4 Read correction X data. Parameter None Type Parameter None Range Return String Default None Menu None Example...
Page 26
SIGLENT 3.5.3.15 Input Impedance ([:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]) Command [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] OHM50 |OHM75 Format [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]? Instruction Set the input impedance for voltage-to-power conversions. Get the input impedance. Parameter Enumeration Type Parameter OHM50 |OHM75 Range Return OHM50 |OHM75 Default OHM50 Menu Amplitude > Corrections Example CORRection:IMPedance? Bandwidth Subsection 3.5.4...
Page 27
SIGLENT 3.5.4.3 Video Bandwidth ([:SENSe]:BWIDth:VIDeo) Command [:SENSe]:BWIDth:VIDeo <freq> Format [:SENSe]:BWIDth:VIDeo? Instruction Specifies the video bandwidth. Parameter Discrete Type Parameter 1 Hz, 3 Hz, 10 Hz, 30 Hz, 100 Hz, 300 Hz, 1 KHz, 3 KHz, 10 KHz, 30 KHz, 100 Range KHz, 300 KHz, 1 MHz Return...
Page 28
SIGLENT Type Parameter None Range Return Default Menu None Example :BWIDth:VIDeo:RATio:CONfig? 3.5.5 Trace Subsection 3.5.5.1 Trace mode (:TRACe[1]|2|3|4:MODE) Command :TRACe[1]|2|3|4:MODE WRITe|MAXHold|MINHold|VIEW|BLANk|AVERage Format :TRACe[1]|2|3|4:MODE? Instruction Selects the display mode for the selected trace. Parameter Enumeration Type Parameter WRITe: puts the trace in the normal mode, updating the data. Range MAXHold: displays the highest measured trace value for all the data that has been measured since the function was turned on.
Page 29
SIGLENT example:X-Y+Ref->Z can not write as X-Y+R->Z. Parameter Enumeration Type Parameter Off: turns off the trace math function. Range X-Y+Ref->Z: math variable X minus math variable Y and add reference level then to output trace. Y-X+Ref->Z: math variable Y minus math variable X and add reference level then to output trace.
Page 30
SIGLENT Parameter Enumeration Type Parameter A|B|C Range Return Enumeration Default Menu Trace > Math > Output Example :TRACe:MATH:Z A 3.5.5.7 Trace Math Const (:TRACe:MATH:CONSt) Command :TRACe:MATH:CONSt <const> Format :TRACe:MATH:CONSt? Instruction Sets trace math const. Gets trace math const. Parameter Enumeration Type Parameter -300dB ~300 dB...
Page 31
SIGLENT weighted based on the repetition frequency of the spectral components making up the signal. That is to say, the result of a quasi-peak measurement depends on the repetition rate of the signal. Return Enumeration Default POSitive Menu Detect Example :DETector:TRAC1 AVERage Average Subsection 3.5.7...
Page 32
SIGLENT Default None Menu None Example :AVERage:TRAC1:CLEar 3.5.8 Sweep Subsection 3.5.8.1 Sweep Mode ([:SENSe]:SWEep:MODE) Command [:SENSe]:SWEep:MODE AUTO|FFT|SWEep Format [:SENSe]:SWEep: MODE? Instruction Sets sweep mode. Gets sweep mode. Parameter Enumeration Type Parameter AUTO|FFT|SWEep Range Return Enumeration Default SWEep Menu Sweep Example :SWEep:MODE SWEep 3.5.8.2 Sweep Time ([:SENSe]:SWEep:TIME) Command...
Page 33
SIGLENT 3.5.8.4 Sweep Speed ([:SENSe]:SWEep:SPEed) Command [:SENSe]:SWEep:SPEed NORMal|ACCUracy Format [:SENSe]:SWEep:SPEed? Instruction Toggles the sweep speed between normal and accuracy. Parameter Enumeration Type Parameter ACCUracy|NORMal Range Return Enumeration Default NORMal Menu Sweep > Sweep Rule Example :SWEep: SPEed NORMal 3.5.8.5 Sweep Numbers ([:SENSe]:SWEep:COUNt) Command [:SENSe]:SWEep:COUNt <integer>...
SIGLENT Format :DISPlay:WINDow:TRACe:Y:DLINe:STATe? Instruction Toggles the display line between on and off. Gets the display line state. Parameter Enumeration Type Parameter OFF|ON|0|1 Range Return Default Menu Display > Display Line Example :DISPlay:WINDow:TRACe:Y:DLINe:STATe ON 3.5.9.3 Display Line (:DISPlay:WINDow:TRACe:Y:DLINe) Command :DISPlay:WINDow:TRACe:Y:DLINe <value> Format :DISPlay:WINDow:TRACe:Y:DLINe? Instruction...
Page 35
SIGLENT Format Instruction Turn all the markers off. Parameter None Type Parameter None Range Return None Default None Menu None Example :CALCulate:MARKer:AOFF 3.6.1.3 Marker Mode (:CALCulate:MARKer[1]|2|3|4:MODE) Command :CALCulate:MARKer[1]|2|3|4:MODE POSition|DELTa|BAND|OFF Format :CALCulate:MARKer[1]|2|3|4:MODE? Instruction Selects the type of markers that you want to activate. Gets the type of markers.
Page 36
SIGLENT 3.6.1.5 Marker Relative To (:CALCulate:MARKer[1]|2|3|4:RELative:TO) Command :CALCulate:MARKer[1]|2|3|4:RELative:TO:MARKer 1|2|3|4 Format :CALCulate:MARKer[1]|2|3|4:RELative:TO:MARKer? Instruction Sets marker relative to. Gets marker relative to. Parameter Enumeration Type Parameter 1|2|3|4 Range Return Enumeration Default Menu Marker > Relative To Example :CALCulate:MARKer1:RELative:TO:MARK 3 3.6.1.6 Marker X Value (:CALCulate:MARKer[1]|2|3|4:X) Command :CALCulate:MARKer[1]|2|3|4:X <para>...
Page 37
SIGLENT When the readout mode is frequency, the query returns the X value of the span of the marker in integer and the unit is “Hz”. When the readout mode is time or period, the query returns the X value of the span of the marker in scientific notation and the unit is “s”.
Page 38
SIGLENT When the readout mode is time or period, the query returns the X value of the span of the marker in scientific notation and the unit is “s”. Reference Command: :CALCulate:MARKer[1]|2|3|4:X:READout Parameter Frequency: Float, unit: Hz, KHz, MHz, GHz, Default “Hz” Type Time: Float, unit: us, ms, s, ks, Default “s”...
Page 39
SIGLENT Example :CALCulate:MARKer1:Y? Return: -25 3.6.1.12 Reference Marker Y Value (:CALCulate:MARKer[1]|2|3|4:Y:REFerence?) Command :CALCulate:MARKer[1]|2|3|4:Y:REFerence? Format Instruction Gets the current Y value for the designated reference marker. This command only can be used when marker mode is DELTa|BAND, Reference Command: :CALCulate:MARKer[1]|2|3|4:MODE Parameter None Type Parameter...
Page 40
SIGLENT Default Menu Marker > Marker Table Example :CALCulate:MARKer:TABLe ON 3.6.1.15 Marker to Start Frequency (:CALCulate:MARKer[1]|2|3|4[:SET]:START) Command :CALCulate:MARKer[1]|2|3|4[:SET]:START Format Instruction Sets the start frequency to the value of the specified marker frequency. This command is not available in zero span. If the Marker is OFF, it will set the marker on center.
Page 41
SIGLENT Default None Menu Marker > M→CF Example :CALCulate:MARKer1:CENTer 3.6.1.18 Marker to Center Frequency Step (:CALCulate:MARKer[1]|2|3|4[:SET]:STEP) Command :CALCulate:MARKer[1]|2|3|4[:SET]:STEP Format Instruction This command sets the center frequency step equal to the specified marker frequency. This command is not available in zero span. If the Marker is OFF, it will set the marker on center.
Page 42
SIGLENT Menu Marker > △ M→Span Example :CALCulate:MARKer2:DELTa:SPAN 3.6.1.21 Marker Delta to Center Frequency (:CALCulate:MARKer[1]|2|3|4:DELTa[:SET]:CENTer) Command :CALCulate:MARKer[1]|2|3|4:DELTa[:SET]:CENTer Format Instruction This command sets the center frequency equal to the specified delta marker frequency. This command can be only used in DELTa|BAND marker mode, Reference Command:CALCulate:MARKer[1]|2|3|4:MODE Parameter None...
Page 43
SIGLENT Default -160.0 dBm Menu Peak > Search Config > Peak Threshold Example :CALCulate:MARKer:PEAK:THReshold -50 3.6.1.24 Peak Excursion (:CALCulate:MARKer:PEAK:EXCursion) Command :CALCulate:MARKer:PEAK:EXCursion <value> Format :CALCulate:MARKer:PEAK:EXCursion? Instruction Specifies the minimum signal excursion above the threshold for the internal peak identification routine to recognize a signal as a peak. Parameter Float, unit: dB Type...
Page 44
SIGLENT 3.6.1.27 Peak Search (:CALCulate:MARKer[1]|2|3|4:MAXimum) Command :CALCulate:MARKer[1]|2|3|4:MAXimum Format Instruction Performs a peak search based on the search mode settings. (based on the search mode settings, include: peak search mode, peak threshold and peak excursion, Reference Commands: :CALCulate:MARKer:PEAK:SEARch:MODE :CALCulate:MARKer:PEAK:THReshold :CALCulate:MARKer:PEAK: EXCursion) Parameter None Type...
Page 45
SIGLENT Type Parameter None Range Return None Default None Menu Peak > Next Left Peak Example :CALCulate:MARKer1:MAXimum:LEFT 3.6.1.30 Marker Peak Right Search (:CALCulate:MARKer[1]|2|3|4:MAXimum:RIGHt) Command :CALCulate:MARKer[1]|2|3|4:MAXimum:RIGHt Format Instruction Places the selected marker on the next highest signal peak to the right of the current marked peak.
Page 46
SIGLENT Parameter OFF: refers to the normal function. Range FCOunt: refers to the frequency counter function. NOISe: refers to the noise measurement function. NDB: refers to the N dB bandwith function. Return Enumeration Default Menu Marker Fn Example :CALCulate:MARK1:FUNCtion FCOunt 3.6.1.33 Query Frequency Counter (:CALCulate:MARKer[1]|2|3|4:FCOunt:X?) Command...
Page 47
SIGLENT Default -3 dB Menu Marker Fn > N dB BW Example :BANDwidth:NDB :CALCulate:MARK1 10 DB 3.6.1.36 Marker X-Axis Read Out (:CALCulate:MARKer[1]|2|3|4:X:READout) Command :CALCulate:MARKer[1]|2|3|4:X:READout FREQuency|TIME|PERiod Format :CALCulate:MARKer[1]|2|3|4:X:READout? Instruction Toggles the marker X-Axis readout between frequency, time and period. Gets the marker X-Axis readout type. Parameter Enumeration Type...
Page 48
SIGLENT 3.6.2.3 Gets Limit Test State (:CALCulate:LLINe:TEST:STATe?) Command :CALCulate:LLINe:TEST:STATe? Format Instruction Gets limit test state. Parameter None Type Parameter None Range Return Default Menu Limit > Test Example :CALCulate:LLINe:TEST:STOP 3.6.2.4 Limit Line State (:CALCulate:LLINe[1]|2:STATe) Command :CALCulate:LLINe[1]|2:STATe OFF|ON|0|1 Format :CALCulate:LLINe[1]|2:STATe? Instruction Sets limit line state.
Page 49
SIGLENT Type Parameter LINE|POINt Range Return Enumeration Default LINE Menu Limit > Limit1|2 Edit > Mode Example :CALCulate:LLINe1: MODE POINt 3.6.2.7 Limit Line Y-axis Value (:CALCulate:LLINe[1]|2:Y) Command :CALCulate:LLINe[1]|2:Y <value> Format :CALCulate:LLINe[1]|2:Y? Instruction Sets the Y-axis value of a limit line. Limit line Y-axis value is set independently and is not affected by the X-axis units.
Page 50
SIGLENT Amplitude: 0 dBm Menu Limit > Limit1|2 Edit Example :CALCulate:LLINe1:ADD 10000000,-20 3.6.2.10 Delete Assigned Limit Point (:CALCulate:LLINe[1]|2:DELete) Command :CALCulate:LLINe[1]|2:DELete <number> Format Instruction Use this command to delete the assigned limit point. Parameter Integer Type Parameter None Range Return None Default None Menu...
SIGLENT Format :CALCulate:LLINe:CONTrol:BEEP? Instruction Use this command to turn on/off the limit beep status. Gets limit beep state. Parameter Boolean Type Parameter OFF|ON|0|1 Range Return Default Menu Limit > Setup > Buzzer Example :CALCulate:LLINe:CONTrol:BEEP OFF 3.6.2.14 Query Limits Result (:CALCulate:LLINe:FAIL?) Command :CALCulate:LLINe:FAIL? Format...
Page 52
SIGLENT Format [:SENSe]:ACPRatio:BWIDth:INTegration? Instruction Specifies the range of integration used in calculating the power in the main channel. Gets the range of integration used in calculating the power in the main channel. Parameter Float, unit: Hz, KHz, MHz, GHz Type Parameter 100 Hz~3.2 GHz(3.0 GHz, 2.1 GHz, 1.8 GHz, 1.5 GHz, 1.0 GHz) Range...
Page 53
SIGLENT Type Parameter None Range Return Float, unit: dBm Default None Menu Meas > ACPR Example :MEASure:ACPRatio:MAIN? 3.7.1.5 Query Lower Adjacent Channel Power (:MEASure:ACPRatio:LOWer:POWer?) Command :MEASure:ACPRatio:LOWer:POWer? Format Instruction Return the lower adjacent channel power of ACPR measurement. Parameter None Type Parameter None Range...
Page 54
SIGLENT Example :MEASure:ACPRatio:UPPer:POWer? 3.7.1.8 Query Upper Adjacent Channel Power Ratio (:MEASure:ACPRatio:UPPer?) Command :MEASure:ACPRatio:UPPer? Format Instruction Return the upper adjacent channel power to main channel power ratio. Parameter None Type Parameter None Range Return Float Default None Menu Meas > ACPR Example :MEASure:ACPRatio:UPPer? 3.7.2...
Page 55
SIGLENT 3.7.2.3 Query Channel Power and Power Spectral Density (:MEASure:CHPower?) Command :MEASure:CHPower? Format Instruction This command returns scalar results of main channel power, and power density. Parameter None Type Parameter None Range Return Float, Channel Power unit: dBm Float, Density unit: dBm/Hz Default None Menu...
Page 56
SIGLENT Instruction This command toggles the method of OBW measurement between percent and dBc. Gets the method of OBW measurement. Parameter Enumeration Type Parameter PERCent|DBC Range Return Enumeration Default PERCent Menu Meas > Occupied BW > Meas Setup > Method Example :OBW:METHod PERCent 3.7.3.2 Set Percentage(%) Method of OBW...
Page 57
SIGLENT Parameter None Type Parameter None Range Return Float, unit: Hz Default None Menu Meas > Occupied BW Example :MEASure:OBW? 3.7.3.5 Query OBW (:MEASure:OBWidth:OBWidth?) Command :MEASure:OBWidth:OBWidth? Format Instruction Use this command to query the occupied bandwidth according to the method you set.
Page 58
SIGLENT Menu Meas > Occupied BW Example :MEASure:OBWidth:OBWidth:FERRor? 3.7.4 SubsectionT-power(T-Power) 3.7.4.1 T-power Center Frequency ([:SENSe]:TPOWer:FREQuency:CENTer) Command [:SENSe]:TPOWer:FREQuency:CENTer <freq> Format [:SENSe]:TPOWer:FREQuency:CENTer? Instruction Sets T-power center frequency. Gets T-power center frequency. Parameter Float, unit: Hz, KHz, MHz, GHz Type Parameter 50 Hz~3.199999950 GHz(2.999999950 GHz, 2.099999950 GHz, 1.799999950 Range GHz, 1.499999950 GHz, 0.999999950 GHz) Zero Span: 0~3.2 GHz(3.0 GHz, 2.1 GHz, 1.8 GHz, 1.5 GHz, 1.0 GHz)
Page 59
SIGLENT 3.7.4.4 Query T-power (:MEASure:TPOWer?) Command :MEASure:TPOWer? Format Instruction Query the result of T-power measurement. Parameter Float, unit: dBm Type Parameter None Range Return Float, unit: dBm Default None Menu Meas > T-power Example :MEASure:TPOWer? Spectrum Monitor(SPECtrogram) 3.7.5 3.7.5.1 Spectrogram state([:SENSe]:SPECtrogram:STATe) Command [:SENSe]:SPECtrogram:STATe RUN|PAUSe Format...
SIGLENT Format Instruction Gets the result of Third-order Intercept Point Parameter None Type Parameter None Range Return Float Default None Menu Meas > TOI Example :MEASure:TOI? 3.7.6.2 Query Third-order Intercept Point(:MEASure:TOI:IP3?) Command :MEASure:TOI:IP3? Format Instruction Gets the min intercept of the Lower TOI(Lower 3rd) and the Upper TOI(Upper 3rd) Parameter None...
SIGLENT Gets video Trigger Level. Parameter Float, unit: dBm, dBmV, dBuV, V, W Type Parameter Unit is dBm: -300 dBm ~ 50 dBm Range uni is dBmV: -253.01 dBmV ~ 96.99 dBmV unit is dBuV: -193.01 dBuV ~ 156.99 dBuV unit is Volts: 223.61 aV ~ 70.71 V unit is Watts: 1.00E-33 W ~ 100 W Return...
Page 62
SIGLENT 3.9.2 TG Level (:SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]) Command :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude] <value> Format :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]? Instruction Sets TG level. Gets TG level. Parameter Float, unit: dBm Type Parameter 0 dBm ~ -20 dBm Range Return Float Default 0 dBm Menu TG > TG Level Example :SOURce:POWer -20 3.9.3 TG Level OffSets (:SOURce:CORRection:OFFSet )
SIGLENT Parameter Float, unit: dB Type Parameter -200 dB ~ 200 dB Range Return Float, unit: dB Default 0 dB Menu TG > Normalize > Ref Lvl Example :DISPlay:WINDow:TRACe:Y:NRLevel 10 TG Normalize Reference Position 3.9.6 (:DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition) Command :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition <integer> Format :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition? Instruction Sets TG normalize reference position.
Page 64
SIGLENT Range Return Enumeration Default Menu Demod Example :DEMod AM 3.10.2 Demod Time ([:SENSe]:DEMod:TIME) Command [:SENSe]:DEMod:TIME <time> Format [:SENSe]:DEMod:TIME? Instruction Sets demod time. Gets demod time. Parameter Float, unit: ms, us, s Type Parameter 5 ms ~1000 s Range Return Float, unit: s Default 5 ms...
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.
Page 67
SIGLENT Set lib file:project---properties---Linker---Command Line---Additional Options: visa32.lib Include visa.h file: In the projectname.cpp file: #include <visa.h> 3, Add codes: (1)USBTMC access code: Write a function Usbtmc_test. 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”...
Page 68
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); (status<VI_SUCCESS) printf (“An error occurred while finding resources.\nHit enter to continue.”); fflush(stdin);...
Page 69
SIGLENT ViUInt32count; ViUInt16portNo; /* First we will need to open the default resource manager. */ status = viOpenDefaultRM (&defaultRM); (status<VI_SUCCESS) printf(“Could not open a session to the VISA Resource Manager!\n”); /* Now we will open a session via TCP/IP device */ Char head[256] =“TCPIP0::”;...
Page 70
SIGLENT 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 ' devices connected to the system and attempts to read back ' results using the write and read functions.
Page 71
SIGLENT status = viWrite(instrsesn, “*IDN?”, 5, retCount) (status < VI_SUCCESS) Then Debug.Print “Error writing to the device.” status = viClose(instrsesn) GoTo NextFind End If ' Now we will attempt to read back a response from the device to ' the identification query that was sent. We will use the viRead ' function to acquire the data.
Page 72
SIGLENT 4.1.3 Example of MATLAB Environment: Win7 32bit system, MATLAB R2010b The function 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、...
Page 73
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、...
SIGLENT 8、 Input the IP address and run the program. 4.2 Using Sockets Examples As mentioned above, socket communication is supported by the operating system—and it is straightforward. Note that SCPI strings are terminated with a “\n” (new line) character. 4.2.1 Example of C int MySocket;...
Page 75
SIGLENT // Read response char buffer[200]; int actual; if((actual=recv(MySocket,&buffer[0],200,0))==-1) exit(1); buffer[actual]=0; // Add zero character (C string) printf(“Instrument ID: %s\n”,buffer); // Close socket if(close(MySocket)==-1) exit(1); SSA3000X Programming Guide 75...
Need help?
Do you have a question about the SSA3000X Series and is the answer not in the manual?
Questions and answers