Home

[SOURce[1|2]]

1. SOURce STATe DEViation PULSe DCYCle DELay HOLD PERiod TRANsition TRAIling LEADing Z je je je jeje e jeje j2 WIDTh PWM INTernal FREQuency FUNCtion EFILe SOURCe STATe DEViation DCYCle SWEep HTIMe MODE RTIMe NI SPACing TIME VOLTage LIMit HIGH LOW UNIT NI Z Z je e e je je Z e je je AFG3000 Series Arbitrary Function Generator Programmer Manual A 3 Appendix A SCPI Conformance Information Table A 1 SCPI conformance information cont Not Defined defined in SCPI in SCPI Command 1999 0 1999 0 LEVel IMMediate HIGH N LOW NI OFFSet AMPLitude SOURce lt 3 4 gt POWer LEVel IMMediate AMPLitude Y STATus OPERation EVENt NI CONDition NI ENABle NI PRESet NI OUEStionable EVENI CONDition NI ENABle y SYSTem BEEPer STATe NI IMMediate J ERRor NEXT Ni KCLick STATe NI KLOCk STATe N PASSword CDISable Ni CENable NI STATe NI NEW NI SECurity IMMediate NI ULANguage V VERSion NI TRACe DATA CATalog NI COPY DATA V LINE NI VALue NI DEFine NI DELete NAME NI A 4 AFG3000 Series Arbitrary Function Generator Programmer Manual Appendix A SCPI Conformance Information Table A 1 SCPI conformance informati
2. Trigger TRIGger SEQuence SLOPe positive NEGative TRIGger SEQuence SLOPe POSi tive indicates that the event occurs on the rising edge of the external trigger signal AFG3000 Series Arbitrary Function Generator Programmer Manual 2 99 Command Descriptions Returns Examples NEGative indicates that the event occurs on the falling edge of the external trigger signal POS NEG TRIGGER SEQUENCE SLOPE POSitive sets the trigger slope to positive which triggers on the rising edge of the signal TRIGger SEQuence SOURce Group Syntax Arguments Returns Examples This command sets or queries the trigger source for an external trigger signal Trigger TRIGger SEQuence SOURCe TIMer EXTernal TRIGger SEQuence SOURCe TIMer specifies an internal clock as the trigger source EXTernal specifies an external trigger input as the trigger source TIM EXT TRIGger SEQuence SOURCe EXTe rnal sets an external trigger input as the trigger source TRIGger SEGuence TIMer Group Syntax 2 100 This command sets or gueries the period of an internal clock when you select the internal clock as the trigger source with the TRIGger SEQuence SOURce command The setting range is 1 us to 500 0 s Trigger TRIGger SEQuence TIMer lt seconds gt TRIGger SEQuence TIMer AFG3000 Series Arbitrary Function Generator Programmer Manual Related Commands Arguments Returns Examples
3. Command Descriptions TRIGger SEQuence SOURce lt seconds gt lt NRf gt lt units gt where lt units gt lt jus ms s lt seconds gt TRIGGER SEQUENCE TIMER 5ms sets the internal trigger rate to 5 ms TRIGger SEGuence IMMediate No Query Form Group Syntax Arguments Examples TST Query Only Group Syntax AFG3000 Series Arbitrary Function Generator Programmer Manual This command forces a trigger event to occur Trigger TRIGger SEQuence IMMediate None TRIGger SEQuence IMMediate generates a trigger event This command performs a self test and returns the results NOTE The self test can take several minutes to complete During this time the arbitrary function generator does not execute any commands Do not power off the instrument during the self test Calibration and Diagnostic TST 2 101 Command Descriptions Related Commands DJAGnostic ALL Arguments None Returns lt NR1 gt where lt NR1 gt 0 indicates that the self test completed without errors lt NR1 gt 70 indicates that the arbitrary function generator detected an error Examples TST performs a self test and returns 0 if no error is reported WAI No Query Form This command prevents the instrument from executing further commands or queries until all pending commands that generate an OPC message are complete Group Synchronization Syntax WAT Related Commands
4. Syntax Arguments Examples Group Syntax This command erases all the current instrument setups setup memory last setup memory user waveform memory and log content and recalls the factory default settings Calibration data is not erased The communication settings are initialized to the factory default settings This might cause a remote communication error System SYSTem SECurity IMMediate None SYSTEM SECURITY IMMEDIATE initializes the instrument This command sets or queries the language that the instrument uses to display information on the screen System SYSTem ULANguage ENGLish FRENch GERMan JAPanese KORean SCHinese TCHinese RUSSian AFG3000 Series Arbitrary Function Generator Programmer Manual Arguments Returns Examples Command Descriptions SYSTem ULANguage ENGLish FRENch GER Man JA Panese KORean SCHinese TCHinese RUSSian specifies which language will be used to display instrument information on the screen ENGLi sh FRENch GERMan JAPanese KORean SCHinese TCHinese RUSSian SYSTEM ULANGUAGE FRENCh specifies that the instrument displays information in French SYSTem VERSion Query Only Group Syntax Arguments Returns Examples This query only command returns the conformed SCPI version of the instrument System SYSTem VERSion None lt SCPI Version gt YYYY V where YYYY indicates year V indicates the version number for that ye
5. Table 3 10 Power on events Event code Event message 500 Power on User Request Events These events are not used in this instrument Table 3 11 User request events Event code Event message 600 User request Request Control Events These events are not used in this instrument Table 3 12 Request control events Event code Event message 700 Request control Operation Complete These events occur when instrument s synchronization protocol having been Events enabled by an OPC command completes all selected pending operations Table 3 13 Operation complete events Event code Event message 800 Operation complete AFG3000 Series Arbitrary Function Generator Programmer Manual 3 17 Status and Events Device Errors The following table lists the error codes that are unique to the AFG3000 Series Arbitrary Function Generator Table 3 14 Device errors Error code Error message 1101 Calibration failed CH1 Internal offset 1102 Calibration failed CH2 Internal offset 1103 Calibration failed CH1 Output offset 1104 Calibration failed CH2 Output offset 1105 Calibration failed CH1 Output gain 1106 Calibration failed CH2 Output gain 1201 Calibration failed CH1 x 3 dB attenuator 1202 Calibration failed CH2 x 3 dB attenuator 1203 Calibration failed CH1 x 6 dB attenuator 1204 Calibration failed CH
6. VOLTage LEVell IMMediate HIGH Set guery output amplitude high level SOURce 1 2 VOLTage LEVel IMMediate LOW Set query output amplitude low level SOURce 1 2 VOLTage LEVell IMMediate OFFSet Set guery output offset voltage SOURce 1 2 VOLTage LEVell IMMediate AMPLitude Set query output amplitude SOURCce lt 3 4 gt POWer LEVel IMMediate AMPLitude Set query internal noise level AFG3000 Series Arbitrary Function Generator Programmer Manual Command Groups Status Commands Status commands let you determine the status of the instrument lists and describes Status commands Table 2 13 Status commands Header Description CLS Clear all event registers and queues ESE Set query standard event status enable register ESR Return standard event status register PSC Set query power on status clear SRE Set query service request enable register STB Read status byte STATus OPERation CONDition Return operation condition register STATus OPERation ENABle Set query operation enable register STATus OPERation EVENt STATus PRESet Return operation event register Preset SCPI enable register STATus QUEStionable CONDition Return questionable condition register STATus QUEStionable ENABle Set query questionable enable register STATus QUEStionable EVENt Return questionable event register System Commands S
7. Status STATUS PRESet None STATUS PRESET presets the SCPI status registers STATus QUEStionable CONDition Query Only Group Syntax Arguments Returns This query only command returns the contents of the Questionable Condition Register Status STATUS QUEStionable CONDi tion None lt bit value gt lt NR1 gt AFG3000 Series Arbitrary Function Generator Programmer Manual 2 85 Command Descriptions Examples STATUS QUESTIONABLE CONDITION might return 32 which indicates that the QCR contains the binary number 00000000 00100000 and the accuracy of frequency is questionable STATus QUEStionable ENABle Group Syntax Arguments Returns Examples This command sets or queries the mask for the Questionable Enable Register Status STATUS QUEStionable ENABle lt bit_value gt STATUS QUEStionable ENABle lt bit value gt lt NR1 gt lt bit value gt STATUS QUESTIONABLE ENABLE 32 sets the FREQuency bit in the QENR to on STATus QUEStionable EVENt Query Only Group Syntax Arguments Returns Examples 2 86 This query only command returns the value in the Questionable Event Register and clears the Questionable Event Register Status STATUS QUEStionable EVENt None lt bit value gt lt NR1 gt STATUS OUESTIONABLE EVENT might return 32 which indicates that the OEVR contains the binary number 00000000 00100000 and the
8. for a listing of the commands by command group or use the index to locate a specific command Backus Naur Form Definition This manual may describe commands and queries using the Backus Naur Form BNF notation The following table defines the standard BNF symbols Table 2 1 BNF symbols and meanings Symbol Meaning Sa Defined element Is defined as Exclusive OR Group one element is required Optional can be omitted Previous element s may be repeated Comment Command and Query Structure 2 2 Commands consist of set commands and query commands usually simply called commands and queries Commands change instrument settings or perform a specific action Queries cause the instrument to return data and information about its status Most commands have both a set form and a query form The query form of the command is the same as the set form except that it ends with a question mark For example the set command DISPlay CONTrast has a query form DISPlay CONTrast Not all commands have both a set and a query form some commands are set only and some are query only A few commands do both a set and query action For example the CAL command runs a self calibration program on the instrument then returns the result of the calibration A command message is a command or query name followed by any information the instrument needs to execute the command or query Command messages cons
9. 2 AM STATe 2 43 2 AM DEPTh 2 40 2 BURSt MODE 2 43 2 BURSt NCYCles 2 44 2 BURSt TDELay 2 45 2 BURSt STATe 2 45 2 COMBine FEED 2 46 2 FM INTernal FREQuency 2 47 2 FM INTernal FUNCtion 2 48 2 FM INTernal FUNCtion EFILe 2 49 2 FM SOURce 2 49 2 1 FM STATe 2 50 2 FM DEViation 2 47 2 FREQuency CENTer 2 50 2 FREQuency CONCurrent STATe 2 51 2 FREOuency MODE 2 52 2 FREQuency SPAN 2 53 2 FREOuency START 2 54 2 FREOuency STOP 2 54 2 1 FREOuency CW FIXed 2 52 2 FSKey INTernal RATE 2 56 2 FSKey SOURCce 2 56 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 LOW 2 SOURce 1 OFFSet SOURce 1 EFILe 2 71 HIGH 2 78 2 1 FSKey STATe 2 57 2 FSKey FREQuency 2 55 2 FUNCtion EFILe 2 57 2 FUNCtion RAMP SYMMetry 2 58 2 FUNCtion SHAPe 2 58 2 PHASe INITiate 2 60 2 1 PHASe A DJust 2 59 2 PM INTernal FREOuency 2 61 2 PM INTernal FUNCtion 2 62 2 PM INTernal FUNCtion EFILe 2 63 2 1 PM SOURCe 2 63 2 PM STATe 2 64 2 PM DEViation 2 61 2 PULSe DCYCle 2 65 2 PULSe
10. AFG3102C AFG3251C AFG3252C The manual consists of the following sections Getting Started covers operating principles of the instrument which helps you understand how your generator operates m Syntax and Commands defines the command syntax and processing conventions describes command notation Status and Events explains the status information and event messages reported by the instrument Programming Examples contains remote interface application programs to help you develop programs for your application Appendix A SCPI Conformance Information contains a list of commands and SCPI information Documentation The following table lists related documentation available for your instrument The documentation is available on the Document CD and on the Tektronix Web site www tektronix com downloads AFG3000 Series Arbitrary Function Generator Programmer Manual ili Preface iv Item Purpose Location Quick Start User Unpacking paN Manual Installation Tutorials LYS Cy Operation and WWW Tektronix com Overviews available in English German French Italian Portuguese Spanish Korean Russian Japanese Simplified Chinese and Traditional Chinese Built in Help part UI Help and Operation of instrument firmware Programmer Menu Structures a Manual this User Interface lt R Sa document and Programming OZ Information Service Manual Self service and JA Performance test
11. CSCopy CH1 CH2 CH1 CH2 AFG3000 Series Arbitrary Function Generator Programmer Manual 2 19 Command Descriptions Arguments Examples CAL Query Only Group Syntax Related Commands Arguments Returns Examples CALibration ALL 2 20 CH1 CH2 AFGCONTROL CSCOPYCH1 CH2 copies the CH1 setup parameters into CH2 This command performs an internal calibration and returns 0 Pass or a calibration error code NOTE The self calibration can take several minutes to complete During this time the arbitrary function generator does not execute any commands Do not power off the instrument during the self calibration Calibration and Diagnostic CAL CALibration ALL None lt NR1 gt where lt NR1 gt 0 indicates that the internal calibration completed without errors lt NR1 gt 0 indicates that the arbitrary function generator detected an error CAL performs an internal calibration and returns results For example it might return 0 which indicates that the calibration completed without any errors The CALibration ALL command performs an internal calibration The CALibration ALL command performs an internal calibration and returns 0 Pass or a calibration error code AFG3000 Series Arbitrary Function Generator Programmer Manual Group Syntax Related Commands Arguments Returns Examples CLS No Query Form Group Syntax Arguments Command Descriptio
12. Description 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 arbitrary function generator complies with this standard Command and Query The syntax for an IEEE 488 2 common command is an asterisk followed by a Structure 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 listed in the last part of the Syntax and Commands section The following are examples of common commands m ESE 16 m CLS AFG3000 Series Arbitrary Function Generator Programmer Manual 2 9 Command Syntax The following are examples of common queries m ESR u IDN 2 10 AFG3000 Series Arbitrary Function Generator Programmer Manual Command Groups This section lists the commands organized by functional group The Command Descriptions section lists all commands alphabetically Calibration and Diagnostic Commands Calibration and Diagnostic commands let you initiate the instrument self calibration routines and examine the results of diagnostic tests lists Calibration and Diagnostic commands Table 2 7 Calibration and Diagnostic commands Header Description CAL Perform self calibration and return result status CALibration ALL Perform self calibration DIAGnostic ALL Perf
13. is set when calibration is in progress and is reset when the calibration is complete Questionable Event Register QEVR This register has the same content as the Questionable Condition Register AFG3000 Series Arbitrary Function Generator Programmer Manual 3 9 Status and Events Enable Registers Questionable Condition Register QCR The Questionable Condition Register is made up of sixteen bits which note the occurrence of two types of events 15 14 13 12 10 9 8 6 4 3 2 1 0 5 FREQ 11 OVHP Figure 3 5 Questionable Condition Register ACR Table 3 4 QCR bit functions Bit Function 15 to 12 Not used 11 OVHP Overheat protection Indicates whether the instrument internal temperature is in questionable condition 10to 6 Not used 5 FREQ Frequency Indicates whether frequency accuracy of the signal is of questionable quality 4to0 Not used There are four types of enable registers m Event Status Enable Register ESER Service Request Enable Register SRER Operation Enable Register OENR m Questionable Enable Register QENR Each bit in the enable registers corresponds to a bit in the controlling status register By setting and resetting the bits in the enable register you can determine whether or not events that occur will be registered to the status register and queue Event Status Enable Register E
14. lt units gt where lt NRf gt is the output frequency lt units gt Hz kHz MHz lt frequency gt SOURcel FREQuency FIxXed 500kHz sets the CH 1 output freguency to 500 kHz when the Run Mode is set to other than Sweep SOURCe 1 2 FREOuency MODE 2 52 Group This command sets or gueries the freguency sweep state You can select sine sguare ramp or arbitrary waveform for sweep The arbitrary function generator automatically changes to the Continuous mode if any waveform is selected other than sine sguare ramp or an arbitrary waveform Source AFG3000 Series Arbitrary Function Generator Programmer Manual Syntax Related Commands Arguments Returns Examples Command Descriptions SOURCe 1 2 FREQuency MODE cw FIXed SwEep SOURce 1 2 FREQUency MODE SOURce 1 2 FREQuency CW FIXed SOURce 1 2 FREQuency CENTer SOURce 1 2 FREQuency SPAN SOURce 1 2 FREQuency STARt SOURce 1 2 FREQuency STOP CW FIXed means that the frequency is controlled by the SOURce 1 2 FREQuency CW FIXed command The sweep is invalid SWEep means that the output frequency is controlled by the sweep command set The sweep is valid CW FIXed SWEep SOURCe1 FREQuency MODE SWEep specifies the sweep command set for controlling the CH 1 output frequency SOURce 1 2 F REQuency SPAN Group Syntax Related Commands Arguments Returns This command sets or queries the span of
15. not include hold time Group Source Syntax SOURce 1 2 SWEep RTIMe lt seconds gt MINimum MAXimum SOURce 1 2 SwEep RTIMe AFG3000 Series Arbitrary Function Generator Programmer Manual 2 75 Command Descriptions Arguments Returns Examples lt seconds gt lt NRf gt lt units gt where lt NR is the return time in seconds lt units gt ns us ms s lt seconds gt SOURCe1 SWEep RTIMe 1ms sets the CH 1 return time to 1 ms SOURce 1 2 SWEep SPACing Group Syntax Arguments Returns Examples The SOURce 1 2 SWEep SPA Cing command selects linear or logarithmic spacing for the sweep for the specified channel The query command returns the type for the sweep spacing for the specified channel Source SOURce 1 2 SWEep SPACing LINear LOGarithmic SOURce 1 2 SWEep SPACing LINear sets the sweep spacing to linear LOGarithmic sets the sweep spacing to logarithmic LIN LOG SOURcel SWEep SPACing LINear sets the CH1 sweep spacing to linear SOURce 1 2 SWEep TIME 2 76 This command sets or gueries the sweep time for the sweep for the specified channel The sweep time does not include hold time and return time The setting range is 1 ms to 300 s AFG3000 Series Arbitrary Function Generator Programmer Manual Group Syntax Arguments Returns Examples Command Descriptions Source SOURCe 1 2 SwEep TIME lt seconds gt MINimum M
16. A ka vie ane iva A ka ovala obn ej obe kle alaa 2 1 Command Syntax 4 pove ba oi olje da EEA eo pena Daje o did ZE Da Pa anja a e 2 2 Backus Naur Form Definition aaa 2 2 Command and Query Structure aaa 2 2 SCPI Commands and Oueries ae 2 4 IEEE 488 2 Common Commands ccc eee aaa 2 9 Command Groups vesna nujni bov e di RV on ences SEE EN SA ea Gowns enensad 2 11 Command DeseriptionS nn kesan nn tn AA nih kla aa doba a de Pale e zdle a velel okoli 2 19 Status and Events Status and EVENIS s snega ENE BE AA sows dons NEO SA E E RANJE SR ee o PO aje ana 3 1 Status Reporting StruCWL engan MAN AN AA ANA A AAA ANA EO a k ea E 3 1 ROGISUGES 23 22st A EN A A IE A AAA E RA ER ON 3 3 COUCHES sij kre eo E A AA A AA ebole dd ae ne oboleli ide ea 3 12 Messages anid Code nana a SEE BAK A KA toe rea A na AAA akad 3 12 Programming Examples Programming Examples sis isti sane ei lO E O AAA EET E ET Ani 4 1 Appendices Appendix A SCPI Conformance Information errr a A 1 AFG3000 Series Arbitrary Function Generator Programmer Manual i Table of Contents ii AFG3000 Series Arbitrary Function Generator Programmer Manual Preface This manual provides operating information for the following products Table i Supported products AFG3011 AFG3021B AFG3011C AFG3101 AFG3022B AFG3021C AFG3102 AFG3022C AFG3251 AFG3051C AFG3252 AFG3052C AFG3101C
17. Condition Register Status AFG3000 Series Arbitrary Function Generator Programmer Manual 2 83 Command Descriptions Syntax Arguments Returns Examples STATUS OPERation CONDi tion None lt bit_value gt lt NR1 gt STATUS OPERATION CONDITION might return 32 which indicates that the OCR contains the binary number 00000000 00100000 and the CH 1 of the instrument is waiting for trigger STATus OPERation ENABle Group Syntax Arguments Returns Examples This command sets or queries the mask for the Operation Enable Register Status STATUS OPERation ENABle lt bit value gt STATUS OPERation ENAB1e lt bit value gt lt NR1 gt lt bit value gt STATUS OPERATION ENABLE 1 sets the CALibrating bit in the OENR to on STATus OPERation EVENt Query Only Group Syntax 2 84 This query only command returns the value in the Operation Event Register and clears the Operation Event Register Status STATUS OPERation EVENt AFG3000 Series Arbitrary Function Generator Programmer Manual Arguments Returns Examples Command Descriptions None lt NR1 gt STATUS OPERATION EVENT might return 1 which indicates that the OEVR contains the binary number 00000000 00000001 and the CALibrating bit is set to on STATus PRESet No Query Form Group Syntax Arguments Examples This command presets the SCPI status registers OENR and OENR
18. DELay 2 66 2 PULSe HOLD 2 67 2 PULSe PERiod 2 67 2 PULSe TRANsition TRAiling 2 68 2 PULSe TRANsition LEA Ding 2 68 2 PULSe WIDTh 2 69 2 PWM INTernal FREQuency 2 70 2 PWM INTernal FUNCtion 2 70 2 PWM INTernal FUNCtion 2 PWM SOURCce 2 72 2 PWM STATe 2 72 2 PWM DEViation DCY Cle 2 73 2 SWEep HTIMe 2 74 2 SWEep MODE 2 75 2 SWEep RTIMe 2 75 2 SWEep SPACing 2 76 2 SWEep TIME 2 76 2 VOLTage CONCurrent STATe 2 77 2 VOLTage LIMit HIGH 2 80 2 VOLTage LIMit LOW 2 81 2 VOLTage UNIT 2 82 2 VOLTage LEVel IMMediate 2 VOLTage LEVel IMMediate 78 2 VOLTage LEVel IMMediate 2 79 2 VOLTage LEVel IMMediate AMPLitude 2 80 SOURce lt 3 4 gt POWer LEVel IMMediate AMPLitude 2 64 SRE 2 83 AFG3000 Series Arbitrary Function Generator Programmer Manual SRER 3 11 standard event status register 3 5 status byte register 3 4 status reporting structure 3 1 STATus OPERation CONDition 2 83 STATus OPERAation ENABle 2 84 STATus OPERation EVENt 2 84 STATus PRESet 2 85 STATus QUEStionable CONDition 2 85 STATus OUEStionable ENA Ble 2 86 STATus QUEStionable EVENt 2 86 STB 2 87 SY STem BEEPer STATe 2 87 SY STem BEEPer IMMediate 2 87 SYSTem ERRor NEXT 2 88 SYSTem KCLick STATe 2 89 SY STem K LLOCk STATe 2 89 SY STem PA SSword C DISable 2 90 SYSTem PASSword NEW 2 91 S
19. DISPLAY SAVER IMMEDIATE sets the screen saver state to ON AFG3000 Series Arbitrary Function Generator Programmer Manual 2 23 Command Descriptions DISPlay SAVer STATe Group Syntax Related Commands Arguments Returns Examples This command sets or gueries the screen saver setting of the LCD display When enabled the screen saver function starts automatically if no operations are applied to the instrument front panel for five minutes Display DISPlay SAVer STATe 4ON OFF lt NR1 gt DISPlay SAVer STATe DISPlay SAVer IMMediate ON or lt NR1 gt 0 enables the screen saver function OFF or lt NR1 gt 0 disables the screen saver function lt NR1 gt indicating the screen saver state DISPLAY SAVER STATE OFF disables the screen saver function DISPlay WINDow TEXT DATA Group Syntax Arguments 2 24 The DISPlay WINDow TEXT DATA command displays a text message on the instrument screen The DISPlay WINDow TEXT DATA guery returns the text string currently displayed on the instrument screen The displayable characters are ASCII codes 32 through 126 and the instrument can display approximately 64 characters Display DISPlay WINDow TEXT DATA lt string gt DISPlay WINDow TEXT DATA lt string gt AFG3000 Series Arbitrary Function Generator Programmer Manual Returns Examples Command Descriptions lt string gt which is the currently di
20. ED SS Technical Specifications Reference and performance Ga verification T procedures ArbExpress Waveform creation ex Software CD Import waveforms Cy from oscilloscope or PC Tektronix com AFG3000 Series Arbitrary Function Generator Programmer Manual Getting Started Getting Started To help you get started with programming the arbitrary function generator this section includes the following subsections u Overview of the Manual Summarizes each major section of this manual Connecting the Interface Describes how to physically connect the arbitrary function generator to a controller m Using the GPIB Port Describes how to use the GPIB port Setting the GPIB Address Describes how to set the GPIB parameters from the front panel um Using TekVISA Describes how to use the TekVISA communication protocol Overview of the Manual Syntax and Commands The information contained in each major section of this manual is described below Syntax and Commands describes the structure and content of the messages your program sends to the arbitrary function generator The following figure shows command parts as described in the Command Syntax subsection Command parts Header Space A ia i CALCulate MARKer MODE ABSolute N Mnemonics Argument Figure 1 1 Command parts AFG3000 Series Arbitrary Function Generator Programmer Manual 1 1 Getting Started CALCulate Comm
21. Function Generator Programmer Manual Getting Started 1631 080 Figure 1 3 GPIB connector rear panel Using the GPIB Port The arbitrary function generator has Talk Listen functions through which it can communicate with other devices as well as the external controller located on the bus GPIB cable ojooo Seng ogge 70 alojadDocoo eC A oooooooll L T Controller Using the generator as a talker or listener co Figure 1 4 GPIB connection GPIB Requirements Observe the following rules when you use your arbitrary function generator with a GPIB network Assign a unique device address to each device on the bus No two devices can share the same device address Do not connect more than 15 devices to any one bus m Connect one device for every 2 m 6 ft of cable used Do not use more than 20 m 65 ft of cable to connect devices to a bus Turn on at least 2 3 of the devices on the network while using the network Connect the devices on the network in a star or linear configuration as shown in the following figure Do not use loop or parallel configurations AFG3000 Series Arbitrary Function Generator Programmer Manual 1 3 Getting Started GPIB Device GPIB Device GPIB Device GPIB Device GPIB
22. Function Generator Programmer Manual 2 71 Command Descriptions Examples SOURCe1 PWM INTernal FUNCtion EFILe SAMPLE1 creates a file named SAMPLE1 in the mass storage SOURce 1 2 PWM SOURce Group Syntax Arguments Returns Examples This command sets or gueries the source of modulating signal of PWM modulation for the specified channel Source SOURce 1 2 PWM SOURce INTernal EXTernal SOURce 1 2 PWM SOURce INTernal means that the carrier waveform is modulated with the internal source EXTernal means that the carrier waveform is modulated with an external source INT EXT SOURCe1 PWM SOURCe INTernal sets the source of modulating signal on CH 1 to internal SOURce 1 2 PWM STATe Group Syntax Arguments Returns 2 72 This command enables or disables PWM modulation The query command returns the state of PWM modulation You can select only pulse waveform as a carrier waveform for PWM Source SOURCe 1 2 PWM STATe 4ON OFF lt NR1 gt SOURce 1 2 PWM STATE ON or lt NR1 gt 40 enables PWM modulation OFF or lt NR1 gt 0 disables PWM modulation lt NR1 gt AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions Examples SOURCe1 PWM STATe ON enables the CH 1 PWM modulation SOURce 1 2 PWM DEViation DCYCle This command sets or gueries the PWM deviation in percent for the specified channel The setting
23. HOLD Set guery pulse waveform parameter SOURce 1 2 PULSe PERiod Set query pulse waveform period SOURCe 1 2 PULSe TRANSition LEADing Set guery pulse waveform leading edge time SOURce 1 2 PULSe TRANsition TRAiling Set query pulse waveform trailing edge time SOURce 1 2 PULSe WIDTh Set guery pulse waveform width SOURce 1 2 PWM INTernal FREQuency Set query pulse width modulation frequency SOURce 1 2 PWM INTernal FUNCtion Set query pulse width modulation waveform SOURce 1 2 PWM INTernal FUNCtion EFILe Set guery EFILe name SOURce 1 2 PWM SOURce Set guery pulse width modulation source SOURcef1 2 PWM STATe Set query pulse width modulation status SOURcef1 2 PWM DEViation DCYCle Set query pulse width modulation deviation SOURce 1 2 SWEep HTIMe Set query sweep hold time SOURce 1 2 SWEep MODE Set query sweep mode SOURCe 1 2 SWEep RTIMe Set guery sweep return time SOURce 1 2 SWEep SPACing Set guery sweep spacing SOURce 1 2 SWEep TIME Set guery sweep time SOURce 1 2 VOLTage CONCurrent STATe Set guery concurrent change of amplitude level SOURce 1 2 VOLTage LIMit HIGH Set query output amplitude upper limit SOURce 1 2 VOLTage LIMit LOW Set query output amplitude lower limit SOURce 1 2 VOLTage UNIT Set query output amplitude units SOURce 1 2
24. OPC Arguments None Examples WAI prevents the instrument from executing any further commands or queries until all pending commands that generate an OPC message are complete 2 102 AFG3000 Series Arbitrary Function Generator Programmer Manual Status and Events Status and Events This section provides details about the status information and events the arbitrary function generator reports Status Reporting Structure The arbitrary function generator status reporting functions conform to IEEE 488 2 and SCPI standards Use the status reporting function to check for instrument errors and to identify the types of events that have occurred on the instrument shows an outline of the instrument error and event reporting function The error and event reporting system consists of the following three blocks um Standard Event Status E Operation Status Questionable Status The operations processed in these blocks are summarized in status bytes which provide the error and event data AFG3000 Series Arbitrary Function Generator Programmer Manual 3 1 Status and Events STATus OUEStionable CONDition STATus OUEStionable EVENt STATus QUEStionable ENABle lt bit value gt Questionable Status Block FREQuency 1 Overheat Protection OCR OEVR OENR OCR OEVR OENR CALibrating Operation Status Block Waiting for TRIGger CH1 Borang Waiti
25. Responses The query causes the arbitrary function generator to return information about its status or settings When a query is sent to the arbitrary function generator only the values are returned When the returned value is a mnemonic it is noted in abbreviated format as shown in the following table Parameter Types Every parameter in the command and query descriptions is of a specified type The parameters are enclosed in brackets such as lt value gt The parameter type is listed after the parameter and is enclosed in parentheses for example boolean Some parameter types are defined specifically for the arbitrary function generator command set and some are defined by SCPI AFG3000 Series Arbitrary Function Generator Programmer Manual 2 5 Command Syntax Special Characters Abbreviating Commands Queries and Parameters 2 6 Table 2 4 Parameter types used in syntax descriptions Parameter type Description Example arbitrary block A specified length of 512234xxxxx where arbitrary data 5 indicates that the following 5 digits 12234 specify the length of the data in bytes XXXXX indicates the data or OXxxxx lt LF gt lt amp EOI gt boolean Boolean numbers or values ON or 0 OFF or 0 discrete a LIST OF SPECIFIC VALUES min max binary Binary numbers B0110 octal Octal numbers 057 03 hexadecimal 2 Hexadecimal numbers HHAA H1 0 9 A B C D E F NR1 2 numeric Integers 0 1 15
26. SRER Bit 6 must be set to 0 shows the SRER functions 6 7 ROS 5 4 3 2 1 0 OSB 6 ESB MAV OSB EQS MSS Figure 3 7 Service Reguest Enable Register SRER Operation Enable Register OENR The OENR consists of bits defined exactly the same as bits 0 through 15 in the OEVR see You can use this register to control whether or not the Operation Status Bit OSB in the SBR is set when an event occurs and the corresponding OEVR bit is set Use the STATus OPERation ENABle command to set the bits in the OENR Use the STATus OPERation ENABle query to read the contents of the OENR 8 5 WTRIG WTRIG SWE CAL CH2 CH1 Figure 3 8 Operation Enable Register OENR Questionable Enable Register QENR The QENR consists of bits defined exactly the same as bits 0 through 15 in the QEVR register see You can use this register to control whether the QSB in the SBR is set when an event occurs and the corresponding QEVR bit is set Use the STATus QUEStionable ENABle command to set the bits in the QENR Use the STATus QUEStionable ENABle query to read the contents of the QENR AFG3000 Series Arbitrary Function Generator Programmer Manual 3 11 Status and Events Queues Output Queue Error Event Queue Messages and Codes 11 OVHP 5 4 FREQ Fig
27. Source SOURce 1 2 VOLTage UNIT VPP VRMS DBM SOURce 1 2 VOLTage UNIT LSOURce 1 2 WOLTage CONCurrent STATe LSOURce 1 2 VOLTage LEVel IMMediate A MPLitude VPP sets the units of the output voltage to Vp p VRMS sets the units of the output voltage to Vrms DBM sets the units of the output voltage to dBm You cannot specify DBM if the load impedance is set to infinite AFG3000 Series Arbitrary Function Generator Programmer Manual Returns Examples SRE Group Syntax Related Commands Arguments Returns Examples Command Descriptions VPP VRMS DBM SOURcel VOLTage UNIT VPP sets the voltage units to Vp p This command sets and queries the bits in the Service Request Enable Register SRER Status SRE lt bit_value gt SRE PSC lt bit value gt lt NR1 gt where lt NR1 gt is a value in the range from 0 through 255 The binary bits of the SRER are set according to this value Using an out of range value causes an execution error The power on default for SRER is 0 if PSC is set to 1 If PSC is set to 0 the SRER maintains the previous power cycle value through the current power cycle lt bit value gt SRE48 sets the bits in the SRER to binary 00110000 SRE might return 32 showing that the bits in the SRER have the binary value of 00100000 STATus OPERation CONDition Query Only Group This query only command returns the contents of the Operation
28. This command sets or gueries the lower limit of the output amplitude low level for the specified channel If your instrument is a dual channel model and the SOURce 1 2 VOLTage CONCurrent STATe command is set to ON then the low level lower limit of the other channel is the same value Source SOURce 1 2 VOLTage LIMit LOW 4 lt voltage gt MINimum MAXimumj SOURce 1 2 VOLTage LIMit LOW LSOURce 1 2 VOLTage CONCurrent STATe lt voltage gt lt NRf gt lt units gt where AFG3000 Series Arbitrary Function Generator Programmer Manual 2 81 Command Descriptions Returns Examples lt NRf gt is the lower limit of output amplitude lt units gt mV V lt voltage gt SOURcel VOLTage LIMit LOW 10mv sets the lower limit of CH 1 output amplitude to 10 mV SOURce 1 2 VOLTage UNIT 2 82 Group Syntax Related Commands Arguments This command sets or queries the units of output amplitude for the specified channel This command does not affect the offset High level or Low level of output The setting of this command is not affected by the units setting of SOURce 1 2 WOLTage LE Vel MMediate AMPLitude command Or NAGO P dBm 10 x log 0 001 V2 P rms Rr Rz load impedance Vims Yop triangle 2 3 If your instrument is a dual channel model and the SOURce 1 2 VOLTage CONCurrent STATe command is set to ON then the units of the other channel are set the same
29. This command sets or queries the symmetry of ramp waveform for the specified channel The setting range is 0 0 to 100 0 Source SOURCe 1 2 FUNCtion RAMP SYMMetry lt symmetry gt MINimum MAXimum SOURce 1 2 FUNCtion RAMP SYMMetry lt symmetry gt lt NR2 gt lt units gt where lt NR2 gt is the symmetry lt units gt PCT lt symmetry gt SOURcel FUNCtion RAMP SYMMetry 80 5 sets the symmetry of the CH 1 ramp waveform to 80 5 SOURce 1 2 FUNCtion SHAPe Group Syntax 2 58 This command sets or queries the shape of the output waveform When the specified user memory is deleted this command causes an error if you select the user memory Source SOURce 1 2 FUNCtion SHAPe SINusoid SQUare PULSe RAMP PRNoise DC SINC GAUSsian LORentz ERISe EDECay HAVersine USER 1 USER2 USER3 USER4 EMEMory EFILe SOURce 1 2 FUNCtion SHAPe AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions Arguments SINusoid SOUare PULSe RAMP PRNoise DCJSINC GAUSsian LORentz ERISe EDECay HAVersine The following table shows the combination of modulation type and the shape of output waveform Sine Square Ramp Arb Sin x x Gaussian Lorentz Exponential Rise Exponential Decay Haversine Pulse Noise DC AM Ni FM Ni PM V FSK V PWM NI Sweep y Burst V NI If you select a waveform shape that is not allowed with a parti
30. of output frequency lt units gt RAD DEG If lt units gt are omitted RAD is specified automatically The setting ranges are RAD 1 PI to 1 PI relative to phase value DEG 180 to 180 relative to phase value lt phase gt SOURcel PHASe ADJust MAXimum sets the maximum value for the phase of CH 1 output frequency SOURce 1 2 PHASe INITiate No Query Form 2 60 Group Syntax Arguments Examples This command synchronizes the phase of CH 1 and CH 2 output waveforms The arbitrary function generator performs the same operation if you specify either SOURcel or SOURce2 If your arbitrary function generator is single channel model this command is not supported Source SOURce 1 2 PHASe INITiate None SOURCE 1 2 PHASE INITTATE synchronizes the phase of CH 1 and CH 2 output signals AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions SOURce 1 2 PM DEViation Group Syntax Arguments Returns Examples This command sets or queries the peak frequency deviation of PM modulation for the specified channel Source SOURCe 1 2 PM DEViation 4 lt deviation gt MINimum MAXimum SOURce 1 2 PM DEViation lt deviation gt lt NR3 gt lt units gt where lt NR3 gt is the phase deviation lt units gt RAD DEG If lt units gt are omitted RAD is specified automatically The setting ranges are RAD 0 PI to 1 PI relative
31. or the EFILe is not yet defined this command causes an error Source SOURce 1 2 AM INTernal FUNCtion SINusoid SQUare TRIangle RAMP NRAMp PRNoise USER 1 USER2 USER3 USER4 EMEMory EFILe SOURce 1 2 AM INTernal FUNCtion SOURce 1 2 AM SOURce SOURce 1 2 AM INTernal FUNCtion EFILe SINusoid SOUare TRIangle RAMP NRAMp PRNoi se One of six types of function waveform can be selected as a modulating signal AFG3000 Series Arbitrary Function Generator Programmer Manual 2 41 Command Descriptions Returns Examples USER 1 USER2 USER3 USER4 EMEMory A user defined waveform saved in the user waveform memory or the EMEMory can be selected as a modulating signal EFILe EFILe is used as a modulating signal SIN SQU TRI RAMP NRAM PRN USER1 USER2 USER3 USER4 EMEMory EFILe SOURCe1 AM INTernal FUNCtion SQUare selects Square as the shape of modulating waveform for the CH 1 output SOURce 1 2 AM INTernal FUNCtion EFILe Group Syntax Arguments Returns Examples This command sets or gueries an EFILe name used as a modulating waveform for AM modulation A file name must be specified in the mass storage system This command returns if there is no file in the mass storage Source SOURCe 1 2 AM INTernal FUNCtion EFILe lt file name gt SOURce 1 2 AM INTernal FUNCtion EFILEe lt file name gt lt string gt specifies a file name in t
32. power the arbitrary function generator will automatically recall the settings you used when you powered off the instrument If you select OFF the default setups are recalled when you power on the instrument Memory MEMory STATe RECall AUTO ON OFF lt NR1 gt MEMory STATe RECal1 AUTO OFF or lt NR1 gt 0 disables the last setup recall function ON or lt NR1 gt 0 enables the recall of the setup memory last used before the instrument was powered off lt NR1 gt MEMORY STATE RECALL AUTO ON sets the instrument to recall the last setup memory when powered on MEMory STATe VALid Query Only Group Syntax Arguments Returns This command returns the availability of a setup memory Memory MEMory STATe VALid 0 1 2 3 4 0 1 2 3 or 4 specifies the location of setup memory lt NR1 gt 1 means that the specified setup memory has been saved 0 means that the specified setup memory has been deleted AFG3000 Series Arbitrary Function Generator Programmer Manual 2 29 Command Descriptions Examples MEMORY STATE VALID 0 might return 1 if the specified setup memory has been saved MMEMory CATalog Query Only Group Syntax Related Commands Arguments Returns Examples MMEMory CDIRectory Group Syntax 2 30 This query only command returns the current state of the mass storage system USB memory Mass Memory MMEMory CATalog MMEMory CDIRectory None
33. remain stable after reaching the stop frequency Source SOURce 1 2 SWEep HTIMe lt seconds gt MINimum MAXimum SOURce 1 2 SWEep HTIMe lt seconds gt lt NRf gt lt units gt where lt NRf gt is the hold time in seconds lt units gt ns us ms s lt seconds gt SOURCe1 SWEep HTIMe 1ms sets the CH 1 hold time to 1 ms AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions SOURce 1 2 SWEep MODE The SOURce 1 2 SWEep MODE command selects auto or manual for the sweep mode for the specified channel The query command returns the sweep mode for the specified channel Group Source Syntax SOURce 1 2 SWEep MODE AUTO MANual SOURCe 1 2 SwEep MODE Related Commands SOURce 1 2 SWEep HTIMe SOURce 1 2 SWEep RTIMe SOUR ce 1 2 SWEep TIME TRIGger SEQuence SOURce TRIGger SEQuence TIMer Arguments AUTO sets the sweep mode to auto The instrument outputs a continuous sweep at a rate specified by Sweep Time Hold Time and Return Time MANual sets the sweep mode to manual The instrument outputs one sweep when a trigger input is received Returns AUTO MAN Examples SOURCe1 SWEep MODE AUTO sets the CH1 sweep mode to auto The instrument outputs a continuous sweep SOURce 1 2 SWEep RTIMe This command sets or queries the sweep return time Return time represents the amount of time from stop frequency through start frequency Return time does
34. the modulation depth to maximum value lt depth gt SOURCe1 AM DEPth MAXimum sets the depth of modulating signal on CH 1 to the maximum value SOURce 1 2 AM INTernal FREQuency 2 40 This command sets or queries the internal modulation frequency of AM modulation for the specified channel You can use this command only when the internal modulation source is selected You can set the internal modulation frequency from 2 mHz to 50 00 kHz with resolution of 1 mHz You can select the source of modulating signal by using the SOURce 1 2 AM SOURce INTernal EXTernal command AFG3000 Series Arbitrary Function Generator Programmer Manual Group Syntax Related Commands Arguments Returns Examples Command Descriptions Source SOURCe 1 2 AM INTernal FREQuency lt frequency gt MINimum MAXimum SOURce 1 2 AM INTernal FREQuency SOURce 1 2 AM SOURce lt frequency gt lt NRf gt lt units gt where lt NRf gt is the modulation frequency lt units gt Hz kHz MHz lt frequency gt SOURCeL AM INTernal FREQuency 10kHz sets the CH 1 internal modulation frequency to 10 kHz SOURce 1 2 AM INTernal FUNCtion Group Syntax Related Commands Arguments This command sets or gueries the modulating waveform of AM modulation for the specified channel You can use this command only when the internal modulation source is selected If you specify EFILe when there is no EFILe
35. using the STB query this bit is called the Master Status Summary MSS bit and indicates that the instrument has issued a service request for one or more reasons The MSS bit is never cleared to 0 by the STB query 5 ESB Event Status Bit This bit indicates whether or not a new event has occurred after the previous Standard Event Status Register SESR has been cleared or after an event readout has been performed 4 MAV Message Available Bit This bit indicates that a message has been placed in the output queue and can be retrieved 3 QSB 2 EQS Questionable Status Bit Error Event Queue Summary 1 0 Not used Standard Event Status Register SESR The SESR records eight types of events that can occur within the instrument as shown in 7 6 5 4 3 2 1 0 PON URA CME EXE DDE QYE RQC OPC Figure 3 3 The Standard Event Status Register SESR AFG3000 Series Arbitrary Function Generator Programmer Manual 3 5 Status and Events Table 3 2 SESR bit functions Bit Function 7 MSB PON Power On Indicates that the power to the instrument is on 6 URQ User Request Indicates that an application event has occurred The arbitrary function generator does not use this bit 5 CME Command Error Indicates that an error occurred while the arbitrary function generator was parsing a command or query 3 6 AFG3000 Series
36. 05 Self test failed CH1 Output gain 2306 Self test failed CH2 Output gain 2401 Self test failed CH1 x 3 dB attenuator 2402 Self test failed CH2 x 3 dB attenuator 2403 Self test failed CH1 x 6 dB attenuator 2404 Self test failed CH2 x 6 dB attenuator 2405 Self test failed CH1 x 10 dB attenuator 2406 Self test failed CH2 x 10 dB attenuator 2407 Self test failed CH1 x 20 dB 1 attenuator 2408 Self test failed CH2 x 20 dB 1 attenuator 2409 Self test failed CH1 x 20 dB 2 attenuator 2410 Self test failed CH2 x 20 dB 2 attenuator 2411 Self test failed CH1 Filter 2412 Self test failed CH2 Filter 2413 Self test failed CH1 x 20 dB 3 attenuator 2501 Self test failed CH1 Sine Flatness 2502 Self test failed CH2 Sine Flatness 9112 Waveform error invalid waveform length 9113 Waveform error waveform length is too short AFG3000 Series Arbitrary Function Generator Programmer Manual Status and Events 3 20 AFG3000 Series Arbitrary Function Generator Programmer Manual Programming Examples Programming Examples The following two example programs demonstrate methods that you can use to control the arbitrary function generator through the General Purpose Interface Bus GPIB m Example 1 Set up a Waveform Output m 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 Tek VISA and a National Instruments GPIB b
37. 1 NR2 23 numeric Decimal numbers 1 2 3 141516 6 5 NR32 numeric Floating point numbers 3 1415E 9 16 1E5 NRf2 numeric Flexible decimal number that may be type NR1 NR2 or NR3 See NR1 NR2 and NR3 examples string 4 Alphanumeric characters must be within quotation marks Testing 1 2 3 1 Defined in ANSI IEEE 488 2 as Definite Length Arbitrary Block Response Data 2 An ANSI IEEE 488 2 1992 defined parameter type 3 Some commands and queries will accept an octal or hexadecimal value even though the parameter type is defined as NR1 4 Defined in ANSI IEEE 488 2 as String Response Data The Line Feed LF 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 short forms as a combination of upper and lower case letters The upper case letters indicate the accepted short form of a command As shown in the following figure you can create a short form by using only the upper case letters The accepted short form and the long form are equivalent and request the same action of the instrument AFG3000 Series Arbitrary Function Generator Programmer Manual Command Syntax Long form of a
38. 10kHz sets the CH 1 internal modulation frequency to 10 kHz SOURce 1 2 FM INTernal FUNCtion 2 48 Group Syntax Related Commands Arguments This command sets or queries the modulating waveform of FM modulation for the specified channel You can use this command only when the internal modulation source is selected If you specify EFILe when there is no EFILe or the EFILe is not yet defined this command causes an error Source SOURCe 1 2 FM INTernal FUNCtion SINusoid SQuare TRIangle RAMP NRAMp PRNoise USER 1 USER2 USER3 USER4 EMEMory EFILe SOURce 1 2 FM INTernal FUNCtion SOURce 1 2 FM SOURce SINusoid SQUare TRIangle RAMP NRAMp PRNoise One of six types of function waveform can be selected as a modulating signal USER 1 USER2 USER3 USER4 EMEMory A user defined waveform saved in the user waveform memory or the EMEMory can be selected as a modulating signal EFILe AFG3000 Series Arbitrary Function Generator Programmer Manual Returns Examples Command Descriptions EFILe is used as a modulating signal SIN SQU TRI RAMP NRAM PRN USER1 USER2 USER3 USER4 EMEMory EFILe SOURCe1 FM INTernal FUNCtion SQUare selects Square as the shape of modulating waveform for the CH 1 output SOURce 1 2 FM INTernal FUNCtion EFILe Group Syntax Arguments Returns Examples This command sets or gueries an EFILe name used as a modulating waveform for FM mod
39. 2 BURSt STATe ON or lt NR1 gt 0 enables the burst mode OFF or lt NR1 gt 0 disables the burst mode lt NR1 gt SOURCe1 BURSt STATe ON enables the burst mode for the CH 1 SOURce 1 2 BURSt TDELay Group Syntax Arguments This command sets or queries delay time in the burst mode for the specified channel It specifies a time delay between the trigger and the signal output This command is available only in the Triggered burst mode The setting range is 0 0 ns to 85 000 s with resolution of 100 ps or 5 digits Source SOURCe 1 2 BURSt TDELay lt delay gt MINimum MAXimum SOURce 1 2 BURSt TDELay lt delay gt lt NRf gt lt units gt where lt units gt s ms us ns MINimum sets the delay time to minimum value MAXimum sets the delay time to maximum value AFG3000 Series Arbitrary Function Generator Programmer Manual 2 45 Command Descriptions Returns Examples lt delay gt SOURCe1 BURSt DELay 20ms sets the CH 1 delay time to 20 ms SOURce 1 2 COMBine FEED 2 46 Group Syntax Related Commands Arguments Returns Examples This command sets or gueries whether to add the internal noise or an external signal to an output signal for the specified channel When you specify the internal noise you can set or guery the noise level by SOURce lt 3 4 gt POWer LEVel IMMediate A MPLitude command 6699 To disable the internal noise add or the exte
40. 2 x 6 dB attenuator 1205 Calibration failed CH1 x 10 dB attenuator 1206 Calibration failed CH2 x 10 dB attenuator 1207 Calibration failed CH1 x 20 dB 1 attenuator 1208 Calibration failed CH2 x 20 dB 1 attenuator 1209 Calibration failed CH1 x 20 dB 2 attenuator 1210 Calibration failed CH2 x 20 dB 2 attenuator 1211 Calibration failed CH1 Filter 1212 Calibration failed CH2 Filter 1213 Calibration failed CH1 x 20 dB 3 attenuator 1301 Calibration failed CH1 Sine Flatness 1302 Calibration failed CH2 Sine Flatness 1401 Calibration failed CH1 ASIC TINT 1402 Calibration failed CH2 ASIC TINT 1403 Calibration failed CH1 ASIC SGEN 1404 Calibration failed CH2 ASIC SGEN 1405 Calibration failed CH1 ASIC clock duty 1406 Calibration failed CH2 ASIC clock duty 2100 Self test failed Calibration data not found 2101 Self test failed Calibration data checksum 2102 Self test failed Calibration data invalid 2201 Self test failed ASIC 1 memory 2202 Self test failed ASIC 2 memory 2203 Self test failed ASIC 1 overheat 2204 Self test failed ASIC 2 overheat 3 18 AFG3000 Series Arbitrary Function Generator Programmer Manual Table 3 14 Device errors cont Status and Events Error code Error message 2301 Self test failed CH1 Internal offset 2302 Self test failed CH2 Internal offset 2303 Self test failed CH1 Output offset 2304 Self test failed CH2 Output offset 23
41. 84 Program currently running 285 Program syntax error 286 Program runtime error 290 Memory use error 291 Out of memory 292 Referenced name does not exist 293 Referenced name already exists 294 Incompatible type Device Specific Errors lists the device specific errors that can occur during arbitrary function generator operation These errors may indicate that the instrument needs repair Table 3 8 Device specific error messages Error code Message 300 Device specific error 310 System error 311 Memory error 312 PUD memory lost 313 Calibration memory lost 314 Save recall memory lost 315 Configuration memory lost 320 Storage fault 321 Out of memory 330 Self test failed 340 Calibration failed 350 Oueue overflow 360 Communication error 361 Parity error in program message 362 Framing error in program message 363 Input buffer overrun 365 Time out error 3 16 AFG3000 Series Arbitrary Function Generator Programmer Manual Status and Events Query Errors lists the error codes that are returned in response to an unanswered query Table 3 9 Query errors Error codes Message 400 query error 410 query INTERRUPTED 420 query UNTERMINATED 430 query DEADLOCKED 440 query UNTERMINATED after indefinite response Power on Events These events occur when the instrument detects an off to on transition in its power supply
42. AFG3000 Series Arbitrary Function Generators Programmer Manual HAN KN NN KN AN Tektronix 077 0743 00 AFG3000 Series Arbitrary Function Generators Programmer Manual www tektronix com Tektronix 077 0743 00 Copyright Tektronix All rights reserved Licensed software products are owned by Tektronix or its subsidiaries or suppliers and are protected by national copyright laws and international treaty provisions Tektronix products are covered by U S and foreign patents issued and pending Information in this publication supersedes 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 14150 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 Warranty Tektronix warrants that the product will be free from defects in materials and workmanship for a period of three 3 years from the date of original purchase from an authorized Tektronix distributor If the 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 Batteries are excluded fr
43. AXimum SOURce 1 2 SWEep TIME lt seconds gt lt NRf gt lt units gt where lt NRf gt is the sweep time in seconds lt units gt ns us ms s lt seconds gt SOURCe1 SWEep TIME 100ms sets the CH 1 sweep time to 100 ms SOURce 1 2 VOLTage CONCurrent STATe Group Syntax Arguments Returns This command enables or disables the function to copy the voltage level of one channel to another channel The SOURce 1 2 VOLTage CONCurrent STATe command copies the voltage level of the channel specified by the header suffix to another channel If you specify CH 1 with the header the CH 1 voltage level will be copied to CH 2 The query command returns 0 off or 1 on If your arbitrary function generator is a single channel model this command is not supported Source SOURce 1 2 VOLTage CONCurrent STATe ON OFF lt NR1 gt SOURce 1 2 VOLTage CONCurrent STATe ON or lt NR1 gt 70 enables the concurrent copy function OFF or lt NR1 gt 0 disables the concurrent copy function lt NR1 gt AFG3000 Series Arbitrary Function Generator Programmer Manual 2 77 Command Descriptions Examples SOURcel VOLTage CONCurrent STATe ON enables the concurrent copy function SOURce 1 2 VOLTage LEVel IMMediate HIGH Group Syntax Related Commands Arguments Returns Examples This command sets or gueries the high level of output amplitude for the
44. Arbitrary Function Generator Programmer Manual Table 3 2 SESR bit functions cont Bit Function Status and Events 4 EXE Execution Error Indicates that an error occurred while the arbitrary function generator was executing a command or query Execution errors occur for one of the following reasons A value designated in the argument is outside the allowable range of the instrument or is in conflict with the capabilities of the instrument m The command was not executed properly because the conditions for execution is differed from those required 3 DDE Device Error An instrument error has been detected AFG3000 Series Arbitrary Function Generator Programmer Manual Status and Events 3 8 Table 3 2 SESR bit functions cont Bit Function 2 QYE Query Error Indicates that a query error has been detected by the output queue controller Query errors occur for one of the following reasons Anattempt was made to retrieve messages from the output queue when the output queue is empty or in pending status m The output queue message was cleared while it was being retrieved from the output queue 1 RQC Request Control The arbitrary function generator does not use this bit 0 OPC Operation Complete Indicates that the operation is complete This bit is set when all pending operations complete following the OPC command Ope
45. Command Descriptions This command sets or query whether to enable the arbitrary function generator output for the specified channel Output OUTPUut 1 2 STATe 0N OFF lt NR1 gt OUTPUtT 1 2 STATe ON or lt NR1 gt 0 enables the arbitrary function generator output OFF or lt NR1 gt 0 disables the arbitrary function generator output lt NRI gt OUTPUTL STATE ON sets the arbitrary function generator CH 1 output to ON OUTPut TRIGger MODE Group Syntax Arguments This command sets or gueries the mode trigger or sync for Trigger Output signal When the burst count is set to Inf Cycles in burst mode TRIGger indicates that the infinite number of cycles of waveform will be output from the Trigger Output connector When the burst count is set to Inf Cycles in burst mode SYNC indicates that one pulse waveform is output from the Trigger Output connector when the Inf Cycles starts When Run Mode is specified other than Burst Inf Cycles TRIGger and SYNC have the same effect Output OUTPut TRIGger MODE TRIGger SYNC OUTPut TRIGger MODE TRIGger means TRIGger is selected for Trigger Out SYNC means SYNC is selected for Trigger Out AFG3000 Series Arbitrary Function Generator Programmer Manual 2 37 Command Descriptions PSC RCL No Query Form 2 38 Returns Examples Group Syntax Arguments Returns Examples Group Syntax TRIG SYNC OUTPUT TRIGGER MODE SYNC out
46. Descriptions SOURcel FSKey SOURce INTernal sets the CH 1 source of modulating signal to internal SOURce 1 2 FSKey STATe Group Syntax Arguments Returns Examples This command enables or disables FSK modulation The query command returns the state of FSK modulation You can select a sine square ramp or arbitrary waveform for the carrier waveform Source SOURCe 1 2 FSKey STATe 4ON OFF lt NR1 gt SOURce 1 2 FSKey STATe ON or lt NR1 gt 40 enables FSK modulation OFF or lt NR1 gt 0 disables FSK modulation lt NR1 gt SOURCe1 FSKey STATe ON enables the CH 1 FSK modulation SOURce 1 2 FUNCtion EFILe Group Syntax Arguments Returns This command sets or gueries an EFILe name used as an output waveform A file name must be specified in the mass storage system This command returns if there is no file in the mass storage Source SOURCe 1 2 FUNCtion EFILe lt file name gt SOURCe 1 2 FUNCtion EFILe lt file_name gt lt string gt specifies a file name in the mass storage system The lt file_name gt includes path Path separators are forward slashes lt file_name gt AFG3000 Series Arbitrary Function Generator Programmer Manual 2 57 Command Descriptions Examples SOURCe1 FUNCtion EFILe SAMPLE1 sets a file named SAMPLE1 in the mass storage SOURce 1 2 FUNCtion RAMP SYMMetry Group Syntax Arguments Returns Examples
47. Device GPIB Device Figure 1 5 Typical GPIB network configurations GPIB Device Setting the GPIB Address Using TekVISA When you use the GPIB port to communicate with an external controller follow these steps to set the address of the arbitrary function generator 1 Press the Utility button 2 Press the I O Interface button 3 Press the GPIB button 4 Press the Address button 5 Turn the general purpose knob to set the GPIB Address The GPIB address must be from 0 to 30 6 Press the Return to top menu button when you have set the GPIB address to save the setting 7 Press the Configuration button to toggle the instrument communications to Talk Listen to remotely control the instrument from an external host computer NOTE The GPIB address cannot be initialized by the RST command TekVISA is Tektronix implementation of VISA Virtual Instrument Software Architecture an industry standard communication protocol VISA provides a common standard for software developers so that software from multiple vendors such as instrument drivers can run on the same platform TekVISA is industry compliant software available with selected Tektronix instruments You can use this software to write or draw interoperable instrument drivers in a variety of Application Development Environments ADEs It implements a subset of Version 2 2 of the VISA specification for controlling GPIB and serial RS 232 instrument int
48. FREQuency bit is set to on AFG3000 Series Arbitrary Function Generator Programmer Manual STB Query Only Group Syntax Arguments Returns Examples Command Descriptions This query only command returns the contents of the Status Byte Register SBR using the Master Summary Status MSS bit Status STB None lt NR1 gt STB might return 96 showing that the SBR contains the binary value 01100000 SYSTem BEEPer IMMediate No Query Form Group Syntax Arguments Examples This command causes the instrument to beep immediately System SYSTem BEEPer IMMediate None SYSTEM BEEPER IMMEDIATE causes a beep SYSTem BEEPer STATe The SYSTem BEEPer STATe command sets the beeper ON or OFF The SY STem BEEPer STATe command returns 0 OFF or 1 ON When the beeper is set to ON the instrument will beep when an error message or a warning message is displayed on the screen The instrument does not beep when an error or warning caused by remote command execution AFG3000 Series Arbitrary Function Generator Programmer Manual 2 87 Command Descriptions Group Syntax Arguments Returns Examples System SYSTem BEEPer STATe ON OFF lt NR1 gt SYSTem BEEPer STATe ON or lt NR1 gt 0 enables the beeper OFF or lt NR1 gt 0 disables the beeper lt NR1 gt SYSTEM BEEPER STATE ON enables the beeper function SYSTem ERRor NEXT Query Only G
49. Rcel PM INTernal FUNCtion EFILe SAMPLEL sets a file named SAMPLE1 in the mass storage SOURce 1 2 PM SOURce Group Syntax This command sets or queries the source of modulation signal of PM modulation for the specified channel Source SOURCe 1 2 PM SOURCe INTernal ExTernal SOURce 1 2 PM SOURce AFG3000 Series Arbitrary Function Generator Programmer Manual 2 63 Command Descriptions Arguments Returns Examples INTernal means that the carrier waveform is modulated with an internal source EXTernal means that the carrier waveform is modulated with an external source INT EXT SOURcel PM SOURce INTernal sets the CH 1 source of modulating signal to internal SOURce 1 2 PM STATe Group Syntax Arguments Returns Examples This command enables or disables PM modulation The query command returns the state of PM modulation You can select a sine square ramp or arbitrary waveform for the carrier waveform Source SOURCe 1 2 PM STATe ON OFF lt NR1 gt SOURce 1 2 PM STATe ON or lt NR1 gt Z0 enables PM modulation OFF or lt NR1 gt 0 disables PM modulation lt NR1 gt SOURCe1 PM STATe ON enables the CH 1 PM modulation SOURce lt 3 4 gt POWer LEVel IMMediate AMPLitude 2 64 This command sets or gueries the internal noise level which applies to the output signal for the specified channel The noise level represents the percent against cur
50. SER The ESER consists of bits defined exactly the same as bits 0 through 7 in the SESR register You can use this register to control whether or not the Event Status Bit ESB in the SBR should be set when an event has occurred and to determine if the corresponding SESR bit is set To set the ESB in the SBR when the SESR bit has been set set the ESER bit corresponding to that event To prevent the ESB from being set reset the ESER bit corresponding to that event Use the ESC command to set the bits in the ESER Use the ESR guery to read the contents of the ESER shows the ESER functions AFG3000 Series Arbitrary Function Generator Programmer Manual Status and Events 7 6 5 4 3 2 1 0 PON URQ CME EXE DDE QYE ROC OPC Figure 3 6 Event Status Enable Register ESER Service Request Enable Register SRER The SRER consists of bits defined exactly the same as bits 0 through 7 in the SBR You can use this register to define which events will generate service requests The SRER bit 6 cannot be set Also the ROS is not maskable The generation of a service request with the GPIB interface involves changing the SRQ line to LOW and making a service request to the controller The result is that a status byte for which an RQS has been set is returned in response to serial polling by the controller Use the SRE command to set the bits of the SRER Use the SRE query to read the contents of the
51. SOURCe 1 2 PULSe TRANSition TRAi ling lt seconds gt MINimum MAXi mum SOURce 1 2 PULSe TRANSition TRA ling lt seconds gt lt NRf gt lt units gt where lt NRf gt is the trailing edge of pulse waveform AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions lt units gt ns us ms s Returns lt seconds gt Examples SOURCel PULSe TRANsition TRAiling 200ns sets the trailing edge time to 200 ns SOURce 1 2 PULSe WIDTh This command sets or gueries the pulse width for the specified channel Pulse Width Period co Duty Cycle 100 The pulse width must be less than the period The setting range is 0 001 to 99 999 in terms of duty cycle AFG3011 3011C 80 ns to 999 99 s u AFG3021B 3021C 3022B 3022C 16 ns to 999 99 s m AFG3051C 3052C 12 ns to 999 99 s u AFG3101 3101C 3102 3102C 8 ns to 999 99 s um AFG3251 3251C 3252 3252C 4 ns to 999 99 s Pulse Width lt Pulse Period 0 8 Leading Edge Time Trailing Edge Time Pulse Width gt 0 625 co Leading Edge Time Trailing Edge Time Group Source Syntax SOURCe 1 2 PULSe WIDTh lt seconds gt MINimum MAXimum SOURCe 1 2 PULSe WIDTh Related Commands SOURce 1 2 PULSe DCYCle Arguments lt seconds gt lt NRf gt lt units gt where lt NRf gt is the pulse width lt units gt ns us ms s Returns lt seconds gt AFG3000 Series Arbitrary Function Gen
52. STATE ON locks front panel controls AFG3000 Series Arbitrary Function Generator Programmer Manual 2 89 Command Descriptions SYSTem PASSword CDISable No Query Form Group Syntax Related Commands Arguments Examples This command disables protected commands The instrument security protection is activated In the AFG3000 Series Arbitrary Function Generators no remote commands are under the control of SYSTem PASSword commands System SYSTem PASSword CDISable lt password gt SYSTem PASSword CENable SYSTem PASSword CENable STATe SYSTem PASSword NEW lt password gt lt string gt specifies current password The string is case sensitive SYSTEM PASSWORD CDISABLE lt password gt activates the security protection SYSTem PASSword CENable No Query Form Group Syntax Related Commands Arguments 2 90 This command enables protected commands to function The instrument security protection is deactivated In the AFG3000 Series Arbitrary Function Generators no remote commands are under the control of SYSTem PASSword commands System SYSTem PASSword CENable lt password gt SY STem PA SSword CDISable SYSTem PASSword CENable STATe SYSTem PASSword NEW lt password gt lt string gt specifies current password The string is case sensitive AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions Examples SYSTEM PASSWORD CENABLE lt passw
53. VOLTage LEVel IMMediate LOW 1V sets the low level of CH 1 output amplitude to 1 V SOURce 1 2 VOLTage LEVel IMMediate OFFSet Group Syntax Related Commands Arguments Returns This command sets or gueries the offset level for the specified channel If your instrument is a dual channel model and the SOURce 1 2 VOLTage CONCurrent STATe command is set to ON then the offset level of the other channel is also the same value Source SOURce 1 2 VOLTage LEVe1 IMMediate OFFSet lt voltage gt MINimum MAXimum SOURce 1 2 VOLTage LEVe1 IMMediate OFFSet SOURce 1 2 VOLTage CONCurrent STATe lt voltage gt lt NRf gt lt units gt where lt NRf gt is the offset voltage level lt units gt mV V lt voltage gt AFG3000 Series Arbitrary Function Generator Programmer Manual 2 79 Command Descriptions Examples SOURCe1 VOLTage LEVel IMMediate OFFSet 500mv sets the CH 1 offset level to 500 mV SOURce 1 2 VOLTage LEVel IMMediate AMPLitude Group Syntax Related Commands Arguments Returns Examples This command sets or gueries the output amplitude for the specified channel Units Amplitude resolution VPP 0 1 mVp p or four digits VRMS 0 1 mVrms or four digits DBM 0 1 dBm You can set the units of output amplitude by using either the bezel menu selection or the SOURce 1 2 VOLTage UNIT command The selection by bezel menu has
54. YSTem PASSword CENable 2 90 SYSTem PASSword CENable STATe 2 91 SYSTem SECurity MMediate 2 92 SYSTem ULANguage 2 92 SYSTem VERSion 2 93 T TRACe TRACe TRACe TRACe TRACe TRACe TRACe TRACe TRACe Index DATA CATalog 2 93 DATA COPY 2 94 DATA DFEFine 2 97 DATA DELete NAME 2 97 DATA LOCK STATe 2 98 DATA POINts 2 98 DATA DATA 2 95 DATA DATA LINE 2 95 DATA DATA VALue 2 96 TRG 2 99 TRIGger SEQuence SLOPe 2 99 TRIGger SEQuence SOURCce 2 100 TRIGger SEQuence TIMer 2 100 TRIGger SEOuence IMMediate 2 101 TST 2 101 U user request events 3 17 W WAI 2 102 AFG3000 Series Arbitrary Function Generator Programmer Manual Index 3
55. amples TRACe DATA DATA Group Syntax Arguments Command Descriptions This command transfers the waveform data from the external controller to the edit memory in the arbitrary function generator The query command returns the binary block data Trace TRACe DATAL DATA EMEMory lt binary block data gt TRACE DATA DATA lt binary block data gt where lt binary block data gt is the waveform data in binary format lt binary block data gt DATA DATA EMEMory 42000 lt DAB gt lt DAB gt lt DAB gt transmits a waveform to the edit memory in the arbitrary function generator The block data element 42000 indicates that 4 is the number of digits in 2000 byte count and the 2000 bytes of binary data are to be transmitted LINE No Query Form This command writes line data to the edit memory The data between the specified points is interpolated linearly Trace TRACE DATA DATA LINE EMEMory lt start_point gt lt point_datal gt lt end point gt lt point data2 gt lt start_point gt lt NR1 gt where NR I gt is the first point from which the data is interpolated linearly lt point_datal gt lt NR1 gt where lt NRI gt is the data value at the start point AFG3000 Series Arbitrary Function Generator Programmer Manual 2 95 Command Descriptions Examples lt end_point gt lt NR1 gt where lt NRI gt is the last point from which the data is interpola
56. and has the same root node TRIGger SEQuence as the first command so these nodes can be omitted AFG3000 Series Arbitrary Function Generator Programmer Manual 2 7 Command Syntax TRIG SEQ TIM 2 5 TRIG SEO SLOP POS TRIG SEQ SOUR EXT Identical root and lower level nodes TRIG SEO TIM 2 5 SLOP POS SOUR EXT First command Additional commands omitted the root nodes REN Figure 2 4 Example of omitting root and lower level nodes in a chained message Unit and SI Prefix If the decimal numeric argument refers to amplitude frequency or time you can express it using SI units instead of using the scaled explicit point input value format lt NR3 gt SI units are units that conform to the Systeme 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 The following table lists the available units Table 2 5 Available units Symbol Meaning dB decibel relative amplitude dBm decibel absolute amplitude DEG degree phase Hz hertz freguency PCT percent S second time V volt The available SI prefixes are shown in the following table Table 2 6 Available SI prefixes SI prefix Z A F P N U M K MA G T PE EX Corresponding power 1021 1018 1015 1012 109 106 103 103 106 109 1012 10415 108 1 When the unit is Hz M may be used instead of MA so that the frequency can be represe
57. ands ABORt Commands IEEE Common Commands CAL CLS ESE ESR IDN OPC Section 2 also describes the effect of each command and provides examples of how you might use it The Command Groups subsection provides lists by functional areas The commands are listed alphabetically in the Command Descriptions section CALCulate DPSA CALCulate CONStellation CALCulate ACPower Syntax Arguments Examples Commands grouped in functional areas Commands listed alphabetically Figure 1 2 Functional groupings and an alphabetical list of commands Status and Events The program may request information from the instrument The instrument provides information in the form of status and error messages The following figure illustrates the basic operation of this system Section 3 Status and Events describes how to get status or event information from the program and details the event and error messages Your program requests status and event reports Controller The generator status and event reports GPIB cable gt Connecting the Interface The instrument has a 24 pin GPIB connector on its rear panel as shown in the following figure 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 00 to this connector AFG3000 Series Arbitrary
58. ar SYSTEM VERSION might return 1999 0 TRACe DATA CATalog Query Only Group This query only command returns the names of user waveform memory and edit memory Trace AFG3000 Series Arbitrary Function Generator Programmer Manual 2 93 Command Descriptions Syntax Arguments Returns Examples TRACe DATA CATalog None lt string gt A series of strings separated by commas is returned Each string is enclosed within guotation marks TRACE DATA CATALOG might return USER1 USER4 EMEM This example indicates that waveform data of USER2 and USER3 are deleted and not saved Edit memory always has data TRACe DATA COPY No Query Form 2 94 Group Syntax Arguments Examples This command copies the contents of edit memory or user waveform memory to a specified user waveform memory or edit memory Trace TRACe DATA COPY lt trace name gt EMEMOry TRACe DATA COPY EMEMory USER 1 USER2 USER3 USER4 lt trace_name gt USER 1 USER2 USER3 USER4 This command is invalid when lt trace_name gt is being output DATA COPY USER1 EMEMory copies the waveform data in the edit memory to the user waveform memory USERI DATA COPY EMEMory USER1 copies the waveform data in the user waveform memory USERI to the edit memory AFG3000 Series Arbitrary Function Generator Programmer Manual TRACe DATA DATA Group Syntax Arguments Returns Ex
59. as 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 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 W16 15AUG04 Table of Contents PHEPACE ib poe oi Pi keto ON lje dol poj jo ooo ie telesa ili DOCUMENTA Oh nn A spev e EN REDU o oa NA sins T AAA bek nesel lc iii Getting Started Getting Started seese eE EE E lo niji RAJE Je E Si 1 1 Overview of the Manual 22 2 0 00 ccc cece enn enn nnn EE EEE EE enn EE enn EE EES 1 1 Connecting the Interface 2ssascceiedesen ence tia saseceuedes sauna poba akne dedi de a aa a 1 2 Using the GPIB Pott san nn En A NE oven AAA A A A A adaa 1 3 Setting the GPIB Addres Seenaa rs da AA AA AAA AAA in SS 1 4 Using Tek VISA onn A bral NASA BAS NN bne Ahad oe valo poi A A add di Siah 1 4 Syntax and Commands Syntax and Commands sinu na nn sate joke a arana
60. ated Commands Arguments Returns Examples Command Descriptions Source SOURce 1 2 PwWM INTernal FUNCtion SINusoid SQUare TRIangle RAMP NRAMp PRNoise USER 1 USER2 USER3 USER4 EMOMory EFILe SOURcCe 1 2 PWM INTernal FUNCtion SOURce 1 2 PWM SOURce SINusoid SOUare TRIangle RAMP NRAMp PRNoi se One of six types of function waveform can be selected as a modulating signal USER 1 USER2 USER3 USER4 EMEMory A user defined waveform saved in the user waveform memory or the EMEMory can be selected as a modulating signal EFILe EFILe is used as a modulating signal SIN SQU TRI RAMP NRAM PRN USER1 USER2 USER3 USER4 EMOMory EFILe SOURCe1 PWM INTernal FUNCtion SQUare selects Square as the shape of modulating waveform for the CH 1 output SOURce 1 2 PWM INTernal FUNCtion EFILe Group Syntax Arguments Returns This command sets or gueries an EFILe name used as a modulating waveform for PWM modulation A file name must be specified in the mass storage system This command returns if there is no file in the mass storage Source SOURCe 1 2 PWM INTernal FUNCtion EFILe lt file name gt SOURce 1 2 PWM INTernal FUNCtion EFILE lt file_name gt lt string gt specifies a file name in the mass storage system The lt file_name gt includes path Path separators are forward slashes lt file_name gt AFG3000 Series Arbitrary
61. ation OFF or lt NR1 gt 0 disables FM modulation lt NR1 gt SOURCe1 FM STATe ON enables the CH 1 FM modulation SOURce 1 2 FREQuency CENTer Group Syntax 2 50 This command sets or queries the center frequency of sweep for the specified channel This command is always used with the SOURce 1 2 FREQuency SPAN command The setting range of center frequency depends on the waveform selected for sweep Source SOURCe 1 2 FREQuency CENTer lt frequency gt MINimum MAXimum SOURce 1 2 FREOuency CENTer AFG3000 Series Arbitrary Function Generator Programmer Manual Related Commands Arguments Returns Examples Command Descriptions SOURce 1 2 FREQuency SPAN SOURce 1 2 FREQuency MODE lt frequency gt lt NRf gt lt units gt where lt NRf gt is the center frequency lt units gt Hz kHz MHz lt frequency gt SOURcel FREQuency CENTer 550kHz sets the CH 1 center freguency to 550 kHz SOURce 1 2 FREQuency CONCurrent STATe Group Syntax Arguments Returns Examples This command enables or disables the function to copy the frequency or period of one channel to another channel The SOURCe 1 2 FREQuency CONCurrent command copies the frequency or period of the channel specified by the header suffix to another channel If you specify CH 1 with the header the CH 1 frequency will be copied to CH 2 The SOURce 1 2 FREQuency CONCurrent command return
62. command SOURcel FREGuency 100 1 Minimum information needed for accepted short form Accepted short form SOURI 4 100 of a command aie Figure 2 2 Example of abbreviating a command NOTE The numeric suffix of a command or query may be included in either the long form or short form the arbitrary function generator will default to 1 if no suffix is used Chaining Commands and You can chain several commands or queries together into a single message To Queries Create a chained message first create a command or query add a semicolon and then add more commands or queries and semicolons until the message is complete If the command following a semicolon is a root node precede it with a colon The following figure illustrates a chained message consisting of several commands and queries The single chained message should end in a command or query not a semicolon Responses to any queries in your message are separated by semicolons z SOUR FREQ FIX 100 0UTP STAT ON SOUR VOLT AMPL TRIG SEQ TIM ee ee ee First command Second command First query Second query The response from this chained message might be 1 000E0 1 000E 3 Response from first query Lp esponse from second query 0587 001 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 the following figure the second comm
63. criptions MEMory STATe DELete No Query Form Group Syntax Arguments Examples MEMory STATe LOCK Group Syntax Arguments Returns Examples 2 28 This command deletes the contents of specified setup memory If a specified setup memory is not allowed to overwrite or delete this command causes an error Memory MEMory STATe DELete 0 1 2 3 4 0 1 2 3 or 4 specifies the location of setup memory MEMORY STATE DELETE 1 deletes the contents of specified setup memory This command sets or queries whether to lock the specified setup memory If you lock a setup memory you cannot overwrite or delete the setup file You cannot execute this command for the setup memory of location number 0 last setup memory Memory MEMory STATe LOCK 1 2 3 4 ON OFF lt NR1 gt MEMory STATe LOCK 1 2 3 4 0 1 2 3 or 4 specifies the setup memory to locked or queried ON or lt NR1 gt 0 locks the specified location of setup memory OFF or lt NR1 gt 0 allows you to overwrite or delete the specified location of setup memory lt NRI gt MEMORY STATE LOCK 1 ON locks the setup memory of location number 1 AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions MEMory STATe RECall AUTo Group Syntax Arguments Returns Examples This command sets or queries whether to enable the automatic recall of last setup memory when powered on The next time you apply the
64. cular modulation sweep or burst the Run mode will automatically be changed to Continuous If you specify EFILe when there is no EFILe or the EFILe is not yet defined this command causes an error If you change the type of output waveform it might change the output freguency because changing waveform types impacts the setting range of output freguency USER 1J USER2 USER3 USER4JEMEMory A user defined waveform saved in the user waveform memory or the EMEMory can be selected as an output waveform EFILe EFILe is specified as an output waveform Returns SIN SQU PULS RAMP PRN DC SINC GAUS LOR ERIS EDEC HARV USER1 USER2 USER3 USER4 EMEMory EFILe Examples SOURcel FUNCtion SHAPe SQUare selects the shape of CH 1 output waveform to square waveform SOURCe 1 2 PHASe ADJust This command sets or gueries the phase of output waveform for the specified channel You can set the value in radians or degrees If no units are specified the default is RAD The guery command returns the value in RAD AFG3000 Series Arbitrary Function Generator Programmer Manual 2 59 Command Descriptions Group Syntax Arguments Returns Examples This command is supported when you select a waveform other than DC Noise and Pulse Source SOURcCe 1 2 PHASe ADJust lt phase gt MINimum MAXimum SOURce 1 2 PHASe ADJust lt phase gt lt NR3 gt lt units gt where lt NR3 gt is the phase
65. cy gt lt NRf gt lt units gt where lt NRf gt is the hop frequency lt units gt Hz kHz MHz lt frequency gt SOURCe1 FSKey FREQuency 1 0MHz sets the hop frequency of CH 1 FSK modulation to 1 0 MHz AFG3000 Series Arbitrary Function Generator Programmer Manual 2 55 Command Descriptions SOURce 1 2 FSKey INTernal RATE Group Syntax Arguments Returns Examples This command sets or queries the internal modulation rate of FSK modulation for the specified channel You can use this command only when the internal modulation source is selected Source SOURce 1 2 FSKey INTernal RATE lt rate gt MINimum MAXimum SOURce 1 2 FSKey INTernal RATE lt rate gt lt NRf gt lt units gt where lt NRf gt is the modulation rate lt units gt Hz kHz MHz lt rate gt SOURcel FSKey INTernal RATE 50Hz sets the CH 1 internal modulation rate to 50 Hz SOURce 1 2 FSKey SOURce Group Syntax Arguments Returns 2 56 This command sets or queries the source of modulation signal of FSK modulation for the specified channel Source SOURce 1 2 FSKey SOURce INTernal ExXTernal SOURce 1 2 FSKey SOURCe INTernal means that the carrier waveform is modulated with an internal source EXTernal means that the carrier waveform is modulated with an external source INT EXT AFG3000 Series Arbitrary Function Generator Programmer Manual Examples Command
66. ds the pulse width setting DUTY means that the arbitrary function generator holds the pulse duty setting WIDT DUTY SOURCe1 PULSe HOLD WIDTh holds the CH 1 pulse width setting SOURce 1 2 PULSe PERiod Group Syntax Arguments Returns This command sets or queries the period for pulse waveform Source SOURce 1 2 PULSe PERiod lt period gt MINimum MAXimum SOURce 1 2 PULSe PERiod lt period gt lt NRf gt lt units gt where lt NRf gt is the pulse period lt units gt ns us ms s lt period gt AFG3000 Series Arbitrary Function Generator Programmer Manual 2 67 Command Descriptions Examples SOURCe1 PULSe PERiod 200ns sets the CH 1 pulse period to 200 ns SOURce 1 2 PULSe TRANsition LEADing Group Syntax Arguments Returns Examples This command sets or queries the leading edge time of pulse waveform Source SOURcCe 1 2 PULSe TRANSition LEADing lt seconds gt MINimum MAXi mum SOURce 1 2 PULSe TRANsition LEADing lt seconds gt lt NRf gt lt units gt where lt NRf gt is the leading edge time of pulse waveform lt units gt ns us ms s lt seconds gt SOURcel PULSe TRANSition LEADing 200ns sets the CH 1 leading edge time to 200 ns SOURce 1 2 PULSe TRANsition TRAiling Group Syntax Arguments 2 68 This command sets or queries the trailing edge time of pulse waveform Source
67. e in the mass storage system The lt file name gt includes path Path separators are forward slashes MMEMORY STORE TRACE EMEMOry SAMPLE1 TFW Copies the content of EMEMory to a file named SAMPLE1 TFW in the mass storage system This command generates the operation complete message by setting bit 0 in the Standard Event Status Register SESR when all pending commands that generate an OPC message are complete The query command places the ASCII character 1 into the output queue when all such OPC commands are complete Synchronization AFG3000 Series Arbitrary Function Generator Programmer Manual Syntax Arguments Returns Examples OPT Query Only Group Syntax Arguments Returns Examples Command Descriptions OPC OPC None lt execution complete gt 1 where 1 indicates that all pending operations are complete OPC might return to indicate that all pending OPC operations are finished This query only command returns a list of the options installed in your arbitrary function generator System OPT None lt OPT gt lt OPT gt lt OPT gt lt OPT gt OPT might return 0 which indicates no option is installed in the instrument OUTPUt 1 2 IMPedance The OUTPut IMPedance command sets the output load impedance for the specified channel The specified value is used for amplitude offset and high low level settings You can set the impedance to a
68. e_name gt Arguments lt file_name gt lt string gt specifies a file to be deleted Examples MMEMORY DELETE TEKOO1 TFW deletes the specified file from the mass storage MMEMory LOAD STATe No Query Form This command copies a setup file in the mass storage system to an internal setup memory If a specified internal setup memory is locked this command causes an error When you power off the instrument the setups are automatically overwritten in the setup memory 0 last setup memory Group Mass Memory Syntax MMEMory LOAD STATe 0 1 2 3 4 lt file_name gt AFG3000 Series Arbitrary Function Generator Programmer Manual 2 31 Command Descriptions Related Commands Arguments Examples MEMory STATe LOCKMEMory STATe RECall A UTOMMEMory STORe STATe 0 1 2 3 or 4 specifies the location of setup memory lt file_name gt lt string gt specifies a setup file to be copied MMEMORY LOAD STATE 1 SETUP1 TFS copies a file named SETUP1 TFS in the mass storage into the internal memory location 1 MMEMory LOAD TRACe No Query Form Group Syntax Related Commands Arguments Examples This command copies a waveform data file in the mass storage system to Edit Memory If the file format is different this command causes an error Mass Memory MMEMory LOAD TRACe EMEMory lt file name gt MMEMory STORe TRACe lt file_name gt lt string gt specifies a waveform data file to be co
69. egister SBR See page 3 4 Status Byte Register SBR Standard Event Status Register SESR See page 3 5 Standard Event Status Register SESR Operation Condition Register OCR See page 3 8 Operation Condition Register OCR Operation Event Register OEVR See page 3 8 Operation Event Register OEVR Questionable Condition Register QCR Questionable Event Register QEVR Status Byte Register SBR The SBR is made up of 8 bits Bits 4 5 and 6 are defined in accordance with IEEE Std 488 2 1992 see These bits are used to monitor the output queue SESR and service requests respectively 6 7 RQS 5 4 3 2 1 0 OSB 6 ESB MAV OSB EASS MSS Figure 3 2 The Status Byte Register SBR Table 3 1 SBR bit functions Bit Function 7 MSB OSB Operation Status Bit Indicates that an operation event has occurred 6 ROS Reguest Service When the instrument is accessed using the GPIB serial poll command this bit is called the Reguest Service ROS bit and indicates to the controller that a service reguest has occurred in other words that the GPIB bus SRO line is LOW The ROS bit is cleared when serial poll ends 3 4 AFG3000 Series Arbitrary Function Generator Programmer Manual Table 3 1 SBR bit functions cont Bit Function Status and Events 6 MSS Master Status Summary When the instrument is accessed
70. er commands in upper or lower case NM You can precede any command with white space characters White space characters include any combination of the ASCII control characters 00 through 09 and OB through 20 hexadecimal 0 through 9 and 11 through 32 decimal The instrument ignores commands that consists of just a combination of white space characters and line feeds SCPI Commands and Queries 2 4 The arbitrary function 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 as shown in the following figure that represents a subsystem The top level of the tree is the root node it is followed by one or more lower level nodes TRIGger _ Root nodes SEQuence _ Lower level nodes SLOPe SOURce TIMer 0587 008 Figure 2 1 Example of SCPI subsystem hierarchy tree AFG3000 Series Arbitrary Function Generator Programmer Manual Command Syntax You can create commands and queries from these subsystem hierarchy trees Commands speci
71. erator Programmer Manual 2 69 Command Descriptions Examples SOURCe1 PULSe WIDTh 200ns sets the CH 1 pulse width to 200 ns SOURce 1 2 PWM INTernal FREQuency Group Syntax Related Commands Arguments Returns Examples This command sets or queries the internal modulation frequency of PWM modulation for the specified channel You can use this command only when the internal modulation source is selected You can set the internal modulation frequency from 2 mHz to 50 00 kHz with resolution of 1 mHz You can select the source of modulating signal by using the SOURce 1 2 PWM SOURce INTernaljEX Ternal command Source SOURce 1 2 PWM INTernal FREQuency lt frequency gt MINimum MAXimum SOURce 1 2 PwM INTernal FREQuency SOURce 1 2 PWM SOURce lt frequency gt lt NRf gt lt units gt where lt NRf gt is the modulation frequency lt units gt Hz kHz MHz lt frequency gt SOURCeL PWM INTernal FREQuency 10kHz sets the CH 1 internal frequency to 10 kHz SOURCe 1 2 PWM INTernal FUNCtion 2 70 This command sets or queries the modulating waveform of PWM modulation for the specified channel You can use this command only when the internal modulation source is selected If you specify EFILe when there is no EFILe or the EFILe is not yet defined this command causes an error AFG3000 Series Arbitrary Function Generator Programmer Manual Group Syntax Rel
72. erfaces locally or remotely via an Ethernet LAN connection AFG3000 Series Arbitrary Function Generator Programmer Manual Getting Started Installation Use an internet browser to access the Tektronix Web site www tektronix com downloads and download the current Tek VISA to your PC Unzip the downloaded file in a temporary directory of your choice and run Setup exe NOTE The details on TekVISA concepts and operations are explained in the TekVISA Programmer Manual that can be also found on the Tektronix Web site AFG3000 Series Arbitrary Function Generator Programmer Manual 1 5 Getting Started 1 6 AFG3000 Series Arbitrary Function Generator Programmer Manual Syntax and Commands Syntax and Commands This section provides the following information Command Syntax defines the command syntax and processing conventions Command Groups describes command groups which lists the commands by function Command Descriptions describes the notation of each of the commands in alphabetical order AFG3000 Series Arbitrary Function Generator Programmer Manual 2 1 Command Syntax Command Syntax You can control the operations and functions of the arbitrary function generator through the GPIB interface using commands and queries The related topics listed below describe the syntax of these commands and queries The topics also describe the conventions that the instrument uses to process them See Command Groups See page 2 11
73. frequency sweep for the specified channel This command is always used with the SOURce 1 2 FREQuency CENTer command The setting range of frequency span depends on the waveform selected for sweep Source SOURCe 1 2 FREQuency SPAN lt frequency gt MINimum MAXimum SOURCe 1 2 FREQuency SPAN SOURce 1 2 FREQuency CENTer SOURce 1 2 FREQuency MODE lt frequency gt lt NRf gt lt units gt where lt NRf gt is the frequency span lt units gt Hz kHz MHz lt frequency gt AFG3000 Series Arbitrary Function Generator Programmer Manual 2 53 Command Descriptions Examples SOURcel FREQuency SPAN 900 kHz sets the CH 1 freguency span to 900 kHz SOURce 1 2 F REQuency STARt Group Syntax Related Commands Arguments Returns Examples This command sets or queries the start frequency of sweep for the specified channel This command is always used with the SOURce 1 2 FREQuency STOP command The setting range of start frequency depends on the waveform selected for sweep For more information on the setting range refer to the specifications page of Quick Start User Manual Source SOURce 1 2 FREGuency STARt lt frequency gt MINimum MAXimum SOURce 1 2 FREOuency STARt LSOURce 1 2 FREOuency MODE SOURce 1 2 FREQuency STOP lt frequency gt lt NRf gt lt units gt where lt NRf gt is the start frequency lt units gt Hz kHz MHz lt freque
74. fy actions for the instrument to perform Queries return measurement data and information about parameter settings Creating Commands SCPI commands are created by stringing together the nodes of a subsystem hierarchy and separating each node by a colon In the figure above TRIGger is the root node and EVENt GATed INPut and SOURce are lower level nodes To create a SCPI command start with the root node TRIGger 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 If you specify a parameter value that is out of range the parameter will be set to a default value The command descriptions list the valid values for all parameters For example TRIGgerEVENt SOURce EXTRear is a valid SCPI command created from the hierarchy tree See Figure 2 1 Parameter Types Parameters are indicated by angle brackets such as lt file name gt There are several different types of parameters See Table 2 4 The parameter type is listed after the parameter Some parameter types are defined specifically for the arbitrary function generator command set and some are defined by SCPI Creating Queries 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 TRIGgerEVENt SOURce is an example of a valid SCPI query using the hierarchy tree in the figure See Figure 2 1 Query
75. he mass storage system The lt file name gt includes path Path separators are forward slashes lt file_name gt SOURCe1 AM INTernal FUNCtion EFILe SAMPLEL sets a file named SAMPLE1 in the mass storage SOURce 1 2 AM SOURce Group 2 42 This command sets or queries the source of modulating signal of AM modulation for the specified channel Source AFG3000 Series Arbitrary Function Generator Programmer Manual Syntax Arguments Returns Examples Command Descriptions SOURCe 1 2 AM SOURCe INTernal EXTernal SOURce 1 2 AM SOURce INTernal means that the carrier waveform is modulated with an internal source EX Ternal means that the carrier waveform is modulated with an external source INT EXT SOURCe1 AM SOURCe INTernal sets the CH 1 source of modulating signal to internal SOURCe 1 2 AM STATe Group Syntax Arguments Returns Examples This command enables or disables AM modulation for the specified channel The guery command returns the state of AM modulation Source SOURce 1 2 AM STATE 4ON OFF lt NR1 gt SOURce 1 2 AM STATe ON or lt NR1 gt 70 enables AM modulation OFF or lt NR1 gt 0 disables AM modulation lt NR1 gt SOURCe1 AM STATe ON enables the CH 1 AM modulation SOURce 1 2 BURSt MODE Group This command sets or queries the burst mode for the specified channel Source AFG3000 Series Arbitrary Function Generato
76. he self test Calibration and Diagnostic DIAGnostic ALL DIAGnostic ALL TSI None lt NR1 gt where lt NR1 gt 0 indicates that the self test completed without errors lt NR1 gt 0 indicates that the arbitrary function generator detected an error DIAGNOSTIC ALL performs a self test DIAGNOSTIC ALL performs a self test and returns a number indicating the outcome of the self test This command sets or queries the contrast of the LCD display AFG3000 Series Arbitrary Function Generator Programmer Manual Group Syntax Arguments Returns Examples Command Descriptions Display DISPlay CONTrast lt contrast gt MINimum MAXimum DISPlay CONTrast lt contrast gt lt NR2 gt where lt NR2 gt is a range of display contrast from 0 00 through 1 00 resolution 3 digits The larger the value the greater the screen contrast MINimum sets the display to the 0 contrast level MAXimum sets the display to the largest contrast level lt NR2 gt DISPLAY CONTRAST MAXIMUM sets the display contrast to the largest contrast level DISPlay SAVer IMMediate No Query Form Group Syntax Related Commands Arguments Examples This command sets the screen saver state to ON regardless of the DISPlay SAVer STATe command setting The screen saver is enabled immediately without waiting for five minutes Display DISPlay SAVer IMMediate DISPlay SAVer STATe None
77. ies Specifications and Performance Verification Technical Reference which can be found on the Tektronix Web site www tektronix com downloads Group Source Syntax SOURCe 1 2 FM DEViation 4 lt deviation gt MINimum MAXimum SOURce 1 2 FM DEViation Arguments lt deviation gt lt NRf gt lt units gt where lt NRf gt is the frequency deviation lt units gt Hz kHz MHz Returns lt deviation gt Examples SOURCcel FM DEViation 1 0MHz sets the CH 1 frequency deviation to 1 0 MHz SOURce 1 2 FM INTernal FREQuency This command sets or queries the internal modulation frequency of FM modulation for the specified channel You can use this command only when the internal modulation source is selected You can set the internal modulation frequency from 2 mHz to 50 00 kHz with resolution of 1 mHz You can select the source of modulating signal by using the SOURce 1 2 FM SOURce INTernal EXTernal command Group Source Syntax SOURCe 1 2 FM INTernal FREQuency lt frequency gt MINimum MAXimum AFG3000 Series Arbitrary Function Generator Programmer Manual 2 47 Command Descriptions Related Commands Arguments Returns Examples SOURce 1 2 FM INTernal FREQuency SOURce 1 2 FM SOURce lt frequency gt lt NRf gt lt units gt where lt NRf gt is the modulation frequency lt units gt Hz kHz MHz lt frequency gt SOURCeL FM INTernal FREQuency
78. ific function or change one of its settings Commands have the structure lt Header gt lt Space gt lt Argument gt lt Comma gt lt Argument gt A command header is made up of one or more mnemonics arranged in a hierarchical or tree structure The first mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch of the previous one Commands at a higher level in the tree may affect those at a lower level The leading colon always returns you to the base of the command tree Queries Queries cause the arbitrary function generator to return information about its status or settings Queries have the structure lt Header gt lt Header gt lt Space gt lt Argument gt lt Comma gt lt Argument gt AFG3000 Series Arbitrary Function Generator Programmer Manual 2 3 Command Syntax Command Entry You can specify a query command at any level within the command tree unless otherwise noted These branch queries return information about all the mnemonics below the specified branch or level Query Responses When a query is sent to the arbitrary function generator only the values are returned When the returned value is a mnemonic it is noted in abbreviated format as shown in the following table See Table 2 3 Table 2 3 Query response examples Symbol Meaning SOURce PULSe DCYcle 50 0 OUTPut POLarity NORM Follow these general rules when entering commands Ent
79. ist of five element types AFG3000 Series Arbitrary Function Generator Programmer Manual Command Syntax Table 2 2 Command message elements Symbol Meaning lt Header gt The basic command name If the header ends with a question mark the command is a query The header may begin with a colon character if the command is concatenated with other commands the beginning colon is required The beginning colon can never be used with command headers beginning with a star lt Mnemonic gt A header subfunction Some command headers have only one mnemonic If a command header has multiple mnemonics they are always separated from each other by a colon character lt Argument gt A quantity quality restriction or limit associated with the header Not all commands have an argument while other commands have multiple arguments Arguments are separated from the header by a Arguments are separated from each other by a lt Comma gt lt Comma gt A single comma between arguments of multiple argument commands It may optionally have white space characters before and after the comma lt Space gt A white space character between command header and argument It may optionally consist of multiple white space characters The following figure shows the five command message elements Comma Header PN and MMEMory STATe LOCK 1 ON Mnemonics Arguments Space Commands Commands cause the instrument to perform a spec
80. litude 1vpp Tvcl writeString SOURCE2 VOLTAGE OFFSET 0 00 Set offset Ov Tvcl writeString C SOURCE2 PHASE ADJUST 90DEG Set phase 90degrees Save settings and output on 1 Tvcl writeString SAV 1 Save settings to Setupl Tvcl writeString RCL 1 Recall settings from Setupl End sub This is a sample program for sending an arbitrary waveform to the arbitrary function generator s Edit Memory and copying the contents of Edit Memory to the user waveform memory Private Sub Sample2 Click Assign resource Tvcl Descriptor GPIBO 11 INSTR Initialize of device setting AFG3000 Series Arbitrary Function Generator Programmer Manual Programming Examples Tvcl writeString RST Make arbitrary block data 2000 Points Dim wave 4000 As Byte For i 0 To 499 Leading edge 500 Points Data i Int 16382 500 Data range is from 0 to 16382 High lt Int Data 256 AFG s Data Format is big endian Low lt Data High 256 wave 2 i High wave 2 i 1 Low Next i For i 500 To 799 Part of High Level 800 Points Data 16382 High lt Int Data 256 Low lt Data High 256 wave 2 1 lt High wave 2 1 4 1 lt Low Next i For i lt 800 To 999 Trailing Edge 200 Points Data 1000 i Int 16382 200 High Int Data 256 Low Data High 256 wave 2 i High wave 2 1 4 1 Low Next i For i lt 1000 To 1999 Part of Low Level 1000 P
81. lt NR1 gt lt NR1 gt lt file name gt lt file type gt lt file size gt where The first lt NR1 gt indicates that the total amount of storage currently used in bytes The second lt NR1 gt indicates that the free space of mass storage in bytes lt file name gt is the exact name of file lt file type gt is DIR for directory otherwise it is blank lt file size gt is the size of the file in bytes MMEMORY CATALOG might return the following response 32751616 27970560 SAMPLE1 TFS 5412 This command changes the current working directory in the mass storage system Mass Memory MMEMory CDIRectory lt directory_name gt MMEMory CDIRectory AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions Arguments lt directory name gt lt string gt indicates the current working directory for the mass storage system If you do not specify a parameter the directory is set to the RST value At RST this parameter is set to the root Returns lt directory_name gt lt string gt Examples MMEMORY CDIRECTORY AFG WORKO changes the current directory to AFG WORKO MMEMory DELete No Query Form This command deletes a file or directory from the mass storage system If a specified file in the mass storage is not allowed to overwrite or delete this command causes an error You can delete a directory if it is empty Group Mass Memory Syntax MMEMory DELete lt fil
82. lt units gt where lt NR2 gt is the duty cycle AFG3000 Series Arbitrary Function Generator Programmer Manual 2 65 Command Descriptions Returns Examples lt units gt PCT lt percent gt SOURCe1 PULSe DCYCle 80 5 sets the duty cycle of the pulse waveform on CH 1 to 80 5 SOURce 1 2 PULSe DELay Group Syntax Related Commands Arguments Returns Examples 2 66 This command sets or queries the lead delay of the pulse waveform for the specified channel Source SOURce 1 2 PULSe DELay lt delay gt MINimum MAXimum SOURce 1 2 PULSe DELay lt delay gt lt NR2 gt lt units gt where lt NR2 gt is the lead delay lt units gt ns us ms s Setting range 0 ns to Pulse Period Continuous mode 0 ns to Pulse Period Pulse Width 0 8 co Leading Edge Time Trailing Edge Time Triggered Gated burst mode lt delay gt SOURCe1 PULSe DELay 20ms sets the CH 1 lead delay to 20 ms AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions SOURce 1 2 PULSe HOLD Group Syntax Arguments Returns Examples The SOURce 1 2 PULSe HOLD command sets the arbitrary function generator to hold either pulse width or pulse duty The SOURce 1 2 PULSe HOLD query returns WIDTh or DUTY Source SOURce 1 2 PULSe HOLD 4WIDTh DUTY SOURce 1 2 PULSe HOLD WIDTh means that the arbitrary function generator hol
83. memory that ranges from 2 to 131072 If the second parameter in the argument is a numerical value the length of the edit memory will be the number of points specified by this number and each point will be initialized to the default value 8191 lt trace_name gt SINusoid SQUare PULSe RAMP NOISe If the second parameter in the argument is specified by lt trace_name gt the specified waveform data will be copied to the edit memory The number of points for the specified waveform data is equal to the number of points for one period of current waveform data in the edit memory If the lt points gt and lt trace_name gt parameters in the argument are omitted the edit memory will be initialized to the default number of points 1000 and value 8191 DATA DEFine EMEMory 1000 sets the length of the edit memory to 1000 points and resets the data points to the default value TRACe DATA DELete NAME No Query Form Group Syntax This command deletes the contents of specified user waveform memory Trace TRACe DATA DELete NAME lt trace_name gt AFG3000 Series Arbitrary Function Generator Programmer Manual 2 97 Command Descriptions Arguments Examples lt trace_name gt USER 1 USER2 USER3 USER4 This command is invalid when trace name is being output or trace name gt is locked DATA DELete NAME USERI deletes the contents of USERI waveform memory TRACe DATA LOCK STATe Group S
84. n generator ESR also clears the SESR since reading the SESR clears it Status ESR CLS ESE SRE STB None lt NR1 gt indicates that the contents of the SESR as a decimal integer ESR might return 181 which indicates that the SESR contains the binary number 10110101 HCOPy SDUMp IMMediate No Query Form 2 26 This command copies a screen image and saves the image file to a USB memory The default file name is TEKOOnnn BMP where nnn is a consecutive number from 000 through 999 The image files are saved in a folder named TEK in the USB memory AFG3000 Series Arbitrary Function Generator Programmer Manual Group Syntax Arguments Examples IDN Query Only Group Syntax Arguments Returns Examples Command Descriptions Screen copy HCOPy SDUMp IMMediate None HCOPY SDUMP IMMEDIATE copies the screen image and may create a file TEK00001 BMP in a USB memory This query only command returns identification information on the arbitrary function generator System IDN None lt Manufacturer gt lt Model gt lt Serial Number gt lt Firmware Level gt where lt Manufacturer gt TEKTRONIX lt Model gt AFG3021 lt Serial Number gt lt Firmware Level gt SCPI 99 0 FV 2 0 IDN might return the following response TEKTRONIX AFG3021 c100101 SCPI 99 0 Fv 1 0 AFG3000 Series Arbitrary Function Generator Programmer Manual 2 27 Command Des
85. ncy gt SOURcel FREQuency STARt 10kHz sets the sweep start frequency of CH 1 to 10 kHz SOURce 1 2 FREQuency STOP 2 54 Group This command sets or queries the start frequency of sweep for the specified channel This command is always used with the SOURce 1 2 FREQuency STARt command The setting range of stop frequency depends on the waveform selected for sweep For more information on the setting range refer to the AFG3000 Series Specifications and Performance Verification Technical Reference which can be found on the Tektronix Web site www tektronix com downloads Source AFG3000 Series Arbitrary Function Generator Programmer Manual Syntax Related Commands Arguments Returns Examples Command Descriptions SOURcCe 1 2 FREQuency STOP lt frequency gt MINimum MAXimum SOURce 1 2 FREQuency STOP SOURce 1 2 FREQuency MODE SOURce 1 2 FREOuency STARt lt frequency gt lt NRf gt lt units gt where lt NRf gt is the stop frequency lt units gt Hz kHz MHz lt frequency gt SOURcel FREOuency STOP 100KHz 100KHz sets the stop freguency of CH 1 to 100 kHz SOURCe 1 2 FSKey FREOuency Group Syntax Arguments Returns Examples This command sets or gueries the hop freguency of FSK modulation for the specified channel Source SOURce 1 2 FSKey FREOuency lt frequency gt MINimum MAXimum SOURce 1 2 FSKey FREOuency lt frequen
86. ng for TRIGger CH2 Output Queue STATus OPERation ENABle lt bit_value gt STATus OPERAtionf EVENI STATus OPERation CONDition Operation Complete 5 Reguest Control Query Error Device Dependent Error Execution Error Command Error e HHT S m H HMHM User Request Power on KN I Error andEvent SESR ESER Status Block ESR ESEcbit au A ae Register SBR SRER STB SRE lt bit value gt SRE Figure 3 1 Error and event handling process Standard Event Status This block is used to report power on off command error and command Block execution status The block has two registers the Standard Event Status Register SESR and the Event Status Enable Register ESER Refer to the Standard Event Status Block shown at the bottom of 3 2 AFG3000 Series Arbitrary Function Generator Programmer Manual Status and Events Standard Event Status Register The SESR is an eight bit status register When an error or other type of event occurs on the instrument the corresponding bit is set You cannot write to this register Event Status Enable Register The ESER is an eight bit enable register that masks the SESR You can set this mask and take AND with the SESR to determine whether or not the ESB bit in the Status Byte Register SBR should be set Operation Status Block This block is used to report on the status of several ope
87. not allowed 109 Missing parameter 110 Command header error 111 Header separator error 112 Program mnemonic too long 113 Undefined header 114 Header suffix out of range 115 Unexpected number of parameters 120 Numeric data error 121 Invalid character in number 123 Exponent too large AFG3000 Series Arbitrary Function Generator Programmer Manual 3 13 Status and Events Execution Errors Table 3 6 Command error messages cont Error code Error message 124 Too many digits 128 Numeric data not allowed 130 Suffix error 131 Invalid suffix 134 Suffix too long 138 Suffix not allowed 140 Character data error 141 Invalid character data 144 Character data too long 148 Character data not allowed 150 String data error 151 Invalid string data 158 String data not allowed 160 Block data error 161 Invalid block data 168 Block data not allowed 170 Expression error 171 Invalid expression 178 Expression data not allowed 180 Macro error 181 Invalid outside macro definition 183 Invalid inside macro definition 184 Macro parameter error lists the errors that are detected during execution of a command Table 3 7 Execution error messages Error code Error message 200 Execution error 201 Invalid while in local 202 Settings lost due to RTL 203 Command protected 210 Trigger error 211 T
88. ns NOTE The self calibration can take several minutes to complete During this time the arbitrary function generator does not execute any commands Do not power off the instrument during the self calibration Calibration and Diagnostic CALibration ALL CALibration ALL CAL None lt NR1 gt where NR 12 0 indicates that the internal calibration completed without errors lt NR1 gt 0 indicates that the arbitrary function generator detected an error CALIBRATION ALL performs an internal calibration CALIBRATION ALL performs an internal calibration and returns results For example it might return 0 which indicates that the calibration completed without any errors This command clears all the event registers and gueues which are used in the arbitrary function generator status and event reporting system Status CLS None AFG3000 Series Arbitrary Function Generator Programmer Manual 2 21 Command Descriptions Examples DIAGnostic ALL Group Syntax Related Commands Arguments Returns Examples DISPlay CONTrast 2 22 CLS clears all the event registers and queues The DIAGnostic ALL command performs a self test The DIAGnostic ALL command returns the results after executing the test NOTE The self test can take several minutes to complete During this time the arbitrary function generator does not execute any commands Do not power off the instrument during t
89. nted by MHz You can omit a unit in a command but you must include the unit when using a SI prefix For example frequency of 15 MHz can be described as follows 15 0E6 1 5E7Hz 15000000 15000000Hz 15MHz etc 15M is not allowed Note that you can use either lower or upper case units and prefixes The following examples have the same result respectively 2 8 AFG3000 Series Arbitrary Function Generator Programmer Manual Command Syntax 170mHz 170mHz 170MHz etc 250mv 250mV 250MV etc General rules for using Here are three general rules for using SCPI commands queries and parameters SCPI commands 66 33 m You can use single or double quotation marks for quoted strings but you cannot use both types of guotation marks for the same string correct This string uses guotation marks correctly correct This string also uses guotation marks correctly incorrect This string does not use guotation marks correctly m You can use upper case lower case or a mixture of both cases for all commands gueries and parameters SOURCE FREQUENCY 10MHZ is the same as source frequency 100mhz and SOURCE frequency LOMHZ NOTE Literal strings quoted are case sensitive for example file names No embedded spaces are allowed between or within nodes correct OUTPUT FILTER LPASS FREQUENCY 200MHZ incorrect OUTPUT FILTER LPASS FREQUENCY 200MHZ IEEE 488 2 Common Commands
90. ny value from 1 Q to 10 kO with a resolution of 1 Q or 3 digits The default value is 50 Q The OUTPut IMPedance command returns the current load impedance setting in ohms If the load impedance is set to INFinity the guery command returns 9 9E137 AFG3000 Series Arbitrary Function Generator Programmer Manual 2 35 Command Descriptions Group Syntax Arguments Returns Examples OUTPUut 1 2 POLarity Group Syntax Arguments Returns Examples 2 36 Output OUTPut 1 2 IMPedance lt ohms gt INFinity MINimum MAXimum OUTPut 1 2 IMPedance lt ohms gt lt NR3 gt lt units gt where lt units gt OHM INFinity sets the load impedance to gt 10 kQ MINimum sets the load impedance to 1 Q MAXimum sets the load impedance to 10 kQ lt ohms gt lt NR3 gt OUTPutl IMPedance MAXimum sets the CH 1 load impedance to 10 KQ This command inverts a specified output waveform relative to the offset level The guery command returns the polarity for the specified channel Output OUTPut 1 2 POLarity 4NORMal INVerted OUTPut 1 2 POLarity NORMA sets the specified output waveform polarity to Normal INVerted sets the specified output waveform polarity to Inverted NORM INV OUTPutl POLarity NORMA sets the CH 1 waveform polarity to Normal AFG3000 Series Arbitrary Function Generator Programmer Manual OUTPut 1 2 STATe Group Syntax Arguments Returns Examples
91. oard with the associated drivers TekVISA is the Tektronix implementation of the VISA Application Programming Interface API Tek VISA 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 GPIBO and the address number of the instrument as 11 If you use an interface other than GPIB change the resource name of source code Refer to Tek VISA manual for details about resource Example 1 This is a sample program for setting the arbitrary function generator outputs Private Sub Samplel Click Assign resource Tvcl Descriptor GPIBO 11 INSTR Initialize of device setting Tvcl writeString RST Set CH1 output parameters 1 Tvcl writeString FUNCTION SIN Set output waveform SIN Tvcl WwriteString FREQUENCY 10E3 Set frequency 10kHz Tvcl writeString C VOLTAGE AMPLITUDE 2 00 Set amplitude 2Vpp AFG3000 Series Arbitrary Function Generator Programmer Manual 4 1 Programming Examples 4 2 Example 2 Tvcl writeString VOLTAGE OFFSET 1 00 Set offset 1V Tvcl writeString PHASE ADJUST ODEG Set phase Odegree Set CH2 output parameters Tvcl writeString C SOURCE2 FUNCTION SIN Set output waveform SIN Tvcl writeString C SOURCE2 FREQUENCY 10E3 Set frequency 10kHz Tvcl writeString SOURCE2 VOLTAGE AMPLITUDE 1 00 Set amp
92. og NI CDIRectory NI DELete NI LOAD STATe NI TRACe NI LOCK STATe J MDIRectory V STORe STATe NI TRACe NI OUTPut 1 2 IMPedance NI POLarity N STATe J TRIGger MODE N AFG3000 Series Arbitrary Function Generator Programmer Manual Appendix A SCPI Conformance Information Table A 1 SCPI conformance information cont Not Defined defined in SCPI in SCPI Command 1999 0 1999 0 SOURce ROSCillator SOURCe NI SOURce 1 2 VOLTage CONCurrent STATe NI AM STATe NI INTernal FREQuency y FUNCtion Ni EFILe NI SOURcef DEPTh V BURSt MODE NCYCles TDELay STATe COMBine FEED J FM INTernal FREQuency NI FUNCtion NI EFILe NI Z Z Z 2 SOURCe STATe DEViation FREQuency CENTer CONCurrent STATe NI MODE SPAN STARt STOP CW FIXed FSKey INTernal RATE SOURCe STATe FREQuency FUNCtion EFILe lt je Z 2 L e lt e f L Z e Z 2 A 2 AFG3000 Series Arbitrary Function Generator Programmer Manual Appendix A SCPI Conformance Information Table A 1 SCPI conformance information cont Not Defined defined in SCPI in SCPI Command 1999 0 1999 0 RAMP SYMMetry N SHAPe N PHASe INITiate ij ADJust y PM INTernal FREQuency NI FUNCtion NI EFILe NI
93. oints Data lt 0 High Int Data 256 Low lt Data High 256 AFG3000 Series Arbitrary Function Generator Programmer Manual 4 3 Programming Examples wave 2 i High wave 2 1 4 1 Low Next 7 Transfer waveform Transfer arbitrary block data to edit memory Tvcl SendEndEnabled False Tvcl writeString TRACE DATA EMEMORY 44000 Tvcl Sendendenabled True Tvcl writeByteArray wave Copy contents of edit memory to USER1 Tvcl WriteString TRAC COPY USER1 EMEM Set CHl output parameters Tvcl writeString FUNCTION USER1 Set output waveform USER1 Tvcl writeString FREQUENCY 8K Set frequency 8kHz Tvcl writeString OUTPUT ON Set CHl output on End Sub AFG3000 Series Arbitrary Function Generator Programmer Manual Appendices Appendix A SCPI Conformance Information All commands in the arbitrary function generator are based on SCPI Version 1999 0 lists the SCPI commands the arbitrary function generator supports Table A 1 SCPI conformance information Not Defined defined in SCPI in SCPI Command 1999 0 1999 0 ABORt NI CALibration ALL NI DIAGnostic ALL NI DISPlay CONTrast NI SAVer STATe NI SAVer IMMediate NI WINDow TEXT DATAJ NI CLEar NI AFGControl CSCopy NI HCOPy SDUMp IMMediate NI MEMory STATe VALid y DELete N LOCK NI RECall AUTo NI MMEMory CATal
94. om this warranty 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 shipping charges prepaid and with a copy of customer proof of purchase 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 h
95. on cont Not Defined defined in SCPI in SCPI Command 1999 0 1999 0 LOCK STATe N POINts TRIGger SEQuence SLOPe SOURCe TIMer IMMediate CAL NI CLS ESE ESR IDN OPC OPT Ni PSC NI RCL N RST y SAV N SRE N STB Ni TRG V TST NI WAI Ni Z e je e 2 L Z Z Z e AFG3000 Series Arbitrary Function Generator Programmer Manual A 5 Appendix A SCPI Conformance Information A 6 AFG3000 Series Arbitrary Function Generator Programmer Manual Index Symbols and Numbers iv A ABORt 2 19 AFGControl CSCopy 2 19 ArbExpress iv C CAL 2 20 CALibration ALL 2 20 CLS 2 21 command errors 3 13 Command Groups 2 11 D device errors 3 18 device specific errors 3 16 DIAGnostic A LL 2 22 DISPlay CONTrast 2 22 DISPlay SAVer IMMediate 2 23 DISPlay SAVer STATe 2 24 DISPlay WINDow TEXT CLEar 2 25 DISPlay WINDow TEXT DATA 2 24 E error event queue 3 12 ESE 2 25 ESER 3 10 ESR 2 26 event status enable register 3 3 execution errors 3 14 H HCOPy SDUMp IMMediate 2 26 IDN 2 27 MEMory STATe DELete 2 28 MEMory STATe LOCK 2 28 MEMory STATe RECall AUTo 2 29 MEMory S TATe VALid 2 29 messages and codes 3 12 MEMory CATalog 2 30 MEMory CDIRectory 2 30 EMory DELete 2 31 EMory LOAD STATe 2 31 Mory LOAD TRACe 2 32 Mory LOCK STATe 2 32 Mo
96. ord gt deactivates the security protection SYSTem PASSword CENable STATe Query Only This query only command returns the security protection state Group System Syntax SYSTem PASSword CENable STATe Related Commands SYSTem PA SSword CDISable SY STem PA SSword CENable SY S Tem PA SSword NEW Arguments None Returns lt NR1 gt where lt NR1 gt 0 indicates that the security protection is in the on state lt NR1 gt 70 indicates that the security protection is in the off state Examples SYSTEM PASSWORD CENABLE STATE might return 0 indicating that the instrument security protection is on SYSTem PASSword NEW No Query Form This command changes the password Group System Syntax SYSTem PASSword NEW lt current_password gt lt new_password gt Related Commands SYSTem PA SSword CDISable AFG3000 Series Arbitrary Function Generator Programmer Manual 2 91 Command Descriptions Arguments Examples SY STem PA SSword CENable SY STem PA SSword CENable STATe lt current password gt lt string gt specifies current password lt new_password gt lt string gt specifies a new password Password strings are case sensitive A password must have at least four characters and not more than 12 characters SYSTEM PASSWORD NEW DEFAULT abc123 changes the current password DEFAULT to abc123 SYSTem SECurity IMMediate No Query Form SYSTem ULANguage 2 92 Group
97. orm self test Tals Perform self test and return result status Display Commands Display commands let you change the graticule style displayed contrast and other display attributes The following table lists and describes Display commands Table 2 8 Display commands Header Description DISPlay CONTrast Set query the LCD display contrast DISPlay SAVer IMMediate Set screen saver DISPlay SAVer STATe Set guery the screen saver settings DISPlay WINDow TEXT DATA Set query the text message display DISPlay WINDow TEXT CLEar Delete text message Memory Commands Memory commands let you change setup memory attributes The following table lists and describes Memory commands Table 2 9 Memory commands Header Description MEMory STATe DELete Delete the setup memory MEMory STATe LOCK Set query the lock of setup memory overwrite and deletion MEMory STATe RECall AUTo Set query the recall of last set memory MEMory STATe VALid Query the availability of setup memory RCL Recall instrument setting from setup memory SAV Save instrument setting to setup memory AFG3000 Series Arbitrary Function Generator Programmer Manual 2 11 Command Groups 2 12 Mass Memory Commands Mass Memory commands let you change mass memory attributes The following table lists and describes Mass Memory commands Table 2 10 Mass Memory commands Header Description MMEMo
98. pecified file in the mass storage system If the specified file in the mass storage system is locked this command causes an error You cannot create a new file if the directory is locked If the setup memory is deleted this command causes an error The lt file_name gt argument is a quoted string that defines the file name and path Mass Memory MMEMory STORe STATe 40 1 2 3 43 lt file name gt MMEMory LOAD STATeMMEMory LOCK STATe AFG3000 Series Arbitrary Function Generator Programmer Manual 2 33 Command Descriptions Arguments Examples 0 1 2 3 or 4 specifies the location of setup memory lt file_name gt lt string gt specifies a file name in the mass storage system The lt file_name gt includes path Path separators are forward slashes MMEMORY STORE STATE 1 SETUP1 TFS Copies the setup file in the setup memory location 1 to a file named SETUP1 TFS in the mass storage system MMEMory STORe TRACe No Query Form OPC 2 34 Group Syntax Related Commands Arguments Examples Group This command copies a waveform data file in the Edit Memory to a file in the mass storage system If the file in the mass storage is locked this command causes an error You cannot create a new file if the directory is locked Mass Memory MMEMory STORe TRACe EMEMory lt file name gt MMEMory LOCK STATe J MMEMory LOAD TRA Ce lt file name gt lt string gt specifies a file nam
99. pied MMEMORY LOAD TRACE EMEMory TEK001 TFw copies a file named TEK001 TFW in the mass storage into Edit Memory MMEMory LOCK STATe Group Syntax 2 32 This command sets or gueries whether to lock a file or directory in the mass storage system If you lock a file or directory you cannot overwrite or delete it Mass Memory MMEMory LOCK STATe lt file_name gt ON OFF lt NR1 gt MMEMory LOCK STATe lt file_name gt AFG3000 Series Arbitrary Function Generator Programmer Manual Arguments Returns Examples Command Descriptions ON or lt NR1 gt 0 locks a file or directory in the mass storage system OFF or lt NR1 gt 0 allows you to overwrite or delete a file or directory in the mass storage system lt NR1 gt MMEMORY LOCK STATE SETUP1 TFS ON locks the file SETUP1 TFS MMEMory MDIRectory No Query Form Group Syntax Arguments Examples This command creates a directory in the mass storage system If the specified directory is locked in the mass storage system this command causes an error Mass Memory MMEMory MDIRectory lt directory_name gt lt directory_name gt lt string gt specifies a directory name to be created MMEMORY MDIRECTORY SAMPLE1 creates a directory named SAMPLE1 in the mass storage system MMEMory STORe STATe No Query Form Group Syntax Related Commands This command copies a setup file in the setup memory to a s
100. priority over the remote command Source SOURce 1 2 VOLTage LEVel1 IMMediate AMPLitude f lt amplitude gt MINimum MAXimum SOURce 1 2 VOLTage LEVel1 IMMediate AMPLitude LSOURce 1 2 VOLTage CONCurrent STATe lt amplitude gt lt NRf gt lt units gt where lt NRf gt is the output amplitude lt units gt VPP VRMS DBM lt amp1itude gt SOURcel VOLTage LEVel IMMediate AMPLitude 1V sets the CH loutput amplitude to 1 V SOURce 1 2 VOLTage LIMit HIGH 2 80 This command sets or gueries the higher limit of the output amplitude high level for the specified channel If your instrument is a dual channel model and the AFG3000 Series Arbitrary Function Generator Programmer Manual Group Syntax Related Commands Arguments Returns Examples Command Descriptions SOURce 1 2 VOLTage CONCurrent STATe command is set to ON then the higher level limit of the other channel is the same value Source SOURCe 1 2 VOLTage LIMit HIGH lt voltage gt MINimum MAXimum SOURce 1 2 VOLTage LIMit HIGH SOURce 1 2 VOLTage CONCurrent STATe lt voltage gt lt NRf gt lt units gt where lt NRf gt is the higher limit of output amplitude lt units gt mV V lt voltage gt SOURCe1 VOLTage LIMit HIGH 1V sets the higher limit of CH 1 output amplitude to 1 V SOURce 1 2 VOLTage LIMit LOW Group Syntax Related Commands Arguments
101. puts one cycle waveform from the Trigger Output connector when Inf Cycles starts This command sets and queries the power on status flag that controls the automatic power on execution of SRER and ESER When PSC is true SRER and ESER are set to 0 at power on When PSC is false the current values in the SRER and ESER are preserved in nonvolatile memory when power is shut off and are restored at power on Status PSC lt NRI gt PSC lt NR1 gt 0 sets the power on status clear flag to false disables the power on clear and allows the instrument to possibly assert SRQ after power on lt NR1 gt 70 sets the power on status clear flag true Sending PSC 1 therefore enables the power on status clear and prevents any SRQ assertion after power on lt NR1 gt PSC 0 sets the power on status clear flag to false This command restores the state of the instrument from a copy of the settings stored in the setup memory The settings are stored using the SAV command If the specified setup memory is deleted this command causes an error Memory RCL 0 1 2 3 4 AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions Related Commands SAV Arguments 0 1 2 3 or 4 specifies the location of setup memory Examples RCL 3 restores the instrument from a copy of the settings stored in memory location 3 RST No Query Form This command resets the instrument to the factory default settings Thi
102. r Programmer Manual 2 43 Command Descriptions Syntax Arguments Returns Examples SOURCe 1 2 BURSt MODE TRIGgered GATed SOURce 1 2 BURSt MODE TRIGgered means that triggered mode is selected for burst mode GATed means that gated mode is selected for burst mode TRIG GAT SOURcel BURSt MODE TRIGgered selects triggered mode SOURce 1 2 BURSt NCYCles Group Syntax Arguments Returns Examples 2 44 This command sets or queries the number of cycles burst count to be output in burst mode for the specified channel The query command returns 9 9E 37 if the burst count is set to INFinity Source SOURce 1 2 BURSt NCyCles lt cycles gt INFinity MINimum MAXimum SOURce 1 2 BURSt NCyCles lt cycles gt lt NRf gt where lt NRf gt is the burst count The burst count ranges from 1 to 1 000 000 INFinity sets the burst count to infinite count MINimum sets the burst count to minimum count MAXimum sets the burst count to maximum count lt cycles gt SOURCe1 BURSt NCYCles 2 sets the CH 1 burst count to 2 AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions SOURce 1 2 BURSt STATe Group Syntax Arguments Returns Examples This command enables or disables the burst mode for the specified channel The query command returns the state of burst mode Source SOURce 1 2 BURSt STATe 0N OFF lt NR1 gt SOURce 1
103. range must meet the following conditions Deviation lt Pulse Width PWmin Deviation lt Pulse Period Pulse Width PWmin Deviation lt Pulse Width 0 8 x Leading Edge Time Trailing Edge Time Deviation lt Pulse Period Pulse Width 0 8 x Leading Edge Time Trailing Edge Time where PWmin is the minimum pulse width Group Source Syntax SOURce 1 2 PWM DEViation DCYCle 4 lt percent gt MINimum MAXimum SOURce 1 2 PWM DEViation DCYCle Arguments lt percent gt lt NR2 gt lt units gt where lt NR2 gt is the PWM deviation lt units gt PCT Returns lt percent gt Examples SOURCe1 PWM DEViation DCYCle 5 0 sets the CH 1 PWM deviation to 5 0 SOURce ROSCillator SOURce This command sets the reference clock to either internal or external AFG3000 Series Arbitrary Function Generator Programmer Manual 2 73 Command Descriptions Group Syntax Arguments Returns Examples Source SOURce ROSCillator SOURce INTernal EXTernal SOURce ROSC1l1lator SOURce INTernal means that the reference clock is set to internal EXTernal means that the reference clock is set to external INT EXT SOURce ROSCillator SOURce INTernal selects the internal clock reference SOURce 1 2 SWEep HTIMe Group Syntax Arguments Returns Examples 2 74 This command sets or queries the sweep hold time Hold time represents the amount of time that the frequency must
104. ration Event Register OEVR This register has the same content as the Operation Condition Register Operation Condition Register OCR The Operation Condition Register is made up of sixteen bits which note the occurrence of events as shown in AFG3000 Series Arbitrary Function Generator Programmer Manual Status and Events 8 5 WTRIG WTRIG 3 SWE 0 CAL CH2 CH1 Figure 3 4 Operation Condition Register OCR Table 3 3 OCR bit functions Bit Function 15 to 9 Not used 8 WTRIG CH2 Waiting for Trigger Indicates whether the instrument is waiting for a trigger This bit is set when CH 2 in the case of dual channel model is waiting for a trigger Bit is reset when the waiting for trigger status is canceled 5 WTRIG CH1 Waiting for Trigger Indicates whether the instrument is waiting for a trigger This bit is set when CH 1 in the case of dual channel model is waiting for a trigger Bit is reset when the waiting for trigger status is canceled Not used 3 SWE Sweep Indicates whether the instrument is executing a frequency sweep This bit is set when a frequency sweep is being executed on CH 1 or another channel in the case of dual channel model Bit is reset when the execution stops 2to1 Not used 0 CAL Calibration Indicates whether the instrument is being calibrated This bit
105. rations being executed by the arbitrary function generator The block has three registers the Operation Condition Register OCR the Operation Event Register OEVR and the Operation Enable Register OENR Refer to the Operation Status Block shown in Operation Condition Register When the instrument achieves a certain status the corresponding bit is set to the OCR It is not allowed for the user to write to this register Operation Event Register The OCR bits that have changed from false reset to true set status are set in the OEVR Operation Enable Register The function of the OENR is to mask the OEVR You can set this mask and take AND with the OEVR to determine whether or not the OSS bit in the Status Byte Register SBR should be set Questionable Status Block This block reports on the status of signals and data such as the accuracy of entered data and signals generated by the instrument The register configuration and process flow are the same as the Questionable Status Block Registers The registers in the event reporting system fall into two functional groups um The Status Registers contain information about the status of the instrument um Enable Registers determine whether selected types of events are reported to the Status Registers and the Event Queue AFG3000 Series Arbitrary Function Generator Programmer Manual 3 3 Status and Events Status Registers There are six types of status registers Status Byte R
106. rent amplitude level The setting range is 0 to 50 This command is available when Run Mode is set to Continuous Burst or Sweep You can set or guery whether to add the internal noise to the output signal using the SOURce 1 2 COMBine FEED command AFG3000 Series Arbitrary Function Generator Programmer Manual Group Syntax Related Commands Arguments Returns Examples Command Descriptions Source SOURce lt 3 4 gt POWer LEVe1 IMMediate AMPLitude 4 lt percent gt MINimum MAXimum SOURce lt 3 4 gt POWer LEVe1 IMMediate AMPLitude SOURce 1 2 COMBine FEED lt percent gt lt NR2 gt lt units gt where lt NR2 gt is the noise level lt units gt PCT lt percent gt SOURCe3 POWer LEVel IMMediate AMPLitude 50PCT sets the internal noise level that is added to the output signal to 50 SOURce 1 2 PULSe DCYCle Group Syntax Related Commands Arguments This command sets or queries the duty cycle of the pulse waveform for the specified channel The setting range is 0 001 to 99 999 in increments of 0 001 The arbitrary function generator will hold the settings of leading edge and trailing edge when the duty cycle is varied Refer to the SOURce 1 2 PULSe WIDTh command for the setting range Source SOURce 1 2 PULSe DCYCle lt percent gt MINimum MAXimum SOURce 1 2 PULSe DCyCle SOURce 1 2 PULSe WIDTh lt percent gt lt NR2 gt
107. rigger ignored 212 Arm ignored 213 Init ignored AFG3000 Series Arbitrary Function Generator Programmer Manual Status and Events Table 3 7 Execution error messages cont Error code Error message 214 Trigger deadlock 215 Arm deadlock 220 Parameter error 221 Settings conflict 222 Data out of range 223 Too much data 224 Illegal parameter value 225 Out of memory 226 Lists not same length 230 Data corrupt or stale 231 Data questionable 232 Invalid format 233 Invalid version 240 Hardware error 241 Hardware missing 250 Mass storage error 251 Missing mass storage 252 Missing media 253 Corrupt media 254 Media full 255 Directory full 256 File name not found 257 File name error 258 Media protected 260 Expression error 261 Math error in expression 270 Macro error 271 Macro syntax error 272 Macro execution error 273 Illegal macro label 274 Macro parameter error 275 Macro definition too long 276 Macro recursion error 277 Macro redefinition not allowed 278 Macro header not found 280 Program error 281 Cannot create program AFG3000 Series Arbitrary Function Generator Programmer Manual Status and Events Table 3 7 Execution error messages cont Error code Error message 282 Illegal program name 283 Illegal variable name 2
108. rnal signal add function specify You can add an external signal to the CH 1 output signal of the AFG3100 and AFG3200 series arbitrary function generators The CH 2 output is not available for adding external signal Both the internal noise and an external signal can be added simultaneously to the arbitrary function generator Source SOURCe 1 2 COMBine FEED NOISe EXTernal BOTH SOURce 1 2 COMBine FEED SOURce lt 3 4 gt POWer LE Vel IMMediate AMPLitude NOISe indicates that the internal noise is added to the output signal EXTernal indicates that an external signal is added to the CH 1 output signal of the AFG3100 or AFG3200 series arbitrary function generators BOTH indicates that the internal noise and an external signal are added to the CH 1 output signal of the AFG3100 or AFG3200 series arbitrary function generators disables the internal noise add and external signal add function NOIS EXT BOTH TEH SOURCe1 COMBine FEED EXTernal adds an external signal to the CH 1 output signal AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions SOURce 1 2 FM DEViation This command sets or queries the peak frequency deviation of FM modulation for the specified channel The setting range of frequency deviation depends on the waveform selected as the carrier For more information refer to the specifications in the AFG3000 Ser
109. roup Syntax Arguments Returns Examples 2 88 This query only command returns the contents of the Error Event queue System SYSTem ERRor NEXT None lt Error event number gt lt NR1 gt lt Error event description gt lt string gt SYSTEM ERROR NEXT might return the following response 410 Query INTERRUPTED If the instrument detects an error or an event occurs the event number and event message will be returned AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions SYSTem KCLick STATe Group Syntax Arguments Returns Examples This command enables or disables the click sound when you push the front panel buttons or turn the general purpose knob The query command returns 0 OFF or 1 ON System SYSTem KCLick STATe 4ON OFF lt NR1 gt SYSTem KCLick STATe ON or lt NR1 gt 0 enables click sound OFF or lt NR1 gt 0 disables click sound lt NR1 gt SYSTEM KCLICK STATE ON enables the click sound SYSTem KLOCk STATe Group Syntax Arguments Returns Examples This command locks or unlocks the instrument front panel controls The guery command returns 0 OFF or 1 ON System SYSTem KLOCk STATe 0N OFF lt NR1 gt SYSTem KLOCK STATe ON or lt NR1 gt 0 locks front panel controls OFF or lt NR1 gt 0 unlocks front panel controls lt NR1 gt SYSTEM KLOCK
110. ry Function Generator The following table lists event code definitions See Table 3 5 When an error occurs you can find its error class by checking for the code in the following tables Events in these tables are organized by event class AFG3000 Series Arbitrary Function Generator Programmer Manual Status and Events Table 3 5 Definition of event codes Event class Code range Description No error 0 No event or status Command errors 100 to 199 Command syntax errors Execution errors 200 to 299 Command execution errors Device specific errors 300 to 399 Internal device errors Query errors 400 to 499 System event and query errors Power on events 500 to 599 Power on events User request events 600 to 699 User request events Request control events 700 to 799 Request control events Operation complete events 800 to 899 Operation complete events Extended device specific 1 to 32767 Device dependent device errors errors Reserved other than above not used Command Errors shows the error messages generated by improper command syntax Check that the command is properly formed and that it follows the rules in the Syntax and Commands Table 3 6 Command error messages Error code Error message 100 Command error 101 Invalid character 102 Syntax error 103 Invalid separator 104 Data type error 105 GET not allowed 108 Parameter
111. ry CATalog Query the status of mass memory MMEMory CDIRectory Set query current directory MMEMory DELete Delete file or directory in mass memory MMEMory LOAD STATe Copy instrument setting in mass memory to setup memory MMEMory LOAD TRACe Copy waveform data file in mass memory to edit memory MMEMory LOCK STATe Set query the lock of mass memory overwrite and deletion MMEMory MDIRectory Create directory in mass memory MMEMory STORe STATe Save the setup memory status to mass memory MMEMory STORe TRACe Save waveform data file in edit memory to mass memory Output Commands Output commands let you set output attributes The following table lists and describes Output commands Table 2 11 Output commands Header Description OUTPUt 1 2 IMPedance Set guery impedance OUTPUt 1 2 POLarity Set guery polarity OUTPut 1 2 STATe Set query output on or off OUTPut TRIGger MODE Set query the mode of Trigger Output Source Commands Source commands let you set waveform output parameters The following table lists and describes Source commands Table 2 12 Source commands Header Description SOURce ROSCillator SOURce Set query clock reference input SOURce 1 2 AM DEPTh Set guery amplitude modulation depth SOURce 1 2 AM INTernal FREOuency Set guery internal modulation freguency SOURce 1 2 AM INTernal FUNCtion Set guery modulation waveform setting SOURce 1 2 AM INTernal FUNCtion Set guery EFILe
112. ry MDIRectory 2 33 Mory STORe STATe 2 33 Mory STORe TRACEe 2 34 SSSSSSSSS SSESSES mamam O OCR 3 8 OENR 3 11 OEVR 3 8 OPC 2 34 operation complete events 3 17 operation condition register 3 8 operation enable register 3 11 operation event register 3 8 OPT 2 35 output queue 3 12 OUTPut TRIGger MODE 2 37 OUTPut 1 2 IMPedance 2 35 OUTPut 1 2 POLarity 2 36 OUTPut 1 2 STATe 2 37 Overview of the Manual 1 1 P power on events 3 17 Programmer Manual iv PSC 2 38 Q QCR 3 10 QENR 3 11 QEVR 3 9 AFG3000 Series Arbitrary Function Generator Programmer Manual Index 1 Index query errors 3 17 questionable condition register 3 10 questionable enable register 3 11 questionable event register 3 9 queues 3 12 R RCL 2 38 registers 3 3 request control events 3 17 RST 2 39 S SAV 2 39 SCPI commands and queries 2 4 SCPI conformance information A 1 service request enable register 3 11 SESR 3 5 SOURce ROSCillator SOURce 2 73 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 SOURce 1 Index 2 2 AM INTernal FREQuency 2 40 2 AM INTernal FUNCtion 2 41 2 AM INTernal FUNCtion EFILe 2 42 2 AM SOURCce 2 42
113. s 0 off or 1 on If your arbitrary function generator is single channel model this command is not supported Source SOURce 1 2 FREGuency CONCurrent STATe ON OFF lt NR1 gt SOURce 1 2 FREGuency CONCurrent STATe ON or lt NR1 gt 0 enables the concurrent copy function OFF or lt NR1 gt 0 disables the concurrent copy function lt NR1 gt SOURCe1 FREQuency CONCurrent ON copies the frequency value of CH 1 to CH 2 AFG3000 Series Arbitrary Function Generator Programmer Manual 2 51 Command Descriptions SOURce 1 2 F REQuency CW FIXed Group Syntax Arguments Returns Examples This command sets or queries the frequency of output waveform for the specified channel This command is available when the Run Mode is set to other than Sweep The setting range of output frequency depends on the type of output waveform If you change the type of output waveform it might change the output frequency because changing waveform types impacts on the setting range of output frequency The resolution is 1 uHz or 12 digits For more information on the setting range refer to the 4FG3000 Series Specifications and Performance Verification Technical Reference which can be found on the Tektronix Web site www tektronix com downloads Source SOURcCe 1 2 FREQuency Cw FIXed 4 lt freguency gt MINimum MAXimum SOURce 1 2 FREGuency CW FIXed lt frequency gt lt NRf gt
114. s command is equivalent to pushing the Default button on the front panel The default values are listed in Default Settings Group System Syntax RST Arguments None Examples RST resets the arbitrary function generator settings to the factory defaults SAV No Query Form This command stores the current settings of the arbitrary function generator to a specified setup memory location A setup memory location numbered 0 last setup memory is automatically overwritten by the setups when you power off the instrument If a specified numbered setup memory is locked this command causes an error Group Memory Syntax SAV 0 1 21314 Related Commands RCL AFG3000 Series Arbitrary Function Generator Programmer Manual 2 39 Command Descriptions Arguments Examples 0 1 2 3 or 4 specifies the location of setup memory SAV 2 saves the current instrument state in the memory location 2 SOURce 1 2 AM DEPTh Group Syntax Arguments Returns Examples This command sets or gueries the modulation depth of AM modulation for the specified channel You can set the modulation depth from 0 0 to 120 0 with resolution of 0 1 Source SOURce 1 2 AM DEPTh 4 lt depth gt MINimum MAXimum SOURce 1 2 AM DEPTh lt depth gt lt NR2 gt lt units gt where lt NR2 gt is the depth of modulating frequency lt units gt PCT MINimum sets the modulation depth to minimum value MAXimum sets
115. setting EFILe AFG3000 Series Arbitrary Function Generator Programmer Manual Table 2 12 Source commands cont Header Command Groups Description SOURce 1 2 AM SOURce Set query amplitude modulation source SOURce 1 2 AM STATe Set query amplitude modulation status SOURce 1 2 BURSt MODE Set query burst mode SOURce 1 2 BURStNCYCles Set query burst mode waveform output cycle SOURce 1 2 BURSt STATe SOURce 1 2 BURSt TDELay Set guery burst mode status Set guery burst mode trigger delay time SOURce 1 2 COMBine FEED Set query internal noise or external signal SOURce 1 2 FM DEViation Set query frequency deviation SOURce 1 2 FM INTernal FREOuency SOURce 1 2 FM INTernal FUNCtion Set query internal modulation frequency Set query internal modulation waveform SOURce 1 2 FM INTernal FUNCtion EFILe Set query EFILe setting SOURce 1 2 FM SOURce Set query frequency modulation source SOURCce 1 2 FM STATe SOURce 1 2 FREQuency CENTer Set query frequency modulation status Set query center frequency SOURCce 1 2 FREOuency CONCurrent STATe Set guery concurrent change of freguency SOURce 1 2 FREOuency CW FIXed Set guery output waveform freguency SOURCce 1 2 FREOuency MODE Set guery sweep status SOURce 1 2 FREQuency SPAN Set query sweep frequency span SOURce 1 2 FREQuenc
116. specified channel If your instrument is a dual channel model and the SOURce 1 2 VOLTage CONCurrent STATe command is set to ON then the high level of other channel is also the same value Source SOURce 1 2 VOLTage LEVel1 IMMediate HIGH 1 lt voltage gt MINimum MAXimum SOURce 1 2 VOLTage LEVel1 IMMediate HIGH LSOURce 1 2 VOLTage CONCurrent STATe lt voltage gt lt NRf gt lt units gt where lt NRf gt is the high level of output amplitude lt units gt mV V lt voltage gt SOURcel VOLTage LEVel IMMediate HIGH 1V sets the high level of CH 1 output amplitude to 1 V SOURce 1 2 VOLTage LEVel IMMediate LOW Group 2 78 This command sets or gueries the low level of output amplitude for the specified channel If your instrument is a dual channel model and the SOURce 1 2 VOLTage CONCurrent STATe command is set to ON then the low level of other channel is also the same value Source AFG3000 Series Arbitrary Function Generator Programmer Manual Syntax Related Commands Arguments Returns Examples Command Descriptions SOURCe 1 2 VOLTage LEVel IMMediate LOw lt voltage gt MINimum MAXimum SOURCe 1 2 VOLTage LEVel IMMediate LOw SOURce 1 2 VOLTage CONCurrent STATe lt voltage gt lt NRf gt lt units gt where lt NRf gt is the low level of output amplitude lt units gt mV V lt voltage gt SOURCe1
117. splayed text message DISPLAY WINDOW TEXT DATA returns the currently displayed text message DISPlay WINDow TEXT CLEar No Query Form Group Syntax Arguments Examples ESE Group Syntax Related Commands Arguments This command clears the text message from the display screen Display DISPlay WINDow TEXT CLEar None DISPLAY WINDOW TEXT CLEAR clears the text message from the screen This command sets or gueries the bits in the Event Status Enable Register ESER used in the status and events reporting system of the arbitrary function generator The guery command returns the contents of the ESER Status ESE lt bit value gt ESE CLS ESR PSC SRE STB lt bit_value gt lt NR1 gt where lt NRI gt is a value in the range of 0 through 255 The binary bits of the ESER are set according to this value AFG3000 Series Arbitrary Function Generator Programmer Manual 2 25 Command Descriptions Returns Examples ESR Query Only Group Syntax Related Commands Arguments Returns Examples lt bit_value gt ESE 177 sets the ESER to 177 binary 10110001 which sets the PON CME EXE and OPC bits ESE might return 186 indicating that the ESER contains the binary value 10111010 This query only command returns the contents of the Standard Event Status Register SESR used in the status events reporting system in the arbitrary functio
118. ted linearly lt point_data2 gt lt NR1 gt where lt NRI gt is the data value at the end point DATA DATA LINE EMEMory 1 2047 250 4094 sets a data value of 2047 for start point and a data value of 4094 for end point 250 and interpolates linearly between these two points in the edit memory TRACe DATA DATA VALue 2 96 Group Syntax Arguments Returns Examples This command sets or queries the data value at the specified point in the edit memory Trace TRACe DATA DATA VALUe EMEMory lt point gt lt data gt TRACe DATA DATA VALUE lt point gt lt NR1 gt where lt NRI gt is the specified point number in the edit memory lt data gt lt NR1 gt where lt NRI gt is the data value for the specified point number lt NRI gt DATA DATA VALue EMEMory 500 2047 sets the data value to 2047 for the point number 500 in the edit memory DATA DATA VALUE EMEMory 500 might return 2047 AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions This example indicates that the data value of point number 500 is set to 2047 TRACe DATA DEFine No Query Form Group Syntax Arguments Examples This command resets the contents of edit memory Trace TRACe DATA DEFine EmEMory lt points gt lt trace_name gt lt points gt lt NR1 gt where lt NRI1 gt is the number of points for the waveform data in the edit
119. tion TRACe DATA CATalog Return user waveform memory status TRACe DATA COPY Copy edit memory or user waveform memory content to user waveform memory or edit memory TRACEe DATA DATA Set guery waveform data to edit memory TRACe DATA DATA LINE Write waveform data with interpolation TRACe DATA DATA VALue Set query waveform data in edit memory TRACe DATA DEFine Set edit memory content TRACe DATA DELete NAME Delete user waveform memory contents TRACe DATA LOCK STATe Set guery lock unlock of user waveform memory TRACe DATA POINts Set query number of points for waveform data in edit memory Trigger Commands Trigger commands let you control all aspects of arbitrary function generator triggering lists and describes Trigger commands Table 2 17 Trigger commands Header Description ABORt Initialize trigger system TRG Force trigger event TRIGger SEOuence IMMediate Generate a trigger event TRIGger SEOuence SLOPe Set guery the slope of trigger signal TRIGger SEQuence SOURce Set query the source of trigger signal TRIGger SEOuence TIMer Set guery the period of internal clock AFG3000 Series Arbitrary Function Generator Programmer Manual Command Groups AFG Control AFG Control command copies setups between two channels Table 2 18 AFG Control command Header Description AFGControl CSCopy Copy CH1 or CH2 setup parameters to CH2 or CH1 Screen Copy Screen cop
120. to phase value DEG 0 to 180 in 1 degree steps relative to phase value lt deviation gt SOURCe1 PM DEViation MAXimum sets the maximum value for the CH 1 phase deviation SOURce 1 2 PM INTernal FREQuency Group This command sets or queries the internal modulation frequency of PM modulation for the specified channel You can use this command only when the internal modulation source is selected You can set the internal modulation frequency from 2 mHz to 50 00 kHz with resolution of 1 mHz You can select the source of modulating signal by using the SOURce 1 2 PM SOURce INTernal EXTernal command Source AFG3000 Series Arbitrary Function Generator Programmer Manual 2 61 Command Descriptions Syntax Related Commands Arguments Returns Examples SOURce 1 2 PM INTernal FREQuency 4 lt freguency gt MINimum MAXimum SOURce 1 2 PM INTernal FREQuency SOURce 1 2 PM SOURce lt frequency gt lt NRf gt lt units gt where lt NRf gt is the modulation frequency lt units gt Hz kHz MHz lt frequency gt SOURCeL PM INTernal FREQuency 10kHz sets the CH 1 internal modulation frequency to 10 kHz SOURce 1 2 PM INTernal FUNCtion 2 62 Group Syntax Related Commands Arguments This command sets or gueries the modulating waveform of PM modulation for the specified channel You can use this command only when the internal modulation source is selected So
121. ulation A file name must be specified in the mass storage system This command returns if there is no file in the mass storage Source SOURCe 1 2 FM INTernal FUNCtion EFILe lt file name gt SOURce 1 2 FM INTernal FUNCtion EFILE lt file_name gt lt string gt specifies a file name in the mass storage system The lt file name gt includes path Path separators are forward slashes file name gt SOURcel FM INTernal FUNCtion EFILe SAMPLEL sets a file named SAMPLE1 in the mass storage SOURce 1 2 FM SOURce Group Syntax This command sets or queries the source of modulating signal of FM modulation for the specified channel Source SOURCe 1 2 FM SOURCe INTernal ExTernal SOURCe 1 2 FM SOURce AFG3000 Series Arbitrary Function Generator Programmer Manual 2 49 Command Descriptions Arguments Returns Examples INTernal means that the carrier waveform is modulated with the internal source EXTernal means that the carrier waveform is modulated with an external source INT EXT SOURcel FM SOURce INTernal sets the CH 1 source of modulating signal to internal SOURce 1 2 FM STATe Group Syntax Arguments Returns Examples This command enables or disables FM modulation The query command returns the state of FM modulation Source SOURCe 1 2 FM STATe ON OFF lt NR1 gt SOURce 1 2 FM STATe ON or lt NR1 gt 0 enables FM modul
122. urce SOURce 1 2 PM INTernal FUNCtion SINusoid SQuare TRIangle RAMP NRAMp PRNoise USER 1 USER2 USER3 USER4 EMEMory EFILeJ SOURce 1 2 PM INTernal FUNCtion SOURce 1 2 PM SOURce SINuSoid SQUare TRIangle RAMP NRAMp PRNoise One of six types of function waveform can be selected as a modulating signal USER 1 USER2 USER3 USER4 EMEMory A user defined waveform saved in the user waveform memory or the EMEMory can be selected as a modulating signal EFILe EFILe AFG3000 Series Arbitrary Function Generator Programmer Manual Returns Examples Command Descriptions is used as a modulating signal SIN SQU TRI RAMP NRAM PRN USER1 USER2 USER3 USER4 EMEMory EFILe SOURcel PM INTernal FUNCtion SQUare selects Square as the shape of modulating waveform for the CH 1 output SOURce 1 2 PM INTernal FUNCtion EFILe Group Syntax Arguments Returns Examples This command sets or gueries an EFILe name used as a modulating waveform for PM modulation A file name must be specified in the mass storage system This command returns if there is no file in the mass storage Source SOURCe 1 2 PM INTernal FUNCtion EFILe lt file name gt SOURce 1 2 PM INTernal FUNCtion EFILE lt file_name gt lt string gt specifies a file name in the mass storage system The lt file name gt includes path Path separators are forward slashes file name gt SOU
123. ure 3 9 Questionable Enable Register QENR There are two types of queues in the status reporting system output queue and error event queues The output queue is an FIFO first in first out queue that holds response messages to queries awaiting retrieval When there are messages in the queue the MAV bit in the SBR is set The output queue is emptied each time a command or query is received so the controller must read the output queue before the next command or query is issued If this is not done an error occurs and the output queue is emptied however the operation proceeds even if an error occurs The event queue is an FIFO queue which stores events as they occur in the instrument If more than 64 events are stored the 64th event is replaced with event code 350 Queue Overflow The oldest error code and text are retrieved by using one of the following queries SYSTem ERRor NEXT First issue the ESR query to read the contents of the SESR The contents of the SESR are cleared after they are read If an SESR bit is set events are stacked in the Error Event Queue Retrieve the event code with the following command sequence ESR SYSTem ERRor NEXT If you omit the ESR query the SESR bit will remain set even if the event disappears from the Error Event Queue Error and event codes with negative values are SCPI standard codes Error and event codes with positive values are unique to the AFG3000 Series Arbitra
124. y STARt Set query sweep start frequency SOURce 1 2 FREQuency STOP SOURce 1 2 FSKey FREOuency Set guery sweep stop freguency Set guery FSK hop freguency SOURce 1 2 FSKey INTernal RATE Set query FSK internal modulation rate SOURce 1 2 F SKey SOURce Set query FSK source SOURce 1 2 FSKey STATe SOURce 1 2 FUNCtion EFILe Set guery FSK status Set guery EFILe name SOURce 1 2 FUNCtion RAMP SYMMetry Set query ramp waveform symmetry SOURce 1 2 FUNCtion SHAPe Set query output waveform SOURce 1 2 PHASe ADJust SOURce 1 2 PHASe INITiate Set query output waveform phase Initiate output waveform phase synchronization SOURce 1 2 PM DEViation Set query phase modulation deviation SOURce 1 2 PM INTernal FREQuency Set query internal modulation frequency SOURce 1 2 PM INTernal FUNCtion SOURce 1 2 PM INTernal FUNCtion EFILe Set guery internal modulation waveform Set guery EFILe name SOURce 1 2 PM SOURce Set query phase modulation source AFG3000 Series Arbitrary Function Generator Programmer Manual 2 13 Command Groups 2 14 Table 2 12 Source commands cont Header Description SOURce 1 2 PM STATe Set guery phase modulation status SOURce 1 2 PULSe DCYCle Set guery pulse waveform duty cycle SOURce 1 2 PULSe DELay Set query pulse waveform lead delay SOURce 1 2 PULSe
125. y command copies screen image Table 2 19 Screen copy command Header Description HCOPy SDUMp IMMediate Copy screen image and save the file to USB memory AFG3000 Series Arbitrary Function Generator Programmer Manual 2 17 Command Groups 2 18 AFG3000 Series Arbitrary Function Generator Programmer Manual Command Descriptions Manual Conventions Commands either set or query instrument values Some commands both set and query some only set and some only query This manual uses the following conventions No Query Form indicates set only commands m A question mark appended to the commands and Query Only indicates query only commands Fully spells out headers mnemonics and arguments with the minimal spelling shown in upper case for example to use the abbreviated form of the DISPlay CONTrast command just type DISP CONT um Syntax of some commands varies depending on the model of arbitrary function generator you are using differences are noted ABORt No Query Form Group Syntax Arguments Examples Initializes all the current trigger system parameters and resets all trigger sequences Trigger ABORt None ABORT resets the trigger system AFGControl CSCopy No Query Form Group Syntax This command copies setup parameters for one channel to another channel If your arbitrary function generator is a single channel model this command is not supported AFG Control AFGControl
126. yntax Arguments Returns Examples TRACe DATA POINts Group Syntax 2 98 This command sets or queries whether to lock or unlock the user waveform memory Trace TRACe DATA LOCK STATE USER 1 USER2 USER3 USER4 ON OFF lt NR1 gt TRACe DATA LOCK STATe USER 1 USER2 USER3 USER4 ON or lt NR1 gt 0 locks the specified user waveform memory OFF or lt NR1 gt 0 unlocks the specified user waveform memory lt NR1 gt DATA LOCK STATe USERI ON locks the USER1 waveform memory This command sets or queries the number of data points for the waveform created in the edit memory Trace TRACe DATA POINtS EMEMory lt points gt MINimum MAXimum TRACe DATA POINts EMEMory MIN MAX AFG3000 Series Arbitrary Function Generator Programmer Manual Arguments Returns Examples TRG No Query Form Group Syntax Related Commands Arguments Examples Command Descriptions lt points gt lt NR1 gt where lt NR1 gt sets the number of points for the waveform created in the edit memory that ranges from 2 to 131072 lt NR1 gt DATA POINts EMEMory 500 sets the waveform data points to 500 in the edit memory This command generates a trigger event Trigger TRG TRIGger SEQuence IMMediate None TRG generates a trigger event TRIGger SEQuence SLOPe Group Syntax Arguments This command sets or queries the slope of trigger signal
127. ystem commands let you control miscellaneous instrument functions lists and describes System commands Table 2 14 System commands Header Description IDN Return identification information OPT Return option information RST Reset SY STem BEEPer IMMediate Generate an audible tone SY STem BEEPer STATe Set guery beeper state SYSTem ERRor NEXT Return error event queue SYSTem KCLick STATe Set query click sound SY STem KLOCK STATe Set guery front panel lock unlock SY STem PASSword CDISable Disable protected commands SY STem PASSword CENable Enable protected commands to function SY STem PASSword CENable STATe Return security protection state SY STem PASSword NEW Change current password SY STem SECurity IMMediate Reset to factory default SY STem ULANguage Set guery language for display screen SYSTem VERSion Return version information AFG3000 Series Arbitrary Function Generator Programmer Manual 2 15 Command Groups 2 16 Synchronization Commands Synchronization commands let you synchronize the operation of the instrument lists and describes Synchronization commands Table 2 15 Synchronization commands Header Description OPC Set query operation complete WAI Wait to continue Trace Commands Trace commands let you set the edit memory and user waveform memory lists and describes Trace commands Table 2 16 Trace commands Header Descrip

[SOURce[1|2]]

Contents

Download Pdf Manuals

Related Search

Related Contents