Tektronix TDS7000 Series Programmer's Manual
  1. Manuals
  2. Brands
  3. Tektronix Manuals
  4. Test Equipment
  5. TDS7000 Series
  6. Programmer's manual
Tektronix TDS7000 Series Programmer's Manual

Tektronix TDS7000 Series Programmer's Manual

Gpib programmer online guide digital phosphor oscilloscopes
Hide thumbs Also See for TDS7000 Series:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
Table of Contents

Advertisement

Quick Links

Download this manual See also: Reference Manual, Instruction Manual
®
TDS7000 Series
GPIB Programmer Online Guide
Printable version 1.0

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the TDS7000 Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Tektronix TDS7000 Series

Summary of Contents for Tektronix TDS7000 Series

  • Page 1 ® TDS7000 Series GPIB Programmer Online Guide Printable version 1.0...

  • Page 3: Copyright And Version Information

    Copyright and Version Information Copyright © Tektronix, Inc. All rights reserved. Licensed software products are owned by Tektronix or its suppliers and are protected by United States copyright laws and international treaty provisions. Use, duplication or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, or...
  • Page 4 Connecting to the Instrument Your instrument has a 24-pin GPIB connector on its rear panel. This connector has a D-type shell and conforms to IEEE Std 488.1–1987. Attach an IEEE Std 488.1–1987 GPIB cable to this connector and to your controller as shown in the following figure. If necessary, the GPIB connectors can be stacked as shown in the figure below.
  • Page 5 Click the Configuration Talk/Listen button. Change the GPIB Address to a unique address. Click the Close button.
  • Page 6 The instrument is set up for bi-directional communication with your controller. Documentation In addition to this TDS7000 Series Programmer Online Guide, the following documentation is included with this instrument. User Manual. The User Manual has information about installing and operating the Oscilloscope. It also...

  • Page 7: Command Syntax

    Command Syntax Syntax Overview You can control the operations and functions of the instrument through the GPIB interface using commands and queries. The related topics listed below describe the syntax of these commands and queries. The topics also describe the conventions that the instrument uses to process them. See the Command Groups topic in the table of contents for a listing of the commands by command group or use the index to locate a specific command.

  • Page 8: Command And Query Structure

    Command and Query Structure 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.
  • Page 9 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 off the previous one.
  • Page 10 Queries Queries cause the instrument to return status or setting information. Queries have the structure: • [:]<Header>? • [:]<Header>?[<Space><Argument>[<Comma><Argument>] ...] You can specify a query command at any level within the command tree unless otherwise noted. These branch queries return information about all the mnemonics below the specified branch or level. For example, HIStogram:STATistics:STDdev? returns the standard deviation of the histogram, while HIStogram:STATistics? returns all the histogram statistics, and HIStogram? returns all the histogram parameters.
  • Page 11 Headers You can control whether the instrument returns headers as part of the query response. Use the HEADer command to control this feature. If header is on, the query response returns command headers, then formats itself as a valid set command. When header is off, the response includes only the values. This may make it easier to parse and extract the information from the response.

  • Page 12: Command Entry

    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).
  • Page 13 Abbreviating You can abbreviate many instrument commands. Each command in this documentation shows the abbreviations in capitals. For example, you can enter the command ACQuire:NUMAvg simply as ACQ:NUMA or acq:numa. Abbreviation rules may change over time as new instrument models are introduced. Thus, for the most robust code, use the full spelling.
  • Page 14 Concatenating You can concatenate any combination of set commands and queries using a semicolon (;). The instrument executes concatenated commands in the order received. When concatenating commands and queries, you must follow these rules: 1 Separate completely different headers by a semicolon and by the beginning colon on all commands except the first one.
  • Page 15 Terminating This documentation uses <EOM> (End of message) to represent a message terminator. End of Message Terminator Symbol Meaning <EOM> Message terminator The end-of-message terminator may be the END message (EOI asserted concurrently with the last data byte), the ASCII code for line feed (LF) sent as the last data byte, or both. The instrument always terminates messages with LF and EOI.

  • Page 16: Clearing The Instrument

    Clearing the Instrument You can clear the Output Queue and reset the instrument to accept a new command or query by using the selected Device Clear (DCL) GPIB function. Refer to your GPIB library documentation for further details about the selected Device Clear operation.

  • Page 17: Argument Types

    Argument Types Numeric Many instrument commands require numeric arguments. The syntax shows the format that the instrument returns in response to a query. This is also the preferred format when sending the command to the instrument though any of the formats will be accepted. This documentation represents these arguments as follows: Numeric Arguments Symbol...
  • Page 18 Block Several instrument commands use a block argument form (see the following table). B l o c k A r g u m e n t s Symbol Meaning <NZDig> A nonzero digit character in the range of 1–9 <Dig> A digit character, in the range of 0–9 <DChar>...

  • Page 19: Constructed Mnemonics

    Constructed Mnemonics Some header mnemonics specify one of a range of mnemonics. For example, a channel mnemonic can be CH1, CH2, CH3, or CH4. You use these mnemonics in the command just as you do any other mnemonic. For example, there is a CH1:POSition command, and there is also a CH2:POSition command.

  • Page 20: Acquisition Command Group

    Commands Acquisition Command Group Acquisition Overview You use the commands in the Acquisition Command Group to set up the modes and functions that control how the instrument acquires the signals you input to the channels and processes them into waveforms. Using these commands for acquiring waveforms, you can do the following: •...
  • Page 21 Acquisition Commands Command Description ACQuire? Returns acquisition parameters ACQuire:MODe? Returns acquisition mode ACQuire:MODe Sets acquisition mode ACQuire:NUMACq? Returns the number of acquisitions that have occurred ACQuire:NUMAVg? Returns number of acquisitions for an averaged waveform ACQuire:NUMAVg Sets number of acquisitions for an averaged waveform ACQuireNUMEnv? Returns number of acquisitions...

  • Page 22: Acquire:mode

    ACQuire:MODe Description This command sets or queries the acquisition mode of the oscilloscope. This affects all live waveforms. This command is equivalent to selecting Horizontal/Acquisition from the Horiz/Acq menu and then choosing the desired mode from the Acquisition Mode group box. Waveforms are the displayed data point values taken from acquisition intervals.
  • Page 23 ACQuire:MODe? This command might return , indicating that the displayed waveform is the :ACQuire:MODe AVERAGE average of the specified number of waveform acquisitions.
  • Page 24 ACQuire:NUMACq? Description This query-only command returns the number of waveform acquisitions that have occurred since starting acquisition with the ACQuire:STATE RUN command. This value is reset to zero when any acquisition, horizontal, or vertical arguments that affect the waveform are changed. The maximum number of acquisitions that can be counted is 2 –1.
  • Page 25 ACQuire:NUMAVg Description This command sets or queries the number of waveform acquisitions that make up an averaged waveform. Use the ACQuire:MODe command to enable the Average mode. Sending this command is equivalent to selecting Horizontal/Acquisition Setup from the Horiz/Acq menu, selecting the Acquisition tab, and then choosing Average from the Acquisition Mode group box.
  • Page 26 ACQuire:NUMEnv Description This command sets or queries the number of waveform acquisitions that make up an envelope waveform. Sending this command is equivalent to setting the Envelope count in the Acquisition Mode side menu. Group Acquisition Syntax 1 ACQuire:NUMEnv {<NRf> | INFInite} Syntax 2 ACQuire:NUMEnv? Arguments...
  • Page 27 ACQuire:REPEt Description This command sets or queries whether repetitive mode is on or off. This is equivalent to setting Equivalent Time Auto/Off in the Acquisition control window. When the oscilloscope is in real-time operation, this setting has no effect. The ACQuire:REPet command specifies the behavior of the acquisition system during equivalent-time operation.
  • Page 28 ACQuire:STATE Description This command starts or stops acquisitions. When state is set to ON or RUN, a new acquisition will be started. If the last acquisition was a single acquisition sequence, a new single sequence acquisition will be started. If the last acquisition was continuous, a new continuous acquisition will be started. If RUN is issued in the middle of completing a single sequence acquisition (for examples, averaging or enveloping), the acquisition sequence is restarted, and any accumulated data is discarded.
  • Page 29 ACQuire:STOPAfter Description This command sets or queries whether the oscilloscope continually acquires acquisitions or acquires a single sequence. This command is equivalent to pressing SINGLE from the front-panel. Group Acquisition Related Commands ACQuire:STATE (see page 26), ACQuire:REPEt (see page 25) Syntax 1 ACQuire:STOPAfter {RUNSTop|SEQuence}...
  • Page 30 ACQuire? Description This query-only command returns the following current acquisition parameters: • Stop after • Acquisition state • Mode • Number of envelopes • Number of averages • Repetitive signals Group Acquisition Related Commands ACQuire:MODe (see page 20), ACQuire:NUMACq (see page 22), ACQuire:NUMAVg (see page 23), ACQuire:NUMenv (see page 24), ACQuire:REPEt (see page 25), ACQuire:STATE ( see page 26), ACQuire:STOPAfter (see page 27) Syntax...
  • Page 31 FASTAcq? Description This query-only command returns the state of Fast Acquisition. This command is equivalent to the FASTACQ button on the front panel. Group Acquisition Syntax FASTAcq? Example FASTAcq? This query might return the following string for the current acquisition parameters: :FASTACQ:STATE 0...
  • Page 32 FASTAcq:STATE Description This command sets or queries the state of Fast Acquisition. This command is equivalent to the FASTACQ button on the front panel. Group Acquisition Syntax 1 FASTAcq:STATE {ON|OFF|<NR1>} Syntax 2 FASTAcq:STATE? Arguments • ON This enables Fast Acquisition mode. •...

  • Page 33: Alias Command Group

    • Alias names do not appear in response messages. • The Alias commands are defined in Tektronix Standard Codes and Formats. Deviations between that standard and what is specified here will be considered Phoenix errors unless specifically noted in the...

  • Page 34: Alias Commands

    Alias Commands Command Description ALIas? Returns the alias state ALIas Sets the alias state ALIAS:CATalog? Returns a list of the currently defined alias labels ALIas:DEFIne Assigns a sequence of program messages to an alias label ALIas:DELEte Removes a specified alias ALIas:DELEte:ALL Deletes all existing aliases ALIas:DELEte:NAMe...
  • Page 35 ALIas Description This command sets or queries the state of alias functionality. Group Alias Related Commands ALIas:STATE (see page 39) Syntax 1 ALIas {OFF|ON|<NR1>} Syntax 2 ALIas? Arguments • OFF This turns Alias expansion off. If a defined alias is sent when ALIas:STATE is off, a command error (102) will be generated.
  • Page 36 ALIas:CATalog? Description This query-only command returns a list of the currently defined alias labels, separated by commas. If no aliases are defined, the query returns the string "". Group Alias Syntax ALIas:CATalog? Example ALIas:CATalog? This query might return the string , showing that :ALIAS:CATALOG "SETUP1","TESTMENU1","DEFAULT"...
  • Page 37 ALIas:DEFIne Description This command assigns a sequence of program messages to an alias label. These messages are then substituted for the alias whenever it is received as a command or query, provided that ALIas:STATE has been turned on. The query form of this command returns the definitions of a selected alias. Attempting to give two aliases the same name causes an error.
  • Page 38 ALIas:DELEte Description This command removes a specified alias and is identical to ALIas:DELEte:NAMe. An error message is generated if the named alias docs do not exist. Group Alias Related Commands *ESR? (see page 36), ALIas:DELEte:ALL (see page 37) Syntax ALIas:DELEte <Qstring> Argument •...
  • Page 39 ALIas:DELEte:ALL Description This command deletes all existing aliases. Group Alias Related Commands ALIas:DELEte (see page 36), ALIas:DELEte:NAMe (see page 38) Syntax ALIas:DELEte:ALL Example ALIas:DELEte:ALL This command deletes all existing aliases.
  • Page 40 ALIas:DELEte:NAMe Description This command removes a specified alias. An error message is generated if the named alias does not exist. This command is identical to ALIas:DELEte. Group Alias Syntax ALIas:DELEte:NAMe <Qstring> Argument • <Qstring> This is the name of the alias to remove. Using ALIas:DELEte:NAMe without specifying an alias causes an exception error.
  • Page 41 ALIas:STATE Description This command turns aliases on or off and is identical to the ALIas command. The query form of this command returns the state of the aliases. Group Alias Syntax 1 ALIas:STATE {OFF|ON|<NR1>} Syntax 2 ALIas:STATE? Arguments • OFF This turns alias expansion off.

  • Page 42: Calibration Command Group

    Calibration Command Group Calibration Overview The calibration commands provide information about the current state of calibration for the mainframe and all resident sampling head channels. Calibration Commands Command Description *CAL? Instructs the scope to perform self-calibration CALibrate:PRObestate:CH<x>? Returns the calibration status of the attached probe CALibrate:RESults? Returns status of all calibration subsystems...
  • Page 43 *CAL? Description This query-only command instructs the digitizing oscilloscope to perform a signal path compensation and returns its calibration status. This command is equivalent to selecting Instrument Calibration from the Utilities menu and then clicking the Calibrate button. The self-calibration can take several minutes to respond. No other commands will be executed Note: until calibration is complete.
  • Page 44 CALibrate:RESults? Description This query-only command returns the status of all the calibration subsystems, without performing an SPC operation. The results returned do not include the calibration status of attached probes. The CALibration:RESults? Query is intended to support GO/NoGO testing of the oscilloscope's calibration readiness: all returned results should indicate Pass status if the oscilloscope is "fit for duty".
  • Page 45 CALibrate:PRObestate:CH<x>? Description This query-only command returns the status of probe calibration of a given channel's probe, which can be Pass (0), Initialized, (1), Fail (-1), or Running (2). This command is equivalent to selecting Probe Cal from the Vertical menu. Group Calibration Related Commands...
  • Page 46 CALibrate:RESults:SPC? Description This query-only command returns the results of the last SPC operation. However, this query does not cause an SPC to be run. This command is equivalent to selecting Instrument Calibration from the Utilities menu. Group Calibration Related Commands *CAL? (see page 41) Syntax CALibrate:RESults:SPC?

  • Page 47: Cursor Command Group

    Cursor Command Group Cursor Overview You use the commands in the Cursor Command Group to control the cursor display and readout. You can use these commands to control the setups for cursor 1 and cursor 2, such as waveform source, cursor position, and cursor color.

  • Page 48: Cursor Commands

    Cursor Commands Command Description CURSor? Returns all cursor settings CURSor:FUNCtion? Returns cursor type CURSor:FUNCtion Sets cursor type CURSor:HBArs? Returns hbar cursor settings CURSor:HBArs:DELTa? Returns hbars vertical difference CURSor:HBArs:POSITION<x>? Returns hbar cursor<x> vertical position CURSor:HBArs:POSITION<x> Sets hbar cursor<x> vertical position CURSor:HBArs:UNIts? Returns hbar cursor units CURSor:MODe? Returns whether cursors move in...
  • Page 49 cursors CURSor:SPLit:UNIts Sets the amplitude units of the split cursors CURSor:SPLit:VDELTA? Returns the horizontal difference between cursors 1 and 2 CURSor:STATE? Returns the cursor state CURSor:STATE Turns cursors on or off CURSor:VBArs? Returns the position of the vertical bar cursor CURSor:VBArs Sets the position of the vertical bar cursor...
  • Page 50 CURSor? Description This query-only command returns all of the current cursor settings. Group Cursor Syntax CURSor? Example: CURSOR? This query might return the following as the current cursor settings: :CURSOR:STATE OFF;FUNCTION VBARS;MODE INDEPENDENT ;SOURCE CH1;VBARS:UNITS SECONDS;POSITION1 -8.0000E-07 ;POSITION2 8.0000E-07;:CURSOR:HBARS:POSITION1 3.0000E-01 ;POSITION2 -3.0000E-01;UNITS BASE;:CURSOR:PAIRED :POSITION1 -8.0000E-07;POSITION2 8.0000E-07;UNITS BASE;...

  • Page 51: Cursor:function

    CURSor:FUNCtion Description This command selects or queries the cursor type. Sending this command is equivalent to selecting Cursor Type from the Cursor menu and then choosing from the drop-down list. Group Cursor Related Commands CURSor:STAte (see page 69) Syntax 1 CURSor:FUNCtion {HBArs|OFF|VBArs|PAIred|SPLit} Syntax 2 CURSor:FUNCtion?
  • Page 52 CURSor:HBArs? Description This query-only command returns the current settings for the horizontal bar cursors. Group Cursor Syntax CURSor:HBArs? Example CURSor:HBArs? This command might return :CURSOR:HBARS:POSITION1 320.0000E-03;POSITION2-320.0000E- 03;UNITS BASE...
  • Page 53 CURSor:HBArs:DELTa? Description This query-only command returns the vertical difference between the two horizontal bar cursors. Group Cursor Syntax CURSor:HBArs:DELTa? Returns <NR3> Example CURSOR:HBArs:DELTa? This command might return , indicating that the voltage difference :CURSOR:HBARS:DELTA 5.0800E+00 between the two cursors is 5.08 V.
  • Page 54 CURSor:HBArs:POSITION<x> Description This command specifies or queries the horizontal bar cursor position relative to ground, which is expressed in vertical units (usually volts). This command is the equivalent of selecting Cursor Position from the Cursors menu, selecting the H Bars Cursor Type and then viewing or editing the desired cursor position.
  • Page 55 CURSor:HBArs:UNIts? Description This query-only command returns the units for the horizontal bar cursors. Group Cursor Syntax CURSor:HBArs:UNIts? Example CURSor:HBArs:UNIts? This query might return indicating that the units for the horizontal bar :CURSOR:HBARS:UNITS BASE cursors are base.

  • Page 56: Cursor:mode

    CURSor:MODe Description This command sets or queries whether the two cursors move together in unison or separately. This command is the equivalent of selecting Cursor Mode from the Cursor menu and then choosing from the drop-down list. Group Cursor Syntax 1 CURSor:MODe {TRACk|INDependent} Syntax 2 CURSor:MODe?
  • Page 57 CURSor:PAIred Description This command positions the active paired cursor to the position defined by the DATa:STARt or DATa:STOP command. This query returns the current paired cursor settings. Group Cursor Related Commands DATa:STARt (see page 473), DATa:STOP (see page 474) Syntax 1 CURSor:PAIred SNAp Syntax 2 CURSor:PAIred?
  • Page 58 CURSor:PAIred:HDELTA? Description This query-only command returns the vertical difference between the cursor1 and cursor2 paired cursors. This is the absolute value of the vertical position for cursor1 minus the vertical position for cursor2. Group Cursor Related Commands CURSor:SPLit:HDELTA? (see page 63) Syntax CURSor:PAIred:HDELTA? Returns...
  • Page 59 CURSor:PAIred:HPOS<x>? Description This query-only command returns the voltage at the vertical position of the cursor<x> paired cursor. The paired cursor can be either 1 or 2. Group Cursor Related Commands CURSor:FUNCtion (see page 49) Syntax CURSor:PAIred:HPOS<x>? Returns A floating point value that indicates the vertical position of the selected paired cursor. Example CURSor:PAIred:HPOS1? This query might return...
  • Page 60 CURSor:PAIred:POSITION<x> Description This command sets or queries the horizontal position (typically in time) of the cursor<x> paired cursor. This command is equivalent to selecting Cursor Position from the Cursors menu and then viewing or editing the desired cursor position. Group Cursor Related Commands CURSor:FUNCtion (see page 49)
  • Page 61 CURSor:PAIred:UNIts? Description This query-only command requests the units for the paired cursors. Group Cursor Syntax CURSor:PAIred:UNIts? Returns The unit of measurement. Example CURSor:PAIred:UNIts? This query might return: , indicating that base is the unit of measure. :CURSOR:PAIRED:UNITS BASE...
  • Page 62 CURSor:PAIred:VDELTA? Description This query-only command requests the Vbar (time) distance between paired cursors. It returns the absolute value of the first cursor less the second cursor horizontal positions. The position can appear in units of base and 1/base. Group Cursor Syntax CURSor:PAIred:VDELTA? Returns...
  • Page 63 CURSor:SOUrce Description This command sets and queries the source for horizontal bar, vertical bar and paired cursors, and both sets and queries the source for split cursor1. This command is equivalent to selecting Cursor Setup from the Cursor menu and then choosing the desired cursor source. Group Cursor Related Commands...
  • Page 64 CURSor:SPLit Description This command positions the Split cursors to positions defined by DATa:STARt and DATa:STOP (or maximum record length, if DATa:STOP is greater than the maximum record length). The query form of this command returns the units, positions and second source of the split cursors. Group Cursor Related Commands...
  • Page 65 CURSor:SPLit:HDELTA? Description This query-only command returns the vertical (volts) difference between cursor1 and cursor2. These values are represented on screen by the "X" markers (placed where the cursor marker and the waveform intersect). Group Cursor Syntax CURSor:SPLit:HDELTA? Example CURSor:SPLit:HDELTA? This query might return , indicating that the vertical difference :CURSOR:SPLIT:HDELTA 3.1400E+00 between two split cursors is 3.14 V.
  • Page 66 CURSor:SPLit:HPOS<x>? Description This query-only command returns the vertical position of cursor<x> (i.e., that point where the Vbar intersects with the waveform), which can be specified as 1 or 2. Group Cursor Related Commands CURSor:SPLit:HDELTA (see page 63) Syntax CURSor:SPLit:HPOS<x>? Example CURSor:SPLit:HPOS1? This query might return , indicating that the vertical position of cursor1...
  • Page 67 CURSor:SPLit:POSITION<x> Description This command returns or sets the horizontal position of the cursor<x> vertical bar markers. This command is equivalent to selecting Cursor Setup from the Cursors menu and then entering the desired Cursor Position. Group Cursor Syntax 1 CURSor:SPLit:POSITION<x>; <NRf> Syntax 2 CURsor:SPLit:POSITION<x>? Argument...
  • Page 68 CURSor:SPLit:SOURCE2 This command sets or returns the source waveform associated with split cursor2. This command is equivalent to selecting Cursor Setup from the Cursors menu and then entering the desired Cursor 2 Source. Group Cursor Related Commands CURSor:SOUrce (see page 61) Syntax 1 CURSor:SPLit:SOURCE2 Syntax 2...
  • Page 69 CURSor:SPLit:UNIts Description This command returns or sets the amplitude units of the split cursors. Group Cursor Syntax 1 CURSor:SPLit:UNIts Syntax 2 CURsor:SPLit:UNIts? Example 1 CURSor:SPLit:UNIts BASE This command sets the amplitude units of the split cursors to base. Example 2 CURSor:SPLit:UNIts? This query would return , indicating that base is the current setting for split...
  • Page 70 CURSor:SPLit:VDELTA? Description This command returns the horizontal (time) difference between the split cursors. It returns the absolute value of the first cursor less the second cursor horizontal positions. Note that the split cursor values are for source1 and source2, and the sources can be located on different waveforms. The position can appear in units of base and 1/base.
  • Page 71 CURSor:STATE Description This command sets or returns the state of the cursor. The cursor can either be turned on or off. Note that setting the cursor state does not modify the cursor type. This command is equivalent to pressing the CURSOR button on the front panel.
  • Page 72 CURSor:VBArs Description This command positions the vertical bar cursor to the position defined by DATa:STARt DATa:STOP This query returns the current vertical bar settings for horizontal position and units. Group Cursor Related Commands DATa:STARt (see page 473), DATa:STOP (see page 474) Syntax 1 CURSor:VBArs? Syntax 2...
  • Page 73 CURSor:VBArs:DELTa? Description This query-only command returns the difference between the two vertical bar cursors. The units are specified by the CURSor:VBArs:UNIts command. The position can appear in units of Base or 1/Base. Group Cursor Related Commands CURSor:VBArs:UNIts (see page 73) Syntax CURSor:VBArs:DELTa? Returns...
  • Page 74 CURSor:VBArs:POSITION<x> Description This command sets or queries the horizontal position for both vertical bar and paired cursors. Values are with respect to trigger position or the zero reference point for the designated waveform (if horizontal units are not set to Time). Use the CURSor:VBArs:UNIts command to specify units. The position can appear in units of base or 1/base.
  • Page 75 CURSor:VBArs:UNIts Description This command sets or queries the units for the vertical bar cursors. Group Cursor Syntax 1 CURSor:VBArs:UNIts Syntax 2 CURSor:VBArs:UNIts? Arguments • SECOnds Fix the units for the VBArs for time domain. • HERtz Fix the units for the VBArs for frequency domain. Returns A string for SECOnds or HERtz, depending upon current vertical bar cursor units.

  • Page 76: Diagnostics Command Group

    Diagnostics Command Group Diagnostics Overview You use the commands in the Diagnostic Command Group to control the selection and execution of diagnostic tests. You can use Test functions to select and execute an item at any level of the test hierarchy.
  • Page 77 Diagnostics Commands Description Command DIAg:CONTROl:HALT Enables or disables halting on first diagnostic failure DIAg:CONTROl:LOOp Enables or disables looping of diagnostics DIAg:EXECUTE Executes currently selected set of diagnostics DIAg:ITEM? Returns all data associated with a particular item of the current RSI menu DIAg:ITEM:FAILURES? Returns the total number of failures...
  • Page 78 from the same level of test hierarchy DIAg:SELect:SUBSYS Selects one of the available diagnostic subsystems DIAg:SELect:TEST Selects one of the available diagnostic tests DIAg:STATE Sets the instrument operating state DIAg:STOP Terminates the execution of diagnostics ERRLOG CLEAR Deletes all entries in the error log and zeroes the test sequence count ERRLOG:FIRST? Returns the first message in the error...
  • Page 79 DIAg:CONTROL:HALT Description This command (no query form) determines whether the next execution of diagnostics will stop on the first diagnostic failure that occurs or will execute the selected set of diagnostic functions. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then enabling Halt on Fail. Group Diagnostics Related Commands...
  • Page 80 DIAg:CONTROL:LOOP Description This command (no query form) determines whether the next execution of diagnostics executes once or continuously loops on the selected set of diagnostics (assuming the halt control is set to off using the DIAg:CONTROL:HALT command or that the halt control is set to ON but no failures occur). This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then enabling Loop Control.
  • Page 81 DIAg:EXECUTE Description This command (no query form) starts the execution of the currently selected set of diagnostics. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then pressing Run. Group Diagnostics Related Commands DIAg:STATE (see page 100) Syntax DIAg:EXECUTE Example...
  • Page 82 DIAg:ITEM? Description This query-only command returns all the data associated with a particular item from the RSI menu (level of test hierarchy). This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the diagnostics settings. Group Diagnostics Related Commands...
  • Page 83 DIAg:ITEM:FAILURES? Description This query-only command returns the total number of failures. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Diagnostic Status. Group Diagnostics Related Commands DIAg:ITEM? (see page 80), DIAg:ITEM:NAME? (see page 82), DIAg:ITEM:RESULT? (see page 83), DIAg:ITEM:SUBITEMS? (see page 84) Syntax DIAg:ITEM:FAILURES?
  • Page 84 DIAg:ITEM:NAMe? Description This query-only command returns the name of the selected menu item. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Subsystem, Area and Test settings. Group Diagnostics Related Commands DIAg:ITEM? (see page 80), DIAg:ITEM:FAILURES? (see page 81), DIAg:ITEM:RESULT? (see page 83), DIAg:ITEM:SUBITEMS? (see page 84) Syntax DIAg:ITEM:NAMe?
  • Page 85 DIAg:ITEM:RESULT? Description This query-only command returns the result from the last execution of the item. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Diagnostic Status. Group Diagnostics Related Commands DIAg:ITEM? (see page 80), DIAg:ITEM:NAMe? (see page 82), DIAg:ITEM:FAILURES? (see page 81), DIAg:ITEM:SUBITEMS? (see page 84) Syntax DIAg:ITEM:RESULT?
  • Page 86 DIAg:ITEM:SUBITEMS? Description This query-only command returns the number of sub-items associated with the item. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu, choosing the Subsystem, Area or Test setting and then reviewing the resulting sub-items. Group Diagnostics Related Commands DIAg:ITEM? (see page 80), DIAg:ITEM:NAME? (see page 82), DIAg:ITEM:FAILURES? (see page 81),...
  • Page 87 DIAg:LEVEL Description This command sets or returns the currently selected level of diagnostic test hierarchy. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Diagnostic Status. Group Diagnostics Syntax 1 DIAg:LEVEL (SUBSYS|AREA|TEST} Syntax 2 DIAg:LEVEL? Arguments •...
  • Page 88 DIAg:LOOPS? Description This query-only command returns the number of times that the selected diagnostics set was completed during the last diagnostic execution. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Loop Count. Group Diagnostics Syntax...
  • Page 89 DIAg:NAMe? Description This query-only command returns the names of the subsystem, area, and test of the current diagnostic test. Group Diagnostics Related Commands DIAg:NAMe:AREA? (see page 88), DIAg:NAMe:SUBSYS? (see page 89), DIAg:NAMe:TEST? (see page Syntax DIAg:NAMe? Example DIAg:NAMe? This query might return :DIAG:NAME:SUBSYS "Acquisition";AREA "Memory";TEST"diag Data Format", indicating the subsystem name, area name, and test name of the currently selected diagnostic test.
  • Page 90 DIAg:NAMe:AREA? Description This query-only command returns the selected area of the current diagnostic test. There are three levels of diagnostic test hierarchy: subsystem, area and test. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Diagnostic Status. Group Diagnostics Related Commands...
  • Page 91 DIAg:NAMe:SUBSYS? Description This query-only command returns the subsystem of the current diagnostic test. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Diagnostic Status. Group Diagnostics Related Commands DIAg:NAMe? (see page 87), DIAg:NAMe:AREA? (see page 88), DIAg:NAMe:TEST? (see page 90) Syntax DIAg:NAMe:SUBSYS? Example...
  • Page 92 DIAg:NAMe:TEST? Description This query-only command returns the name of the current diagnostic test. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Diagnostic Status. Group Diagnostics Related Commands DIAg:NAMe? (see page 87), DIAg:NAMe:AREA? (see page 88), DIAg:NAMe:SUBSYS? (see page 89) Syntax DIAg:NAMe:TEST? Example...
  • Page 93 DIAg:NUMITEMS? Description This query-only command returns the number of items on the currently selected level of test hierarchy, which ranges from 0 through 15. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Diagnostic Status. Group Diagnostics Syntax...
  • Page 94 DIAg:PUMODE Description This command sets or returns the current diagnostic mode of the instrument. Group Diagnostics Syntax 1 DIAg:PUMODE {USER|FACTORY} Syntax 2 DIAg:PUMODE? Arguments • USER This sets the instrument to user diagnostic mode. • FACTORY This sets the instrument to factory diagnostic mode. Example 1 DIAg:PUMODE FACTORY This command sets the instrument to the factory diagnostic mode.
  • Page 95 DIAg:RESULts? Description This query-only command returns an abbreviated status about the results of the last diagnostic (or test) execution. For a more explanatory status message, use the DIAg:RESULts:VERBose? query. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Diagnostic Status.
  • Page 96 DIAg:RESULts:VERBose? Description This query-only command returns a more explanatory message about the results of the last diagnostic (or test) execution than the DIAg:RESUlts? query. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Diagnostic Status. Group Diagnostics Related Commands...
  • Page 97 DIAg:SELect:ALL Description This command (no query form) selects all available diagnostics. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then choosing ALL from the Subsystem, Area and Test pull-down lists. Group Diagnostics Related Commands DIAg:NAMe:AREA? (see page 88), DIAg:NAMe:SUBSYS? (see page 89), DIAg:NAMe:TEST? (see page 90), DIAg:EXECUTE (see page 79) Syntax DIAg:SELect:ALL...
  • Page 98 DIAg:SELect:AREA Description This command (no query form) selects one of the available areas. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then selecting an Area from the pull-down list. Note: This command should be executed only if DIAg:LEVEL is currently set to AREA. Group Diagnostics Related Commands...
  • Page 99 DIAg:SELect:LAST Description This command (no query form) selects one or more diagnostic menu items to be executed via the DIAg:EXECUTE command. If you specify DIAg:LEVEL SUBSYS, then menu items come from this diagnostic level and are limited to the value returned by the DIAg:NUMITEMS? query. For example, specifying DIAg:SELECT:SUBSYS 2 and DIAg:NUMITEMS 5 indicates that diagnostics will start from subsystem 2 and that you can specify a range from 2 through 5 for DIAg:SELect:LAST.
  • Page 100 DIAg:SELect:SUBSYS Description This command (no query form) selects one of the available subsystems. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then choosing a Subsystem from the drop- down list. Note: This command should be executed only if DIAg:LEVEL is currently set to SUBSYS. Group Diagnostics Related Commands...
  • Page 101 DIAg:SELect:TEST Description This command (no query form) selects one of the available tests. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then choosing a Test from the drop-down list. Note: This command should be executed only if DIAg:LEVEL is currently set to TEST. Group Diagnostics Related Commands...
  • Page 102 DIAg:STATE Description This command (no query form) changes the oscilloscope operating state. Depending on the argument, diagnostics capabilities are either turned on or off. This command is equivalent to opening the DIAg:STATE dialog (ON) or closing it (OFF). Group Diagnostics Related Commands TEST:STOP (see page 105) Syntax...
  • Page 103 DIAg:STOP Description This command (no query form) causes diagnostics (or test) execution to terminate at the end of the next low-level test. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then clicking Abort. Group Diagnostics Related Commands TEST:STOP (see page 105) Syntax...
  • Page 104 TEST Description This command (no query form) provides the ability to select and execute an item at any level of the test hierarchy (Test, Area or Subsystem). This command is equivalent to selecting Instrument Diagnostics from the Utilities menu, choosing a test and then pressing Run. Note: Turning off both DIAg:CONTROL:HALT and DIAg:CONTROL:LOOP before executing the TEST command is recommended.

  • Page 105: Test Results

    TEST:RESults? Description This query-only command returns an abbreviated status about the results of the last TEST execution. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then reviewing the Diagnostic Status. Group Diagnostics Related Commands TEST (see page 102), TEST:RESults:VERBose? (see page 104) Syntax TEST:RESults? Example 1...
  • Page 106 TEST:RESults:VERBose? Description This query-only command returns a more explanatory message about the results of the last TEST execution than the TEST:RESults query. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then clicking the Error Log button. Group Diagnostics Related Commands...
  • Page 107 TEST:STOP Description This command (no query form) causes test (or diagnostics) execution to terminate at the end of the next low-level test. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then clicking Abort. Group Diagnostics Related Commands DIAg:STOP (see page 101) Syntax...
  • Page 108 ERRLOG CLEAR Description This command (no query form) deletes all entries in the log and zeroes the test sequence count. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu, clicking Error Log and then clicking Clear Log. Group Diagnostics Related Commands...
  • Page 109 ERRLOG:FIRST? Description This command query returns the first message in the error log. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then clicking the Error Log button. Group Diagnostics Related Commands ERRLOG CLEAR (see page 106), ERRLOG:NEXT? (see page 108), ERRLOG:NUMENTRIES? (see page 109) Syntax ERRLOG:FIRST?
  • Page 110 ERRLOG:NEXT? Description This command query returns the next message in the error log. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then clicking the Error Log button. Group Diagnostics Related Commands ERRLOG CLEAR (see page 106), ERRLOG:FIRST? (see page 107), ERRLOG:NUMENTRIES? (see page 109) Syntax ERRLOG:NEXT?
  • Page 111 ERRLOG:NUMENTRIES? Description This command query returns the total number of messages in the error log. This command is equivalent to selecting Instrument Diagnostics from the Utilities menu and then viewing the Error Log. Group Diagnostics Related Commands ERRLOG CLEAR (see page 106), ERRLOG:FIRST? (see page 107), ERRLOG:NEXT? (see page 108) Syntax ERRLOG:NUMENTRIES? Example...

  • Page 112: Display Control Command Group

    Display Control Command Group Display Overview You use the commands in the Display Control Command Group to change the graticule style, the displayed intensities, and to set the characteristics of the waveform display. You can set the following: • Background and foreground color as well as cursor, histogram, mask, and measurement annotation colors.
  • Page 113 Display Control Commands Command Description DISplay? Returns current display settings DISplay:CLOCk? Sets the display of the date/time stamp DISplay:CLOCk Returns the display of the date/time stamp DISplay:COLOr? Returns color group settings DISplay:COLOr:MATHCOLOR? Returns the color to be used for math traces DISplay:COLOr:MATHCOLOR Sets the color to be used for math traces...
  • Page 114 DISplay:PERSistence? Returns display persistence setting DISplay:PERSistence Sets display persistence setting DISplay:STYLE? Returns data display style DISplay:STYLE Sets data display style DISplay:TRIGBar? Returns the display setting of the trigger level indicator bar(s) DISplay:TRIGBar Sets the display of the trigger level indicator bar(s) DISplay:TRIGT? Returns the display setting of the trigger point indicator...
  • Page 115 DISplay? Description This query-only command returns the current display settings. This command is equivalent to selecting Display Setup from the Display menu and then viewing the contents of each tab. Group Display Control Syntax DISplay? Example DISplay? This query might return :DISPLAY:CLOCK 1 ;COLOR:PALETTE NORMAL;MATHCOLOR DEFAULT ;REFCOLOR DEFAULT;:DISPLAY:FILTER SINX;FORMAT YT ;GRATICULE FULL;INTENSITY:WAVEFORM 6.0000E+01...

  • Page 116: Display:clock

    DISplay:CLOCk Description This command sets or queries the display of the date and time. This is equivalent to selecting Display Date & Time from the Display menu. The query form of this command returns an ON (1) or an OFF (0). Group Display Control Syntax 1...

  • Page 117: Display Color

    DISplay:COLOr? Description This query-only command returns the settings from the PALETTE, MATHCOLOR and REFCOLOR commands. This is equivalent to selecting Colors from the Display menu. Group Display Control Syntax DISplay:COLOr? Arguments None. Example DISplay:COLOr? This query might return :DISPLAY:COLOR:PALETTE NORMAL;MATHCOLOR DEFAULT;REFCOLOR INHERIT...
  • Page 118 DISplay:COLOr:PALETTE Description This command sets or queries the palette to be used for trace display. This is equivalent to selecting Colors from the Display menu and choosing from the displayed color palette options. Group Display Control Related Commands DISplay:COLOr (see page 115), DISplay:COLOr:MATHCOLOr (see page 117), DISplay:COLOr:REFCOLOr (see page 118) Syntax 1 DISplay:COLOr:PALETTE {NORMal|MONOGREEN|MONOGRAY|TEMPErature|SPECTral}...
  • Page 119 DISplay:COLOr:MATHCOLOr Description This command sets or queries the color to be used for math traces, either in the palette's nominal Math color, or according to the color of the source waveform. This command is equivalent to selecting Display Setup from the Display menu and then choosing the Colors tab. Group Display Control Related Commands...
  • Page 120 DISplay:COLOr:REFCOLOr Description This command sets or queries the color to be used for reference traces, either in the palette's nominal REF color or according to the color of the source waveform. This command is equivalent to selecting Display Setup from the Display menu and then choosing the Colors tab. Group Display Control Related Commands...

  • Page 121: Display:filter

    DISplay:FILTer Description This command sets or queries the type of interpolation to use for the display. Filtering only applies to normal-mode acquisition. DPO never interpolates. The DISplay:FILTer command also provides selection for acquisition interpolation type. This command is equivalent to selecting Waveform Interpolation from the Display menu.

  • Page 122: Display Format

    DISplay:FORMat Description This command sets or queries the display format. This command is equivalent to setting Format from the Display menu. Group Display Control Syntax 1 DISplay:FORMat {YT|XY|XYZ} Syntax 2 DISplay:FORMat? Arguments • YT This sets the display to a voltage versus time format and is the normal mode. •...

  • Page 123: Display:graticule

    DISplay:GRATicule Description This command selects or queries the type of graticule that is displayed. This command is equivalent to selecting Graticule Style from the Display menu. Group Display Control Syntax 1 DISplay:GRAticule {CROSSHair|FRAme|FULl|GRId} Syntax 2 DISplay:GRAticule? Arguments • CROSSHair This specifies a frame and cross hairs. •...

  • Page 124: Display:intensity

    DISplay:INTENSITy? Description This query-only command returns the waveform saturation level, autobright state and screensaver settings. This command is equivalent to selecting Display Setup from the Display menu and then choosing the Appearance tab. Group Display Control Related Commands DISplay:INTENSITy:AUTOBright (see page 123), DISplay:INTENSITy:WAVEform (see page 124), DISplay:INTENSITy:SCREENSAVER (see page 125), DISplay:INTENSITy:SCREENSAVERDELAY (see page 126) Syntax...
  • Page 125 DISplay:INTENSITy:AUTOBright Description This command enables automatic, ongoing adjustment of the hi-res to 4-bit-display mapping transform for converting DPO or RecordVu images to display images. The query form returns an ON (1) or OFF (0). This command is equivalent to selecting Display Setup from the Display menu and then choosing the Appearance tab.
  • Page 126 DISplay:INTENSITy:WAVEform Description This command sets or queries the intensity saturation of the waveforms. This command is equivalent adjusting the INTENSITY knob on the front panel. Group Display Control Related Commands DISplay:INTENSITy:AUTOBright (see page 123) Syntax 1 DISplay:INTENSITy:WAVEform <NR1> Syntax 2 DISplay:INTENSITy:WAVEform? Arguments •...
  • Page 127 DISplay:INTENSITy:SCREENSAVER Description This command sets and queries the screen protection features of the underlying MS Windows operating system. When enabled, a delay timer (set in seconds by the DISplay:INTENSITy:SCREENSAVERDELAY command) begins counting down. When this screensaver delay times out, the screen low-power mode engages. This causes the LCD backlight to switch off and clears both waveform and text displays.
  • Page 128 DISplay:INTENSITy:SCREENSAVERDELAY Description This command sets or queries the timeout of the screen protection features of the display system. When enabled (after the specified screen saver delay seconds of control activity and when the screensaver feature is enabled) the instrument activates the screensaver feature. Normal scope displays are restored and the delay timer is reset upon any control activity.

  • Page 129: Display:persistence

    DISplay:PERSistence Description This command sets or queries the persistence aspect of the display. This affects the display only and is equivalent to selecting Display Persistence from the Display menu. Group Display Control Related Commands DISplay:VARPersist (see page 131) Syntax 1 DISplay:PERSistence {OFF|INFPersist|VARPersist} Syntax 2 DISplay:PERSistence?

  • Page 130: Display:style

    DISplay:STYle Description This command sets or queries how the data is displayed for normal and FastAcq modes. This command is equivalent to setting Display Style from the Display menu. Group Display Control Syntax 1 DISplay:STYle {VECtors|DOTs|INTENSIFied} Syntax 2 DISplay:STYle? Arguments •...
  • Page 131 DISplay:TRIGBar Description This command controls or queries the display of the trigger-level indicator bar/s. Indicator bars show where the trigger voltage level is set. The oscilloscope will only display the bar if the associated trigger source is also displayed. If both a main and a delayed trigger are displayed, then two bars will appear.
  • Page 132 DISplay:TRIGT Description This command controls or queries the display of the trigger point indicator. This is equivalent to selecting Objects from the Display menu. The query form returns an ON (1) or an OFF (0). Group Display Control Syntax 1 DISplay:TRIGT {ON|OFF|<NR1>} Syntax 2 DISplay:TRIGT?
  • Page 133 DISplay:VARPersist Description This command sets or queries persistence decay time, which is the approximate decay time for a freshly struck persistence sample. This command is equivalent to selecting Display Setup from the Display menu, selecting the Appearance tab and then entering the desired Persist Time. Group Display Control Related Commands...

  • Page 134: File System Command Group

    File System Command Group File System Overview You use the commands in the File System Command Group to help you use the built-in hard disk drive and floppy disk drive. You can use the commands to do the following: • List the contents of the default directory •...

  • Page 135: File System Commands

    File System Commands Command Description FILESystem? Returns the file system state FILESystem:COPy Copies one or more files to a new file FILESystem:DELEte Deletes a named file or directory FILESystem:DIR? Returns a list of directory contents FILESystem:MKDir Makes a new directory FILESystem:PRInt Prints a named file to the named port FILESystem:READFile...

  • Page 136: File System

    FILESystem? Description This query-only command returns the state of the file system. Group File System Related Commands FILESystem:COPy (see page 135), FILESystem:DELEte (see page 136), FILESystem:DIR? (see page 137), FILESystem:PRInt (see page 139), FILESystem:READFile (see page 140), FILESystem:REName (see page 141), FILESystem:WRITEFile (see page 143) Syntax FILESystem? Arguments...
  • Page 137 FILESystem:COPy Description This command (no query form) copies a named file or files to a new file. The new file may be in a totally separate directory than the old file. Also, you can use wild card characters (*.*) to copy multiple files with one command.
  • Page 138 FILESystem:DELEte Description This command (no query form) deletes a named file or directory. Group File System Related Commands FILESystem:COPy (see page 135) Syntax FILESystem:DELEte <file path> Arguments • <file path> This is a quoted string that defines the file name and path. Input the file path using the form <drive>/<dir>/<filename>.<drive>...
  • Page 139 FILESystem:DIR? Description This query-only command returns a list quoted string. Each string contains the name of a file or directory in the current directory. Group File System Related Commands FILESystem:MKDir (see page 138) Syntax FILESystem:DIR? Arguments None. Example FILESystem:DIR? This query returns a list of files and directories in the default directory.
  • Page 140 FILESystem:MKDir Description This command (no query form) creates a new directory. Group File System Related Commands FILESystem:DIR? (see page 137) Syntax FILESystem:MKDir <directory path> Arguments • <directory path> This is a quoted string that defines the directory. Input the directory using the form <drive>/<dir>/<directory name>.<drive>...
  • Page 141 FILESystem:PRInt Description This command (no query form) prints a named file to a named port. Group File System Related Commands FILESystem:READFile (see page 140) Syntax FILESystem:PRInt <filepath>, GPIb Arguments • <file path> This is a quoted string that defines the file name and path. Input the file path using the form <drive>/<dir>/<filename>.<drive>...
  • Page 142 FILESystem:READFile Description This command (no query form) copies a named file to the GPIB port. Group File System Related Commands FILESystem:PRInt (see page 139) Syntax FILESystem:READFile <filepath> Arguments • <file path> This is a quoted string that defines the file name and path. Input the file path using the form <drive>/<dir>/<filename>.<drive>...
  • Page 143 FILESystem:REName Description This command (no query form) assigns a new name to an existing file. Group File System Syntax FILESystem:REName <old file path>,<new file path> Arguments • <old file path> This is a quoted string that defines the file to rename. Input the file path using the form <drive>/<dir>/<filename>.<drive>...
  • Page 144 FILESystem:RMDir Description This command (no query form) deletes a named directory. The directory and all of the files and subdirectories it contains are deleted. Group File System Syntax FILESystem:RMDir <directory path> Arguments • <directory path> This is a quoted string that defines the directory. Input the directory using the form <drive>/<dir>/<directory name>.<drive>...
  • Page 145 FILESystem:WRITEFile Description This command (no query form) copies the GPIB port block data to a named file. Group File System Syntax FILESystem:WRITEFile <file path>,<data> Arguments • <file path> This is a quoted string that defines the file name and path. Input the file path using the form <drive>/<dir>/<filename>.<drive>...

  • Page 146: Hard Copy Command Group

    Hard Copy Command Group Hard Copy Overview Hard copy commands enables you to make hard copies of data files or send the data to a specified file. In addition, these commands provide you with information about (and the ability to set) file path settings.

  • Page 147: Hard Copy Commands

    Hard Copy Commands Command Description HARDCopy? Returns format, layout, and port information HARDCopy Sends a screen copy that can either be stored or printed HARDCopy:FILEName? Returns the hardcopy file path HARDCopy:FILEName Sets the hardcopy file path HARDCopy:PORT? Returns the data format that will be used on the next hardcopy command HARDCopy:PORT Sets whether the data will be sent to a file or...
  • Page 148 HARDCopy Description This command sends a copy of the screen display followed by an EOI to the port specified by HARDCopy:PORT. The format and layout of the output is specified with the HARDCopy:FORMat and HARDCopy:LAYout commands. This command is equivalent to pressing the PRINT button on the front panel.
  • Page 149 HARDCopy:FILEName Description This command sets or returns the file that will be sent hardcopy data on the next HARDCopy command. Group Hardcopy Related Commands HARDCopy (see page 146) Syntax 1 HARDCopy:FILEName <file path> Syntax 2 HARDCopy:FILEName? Argument • <file path> This specifies that the hardcopy is sent to the named file.
  • Page 150 HARDCopy:PORT Description This command selects or returns whether the hardcopy data will be sent to a file or printed on the next hardcopy command (i.e. HARDCopy STARt command). This is equivalent to selecting Print in the File menu and then either choosing Print to file or specifying the default printer. Group Hardcopy Related Commands...

  • Page 151: Histogram Command Group

    Histogram Command Group Histogram Overview Histogram commands let you select the type of histogram, what part of the waveform should go into the histogram, and histogram statistics. You can use commands from this group to do the following: • Create a histogram of vertical or horizontal values for a channel, math or reference waveform •...

  • Page 152: Histogram Commands

    Histogram Commands Command Description HIStogram? Return all histogram parameters HIStogram:BOX? Returns the left, top, right, and bottom positions of the histo box, in source waveform coordinates HIStogram:BOX Sets the left, top, right, and bottom positions of the histo box, in source waveform coordinates HIStogram:BOXPcnt? Returns same as HIStogram:BOX, but in percentage coordinates, with 0,0 upper left and...
  • Page 153 HIStogram? Description This query-only command returns all histogram parameters; it queries the state of all histogram parameters that the user can set. This command is equivalent to selecting Waveform Histograms from the Measure menu. Group Histogram Related Commands MEASUrement:METHod (see page 258) Syntax 1 HIStogram? Arguments...
  • Page 154 HIStogram:Box Description This command defines or returns the left, top, right, and bottom boundaries of the histogram box, in source waveform coordinates. This command is equivalent to selecting Waveform Histograms from the Measure menu and then setting Limits for Left, Right, Top, and Bottom in the appropriate boxes. This command is similar to the HIStogram:BOXPcnt command except that command uses percentage coordinates to define the boundaries of the histogram box.
  • Page 155 HIStogram:BOXPcnt Description This command defines or queries the left, top, right, and bottom positions of the histogram box, in percentage coordinates. The upper left has the value 0,0 and the lower right has the value 100, 100. Any value outside the range of 0 to 100 is clipped. This command is similar to the HIStogram:Box command except that this command uses percentage coordinates to define the boundaries of the histogram box.
  • Page 156 HIStogram:COUNt Description This command (no query form) clears the count and statistics for the histogram and the histogram source data. If the histogram is on, then counting restarts. This command is equivalent selecting Waveform Histograms from the Measure menu and then clicking the Reset button. Group HIStogram Related Commands...

  • Page 157: Histogram Display

    HIStogram:DISplay Description This command sets the format of the histogram displayed or whether the histogram is displayed. The query form of this command either returns the histogram display format or that histogram display is disabled. This command is equivalent to selecting Waveform Histogram from the Measure menu and then ensuring that Display is set to On.
  • Page 158 HIStogram:FUNCtion Description This command either selects the type of histogram to create or returns the current histogram type. This command is equivalent to selecting Waveform Histogram from the Measure menu and then choosing either Horizontal or Vertical from the Histogram Mode group box. Group HIStogram Related Commands...

  • Page 159: Histogram:mode

    HIStogram:MODe Description This command selects the type of histogram to create or disables the histogram display. The query form of this command query returns the current histogram type or that histogram display functionality is disabled. This command is equivalent to selecting Waveform Histogram from the Measure menu and then choosing from the Histogram Mode group box.

  • Page 160: Histogram:size

    HIStogram:SIZe Description This command sets or queries the width or height of the histogram on the screen. This is equivalent to selecting Waveform Histograms from the Measure menu and then entering a value in the Histo Size box. Group HIStogram Related Commands HIStogram:DISplay (see page 155) Syntax 1...
  • Page 161 HIStogram:SOUrce Description This command sets or queries which source will be compared against the histogram box when the histogram testing is enabled. This is equivalent to selecting Waveform Histograms from the Measure menu and then choosing the desired waveform source. The waveform need not be displayed for histograms to run.
  • Page 162 HIStogram:STATE Description This command sets or queries whether the histogram calculations are enabled. This is equivalent to selecting Waveform Histograms from the Measure menu. Group HIStogram Related Commands HIStogram:MODe (see page 157), MEASUrement:METHod (see page 258) Syntax 1 HIStogram:STATE {ON|OFF|NR1} Syntax 2 HIStogram:STATE? Arguments...

  • Page 163: Horizontal Command Group

    • Enable or disable the display of the time base You may substitute SECdiv for SCAle in the horizontal commands. This provides program compatibility with earlier models of Tektronix oscilloscopes. Horizontal Fastframe (also known as memory segmentation) commands are designed for situations where you want to capture a series of triggered acquisitions with minimal dead time between them.

  • Page 164: Horizontal Commands

    Horizontal Commands Command Description HORizontal? Returns all learnable settings for the horizontal commands HORizontal:DIVisions? Returns the number of graticule divisions over which the waveform is displayed HORizontal:FASTframe:COUNt? Returns FastFrame frame count HORizontal:FASTframe:COUNt Sets FastFrame frame count HORizontal:FASTframe:LENgth? Returns the horizontal record length per frame HORizontal:FASTframe:LENgth Sets the horizontal record length to...
  • Page 165 within the specified waveform HORizontal:FASTframe:TRACk? Returns the state of the FastFrame tracking feature HORizontal:FASTframe:TRACk Sets the FastFrame tracking feature HORizontal:MAIn? Returns the time per division of the main time base HORizontal[:MAIn]:DELay:POSition? Returns the main time base position when Horizontal Delay Mode is turned off HORizontal[:MAIn]:DELay:POSition Sets the main time base position...
  • Page 166 delay HORizontal:MAIn:UNIts:VALue Sets the unit value for the horizontal main time base trigger delay HORizontal:POSition? Returns the waveform's horizontal position on the display HORizontal:POSition Positions the waveform horizontally on the display HORizontal:RECOrdlength? Returns the current horizontal record length HORizontal:RECOrdlength Sets the horizontal record length to the number of data points in each frame HORizontal:RESOlution?
  • Page 167 HORizontal? Description This query-only command returns all learnable settings for the horizontal commands. Group HORizontal Syntax HORizontal? Example HORizontal? This query might return :HORIZONTAL:DELAY:MODE 1 ;POSITION 5.0000E+01;TIME 0.0000E+00; :HORIZONTAL:MAIN:SCALE 2.0000E-07;POSITION 5.0000E+01 ;UNITS:VALUE 1.0000E+00;STRING "s";OFFSET 0.0000E+00; :HORIZONTAL:RECORDLENGTH 5000;ROLL AUTO;FASTFRAME:STATE 0 ;LENGTH 5000;COUNT 2;SELECTED:CH1 2;CH2 2;CH3 2;CH4 2 ;MATH1 2;MATH2 2;MATH3 2;MATH4 2;REF1 2;REF2 2;REF3 2 ;REF4 2;:HORIZONTAL:FASTFRAME:REF:SOURCE CH1;FRAME 1;...
  • Page 168 HORizontal:DIVisions? Description This query-only command returns the number of graticule divisions over which the waveform is displayed. Group Horizontal Syntax HORizontal:DIVisions? Arguments None. Example HORizontal:DIVisions? This query might return :HORIZONTAL:DIVISIONS 1.0000E-01, indicating that the waveform is displayed across one division.
  • Page 169 HORizontal:FASTframe:COUNt Description This command sets or queries FastFrame frame count. This is equivalent to selecting FastFrame Setup from the Horiz/Acq menu and entering a value in the Frame Count box. FastFrame, also known as memory segmentation, captures a series of triggered acquisitions with minimal intervening time. This command is equivalent to selecting Fast Frame Setup from the Horiz/Acq menu and entering a value in the Frame Count box.
  • Page 170 HORizontal:FASTframe:REF:FRAME Description This command sets or queries the FastFrame reference frame number. The Reference Frame number is used to calculate time differences for each frame and displays those differences in the graticule. This command is equivalent to selecting FastFrame Setup in the Horiz/Acq menu and entering a value in the Time Stamps/Frame box.
  • Page 171 HORizontal:FASTframe:LENgth Description This command sets or queries the horizontal record length to the number of sample points in each frame. This command is equivalent to selecting FastFrame Setup from the Horiz/Acq menu and entering a value in the Rec Length box. FastFrame, also known as memory segmentation, captures a series of triggered acquisitions with minimal intervening time between them.
  • Page 172 HORizontal:FASTframe:REF:SOUrce Description This command sets or queries FastFrame Reference waveform source. This is equivalent to selecting FastFrame Setup from the Horiz/Acq menu and choosing the reference source. Group Horizontal Related Commands HORizontal:FASTframe:REF:FRAme (see page 168), HORizontal:FASTframe:TIMEstamp:DELTa:<wfm>? (see page 175), HORizontal:FASTframe:TIMEstamp:REF? (see page 177), HORizontal:FASTframe:TRACk (see page 179) Syntax 1 HORizontal:FASTframe:REF:SOUrce <wfm>...
  • Page 173 HORizontal:FASTframe:SELECTED:<wfm> Description This command sets or returns the FastFrame Selected frame number on the specified waveform. This is equivalent to selecting FastFrame Setup from the Horiz/Acq menu and then choosing the waveform source and frame. Valid waveforms include CH<x>, MATH<x> and REF<x>; the x variable can be expressed as an integer ranging from 1 through 4.
  • Page 174 HORizontal:FASTframe:STATE Description This command sets or returns the state of FastFrame acquisition. This is equivalent to setting FastFrame On in the FastFrame Setup menu. FastFrame, also known as memory segmentation, lets users capture a series of triggered acquisitions with minimal time between them. The digitizing oscilloscope in FastFrame mode is ready to accept a continuous burst of triggers 400 ms after the controller sends the ACQuire:STATE RUN command.
  • Page 175 HORizontal:FASTframe:TIMEStamp:ALL:<wfm>? Description This query-only command returns the frame number and time stamp for each frame between requested frames, inclusive, within the specified waveform. Argument order is unimportant. Valid waveforms include CH<x>, MATH<x> and REF<x>; the x variable can be expressed as an integer ranging from 1 through 4. Group Horizontal Syntax...
  • Page 176 HORizontal:FASTframe:TIMEStamp:BETWeen:<wfm>? Description This query-only command returns the relative trigger for the delta time between the specified frames, within the specified waveform. Valid waveforms include CH<x>, MATH<x> and REF<x>; the x variable can be expressed as an integer ranging from 1 through 4. Group Horizontal Syntax...
  • Page 177 HORizontal:FASTframe:TIMEStamp:DELTa:<wfm>? Description This query-only command returns the relative time between the triggers of the FastFrame Selected and the FastFrame Reference, within the specified waveform. Valid waveforms include CH<x>, MATH<x> and REF<x>; the x variable can be expressed as an integer ranging from 1 through 4. Group Horizontal Syntax...
  • Page 178 HORizontal:FASTframe:TIMEStamp:FRAME:<wfm>? Description This query-only command returns the absolute trigger date and time for the specified frame and waveform. Valid waveforms include CH<x>, MATH<x> and REF<x>; the x variable can be expressed as an integer ranging from 1 through 4. Group Horizontal Syntax HORizontal:FASTframe:TIMEStamp:FRAME:<wfm>? <NR1>...
  • Page 179 HORizontal:FASTframe:TIMEStamp:REF? Description This query-only command returns the absolute trigger date and time for FastFrame reference. Group Horizontal Related Commands HORizontal:FASTframe:REF:FRAme (see page 168), HORizontal:FASTframe:REF:SOUrce (see page 170) Syntax HORizontal:FASTframe:TIMEStamp:REF? Example HORizontal:FASTframe:TIMEStamp:REF? This query might return :HORIZONTAL:FASTFRAME:TIMESTAMP:REF "02 Mar 2000 20:10:54.533 036 838 784", which is the time stamp of FastFrame Reference.
  • Page 180 HORizontal:FASTframe:TIMEStamp:SELECTED:<wfm>? Description This query-only command returns the absolute trigger date and time for the FastFrame Selected, within the specified waveform. Valid waveforms include CH<x>, MATH<x> and REF<x>; the x variable can be expressed as an integer ranging from 1 through 4. Group Horizontal Related Commands...
  • Page 181 HORizontal:FASTframe:TRACk Description This command sets up or returns the state of FastFrame tracking feature. This command is equivalent to selecting FastFrame Setup from the Horiz/Acq menu and then clicking the desired Frame Tracking state. When FastFrame Track is set to "live", the channel and math waveforms are locked together. Adjusting a channel waveform also adjusts a related math waveform.
  • Page 182 HORizontal:MAIn? Description This query-only command returns the time per division of the time base. This command is equivalent to selecting Position/Scale from the Horiz/Acq menu. Group Horizontal Related Commands HORizontal:SCAle (see page 195) Syntax HORizontal:MAIn? Example HORizontal:MAIn? This query might return :HORIZONTAL:MAIN:SCALE 1.0000E-04;POSITION 5.0000E+01;UNITS:VALUE 1.0000E+00;STRING "s";OFFSET 0.0000E+01...
  • Page 183 HORizontal[:MAIn]:POSition This command either positions the waveform horizontally on the display or returns the horizontal position on the display and is identical to the HORizontal:POSition command. When Horizontal Delay mode is turned off, this command is equivalent to adjusting the HORIZONTAL POSITION knob on the front-panel. When Horizontal Delay mode is turned on, this command is equivalent to selecting Horizontal/Acquisition from the Horiz/Acq menu and then choosing a Horizontal Ref Point value.
  • Page 184 HORizontal[:MAIn]:SCAle Description This command sets the time per division for the time base or returns its horizontal scale on the display and is identical to the HORizontal:SCAle command. The specified scale value is rounded to a valid scale setting. This command is equivalent to selecting Position/Scale from the Horiz/Acq menu and then choosing a Scale value.
  • Page 185 HORizontal[:MAIn]:DELay:POSition Description This command sets or queries the time base position when Horizontal Delay Mode is turned on. This command is equivalent to selecting Horizontal/Acquisition Setup from the Horiz/Acq menu and then entering a Ref Point value. Group Horizontal Related Commands HORizontal[:MAIn}:DELay:TIMe (see page 183) Syntax 1 HORizontal[:MAIn]:DELay:POSition <NR3>...
  • Page 186 HORizontal[:MAIn]:DELay:MODe Description This command sets or queries the time base trigger delay mode. This command is equivalent to choosing Delay Mode On from the Horiz/Acq menu. Group Horizontal Related Commands HORizontal[:MAIn]:DELay:TIMe (see page 185) Syntax 1 HORizontal[:MAIn]:DELay:MODe [ON|OFF|<NR1>] Syntax 2 HORizontal[:MAIn]:DELay:MODe? Arguments •...
  • Page 187 HORizontal[:MAIn]:DELay:TIMe Description This command sets or queries the time base trigger delay time. This command is equivalent to selecting Position/Scale from the Horiz/Acq menu and choosing a value for Horiz Delay. Group Horizontal Related Commands HORizontal[:MAIn]:DELay:MODe (see page 184), HORizontal[:MAIn]:DELay:POSition (see page 183) Syntax 1 HORizontal[:MAIn]:DELay:TIMe <NR3>...
  • Page 188 HORizontal:MAIn:SAMPLERate Description This command sets the horizontal sample rate to the desired number of samples per second. The record length is automatically adjusted at the same time to maintain a constant number of data points in each frame. The query form of this command returns the current horizontal sample rate. This command is equivalent to selecting Horizontal/Acquisition Setup from the Horiz/Acq menu and then entering the desired Sample Rate.
  • Page 189 HORizontal:MAIn:UNIts Description This command sets or returns the units for the horizontal time base. It is equivalent to separately setting the following commands: • HORizontal:MAIn:UNIts:VALue • HORizontal:MAIn:UNIts:STRing • HORizontal:MAIn:UNIts:OFFSet Group Horizontal Related Commands HORizontal:MAIn:UNIts:VALue (see page 190), HORizontal:MAIn:UNIts:STRing (see page 189), HORizontal:MAIn:UNIts:OFFSet (see page 188) Syntax 1 HORizontal:MAIn:UNIts <NR3>...
  • Page 190 HORizontal:MAIn:UNIts:OFFset Description This command sets or returns the offset units for the horizontal time base trigger delay. Group Horizontal Related Commands HORizontal:MAIn:UNIts (see page 187) Syntax 1 HORizontal:MAIn:UNIts:OFFSet <NR3> Syntax 2 HORizontal:MAIn:UNIts:OFFSet? Argument • <NR3> This is the time base unit offset. Example 1 HORizontal:MAIn:UNIts:OFFSet 2.9 This command sets the horizontal time base trigger delay offset units to 2.9 s.
  • Page 191 HORizontal:MAIn:UNIts:STRing Description This command sets or returns the units string for the horizontal time base trigger delay. Group Horizontal Related Commands HORizontal:MAIn:UNIts (see page 187) Syntax 1 HORizontal:MAIn:UNIts <STRing> Syntax 2 HORizontal:MAIn:UNIts:STRing? Argument • <STRing> This is the time base units string. Example 1 HORizontal:MAIn:UNIts:STRing lum This command sets the units string for the time base trigger delay to lumens.
  • Page 192 HORizontal:MAIn:UNIts:VALue Description This command sets or returns the unit value for the horizontal time base trigger delay. Group Horizontal Related Commands HORizontal:MAIn:UNIts (see page 187) Syntax 1 HORizontal:MAIn:UNIts:VALue <NR3> Syntax 2 HORizontal:MAIn:UNIts:VALue? Argument • <NR3> This is the time base unit value. Example 1 HORizontal:MAIn:UNIts:VALue 5.5 This command sets the unit value for the time base trigger delay to 5.5.

  • Page 193: Horizontal Position

    HORizontal:POSition Description This command either positions the waveform horizontally on the display or returns its horizontal position on the display. When Horizontal Delay Mode is turned off, this command is equivalent to adjusting the HORIZONTAL POSITION knob on the front panel. Group Horizontal Related Commands...
  • Page 194 HORizontal:RECOrdlength Description This command sets the horizontal record length to the number of data points in each frame. The query form of this command returns the current horizontal record length. This command is equivalent to selecting Resolution from the Horiz/Acq menu and then entering the desired Rec Length. Group Horizontal Syntax 1...

  • Page 195: Horizontal:resolution

    HORizontal:RESOlution Description This command sets the horizontal record length to the number of data points in each frame. The sample rate is automatically adjusted at the same time to maintain a constant time per division. The query form of this command returns the current horizontal record length. This command is equivalent to adjusting the RESOLUTION knob on the front panel.
  • Page 196 HORizontal:ROLL Description This command sets or queries the Roll Mode status. Use Roll Mode when you want to view data at very slow sweep speeds. It is useful for observing data samples on the screen as they occur. This command is equivalent to selecting Horizontal/Acquisition Setup from the Horiz/Acq menu, selecting the Acquisition tab and then choosing the desired Roll Mode.

  • Page 197: Horizontal:scale

    This command sets or queries the time per division for the time base and is identical to the HORizontal:MAIn:SCAle command. It is provided to maintain program compatibility with some older models of Tektronix oscilloscopes. This command is equivalent to selecting Position/Scale from the Horiz/Acq menu and then entering the desired Scale value.

  • Page 198: Horizontal:trigger:position

    This command sets or queries the position of the trigger and is identical to the HORizontal:MAIn:POSition command. It is provided to maintain program compatibility with some older models of Tektronix oscilloscopes. This command is equivalent to selecting Position/Scale from the Horiz/Acq menu and then entering the desired Position.

  • Page 199: Math Command Group

    Math Command Group Math Overview You use the commands in the Math Command Group to create and define math waveforms. You can define and display up to four math waveforms simultaneously. Use the available math functions to define your math waveform. The math waveform you create depends on sources listed in the math expression.

  • Page 200: Math Commands

    Math Commands Command Description MATH<x>? Returns the specified math waveform settings MATH<x>:DEFine? Returns the math<x> definition for the specified waveform MATH<x>:DEFine Sets the math<x> waveform definition MATH<x>:LABEL:NAMe? Returns the label string used for annotating the displayed math waveform MATH<x>:LABEL:NAMe Sets the label string used for annotating the displayed math waveform MATH<x>:LABEL:XPOS? Returns the X screen offset where the math...
  • Page 201 MATH<x>:SPECTral:MAG? Returns the units of the SpectralMag function in the specified math string MATH<x>:SPECTral:MAG Sets the units of the SpectralMag function in the specified math string MATH<x>:SPECTral:PHASE? Returns the units of the SpectralPhase function in the specified math string MATH<x>:SPECTral:PHASE Sets the units of the SpectralPhase function in the specified math string MATH<x>:SPECTral:REFLEVEL?
  • Page 202 MATH<x>? Description This query-only command returns the definition for the math waveform specified by <x>, which ranges from 1 through 4. Group Math Related Commands SELect:<wfm> (see page 460) Syntax MATH<x>? Example MATH1? This query might return :MATH1 DEFINE "PROBE POINT7" ;NUMAVG 2;SCALE 1.0000E+00;POSITION 0.0000E+00 ;LABEL:NAME "Math1";XPOS 5;YPOS 65;;MATH1:SPECTRAL:MAG DB ;PHASE DEGREES;GATEPOS 0.0000E+00;GATEWIDTH 1.9996E-06...
  • Page 203 MATH<x>:DEFIne Description This command allows you to define new waveforms using mathematical expressions. Sending this command is equivalent to selecting Math Setup from the Math menu, selecting a math waveform (Math 1 through Math 4) and then entering a math expression in the Math<x> box. The query form of this command returns the math definition for the specified math waveform.
  • Page 204 MATH<x>:LABEL:NAMe Description This command sets or returns the label string, which is used for annotating the math waveform on the screen. This command is equivalent to selecting Math Setup from the Math menu and then entering a label in the Label box. Group Math Syntax 1...
  • Page 205 MATH<x>:LABEL:XPOS Description This command sets or queries the X screen offset at which the label attached to the displayed math waveform is displayed, relative to the left edge of the screen. Channels are specified by x, which ranges from 1 through 4. This command is equivalent to selecting Math Label from the Math menu and entering a value in the X Position box.
  • Page 206 MATH<x>:LABEL:YPOS Description This command sets or queries the Y screen offset at which the label attached to the displayed math waveform is displayed, relative to the top edge of the screen. Channels are specified by x, which ranges from 1 through 4. This command is equivalent to selecting Math Label from the Math menu and entering a value in the Y Position box.
  • Page 207 MATH<x>:NUMAVg Description This command sets or returns the acquisition number at which the averaging algorithm will begin exponential averaging. Prior to that acquisition number, the algorithm uses stable averaging. This has no affect unless the AVG() function is used in the specified math. If so, it affects all AVG() functions in this math.
  • Page 208 MATH<x>:POSition Description This command sets or queries the vertical position of the specified Math waveform. The Math waveform is specified by x, which can range from 1 through 4. The position value is usually applied to the signal before it is digitized. The highest three units/div scale ranges of a given math are implemented by changing the way the acquired data is displayed.
  • Page 209 MATH<x>:SCAle Description This command sets or queries the vertical scale of the specified math waveform. The math waveform is specified by x, which can range from 1 through 4. This command is equivalent to selecting Position/Scale from the Math menu and then entering a Vert Scale value or adjusting the front-panel Vertical SCALE knob.
  • Page 210 MATH<x>:SPECTral? Description This query-only command returns the current spectral setups for the specified math waveform. This command is equivalent to selecting Spectral Setup from the Math menu and viewing the current spectral setup values. Group Math Syntax MATH<x>:SPECTral? Example MATH1:SPECTral? This query might return :MATH1:SPECTRAL:MAG DB;PHASE DEGREES ;GATEPOS 0.0000E+00;GATEWIDTH 1.9996E-06;REFLEVEL 4.4587+01...
  • Page 211 MATH<x>:SPECTral:CENTER Description This command specifies or returns the center frequency of the spectral analyzer output data span. This command is equivalent to selecting Spectral Setup from the Math menu and then entering a Center Freq value. Group Math Related Commands MATH<x>:SPECTral:SPAN (see page 218) Syntax 1 MATH<x>:SPECTral:CENTER <NR3>...
  • Page 212 MATH<x>:SPECTral:GATEPOS Description This command sets or returns the position of the center of the gate, which is used as the data input to the spectral analyzer. This command is equivalent to selecting Spectral Setup from the Math menu and then entering a Gate Pos value.
  • Page 213 MATH<x>:SPECTral:GATEWIDTH Description This command sets or returns the gate width input, in seconds, to the spectral analyzer. This command is equivalent to selecting Spectral Setup from the Math menu and then entering a value in the Duration box. This command is equivalent to selecting Spectral Setup from the Math menu and then entering a Gate Dur value.
  • Page 214 MATH<x>:SPECTral:LOCk Description This command locks menus for Math<x> and Math<y> together as a group. The query form of this command returns an ON (1) or OFF (0), indicating whether spectral locking is turned on. This command is equal to selecting Spectral Setup from the Math menu, choosing the Control tab and then clicking the Time/Track Frequency Domain Controls button associated with the math waveforms that you want to lock.
  • Page 215 MATH<x>:SPECTral:MAG Description This command controls or returns the units of a SpectralMag function in the math string. This command is equal to selecting Spectral Setup from the Math menu, choosing the Mag tab and then clicking the desired Scale button. Group Math Related Commands...
  • Page 216 MATH<x>:SPECTral:PHASE Description This command controls or returns the units of a SpectralPhase function in the math string. This command is equal to selecting Spectral Setup from the Math menu, choosing the Phase tab and then clicking the desired Scale button. Group Math Related Commands...
  • Page 217 MATH<x>:SPECTral:REFLevel Description This command specifies the vertical position of the output data from the spectral analyzer on the display screen. The numerical value represents the position at the top of the display graticule. This command is equal to selecting Spectral Setup from the Math menu, choosing the Mag tab and then entering a value in the Reference Level box.
  • Page 218 MATH<x>:SPECTral:REFLEVELOffset Description This command sets or returns the spectral level offset used for calculating the dB value. Changing the reference level offset causes the spectral waveform to move vertically, with respect to zero dB. This command is equal to selecting Spectral Setup from the Math menu, choosing the Mag tab and then entering a value in the Reference Level Offset box.
  • Page 219 MATH<x>:SPECTral:RESBw Description This command sets or returns the resolution bandwidth of the spectral analyzer. This command is equivalent to selecting Spectral Setup from the Math menu and then entering a value in the Res BW box. Group Math Related Commands MATH<x>:SPECTral:GATEWIDTH (see page 211), MATH<x>:SPECTral:CENTER (see page 209), MATH<x>:SPECTral:SPAN (see page 218), MATH<x>:SPECTral:WINdow (see page 221) Syntax 1...
  • Page 220 MATH<x>:SPECTral:SPAN Description This command sets the ceiling of the span to a value that is closest to the specified value. The query form of this command returns the current span value of the specified math waveform. This command is equal to selecting Spectral Setup from the Math menu and then entering a value in the Freq Span box. Group Math Related Commands...
  • Page 221 MATH<x>:SPECTral:SUPPress Description This command sets or returns the phase suppression threshold. This command is equal to selecting Spectral Setup from the Math menu, choosing the Phase tab and then entering a value in the Suppression Threshold box. Group Math Related Commands MATH<x>:SPECTral:UNWRap (see page 220) Syntax 1 MATH<x>:SPECTral:SUPPress <NR3>...
  • Page 222 MATH<x>:SPECTral:UNWRap Description This command specifies or returns whether or not phase unwrap of the spectral analyzer output data is enabled. This command is equal to selecting Spectral Setup from the Math menu, choosing the Phase tab and then clicking the Unwrap button. Group Math Related Commands...
  • Page 223 MATH<x>:SPECTral:WINdow Description This command sets or returns the window function used to multiply the spectral analyzer input data. A spectral window determines what the filter shape of the spectral analyzer will be in the frequency domain. It can be described by a mathematical function that is multiplied point-by-point times the input data to the spectral analyzer.

  • Page 224: Measurement Command Group

    Measurement Command Group Measurement Overview You use the commands in the Measurement Command Group to control the automated measurement system. Up to eight automated measurements can be displayed on the screen. In the commands, these measurement readouts are named MEAS<x>, where <x> can be 1 through 8. In addition to the eight displayed measurements, the measurement commands let you specify an additional measurement, IMMed.

  • Page 225: Measurement Commands

    Measurement Commands Command Description MEASUrement? Returns all measurement parameters MEASUrement:GATING? Returns the measurement gating setting MEASUrement:GATING Sets measurement gating MEASUrement:IMMed? Returns all immediate measurement setup parameters MEASUrement:IMMed:DElay? Returns information about the immediate delay measurement MEASUrement:IMMed:DElay:DIREction? Returns the search direction used for immediate delay measurements MEASUrement:IMMed:DElay:DIREction Sets the search direction to use...
  • Page 226 statistical reset MEASUrement:MEAS<n>:MAXimum? Returns the maximum value found since the last statistical reset MEASUrement:MEAS<n>:MEAN? Returns the mean value accumulated since the last statistical reset MEASUrement:MEAS<n>:MINImum? Returns the minimum value found since the last statistical reset MEASUrement:MEAS<n>:STDdev? Returns the standard deviation of values accumulated since the last statistical reset MEASUrement:MEAS<x>?
  • Page 227 MEASUrement:MEAS<x>:UNIts? Returns measurement<x> units MEASUrement:MEAS<x>:VALue? Returns the value of measurement<x> MEASUrement:METHod? Returns the method used for calculating reference levels MEASUrement:METHod Sets the method used for calculating reference levels MEASUrement:REFLevel? Returns reference level parameters MEASUrement:REFLevel:ABSolute:HIGH Returns the top reference level for rise time MEASUrement:REFLevel:ABSolute:HIGH Sets the top reference level for rise time...
  • Page 228 statistics from memory MEASUrement:STATIstics:MODE? Returns which pair of statistical accumulations is displayed MEASUrement:STATIstics:MODe Turns management statistics on or off and sets which pair of statistical accumulations is displayed MEASUrement:STATIstics:WEIghting? Returns the 'time constant' for mean and standard deviation statistical accumulations MEASUrement:STATIstics:WEIghting Sets the 'time constant' for mean and standard deviation...
  • Page 229 MEASUrement? Description This query-only command returns all measurement parameters in the following order: MEAS1, MEAS2, MEAS3, MEAS4, MEAS5, MEAS6, MEAS7, MEAS8, IMMED. Group Measurement Syntax MEASUrement? Example MEASUrement? This query might return :MEASUREMENT:GATING OFF ;METHOD HISTOGRAM;IMMED:TYPE UNDEFINED;UNITS "V" ;SOURCE1 CH1;SOURCE2 CH1;DELAY:EDGE1 RISE;EDGE2 RISE ;DIRECTION FORWARDS;:MEASUREMENT:MEAS1:STATE 0 ;TYPE UNDEFINED;UNITS "V";SOURCE1 CH1;SOURCE2 CH1 ;DELAY:EDGE1 RISE;EDGE2 RISE;DIRECTION FORWARDS;...

  • Page 230: Measurement:gating

    MEASUrement:GATING Description This command specifies or returns the measurement gating setting. This command is equivalent to selecting Gating from the Measure menu and then clicking the desired Measurement Gating setting. Group Measurement Syntax 1 MEASUrement:GATING {ON|OFF|<NRf>|ZOOM|CURSOR} Syntax 2 MEASUrement:GATING? Arguments •...
  • Page 231 MEASUrement:IMMed? Description This query-only command returns all immediate measurement setup parameters. Group Measurement Syntax MEASUrement:IMMed? Example MEASUrement:IMMed? This query might return :MEASUREMENT:IMMED:TYPE PERIOD;UNITS "s";SOURCE1 CH1;SOURCE2 CH1;DELAY:EDGE1 RISE;EDGE2 RISE;DIRECTION FORWARDS...
  • Page 232 MEASUrement:IMMed:DELay? Description This query-only command returns information about the immediate delay measurement. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab and then clicking the Delay button. Group Measurement Syntax MEASUrement:IMMed:DELay? Example MEASUrement:IMMed:DELay? This query might return :MEASUREMENT:IMMED:DELAY:EDGE1 RISE;EDGE2 RISE;...
  • Page 233 MEASUrement:IMMed:DELay:DIREction Description This command sets or returns the starting point and direction that determines the delay "to" edge when taking an immediate delay measurement. Use the MEASUrement:IMMed:SOURCE2 command to specify the delay "to" waveform. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Search Direction setting.
  • Page 234 MEASUrement:IMMed:DELay:EDGE[1] Description This command sets or queries the slope of the edge that is used for the delay "from" waveform when taking an immediate delay measurement. Use the MEASUrement:IMMed:SOURCE1 command to specify the waveform. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Delay Edge1 setting.
  • Page 235 MEASUrement:IMMed:DELay:EDGE2 Description This command sets or queries the slope of the edge that is used for the delay "to" waveform when taking an immediate delay measurement. Use the MEASUrement:IMMed:SOURCE2 command to specify the waveform. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Delay Edge2 setting.
  • Page 236 MEASUrement:IMMed:SOURCE[1] Description This command sets or queries the source for all single channel immediate measurements and specifies the source to measure "from" when taking an immediate delay measurement or phase measurement. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Source1 (From) setting.
  • Page 237 MEASUrement:IMMed:SOURCE2 Description This command sets or queries the source for all single channel immediate measurements and specifies the source to measure "to" when taking an immediate delay measurement or phase measurement. This command is equivalent to selecting Measurement Setup from the Measure menu, choosing the Time tab, clicking the Delay button to display the delay settings and then clicking the desired Source2 (To) setting.
  • Page 238 MEASUrement:IMMed:TYPe Description This command sets or queries the immediate measurement type. Group Measurement Syntax 1 MEASUrement:IMMed:TYPE {AMPlitude|AREa|BURst|CARea|CMEam| CRMs|DELay|FALL|FREQuency|HIGH|LOW|MAXimum|MEAN|MINImum| NDUty|NOVershoot|NWIdth|PDUty|PERIod|PHAse|PK2Pk|POVershoot| PWIdth|RISe|RMS} Syntax 2 MEASUrement:IMMed:TYPe? Arguments • AMPlitude This is the high value minus the low value. • AREa This is the area between the curve and ground over the entire waveform. •...
  • Page 239 This is the negative overshoot, expressed as 100 x (Low - Minimum/Amplitude). • NWIdth This is the distance (time) between MidRef (usually 50%) amplitude points of a negative pulse. • PDUty This is the ratio of the positive pulse width to the signal period, expressed as a percentage. •...
  • Page 240 MEASUrement:IMMed:UNIts? Description This query-only command returns the units of the immediate measurement. Group Measurement Syntax MEASUrement:IMMed:UNIts? Example MEASUrement:IMMed:UNIts? This query might return , indicating that units for the immediate :MEASUREMENT:IMMED:UNIts "s" measurement are represented in seconds.
  • Page 241 MEASUrement:IMMed:VALue? Description This query-only command returns the value of the measurement specified by the MEASUrement:IMMed:TYPe command. The measurement is immediately taken on the source(s) specified by a MEASUrement:IMMed:SOURCE command. A change to HORizontal:MAIn:SCALe or CH<x>:SCALe will not necessarily have taken affect if Note: followed by this command.
  • Page 242 MEASUrement:MEAS<n>:COUNt? Description This query-only command returns the number of values accumulated for this measurement since the last statistical reset. Some values may have been ignored because they generated an error. Group Measurement Syntax MEASUrement:MEAS<n>:COUNt? Example MEASUrement:MEAS3:COUNt? This query might return :MEASUREMENT:MEAS3:COUNT 3.247000000E+03...
  • Page 243 MEASUrement:MEAS<n>:MAXimum? Description This query-only command returns the maximum value found for this measurement since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS<n>:MAXimum? Example MEASUrement:MEAS3:MAXimum? This query might return :MEASUREMENT:MEAS3:MAXIMUM 4.18E-9...
  • Page 244 MEASUrement:MEAS<n>:MEAN? Description This query-only command returns the mean value accumulated for this measurement since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS<n>:MEAN? Example MEASUrement:MEAS1:MEAN? This query might return :MEASUREMENT:MEAS1:MEAN 514.71E-09...
  • Page 245 MEASUrement:MEAS<n>:MINImum? Description This query-only command returns the minimum value found for this measurement since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS<n>:MINImum? Example MEASUrement:MEAS1:MINImum? This query might return :MEASUREMENT:MEAS1:MINIMUM 1.75E-09...
  • Page 246 MEASUrement:MEAS<n>:STDdev? Description This query-only command returns the standard deviation of values accumulated for this measurement since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS<n>:STDdev? Example MEASUrement:MEAS1:STDdev? This query might return :MEASUREMENT:MEAS1:STDDEV 21.0E-12...
  • Page 247 MEASUrement:MEAS<x>? Description This query-only command returns all measurement parameters for the displayed measurement specified by x, which can range from 1 through 8. This query command is equivalent to selecting Measurement Setup from the Measure menu and viewing the Measurements table; then choosing the Time tab, clicking the Delay button and viewing the Delay Edge and Search Direction settings.
  • Page 248 MEASUrement:MEAS<x>:DELay? Description This query-only command returns the delay measurement parameters for the measurement specified by <x>, which ranges from 1 through 8. Measurement parameters are presented in the following order: Edge1, Edge2 and Direction. This query command is equivalent to selecting Time from the Measure menu, choosing Delay and then viewing the Delay Edge and Search Direction settings.
  • Page 249 MEASUrement:MEAS<x>:DELay:DIREction Description This command sets or queries the starting point and direction that determines the delay "to" edge when taking a delay measurement. Use the MEASUrement:MEAS<x>:SOURCE2 command to specify the waveform. This command is equivalent to selecting Time from the Measure menu, choosing Delay from the drop-down list and then clicking the desired Search Direction setting.
  • Page 250 MEASUrement:MEAS<x>:DELay:EDGE[1] Description This command sets or queries the slope of the edge that is used for the delay "from" waveform when taking a delay measurement. Use the MEASUrement:MEAS<x>:SOURCE[1] command to specify the waveform. This command is equivalent to selecting Time from the Measure menu, choosing Delay from the drop-down list and then clicking the desired Delay Edge1 setting.
  • Page 251 MEASUrement:MEAS<x>:DELay:EDGE2 Description This command sets or queries the slope of the edge that is used for the delay "to" waveform when taking a delay measurement. Use the MEASUrement:MEAS<x>:SOURCE2 command to specify the waveform. This command is equivalent to selecting Time from the Measure menu, choosing Delay from the drop- down list and then clicking the desired Delay Edge2 setting.
  • Page 252 MEASUrement:MEAS<x>:SOURCE[1] Description This command sets or queries the source for all single channel measurements and specifies the source to measure "from" when taking a delay measurement or phase measurement. Measurements are specified by x, which ranges from 1 through 8. This command is equivalent to selecting Measurement Setup from the Measure menu and then choosing the desired measurement source.
  • Page 253 MEASUrement:MEAS<x>:SOURCE2 Description This command sets or queries the source for all single channel measurements and specifies the reference source to measure "to" when taking a delay measurement or phase measurement. Measurements are specified by x, which ranges from 1 through 8. This command is equivalent to selecting Measurement Setup from the Measure menu, selecting a measurement type of either Phase or Delay, and then choosing the desired measurement source.
  • Page 254 MEASUrement:MEAS<x>:STATE Description This command sets or queries whether the specified measurement slot is computed and displayed. The measurement slot is specified by x, which ranges from 1 through 8. This command is equivalent to selecting Measurement Setup from the Measure menu and then clicking the Display button. For a measurement to display, you must have selected a source waveform and defined the measurement you want to take and display.
  • Page 255 MEASUrement:MEAS<x>:TYPe Description This command sets or queries the type of measurement that is defined for the specified measurement slot. The measurement slot is specified by x, which ranges from 1 through 4. This command is equivalent to selecting Measurement Setup from the Measure menu and then choosing the desired measurement type.
  • Page 256 • LOW This measures the Low reference (0% level, sometimes called Baseline) of a waveform. • MAXimum This finds the maximum amplitude. This value is the most positive peak voltage found. It is measured over the entire waveform or gated region. •...
  • Page 257 This amplitude measurement finds the true Root Mean Square voltage in the entire waveform or gated region. • UNDEFINED This is the default measurement type, which indicates that a measurement type has not yet been chosen. Once a measurement type is chosen, measurements cannot be reset using this argument. Example 1 MEASUrement:MEAS2:TYPe FREQuency This command defines measurement 2 as a measurement of the frequency of a waveform.
  • Page 258 MEASUrement:MEAS<x>:UNIts? Description This query-only command returns the units associated with the specified measurement. Group Measurement Related Commands MEASUrement:MEAS<x>:TYPe (see page 253) Syntax MEASUrement:MEAS<x>:UNIts? Example MEASUrement:MEAS1:UNIts? This query might return , indicating units for measurement 1 are set to :MEASUREMENT:MEAS1:UNIts % percent.
  • Page 259 MEASUrement:MEAS<x>:VALue? Description This query-only command returns the value that has been calculated for the measurement specified by <x>, which ranges from 1 through 8. This command is equivalent to selecting Display Statistics from the Measure menu and then choosing Value from the drop-down list to display all measurement values on- screen.

  • Page 260: Measurement Method

    MEASUrement:METHod Description This command sets or queries the method used to calculate the 0% and 100% reference level. This command is equivalent to selecting Reference Levels from the Measure menu and then choosing the desired Determine Base, Top Form setting. Group Measurement Related Commands...
  • Page 261 MEASUrement:REFLevel? Description This query-only command returns the current reference level parameters. This command is equivalent to selecting Reference Levels from the Measure menu and then viewing the current Reference Levels settings. Group Measurement Syntax MEASUrement:REFLevel? Example MEASUrement:REFLevel? This query might return :MEASUREMENT:REFLEVEL:METHOD ABSOLUTE ;ABSOLUTE:HIGH 0.0000E+00;LOW 0.0000E+00;MID1 0.0000E+00 ;MID2 0.0000E+00;:MEASUREMENT:REFLEVEL:PERCENT:HIGH...
  • Page 262 MEASUrement:REFLevel:ABSolute:HIGH Description This command sets or queries the high reference level, and is the upper reference level when MEASUrement:REFLevel:METHod is set to Absolute. Note that this command affects the results of rise and fall measurements. This command is equivalent to selecting Reference Levels from the Measure menu and then entering the Absolute High Ref value.
  • Page 263 MEASUrement:REFLevel:ABSolute:LOW Description This command sets or queries the low reference level, and is the lower reference level when MEASUrement:REFLevel:METHod is set to Absolute. Note that this command affects the results of rise and fall measurements. This command is equivalent to selecting Reference Levels from the Measure menu and then entering the Absolute Low Ref value.
  • Page 264 MEASUrement:REFLevel:ABSolute:MID Description This command sets or queries the mid reference level, and is the 50% reference level when MEASUrement:REFLevel:METHod is set to Absolute. Note that this command affects the results of period, frequency, delay, and all cyclic measurements. This command is equivalent to selecting Reference Levels from the Measure menu and then entering the Absolute Mid Ref value.
  • Page 265 MEASUrement:REFLevel:ABSolute:MID2 Description This command sets or queries the mid reference level for the "to" waveform when taking a delay measurement, and is the 50% reference level when MEASUrement:REFLevel:METHod is set to Absolute. Note that this command affects the results of delay measurements. This command is equivalent to selecting Reference Levels from the Measure menu and then entering the Absolute Mid2 Ref value.
  • Page 266 MEASUrement:REFLevel:METHod Description This command specifies or queries the reference level units used for measurement calculations. This command is equivalent to selecting Reference Levels from the Measure menu and then choosing the desired reference level from the Units group box. Group Measurement Syntax 1 MEASUrement:REFLevel:METHod {ABSolute|PERCent}...
  • Page 267 MEASUrement:REFLevel:PERCent:HIGH Description This command sets or queries the percent (where 100% is equal to HIGH) that is used to calculate the high reference level when MEASUrement:REFLevel:METHod is set to Percent. Note that this command affects the results of rise and fall measurements. This command is equivalent to selecting Reference Levels from the Measure menu and then entering the Percentage High Ref value.
  • Page 268 MEASUrement:REFLevel:PERCent:LOW Description This command sets or queries the percent (where 100% is equal to HIGH) that is used to calculate the low reference level when MEASUrement:REFLevel:METHod is set to Percent. Note that this command affects the results of rise and fall measurements. This command is equivalent to selecting Reference Levels from the Measure menu and then entering the Percentage Low Ref value.
  • Page 269 MEASUrement:REFLevel:PERCent:MID[1] Description This command sets or queries the percent (where 100% is equal to HIGH) that is used to calculate the mid reference level when MEASUrement:REFLevel:METHod is set to Percent. Note that this command affects the results of period, frequency, delay, and all cyclic measurements. This command is equivalent to selecting Reference Levels from the Measure menu and then entering the Percentage Mid Ref value.
  • Page 270 MEASUrement:REFLevel:PERCent:MID2 Description This command sets or queries the percent (where 100% is equal to HIGH) that is used to calculate the mid reference level for the second waveform specified when MEASUrement:REFLevel:METHod is set to Percent. Note that this command affects the results of delay measurements. This command is equivalent to selecting Reference Levels from the Measure menu and then entering the Percentage Mid2 Ref value.
  • Page 271 MEASUrement:STATIstics:COUNt Description This command (no query form) clears existing measurement statistics from memory. This command is equivalent to selecting Reset Statistics from the Measure menu. Group Measurement Related Commands MEASUrement:STATIstics:MODe (see page 270) Syntax MEASUrement:STATIstics:COUNt {RESET} Argument • RESET This clears existing measurement statistics from memory. Example MEASUrement:STATIstics:COUNt RESET This command clears existing measurement statistics from memory.
  • Page 272 MEASUrement:STATIstics:MODe Description This command controls the operation and display of management statistics. This command is equivalent to selecting Measurement Setup from the Measure menu, clicking the Statistics button and then choosing the desired Measurement Format. Group Measurement Related Commands MEASUrement:STATIstics:WEIghting (see page 271) Syntax 1 MEASUrement:STATIstics:MODe {OFF|ALL|VALUEMean} Syntax 2...
  • Page 273 MEASUrement:STATIstics:WEIghting Description This command sets or queries the 'time constant' for mean and standard deviation statistical accumulations. This command is equivalent to selecting Measurement Setup from the Measure menu, clicking the Statistics button and then entering the desired Weight n= value. Group Measurement Related Commands...

  • Page 274: Miscellaneous Command Group

    Miscellaneous Command Group Miscellaneous Overview Miscellaneous commands do not fit into other categories. Several commands and queries are common to all 488.2–1987 devices on the GPIB bus. The 488.2– 1987 standard defines these commands. The common commands begin with an asterisk (*) character.

  • Page 275: Miscellaneous Commands

    Miscellaneous Commands Command Description *DDT? Returns the commands that are executed by the group execute trigger *DDT Sets the commands that will be executed by the group execute trigger *IDN? Returns the oscilloscope identification code *LRN? Returns a listing of oscilloscope settings *TRG Performs the group execute trigger (GET) *TST?
  • Page 276 *DDT Description This command allows you to specify a command or a list of commands that are executed when the oscilloscope receives a *TRG command or the GET GPIB interface message. Define Device Trigger (*DDT) is a special alias that the *TRG command uses. Group Miscellaneous Related Commands...
  • Page 277 *IDN? Description This query-only command returns the oscilloscope identification code. Group Miscellaneous Related Commands ID? (see page 290) Syntax IDN? Example *IDN? This query might return , indicating the oscilloscope :TEKTRONIX,TDS7104,0,CF:91.1CT FV:01.00.912 model number, configured number, and firmware version number.
  • Page 278 *LRN? Description This query-only command returns the commands that list the oscilloscope settings (except for configuration information for the calibration values), allowing you to record or "learn" the current oscilloscope settings. You can use these commands to return the oscilloscope to the state it was in when you made the *LRN? query.
  • Page 279 ;PHASE DEGREES;GATEPOS -800.0000E-12;GATEWIDTH 1.9992E-6 ;REFLEVEL 20.0000;REFLEVELOFFSET 223.6000E-3;SPAN 600.0000E+6;CENTER 325.0000E+6;RESBW 1.0004E+6;WINDOW GAUSSIAN;SUPPRESS -35000.0000E-3;UNWRAP 0;LOCK 0; :MATH2:DEFINE " ";NUMAVG 2;SCALE 1.0000;POSITION 0.0000 ;LABEL:NAME "";XPOS 5;YPOS 80;:MATH2:SPECTRAL:MAG DB ;PHASE DEGREES;GATEPOS -800.0000E-12;GATEWIDTH 1.9992E-6 ;REFLEVEL 20.0000;REFLEVELOFFSET 223.6000E-3;SPAN 600.0000E+6;CENTER 325.0000E+6;RESBW 1.0004E+6;WINDOW GAUSSIAN;SUPPRESS -35000.0000E-3;UNWRAP 0;LOCK 0; :MATH3:DEFINE " ";NUMAVG 2;SCALE 1.0000;POSITION 0.0000 ;LABEL:NAME "";XPOS 5;YPOS 95;:MATH3:SPECTRAL:MAG DB ;PHASE DEGREES;GATEPOS -800.0000E-12;GATEWIDTH 1.9992E-6 ;REFLEVEL 20.0000;REFLEVELOFFSET 223.6000E-3;SPAN...
  • Page 280 :HIGH 90.0000;LOW 10.0000;MID1 50.0000;MID2 50.0000; :MEASUREMENT:STATISTICS:MODE OFF;WEIGHTING 32;:ZOOM :MODE 0;GRATICULE:SIZE 50;:ZOOM:HORIZONTAL:LOCK ALL; :ZOOM:CH1:HORIZONTAL:POSITION 50.0000;SCALE 2;:ZOOM :CH1:VERTICAL:POSITION 0.0000;SCALE 1.0000;:ZOOM:CH2 :HORIZONTAL:POSITION 50.0000;SCALE 2;:ZOOM:CH2:VERTICAL :POSITION 0.0000;SCALE 1.0000;:ZOOM:CH3:HORIZONTAL :POSITION 50.0000;SCALE 2;:ZOOM:CH3:VERTICAL:POSITION 0.0000;SCALE 1.0000;:ZOOM:CH4:HORIZONTAL:POSITION 50.0000;SCALE 2;:ZOOM:CH4:VERTICAL:POSITION 0.0000 ;SCALE 1.0000;:ZOOM:MATH1:HORIZONTAL:POSITION 50.0000 ;SCALE 2;:ZOOM:MATH1:VERTICAL:POSITION 0.0000;SCALE 1.0000;:ZOOM:MATH2:HORIZONTAL:POSITION 50.0000;SCALE 2; :ZOOM:MATH2:VERTICAL:POSITION 0.0000;SCALE 1.0000;...
  • Page 281 *TRG Description This command (no query form) performs the group execute trigger on commands defined by *DDT. Group Miscellaneous Related Commands *DDT (see page 274) Syntax *TRG Example *TRG This command immediately executes all commands that have been defined by *DDT.
  • Page 282 *TST? Description This query-only command tests (self-test) the GPIB interface and returns a 0. Group Miscellaneous Syntax *TST? Example *TST? This query always returns...
  • Page 283 AUTOSet EXECute Description This command causes the digitizing oscilloscope to adjust its vertical, horizontal, and trigger controls to provide a stable display of the selected waveform. This is equivalent to pressing the front-panel AUTOSET button. For a detailed description of autoset functionality, see Autoset in the index of your oscilloscope online help.
  • Page 284 AUXout? Description This query-only command returns the auxiliary out setup. This query command is equivalent to selecting AUX OUT Configuration from the Utilities menu and then viewing the current settings. Group Miscellaneous Related Commands AUXout:EDGe (see page 283), AUXout:SOUrce (see page 284) Syntax AUXout? Example...
  • Page 285 AUXout:EDGE Description This command sets or queries the direction in which the trigger output signal transitions when a trigger occurs. This command is equivalent to selecting AUX OUT Configuration from the Utilities menu and then clicking the desired Polarity setting. Group Miscellaneous Related Commands...
  • Page 286 AUXout:SOUrce Description This command sets or queries the trigger source at the BNC connection. This command is equivalent to selecting AUX OUT Configuration from the Utilities menu and then selecting the desired Configuration setting. Group Miscellaneous Related Commands AUXout? (see page 282), AUXout:EDGe (see page 283) Syntax 1 AUXout:SOUrce {ATRIGger|BTRIGger} Syntax 2...
  • Page 287 BELI Description This command was previously used to beep an audio indicator and is provided for backward compatibility. Group Miscellaneous Syntax BEL1 Example BEL1 This command is accepted but does nothing.
  • Page 288 CMDBatch Description This command sets or queries the state of command batching. By batching commands, database transactions can be optimized, increasing command throughput. Also, batching allows for ALL commands in an individual batch to be order independent and accomplish the same result as if the commands were coupled.
  • Page 289 DATe Description This command sets or queries the date that the oscilloscope can display. This command is equivalent to selecting Set Date & Time from the Utilities menu and then setting the fields in the Date group box. Group Miscellaneous Related Commands TIMe (see page 298) Syntax 1...
  • Page 290 Description This command is identical to the HEADer query and is included for backward compatibility purposes. Group Miscellaneous Related Commands HEADer (see page 289), VERBose (see page 300) Syntax 1 HDR {OFF|ON|<NR1>} Syntax 2 HDR? Arguments • OFF This sets the Response Header Enable State to false. This causes the oscilloscope to omit headers on query responses, so that only the argument is returned.
  • Page 291 HEADer Description This command sets or queries the Response Header Enable State that causes the oscilloscope to either include or omit headers on query responses. This command does not affect IEEE Std 488.2-1987 Common Commands (those starting with an Note: asterisk);...
  • Page 292 Description This query-only command returns identifying information about the oscilloscope and related firmware. Group Miscellaneous Related Commands IDN? (see page 275) Syntax Example This query might return , indicating the oscilloscope model :TEK/TDS7104,CF:91.1CT,FV:01.00.912 number, configured format, and firmware version number.
  • Page 293 LOCk Description This command enables or disables all front panel buttons and knobs, including the touch screen. There is no front panel equivalent. Group Miscellaneous Related Commands UNLock (see page 299) Syntax 1 LOCk {ALL|NONe} Syntax 2 LOCk? Arguments • ALL This disables all front panel controls.
  • Page 294 NEWpass Description This command (no query form) changes the password that enables access to password protected data. The PASSWord command must be successfully executed before using this command or an execution error will be generated. Group Miscellaneous Related Commands PASSWord (see page 293), *PUD (see page 324) Syntax NEWpass <QString>...
  • Page 295 PASSWord Description This command (no query form) enables the *PUD NEWpass set commands. Sending PASSWord without any arguments disables these same commands. Once the password is successfully entered, the *PUD and NEWpass commands are enabled until the oscilloscope is powered off, or until the FACtory command, the PASSWord command with no arguments, or the *RST...
  • Page 296 Description This command (no query form) embeds a comment within GPIB programs as a means of internally documenting the programs. The oscilloscope ignores these embedded comment lines. Group Miscellaneous Related Commands NEWpass (see page 292), *PUD (see page 324) Syntax REM <QString>...
  • Page 297 SET? Description This query-only command returns the commands that list the oscilloscope settings, except for configuration information for the calibration values. You can use these commands to return the oscilloscope to the state it was in when you made the SET? query. This command is identical to the *LRN? command.
  • Page 298 STAYSHIGH;TIME 2.0000E-9;:TRIGGER:B:STATE 0;TYPE EDGE ;LEVEL 0.0000;BY EVENTS;EDGE:SOURCE CH1;SLOPE RISE ;COUPLING DC;:TRIGGER:B:TIME 16.0000E-9;EVENTS:COUNT 2; :MATH1:DEFINE " ";NUMAVG 2;SCALE 1.0000;POSITION 0.0000 ;LABEL:NAME "";XPOS 5;YPOS 65;:MATH1:SPECTRAL:MAG DB ;PHASE DEGREES;GATEPOS -800.0000E-12;GATEWIDTH 1.9992E-6 ;REFLEVEL 20.0000;REFLEVELOFFSET 223.6000E-3;SPAN 600.0000E+6;CENTER 325.0000E+6;RESBW 1.0004E+6;WINDOW GAUSSIAN;SUPPRESS -35000.0000E-3;UNWRAP 0;LOCK 0; :MATH2:DEFINE " ";NUMAVG 2;SCALE 1.0000;POSITION 0.0000 ;LABEL:NAME "";XPOS 5;YPOS 80;:MATH2:SPECTRAL:MAG DB ;PHASE DEGREES;GATEPOS -800.0000E-12;GATEWIDTH 1.9992E-6 ;REFLEVEL 20.0000;REFLEVELOFFSET 223.6000E-3;SPAN...
  • Page 299 ;EDGE2 RISE;DIRECTION FORWARDS;:MEASUREMENT:MEAS8 :STATE 0;TYPE UNDEFINED;SOURCE1 CH1;SOURCE2 CH1;DELAY :EDGE1 RISE;EDGE2 RISE;DIRECTION FORWARDS;:MEASUREMENT :REFLEVEL:METHOD PERCENT;ABSOLUTE:HIGH 0.0000;LOW 0.0000 ;MID1 0.0000;MID2 0.0000;:MEASUREMENT:REFLEVEL:PERCENT :HIGH 90.0000;LOW 10.0000;MID1 50.0000;MID2 50.0000; :MEASUREMENT:STATISTICS:MODE OFF;WEIGHTING 32;:ZOOM :MODE 0;GRATICULE:SIZE 50;:ZOOM:HORIZONTAL:LOCK ALL; :ZOOM:CH1:HORIZONTAL:POSITION 50.0000;SCALE 2;:ZOOM :CH1:VERTICAL:POSITION 0.0000;SCALE 1.0000;:ZOOM:CH2 :HORIZONTAL:POSITION 50.0000;SCALE 2;:ZOOM:CH2:VERTICAL :POSITION 0.0000;SCALE 1.0000;:ZOOM:CH3:HORIZONTAL :POSITION 50.0000;SCALE 2;:ZOOM:CH3:VERTICAL:POSITION 0.0000;SCALE 1.0000;:ZOOM:CH4:HORIZONTAL:POSITION...
  • Page 300 TIMe Description This command sets or queries the time that the oscilloscope can display. This command is equivalent to selecting Set Time & Date from the Utilities menu and then setting the fields in the Time group box Group Miscellaneous Related Commands DATe (see page 287) Syntax 1...
  • Page 301 UNLock Description This command (no query form) unlocks the front panel. The command is equivalent to LOCk NONe. Note: If the oscilloscope is in the Remote With Lockout State (RWLS), the UNLock command has no effect. For more information, see the ANSI-IEEE Std 488.1-1987 Standard Digital Interface for Programmable Instrumentation, section 2.8.3 on RL State Descriptions.
  • Page 302 VERBose Description This command sets and queries the Verbose state that controls the length of keywords on query responses. Keywords can be both headers and arguments. This command does not affect IEEE Std 488.2-1987 Common Commands (those starting with an asterisk). Group Miscellaneous Related Commands...

  • Page 303: Save And Recall Command Group

    Save and Recall Command Group Save and Recall Overview You use the commands in the Save and Recall Command Group to store and retrieve internal waveforms and settings. When you save a setup, you save all the settings of the oscilloscope. When you recall a setup, the oscilloscope restores itself to the state that it was in when you originally saved that setting.
  • Page 304 Save and Recall Commands Command Description *RCL Restores the state of the oscilloscope from a copy of the setting stored in memory. *SAV Stores the current oscilloscope state to a specified memory location *SDS Changes the specified setup to reference the factory setup instead of the user setup DELEte:SETUp Removes stored setups from memory and...
  • Page 305 *RCL Description This command (no query form) restores the state of the oscilloscope from a copy of the settings stored in memory (The settings are stored using the *SAV command). If 'factory' is referenced (by specifying '0'), the factory default values will be restored. This command is equivalent to RECAll:SETUp and performs the same function as selecting Instrument Setup from the File menu and then choosing the Recall Setups...
  • Page 306 *SAV Description This command (no query form) stores the state of the oscilloscope to a specified memory location. You can later use the *RCL command to restore the oscilloscope to this saved state. This is equivalent to selecting Instrument Setup from the File menu and then choosing the Save Setups tab. Group Save and Recall Related Commands...
  • Page 307 *SDS Description This command (no query form) changes the specified setup to reference the factory setup instead of the specific user setup slot. The content of the setup slot is unchanged, but the data will no longer be accessible to you. This command is equivalent to selecting Instrument Setups from the File menu, choosing the Recall Setups tab and then clicking the Default button.

  • Page 308: Delete:setup

    DELEte:SETUp Description This command (no query form) changes the setup to reference the factory setup instead of the specific user setup slot. The content of the setup slot is unchanged but the data will no longer be accessible to you. This command is equivalent to selecting Instrument Setup from the File menu, choosing the Delete tab and then clicking the Delete button.
  • Page 309 DELEte:WAVEform Description This command (no query form) deletes one or all stored reference waveforms from memory. This command is equivalent to selecting Reference Waveforms from the File menu and choosing Reference Setup from the drop-down list (when deleting individual reference waveforms) or selecting Delete All Refs from the File menu (when deleting all reference waveforms).
  • Page 310 FACtory Description This command (no query form) resets the oscilloscope to factory default settings. This command is equivalent to pressing the DEFAULT SETUP button located on the front panel. Group Save and Recall Related Commands *PSC (see page 323), *RCL? (see page 303), RECall:SETUp (see page 309), *RST (see page 325), *SAV (see page 304), SAVe:SETUp (see page 311) Syntax FACtory...

  • Page 311: Recall:setup

    RECAll:SETUp Description This command (no query form) restores a stored or factory front-panel setup of the oscilloscope from a copy of the settings stored in memory. If 'factory' is referenced (by specifying '0'), the factory default values will be restored. This command is equivalent to *RCL and performs the same function as selecting Instrument Setup from the File menu and then choosing the Recall Setups tab.

  • Page 312: Recall:waveform

    RECAll:WAVEform Description This command (no query form) recalls a stored waveform to a reference location. This command is equivalent to selecting Reference Waveforms from the File menu and then choosing Recall Wfm. Group Save and Recall Related Commands DELEte:WAVEform (see page 307), SAVe_WAVEform (see page 312) Syntax RECAll:WAVEform {<file path>|REF<x>} Arguments...

  • Page 313: Save:setup

    SAVe:SETUp Description This command (no query form) saves the current front-panel setup into the specified memory location or file. This is equivalent to selecting Instrument Setup from the File menu and then choosing the Save Setups tab. Group Save and Recall Related Commands *RCL (see page 303), RECAll:SETUp (see page 309),*SAV (see page 304) Syntax...

  • Page 314: Save:waveform

    SAVe:WAVEform Description This command (no query form) saves a waveform to one of four reference memory locations or a mass storage file. This command is equivalent to selecting Reference Waveforms from the File menu and then choosing Save Wfm from the drop-down list. Group Save and Recall Related Commands...
  • Page 315 SAVe:WAVEform:FILEFormat Description This command specifies or returns the file format for saved waveforms. Waveform header and timing information is included in the resulting file of non-internal formats. The instrument saves DPO waveforms as a 500x200 matrix, with the first row corresponding to the most recently acquired data. The values specified by DATa:STARt and DATa:STOP determine the range of waveform data to output.
  • Page 316 This query might return: , indicating that waveforms are saved SAVE:WAVEFORM:FILEFORMAT INTERNAL using the internal format.

  • Page 317: Setup:name

    SETUp:NAMe Description This command sets and queries a Setup Label that you define. This command is equivalent to selecting Instrument Setup from the File menu, choosing the Save Setups tab and then adding a meaningful label to the selected setup. Group Save and Recall Related Commands...

  • Page 318: Status And Error Command Group

    Status and Error Command Group Status and Error Overview You use the commands in the Status and Error command Group to determine the status of the oscilloscope and control events. Several commands and queries used with the oscilloscope are common to all devices on the GPIB bus. The IEEE Std 488.2–1987 defines these commands and queries.

  • Page 319: Status And Error Commands

    Status and Error Commands Command Description *CLS Clears status *ESE? Returns the bits in the Event Status Enable Register *ESE Sets the bits in the Event Status Enable Register *ESR? Returns the contents of the Standard Event Status Register *OPC? Returns “1”...
  • Page 320 *CLS Description This command (no query form) clears the following: • Event Queue • Standard Event Status Register • Status Byte Register (except the MAV bit) If the *CLS command immediately follows an <EOI>, the Output Queue and MAV bit (Status Byte Register bit 4) are also cleared.
  • Page 321 *ESE Description This command sets and queries the bits in the Event Status Enable Register (ESER). The ESER prevents events from being reported to the Status Byte Register (STB). For a more detailed discussion of the use of these registers, see Registers on page 522. Group Status and Error Related Commands...
  • Page 322 *ESR? Description This query-only command returns the contents of the Standard Event Status Register (SESR). *ESR? also clears the SESR (since reading the SESR clears it). For a more detailed discussion of the use of these registers, see Registers on page 522. Group Status and Error Related Commands...
  • Page 323 *OPC Description This command generates the operation complete message in the Standard Event Status Register (SESR) when all pending operations finish. The *OPC? query places the ASCII character "1" into the output queue when all pending operations are finished. The *OPC? response is not available to read until all pending operations finish.
  • Page 324 *OPT? Description This query-only command returns a list of the options installed in your oscilloscope. Group Status and Error Syntax *OPT? Example *OPT? This query might return :3M:16 Meg Max 4M/CH...
  • Page 325 *PSC Description This command sets and queries the power-on status flag that controls the automatic power-on handling of the DESER, SRER, and ESER registers. When *PSC is true, the DESER register is set to 255 and the SRER and ESER registers are set to 0 at power-on. When *PSC is false, the current values in the DESER, SRER, and ESER registers are preserved in nonvolatile memory when power is shut off and are restored at power-on.
  • Page 326 *PUD Description This command sets or queries a string of Protected User Data. This data is protected by the PASSWord command. You can modify it only by first entering the correct password. This password is not necessary to query the data. Group Status and Error Related Commands...
  • Page 327 *RST Description This command (no query form) resets the oscilloscope to the factory default settings. The *RST command does not alter the following: • The state of the IEEE Std 488.1-1987 interface • The selected IEEE Std 488.1-1987 address of the oscilloscope •...
  • Page 328 *SRE Description The *SRE (Service Request Enable) command sets and queries the bits in the Service Request Enable Register. For more information, refer to Registers on page 522. Group Status and Error Related Commands *CLS (see page 318), DESE (see page 331), *ESE (see page 319), *ESR? (see page 320), EVENT? (see page 332), EVMSg? (see page 333), FACtory (see page 308), *STB? (see page 327) Syntax 1 *SRE <NR1>...
  • Page 329 *STB? Description The *STB? (Read Status Byte) query returns the contents of the Status Byte Register (SBR) using the Master Summary Status (MSS) bit. For more information, refer to Registers on page 522. Group Status and Error Related Commands CLS (see page 318), DESE (see page 331), *ESE (see page 319), *ESR? (see page 320), EVENT? (see page 332), EVMSg? (see page 333), FACtory (see page 308), *SRE? (see page 326) Syntax *STB?
  • Page 330 *WAI Description The *WAI (Wait) command (no query form) prevents the oscilloscope from executing further commands or queries until all pending operations finish. This command allows you to synchronize the operation of the oscilloscope with your application program. For more information, refer to Synchronization Methods on page 542.
  • Page 331 ALLEV? Description This query-only command prompts the oscilloscope to return all events and their messages (delimited by commas), and removes the returned events from the Event Queue. Use the *ESR? query to enable the events to be returned. This command is similar to repeatedly sending *EVMsg? queries to the oscilloscope.
  • Page 332 BUSY? Description This query-only command returns the status of the oscilloscope. This command allows you to synchronize the operation of the oscilloscope with your application program. Group Status and Error Related Commands *OPC (see page 321), *WAI (see page 328) Syntax BUSY? Returns...
  • Page 333 DESE Description This command sets and queries the bits in the Device Event Status Enable Register (DESER). The DESER is the mask that determines whether events are reported to the Standard Event Status Register (SESR), and entered into the Event Queue. For a more detailed discussion of the use of these registers, see Registers on page 522.
  • Page 334 EVENT? Description This query-only command returns an event code from the Event Queue that provides information about the results of the last *ESR? read. EVENT? also removes the returned value from the Event Queue. Group Status and Error Related Commands ALLEv? (see page 329), *CLS (see page 318), DESE (see page 331), *ESE (see page 319), *ESR? (see page ), EVMsg? (see page 333), *SRE (see page 326), *STB? (see page 327) Syntax...
  • Page 335 EVMsg? Description This query-only command removes a single event code from the Event Queue that is associated with the results of the last *ESR? read and returns the event code along with an explanatory message. For more information, see Event Handling on page 530. Group Status and Error Related Commands...
  • Page 336 EVQty? Description This query-only command returns the number of event codes that are in the Event Queue. This is useful when using the ALLEv? query, since it lets you know exactly how may events will be returned. Group Status and Error Related Commands ALLEv? (see page 329), EVENT? (see page 332), EVMsg? (see page 333) Syntax...

  • Page 337: Trigger Command Group

    Trigger Command Group Trigger Overview You use the commands in the Trigger Command Group to control all aspects of triggering for the oscilloscope. There are two triggers: A and B. Where appropriate, the command set has parallel constructions for each trigger.

  • Page 338: Trigger Commands

    Trigger Commands Command Description TRIGger? Returns current trigger parameters for the oscilloscope TRIGger Forces a trigger event to occur TRIGger:A? Returns current A trigger parameters TRIGger:A Sets A trigger level to 50% TRIGger:A:EDGE? Returns the source, coupling and source for the A edge trigger TRIGger:A:EDGE:COUPling? Returns the type of coupling...
  • Page 339 channels for the A logic trigger TRIGger:A:LOGIc:FUNCtion Sets the logical combination of the input channels for the A logic trigger TRIGger:A:LOGIc:INPut? Returns the A logic trigger input for channels 1-3. TRIGger:A:LOGIc:INPut:CH<x>? Returns the input settings for the specified logic trigger channel TRIGger:A:LOGIc:INPut:CH<x>...
  • Page 340 for setup and hold triggering TRIGger:A:LOGIc:SETHold:CLOCk Returns the clock source for :SOUrce? the A logic trigger setup and hold input TRIGger:A:LOGIc:SETHold:CLOCk Sets the clock source for the :SOUrce A logic trigger setup and hold input TRIGger:A:LOGIc:SETHold:CLOCk Returns the clock voltage :THReshold? threshold for setup and hold trigger...
  • Page 341 TRIGger:A:LOGIc:THReshold:CH<x>? Returns the A logic trigger threshold voltage for the specified channel TRIGger:A:LOGIc:THReshold:CH<x> Sets the A logic trigger threshold voltage for the specified channel TRIGger:A:MODe? Returns the A trigger mode TRIGger:A:MODe Sets the A trigger mode TRIGger:A:PULse? Returns the A pulse trigger parameters TRIGger:A:PULse:CLAss? Returns the type of pulse on...
  • Page 342 width the trigger checks for when it uncovers a runt TRIGger:A:PULse:RUNT:WHEn Sets the type of pulse width the trigger checks for when it uncovers a runt TRIGger:A:PULse:RUNT:WIDth? Returns the minimum width for A pulse runt trigger TRIGger:A:PULse:RUNT:WIDth Sets the minimum width for A pulse runt trigger TRIGger:A:PULse:SOURce? Returns the source for the A...
  • Page 343 TRIGger:A:PULse:TRANsition:WHEn? Returns the relationship of delta time to transitioning signal TRIGger:A:PULse:TRANsition:WHEn Sets the relationship of delta time to transitioning signal TRIGger:A:PULse:WIDth? Returns the trigger A pulse width parameters TRIGger:A:PULse:WIDth:HIGHLimit? Returns the upper limit for the A pulse width trigger TRIGger:A:PULse:WIDth:HIGHLimit Sets the upper limit for the A pulse width trigger TRIGger:A:PULse:WIDth:LOWLimit?
  • Page 344 TRIGger:B:EVENTS? Returns the current B trigger events parameter TRIGger:B:EVENTS:COUNt? Returns the number of events that must occur before the B trigger occurs TRIGger:B:EVENTS:COUNt Sets the number of events that must occur before the B trigger occurs TRIGger:B:LEVel? Returns the level for the B trigger TRIGger:B:LEVel Sets the level for the B...
  • Page 345 TRIGger Description This command forces a trigger event to occur and the query returns current trigger parameters for the oscilloscope. Group Trigger Syntax 1 TRIGger FORCe Syntax 2 TRIGger? Argument • FORCe This creates a trigger event. If TRIGger:STATE is set to READy, the acquisition will complete. Otherwise, this command will be ignored.
  • Page 346 TRIGger:A Description This command sets the A trigger level automatically to 50% of the minimum/maximum value of the trigger input signal. The query returns current A trigger parameters. TRIGger:A? is a composite of TRIGger:A:EDGE?, TRIGger:A:LOGIc?, and TRIGger:A:PULSE? The trigger level is the voltage threshold through which the trigger source signal must pass to generate a trigger event.
  • Page 347 TRIGger:A:EDGE? Description This query-only command returns the trigger source, coupling and slope for the A edge trigger. This command is equivalent to selecting Edge Setup from the Trig menu and then viewing the current setups. Group Trigger Related Commands TRIGger:A:PULse? (see page 380), TRIGger:A:LOGIc? (see page 354) Syntax TRIGger:A:EDGE? Example...
  • Page 348 TRIGger:A:EDGE:COUPling Description This command sets or queries the type of coupling for the A edge trigger. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then choosing from the Coupling drop- down list. Group Trigger Related Commands...
  • Page 349 TRIGger:A:EDGE:SLOpe Description This command sets or queries the slope for the A edge trigger. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then choosing the desired Slope. Group Trigger Related Commands TRIGger:A:EDGE:SOUrce (see page 348), TRIGger:A:EDGE:COUPling (see page 346) Syntax 1 TRIGger:A:EDGE:SLOpe {RISe|FALL} Syntax 2...
  • Page 350 TRIGger:A:EDGE:SOUrce Description This command sets or queries the source for the A edge trigger. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then choosing from the Source drop-down list. Group Trigger Related Commands TRIGger:A:EDGE:SLOpe (see page 347), TRIGger:A:EDGE:COUPling (see page 346) Syntax 1 TRIGger:A:EDGE:SOUrce {AUXiliary|CH<x>|LINE}...
  • Page 351 TRIGger:A:HOLDoff? Description This query-only command returns the A trigger holdoff parameters. These parameters specify the time period during which the trigger circuitry is not looking to generate a trigger event. This command is equivalent to selecting Holdoff from the Trig menu and then viewing the current settings. Group Trigger Related Commands...
  • Page 352 TRIGger:A:HOLDoff:ACTUal? Description This query-only command returns the holdoff time actually used (expressed in seconds) by the A trigger. This command is equivalent to selecting Holdoff from the Trig menu and then viewing the current Trig Holdoff value. Group Trigger Related Commands TRIGger:A:HOLDoff? (see page 349), TRIGger:A:HOLDoff:BY (see page 351), TRIGger:A:HOLDoff:TIMe (see page 352) Syntax...
  • Page 353 TRIGger:A:HOLDoff:BY Description This command sets or queries the type of holdoff for the A trigger. Holdoff types are expressed as either user-specified time (TIMe) or by an internally calculated minimum time value (DEFAult). This command is equivalent to selecting Holdoff from the Trig menu and then viewing or setting the Holdoff type. Group Trigger Related Commands...
  • Page 354 TRIGger:A:HOLDoff:TIMe Description This command sets or queries the A trigger holdoff time. This command is equivalent to selecting Holdoff from the Trig menu and then choosing the desired Trig Holdoff. Group Trigger Related Commands TRIGger:A:HOLDoff:BY (see page 351) Syntax 1 TRIGger:A:HOLDoff:TIMe <NR3>...
  • Page 355 TRIGger:A:LEVel Description This command sets or queries the level for the A trigger. This command is equivalent to selecting Holdoff from the Trig menu and then viewing or setting the trigger Level. Group Trigger Syntax 1 TRIGger:A:LEVel {ECL|TTL|<NR3>} Syntax 2 TRIGger:A:LEVel? Arguments •...
  • Page 356 TRIGger:A:LOGIc? Description This query-only command returns all of the A logic trigger parameters. Group Trigger Related Commands TRIGger:A:LOGIc:CLAss (see page 355) Syntax TRIGger:A:LOGic? Example TRIGger:A:LOGic? This query might return :TRIGGER:A:LOGIC:CLASS PATTERN ;FUNCTION AND;WHEN TRUE;THRESHOLD:CH1 1.4000;CH2 1.4000 ;CH3 1.4000;CH4 1.4000;:TRIGGER:A:LOGIC:INPUT:CH1 HIGH ;CH2 X;CH3 X;:TRIGGER:A:LOGIC:PATTERN:INPUT:CH4 X;...
  • Page 357 TRIGger:A:LOGIc:CLAss Description This command sets or queries the class of the Logic Trigger. Used in concert with TRIGger:A:TYPe, this command is equivalent to selecting Logic Pattern, Logic State or Setup/Hold Setup from the Trig menu. Group Trigger Related Commands TRIGger:A:TYPe (see page 412), TRIGger:A:PULse:CLAss (see page 381) Syntax 1 TRIGger:A:LOGIc:CLAss {PATtern|STATE|SETHold} Syntax 2...
  • Page 358 TRIGger:A:LOGIc:FUNCtion Description This command sets or queries the logical combination of the input channels for the A pattern and A state logic triggers. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then setting or viewing the Pattern Type. Group Trigger Related Commands...
  • Page 359 TRIGger:A:LOGIc:INPut? Description This query-only command returns the A logic trigger input expected for channel 1, 2, and 3. Channel 4 is set or queried with the command TRIGger:A:LOGIc:PATtern:INPut:CH4. This command is equivalent to selecting A Event (Main) Trigger Setup and then viewing or setting the Input Threshold for channel 1 through 3.
  • Page 360 TRIGger:A:LOGIc:INPut:CH<x> Description This command sets or queries the A logical input for the specified logic trigger channel, which ranges from CH1 through CH3. Note that CH4 cannot be set or queried with this command. For details about setting this channel, see TRIGger:A:LOGIc:PATtern:INPut:CH4. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then choosing the desired logical input from the Ch<x>...
  • Page 361 TRIGger:A:LOGIc:PATtern? Description This query-only command returns the conditions used for generating an A logic pattern trigger, with respect to the defined input pattern, and identifies the maximum and minimum time that the selected pattern may be true and still generate the trigger. This command is equivalent to selecting Logic Pattern from the Trig menu and then viewing the current setups.
  • Page 362 TRIGger:A:LOGIc:PATtern:INPut:CH4 Description This command sets or queries the A logic trigger input for channel 4. This command specifies the logic value used when the pattern trigger detects the threshold level. This command is equivalent to selecting Logic Pattern from the Trig menu and then choosing the desired logical input from the Ch4 drop-down list, which is located in the Input Threshold group box.
  • Page 363 TRIGger:A:LOGIc:PATtern:WHEn Description This command sets or queries the condition for generating an A logic pattern trigger with respect to the defined input pattern. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then choosing a trigger condition from the Pattern drop-down list, which is located in the Trigger When group box.
  • Page 364 TRIGger:A:LOGIc:PATtern:WHEn:LESSLimit Description This command sets or queries the maximum time that the selected pattern may be true and still generate an A logic pattern trigger. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then entering the following Trigger When settings: choose Less Than from the Pattern drop-down list, then enter a maximum value for Time.
  • Page 365 TRIGger:A:LOGIc:PATtern:WHEn:MORELimit Description This command sets or queries the minimum time that the selected pattern may be true and still generate an A logic pattern trigger. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then entering the following Trigger When settings: choose More Than from the Pattern drop-down list, then enter a minimum value for Time.
  • Page 366 TRIGger:A:LOGIc:SETHold? Description This query-only command returns the clock edge polarity, voltage threshold and source input; data voltage threshold and source; and both setup and hold times for setup and hold violation triggering. This command is equivalent to selecting Setup/Hold Setup from the Trig menu and then viewing the current setups.
  • Page 367 TRIGger:A:LOGIc:SETHold:CLOCk? Description This query-only command returns the clock edge polarity, voltage threshold and source input for setup and hold triggering. This command is equivalent to selecting Setup/Hold Setup from the Trig menu and then viewing the current clock setups. Group Trigger Related Commands TRIGger:A:LOGIc:SETHold:DATa? (see page 369), TRIGger:A:LOGIc:SETHold:CLOCk:EDGE (see...
  • Page 368 TRIGger:A:LOGIc:SETHold:CLOCk:EDGE Description This command sets or queries the clock edge polarity for setup and hold triggering. This is equivalent to selecting Setup/Hold Setup from the Trig menu and then choosing the desired Clock Edge. Group Trigger Related Commands TRIGger:A:LOGIc:SETHold:CLOCk:SOUrce (see page 367), TRIGger:A:LOGIc:SETHold:CLOCk:THReshold (see page 368) Syntax 1 TRIGger:A:LOGIc:SETHold:CLOCk:EDGE {FALL|RISe}...
  • Page 369 TRIGger:A:LOGIc:SETHold:CLOCk:SOUrce Description This command sets or queries the clock source for the A logic trigger setup and hold input. The channel is specified by x, which ranges from 1 through 4. This is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then choosing the desired channel from the Clock Source drop-down list.
  • Page 370 TRIGger:A:LOGIc:SETHold:CLOCk:THReshold Description This command sets or queries the clock voltage threshold for setup and hold trigger. This command is equivalent to selecting Setup/Hold Setup from the Trig menu and then setting the desired Clock Level. Group Trigger Related Commands TRIGger:A:LOGIc:SETHold:CLOCk:EDGE (see page 366), TRIGger:A:LOGIc:SETHold:CLOCk:SOUrce (see page 367) Syntax 1 TRIGger:A:LOGIc:SETHold:CLOCk:THReshold {ECL|TTL|<NR3>}...
  • Page 371 TRIGger:A:LOGIc:SETHold:DATa? Description This query-only command returns the voltage threshold and data source for setup and hold trigger. This command is equivalent to selecting Setup/Hold Setup from the Trig menu and then viewing the current data setups. Group Trigger Related Commands TRIGger:A:LOGIc:SETHold:CLOCk? (see page 365) Syntax TRIGger:A:LOGIc:SETHold:DATa?
  • Page 372 TRIGger:A:LOGIc:SETHold:DATa:THReshold Description This command sets or queries the data voltage threshold for setup and hold trigger. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then setting the desired Data Level. Group Trigger Related Commands TRIGger:A:LOGIc:SETHold:DATa:SOUrce (see page 371) Syntax 1...
  • Page 373 TRIGger:A:LOGIc:SETHold:DATa:SOUrce Description This command sets or queries the data source for setup and hold trigger. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then choosing the desired channel from the Data Source drop-down list. Group Trigger Related Commands...
  • Page 374 TRIGger:A:LOGIc:SETHold:HOLDTime Description This command sets or queries the hold time for setup and hold violation triggering. This command is equivalent to selecting Setup/Hold Setup from the Trig menu and then setting the desired Hold Time. Group Trigger Related Commands TRIGger:A:LOGIc:SETHold:SETTime (see page 373) Syntax 1 TRIGger:A:LOGIc:SETHold:HOLDTime <NR3>...
  • Page 375 TRIGger:A:LOGIc:SETHold:SETTime Description This command sets or queries the setup time for setup and hold violation triggering. This command is equivalent to selecting Setup/Hold Setup from the Trig menu and then setting the desired Hold Time. Group Trigger Related Commands TRIGger:A:LOGIc:SETHold:HOLDTime (see page 372) Syntax 1 TRIGger:A:LOGIc:SETHold:SETTime <NR3>...
  • Page 376 TRIGger:A:LOGIc:STATE? Description This query-only command returns the data input and trigger criteria for the A logic trigger. This command is equivalent to selecting Logic State from the Trig menu and then viewing the current logic state settings. Group Trigger Related Commands TRIGger:A:LOGIc:STATE:INPut:CH4 (see page 375), TRIGger:A:LOGic:STATE:WHEn (see page 376) Syntax TRIGger:A:LOGIc:STATE?
  • Page 377 TRIGger:A:LOGIc:STATE:INPut:CH4 Description This command sets or queries the slope for channel 4 when the logic class is set to STATE. This command is equivalent to selecting Logic State from the Trig menu and then choosing the desired channel input (NEG or POS) from the Ch4 drop-down list. Group Trigger Related Commands...
  • Page 378 TRIGger:A:LOGIc:STATE:WHEn Description This command sets or queries the condition for generating an A logic state trigger. This command is equivalent to selecting Logic State from the Trig menu and then choosing the desired condition from the Trigger When Pattern drop-down list. Group Trigger Related Commands...
  • Page 379 TRIGger:A:LOGIc:THReshold? Description This query-only command returns the threshold voltage for all channels in A logic trigger. This command query is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then viewing the current Input Threshold voltage settings. Group Trigger Related Commands...
  • Page 380 TRIGger:A:LOGIc:THReshold:CH<x> Description This command sets or queries the A logic trigger threshold voltage for the channel, specified by x, which ranges from 1 through 4. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then setting the desired Input Threshold voltage for the desired channel. Group Trigger Related Commands...
  • Page 381 TRIGger:A:MODe Description This command sets or queries the A trigger mode. This command is equivalent to selecting Mode from the Trig menu and then choosing the desired Trigger Mode. Group Trigger Related Commands TRIGger:A:LEVel (see page 353) Syntax 1 TRIGger:A:MODe {AUTO|NORMal} Syntax 2 TRIGger:A:MODe? Arguments...
  • Page 382 TRIGger:A:PULse? Description This query-only command returns the A pulse trigger parameters. Group Trigger Related Commands TRIGger:A:EDGE? (see page 345), TRIGger:A:LOGIc? (see page 354) Syntax TRIGger:A:PULse? Example TRIGger:A:PULse? This query might return :TRIGGER:A:PULSE:CLASS GLITCH;SOURCE CH1;GLITCH:WIDTH 2.0000E-9;TRIGIF ACCEPT;POLARITY POSITIVE;:TRIGGER:A:PULSE:RUNT:POLARITY POSITIVE ;THRESHOLD:HIGH 1.2000;LOW 800.0000E-3;:TRIGGER:A:PULSE :RUNT:WHEN OCCURS;WIDTH 2.0000E-9;:TRIGGER:A:PULSE: TRANSITION:DELTATIME 2.0000E-9;POLARITY POSITIVE ;THRESHOLD:HIGH 1.2000;LOW 800.0000E-3;:TRIGGER:A...
  • Page 383 TRIGger:A:PULse:CLAss Description This command sets or queries the type of pulse on which to trigger. This command is equivalent to selecting A Event (Main) Trigger Setup from the Trig menu and then choosing the desired pulse Trigger Type. Group Trigger Related Commands TRIGger:A:PULse:GLItch? (see page 382), TRIGger:A:PULse:RUNT? (see page 386), TRIGger:A:PULse:WIDth? (see page 406), TRIGger:A:PULse:TIMEOut? (see page 403),...
  • Page 384 TRIGger:A:PULse:GLItch? Description This query-only command returns the current A glitch pulse trigger parameters. This command query is equivalent to selecting Glitch Setup from the Trig menu and then viewing the current pulse glitch settings. Group Trigger Related Commands TRIGger:A:PULse:GLItch:POLarity (see page 383), TRIGger:A:PULse:GLItch:TRIGIF(see page 384), TRIGger:A:PULse:GLItch:WIDth (see page 385) Syntax TRIGger:A:PULse:GLItch?
  • Page 385 TRIGger:A:PULse:GLItch:POLarity Description This command sets or queries the polarity for A pulse glitch trigger. This command is equivalent to selecting Glitch Setup from the Trig menu and then choosing the desired Polarity. Group Trigger Related Commands TRIGger:A:LEVel (see page 353), TRIGger:A:PULse:GLItch:WIDth (see page 385) Syntax 1 TRIGger:A:PULse:GLItch:POLarity {POSITIVe|NEGative|EITher} Syntax 2...
  • Page 386 TRIGger:A:PULse:GLItch:TRIGIF Description This command sets or queries the acceptance/rejection of the glitch pulse trigger, based on width. This command is equivalent to selecting Glitch Setup from the Trig menu and then choosing the desired Trig if Width setting. Group Trigger Related Commands TRIGger:A:PULse:GLItch:WIDth (see page 385) Syntax 1...
  • Page 387 TRIGger:A:PULse:GLItch:WIDth Description This command sets or queries the width for the A pulse glitch trigger. This command is equivalent to selecting Glitch Setup from the Trig menu and then setting the desired Width. For information about using the width value, refer to the TRIGger:A:PULse:GLItch:TRIGIF command. Group Trigger Related Commands...
  • Page 388 TRIGger:A:PULse:RUNT? Description This query-only command returns the current A runt pulse trigger parameters. This command query is equivalent to selecting Runt Setup from the Trig menu and then viewing the current settings. Group Trigger Related Commands TRIGger:A:PULse:GLItch? (see page 382), TRIGger:A:PULse:TIMEOut? (see page 403), TRIGger:A:PULse:TRANsition? (see page 394), TRIGger:A:PULse:WIDth? (see page 406) Syntax TRIGger:A:PULse:RUNT?
  • Page 389 TRIGger:A:PULse:RUNT:POLarity Description This command sets or queries the polarity for the A pulse runt trigger. This command is equivalent to selecting Runt Setup from the Trig menu and then choosing the Polarity setting. Group Trigger Related Commands TRIGger:A:PULse:RUNT:THReshold? (see page 388) Syntax 1 TRIGger:A:PULse:RUNT:POLarity {POSITIVe|NEGAtive|EITher} Syntax 2...
  • Page 390 TRIGger:A:PULse:RUNT:THReshold? Description This query-only command returns the upper and lower thresholds for the A pulse runt trigger. This command query is equivalent to selecting Runt Setup from the Trig menu and then viewing the runt trigger Upper Level and Lower Level settings. Group Trigger Related Commands...
  • Page 391 TRIGger:A:PULse:RUNT:THReshold:BOTh Description This command (no query form) sets the upper and lower switching thresholds for the A pulse runt trigger. This command is equivalent to selecting Runt Setup from the Trig menu and then setting the desired runt trigger Upper Level and Lower Level voltages. Group Trigger Related Commands...
  • Page 392 TRIGger:A:PULse:RUNT:THReshold:HIGH Description This command sets or queries the upper limit for the A pulse runt trigger. This command is equivalent to selecting Runt Setup from the Trig menu and then setting the desired runt trigger Upper Level voltage. Group Trigger Related Commands TRIGger:A:PULse:RUNT:THReshold? (see page 388) Syntax 1...
  • Page 393 TRIGger:A:PULse:RUNT:THReshold:LOW Description This command sets or queries the lower limit for the A pulse runt trigger. This command is equivalent to selecting Runt Setup from the Trig menu and then setting the desired runt trigger Lower Level voltage. Group Trigger Related Commands TRIGger:A:PULse:RUNT:THReshold? (see page 388) Syntax 1...
  • Page 394 TRIGger:A:PULse:RUNT:WHEn Description This command sets or queries the type of pulse width the trigger checks for when it uncovers a runt. This is equivalent to selecting Runt Setup from the Trig menu and then choosing the desired Trigger When setting from the Runt drop-down list. Group Trigger Related Commands...
  • Page 395 TRIGger:A:PULse:RUNT:WIDth Description This command sets or queries the minimum width for a valid A pulse runt trigger. This command is equivalent to selecting Runt Setup from the Trig menu and then setting the desired Width. Group Trigger Related Commands TRIGger:A:PULse:RUNT:WHEn (see page 392) Syntax 1 TRIGger:A:PULse:RUNT:WIDth <NR3>...
  • Page 396 TRIGger:A:PULse:TRANsition? Description This query-only command returns delta time, polarity, and both upper and lower threshold limits for the transition time trigger. This command is equivalent to selecting Transition Setup from the Trig menu and then viewing the current transition settings. Group Trigger Related Commands...
  • Page 397 TRIGger:A:PULse:TRANsition:DELTATime Description This command sets or queries the delta time used in calculating the transition value. This is equivalent to selecting Transition Setup from the Trig menu and then setting the desired Time. Group Trigger Related Commands TRIGger:A:PULse:TRANsition:POLarity (see page 396), TRIGger:A:PULse:TRANsition:THReshold? (see page 397) Syntax 1 TRIGger:A:PULse:TRANsition:DeltaTime <NR3>...
  • Page 398 TRIGger:A:PULse:TRANsition:POLarity Description This command sets or queries the polarity for the A pulse transition trigger. This command is equivalent to selecting Transition Setup from the Trig menu and then choosing from the Polarity pull-down list. Group Trigger Related Commands TRIGger:A:PULse:TRANsition:DELTATime (see page 395) Syntax 1 TRIGger:A:PULse:TRANsition:POLarity {POSITIVe|NEGative|EITher} Syntax 2...
  • Page 399 TRIGger:A:PULse:TRANsition:THReshold? Description This query-only command returns the upper and lower threshold limits for the transition time trigger. This command is equivalent to selecting Transition Setup from the Trig menu and then viewing the Upper Level and Lower Level voltage settings. Group Trigger Related Commands...
  • Page 400 TRIGger:A:PULse:TRANsition:THReshold:BOTh Description This command (no query form) sets the upper and lower thresholds for pulse transition trigger. This command is equivalent to selecting Transition Setup from the Trig menu and then setting the desired Upper Level and Lower Level voltages. Group Trigger Related Commands...
  • Page 401 TRIGger:A:PULse:TRANsition:THReshold:HIGH Description This command sets or queries the upper (most positive) transition trigger threshold. This command is equivalent to selecting Transition Setup from the Trig menu and then setting the desired Upper Level voltage. Group Trigger Related Commands TRIGger:A:PULse:TRANsition:THReshold:LOW (see page 400) Syntax 1 TRIGger:A:PULse:TRANsition:THReshold:HIGH <NR3>...
  • Page 402 TRIGger:A:PULse:TRANsition:THReshold:LOW Description This command sets or queries the lower (most negative) transition trigger threshold. This command is equivalent to selecting Transition Setup from the Trig menu and then setting the desired Lower Level voltage. Group Trigger Related Commands TRIGger:A:PULse:TRANsition:THReshold:HIGH (see page 399) Syntax 1 TRIGger:A:PULse:TRANsition:THReshold:LOW <NR3>...
  • Page 403 TRIGger:A:PULse:TRANsition:WHEn Description This command sets or queries whether to check for a transitioning signal that is faster or slower than the specified delta time. This is equivalent to selecting Transition Setup from the Trig menu and then choosing the desired Trigger When Transition Time setting. Group Trigger Related Commands...
  • Page 404 TRIGger:A:PULse:SOUrce Description This command sets or queries the source for the A pulse trigger. This source parameter applies to all classes of pulse trigger. This command is equivalent to selecting Transition Setup from the Trig menu and then choosing the desired channel from the Source pull-down list. Group Trigger Related Commands...
  • Page 405 TRIGger:A:PULse:TIMEOut? Description This query-only command returns the polarity and time-out duration for the A pulse time-out trigger. This command is equivalent to selecting Transition Setup from the Trig menu and then viewing the current Polarity and Time settings. Group Trigger Related Commands TRIGger:A:PULse:TIMEOut:POLarity (see page 404), TRIGger:A:PULse:TIMEOut:TIMe (see page 405) Syntax...
  • Page 406 TRIGger:A:PULse:TIMEOut:POLarity Description This command sets or queries the polarity for the A pulse time-out trigger. This command is equivalent to selecting Transition Setup from the Trig menu and then setting the desired Polarity. Group Trigger Related Commands TRIGger:A:PULse:TIMEOut? (see page 403) Syntax 1 TRIGger:A:PULse:TIMEOut:POLarity {STAYSHigh|STAYSLow|EITher} Syntax 2...
  • Page 407 TRIGger:A:PULse:TIMEOut:TIMe Description This command sets or queries the pulse time-out trigger time, in seconds. This command is equivalent to selecting Transition Setup from the Trig menu and then setting the desired time-out Time. Group Trigger Related Commands TRIGger:A:PULse:TIMEOut? (see page 403) Syntax 1 TRIGger:A:PULse:TIMEOut:TIMe <NR3>...
  • Page 408 TRIGger:A:PULse:WIDth? Description This query-only command returns the width parameters for the A pulse width trigger. This command is equivalent to selecting Width Setup from the Trig menu and then viewing the current pulse width trigger Lower Limit, Upper Limit, Trig When and Polarity settings. Group Trigger Related Commands...
  • Page 409 TRIGger:A:PULse:WIDth:HIGHLimit Description This command sets or queries the upper limit for the A pulse width trigger. This command is equivalent to selecting Width Setup from the Trig menu and then setting the pulse width trigger Upper Limit. Group Trigger Related Commands TRIGger:A:PULse:WIDth? (see page 406) Syntax 1 TRIGger:A:PULse:WIDth:HIGHLimit <NR3>...
  • Page 410 TRIGger:A:PULse:WIDth:LOWLimit Description This command sets or queries the lower limit for the A pulse width trigger. This command is equivalent to selecting Width Setup from the Trig menu and then setting the pulse width trigger Lower Limit. Group Trigger Related Commands TRIGger:A:PULse:WIDth? (see page 393) Syntax 1 TRIGger:A:PULse:WIDth:LOWLimit <NR3>...
  • Page 411 TRIGger:A:PULse:WIDth:POLarity Description This command sets or queries the polarity for the A pulse width trigger. This command is equivalent to selecting Width Setup from the Trig menu and then selecting the pulse width trigger Polarity. Group Trigger Related Commands TRIGger:A:PULse:WIDth? (see page 406) Syntax 1 TRIGger:A:PULse:WIDth:POLarity {NEGAtive|POSITIVe} Syntax 2...
  • Page 412 TRIGger:A:PULse:WIDth:WHEn Description This command sets or queries whether to trigger on a pulse width that falls outside (or within) the specified range of limits. You can define or query trigger pulse width upper and lower limits using the TRIGger:A:PULse:WIDth:HIGHLimit and TRIGger:A:PULse:WIDth:LOWLimit commands. This command is equivalent to selecting Width Setup from the Trig menu and then choosing from the Trig When drop-down list.
  • Page 413 TRIGger:STATE? Description This query-only command returns the current state of the triggering system. This command is equivalent to viewing the trigger status LEDs on the instrument front-panel. Group Trigger Related Commands TRIGger:A:MODe (see page 379) Syntax TRIGger:STATE? Outputs • ARMed This indicates that the oscilloscope is acquiring pretrigger information.
  • Page 414 TRIGger:A:TYPe Description This command sets or queries the type of A trigger. The three types of triggers consist of Edge, Logic, and Pulse. Both Logic and Pulse triggers contain classes. Logic triggers consist of State and Pattern classes; Pulse triggers consist of Glitch, Runt, Width, Transition, and Timeout classes. Once you have set the trigger type, you may also need to identify the associated trigger class.
  • Page 415 TRIGger:B Description This command sets the B trigger level to 50% of minimum and maximum. The query form of this command returns the B trigger parameters. This command is similar to selecting B Event (Delayed) Trigger Setup from the Trig menu and then viewing the current setups. Group Trigger Related Commands...
  • Page 416 TRIGger:B:BY Description This command selects or returns whether the B trigger occurs after a specified number of events or a specified period of time after the A trigger. This is equivalent to selecting B Event (Delayed) Trigger Setup from the Trig menu, selecting the A→B Seq tab, and then choosing Trig After Time or Trig on nth event. The traditional Runs After functionality is now served by the Horizontal Delay function.
  • Page 417 TRIGger:B:EDGE? Description This query-only command returns the source, slope, and coupling for the edge type of B trigger. This command is equivalent to selecting B Event (Delayed) Trigger Setup from the Trig menu and then viewing the current Source, Slope, and Coupling settings. Group Trigger Related Commands...
  • Page 418 TRIGger:B:EDGE:COUPling Description This command sets or queries the type of coupling for the B trigger. This command is equivalent to selecting B Event (Delayed) Trigger Setup from the Trig menu and then choosing the desired setting from the Coupling drop-down list. Group Trigger Related Commands...
  • Page 419 TRIGger:B:EDGE:SLOpe Description This command sets or queries the slope for the B edge trigger. This command is equivalent to selecting B Event (Delayed) Trigger Setup from the Trig menu and then choosing the desired Slope. Group Trigger Related Commands TRIGger:B:EDGE? (see page 415) Syntax 1 TRIGger:B:EDGE:SLOpe {RISe|FALL} Syntax 2...
  • Page 420 TRIGger:B:EDGE:SOUrce Description This command sets or queries the source for the B edge trigger. This command is equivalent to selecting B Event (Delayed) Trigger Setup from the Trig menu and then choosing the desired setting from the Source drop-down list. Group Trigger Related Commands...
  • Page 421 TRIGger:B:EVENTS? Description This query-only command returns the current B trigger events parameter. This command is equivalent to selecting B Event (Delayed) Trigger Setup from the Trig menu, selecting the A→B Seq tab, choosing Trig on nth event, and then viewing the Trig Event setting. Group Trigger Related Commands...
  • Page 422 TRIGger:B:EVENTS:COUNt Description This command sets or queries the number of events that must occur before the B trigger (when TRIG:DELay:BY is set to EVENTS). This command is equivalent to selecting B Event (Delayed) Trigger Setup from the Trig menu, selecting the A→B Seq tab, choosing Trig on nth event, and then setting the desired Trig Event value.
  • Page 423 TRIGger:B:LEVel Description This command sets or queries the level for the B trigger. This command is equivalent to selecting B Event (Delayed) Trigger Setup from the Trig menu, selecting the A→B Seq tab, and then setting the B Trig Level voltage. Group Trigger Related Commands...
  • Page 424 TRIGger:B:STATE Description This command sets or queries the state of B trigger activity. If the trigger B state is on, the B trigger is part of the triggering sequence. If trigger B state is off, then only the A trigger causes the trigger event. Group Trigger Related Commands...
  • Page 425 TRIGger:B:TIMe Description This command sets or queries trigger B delay time. Trigger B time applies only if TRIGger:B:BY is set to TIMe. This command is equivalent to selecting B Event (Delayed) Trigger Setup from the Trig menu, choosing the A→B Seq tab, and then setting Trig Delay. Group Trigger Related Commands...
  • Page 426 TRIGger:B:TYPe Description This command sets or queries the type of B trigger. This command is equivalent to selecting B Event (Delayed) Trigger Setup from the Trig menu and then choosing Edge. Group Trigger Related Commands TRIGger:A:TYPe (see page 412) Syntax 1 TRIGger:B:TYPe EDGE Syntax 2 TRIGger:B:TYPe?

  • Page 427: Vertical Command Group

    The SELect:<wfm> command also selects the waveform that many commands in other command groups use. You may replace VOLts with SCAle in the vertical commands. This provides program compatibility with earlier models of Tektronix oscilloscopes.
  • Page 428 Vertical Commands Command Description CH<x>? Returns vertical parameters for the specified channel CH<x>:BANdwidth? Returns the bandwidth of the specified channel CH<x>:BANdwidth Sets the bandwidth of the specified channel CH<x>:COUPling? Returns the coupling setting for the specified channel CH<x>:COUPling Sets the coupling for the specified channel CH<x>:DESKew? Returns the deskew time for the...
  • Page 429 attached to the specified channel CH<x>:PROBEFunc:EXTatten? Returns the user-specified attenuation CH<x>:PROBEFunc:EXTatten Sets the attenuation value for the specified channel to the specified scale factor CH<x>PROBEFunc:EXTDBatten Returns the user-specified attenuation, in decibels CH<x>PROBEFunc:EXTDBatten Sets the attenuation value for the specified channel to the specified value, in decibels CH<x>PROBEFunc:EXTUnits? Returns the user-specified unit of...
  • Page 430 specified reference waveform REF<x>:SCAle Sets the vertical scale of the specified reference waveform SELect? Return information on which waveforms are ON/OFF and which is the selected waveform. SELect:<wfm>? Returns whether the specified channel is on or off SELect<wfm> Turns on the specified waveform SELect:CONTRol? Returns the waveform and time base selected for front-panel control.
  • Page 431 CH<x>? Description This query-only command returns the vertical parameters for the specified channel. The channel is specified by x, which ranges from 1 through 4. This command is similar to selecting Vertical Setup from the Vertical menu. Group Vertical Syntax CH<x>? Example CH1?
  • Page 432 CH<x>:BANdwidth Description This command sets or queries the selectable low-pass bandwidth limit filter of the specified channel. This is equivalent to selecting Bandwidth from the Vertical menu. Group Vertical Syntax 1 CH<x>:BANdwidth {TWEnty|TWOfifty|FULl|<NR3>} Syntax 2 CH<x>:BANdwidth? Arguments • TWEnty This sets the upper bandwidth limit to 20 MHz. •...
  • Page 433 CH<x>:COUPling Description This command sets or queries the input attenuator coupling setting for the specified channel. This command is equivalent to selecting Coupling from the Vertical menu. Group Vertical Syntax 1 CH<x>:COUPling {AC|DC|GND} Syntax 2 CH<x>:COUPling? Arguments • AC This sets the specified channel to AC coupling. •...
  • Page 434 CH<x>:DESKew Description This command sets or queries the deskew time for the specified channel. The channel is specified by x, which can range from 1 through 4. This command is equivalent to selecting Deskew from the Vertical Setup menu. You can adjust the deskew time to add an independent, channel-based delay time to the delay (set by the horizontal position control and common to all channels) from the common trigger point to first sample taken for each channel.
  • Page 435 CH<x>:LABEL:NAMe Description This command sets or queries the label attached to the displayed waveform for the specified channel. This command is equivalent to selecting Label from the Vertical menu. Group Vertical Syntax 1 CH<x>:LABEL:NAMe <str> Syntax 2 CH<x>:LABEL:NAMe? Argument • <str> This is an alphanumeric character string, ranging from 1 through 32 characters in length.
  • Page 436 CH<x>:LABEL:XPOS Description This command sets or queries the X screen offset at which the label (attached to the displayed waveform of the specified channel) is displayed, relative to the left edge of the screen. Channels are specified by x, which ranges from 1 through 4. This command is equivalent to selecting Label from the Vertical menu and either viewing or setting X Pos.
  • Page 437 CH<x>:LABEL:YPOS Description This command sets or queries the Y screen offset at which the label (attached to the displayed waveform of the specified channel) is displayed, relative to the top edge of the screen. Channels are specified by x, which ranges from 1 through 4. This command is equivalent to selecting Label from the Vertical menu and either viewing or setting Y Pos.
  • Page 438 CH<x>:OFFSet Description This command sets or queries the vertical offset for the specified channel. The channel is specified by x, which can range from 1 through 4. This command is equivalent to selecting Offset from the Vertical menu. This command offsets the vertical acquisition window (moves the level at the vertical center of the acquisition window) for the selected channel.
  • Page 439 CH<x>:POSition Description This command sets or queries the vertical position of the specified channel. The channel is specified by x, which ranges from 1 through 4. The position value is applied to the signal before it is digitized. This command is equivalent to selecting Position/Scale from the Vertical menu and either viewing or setting Position.
  • Page 440 CH<x>:PRObe? Description This query-only command returns all information concerning the probe that is attached to the specified channel. The channel is specified by x, which ranges from 1 through 4. Group Vertical Related Commands CALibrate:PRObestate:CH<x>? (see page 43), CH<x>:PROBECal? (see page 439) Syntax CH<x>:PROBE? Example...
  • Page 441 CH<x>:PROBECal? Description This query-only command returns the probe calibration state for the selected channel. The channel is specified by x, which ranges from 1 through 4. This command is equivalent to selecting Probe Cal from the Vertical menu. Group Vertical Related Commands CALibrate:PRObestate:CH<x>? (see page 43) Syntax...
  • Page 442 CH<x>:PRObe:GAIN? Description This query-only command returns the gain factor of the probe that is attached to the specified channel. The channel is specified by x, which ranges from 1 through 4. The "gain" of a probe is the output divided by the input transfer ratio.
  • Page 443 CH<x>:PRObe:ID? Description This query-only command returns the type and serial of the probe that is attached to the specified channel. The channel is specified by x, which ranges from 1 through 4. Group Vertical Syntax CH<x>:PRObe:ID? Example CH2:PRObe:ID? This query might return , indicating that a passive 10x :CH2:PROBE:ID:TYPE "10X";SERNUMBER "N/A"...
  • Page 444 CH<x>:PRObe:ID:TYPe? Description This query-only command returns the type of probe that is attached to the specified channel. The channel is specified by x, which ranges from 1 through 4. Level 2 (or higher) probes supply their exact product nomenclature; for Level 0 or 1 probes, a generic 'type string' of "nnX" is returned. Group Vertical Syntax...
  • Page 445 CH<x>:PRObe:ID:SERnumber? Description This query-only command returns the serial number of the probe that is attached to the specified channel. The channel is specified by x, which ranges from 1 through 4. Note: For Level 0 and 1 probes, the serial number will be "N/A". Group Vertical Syntax...
  • Page 446 CH<x>:PRObe:RESistance? Description This query-only command returns the resistance factor of the probe that is attached to the specified channel. The channel is specified by x, which ranges from 1 through 4. Group Vertical Syntax CH<x>:PRObe:RESistance? Example CH2:PRObe:RESistance? This query might return , indicating that the input resistance of the :CH2:PROBE:RESISTANCE 10.0000E+06 probe attached to Channel 2 is 10.0 megOhms.
  • Page 447 CH<x>:PRObe:UNIts? Description This query-only command returns a string describing the units of measure for the probe attached to the specified channel. The channel is specified by x, which ranges from 1 through 4. Group Vertical Related Commands CH<x>:PROBEFunc:EXTUnits (see page 448) Syntax CH<x>:PRObe:UNIts? Example...
  • Page 448 CH<x>:PROBEFunc:EXTatten Description This command instructs the oscilloscope when to make vertical settings (offset and scale) for the specified channel effective. The vertical settings become effective at the input of the external network or transducer (of a specified input÷output transfer ratio) when the output is connected to the input of the probe attached to the channel.
  • Page 449 CH<x>:PROBEFunc:EXTDBatten Description This command instructs the oscilloscope to make the vertical scale and offset settings for a specified channel effective at the input of an external network or transducer (with a specified input ÷ output transfer ratio in decibels). It is assumed that the input of the probe for the specified channel is connected to the output of this network or transducer.
  • Page 450 CH<x>:PROBEFunc:EXTUnits Description This command sets the unit of measurement for the external attenuator of the specified channel. The channel is specified by x, which ranges from 1 through 4. There is also a corresponding query that returns the user-specified unit of measurement for the external attenuator. Unless these units are set to the factory default string value of "None", they become the attenuated units of measure for that channel.
  • Page 451 CH<x>:SCAle Description This command sets or queries the vertical scale of the specified channel. The channel is specified by x, which can range from 1 through 4. Sending this command is equivalent to selecting Vertical Setup from the Vertical menu and then viewing or setting the Scale. Each waveform has a vertical scale parameter.
  • Page 452 CH<x>:TERmination Description This command sets the connected/disconnected status of a 50 ohm resistor, which may be connected between the specified channel's coupled input and oscilloscope ground. The channel is specified by x, which ranges from 1 through 4. There is also a corresponding query that requests the termination parameter and translates this enumeration into one of the two float values.
  • Page 453 MATH<x>:POSition? Description This command sets or queries the vertical position of the specified Math waveform. The Math waveform is specified by x, which can range from 1 through 4. The position value is usually applied to the signal before it is digitized. The highest three units/div scale ranges of a given math are implemented by changing the way the acquired data is displayed.
  • Page 454 MATH<x>:SCAle Description This command sets or queries the vertical scale of the specified math waveform. The math waveform is specified by x, which can range from 1 through 4. This command is equivalent to selecting Position/Scale from the Math menu and then entering a Vert Scale value or adjusting the front-panel Vertical SCALE knob.
  • Page 455 REF<x>:LABel? Description This query-only command returns a branch query containing the waveform label name and the coordinates at which the label (attached to the displayed waveform of the specified reference) is displayed. References are specified by x, which ranges from 1 through 4. This command is equivalent to selecting Reference Waveforms from the File menu and then choosing Label from the drop-down list.
  • Page 456 REF<x>:LABel:NAMe Description This command sets or queries the label of the designated waveform. References are specified by x, which ranges from 1 through 4. This command is equivalent to selecting Reference Waveforms from the File menu and then choosing Reference Setup from the drop-down list. Then select the tab associated with the reference for which you want to create a label and then enter a label in the Label box.
  • Page 457 REF<x>:LABel:XPOS Description This command sets or queries the X screen offset at which the label (attached to the displayed waveform of the specified reference) is displayed, relative to the left edge of the screen. References are specified by x, which ranges from 1 through 4. This command is equivalent to selecting Reference Waveforms from the File menu and then choosing Reference Setup from the drop-down list.
  • Page 458 REF<x>:LABel:YPOS Description This command sets or queries the Y screen offset at which the label (attached to the displayed waveform of the specified reference) is displayed, relative to the top edge of the screen. References are specified by x, which ranges from 1 through 4. This command is equivalent to selecting Reference Waveforms from the File menu and then choosing Reference Setup from the drop-down list.

  • Page 459: Ref :Position

    REF<x>:POSition Description This command sets or queries the vertical position of the specified reference waveform. The reference waveform is specified by x, which ranges from 1 through 4. This command is equivalent to selecting Reference Waveforms from the File menu, choosing Reference Setup from the drop-down list and then entering the desired Position value.
  • Page 460 REF<x>:SCAle Description This command sets or queries the vertical scale of the specified reference waveform. The reference is specified by x, which can range from 1 through 4. Each waveform has a vertical scale parameter. For a signal with constant amplitude, increasing the Scale causes the waveform to be displayed smaller.
  • Page 461 SELect? Description This query-only command returns the selected waveform that is affected by the front-panel controls and the display status (on or off) of all waveforms. This query command is equivalent to selecting Measurement Setup from the Measure menu and viewing the Source waveform setting. Group Vertical Syntax...
  • Page 462 SELect:<wfm> Description This command turns on a specified waveform. This action also resets the acquisition. The query returns whether the channel is on or off but does not indicate whether it is the selected waveform. Group Vertical Syntax 1 SELect:<wfm> {ON|OFF|<NR1>} Syntax 2 SELect:<wfm>? Arguments...

  • Page 463: Select:control

    SELect:CONTRol <wfm> Description This command sets or queries the waveform that is selected as the 'implied' recipient of channel-related commands that support legacy style programs. The command form also performs the equivalent of a SELECT:<wfm> ON command. This command is equivalent to selecting Measurement Setup from the Measure menu and either viewing or setting the Source waveform.

  • Page 464: Waveform Transfer Command Group

    Waveform Transfer Command Group Waveform Transfer Overview You use the commands in the Waveform transfer Command Group to transfer waveform data points to and from the instrument. Waveform data points are a collection of values that define a waveform. One data value usually represents one data point in the waveform record.
  • Page 465 oscilloscope. You can only transfer one waveform at a time. Waveforms sent to the instrument are always stored in one of the four reference memory locations. You use the DATa:DESTination command to specify a reference memory location. Waveform Preamble Each waveform that you transfer has an associated waveform preamble that contains information such as the horizontal scale, the vertical scale, and other settings in effect when the waveform was created.
  • Page 466 Waveform Transfer Commands Command Description CURve? Transfers waveform data from instrument specified by the DATa:SOUrce command CURVe Transfer waveform data to the instrument (reference memory location specified by DATa:DESTination) DATa? Returns waveform data format and location DATa Sets the waveform data format and location DATa:DESTination? Returns the reference memory location for storing waveform data sent to the...
  • Page 467 WFMInpre:ENCdg? Returns the type of encoding for incoming waveform data WFMInpre:ENCdg Sets the type of encoding for incoming waveform data WFMInpre:NR_Pt? Returns the number of points in the transmitted waveform record WFMInpre:NR_Pt Sets the number of points in the transmitted waveform record WFMInpre:PT_Fmt? Returns the point format of incoming...
  • Page 468 point that outgoing waveforms contain WFMOutpre:BIT_Nr Sets the number of bits per waveform point that outgoing waveforms contain WFMOutpre:BN_Fmt? Returns the format of binary data for the waveform WFMOutpre:BN_Fmt Sets the format of binary data for the waveform WFMOutpre:BYT_Nr? Returns the data width for the waveform WFMOutpre:BYT_Nr Sets the data width for the waveform WFMOutpre:BYT_Or?
  • Page 469 CURVe Description This command transfers waveform data to and from the oscilloscope. Each waveform that is transferred has an associated waveform preamble that contains information such as data format and scale. The CURVe? query transfers data from the instrument. The data source is specified by the DATa:SOUrce command.
  • Page 470 DATa Description This command sets or queries the format and location of the waveform data that is transferred with the CURVe command. Group Waveform Transfer Related Commands CURVe (see page 467), DATa:STARt (see page 473), DATa:STOP (see page 474), DATa:ENCdg (see page 470) Syntax 1 DATa {INIT|SNAp}...

  • Page 471: Data:destination

    DATa:DESTination Description This command sets or queries the reference memory location for storing waveform data that is transferred into the oscilloscope by the CURVe command. Group Waveform Transfer Related Commands CURVe (see page 467) Syntax 1 DATa:DESTination REF<x> Syntax 2 DATa:DESTination? Argument •...
  • Page 472 DATa:ENCdg Description This command sets or queries the format of outgoing waveform data. This command is equivalent to setting WFMOutpre:ENCdg, WFMOutpre:BN_Fmt, and WFMOutpre:BYT_Or. Setting the DATa:ENGdg value causes the corresponding WFMOutpre values to be updated and visa versa. Values are constrained (for outbound data) to the format of the data specified by DATa:SOUrce. Note: Group Waveform Transfer...
  • Page 473 • SFPbinary This specifies floating point data in IBM format. D AT a an d W FM O UT PR E P a r a m et e r S et t i n g s WFMOUTPRE Settings DATa:ENCdg Setting :ENCdg :BN_Fmt :BYT_Or...

  • Page 474: Data:source

    DATa:SOUrce Description This command sets or queries the location of waveform data that is transferred from the oscilloscope by the CURVe? Query. Group Waveform Transfer Related Commands CURVe? (see page 467) Syntax 1 DATa:SOUrce <wfm>[<,><wfm>] Syntax 2 DATa:SOUrce? Argument • <wfm> This is the location of the waveform data that will be transferred from the oscilloscope to the controller.
  • Page 475 DATa:STARt Description This command sets or queries the starting data point for waveform transfer. This command allows for the transfer of partial waveforms to and from the oscilloscope. Group Waveform Transfer Related Commands DATa (see page 468), DATa:STOP (see page 474), WFMInpre:NR_Pt (see page 482), WFMOutpre:NR_Pt (see page 499) Syntax 1 DATa:STARt <NR1>...
  • Page 476 DATa:STOP Description This command sets or queries the last data point that will be transferred when using the CURVe? query. This command allows for the transfer of partial waveforms to the controller. When using the CURVe command, DATa:STOP is ignored and WFMInpre:NR_Pt is used.
  • Page 477 WAVFrm? Description This query-only command returns WFMOutpre? and CURVe? data for the waveform as specified by the DATA:SOUrce command. This command is equivalent to sending both WFMOutpre? and CURVe?, with the additional provision that the response to WAVFrm? is guaranteed to provide a synchronized preamble and curve.
  • Page 478 WFMInpre? Description This query-only command returns the waveform formatting specification to be applied to the next incoming CURVe command data. Group Waveform Transfer Related Commands CURVe (see page 467), WFMOutpre? (see page 493) Syntax WFMInpre? Example WFMInpre? This query might return :WFMINPRE:BIT_NR 8;BN_FMT RI;BYT_NR 1;BYT_OR MSB;ENCDG BIN;NR_PT 500;PT_FMT Y;PT_OFF 0;XINCR 2.0000E-6;XZERO 1.7536E-6;XUNIT "s";YMULT 1.0000E-3;YOFF 0.0000;YZERO 0.0000;YUNIT "V"...
  • Page 479 WFMInpre:ENCdg Description This command sets or queries the type of encoding for incoming waveform data. Group Waveform Transfer Related Commands WFMOutpre:ENCdg (see page 494) Syntax 1 WFMInpre:ENCdg {ASC|BIN} Syntax 2 WFMInpre:ENCdg? Arguments • ASC This specifies that the incoming data is in ASCII format. •...
  • Page 480 WFMInpre:BN_Fmt Description This command sets or queries the format of binary data for incoming waveforms. Group Waveform Transfer Related Commands WFMOutpre:BN_Fmt (see page 496) Syntax 1 WFMInpre:BN_Fmt {RI|RP|FP} Syntax 2 WFMInput:BN_Fmt? Arguments • RI This specifies signed integer datapoint representation. •...
  • Page 481 WFMInpre:BYT_Or Description This command sets or queries which byte of binary waveform data is transmitted first for incoming waveform data when data points require more than one byte. This specification only has meaning when WFMInpre:ENCdg is set to BIN and WFMInpre:BYT_Nr is greater than 1. Group Waveform Transfer Related Commands...
  • Page 482 WFMInpre:BYT_Nr Description This command sets or returns the binary field data width for the first ordered waveform, as specified by the DATa:DESTination command. This specification is only meaningful when WFMInpre:ENCdg is set to BIN and WFMInpre:BN_Fmt is set to either RI or RP. Group Waveform Transfer Related Commands...
  • Page 483 WFMInpre:BIT_Nr Description This command sets or returns the number of bits per binary waveform point for the waveform, as specified by the DATa:DESTination command. This specification is only meaningful when WFMInpre:ENCdg is set to BIN. Group Waveform Transfer Related Commands DATa:DESTination (see page 469), WFMInpre:ENCdg (see page 477), WFMInpre:BYT_Nr (see page 480), WFMOutpre:BIT_Nr (see page 495) Syntax 1...
  • Page 484 WFMInpre:NR_Pt Description This command sets or returns the number of points that are in the transmitted waveform record. Group Waveform Transfer Related Commands WFMInpre:PT_Fmt (see page 483), WFMOutpre:NR_Pt? (see page 499) Syntax 1 WFMInpre:NR_Pt <NR1> Syntax 2 WFMInpre:NR_Pt? Argument • <NR1> If WFMInpre:PT_Fmt is set to Y, this is the number of data points;...
  • Page 485 WFMInpre:PT_Fmt Description This command sets or queries the point format of the incoming waveform data. Regardless of the argument used, the scale, offset, etc. are interpreted similarly. When ENV is used, waveform data interpreted over the min/max pair; when Y is used, it is interpreted over a single point. Group Waveform Transfer Related Commands...
  • Page 486 WFMInpre:PT_Off Description This command specifies or returns the trigger point, within the waveform record, for the reference waveform specified by the DATa:DESTination command. Group Waveform Transfer Related Commands DATa:DESTination (see page 469), DATa:STARt (see page 473), WFMOutpre:PT_Off (see page 501) Syntax 1 WFMInpre:PT_Off <NR1>...
  • Page 487 WFMInpre:WFId Description This command (no query form) accepts but ignores the argument. This command is provided only to allow a waveform extracted from the oscilloscope to be more easily imported. Group Waveform Transfer Related Commands DATa:DESTination (see page 469), WFMInpre:BN_Fmt (see page 478), WFMInpre:ENCdg (see page 477), WFMOutpre:WFid (see page 503) Syntax WFMInpre:WFId <String>...
  • Page 488 WFMInpre:XINcr Description This command sets or queries the horizontal interval between incoming waveform points in units specified by WFMInpre:XUNit. Group Waveform Transfer Related Commands WFMInpre:XUNit (see page 488), WFMOutpre:XINcr (see page 505) Syntax 1 WFMInpre:XINcr <NR3> Syntax 2 WFMInpre:XINcr? Argument •...
  • Page 489 WFMInpre:XZEro Description This command sets or queries the (subsample) time between the trigger sample (designated by PT_OFF) and the occurrence of the actual trigger of the incoming waveform. This value is used to compute TTOFF for the incoming waveform, and is expressed in terms of WFMInpre:XUNit. Group Waveform Transfer Related Commands...
  • Page 490 WFMInpre:XUNit Description This command sets or returns the horizontal units of the incoming waveform. Group Waveform Transfer Related Commands WFMOutpre:XUNit (see page 507) Syntax 1 WFMInpre:XUNit <String> Syntax 2 WFMInpre:XUNit? Argument • <String> This contains a maximum of three alpha characters that represent the horizontal unit of measure for the incoming waveform.
  • Page 491 WFMInpre:YMUlt Description This command sets or queries the vertical scale factor (in units/digitizing level) for the reference waveform, specified by DATa:DESTination, upon a CURVe command. Group Waveform Transfer Related Commands DATa:DESTination (see page 469), WFMInpre:BYT_Nr (see page 480), WFMInpre:YUNit (see page 488) Syntax 1 WFMInpre:YMUlt <NR3>...
  • Page 492 WFMInpre:YOFf Description This command sets or queries the vertical position of the incoming waveform in digitizing levels. Variations in this number are analogous to changing the vertical position of the waveform. For those formats in which WFMInpre:BYT_Nr is important (all nonfloating point formats), this command must take the location of the binary point implied by BYT_NR into consideration.
  • Page 493 WFMInpre:YUNit Description This command sets or queries the vertical units of the incoming waveform. Group Waveform Transfer Related Commands WFMOutpre:YUNit (see page 510) Syntax 1 WFMInpre:YUNit <String> Syntax 2 WFMInpre:YUNit? Argument • <String> This contains a maximum of three alpha characters that represent the vertical unit of measure for the incoming waveform.
  • Page 494 WFMInpre:YZEro Description This command sets or queries the offset of the incoming waveform in units specified by WFMInpre:YUNit. Variations in this number are analogous to changing the vertical offset of the waveform. Group Waveform Transfer Related Commands WFMInpre:YUNit (see page 491), WFMOutpre:YZEro (see page 511) Syntax 1 WFMInpre:YZEro <NR3>...
  • Page 495 WFMOutpre? Description This query-only command returns the waveform formatting data for the waveform specified by the DATa:SOUrce command. The preamble components are considered to be of two types; formatting and interpretation. The formatting components are: ENCdg, BN_Fmt, BYT_Or, BYT_Nr, BIT_Nr. The interpretation components are derived from the DATa:SOUrce specified waveform.
  • Page 496 WFMOutpre:ENCdg Description This command sets and queries the type of encoding for outgoing waveforms. Group Waveform Transfer Related Commands DATa:ENCdg (see page 470), WFMOutpre:BYT_Nr (see page 498), WFMOutpre:BYT_Or (see page 497), WFMOutpre:BIT_Nr (see page 495), WFMOutpre:BN_Fmt (see page 496) Syntax 1 WFMOutpre:ENCdg {ASC|BIN} Syntax 2 WFMOutpre:ENCdg?
  • Page 497 WFMOutpre:BIT_Nr Description This command sets and returns the number of bits per waveform point that outgoing waveforms contain, as specified by the DATa:SOUrce command. Note that values will be constrained according to the underlying waveform data. This specification is only meaningful when WFMOutpre:ENCdg is set to BIN and WFMOutpre:BN_Fmt is set to either RI or RP.
  • Page 498 WFMOutpre:BN_Fmt Description This command sets or queries the format of binary data for outgoing waveforms specified by the DATa:SOUrce command. Group Waveform Transfer Related Commands DATa:SOUrce (see page 472) Syntax 1 WFMOutpre:BN_Fmt {RI|RP|FP} Syntax 2 WFMOutput:BN_Fmt? Arguments • RI This specifies signed integer datapoint representation. •...
  • Page 499 WFMOutpre:BYT_Or Description This command sets or queries which byte of binary waveform data is transmitted first, during a waveform data transfer, when data points require more than one byte. This specification only has meaning when WFMOutpre:ENCdg is set to BIN. Group Waveform Transfer Related Commands...
  • Page 500 WFMOutpre:BYT_Nr Description This command sets or returns the binary field data width for the waveform specified by the DATa:SOUrce command. Note that values will be constrained according to the underlying waveform data. This specification is only meaningful when WFMOutpre:ENCdg is set to BIN and WFMOutpre:BN_Fmt is set to either RI or RP.
  • Page 501 WFMOutpre:NR_Pt? Description This query-only command returns the number of points for the DATa:SOUrce waveform that will be transmitted in response to a CURVe? query. Group Waveform Transfer Related Commands CURVe? (see page 467), DATa:SOUrce (see page 472), DATa:STARt (see page 473), DATa:STOP (see page 474) Syntax WFMOutpre:NR_Pt?
  • Page 502 WFMOutpre:PT_Fmt? Description This query-only command returns the point format for the waveform specified by the DATa:SOUrce command. The format specifies a set of equations describing how the scale factors in the preamble are used to give meaning to the CURVe data points. An error is reported if the DATa:SOUrce waveform does not exist.
  • Page 503 WFMOutpre:PT_Off? Description This query-only command returns the trigger point relative to DATa:STARt for the waveform specified by the DATa:SOUrce command. This value is the point immediately following the actual trigger. Note: Group Waveform Transfer Related Commands DATa:SOUrce (see page 472), DATa:STARt (see page 473), WFMOutpre:XZEro? (see page 506) Syntax WFMOutpre:PT_Off? Example...
  • Page 504 WFMOutpre:PT_OR? Description This query-only command specifies whether the source waveform is Fast Acquisition. A Fast Acquisition waveform is stored as a 200 (vertical) by 500 (horizontal) point bitmap. Each point represents display intensity for that screen location. Only CURVe? query functions are allowed on Fast Acquisition waveforms.
  • Page 505 WFMOutpre:WFId? Description This query-only command returns a string describing several aspects of the acquisition parameters for the waveform specified by the DATa:SOUrce command. An error is reported if the DATa:SOUrce waveform does not exist. Group Waveform Transfer Related Commands DATa:SOUrce (see page 472) Syntax WFMOutpre:WFId? Outputs...
  • Page 506 This query might return :WFMOUTPRE:WFID "Ch1, DC coupling, 100.0mVolts/div,500.0µs/div,500 points, Hi Res mode"...
  • Page 507 WFMOutpre:XINcr? Description This query-only command returns the horizontal point spacing in units of WFMOutpre:XUNit for the waveform specified by the DATa:SOUrce command. This value corresponds to the sampling interval. An error is reported if the DATa:SOUrce waveform does not exist. Group Waveform Transfer Related Commands...
  • Page 508 WFMOutpre:XZEro? Description This query-only command returns the (subsample) time between the trigger sample (designated by PT_OFF) and the occurrence of the actual trigger for the waveform specified by the DATa:SOUrce command. This value is in units of WFMOutpre:XUNit. An error is reported if the DATa:SOUrce waveform does not exist. Note: During stopped state operation (i.e., ACQuire:STATE OFF), this is the only preamble that changes on each acquisition.
  • Page 509 WFMOutpre:XUNit? Description This query-only command returns the horizontal units for the waveform specified by the DATa:SOUrce command. An error is reported if the DATa:SOUrce waveform does not exist. Group Waveform Transfer Related Commands DATa:SOUrce (see page 472) Syntax WFMOutpre:XUNit? Example WFMOutpre:XUNit? This query might return , indicating that the horizontal units for the waveform are...
  • Page 510 WFMOutpre:YMUlt? Description This query-only command returns the vertical scale factor per digitizing level in units specified by the WFMOutpre:YUNit command for the waveform specified by the DATa:SOUrce command. For those formats in which WFMOutpre:BYT_Nr is important (all nonfloating point formats), WFMOutpre:YMUlt? must take the location of the binary point implied by BYT_NR into consideration.
  • Page 511 WFMOutpre:YOFf? Description This query-only command returns the vertical offset in digitized levels for the waveform specified by the DATa:SOUrce command. For those formats in which BYT_NR is important (all non-floating point formats), this command must take the location of the binary point implied by WFMOutpre:BYT_Nr into consideration.
  • Page 512 WFMOutpre:YUNit? Description This query-only command returns the vertical units for the waveform specified by the DATa:SOUrce command. An error is reported if the DATa:SOUrce waveform does not exist. Group Waveform Transfer Related Commands DATa:SOUrce (see page 472) Syntax WFMOutpre:YUNit? Example WFMOutpre:YUNit? This query might return , indicating that the vertical units for the waveform are...
  • Page 513 WFMOutpre:YZEro? Description This query-only command returns the vertical offset in units specified by WFMOutpre:YUNit for the waveform specified by the DATa:SOUrce command. An error is reported if the DATa:SOUrce waveform does not exist. Group Waveform Transfer Related Commands DATa:SOUrce (see page 472), WFMOutpre:YUNit? (see page 510) Syntax WFMOutpre:YZEro? Example...

  • Page 514: Zoom Command Group

    Zoom Command Group Zoom Overview Zoom commands let you expand and position the waveform display horizontally and vertically without changing the time base or vertical settings.
  • Page 515 Zoom Commands Command Description ZOOm? Returns the current vertical and horizontal positioning and scaling of the display ZOOm Sets the zoom transforms to default values for either live traces or all traces ZOOm:MODE? Returns the current zoom mode ZOOm:MODE Turns zoom mode on or off ZOOm:HORIzontal:LOCk? Returns the waveforms that the horizontal zoom parameters affect...
  • Page 516 ZOOm Description This command resets the zoom transforms to default values for all traces or live traces. The ZOOm query returns the current vertical and horizontal positioning and scaling of the display. Group Zoom Syntax 1 ZOOm {RESET|RESETLive} Syntax 2 ZOOm? Arguments •...

  • Page 517: Zoom Mode

    ZOOm:MODe Description This command turns Zoom mode on or off. The Zoom query returns the current state of Zoom mode. This command is equivalent to pressing the ZOOM button located on the front panel. Group Zoom Syntax 1 ZOOm:MODe {ON|OFF|<NR1>} Syntax 2 ZOOm:MODe Arguments...
  • Page 518 ZOOm:HORizontal:LOCk Description This command sets or queries the waveforms that the horizontal zoom parameter affects. This is equivalent to setting Horizontal Lock in the Zoom side menu. Group Zoom Syntax 1 ZOOm:HORizontal:LOCk {ALL|LIVe|NONe} Syntax 2 ZOOm:HORizontal:LOCk? Arguments • ALL This specifies that all the (CH<x>, Ref<x>, Math<x>) waveforms will be horizontally positioned and scaled together.
  • Page 519 ZOOm:<wfm>:HORizontal:POSition Description This command sets or queries the horizontal position of specified waveform. The setting of the ZOOm:HORizontal:LOCk command determines the waveforms that are affected. For example, if ZOOm:HORizontal:LOCk is set to LIVe, then only live (as opposed to reference) waveforms are affected. Group Zoom Syntax 1...
  • Page 520 ZOOm:<wfm>:HORizontal:SCAle Description This command sets or queries the zoom horizontal scale factor of the specified waveform. Group Zoom Syntax 1 ZOOm:<wfm>:HORizontal:SCAle <NR3> Syntax 2 ZOOm:<wfm>:HORizontal:SCAle? Argument • <NR3> This is the amount of expansion in the horizontal direction. Example 1 ZOOm:CH2:HORizontal:SCAle? This query might return , indicating channel 2 has a horizontal scale...
  • Page 521 ZOOm:<wfm>:VERTical:POSition Description This command sets or queries the Zoom vertical position of the specified waveform. Group Zoom Syntax 1 ZOOm:<wfm>:VERTical:POSition <NR3> Syntax 2 ZOOm:<wfm>:VERTical:POSition? Argument • <NR3> This is the vertical position, expressed in divisions. Example 1 ZOOm:CH1:VERTical:POSition? This query might return , indicating that the zoomed trace is :ZOOm:CH1:VERTical:POSition 0.0000 centered at division 0 of the acquire trace.
  • Page 522 ZOOm:<wfm>:VERTical:SCAle Description This command sets or queries the zoom vertical scale of the specified waveform. Group Zoom Syntax 1 ZOOm:<wfm>:VERTical:SCAle <NR3> Syntax 2 ZOOm:<wfm>:VERTical:SCAle? Argument • <NR3> This is the amount of vertical expansion or compression, which operates on a 1 - 2 - 5 sequence (For example, 1, 2, 5, 10, 20, 50, 100…).

  • Page 523: Status And Events

    Status and Events The oscilloscope provides a status and event reporting system for the GPIB interface. This system informs you of certain significant events that occur within the oscilloscope. The oscilloscope status handling system consists of five 8-bit registers and two queues. The remaining Status subtopics describe these registers and components.
  • Page 524 Registers Overview The registers in the event handling system fall into two functional groups: ! Status Registers contain information about the status of the oscilloscope. They include the Standard Event Status Register (SESR) and the Status Byte Register (SBR). ! Enable Registers determine whether selected types of events are reported to the Status Registers and the Event Queue.
  • Page 525 Status The Standard Event Status Register (SESR) and the Status Byte Register (SBR) record certain types of events that may occur while the oscilloscope is in use. IEEE Std 488.2-1987 defines these registers. Each bit in a Status Register records a particular type of event, such as an execution error or message available.
  • Page 526 S t a t u s B yt e R e g i s t e r ( S B R ) ---- MAV ---- ---- ---- ---- SBR Bit Functions Function 7 (MSB) ------- Not used. Request Service. Obtained from a serial poll.
  • Page 527 Enable DESER, ESER, and SRER allow you to select which events are reported to the Status Registers and the Event Queue. Each Enable Register acts as a filter to a Status Register (the DESER also acts as a filter to the Event Queue) and can prevent information from being recorded in the register or queue. Each bit in an Enable Register corresponds to a bit in the Status Register it controls.
  • Page 528 *PSC Command The *PSC command controls the Enable Registers contents at power-on. Sending *PSC 1 sets the Enable Registers at power on as follows: ! DESER 255 (equivalent to a DESe 255 command) ! ESER 0 (equivalent to an *ESE 0 command) ! SRER 0 (equivalent to an *SRE 0 command) Sending *PSC 0 lets the Enable Registers maintain their values in nonvolatile memory through a power cycle.
  • Page 529 Queues Overview The oscilloscope status and event reporting system contains two queues: the Output Queue and the Event Queue.

  • Page 530: Output Queue

    Output Queue The oscilloscope stores query responses in the Output Queue and empties this queue each time it receives a new command or query message after an <EOM>. The controller must read a query response before it sends the next command (or query) or it will lose responses to earlier queries. Caution: When a controller sends a query, an <EOM>, and a second query, the oscilloscope normally clears the first response and outputs the second while reporting a Query Error (QYE bit in the ESER) to indicate the lost response.

  • Page 531: Event Queue

    Event Queue The Event Queue stores detailed information on up to 33 events. If more than 32 events stack up in the Event Queue, the 32nd event is replaced by event code 350, "Queue Overflow." Read the Event Queue with the EVENT? query (which returns only the event number), with the EVMSG? query (which returns the event number and a text description of the event), or with the ALLEV? query (which returns all the event numbers along with a description of the event).
  • Page 532 Messages Overview The information contained in the topic tabs above covers all the programming interface messages the oscilloscope generates in response to commands and queries. For most messages, a secondary message from the oscilloscope gives more detail about the cause of the error or the meaning of the message.
  • Page 533 No Event The following table shows the messages when the system has no events or status to report. These have no associated SESR bit. N o E ve n t M e s s a g e s C o d e M e s s a g e No events to report;...

  • Page 534: Command Error

    Command Error The following table shows the command error messages generated by improper syntax. Check that the command is properly formed and that it follows the rules in the section on command Syntax. C o m m a n d E r r o r M e s s a g e s ( C M E B i t 5 ) C o d e M e s s a g e Command error...

  • Page 535: Execution Error

    Execution Error The following table lists the execution errors that are detected during execution of a command.
  • Page 536 E x e c u t i o n E r r o r M e s s a g e s ( E X E B i t 4 ) C o d e M e s s a g e Execution error Invalid while in local Settings lost due to RTL...
  • Page 537 2209 Measurement error, No second Mid Ref crossing 2210 Measurement error, No Mid Ref crossing, second waveform 2211 Measurement error, No backwards Mid Ref crossing 2212 Measurement error, No negative crossing 2213 Measurement error, No positive crossing 2214 Measurement error, No crossing 2215 Measurement error, No crossing, second waveform...
  • Page 538 2250 Reference error, Waveform reference file is invalid 2251 Reference error, Waveform preamble does not match actual 2252 Reference error, Source wfm is not valid 2253 Reference error, Too many points received 2254 Reference error, Too few points received 2259 File too big 2261 Calibration error, wait for the...

  • Page 539: Device Error

    Device Error The following table lists the device errors that can occur during oscilloscope operation. These errors may indicate that the oscilloscope needs repair. D e vi c e E r r o r M e s s a g e s ( D D E B i t 3 ) C o d e M e s s a g e Device-specific error...

  • Page 540: System Event

    System Event The following table lists the system event messages. These messages are generated whenever certain system conditions occur. S ys t e m E ve n t M e s s a g e s C o d e M e s s a g e Query event Power on (PON bit 7 set)

  • Page 541: Execution Warning

    Execution Warning The following table lists warning messages that do not interrupt the flow of command execution. These notify you that you may get unexpected results. E x e c u t i o n W a r n i n g M e s s a g e s ( E X E B i t 4 ) C o d e M e s s a g e Measurement warning...

  • Page 542: Internal Warning

    Internal Warning The following table shows internal errors that indicate an internal fault in the oscilloscope. Internal Warning Messages Code Message Internal warning Internal warning, 50 ohm overload...

  • Page 543: Event Handling Sequence

    Event Handling Sequence The figure below shows how to use the status and event handling system. In the explanation that follows, numbers in parentheses refer to numbers in the figure. When an event occurs, a signal is sent to the DESER (1). If that type of event is enabled in the DESER (that is, if the bit for that event type is set to 1), the appropriate bit in the SESR is set to one, and the event is recorded in the Event Queue (2).

  • Page 544: Synchronization Methods

    Synchronization Methods Overview Although most GPIB commands are completed almost immediately after being received by the oscilloscope, some commands start a process that requires more time. For example, once a single sequence acquisition command is executed, it may be a few seconds before the hardcopy operation is complete.
  • Page 545 =========================================================== To ensure the oscilloscope completes waveform acquisition before taking the measurement on the acquired data, you can synchronize the program. =========================================================== ___________________ |ACQUIRE:STATE +-----------------+_____________ |Acquiring |Waveform |Data +----------- +___________________________ |Take Measurement +------------ -------------+ |<------------------------------------------------------->| Processing Time =========================================================== You can use four commands to synchronize the operation of the oscilloscope with your application program: *WAI, BUSY?, *OPC, and *OPC?
  • Page 546 *WAI You can force commands to execute sequentially by using the *WAI command. This command forces completion of the previous commands before processing new ones. The same command sequence using the *WAI command for synchronization looks like this: /* Set up conditional acquisition */ ACQUIRE:STATE OFF SELECT:CH1 ON HORIZONTAL:RECORDLENGTH 500...
  • Page 547 BUSY? The BUSY? query allows you to find out whether the oscilloscope is busy processing a command that has an extended processing time such as single-sequence acquisition. The same command sequence, using the BUSY? query for synchronization, looks like this: /* Set up conditional acquisition */ ACQUIRE:STATE OFF SELECT:CH1 ON...
  • Page 548 *OPC If the corresponding status registers are enabled, the *OPC command sets the OPC bit in the Standard Event Status Register (SESR) when an operation is complete. You achieve synchronization by using this command with either a serial poll or service request handler. Serial Poll Method: Enable the OPC bit in the Device Event Status Enable Register (DESER) and the Event Status Enable Register (ESER) using the DESE and *ESE commands.
  • Page 549 HORIZONTAL:RECORDLENGTH 500 ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE /* Enable the status registers */ DESE 1 *ESE 1 *SRE 32 /* Acquire waveform data */ ACQUIRE:STATE ON /* Set up the measurement parameters */ MEASUREMENT:IMMED:TYPE AMPLITUDE MEASUREMENT:IMMED:SOURCE CH1 /* Wait until the acquisition is complete before taking the measurement *OPC Program can now do different tasks such as talk to other devices.
  • Page 550 OPC? The *OPC? query places a 1 in the Output Queue once an operation is complete. A time-out could occur if you try to read the output queue before there is any data in it. The same command sequence using the *OPC? query for synchronization looks like this: /* Set up conditional acquisition */ ACQUIRE:STATE OFF SELECT:CH1 ON...

  • Page 551: Programming Examples

    The GPIB programs you compile in the Sources directory work with the National Instruments AT- Note: GPIB/TNT GPIB system. It may take extra steps or changes to get them to work with older Tektronix GURU and other GPIB systems. Compiling and Linking Example Visual C++ Programs...
  • Page 552 Miscellaneous Character Charts...

  • Page 553: Reserved Words

    Reserved Words Overview This topic is a list of reserved words for the TDS7000 series oscilloscopes. Capital letters identify the required minimum spelling. For the most robust code use the full spelling, since spelling rules may change over time and from instrument model to instrument model.
  • Page 554 *CAL to DIAg *CAL *TRG BETWeen CONTROL *CLS *TST BIT_Nr COPy *DDT *WAI BN_Fmt COUNt *ESE BOTh COUPling *ESR ABSolute CURSor *IDN ACQuire BOXPcnt CURVe *LRN ACTUal BUSY DATa *OPC ALIas DATe *OPT BYT_Nr DEFIne *PSC ALLev BYT_Or DELay *PUD AREA CALibrate DELEte...
  • Page 555 DIR to MAXimum FAILURES HALT ITEM DIREction FASTAcq HARDCopy LABEL DISplay FILEName HBArs LAST DIVisions FILESystem HDELTA LENgth EDGE FILTer LESSLimit EDGE2 FIRST HEADer LEVEL ENCdg FORMat HIGH LOCk ERRLOG FRAME HIGHLimit LOGIc EVENT FREQuency HIStogram LOOP EVENTS FUNCtion HOLDoff LOOPS EVMsg GAIN...
  • Page 556 MEAN to SIZe MEAN NUMITEMS PRObestate RESULT MEAS<x> OFFSet PT_Fmt RESults MEASUrement PAIred PT_Off RMDir METHod PALETTE PT_OR RUNT PASSword PULse SAMPLERate MID2 PATtern PUMODE SAVe MINimum PERCent READFile SCAle MKDir PERSistence RECAll SCREENSAVER MODe PHASE RECOrdlength SCREENSAVERDELAY MORELimit POLarity SELect NAMe PORT...
  • Page 557 SLOpe to ZOOm SLOpe SUPPress VALue XINcr SOURCE TERminator VARPersist XPOS SOURCE2 TEST VBArs XUNit SPAN THReshold VDELTA XZEro TIMe VERBose YMUlt SPECTral TIMEOut VOLtage YOFf SPLit TIMEStamp <wfm> YPOS STARt TRACk WAVEform YUNit STATE TRANsition WAVFrm YZEro STATIstics TRIGBar WEIghting ZOOm STDdev...

  • Page 558: Factory Default Setup Values

    Factory Default Setup Values Overview This topic contains tables that list the default setup values by command group. These are the values that the instrument sets when you press the DEFAULT SETUP front-panel button or send the FACtory command. Only those commands that have values set by the DEFAULT SETUP function are listed in these tables.
  • Page 559 Acquisition D ef au lt S et u p V al u e s C o m m a n d D e f a u l t ACQuire:MODe SAMple ACQuire:NUMAVg ACQuire:NUMEnv ACQuire:REPEt 1 (ON) ACQuire:STATE 1 (ON) ACQuire:STOPAfter RUNSTop FASTAcq:STATE 0 (OFF)
  • Page 560 Cursor D e f a u l t S e t u p V a l u e s C o m m a n d D e f a u l t CURSor:FUNCtion VBArs ±300.0000E-9 CURSor:HBArs:POSITION<x> CURSor:MODe INDependent ±800.0000E-9 CURSor:PAIred:POSITION<x>...
  • Page 561 Display Default Setup Values C o m m a n d D e f a u l t DISplay:CLOCk DISplay:COLOr:MATHCOLOr DEFAULT DISplay:COLOr:PALETTE NORMal DISplay:COLOr:REFCOLOr DEFAULT DISplay:FILTer SINX DISplay:FORMat DISplay:INTENSITy:AUTOBright 1 (ON) DISplay:INTENSITy:SCREENSAVER 1 (ON) DISplay:INTENSITy:SCREENSAVERDELAY 28800 DISplay:INTENSITy:WAVEform 75.0000 DISplay:PERSistence DISplay:STYle VECtors DISplay:TRIGBar SHORt...
  • Page 562 Hardcopy D ef au lt S et u p V al u e s C o m m a n d D e f a u l t HARDCopy:FILEName "" HARDCopy:PORT FILE...
  • Page 563 Histogram D ef au lt S et u p V al u e s C o m m a n d D e f a u l t HIStogram:BOXPcnt 30.0000, 25.1000, 70.0000, 75.2000 HIStogram:DISplay 0 (OFF) HIStogram:FUNCTION HORizontal HIStogram:SIZe 2.0000 HIStogram:SOUrce HIStogram:STATE 0 (OFF)
  • Page 564 Horizontal D ef au lt S et u p V al u e s C o m m a n d D e f a u l t HORizontal:FASTframe:COUNt HORizontal:FASTframe:LENgth 5000 HORizontal:FASTframe:REF:FRAme HORizontal:FASTframe:REF:SOUrce HORizontal:FASTframe:SELECTED:<wfm> CH1-4 MATH1-4 2 REF1-4 HORizontal:FASTframe:STATE HORizontal:FASTframe:TRACk LIVE HORizontal:RECOrdlength 5000...
  • Page 565 Math D ef au lt S et u p V al u e s C o m m a n d D e f a u l t MATH<x>:DEFine " " MATH<x>:LABEL:NAMe " " MATH<x>:LABEL:XPOS MATH<x>:LABEL:YPOS MATH1 MATH2 MATH3 MATH4 110 MATH<x>:NUMavg MATH<x>:POSition 0.0000...
  • Page 566 Measurement D ef au lt S et u p V al u e s C o m m a n d D e f a u l t MEASUrement:GATING 0 (OFF) MEASUrement:METHod HIStogram MEASUrement:IMMed:TYPe undefined MEASUrement:IMMed:SOURCE[1] MEASUrement:IMMed:SOURCE2 MEASUrement:IMMed:DELay:EDGE[1] RISe MEASUrement:IMMed:DELay:EDGE2 RISe MEASUrement:IMMed:DELay:DIREction FORWards...
  • Page 567 Miscellaneous D ef au lt S et u p V al u e s C o m m a n d D e f a u l t AUXout:EDGe FALling AUXout:SOUrce ATRIGger CMDBatch 1 (ON) HEADer 1 (ON) LOCk NONe VERBose 1 (ON)
  • Page 568 Trigger D ef au lt S et u p V al u e s C o m m a n d D e f a u l t TRIGger:A:MODe AUTO TRIGger:A:TYPe EDGE TRIGger:A:LEVel 0.0000 TRIGger:A:HOLDoff:BY DEFAult TRIGger:A:HOLDoff:TIMe 250.0000E-09 TRIGger:A:EDGE:SOUrce TRIGger:A:EDGE:COUPling TRIGger:A:EDGE:SLOpe RISe TRIGger:A:LOGIc:CLAss...
  • Page 570 Vertical D ef au lt S et u p V al u e s C o m m a n d D e f a u l t CH<x>:BANdwidth CH1-4 1.0000E+09 CH<x>:COUPling CH1-4 CH<x>:DESKew CH1-4 0.0000 CH<x>:OFFSet CH1-4 0.0000 CH<x>:POSition CH1-4 0.0000 CH<x>:SCAle...
  • Page 571 Waveform D ef au lt S et u p V al u e s C o m m a n d D e f a u l t WFid "Ch1, DC coupling, 100.0mV/div, 2000.0ns/div, 5000 points, Sample mode" WFMInpre:BIT_Nr WFMInpre:BN_Fmt WFMInpre:BYT_Nr WFMInpre:BYT_Or WFMInpre:ENCdg...
  • Page 572 Zoom D ef au lt S et u p V al u e s Com ma n d Def au lt ZOOm:MODe 0 (OFF) ZOOm:HORizontal:LOCk ZOOm:<wfm>:HORizontal:POSition CH1-4 50.0000 MATH1-4 50.0000 REF1-4 50.0000 ZOOm:<wfm>:HORizontal:SCAle CH1-4 MATH1-4 2 REF1-4 CH1-4 0.0000 ZOOm:<wfm>:VERTical:POSition MATH1-4 0.0000 REF1-4 0.0000...

  • Page 573: Gpib Interface Specifications

    GPIB Interface Specifications Overview This topic describes details of the GPIB remote interface of the instrument. Normally, you will not need this information to use the instrument, but this information may be useful if you are connecting to controllers with unusual configurations.

  • Page 574: Gpib Functions

    GPIB Functions The following table lists the GPIB interface functions and electrical functions subsets supported by this instrument with brief descriptions of each.
  • Page 575 G P IB F u n c t i o n s I n t e r f a c e F u n c t i o n S u b s e t M e a n i n g Acceptor The instrument can receive multiline Handshake...

  • Page 576: Interface Messages

    Interface Messages The following table shows the standard interface messages that the instrument supports. S t a n d a r d I n t e r f a c e M e s s a g e s M e s s a g e G P I B Listen Addresses Talk Addresses...

Table of Contents