Saluki S3331 Series, S3331A, S3331B Programming Manual

S3331 Series Handheld Spectrum Analyzer

Programming Manual

Saluki Technology Inc.

Tel: [phone] Email: [e-mail]

2

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 Qty

1 Main Machine 1 Set

2 AC/DC Adaptor 1 pcs

3 CD 1 pcs

Options of the S3331 handheld sp ect rum anal yz er:

www.salukitec.com

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: [e-mail]

3

www.salukitec.com

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

Manual Auth orizat ion

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

Product Quality Assurance

The warranty period of the product is 18 months from the date of 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，T aiwan (R.O.C.)

4

Tel: [phone] Email: [e-mail]

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: [e-mail]

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

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 remote control functions:

 Instrument configuration
 Measurement
 Data access (status/measurement data)
 Print

1.2. Introduction to the S CPI 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.2 must support, and its syntax and semantics follow the
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 specific control commands for measuring, 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: [e-mail]

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> is separated 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 are not 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 more parameters.

 Example

[:SENSe]:CORRection:CSET<n>:DATA <freq>,<rel_ampl>{,<freq>,<rel_ampl>}

In {,<freq>,<rel_ampl>} the frequency and amplitude can be omitted, or se t 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: [e-mail]

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 any integer 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 these values 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 of ASCII characters.

 Example

: SYSTem: DATE <year>, <month>, <day>

8

Tel: [phone] Email: [e-mail]

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: [e-mail]

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?

Query the instrument ID string

Description

*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

*RST

Command Format *RST

Description Reset the instrument

2.2. :CALibration

:CALibration[:ALL]

Tel: [phone] Email: [e-mail]

www.salukitec.com

Command Format

Description For user calibration

Note

:CALibration:RESTore

Command Format :CALibration:RESTore

Description Restore to default calibration status

Note

:CALibration[:ALL]
:CALibration[:ALL]?

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

11

2.3. :CALCulate

:CALCulate:MARKer[n]:FCOunt[:STATe]

Tel: [phone] Email: [e-mail]

www.salukitec.com

Command Format

Description

Note Enable/disable frequency counter

:CALCulate:MARKer:FCOunt:RESolution <bw>

Command Format

Description Set or inquire resolution of frequency counter

Note

:CALCulate:MARKer[n]:FCOunt:X?

Command Format :CALCulate:MARKer[n]:FCOunt:X?

:CALCulate:MARKer[n]:FCOunt[:STATe] ON|OFF|0|1
:CALCulate:MARKer[n]:FCOunt[:STATe]?

Enable/disable frequency counter, inquire the status of frequency counter

 Example:

:CALC:MARK1:FCO 1 // enable frequency counter

:CALCulate:MARKer:FCOunt:RESolution
:CALCulate:MARKer:FCOunt:RESolution?

Available value of <bw>
1,10,100,1000

Description Inquire the result of frequency counter

Note

:CALCulate:TUNE:AUTO

Command Format

Description Auto search Start/ Stop

Note

Default OFF

:CALCulate:MARKer:AOFF

Command Format :CALCulate:MARKer:AOFF

Description Turn off all markers

:CALCulate:TUNE:AUTO ON|OFF|0|1
:CALCulate:TUNE:AUTO?

ON|1

Start auto search

OFF|0

Stop auto search

Note

12

: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

Tel: [phone] Email: [e-mail]

www.salukitec.com

Note

:CALCulate:MARKer[n]:MODE

Command Format :CALCulate:MARKer[n]:MODE POSition | DELTa

Description Set or inquire current marker mode

Note [n] is available 1~5

:CALCulate:MARKer:TABLe:STATe

Command Format

Description

<n> is available 1~5， <integer> is availabl e 1~5

:CALCulate:MARKer[n]:MODE?

 Example

:CALCulate:MARKer1:MODE DELT; // Set Marker 1 as a DELTa marker

:CALCulate:MARKer:TABLe:STATe ON|OFF|0|1
:CALCulate:MARKer:TABLe:STATe?

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

:CALCulate:MARKer[n]:X

Tel: [phone] Email: [e-mail]

www.salukitec.com

Command Format

Description

Note [n] is available 1~5

:CALCulate:MARKer[n]:Y?

Command Format :CALCulate:MARKer[n]:Y?

Description

Note [n] is available 1~5

:CALCulate:MARKer[n]:PHNoise[:STATe]

Command Format

:CALCulate:MARKer[n]:X <param>
:CALCulate:MARKer[n]:X?

Set or inquire the X axis value of current marker
 Example
:CALCulate:MARKer1:X 200MHz; // Move current marker to 200MHz

Inquire the Y axis value of current marker
 Example

:CALC:MARK1:Y? // Inquire Y value of Marker 1

:CALCulate:MARKer[n]:PHNoise[:STATe] ON|OFF|0|1
:CALCulate:MARKer[n]:PHNoise[:STATe]?

Enable/disable marker noise function. Inquire the marker noise function state.

Description

Note

:CALCulate:MARKer:PHNoise:Y?

Command Format :CALCulate:MARKer:PHNoise:Y?

Description

Note

 Example

:CALCulate:MARK2:PHNoise 1; // enable marker 2 marker noise function

0|OFF disable
1|ON enable
[n] is available 1~5

Inquire the value of marker noise
 Example

:CALCulate:MARKer:PHNoise:Y?

14

:CALCulate:MARKer:PHNoise:OFFSet:FREQuency

Tel: [phone] Email: [e-mail]

www.salukitec.com

Command Format

:CALCulate:MARKer:PHNoise:OFFSet:FREQuency <freq>
: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 <

Command Format

:CALCulate:MARKer:PHNoise:OFFSet?

Set or inquire the bandwidth of marker noise
 Example

Description

:CALCulate:MARKer:PHNoise:OFFSet 2MHz

Return Value：2000000

Note

±

bw>

:CALCulate:BWIDth|BANDwith[:STATe]

Command Format

Description

Note

:CALCulate:BWIDth|BANDwith:NDB

Command Format

Description

:CALCulate:BWIDth|BANDwith[:STATe] ON|OFF|0|1
:CALCulate:BWIDth|BANDwith[:STATe]?

Enable / disable NdB measurement function， inquire NdB measurement function state
 Example

:CALC:BWID 1; // Enable NdB measurement
Return Value 1

0|OFF Disable
1|ON Enable

:CALCulate:BWIDth|BANDwith:NDB <rel_ampl>
:CALCulate:BWIDth|BANDwith:NDB?

Set or inquire NdB amplitude
 Example

:CALC:BWID:NDB 3; // set Ndb amplitude to 3dB

Return Value 3.00

Note

15

:CALCulate:BWIDth|BANDwith:RESult?

Command Format :CALCulate:BWIDth|BANDwith:RESult?

Inquire NdB measurement result/

Tel: [phone] Email: [e-mail]

www.salukitec.com

Description

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

 Example

:CALC:BWID:RES?;

Return Value: 1000300

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