Anritsu 68247B GPIB Programming Manual

SERIES

682XXB/683XXB

SYNTHESIZED SIGNAL GENERATORS

GPIB PROGRAMMING MANUAL

490 JARVIS DRIVE
MORGAN HILL, CA 95037-2809

P/N: 10370-10286

PRINTED: NOVEMBER 1996

COPYRIGHT 1994 WILTRON CO.

REVISION: D

WARRANTY

The WILTRON product(s) listed on the title page is (are) warranted against defects in materials
and workmanship for one year from the date of shipment, except for YIG-tuned oscillators and all
WILTRON manufactured microwave components, which are warranted for two years.

WILTRON’s obligation covers repairing or replacing products which prove to be defective during the
warranty period. Buyers shall prepay transportation charges for equipment returned to WILTRON
for warranty repairs. Obligation is limited to the original purchaser. WILTRON is not liable for
consequential damages.

LIMITATION OF WARRANTY

The foregoing warranty does not apply to WILTRON connectors that have failed due to normal wear.
Also, the warranty does not apply to defects resulting from improper or inadequate maintenance by
the Buyer, unauthorized modification or misu se, or operation outside of the environmental spec ifi­cations of the product. No other warranty is expressed or implied, and the remedies provided herein
are the Buyer’s sole and exclusive remedies.

TRADEMARK ACKNOWLEDGEMENTS

Adobe Acrobat is a registered trademark of Adobe Systems Incorporated.

NOTICE

WILTRON Company has prepared this manual for use by WILTRON Company personnel and
customers as a guide for the proper installation, operation, and maintenance of WILTRON Company
equipment and computor programs. The drawings, specifications, and information contained herein
are the property of WILTRON 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 wit hout the
prior writtten consent of WILTRON Company.

TABLE OF CONTENTS

Chapter 1 — General GPIB Information

Chapter 1 provides a general description of the General Purpose Interface Bus (GPIB) and the bus

data transfer and control functions. It also contains a listing of the 682XXB/683XXB’s GPIB inter­face function subset capability and response to IEEE-488 interface function messages. Chapter con­tents are detailed immediately following the tab.

Chapter 2 — Programming with 682XXB/683XXB GPIB Commands

Chapter 2 provides information for remote operation of the Series 682XXB/683XXB Synthesized
Signal Generators via the GPIB using 682XX B/683XXB GPIB commands. All GP IB Product-Spe­cific commands that are accepted and implemented by the 682XXB/683XXB are listed and de­scribed by function. Sample programs showing usage of the commands are also included. Chapter
contents are detailed immediately follo wing the tab.

Appendix A — Index of GPIB Commands

Appendix A provides an alphabetical index of t he GPIB Product-Specific commands for the
682XXB/683XXB.

682XXB/683XXB PM i/ii

Chapter 1
General GPIB Information

Table of Contents

1-1 SCOPE OF MANUAL . . . . . . . . . . . . . . . . 1-3

Electronic Man ual . . . . . . . . . . . . . . . . . 1-3

1-2 INTRODUCTION . . . . . . . . . . . . . . . . . . 1-3

1-3 IEEE-488 INTERFACE BUS DESCRIPTION . . . 1-5

Functional Elements . . . . . . . . . . . . . . . . 1-6

Bus Structure . . . . . . . . . . . . . . . . . . . . 1-7

Data Bus Description . . . . . . . . . . . . . . . . 1-7

Data Byte Transfer Control Bus Description . . . 1-8

General Interface Management Bus Description . 1-9

Device Interface Function Capability . . . . . . . 1-10

Message Types . . . . . . . . . . . . . . . . . . . 1-11

1-4 682XXB/683XXB GPIB OPERATION . . . . . . . . 1-13

Setting GPIB Operating Parameters . . . . . . . 1-13

Selecting the Interface Language . . . . . . . . . 1-13

Response to GPIB Interface Function Messages . 1-13

Chapter 1
General GPIB Information

1-1

SCOPE OF MANUAL

This manual provides information for remote operation of the Series
682XXB/683XXB Synthesized Signal Generators using commands
sent from an external controller via the IEEE-488 General Purpose
Interface Bus (GPIB). It 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 recog­nized by the signal generator with a description of its response.
A c omplete listing and description of all 682XXB/683XXB GPIB
commands (i.e., Product Specific Commands) that can be used to
control signal generator operation with programming examples.

This manual is intended to be used in conjunction with the Series
682XXB/683XXB Synthesized Signal Generators Operation Manual,
P/N 10370-10284. Refer to that manual for general information about
the 682XXB/683XXB, including equipment set up and front panel
(manual mode) operating instructions.

Electronic
Manual

This manual is available on CD ROM as an Adobe
Acrobat Portable Document Format (∗.pdf) file. The
file can be viewed using Acrobat Reader, a free pro­gram that is also included on the CD ROM. The file

is “linked” such that the viewer can choose a topic to
view from the displayed “bookmark” list and “jump”
to the manual page on which the topic resides. The
text can also be word-searched. Contact
Customer Service for price and availability.

WILTRON

1-2

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
682XXB/683XXB’s GPIB interface function subset capability and re­sponse 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 docu­ments: 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 me­chanical and electrical interface, and of the data transfer and control
protocols.

682XXB/683XXB PM 1-3

GENERAL GPIB IEEE-488 INTERFACE
INFORMATION BUS DESCRIPTION

IEEE-488 BUS (16 Lines)

DEVICE A

Able to talk, listen,
and control

(e.g. COMPUTER)

DEVIC E B

Able to talk and listen

(e.g. 682XXB/683XXB
SIGNAL
GENERATOR)

DEVICE C

Data Bus
(8 signal lines)

Data Byte Transfer
Control Bus

(3 sign al l in es )

DATA LINES

HANDSHAKE Lines

Only able to listen

(e.g. OTHER
INSTRUMENT**)

DEVICE D

Only able to talk

(e.g. OTHER
INSTRUMENT**)

General Interface
Management Bus

(5 sign al l in es )

DATA
INPUT/OUTPUT, DIO
1 thru DIO 8
DAV - DATA VALID

NRFD - NOT READY FOR DATA*
NDAC - NOT DATA ACCEPTED*

IFC - INTERFACE CLEAR
ATN - ATTENT ION
SRQ - SERVI CE REQUE ST
REN - REMOTE ENABLE
EOI - END OR IDEN TI FY

* NEGATION IS REPRESENTED BY
LOW STATE ON THESE TWO
LINES

** IF USED

Figure 1-1. Interface Connections and GPIB Bus Structure

Management
CONTROL Lines

1-4 682XXB/683XXB PM

GENERAL GPIB IEEE-488 INTERFACE
INFORMATION BUS DESCRIPTION

1-3

IEEE-488 INTERFACE
BUS DESCRIPTION

The IEEE-488 General Purpose Interface Bus (GPIB) is an instrumen­tation interface for integrating instruments, computers, printers, plot­ters, and other measurement devices into systems. The GPIB uses 16
signal lines to effect transfer of information between all devices con­nected on 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 twic e the number of devices connected (in me-

ters), or 20 meters—whichever is less.
A maximum data rate of 1 Mb/s across the interface on any sig­nal 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. 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 be­tween devices. The five remaining signal lines are referred to as inter­face management lines.

The following paragraphs provide an overview of the GPIB including a
description of the functional elements, bus structure, bus data trans­fer process, interface management bus, device interface function re­quirements, and message types.

682XXB/683XXB PM 1-5

GENERAL GPIB IEEE-488 INTERFACE
INFORMATION BUS DESCRIPTION

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-de­pendent data to another device on the bus when ad­dressed to talk. Only one GPIB device at a time can
be an active talker.

Listener

A listener is a device capable of receiving device-de­pendent data from another device on the bus when
addressed to listen. Any number of GPIB devices
can be listeners simultaneously.

Controller

A c on troller 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 designat­ing who will talk and who will listen.

System Controller

The system controller is the device that always re­tains ultimate control of the GPIB. When the sys­tem is first powered-up, the system controller is the
active controller and manages the GPIB. The sys­tem controller can pass control to a device, making
it the new active controller. The new active control­ler, in turn, may pass control on to yet another de­vice. 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 con trol of the
GPIB at anytime.

1-6 682XXB/683XXB PM

GENERAL GPIB IEEE-488 INTERFACE
INFORMATION BUS DESCRIPTION

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 des­ignated according to function. T able 1-1 lists these
designations.

Table 1-1. Interface Bus Signal Line Designations

DAV
NRFD
NDAC

ATN
IFC
SRQ
REN
EOI

Signal Line

Name

Function

Data Availa ble
Not Ready For Data
Not Data Accepted

Attention
Interface Clear
Service Request
Remote Enable
End Or Identify

Bus Type

Data Bus D IO1–DIO8 Data Input/Output, 1 thru 8
Data Byte

Transfer
Control Bus

General
Interface
Management
Bus

Data Bus
Description

The data bus is the conduit for the transfer of data
and commands between the devices on the GPIB. It
contains eight bi-directional, active-low signal lines

—DIO 1 thru DIO 8. Data and commands are trans­ferred over the data bus in byte-serial, bit-parallel
form. This means that one byte of data (eight bits)
is transferred over the bus at a time. DIO 1 repre­sents the least-significant bit (LSB) in this byte and
DIO 8 represents the most-significant bit (MSB).
Bytes of data are normally formatted in seven-bit
ASCII (American Standard Code for Information In­terchange) code. The eighth (parity) bit is not used.

Each byte placed on the data bus represents either
a command or a data byte. If the Attention (ATN) in­terface management line is TRUE while the data is
transferred, then the data bus is carrying a bus com­mand which is to be received by every GPIB device.
If ATN is FALSE, then a data byte is being trans­ferred and only the active listeners will receive that
byte.

682XXB/683XXB PM 1-7

GENERAL GPIB IEEE-488 INTERFACE

1st Data Byte 2nd Data Byte

Valid

Not

Valid

Valid

Not

Valid

All

Ready

None

Ready

All

Ready

None

Ready

All

Accept

None

Accept

None

Accept

All

Accept

DIO1-DIO8

(composite)

DAV

NRFD

NDAC

INFORMATION BUS DESCRIPTION

Figure 1-2. Typical GPIB Handshake Operation

Data Byte
Transfer
Control Bus
Description

Control of the transfer of each byte of data on the
data bus is accomplished by a technique called the

“three-wire handshake”, which involves the three
signal lines of the Data Byte Transfer Control Bus.
This technique forces data transfers at the speed of
the slowest listener, which ensures data integrity in
multiple listener transfers. One line (DAV) is con­trolled by the talker, while the other two (NRFD
and NDAC) are wired-OR lines shared by all active
listeners. The handshake lines, like the other GPIB
lines, are active low. The technique is described
briefly in the following paragraphs and is depicted
in Figure 1-2. For further information, refer to
ANSI/IEEE Std 488.1.

DAV (Data Valid)

This line is controlled by the active talker. Before
sending any data, the talker verifies that NDAC is
TRUE (active low) which indicates that all listeners
have accepted the previous data byte. The talker
then places a byte on the data lines and waits until
NRFD is FALSE (high) which indicates that all ad­dressed listeners are ready to accept the informa­tion. When both NRFD and NDAC are in the proper
state, the talker sets the DAV line TRUE (active
low) to indicate that the data on the bus is valid
(stable).

NRFD (Not Ready For Data)

This line is used by the listeners to inform the
talker when they are ready to accept new data. The
talker must wait for each listener to set the NRFD
line FALSE (high) which they will do at their own

1-8 682XXB/683XXB PM

GENERAL GPIB IEEE-488 INTERFACE
INFORMATION BUS DESCRIPTION

rate. This assures that all devices that are to accept
the data are ready to receive it.

NDAC (Not Data Accepted)

This line is also controlled by the listeners and is
used to inform the talker that each device ad­dressed to listen has accepted the data. Each device
releases NDAC at its own rate, but NDAC will not
go FALSE (high) until the slowest listener has ac­cepted the data byte.

General
Interface
Management
Bus
Description

The general interface management bus is a group of
five signal lines used to manage the flow of informa­tion across the GPIB. A description of the function
of each of the individual control lines is provided be­low.

ATN (Attention)

The active controller uses the ATN line to define
whether the information on the data bus is a com­mand or is data . When ATN is TRUE (low), the bus
is in the command mode and the data lines carry
bus commands. When ATN is FALSE (high), the bus
is in the data mode and the data lines carry device­dependent instructions or data.

EOI (End or Identify)

The EOI line is used to indicate the last byte of a
multibyte data transfer. The talker sets the EOI
line TRUE during the last data byte.

The active controller also uses the EOI line in con­junction with the ATN line to initiate a parallel poll
sequence.

IFC (Interface Clear)

Only the system controller uses this line. When IFC
is TRUE (low), all devices on the bus are placed in a
known, quiescent state (unaddressed to talk, unad­dressed to listen, and service request idle).

REN (Remote Enable)

Only the system controller uses this line. When
REN is set TRUE (low), the bus is in the remote
mode and devices are addressed either to listen or
to talk. When the bus is in remote and a device is
addressed, it receives instructions from the GPIB
rather than from its front panel. When REN is set
FALSE (high), the bus and all devices return to lo­cal operation.

682XXB/683XXB PM 1-9

GENERAL GPIB IEEE-488 INTERFACE
INFORMATION BUS DESCRIPTION

SRQ (Service Request)

The SRQ line is set TRUE (low) by any device re­questing service by the active controller.

Device
Interface
Function
Capability

An interface function is the GPIB system element
which provides the basic operational facility
through which a device can receive, process, and
send messages. Each specific interface function may
only send or receive a limited set of messages
within particular classes of messages. As a result, a
set of interface functions is necessary to achieve
complete communications among devices on the
GPIB. ANSI/IEEE Std 488.1 defines each of the
interface functions along with its specific protocol.

ANSI/IEEE Std 488.2 specifies the minimum set of
IEEE 488.1 interface capabilities that each GPIB de­vice must have. This minimum set of interface func­tions assures that the device is able to send and
receive data, request service, and repond to a device
clear message. Table 1-2 lists the interface function
capability of the series 682XXB/683XXB signal gen­erators.

Table 1-2. 682XXB/683XXB Interface Function Capability

Function
Identifier

AH1 Acceptor Handshake Complete Capability

Function 682XXB/683XXB Capability

SH1 Source Handshake Complete Capabil ity

T6 Talker No Talk Only (TON)

L4 Listener No Listen Only (LON)
SR1 Service Request Complete Capability
RL1 Remote/Local Complete Capability
PP1 Parallel Poll Complete Capability
DC1 Device Clear Complete Capability
DT1 Device Trigger Complete Capability

C0, C1, C2,

C3, C28

E2 Tri-State Drivers Three-state bus drivers

Controller Capability
Options

C0, No Capability;
C1, System Controller;
C2, Send IFC and Take Charge;
C3, Send REN;
C28, Send IF Messages

1-10 682XXB/683XXB PM

GENERAL GPIB IEEE-488 INTERFACE
INFORMATION BUS DESCRIPTION

Message
Types

There are three types of information transmitted

over the GPIB—interface function messages, device­specific commands, and data and instrument status
messages.

Interface Function Messages

The controller manages the flow of information on
the GPIB using interface function messages, usu­ally called commands or command messages. Inter-
face function messages perform such functions as
initializing the bus, addressing and unaddressing
devices, and setting device modes for remote or local
operation.

There are two types of commands—multiline and
uniline. Multiline commands are bytes sent by the
active controller over the data bus (DIO1-DIO8)
with ATN set TRUE. Uniline commands are signals
carried by the individual interface management
lines.

The user generally has control over these com­mands; however, the extent of user control depends
on the implementation and varies with the specific
GPIB interface hardware and software used with
the external controller.

Device-Specific Commands

These commands are keywords or mnemonic codes
sent by the external controller to control the setup
and operation of the addressed device or instru­ment. The commands are normally unique to a par­ticular instrument or class of instruments and are
described in its documentation.

Device-specific commands are transmitted over the
data bus of the GPIB to the device in the form of
ASCII strings containing one or more keywords or
codes.They are decoded by the device’s internal con-
troller and cause the various instrument functions
to be performed.

Data and Instrument Status Messages

These messages are sent by the device to the exter­nal controller via the GPIB. They contain measure­ment results, instrument status, or data files that
the device transmits over the data bus in response
to specific requests from the external controller. The
contents of these messages are instrument specific
and may be in the form of ASCII strings or binary
data.

682XXB/683XXB PM 1-11

GENERAL GPIB IEEE-488 INTERFACE
INFORMATION BUS DESCRIPTION

In some cases data messages will be transmitted
from the external controller to the device. For exam­ple, messages to load calibration data.

An SRQ (service request) is an interface function
message sent from the device to the external control­ler to request service from the controller, usually
due to some predetermined status condition or er­ror. To send this message, the device sets the SRQ
line of the General Interface Management Bus true,
then sends a status byte on the data bus lines.

An SRQ interface function message is also sent by
the device in response to a serial poll message from
the controller, or upon receiving an Output Status
Byte(s) command from the controller. The protocols
associated with the SRQ functions are defined in
the ANSI/IEEE Std 488.2 document.

The manner in which interface function messages
and device-specific commands are invoked in pro­grams is implementation specific for the GPIB inter­face used with the external controller. Even though
both message types are represented by mnemonics,
they are implemented and used in different ways.

Normally, the interface function messages are sent
automatically by the GPIB driver software in re­sponse to invocation of a software function. For ex­ample, to send the
fuction message, one would call the
the National Instruments software driver. On the
other hand, the command
command string to the addressed device. In the case
of the National Instruments example, this would be
done by using the

IFC (Interface Clear) interface

ibsic function of

*RST (Reset) is sent in a

ibwrt function call.

1-12 682XXB/683XXB PM

GENERAL GPIB 682XXB/683XXB
INFORMATION GPIB OPERATION

1-4

682XXB/683XXB GPIB
OPERATION

All Series 682XXB/683XXB Synthesized Signal Generator functions,
settings, and operating modes (except for power on/standby) are con­trollable using commands sent from an external controller via the
GPIB. When in the remote (GPIB) mode, the signal generator func­tions both as a listener and a talker. The GPIB interface function capa­bility of the 682XXB/683XXB is listed in Table 1-2 (page 1-10).

Setting
GPIB
Operating
Parameters

Selecting the
Interface
Language

The 682XXB/683XXB leaves the factory with the
GPIB address value set to
terminator set to carriage return and line feed

CR/LF). A different address value can be entered

(
from the front panel using the Configure GPIB
menu. Using this same menu, the data delimiting
terminator can be changed to carriage return (
only. Refer to Chapter 2 of the Series 682XXB/
683XXB Synthesized Signal Generators Operation
Manual for the procedure.

Series 682XXB/683XXB Synthesized Signal Gener­ators with Option 19 can be remotely operated us-

ing one of two external interface languages—Native
or SCPI. The Native interface language uses a set of
682XXB/683XXB GPIB Product-Specific commands
to control the instrument; the SCPI interface lan­guage uses a set of the Standard Commands for Pro­grammable Instruments commands to control the
unit. Selecting which of these external interface lan­guages is to be used can be done from the front
panel using the Configure GPIB menu. Refer to
Chapter 2 of the Series 682XXB/683XXB Synthe­sized Signal Generators Operation Manual for the
procedure.

5 and the data delimiting

CR)

Response to
GPIB
Interface
Function
Messages

Table 1-3 (page 1-14) lists the GPIB Interface Func­tion Messages that the 682XXB/683XXB will recog­nize and respond to. With the exception of the
Device Clear and Selected Device Clear messages,
these messages affect only the operation of th e
682XXB/683XXB GPIB interface. The 682XXB/
683XXB response for each message is indicated.

Interface function messages are transmitted on the
GPIB data lines and interface management lines as
either unad dressed or addressed commands. The
manner in which these messages are invoked in pro­grams is implementation dependent. For program­ming information, refer to the documentation
included with the GPIB Interface for the external
controller used.

682XXB/683XXB PM 1-13

GENERAL GPIB 682XXB/683XXB
INFORMATION GPIB OPERATION

Table 1-3. 682XXB/683XXB Response to GPIB In terface Function Messages

Interface Function Message

Addressed

Command

682XXB/683XXB Response

Device Clear (DCL)
Selected Device Clear (SDC)

Go To Local (GTL) Yes Returns the 682XXB/683XXB to

Group Execute Trigger
(GET)

Interface Clear (IFC) No Stops the 682XXB/683XXB GPIB

Local Lockout (LLO) No Disables the front panel menu

Remote Enable (REN) No Places the 682XXB/683XXB under

Serial-Poll Enable (SPE) No Outputs the serial-poll status byte.
Serial-Poll Disable (SPD) No Disables the serial-p ol l fu nc ti on .
Parallel-Poll Configure (PPC) Yes Respo nd s to a para ll el -po ll

No

Yes

Yes Executes a string of commands, if

Resets the 682XXB/683XXB to its
default state. (Equivalent to sending
the *RST command.)

local (front panel) control.

programmed.

interface from listening or talking.
(The front panel controls are not
cleared.)

RETURN TO LOCAL soft-key.

remote (GPIB) control when it has
been addressed to listen.

message (PPOLL) by setting
assigned data bus line to the logi ca l
state (1,0) that indicates its correct
SRQ status.

Parallel-Poll Unconfigure
(PPU)

No Disables the paralle l-p ol l fu nc ti on .

1-14 682XXB/683XXB PM

Chapter 2
Programming with
GPIB Commands

Table of Contents

2-1 INTRODUCTION . . . . . . . . . . . . . . . . . . 2-5

2-2 COMMAND CODES . . . . . . . . . . . . . . . . . 2-5

2-3 DATA INPUT RESTRICTIONS . . . . . . . . . . . 2-8

2-4 PARAMETER AND DATA ENTRY COMMANDS . 2-9

Opening a Parameter . . . . . . . . . . . . . . . . 2-9

Data Entry . . . . . . . . . . . . . . . . . . . . . 2-9

Using the SYZ Command . . . . . . . . . . . . . . 2-17

2-5 CW FREQUENCY COMMANDS . . . . . . . . . . 2-18

2-6 ANALOG AND STEP SWEEP COMMANDS . . . . 2-19

Sweep Range . . . . . . . . . . . . . . . . . . . . 2-19

Alternate Sweep . . . . . . . . . . . . . . . . . . . 2 -20

Sweep Triggering . . . . . . . . . . . . . . . . . . 2-20

Analog/Step Sweep Select . . . . . . . . . . . . . 2-22

Special Step Sweep . . . . . . . . . . . . . . . . . 2-24

2-7 FREQUENCY MARKER COMMANDS . . . . . . 2-24

2-8 OUTPUT POWER LEVELING COMMANDS . . . 2-26

RF Output Power Level Selection . . . . . . . . . 2-26

Alternate Sweep RF Output Power Level Selection2-26

Output Power Leveling . . . . . . . . . . . . . . . 2-26

ALC Power Slope . . . . . . . . . . . . . . . . . . 2-29

Attenuator Decoupling . . . . . . . . . . . . . . . 2-29

Table of Contents (Continued)

2-9 MODULATION COMMANDS . . . . . . . . . . . . 2-30

Amplitude Modulation . . . . . . . . . . . . . . . 2-30

Frequency Modulation . . . . . . . . . . . . . . . 2-31

Phase Modulati on . . . . . . . . . . . . . . . . . . 2-32

Pulse Modulati on . . . . . . . . . . . . . . . . . . 2-33

2-10 MEASURE FUNCTION COMMANDS . . . . . . . 2-41

2-11 OUTPUT COMMANDS . . . . . . . . . . . . . . . 2-42

2-12 STORED SETUP COMMANDS . . . . . . . . . . . 2-47

2-13 SRQ AND STATUS BYTE COMMANDS . . . . . . 2-49

Status Bytes . . . . . . . . . . . . . . . . . . . . . 2-49

SRQ Generation . . . . . . . . . . . . . . . . . . . 2-49

2-14 CONFIGURATION COMMANDS . . . . . . . . . . 2-54

2-15 GROUP EXECUTE TRIGGER COMMANDS . . . 2-55
2-16 FAST-FREQUENCY-SWITCHING COMMANDS . 2-56

2-17 POWER-OFFSET-TABLE COMMANDS . . . . . . 2-57

Loading the Power-Offset Table . . . . . . . . . . 2-57

2-18 USER LEVEL CALIBRATION COMMANDS . . . 2-60

Editing the Table Data . . . . . . . . . . . . . . . 2-64

2-19 MASTER-SLAVE OPERATION COMMANDS . . . 2-68

2-20 SELF TEST COMMAND . . . . . . . . . . . . . . 2-69

2-21 MISCELLANEOUS COMMANDS . . . . . . . . . 2-71

2-22 PROGRAM ERRORS . . . . . . . . . . . . . . . . 2 -72

Invalid-Parameter . . . . . . . . . . . . . . . . . 2-72

Syntax . . . . . . . . . . . . . . . . . . . . . . . . 2-72

2-2 682XXB/683XXB PM

Table of Contents (Continued)

2-23 RESET PROGRAMMING AND DEFAULT

CONDITIONS . . . . . . . . . . . . . . . . . . . . 2-73

2-24 PROG RAM MIN G EXAM PL ES . . . . . . . . . . . 2-74

682XXB/683XXB PM 2-3/2-4

Chapter 2
Programming with
GPIB Commands

2-1

2-2

INTRODUCTION

COMMAND CODES

This chapter provides information for remote operation of the Series
682XXB/683XXB Synthesized Signal Generators via the GPIB using
682XXB/683XXB GPIB commands. All GPIB Product-Specific com­mands that are accepted and implemented by the 682XXB/683XXB are
listed and described by function. Sample programs showing usage of
the commands are also included.

There are over three hundred and fifty GPIB Product-Specific com­mands that are accepted and implemented by the 682XXB/683XXB.
These GPIB commands allow the user to program all front panel and
menu functions (except for power on/standby). Each GPIB command is
a two- or three-character mnemonic code that represents an instru­ment command or parameter; for example:

Table 2-1, beginning on page 2-6, is a listing of all 682XXB/683XXB
GPIB command mnemonic codes grouped into functional categories.
The listing for each category includes references to the paragraph and
page number in this chapter where a complete description of that
group of commands can be found.

NOTE

A quick way to determine the function of any of the GPIB
command codes listed in Table 2-1 is to look up the command
code of interest in Appendix A of this manual. Appendix A is an
alphabetical index of all 682XXB/683XXB GPIB command
mnemonic codes. A brief description of the function of each
command is also included.

RST (reset).

682XXB/683XXB PM 2-5

PROGRAMMING WITH COMMAND
682XXB/683XXB GPIB COMMANDS CODES

Table 2-1. 682XXB/683XXB GPIB Command Codes Listed by Function (1 of 3)

GPIB Command
Group Function

Parameter Entry
Commands

Data Entry/
DataTerminator
Commands

CW Frequency
Commands

Command Codes Para. Page

F0, F1, F2, F3, F4 , F5, F6, F7, F8, F9, M0,
M1, M2, M3, M4, M5, M6, M7, M8, M9,
XL0, XL1, XL2, XL3, XL4, XL5, XL6, XL7,
XL8, XL9, DLF, DFF, DFM, SLF0, SLF1,
SLF2, SLF3, SLF4, SLF5, SLF6, SLF7,
SLF8, SLF9, SLM0, SLM1, SLM2, SLM3,
SLM4, SLM5, SLM6, SLM7, SLM8, SLM9,
SLDF, SDT , SNS, SWT, LOS, PDT, PNS,
ADP1, ADP2, AMR, AMS, ASD, FDV,
FMR, FMS, PHD, PHR, PHS, PER, PR,
PW, W1, W2, W3, W4, PDY, D1, D2, D3,
D4, PVT, SDD, SDE, SDL, SDS,SLP, SOF,
SLV, SLL1, SLL2, EGI, ADD, F RS, SYZ,
UP, DN, CLO

0 thru 9, –, ., ADR, CLR, DB, DM, GH, MH,
KH, HZ, SEC, MS, US, NS, PCT, RD, GV,
MV, KV, DV, PCV, RV, SPS, TMS

CF0, CF1, CF2, CF3, CF4, CF5, CF6,
CF7, CF8, CF9, CM0, CM1, CM2, CM3,
CM4, CM5, CM6, CM7, CM8, CM9, SQF,
SQU, SQD, ACW

2-4 2-9

2-4 2-15,

2-16

2-5 2-18

Analog and Step
Sweep Commands

Frequency Ma rke r
Commands

Output Power
Leveling
Commands

Modulation
Commands

SF1, SF3, FUL, DF0, DF1, DF5, DF6,
AFU, AF1, AF3, AD1, AD5 , AD6, AUT, EXT,
TRG, TRS, RSS, SWP, SSP, MAN, DU1,
DU0, TSS, SP1, SP0

ME1, ME0, MK0, IM1, VM1 2-7 2-24

L0, L1, L2, L3, L4, L5, L6, L7, L8, L9, AL0,
AL1, AL2, AL3, AL4, AL 5, AL6, AL7, AL8 ,
AL9, RF1, RF0, LO1, LO0, IL1, DL1, PL1,
ELF, ELR, LV0, LSP, AT0, AT1, ATT(x x),
SL0, SL1, EGO

AM0, AM1, AM2, AM3, AM4, AM5, AM6,
AM7, AM8, AMW(x), FM0, FM1, FM2,
FM3, FM4, FM5, FM6, FM7, FM8, FM9,
FMN, FMW, FML, FMU, FWV(x), PH0,
PH1, PH2, PH3, PH4, PH5, PH6, PH7,
PH8, PHN, PHW, PHV(x), P0, IP, XP, P3,
P4, PC1, PC4, PMD(x), PTG(x), PTR,
PTF, GP, DPT, SD0, SD1, SQP, SW0,
SW1, SW2, SW3, SW4, SW5, SW6, SC0,
SC1

2-6 2-19

2-8 2-26

2-9 2-30

2-6 682XXB/683XXB PM

PROGRAMMING WITH COMMAND
682XXB/683XXB GPIB COMMANDS CODES

Table 2-1. 682XXB/683XXB GPIB Command Codes Listed by Function (2 of 3)

GPIB Command
Group Function

Measure Function
Commands

Output Commands OI, OFL, OFH, OF0, OF1, OF2, OF3, OF4,

Stored Setup
Commands

Service Request
and Status Byte
Commands

AMI, FMD, MOM, PM1, PM0 2-10 2-41

OF5, OF6, OF7, OF8, OF9, OM0, OM1,
OM2, OM3, OM4, OM5, OM6, OM7, OM8,
OM9, OL0, OL1, OL2, OL3, OL4, OL5,
OL6, OL7, OL8, OL9, OLO, ODF, OPD,
OPS, OSD, OSS, OST, OAD1, OAD2,
OAR, OAW, OAS, OAB, OAI, OAE, OFD,
OFR, OFW, OFK, OFS, OFI, OFE, OPR,
OPP, OPW, OW1, OW2, OW3, OW4, ODP,
OD1, OD2, OD3, OD4, ODD, ODE, ODL,
ODS, OMD, OPC, OPT, OP5, OP3, OMM,
OPHD, OPHR, OPHW, OPHM, OPHS,
OPHI, OPHE, OPM, OVN, OWT, OSE,
OEM, OES, OSB,OSM, OSR

SAF, SAM, SM, SSN(M
RSN(M

ES1, ES0, FB1, FB0, LE1, LE0, MB0,
MB1, MB2, PE1, PE0, SB1, SB0, SE1,
SE0, SQ1, SQ0, UL1, UL0, LS1, LS0, EL1,
EL0, II1, II0, CSB

Command Codes Para. Page

), RCF, RCM,

1-9

)

1-9

2-11 2-42

2-12 2-47

2-13 2-49

Configuration
Commands

Group Execute
Trigger (GET)
Commands

Fast-Frequency­Switching
Commands

Power-Offset­Table Commands

User Level
Calibration
Commands

Master-Slave
Operation
Commands

Self Test
Command

BPN, BPP, EP0, EP1, FRS, PPO, PPC,
RC0, RC1, RT0, RT1, RO0, RO1

GTC, GTD, GTF, GTL, GTO, GTS, GTT,
GTU, Y

ZL(X

PT0, PT1, PTC, PTL 2-17 2-57

LU0, LU1, LU2, LU3, LU4, LU5, LUS, LUR 2-18 2-60

S0, S1 2-19 2-68

TST 2-20 2-69

000-999

), ZEL, ZS(X

000-999)

2-14 2-54

2-15 2-55

2-16 2-56

682XXB/683XXB PM 2-7

PROGRAMMING WITH DATA INPUT
682XXB/683XXB GPIB COMMANDS RESTRICTIONS

Table 2-1. 682XXB/683XXB GPIB Command Codes Listed by Function (3 of 3)

2-3

DATA INPUT
RESTRICTIONS

GPIB Command
Group Function

Miscellaneous
Commands

The 682XXB/683XXB signal generator does not accept parameter or
data entries in an exponential or scientific notation format. The ac­cepted data formats are as follows:

A decimal or integer format for entering parameters and data.
A binary-byte format for entering the status byte mask com­mands (paragraph 2-13), the
mands (paragraph 2-12), the power-offset-table commands (para­graph 2-17), and the
(paragraph 2-18).

Programming Note: The signal generator only recognizes the follow­ing 65 characters:

The 52 upper- and lower-case alphabetic characters. (The 682XXB/
683XXB accepts both upper- and lower-case characters without
distinguishing between the cases).

The minus sign (–).
The comma (,).
The decimal point (.).
The numerals between 0 and 9.

ADD, CS0, CS1, DS0, DS1, RL, RST, SNR 2-21 2-71

Command Codes Para. Page

RCF and RCM stored-setup com-

LUR user level calibration command

All characters other than the 65 listed above are ignored and can be in­terspersed between meaningful characters without ill effect. This use
of other characters can improve readability. For example, the two com­mand strings below are valid and interchangable.

F12.754GHF27.792GHSF1SWPMK0L12DM”

“

F1=2.754 GH, F2=7.792 GH, SF1, SWP, MK0, L1=2 DM”

“

2-8 682XXB/683XXB PM

PROGRAMMING WITH PARAMETER AND DATA
682XXB/683XXB GPIB COMMANDS ENTRY COMMANDS

2-4

P ARAMETER AND DATA
ENTRY COMMANDS

Table 2-2 lists the command mnemonic codes that open parameters for
data entry. The table also provides the range of values permitted for
each parameter and the data terminator mnemonic codes for each.
Tables 2-3 and 2-4 (pages 2-15 and 2-16) list the data entry and data
terminator command mnemonic codes.

Opening a
Parameter

Data Entry When a parameter is open for data entry, its value

All of the commands listed in Table 2-2 open a pa­rameter for data entry. Once opened, a parameter re­mains open until one of the following occurs:

Another parameter is opened.
A function other than video markers, intensity
markers, or output power leveling is com­manded.
The CLO (close open parameter) command is re­ceived.

can be changed as follows:

By sending a numeric value followed by the ap­propriate terminator code.
By incrementing or decrementing its value us­ing an associated step size.

NOTE

An appropriate data terminator must be
used to terminate a numeric-parame ter en­try, and it must immediately f ollow the nu­meric value. If it does not, a parame ter entry
error will result.

The parameter and data entry commands do not affect the signal gen-

erator’s output unless the parameter being changed is also the current
output parameter. The commands, therefore, may be used to change
the preset values of parameters without altering the 682XXB/683XXB
output.

Example: Assume that the 682XXB/683XXB is executing an F3-F4
sweep from 3 GHz to 10 GHz. Changing the value of F1 to 3 GHz with
the command string “
the signal generator. However, changing the value of F4 with the com­mand string “
because it changes the end point of the F3-F4 sweep to 16.01 GHz.

F4 16.01 GH” alters the output of the 682XXB/683XXB

F1 3 GH” does not affect the current output of

682XXB/683XXB PM 2-9

PROGRAMMING WITH PARAMETER AND DATA
682XXB/683XXB GPIB COMMANDS ENTRY COMMANDS

Table 2-2. Parameter Entry Commands (1 of 6)

MNEMONIC

CODE

F0
F1
F2
F3
F4
F5
F6
F7
F8
F9

M0
M1
M2
M3
M4
M5
M6
M7
M8
M9

XL0
XL1
XL2
XL3
XL4
XL5
XL6
XL7
XL8
XL9

PARAMETER VALUES

Opens the F0 parameter
Opens the F1 parameter
Opens the F2 parameter
Opens the F3 parameter
Opens the F4 parameter
Opens the F5 parameter
Opens the F6 parameter
Opens the F7 parameter
Opens the F8 parameter
Opens the F9 parameter

Opens the M0 parameter
Opens the M1 parameter
Opens the M2 parameter
Opens the M3 parameter
Opens the M4 parameter
Opens the M5 parameter
Opens the M6 parameter
Opens the M7 parameter
Opens the M8 parameter
Opens the M9 parameter

Opens the L0 parameter
Opens the L1 parameter
Opens the L2 parameter
Opens the L3 parameter
Opens the L4 parameter
Opens the L5 parameter
Opens the L6 parameter
Opens the L7 parameter
Opens the L8 parameter
Opens the L9 parameter

Dependent on the
frequency range of
the instrument

Dependent on the
frequency range of
the instrument

Dependent on the
power level range of
the instrument

TERMINATOR

GH
MH
KH

HZ

GH
MH
KH

HZ

DM

DLF

DFF

DFM

Opens the ∆F parameter
Opens the ∆F parameter
Opens the ∆F parameter

Dependent on the
frequency range of
the instrument

GH
MH
KH

HZ

Slave Unit Frequencies

SLF0
SLF1
SLF2
SLF3
SLF4
SLF5
SLF6
SLF7
SLF8
SLF9

Opens the F0 parameter
Opens the F1 parameter
Opens the F2 parameter
Opens the F3 parameter
Opens the F4 parameter
Opens the F5 parameter
Opens the F6 parameter
Opens the F7 parameter
Opens the F8 parameter
Opens the F9 parameter

Dependent on the
frequency range of
the instrument

GH
MH
KH

HZ

2-10 682XXB/683XXB PM

PROGRAMMING WITH PARAMETER AND DATA
682XXB/683XXB GPIB COMMANDS ENTRY COMMANDS

Table 2-2. Parameter Entry Commands (2 of 6)

MNEMONIC

CODE

PARAMETER VALUES TERMINATOR

Slave Unit Frequencies

SLM0
SLM1
SLM2
SLM3
SLM4
SLM5
SLM6
SLM7
SLM8
SLM9

SLDF

SDT Opens the step sweep

SNS Opens the step sweep

SWT Opens the analog sweep

Opens the M0 parameter
Opens the M1 parameter
Opens the M2 parameter
Opens the M3 parameter
Opens the M4 parameter
Opens the M5 parameter
Opens the M6 parameter
Opens the M7 parameter
Opens the M8 parameter
Opens the M9 parameter

Opens the ∆F parameter
for the slave 68XXXB

dwell time parameter

number of steps parameter

and CW ramp time
parameter

Dependent on the
frequency range of
the instrumen t

Dependent on the
frequency range of
the instrumen t

1 ms to 99s MS

1 to 10,000 SPS

30 ms to 99s MS

GH
MH
KH

HZ

GH
MH
KH

HZ

SEC

SEC

LOS Op en s th e le ve l offset

parameter

PDT Opens the power sweep

dwell time parameter

PNS Opens the power sweep

number of steps
parameter

ADP1 Opens the internal AM %

depth parameter

ADP2 Opens the internal AM dB

depth parameter

AMR Opens the inte rnal AM rate

parameter

+100 dB to –100 dB DB

1 ms to 99 sec MS

SEC

1 to 10,000 SPS

0% to 100% PCT

0 dB to 25 dB DB

0.1 Hz to 1 MHz for
sine wave;

0.1 Hz to 100 kHz
for square, triangle,
and ramp waveforms

MH
KH

HZ

682XXB/683XXB PM 2-11

PROGRAMMING WITH PARAMETER AND DATA
682XXB/683XXB GPIB COMMANDS ENTRY COMMANDS

Table 2-2. Parameter Entry Commands (3 of 6)

MNEMONIC

CODE

AMS Opens the external AM

ASD Opens the external AM

FDV Opens th e in te rna l FM

FMR Opens the internal FM rate

FMS Opens the external FM

PARAMETER VALUES TERMINATOR

%/V sensitivit y pa ram et er

dB/V sensitivit y pa ram eter

deviation parameter

parameter

sensitivity parameter

0 %/V to 100 %/V PCV

0 dB/V to 25 dB/V DV

10 kHz to 20 MHz in
Locked, Locked
Low-Noise, and
Unlocked Narrow
FM; 100 kHz to
100 MHz in
Unlocked Wi de FM

0.1 Hz to 1 MHz for
sine wave;

0.1 Hz to 100 kHz
for square, triangle,
and ramp waveforms

±10 kHz/V to
±20 MHz/V in

Locked, Locked
Low-Noise, and
Unlocked Narrow
FM; ±100 kHz/V to
±100 MHz/V in
Unlocked Wi de FM

MH

KH

MH

KH
HZ

KV

MV

PHD

PHR

PHS

Opens the internal ΦM
deviation parameter

Opens the internal ΦM
rate parameter

Opens the externa l Φ M
sensitivity parameter

0.0025 to 5 radians
in ΦM Narrow
mode;

0.25 to 500 radians
in ΦM Wide mode

0.1 Hz to 1 MHz for
sine wave;

0.1 Hz to 100 kHz
for square, triangle,
and ramp waveforms

±0.0025 radians/V
to ±5 radians/V in

ΦM Narrow mode;
±0.25 radians/V to
±500 radians/V in
ΦM Wide mode

RD

MH

KH
HZ

RV

2-12 682XXB/683XXB PM

PROGRAMMING WITH PARAMETER AND DATA
682XXB/683XXB GPIB COMMANDS ENTRY COMMANDS

Table 2-2. Parameter Entry Commands (4 of 6)

MNEMONIC

CODE

PER Opens the internal pulse

PR O p ens the internal puls e

PW, W1

W2
W3
W4

PDY, D1 Opens the inte rna l pu ls e

PARAMETER VALUES

period parameter

frequency param et er

Opens the internal pulse
width 1 parameter
Opens the internal pulse
width 2 parameter
Opens the internal pulse
width 3 parameter
Opens the internal pulse
width 4 parameter

delay 1 paramet er

250 ns to 419 ms at
40 MHz pulse clock
rate; 600 ns to 1.6s
at 10 MHz pulse
clock rate

2.385 Hz to 4 MHz
at 40 MHz pulse
clock rate;

0.597 Hz to

1.66 MHz at 10 MHz
pulse clock rate

25 ns to 419 ms at
40 MHz pulse clock
rate; 100 ns to 1.6s
at 10 MHz pulse
clock rate

0 to 419 ms at
40 MHz pulse clock
rate; 0 to 1.6 s at
10 MHz pulse clock
rate

TERMINATOR

SEC

MS

US
NS

MH

KH
HZ

SEC

MS

US
NS

SEC

MS

US
NS

D2
D3
D4

SDD Opens the internal pulse

SDE Opens the internal pulse

Opens the internal pulse
delay 2 paramet er
Opens the internal pulse
delay 3 paramet er
Opens the internal pulse
delay 4 paramet er

stepped delay mode step
size parameter

stepped delay mode delay
1 stop parameter

100 ns to 419 ms at
40 MHz pulse clock
rate; 300 ns to 1.6s
at 10 MHz pulse
clock rate

0 to 419 ms at
40 MHz pulse clock
rate; 0 to 1.6 s at
10 MHz pulse clock
rate

0 to 419 ms at
40 MHz pulse clock
rate; 0 to 1.6 s at
10 MHz pulse clock
rate

SEC

MS

US
NS

SEC

MS

US
NS

SEC

MS

US
NS

682XXB/683XXB PM 2-13

PROGRAMMING WITH PARAMETER AND DATA
682XXB/683XXB GPIB COMMANDS ENTRY COMMANDS

Table 2-2. Parameter Entry Commands (5 of 6)

MNEMONIC

CODE

SDL Opens the internal pulse

SDS Opens the internal pulse

PVT Opens the ALC power

SLP Opens the ALC power

SOF Opens the frequency

SLV, SLL1 Opens the main power

PARAMETER VALUES

stepped delay mode dwell­time-per-step paramet er

stepped delay mode delay
1 start parameter

slope pivot point frequency
parameter

slope value parameter

offset parameter for the
slave 68XXXB (in a 360B
VNA configuration)

level parameter (L1) for
the slave 68XXXB

TERMINATOR

100 µs to 10s

0 to 419 ms at
40 MHz pulse clock
rate; 0 to 1.6 s at
10 MHz pulse clock
rate

Dependent on the
frequency range of
the instrumen t

0 to 255 SPS

Dependent on the
frequency range of
the instrumen t

Dependent on the
power level range of
the instrumen t

SEC

MS
US

SEC

MS
US
NS

GH

MH

KH
HZ

GH

MH

KH
HZ

DM

SLL2 Opens the alternate sweep

power level parameter (L2)
for the slave 68XXXB

EGI Opens the Ref ere nc e

Level DAC setting
parameter (in external
power leveling mode)

ADD Opens the GPIB address

parameter.

FRS Opens the frequency

scaling reference multiplier
parameter

SYZ Opens the st ep -si ze

parameter for updating

UP Increments the open

parameter by the step size

Dependent on the
power level range of
the instrumen t

0 to 255 SPS

1 to 30 ADR

0.1 to 14 TMS

Dependent on the
open parameter

N/A N/A

DM

N/A

2-14 682XXB/683XXB PM