Anritsu Site Master S331L Manual del propietario

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

Otros manuales para Site Master S331L

Tabla de contenidos

Otros manuales de Instrumento de medición de Anritsu

Anritsu

Anritsu VNA Master MS2026C Manual del propietario

Anritsu

Anritsu Field Master Pro MS2090A Manual de usuario

Anritsu

Anritsu MP1570A Manual de usuario

Anritsu

Anritsu MS2830A Manual de usuario

Anritsu

Anritsu MS2711A Manual de usuario

Anritsu

Anritsu MS2830A-040 Manual de usuario

Anritsu

Anritsu MS2711A Manual de usuario

Anritsu

Anritsu LMR Master S412E Manual de usuario

Anritsu

Anritsu MS2690A Manual de usuario

Anritsu

Anritsu 3656C W1 Manual de usuario

Anritsu

Anritsu Microwave Site Master S820E Manual de usuario

Anritsu

Anritsu MS2830A Manual de usuario

Anritsu

Anritsu Spectrum Master MS2720T Manual de usuario

Anritsu

Anritsu Spectrum Master MT8212A Manual de usuario

Anritsu

Anritsu Cell Master MT8212B Manual de usuario

Anritsu

Anritsu VNA master Manual de usuario

Anritsu

Anritsu Network Master Series Manual de usuario

Anritsu

Anritsu MS2024A Manual de usuario

Anritsu

Anritsu ShockLine Series Manual de usuario

Anritsu

Anritsu MT8801C Manual de usuario

Anritsu

Anritsu VectorStar ME7838D4 Manual de usuario

Anritsu

Anritsu HA-100 Series Manual de usuario

Anritsu

Anritsu VectorStar ME7828A Series Manual de usuario

Anritsu

Anritsu Site Master S114C Manual de usuario

Manuales populares de Instrumento de medición de otras marcas

Suaoki

Suaoki D40 Manual de usuario

Elster

Elster BK-G1.6 Manual de usuario

Endress+Hauser

Endress+Hauser Deltabar FMD71 Manual

Duratool

Duratool D03128 Manual de usuario

Vega

Vega VEGAPULS 65 Manual de usuario

Tonghui

Tonghui TH2618B Manual de usuario

Tenmars

Tenmars TM-801 Manual de usuario

MSR

MSR 145 Manual de usuario

TPS

TPS WP-82 Manual de usuario

ELMETRON

ELMETRON CP-511 Manual de usuario

PCB Piezotronics

PCB Piezotronics 003C30 Manual de usuario

Tenma

Tenma 72-10465 Manual de usuario

Endress+Hauser

Endress+Hauser Proline Promag 50 Especificaciones técnicas

Siemens

Siemens SITRANS F Coriolis FCT030 Manual de lista de piezas

KLINGER

KLINGER CMF V Series Manual de usuario

EXFO

EXFO FTB-2 Manual de operación y mantenimiento

Keysight

Keysight M8290A Manual de usuario

ADTEK

ADTEK MW-5 Manual de usuario