Teledyne Everywhereyoulook T3AWG3K-C Series Owner's manual

Programming Manual
Arbitrary Waveform Generator
True-Arb Operating Mode
High Definition AWG
T3AWG3K Series
Rev. 1.3
T3AWG-3352/3252
Simple Rider TrueArb

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
1
TABLE OF CONTENTS
1. PREFACE..................................................................................................................... 8
1.1 ABBREVIATIONS AND TERMS ............................................................................................ 8
1.2 REVISION HISTORY ......................................................................................................... 8
2. SYNTAX AND COMMANDS .......................................................................................... 11
2.1 COMMAND SYNTAX .................................................................................................... 11
2.1.1 Syntax Overview .................................................................................................. 11
2.1.2 Command and Query Structure ....................................................................... 11
2.1.3 Command Entry................................................................................................... 13
2.1.4 Parameter Types .................................................................................................. 14
2.1.5 SCPI Commands and Queries ........................................................................... 17
2.2 STATUS AND EVENTS ..................................................................................................... 18
2.2.1 Status and event reporting system ................................................................... 18
2.2.2 Status Byte Register (SBR).................................................................................... 20
2.2.3 Service Request Enable Register (SRER) ........................................................... 21
2.2.4 Standard Event 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 and Diagnostic................................................................................ 28
2.9.3 Output Group Commands................................................................................. 28
2.9.4 Display Commands ............................................................................................. 29
2.9.5 License Commands............................................................................................. 30
2.9.6 Marker Commands.............................................................................................. 30
2.9.7 Clock Group Commands ................................................................................... 31
2.9.8 IEEE Mandated and Optional Group Command........................................... 31
2.9.9 Status Group Command .................................................................................... 32
2.9.10 System Group Commands ................................................................................. 33
2.9.11 Memory Group Commands............................................................................... 33
2.9.12 MASS Memory Commands ................................................................................ 34

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
2
2.9.13 Trigger Group Commands.................................................................................. 36
2.9.14 Sequence Group Commands........................................................................... 36
2.9.15 Waveform Group Commands........................................................................... 38
2.9.16 Multi Instrument Commands .............................................................................. 39
2.10 CONTROL GROUP COMMANDS ................................................................................... 41
2.11 CALIBRATION AND DIAGNOSTIC COMMANDS ............................................................... 49
2.12 OUTPUT GROUP COMMANDS ...................................................................................... 51
2.13 DISPLAY GROUP COMMANDS ...................................................................................... 57
2.14 LICENSE GROUP COMMANDS ...................................................................................... 60
2.15 MARKER GROUP COMMANDS ..................................................................................... 62
2.16 CLOCK GROUP COMMANDS....................................................................................... 65
2.17 IEEE MANDATED AND OPTIONAL GROUP COMMANDS.................................................. 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
5.2 NI LABVIEW EXAMPLES .............................................................................................. 136
5.2.1 Continuous Mode .............................................................................................. 136
5.2.2 Burst Mode .......................................................................................................... 138
5.2.3 Stepped Mode................................................................................................... 139
5.2.4 Advanced Mode............................................................................................... 141
5.2.5 Import an Arbitrary Waveform Generation ................................................... 143
5.3 SCRIPT EXAMPLES ...................................................................................................... 147
5.3.1 Continuous Mode .............................................................................................. 147
5.3.2 Stepped Mode................................................................................................... 148
5.3.3 Import Arbitrary .................................................................................................. 149
5.3.4 Advanced Mode............................................................................................... 150

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
3
LIST OF TABLES
Table 1: Abbreviations and terms......................................................................................................... 8
Table 2: Revision History........................................................................................................................ 10
Table 3: Syntax symbols and their meanings .................................................................................... 11
Table 4: Message symbols and their meanings................................................................................ 12
Table 5: Message terminator and meaning ..................................................................................... 14
Table 6: Parameter types, their descriptions, and examples ......................................................... 15
Table 7: String symbol and meaning.................................................................................................. 15
Table 8: SI prefixes and their indexes.................................................................................................. 16
Table 9: Status Byte Register (SBR) ...................................................................................................... 20
Table 10: Service Request Enable Register (SRER) ........................................................................... 21
Table 11: Standard Event Status Register (SESR) .............................................................................. 22
Table 12: Operation Condition Register (OCR)............................................................................... 23
Table 13: Models and available parameters ................................................................................... 27
Table 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 ............................................................................................... 34
Table 25: Mass Memory Group commands...................................................................................... 36
Table 26: Trigger group commands ................................................................................................... 36
Table 27: Sequence group commands............................................................................................. 38
Table 28: Waveform group commands ............................................................................................ 39
Table 29: Multi-Instrument group commands and their descriptions ........................................... 40
Table 30: AWGControl:AFGSwitch ..................................................................................................... 41
Table 31: AWGControl:BURST .............................................................................................................. 41
Table 32: AWGControl:CONFigure:CNUMber? ................................................................................ 42
Table 33: AWGControl:CONFigure:DNUMber? ................................................................................ 42
Table 34: AWGControl:DECreasing.................................................................................................... 43
Table 35: AWGControl:INCreasing ..................................................................................................... 43
Table 36: AWGControl:LENGth:MODE ............................................................................................... 44

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
4
Table 37: AWGControl:RESET[:IMMediate] ........................................................................................ 45
Table 38: AWGControl:RMODe........................................................................................................... 46
Table 39: AWGControl:RSTATe? .......................................................................................................... 46
Table 40: AWGControl:RUN[:IMMediate] .......................................................................................... 46
Table 41: AWGControl:SREStore.......................................................................................................... 47
Table 42: AWGControl:SSAVe ............................................................................................................. 47
Table 43: AWGControl:STOP[:IMMediate]......................................................................................... 47
Table 44: AWGControl:WAITstate ....................................................................................................... 48
Table 45: AWGControl:JUMPMode .................................................................................................... 48
Table 46: AWGControl:DJStrobe......................................................................................................... 49
Table 47: CALibration[:ALL].................................................................................................................. 49
Table 48: DIAGnostic[:ALL]................................................................................................................... 50
Table 49: OUTPut[n]:BLOFfset............................................................................................................... 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: LICense:ERRor? ..................................................................................................................... 60
Table 64: LICense:HID? ......................................................................................................................... 61
Table 65: LICense: INSTall ..................................................................................................................... 61
Table 66: LICense:LIST? ......................................................................................................................... 62
Table 67: *OPT?...................................................................................................................................... 62
Table 68: MARKer:LEVel[m].................................................................................................................. 63
Table 69: MARKer:MODE[m]................................................................................................................ 64
Table 70: MARKer:SKEW[m].................................................................................................................. 64
Table 71: ROSCillator............................................................................................................................. 65
Table 72: AWGControl:SRATe.............................................................................................................. 65
Table 73: ROSCillator:SOURce ............................................................................................................. 66
Table 74: *CAL? ..................................................................................................................................... 67
Table 75: *CLS ........................................................................................................................................ 67

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
5
Table 76: *ESE ......................................................................................................................................... 68
Table 77: *ESR?....................................................................................................................................... 68
Table 78: *IDN? ...................................................................................................................................... 68
Table 79: *OPC ...................................................................................................................................... 69
Table 80: *RST ......................................................................................................................................... 69
Table 81: *SRE......................................................................................................................................... 70
Table 82: *TRG........................................................................................................................................ 70
Table 83: *TST?........................................................................................................................................ 70
Table 84: *WAI........................................................................................................................................ 71
Table 85: *RCL........................................................................................................................................ 72
Table 86: *SAV........................................................................................................................................ 72
Table 87: MEMory:NSTates? ................................................................................................................. 73
Table 88: MEMory:STATe:CATalog? .................................................................................................... 73
Table 89: MEMory:STATe:DELete ......................................................................................................... 74
Table 90: MEMory:STATe:LOCK............................................................................................................ 74
Table 91: MEMory:STATe:NAME ........................................................................................................... 75
Table 92: MEMory:STATe:VALid? ......................................................................................................... 75
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:STATe ...................................................................................................... 86
Table 107: MMEMory:LOAD:STATe ...................................................................................................... 87
Table 108:MMEMory:MSIS..................................................................................................................... 88
Table 109: MMEMory:OPEN ................................................................................................................. 89
Table 110: MMEMory:OPEN:SETup ...................................................................................................... 89
Table 111:MMEMory:RDIRectory ......................................................................................................... 90
Table 112: MMEMory:STORe:ALL ......................................................................................................... 90
Table 113: MMEMory:SAVE:SETup ....................................................................................................... 91
Table 114: MMEMory:STORe:STATe ..................................................................................................... 92

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
6
Table 115: MMEMory:UPLoad?............................................................................................................ 92
Table 116: STATus:OPERation:CONDition?......................................................................................... 93
Table 117: STATus:OPERation:ENABle ................................................................................................. 93
Table 118: STATus:OPERation[:EVENt]?............................................................................................... 93
Table 119: STATus:PRESet ...................................................................................................................... 94
Table 120: STATus:QUEStionable:CONDition? ................................................................................... 94
Table 121: STATus:QUEStionable:ENABle............................................................................................ 95
Table 122: STATus:QUEStionable[:EVENt] ........................................................................................... 95
Table 123: *STB? ..................................................................................................................................... 95
Table 124: *PSC...................................................................................................................................... 96
Table 125: SYSTem:BEEPer:STATe ......................................................................................................... 97
Table 126: SYSTem:BEEPer[:IMMediate] ............................................................................................. 97
Table 127: SYSTem:DATE ....................................................................................................................... 98
Table 128: SYSTem:ERRor[:NEXT]?........................................................................................................ 98
Table 129: SYSTem:KLOCk[:STATe] ...................................................................................................... 99
Table 130: SYSTem:SECurity:IMMediate (No Query Form)............................................................... 99
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:ELEM[n]:VOLTage:HIGH[m]......................................................................... 105
Table 143: SEQuence:ELEM[n]:VOLTage:LOW[m].......................................................................... 105
Table 144: SEQuence:LENgth ............................................................................................................ 106
Table 145: SEQuence:ELEM[n]:LOOP:COUNt.................................................................................. 107
Table 146: SEQuence:ELEM[n]:WAVeform[m] ................................................................................ 107
Table 147: SEQuence:LENGth ........................................................................................................... 108
Table 148: SEQuence:NEW ................................................................................................................ 108
Table 149: SEQuence:FOCus............................................................................................................. 109
Table 150:SEQuence:ELEM[n]:WAITEvent ........................................................................................ 109
Table 151:SEQuence:ELEM[n]:GOTOMode..................................................................................... 110
Table 152: SEQuence:ELEM[n]:GOTOEntry...................................................................................... 111
Table 153: SEQuence:ELEM[n]:JUMPTOMode ................................................................................ 111

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
7
Table 154: SEQuence:ELEM[n]:JUMPEvent...................................................................................... 112
Table 155: SEQuence:ELEM[n]:JUMPTOEntry .................................................................................. 113
Table 156: SEQuence:ELEM[n]:PATTERN........................................................................................... 114
Table 157: SEQuence:ELEM[n]:PATTERNJUMPTOMode ................................................................. 115
Table 158: SEQuence:ELEM[n]:PATTERNJUMPTOEntry ................................................................... 116
Table 159: WLISt:LIST? .......................................................................................................................... 116
Table 160: WLISt:NAME? ..................................................................................................................... 117
Table 161: WLISt:SIZE?.......................................................................................................................... 117
Table 162: WLISt: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:FORWard? (Query Only)......................................................................................... 124
Table 174: MIM:SLAve? (Query Only)............................................................................................... 124
Table 175: MIM:CAPTured? (Query Only)........................................................................................ 125
Table 176: MIM:RELease (No Query Form) ...................................................................................... 125
Table 177: Command Errors .............................................................................................................. 128
Table 178: Predefined Waveforms ................................................................................................... 128

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
8
1. PREFACE
Scope of this document is to describe the use of SCPI commands with the HD T3AWG3K-C
series when used in the True-Arb Operating Mode.
1.1 Abbreviations 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: Abbreviations and terms
1.2 Revision History

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
9
Rev.
Document Changes
Date
1.3
Modified Commands:
AWGControl:RMODe
Added commands:
AWGControl:JUMPMode
{AFTERrepetitions|IMMediate}
AWGControl:JUMPMode
{AFTERrepetitions|IMMediate}
AWGControl:JUMPMode?
SEQuence:ELEM[#]:WAITEvent
{NONE|MANual|TIMer|EXTernal}
SEQuence:ELEM[#]:WAITEvent?
SEQuence:ELEM[#]:GOTOMode
{FIRST|PREVious|NEXT|LAST|ITEM}
SEQuence: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|MAXimum|DEFault|<value>}
SEQuence:ELEM[#]:PATTERN?
[{MINimum|MAXimum}]
SEQuence:ELEM[#]:PATTERNJUMPTOMode
{FIRST|PREVious|NEXT|LAST|ITEM}
SEQuence:ELEM[#]:PATTERNJUMPTOMode?
SEQuence:ELEM[#]:PATTERNJUMPTOEntry
{MINimum|MAXimum|DEFault|<value>}
May 7, 2019

Programming Manual –T3AWG3K-C Series 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?

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
11
2. SYNTAX AND COMMANDS
2.1 Command Syntax
2.1.1 Syntax Overview
Control the operations and functions of the instrument 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 instrument uses to
process them. See the Command Groups topic for a listing of the commands by command
group or use the index to locate a specific command.
Refer to the following table for the symbols that are used.
Symbol
Meaning
< >
Defined element
::=
Is defined as
|
Exclusive OR
{ }
Group; one element is required
[ ]
Optional; can 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 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 OUTPut1:STATe has a query form OUTPut1:STATe?.
Not all commands have both a set and a query form. Some commands have only set and
some have only query.
Messages
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.

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
12
Symbol
Meaning
<Header>
This is the basic command name. If the header ends with a question mark,
the command is a query. The header may begin with a colon (:) character.
If the command is concatenated with other commands, the beginning
colon is required. Never use the beginning colon with command headers
beginning with a star (*).
<Mnemonic>
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.
<Argument>
This is a quantity, quality, restriction, or limit associated with the header.
Some commands have no arguments while others have multiple arguments.
A <space> separates arguments from the header. A <comma> separates
arguments from each other.
<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 perform a specific function or change one of the settings.
Commands have the structure:
[:]<Header>[<Space><Argument>[<Comma><Argument>]...]
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 of the previous one. Commands at a higher level in the tree may affect
those at a lower level. The leading colon (:) always returns you to the base of the command
tree.
Queries
Queries cause the instrument to return status or setting information.
Queries have the structure:
[:]<Header>?
[:]<Header>?[<Space><Argument>[<Comma><Argument>]...]

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
13
2.1.3 Command Entry
Rules
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 through 09 and 0B 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.
Abbreviating
You can abbreviate many instrument commands. Each command in this documentation
shows the abbreviations in capitals. For example, enter the command AWGControl:RMODE
TRIGgered simply as AWGC:RMODE TRIG.
Concatenating
Use a semicolon (;) to concatenate any combination of set commands and queries.
The instrument executes concatenated commands in the order received. When
concatenating commands and queries, follow these rules:
1. Separate completely different headers by a semicolon and by the beginning colon on
all commands except the first one.
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 only the last mnemonic,
abbreviate the second command and eliminate the beginning colon.
For example, concatenate the commands SEQuence:ELEM1:VOLTage:HIGH1 2 and
SEQuence:ELEM1:VOLTage:LOW1 -2 into a single command:
SEQuence:ELEM1:VOLTage:HIGH1 2;LOW1 -2
The longer version works equally well:
SEQuence:ELEM1:VOLTage:HIGH1 2;: SEQuence:ELEM1:VOLTage:LOW1 -2
3. Never precede a star (*) command with a semicolon (;) or colon (:).
4. When you concatenate queries, the responses to all the queries are concatenated into
a single response message.
For example, if the high level of the marker1 of channel one is 1.0 V and the voltage
selection is LINE, the concatenated query : MARKer:LEVel1?; : MARKer:MODE?; will return
the following:
1.0;FIXEDLow

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
14
5. Set commands and queries may be concatenated in the same message.
For example, AWGControl:RMODe CONTinuous;:SEQuence:LENGth? is a valid message
that sets the run mode to Sequence. The message then queries the length of the
sequence. Concatenated commands and queries are executed in the order received.
Here are some invalid concatenations:
•OUTPut1:STATe ON;AWGControl:RMODE CONTinuous
(no colon before AWGControl)
•SEQuence:ELEM1:VOLTage:HIGH1 2;:LOW1 -2 (extra colon before LOW1 -2 instead
SEQuence:ELEM1:VOLTage:HIGH1 2;LOW1 -2)
Terminating
This documentation uses <EOM> (end of message) to represent a message terminator.
Symbol
Meaning
<EOM>
Message terminator
Table 5: Message terminator and meaning
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.
2.1.4 Parameter Types
Parameters are indicated by angle brackets, such as <file_name>. 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.
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 #0xxxxx...<LF><&EOI>
Boolean
Boolean numbers or values
ON or 1
OFF or 0
Discrete
A list of specific values
MINimum, MAXimum
NR1 numeric
Integers
0, 1, 15, –1
NR2 numeric
Decimal numbers
1.2, 3.141,–6.5

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
15
NR3 numeric
Floating point numbers
3.1415E+9
NRf numeric
Flexible decimal numbers that may
be type NR1, NR2, or NR3
See NR1, NR2, and NR3 examples in
this table
String
Alphanumeric characters (must be
within quotation marks)
"Testing 1, 2, 3"
Table 6: Parameter types, their descriptions, and examples
Quoted String
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:
Symbol
Meaning
<QString >
Quoted string of ASCII text
Table 7: String symbol and meaning
A quoted string can include any character defined in the 7-bit ASCII character set. Follow
these rules when you use quoted strings:
1. Use the same type of quote character to open and close the string. For example: “this
is a valid string”.
2. 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 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.
Here are some invalid strings:
•“Invalid string argument' (quotes are not of the same type)
•“test<EOI>”(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 <NR3>. (SI units are
units that conform to the System International d’Unites standard.) 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.

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
16
Omit the unit when you describe commands, but include the SI unit prefix. Enter both
uppercase and lowercase characters. The following list shows examples of units you can use
with the commands.
•V for voltage (V).
•HZ for frequency (Hz).
•OHM for impedance (ohm).
•S for time (s).
•DBM for power ratio.
•PCT for %.
•VPP for Peak-to-Peak Voltage (V p-p).
•UIPP for Peak-to-Peak, Unit is UI (UI p-p).
•UIRMS for RMS, Unit is UI (UIrms).
•SPP for Peak-to-Peak, Unit 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: SI prefixes and their indexes
1. Note that the prefix m/M indicates 10–3when the decimal numeric argument denotes voltage or time, but indicates
106when it denotes frequency.
2. Note that the prefix u/U is used instead of “μ”.
Since M (m) can be interpreted as 1E-3 or 1E6 depending on the units, use mV for V, and MHz
for Hz.

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
17
The SI prefixes need units.
Correct: 10MHz, 10E+6Hz, 10E+6
Incorrect: 10M
2.1.5 SCPI Commands and Queries
The arbitrary waveform generator uses a command language based on the SCPI standard.
The SCPI (Standard Commands for Programmable Instruments) standard was created by a
consortium to provide guidelines for remote programming of instruments. These guidelines
provide a consistent programming environment for instrument control and data transfer. This
environment uses defined programming messages, instrument responses and data formats
that operate across all SCPI instruments, regardless of manufacturer.
The SCPI language is based on a hierarchical or tree structure 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.
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.

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
18
2.2 Status and events
The SCPI interface in the instrument includes a status and event reporting system that ena-
bles the user 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 in the Status Byte.

Programming Manual –T3AWG3K-C Series Arbitrary Waveform Generator
True-Arb Operating Mode
19