SIGLENT TECHNOLOGIES SSA3000X Series Programming Manual

Spectrum analyzer
Hide thumbs Also See for SSA3000X Series:

Advertisement

Quick Links

Programming Guide
SSA3000X Series Spectrum Analyzer
PG0703X-E03A
2017 SIGLENT TECHNOLOGIES CO., LTD

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SSA3000X Series and is the answer not in the manual?

Questions and answers

Summary of Contents for SIGLENT TECHNOLOGIES SSA3000X Series

  • Page 1 Programming Guide SSA3000X Series Spectrum Analyzer PG0703X-E03A 2017 SIGLENT TECHNOLOGIES CO., LTD...
  • Page 2: Table Of Contents

    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 ................
  • Page 3: Programming Overview

    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.
  • Page 6: Remote Control Capabilities

    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.
  • Page 7: Scpi Overview

    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.
  • Page 8: Parameter Type

    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.
  • Page 9: System Commands

    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.
  • Page 11: System Subsystem

    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?)
  • Page 16: Instrument Subsystem

    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...
  • Page 17: Initiate Subsystem

    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>...
  • Page 34: Calculate Subsystem

    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...
  • Page 51: Measurement Subsystem

    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...
  • Page 60: Trigger Subsystem

    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...
  • Page 61: Tg Subsystem

    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 )
  • Page 63: Demod Subsystem

    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...
  • Page 65: Calibration Subsystem

    SIGLENT 3.11 Calibration Subsystem 3.11.1 Calibration on-off ([:SENSe]:CALibration:STATe) Command [:SENSe]:CALibration:STATe OFF|ON|0|1 Format [:SENSe]:CALibration:STATe? Instruction Sets calibration on-off. Gets calibration on-off. Parameter Boolean Type Parameter OFF|ON|0|1 Range Return Default Menu Syetem > Calibration > Auto Cal Example :CALibration:STATe ON SSA3000X Programming Guide 65...
  • Page 66: Programming Examples

    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、...
  • Page 74: Using Sockets Examples

    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...

Table of Contents