Remote Spectrum Monitor User Guide : Programming with SCPI
 
Programming with SCPI
 
Introduction
Remote Programming Setup and Interface
Ethernet Interface Connection and Setup
LAN Connection
SCPI Common Commands
*IDN?
*RST
SCPI Required Commands
SCPI Optional Commands
Subsystem Commands
Command Names
Hierarchical Command Structure
Query Commands
Identifiers
Data Parameters
Data Parameter Notations
Notational Conventions
Notational Examples
Command Terminators
Formatting Conventions
SCPI Command Programming Examples
Spectrum Trace Data via SCPI
Spectrum Trace Data Format
I/Q Capture Block Mode
Raw Socket Connection
I/Q Block Capture via SCPI
IQ Capture Data to Absolute Power Level
Stand Alone IQ
Histogram
I/Q Data Format
I/Q Frame Structure
I/Q Extended Frame
I/Q Time Stamp
I/Q Frame Structure with Time Stamp
Time Stamp Boundary Conditions
I/Q Capture Streaming Mode
SCPI Command Files
Introduction
This chapter provides an introduction to Standard Commands for Programming Instruments (SCPI) programming that includes descriptions of the command types, hierarchical command structure, command subsystems, data parameters, and notational conventions.
Remote Programming Setup and Interface
Remote programming and operation of the instrument is accomplished via the Ethernet. The following sections provide information about the interface connections, cable requirements, and remote operation setup.
Caution 
Consult with your network administrator when configuring the network interface to avoid potential loss of access or discovery of the device.
Ethernet Interface Connection and Setup
The MS2710xA fully supports the IEEE-802.3 standard. Instrument functions (except power on/off) can be controlled via an Ethernet connection to a PC connected directly (with an Ethernet cross-over cable) or through a network. The instrument software supports the TCP/IP network protocol.
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, the data is again retransmitted after waiting twice as long. This is known as exponential back off.
The TCP/IP setup requires the following:
IP Address: Every computer and 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 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 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 (MAC address) permanently stored into its memory.
Interface between the instrument and other devices on the network is via a category five (CAT-5) interface cable connected to a network. This cable uses four twisted pairs of insulated copper wires terminated into an RJ45 connector. CAT-5 cabling is capable of supporting frequencies up to 100 MHz and data transfer speeds up to 1 Gbps, which accommodates 1000Base-T, 100Base-T, and 10Base-T networks. CAT-5 cables are based on the EIA/TIA 568 Commercial Building Telecommunications Wiring Standard developed by the Electronics Industries Association.
LAN Connection
The RJ45 connector is used to connect the instrument to a local area network. The instrument IP address can be set automatically using DHCP, or manually by entering the desired IP address, gateway address and subnet mask.