Anritsu Site Master S331L Manuel du propriétaire

SCPI Programming Manual

S331L Site Master™

Handheld Cable and Antenna Analyzer

Anritsu Company

490 Jarvis Drive

Morgan Hill, CA 95037-2809

USA

http://www.anritsu.com

Part Number: 10580-00322

Revision: F

Published: March 2022

NOTICE

Anritsu Company has prepared this manual for use by Anritsu Company personnel and customers as a

guide for the proper installation, operation and maintenance of Anritsu Company equipment and

computer programs. The drawings, specifications, and information contained herein are the property of

Anritsu Company, and any unauthorized use or disclosure of these drawings, specifications, and

information is prohibited; they shall not be reproduced, copied, or used in whole or in part as the basis

for manufacture or sale of the equipment or software programs without the prior written consent of

Anritsu Company.

UPDATES

Updates, if any, can be downloaded from the Anritsu Website at:

http://www.anritsu.com

For the latest service and sales contact information in your area, please visit:

http://www.anritsu.com/contact-us

S331L PM PN: 10580-00322 Rev. F Contents-1

Table of Contents

Chapter 1—General Information

1-1 About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

1-2 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

1-3 Remote Operation Setup and Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

USB Interface Connection and Setup . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Ethernet Interface Connection and Setup . . . . . . . . . . . . . . . . . . . . . . . 1-4

Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

Site Master LAN Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

1-4 Sending SCPI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6

USB Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6

Ethernet Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9

Chapter 2—Programming with SCPI

2-1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

2-2 Introduction to SCPI Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

SCPI Common Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

SCPI Required Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

SCPI Optional Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

2-3 Subsystem Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

Command Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

Hierarchical Command Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Query Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

Data Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

Unit Suffixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

2-4 Notational Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

2-5 Notational Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8

Command Terminators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8

2-6 Formatting Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9

Contents-2 PN: 10580-00322 Rev. F S331L PM

Table of Contents (Continued)

Chapter 3—All Mode Commands

Chapter 4—Cable & Antenna Analyzer Mode Commands

Appendix A—Examples

A-1 C/C++ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

A-2 Visual Basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4

A-3 Visual Basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6

A-4 Visual Basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10

A-5 LabVIEW™ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-13

Appendix B—List of Commands by Mode

Appendix C—List of Commands, Alphabetical

S331L PM PN: 10580-00322 Rev. F 1-1

Chapter 1 — General Information

1-1 About this Manual

This SCPI Programming Manual provides information for remote operation of the Site

Master S331L, Cable and Antenna Analyzer, using commands sent from an external

controller through the USB or Ethernet connection.

This Programming Manual includes the following:

•An overview of the USB and Ethernet connections to the instrument.

•An overview of Standard Commands for Programmable Instruments (SCPI) command

structure and conventions.

•The IEEE common commands that are supported by the instruments.

•A complete listing and description of all the SCPI commands that can be used to

remotely control functions of the instrument. The commands are organized by

measurement mode starting in Chapter 3.

This manual is intended to be used in conjunction with the Site Master S331L User Guide.

Refer to the instrument user guide for general information about the instrument, including

equipment setup and operating instructions.

1-2 Introduction

This chapter provides a general description of remote programming setup and interface using

USB or Ethernet, and sending SCPI commands to the instrument.

1-3 Remote Operation Setup and Interface

Remote operation of the instrument is accomplished via the USB or Ethernet interface. The

following paragraphs provide information about the interface connections, cable

requirements, and setting up remote operation.

USB Interface Connection and Setup

The Universal Serial Bus (USB) architecture is a high-performance networking standard that

is considered “plug and play” compatible. The USB driver software is automatically detected

and configured by the operating system of the devices that are connected to the bus. The

instrument conforms to the USB 2.0 standard and is a USB “Hi-speed” device that supports

data rates of up to 480 Mbps with the following restrictions:

•One USB network can support up to 127 devices

•The maximum length of USB cables between active devices is 5 meters (for USB 2.0)

and 3 meters (for USB 1.0)

You must have NI-VISA 2.5 or later installed on the controller PC and must select the VISA

library (visa32.dll) as a reference in a Visual Basic project. For remote USB control, the

controlling PC needs to have a version of VISA installed that supports USBTMC (USB Test

and Measurement Class) devices.

1-3 Remote Operation Setup and Interface Chapter 1 — General Information

1-2 PN: 10580-00322 Rev. F S331L PM

USB Interface, Type Mini-B

The USB 2.0 Mini-B device connector is used to connect the instrument directly to a

PC. The first time the instrument is connected to a PC, the normal USB device

detection by the computer operating system takes place.

1. Power on the instrument and controller PC and wait for the systems to power up

completely.

2. Connect the USB cable Mini-B connector to the instrument.

3. Connect the USB cable A connector to the controller PC USB host port. The

controller PC should indicate “New Hardware Found” if the combination of USB

VID/PID/Serial Number has never been connected to this controller PC.

Figure 1-1. USB Found New Hardware Wizard

Chapter 1 — General Information 1-3 Remote Operation Setup and Interface

S331L PM PN: 10580-00322 Rev. F 1-3

4. Select to allow the Wizard to search for and install the USB software

automatically.

5. After the software installs, close the Wizard by clicking Finish.

Figure 1-2. USB Found New Hardware Wizard

Figure 1-3. USB Found New Hardware Wizard

1-3 Remote Operation Setup and Interface Chapter 1 — General Information

1-4 PN: 10580-00322 Rev. F S331L PM

Ethernet Interface Connection and Setup

The Site Master S331L fully supports the IEEE-802.3 standard. Most Site Master functions

(except power On/Off) can be controlled via an Ethernet connection to a PC that is connected

directly (with an Ethernet cross-over cable) or through a network.

Ethernet networking uses a bus or star topology in which all of the interfacing devices are

connected to a central cable called the bus, or are connected to a hub. Ethernet uses the

CSMA/CD access method to handle simultaneous transmissions over the bus. CSMA/CD

stands for Carrier Sense Multiple Access/Collision Detection. This standard enables network

devices to detect simultaneous data channel usage (called a collision) and provides for a

contention protocol. When a network device detects a collision, the CSMA/CD standard

dictates that the data is retransmitted after waiting a random amount of time. If a second

collision is detected, then the data are again retransmitted after waiting twice as long. This is

known as exponential back off.

The TCP/IP setup requires the following:

•USB-to-Ethernet Dongle: The S331L requires the use of an external USB-to-Ethernet

dongle, such as Anritsu part number 2000-1810-R, to enable TCP/IP communication.

•IP Address: Every computer/electronic device in a TCP/IP network requires an IP

address. An IP address has four numbers (each between 0 and 255) separated by

periods. For example: 128.111.122.42 is a valid IP address.

•Subnet Mask: The subnet mask distinguishes the portion of the IP address that is the

network ID from the portion that is the station ID. The subnet mask 255.255.0.0, when

applied to the IP address given above, would identify the network ID as 128.111 and

the station ID as 122.42. All stations in the same local area network should have the

same network ID, but different station IDs.

•Default Gateway: A TCP/IP network can have a gateway to communicate beyond the

LAN that is identified by the network ID. A gateway is a computer or electronic device

that is connected to two different networks and can move TCP/IP data from one

network to the other. A single LAN that is not connected to other LANs requires a

default gateway setting of 0.0.0.0. If you have a gateway, then the default gateway

would be set to the appropriate value of your gateway.

•Ethernet Address: An Ethernet address (also known as a MAC address) is a unique

48-bit value that identifies a network interface card to the rest of the network. Every

network card has a unique ethernet address permanently stored into its memory.

Chapter 1 — General Information 1-3 Remote Operation Setup and Interface

S331L PM PN: 10580-00322 Rev. F 1-5

Connectivity

TCP/IP connectivity requires setting up the parameters that are described at the beginning of

this section. The following is a brief overview of how to set up a general LAN connection on

the Site Master.

Site Master LAN Connections

The S331L requires the use of an external USB-Ethernet dongle, such as Anritsu part

number 2000-1810-R, to connect the Site Master to a local area network (LAN). Integrated

into this dongle are two LEDs (Light Emitting Diodes). The amber LED indicates the speed of

the LAN connection (ON for 100 Mb/s and OFF for 10 Mb/s), and the green LED flashes to

show that LAN traffic is present. The instrument IP address is set automatically by using

Dynamic Host Configuration Protocol (DHCP). DHCP is an Internet protocol that automates

the process of setting IP addresses for devices that use TCP/IP, and is the most common

method of configuring a device for network use. After the Ethernet cable is connected to the

instrument, go to System, Status, Connectivity Info to view the IP address that the

instrument has been assigned.

Table 1-1. 8-pin Ethernet RJ45 Connector Pinout Diagram

Pin Name Description Wire Color

1 TX+ Transmit data (> +3 volts) White/Orange

2 TX– Transmit data (< –3 volts) Orange

3 RX+ Receive data (> +3 volts) White/Green

4 — Not used (common mode termination) Blue

5 — Not used (common mode termination) White/Blue

6 RX– Receive data (< –3 volts) Green

7 — Not used (common mode termination) White/Brown

8 — Not used (common mode termination) Brown

Note You may need to consult your network documentation or network administrator for

assistance in configuring your network setup.

8 7 6 5 4 3 2 1

1-4 Sending SCPI Commands Chapter 1 — General Information

1-6 PN: 10580-00322 Rev. F S331L PM

1-4 Sending SCPI Commands

SCPI commands can be sent to the instrument through any Virtual Instrument Software

Architecture (VISA) controller. VISA is a commonly used API in the Test and Measurement

industry for communicating with instruments from a PC. The physical connection between

the PC and the instrument is USB or Ethernet. NI-VISA is the National Instruments

implementation of the VISA I/O standard. Information and downloads are available at:

http://www.ni.com/visa/

The following example describes the verification that a VISA controller can interact with the

instrument. The images shown and the instructions for your instrument and software may

differ from the examples.

USB Connectivity

1. On the PC, run NI Measurement & Automation Explorer or VISA Interactive Control

and double-click on the TMC Class instrument.

Figure 1-4. Figure 1-4. NI Measurement & Automation Explorer

Autres manuels pour Site Master S331L

Table des matières

Autres manuels Anritsu Instrument de mesure

Anritsu

Anritsu MP1777A Manuel utilisateur

Anritsu

Anritsu MP1590B Manuel utilisateur

Anritsu

Anritsu MS2681A Manuel utilisateur

Anritsu

Anritsu Sire Master S331D Manuel utilisateur

Anritsu

Anritsu MS2690A Manuel utilisateur

Anritsu

Anritsu ms9710b Manuel utilisateur

Anritsu

Anritsu Network Master Series Manuel utilisateur

Anritsu

Anritsu MS2070A Manuel utilisateur

Anritsu

Anritsu Spectrum Master MS2711E Manuel utilisateur

Anritsu

Anritsu ShockLine MS46131A-010 Manuel utilisateur

Anritsu

Anritsu Field Master Pro MS2090A Manuel utilisateur

Anritsu

Anritsu 3656C W1 Manuel utilisateur

Anritsu

Anritsu Spectrum Master MS2720T Manuel du propriétaire

Anritsu

Anritsu Spectrum Master MS2721B Manuel utilisateur

Anritsu

Anritsu Spectrum Master MS2721B Manuel utilisateur

Anritsu

Anritsu VNA Master MS2026C Manuel du propriétaire

Anritsu

Anritsu Power Master MA24507A Manuel utilisateur

Anritsu

Anritsu Bit Master MP1026B Manuel du propriétaire

Anritsu

Anritsu VNA Master MS2026C Manuel utilisateur

Anritsu

Anritsu CMA 5000 - UTA Manuel utilisateur

Anritsu

Anritsu MD1230B Manuel utilisateur

Anritsu

Anritsu MT8801C Manuel utilisateur

Anritsu

Anritsu Site Master S331L Manuel utilisateur

Anritsu

Anritsu MT9083B2 Manuel utilisateur

Manuels Instrument de mesure populaires d'autres marques

Suaoki

Suaoki D40 Manuel utilisateur

Elster

Elster BK-G1.6 Manuel utilisateur

Endress+Hauser

Endress+Hauser Deltabar FMD71 Manuel

Duratool

Duratool D03128 Manuel utilisateur

Vega

Vega VEGAPULS 65 Manuel utilisateur

Tonghui

Tonghui TH2618B Manuel utilisateur

Tenmars

Tenmars TM-801 Manuel utilisateur

MSR

MSR 145 Manuel utilisateur

TPS

TPS WP-82 Manuel utilisateur

ELMETRON

ELMETRON CP-511 Manuel utilisateur

PCB Piezotronics

PCB Piezotronics 003C30 Manuel utilisateur

Tenma

Tenma 72-10465 Manuel utilisateur

Endress+Hauser

Endress+Hauser Proline Promag 50 Caractéristiques techniques

Siemens

Siemens SITRANS F Coriolis FCT030 Manuel de la liste des pièces

KLINGER

KLINGER CMF V Series Manuel utilisateur

EXFO

EXFO FTB-2 Manuel d'exploitation et d'entretien

Keysight

Keysight M8290A Manuel utilisateur

ADTEK

ADTEK MW-5 Manuel utilisateur