background image

Programming Manual 

 T3AWG3K-C Series Arbitrary Waveform Generator 

True-Arb Operating Mode 

72 

 

2.18

 

Memory Group Commands 

Command 

*RCL (No Query Form)

 

Description 

This command restores the state of the instrument from a copy of 
the settings stored in the setup memory.  
The settings are stored using the *SAV command. If the specified 
setup memory is deleted, this command causes an error. 

Group 

Memory 

Syntax 

*RCL {0|1|2|3|4} 

Related Commands 

*SAV 

Arguments 

0, 1, 2, 3, or 4 
Specifies the location of setup memory 

Returns 

None 

Example 

*RCL 3 
Restores the instrument from a copy of the settings stored in memory 
location 3 

Table 85: *RCL 

Command 

*SAV (No Query Form)

 

Description 

This command stores the current AWG configuration to a specified 
setup memory location.  
The current AWG configuration is automatically saved every time 
the user changes a parameter. This configuration, here named 
"current configuration" is automatically loaded at the power on. 
 
Note: If a specified numbered setup memory is locked, this 
command causes an error. 

Group 

Memory 

Syntax 

*SAV {0|1|2|3|4} 

Related Commands 

*RCL 

Arguments 

0, 1, 2, 3, or 4 
Specifies the location of setup memory 

Returns 

None 

Example 

*SAV 2 
Saves the current instrument state in the memory location 2 

Table 86: *SAV 

 
 
 

Summary of Contents for Everywhereyoulook T3AWG3K-C Series

Page 1: ...Programming Manual Arbitrary Waveform Generator True Arb Operating Mode High Definition AWG T3AWG3K Series Rev 1 3 T3AWG 3352 3252 Simple Rider TrueArb ...

Page 2: ...vent Status Block SESB 21 2 2 5 Operation status block 22 2 2 6 Questionable status block 23 2 3 ANALOG DATA FORMAT TXT FILE ONLY 24 2 4 DIGITAL DATA FORMAT TXT FILE ONLY 24 2 5 GRANULARITY 25 2 6 TRANSFERRING DATA FILE 25 2 6 1 Block Data Format 25 2 7 BYTE ORDER DURING TRANSFER 25 2 8 HOW TO GENERATE AN ARBITRARY WAVEFORM 25 2 9 COMMAND GROUPS 27 2 9 1 Control group commands 27 2 9 2 Calibration...

Page 3: ...MMANDS 67 2 18 MEMORY GROUP COMMANDS 72 2 19 MASS MEMORY GROUP COMMANDS 76 2 20 STATUS GROUP COMMANDS 92 2 21 SYSTEM GROUP COMMANDS 97 2 22 TRIGGER GROUP COMMANDS 100 2 23 SEQUENCE GROUP COMMANDS 103 2 24 WAVEFORM GROUP COMMANDS 116 2 25 MULTI INSTRUMENT GROUP COMMANDS 123 3 COMMAND ERRORS 125 4 PREDEFINED WAVEFORMS 128 5 REMOTE CONTROL 129 5 1 PREREQUISITE 129 5 1 1 AT Instrument Communicator 134...

Page 4: ...able 14 Control group commands 28 Table 15 Calibration and Diagnostic group commands 28 Table 16 Output group commands 29 Table 17 Display group commands 30 Table 18 License group commands 30 Table 19 Marker group commands 30 Table 20 Clock group commands 31 Table 21 IEEE Mandatory group commands 32 Table 22 Status group commands 33 Table 23 System group commands 33 Table 24 Memory Group commands ...

Page 5: ... 51 Table 50 OUTPut n DELay 52 Table 51 OUTPut n POLarity 52 Table 52 OUTPut n SCALe 53 Table 53 OUTPut n STATe 54 Table 54 DIGitals LEVel m 55 Table 55 DIGital NUMber 55 Table 56 DIGitals SKEW m 56 Table 57 DIGitals STATe 56 Table 58 DISPlay FOCus 57 Table 59 DISPlay UNIT VOLT 57 Table 60 DISPlay WINDow TEXT CLEar 58 Table 61 DISPlay WINDow TEXT DATA 58 Table 62 HCOPy SDUMp IMMediate 59 Table 63 ...

Page 6: ...Table 93 DELete SETUp 76 Table 94 RECALL SETUp 76 Table 95 MMEMory CDIRectory 78 Table 96 MMEMory COPY 78 Table 97 MMEMory DATA 79 Table 98 MMEMory DATA SIZE 80 Table 99 MMEMory DELete 81 Table 100 MMEMory DOWNload DATA 81 Table 101 MMEMory DOWNload FNAMe 82 Table 102 MMEMory EXPort 83 Table 103 MMEMory IMPort 84 Table 104 MMEMory LOAD ALL 85 Table 105 MMEMory LOAD STATe 86 Table 106 MMEMory LOAD ...

Page 7: ...9 Table 131 SYSTem TIME 99 Table 132 SYSTem VERSion 100 Table 133 ABORt 100 Table 134 TRIGger SEQuence SOURce 101 Table 135 TRIGger SEQuence SLOPe 101 Table 136 TRIGger SEQuence LEVel 102 Table 137 TRIGger SEQuence TIMer 102 Table 138 TRIGger IMPedance 103 Table 139 TRIGger SEQuence IMMediate 103 Table 140 SEQuence ELEM n AMPlitude m 104 Table 141 SEQuence ELEM n OFFset m 104 Table 142 SEQuence EL...

Page 8: ... WAVeform DATA 118 Table 163 WLISt WAVeform DELete 119 Table 164 WLISt WAVeform IMPort 120 Table 165 WLISt WAVeform LMAXimum 121 Table 166 WLISt WAVeform LMINimum 121 Table 167 WLISt WAVeform LENGth 121 Table 168 WLISt WAVeform PREDefined 122 Table 169 WLISt WAVeform TYPE 122 Table 170 MIM CAPTure No Query Form 123 Table 171 MIM ID Query Only 123 Table 172 MIM CAPTured Query Only 124 Table 173 MIM ...

Page 9: ...reviations and terms Abbreviation Description SW Software UI User Interface API Application Programming Interface FG Function Generator AM Amplitude Modulation FM Frequency Modulation PM Phase Modulation PWM Pulse Width Modulation SCPI Standard Commands for Programmable Instruments AWG Arbitrary Waveform Generator SDK Software Development Kit VISA Virtual Instrument Software Architecture Table 1 A...

Page 10: ...ce ELEM GOTOMode SEQuence ELEM GOTOEntry MINimum MAXimum DEFault value SEQuence ELEM GOTOEntry MINimum MAXimum SEQuence ELEM JUMPTOMode FIRST PREVious NEXT LAST ITEM SEQuence ELEM JUMPTOMode SEQuence ELEM JUMPEvent NONE MANual TIMer EXTernal SEQuence ELEM JUMPEvent SEQuence ELEM JUMPTOEntry MINimum MAXimum DEFault value SEQuence ELEM JUMPTOEntry MINimum MAXimum SEQuence ELEM PATTERN MINimum MAXimu...

Page 11: ...eries Arbitrary Waveform Generator True Arb Operating Mode 10 Table 2 Revision History SEQuence ELEM PATTERNJUMPTOEntry MINimum MAXimum AWGControl DJStrobe MIM CAPture MIM RELease MIM ID MIM SLAve MIM FORWard MIM CAPTured MIM NUMber ...

Page 12: ...be omitted Previous elements can be repeated Comment Table 3 Syntax symbols and their meanings 2 1 2 Command and Query Structure Overview 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 b...

Page 13: ...her Comma A single comma is used between arguments of multiple argument commands Optionally there may be white space characters before and after the comma Space A white space character is used between a command header and the related argument Optionally a white space may consist of multiple white space characters Table 4 Message symbols and their meanings Commands Commands cause the instrument to ...

Page 14: ... concatenating commands and queries follow these rules 1 Separate completely different headers by a semicolon and by the beginning colon on all commands except the first one For example the commands OUTPut1 STATe ON and AWGControl RMODe TRIGgered can be concatenated into the following single command OUTPut1 STATe ON AWGControl RMODE TRIGgered 2 If concatenated commands have headers that differ by o...

Page 15: ...or 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 2 1 4 Parameter Types Parameters are indicated by angle brackets such as file_name There are several different types of parameters a...

Page 16: ...and close the string For example this 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 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 stri...

Page 17: ... is second s p p SRMS for RMS Unit is second srms V NS for SLEW s unit V ns In the case of angles use RADian and DEGree The default unit is RADian The SI prefixes which must be included are shown in the following table You can enter both uppercase and lowercase characters SI prefix 1 Corresponding power EX 1018 PE 1015 T 1012 G 109 MA 106 K 103 M 10 3 U 2 10 6 N 10 9 P 10 12 F 10 15 A 10 18 Table 8 ...

Page 18: ...s 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...

Page 19: ... to monitor crucial events that occur in the instrument 2 2 1 Status and event reporting system The following figure outlines the status and event reporting mechanism offered in the arbi trary waveform generators It contains three major blocks Standard Event Status Operation Status Questionable Status fan out structure not used in this version The processes performed in these blocks are summarized...

Page 20: ...Programming Manual T3AWG3K C Series Arbitrary Waveform Generator True Arb Operating Mode 19 ...

Page 21: ... 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 is sued a service request for one or more reasons The MSS bit is never cleared to 0 by the STB Query 5 ESB Event Status Bit ESB This bit indicates whether or not a new event has occurred after the previous Standard Even...

Page 22: ...ller 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 Table 10 Service Request Enable Register SRER 2 2 4 Standard Event Status Block SESB Reports the power on off state command errors and the running state It consists of the following registers Standard Event Status Register SESR Even...

Page 23: ...tempt was made to retrieve messages from the output queue despite the fact that the out put queue is empty or in pending status the output queue messages have been cleared despite the fact that they have not been re trieved 1 Not used 0 LSB OPC Operation Complete OPC This bit is set with the re sults of the execution of the OPC command It indi cates that all pending operations have been com pleted...

Page 24: ...d 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 2 2 6 Questionable status block The questionable status register set contains bits which give an indication of the quality of various aspects of the signal t...

Page 25: ...l waveform you have to create a single column of values unsigned integer range 0 232 1 the header is not allowed separated with new line In this way each value converted into 32 bits binary format represents the status of the corresponding digital line Bit 0 Digital Line 0 Bit 1 Digital Line 1 Bit 31 Digital Line 31 matches the binary value value 5789 integer the For example 0000000000000000000101...

Page 26: ...roller to report the progress of the operation to the user 2 6 1 Block Data Format Block data is a transmission format which is suitable for the transmission of large amounts of data A command using a block data parameter with definite length has the following struc ture Example HEADer HEADer 45168xxxxxxxx The hash symbol introduces the data block The next number indicates how many of the followin...

Page 27: ...nt see MMEMory DATA command and Block Data Format chapter for more details about this operation 3 Import the txt file in waveform list see WLISt WAVeform IMPort command which also allows you to choose an appropriate name for the new imported waveform i e Wave_name 4 Insert Wave_name waveform in the first entry of sequencer and on the desired channel see SEQuence ELEM n WAVeform m command 5 Set the...

Page 28: ...ription AWGControl AFGSwitch Turns off the TrueArb application and runs the Simple AFG application AWGControl BURST Sets or returns the Burst Count parameter AWGControl CONFigure CNUMber Returns the number of analog channels available on the instrument AWGControl CONFigure DNUMber Returns the number of digital channels available on the AWG AWGControl DECreasing Sets or returns the Sample Drecreasi...

Page 29: ... Sets or returns the Wait Trigger On parameter AWGControl JUMPMode Sets or returns the Jump Mode parametes AWGControl DJStrobe Sends the pattern strobe event Table 14 Control group commands 2 9 2 Calibration and Diagnostic Command Description CALibration ALL Performs a full calibration of the AWG The query form performs a full calibration and returns a status of the operation DIAGnostic ALL Perfor...

Page 30: ... LEVel m Sets or returns the Voltage Level of the selected Digital Probe m DIGitals NUMber Sets or returns the number of the Digital Channels DIGitals SKEW m Sets or returns the Skew parameter for the selected Digital Probe m DIGitals STATe Sets or returns the state of the dgital channels Table 16 Output group commands 2 9 4 Display Commands Display commands let you to manage features related to t...

Page 31: ...ration LICense HID Returns the instrument HostID unique identifier LICense INSTall Accepts a license and installs it on the instrument LICense LIST Returns the license codes as a comma separated list of string OPT Returns the implemented options for the AWG Table 18 License group commands 2 9 6 Marker Commands Use the following marker commands to set and query the marker output parameter Command D...

Page 32: ...rd and the specifications for devices in IEEE 488 2 Command Description CAL Runs the self calibration and returns the result Same as CALibration ALL CLS Clears all event registers and queues ESE This command sets or returns the status of Event Status Enable Register ESER See Status and events chapter IDN This command returns identification information for the AWG Refer to Std IEEE 488 2 for additi...

Page 33: ... of the TrueArb event status reporting system For more information about registers and queues see Status and Event reporting section Command Description CLS Clears all event registers and queues ESE Sets or queries the status of Event Status Enable Register ESER ESR Returns the status of Standard Event Status Register SESR SRE Sets or queries the bits in Service Request Enable Register SRER STATus...

Page 34: ...ument functions Command Description SYSTem BEEPer STATe Sets or queries the beeper state SYSTem BEEPer IMMediate Generates an audible tone SYSTem DATE Sets or returns the system date SYSTem ERRor NEXT Returns data from the error and event queue SYSTem KLOCk STATe Sets or queries the front panel lock unlock SYSTem SECurity IMMediate Resets to factory default SYSTem TIME Sets or returns the system t...

Page 35: ...onfiguration overwrite and deletion MEMory STATe NAME Copies a configuration MEMory STATe VALid Queries the availability of a configuration DELete SETUp Deletes a configuration RECALL SETUp Restores the instrument settings from a configuration name Table 24 Memory Group commands 2 9 12 MASS Memory Commands Mass memory commands let you change mass memory attributes The following table describes the...

Page 36: ... Memory MMEMory EXPort Exports a waveform from the current waveform list to an archive file zip MMEMory IMPort Imports a file into the AWG s waveform list MMEMory LOAD ALL Loads an AWG s configuration file and set it as current configuration MMEMory LOAD STATe Loads an AWG s configuration file in the configurations list MMEMory MDIRectory Creates a new directory in the current path on the Mass Mem...

Page 37: ...er input commands Command Description ABORt Reset and initialize the trigger system TRIGger SEQuence IMMediate Generates a trigger event TRIGger SEQuence SLOPe Set or query the slope of the trigger input signal TRIGger SEQuence SOURce Set or query the source of the trigger input signal TRIGger SEQuence LEVel Set or query the trigger threshold level of an input signal TRIGger SEQuence TIMer Set or ...

Page 38: ...EM n VOLTage HIGH m Sets or returns the maximum level of the waveform expressed in Volts for sequence element n of channel m SEQuence ELEM n VOLTage LOW m Sets or returns the minimum level of the waveform expressed in Volts for sequence element n of channel m SEQuence ELEM n LENGth Sets or returns the number of waveform samples for sequence element n SEQuence ELEM n LOOP COUNt Sets or returns the ...

Page 39: ...e Jump To command SEQuence ELEM n PATTERN Sets or returns the pattern code value for the Pattern Jump command for sequence element n SEQuence ELEM n PATTERNJUMPTOMode Sets or returns the Pattern Jump command type for sequence element n SEQuence ELEM n PATTERNJUMPTOEntry Sets or returns the target entry for the Pattern Jump command for the sequence element n Table 27 Sequence group commands 2 9 15 ...

Page 40: ...ist 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 PREDefined Returns true or false based on whether the waveform is predefined already present in waveform list by default WLISt WAVeform TYPE Returns the type of the waveform analog or digital...

Page 41: ...as been captured by a master MIM FORWard Returns whether there is another instrument connected to the Sync Out port MIM SLAve Returns whether there is another instrument connected to the Sync In port MIM NUMber Returns the number of captured devices MIM RELease This command release all the captured instruments Table 29 Multi Instrument group commands and their descriptions ...

Page 42: ...Switch Command AWGControl BURST Description This command and query sets or returns the Burst Count parameter Group Control Syntax AWGControl BURST MINimum MAXimum DEFault value AWGControl BURST MINimum MAXimum Related Commands Arguments Returns A single NR1 value Example AWGControl BURST DEFault It sets the Burst Count parameter to its default value AWGControl BURST 20 AWGControl BURST Might retur...

Page 43: ...able 33 AWGControl CONFigure DNUMber Command AWGControl DECreasing Description This command and query sets or returns the Sample Decreasing Strategy The Sample decreasing strategy parameter defines the strategy used to adapt the waveform length to the sequencer entry length in the case where the original waveform length is longer than the sequencer entry length Group Control Syntax AWGControl DECr...

Page 44: ...e sequencer entry length Group Control Syntax AWGControl INCreasing INTERpolation RETURNzero HOLDlast SAMPLESMultiplication AWGControl INCreasing Related Commands Arguments INTERpolation it performs a linear interpolation between the waveform samples RETURNzero it fills with 0 s the tail of the waveform HOLDlast it holds the last value of the waveform SAMPLESMultiplication it repeats the waveform ...

Page 45: ...els assigned to the entry DEFault the length of an entry of the sequencer by default will be equal to the value specified in the Sequencer Item Default Length N parameter Returns ADAPTLonger ADAPTShorter DEFault Example AWGControl LENGth MODE ADAPTLonger sets the entry length strategy to Adapt to Longer Analog Waveform AWGControl LENGth MODE Might return DEFault Table 36 AWGControl LENGth MODE Com...

Page 46: ...unt N 1 the instrument is in Single mode and the sequence will be repeated only once TCONtinuous the AWG waits for a trigger event When the trigger event occurs each waveform will loop as written in the entry repetition parameter and the entire sequence will be repeated circularly STEPped the AWG for each entry waits for a trigger event before the execution of the sequencer entry The waveform of t...

Page 47: ...stopped 1 indicates that the AWG is waiting for trigger 2 indicates that the AWG is running Example AWGCONTROL RSTATe might return 0 indicating that waveform generation is stopped Table 39 AWGControl RSTATe Command AWGControl RUN IMMediate No Query Form Description This command starts the output of a sequence This is the same to press the run button on the front panel or display Group Control Synt...

Page 48: ...e cfg_name Related Commands MMEMory SAVE SETup Arguments cfg_name string Returns Example AWGCONTROL SSAVE my_configuration Table 42 AWGControl SSAVe Command AWGControl STOP IMMediate No Query Form Description This command stops the output of a sequence Group Control Syntax AWGControl STOP IMMediate Related Commands AWGControl RUN IMMediate Arguments Returns Example AWGControl STOP IMMediate stops ...

Page 49: ...or returns the Jump Mode parameter Group Control Syntax AWGControl JUMPMode AFTERrepetitions IMMediate AWGControl JUMPMode Related Commands SEQuence ELEM n JUMPTOMode SEQuence ELEM n JUMPEvent SEQuence ELEM n JUMPTOEntry Arguments AFTERrepetitions the sequencer jumps to the selected entry after the completion of the current waveform repetitions IMMediate the sequencer jumps as soon as possible to ...

Page 50: ... returns a status indicating the success or failure of the operation This command is equivalent to the CAL command Group Control Syntax CALibration ALL CALibration ALL Related Commands CAL Arguments Returns calibration error code NR1 0 indicates no error 1 indicates an error Example CALIBRATION ALL performs a calibration CALIBRATION ALL performs a calibration and returns results For ex ample it mi...

Page 51: ...tic ALL DIAGnostic ALL Related Commands CAL Arguments Returns A single NR1 value 0 indicates no error 1 indicates that the test failed Example DIAGNOSTIC executes the self diagnostic procedure DIAGNOSTIC executes the self diagnostic procedure and might return 0 indicating that there are no errors Table 48 DIAGnostic ALL ...

Page 52: ...lue The value of n indicates the channel number Returns NRf Example OUTPut1 BLOFfset MAXimum Sets the channel 1 Base Line Offset to the maximum value OUTPut1 BLOFfset Might return 6V Table 49 OUTPut n BLOFfset Command OUTPut n DELay Description This command and query sets or returns the Skew parameter of the analog channel n Group Output Syntax OUTPut n DELay MINimum MAXimum DEFault Seconds OUTPut...

Page 53: ... 1 polarity OUTPut1 POLarity Might return INVerted that means the polarity is inverted Command OUTPut n SCALe Description This command and query sets or returns the Amplitude Scale parameter of the analog channel n This parameter can be modified at run time to adjust the waveform amplitude while the instrument is running and it is applied to all the waveforms contained in the sequencer It is expre...

Page 54: ...his command and query sets or returns the Output Impedance of the analog channel n Group Output Syntax OUTPut n SERIESIMPedance 50Ohm LOW OUTPut n SERIESIMPedance Related Commands None Arguments 50Ohm the output impedance is set to 50 Ohm LOW the output impedance is set to Low impedance 5 Ohm The value of n indicates the channel number Returns NRf Example OUTPut1 SERIESIMPedance 50Ohm Sets the out...

Page 55: ...lue of n indicates the channel number Returns OFF ON Example OUTPut1 ON Turns on the analog output signal and closes the output relay Command DIGitals LEVel m Description This command and query sets or returns the Voltage Level of the digital output probe Group Output Syntax DIGitals LEVel m MINimum MAXimum DEFault Volts DIGitals LEVel m MINimum MAXimum Related Commands None Arguments MINimum sets...

Page 56: ...ause a decrease of resolution in the analog output channels as shown in the user manual table Digital Channels section Related Commands None Arguments value NR1 The value indicates the available number of the digital channels Returns value Example DIGital NUMber 2 DIGital NUMber Might returns 2 Table 55 DIGital NUMber DIGitals LEVel2 Might return 2 5 Command DIGitals SKEW m Description This comman...

Page 57: ...xample DIGitals STATe ON Enables all the available digital channels SOURce1 DIGital STATe Might returns 1 that means ON Table 57 DIGitals STATe Syntax DIGitals SKEW m MINimum MAXimum DEFault Seconds DIGitals SKEW m MINimum MAXimum Related Commands None Arguments MINimum sets the parameter to the minimum value MAXimum sets the parameter to the maximum value DEFault sets the parameter to the default...

Page 58: ...ple DISPlay FOCus CH2 It brings the channel 2 page to the front Table 58 DISPlay FOCus Command DISPlay UNIT VOLT No Query Form Description Selects the method for specifying voltage ranges You can specify a voltage range as an amplitude and an offset or as high and low values Group Display Syntax DISPlay UNIT VOLT AMPLitudeoff HIGHlow Related Commands SEQuence ELEM n AMPlitude m SEQuence ELEM n OFF...

Page 59: ...ow TEXT DATA command displays a text message on the instrument screen The DISPlay WINDow TEXT DATA query returns the text string currently displayed on the instrument screen Description This command clears the text message from the display screen Group Display Syntax DISPlay WINDow TEXT DATA message DISPlay WINDow TEXT DATA Related Commands DISPlay WINDow TEXT CLEar Arguments message string Return...

Page 60: ...th file name and extension Valid extensions are bmp jpg jpeg gif png tiff It can be absolute or relative path if it is a relative path it will be combined with the specified path with the commands MMEMory CDIRectory and MMEMory MSIS Returns None Example HCOPY SDUMP IMMEDIATE D my_screenshot png Copies the screen shot image and creates a graphic file on the USB memory D called screenshot png Table ...

Page 61: ...iption This query only command returns a code about license options loading operation Group License Syntax LICense ERRor Related Commands Arguments None Returns A single NR1 value 0 indicates no error 1 indicates a fail condition Example LICense ERRor Might return 0 that means no errors has occurred during the options loading procedure Table 63 LICense ERRor ...

Page 62: ...cepts a license and installs it on the instrument Restarting the instrument may be necessary to fully activate the additional capabilities Group License Syntax LICense INSTall license_string Related Commands Arguments license_string string Returns None Example LICense INSTall license_string Install license file to unit Table 65 LICense INSTall Command LICense LIST Query Only Description This query...

Page 63: ...ion string option_value string Example OPT might return the following string Memory Option 128 MSample Digitals Option No Digitals Amplitude Option 6 VPP Table 67 OPT 2 15 Marker Group Commands Command MARKer LEVel m Description This command and query sets or returns the marker output Voltage Level parameter in Volts The marker voltage is calculated on 50 ohm load the minimum value is 1V 50 Ohm lo...

Page 64: ...digital MARKer MODE m Related Commands Arguments FIXEDLow the marker level is fixed to low level FIXEDHigh the marker level is fixed to high level AUTOmatic the marker has a behavior that depends on the Run Mode please check Marker Settings section on TrueArb user Manual for a more in depth explanation REPLYdigital it means that The Marker Out will behave like the Digital line 0 output This choice...

Page 65: ...e is automatically rounded to the closest value that the hardware can implement Group Marker Syntax MARKer SKEW m MINimum MAXimum DEFault Seconds MARKer SKEW m MINimum MAXimum Important Note The maximum value you can set in the marker skew depends on the Sampling rate Related Commands None Arguments MINimum sets the parameter to the minimum value MAXimum sets the parameter to the maximum value DEF...

Page 66: ... to10 MHz Table 71 ROSCillator Command AWGControl SRATe Description This command sets or returns the sample rate for the Sampling Clock Group Clock Syntax AWGControl SRATe MINimum MAXimum DEFault Hertz AWGControl SRATe MINimum MAXimum Related Commands ROSCillator ROSCillator SOURce Arguments Hertz NRf A single NRf value RST sets this to the maximum value Returns A single NR3 value Example AWGContr...

Page 67: ...Ternal EXTernal ROSCillator SOURce Related Commands ROSCillator ROSCillator SOURce Arguments INTernal means that the reference clock is set to Internal EXTernal means that the reference clock is set to External Returns INT EXT Example SOURce ROSCillator SOURce INTernal Selects the internal clock reference Table 73 ROSCillator SOURce ...

Page 68: ...guments Returns A single NR1 value 0 1 Example CAL might return 1 on any failure 0 on all pass Table 74 CAL Command CLS No Query Form Description This command sets or returns the status of Event Status Enable Register ESER See Status and events chapter Group IEEE Mandated and Optional Group Command Syntax CLS Related Commands None Arguments Returns Example CLS Clears all the event registers and qu...

Page 69: ...that the SESR contains the binary number 10110101 Table 77 ESR Command IDN Query Only Description This command returns identification information for the AWG Refer to Std IEEE 488 2 for additional information Group IEEE Mandated and Optional Group Command Syntax IDN Related Commands Arguments Returns Manufacturer Model Serial number Software version Manufacturer ACTIVE TECHNOLOGIES Model XXXXXXX i...

Page 70: ...yntax OPC OPC Related Commands WAI Arguments Returns A single NR1 value Example OPC returns 1 to indicate that the last issued overlapping command is finished Table 79 OPC Command RST No Query Form Description This command resets the AWG to its default state The AWG will be stopped Group IEEE Mandated and Optional Group Command Syntax RST Related Commands Arguments Returns Example RST resets the A...

Page 71: ...EE Mandated and Optional Group Command Syntax TRG Related Commands TRIGger IMMediate AWGControl RMODe Arguments Returns Example TRG generates a trigger event Table 82 TRG Command TST Query Only Description This command executes the Self Diagnostic procedure Group IEEE Mandated and Optional Group Command Syntax TST Related Commands DIAGnostic IMMediate DIAGnostic DATA DIAGnostic RESult Arguments Re...

Page 72: ...mming Manual T3AWG3K C Series Arbitrary Waveform Generator True Arb Operating Mode 71 Group IEEE Mandated and Optional Group Command Syntax WAI Related Commands OPC Arguments Returns None Example Table 84 WAI ...

Page 73: ...ample RCL 3 Restores the instrument from a copy of the settings stored in memory location 3 Table 85 RCL Command SAV No Query Form Description This command stores the current AWG configuration to a specified setup memory location The current AWG configuration is automatically saved every time the user changes a parameter This configuration here named current configuration is automatically loaded a...

Page 74: ...uery Only Description List the names of available configurations saved in the AWG Group Memory Syntax MEMory STATe CATalog Related Commands Arguments Returns cfg_name cfg_name cfg_name cfg_name cfg_name string Example MEMory STATe CATalog Configuration_20190110_183606_568 test Table 88 MEMory STATe CATalog Command MEMory STATe DELete No Query Form Description This command deletes the specified con...

Page 75: ...to lock the specified configuration If you lock a configuration you cannot overwrite or delete the setup file Group Memory Syntax MEMory STATe LOCK 0 1 2 3 4 cfg_name OFF ON MEMory STATe LOCK 0 1 2 3 4 cfg_name Related Commands Arguments 0 1 2 3 4 or cfg_name where cfg_name string specifies the configuration to locked or queried ON or NR1 0 Locks the specified configuration OFF or NR1 0 Allows you...

Page 76: ...ration name Returns cfg_name where cfg_name string Example MEM STAT NAME 1 TEST_RACK_1 Copy location MEM_1 in TEST_RACK_1 Table 91 MEMory STATe NAME Command MEMory STATe VALid Query Only Description This command returns the availability of a configuration Group Memory Syntax MEMory STATe VALid 0 1 2 3 4 src_cfg_name Related Commands Arguments Returns NR1 1 means that the specified configuration is...

Page 77: ...ds Command MMEMory CATalog Query only Description This command returns a list of informations concerning the contents of the current directory of the file system on the AWG In particular it returns the list of all files and directories present there specifying their names and sizes It reports also the dimension of free space of the mass storage in bytes Group Mass memory Syntax MMEMory CATalog ALL...

Page 78: ...s The current directory for the programmatic interface is different from the currently selected directory in the Windows Explorer on the AWG NOTE Only removable units and C Users awg3000 Pictures Saved_Pictures directory are accessible by MMEMory commands Group Mass memory Syntax MMEMory CDIRectory directory_name MMEMory CDIRectory Related Commands None Arguments directory_name string Returns dire...

Page 79: ...ied jpeg png bmp jpg gif tiff zip txt trc bin Group Mass memory Syntax MMEMory COPY source_file target_file Related Commands None Arguments source_file string target_file string Both of them could be absolute or relative respect current directory paths Returns None Example Assuming the current msus is C and current directory C Users awg3000 Pictures Saved Pictures MMEMORY COPY source txt D My_Wave...

Page 80: ...file_name where writing reading operations will start size NR1 is the size in bytes to write read block_data see Block Data Format chapter IEEE 488 2 data block Returns block_data IEEE 488 2 block data format Example Assuming the current msus is C and current directory C Users awg3000 Pictures Saved Pictures MMEMORY DATA 123 TXT 13ABC loads ABC into 123 TXT in the current directory MMEMory DATA da...

Page 81: ...ctures Saved Pictures MMEMORY DATA SIZE data bin might return 1024 MMEMORY DATA SIZE D tmp waveform txt might return 65535 Table 98 MMEMory DATA SIZE Command MMEMory DELete No Query Form Description This command deletes a file or directory from the AWG s accessible files system NOTE 1 Only removable units and C Users awg3000 Pictures Saved_Pictures directory are accessible by MMEMory commands NOTE...

Page 82: ...le units and C Users awg3000 Pictures Saved Pictures directory are accessible by MMEMory commands Group Mass Memory Syntax MMEMory DOWNload DATA binary_block Related Commands MMEMory DOWNload FNAMe Arguments Any IEEE 488 definite or indefinite block Returns None Example Writes the word Hello to the file D Myfile txt on internal storage MMEM DOWN FNAM D Myfile txt MMEM DOWN DATA 15Hello Table 100 M...

Page 83: ...ist NOTE 3 If the archive file name is already present in the destination directory the file will be overwritten NOTE4 Only removable units and C Users awg3000 Pictures Saved_Pictures directory are accessible by MMEMory commands The archive path may contain a full file path However if the file path only contains an archive name the archive waveform will be exported starting from the current direct...

Page 84: ...meter ANAlog DIGitals will be not taken into consideration The zip format already contains this information NOTE 3 If the waveform name wfm_name has already present in waveform list an error will be occurred NOTE 4 If waveform type ANAlog DIGitals isn t specify ANAlog type will be assumpted as default NOTE 5 Only removable units and C Users awg3000 Pictures Saved_Pictures directory are accessible ...

Page 85: ...rrent configuration This operation is performed in two steps 1 First the archive is loaded into the configurations list Note The name of the archive file is used as the name of the im ported configuration my_configuration zip my_configura tion If a configuration with the same name is already present the configuration is replaced If a configuration with the same name is already present and is locat...

Page 86: ... directory Table 104 MMEMory LOAD ALL Command MMEMory LOAD STATe No Query Form Description This command imports a configuration saved in an archive zip into the configurations list with the specified name NOTE 1 If a configuration with the same name is already present in configuration list then it will be replaced NOTE 2 If a configuration with the same name is already present in configuration lis...

Page 87: ...le Assuming the current msus is C and current directory C Users awg3000 Pictures Saved Pictures MMEMORY LOAD STATE SETUP1 zip 1 loads the configuration file SETUP1 zip located in the current directory in MEM_1 Table 105 MMEMory LOAD STATe Command MMEMory MDIRectory No Query Form Description This command creates a new directory in the current path on the mass storage system NOTE Only removable unit...

Page 88: ...y Syntax MMEMory MOVE file1 file2 Related Commands None Arguments file1 file2 they could be absolute or relative paths Returns None Example MMEM MOVE MySetup zip D Backup zip MMEM MOVE D arbMonday txt D arbTuesday bin Table 107 MMEMory LOAD STATe Command MMEMory MSIS Description This command selects or returns a mass storage device used by all MMEMory commands msus specifies a drive using a drive ...

Page 89: ...t be taken into account The zip format already has this information in itself NOTE 2 The waveform name will be derived directly from the ar chive name NOTE 3 If the waveform name is already present in the waveform list then an error will occur NOTE 4 If the waveform type ANAlog DIGitals is not specified the ANAlog type will be assumed as default NOTE 5 Only removable units and C Users awg3000 Pic ...

Page 90: ...nfiguration present in an ar chive zip and applay it in place of the current configuration NOTE 1 It s an alias of MMEMory LOAD ALL command See its de scription for more informations NOTE 2 The AWG must be in idle state Group Mass memory Syntax MMEMory OPEN SETup filepath Related Commands None Arguments filepath string zip could be an absolute or relative path Returns None Example MMEMORY OPEN SET...

Page 91: ... current AWG s configuration in an archive zip NOTE 1 If an archive with the same name and path is already pre sent then the archive is overwritten NOTE 2 Only removable units and C Users awg3000 Pic tures Saved Pictures directory are accessible by MMEMory com mands The archive path may contain a full path However if only name is specified the archive will be saved starting from the cur rent direc...

Page 92: ...000 Pictures Saved Pictures mySetip zip file Table 113 MMEMory SAVE SETup Command MMEMory STORe STATe No Query Form Description This command saves a configuration present in the configurations list in an archive zip NOTE 1 If an archive with the same path and name is already pre sent then it will be overwritten NOTE 2 Only removable units and C Users awg3000 Pic tures Saved Pictures directory are ...

Page 93: ...n This command returns the contents of a file NOTE 1 Only removable units and C Users awg3000 Pictures Saved_Pictures directory are accessible by MMEMory commands NOTE 2 Only files with the following extension can be deleted on removable units jpeg png bmp jpg gif tiff zip txt trc bin Group Mass memory Syntax MMEMory UPLoad file_name Related Commands MMEMory CDIRectory MMEMory MSIS Arguments file_...

Page 94: ...mands STATus OPERation CONDition STATus OPERation EVENt Arguments A single NR1 enable_value value Range 0 to 65535 Returns A single NR1 value Example 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 Table 117 STATus OPERation ENABle Com...

Page 95: ...Dition Related Commands STATus QUEStionable ENABle STATus QUEStionable EVENt Arguments Returns A single NR1 value Example STATus QUEStionable CONDition Might return 0 Table 120 STATus QUEStionable CONDition Command STATus QUEStionable ENABle Description This command sets or returns the enable mask of the Questionable Enable Register QENR which allows true conditions in the Questionable Event Regis...

Page 96: ...porting system section for additional information Group Status Syntax STATus QUEStionable EVENt Related Commands STATus QUEStionable CONDition STATus QUEStionable ENABle Arguments Returns A single NR1 value showing the contents of the QEVR Example STATus QUEStionable EVENt might return 64 showing that the bits in the QEVR have the binary value 00000000 00100000 which means that the FREQuency bit i...

Page 97: ...re preserved in nonvolatile memory when power is shut off and are restored at power on Group Status Syntax PSC 0 1 PSC Related Commands Arguments NR1 0 Sets the power on status clear flag to false disables the power on clear and allows the instrument to possibly assert SRQ after power on NR1 0 Sets the power on status clear flag true sending PSC 1 therefore enables the power on status clear and pr...

Page 98: ... warning caused by remote command execution Group System Syntax SYSTem BEEPer STATe OFF ON SYSTem BEEPer STATe Related Commands Arguments ON or NR1 0 Enables the beeper OFF or NR1 0 Disables the beeper Returns A single NR1 value Example SYSTem BEEPer STATe ON Enables the beeper function Table 125 SYSTem BEEPer STATe Command SYSTem BEEPer IMMediate Description This command causes the instrument to ...

Page 99: ... Only Description This command returns data from the error and event queues Group System Syntax SYSTem ERRor NEXT Related Commands Arguments Error number error description Error number NR1 error description string Returns year month day Example SYSTem ERRor NEXT might return 0 No error indicating there are not errors Table 128 SYSTem ERRor NEXT Command SYSTem KLOCk STATe Description This command l...

Page 100: ...ate Initializes the instrument Table 130 SYSTem SECurity IMMediate No Query Form Command SYSTem TIME Description This command sets or returns the system time hours minutes and seconds Group System Syntax SYSTem TIME hh mm ss SYSTem TIME Related Commands Arguments hour minute second hour NR1 specifies the hours Range 0 to 23 minute NR1 specifies the minutes Range 0 to 59 second NR1 specifies the se...

Page 101: ...n This command stops waveform playout when the Run Mode is set to Gated This is equivalent to release the Force Trigger button on the front panel when the instrument is in gated mode Group Trigger Syntax ABORt Related Commands AWGControl RMODe TRG Example ABORt It will stop the waveform playout on all channels with their Run Mode set to Gated Table 133 ABORt Command TRIGger SEQuence SOURce Descrip...

Page 102: ...s slope POSitive NEGative BOTH POSitive specifies a trigger event on the rising edge of the external trigger signal NEGative specifies a trigger event on the falling edge of the external trigger signal BOTH specifies that a trigger event occurs both on falling and rising edge of the external trigger signal Returns slope Example TRIGger SLOPe POS It sets the trigger slope to rising edge TRIGger SLO...

Page 103: ...Syntax TRIGger SEQuence TIMer MINimum MAXimum DEFault Seconds TRIGger SEQuence TIMer MINimum MAXimum Related Commands TRIGger SEQuence SOURce Arguments seconds NRf units where units μs ms s and it specifies the interval value expressed in units MINimum sets or queries the minimum interval value MAXimum sets or queries the maximum interval value DEFault sets the default interval value 1 s Returns S...

Page 104: ...TRG Arguments None Returns None Example TRIGger SEQuence IMMediate It generates a trigger event Table 139 TRIGger SEQuence IMMediate 2 23 Sequence Group Commands Command SEQuence ELEM n AMPlitude m Description Sets or returns the voltage peak to peak amplitude for the element n of the channel m Group Sequence Syntax SEQuence ELEM n AMPlitude m MINimum MAXimum DEFault Volts SEQuence ELEM n AMPlitud...

Page 105: ...imum Related Commands SEQuence ELEM n AMPlitude m Arguments The value of n indicates the sequence element number The value of m is the channel number Volts NRf sets the offset level expressed in Volt MINimum sets or queries the minimum offset level MAXimum sets or queries the maximum offset level DEFault sets the default offset level 0V Returns Volts NRf Example SEQuence ELEM5 OFFset2 1 2 Sets the...

Page 106: ... HIGH m Command SEQuence ELEM n VOLTage LOW m Description This command sets or returns the low voltage level of the waveform for the element n of the channel m Group Sequence Syntax SEQuence ELEM n VOLTage LOW m MINimum MAXimum DEFault Volts SEQuence ELEM n VOLTage LOW m MINimum MAXimum Related Commands SEQuence ELEM n VOLTage HIGH m Arguments The value of n indicates the sequence element number T...

Page 107: ... SEQuence ELEM3 LENGth 100 Sets the sequencer length of the element n to 100 for all channels SEQuence ELEM2 LENGth Might returns 1000 Table 144 SEQuence LENgth Command SEQuence ELEM n LOOP COUNt Description This command sets or returns the number of repetitions of the waveform for the element n Group Sequence Syntax SEQuence ELEM n LOOP COUNt MINimum MAXimum DEFault INFinite value SEQuence ELEM n...

Page 108: ...e list others customized waveforms Group Sequence Syntax SEQuence ELEM n WAVeform m wfm_name SEQuence ELEM n WAVeform m Related Commands None Arguments The value of n indicates the element index The value of m is the channel number wfm_name String is the waveform s name Returns wfm_name String Example SEQUENCE ELEM1 WAVEFORM1 TRIANGLE1000 Sets the TRIANGLE1000 waveform into the first element of th...

Page 109: ...No Query Form Description This command creates a new sequence with only one element with default value Group Sequence Syntax SEQuence NEW Related Commands None Arguments None Returns None Example SEQuence NEW It creates a new sequence with only one element Table 148 SEQuence NEW Command SEQuence FOCus No Query Form Description This command visualizes a specific element of the sequencer on the disp...

Page 110: ...rnal the wait event comes from the external BNC connector Returns wait_event NONE MANual TIMer EXTernal Example SEQuence ELEM1 WAITEvent TIMER It sets the wait event for first element of the sequence to timer SEQuence ELEM1 WAITEvent Might return TIMer Table 150 SEQuence ELEM n WAITEvent Command SEQuence ELEM n GOTOMode Description This command sets or returns the GOTO command type for the selecte...

Page 111: ...SEQuence ELEM4 GOTOMode Might return FIRST Table 151 SEQuence ELEM n GOTOMode Command SEQuence ELEM n GOTOEntry Description This command sets or returns the target entry for the GOTO com mand for the selected element n of the sequencer After generating the waveform s specified in a sequence element the sequencer jumps to the entry specified as the GOTO target This is an unconditional jump Group Se...

Page 112: ...M n JUMPTOEntry SEQuence ELEM n JUMPEvent AWGControl JUMPMode Arguments mode FIRST PREVious NEXT LAST ITEM FIRST the sequencer will jump to the first element of the sequence PREVious the sequencer will jump to the previous element of the sequence If the selected element is the first it will jump to the last NEXT the sequencer will jump to the next element of the sequence If the selected element is...

Page 113: ...al timer EXTernal the jump event comes from the external BNC connector Returns jump_event NONE MANual TIMer EXTernal Example SEQuence ELEM1 JUMPEvent MANual It sets the jump event for first element of the sequence to manual SEQuence ELEM1 JUMPEvent Might returns MANual Table 154 SEQuence ELEM n JUMPEvent Command SEQuence ELEM n JUMPTOEntry Description This command sets or returns the target entry ...

Page 114: ...de ITEM SEQuence ELEM4 JUMPTOEntry 6 Sets the jump target entry index to the 6th element SEQuence ELEM4 JUMPTOEntry Might return 6 Table 155 SEQuence ELEM n JUMPTOEntry Command SEQuence ELEM n PATTERN Description This command sets or returns the pattern code value for the Pat tern Jump command for the selected element n of the se quencer Note The Pattern Jump is a conditional jump that occurs when...

Page 115: ... sets or returns the Pattern Jump command type for the selected element n of the sequencer The Pattern Jump command is a conditional jump Group Sequence Syntax SEQuence ELEM n PATTERNJUMPTOMode FIRST PREVious NEXT LAST ITEM SEQuence ELEM n PATTERNJUMPTOMode Related Commands SEQuence ELEM n PATTERN SEQuence ELEM n PATTERNJUMPTOEntry AWGControl DJStrobe Arguments mode FIRST PREVious NEXT LAST ITEM F...

Page 116: ...tern Jump is a conditional jump that occurs when a Pat tern code is received by the sequencer As soon as the sequencer receives this pattern event it will jump to the entry selected in this command Note this will take effect only when SEQuence ELEM n PATTERNJUMPTO Mode is set to ITEM Group Sequence Syntax SEQuence ELEM n JUMPTOEntry MINimum MAXimum DEFault value SEQuence ELEM n JUMPTOEntry MINimum...

Page 117: ...Entry 2 24 Waveform Group Commands Command WLISt LIST Query Only Description Returns the name of the all waveforms in the waveform list Group Waveform Syntax WLISt LIST Related Commands None Arguments None Returns waveform_name waveform_name waveform_name string Example WLISt LIST Might returns Sine Ramp Square Sync DC Gaussian Lorentz Haversine Exp_Rise Exp_Decay Zero One Counter Clock Waveform_I...

Page 118: ...his returns the number of predefined waveforms Example WLIST SIZE Might return 14 Table 161 WLISt SIZE Command WLISt WAVeform DATA Query Only Description This command returns all sample of an analog or digital waveform or a portion of them specifying StartIndex and Size parameters In this way it possible transfer a waveform from the waveform list to the external control program The returned bytes r...

Page 119: ... a time Very large waveforms can be transferred in chunks Transferring large waveforms in chunks allows external programs to cancel the operation before it is completed Group Waveform Syntax WLISt WAVeform DATA wfm_name StartIndex Size Related Commands None Arguments wfm_name string is the waveform s name in waveform list StartIndex NR1 specifies the start byte Size NR1 specifies the number of byt...

Page 120: ...mands WLISt SIZE WLISt NAME Arguments wfm_name string Returns None Example WLISt WAVeform DELete ALL Deletes all user created waveforms from the waveform list The ALL parameter does not delete predefined waveforms WLIST WAVeform DELETE Test1 Deletes a waveform called Test1 Table 163 WLISt WAVeform DELete Command WLISt WAVeform IMPort Description This command imports the waveform from internal drive...

Page 121: ...ave List Import Group Waveform Syntax WLISt WAVeform IMPort wfm_name file_name ANAlog DIGitals Related Commands WLISt SIZE WLISt NAME WLISt WAVeform DELete Arguments wfm_name string file_name string zip trc txt indicates the absolute or relative path of the waveform file to import ANAlog the waveform is imported as analog waveform DIGitals the waveform is imported as digitals waveform Returns None...

Page 122: ...of waveform sample points required for a valid waveform Group Waveform Syntax WLISt WAVeform LMINimum Related Commands WLISt WAVeform LMAXimum Arguments None Returns NR1 Example WLISt WAVeform LMINimum Returns 16 Table 166 WLISt WAVeform LMINimum Command WLISt WAVeform LENGth Query Only Description This query returns the size of the waveform The returned value represents data points not bytes Grou...

Page 123: ...eform Syntax WLISt WAVeform PREDefined wfm_name Related Commands None Arguments wfm_name string Returns 0 1 where 0 means FALSE and 1 means TRUE Example WLISt WAVeform PREDefined Sine might return 1 indicating that it is a predefined waveform Table 168 WLISt WAVeform PREDefined Command WLISt WAVeform TYPE Query Only Description This query returns if the waveform is analog or digital Group Waveform Syn...

Page 124: ...ONE Returns Example MIM CAPTure This command sent on a master instrument capture the connected slave instruments Table 170 MIM CAPTure No Query Form Command MIM CAPTured Query Only Description This query return whether an instrument is captured by a master Group Multi Instrument Syntax MIM CAPTured Related Commands NONE Arguments NONE Command MIM ID Query Only Description This query command allows...

Page 125: ...ght return 1 1 indicates that another instrument is present and ready to be cap tured Table 173 MIM FORWard Query Only Command MIM SLAve Query Only Description This query returns wherther an instrument is slave or master If it returns 1 it indicates that there is another instrument connected to the Sync In port but it doesn t mean that the slave is captured Group Multi Instrument Syntax MIM SLAve ...

Page 126: ...ription This command sent on the master of a chain releases all captured instruments Group Multi Instrument Syntax MIM RELease Related Commands MIM CAPTure Arguments NONE Returns Example MIM RELease This command sent on a master instrument release the captured slave instruments Table 176 MIM RELease No Query Form 3 COMMAND ERRORS Command errors are returned when there is a syntax error in the comm...

Page 127: ... between channels in one sequencer subsequencer entry 378 Unable to set the Attenuation Value if the Attenuation value is greater than 20dB the Vocm value must be in the following range 250mV 377 Predefined Waveform Error it is not possible to delete or create a predefined waveform 376 Waveform Granularity Error 375 Digital port disabled error the digital port is disabled 374 The start operation i...

Page 128: ... present error 348 Wrong path error 347 Predefined waveform 346 Wrong block data 345 Sequencer memory overflow 344 No license installed 343 Wrong waveform name 0 No error 5 DESIGN ERROR Too many numeric suffices in Command Spec 10 No Input Command to parse 14 Numeric suffix is invalid value 16 Invalid value in numeric or channel list e g out of range 17 Invalid number of dimensions in a channel li...

Page 129: ...UARE Square waveform 16384 samples analog normalized SYNC Sync waveform 16384 samples analog normalized DC DC level waveform 16384 samples analog normalized GAUSSIAN Gaussian waveform 16384 samples analog normalized LORENTZ Lorentz waveform 16384 samples analog normalized HAVERSINE Haversine waveform 16384 samples analog normalized EXP_RISE Exponential rise waveform 16384 samples analog normalized...

Page 130: ...e commands You can follow the next steps to communicate with your AWG 3000 Series instrument 5 1 Prerequisite NI VISA VISA provides the programming interface between the hardware and development environments such as Visual Studio NET LabVIEW LabWindows CVI Measurement Studio for Microsoft Visual Studio and MatLab NI VISA is the National Instruments implementation of the VISA I O standard NI VISA i...

Page 131: ...ng Manual T3AWG3K C Series Arbitrary Waveform Generator True Arb Operating Mode 130 3 Launch the NI MAX tool on the Client PC Press Add Network Device VISA TCP IP Resource 4 Select Auto detect of LAN Instrument ...

Page 132: ...K C Series Arbitrary Waveform Generator True Arb Operating Mode 131 5 The panel will retrieve the discovered instruments on the LAN network you should se lect the AWG3000X series one 6 Specify an Alias for the selected resource ...

Page 133: ...Programming Manual T3AWG3K C Series Arbitrary Waveform Generator True Arb Operating Mode 132 7 Press Finish 8 The T3AWG resource will be available in the Network Devices list ...

Page 134: ...ator True Arb Operating Mode 133 9 Now you can use send the SCPI commands to the T3AWG resource using the NI Visa Test Panel or the AT Instrument Communicator 10 On the Client PC IP Address or AWG instrument LocalHost launch the AT Instru ment Communicator tool ...

Page 135: ...a copy of NIVISA to make use of this client side component please follow the Prerequisite steps 1 On the Client PC launch the AT Instrument Communicator setup you can find in the folder SDK_TRUEARB_AWG_3000 and install the software 2 Select the AWG3000X resource on the Device list 3 Press the Connect button 4 If the instrument connection will be established the SCPI command button will be en abled...

Page 136: ... like this ACTIVE TECHNOLOGIES AWG3352 T0302I000001 SCPI 99 0 SV 1 0 34 0 where T0302I000001 is the serial number SCPI 99 0 is the SCPI command version and SV 1 0 34 0 is the Software Version 8 A command script is a list of SCPI commands one command for each line saved in a txt file you can send a command script using the File Load Script menu item ...

Page 137: ..._TRUEARB_T3AWG3K_Teledyne Test Tools folder in LabVIEW 2013 instr lib folder on your computer and open the file Active Technologies AWG3000 lvproj The LabView project contains several Vis that control the basic instrument features and four examples located in the folder Examples 5 2 1 Continuous Mode Double click on the project tree to launch the Active Technologies AWG3000 Continuous Mode vi exam...

Page 138: ...veforms in Continuous mode the sequencer by default is made of three entries and it is loaded as follows Entry 1 Length 16384 Rep 1 Entry 2 Length 16384 Rep 2 Entry 3 Length 16384 Rep 3 CH1 Sine Amp 2V Offset 0V Ramp Amp 3V Offset 0V Lorentz Amp 4V Offset 0V CH2 Ramp Amp 1V Offset 0 5V Sync Amp 3V Offset 0V Lorentz Amp 4V Offset 0V ...

Page 139: ...u to change on the fly the Amplitude Scale the Base Line Offset the Skew the Polarity and the Output Impedace parameters Select the Channel and press the Apply Changes button to confirm the changes You can press the CH OFF ON button to enable or disable the analog channel The entire sequence will be repeated continuously until you press again the START AWG button 5 2 2 Burst Mode Double click on t...

Page 140: ...n the Burst Parameters section you can change the number of burst Burst Count and the Wait Trigger On parameter If you load Digital Waveforms in the sequencer in the Digital Parameters section you can select the number of Digital channels the Digital Pod the Skew and the Digital Voltage Level Run the VI to initialize the instrument and load the default parameters into the instrument the Send Trigg...

Page 141: ...fter pressing the RUN STOP button each entry waits for a trigger event before its execution The waveform of the entry will loop as written in the entry repetition parameter The sequencer by default is loaded as follows Entry 1 Length 16384 Rep 1 Entry 2 Length 16384 Rep 2 Entry 3 Length 16384 Rep 3 CH1 Sine Amp 2V Offset 0V Sync Amp 3V Offset 0V Lorentz Amp 4V Offset 0V ...

Page 142: ...the instrument will receive the trigger from the front panel button 2 Press the START AWG button to run the AWG 3 Press the SEND TRIGGER button to send a software trigger In the Trigger IN Settings you can configure the Trigger In Source the Threshold the Trigger IN impedance the Timer Interval the Trigger Slope and the Wait Trigger On Parameter Stop the instrument and then press the APPLY CHANGES...

Page 143: ...To Entry Item 1 Entry 3 Length 16384 Wait Event None Rep 1 Infinite Repetitions On Jump Event Button Jump To Mode Previous Jump to Entry Item 1 Go To Mode Next Go To Entry Item 1 Pattern Mode Next Pattern Code 123 Pattern Jump To Entry Item 1 CH1 Sine Amp 2V Offset 0V Ramp Amp 2V Offset 0V Sinc Amp 2V Offset 0V CH2 Sine Amp 2V Offset 0V Ramp Amp 2V Offset 0V Sinc Amp 2V Offset 0V Before running th...

Page 144: ...END PATTERN button to change the execution order of the waveform sequence In the Trigger General Settings you can configure the Trigger In Source the Threshold the Trigger IN impedance the Timer Interval the Trigger Slope the Wait Trigger On Parameter and the Jump Mode parameter Stop the instrument and then press the APPLY CHANGES button to confirm changes on the TRIGGER GENERAL settings 5 2 5 Imp...

Page 145: ...ing section you have different parameters to set the digital waveform in the Digital Pattern type dropdown list you can select between a counter a random number a fixed value or an arbitrary pattern When you select arbitrary pattern you can set in the Arbitrary Pattern table the samples of the waveform the row is the sample number and the column is the digital line The Digital Channels and the Num...

Page 146: ...rol write SINE_120MHZ 3 Set Analog in the Specify the Waveform Type dropdown list 4 In the Analog Waveform Setting section set Sine Wave as signal type 120 MHz in the Arb Frequency 1 GHz as Fs sampling rate and 12000 as number of samples 5 Press the Import button 6 In the Set Waveform Name control write RAND_12000 7 Set Digitals in the Specify the Waveform Type dropdown list 8 In the Digital Wavef...

Page 147: ...V Offset 0V Ramp Amp 2V Offset 0V Square Amp 2V Offset 0V CH2 Sine Amp 2V Offset 0V Ramp Amp 2V Offset 0V Square Amp 2V Offset 0V DIG WAV 12 Replace the third entry with the imported ones Entry 1 Length 16384 Rep 1 Entry 2 Length 16384 Rep 1 Entry 3 Length 12000 Rep 1 CH1 Sine Amp 2V Offset 0V Ramp Amp 2V Offset 0V SINE_120MHZ Amp 2V Offset 0V CH2 Sine Amp 2V Offset 0V Ramp Amp 2V Offset 0V SINE_1...

Page 148: ...AMPlitude2 1 000000 SEQuence ELEM1 OFFset2 0 500000 SEQuence ELEM1 LENGth 16384 SEQuence ELEM1 LOOP COUNt 1 SEQuence ELEM2 WAVeform1 RAMP SEQuence ELEM2 AMPlitude1 3 000000 SEQuence ELEM2 OFFset1 0 000000 SEQuence ELEM2 WAVeform2 SYNC SEQuence ELEM2 AMPlitude2 3 000000 SEQuence ELEM2 OFFset2 0 000000 SEQuence ELEM2 LENGth 16384 SEQuence ELEM2 LOOP COUNt 2 SEQuence ELEM3 WAVeform1 LORENTZ SEQuence ...

Page 149: ...eform2 EXP_RISE SEQuence ELEM1 AMPlitude2 2 000000 SEQuence ELEM1 OFFset2 0 000000 SEQuence ELEM1 WAVeform3 COUNTER SEQuence ELEM1 LENGth 16384 SEQuence ELEM1 LOOP COUNt 1 SEQuence ELEM2 WAVeform1 SYNC SEQuence ELEM2 AMPlitude1 3 000000 SEQuence ELEM2 OFFset1 0 000000 SEQuence ELEM2 WAVeform2 SYNC SEQuence ELEM2 AMPlitude2 3 000000 SEQuence ELEM2 OFFset2 0 000000 SEQuence ELEM2 WAVeform3 COUNTER S...

Page 150: ...nstrument in Continuous mode CLS IDN RST AWGControl CONFigure CNUMber AWGControl RMODe CONTinuous DISPlay UNIT VOLT AMPLitudeoff DIGitals NUMber 8 DIGitals LEVel1 3 000000 DIGitals SKEW1 0 000000 DIGitals STATe ON WLISt WAVeform IMPort Sine_10000 Example_Wave_TXT 10000_Sample_Analog_Sine_Wave txt ANAlog WLISt WAVeform IMPort Digital_10000 Example_Wave_TXT 10000_Sample_Digital_Random_Pattern txt DI...

Page 151: ...litude2 2 000000 SEQuence ELEM1 OFFset2 0 000000 SEQuence ELEM1 LENGth 16384 SEQuence ELEM1 LOOP COUNt 100 SEQuence ELEM1 WAITEvent MANual SEQuence ELEM1 JUMPEvent NONE SEQuence ELEM1 JUMPTOMode NEXT SEQuence ELEM1 JUMPTOEntry 1 SEQuence ELEM1 GOTOMode NEXT SEQuence ELEM1 GOTOEntry 1 SEQuence ELEM1 PATTERNJUMPTOMode NEXT SEQuence ELEM1 PATTERN 1 SEQuence ELEM1 PATTERNJUMPTOEntry 1 DISPlay UNIT VOL...

Page 152: ...t1 0 000000 SEQuence ELEM3 WAVeform2 SINC SEQuence ELEM3 AMPlitude2 2 000000 SEQuence ELEM3 OFFset2 0 000000 SEQuence ELEM3 LENGth 16384 SEQuence ELEM3 LOOP COUNt INFinite SEQuence ELEM3 WAITEvent MANual SEQuence ELEM3 JUMPEvent NONE SEQuence ELEM3 JUMPTOMode PREVious SEQuence ELEM3 JUMPTOEntry 1 SEQuence ELEM3 GOTOMode NEXT SEQuence ELEM3 GOTOEntry 1 SEQuence ELEM3 PATTERNJUMPTOMode NEXT SEQuence...

Reviews: