SAF Spectrum Compact 0.3-3 GHz v2 User manual

Spectrum Compact v2.0 API
user manual
0
API User Manual v.1.0
Spectrum Compact 0.3-3 GHz v2
(J0SSAP33)
Spectrum Compact 2-8 GHz v2
(J0SSAP55)
Spectrum Compact 6-20 GHz v2
(J0SSAP52)
Spectrum Compact 16–26.5 GHz v2
(J0SSAP53)
Spectrum Compact 24–40 GHz v2
(J0SSAP74)
Spectrum Compact 24–43 GHz v2
(J0SSAP54)

Spectrum Compact v2 API user manual v.1.0
1
FCC Compliance statement
This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant
to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful
interference in a residential installation. This equipment generates, uses, and can radiate radio frequency
energy and, if not installed and used in accordance with the instructions, may cause harmful interference
to radio communications. However, there is no guarantee that interference will not occur in a particular
installation. If this equipment does cause harmful interference to radio or television reception, which can
be determined by turning the equipment off and on, the user is encouraged to try to correct the
interference by one or more of the following measures:
- Reorient or relocate the receiving antenna.
- Increase the separation between the equipment and receiver.
- Connect the equipment into an outlet on a circuit different from that to which the
receiver is connected.
- Consult the dealer or an experienced radio/TV technician for help.
Changes or modifications not expressly approved by the party responsible
for compliance could void the user’s authority to operate the equipment.
Spectrum Compact does not contain serviceable parts. Warranty will not
be applicable in the event Spectrum Compact has been opened.
The information presented in this guide is the property of SAF Tehnika, JSC. No part of this document
may be reproduced or transmitted without proper permission from SAF Tehnika, JSC.
The specifications or information contained in this document are subject to change without notice
due to continuing introduction of design improvements. If there is any conflict between this document
and compliance statements, the latter will supersede this document.
SAF Tehnika, JSC has no liability for typing errors in this document or damages of any kind that result
from the use of this document.
To get up to date information about accessories and their availability, please contact the sales
representative.
Copyright Notice
Copyright © 2022 SAF Tehnika, JSC. All rights reserved.

Spectrum Compact v2 API user manual v.1.0
2
1Contents
2 Introduction............................................................................................. 3
3 Installing Spectrum Compact drivers ................................................... 3
4 Establish PC connection with Spectrum Compact.............................. 5
5 Spectrum compact API command line commands Table 1............... 8
6 API CLI commands and description Table 2...................................... 12

Spectrum Compact v2 API user manual v.1.0
3
2Introduction
Welcome to the Spectrum Compact family!
Spectrum Compact is a handheld, field-ready spectrum analyzer. This guide is
prepared to show you how to install and use Spectrum Compact via Application
Programming Interface (API). The guide will contain two tutorials that show you how to
communicate with Spectrum Compact via a USB interface. Spectrum Compact driver
installation is available to download from https://spectrumcompact.com/ in
SUPPORT&DOWNLOADS→Downloads→Firmware section.
3Installing Spectrum Compact drivers
These drivers enable you to communicate with Spectrum Compact via a USB
interface.
Spectrum Compact Windows driver is available to download from
https://spectrumcompact.com/ in SUPPORT&DOWNLOADS→Downloads→Firmware
section. After selecting the relevant Spectrum compact model, you will be prompted to enter
registration credentials. Once the registration process is complete you will be able to
download the relevant Spectrum Compact download package.
Follow these simple installation steps:
1Installation Wizard will check if the downloaded installation file is unzipped. If
not, then the following message will guide you through the installation process.
A dialog box will appear.

Spectrum Compact v2 API user manual v.1.0
4
Please note that installing all Spectrum Compact driver installation files is a
prerequisite to communicate with Spectrum Compact.
2Click Extract all, and unzip Windows driver installation file.
3Choose a supported Operating system.
Begin the installation process by double-clicking on install_sc_drivers application
file.
4Click Next, when the following dialog box appears.
5Click Finish, to finish the driver installation.

Spectrum Compact v2 API user manual v.1.0
5
4Establish PC connection with Spectrum
Compact
Locate and open “Control panel” in Windows OS and choose “Windows Device
Manager”.
Before connecting Spectrum Compact to PC locate COM ports that have been used
by other devices.
Turn on Spectrum Compact unit and turn on the VCP mode under the
TOOLS&SETTINGS -> SERVICE MENU -> USB MODE.

Spectrum Compact v2 API user manual v.1.0
6
Connect Spectrum Compact to PC and identify COM port that will be used to
communicate between PC and Spectrum Compact.
Right-click on the new COM port in the “Ports” list. Then choose properties and
change default communication settings.
This COM port will allow you to send and receive API commands to Spectrum
Compact.

Spectrum Compact v2 API user manual v.1.0
7
Open any terminal emulator program such as Termite or Putty. Change connection
type to “Serial”. Change the default COM port to the COM port that has been identified as the
COM port for Spectrum Compact and also change “Speed”to 115200.
Click Open and launch a new Spectrum Compact terminal window.
With Spectrum Compact API commands, you will be able to configure Spectrum
Compact device and control measurement parameters.

Spectrum Compact v2 API user manual v.1.0
8
5Spectrum compact API command line commands Table 1
Num
Frequency range
0.3-3 GHz
2-8 GHz
6-20 GHz
16-26.5GHz
24-40 GHz
24-43 GHz
FW version
V 5.2.8.6
V 5.4.3.6
V 5.4.3.6
V 5.3.6.12
V 5.3.6.12
V 5.3.6.12
Product number (P/N)
J0SSAP33
J0SSAP55
J0SSAP52
J0SSAP53
J0SSAP74
J0SSAP54
1
?
Yes
Yes
Yes
Yes
Yes
Yes
3
ver
Yes
Yes
Yes
Yes
Yes
Yes
3
freq
Yes
Yes
Yes
Yes
Yes
Yes
4
stop
Yes
Yes
Yes
Yes
Yes
Yes
5
trace
Yes
Yes
Yes
Yes
Yes
Yes
6
trace < 1–8 >
Yes
Yes
Yes
Yes
Yes
Yes
7
lna
Yes
Yes
Yes
N/A
N/A
N/A
8
lna < 0 –1 >
Yes
Yes
Yes
N/A
N/A
N/A
9
bwidth
Yes
Yes
Yes
Yes
Yes
Yes
10
bwidth <10|30|100|300>
<1|3|10|30|100>
Yes
N/A
N/A
N/A
N/A
N/A
bwidth <30|100|300|1000>
<1|3|10|30|100>
N/A
Yes
Yes
N/A
N/A
N/A
bwidth <100|300|1000>
<1|3|10|30|100>
N/A
N/A
N/A
Yes
Yes
Yes
11
att
Yes
Yes
Yes
Yes
N/A
N/A
12
att < 0 –31 >
Yes
Yes
Yes
Yes
N/A
N/A

Spectrum Compact v2 API user manual v.1.0
9
Num
Frequency range
0.3-3 GHz
2-8 GHz
6-20 GHz
16-26.5GHz
24-40 GHz
24-43 GHz
FW version
V 5.2.8.6
V 5.4.3.6
V 5.4.3.6
V 5.3.6.12
V 5.3.6.12
V 5.3.6.12
Product number (P/N)
J0SSAP33
J0SSAP55
J0SSAP52
J0SSAP53
J0SSAP74
J0SSAP54
13
sweepu
Yes
Yes
Yes
Yes
Yes
Yes
14
sweepu <start> <end> <step>kHz
Minimum start frequency
300000 kHz
2000000 kHz
6000000 kHz
16000000 kHz
24000000 kHz
24000000 kHz
Maximum end frequency
3000000 kHz
8000000 kHz
20000000 kHz
26500000 kHz
43000000 kHz
43000000 kHz
Min. span (end freq. –start freq.)
if RBW = 10 kHz
500 kHz
N/A
N/A
N/A
N/A
N/A
if RBW = 30 kHz
1500 kHz
1500 kHz
N/A
N/A
N/A
N/A
if RBW = 100 kHz
5000 kHz
5000 kHz
5000 kHz
5000 kHz
5000 kHz
5000 kHz
if RBW = 300 kHz
15000 kHz
15000 kHz
15000 kHz
15000 kHz
15000 kHz
15000 kHz
if RBW = 1000 kHz
N/A
N/A
50000 kHz
50000 kHz
50000 kHz
50000 kHz
Minimal frequency step
if RBW = 10 kHz
2 kHz
N/A
N/A
N/A
N/A
N/A
if RBW = 30 kHz
7 kHz
7 kHz
N/A
N/A
N/A
N/A
if RBW = 100 kHz
25 kHz
25 kHz
30 kHz
30 kHz
30 kHz
30 kHz
if RBW = 300 kHz
75 kHz
75 kHz
75 kHz
75 kHz
75 kHz
75 kHz
if RBW = 1000 kHz
N/A
N/A
250 kHz
250 kHz
250 kHz
250 kHz
Maximal frequency step
for all RBW settings
10000 kHz
10000 kHz
10000 kHz
10000 kHz
10000 kHz
10000 kHz
15
gain
Yes
Yes
Yes
N/A
N/A
N/A
16
gain <-12, -6, 0, 6, 12 >
Yes
Yes
Yes
N/A
N/A
N/A