Page 1
S3331 Series Handheld Spectrum Analyzer Programming Manual Saluki Technology Inc.
Page 2
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com The manual applies to the cable & antenna tester of the following models: S3331A handheld spectrum analyzer (9kHz-3.6GHz). S3331B handheld spectrum analyzer (9kHz-7.5GHz). Standard Accessories of S3331 handheld spectrum analyzer Item Name Main Machine 1 Set AC/DC Adaptor...
Page 3
Manual rests with Saluki. Saluki Tech owns the copyright of this Manual which should not be modified or tampered by any organization or individual, or reproduced or transmitted for the purpose of making profit without its prior permission, otherwise Saluki will reserve the right to investigate and affix legal liability of infringement.
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com 1. Overview This chapter means to give an overall description of the S3331 programming and SCPI, following content is included: Overview of S3331 programming SCPI introduction Format Symbol Parameter Command ...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com CALCulate is the root of the command, BANDwidth and NDB are the second and third level keywords. The command line begins with a colon "," and separates the keywords at all levels. <Rel_ampl> represents the settable parameter; the question mark "?" Indicates the query;...
Page 7
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com The parameters contained in the commands described in this manual can be classified into the following six types: Boolean, keyword, integer, continuous real, discrete, ASCII string. boolean 1.2.3.1. The parameter values are "OFF", "ON", "0" or "1". Example ...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com The parameter is the set date format string. 1.2.4. Command abbreviation All commands are case insensitive, user can use uppercase or lowercase. Meanwhile if abbreviations to be used, users must type in all the capital letters in the command format. Example ...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com 2. Sub-command This chapter introduces the sub-command system of the S3331 in the alphabet sequence (except IEEE 488.2 standard commands). IEEE488.2 : CALibration 3 2 H : CALCulate 3 3 H :CONFigure ...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com *RST Command Format *RST Description Reset the instrument 2.2. :CALibration :CALibration[:ALL] :CALibration[:ALL] Command Format :CALibration[:ALL]? Description For user calibration When the instrument is connected to a calibration signal, user can run this command to do user calibration Note For S3331 the calibration signal frequency is 440MHz, amplitude is -20dBm :CALibration:RESTore...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com 2.3. :CALCulate :CALCulate:MARKer[n]:FCOunt[:STATe] :CALCulate:MARKer[n]:FCOunt[:STATe] ON|OFF|0|1 Command Format :CALCulate:MARKer[n]:FCOunt[:STATe]? Enable/disable frequency counter, inquire the status of frequency counter Description Example: :CALC:MARK1:FCO 1 // enable frequency counter Note Enable/disable frequency counter :CALCulate:MARKer:FCOunt:RESolution <bw> :CALCulate:MARKer:FCOunt:RESolution Command Format :CALCulate:MARKer:FCOunt:RESolution? Description Set or inquire resolution of frequency counter...
Page 12
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :CALCulate:MARKer[n]:STATe Command Format :CALCulate:MARKer[n]:STATe ON|OFF|0|1 :CALCulate:MARKer[n]:STATe? Description Display/hide the marker state, inquire the marker state Note [n] available value is 1~5 :CALCulate:MARKer<n>:TRACe Command Format :CALCulate:MARKer<n>:TRACe <integer> :CALCulate:MARKer<n>:TRACe? Description Set of inquire the trace for current marker n Example: ...
Page 13
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :CALCulate:MARKer[n]:X :CALCulate:MARKer[n]:X <param> Command Format :CALCulate:MARKer[n]:X? Set or inquire the X axis value of current marker Description Example :CALCulate:MARKer1:X 200MHz; // Move current marker to 200MHz Note [n] is available 1~5 :CALCulate:MARKer[n]:Y? Command Format :CALCulate:MARKer[n]:Y? Inquire the Y axis value of current marker Description...
Page 14
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :CALCulate:MARKer:PHNoise:OFFSet:FREQuency :CALCulate:MARKer:PHNoise:OFFSet:FREQuency <freq> Command Format :CALCulate:MARKer:PHNoise:OFFSet:FREQuency? Set or inquire the start frequency of marker noise Example Description :CALCulate:MARKer:PHNoise:OFFSet:FREQ 100MHz Return Value:100000000 Note :CALCulate:MARKer:PHNoise:OFFSet :CALCulate:MARKer:PHNoise:OFFSet < bw> ± Command Format :CALCulate:MARKer:PHNoise:OFFSet? Set or inquire the bandwidth of marker noise ...
Page 15
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :CALCulate:BWIDth|BANDwith:RESult? Command Format :CALCulate:BWIDth|BANDwith:RESult? Inquire NdB measurement result/ Example Description :CALC:BWID:RES?; Return Value: 1000300 Note :CALCulate:MARKer:FUNCtion:AOFF Command Format :CALCulate:MARKer:FUNCtion:AOFF Description Disable all marker functions Note :CALCulate:MARKer[n][:SET]:CENTer Command Format :CALCulate:MARKer[n][:SET]:CENTer Description Set the frequency of marker [n] as the center frequency Note [n] is available 1~5 :CALCulate:MARKer[n][:SET]:STEP...
Page 16
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :CALCulate:MARKer[n][:SET]:RLEVel Command Format :CALCulate:MARKer[n][:SET]: RLEVel Description Set the amplitude of marker [n] as the reference level Note [n] is available 1~5 :CALCulate:MARKer[n][:SET]:SPAN Command Format :CALCulate:MARKer[n][:SET]: SPAN Description Set the frequency difference of delta marker as span Note [n] is available 1~5 :CALCulate:MARKer[n]:MAXimum...
Page 17
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :CALCulate:MARKer[n]:CPEak[:STATe] :CALCulate:MARKer[n]:CPEak[:STATe] ON|OFF|0|1 Command Format :CALCulate:MARKer[n]:CPEak[:STATe]? Description Set or inquire the status of continuous peak function 0|OFF disable Note 1|ON enable [n] is available 1~5 :CALCulate:NETMeasure[:STATe] :CALCulate:NETMeasure[:STATe] ON|OFF|0|1 Command Format :CALCulate:NETMeasure[:STATe]? Description Set or inquire the status of network measurement 0|OFF disable Note 1|ON enable...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com 2.5. :DISPlay :DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel :DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel <ampl> Command Format :DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel? Set or inquire the reference level, Default unit for log display format is dBm, for linear display format is mV Example: Description :DISP:WIN:TRAC:Y: RLEV -10 // set the reference level to -10 dBm or mV Return Value: -10 <ampl>...
Page 20
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :DISPlay:WINdow:TRACe:Y[:SCALe]:SPACing :DISPlay:WINdow:TRACe:Y[:SCALe]: SPACing LINear| LOGarithmic Command Format :DISPlay:WINdow:TRACe:Y[:SCALe]: SPACing? Set or inquire the display formate Example: Description :DISP:WIN:TRAC:Y: SPAC LIN; //set the display format to linear Return value LINear Available keywords Note LINear LOGarithmic Default LOGarithmic...
Page 21
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :DISPlay:FORMat:ZOOM :DISPlay:FORMat:ZOOM ON|OFF|0|1 Command Format :DISPlay:FORMat: ZOOM? Description Set or inquire the display zoom function 0|OFF Disable Note 1|ON Enable :DISPlay:WINdow:TRACe:Y:DLINe :DISPlay:WINdow:TRACe:Y:DLINe <ampl> Command Format :DISPlay:WINdow:TRACe:Y:DLINe? Set or inquire the reference line function Example: Description :DISP:WIN:TRAC:Y:DLIN -20 // set a reference line, Y axis value is -20, unit depends on display formate Return value -20...
Page 22
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :DISPlay:BRIGhtness :DISPlay:BRIGhtness <integer> Command Format :DISPlay:BRIGhtness? Set or inquire the brightness of the screen Example: Description :DISPlay:BRIG 50 // set the screen brightness to 50 Return value 50 Note <integer> range 1~100 :DISPlay:ANNotation:CLOCk[:STATe] :DISPlay:ANNotation:CLOCk[:STATe] ON|OFF|0|1 Command Format :DISPlay:ANNotation:CLOCk[:STATe]?
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com 2.6. :FETCh :FETCh:ACPower:MAIN? Command Format :FETCh:ACPower:MAIN? Description Inquire the main channel power Note :FETCh:ACPower? Command Format :FETCh:ACPower? Description Inquire the adjacent channels power Note :FETCh:ACPower:LOWer? Command Format :FETCh:ACPower:LOWer? Description Inquire lower channel power Note :FETCh:ACPower:UPPer? Command Format :FETCh:ACPower:UPPer?
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com 2.7. :HCOPy :HCOPy:IMAGe:COLor[:STATe] :HCOPy:IMAGe:COLor[:STATe] ON|OFF|0|1 Command Format :HCOPy:IMAGe:COLor[:STATe]? Description Set and inquire printer type ON|1 colorful printer Note OFF|0 Black/White printer :HCOPy:PAGE:ORIentation :HCOPy:PAGE:ORIentation LANDscape|PORTrait Command Format :HCOPy:PAGE:ORIentation? Description Set and inquire the paper direction Available keyword: Note LANDscape...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :INITiate 2.8. [:INITiate]:CONTinuous [:INITiate]:CONTinuous OFF|ON|0|1 Command Format [:INITiate]:CONTinuous? Set or inquire sweep mode Example: Description :INIT:CONT 0 // set sweep mode as single sweep Return value 0 2 sweep modes are supported: Single sweep and continuous sweep Note ON|1 Continuous Sweep OFF|0 Single Sweep...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com 2.9. :MMEMory :MMEMory:CATalog? Command Format :MMEMory:CATalog? Description Inquire the saving file directory Note Return the saving file directory Default :MMEMory:STORe:STATe Command Format :MMEMory:STORe:STATe Description Save current user state Note Default :MMEMory:DISK:INFormation? Command Format :MMEMory:DISK:INFormation? Description Inquire hard disk information Note...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe] 2.10. [:SENSe]:FREQuency:CENTer [:SENSe]:FREQuency:CENTer <freq> Command Format [:SENSe]:FREQuency:CENTer? Set or inquire the center frequency. Supported units are GHz, MHz, KHz, Hz, Default unit is Hz, Example: :FREQ:CENT 200000000 Description :FREQ:CENT 200000000Hz // set the center frequency to 20MHz Return value 200000000 Note <freq>...
Page 30
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:FREQuency:STOP [:SENSe]:FREQuency:STOP <freq> Command Format [:SENSe]:FREQuency:STOP? Set or inquire the stop frequency. Supported units are GHz, MHz, KHz, Hz, Default unit is Hz. Example: :FREQ:STOP 1000000000 Description :FREQ:STOP 1GHz //set the stop frequency to 1GHz Return value 1000000000 Note <freq>...
Page 31
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:FREQuency:REFerence INTernal|EXTernal [:SENSe]:FREQuency:REFerence INTernal|EXTernal Command Format [:SENSe]:FREQuency:REFerence? Set or inquire the reference source mode Example: Description :FREQ:REF INT //use internal reference source Return value:INTernal Keywords: Note INTernal: Internal source EXTernal: External reference source Default INTernal [:SENSe]:FREQuency:SPAN...
Page 32
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:FREQuency:SPAN:PREVious Command Format [:SENSe]:FREQuency:SPAN:PREVious Description Set current span the same as the previous span Note [:SENSe]:BANDwidth|BWIDth[:RESolution] [:SENSe]:BANDwidth[:RESolution] <freq> [:SENSe]:BWIDth[:RESolution] <freq> Command Format [:SENSe]:BANDwidth[:RESolution]? [:SENSe]:BWIDth[:RESolution]? Set or inquire resolution bandwidth. Example: :BAND:RES 1000 Description :BAND:RES 1KHz // set the resolution bandwidth Return Value 1000 Following RBW are supported:...
Page 33
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO [:SENSe]:BANDwidth[:RESolution] :AUTO OFF|ON|0|1 [:SENSe]:BWIDth[:RESolution] :AUTO OFF|ON|0|1 Command Format [:SENSe]:BANDwidth[:RESolution] :AUTO? [:SENSe]:BWIDth[:RESolution] :AUTO? Set or inquire RBW setting mode, manual and auto modes are supported. Example: Description :BAND:RES:AUTO OFF // Manual set the RBW Return value 0 ON|1 Auto mode Note...
Page 34
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:BANDwidth|BWIDth:VIDeo [:SENSe]:BANDwidth:VIDeo <freq> [:SENSe]:BWIDth:VIDeo <freq> Command Format [:SENSe]:BANDwidth:VIDeo? [:SENSe]:BWIDth:VIDeo? Set video bandwidth, Supported units are GHz, MHz, KHz, Hz, Default unit is Hz Example: :BAND:VID 1000000 Description :BAND:VID 1MHz // set the video bandwidth to 1MHz. Return value 1000000 Video bandwidth available value: Note...
Page 35
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:BANDwidth|BWIDth:EMC [:SENSe]:BANDwidth:EMC <freq> [:SENSe]:BWIDth:EMC <freq> Command Format [:SENSe]:BANDwidth:EMC? [:SENSe]:BWIDth:EMC? Set or inquire EMC bandwidth Example: :BAND:EMC 120000 Description :BAND:EMC 120kHz // set EMC bandwidth to 120kHz Return value 120000 Following EMC bandwidth is available: Note 1MHz,120kHz,30kHz,9kHz,200Hz Default...
Page 36
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:AVERage:COUNt [:SENSe]:AVERage:COUNt <integer> Command Format [:SENSe]:AVERage:COUNt? Set or inquire average factor Example Description :AVER:COUN 50 // set average factor to 50 Return Value 50 Note Average function should be enabled before setting the average factor Default [:SENSe]:AVERage[:STATe] [:SENSe]:AVERage[:STATe]...
Page 37
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:POWer[:RF]:ATTenuation:AUTO [:SENSe]:POWer[:RF]:ATTenuation:AUTO ON|OFF|1|0 Command Format [:SENSe]:POWer[:RF]:ATTenuation:AUTO? Set or inquire the attenuator setting mode, manual or auto. Example Description :POW:ATT:AUTO OFF // set the attenuator manually Return value 0 ON|1 Auto Note OFF|0 Manual Default Auto [:SENSe]:POWer[:RF]:GAIN[:STATe]:AUTO...
Page 38
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:SWEep:TIME:AUTO [:SENSe]:SWEep:TIME:AUTO OFF|ON|0|1 Command Format [:SENSe]:SWEep:TIME:AUTO? Set or inquire the sweep time setting mode, auto or manual Example: Description :SWE:TIME:AUTO OFF // manually set the sweep time Return value 0 ON|1 Auto Note OFF|0 Manual Default Auto...
Page 39
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:ACPower:BANDwidth:INTegration [:SENSe]:ACPower:BANDwidth:INTegration <freq> Command Format [:SENSe]:ACPower:BANDwidth:INTegration? Set or inquire main channel bandwidth: Description :ACP:BAND:INT 1MHz; // set the main channel bandwidth 1MHz Return value: 1000000 Note Adjacent channel power measurement function should be enabled before setting the main channel bandwidth. [:SENSe]:ACPower:BANDwidth:ACHannel:COUNt [:SENSe]:ACPower:BANDwidth:ACHannel:COUNt <integer>...
Page 40
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com [:SENSe]:OBWidth:PERCent [:SENSe]:OBWidth: PERCent <real> Command Format [:SENSe]:OBWidth: PERCent? Set or inquire OBW percentage Description :OBW:PERC 98; // set the percentage to 98% Return value 98 Note OBW function should be enabled before setting the OBW percentage. [:SENSe]:CHPower:FREQuency:SPAN [:SENSe]: CHPower:FREQuency:SPAN <freq>...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :SYSTem 2.11. :SYSTem:DATE :SYSTem:DATE <year>,<month>,<day> Command Format :SYSTem:DATE? Set or inquire system date, Example: Description :SYST:DATE 2016,11,1 // set date to 2016.11.1 Return value 2016,11,1 <year> ranges 2000~2037 Note <month> ranges 1~12 <day> ranges 1~31 :SYSTem:TIME :SYSTem:TIME <hour>,<minute>,<second>...
Page 42
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :SYSTem:COMMunicate:LAN:IP:ADDRess :SYSTem:COMMunicate:LAN:IP:ADDRess <ip> Command Format :SYSTem:COMMunicate:LAN:IP:ADDRess? Set or inquire the instrument IP address. Description :SYST:COMM:LAN:IP:ADDR 192.168.1.10 // set the instrument IP to 192.168.1.10 Return value 192.168.1.10 Note :SYSTem:COMMunicate:LAN:MASK :SYSTem:COMMunicate:LAN:MASK <mask> Command Format :SYSTem:COMMunicate:LAN:MASK? Set or inquire the instrument IP address mask Description :SYST:COMM:LAN:MASK 255.255.255.0 // set the mask to 255.255.255.0 Return value 255.255.255.0...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :TRACe 2.12. :TRACe[:DATA] Command Format :TRACe[:DATA] ? TRACE1| TRACE2| TRACE3| TRACE4| TRACE5 Inquire trace data of a specified trace. Example: Description :TRAC? TRACE1 // inquire the trace data of Trace 1 Return value 64.7301,-68.163, …, -36.185,-57.931 S3331 support maximum 5 traces simultaneously.
Page 44
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :TRACe:SOCKdata? Command Format :TRACe:SOCKdata? TRACE1| TRACE2| TRACE3| TRACE4| TRACE5 Inquire the trace date in binary data. Example: Description :TRAC:SOCK? Trace1; // inquire binary data of trace 1 Return value: c1 b8 de 61 c2 84 83 26 c2 81 82 9d c2 81 b9 c6 …2a 6a c2 81 3e 9d c2 82 71 eb c2 80 85 90 0d 0a Note Default...
Tel: 886.2.2175 2930 Email: sales@salukitec.com www.salukitec.com :UNIT 2.15. :UNIT:POWer :UNIT:POWer dBm|dBuW|dBpW|dBmV|dBuV|V|W Command Format :UNIT:POWer? Set or inquire power unit, default unit is dBm. Example: Description :UNIT:POW dBpW; //set power unit to dBpW Return Value: dBpW Note Default -End of Document-...