Programmer Manual
DG2020A
Data Generator
071-0054-50
www.tektronix.com
Copyright © T ektronix, Inc. All rights reserved.
T ektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supercedes
that in all previously published material. Specifications and price change privileges reserved.
T ektronix, Inc., P.O. Box 500, Beaverton, OR 97077
TEKTRONIX and TEK are registered trademarks of T ektronix, Inc.
Table of Contents
Getting Started
Command Syntax
Preface v. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Getting Started 1-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview 1-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Choosing an Interface 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing for GPIB Communication 1-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing for RS-232-C Communication 1-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Syntax 2-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Notation 2-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Program and Response Messages 2-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command and Query Structure 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Character Encoding 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Syntactic Delimiters 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
White Space 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Characters 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Arguments 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Header 2-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Concatenating Commands 2-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Query Responses 2-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other General Command Conventions 2-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Groups 2-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Summaries 2-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Descriptions 2-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Retrieving Response Messages 2-113. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status and Event Reporting
Status and Event Reporting 3-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Registers 3-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Queues 3-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Processing Sequence 3-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Messages 3-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Programming Examples
Programming Examples 4-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview of the Sample Programs 4-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Required Execution Environment 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Floppy Disk Files 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing and Compiling the Programs 4-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sample Program Functions and Usage 4-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DG2020A Programmer Manual
i
Table of Contents
Appendices
Glossary & Index
Appendix A: Character Charts A–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix B: Reserved Words B–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix C: Interface Specification C–1. . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix D: Factory Initialization Settings D–1. . . . . . . . . . . . . . . . . . . . .
Glossary Glossary–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Index Index–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ii
DG2020A Programmer Manual
List of Figures
Table of Contents
Figure 1-1: Functional layers in gpib system 1-1. . . . . . . . . . . . . . . . . . . .
Figure 1-2: GPIB connector 1-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 1-3: GPIB system configurations 1-4. . . . . . . . . . . . . . . . . . . . . . . .
Figure 1-4: GPIB parameter settings 1-5. . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 1-5: RS-232-C point-to-point connection 1-6. . . . . . . . . . . . . . . . .
Figure 1-6: RS-232-C port 1-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 1-7: Pin assignments of 9-pin and
25-pin D-type shell connector 1-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 1-8: Typical RS-232-C cable wiring requirements 1-8. . . . . . . . . .
Figure 1-9: RS-232-C parameter settings 1-9. . . . . . . . . . . . . . . . . . . . . . .
Figure 2-1: Command and query structure flowchart 2-2. . . . . . . . . . . .
Figure 2-2: ABSTouch arguments and associated controls 2-20. . . . . . . . .
Figure 2-3: GPIB: Retrieving response messages 2-113. . . . . . . . . . . . . . . . .
Figure 2-4: RS-232-C: Retrieving response messages 2-113. . . . . . . . . . . . .
Figure 3-1: Standard event status (SESR) 3-2. . . . . . . . . . . . . . . . . . . . . .
Figure 3-2: Status byte register (SBR) 3-3. . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 3-3: Device event status enable register (DESER) 3-4. . . . . . . . . .
Figure 3-4: event status enable register (ESER) 3-4. . . . . . . . . . . . . . . . . .
Figure 3-5: Service request enable register (SRER) 3-5. . . . . . . . . . . . . . .
Figure 3-6: Status and event handling process overview 3-7. . . . . . . . . . .
DG2020A Programmer Manual
iii
Table of Contents
List of Tables
Table 1-1: GPIB and RS-232-C comparison 1-2. . . . . . . . . . . . . . . . . . . .
Table 2-1: BNF symbols and meanings 2-1. . . . . . . . . . . . . . . . . . . . . . . .
Table 2-2: Decimal numeric notation 2-4. . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2-3: Header in query responses 2-9. . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2-4: DATA commands 2-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2-5: DIAGNOSTIC commands 2-12. . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2-6: DISPLAY commands 2-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2-7: HARDCOPY commands 2-13. . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2-8: MEMORY commands 2-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2-9: MODE commands 2-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2-10: OUTPUT commands 2-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2-11: SOURCE commands 2-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2-12: STATUS & EVENT commands 2-16. . . . . . . . . . . . . . . . . . . .
Table 2-13: SYNCHRONIZATION commands 2-17. . . . . . . . . . . . . . . . . .
Table 2-14: SYSTEM commands 2-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3-1: SESR bit functions 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3-2: SBR bit functions 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3-3: Definition of event codes 3-9. . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3-4: Normal condition 3-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3-5: Command errors (CME bit:5) 3-10. . . . . . . . . . . . . . . . . . . . . .
Table 3-6: Execution errors (EXE bit:4) 3-12. . . . . . . . . . . . . . . . . . . . . . .
Table 3-7: Internal device errors (DDE bit:3) 3-14. . . . . . . . . . . . . . . . . . .
Table 3-8: System event and query errors 3-14. . . . . . . . . . . . . . . . . . . . . .
Table 3-9: Warnings (EXE bit:4) 3-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3-10: Device-dependent command execution errors 3-15. . . . . . . . .
Table 3-11: Extended device specific errors 3-17. . . . . . . . . . . . . . . . . . . . .
Table A–1: DG2020A character set A–1. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table A–2: ASCII & GPIB code chart A–2. . . . . . . . . . . . . . . . . . . . . . . . . .
Table C–1: GPIB interface function implementation C–1. . . . . . . . . . . . .
Table C–2: GPIB interface messages C–2. . . . . . . . . . . . . . . . . . . . . . . . . .
Table D–1: Factory initialized settings D–1. . . . . . . . . . . . . . . . . . . . . . . . .
iv
DG2020A Programmer Manual
Preface
This is the Programmer Manual for the DG2020A Data Generator and Pods.
This manual provides information on operating these instruments using General
Purpose Interface Bus (GPIB) interface and RS-232-C interface.
This manual provides the following information:
H Getting Started describes how to connect and set up for remote operation.
H Syntax and Commands defines the command syntax and processing
conventions and describes each command in the data generator command
set.
H Status and Events explains the status information and event messages
reported by the data generator.
H Appendices contains various topics of use to the programmer.
H Glossary and Index contains a glossary of common terms and an index to
this manual.
Related Manuals
Other documentation for the data generator includes:
H The User Manual that describes the operation of the Data Generator that was
supplied as a standard accessory with the instrument.
H The Service Manual (optional accessory) provides information for maintain-
ing and servicing the Data Generator.
DG2020A Programmer Manual
v
Preface
vi
DG2020A Programmer Manual
Getting Started
Overview
The Data Generator has two interfaces for remote operation — the GPIB interface
and the RS-232-C interface. All menu controlled and front-panel controlled
functions, except the ON/STBY function, the edit function, and the GPIB and
RS-232-C parameter setup functions, can be controlled through the GPIB or the
RS-232-C interface using the programming command set (see Section 2).
The GPIB interface conforms to ANSI/IEEE Std 488.1-1987, which specifies the
hardware interface, its basic functional protocol, and a set of interface messages
(codes) that control the interface functions. This instrument also conforms to
ANSI/IEEE Std 488.2-1987 which specifies Codes, Formats, Protocols, and
Common Commands to support the system application. The functional layers of
the GPIB system are shown in Figure 1-1.
BUS
DeviceĆspecific Messages
Common Commands and Queries
Syntax and Data Structures
Remote INTFC Messages
D
CBA ABCD
System Component x System Component y
Specified
by
Device
IEEE 488.2
Standard
A: Interface Function Layer
B: Message Communication Function Layer
C: Common System Function Layer
D: Device Function Layer
IEEE 488.1
Standard
Figure 1Ć1: Functional layers in gpib system
IEEE 488.2
Standard
Specified
by
Device
DG2020A Programmer Manual
1Ć1
Getting Started
Choosing an Interface
The RS-232-C interface, which was established by the Electronic Industries
Association (EIA), provides a common basis of communication between devices
that exchange data. This interface has long been used on terminals, modems,
printers, and other devices. The RS-232-C interface that the data generator
provides also uses most of the same Codes, Formats, Protocols, and Common
Commands as are used with the GPIB interface (ANSI/IEEE Std 488.2-1987).
Your system hardware may let you choose which interface to use with your
system; if so, you should consider the comparative advantages and disadvantages
of each interface. For example, the GPIB interface is an eight-bit parallel bus and
therefore it offers high-speed data transfers and multiple instrument control. In
contrast, the RS-232-C interface is a slower serial data bus for single instrument
control, but it is easy to connect to and can be used with a low-cost controller.
Table 1-1 compares the GPIB and RS-232-C interface.
Table 1Ć1: GPIB and RSĆ232ĆC comparison
Operating attribute GPIB RSĆ232ĆC
Cable ANSI/IEEE Std 488 9Ćwire (DCE)
Data flow control Hardware, 3Ćwire handshake Flagging: soft (XON/XOFF),
hard (DTR/CTS)
Data format 8Ćbit parallel 8Ćbit serial
Interface control Operator lowĆlevel control
message
Interface messages Most ANSI/IEEE Std 488 Device clear via ASCII break
Interrupts reported Service requests
status and event code
Message termination
(Receive)
Message termination
(Transmit)
Timing Asynchronous Asynchronous
Transmission path length ≤2 meters between devices;
Speed 200 Kbytes/sec 19,200 bits/sec
Hardware EOI, software LF, or
both
Hardware EOI, and softwareLFSoftware LF
≤20 meters total cabling for
GPIB system
None
signal
Status and event code
(no service requests)
Software CR, LF, or CR and
LF
≤15 meters
1Ć2
System environment Multiple devices (≤15) Single terminal (point to point
connection)
DG2020A Programmer Manual
Installing for GPIB Communication
With the power off, connect a GPIB cable from the GPIB controller to the
ANSI/IEEE Std 488 port (GPIB) connector on the rear panel of the data
generator (see Figure 1-2). For example, when using an MS-DOS compatible
controller, connect the GPIB cable between the National Instrument PC2A GPIB
board and the data generator GPIB connector.
GPIB Connector
Getting Started
POD C
POD B
POD A
IEEE STD 488 PORT
RS-232-C
CALIBRATION
CLOCK IN
CLOCK OUT
Figure 1Ć2: GPIB connector
Instruments can be connected to the GPIB in linear or star configurations or in a
combination of both configurations. A linear hookup is one where a GPIB cable
is used to string one device to a second, and then another GPIB cable is used to
string from a second to a third, and so on until all devices in the system are
connected. A star setup is one where one end of all the GPIB cables in the
system are attached to one device. Refer to Figure 1-3 for these GPIB system
configurations.
DG2020A Programmer Manual
1Ć3
Getting Started
C
Star Configuration
B D
A
Restrictions
F
A
D
B C D E F
E
A
C
E
Linear Configuration
Combination of Star and
Linear Configurations
F
G H
B
Figure 1Ć3: GPIB system configurations
Consider the following rules when distributing instruments on the GPIB:
1Ć4
1. No more than 15 total devices (including the controller) can be included on a
signal bus.
2. In order to maintain the electrical characteristics of the bus, one device load
must be connected for every two meters of cable (most often, each device
represents one device load to the bus).
3. The total cable length (cumulative) must not exceed 20 meters.
4. At least two-thirds of the device loads must be powered on.
DG2020A Programmer Manual
Getting Started
Setting the GPIB
Parameters
To set the GPIB parameters, proceed as follows:
1. Press the UTILITY button in the MENU column to the right of the screen.
The UTILITY menu appears above the bottom menu buttons.
2. Press the System bottom menu button to display the System menu (See
figure 1-4).
3. Select the Configure item from the GPIB menu using the up and down arrow
buttons. Set the GPIB operating mode using the left and right arrow buttons.
H Talk/Listen. Sets the communications mode to talk/listen.
H Talk Only. Sets the communications mode to talk only, which is used for
hardcopy output.
H Off Bus. Logically disconnect the data generator from GPIB system.
NOTE. The data generator accepts as a terminator either the software LF (Line
Feed), sent as the last data byte, or the hardware EOI, with the EOI line asserted
concurrently with the last data byte sent.
4. Select the Address item from the GPIB menu using the up and down arrow
buttons. Then use the rotary knob to set the primary address to a value in the
range 0 to 30.
GPIB Menu
5. Select the Remote Port item using the up and down arrow buttons, and
additionally, highlight ”GPIB” using the left and right arrow buttons. This
selects the GPIB as the remote interface.
Figure 1Ć4: GPIB parameter settings
DG2020A Programmer Manual
1Ć5
Getting Started
Installing for RSĆ232ĆC Communication
Connect an RS-232-C cable from the computer terminal to the RS-232-C
connector on the rear panel of the data generator. Use a configuration based on
the settings for the data flow control (flagging).
The RS-232-C provides a point-to-point connected communication interface
between devices (see Figure 1-5). The data generator can transmit and receive the
same message serially over the RS-232-C interface as it can in parallel over the
GPIB interface.
Controller
Figure 1Ć5: RSĆ232ĆC pointĆtoĆpoint connection
Several connectors are used with the RS-232-C interface: a DTE device uses a
standard 25-pin male D-type shell connector; a DCE device uses a standard
25-pin female D-type shell connector. Some recent computers implement the
RS-232-C interface using 9-pin D-type connector.
This data generator uses a standard 9-pin D-type shell connector, provided on the
rear panel (see Figure 1-6), along with a 9-pin male to 25-pin male conversion
cable. Figure 1-7 on page 1-8 shows both 9-pin and 25 pin connectors with
their pin number assignments.
DG2020A
1Ć6
DG2020A Programmer Manual
IEEE STD 488 PORT
Getting Started
POD C
POD B
POD A
RS-232-C
CLOCK IN
CLOCK OUT
RSĆ232ĆC
Connector
CALIBRATION
Figure 1Ć6: RSĆ232ĆC port
This data generator is designed as DCE device. You may connect it up to
15 meters (50 feet) from a DTE device using a straight-through male-to-female
cable. However, if the other device is instead configured as a DCE device, you
will need a special adapter or null-modem cable for local DCE-to-DCE
communications. Refer to the wiring examples in the Figure 1-8 for the proper
signal connections between devices.
NOTE.
available.
In this data generator, only TxD, RxD, DTR, CTS pins and Signal Ground are
DG2020A Programmer Manual
1Ć7
Getting Started
Pin
9ĆPIN DĆSHELL
1
2
6
7
8
9
NOTE: TxD, RxD, DTR, CTS and Ground lines are only available
in the data generator.
Receive Data (RxD) 3
2
3 Transmit Data (TxD) 2
3
4 Data Terminal Ready (DTR) 20
4
5 Signal Ground 7
5
8 Clear to Send (CTS) 5
25ĆPIN DĆSHELL
14
15
16
17
18
19
20
21
22
23
24
25
1
2
3
4
5
6
7
8
9
10
11
12
13
Figure 1Ć7: Pin assignments of 9Ćpin and 25Ćpin DĆtype shell connector
Pin Pin Pin
2
3
4
5
8
9Ćpin DCE to 9Ćpin DTE 9Ćpin DCE to 9Ćpin DCE
2
3
4
5
8
2
3
4
5
8
2
3
4
5
8
Pin Pin
2
3
4
5
8
9Ćpin DCE to 25Ćpin DTE
NOTE: When using software flow control, the CTSĆDTR lines do not need to be connected.
2
3
5
7
20
Pin Pin
2
3
4
5
8
Figure 1Ć8: Typical RSĆ232ĆC cable wiring requirements
1Ć8
2
3
5
7
20
9Ćpin DCE to 25Ćpin DCE
DG2020A Programmer Manual
Getting Started
Setting the RSĆ232
Parameters
To set the RS-232-C parameters, perform the following steps:
1. Press the UTILITY button in the MENU column to the right of the screen.
The UTILITY menu appears above the bottom menu buttons.
2. Press the System bottom menu button to display the System menu (See
figure 1-9).
3. Select the Baudrate item from the Serial menu using the up and down arrow
buttons. Here select the data transfer rate using the left and right arrow
buttons. The rate can be set to 300, 600, 1200, 2400, 4800, 9600, or 19200
baud.
4. Select the Data Bits item from the Serial menu using the up and down arrow
buttons. Then use the left and right arrow buttons to select the data bit length
for each character. The bit length can be set to either 7 or 8 bits.
5. Select the Parity item from the Serial menu using the up and down arrow
buttons. Then use the left and right arrow buttons to set the error check bit
for each character. The error bit can be set to None, Even, or Odd parity.
6. Select the Stop Bits item from the Serial menu using the up and down arrow
buttons. Then use the left and right arrow buttons to select the number of
stop bits sent after each character. The number of stop bits can be set to
either 1 or 2.
Serial Menu
7. Select the Handshake item from the Serial menu using the up and down
arrow buttons. Then use the left and right arrow buttons to select the method
of controlling the flow of data between devices. The data flow method can
be set to Hard (DTR/CTS), Soft (XON/XOFF), and Off (no flow control).
8. Select the Remote Port item using the up and down arrow buttons, and
additionally, highlight ”RS232C” using the left and right arrow buttons. This
selects the RS-232-C interface as the remote interface.
Figure 1Ć9: RSĆ232ĆC parameter settings
DG2020A Programmer Manual
1Ć9
Getting Started
1Ć10
DG2020A Programmer Manual
Command Syntax
A large set of commands can be used to control the operations and functions of
the data generator from an external controller. This section describes the syntax
and communication rules for using these commands to operate the data
generator.
Command Notation
The command syntax is in extended BNF (Backus-Naur Form) notation. The
extended BNF symbols used in the command set are shown in the following
table.
Table 2Ć1: BNF symbols and meanings
Symbol Meaning
<ą> Indicates a defined element
| Delimits Exclusive OR elements
{ą} Delimits a group of elements one of which the programmer must select
[ą] Delimits an optional element that the programmer may omit
[ą]... Delimits an optional element that the programmer may omit or may repeat one
::= Indicates that the left member is defined as shown by the the right member
Program and Response Messages
Programs created or placed in an external controller are transferred to the data
generator as a program message. A program message is a sequence of zero or
more program message units delimited by the program message unit delimiter,
the semicolon (;).
A program message unit is a set command or query command. The data
generator performs a function or changes a setting or mode when it receives a set
command; when it receives a query command, it returns measurement data,
settings, status codes and/or status messages. The data generator transfers these
response messages to the external controller.
or more times
DG2020A Programmer Manual
2Ć1
Command Syntax
Command and Query Structure
Commands are either set commands or query commands (usually just called
commands and queries in this manual). Most commands have both a set form
and query form. The query form of a command is the same as the set form,
except that the query form ends with a question mark.
Figure 2-1 shows a flowchart of the structure of the commands and queries. The
structure of the header is described in detail in Header on page 2-6.
Command
,
Character Encoding
Header
Mnemonic
Argument
,
?
:
:
Header
Mnemonic
Argument
?
,
Argument
,
Argument
Command
Query
Query
Query
Command
Command
Figure 2Ć1: Command and query structure flowchart
The program can be described using the American Standard Code for Information Interchange (ASCII) character encoding.
2Ć2
This seven-bit ASCII code is used for the majority of syntactic elements and
semantic definitions. In special cases, an eight-bit ASCII Code is allowed in the
arbitrary block arguments described on page 2-5. The ASCII code character set
table is found in Appendix A.
DG2020A Programmer Manual
Syntactic Delimiters
Command Syntax
Syntactic elements in a program message unit are delimited (differentiated) with
colons, white space, commas, or semicolons.
Colon (:). Typically delimits the compound command header.
MMEMORY:DELETE:ALL, SOURCE:OSCILLATOR:SOURCE
White Space. Typically delimits command/query headers from the argument.
DIAGNOSTIC:SELECT ALL
SYSTEM:DATE 1995,3,4
DIAGNOSTIC:SELECT and SYSTEM:DATE are the command headers, and ALL and
1995,3,4 are the arguments.
Comma (,). Typically delimits between multiple arguments. In the above
example, a comma delimits the multiple arguments 1995, 3 and 4.
White Space
Special Characters
Semicolon (;). Typically delimits between multiple commands (or multiple
program message units). For more information about using the semicolon, refer
to Concatenating Commands on page 2-8.
White space, which is used to delimit certain syntactic elements in a command,
is defined in the data generator as a single ASCII-encoded byte in the range
ASCII 0-32 (decimal). This range consists of the standard ASCII characters
exclusively except for ASCII 10, which is the Line Feed (LF) or New Line (NL)
character.
The Line Feed (LF) character or the New Line (NL) character (ASCII 10) and all
characters in the range of ASCII 127-255 are defined as special characters. These
characters are used in arbitrary block arguments only; using these characters in
other parts of any command yields unpredictable results.
DG2020A Programmer Manual
2Ć3
Command Syntax
Arguments
In a command or query, one or more arguments follow the command header. The
argument, sometimes called program data, is a quantity, quality, restriction, or
limit associated with the command or query header. Depending on the command
or query header given, the argument is one of the following types:
H Decimal Numeric
H String
H Arbitrary Block
Decimal Numeric
The data generator defines a decimal numeric argument as one expressed in one
of three numeric representations — NR1, NR2, or NR3. This definition complies
with that found in ANSI/IEEE Std 488.2-1987. Any commands that use
arguments in any of the the first three notations can use a fourth notation NRf
(for Numerical Representation flexible). The four formats are shown in Table
2-2.
Table 2Ć2: Decimal numeric notation
Type Format Examples
NR1 implicitĆpoint (integer) 1, +3, -2, +10, -20
NR2 explicitĆpoint unscaled
(fixed point)
NR3 explicitĆpoint scaled (floating point) 1E+2, +3.36E-2, -1.02E+3
NRf numeric representationĆflexible; any of
NR1, NR2, and NR3 may be used
1, 2, +23.5, -0.15
1, +23.5, -1.02E+3
As just implied, you can use NRf notation for arguments in your programs for
any commands that this manual lists as using any of NR1, NR2, or NR3 notation
in its arguments. Be aware, however, that query response will still be in the
format specified in the command. For example, if the command description is
:DESE <NR1>, you can substitute NR2 or NR3 when using the command in a
program. However, if you use the query :DESE?, the data generator will respond
in the format <NR1> to match the command description in this manual.
2Ć4
Unit and SI Prefix
If the decimal numeric argument refers to a voltage or frequency, you can
express it using SI units instead of in the scaled explicit point input value format
<NR3>. (SI units are units that conform to the Systeme International d’Unites
standard.) For example, you can use the input format 200mV or 1.0MHz instead
of 200.0E–3 or 1.0E+6, respectively, to specify voltage or frequency.
DG2020A Programmer Manual
Command Syntax
You can omit the unit, but you must include the SI unit prefix. You can use either
upper or lowercase units.
V or v for voltage
Hz, HZ, or hz for frequency
The SI prefixes, which must be included, are shown below. Note that either
lower or upper case prefixes can be used.
String
SI prefix
Corresponding Power 10
1
1
Note that the prefix m/M indicates 10-3when the decimal numeric argument denotes
voltage, but 10
6
when it denotes frequency.
m/M k/K m/M
-3
10
3
10
6
String, sometimes referred to as a string literal, a literal, or just a string, is
defined as a series of characters enclosed by double quotation marks (”) as in:
"This is a string constant"ąąorąą"0 .. 127"
To include a double quoted character in the string, insert an additional double
quote character ahead of the double quote character in the string. For example,
the string:
serial number "B010000"
would be defined as:
"serial number ""B010000"""
Single quotation marks (’) can also be used instead of double quotation marks.
For instance:
Arbitrary Block
DG2020A Programmer Manual
'serial number ''B010000'''
String constants may be of any length up to the memory limits of the instrument
in which the message is parsed.
An arbitrary block argument is defined as:
#<byte count digit><byte count>[<contiguous eightĆbit data
byte>]...
or:
#<contiguous eightĆbit data byte]... <terminator>
2Ć5
Command Syntax
Header
where:
<byte count digit>::= a nonzero digit in the range ASCII 1–9 that defines the
number of digits (bytes) in the <byte count> field.
<byte count>::= any number of digits in the range ASCII 0–9 that define how
many bytes are in the <contiguous 8Ćbit data byte> field.
<contiguous 8Ćbit data byte>::= a <byte count> number of 8-bit bytes in
the range ASCII 0–255 that define the message. Each byte defines one character.
<terminator>::= a software LF followed by a hardware EOI. For example,
#16AB4ZLT<LF><&EOI>
Header Mnemonic
Pod and Channel
Representation
Header Structure
The header mnemonic represents a header node or a header subfunction. The
command or query header comprises one or more header mnemonics that are
delimited with the colon (:).
The pod and channel can be specified by using the OUTPut:POD<s>:CH<n>
header mnemonic in commands and query commands. The term <s> is either A,
B, or C, and expresses the connected pattern data output connector for the pod
being specified. The term <n> is a number between 0 and 11 that expresses the
specified channel.
Commands and queries can be structured into six basic forms.
H Simple command header
H Simple query header
H Compound command header
H Compound query header
H Common command header
H Common query header
2Ć6
Figure 2-1 on page 2-2 shows the syntax for all possible structures, and each of
the six basic forms are explained below.
DG2020A Programmer Manual
Command Syntax
Simple Command Header. A command that contains only one header mnemonic.
It may also contain one or more arguments. Its message format is:
[:]<Header Mnemonic> [<Argument>[,<Argument>]...]
such as:
START
or
STOP
Simple Query Header. A command that contains only one header mnemonic
followed by a question mark (?). Its message format is:
[:]<Header Mnemonic>? [<Argument>[,<Argument>]...]
such as:
HCOPY?
or
TRIGGER?
Compound Command Header. A command that contains multiple header
mnemonics plus argument(s). Its message format is:
[:]<Header Mnemonic>[:<Header Mnemonic>]...
[<Argument>[,<Argument>]...]
such as:
MMEMORY:INITIALIZE HD1
or
SYSTEM:SECURITY:STATE ON
Compound Query Header. A command that contains multiple header mnemonics
followed by a question mark (?). Its message format is:
[:]<Header Mnemonic>[:<Header Mnemonic>]...?
[<Argument>[,<Argument>]...]
such as:
DIAGNOSTIC:RESULT?
or
DATA:BLOCK:SIZE? "BLOCK1"
DG2020A Programmer Manual
2Ć7
Command Syntax
Common Command Header. A command that precedes its header mnemonic with
an asterisk (*). Its message format is:
<Header Mnemonic> [<Argument>[,<Argument>]...]
such as:
*RST
The common commands are defined by IEEE Std 488.2 and are common to all
devices which support IEEE Std 488.2 on the GPIB bus.
Common Query Header. A command that precedes its header mnemonic with an
asterisk (*) and follows it with a question mark (?). Its message format is:
<Header Mnemonic>? [<Argument>[,<Argument>]...]
such as:
*IDN?
The common commands are defined by IEEE Std 488.2 and are common to all
devices which support the IEEE Std 488.2 on the GPIB bus.
Concatenating Commands
Most of the compound command headers are in a tree structure. The tree
structure of an example command is diagrammed below. Note that the top of the
structure always begins with a colon (:).
BLOCK GROUP MSIZE PATTERN SEQUENCE UPDATE
ADD ADDADD DEFINE DEFINE ... DEFINEBIT BITDELETE ... DELETE ...WORD
The following example of a compound command combines three headers
delimited by semicolons:
:DATA:
:DATA:BLOCK:ADD 512,"BLOCK3"; :DATA:BLOCK:DELETE "BLOCK2";
:DATA:BLOCK:SIZE "BLOCK1",512
2Ć8
You must include the complete path in each header when there is no common
complete path to the start of the tree structure (the colon). However, note that
part of each header in the above example has a common path :DATA:BLOCK. You
DG2020A Programmer Manual
Command Syntax
may shorten compound command structures with such headers. For example, the
command above may be rewritten as follows.
:DATA:BLOCK:ADD 512,"BLOCK3"; DELETE "BLOCK2"; SIZE
"BLOCK1",512
Note that the mnemonics :DATA and :BLOCK are assumed from the first header
by the headers that follow. The following command descriptions are valid
examples of commands shortened using the principle just described. (Note that
the insertion of common command (*SRE) between headers does not prevent the
headers that follow from assuming the earlier header mnemonics.)
:DATA:BLOCK:ADD 512,"BLOCK3"; DELETE "BLOCK2";
:DATA:GROUP:DELETE "GROUP4"
:DATA:MSIZE 16384; BLOCK:ADD 512,"BLOCK3"; DELETE "BLOCK2"
:DATA:BLOCK:ADD 512,"BLOCK3"; *SRE?; DELETE "BLOCK2"; SIZE
"BLOCK1",512
The following examples have been shortened incorrectly and cause errors.
Query Responses
:DATA:BLOCK:DELETE "BLOCK2"; DATA:GROUP:DELETE "GROUP4"
:DATA:BLOCK:ADD 512,"BLOCK3"; GROUP:DELETE "GROUP4"
:DATA:BLOCK:DELETE "BLOCK2"; MSIZE 16384
The query causes the data generator to return information about its status or
settings. A few queries also initiate an operation action before returning
information; for instance, the *TST? query performs the self test.
If the programmer has enabled headers to be returned with query responses, the
data generator formats a query response like the equivalent set-command header
followed by its argument(s). When headers are turned off for query responses,
only the values are returned. Table 2-3 shows the difference in query responses.
Table 2Ć3: Header in query responses
Query Header on Header off
DATA:MSIZE? :DATA:MSIZE 16384 16384
DIAGNOSTIC:SELECT? :DIAGNOSTIC:SELECT PMEMORY PMEMORY
DG2020A Programmer Manual
2Ć9
Command Syntax
Use the command HEADER ON when you want the header returned along with the
information. You can save such a response and send it back as a set-command
later. Use HEADER OFF when you want only the information back.
Other General Command Conventions
Upper and Lower Case
Abbreviation
The instrument accepts upper, lower, or mixed case alphabetic messages. The
following three commands are recognized as identical.
HEADER ON
or
header on
or
header On
Any header, argument, or reserved word that is sent to the data generator can be
abbreviated. The minimum required spelling is shown in upper case throughout
the subsection Command Groups beginning on page 2-11. The command
TRIGger:SLOPe POSitive can be rewritten in either of the following forms.
TRIGGER:SLOPE POSITIVE
or
TRIG:SLOP POS
2Ć10
DG2020A Programmer Manual
Command Groups
This subsection describes the organization of the DG2020A Data Generator
command as a number of functional groups. (See subsection Command
Descriptions on page 2-19 for a complete description of each command in
alphabetical order.)
Throughout this section, the parenthesized question symbol (?) follows the
command header to indicate that both a command and query form of the
command can be used.
Command Summaries
Tables 2-4 through 2-14 describe each command in each of the 11 functional
groups.
DATA Commands
The DATA commands are used to define blocks, groups, and sequences, to set up
pattern data, and to set which sequence controls become valid when the run
mode is set to Enhanced.
Table 2Ć4: DATA commands
Header Description
DATA? Query the settings related to pattern data
DATA:BLOCk:ADD Add a block definition
DATA:BLOCk:DEFine(?) Set the block definitions
DATA:BLOCk:DELete Delete a block definition
DATA:BLOCk:DELete:ALL Delete all block definitions
DATA:BLOCk:REName Change a block name
DATA:BLOCk:SIZe(?) Change the size of a block
DATA:GROUp:ADD Add a group definition
DATA:GROUp:BIT(?) Change a groups bit structure
DATA:GROUp:DEFine(?) Sets the group definitions
DATA:GROUp:DELete Delete a group definition
DATA:GROUp:DELete:ALL Delete all group definitions
DG2020A Programmer Manual
DATA:GROUp:NAME? Query the name of a group
DATA:GROUp:REName Change a group name
DATA:MSIZe(?) Set the pattern data memory size
2Ć11
Command Groups
Table 2Ć4: DATA commands (Cont.)
Header Description
DATA:PATTern:BIT(?) Set individual pattern data bits
DATA:PATTern[:WORD](?) Set pattern data in word units
DATA:SEQuence:ADD Add a sequence step
DATA:SEQuence:DEFine(?) Set the sequence definitions
DATA:SEQuence:DELete Delete a sequence step
DATA:SEQuence:DELete:ALL Delete all sequence definitions
DATA:SEQuence:EVJ(?) Set the event jump on/off state
DATA:SEQuence:EVJTO(?) Set the event jump destination
DATA:SEQuence:LOOP(?) Set the infinite loop on/off state
DATA:SEQuence:REPeat(?) Set the repeat count
DATA:SEQuence:TWAIT(?) Set the trigger wait on/off state
DATA:SUBSequence:ADD Add a subĂsequenceĂstep
DIAGNOSTIC Commands
DATA:SEBSequence:CLEAr DeleteĂall subĂsequence definitions
DATA:SUBSequence:DEFine(?) Set orĂqueryĂthe subĂsequence definitions
DATA:SUBSequence:DELete Delete a sub sequence step
DATA:SUBSequence:DELete:ALL Delete a sub sequence definition
DATA:SUBSequence:REPeat(?) Set orĂqueryĂthe repeat countĂofĂaĂsubĂseĆ
quenceĂstepĂ
DATA:UPDate Forcibly update the pattern and other data
The DIAGNOSTIC commands select and execute the self–test routines, which
are classified by function.
Table 2Ć5: DIAGNOSTIC commands
Header Description
DIAGnostic? Query all current settings related to self test
DIAGnostic:RESUlt? Query selfĆtest result
DIAGnostic:SELect(?) Select selfĆtest routine
DIAGnostic:STATe Perform self test
2Ć12
*TST? Perform self test
DG2020A Programmer Manual
Command Groups
DISPLAY Commands
The DISPLAY commands execute functions associated with front panel keys,
buttons, and knobs, adjust the screen brightness, and perform other display
related functions.
Table 2Ć6: DISPLAY commands
Header Description
ABSTouch Perform the function corresponding to the
front-panel control selected
DISPlay? Query settings made with display group commands
DISPlay:BRIGhtness(?) Set brightness of screen
DISPlay:CLOCk(?) Set the date and time display state
DISPlay:DIMmer(?) Set the state of the display dimmer function
DISPlay:ENABle(?) Set the display on/off state
DISPlay:MENU? Query all menu display related information
DISPlay:MENU[:NAME] Set the menu selection state
DISPlay:MENU:NAME? Query the menu selection state
DISPlay:MENU:STATe(?) Set the menu display on/off state
DISPlay[:WINDow]:TEXT:CLEar Erase the message display area
HARDCOPY Commands
DISPlay[:WINDow]:
TEXT[:DATA](?)
Set the contents of the message display area
The HARDCOPY commands start and stop for hardcopy operation, and select
port and its outputting format.
Table 2Ć7: HARDCOPY commands
Header Description
HCOPy? Query all hardcopy related information
HCOPy:ABORt Stop the current hardcopy operation
HCOPy:DATA? Create and send hardcopy data
HCOPy:FORMat(?) Select output format of hardcopy
HCOPy:PORT(?) Select output port of hardcopy
HCOPy:STARt Start a hardcopy operation
DG2020A Programmer Manual
2Ć13
Command Groups
MEMORY Commands
The MEMORY commands control all floppy disk and file operations.
Table 2Ć8: MEMORY commands
Header Description
MMEMory:CATalog[:ALL]? Query disk file and directory information
MMEMory:CATalog:ORDer(?) Set the display order for disk file and directory
information
MMEMory:CDIRectory(?) Set the current working directory
MMEMory:COPY Copy a disk file
MMEMory:DELete:ALL Delete all files and directories on a disk
MMEMory:DELete[:NAME] Delete the specified file or directory on a disk
MMEMory:FREE? Query disk memory usage
MMEMory:INITialize Format a disk
MMEMory:LOAD Read data from a disk file
MMEMory:LOCK(?) Set the disk file lock state
MMEMory:MDIRectory Create a new directory on the disk
MMEMory:RDIRectory Remove a directory on the disk
MODE Commands
MMEMory:REName Change the name of a disk file or directory
MMEMory:SAVE Write data to a disk file
The MODE commands are used to set the run and update modes, to start or stop
pattern data or sequence output, and to set the trigger conditions for the external
trigger source.
Table 2Ć9: MODE commands
Header Description
MODE? Query the states related to pattern generation
MODE:STATe(?) Set the run mode for pattern generation
MODE:UPDate(?) Set the data update mode
RUNNing? Query whether the instrument is currently outputting
a pattern or sequence
STARt Start pattern or sequence output
STOP Stop pattern or sequence output
*TRG Generate the triggering event
TRIGger? Query all current triggerĆrelated settings
2Ć14
DG2020A Programmer Manual
Command Groups
Table 2Ć9: MODE commands (Cont.)
Header Description
TRIGger:IMPedance(?) Select the impedance presented to the the external
trigger signal
TRIGger:LEVel(?) Set the level of the external trigger signal that
generates the triggering event
TRIGger:SLOPe(?) Select the slope of the external signal that
generates a triggering event
OUTPUT Commands
The OUTPUT commands set all the pod–related settings. The <s> and <n> terms
in the header mnemonic are used to specify the pod and channel in these
commands.
Table 2Ć10: OUTPUT commands
Header Description
OUTPut? Query the settings related to the output channels
and clock
OUTPut:ELEVel(?) Set the event input level
OUTPut:ILEVel(?) Set the inhibit input level
OUTPut:POD<s>:CH<n>:ASSIGn(?) Set the pod data bit assignments
OUTPut:POD<s>:CH<n>:DELAy(?) Set the pod delay times
OUTPut:POD<s>:CH<n>:HIGH(?) Set the pod high-level output voltage
OUTPut:POD<s>:CH<n>:INHibit(?) Set the pod high-impedance control method
OUTPut:POD<s>:CH<n>:LOW(?) Set the pod low-level output voltage
OUTPut:POD<s>:CH<n>:RELEase Clear the pod data bit assignments
OUTPut:POD<s>:DEFine(?) Set pod data bit assignments
OUTPut:POD<s>:TYPE? Query the pod type
DG2020A Programmer Manual
2Ć15
Command Groups
SOURCE Commands
STATUS & EVENT
Commands
The SOURCE commands are used to select the clock signal source, set the clock
frequency, and enable or disable the event input of the pod.
Table 2Ć11: SOURCE commands
Header Description
SOURce[:OSCillator]? Query all clock signal settings
SOURce:OSCillator:EXTernal:
FREQuency(?)
SOURce:OSCillator[:INTernal]:
FREQuency(?)
SOURce:OSCillator[:INTernal]:
PLLlock(?)
SOURce:OSCillator:SOURce(?) Set the clock signal internal/external selection
SOURce:POD<s>:EVENT:ENABle(?) Enable or disable the event input of the pod
Input the external clock frequency
Set the internal clock frequency
Set the internal clock oscillator circuit PLL operating
state
The STATUS & EVENT commands are used to set and query the registers and
queues used by the status and event reporting system, to investigate the state of
the instrument, and to control event generation. See section 3 for details on the
status and event reporting system.
Table 2Ć12: STATUS & EVENT commands
Header Description
ALLEv? Dequeue all events from Event Queue
*CLS Clear SESR, SBR and Event Queue
DESE(?) Set and query DESER
*ESE(?) Set and query ESER
*ESR? Query SESR
EVENT? Dequeue event from Event Queue
EVMsg? Dequeue event from Event Queue
EVQty? Query number of event on Event Queue
*PSC(?) Set powerĆon status clear flag
*SRE(?) Set and query SRER
*STB? Query SBR
2Ć16
DG2020A Programmer Manual
Command Groups
SYNCHRONIZATION
Commands
SYSTEM Commands
The SYNCHRONIZATION commands monitor for the completion of all
pending operations.
Table 2Ć13: SYNCHRONIZATION commands
Header Description
*OPC(?) Generate or return the operation complete message
*WAI Hold off all commands until all pending operations
complete
The SYSTEM commands are used (for example) to set the date and time, to lock
out front panel control, to control the handling of headers in responses, and to
query for ID and setting information. This group is a collection of commands
that cannot be classified in any other group.
Table 2Ć14: SYSTEM commands
Header Description
DEBug? Query all settings for debugging
DEBug:SNOop? Query all settings for debugging
DEBug:SNOop:DELAy? Query delay time for debugging
DEBug:SNOop:DELAy:TIME(?) Set delay time for debugging
DEBug:SNOop:STATe(?) Turn on or off for debugging
FACTory Reset all settings to defaults
HEADer(?) Allow or suppress the return of the control header in
response messages
ID? Query ID information about the data generator
*IDN? Query ID information about the data generator
LOCk(?) Lock or unlock local control using the frontĆpanel
controls
*OPT? Query which options are implemented for this data
generator
*RST Reset this data generator
SYSTem:DATE(?) Set the clock date
SYSTem:PPAUse(?) Set the setting for system operation when a
self-diagnostics detects an error
SYSTem:SECurity:IMMediate Delete all settings and data
SYSTem:SECurity:STATe(?) Set the security on/off state
SYSTem:TIME(?) Set the clock time
DG2020A Programmer Manual
2Ć17
Command Groups
Table 2Ć14: SYSTEM commands (Cont.)
Header Description
UNLock Unlock (allow) local control using the frontĆpanel
controls
UPTime? Query the elapsed time since power on
VERBose(?) Select short or long response headers
2Ć18
DG2020A Programmer Manual
Command Descriptions
This subsection lists each command and query in the command set alphabetically. Each command entry includes its command description and command group,
its related commands (if any), its syntax, and its arguments. Each entry also
includes one or more usage examples.
This subsection fully spells out headers, mnemonics, and arguments with the
minimal spelling shown in upper case. For example, to use the abbreviated
version of the DISPlay:BRIGhtness command, just type DISP:BRIG.
The symbol ’(?)’ follows the command header of those commands that can be
used as either a command or a query. The symbol ’?’ follows those commands
that can only be a query. If neither symbol follows the command, it can only be
used as a command.
ABSTouch
The ABSTouch command performs the same action that actuating the corresponding front-panel key, button, or knob would do.
Group
Related Commands
Syntax
Arguments
DISPLAY
ABSTouch {BOTTOM1 | BOTTOM2 | BOTTOM3 | BOTTOM4 | BOTTOM5 |
BOTTOM6 | BOTTOM7 | SIDE1 | SIDE2 | SIDE3 | SIDE4 | SIDE5 |
CLEARMenu | SETUp | EDIT | APPLication | UTILity | CURSor |
EXECute | UParrow | DOWNarrow | LEFTarrow | RIGHtarrow | KNOBLeft
| KNOBRight | RUN | STEp | ZERo | ONE | TWO | THREe | FOUR | FIVe
| SIX | SEVen | EIGHt | NINe | POINt|A|MINUs|B|HZ|S|V
|C|KHZ|MS|MV|D|MHZ|US|E|NS|F|DELete | ENTer
| HARDcopy | MANual}
Sending any of the arguments that are shown in Figure 2-2 is the equivalent of
operating a front panel control. Which argument corresponds to which control is
shown by in Figure 2-2. Sending an argument corresponding to a front-panel
button is the same as pressing that button once; if the argument sent corresponds
to a knob, it is the same as rotating the knob clockwise or counterclockwise by
1
@
of a turn.
25
DG2020A Programmer Manual
2Ć19
Command Descriptions
UParrow
EXECute
RIGHtarrow
KNOBLeft
KNOBRight
HARDcopy
MANual
DG2020A
DATAGENERATOR
SIDE 1
SIDE 2
SIDE 3
SIDE 4
CURSor
LEFTarrow
RUN
STEp
SETUp
EDIT
APPLication
UTILity
DOWNarrow
SIDE 5
ON/
STBY
CLEAR
MENU
BOTTOM 1 BOTTOM 7
CLEARMenu
SEVenąEIGHtąNINe
9
87
6
5
4
FOURąăFIVeăąSIX
23
1
ONEăTWOăTHREe
.
ZERo
0
-
A
F
NS
MHZ/US
E
ns
F
D
MHz/ms
kHz/ms/mV
B
CAB
E
D
C
KHZ/MS/MV
DELete
ENTERHz/s/V
ENTer
Figure 2Ć2: ABSTouch arguments and associated controls
Examples
ABSTOUCH SETUP
displays the same setup menu that is displayed by pressing the front-panel button
SETUP in the MENU column on the front panel.
ALLEv?
The ALLEv? query dequeues all event codes and their corresponding event
messages. Use the *ESR? query to make events available for dequeuing using
ALLEv? query.
Group
Related Commands
Syntax
STATUS & EVENT
*CLS, DESE, *ESE, *ESR?, EVENT?, EVMsg?, EVQty?, *SRE, *STB?
ALLEv?
HZ/S/VMINUsPOINt
2Ć20
DG2020A Programmer Manual
Command Descriptions
*CLS
Arguments
Responses
Examples
Group
None
[:ALLEV]<event code>,"<event message;second message>" [;<event
code>,"<event message:second message>"]...
ALLEV?
might return the string
:ALLEV 113,"Undefined header; unrecognized command - OUT:ELEV";
420, "Query UNTERMINATED".
The *CLS common command clears SESR (Standard Event Status Register), the
SBR (Status Byte Register) and the Event Queue, which are used in the data
generator status and event reporting system. For more details, refer to Section 3
Status and Events.
STATUS & EVENT
Related Commands
DATA?
Related Commands
Syntax
Examples
Group
Syntax
DESE, *ESE, *ESR?, *EVENT?, EVMsg?, EVQty?, *SRE, *STB?
*CLS
*CLS
clears the SESR, the SBR, and the Event Queue.
The DATA? query returns the setting states related to the pattern data.
DATA
OUTPut?
DATA?
DG2020A Programmer Manual
2Ć21
Command Descriptions
Examples
DATA:BLOCk:ADD
Group
Related Commands
Syntax
DATA?
might return
:DATA:MSIZE378;BLOCK:DEFINEĂ#2440,BLOCK_1<LF>99,BLOCK_2<LF>189,
BLOCK_3<LF>288,BLOCK_4;:DATA:SUBSEQUENCE:DEFINEĂ#217UNNAMED,1;
:DATA:SEQUENCE:DEFINEĂ#271BLOCK_1,1,0,1,0,0<LF>BLOCK_2,1,0,0,1,0
<LF>BLOCK_3,1,0,0,0,0<LF>BLOCK_4,1,0,0,0;:DATA:GROUP:DEFINEĂ#279
DATA7,7,7<LF>DATA6,6,6<LF>DATA5,5,5<LF>DATA4,4,4<LF>DATA3,3,3<LF>
DATA2,2,2<LF>DATA1,1,1<LF>DATA0,0,0
The DATA:BLOCk:ADD command adds a block. This results in one new block
being defined in the block definition section.
DATA
DATA:BLOCk:DEFine, DATA:BLOCk:DELete, DATA:BLOCk:DELete:ALL,
DATA:BLOCk:REName, DATA:BLOCk:SIZe
DATA:BLOCk:ADD <Position>,<Name>
Arguments
Examples
<Position>::=<NR1>
where <NR1> is the start position of the added block.
<Name>::=<string>
where <string> is the name of the added block.
:DATA:BLOCK:ADD 512,"BLOCK1"
adds a block starting at address 512 named BLOCK1.
2Ć22
DG2020A Programmer Manual
DATA:BLOCk:DEFine (?)
The DATA:BLOCk:DEFine command sets up the information for the whole block
definition section in ASCII. The DATA:BLOCk:DEFine? query returns the whole
block definition section.
Command Descriptions
Group
Related Commands
Syntax
Arguments
DATA
DATA:BLOCk:ADD, DATA:BLOCk:DELete, DATA:BLOCk:DELete:ALL,
DATA:BLOCk:REName, DATA:BLOCk:SIZe
DATA:BLOCk:DEFine <Blockinfo>
DATA:BLOCk:DEFine?
<Blockinfo>::=<blockheader><Blkdef>[<LF><Blkdef>][<LF><Blkdef>]...
Arbitrary block data for the block definition
where,
<blockheader>::=<byte count digit><byte count>
<Blkdef>::=<APosition>,<AName>
<Aposition> is the block starting position specified in ASCII (Note that the
starting position of the first block must be zero), and <AName> is the block
name specified in ASCII.
<LF>::=<ASCII line feed code (dec 10)>
Responses
Examples
DG2020A Programmer Manual
[:DATA:BLOCk:DEFINE] <Blockinfo>
where <Blockinfo> is a data block in the same format as the argument.
:DATA:BLOCk:DEFine #2320,BLOCK0<LF>512,BLOCK1<LF>1024,BLOCK2
defines three blocks: BLOCK0, BLOCK1, and BLOCK2.
2Ć23
Command Descriptions
DATA:BLOCk:DELete
The DATA:BLOCk:DELete command deletes the specified block. Note that the
first block cannot be deleted.
Group
Related Commands
Syntax
Arguments
Examples
DATA
DATA:BLOCk:ADD, DATA:BLOCk:DEFine, DATA:BLOCk:DELete:ALL,
DATA:BLOCk:REName, DATA:BLOCk:SIZe
DATA:BLOCk:DELete <Name>
<Name>::=<string>
where <string> is the name of the block to be deleted.
:DATA:BLOCK:DELETE "BLOCK2"
deletes the block with the name BLOCK2.
DATA:BLOCk:DELete:ALL
The DATA:BLOCk:DELete:ALL command deletes all blocks. After this command
is executed, the whole memory area consists of one block with the name ”NO
NAME”.
2Ć24
Group
Related Commands
Syntax
Arguments
DATA
DATA:BLOCk:ADD, DATA:BLOCk:DEFine, DATA:BLOCk:DELete,
DATA:BLOCk:REName, DATA:BLOCk:SIZe
DATA:BLOCk:DELete:ALL
None
DG2020A Programmer Manual
DATA:BLOCk:REName
Command Descriptions
The DATA:BLOCk:REName command changes the name of a data block.
Group
Related Commands
Syntax
Arguments
Examples
DATA:BLOCk:SIZe (?)
DATA
DATA:BLOCk:ADD, DATA:BLOCk:DEFine, DATA:BLOCk:DELete,
DATA:BLOCk:DELete:ALL, DATA:BLOCk:SIZe
DATA:BLOCk:REName <From-blockname>,<To-blockname>
<From-blockname>::=<string>
where <string> is the name of the block before it is renamed.
<To-blockname>::=<string>
where <string> is the name of the block after it is renamed.
:DATA:BLOCK:RENAME "BLOCK3","BLOCK4"
changes the name of BLOCK3 to BLOCK4.
The DATA:BLOCk:SIZe command changes the size of a data block. The
DATA:BLOCk:SIZe? query returns the size of the specified block.
Group
Related Commands
Syntax
Arguments
Responses
DG2020A Programmer Manual
DATA
DATA:BLOCk:ADD, DATA:BLOCk:DEFine, DATA:BLOCk:DELete,
DATA:BLOCk:DELete:ALL, DATA:BLOCk:REName
DATA:BLOCk:SIZe <Name>,<Size>
DATA:BLOCk:SIZe? <Name>
<Name>::=<string>
where <string> is a block name.
<Size>::=<NR1>
where <NR1> is a new block size.
[:DATA:BLOCK:SIZE] <Name>,<Size>
2Ć25
Command Descriptions
Examples
DATA:GROUp:ADD
Group
Related Commands
Syntax
Arguments
:DATA:BLOCK:SIZE "BLOCK1",512
changes the block size of the block BLOCK1 to 512.
The DATA:GROUp:ADD command adds a group.
DATA
DATA:GROUp:BIT, DATA:GROUp:DEFine, DATA:GROUp:DELete,
DATA:GROUp:DELete:ALL, DATA:GROUp:NAME?, DATA:GROUp:REName
DATA:GROUp:ADD <Name>,<MSB>,<LSB>
<Name>::=<string>
where <string> is the name of the group to be added.
<MSB>::=<NR1>
where MSB is the Most Significant Bit
where <NR1>is the high order bit for the group.
Examples
<LSB>::=<NR1>
where LSB is the Least Significant bit
where <NR1>is the low order bit for the group.
:DATA:GROUP:ADD "GROUP01",3,0
adds a group that consists of 4 bits, DATA00 to DATA03, and has the name
GROUP01.
2Ć26
DG2020A Programmer Manual
DATA:GROUp:BIT (?)
Command Descriptions
The DATA:GROUp:BIT command changes the bit configuration of a group. The
DATA:GROUp:BIT? query returns the set bit configuration.
Group
Related Commands
Syntax
Arguments
Responses
Examples
DATA
DATA:GROUp:ADD, DATA:GROUp:DEFine, DATA:GROUp:DELete,
DATA:GROUp:DELete:ALL, DATA:GROUp:NAME?, DATA:GROUp:REName
DATA:GROUp:BIT <Name>,<MSB>,<LSB>
DATA:GROUp:BIT? <Name>
<Name>::=<string>
where the name of the group to be changed or queried.
<MSB>::=<NR1>
where <NR1>is the high order bit for the group.
<LSB>::=<NR1>
where <NR1>is the low order bit for the group.
[:DATA:GROUP:BIT] <Name>,<MSB>,<LSB>
:DATA:GROUP:BIT "GROUP02",7,4
changes the bit configuration for the group named GROUP02 to be DATA04 to
DATA07.
DG2020A Programmer Manual
2Ć27
Command Descriptions
DATA:GROUp:DEFine (?)
The DATA:GROUp:DEFine command sets up the information for the whole group
definition section in ASCII. The DATA:GROUp:DEFine? query returns the
information for the whole group definition section.
Group
Related Commands
Syntax
Arguments
DATA
DATA:GROUp:ADD, DATA:GROUp:BIT, DATA:GROUp:DELete,
DATA:GROUp:DELete:ALL, DATA:GROUp:NAME?, DATA:GROUp:REName
DATA:GROUp:DEFine <Groupblock>
DATA:GROUp:DEFine?
<Groupblock>::=<blockheader><Group>[<LF><Group>][<LF><Group>]...
Arbitrary block data for the group definition
where,
<blockheader>::=<byte count digit><byte count>
<Group>::=<AName>,<AMSB>,<ALSB>
The <AName>, <AMSB>, and <ALSB> fields are ASCII character strings that
specify the following information.
<AName> group name
<AMSB> group’s high order bit
<ALSB> group’s low order bit
2Ć28
Responses
Examples
<LF>::=<ASCII line feed code (10)>
[:DATA:GROUP:DEFINE] <Groupblock>
where <Groupblock> is a data block with the same format as the argument.
:DATA:GROUp:DEFine
#238GROUP01,7,0<LF>GROUP02,11,8<LF>GROUP03,15,12
defines the three groups GROUP01, GROUP02, and GROUP03.
DG2020A Programmer Manual
DATA:GROUp:DELete
Command Descriptions
The DATA:GROUp:DELete command deletes the specified group.
Group
Related Commands
Syntax
Arguments
Examples
DATA
DATA:GROUp:ADD, DATA:GROUp:BIT, DATA:GROUp:DEFine,
DATA:GROUp:DELete:ALL, DATA:GROUp:NAME?, DATA:GROUp:REName
DATA:GROUp:DELete <Name>
<Name>::=<string>
where <string> is the name of the group to delete.
:DATA:GROUP:DELETE "GROUP02"
deletes the group with the name GROUP02.
DATA:GROUp:DELete:ALL
The DATA:GROUp:DELete:ALL command deletes all group definitions.
Group
DATA
Related Commands
Syntax
Arguments
DATA:GROUp:NAME?
Group
DG2020A Programmer Manual
DATA:GROUp:ADD, DATA:GROUp:BIT, DATA:GROUp:DEFine, DATA:GROUp:DEĆ
Lete, DATA:GROUp:NAME?, DATA:GROUp:REName
DATA:GROUp:DELete:ALL
None
The DATA:GROUp:NAME? query returns the name of the group that includes the
specified bit.
DATA
2Ć29
Command Descriptions
Related Commands
Syntax
Arguments
Responses
Examples
DATA:GROUp:REName
DATA:GROUp:ADD, DATA:GROUp:BIT, DATA:GROUp:DEFine, DATA:GROUp:DEĆ
Lete, DATA:GROUp:DELete:ALL, DATA:GROUp:REName
DATA:GROUp:NAME? <Bit>
<Bit>::=<NR1>
where <NR1> is the number of the bit to be queried (0 to 35).
[:DATA:GROUP:NAME] <Bit>,<Name>
where
<Bit>::=<NR1> a bit number (0 to 35)
<Name>::=<string> the group name
DATA:GROUp:NAME? <6>
might return :DATA:GROUP:NAME 6,"GROUP02", which indicates that the name
of the group that includes the DATA06 bit is GROUP02.
Group
Related Commands
Syntax
Arguments
Examples
The DATA:GROUp:REName command changes the name of a group.
DATA
DATA:GROUp:ADD, DATA:GROUp:BIT, DATA:GROUp:DEFine, DATA:GROUp:DEĆ
Lete, DATA:GROUp:DELete:ALL, DATA:GROUp:NAME?
DATA:GROUp:REName <From-groupname>,<To-groupname>
<From-groupname>::=<string>
where <string> is the name of the group before it is renamed.
<To-groupname>::=<string>
where <string> is the name of the group after it is renamed.
:DATA:GROUP:RENAME "GROUP03","GROUP04"
changes the name of the group GROUP03 to be GROUP04.
2Ć30
DG2020A Programmer Manual
DATA:MSIZe (?)
Command Descriptions
The DATA:MSIZe command sets the bit pattern section memory area size. The
DATA:MSIZe? query returns the bit pattern section memory area setting.
Group
Related Commands
Syntax
Arguments
Responses
DATA:PATTern:BIT (?)
DATA
DATA:MSIZe <Memory Size>
DATA:MSIZe?
<Memory Size>::=<NR1>
where <NR1> is the number that expresses the memory size (in words).
[:DATA:MSIZE] <Memory Size>
The DATA:PATTern:BIT command sets the data memory bit pattern section. Data
is given in bit units. The DATA:PATTern:BIT? query returns the contents of the
data memory bit pattern section.
Group
Related Commands
Syntax
DG2020A Programmer Manual
DATA
DATA:PATTern[:WORD]
DATA:PATTern:BIT <Bit Position>,<Address>,<Length>,<Data>
DATA:PATTern:BIT? <Bit Position>,<Address>,<Length>
2Ć31
Command Descriptions
Arguments
Responses
<Bit Position>::=<NR1> bit position (0 to 35)
<Address>::=<NR1> start address (0 to 65535)
<Length>::=<NR1> data length (1 to 65536)
<Data>::=<block> arbitrary block data for the bit pattern section
Example where the data length is 128:
#3128<bit 1> <bit 2> ... <bit 128>
Number of digits
<bit N> ::= {1 | 0}
Number of bits
The value of the data bit at the specified address is specified with the ASCII
character for 0 or 1. Data bits for the specified data length are stored in
address order, with all bits expressed similarly in ASCII. The number of
bytes in the block header will be equal to the length of the specified data.
[:DATA:PATTERN:BIT] <Bit Position>,<Address>,<Length>,<Data>
2Ć32
DG2020A Programmer Manual
DATA:PATTern[:WORD] (?)
The DATA:PATTern[:WORD] command sets the data memory bit pattern section.
The data is given in word units. The DATA:PATTern:WORD? query returns the
contents of the data memory bit pattern section.
Command Descriptions
Group
Related Commands
Syntax
Arguments
DATA
DATA:PATTern:BIT
DATA:PATTern[:WORD] <Address>,<Length>,<Data>
DATA:PATTern:[WORD]? <Address>,<Length>
<Address>::=<NR1>
where <NR1> is a start address (0 to 65535)
<Length>::=<NR1> data length (1 to 65536)
<Data>::=<block> arbitrary block data for the bit pattern section
Example where the data length is 50:
#3250<byte 1> <byte 2> ... <byte 250>
Number of digits
<byte 1> <byte 2> <byte 3> <byte 4> <byte 5>
Number of bytes
bit 35–32
bit 31–24
bit 23–16
bit 15–8
bit 7–0
Responses
DG2020A Programmer Manual
Each word (36 bits) of the bit pattern data is expressed as a group of 5 bytes
starting with the first byte. When each byte group is seen as consisting of the
bytes byte1 to byte5 as shown in the figure, the bits correspond to the bits in
the bit pattern data starting with the MSB in order starting with byte1.
Although all 8 bits in byte2 to byte5 are used, the high–order 4 bits in byte1
are unused. The data block is formed by iterating this packing method for
each word in order starting with the start address. Thus the number of bytes
in the data block (excluding the header) will be 5 times the number of words.
[:DATA:PATTERN:WORD] <Address>,<Length>,<Data>
2Ć33
Command Descriptions
DATA:SEQuence:ADD
The DATA:SEQuence:ADD command adds a sequence step.
Group
Related Commands
Syntax
Arguments
DATA
DATA:SEQuence:DEFine, DATA:SEQuence:DELete, DATA:SEQuence:DEĆ
Lete:ALL
DATA:SEQuence:ADD <LineN>,<Name>,<ReĆ
peat>,<To>,<WaitE>,<JumpE>,<LoopE>
<LineN>::=<NR1>
where <NR1> is a sequence step number.
<Name>::=<string>
where <string> is a block name (surrounded in double (”) or single (’) quotes).
<Repeat>::=<NR1>
where <NR1> is a repeat count (1 to 65536).
<To>::=<NR1>
where <NR1> is a event jump destination line number.
<WaitE>::={ON | OFF|1|0} trigger wait on/off state
Examples
<JumpE>::={ON | OFF|1|0} event jump on/off state
<LoopE>::={ON | OFF|1|0} infinite loop on/off
:DATA:SEQUENCE:ADD 4,"BLOCK3",16,0,0,1,1
adds a sequence step that consists of the block named BLOCK3 at the sequence
line number 4 position.
When this sequence is executed in enhanced mode, BLOCK3 will be executed
repeatedly since the infinite loop setting is set on. However, since event jump is
also set on, the instrument will jump to sequence line number 0 if an external
event occurs. In run modes other than enhanced mode, BLOCK3 will be
executed 16 times and then control will switch to the next line number.
2Ć34
DG2020A Programmer Manual
DATA:SEQuence:DEFine (?)
The DATA:SEQuence:DEFine command sets up all of the sequence definition
section information in ASCII. The DATA:SEQuence:DEFine? query returns all of
the sequence definition section information.
Command Descriptions
Group
Related Commands
Syntax
Arguments
DATA
DATA:SEQuence:ADD, DATA:SEQuence:DELete, DATA:SEQuence:DELete:ALL
DATA:SEQuence:DEFine <Sequence Block>
DATA:SEQuence:DEFine?
<Sequence Block>::=<blockheader><Step>[<LF><Step>][<LF><Step>]...
Arbitrary block data for the sequence definition
where,
<blockheader>::=<byte count digit><byte count>
<Step>::=<AName>,<ARepeat>,<ATo>,<AWaitE>,<AJumpE>,<ALoopE>
The items in <Step> are ASCII character strings that express the following
information.
<AName> the block name (with no quotation marks)
<ARepeat> repeat count (1 to 65536)
<ATo> event jump destination line number
<AWaitE> trigger wait on/off state ({ON | 1}:ON, {OFF | 0}:OFF)
<AJumpE> event jump on/off state ({ON | 1}:ON, {OFF | 0}:OFF)
<ALoopE> infinite loop on/off ({ON | 1}:ON, {OFF | 0}:OFF)
Responses
Examples
DG2020A Programmer Manual
<LF>::=<ASCII line feed code (10)>
[:DATA:SEQUENCE:DEFINE] <Sequence Block>
where <Sequence Block> is a data block with the same format as the argument.
However, note that rather than the ON and OFF keywords, only 0 and 1 are used
for the <AWaitE>, <AJumpE>, and <ALoopE> items.
:DATA:SEQuence:DEFine #235BLOCK1,16,0,1,0,0<LF>BLOCK2,32,0,0,1,1
defines a two step sequence that consists of the two blocks BLOCK1 and
BLOCK2.
2Ć35
Command Descriptions
DATA:SEQuence:DELete
The DATA:SEQuence:DELete command deletes the specified sequence step.
Group
Related Commands
Syntax
Arguments
Examples
DATA
DATA:SEQuence:ADD, DATA:SEQuence:DEFine, DATA:SEQuence:DELete:ALL
DATA:SEQuence:DELete <Line Number>
<Line Number>::=<NR1>
where <NR1> is the line number of the sequence step to be deleted.
:DATA:SEQUENCE:DELETE 3
deletes the line 3 sequence step.
DATA:SEQuence:DELete:ALL
The DATA:SEQuence:DELete:ALL command deletes all sequence definitions.
Group
DATA
2Ć36
Related Commands
Syntax
Arguments
DATA:SEQuence:ADD, DATA:SEQuence:DEFine, DATA:SEQuence:DELete
DATA:SEQuence:DELete:ALL
None
DG2020A Programmer Manual
DATA:SEQuence:EVJ (?)
The DATA:SEQuence:EVJ command sets the sequence step event jump to on or
off. The DATA:SEQuence:EVJ? query returns the sequence step event jump
on/off state.
Command Descriptions
Group
Related Commands
Syntax
Arguments
Responses
Examples
DATA
DATA:SEQuence:EVJTO, DATA:SEQuence:LOOP, DATA:SEQuence:REPeat,
DATA:SEQuence:TWAIT
DATA:SEQuence:EVJ <Line Number>,{ON | OFF|1|0}
DATA:SEQuence:EVJ? <Line Number>
<Line Number>::=<NR1>
where <NR1> is the line number of the sequence step to be set.
ON or 1
sets the event jump to on.
OFF or 0
sets the event jump to off.
[:DATA:SEQUENCE:EVJ] <Line Number>,{1 | 0}
:DATA:SEQUENCE:EVJ 8,ON
sets the event jump state for the line 8 sequence step to on.
DG2020A Programmer Manual
2Ć37
Command Descriptions
DATA:SEQuence:EVJTO (?)
The DATA:SEQuence:EVJTO command sets the sequence step event jump
destination. The DATA:SEQuence:EVJTO? query returns the event jump
destination set for the sequence step.
Group
Related Commands
Syntax
Arguments
Responses
Examples
DATA
DATA:SEQuence:EVJ, DATA:SEQuence:LOOP, DATA:SEQuence:REPeat,
DATA:SEQuence:TWAIT
DATA:SEQuence:EVJTO <Line Number>,<Target>
DATA:SEQuence:EVJTO? <Line Number>
<Line Number>::=<NR1>
where <NR1> is the line number of the sequence step to be set.
<Target>::=<NR1>
where <NR1> is the line number of the jump destination sequence step.
[:DATA:SEQUENCE:EVJTO] <Line Number>,<Target>
:DATA:SEQUENCE:EVJTO 5,0
sets the line 5 sequence step event jump destination to line 0.
2Ć38
DG2020A Programmer Manual
DATA:SEQuence:LOOP (?)
The DATA:SEQuence:LOOP command sets the sequence step infinite loop state to
on or off. The DATA:SEQuence:LOOP? query returns the sequence step infinite
loop on/off state.
Command Descriptions
Group
Related Commands
Syntax
Arguments
Responses
Examples
DATA
DATA:SEQuence:EVJ, DATA:SEQuence:EVJTO, DATA:SEQuence:REPeat,
DATA:SEQuence:TWAIT
DATA:SEQuence:LOOP <Line Number>,{ON | OFF|1|0}
DATA:SEQuence:LOOP? <Line Number>
<Line Number>::=<NR1>
where <NR1> is the line number of the sequence step to be set.
ON or 1
sets the infinite loop state to on.
OFF or 0
sets the infinite loop state to off.
[:DATA:SEQUENCE:LOOP] <Line Number>,{1 | 0}
:DATA:SEQUENCE:LOOP 9,OFF
sets the infinite loop state for the line 9 sequence step to off.
DATA:SEQuence:REPeat (?)
The DATA:SEQuence:REPeat command sets the sequence step repeat count. The
DATA:SEQuence:REPeat? query returns the repeat count set for the sequence
step.
Group
Related Commands
DG2020A Programmer Manual
DATA
DATA:SEQuence:EVJ, DATA:SEQuence:EVJTO, DATA:SEQuence:LOOP,
DATA:SEQuence:TWAIT
2Ć39
Command Descriptions
Syntax
Arguments
Responses
Examples
DATA:SEQuence:REPeat <Line Number>,<Times>
DATA:SEQuence:REPeat? <Line Number>
<Line Number>::=<NR1>
where <NR1> is the line number of the sequence step to be set.
<Times>::=<NR1>
where <NR1> is a repeat count (1 to 65536).
[:DATA:SEQUENCE:REPEAT] <Line Number>,<Times>
:DATA:SEQUENCE:REPEAT 5,8
sets the line 5 sequence step repeat count to 8.
DATA:SEQuence:TWAIT (?)
The DATA:SEQuence:TWAIT command sets the sequence step trigger wait state to
on or off. The DATA:SEQuence:TWAIT? query returns the sequence step trigger
wait on/off state.
Group
Related Commands
Syntax
Arguments
Responses
Examples
DATA
DATA:SEQuence:EVJ, DATA:SEQuence:EVJTO, DATA:SEQuence:LOOP,
DATA:SEQuence:REPeat
DATA:SEQuence:TWAIT <Line Number>,{ON | OFF|1|0}
DATA:SEQuence:TWAIT? <Line Number>
<Line Number>::=<NR1>
where <NR1> is the line number of the sequence step to be set.
ON or 1
sets the trigger wait state to on.
OFF or 0
sets the trigger wait state to off.
[:DATA:SEQUENCE:TWAIT] <Line Number>,{1 | 0}
:DATA:SEQUENCE:TWAIT 5,ON
sets the line 5 sequence step trigger wait state to on.
2Ć40
DG2020A Programmer Manual
DATA:SUBSequence:ADD
The DATA:SUBSequence:ADD command adds a sub sequence step.
Command Descriptions
Group
Related Commands
Syntax
Arguments
Examples
DATA
DATA:SUBSequence:DEFine, DATA:SUBSequence:DELete,
DATA:SUBSequence:DELete:ALL
DATA:SUBSequence:ADD <Sname>, <LineN>, <Name>, <Repeat>
<Sname>::=<String>
where <string> is a sub sequence name (surrounded in double (”) or single (’)
quotes).
<LineN>::=<NR1>
where <NR1> is a sub sequence step number.
<Name>::=<String>
where <string> is a block name (surrounded in double (”) or single (’) quotes).
<Repeat>::=<NR1>
where <NR1> is a repeat count (1 to 65536).
:DATA:SUBSEQUENCE:ADD "SUB1",2"BLOCK3",10
adds a sub sequence step that consists of the block named BLOCK3 at the sub
sequence line number 2 position in the sub sequence named SUB1.
DATA:SUBSequence:CLEAr
The DATA:SUBSequence:CLEAr command clears all sub sequence definitions.
Group
Related Commands
Syntax
Arguments
DG2020A Programmer Manual
DATA
DATA:SUBSequence:ADD, DATA:SUBSequence:DEFine,
DATA:SUBSequence:DELete, DATA:SUBSequence:DELete:ALL
DATA:SUBSequence:DELete:CLEAr
None
2Ć41
Command Descriptions
DATA:SUBSequence:DEFine (?)
The DATA:SUBSequence:DEFine command sets up all of the sub sequence
definition section information in ASCII. The DATA:SUBSquence:DEFine? query
returns all of the sub sequence definition section information.
Group
Related Commands
Syntax
Arguments
DATA
DATA:SUBSequence:ADD, DATA:SUBSequence:CLEAr,
DATA:SUBSequence:DELete, DATA:SUBSequence:DELete:ALL
DATA:SUBSequence:DEFine <Subseq Block>
DATA:SUBSequence:DEFine?
<Subseq Block>::=<blockheadĆ
er><SName>,<Step>[,<Step>...][<LF><SName>,<Step>][,<Step>...]...]
Arbitrary block data for the sequence definition
where,
<Step>::=<AName>,<ARepeat>
The items in <Step> are ASCII character strings that express the following
information.
<SName> the sub sequence name (with no quotation marks)
<AName> the block name (with no quotation marks)
<ARepeat> repeat count (1 to 65536)
2Ć42
Responses
Examples
<LF>::=<ASCII line feed code (10)>
[:DATA:SUBSEQUENCE:DEFINE] <Subseq Block>
where <Subseq Block> is a data block with the same format as the argument.
:DATA:SUBSEQUENCE:DEFINE #233SUB1,B1,16,B2,32<LF>SUB2,B3,2,B4,3
defines a two step sub sequence that consists of the two sub sequences SUB1 and
SUB2.
DG2020A Programmer Manual
DATA:SUBSequence:DELete
The DATA:SUBSequence:DELete command deletes the specified sub sequence
step.
Command Descriptions
Group
Related Commands
Syntax
Arguments
Examples
DATA
DATA:SUBSequence:ADD, DATA:SUBSequence:CLEAr,
DATA:SUBSequence:DEFine, DATA:SUBSequence:DELete:ALL
DATA:SUBSequence:DELete <SName>,<Line Number>
<SName>::=<String>
where <String> is a sub sequence name (surrounded in double (”) or single (’)
quotes).
<Line Number>::=<NR1>
where <NR1> is the line number of the sequence step to be deleted.
:DATA:SUBSEQUENCE:DELETE "SUB2", 7
deletes the line 7 sub sequence step named SUB2.
DATA:SUBSequence:DELete:ALL
Group
Related Commands
Syntax
Arguments
DG2020A Programmer Manual
The DATA:SUBSequence:DELete:ALL command deletes the specified sub
sequence definitions.
DATA
DATA:SUBSequence:ADD, DATA:SUBSequence:CLEAr,
DATA:SUBSequence:DEFine, DATA:SUBSequence:DELete
DATA:SUBSequence:DELete:ALL <SName>
<SName>::=<String>
where <String> is a sub sequence name (surrounded in double (”) or single (’)
quotes).
2Ć43
Command Descriptions
Examples
:DATA:SUBSEQUENCE:DELETE:ALL "SUB1"
deletes the sub sequence definition named SUB1.
DATA:SUBSequence:REPeat (?)
The DATA:SUBSequence:REPeat command sets the sub sequence step repeat
count. The DATA:SUBSequence:REPeat? query returns the repeat count set for
the sub sequence step.
Group
Related Commands
Syntax
Arguments
DATA
None
DATA:SUBSequence:REPeat <SName>,<Line Number>,<Times>
DATA:SUBSequence:REPeat? <SName>,<Line Number>
<SName>::=<String>
where <String> is a sub sequence name (surrounded in double (”) or single (’)
quotes).
Responses
Examples
<Line Number>::=<NR1>
where <NR1> is the line number of the sequence step to be set.
<Times>::=<NR1>
where <NR1> is a repeat count (1 to 65536).
[:DATA:SUBSEQUENCE:REPEAT] <SName>,<Line Number>,<Times>
:DATA:SUBSEQUENCE:REPEAT "SUB1",5,8
sets the line 5 sequence step repeat count in the sub sequence named SUB1 to 8.
2Ć44
DG2020A Programmer Manual
DATA:UPDate
Command Descriptions
The DATA:UPDate command transfers the contents of data memory to pattern
generation memory so that the output reflects the most recent data. This
command is only valid when the mode is set to manual mode. The processing
performed by this command is executed automatically if any data changes when
the instrument is in automatic mode.
Related Commands
DEBug?
Related Commands
Group
Syntax
Arguments
Group
DATA
DATA:UPDate
None
The DEBug? query returns all current settings for the remote command debugging
function.
This query is equivalent to the DEBug:SNOop? query.
SYSTEM
DEBug:SNOop?, DEBug:SNOop:DELAy:TIME, DEBug:SNOop:STATe
Syntax
Arguments
Responses
Examples
DG2020A Programmer Manual
DEBug?
None
See Examples
DEBUG?
might return :DEBUG:SNOOP:STATE 0; DELAY:TIME 0.2
2Ć45
Command Descriptions
DEBug:SNOop?
The DEBug:SNOop? query returns all current settings for the remote command
debugging function.
This query is equivalent to the DEBug? query.
Group
Related Commands
Syntax
Arguments
Responses
Examples
SYSTEM
DEBug?, DEBug:SNOop:DELAy:TIME, DEBug:SNOop:STATe
DEBug:SNOop?
None
See Examples
DEBUG:SNOOP?
might return :DEBUG:SNOOP:STATE 0; DELAY:TIME 0.2
2Ć46
DG2020A Programmer Manual
DEBug:SNOop:DELAy?
Command Descriptions
The DEBug:SNOop:DELAy? query returns the display time for commands in a
sequence of commands connected by semicolons.
This query is equivalent to the DEBug:SNOop:DELAy:TIME? query.
Group
Related Commands
Syntax
Arguments
Responses
Examples
SYSTEM
DEBug?, DEBug:SNOop?, DEBug:SNOop:DELAy:TIME?, DEBug:SNOop:STATe
DEBug:SNOop:DELAy?
None
[:DEBUG:SNOOP:DELAY]<Delay Time>
where <Delay Time>::=<NR2>
DEBUG:SNOOP:DELAY?
might return :DEBUG:SNOOP:DELAY:TIME 0.2
DG2020A Programmer Manual
2Ć47
Command Descriptions
DEBug:SNOop:DELAy:TIME (?)
The DEBug:SNOop:DELAy:TIME command sets the display time for commands in
a sequence of commands that are connected by semicolons.
The DEBug:SNOop:DELAy:TIME? query returns the display time for commands in
a sequence of commands connected by semicolons.
Group
Related Commands
Syntax
Arguments
Examples
SYSTEM
DEBug?, DEBug:SNOop?, DEBug:SNOop:DELAy?, DEBug:SNOop:STATe
DEBug:SNOop:DELAy:TIME <Time>
DEBug:SNOop:DELAy:TIME?
<Time>::=<NR2>[<unit>]
where <NR2> combined with [<unit>] specifies a time in the range 0.0 s to
10.0 s in steps of 0.1 s, and [<unit>]::={s|ms|ms}, for seconds, milliseconds,
or microseconds.
:DEBUG:SNOOP:DELAY:TIME 0.5
sets the command display time to 0.5 seconds.
2Ć48
DG2020A Programmer Manual
DEBug:SNOop:STATe (?)
The DEBug:SNOop:STATe command sets and clears the remote command
debugging function.
The DEBug:SNOop:STATe? query returns the currently specified state of the
remote command debugging function.
The debugging function displays messages input from the remote interface in the
CRT screen message area. If commands are connected by semicolons, each
message is displayed for the time specified with the DEBug:SNOop:DELAy:TIME
command.
The display format is as follows.
Control codes — "<code decimal display>", e.g. LF is displayed as
"<10>".
Alphanumerics and symbols — "<code ASCII display>", e.g., "A" is
displayed as "A".
Command Descriptions
Group
Related Commands
Syntax
Arguments
Message termination — "<PMT>"
Interface messages — "<DCL>" and "<GET>". Others are displayed as
"<code decimal display>".
Block data — "#0"
Any data other than one of the above — "<code decimal display>",
e.g. a code value of 80 (hexadecimal) would be displayed as <128>.
SYSTEM
DEBug?, DEBug:SNOop?, DEBug:SNOop:DELAy?, DEBug:SNOop:TIME
DEBug:SNOop:STATe {ON | OFF | <NR1>}
DEBug:SNOop:STATe?
ON or nonzero value
enables the debugging function.
OFF or zero value
clears the debugging function.
DG2020A Programmer Manual
2Ć49
Command Descriptions
DESE (?)
Related Commands
Responses
Examples
Group
1 the debugging function is currently set.
0 the debugging function is currently cleared.
:DEBUG:SNOOP:STATE ON
enables the debugging function.
The DESE command sets the bits of the DESER (Device Event Status Enable
Register) used in the status and event reporting system of the data generator. The
DESE? query returns the contents of the DESER. Refer to Section 3 Status and
Events for more information about DESE.
The power-on default for the DESER is to set all bits to 1 if the power-on status
flag is TRUE. If this flag is set to FALSE, the DESER maintains its current
value through a power cycle.
STATUS & EVENT
*CLS, *ESE, *ESR?, EVENT?, EVMsg?, EVQty?, *SRE, *STB?
Syntax
Arguments
Examples
DESE <Bit Value>
DESE?
<Bit Value>::=<NR1>
where <NR1> is a decimal integer, which must range from 0 to 255, that sets the
DESER bits to its binary equivalent.
:DESE 177
sets the DESER to 177 (binary 10110001), which sets the PON, CME, EXE and
OPC bits.
:DESE?
might return :DESE 176, which indicates that the DESER contains the binary
number 10110000.
2Ć50
DG2020A Programmer Manual
DIAGnostic?
Command Descriptions
The DIAGnostic? query returns the selected self-test routine(s), runs the routine,
and returns the results.
Group
Related Commands
Syntax
Arguments
Responses
DIAGNOSTIC
DIAGnostic:SELect, DIAGnostic:STATe, DIAGnostic:RESUlt?
DIAGnostic?
None
[:DIAGNOSTIC:SELECT] <Self-test Routine>; [RESULT],<Result>[,
<Result>]...
<SelfĆtest Routine>::= <label>
where <label>
ALL all routines
CPU CPU unit check routine
DISPlay display unit check routine
FPANel front panel control unit check routine
CLOCk clock unit check routine
TRIGger trigger unit test routine
PMEMory pattern memory check routine
SMEMory sequence memory check routine
is one of following routines:
DG2020A Programmer Manual
and where <Result>::=<NR1> is one of following responses:
ăă0 terminated without error
100 detected an error in the CPU unit
200 detected an error in the display unit
300 detected an error in the front panel unit
400 detected an error in the clock unit
500 detected an error in the trigger unit
600 detected an error in the sequence memory
700 detected an error in the pattern memory
NOTE. The does not respond to any commands or queries issued during Self
Test.
2Ć51
Command Descriptions
Examples
DIAGnostic:RESUlt?
Group
Related Commands
Syntax
Arguments
Responses
DIAGNOSTIC?
might return :DIAGNOSTIC:SELECT ALL;RESULT 0.
The DIAGnostic:RESUlt? query returns the results of self-test execution.
DIAGNOSTIC
DIAGnostic:SELect, DIAGnostic:STATe
DIAGnostic:RESUlt?
None
:DIAGNOSTIC:RESULT<Result>[,<Result>]...
<Result>::=<NR1>
<NR1> is one of following values:
where
Examples
ăă0 terminated without error
100 detected an error in the CPU unit
200 detected an error in the display unit
300 detected an error in the front panel unit
400 detected an error in the clock unit
500 detected an error in the trigger unit
600 detected an error in the sequence memory
700 detected an error in the pattern memory
DIAGNOSTIC:RESULT?
might return :DIAGNOSTIC:RESULT 200
2Ć52
DG2020A Programmer Manual
DIAGnostic:SELect (?)
Command Descriptions
The DIAGnostic:SELect command selects the self test routine. The DIAGnosĆ
tic:SELect? query returns the currently selected routine. The DIAGnosĆ
tic:STATe command executes the routine.
Group
Related Commands
Syntax
Arguments
Examples
DIAGNOSTIC
DIAGnostic:STATe, DIAGnostic:RESULt?
DIAGnostic:SELect { ALL | CPU | DISPlay | FPANel | CLOCk |
TRIGger | SMEMory | PMEMory }
DIAGnostic:SELect?
ALL checks all routines that follow
CPU checks the CPU unit
DISPlay checks the display unit
FPANel checks the front panel control unit
CLOCk checks the clock unit
TRIGger checks the trigger unit
SMEMory checks the sequence memory
PMEMory checks the pattern memory
:DIAGNOSTIC:SELECT CPU ; STATE EXECUTE
executes the CPU self-test routine.
DIAGnostic:STATe
Group
Related Commands
Syntax
DG2020A Programmer Manual
The DIAGnostic:STATe command executes the self-test routine(s) selected with
the DIAGnostic:SELect command. If an error is detected during execution, the
routine that detected the error terminates. If all of the self-test routines are
selected using the DIAGnostic:SELect command, self-testing continues with
execution of the next self-test routine.
DIAGNOSTIC
DIAGnostic:SELect, DIAGnostic:RESUlt?
DIAGnostic:STATe EXECute
2Ć53
Command Descriptions
DISPlay?
Related Commands
Arguments
Examples
Group
Syntax
Arguments
EXECute
Performs the self-test using the selected routine.
:DIAGNOSTIC:SELECT ALL ; STATE EXECUTE ; RESULT?
executes all of the self-test routines. After all self-test routines finish, the results
of the self tests are returned.
The DISPlay? query returns all the settings set using the display commands.
DISPLAY
None
DISPlay?
None
Responses
Examples
Returns the settings as a sequence of commands, suitable for sending as set
commands later to restore a setup. See Examples.
DISPLAY?
might return :DISPLAY:BRIGHTNESS 0.7;CLOCK 0;DIMMER 1;ENABLE
1;MENU:NAME SETUP;STATE 1;:DISPLAY:WINDOW:TEXT:DATA " "
2Ć54
DG2020A Programmer Manual
DISPlay:BRIGhtness (?)
Command Descriptions
The DISPlay:BRIGhtness command adjusts the brightness of the screen; the
DISPlay:BRIGhtness? query returns the current brightness setting.
Group
Related Commands
Syntax
Arguments
Examples
DISPlay:CLOCk (?)
DISPLAY
DISPlay?
DISPlay:BRIGhtness <Value>
DISPlay:BRIGhtness?
<Value>::=<NRf>
where <NRf> is a real number ranging from 0 to 1.
:DISPLAY:BRIGHTNESS 0.7
sets screen brightness to 70% of maximum intensity.
The DISPlay:CLOCk command sets whether or not the data and time are
displayed.
The DISPlay:CLOCk? query returns whether or not the data and time are
displayed.
Group
Related Commands
Syntax
Arguments
DG2020A Programmer Manual
DISPLAY
DISPlay?
DISPlay:CLOCk {ON | OFF|1|0}
DISPlay:CLOCk?
ON or 1
sets the data generator to display the date and time.
OFF or 0
sets the data generator to not display the date and time.
2Ć55
Command Descriptions
Responses
Examples
DISPlay:DIMmer (?)
Group
Related Commands
Syntax
1 Date and time is currently displayed.
0 Date and time is currently not displayed.
:DISPLAY:CLOCK ON
sets the data generator to display the date and time.
The DISPlay:DIMmer command sets whether or not the screen dimmer function
operates. The DISPlay:DIMmer? query returns the on/off state of the screen
dimmer function. When the dimmer function is on, if no front panel controls are
used for about 10 minutes, the screen brightness is lowered automatically.
DISPLAY
DISPlay?
DISPlay:DIMmer {ON | OFF|1|0}
DISPlay:DIMmer?
Arguments
Responses
Examples
ON or 1
enables the dimmer function.
OFF or 0
clears the dimmer function.
[:DISPLAY:DIMMER] {1 | 0}
:DISPLAY:DIMMER ON
turns the dimmer function on.
2Ć56
DG2020A Programmer Manual
DISPlay:ENABle (?)
Command Descriptions
The DISPlay:ENABle command turns the display on or off. When security is
turned on, once the display is set to off, it cannot be turned on again. The
DISPlay:ENABle? query returns the on/off state of the display.
Group
Related Commands
Syntax
Arguments
Responses
Examples
DISPLAY
DISPlay?, DISPlay:MENU:STATe
DISPlay:ENABle {ON | OFF|1|0}
DISPlay:ENABle?
ON or 1
turns the display on.
OFF or 0
turns the display off.
[:DISPLAY:ENABLE] {1 | 0}
:DISPLAY:ENABLE OFF
turns the display off.
DISPlay:MENU?
Group
Related Commands
Syntax
Arguments
Responses
DG2020A Programmer Manual
The DISPlay:MENU? query returns the type and display state of the selected
menu.
DISPLAY
DISPlay?, DISPlay:MENU[:NAME], DISPlay:MENU:NAME?
DISPlay:MENU?
None
[:DISPLAY:MENU:NAME] {SETUP | EDIT | APPLICATION | UTILĆ
ITY};[STATE] {1 | 0}
2Ć57
Command Descriptions
Examples
DISPlay:MENU[:NAME]
Group
Related Commands
Syntax
Arguments
:DISPlay:MENU?
might return :DISPLAY:MENU:NAME SETUP;STATE 1
The DISPlay:MENU[:NAME] command selects the menu to be displayed on the
screen.
DISPLAY
DISPlay?, DISPlay:MENU?, DISPlay:MENU:NAME?
DISPlay:MENU[:NAME] {SETUp | EDIT | APPLication | UTILity}
SETUp displays the setup menu
EDIT displays the edit menu
APPLication displays the application menu
UTILity displays the utility menu
Examples
:DISPLAY:MENU:NAME UTILITY
selects the UTILITY menu.
2Ć58
DG2020A Programmer Manual
DISPlay:MENU:NAME?
Command Descriptions
The DISPlay:MENU:NAME? query returns the type of the selected menu.
Group
Related Commands
Syntax
Arguments
Responses
Examples
DISPLAY
DISPlay?, DISPlay:MENU?, DISPlay:MENU:[:NAME]
DISPlay:MENU:NAME?
None
[:DISPLAY:MENU:NAME] {SETUP | EDIT | APPLICATION | UTILITY}
DISPlay:MENU:NAME?
might return :DISPLAY:MENU:NAME EDIT
DISPlay:MENU:STATe (?)
The DISPlay:MENU:STATe command sets whether or not menus are displayed on
the screen. The DISPlay:MENU:STATE? query returns whether or not menus are
displayed on the screen. This command is equivalent to the DISPlay:ENABle
command.
Group
Related Commands
Syntax
Arguments
Responses
Examples
DG2020A Programmer Manual
DISPLAY
DISPlay?, DISPlay:ENABle, DISPlay:MENU?, DISPlay:MENU:[:NAME]
DISPlay:MENU:STATe {ON | OFF | 1 | 0}
DISPlay:MENU:STATe?
ON or 1 Menus are displayed.
OFF or 0 Menus are not displayed.
[:DISPLAY:MENU:STATE] {1 | 0}
DISPLAY:MENU:STATE ON
sets the instrument to display menus on the screen.
2Ć59
Command Descriptions
DISPlay[:WINDow]:TEXT:CLEar
The DISPlay[:WINDow]:TEXT:CLEar command clears the message display area
on the screen.
Group
Related Commands
Syntax
Arguments
Examples
DISPLAY
DISPlay?, DISPlay[:WINDow]:TEXT[:DATA]
DISPlay[:WINDow]:TEXT:CLEar
None
:DISPLAY:WINDOW:TEXT:CLEAR
clears the message display area.
2Ć60
DG2020A Programmer Manual
DISPlay[:WINDow]:TEXT[:DATA] (?)
The DISPlay[:WINDow]:TEXT[:DATA] command sends a message to be
displayed in the screen message display area. The sent message is displayed
immediately. The DISPlay[:WINDow]:TEXT[:DATA]? query returns the contents
of the input screen message.
NOTE. The contents of the message display area scrolls automatically. To fully
update the display contents, first clear the message display area using the
DISPlay[:WINDow]:TEXT:CLEar command.
Command Descriptions
Related Commands
*ESE (?)
Group
Syntax
Arguments
Responses
Examples
DISPLAY
DISPlay?, DISPlay[:WINDow]:TEXT:CLEar
DISPlay[:WINDow]:TEXT[:DATA] <Message>
DISPlay[:WINDow]:TEXT[:DATA]?
<Message>::=<string>
where <string> is a message character string.
[:DISPLAY:WINDOW:TEXT:DATA] <Message>
:DISPLAY:WINDOW:TEXT:DATA "ABCD"
sends the text ”ABCD” to be displayed in the message display area.
The *ESE common command sets the bits of the ESER (Event Status Enable
Register) used in the status and events reporting system of the data generator.
The *ESE? query returns the contents of the ESER. Refer to Section 3 Status and
Events for more information about the ESER.
Group
DG2020A Programmer Manual
If the power on status flag is TRUE, the power-on default for the ESER is to
reset all bits to zero. If this flag is set to FALSE, the ESER bits do not change
value during the power-on cycle.
STATUS & EVENT
2Ć61
Command Descriptions
*ESR?
Related Commands
Syntax
Arguments
Examples
*CLS, DESE, *ESR?, EVENT?, EVMsg?, EVQty?, *SRE, *STB?
*ESE <Bit Value>
*ESE?
<Bit Value>::=<NR1>
where <NR1> is a decimal integer that ranges from 0 to 255. The ESER bits will
be set to the binary equivalent of the decimal integer sent.
*ESE 177
sets the ESER to 177 (binary 10110001), which sets the PON, CME, EXE and
OPC bits.
*ESE?
might return 176,which indicates that the ESER contains the binary number
11010000.
The *ESR? common query returns the contents of SESR (Standard Event Status
Register) used in the status and events reporting system. Refer to Section 3
Status and Events for more information about *ESR? or SESR.
Group
Related Commands
Syntax
Arguments
Examples
STATUS & EVENT
*CLS, DESE, *ESE?, EVENT?, EVMsg?, EVQty?, *SRE, *STB?
*ESR?
None
*ESR?
might return 181, which indicates that the SESR contains the binary number
10110101.
2Ć62
DG2020A Programmer Manual
EVENT?
Command Descriptions
The EVENT? query dequeues the event code of the event that has been in the
Event Queue the longest out of all available events. Use the *ESR? query to
make the events available for dequeuing using EVENT?. Refer to Section 3 Status
and Events.
Related Commands
EVMsg?
Group
Syntax
Arguments
Examples
STATUS & EVENT
*CLS, DESE, *ESE, *ESR?, EVMsg?, EVQty?, *SRE, *STB?
EVENT?
None
EVENT?
might return :EVENT 113
The EVMsg? query dequeues the event code and event message of the event that
has been in the Event Queue the longest out of all available events. Use the
*ESR? query to make the events available for dequeuing using EVMsg? For more
details, refer to Section 3 Status and Events.
Group
Related Commands
Syntax
Arguments
Examples
DG2020A Programmer Manual
STATUS & EVENT
*CLS, DESE, *ESE, *ESR?, EVENT?, EVQty?, *SRE, *STB?
EVMsg?
None
:EVMSG?
might return :EVMSG 420,"Query UNTERMINATED".
2Ć63
Command Descriptions
EVQty?
The EVQty? query returns the number of events currently in the Event Queue. If
no event is being queued, 0 is returned.
Related Commands
FACTory
Group
Syntax
Arguments
Examples
Group
STATUS & EVENT
*CLS, DESE, *ESE, *ESR, EVMsg?, EVENT?, *SRE, *STB?
EVQty?
None
:EVQty?
might return :EVQTY 5.
The FACTory command resets the data generator to its factory default settings
and purges all stored settings. (See Appendix D, page D–1, for a list of the
factory settings.)
SYSTEM
2Ć64
Related Commands
Syntax
Arguments
Examples
*RST, SECUre
FACTory
None
:FACTORY
resets the data generator to its factory default settings.
DG2020A Programmer Manual
HCOPy?
Command Descriptions
The HCOPy? query returns the set image data format and output port for hardcopy
output.
Group
Related Commands
Syntax
Arguments
Responses
HARDCOPY
HCOPy:FORMat, HCOPy:PORT
HCOPy?
None
[:HCOPY:FORMAT] {BMP | EPSON | EPSMONO | THINKJET | TIFF};[:PORT]
{DISK | GPIB | RS232C}
where
BMP
the Windows monochrome file format.
EPSOn
the format used by 9-pin and 24-pin dot matrix printers in ESC/P graphics mode.
EPSMono
the encapsulated Postscript format monochrome image file format.
Examples
DG2020A Programmer Manual
THINkjet
the format used by HP inkjet printers.
TIFF
the TIFF format.
HCOPY?
might return :HCOPY:FORMAT TIFF ; PORT DISK
In this case the instrument outputs hardcopy data to file on the floppy disk in the
TIFF format.
2Ć65
Command Descriptions
HCOPy:ABORt
The HCOPy:ABORt command aborts hardcopy output.
Related Commands
Arguments
Examples
HCOPy:DATA?
Group
Syntax
Group
HARDCOPY
HCOPy:STARt
HCOPy:ABORt
None
:HCOPY:ABORT
aborts hardcopy output.
The HCOPy:DATA? query outputs the hard copy data to the output queue.
However, note that this command has no effect on (and is not affected by) the
hard copy output port setting.
HARDCOPY
2Ć66
Related Commands
Syntax
Arguments
Responses
Examples
HCOPy:PORT
HCOPy:DATA?
None
[:HCOPY:DATA] <Image>
where
<Image>::=<block> the hardcopy image data block
:HCOPY:DATA?
outputs hard copy data to the output queue.
DG2020A Programmer Manual
HCOPy:FORMat (?)
Command Descriptions
The HCOPy:FORMat command sets the hard copy output format.
The HCOPy:FORMat? query returns the currently specified hard copy output
format.
Group
Related Commands
Syntax
Arguments
HARDCOPY
HCOPy?
HCOPy:FORMAT {BMP | EPSOn | EPSMono | THINkjet | TIFF}
HCOPy:FORMAT?
BMP
the Windows monochrome file format.
EPSOn
the format used by 9-pin and 24-pin dot matrix printers in ESC/P graphics mode.
EPSMono
the encapsulated Postscript format monochrome image file format.
THINkjet
the format used by HP inkjet printers.
TIFF
the TIFF format.
Responses
Examples
DG2020A Programmer Manual
[:HCOPY:FORMAT] {BMP | EPSON | EPSMONO | THINKJET | TIFF}
:HCOPY:FORMAT TIFF
sets the data generator to output hard copy in the TIFF format.
2Ć67
Command Descriptions
HCOPy:PORT (?)
The HCOPy:PORT command sets the hard copy output port.
The HCOPy:PORT? query returns the currently specified hard copy output port.
Group
Related Commands
Syntax
Arguments
Responses
Examples
HARDCOPY
HCOPy?
HCOPy:PORT {DISK | GPIB | RS232c}
HCOPy:PORT?
DISK
outputs to a file on the floppy disk.
GPIB
outputs to the GPIB port.
RS232c
outputs to the RS-232C port.
[HCOPy:PORT] {DISK | GPIB | RS232c}
:HCOPY:PORT DISK
sets the hard copy output to be to a file on the floppy disk.
2Ć68
DG2020A Programmer Manual
HCOPy:STARt
Command Descriptions
The HCOPy:STARt command starts hardcopy output.
Related Commands
HEADer (?)
Group
Syntax
Arguments
Examples
Group
HARDCOPY
HCOPy:ABORt
HCOPy:STARt
None
:HCOPY:START
starts hardcopy output.
The HEADer command enables or disables the command header responses to all
queries except IEEE Std 488.2 common commands. The HEADer? query returns
the status indicating whether the command header responses are enabled or not.
SYSTEM
Related Commands
Syntax
Arguments
Responses
DG2020A Programmer Manual
VERBose
HEADer {ON | OFF | <NR1>}
HEADer?
ON or nonzero value
enables the command header responses.
OFF or zero value
disables the command header responses.
1 command header responses are currently enabled.
0 command header responses are currently disabled.
2Ć69
Command Descriptions
ID?
Examples
Group
Related Commands
Syntax
Arguments
:HEADER OFF
disables the command header responses.
:HEADER?
might return 1 which indicates command headers are currently enabled for
return in query responses.
The ID? query returns the ID information of the data generator.
SYSTEM
*IDN?
ID?
None
Responses
Examples
ID <Manufacturer>/<Model>, <Firmware Level>
where
<Manufacturer>::=SONY_TEK,
<Model>::=DG2020A
<Firmware Level>::=CF:<Code and Format Version>, and
FV:<Firmware Version>.
:ID?
returns SONY_TEK/DG2020A,CF:91.1CN,FV:1.00
2Ć70
DG2020A Programmer Manual
*IDN?
Command Descriptions
The *IDN? common query returns the ID information of the data generator.
Group
Related Commands
Syntax
Arguments
Responses
Examples
SYSTEM
ID?
*IDN?
None
<Manufacturer>, <Model>, <Serial Number>, <Firmware Level>
where
<Manufacturer>::=SONY/TEK,
<Model>::=DG2020A,
<Serial Number>::=0,
<Firmware Level>::=CF:<Code and Format Version>,
<sp>FV:<Firmware Version>, and
<sp>::= Space.
*IDN?
might return SONY/TEK,DG2020A,0,CF:91.1CN FV:1.00
LOCk (?)
DG2020A Programmer Manual
The LOCk command enables or disables the knob and all front panel buttons
except the ON/STBY button.
The LOCk? query returns a status indicating whether the knob and the buttons are
locked or not.
These data generators do not switch between remote control and local control
modes, but rather allow simultaneous setting from an external controller and
from the front panel. Use this command to lock the functions of the front panel
buttons and knobs to disable front panel operations during operation from an
external controller or during external controller software execution.
2Ć71
Command Descriptions
NOTE. When the front panel control operations are locked out by the LOCk
command, the instrument displays the character string ”FP: LOCKED” at the
upper right of the screen.
Group
Related Commands
Syntax
Arguments
Examples
SYSTEM
UNLock
LOCk {ALL | NONe}
LOCk?
ALL
disables the front panel buttons and the knob except the ON/STBY button.
NONe
enables the front panel buttons and the knob.
:LOCk ALL
disables the front panel buttons and the knob.
2Ć72
DG2020A Programmer Manual
MMEMory:CATalog[:ALL]?
The MMEMory:CATalog[:ALL]? query returns a list of all files and directories in
the current directory on the floppy disk.
Command Descriptions
Group
Related Commands
Syntax
Arguments
Responses
MEMORY
MMEMory:CATalog:ORDer
MMEMory:CATalog[:ALL]?
None
[:MMEMORY:CATALOG:ALL] <File Entry>[,<File Entry>]...
where
<File Entry>::=<File Name>,<File Size>,<Time Stamp>,
<File Name>::=<string>,
<File Size>::=<NR1>, and
<Time Stamp>::=<string>.
NOTE. A file size of 0 is returned for subdirectories.
MMEMory:CATalog:ORDer (?)
The MMEMory:CATalog:ORDer command sets the display order for file information in disk directory listings. The MMEMory:CATalog:ORDer? query returns the
display order for file information in disk directory listings.
Group
Related Commands
Syntax
Arguments
DG2020A Programmer Manual
MEMORY
MMEMory:CATalog[:ALL]?
MMEMory:CATalog:ORDer {NAME1 | NAME2 | TIME1 | TIME2}
MMEMory:CATalog:ORDer?
NAME1
orders the display according to the ASCII collating sequence of the file names.
2Ć73
Command Descriptions
NAME2
orders the display in the reverse order of the NAME1 order.
TIME1
orders the display with older (Date and Time) files first.
TIME2
orders the display with more recent (Date and Time) files first.
Responses
Examples
[:MMEMORY:CATALOG:ORDER] {NAME1 | NAME2 | TIME1 | TIME2}
:MMEMORY:CATALOG:ORDER NAME1
sets the order of file information recorded in disk directory listings to alphabetical order by file name.
MMEMory:CDIRectory (?)
The MMEMory:CDIRectory command changes the current working directory. The
MMEMory:CDIRectory? query returns the current working directory path.
Group
Related Commands
Syntax
MEMORY
MMEMory:MDIRectory
MMEMory:CDIRectory <Directory Path>
MMEMory:CDIRectory?
2Ć74
Arguments
Responses
Examples
<Directory Path>::=<string>
where <string> is the name of the new current working directory.
[:MMEMORY:CDIRECTORY] <Directory Path>
:MMEMORY:CDIRECTORY "\DG\WORK3"
changes the current working directory to \DG\WORK3.
DG2020A Programmer Manual
MMEMory:COPY
Command Descriptions
The MMEMory:COPY command copies a file on the disk and creates a new file. If
the copy destination file already exists, an error is issued and the existing file is
not overwritten.
Group
Related Commands
Syntax
Arguments
Examples
MMEMory:DELete:ALL
MEMORY
MMEMory:DELete:ALL, MMEMory:DELete[:NAME]
MMEMory:COPY <From-path>,<To-path>
<From-path>::=<string>
where <string> is the path name of the source file.
<To-path>::=<string>
where <string> is the path name of the destination file.
:MMEMORY:COPY "MYDATA.PDA","MYWORK.PDA"
copies the file MYDATA.PDA in the current directory and creates a new file,
MYWORK.PDA, in the current directory.
The MMEMory:DELete:ALL command deletes all files and subdirectories in the
current directory. However, non–empty subdirectories are not deleted.
Group
Related Commands
Syntax
Arguments
Examples
DG2020A Programmer Manual
MEMORY
MMEMory:DELete[:NAME]
MMEMory:DELete:ALL
None
:MMEMORY:DELETE:ALL
deletes all files and empty subdirectories in the current directory.
2Ć75
Command Descriptions
MMEMory:DELete[:NAME]
The MMEMory:DELete[:NAME] command deletes the file or subdirectory with the
specified path name. However, non–empty subdirectories are not deleted.
Group
Related Commands
Syntax
Arguments
Examples
MMEMory:FREE?
Group
MEMORY
MMEMory:DELete:ALL
MMEMory:DELete[:NAME] <Path Name>
<Path Name>::=<string>
where <string> is the path name of the file or subdirectory to be deleted.
:MMEMORY:DELETE "NOMORE.PDA"
deletes the file NOMORE.PDA in the current directory.
The MMEMory:FREE? query returns used size and unused size of the mass
memory. This query is equivalent to the MMEMory:FREE:ALL? query.
MEMORY
2Ć76
Related Commands
Syntax
Arguments
Responses
Examples
MMEMory:FREE?
None
:MMEMORY:FREE <Used Size>, <Unused Size>
where
<Used Size>::=<NR1> and
<Unused Size>::=<NR1>.
:MMEMORY:FREE?
might return :MMEMORY:FREE 104584,1352704
DG2020A Programmer Manual
MMEMory:INITialize
Command Descriptions
The MMEMory:INITialize command formats a floppy disk. The format type is
specified by the argument.
Group
Related Commands
Syntax
Arguments
MEMORY
MMEMory:INITialize {DD1 | DD2 | HD1 | HD2 | HD3}
You can select from the following formats:
Argument Description
DD1 2DD, 720 KB, 80 tracks, 9 sectors/track, 512 bytes/sector.
Format for IBM PC 2DD and T oshiba J3100 2DD.
DD2 2DD, 640 KB, 80 tracks, 8 sectors/track, 512 bytes/sector .
Format for NEC PC–9800 2DD.
HD1 2HD, 1.232 MB, 77 tracks, 15 sectors/track, 1,024 bytes/sector .
Format for NEC PC–9800 2HD.
HD2 2HD, 1.200 MB, 80 tracks, 15 sectors/track, 512 bytes/sector .
Format for Toshiba J3100 2HD.
HD3 2HD, 1.440 MB, 80 tracks, 18 sectors/track, 512 bytes/sector .
Format for IBM PC 2HD.
Examples
MMEMory:LOAD
Group
Related Commands
DG2020A Programmer Manual
:MMEMORY:INITIALIZE HD3
formats a floppy disk for IBM PC 2HD.
The MMEMory:LOAD command loads in pattern data and block, group, sequence,
and setup information in DG2020A format into the instrument’s internal memory
from a disk file.
MEMORY
MMEMory:SAVE
2Ć77
Command Descriptions
Syntax
Arguments
Examples
MMEMory:LOCK (?)
Group
Related Commands
MMEMory:LOAD <File Name>
<File Name>::=<string>
where <string> is the name of the file to be loaded.
:MMEMORY:LOAD "MYDATA.PDA"
loads all information from the file MYDATA.PDA in the current directory into
the instrument’s internal memory.
The MMEMory:LOCK command sets and clears file locks. When a file is locked, it
cannot be deleted or written to. The MMEMory:LOCK? query returns whether or
not the file is locked.
MEMORY
Syntax
Arguments
Responses
Examples
MMEMory:LOCK <Path Name>,{ON | OFF|1|0}
MMEMory:LOCK? <Path Name>
<Path Name>::=<string>
where <string> is the name of the file to be locked or unlocked.
ON or 1
locks the file.
OFF or 0
unlocks the file.
0 the file is not locked.
1 the file is locked.
:MMEMORY:LOCK "COUNT1.PDA",ON
locks the file COUNT1.PDA in the current directory.
2Ć78
DG2020A Programmer Manual
MMEMory:MDIRectory
Command Descriptions
The MMEMory:MDIRectory command creates a new subdirectory. The command
is invalid if a directory with the specified name already exists.
Group
Related Commands
Syntax
Arguments
Examples
MMEMory:RDIRectory
Group
MEMORY
MMEMory:CDIRectory
MMEMory:MDIRectory <Directory Path>
<Directory Path>::=<string>
where <string> is the name or path of the new directory.
:MMEMORY:MDIRECTORY "WORK4"
creates the new directory WORK4 in the current working directory.
The MMEMory:RDIRectory command removes a subdirectory. If a file exist in
the subderectory, this command will not be performed.
MEMORY
Related Commands
Syntax
Arguments
Examples
DG2020A Programmer Manual
MMEMory:CDIRectory, MMEMory:MDIRectory
MMEMory:RDIRectory <Directory Path>
<Directory Path>::=<string>
where <string> is the name of the directory to be removed.
:MMEMORY:RDIRECTORY WORK4"
removes the directory WORK4 in the current working directory.
2Ć79
Command Descriptions
MMEMory:REName
The MMEMory:REName command changes the name of the specified file. A file
that is locked using the MMEMory:LOCk command cannot be renamed.
Related Commands
Syntax
Arguments
Examples
MMEMory:SAVE
Group
MEMORY
MMEMory:COPY
MMEMory:REName <FromĆfilename>, <ToĆfilename>
<FromĆfilename>::=<string>
where <string> is the name of the file to be changed.
<ToĆfilename>::=<string>
where <string> is the name of the file after it is changed.
:MMEMORY:RENAME "COUNT1.PDA","COUNT2.PDA"
changes the name of the file COUNT1.PDA in the current working directory to
COUNT2.PDA.
The MMEMory:SAVE command saves the pattern data and block, group, sequence,
and setup information stored in the internal memory into a disk file in DG2020A
format.
2Ć80
Group
Related Commands
Syntax
Arguments
Examples
MEMORY
MMEMory:LOAD
MMEMory:SAVE <Path Name>
<Path Name>::=<string>
where <string> is the path name of the file.
:MMEMORY:SAVE "NEWDATA.PDA"
saves all the information in internal memory to the file NEWDATA.PDA in the
current working directory.
DG2020A Programmer Manual
MODE?
Command Descriptions
The MODE? query returns all the setting states related to the pattern generation
mode.
Related Commands
Syntax
Arguments
Responses
Examples
MODE:STATe (?)
Group
MODE
MODE:STATe, MODE:UPDate
MODE?
None
[:MODE:STATE] {REPEAT | SINGLE | STEP | ENHANCED};[UPDATE] {AUTO
| MANUAL}
MODE?
might return :MODE:STATE REPEAT;UPDATE AUTO
Here, the run mode is set to repeat and the output pattern update method is set to
automatic. (See the items on the MODE:STATe and MODE:UPDate commands.)
Group
Related Commands
Syntax
Arguments
DG2020A Programmer Manual
The MODE:STATe command sets the run mode for pattern generation. The
MODE:STATe? query returns the pattern generation run mode setting.
MODE
MODE?
MODE:STATe {REPeat | SINGle | STEp | ENHanced}
MODE:STATe?
REPeat Pattern data output is repeated.
SINGle Pattern data output is performed exactly once.
STEp Pattern data is output not according to the internal clock, but
rather by a clock signal created by the STEP key.
ENHanced Pattern data is output according to the defined sequence.
2Ć81
Command Descriptions
Responses
Examples
MODE:UPDate (?)
Group
Related Commands
Syntax
[:MODE:STATE] {REPEAT | SINGLE | STEP | ENHANCED}
:MODE:STATE SINGLE
sets the run mode to single.
The MODE:UPDate command sets the output pattern update method used when
data related to pattern generation is changed. The MODE:UPDate? query returns
the output pattern update method used when data related to pattern generation is
changed.
MODE
MODE?
MODE:UPDate {AUTO | MANual}
MODE:UPDate?
Arguments
Responses
Examples
AUTO Pattern output reflects changes each time the data is changed in
any way.
MANual Pattern output is not changed when data is changed until an
update forcing command is received.
[:MODE:UPDATE] {AUTO | MANUAL}
:MODE:UPDATE AUTO
sets the output pattern update method to AUTO.
2Ć82
DG2020A Programmer Manual
Loading...