Tektronix AWG710,AWG710B Programmer Manual
Programmer Manual
AWG710 & AWG710B
4GS/s / 4.2GS/s Arbitrary Waveform Generator
071-1414-00
This document supports firmware version 4.00 and above.
www.tektronix.com
Copyright © Tektronix Ja pan, Ltd. All rights reserved.
Copyright © Tektronix, Inc. All rights reserved.
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, Inc., P.O. Box 500, Beaverton, OR 97077
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
WARRANTY
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.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of
the warranty period and make s uitable arrangements fo r the perform ance of service. Cu stomer shall be respo nsible for
packaging and shipping the defective product to the service center designated by Tektronix, with shipping charges
prepaid. T ektronix shall pay for the return of the product to Customer if the shipment is to a location within the country
in which the T e ktronix serv ice center is lo cated. Custo mer shall be respo nsible for payi ng all shippi ng char ges, 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; or c) 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 THIS PRODUCT IN LIEU OF ANY
OTHER WARRANTIES, EXPRESSED OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY
IMPLIED WARRANT IES OF MERCHANTABILITY OR FITNESS FOR A PART ICULAR PURPOSE.
TEKTRONIX’ 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.
Tabl e o f Content s
Getting Started
Syntax and Commands
Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . i
List of Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v
List of Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Related Manuals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Manual Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Setting Up Remote Communications Using GPIB . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Setting Up Remote Communications Using Ethernet . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
SCPI Commands and Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
IEEE 488.2 Common Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Constructed Mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Syntax Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Command Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
Functional Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
Command Quick Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
Command Summaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16
Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-25
ABORt (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-25
:ABSTouch (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-26
:AWGControl:CLOCk:SOURce (?) (only AWG710B). . . . . . . . . . . . . . . . . . . . . . . 2-28
:AWGControl:DOUTput[1][:STATe] (?) (except option02) . . . . . . . . . . . . . . . . . . . 2-29
:AWGControl:ENHanced:SEQuence[:JMODe] (?). . . . . . . . . . . . . . . . . . . . . . . . . . 2-30
:AWGControl:EVENt[:LOGic][:IMMediate] (No Query Form) . . . . . . . . . . . . . . . 2-30
:AWGControl:EVENt:SOFTware[:IMMediate] (No Query Form). . . . . . . . . . . . . . 2-31
:AWGControl:EVENt:TABLe[:IMMediate] (No Query Form) . . . . . . . . . . . . . . . . 2-32
:AWGControl:FG:FREQuency[:CW|:FIXed] (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32
:AWGControl:FG[1]:FUNCtion[:SHAPe] (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-33
:AWGControl:FG[1]:POLarity (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-34
:AWGControl:FG[1]:PULSe:DCYCle (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-35
:AWGControl:FG[:STATe] (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-36
:AWGControl:FG[1]:VOLTage[:LEVel][:IMMediate][:AMPLitude] (?) . . . . . . . . . 2-37
:AWGControl:FG[1]:VOLTage[:LEVel][:IMMediate]:OFFSet (?)
(except option02) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-38
:AWGControl:MIX[:STATe] (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-38
:AWGControl:RMODe (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-39
:AWGControl:RSTate? (Query Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-40
:AWGControl:RUN[:IMMediate] (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . 2-41
AWG710 & AWG710B Arbitrary Waveform Generator Programmer Manual i
Table of Contents
:AWGControl:SREStore (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42
:AWGControl:SSAVe (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42
:AWGControl:STOP[:IMMediate] (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . 2-43
:AWGControl:SYNChronous:ADDRess (?) (AWG 710B only) . . . . . . . . . . . . . . . . 2-44
:AWGControl:SYNChronous:CALibration (No Query Form) (AWG710B only) . . 2-44
:AWGControl:SYNChronous:CONNect (?) (AWG710B only) . . . . . . . . . . . . . . . . . 2-45
:AWGControl:SYNChronous:MASTer[:STATe] (?) (AWG710B only). . . . . . . . . . . 2-46
:AWGControl:SYNChronous:SLAVe[:STATe] (?) (AWG710B only) . . . . . . . . . . . . 2-47
*CAL? (Query Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-48
:CALibration[:ALL] (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-48
*CLS (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-50
:DIAGnostic:DATA? (Query Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-50
:DIAGnostic[:IMMediate] (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-51
:DIAGnostic:SELect (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52
:DISPlay:ENABle (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-53
:DISPlay:HILight:COLor (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-54
*ESE (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-54
*ESR? (Query Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-55
:HCOPy:DESTination (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-56
:HCOPy:DEVice:COLor (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-56
:HCOPy:DEVice:LANGuage (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-57
:HCOPy[:IMMediate] (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-58
:HCOPy:SDUMp[:IMMediate] (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-58
*IDN? (Query Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-59
:MMEMory:CATalog? (Query Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-60
:MMEMory:CDIRectory (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-61
:MMEMory:CLOSe (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-61
:MMEMory:COPY (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62
:MMEMory:DATA (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62
:MMEMory:DELete (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-63
:MMEMory:FEED (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-64
:MMEMory:INITialize (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-65
:MMEMory:MDIRectory (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-66
:MMEMory:MOVE (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-67
:MMEMory:MSIS (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-68
:MMEMory:NAME (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-68
:MMEMory:OPEN (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-69
*OPC (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-70
*OPT? (Query Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-70
:OUTPut[1]:FILTer[:LPASs]:FREQuency (?) (except option02). . . . . . . . . . . . . . . . 2-71
:OUTPut[1]:ISTate (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-72
:OUTPut[1][:STATe] (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-72
:OUTPut[1]:MARKer[:STATe] (?) (AWG710B only). . . . . . . . . . . . . . . . . . . . . . . . 2-73
*PSC (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-74
*RST (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-75
[:SOURce[1]]:FREQuency[:CW|FIXed] (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-75
[:SOURce[1]]:FUNCtion:USER (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-76
[:SOURce[1]]:MARKer[1|2]:VOLTage[:LEVel][:IMMediate]:HIGH (?) . . . . . . . . . 2-77
[:SOURce[1]]:MARKer[1|2]:VOLTage[:LEVel][:IMMediate]:LOW (?). . . . . . . . . . 2-78
[:SOURce[1]]:ROSCillator:SOURce (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-79
[:SOURce[1]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] (?) . . . . . . . . . . . . . . . 2-80
ii AWG710 & AWG710B Arbitrary Waveform Generator Programmer Manual
Table of Contents
[:SOURce[1]]:VOLTage[:LEVel][:IMMediate]:OFFSet (?) (except option02) . . . . 2-81
*SRE (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82
:STATus:OPERation:CONDition? (Query Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-82
:STATus:OPERation:ENABle (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-83
:STATus:OPERation[:EVENt]? (Query Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-84
:STATus:PRESet (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-84
:STATus:QUEStionable:CONDition? (Query Only). . . . . . . . . . . . . . . . . . . . . . . . . 2-84
:STATus:QUEStionable:ENABle (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-85
:STATus:QUEStionable[:EVENt]? (Query Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-86
*STB? (Query Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-86
:SYSTem:BEEPer[:IMMediate] (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . . 2-87
:SYSTem:COMMunicate:LAN:DHCP[:CLIent]:LEASe:TIME (?). . . . . . . . . . . . . 2-88
:SYSTem:COMMunicate:LAN:DHCP[:CLIent][:STATe] (?). . . . . . . . . . . . . . . . . . 2-88
:SYSTem:COMMunicate:LAN:FTP[:SERVer][:STATe] (?). . . . . . . . . . . . . . . . . . . 2-89
:SYSTem:COMMunicate:LAN:FTP[:SERVer]:VERSion (?). . . . . . . . . . . . . . . . . . 2-90
:SYSTem:COMMunicate:LAN:GATeway[1|2|3]:ADDRess (?) . . . . . . . . . . . . . . . . 2-90
:SYSTem:COMMunicate:LAN:NFS:TLIMit (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-91
:SYSTem:COMMunicate:LAN:PING? (Query Only). . . . . . . . . . . . . . . . . . . . . . . . 2-92
:SYSTem:COMMunicate:LAN:RDEVice[1|2|3]:ADDRess (?) . . . . . . . . . . . . . . . . 2-92
:SYSTem:COMMunicate:LAN:RDEVice[1|2|3]:FSYStem (?). . . . . . . . . . . . . . . . . 2-93
:SYSTem:C OMMunicate:LAN:RDEVice[1|2|3]:NAME (?). . . . . . . . . . . . . . . . . . . 2-94
:SYSTem:COMMunicate:LAN:RDEVice[1|2|3]:PROTocol (?) . . . . . . . . . . . . . . . . 2-94
:SYSTem:COMMunicate:LAN:RDEVice[1|2|3][:STATe] (?). . . . . . . . . . . . . . . . . . 2-95
:SYSTem:COMMunicate:LAN[:SELF]:ADDRess (?) . . . . . . . . . . . . . . . . . . . . . . . 2-96
:SYSTem:COMMunicate:LAN[:SELF]:MADDress? (Query Only) . . . . . . . . . . . . 2-96
:SYSTem:COMMunicate:LAN[:SELF]:SMASk (?). . . . . . . . . . . . . . . . . . . . . . . . . 2-97
:SYSTem:DATE (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-98
:SYSTem:ERRor[:NEXT]? (Query Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-98
:SYSTem:KDIRrection (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-99
:SYSTem:KEYBoard[:TYPE] (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-100
:SYSTem:KLOCk (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-100
:SYSTem:SECurity:IMMediate (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . 2-101
:SYSTem:TIME (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-102
:SYSTem:UPTime? (Query Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-102
:SYSTem:VERSion? (Query Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-103
*TRG (No Query Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-103
:TRIGger[:SEQuence][:IMMediate] (No Query Form). . . . . . . . . . . . . . . . . . . . . . 2-104
:TRIGger[:SEQuence]:IMPedance (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-104
:TRIGger[:SEQuence]:LEVel (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-105
:TRIGger[:SEQuence]:POLarity (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-106
:TRIGger[:SEQuence]:SLOPe (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-107
:TRIGger[:SEQuence]:SOURce (?). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-108
:TRIGger[:SEQuence]:TIMer (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-108
*TST? (Query Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-109
*WAI (No Query Form). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-110
Retrieving Response Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-111
Data Transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-113
Data File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-113
About Waveform and Pattern Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-114
Data Transfer Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-121
AWG710 & AWG710B Arbitrary Waveform Generator Programmer Manual iii
Table of Contents
Status and Events
Status and Event Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Status Reporting Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-4
Status Registers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Enable Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
Queues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
Status and Event Processing Sequence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
I/O Status and Event Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
Synchronizing Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Messages and Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
Command Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
Execution Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18
Device Specific Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-20
Query Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
Power–On Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
User Request Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
Request Control Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22
Operation Complete Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22
Device Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
Examples
Appendices
Glossary and Index
Programming Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Appendix A: Character Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
Appendix B: GPIB Interface Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
Interface Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
Interface Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
Appendix C: Network Interface Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1
Appendix D: SCPI Conformance Information . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
Appendix E: Factory Initialization Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-1
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Glossary-1
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
iv AWG710 & AWG710B Arbitrary Waveform Generator Programmer Manual
List of Figures
List of Figures
Figure 1-1: Common message elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Figure 1-2: Functional groupings and alphabetical list of commands . . . . . . . . . 1-2
Figure 1-3: Basic operation of status and events reporting . . . . . . . . . . . . . . . . . 1-3
Figure 1-4: The floppy disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Figure 1-5: GPIB connector location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Figure 1-6: How to stack GPIB connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Figure 1-7: Typical GPIB network configurations . . . . . . . . . . . . . . . . . . . . . . . . 1-6
Figure 1-8: Selecting the GPIB configuration and address . . . . . . . . . . . . . . . . . . 1-7
Figure 1-9: Ethernet port location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
Figure 1-10: Setting the Network parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
Figure 1-11: Message box to indicate the establishment of communication . . . 1-11
Figure 2-1: Example of SCPI subsystem hierarchy tree . . . . . . . . . . . . . . . . . . . . 2-2
Figure 2-2: Example of abbreviating a command . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Figure 2-3: Example of chaining commands and queries . . . . . . . . . . . . . . . . . . . 2-6
Figure 2-4: Example of omitting root and lower–level nodes in a chained message .
2-6
Figure 2-5: Typical syntax diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Figure 2-6: ABSTouch arguments and Front panel . . . . . . . . . . . . . . . . . . . . . . 2-27
Figure 2-7: Retrieving response messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-111
Figure 2-8: The Waveform file format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-115
Figure 2-9: The Pattern File format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-116
Figure 2-10: The Sequence File format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-117
Figure 2-11: The Equation File format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-119
Figure 2-12: The Code Convert File format . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-120
Figure 3-1: Error and Event handling process overview . . . . . . . . . . . . . . . . . . . 3-2
Figure 3-2: The Status Byte Register (SBR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Figure 3-3: The Standard Event Status Register (SESR) . . . . . . . . . . . . . . . . . . . 3-6
Figure 3-4: The Operation Condition Register (OCR) . . . . . . . . . . . . . . . . . . . . . 3-7
Figure 3-5: The Questionable Condition Register (QCR) . . . . . . . . . . . . . . . . . . . 3-7
Figure 3-6: The Event Status Enable Register (ESER) . . . . . . . . . . . . . . . . . . . . . 3-8
Figure 3-7: The Service Request Enable Register (SRER) . . . . . . . . . . . . . . . . . . 3-9
Figure 3-8: The Operation Enable Register (OENR) . . . . . . . . . . . . . . . . . . . . . . 3-9
Figure 3-9: The Questionable Enable Register (QENR) . . . . . . . . . . . . . . . . . . . . 3-9
Figure 3-10: Status and Event processing sequence — Operation status block 3-11
Figure 3-11: Status and Event processing sequence — Questionable status block . .
3-11
Figure 3-12: Status and Event processing sequence — Standard/Event status block
3-12
Figure 3-13: Status and Event screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
Figure 4-1: Equipment needed to run the GPIB example programs . . . . . . . . . . 4-1
AWG710 & AWG710B Arbitrary Waveform Generator Programmer Manual v
List of Figures
vi AWG710 & AWG710B Arbitrary Waveform Generator Programmer Manual
List of Tables
List of Tables
Table 2-1: BNF symbols and meanings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Table 2-2: Query response examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Table 2-3: Parameter types used in syntax descriptions . . . . . . . . . . . . . . . . . . . . 2-4
Table 2-4: Functional groups in the AWG command set . . . . . . . . . . . . . . . . . . 2-13
Table 2-5: AWG Control commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16
Table 2-6: Calibration commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
Table 2-7: Diagnostic commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
Table 2-8: Display commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
Table 2-9: Hardcopy commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
Table 2-10: Mass storage in AWG710 and AWG710B . . . . . . . . . . . . . . . . . . . . 2-19
Table 2-11: Mass Memory commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-19
Table 2-12: Output commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Table 2-13: Source commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Table 2-14: Status commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21
Table 2-15: Synchronization commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21
Table 2-16: System commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22
Table 2-17: Trigger commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-23
Table 2-18: Selecting run modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-40
Table 2-19: Self–test routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52
Table 3-1: SBR bit functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Table 3-2: SESR bit functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Table 3-3: OCR bit functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Table 3-4: QCR bit functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Table 3-5: Definition of event codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
Table 3-6: Command errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
Table 3-7: Execution errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18
Table 3-8: Device specific errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-20
Table 3-9: Query errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
Table 3-10: Power–on events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
Table 3-11: User request events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
Table 3-12: Request control events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22
Table 3-13: Operation complete events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22
Table 3-14: Device errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
Table A-1: The AWG character set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
Table A-2: ASCII & GPIB code chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
Table B-1: GPIB interface function implementation . . . . . . . . . . . . . . . . . . . . . . . B-1
Table B-2: AWG standard interface message . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
Table D-1: SCPI conformance information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
Table E-1: Factory initialization settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-1
AWG710 & AWG710B Arbitrary Waveform Generator Programmer Manual vii
List of Tables
viii AWG710 & AWG710B Arbitrary Waveform Generator Programmer Manual
Preface
This is the programmer manual for the AWG710 and AWG710B Arbitrary
Waveform Generators. This manual provides information necessary for operating
the instrument over both the G eneral Purpose Interface Bus (GPIB) and E thernet
interfaces.
This manual provides the following information:
The Getting Starte d section desc ribes ho w to connect and se t up the wa veform
generator for remote operation.
The Syntax and Commands section defines the command syntax and
processing conventions and describes each command in the waveform
generator command set.
The Status and Events section explains the status information and event
messages reported by the waveform generator.
The Programming Examples section describe s how to u se the Sample Pr ogram
floppy disk supplied with the waveform 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 docum entation for the waveform generator includes:
The AWG710 & AWG710B Arbitrary Waveform Generator User Manual
(Tektronix part number 071–1413–00) describes the operation of the
instrument.
AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual ix
Preface
x AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual
Getting Started
Getting Started
Manual Overview
The AWG710 Arbitrary Waveform Generator has GPIB and
10Base-T/100Base-TX Ethernet interface capability. You can write computer
programs that remote ly se t the fron t panel controls or that transf er w aveform data.
To help you get started with programming the waveform generator, this section
includes the following subs ections:
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 waveform generator to a controller through the GPIB interface, and how to
set the appropriate front panel controls.
Setting Up Remote Communications Using Ethernet - describes how to
connect the wa veform gener ator to a contro ller using the Et hernet interf ace and
how to set the appropriate front panel controls.
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 waveform
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
n
i
c
s
o
e
n
m
M
Syntax diagram
FUNCtion USER
:
Figure 1-1: Common message elements
Comma
"FILE1","FLOPpy"
Space
<space>
Arguments
<file_name>
,
<msus>
AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual 1-1
Getting Started
The Command Syntax subsection also describes the result of each comm and, 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-25, arranges
commands alphabetically. Figure 1-2 illustrates the two kinds of command lists.
Tr ig ge r
Diagnostic Commands
Calibration Commands
D
D
D
Commands Grouped in Functional Areas and Commands Listed Alphabetically
AWG C o n t rol C o m m a nds
C
C
:AWGControl:DOUTput:[:STATe]
C
:AWGControl:EVENt:LOGic[:IMMediate]
:AWGControl:RMODe
:AWGControl:RSTate?
:AWGControl:RUN[:IMMediate]
TRIGg
Figure 1-2: Functional groupings and alphabetical list of commands
Status and Events
Reporting
The program may request information from the waveform generator. The
wavef orm generator p rovides inf ormation in th e form of status an d error message s.
Figure 1-3 on page 1-3 illustrates the basic operation of this system.
The Status and Eve nts Reporting subsect io n, whi ch begins on page 3-1, describes
how to use t he st at us r eporting functions that conform to SCPI and IEEE-488.2 in
your programs.
AWG Con tro l:R MOD e
AWGControl:EVENt:LOGic[:IMMediate]
S
S
G
E
AWGControl:DOUTput[:STATe]
G
Syntax: . . .
E
Group: . . .
Examples: . . .
1-2 AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual
Your program requests
status and event reports.
Controller
Your program requests
status and event reports.
Getting Started
AWG sends status and event reports.
Waveform generator (rear panel)
GPIB cable
Programming Examples
Controller
Lan cable
LAN (Ethernet) or Hub
AWG sends status and event reports.
Waveform generator (rear panel)
Lan cable
Figure 1-3: Basic operation of status and events reporting
The Programming Examples section, which begins on page 4-1, provides some
sample waveform generator programs. A floppy disk (see Figure 1-4) is supplied
with this manual. The disk contains a Microsoft Visual C++ and Visual BASIC
source–code version of each program.
AWG Examp le
Programs
Figure 1-4: The floppy disk
AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual 1-3
Getting Started
Setting Up Remote Communications Using GPIB
For remote operations, the instrument must be connected to the controller.
The wav ef orm generator has a 24– pin GPIB connector on its rear panel, as shown
in Figure 1-5. This connector has a D–type shell and conforms to IEEE Std
488.1–1987.
Attach an IEEE Std 488.1–1987 GPIB cable (Tektronix Part Number
012–0991–XX) to the GPIB connector.
GPIB connector
Figure 1-5: GPIB connector location
1-4 AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual
Stack GPIB connectors, if needed, as shown in Figure 1-6.
Getting Started
Figure 1-6: How to stack GPIB connectors
AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual 1-5
Getting Started
GPIB Requirements
Follow these rules when you use your waveform generator with a GPIB network:
Assign a unique de vice addr ess to each de vice on the b us. 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 th e devices on the
network.
Connect the devices on t he network in a st ar or l in ear configurat ion, as sho wn
in Figure 1-7. Do not use loop or parallel configurations.
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
Setting the GPIB
Parameters
Figure 1-7: Typical GPIB network configurations
NOTE. Appendix C: Network Interface Specification provides more information
about the GPIB configuration of the waveform generator.
You must set the GPIB parameters of the waveform generator t o match the
configuration of the bus. F ollow the step s be low to set up the waveform ge ner at or
for the GPIB interface.
1. Press the UTILITY button to display the Utility screen.
2. Press the Comm menu button at the bottom of the screen.
3. Move the cursor to the Remote Control field using the up/down ("/#) arrow
buttons, then select GPIB using the left/right (z/!) arrow buttons.
4. Move the cursor to the GPIB Configura tion field using the up/down ("/#)
arrow buttons, then select Talk/Listen using either the general purpose knob
or the left/right (z/!) arrow buttons. See Figure 1-8 on page 1-7.
1-6 AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual
Getting Started
5. Move the cursor to the GPIB Address field using the down (#) arrow button.
Set the address using either the general purpose knob or the keypad.
Figure 1-8: Selecting the GPIB configuration and address
The waveform generator is set up for bidirectional communication with your
controller. Do the following to isolate the waveform generator from the bus:
Select Off Bus in the GPIB Configuration field.
This selection disables all communication with the controller.
AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual 1-7
Getting Started
Setting Up Remote Communications Using Ethernet
NOTE. For remote operations, the instrument must be connected to the controller.
The wave for m gene ra tor has an Ethernet (10Base-T/ 100Ba se -Tx) por t on the rear
panel as shown in Figures 1-9.
Attach an Ethernet cable to the Ethernet port.
Ethernet port
Figure 1-9: Ethernet port location
1-8 AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual
Getting Started
Setting the Network
Parameters
You must set the network parameters of the waveform generator to match the
configuration of the net work. After you ha v e set these par ameters, you can contro l
the waveform generator throug h the Ethern et interface.
1. Press the UTILITY button to display the Utility screen.
2. Press the Comm menu button at the bottom of the screen.
3. Move the cursor to the Remote Control field using the up/down ("/#) arrow
buttons, then select Network using the left/right (z/!) arrow buttons.
4. Move the cursor to the Network IP Address field using the up/down ("/#)
arrow buttons, then press the Edit... button and set the address using the
keypad. See Figure 1-10 on page 1-10.
Manual operation:
a. Move the cursor to the DHCP Client field using the up/do wn ("/#) arrow
buttons, then press Disabled using the left/right (z/!) arrow buttons.
b. Move the cursor to the IP Address field using the up/down ("/#) arrow
buttons, then press the Edit... button.
c. Set the IP Address in IP Address dialog box.
d. If necessary, use the Subnet Mask field to set the address.
Using DHCP:
e. Move the cursor to the DHCP Client field us ing the up/down ("/#) arrow
buttons, then press Enabled using the left/right (z/!) arrow buttons.
f. AWG710 sends an acquisition request, then the server sends the address.
The address is displayed in the IP Address fie ld.
5. If necessary , use the Destination Network and Gateway Address fields to set
the destination network and the address.
You need to set the gateway address when the remote computers are
connecting to an other network t hat i s connected to th e n et w o rk via a gate w ay.
You can set up to three gateways.
Set the FTP server to Enabled for access to the hard disk sy stem of the
instrument from a remote computer.
If you are not familiar with the network setup, consult with your network
administrator.
AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual 1-9
Getting Started
Network
parameters
Figure 1-10: Setting the Network parameters
1-10 AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual
Getting Started
Testing the Network
Connection
After completing the connection and settings, verify that the waveform generator
can recognize the network and the remote computers, or if the network can
recognize the waveform generator. Follow these steps to use the “ping” command
to verify that the instrument can communicate with the network:
1. Press the UTILITY button to display the Utility screen.
2. Press the Network or Comm bottom menu button.
3. Press the Execute Ping side button to display a dialog box.
4. Enter the IP address of the remote computer in the dialog box, and then push
the OK side button.
The ping command sends a pac k et t o t h e r emot e c omput er spe ci fied by the IP
address. When the computer receives the packet, it sends the packet back to the
sender (waveform generator).
When the waveform generator can communicate with the remote computer
through the network the message in Figure 1-11 displays. If communication
failed, the message box displays an error message such as "no response
from...".
5. Repeat steps 2 and 3 to verify the connection for other remote computers on
the network .
Figure 1-11: Message box to indicate the establishment of communication
AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual 1-11
Getting Started
1-12 AWG710&AWG710B Arbitrary Waveform Generator Programmer Manual
Syntax and Commands
