Keysight Technologies InfiniiVision DSOX1204A Programmer's Manual
  1. Manuals
  2. Brands
  3. Keysight Technologies Manuals
  4. Test Equipment
  5. InfiniiVision DSOX1204A
  6. Programmer's manual

Keysight Technologies InfiniiVision DSOX1204A Programmer's Manual

Hide thumbs
1
2
3
4
5
6
Table Of Contents
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
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
Table of Contents

Advertisement

Quick Links

Download this manual
Keysight InfiniiVision
DSOX1204A/G Oscilloscopes
Programmer's
Guide

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the InfiniiVision DSOX1204A and is the answer not in the manual?

Questions and answers

Related Manuals for Keysight Technologies InfiniiVision DSOX1204A

Summary of Contents for Keysight Technologies InfiniiVision DSOX1204A

  • Page 1 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 2 DFAR 227.7103-5 (c), as applicable in any technical data. The hardware and/or software described in this document are furnished under a license and may be used or copied only in accordance with the terms of such license. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 3: In This Book

    In This Book This book is your guide to programming the InfiniiVision DSOX1204A/G oscilloscopes: Table 1 DSOX1204A/G Model Numbers, Bandwidths Model: DSOX1204A DSOX1204G Channels: Bandwidth: 70 MHz Bandwidth upgrades: 70 MHz to 100 MHz with D1200BW1A upgrade 70 MHz to 200 MHz with D1200BW2A upgrade...
  • Page 4 22, “:RECall Commands,” starting on page 433, describes commands that recall previously saved oscilloscope setups, reference waveforms, or masks. • Chapter 23, “:SAVE Commands,” starting on page 441, describes commands that save oscilloscope setups, screen images, and data. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 5 • For information on controller PC interface configuration, see the documentation for the interface card used (for example, the Keysight 82350A GPIB interface). • For information on oscilloscope front-panel operation, see the User's Guide. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 6 • For detailed connectivity information, refer to the Keysight Technologies USB/LAN/GPIB Connectivity Guide. For a printable electronic copy of the Connectivity Guide, direct your Web browser to www.keysight.com and search for "Connectivity Guide". • For the latest versions of this and other manuals, see: http://www.keysight.com/find/1000X-Series-manual...

  • Page 7: Table Of Contents

    Reading Query Results into String Variables / 46 Reading Query Results into Numeric Variables / 46 Reading Definite-Length Block Query Response Data / 46 Sending Multiple Queries and Reading Results / 47 Checking Instrument Status / 48 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 8 6 Root (:) Commands :AER (Arm Event Register) / 136 :AUToscale / 137 :AUToscale:AMODE / 139 :AUToscale:CHANnels / 140 :AUToscale:FDEBug / 141 :BLANk / 142 :DIGitize / 143 :MTEenable (Mask Test Event Enable Register) / 144 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 9 :ACQuire:SEGMented:ANALyze / 183 :ACQuire:SEGMented:COUNt / 184 :ACQuire:SEGMented:INDex / 185 :ACQuire:SRATe / 188 :ACQuire:TYPE / 189 9 :CALibrate Commands :CALibrate:DATE / 193 :CALibrate:LABel / 194 :CALibrate:OUTPut / 195 :CALibrate:PROTected / 196 :CALibrate:STARt / 197 :CALibrate:STATus / 198 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 10 :DISPlay:ANNotation / 229 :DISPlay:ANNotation:BACKground / 230 :DISPlay:ANNotation:COLor / 231 :DISPlay:ANNotation:TEXT / 232 :DISPlay:CLEar / 233 :DISPlay:DATA / 234 :DISPlay:INTensity:WAVeform / 235 :DISPlay:LABel / 236 :DISPlay:LABList / 237 :DISPlay:MENU:TIMeout / 238 :DISPlay:PERSistence / 239 :DISPlay:VECTors / 240 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 11 :FFT:WINDow / 270 16 :FRANalysis Commands :FRANalysis:DATA / 275 :FRANalysis:ENABle / 276 :FRANalysis:FREQuency:MODE / 277 :FRANalysis:FREQuency:SINGle / 278 :FRANalysis:FREQuency:STARt / 279 :FRANalysis:FREQuency:STOP / 280 :FRANalysis:RUN / 281 :FRANalysis:SOURce:INPut / 282 :FRANalysis:SOURce:OUTPut / 283 :FRANalysis:SWEep:POINts / 284 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 12 :HARDcopy:INKSaver / 317 :HARDcopy:LAYout / 318 :HARDcopy:NETWork:ADDRess / 319 :HARDcopy:NETWork:APPLy / 320 :HARDcopy:NETWork:SLOT / 321 :HARDcopy:PALette / 322 :HARDcopy:PRINter:LIST / 323 :HARDcopy:STARt / 324 19 :MARKer Commands :MARKer:MODE / 328 :MARKer:X1Position / 329 :MARKer:X1Y1source / 330 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 13 :MEASure:PPULses / 373 :MEASure:PREShoot / 374 :MEASure:PWIDth / 375 :MEASure:RESults / 376 :MEASure:RISetime / 377 :MEASure:SDEViation / 378 :MEASure:SHOW / 379 :MEASure:SOURce / 380 :MEASure:TEDGe / 382 :MEASure:TVALue / 384 :MEASure:VAMPlitude / 386 :MEASure:VAVerage / 387 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 14 :MTESt:RMODe:FACTion:SAVE / 421 :MTESt:RMODe:FACTion:STOP / 422 :MTESt:RMODe:SIGMa / 423 :MTESt:RMODe:TIME / 424 :MTESt:RMODe:WAVeforms / 425 :MTESt:SCALe:BIND / 426 :MTESt:SCALe:X1 / 427 :MTESt:SCALe:XDELta / 428 :MTESt:SCALe:Y1 / 429 :MTESt:SCALe:Y2 / 430 :MTESt:SOURce / 431 :MTESt:TITLe / 432 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 15 :SBUS<n>:CAN Commands / 466 :SBUS<n>:CAN:COUNt:ERRor / 468 :SBUS<n>:CAN:COUNt:OVERload / 469 :SBUS<n>:CAN:COUNt:RESet / 470 :SBUS<n>:CAN:COUNt:TOTal / 471 :SBUS<n>:CAN:COUNt:UTILization / 472 :SBUS<n>:CAN:SAMPlepoint / 473 :SBUS<n>:CAN:SIGNal:BAUDrate / 474 :SBUS<n>:CAN:SIGNal:DEFinition / 475 :SBUS<n>:CAN:SOURce / 476 :SBUS<n>:CAN:TRIGger / 477 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 16 :SBUS<n>:SPI:CLOCk:TIMeout / 511 :SBUS<n>:SPI:FRAMing / 512 :SBUS<n>:SPI:SOURce:CLOCk / 513 :SBUS<n>:SPI:SOURce:FRAMe / 514 :SBUS<n>:SPI:SOURce:MISO / 515 :SBUS<n>:SPI:SOURce:MOSI / 516 :SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA / 517 :SBUS<n>:SPI:TRIGger:PATTern:MISO:WIDTh / 518 :SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA / 519 :SBUS<n>:SPI:TRIGger:PATTern:MOSI:WIDTh / 520 :SBUS<n>:SPI:TRIGger:TYPE / 521 :SBUS<n>:SPI:WIDTh / 522 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 17 :SYSTem:PERSona[:MANufacturer]:DEFault / 555 :SYSTem:PRESet / 556 :SYSTem:PROTection:LOCK / 559 :SYSTem:RLOGger / 560 :SYSTem:RLOGger:DESTination / 561 :SYSTem:RLOGger:DISPlay / 562 :SYSTem:RLOGger:FNAMe / 563 :SYSTem:RLOGger:STATe / 564 :SYSTem:RLOGger:TRANsparent / 565 :SYSTem:RLOGger:WMODe / 566 :SYSTem:SETup / 567 :SYSTem:TIME / 569 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 18 :TRIGger[:EDGE]:SLOPe / 601 :TRIGger[:EDGE]:SOURce / 602 :TRIGger:GLITch Commands / 603 :TRIGger:GLITch:GREaterthan / 604 :TRIGger:GLITch:LESSthan / 605 :TRIGger:GLITch:LEVel / 606 :TRIGger:GLITch:POLarity / 607 :TRIGger:GLITch:QUALifier / 608 :TRIGger:GLITch:RANGe / 609 :TRIGger:GLITch:SOURce / 610 :TRIGger:PATTern Commands / 611 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 19 :WAVeform:PREamble / 649 :WAVeform:SEGMented:COUNt / 652 :WAVeform:SEGMented:TTAG / 653 :WAVeform:SOURce / 654 :WAVeform:SOURce:SUBSource / 658 :WAVeform:TYPE / 659 :WAVeform:UNSigned / 660 :WAVeform:VIEW / 661 :WAVeform:XINCrement / 662 :WAVeform:XORigin / 663 :WAVeform:XREFerence / 664 :WAVeform:YINCrement / 665 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 20 :WGEN:VOLTage:HIGH / 697 :WGEN:VOLTage:LOW / 698 :WGEN:VOLTage:OFFSet / 699 30 :WMEMory<r> Commands :WMEMory<r>:CLEar / 703 :WMEMory<r>:DISPlay / 704 :WMEMory<r>:LABel / 705 :WMEMory<r>:SAVE / 706 :WMEMory<r>:SKEW / 707 :WMEMory<r>:YOFFset / 708 :WMEMory<r>:YRANge / 709 :WMEMory<r>:YSCale / 710 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 21 :MTESt:AVERage / 745 :MTESt:AVERage:COUNt / 746 :MTESt:LOAD / 747 :MTESt:RUMode / 748 :MTESt:RUMode:SOFailure / 749 :MTESt:{STARt | STOP} / 750 :MTESt:TRIGger:SOURce / 751 :PRINt? / 752 :SAVE:IMAGe:AREA / 754 :TIMebase:DELay / 755 :TRIGger:TV:TVMode / 756 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 22 Acquire a Waveform / 788 Retrieve Results / 788 Blocking Synchronization / 789 Polling Synchronization With Timeout / 790 Synchronizing with a Single-Shot Device Under Test (DUT) / 792 Synchronization with an Averaging Acquisition / 794 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 23 VISA.NET Example in Visual Basic .NET / 900 VISA.NET Example in IronPython / 907 SICL Examples / 913 SICL Example in C / 913 SICL Example in Visual Basic / 922 SCPI.NET Examples / 933 Index Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 24 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 25: What's New

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 1 What's New What's New in Version 2.01 / 26 Version 2.00 at Introduction / 27 Command Differences From 1000 X-Series Oscilloscopes / 28...

  • Page 26: What's New In Version 2.01

    What's New What's New in Version 2.01 New features in version 2.01 of the InfiniiVision DSOX1204A/G oscilloscope software are: • Frequency Response Analysis (FRA) now supports more flexible frequency ranges in the sweep analysis. More detailed descriptions of the new and changed commands appear below.

  • Page 27: Version 2.00 At Introduction

    What's New Version 2.00 at Introduction The Keysight InfiniiVision DSOX1204A/G oscilloscopes were introduced with version 2.00 of oscilloscope operating software. The command set is most closely related to the InfiniiVision 1000 X-Series oscilloscopes (and the 2000/3000 X-Series, 7000 Series, 6000 Series, and 54620/54640 Series oscilloscopes before them).

  • Page 28: Command Differences From 1000 X-Series Oscilloscopes

    What's New Command Differences From 1000 X-Series Oscilloscopes The Keysight InfiniiVision DSOX1204A/G oscilloscopes command set is most closely related to the InfiniiVision 1000 X-Series oscilloscopes (and the 2000/3000 X-Series, 7000 Series, 6000 Series, and 54620/54640 Series oscilloscopes before them). The main differences between the version 2.00 programming command set for the InfiniiVision DSOX1204A/G oscilloscopes and the 1.10 programming command set...
  • Page 29 EXTernal source is not available. page 382) :MEASure:VTIMe (see EXTernal source is not available. page 393) :SBUS<n>:CAN:SOURce (see EXTernal cannot be specified as the source. page 476) :SBUS<n>:IIC[:SOURce]:CLOCk EXTernal cannot be specified as the source. (see page 485) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 30 EXT source is not available. page 654) Discontinued Commands Command Description :EXTernal:DISPlay (see The Ext Trig input cannot be displayed as a digital waveform. page 252) :EXTernal:LABel (see page 253) :EXTernal:POSition (see page 255) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 31: Setting Up

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 2 Setting Up Step 1. Install Keysight IO Libraries Suite software / 32 Step 2. Connect and set up the oscilloscope / 33 Step 3. Verify the oscilloscope connection / 35 This chapter explains how to install the Keysight IO Libraries Suite software, connect the oscilloscope to the controller PC, set up the oscilloscope, and verify the oscilloscope connection.

  • Page 32: Step 1. Install Keysight Io Libraries Suite Software

    Setting Up Step 1. Install Keysight IO Libraries Suite software Download the Keysight IO Libraries Suite software from the Keysight web site • http://www.keysight.com/find/iolib Run the setup file, and follow its installation instructions. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 33: Step 2. Connect And Set Up The Oscilloscope

    Contact your network administrator about adding the oscilloscope to the network. Find out if automatic configuration via DHCP or AutoIP can be used. Also, find out whether your network supports Dynamic DNS or Multicast DNS. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 34 When you are done, press the [Back up] key. Press the Host name softkey. Use the softkeys and the Entry knob to enter the Host name. When you are done, press the [Back up] key. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 35: Step 3. Verify The Oscilloscope Connection

    On the controller PC, click on the Keysight IO Control icon in the taskbar and choose Connection Expert from the popup menu. In the Keysight Connection Expert application, instruments connected to the controller's USB interface should automatically appear in the Instruments tab. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 36 Send Command, Read Response, or Send & Read. Choose Connect > Exit from the menu to exit the Keysight Interactive IO application. In the Keysight Connection Expert application, choose File > Exit from the menu to exit the application. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 37: Getting Started

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 3 Getting Started Basic Oscilloscope Program Structure / 38 Programming the Oscilloscope / 40 This chapter gives you an overview of programming the InfiniiVision DSOX1204A/G oscilloscopes. It describes basic oscilloscope program structure and shows how to program the oscilloscope using a few simple examples.

  • Page 38: Basic Oscilloscope Program Structure

    Any additional commands sent while :DIGitize is working are buffered until :DIGitize is complete. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 39: Analyzing Captured Data

    Using the :WAVeform commands, you can transfer the data to your controller. You may want to display the data, compare it to a known good measurement, or simply check logic patterns at various time intervals in the acquisition. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 40: Programming The Oscilloscope

    To reference the Keysight VISA COM library in Visual Basic for Applications (VBA, which comes with Microsoft Office products like Excel): Choose Tools > References... from the main menu. In the References dialog, check the "VISA COM 5.9 Type Library". Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 41: Opening The Oscilloscope Connection Via The Io Library

    To make sure the bus and all appropriate interfaces are in a known state, begin every program with an initialization statement. When using the Keysight VISA COM library, you can use the resource session object's Clear method to clears the interface buffer: Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 42: Using :Autoscale To Automate Oscilloscope Setup

    An example of the commands that might be sent to the oscilloscope are: myScope.WriteString ":CHANnel1:PROBe 10" myScope.WriteString ":CHANnel1:RANGe 16" myScope.WriteString ":CHANnel1:OFFSet 1.00" myScope.WriteString ":TIMebase:MODE MAIN" myScope.WriteString ":TIMebase:RANGe 1E-3" myScope.WriteString ":TIMebase:DELay 100E-6" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 43: Capturing Data With The :Digitize Command

    :ACQuire subsystem. When the digitize process is complete, the acquisition is stopped. The captured data can then be measured by the instrument or transferred to the controller for further analysis. The captured data consists of two parts: the waveform data record, and the preamble. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 44 Digitized waveforms are passed from the instrument to the controller by sending a numerical representation of each digitized point. The format of the numerical representation is controlled with the :WAVeform:FORMat command and may be selected as BYTE, WORD, or ASCii. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 45: Reading Query Responses From The Oscilloscope

    This also causes an error to be placed in the error queue. Executing a read statement before sending a query causes the controller to wait indefinitely. The format specification for handling response messages depends on the programming language. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 46: Reading Query Results Into String Variables

    After the non-zero digit is the decimal integer that states the number of 8-bit data bytes being sent. This is followed by the actual data. For example, for transmitting 1000 bytes of data, the syntax would be: Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 47: Sending Multiple Queries And Reading Results

    ReadList method to read the query results into a string array variable using the commands: myScope.WriteString ":TIMebase:RANGe?;DELay?" Dim strResults() As String strResults() = myScope.ReadList(ASCIIType_BSTR) MsgBox "Timebase range: " + strResults(0) + ", delay: " + strResults(1) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 48: Checking Instrument Status

    For more information, see Chapter 33, “Status Reporting,” starting on page 765 which explains how to check the status of the instrument. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 49: Commands Quick Reference

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 4 Commands Quick Reference Command Summary / 50 Syntax Elements / 103...

  • Page 50: Command Summary

    • General :TRIGger Commands Summary (see page • :TRIGger[:EDGE] Commands Summary (see page • :TRIGger:GLITch Commands Summary (see page • :TRIGger:PATTern Commands Summary (see page • :TRIGger:SHOLd Commands Summary (see page • :TRIGger:TRANsition Commands Summary (see page Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 51 IEEE 488.2 # format page 118) page 118) *OPC (see *OPC? (see ASCII "1" is placed in the output queue when all pending device operations have completed. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 52 *RCL <value> (see <value> ::= {0 | 1 | 2 | 3 | 4 | page 120) 5 | 6 | 7 | 8 | 9} page 121) page 121) *RST (see See *RST (Reset) (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 53 ---- (Not used.) Message displayed. User event condition occurred. A trigger occurred. page 129) *TRG (see page 130) *TST? (see <result> ::= 0 or non-zero value; an integer in NR1 format page 131) *WAI (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 54 :OPEE? (see <n> ::= 15-bit integer in NR1 page 148) format :OPERregister:CONDiti <n> ::= 15-bit integer in NR1 page 150) on? (see format :OPERegister[:EVENt]? <n> ::= 15-bit integer in NR1 page 152) (see format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 55 <display> ::= {CHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r> | ABUS} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1 to (# ref waveforms) in NR1 format page 163) :STOP (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 56 <string> <nondecimal> ::= #Hnn...n where n ::= {0,..,9 | A,..,F} for hexadecimal <nondecimal> ::= #Bnn...n where n ::= {0 | 1} for binary <string> ::= "0xnn...n" where n ::= {0,..,9 | A,..,F} for hexadecimal Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 57 (see up to 32 characters page 194) :CALibrate:OUTPut :CALibrate:OUTPut? <signal> ::= {TRIGgers | MASK | page 195) <signal> (see (see WAVEgen} page 195) :CALibrate:PROTected? {"PROTected" | "UNPRotected"} page 196) (see :CALibrate:STARt (see page 197) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 58 <n> ::= 1 to (# analog channels) page 208) in NR1 format :CHANnel<n>:INVert :CHANnel<n>:INVert? {0 | 1} page 209) {{0 | OFF} | {1 | (see <n> ::= 1 to (# analog channels) page 209) ON}} (see in NR1 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 59 NR1 format :CHANnel<n>:RANGe :CHANnel<n>:RANGe? <range> ::= Vertical full-scale page 218) <range>[suffix] (see (see range value in NR3 format page 218) [suffix] ::= {V | mV} <n> ::= 1 to (# analog channels) in NR1 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 60 CH4 | DIG | MATH | REF | MARKer | page 231) WHITe | RED} :DISPlay:ANNotation:T :DISPlay:ANNotation:T <string> ::= quoted ASCII string page 232) EXT <string> (see EXT? (see (up to 254 characters) page 232) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 61 243) number in NR3 format :DVM:ENABle {{0 | :DVM:ENABle? (see {0 | 1} page 244) OFF} | {1 | ON}} (see page 244) :DVM:FREQuency? (see <freq_value> ::= floating-point page 243) number in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 62 <range> ::= vertical full-scale page 257) <range>[<suffix>] range value in NR3 format page 257) (see <suffix> ::= {V | mV} :EXTernal:UNITs :EXTernal:UNITs? (see <units> ::= {VOLT | AMPere} page 258) page 258) <units> (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 63 :FRANalysis:DATA? <binary_block> ::= page 275) (see comma-separated data with newlines at the end of each row :FRANalysis:ENABle :FRANalysis:ENABle? {0 | 1} page 276) {{0 | OFF} | {1 | (see page 276) ON}} (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 64 :FRANalysis:WGEN:LOAD :FRANalysis:WGEN:LOAD <impedance> ::= {ONEMeg | FIFTy} page 286) <impedance> (see ? (see page 286) :FRANalysis:WGEN:VOLT :FRANalysis:WGEN:VOLT <amplitude> ::= amplitude in page 287) age <amplitude> (see age? (see volts in NR3 format page 287) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 65 :FUNCtion:OFFSet :FUNCtion:OFFSet? <offset> ::= the value at center page 302) <offset> (see (see screen in NR3 format. page 302) The range of legal values is +/-10 times the current sensitivity of the selected function. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 66 313) page 313) (see :HARDcopy:APRinter :HARDcopy:APRinter? <active_printer> ::= {<index> | page 314) <active_printer> (see (see <name>} page 314) <index> ::= integer index of printer in list <name> ::= name of printer in list Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 67 322) :HARDcopy:PRINter:LIS <list> ::= [<printer_spec>] ... page 323) T? (see [printer_spec>] <printer_spec> ::= "<index>,<active>,<name>;" <index> ::= integer index of printer <active> ::= {Y | N} <name> ::= name of printer :HARDcopy:STARt (see page 324) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 68 :MARKer:Y1Position :MARKer:Y1Position? <position> ::= Y1 cursor position page 336) <position>[suffix] (see value in NR3 format page 336) (see [suffix] ::= {V | mV | dB} <return_value> ::= Y1 cursor position value in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 69 :MEASure:COUNter :MEASure:COUNter? <source> ::= {CHANnel<n> | [<source>] (see [<source>] (see EXTernal} page 355) page 355) <n> ::= 1 to (# analog channels) in NR1 format <return_value> ::= counter frequency in Hertz in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 70 FUNCtion | MATH | WMEMory<r> | page 361) page 361) EXTernal} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= ratio of positive pulse width to period in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 71 FUNCtion | MATH | WMEMory<r>} page 366) page 366) <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= the falling pulse count in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 72 [,<source2>] (see [,<source2>] (see <n> ::= 1 to (# analog channels) page 372) page 372) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= the phase angle value in degrees in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 73 FUNCtion | MATH | WMEMory<r>} page 377) page 377) <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= rise time in seconds in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 74 <source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= time in seconds of the specified transition Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 75 FUNCtion | MATH | WMEMory<r>} page 388) page 388) <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <base_voltage> ::= voltage at the base of the selected waveform in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 76 392) page 392) FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= calculated dc RMS voltage in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 77 397) page 397) WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1 to (# ref waveforms) in NR1 format <return_value> ::= horizontal value of the maximum in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 78 :MTESt:LOCK {{0 | :MTESt:LOCK? (see {0 | 1} page 417) OFF} | {1 | ON}} (see page 417) :MTESt:RMODe <rmode> :MTESt:RMODe? (see <rmode> ::= {FORever | TIME | page 418) page 418) (see SIGMa | WAVeforms} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 79 428) :MTESt:SCALe:Y1 :MTESt:SCALe:Y1? (see <y1_value> ::= Y1 value in NR3 page 429) <y1_value> (see format page 429) :MTESt:SCALe:Y2 :MTESt:SCALe:Y2? (see <y2_value> ::= Y2 value in NR3 page 430) <y2_value> (see format page 430) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 80 NR1 format <file_name> ::= quoted ASCII string :RECall:WMEMory<r>[:S <r> ::= 1-2 in NR1 format TARt] [<file_name>] <file_name> ::= quoted ASCII page 439) (see string If extension included in file name, it must be ".h5". Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 81 :SAVE:SETup[:STARt] <file_spec> ::= {<internal_loc> [<file_spec>] (see | <file_name>} page 453) <internal_loc> ::= 0-9; an integer in NR1 format <file_name> ::= quoted ASCII string :SAVE:WAVeform[:STARt <file_name> ::= quoted ASCII ] [<file_name>] (see string page 454) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 82 {0 | 1} page 464) | OFF} | {1 | ON}} (see page 464) (see :SBUS<n>:MODE <mode> :SBUS<n>:MODE? (see <mode> ::= {CAN | IIC | LIN | SPI page 465) page 465) (see | UART} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 83 <string ::= "0xnn...n" where n ::= {0,..,9 | A,..,F | X | $} :SBUS<n>:CAN:TRIGger: :SBUS<n>:CAN:TRIGger: <length> ::= integer from 1 to 8 PATTern:DATA:LENGth PATTern:DATA:LENGth? in NR1 format page 480) <length> (see (see page 480) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 84 :SBUS<n>:IIC:TRIGger[ :SBUS<n>:IIC:TRIGger[ <type> ::= {STARt | STOP | READ7 page 491) :TYPE] <type> (see :TYPE]? (see | READEprom | WRITe7 | WRITe10 | page 491) NACKnowledge | ANACk | R7Data2 | W7Data2 | RESTart} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 85 <string> ::= "nn...n" where n ::= {0 | 1 | X | $} when <base> = BINary <string> ::= "0xnn...n" where n ::= {0,..,9 | A,..,F | X | $} when <base> = HEX Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 86 <string> ::= "nn...n" where n ::= PATTern:MISO:DATA PATTern:MISO:DATA? {0 | 1 | X | $} page 517) <string> (see (see <string ::= "0xnn...n" where n page 517) ::= {0,..,9 | A,..,F | X | $} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 87 <frame_count> ::= integer in NR1 page 528) RRor? (see format :SBUS<n>:UART:COUNt:R page 529) ESet (see :SBUS<n>:UART:COUNt:R <frame_count> ::= integer in NR1 XFRames? (see format page 530) :SBUS<n>:UART:COUNt:T <frame_count> ::= integer in NR1 XFRames? (see format page 531) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 88 <hexadecimal> ::= #Hnn where n ::= {0,..,9 | A,..,F} for hexadecimal <binary> ::= #Bnn...n where n ::= {0 | 1} for binary <quoted_string> ::= any of the 128 valid 7-bit ASCII characters (or standard abbreviations) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 89 See Error Messages (see :SYSTem:LOCK <value> :SYSTem:LOCK? (see <value> ::= {{1 | ON} | {0 | page 552) page 552) (see OFF}} :SYSTem:MENU <menu> <menu> ::= {MASK | MEASure | page 553) (see SEGMented} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 90 565) :SYSTem:RLOGger:WMODe :SYSTem:RLOGger:WMODe <write_mode> ::= {CREate | page 566) <write_mode> (see ? (see APPend} page 566) :SYSTem:SETup :SYSTem:SETup? (see <setup_data> ::= data in IEEE page 567) <setup_data> (see 488.2 # format. page 567) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 91 NR3 format for the page 582) zoomed window :TIMebase:WINDow:SCAL :TIMebase:WINDow:SCAL <scale_value> ::= scale value in page 583) e <scale_value> (see e? (see seconds in NR3 format for the page 583) zoomed window Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 92 :TIMebase:MODE is ROLL or :TRIGger:NREJect {{0 :TRIGger:NREJect? {0 | 1} page 595) | OFF} | {1 | ON}} (see page 595) (see :TRIGger:SWEep :TRIGger:SWEep? (see <sweep> ::= {AUTO | NORMal} page 596) page 596) <sweep> (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 93 [suffix] ::= {s | ms | us | ns | :TRIGger:GLITch:LESSt :TRIGger:GLITch:LESSt <less_than_time> ::= page 605) han? (see floating-point number in NR3 <less_than_time>[suff format page 605) ix] (see [suffix] ::= {s | ms | us | ns | Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 94 [suffix] ::= {s | ms | us | ns | :TRIGger:GLITch:SOURc :TRIGger:GLITch:SOURc <source> ::= {CHANnel<n>} page 610) e <source> (see e? (see <n> ::= 1 to (# analog channels) page 610) in NR1 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 95 [suffix] ::= {s | ms | us | ns | :TRIGger:SHOLd:TIME:S :TRIGger:SHOLd:TIME:S <time> ::= floating-point number page 621) ETup <time>[suffix] ETup? (see in NR3 format page 621) (see [suffix] ::= {s | ms | us | ns | Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 96 631) <source> (see (see <n> ::= 1 to (# analog channels) page 631) in NR1 format :TRIGger:TV:STANdard :TRIGger:TV:STANdard? <standard> ::= {NTSC | PAL | PALM page 632) <standard> (see (see | SECam} page 632) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 97 | <points_mode>} if waveform points mode is MAXimum or RAW <points_mode> ::= {NORMal | MAXimum | RAW} :WAVeform:POINts:MODE :WAVeform:POINts:MODE <points_mode> ::= {NORMal | page 647) <points_mode> (see ? (see MAXimum | RAW} page 647) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 98 659) AVER | HRES} :WAVeform:UNSigned :WAVeform:UNSigned? {0 | 1} page 660) {{0 | OFF} | {1 | (see page 660) ON}} (see :WAVeform:VIEW <view> :WAVeform:VIEW? (see <view> ::= {MAIN} page 661) page 661) (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 99 20% to 80% in NR1 page 678) page 678) (see format :WGEN:MODulation:AM:D :WGEN:MODulation:AM:D <percent> ::= AM depth percentage page 679) EPTh <percent> (see EPTh? (see from 0% to 100% in NR1 format page 679) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 100 OFF} | {1 | ON}} (see page 691) :WGEN:OUTPut:LOAD :WGEN:OUTPut:LOAD? <impedance> ::= {ONEMeg | FIFTy} page 692) <impedance> (see (see page 692) :WGEN:OUTPut:POLarity :WGEN:OUTPut:POLarity <polarity> ::= {NORMal | page 693) <polarity> (see ? (see INVerted} page 693) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 101 NOTE: Only ADD or SUBtract math operations can be saved as reference waveforms. :WMEMory<r>:SKEW :WMEMory<r>:SKEW? <r> ::= 1-2 in NR1 format page 707) page 707) <skew> (see (see <skew> ::= time in seconds in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 102 [suffix] ::= {V | mV} :WMEMory<r>:YSCale :WMEMory<r>:YSCale? <r> ::= 1-2 in NR1 format page 710) <scale>[suffix] (see (see <scale> ::= vertical units per page 710) division value in NR3 format [suffix] ::= {V | mV} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 103: Syntax Elements

    ON or OFF may be selected, not both. ::= (Defined As) ::= means "defined as". For example, <A> ::= <B> indicates that <A> can be replaced by <B> in any statement containing <A>. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 104: (Angle Brackets)

    For example, for transmitting 1000 bytes of data, the syntax would be #800001000<1000 bytes of data> <NL> 8 is the number of digits that follow 00001000 is the number of bytes to be transmitted Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 105 Commands Quick Reference <1000 bytes of data> is the actual data Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 106 Commands Quick Reference Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 107: Common (*) Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 5 Common (*) Commands Commands defined by IEEE 488.2 standard that are common to all instruments. "Introduction to Common (*) Commands" on page 109. Table 39 Common (*) Commands Summary Command Query Options and Query Returns...
  • Page 108 <Digital Voltmeter> ::= {0 | DVM} <Remote Command Logging> ::= {0 | RML} *RCL <value> (see <value> ::= {0 | 1 | 2 | 3 | 4 | page 120) 5 | 6 | 7 | 8 | 9} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 109 IEEE 488.2 standard. They Commands provide some of the basic instrument functions, such as instrument identification and reset, reading the instrument setup, and determining how status is read and cleared. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 110 :AUToscale command in order to re-enter the ACQuire subsystem and set the count. Each of the status registers has an enable (mask) register. By setting the bits in the enable N OTE register, you can select the status information you want to use. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 111: Cls (Clear Status)

    127 • "*ESE (Standard Event Status Enable)" on page 112 • "*ESR (Standard Event Status Register)" on page 114 • "*SRE (Service Request Enable)" on page 125 • ":SYSTem:ERRor" on page 551 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 112: Ese (Standard Event Status Enable)

    Status Register. A zero disables the bit. Standard Event CM E * ES R? Status Register Standard Event * ES E Status Enable * ES E? (Mask) Register To ESB bit in Status Byte Register Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 113 See Also • "Introduction to Common (*) Commands" on page 109 • "*ESR (Standard Event Status Register)" on page 114 • "*OPC (Operation Complete)" on page 118 • "*CLS (Clear Status)" on page 111 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 114: Esr (Standard Event Status Register)

    An execution error has been detected. Device Dependent Error A device-dependent error has been detected. Query Error A query error has been detected. Request Control The device is requesting control. (Not used.) Operation Complete Operation is complete. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 115 "Introduction to Common (*) Commands" on page 109 • "*ESE (Standard Event Status Enable)" on page 112 • "*OPC (Operation Complete)" on page 118 • "*CLS (Clear Status)" on page 111 • ":SYSTem:ERRor" on page 551 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 116: Idn (Identification Number)

    X.XX.XX ::= the software revision of the instrument See Also • "Introduction to Common (*) Commands" on page 109 • "*OPT (Option Identification)" on page 119 • ":SYSTem:PERSona[:MANufacturer]" on page 554 • ":SYSTem:PERSona[:MANufacturer]:DEFault" on page 555 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 117: Lrn (Learn Device Setup)

    IEEE 488.2 specification which says that the query result must contain ":SYST:SET " before the binary block data. See Also • "Introduction to Common (*) Commands" on page 109 • "*RCL (Recall)" on page 120 • "*SAV (Save)" on page 124 • ":SYSTem:SETup" on page 567 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 118: Opc (Operation Complete)

    • "Introduction to Common (*) Commands" on page 109 • "*ESE (Standard Event Status Enable)" on page 112 • "*ESR (Standard Event Status Register)" on page 114 • "*CLS (Clear Status)" on page 111 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 119: Opt (Option Identification)

    <Remote Command Logging> ::= {0 | RML} The *OPT? query returns the following: Module Module Id No modules attached 0,0,0,0,0,0,0,0,0,0,0,0,0,SGM,MASK,0,0,0,0,0,0,0,0,EDK,WAVEGEN,0,0,0, 0,0,0,0,0,0,0,0,RML,0,0,0 See Also • "Introduction to Common (*) Commands" on page 109 • "*IDN (Identification Number)" on page 116 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 120: Rcl (Recall)

    <value> ::= {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9} The *RCL command restores the state of the instrument from the specified save/recall register. See Also • "Introduction to Common (*) Commands" on page 109 • "*SAV (Save)" on page 124 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 121: Rst (Reset)

    Analog Channel Menu Channel 1 Channel 2 Volts/division 5.00 V Offset 0.00 Coupling Probe attenuation 10:1 Vernier Invert BW limit Impedance 1 M Ohm (cannot be changed) Units Volts Skew Cursor Menu Source Channel 1 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 122 Mode Auto Coupling Source Channel 1 Level 0.0 V Slope Positive HF Reject and noise reject Holdoff 60 ns External probe attenuation 10:1 External Units Volts External Impedance 1 M Ohm (cannot be changed) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 123 It is not necessary to reinitialize them unless the default ' setting is not suitable for your application. myScope.WriteString "*RST" ' Reset the oscilloscope to the defaults. See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 124: Sav (Save)

    The *SAV command stores the current state of the instrument in a save register. The data parameter specifies the register where the data will be saved. See Also • "Introduction to Common (*) Commands" on page 109 • "*RCL (Recall)" on page 120 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 125: Sre (Service Request Enable)

    Status Byte Register. A zero disables the bit. From From Standard Operati on Event Status Status Registers Registers TER? Trigger Event Register Outp ut Queue RQS/ OPER *STB? Statu s Byte Register *SRE Service Request Enable (Mask) Register *SRE? Service Request Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 126 <mask> ::= sum of all bits that are set, 0,..,255; an integer in NR1 format See Also • "Introduction to Common (*) Commands" on page 109 • "*STB (Read Status Byte)" on page 127 • "*CLS (Clear Status)" on page 111 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 127: Stb (Read Status Byte)

    <value> ::= 0,..,255; an integer in NR1 format From From Standard Operati on Event Status Status Registers Registers TER? Trigger Event Register Outp ut Queue RQS/ OPER *STB? Statu s Byte Register *SRE Service Request Enable (Mask) Register *SRE? Service Request Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 128 To read the instrument's status byte with RQS reported on bit 6, use the interface Serial Poll. N OTE See Also • "Introduction to Common (*) Commands" on page 109 • "*SRE (Service Request Enable)" on page 125 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 129: Trg (Trigger)

    The *TRG command has the same effect as the :DIGitize command with no parameters. See Also • "Introduction to Common (*) Commands" on page 109 • ":DIGitize" on page 143 • ":RUN" on page 159 • ":STOP" on page 163 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 130: Tst (Self Test)

    If the test fails, refer to the troubleshooting section of the Service Guide. Return Format <result><NL> <result> ::= 0 or non-zero value; an integer in NR1 format See Also • "Introduction to Common (*) Commands" on page 109 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 131: Wai (Wait To Continue)

    (see page 798) Command Syntax *WAI The *WAI command has no function in the oscilloscope, but is parsed for compatibility with other instruments. See Also • "Introduction to Common (*) Commands" on page 109 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 132 Common (*) Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 133: Root (:) Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 6 Root (:) Commands Control many of the basic functions of the oscilloscope and reside at the root level of the command tree. See "Introduction to Root (:) Commands" on page 135. Table 44 Root (:) Commands Summary...
  • Page 134 BMP8bit | BMP | PNG | NOFactors | FACTors} <print option> can be repeated up to 5 times. page 159) :RUN (see page 160) :SERial (see <return value> ::= unquoted string containing serial number page 161) :SINGle (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 135 These commands are always recognized by the parser if they are prefixed with a Commands colon, regardless of current command tree position. After executing a root-level command, the parser is positioned at the root of the command tree. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 136: Aer (Arm Event Register)

    • ":OPERegister:CONDition (Operation Status Condition Register)" on page 150 • ":OPERegister[:EVENt] (Operation Status Event Register)" on page 152 • "*STB (Read Status Byte)" on page 127 • "*SRE (Service Request Enable)" on page 125 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 137: Autoscale

    • Reference waveforms. • Zoomed (delayed) time base mode. For further information on :AUToscale, see the User's Guide. See Also • "Introduction to Root (:) Commands" on page 135 • ":AUToscale:CHANnels" on page 140 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 138 ' AUTOSCALE - This command evaluates all the input signals and sets ' the correct conditions to display all of the active signals. myScope.WriteString ":AUToscale" ' Same as pressing Auto Scale key. See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 139: Autoscale:amode

    <value> ::= {NORM | CURR} See Also • "Introduction to Root (:) Commands" on page 135 • ":AUToscale" on page 137 • ":AUToscale:CHANnels" on page 140 • ":ACQuire:TYPE" on page 189 • ":ACQuire:MODE" on page 181 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 140: Autoscale:channels

    <value> ::= {ALL | DISP} See Also • "Introduction to Root (:) Commands" on page 135 • ":AUToscale" on page 137 • ":AUToscale:AMODE" on page 139 • ":VIEW" on page 165 • ":BLANk" on page 142 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 141: Autoscale:fdebug

    The :AUToscale:FDEBug? query returns the current autoscale fast debug setting. Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to Root (:) Commands" on page 135 • ":AUToscale" on page 137 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 142: Blank

    233 • ":CHANnel<n>:DISPlay" on page 207 • ":FUNCtion:DISPlay" on page 292 • ":WMEMory<r>:DISPlay" on page 704 • ":STATus" on page 162 • ":VIEW" on page 165 Example Code • "Example Code" on page 165 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 143: Digitize

    Chapter 28, “:WAVeform Commands,” starting on page 633 Example Code ' Capture an acquisition using :DIGitize. ' ----------------------------------------------------------------- myScope.WriteString ":DIGitize CHANnel1" See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 144: Mteenable (Mask Test Event Enable Register)

    Mask test is complete. Query Syntax :MTEenable? The :MTEenable? query returns the current value contained in the Mask Test Event Enable register as an integer number. Return Format <value><NL> <value> ::= integer in NR1 format. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 145 152 • ":OVLenable (Overload Event Enable Register)" on page 154 • ":OVLRegister (Overload Event Register)" on page 156 • "*STB (Read Status Byte)" on page 127 • "*SRE (Service Request Enable)" on page 125 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 146: Mteregister[:Event] (Mask Test Event Event Register)

    See Also • "Introduction to Root (:) Commands" on page 135 • ":CHANnel<n>:PROTection" on page 217 • ":OPEE (Operation Status Enable Register)" on page 148 • ":OPERegister:CONDition (Operation Status Condition Register)" on page 150 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 147 Root (:) Commands • ":OVLenable (Overload Event Enable Register)" on page 154 • ":OVLRegister (Overload Event Register)" on page 156 • "*STB (Read Status Byte)" on page 127 • "*SRE (Service Request Enable)" on page 125 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 148: Opee (Operation Status Enable Register)

    (Not used.) OVLR Overload Event when 50Ω input overload occurs. (Not used.) Mask Test Event Event when mask test event occurs. (Not used.) Wait Wait Trig Event when the trigger is armed. Trig (Not used.) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 149 152 • ":OVLenable (Overload Event Enable Register)" on page 154 • ":OVLRegister (Overload Event Register)" on page 156 • "*STB (Read Status Byte)" on page 127 • "*SRE (Service Request Enable)" on page 125 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 150: Operegister:condition (Operation Status Condition Register)

    A mask test event has occurred. (Not used.) Wait Wait Trig The trigger is armed (set by the Trigger Armed Trig Event Register (TER)). (Not used.) Running The oscilloscope is running (not stopped). (Not used.) Return Format <value><NL> Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 151 "*STB (Read Status Byte)" on page 127 • "*SRE (Service Request Enable)" on page 125 • ":MTERegister[:EVENt] (Mask Test Event Event Register)" on page 146 • ":MTEenable (Mask Test Event Enable Register)" on page 144 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 152: Operegister[:Event] (Operation Status Event Register)

    Wait Trig The trigger is armed (set by the Trigger Armed Trig Event Register (TER)). (Not used.) Running The oscilloscope has gone from a stop state to a single or running state. (Not used.) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 153 "*STB (Read Status Byte)" on page 127 • "*SRE (Service Request Enable)" on page 125 • ":MTERegister[:EVENt] (Mask Test Event Event Register)" on page 146 • ":MTEenable (Mask Test Event Enable Register)" on page 144 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 154: Ovlenable (Overload Event Enable Register)

    Event when overload occurs on Channel 2 input. Channel 1 OVL Event when overload occurs on Channel 1 input. Query Syntax :OVLenable? The :OVLenable query returns the current enable mask value contained in the Overload Event Enable Register. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 155 150 • ":OPERegister[:EVENt] (Operation Status Event Register)" on page 152 • ":OVLRegister (Overload Event Register)" on page 156 • "*STB (Read Status Byte)" on page 127 • "*SRE (Service Request Enable)" on page 125 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 156: Ovlregister (Overload Event Register)

    135 • ":CHANnel<n>:PROTection" on page 217 • ":OPEE (Operation Status Enable Register)" on page 148 • ":OVLenable (Overload Event Enable Register)" on page 154 • "*STB (Read Status Byte)" on page 127 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 157 Root (:) Commands • "*SRE (Service Request Enable)" on page 125 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 158: Print

    See Also • "Introduction to Root (:) Commands" on page 135 • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:FACTors" on page 315 • ":HARDcopy:GRAYscale" on page 728 • ":DISPlay:DATA" on page 234 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 159: Run

    - STOP stops the data acquisition and turns off AUTOSTORE. ' myScope.WriteString ":RUN" ' Start data acquisition. ' myScope.WriteString ":STOP" ' Stop the data acquisition. See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 160: Serial

    Root (:) Commands :SERial (see page 798) Query Syntax :SERial? The :SERial? query returns the serial number of the instrument. Return Format: Unquoted string<NL> See Also • "Introduction to Root (:) Commands" on page 135 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 161: Single

    This is the same as pressing the Single key on the front panel. See Also • "Introduction to Root (:) Commands" on page 135 • ":RUN" on page 159 • ":STOP" on page 163 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 162: Status

    • "Introduction to Root (:) Commands" on page 135 • ":BLANk" on page 142 • ":CHANnel<n>:DISPlay" on page 207 • ":FUNCtion:DISPlay" on page 292 • ":WMEMory<r>:DISPlay" on page 704 • ":VIEW" on page 165 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 163: Stop

    See Also • "Introduction to Root (:) Commands" on page 135 • ":RUN" on page 159 • ":SINGle" on page 161 Example Code • "Example Code" on page 159 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 164: Ter (Trigger Event Register)

    <value> ::= {1 | 0}; a 16-bit integer in NR1 format. See Also • "Introduction to Root (:) Commands" on page 135 • "*SRE (Service Request Enable)" on page 125 • "*STB (Read Status Byte)" on page 127 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 165: View

    - BLANK turns off (stops displaying) a channel. ' myScope.WriteString ":BLANk CHANnel1" ' Turn channel 1 off. ' myScope.WriteString ":VIEW CHANnel1" ' Turn channel 1 on. See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 166 Root (:) Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 167: :Abus Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 7 :ABUS Commands Control all oscilloscope functions associated with a bus made up of analog channels. See "Introduction to :ABUS Commands" on page 168. Table 52 :ABUS Commands Summary Command Query Options and Query Returns :ABUS:BIT<m>...
  • Page 168 Use :ABUS? to query setup information for the ABUS subsystem. Return Format The following is a sample response from the :ABUS? query. In this case, the query was issued following a *RST command. :ABUS:DISP 0;LAB "ABUS1";MASK +0 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 169: Abus:bit

    170 • ":ABUS:CLEar" on page 172 • ":ABUS:DISPlay" on page 173 • ":ABUS:LABel" on page 174 • ":ABUS:MASK" on page 175 Example Code ' Include analog channel 2 in the bus: myScope.WriteString ":ABUS:BIT1 ON" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 170: Abus:bits

    See Also • "Introduction to :ABUS Commands" on page 168 • ":ABUS:BIT<m>" on page 169 • ":ABUS:CLEar" on page 172 • ":ABUS:DISPlay" on page 173 • ":ABUS:LABel" on page 174 • ":ABUS:MASK" on page 175 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 171 :ABUS Commands Example Code ' Include analog channel 1 and analog channel 4 in the bus: myScope.WriteString ":ABUS:BITS (@0,3), ON" ' Include all analog channels in the bus: myScope.WriteString ":ABUS:BITS (@0:3), ON" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 172: Abus:clear

    See Also • "Introduction to :ABUS Commands" on page 168 • ":ABUS:BIT<m>" on page 169 • ":ABUS:BITS" on page 170 • ":ABUS:DISPlay" on page 173 • ":ABUS:LABel" on page 174 • ":ABUS:MASK" on page 175 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 173: Abus:display

    See Also • "Introduction to :ABUS Commands" on page 168 • ":ABUS:BIT<m>" on page 169 • ":ABUS:BITS" on page 170 • ":ABUS:CLEar" on page 172 • ":ABUS:LABel" on page 174 • ":ABUS:MASK" on page 175 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 174: Abus:label

    • ":ABUS:DISPlay" on page 173 • ":ABUS:MASK" on page 175 • ":CHANnel:LABel" on page 716 • ":DISPlay:LABList" on page 237 Example Code ' Set the analog channel bus label to "DATA": myScope.WriteString ":ABUS:LABel 'Data'" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 175: Abus:mask

    See Also • "Introduction to :ABUS Commands" on page 168 • ":ABUS:BIT<m>" on page 169 • ":ABUS:BITS" on page 170 • ":ABUS:CLEar" on page 172 • ":ABUS:DISPlay" on page 173 • ":ABUS:LABel" on page 174 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 176 :ABUS Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 177: :Acquire Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 8 :ACQuire Commands Set the parameters for acquiring and storing data. See "Introduction to :ACQuire Commands" on page 177. Table 53 :ACQuire Commands Summary Command Query Options and Query Returns :ACQuire:COMPlete :ACQuire:COMPlete? <complete> ::= 100; an integer in...
  • Page 178 Use :ACQuire? to query setup information for the ACQuire subsystem. Return Format The following is a sample response from the :ACQuire? query. In this case, the query was issued following a *RST command. :ACQ:MODE RTIM;TYPE NORM;COMP 100;COUNT 8;SEGM:COUN 2 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 179: Acquire:complete

    The parameter determines the percentage of time ' buckets needed to be "full" before an acquisition is considered ' to be complete. myScope.WriteString ":ACQuire:COMPlete 100" See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 180: Acquire:count

    <count_argument> ::= an integer from 2 to 65536 in NR1 format See Also • "Introduction to :ACQuire Commands" on page 177 • ":ACQuire:TYPE" on page 189 • ":DIGitize" on page 143 • ":WAVeform:COUNt" on page 641 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 181: Acquire:mode

    :ACQuire:MODE? The :ACQuire:MODE? query returns the acquisition mode of the oscilloscope. Return Format <mode_argument><NL> <mode_argument> ::= {RTIM | SEGM} See Also • "Introduction to :ACQuire Commands" on page 177 • ":ACQuire:TYPE" on page 189 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 182: Acquire:points

    Return Format <points_argument><NL> <points_argument> ::= an integer in NR1 format See Also • "Introduction to :ACQuire Commands" on page 177 • ":DIGitize" on page 143 • ":WAVeform:POINts" on page 645 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 183: Acquire:segmented:analyze

    In order to use this command, the oscilloscope must be stopped and in segmented acquisition mode, with either quick measurements or infinite persistence on. See Also • ":ACQuire:MODE" on page 181 • ":ACQuire:SEGMented:COUNt" on page 184 • "Introduction to :ACQuire Commands" on page 177 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 184: Acquire:segmented:count

    161 • ":RUN" on page 159 • ":WAVeform:SEGMented:COUNt" on page 652 • ":ACQuire:SEGMented:ANALyze" on page 183 • "Introduction to :ACQuire Commands" on page 177 Example Code • "Example Code" on page 185 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 185: Acquire:segmented:index

    159 • ":WAVeform:SEGMented:COUNt" on page 652 • ":WAVeform:SEGMented:TTAG" on page 653 • ":ACQuire:SEGMented:ANALyze" on page 183 • "Introduction to :ACQuire Commands" on page 177 Example Code ' Segmented memory commands example. ' ------------------------------------------------------------------- Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 186 = myScope.ReadNumber Loop Until varQueryResult = 25 Debug.Print "Number of segments in acquired data: " _ + FormatNumber(varQueryResult) Dim lngSegments As Long lngSegments = varQueryResult ' For each segment: Dim dblTimeTag As Double Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 187 ":WAVeform:SEGMented:TTAG?" dblTimeTag = myScope.ReadNumber Debug.Print "Segment " + CStr(lngI) + " time tag: " _ + FormatNumber(dblTimeTag, 12) Next lngI Exit Sub VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.Description End Sub Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 188: Acquire:srate

    The :ACQuire:SRATe? query returns the current oscilloscope acquisition sample rate. The sample rate is not directly controllable. Return Format <sample_rate><NL> <sample_rate> ::= sample rate in NR3 format See Also • "Introduction to :ACQuire Commands" on page 177 • ":ACQuire:POINts" on page 182 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 189: Acquire:type

    The obsolete command ACQuire:TYPE:REALtime is functionally equivalent to sending N OTE ACQuire:MODE RTIME; TYPE NORMal. Query Syntax :ACQuire:TYPE? The :ACQuire:TYPE? query returns the current acquisition type. Return Format <acq_type><NL> <acq_type> ::= {NORM | AVER | HRES | PEAK} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 190 649 Example Code ' AQUIRE_TYPE - Sets the acquisition mode, which can be NORMAL, ' PEAK, or AVERAGE. myScope.WriteString ":ACQuire:TYPE NORMal" See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 191: :Calibrate Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 9 :CALibrate Commands Utility commands for viewing calibration status and for starting the user calibration procedure. See "Introduction to :CALibrate Commands" on page 192. Table 54 :CALibrate Commands Summary Command Query Options and Query Returns :CALibrate:DATE? (see <return value>...
  • Page 192 Commands (CAL PROTECT). • Saving and querying the calibration label string. • Reporting the calibration time and date. • Reporting changes in the temperature since the last calibration. • Starting the user calibration procedure. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 193: Calibrate:date

    798) Query Syntax :CALibrate:DATE? The :CALibrate:DATE? query returns the date of the last calibration. Return Format <date><NL> <date> ::= year,month,day in NR1 format<NL> See Also • "Introduction to :CALibrate Commands" on page 192 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 194: Calibrate:label

    The :CALibrate:LABel? query returns the contents of the calibration label string. Return Format <string><NL> <string>::= unquoted ASCII string of up to 32 characters in length See Also • "Introduction to :CALibrate Commands" on page 192 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 195: Calibrate:output

    The :CALibrate:OUTPut query returns the Gen Out BNC signal selection. Return Format <signal><NL> <signal> ::= {TRIG | MASK | OFF} See Also • "Introduction to :CALibrate Commands" on page 192 • ":WGEN:OUTPut" on page 691 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 196: Calibrate:protected

    PROTECT) button state. The value "PROTected" indicates calibration is disabled, and "UNPRotected" indicates calibration is enabled. Return Format <switch><NL> <switch> ::= {"PROTected" | "UNPRotected"} See Also • "Introduction to :CALibrate Commands" on page 192 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 197: Calibrate:start

    UNPROTECTED, and you must connect BNC cables from the TRIG OUT connector to the analog channel inputs. See the User's Guide for details. See Also • "Introduction to :CALibrate Commands" on page 192 • ":CALibrate:PROTected" on page 196 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 198: Calibrate:status

    The :CALibrate:STATus? query returns the summary results of the last user calibration procedure. Return Format <return value><NL> <return value> ::= <status_code>,<status_string> <status_code> ::= an integer status code <status_string> ::= an ASCII status string See Also • "Introduction to :CALibrate Commands" on page 192 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 199: Calibrate:temperature

    The :CALibrate:TEMPerature? query returns the change in temperature since the last user calibration procedure. Return Format <return value><NL> <return value> ::= degrees C delta since last cal in NR3 format See Also • "Introduction to :CALibrate Commands" on page 192 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 200: Calibrate:time

    798) Query Syntax :CALibrate:TIME? The :CALibrate:TIME? query returns the time of the last calibration. Return Format <date><NL> <date> ::= hour,minutes,seconds in NR1 format See Also • "Introduction to :CALibrate Commands" on page 192 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 201: 10 :Channel Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 10 :CHANnel<n> Commands Control all oscilloscope functions associated with individual analog channels or groups of channels. See "Introduction to :CHANnel<n> Commands" on page 203. Table 55 :CHANnel<n> Commands Summary Command Query Options and Query Returns :CHANnel<n>:BANDwidth...
  • Page 202 :CHANnel<n>:SCALe :CHANnel<n>:SCALe? <scale> ::= Vertical units per page 219) <scale>[suffix] (see (see division value in NR3 format page 219) [suffix] ::= {V | mV} <n> ::= 1 to (# analog channels) in NR1 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 203 The following are sample responses from the :CHANnel<n>? query. In this case, the query was issued following a *RST command. :CHAN1:RANG +40.0E+00;OFFS +0.00000E+00;COUP DC;IMP ONEM;DISP 1;BWL 0; INV 0;LAB "1";UNIT VOLT;PROB +10E+00;PROB:SKEW +0.00E+00;STYP SING Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 204: Channel:Bandwidth

    If the bandwidth limit is off, the query returns the full bandwidth of the oscilloscope. When the MAXimum parameter is used, the oscilloscope's maximum possible bandwidth is returned. Return Format <limit><NL> <limit> ::= 25E6 or full bandwidth in NR3 format See Also • ":CHANnel<n>:BWLimit" on page 205 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 205: Channel:Bwlimit

    25 MHz. Query Syntax :CHANnel<n>:BWLimit? The :CHANnel<n>:BWLimit? query returns the current setting of the low-pass filter. Return Format <bwlimit><NL> <bwlimit> ::= {1 | 0} See Also • "Introduction to :CHANnel<n> Commands" on page 203 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 206: Channel:Coupling

    Query Syntax :CHANnel<n>:COUPling? The :CHANnel<n>:COUPling? query returns the current coupling for the specified channel. Return Format <coupling value><NL> <coupling value> ::= {AC | DC} See Also • "Introduction to :CHANnel<n> Commands" on page 203 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 207: Channel:Display

    Return Format <display value><NL> <display value> ::= {1 | 0} See Also • "Introduction to :CHANnel<n> Commands" on page 203 • ":VIEW" on page 165 • ":BLANk" on page 142 • ":STATus" on page 162 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 208: Channel:Impedance

    Query Syntax :CHANnel<n>:IMPedance? The :CHANnel<n>:IMPedance? query returns the current input impedance setting for the specified channel. Return Format <impedance value><NL> <impedance value> ::= ONEM See Also • "Introduction to :CHANnel<n> Commands" on page 203 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 209: Channel:Invert

    Query Syntax :CHANnel<n>:INVert? The :CHANnel<n>:INVert? query returns the current state of the channel inversion. Return Format <invert value><NL> <invert value> ::= {0 | 1} See Also • "Introduction to :CHANnel<n> Commands" on page 203 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 210: Channel:Label

    ' can be useful for organizing the display. myScope.WriteString ":CHANnel1:LABel ""CAL 1""" ' Label ch1 "CAL 1". myScope.WriteString ":CHANnel2:LABel ""CAL2""" ' Label ch1 "CAL2". See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 211: Channel:Offset

    <offset><NL> <offset> ::= Vertical offset value in NR3 format See Also • "Introduction to :CHANnel<n> Commands" on page 203 • ":CHANnel<n>:RANGe" on page 218 • ":CHANnel<n>:SCALe" on page 219 • ":CHANnel<n>:PROBe" on page 212 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 212: Channel:Probe

    ' channel. The probe attenuation factor may be set from 0.1 to 10000 myScope.WriteString ":CHANnel1:PROBe 10" ' Set Probe to 10:1. See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 213: Channel:Probe:head[:Type]

    | DIFF12 | DIFF20 | NONE} See Also • "Introduction to :CHANnel<n> Commands" on page 203 • ":CHANnel<n>:PROBe" on page 212 • ":CHANnel<n>:PROBe:ID" on page 214 • ":CHANnel<n>:PROBe:SKEW" on page 215 • ":CHANnel<n>:PROBe:STYPe" on page 216 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 214: Channel:Probe:id

    • 1159A • AutoProbe • E2621A • E2622A • E2695A • E2697A • HP1152A • HP1153A • NONE • Probe • Unknown • Unsupported See Also • "Introduction to :CHANnel<n> Commands" on page 203 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 215: Channel:Probe:skew

    The :CHANnel<n>:PROBe:SKEW? query returns the current probe skew setting for the selected channel. Return Format <skew value><NL> <skew value> ::= skew value in NR3 format See Also • "Introduction to :CHANnel<n> Commands" on page 203 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 216: Channel:Probe:stype

    The :CHANnel<n>:PROBe:STYPe? query returns the current probe signal type setting for the selected channel. Return Format <signal type><NL> <signal type> ::= {DIFF | SING} See Also • "Introduction to :CHANnel<n> Commands" on page 203 • ":CHANnel<n>:OFFSet" on page 211 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 217: Channel:Protection

    798) Command Syntax :CHANnel<n>:PROTection[:CLEar] <n> ::= 1 to (# analog channels) in NR1 format| 4} With the InfiniiVision DSOX1204A/G oscilloscopes, the analog channel input impedance is always 1 M , so automatic overvoltage protection is not necessary Ω (as it is for channels with 50 input impedance).

  • Page 218: Channel:Range

    ' range value is 8 times the volts per division. myScope.WriteString ":CHANnel1:RANGe 8" ' Set the vertical range to 8 volts. See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 219: Channel:Scale

    Return Format <scale value><NL> <scale value> ::= vertical units per division in NR3 format See Also • "Introduction to :CHANnel<n> Commands" on page 203 • ":CHANnel<n>:RANGe" on page 218 • ":CHANnel<n>:PROBe" on page 212 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 220: Channel:Units

    Return Format <units><NL> <units> ::= {VOLT | AMP} See Also • "Introduction to :CHANnel<n> Commands" on page 203 • ":CHANnel<n>:RANGe" on page 218 • ":CHANnel<n>:PROBe" on page 212 • ":EXTernal:UNITs" on page 258 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 221: Channel:Vernier

    Query Syntax :CHANnel<n>:VERNier? The :CHANnel<n>:VERNier? query returns the current state of the channel's vernier setting. Return Format <vernier value><NL> <vernier value> ::= {0 | 1} See Also • "Introduction to :CHANnel<n> Commands" on page 203 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 222 :CHANnel<n> Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 223: 11 :Demo Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 11 :DEMO Commands When the education kit is licensed (Option EDK), you can output demonstration signals on the oscilloscope's Demo terminal. See "Introduction to :DEMO Commands" on page 223. Table 56 :DEMO Commands Summary...

  • Page 224: Demo:function

    Burst of digital pulses that occur every 50 µs @ ~ 3.6 Vpp, ~1.5 V offset GLITch Burst of 6 digital pulses (plus infrequent glitch) that occurs once every 80 µs @ ~3.6 Vpp, ~1.8 V offset Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 225 <signal> ::= {SIN | NOIS | LFS | AM | RFB | FMB | HARM | COUP | RING | SING | CLK | TRAN | BURS | GLIT | UART | CAN | LIN} See Also • "Introduction to :DEMO Commands" on page 223 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 226: Demo:output

    The :DEMO:OUTPut? query returns the current state of the demo signal output setting. Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :DEMO Commands" on page 223 • ":DEMO:FUNCtion" on page 224 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 227: 12 :Display Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 12 :DISPlay Commands Control how waveforms, graticule, and text are displayed and written on the screen. See "Introduction to :DISPlay Commands" on page 228. Table 57 :DISPlay Commands Summary Command Query Options and Query Returns...
  • Page 228 Use :DISPlay? to query the setup information for the DISPlay subsystem. Return Format The following is a sample response from the :DISPlay? query. In this case, the query was issued following a *RST command. :DISP:LAB 0;VECT 1;PERS MIN Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 229: Display:annotation

    The :DISPlay:ANNotation? query returns the annotation setting. Return Format <value><NL> <value> ::= {0 | 1} See Also • ":DISPlay:ANNotation:TEXT" on page 232 • ":DISPlay:ANNotation:COLor" on page 231 • ":DISPlay:ANNotation:BACKground" on page 230 • "Introduction to :DISPlay Commands" on page 228 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 230: Display:annotation:background

    Return Format <mode><NL> <mode> ::= {OPAQ | INV | TRAN} See Also • ":DISPlay:ANNotation" on page 229 • ":DISPlay:ANNotation:TEXT" on page 232 • ":DISPlay:ANNotation:COLor" on page 231 • "Introduction to :DISPlay Commands" on page 228 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 231: Display:annotation:color

    <color> ::= {CH1 | CH2 | CH3 | CH4 | DIG | MATH | REF | MARK | WHIT | RED} See Also • ":DISPlay:ANNotation" on page 229 • ":DISPlay:ANNotation:TEXT" on page 232 • ":DISPlay:ANNotation:BACKground" on page 230 • "Introduction to :DISPlay Commands" on page 228 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 232: Display:annotation:text

    (ASCII 0x0D). Return Format <string><NL> <string> ::= quoted ASCII string See Also • ":DISPlay:ANNotation" on page 229 • ":DISPlay:ANNotation:COLor" on page 231 • ":DISPlay:ANNotation:BACKground" on page 230 • "Introduction to :DISPlay Commands" on page 228 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 233: Display:clear

    If the oscilloscope is running, all of the data for active channels and functions is erased; however, new data is displayed on the next acquisition. See Also • "Introduction to :DISPlay Commands" on page 228 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 234: Display:data

    ' Open file f or output. Put #1, , byteData ' Write data. Close #1 ' Close file. myScope.IO.Timeout = 5000 See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 235: Display:intensity:waveform

    Query Syntax :DISPlay:INTensity:WAVeform? The :DISPlay:INTensity:WAVeform? query returns the waveform intensity setting. Return Format <value><NL> <value> ::= an integer from 0 to 100 in NR1 format. See Also • "Introduction to :DISPlay Commands" on page 228 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 236: Display:label

    Example Code ' DISP_LABEL - Turns label names ON or OFF on the analyzer display. myScope.WriteString ":DISPlay:LABel ON" ' Turn on labels. See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 237: Display:lablist

    <binary block> ::= an ordered list of up to 75 labels, a maximum of 10 characters each, separated by newline characters. See Also • "Introduction to :DISPlay Commands" on page 228 • ":DISPlay:LABel" on page 236 • ":CHANnel<n>:LABel" on page 210 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 238: Display:menu:timeout

    The :DISPlay:MENU:TIMeout command sets the softkey menu timeout period. OFF and MAX are equivalent. Query Syntax :DISPlay:MENU:TIMeout? The :DISPlay:MENU:TIMeout? query returns the softkey menu timeout period setting. Return Format <value><NL> <value> ::= an integer from 5 to 60 in NR1 format or OFF. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 239: Display:persistence

    :DISPlay:PERSistence? The :DISPlay:PERSistence? query returns the specified persistence value. Return Format <value><NL> <value> ::= {MIN | INF | <time>} See Also • "Introduction to :DISPlay Commands" on page 228 • ":DISPlay:CLEar" on page 233 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 240: Display:vectors

    Query Syntax :DISPlay:VECTors? The :DISPlay:VECTors? query returns the vectors setting. Return Format <vectors><NL> <vectors> ::= 1 See Also • "Introduction to :DISPlay Commands" on page 228 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 241: 13 :Dvm Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 13 :DVM Commands When the optional DSOXDVM digital voltmeter analysis feature is licensed, these commands control the digital voltmeter (DVM) feature. Table 58 :DVM Commands Summary Command Query Options and Query Returns :DVM:ARANge {{0 |...

  • Page 242: Dvm:arange

    The :DVM:ARANge? query returns a flag indicating whether the digital voltmeter's Auto Range capability is on or off. Return Format <setting><NL> <setting> ::= {0 | 1} See Also • ":DVM:SOURce" on page 247 • ":DVM:ENABle" on page 244 • ":DVM:MODE" on page 246 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 243: Dvm:current

    +9.9E+37 is returned. Return Format <dvm_value><NL> <dvm_value> ::= floating-point number in NR3 format See Also • ":DVM:SOURce" on page 247 • ":DVM:ENABle" on page 244 • ":DVM:MODE" on page 246 • ":DVM:FREQuency" on page 245 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 244: Dvm:enable

    The :DVM:ENABle? query returns a flag indicating whether the digital voltmeter (DVM) analysis feature is on or off. Return Format <setting><NL> <setting> ::= {0 | 1} See Also • ":DVM:SOURce" on page 247 • ":DVM:MODE" on page 246 • ":DVM:ARANge" on page 242 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 245: Dvm:frequency

    246), this query will return 9.9E+37. Return Format <freq_value><NL> <freq_value> ::= floating-point number in NR3 format See Also • ":DVM:SOURce" on page 247 • ":DVM:ENABle" on page 244 • ":DVM:MODE" on page 246 • ":DVM:CURRent" on page 243 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 246: Dvm:mode

    <dvm_mode> ::= {ACRM | DC | DCRM | FREQ} See Also • ":DVM:ENABle" on page 244 • ":DVM:SOURce" on page 247 • ":DVM:ARANge" on page 242 • ":DVM:CURRent" on page 243 • ":DVM:FREQuency" on page 245 • ":TRIGger:MODE" on page 594 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 247: Dvm:source

    <n> ::= 1 to (# analog channels) in NR1 format See Also • ":DVM:ENABle" on page 244 • ":DVM:MODE" on page 246 • ":DVM:ARANge" on page 242 • ":DVM:CURRent" on page 243 • ":DVM:FREQuency" on page 245 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 248 :DVM Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 249: 14 :External Trigger Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 14 :EXTernal Trigger Commands Control the input characteristics of the external trigger input. See "Introduction to :EXTernal Trigger Commands" on page 249. Table 59 :EXTernal Trigger Commands Summary Command Query Options and Query Returns...
  • Page 250 Use :EXTernal? to query setup information for the EXTernal subsystem. Return Format The following is a sample response from the :EXTernal query. In this case, the query was issued following a *RST command. :EXT:BWL 0;RANG +8E+00;UNIT VOLT;PROB +1.000E+00 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 251: External:bwlimit

    The :EXTernal:BWLimit? query returns the current setting of the low-pass filter (always 0). Return Format <bwlimit><NL> <bwlimit> ::= 0 See Also • "Introduction to :EXTernal Trigger Commands" on page 249 • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:HFReject" on page 589 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 252: External:display

    :EXTernal:DISPlay (see page 798) Command Syntax :EXTernal:DISPlay {0 | OFF} In the InfiniiVision DSOX1204A/G oscilloscopes, the :EXTernal:DISPlay command can be set only to off. Query Syntax :EXTernal:DISPlay? The :EXTernal:DISPlay? query returns the external trigger input display setting. Return Format <setting><NL>...

  • Page 253: External:label

    Query Syntax :EXTernal:LABel? The :EXTernal:LABel? query returns the label associated with the external trigger input. Return Format <string><NL> <string> ::= quoted ASCII string. See Also • ":EXTernal:DISPlay" on page 252 • ":DISPlay:LABel" on page 236 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 254: External:level

    The :EXTernal:LEVel command sets the external trigger input threshold (trigger) voltage level. Query Syntax :EXTernal:LEVel? The :EXTernal:LEVel? query returns the external trigger input threshold voltage setting. Return Format <value><NL> See Also • ":EXTernal:DISPlay" on page 252 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 255: External:position

    798) Command Syntax :EXTernal:POSition <value> <value> ::= Zero in NR3 format. In the InfiniiVision DSOX1204A/G oscilloscopes, the :EXTernal:POSition command can be set to zero only (since the Ext Trig input cannot be displayed as a digital waveform). Query Syntax :EXTernal:POSition? The :EXTernal:POSition? query returns zero.

  • Page 256: External:probe

    <attenuation> ::= probe attenuation ratio in NR3 format See Also • "Introduction to :EXTernal Trigger Commands" on page 249 • ":EXTernal:RANGe" on page 257 • "Introduction to :TRIGger Commands" on page 585 • ":CHANnel<n>:PROBe" on page 212 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 257: External:range

    <range_argument><NL> <range_argument> ::= external trigger range value in NR3 format See Also • "Introduction to :EXTernal Trigger Commands" on page 249 • ":EXTernal:PROBe" on page 256 • "Introduction to :TRIGger Commands" on page 585 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 258: External:units

    See Also • "Introduction to :EXTernal Trigger Commands" on page 249 • "Introduction to :TRIGger Commands" on page 585 • ":EXTernal:RANGe" on page 257 • ":EXTernal:PROBe" on page 256 • ":CHANnel<n>:UNITs" on page 220 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 259: 15 :Fft Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 15 :FFT Commands Control functions in the measurement/storage module. See "Introduction to :FFT Commands" on page 260. Table 60 :FFT Commands Summary Command Query Options and Query Returns :FFT:CENTer :FFT:CENTer? (see <frequency> ::= the current...
  • Page 260 Return Format The following is a sample response from the :FFT? query. In this case, the query was issued following a *RST command. :FFT:DISP 0;SOUR1 CHAN1;RANG +160E+00;OFFS -60.0000E+00;SPAN +100.0000E+03;CENT +50.000000E+03;WIND HANN;VTYP DEC;DMODE NORM;AVER:COUN 8 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 261: Fft:center

    ":FFT:RANGe" on page 264 • ":FFT:REFerence" on page 265 • ":FFT:SCALe" on page 266 • ":FFT:SOURce1" on page 267 • ":FFT:SPAN" on page 268 • ":FFT:VTYPe" on page 269 • ":FFT:WINDow" on page 270 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 262: Fft:display

    ":FFT:RANGe" on page 264 • ":FFT:REFerence" on page 265 • ":FFT:SCALe" on page 266 • ":FFT:SOURce1" on page 267 • ":FFT:SPAN" on page 268 • ":FFT:VTYPe" on page 269 • ":FFT:WINDow" on page 270 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 263: Fft:offset

    ":FFT:RANGe" on page 264 • ":FFT:REFerence" on page 265 • ":FFT:SCALe" on page 266 • ":FFT:SOURce1" on page 267 • ":FFT:SPAN" on page 268 • ":FFT:VTYPe" on page 269 • ":FFT:WINDow" on page 270 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 264: Fft:range

    ":FFT:OFFSet" on page 263 • ":FFT:REFerence" on page 265 • ":FFT:SCALe" on page 266 • ":FFT:SOURce1" on page 267 • ":FFT:SPAN" on page 268 • ":FFT:VTYPe" on page 269 • ":FFT:WINDow" on page 270 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 265: Fft:reference

    ":FFT:OFFSet" on page 263 • ":FFT:RANGe" on page 264 • ":FFT:SCALe" on page 266 • ":FFT:SOURce1" on page 267 • ":FFT:SPAN" on page 268 • ":FFT:VTYPe" on page 269 • ":FFT:WINDow" on page 270 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 266: Fft:scale

    ":FFT:OFFSet" on page 263 • ":FFT:RANGe" on page 264 • ":FFT:REFerence" on page 265 • ":FFT:SOURce1" on page 267 • ":FFT:SPAN" on page 268 • ":FFT:VTYPe" on page 269 • ":FFT:WINDow" on page 270 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 267: Fft:source1

    ":FFT:OFFSet" on page 263 • ":FFT:RANGe" on page 264 • ":FFT:REFerence" on page 265 • ":FFT:SCALe" on page 266 • ":FFT:SPAN" on page 268 • ":FFT:VTYPe" on page 269 • ":FFT:WINDow" on page 270 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 268: Fft:span

    ":FFT:OFFSet" on page 263 • ":FFT:RANGe" on page 264 • ":FFT:REFerence" on page 265 • ":FFT:SCALe" on page 266 • ":FFT:SOURce1" on page 267 • ":FFT:VTYPe" on page 269 • ":FFT:WINDow" on page 270 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 269: Fft:vtype

    ":FFT:OFFSet" on page 263 • ":FFT:RANGe" on page 264 • ":FFT:REFerence" on page 265 • ":FFT:SCALe" on page 266 • ":FFT:SOURce1" on page 267 • ":FFT:SPAN" on page 268 • ":FFT:WINDow" on page 270 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 270: Fft:window

    ":FFT:DISPlay" on page 262 • ":FFT:OFFSet" on page 263 • ":FFT:RANGe" on page 264 • ":FFT:REFerence" on page 265 • ":FFT:SCALe" on page 266 • ":FFT:SOURce1" on page 267 • ":FFT:SPAN" on page 268 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 271 :FFT Commands • ":FFT:VTYPe" on page 269 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 272 :FFT Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 273: 16 :Franalysis Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 16 :FRANalysis Commands Control oscilloscope functions associated with the Frequency Response Analysis (FRA) feature, which is available in G-suffix oscilloscope models (that have a built-in waveform generator). See "Introduction to :FRANalysis Commands" page 274.
  • Page 274 Use :FRANalysis? to query setup information for the FRANalysis subsystem. Return Format The following is a sample response from the :FRANalysis? query. In this case, the query was issued following a *RST command. :FRAN:SOUR:INP CHAN1;OUTP CHAN2;:FRAN:FREQ:STAR +100E+00; STOP +20.000000E+06;:FRAN:WGEN:VOLT +200.0E-03;LOAD FIFT Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 275: Franalysis:data

    ":FRANalysis:FREQuency:STOP" on page 280 • ":FRANalysis:RUN" on page 281 • ":FRANalysis:SOURce:INPut" on page 282 • ":FRANalysis:SOURce:OUTPut" on page 283 • ":FRANalysis:TRACe" on page 285 • ":FRANalysis:WGEN:LOAD" on page 286 • ":FRANalysis:WGEN:VOLTage" on page 287 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 276: Franalysis:enable

    ":FRANalysis:FREQuency:STARt" on page 279 • ":FRANalysis:FREQuency:STOP" on page 280 • ":FRANalysis:RUN" on page 281 • ":FRANalysis:SOURce:INPut" on page 282 • ":FRANalysis:SOURce:OUTPut" on page 283 • ":FRANalysis:WGEN:LOAD" on page 286 • ":FRANalysis:WGEN:VOLTage" on page 287 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 277: Franalysis:frequency:mode

    Return Format <setting><NL> <setting> ::= {SWEep | SINGle} See Also • ":FRANalysis:RUN" on page 281 • ":FRANalysis:FREQuency:SINGle" on page 278 • ":FRANalysis:FREQuency:STARt" on page 279 • ":FRANalysis:FREQuency:STOP" on page 280 • ":FRANalysis:SWEep:POINts" on page 284 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 278: Franalysis:frequency:single

    ":FRANalysis:SWEep:POINts" on page 284 • ":FRANalysis:FREQuency:MODE" on page 277 • ":FRANalysis:RUN" on page 281 • ":FRANalysis:SOURce:INPut" on page 282 • ":FRANalysis:SOURce:OUTPut" on page 283 • ":FRANalysis:WGEN:LOAD" on page 286 • ":FRANalysis:WGEN:VOLTage" on page 287 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 279: Franalysis:frequency:start

    ":FRANalysis:SWEep:POINts" on page 284 • ":FRANalysis:FREQuency:MODE" on page 277 • ":FRANalysis:RUN" on page 281 • ":FRANalysis:SOURce:INPut" on page 282 • ":FRANalysis:SOURce:OUTPut" on page 283 • ":FRANalysis:WGEN:LOAD" on page 286 • ":FRANalysis:WGEN:VOLTage" on page 287 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 280: Franalysis:frequency:stop

    ":FRANalysis:SWEep:POINts" on page 284 • ":FRANalysis:FREQuency:MODE" on page 277 • ":FRANalysis:RUN" on page 281 • ":FRANalysis:SOURce:INPut" on page 282 • ":FRANalysis:SOURce:OUTPut" on page 283 • ":FRANalysis:WGEN:LOAD" on page 286 • ":FRANalysis:WGEN:VOLTage" on page 287 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 281: Franalysis:run

    • ":FRANalysis:SOURce:INPut" on page 282 • ":FRANalysis:SOURce:OUTPut" on page 283 • ":FRANalysis:TRACe" on page 285 • ":FRANalysis:WGEN:LOAD" on page 286 • ":FRANalysis:WGEN:VOLTage" on page 287 • "*ESR (Standard Event Status Register)" on page 114 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 282: Franalysis:source:input

    ":FRANalysis:ENABle" on page 276 • ":FRANalysis:FREQuency:STARt" on page 279 • ":FRANalysis:FREQuency:STOP" on page 280 • ":FRANalysis:RUN" on page 281 • ":FRANalysis:SOURce:OUTPut" on page 283 • ":FRANalysis:WGEN:LOAD" on page 286 • ":FRANalysis:WGEN:VOLTage" on page 287 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 283: Franalysis:source:output

    ":FRANalysis:ENABle" on page 276 • ":FRANalysis:FREQuency:STARt" on page 279 • ":FRANalysis:FREQuency:STOP" on page 280 • ":FRANalysis:RUN" on page 281 • ":FRANalysis:SOURce:INPut" on page 282 • ":FRANalysis:WGEN:LOAD" on page 286 • ":FRANalysis:WGEN:VOLTage" on page 287 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 284: Franalysis:sweep:points

    The :FRANalysis:SWEep:POINts command specifies the total number of points in the frequency response analysis. Query Syntax :FRANalysis:SWEep:POINts? The :FRANalysis:SWEep:POINts? query returns the number of points setting. Return Format <pts><NL> See Also • ":FRANalysis:FREQuency:STARt" on page 279 • ":FRANalysis:FREQuency:STOP" on page 280 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 285: Franalysis:trace

    "NONE" if neither gain nor phase data is included. Return Format <selection_list><NL> <selection_list> ::= {"NONE" | "GAIN" | "PHASe" | "GAIN,PHASe"} See Also • ":FRANalysis:RUN" on page 281 • ":FRANalysis:DATA" on page 275 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 286: Franalysis:wgen:load

    ":FRANalysis:ENABle" on page 276 • ":FRANalysis:FREQuency:STARt" on page 279 • ":FRANalysis:FREQuency:STOP" on page 280 • ":FRANalysis:RUN" on page 281 • ":FRANalysis:SOURce:INPut" on page 282 • ":FRANalysis:SOURce:OUTPut" on page 283 • ":FRANalysis:WGEN:VOLTage" on page 287 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 287: Franalysis:wgen:voltage

    ":FRANalysis:FREQuency:STARt" on page 279 • ":FRANalysis:FREQuency:STOP" on page 280 • ":FRANalysis:SWEep:POINts" on page 284 • ":FRANalysis:RUN" on page 281 • ":FRANalysis:SOURce:INPut" on page 282 • ":FRANalysis:SOURce:OUTPut" on page 283 • ":FRANalysis:WGEN:LOAD" on page 286 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 288 :FRANalysis Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 289: 17 :Function Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 17 :FUNCtion Commands Control functions in the measurement/storage module. See "Introduction to :FUNCtion Commands" on page 291. Table 62 :FUNCtion Commands Summary Command Query Options and Query Returns :FUNCtion:DISPlay {{0 :FUNCtion:DISPlay? {0 | 1}...
  • Page 290 GOFT is only for FFT operation. :FUNCtion:SOURce2 :FUNCtion:SOURce2? <source> ::= {CHANnel<n> | NONE} page 309) <source> (see (see <n> ::= 1 to (# analog channels) page 309) in NR1 format, depending on SOURce1 selection Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 291 Use :FUNCtion? to query setup information for the FUNCtion subsystem. Return Format The following is a sample response from the :FUNCtion? queries. In this case, the query was issued following a *RST command. :FUNC:OPER ADD;DISP 0;SOUR1 CHAN1;SOUR2 CHAN2;RANG +8.00E+00;OFFS +0.0E+00;:FUNC:GOFT:OPER ADD;SOUR1 CHAN1;SOUR2 CHAN2 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 292: Function:display

    The :FUNCtion:DISPlay? query returns whether the function display is on or off. Return Format <display><NL> <display> ::= {1 | 0} See Also • "Introduction to :FUNCtion Commands" on page 291 • ":VIEW" on page 165 • ":BLANk" on page 142 • ":STATus" on page 162 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 293: Function[:Fft]:Center

    :FUNCtion:SPAN value, they no longer track the :TIMebase:RANGe value. See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion[:FFT]:SPAN" on page 295 • ":TIMebase:RANGe" on page 577 • ":TIMebase:SCALe" on page 579 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 294: Function[:Fft]:Phase:reference

    Query Syntax :FUNCtion[:FFT]:PHASe:REFerence? The :FUNCtion[:FFT]:PHASe:REFerence? query returns the selected reference point. Return Format <ref_point><NL> <ref_point> ::= {TRIGger | DISPlay} See Also • ":FUNCtion:OPERation" on page 303 • "Introduction to :FUNCtion Commands" on page 291 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 295: Function[:Fft]:Span

    <span> ::= the current frequency span in NR3 format. Legal values are 1 Hz to 100 GHz. See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion[:FFT]:CENTer" on page 293 • ":TIMebase:RANGe" on page 577 • ":TIMebase:SCALe" on page 579 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 296: Function[:Fft]:Vtype

    <units> ::= {DEC | VRMS} for the FFT (magnitude) operation <units> ::= {DEGR | RAD} for the FFTPhase operation See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:OPERation" on page 303 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 297: Function[:Fft]:Window

    The :FUNCtion[:FFT]:WINDow? query returns the value of the window selected for the FFT function. Return Format <window><NL> <window> ::= {RECT | HANN | FLAT | BHAR} See Also • "Introduction to :FUNCtion Commands" on page 291 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 298: Function:frequency:lowpass

    The low-pass filter is a 4th order Bessel-Thompson filter. Query Syntax :FUNCtion:FREQuency:LOWPass? The :FUNCtion:FREQuency:LOWPass query returns the low-pass filter's cutoff frequency. Return Format <3dB_freq><NL> <3dB_freq> ::= -3dB cutoff frequency value in NR3 format See Also • ":FUNCtion:OPERation" on page 303 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 299: Function:goft:operation

    Return Format <operation><NL> <operation> ::= {ADD | SUBT | MULT} See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:GOFT:SOURce1" on page 300 • ":FUNCtion:GOFT:SOURce2" on page 301 • ":FUNCtion:SOURce1" on page 308 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 300: Function:goft:source1

    <value><NL> <value> ::= CHAN<n> <n> ::= 1 to (# analog channels) in NR1 format See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:GOFT:SOURce2" on page 301 • ":FUNCtion:GOFT:OPERation" on page 299 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 301: Function:goft:source2

    <value><NL> <value> ::= CHAN<n> <n> ::= 1 to (# analog channels) in NR1 format See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:GOFT:SOURce1" on page 300 • ":FUNCtion:GOFT:OPERation" on page 299 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 302: Function:offset

    <offset> ::= the value at center screen in NR3 format. See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:RANGe" on page 305 • ":FUNCtion:REFerence" on page 306 • ":FUNCtion:SCALe" on page 307 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 303: Function:operation

    Query Syntax :FUNCtion:OPERation? The :FUNCtion:OPERation? query returns the current operation for the selected function. Return Format <operation><NL> <operation> ::= {ADD | SUBT | MULT | DIV | FFT | FFTP | LOWP} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 304 :FUNCtion Commands See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:SOURce1" on page 308 • ":FUNCtion:SOURce2" on page 309 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 305: Function:range

    The :FUNCtion:RANGe? query returns the current full-scale range value for the selected function. Return Format <range><NL> <range> ::= the full-scale vertical axis value in NR3 format. See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:SCALe" on page 307 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 306: Function:reference

    <level> ::= the current reference level in NR3 format. See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:OFFSet" on page 302 • ":FUNCtion:RANGe" on page 305 • ":FUNCtion:SCALe" on page 307 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 307: Function:scale

    The :FUNCtion:SCALe? query returns the current scale value for the selected function. Return Format <scale value><NL> <scale value> ::= integer in NR1 format See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:RANGe" on page 305 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 308: Function:source1

    <n> ::= 1 to (# analog channels) in NR1 format See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:OPERation" on page 303 • ":FUNCtion:GOFT:OPERation" on page 299 • ":FUNCtion:GOFT:SOURce1" on page 300 • ":FUNCtion:GOFT:SOURce2" on page 301 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 309: Function:source2

    <value> ::= {CHAN<n> | NONE} <n> ::= 1 to (# analog channels) in NR1 format See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:OPERation" on page 303 • ":FUNCtion:SOURce1" on page 308 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 310 :FUNCtion Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 311: 18 :Hardcopy Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 18 :HARDcopy Commands Set and query the selection of hardcopy device and formatting options. See "Introduction to :HARDcopy Commands" on page 312. Table 63 :HARDcopy Commands Summary Command Query Options and Query Returns :HARDcopy:AREA <area>...
  • Page 312 Use :HARDcopy? to query setup information for the HARDcopy subsystem. Return Format The following is a sample response from the :HARDcopy? query. In this case, the query was issued following the *RST command. :HARD:APR "";AREA SCR;FACT 0;FFE 0;INKS 1;PAL NONE;LAY PORT Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 313: Hardcopy:area

    ":HARDcopy:APRinter" on page 314 • ":HARDcopy:PRINter:LIST" on page 323 • ":HARDcopy:FACTors" on page 315 • ":HARDcopy:FFEed" on page 316 • ":HARDcopy:INKSaver" on page 317 • ":HARDcopy:LAYout" on page 318 • ":HARDcopy:PALette" on page 322 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 314: Hardcopy:aprinter

    The :HARDcopy:APRinter? query returns the name of the active printer. Return Format <name><NL> <name> ::= name of printer in list See Also • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:PRINter:LIST" on page 323 • ":HARDcopy:STARt" on page 324 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 315: Hardcopy:factors

    See Also • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:STARt" on page 324 • ":HARDcopy:FFEed" on page 316 • ":HARDcopy:INKSaver" on page 317 • ":HARDcopy:LAYout" on page 318 • ":HARDcopy:PALette" on page 322 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 316: Hardcopy:ffeed

    See Also • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:STARt" on page 324 • ":HARDcopy:FACTors" on page 315 • ":HARDcopy:INKSaver" on page 317 • ":HARDcopy:LAYout" on page 318 • ":HARDcopy:PALette" on page 322 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 317: Hardcopy:inksaver

    See Also • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:STARt" on page 324 • ":HARDcopy:FACTors" on page 315 • ":HARDcopy:FFEed" on page 316 • ":HARDcopy:LAYout" on page 318 • ":HARDcopy:PALette" on page 322 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 318: Hardcopy:layout

    See Also • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:STARt" on page 324 • ":HARDcopy:FACTors" on page 315 • ":HARDcopy:PALette" on page 322 • ":HARDcopy:FFEed" on page 316 • ":HARDcopy:INKSaver" on page 317 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 319: Hardcopy:network:address

    The :HARDcopy:NETWork:ADDRess? query returns the specified address for the currently selected network printer slot. Return Format <address><NL> <address> ::= quoted ASCII string See Also • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:NETWork:SLOT" on page 321 • ":HARDcopy:NETWork:APPLy" on page 320 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 320: Hardcopy:network:apply

    :HARDcopy:NETWork:APPLy The :HARDcopy:NETWork:APPLy command applies the network printer settings and makes the printer connection. See Also • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:NETWork:SLOT" on page 321 • ":HARDcopy:NETWork:ADDRess" on page 319 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 321: Hardcopy:network:slot

    The :HARDcopy:NETWork:SLOT? query returns the currently selected network printer slot. Return Format <slot><NL> <slot> ::= {NET0 | NET1} See Also • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:NETWork:APPLy" on page 320 • ":HARDcopy:NETWork:ADDRess" on page 319 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 322: Hardcopy:palette

    See Also • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:STARt" on page 324 • ":HARDcopy:FACTors" on page 315 • ":HARDcopy:LAYout" on page 318 • ":HARDcopy:FFEed" on page 316 • ":HARDcopy:INKSaver" on page 317 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 323: Hardcopy:printer:list

    <active> ::= {Y | N} <name> ::= name of printer (for example "DESKJET 950C") See Also • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:APRinter" on page 314 • ":HARDcopy:STARt" on page 324 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 324: Hardcopy:start

    ":HARDcopy:APRinter" on page 314 • ":HARDcopy:PRINter:LIST" on page 323 • ":HARDcopy:FACTors" on page 315 • ":HARDcopy:FFEed" on page 316 • ":HARDcopy:INKSaver" on page 317 • ":HARDcopy:LAYout" on page 318 • ":HARDcopy:PALette" on page 322 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 325: 19 :Marker Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 19 :MARKer Commands Set and query the settings of X-axis markers (X1 and X2 cursors) and the Y-axis markers (Y1 and Y2 cursors). See "Introduction to :MARKer Commands" page 326. Table 64 :MARKer Commands Summary...
  • Page 326 X and Y cursors, and query delta X and delta Y cursor values. Reporting the Setup Use :MARKer? to query setup information for the MARKer subsystem. Return Format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 327 :MARKer Commands The following is a sample response from the :MARKer? query. In this case, the query was issued following a *RST and ":MARKer:MODE MANual" command. :MARK:X1Y1 CHAN1;X2Y2 CHAN1;MODE MAN Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 328: Marker:mode

    ":MARKer:X1Y1source" on page 330 • ":MARKer:X2Y2source" on page 332 • ":MEASure:SOURce" on page 380 • ":MARKer:X1Position" on page 329 • ":MARKer:X2Position" on page 331 • ":MARKer:Y1Position" on page 336 • ":MARKer:Y2Position" on page 337 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 329: Marker:x1Position

    "Introduction to :MARKer Commands" on page 326 • ":MARKer:MODE" on page 328 • ":MARKer:X2Position" on page 331 • ":MARKer:X1Y1source" on page 330 • ":MARKer:X2Y2source" on page 332 • ":MARKer:XUNits" on page 334 • ":MEASure:TSTArt" on page 737 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 330: Marker:x1Y1Source

    <source> ::= {CHAN<n> | FUNC | FFT | WMEM<r> | NONE} See Also • "Introduction to :MARKer Commands" on page 326 • ":MARKer:MODE" on page 328 • ":MARKer:X2Y2source" on page 332 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 331: Marker:x2Position

    See Also • "Introduction to :MARKer Commands" on page 326 • ":MARKer:MODE" on page 328 • ":MARKer:X1Position" on page 329 • ":MARKer:X2Y2source" on page 332 • ":MARKer:XUNits" on page 334 • ":MEASure:TSTOp" on page 738 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 332: Marker:x2Y2Source

    <source> ::= {CHAN<n> | FUNC | WMEM<r> | NONE} See Also • "Introduction to :MARKer Commands" on page 326 • ":MARKer:MODE" on page 328 • ":MARKer:X1Y1source" on page 330 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 333: Marker:xdelta

    "Introduction to :MARKer Commands" on page 326 • ":MARKer:MODE" on page 328 • ":MARKer:X1Position" on page 329 • ":MARKer:X2Position" on page 331 • ":MARKer:X1Y1source" on page 330 • ":MARKer:X2Y2source" on page 332 • ":MARKer:XUNits" on page 334 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 334: Marker:xunits

    "Introduction to :MARKer Commands" on page 326 • ":MARKer:XUNits:USE" on page 335 • ":MARKer:X1Y1source" on page 330 • ":MARKer:X2Y2source" on page 332 • ":MEASure:SOURce" on page 380 • ":MARKer:X1Position" on page 329 • ":MARKer:X2Position" on page 331 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 335: Marker:xunits:use

    ":MARKer:XUNits" on page 334 • ":MARKer:X1Y1source" on page 330 • ":MARKer:X2Y2source" on page 332 • ":MEASure:SOURce" on page 380 • ":MARKer:X1Position" on page 329 • ":MARKer:X2Position" on page 331 • ":MARKer:XDELta" on page 333 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 336: Marker:y1Position

    "Introduction to :MARKer Commands" on page 326 • ":MARKer:MODE" on page 328 • ":MARKer:X1Y1source" on page 330 • ":MARKer:X2Y2source" on page 332 • ":MARKer:Y2Position" on page 337 • ":MARKer:YUNits" on page 339 • ":MEASure:VSTArt" on page 742 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 337: Marker:y2Position

    "Introduction to :MARKer Commands" on page 326 • ":MARKer:MODE" on page 328 • ":MARKer:X1Y1source" on page 330 • ":MARKer:X2Y2source" on page 332 • ":MARKer:Y1Position" on page 336 • ":MARKer:YUNits" on page 339 • ":MEASure:VSTOp" on page 743 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 338: Marker:ydelta

    "Introduction to :MARKer Commands" on page 326 • ":MARKer:MODE" on page 328 • ":MARKer:X1Y1source" on page 330 • ":MARKer:X2Y2source" on page 332 • ":MARKer:Y1Position" on page 336 • ":MARKer:Y2Position" on page 337 • ":MARKer:YUNits" on page 339 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 339: Marker:yunits

    ":MARKer:YUNits:USE" on page 340 • ":MARKer:X1Y1source" on page 330 • ":MARKer:X2Y2source" on page 332 • ":MEASure:SOURce" on page 380 • ":MARKer:Y1Position" on page 336 • ":MARKer:Y2Position" on page 337 • ":MARKer:YDELta" on page 338 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 340: Marker:yunits:use

    ":MARKer:YUNits" on page 339 • ":MARKer:X1Y1source" on page 330 • ":MARKer:X2Y2source" on page 332 • ":MEASure:SOURce" on page 380 • ":MARKer:Y1Position" on page 336 • ":MARKer:Y2Position" on page 337 • ":MARKer:YDELta" on page 338 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 341: 20 :Measure Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 20 :MEASure Commands Select automatic measurements to be made and control time markers. See "Introduction to :MEASure Commands" on page 350. Table 65 :MEASure Commands Summary Command Query Options and Query Returns :MEASure:ALL (see...
  • Page 342 FUNCtion | MATH | WMEMory<r> | page 361) page 361) EXTernal} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= ratio of positive pulse width to period in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 343 FUNCtion | MATH | WMEMory<r>} page 366) page 366) <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= the falling pulse count in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 344 [,<source2>] (see [,<source2>] (see <n> ::= 1 to (# analog channels) page 372) page 372) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= the phase angle value in degrees in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 345 FUNCtion | MATH | WMEMory<r>} page 377) page 377) <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= rise time in seconds in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 346 <source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= time in seconds of the specified transition Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 347 FUNCtion | MATH | WMEMory<r>} page 388) page 388) <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <base_voltage> ::= voltage at the base of the selected waveform in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 348 392) page 392) FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= calculated dc RMS voltage in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 349 397) page 397) WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1 to (# ref waveforms) in NR1 format <return_value> ::= horizontal value of the maximum in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 350 Not all measurements are available on the FFT (Fast Fourier Transform). Reporting the Setup Use the :MEASure? query to obtain setup information for the MEASure subsystem. (Currently, this is only :MEASure:SOURce.) Return Format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 351 :MEASure Commands The following is a sample response from the :MEASure? query. In this case, the query was issued following a *RST command. :MEAS:SOUR CHAN1,CHAN2;STAT ON Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 352: Measure:all

    :MEASure Commands :MEASure:ALL (see page 798) Command Syntax :MEASure:ALL This command installs a Snapshot All measurement on the screen. See Also • "Introduction to :MEASure Commands" on page 350 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 353: Measure:brate

    <value><NL> <value> ::= the bit rate value in Hertz See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:FREQuency" on page 363 • ":MEASure:PERiod" on page 371 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 354: Measure:clear

    :MEASure Commands :MEASure:CLEar (see page 798) Command Syntax :MEASure:CLEar This command clears all selected measurements and markers from the screen. See Also • "Introduction to :MEASure Commands" on page 350 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 355: Measure:counter

    <source><NL> <source> ::= count in Hertz in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:FREQuency" on page 363 • ":MEASure:CLEar" on page 354 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 356: Measure:define

    DELay FALLtime FREQuency NWIDth OVERshoot PERiod PHASe PREShoot PWIDth RISetime VAVerage VRMS :MEASure:DEFine :MEASure:DEFine DELay,<delay spec>[,<source>] DELay Command <delay spec> ::= <edge_spec1>,<edge_spec2> Syntax <edge_spec1> ::= [<slope>]<occurrence> <edge_spec2> ::= [<slope>]<occurrence> <slope> ::= {+ | -} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 357 :MEASure:DEFine? <meas_spec>[,<source>] <meas_spec> ::= {DELay | THResholds} The :MEASure:DEFine? query returns the current edge specification for the delay measurements setup or the current specification for the thresholds setup. Return Format for <meas_spec> = DELay: Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 358 "Introduction to :MEASure Commands" on page 350 • ":MEASure:DELay" on page 359 • ":MEASure:SOURce" on page 380 • ":CHANnel<n>:RANGe" on page 218 • ":CHANnel<n>:SCALe" on page 219 • ":CHANnel<n>:PROBe" on page 212 • ":CHANnel<n>:UNITs" on page 220 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 359: Measure:delay

    Also in the :MEASure:DEFine command, you can set upper, middle, and lower threshold values. It is the middle threshold value that is used when performing the delay query. The standard upper, middle, and lower measurement thresholds are Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 360 Return Format <value><NL> <value> ::= floating-point number delay time in seconds in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:DEFine" on page 356 • ":MEASure:PHASe" on page 372 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 361: Measure:dutycycle

    <value> ::= ratio of positive pulse width to period in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:PERiod" on page 371 • ":MEASure:PWIDth" on page 375 • ":MEASure:SOURce" on page 380 Example Code • "Example Code" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 362: Measure:falltime

    <value> ::= time in seconds between the lower threshold and upper threshold in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:RISetime" on page 377 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 363: Measure:frequency

    <source> ::= frequency in Hertz in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:PERiod" on page 371 Example Code • "Example Code" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 364: Measure:nduty

    <value> ::= ratio of negative pulse width to period in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:PERiod" on page 371 • ":MEASure:NWIDth" on page 367 • ":MEASure:SOURce" on page 380 • ":MEASure:DUTYcycle" on page 361 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 365: Measure:nedges

    The :MEASure:NEDGes? query measures and returns the on-screen falling edge count. Return Format <value><NL> <value> ::= the falling edge count in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 366: Measure:npulses

    The :MEASure:NPULses? query measures and returns the on-screen falling pulse count. Return Format <value><NL> <value> ::= the falling pulse count in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 367: Measure:nwidth

    <value> ::= negative pulse width in seconds in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:PWIDth" on page 375 • ":MEASure:PERiod" on page 371 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 368: Measure:overshoot

    <overshoot>::= the percent of the overshoot of the selected waveform in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:PREShoot" on page 374 • ":MEASure:SOURce" on page 380 • ":MEASure:VMAX" on page 389 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 369 :MEASure Commands • ":MEASure:VTOP" on page 394 • ":MEASure:VBASe" on page 388 • ":MEASure:VMIN" on page 390 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 370: Measure:pedges

    The :MEASure:NEDGes? query measures and returns the on-screen rising edge count. Return Format <value><NL> <value> ::= the rising edge count in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 371: Measure:period

    "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:NWIDth" on page 367 • ":MEASure:PWIDth" on page 375 • ":MEASure:FREQuency" on page 363 Example Code • "Example Code" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 372: Measure:phase

    <value> ::= the phase angle value in degrees in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:DELay" on page 359 • ":MEASure:PERiod" on page 371 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 373: Measure:ppulses

    The :MEASure:PPULses? query measures and returns the on-screen rising pulse count. Return Format <value><NL> <value> ::= the rising pulse count in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 374: Measure:preshoot

    See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:VMIN" on page 390 • ":MEASure:VMAX" on page 389 • ":MEASure:VTOP" on page 394 • ":MEASure:VBASe" on page 388 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 375: Measure:pwidth

    <value> ::= width of positive pulse in seconds in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:NWIDth" on page 367 • ":MEASure:PERiod" on page 371 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 376: Measure:results

    When no quick measurements are installed, the :MEASure:RESults? query returns nothing (empty string). Return Format <result_list><NL> <result_list> ::= comma-separated list of measurement results See Also • "Introduction to :MEASure Commands" on page 350 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 377: Measure:risetime

    = time at upper threshold - time at lower threshold Return Format <value><NL> <value> ::= rise time in seconds in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:FALLtime" on page 362 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 378: Measure:sdeviation

    Return Format <value><NL> <value> ::= calculated std deviation value in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:VRMS" on page 392 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 379: Measure:show

    This feature is always on. Query Syntax :MEASure:SHOW? The :MEASure:SHOW? query returns the current state of the markers. Return Format <show><NL> <show> ::= 1 See Also • "Introduction to :MEASure Commands" on page 350 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 380: Measure:source

    372 Example Code ' MEASURE - The commands in the MEASURE subsystem are used to make ' measurements on displayed waveforms. myScope.WriteString ":MEASURE:SOURCE CHANNEL1" ' Source to measure. myScope.WriteString ":MEASURE:FREQUENCY?" ' Query for frequency. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 381 ' Query for Vmax. varQueryResult = myScope.ReadNumber ' Read Vmax. MsgBox "Maximum voltage:" + vbCrLf _ + FormatNumber(varQueryResult, 4) + " V" See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 382: Measure:tedge

    For an example of making a delay and phase measurement, see ":MEASure:TEDGe Code" on page 383. If the optional source parameter is specified, the current source is modified. This query is not available if the source is FFT (Fast Fourier Transform). N OTE Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 383 MsgBox "Phase = " + vbCrLf + CStr(dblPhase) See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:TVALue" on page 384 • ":MEASure:VTIMe" on page 393 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 384: Measure:tvalue

    If the optional source parameter is specified, the current source is modified. This query is not available if the source is FFT (Fast Fourier Transform). N OTE Return Format <value><NL> <value> ::= time in seconds of the specified value crossing in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 385 :MEASure Commands See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:TEDGe" on page 382 • ":MEASure:VTIMe" on page 393 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 386: Measure:vamplitude

    <value> ::= the amplitude of the selected waveform in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:VBASe" on page 388 • ":MEASure:VTOP" on page 394 • ":MEASure:VPP" on page 391 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 387: Measure:vaverage

    If at least three edges are not present, the oscilloscope averages all data points. Return Format <value><NL> <value> ::= calculated average value in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 388: Measure:vbase

    <base_voltage> ::= value at the base of the selected waveform in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:VTOP" on page 394 • ":MEASure:VAMPlitude" on page 386 • ":MEASure:VMIN" on page 390 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 389: Measure:vmax

    <value> ::= maximum vertical value of the selected waveform in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:VMIN" on page 390 • ":MEASure:VPP" on page 391 • ":MEASure:VTOP" on page 394 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 390: Measure:vmin

    <value> ::= minimum vertical value of the selected waveform in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:VBASe" on page 388 • ":MEASure:VMAX" on page 389 • ":MEASure:VPP" on page 391 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 391: Measure:vpp

    <value> ::= vertical peak to peak value in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:VMAX" on page 389 • ":MEASure:VMIN" on page 390 • ":MEASure:VAMPlitude" on page 386 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 392: Measure:vrms

    RMS value on all displayed data points. Return Format <value><NL> <value> ::= calculated dc RMS value in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 393: Measure:vtime

    <value> ::= value at the specified time in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:TEDGe" on page 382 • ":MEASure:TVALue" on page 384 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 394: Measure:vtop

    <value> ::= vertical value at the top of the waveform in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 • ":MEASure:VMAX" on page 389 • ":MEASure:VAMPlitude" on page 386 • ":MEASure:VBASe" on page 388 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 395: Measure:window

    The :MEASure:WINDow? query returns the current measurement window setting. Return Format <type><NL> <type> ::= {MAIN | ZOOM | AUTO} See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:SOURce" on page 380 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 396: Measure:xmax

    Return Format <value><NL> <value> ::= horizontal value of the maximum in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:XMIN" on page 397 • ":MEASure:TMAX" on page 735 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 397: Measure:xmin

    Return Format <value><NL> <value> ::= horizontal value of the minimum in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:XMAX" on page 396 • ":MEASure:TMIN" on page 736 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 398 :MEASure Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 399: 21 :Mtest Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 21 :MTESt Commands Mask testing is available on the DSOX1000-Series oscilloscope models. The MTESt subsystem commands and queries control the mask test features. See "Introduction to :MTESt Commands" on page 401. Table 66 :MTESt Commands Summary...
  • Page 400 :MTESt:SCALe:BIND {{0 :MTESt:SCALe:BIND? {0 | 1} page 426) | OFF} | {1 | ON}} (see page 426) (see :MTESt:SCALe:X1 :MTESt:SCALe:X1? (see <x1_value> ::= X1 value in NR3 page 427) <x1_value> (see format page 427) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 401 FOR;RMOD:TIME +1E+00;WAV 1000;SIGM +6.0E+00;:MTES:RMOD:FACT:STOP 0;PRIN 0;SAVE 0 Example Code ' Mask testing commands example. ' ------------------------------------------------------------------- Option Explicit Public myMgr As VisaComLib.ResourceManager Public myScope As VisaComLib.FormattedIO488 Public varQueryResult As Variant Public strQueryResult As String Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 402 ":MTESt:AMASk:YDELta?" varQueryResult = myScope.ReadNumber Debug.Print "Mask test auto-mask Y delta: " + _ FormatNumber(varQueryResult) ' Enable "Auto Mask Created" event (bit 10, &H400) myScope.WriteString "*CLS" myScope.WriteString ":MTEenable " + CStr(CInt("&H400")) ' Create mask. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 403 Debug.Print "Mask test failed waveforms: " + strQueryResult myScope.WriteString ":MTESt:COUNt:TIME?" strQueryResult = myScope.ReadString Debug.Print "Mask test elapsed seconds: " + strQueryResult Exit Sub VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.Description End Sub Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 404: Mtest:all

    • OFF — Just the selected source channel is included in the test. Query Syntax :MTESt:ENABle? The :MTESt:ENABle? query returns the current setting. Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :MTESt Commands" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 405: Mtest:amask:create

    401 • ":MTESt:AMASk:XDELta" on page 408 • ":MTESt:AMASk:YDELta" on page 409 • ":MTESt:AMASk:UNITs" on page 407 • ":MTESt:AMASk:SOURce" on page 406 • ":MTESt:SOURce" on page 431 Example Code • "Example Code" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 406: Mtest:amask:source

    "Introduction to :MTESt Commands" on page 401 • ":MTESt:AMASk:XDELta" on page 408 • ":MTESt:AMASk:YDELta" on page 409 • ":MTESt:AMASk:UNITs" on page 407 • ":MTESt:SOURce" on page 431 Example Code • "Example Code" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 407: Mtest:amask:units

    401 • ":MTESt:AMASk:XDELta" on page 408 • ":MTESt:AMASk:YDELta" on page 409 • ":CHANnel<n>:UNITs" on page 220 • ":MTESt:AMASk:SOURce" on page 406 • ":MTESt:SOURce" on page 431 Example Code • "Example Code" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 408: Mtest:amask:xdelta

    "Introduction to :MTESt Commands" on page 401 • ":MTESt:AMASk:UNITs" on page 407 • ":MTESt:AMASk:YDELta" on page 409 • ":MTESt:AMASk:SOURce" on page 406 • ":MTESt:SOURce" on page 431 Example Code • "Example Code" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 409: Mtest:amask:ydelta

    "Introduction to :MTESt Commands" on page 401 • ":MTESt:AMASk:UNITs" on page 407 • ":MTESt:AMASk:XDELta" on page 408 • ":MTESt:AMASk:SOURce" on page 406 • ":MTESt:SOURce" on page 431 Example Code • "Example Code" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 410: Mtest:count:fwaveforms

    "Introduction to :MTESt Commands" on page 401 • ":MTESt:COUNt:WAVeforms" on page 413 • ":MTESt:COUNt:TIME" on page 412 • ":MTESt:COUNt:RESet" on page 411 • ":MTESt:SOURce" on page 431 Example Code • "Example Code" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 411: Mtest:count:reset

    Command Syntax :MTESt:COUNt:RESet The :MTESt:COUNt:RESet command resets the mask statistics. See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:COUNt:WAVeforms" on page 413 • ":MTESt:COUNt:FWAVeforms" on page 410 • ":MTESt:COUNt:TIME" on page 412 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 412: Mtest:count:time

    <time> ::= elapsed seconds in NR3 format. See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:COUNt:WAVeforms" on page 413 • ":MTESt:COUNt:FWAVeforms" on page 410 • ":MTESt:COUNt:RESet" on page 411 Example Code • "Example Code" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 413: Mtest:count:waveforms

    <count> ::= number of waveforms in NR1 format. See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:COUNt:FWAVeforms" on page 410 • ":MTESt:COUNt:TIME" on page 412 • ":MTESt:COUNt:RESet" on page 411 Example Code • "Example Code" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 414: Mtest:data

    # definite-length format defined in the IEEE 488.2 specification. Return Format <mask><NL> <mask> ::= binary block data in IEEE 488.2 # format See Also • ":SAVE:MASK[:STARt]" on page 450 • ":RECall:MASK[:STARt]" on page 436 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 415: Mtest:delete

    :MTESt Commands :MTESt:DELete (see page 798) Command Syntax :MTESt:DELete The :MTESt:DELete command clears the currently loaded mask. See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:AMASk:CREate" on page 405 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 416: Mtest:enable

    • OFF — Disables the mask test features. Query Syntax :MTESt:ENABle? The :MTESt:ENABle? query returns the current state of mask test features. Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :MTESt Commands" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 417: Mtest:lock

    Query Syntax :MTESt:LOCK? The :MTESt:LOCK? query returns the current mask lock setting. Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:SOURce" on page 431 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 418: Mtest:rmode

    <rmode> ::= {FOR | SIGM | TIME | WAV} See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:RMODe:SIGMa" on page 423 • ":MTESt:RMODe:TIME" on page 424 • ":MTESt:RMODe:WAVeforms" on page 425 Example Code • "Example Code" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 419: Mtest:rmode:faction:measure

    Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:RMODe:FACTion:PRINt" on page 420 • ":MTESt:RMODe:FACTion:SAVE" on page 421 • ":MTESt:RMODe:FACTion:STOP" on page 422 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 420: Mtest:rmode:faction:print

    Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:RMODe:FACTion:MEASure" on page 419 • ":MTESt:RMODe:FACTion:SAVE" on page 421 • ":MTESt:RMODe:FACTion:STOP" on page 422 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 421: Mtest:rmode:faction:save

    Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:RMODe:FACTion:MEASure" on page 419 • ":MTESt:RMODe:FACTion:PRINt" on page 420 • ":MTESt:RMODe:FACTion:STOP" on page 422 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 422: Mtest:rmode:faction:stop

    Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:RMODe:FACTion:MEASure" on page 419 • ":MTESt:RMODe:FACTion:PRINt" on page 420 • ":MTESt:RMODe:FACTion:SAVE" on page 421 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 423: Mtest:rmode:sigma

    Return Format <level><NL> <level> ::= from 0.1 to 9.3 in NR3 format See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:RMODe" on page 418 Example Code • "Example Code" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 424: Mtest:rmode:time

    The :MTESt:RMODe:TIME? query returns the number of seconds currently set. Return Format <seconds><NL> <seconds> ::= from 1 to 86400 in NR3 format See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:RMODe" on page 418 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 425: Mtest:rmode:waveforms

    The :MTESt:RMODe:WAVeforms? query returns the number of waveforms currently set. Return Format <count><NL> <count> ::= number of waveforms in NR1 format from 1 to 2,000,000,000 See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:RMODe" on page 418 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 426: Mtest:scale:bind

    <on_off> ::= {1 | 0} See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:SCALe:X1" on page 427 • ":MTESt:SCALe:XDELta" on page 428 • ":MTESt:SCALe:Y1" on page 429 • ":MTESt:SCALe:Y2" on page 430 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 427: Mtest:scale:x1

    <x1_value> ::= X1 value in NR3 format See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:SCALe:BIND" on page 426 • ":MTESt:SCALe:XDELta" on page 428 • ":MTESt:SCALe:Y1" on page 429 • ":MTESt:SCALe:Y2" on page 430 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 428: Mtest:scale:xdelta

    <xdelta_value> ::= X delta value in NR3 format See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:SCALe:BIND" on page 426 • ":MTESt:SCALe:X1" on page 427 • ":MTESt:SCALe:Y1" on page 429 • ":MTESt:SCALe:Y2" on page 430 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 429: Mtest:scale:y1

    <y1_value> ::= Y1 value in NR3 format See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:SCALe:BIND" on page 426 • ":MTESt:SCALe:X1" on page 427 • ":MTESt:SCALe:XDELta" on page 428 • ":MTESt:SCALe:Y2" on page 430 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 430: Mtest:scale:y2

    <y2_value> ::= Y2 value in NR3 format See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:SCALe:BIND" on page 426 • ":MTESt:SCALe:X1" on page 427 • ":MTESt:SCALe:XDELta" on page 428 • ":MTESt:SCALe:Y1" on page 429 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 431: Mtest:source

    Return Format <source><NL> <source> ::= {CHAN<n> | NONE} <n> ::= 1 to (# analog channels) in NR1 format See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:AMASk:SOURce" on page 406 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 432: Mtest:title

    The title is displayed in the mask test dialog box and mask test tab when a mask file is loaded. Return Format <title><NL> <title> ::= a string of up to 128 ASCII characters. See Also • "Introduction to :MTESt Commands" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 433: 22 :Recall Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 22 :RECall Commands Recall previously saved oscilloscope setups, reference waveforms, and masks. Table 67 :RECall Commands Summary Command Query Options and Query Returns :RECall:FILename :RECall:FILename? <base_name> ::= quoted ASCII page 435) <base_name> (see (see...
  • Page 434 Use :RECall? to query setup information for the RECall subsystem. Return Format The following is a sample response from the :RECall? query. In this case, the query was issued following the *RST command. :REC:FIL "scope_0" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 435: Recall:filename

    The :RECall:FILename? query returns the current RECall filename. Return Format <base_name><NL> <base_name> ::= quoted ASCII string See Also • "Introduction to :RECall Commands" on page 433 • ":RECall:SETup[:STARt]" on page 438 • ":SAVE:FILename" on page 444 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 436: Recall:mask[:Start]

    If a file extension is provided as part of a specified <file_name>, it must be ".msk". N OTE See Also • "Introduction to :RECall Commands" on page 433 • ":RECall:FILename" on page 435 • ":SAVE:MASK[:STARt]" on page 450 • ":MTESt:DATA" on page 414 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 437: Recall:pwd

    The :RECall:PWD? query returns the currently set working directory for recall operations. Return Format <path_name><NL> <path_name> ::= quoted ASCII string See Also • "Introduction to :RECall Commands" on page 433 • ":SAVE:PWD" on page 452 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 438: Recall:setup[:Start]

    If a file extension is provided as part of a specified <file_name>, it must be ".scp". N OTE See Also • "Introduction to :RECall Commands" on page 433 • ":RECall:FILename" on page 435 • ":SAVE:SETup[:STARt]" on page 453 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 439: Recall:wmemory[:Start]

    If a file extension is provided as part of a specified <file_name>, it must be ".h5". N OTE See Also • "Introduction to :RECall Commands" on page 433 • ":RECall:FILename" on page 435 • ":SAVE:WMEMory[:STARt]" on page 460 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 440 :RECall Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 441: 23 :Save Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 23 :SAVE Commands Save oscilloscope setups, screen images, and data. See "Introduction to :SAVE Commands" on page 442. Table 68 :SAVE Commands Summary Command Query Options and Query Returns :SAVE:FILename :SAVE:FILename? (see <base_name> ::= quoted ASCII...
  • Page 442 <file_name> ::= quoted ASCII [<file_name>] (see string page 460) If extension included in file name, it must be ".h5". Introduction to The :SAVE subsystem provides commands to save oscilloscope setups, screen :SAVE Commands images, and data. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 443 Return Format The following is a sample response from the :SAVE? query. In this case, the query was issued following the *RST command. :SAVE:FIL "";:SAVE:IMAG:AREA GRAT;FACT 0;FORM TIFF;INKS 0;PAL MON;:SAVE:PWD "C:/setups/";:SAVE:WAV:FORM NONE;LENG 1000;SEGM CURR Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 444: Save:filename

    See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:IMAGe[:STARt]" on page 445 • ":SAVE:SETup[:STARt]" on page 453 • ":SAVE:WAVeform[:STARt]" on page 454 • ":SAVE:PWD" on page 452 • ":RECall:FILename" on page 435 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 445: Save:image[:Start]

    See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:IMAGe:FACTors" on page 446 • ":SAVE:IMAGe:FORMat" on page 447 • ":SAVE:IMAGe:INKSaver" on page 448 • ":SAVE:IMAGe:PALette" on page 449 • ":SAVE:FILename" on page 444 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 446: Save:image:factors

    <factors> ::= {0 | 1} See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:IMAGe[:STARt]" on page 445 • ":SAVE:IMAGe:FORMat" on page 447 • ":SAVE:IMAGe:INKSaver" on page 448 • ":SAVE:IMAGe:PALette" on page 449 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 447: Save:image:format

    See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:IMAGe[:STARt]" on page 445 • ":SAVE:IMAGe:FACTors" on page 446 • ":SAVE:IMAGe:INKSaver" on page 448 • ":SAVE:IMAGe:PALette" on page 449 • ":SAVE:WAVeform:FORMat" on page 455 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 448: Save:image:inksaver

    <value> ::= {0 | 1} See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:IMAGe[:STARt]" on page 445 • ":SAVE:IMAGe:FACTors" on page 446 • ":SAVE:IMAGe:FORMat" on page 447 • ":SAVE:IMAGe:PALette" on page 449 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 449: Save:image:palette

    <palette> ::= {COL | GRAY} See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:IMAGe[:STARt]" on page 445 • ":SAVE:IMAGe:FACTors" on page 446 • ":SAVE:IMAGe:FORMat" on page 447 • ":SAVE:IMAGe:INKSaver" on page 448 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 450: Save:mask[:Start]

    If a file extension is provided as part of a specified <file_name>, it must be ".msk". N OTE See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:FILename" on page 444 • ":RECall:MASK[:STARt]" on page 436 • ":MTESt:DATA" on page 414 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 451: Save:multi[:Start]

    If a file extension is provided as part of a specified <file_name>, it must be ".h5". N OTE See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:FILename" on page 444 • ":SAVE:PWD" on page 452 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 452: Save:pwd

    The :SAVE:PWD? query returns the currently set working directory for save operations. Return Format <path_name><NL> <path_name> ::= quoted ASCII string See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:FILename" on page 444 • ":RECall:PWD" on page 437 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 453: Save:setup[:Start]

    If a file extension is provided as part of a specified <file_name>, it must be ".scp". N OTE See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:FILename" on page 444 • ":RECall:SETup[:STARt]" on page 438 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 454: Save:waveform[:Start]

    See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:WAVeform:FORMat" on page 455 • ":SAVE:WAVeform:LENGth" on page 456 • ":SAVE:FILename" on page 444 • ":RECall:SETup[:STARt]" on page 438 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 455: Save:waveform:format

    When NONE is returned, it indicates that an image file format is currently selected. See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:WAVeform[:STARt]" on page 454 • ":SAVE:WAVeform:LENGth" on page 456 • ":SAVE:IMAGe:FORMat" on page 447 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 456: Save:waveform:length

    <length> ::= 100 to max. length; an integer in NR1 format See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:WAVeform:LENGth:MAX" on page 457 • ":SAVE:WAVeform[:STARt]" on page 454 • ":WAVeform:POINts" on page 645 • ":SAVE:WAVeform:FORMat" on page 455 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 457: Save:waveform:length:max

    The :SAVE:WAVeform:LENGth:MAX? query returns the current setting. Return Format <setting><NL> <setting> ::= {0 | 1} See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:WAVeform[:STARt]" on page 454 • ":SAVE:WAVeform:LENGth" on page 456 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 458: Save:waveform:segmented

    Return Format <option><NL> <option> ::= {ALL | CURR} See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:WAVeform[:STARt]" on page 454 • ":SAVE:WAVeform:FORMat" on page 455 • ":SAVE:WAVeform:LENGth" on page 456 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 459: Save:wmemory:source

    Return Format <source><NL> <source> ::= {CHAN<n> | FUNC | WMEM<r> | NONE} See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:WMEMory[:STARt]" on page 460 • ":RECall:WMEMory<r>[:STARt]" on page 439 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 460: Save:wmemory[:Start]

    If a file extension is provided as part of a specified <file_name>, it must be ".h5". N OTE See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:WMEMory:SOURce" on page 459 • ":RECall:WMEMory<r>[:STARt]" on page 439 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 461: 24 :Sbus Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 24 :SBUS<n> Commands Control the modes and parameters for each serial bus decode/trigger type. See: • "Introduction to :SBUS<n> Commands" on page 461 • "General :SBUS<n> Commands" on page 463 • ":SBUS<n>:CAN Commands" on page 466 •...
  • Page 462 Return Format The following is a sample response from the :SBUS1? query. In this case, the query was issued following a *RST command. :SBUS1:DISP 0;MODE IIC;:SBUS1:IIC:ASIZ BIT7;:SBUS1:IIC:TRIG:TYPE STAR;QUAL EQU;:SBUS1:IIC:SOUR:CLOC CHAN1;DATA CHAN2;:SBUS1:IIC:TRIG:PATT:ADDR -1;DATA -1;DATA2 -1 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 463: General :Sbus Commands

    {0 | 1} page 464) | OFF} | {1 | ON}} (see page 464) (see :SBUS<n>:MODE <mode> :SBUS<n>:MODE? (see <mode> ::= {CAN | IIC | LIN | SPI page 465) page 465) (see | UART} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 464: Sbus:Display

    "-241, Hardware missing" on page 759 See Also • "Introduction to :SBUS<n> Commands" on page 461 • ":CHANnel<n>:DISPlay" on page 207 • ":VIEW" on page 165 • ":BLANk" on page 142 • ":STATus" on page 162 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 465: Sbus:Mode

    "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:CAN Commands" on page 466 • ":SBUS<n>:IIC Commands" on page 483 • ":SBUS<n>:LIN Commands" on page 493 • ":SBUS<n>:SPI Commands" on page 507 • ":SBUS<n>:UART Commands" on page 523 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 466: Sbus:Can Commands

    <string> ::= "nn...n" where n ::= PATTern:DATA <string> PATTern:DATA? (see {0 | 1 | X | $} page 479) page 479) (see <string ::= "0xnn...n" where n ::= {0,..,9 | A,..,F | X | $} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 467 481) page 481) (see <string ::= "0xnn...n" where n ::= {0,..,9 | A,..,F | X | $} :SBUS<n>:CAN:TRIGger: :SBUS<n>:CAN:TRIGger: <value> ::= {STANdard | EXTended} PATTern:ID:MODE PATTern:ID:MODE? (see page 482) page 482) <value> (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 468: Sbus:Can:count:error

    Errors • "-241, Hardware missing" on page 759 See Also • ":SBUS<n>:CAN:COUNt:RESet" on page 470 • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN Commands" on page 466 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 469: Sbus:Can:count:overload

    Errors • "-241, Hardware missing" on page 759 See Also • ":SBUS<n>:CAN:COUNt:RESet" on page 470 • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN Commands" on page 466 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 470: Sbus:Can:count:reset

    • ":SBUS<n>:CAN:COUNt:OVERload" on page 469 • ":SBUS<n>:CAN:COUNt:TOTal" on page 471 • ":SBUS<n>:CAN:COUNt:UTILization" on page 472 • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN Commands" on page 466 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 471: Sbus:Can:count:total

    Errors • "-241, Hardware missing" on page 759 See Also • ":SBUS<n>:CAN:COUNt:RESet" on page 470 • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN Commands" on page 466 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 472: Sbus:Can:count:utilization

    Errors • "-241, Hardware missing" on page 759 See Also • ":SBUS<n>:CAN:COUNt:RESet" on page 470 • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN Commands" on page 466 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 473: Sbus:Can:samplepoint

    <value> ::= {60 | 62.5 | 68 | 70 | 75 | 80 | 87.5} in NR3 format See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN:TRIGger" on page 477 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 474: Sbus:Can:signal:baudrate

    <baudrate> ::= integer from 10000 to 4000000 in 100 b/s increments, or 5000000 See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN:TRIGger" on page 477 • ":SBUS<n>:CAN:SIGNal:DEFinition" on page 475 • ":SBUS<n>:CAN:SOURce" on page 476 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 475: Sbus:Can:signal:definition

    <value> ::= {CANH | CANL | RX | TX | DIFL | DIFH} See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN:SIGNal:BAUDrate" on page 474 • ":SBUS<n>:CAN:SOURce" on page 476 • ":SBUS<n>:CAN:TRIGger" on page 477 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 476: Sbus:Can:source

    The :SBUS<n>:CAN:SOURce? query returns the current source for the CAN signal. Return Format <source><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN:TRIGger" on page 477 • ":SBUS<n>:CAN:SIGNal:DEFinition" on page 475 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 477: Sbus:Can:trigger

    IDEither ID - Remote or Data Frame ID IDRemote ID & RTR - Remote Frame ID (RTR) ALLerrors All Errors - All Errors OVERload Overload - Overload Frame ACKerror Ack Error - Acknowledge Error Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 478 ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN:TRIGger:PATTern:DATA" on page 479 • ":SBUS<n>:CAN:TRIGger:PATTern:DATA:LENGth" on page 480 • ":SBUS<n>:CAN:TRIGger:PATTern:ID" on page 481 • ":SBUS<n>:CAN:TRIGger:PATTern:ID:MODE" on page 482 • ":SBUS<n>:CAN:SIGNal:DEFinition" on page 475 • ":SBUS<n>:CAN:SOURce" on page 476 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 479: Sbus:Can:trigger:pattern:data

    Return Format <string><NL> in nondecimal format Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:CAN:TRIGger:PATTern:DATA:LENGth" on page 480 • ":SBUS<n>:CAN:TRIGger:PATTern:ID" on page 481 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 480: Sbus:Can:trigger:pattern:data:length

    <count> ::= integer from 1 to 8 in NR1 format Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:CAN:TRIGger:PATTern:DATA" on page 479 • ":SBUS<n>:CAN:SOURce" on page 476 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 481: Sbus:Can:trigger:pattern:id

    <string><NL> in 29-bit binary string format Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:CAN:TRIGger:PATTern:ID:MODE" on page 482 • ":SBUS<n>:CAN:TRIGger:PATTern:DATA" on page 479 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 482: Sbus:Can:trigger:pattern:id:mode

    "-241, Hardware missing" on page 759 See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:CAN:TRIGger:PATTern:DATA" on page 479 • ":SBUS<n>:CAN:TRIGger:PATTern:DATA:LENGth" on page 480 • ":SBUS<n>:CAN:TRIGger:PATTern:ID" on page 481 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 483: Sbus:Iic Commands

    :SBUS<n>:IIC:TRIGger[ :SBUS<n>:IIC:TRIGger[ <type> ::= {STARt | STOP | READ7 page 491) :TYPE] <type> (see :TYPE]? (see | READEprom | WRITe7 | WRITe10 | page 491) NACKnowledge | ANACk | R7Data2 | W7Data2 | RESTart} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 484: Sbus:Iic:asize

    The :SBUS<n>:IIC:ASIZe? query returns the current IIC address width setting. Return Format <mode><NL> <mode> ::= {BIT7 | BIT8} Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:IIC Commands" on page 483 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 485: Sbus:Iic[:Source]:Clock

    (SCL). Query Syntax :SBUS<n>:IIC[:SOURce]:CLOCk? The :SBUS<n>:IIC[:SOURce]:CLOCk? query returns the current source for the IIC serial clock. Return Format <source><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:IIC[:SOURce]:DATA" on page 486 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 486: Sbus:Iic[:Source]:Data

    The :SBUS<n>:IIC[:SOURce]:DATA command sets the source for IIC serial data (SDA). Query Syntax :SBUS<n>:IIC[:SOURce]:DATA? The :SBUS<n>:IIC[:SOURce]:DATA? query returns the current source for IIC serial data. Return Format <source><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:IIC[:SOURce]:CLOCk" on page 485 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 487: Sbus:Iic:trigger:pattern:address

    IIC data. Return Format <value><NL> <value> ::= integer See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:IIC:TRIGger:PATTern:DATA" on page 488 • ":SBUS<n>:IIC:TRIGger:PATTern:DATa2" on page 489 • ":SBUS<n>:IIC:TRIGger[:TYPE]" on page 491 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 488: Sbus:Iic:trigger:pattern:data

    The :SBUS<n>:IIC:TRIGger:PATTern:DATA? query returns the current pattern for IIC data. Return Format <value><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:IIC:TRIGger:PATTern:ADDRess" on page 487 • ":SBUS<n>:IIC:TRIGger:PATTern:DATa2" on page 489 • ":SBUS<n>:IIC:TRIGger[:TYPE]" on page 491 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 489: Sbus:Iic:trigger:pattern:data2

    The :SBUS<n>:IIC:TRIGger:PATTern:DATa2? query returns the current pattern for IIC data 2. Return Format <value><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:IIC:TRIGger:PATTern:ADDRess" on page 487 • ":SBUS<n>:IIC:TRIGger:PATTern:DATA" on page 488 • ":SBUS<n>:IIC:TRIGger[:TYPE]" on page 491 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 490: Sbus:Iic:trigger:qualifier

    The :SBUS<n>:IIC:TRIGger:QUALifier? query returns the current IIC data qualifier value. Return Format <value><NL> <value> ::= {EQUal | NOTequal | LESSthan | GREaterthan} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:IIC:TRIGger[:TYPE]" on page 491 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 491: Sbus:Iic:trigger[:Type]

    <value> ::= {STAR | STOP | READ7 | READE | WRIT7 | WRIT10 | NACK | ANAC | R7D2 | W7D2 | REST} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:IIC:TRIGger:PATTern:ADDRess" on page 487 • ":SBUS<n>:IIC:TRIGger:PATTern:DATA" on page 488 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 492 :SBUS<n> Commands • ":SBUS<n>:IIC:TRIGger:PATTern:DATa2" on page 489 • ":SBUS<n>:IIC:TRIGger:QUALifier" on page 490 • "Long Form to Short Form Truncation Rules" on page 800 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 493: Sbus:Lin Commands

    <string> from 0-63 or 0x00-0x3f <nondecimal> ::= #Hnn where n ::= {0,..,9 | A,..,F} for hexadecimal <nondecimal> ::= #Bnn...n where n ::= {0 | 1} for binary <string> ::= "0xnn" where n ::= {0,..,9 | A,..,F} for hexadecimal Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 494 <length> ::= integer from 1 to 8 PATTern:DATA:LENGth PATTern:DATA:LENGth? in NR1 format page 505) <length> (see (see page 505) :SBUS<n>:LIN:TRIGger: :SBUS<n>:LIN:TRIGger: <base> ::= {BINary | HEX | PATTern:FORMat <base> PATTern:FORMat? (see DECimal} page 506) page 506) (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 495: Sbus:Lin:parity

    Return Format <display><NL> <display> ::= {0 | 1} Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:LIN Commands" on page 493 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 496: Sbus:Lin:samplepoint

    <value> ::= {60 | 62.5 | 68 | 70 | 75 | 80 | 87.5} in NR3 format See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:LIN:TRIGger" on page 501 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 497: Sbus:Lin:signal:baudrate

    <baudrate> ::= integer from 2400 to 625000 in 100 b/s increments See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:LIN:TRIGger" on page 501 • ":SBUS<n>:LIN:SOURce" on page 498 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 498: Sbus:Lin:source

    The :SBUS<n>:LIN:SOURce? query returns the current source for the LIN signal. Return Format <source><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:LIN:TRIGger" on page 501 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 499: Sbus:Lin:standard

    The :SBUS<n>:LIN:STANdard? query returns the current LIN standard setting. Return Format <std><NL> <std> ::= {LIN13 | LIN20} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:LIN:SOURce" on page 498 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 500: Sbus:Lin:syncbreak

    The :SBUS<n>:LIN:SYNCbreak? query returns the current LIN sync break setting. Return Format <value><NL> <value> ::= {11 | 12 | 13} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:LIN:SOURce" on page 498 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 501: Sbus:Lin:trigger

    See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:LIN:TRIGger:ID" on page 502 • ":SBUS<n>:LIN:TRIGger:PATTern:DATA:LENGth" on page 505 • ":SBUS<n>:LIN:TRIGger:PATTern:DATA" on page 503 • ":SBUS<n>:LIN:SOURce" on page 498 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 502: Sbus:Lin:trigger:id

    <value> ::= integer in decimal Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:LIN:TRIGger" on page 501 • ":SBUS<n>:LIN:SOURce" on page 498 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 503: Sbus:Lin:trigger:pattern:data

    Query Syntax :SBUS<n>:LIN:TRIGger:PATTern:DATA? The :SBUS<n>:LIN:TRIGger:PATTern:DATA? query returns the currently specified LIN trigger data pattern. Return Format <string><NL> Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 504 :SBUS<n> Commands See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:LIN:TRIGger:PATTern:FORMat" on page 506 • ":SBUS<n>:LIN:TRIGger" on page 501 • ":SBUS<n>:LIN:TRIGger:PATTern:DATA:LENGth" on page 505 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 505: Sbus:Lin:trigger:pattern:data:length

    <count> ::= integer from 1 to 8 in NR1 format Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:LIN:TRIGger:PATTern:DATA" on page 503 • ":SBUS<n>:LIN:SOURce" on page 498 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 506: Sbus:Lin:trigger:pattern:format

    LIN pattern data. Return Format <base><NL> <base> ::= {BIN | HEX | DEC} See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:LIN:TRIGger:PATTern:DATA" on page 503 • ":SBUS<n>:LIN:TRIGger:PATTern:DATA:LENGth" on page 505 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 507: Sbus:Spi Commands

    <string ::= "0xnn...n" where n page 517) ::= {0,..,9 | A,..,F | X | $} :SBUS<n>:SPI:TRIGger: :SBUS<n>:SPI:TRIGger: <width> ::= integer from 4 to 64 PATTern:MISO:WIDTh PATTern:MISO:WIDTh? in NR1 format page 518) page 518) <width> (see (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 508 <width> (see (see :SBUS<n>:SPI:TRIGger: :SBUS<n>:SPI:TRIGger: <value> ::= {MOSI | MISO} page 521) TYPE <value> (see TYPE? (see page 521) :SBUS<n>:SPI:WIDTh :SBUS<n>:SPI:WIDTh? <word_width> ::= integer 4-16 in page 522) <word_width> (see (see NR1 format page 522) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 509: Sbus:Spi:bitorder

    <order> ::= {LSBF | MSBF} Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:SPI Commands" on page 507 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 510: Sbus:Spi:clock:slope

    The :SBUS<n>:SPI:CLOCk:SLOPe? query returns the current SPI clock source slope. Return Format <slope><NL> <slope> ::= {NEG | POS} See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:SPI:CLOCk:TIMeout" on page 511 • ":SBUS<n>:SPI:SOURce:CLOCk" on page 513 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 511: Sbus:Spi:clock:timeout

    <time value><NL> <time_value> ::= time in seconds in NR3 format See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:SPI:CLOCk:SLOPe" on page 510 • ":SBUS<n>:SPI:SOURce:CLOCk" on page 513 • ":SBUS<n>:SPI:FRAMing" on page 512 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 512: Sbus:Spi:framing

    Return Format <value><NL> <value> ::= {CHIP | NCH | TIM} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:SPI:CLOCk:TIMeout" on page 511 • ":SBUS<n>:SPI:SOURce:FRAMe" on page 514 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 513: Sbus:Spi:source:clock

    See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:SPI:CLOCk:SLOPe" on page 510 • ":SBUS<n>:SPI:CLOCk:TIMeout" on page 511 • ":SBUS<n>:SPI:SOURce:FRAMe" on page 514 • ":SBUS<n>:SPI:SOURce:MOSI" on page 516 • ":SBUS<n>:SPI:SOURce:MISO" on page 515 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 514: Sbus:Spi:source:frame

    SPI serial frame. Return Format <source><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:SPI:SOURce:CLOCk" on page 513 • ":SBUS<n>:SPI:SOURce:MOSI" on page 516 • ":SBUS<n>:SPI:SOURce:MISO" on page 515 • ":SBUS<n>:SPI:FRAMing" on page 512 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 515: Sbus:Spi:source:miso

    ":SBUS<n>:SPI:SOURce:MOSI" on page 516 • ":SBUS<n>:SPI:SOURce:CLOCk" on page 513 • ":SBUS<n>:SPI:SOURce:FRAMe" on page 514 • ":SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA" on page 517 • ":SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA" on page 519 • ":SBUS<n>:SPI:TRIGger:PATTern:MISO:WIDTh" on page 518 • ":SBUS<n>:SPI:TRIGger:PATTern:MOSI:WIDTh" on page 520 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 516: Sbus:Spi:source:mosi

    ":SBUS<n>:SPI:SOURce:MISO" on page 515 • ":SBUS<n>:SPI:SOURce:CLOCk" on page 513 • ":SBUS<n>:SPI:SOURce:FRAMe" on page 514 • ":SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA" on page 517 • ":SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA" on page 519 • ":SBUS<n>:SPI:TRIGger:PATTern:MISO:WIDTh" on page 518 • ":SBUS<n>:SPI:TRIGger:PATTern:MOSI:WIDTh" on page 520 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 517: Sbus:Spi:trigger:pattern:miso:data

    SPI data pattern resource in the binary string format. Return Format <string><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:SPI:TRIGger:PATTern:MISO:WIDTh" on page 518 • ":SBUS<n>:SPI:SOURce:MISO" on page 515 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 518: Sbus:Spi:trigger:pattern:miso:width

    Return Format <width><NL> <width> ::= integer from 4 to 64 in NR1 format See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA" on page 517 • ":SBUS<n>:SPI:SOURce:MISO" on page 515 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 519: Sbus:Spi:trigger:pattern:mosi:data

    SPI data pattern resource in the binary string format. Return Format <string><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:SPI:TRIGger:PATTern:MOSI:WIDTh" on page 520 • ":SBUS<n>:SPI:SOURce:MOSI" on page 516 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 520: Sbus:Spi:trigger:pattern:mosi:width

    Return Format <width><NL> <width> ::= integer from 4 to 64 in NR1 format See Also • "Introduction to :TRIGger Commands" on page 585 • ":SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA" on page 519 • ":SBUS<n>:SPI:SOURce:MOSI" on page 516 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 521: Sbus:Spi:trigger:type

    ":SBUS<n>:SPI:SOURce:MOSI" on page 516 • ":SBUS<n>:SPI:SOURce:MISO" on page 515 • ":SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA" on page 517 • ":SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA" on page 519 • ":SBUS<n>:SPI:TRIGger:PATTern:MISO:WIDTh" on page 518 • ":SBUS<n>:SPI:TRIGger:PATTern:MOSI:WIDTh" on page 520 • ":TRIGger:MODE" on page 594 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 522: Sbus:Spi:width

    <word_width> ::= integer 4-16 in NR1 format Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:SPI Commands" on page 507 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 523: Sbus:Uart Commands

    ::= {0 | 1} for binary :SBUS<n>:UART:PARity :SBUS<n>:UART:PARity? <parity> ::= {EVEN | ODD | NONE} page 533) <parity> (see (see page 533) :SBUS<n>:UART:POLarit :SBUS<n>:UART:POLarit <polarity> ::= {HIGH | LOW} page 534) y <polarity> (see y? (see page 534) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 524 542) PARityerror | TSTArt | TSTOp | TDATa | TD1 | TD0 | TDX} :SBUS<n>:UART:WIDTh :SBUS<n>:UART:WIDTh? <width> ::= {5 | 6 | 7 | 8 | 9} page 543) page 543) <width> (see (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 525: Sbus:Uart:base

    Return Format <base><NL> <base> ::= {ASCii | BINary | HEX} Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:UART Commands" on page 523 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 526: Sbus:Uart:baudrate

    The :SBUS<n>:UART:BAUDrate? query returns the current UART baud rate setting. Return Format <baudrate><NL> <baudrate> ::= integer from 100 to 8000000 See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 527: Sbus:Uart:bitorder

    <bitorder> ::= {LSBF | MSBF} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 • ":SBUS<n>:UART:SOURce:RX" on page 535 • ":SBUS<n>:UART:SOURce:TX" on page 536 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 528: Sbus:Uart:count:error

    Errors • "-241, Hardware missing" on page 759 See Also • ":SBUS<n>:UART:COUNt:RESet" on page 529 • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:UART Commands" on page 523 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 529: Sbus:Uart:count:reset

    • ":SBUS<n>:UART:COUNt:ERRor" on page 528 • ":SBUS<n>:UART:COUNt:RXFRames" on page 530 • ":SBUS<n>:UART:COUNt:TXFRames" on page 531 • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:UART Commands" on page 523 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 530: Sbus:Uart:count:rxframes

    Errors • "-241, Hardware missing" on page 759 See Also • ":SBUS<n>:UART:COUNt:RESet" on page 529 • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:UART Commands" on page 523 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 531: Sbus:Uart:count:txframes

    Errors • "-241, Hardware missing" on page 759 See Also • ":SBUS<n>:UART:COUNt:RESet" on page 529 • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:MODE" on page 465 • ":SBUS<n>:UART Commands" on page 523 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 532: Sbus:Uart:framing

    <value> ::= {OFF | <decimal>} <decimal> ::= 8-bit integer in decimal from 0-255 Errors • "-241, Hardware missing" on page 759 See Also • "Introduction to :SBUS<n> Commands" on page 461 • ":SBUS<n>:UART Commands" on page 523 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 533: Sbus:Uart:parity

    The :SBUS<n>:UART:PARity? query returns the current UART parity setting. Return Format <parity><NL> <parity> ::= {EVEN | ODD | NONE} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 534: Sbus:Uart:polarity

    The :SBUS<n>:UART:POLarity? query returns the current UART polarity setting. Return Format <polarity><NL> <polarity> ::= {HIGH | LOW} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 535: Sbus:Uart:source:rx

    The :SBUS<n>:UART:SOURce:RX? query returns the current source for the UART Rx signal. Return Format <source><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 • ":SBUS<n>:UART:BITorder" on page 527 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 536: Sbus:Uart:source:tx

    The :SBUS<n>:UART:SOURce:TX? query returns the current source for the UART Tx signal. Return Format <source><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 • ":SBUS<n>:UART:BITorder" on page 527 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 537: Sbus:Uart:trigger:base

    The :SBUS<n>:UART:TRIGger:BASE? query returns the current UART base setting. Return Format <base><NL> <base> ::= {ASC | HEX} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:DATA" on page 539 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 538: Sbus:Uart:trigger:burst

    <value> ::= {OFF | 1 to 4096 in NR1 format} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:IDLE" on page 540 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 539: Sbus:Uart:trigger:data

    <value><NL> <value> ::= 8-bit integer in decimal from 0-255 See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:BASE" on page 537 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 540: Sbus:Uart:trigger:idle

    <time_value> ::= time from 1 us to 10 s in NR3 format See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:BURSt" on page 538 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 541: Sbus:Uart:trigger:qualifier

    The :SBUS<n>:UART:TRIGger:QUALifier? query returns the current UART trigger qualifier. Return Format <value><NL> <value> ::= {EQU | NOT | GRE | LESS} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 542: Sbus:Uart:trigger:type

    TSTO | TDAT | TD1 | TD0 | TDX} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:DATA" on page 539 • ":SBUS<n>:UART:TRIGger:QUALifier" on page 541 • ":SBUS<n>:UART:WIDTh" on page 543 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 543: Sbus:Uart:width

    Return Format <width><NL> <width> ::= {5 | 6 | 7 | 8 | 9} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":SBUS<n>:UART:TRIGger:TYPE" on page 542 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 544 :SBUS<n> Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 545: 25 :System Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 25 :SYSTem Commands Control basic system functions of the oscilloscope. See "Introduction to :SYSTem Commands" on page 547. Table 75 :SYSTem Commands Summary Command Query Options and Query Returns :SYSTem:DATE <date> :SYSTem:DATE? (see <date> ::= <year>,<month>,<day>...
  • Page 546 488.2 # format. page 567) :SYSTem:TIME <time> :SYSTem:TIME? (see <time> ::= hours,minutes,seconds page 569) page 569) (see in NR1 format :SYSTem:USB:EJECt <usb_path> ::= path of USB [<usb_path>] (see storage device page 570) :SYSTem:USB:PLISt? page 571) (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 547 :SYSTem Commands Introduction to SYSTem subsystem commands enable writing messages to the display, setting :SYSTem and reading both the time and the date, querying for errors, and saving and Commands recalling setups. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 548: System:date

    The :SYSTem:DATE command sets the date. Validity checking is performed to ensure that the date is valid. Query Syntax :SYSTem:DATE? The SYSTem:DATE? query returns the date. Return Format <year>,<month>,<day><NL> See Also • "Introduction to :SYSTem Commands" on page 547 • ":SYSTem:TIME" on page 569 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 549: System:didentifier

    Use the *IDN? query instead to get the model number and/or serial number in a defined portable format. Return Format <host_id><NL> <host_id> ::= quoted ASCII string See Also • "*IDN (Identification Number)" on page 116 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 550: System:dsp

    (Two sets of quote marks without a space between them creates a NULL string.) Press any menu key to manually remove the message from the display. See Also • "Introduction to :SYSTem Commands" on page 547 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 551: System:error

    Chapter 32, “Error Messages,” starting on page 757. See Also • "Introduction to :SYSTem Commands" on page 547 • "*ESR (Standard Event Status Register)" on page 114 • "*CLS (Clear Status)" on page 111 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 552: System:lock

    Query Syntax :SYSTem:LOCK? The :SYSTem:LOCK? query returns the lock status of the front panel. Return Format <value><NL> <value> ::= {1 | 0} See Also • "Introduction to :SYSTem Commands" on page 547 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 553: System:menu

    :SYSTem Commands :SYSTem:MENU (see page 798) Command Syntax :SYSTem:MENU <menu> <menu> ::= {MASK | MEASure | SEGMented} The :SYSTem:MENU command changes the front panel softkey menu. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 554: System:persona[:Manufacturer]

    *IDN? query. The default manufacturer string is "KEYSIGHT TECHNOLOGIES". If your remote programs depend on a legacy manufacturer string, for example, you could use this command to set the manufacturer string to "AGILENT TECHNOLOGIES".

  • Page 555: System:persona[:Manufacturer]:Default

    Command Syntax :SYSTem:PERSona[:MANufacturer]:DEFault The :SYSTem:PERSona[:MANufacturer]:DEFault command sets the manufacturer string to "KEYSIGHT TECHNOLOGIES". See Also • "*IDN (Identification Number)" on page 116 • ":SYSTem:PERSona[:MANufacturer]" on page 554 • "Introduction to :SYSTem Commands" on page 547 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 556: System:preset

    Analog Channel Menu Channel 1 Channel 2 Volts/division 5.00 V Offset 0.00 Coupling Probe attenuation 10:1 Vernier Invert BW limit Impedance 1 M Ohm (cannot be changed) Units Volts Skew Cursor Menu Source Channel 1 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 557 Mode Auto Coupling Source Channel 1 Level 0.0 V Slope Positive HF Reject and noise reject Holdoff 60 ns External probe attenuation 10:1 External Units Volts External Impedance 1 M Ohm (cannot be changed) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 558 :SYSTem Commands See Also • "Introduction to Common (*) Commands" on page 109 • "*RST (Reset)" on page 121 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 559: System:protection:lock

    Query Syntax :SYSTem:PROTection:LOCK? The :SYSTem:PROTection:LOCK? query returns the analog channel protection lock status. Return Format <value><NL> <value> ::= {1 | 0} See Also • "Introduction to :SYSTem Commands" on page 547 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 560: System:rlogger

    See Also • ":SYSTem:RLOGger:DESTination" on page 561 • ":SYSTem:RLOGger:DISPlay" on page 562 • ":SYSTem:RLOGger:FNAMe" on page 563 • ":SYSTem:RLOGger:STATe" on page 564 • ":SYSTem:RLOGger:TRANsparent" on page 565 • ":SYSTem:RLOGger:WMODe" on page 566 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 561: System:rlogger:destination

    <dest> ::= {FILE | SCR | BOTH} See Also • ":SYSTem:RLOGger" on page 560 • ":SYSTem:RLOGger:DISPlay" on page 562 • ":SYSTem:RLOGger:FNAMe" on page 563 • ":SYSTem:RLOGger:STATe" on page 564 • ":SYSTem:RLOGger:TRANsparent" on page 565 • ":SYSTem:RLOGger:WMODe" on page 566 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 562: System:rlogger:display

    <setting> ::= {0 | 1} See Also • ":SYSTem:RLOGger" on page 560 • ":SYSTem:RLOGger:DESTination" on page 561 • ":SYSTem:RLOGger:FNAMe" on page 563 • ":SYSTem:RLOGger:STATe" on page 564 • ":SYSTem:RLOGger:TRANsparent" on page 565 • ":SYSTem:RLOGger:WMODe" on page 566 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 563: System:rlogger:fname

    Return Format <file_name><NL> See Also • ":SYSTem:RLOGger" on page 560 • ":SYSTem:RLOGger:DESTination" on page 561 • ":SYSTem:RLOGger:DISPlay" on page 562 • ":SYSTem:RLOGger:STATe" on page 564 • ":SYSTem:RLOGger:TRANsparent" on page 565 • ":SYSTem:RLOGger:WMODe" on page 566 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 564: System:rlogger:state

    <setting> ::= {0 | 1} See Also • ":SYSTem:RLOGger" on page 560 • ":SYSTem:RLOGger:DESTination" on page 561 • ":SYSTem:RLOGger:DISPlay" on page 562 • ":SYSTem:RLOGger:FNAMe" on page 563 • ":SYSTem:RLOGger:TRANsparent" on page 565 • ":SYSTem:RLOGger:WMODe" on page 566 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 565: System:rlogger:transparent

    <setting> ::= {0 | 1} See Also • ":SYSTem:RLOGger" on page 560 • ":SYSTem:RLOGger:DESTination" on page 561 • ":SYSTem:RLOGger:DISPlay" on page 562 • ":SYSTem:RLOGger:FNAMe" on page 563 • ":SYSTem:RLOGger:STATe" on page 564 • ":SYSTem:RLOGger:WMODe" on page 566 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 566: System:rlogger:wmode

    <write_mode> ::= {CRE | APP} See Also • ":SYSTem:RLOGger" on page 560 • ":SYSTem:RLOGger:DESTination" on page 561 • ":SYSTem:RLOGger:DISPlay" on page 562 • ":SYSTem:RLOGger:FNAMe" on page 563 • ":SYSTem:RLOGger:STATe" on page 564 • ":SYSTem:RLOGger:TRANsparent" on page 565 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 567: System:setup

    ' write it back to the oscilloscope. Dim varSetupString As Variant strPath = "c:\scope\config\setup.dat" ' Open file for input. Open strPath For Binary Access Read As #1 Get #1, , varSetupString ' Read data. Close #1 ' Close file. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 568 :SYSTem Commands ' Write setup string back to oscilloscope using ":SYSTEM:SETUP" ' command: myScope.WriteIEEEBlock ":SYSTEM:SETUP ", varSetupString CheckForInstrumentErrors See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 569: System:time

    :SYSTem:TIME? <time> The :SYSTem:TIME? query returns the current system time. Return Format <time><NL> <time> ::= hours,minutes,seconds in NR1 format See Also • "Introduction to :SYSTem Commands" on page 547 • ":SYSTem:DATE" on page 548 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 570: System:usb:eject

    When the ALL parameter is given, the command will dismount/eject all connected USB storage devices. The paths of connected USB storage devices are returned by the :SYSTem:USB:PLISt? query. See Also • ":SYSTem:USB:PLISt" on page 571 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 571: System:usb:plist

    The :SYSTem:USB:PLISt? query returns the root path for all connected USB storage devices, delimited by a newline character ("\n"). Return Format <string><NL> <string> ::= a string of up to 256 ASCII characters. See Also • ":SYSTem:USB:EJECt" on page 570 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 572 :SYSTem Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 573: 26 :Timebase Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 26 :TIMebase Commands Control all horizontal sweep functions. See "Introduction to :TIMebase Commands" on page 574. Table 76 :TIMebase Commands Summary Command Query Options and Query Returns :TIMebase:MODE :TIMebase:MODE? (see <value> ::= {MAIN | WINDow | XY |...
  • Page 574 Use :TIMebase? to query setup information for the TIMebase subsystem. Return Format The following is a sample response from the :TIMebase? query. In this case, the query was issued following a *RST command. :TIM:MODE MAIN;REF CENT;MAIN:RANG +1.00E-03;POS +0.0E+00 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 575: Timebase:mode

    ' Set the time base mode to MAIN, DELAYED, XY, or ROLL. ' Set time base mode to main. myScope.WriteString ":TIMEBASE:MODE MAIN" See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 576: Timebase:position

    See Also • "Introduction to :TIMebase Commands" on page 574 • ":TIMebase:REFerence" on page 578 • ":TIMebase:RANGe" on page 577 • ":TIMebase:SCALe" on page 579 • ":TIMebase:WINDow:POSition" on page 581 • ":TIMebase:DELay" on page 755 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 577: Timebase:range

    ' range value is 10 times the time per division. myScope.WriteString ":TIM:RANG 2e-3" ' Set the time range to 0.002 seconds. See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 578: Timebase:reference

    - CENTer sets the display reference to the center of the screen. - RIGHt sets the display reference one time division from the righ myScope.WriteString ":TIMebase:REFerence CENTer" ' Set reference to center. See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 579: Timebase:scale

    <scale_value><NL> <scale_value> ::= time/div in seconds in NR3 format See Also • "Introduction to :TIMebase Commands" on page 574 • ":TIMebase:RANGe" on page 577 • ":TIMebase:WINDow:SCALe" on page 583 • ":TIMebase:WINDow:RANGe" on page 582 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 580: Timebase:vernier

    The :TIMebase:VERNier? query returns the current state of the time base control's vernier setting. Return Format <vernier value><NL> <vernier value> ::= {0 | 1} See Also • "Introduction to :TIMebase Commands" on page 574 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 581: Timebase:window:position

    "Introduction to :TIMebase Commands" on page 574 • ":TIMebase:MODE" on page 575 • ":TIMebase:POSition" on page 576 • ":TIMebase:RANGe" on page 577 • ":TIMebase:SCALe" on page 579 • ":TIMebase:WINDow:RANGe" on page 582 • ":TIMebase:WINDow:SCALe" on page 583 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 582: Timebase:window:range

    Return Format <value><NL> <value> ::= range value in seconds See Also • "Introduction to :TIMebase Commands" on page 574 • ":TIMebase:RANGe" on page 577 • ":TIMebase:POSition" on page 576 • ":TIMebase:SCALe" on page 579 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 583: Timebase:window:scale

    <scale_value> ::= current seconds per division for the zoomed window See Also • "Introduction to :TIMebase Commands" on page 574 • ":TIMebase:RANGe" on page 577 • ":TIMebase:POSition" on page 576 • ":TIMebase:SCALe" on page 579 • ":TIMebase:WINDow:RANGe" on page 582 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 584 :TIMebase Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 585: 27 :Trigger Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 27 :TRIGger Commands Control the trigger modes and parameters for each trigger type. See: • "Introduction to :TRIGger Commands" on page 585 • "General :TRIGger Commands" on page 587 • ":TRIGger[:EDGE] Commands" on page 597 •...
  • Page 586 The return format for the TRIGger? query varies depending on the current mode. The following is a sample response from the :TRIGger? query. In this case, the query was issued following a *RST command. :TRIG:MODE EDGE;SWE AUTO;NREJ 0;HFR 0;HOLD +60.0000000000000E-09; :TRIG:EDGE:SOUR CHAN1;LEV +0.00000E+00;SLOP POS;REJ OFF;COUP DC Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 587: General :Trigger Commands

    :TIMebase:MODE is ROLL or :TRIGger:NREJect {{0 :TRIGger:NREJect? {0 | 1} page 595) | OFF} | {1 | ON}} (see page 595) (see :TRIGger:SWEep :TRIGger:SWEep? (see <sweep> ::= {AUTO | NORMal} page 596) page 596) <sweep> (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 588: Trigger:force

    The :TRIGger:FORCe command causes an acquisition to be captured even though the trigger condition has not been met. This command is equivalent to the front panel [Force Trigger] key. See Also • "Introduction to :TRIGger Commands" on page 585 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 589: Trigger:hfreject

    The :TRIGger:HFReject? query returns the current high frequency reject filter mode. Return Format <value><NL> <value> ::= {0 | 1} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger[:EDGE]:REJect" on page 600 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 590: Trigger:holdoff

    The :TRIGger:HOLDoff? query returns the holdoff time value for the current trigger mode. Return Format <holdoff_time><NL> <holdoff_time> ::= the holdoff time value in seconds in NR3 format. See Also • "Introduction to :TRIGger Commands" on page 585 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 591: Trigger:level:asetup

    If AC coupling is used, the trigger levels are set to 0 V. When High and Low (dual) trigger levels are used (as with Rise/Fall Time and Runt triggers, for example), this command has no effect. See Also • ":TRIGger[:EDGE]:LEVel" on page 599 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 592: Trigger:level:high

    The :TRIGger:LEVel:HIGH? query returns the high trigger voltage level for the specified source. Return Format <level><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:LEVel:LOW" on page 593 • ":TRIGger[:EDGE]:SOURce" on page 602 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 593: Trigger:level:low

    The :TRIGger:LEVel:LOW? query returns the low trigger voltage level for the specified source. Return Format <level><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:LEVel:HIGH" on page 592 • ":TRIGger[:EDGE]:SOURce" on page 602 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 594: Trigger:mode

    596 • ":TIMebase:MODE" on page 575 Example Code ' TRIGGER_MODE - Set the trigger mode to EDGE. myScope.WriteString ":TRIGger:MODE EDGE" See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 595: Trigger:nreject

    TV trigger mode. Query Syntax :TRIGger:NREJect? The :TRIGger:NREJect? query returns the current noise reject filter mode. Return Format <value><NL> <value> ::= {0 | 1} See Also • "Introduction to :TRIGger Commands" on page 585 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 596: Trigger:sweep

    This feature is called "Mode" on the instrument's front panel. N OTE Query Syntax :TRIGger:SWEep? The :TRIGger:SWEep? query returns the current trigger sweep mode. Return Format <sweep><NL> <sweep> ::= current trigger sweep mode See Also • "Introduction to :TRIGger Commands" on page 585 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 597: Trigger[:Edge] Commands

    NEGative | EITHer | ALTernate} page 601) :TRIGger[:EDGE]:SOURc :TRIGger[:EDGE]:SOURc <source> ::= {CHANnel<n> | page 602) e <source> (see e? (see EXTernal | LINE | WGEN} page 602) <n> ::= 1 to (# analog channels) in NR1 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 598: Trigger[:Edge]:Coupling

    The :TRIGger[:EDGE]:COUPling? query returns the current coupling selection. Return Format <coupling><NL> <coupling> ::= {AC | DC | LFR} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":TRIGger[:EDGE]:REJect" on page 600 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 599: Trigger[:Edge]:Level

    The :TRIGger[:EDGE]:LEVel? query returns the trigger level of the current trigger source. Return Format <level><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger[:EDGE]:SOURce" on page 602 • ":EXTernal:RANGe" on page 257 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 600: Trigger[:Edge]:Reject

    The :TRIGger[:EDGE]:REJect? query returns the current status of the reject filter. Return Format <reject><NL> <reject> ::= {OFF | LFR | HFR} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:HFReject" on page 589 • ":TRIGger[:EDGE]:COUPling" on page 598 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 601: Trigger[:Edge]:Slope

    ' TRIGGER_EDGE_SLOPE - Sets the slope of the edge for the trigger. ' Set the slope to positive. myScope.WriteString ":TRIGGER:EDGE:SLOPE POSITIVE" See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 602: Trigger[:Edge]:Source

    ' TRIGGER_EDGE_SOURCE - Selects the channel that actually produces th ' edge trigger. Any channel can be selected. myScope.WriteString ":TRIGger:EDGE:SOURce CHANnel1" See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 603: Trigger:glitch Commands

    [suffix] ::= {s | ms | us | ns | :TRIGger:GLITch:SOURc :TRIGger:GLITch:SOURc <source> ::= {CHANnel<n>} page 610) e <source> (see e? (see <n> ::= 1 to (# analog channels) page 610) in NR1 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 604: Trigger:glitch:greaterthan

    Return Format <greater_than_time><NL> <greater_than_time> ::= floating-point number in NR3 format. See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:GLITch:SOURce" on page 610 • ":TRIGger:GLITch:QUALifier" on page 608 • ":TRIGger:MODE" on page 594 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 605: Trigger:glitch:lessthan

    Return Format <less_than_time><NL> <less_than_time> ::= floating-point number in NR3 format. See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:GLITch:SOURce" on page 610 • ":TRIGger:GLITch:QUALifier" on page 608 • ":TRIGger:MODE" on page 594 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 606: Trigger:glitch:level

    If all channels are off, the query returns "NONE." Return Format <level_argument><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":TRIGger:GLITch:SOURce" on page 610 • ":EXTernal:RANGe" on page 257 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 607: Trigger:glitch:polarity

    The :TRIGger:GLITch:POLarity? query returns the glitch pulse width trigger polarity. Return Format <polarity><NL> <polarity> ::= {POS | NEG} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":TRIGger:GLITch:SOURce" on page 610 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 608: Trigger:glitch:qualifier

    The :TRIGger:GLITch:QUALifier? query returns the glitch pulse width qualifier. Return Format <operator><NL> <operator> ::= {GRE | LESS | RANG} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:GLITch:SOURce" on page 610 • ":TRIGger:MODE" on page 594 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 609: Trigger:glitch:range

    The :TRIGger:GLITch:RANGe? query returns the pulse width duration time for :TRIGger:GLITch:SOURce. Return Format <less_than_time>,<greater_than_time><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:GLITch:SOURce" on page 610 • ":TRIGger:GLITch:QUALifier" on page 608 • ":TRIGger:MODE" on page 594 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 610: Trigger:glitch:source

    585 • ":TRIGger:MODE" on page 594 • ":TRIGger:GLITch:LEVel" on page 606 • ":TRIGger:GLITch:POLarity" on page 607 • ":TRIGger:GLITch:QUALifier" on page 608 • ":TRIGger:GLITch:RANGe" on page 609 Example Code • "Example Code" on page 602 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 611: Trigger:pattern Commands

    <edge> ::= {POSitive | NEGative} :TRIGger:PATTern:FORM :TRIGger:PATTern:FORM <base> ::= {ASCii | HEX} page 614) at <base> (see at? (see page 614) :TRIGger:PATTern:QUAL :TRIGger:PATTern:QUAL <qualifier> ::= ENTered page 615) ifier <qualifier> ifier? (see page 615) (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 612: Trigger:pattern

    ASCII <string> parameter. If the edge source and edge parameters are used, they take precedence. You can only specify an edge on one channel. When an edge is specified, the :TRIGger:PATTern:QUALifier does not apply. Query Syntax :TRIGger:PATTern? Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 613 The :TRIGger:PATTern? query returns the pattern string, edge source, and edge. Return Format <string>,<edge_source>,<edge><NL> See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:PATTern:FORMat" on page 614 • ":TRIGger:PATTern:QUALifier" on page 615 • ":TRIGger:MODE" on page 594 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 614: Trigger:pattern:format

    The :TRIGger:PATTern:FORMat? query returns the currently set number base for pattern trigger patterns. Return Format <base><NL> <base> ::= {ASC | HEX} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:PATTern" on page 612 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 615: Trigger:pattern:qualifier

    Command Syntax :TRIGger:PATTern:QUALifier <qualifier> <qualifier> ::= ENTered The :TRIGger:PATTern:QUALifier command qualifies when the trigger occurs. In the InfiniiVision DSOX1204A/G oscilloscopes, the trigger always occurs when the pattern is entered. Query Syntax :TRIGger:PATTern:QUALifier? The :TRIGger:PATTern:QUALifier? query returns the trigger duration qualifier.

  • Page 616: Trigger:shold Commands

    [suffix] ::= {s | ms | us | ns | :TRIGger:SHOLd:TIME:S :TRIGger:SHOLd:TIME:S <time> ::= floating-point number page 621) ETup <time>[suffix] ETup? (see in NR3 format page 621) (see [suffix] ::= {s | ms | us | ns | Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 617: Trigger:shold:slope

    Return Format <slope><NL> <slope> ::= {NEG | POS} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":TRIGger:SHOLd:SOURce:CLOCk" on page 618 • ":TRIGger:SHOLd:SOURce:DATA" on page 619 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 618: Trigger:shold:source:clock

    The :TRIGger:SHOLd:SOURce:CLOCk? query returns the currently set clock signal source. Return Format <source><NL> <source> ::= {CHAN<n>} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":TRIGger:SHOLd:SLOPe" on page 617 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 619: Trigger:shold:source:data

    The :TRIGger:SHOLd:SOURce:DATA? query returns the currently set data signal source. Return Format <source><NL> <source> ::= {CHAN<n>} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":TRIGger:SHOLd:SLOPe" on page 617 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 620: Trigger:shold:time:hold

    The :TRIGger:SHOLd:TIME:HOLD command sets the hold time. Query Syntax :TRIGger:SHOLd:TIME:HOLD? The :TRIGger:SHOLd:TIME:HOLD? query returns the currently specified hold time. Return Format <time><NL> <time> ::= floating-point number in NR3 format See Also • "Introduction to :TRIGger Commands" on page 585 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 621: Trigger:shold:time:setup

    The :TRIGger:SHOLd:TIME:SETup command sets the setup time. Query Syntax :TRIGger:SHOLd:TIME:SETup? The :TRIGger:SHOLd:TIME:SETup? query returns the currently specified setup time. Return Format <time><NL> <time> ::= floating-point number in NR3 format See Also • "Introduction to :TRIGger Commands" on page 585 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 622: Trigger:transition Commands

    <n> ::= 1 to (# analog channels) page 625) in NR1 format :TRIGger:TRANsition:T :TRIGger:TRANsition:T <time> ::= floating-point number page 626) IME <time>[suffix] IME? (see in NR3 format page 626) (see [suffix] ::= {s | ms | us | ns | Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 623: Trigger:transition:qualifier

    The :TRIGger:TRANsition:QUALifier? query returns the current rise/fall time trigger qualifier setting. Return Format <qualifier><NL> <qualifier> ::= {GRE | LESS} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:TRANsition:TIME" on page 626 • ":TRIGger:MODE" on page 594 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 624: Trigger:transition:slope

    The :TRIGger:TRANsition:SLOPe? query returns the current rise/fall time trigger slope setting. Return Format <slope><NL> <slope> ::= {NEG | POS} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":TRIGger:TRANsition:SOURce" on page 625 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 625: Trigger:transition:source

    The :TRIGger:TRANsition:SOURce? query returns the current transition trigger source. Return Format <source><NL> <source> ::= {CHAN<n>} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":TRIGger:TRANsition:SLOPe" on page 624 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 626: Trigger:transition:time

    The :TRIGger:TRANsition:TIME? query returns the current rise/fall time trigger time value. Return Format <time><NL> <time> ::= floating-point number in NR3 format See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:TRANsition:QUALifier" on page 623 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 627: Trigger:tv Commands

    631) <source> (see (see <n> ::= 1 to (# analog channels) page 631) in NR1 format :TRIGger:TV:STANdard :TRIGger:TV:STANdard? <standard> ::= {NTSC | PAL | PALM page 632) <standard> (see (see | SECam} page 632) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 628: Trigger:tv:line

    The :TRIGger:TV:LINE? query returns the current TV trigger line number setting. Return Format <line_number><NL> <line_number>::= integer in NR1 format See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:TV:STANdard" on page 632 • ":TRIGger:TV:MODE" on page 629 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 629: Trigger:tv:mode

    <value> ::= {FIE1 | FIE2 | AFI | ALIN | LFI1 | LFI2 | LALT} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:TV:STANdard" on page 632 • ":TRIGger:MODE" on page 594 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 630: Trigger:tv:polarity

    The :TRIGger:TV:POLarity? query returns the TV trigger polarity. Return Format <polarity><NL> <polarity> ::= {POS | NEG} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":TRIGger:TV:SOURce" on page 631 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 631: Trigger:tv:source

    Return Format <source><NL> <source> ::= {CHAN<n>} See Also • "Introduction to :TRIGger Commands" on page 585 • ":TRIGger:MODE" on page 594 • ":TRIGger:TV:POLarity" on page 630 Example Code • "Example Code" on page 602 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 632: Trigger:tv:standard

    The :TRIGger:TV:STANdard command selects the video standard: • NTSC • PAL • PAL-M • SECAM Query Syntax :TRIGger:TV:STANdard? The :TRIGger:TV:STANdard? query returns the current TV trigger standard setting. Return Format <standard><NL> <standard> ::= {NTSC | PALM | PAL | SEC} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 633: 28 :Waveform Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 28 :WAVeform Commands Provide access to waveform data. See "Introduction to :WAVeform Commands" on page 635. Table 85 :WAVeform Commands Summary Command Query Options and Query Returns :WAVeform:BYTeorder :WAVeform:BYTeorder? <value> ::= {LSBFirst | MSBFirst}...
  • Page 634 658) (see :WAVeform:TYPE? (see <return_mode> ::= {NORM | PEAK | page 659) AVER | HRES} :WAVeform:UNSigned :WAVeform:UNSigned? {0 | 1} page 660) {{0 | OFF} | {1 | (see page 660) ON}} (see Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 635 The preamble also contains the X and Y increments, origins, and references for the acquired data, so that word and byte data can be translated to time and voltage values. Data Acquisition Types Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 636 645). Only the magnitude values of each data point are transmitted. The first voltage value corresponds to the first time bucket on the left side of the screen and the last value corresponds to the Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 637 Y origins, and X and Y increments. These values are read from the waveform preamble. Each channel has its own waveform preamble. In converting a data value to a voltage value, the following formula is used: voltage = [(data value - yreference) * yincrement] + yorigin Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 638 In ASCii format, holes are represented by the value 9.9e+37. The setting of :WAVeform:BYTeorder (see page 640) and :WAVeform:UNSigned (see page 660) have no effect when the format is ASCii. Data Format for Transfer - WORD format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 639 BYTE. Reporting the Setup The following is a sample response from the :WAVeform? query. In this case, the query was issued following a *RST command. :WAV:UNS 1;VIEW MAIN;BYT MSBF;FORM BYTE;POIN +1000;SOUR CHAN1;SOUR:SUBS NONE Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 640: Waveform:byteorder

    "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:DATA" on page 642 • ":WAVeform:FORMat" on page 644 • ":WAVeform:PREamble" on page 649 Example Code • "Example Code" on page 654 • "Example Code" on page 650 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 641: Waveform:count

    Return Format <count_argument><NL> <count_argument> ::= an integer from 1 to 65536 in NR1 format See Also • "Introduction to :WAVeform Commands" on page 635 • ":ACQuire:COUNt" on page 180 • ":ACQuire:TYPE" on page 189 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 642: Waveform:data

    ' READ_WAVE_DATA - The wave data consists of two parts: the header, ' and the actual waveform data followed by a new line (NL) character. ' The query data has the following format: <header><waveform_data><NL> ' Where: Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 643 FormatNumber(((lngI / intBytesPerData - lngXReference) _ * sngXIncrement + dblXOrigin) * 1000000) + " us" + vbCrLf Next lngI MsgBox "Waveform data:" + vbCrLf + strOutput See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 644: Waveform:format

    "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:BYTeorder" on page 640 • ":WAVeform:SOURce" on page 654 • ":WAVeform:DATA" on page 642 • ":WAVeform:PREamble" on page 649 Example Code • "Example Code" on page 654 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 645: Waveform:points

    MAXimum or RAW If a full screen of data is not displayed, the number of points returned will not be 1000 or an N OTE even divisor of it. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 646 Example Code ' WAVE_POINTS - Specifies the number of points to be transferred ' using the ":WAVeform:DATA?" query. myScope.WriteString ":WAVeform:POINts 1000" See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 647: Waveform:points:mode

    Query Syntax :WAVeform:POINts:MODE? The :WAVeform:POINts:MODE? query returns the current points mode. Setting the points mode will affect what data is transferred. See the discussion above. Return Format <points_mode><NL> Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 648 ":ACQuire:POINts" on page 182 • ":WAVeform:VIEW" on page 661 • ":WAVeform:PREamble" on page 649 • ":WAVeform:POINts" on page 645 • ":TIMebase:MODE" on page 575 • ":ACQuire:TYPE" on page 189 • ":ACQuire:COUNt" on page 180 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 649: Waveform:preamble

    65536 (if format = WORD) 256 (if format = BYTE) X origin (t) X reference = 0 X increment (t) = time between successive points See Also • "Introduction to :WAVeform Commands" on page 635 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 650 Dim sngYIncrement As Single Dim sngYOrigin As Single Dim lngYReference As Long Dim strOutput As String myScope.WriteString ":WAVEFORM:PREAMBLE?" ' Query for the preamble. Preamble() = myScope.ReadList ' Read preamble information. intFormat = Preamble(0) intType = Preamble(1) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 651 = Preamble(3) dblXIncrement = Preamble(4) dblXOrigin = Preamble(5) lngXReference = Preamble(6) sngYIncrement = Preamble(7) sngYOrigin = Preamble(8) lngYReference = Preamble(9) See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 652: Waveform:segmented:count

    184 • ":DIGitize" on page 143 • ":SINGle" on page 161 • ":RUN" on page 159 • "Introduction to :WAVeform Commands" on page 635 Example Code • "Example Code" on page 185 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 653: Waveform:segmented:ttag

    The index is selected using the :ACQuire:SEGMented:INDex command. Return Format <time_tag> ::= in NR3 format See Also • ":ACQuire:SEGMented:INDex" on page 185 • "Introduction to :WAVeform Commands" on page 635 Example Code • "Example Code" on page 185 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 654: Waveform:source

    Once these parameters have been sent, ' the waveform data and the preamble can be read. ' WAVE_SOURCE - Selects the channel to be used as the source for ' the waveform commands. myScope.WriteString ":WAVEFORM:SOURCE CHAN1" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 655 ":WAVEFORM:PREAMBLE?" ' Query for the preamble. Preamble() = myScope.ReadList ' Read preamble information. intFormat = Preamble(0) intType = Preamble(1) lngPoints = Preamble(2) lngCount = Preamble(3) dblXIncrement = Preamble(4) dblXOrigin = Preamble(5) lngXReference = Preamble(6) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 656 ' waveform. You can then read that number of bytes from the ' oscilloscope and the terminating NL character. Dim lngI As Long Dim lngDataValue As Long ' Unsigned integer bytes. varQueryResult = myScope.ReadIEEEBlock(BinaryType_UI1) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 657 FormatNumber(((lngI / intBytesPerData - lngXReference) _ * sngXIncrement + dblXOrigin) * 1000000) + " us" + vbCrLf Next lngI MsgBox "Waveform data:" + vbCrLf + strOutput See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 658: Waveform:source:subsource

    Query Syntax :WAVeform:SOURce:SUBSource? The :WAVeform:SOURce:SUBSource? query returns the current waveform subsource setting. Return Format <subsource><NL> <subsource> ::= {SUB0 | SUB1} See Also • "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:SOURce" on page 654 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 659: Waveform:type

    If the :WAVeform:SOURce is POD1 or POD2, the type is always NORM. N OTE See Also • "Introduction to :WAVeform Commands" on page 635 • ":ACQuire:TYPE" on page 189 • ":WAVeform:DATA" on page 642 • ":WAVeform:PREamble" on page 649 • ":WAVeform:SOURce" on page 654 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 660: Waveform:unsigned

    The :WAVeform:UNSigned? query returns the status of unsigned mode for the currently selected waveform. Return Format <unsigned><NL> <unsigned> ::= {0 | 1} See Also • "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:SOURce" on page 654 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 661: Waveform:view

    The :WAVeform:VIEW? query returns the view setting associated with the currently selected waveform. Return Format <view><NL> <view> ::= {MAIN} See Also • "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:POINts" on page 645 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 662: Waveform:xincrement

    <value> ::= x-increment in the current preamble in 64-bit floating point NR3 format See Also • "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:PREamble" on page 649 Example Code • "Example Code" on page 650 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 663: Waveform:xorigin

    <value> ::= x-origin value in the current preamble in 64-bit floating point NR3 format See Also • "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:PREamble" on page 649 • ":WAVeform:XREFerence" on page 664 Example Code • "Example Code" on page 650 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 664: Waveform:xreference

    <value> ::= x-reference value = 0 in 32-bit NR1 format See Also • "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:PREamble" on page 649 • ":WAVeform:XORigin" on page 663 Example Code • "Example Code" on page 650 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 665: Waveform:yincrement

    <value> ::= y-increment value in the current preamble in 32-bit floating point NR3 format See Also • "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:PREamble" on page 649 Example Code • "Example Code" on page 650 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 666: Waveform:yorigin

    <value> ::= y-origin in the current preamble in 32-bit floating point NR3 format See Also • "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:PREamble" on page 649 • ":WAVeform:YREFerence" on page 667 Example Code • "Example Code" on page 650 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 667: Waveform:yreference

    <value> ::= y-reference value in the current preamble in 32-bit NR1 format See Also • "Introduction to :WAVeform Commands" on page 635 • ":WAVeform:PREamble" on page 649 • ":WAVeform:YORigin" on page 666 Example Code • "Example Code" on page 650 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 668 :WAVeform Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 669: 29 :Wgen Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 29 :WGEN Commands On G-suffix oscilloscope models, a waveform generator is built into the oscilloscope. You can use the waveform generator to output sine, square, ramp, pulse, DC, and noise waveforms. The :WGEN commands are used to select the waveform function and parameters.
  • Page 670 <period> ::= period in seconds in page 694) page 694) (see NR3 format :WGEN:RST (see page 695) :WGEN:VOLTage :WGEN:VOLTage? (see <amplitude> ::= amplitude in page 696) <amplitude> (see volts in NR3 format page 696) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 671 Use :WGEN? to query setup information for the WGEN subsystem. Return Format The following is a sample response from the :WGEN? query. In this case, the query was issued following the *RST command. :WGEN:FUNC SIN;OUTP 0;FREQ +1.0000E+03;VOLT +500.0E-03;VOLT:OFFS +0.0E+00;:WGEN:OUTP:LOAD ONEM Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 672: Wgen:frequency

    The :WGEN:FREQuency? query returns the currently set waveform generator frequency. Return Format <frequency><NL> <frequency> ::= frequency in Hz in NR3 format See Also • "Introduction to :WGEN Commands" on page 671 • ":WGEN:FUNCtion" on page 673 • ":WGEN:PERiod" on page 694 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 673: Wgen:function

    697 • ":WGEN:VOLTage:LOW" on page 698 • ":WGEN:FUNCtion:SQUare:DCYCle" on page 678 The frequency can be adjusted from 100 mHz to 10 MHz. The duty cycle can be adjusted from 20% to 80%. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 674 10 mVpp to 2.5 Vpp (or from 20 mVpp to 5 Vpp into and open-circuit load). Query Syntax :WGEN:FUNCtion? The :WGEN:FUNCtion? query returns the currently selected signal type. Return Format <signal><NL> <signal> ::= {SIN | SQU | RAMP | PULS | NOIS | DC} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 675 :WGEN Commands See Also • "Introduction to :WGEN Commands" on page 671 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 676: Wgen:function:pulse:width

    The :WGEN:FUNCtion:PULSe:WIDTh? query returns the currently set pulse width. Return Format <width><NL> <width> ::= pulse width in seconds in NR3 format See Also • "Introduction to :WGEN Commands" on page 671 • ":WGEN:FUNCtion" on page 673 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 677: Wgen:function:ramp:symmetry

    The :WGEN:FUNCtion:RAMP:SYMMetry? query returns the currently set ramp symmetry. Return Format <percent><NL> <percent> ::= symmetry percentage from 0% to 100% in NR1 format See Also • "Introduction to :WGEN Commands" on page 671 • ":WGEN:FUNCtion" on page 673 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 678: Wgen:function:square:dcycle

    The :WGEN:FUNCtion:SQUare:DCYCle? query returns the currently set square wave duty cycle. Return Format <percent><NL> <percent> ::= duty cycle percentage from 20% to 80% in NR1 format See Also • "Introduction to :WGEN Commands" on page 671 • ":WGEN:FUNCtion" on page 673 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 679: Wgen:modulation:am:depth

    ":WGEN:MODulation:FM:FREQuency" on page 682 • ":WGEN:MODulation:FSKey:FREQuency" on page 683 • ":WGEN:MODulation:FSKey:RATE" on page 684 • ":WGEN:MODulation:FUNCtion" on page 685 • ":WGEN:MODulation:FUNCtion:RAMP:SYMMetry" on page 686 • ":WGEN:MODulation:STATe" on page 688 • ":WGEN:MODulation:TYPE" on page 689 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 680: Wgen:modulation:am:frequency

    ":WGEN:MODulation:FM:FREQuency" on page 682 • ":WGEN:MODulation:FSKey:FREQuency" on page 683 • ":WGEN:MODulation:FSKey:RATE" on page 684 • ":WGEN:MODulation:FUNCtion" on page 685 • ":WGEN:MODulation:FUNCtion:RAMP:SYMMetry" on page 686 • ":WGEN:MODulation:STATe" on page 688 • ":WGEN:MODulation:TYPE" on page 689 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 681: Wgen:modulation:fm:deviation

    ":WGEN:MODulation:FM:FREQuency" on page 682 • ":WGEN:MODulation:FSKey:FREQuency" on page 683 • ":WGEN:MODulation:FSKey:RATE" on page 684 • ":WGEN:MODulation:FUNCtion" on page 685 • ":WGEN:MODulation:FUNCtion:RAMP:SYMMetry" on page 686 • ":WGEN:MODulation:STATe" on page 688 • ":WGEN:MODulation:TYPE" on page 689 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 682: Wgen:modulation:fm:frequency

    ":WGEN:MODulation:FM:DEViation" on page 681 • ":WGEN:MODulation:FSKey:FREQuency" on page 683 • ":WGEN:MODulation:FSKey:RATE" on page 684 • ":WGEN:MODulation:FUNCtion" on page 685 • ":WGEN:MODulation:FUNCtion:RAMP:SYMMetry" on page 686 • ":WGEN:MODulation:STATe" on page 688 • ":WGEN:MODulation:TYPE" on page 689 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 683: Wgen:modulation:fskey:frequency

    ":WGEN:MODulation:FM:DEViation" on page 681 • ":WGEN:MODulation:FM:FREQuency" on page 682 • ":WGEN:MODulation:FSKey:RATE" on page 684 • ":WGEN:MODulation:FUNCtion" on page 685 • ":WGEN:MODulation:FUNCtion:RAMP:SYMMetry" on page 686 • ":WGEN:MODulation:STATe" on page 688 • ":WGEN:MODulation:TYPE" on page 689 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 684: Wgen:modulation:fskey:rate

    ":WGEN:MODulation:FM:DEViation" on page 681 • ":WGEN:MODulation:FM:FREQuency" on page 682 • ":WGEN:MODulation:FSKey:FREQuency" on page 683 • ":WGEN:MODulation:FUNCtion" on page 685 • ":WGEN:MODulation:FUNCtion:RAMP:SYMMetry" on page 686 • ":WGEN:MODulation:STATe" on page 688 • ":WGEN:MODulation:TYPE" on page 689 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 685: Wgen:modulation:function

    ":WGEN:MODulation:FM:DEViation" on page 681 • ":WGEN:MODulation:FM:FREQuency" on page 682 • ":WGEN:MODulation:FSKey:FREQuency" on page 683 • ":WGEN:MODulation:FSKey:RATE" on page 684 • ":WGEN:MODulation:FUNCtion:RAMP:SYMMetry" on page 686 • ":WGEN:MODulation:STATe" on page 688 • ":WGEN:MODulation:TYPE" on page 689 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 686: Wgen:modulation:function:ramp:symmetry

    ":WGEN:MODulation:FM:DEViation" on page 681 • ":WGEN:MODulation:FM:FREQuency" on page 682 • ":WGEN:MODulation:FSKey:FREQuency" on page 683 • ":WGEN:MODulation:FSKey:RATE" on page 684 • ":WGEN:MODulation:FUNCtion" on page 685 • ":WGEN:MODulation:STATe" on page 688 • ":WGEN:MODulation:TYPE" on page 689 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 687: Wgen:modulation:noise

    TRIG OUT). This is because the trigger comparator is located after the noise source. Query Syntax :WGEN:MODulation:NOISe? The :WGEN:MODulation:NOISe query returns the percent of added noise. Return Format <percent><NL> <percent> ::= 0 to 100 See Also • ":WGEN:FUNCtion" on page 673 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 688: Wgen:modulation:state

    ":WGEN:MODulation:FM:DEViation" on page 681 • ":WGEN:MODulation:FM:FREQuency" on page 682 • ":WGEN:MODulation:FSKey:FREQuency" on page 683 • ":WGEN:MODulation:FSKey:RATE" on page 684 • ":WGEN:MODulation:FUNCtion" on page 685 • ":WGEN:MODulation:FUNCtion:RAMP:SYMMetry" on page 686 • ":WGEN:MODulation:TYPE" on page 689 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 689: Wgen:modulation:type

    <type> ::= {AM | FM | FSK} See Also • ":WGEN:MODulation:AM:DEPTh" on page 679 • ":WGEN:MODulation:AM:FREQuency" on page 680 • ":WGEN:MODulation:FM:DEViation" on page 681 • ":WGEN:MODulation:FM:FREQuency" on page 682 • ":WGEN:MODulation:FSKey:FREQuency" on page 683 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 690 :WGEN Commands • ":WGEN:MODulation:FSKey:RATE" on page 684 • ":WGEN:MODulation:FUNCtion" on page 685 • ":WGEN:MODulation:FUNCtion:RAMP:SYMMetry" on page 686 • ":WGEN:MODulation:STATe" on page 688 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 691: Wgen:output

    Query Syntax :WGEN:OUTPut? The :WGEN:OUTPut? query returns the current state of the waveform generator output setting. Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :WGEN Commands" on page 671 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 692: Wgen:output:load

    Query Syntax :WGEN:OUTPut:LOAD? The :WGEN:OUTPut:LOAD? query returns the current expected output load impedance. Return Format <impedance><NL> <impedance> ::= {ONEM | FIFT} See Also • "Introduction to :WGEN Commands" on page 671 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 693: Wgen:output:polarity

    The :WGEN:OUTPut:POLarity command specifies whether the waveform generator output is inverted.. Query Syntax :WGEN:OUTPut:POLarity? The :WGEN:OUTPut:POLarity? query returns the specified output polarity. Return Format <polarity><NL> <polarity> ::= {NORM | INV} See Also • "Introduction to :WGEN Commands" on page 671 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 694: Wgen:period

    The :WGEN:PERiod? query returns the currently set waveform generator period. Return Format <period><NL> <period> ::= period in seconds in NR3 format See Also • "Introduction to :WGEN Commands" on page 671 • ":WGEN:FUNCtion" on page 673 • ":WGEN:FREQuency" on page 672 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 695: Wgen:rst

    The :WGEN:RST command restores the waveform generator factory default settings (1 kHz sine wave, 500 mVpp, 0 V offset). See Also • "Introduction to :WGEN Commands" on page 671 • ":WGEN:FUNCtion" on page 673 • ":WGEN:FREQuency" on page 672 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 696: Wgen:voltage

    <amplitude> ::= amplitude in volts in NR3 format See Also • "Introduction to :WGEN Commands" on page 671 • ":WGEN:FUNCtion" on page 673 • ":WGEN:VOLTage:OFFSet" on page 699 • ":WGEN:VOLTage:HIGH" on page 697 • ":WGEN:VOLTage:LOW" on page 698 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 697: Wgen:voltage:high

    <high> ::= high-level voltage in volts, in NR3 format See Also • "Introduction to :WGEN Commands" on page 671 • ":WGEN:FUNCtion" on page 673 • ":WGEN:VOLTage:LOW" on page 698 • ":WGEN:VOLTage" on page 696 • ":WGEN:VOLTage:OFFSet" on page 699 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 698: Wgen:voltage:low

    <low> ::= low-level voltage in volts, in NR3 format See Also • "Introduction to :WGEN Commands" on page 671 • ":WGEN:FUNCtion" on page 673 • ":WGEN:VOLTage:LOW" on page 698 • ":WGEN:VOLTage" on page 696 • ":WGEN:VOLTage:OFFSet" on page 699 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 699: Wgen:voltage:offset

    <offset> ::= offset in volts in NR3 format See Also • "Introduction to :WGEN Commands" on page 671 • ":WGEN:FUNCtion" on page 673 • ":WGEN:VOLTage" on page 696 • ":WGEN:VOLTage:HIGH" on page 697 • ":WGEN:VOLTage:LOW" on page 698 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 700 :WGEN Commands Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 701: 30 :Wmemory Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 30 :WMEMory<r> Commands Control reference waveforms. Table 87 :WMEMory<r> Commands Summary Command Query Options and Query Returns :WMEMory<r>:CLEar <r> ::= 1-2 in NR1 format page 703) (see :WMEMory<r>:DISPlay :WMEMory<r>:DISPlay? <r> ::= 1-2 in NR1 format...
  • Page 702 [suffix] ::= {V | mV} :WMEMory<r>:YSCale :WMEMory<r>:YSCale? <r> ::= 1-2 in NR1 format page 710) <scale>[suffix] (see (see <scale> ::= vertical units per page 710) division value in NR3 format [suffix] ::= {V | mV} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 703: Wmemory:Clear

    <r> ::= 1-2 in NR1 format The :WMEMory<r>:CLEar command clears the specified reference waveform location. See Also • Chapter 30, “:WMEMory<r> Commands,” starting on page 701 • ":WMEMory<r>:SAVE" on page 706 • ":WMEMory<r>:DISPlay" on page 704 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 704: Wmemory:Display

    The :WMEMory<r>:DISPlay? query returns the current display setting for the reference waveform. Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • Chapter 30, “:WMEMory<r> Commands,” starting on page 701 • ":WMEMory<r>:CLEar" on page 703 • ":WMEMory<r>:LABel" on page 705 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 705: Wmemory:Label

    The :WMEMory<r>:LABel? query returns the label associated with a particular reference waveform. Return Format <string><NL> <string> ::= quoted ASCII string See Also • Chapter 30, “:WMEMory<r> Commands,” starting on page 701 • ":WMEMory<r>:DISPlay" on page 704 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 706: Wmemory:Save

    Only ADD or SUBtract math operations can be saved as reference waveforms. N OTE See Also • Chapter 30, “:WMEMory<r> Commands,” starting on page 701 • ":WMEMory<r>:DISPlay" on page 704 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 707: Wmemory:Skew

    <skew> ::= time in seconds in NR3 format See Also • Chapter 30, “:WMEMory<r> Commands,” starting on page 701 • ":WMEMory<r>:DISPlay" on page 704 • ":WMEMory<r>:YOFFset" on page 708 • ":WMEMory<r>:YRANge" on page 709 • ":WMEMory<r>:YSCale" on page 710 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 708: Wmemory:Yoffset

    <offset> ::= vertical offset value in NR3 format See Also • Chapter 30, “:WMEMory<r> Commands,” starting on page 701 • ":WMEMory<r>:DISPlay" on page 704 • ":WMEMory<r>:YRANge" on page 709 • ":WMEMory<r>:YSCale" on page 710 • ":WMEMory<r>:SKEW" on page 707 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 709: Wmemory:Yrange

    <range> ::= vertical full-scale range value in NR3 format See Also • Chapter 30, “:WMEMory<r> Commands,” starting on page 701 • ":WMEMory<r>:DISPlay" on page 704 • ":WMEMory<r>:YOFFset" on page 708 • ":WMEMory<r>:SKEW" on page 707 • ":WMEMory<r>:YSCale" on page 710 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 710: Wmemory:Yscale

    <scale> ::= vertical units per division in NR3 format See Also • Chapter 30, “:WMEMory<r> Commands,” starting on page 701 • ":WMEMory<r>:DISPlay" on page 704 • ":WMEMory<r>:YOFFset" on page 708 • ":WMEMory<r>:YRANge" on page 709 • ":WMEMory<r>:SKEW" on page 707 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 711: Obsolete And Discontinued Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 31 Obsolete and Discontinued Commands Obsolete commands are older forms of commands that are provided to reduce customer rework for existing systems and programs (see"Obsolete Commands" page 798). Obsolete Command Current Command Equivalent Behavior Differences ANALog<n>:BWLimit...
  • Page 712 :MEASure:SCRatch (see :MEASure:CLEar (see page 732) page 354) :MEASure:TDELta (see :MARKer:XDELta (see page 733) page 333) :MEASure:THResholds (see :MEASure:DEFine:THResholds MEASure:DEFine:THResholds page 734) (see page 356) can define absolute values or percentage Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 713 750) (see page 163) :MTESt:TRIGger:SOURce (see :TRIGger Commands (see There are various commands page 751) page 585) for setting the source with different types of triggers. :PRINt? (see page 752) :DISPlay:DATA? (see page 234) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 714 629) Discontinued Discontinued commands are commands that were used by previous oscilloscopes, Commands but are not supported by the InfiniiVision DSOX1204A/G oscilloscopes. Listed below are the Discontinued commands and the nearest equivalent command available (if any). Discontinued Command Current Command Equivalent...
  • Page 715 TRIGger:TV:VIR none VAUToscale none Discontinued Some previous oscilloscope queries returned control setting values of OFF and ON. Parameters The InfiniiVision DSOX1204A/G oscilloscopes only return the enumerated values 0 (for off) and 1 (for on). Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 716: Channel:label

    The :CHANnel:LABel command is an obsolete command provided for compatibility to previous N OTE oscilloscopes. Use the :CHANnel<n>:LABel command (see page 210). Query Syntax :CHANnel:LABel? The :CHANnel:LABel? query returns the label associated with a particular analog channel. Return Format <string><NL> <string> ::= quoted ASCII string Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 717: Channel2:Skew

    The :CHANnel2:SKEW? query returns the current probe skew setting for the selected channel. Return Format <skew value><NL> <skew value> ::= skew value in NR3 format See Also • "Introduction to :CHANnel<n> Commands" on page 203 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 718: Channel:Input

    Use the :CHANnel<n>:IMPedance command (see page 208) instead. Query Syntax :CHANnel<n>:INPut? The :CHANnel<n>:INPut? query returns the current input impedance setting for the specified channel. Return Format <impedance value><NL> <impedance value> ::= {ONEM | FIFT} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 719: Channel:Pmode

    The :CHANnel<n>:PMODe command is an obsolete command provided for compatibility to N OTE previous oscilloscopes. Query Syntax :CHANnel<n>:PMODe? The :CHANnel<n>:PMODe? query returns AUT if an autosense probe is attached and MAN otherwise. Return Format <pmode value><NL> <pmode value> ::= {AUT | MAN} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 720: Display:connect

    Use the :DISPlay:VECTors command (see page 240) instead. Query Syntax :DISPlay:CONNect? The :DISPlay:CONNect? query returns the current state of the vectors setting. Return Format <connect><NL> <connect> ::= {1 | 0} See Also • ":DISPlay:VECTors" on page 240 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 721: Erase

    798) Command Syntax :ERASe The :ERASe command erases the screen. The :ERASe command is an obsolete command provided for compatibility to previous N OTE oscilloscopes. Use the :DISplay:CLEar command (see page 233) instead. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 722: External:pmode

    The :EXTernal:PMODe command is an obsolete command provided for compatibility to N OTE previous oscilloscopes. Query Syntax :EXTernal:PMODe? The :EXTernal:PMODe? query returns AUT if an autosense probe is attached and MAN otherwise. Return Format <pmode value><NL> <pmode value> ::= {AUT | MAN} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 723: Franalysis:ppdecade

    Query Syntax :FRANalysis:PPDecade? The :FRANalysis:PPDecade? query returns the points per decade setting. Return Format <value><NL> See Also • ":FRANalysis:SWEep:POINts" on page 284 • ":FRANalysis:FREQuency:STARt" on page 279 • ":FRANalysis:FREQuency:STOP" on page 280 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 724: Function:source

    <value> ::= {CHAN<n> | ADD | SUBT | MULT} <n> ::= 1 to (# analog channels) in NR1 format See Also • "Introduction to :FUNCtion Commands" on page 291 • ":FUNCtion:OPERation" on page 303 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 725: Function:view

    The :FUNCtion:VIEW command is provided for backward compatibility to previous N OTE oscilloscopes. Use the :FUNCtion:DISPlay command (see page 292) instead. Query Syntax :FUNCtion:VIEW? The :FUNCtion:VIEW? query returns the current state of the selected function. Return Format <view><NL> <view> ::= {1 | 0} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 726: Hardcopy:destination

    Use the :HARDcopy:FILename command (see page 727) instead. Query Syntax :HARDcopy:DESTination? The :HARDcopy:DESTination? query returns the selected hardcopy destination. Return Format <destination><NL> <destination> ::= {CENT | FLOP} See Also • "Introduction to :HARDcopy Commands" on page 312 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 727: Hardcopy:filename

    :RECall:FILename command (see page 435) instead. Query Syntax :HARDcopy:FILename? The :HARDcopy:FILename? query returns the current hardcopy output filename. Return Format <string><NL> <string> ::= quoted ASCII string See Also • "Introduction to :HARDcopy Commands" on page 312 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 728: Hardcopy:grayscale

    :HARDcopy:GRAYscale? The :HARDcopy:GRAYscale? query returns a flag indicating whether grayscaling is performed in the hardcopy dump. Return Format <gray><NL> <gray> ::= {0 | 1} See Also • "Introduction to :HARDcopy Commands" on page 312 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 729: Hardcopy:igcolors

    Query Syntax :HARDcopy:IGColors? The :HARDcopy:IGColors? query returns a flag indicating whether graticule colors are inverted or not. Return Format <value><NL> <value> ::= {0 | 1} See Also • "Introduction to :HARDcopy Commands" on page 312 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 730: Hardcopy:pdriver

    DJ8S | DJ8 | DJ9V | OJPR | DJ9 | GVIP | DJ55 | PS10 | PS47 | CLAS | MLAS | LJF | POST} See Also • "Introduction to :HARDcopy Commands" on page 312 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 731: Measure:lower

    Return Format <voltage><NL> <voltage> ::= the user-defined lower threshold in volts in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:THResholds" on page 734 • ":MEASure:UPPer" on page 740 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 732: Measure:scratch

    The :MEASure:SCRatch command clears all selected measurements and markers from the screen. The :MEASure:SCRatch command is obsolete and is provided for backward compatibility to N OTE previous oscilloscopes. Use the :MEASure:CLEar command (see page 354) instead. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 733: Measure:tdelta

    326 • "Introduction to :MEASure Commands" on page 350 • ":MARKer:X1Position" on page 329 • ":MARKer:X2Position" on page 331 • ":MARKer:XDELta" on page 333 • ":MEASure:TSTArt" on page 737 • ":MEASure:TSTOp" on page 738 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 734: Measure:thresholds

    {VOLTage} uses the upper and lower voltage thresholds set by the UPPer and LOWer commands on the selected waveform. See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:LOWer" on page 731 • ":MEASure:UPPer" on page 740 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 735: Measure:tmax

    <value><NL> <value> ::= time at maximum in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:TMIN" on page 736 • ":MEASure:XMAX" on page 396 • ":MEASure:XMIN" on page 397 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 736: Measure:tmin

    <value><NL> <value> ::= time at minimum in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:TMAX" on page 735 • ":MEASure:XMAX" on page 396 • ":MEASure:XMIN" on page 397 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 737: Measure:tstart

    326 • "Introduction to :MEASure Commands" on page 350 • ":MARKer:X1Position" on page 329 • ":MARKer:X2Position" on page 331 • ":MARKer:XDELta" on page 333 • ":MEASure:TDELta" on page 733 • ":MEASure:TSTOp" on page 738 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 738: Measure:tstop

    326 • "Introduction to :MEASure Commands" on page 350 • ":MARKer:X1Position" on page 329 • ":MARKer:X2Position" on page 331 • ":MARKer:XDELta" on page 333 • ":MEASure:TDELta" on page 733 • ":MEASure:TSTArt" on page 737 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 739: Measure:tvolt

    The :MEASure:TVOLt command is obsolete and is provided for backward compatibility to N OTE previous oscilloscopes. Use the :MEASure:TVALue command (see page 384). Return Format <value><NL> <value> ::= time in seconds of the specified voltage crossing in NR3 format Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 740: Measure:upper

    The :MEASure:UPPer? query returns the current upper threshold level. Return Format <value><NL> <value> ::= the user-defined upper threshold in NR3 format See Also • "Introduction to :MEASure Commands" on page 350 • ":MEASure:LOWer" on page 731 • ":MEASure:THResholds" on page 734 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 741: Measure:vdelta

    326 • "Introduction to :MEASure Commands" on page 350 • ":MARKer:Y1Position" on page 336 • ":MARKer:Y2Position" on page 337 • ":MARKer:YDELta" on page 338 • ":MEASure:TDELta" on page 733 • ":MEASure:TSTArt" on page 737 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 742: Measure:vstart

    ":MARKer:Y1Position" on page 336 • ":MARKer:Y2Position" on page 337 • ":MARKer:YDELta" on page 338 • ":MARKer:X1Y1source" on page 330 • ":MEASure:SOURce" on page 380 • ":MEASure:TDELta" on page 733 • ":MEASure:TSTArt" on page 737 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 743: Measure:vstop

    ":MARKer:Y1Position" on page 336 • ":MARKer:Y2Position" on page 337 • ":MARKer:YDELta" on page 338 • ":MARKer:X2Y2source" on page 332 • ":MEASure:SOURce" on page 380 • ":MEASure:TDELta" on page 733 • ":MEASure:TSTArt" on page 737 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 744: Mtest:amask:{Save | Store

    The :MTESt:AMASk:{SAVE | STORe} command is obsolete and is provided for backward N OTE compatibility to previous oscilloscopes. Use the :SAVE:MASK[:STARt] command (see page 450) instead. See Also • "Introduction to :MTESt Commands" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 745: Mtest:average

    Query Syntax :MTESt:AVERage? The :MTESt:AVERage? query returns the current setting for averaging. Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:AVERage:COUNt" on page 746 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 746: Mtest:average:count

    The :MTESt:AVERage:COUNt? query returns the currently selected count value. Return Format <count><NL> <count> ::= an integer from 2 to 65536 in NR1 format See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:AVERage" on page 745 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 747: Mtest:load

    The :MTESt:LOAD command is obsolete and is provided for backward compatibility to previous N OTE oscilloscopes. Use the :RECall:MASK[:STARt] command (see page 436) instead. See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:AMASk:{SAVE | STORe}" on page 744 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 748: Mtest:rumode

    <seconds> ::= from 1 to 86400 in NR3 format <wfm_count> ::= number of waveforms in NR1 format from 1 to 1,000,000,000 See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:RUMode:SOFailure" on page 749 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 749: Mtest:rumode:sofailure

    The :MTESt:RUMode:SOFailure? query returns the current state of the Stop on Failure control. Return Format <on_off><NL> <on_off> ::= {1 | 0} See Also • "Introduction to :MTESt Commands" on page 401 • ":MTESt:RUMode" on page 748 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 750: Mtest:{Start | Stop

    The :MTESt:STARt and :MTESt:STOP commands are obsolete and are provided for backward N OTE compatibility to previous oscilloscopes. Use the :RUN command (see page 159) and :STOP command (see page 163) instead. See Also • "Introduction to :MTESt Commands" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 751: Mtest:trigger:source

    The :MTESt:TRIGger:SOURce? query returns the currently selected trigger source. Return Format <source> ::= CHAN<n> <n> ::= 1 to (# analog channels) in NR1 format See Also • "Introduction to :MTESt Commands" on page 401 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 752: Print

    Selects outputting of Not used additional settings information for :PRINT NOFactors Deselects outputting Not used of additional settings information for :PRINT Old Print Option: Is Now: HIRes COLor LORes GRAYscale PARallel PRINter0 DISK invalid invalid Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 753 See Also • "Introduction to Root (:) Commands" on page 135 • "Introduction to :HARDcopy Commands" on page 312 • ":HARDcopy:FACTors" on page 315 • ":HARDcopy:GRAYscale" on page 728 • ":DISPlay:DATA" on page 234 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 754: Save:image:area

    See Also • "Introduction to :SAVE Commands" on page 442 • ":SAVE:IMAGe[:STARt]" on page 445 • ":SAVE:IMAGe:FACTors" on page 446 • ":SAVE:IMAGe:FORMat" on page 447 • ":SAVE:IMAGe:INKSaver" on page 448 • ":SAVE:IMAGe:PALette" on page 449 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 755: Timebase:delay

    ' is the internal time between the trigger event and the ' onscreen delay reference point. ' Set time base delay to 0.0. myScope.WriteString ":TIMEBASE:DELAY 0.0" See complete example programs at: Chapter 36, “Programming Examples,” starting on page 807 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 756: Trigger:tv:tvmode

    Query Syntax :TRIGger:TV:TVMode? The :TRIGger:TV:TVMode? query returns the TV trigger mode. Return Format <value><NL> <value> ::= {FIE1 | FIE2 | AFI | ALIN | LINE | VERT | LFI1 | LFI2 | LALT | LVER} Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 757: Error Messages

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 32 Error Messages -440, Query UNTERMINATED after indefinite response -430, Query DEADLOCKED -420, Query UNTERMINATED -410, Query INTERRUPTED -400, Query error -340, Calibration failed -330, Self-test failed -321, Out of memory -320, Storage fault...
  • Page 758 -310, System error -300, Device specific error -278, Macro header not found -277, Macro redefinition not allowed -276, Macro recursion error -273, Illegal macro label -272, Macro execution error -258, Media protected -257, File name error Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 759 This message can occur when a feature is unavailable or unlicensed. For example, some serial bus decode commands are only available when the serial decode options are licensed. -240, Hardware error -231, Data questionable -230, Data corrupt or stale -224, Illegal parameter value Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 760 -183, Invalid inside macro definition -181, Invalid outside macro definition -178, Expression data not allowed -171, Invalid expression -170, Expression error -168, Block data not allowed -161, Invalid block data -158, String data not allowed Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 761 -131, Invalid suffix -128, Numeric data not allowed -124, Too many digits -123, Exponent too large -121, Invalid character in number -120, Numeric data error -114, Header suffix out of range -113, Undefined header Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 762 -108, Parameter not allowed -105, GET not allowed -104, Data type error -103, Invalid separator -102, Syntax error -101, Invalid character -100, Command error +10, Software Fault Occurred +100, File Exists +101, End-Of-File Found +102, Read Error Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 763 A remote operation wants some information, but there is no information available. For example, you may request a stored TIFF image using the :DISPlay:DATA? query, but there may be no image stored. +112, Unknown File Type +113, Directory Not Supported Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 764 Error Messages Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 765: Status Reporting

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 33 Status Reporting Status Reporting Data Structures / 767 Status Byte Register (STB) / 770 Service Request Enable Register (SRE) / 772 Trigger Event Register (TER) / 773 Output Queue / 774 Message Queue / 775...
  • Page 766 Registers are read with their associated commands. The *CLS command clears all event registers and all queues except the output queue. If you send *CLS immediately after a program message terminator, the output queue is also cleared. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 767: Status Reporting Data Structures

    :OVL? Overload Event Enable (Mask) Register Com- Auto :MTERegister[:EVENt]? Started Fail Mask plete Mask Test Event Event Register :MTEenable :MTEenable? Mask Test Event Enable (MASK) Register To bits in Operation Status Condition Register: OVLR Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 768 Register bits to generate a summary bit, the bits must be enabled. These bits are enabled by using the *ESE common command to set the corresponding bit in the Standard Event Status Enable Register. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 769 Status Byte Register must be enabled. These bits are enabled by using the *SRE common command to set the corresponding bit in the Service Request Enable Register. These enabled bits can then set RQS and MSS (bit 6) in the Status Byte Register. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 770: Status Byte Register (Stb)

    6 (weight = 64). Bit 6 is set when the first enabled summary bit is set and is cleared when the Status Byte Register is read by the serial poll command. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 771 Use Serial Polling to Read Status Byte Register. Serial polling is the preferred method to read N OTE the contents of the Status Byte Register because it resets bit 6 and allows the next enabled event that occurs to generate a new SRQ interrupt. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 772: Service Request Enable Register (Sre)

    • When one or more bytes in the Output Queue set bit 4 (MAV). • When an enabled event in the Standard Event Status Register generates a summary bit that sets bit 5 (ESB). Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 773: Trigger Event Register (Ter)

    If you are using the Service Request to interrupt a program or controller operation, you must clear the event register each time the trigger bit is set. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 774: Output Queue

    This summary bit sets the MAV bit (bit 4) in the Status Byte Register. When using the Keysight VISA COM library, the output queue may be read with the FormattedIO488 object's ReadString, ReadNumber, ReadList, or ReadIEEEBlock methods. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 775: Message Queue

    The length of the oscilloscope's message queue is 1. Note that messages sent with the :SYSTem:DSP command do not set the MSG status bit in the Status Byte Register. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 776: (Standard) Event Status Register (Esr)

    = myScope.ReadNumber MsgBox "Standard Event Status Register: 0x" + Hex(varQueryResult) If bit 4 (weight = 16) and bit 5 (weight = 32) are set, the program prints the sum of the two weights. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 777: (Standard) Event Status Enable Register (Ese)

    (Standard) Event Status Register bits that are not enabled still respond to their corresponding conditions (that is, they are set if the corresponding event occurs). However, because they are not enabled, they do not generate a summary bit to the Status Byte Register. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 778: Error Queue

    "0, No error". The error queue is cleared when: • the instrument is powered up, • the instrument receives the *CLS common command, or • the last item is read from the error queue. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 779: Operation Status Event Register (:Operegister[:Event])

    If any of these bits are set, the OPER bit (bit 7) of the Status Byte Register is set. The Operation Status Event Register is read and cleared with the :OPERegister[:EVENt]? query. The register output is enabled or disabled using the mask value supplied with the OPEE command. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 780: Operation Status Condition Register (:Operegister:condition)

    MTE bit bit 9 Comes from the Mask Test Event Registers. OVLR bit bit 11 Is set whenever a 50Ω input overload occurs. The :OPERegister:CONDition? query returns the value of the Operation Status Condition Register. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 781: Arm Event Register (Aer)

    If you are using the Service Request to interrupt a program or controller operation when the trigger bit is set, then you must clear the event register after each time it has been set. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 782: Overload Event Register (:Ovlregister)

    Channel 3 Fault bit 8 Fault has occurred on Channel 3 input. Channel 4 Fault bit 9 Fault has occurred on Channel 4 input. External Trigger bit 10 Fault has occurred on External Trigger input. Fault Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 783: Mask Test Event Event Register (:Mteregister[:Event])

    Is set when mask testing is started. Auto Mask bit 10 Is set when auto mask creation is completed. The :MTERegister[:EVENt]? query returns the value of, and clears, the Mask Test Event Event Register. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 784: Clearing Registers And Queues

    Clearing Registers and Queues The *CLS common command clears all event registers and all queues except the output queue. If *CLS is sent immediately after a program message terminator, the output queue is also cleared. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 785: Status Reporting Decision Chart

    If events are monitored by the Standard Event Status Register, myScope.WriteString "*STB?" also enable ESB with the *SRE varR = myScope.ReadNumber Determine which bits in the command. MsgBox "STB: 0x" + Hex(varR) Status Byte Register are set. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 786 Status Reporting Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 787: Synchronizing Acquisitions

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 34 Synchronizing Acquisitions Synchronization in the Programming Flow / 788 Blocking Synchronization / 789 Polling Synchronization With Timeout / 790 Synchronizing with a Single-Shot Device Under Test (DUT) / 792 Synchronization with an Averaging Acquisition / 794...

  • Page 788: Synchronization In The Programming Flow

    Requires known maximum wait time. Implementation "Blocking Synchronization" "Polling Synchronization Details on page 789. With Timeout" on page 790. Retrieve Results Once the acquisition is complete, it is safe to retrieve measurements and statistics. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 789: Blocking Synchronization

    ":MEASure:RISetime" myScope.WriteString ":MEASure:RISetime?" varQueryResult = myScope.ReadNumber ' Read risetime. Debug.Print "Risetime: " + _ FormatNumber(varQueryResult * 1000000000, 1) + " ns" Exit Sub VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.Description End Sub Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 790: Polling Synchronization With Timeout

    ' Look for RUN bit = stopped (acquisition complete). Dim lngTimeout As Long ' Max millisecs to wait for single-shot. Dim lngElapsed As Long lngTimeout = 10000 ' 10 seconds. lngElapsed = 0 Do While lngElapsed <= lngTimeout Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 791 Debug.Print "Risetime: " + _ FormatNumber(varQueryResult * 1000000000, 1) + " ns" Else Debug.Print "Timeout waiting for single-shot trigger." End If Exit Sub VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.Description End Sub Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 792: Synchronizing With A Single-Shot Device Under Test (Dut)

    ' Set up the trigger and horizontal scale. myScope.WriteString ":TRIGger:MODE EDGE" myScope.WriteString ":TRIGger:EDGE:LEVel 2" myScope.WriteString ":TIMebase:SCALe 5e-8" ' Stop acquisitions and wait for the operation to complete. myScope.WriteString ":STOP" myScope.WriteString "*OPC?" strQueryResult = myScope.ReadString ' Acquire. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 793 Debug.Print "Risetime: " + _ FormatNumber(varQueryResult * 1000000000, 1) + " ns" Else Debug.Print "Timeout waiting for single-shot trigger." End If Exit Sub VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.Description End Sub Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 794: Synchronization With An Averaging Acquisition

    ' Stop acquisitions and wait for the operation to complete. myScope.WriteString ":STOP" myScope.WriteString "*OPC?" strQueryResult = myScope.ReadString ' Set up average acquisition mode. Dim lngAverages As Long lngAverages = 256 myScope.WriteString ":ACQuire:COUNt " + CStr(lngAverages) myScope.WriteString ":ACQuire:TYPE AVERage" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 795 ":MEASure:RISetime" myScope.WriteString ":MEASure:RISetime?" varQueryResult = myScope.ReadNumber ' Read risetime. Debug.Print "Risetime: " + _ FormatNumber(varQueryResult * 1000000000, 1) + " ns" Exit Sub VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.Description End Sub Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 796 Synchronizing Acquisitions Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 797: More About Oscilloscope Commands

    Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide 35 More About Oscilloscope Commands Command Classifications / 798 Valid Command/Query Strings / 799 Query Return Values / 805 All Oscilloscope Commands Are Sequential / 806...

  • Page 798: Command Classifications

    New systems and programs should use the Core (and Non-core) commands. Obsolete commands are listed in: • Chapter 31, “Obsolete and Discontinued Commands,” starting on page 711 Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 799: Valid Command/Query Strings

    ":DISPlay:LABel ON" is a command. Queries are indicated by adding a question mark (?) to the end of the header, for example, ":DISPlay:LABel?". Many instructions can be used as either commands or queries, depending on whether or Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 800 • When the command/keyword is four or fewer characters, use all of the characters. Long Form Short form RANGe RANG PATTern PATT Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 801 Common command headers control IEEE 488.2 functions within the instrument (such as clear status). Their syntax is: *<command header><terminator> No space or separator is allowed between the asterisk (*) and the command header. *CLS is an example of a common command header. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 802 9, you would send a byte representing the ASCII code for the character 9 (which is 57). A three-digit number like 102 would take up three bytes (ASCII codes 49, 48, and 50). This is handled automatically when you include the entire instruction in a string. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 803: Duplicate Mnemonics

    Visual Basic. The quoted string is placed on the bus, followed by a carriage return and linefeed (CRLF). To execute more than one function within the same subsystem, separate the functions with a semicolon (;): :<subsystem>:<function><separator><data>;<function><separator><data><ter minator> For example: myScope.WriteString ":TIMebase:RANGe 0.5;POSition 0" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 804 The parser can then see the DISPlay:VECTors ON command. The space between REFerence and CENter is required; so is the space between VECTors and ON. Multiple commands may be any combination of compound and simple commands. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 805: Query Return Values

    (the current response) and places a Query INTERRUPTED error in the error queue. Infinity The representation of infinity is +9.9E+37. This is also the value returned when a Representation measurement cannot be made. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 806: All Oscilloscope Commands Are Sequential

    • Sequential commands finish their task before the execution of the next command starts. • Overlapped commands run concurrently. Commands following an overlapped command may be started before the overlapped command is completed. All of the oscilloscope commands are sequential. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 807: Programming Examples

    Example programs are ASCII text files that can be cut from the help file and pasted into your favorite text editor. See Also • You can find additional programming examples for the InfiniiVision 1000 X-Series oscilloscopes on the Keysight Technologies website at: www.keysight.com/find/1000X-Series-examples...

  • Page 808: Visa Com Examples

    Public myMgr As VisaComLib.ResourceManager Public myScope As VisaComLib.FormattedIO488 Public varQueryResult As Variant Public strQueryResult As String ' For Sleep subroutine. Private Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long) ' Main Program ' ------------------------------------------------------------------- Sub Main() Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 809 ' Clear status and load the default setup. DoCommand "*CLS" DoCommand "*RST" Exit Sub VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.Description End Sub ' Capture the waveform. ' ------------------------------------------------------------------- Private Sub Capture() Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 810 Debug.Print "Channel 1 vertical offset: " + _ DoQueryString(":CHANnel1:OFFSet?") ' Set horizontal scale and offset. DoCommand ":TIMebase:SCALe 0.0002" Debug.Print "Timebase scale: " + _ DoQueryString(":TIMebase:SCALe?") DoCommand ":TIMebase:POSition 0.0" Debug.Print "Timebase position: " + _ Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 811 MsgBox "Frequency:" + vbCrLf + _ FormatNumber(varQueryResult / 1000, 4) + " kHz" DoCommand ":MEASure:VAMPlitude" varQueryResult = DoQueryNumber(":MEASure:VAMPlitude?") MsgBox "Vertical amplitude:" + vbCrLf + _ FormatNumber(varQueryResult, 4) + " V" ' Download the screen image. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 812 Dim intType As Integer Dim lngPoints As Long Dim lngCount As Long Dim dblXIncrement As Double Dim dblXOrigin As Double Dim lngXReference As Long Dim sngYIncrement As Single Dim sngYOrigin As Single Dim lngYReference As Long Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 813 Debug.Print "Waveform Y increment: " + _ Format(sngYIncrement, "Scientific") Debug.Print "Waveform Y origin: " + _ FormatNumber(sngYOrigin, 0) Debug.Print "Waveform Y reference: " + _ FormatNumber(lngYReference, 0) ' Get the waveform data varQueryResult = DoQueryIEEEBlock_UI1(":WAVeform:DATA?") Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 814 MsgBox "VISA COM Error: " + vbCrLf + CStr(Err.Number) + ", " + _ Err.Source + ", " + _ Err.Description, vbExclamation, "VISA COM Error" End Sub Private Sub DoCommandIEEEBlock(command As String, data As Variant) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 815 MsgBox "VISA COM Error: " + vbCrLf + CStr(Err.Number) + ", " + _ Err.Source + ", " + _ Err.Description, vbExclamation, "VISA COM Error" End Function Private Function DoQueryNumbers(query As String) As Variant() On Error GoTo VisaComError Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 816 = strOut + "INST Error: " + strErrVal myScope.WriteString ":SYSTem:ERRor?" ' Request error message. strErrVal = myScope.ReadString ' Read error message. Wend If Not strOut = "" Then MsgBox strOut, vbExclamation, "INST Error Messages" myScope.FlushWrite (False) myScope.FlushRead End If Exit Sub Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 817: Visa Com Example In C

    * features of your Keysight oscilloscope. * ------------------------------------------------------------------- using System; using System.IO; using System.Text; using Ivi.Visa.Interop; using System.Runtime.InteropServices; namespace InfiniiVision class VisaComInstrumentApp private static VisaComInstrument myScope; public static void Main(string[] args) myScope = new Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 818 = myScope.DoQueryString("*IDN?"); Console.WriteLine("*IDN? result is: {0}", strResults); // Clear status and load the default setup. myScope.DoCommand("*CLS"); myScope.DoCommand("*RST"); * Capture the waveform. * -------------------------------------------------------------- private static void Capture() // Use auto-scale to automatically configure oscilloscope. myScope.DoCommand(":AUToscale"); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 819 Console.WriteLine("Channel 1 vertical offset: {0}", myScope.DoQueryString(":CHANnel1:OFFSet?")); // Set horizontal scale and offset. myScope.DoCommand(":TIMebase:SCALe 0.0002"); Console.WriteLine("Timebase scale: {0}", myScope.DoQueryString(":TIMebase:SCALe?")); myScope.DoCommand(":TIMebase:POSition 0.0"); Console.WriteLine("Timebase position: {0}", myScope.DoQueryString(":TIMebase:POSition?")); // Set the acquisition type (NORMal, PEAK, AVERage, or HRESolution Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 820 Console.WriteLine("Vertical amplitude: {0:F2} V", fResult); // Download the screen image. // ----------------------------------------------------------- myScope.DoCommand(":HARDcopy:INKSaver OFF"); // Get the screen data. ResultsArray = myScope.DoQueryIEEEBlock(":DISPlay:DATA? PNG, COLor"); nLength = ResultsArray.Length; // Store the screen data to a file. strPath = "c:\\scope\\data\\screen.png"; Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 821 Console.WriteLine("Waveform format: WORD"); else if (fFormat == 2.0) Console.WriteLine("Waveform format: ASCii"); double fType = fResultsArray[1]; if (fType == 0.0) Console.WriteLine("Acquire type: NORMal"); else if (fType == 1.0) Console.WriteLine("Acquire type: PEAK"); else if (fType == 2.0) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 822 (int i = 0; i < nLength - 1; i++) writer.WriteLine("{0:f9}, {1:f6}", fXorigin + ((float)i * fXincrement), (((float)ResultsArray[i] - fYreference) * fYincrement) + fYorigin); // Close output file. writer.Close(); Console.WriteLine("Waveform format BYTE data written to {0}", strPath); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 823 // Send the query. m_IoObject.WriteString(strQuery, true); // Get the result string. string strResults; strResults = m_IoObject.ReadString(); // Check for inst errors. CheckInstrumentErrors(strQuery); // Return results string. return strResults; public double DoQueryNumber(string strQuery) // Send the query. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 824 IEEEBinaryType.BinaryType_UI1, false, true); // Check for inst errors. CheckInstrumentErrors(strQuery); // Return results array. return ResultsArray; private void CheckInstrumentErrors(string strCommand) // Check for instrument errors. string strInstrumentError; bool bFirstError = true; // While not "0,No error". Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 825 = (IMessage)m_ResourceManager.Open(m_strVisaAddress, AccessMode.NO_LOCK, 0, ""); catch (Exception e) Console.WriteLine("An error occurred: {0}", e.Message); public void SetTimeoutSeconds(int nSeconds) m_IoObject.IO.Timeout = nSeconds * 1000; public void Close() m_IoObject.IO.Close(); catch { } Marshal.ReleaseComObject(m_IoObject); catch { } Marshal.ReleaseComObject(m_ResourceManager); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 826: Visa Com Example In Visual Basic .Net

    ' features of your Keysight oscilloscope. ' ------------------------------------------------------------------- Imports System Imports System.IO Imports System.Text Imports Ivi.Visa.Interop Imports System.Runtime.InteropServices Namespace InfiniiVision Class VisaComInstrumentApp Private Shared myScope As VisaComInstrument Public Shared Sub Main(ByVal args As String()) myScope = New VisaComInstrument("USB0::0x0957::0x17A6::US50210029::0::INSTR" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 827 ' Use auto-scale to automatically configure oscilloscope. myScope.DoCommand(":AUToscale") ' Set trigger mode (EDGE, PULSe, PATTern, etc., and input source. myScope.DoCommand(":TRIGger:MODE EDGE") Console.WriteLine("Trigger mode: {0}", _ myScope.DoQueryString(":TRIGger:MODE?")) ' Set EDGE trigger parameters. myScope.DoCommand(":TRIGger:EDGE:SOURCe CHANnel1") Console.WriteLine("Trigger edge source: {0}", _ myScope.DoQueryString(":TRIGger:EDGE:SOURce?")) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 828 ' Set the acquisition type (NORMal, PEAK, AVERage, or HRESolution) myScope.DoCommand(":ACQuire:TYPE NORMal") Console.WriteLine("Acquire type: {0}", _ myScope.DoQueryString(":ACQuire:TYPE?")) ' Or, configure by loading a previously saved setup. Dim DataArray As Byte() Dim nBytesWritten As Integer ' Read setup string from file. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 829 ' Store the screen data to a file. strPath = "c:\scope\data\screen.png" Dim fStream As FileStream fStream = File.Open(strPath, FileMode.Create) fStream.Write(ResultsArray, 0, nLength) fStream.Close() Console.WriteLine("Screen image ({0} bytes) written to {1}", _ nLength, strPath) ' Download waveform data. ' ------------------------------------------------------------ Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 830 Dim fCount As Double = fResultsArray(3) Console.WriteLine("Waveform average count: {0:e}", fCount) Dim fXincrement As Double = fResultsArray(4) Console.WriteLine("Waveform X increment: {0:e}", fXincrement) Dim fXorigin As Double = fResultsArray(5) Console.WriteLine("Waveform X origin: {0:e}", fXorigin) Dim fXreference As Double = fResultsArray(6) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 831 Private m_IoObject As FormattedIO488Class Private m_strVisaAddress As String ' Constructor. Public Sub New(ByVal strVisaAddress As String) ' Save VISA address in member variable. m_strVisaAddress = strVisaAddress ' Open the default VISA COM IO object. OpenIo() Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 832 ' Send the query. m_IoObject.WriteString(strQuery, True) ' Get the result number. Dim fResult As Double fResult = _ CDbl(m_IoObject.ReadNumber(IEEEASCIIType.ASCIIType_R8, True)) ' Check for inst errors. CheckInstrumentErrors(strQuery) ' Return result number. Return fResult End Function Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 833 If Not strInstrumentError.ToString().StartsWith("+0,") Then If bFirstError Then Console.WriteLine("ERROR(s) for command '{0}': ", _ strCommand) bFirstError = False End If Console.Write(strInstrumentError) End If Loop While Not strInstrumentError.ToString().StartsWith("+0,") End Sub Private Sub OpenIo() m_ResourceManager = New ResourceManagerClass() Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 834: Visa Com Example In Python

    If "python.exe" can be found via your PATH environment variable, open a Command Prompt window; then, change to the folder that contains the "example.py" file, and enter: python example.py # Keysight VISA COM Example in Python using "comtypes" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 835 # Use auto-scale to automatically set up oscilloscope. print "Autoscale." do_command(":AUToscale") # Set trigger mode. do_command(":TRIGger:MODE EDGE") qresult = do_query_string(":TRIGger:MODE?") print "Trigger mode: %s" % qresult # Set EDGE trigger parameters. do_command(":TRIGger:EDGE:SOURCe CHANnel1") qresult = do_query_string(":TRIGger:EDGE:SOURce?") Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 836 # Or, configure by loading a previously saved setup. f = open("c:\scope\config\setup.stp", "rb") setup_bytes = f.read() f.close() do_command_ieee_block(":SYSTem:SETup", array.array('B', setup_bytes)) print "Setup bytes restored: %d" % len(setup_bytes) # Capture an acquisition using :DIGitize. do_command(":DIGitize CHANnel1") # ========================================================= # Analyze: # ========================================================= Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 837 # Choose the format of the data returned: do_command(":WAVeform:FORMat BYTE") print "Waveform format: %s" % do_query_string(":WAVeform:FORMat?") # Display the waveform settings from preamble: wav_form_dict = { 0 : "BYTE", 1 : "WORD", 4 : "ASCii", acq_type_dict = { 0 : "NORMal", Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 838 = x_origin + (i * x_increment) voltage = (data_bytes[i] - y_reference) * y_increment + y_origin f.write("%E, %f\n" % (time_val, voltage)) # Close output file. f.close() print "Waveform format BYTE data written to %s." % strPath # ========================================================= Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 839 = myScope.ReadNumber(VisaComLib.ASCIIType_R8, True) check_instrument_errors(query) return result # ========================================================= # Send a query, check for errors, return values: # ========================================================= def do_query_numbers(query): myScope.WriteString("%s" % query, True) result = myScope.ReadList(VisaComLib.ASCIIType_R8, ",;") check_instrument_errors(query) return result # ========================================================= Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 840 # Set the Timeout to 15 seconds. myScope.IO.Timeout = 15000 # 15 seconds. print "Timeout set to 15000 milliseconds." # Initialize the oscilloscope, capture data, and analyze. initialize() capture() analyze() print "End of program" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 841: Visa Examples

    Show directories for Include files, and add the include directory (for example, Program Files (x86)\IVI Foundation\VISA\WinNT\Include). Show directories for Library files, and add the library files directory (for example, Program Files (x86)\IVI Foundation\VISA\WinNT\lib\msc). Click OK to close the Options dialog. Build and run the program. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 842 (err != VI_SUCCESS) error_handler(); /* Set the I/O timeout to fifteen seconds. */ err = viSetAttribute(vi, VI_ATTR_TMO_VALUE, 15000); if (err != VI_SUCCESS) error_handler(); /* Initialize - start from a known state. */ initialize(); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 843 /* Set EDGE trigger parameters. */ do_command(":TRIGger:EDGE:SOURCe CHANnel1"); do_query_string(":TRIGger:EDGE:SOURce?"); printf("Trigger edge source: %s\n", str_result); do_command(":TRIGger:EDGE:LEVel 1.5"); do_query_string(":TRIGger:EDGE:LEVel?"); printf("Trigger edge level: %s\n", str_result); do_command(":TRIGger:EDGE:SLOPe POSitive"); do_query_string(":TRIGger:EDGE:SLOPe?"); printf("Trigger edge slope: %s\n", str_result); /* Save oscilloscope configuration. */ Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 844 (%d bytes) from file ", num_bytes); printf("c:\\scope\\config\\setup.stp.\n"); /* Restore setup string. */ num_bytes = do_command_ieeeblock(":SYSTem:SETup", num_bytes); printf("Restored setup string (%d bytes).\n", num_bytes); /* Capture an acquisition using :DIGitize. */ do_command(":DIGitize CHANnel1"); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 845 (fp); printf("Wrote screen image (%d bytes) to ", num_bytes); printf("c:\\scope\\data\\screen.png.\n"); /* Download waveform data. * ------------------------------------------------------------- */ /* Set the waveform points mode. */ do_command(":WAVeform:POINts:MODE RAW"); do_query_string(":WAVeform:POINts:MODE?"); printf("Waveform points mode: %s\n", str_result); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 846 AVERage\n"); else if (acq_type == 3.0) printf("Acquire type: HRESolution\n"); wav_points = dbl_results[2]; printf("Waveform points: %e\n", wav_points); avg_count = dbl_results[3]; printf("Waveform average count: %e\n", avg_count); x_increment = dbl_results[4]; printf("Waveform X increment: %e\n", x_increment); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 847 * --------------------------------------------------------------- */ void do_command(command) char *command; char message[80]; strcpy(message, command); strcat(message, "\n"); err = viPrintf(vi, message); if (err != VI_SUCCESS) error_handler(); check_instrument_errors(); /* Command with IEEE definite-length block. * --------------------------------------------------------------- */ int do_command_ieeeblock(command, num_bytes) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 848 /* Query for a number result. * --------------------------------------------------------------- */ void do_query_number(query) char *query; char message[80]; strcpy(message, query); strcat(message, "\n"); err = viPrintf(vi, message); if (err != VI_SUCCESS) error_handler(); err = viScanf(vi, "%lf", &num_result); if (err != VI_SUCCESS) error_handler(); check_instrument_errors(); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 849 /* Check for instrument errors. * --------------------------------------------------------------- */ void check_instrument_errors() char str_err_val[256] = {0}; char str_out[800] = ""; err = viQueryf(vi, ":SYSTem:ERRor?\n", "%t", str_err_val); if (err != VI_SUCCESS) error_handler(); while(strncmp(str_err_val, "+0,No error", 3) != 0 ) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 850: Visa Example In Visual Basic

    Include), select it, and click Open. Choose Insert > Module. Cut-and-paste the code that follows into the editor. Edit the program to use the VISA address of your oscilloscope, and save the changes. Run the program. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 851 ' Set the I/O timeout to ten seconds. err = viSetAttribute(vi, VI_ATTR_TMO_VALUE, 10000) If (err <> VI_SUCCESS) Then HandleVISAError vi ' Initialize - start from a known state. Initialize ' Capture data. Capture ' Analyze the captured waveform. Analyze Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 852 Debug.Print "Trigger edge source: " + _ DoQueryString(":TRIGger:EDGE:SOURce?") DoCommand ":TRIGger:EDGE:LEVel 1.5" Debug.Print "Trigger edge level: " + _ DoQueryString(":TRIGger:EDGE:LEVel?") DoCommand ":TRIGger:EDGE:SLOPe POSitive" Debug.Print "Trigger edge slope: " + _ DoQueryString(":TRIGger:EDGE:SLOPe?") ' Save oscilloscope configuration. ' ----------------------------------------------------------------- Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 853 Dim lngSetupFileSize As Long lngSetupFileSize = LOF(hFile) ' Length of file. Get hFile, , byteArray ' Read data. Close hFile ' Close file. ' Write learn string back to oscilloscope using ":SYSTem:SETup" ' command: Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 854 Dim lngI As Long For lngI = 0 To lngBlockSize - 1 Put hFile, , byteArray(lngI) ' Write data. Next lngI Close hFile ' Close file. MsgBox "Screen image written to " + strPath Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 855 = dblArray(7) lngYOrigin = dblArray(8) lngYReference = dblArray(9) If intFormat = 0 Then Debug.Print "Waveform format: BYTE" ElseIf intFormat = 1 Then Debug.Print "Waveform format: WORD" ElseIf intFormat = 2 Then Debug.Print "Waveform format: ASCii" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 856 Dim lngDataValue As Long For lngI = 0 To lngNumBytes - 1 lngDataValue = CLng(byteArray(lngI)) ' Write time value, voltage value. Print #hFile, _ FormatNumber(dblXOrigin + (lngI * dblXIncrement), 9) + _ ", " + _ Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 857 = viVPrintf(vi, query + vbLf, 0) If (err <> VI_SUCCESS) Then HandleVISAError vi err = viVScanf(vi, "%t", strResult) If (err <> VI_SUCCESS) Then HandleVISAError vi DoQueryString = strResult CheckInstrumentErrors End Function Private Function DoQueryNumber(query As String) As Variant Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 858 = VarPtr(byteArray(0)) ' Set retCount to max number of elements array can hold. retCount = ByteArraySize ' Get unsigned integer bytes. err = viVScanf(vi, "%#b" + vbLf, paramsArray(0)) If (err <> VI_SUCCESS) Then HandleVISAError vi Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 859 = viFlush(vi, VI_READ_BUF) If (err <> VI_SUCCESS) Then HandleVISAError vi err = viFlush(vi, VI_WRITE_BUF) If (err <> VI_SUCCESS) Then HandleVISAError vi End If Exit Sub ErrorHandler: MsgBox "*** Error : " + Error, vbExclamation End Sub Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 860: Visa Example In C

    Help that comes with Keysight IO Libraries Suite. * Keysight VISA Example in C# * ------------------------------------------------------------------- * This program illustrates a few commonly used programming * features of your Keysight oscilloscope. * ------------------------------------------------------------------- using System; using System.IO; using System.Text; Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 861 * Initialize the oscilloscope to a known state. * -------------------------------------------------------------- private static void Initialize() StringBuilder strResults; // Get and display the device's *IDN? string. strResults = myScope.DoQueryString("*IDN?"); Console.WriteLine("*IDN? result is: {0}", strResults); // Clear status and load the default setup. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 862 Console.WriteLine("Setup bytes saved: {0}", nLength); // Change settings with individual commands: // Set vertical scale and offset. myScope.DoCommand(":CHANnel1:SCALe 0.05"); Console.WriteLine("Channel 1 vertical scale: {0}", myScope.DoQueryString(":CHANnel1:SCALe?")); myScope.DoCommand(":CHANnel1:OFFSet -1.5"); Console.WriteLine("Channel 1 vertical offset: {0}", myScope.DoQueryString(":CHANnel1:OFFSet?")); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 863 // Make a couple of measurements. // ----------------------------------------------------------- myScope.DoCommand(":MEASure:SOURce CHANnel1"); Console.WriteLine("Measure source: {0}", myScope.DoQueryString(":MEASure:SOURce?")); double fResult; myScope.DoCommand(":MEASure:FREQuency"); fResult = myScope.DoQueryNumber(":MEASure:FREQuency?"); Console.WriteLine("Frequency: {0:F4} kHz", fResult / 1000); myScope.DoCommand(":MEASure:VAMPlitude"); fResult = myScope.DoQueryNumber(":MEASure:VAMPlitude?"); Console.WriteLine("Vertical amplitude: {0:F2} V", fResult); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 864 // Display the waveform settings: double[] fResultsArray; fResultsArray = myScope.DoQueryNumbers(":WAVeform:PREamble?"); double fFormat = fResultsArray[0]; if (fFormat == 0.0) Console.WriteLine("Waveform format: BYTE"); else if (fFormat == 1.0) Console.WriteLine("Waveform format: WORD"); else if (fFormat == 2.0) Console.WriteLine("Waveform format: ASCii"); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 865 // Set up output file: strPath = "c:\\scope\\data\\waveform_data.csv"; if (File.Exists(strPath)) File.Delete(strPath); // Open file for output. StreamWriter writer = File.CreateText(strPath); // Output waveform data in CSV format. for (int i = 0; i < nLength - 1; i++) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 866 // Send the command to the device. string strCommandAndLength; int nViStatus, nLength, nBytesWritten; nLength = DataArray.Length; strCommandAndLength = String.Format("{0} #8%08d", strCommand); // Write first part of command to formatted I/O write buffer. nViStatus = visa32.viPrintf(m_nSession, strCommandAndLength, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 867 // Check for inst errors. CheckInstrumentErrors(strQuery); // Return string results. return fResults; public double[] DoQueryNumbers(string strQuery) // Send the query. VisaSendCommandOrQuery(strQuery); // Get the result string. double[] fResultsArray; fResultsArray = VisaGetResultNumbers(); // Check for inst errors. CheckInstrumentErrors(strQuery); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 868 = visa32.viScanf(m_nSession, "%1000t", strResults); CheckVisaStatus(nViStatus); return strResults; private double VisaGetResultNumber() double fResults = 0; // Read return value string from the device. int nViStatus; nViStatus = visa32.viScanf(m_nSession, "%lf", out fResults); CheckVisaStatus(nViStatus); return fResults; private double[] VisaGetResultNumbers() Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 869 // Check for instrument errors. StringBuilder strInstrumentError = new StringBuilder(1000); bool bFirstError = true; // While not "0,No error" VisaSendCommandOrQuery(":SYSTem:ERRor?"); strInstrumentError = VisaGetResultString(); if (!strInstrumentError.ToString().StartsWith("+0,")) if (bFirstError) Console.WriteLine("ERROR(s) for command '{0}': ", strCommand); bFirstError = false; Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 870 // If VISA error, throw exception. if (nViStatus < visa32.VI_SUCCESS) StringBuilder strError = new StringBuilder(256); visa32.viStatusDesc(this.m_nResourceManager, nViStatus, strError); throw new ApplicationException(strError.ToString()); public void Close() if (m_nSession != 0) visa32.viClose(m_nSession); if (m_nResourceManager != 0) visa32.viClose(m_nResourceManager); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 871: Visa Example In Visual Basic .Net

    ' features of your Keysight oscilloscope. ' ------------------------------------------------------------------- Imports System Imports System.IO Imports System.Text Namespace InfiniiVision Class VisaInstrumentApp Private Shared myScope As VisaInstrument Public Shared Sub Main(ByVal args As String()) myScope = _ New VisaInstrument("USB0::0x0957::0x17A6::US50210029::0::INSTR ") myScope.SetTimeoutSeconds(10) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 872 ' Set trigger mode (EDGE, PULSe, PATTern, etc., and input source. myScope.DoCommand(":TRIGger:MODE EDGE") Console.WriteLine("Trigger mode: {0}", _ myScope.DoQueryString(":TRIGger:MODE?")) ' Set EDGE trigger parameters. myScope.DoCommand(":TRIGger:EDGE:SOURCe CHANnel1") Console.WriteLine("Trigger edge source: {0}", _ myScope.DoQueryString(":TRIGger:EDGE:SOURce?")) myScope.DoCommand(":TRIGger:EDGE:LEVel 1.5") Console.WriteLine("Trigger edge level: {0}", _ Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 873 Console.WriteLine("Acquire type: {0}", _ myScope.DoQueryString(":ACQuire:TYPE?")) ' Or, configure by loading a previously saved setup. Dim DataArray As Byte() Dim nBytesWritten As Integer ' Read setup string from file. strPath = "c:\scope\config\setup.stp" DataArray = File.ReadAllBytes(strPath) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 874 Dim fStream As FileStream fStream = File.Open(strPath, FileMode.Create) fStream.Write(ResultsArray, 0, nLength) fStream.Close() Console.WriteLine("Screen image ({0} bytes) written to {1}", _ nLength, strPath) ' Download waveform data. ' ------------------------------------------------------------ ' Set the waveform points mode. myScope.DoCommand(":WAVeform:POINts:MODE RAW") Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 875 Console.WriteLine("Waveform average count: {0:e}", fCount) Dim fXincrement As Double = fResultsArray(4) Console.WriteLine("Waveform X increment: {0:e}", fXincrement) Dim fXorigin As Double = fResultsArray(5) Console.WriteLine("Waveform X origin: {0:e}", fXorigin) Dim fXreference As Double = fResultsArray(6) Console.WriteLine("Waveform X reference: {0:e}", fXreference) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 876 Private m_strVisaAddress As String ' Constructor. Public Sub New(ByVal strVisaAddress As String) ' Save VISA address in member variable. m_strVisaAddress = strVisaAddress ' Open the default VISA resource manager. OpenResourceManager() ' Open a VISA resource session. OpenSession() Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 877 As StringBuilder ' Send the query. VisaSendCommandOrQuery(strQuery) ' Get the result string. Dim strResults As New StringBuilder(1000) strResults = VisaGetResultString() ' Check for inst errors. CheckInstrumentErrors(strQuery) ' Return string results. Return strResults End Function Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 878 End Function Private Sub VisaSendCommandOrQuery(ByVal strCommandOrQuery _ As String) ' Send command or query to the device. Dim strWithNewline As String strWithNewline = [String].Format("{0}" & Chr(10) & "", _ strCommandOrQuery) Dim nViStatus As Integer Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 879 ' Read return value string from the device. Dim nViStatus As Integer nViStatus = visa32.viScanf(m_nSession, "%#b", length, _ ResultsArray) CheckVisaStatus(nViStatus) ' Write and read buffers need to be flushed after IEEE block? nViStatus = visa32.viFlush(m_nSession, visa32.VI_WRITE_BUF) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 880 * 1000) CheckVisaStatus(nViStatus) End Sub Public Sub CheckVisaStatus(ByVal nViStatus As Integer) ' If VISA error, throw exception. If nViStatus < visa32.VI_SUCCESS Then Dim strError As New StringBuilder(256) visa32.viStatusDesc(Me.m_nResourceManager, nViStatus, strError) Throw New ApplicationException(strError.ToString()) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 881: Visa Example In Python (Pyvisa 1.5 And Older)

    # Global variables (booleans: 0 = False, 1 = True). # --------------------------------------------------------- debug = 0 # ========================================================= # Initialize: # ========================================================= def initialize(): # Get and display the device's *IDN? string. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 882 # Set vertical scale and offset. do_command(":CHANnel1:SCALe 0.05") qresult = do_query_values(":CHANnel1:SCALe?")[0] print "Channel 1 vertical scale: %f" % qresult do_command(":CHANnel1:OFFSet -1.5") qresult = do_query_values(":CHANnel1:OFFSet?")[0] print "Channel 1 offset: %f" % qresult # Set horizontal scale and offset. do_command(":TIMebase:SCALe 0.0002") Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 883 # Download the screen image. # -------------------------------------------------------- do_command(":HARDcopy:INKSaver OFF") sDisplay = do_query_string(":DISPlay:DATA? PNG, COLor") sDisplay = get_definite_length_block_data(sDisplay) # Save display data values to file. f = open("screen_image.png", "wb") f.write(sDisplay) f.close() print "Screen image written to screen_image.png." Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 884 "Waveform Y increment: %s" % y_increment print "Waveform Y origin: %s" % y_origin print "Waveform Y reference: %s" % y_reference # Get numeric values for later calculations. x_increment = do_query_values(":WAVeform:XINCrement?")[0] x_origin = do_query_values(":WAVeform:XORigin?")[0] y_increment = do_query_values(":WAVeform:YINCrement?")[0] y_origin = do_query_values(":WAVeform:YORigin?")[0] Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 885 # Send a query, check for errors, return string: # ========================================================= def do_query_string(query): if debug: print "Qys = '%s'" % query result = InfiniiVision.ask("%s\n" % query) check_instrument_errors(query) return result # ========================================================= # Send a query, check for errors, return values: # ========================================================= Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 886 # Second character is number of following digits for length value. digits = sBlock[1:2] # Get the data out of the block and return it. sData = sBlock[int(digits) + 2:] return sData # ========================================================= # Main program: Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 887: Visa Example In Python (Pyvisa 1.6 And Newer)

    # Import modules. # --------------------------------------------------------- import visa import string import struct import sys # Global variables (booleans: 0 = False, 1 = True). # --------------------------------------------------------- debug = 0 # ========================================================= # Initialize: # ========================================================= def initialize(): Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 888 # Set vertical scale and offset. do_command(":CHANnel1:SCALe 0.05") qresult = do_query_string(":CHANnel1:SCALe?") print "Channel 1 vertical scale: %s" % qresult do_command(":CHANnel1:OFFSet -1.5") qresult = do_query_string(":CHANnel1:OFFSet?") print "Channel 1 offset: %s" % qresult # Set horizontal scale and offset. do_command(":TIMebase:SCALe 0.0002") Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 889 # -------------------------------------------------------- do_command(":HARDcopy:INKSaver OFF") sDisplay = do_query_ieee_block(":DISPlay:DATA? PNG, COLor") # Save display data values to file. f = open("screen_image.png", "wb") f.write(sDisplay) f.close() print "Screen image written to screen_image.png." # Download waveform data. # -------------------------------------------------------- Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 890 "Waveform Y origin: %s" % y_origin print "Waveform Y reference: %s" % y_reference # Get numeric values for later calculations. x_increment = do_query_number(":WAVeform:XINCrement?") x_origin = do_query_number(":WAVeform:XORigin?") y_increment = do_query_number(":WAVeform:YINCrement?") y_origin = do_query_number(":WAVeform:YORigin?") y_reference = do_query_number(":WAVeform:YREFerence?") Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 891 "Cmb = '%s'" % command InfiniiVision.write_binary_values("%s " % command, values, datatype='c' check_instrument_errors(command) # ========================================================= # Send a query, check for errors, return string: # ========================================================= def do_query_string(query): if debug: print "Qys = '%s'" % query Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 892 # "No error" break else: # :SYSTem:ERRor? should always return string. print "ERROR: :SYSTem:ERRor? returned nothing, command: '%s'" % comma print "Exited because of error." sys.exit(1) # ========================================================= # Main program: # ========================================================= rm = visa.ResourceManager() Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 893 Programming Examples InfiniiVision= rm.open_resource("USB0::0x2A8D::0x1797::CN56240004::0::IN STR") InfiniiVision.timeout = 15000 InfiniiVision.clear() # Initialize the oscilloscope, capture data, and analyze. initialize() capture() analyze() print "End of program." Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 894: Visa.net Examples

    * Keysight VISA.NET Example in C# * ------------------------------------------------------------------- * This program illustrates a few commonly used programming * features of your Keysight InfiniiVision oscilloscope. * ------------------------------------------------------------------- using System; using System.IO; using System.Collections.Generic; using System.Text; using Ivi.Visa; using Ivi.Visa.FormattedIO; Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 895 FileStream fStream; // Get and display the device's *IDN? string. myScope.WriteLine("*IDN?"); strResults = myScope.ReadLine(); Console.WriteLine("*IDN? result is: {0}", strResults); // Clear status and load the default setup. myScope.WriteLine("*CLS"); myScope.WriteLine("*RST"); // Capture data. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 896 // Set vertical scale and offset. myScope.WriteLine(":CHANnel1:SCALe 0.05"); myScope.WriteLine(":CHANnel1:SCALe?"); strResults = myScope.ReadLine(); Console.WriteLine("Channel 1 vertical scale: {0}", strResults); myScope.WriteLine(":CHANnel1:OFFSet -1.5"); myScope.WriteLine(":CHANnel1:OFFSet?"); strResults = myScope.ReadLine(); Console.WriteLine("Channel 1 vertical offset: {0}", strResults); // Set horizontal scale and offset. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 897 = myScope.ReadLine(); Console.WriteLine("Measure source: {0}", strResults); double fResult; myScope.WriteLine(":MEASure:FREQuency"); myScope.WriteLine(":MEASure:FREQuency?"); fResult = myScope.ReadLineDouble(); Console.WriteLine("Frequency: {0:F4} kHz", fResult / 1000); myScope.WriteLine(":MEASure:VAMPlitude"); myScope.WriteLine(":MEASure:VAMPlitude?"); fResult = myScope.ReadLineDouble(); Console.WriteLine("Vertical amplitude: {0:F2} V", fResult); // Download the screen image. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 898 // Display the waveform settings: double[] fResultsArray; myScope.WriteLine(":WAVeform:PREamble?"); fResultsArray = myScope.ReadLineListOfDouble(); double fFormat = fResultsArray[0]; if (fFormat == 0.0) Console.WriteLine("Waveform format: BYTE"); else if (fFormat == 1.0) Console.WriteLine("Waveform format: WORD"); else if (fFormat == 2.0) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 899 Console.WriteLine("Waveform Y reference: {0:e}", fYreference); // Read waveform data. myScope.WriteLine(":WAVeform:DATA?"); ResultsArray = myScope.ReadLineBinaryBlockOfByte(); nLength = ResultsArray.Length; Console.WriteLine("Number of data values: {0}", nLength); // Set up output file: strPath = "c:\\scope\\data\\waveform_data.csv"; if (File.Exists(strPath)) File.Delete(strPath); // Open file for output. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 900: Visa.net Example In Visual Basic .Net

    Explorer window of the Microsoft Visual Studio environment. Choose Add Reference..In the Add Reference dialog, select the Browse tab, and navigate to the ScpiNetDrivers folder. • Windows XP: C:\Documents and Settings\All Users\Agilent\Command Expert\ScpiNetDrivers Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 901 ' ------------------------------------------------------------------- Imports System Imports System.IO Imports System.Collections.Generic Imports System.Text Imports Ivi.Visa Imports Ivi.Visa.FormattedIO Namespace Example Class Program Public Shared Sub Main(args As String()) ' Change this variable to the address of your instrument Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 902 ' Use auto-scale to automatically configure oscilloscope. myScope.WriteLine(":AUToscale") ' Set trigger mode (EDGE, PULSe, PATTern, etc., and input source. myScope.WriteLine(":TRIGger:MODE EDGE") myScope.WriteLine(":TRIGger:MODE?") strResults = myScope.ReadLine() Console.WriteLine("Trigger mode: {0}", strResults) ' Set EDGE trigger parameters. myScope.WriteLine(":TRIGger:EDGE:SOURce CHANnel1") Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 903 = myScope.ReadLine() Console.WriteLine("Channel 1 vertical offset: {0}", strResults) ' Set horizontal scale and offset. myScope.WriteLine(":TIMebase:SCALe 0.0002") myScope.WriteLine(":TIMebase:SCALe?") strResults = myScope.ReadLine() Console.WriteLine("Timebase scale: {0}", strResults) myScope.WriteLine(":TIMebase:POSition 0.0") myScope.WriteLine(":TIMebase:POSition?") strResults = myScope.ReadLine() Console.WriteLine("Timebase position: {0}", strResults) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 904 ' Download the screen image. ' ----------------------------------------------------------- myScope.WriteLine(":HARDcopy:INKSaver OFF") ' Get the screen data. myScope.WriteLine(":DISPlay:DATA? PNG, COLor") ResultsArray = myScope.ReadLineBinaryBlockOfByte() nLength = ResultsArray.Length ' Store the screen data to a file. strPath = "c:\scope\data\screen.png" Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 905 If fType = 0.0 Then Console.WriteLine("Acquire type: NORMal") ElseIf fType = 1.0 Then Console.WriteLine("Acquire type: PEAK") ElseIf fType = 2.0 Then Console.WriteLine("Acquire type: AVERage") ElseIf fType = 3.0 Then Console.WriteLine("Acquire type: HRESolution") End If Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 906 * fYincrement) + fYorigin) Next ' Close output file. writer.Close() Console.WriteLine("Waveform format BYTE data written to {0}", _ strPath) ' Close the connection to the instrument ' -------------------------------------------------------------- session.Dispose() Console.WriteLine("Press any key to exit...") Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 907: Visa.net Example In Ironpython

    System.Text import * from System.Runtime.InteropServices import * import clr clr.AddReference("Ivi.Visa") from Ivi.Visa import * from Ivi.Visa.FormattedIO import * # ========================================================= # Initialize: # ========================================================= def initialize(): # Get and display the device's *IDN? string. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 908 "Setup bytes saved: %d" % len(setup_bytes) # Change settings with individual commands: # Set vertical scale and offset. myScope.WriteLine(":CHANnel1:SCALe 0.05") myScope.WriteLine(":CHANnel1:SCALe?") qresult = myScope.ReadLine() print "Channel 1 vertical scale: %s" % qresult myScope.WriteLine(":CHANnel1:OFFSet -1.5") myScope.WriteLine(":CHANnel1:OFFSet?") qresult = myScope.ReadLine() Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 909 "Measure source: %s" % qresult myScope.WriteLine(":MEASure:FREQuency") myScope.WriteLine(":MEASure:FREQuency?") qresult = myScope.ReadLineDouble() print "Measured frequency on channel 1: %f" % qresult myScope.WriteLine(":MEASure:VAMPlitude") myScope.WriteLine(":MEASure:VAMPlitude?") qresult = myScope.ReadLineDouble() print "Measured vertical amplitude on channel 1: %f" % qresult Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 910 1 : "WORD", 4 : "ASCii", acq_type_dict = { 0 : "NORMal", 1 : "PEAK", 2 : "AVERage", 3 : "HRESolution", myScope.WriteLine(":WAVeform:PREamble?") wav_form, acq_type, wfmpts, avgcnt, x_increment, x_origin, x_reference, y_increment, y_origin, y_reference ) = string.split(myScope.ReadLine(), ",") Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 911 "Waveform format BYTE data written to %s." % strPath # ========================================================= # Main program: # ========================================================= addr = "USB0::0x2A8D::0x1797::CN56240004::0::INSTR" session = GlobalResourceManager.Open(addr) session.TimeoutMilliseconds = 20000 myScope = MessageBasedFormattedIO(session) # Initialize the oscilloscope, capture data, and analyze. initialize() capture() analyze() Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 912 Programming Examples # Close the connection to the instrument session.Dispose() print "End of program." # Wait for a key press before exiting. print "Press any key to exit..." Console.ReadKey(True) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 913: Sicl Examples

    Click OK to close the Options dialog. Build and run the program. * Keysight SICL Example in C * ------------------------------------------------------------------ * This program illustrates a few commonly-used programming * features of your Keysight oscilloscope. #include <stdio.h> /* For printf(). */ Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 914 /* Open a device session using the SICL_ADDRESS */ id = iopen(SICL_ADDRESS); if (id == 0) printf ("Oscilloscope iopen failed!\n"); else printf ("Oscilloscope session opened!\n"); /* Initialize - start from a known state. */ initialize(); /* Capture data. */ capture(); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 915 /* Set trigger mode (EDGE, PULSe, PATTern, etc., and input source. */ do_command(":TRIGger:MODE EDGE"); do_query_string(":TRIGger:MODE?"); printf("Trigger mode: %s\n", str_result); /* Set EDGE trigger parameters. */ do_command(":TRIGger:EDGE:SOURCe CHANnel1"); do_query_string(":TRIGger:EDGE:SOURce?"); printf("Trigger edge source: %s\n", str_result); do_command(":TRIGger:EDGE:LEVel 1.5"); do_query_string(":TRIGger:EDGE:LEVel?"); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 916 * ------------------------------------------------------------- */ /* Read setup string from file. */ fp = fopen ("c:\\scope\\config\\setup.stp", "rb"); num_bytes = fread (ieeeblock_data, sizeof(unsigned char), IEEEBLOCK_SPACE, fp); fclose (fp); printf("Read setup string (%d bytes) from file ", num_bytes); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 917 /* Read screen image. */ num_bytes = do_query_ieeeblock(":DISPlay:DATA? PNG, COLor"); printf("Screen image bytes: %d\n", num_bytes); /* Write screen image bytes to file. */ fp = fopen ("c:\\scope\\data\\screen.png", "wb"); num_bytes = fwrite(ieeeblock_data, sizeof(unsigned char), num_bytes, fp); fclose (fp); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 918 ASCii\n"); acq_type = dbl_results[1]; if (acq_type == 0.0) printf("Acquire type: NORMal\n"); else if (acq_type == 1.0) printf("Acquire type: PEAK\n"); else if (acq_type == 2.0) printf("Acquire type: AVERage\n"); else if (acq_type == 3.0) Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 919 (((float)ieeeblock_data[i] - y_reference) * y_increment) + y_origin); /* Close output file. */ fclose(fp); printf("Waveform format BYTE data written to "); printf("c:\\scope\\data\\waveform_data.csv.\n"); /* Send a command to the instrument. * --------------------------------------------------------------- */ void do_command(command) char *command; char message[80]; Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 920 "\n"); iprintf(id, message); iscanf(id, "%t\n", str_result); check_instrument_errors(); /* Query for a number result. * --------------------------------------------------------------- */ void do_query_number(query) char *query; char message[80]; strcpy(message, query); strcat(message, "\n"); iprintf(id, message); iscanf(id, "%lf", &num_result); check_instrument_errors(); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 921 /* Check for instrument errors. * --------------------------------------------------------------- */ void check_instrument_errors() char str_err_val[256] = {0}; char str_out[800] = ""; ipromptf(id, ":SYSTem:ERRor?\n", "%t", str_err_val); while(strncmp(str_err_val, "+0,No error", 3) != 0 ) strcat(str_out, ", "); strcat(str_out, str_err_val); ipromptf(id, ":SYSTem:ERRor?\n", "%t", str_err_val); Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 922: Sicl Example In Visual Basic

    Public Const ByteArraySize = 5000000 Public retCount As Long Public byteArray(ByteArraySize) As Byte ' Declare fixed length string variable to hold string value returned ' by ivscanf. Public strQueryResult As String * 200 ' For Sleep subroutine. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 923 ' Get and display the device's *IDN? string. strQueryResult = DoQueryString("*IDN?") MsgBox "Result is: " + RTrim(strQueryResult), vbOKOnly, "*IDN? Result" ' Clear status and load the default setup. DoCommand "*CLS" DoCommand "*RST" Exit Sub ErrorHandler: Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 924 = FreeFile Open strPath For Binary Access Write Lock Write As hFile Dim lngI As Long For lngI = 0 To lngSetupStringSize - 1 Put hFile, , byteArray(lngI) ' Write data. Next lngI Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 925 Debug.Print "Setup bytes restored: " + CStr(lngRestored) ' Capture an acquisition using :DIGitize. ' ----------------------------------------------------------------- DoCommand ":DIGitize CHANnel1" Exit Sub ErrorHandler: MsgBox "*** Error : " + Error, vbExclamation End Sub ' Analyze the captured waveform. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 926 MsgBox "Screen image written to " + strPath ' Download waveform data. ' ----------------------------------------------------------------- ' Set the waveform points mode. DoCommand ":WAVeform:POINts:MODE RAW" Debug.Print "Waveform points mode: " + _ DoQueryString(":WAVeform:POINts:MODE?") ' Get the number of waveform points available. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 927 If intType = 0 Then Debug.Print "Acquisition type: NORMal" ElseIf intType = 1 Then Debug.Print "Acquisition type: PEAK" ElseIf intType = 2 Then Debug.Print "Acquisition type: AVERage" ElseIf intType = 3 Then Debug.Print "Acquisition type: HRESolution" End If Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 928 ", " + _ FormatNumber(((lngDataValue - lngYReference) * _ sngYIncrement) + sngYOrigin) Next lngI ' Close output file. Close hFile ' Close file. MsgBox "Waveform format BYTE data written to " + _ "c:\scope\data\waveform_data.csv." Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 929 ' retCount is now actual number of bytes written. DoCommandIEEEBlock = retCount CheckInstrumentErrors Exit Function ErrorHandler: MsgBox "*** Error : " + Error, vbExclamation End Function Private Function DoQueryString(query As String) As String Dim actual As Long On Error GoTo ErrorHandler Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 930 On Error GoTo ErrorHandler Dim dblResults(10) As Double Call ivprintf(id, query + vbLf) Call ivscanf(id, "%,10lf" + vbLf, dblResults) DoQueryNumbers = dblResults CheckInstrumentErrors Exit Function ErrorHandler: MsgBox "*** Error : " + Error, vbExclamation Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 931 ' End if find: +0,"No Error". strOut = strOut + "INST Error: " + strErrVal Call ivprintf(id, ":SYSTem:ERRor?" + vbLf) ' Request error message Call ivscanf(id, "%200t", strErrVal) ' Read error message. Wend If Not strOut = "" Then Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 932 Programming Examples MsgBox strOut, vbExclamation, "INST Error Messages" Call iflush(id, I_BUF_READ Or I_BUF_WRITE) End If Exit Sub ErrorHandler: MsgBox "*** Error : " + Error, vbExclamation End Sub Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 933: Scpi.net Examples

    NI LabVIEW, Microsoft Excel, Keysight VEE, and Keysight SystemVue. To download the Keysight Command Expert software, see: http://www.keysight.com/find/commandexpert For more on programming with the SCPI.NET drivers, see "Using SCPI.NET Drivers" in the help that comes with Keysight Command Expert. Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 934 Programming Examples Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

  • Page 935: Index

    AER (Arm Event Register), 136, 150, 152, automask source, automask units, all (snapshot) measurement, automatic measurements constants, ALL segments waveform save option, automatic probe type detection, 719, C, SICL library example, AM demo signal, autoscale, C, VISA library example, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 936 VISA library example in C, COUPling demo signal, characters to display, code, VISA library example in C#, coupling for channels, classes of input signals, 270, code, VISA library example in Python, 881, create automask, classifications, command, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 937 :ACQuire:COMPlete, divide math function, definite-length block query response, example code, :ACQuire:SEGMented, DNS IP, definite-length block response data, example code, :ACQuire:TYPE, domain, delay measured to calculate phase, example code, :AUToscale, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 938 261, 268, 270, 291, 293, resolution, 270, frequency, 295, 297, 303, 309, hardcopy, 158, frequency response analysis, sweep start FF values in waveform data, HARDcopy commands, frequency, hardcopy factors, 315, hardcopy filename, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 939 LINE trigger level, image, save, LINE trigger source, image, save with inksaver, list of channel labels, impedance, load utilization (CAN), infinity representation, local lockout, initialization, 38, key disable, lock, initialize, 121, lock mask to signal, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 940 680, mask statistics, reset, value, modulation (waveform generator), mask test commands, measurements, maximum vertical value, enabling/disabling, Mask Test Event Enable Register time of, 396, modulation type, waveform generator, (MTEenable), Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 941 182, 645, output queue clear, nwidth, points in waveform data, output sequence, points per decade, frequency response overlapped commands, analysis, overload, points, frequency response analysis, Overload Event Enable Register (OVL), polarity, 534, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 942 120, 433, pulse width trigger level, rise time of positive edge, RECall commands, pulse width triggering, rising edge count measurement, recall filename, 435, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 943 129, 143, 159, segmented waveform save option, analysis, start and stop edges, segments, analyze, single-ended probe heads, start cursor, segments, count of waveform, single-ended signal type, start measurement, segments, setting number of memory, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 944 IIC pattern data, temporary message, TRG (Trigger), 126, 128, trigger, IIC pattern data 2, TER (Trigger Event Register), 164, trigger armed event register, 150, trigger, IIC qualifier, termination conditions, mask test, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 945 UART base, vertical peak-to-peak measured on Wait Trig bit, 150, UART baud rate, waveform, warranty, UART bit order, vertical scale, 219, 266, waveform base value measured, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...
  • Page 946 Y1, mask scaling, waveform, X reference, Y2 cursor, 326, 332, 337, waveform, Y increment, Y2, mask scaling, waveform, Y origin, Y-axis value, waveform, Y reference, Y-increment, WAVeform:FORMat, Y-origin, 666, waveforms, mask test run, Y-reference, Keysight InfiniiVision DSOX1204A/G Oscilloscopes Programmer's Guide...

This manual is also suitable for:

Infiniivision dsox1204g

Table of Contents

Save PDF