Table of Contents Getting Started Introduction ....................... Remote Control ....................GPIB Parameters ....................LAN Parameters ....................Connecting to the Instrument using GPIB ..............Setting Up GPIB Communication ................Documentation....................Sample Program ....................1-10 Syntax and Commands Command Syntax....................Syntax Overview..................... Command and Query Structure ................
Page 6
Table of Contents Command Descriptions ..................2-25 Status and Events Status and Event Reporting..................Status Reporting Structure .................. Registers ...................... Status Registers ....................Status Byte Register (SBR) ................. Standard Event Status Register (SESR) ..............Operation Enable Register (OENR) ............... Operation Condition Register (OCR)..............Operation Event Register (OEVR).................
Page 7
Table of Contents Appendix C: SCPI Conformance Information ............... Appendix D: Raw Socket Specification............... Appendix E: Factory Initialization Settings ..............Appendix F: Compatibility with Other Instruments ............AWG5000 and AWG7000 Series Programmer Manual...
Page 8
Table of Contents AWG5000 and AWG7000 Series Programmer Manual...
Introduction This online programmer guide provides you with the information to use commands for remotely controlling your instrument. With this information, write computer programs that will perform functions such as setting the front-panel controls, selecting clock source, setting sampling rate, and exporting data for use in other programs.
Remote Control Remote Control The instrument support GPIB interface and LAN interface. To set the GPIB address, use the System Menu > GPIB/LAN Configuration menu. GPIB Interface The GPIB enables up to 15 devices (including the controller) to be connected for concurrent use.
GPIB Parameters GPIB Parameters To use the GPIB, the instrument require you to configure the GPIB mode and the GPIB address. Talk/Listen: Select this mode to remotely control your instrument using an external computer as the controller. Off Bus: Select this mode to electronically disconnect the instrument from the GPIB bus.
LAN Parameters LAN Parameters In the instrument, set parameters to start or stop a process that communicates through LAN. The instrument can communicate with LAN using the following methods: VXI-11 Server (LAN): VXI-11 protocol is used through TekVISA. To use this protocol, TekVISA must also be installed on the remote controller (PC).
Connecting to the Instrument using GPIB Connecting to the Instrument using GPIB Your instrument has a 24-pin GPIB connector on its rear panel. This connector has a D-type shell and conforms to IEEE Std 488.1–1987. Attach an IEEE Std 488.1–1987 GPIB cable to this connector and to your controller as shown in the following figure.
Setting Up GPIB Communication Setting Up GPIB Communication Before setting up your instrument for remote communications using the electronic (physical) GPIB interface, you should familiarize yourself with the following GPIB requirements: A unique device address must be assigned to each device on the bus. No two devices can share the same device address.
Page 17
Setting Up GPIB Communication To change the GPIB address settings, do the following: 1. Select GPIB/LAN Configuration… from the System menu. AWG5000 and AWG7000 Series Programmer Manual...
Page 18
Setting Up GPIB Communication 2. The GPIB/LAN Configuration dialog box is displayed. 3. Change the GPIB Address to a unique address. 4. Click OK button. AWG5000 and AWG7000 Series Programmer Manual...
Verification Procedures procedures. These documents are available on the Documentation CD. Service Procedures Read the Service Manuals to service the instrument to the module level. The manuals are available on the Tektronix Web site (www.Tektronix.com/manuals). AWG5000 and AWG7000 Series Programmer Manual...
The sample program illustrates methods use to control the arbitrary waveform generator. This program sends waveform data and then starts waveform generation. Access the sample program from Windows Start menu. Select All Programs > Tektronix > AWG > Examples. This program is also included on the Document CD. 1-10...
Command Syntax Syntax Overview Control the operations and functions of the instrument through the GPIB and LAN 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 the Command Groups topic for a listing of the commands by command group or use the index to locate a specific command.
Page 24
Command Syntax Table 2-2: Message symbols and their meanings Symbol Meaning <Header> This is 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.
Command Syntax Clearing the Instrument Use the Device Clear (DCL) or Selected Device Clear (SDC) GPIB functions to clear the Output Queue and reset the instrument to accept a new command or query. Refer to your GPIB library documentation for further details about the Device Clear operation.
Page 26
Command Syntax Concatenating Use a semicolon (;) to concatenate any combination of set commands and queries. The instrument executes concatenated commands in the order received. When concatenating commands and queries, follow these rules: 1. Separate completely different headers by a semicolon and by the beginning colon on all commands except the first one.
Command Syntax For messages sent to the instrument, the end-of-message terminator must be the END message (EOI asserted concurrently with the last data byte). The instrument always terminates messages with LF and EOI. It allows white space before the terminator. For example, it allows CR LF. Parameter Types Parameters are indicated by angle brackets, such as <file_name>.
Page 28
Command Syntax Block Several instrument commands use a block argument form (see the following table). Table 2-5: Block symbols and their meanings Symbol Meaning <NZDig> A nonzero digit character in the range of 1–9 <Dig> <Dig> A digit character, in the range of 0–9 <DChar>...
Page 29
Command Syntax A quoted string can include any character defined in the 7-bit ASCII character set. Follow these rules when you use quoted strings: 1. Use the same type of quote character to open and close the string. For example: “this is a valid string”. 2.
Page 30
Command Syntax Omit the unit when you describe commands, but include the SI unit prefix. Enter both uppercase and lowercase characters. The following list shows examples of units you can use with the commands. V for voltage (V). HZ for frequency (Hz). OHM for impedance (ohm).
Command Syntax Since M (m) can be interpreted as 1E-3 or 1E6 depending on the units, use mV for V, and MHz for Hz. The SI prefixes need units. correct: 10MHz, 10E+6Hz, 10E+6 incorrect: 10M SCPI Commands and Queries The arbitrary waveform generator uses a command language based on the SCPI standard.
Page 32
Command Syntax 2-10 AWG5000 and AWG7000 Series Programmer Manual...
Command Groups Control group commands Use the following commands to control operating modes: Table 2-8: Control group commands and their descriptions Command Description AWGControl:APPLication:RUN Executes the specified application AWGControl:APPLication:STATe? Returns the running state of the specified application AWGControl:CLOCk:DRATe Sets or returns the divider rate for the external oscillator AWGControl:CLOCk:PHASe[:ADJust] Sets or returns the clock phase adjust...
Command Groups Table 2-8: Control group commands and their descriptions (cont.) Command Description AWGControl:RRATe Sets or returns the repetition rate of the arbitrary waveform generator AWGControl:RRATe:HOLD Sets or returns the hold property of repetition rate AWGControl:RSTate? Returns the state of the arbitrary waveform generator or sequencer AWGControl:RUN[:IMMediate] Initiates the output of a waveform or a...
Page 35
Command Groups Table 2-10: Diagnostic group commands and their descriptions Command Description DIAGnostic:DATA? Returns the result of a self test DIAGnostic[:IMMediate] Executes selected self test routines DIAGnostic:SELect Selects the self-test routines *TST? Executes a self test AWG5000 and AWG7000 Series Programmer Manual 2-13...
Command Groups Display Group Commands Use the following display commands to set the display state of waveform and sequence windows on the instrument: Table 2-11: Display group commands and their descriptions Command Description DISPlay[:WINDow[1|2]][:STATe] Minimizes or restores the sequence or waveform window of the arbitrary waveform generator Event Group Commands...
Command Groups Table 2-14: Mass Memory group commands and their descriptions Command Description MMEMory:CATalog? Returns the current contents and state of the mass storage media MMEMory:CDIRectory Sets or returns the current directory of the file system on the arbitrary waveform generator MMEMory:DATA Sets or returns block data to/from the file in the current mass storage device...
Command Groups Table 2-15: Output group commands and their descriptions Command Description OUTPut[n]:FILTer[:LPASs]:FREQuency Sets or returns the low pass filter frequency of the filter OUTPut[n][:STATe] Sets or returns the output state of the arbitrary waveform generator Sequence Group Commands Use the following sequence commands to define and edit a sequence: Table 2-16: Sequence group commands and their descriptions Command Description...
Command Groups There is only one sequence defined for an instrument. This is common to all channels. Refer to the AWG7000 and AWG5000 Series Arbitrary Waveform Generators Quick Start User Manuals for a discussion on sequencing waveforms. Creating and Working with To create a sequence programmatically, first set the sequence length using...
Page 40
Command Groups Table 2-18: Source group commands and their descriptions (cont.) Command Description [SOURce[n]]:COMBine:FEED Adds the signal from an external input to the output of the channel [SOURce[n]]:DAC:RESolution Sets or returns the DAC resolution [SOURce[n]]:DELay[:ADJust] Sets or returns the delay (in seconds) of the analog output [SOURce[n]]:DELay:POINts Sets or returns the delay (in points) of the...
Command Groups Table 2-18: Source group commands and their descriptions (cont.) Command Description [SOURce[n]]:VOLTage[:LEVel][:IMMediate][: Sets or returns the amplitude for the AMPLitude] waveform associated with a channel [SOURce[n]]:VOLTage[:LEVel][:IMMediate]: Sets or returns the high voltage level for the HIGH waveform associated with a channel [SOURce[n]]:VOLTage[:LEVel][:IMMediate]: Sets or returns the low voltage level for the waveform associated with a channel...
Command Groups Table 2-19: Status group commands and their descriptions (cont.) Command Description STATus:QUEStionable:ENABle Sets or returns the mask for Questionable Enable Register (QENR) STATus:QUEStionable[:EVENt]? Returns the status of the Questionable Event (QEVR) Register and clears it Subsequence Group Commands Use the following subsequence commands to define and edit a subsequence: Table 2-20: Subsequence group commands and their descriptions Command...
Command Groups System Group Commands Use the following system commands to control miscellaneous instrument functions: Table 2-22: System group commands and their descriptions Command Description *IDN? Returns identification information for the arbitrary waveform generator *OPT? Returns the implemented options for the arbitrary waveform generator *RST Resets the arbitrary waveform generator to...
Command Groups Table 2-23: Trigger group commands and their descriptions (cont.) Command Description TRIGger[:SEQuence]:TIMer Sets or returns the internal trigger rate (trigger interval) TRIGger[:SEQuence]:WVALue Sets or returns the output data position of a waveform while the instrument is in the waiting-for-trigger state Waveform Group Commands Use the following waveform commands to create and transfer waveforms between...
Page 45
Command Groups Waveform Data Format The instrument support two types of waveform data – Integer format and Floating Point format. Integer format is useful when you want to transfer data faster. It also speeds up restoring data from AWG setup file ( file) thereby making loading faster.
Page 46
Command Groups DAC resolution affects the way hardware interprets the bits in the waveform. Therefore it is necessary to reload waveforms once the DAC resolution is modified. To understand how to change the DAC resolution, see the [SOURce[n]]:DAC:RESolution command. To understand how to load a waveform into hardware memory see the [SOURce[n]]:WAVeform command.
Command Descriptions ABORt (No Query Form) This command stops waveform generation when the arbitrary waveform generator is in gated mode. This is equivalent to releasing the Trig button on the front panel when the instrument is in gated mode. Group Trigger Syntax ABORt...
Page 48
Only 1, 2, 4, 8… are valid values. Errors for the AWG5000 series are –222 and –224. The –222, which is out of range, is produced when a value is greater than 32 and less than or equal to 256.
Page 49
Command Descriptions Examples sets the divider rate to 8. AWGCONTROL:CLOCK:DRATE 8 returns 8. AWGCONTROL:CLOCK:DRATE? AWGControl:CLOCk:PHASe[:ADJust] (AWG7000B and AWG7000C Series only) This command and query sets or returns the clock phase adjust. It is used to adjust the internal clock phase of the instrument to synchronize or align timing with external devices.
Page 50
Command Descriptions Syntax AWGControl:CLOCk:SOURce <source> AWGControl:CLOCk:SOURce? Related Commands AWGControl:APPLication:STATe? Arguments ::={EXTernal|INTernal} <source> specifies that the clock signal from external oscillator is used. EXTernal specifies that the clock signal is generated internally. INTernal At *RST, this value is set to INTernal. Returns EXT|INT Examples...
Page 51
Command Descriptions Syntax AWGControl:CONFigure:CNUMber? None Related Commands Returns <NR1> Returns 1, 2, or 4 depending on the model. Examples might return 2. AWGCONTROL:CONFIGURE:CNUMBER? AWGControl:DC[n][:STATe] This commands and query sets or returns the output state of one of the four DC outputs.
Page 52
Command Descriptions AWGControl:DC[n]:VOLTage[:LEVel][:IMMediate]:OFFSet This command and query sets or returns the DC output level. The value of n = 1|2|3|4. Group Control Syntax AWGControl:DC[n]:VOLTage[:LEVel][:IMMediate]:OFFSet <offset> AWGControl:DC[n]:VOLTage[:LEVel][:IMMediate]:OFFSet? Related Commands AWGControl:DC[n][:STATe] Arguments ::=<NR3> the value will be between –3.0 V to +5.0 V. <offset>...
Page 53
Command Descriptions Arguments ::= <Boolean> <state> indicates OFF indicates ON At *RST, this returns 0. <state> Returns Examples causes the instrument to output raw DAC AWGCONTROL:DOUTPUT1:STATE 1 waveform from Channel 1. AWGControl:ENHanced:SEQuence:JMODe This command and query sets or returns the jump mode. This command is available for the AWG5012B, AWG5000C, and AWG7000C with option 09.
Page 54
Jump Mode to Event Jump. The jump targets defined EJUMp in the sequence definition table will be used as the jump target. In this mode, the instrument behavior for the event jump is the same as that of the AWG7000/AWG5000 series. 2-32 AWG5000 and AWG7000 Series Programmer Manual...
Page 55
Command Descriptions sets the Jump Mode to Dynamic Jump. The Dynamic Jump target DJUMp definitions are used as the jump target. This is also known as Table Jump. The jump command is always available in both the modes. At *RST, this returns EJUMp. Examples sets the Jump Mode to Dynamic Jump.
Page 56
Command Descriptions Group Control Syntax AWGControl:EVENt:TABLe[:IMMediate] Related Commands AWGControl:ENHanced:SEQuence:JMODe, EVENt[:IMMediate] Examples generates an event signal for Table AWGCONTROL:EVENT:TABLE[:IMMEDIATE] Jump. AWGControl:INTerleave:ADJustment:AMPLitude This command and query sets or returns the interleave adjustment amplitude. This command is available only for Option 06. This setting is only valid when the interleave state is On.
Page 57
Command Descriptions AWGControl:INTerleave:ADJustment:PHASe This command and query sets or returns the interleave adjustment phase. This command is available only for Option 06. This setting is only valid when the interleave state is On. Group Control Syntax AWGControl:INTerleave:ADJustment:PHASe <NR3> AWGControl:INTerleave:ADJustment:PHASe? Related Commands AWGControl:INTerleave[:STATe] Arguments <NR3>...
Page 58
Command Descriptions NOTE. Switching the interleave state from ON to OFF will not restore the sequence CH2 waveforms. Also once the coupled state is lost, it is not restored. Marker data cannot be interleaved. Only even marker data is output when the interleave state is ON. Group Control Syntax...
Page 59
Command Descriptions Syntax AWGControl:INTerleave:ZERoing <state> AWGControl:INTerleave:ZERoing? Related Commands AWGControl:INTerleave[:STATe] Arguments ::=<Boolean> <state> indicates OFF indicates ON At *RST, this returns 0. <state> Returns Examples turns on the zeroing function. AWGCONTROL:INTERLEAVE:ZEROING 1 AWGControl:RMODe This command and query sets or returns the run mode of the arbitrary waveform generator.
Page 60
Command Descriptions Returns CONT|TRIG|GAT|SEQ Examples sets the instrument Run mode to Triggered. AWGCONTROL:RMODE TRIGGERED returns CONT if the instrument is in continuous mode. AWGCONTROL:RMODE? The following table lists the run modes and their descriptions: Argument Description CONTinuous Selects the continuous mode, which continuously outputs the waveform.
Page 61
Command Descriptions Arguments ::=<NR3> <repetition_rate> At *RST, this value is 10 MHz. Returns <NR3> Examples sets the repetition rate to 1MHz. AWGCONTROL:RRATE 1000000 returns 1E+6. AWGCONTROL:RRATE? AWGControl:RRATe:HOLD This command and query sets or returns the hold property of repetition rate. Setting this to ON keeps the repetition rate of the instrument constant even when the waveform size changes.
Page 62
Command Descriptions Group Control Syntax AWGControl:RSTate? Related Commands AWGControl:RMODe, AWGControl:RUN[:IMMediate] Returns <NR1> 0 indicates that the instrument has stopped. 1 indicates that the instrument is waiting for trigger. 2 indicates that the instrument is running. Examples might return 0 if the instrument waveform generation is AWGCONTROL:RSTATE? stopped.
Page 63
Command Descriptions Related Commands AWGControl:SEQuencer:TYPE? Returns <NR1> At *RST, this value is 1. Examples might return 100. AWGCONTROL:SEQUENCER:POSITION? AWGControl:SEQuencer:TYPE? (Query Only) This query returns the type of the arbitrary waveform generator's sequencer. The sequence is executed by the hardware sequencer whenever possible. Group Control Syntax...
Page 64
Command Descriptions Returns <file_name>,<msus> <file_name>::=<string> <msus> (mass storage unit specifier)::=<string> At *RST, this values is “”,“C:” Examples might return the following response: AWGCONTROL:SNAME? “\my\project\awg\setup\a1.awg”,“D:” AWGControl:SREStore (No Query Form) This command restores the arbitrary waveform generator’s setting from a specified settings file. The drive may be a local or a network drive. If the full path is not specified, the file will be stored in the current path.
Page 65
Command Descriptions Arguments ::=<string> <file_name> (mass storage unit specifier)::=<string> <msus> Examples will save AWGCONTROL:SSAVE “\my\project\awg\setup\x.awg”,“D:” the current setup to “D:\my\project\awg\setup\x.awg” AWGControl:STOP[:IMMediate] (No Query Form) This command stops the output of a waveform or a sequence. Group Control Syntax AWGControl:STOP[:IMMediate] Related Commands AWGControl:RUN[:IMMediate] Examples stops the output of a waveform.
Page 66
Command Descriptions CALibration[:ALL] This command does a full calibration of the arbitrary waveform generator. In its query form, the command does a full calibration and returns a status indicating the success or failure of the operation. is equivalent CALibration[:ALL]? *CAL? Group Calibration Syntax...
Page 67
Command Descriptions DIAGnostic:DATA? (Query Only) This command returns the results of a self test. Group Diagnostic Syntax DIAGnostic:DATA? Related Commands DIAGnostic[:IMMediate], DIAGnostic:SELect Returns <NR1> 0 indicates no error. –330 indicates that the self test failed. Examples might return 0, which indicates that the diagnostics DIAGNOSTIC:DATA? completed without any errors.
Page 68
AREGister – AWG register read back A1Memory – CH1 waveform memory test A2Memory – CH2 waveform memory test A3Memory – CH3 waveform memory test (for AWG5000 series only) A4Memory – CH4 Waveform memory test (for AWG5000 series only) CREGister – Clock register read back CPLock –...
Page 69
Command Descriptions Returns ALL|FPAN|AREG|DTIM|A1M|A2M|A3M|A4M|CREG|CPL|O1R|O1AL|O1ML| O2R|O2AL|O2ML Examples selects the front panel read/write access test. DIAGNOSTIC:SELECT FPANEL DISPlay[:WINDow[1|2]][:STATe] This command minimizes or restores the sequence or waveform window of the arbitrary waveform generator. This command only minimizes or restores the display area; it does not close the window. There is no maximizing. WINDow1 –...
Page 70
Command Descriptions Syntax *ESE <NR1> *ESE? Related Commands *CLS, *ESR?, *SRE, *STB? Arguments <NR1> Returns <NR1> Examples sets the ESER to 177 (binary 10110001), which sets the PON, CME, *ESE 177 EXE and OPC bits. *ESR? (Query Only) This query returns the status of Standard Event Status Register. Group Status Syntax...
Page 71
Command Descriptions Syntax EVENt[:IMMediate] Related Commands EVENt:IMPedance, EVENt:JTIMing, EVENt:LEVel, EVENt:POLarity Examples generates the event signal. EVENT:IMMEDIATE EVENt:IMPedance This command and query sets or returns the impedance of the external event input. Valid values are 50 ohm or 1 kohm. Group Event Syntax EVENt:IMPedance <ohms>...
Page 72
Command Descriptions Related Commands EVENt[:IMMediate], EVENt:IMPedance, EVENt:LEVel, EVENt:POLarity Arguments ::={SYNChronous|ASYNchronous} <jump_type> indicates jump occurs immediately. SYNChronous indicates jump occurs after the signal generation is finished. ASYNchronous At *RST, this returns ASYNchronous. Returns SYNC|ASYN Examples sets the jump to asynchronous type. EVENT:JTIMING ASYNCHRONOUS EVENt:LEVel This command and query sets or returns the event level.
Page 73
*IDN? Related Commands None Returns <Manufacturer>, <model>, <serial number>, <Firmware version> <Manufacturer>:: = TEKTRONIX <Model>:: = AWG7122C, AWG7082C, AWG7121B, AWG7122B, AWG7061B, AWG7062B, AWG5012C, AWG5014C, AWG5002C, AWG5012B, AWG5014B, AWG5002B, AWG5004B <Serial number>:: = XXXXXXX (indicates an actual serial number) <Firmware version>:: = SCPI: 99.0 FW:x.x.x.x (x.x.x.x is system software...
Page 74
Command Descriptions Examples might return the following response: *IDN? TEKTRONIX,AWG7122B,B010123,SCPI:99.0 FW:3.0.136.602 INSTrument:COUPle:SOURce This command and query sets or returns the coupled state for a channel. NOTE. When coupling is done, CH1 can be coupled to CH2, CH3 and CH4. CH3 can be coupled to CH4.
Page 75
Command Descriptions MMEMory:CATalog? (Query Only) This query returns the current contents and state of the mass storage media. Group Mass memory Syntax MMEMory:CATalog? [<msus>] Related Commands MMEMory:CDIRectory, MMEMory:MSIS Arguments (mass storage unit specifier)::=<string> <msus> Returns <NR1>,<NR1>[,<file_entry>] The first <NR1> indicates the total amount of storage currently used in bytes. The second <NR1>...
Page 76
Command Descriptions None Related Commands Arguments ::=<string> <directory_name> Returns <directory_name> Examples changes the current directory to MMEMORY:CDIRECTORY "/AWG/WORK0" /AWG/WORK0. MMEMory:DATA This command and query sets or returns block data to/from the file in the current mass storage device. NOTE. The file is always transferred to the path mentioned along with the file name on the target.
Page 77
Command Descriptions file_name – string having file name and path. Examples loads data into the file FILE1. MMEMORY:DATA "FILE1",#41024XXXXX... MMEMory:DELete (No Query Form) This command deletes a file or directory from the instrument's hard disk. When used on a directory, this command succeeds only if the directory is empty. Group Mass memory Syntax...
Page 78
Command Descriptions TXT14 – Text file with 14-bit DAC resolution (AWG5000 Series only) WFM – AWG400/AWG500/AWG600/AWG700 Series waveform Group Mass memory Syntax MMEMory:EXPort <wfm_name>,<filename>,<type> Related Commands None Arguments <wfm_name>,<filename>,<type> ::=<string> <wfm_name> ::=<string> <filename> = {TXT|TXT8|TXT10|TXT14|WFM} <type> Examples "sine1024","sine1024.txt",txt exports a waveform named MMEMORY:EXPORT "sine1024"...
Page 79
Command Descriptions WFM – AWG400/AWG500/AWG600/AWG700 Series waveform PAT – AWG400/AWG500/AWG600/AWG700 Series pattern file TFW – AFG3000 Series waveform file format IQT – RSA3000 Series waveform file format TIQ – RSA6000 Series waveform file format Group Mass memory Syntax MMEMory:IMPort <wfm_name>,<filename>,<type> Related Commands MMEMory:IMPort:PARameter:FREQuency[:UPDate][:STATe], MMEMory:...
Page 80
Command Descriptions Arguments ::=<Boolean> <state> indicates OFF indicates ON At *RST, this returns 1. <state> Returns Examples the instrument MMEMORY:IMPORT:PARAMETER:FREQUENCY:UPDATE:STATE 1 will automatically modify the sampling rate when importing the waveform data. MMEMory:IMPort:PARameter:LEVel[:UPDate]:CHANnel This command sets or queries the channel for which the amplitude and offset values will be updated during import.
Page 81
Command Descriptions MMEMory:IMPort:PARameter:LEVel[:UPDate][:STATe] This command sets or queries the LEVel parameter which determines whether amplitude and offsets are modified during waveform import. If this value is set, the instrument amplitude and offset are automatically updated during waveform import. Group Mass memory Syntax MMEMory:IMPort:PARameter:LEVel[:UPDate][:STATe] <state>...
Page 82
Command Descriptions Related Commands MMEMory:IMPort, MMEMory:IMPort:PARameter:LEVel[:UPDate][:STATe] Arguments ::={IDATa|QDATa} <Type> indicates that the instrument imports I data. IDATa indicates that the instrument imports Q data. QDATa At *RST, the value is IDATa. Returns IDAT|QDAT Examples sets I data to be MMEMORY:IMPORT:PARAMETER:LEVEL:UPDATE:TYPE IDATA imported while importing an RSA file.
Page 83
Command Descriptions At *RST, this returns NONE. Returns NONE|FSC|ZREF Examples will not normalize the MMEMORY:IMPORT:PARAMETER:NORMALIZE NONE imported data. MMEMory:IMPort:PARameter:RESampling:FREQuency This command sets or queries the sampling rate parameter for resampling. The specified sampling rate is applied to imported waveform. NOTE. This command will take effect only when the MMEMory:IMPort: PARameter:FREQuency[:UPDate][:STATe]...
Page 84
Command Descriptions Waveform data to be imported must have sampling rate information. MMEMory:IMPort:PARameter:FREQuency[:UPDate][:STATe] command must be set to True. Use this command to set the resampling state on or off. If you set the resampling state on, resampling is automatically invoked when importing waveform data. The query form of this command returns the resampling state of the instrument.
Page 85
Command Descriptions Arguments ::=<string> specifies a new directory. <directory_name> Examples makes the directory “WAVEFORM”. MMEMORY:MDIRECTORY "WAVEFORM" MMEMory:MSIS This command and query selects or returns a mass storage device used by all MMEMory commands. <msus> specifies a drive using a drive letter. The drive letter can represent hard disk drives, network drives, DVD/CD-RW drives, or USB memory.
Page 86
Command Descriptions Returns <NR1> <NR1>=1 when all pending operations are finished. Examples might return 1 to indicate that all pending OPC operations are finished. *OPC? *OPT? (Query Only) This command returns the implemented options for the arbitrary waveform generator. Group System Syntax *OPT?
Page 87
Command Descriptions Returns <NR3> Examples sets the cutoff frequency of the OUTPUT1:FILTER:LPASS:FREQUENCY 200MHZ low-pass filter for CH 1 to 200 MHz. OUTPut[n][:STATe] This command and query sets or returns the output state of the arbitrary waveform generator. Setting the output state of a channel to ON will switch on its analog output signal and marker.
Page 88
Command Descriptions Examples resets the instrument. *RST SEQuence:ELEMent[n]:GOTO:INDex This command and query sets or returns the target index for the GOTO command of the sequencer. After generating the waveform specified in a sequence element, the sequencer jumps to the element specified as GOTO target. This is an unconditional jump. If GOTO target is not specified, the sequencer simply moves on to the next element.
Page 89
Command Descriptions Syntax SEQuence:ELEMent[n]:GOTO:STATe <goto_state> SEQuence:ELEMent[n]:GOTO:STATe? Related Commands SEQuence:ELEMent[n]:GOTO:INDex, SEQuence:LENGth Arguments ::=<Boolean> <goto_state> indicates OFF indicates ON At *RST, this returns 0. The value of <n> is an index number of sequence. Returns <NR1> Examples sets the GOTO state to ON. SEQUENCE:ELEMENT1:GOTO:STATE 1 SEQuence:ELEMent[n]:JTARget:INDex This command and query sets or returns the target index for the...
Page 90
Command Descriptions SEQuence:ELEMent[n]:JTARget:TYPE This command and query sets or returns the event jump target type for the jump. Generate an event in one of the following ways: By connecting an external cable to instrument rear panel for external event. By pressing the Force Event button on the front panel. By sending the EVENt[:IMMediate] remote command.
Page 91
Command Descriptions Related Commands SEQuence:ELEMent[n]:LOOP:INFinite, SEQuence:LENGth Arguments <NR1> The value ranges between 1 and 65,536. At *RST, this returns 1. The value of n is an index number of sequence. Returns <NR1> Examples sets the element loop count to 100. SEQUENCE:ELEMENT:LOOP:COUNT 100 SEQuence:ELEMent[n]:LOOP:INFinite This command and query sets or returns the infinite looping state for a...
Page 92
Command Descriptions SEQuence:ELEMent[n]:SUBSequence This command and query sets or returns the subsequence for a sequence element. The AWG5012B, AWG5000C, and AWG7000C (option 09) series instruments support Subsequence. The subsequence name can be a null string (“”). When a waveform is assigned to this sequence, the command returns “”.
Page 93
Command Descriptions Related Commands SEQuence:LENGth Arguments ::=<Boolean> <wait_trigger_state> indicates OFF indicates ON At *RST, this returns 0. In the OFF state, the sequencer ignores trigger signals. The value of <n> is an index number of sequence. NOTE. The instrument without option 08 always sets Wait Trigger On. Trying to set the wait trigger state to off in an instrument without option 08 will cause an error.
Page 94
Command Descriptions Arguments >::=<string> <wfm_name Returns <wfm_name> Examples sets the SEQUENCE:ELEMENT1:WAVEFORM1 “*TRIANGLE1000” “*Triangle1000” waveform into the first element of the sequence. might return “*Sine1000” indicating that SEQUENCE:ELEMENT20:WAVEFORM1? the waveform named *Sine1000 is assigned to index number 20 of the channel 1 sequence.
Page 95
Command Descriptions Syntax SEQuence:LENGth <NR1> SEQuence:LENGth? Related Commands None Arguments <NR1> At *RST, this returns 0. Returns <NR1> Examples creates a sequence of 10 elements initializing all SEQUENCE:LENGTH 10 sequence parameters to default values. will now return 10. SEQUENCE:LENGTH? will append two elements to the end of the above created SEQUENCE:LENGTH 12 sequence and initialize the new elements’...
Page 96
Command Descriptions SLISt:SIZE? (Query Only) This query returns the size of the subsequence list. Group Subsequence Syntax SLISt:SIZE? Related Commands SLISt:NAME? Returns <NR1> Examples returns the number of existing subsequences. SLIST:SIZE? SLISt:SUBSequence:DELete (No Query Form) This command deletes the subsequence from the currently loaded setup. NOTE.
Page 97
Command Descriptions SLISt:SUBSequence:ELEMent[n]:LOOP:COUNt This command and query sets or returns the loop count for the specified subsequence element. The loop count is an integer. Group Subsequence Syntax SLISt:SUBSequence:ELEMent[n]:LOOP:COUNt <subseq_name>,<NR1> SLISt:SUBSequence:ELEMent[n]:LOOP:COUNt? <subseq_name> Arguments <NR1> At *RST, this returns 0. Returns <NR1> Examples sets the loop SLIST:SUBSEQUENCE:ELEMENT5:LOOP:COUNT “MYTEST”,11...
Page 98
Command Descriptions Related Commands SLISt:NAME?, SLISt:SUBSequence:NEW Arguments ::=<string> <subseq_name> ::=<string> <wfm_name> Returns <wfm_name> Examples sets SLIST:SUBSEQUENCE:ELEMENT5:WAVEFORM2 “MYTEST”,“*SINE360” the waveform “*Sine360” to the fifth index element of the CH2 subsequence named “mytest”. might return SLIST:SUBSEQUENCE:ELEMENT5:WAVEFORM2? “MYTEST” “*Sine360”, which indicates that the waveform named “*Sine360” is assigned to index element five of the CH2 subsequence named “mytest”.
Page 99
Command Descriptions Syntax SLISt:SUBSequence:NEW <subseq_name>,<length> Arguments ::=<string> <subseq_name> Examples creates a subsequence named SLIST:SUBSEQUENCE:NEW “MYTEST”,100 of length 100. “mtest” SLISt:SUBSequence:TSTamp? (Query Only) This query returns the time stamp of the subsequence. Time stamp is updated whenever the subsequence is created or changed. It is not updated when it is renamed.
Page 100
Command Descriptions Note that the frequency of the waveform output by the instrument is calculated as: The minimum number of points in a waveform for the instrument is 1. Group Source Syntax [SOURce[1]]:FREQuency[:CW|:FIXed] <NR3> [SOURce[1]]:FREQuency[:CW|:FIXed]? Related Commands [SOURce[n]]:WAVeform, AWGControl:INTerleave[:STATe] Arguments .
Page 101
Command Descriptions Returns <NR3> Examples sets the reference oscillator SOURCE1:ROSCILLATOR:FREQUENCY 10MHZ source frequency to 10 MHz. might return 1.00000000E+7. SOURCE1:ROSCILLATOR:FREQUENCY? [SOURce[1]]:ROSCillator:MULTiplier This command and query sets or returns the ROSCillator multiplier rate. This parameter is valid only when Clock Source is Internal and Reference Source is External and External Reference Type is Variable.
Page 102
Command Descriptions Syntax [SOURce[1]]:ROSCillator:SOURce {INTernal|EXTernal} [SOURce[1]]:ROSCillator:SOURce? Related Commands [SOURce[1]]:ROSCillator:FREQuency, [SOURce[1]]:ROSCillator:TYPE Arguments <INTernal|EXTernal> – The reference frequency is derived from the internal precision INTernal oscillator. – The reference frequency is derived from an external signal supplied EXTernal through the reference clock input. At *RST, this returns INTernal.
Page 103
fixed frequency external SOURCE1:ROSCILLATOR:TYPE FIXED reference oscillator. The frequency is fixed to 10 MHz, 20 MHz, or 100 MHz. [SOURce[n]]:COMBine:FEED (AWG5000 Series only) This command adds the signal from an external input to the output of the channel. NOTE.
Page 104
When the resolution changes to 10-bit, marker data will not be available. AWG5000 Series instruments support only 14-bit resolution. Therefore this command will have no effect for these instruments. DAC resolution is independent for each channel in AWG7000 Series instruments.
Page 105
Command Descriptions Group Source Syntax [SOURce[n]]:DELay[:ADJust] <NR3> [SOURce[n]]:DELay[:ADJust]? Related Commands [SOURce[n]]:DELay:POINts, [SOURce[n]]:PDELay:HOLD, [SOURce[n]]: PHASe[:ADJust] Arguments <NR3> At *RST, this returns 0 s. Returns <NR3> Examples sets the analog output delay for channel 1 to 20 SOURCE1:DELAY:ADJUST 20PS picoseconds. [SOURce[n]]:DELay:POINts This command and query sets or returns the delay (in points) of the analog output. NOTE.
Page 106
SOURCE1:DIGITAL:VOLTAGE:LEVEL:IMMEDIATE:AMPLITUDE 1.4 digital output amplitude level to 1.4 volts. [SOURce[n]]:DIGital:VOLTage[:LEVel][:IMMediate]:HIGH (AWG5000 Series only) This command and query sets or returns the high digital output. This command is available only for AWG5000B and AWG5000C instruments with option 03. Group...
Page 107
SOURCE1:DIGITAL:VOLTAGE:LEVEL:IMMEDIATE:HIGH 1.4 output high level to 1.4 volts. [SOURce[n]]:DIGital:VOLTage[:LEVel][:IMMediate]:LOW (AWG5000 Series only) This command and query sets or returns the low digital output. This command is available only for AWG5000B and AWG5000C instruments with option 03. Group...
Page 108
Command Descriptions [SOURce[n]]:DIGital:VOLTage[:LEVel][:IMMediate]:OFFSet (AWG5000 Series only) This command and query sets or returns the offset of digital output. This command is available only for AWG5000B and AWG5000C instruments with option 03. Group Source Syntax [SOURce[n]]:DIGital:VOLTage[:LEVel][:IMMediate]:OFFSet <NR3> [SOURce[n]]:DIGital:VOLTage[:LEVel][:IMMediate]:OFFSet? Related Commands [SOURce[n]]:DIGital:VOLTage[:LEVel][:IMMediate]:HIGH,...
Page 109
Command Descriptions [SOURce[n]]:FUNCtion:USER This command and query sets or returns the waveform to waveform memory. Use this command to directly load an AWG400/500/600/700 series waveform (WFM), pattern file (PAT), or sequence (SEQ) file from mass memory to a specified channel. However, when loading a sequence file, the SOURce’s suffix is ignored.
Page 110
Command Descriptions In the AWG7000 Series when DAC resolution is changed to 10 bits, marker output is not available. However, marker related parameters can be modified using SCPI commands. Group Source Syntax [SOURce[n]]:MARKer[1|2]:DELay <NR3> [SOURce[n]]:MARKer[1|2]:DELay? Related Commands [SOURce[n]]:DAC:RESolution Arguments <NR3> The value of n indicates the channel number.
Page 111
Command Descriptions Arguments <NR3> The value of n indicates the channel number. At *RST, this returns 1 Vpp. Returns <NR3> Examples sets the channel1 SOURCE1:MARKER1:VOLTAGE:AMPLITUDE 0.5V marker1amplitude to 0.5 volts. might return 0.5 volts. SOURCE1:MARKER1:VOLTAGE:AMPLITUDE? [SOURce[n]]:MARKer[1|2]:VOLTage[:LEVel][:IMMediate]:HIGH This command sets the marker high level. In the AWG7000 Series, when DAC resolution is changed to 10 bits, marker output is not available.
Page 112
Command Descriptions [SOURce[n]]:MARKer[1|2]:VOLTage[:LEVel][:IMMediate]:LOW This command sets the marker low level. In the AWG7000 Series, when the DAC resolution is changed to 10 bits, marker output is not available. However, marker related parameters can be modified using SCPI commands. Refer to the User Online Help for the setting range of marker high and marker low. Group Source Syntax...
Page 113
Command Descriptions Related Commands [SOURce[n]]:DAC:RESolution, [SOURce[n]]:MARKer[1|2]:VOLTage[:LEVel][: IMMediate]:HIGH, [SOURce[n]]:MARKer[1|2]:VOLTage[:LEVel][:IMMediate]: Arguments <NR3> The value of n indicates the channel number. At *RST, this returns 0.5 V. Returns <NR3> Examples sets the offset channel1 marker1 to SOURCE1:MARKER1:VOLTAGE:OFFSET 1.0 1 V. [SOURce[n]]:PDELay:HOLD This command and query sets or returns the parameter that is retained when sampling rate or waveform length is changed.
Page 114
Command Descriptions [SOURce[n]]:PHASe[:ADJust] (AWG5000 Series only) This command and query sets or returns the phase of the analog output. NOTE. The effect of this command can be seen only in non-sequence mode. This command does not change the waveform display on the user interface.
Page 115
Command Descriptions Arguments <NR3> –100 ps to +100 ps. It can be changed by a minimum of 1 ps at a time. The value of n indicates the channel number. At *RST, this returns 0 s. Returns <NR3> Examples sets the skew for channel2 to 75 ps. SOURCE2:SKEW 75PS might return 7.50000000E-011, indicating that the skew is 75 ps.
Page 116
Command Descriptions [SOURce[n]]:VOLTage[:LEVel][:IMMediate]:HIGH This command and query sets or returns the high voltage level for the waveform associated with a channel. The command is not available on instruments with the Option 02 or Option 06 installed. Group Source Syntax [SOURce[n]]:VOLTage[:LEVel][:IMMediate]:HIGH <NR3> [SOURce[n]]:VOLTage[:LEVel][:IMMediate]:HIGH? Related Commands [SOURce[n]]:VOLTage[:LEVel][:IMMediate]:LOW...
Page 117
Command Descriptions Returns <NR3> Examples sets the channel1 low to 0.25 volts. SOURCE1:VOLTAGE:LOW 0.25 [SOURce[n]]:VOLTage[:LEVel][:IMMediate]:OFFSet This command and query sets or returns the offset for the waveform associated with a channel. The command is not available on instruments with Option 02 or Option 06 installed.
Page 118
Command Descriptions Syntax [SOURce[n]]:WAVeform <wfm_name> [SOURce[n]]:WAVeform? Related Commands [SOURce[n]]:FUNCtion:USER Arguments ::=<string> <wfm_name> The value of n indicates the channel number. Returns <wfm_name> Examples loads a predefined waveform called SOURCE1:WAVEFORM “*SINE100” “*Sine100” into channel1 memory. might return “*Sine100”. SOURCE1:WAVEFORM? *SRE This command sets or queries the bits in Service Request Enable register. Group Status Syntax...
Page 119
Command Descriptions STATus:OPERation:CONDition? (Query Only) This query returns the contents of the Operation Condition Register. Note that the OCR is not used in the arbitrary waveform generator. Group Status Syntax STATus:OPERation:CONDition? Related Commands STATus:OPERation:ENABle, STATus:OPERation[:EVENt]? Returns <NR1> STATus:OPERation:ENABle This command and query sets or returns the mask for the Operation Enable Register.
Page 120
Command Descriptions Syntax STATus:OPERation[:EVENt]? Related Commands STATus:OPERation:CONDition?, STATus:OPERation:ENABle Returns <NR1> STATus:PRESet (No Query Form) This command sets the OENR and QENR registers. Group Status Syntax STATus:PRESet Related Commands None Examples resets the SCPI enable registers. STATUS:PRESET STATus:QUEStionable:CONDition? (Query Only) This query returns the status of the Questionable Condition Register. Note that the QCR is not used in the arbitrary waveform generator.
Page 121
Command Descriptions Note that the QENR is not used in the arbitrary waveform generator. Group Status Syntax STATus:QUEStionable:ENABle <NR1> STATus:QUEStionable:ENABle? Related Commands STATus:QUEStionable:CONDition?, STATus:QUEStionable[:EVENt]? Returns <NR1> STATus:QUEStionable[:EVENt]? (Query Only) This query returns the status of the QEVR register and clears it. Group Status Syntax...
Page 122
Command Descriptions Returns <NR1> Examples might return 96, which indicates that the SBR contains the binary number *STB? 0110 0000. SYSTem:DATE This command and query sets or returns the system date. When the values are nonintegers, they are rounded off to nearest integral values. Group System Syntax...
Page 123
Command Descriptions 0 – No Error Error / event number <NR1> error / event description <string> Examples might return the following response: SYSTEM:ERROR:NEXT? –102,”Syntax error;possible invalid suffix - :SOUR:FREQ 2V” This response indicates that the unit is invalid. SYSTem:KLOCk This command locks or unlocks the keyboard and front panel of the arbitrary waveform generator.
Page 124
Command Descriptions SYSTem:TIME This command and query sets or returns the system time. When the values are nonintegers, they are rounded off to nearest integral values. Group System Syntax SYSTem:TIME <hour>,<minute>,<second> SYSTem:TIME? Related Commands None Arguments <hour>,<minute>,<second> ::=<NRf> from 0 to 23 <hour>...
Page 125
Command Descriptions *TRG (No Query Form) This command generates a trigger event. This is equivalent to pressing Trig button on front panel. Group Trigger Syntax *TRG Related Commands TRIGger[:SEQuence][:IMMediate] Examples generates a trigger event. *TRG TRIGger[:SEQuence][:IMMediate] (No Query Form) This command generates a trigger event. This is equivalent to *TRG. Group Trigger Syntax...
Page 126
Command Descriptions Arguments ::=<NR3> the value will be 50 and 1000. <impedance> At *RST, this returns 1000 Ω. Returns <NR3> Examples selects 50 Ω impedance for the external TRIGGER:SEQUENCE:IMPEDANCE 50 trigger input. TRIGger[:SEQuence]:LEVel This command and query sets or returns the trigger input level (threshold). Group Trigger Syntax...
Page 127
Command Descriptions Related Commands TRIGger[:SEQuence]:SOURce Arguments >::={SYNChronous|ASYNchronous} <trigger_type SYNChronous does not lower trigger jitter. ASYNchronous lowers trigger jitter. At *RST, this returns ASYNchronous. Returns SYNC|ASYN Examples sets the trigger timing to TRIGGER:SEQUENCE:MODE ASYNCHRONOUS asynchronous type. TRIGger[:SEQuence]:POLarity This command and query sets or returns the trigger input polarity. It is used to set polarity in gated mode.
Page 128
Command Descriptions TRIGger[:SEQuence]:SLOPe This command and query sets or returns the trigger slope. It is used to set polarity in modes other than gated mode. Group Trigger Syntax TRIGger[:SEQuence]:SLOPe {POSitive|NEGative} TRIGger[:SEQuence]:SLOPe? Related Commands TRIGger[:SEQuence]:SOURce Arguments means that the event occurs on the rising edge of the external trigger POSitive signal.
Page 129
Command Descriptions Returns INT|EXT Examples selects the internal clock as the trigger TRIGGER:SEQUENCE:SOURCE INTERNAL source. TRIGger[:SEQuence]:TIMer This command and query sets or returns the internal trigger rate (trigger interval). Group Trigger Syntax TRIGger[:SEQuence]:TIMer <NR3> TRIGger[:SEQuence]:TIMer? Related Commands TRIGger[:SEQuence]:SOURce Arguments <NR3> At *RST, this returns 100 ms.
Page 130
Command Descriptions Arguments specifies the first value of the waveform as the output level. FIRSt specifies the last value of the waveform as the output level. LAST At *RST, this returns FIRSt. Returns FIRS|LAST Examples selects the last value as the output level. TRIGGER:SEQUENCE:WVALUE LAST *TST? (Query Only) This query executes a self test and returns the results.
Page 131
Command Descriptions Examples prevents the execution of any commands or queries until all pending *WAI operations complete. WLISt:NAME? (Query Only) This query returns the waveform name of an element in the waveform list. This query can be used to query the waveform name in the waveform list. Group Waveform Syntax...
Page 132
Command Descriptions WLISt:WAVeform:DATA This command transfers waveform data from the external controller into the waveform list or from the waveform list to the external control program. NOTE. Before transferring data to the instrument, a waveform must be created using the WLISt:WAVeform:NEW command.
Page 133
Command Descriptions Syntax WLISt:WAVeform:DATA <wfm_name>[,<StartIndex>[,<Size>]],<block_data> WLISt:WAVeform:DATA? <wfm_name>[,<StartIndex>[,<Size>]] Related Commands WLISt:WAVeform:NEW, WLISt:WAVeform:MARKer:DATA Arguments StartIndex, Size,<block_data> ::=<string> <wfm_name> ::=<NR1> <StartIndex> ::=<NR1> <Size> ::=<IEEE 488.2 block> <block_data> Returns <block_data> Examples this transfers WLIST:WAVEFORM:DATA “TestWfm”,0,1024,#42048xxxx… waveform data to a waveform called “TestWfm” created earlier using the command.
Page 134
Command Descriptions Syntax WLISt:WAVeform:DELete {<wfm_name>|ALL} Related Commands WLISt:SIZE? Arguments ::=<string> <wfm_name> Examples deletes all user-defined waveforms from the WLIST:WAVEFORM:DELETE ALL currently loaded setup. The ALL parameter does not delete predefined waveforms. deletes a waveform called “Test1”. WLIST:WAVEFORM:DELETE “Test1” WLISt:WAVeform:LENGth? (Query Only) This query returns the size of the waveform.
Page 135
Command Descriptions WLISt:WAVeform:MARKer:DATA This command sets or queries the waveform marker data. NOTE. This command returns or sends only marker data for the waveform. Each marker data occupies one bit. Two most significant bits of each byte are used for marker1 and marker2 (bit 6 for marker1 and bit 7 for marker2). For more information about the waveform data format, refer to the AWG Reference >...
Page 136
Command Descriptions Examples WLIST:WAVEFORM:MARKER:DATA “myWaveform”,0,1000,#41000…. WLIST:WAVEFORM:MARKER:DATA? “myWaveform”,0,1000 WLISt:WAVeform:NEW (No Query Form) This command creates a new empty waveform in the waveform list of current setup. Group Waveform Syntax WLISt:WAVeform:NEW <wfm_name>,<Size>,<Type> Related Commands WLISt:WAVeform:DATA Arguments ::=<string> <wfm_name> ::=<NR1> <Size> ::={REAL|INTeger} <Type> Examples creates a new integer WLIST:WAVEFORM:NEW “Test1”, 1024, INTEGER...
Page 137
Command Descriptions Examples normalizes the waveform WLIST:WAVEFORM:NORMALIZE “Untitled25”, FSC titled “Untitled25”, if it exists, using full scale. WLISt:WAVeform:PREDefined? (Query Only) This query returns true or false based on whether the waveform is predefined. NOTE. Predefined waveforms have fixed length and name. Therefore, renaming or deleting them is not possible.
Page 138
Command Descriptions None Related Commands Arguments <wfm_name::=<string> <Size>::=<NR1> Examples resamples the waveform WLIST:WAVEFORM:RESAMPLE “Untitled25”, 1024 titled “Untitled25”, if it exists, to 1024 points. WLISt:WAVeform:TSTamp? (Query Only) This query returns the time stamp of the waveform. NOTE. Time stamp is updated whenever the waveform is created or changed. It is not updated when it is renamed.
Page 139
Command Descriptions Examples might return the date and time the “Sine” WLIST:WAVEFORM:TSTAMP? “Sine” waveform was created or last modified. might return “” because “*DC” is a WLIST:WAVEFORM:TSTAMP? “*DC” predefined waveform. WLISt:WAVeform:TYPE? (Query Only) This query returns the type of the waveform. Group Waveform Syntax...
Page 140
Command Descriptions 2-118 AWG5000 and AWG7000 Series Programmer Manual...
Status and Event Reporting Status Reporting Structure The arbitrary waveform 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.
Status and Event Reporting Registers There are two main types of registers: Status Registers: store data relating to instrument status. These registers are set by the arbitrary waveform generator. Enable Registers: determine whether to set events that occur in the instrument to the appropriate bits in the status registers and event queues.
Status and Event Reporting Status Registers There are six types of status registers: Status Byte Register (SBR) Standard Event Status Register (SESR) Operation Condition Register (OCR) Operation Event Register (OEVR) Questionable Condition Register (QCR) Status Byte Register (SBR) The Status Byte Register (SBR) is made up of 8 bits. Bits 4, 5 and 6 are defined in accordance with IEEE Std 488.2-1987 (see the following figure and table).
Status and Event Reporting Table 3-1: SBR bit functions (cont.) Function Event Queue Available (EAV) Not used Standard Event Status Register (SESR) The Standard Event Status Register (SESR) is made up of 8 bits. Each bit records the occurrence of a different type of event, shown in following figure. The contents of this register are returned when the *ESR? query is used.
Status and Event Reporting Operation Enable Register (OENR) None of the bits in the Operation Enable Register are used. Operation Condition Register (OCR) None of the bits in the Operation Condition Register are used. Operation Event Register (OEVR) None of the bits in the Operation Event Register are used. Questionable Condition Register (QCR) None of the bits in the Questionable Condition Register are used.
Status and Event Reporting Event Status Enable Register (ESER) The ESER is made up of bits defined exactly the same as bits 0 through 7 in the SESR. Use this register to designate whether or not the SBR ESB bit should be set when an event has occurred, and to determine if the corresponding SESR bit is set.
Status and Event Reporting Use the command to set the bits of the SRER. Use the query to *SRE *SRE? read the contents of the SRER. Bit 6 must be set to 0. Questionable Enable Register (QENR) None of the bits in the Questionable Enable Register are used. Queues There are two types of queues in the status reporting system: output queues and error/event queues.
Status and Event Reporting Operation Status Block This block is used to report on the status of several operations being executed by the arbitrary waveform generator. The block is made up of three registers: the Operation Condition Register (OCR), the Operation Event Register (OEVR) and the Operation Enable Register (OENR).
Status and Event Reporting Standard/Event Status Block This block is used to report power on/off, command error, and command 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 in the figure in section Status Reporting Structure.
Status and Event Reporting Synchronizing Execution All commands used in the arbitrary waveform generator are designed to be executed in the order in which they are sent from the external controller. The following synchronization commands are included to ensure compliance with the SCPI standard.
Messages and Codes Messages and Codes Messages and Codes Error and event codes with negative values are SCPI standard codes. Error and event codes with positive values are unique to the arbitrary waveform generator series number. The following table lists event code definitions. When an error occurs, find its error class by checking for the code range in tables that are organized by event class.
Messages and Codes Command Errors Command errors are returned when there is a syntax error in the command. Table 3-5: Command errors 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...
Messages and Codes Table 3-6: Execution errors (cont.) Error code Error message -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...
Appendix B: GPIB Interface Specifications GPIB Interface Specifications This appendix lists and describes the GPIB functions and messages that the arbitrary waveform generator implements. Interface Functions Interface Messages Interface Functions The following table lists the GPIB interface functions this instrument implements. Each function is briefly described.
Page 164
Appendix B: GPIB Interface Specifications Table B-1: GPIB interface function implementation (cont.) Implemented Interface function subset Capability Description Listener (L) Basic Listener Enables a Unaddress if device to receive my-talk-address device-dependent (MTA) No Listen data over the Only mode interface. This capability is available only when the device...
Appendix B: GPIB Interface Specifications Table B-1: GPIB interface function implementation (cont.) Implemented Interface function subset Capability Description Controller (C) None Enables a device that has this capability to send its address, universal commands, and addressed commands to other devices over the interface.
Page 166
Appendix B: GPIB Interface Specifications Table B-2: AWG standard interface messages (cont.) Message GPIB Description Parallel Poll Configure (PPC). Causes the listen-addressed device to respond to the secondary commands Parallel Poll Enable (PPE) and Parallel Poll Disable (PPD), which are placed on the bus following the PPC command.
Appendix C: SCPI Conformance Information All commands in the arbitrary waveform generator are based on SCPI Version 1999.0. The following tables list the SCPI commands this arbitrary waveform generator supports. AWG5000 and AWG7000 Series Programmer Manual...
Page 168
Appendix C: SCPI Conformance Information AWG5000 and AWG7000 Series Programmer Manual...
Page 169
Appendix C: SCPI Conformance Information AWG5000 and AWG7000 Series Programmer Manual...
Page 170
Appendix C: SCPI Conformance Information AWG5000 and AWG7000 Series Programmer Manual...
Appendix D: Raw Socket Specification TCP/IP is used as the network protocol, and the port number is variable. Commands can be sent from the application program through the TCP/IP socket interface, and queries can be received through the interface. The following lists the differences between the GPIB interface and the Raw Socket interface.
Page 172
Appendix D: Raw Socket Specification AWG5000 and AWG7000 Series Programmer Manual...
Appendix E: Factory Initialization Settings The following tables list the default settings for the each command. AWG5000 and AWG7000 Series Programmer Manual...
Page 174
Appendix E: Factory Initialization Settings AWG5000 and AWG7000 Series Programmer Manual...
Appendix F: Compatibility with Other Instruments The following tables list the compatibility of the commands with other Tektronix arbitrary waveform generators like the AWG400, AWG500, AWG600, and AWG700 Series. AWG5000 and AWG7000 Series Programmer Manual...
Page 176
Appendix F: Compatibility with Other Instruments AWG5000 and AWG7000 Series Programmer Manual...
Page 177
Appendix F: Compatibility with Other Instruments AWG5000 and AWG7000 Series Programmer Manual...
Page 178
Appendix F: Compatibility with Other Instruments AWG5000 and AWG7000 Series Programmer Manual...
Need help?
Do you have a question about the AWG5000 Series and is the answer not in the manual?
Questions and answers