Anritsu MG369 C Series Owner's manual

SCPI Programming Manual
MG369xC Series
Synthesized Signal Generators
Anritsu Company
490 Jarvis Drive
Morgan Hill, CA 95037-2809
USA
Part Number: 10370-10375
Revision: E
Published: February 2020
Copyright 2020 Anritsu Company

MG369xC SCPI PM PN: 10370-10375 Rev. E Contents-1
Table of Contents
Chapter 1—General GPIB Information
1-1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1-2 Scope of Manual. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1-3 Related Manuals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1-4 Chapter Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
1-5 IEEE-488 Interface Bus Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Functional Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Bus Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Data Bus Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Data Byte Transfer Control Bus Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
General Interface Management Bus Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
Device Interface Function Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
Message Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
1-6 MG369xC GPIB Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Setting GPIB Operating Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Selecting the Interface Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Response to GPIB Interface Function Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
1-7 Remote Programming Setup and Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
Interface Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
VISA (Virtual Instrument System Architecture) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
Interface Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
1-8 GPIB Interconnection and Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11
GPIB Interconnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11
GPIB Cable Length Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11
Setting the GPIB Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11
Selecting the Line Terminator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
1-9 Ethernet LAN TCP/IP Requirements and Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13
TCP/IP General Requirements and Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13
Ethernet Setup - Static IP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14
Ethernet Setup - DHCP with AutoIP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-17
Testing the TCP/IP Connection Over LAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-19
Example PC Control of MG369xC via LAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-20
Ethernet Control Example in C# Programming using NI VISA . . . . . . . . . . . . . . . . . . . . . 1-22
Resetting Ethernet IP Address to Factory Default. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24

Contents-2 PN: 10370-10375 Rev. E MG369xC SCPI PM
Table of Contents (Continued)
Chapter 2—Programming with SCPI Commands
2-1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
2-2 Introduction to SCPI Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
SCPI Command Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Common Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Required and Optional SCPI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Query Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Command Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Hierarchical Command Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Data Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Unit Suffixes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
2-3 Notational Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
General Notations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Parameter Notations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Notational Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
2-4 SCPI Interface Language Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
Front Panel Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
Remote Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
2-5 Status System Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Status Group Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Status Group Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
2-6 Trigger System Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Trigger System Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Chapter 3—Programming Commands
3-1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
3-2 Common Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
IEEE 488.2 Mandated Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Optional Common Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
3-3 Subsystem Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
3-4 :ABORt Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
3-5 :CONTrol Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
3-6 :DIAGnostic Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
3-7 :DISPlay Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
3-8 :INITiate Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
3-9 :OUTPut Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10

MG369xC SCPI PM PN: 10370-10375 Rev. E Contents-3
Table of Contents (Continued)
3-10 [:SOURce] Subsystems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
[:SOURce]:AM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
[:SOURce]:CORRection Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
[:SOURce]:FM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
[:SOURce]:FREQuency Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
[:SOURce]:LIST Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-29
[:SOURce]:MARKer Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-34
[:SOURce]:PM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-37
[:SOURce]:POWer Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-40
[:SOURce]:PULM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-49
[:SOURce]:PULSe Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-51
[:SOURce]:ROSCillator Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-55
[:SOURce]:SCAN Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-56
[:SOURce]:SWEep Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-56
3-11 :STATus Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-65
3-12 :SYSTem Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-70
3-13 :TRIGger Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-72
3-14 :TSWeep Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-74
3-15 :UNIT Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-75
Chapter 4—Error Messages
4-1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4-2 Error Query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4-3 Error Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4-4 Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4-5 No Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4-6 Command Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
4-7 Execution Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
4-8 Device-Specific Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
4-9 Query Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
4-10 Parser Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
4-11 Self-Test Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Appendix A—Overall Command Tree
A-1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
Appendix B—SCPI Conformance Information
B-1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
Index

Contents-4 PN: 10370-10375 Rev. E MG369xC SCPI PM

MG369xC SCPI PM PN: 10370-10375 Rev. E 1-1
Chapter 1 — General GPIB Information
1-1 Introduction
This manual provides information for remote operation of the Series MG369xC Synthesized High Performance
Signal Generator using commands sent from an external controller via the IEEE-488 General Purpose
Interface Bus (GPIB).
1-2 Scope of Manual
This manual includes the following:
•A general description of the GPIB and the bus data transfer and control functions
•A listing of the IEEE-488 Interface Function Messages recognized by the signal generator with a
description of its response
•A complete listing and description of all the Standard Commands for Programmable Instruments (SCPI)
commands that can be used to control signal generator operation with examples of command usage
•Error messages related to the MG369xC operation
This manual is intended to be used in conjunction with the Series MG369xC Synthesized Signal Generator
Operation Manual, P/N: 10370-10373. Refer to that manual for general information about the MG369xC,
including equipment set up and front panel (manual mode) operating instructions.
1-3 Related Manuals
This is one of a four manual set that consists of an operation manual, a GPIB programming manual, a SCPI
programming manual, and a maintenance manual.
GPIB Programming Manual
The Series MG369xC Synthesized Signal Generator GPIB Programming Manual provides information for
remote operation of the signal generator with product specific commands sent from an external controller via
the IEEE 488 General Purpose Interface Bus (GPIB). It contains a general description of the GPIB and bus
data transfer and control functions, a complete listing and description of all MG369xC GPIB product specific
commands, and several programming examples. The Anritsu part number for the GPIB programming manual
is 10370-10374.
Operation Manual
The Series MG369xC Synthesized Signal Generator Operation Manual provides general information,
installation, and operating information for the Anritsu series MG369xC synthesized signal generator. The
Anritsu part number for the operation manual is 10370-10373.
Maintenance Manual
The Series MG369xC Synthesized Signal Generator Maintenance Manual supplies service information for all
models in the MG369xC series. The service information includes functional circuit descriptions, block
diagrams, performance verification tests, calibration procedures, troubleshooting data, and assembly and
component removal/replacement procedures. The Anritsu part number for the maintenance manual is
10370-10376.

1-4 Chapter Introduction General GPIB Information
1-2 PN: 10370-10375 Rev. E MG369xC SCPI PM
1-4 Chapter Introduction
This chapter provides a general description of the GPIB and the bus data transfer and control functions. It also
contains a listing of the MG369xC’s GPIB interface function subset capability and response to IEEE-488
interface function messages.
The GPIB information presented in this chapter is general in nature. For complete and specific information,
refer to the following documents: ANSI/IEEE Std 488.1-1987 IEEE Standard Digital Interface for
Programmable Instrumentation and ANSI/IEEE Std 488.2-1987 IEEE Standard Codes, Formats, Protocols
and Common Commands. These documents precisely define the total specification of the mechanical and
electrical interface, and of the data transfer and control protocols.
1-5 IEEE-488 Interface Bus Description
The IEEE-488 General Purpose Interface Bus (GPIB) is an instrumentation interface for integrating
instruments, computers, printers, plotters, and other measurement devices into systems. The GPIB uses
16 signal lines to effect transfer of information between all devices connected to the bus.
The following requirements and restrictions apply to the GPIB:
•No more than 15 devices can be interconnected by one contiguous bus; however, an instrumentation
system may contain more than one interface bus.
•The maximum total cumulative cable length for one interface bus may not exceed twice the number of
devices connected (in meters), or 20 meters—whichever is less.
•A maximum data rate of 1 Mb/s across the interface on any signal line.
•Each device on the interface bus must have a unique address, ranging from 00 to 30.
The devices on the GPIB are connected in parallel, as shown in Figure 1-1 on page 1-3. The interface consists of
16 signal lines and 8 ground lines in a shielded cable. Eight of the signal lines are the data lines, DIO 1 thru
DIO 8. These data lines carry messages (data and commands), one byte at a time, among the GPIB devices.
Three of the remaining lines are the handshake lines that control the transfer of message bytes between
devices. The five remaining signal lines are referred to as interface management lines.
The following paragraphs provide an overview of the GPIB including a description of the functional elements,
bus structure, bus data transfer process, interface management bus, device interface function requirements,
and message types.

General GPIB Information 1-5 IEEE-488 Interface Bus Description
MG369xC SCPI PM PN: 10370-10375 Rev. E 1-3
Figure 1-1. Interface Connections and GPIB Bus Structure

1-5 IEEE-488 Interface Bus Description General GPIB Information
1-4 PN: 10370-10375 Rev. E MG369xC SCPI PM
Functional Elements
Effective communications between devices on the GPIB requires three functional elements; a talker, a listener,
and a controller. Each device on the GPIB is categorized as one of these elements depending on its current
interface function and capabilities.
Talker
A talker is a device capable of sending device-dependent data to another device on the bus when
addressed to talk. Only one GPIB device at a time can be an active talker.
Listener
A listener is a device capable of receiving device-dependent data from another device on the bus when
addressed to listen. Any number of GPIB devices can be listeners simultaneously.
Controller
A controller is a device, usually a computer, capable of managing the operation of the GPIB. Only one
GPIB device at a time can be an active controller. The active controller manages the transfer of
device-dependent data between GPIB devices by designating who will talk and who will listen.
System Controller
The system controller is the device that always retains ultimate control of the GPIB. When the system is
first powered-up, the system controller is the active controller and manages the GPIB. The system
controller can pass control to a device, making it the new active controller. The new active controller, in
turn, may pass control on to yet another device. Even if it is not the active controller, the system
controller maintains control of the Interface Clear (IFC) and Remote Enable (REN) interface
management lines and can thus take control of the GPIB at anytime.
Bus Structure
The GPIB uses 16 signal lines to carry data and commands between the devices connected to the bus.
The interface signal lines are organized into three functional groups.
•Data Bus (8 lines)
•Data Byte Transfer Control Bus (3 lines)
•General Interface Management Bus (5 lines)
The signal lines in each of the three groups are designated according to function. Table 1-1 lists these
designations.
Table 1-1. Interface Bus Signal Line Designations
Bus Type Signal Line Name Function
Data Bus DIO1–DIO8 Data Input/Output, 1 thru 8
Data Byte Transfer Control Bus DAV Data Available
NRFD Not Ready For Data
NDAC Not Data Accepted
General Interface Management Bus ATN Attention
IFC Interface Clear
SRQ Service Request
REN Remote Enable
EOI End Or Identify