Home

Query Only

Contents

1. Error code Error message 220 Parameter 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 240 Hardware 241 Hardware missing 250 Mass storage 251 Missing mass storage 252 Missing media 253 Corrupt media 254 Media full 255 Directory full 256 Filename not found 257 Filename 258 Media protected 260 Execution expression 261 Math in expression 270 Execution macro 271 Macro syntax 272 Macro execution 273 Illegal macro label 274 Execution macro parameter 275 Macro definition too long 276 Macro recursion 277 Macro redefinition not allowed 278 Macro header not found 280 Program 281 Cannot create program 282 Illegal program name 283 Illegal variable name 284 Program currently running 285 Program syntax AWG70000 Series Programmer Manual Error messages and codes Device specific errors Table 3 7 Execution errors cont Error code Error message 286 Program runtime 290 Memory use 291 Out of memory 292 Referenced name does not exist 293 Referenced name already exists 294 Incompatible type These error codes are returned when an internal instrument error is detected This type of error can indicate a hardware problem or programming error Table 3 8
2. Waiting for TRIGger CO CO NI DlA S GO RO el o 10 11 12 13 14 Always zero 15 Operation Condition egies OCR Operation Transition Register OTR Operation Event Register OEVR Operation Enable Register OENR The use of Bit 15 is not allowed in SCPI The value of this bit is always zero Error Event queue Figure 3 1 3 2 Standard event status block Operation Complete Request Control Query Error Device Dependent Error Status byte Execution Error Command Error User Request Power On JN ID JOT CO INO Standard Event Status Register SESR Event Status Enable Register ESER Status Event reporting mechanism YYYVYVY Status Byte Register SBR Service Request Enable Register SRER 0782 001 AWG70000 Series Programmer Manual Status byte Status Byte Register SBR Service Request Enable Register SRER Status and events The Status Byte contains the following two registers Status Byte Register SBR m Service Request Enable Register SRER The SBR is made up of 8 bits Bits 4 5 and 6 are defined in accordance wit
3. _J OPC returns after the first 1 overlapping command opc K _J to finish IDN Ec NOTE For AWG70000A Series instruments the OPC query only supports one overlapping command not the two or more overlapping commands as defined in the IEEE Std 488 2 standard Overlapping commands are noted in their command descriptions AWG70000 Series Programmer Manual 2 11 Command syntax 2 12 AWG70000 Series Programmer Manual Command groups Calibration group commands Table 2 8 Calibration group commands and their descriptions Command Description CALibration ABORt Stops the self calibration process and restores the previous calibration constants CALibration ALL Performs a full calibration of the AWG The query form performs a full calibration and returns a status of the operation CALibration CATalog Returns the list of subsystems areas or procedures CALibration LOG Returns a string of continuous concatenated calibration results CALibration LOG CLEar Clears the results log CALibration LOG DETails Sets or returns the flag that controls the amount of result information saved into the log CALibration LOG FAlLuresonly Sets and returns the flag that controls the amount of result information saved into the log CALibration RES Tore Restores the calibration constants from the factory non volatile memory and copied to user storage CALibration RESult Returns th
4. Related Commands DIAGnostic DATA DIAGnostic RESult Returns A single lt NR1 gt value 0 indicates no error 330 indicates that the test failed Examples DIAGNOSTIC executes the NORMal test routines DIAGNOSTIC executes the NORMal test routines and might return 0 indicating there are no errors DIAGnostic LOG Query Only This command returns a string of continuous concatenated test results The start time is recorded for each of the selected tests This command can be issued at any time including while diagnostics are in progress Conditions The return string is limited to only the first 64K of text which can cause a loss of results Use the DIAGnostic LOG CLEar command to start a fresh log AWG70000 Series Programmer Manual 2 73 Command descriptions Group Syntax Related Commands Returns Examples Diagnostic DIAGnostic LOG DIAGnostic LOG CLEar lt string gt lt Started timestamp gt lt LF delimiter gt lt test name and result gt lt LF delimiter gt lt test name and result gt DIAGNOSTIC LOG might return Channell Memory Data Lines Started 6 14 2011 10 19 AM Channell Memory DataLines PASS Channell Memory Address Lines Started 6 14 2011 10 20 AM Channell Memory Address Lines PASS DIAGnostic LOG CLEar No Query Form Conditions Group Syntax Related Commands Examples This command clears the diagnostics results log This command requires that ACTive MODE is se
5. See page 2 9 Sequential blocking and overlapping commands Group IEEE mandated and optional Syntax WAI Related Commands OPC Examples Assuming that you want to use the DIAG START command followed by the DIAG RES command To ensure the DIAG START command finishes before starting the next command insert the WAI command between the two commands such as DIAG START WAT DIAG RES AWG70000 Series Programmer Manual 2 181 Command descriptions WLISt LAST Query Only This command returns the name of the most recently added waveform in the waveform list Group Waveform Syntax WLISt LAST Returns lt string gt lt wfm_name gt Examples WLIST LAST might return untitled2 WLISt NAME Query Only This command returns a waveform name from the waveform list in the position specified by the index value Group Waveform Syntax WLISt NAME lt Index gt Arguments lt Index gt lt NRI gt Returns lt string gt lt wfm_name gt is the waveform name specified by lt index gt Examples WLIST NAME 21 might return untitled21 2 182 AWG70000 Series Programmer Manual Command descriptions WLISt SIZE Query Only Group Syntax Returns Examples This command returns the number of waveforms in the waveform list Waveform WLISt SIZE lt NRI gt WLIST SIZE might return 2 when there are two waveforms in the waveform list WLISt WAVeform DATA This command transfers waveform data
6. 5 us TRIGGER SEQUENCE INTERVAL might return 8 0000000000E 3 indicating 8 LS TRIGger SEQuence LEVel Conditions Group Syntax Related Commands Arguments 2 176 This command sets or returns the external trigger input level threshold When synchronization is enabled and the instrument is not the master this command is not available Trigger TRIGger SEQuence LEVel lt NRf gt lt input_trigger gt TRIGger SEQuence LEVel lt input_trigger gt TRIGger SEQuence SOURce A single lt NRf gt value Range 5 V to 5 V lt input trigger gt ATRigger BTRigger Defaults to ATR if not specified AWG70000 Series Programmer Manual Returns Examples Command descriptions RST sets this to 1 4 V lt NRf gt TRIGGER SEQUENCE LEVEL 0 2 sets the trigger A level to 200 mV TRIGGER SEQUENCE LEVEL ATRIGGER might return 200 0000000000E 3 indicating the Trigger A input level is 200 mV TRIGger SEQuence MODE Conditions Group Syntax Arguments Returns Examples This command sets or returns the trigger timing used when an external trigger source is being used The trigger run mode must be set to Triggered or Trig d Continuous When synchronization is enabled and the instrument is the master the command choice is limited to SYNChronous When synchronization is enabled and the instrument is not the master this command is not available Trigger TRIGger
7. Arguments Returns Examples This command sets or returns the Flag B value of the track in a sequence step Flags are not allowed in sequence steps containing a subsequence Sequence SLISt SEQuence STEP n TFLag m BFLag lt sequence_name gt NCHange HIGH LOW TOGG1e PULSe SLISt SEQuence STEP n TFLag m BFLag lt Sequence_name gt n is a step in the sequence lt NRI gt m is a specific track in a sequence lt NR1 gt lt sequence_ name gt lt string gt NCHange The flag state continues to be in the state is defined in the previous step Default value HIGH The flag signal transitions to the high state LOW The flag signal transitions to the low state TOGG1e The flag signal transitions to the high state if the previous step defined the flag to be in the low state and vice versa PULSe The flag signal outputs a pulse signal of a fixed width NCH HIGH LOW TOGG PULS SLISt SEQuence STEP5 TFLAG1 BFLag MyTest HIGH sets the Flag output of Flag B to high when the instrument is playing out the fifth step of the first track of sequence MyTest SLISt SEQuence STEP2 TFLAG3 BFLag MyTest might return LOW when Flag B of sequence MyTest is set to LOW in the second step of track 3 SLISt SEQuence STEP n TFLag m CFLag Conditions This command sets or returns the Flag C value of the track in a sequence step Flags are not allowed in sequence steps containing a
8. Parameter type Description Example Arbitrary block A block of data bytes 512234xxxxx where 5 indicates that the following 5 digits 12234 specify the length of the data in bytes XxXxX indicates actual 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 MINimum MAXimum NaN Not a Number 9 91 37 AWG70000 Series Programmer Manual Command syntax Table 2 4 Parameter types their descriptions and examples cont Parameter type Description Example NR1 numeric Integers 0 1 15 1 NR2 numeric Decimal numbers 1 2 3 141 6 5 NR3 numeric Floating point numbers 3 1415E 9 NRf numeric Flexible decimal numbers See NR1 NR2 and NR3 that may be type NR1 NR2 examples in this table or NR3 String Alphanumeric characters Testing 1 2 3 must be within quotation marks About MIN MAX You can also use MINimum and MAXimum keywords in the commands with the Numeric parameter Set the minimum value or the maximum value using these keywords and query these values Block Several instrument commands use a block argument form see the following table Table 2 5 Block symbols and their meanings Symbol Meaning lt NZDig gt A nonzero digit character in the range of 1 9 lt Dig gt lt DChar gt lt Dig gt A digit character in the range of 0 9 A character with the hexadecimal equivalent of 00 through FF 0
9. SLISt SEQuence STEP n RCOunt lt Sequence_name gt ONCE INFinite lt NR1 gt SLISt SEQuence STEP n RCOunt lt Sequence_name gt n is a step in the sequence lt sequence name gt lt string gt ONCE Plays the waveform one time during this sequence step INFinte Plays the waveform continuously during this sequence step lt NRI gt Plays this waveform the selected number of times during this sequence step The allowed value is between 1 and 2 20 ONCE INF lt NR1 gt a single value SLIST SEQUENCE STEP1 RCOUNT MySequence 55 sets the repeat count to 55 for step 1 SLIST SEQUENCE STEP1 RCOUNT MySequence might return ONCE indicating that a waveform s in the track s will only play once before continuing to the next specified step SLIST SEQUENCE STEP12 RCOUNT MySequence INFINTE sets the repeat count to Infinite on step 12 indicating that a waveform s in track s will play until stopped externally by the AWGControl STOP command or the SLISt SEQuence JUMP IMMediate command AWG70000 Series Programmer Manual 2 129 Command descriptions SLISt SEQuence STEP RCOunt MAX Query Only Group Syntax Related Commands Returns Examples This command returns the maximum number of repeats allowed for a step in a sequence Sequence SLISt SEQuence STEP RCOunt MAX SLISt SEQuence STEP n RCOunt A single lt NR1 gt value of 1048576 SLIST SEQUENCE STEP RCOUNT MAX will re
10. SOURCE1 CASSET might return SINE100 if waveform SINE100 is assigned to channel 1 SOURce n CASSet SEQuence No Query Form Conditions Group Syntax Arguments 2 144 This command assigns a track of a sequence from the sequence list to the specified channel When synchronization is enabled and playing this command is not available Source SOURCe n CASSet SEQuence lt sequence_name gt lt track_number gt lt sequence_name gt lt string gt lt track_number gt lt NR1 gt n 1 2 n determines the channel number If omitted interpreted as 1 AWG70000 Series Programmer Manual Examples Command descriptions SOURCE1 CASSET SEQUENCE Sequencel0 1 assigns track 1 of Sequence10 to Channel 1 SOURce n CASSet TYPE Query Only Group Syntax Arguments Returns Examples This command returns the type of the asset waveform or sequence assigned to a channel Source SOURCe n CASSet TYPE n 1 2 n determines the channel number If omitted interpreted as 1 WAV a waveform is assigned to the specified channel SEQ a sequence is assigned to the specified channel NONE nothing is assigned to the specified channel SOURCE1 CASSET TYPE might return WAV indicating that a waveform is assigned to Channel 1 SOURce n CASSet WAVeform No Query Form Conditions Group Syntax Arguments Examples This command assigns a wave
11. SOURce n VOLTage LE Vel IMMediate LOW A single lt NRf gt value Range 125 mV to 250 mV n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 250 mV A single lt NRf gt value SOURCE1 VOLTAGE LEVEL IMMEDIATE HIGH 0 125V sets the amplitude high of channel 1 to 125 mV SOURCE2 VOLTAGE LEVEL IMMEDIATE HIGH might return 250 0000000000E 3 indicating that the high voltage output voltage level for channel 2 is 250 mV SOURce n VOLTage LEVel IMMediate LOW Conditions Group Syntax Related Commands Arguments Returns This command sets or returns the low voltage level for the waveform associated with a channel This is a blocking command See page 2 9 Sequential blocking and overlapping commands Source SOURCe n VOLTage LEVel IMMediate LOW lt NRf gt SOURce n VOLTage LEVvel IMmMediate LOw SOURce n VOLTage LEVel MMediate HIGH A single lt NRf gt value Range 250 mV to 125 mV n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 250 mV A single lt NRf gt value AWG70000 Series Programmer Manual 2 157 Command descriptions Examples SOURCE1 VOLTage LEVEL IMMEDIATE LOW 0 125v sets the amplitude low of Channel 1 to 0 125 mV SOURCE1 VOLTage LEVEL IMMEDIATE LOW might return 250 0000000000E 3 indicating that the low voltage output voltage le
12. Arguments Returns 2 96 This command sets or returns the coupled state of the channel s Analog and Marker output controls of two channel instrument The set form of this command forces channel 2 to match channel 1 After the initial coupling of the settings changes made to either channel 1 or channel 2 amplitude settings affect both channels NOTE Output Skew and Delay settings are not coupled between channels Instrument INSTrument COUPle SOURcCe 0 1 OFF ON INSTrument COUP le SOURCe 0 or OFF disables channel coupling 1 or ON enables channel coupling RST sets this to 0 A single lt Boolean gt value 0 or 1 AWG70000 Series Programmer Manual Examples INSTrument MODE Group Syntax Arguments Returns Examples MMEMory CATalog Conditions Group Syntax Related Commands Command descriptions INSTRUMENT COUPLE SOURCE 1 couples the CH1 parameters and CH2 parameters INSTRUMENT COUPLE SOURCE might return 0 This command sets or returns the AWG mode either the AWG mode or the Function generator mode Instrument INSTrument MODE AWG FGEN INSTrument MODE AWG sets the instrument to the Arbitrary Waveform Generator mode FGEN sets the instrument to the Function generator mode RST sets this to AWG AWG FGEN INSTRUMENT MODE FGEN sets the AWG to the function generator mode INSTRUMENT MODE might return FGEN indicating the AWG is in the functio
13. Returns the error and event queue for the next item and removes it from the queue SYSTem ERRor COUNt Returns the error and event queue for the number of unread items SYSTem ERRor DIALog Sets or returns the error dialog display status SYSTem ERRor NEXT Returns data from the error and event queue SYSTem TIME Sets or returns the system time SYSTem VERSion Returns the SCPI version number to which the command conforms AWG70000 Series Programmer Manual Trigger group commands Command groups Table 2 23 Trigger group commands and their descriptions Command Description TRIGger SEQuence IMMediate Generates a trigger event TRIGger SEQuence MPedance Sets or returns the impedance of the external triggers TRIGger SEQuence INTerval Sets or returns the internal trigger interval TRIGger SEQuence LEVel Sets or returns the external trigger input levels threshold TRIGger SEQuence MODE Sets or returns the trigger timing used when an external trigger source is being used TRIGger SEQuence SLOPe Sets or returns the external trigger slopes TRIGger SEQuence SOURce Sets or returns the trigger source NOTE This command exists for backwards compatibility Use the command SOURce n TINPut TRIGger SEQuence WVALue Waveform group commands Sets or returns the output data position of a waveform while the instrument
14. This command returns the status of the Questionable Condition Register Status STATUS QUEStionable CONDi tion STATus QUEStionable ENABle STATus QUEStionable EVENt A single lt NR1 gt value STATUS QUESTIONABLE CONDITION might return 0 STATus QUEStionable ENABle Group 2 162 This command sets or returns the enable mask of the Questionable Enable Register QENR which allows true conditions in the Questionable Event Register to be reported in the summary bit Status AWG70000 Series Programmer Manual Syntax Arguments Returns Examples Command descriptions STATUS QUEStionable ENABle lt bit_value gt STATUS QUEStionable ENABle lt bit_value gt lt NR1 gt is the enable mask of the QENR A single lt NR1 gt value showing the contents of the QENR STATUS QUESTIONABLE ENABLE 64 enables the FREQuency bit STATUS QUESTIONABLE ENABLE might return 64 showing that the bits in the QENR have the binary value 00000000 00100000 which means that the FREQuency bit is valid STATus QUEStionable EVENt Query Only Group Syntax Returns Examples This command returns the contents of the Questionable Event Register QEVR Reading the QEVR clears it Status STATUS QUEStionable EVENt A single lt NR1 gt value showing the contents of the QEVR STATUS QUESTIONABLE EVENT might return 64 showing that the bits in the QEVR have the binary value 00000000 00100000
15. 123 txt 3 15 Return starting at index 3 for 15 bytes is 215DEFGHIJKLMNOPQR Following these principles you can edit or append large or small segments in existing files and alternatively read smaller or large sections in a currently existing file MMEMory DATA SIZE Query Only 2 100 Group Syntax Related Commands Arguments Returns Examples This command returns the size in bytes of a selected file Mass Memory MMEMory DATA SIZE lt file_path gt MMEMory CDIRectory MMEMory MSIS lt file_path gt lt string gt lt NRI gt is the size in bytes of the selected file Assuming that the current file is in the current directory MMEMORY DATA SIZE waveforml wfm might return 1024 MMEMORY DATA SIZE C Tektronix waveforms myFi le wfm might return 65535 AWG70000 Series Programmer Manual Command descriptions MMEMory DELete No Query Form Group Syntax Related Commands Arguments Examples This command deletes a file or directory from the AWG s hard disk When used on a directory this command succeeds only if the directory is empty Mass Memory MMEMory DELete lt file_name gt msus MMEMory CDIRectory MMEMory MSIS lt file_name gt lt string gt lt msus gt mass storage unit specifier lt string gt MMEMORY DELETE SETUP1L AWG deletes SETUP1 AWG in the current directory MMEMORY DELETE my proj awg test awg D deletes D my proj awg test awg
16. C TestFi les AwG_x000_4CH awg Untitled36 OPC imports Untitled36 alone The overlapping command is followed with an Operation Complete query MMEMORY OPEN SASSET WAVEFORM C TestFi les AwG_x000_4CH awg OPC imports both Untitled36 and Untitled37 The overlapping command is followed with an Operation Complete query AWG70000 Series Programmer Manual Command descriptions MMEMory OPEN SETup No Query Form Conditions Group Syntax Arguments Examples This command restores a setup file designated by the lt filepath gt The supported file format is the native setup format AWGX This is a blocking command See page 2 9 Sequential blocking and overlapping commands Mass Memory MMEMory OPEN SETup lt filepath gt lt filepath gt lt string gt must contain the complete path with drive letter and file name MMEMORY OPEN SETUP C TestFi les mySetup awgx opens the setup file named mySetup awex MMEMory OPEN TXT No Query Form Conditions Group Syntax Related Commands Arguments This command loads a waveform from a TXT file into the AWG s waveform list NOTE If the waveform name already exists it is overwritten without warning Only AWG TXT compatible files can be opened using this method This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Mass Memory MMEMory OPEN TXT lt filepath gt lt bitdepth gt
17. Device specific errors Error code Error message 300 Device specific or sequence step error 310 System 311 Memory 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 Queue overflow 360 Communication 361 Parity in program message 362 Framing in program message 363 Input buffer overrun AWG70000 Series Programmer Manual Error messages and codes Query and system errors These error codes are returned in response to an unanswered query Table 3 9 Query errors Error code Error message 400 Query error 410 Query interrupted 420 Query unterminated 430 Query deadlocked 440 Query unterminated after indefinite period 500 Power on 600 User request 700 Request control 800 Operation complete AWG70000A series error codes These error codes and messages are unique to the AWG70000A Series instruments Table 3 10 Device errors Error code Error message 500 Calibration in process 501 Waiting for trigger 550 Lost frequency lock with External Reference source 551 External Reference frequency out of range 552 Calibration recommended temperature change 553 Ext Clk adjustment recommended for frequency change 554 Ext Clk adjustment rec
18. SEQUENCE mySequence C mySequence SEQX OPC saves the sequence named mySequence to the filepath and names the sequence to mySequence The overlapping command is followed with an Operation Complete query AWG70000 Series Programmer Manual Command descriptions MMEMory SAVE SETup No Query Form This command saves the AWG s setup and optionally includes the assets waveforms and sequences NOTE If a file already exists in the selected file path it is overwritten without warning If the save fails the file is deleted This command supports the native setup file format AWGX Conditions Tbis is an overlapping command See page 2 9 Sequential blocking and overlapping commands Group Mass Memory Syntax MMEMory SAVE SETup lt filepath gt lt with_assets gt Arguments lt filepath gt lt string gt must contain the complete path with drive letter and file name lt with_assets gt lt Boolean gt 0 indicates that the setup file be saved without waveforms and sequences 1 indicates that the setup file will be saved with waveforms and sequences NOTE By default if lt with_assets gt is not included then the setup will be saved with assets Examples To save the setup with waveforms and sequences use one of the two following commands MMEMORY SAVE SETUP C mySetup awgx OPC MMEMORY SAVE SETUP C mySetup awgx 1 OPC The overlapping commands are followed with an
19. TestFiles wFM 001 wfm wFM OPC The overlapping command is followed with an Operation Complete query To import a TXT file MMEMORY IMPORT MyWaveform C TestFiles my8bit txt TXT8 OPC The overlapping command is followed with an Operation Complete query 2 102 AWG70000 Series Programmer Manual Command descriptions MMEMory IMPort PARameter NORMalize NOTE This command exists for backwards compatibility Use the command MMEMory OPEN PARameter NORMaiize This command sets or queries if the imported data is normalized during select file format import operations The imported waveform data for select file formats is normalized based on the option set in this command File Formats supported WFM AWG400 AWG500 AWG600 AWG700 Series waveform AWG AWG5000 AWG7000 Series waveforms TXT Analog text files from AWG RFD RFXpress AWG Series waveforms Conditions Normalization will not be carried out on file formats which are not supported Group Mass Memory Syntax MMEMory IMPort PARameter NORMalize lt Type gt MMEMory IMPort PARameter NORMa lize Related Commands MMEMory OPEN PARameter NORMalize Arguments lt type gt NONE FSCale ZREFerence NONE will not normalize the imported data The data may contain points outside of the AWG s amplitude range FSCale normalizes the imported data to the full amplitude range ZREFerence normalizes the imported data while preserving the offset Return
20. The query form returns a 1 when the last overlapping command operation is finished OPC is limited to one overlapping command See page 2 9 Sequential blocking and overlapping commands IEEE mandated and optional OPC OPC WAI AWG70000 Series Programmer Manual 2 113 Command descriptions Returns Examples OPT Query Only Group Syntax Returns Examples OUTPut OFF Conditions Group Syntax Arguments 2 114 A single lt NR1 gt value OPC returns to indicate that the last issued overlapping command is finished This command returns the implemented options for the AWG See page 3 1 Status and events IEEE mandated and optional OPT lt opt gt lt opt gt lt opt gt lt opt gt 0 xx xx xx where xx is the option identifier OPT might return 0 to indicate that no option is installed in the AWG This command sets or returns the state of the All Outputs Off control Enabling All Output Off causes each channel s output and markers to go to an ungrounded or open state Disabling the control causes each channel to go to its currently defined state A channel s defined state can be changed while the All Outputs Off is in effect but the actual output remains open until the All Outputs Off is disabled This is a blocking command See page 2 9 Sequential blocking and overlapping commands Output OUTPut OFF 0 1 OFF ON OUTPut OFF O or OF
21. is between 1 and 16383 NEXT This enables the sequencer to jump to the next sequence step FIRSt This enables the sequencer to jump to first step in the sequence LAST This enables the sequencer to jump to the last step in the sequence END This enables the sequencer to jump to the end and play 0 V until play is stopped Returns lt NRI1 gt a single value LAST FIRS NEXT END Examples SLISt SEQuence STEP1 EJUMp MySequence 6 causes the sequencer to jump to the sixth step after executing the first step after the trigger event SLISt SEQuence STEP1 EJUMp MySequence might return 6 that when step 1 completes the sequence will jump to step 6 after the trigger event SLISt SEQuence STEP1 EJUMp MySequence LAST allows the sequencer to jump to last step in the sequence after executing step 1 AWG70000 Series Programmer Manual 2 127 Command descriptions SLISt SEQuence STEP1 EJUMp MySequence might return NEXT indicating the sequencer will proceed to the next step after the trigger event SLISt SEQuence STEP n GOTO 2 128 Group Syntax Related Commands Arguments Returns Examples This command sets or returns the target step for the GOTO command of the sequencer at the specified step After generating the waveform s specified in a sequence step the sequencer jumps to the step specified as the GOTO step This is an unconditional jump If the GOTO step is not specified the sequencer mo
22. lt area gt One of the areas listed by the area catalog lt test gt One of the tests listed by the test catalog A single lt Boolean gt value 0 or 1 0 is not selected 1 is selected DIAGNOSTIC SELECT Channel1 waveform Memory Data Lines selects one test AWG70000 Series Programmer Manual 2 81 Command descriptions DIAGNOSTIC SELECT VER Channeli waveform Memory Data Lines returns 1 DIAG UNS Channell Waveform Memory Data Lines unselects one test DIAG SEL VER Channell Waveform Memory Data Lines returns 0 DIAGnostic STARt No Query Form Conditions Group Syntax Related Commands Examples This command starts the execution of the selected set of diagnostic tests This command requires that ACTive MODE is set to DIAGnostic This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Diagnostic DIAGnostic STARt ACTive MODE DIAGnostic ABORt DIAGnostic STOP DIAGNOSTIC START OPC starts the execution of the selected set of tests The overlapping command is followed with an Operation Complete query DIAGnostic STOP No Query Form 2 82 Conditions Group Syntax This command stops the diagnostic tests from running after the diagnostic test currently in progress completes This also terminates diagnostic test looping This command requires that ACTive MODE is set to DIAGnostic This is an overlapping command See page 2 9
23. phase is set to 100 degrees AWG70000 Series Programmer Manual Command descriptions AWGControl CLOCk SOURce Conditions Group Syntax Related Commands Arguments Returns Examples NOTE This command exists for backwards compatibility Use the command CLOCk SOURce This command sets or returns the source of the clock This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Control AWGControl CLOCk SOURCe INTernal EXTernal EFIXed EVARiable AWGControl CLOCk SOURCe CLOCk SOURce INTernal clock signal is generated internally and the reference frequency is derived by the internal oscillator EFIXed clock is generated internally and the reference frequency is derived from a fixed 10 MHz reference supplied at the Reference In connector EVARiable clock is generated internally and the reference frequency is derived from a variable reference supplied at the Reference In connector ExTernal clock signal supplied by the Clock In connector and the reference frequency is derived from the internal precision oscillator RST sets this to INT INT EXT EFIXed EVAR AWGCONTROL CLOCK SOURCE INTERNAL OPC sets the clock source to internal The overlapping command is followed with an Operation Complete query AWG70000 Series Programmer M
24. 2 97 Master slave operation D 1 MEMory CATalog 2 97 MEMory CDIRectory 2 98 MEMory DATA 2 99 Mory DATA SIZE 2 100 Mory DELete 2 101 Mory IMPort 2 101 Mory IMPort PARameter NORMalize 2 103 Mory MDyIRectory 2 104 Mory MSIS 2 104 Mory OPEN 2 105 Mory OPEN PARameter NORMalize 2 106 Mory OPEN SASSet WAVeform 2 108 Mory OPEN SASSet SEQuence 2 106 Mory OPEN SETup 2 109 Mory OPEN TXT 2 109 Mory SAVE WAVeform WFMX 2 112 Mory SAVE WAVeform TXT 2 112 Mory SAVE SEQuence 2 110 Mory SAVE SETup 2 111 O S55 5555585 S585 58585855555 SSSSS S55 S55 S55 555858 es mes Mlesics MlcsMlcsMl cs esis MesMlcsMesMcsMesMcs mes OPC 2 113 Operation status block 3 5 OPT 2 114 Index 2 OUTPut n STATe 2 115 OUTPut n S VALue ANALog STATe 2 116 OUTPut n S VALue MARKer 1 2 2 116 OUTPut n W VALue ANALog STATe 2 117 OUTPut n W VALue MARKer 1 2 2 118 OUTPut OFF 2 114 Q Questionable status block 3 6 Queues 3 7 event 3 7 output 3 7 R Raw socket specification B 1 RST 2 119 S Service Request Enable Register SRER 3 3 SLISt NAME 2 119 SLISt SEQuence DELete 2 120 SLISt SEQuence EVENt JTIMing 2 121 SLISt SEQuence EVENt PJUMp DEFine 2 121 SLISt SEQuence EVENt PJUMp ENABle 2 122 SLISt SEQuence EVENt PJUMp SIZE 2 124 SLISt SEQuence LENGth 2 124 SLISt SEQuence NEW 2 124 SLISt SEQuence RFLag 2 125 SLISt SEQuence STEP MAX 2 125 SLISt SEQuenc
25. 360 might return 360 WLISt WAVeform LMAXimum Query Only Conditions Group Syntax Related Commands Returns Examples 2 186 This command returns the maximum number of waveform sample points allowed The returned value is dependent on the instrument model the installed options and sampling rate setting Waveform WLISt wAVeform LMAXimum WLISt WAVeform LMINimum A single lt NR1 gt value WLIST WAVEFORM LMAXIMUM might return 2000000000 indicating that the maximum number of allowed waveform sample points is 2 Giga samples AWG70000 Series Programmer Manual Command descriptions WLISt WAVeform LMINimum Query Only Group Syntax Related Commands Returns Examples This command returns the minimum number of waveform sample points required for a valid waveform The number of required sample points is dependent on the instrument model Waveform WLISt wAVeform LMINimum WLISt WAVeform LMAXimum A single lt NR1 gt value WLIST WAVEFORM LMINIMUM might return 2400 indicating that the minimum number of waveform sample points required is 2 4 k WLISt WAVeform MARKer DATA Group This command sets or returns 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 marker and marker2 bit 6 for marker1 and bit 7 for marker2 You will h
26. AWG70000 Series Programmer Manual Status and events Table 3 5 Questionable status register bit definition cont Bit Description 4 TEMPerature TEMP Calibration required due to instrument temperature change 3 0 Not used When the specified state changes in the QCR its bit is set or reset This change is filtered with a transition register and the corresponding bit of the QEVR is set If the bit corresponding to the event has also been set in the QENR the SBR QSS bit is also set Queues There are two types of queues in the status reporting system used in the analyzer output queues and event queues Output queue The output queue is a FIFO first in first out queue and holds response messages to queries where they await retrieval When there are messages in the queue the SBR MAV bit is set The output queue will be 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 will occur and the output queue will be emptied however the operation will proceed even if an error occurs Event queue The event queue is a FIFO queue and stores events as they occur in the analyzer If more than 32 events occur event 32 will be replaced with event code 350 Queue Overflow The error code and text are retrieved using the SYSTem ERRor queries AWG70000 Series Programmer Manual 3 7 Status and events Status a
27. Command Description SOURce n MARKer 1 2 VOLTage LEVel IMMediate LOW Sets or returns the marker low level SOURce n MARKer 1 2 VOLTage LEVel IMMediate OFFSet Sets or returns the marker offset SOURce RCCouple Sets or returns the coupled state of the channel s run controls of a two channel instrument SOURce n RMODe Sets or returns the run mode of the AWG SOURce ROSCillator MULTiplier Sets or returns the multiplier of the external reference oscillator NOTE This command exists for backwards compatibility Use the command CLOCk EREFerence MULTiplier SOURce n SCSTep Returns the current step of the sequence while system is running SOURce n SKEW Sets or returns the skew for the waveform associated with a channel in a two channel configuration SOURce n TINPut Sets or returns the trigger input source SOURce n VOLTage LEVel IMMediate AMPLitude Sets or returns the amplitude for the waveform associated with a channel SOURce n VOLTage LEVel IMMediate HIGH Sets or returns the high voltage level for the waveform associated with a channel SOURce n VOLTage LEVel IMMediate LOW Sets or returns the low voltage level for the waveform associated with a channel SOURce n WAVeform Sets or returns the name of the waveform assigned to a channel Status group command 2 24 The exter
28. EENE EEEE EEEE A 1 Appendix B Raw socket specification 0 ccc cece cece c cence ene ene rrr rrrrrtrsrsrrerrrrerrerrerrrnn B 1 Appendix C Factory initialization settings c cece cece eee ne ence ene ene eee enna e een eee eea C 1 Appendix D Master amp slave operation 0 ccc cce ec ee eee eee nee rrr ene e nee enn e een neta e a D 1 Operation with the AWG70000 as a master ununnnnusnunssussersrersrrrrrrrrrrrrrrrrrrrreereere D 1 Operation with the AWG70000 as a slave 6 cece cece nee eee deen ne ene e eee n tena e ees D 1 Operation with the AWG70000 as a master or slave and system is not idle 00000 D 2 AWG70000 Series Programmer Manual Getting started Introduction This programmer guide provides you with the information required to use Programmable Interface PI commands for remotely controlling your AWG With this information you can write computer programs that perform functions such as setting the front panel controls selecting clock source setting sampling rate and exporting data for use in other programs In addition to the LAN electronic interface your AWG is provided with a TekVISA GPIB compatible interface referred to as the virtual GPIB interface The programmer guide is divided into the following major sections Getting Started provides basic information about setting up your AWG for remote control Command Syntax provides an overview of the
29. FORCe No Query Form Group Syntax Arguments Examples This command forces the sequencer to jump to the specified step per channel A force jump does not require a trigger event to execute the jump For two channel instruments if both channels are playing the same sequence then both channels jump simultaneously to the same sequence step Source SOURCe n JUMP FORCe FIRSt CURRent LAST END lt NR1 gt n 1 2 n determines the channel number If omitted interpreted as 1 FIRSt This enables the sequencer to jump to first step in the sequence CURRent This enables the sequencer to jump to the current sequence step essentially starting the current step over LAST This enables the sequencer to jump to the last step in the sequence END This enables the sequencer to go to the end and play 0 V until play is stopped lt NR1 gt This enables the sequencer to jump to the specified step where the value is between and 16383 SOURCE1 JUMP FORCE 240 specifies that Channel 1 will jump to step 240 at end of sequence step or immediately depending on the state of SLISt SEQuence EVENt JTIMing If Channel 1 and Channel 2 are playing the same sequence Channel 2 also jumps to location 240 simultaneously SOURCE2 JUMP FORCE CURRENT starts playing the current step on Channel 2 based on the SLISt SEQuence EVENt JTIMing value SOURce n JUMP PATTern FORCe No Query Form Group Syntax This command generat
30. IMMediate AWGControl STOP MMediate AWGCONTROL RUN IMMEDIATE puts the AWG in the run state AWGControl SNAMe Query Only Group Syntax Returns Examples 2 40 This command returns the AWG s most recently saved setup location The response contains the full path for the file including the disk drive letter msus or mass storage unit specifier Control AWGControl SNAMe Returns lt file_name gt lt msus gt lt file_name gt lt string gt a lt msus gt mass storage unit specifier lt string gt By default when there has been no save setup command this value is C AWGCONTROL SNAME might return the following response my project setups mySetup awgx D AWG70000 Series Programmer Manual Command descriptions AWGControl SREStore No Query Form Conditions Group Syntax Related Commands Arguments Examples NOTE This command exists for backwards compatibility Use the command MMEMory OPEN SETup This command opens a setup file into the AWG s setup memory This is a blocking command See page 2 9 Sequential blocking and overlapping commands Control AWGControl SREStore lt filepath gt lt msus gt MMEMory OPEN SETup lt filepath gt lt string gt lt msus gt mass storage unit specifier lt string gt With mass storage unit specifier specified as a parameter AWGCONTROL SRESTORE TestFiles mySetup awgx C With mass stora
31. INT Time 2 6 2013 8 38 34 AM CALibration RUNNing Query Only Group Syntax Returns Examples This command returns the name of the subsystem area and procedure in progress This command can be issued while procedure is in progress Calibration CALibration RUNNing wom A string of colon separated subsystem area and procedure CALIBRATION RUNNING might return Channell Dc Amplitude indicating the subsystem area and procedure in progress A return of indicates there isn t a currently running procedure CALibration STARt No Query Form Conditions This command starts the calibration Setting only works in the active mode for calibration See the ACTive MODE command This is an overlapping command See page 2 9 Sequential blocking and overlapping commands AWG70000 Series Programmer Manual 2 51 Command descriptions Group Syntax Related Commands Examples Calibration CALibration STARt ACTive MODE CALibration ABORt CALIBRATION START OPC starts the execution of calibration routines The overlapping command is followed with an Operation Complete query CALibration STATe FACTory Query Only 2 52 Conditions Group Syntax Arguments Returns This command returns the current factory state of the calibration for the AWG A calibration state will be Calibrated or Uncalibrated m Areas will be calibrated when all procedures for that area have b
32. MMEMory OPEN PA Rameter NORMalize lt filepath gt lt string gt must contain the complete path with drive letter and file name lt bitdepth gt ANALog DIG8 DIG9 DIG10 AWG70000 Series Programmer Manual 2 109 Command descriptions Examples MMEMORY OPEN TXT C TestFiles my8bitTXTfile txt DIG8 OPC opens the digital eight bit file named my8bitTXTfile The overlapping command is followed with an Operation Complete query MMEMORY OPEN TXT C TestFiles myAnalogTxTfile txt ANALOG OPC opens the analog file named myAnalogTXTfile txt The overlapping command is followed with an Operation Complete query MMEMory SAVE SEQuence No Query Form Conditions Group Syntax Arguments Examples 2 110 This command exports a sequence given a unique name to an eligible storage location as the SEQX file type NOTE If a file already exists in the selected file path it is overwritten without warning If the save fails the file is deleted NOTE The waveform name is renamed to the filename without extension if the waveform source is different from the selected file path This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Mass Memory MMEMory SAVE SEQuence lt sequence gt lt filepath gt lt sequence gt lt string gt lt filepath gt lt string gt must contain the complete path with drive letter and file name MMEMORY SAVE
33. SOURCE1 SCSTEP might return END indicating that channel 1 is playing 0 V until the play ends SOURCE1 SCSTEP might return lt Subsequence_Name gt lt Step_Index gt when playing out step lt Step_Index gt of subsequence lt Sequence_Name gt This command sets or returns the skew for the waveform associated with a channel Source SOURCe n SKEW lt NR3 gt SOURCe n SKEW AWG70000 Series Programmer Manual Arguments Returns Examples SOURce n TINPut Group Syntax Arguments Returns Examples Command descriptions A single lt NR3 gt value Range 100 ps to 100 ps Minimum increments is 0 5 ps n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 0 A single lt NR3 gt value SOURCE2 SKEW 75PS sets the skew for channel 2 to 75 ps SOURCE2 SKEW might return 75 0000000000E 12 indicating that the skew for channel 2 is set to 75 ps This command sets or returns the trigger input source of the specified channel Source SOURce n TINPut ATRigger BTRigger SOURce n TINPut ATRigger selects trigger input A BTRigger selects trigger input B n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to ATR ATR BTR SOURCe1 TINPut BTRIGGER selects Trigger B as the external trigger input source for channel 1 SOURCe1 TINPut might return BTR indicating that Trigger B is the external t
34. Sequential blocking and overlapping commands Diagnostic DIAGnostic STOP AWG70000 Series Programmer Manual Related Commands Examples Command descriptions ACTive MODE DIAGnostic ABORt DIAGnostic STOP DIAGnostic STOP STATe DIAGNOSTIC STOP OPC stops the execution of the selected set of tests The overlapping command is followed with an Operation Complete query DIAGnostic STOP STATe Query Only Group Syntax Returns Examples DIAGnostic TYPE Conditions Group This command returns the current state of diagnostic testing Diagnostic DIAGnostic STOP STATe A single lt Boolean gt value 0 or 1 1 represents a stopped state and 0 represents running state DIAGNOSTIC STOP STATE might return 1 indicating that testing has stopped This command sets or returns the diagnostic type The diagnostics work on a list of tests that support different types of testing This sets the context for other commands such as selecting a test to run This command requires that ACTive MODE is set to DIAGnostic If not the following error is generated m 300 Device specific error Not in Diagnostics mode diag type post The diagnostic type can only be changed if no testing is currently in progress If there is the following error is generated 300 Device specific error Diagnostics procedures still in progress diag type post Diagnostic AWG70000 Series Programmer Manual 2 83 Com
35. Status and event reporting system 1 0 0 cece cece ene ee eee ene e nee eee ents eee nett tant tees 3 1 Status DYLChsccccnserne Erren E EEEE EE EEE ame nennde quintet datanseecedenuae sie EUNE EET 3 3 Standard Event Status Block SESB 0 0 ccc cece cee ce cee e ee eee eee eee e eee e ee eae ee ena e eens 3 4 Operation status block 0 222 rener ceiglsaterseoed ideas cohissanecdaubevsands cavdvddastes toadieuses cede ee 3 5 Questionable status DIOCK 0 c ccc cece ne ene een AAA nn EE Eee E EE EEE EEE EEE EE ES 3 6 UCTIES oreina aiee aided dbiadciawadanbbbad ded belsewcatah A A Ra A ea 3 7 Status and event processing Sequence ek cee cece cence eee nee eee enn e nee eee erse rrrserrrerrsnenes 3 8 SYNCHFOMIZING CXECULION saarnia inti ce acenesdesawsalewscassdensedlehaesanaecdaracide saedebaa sessed adeweels 3 9 Errormessages and codes os ceseeuccedadeweacaietteundoecnedaddanee nleltnaslen EEE E EEE EOE 3 11 Command Errors iss cdcucnaunsa ave aE aeu ee nut ena ENNAN E EEES at dawedsuaies 3 11 Execution CLO 23so0 ee ecdccuniaeds dah daen sid extda eds bocce audeud ob ee AI EE 3 12 Device specific errors users nirai ii ni nE ET arabs EE EE EE EEEO EAEE E 3 14 Query and systemi CrrOTS 2550 sadcuddeid ceaddcdebhoues E E ANAO A N a A E R A 3 15 AWG70000A Series error COdES ei e cece cece cence eee eee EEEE EE EE E E eas 3 15 Appendices ii Appendix A Character Charts s c ccssuesnenanccenneciensenulawan EE E EE E E
36. be strobed in causing a sequence to jump to a defined step The sequence and step are defined with the command SLISt SEQuence EVENt PJUMp DEFine Sequence SLISt SEQuence EVENt PJ UMp ENAB1 e lt sequence_name gt 0 1 OFF ON SLISt SEQuence EVENt PJUMp ENABle lt Sequence_name gt AWG70000 Series Programmer Manual Command descriptions Related Commands SLISt SEQuence EVENt PJUMp DEFine Arguments lt sequence_name gt lt string gt OFF or 0 disables pattern jump as an event source independent of any values present at the Pattern Jump In connector ON or 1 enables pattern jump as an event source RST sets this to 0 Returns A single lt Boolean gt value Examples SLIST SEQUENCE EVENT PJUMP ENABLE MySequence ON enables the pattern jump SLIST SEQUENCE EVENT PJUMP ENABLE MySequence might return 1 indicating the pattern jump is enabled AWG70000 Series Programmer Manual 2 123 Command descriptions SLISt SEQuence EVENt PJUMp SIZE Query Only Group Syntax Returns Examples This command returns the maximum number of entries in the pattern jump table Sequence SLISt SEQuence EVENt PJUMp SIZE A single lt NR1 gt value of 256 SLIST SEQUENCE EVENT PJUMP SIZE will return 256 indicating the maximum number of entries in the pattern jump table SLISt SEQuence LENGth Query Only Group Syntax Arguments Returns Examples This command returns the total num
37. blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Group Clock Syntax CLOCk ECLock DIVider lt NR1 gt Related Commands 2 54 CLOCk ECLock DIVider CLOCk ECLock MULTiplier CLOCk SRATe CLOCk SOURce AWG70000 Series Programmer Manual Arguments Returns Examples Command descriptions A single lt NR1 gt value that is a power of 2 Range 1 to 16777216 RST sets this to 1 A single lt NR1 gt value CLOCK ECLOCK DIVIDER 4 OPC sets the external clock divider rate to 4 The overlapping command is followed with an Operation Complete query CLOCK ECLOCK DIVIDER might returns 4 indicating the external clock divider rate is set to 4 CLOCk ECLock FREQuency Conditions Group Syntax Related Commands Arguments Returns This command sets or returns the expected frequency being provided by the external clock This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Clock CLOCk ECLock FREQuency lt NR3 gt CLOCK ECLock FREQuency CLOCk SOURce A single lt NR3 gt value Range 6 25E9 to 12 5E9 RST sets this to 6 25E9 A single lt NR3 gt value AWG70000 Series Programmer Manual 2 55 Command descriptions Examples CLOCK ECLOCK FREQUENCY 10
38. command syntax that you will use to communicate with the AWG and other general information about commands such as how commands and queries are constructed how to enter commands constructed mnemonics and argument types Command Groups contains all the commands listed in functional groups Each group consists of an overview of the commands in that group and a table that lists all the commands and queries for that group E Status and Events discusses the status and event reporting system for the LAN interface This system informs you of certain significant events that occur within the AWG m Appendices contains miscellaneous information such as LAN interface specifications that may be helpful when using remote commands to control the AWG AWG70000 Series Programmer Manual 1 1 Remote control Remote control Ethernet control You can remotely control communications between your instrument and a PC via Ethernet or GPIB cables Refer to the following sections describing the setups and connections required If you are using Ethernet start by connecting an appropriate Ethernet cable to the Ethernet port RJ 45 connector on the rear panel of the instrument This connects the instrument to a 1OBASE T 100BASE TX 1000BASE T local area network of SS Device 10 100 1000 Mbps a 5 to alsa The AWG accepts two types of Ethernet LAN connections E VXI 11 Server VXI 11 protocol is used through TekVISA TekVIS
39. event status register Table 3 3 Standard event status register bit definition Bit Description 7 Power On PON Indicates that the power to the instrument is on 6 Not used 5 Command Error CME Indicates that a command error has occurred while parsing by the command parser was in progress 4 Execution Error EXE Indicates that an error occurred during the execution of a command Execution errors occur for one of the following reasons When a value designated in the argument is outside the allowable range of the instrument or is in conflict with the capabilities of the instrument When the command could not be executed properly because the conditions for execution differed from those essentially required 3 Device Dependent Error DDE An instrument error has been detected AWG70000 Series Programmer Manual Status and events Table 3 3 Standard event status register bit definition cont Bit Description 2 Query Error QYE 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 despite the fact that the output queue is empty or in pending status The output queue messages have been cleared despite the fact that they have not been retrieved 1 Not used 0 Operation Complete OPC This bit is set with the results of the execution of the OPC com
40. into waveform memory it is unloaded If the RUN state of the AWG is ON the state is turned OFF If the channel is on it will be switched off AWG70000 Series Programmer Manual Group Syntax Related Commands Arguments Examples Command descriptions Waveform WLISt wAVeform DELete lt wfm_name gt ALL WLISt SIZE lt wfm_name gt lt string gt WLIST WAVEFORM DELETE ALL deletes all user defined waveforms from the currently loaded setup WLIST WAVEFORM DELETE Test1 deletes a waveform called Test1 WLISt WAVeform GRANularity Query Only Group Syntax Related Commands Returns Examples This command returns the granularity of sample points required for the waveform to be valid The number of sample points of a single channel instrument must be divisible by 2 Waveform WLISt wAVeform GRANu larity WLISt WAVeform LMINimum WLISt WAVeform LMA Ximum A single lt NR1 gt value WLIST WAVEFORM GRANULARITY might return 2 indicating that the number of sample points must be divisible by 2 AWG70000 Series Programmer Manual 2 185 Command descriptions WLISt WAVeform LENGth Query Only Group Syntax Arguments Returns Examples This command returns the size of the waveform The returned value represents data points not bytes Waveform lt wfm_name gt WLISt wAVeform LENGth lt wfm_name gt lt string gt lt NRI gt WLIST WAVEFORM LENGTH Sine
41. not the master this command is not available Group Clock Syntax CLOCk SRATe lt NRf gt CLOCk SRATe Related Commands CLOCk SOURce 2 66 AWG70000 Series Programmer Manual Command descriptions Arguments A single lt NRf gt value Range AWG70001A 1 49 kS s to 50 GS When Clock Source is set to External 4 times the External Clock In frequency AWG70002A 1 49 kS s to 25 GS When Clock Source is set to External 2 times the External Clock In frequency RST sets this to the maximum value Returns A single lt NR3f gt value Examples CLOCK SRATE 5E8 OPC sets the clock sample rate to 500 MS s The overlapping command is followed with an Operation Complete query CLOCK SRATE might return 25 0000000000E 9 indicating the clock sample rate is set to 25 GS s CLS No Query Form This command clears all event registers and queues See page 3 1 Status and events Group IEEE mandated and optional Syntax CLS Examples CLS clears all the event registers and queues DIAGnostic ABORt No Query Form This command attempts to stop the current diagnostic test and stops the execution of any additional selected tests This may result in loss of logging information collected for the current test that responds to the abort event Conditions This command requires that ACTive MODE is set to DIAGnostic AWG70000 Series Programmer Manual 2 67 Command descriptions Group Syntax Related Commands Example
42. or returns the flag that controls the amount of result information saved into the log AWG70000 Series Programmer Manual Command groups Table 2 11 Diagnostic group commands and their descriptions cont Command Description DlAGnostic LOOPs Returns the number of times that the selected diagnostics set was completed during the current running or the last diagnostic running of the set DlAGnostic RESult Returns the status about the results of the last start of a set of selected tests DlAGnostic RESult TEMPerature Returns the temperature from the results of the last start of a set of selected tests DlAGnostic RESult TIME Returns the time from the results of the last start of a set of selected tests DlAGnostic RUNNing Returns the name of the subsystem area and test of the current diagnostic test DlAGnostic SELect Selects one or more tests of the current test list DlAGnostic SELect VERify Returns selection status of one specific test DlAGnostic STARt This command starts the execution of the selected set of diagnostic tests DlAGnostic STOP Stops the diagnostic tests from running after the diagnostic test currently in progress completes DlAGnostic STOP STATe Returns the current state of diagnostic testing DlAGnostic TYPE Sets or returns the diagnostic type DlAGnostic TYPE CATalog Returns a list of diagnostic types available depending on the end user DlAGnosti
43. refers to two digit minute number ss refers to two digit second number Examples SLIST SEQUENCE TSTAMP MySequence might return 2012 07 25 9 05 21 which is the date and time the sequence named MySequence was created or last modified 2 140 AWG70000 Series Programmer Manual Command descriptions SLISt SIZE Query Only Group Syntax Returns Examples This command returns the number sequences in sequence list Sequence SLISt SIZE A single lt NR1 gt value SLIST SIZE might return 4500 which is the number of existing sequences in the sequence list SOURce FREQuency CW FlXed Conditions Group Syntax Related Commands NOTE This command exists for backwards compatibility Use the command CLOCK SRATe This command sets or returns the clock sample rate of the AWG CW and FIXed are optional to provide legacy support but provide no added functionality This command is not valid when CLOCk SOURCe is set to EXTernal This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Source SOURCe FREQuency cw FIXed lt NR3 gt SOURCe FREQuency cw FIXed CLOCk SOURce AWG70000 Series Programmer Manual 2 141 Command descriptions SOURce RCCouple 2 142 Arguments Returns Examples Group Syntax A
44. subsequence AWG70000 Series Programmer Manual 2 135 Command descriptions Group Syntax Arguments Returns Examples Sequence SLISt SEQuence STEP n TFLag m CFLag lt sequence_name gt NCHange HIGH LOW TOGG1e PULSe SLISt SEQuence STEP n TFLag m CFLag lt sequence_name gt n is a step in the sequence lt NR1 gt m is a specific track in a sequence lt NRI gt lt sequence name gt lt string gt NCHange The flag state continues to be in the state is defined in the previous step Default value HIGH The flag signal transitions to the high state LOW The flag signal transitions to the low state TOGG1e The flag signal transitions to the high state if the previous step defined the flag to be in the low state and vice versa PULSe The flag signal outputs a pulse signal of a fixed width NCH HIGH LOW TOGG PULS SLISt SEQuence STEP5 TFLAG1 CFLag MyTest HIGH sets the Flag output of Flag C to high when the instrument is playing out the fifth step of the first track of sequence MyTest SLISt SEQuence STEP2 TFLAG3 CFLag MyTest might return LOW when Flag C of sequence MyTest is set to LOW in the second step of track 3 SLISt SEQuence STEP n TFLag m DFLag 2 136 Conditions Group Syntax This command sets or returns the Flag D value of the track in a sequence step Flags are not allowed in sequence steps containing a subsequence Sequenc
45. the instrument This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Synchronization SYNChronize ENABle OFF ON 0O 1 SYNChronize ENAB1e OFF or 0 disables synchronization OFF or 0 is the default value ON or 1 enables synchronization AWG70000 Series Programmer Manual Returns Examples Command descriptions A single lt Boolean gt value SYNCHRONIZE ENABLE ON OPC enables synchronization in the instrument to be part of a synchronized system The overlapping command is followed with an Operation Complete query SYNCHRONIZE ENABLE might return 0 indicating the synchronization is not enabled SYNChronize TYPE Query Only Conditions Group Syntax Returns Examples This command returns the instrument type master or slave in the synchronized system This command is not active until synchronization enable has completed Synchronization SYNChronize TYPE MAST when synchronization is enabled and the instrument is the master of the synchronized system SLAV when synchronization is enabled and the instrument is a slave in the synchronized system UNKN when the instrument is unknown in the synchronized system This indicates synchronization has not been enabled or a possible cable connection problem SYNCHRONIZE TYPE returns MAST indicating synchronization is enabled and the instrument is the master AWG70000 Series Programmer Manual 2 169 C
46. unable to load waveform or sequence due to hardware error 1220 Empty sequence sequence is empty unable to load 1221 Failed to load sequence sequence step must contain waveforms of equal length 1222 Failed to load sequence pattern jump table size exceeds hardware limit 1223 1224 Failed to load sequence total waveform s length exceeds maximum samples Failed to find sequence no sequence definition was found in the file 1300 Unknown exception unable to save file 1301 File save error unknown error unable to save waveform 1302 File restore error unknown error unable to open asset from setup file 1303 Unknown exception unable to open waveform 1304 Recall waveform failed duplicate name 1307 1308 File access failed Recall waveform failed missing parameter 1309 Recall waveform failed unsupported number of bits 1310 Recall waveform failed invalid marker type 1311 1312 Recall waveform failed invalid marker data length Recall waveform failed waveform name and or data not found 1313 Recall waveform failed unsupported waveform file type 1314 Recall waveform failed invalid sample data 1315 Recall waveform failed unable to read sample data 1316 Recall waveform failed unable to read Matlab HDF5 data set 1317 Recall waveform failed invalid IQ data format 1318 Re
47. waveform list of the current setup Waveform WLISt wAVeform NEW lt wfm_name gt lt Size gt WLISt WAVeform DATA lt wfm_name gt lt string gt lt Size gt lt NRI gt WLIST WAVEFORM NEW Test1 1024 creates a new waveform called Test1 with 1024 points AWG70000 Series Programmer Manual Command descriptions WLISt WAVeform NORMalize No Query Form Conditions Group Syntax Arguments Examples This command normalizes a waveform in the waveform list This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Waveform WLISt wAVeform NORMalize lt wfm_name gt FSCale ZREFerence lt wfm_name gt lt string gt FSCale normalizes the waveform to the full amplitude range ZREFerence normalizes the waveform while preserving the offset WLIST WAVEFORM NORMALIZE Untitled25 FSCALE OPC normalizes the waveform titled Untitled25 if it exists using full scale The overlapping command is followed with an Operation Complete query WLISt WAVeform RESample No Query Form Conditions Group Syntax Arguments Examples This command resamples the number of points in a waveform in the waveform list This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Waveform WLISt wAVeform RESample lt wfm_name gt lt size gt lt wfm_name lt string gt lt size gt lt NR1 gt WLIST WAVEFORM RES
48. which means that the FREQuency bit is set STATus QUEStionable NTRansition Group Syntax This command sets or returns the negative transition filter value of the Questionable Transition Register QTR Status STATUS QUEStionable NTRansition lt bit_value gt STATUS QUEStionable NTRansition AWG70000 Series Programmer Manual 2 163 Command descriptions Arguments Returns Examples lt bit_value gt lt NR1 gt is the negative transition filter value A single lt NR1 gt value showing the contents of the QTR STATUS QUESTIONABLE NTRANSITION 32 sets the negative transition filter value to 32 STATUS QUESTIONABLE NTRANSITION might return 32 indicating the negative transition filter value is 32 STATus QUEStionable PTRansition Group Syntax Arguments Returns Examples STB Query Only Group Syntax 2 164 This command sets or queries the positive transition filter value of the Questionable Transition Register QTR Status STATUS QUEStionable PTRansition lt bit_value gt STATUS QUEStionable PTRansition lt bit_value gt lt NR1 gt is the positive transition filter value A single lt NR1 gt value showing the contents of the QTR STATUS QUESTIONABLE PTRANSITION O sets the positive transition filter value to 0 STATUS QUESTIONABLE PTRANSITION might return 0 indicating that the positive transition filter value is 0 This command returns the contents o
49. 0 Series Programmer Manual CLOCk EREFerence FREQuency DETect 2 60 CLOCk EREFerence MULTiplier 2 61 CLOCk JITTer 2 62 CLOCk OUTPut STATe 2 63 CLOCk OUTPut FREQuency 2 62 CLOCk PHASe ADJust 2 64 CLOCk SOURCce 2 64 CLOCk SOUT STATe 2 66 CLOCKk SRATe 2 66 CLS 2 67 D DIJAGnostic MMediate 2 73 DIAGnostic ABORt 2 67 DIAGnostic CATalog 2 68 DIAGnostic CONTrol COUNt 2 70 DIAGnostic CONTrol HALT 2 71 DIAGnostic CONTrol LOOP 2 71 DIAGnostic DATA 2 72 DIAGnostic LOG 2 73 DIAGnostic LOG CLEar 2 74 DIAGnostic LOG FAILuresonly 2 74 DIAGnostic LOOPs 2 75 DIAGnostic RESult 2 76 DIAGnostic RESult TEMPerature 2 78 DIAGnostic RESult TIME 2 79 DIAGnostic RUNNing 2 80 DIAGnostic SELect 2 80 DIAGnostic SELect VERify 2 81 DIAGnostic STARt 2 82 DIAGnostic STOP 2 82 DIAGnostic STOP STATe 2 83 DIAGnostic TYPE 2 83 DIAGnostic TYPE CATalog 2 84 DIAGnostic UNSelect 2 84 DISPlay PLOT STATe 2 86 E Error codes 3 11 ESE 2 87 ESR 2 88 Index 1 Index F Factory settings C 1 FGEN CHANnel n AMPLitude 2 88 FGEN CHANnel n DCLevel 2 89 FGEN CHANnel n FREQuency 2 90 FGEN CHANnel n HIGH 2 90 FGEN CHANnel n LOW 2 91 FGEN CHANnel n OFFSet 2 92 FGEN CHANnel n PHASe 2 92 FGEN CHANnel n SYMMetry 2 93 FGEN CHANnel n TYPE 2 94 FGEN COUPIle AMPLitude 2 94 FGEN PERiod 2 95 IDN 2 96 INSTrument COUPle SOURCce 2 96 INSTrument MODE
50. 0 Series Programmer Manual 2 79 Command descriptions DIAGnostic RUNNing Query Only Group Syntax Returns Examples This command returns the name of the subsystem area and test of the current diagnostic test This command can be issued at any time Diagnostic DIAGnostic RUNNing String of the path of the test which includes subsystem area and test names of currently running test If there is no currently running test then the string is empty DIAGNOSTIC RUNNING might return Channell Waveform Memory Calibration indicating the currently running diagnostic test by the subsystem name area name and test name DIAGnostic SELect No Query Form 2 80 Group Syntax Related Commands This command no query form selects one or more tests of the current test list Tests can be selected by the keyword ALL by subsystem by area or by test The selection by area requires subsystem and a test requires both the subsystem and area NOTE The keywords may be in quotes but is not necessary This command requires that ACTive MODE is set to DIAGnostic If not the following error is generated m 300 Device specific error Not in Diagnostics mode diag sel Channel1 If in the proper active of DIAGnostic then an invalid string generates the following error 220 Parameter error Invalid subsystem diag sel Channel2 Diagnostic DIAGnostic SELect ALL lt path gt ACTive M
51. 2 SA2 162 SA18 0010 ski 2 B R b f 22 34 32 50 42 66 52 82 62 98 72 114 3 23 63 LA19 103 TAZ 123 TA19 143 SA3 163 SA19 0011 ETX DC3 3 c S c s 3 3 13 19 33 51 43 67 53 83 63 99 73 115 4 spc 24 DCL 44 LA4 64 LA20 104 TA4 124 Tazo 144 SA4 164 SA20 0100 EOT DC4 4 D T d t 4 4 14 20 24 36 34 52 44 68 54 84 64 100 74 116 25 PPU 45 LAS 105 TAS 125 TA21 145 SA5 165 SA21 0101 NAK E U e u 15 2 25 37 45 69 55 85 65 101 75 117 6 26 46 Las 66 LA22 106 Tas 126 TA22 146 SA6 166 SA22 0110 ACK SYN amp 6 F v f v 6 6 16 22 26 38 36 54 46 70 56 86 66 102 76 118 7 27 47 LA7 67 LA23 107 TA7 127 TA23 147 SA7 167 SA23 01141 BEL ETB J 7 G w g w 7 7 17 23 27 39 37 55 47 71 57 87 67 103 77 119 10 GET 30 SPE 50 Las 70 LA24 110 Tas 130 TA24 150 sas 170 SA24 1000 BS CAN 8 H X h x 8 8 18 24 28 40 38 56 48 72 58 88 68 104 78 120 11 TCT 31 SPD 51 LA9 71 LA25 111 TAS 131 TA25 151 SA9 171 SA25 1001 HT EM 9 I Y i y 9 9 19 25 29 4 39 57 49 73 59 89 69 105 79 121 12 32 52 Lato 72 LA26 112 Tato 132 172 SA26 1010 LF SUB J z A 10 1A 26 2A 42 3A 58 4A 74 5A 7A 122 13 33 53 LA11 73 LA27 113 TAI 133 173 SA27 1011 VT ESC K B 1 1B 27 2B 43 3B 59 4B 75 58 7B 123 14 34 54 LA12 74 LA28 114 TAI2 134 174 SA28 1100 FF FS 5 lt L i c 12 1C 28 2c 44 3C 60 4c 76 5C 7
52. A is preinstalled on the instrument but to use this protocol Tek VISA must also be installed on the remote controller PC Simple Raw Socket Raw socket server using the Socket Server Plus application The Socket Server Plus application is preinstalled on the instrument Raw Socket setup The following steps to configure the Socket Server Plus application AWG70000 Series Programmer Manual Remote control 1 Enable the Socket Server Plus application a Inthe Windows notification area click the arrow to show the hidden icons b Locate the icon representing the Socket Server Plus application i L Socket Server Plus Icon c Right click on the icon and select Start Socket Server Plus Stop Socket Server Plus Start Socket Server Plus N Properties Exit 2 Set the properties for the Socket Server Plus application a Right click on the icon again and select Properties Properties Sa Socket Server MV Start server at system powerup b In the Properties dialog box set the Socket Server to enable start at system power up c The default Port is set to 4001 Typically this does not need to change NOTE You can change the Port number as long as it doesn t conflict with other applications For instance TekVISA defaults to Port 4000 for communication IP address By default the AWGs are specified to automatically acquire an IP address by DHCP Refer to Windows documentation reg
53. AMPLE Untitled25 1024 OPC resamples the waveform titled Untitled25 to 1024 points The overlapping command is followed with an Operation Complete query AWG70000 Series Programmer Manual 2 189 Command descriptions WLISt WAVeform SHIFt No Query Form This command shifts the phase of a waveform in the waveform list Conditions This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Group Waveform Syntax WLISt wAveform SHIFt lt wfm_name gt lt phase gt Arguments lt wfm_name lt string gt lt phase gt lt NR1 gt Returns lt wfm_name lt string gt lt Size gt lt NR3 gt Examples WLIST WAVEFORM SHIFT Untitled25 180 OPC shifts the waveform titled Untitled25 if it exists by 180 degrees The overlapping command is followed with an Operation Complete query 2 190 AWG70000 Series Programmer Manual Command descriptions WLISt WAVeform TSTamp Query Only Group Syntax Arguments Returns Examples This command returns the timestamp of the waveform NOTE The timestamp is updated whenever the waveform is created or changed The command returns the date as a string in the form yyyy mm dd hh mm ss a blank space between date and time Waveform WLISt wAVeform TSTamp lt wfm_name gt lt wfm_name gt lt string gt yyyy mm dd hh mm ss is the waveform timestamp Where yyyy refers to a four digit year number mm refers to t
54. AWG70000A Series Arbitrary Waveform Generators Programmer Manual HANNAN OTN E O Tektronix 077 0782 02 AWG70000A Series Arbitrary Waveform Generators Programmer Manual www tektronix com Tektronix S 077 0782 02 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 Supports product software version 3 0 and above 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 Table of Contents Getting started IMtrOGUCHOM sieisen id beshedadGhdccdudanudtailedadsa ght nbuadhidastaecdyobiaetaddteamelakeadwebue 1 1 REMOLECONIIO 0 5 cncwsssresncecarsisriets cg eE EEE sede Henceled tae d Seca EAEE EE ERs 1 2 Ethernet Control cesare ii lancas ed A EE aeeddasteddeestegeeneitermaaeats 1 2 GPIB iControl chi o5e3 ees eien E el A EEE OEE GAIET EE OEE 1 3 DOCUMENTATION 3 sssi tienen arn
55. C 124 15 35 55 LA13 75 LA29 115 TA13 135 175 SA29 1101 CR GS 7 M D 13 1D 29 2D 45 3D 61 4D 77 5D 7D 125 16 56 Lata 76 LA30 116 TA14 136 176 SA30 1110 so gt N E 14 2E 46 3E 62 4E 78 5E 7E 126 17 37 57 LA15 77 UNL 117 TAI5 137 UNT 177 11141 SI US l 0 a F 15 1F 31 2F 47 3F 63 4F 79 5F 95 DEL a7 ADDRESSED UNIVERSAL LISTEN 7F TALK SECONDARY ADDRESSES COMMANDS COMMANDS ADDRESSES ADDRESSES OR COMMANDS KEY octal 5 PPC GPIB code with ATN asserted ENQ lt ASCII character hex 5 5 decimal AWG70000 Series Programmer Manual Tektronix REF ANSI STD X3 4 1977 IEEE STD 488 1 1987 ISO STD 646 2973 A 1 Appendix A Character charts A 2 AWG70000 Series Programmer Manual Appendix B 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 m The Line Feed LF code is needed as a terminator at the end of a message m The IEEE 488 1 standard for example Device Clear or Service Request is not supported The Message Exchange Control Protocol in the IEEE 488 2 is not supported However common commands such as ESE and the event handling features are supported The Indefinite format the block start at 0 in the lt ARBITRARY BLOCK PROGRAM DATA gt of the IEEE 488 2 is not supp
56. Command descriptions MMEMory OPEN PARameter NORMalize Conditions Group Syntax Arguments Returns Examples This command sets or queries if the imported data is normalized during select file format import operations The imported waveform data for select file formats is normalized based on the option set in this command File formats supported WFM AWG400 AWG500 AW G600 AWG700 Series waveform AWG AWG5000 AWG7000 Series waveform TXT Analog text files from AWG RFD RFXpress AWG Series waveforms MAT Matlab files Normalization will not be carried out on file formats which are not supported Mass Memory MMEMory OPEN PARameter NORMalize lt Type gt lt type gt NONE FSCale ZREFerence NONE will not normalize the imported data The data may contain points outside of the AWG s amplitude range FSCale normalizes the imported data to the full amplitude range ZREFerence normalizes the imported data while preserving the offset RST sets the arguments to NONE NONE FSC ZREF MMEMORY OPEN NORM NONE imports the waveform with no normalization MMEMORY OPEN NORM might return ZREF indicating that imported data is normalized while preserving the offset MMEMory OPEN SASSet SEQuence No Query Form 2 106 This command loads all sequences or a single sequence if lt desired_sequence gt is designated into the Sequences list and all associated used sequences and waveforms within th
57. E9 OPC sets the expected frequency of the external clock to 10 GHz The overlapping command is followed with an Operation Complete query LOCK ECLOCK FREQUENCY might return 10 0000000000E 9 indicating that the expected frequency of the external clock is 10 GHz CLOCk ECLock FREQuency ADJust No Query Form Conditions Group Syntax Examples This command initiates an adjustment calibration to the system clock circuitry The adjustment can be run at any time but if the system detects setting changes that impact clock accuracy the adjustment is required before any signals can be played A message is displayed in the status area when an adjustment is required A error message is generated if the adjustment fails This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Clock CLOCk ECLock FREQuency ADJust CLOCK ECLOCK FREQUENCY ADJUST OPC performs a calibration of the system clock circuitry when using an external clock signal The overlapping command is followed with an Operation Complete query CLOCk ECLock FREQuency DETect No Query Form 2 56 This command detects the frequency of the signal applied to the Clock In connector and adjusts the system to use the signal The frequency is detected once each time the command executes An error message is gen
58. ER1 VOLTAGE AMPLITUDE 0 5V OPC AWG70000 Series Programmer Manual 2 149 Command descriptions sets the channel 1 marker 1 amplitude to 0 5 volts The overlapping command is followed with an Operation Complete query SOURCE1 MARKERL VOLTAGE AMPLITUDE might return 500 0000000000E 3 volts SOURce n MARKer 1 2 VOLTage LEVel IMMediate HIGH 2 150 Conditions Group Syntax Related Commands Arguments Returns Examples This command sets or returns the marker high voltage level of the selected marker of the selected channel NOTE The following command may overwrite the values set with this command SOURce n MARKer 1 2 VOLTage LE Vel IMMediate AMPLitude This is a blocking command See page 2 9 Sequential blocking and overlapping commands Source SOURce n MARKer 1 2 VOLTage LEVel IMMediate HIGH lt NRf gt SOURCe n MARKer 1 2 VOLTage LEVel IMMediate HIGH SOURce n DAC RESolution SOURce n MAR Ker 1 2 VOLTage LEVel IMMediate LOW A single lt NRf gt value Range 1 4 V to 1 4 V n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 1 V A single lt NRf gt value SOURCE1 MARKER1 VOLTAGE HIGH 0 75 sets the channel 1 marker 1 high level to 750 mV SOURCE1 MARKER1 VOLTAGE HIGH might return 500 0000000000E 3 indicating the channel 1 marker 1 high level is set to 500 mV AW
59. Error Event Queue 1 0 Not used The SRER is made up of bits defined exactly the same as bits 0 through 7 in the SBR as shown in the following figure This register is used by the user to determine what events will generate service requests The SRER bit 6 cannot be set Also the RQS is not maskable AWG70000 Series Programmer Manual 3 3 Status and events 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 SRER Bit 6 must normally be set to 0 7 6 5 4 3 2 1 0 OSB ESB MAV QSB Figure 3 3 Service Request Enable Register SRER Standard Event Status Block SESB 3 4 Reports the power on off state command errors and the running state It consists of the following registers Standard Event Status Register SESR m Event Status Enable Register ESER These registers are made up of the same bits defined in the following figure and table Use the ESR query to read the contents of the SESR Use the ESE command to access the ESER 7 6 5 4 3 2 1 0 PON CME EXE DDE QYE OPC Figure 3 4 Standard
60. F disables the All Output Off function allowing the channel and marker outputs to go to their defined state AWG70000 Series Programmer Manual Returns Examples OUTPut n STATe Conditions Group Syntax Arguments Returns Examples Command descriptions 1 or ON enables the All Output Off function disabling all channel outputs and marker outputs RST sets all channels to 0 A single lt Boolean gt value OUTPUT OFF ON enables All Outputs Off OUTPUT OFF might return 0 indicating the All Outputs Off control is not enabled and each individual channel output will function as set This command sets or returns the output state of the specified channel This is a blocking command See page 2 9 Sequential blocking and overlapping commands Output OUTPut n STATe 0 1 OFF ON ouUTPut n STATe O or OFF disables the channel s output 1 or ON enables the channel s output n 1 2 n determines the channel number If omitted interpreted as 1 RST sets all channels to 0 A single lt Boolean gt value OUTPUT1 STATE ON sets the analog output state of channel 1 to on OUTPUT2 STATE might return 0 indicating channel 2 output is off AWG70000 Series Programmer Manual 2 115 Command descriptions OUTPut n SVALue ANALog STATe Group Syntax Related Commands Arguments Returns Examples This command sets or returns the output condition of a waveform of t
61. G70000 Series Programmer Manual Command descriptions SOURce n MARKer 1 2 VOLTage LEVel IMMediate _LOW Conditions Group Syntax Related Commands Arguments Returns Examples This command sets or returns the marker low voltage level of the selected marker of the selected channel NOTE The following command may overwrite the values set with this command SOURce n MARKer 1 2 VOLTage LEVel IMMediate AMPLitude This is a blocking command See page 2 9 Sequential blocking and overlapping commands Source SOURce n MARKer 1 2 VOLTage LEVel IMMediate Low lt NRf gt SOURce n MARKer 1 2 VOLTage LEVel IMMediate Low SOURce n DAC RESolution SOURce n MARKer 1 2 VOLTage LEVel IMMediate HIGH A single lt NRf gt value Range 1 4 V to 1 4 V n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 0 V A single lt NRf gt value SOURCE1 MARKER1 VOLTAGE LOW 0 5 sets the channel 1 marker 1 low level to 500 mV SOURCE1 MARKERL VOLTAGE LOW might return 500 0000000000E 3 indicating that the channel 1 marker 1 low level is set to 500 mV AWG70000 Series Programmer Manual 2 151 Command descriptions SOURce n MARKer 1 2 VOLTage LEVel IMMediate OFF Set Group Syntax Related Commands Arguments Returns Examples 2 152 This command sets or returns the offset voltage of the s
62. HANNEL1 SYMMETRY might return 100 indicating the symmetry is set to 100 FGEN CHANnel n TYPE Group Syntax Arguments Returns Examples This command sets or returns the function generator s waveform type shape of the selected channel Function generator FGEN CHANnel n TYPE SINE SQUare TRIangle NOISe DC GAUSsian EXPRise EXPDecay NONE FGEN CHANnel n TYPE SINE SQUare TRIangle NOISe DC GAUSsian EXPRise EXPDecay NONE n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to SINE SINE SQU TRI NOIS DC GAUS EXPR EXPD NONE FGEN CHANNEL1 TYPE SINE sets the function generator waveform type for channel 1 to a Sinewave FGEN CHANNEL1 TYPE might return SINE indicating that the function generator waveform type for channel is set to Sinewave FGEN COUPIle AMPLitude Group 2 94 This command sets or returns the coupling mode of the function generator s waveform amplitude controls between channel and channel 2 of a two channel AWG The set form of this command forces the channel 2 amplitude settings to match channel 1 After the initial coupling of the settings changes made to either channel or channel 2 amplitude settings affect both channels Function generator AWG70000 Series Programmer Manual Syntax Arguments Returns Examples Command descriptions FGEN COUPle AMPLitude 0 1 OFF ON FGEN COUP1e AMPLi tude 0 or OFF
63. LOCk SOURce CLOCk ECLock DIVider CLOCk ECLock FREQuency CLOCk ECLock FREQuency ADJust CLOCk ECLock FREQuency DETect CLOCk ECLock MULTiplier CLOCk EREFerence DIVider CLOCk EREFerence FREQuency CLOCk EREFerence FREQuency DETect CLOCk EREFerence MULTiplier CLOCk JITTer CLOCk OUTPut STATe CLOCk SOURce CLOCk SRATe TRIGger SEQuence IMMediate TRIGger SEQuence MPedance TRIGger SEQuence INTerval TRIGger SEQuence LEVel AWG70000 Series Programmer Manual D 1 Appendix D Master amp slave operation TRIGger SEQuence MODE TRIGger SEQuence SLOPe TRIGger SEQuence SOURce Operation with the AWG70000 as a master or slave and system is not idle When synchronization is enabled and the AWG70000 is either a master or a slave the following commands will not cause any changes and will generate an error message while the system is playing or not idle Refer to the individual command for more information SOURce n CASSet SEQuence SOURce n CASSet WAVeform SOURce n DAC RESolution SOURce n WAVeform OUTPut n W VALue MARKer 1 2 OUTPut n WVALue ANALog STATe SLISt SEQuence DELete SLISt SEQuence EVENt PJUMp DEFine SLISt SEQuence EVENt PJUMp ENABle SLISt SEQuence STEP n EJINput SLISt SEQuence STEP n EJUMp SLISt SEQuence STEP n TFLag m AFLag SLISt SEQuence STEP n TFLag m BFLag SLISt SEQuence STEP n TFLag m CFLag SLISt SEQuence STEP n TFLag m DFLag SLISt SEQuence STEP n GOTO SLISt SEQuence STEP RCOunt MA
64. Local Bus in the Host Communications area of the Channell subsystem DISPlay PLOT STATe This command minimizes or restores the plot s display area on the Home screen s channel window of the AWG This command only minimizes or restores the display area it does not close the window Plots in the Function generator window are not affected Group Display Syntax DISP ay PLOT STATe 0 1 OFF ON DISPlay PLOT STATe 2 86 AWG70000 Series Programmer Manual Arguments Returns Examples ESE Group Syntax Related Commands Arguments Returns Examples Command descriptions 0 or OFF minimizes the plot display 1 or ON restores the plot display RST sets this to 1 A single lt NR1 gt value 0 or 1 DISPLAY STATE 0 minimizes the plots on the Home screen window DISPLAY STATE might return 1 indicating that the plot display area on the Home screen is not minimized This command sets or returns the status of Event Status Enable Register ESER See page 3 1 Status and events IEEE mandated and optional ESE lt NRI gt ESE CLS ESR SRE STB A single lt NR1 gt value A single lt NR1 gt value ESE 177 sets the ESER to 177 binary 10110001 which sets the PON CME EXE and OPC bits ESE might return 177 AWG70000 Series Programmer Manual 2 87 Command descriptions ESR Query Only Group Syntax Related Commands Returns Examples This command r
65. NTerval 2 176 TRIGger SEQuence LEVel 2 176 TRIGger SEQuence MODE 2 177 TRIGger SEQuence SLOPe 2 178 TRIGger SEQuence SOURce 2 178 TRIGger SEQuence WVALue 2 179 TST 2 180 W WAI 2 181 WLISt LAST 2 182 WLISt NAME 2 182 WLISt SIZE 2 183 WLISt WAVeform DATA 2 183 WLISt WAVeform DELete 2 184 WLISt WAVeform GRANularity 2 185 WLISt WAVeform LENGth 2 186 WLISt WAVeform LMA Ximum 2 186 WLISt WAVeform LMINimum 2 187 WLISt WAVeform MARKer DATA 2 187 Index 3 Index WLISt WAVeform NEW 2 188 WLISt WAVeform SHIFt 2 190 WLISt WAVeform NORMalize 2 189 WLISt WAVeform TSTamp 2 191 WLISt WAVeform RESample 2 189 WLISt WAVeform TYPE 2 192 Index 4 AWG70000 Series Programmer Manual
66. ODE DIAGnostic UNSelect AWG70000 Series Programmer Manual Arguments Examples Command descriptions ALL selects all available tests lt path gt lt subsystem gt lt area gt lt test gt lt subsystem gt One of the strings listed by the DIAGnostic CATalog command lt area gt One of the strings listed by the DIAGnostic CATalog lt subsystem gt command lt test gt One of the strings listed by the DIAGnostic CATalog lt subsystem gt lt area gt command DIAGNOSTIC SELECT All selects all available tests DIAGNOSTIC SELECT System selects all tests in System subsystem DIAGNOSTIC SELECT Clock1 Clock Internal selects all tests in the Clock Internal area of the Clock1 subsystem DIAGNOSTIC SELECT Clock1i Clock Internal ALL selects all tests in the Clock Internal area of the Clock subsystem DIAGNOSTIC SELECT Channel1 waveform Memory Data Lines selects one test DIAGnostic SELect VERify Query Only Group Syntax Related Commands Arguments Returns Examples This command returns selection status of one specific test A specific test requires WoW the subsystem area and test This is context sensitive and is dependent on the type as set with the command DIAGnostic TYPE Diagnostic DIAGnostic SELect VERify lt subsystem gt lt area gt lt test gt DIAGnostic TYPE DIAGnostic UNSelect lt subsystem gt One of subsystems listed in by the system catalog
67. Operation Complete query To save the setup without waveforms and sequences use the following command MMEMORY SAVE SETUP C mySetup awgx 0 OPC The overlapping command is followed with an Operation Complete query AWG70000 Series Programmer Manual 2 111 Command descriptions MMEMory SAVE WAVeform TXT No Query Form Conditions Group Syntax Arguments Examples This command exports a waveform given a unique waveform name to an eligible storage location from the AWG s waveforms as a text file as the TXT file type NOTE Ifa file already exists in the selected file path it is overwritten without warning If the save fails the file is deleted NOTE The waveform name is renamed to the filename without extension if the waveform source is different from the selected file path This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Mass Memory MMEMOr y SAVE wAVeform TXT lt wfm_name gt lt filepath gt lt bitdepth gt lt wfm name gt lt string gt lt filepath gt lt string gt must contain the complete path with drive letter and file name lt bitdepth gt ANALog DIG8 DIG9 DIG10 MMEMORY SAVE WAVEFORM TXT myWFM C myNewTXTfi le TXT DIGT8 OPC saves the digital eight bit waveform file named myWFM to the filepath and renames the waveform to myNewTXTfile The overlapping command is followed wi
68. SEQuence MODE SYNChronous ASYNchronous lt input_trigger gt TRIGger SEQuence MODE lt input_trigger gt SYNChronous Synchronous triggering This is the recommended trigger type when using the Sync Clock Out to synchronize with external devices ASYNchronous Asynchronous triggering This is the fastest triggering type lt input_trigger gt ATRigger BTRigger Defaults to trigger A if not specified RST sets this to ASYNchronous ASYN SYNC TRIGGER SEQUENCE MODE ASYNCHRONOUS sets the trigger timing to asynchronous type AWG70000 Series Programmer Manual 2 177 Command descriptions TRIGGER SEQUENCE MODE might return ASYN indicating that the trigger mode is set to Asynchronous triggering TRIGger SEQuence SLOPe Conditions Group Syntax Related Commands Arguments Returns Examples This command sets or returns the polarity of the external trigger slope Use this command to set the polarity in modes other than gated mode When synchronization is enabled and the instrument is not the master this command is not available Trigger TRIGger SEQuence SLOPe PoSitive NEGative lt input_trigger gt TRIGger SEQuence SLOPe lt input_trigger gt TRIGger SEQuence SOURce POSitive specifies a trigger on the rising edge of the external trigger signal NEGative specifies a trigger on the falling edge of the external trigger signal lt input trigger gt ATRigger BTRigge
69. Sequence SLISt SEQuence RFLag lt sequence_name gt 0 1 OFF ON SLISt SEQuence RFLag lt sequence_name gt lt sequence_ name gt lt string gt 0 or OFF disables the Flag Repeat This is the default value 1 or ON enables the Flag Repeat A single lt Boolean gt value SLISt SEQuence RFLag MyTest ON enables the Repeat Flag SLISt SEQuence RFLag MyTest returns 0 if the Repeat Flag is not set SLISt SEQuence STEP MAX Query Only Group Syntax This command returns the maximum number of steps allowed in a sequence Sequence SLISt SEQuence STEP MAX AWG70000 Series Programmer Manual 2 125 Command descriptions Returns Examples A single lt NR1 gt value of 16383 SLIST SEQUENCE STEP MAX will return 16383 indicating the maximum number of steps allowed in a sequence SLISt SEQuence STEP n EJINput 2 126 Group Syntax Arguments Returns Examples This command sets or returns wether the sequence will jump when it receives Trigger A Trigger B Internal Trigger or no jump at all This is settable for every step in a sequence Sequence SLISt SEQuence STEP n EJINput lt Sequence_name gt ATRigger BTRigger OFF ITRigger SLISt SEQuence STEP n EJINput lt sequence_name gt n is a step in the sequence with a value between and 16383 lt sequence name gt lt string gt ATRigger This enables the sequencer to jump to the event of a ATRIG BTRigger T
70. Series Programmer Manual C 1 Appendix C Factory initialization settings C 2 Table C 1 Factory initialization settings cont Command Default value FGEN COUPIle AMPLitude 0 off INSTrument COUPle SOURce 0 off INSTrument MODE AWG MMEMory OPEN PARameter NORMalize NONE OUTPut OFF 0 off OUTPut n STATe 0 off OUTPut n SVALue ANALog STATe ZERO OUTPut n SVALue MARKer 1 2 LOW OUTPut n WVALue ANALog STATe ZERO OUTPut n WVALue MARKer 1 2 LOW SLISt SEQuence EVENt JTIMing END SLISt SEQuence EVENt PJUMp ENABle 0 off SLISt SEQuence RFLag 1 on SLISt SEQuence STEP n EJINput 0 off SOURce FREQuency CW F xed 8 GHz SOURce n DAC RESolution 10 SOURce n MARKer 1 2 DELay 0 seconds SOURce n MARKer 1 2 VOLTage LEVel 1V IMMediate AMPLitude SOURce n MARKer 1 2 VOLTage LEVel 1V IMMediate HIGH SOURce n MARKer 1 2 VOLTage LEVel oV IMMediate LOW SOURce n MARKer 1 2 VOLTage LEVel 500 mV IMMediate OFFSet SOURce RCCouple 0 off SOURce n RMODe CONTinuous SOURce n SKEW 0 seconds SOURce n TINPut ATRigger SOURce n VOLTage LEVel IMMediate 500 mV AMPLitude SOURce n VOLTage LEVel IMMediate HIGH 250 mV SOURce n VOLTage LEVel IMMediate _LOW 250 mV SYNChronize ENABle 0 off SYSTem ERRor DIALog 1 enabled TRIGger SEQuence IMPedance 50 Q
71. Sets or returns the divider rate for the external clock AWGControl CLOCk PHASe ADJust NOTE This command exists for backwards compatibility Use the command CLOCk PHASe AD Just Sets or returns the phase of the internal Clock AWGControl CLOCk SOURce NOTE This command exists for backwards compatibility Use the command CLOCk SOURce Sets or returns the clock source AWGControl CONFigure CNUMber Returns the number of channels available on the AWG AWGControl INTerleave ADJustment AMPLitude AWGControl INTerleave ADJustment PHASe Sets or returns the interleave adjustment amplitude percentage Sets or returns the interleave adjustment phase AWGControl RMODe NOTE This command exists for backwards compatibility Use the command SOURce n RMODe Sets or returns the run mode of the AWG AWGControl RS Tate Returns the state of the AWG AWGControl RUN IMMediate Initiates the output of a waveform or sequence AWGControl SNAMe Returns the most recently saved setup location AWGControl SREStore NOTE This command exists for backwards compatibility Use the command MMEMory OPEN SETup Opens a setup file into the AWG s setup memory AWG70000 Series Programmer Manual 2 15 Command groups Table 2 10 Control group commands and their descriptions cont Command Description AWGControl SSAVe NOTE This command exists for backwar
72. T1 WVALUE MARKER2 might return LOW indicating that marker 2 of channel 1 will be a logic level low while channel 1 is in the waiting for trigger state RST No Query Form This command resets the AWG to its default state See page C 1 Factory initialization settings Conditions This is a blocking command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and playing this command is not available Group IEEE mandated and optional Syntax RST Examples RST resets the AWG SLISt NAME Query Only This command returns the name of the sequence at the specified sequence list index Group Sequence Syntax SLISt NAME lt sequence_list_index gt Related Commands SLISt SIZE Arguments lt sequence_list_index gt lt NR1 gt Returns lt sequence_name gt lt string gt NOTE If there is not a sequence at the chosen index an empty string is returned AWG70000 Series Programmer Manual 2 119 Command descriptions Examples SLIST NAME 45 might return AnotherSequence which is the name of the 45th sequence in the current sequence list where SLISt SIZE returned a value greater than 45 SLISt SEQuence DELete No Query Form This command deletes a specific sequence or all sequences from the sequence list Group Sequence Syntax SLISt SEQuence DELete lt sequence_name gt ALL Arguments lt sequence_name gt lt string gt ALL Examples SLIST SEQUENCE DELETE ALL d
73. TPUT2 SVALUE MARKER1 might return LOW indicating that the channel 2 s marker 1 will be a logic level low when in the stopped state OUTPut n WVALue ANALog STATe Conditions Group Syntax Related Commands Arguments Returns This command sets or returns the output condition of a waveform of the specified channel while the instrument is in the waiting for trigger state or for a brief period after the waveform loads to the DAC and before the first point plays This is valid only when the Run Mode is Triggered When synchronization is enabled and playing this command is not available Output OUTPut n wVALue ANALog STATe FIRSt ZERO OUTPut n WVALue ANALog STATe OUTPut n SVALue ANALog STATe JOUTPut n S VALue ANALog STATe FIRSt sets the output level for channel n to match the first point in the waveform when channel n is in the Waiting for trigger state ZERO sets the output level for channel n to 0 volts when channel n is in the Waiting for trigger state n 1 2 n determines the channel number If omitted interpreted as 1 RST sets all channels to ZERO FIRS ZERO AWG70000 Series Programmer Manual 2 117 Command descriptions Examples OUTPUT1 WVALUE ANALOG STATE FIRST sets the output level for channel 1 to match the first point in the waveform when channel is in the Waiting for trigger state OUTPUT2 WVALUE ANALOG STATE might return ZERO indicati
74. TRIGger SEQuence LEVel 1 4 V TRIGger SEQuence MODE ASYNchronous AWG70000 Series Programmer Manual Appendix C Factory initialization settings Table C 1 Factory initialization settings cont Command Default value TRIGger SEQuence SLOPe POSitive TRIGger SEQuence SOURce EXTernal TRIGger SEQuence WVALue ZERO AWG70000 Series Programmer Manual C 3 Appendix C Factory initialization settings C 4 AWG70000 Series Programmer Manual Appendix D Master amp slave operation The AWGSYNCO1 Synchronization Hub provides a means of synchronizing multiple AWG70000 series instruments in a complex system The AWG70000 series instruments can be used as masters or slaves This appendix lists commands that cannot be modified when used in a master slave configuration Operation with the AWG70000 as a master When synchronization is enabled and the AWG70000 is the master the following commands have limited functins Refer to the individual command for more information CLOCk OUTPut STATe TRIGger SEQuence MODE Operation with the AWG70000 as a slave When synchronization is enabled and the AWG70000 is a slave the following commands will not cause any changes and will generate an error message Refer to the individual command for more information TRG SOURce FREQuency CW FIXed SOURce ROSCillator MULTiplier AWGControl RUN IMMediate AWGControl STOP MMediate AWGControl CLOCk DRATe AWGControl C
75. US OPERATION CONDITION might return 0 showing that the bits in the OCR have the binary value 0000000000000000 AWG70000 Series Programmer Manual 2 159 Command descriptions STATus OPERation ENABle Conditions Group Syntax Arguments Returns Examples This command sets or returns the mask for the Operation Enable Register The most significant bit cannot be set true Status STATUS OPERation ENABle lt NR1 gt STATUS OPERation ENAB1e A single lt NR1 gt value A single lt NR1 gt value STATUS OPERATION ENABLE 1 enables the Calibrating bit STATUS OPERATION ENABLE might return 1 showing that the bits in the OENR have the binary value 00000000 00000001 which means that the Calibrating bit is valid STATus OPERation EVENt Query Only Group Syntax Returns Examples 2 160 This command returns the contents of the Operation Event Register OEVR Reading the OEVR clears it Status STATUS OPERation EVENt A single lt NR1 gt value showing the contents of the OEVR STATUS OPERATION EVENT might return showing that the bits in the OEVR have the binary value 00000000 00000001 which means that the CALibrating bit is set AWG70000 Series Programmer Manual Command descriptions STATus OPERation NTRansition Conditions Group Syntax Arguments Returns Examples This command sets or returns the negative transition filter value of the Operation Transit
76. X SLISt SEQuence STEP n TASSet SEQuence SLISt SEQuence STEP n TASSet m WAVeform SLISt SEQuence STEP n WINPut WLISt WAVeform DELete WLISt WAVeform NORMalize WLISt WAVeform RESample WLISt WAVeform SHIFt D 2 AWG70000 Series Programmer Manual Index A ACTive MODE 2 32 AWGControl CLOCk DRATe 2 33 AWGControl CLOCk SOURce 2 35 AWGControl CLOCk PHASe ADJust 2 34 AWGControl CONFigure CNUMber 2 36 AWGControl INTerleave ADJustment AMPLitude 2 36 AWGControl INTerleave ADJustment PHASe 2 37 AWGControl RMODe 2 38 AWGControl RSTate 2 39 AWGControl RUN IMMediate 2 40 AWGControl SNAMe 2 40 AWGControl SREStore 2 41 AWGControl SSAVe 2 41 AWGControl STOP MMediate 2 42 C CAL 2 43 CALibration ALL 2 44 CALibration ABORt 2 43 CALibration CATalog 2 44 CALibration LOG 2 45 CALibration LOG CLEar 2 46 CA Libration LOG DETails 2 47 CALibration LOG FAILuresonly 2 48 CALibration RESTore 2 49 CALibration RESult 2 49 CA Libration RESult TEMPerature 2 50 CA Libration RESult TIME 2 51 CALibration RUNNing 2 51 CALibration STARt 2 51 CALibration STATe FACTory 2 52 CALibration STATe USER 2 53 CALibration STOP STATe 2 54 Character charts A 1 CLOCk ECLock DIVider 2 54 CLOCk ECLock FREQuency 2 55 CLOCk ECLock FREQuency ADJust 2 56 CLOCk ECLock FREQuency DETect 2 56 CLOCk ECLock MULTiplier 2 57 CLOCk EREFerence DIVider 2 58 CLOCk EREFerence FREQuency 2 59 AWG7000
77. an uan En E da vewiid aed EEEN EEE bei AE EEE ESEE bed ueuaues tad cneseaue ys 1 5 Syntax and commands Command Syntax a sesesss eons ccvedivanecetiaten Pes deddsaawtehetentounecenthisaecreeseidand cosedgtaaanneeetes san 2 1 Syntax OVEPVIEW sachs cess adda aN EEE SNN N EE NEEE EE aN A ENR E 2 1 Command and Query Stricture oa scsccsrwenueaus ager EE Ea Er E E E E E A EEEE S 2 1 Clearing the instrument ecceri aa a aa E E N 2 2 Command entry senisiancediteraceatenneh dine bacevarings eeelehtionsceveiriae Alec euhinmncaereussabieebneieae 2 3 Parameter types esaisiasceudeaansdcucctariavasnaanien sande aunune EEN ET oaaeuatie Med ASG 2 4 SCPI commands and Queries iv 0cendortersecnunennnidsneddessnad tenis viniaidenadennnssngerarmatadansenncs 2 8 Sequential blocking and overlapping commands cc ccc eeee ence eee eee e eae eeeaeeneenaes 2 9 Command STOUPS securi a veedicnatwalsnescanabiendaasawidu edagdedalaatodedssanieewegiaeesgereaaciue 2 13 Calibration group COMMAMAS 6 6c cece eee eee ene n een ene EEE EEE EEE Seen EE EEE ES 2 13 Clock group commands cece ccc eee een nnn nnn EE Een EE EEE EEE nen EE EEE Ea 2 14 Control group COMMANS siess eere rr ernia ee r En EENE E aE REE RE EEE EEE eia EEE 2 15 Diagnostic group commands ccc ccc een a K NESEN E E A EE ia 2 16 Display group commands osso correrse srror es is oneta E OEE E E EE EEE E O EE A 2 17 Function generator group commandS s
78. anual 2 35 Command descriptions AWGCONTROL CLOCK SOURCE might return EXT indicating that the clock source is set to use the Clock In connector AWGControl CONFigure CNUMber Query Only Group Syntax Returns Examples This command returns the number of channels available on the AWG Control AwGControl CONFigure CNUMber A single lt NR1 gt value AWGCONTROL CONFIGURE CNUMBER might return 2 AWGControl INTerleave ADJustment AMPLitude Conditions Group Syntax Arguments Returns 2 36 This command sets or returns the interleave amplitude adjustment as a percentage of the analog output voltage The percentage is applied to both of the channel s interleave DACs such that the analog output voltage is minimally affected When the analog output is changed this amplitude percentage is applied at the same time This command is only valid on a single channel model Control AWGControl INTerleave ADJustment AMPLitude lt NRf gt AWGControl INTerleave ADJustment AMPLi tude A single lt NRf gt value Maximum percentage changed is 10 up to and including Min and Max of the analog output amplitude Minimum percentage that can change is 1 RST sets this to 0 lt NRf gt AWG70000 Series Programmer Manual Examples Command descriptions AWGCONTROL INTERLEAVE ADJUSTMENT AMPLITUDE 10 adjusts the relationship between the two DACs by 10 of the analog output The actual a
79. arding network related parameters GPIB control The AWG has a USB 2 0 high speed HS device port to control the instrument through USBTMC or GPIB with a TEK USB 488 Adapter The USBTMC AWG70000 Series Programmer Manual 1 3 Remote control protocol allows USB devices to communicate using IEEE488 style messages This lets you run your GPIB software applications on USB hardware To use GPIB General Purpose Interface Bus start by connecting an appropriate USB cable to the USB 2 0 high speed HS device port on the rear panel of the AWG Connect the other end to the TEK USB 488 Adapter host port Then connect a GPIB cable from the TEK USB 488 Adapter to your PC Before setting up the instrument for remote communication using the electronic physical GPIB interface you should familiarize yourself with the following GPIB requirements E A unique device address must be assigned to each device on the bus No two devices can share the same device address No more than 15 devices can be connected to any one line E One device should be connected for every 6 feet 2 meters of cable used No more than 65 feet 20 meters of cable should be used to connect devices to a bus At least two thirds of the devices on the network should be powered on while using the network Connect the devices on the network in a star or linear configuration Do not use loop or parallel configurations The default setting for the GPIB configurat
80. are still valid if the calibration is aborted and the calibration constants are restored AWG70000 Series Programmer Manual 2 45 Command descriptions Group Syntax Related Commands Returns Examples NOTE The returned string is limited which can cause lost results Only the first 64K of text is recorded Calibration CALibration LOG CALibration LOG CLEar lt string gt lt Started timestamp gt lt LF delimiter gt lt calibration name and result gt lt LF delimiter gt lt calibration name and result gt CALIBRATION LOG might return Channell Dc Amplitude Started 6 14 2011 10 19 AM lt LFCR gt Channel1 Dc Amplitude FAIL lt LFCR gt Channel1 Dc Common Mode Offset Started 6 14 2011 10 23 AM lt LFCR gt Channel1 Dc Common Mode Offset PASS lt LFCR gt CALibration LOG CLEar No Query Form Group Syntax Related Commands Examples 2 46 This command clears the results log The command works when in the active mode for calibration See the ACTive MODE command Calibration CALibration LOG CLEar ACTive MODE CALIBRATION LOG CLEAR clears the results log AWG70000 Series Programmer Manual Command descriptions CALibration LOG DETails This command sets or returns the flag that controls the amount of result information saved into the log Typically the additional information is related to errors It is important to note that details are generated during the calibration and need to b
81. atenate queries the responses to all the queries are concatenated into a single response message For example if the high level of marker one of channel one is 1 0 V and the low level is 0 0 V the concatenated query SOURCe1 MARKer1 VOLTage HIGH SOURCe1 MARKer1 VOLTage LOw will return the following 1 0 0 0 5 Set commands and queries may be concatenated in the same message For example TRIGger SOURCe EXTernal SLOPe is a valid message that sets the trigger source to External The message then queries the external trigger slope Concatenated commands and queries are executed in the order received This documentation uses lt EOM gt end of message to represent a message terminator Table 2 3 Message terminator and meaning Symbol lt EOM gt Meaning Message terminator 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 Parameters are indicated by angle brackets such as lt file name gt There are several different types of parameters as listed in the following table The parameter type is listed after the parameter Some parameter types are defined specifically for the instrument command set and some are defined by SCPI Table 2 4 Parameter types their descriptions and examples
82. ave to use bit masks to obtain the actual value When used on a waveform with n data points you get only n bytes each byte having values for both markers Block data can be sent in batches using Size and StartIndex parameters This command has a limit of 999 999 999 bytes of data If this limit is insufficient consider the following alternatives Send a more efficient file format using MMEM DATA Use Ethernet ftp http or file sharing to transfer the file Waveform AWG70000 Series Programmer Manual 2 187 Command descriptions Syntax Related Commands Arguments Returns Examples WLISt wAVeform MARKer DATA lt wfm_name gt lt StartIndex gt lt Size gt lt block_data gt WLISt wAVeform MARKer DATA lt wfm_name gt lt StartIndex gt lt Size gt WLISt WAVeform DATA lt wfm_name gt lt string gt lt StartIndex gt lt NR1 gt lt Size gt lt NRI gt lt block_data gt lt IEEE 488 2 block gt lt block_data gt WLIST WAVEFORM MARKER DATA myWaveform 0 1000 41000 transfers the marker data to the waveform named myWaveform previously created with the WLISt WAVeform NEW command WLIST WAVEFORM MARKER DATA mywWaveform 0 1000 returns 1000 marker values from myWaveform starting at the first sample WLISt WAVeform NEW No Query Form Group Syntax Related Commands Arguments Examples 2 188 This command creates a new empty waveform in the
83. ber of steps in the named sequence Sequence SLISt SEQuence LENGth lt sequence_name gt lt sequence name gt lt string gt lt number_of_steps gt lt NR1 gt SLIST SEQUENCE LENGTH LongSequence might return 10000 indicating there are 10 000 steps in the sequence named LongSequence SLISt SEQuence NEW No Query Form Group Syntax 2 124 This command creates a new sequence with the selected name number of steps and number of tracks Sequence SLISt SEQuence NEW lt sequence_name gt lt number_of_steps gt lt number_of_tracks gt AWG70000 Series Programmer Manual Arguments Examples Command descriptions lt sequence_ name gt lt string gt lt number_of steps gt lt NR1 gt maximum of 16383 steps and a minimum of 1 lt number_of tracks gt lt NR1 gt maximum of 8 and minimum of 1 defaults to number of available channels 1 or 2 SLIST SEQUENCE NEW LongSequence 16000 4 creates a second sequence named LongSequence with 16000 steps and four tracks SLISt SEQuence RFLag Group Syntax Arguments Returns Examples This command sets or returns the Enable Flag Repeat value for the sequence If the value is ON then the flags will change each time that the step plays out For example if Wfm1 is at a step in Sequence with repeat 2 and one of the flags is set to Toggle then the flag state will toggle twice at this step if the Enable Flag Repeat value is ON
84. c UNSelect Unselects one or more tests of the current test list Display group commands Table 2 12 Display group commands and their descriptions Command Description DISPlay PLOT STATe Minimizes or restores the plot s display area on the Home screen s channel window of the AWG AWG70000 Series Programmer Manual 2 17 Command groups Function generator group commands Table 2 13 Function generator group commands and their descriptions Command Description FGEN CHANnel n AMPLitude Sets or returns the amplitude of the generated waveform of the selected channel FGEN CHANnel n FREQuency Sets or returns the frequency of the generated waveform FGEN CHANnel n DCLevel Sets or returns the DC level of the generated waveform of the selected channel FGEN CHANnel n HIGH Sets or returns the generated waveform s high voltage value of the selected channel FGEN CHANnel n LOW Sets or returns the generated waveform s low voltage value of the selected channel FGEN CHANnel n OFFSet Sets or returns the offset of the generated waveform of the selected channel FGEN PERiod Returns the generated waveform s period FGEN CHANnel n PHASe Sets or returns the generated waveform s phase of the selected channel FGEN CHANnel n SYMMetry Sets or returns the generated waveform s symmetry value of the selected channel FGEN CHANnel n TYPE Sets or returns the waveform type sha
85. c sequence s step and track Group Sequence Syntax SLISt SEQuence STEP n TASSet SEQuence lt sequence_name gt lt subsequence_name gt Arguments lt sSequence_name gt lt string gt lt subsequence_name gt lt string gt n is a step in the sequence lt NR1 gt n is a value between 1 and 16383 not to exceed the number of steps for this sequence Examples SLISt SEQuence STEP5 TASSet SEQuence MyTest Seq360 sets the subsequence Seq360 to the fifth step of all tracks in the sequence named MyTest SLISt SEQuence STEP n TASSet m TYPE Query Only This command returns the type of asset assigned at the step and track for a specified sequence The types of assets are waveform and subsequence Group Sequence Syntax SLISt SEQuence STEP n TASSet m TYPE lt sequence_name gt Arguments lt sequence_name gt lt string gt n is a step in the sequence lt NR1 gt n is a value between 1 and 16383 not to exceed the number of steps for sequence m m is a specific track in a sequence lt NR 1 gt m is a value between 1 and 8 not to exceed the number of tracks in the sequence AWG70000 Series Programmer Manual 2 131 Command descriptions Returns WAVeform SEQuence WAVEform signifies a waveform loaded at the step and track for this sequence SEQuence signifies a subsequence loaded at the step and track for this sequence Examples SLISt SEQuence STEP5 TASSet2 TYPE MyTes
86. call waveform failed invalid DPX spectral data format 1319 Recall waveform failed invalid RSA header format 1320 Recall waveform failed data length error 1321 Recall waveform failed invalid data format 1322 Recall waveform failed invalid marker data format AWG70000 Series Programmer Manual Error messages and codes Table 3 10 Device errors cont Error code Error message 1323 Recall waveform failed invalid file extension 1324 Recall waveform failed invalid file header 1325 Recall waveform failed file type unknown 1326 Recall waveform failed file version not supported 1327 Recall waveform failed no waveform data 1328 Asset not found unable to import asset s 1329 Recall waveform failed unable to open waveform from RSA file 1330 Recall waveform failed waveform format not supported 1331 Invalid operation 1332 Read failed unable to open file 1333 Export failed to write file 1334 Recall waveform failed unable to read filed 1335 Export failed out of disk space 1336 File not found 1337 File format error file format not valid unable to open file 1338 Failed to delete file 1340 Invalid save type save type not valid unable to save file 1341 Asset name error asset list already has an asset with that name unable to save file 1342 Asset not found item is not in t
87. cess to be notified Using the OPC query The OPC query causes the AWG to sense the internal flag referred to as the No Operation Pending flag same as the OPC command AWG70000 Series Programmer Manual 3 9 Status and events When the pending operation has completed a 1 will be returned to the client This query does not use the ESR register and the service request process does not work Using the WAl command The WAI command causes the AWG to sense the same internal flag referred to as the No Operation Pending flag The WAI command prevents any command or query from executing until any pending operation completes AWG70000 Series Programmer Manual Error messages and codes Error messages and codes Error codes with negative values are SCPI standard codes Error codes with positive values are unique to the AWG70000 series Arbitrary Waveform Generators Event codes and messages can be obtained by using the queries SYSTem ERRor and SYSTem ERRor ALL These are returned in the following format Command errors Command errors are returned when there is a syntax error in the command Table 3 6 Command errors Error code Error message 100 Command 101 Invalid character 102 Syntax 103 Invalid separator 104 Data type 105 GET not allowed 108 Parameter not allowed 109 Missing parameter 110 Command header 111 Header separator 112 Pro
88. channel while the instrument is in the waiting for trigger state AWG70000 Series Programmer Manual 2 21 Command groups Sequence group commands Table 2 18 Sequence group commands and their descriptions 2 22 Command Description SLIStNAME Returns the name of the sequence corresponding to the specified index in the sequence list SLISt SEQuence DELete Deletes a specific sequence or all sequences from the sequence list SLISt SEQuence EVENt JTIMing Sets or returns the jump timing of a sequence SLISt SEQuence EVENt PJUMp ENABle Sets or returns the pattern jump for a sequence SLISt SEQuence EVENt PJUMp DEFine Sets or returns the pattern jump targets in the pattern jump table SLISt SEQuence EVENt PJUMp SIZE Returns number of patterns in the pattern table SLISt SEQuence LENGth Returns the total number of steps in the named sequence SLISt SEQuence NEW Creates a new sequence SLISt SEQuence RFLag Sets or returns the Enable Flag Repeat value for the sequence SLISt SEQuence STEP n EJINput Sets or returns weather the sequence of play will jump when it receives Trigger A Trigger B or not jump at all SLISt SEQuence STEP n EJUMp Sets or returns the step that the sequence of play will jump to on a trigger event SLISt SEQuence STEP n GOTO Sets or returns the Goto target for a step SLISt SEQuence STEP n RCOunt Sets or returns the repeat c
89. connector EVARiable clock is generated internally and the reference frequency is derived from a variable reference supplied at the Reference In connector EXTernal clock signal supplied by the Clock In connector and the reference frequency is derived from the internal precision oscillator RST sets this to INT Returns INT EFIX EVAR EXT Examples CLOCK SOURCE INTERNAL OPC sets the clock source to internal The overlapping command is followed with an Operation Complete query CLOCK SOURCE might return EFIX indicating that the clock source is set to use the Reference In connector AWG70000 Series Programmer Manual 2 65 Command descriptions CLOCk SOUT STATe This command sets or returns the state of the Sync Clock Out output Group Clock Syntax CLOCk SOUT STATe 0 1 OFF ON CLOCk SOUT STATe Arguments 0 or OFF disables the Sync Clock Out 1 or ON enables the Sync Clock Out RST sets this to 0 Returns A single lt Boolean gt value 0 or 1 Examples CLOCK SOUT STATE 1 sets the Sync Clock Out output to ON CLOCK SOUT STATE might return 0 indicating that the Sync Clock Out output is off CLOCk SRATe This command sets or returns the sample rate for the clock Conditions This command is not valid when CLOCk SOURCe is set to EXTernal This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is
90. d Function generator FGEN CHANnel n DCLevel lt NRf gt FGEN CHANnel n DCLevel A single lt NR3 gt value Range 250 mV to 250 mV n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 0 A single lt NRf gt value FGEN CHANNEL1 DCLEVEL 0 12 sets the function generator DC level for channel 1 to 120 mV FGEN CHANNEL1 DCLEVEL might return 250 0000000000E 3 indicating that the function generator DC level for channel 1 is set to 250 mV AWG70000 Series Programmer Manual 2 89 Command descriptions FGEN CHANnel n FREQuency Conditions Group Syntax Related Commands Arguments Returns Examples This command sets or returns the function generator s waveform frequency If the value entered is higher than the designated maximum frequency or lower than the designated minimum then the respective max min values are used Function generator FGEN CHANnel n FREQuency lt NRf gt FGEN CHANnel n FREQuency INSTrument MODE A single lt NRf gt value Range 1 Hz to 50 MHz RST sets this to 1 2 MHz A single lt NRf gt value FGEN CHANNEL FREQUENCY 1 25 E6 sets the function generator frequency to 1 25 MHz FGEN CHANNEL AMPLITUDE might return 1 2000000000E 6 indicating that the function generator frequency is set to 1 2 MHz FGEN CHANnel n HIGH Group Syntax Related Commands 2 90 This command sets or retu
91. d Each procedure is prefixed with lt subsystem gt lt area gt and separated by a comma Lists are always in priority of desired execution If the area parameter is ALL then all the procedures of all the areas for a specified subsystem is returned Each procedure is prefixed with lt area gt and separated by a comma Lists are always in priority of desired execution If the subsystem and area parameters are valid then the list of procedures for that subsystem and area is returned wow Returns String of all calibration subsystems areas and or procedures separated by commas Examples CALIBRATION CATALOG might return Initialization Channell Channel2 System CALIBRATION CATALOG Channel1 might return Dc Adc Clock Align Dac Marker1 Marker2 CALIBRATION CATALOG ALL might return Initialization Init Calibration Initialization Channel1 Dc Differential Offset Channel1 Dc Common Mode Channel1 Dc Amplitude Channell Adc Adc Internal Channell Clock Clock Amplitude Channel1 Clock Clock Offset Channell Align Sample Point Channell Dac Speed CALibration LOG Query Only This command returns a string of continuous concatenated calibration results The start time is recorded plus one or more lt cal path gt lt cal name gt lt result gt This command can be issued while calibration is still in progress Use the CALibration LOG CLEar command to start a fresh log and provide additional information Log results
92. d by a byte to determine the number of bytes to read 9 9 indicates that we need to read 9 bytes to determine the length of the following data block 999 999 999 separated by commas to help separate they will not be present normally Because of the size limitation it is suggested that the user make use of the starting index and size for querying to append data in multiple commands queries Waveform WLISt wAVeform DATA lt wfm_name gt lt StartIndex gt lt Size gt lt block_data gt WLISt wAVeform DATA lt wfm_name gt lt StartIndex gt lt Size gt WLISt WAVeform NEW WLISt WAVeform MARKer DATA StartIndex Size lt block_data gt lt wfm_name gt lt string gt lt StartIndex gt lt NR1 gt lt Size gt lt NR1 gt lt block_data gt lt IEEE 488 2 block gt lt block_data gt WLIST WAVEFORM DATA Testwfm 0 1024 44096xxxx transfers the waveform data to a waveform called TestWfm created earlier using the WLISt WAVeform NEW command The data size is 1024 points 4096 bytes and the start index is 0 the first data point WLISt WAVeform DELete No Query Form 2 184 This command deletes the waveform from the waveform list NOTE When ALL is specified all user defined waveforms in the list are deleted in a single action Note that there is no UNDO action once the waveforms are deleted Use caution before issuing this command If the deleted waveform is currently loaded
93. de it s recommended to follow the action with an operation complete command OPC to ensure the command has finished before other commands are processed This is a blocking command See page 2 9 Sequential blocking and overlapping commands Diagnostic ACTive MODE NORMal CALibration DIAGnostic ACTive MODE DIAGnostic ABORt DIAGnostic STOP CALibration ABORt NORMa disables any active state for either calibration or diagnostics When entering the active state of normal the hardware is set to a default state and the previous system state is restored and waveform playout is set to off CALibration enables the active state for the calibration Entering the active state of calibration turns waveform playout off DIAGnostic enables the active state for the diagnostics Entering the active state of diagnostics turns waveform playout off AWG70000 Series Programmer Manual Returns Examples Command descriptions RST sets this to NORM NORM CAL DIAG ACTIVE MODE DIAGNOSTIC enables the diagnostics mode ACTIVE MODE might return DIAG if in the diagnostics mode AWGControl CLOCk DRATe Conditions Group Syntax Related Commands Arguments Returns NOTE This command exists for backwards compatibility Use the command CLOCk ECLock DiVider This command sets or returns the divider rate for the external clock Setting the clock divider rate forces the clock multiplier rate to a value of 1 T
94. disables the function generator s amplitude coupling 1 or ON enables the function generator s amplitude coupling RST sets this to 0 A single lt Boolean gt value 0 or 1 FGEN COUPLE AMPLITUDE ON couples the amplitude controls of channel 1 and channel 2 together FGEN COUPLE AMPLITUDE might return 0 indicating that the amplitude controls of channel 1 and channel 2 are not coupled together FGEN PERiod Query Only Group Syntax Related Commands Returns Examples This command returns the function generator s waveform period Function generator FGEN PERiod INSTrument MODE A single lt NR3 gt value FGEN PERIOD might return 1 0000000000E 6 indicating that the waveform period is 1 0 ps AWG70000 Series Programmer Manual 2 95 Command descriptions IDN Query Only Group Syntax Returns Examples This command returns identification information for the AWG Refer to Std IEEE 488 2 for additional information IEEE mandated and optional IDN lt Manufacturer gt lt model gt lt serial number gt lt Firmware version gt lt Manufacturer gt TEKTRONIX lt Model gt AWG70001A AWG70002A lt Serial number gt XXXX XXX indicates an actual serial number lt Firmware version gt SCPI 99 0 FW x x x x x x x x is software version IDN might return TEKTRONIX AWG70001A B010123 SCPI 99 0 FW 1 0 136 602 INSTrument COUPle SOURce Group Syntax
95. does a full calibration and returns a status indicating the success or failure of the operation This command is equivalent to the CAL command This command cannot be aborted This is a blocking command See page 2 9 Sequential blocking and overlapping commands Calibration CALibration ALL CALibration ALL CAL lt calibration error code gt lt NR1 gt 0 indicates no error 340 indicates an error CALIBRATION ALL performs a calibration CALIBRATION ALL performs a calibration and returns results For example it might return 0 indicating that the calibration completed without any errors CALibration CATalog Query Only 2 44 Group This command returns the list of calibration procedures All tests are grouped by areas All areas are grouped by subsystems The available subsystems areas and tests depend on the type of testing such as POST or ALL Calibration AWG70000 Series Programmer Manual Command descriptions Syntax CALibration CATalog ALL lt subsystem gt ALL lt area gt Arguments ALL Keyword or as a string lt subsystem gt a subsystem as a string lt area gt an area as a String If there are no parameters then the list of subsystems is returned If there is a valid subsystem parameter then the list of areas for that subsystem is returned If the subsystem parameter is ALL then all the procedures of all the areas of all the subsystems is returne
96. ds compatibility Use the command MMEMory SAVE SETup Saves the AWG s setup with waveforms AWGControl STOP IMMediate Stops the output of a waveform or sequence Diagnostic group commands Table 2 11 Diagnostic group commands and their descriptions 2 16 Command Description ACTive MODE Enables and disables access to diagnostics or calibration DlAGnostic ABORt Stops the current diagnostic test DlAGnostic CATalog Returns the list of all diagnostic tests per selected type DlAGnostic CONTrol COUNt Sets or returns the number of loop counts used when the selected loop mode is COUNT DlIAGnostic CONTrol HALT Determines or returns whether the next execution of diagnostics looping stops on the first diagnostic failure that occurs or continues to loop on the selected set of diagnostic functions DlAGnostic CONTrol LOOP Determines or queries whether the next start of diagnostics runs once runs continuous loops or loops for a number times for the selected set of tests DlAGnostic DATA Returns the results of last executed tests for the NORMal diagnostic type DlAGnostic IMMediate Executes all of the NORMal diagnostic tests The query form executes the selected tests and returns the results DlAGnostic LOG Returns a string of continuous concatenated test results DlAGnostic LOG CLEar Clears the diagnostics results log DlAGnostic LOG FAlLuresonly Sets
97. e SLISt SEQuence STEP n TFLag m DFLag lt sequence_name gt NCHange HIGH LOW TOGG1e PULSe SLISt SEQuence STEP n TFLag m DFLag lt sequence_name gt AWG70000 Series Programmer Manual Arguments Returns Examples Command descriptions n is a step in the sequence lt NRI gt m is a specific track in a sequence lt NR1 gt lt sequence_name gt lt string gt NCHange The flag state continues to be in the state is defined in the previous step Default value HIGH The flag signal transitions to the high state LOW The flag signal transitions to the low state TOGG1e The flag signal transitions to the high state if the previous step defined the flag to be in the low state and vice versa PULSe The flag signal outputs a pulse signal of a fixed width NCH HIGH LOW TOGG PULS SLISt SEQuence STEP5 TFLAG1 DFLag MyTest HIGH sets the Flag output of Flag D to high when the instrument is playing out the fifth step of the first track of sequence MyTest SLISt SEQuence STEP2 TFLAG3 DFLag MyTest might return LOW when Flag D of sequence MyTest is set to LOW in the second step of track 3 SLISt SEQuence STEP n WINPut Group Syntax Related Commands This command sets or returns the trigger source for the wait input state for a step Send a trigger signal in one of the following ways m Use an external trigger signal m Push the Force Trigger button on the fr
98. e V HZ for frequency Hz m OHM for impedance ohm S for time s DBM for power ratio m PCT for VPP for Peak to Peak Voltage V p p m UIPP for Peak to Peak Unit is UI UI p p UIRMS for RMS Unit is UI UIrms m SPP for Peak to Peak Unit is second s p p m SRMS for RMS Unit is second srms E V NS for SLEW s unit V ns The SI prefixes which must be included are shown in the following table You can enter both uppercase and lowercase characters Table 2 7 SI prefixes and their indexes SI prefix 4 Corresponding power EX 1018 PE 1015 T 1012 109 MA 106 K 103 AWG70000 Series Programmer Manual 2 7 Command syntax Table 2 7 SI prefixes and their indexes cont SI prefix Corresponding power M 10 3 U2 10 6 N 10 9 P 10 12 F 10 15 A 10 18 1 Note that the prefix m M indicates 10 3 when the decimal numeric argument denotes voltage or time but indicates 106 when it denotes frequency 2 Note that the prefix u U is used instead of y 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 1OMHz 10E 6Hz 10E 6 incorrect 10M SCPI commands and queries 2 8 The AWG 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
99. e STEP n EJINput 2 126 SLISt SEQuence STEP n EJUMp 2 127 SLISt SEQuence STEP n GOTO 2 128 SLISt SEQuence STEP n RCOunt 2 129 SLISt SEQuence STEP n TASSet m 2 130 SLISt SEQuence STEP n TASSet m TY PE 2 131 SLISt SEQuence STEP n TASSet m WAVeform 2 133 SLISt SEQuence STEP n TASSet SEQuence 2 131 SLISt SEQuence STEP n TFLag m AFLag 2 133 SLISt SEQuence STEP n TFLag m BFLag 2 135 SLISt SEQuence STEP n TFLag m CFLag 2 135 SLISt SEQuence STEP n TFLag m DFLag 2 136 SLISt SEQuence STEP n WINPut 2 137 SLISt SEQuence STEP RCOunt MAX 2 130 SLISt SEQuence TRACKk 2 138 SLISt SEQuence TRACk MAX 2 140 AWG70000 Series Programmer Manual SLISt SEQuence TSTamp 2 140 SLISt SIZE 2 141 SOURce FREQuency CW FIXed 2 141 SOURce RCCouple 2 142 SOURce ROSCillator MULTiplier 2 143 SOURce n CASSet 2 144 SOURce n CASSet SEQuence 2 144 SOURce n CASSet TYPE 2 145 SOURce n CASSet WAVeform 2 145 SOURce n DAC RESolution 2 146 SOURce n JUMP FORCe 2 147 SOURce n JUMP PATTern FORCe 2 147 SOURce n MARKer 1 2 DELay 2 148 SOURce n MARKer 1 2 VOLTage LEVel IMMediate AMPLitude 2 149 SOURce n MARKer 1 2 VOLTage LEVel IMMediate HIGH 2 150 SOURce n MARKer 1 2 VOLTage LEVel IMMediate LOW 2 151 SOURce n MARKer 1 2 VOLTage LEVel IMMediate OFFSet 2 152 SOURce n RMODe 2 153 SOURce n SCSTep 2 154 SOURc
100. e designated file in lt filepath gt File formats supported AWG AWG7000 Series setup AWGX AWG70000 Series setup AWG70000 Series Programmer Manual Command descriptions SEQ AWG400 AWG500 AWG600 Series sequence SEQX AWG70000 Series sequence NOTE If the sequence any subsequent sequence or any associated waveform name already exists it will be overwritten without warning Conditions This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Group Mass Memory Syntax MMEMory OPEN SASSet SEQuence lt filepath gt lt desired_sequence gt Arguments lt filepath gt lt string gt must contain the complete path with drive letter and file name lt desired_sequence gt lt string gt Examples Assuming the file AWG_w_2seqs awgx has two sequences named Sequence and Sequence in it MMEMORY OPEN SASSET SEQUENCE C TestFiles AWG_w_2seqs awgx Sequencel1 OPC imports Sequence alone and all waveforms used by Sequencel The overlapping command is followed with an Operation Complete query Assuming the file AWG_w_2seqs awgx has waveforms Sequence and Sequence2 in it MMEMORY OPEN SASSET SEQUENCE C TestFiles AWG_w_2seqs awgx OPC imports both Sequence and Sequence2 and all waveforms used by both sequences The overlapping command is followed with an Operation Complete query Assuming the file AWG w_ 2seqs awgx has two sequences named Seq
101. e level This manual is available on the Tektronix Web site www Tektronix com manuals AWG70000 Series Programmer Manual 1 5 Documentation 1 6 AWG70000 Series Programmer Manual Syntax and commands Command syntax Syntax overview Control the operations and functions of the AWG through the 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 AWG 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 Refer to the following table for the symbols that are used Table 2 1 Syntax symbols and their meanings Symbol Meaning lt gt Defined element Is defined as Exclusive OR Group one element is required Optional can be omitted Previous elements can be repeated Comment Command and query structure Overview Messages Commands consist of set commands and query commands usually called commands and queries Commands modify instrument settings or tell the instrument to perform a specific action Queries cause the instrument to return data and status information Most commands have both a set form and a query form The query form of the command differs from the set form by its question mark on the end For example the set command AWGControl RSTate has a query form AWGC
102. e multiplier rate of the external clock CLOCk EREFerence DIVider Sets or returns the divider rate of the external reference oscillator CLOCk EREFerence FREQuency Sets or returns the expected frequency of the signal applied to the EXT REF input connector CLOCk EREFerence FREQuency DETect Detects the frequency of the signal applied to the EXT REF input connector and adjusts the system to use the signal CLOCk EREFerence MULTiplier Sets or returns the multiplier rate of the variable external reference signal CLOCk JITTer Sets or returns whether or not low jitter Jitter Reduction is enabled on the internal system clock or the clock signal applied to the Reference In connector CLOCk OUTPut FREQuency Returns the frequency of the output clock CLOCk OUTPut STATe Sets or returns the output state of the clock output CLOCk PHASe ADJust Sets or returns the internal clock phase adjustment of the AWG CLOCk SOURce Sets or returns the source of the clock CLOCk SOUT STATe Sets or returns the state of the Sync Clock Out output CLOCk SRATe Sets or returns the sample rate for the clock AWG70000 Series Programmer Manual Control group commands Command groups Table 2 10 Control group commands and their descriptions Command Description AWGControl CLOCk DRATe NOTE This command exists for backwards compatibility Use the command CLOCk ECLock D IVider
103. e n SKEW 2 154 SOURce n TINPut 2 155 SOURce n VOLTage LEVel IMMediate AMPLitude 2 156 SOURce n VOLTage LE Vel IM Mediate HIGH 2 156 SOURce n VOLTage LE Vel IM Mediate LOW 2 157 SOURce n WAVeform 2 158 SRE 2 159 Standard Event Status Block SESB 3 4 Status and event processing sequence 3 8 Status and events 3 1 reporting system 3 1 Status Byte Register SBR 3 3 STATus OPERation EVENt 2 160 STATus OPERation CONDition 2 159 STATus OPERation ENABle 2 160 STATus OPERation NTRansition 2 161 STATus OPERation PTRansition 2 161 STATus PRESet 2 162 STATus QUEStionable EVENt 2 163 STATus QUEStionable CONDition 2 162 AWG70000 Series Programmer Manual Index STATus QUEStionable ENABle 2 162 STATus QUEStionable NTRansition 2 163 STATus QUEStionable PTRansition 2 164 STB 2 164 SYNChronize ADJust STARt 2 165 SYNChronize CONFigure 2 165 SYNChronize DESKew STARt 2 167 SY NChronize DESKew ABORt 2 167 SYNChronize DESKew STATe 2 168 SYNChronize ENABle 2 168 SYNChronize TYPE 2 169 Synchronizing execution 3 9 SYSTem DATE 2 170 SYSTem ERRor NEXT 2 172 SYSTem ERRor ALL 2 170 SYSTem ERRor CODE NEXT 2 171 SYSTem ERRor CODE ALL 2 171 SYSTem ERRor COUNt 2 171 SYSTem ERRor DIALog 2 172 SYSTem TIME 2 173 SYSTem VERSion 2 173 T TRG 2 174 TRIGger SEQuence IMMediate 2 174 TRIGger SEQuence MPedance 2 175 TRIGger SEQuence I
104. e saved during execution Enabling details potentially reduces the number of pass fail results in the log due to log size limitations 0 and 1 are the same as OFF and ON respectively Conditions The set form of this command only works in the active mode for calibration See the ACTive MODE command Group Calibration Syntax CALibration LOG DETails OFF ON 0 1 CALibration LOG DETai 1s Related Commands ACTive MODE Arguments OFF disables the detail mode ON enables the detail mode lt Boolean gt of 0 or 1 only 0 and 1 are equivalent to OFF and ON respectively RST sets this to 0 Returns A single lt Boolean gt value representing current cal log details setting 0 1 Examples CALIBRATION LOG DETAILS CALIBRATION LOG DETAILS OFF disables the detail mode CALIBRATION LOG DETAILS might return 0 showing the detail mode is disabled CALIBRATION LOG DETAILS might return Channel1 Dc Amplitude Started 6 14 2011 10 19 AM lt LFCR gt Channel1 Dc Amplitude FAIL lt LFCR gt CALIBRATION LOG DETAILS 1 enables the detail mode CALIBRATION LOG DETAILS might return 1 showing enabled detailed message in the log AWG70000 Series Programmer Manual 2 47 Command descriptions CALIBRATION LOG DETAILS might return Channell Dc Amplitude Started 6 14 2011 10 19 AM Temperature 40C lt LFCR gt Error 0x01dc2345 Negative Low Value Out of Range Expected 0 08V Actual 0 78V lt LFCR gt Channel1 Dc Amplitude FAIL lt LFCR gt CAL
105. e space character is used between a command header and the related argument Optionally a white space may consist of multiple white space characters Commands cause the instrument to perform a specific function or change one of the settings Commands have the structure lt Header gt lt Space gt lt Argument gt lt Comma gt lt Argument gt A command header consists 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 off 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 cause the instrument to return status or setting information Queries have the structure lt Header gt lt Header gt lt Space gt lt Argument gt lt Comma gt lt Argument gt Clearing the instrument Use the Device Clear DCL or Selected Device Clear SDC functions to clear the Output Queue and reset the instrument to accept a new command or query AWG70000 Series Programmer Manual Command entry Rules Abbreviating Concatenating Command syntax The following rules apply when entering commands You can enter commands in upper or lower case You can precede any command with white space characters White space characters include any combination of the ASCII control characters 00 th
106. e status about the results of the last start of a set of selected calibration procedures CALibration RESult TEMPerature Returns the temperature from the results of the last start of a set of selected procedures CALibration RESult TIME Returns the time from the results of the last start of a set of selected procedures CALibration RUNNing Returns the name of the subsystem area and procedure in progress CALibration STARt Starts the selected set of calibrations CALibration STATe FACTory Returns the current factory state of the calibration for the AWG CALibration STATe USER Returns the current factory state of the calibration for the AWG CALibration STOP STATe Returns the state of the calibration procedure AWG70000 Series Programmer Manual 2 13 Command groups Clock group commands Table 2 9 Clock group commands and their descriptions Command Description CLOCk ECLock DIVider Sets or returns the divider rate of the external clock CLOCk ECLock FREQuency Sets or returns the expected frequency being provided by the external clock CLOCk ECLock FREQuency ADJust Adjusts the external clock to the frequency specified by the user or set by the external clock frequency detect CLOCk ECLock FREQuency DETect Detects the frequency of the signal applied to the Clock In connector and adjusts the system to use the signal CLOCk ECLock MULTiplier Sets or returns th
107. e which can be accessed with SYSTem ERRor NEXT Conditions This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Group Clock Syntax CLOCk EREFerence FREQuency DETect Examples CLOCK EREFERENCE FREQUENCY DETECT OPC detects the clock frequency applied to the Reference In connector The overlapping command is followed with an Operation Complete query 2 60 AWG70000 Series Programmer Manual Command descriptions CLOCk EREFerence MULTiplier This command sets or returns the multiplier rate of the variable external reference signal Conditions Setting the external reference multiplier rate forces the external reference divider rate to a value of 1 This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Group Clock Syntax CLOCk EREFerence MULTiplier lt NR1 gt CLOCk EREFerence MULTiplier Arguments A single lt NR1 gt value Range 1 to 1000 limited by the maximum sample rate RST sets this to 1 Returns A single lt NR1 gt value Examples CLOCK EREFERENCE MULTIPLIER 50 OPC sets the multiplier to 50 The overlapping command is followed with an Operation Complete query CLOCK EREFERENCE MULTIPLIER might return 100
108. ed sets the Run Mode to Triggered waiting for a trigger event One waveform play out cycle completes then play out stops waiting for the next trigger event RST sets this to CONT Returns CONT TRIG Examples AWGCONTROL RMODE TRIGGERED sets the AWG Run mode to Triggered AWGCONTROL RMODE might return CONT if the AWG is in continuous mode 2 38 AWG70000 Series Programmer Manual Command descriptions AWGControl RSTate Query Only Group Syntax Related Commands Returns Examples This command returns the run state of the AWG Control AWGControl RSTate SOURce n RMODe A single lt NR1 gt value 0 indicates that the AWG has stopped 1 indicates that the AWG is waiting for trigger 2 indicates that the AWG is running AWGCONTROL RSTATE returns 0 if waveform generation is stopped AWG70000 Series Programmer Manual 2 39 Command descriptions AWGControl RUN IMMediate No Query Form Conditions Group Syntax Related Commands Examples This command initiates the output of a waveform or sequence This is equivalent to pushing the play button on the front panel or display The AWG can be put in the run state only when waveforms or sequences are assigned to channels This is a blockingcommand See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Control AWGControl RUN
109. een executed and passed E Subsystems will be calibrated when all areas for that subsystem are calibrated Each calibrated as opposed to uncalibrated state will have a temperature and date time m An uncalibrated state will not have a valid temperature or date time and should be ignored Results will be undetermined if there is a calibration procedure in progress Calibration CALibration STATe FACTory lt subsystem gt lt area gt lt subsystem gt lt string gt lt area gt lt string gt lt test gt lt string gt lt State gt lt State gt S C U Reflects the current state C Calibrated U Uncalibrated AWG70000 Series Programmer Manual Command descriptions D Date and time T Temperature in C Examples Query the factory calibration state of the system CALIBRATION STATE FACTORY might return INT S C D 2 1 2013 12 00 00 AM T 44 Query a specific area state CALIBRATION STATE FACTORY Channel1 Dc might return Channel1 Dce S U D 1 1 1970 12 00 00 AM T 0 CALibration STATe USER Query Only This command returns the current user state of the calibration for the AWG A calibration state will be Calibrated or Uncalibrated m Areas will be calibrated when all procedures for that area have been executed and passed Subsystems will be calibrated when all areas for that subsystem are calibrated E Each calibrated as opposed to uncalibrated
110. elected marker of the selected channel NOTE The following command may overwrite the values set with this command SOURce n MARKer 1 2 VOLTage LEVel IMMediate AMPLitude Source SOURCe n MARKer 1 2 VOLTage LEVel IMMediate OFFSet lt NR3 gt SOURCe n MARKer 1 2 VOLTage LEVel IMMediate OFFSet SOURce n DAC RESolution SOURce n MARKer 1 2 VOLTage LEVel MMediate HIGH SOURce n MARKer 1 2 VOLTage LEVel IM Mediate LOW A single lt NR3 gt value Range 1 15 V to 1 15 V n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 500 mV A single lt NR3 gt value SOURCE1 MARKER1 VOLTAGE OFFSET 0 5 sets the channel 1 marker 1 offset to 500 mV SOURCE1 MARKERL VOLTAGE OFFSET might return 500 0000000000E 3 indicating that the channel 1 marker 1 offset is set to 500 mV AWG70000 Series Programmer Manual Command descriptions SOURce n RMODe This command sets or returns the run mode of the specified channel Group Source Syntax SOURCe n RMODe CONTinuous TRIGgered TCONtinuous SOURCe n RMODe Related Commands SOURce n TINPut TRG Arguments CONTinuous sets the Run Mode to Continuous not waiting for trigger TRIGgered sets the Run Mode to Triggered waiting for a trigger event One waveform play out cycle completes then play out stops waiting for the next trigger event TCONtinuous sets the R
111. eletes all sequences from the current sequence list SLIST SEQUENCE DELETE MySequence deletes the sequence named MySequence 2 120 AWG70000 Series Programmer Manual Command descriptions SLISt SEQuence EVENt JTIMing This command sets or returns the condition of when the sequencer jumps upon a logic event pattern jump or software forced jump The jump can occur immediately or at the end of the current sequence step Group Sequence Syntax SLISt SEQuence EVENt JTIMing lt sequence_name gt END IMMediate SLISt SEQuence EVENt JTIMing lt Sequence_name gt Arguments END on receiving an event wait until the end of current step before jumping to specified event jump step IMMedi ate on receiving an event immediately jump to specified event jump step Returns END IMM Examples SLIST SEQUENCE EVENT JTIMING MySequence END requires all event jumps to wait for the end of current sequence step before jumping to the event jump step SLIST SEQUENCE EVENT JTIMING MySequence might return IMM indicating that all event jumps are to be processed immediately in sequence SLISt SEQuence EVENt PJUMp DEFine This command associates an event pattern with the jump to step for Pattern Jump The query returns the jump step associated to the specified pattern The event pattern is read from the Pattern Jump In connector on the rear panel Eight bits of data and a strobe are required When the strobed event pattern is rece
112. ency A single lt NRf gt value If the clock output state is not enabled 0 0000 is returned If the clock output state is enabled a value between 6 25 GHz and 12 5 GHz is returned depending on the sample rate CLOCK OUTPUT FREQUENCY might return 12 4999955600E 49 indicating that the clock output is enabled and the frequency is essentially 12 5 GHz CLOCk OUTPut STATe Conditions Group Syntax Related Commands Arguments Returns This command sets or returns the state of the output clock Enabling Clock Out provides a high speed clock that is related to sample rate to drive other devices or to measure This is a blocking command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is the master the command choice is limited to ON or 1 When synchronization is enabled and the instrument is not the master this command is not available Clock CLOCk OUTPut STATe 0 1 OFF ON CLOCk OUTPut STATe CLOCk SOURce A single lt Boolean gt value 0 or OFF disables the clock out 1 or ON enables the clock out RST sets this to 0 A single lt Boolean gt value 0 or 1 AWG70000 Series Programmer Manual 2 63 Command descriptions Examples CLOCK OUTPUT STATE ON sets the Clock Output to ON CLOCK OUTPUT STATE might return 1 indicating that the output clock is enabled CLOCk PHASe ADJust Conditions Group Sy
113. end data in multiple commands queries NOTE If querying a size that is larger than the remaining data on the file according to the size of the file and or the starting index the returned size will be all of the remaining data size will be truncated to the size of the remaining number of bytes left in the file Group Mass Memory Syntax MMEMory DATA lt file_path gt lt start_index gt lt block_data gt MMEMory DATA lt file_path gt lt start_index gt lt size gt Related Commands MMEMory CDIRectory MMEMory MSIS Arguments lt file_path gt lt string gt lt start_index gt lt NRI gt is the byte index where writing reading will commence in the desired lt file_path gt lt size gt lt NR1 gt is the size in bytes to read lt block_data gt IEEE 488 2 data block AWG70000 Series Programmer Manual 2 99 Command descriptions Returns Examples lt block_data gt MMEMORY DATA 123 TXT 13ABC loads ABC into 123 TXT in the current directory Assuming C 123 txt already contains ABC MMEMORY DATA C 123 txt 3 223DEFGHIJKLMNOPQRSTUVWXYZ starts loading appends the data at byte index 3 of C 123 txt The file will now contain ABCDEFGHIJKLMNOPQRSTUVWXYZ Assuming C 123 txt contains the final text in the example above MMEMORY DATA C 123 txt Return is 226A BCDEFGHIJKLMNOPQRSTUVWXYZ Assuming C 123 txt contains the final text in the example above MMEMORY DATA C
114. erated if no frequency is detected or is out of range AWG70000 Series Programmer Manual Conditions Group Syntax Related Commands Examples Command descriptions This command is only valid if the clock source is set to External See the CLOCk SOURce command This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Clock CLOCk ECLock FREQuency DETect CLOCk SOURce CLOCK ECLOCK FREQUENCY DETECT OPC detects the clock frequency applied to the Clock In connector The overlapping command is followed with an Operation Complete query CLOCk ECLock MULTiplier Conditions Group Syntax Related Commands This command sets or returns the multiplier rate of the external clock Setting the clock multiplier rate forces the clock divider rate to a value of 1 This command is only valid if the clock source is set to External See the CLOCk SOURce command This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Control CLOCk ECLock MULTiplier lt NR1 gt CLOCk ECLock MULTiplier CLOCk ECLock DIVider CLOCk SRATe CLOCk SOURce AWG70000 Series Programmer Manual 2 57 Command descriptions Arguments Returns Examp
115. es an event forcing the sequencer to the step specified by the pattern in the pattern jump table If the sequence is playing on both channels the force jump is applied to both channels simultaneously Source SOURCe n JUMP PATTern FORCe lt pattern gt AWG70000 Series Programmer Manual 2 147 Command descriptions Arguments Examples lt pattern gt lt NRI1 gt The values ranges between 0 and 255 This parameter specifies the event pattern to make an event jump The pattern bits are mapped to the integer value as follows MSB LSB Event bits 76543210 SOURCE2 JUMP PATTERN FORCE 15 jumps to the location chosen in the definition of event pattern 00001111 for channel 2 If SLIST SEQUENCE EVENT PJUMP DEFINE MySequence 255 4 and MySequence is playing then SOURCEL JUMP PATTern FORCe 255 the sequence will jump to step 4 for channel 1 SOURce n MARKer 1 2 DELay Conditions Group Syntax Related Commands Arguments Returns Examples 2 148 This command sets or returns the marker delay Marker delay is independent for each channel This is a blocking command See page 2 9 Sequential blocking and overlapping commands Source SOURCe n MARKer 1 2 DELay lt NR3 gt SOURcCe n MARKer 1 2 DELay SOURce n DAC RESolution A single lt NRf gt value Range 0 to 100E 12 seconds n 1 2 n determines the channel number If omitted interpreted as 1 RST sets
116. es that the instrument is currently performing a calibration When the specified state changes in the OCR its bit is set or reset This change is filtered with a transition register and the corresponding bit of the OEVR is set If the bit corresponding to the event has also been set in the OENR the SBR OSS bit is also set Questionable status block The questionable status register set contains bits which give an indication of the quality of various aspects of the signal together with the fanned out registers as described in the next subsections It consists of the following registers m Questionable Condition Register QCR E Questionable Positive Negative Transition Register QPTR QNTR Questionable Event Register QEVR Questionable Enable Register QENR These registers are made up of the same bits defined in the following table and figure Use the STATus QUEStionable commands to access the questionable status register set 13 e 10 DESK 9 8 7 6 5 4 3 2 1 0 ADJ FREQ TEMP 0782 002 Figure 3 6 Questionable status register 3 6 Table 3 5 Questionable status register bit definition Bit Description 15 Always zero 0 14 11 Not used 10 DESKew Deskew calibration required due to temperature out of range 9 ADJust ADJ External clock adjustment required 8 6 Not used FREQuency FREQ Using External Reference or frequency is out of range
117. eturns This command returns the SCPI version number to which the command conforms System SYSTem VERSion A single lt NR2 gt value lt NR2 gt YYYY V where YYYY is the year version and V is revision number for that year AWG70000 Series Programmer Manual 2 173 Command descriptions Examples SYSTEM VERSION might return 1999 0 TRG No Query Form This command generates a trigger event for Trigger A only This is equivalent to pressing the Trig A button on front panel Conditions When synchronization is enabled and the instrument is not the master this command is not available Group IEEE mandated and optional Syntax TRG Related Commands TRIGger SEQuence MMediate Examples TRG generates a trigger event TRIGger SEQuence I MMediate No Query Form This command generates a trigger A or B event If a trigger is not specified the command is then equivalent to the TRG command Conditions When synchronization is enabled and the instrument is not the master this command is not available Group Trigger Syntax TRIGger SEQuence IMMediate lt input_trigger gt Related Commands TRG SOURce n TINPut Arguments lt input trigger gt ATRigger BTRigger Defaults to trigger A if not specified 2 174 AWG70000 Series Programmer Manual Examples Command descriptions TRIGGER SEQUENCE IMMEDIATE ATRIGGER generates a trigger A event TRIGger SEQuence I MPedance Conditions Grou
118. eturns the status of Standard Event Status Register SESR See page 3 1 Status and events IEEE mandated and optional ESR CLS ESE SRE STB A single lt NR1 gt value ESR might return 181 which indicates that the SESR contains the binary number 10110101 FGEN CHANnel n AMPLitude Group Syntax Related Commands Arguments Returns 2 88 This command sets or returns the function generator s waveform amplitude value of the selected channel Function generator FGEN CHANnel n AMPLitude lt NRf gt FGEN CHANnel n AMPLitude INSTrument MODE FGEN CHANnel n HIGH FGEN CHANnel n LOW FGEN CHANnel n OFFSet A single lt NRf gt value n 1 2 n determines the channel number If omitted interpreted as 1 Range 0 to 500 mV RST sets this to 500 mV A single lt NRf gt value AWG70000 Series Programmer Manual Examples Command descriptions FGEN CHANNEL1 AMPLITUDE 0 35 sets the function generator output for channel to 350 mV FGEN CHANNEL1 AMPLITUDE might return 250 0000000000E 3 indicating that the function generator output for channel is set to 250 mV FGEN CHANnel n DCLevel Conditions Group Syntax Arguments Returns Examples This command sets or returns the DC level of the generated waveform of the selected channel If the value exceeds the designated maximum or minimum offset then the respective max min values are use
119. f Status Byte Register See page 3 1 Status and events IEEE mandated and optional STB AWG70000 Series Programmer Manual Command descriptions Related Commands CLS ESE ESR SRE Returns A single lt NR1 gt value Examples STB might return 96 which indicates that the SBR contains the binary number 0110 0000 SYNChronize ADJust STARt No Query Form This command only performs a system sample rate calibration on the synchronized system This command may take up to 3 minutes to complete Conditions This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is not enabled this command is not available When synchronization is enabled and the instrument is not the master this command is not available Group Synchronization Syntax SYNChronize ADJust STARt Examples SYNCHRONIZE ADJUST START starts the calibration on the synchronized system SYNChronize CONFigure This command configures the ports in a synchronized system and forces an initialization within the selected configuration Conditions This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is not enabled this command is not available When synchronization is enabled and the instrument is not the master this command is not available Group Synchronization AWG70000 Series Programmer Manual 2 165 Command descr
120. form from the waveform list to the specified channel When synchronization is enabled and playing this command is not available Source SOURce n CASSet wAVeform lt wfm_name gt lt wfm_name gt lt string gt n 1 2 n determines the channel number If omitted interpreted as 1 SOURCE1 CASSET WAVEFORM SINE100 assigns waveform SINE100 to Channel 1 AWG70000 Series Programmer Manual 2 145 Command descriptions SOURce n DAC RESolution This command sets or returns the DAC resolution Conditions This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and playing this command is not available Group Source Syntax SouRce n DAC RESolution 8 9 10 SOURCe n DAC RESolution Arguments 8 indicates 8 bit DAC Resolution 2 marker bits 9 indicates 9 bit DAC Resolution 1 marker bit 10 indicates 10 bit DAC Resolution 0 marker bits n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 10 Returns A single lt NRI gt value 8 9 or 10 Examples SOURCE1 DAC RESOLUTION 10 OPC sets the channel 1 DAC resolution to 10 bits 0 marker bits The overlapping command is followed with an Operation Complete query SOURCE1 DAC RESOLUTION might return 8 indicating 8 bit DAC resolution 2 marker bits 2 146 AWG70000 Series Programmer Manual Command descriptions SOURce n JUMP
121. from the external controller into the specified waveform or from a waveform to the external control program NOTE Before transferring data to the instrument a waveform must be created using the WLISt WAVeform NEW command Use this command to set both analog and marker data To set only the marker data use the WLISt WAVeform MARKer DATA command Using StartIndex and Size part of a waveform can be transferred at a time Very large waveforms can be transferred in chunks Waveform data is always transferred in the LSB first format The format of the transferred data depends on the waveform type If Size is omitted the length of waveform is assumed to be the value of the Size parameter Transferring large waveforms in chunks allows external programs to cancel the operation before it is completed The instrument supports floating point format Floating point waveform data points occupy four bytes So the total bytes will be four times the size of the waveform The minimum size of the waveform must be 1 and the maximum size depends on the instrument model and configuration This command has a limit of 999 999 999 bytes of data AWG70000 Series Programmer Manual 2 183 Command descriptions Group Syntax Related Commands Arguments Returns Examples As the IEEE 488 2 is a limitation that the largest read or write that may occur in a single command is 999 999 999 bytes as the structure is defined as a followe
122. ge unit specifier specified within the file path AWGCONTROL SRESTORE C TestFiles mySetup awgx AWGControl SSAVe No Query Form Conditions Group NOTE This command exists for backwards compatibility Use the command MMEMory SAVE SETup This command saves the AWG s setup with waveforms This is a blocking command See page 2 9 Sequential blocking and overlapping commands Control AWG70000 Series Programmer Manual 2 41 Command descriptions Syntax Related Commands Arguments Examples AWGControl SSAVe lt filepath gt lt msus gt MMEMory SAVE SETup lt filepath gt lt string gt lt msus gt mass storage unit specifier lt string gt AWGCONTROL SSAVE C TestFiles mySetup awgx AWGCONTROL SSAVE TestFiles mySetup awgx C AWGControl STOP IMMediate No Query Form Conditions Group Syntax Related Commands Examples 2 42 This command stops the output of a waveform or a sequence This is a blocking command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Control AWGControl STOP IMMediate AWGControl RUN IMMediate AWGCONTROL STOP IMMEDIATE OPC stops the output of a waveform or sequence AWG70000 Series Programmer Manual CAL Query Only Conditions Group Syntax Related Commands Returns Examples Command description
123. gram mnemonic too long 113 Undefined header 114 Header suffix out of range 120 Numeric data 121 Invalid character in number 123 Exponent too large 124 Too many digits 128 Numeric data not allowed 130 Suffix 131 Invalid suffix 134 Suffix too long 138 Suffix not allowed AWG70000 Series Programmer Manual Error messages and codes Table 3 6 Command errors cont Error code Error message 140 Character data 141 Invalid character data 144 Character data too long 148 Character data not allowed 150 String data 151 Invalid string data 158 String data not allowed 160 Block data 161 Invalid block data 168 Block data not allowed 170 Expression 171 Invalid expression 178 Expression data not allowed 180 Macro 181 Invalid outside macro definition 183 Invalid inside macro definition 184 Macro parameter Execution errors These error codes are returned when an error is detected while a command is being executed Table 3 7 Execution errors Error code Error message 200 Execution 201 Invalid while in local 202 Settings lost due to RTL 210 Trigger 211 Trigger ignored 212 Arm ignored 213 Init ignored 214 Trigger deadlock 215 Arm deadlock 3 12 AWG70000 Series Programmer Manual Error messages and codes Table 3 7 Execution errors cont
124. h IEEE Std 488 2 These bits are used to monitor the output queue SESR and service requests respectively The contents of this register are returned when the STB query is used 6 7 RQS 5 4 3 2 1 0 Oss 6 ESB MAV ss Eav MSS Figure 3 2 Status Byte Register SBR Table 3 2 SBR bit functions Bit Description T Operation Summary Status OSS Summary of the operation status register 6 Request Service RQS Master Status Summary MSS When the instrument is accessed using the serial poll command this bit is called the Request Service RQS bit and indicates to the controller that a service request has occurred The RQS bit is cleared when serial poll ends When the instrument is accessed 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 Event Status Bit ESB 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 Message Available Bit MAV This bit indicates that a message has been placed in the output queue and can be retrieved 3 Questionable Summary Status QSS Summary of the Questionable Status Byte register 2 Event Quantity Available EAV Summary of the
125. he SOURce n WAVeform command AWG70000 Series Programmer Manual Command groups Byte order during transfer Waveform data is always transferred in LSB first format AWG70000 Series Programmer Manual 2 29 Command groups 2 30 AWG70000 Series Programmer Manual Command descriptions AWG70000 Series Programmer Manual 2 31 Command descriptions ACTive MODE 2 32 Conditions Group Syntax Related Commands Arguments This command enables and disables access to diagnostics or calibration When the active mode is DIAGnostic or CALibration all other non diagnostic and non calibration commands are ignored and no action occurs If a test or procedure is in progress errors are not returned they are added to the system error queue which can be accessed with SYSTem ERRor NEXT For example m 200 D C are still running m 300 Device specific error Diagnostics tests still in progress act mode diag m 300 Device specific error Calibration procedures still in progress act mode cal To avoid this error use the command DIAGnostic STOP STATe or CALibration STOP STATe to test for this condition This command blocks when changing any state Changing the state to NORMal causes a hardware initialization process and any related system settings are restored If any diagnostic tests are in progress then the request to change the active mode fails and the mode will not change When changing the active mo
126. he Asset List unable to save file 1343 Recall failed IQ waveform error 1344 Restore setup failed unable to open setup file 1345 Error in file format or data unable to restore the sequence and it s assets 1346 Subsequences not supported restored subsequences will be added to the Sequence List but the sequence steps they occupied will be shown as Empty 1347 Missing asset file s waveform or sequence file s not found shown as Empty in the sequence table 1348 Restore pattern table error Pattern Jump table has too many rows Restored the first 256 patterns only 1600 Timing error unable to change clock setting 1601 Timing error lost timing lock 1602 Channel error unable to change channel parameter 1603 USB lock unlock failed Administrator permissions are required to lock or unlock the USB ports Check the Windows security settings or contact your network administrator 1604 Force Jump error unable to force jump to specified step AWG70000 Series Programmer Manual Error messages and codes Table 3 10 Device errors cont Error code Error message 1605 External Clock adjustment failed check the Clock In signal 1606 External Clock error clock In differs from external clock adjustments Check the Clock In signal or Adjust 1606 External Clock error Clock In differs from the external clock adjustments Check the Clock In signal or Adjust 1700 1701 Resample failed
127. he specified channel while the instrument is in the stopped state Output OUTPut n SVALue ANALog STATe OFF ZERO OUTPut n SVALUe ANALog STATe SOURce n RMODe OFF sets the stop state output for channel n to open electrically disconnected ZERO sets the stop state output for channel n value to 0 volts n 1 2 n determines the channel number If omitted interpreted as 1 RST sets all channels to ZERO OFF ZERO OUTPUT1 SVALUE ANALOG STATE OFF sets channel 1 s output to be disconnected when in the stopped state OUTPUT1 SVALUE ANALOG STATE might return ZERO indicating that when channel is in the stopped state the output will be 0 volts OUTPut n SVALue MARKer 1 2 Group Syntax Arguments 2 116 This command sets or returns the condition of the specified marker of the specified channel when in the stopped state Output OUTPut n SVALUe MARKer 1 2 OFF LOw OUTPut n SVALUe MARKer 1 2 OFF sets the stop state marker output for channel n to open electrically disconnected LOW sets the stop state marker output for channel n value to 0 volts n 1 2 n determines the channel number If omitted interpreted as 1 AWG70000 Series Programmer Manual Returns Examples Command descriptions RST sets all channel markers to LOW OFF Low OUTPUT1 SVALUE MARKER1 OFF sets the channel 1 s marker 1 to be disconnected when in the stopped state OU
128. his enables the sequencer to jump to the event of a BTRIG ITRigger This enables the sequencer to jump to the event of an Internal Trigger OFF Ignores all events even if an event occurs during that step RST sets this to OFF ATR BTR ITR OFF SLISt SEQuence STEPL EJINput MySequence ATR allows the sequencer to jump to step 1 after receiving a Trigger A event from Force Trig A or a signal on the Trigger A input connector SLISt SEQuence STEP1 EJINput MySequence might return BTR indicating this step will only jump after receiving a Trigger B event from a Force Trig B or a signal on the Trig B input connector AWG70000 Series Programmer Manual Command descriptions SLISt SEQuence STEP n EJUMp This command sets or returns the step that the specified sequence will jump to on a trigger event This setting is only available if the event jump input has been selected as Trigger A or Trigger B for the specified step Conditions The Event Input must be set at the same step with the command SLISt SEQuence STEP n EJINput Group Sequence Syntax SLISt SEQuence STEP n EJUMp lt sequence_name gt lt NR1 gt NEXT FIRSt LAST END SLISt SEQuence STEP n EJUMp lt Sequence_name gt Related Commands _ SLISt SEQuence STEP n EJINput Arguments n is a step in the sequence lt NR1 gt lt sequence name gt lt string gt lt NRI gt This enables the sequencer to jump to the specified step where the value
129. his is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Control AWGControl CLOCk DRATe lt NR1 gt AWGControl CLOCk DRATe CLOCk ECLock MULTiplier CLOCk SRATe AWGControl CLOCk SOURce A single lt NRI gt value that is a power of 2 Range 1 to 16777216 RST sets this to 1 A single lt NR1 gt value AWG70000 Series Programmer Manual 2 33 Command descriptions Examples AWGCONTROL CLOCK DRATE 4 OPC sets the external clock divider rate to 4 The overlapping command is followed with an Operation Complete query AWGCONTROL CLOCK DRATE might return 4 AWGControl CLOCk PHASe ADJust Conditions Group Syntax Arguments Returns Examples 2 34 NOTE This command exists for backwards compatibility Use the command CLOCk PHASe ADJust This command sets or returns the internal clock phase adjustment of the AWG This is a blocking command See page 2 9 Sequential blocking and overlapping commands Control AWGControl CLOCk PHASe ADJust lt NR1 gt AWGControl CLOCk PHASe ADJust A single lt NR1 gt value Range 10800 degrees to 10800 degrees A single lt NR1 gt value AWGCONTROL CLOCK PHASE ADJUST 100 sets the clock phase to 100 degrees AWGCONTROL CLOCK PHASE ADJUST might return 100 indicating the clock
130. ibility Use the command MMEMory OPEN Loads a file into the AWG waveform list MMEMory IMPort PARameter NORMalize NOTE This command exists for backwards compatibility Use the command MMEMory OPEN PARameter NORMalize Sets or returns if the imported data is normalized during select file format import operations The imported waveform data for select file formats is normalized based on the option set in this command MMEMory MDIRectory Creates a new directory in the current path on the mass storage system MMEMory MSIS Sets or returns a mass storage device used by all MMEMory commands MMEMory OPEN Loads a file into the AWG waveform list MMEMory OPEN PARameter NORMalize Sets or returns if the imported data is normalized during select file format import operations MMEMory OPEN SASSet WAVeform Loads all waveforms or a single desired waveform from a file into the AWG s waveforms list MMEMory OPEN SASSet SEQuence Loads all sequences or a single desired sequence from a file into the AWG s sequences list MMEMory OPEN SETup Opens a setup file into the AWG s setup memory MMEMory OPEN TXT Loads a file into the AWG s waveform list AWG70000 Series Programmer Manual Command groups Table 2 16 Mass Memory group commands and their descriptions cont Command Description MMEMory OPEN PARameter NORMalize Sets or returns if the imported data is normalized du
131. ibration LOG FAlLuresonly Conditions Group Syntax Related Commands Arguments Returns Examples 2 48 This command sets or returns the flag that controls the amount of result information saved into the log This controls all tests that pass or fail or only tests that fail It is important to note that details are generated during the test and need to be saved during the test execution The set form of this command only works in the active mode for calibration See the ACTive MODE command Calibration CALibration LOG FAILuresonly OFF ON 0 1 CALibration LOG FAILuresonly ACTive MODE OFF disables the failures only mode ON enables the failures only mode lt Boolean gt 0 1 0 and 1 are the equivalent of OFF and ON respectively RST sets this to 0 A single lt Boolean gt value representing current calibration log failures only state O 1 CALIBRATION LOG FAILURESONLY OFF disables the failure only log mode CALIBRATION LOG FAILURESONLY 1 enables the failure only log mode CALIBRATION LOG FAILURESONLY might return 1 indicating the failure only log mode is enabled AWG70000 Series Programmer Manual Command descriptions CALibration RESTore No Query Form This command restores the calibration constants from the factory non volatile memory and copied to user storage Conditions Setting only works in the active mode for calibration See the ACTive MODE command This is a blocking co
132. indicating that the external clock multiplier rate is set to 100 AWG70000 Series Programmer Manual 2 61 Command descriptions CLOCk JITTer Conditions Group Syntax Arguments Returns Examples This command sets or returns whether or not low jitter Jitter Reduction is enabled on the internal system clock or the clock signal applied to the Reference In connector This is a blocking command See page 2 9 Sequential blocking and overlapping commands When enabled the sample rate is limited by clock frequency multiples of 50 MHz When synchronization is enabled and the instrument is not the master this command is not available Clock CLOCk JITTer 0 1 OFF ON 0 or OFF disables jitter reduction 1 or ON enables jitter reduction RST sets this to 0 A single lt Boolean gt value 0 or 1 CLOCK JITTER ON enables the jitter reduction mode for system clock CLOCK JITTER might return 0 indicating that the jitter reduction mode is not enabled for the system clock CLOCk OUTPut FREQuency Query Only Conditions Group 2 62 This command returns the frequency of the output clock on the Clock Out connector If clock output state is not enabled 0 0000 is returned When synchronization is enabled and the instrument is not the master this command is not available Control AWG70000 Series Programmer Manual Syntax Returns Examples Command descriptions CLOCK OUTPut FREQu
133. ing that error messages will be displayed on the AWG SYSTem ERRor NEXT Query Only This command returns data from the error and event queues Group System Syntax SYSTem ERRor NEXT Returns lt Error number gt lt error description gt Error number lt NR1 gt error description lt string gt 2 172 AWG70000 Series Programmer Manual Examples SYSTem TIME Group Syntax Arguments Returns Examples Command descriptions SYSTEM ERROR NEXT might return 0 No error indicating there are not errors This command sets or returns the system time hours minutes and seconds This command is equivalent to the time setting through the Windows Control Panel System SYSTem TIME lt hour gt lt minute gt lt second gt SYSTem TIME lt hour gt lt minute gt lt second gt lt hour gt lt NRI1 gt specifies the hours Range 0 to 23 lt minute gt lt NR1 gt specifies the minutes Range 0 to 59 lt second gt lt NRI gt specifies the seconds Range 0 to 59 lt hour gt lt minute gt lt second gt lt hour gt lt NR 1 gt specifies the hours lt minute gt lt NR1 gt specifies the minutes lt second gt lt NR1 gt specifies the seconds These values are rounded to the nearest integer SYSTEM TIME 10 15 30 sets the time to 10 15 30 SYSTEM TIME might return 12 20 32 indicating the system time is 12 20 32 SYSTem VERSion Query Only Group Syntax R
134. ings listed by DIAGnostic CATalog lt area gt One of the strings listed by DIAGnostic CATalog lt subsystem gt lt test gt One of the strings listed by DIAGnostic CATalog lt subsystem gt lt area gt lt result record gt lt result record gt lt subsystem gt lt area gt lt test gt lt details gt lt details gt lt Status gt lt Loop Count gt lt Pass gt lt Fail gt lt Status gt S P F R Reflects the current or last state When the status reflects only the subsystem or area then an F for Fail will be set for any of the tests that have failed lt Loop Count gt LC lt Pass gt P lt Fail gt F P Pass F Fail R Running lt NRI1 gt AWG70000 Series Programmer Manual Command descriptions Examples Asking for a specific test result DIAGNOSTIC RESULT Channel1 waveform Memory Calibration might return Channell Waveform Memory Calibration S F LC 1 P 0 F 1 Asking for a specific area result DIAGNOSTIC RESULT Channel1 waveform Memory might return Channell Waveform Memory S F Asking for a specific subsystem result DIAGNOSTIC RESULT Channel1 might return Channel1 S F Asking for all test results of a specific area DIAGNOSTIC RESULT Channel1 waveform Memory ALL might return Channell Waveform Memory Calibration S F LC 1 P 0 F 1 Channell Waveform Memory Data Lines S P LC 1 P 1 F 0 Channell Waveform Me
135. ion might return 32 2 78 AWG70000 Series Programmer Manual Command descriptions DIAGnostic RESult TIME Query Only This command returns the time from the results of the last start of a set of selected tests Time is returned as a date time string as in the following example of 3 14 2013 10 19 AM Time for an area or subsystem have the following requirements The time only reflects the selected tests The selected tests must have results of pass or fail As an example if 3 of the 4 tests in an area has been selected then only those 3 contribute to the area result If only 2 of the selected 3 have run and completed a stop event occurred then only those 2 contribute to the result The time returned which is associated with the highest temperature of any selected test is returned when the results for more than one test is requested as in an area Group Diagnostic Syntax DIAGnostic RESuIt TIME lt subsystem gt lt area gt lt test gt Arguments lt subsystem gt lt string gt lt area gt lt string gt lt test gt lt string gt Returns lt time gt lt time gt lt string gt lt string gt Ascii text in the form of mm dd yy followed by the time in hr min as in the example of 3 14 2013 10 19 AM Examples DIAGNOSTIC RESULT TIME Channel1 waveform Memory Calibration might return Channell Waveform Memory Calibration Time 2 5 2013 4 51 53 PM AWG7000
136. ion Register OTR The most significant bit cannot be set true Status STATUS OPERation NTRansition lt bit_value gt STATUS OPERation NTRansition lt bit_value gt lt NR1 gt is the negative transition filter value A single lt NR1 gt value showing the contents of the OTR STATUS OPERATION NTRANSITION 17 sets the negative transition filter value to 17 STATUS OPERATION NTRANSITION might return 17 STATus OPERation PTRansition Conditions Group Syntax Arguments Returns AWG70000 Series Programmer Manual This command sets or returns the positive transition filter value of the Operation Transition Register OTR The most significant bit cannot be set true Status STATUS OPERation PTRansition lt bit_value gt STATUS OPERation PTRansition lt bit_value gt lt NR1 gt is the positive transition filter value A single lt NR1 gt value showing the contents of the OTR 2 161 Command descriptions Examples STATUS OPERATION PTRANSITION 0 sets the positive transition filter value to 17 STATUS OPERATION PTRANSITION might return 0 STATus PRESet No Query Form Group Syntax Examples This command sets the Operation Enable Register OENR and Questionable Enable Register QENR Status STATUS PRESet STATUS PRESET resets the SCPI enable registers STATus QUEStionable CONDition Query Only Group Syntax Related Commands Returns Examples
137. ion is GPIB Address 1 If you need to change the GPIB address do the following 1 Display the Utilities screen and select System 2 Set the GPIB address 3 Ifthe TEK USB 488 adapter is connected to the instrument disconnect and reconnect the adapter to ensure the new address is acquired A ae Run diag i id self calibration Diagnos Calibration let view deta Preferences Help amp Support 1014 4 35 03 PM About my AWG GPIB requires external USB to GPIB converter ct converter after GPIB Ac AWG70000 Series Programmer Manual Documentation To read about Safety and Installation Documentation Review the following table to locate more information about this product Use these documents Read the Safety and Installation manual for general safety information and proper instrument installation Operation and User Interface Help Access the user help from the Help menu for information on controls and screen elements Programmer commands Read the Programmer manual to learn the proper syntax of remote commands This manual is available on the Tektronix Web site www Tektronix com manuals Specifications and Performance Verification procedures Read the Technical Reference document for specifications and the performance verification procedures This manual is available on the Tektronix Web site www Tektronix com manuals Service Procedures Read the Service Manual to service the AWG to the modul
138. iptions Syntax SYNChronize CONFigure lt port_configuration gt SYNChronize CONFigure Arguments lt port_configuation gt lt NR1 gt NR1 Sum of Port 1 Port 2 Port 3 and Port 4 Where Port 1 1 shall always be on as Master of synchronized system Port 2 2 if enabled otherwise 0 Port 3 4 if enabled otherwise 0 Port 4 8 if enabled otherwise 0 Returns lt NRI gt lt port_configuration gt Examples SYNCHRONIZE CONFIGURE 3 OPC enables Ports 1 and 2 in this synchronized system The overlapping command is followed with an Operation Complete query SYNCHRONIZE CONFIGURE might return 15 indicating that Ports 1 2 3 and 4 are enabled in this synchronized system 2 166 AWG70000 Series Programmer Manual Command descriptions SYNChronize DESKew ABORt No Query Form Conditions Group Syntax Examples This command cancels a system deskew calibration This is an overlapping command See page 2 9 Sequential blocking and overlapping commands The command might take up to 10 minutes to cancel When synchronization is not enabled this command is not available When synchronization is enabled and the instrument is not the master this command is not available Synchronization SYNChronize DESKew ABORt SYNCHRONIZE DESKEW ABORT OPC returns when deskew calibration is cancelled The overlapping command is followed with an Operation Complete query SYNChronize DESKew STARt N
139. is command sets or returns the Flag A value of the track in a sequence step Flags are not allowed in sequence steps containing a subsequence Sequence SLISt SEQuence STEP n TFLag m AFLag lt sequence_name gt NCHange HIGH LOw TOGG1e PULSe SLISt SEQuence STEP n TFLag m AFLag lt Sequence_name gt n is a step in the sequence lt NR1 gt m is a specific track in a sequence lt NR1 gt lt sequence_name gt lt string gt AWG70000 Series Programmer Manual 2 133 Command descriptions 2 134 Returns Examples NCHange The flag state continues to be in the state is defined in the previous step Default value HIGH The flag signal transitions to the high state LOW The flag signal transitions to the low state TOGG1e The flag signal transitions to the high state if the previous step defined the flag to be in the low state and vice versa PULSe The flag signal outputs a pulse signal of a fixed width NCH HIGH LOW TOGG PULS SLISt SEQuence STEP5 TFLAG1 AFLag MyTest HIGH sets the Flag output of Flag A to high when the instrument is playing out the fifth step of the first track of sequence MyTest SLISt SEQuence STEP2 TFLAG3 AFLag MyTest might return LOW when Flag A of sequence MyTest is set to LOW in the second step of track 3 AWG70000 Series Programmer Manual Command descriptions SLISt SEQuence STEP n TFLag m BFLag Conditions Group Syntax
140. is in the waiting for trigger state NOTE This command exists for backwards compatibility Use the commands OUTPut n WVALue ANALog STATe and OUTPut n WVALue MARKer 1 2 Table 2 24 Waveform group commands and their descriptions Command Description WLISt LAST Returns the name of the most recently added waveform in the waveform list WLISt NAME Returns the waveform name of an element in the waveform list WLISt SIZE Returns the size of the waveform list WLISt WAVeform DATA Transfers waveform data from the external controller into the specified waveform or from a waveform to the external control program WLISt WAVeform DELete Deletes the waveform from the currently loaded setup WLISt WAVeform GRANularity Returns the granularity of sample points required for the waveform to be valid AWG70000 Series Programmer Manual 2 27 Command groups 2 28 Waveform data format Table 2 24 Waveform group commands and their descriptions cont Command Description WLISt WAVeform LMAXimum Returns the maximum number of waveform sample points allowed WLISt WAVeform LMINimum Returns the minimum number of waveform sample points required for a valid waveform WLISt WAVeform LENGth Returns the size of the waveform WLISt WAVeform MARKer DATA Sets or returns the waveform marker data WLISt WAVeform NEW Creates a new empty waveform in the waveform list of current setu
141. ived an event pattern jump is created moving the sequence to the step defined in this command Conditions The pattern jump feature for the sequence must be set to enabled See SLISt SEQuence EVENt PJUMp ENABle Group Sequence AWG70000 Series Programmer Manual 2 121 Command descriptions Syntax Related Commands Arguments Returns Examples SLISt SEQuence EVENt PJUMp DEFine lt sequence_name gt lt pattern gt lt jump_step gt SLISt SEQuence EVENt PJUMp DEFine lt sequence_name gt lt pattern gt SLISt SEQuence EVENt PJUMp ENABle lt sequence name gt lt string gt lt pattern gt lt NRI1 gt The value range is between 0 and 255 This parameter specifies the event pattern to make an event jump The pattern bits are mapped to the integer value as follows MSB LSB Event bits 76543210 lt jump_step gt lt NRI1 gt between 1 and 16383 lt NRI gt lt jump_step gt SLIST SEQUENCE EVENT PJUMP DEFINE MySequence 15 3 sets the jump target index to the third sequence step of MySequence for the event pattern 00001111 SLIST SEQUENCE EVENT PJUMP DEFINE MySequence 84 might return 1200 indicating that at pattern event 84 the sequence will jump to step 1200 of MySequence SLISt SEQuence EVENt PJUMp ENABle 2 122 Group Syntax This command sets or returns the Event Pattern Jump enable for the specified sequence When enabled the data at the Pattern Jump In connector can
142. l commands OUTPut OFF ON E MMEMory CDIRectory F DN E In normal operation these commands could all be sent at once and they would be queued up and executed sequentially The AWG70000A Series instruments have several commands that are blocking A blocking command does not allow any further commands to be executed until it is finished performing its task such as a command that changes a hardware setting Blocking commands perform similar to sequential commands but they tend to take a longer amount of time to complete Because of the time for a blocking command to complete if a number of blocking commands are run in a sequence followed by a query the query could time out because the previous blocking commands have not finished Blocking commands are noted in their command descriptions AWG70000 Series Programmer Manual 2 9 Command syntax Overlapping commands 2 10 Overlapping commands run concurrently with other commands allowing additional commands to start before the overlapping command has finished The illustration below shows how a series of overlapping commands might start and end Overlapping Command 1 l Overlapping Command 2 E Overlapping Command 3 F In some instances you may want to make an overlapping command perform similarly to a sequential command This is simply done by placing a WAI command after the overlapping command as illustrated below Overlap
143. les A single lt NR1 gt value Range 1 2 or 4 AWG70001 Range 1 or 2 AWG70002 RST sets this to 1 A single lt NR1 gt value CLOCK ECLOCK MULTIPLIER 4 OPC sets the external clock multiplier to 4 The overlapping command is followed with an Operation Complete query CLOCK ECLOCK MULTIPLIER might return 1 0000000000 indicating the clock multiplier is set to 1 CLOCk EREFerence DIVider Conditions Group Syntax Arguments Returns 2 58 This command sets or returns the divider rate of the external reference signal when the external reference is variable Setting the external reference divider rate forces the external reference multiplier rate to a value of 1 This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Clock CLOCk EREFerence DIVider lt NR1 gt CLOCk EREFerence DIVider A single lt NR1 gt value that is a power of 2 Range 1 to 16777216 RST sets this to 1 A single lt NR1 gt value AWG70000 Series Programmer Manual Examples Command descriptions CLOCK EREFERENCE DIVIDER 1 OPC sets the external reference divider to 1 The overlapping command is followed with an Operation Complete query CLOCK EREFERENCE DIVIDER might return 1 indicating the divider rate is set to 1 CLOCk EREFerence FREQuency Condition
144. loop mode is set to COUNt See DIAGnostic CONTrol LOOP DIAGnostic CONTrol LOOP must be set to COUNt The set form of this command requires that ACTive MODE is set to DIAGnostic Diagnostic DIAGnostic CONTrol COUNt lt NR1 gt DIAGnostic CONTrol COUNt ACTive MODE DIAGnostic CONTrol LOOP A single lt NR1 gt value Range gt 0 to 1073741823 or Ox3FFFFFFF 2 30 1 A count of 0 is the same as a count of 1 RST sets this to 0 A single lt NR1 gt value DIAGNOSTIC CONTROL COUNT 1000 sets the diagnostic looping to occur for 1000 times before exiting DIAGNOSTIC CONTROL COUNT might return 1000 indicating that the diagnostic tests will loop 1000 times before halting AWG70000 Series Programmer Manual Command descriptions DIAGnostic CONTrol HALT Group Syntax Arguments Returns Examples DIAGnostic CONTro Conditions Group Syntax Related Commands This command sets or returns whether the next execution of diagnostics looping stops on the first diagnostic failure that occurs or continues to loop on the selected set of diagnostic functions Diagnostic DIAGnostic CONTrol HALT 0 1 OFF ON 0 or OFF disables the halt function allowing the AWG to continue to loop on the entire set of diagnostics even if a diagnostic failure occurs 1 or ON enables the halt function causing the execution of diagnostics looping to halt at the first diagnostic failure that occurs RST sets this
145. lter value of the Questionable Transition Register QTR Sets or returns the positive transition filter value of the Questionable Transition Register QTR AWG70000 Series Programmer Manual 2 25 Command groups Synchronization group commands The external controller uses these commands and an AWGSYNCO1 to synchronize two to four AWG70000 instruments Table 2 21 Synchronization group commands and their descriptions Command Description SYNChronize ADJust STARt Performs a system sample rate calibration SYNChronize CONFigure Configures the ports in a synchronized system SYNChronize DESKew ABORt Cancels a system deskew calibration SYNChronize DESKew STARt Performs a system deskew calibration SYNChronize DESKew STATe Returns the state of the system deskew condition SYNChronize ENABle Enables or disables synchronization in the instrument SYNChronize TY PE Returns the instrument type master or slave in the synchronized system System group commands Table 2 22 System group commands and their descriptions Command Description SYSTem DATE Sets or returns the system date SYSTem ERRor ALL Returns the error and event queue for all the unread items and removes them from the queue SYSTem ERRor CODE ALL Returns the error and event queue for the codes of all the unread items and removes them from the queue SYSTem ERRor CODE NEXT
146. mand It indicates that all pending operations have been completed When an event occurs the SESR bit corresponding to the event is set resulting in the event being stacked in the Error Event Queue The SBR OAV bit is also set If the bit corresponding to the event has also been set in the ESER the SBR ESB bit is also set When a message is sent to the Output Queue the SBR MAV bit is set Operation status block The operation status block contains conditions that are part of the instrument s normal operation It consists of the following registers Operation Condition Register OCR Operation Positive Negative Transition Register OPTR ONTR m Operation Event Register OEVR Operation Enable Register OENR These registers are made up of the same bits defined in the following table and figure Use the STATus OPERation commands to access the operation status register set 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 WFT CAL Figure 3 5 Operation status register Table 3 4 Operation status register bit definition Bit Description 15 Always zero 0 14 6 Not used 5 Waiting for trigger WFT Indicates that the instrument is waiting for a trigger event to occur AWG70000 Series Programmer Manual 3 5 Status and events Table 3 4 Operation status register bit definition cont Bit Description 4 1 Not used 0 Calibrating CAL Indicat
147. mand descriptions Syntax Related Commands Arguments Returns Examples DIAGnNoOStic TYPE NORMal POST DIAGnostic TYPE DIAGnostic SELect DIAGnostic UNSelect DIAGnostic STARt NORMa 1 Normal operating mode POST Power On Self Test RST sets this to NORM NORM POST DIAGNOSTIC TYPE NORMAL sets the AWG to normal operating mode DIAGNOSTIC TYPE might return NORM DIAGnostic TYPE CATalog Query Only Group Syntax Returns Examples This command returns a list of diagnostic types available NOTE This can be queried anytime and does not depend on ACTive MODE being set to DIAGnostic Diagnostic DIAGnostic TYPE CATalog NORM Normal operating mode POST Power On Self Test DIAGNOSTIC TYPE CATALOG might return NORM DIAGnostic UNSelect No Query Form 2 84 This command unselects one or more tests of the current test list Tests can be unselected by the keyword ALL or by subsystem or by area or by test To unselect an area subsystem is required To unselect a test requires both the subsystem and area AWG70000 Series Programmer Manual Conditions Group Syntax Related Commands Arguments Command descriptions This command requires that ACTive MODE is set to DIAGnostic Diagnostic DIAGnostic UNSelect ALL lt subsystem gt lt area gt lt test gt ACTive MODE DIAGnostic SELect m lt subsystem gt One of subsystems li
148. mmand See page 2 9 Sequential blocking and overlapping commands Group Calibration Syntax CALibration RESTore Related Commands ACTive MODE Examples CALIBRATION RESTORE sets all calibration constants to their factory settings CALibration RESult Query Only This command returns the status of the last calibration procedure This query only command can be issued while calibration is in progress Group Calibration Syntax CALibration RESult Returns lt result record gt lt result record gt lt subsystem gt lt area gt lt procedure gt lt details gt lt details gt lt Status gt lt Loop Count gt lt Pass gt lt Fail gt lt Status gt S C R U Reflexs the current or last state Currently by request when the status reflects only the subsystem or area then a U for Unknown Uncalibrated will be set for any of the procedures that are unknown even if it is only 1 out of 10 selected procedures lt Loop Count gt LC lt Pass gt P lt Fail gt F C Calibrated I Initialized selected but has not run AWG70000 Series Programmer Manual 2 49 Command descriptions Examples R Running U Unknown or Uncalibrated lt NRI gt Query a specific calibration result CAL RESu1t Channel1 Clock Amplitude might return might return Channel1 Clock Clock Amplitude S C LC 0 P 0 F 0 Query all calibration results CAL RESUIt INT C signif
149. mmer Manual Command descriptions MMEMory OPEN No Query Form This command loads a file into the AWG waveform list File formats supported WFMX Native waveform format SF TDS3000 and DPO4000 waveform format TDS TDS5000 TDS6000 TDS7000 DPO7000 DP070000 DSA70000 Series waveform WFM AWG400 AWG500 AWG600 AWG700 AWG5000 AWG7000 Series waveform PAT AWG400 AWG500 AWG600 AWG700 Series pattern file TFW AFG3000 Series waveform file format IQT RSA3000 Series waveform file format TIQ RFXpress series waveforms TIQ RSA6000 Series waveform file format WFM MDO files SEQX AWG70000 sequence format SEQ AWG400 AWG500 AWG600 sequence format NOTE If the waveform name already exists it will be overwritten without warning The file name must contain a path and drive letter Conditions AWG5000 7000 setup AWG AWG 70000 setup AWGX TXT and MAT files will not work using this command This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Group Mass Memory Syntax MMEMory OPEN lt filepath gt Related Commands MMEMory OPEN SASSet WAVeform MMEMory OPEN PARameter NORMalize Arguments lt filepath gt lt string gt Examples MMEMORY OPEN C TestFiles wFM 001 wfm OPC loads the WFM 001 waveform into the AWG waveform list The overlapping command is followed with an Operation Complete query AWG70000 Series Programmer Manual 2 105
150. mory Address Lines S P LC 1 P 1 F 0 AWG70000 Series Programmer Manual 2 77 Command descriptions DIAGnostic RESult TEMPerature Query Only This command returns the temperature from the results of the last start of a set of selected tests All temperatures will be in C Temperature for an area or subsystem have the following requirements u The temperature only reflects the selected tests The selected tests must have results of pass or fail As an example if 3 of the 4 tests in an area has been selected then only those 3 contribute to the area result If only 2 of the selected 3 have run and completed a stop event occurred then only those 2 contribute to the result The highest temperature is returned when the results for more than one test is requested as in an area The time will also be recorded for the highest temperature and may be found with the Diag Result Time query Group Diagnostic Syntax DIAGnostic RESult TEMPerature lt subsystem gt lt area gt lt test gt Related Commands DJAGnostic RESult TIME Arguments lt subsystem gt lt string gt lt area gt lt string gt lt test gt lt string gt Returns lt temperature gt lt temperature gt lt string gt lt string gt Ascii text where a number will be in C or NA Examples Asking for a specific temperature result DIAGNOSTIC RESULT TEMPERATURE Channel1 waveform Memory Calibrat
151. n generator mode Query Only This command returns the current contents and state of the mass storage media Directories will not have their size determined Directory s lt file size gt will always be 0 Mass Memory MMEMory CATalog lt msus gt MMEMory CDIRectory MMEMory MSIS AWG70000 Series Programmer Manual 2 97 Command descriptions MMEMory CDiRectory 2 98 Arguments Returns Examples Conditions Group Syntax Arguments Returns Examples lt msus gt mass storage unit specifier lt string gt lt NR1 gt lt NRI gt lt file_entry gt The first lt NR1 gt indicates the total amount of storage currently used in bytes The second lt NR1 gt indicates the free space of the mass storage in bytes lt file_entry gt lt file_name gt lt file_type gt lt file_size gt lt file_name gt the exact name of the file lt file_type gt is DIR for an entry that is a directory empty blank otherwise lt file_size gt lt NR1 gt is the size of the file in bytes For lt file_type gt marked DIR the file size will always be 0 MMEMORY CATALOG might return 484672 3878652 SAMPLE1 AWG 2948 aaa txt 1024 ddd DIR 0 zzz awg 2948 This command sets or returns the current directory of the file system on the AWG The current directory for the programmatic interface is different from the currently selected directory in the Windows Explorer on the AWG The lt msus g
152. nal controller uses the status commands to coordinate operation between the AWG and other devices on the bus The status commands set and query the registers queues of the AWG event status reporting system For more information about registers and queues see Status and Event reporting section AWG70000 Series Programmer Manual Command groups Table 2 20 Status group commands and their descriptions Command Description STATus OPERation CONDition Returns the contents of the Operation Condition Register OCR STATus OPERation ENABle Sets or returns the mask for the Operation Enable Register OENR STATus OPERation EVENt Returns the contents of Operation Event Register OEVR STATus OPERation NTRansition Sets or returns the negative transition filter value of the Operation Transition Register OTR STATus OPERation PTRansition Sets or returns the positive transition filter value of the Operation Transition Register OTR STATus PRESet Sets the OENR and QENR registers STATus QUEStionable CONDition STATus QUEStionable ENABle Returns the status of the Questionable Condition Register QCR Sets or returns the mask for Questionable Enable Register QENR STATus QUEStionable EVENt Returns the contents of the Questionable Event QEVR Register and clears it STATus QUEStionable NTRansition STATus QUEStionable PTRansition Sets or returns the negative transition fi
153. nalog output is minimally affected AWGCONTROL INTERLEAVE ADJUSTMENT AMPLITUDE might return 10 0000000000 indicating that the interleave adjustment amplitude percentage is 10 of the analog output AWGControl INTerleave ADJustment PHASe Conditions Group Syntax Arguments Returns Examples This command sets or returns the interleave adjustment phase The phase adjustment is applied to both of the channel s interleave DACs This command is valid only for single channel models Control AWGControl INTerleave ADJustment PHASe lt NRf gt AWGControl INTerleave ADJustment PHASe A single lt NRf gt value Range 180 to 180 degrees Resolution 0 1 degrees RST sets this to 0 degrees A single lt NRf gt value AWGCONTROL INTERLEAVE ADJUSTMENT PHASE 120 sets the interleave adjustment phase to 120 degrees AWGCONTROL INTERLEAVE ADJUSTMENT PHASE might return 120 0000000000 indicating that the interleave adjustment phase is 120 degrees AWG70000 Series Programmer Manual 2 37 Command descriptions AWGControl RMODe NOTE This command exists for backwards compatibility Use the command SOURce n RMODe This command sets or returns the run mode of the AWG Group Control Syntax AwWGControl RMODe CONTinuous TRIGgered AwGControl RMODe Related Commands SOURce n RMODe Arguments CONTinuous sets the Run Mode to Continuous not waiting for a trigger event TRIGger
154. nce TRACk Query Only 2 138 Group Syntax Related Commands Arguments Returns This command returns the number of tracks defined in the specified sequence Sequence SLISt SEQuence TRACK lt sequence_name gt SLISt SEQuence NEW lt sequence name gt lt string gt A single lt NR1 gt value AWG70000 Series Programmer Manual Command descriptions Examples SLIST SEQUENCE TRACK MySequence might return 4 indicating the number of tracks defined in this sequence AWG70000 Series Programmer Manual 2 139 Command descriptions SLISt SEQuence TRACk MAX Query Only This command returns the maximum number of tracks allowed in a sequence Group Sequence Syntax SLISt SEQuence TRACkK MAX Returns A single lt NR1 gt value of 8 Examples SLIST SEQUENCE TRACK MAX will return 8 indicating the maximum number of tracks allowed in a sequence SLISt SEQuence TSTamp Query Only This command returns the timestamp of the named sequence Every sequence has a timestamp that indicates when the sequence was created or last modified Group Sequence Syntax SLISt SEQuence TSTamp lt sequence_name gt Arguments lt sequence_name gt lt string gt Returns String with yyyy mm dd hh mm ss as the sequence timestamp Where yyyy refers to a four digit year number mm refers to two digit month number from 01 to 12 dd refers to two digit day number in the month bh refers to two digit hour number mm
155. nd event processing sequence Standard Event Status Register SESR Read using ESR Cannot be written Event Status Enable Register ESER Read using ESE Write using ESE Status Byte Register SBR Read using STB Cannot be written Service Request Enable Register SRER Read using SRE Write using SRE The following figure shows an outline of the sequence for status and event processing V 7 6 5 4 3 2 1 0 PON URQ CME EXE DDE QYE RQC OPC Event Event Event PON URQ CME EXE DDE QYE RQC OPC Figure 3 7 Status and event processing sequence 1 ao Pe SS Event Queue Output Queue If an event has occurred the SESR bit corresponding to that event is set and the event is placed in the event queue A bit corresponding to that event in the ESER has is set The SBR ESB bit is set to reflect the status of the ESER When a message is sent to the output queue the SBR MAV bit is set Setting either the ESB or MAV bits in the SBR sets the respective bit in the SRER When the SRER bit is set the SBR MSS bit is set and a service request is generated when using the GPIB interface AWG70000 Series Programmer Manual Status and events Synchronizing execution Almost all commands are executed in the order in which they a
156. ndicating that the test or tests will execute a single time before halting DIAGnostic DATA Query Only 2 72 Group Syntax Related Commands Returns Examples This command returns the results of last executed tests for the NORMal diagnostic type in the form of a numeric value of 0 for no errors or 330 for one or more tests failed Additional error details can be found by using the subsystem area and test queries such as DIAGnostic RESuIt lt subsystem gt lt area gt lt test gt Diagnostic DIAGnostic DATA DIAGnostic TYPE DIAGnostic RESult A single lt NR1 gt value 0 indicates no error 330 indicates that the self test failed DIAGNOSTIC DATA might return 0 which indicates that the diagnostics completed without any errors AWG70000 Series Programmer Manual Command descriptions DIAGnostic IMMediate This command executes all of the NORMal diagnostic tests The query form of this command executes all of the NORMal diagnostics and returns the results in the form of numeric of values of 0 for no errors or 330 for one or more tests failed This changes the active mode to DIAGnostic if necessary and returns back to the original active mode when done This makes a single pass of all of the NORMal diagnostics Conditions This isa blocking command See page 2 9 Sequential blocking and overlapping commands Group Diagnostic Syntax DIAGnostic IMMediate DIAGnostic IMMediate
157. ng that when channel 2 is in the Waiting for trigger state the output will be 0 volts OUTPut n WVALue MARKer 1 2 Conditions Group Syntax Related Commands Arguments Returns Examples 2 118 This command sets or returns the output condition of the specified marker of the specified channel while the instrument is in the waiting for trigger state or for a brief period after the waveform loads to the DAC and before the first point plays This is valid only when the Run Mode is in a triggered mode When synchronization is enabled and playing this command is not available Output OUTPut n WVALue MARKer 1 2 FIRSt LOW HIGH OUTPut n wVALUe MARKer 1 2 OUTPut n WVALue ANALog STATe FIRSt sets the marker output level to match the first point in the waveform of channel n when channel n is in the waiting for trigger state LOW sets the marker output to a logic level low for channel n when channel n is in the waiting for trigger state HIGH sets the marker output to a logic level high for channel n when channel n is in the waiting for trigger state n 1 2 n determines the channel number If omitted interpreted as 1 RST sets all channels to LOW FIRS LOW HIGH OUTPUT1L WVALUE MARKER1 FIRST sets the channel marker 1 output state to the first point of the waveform to play while in the waiting for trigger state AWG70000 Series Programmer Manual Command descriptions OUTPU
158. ntax Related Commands Arguments Returns Examples CLOCk SOURce 2 64 This command sets or returns the phase adjustment to synchronize multiple AWGs Setting the phase adjusts the phase of all signal outputs relative to the system clock This is a blocking command See page 2 9 Sequential blocking and overlapping commands Clock CLOCk PHASe ADJust lt NR1 gt CLOCk PHASe ADJust CLOCk SOUT STATe A single lt NR1 gt value Range 10800 to 10800 RST sets this to 0 A single lt NR1 gt value CLOCK PHASE ADJUST 100 OPC sets the clock phase to 100 degrees The overlapping command is followed with an Operation Complete query CLOCK PHASE ADJUST might return 100 indicating the clock phase is set to 100 degrees This command sets or returns the source of the clock AWG70000 Series Programmer Manual Command descriptions Conditions _ This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Group Clock Syntax CLOCk SOURCe INTernal EFIXed EVARiable EXTernal CLOCK SOURCe Arguments INTernal clock signal is generated internally and the reference frequency is derived by the internal oscillator EFIXed clock is generated internally and the reference frequency is derived from a fixed 10 MHz reference supplied at the Reference In
159. o Query Form Conditions Group Syntax Examples This command only performs a system deskew calibration This is an overlapping command See page 2 9 Sequential blocking and overlapping commands The command might take up to 30 minutes to complete When synchronization is not enabled this command is not available When synchronization is enabled and the instrument is not the master this command is not available Synchronization SYNChronize DESKew STARt SYNCHRONIZE DESKEW START OPC AWG70000 Series Programmer Manual 2 167 Command descriptions returns when the deskew calibration is complete The overlapping command is followed with an Operation Complete query SYNChronize DESKew STATe Query Only Conditions Group Syntax Returns Examples SYNChronize ENABle Conditions Group Syntax Arguments 2 168 This command returns the state of the system deskew condition The command is only valid when synchronization is enabled and the instrument is the master When synchronization is enabled and the instrument is not the master the command returns 0 Synchronization SYNChronize DESKew STATe 1 the deskew calibration is running 0 the deskew calibration is stopped cancelled complete or when synchronization is disabled SYNCHRONIZE DESKEW STATE returns 0 when the deskew calibration is cancelled or complete This command enables or disables synchronization in
160. ommand can be issued while diagnostics are still in progress Diagnostic DIAGnostic LOOPs A single lt NR1 gt value representing the number of loops completed DIAGNOSTIC LOOPS might return 5 indicating that the selected set of diagnostics has completed five times AWG70000 Series Programmer Manual 2 75 Command descriptions DIAGnostic RESult Query Only 2 76 Group Syntax Arguments Returns This command returns the status about the results of the last start of a set of selected tests An individual test result can have a status of Pass Fail or Running Status for an area or a subsystem have the following requirements The results only reflect the selected tests m The selected tests have to have results of pass or fail or be in the running state m Only selected tests in an area or subsystem contribute to the result As an example if 3 of the 4 tests in an area has been selected then only those 3 contribute to the area result If only 2 of the selected 3 have run and completed a stop event occurred then only those 2 contribute to the result If all contributors have passed then the result is passed If any contributor has failed then the result is failed If any contributor is running then the result is running Diagnostic DIAGnostic RESult ALL lt path gt ALL Keyword as a string lt path gt lt subsystem gt lt area gt lt test gt lt subsystem gt One of the str
161. ommand descriptions SYSTem DATE Group Syntax Arguments Returns Examples This command sets or returns the system date When the values are nonintegers they are rounded off to nearest integral values System SYSTem DATE lt year gt lt month gt lt day gt lt year gt lt NR1 gt Four digit number lt month gt lt NR1 gt from 1 to 12 lt day gt lt NRI1 gt from 1 to 31 lt year gt lt month gt lt day gt SYSTEM DATE 2012 11 20 sets the date to November 20 2012 SYSTem ERRor ALL Query Only Group Syntax Returns Examples 2 170 This command returns the error and event queue for all the unread items and removes them from the queue System SYSTem ERRor ALL lt ecode gt lt edesc gt lt einfo gt lt ecode gt lt edesc gt lt einfo gt Where lt ecode gt lt NR1 gt is the error event code lt edesc gt lt string gt is the description on the error event lt einfo gt lt string gt is the detail of the error event If the queue is empty the response is 0 No error SYSTEM ERROR ALL might return 113 Undefined header indicating the command was not a recognized command AWG70000 Series Programmer Manual Command descriptions SYSTem ERRor CODE ALL Query Only Group Syntax Returns Examples This command returns the error and event queue for the codes of all the unread items and removes them from the queue Sys
162. ommended for temperature change 555 Deskew Calibration recommended 556 Synchronization Adjust recommended on master 557 Sync Clock unlocked Lost frequency lock with Clock In provided by the system unable to play 558 Sync Frequency out of range Clock In frequency is higher or lower than the specified range or the value specified by the system 559 Configuration recommended on Master Configure the system on the Master or adjust if already configured to properly synchronize the system 1000 Waveform allocation failed AWG70000 Series Programmer Manual 3 15 Error messages and codes Table 3 10 Device errors cont Error code Error message 1001 Registry write failed 1002 Sequencing not enabled Option 03 Sequencing not enabled unable to complete the operation 1003 Firmware load failed 1004 Option system failed 1100 Function generator failed 1102 Function generator frequency too high 1103 Function generator frequency too low 1104 Function generator hardware failed 1200 Load failure unable to load waveform or sequence 1201 Waveform load max length error waveform length exceeds maximum samples unable to load waveform Maximum length is based on sample rate and options 1202 Waveform load min length error waveform length less than minimum samples unable to load waveform Use Modify waveform to increase the number of wavef
163. ont panel Send the TRG or TRIGger SEQuence IMMediate remote commands Use the Internal Trigger Sequence SLISt SEQuence STEP n WINPut lt Sequence_name gt ATRigger BTRigger ITRigger OFF SLISt SEQuence STEP n wWINPut lt Sequence_name gt TRIGger SEQuence IMMediate AWG70000 Series Programmer Manual 2 137 Command descriptions Arguments Returns Examples TRG n is a step in the sequence lt NR1 gt n is a value between 1 and 16383 lt sequence_name gt lt string gt ATRigger This enables the sequencer to move due to a trigger event from the A Trigger Input connector or the A Force Trigger front panel button BTRigger This enables the sequencer to move due to a trigger event from the B Trigger Input connector or the B Force Trigger front panel button ITRigger This enables the sequencer to move due to an Internal Trigger event OFF Disables the wait for trigger event allowing the waveforms s of this step to be played immediately ATR BTR ITR OFF SLIST SEQUENCE STEPL WINPUT MYSEQUENCE ATR allows the sequencer play the waveform s specified in this step after receiving a trigger event from the Trigger A Input connector or a Force A Trigger SLIST SEQUENCE STEP1 WINPUT MySequence might return BTR indicating this step will only play the waveform s specified after receiving a trigger event from the Trigger B Input connector or a Force B Trigger SLISt SEQue
164. ontrol RSTate Not all commands have both a set and a query form Some commands have only set and some have only query A command message is a command or query name followed by any information the instrument needs to execute the command or query Command messages may contain five element types defined in the following table AWG70000 Series Programmer Manual 2 1 Command syntax Commands Queries Table 2 2 Message symbols and their meanings Symbol Meaning lt Header gt 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 Never use the beginning colon with command headers beginning with a star lt Mnemonic gt This is a header subfunction Some command headers have only one mnemonic If a command header has multiple mnemonics a colon character always separates them from each other lt Argument gt This is a quantity quality restriction or limit associated with the header Some commands have no arguments while others have multiple arguments A lt space gt separates arguments from the header A lt comma gt separates arguments from each other lt Comma gt A single comma is used between arguments of multiple argument commands Optionally there may be white space characters before and after the comma lt Space gt A whit
165. orm points by adding points or repeating the waveform 1203 Waveform load granularity error length is not divisible by granularity unable to load waveform Use Modify waveform to add or subtract one point or repeat the waveform for 2 cycles 1204 Play failed no waveform assigned 1205 No asset assigned to channel 1206 Play failed resampled waveform exceeds maximum Use Modify waveform to decrease the number of waveform points 1207 Play failed resampled waveform too small Use Modify waveform to increase the number of waveform points 1208 Resampled waveform load granularity 1209 Play failed hardware failure 1210 Play failed to stop hardware failure 1211 Failed to load hardware failure 1212 Sample rate not available requested sample rate is not available sample rate set to nearest value 1213 Failed to load sequence sequence step count exceeds hardware limit 1214 Failed to load sequence sequence step has no asset assigned 1215 Failed to load sequence repeat count of Sequence step exceeds hardware limit AWG70000 Series Programmer Manual Error messages and codes Table 3 10 Device errors cont Error code Error message 1216 1217 Failed to load sequence sequence step contains invalid Goto step Failed to load sequence sequence step contains invalid Event Jump step 1218 Failed to load sequence pattern jump table contains invalid jump target 1219 Hardware error
166. orted AWG70000 Series Programmer Manual B 1 Appendix B Raw socket specification B 2 AWG70000 Series Programmer Manual Appendix C Factory initialization settings Commands affected by a factory initialization RST command are listed in the following table and are also noted in their command description Table C 1 Factory initialization settings Command Default value ACTive MODE NORMal AWGControl INTerleave ADJustment AMPLitude 0 AWGControl INTerleave ADJustment PHASe 0 AWGControl RMODe CONTinuous CALibration LOG DETails 0 off CALibration LOG FAlLuresonly 0 off CLOCk ECLock DIVider 1 CLOCk ECLock MULTiplier 1 CLOCk EREFerence DIVider 1 CLOCk EREFerence FREQuency 35 MHz CLOCk EREFerence MULTiplier 1 CLOCk JITTer 0 off CLOCk OUTPut STATe 0 off CLOCk PHASe ADJust 0 CLOCk SOURce INTernal CLOCk SOUT STATe 0 off CLOCk SRATe AWG70001A 50 GS AWG70002A 25 GS DlAGnostic CONTrol COUNt 0 DlAGnostic CONTrol HALT 0 off DlAGnostic CONTrol LOOP ONCE DlAGnostic LOG FAlLuresonly 0 off DlAGnostic TYPE NORMal DISPlay PLOT STATe 1 on FGEN CHANnel n AMPLitude 500 mV FGEN CHANnel n F REQuency 1 2 MHz FGEN CHANnell n DCLevel OV FGEN CHANnel n HIGH 250 mV FGEN CHANnel n LOW 250 mV FGEN CHANnell n OFFSet OV FGEN CHANnell n PHASe 0 FGEN CHANnel n SYMMetry 100 FGEN CHANnel n TY PE SINE AWG70000
167. ount SLISt SEQuence STEP RCOunt MAX Returns the maximum number of repeats allowed for a step in a sequence SLISt SEQuence STEP n TASSet m Returns the name of the waveform assigned to a step SLISt SEQuence STEP n TASSet SEQuence Assigns a subsequence for a specific sequence s step and track SLISt SEQuence STEP n TASSet m TYPE Returns the type of asset assigned at the step and track for a specified sequence SLISt SEQuence STEP n TASSet m WAVeform Assigns a waveform to the specified track of a step SLISt SEQuence STEP n TFLag m AFLag Sets or returns the Flag A value of the track in a sequence step SLISt SEQuence STEP n TFLag m BFLag Sets or returns the Flag B value of the track in a sequence step SLISt SEQuence STEP n TFLag m CFLag Sets or returns the Flag C value of the track in a sequence step AWG70000 Series Programmer Manual Command groups Table 2 18 Sequence group commands and their descriptions cont Command Description SLISt SEQuence STEP n TFLag m DFLag Sets or returns the Flag D value of the track in a sequence step SLISt SEQuence STEP n WINPut Sets or returns the wait input for a step SLISt SEQuence TSTamp Returns the timestamp of the named sequence SLISt SEQuence STEP MAX Returns the maximum number of steps allowed in a sequence SLISt SEQuence TRACk Returns the total number of tracks in the named
168. p Syntax Arguments Returns Examples This command sets or returns the external trigger impedance It applies only to the external trigger When synchronization is enabled and the instrument is not the master this command is not available Trigger TRIGger SEQuence IMPedance lt impedance gt lt input_trigger gt TRIGger SEQuence IMPedance lt input_trigger gt lt impedance gt lt NR1 gt the value will be 50 or 1000 lt input_trigger gt ATRigger BTRigger Defaults to trigger A if not specified RST sets this to 50 lt NRI gt TRIGGER SEQUENCE IMPEDANCE 50 selects 50 Q impedance for the external trigger A input TRIGGER SEQUENCE IMPEDANCE 50 BTRIGGER selects 50 Q impedance for the external trigger B input TRIGGER SEQUENCE IMPEDANCE BTRIGGER might return 1000 indicating impedance for external trigger B input is set to 1 KQ AWG70000 Series Programmer Manual 2 175 Command descriptions TRIGger SEQuence INTerval Conditions Group Syntax Arguments Returns Examples This command sets or returns the internal trigger interval When synchronization is enabled and the instrument is not the master this command is not available Timing TRIGger SEQuence INTerval lt NR3 gt TRIGger SEQuence INTerval A single lt NR3 gt value range is from 1 to 10 us A single lt NR3 gt value TRIGGER SEQUENCE INTERVAL 5E 6 sets the internal trigger interval to
169. p WLISt WAVeform NORMalize Normalizes a waveform that exists in the waveform list WLISt WAVeform RESample Resamples a waveform that exists in the waveform list WLISt WAVeform SHIFt Shifts the phase of a waveform that exists in the waveform list WLISt WAVeform TS Tamp Returns the timestamp of the waveform WLISt WAVeform TY PE This command returns the type of the waveform NOTE This command exists for backwards compatibility The AWG supports the Floating Point format of waveform data Floating data format is the same as the IEEE 754 single precision format It occupies 4 bytes per waveform data point It stores normalized data without any scaling When the waveform in real data format is output the data is rounded off to the nearest integer value and clipped to fit the DAC range The waveforms in the real format retains normalized values The format for the waveform analog data in the real format is IEEE754 single precision The real data format is shown in the following table Table 2 25 Real data format Byte offset 3 Byte offset 2 Byte offset 1 Byte offset 0 IEEE754 single precision format 32 bits 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 t
170. pe of the selected channel FGEN COUPIe AMPLitude Sets or returns the coupling of amplitude controls between channel 1 and channel 2 of a two channel instrument IEEE mandated and optional group commands All AWG IEEE mandated and optional command implementations are based on the SCPI standard and the specifications for devices in IEEE 488 2 Table 2 14 IEEE mandated and optional group commands and their descriptions Command Description CAL Runs all self calibrations Same as CALibration ALL CLS Clears all event registers and queues ESE Sets the Event Status Enable Register ESER ESE Returns the contents of the Event Status Enable Register ESER ESR Returns the current contents of the Event Status Register ESR 2 18 AWG70000 Series Programmer Manual Command groups Table 2 14 IEEE mandated and optional group commands and their descriptions cont Command Description IDN Returns identification information for the AWG OPC Causes the AWG to sense the internal flag referred to as the No Operation Pending flag When the pending operation has completed the Operation Complete OPC bit in the Event Status Register ESR is set OPC Causes the AWG to sense the internal flag referred to as the No Operation Pending flag When the pending operation has completed a 1 will be returned to the client SOFT Returns the implemented o
171. ping Command 1 H NAI Overlapping Command 2 ANAI Overlapping Command 3 E HAAI E You always want to ensure the overlapping command has completed This is done by using the OPC command When an overlapping command starts the operation complete status event is cleared When the overlapping command completes the operation complete status event is set The OPC command requirement is to return a 1 when the operation complete status event is set In the illustration below the OPC command blocks any further commands from being executed until the operation complete status event is set DAGSTARE p aipin I Sequential DIAG RUNNing Fcommand 5 Sequential DIAG RUNNing FSommand 9 Sequential DIAG RESults Feommand 5 1 Operation complete rope FAY Sequential DIAG RUNNing FSommand 9 NOTE Always ensure overlapping commands have completed by placing an OPC command after the overlapping command AWG70000 Series Programmer Manual Command syntax The AWG70000A Series instruments are limited to one outstanding overlapping command per OPC If two or more overlapping commands are sent and followed by an OPC then the first overlapped command to finish will set the operation complete status event and OPC will return 1 This early return may produce undesirable results The following illustration shows this behavior Overlapping Command 1 Be Overlapping Command 2 _
172. programming of instruments These guidelines provide a consistent programming environment for instrument control and data transfer This environment uses defined programming messages instrument responses and data formats that operate across all SCPI instruments regardless of manufacturer The SCPI language is based on a hierarchical or tree structure that represents a subsystem see following figure The top level of the tree is the root node it is followed by one or more lower level nodes AVGControl _ Root node CLOCK Lower level nodes JITTer FREQuency source You can create commands and queries from these subsystem hierarchy trees Commands specify actions for the instrument to perform Queries return measurement data and information about parameter settings AWG70000 Series Programmer Manual Command syntax Sequential blocking and overlapping commands Sequential commands Blocking commands Programming commands and queries fall into three command type categories m Sequential Blocking Overlapping The type of command is important to consider when programming since they could cause unexpected results if not handled correctly See the following explanations and examples Most of the programming commands for the AWG70000A Series are sequential type commands This simply means a command will not start until the previous command has finished Following is an example of a series of sequentia
173. ptions for the AWG RST Resets the AWG to its default state SRE Sets the bits in the Service Request Enable Register SRER SRE Returns the contents of the Service Request Enable Register SRER STB Returns the contents of Status Byte Register SBR TRG Generates a trigger event for Trigger A only TST Executes a power on self test and returns the results WAI Ensures the completion of the previous command before the next command is issued Instrument group commands Table 2 15 Instrument group commands and their descriptions Command Description INSTrument COUPle SOURce Sets or returns the coupled state of the channels two channel AWGs INSTrument MODE Sets or returns the AWG mode AWG70000 Series Programmer Manual 2 19 Command groups Mass memory group commands 2 20 Table 2 16 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 AWG MMEMory DATA Sets or returns block data to from file in the current mass storage device MMEMory DATA SIZE Returns the size in bytes of a selected file MMEMory DELete Deletes a file or directory from the AWG s hard disk MMEMory IMPort NOTE This command exists for backwards compat
174. r defaults to ATR if not specified RST sets all external trigger slopes to POSitive POS NEG TRIGGER SEQUENCE SLOPE NEGATIVE selects the Negative slope for Trigger A TRIGGER SEQUENCE SLOPE NEGATIVE BTRIGGER selects the Negative slope for Trigger B TRIGGER SEQUENCE SLOPE ATRIGGER might return POS for Trigger A TRIGger SEQuence SOURce 2 178 This command sets or returns the trigger source AWG70000 Series Programmer Manual Conditions Group Syntax Arguments Returns Examples Command descriptions NOTE This command exists for backwards compatibility Use the command SOURce n TINPut When synchronization is enabled and the instrument is not the master this command is not available Trigger TRIGger SEQuence SOURCe EXTernal INTernal TRIGger SEQuence SOURCe ExTernal selects external trigger as the trigger source INTernal select internal interval timing as the trigger source RST sets this to EXT EXT INT TRIGGER SEQUENCE SOURCE EXTERNAL selects the internal interval timing as the trigger source TRIGGER SEQUENCE SOURCE might return EXT indicating the trigger source is set to external trigger TRIGger SEQuence WVALue Group Syntax NOTE This command exists for backwards compatibility Use the commands OUTPut n WVALue ANALog STATe and OUTPut n WVALue MARKer 1 2 This command sets or returns the channel s outpu
175. re sent from the controller However some commands perform data analysis in another thread and another command can thus be executed concurrently These types of commands are called overlapping commands See page 2 9 Sequential blocking and overlapping commands Some examples of these types of commands include the following AWGControl RUN CLOCKk JITTer MMEMory SAVE WFMX You have two options to achieve command synchronization m Using the status and event reporting function Using synchronizing commands Using the status and event In the following example the Operation Condition Register OCR is being used reporting function to provide synchronization STATUS OPERation NTRansition 32 Set the filter of the OCR Waiting for Trigger bit STATUS OPERation ENABle 32 Enable the filter of the OCR Waiting for Trigger bit SRE 128 Set the SRER OSS bit The command waits for generation of SRQ Using synchronizing The IEEE 488 2 common commands include the following synchronizing commands commands m OPC m OPC a WAI Using the OPC command The OPC command causes the AWG to sense the internal flag referred to as the No Operation Pending flag An on going overlapped command would be an operation that is pending When the pending operation has completed the Operation Complete OPC bit in the Event Status Register ESR is set The user can poll the ESR register ESR or enable the service request pro
176. regardless of the current directory and msus MMEMory IMPort No Query Form NOTE This command exists for backwards compatibility Use the command MMEMory OPEN This command imports a file into the AWG s waveform list NOTE If the waveform name already exists it is overwritten without warning The file name must contain a path and drive letter File formats supported ISF TDS3000 and DPO4000 waveform format TDS TDS5000 TDS6000 TDS7000 DPO7000 DP070000 DSA70000 Series waveform TXT Text file with analog data TXT8 Text file with 8 bit DAC resolution TXT10 Text file with 10 bit DAC resolution TXT14 Text file with 14 bit DAC resolution WFM AWG400 AWGS500 AW G600 AWG700 Series waveform AWG70000 Series Programmer Manual 2 101 Command descriptions PAT AWG400 AWGS500 AWG600 AWG700 Series pattern file TFW AFG3000 Series waveform file format IQT RSA3000 Series waveform file format TIQ RSA6000 Series waveform file format Conditions This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Group Mass Memory Syntax MMEMory IMPort lt wfm_name gt lt fi lepath gt lt type gt Related Commands MMEMory OPEN Arguments lt wfm_name gt lt string gt lt filepath gt lt string gt lt type gt ISFJTDS TXT TXT8 TXT 10 TXT14 WFM PAT TFWIIQT TIQ Examples To import the waveform file named My Waveform MMEMORY IMPORT MywWaveform C
177. rguments Returns Examples A single lt NR3 gt value Range AWG70001A 1 49 kS s to 50 GS AWG70002A 1 49 kS s to 25 GS RST sets the frequency to 25 GHz A single lt NR3 gt value SOURCE FREQUENCY 10E6 OPC sets the clock sample rate to 10 MS s The overlapping command is followed with an Operation Complete query SOURCE FREQUENCY might return 8 0000000000 E9 indicating that the clock sample rate is set to 8 GS s This command sets or returns the coupled state of the channel s run controls of a two channel instrument The Run controls consist of the Run Mode and Trigger Input The set form of the command forces channel 2 to match channel 1 After the initial coupling of the settings changes made to either channel or channel 2 run controls affect both channels Source SOURCe RCCouple 0 1 ON OFF 0 or OFF 1 or ON RST sets this to 0 A single lt Boolean gt value SOURCE RCCOUPLE 1 sets the Run Control Coupled state to On SOURCE RCCOUPLE might return 0 indicating that the Run Control Coupled state is Off AWG70000 Series Programmer Manual Command descriptions SOURce ROSCillator MULTiplier NOTE This command exists for backwards compatibility Use the command CLOCk EREFerence MULTiplier This command sets or returns the multiplier of the external reference signal when the external reference is variable Conditions Setting the external reference multiplier rate forces
178. rigger input source for channel 1 AWG70000 Series Programmer Manual 2 155 Command descriptions SOURce n VOLTage LEVel I MMediate AMPLitude Conditions Group Syntax Arguments Returns Examples This command sets or returns the amplitude for the waveform associated with a channel This is a blocking command See page 2 9 Sequential blocking and overlapping commands Source SoURce n VOLTage LEVel IMMediate AMPLitude lt NRf gt SOURcCe n VOLTage LEVel IMMediate AMPLitude A single lt NRf gt value Range 250 mV to 500 mV n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 500 mV A single lt NRf gt value SOURCE1 VOLTAGE AMPLITUDE 0 25 sets the output amplitude of channel 1 to 250 mV SOURCE1 VOLTAGE AMPLITUDE might return 350 0000000000E 3 indicating that the amplitude output for channel 1 is set to 350 mV p SOURce n VOLTage LEVel IMMediate HIGH Conditions Group Syntax 2 156 This command sets or returns the high voltage level for the waveform associated with a channel This is a blocking command See page 2 9 Sequential blocking and overlapping commands Source SOURCe n VOLTage LEVel IMMediate HIGH lt NRf gt SOURCce n VOLTage LEVel IMMediate HIGH AWG70000 Series Programmer Manual Related Commands Arguments Returns Examples Command descriptions
179. ring select file format import operations MMEMory SAVE SETup MMEMory SAVE SEQuence MMEMory SAVE WAVeform TXT Saves the AWG s setup and optionally includes the waveforms Exports a sequence given a unique name to an eligible storage location as a SEQxX file type Exports a waveform given a unique waveform name to an eligible storage location from the AWG s waveforms as a TXT file type MMEMory SAVE WAVeform WFMX Exports a waveform given a unique waveform name to an eligible storage location from the AWG s waveforms as a WFMX file type Output group commands Table 2 17 Output group commands and their descriptions Command Description OUTPut OFF Sets or returns whether or not All Outputs Off has been enabled OUTPut n S TATe Sets or returns the output state of the channel OUTPut n SVALue ANALog STATe Sets or returns the output condition of a waveform of the specified channel while the instrument is in the stopped state OUTPut n SVALue MARKer 1 2 Sets or returns the output condition of the specified marker of the specified channel while the instrument is in the stopped state OUTPut n WVALue ANALog STATe Sets or returns the output condition of a waveform of the specified channel while the instrument is in the waiting for trigger state OUTPut n WVALue MARKer 1 2 Sets or returns the output condition of the specified marker of the specified
180. rns the function generator s waveform high voltage value of the selected channel Function generator FGEN CHANnel n HIGH lt NRf gt FGEN CHANnel n HIGH INSTrument MODE FGEN CHANnel n AMPLitude FGEN CHANnel n LOW FGEN CHANnel n OFFSet AWG70000 Series Programmer Manual Arguments Returns Examples Command descriptions A single lt NRf gt value Range 250 mV to 250 mV n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 250 mV A single lt NRf gt value FGEN CHANNEL1 HIGH 0 25 sets the function generator waveform high voltage value for channel 1 to 250 mV FGEN CHANNEL1 HIGH might return 200 0000000000E 3 indicating that the function generator waveform high voltage value for channel 1 is 200 mV FGEN CHANnel n LOW Group Syntax Related Commands Arguments Returns Examples This command sets or returns the function generator s waveform low voltage value of the selected channel Function generator FGEN CHANne 1 n LOW lt NRf gt FGEN CHANnel n LOW INSTrument MODE FGEN CHANnel n AMPLitude FGEN CHANnel n HIGH FGEN CHANnel n OFFSet A single lt NRf gt value Range 250 mV to 250 mV n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 250 mV A single lt NRf gt value FGEN CHANNEL1 LOW 0 25 sets the function generator wa
181. rough 09 and OB through 20 hexadecimal 0 through 9 and 11 through 32 decimal The instrument ignores commands consisting of any combination of white space characters and line feeds You can abbreviate many instrument commands Each command in this documentation shows the abbreviations in capitals For example enter the command TRIGger LEVel simply as TRIG LEV 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 3 Separate completely different headers by a semicolon and by the beginning colon on all commands except the first one For example the commands TRIGger IMPedance 50 and SOURCe RMODe TRIGgered can be concatenated into the following single command TRIGger IMPedance 50 RMODe TRIGgered If concatenated commands have headers that differ by only the last mnemonic you can abbreviate the second command and eliminate the beginning colon For example you can concatenate the commands TRIGger SOURCE ExTernal and TRIGger SLOPe NEGative into a single command TRIGger SOURCe EXTernal SLOPe NEGative The longer version works equally well TRIGger SOURCE EXTernal TRIGger SLOPe NEGative Never precede a star command with a semicolon or colon AWG70000 Series Programmer Manual 2 3 Command syntax Terminating Parameter types 2 4 4 When you conc
182. ructure The processes performed in these blocks are summarized in the Status Byte The three blocks contain four types of registers as shown in the following table Table 3 1 Register type Register Description Condition register Records event occurrence in the instrument Read only Transition register A positive transition filter allows an event to be reported when a positive negative condition changes from false to true A negative filter allows an event to be reported when a condition changes from true to false Setting both positive and negative filters true allows an event to be reported anytime the condition changes Clearing both filters disables event reporting Event register Records events filtered by the transition register Read only Enable register Masks the event register to report in the summary bit User definable AWG70000 Series Programmer Manual 3 1 Status and events l Questionable Condition Register QCR Output Queue Questionable status block TEMP FREQuency CO CO NI Od O1 CO NO ADJust DESKew _10 ll 12 13 H 14 Always zero 15 Questionable Transition Register QTR Questionable Event Register QEVR Questionable Enable Register QENR Operation status block CALibrating
183. s Group Syntax Arguments Returns Examples This command sets or returns the expected frequency of the signal applied to the Reference In connector This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Clock CLOCk EREFerence FREQuency lt NRf gt CLOCk EREFerence FREQuency A single lt NRf gt value Range 35 MHz to 250 MHz RST sets this to 35 MHz A single lt NRf gt value CLOCK EREFERENCE FREQUENCY 35E6 OPC sets the expected reference frequency applied to the Reference In connector to be 35 MHz The overlapping command is followed with an Operation Complete query CLOCK EREFERENCE FREQUENCY might return 200 0000000000E 6 indicating that the expected frequency of the signal applied to the Reference In connector is set to 200 MHz AWG70000 Series Programmer Manual 2 59 Command descriptions CLOCk EREFerence FREQuency DETect This command detects the frequency of the signal applied to the Reference In connector and adjusts the system to use the signal The frequency is detected once each time the command executes An error message is generated if no frequency is detected is out of range or if the adjustment fails This command is only valid when the clock source is external Errors are not returned They are added to the system error queu
184. s This command runs all selected calibrations The command returns a status code indicating the success or failure of all of the calibrations Any single calibration failure returns a failure code CAL is equivalent to the CALibration ALL command Use CALibration RESult to retrieve more detailed error information All calibrations are selected by default and cannot be modified by the user IEEE mandated and optional CAL CALibration ALL CALibration RESult A single lt NR1 gt value 0 340 CAL might return 340 on any failure 0 on all pass CALibration ABORt No Query Form Conditions Group Syntax Related Commands AWG70000 Series Programmer Manual This command stops the self calibration process and restores the previous calibration constants Setting only works in the active mode for calibration See the ACTive MODE command This command does not abort the CALibration ALL command This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Calibration CALibration ABORt ACTive MODE CALibration STARt 2 43 Command descriptions Examples CALibration ALL Conditions Group Syntax Related Commands Returns Examples CALIBRATION ABORT OPC stops the calibration process The overlapping command is followed with an Operation Complete query This command does a full calibration of the AWG In its query form the command
185. s This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Diagnostic DIAGnostic ABORt ACTive MODE DIAGnostic STARt DIAGNOSTIC ABORT OPC stops the current diagnostic test The overlapping command is followed with an Operation Complete query DIAGnostic CATalog Query Only Conditions Group Syntax Related Commands 2 68 This command returns the list of all diagnostic tests per selected type per subsystems areas or ALL All tests are grouped by areas All areas are grouped by subsystems The available subsystems areas and tests depend on the type of testing such as POST only or Full diagnostics The selected type is set with the command DIAGnostic TYPE NOTE This can be queried anytime and does not depend on ACTive MODE being set to DIAGnostic It does however depend on the DIAG TYPE which can only be changed if the ACTive MODE is set to DIAGnostic Diagnostic DIAGnostic CATalog ALL lt subsystem gt ALL lt area gt DIAGnostic TYPE AWG70000 Series Programmer Manual Command descriptions Arguments This works in the current context as set by the DIAG TYPE command E ALL Keyword or as a string E lt subsystem gt A subsystem as a string m lt area gt An area as a string If there are no parameters then the list of subsystems is returned If there is a valid subsystem parameter then the list of areas for that subs
186. s NONE FSC ZREF Examples MMEMORY IMP NORM NONE imports the waveform with no normalization MMEMORY IMP NORM might return ZREF indicating that imported data is normalized while preserving the offset AWG70000 Series Programmer Manual 2 103 Command descriptions MMEMory MDiRectory No Query Form Group Syntax Related Commands Arguments Examples MMEMory MSIS Group Syntax Arguments Returns Examples 2 104 This command creates a new directory in the current path on the mass storage system Mass Memory MMEMory MDIRectory lt directory_name gt MMEMory CDIRectory MMEMory MSIS lt directory name gt lt string gt MMEMORY MDIRECTORY Waveform makes the directory Waveform in the current directory This command selects or returns a mass storage device used by all MMEMory commands lt msus gt specifies a drive using a drive letter The drive letter can represent hard disk drives network drives external DVD CD RW drives or USB memory Mass Memory MMEMory MSIS lt msus gt MMEMory MSIS lt msus gt mass storage unit specifier lt string gt lt msus gt NOTE If the mass storage device has not been defined the returned lt msus gt value is the system s default drive which is typically the C drive MMEMORY MSIS might return X assuming the current MSUS is the X drive MMEMORY MSIS D changes the MSUS to the D drive AWG70000 Series Progra
187. s is a valid string 2 You can mix quotation marks within a string as long as you follow the previous rule For example this is an acceptable string 3 You can include a quote character within a string simply by repeating the quote wet For example here is a mark 4 Strings can have upper or lower case characters 5 A carriage return or line feed embedded in a quoted string does not terminate the string but is treated as just another character in the string 6 The maximum length of a quoted string returned from a query is 1000 characters AWG70000 Series Programmer Manual Command syntax Here are some invalid strings Invalid string argument quotes are not of the same type test lt EOI gt termination character is embedded in the string Units and SI prefix If the decimal numeric argument refers to voltage frequency impedance or time express it using SI units instead of using the scaled explicit point input value format lt NR3 gt SI prefixes are standardized for use in the International System of Units by the International Bureau of Weights and Measures For example 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 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 voltag
188. sample rate value not found The waveform did not include the recommended sample rate Failed to resample waveform 1702 1703 Resampling ratio too small Resampling ratio too large 1704 1750 Shift rotate failed Step number exceeds max exceeds max number of steps failed to add step s 1751 Invalid step invalid step specified 1752 Add step s failure failed to add step s to sequence 1753 1754 Insert step s failure failed to insert step s to sequence Remove step s failure failed to remove step s from sequence 1755 Failed to add track exceeded maximum number of tracks 1756 Failed to remove track sequence must have at least one track 1757 Invalid track number invalid track number specified 1758 Add track error failed to add track 1759 1760 Remove track error failed to remove track Sequence name in use name already used in Sequence List unable to create sequence 1761 Sequence creation failed unable to create sequence 1762 Paste error clipboard values do not match paste area data type s 1800 Invalid name invalid name or handle for asset 1801 Renaming error no name given unable to rename asset 1802 1803 Asset name in use name already used in list unable to rename asset Rename failed linked file missing 1804 File name in use unable to rename asset 1903 Calibra
189. sequence SLISt SEQuence TRACk MAX Returns the maximum number of tracks allowed in a sequence SLIStSIZE Returns the number of sequences in the sequence list Source group commands Table 2 19 Source group commands and their descriptions Command Description SOURce n CASSet Returns the waveform or sequence assigned to a channel SOURce n CASSet SEQuence Assigns a sequence to a channel SOURce n CASSet TY PE Returns the type of the asset waveform or sequence assigned to a channel SOURce n CASSet WAVeform Assigns a waveform to a channel SOURce n DAC RESolution Sets or returns the DAC resolution SOURce FREQuency CW FlXed Sets or returns the clock sample rate of the AWG NOTE This command exists for backwards compatibility Use the command CLOCK SRATe SOURce n JUMP FORCe Forces the sequencer to jump to the specified step for the specified channel SOURce n JUMP PAT Tern FORCe Generates an event forcing the sequencer to the step specified by pattern in the pattern jump table SOURce n MARKer 1 2 DELay Sets or returns the marker delay SOURce n MARKer 1 2 VOLTage Sets or returns the marker amplitude LEVell IMMediate AMPLitude SOURce n MARKer 1 2 VOLTage Sets or returns the marker high level LEVel IMMediate HIGH AWG70000 Series Programmer Manual 2 23 Command groups Table 2 19 Source group commands and their descriptions cont
190. ssssssssssses sess srssrsrrsrssrsrrsrssrsrrsrrsrsrssrst 2 18 IEEE mandated and optional group commands ccce ccc ence eee en cee nese eeneeeeanennees 2 18 Instrument group commands cece seess sesers een nee ene e ene eee ene eee EEE eta e ne ES 2 19 Mass memory group commands 0 cece cece ence een een n ene eee EEE Eee EEE Etat e EE ES 2 20 Output group COMMAMNAS 6 cece cece ee EEE EEE EEE EEE EEE EEE a nee EEE EE 2 21 Sequence group COMMANAS cece cece een ee EEE EEE EEE EEE EEE EEE ene EE EEE EE 2 22 Source group COMMAIAS cece cece cee r iia a EE EEE E EEE EEE a EEE Seen EE EEE Ea 2 23 Status Group command oi 3253 setae ecedss dencacened seta E O EIET REE EAEE EO E 2 24 Synchronization group COMMANAS 6 cce cece eee eee ene eee ee een e nde eee nee een ee EEE Ea 2 26 System Group COMMANAS so cccvnscennnewneane dan E ETE Mende demain ne deoneun emailer EEEO TENEN 2 26 Trigger group COMMAMNAS 6 cece cece eee nnn EEE ene EEE EEE EEE Eee e EEE EEE EEE ES 2 27 Waveform group COMMAIAS 6 cece eee eee enn nnn EEE Ene EEE EEE EEE Eee EEE EEE EEE ES 2 27 AWG70000 Series Programmer Manual i Table of Contents Command descriptions sued iccesssscias sages bontatdeedeg haat eanaed boatancedhesnuarenhavrnueuceeeonnsteandenes 2 31 Status and events Status and events xci2issshetacenedsieusceebiedtodenonas bvhud habrexredse cates T E O E T ld vhusebeben toons 3 1
191. state will have a temperature and date time An uncalibrated state will not have a valid temperature or date time and should be ignored Group Calibration Syntax CALibration STATe USER lt subsystem gt lt area gt Arguments lt subsystem gt lt string gt lt area gt lt string gt Returns lt State gt lt State gt S C U Reflects the current state C Calibrated U Uncalibrated D Date and time T Temperature in C Examples Asking for a specific subsystem state CALIBRATION STATE USER Channel1 might return Channel1 S C D 1 1 2013 12 01 52 AM T 112 AWG70000 Series Programmer Manual 2 53 Command descriptions Query a specific area state CALIBRATION STATE USER Channel1 Dc might return Channel1 De S C D 1 1 2013 12 00 02 AM T 32 CALibration STOP STATe Query Only This command returns the state of the calibration procedure Group Calibration Syntax CALibration STOP STATe Returns A single lt Boolean gt value 0 1 1 is stopped and 0 is not stopped Examples CALIBRATION STOP STATE might return 1 CLOCk ECLock DIVider This command sets or returns the divider rate for the external clock Conditions Setting the external clock divider rate forces the external clock multiplier rate to a value of 1 This command is only valid if the clock source is set to External See the CLOCk SOURce command This is an overlapping command See page 2 9 Sequential
192. sted by the system catalog m lt area gt One of the areas listed by the area catalog E lt test gt One of the tests listed by the test catalog ALL selects all available tests Table 2 26 DIAGnostic UNSelect arguments subsystem area test System System Interface Clock Clock Internal Communications Internal Reference Attenuator Check Channel Host Communications Local Bus Serial PCle Communications Host Bus Waveform Memory Calibration Data Lines Address Lines Cells Real Time Real Time Clock Real Time Trigger Icc Dac Connect Real Time Alignment AWG70000 Series Programmer Manual 2 85 Command descriptions Table 2 26 DIAGnostic UNSelect arguments cont subsystem area test Marker Communications Adc Offset Negative Offset Positive Offset Amplitude Crossing Point Marker2 Communications Adc Offset Negative Offset Positive Offset Amplitude Crossing Point Examples DIAGNOSTIC UNSELECT ALL unselects all available tests DIAGNOSTIC UNSELECT System unselects all the tests in System subsystem DIAGNOSTIC UNSELECT Channel1 Host Communications unselects all the tests in the Host Communications area of in the Channell subsystem DIAGNOSTIC UNSELECT Channel1 Host Communications ALL unselects all the tests in Host Communications area of the Channell subsystem DIAGNOSTIC UNSELECT Channel1 Host Communications Local Bus unselects the single test named
193. t might return WAV because Sin360 was the waveform set at the fifth step of Track 2 to the sequence named MyTest SLISt SEQuence STEP10 TASSet1 TYPE MyTest might return SEQ because Seq6 was the waveform set at the tenth step of Track 1 to the sequence named MyTest 2 132 AWG70000 Series Programmer Manual Command descriptions SLISt SEQuence STEP n TASSet m WAVeform No Query Form Group Syntax Related Commands Arguments Examples This command assigns a waveform for a specific sequence s step and track This waveform is played whenever the playing sequence reaches this step A track in a sequence is assigned to a channel with the command SOURce n CASSET SEQ Sequence SLISt SEQuence STEP n TASSet m wAVeform lt sequence_name gt lt waveform_name gt SOURce n CASSet SEQuence lt sequence_name gt lt string gt lt waveform_name gt lt string gt n is a step in the sequence lt NR1 gt n is a value between 1 and 16383 not to exceed the number of steps for sequence m m is a specific track in a sequence lt NR 1 gt m is a value between 1 and 8 not to exceed the number of tracks in the sequence SLIST SEQUENCE STEP5 TASSET2 WAVEFORM MyTest Sine360 assigns the waveform Sine360 to the step 5 of track 2 of the sequence named MyTest SLISt SEQuence STEP n TFLag m AFLag Conditions Group Syntax Arguments Th
194. t cannot be specified in the CDIR action Mass Memory MMEMory CDIRectory lt directory_name gt MMEMory CDIRectory lt directory name gt lt string gt lt directory_name gt Assuming the current lt msus gt is C MMEMORY CDIRECTORY Users changes the current directory to C Users If the current directory is C Program Files MMEMORY CDIRECTORY Program Files changes the current directory to C Program Files AWG70000 Series Programmer Manual Command descriptions MMEMORY CDIRECTORY returns Program Files if the current directory is C Program Files MMEMORY CDIRECTORY Windows changes the current directory to C Windows MMEMory DATA This command sets or returns block data to from a file in the current mass storage device NOTE The file path may contain a full file path However if the file path only contains a file name the current directory is assumed Conditions As the IEEE 488 2 is a limitation that the largest read or write that may occur ina single command is 999 999 999 bytes as the structure is defined as a followed by a byte to determine the number of bytes to read 9 9 indicates that we need to read 9 bytes to determine the length of the following data block 999 999 999 separated by commas to help separate they will not be present normally Because of the size limitation it is suggested that the user make use of the starting index and size for querying to app
195. t state when in the Waiting for trigger mode This value is applied to all channels and markers Trigger TRIGger SEQuence wWVALue FIRSt TRIGger SEQuence wWVALue AWG70000 Series Programmer Manual 2 179 Command descriptions Related Commands Arguments Returns Examples TST Query Only Group Syntax Related Commands Returns Examples 2 180 OUTPut n WVALue ANALog STATe OUTPut n WVALue MARKer 1 2 FIRSt specifies the first value of the waveform as the output level RST sets this to ZERO FIRS Output is set to the first value of the waveform ZERO Output is set to zero volts TRIGGER SEQUENCE WVALUE FIRST selects the first value of the waveform as the output level TRIGGER SEQUENCE WVALUE might return FIRS indicating that the trigger value while in the wait state is set to the first value of the waveform This command executes the Power On Self Test POST and returns the results Use DIAGnostic RESult to retrieve more detailed error information IEEE mandated and optional TST DIAGnostic MMediate DIAGnostic DATA DIAGnostic RESult A single lt NR1 gt value A returned value of 0 indicates no error TST might return 330 indicating that the self test failed AWG70000 Series Programmer Manual Command descriptions WAI No Query Form This command is used to ensure that the previous command is complete before the next command is issued
196. t to DIAGnostic Diagnostic DIAGnostic LOG CLEar ACTive MODE DIAGNOSTIC LOG CLEAR deletes the contents of the diagnostics log DIAGnostic LOG FAlLuresonly Conditions 2 74 This command sets or returns the flag that controls the amount of result information saved into the diagnostic log This controls all tests that pass or fail or only tests that fail The flag must be set before starting the diagnostic tests to obtain the expected data The set form of this command only works when ACTive MODE is set to DIAGnostic AWG70000 Series Programmer Manual Group Syntax Related Commands Arguments Returns Examples Command descriptions Diagnostic DIAGnostic LOG FAILuresonly 0 1 OFF ON DIAGnostic LOG FAILuresonly ACTive MODE DIAGnostic LOG DIAGnostic LOG CLEar 0 or OFF disables the failure only mode 1 or ON enables the failure only mode RST sets this to 0 A single lt Boolean gt value 0 or 1 DIAGNOSTIC LOG FAILURESONLY OFF disables the failure only mode DIAGNOSTIC LOG FAILURESONLY 1 enables the failure only mode DIAGNOSTIC LOG FAILURESONLY might return 1 showing the failure only mode is enabled DIAGnostic LOOPs Query Only Group Syntax Returns Examples This command returns the number of times that the selected diagnostics set was completed during the current running or the last diagnostic running of the set The current loop is reset after every start This c
197. tem SYSTem ERRor CODE ALL lt ecode gt lt ecode gt Where lt ecode gt lt NR1 gt is the error event code If the queue is empty the response is 0 SYSTEM ERROR CODE ALL might return 101 108 SYSTem ERRor CODE NEXT Query Only Group Syntax Returns Examples This command returns the error and event queue for the next item and removes it from the queue System SYSTem ERRor CODE NEXT lt ecode gt lt NR1 gt is the error and event code SYSTEM ERROR CODE NEXT might return 101 SYSTem ERRor COUNt Query Only Group Syntax This command returns the error and event queue for the number of unread items System SYSTem ERRor COUNt AWG70000 Series Programmer Manual 2 171 Command descriptions Returns lt enum gt lt NR 1 gt is the number of errors events If the queue is empty the response is 0 Examples SYSTEM ERROR COUNT might return 3 SYSTem ERRor DIALog This command enables or disables error dialogs from displaying on the UI when an error condition occurs on the AWG Group System Syntax SYSTem ERRor DIALog lt show_dialog gt SYSTem ERRor DIALog Arguments lt show_dialog gt lt Boolean gt 0 hides the error dialogs 1 displays the error dialogs RST sets this value to 1 Returns A single lt NR1 gt value Examples SYSTEM ERROR DIALOG 0 hides the error dialogs from display SYSTEM ERROR DIALOG might return 1 indicat
198. th an Operation Complete query MMEMory SAVE WAVeform WFMX No Query Form 2 112 This command exports a waveform given a unique waveform name to an eligible storage location from the AWG s waveforms as the WFMX file type NOTE Ifa file already exists in the selected file path it is overwritten without warning If the save fails the file is deleted AWG70000 Series Programmer Manual Conditions Group Syntax Arguments Examples OPC Conditions Group Syntax Related Commands Command descriptions NOTE The waveform name is renamed to the filename without extension if the waveform source is different from the selected file path This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Mass Memory MMEMory SAVE WAVeform WFMX lt wfm_name gt lt filepath gt lt wfm_name gt lt string gt lt filepath gt lt string gt must contain the complete path with drive letter and file name MMEMORY SAVE WAVEFORM WFMX myWFM C TestFi les myNewWwFMx WFMX OPC saves the waveform named myWFM to the filepath and renames the waveform to myNewWFMX The overlapping command is followed with an Operation Complete query This command causes the AWG to sense the internal flag referred to as the No Operation Pending flag The command sets bit 0 in the Standard Event Status Register when pending operations are complete
199. the external reference divider rate to a value of 1 This is an overlapping command See page 2 9 Sequential blocking and overlapping commands When synchronization is enabled and the instrument is not the master this command is not available Group Source Syntax SOURCe ROSCillator MULTiplier lt NR1 gt SOURCe ROSCillator MULTiplier Related Commands CLOCk EREFerence MULTiplier Arguments A single lt NR1 gt value Range 1 to 1000 limited by the maximum sample rate Returns A single lt NR1 gt value Examples SOURCE ROSCILLATOR MULTIPLIER 50 OPC sets the multiplier to 50 The overlapping command is followed with an Operation Complete query SOURCE ROSCILLATOR MULTIPLIER might return 100 AWG70000 Series Programmer Manual 2 143 Command descriptions SOURce n CASSet Query Only Group Syntax Arguments Returns Examples This command returns the asset waveform or sequence assigned to the specified channel Source SOURce n CASSet n 1 2 n determines the channel number If omitted interpreted as 1 If a waveform is assigned to the channel a single lt string gt value representing a waveform name If a sequence is assigned to the channel a single lt string gt value representing a sequence name and the track number separated by a comma sequence_name track_number SOURCE1 CASSET might return SEQ100 1 if track 1 of SEQ100 is assigned to channel 1
200. this to 0 A single lt NRf gt value SOURCE1 MARKER1 DELAY 20PS sets the marker delay of channel to 20 picoseconds AWG70000 Series Programmer Manual Command descriptions SOURCE1 MARKER1 DELAY might return 10 0000000000E 12 indicating a delay of 10 ps SOURce n MARKer 1 2 VOLTage LEVel IMMediate AMPLitude Conditions Group Syntax Related Commands Arguments Returns Examples This command sets or returns the marker voltage amplitude of the selected marker of the selected channel NOTE The following commands may overwrite the values set with this command SOURce n MARKer 1 2 VOLTage LEVel IMMediate HIGH SOURce n MARKer 1 2 VOLTage LEVel IMMediate LOW SOURce n MARKer 1 2 VOLTage LEVel IMMediate OF F Set This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Source SOURCce n MARKer 1 2 VOLTage LEVel IMMediate AMPLitude lt NRf gt SOURCe n MARKer 1 2 VOLTage LEVel IMMediate AMPLi tude SOURce n DAC RESolution SOURce n MARKer 1 2 WOLTage LE Vel IMMediate HIGH SOURce n MARKer 1 2 WOLTage LE Vel IMMediate LOW SOURce n MARKer 1 2 WOLTage LE Vel IMMediate OFFSet A single lt NRf gt value Range 0 5 V to 1 4 V n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 1 V A single lt NRf gt value SOURCE1 MARK
201. through 255 decimal that represents actual data lt Block gt A block of data bytes defined as lt Block gt lt NZDig gt lt Dig gt lt Dig gt lt DChar gt 0 lt DChar gt lt terminator gt AWG70000 Series Programmer Manual 2 5 Command syntax 2 6 Arbitrary block Quoted string An arbitrary block argument is defined as lt NZDig gt lt Dig gt lt Dig gt lt DChar gt or 0 lt DChar gt lt terminator gt lt NZDig gt specifies the number of lt Dig gt elements that follow Taken together the lt NZDig gt and lt Dig gt elements form a decimal integer that specifies how many lt DChar gt elements follow 0 means that the lt Block gt is an indefinite length block The lt terminator gt ends the block NOTE The AWGs do not support the indefinite format a block starts with 0 Some commands accept or return data in the form of a quoted string which is simply a group of ASCII characters enclosed by a single quote or double quote For example this is a quoted string This documentation represents these arguments as follows Table 2 6 String symbol and meaning Symbol Meaning lt QString gt Quoted string of ASCII text 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 thi
202. tions are still running Abort and try again 2000 AWGSYNC01 Communication failed 2001 AWGSYNC01 Connection failure 2002 AWG70000 Series Programmer Manual AWGSYNC01 FPGA Update failure Error messages and codes Table 3 10 Device errors cont Error code Error message 2003 AWGSYNC01 Configuration failure 2004 AWGSYNC01 Deskew Calibration failure 2005 Failed to set sample rate on Port 2 2006 Failed to set sample rate on Port 3 2007 Failed to set sample rate on Port 4 2008 AWGSYNC01 time out failure 2009 AWGSYNC01 alignment failure 2010 AWGSYNC01 Play failure 2011 AWGSYNC01 Configuration failure 2012 AWGSYNC01 Adjust failure 2013 AWGSYNC01 missing configuration failure 2014 AWGSYNC01 missing configuration failure 2015 AWGSYNC01 synchronization failure 2016 AWGSYNC01 Deskew Calibration failure 2017 AWGSYNC01 Deskew Calibration failure 3 20 AWG70000 Series Programmer Manual Appendices Appendix A Character charts B7 1 B6 1 B5 1 BITS NUMBERS B4 B3 B2 B1 CONTROL SYMBOLS UPPER CASE LOWER CASE 20 40 LAO 60 LAi6 100 TAO 120 TAI6 140 SAO 160 SA16 0000 DLE SP 0 P p 10 16 20 32 30 48 40 64 50 80 60 96 70 112 1 GTL 21 LLO 41 Lat 61 LA17 101 Tat 121 TA17 141 SA1 161 SA17 0001 SOH DC1 1 A Q a q 1 1 4 17 21 33 31 49 41 65 51 81 61 97 71 113 42 LA2 62 LA18 102 TA2 122 TA18 14
203. tive max min values are used Function generator FGEN CHANnel n PHASe lt NRf gt FGEN CHANnel n PHASe AWG70000 Series Programmer Manual Related Commands Arguments Returns Examples Command descriptions INSTrument MODE A single lt NRf gt value n 1 2 n determines the channel number If omitted interpreted as 1 Range 180 0 degrees to 180 0 degrees RST sets this to 0 A single lt NRf gt value FGEN CHANNEL1 PHASE 10 sets the phase of the function generator for channel 1 to 10 FGEN CHANNEL1 PHASE might return 0 0000 indicating the function generator phase is set to 0 for channel 1 FGEN CHANnel n SYMMetry Conditions Group Syntax Related Commands Arguments Returns This command sets or returns the function generator s triangle waveform symmetry value of the selected channel If the value is higher than the designated maximum symmetry value or lower than the designated minimum then the respective max min values are used Function generator FGEN CHANnel n SYMMetry lt NR1 gt FGEN CHANnel n SYMMetry INSTrument MODE A single lt NR1 gt value n 1 2 n determines the channel number If omitted interpreted as 1 Range 0 to 100 RST sets this to 100 A single lt NR1 gt value AWG70000 Series Programmer Manual 2 93 Command descriptions Examples FGEN CHANNEL1 SYMMETRY 10 sets the symmetry to 10 FGEN C
204. to 0 A single lt Boolean gt value 0 or 1 DIAGNOSTIC CONTROL HALT ON enables the halt function causing the execution of diagnostics looping to halt at the first diagnostic failure DIAGNOSTIC CONTROL HALT might return 0 indicating that the halt function is disabled LOOP This command sets or returns whether the next start of diagnostics runs once runs continuous loops or loops for a number times for the selected set of tests All loops may be affected by the DIAGnostic CONTrol HALT command which determines what happens if an error occurs This command requires that ACTive MODE is set to DIAGnostic Diagnostic DIAGnostic CONTrol LOOP ONCE CONTinuous COUNt DIAGnostic CONTrol LOOP ACTive MODE DIAGnostic CONTrol COUNt DIAGnostic CONTrol HALT AWG70000 Series Programmer Manual 2 71 Command descriptions Arguments Returns Examples ONCE disables the loop function causes the execution of selected test s which may be one or more of diagnostics once and then halt CONTinuous enables the loop function causing the execution of diagnostics to continuously loop COUNt enables the loop function causing the execution of diagnostics to loop for a predefined count Exit of the loop happens when the predefined loop count occurs RST sets this to ONCE ONCE CONT COUN DIAGNOSTIC CONTROL LOOP CONTinuous enables the diagnostics loop continuously DIAGNOSTIC CONTROL LOOP might return ONCE i
205. turn 10478576 indicating the maximum number of repeats of a step in a sequence SLISt SEQuence STEP n TASSet m Query Only Group Syntax Related Commands Arguments Returns 2 130 This command returns the name of the waveform or subsequence at the specified sequence s step number and track asset value Waveform or subsequence can be distinguished by the SLISt SEQuence STEP n TASSet m TYPE query Sequence SLISt SEQuence STEP n TASSet m lt sequence_name gt SLISt SEQuence STEP n TASSet m TYPE lt asset_name gt lt string gt n is a step in the sequence lt NR1 gt n is a value between 1 and 16383 not to exceed the number of steps for sequence m m is a specific track in a sequence lt NR1 gt m is a value between and 8 not to exceed the number of tracks in the sequence lt asset_name gt lt string gt An empty string is returned if no waveform has been assigned to this track and step AWG70000 Series Programmer Manual Command descriptions Examples SLISt SEQuence STEP5 TASSet2 MyTest might return Sin360 which is the waveform assigned to the fifth step of track 2 of the sequence named MyTest SLISt SEQuence STEP5 TASSet MyTest might return Seql which is a subsequence set at the fifth step of all tracks of the sequence named MyTest SLISt SEQuence STEP n TASSet SEQuence No Query Form This command assigns a subsequence for a specifi
206. uenceA and SequenceB in it and SequenceA uses SequenceB as a subsequence MMEM OPEN SASSET SEQUENCE C TestFiles AwWG_w_2seqs awgx SequenceA OPC imports SequenceA as a separate sequence SequenceB as separate sequence and all waveforms used by both sequences The overlapping command is followed with an Operation Complete query AWG70000 Series Programmer Manual 2 107 Command descriptions MMEMory OPEN SASSet WAVeform No Query Form 2 108 Conditions Group Syntax Related Commands Arguments Examples This command loads a single waveform if lt desired_waveform gt is designated Otherwise the command imports all waveforms within the designated file in lt filepath gt File formats supported AWG AWG5000 AWG7000 Series waveforms AWGX AWG70000 Series waveforms MAT MATLAB files SEQX AWG70000 Series sequence NOTE If the waveform name already exists it is overwritten without warning This is an overlapping command See page 2 9 Sequential blocking and overlapping commands Mass Memory MMEMory OPEN SASSet wAVeform lt filepath gt lt desired_waveform gt MMEMory OPEN PARameter NORMalize lt filepath gt lt string gt must contain the complete path with drive letter and file name lt desired_waveform gt lt string gt Assuming the test file AWG_x000_4CH awg has waveforms Untitled36 and Untitled37 in it MMEMORY OPEN SASSET WAVEFORM
207. un Mode to Triggered Continuous waiting for a trigger Once a trigger is received the waveform plays out continuously n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to CONT Returns CONT TRIG TCON Examples SOURCE1 RMODE TRIG sets the AWG Run mode for channel 1 to wait for a trigger SOURCE1 RMODE might return CONT indicating that the Run mode for channel 1 is set to continuous AWG70000 Series Programmer Manual 2 153 Command descriptions SOURce n SCSTep Query Only Conditions Group Syntax Arguments Returns Examples SOURce n SKEW 2 154 Group Syntax This command allows you to read the current step of the sequence while the system is running The return value is between 0 and 16383 or END A 0 indicates that the sequence is not playing or is waiting for a trigger Source SOURce n SCSTep n 1 2 n determines the channel number If omitted interpreted as 1 lt string gt END indicates the sequence has reached the end of the sequence and the outputs are defined by the Output Options for Sequence End SCST might return 4 indicating that channel 1 is currently at step 4 of the sequencer SOURCE2 SCSTEP might return 12 indicating that channel 2 is currently at step 12 of the sequencer SOURCE2 SCSTEP might return Sequence_1 2 indicating that channel 2 is currently at step 2 of the subsequence named Sequence_1
208. veform low voltage value for channel 1 to 250 mV FGEN CHANNEL1 LOW might return 200 0000000000E 3 indicating that the function generator waveform low voltage value for channel is 200 mV AWG70000 Series Programmer Manual 2 91 Command descriptions FGEN CHANnel n OFFSet Group Syntax Related Commands Arguments Returns Examples This command sets or returns the function generator s waveform offset value of the selected channel If the offset value is higher than the designated maximum offset or lower than the designated minimum offset then the respective max min values are used Function generator FGEN CHANnel n OFFSet lt NR3 gt FGEN CHANnel n OFFSet INSTrument MODE FGEN CHANnel n AMPLitude FGEN CHANnel n HIGH FGEN CHANnel n LOW A single lt NR3 gt value n 1 2 n determines the channel number If omitted interpreted as 1 RST sets this to 0 A single lt NR3 gt value FGEN CHANNEL1 0FFSET 0 1 sets the function generator offset of channel 1 to 100 mV FGEN CHANNEL1 OFFSET might return 100 0000000000E 3 indicating that the function generator offset of channel 1 is 100 mV FGEN CHANnel n PHASe Conditions Group Syntax 2 92 This command sets or returns the function generator s waveform phase value of the selected channel If the value is higher than the designated maximum phase or lower than the designated minimum then the respec
209. vel for channel is 250 mV SOURce n WAVeform This command sets or returns the name of the waveform assigned to the channel Conditions When synchronization is enabled and playing this command is not available Group Source Syntax SoURce n wAveform lt wfm_name gt SOURce n wAVeform Arguments lt wfm name gt lt string gt n 1 2 n determines the channel number If omitted interpreted as 1 Returns A single lt string gt value representing a waveform name Examples SOURCE1 WAVEFORM SINE100 assigns waveform Sine100 to channel 1 SOURCE1 WAVEFORM might return Sine100 2 158 AWG70000 Series Programmer Manual SRE Group Syntax Related Commands Arguments Returns Examples Command descriptions This command sets or queries the bits in the Service Request Enable register See page 3 1 Status and events IEEE mandated and optional SRE lt NR1 gt SRE CLS ESE ESR STB A single lt NR1 gt value A single lt NR1 gt value SRE 48 sets the bits in the SRER to the binary value 00110000 SRE might return a value of 32 showing that the bits in the SRER have the binary value 00100000 STATus OPERation CONDition Query Only Group Syntax Returns Examples This command returns the contents of the Operation Condition Register OCR Status STATUS OPERation CONDition A single lt NR1 gt value showing the contents of the OCR STAT
210. ves to the next step If the Repeat Count is Infinite the specified GOTO step is not used Sequence SLISt SEQuence STEP n GOTO lt sequence_name gt lt NR1 gt LAST FIRSt NEXT END SLISt SEQuence STEP n GOTO lt sequence_name gt SLISt SEQuence STEP n RCOunt n is a step in the sequence lt sequence name gt lt string gt lt NR 1 gt This enables the sequencer to go to the specified step where the value is between 1 and 16383 LAST This enables the sequencer to go to the last step in the sequence FIRSt This enables the sequencer to go to first step in the sequence NEXT This enables the sequencer to go to the next sequence step SLISt SEQuence STEP n EJUMp STEP setting is ignored END This enables the sequencer to go to the end and play 0 V until play is stopped lt NRI gt a single value LAST FIRS NEXT END SLISt SEQuence STEP1 GOTO MySequence 6 causes the sequencer to jump to the sixth step after executing the first step AWG70000 Series Programmer Manual Command descriptions SLISt SEQuence STEP1 GOTO MySequence might return LAST indicating that after playing this step it will proceed to the last step of the sequence SLISt SEQuence STEP n RCOunt Group Syntax Arguments Returns Examples This command sets or returns the repeat count which is the number of times the assigned waveform s play before proceeding to the next step in the sequence Sequence
211. wo digit month number from 01 to 12 dd refers to two digit day number in the month bh refers to two digit hour number mm refers to two digit minute number ss refers to two digit second number WLIST WAVEFORM TSTAMP Sine might return 2012 07 25 9 05 21 which is the date and time the Sine waveform was created or last modified AWG70000 Series Programmer Manual 2 191 Command descriptions WLISt WAVeform TYPE Query Only Group Syntax Arguments Returns Examples 2 192 This command returns the type of the waveform NOTE This command exists for backwards compatibility Waveform WLISt wAVeform TYPE lt wfm_name gt lt wfm_name gt lt string gt REAL WLIST WAVEFORM TYPE Ramp1000 returns REAL AWG70000 Series Programmer Manual Status and events Status and events The SCPI interface in the analyzer includes a status and event reporting system that enables the user to monitor crucial events that occur in the instrument The instrument is equipped with four registers and one queue that conform to IEEE Std 488 2 This section discusses these registers and queues along with status and event processing Status and event reporting system The following figure outlines the status and event reporting mechanism offered in the AWG70000A Series arbitrary waveform generators It contains three major blocks E Standard Event Status Operation Status Questionable Status fan out st
212. ying internal calibration completed and passed Query a specific area result CAL RESuUIt Channel1l Clock might return Channel1 Clock C Query a specific subsystem result CAL RESuIt Channel1 might return Channel R Query all calibration results of a specific area CAL RESuIt Channel1l Clock ALL might return Channell Clock Clock Amplitude S C LC 0 P 0 F 0 Channel 1 Clock Clock Offset S U LC 0 P 0 F 0 Asking for all calibration results of a specific subsystem CAL RESuIt Channel1 ALL might return Channel1 De U Channell Adc U Channel1 Clock U Channel Align U Channel 1 Dac U Channel1 Marker1 U Channel 1 Marker2 U CALibration RESult TEMPerature Query Only 2 50 Group Syntax Returns Examples This command returns the temperature of the last calibration All temperatures are in C Calibration CALibration RESult TEMPerature lt T gt lt NRI gt Returns the temp in C Uncalibrated returns an empty string Query a temperature result CAL RES TEMP might return INT Temp 33 AWG70000 Series Programmer Manual Command descriptions CALibration RESult TIME Query Only Group Syntax Returns Examples This command returns the time of the last calibration Calibration CALibration RESuIt TIME lt T gt mm dd yyyy hh mm A P M Query a specific time result CAL RES TIM might return
213. ystem is returned If the subsystem parameter is ALL then all the tests of all the areas of all the subsystems are returned Each test is prefixed with lt subsystem gt lt area gt and separated by a comma Lists are always in priority of the desired execution If the area parameter is ALL then all the tests of all the areas for a specified subsystem are returned Each test is prefixed with lt area gt and separated by a comma Lists are always in priority of the desired execution If the subsystem and area parameters are valid then the list of tests for that subsystem and area are returned wom Returns String of diagnostic subsystems s areas and or procedures separated by commas Examples DIAGNOSTIC CATALOG might return System Clock1 Channel1 Channel2 DIAGNOSTIC CATALOG Channel1 might return Host Communications Waveform Memory Real Time Marker1 Marker2 DIAGNOSTIC CATALOG Channel1 waveform Memory might return Calibration Data Lines Address Lines Cells DIAGNOSTIC CATALOG ALL might return Channell Waveform Memory Calibration Channell Waveform Memory Data Lines Channell Waveform Memory Address Lines Channel1l Waveform Memory Cells AWG70000 Series Programmer Manual 2 69 Command descriptions DIAGnostic CONTrol COUNt Conditions Group Syntax Related Commands Arguments Returns Examples 2 70 This command sets or returns the number of loop counts used when the

Download Pdf Manuals

Related Search

Related Contents

QUICK GUIDE - MY VOLVO LIBRARY    Guía del usuario  Ilumiline 21g2 IP_Optic WW Rev. 2 User Manual  LANKOMUR 103  November 2004 - Fletcher, Heald & Hildreth  Mémo pratique Edito  BEPE Banca Electrónica para Empresas  の理論乾燥燃焼ガス中のCO濃度における測定の不確かさ【PDF:696KB】  

Copyright © All rights reserved. Failed to retrieve file