Saluki S3331 Series Owner's manual

S3331 Series Handheld Spectrum Analyzer
Programming Manual
Saluki Technology Inc.

Tel: [phone] Email: sale[email protected]
www.salukitec.com
2
The manual applies to the cable & antenna tester of the following models:
S3331Ahandheld spectrum analyzer (9kHz-3.6GHz).
S3331B handheld spectrum analyzer (9kHz-7.5GHz).
Standard Accessories of S3331 handheld spectrum analyzer
Item Name Qty
1 Main Machine 1 Set
2 AC/DCAdaptor 1 pcs
3 CD 1 pcs
Options of the S3331 handheld spectrum analyzer:
Option Number Item
S3331-01 100kHz - 1.5GHz tracking source
S3331-02 100kHz - 3.2GHz tracking source
S3331-03 PC control software
S3331-04 Soft pack bag

Tel: [phone] Email: sale[email protected]
www.salukitec.com
3
Preface
Thanks for choosing S3331 handheld spectrum analyzer produced by Saluki Technology Inc. Please read this quick starter manual
carefully for your convenience.
Manual No.
S3331-03-03
Version
Rev01 2016.09 Saluki Technology
ManualAuthorization
The information contained in this Manual is subject to change without notice. The power to interpret the contents of and terms used in
this Manual rests with Saluki.
Saluki Tech owns the copyright of this Manual which should notbe 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.
Product Quality Assurance
The warranty period of the product is 18 months from the dateof delivery.
Product Quality Certificate
The product meets the indicator requirements of the manual at the time of delivery. Calibration and measurement are completed by the
measuring organization with qualifications specified by the state, and relevant data are provided for reference.
Quality/Environment Management
Research, development, manufacturing and testing of the product comply with the requirements of the quality and environmental
management system.
Contacts
Service Tel: [phone]
Website: www.salukitec.com
Email: [e-mail]
Address: No. 367 Fuxing N Road, Taipei 105，Taiwan (R.O.C.)

4
Tel: [phone] Email: sale[email protected]
www.salukitec.com
Content
1. Overview......................................................................................................................................................................................5
1.1. S3331 Programming...........................................................................................................................................................5
1.2. Introduction to the SCPI command .....................................................................................................................................5
1.2.1. Command format...............................................................................................................................................5
1.2.2. Symbol Description............................................................................................................................................6
1.2.3. Parameter Type.................................................................................................................................................6
1.2.4. Command abbreviation......................................................................................................................................8
2. Sub-command.............................................................................................................................................................................. 9
2.1. IEEE488.2........................................................................................................................................................................... 9
2.2. :CALibration.......................................................................................................................................................................10
2.3. :CALCulate........................................................................................................................................................................ 11
2.4. :CONFigure....................................................................................................................................................................... 18
2.5. :DISPlay............................................................................................................................................................................19
2.6. :FETCh.............................................................................................................................................................................. 23
2.7. :HCOPy............................................................................................................................................................................. 24
2.8. :INITiate............................................................................................................................................................................. 25
2.9. :MMEMory......................................................................................................................................................................... 26
2.10. [:SENSe]............................................................................................................................................................................29
2.11. :SYSTem........................................................................................................................................................................... 41
2.12. :TRACe..............................................................................................................................................................................43
2.13. :OUTPut............................................................................................................................................................................ 45
2.14. :SOURce........................................................................................................................................................................... 46
2.15. :UNIT................................................................................................................................................................................. 47

5
Tel: [phone] Email: sale[email protected]
www.salukitec.com
1. Overview
This chapter means to give an overall description of the S3331programming and SCPI, following content is included:
Overview of S3331 programming
SCPI introduction
Format
Symbol
Parameter
Command
1.1.S3331 Programming
S3331 supports remote access via LAN or USB port. All programming commands are sent as ASCII strings for easy programming and
development.
S3331 provide following remotecontrol functions:
Instrument configuration
Measurement
Data access (status/measurement data)
Print
1.2.Introduction to the SCPI command
SCPI (Standard Commands for Programmable Instrument) is a standard instruction set of programmable instrument on IEEE 488.2. The
SCPI command is divided into two parts: the IEEE 488.2 common command and the SCPI instrument specific control command.
The common command is a command that the instrument specified by IEEE 488.2must support, and its syntax and semantics followthe
requirements of IEEE 488.2. Common commands are independent of measurement and are used to control reset, self-test, and state
operations. Refer to the IEEE 488.2 section for an introduction to the SCPI common command.
SCPI instrument specificcontrolcommandsformeasuring, access to data and other operations, including all measurement functions and
some calculation functions.
1.2.1. Command format
The SCPI command is a tree hierarchy, including multiple subsystems, each consisting of a root key and one or more hierarchical
keywords. The command line begins with a colon " : "; the keywords are separated by a colon " :" followed by an optional parameter; the
question mark " ? " Is appended to the command line to indicate that the function is queried; commands and parameters are separated
by a space " ".
Example
:CALCulate:BANDwidth:NDB <rel_ampl>
:CALCulate:BANDwidth:NDB?

6
Tel: [phone] Email: sale[email protected]
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; the command: CALCulate: BANDwidth: NDB and the parameter <rel_ampl> isseparated by a space “ “.
In some commands with parameters, usually with a comma ","separate multiple parameters, such as:
: SYSTem: DATE <year>, <month>, <day>
1.2.2. Symbol Description
The following four symbols arenot the contents of the SCPI command, but are usually used to describe the parameters in the command.
1.2.2.1. Braces {}
The parameters in braces are optional, can be empty, or can be set one or moreparameters.
Example
[:SENSe]:CORRection:CSET<n>:DATA<freq>,<rel_ampl>{,<freq>,<rel_ampl>}
In {,<freq>,<rel_ampl>} the frequency and amplitude can be omitted, or set one or more pairs of frequency/amplitude parameters.
1.2.2.2. Vertical bar |
The vertical bar is used to separate multiple parameter options, and one of the parameters must be selected when execute the
command.
Example
: DISPLAY: MENU: STATe OFF | ON | 0| 1
The available command parameters are "OFF", "ON","0" or "1", one of them must be selected.
1.2.2.3. Square brackets []
The contents in the square brackets (command keywords) are optional and can be omitted.
Example
[: SENSe]: CORRection:OFFSet [: MAGNitude]?
This command equals to following 3 commands:
: CORRection: OFFSet?
: CORRection: OFFSet: MAGNitude?
: SENSe: CORRection: OFFSet?
1.2.2.4. Triangle brackets <>
The parameters in the triangle brackets must be a valid value.
Example
: DISPlay: BRIGtness <integer>
: DISPlay: BRIGtness 10
1.2.3. Parameter Type

7
Tel: [phone] Email: sale[email protected]
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.
1.2.3.1. boolean
The parameter values are "OFF", "ON", "0" or "1".
Example
: DISPlay: MENU: STATe OFF | ON | 0 | 1
1.2.3.2. keywords
The value of the parameter is the value listed.
Example
: DISPlay:AFUnction: POSition BOTTom | CENTer | TOP
The parameters are "BOTTom", "CENTer" or "TOP".
1.2.3.3. Integer
Unless otherwise noted, the parameter can take any integer value within the valid range. Note that this time, please do not set the
parameters to decimal format, otherwise an exception will occur.
Example
: DISPlay: BRIGtness <integer>
The parameter <integer> is anyinteger in the range 0 to 255.
1.2.3.4. Continuous real type
Any continuous real parameters is allowed in the effective range of precision requirements (usually the default accuracy is six digits after
decimal point).
Example
: CALCulate: BANDwidth: NDB <rel_ampl>
The parameter <rel_ampl> desires a real number between -100 and 100.
1.2.3.5. Discrete
Parameters can only take from the specified values, and thesevalues are not continuous.
Example
: CALCulate: MARKer <n>: MAXimum: MAX
The parameter <n> can only be 1, 2, 3, or 4.
1.2.3.6. ASCII string
The parameter value is a combination ofASCII characters.
Example
: SYSTem: DATE <year>, <month>, <day>

8
Tel: [phone] Email: sale[email protected]
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
: CALCulate: BANDwidth: NDB?
Can be abbreviated as :
: CALC: BAND: NDB?

9
Tel: [phone] Email: sale[email protected]
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
32H:CALibration

33H :CALCulate
:CONFigure

34H :DISPlay

35H :FETCh

36H :HCOPy

37H :INITiate

38H :MMEMory

39H [:SENSe]

40H :SYSTem

41H :TRACe

42H :OUTPut

43H :SOURce
:UNIT
Note: In this command set, if there is no special description, the query function is not installed, will return "N / A" (without quotation
marks), and when the query function is not validated or the type does not match, Returns "ERR" (without the quotation marks). Each
instruction ends with a semicolon (;)
2.1.IEEE488.2
The IEEE standard defines common commands for querying instrument basic information or performing common basic operations.
These commands usually begin with "*" and the command key length is 3 characters.
*IDN?
Command Format *IDN?
Description
Query the instrument ID string
*IDN?
Company, S3331B, SN20000101 V1.8.0.1033
Note ID string is consisted of 4 parts:
Company name + Equipment type + Serial No. + Revision No.

10
Tel: [phone] Email: sale[email protected]
www.salukitec.com
*RST
Command Format *RST
Description Reset the instrument
2.2.:CALibration
:CALibration[:ALL]
Command Format :CALibration[:ALL]
:CALibration[:ALL]?
Description For user calibration
Note When the instrument is connected to a calibration signal, user can run this command to do user calibration
For S3331 the calibration signal frequency is 440MHz, amplitude is -20dBm
:CALibration:RESTore
Command Format :CALibration:RESTore
Description Restore to default calibration status
Note

11
Tel: [phone] Email: sale[email protected]
www.salukitec.com
2.3.:CALCulate
:CALCulate:MARKer[n]:FCOunt[:STATe]
Command Format :CALCulate:MARKer[n]:FCOunt[:STATe] ON|OFF|0|1
:CALCulate:MARKer[n]:FCOunt[:STATe]?
Description
Enable/disable frequency counter, inquire the status of frequency counter
Example:
:CALC:MARK1:FCO 1 // enable frequency counter
Note Enable/disable frequency counter
:CALCulate:MARKer:FCOunt:RESolution <bw>
Command Format :CALCulate:MARKer:FCOunt:RESolution
:CALCulate:MARKer:FCOunt:RESolution?
Description Set or inquire resolution of frequency counter
Note Available value of <bw>
1,10,100,1000
:CALCulate:MARKer[n]:FCOunt:X?
Command Format :CALCulate:MARKer[n]:FCOunt:X?
Description Inquire the result of frequency counter
Note
:CALCulate:TUNE:AUTO
Command Format :CALCulate:TUNE:AUTO ON|OFF|0|1
:CALCulate:TUNE:AUTO?
Description Auto search Start/ Stop
Note
ON|1
Start auto search
OFF|0
Stop auto search
Default OFF
:CALCulate:MARKer:AOFF
Command Format :CALCulate:MARKer:AOFF
Description Turn off all markers
Note

12
Tel: [phone] Email: sale[email protected]
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:
:CALC:MARK1:TRACe 1 // Set Marker 1 onto trace 1
Note <n> is available 1~5，<integer>is available 1~5
:CALCulate:MARKer[n]:MODE
Command Format :CALCulate:MARKer[n]:MODE POSition | DELTa
:CALCulate:MARKer[n]:MODE?
Description Set or inquire current marker mode
Example
:CALCulate:MARKer1:MODE DELT; // Set Marker 1 as a DELTa marker
Note [n] is available 1~5
:CALCulate:MARKer:TABLe:STATe
Command Format :CALCulate:MARKer:TABLe:STATe ON|OFF|0|1
:CALCulate:MARKer:TABLe:STATe?
Description
Display / Hide marker table, inquire the status of marker table
Example
:CALCulate:MARKer:TABLe:STATe 1; // Display the marker table
Note 0|OFF Hide
1|ON Display

13
Tel: [phone] Email: sale[email protected]
www.salukitec.com
:CALCulate:MARKer[n]:X
Command Format :CALCulate:MARKer[n]:X <param>
:CALCulate:MARKer[n]:X?
Description
Set or inquire the X axis value of current marker
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?
Description
Inquire the Y axis value of current marker
Example
:CALC:MARK1:Y? // Inquire Y value of Marker 1
Note [n] is available 1~5
:CALCulate:MARKer[n]:PHNoise[:STATe]
Command Format :CALCulate:MARKer[n]:PHNoise[:STATe] ON|OFF|0|1
:CALCulate:MARKer[n]:PHNoise[:STATe]?
Description
Enable/disable marker noise function. Inquire the marker noise function state.
Example
:CALCulate:MARK2:PHNoise 1; // enable marker 2 marker noise function
Note
0|OFF disable
1|ON enable
[n] is available 1~5
:CALCulate:MARKer:PHNoise:Y?
Command Format :CALCulate:MARKer:PHNoise:Y?
Description
Inquire the value of marker noise
Example
:CALCulate:MARKer:PHNoise:Y?
Note

14
Tel: [phone] Email: sale[email protected]
www.salukitec.com
:CALCulate:MARKer:PHNoise:OFFSet:FREQuency
Command Format :CALCulate:MARKer:PHNoise:OFFSet:FREQuency <freq>
:CALCulate:MARKer:PHNoise:OFFSet:FREQuency?
Description
Set or inquire the start frequency of marker noise
Example
:CALCulate:MARKer:PHNoise:OFFSet:FREQ 100MHz
Return Value：100000000
Note
:CALCulate:MARKer:PHNoise:OFFSet
Command Format :CALCulate:MARKer:PHNoise:OFFSet <
± bw>
:CALCulate:MARKer:PHNoise:OFFSet?
Description
Set or inquire the bandwidth of marker noise
Example
:CALCulate:MARKer:PHNoise:OFFSet 2MHz
Return Value：2000000
Note
:CALCulate:BWIDth|BANDwith[:STATe]
Command Format :CALCulate:BWIDth|BANDwith[:STATe] ON|OFF|0|1
:CALCulate:BWIDth|BANDwith[:STATe]?
Description
Enable / disable NdB measurement function，inquire NdB measurement function state
Example
:CALC:BWID 1; // Enable NdB measurement
Return Value 1
Note 0|OFF Disable
1|ON Enable
:CALCulate:BWIDth|BANDwith:NDB
Command Format :CALCulate:BWIDth|BANDwith:NDB <rel_ampl>
:CALCulate:BWIDth|BANDwith:NDB?
Description
Set or inquire NdB amplitude
Example
:CALC:BWID:NDB 3; // set Ndb amplitude to 3dB
Return Value 3.00
Note

15
Tel: [phone] Email: sale[email protected]
www.salukitec.com
:CALCulate:BWIDth|BANDwith:RESult?
Command Format :CALCulate:BWIDth|BANDwith:RESult?
Description
Inquire NdB measurement result/
Example
: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
Command Format :CALCulate:MARKer[n][:SET]:STEP
Description Set the frequency of marker [n] as the step frequency
Note [n] is available 1~5
:CALCulate:MARKer[n][:SET]:STARt
Command Format :CALCulate:MARKer[n][:SET]:STARt
Description Set the frequency of marker [n] as the start frequency
Note [n] is available 1~5
:CALCulate:MARKer[n][:SET]:STOP
Command Format :CALCulate:MARKer[n][:SET]:STOP
Description Set the frequency of marker [n] as the stop frequency
Note [n] is available 1~5

16
Tel: [phone] Email: sale[email protected]
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
Command Format :CALCulate:MARKer[n]:MAXimum
Description Search for the peak
Note [n] is available 1~5
:CALCulate:MARKer[n]:MAXimum:LEFT
Command Format :CALCulate:MARKer[n]:LEFT
Description Search for the leaf peak
Note [n] is available 1~5
:CALCulate:MARKer[n]:MAXimum:RIGHt
Command Format :CALCulate:MARKer[n]:RIGHt
Description Search for the right peak
Note [n] is available 1~5
:CALCulate:MARKer[n]:MAXimum:NEXT
Command Format :CALCulate:MARKer[n]:NEXT
Description Search for the next peak
Note [n] is available 1~5
:CALCulate:MARKer[n]:MINimum
Command Format :CALCulate:MARKer[n]:MINimum
Description Search for the valley
Note [n] is available 1~5

17
Tel: [phone] Email: sale[email protected]
www.salukitec.com
:CALCulate:MARKer[n]:CPEak[:STATe]
Command Format :CALCulate:MARKer[n]:CPEak[:STATe] ON|OFF|0|1
:CALCulate:MARKer[n]:CPEak[:STATe]?
Description Set or inquire the status of continuous peak function
Note
0|OFF disable
1|ON enable
[n] is available 1~5
:CALCulate:NETMeasure[:STATe]
Command Format :CALCulate:NETMeasure[:STATe] ON|OFF|0|1
:CALCulate:NETMeasure[:STATe]?
Description Set or inquire the status of network measurement
Note 0|OFF disable
1|ON enable
:CALCulate:NETMeasure:RLEVel
Command Format :CALCulate:NETMeasure:RLEVel <ampl>
:CALCulate:NETMeasure:RLEVel?
Description Set or inquire the reference level of network measurement
Note <ampl> is available -80dB~+30dB
:CALCulate:NETMeasure:POWer
Command Format :CALCulate:NETMeasure:POWer <ampt>
:CALCulate:NETMeasure:POWer?
Description Set or inquire the output power of network measurement
Note <ampt> is available -30dB~0dB
:CALCulate:NETMeasure:NORMalize
Command Format :CALCulate:NETMeasure:NORMalize
Description Normalize the network measurement result
Note

18
Tel: [phone] Email: sale[email protected]
www.salukitec.com
2.4.:CONFigure
:CONFigure:ACPower
Command Format :CONFigure:ACPower
Description Switch to adjacent channel power measurement mode
Note
:CONFigure:CHPower
Command Format :CONFigure:CHPower
Description Switch to channel power measurement mode
Note
:CONFigure:OBWidth
Command Format :CONFigure:OBWidth
Description Switch to occupied bandwidth measurement mode
Note
:CONFigure:SANalyzer
Command Format :CONFigure: SANalyzer
Description Switch to Spectrum analyzer mode
Note
:CONFigure?
Command Format :CONFigure?
Description Inquire the measurement mode
Note

19
Tel: [phone] Email: sale[email protected]
www.salukitec.com
2.5.:DISPlay
:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel
Command Format :DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel <ampl>
:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel?
Description
Set or inquire the reference level, Default unit for log display format is dBm, for linear display format is mV
Example:
:DISP:WIN:TRAC:Y: RLEV -10 // set the reference level to -10 dBm or mV
Return Value: -10
Note <ampl> is available -80dBm~+30dBm
Available range will change with the display format of the Y axis unit.
Default 0dBm
:DISPlay:WINdow:TRACe:X[:SCALe]:OFFSet
Command Format :DISPlay:WINdow:TRACe:X[:SCALe]:OFFSet <freq>
:DISPlay:WINdow:TRACe:X[:SCALe]:OFFSet?
Description
Set or inquire the frequency offset
Example:
:DISP:WIN:TRAC:X:OFFS 10MHz; // set the offset to 10MHz
Return Value 10000000
Note <freq>is available -MAXFREQ~+-MAXFREQ
Default 0Hz
:DISPlay:WINdow:TRACe:Y[:SCALe]:PDIVison
Command Format :DISPlay:WINdow:TRACe:Y[:SCALe]:PDIVison <rel_ampl>
:DISPlay:WINdow:TRACe:Y[:SCALe]:PDIVison?
Description
Set or inquire the scale
Example:
:DISP:WIN:TRAC:Y:PDIV 5.0; // set the scale to 5 unit per grid
Return Value 5.00
Note < rel_ampl > is available 1 ~ 255
Default 10.0

20
Tel: [phone] Email: sale[email protected]
www.salukitec.com
:DISPlay:WINdow:TRACe:Y[:SCALe]:SPACing
Command Format :DISPlay:WINdow:TRACe:Y[:SCALe]: SPACing LINear| LOGarithmic
:DISPlay:WINdow:TRACe:Y[:SCALe]: SPACing?
Description
Set or inquire the display formate
Example:
:DISP:WIN:TRAC:Y: SPAC LIN; //set the display format to linear
Return value LINear
Note
Available keywords
LINear
LOGarithmic
Default LOGarithmic
:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel:OFFSet
Command Format :DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel:OFFSet <rel_ampl>
:DISPlay:WINdow:TRACe:Y[:SCALe]:RLEVel:OFFSet?
Description
Set or inquire reference offset, unit is dBm
Example:
:DISP:WIN:TRAC:Y: RLEV:OFFS 20 // set the reference offset to 20dBm
Return value: 20.00
Note < rel_ampl > is available 0 ~ 120
Default 0dBm
:DISPlay:ENABle
Command Format :DISPlay:ENABle ON|OFF|0|1
:DISPlay:ENABle?
Description Set or inquire the display refresh function
Note 0|OFF Disable
1|ON Enable
:DISPlay:MENU:STATe
Command Format :DISPlay:MENU:STATe ON|OFF|0|1
:DISPlay:MENU:STATe?
Description Set or inquire the full window display
Note