Tektronix AFG3000 Programming Examples

AFG3000 Series Arbitrary/Function Generators Reference Manual 5-1

Programming Examples

The following two example programs, which demonstrate methods that you can

use to control the arbitrary/function generator through the General Purpose Inter-

face Bus (GPIB), are included on the AFG3000 Series Arbitrary/Function Gener-

ators Product CD.

Example 1: Set up a Waveform Output

Example 2: Waveform Transfer and Copy

The example programs are written in Microsoft Visual Basic Version 6.0. The

programs run on Windows PC compatible systems equipped with TekVISA and a

National Instruments GPIB board with the associated drivers.

TekVISA is the Tektronix implementation of the VISA Application Programming

Interface (API). TekVISA is industry-compliant software for writing interoperable

instrument drivers in a variety of Application Development Environments (ADEs).

The example programs assume that the GPIB system recognizes the PC (external

controller) as GPIB0, and the address number of the instrument as 11.

If you use an interface other than GPIB, change the resouce name of source code.

Refer to TekVISA manual for details about resouce.

Contents

Main Page WARRANTY 16 Page AFG3000 Series Arbitrary/Function Generators Reference Manual i Table of Contents Operating Basics Reference Syntax and Commands ii AFG3000 Series Arbitrary/Function Generators Reference Manual AFG3000 Series Arbitrary/Function Generators Reference Manual iii iv AFG3000 Series Arbitrary/Function Generators Reference Manual Status and Events Programming Examples Appendices Index List of Figures List of Figures Page List of Tables AFG3000 Series Arbitrary/Function Generators Reference Manual vii List of Tables Page General Safety Summary To avoid Fire or Personal Injury Symbols and Terms Preface Documentation Contacting Tektronix Page Page AFG3000 Series Arbitrary/Function Generators Reference Manual 1-1 Operating Basics AFG Figure 1-1: Dual-channel model Channel TriggerTrigger Front Panel Controls Action Buttons Page Page Menu Buttons State Buttons Function Buttons Shortcut Buttons Knob and Arrow Keys BNC Connectors USB Memory To Unlock Front Panel Controls Display Area and Screen Interface Main Display Area Message Display Area Bezel Menu Display Area Waveform Parameters and Numeric Input Changing Parameters Using the Bezel Menu Numeric Input Page Page Page Rear Panel Page Page Page Reference Menu System Using the Menu System Menu Structure AFG3000 Series Arbitrary/Function Generators Reference Manual 2-3 Sine/Square Menu Table2-1: Sine/Square Menu 2-4 AFG3000 Series Arbitrary/Function Generators Reference Manual Ramp Menu Pulse Menu Table2-2: Ramp Menu Table2-3: Pulse Menu Arb Menu More... Menu Modulation Parameter Menu Page AFG3000 Series Arbitrary/Function Generators Reference Manual 2-9 Sweep Parameter Menu Figure 2-1: Sweep type Table2-7: Sweep Parameter Menu Page Burst Parameter Menu 2-12 AFG3000 Series Arbitrary/Function Generators Reference Manual Output Menu front-panel Top Menu button, and then push the bottom bezel button. Table2-9: Output Menu Save/Recall Menu Edit Menu AFG3000 Series Arbitrary/Function Generators Reference Manual 2-15 Table2-11: Edit Menu (cont.) Page Page Page Page Page Page Page AFG3000 Series Arbitrary/Function Generators Reference Manual 2-23 Utility Menu 2-24 AFG3000 Series Arbitrary/Function Generators Reference Manual Table2-13: Utility Menu (cont.) Page Page Page File Operations Browsing Waveform Files Saving a Waveform File Page Browsing Instrument Setup Files Saving an Instrument Setup File File Management Conventions Page Page Syntax and Commands Command Syntax Command and Query Structure Page Command Entry SCPI Commands and Queries Creating Commands Parameter Types Special Characters Abbreviating Commands, Queries, and Parameters Chaining Commands and Queries Units and SI Prefix General Rules for Using SCPI commands Command Groups Page Syntax and Commands AFG3000 Series Arbitrary/Function Generators Reference Manual 3-11 Table3-10: Source commands (cont.) Syntax and Commands 3-12 AFG3000 Series Arbitrary/Function Generators Reference Manual Table3-11: Status commands Table3-10: Source commands (cont.) Page Page Command Descriptions Manual Conventions ABORt (No Query Form) Group Syntax Arguments Examples AFGControl:CSCopy (No Query Form) *CAL? CALibration[:ALL] *CLS (No Query Form) DIAGnostic[:ALL] DISPlay:CONTrast DISPlay:SAVer[:STATe] DISPlay[:WINDow]:TEXT[:DATA] DISPlay[:WINDow]:TEXT:CLEar (No Query Form) *ESE *ESR? *IDN? MEMory:STATe:VALid? MEMory:STATe:DELete (No Query Form) MEMory:STATe:LOCK MEMory:STATe:RECall:AUTo MMEMory:CATalog? MMEMory:CDIRectory MMEMory:DELete (No Query Form) MMEMory:LOAD:STATe (No Query Form) MMEMory:LOAD:TRACe (No Query Form) MMEMory:LOCK[:STATe] MMEMory:MDIRectory (No Query Form) MMEMory:STORe:STATe (No Query Form) MMEMory:STORe:TRACe (No Query Form) *OPC *OPT? OUTPut[1|2]:IMPedance OUTPut[1|2]:POLarity OUTPut[1|2][:STATe] OUTPut:TRIGger:MODE *PSC *RCL (No Query Form) *RST (No Query Form) *SAV (No Query Form) [SOURce[1|2]]:AM[:DEPTh] [SOURce[1|2]]:AM:INTernal:FREQuency [SOURce[1|2]]:AM:INTernal:FUNCtion [SOURce[1|2]]:AM:INTernal:FUNCtion:EFILe [SOURce[1|2]]:AM:SOURce [SOURce[1|2]]:AM:STATe [SOURce[1|2]]:BURSt:MODE [SOURce[1|2]]:BURSt:NCYCles [SOURce[1|2]]:BURSt[:STATe] [SOURce[1|2]]:BURSt:TDELay [SOURce[1|2]]:COMBine:FEED [SOURce[1|2]]:FM[:DEViation] [SOURce[1|2]]:FM:INTernal:FREQuency [SOURce[1|2]]:FM:INTernal:FUNCtion [SOURce[1|2]]:FM:INTernal:FUNCtion:EFILe [SOURce[1|2]]:FM:SOURce [SOURce[1|2]]:FM:STATe [SOURce[1|2]]:FREQuency:CENTer [SOURce[1|2]]:FREQuency:CONCurrent[:STATe] [SOURce[1|2]]:FREQuency[:CW|:FIXed] [SOURce[1|2]]:FREQuency:MODE [SOURce[1|2]]:FREQuency:SPAN [SOURce[1|2]]:FREQuency:STARt [SOURce[1|2]]:FREQuency:STOP [SOURce[1|2]]:FSKey[:FREQuency] [SOURce[1|2]]:FSKey:INTernal:RATE [SOURce[1|2]]:FSKey:SOURce [SOURce[1|2]]:FSKey:STATe [SOURce[1|2]]:FUNCtion:EFILe [SOURce[1|2]]:FUNCtion:RAMP:SYMMetry [SOURce[1|2]]:FUNCtion[:SHAPe] Syntax Arguments [SOURce[1|2]]:PHASe[:ADJust] [SOURce[1|2]]:PHASe:INITiate (No Query Form) [SOURce[1|2]]:PM[:DEViation] [SOURce[1|2]]:PM:INTernal:FREQuency [SOURce[1|2]]:PM:INTernal:FUNCtion [SOURce[1|2]]:PM:INTernal:FUNCtion:EFILe [SOURce[1|2]]:PM:SOURce [SOURce[1|2]]:PM:STATe SOURce<3|4>:POWer[:LEVel][:IMMediate][:AMPLitude] [SOURce[1|2]]:PULSe:DCYCle [SOURce[1|2]]:PULSe:DELay [SOURce[1|2]]:PULSe:HOLD [SOURce[1|2]]:PULSe:PERiod [SOURce[1|2]]:PULSe:TRANsition[:LEADing] [SOURce[1|2]]:PULSe:TRANsition:TRAiling [SOURce[1|2]]:PULSe:WIDTh [SOURce[1|2]]:PWM:INTernal:FREQuency [SOURce[1|2]]:PWM:INTernal:FUNCtion [SOURce[1|2]]:PWM:INTernal:FUNCtion:EFILe [SOURce[1|2]]:PWM:SOURce [SOURce[1|2]]:PWM:STATe [SOURce[1|2]]:PWM[:DEViation]:DCYCle [SOURce]:ROSCillator:SOURce [SOURce[1|2]]:SWEep:HTIMe [SOURce[1|2]]:SWEep:MODE [SOURce[1|2]]:SWEep:RTIMe [SOURce[1|2]]:SWEep:SPACing [SOURce[1|2]]:SWEep:TIME [SOURce[1|2]]:VOLTage:CONCurrent[:STATe] [SOURce[1|2]]:VOLTage[:LEVel][:IMMediate]:HIGH [SOURce[1|2]]:VOLTage[:LEVel][:IMMediate]:LOW [SOURce[1|2]]:VOLTage[:LEVel][:IMMediate]:OFFSet [SOURce[1|2]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] Related Commands Syntax Arguments Returns Examples [SOURce[1|2]]:VOLTage:LIMit:HIGH [SOURce[1|2]]:VOLTage:LIMit:LOW [SOURce[1|2]]:VOLTage:UNIT Related Commands Syntax Arguments Returns Examples *SRE STATus:OPERation:CONDition? STATus:OPERation:ENABle STATus:OPERation[:EVENt]? STATus:PRESet (No Query Form) STATus:QUEStionable:CONDition? STATus:QUEStionable:ENABle STATus:QUEStionable[:EVENt]? *STB? SYSTem:BEEPer[:IMMediate] (No Query Form) SYSTem:BEEPer:STATe SYSTem:ERRor[:NEXT]? SYSTem:KCLick[:STATe] SYSTem:KLOCk[:STATe] SYSTem:SECurity:IMMediate (No Query Form) SYSTem:ULANguage SYSTem:VERSion? TRACe |DATA:CATalo g? TRACe|DATA:COPY (No Query Form) TRACe |DATA[:DATA] TRACe|DATA[:DATA]:LINE (No Query Form) TRACe |DATA[:DATA]:VAL ue TRACe|DATA:DEFine (No Query Form) Group Syntax Arguments Examples TRACe|DATA:DELete[:NAME] (No Query Form) TRACe|DATA:LOCK[:STATe] TRACe |DATA:PO INt s *TRG (No Query Form) TRIGger[:SEQuence]:SLOPe TRIGger[:SEQuence]:SOURce TRIGger[:SEQuence]:TIMer TRIGger[:SEQuence][:IMMediate] (No Query Form) *TST? *WAI (No Query Form) Page Page Page Status and Events Status Reporting Structure 4-2 AFG3000 Series Arbitrary/Function Generators Reference Manual Figure 4-1: Error and event handling process Standard/Event Status Block Operation Status Block Questionable Status Block Registers Status Registers AFG3000 Series Arbitrary/Function Generators Reference Manual 4-5 Figure 4-2: The Status Byte Register (SBR) Table4-1: SBR bit functions 4-6 AFG3000 Series Arbitrary/Function Generators Reference Manual AFG3000 Series Arbitrary/Function Generators Reference Manual 4-7 Table4-3: OCR bit functions Enable Registers Page Queues Output Queue Error/Event Queue Messages and Codes Command Errors 4-12 AFG3000 Series Arbitrary/Function Generators Reference Manual Table4-6: Command error messages (cont.) AFG3000 Series Arbitrary/Function Generators Reference Manual 4-13 Execution Errors Table4-7: Execution error messages 4-14 AFG3000 Series Arbitrary/Function Generators Reference Manual Table4-7: Execution error messages (cont.) Device Specific Errors Query Errors Power-on Events Page AFG3000 Series Arbitrary/Function Generators Reference Manual 4-17 Device Errors trary/Function Generators. Table4-14: Device errors 4-18 AFG3000 Series Arbitrary/Function Generators Reference Manual Table4-14: Device errors (cont.) Page Page Programming Examples 5-2 AFG3000 Series Arbitrary/Function Generators Reference Manual Example 1 AFG3000 Series Arbitrary/Function Generators Reference Manual 5-3 Example 2 tion generator's Edit Memory and copying the contents of Edit Memory to the user waveform memory. 5-4 AFG3000 Series Arbitrary/Function Generators Reference Manual Page Page AFG3000 Series Arbitrary/Function Generators Reference Manual A-1 Appendix A: Accessories and Options Options The following options can be ordered for the instrument: TableA-1: Options Accessories Standard Optional Page Page Appendix B: General Care and Cleaning General Care Cleaning Page AFG3000 Series Arbitrary/Function Generators Reference Manual C-1 Appendix C: SCPI Conformance Information C-2 AFG3000 Series Arbitrary/Function Generators Reference Manual AFG3000 Series Arbitrary/Function Generators Reference Manual C-3 C-4 AFG3000 Series Arbitrary/Function Generators Reference Manual AFG3000 Series Arbitrary/Function Generators Reference Manual D-1 Appendix D: Default Setup Page Page Page Index Symbols A B C F G H I L N O P Q R Page T U V W Z