Tektronix 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.
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
Contacting Tektronix
Tektronix, Inc.
14200 SW Karl Braun Drive
P.O. Box 500
Beaverton, OR 97077
USA
For product information, sales, service, and technical support:
In North America, call 1-800-833-9200.
Worldwide, visit www.tektronix.com to find contacts in your area.
WARRANTY2
Tektronix warrants that this product will be free from defects in materials and workmanship for a period of one (1)
year from the date of shipment. If any such product proves defective during this warranty period, Tektronix, at its
option, either will repair the defective product without charge for parts and labor, or will provide a replacement in
exchange for the defective product. Parts, modules and replacement products used by Tektronix for warranty work may
be new or reconditioned to like new performance. All replaced parts, modules and products become the property of
Tektronix.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of
the warranty period and make suitable arrangements for the performance of service. Customer shall be responsible for
packaging and shipping the defective product to the service center designated by Tektronix, with shipping charges
prepaid. Tektronix shall pay for the return of the product to Customer if the shipment is to a location within the country
in which the Tektronix service center is located. Customer shall be responsible for paying all shipping charges, duties,
taxes, and any other charges for products returned to any other locations.
This warranty shall not apply to any defect, failure or damage caused by improper use or improper or inadequate
maintenance and care. Tektronix shall not be obligated to furnish service under this warranty a) to repair damage
resulting from attempts by personnel other than Tektronix representatives to install, repair or service the product; b) to
repair damage resulting from improper use or connection to incompatible equipment; c) to repair any damage or
malfunction caused by the use of non-Tektronix supplies; or d) to service a product that has been modified or integrated
with other products when the effect of such modification or integration increases the time or difficulty of servicing the
product.
THIS WARRANTY IS GIVEN BY TEKTRONIX WITH RESPECT TO THE PRODUCT IN LIEU OF ANY
OTHER WARRANTIES, EXPRESS OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
TEKTRONIXÅf RESPONSIBILITY TO REPAIR OR REPLACE DEFECTIVE PRODUCTS IS THE SOLE
AND EXCLUSIVE REMEDY PROVIDED TO THE CUSTOMER FOR BREACH OF THIS WARRANTY.
TEKTRONIX AND ITS VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT, SPECIAL,
INCIDENTAL, OR CONSEQUENTIAL DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX OR
THE VENDOR HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.
viDTG5000 Series Data Timing Generators Programmer Manual
Preface
This is the programmer manual for the DTG5000 Series Data Timing Generators.
This manual provides information necessary for operating the instrument over the
General Purpose Interface Bus (GPIB) interface.
This manual provides the following information:
The Getting Started section describes how to connect and set up the data timing
generator for remote operation.
The Syntax and Commands section defines the command syntax and
processing conventions and describes each command in the data timing
generator command set.
The Status and Events section explains the status information and event
messages reported by the data timing generator.
The Programming Examples section describes how to use the Sample Program
of the data timing generator.
The Appendices section contains various tables of reference information.
Related Manuals
The Glossary and Index section contains a glossary of common terms and an
index to this manual.
Other documentation for the data timing generator includes:
The DTG5000 Series User Manual 2 (071-1609-xx) describes the operation of
the instrument.
DTG5000 Series Data Timing Generators Programmer Manualvii
Preface
viiiDTG5000 Series Data Timing Generators Programmer Manual
Getting Started
Getting Started
Manual Overview
The DTG5000 Series Data Timing Generator has GPIB interface capability. You
can write computer programs that remotely set the front panel controls.
To help you get started with programming the data timing generator, this section
includes the following subsections:
Manual Overview - summarizes the type of programming information
contained in each major section in this manual.
Setting Up Remote Communications Using GPIB - describes how to connect
the data timing generator to a controller through the GPIB interface.
A summary of the information provided in each major section of this manual
follows:
Syntax and Commands
The Command Syntax subsection, which begins on page 2-1, describes the
structure and content of the messages your program sends to the data timing
generator. You can use the Standard Commands for Programmable Instruments
(SCPI) and IEEE 488.2 Common Commands. Figure 1-1 is an example of the
syntax and command parts diagrams used in the Command Syntax subsection.
Command parts
Header
FUNCtion:USER
Mnemonics
Syntax diagram
FUNCtion
Figure 1-1: Common message elements
:
USER
Comma
“FILE1”,“FLOPpy”
Space
Arguments
<file_name><space><msus>
,
DTG5000 Series Data Timing Generators Programmer Manual1-1
Getting Started
The Command Syntax subsection also describes the result of each command, and
provides examples of how you might use it. The Command Groups subsection,
which begins on page 2-13, provides a command list by functional area. The
Command Descriptions subsection, which begins on page 2-21, arranges
commands alphabetically.
Status and Events
Reporting
The program may request information from the data timing generator. The data
timing generator provides information in the form of status and error messages.
Figure 1-2 illustrates the basic operation of this system.
The Status and Events Reporting subsection, which begins on page 3-1, describes
how to use the status reporting functions that conform to SCPI and IEEE-488.2 in
your programs.
Your program requests
status and event reports.
Controller
DTGs ends status and event reports.
DTG (rear panel )
GPIB cable
Figure 1-2: Basic operation of status and events reporting
Programming Examples
The Programming Examples section, which begins on page 4-1, provides a sample
data timing generator program.
1-2DTG5000 Series Data Timing Generators Programmer Manual
Setting Up Remote Communications Using GPIB
For remote operations, the instrument must be connected to the controller.
The data timing generator has a 24-pin GPIB connector on its rear panel, as shown
in Figure 1-3. This connector has a D-type shell and conforms to IEEE Std
488.2-1992.
Attach an IEEE Std 488.2-1992 GPIB cable (Tektronix part number 012-0991-xx)
to the GPIB connector.
Getting Started
GPIB connector
Figure 1-3: GPIB connector location
DTG5000 Series Data Timing Generators Programmer Manual1-3
Getting Started
GPIB Requirements
Follow these rules when you use your data timing generator with a GPIB network:
Assign a unique device address to each device on the bus. Two devices can not
share the same device address.
Do not connect more than 15 devices to one bus.
Connect one device for every 2 meters (6 feet) of cable used.
Do not use more than 20 meters (65 feet) of cable to connect devices to a bus.
While using the network, turn on at least two-thirds of the devices on the
network.
Connect the devices on the network in a star or linear configuration, as shown
in Figure 1-4. Do not use loop or parallel configurations.
GPIBDevice
GPIBDeviceGPIBDevice
GPIBDevice
GPIBDevice
GPIBDevice
Figure 1-4: Typical GPIB network configurations
GPIBDevice
1-4DTG5000 Series Data Timing Generators Programmer Manual
Syntax and Commands
Command Syntax
This section contains general information about command structure and syntax
usage. You should familiarize yourself with this material before using the data
timing generator command descriptions.
This manual describes commands and queries using Backus–Naur Form (BNF)
notation. Table 2-1 defines standard BNF symbols.
Table 2-1: BNF symbols and meanings
SymbolMeaning
<>Defined element
::=Is defined as
|Exclusive OR
{}Group; one element is required
[]Optional; can be omitted
. . .Previous element(s) may be repeated
()Comment
DTG5000 Series Data Timing Generators Programmer Manual2-1
Command Syntax
SCPI Commands and Queries
The data timing generator uses a command language based on the SCPI standard.
The SCPI (Standard Commands for Programmable Instruments) standard was
created by a consortium to provide guidelines for remote programming of
instruments. These guidelines provide a consistent programming environment for
instrument control and data transfer. This environment uses defined programming
messages, instrument responses and data formats that operate across all SCPI
instruments, regardless of manufacturer.
The SCPI language is based on a hierarchical or tree structure that represents a
subsystem (see Figure 2-1). The top level of the tree is the root node; it is followed
by one or more lower–level nodes.
OUTPut
CLOCk
OFFSet
STATeAMPLitude
Root node
Lower-level
nodes
Figure 2-1: Example of SCPI subsystem hierarchy tree
You can create commands and queries from these subsystem hierarchy trees.
Commands specify actions for the instrument to perform. Queries return
measurement data and information about parameter settings.
2-2DTG5000 Series Data Timing Generators Programmer Manual
Command Syntax
Creating Commands
Creating Queries
Query Responses
SCPI commands are created by stringing together the nodes of a subsystem
hierarchy and separating each node by a colon.
In Figure 2-1 on page 2-2, OUTPut is the root node and CLOCk, AMPLitude,
OFFSet, and STATe are lower–level nodes. To create an SCPI command, start
with the root node OUTPut and move down the tree structure adding nodes until
you reach the end of a branch. Most commands and some queries have parameters;
you must include a value for these parameters. The command descriptions, which
begin on page 2-21, list the valid values for all parameters.
For example, OUTPut:CLOCk:AMPLitude 2.0 is a valid SCPI command
created from the hierarchy tree in Figure 2-1 on page 2-2.
To create a query, start at the root node of a tree structure, move down to the end
of a branch, and add a question mark. OUTPut:CLOCk:AMPLitude? is an
example of a valid SCPI query using the hierarchy tree in Figure 2-1 on
page 2-2.
The query causes the data timing generator to return information about its status or
settings. When a query is sent to the data timing generator, only the values are
returned. When the returned value is a mnemonic, it is noted in abbreviated format,
as shown in Table 2-2.
Table 2-2: Query response examples
QueryResponse
SYSTem:VERSion?1999.0
DIAGnostic:SELect?ALL
A few queries also initiate an operation action before returning information. For
example, the *CAL? query runs a calibration.
DTG5000 Series Data Timing Generators Programmer Manual2-3
Command Syntax
Parameter Types
Parameters are indicated by angle brackets, such as <file_name>. There are several
different types of parameters, as listed in Table 2-3. The parameter type is listed
after the parameter. Some parameter types are defined specifically for the
DTG5000 series command set and some are defined by SCPI.
Table 2-3: Parameter types used in syntax descriptions
Parameter typeDescriptionExample
arbitrary blockA block of data bytes#512234xxxxx...
where 5 indicates that the following 5
digits (12234) specify the length of
the data in bytes;
xxxxx... indicates the data
or
#0xxxxx...<LF><&EOI>
booleanBoolean numbers or NRfON or ≠ 0
OFF or 0
discreteA list of specific valuesMIN, MAX
binaryBinary numbers#B0110
octalOctal numbers#Q75, #Q3
hexadecimal
NR1
NR2
NR3
NRf
Numeric numericFlexible decimal number that may be
string Alphanumeric characters (must be
numericIntegers0, 1, 15, -1
numericDecimal numbers1.2, 3.141516, -6.5
numericFloating point numbers3.1415E-9, -16.1E5
numericFlexible decimal number that may be
Hexadecimal numbers (0-9, A- F)#HAA, #H1
See NR1, NR2, NR3 examples in this
type NR1, NR2, or NR3
type NR1, NR2, NR3, or specific
value (MIN, MAX).
within quotation marks)
table
See NR1, NR2, NR3 discrete
examples in this table
“Testing 1, 2, 3”
About MIN, MAX
You can use MINimum, MAXimum keywords in addition to Numeric in the
commands with
“Numeric” parameter. You can set the minimum value or the
maximum value by the use of this keywords. You can query the minimum value or
the maximum value at that time.
2-4DTG5000 Series Data Timing Generators Programmer Manual
Command Syntax
Special Characters
Abbreviating Commands,
Queries, and Parameters
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.
You can abbreviate most SCPI commands, queries, and parameters to an accepted
short form. This manual shows these commands as a combination of upper and
lower case letters. The upper case letters indicate the accepted short form of a
command, as shown in Figure 2-2. The accepted short form and the long form are
equivalent and request the same action of the instrument.
Long form of a
command
Accepted short form
of a command
OUTP
ut:CLOCk:AMPLitude 2.0
Minimum information needed
for accepted short form
OUTP:CLOC:AMPL 2.0
Figure 2-2: Example of abbreviating a command
DTG5000 Series Data Timing Generators Programmer Manual2-5
Command Syntax
Chaining Commands and
Queries
You can chain several commands or queries together into a single message. To
create a chained message, first create a command or query, then add a semicolon
(;), and finally add more commands or queries and semicolons until you are done.
If the command following a semicolon is a root node, precede it with a colon (:).
Figure 2-3 illustrates a chained message consisting of several commands and
queries. The chained message should end in a command or query, not a semicolon.
Responses to any queries in your message are separated by semicolons.
Figure 2-3: Example of chaining commands and queries
If a command or query has the same root and lower–level nodes as the previous
command or query, you can omit these nodes. In Figure 2-4, the second command
has the same upper node (OUTP:DC) as the first command, so these nodes can be
omitted.
Figure 2-4: Example of omitting upper and lower–level nodes in a chained message
2-6DTG5000 Series Data Timing Generators Programmer Manual
Command Syntax
Unit and SI Prefix
If the decimal numeric argument refers to voltage, frequency, impedance, or time,
you can express it using SI units instead of using the scaled explicit point input
value format <NR3>. (SI units are units that conform to the System International
d’Unites standard.) For example, you can use the input format 200 mV or 1.0 MHz
instead of 200.0E-3 or 1.0E+6, respectively, to specify voltage or frequency.
You can omit the unit, but you must include the SI unit prefix. You can use either
upper or lowercase units.
V for voltage (V).
HZ for frequency (Hz).
OHM for impedance (ohm).
S for time (s).
DBM for power ratio
PCT for %
VPP for Peak-to-Peak Voltage (V p-p).
UIPP for Peak-to-Peak, Unit is UI (UI p-p).
UIRMS for RMS, Unit is UI (UIrms).
SPP for Peak-to-Peak, Unit is second (s p-p).
SRMS for RMS, Unit is second (srms).
V/NS for SLEW’s unit (V/ns).
In the case of angle, you can use RADian and DEGree. The default unit is RADian.
The SI prefixes, which must be included, are shown below. Note that either lower
or upper case prefixes can be used.
SI prefix *Corresponding power
EX10
PE10
T10
G10
MA10
K10
M10
18
15
12
9
6
3
-3
DTG5000 Series Data Timing Generators Programmer Manual2-7
Command Syntax
SI prefix *Corresponding power
U10
N10
P10
F10
A10
*Note that the prefix m/M indicates 10-3 when the decimal numeric argument
denotes voltage or time, but indicates 106 when it denotes frequency.
*Note that the prefix u/U is used instead of “µ”.
-6
-9
-12
-15
-18
Use mV for V, and MHz for Hz.
The SI prefixes need units.
correct:10MHz, 10E+6Hz, 10E+6
incorrect:10M
2-8DTG5000 Series Data Timing Generators Programmer Manual
Command Syntax
General Rules
Here are three general rules for using SCPI commands, queries, and parameters:
You can use single (‘ ’) or double (“ ”) quotation marks for quoted strings, but
you cannot use both types of quotation marks for the same string.
correct:“This string uses quotation marks correctly.”
correct:‘This string also uses quotation marks correctly.’
incorrect:“This string does not use quotation marks correctly.’
You can use upper case, lower case, or a mixture of both cases for all
commands, queries, and parameters.
:OUTPUT:DC:LEVEL 0,1.1V
is the same as
output:dc:level 0,1.1V
and
OUTPUT:dc:LEVEL 0,1.1V
NOTE. Literal strings (quoted) are case sensitive. For example: file names.
No embedded spaces are allowed between or within nodes.
correct:OUTPUT:DC:LEVEL 0,1.1V
incorrect:OUTPUT: DC: LEVEL 0,1.1V
DTG5000 Series Data Timing Generators Programmer Manual2-9
Command Syntax
IEEE 488.2 Common Commands
ANSI/IEEE Standard 488.2 defines the codes, formats, protocols, and usage of
common commands and queries used on the interface between the controller and
the instruments. The data timing generator complies with this standard.
The syntax for an IEEE 488.2 common command is an asterisk (*) followed by a
command and, optionally, a space and parameter value. The syntax for an
IEEE 488.2 common query is an asterisk (*) followed by a query and a question
mark. All of the common commands and queries are included in the Syntax and Commands section of this manual. The following are examples of common
commands:
*ESE 16
*CLS
The following are examples of common queries:
*ESR?
*IDN?
2-10DTG5000 Series Data Timing Generators Programmer Manual
Loading...
+ 168 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.