Agilent Technologies InfiniiVision 2000 X-Series Скачать руководство пользователя страница 846

Страница: 846 / 930

846

Agilent InfiniiVision 2000 X-Series Oscilloscopes Programmer's Guide

Programming Examples

' Capture an acquisition using :DIGitize.

' -----------------------------------------------------------------

DoCommand ":DIGitize CHANnel1"

End Sub

' Analyze the captured waveform.

' -------------------------------------------------------------------

Private Sub Analyze()

' Make a couple of measurements.

' -----------------------------------------------------------------

DoCommand ":MEASure:SOURce CHANnel1"

Debug.Print "Measure source: " + _

DoQueryString(":MEASure:SOURce?")

DoCommand ":MEASure:FREQuency"

dblQueryResult = DoQueryNumber(":MEASure:FREQuency?")

MsgBox "Frequency:" + _

FormatNumber(dblQueryResult / 1000, 4) + " kHz"

DoCommand ":MEASure:VAMPlitude"

dblQueryResult = DoQueryNumber(":MEASure:VAMPlitude?")

MsgBox "Vertial amplitude:" + _

FormatNumber(dblQueryResult, 4) + " V"

' Download the screen image.

' -----------------------------------------------------------------

DoCommand ":HARDcopy:INKSaver OFF"

' Get screen image.

Dim lngBlockSize As Long

lngBlockSize = DoQueryIEEEBlock_Bytes(":DISPlay:DATA? PNG, COLor")

Debug.Print "Screen image bytes: " + CStr(lngBlockSize)

' Save screen image to a file:

Dim strPath As String

strPath = "c:\scope\data\screen.png"

If Len(Dir(strPath)) Then

Kill strPath

' Remove file if it exists.

End If

Dim hFile As Long

hFile = FreeFile

Open strPath For Binary Access Write Lock Write As hFile

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

' Download waveform data.

Содержание InfiniiVision 2000 X-Series

Страница 1: ...s1 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide...

Страница 2: ...terms of such license Restricted Rights Legend If software is for use in the performance of a U S Government prime contract or sub contract Software is delivered and licensed as Commercial computer s...

Страница 3: ...messages Chapter 5 Common Commands starting on page 121 describes commands defined by the IEEE 488 2 standard that are common to all instruments Chapter 6 Root Commands starting on page 147 describes...

Страница 4: ...t Chapter 16 FUNCtion Commands starting on page 277 describes commands that control math waveforms Chapter 17 HARDcopy Commands starting on page 295 describes commands that set and query the selection...

Страница 5: ...3 describes commands that control reference waveforms Chapter 33 Obsolete and Discontinued Commands starting on page 703 describes obsolete commands which still work but have been replaced by newer co...

Страница 6: ...nformation on using the SICL VISA and VISA COM libraries in general see the documentation that comes with the Agilent IO Libraries Suite For information on controller PC interface configuration see th...

Страница 7: ...n Version 1 10 33 Version 1 00 at Introduction 34 Command Differences From 7000B Series Oscilloscopes 35 2 Setting Up Step 1 Install Agilent IO Libraries Suite software 40 Step 2 Connect and set up th...

Страница 8: ...te Length Block Query Response Data 58 Sending Multiple Queries and Reading Results 59 Checking Instrument Status 60 Other Ways of Sending Commands 61 Telnet Sockets 61 Sending SCPI Commands Using Bro...

Страница 9: ...nable Mask Test Event Enable Register 161 MTERegister EVENt Mask Test Event Event Register 163 OPEE Operation Status Enable Register 165 OPERegister CONDition Operation Status Condition Register 167 O...

Страница 10: ...ut 211 CALibrate PROTected 212 CALibrate STARt 213 CALibrate STATus 214 CALibrate TEMPerature 215 CALibrate TIME 216 10 CHANnel n Commands CHANnel n BWLimit 220 CHANnel n COUPling 221 CHANnel n DISPla...

Страница 11: ...lay ANNotation 253 DISPlay ANNotation BACKground 254 DISPlay ANNotation COLor 255 DISPlay ANNotation TEXT 256 DISPlay CLEar 257 DISPlay DATA 258 DISPlay LABel 259 DISPlay LABList 260 DISPlay PERSisten...

Страница 12: ...2 294 17 HARDcopy Commands HARDcopy AREA 297 HARDcopy APRinter 298 HARDcopy FACTors 299 HARDcopy FFEed 300 HARDcopy INKSaver 301 HARDcopy LAYout 302 HARDcopy NETWork ADDRess 303 HARDcopy NETWork APPLy...

Страница 13: ...r 343 MEASure DEFine 344 MEASure DELay 347 MEASure DUTYcycle 349 MEASure FALLtime 350 MEASure FREQuency 351 MEASure NWIDth 352 MEASure OVERshoot 353 MEASure PERiod 355 MEASure PHASe 356 MEASure PRESho...

Страница 14: ...393 MTESt ENABle 394 MTESt LOCK 395 MTESt RMODe 396 MTESt RMODe FACTion MEASure 397 MTESt RMODe FACTion PRINt 398 MTESt RMODe FACTion SAVE 399 MTESt RMODe FACTion STOP 400 MTESt RMODe SIGMa 401 MTESt...

Страница 15: ...m LENGth MAX 442 SAVE WAVeform SEGMented 443 SAVE WMEMory SOURce 444 SAVE WMEMory STARt 445 25 SBUS n Commands General SBUS n Commands 449 SBUS n DISPlay 450 SBUS n MODE 451 SBUS n CAN Commands 452 SB...

Страница 16: ...86 SBUS n LIN TRIGger 487 SBUS n LIN TRIGger ID 488 SBUS n LIN TRIGger PATTern DATA 489 SBUS n LIN TRIGger PATTern DATA LENGth 491 SBUS n LIN TRIGger PATTern FORMat 492 SBUS n SPI Commands 493 SBUS n...

Страница 17: ...IDTh 530 26 SEARch Commands General SEARch Commands 532 SEARch COUNt 533 SEARch MODE 534 SEARch STATe 535 SEARch SERial CAN Commands 536 SEARch SERial CAN MODE 537 SEARch SERial CAN PATTern DATA 538 S...

Страница 18: ...66 SYSTem ERRor 567 SYSTem LOCK 568 SYSTem MENU 569 SYSTem PRESet 570 SYSTem PROTection LOCK 573 SYSTem SETup 574 SYSTem TIME 576 28 TIMebase Commands TIMebase MODE 579 TIMebase POSition 580 TIMebase...

Страница 19: ...TRIGger GLITch RANGe 614 TRIGger GLITch SOURce 615 TRIGger PATTern Commands 616 TRIGger PATTern 617 TRIGger PATTern FORMat 619 TRIGger PATTern QUALifier 620 TRIGger TV Commands 621 TRIGger TV LINE 622...

Страница 20: ...EN MODulation AM FREQuency 673 WGEN MODulation FM DEViation 674 WGEN MODulation FM FREQuency 675 WGEN MODulation FSKey FREQuency 676 WGEN MODulation FSKey RATE 677 WGEN MODulation FUNCtion 678 WGEN MO...

Страница 21: ...Ction SOURce 718 FUNCtion VIEW 719 HARDcopy DESTination 720 HARDcopy FILename 721 HARDcopy GRAYscale 722 HARDcopy IGColors 723 HARDcopy PDRiver 724 MEASure LOWer 725 MEASure SCRatch 726 MEASure TDELta...

Страница 22: ...0 Error Queue 771 Operation Status Event Register OPERegister EVENt 772 Operation Status Condition Register OPERegister CONDition 773 Arm Event Register AER 774 Overload Event Register OVLRegister 775...

Страница 23: ...ommands Are Sequential 798 38 Programming Examples VISA COM Examples 800 VISA COM Example in Visual Basic 800 VISA COM Example in C 809 VISA COM Example in Visual Basic NET 818 VISA COM Example in Pyt...

Страница 24: ...24 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide...

Страница 25: ...What s New What s New in Version 2 30 26 What s New in Version 2 20 28 What s New in Version 2 10 30 What s New in Version 2 00 31 What s New in Version 1 20 32 What s New in Version 1 10 33 Version 1...

Страница 26: ...to a file SAVE MULTi STARt see page 436 Lets you save Multi Channel Waveform data h5 format files that can be opened by the N8900A InfiniiView oscilloscope analysis software SBUS n CAN Commands see p...

Страница 27: ...channels to their waveforms 50 values Command Differences Command Differences BLANk see page 158 You can now use the SBUS1 source parameter to turn off the serial decode display DIGitize see page 159...

Страница 28: ...tude modulation WGEN MODulation AM FREQuency see page 673 Specifies the frequency of the modulating signal WGEN MODulation FM DEViation see page 674 Specifies the frequency deviation from the original...

Страница 29: ...an now use the WMEMory r source parameter to turn off the display of a reference waveform location STATus see page 179 You can now use the WMEMory r source parameter to view the display status of a re...

Страница 30: ...ailed descriptions of the new and changed commands appear below New Commands Command Description DISPlay ANNotation see page 253 Turns screen annotation on or off DISPlay ANNotation BACKground see pag...

Страница 31: ...ersion 2 00 of the InfiniiVision 2000 X Series oscilloscope software are Ability to add noise to the waveform generator s output signal More detailed descriptions of the new and changed commands appea...

Страница 32: ...d Description FUNCtion FFT VTYPe see page 283 Specifies FFT vertical units as DECibel or VRMS MARKer XUNIts see page 325 Specifies the units for X cursors MARKer XUNIts USE see page 326 Sets the curre...

Страница 33: ...Support for the new extended Video triggering license More detailed descriptions of the new and changed commands appear below New Commands Command Description SYSTem PRESet see page 570 Now documente...

Страница 34: ...Series oscilloscopes were introduced with version 1 00 of oscilloscope operating software The command set is most closely related to the InfiniiVision 7000B Series oscilloscopes and the 7000A Series 6...

Страница 35: ...Serial decode is not supported Waveform event search is not supported Smaller set of trigger types Fewer measurements Different path name format for internal and USB storage device locations More deta...

Страница 36: ...ter with the 2000 X Series oscilloscopes CALibrate OUTPut see page 211 The TRIG OUT signal can be a trigger output mask test failure or waveform generator sync pulse DISPlay DATA see page 258 Monochro...

Страница 37: ...ID Not supported on external TRIG IN connector EXTernal PROBe STYPe Not supported on external TRIG IN connector EXTernal PROTection Not supported on external TRIG IN connector HARDcopy DEVice HARDcopy...

Страница 38: ...38 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 1 What s New...

Страница 39: ...t IO Libraries Suite software 40 Step 2 Connect and set up the oscilloscope 41 Step 3 Verify the oscilloscope connection 43 This chapter explains how to install the Agilent IO Libraries Suite software...

Страница 40: ...ogrammer s Guide 2 Setting Up Step 1 Install Agilent IO Libraries Suite software 1 Download the Agilent IO Libraries Suite software from the Agilent web site at http www agilent com find iolib 2 Run t...

Страница 41: ...hen installed these interfaces are always active Using the USB Device Interface 1 Connect a USB cable from the controller PC s USB port to the USB DEVICE port on the back of the oscilloscope This is a...

Страница 42: ...nd enable all the configuration options supported by your network d If automatic configuration is not supported press the Addresses softkey Use the Modify softkey and the other softkeys and the Entry...

Страница 43: ...roller PC click on the Agilent IO Control icon in the taskbar and choose Agilent Connection Expert from the popup menu 2 In the Agilent Connection Expert application instruments connected to the contr...

Страница 44: ...scilloscopes Programmer s Guide 2 Setting Up You must manually add instruments on LAN interfaces a Right click on the LAN interface choose Add Instrument from the popup menu b If the oscilloscope is o...

Страница 45: ...es Oscilloscopes Programmer s Guide 45 Otherwise if the instrument is not on the same subnet click Add Address i In the next dialog select either Hostname or IP address and enter the oscilloscope s ho...

Страница 46: ...ies Oscilloscopes Programmer s Guide 2 Setting Up iii If the instrument is successfully opened click OK to close the dialog If the instrument is not opened successfully go back and verify the LAN conn...

Страница 47: ...Send Commands To This Instrument from the popup menu b In the Agilent Interactive IO application enter commands in the Command field and press Send Command Read Response or Send Read c Choose Connect...

Страница 48: ...48 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 2 Setting Up...

Страница 49: ...programming the 2000 X Series oscilloscopes It describes basic oscilloscope program structure and shows how to program the oscilloscope using a few simple examples The getting started examples show ho...

Страница 50: ...ontroller initialization ensures that the interface to the oscilloscope is properly set up and ready for data transfer Oscilloscope initialization sets the channel configuration channel labels thresho...

Страница 51: ...ail DIGitize on the other hand ensures that data capture is complete Also DIGitize when complete stops the acquisition process so that all measurements are on displayed data not on a constantly changi...

Страница 52: ...umeric Variables on page 58 Reading Definite Length Block Query Response Data on page 58 Sending Multiple Queries and Reading Results on page 59 Checking Instrument Status on page 60 Referencing the I...

Страница 53: ...eList or WriteIEEEBlock methods are used for sending commands and queries After a query is sent the response is read using the ReadString ReadNumber ReadList or ReadIEEEBlock methods The following Vis...

Страница 54: ...ope Setup The AUToscale command performs a very useful function for unknown waveforms by setting up the vertical channel time base and trigger level of the instrument The syntax for the autoscale comm...

Страница 55: ...vertical range to 1 6 volts full scale with center screen at 0 4 volts with 10 1 probe attenuation and DC coupling myScope WriteString CHANnel1 PROBe 10 Probe attenuation to 10 1 myScope WriteString C...

Страница 56: ...teString WAVeform POINts 500 myScope WriteString WAVeform DATA This setup places the instrument into the averaged mode with eight averages This means that when the DIGitize command is received the com...

Страница 57: ...typically has a format specification for handling the response message When using the VISA COM library in Visual Basic you use different read methods ReadString ReadNumber ReadList or ReadIEEEBlock f...

Страница 58: ...im varQueryResult As Variant varQueryResult myScope ReadNumber MsgBox Range variant CStr varQueryResult After running this program the controller displays Range variant 40 Reading Definite Length Bloc...

Страница 59: ...hem back into a single string variable multiple string variables or multiple numeric variables For example to read the TIMebase RANGe DELay query result into a single string variable you could use the...

Страница 60: ...m varResults As Variant varResults myScope ReadList MsgBox Timebase range FormatNumber varResults 0 1000 4 _ ms delay FormatNumber varResults 1 1000000 4 us Checking Instrument Status Status registers...

Страница 61: ...ect to the oscilloscope via a telnet socket issue the following command telnet hostname 5024 where hostname is the hostname of the oscilloscope This will give you a command line with prompt For a comm...

Страница 62: ...62 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 3 Getting Started...

Страница 63: ...s1 63 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 4 Commands Quick Reference Command Summary 64 Syntax Elements 117...

Страница 64: ...mmands Summary see page 81 MARKer Commands Summary see page 81 MEASure Commands Summary see page 82 MTESt Commands Summary see page 89 POD n Commands Summary see page 91 RECall Commands Summary see pa...

Страница 65: ...sk see page 126 ESE see page 126 mask 0 to 255 an integer in NR1 format Bit Weight Name Enables 7 128 PON Power On 6 64 URQ User Request 5 32 CME Command Error 4 16 EXE Execution Error 3 8 DDE Dev Dep...

Страница 66: ...Measurements 0 PWR Segmented Memory 0 SGM Mask Test 0 MASK Bandwidth 0 BW10 BW20 Waveform Generator 0 WAVEGEN RCL value see page 135 n a value 0 1 4 5 6 7 8 9 RST see page 136 n a See RST Reset see pa...

Страница 67: ...2 4 MSG Message displayed 1 2 USR User event condition occurred 0 1 TRG A trigger occurred TRG see page 144 n a n a n a TST see page 145 result 0 or non zero value an integer in NR1 format WAI see pag...

Страница 68: ...le AMODE see page 155 value NORMal CURRent AUToscale CHANnels value see page 156 AUToscale CHANnels see page 156 value ALL DISPlayed AUToscale FDEBug 0 OFF 1 ON see page 157 AUToscale FDEBug see page...

Страница 69: ...r in NR1 format OPEE n see page 165 OPEE see page 165 n 15 bit integer in NR1 format n a OPERregister CONDiti on see page 167 n 15 bit integer in NR1 format n a OPERegister EVENt see page 169 n 15 bit...

Страница 70: ...isplay see page 179 0 1 display CHANnel n DIGital d POD 1 2 BUS 1 2 FUNCtion MATH SBUS1 WMEMory r n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format r 1 to ref waveforms in N...

Страница 71: ...page 190 ACQuire SEGMented CO UNt see page 190 count an integer from 2 to 25 in NR1 format with Option SGM ACQuire SEGMented IN Dex index see page 191 ACQuire SEGMented IN Dex see page 191 index an in...

Страница 72: ...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 n 1 or 2 an integer in NR1 format Table 5 BUS n Commands Summary...

Страница 73: ...0 0 1 n 1 to analog channels in NR1 format CHANnel n COUPling coupling see page 221 CHANnel n COUPling see page 221 coupling AC DC n 1 to analog channels in NR1 format CHANnel n DISPlay 0 OFF 1 ON see...

Страница 74: ...HANnel n PROBe STY Pe signal type see page 231 CHANnel n PROBe STY Pe see page 231 signal type DIFFerential SINGle n 1 to analog channels in NR1 format CHANnel n PROTectio n see page 232 CHANnel n PRO...

Страница 75: ...lay see page 245 d 0 to digital channels 1 in NR1 format 0 1 DIGital d LABel string see page 246 DIGital d LABel see page 246 d 0 to digital channels 1 in NR1 format string any series of 10 or less AS...

Страница 76: ...T string see page 256 DISPlay ANNotation T EXT see page 256 string quoted ASCII string up to 254 characters DISPlay CLEar see page 257 n a n a n a DISPlay DATA format palett e see page 258 format BMP...

Страница 77: ...ee page 268 DVM MODE see page 268 dvm_mode ACRMs DC DCRMs FREQuency DVM SOURce source see page 269 DVM SOURce see page 269 source CHANnel n n 1 2 or 1 4 in NR1 format Table 12 EXTernal Trigger Command...

Страница 78: ...its DECibel VRMS FUNCtion FFT WINDo w window see page 284 FUNCtion FFT WINDo w see page 284 window RECTangular HANNing FLATtop BHARris FUNCtion GOFT OPERat ion operation see page 285 FUNCtion GOFT OPE...

Страница 79: ...suffix V dB FUNCtion SOURce1 source see page 293 FUNCtion SOURce1 see page 293 source CHANnel n GOFT n 1 2 3 4 for 4ch models n 1 2 for 2ch models GOFT is only for FFT operation FUNCtion SOURce2 sour...

Страница 80: ...HARDcopy NETWork DOM ain see page 305 domain quoted ASCII string HARDcopy NETWork PAS Sword password see page 306 n a password quoted ASCII string HARDcopy NETWork SLO T slot see page 307 HARDcopy NE...

Страница 81: ...ANual WAVeform MARKer X1Position position suffix see page 320 MARKer X1Position see page 320 position X1 cursor position value in NR3 format suffix s ms us ns ps Hz kHz MHz return_value X1 cursor posi...

Страница 82: ...er Y2Position see page 328 position Y2 cursor position value in NR3 format suffix V mV dB return_value Y2 cursor position value in NR3 format n a MARKer YDELta see page 329 return_value Y cursors delt...

Страница 83: ...ASure DUTYcycle source see page 349 source CHANnel n FUNCtion MATH WMEMory r for DSO models source CHANnel n DIGital d FUNCtion MATH WMEMory r for MSO models n 1 to analog channels in NR1 format r 1 2...

Страница 84: ...see page 352 MEASure NWIDth source see page 352 source CHANnel n FUNCtion MATH WMEMory r for DSO models source CHANnel n DIGital d FUNCtion MATH WMEMory r for MSO models n 1 to analog channels in NR1...

Страница 85: ...channels in NR1 format r 1 2 in NR1 format return_value the phase angle value in degrees in NR3 format MEASure PREShoot source see page 357 MEASure PREShoot source see page 357 source CHANnel n FUNCti...

Страница 86: ...for DSO models source1 2 CHANnel n DIGital d FUNCtion MATH WMEMory r EXTernal for MSO models n 1 to analog channels in NR1 format r 1 2 in NR1 format d 0 to digital channels 1 in NR1 format return_val...

Страница 87: ...ee page 367 MEASure VAMPlitude source see page 367 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format return_value the amplitude of the selected waveform...

Страница 88: ...in NR1 format return_value minimum voltage of the selected waveform in NR3 format MEASure VPP source see page 372 MEASure VPP source see page 372 source CHANnel n FUNCtion MATH WMEMory r n 1 to analo...

Страница 89: ...page 375 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format return_value voltage at the top of the waveform in NR3 format MEASure WINDow type see page 3...

Страница 90: ...MTESt DATA mask see page 392 MTESt DATA see page 392 mask data in IEEE 488 2 format MTESt DELete see page 393 n a n a MTESt ENABle 0 OFF 1 ON see page 394 MTESt ENABle see page 394 0 1 MTESt LOCK 0 O...

Страница 91: ...X1 value in NR3 format MTESt SCALe XDELta xdelta_value see page 406 MTESt SCALe XDELta see page 406 xdelta_value X delta value in NR3 format MTESt SCALe Y1 y1_value see page 407 MTESt SCALe Y1 see pag...

Страница 92: ...mmand Query Options and Query Returns RECall FILename base_name see page 419 RECall FILename see page 419 base_name quoted ASCII string RECall MASK STARt file_spec see page 420 n a file_spec internal_...

Страница 93: ...e page 432 SAVE IMAGe INKSaver see page 432 0 1 SAVE IMAGe PALette palette see page 433 SAVE IMAGe PALette see page 433 palette COLor GRAYscale MONochrome SAVE LISTer STARt file_name see page 434 n a...

Страница 94: ...CURRent SAVE WMEMory SOURce source see page 444 SAVE WMEMory SOURce see page 444 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format NOTE Only ADD or SUBt...

Страница 95: ...al B AUDrate see page 460 baudrate integer from 10000 to 4000000 in 100 b s increments or 5000000 SBUS n CAN SIGNal D EFinition value see page 461 SBUS n CAN SIGNal D EFinition see page 461 value CANH...

Страница 96: ...S n IIC SOURce CLOCk see page 471 source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format SBUS n...

Страница 97: ...PARity see page 481 0 1 SBUS n LIN SAMPlepo int value see page 482 SBUS n LIN SAMPlepo int see page 482 value 60 62 5 68 70 75 80 87 5 in NR3 format SBUS n LIN SIGNal B AUDrate baudrate see page 483...

Страница 98: ...Tern DATA LENGth length see page 491 SBUS n LIN TRIGger PATTern DATA LENGth see page 491 length integer from 1 to 8 in NR1 format SBUS n LIN TRIGger PATTern FORMat base see page 492 SBUS n LIN TRIGger...

Страница 99: ...n SPI SOURce M ISO see page 501 value CHANnel n EXTernal for the DSO models value CHANnel n DIGital d for the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format SB...

Страница 100: ...width integer 4 16 in NR1 format Table 26 SBUS n SPI Commands Summary continued Command Query Options and Query Returns Table 27 SBUS n UART Commands Summary Command Query Options and Query Returns SB...

Страница 101: ...see page 522 SBUS n UART SOURce RX see page 522 source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR...

Страница 102: ...in NR3 format SBUS n UART TRIGger QUALifier value see page 528 SBUS n UART TRIGger QUALifier see page 528 value EQUal NOTequal GREaterthan LESSthan SBUS n UART TRIGger TYPE value see page 529 SBUS n U...

Страница 103: ...X for hexadecimal SEARch SERial CAN PA TTern ID MODE value see page 541 SEARch SERial CAN PA TTern ID MODE see page 541 value STANdard EXTended Table 30 SEARch SERial IIC Commands Summary Command Quer...

Страница 104: ...D DATA ERRor SEARch SERial LIN PA TTern DATA string see page 552 SEARch SERial LIN PA TTern DATA see page 552 When SEARch SERial LIN PATTern FORMa t DECimal string n where n 32 bit integer in unsigned...

Страница 105: ...al hexadecimal binary or quoted_string format 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...

Страница 106: ...Tem TIME time see page 576 SYSTem TIME see page 576 time hours minutes seconds in NR1 format Table 34 SYSTem Commands Summary continued Command Query Options and Query Returns Table 35 TIMebase Comman...

Страница 107: ...d window Table 35 TIMebase Commands Summary continued Command Query Options and Query Returns Table 36 General TRIGger Commands Summary Command Query Options and Query Returns TRIGger FORCe see page 5...

Страница 108: ...er EDGE Commands Summary Command Query Options and Query Returns TRIGger EDGE COUPl ing AC DC LFReject see page 602 TRIGger EDGE COUPl ing see page 602 AC DC LFReject TRIGger EDGE LEVel level source s...

Страница 109: ...uery Options and Query Returns TRIGger GLITch GREat erthan greater_than_time s uffix see page 609 TRIGger GLITch GREat erthan see page 609 greater_than_time floating point number in NR3 format suffix...

Страница 110: ...615 source CHANnel n DIGital d n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format Table 38 TRIGger GLITch Commands Summary continued Command Query Options and Query Returns...

Страница 111: ...source CHANnel n n 1 to analog channels in NR1 format TRIGger TV STANdard standard see page 626 TRIGger TV STANdard see page 626 standard NTSC PAL PALM SECam Table 41 WAVeform Commands Summary Command...

Страница 112: ...e see page 644 preamble_block format NR1 type NR1 points NR1 count NR1 xincrement NR3 xorigin NR3 xreference NR1 yincrement NR3 yorigin NR3 yreference NR1 format an integer in NR1 format 0 for BYTE fo...

Страница 113: ...e 655 0 1 WAVeform VIEW view see page 656 WAVeform VIEW see page 656 view MAIN n a WAVeform XINCrement see page 657 return_value x increment in the current preamble in NR3 format n a WAVeform XORigin...

Страница 114: ...page 672 percent AM depth percentage from 0 to 100 in NR1 format WGEN MODulation AM F REQuency frequency see page 673 WGEN MODulation AM F REQuency see page 673 frequency modulating waveform frequenc...

Страница 115: ...in seconds in NR3 format WGEN RST see page 687 n a n a WGEN VOLTage amplitude see page 688 WGEN VOLTage see page 688 amplitude amplitude in volts in NR3 format WGEN VOLTage HIGH high see page 689 WGE...

Страница 116: ...MEMory r SKEW skew see page 699 WMEMory r SKEW see page 699 r 1 2 in NR1 format skew time in seconds in NR3 format WMEMory r YOFFset offset suffix see page 700 WMEMory r YOFFset see page 700 r 1 2 in...

Страница 117: ...th Block Response Data on page 118 Number Format NR1 specifies integer data NR3 specifies exponential data in floating point format for example 1 0E 3 NL Line Terminator NL new line or linefeed ASCII...

Страница 118: ...example when using the Agilent VISA COM library in Visual Basic the command myScope WriteString CHANNEL1 LABEL One has a quoted ASCII string of One In order to read quoted ASCII strings from query ret...

Страница 119: ...ilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 119 800001000 1000 bytes of data NL 8 is the number of digits that follow 00001000 is the number of bytes to be transmitted 1000 byte...

Страница 120: ...120 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 4 Commands Quick Reference...

Страница 121: ...r Request 5 32 CME Command Error 4 16 EXE Execution Error 3 8 DDE Dev Dependent Error 2 4 QYE Query Error 1 2 RQL Request Control 0 1 OPC Operation Complete n a ESR see page 128 status 0 to 255 an int...

Страница 122: ...urements 0 PWR Segmented Memory 0 SGM Mask Test 0 MASK Bandwidth 0 BW10 BW20 Waveform Generator 0 WAVEGEN RCL value see page 135 n a value 0 1 4 5 6 7 8 9 RST see page 136 n a See RST Reset see page 1...

Страница 123: ...ars the status information and sets the average count In contrast if a root level command or some other subsystem command is within the program message you must re enter the original subsystem after t...

Страница 124: ...2000 X Series Oscilloscopes Programmer s Guide 5 Common Commands NOTE Each of the status registers has an enable mask register By setting the bits in the enable register you can select the status inf...

Страница 125: ...rror queue and the Request for OPC flag See Also Introduction to Common Commands on page 123 STB Read Status Byte on page 142 ESE Standard Event Status Enable on page 126 ESR Standard Event Status Reg...

Страница 126: ...Standard Event Status Enable ESE Bit Name Description When Set 1 High True Enables 7 PON Power On Event when an OFF to ON transition occurs 6 URQ User Request Event when a front panel key is pressed...

Страница 127: ...rns the current contents of the Standard Event Status Enable Register Return Format mask_argument NL mask_argument 0 255 an integer in NR1 format See Also Introduction to Common Commands on page 123 E...

Страница 128: ...R1 format Table 46 Standard Event Status Register ESR Bit Name Description When Set 1 High True Indicates 7 PON Power On An OFF to ON transition has occurred 6 URQ User Request A front panel key has b...

Страница 129: ...129 See Also Introduction to Common Commands on page 123 ESE Standard Event Status Enable on page 126 OPC Operation Complete on page 132 CLS Clear Status on page 125 SYSTem ERRor on page 567 NOTE Rea...

Страница 130: ...query identifies the instrument type and software version Return Format AGILENT TECHNOLOGIES model serial number X XX XX NL model the model number of the instrument serial number the serial number of...

Страница 131: ...instrument settings at a later time Return Format learn_string NL learn_string SYST SET setup_data setup_data binary block data in IEEE 488 2 format learn string specifies the current instrument setu...

Страница 132: ...ter when all pending device operations have finished Query Syntax OPC The OPC query places an ASCII 1 in the output queue when all pending device operations have completed The interface hangs until th...

Страница 133: ...Memory Mask Test reserved Bandwidth reserved reserved reserved reserved reserved Educator s Kit Waveform Generator reserved reserved reserved reserved reserved reserved Digital Voltmeter reserved All...

Страница 134: ...134 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 5 Common Commands See Also Introduction to Common Commands on page 123 IDN Identification Number on page 130...

Страница 135: ...s Programmer s Guide 135 RCL Recall see page 790 Command Syntax RCL value 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 Als...

Страница 136: ...etup there are no user settings that remain unchanged To perform the equivalent of the front panel s Default Setup key where some user settings like preferences remain unchanged use the SYSTem PRESet...

Страница 137: ...d TTL 1 4 V Display Menu Persistence Off Grid 20 Quick Meas Menu Source Channel 1 Run Control Scope is running Time Base Menu Main time division 100 us Main time base delay 0 00 s Delay time division...

Страница 138: ...rk as expected Most of the following initialization commands are initialized by RST It is not necessary to reinitialize them unless the default setting is not suitable for your application myScope Wri...

Страница 139: ...Save see page 790 Command Syntax SAV value value 0 1 2 3 4 5 6 7 8 9 The SAV command stores the current state of the instrument in a save register The data parameter specifies the register where the...

Страница 140: ...ster The Service Request Enable Register contains a mask value for the bits to be enabled in the Status Byte Register A one in the Service Request Enable Register enables the corresponding bit in the...

Страница 141: ...Service Request Enable Register SRE Bit Name Description When Set 1 High True Enables 7 OPER Operation Status Register Interrupts when enabled conditions in the Operation Status Register OPER occur 6...

Страница 142: ...bit is reported on bit 6 instead of the RQS request service bit The MSS indicates whether or not the device has at least one reason for requesting service Return Format value NL value 0 255 an integer...

Страница 143: ...e When polled that the device is requesting service MSS Master Summary Status When read by STB whether the device has a reason for requesting service 5 ESB Event Status Bit An enabled condition in the...

Страница 144: ...mmer s Guide 5 Common Commands TRG Trigger see page 790 Command Syntax TRG The TRG command has the same effect as the DIGitize command with no parameters See Also Introduction to Common Commands on pa...

Страница 145: ...self test on the instrument The result of the test is placed in the output queue A zero indicates the test passed and a non zero indicates the test failed If the test fails refer to the troubleshootin...

Страница 146: ...s Programmer s Guide 5 Common Commands WAI Wait To Continue see page 790 Command Syntax WAI The WAI command has no function in the oscilloscope but is parsed for compatibility with other instruments S...

Страница 147: ...teger in NR1 format levels logical highs or lows 32 bit integer in NR1 format n a AER see page 152 0 1 an integer in NR1 format AUToscale source source see page 153 n a source CHANnel n for DSO models...

Страница 148: ...ion MATH for DSO models source CHANnel n DIGital d POD 1 2 BUS 1 2 FUNCtion MATH for MSO models source can be repeated up to 5 times n 1 to analog channels in NR1 format d 0 to digital channels 1 in N...

Страница 149: ...VLenable for value PRINt options see page 175 n a options print option print option print option COLor GRAYscale PRINter0 PRINter1 BMP8bit BMP PNG NOFactors FACTors print option can be repeated up to...

Страница 150: ...d tree position After executing a root level command the parser is positioned at the root of the command tree n a TER see page 181 0 1 VIEW source see page 182 n a source CHANnel n FUNCtion MATH SBUS1...

Страница 151: ...er in NR1 format bit 0 DIGital 0 bit 15 DIGital 15 See Also Introduction to Root Commands on page 150 POD n THReshold on page 414 DIGital d THReshold on page 249 NOTE Because the ACTivity query return...

Страница 152: ...n Status Event Register A Service Request can be generated when the Wait Trig bit transitions and the appropriate enable bits have been set in the Operation Status Enable Register OPEE and the Service...

Страница 153: ...ecified those specified sources will be enabled and all others blanked The autoscale channels mode see AUToscale CHANnels on page 156 is set to DISPlayed channels Then the autoscale is performed When...

Страница 154: ...Root Commands on page 150 AUToscale CHANnels on page 156 AUToscale AMODE on page 155 Example Code AUTOSCALE This command evaluates all the input signals and sets the correct conditions to display all...

Страница 155: ...l acquisition type and the RTIMe real time acquisition mode When CURRent is selected the current acquisition type and mode are kept on subsequent AUToscales Use the ACQuire TYPE and ACQuire MODE comma...

Страница 156: ...lected all channels that meet the requirements of AUToscale will be displayed When DISPlayed is selected only the channels that are turned on are autoscaled Use the VIEW or BLANk root commands to turn...

Страница 157: ...option changes the behavior of AUToscale to let you make quick visual comparisons to determine whether the signal being probed is a DC voltage ground or an active AC signal Channel coupling is mainta...

Страница 158: ...tal pod math function or serial decode bus The BLANk command with no parameter turns off all sources See Also Introduction to Root Commands on page 150 DISPlay CLEar on page 257 CHANnel n DISPlay on p...

Страница 159: ...ment to acquire waveforms according to the settings of the ACQuire commands subsystem When the acquisition is complete the instrument is stopped If no argument is given DIGitize acquires the channels...

Страница 160: ...Series Oscilloscopes Programmer s Guide 6 Root Commands Example Code Capture an acquisition using DIGitize myScope WriteString DIGitize CHANnel1 See complete example programs at Chapter 38 Programmin...

Страница 161: ...the Mask Test Event Enable register as an integer number Return Format value NL value integer in NR1 format See Also Introduction to Root Commands on page 150 AER Arm Event Register on page 152 Table...

Страница 162: ...t Commands CHANnel n PROTection on page 232 OPERegister EVENt Operation Status Event Register on page 169 OVLenable Overload Event Enable Register on page 171 OVLRegister Overload Event Register on pa...

Страница 163: ...OPERegister CONDition Operation Status Condition Register on page 167 OVLenable Overload Event Enable Register on page 171 OVLRegister Overload Event Register on page 173 Table 51 Mask Test Event Eve...

Страница 164: ...164 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 6 Root Commands STB Read Status Byte on page 142 SRE Service Request Enable on page 140...

Страница 165: ...Name Description When Set 1 High True Enables 14 12 Not used 11 OVLR Overload Event when 50 input overload occurs 10 Not used 9 MTE Mask Test Event Event when mask test event occurs 8 6 Not used 5 Wa...

Страница 166: ...turn Format value NL value integer in NR1 format See Also Introduction to Root Commands on page 150 AER Arm Event Register on page 152 CHANnel n PROTection on page 232 OPERegister EVENt Operation Stat...

Страница 167: ...us Condition Register Bit Name Description When Set 1 High True Indicates 14 12 Not used 11 OVLR Overload A 50 input overload has occurred 10 Not used 9 MTE Mask Test Event A mask test event has occur...

Страница 168: ...atus Event Register on page 169 OVLenable Overload Event Enable Register on page 171 OVLRegister Overload Event Register on page 173 STB Read Status Byte on page 142 SRE Service Request Enable on page...

Страница 169: ...High True Indicates 14 12 Not used 11 OVLR Overload A 50 input overload has occurred 10 Not used 9 MTE Mask Test Event A mask test event has occurred 8 6 Not used 5 Wait Trig Wait Trig The trigger is...

Страница 170: ...er CONDition Operation Status Condition Register on page 167 OVLenable Overload Event Enable Register on page 171 OVLRegister Overload Event Register on page 173 STB Read Status Byte on page 142 SRE S...

Страница 171: ...1 GHz bandwidth oscilloscope models On these same bandwidth models if there are only two analog channels you can also set external trigger input impedance to 50 Table 55 Overload Event Enable Registe...

Страница 172: ...Tection on page 232 OPEE Operation Status Enable Register on page 165 OPERegister CONDition Operation Status Condition Register on page 167 OPERegister EVENt Operation Status Event Register on page 16...

Страница 173: ...l trigger input impedance to 50 Table 56 Overload Event Register OVLR Bit Description When Set 1 High True Indicates 15 10 Not used 9 Channel 4 Fault Fault has occurred on Channel 4 input 8 Channel 3...

Страница 174: ...value integer in NR1 format See Also Introduction to Root Commands on page 150 CHANnel n PROTection on page 232 OPEE Operation Status Enable Register on page 165 OVLenable Overload Event Enable Regis...

Страница 175: ...PNG NOFactors FACTors The print option parameter may be repeated up to 5 times The PRINt command formats the output according to the currently selected format device If an option is not specified the...

Страница 176: ...lso Introduction to Root Commands on page 150 SINGle on page 178 STOP on page 180 Example Code RUN_STOP not executed in this example RUN starts the data acquisition for the active waveform display STO...

Страница 177: ...2000 X Series Oscilloscopes Programmer s Guide 177 SERial see page 790 Query Syntax SERial The SERial query returns the serial number of the instrument Return Format Unquoted string NL See Also Intro...

Страница 178: ...ot Commands SINGle see page 790 Command Syntax SINGle The SINGle command causes the instrument to acquire a single trigger of data This is the same as pressing the Single key on the front panel See Al...

Страница 179: ...g channels in NR1 format d 0 to digital channels 1 in NR1 format r 1 to ref waveforms in NR1 format The STATus query reports whether the channel function or serial decode bus specified by source is di...

Страница 180: ...Root Commands STOP see page 790 Command Syntax STOP The STOP command stops the acquisition This is the same as pressing the Stop key on the front panel See Also Introduction to Root Commands on page 1...

Страница 181: ...red The Trigger Event Register is summarized in the TRG bit of the Status Byte Register STB A Service Request SRQ can be generated when the TRG bit of the Status Byte transitions and the TRG bit is se...

Страница 182: ...channel function or serial decode bus See Also Introduction to Root Commands on page 150 BLANk on page 158 CHANnel n DISPlay on page 222 DIGital d DISPlay on page 245 FUNCtion DISPlay on page 280 POD...

Страница 183: ...t ACQuire COUNt count see page 186 ACQuire COUNt see page 186 count an integer from 2 to 65536 in NR1 format ACQuire MODE mode see page 187 ACQuire MODE see page 187 mode RTIMe SEGMented n a ACQuire P...

Страница 184: ...ution command sets the oscilloscope in the high resolution mode also known as smoothing This mode is used to reduce noise at slower sweep speeds where the digitizer samples faster than needed to fill...

Страница 185: ...for the COMPlete command is 100 All time buckets must contain data for the acquisition to be considered complete Query Syntax ACQuire COMPlete The ACQuire COMPlete query returns the completion criter...

Страница 186: ...y value from 2 to 65536 Query Syntax ACQuire COUNT The ACQuire COUNT query returns the currently selected count value for averaging mode Return Format count_argument NL count_argument an integer from...

Страница 187: ...d sets the oscilloscope in real time mode The ACQuire MODE SEGMented command sets the oscilloscope in segmented memory mode Query Syntax ACQuire MODE The ACQuire MODE query returns the acquisition mod...

Страница 188: ...signal The number of points acquired is not directly controllable To set the number of points to be transferred from the oscilloscope use the command WAVeform POINts The WAVeform POINts query will re...

Страница 189: ...It corresponds to the front panel Analyze Segments softkey which appears in both the Measurement Statistics and Segmented Memory Menus In order to use this command the oscilloscope must be stopped and...

Страница 190: ...d by the WAVeform SEGMented COUNt query The maximum number of segments may be limited by the memory depth of your oscilloscope For example an oscilloscope with 100K memory allows a maximum of 25 segme...

Страница 191: ...g of the currently indexed memory segment is returned by the WAVeform SEGMented TTAG query The maximum number of segments may be limited by the memory depth of your oscilloscope For example an oscillo...

Страница 192: ...de strQueryResult Set the number of segments to 25 myScope WriteString ACQuire SEGMented COUNt 25 myScope WriteString ACQuire SEGMented COUNt strQueryResult myScope ReadString Debug Print Acquisition...

Страница 193: ...Str lngI myScope WriteString ACQuire SEGMented INDex strQueryResult myScope ReadString Debug Print Acquisition memory segment index strQueryResult Display the segment time tag myScope WriteString WAVe...

Страница 194: ...page 790 Query Syntax 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_ra...

Страница 195: ...than needed to fill memory for the displayed time range For example if the digitizer samples at 200 MSa s but the effective sample rate is 1 MSa s because of a slower sweep speed only 1 out of every 2...

Страница 196: ...83 ACQuire COUNt on page 186 ACQuire MODE on page 187 DIGitize on page 159 WAVeform FORMat on page 639 WAVeform TYPE on page 654 WAVeform PREamble on page 644 Example Code AQUIRE_TYPE Sets the acquisi...

Страница 197: ...S n BIT m 0 OFF 1 ON see page 199 BUS n BIT m see page 199 0 1 n 1 or 2 an integer in NR1 format m 0 7 an integer in NR1 format BUS n BITS channel_list 0 OFF 1 ON see page 200 BUS n BITS see page 200...

Страница 198: ...ssued following a RST command BUS1 DISP 0 LAB BUS1 MASK 255 BUS n LABel string see page 204 BUS n LABel see page 204 string quoted ASCII string up to 10 characters n 1 or 2 an integer in NR1 format BU...

Страница 199: ...elected bus If the parameter is a 1 ON the bit is included in the definition If the parameter is a 0 OFF the bit is excluded from the definition Note BIT0 7 correspond to DIGital0 7 Query Syntax BUS n...

Страница 200: ...d bus definition If the parameter is a 0 OFF then the bits in the channel list are excluded from the definition of the selected bus Query Syntax BUS n BITS The BUS n BITS query returns the definition...

Страница 201: ...BUS n Commands 8 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 201 Include digital channels 1 through 3 5 and 7 in bus 1 myScope WriteString BUS1 BITS 1 3 5 7 ON...

Страница 202: ...ffix to BUS and defines the bus that is affected by the command The BUS n CLEar command excludes all of the digital channels from the selected bus definition See Also Introduction to BUS n Commands on...

Страница 203: ...affected by the command The BUS n DISPlay command enables or disables the view of the selected bus Query Syntax BUS n DISPlay The BUS n DISPlay query returns the display value of the selected bus Retu...

Страница 204: ...e BUS n LABel query returns the name of the specified bus Return Format quoted_string NL quoted_string any series of 10 or less characters as a quoted ASCII string See Also Introduction to BUS n Comma...

Страница 205: ...e bus that is affected by the command The BUS n MASK command defines the bits included and excluded in the selected bus according to the mask Set a mask bit to a 1 to include that bit in the selected...

Страница 206: ...206 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 8 BUS n Commands...

Страница 207: ...month day all in NR1 format CALibrate LABel string see page 210 CALibrate LABel see page 210 string quoted ASCII string up to 32 characters CALibrate OUTPut signal see page 211 CALibrate OUTPut see pa...

Страница 208: ...te Commands Determining the state of the calibration factor protection switch CAL PROTECT Saving and querying the calibration label string Reporting the calibration time and date Reporting changes in...

Страница 209: ...copes Programmer s Guide 209 CALibrate DATE see page 790 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...

Страница 210: ...CALibrate LABel command saves a string that is up to 32 characters in length into the instrument s non volatile memory The string may be used to record calibration dates or other information as needed...

Страница 211: ...t indicating a failure WAVEgen waveform generator sync output signal This signal depends on the WGEN FUNCtion setting Query Syntax CALibrate OUTPut The CALibrate OUTPut query returns the current sourc...

Страница 212: ...ery Syntax CALibrate PROTected The CALibrate PROTected query returns the rear panel calibration protect CAL PROTECT button state The value PROTected indicates calibration is disabled and UNPRotected i...

Страница 213: ...Rt command starts the user calibration procedure See Also Introduction to CALibrate Commands on page 207 CALibrate PROTected on page 212 NOTE Before starting the user calibration procedure you must se...

Страница 214: ...0 Query Syntax 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 statu...

Страница 215: ...Perature see page 790 Query Syntax CALibrate TEMPerature The CALibrate TEMPerature query returns the change in temperature since the last user calibration procedure Return Format return value NL retur...

Страница 216: ...Guide 9 CALibrate Commands CALibrate TIME see page 790 Query Syntax CALibrate TIME The CALibrate TIME query returns the time of the last calibration Return Format date NL date hour minutes seconds in...

Страница 217: ...222 CHANnel n DISPlay see page 222 0 1 n 1 to analog channels in NR1 format CHANnel n IMPedance impedance see page 223 CHANnel n IMPedance see page 223 impedance ONEMeg n 1 to analog channels in NR1...

Страница 218: ...ge 231 CHANnel n PROBe STY Pe see page 231 signal type DIFFerential SINGle n 1 to analog channels in NR1 format CHANnel n PROTectio n see page 232 CHANnel n PROTectio n see page 232 NORM n 1 to analog...

Страница 219: ...A label command provides identifying annotations of up to 10 characters You can toggle the channel displays on and off with the CHANnel n DISPlay command as well as with the root level commands VIEW a...

Страница 220: ...nalog channels in NR1 format The CHANnel n BWLimit command controls an internal low pass filter When the filter is on the bandwidth of the specified channel is limited to approximately 25 MHz Query Sy...

Страница 221: ...log channels in NR1 format The CHANnel n COUPling command selects the input coupling for the specified channel The coupling for each analog channel can be set to AC or DC Query Syntax CHANnel n COUPli...

Страница 222: ...format The CHANnel n DISPlay command turns the display of the specified channel on or off Query Syntax CHANnel n DISPlay The CHANnel n DISPlay query returns the current display setting for the specif...

Страница 223: ...s in NR1 format The CHANnel n IMPedance command selects the input impedance setting for the specified analog channel The only legal value for this command is ONEMeg 1 M Query Syntax CHANnel n IMPedanc...

Страница 224: ...nalog channels in NR1 format The CHANnel n INVert command selects whether or not to invert the input signal for the specified channel The inversion may be 1 ON inverted or 0 OFF not inverted Query Syn...

Страница 225: ...g NL string quoted ASCII string See Also Introduction to CHANnel n Commands on page 218 DISPlay LABel on page 259 DIGital d LABel on page 246 DISPlay LABList on page 260 BUS n LABel on page 204 Exampl...

Страница 226: ...alues varies with the value set by the CHANnel n RANGe and CHANnel n SCALe commands If you set the offset to a value outside of the legal range the offset value is automatically set to the nearest leg...

Страница 227: ...the reference constants for scaling the display factors for making automatic measurements and for setting trigger levels Query Syntax CHANnel n PROBe The CHANnel n PROBe query returns the current prob...

Страница 228: ...12 Single ended 12dB SEND20 Single ended 20dB DIFF0 Differential 0dB DIFF6 Differential 6dB DIFF12 Differential 12dB DIFF20 Differential 20dB Query Syntax CHANnel n PROBe HEAD TYPE The CHANnel n PROBe...

Страница 229: ...n PROBe ID query returns the type of probe attached to the specified oscilloscope channel Return Format probe id NL probe id unquoted ASCII string up to 11 characters Some of the possible returned val...

Страница 230: ...sets the channel to channel skew factor for the specified channel Each analog channel can be adjusted or 100 ns for a total of 200 ns difference between channels You can use the oscilloscope s probe...

Страница 231: ...s and determines how offset is applied When single ended is selected the CHANnel n OFFset command changes the offset value of the probe amplifier When differential is selected the CHANnel n OFFset com...

Страница 232: ...annel input impedance is always 1 M so automatic overvoltage protection is not necessary as it is for channels with 50 input impedance There are no protection settings to clear so the CHANnel n PROTec...

Страница 233: ...ed the range value is multiplied by the probe attenuation factor Query Syntax CHANnel n RANGe The CHANnel n RANGe query returns the current full scale range setting for the specified channel Return Fo...

Страница 234: ...ommand sets the vertical scale or units per division of the selected channel If the probe attenuation is changed the scale value is multiplied by the probe s attenuation factor Query Syntax CHANnel n...

Страница 235: ...onnected probe Select VOLT for a voltage probe and select AMPere for a current probe Measurement results channel sensitivity and trigger level will reflect the measurement units you select Query Synta...

Страница 236: ...ON 0 OFF n 1 to analog channels in NR1 format The CHANnel n VERNier command specifies whether the channel s vernier fine vertical adjustment setting is ON 1 or OFF 0 Query Syntax CHANnel n VERNier The...

Страница 237: ...etup Use DEMO to query setup information for the DEMO subsystem Return Format The following is a sample response from the DEMO query In this case the query was issued following the RST command DEMO FU...

Страница 238: ...offset phase shifted by the amount entered using the DEMO FUNCtion PHASe PHASe on page 240 command RINGing 500 kHz digital pulse 3 Vpp 1 5 V offset and 500 ns pulse width with ringing Off SINGle 500 n...

Страница 239: ...kHz stair step sine wave output of DAC 1 5 Vpp 0 75 V offset DAC input signals are internally routed to digital channels D0 through D7 3 1 kHz sine wave filtered from DAC output 600 mVpp 300 mV offse...

Страница 240: ...0 in NR3 format For the phase shifted sine demo signals the DEMO FUNCtion PHASe PHASe command specifies the phase shift in the second sine waveform Query Syntax DEMO FUNCtion PHASe PHASe The DEMO FUNC...

Страница 241: ...O OUTPut on_off on_off 1 ON 0 OFF The DEMO OUTPut command specifies whether the demo signal output is ON 1 or OFF 0 Query Syntax DEMO OUTPut The DEMO OUTPut query returns the current state of the demo...

Страница 242: ...242 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 11 DEMO Commands...

Страница 243: ...ABel see page 246 d 0 to digital channels 1 in NR1 format string any series of 10 or less ASCII characters enclosed in quotation marks DIGital d POSition position see page 247 DIGital d POSition see p...

Страница 244: ...ls They also control threshold settings for groups of digital channels or pods Reporting the Setup Use DIGital d to query setup information for the DIGital subsystem Return Format The following is a s...

Страница 245: ...command turns digital display on or off for the specified channel Query Syntax DIGital d DISPlay The DIGital d DISPlay query returns the current digital display setting for the specified channel Retur...

Страница 246: ...in non volatile memory replacing the oldest label in the list Query Syntax DIGital d LABel The DIGital d LABel query returns the name of the specified channel Return Format label string NL label strin...

Страница 247: ...es serial decode waveforms or the zoomed time base are displayed Query Syntax DIGital d POSition The DIGital d POSition query returns the position of the specified channel If the returned value is 1 t...

Страница 248: ...s on the display Sizes are set for all digital channels Therefore if you set the size on digital channel 0 for example the same size is set on all other as well Query Syntax DIGital d SIZE The DIGital...

Страница 249: ...and sets the logic threshold value for all channels in the same pod as the specified channel The threshold is used for triggering purposes and for displaying the digital data as high above the thresho...

Страница 250: ...250 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 12 DIGital d Commands...

Страница 251: ...TRANsparent DISPlay ANNotation C OLor color see page 255 DISPlay ANNotation C OLor see page 255 color CH1 CH2 CH3 CH4 DIG MATH REF MARKer WHITe RED DISPlay ANNotation T EXT string see page 256 DISPlay...

Страница 252: ...ls Save and Recall display data Reporting the Setup 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...

Страница 253: ...e annotation appears in the upper left corner of the oscilloscope s display The annotation is useful for documentation purposes to add notes before capturing screens Query Syntax DISPlay ANNotation Th...

Страница 254: ...OPAQue the annotation has a solid background INVerted the annotation s foreground and background colors are switched TRANsparent the annotation has a transparent background Query Syntax DISPlay ANNota...

Страница 255: ...tation color You can choose white red or colors that match analog channels digital channels math waveforms reference waveforms or markers Query Syntax DISPlay ANNotation COLor The DISPlay ANNotation C...

Страница 256: ...ine character but the actual backslash and n characters in the string Carriage returns lessen the number of characters available for the annotation string Use DISPlay ANNotation TEXT to remotely clear...

Страница 257: ...he DISPlay CLEar command clears the display and resets all associated measurements If the oscilloscope is stopped all currently displayed data is erased If the oscilloscope is running all of the data...

Страница 258: ...on to DISPlay Commands on page 252 HARDcopy INKSaver on page 301 PRINt on page 175 RCL Recall on page 135 SAV Save on page 139 VIEW on page 182 Example Code IMAGE_TRANSFER In this example we will quer...

Страница 259: ...and off Query Syntax DISPlay LABel The DISPlay LABel query returns the display mode of the analog and digital labels Return Format value NL value 0 1 See Also Introduction to DISPlay Commands on page...

Страница 260: ...LABList query returns the label list Return Format binary block NL binary block an ordered list of up to 75 labels a maximum of 10 characters each separated by newline characters See Also Introduction...

Страница 261: ...the persistence setting MINimum indicates zero persistence INFinite indicates infinite persistence time for variable persistence that is you can specify how long acquisitions remain on the screen Use...

Страница 262: ...VECTors vectors vectors 1 ON The only legal value for the DISPlay VECTors command is ON or 1 This specifies that lines are drawn between acquired data points on the screen Query Syntax DISPlay VECTor...

Страница 263: ...d Query Returns DVM ARANge 0 OFF 1 ON see page 264 DVM ARANge see page 264 0 1 n a DVM CURRent see page 265 dvm_value floating point number in NR3 format DVM ENABle 0 OFF 1 ON see page 266 DVM ENABle...

Страница 264: ...al scale vertical ground level position and trigger threshold voltage level used for the counter frequency measurement are automatically adjusted The Auto Range capability overrides attempted adjustme...

Страница 265: ...see page 790 Query Syntax DVM CURRent The DVM CURRent query returns the displayed 3 digit DVM value based on the current mode Return Format dvm_value NL dvm_value floating point number in NR3 format...

Страница 266: ...etting OFF 0 ON 1 The DVM ENABle command turns the digital voltmeter DVM analysis feature on or off Query Syntax DVM ENABle The DVM ENABle query returns a flag indicating whether the digital voltmeter...

Страница 267: ...Query Syntax DVM FREQuency The DVM FREQuency query returns the displayed 5 digit frequency value that is displayed below the main DVM value Return Format freq_value NL freq_value floating point numbe...

Страница 268: ...value of the acquired data with the DC component removed DC displays the DC value of the acquired data DCRMs displays the root mean square value of the acquired data FREQuency displays the frequency...

Страница 269: ...channel on which digital voltmeter DVM measurements are made The selected channel does not have to be on displaying a waveform in order for DVM measurements to be made Query Syntax DVM SOURce The DVM...

Страница 270: ...270 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 14 DVM Commands...

Страница 271: ...orting the Setup 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...

Страница 272: ...or product compatibility The only legal value is 0 or OFF Use the TRIGger HFReject command to limit bandwidth on the external trigger input Query Syntax EXTernal BWLimit The EXTernal BWLimit query ret...

Страница 273: ...ce constants for scaling the display factors and for setting trigger levels If an AutoProbe probe is connected to the oscilloscope the attenuation value cannot be changed from the sensed value Attempt...

Страница 274: ...sing 1 1 probe attenuation the range can only be set to 8 0 V If the probe attenuation is changed the range value is multiplied by the probe attenuation factor Query Syntax EXTernal RANGe The EXTernal...

Страница 275: ...for a voltage probe and select AMPere for a current probe Measurement results channel sensitivity and trigger level will reflect the measurement units you select Query Syntax EXTernal UNITs The CHANn...

Страница 276: ...276 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 15 EXTernal Trigger Commands...

Страница 277: ...SPAN span see page 282 FUNCtion FFT SPAN see page 282 span the current frequency span in NR3 format Legal values are 1 Hz to 100 GHz FUNCtion FFT VTYPe units see page 283 FUNCtion FFT VTYPe see page 2...

Страница 278: ...ge see page 290 FUNCtion RANGe see page 290 range the full scale vertical axis value in NR3 format The range for ADD SUBT MULT is 8E 6 to 800E 3 The range for the FFT function is 8 to 800 dBV FUNCtion...

Страница 279: ...e from time to frequency Hz and the vertical cursors change from volts to decibel dB Reporting the Setup Use FUNCtion to query setup information for the FUNCtion subsystem Return Format The following...

Страница 280: ...the function on or off When ON is selected the function performs as specified using the other FUNCtion commands When OFF is selected function is neither calculated nor displayed Query Syntax FUNCtion...

Страница 281: ...UNCtion FFT CENTer query returns the current center frequency in Hertz Return Format frequency NL frequency the current center frequency in NR3 format The range of legal values is from 0 Hz to 25 GHz...

Страница 282: ...cule when FFT Fast Fourier Transform is selected Query Syntax FUNCtion FFT SPAN The FUNCtion FFT SPAN query returns the current frequency span in Hertz Return Format span NL span the current frequency...

Страница 283: ...NCtion FFT VTYPe units units DECibel VRMS The FUNCtion FFT VTYPe command specifies FFT vertical units as DECibel or VRMS Query Syntax FUNCtion FFT VTYPe The FUNCtion FFT VTYPe query returns the curren...

Страница 284: ...othly at the start and end of the record are employed as filters to the FFTs Each window is useful for certain classes of input signals RECTangular useful for transient signals and signals where there...

Страница 285: ...nput to the FFT function ADD Source1 source2 SUBTract Source1 source2 MULTiply Source1 source2 The FUNCtion GOFT SOURce1 and FUNCtion GOFT SOURce2 commands are used to select source1 and source2 Query...

Страница 286: ...and selects the first input channel for the g t source that can be used as the input to the FFT function Query Syntax FUNCtion GOFT SOURce1 The FUNCtion GOFT SOURce1 query returns the current selectio...

Страница 287: ...command selects the second input channel for the g t source that can be used as the input to the FFT function Query Syntax FUNCtion GOFT SOURce2 The FUNCtion GOFT SOURce2 query returns the current sel...

Страница 288: ...cale of the selected function but will vary by function If you set the offset to a value outside of the legal range the offset value is automatically set to the nearest legal value Query Syntax FUNCti...

Страница 289: ...2 FFT Fast Fourier Transform on the selected waveform source When the operation is ADD SUBTract or MULTiply the FUNCtion SOURce1 and FUNCtion SOURce2 commands are used to select source1 and source2 Fo...

Страница 290: ...value in NR3 format The FUNCtion RANGe command defines the full scale vertical axis for the selected function Query Syntax FUNCtion RANGe The FUNCtion RANGe query returns the current full scale range...

Страница 291: ...le of the selected function but will vary by function If you set the reference level to a value outside of the legal range the level is automatically set to the nearest legal value Query Syntax FUNCti...

Страница 292: ...B The FUNCtion SCALe command sets the vertical scale or units per division of the selected function Legal values for the scale depend on the selected function Query Syntax FUNCtion SCALe The FUNCtion...

Страница 293: ...r the FFT function It lets you specify as the function input source the addition subtraction or multiplication of two channels When GOFT is used the g t source is specified by the FUNCtion GOFT OPERat...

Страница 294: ...ource If CHANnel1 or CHANnel2 is selected for FUNCtion SOURce1 the SOURce2 selection can be CHANnel1 or CHANnel2 Likewise if CHANnel3 or CHANnel4 is selected for FUNCtion SOURce1 the SOURce2 selection...

Страница 295: ...ex name index integer index of printer in list name name of printer in list HARDcopy FACTors 0 OFF 1 ON see page 299 HARDcopy FACTors see page 299 0 1 HARDcopy FFEed 0 OFF 1 ON see page 300 HARDcopy F...

Страница 296: ...ued following the RST command HARD APR AREA SCR FACT 0 FFE 0 INKS 1 PAL NONE LAY PORT HARDcopy NETWork PAS Sword password see page 306 n a password quoted ASCII string HARDcopy NETWork SLO T slot see...

Страница 297: ...urrently the only legal choice is SCReen Query Syntax HARDcopy AREA The HARDcopy AREA query returns the selected display area Return Format area NL area SCR See Also Introduction to HARDcopy Commands...

Страница 298: ...name index integer index of printer in list name name of printer in list The HARDcopy APRinter command sets the active printer Query Syntax HARDcopy APRinter The HARDcopy APRinter query returns the n...

Страница 299: ...e scale factors are output on the hardcopy dump Query Syntax HARDcopy FACTors The HARDcopy FACTors query returns a flag indicating whether oscilloscope instrument settings are output on the hardcopy R...

Страница 300: ...output between the screen image and factors of a hardcopy dump Query Syntax HARDcopy FFEed The HARDcopy FFEed query returns a flag indicating whether a formfeed is output at the end of the hardcopy du...

Страница 301: ...ntrols whether the graticule colors are inverted or not Query Syntax HARDcopy INKSaver The HARDcopy INKSaver query returns a flag indicating whether graticule colors are inverted or not Return Format...

Страница 302: ...HARDcopy LAYout command sets the hardcopy layout mode Query Syntax HARDcopy LAYout The HARDcopy LAYout query returns the selected hardcopy layout mode Return Format layout NL layout LAND PORT See Als...

Страница 303: ...t The network printer slot is selected by the HARDcopy NETWork SLOT command To apply the entered address use the HARDcopy NETWork APPLy command Query Syntax HARDcopy NETWork ADDRess The HARDcopy NETWo...

Страница 304: ...ETWork APPLy The HARDcopy NETWork APPLy command applies the network printer settings and makes the printer connection See Also Introduction to HARDcopy Commands on page 296 HARDcopy NETWork SLOT on pa...

Страница 305: ...e domain name setting is a common setting for both network printer slots Query Syntax HARDcopy NETWork DOMain The HARDcopy NETWork DOMain query returns the current Windows network domain name Return F...

Страница 306: ...HARDcopy NETWork PASSword command sets the password for the specified Windows network domain and user name The password setting is a common setting for both network printer slots See Also Introductio...

Страница 307: ...ress and apply commands There are two network printer slots to choose from Query Syntax HARDcopy NETWork SLOT The HARDcopy NETWork SLOT query returns the currently selected network printer slot Return...

Страница 308: ...Windows network domain The user name setting is a common setting for both network printer slots Query Syntax HARDcopy NETWork USERname The HARDcopy NETWork USERname query returns the currently set us...

Страница 309: ...rint driver cannot print color images to color laser printers so the COLor option is not available when connected to laser printers Query Syntax HARDcopy PALette The HARDcopy PALette query returns the...

Страница 310: ...ARDcopy PRINter LIST query returns a list of available printers The list can be empty Return Format list NL list printer_spec printer_spec printer_spec index active name index integer index of printer...

Страница 311: ...Syntax HARDcopy STARt The HARDcopy STARt command starts a print job See Also Introduction to HARDcopy Commands on page 296 HARDcopy APRinter on page 298 HARDcopy PRINter LIST on page 310 HARDcopy FAC...

Страница 312: ...312 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 17 HARDcopy Commands...

Страница 313: ...ay and return data from the Lister display Table 68 LISTer Commands Summary Command Query Options and Query Returns n a LISTer DATA see page 314 binary_block comma separated data with newlines at the...

Страница 314: ...page 790 Query Syntax LISTer DATA The LISTer DATA query returns the lister data Return Format binary block NL binary_block comma separated data with newlines at the end of each row See Also Introducti...

Страница 315: ...in the Lister or whether the Lister is off ON or 1 is the same as SBUS1 When set to ALL the decode information for different buses is interleaved in time Serial bus decode must be on before it can be...

Страница 316: ...EFerence command selects whether the time value for a Lister row is relative to the trigger ot the previous Lister row Query Syntax LISTer REFerence The LISTer REFerence query returns the Lister time...

Страница 317: ...x s ms us ns ps Hz kHz MHz return_value X1 cursor position value in NR3 format MARKer X1Y1source source see page 321 MARKer X1Y1source see page 321 source CHANnel n FUNCtion MATH WMEMory r n 1 to anal...

Страница 318: ...Y1 CHAN1 X2Y2 CHAN1 MODE MAN MARKer XUNits mode see page 325 MARKer XUNits see page 325 units SEConds HERTz DEGRees PERCent MARKer XUNits USE see page 326 n a n a MARKer Y1Position position suffix see...

Страница 319: ...g the mode to MEASurement sets the marker sources MARKer X1Y1source and MARKer X2Y2source to the measurement source MEASure SOURce Setting the measurement source remotely always sets the marker source...

Страница 320: ...Query Syntax MARKer X1Position The MARKer X1Position query returns the current X1 cursor position This is functionally equivalent to the obsolete MEASure TSTArt command query Return Format position NL...

Страница 321: ...e pair of markers for example X1Y1 sets the source for the other for example X2Y2 If the marker mode is currently WAVeform the X1Y1 source can be set separate from the X2Y2 source If MARKer MODE is se...

Страница 322: ...er XUNits command Query Syntax MARKer X2Position The MARKer X2Position query returns current X2 cursor position This is functionally equivalent to the obsolete MEASure TSTOp command query Return Forma...

Страница 323: ...e pair of markers for example X2Y2 sets the source for the other for example X1Y1 If the marker mode is currently WAVeform the X2Y2 source can be set separate from the X1Y1 source If MARKer MODE is se...

Страница 324: ...are set by the MARKer XUNits command Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 318 MARKer MODE on page 319 MARKer X1Position on page...

Страница 325: ...360 degrees PERCent for making ratio measurements Use the MARKer XUNits USE command to set the current X1 location as 0 percent and the current X2 location as 100 percent Changing X units affects the...

Страница 326: ...ARKer XUNits USE command sets the current X1 location as 0 percent and the current X2 location as 100 percent Once the 0 and 360 degree or 0 and 100 percent locations are set inputs to and outputs fro...

Страница 327: ...ns cannot be set Query Syntax MARKer Y1Position The MARKer Y1Position query returns current Y1 cursor position This is functionally equivalent to the obsolete MEASure VSTArt command query Return Forma...

Страница 328: ...ons cannot be set Query Syntax MARKer Y2Position The MARKer Y2Position query returns current Y2 cursor position This is functionally equivalent to the obsolete MEASure VSTOp command query Return Forma...

Страница 329: ...MARKer YUNits command Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 318 MARKer MODE on page 319 MARKer X1Y1source on page 321 MARKer X2Y2...

Страница 330: ...rrent Y1 location as 0 percent and the current Y2 location as 100 percent Changing Y units affects the input and output values of the MARKer Y1Position MARKer Y2Position and MARKer YDELta commands que...

Страница 331: ...d the current Y2 location as 100 percent Once the 0 and 100 percent locations are set inputs to and outputs from the MARKer Y1Position MARKer Y2Position and MARKer YDELta commands queries are relative...

Страница 332: ...332 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 19 MARKer Commands...

Страница 333: ...344 MEASure DEFine DELay see page 345 delay spec edge_spec1 edge_spec2 edge_spec1 slope occurrence edge_spec2 slope occurrence slope occurrence integer MEASure DEFine THResholds threshold spec see pa...

Страница 334: ...0 source CHANnel n FUNCtion MATH WMEMory r for DSO models source CHANnel n DIGital d FUNCtion MATH WMEMory r for MSO models n 1 to analog channels in NR1 format r 1 2 in NR1 format d 0 to digital chan...

Страница 335: ...1 format r 1 2 in NR1 format return_value the percent of the overshoot of the selected waveform in NR3 format MEASure PERiod source see page 355 MEASure PERiod source see page 355 source CHANnel n FUN...

Страница 336: ...FUNCtion MATH WMEMory r for DSO models source CHANnel n DIGital d FUNCtion MATH WMEMory r for MSO models n 1 to analog channels in NR1 format r 1 2 in NR1 format d 0 to digital channels 1 in NR1 form...

Страница 337: ...format d 0 to digital channels 1 in NR1 format return_value source NONE n a MEASure TEDGe slope occurrence source see page 363 slope direction of the waveform occurrence the transition to be reported...

Страница 338: ...page 367 MEASure VAMPlitude source see page 367 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format return_value the amplitude of the selected waveform in...

Страница 339: ...NR1 format return_value minimum voltage of the selected waveform in NR3 format MEASure VPP source see page 372 MEASure VPP source see page 372 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog c...

Страница 340: ...or MSO models n 1 to analog channels in NR1 format r 1 2 in NR1 format d 0 to digital channels 1 in NR1 format return_value voltage at the specified time in NR3 format MEASure VTOP source see page 375...

Страница 341: ...not three edges the oscilloscope will revert to the mode of making the measurement at the start of the main sweep When the command form is used the measurement result is displayed on the instrument Wh...

Страница 342: ...X Series Oscilloscopes Programmer s Guide 20 MEASure Commands MEASure ALL see page 790 Command Syntax MEASure ALL This command installs a Snapshot All measurement on the screen See Also Introduction t...

Страница 343: ...ion 2000 X Series Oscilloscopes Programmer s Guide 343 MEASure CLEar see page 790 Command Syntax MEASure CLEar This command clears all selected measurements and markers from the screen See Also Introd...

Страница 344: ...entifies which measurement results that can be affected by redefining the DELay specification or the THResholds values For example changing the THResholds definition from the default 10 50 and 90 valu...

Страница 345: ...middle and upper measurement thresholds to 10 50 and 90 values between Vbase and Vtop Threshold mode PERCent sets the measurement thresholds to any user defined percentages between 5 and 95 of values...

Страница 346: ...er threshold percentage values between Vbase and Vtop in NR3 format for meas_spec THResholds and threshold mode ABSolute THR ABS upper middle lower NL upper middle lower A number specifying the upper...

Страница 347: ...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...

Страница 348: ...delay measurement point nearer to Vtop or Vbase you must change the threshold values with the MEASure DEFine THResholds command Return Format value NL value floating point number delay time in seconds...

Страница 349: ...re DUTYcycle source The MEASure DUTYcycle query measures and outputs the duty cycle of the signal specified by the MEASure SOURce command The value returned for the duty cycle is the ratio of the posi...

Страница 350: ...modified Query Syntax MEASure FALLtime source The MEASure FALLtime query measures and outputs the fall time of the displayed falling negative going edge closest to the trigger reference The fall time...

Страница 351: ...fied the current source is modified IF the edge on the screen closest to the trigger reference is rising THEN frequency 1 time at trailing rising edge time at leading rising edge ELSE frequency 1 time...

Страница 352: ...rce parameter is not specified the current source is modified Query Syntax MEASure NWIDth source The MEASure NWIDth query measures and outputs the width of the negative pulse on the screen closest to...

Страница 353: ...ax or Vmin depending on whether the edge is rising or falling For a rising edge overshoot Vmax Vtop Vtop Vbase x 100 For a falling edge overshoot Vbase Vmin Vtop Vbase x 100 Vtop and Vbase are taken f...

Страница 354: ...354 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 20 MEASure Commands MEASure VTOP on page 375 MEASure VBASe on page 369 MEASure VMIN on page 371...

Страница 355: ...od source The MEASure PERiod query measures and outputs the period of the cycle closest to the trigger reference on the screen The period is measured at the midpoint of the upper and lower thresholds...

Страница 356: ...een the specified sources A phase measurement is a combination of the period and delay measurements First the period is measured on source1 Then the delay is measured between source1 and source2 The e...

Страница 357: ...d either Vmin or Vmax depending on whether the edge is rising or falling For a rising edge preshoot Vmin Vbase Vtop Vbase x 100 For a falling edge preshoot Vmax Vtop Vtop Vbase x 100 Vtop and Vbase ar...

Страница 358: ...is modified Query Syntax MEASure PWIDth source The MEASure PWIDth query measures and outputs the width of the displayed positive pulse closest to the trigger reference Pulse width is measured at the...

Страница 359: ...e of the displayed rising positive going edge closest to the trigger reference For maximum measurement accuracy set the sweep speed as fast as possible while leaving the leading edge of the waveform o...

Страница 360: ...mmand Syntax MEASure SHOW show show 1 ON The MEASure SHOW command enables markers for tracking measurements on the display This feature is always on Query Syntax MEASure SHOW The MEASure SHOW query re...

Страница 361: ...new value If MARKer MODE is set to OFF or MANual setting MEASure SOURce to CHANnel n FUNCtion or MATH will also set MARKer X1Y1source to source1 and MARKer X2Y2source to source2 EXTernal is only a val...

Страница 362: ...y for duty cycle varQueryResult myScope ReadNumber Read duty cycle MsgBox Duty cycle vbCrLf _ FormatNumber varQueryResult 3 myScope WriteString MEASURE RISETIME Query for risetime varQueryResult mySco...

Страница 363: ...ope selects a rising or falling edge If no sign is specified for the slope it is assumed to be the rising edge The magnitude of occurrence defines the occurrence to be reported For example 3 returns t...

Страница 364: ...1 on ch 2 dblChan2Edge1 myScope ReadNumber Calculate delay time between ch1 and ch2 dblDelay dblChan2Edge1 dblChan1Edge1 Write calculated delay time to screen MsgBox Delay vbCrLf CStr dblDelay Make a...

Страница 365: ...d occurrence is returned as the response to the query The specified value can be negative or positive To specify a negative value use a minus sign The sign of the slope selects a rising or falling edg...

Страница 366: ...Series Oscilloscopes Programmer s Guide 20 MEASure Commands value time in seconds of the specified value crossing in NR3 format See Also Introduction to MEASure Commands on page 340 MEASure TEDGe on p...

Страница 367: ...e optional source parameter is specified the current source is modified Query Syntax MEASure VAMPlitude source The MEASure VAMPlitude query measures and returns the vertical amplitude of the waveform...

Страница 368: ...tional source parameter is specified the current source is modified The interval option lets you specify the measurement interval either an integral number of cycles or the full screen If interval is...

Страница 369: ...parameter is specified the current source is modified Query Syntax MEASure VBASe source The MEASure VBASe query returns the vertical value at the base of the waveform The base value of a pulse is norm...

Страница 370: ...ent and starts a maximum vertical value measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VMAX source The MEASure VMAX query measures and ou...

Страница 371: ...and starts a minimum vertical value measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VMIN source The MEASure VMIN query measures and output...

Страница 372: ...e is modified Query Syntax MEASure VPP source The MEASure VPP query measures the maximum and minimum vertical value for the selected source then calculates the vertical peak to peak value and returns...

Страница 373: ...ber of cycles or the full screen If interval is not specified DISPlay is implied The type option lets you choose between a DC RMS measurement and an AC RMS measurement If type is not specified DC is i...

Страница 374: ...to digital channels 1 in NR1 format The MEASure VTIMe query returns the value at a specified time on the source specified with MEASure SOURce The specified time must be on the screen and is referenced...

Страница 375: ...top value measurement Query Syntax MEASure VTOP source The MEASure VTOP query returns the vertical value at the top of the waveform The top value of the pulse is normally not the same as the maximum v...

Страница 376: ...measurement window MAIN the measurement window is the upper Main window ZOOM the measurement window is the lower Zoom window AUTO the measurement is attempted in the lower Zoom window if it cannot be...

Страница 377: ...els n 1 2 for 2ch models MTESt AMASk UNITs units see page 385 MTESt AMASk UNITs see page 385 units CURRent DIVisions MTESt AMASk XDELta value see page 386 MTESt AMASk XDELta see page 386 value X delta...

Страница 378: ...CTion SAVE 0 OFF 1 ON see page 399 MTESt RMODe FACTion SAVE see page 399 0 1 MTESt RMODe FACTion STOP 0 OFF 1 ON see page 400 MTESt RMODe FACTion STOP see page 400 0 1 MTESt RMODe SIGMa level see page...

Страница 379: ...0 Y2 3 00000E 00 BIND 0 MTES RMOD 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 Re...

Страница 380: ...Scope ReadNumber Debug Print Mask test termination test sigma _ FormatNumber varQueryResult Use auto mask to create mask myScope WriteString MTESt AMASk SOURce CHANnel1 myScope WriteString MTESt AMASk...

Страница 381: ...or RUN bit stopped mask test termination lngElapsed 0 Do While lngElapsed lngTimeout myScope WriteString OPERegister CONDition varQueryResult myScope ReadNumber Operation Status Condition Register RUN...

Страница 382: ...e MTESt ALL command specifies the channel s that are included in the mask test ON All displayed analog channels are included in the mask test OFF Just the selected source channel is included in the te...

Страница 383: ...and MTESt AMASk UNITs commands The mask only encompasses the portion of the waveform visible on the display so you must ensure that the waveform is acquired and displayed consistently to obtain repea...

Страница 384: ...hannel units as set by the CHANnel n UNITs command of the selected source Suppose that UNITs are CURRent and that you set SOURce to CHANNEL1 which is using units of volts Then you can define AMASk XDE...

Страница 385: ...ubsystem uses the graticule as the measurement system so tolerance settings are specified as parts of a screen division The mask test subsystem maintains separate XDELta and YDELta settings for CURRen...

Страница 386: ...ting for MTESt AMASk UNITs is CURRent and the current setting specifies time in the horizontal direction the tolerance will be 250 ms If the setting for MTESt AMASk UNITs is DIVisions the same X delta...

Страница 387: ...r MTESt AMASk UNITs is CURRent and the current setting specifies voltage in the vertical direction the tolerance will be 250 mV If the setting for MTESt AMASk UNITs is DIVisions the same Y delta value...

Страница 388: ...ent mask test run This count is for all regions and all waveforms collected on the channel specified by the optional parameter or collected on the currently specified source channel MTESt SOURce if th...

Страница 389: ...Guide 389 MTESt COUNt RESet see page 790 Command Syntax MTESt COUNt RESet The MTESt COUNt RESet command resets the mask statistics See Also Introduction to MTESt Commands on page 379 MTESt COUNt WAVe...

Страница 390: ...COUNt TIME The MTESt COUNt TIME query returns the elapsed time in the current mask test run Return Format time NL time elapsed seconds in NR3 format See Also Introduction to MTESt Commands on page 37...

Страница 391: ...rms The MTESt COUNt WAVeforms query returns the total number of waveforms acquired in the current mask test run Return Format count NL count number of waveforms in NR1 format See Also Introduction to...

Страница 392: ...d loads a mask from binary block data These are the data bytes found in a msk file Query Syntax MTESt DATA The MTESt DATA query returns a mask in binary block data format The format for the data trans...

Страница 393: ...00 X Series Oscilloscopes Programmer s Guide 393 MTESt DELete see page 790 Command Syntax MTESt DELete The MTESt DELete command clears the currently loaded mask See Also Introduction to MTESt Commands...

Страница 394: ...n_off on_off 1 ON 0 OFF The MTESt ENABle command enables or disables the mask test features ON Enables the mask test features OFF Disables the mask test features Query Syntax MTESt ENABle The MTESt EN...

Страница 395: ...disables the mask lock feature ON Locks a mask to the SOURce As the vertical or horizontal scaling or position of the SOURce changes the mask is redrawn accordingly OFF The mask is static and does not...

Страница 396: ...age 401 command TIME the mask test runs for a fixed amount of time The amount of time is set by the MTESt RMODe TIME on page 402 command WAVeforms the mask test runs until a fixed number of waveforms...

Страница 397: ...tics run only on waveforms that contain a mask violation passing waveforms do not affect measurements and measurement statistics This mode is not available when the acquisition mode is set to Averagin...

Страница 398: ...starting on page 295 for more information on setting the hardcopy device and formatting options Query Syntax MTESt RMODe FACTion PRINt The MTESt RMODe FACTion PRINt query returns the current mask fail...

Страница 399: ...4 SAVE Commands starting on page 425 for more information on save options Query Syntax MTESt RMODe FACTion SAVE The MTESt RMODe FACTion SAVE query returns the current mask failure save setting Return...

Страница 400: ...ilure on or off When this setting is ON and a mask violation is detected the mask test is stopped and the acquisition system is stopped Query Syntax MTESt RMODe FACTion STOP The MTESt RMODe FACTion ST...

Страница 401: ...est sigma is the best achievable process sigma assuming no failures Process sigma is calculated using the number of failures per test The test sigma level indirectly specifies the number of waveforms...

Страница 402: ...400 in NR3 format When the MTESt RMODe command is set to TIME the MTESt RMODe TIME command sets the number of seconds for a mask test to run Query Syntax MTESt RMODe TIME The MTESt RMODe TIME query re...

Страница 403: ...00 000 When the MTESt RMODe command is set to WAVeforms the MTESt RMODe WAVeforms command sets the number of waveform acquisitions that are mask tested Query Syntax MTESt RMODe WAVeforms The MTESt RMO...

Страница 404: ...nd the 0 Level controls track each other Adjusting either the 1 Level or the 0 Level control shifts the position of the mask up or down without changing its size OFF If the Bind 1 0 Levels control is...

Страница 405: ...ms an X value of 0 100 is a vertex at 110 ms The oscilloscope uses this equation to normalize vertices This simplifies reprogramming to handle different data rates For example if you halve the period...

Страница 406: ...it is best if you define XDELta as a pulse width or bit period Then a change in data rate without corresponding changes in the waveform can easily be handled by changing X The X coordinate of polygon...

Страница 407: ...he boundaries set by SCALe Y1 and SCALe Y2 according to the equation Y Y Y2 Y1 Y1 Thus if you set Y1 to 100 mV and Y2 to 1 V a Y value of 0 100 in a vertex is at 190 mV The Y1 value is a voltage value...

Страница 408: ...ries defined by SCALe Y1 and SCALe Y2 according to the following equation Y Y Y2 Y1 Y1 Thus if you set Y1 to 100 mV and Y2 to 1 V a Y value of 0 100 in a vertex is at 190 mV The Y2 value is a voltage...

Страница 409: ...SOURce command selects the channel which is configured by the commands contained in a mask file when it is loaded Query Syntax MTESt SOURce The MTESt SOURce query returns the channel which is configur...

Страница 410: ...Syntax MTESt TITLe The MTESt TITLe query returns the mask title which is a string of up to 128 characters The title is displayed in the mask test dialog box and mask test tab when a mask file is loade...

Страница 411: ...stem Return Format The following is a sample response from the POD1 query In this case the query was issued following a RST command POD1 DISP 0 THR 1 40E 00 Table 72 POD n Commands Summary Command Que...

Страница 412: ...command POD1 D0 D7 The POD n DISPlay command turns displaying of the specified group of channels on or off Query Syntax POD n DISPlay The POD n DISPlay query returns the current display setting of th...

Страница 413: ...re affected by the command POD1 D0 D7 value SMALl MEDium LARGe The POD n SIZE command specifies the size of digital channels on the display Query Syntax POD n SIZE The POD n SIZE query returns the dig...

Страница 414: ...Query Syntax POD n THReshold The POD n THReshold query returns the threshold value for the specified group of channels Return Format threshold NL threshold Floating point number in NR3 format See Als...

Страница 415: ...iVision 2000 X Series Oscilloscopes Programmer s Guide 415 Set external channel to TTL threshold short form myScope WriteString TRIG LEV TTL EXT See complete example programs at Chapter 38 Programming...

Страница 416: ...416 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 22 POD Commands...

Страница 417: ...and Query Returns RECall FILename base_name see page 419 RECall FILename see page 419 base_name quoted ASCII string RECall MASK STARt file_spec see page 420 n a file_spec internal_loc file_name intern...

Страница 418: ...Vision 2000 X Series Oscilloscopes Programmer s Guide 23 RECall Commands Return Format The following is a sample response from the RECall query In this case the query was issued following the RST comm...

Страница 419: ...ame command specifies the source for any RECall operations Query Syntax RECall FILename The RECall FILename query returns the current RECall filename Return Format base_name NL base_name quoted ASCII...

Страница 420: ...file_spec internal_loc file_name internal_loc 0 3 an integer in NR1 format file_name quoted ASCII string The RECall MASK STARt command recalls a mask See Also Introduction to RECall Commands on page 4...

Страница 421: ...path_name quoted ASCII string The RECall PWD command sets the present working directory for recall operations Query Syntax RECall PWD The RECall PWD query returns the currently set working directory...

Страница 422: ...pec file_spec internal_loc file_name internal_loc 0 9 an integer in NR1 format file_name quoted ASCII string The RECall SETup STARt command recalls an oscilloscope setup See Also Introduction to RECal...

Страница 423: ...RECall WMEMory r STARt file_name r 1 2 in NR1 format file_name quoted ASCII string The RECall WMEMory r STARt command recalls a reference waveform See Also Introduction to RECall Commands on page 417...

Страница 424: ...424 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 23 RECall Commands...

Страница 425: ...1 ON see page 430 SAVE IMAGe FACTors see page 430 0 1 SAVE IMAGe FORMat format see page 431 SAVE IMAGe FORMat see page 431 format TIFF BMP BMP24bit BMP8bit PNG NONE SAVE IMAGe INKSaver 0 OFF 1 ON see...

Страница 426: ...440 format ASCiixy CSV BINary NONE SAVE WAVeform LENGth length see page 441 SAVE WAVeform LENGth see page 441 length 100 to max length an integer in NR1 format SAVE WAVeform LENGth MAX 0 OFF 1 ON see...

Страница 427: ...up Use SAVE to query setup information for the SAVE subsystem 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...

Страница 428: ...SAVE operations Query Syntax SAVE FILename The SAVE FILename query returns the current SAVE filename Return Format base_name NL base_name quoted ASCII string See Also Introduction to SAVE Commands on...

Страница 429: ...NKSaver on page 432 SAVE IMAGe PALette on page 433 SAVE FILename on page 428 NOTE Be sure to set the SAVE IMAGe FORMat before saving an image If the format is NONE the save image command will not succ...

Страница 430: ...th the image Query Syntax SAVE IMAGe FACTors The SAVE IMAGe FACTors query returns a flag indicating whether oscilloscope factors are output along with the image Return Format factors NL factors 0 1 Se...

Страница 431: ...ype Query Syntax SAVE IMAGe FORMat The SAVE IMAGe FORMat query returns the selected image format type Return Format format NL format BMP BMP8 PNG NONE When NONE is returned it indicates that a wavefor...

Страница 432: ...command controls whether the graticule colors are inverted or not Query Syntax SAVE IMAGe INKSaver The SAVE IMAGe INKSaver query returns a flag indicating whether graticule colors are inverted or not...

Страница 433: ...scale The SAVE IMAGe PALette command sets the image palette color Query Syntax SAVE IMAGe PALette The SAVE IMAGe PALette query returns the selected image palette color Return Format palette NL palette...

Страница 434: ...AVE LISTer STARt file_name file_name quoted ASCII string The SAVE LISTer STARt command saves the Lister display data to a file See Also Introduction to SAVE Commands on page 426 SAVE FILename on page...

Страница 435: ...file_spec internal_loc file_name internal_loc 0 3 an integer in NR1 format file_name quoted ASCII string The SAVE MASK STARt command saves a mask See Also Introduction to SAVE Commands on page 426 SAV...

Страница 436: ...le_name quoted ASCII string The SAVE MULTi STARt command saves multi channel waveform data to a file This file can be opened by the N8900A InfiniiView oscilloscope analysis software See Also Introduct...

Страница 437: ...quoted ASCII string The SAVE PWD command sets the present working directory for save operations Query Syntax SAVE PWD The SAVE PWD query returns the currently set working directory for save operations...

Страница 438: ...pec file_spec internal_loc file_name internal_loc 0 9 an integer in NR1 format file_name quoted ASCII string The SAVE SETup STARt command saves an oscilloscope setup See Also Introduction to SAVE Comm...

Страница 439: ...n page 426 SAVE WAVeform FORMat on page 440 SAVE WAVeform LENGth on page 441 SAVE FILename on page 428 RECall SETup STARt on page 422 NOTE Be sure to set the SAVE WAVeform FORMat before saving wavefor...

Страница 440: ...information for all analog channels that are displayed turned on The proper file extension for this format is csv BINary creates an oscilloscope binary data format file See the User s Guide for a des...

Страница 441: ...orm data length that is the number of points saved When the SAVE WAVeform LENGth MAX setting is ON the SAVE WAVeform LENGth setting has no effect Query Syntax SAVE WAVeform LENGth The SAVE WAVeform LE...

Страница 442: ...X command specifies whether maximum number of waveform data points is saved When OFF the SAVE WAVeform LENGth command specifies the number of waveform data points saved Query Syntax SAVE WAVeform LENG...

Страница 443: ...d specifies which segments are included when the waveform is saved ALL all acquired segments are saved CURRent only the currently selected segment is saved Query Syntax SAVE WAVeform SEGMented The SAV...

Страница 444: ...saved as a reference waveform file Query Syntax SAVE WMEMory SOURce The SAVE WMEMory SOURce query returns the source to be saved as a reference waveform file Return Format source NL source CHAN n FUN...

Страница 445: ...Mory STARt file_name file_name quoted ASCII string The SAVE WMEMory STARt command saves oscilloscope waveform data to a reference waveform file See Also Introduction to SAVE Commands on page 426 SAVE...

Страница 446: ...446 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 24 SAVE Commands...

Страница 447: ...triggering will trigger on CAN version 2 0A and 2 0B signals Setup consists of connecting the oscilloscope to a CAN signal Baud rate signal source and signal polarity and type of data to trigger on c...

Страница 448: ...64 bits long UART RS 232 triggering with Option 232 lets you trigger on RS 232 serial data Reporting the Setup Use SBUS n to query setup information for the SBUS n subsystem Return Format The followin...

Страница 449: ...ammer s Guide 449 General SBUS n Commands Table 75 General SBUS n Commands Summary Command Query Options and Query Returns SBUS n DISPlay 0 OFF 1 ON see page 450 SBUS n DISPlay see page 450 0 1 SBUS n...

Страница 450: ...ry returns the current display setting of the serial decode bus Return Format display NL display 0 1 Errors 241 Hardware missing on page 753 See Also Introduction to SBUS n Commands on page 447 CHANne...

Страница 451: ...n MODE The SBUS n MODE query returns the current serial bus decode mode setting Return Format mode NL mode CAN IIC LIN SPI UART NONE Errors 241 Hardware missing on page 753 See Also Introduction to SB...

Страница 452: ...ating point in NR3 format SBUS n CAN SAMPlepo int value see page 459 SBUS n CAN SAMPlepo int see page 459 value 60 62 5 68 70 75 80 87 5 in NR3 format SBUS n CAN SIGNal B AUDrate baudrate see page 460...

Страница 453: ...NGth length see page 466 SBUS n CAN TRIGger PATTern DATA LENGth see page 466 length integer from 1 to 8 in NR1 format SBUS n CAN TRIGger PATTern ID string see page 467 SBUS n CAN TRIGger PATTern ID se...

Страница 454: ...age 790 Query Syntax SBUS n CAN COUNt ERRor Returns the error frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n CAN COU...

Страница 455: ...ge 790 Query Syntax SBUS n CAN COUNt OVERload Returns the overload frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n CA...

Страница 456: ...US n CAN COUNt RESet Resets the frame counters Errors 241 Hardware missing on page 753 See Also SBUS n CAN COUNt ERRor on page 454 SBUS n CAN COUNt OVERload on page 455 SBUS n CAN COUNt TOTal on page...

Страница 457: ...age 790 Query Syntax SBUS n CAN COUNt TOTal Returns the total frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n CAN COU...

Страница 458: ...ge 790 Query Syntax SBUS n CAN COUNt UTILization Returns the percent utilization Return Format percent NL percent floating point in NR3 format Errors 241 Hardware missing on page 753 See Also SBUS n C...

Страница 459: ...me where the bit level is sampled to determine whether the bit is dominant or recessive The sample point represents the percentage of time between the beginning of the bit time to the end of the bit t...

Страница 460: ...set to the nearest baud rate divisible by 100 b s You can also set the baud rate of the CAN signal to 5 Mb s Fractional baud rates between 4 Mb s and 5 Mb s are not allowed If the baud rate you selec...

Страница 461: ...nant low signals CANL the actual CAN_L differential bus signal RX the Receive signal from the CAN bus transceiver TX the Transmit signal to the CAN bus transceiver DIFL the CAN differential L H bus si...

Страница 462: ...r the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n CAN SOURce command sets the source for the CAN signal Query Syntax SBUS n CAN SOURce The SBUS n...

Страница 463: ...l trigger on the specified Id regardless if it is a Remote frame or a Data frame IDRemote will trigger on CAN frames matching the specified Id of a Remote frame ALLerrors will trigger on CAN active er...

Страница 464: ...mmand Query Syntax SBUS n CAN TRIGger The SBUS n CAN TRIGger query returns the current CAN trigger on condition Return Format condition NL condition SOF DATA ERR IDD IDE IDR ALL OVER ACK Errors 241 Ha...

Страница 465: ...X don t care characters otherwise it is a binary string made up of 0 1 and X don t care characters Query Syntax SBUS n CAN TRIGger PATTern DATA The SBUS n CAN TRIGger PATTern DATA query returns the cu...

Страница 466: ...ng The number of bytes in the string can be anywhere from 1 bytes to 8 bytes 64 bits The value for these bytes is set by the SBUS n CAN TRIGger PATTern DATA command Query Syntax SBUS n CAN TRIGger PAT...

Страница 467: ...made up of hexadecimal and X don t care characters otherwise it is a binary string made up of 0 1 and X don t care characters Query Syntax SBUS n CAN TRIGger PATTern ID The SBUS n CAN TRIGger PATTern...

Страница 468: ...selects the extended 29 bit identifier The CAN identifier is set by the SBUS n CAN TRIGger PATTern ID command Query Syntax SBUS n CAN TRIGger PATTern ID MODE The SBUS n CAN TRIGger PATTern ID MODE qu...

Страница 469: ...e 472 source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format SBUS n IIC TRIGger PATTern ADDRess...

Страница 470: ...e command determines whether the Read Write bit is included as the LSB in the display of the IIC address field of the decode bus Query Syntax SBUS n IIC ASIZe The SBUS n IIC ASIZe query returns the cu...

Страница 471: ...ANnel n DIGital d for the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n IIC SOURce CLOCk command sets the source for the IIC serial clock SCL Query...

Страница 472: ...e CHANnel n DIGital d for the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n IIC SOURce DATA command sets the source for IIC serial data SDA Query S...

Страница 473: ...ss for IIC data The address can range from 0x00 to 0x7F 7 bit or 0x3FF 10 bit hexadecimal Use the don t care address 1 or 0xFFFFFFFF to ignore the address value Query Syntax SBUS n IIC TRIGger PATTern...

Страница 474: ...mand sets IIC data The data value can range from 0x00 to 0x0FF hexadecimal Use the don t care data pattern 1 or 0xFFFFFFFF to ignore the data value Query Syntax SBUS n IIC TRIGger PATTern DATA The SBU...

Страница 475: ...mand sets IIC data 2 The data value can range from 0x00 to 0x0FF hexadecimal Use the don t care data pattern 1 or 0xFFFFFFFF to ignore the data value Query Syntax SBUS n IIC TRIGger PATTern DATa2 The...

Страница 476: ...The SBUS n IIC TRIGger QUALifier command sets the IIC data qualifier when TRIGger IIC TRIGger TYPE is set to READEprom Query Syntax SBUS n IIC TRIGger QUALifier The SBUS n IIC TRIGger QUALifier query...

Страница 477: ...g Start Address7 Write Ack Data The value WRITe is also accepted for WRITe7 W7Data2 7 bit address frame containing Start Address7 Write Ack Data Ack Data2 WRITe10 10 bit address frame containing Start...

Страница 478: ...mer s Guide 25 SBUS n Commands SBUS n IIC TRIGger PATTern ADDRess on page 473 SBUS n IIC TRIGger PATTern DATA on page 474 SBUS n IIC TRIGger PATTern DATa2 on page 475 SBUS n IIC TRIGger QUALifier on p...

Страница 479: ...25000 in 100 b s increments SBUS n LIN SOURce source see page 484 SBUS n LIN SOURce see page 484 source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog channe...

Страница 480: ...mal string nn n where n 0 1 X when base BINary string 0xnn n where n 0 9 A F X when base HEX SBUS n LIN TRIGger PATTern DATA LENGth length see page 491 SBUS n LIN TRIGger PATTern DATA LENGth see page...

Страница 481: ...hether the parity bits are included as the most significant bits MSB in the display of the Frame Id field in the LIN decode bus Query Syntax SBUS n LIN PARity The SBUS n LIN PARity query returns the c...

Страница 482: ...d to determine whether the bit is dominant or recessive The sample point represents the percentage of time between the beginning of the bit time to the end of the bit time Query Syntax SBUS n LIN SAMP...

Страница 483: ...ignal from 2400 b s to 625 kb s in 100 b s increments If you enter a baud rate that is not divisible by 100 b s the baud rate is set to the nearest baud rate divisible by 100 b s Query Syntax SBUS n L...

Страница 484: ...ANnel n DIGital d for the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n LIN SOURce command sets the source for the LIN signal Query Syntax SBUS n L...

Страница 485: ...3 LIN20 The SBUS n LIN STANdard command sets the LIN standard in effect for triggering and decoding to be LIN1 3 or LIN2 0 Query Syntax SBUS n LIN STANdard The SBUS n LIN STANdard query returns the cu...

Страница 486: ...to be greater than or equal to 11 12 or 13 clock lengths The sync break is the idle period in the bus activity at the beginning of each packet that distinguishes one information packet from the previo...

Страница 487: ...IGger ID command to specify the frame ID Use the SBUS n LIN TRIGger PATTern DATA LENGth and SBUS n LIN TRIGger PATTern DATA commands to specify the data string length and value Query Syntax SBUS n LIN...

Страница 488: ...exadecimal The SBUS n LIN TRIGger ID command defines the LIN identifier searched for in each CAN message when the LIN trigger mode is set to frame ID Setting the ID to a value of 1 results in 0xXX whi...

Страница 489: ...lue is used When base DECimal the X and characters cannot be entered When queried the character is returned when any bits in the pattern have the value of X and base DECimal When any bits in a given n...

Страница 490: ...es Oscilloscopes Programmer s Guide 25 SBUS n Commands See Also Introduction to TRIGger Commands on page 589 SBUS n LIN TRIGger PATTern FORMat on page 492 SBUS n LIN TRIGger on page 487 SBUS n LIN TRI...

Страница 491: ...ng The number of bytes in the string can be anywhere from 1 bytes to 8 bytes 64 bits The value for these bytes is set by the SBUS n LIN TRIGger PATTern DATA command Query Syntax SBUS n LIN TRIGger PAT...

Страница 492: ...mand sets the entry and query number base used by the SBUS n LIN TRIGger PATTern DATA command The default base is BINary Query Syntax SBUS n LIN TRIGger PATTern FORMat The SBUS n LIN TRIGger PATTern F...

Страница 493: ...FRAMing value see page 498 SBUS n SPI FRAMing see page 498 value CHIPselect NCHipselect NOTC TIMeout SBUS n SPI SOURce C LOCk source see page 499 SBUS n SPI SOURce C LOCk see page 499 value CHANnel n...

Страница 494: ...n MISO WIDTh width see page 504 SBUS n SPI TRIGger PATTern MISO WIDTh see page 504 width integer from 4 to 64 in NR1 format SBUS n SPI TRIGger PATTern MOSI DATA string see page 505 SBUS n SPI TRIGger...

Страница 495: ...order most significant bit first MSB or least significant bit first LSB used when displaying data in the serial decode waveform and in the Lister Query Syntax SBUS n SPI BITorder The SBUS n SPI BITor...

Страница 496: ...I CLOCk SLOPe command specifies the rising edge POSitive or falling edge NEGative of the SPI clock source that will clock in the data Query Syntax SBUS n SPI CLOCk SLOPe The SBUS n SPI CLOCk SLOPe que...

Страница 497: ...ut resource in seconds from 100 ns to 10 s when the SBUS n SPI FRAMing command is set to TIMeout The timer is used to frame a signal by a clock timeout Query Syntax SBUS n SPI CLOCk TIMeout The SBUS n...

Страница 498: ...framing value If TIMeout is selected the timeout value is set by the SBUS n SPI CLOCk TIMeout command Query Syntax SBUS n SPI FRAMing The SBUS n SPI FRAMing query returns the current SPI framing value...

Страница 499: ...mat d 0 to digital channels 1 in NR1 format The SBUS n SPI SOURce CLOCk command sets the source for the SPI serial clock Query Syntax SBUS n SPI SOURce CLOCk The SBUS n SPI SOURce CLOCk query returns...

Страница 500: ...d 0 to digital channels 1 in NR1 format The SBUS n SPI SOURce FRAMe command sets the frame source when SBUS n SPI FRAMing is set to CHIPselect or NOTChipselect Query Syntax SBUS n SPI SOURce FRAMe The...

Страница 501: ...ISO command sets the source for the SPI serial MISO data Query Syntax SBUS n SPI SOURce MISO The SBUS n SPI SOURce MISO query returns the current source for the SPI serial MISO data Return Format sour...

Страница 502: ...MOSI data You can also use the equivalent SBUS n SPI SOURce DATA command to set the MOSI data source Query Syntax SBUS n SPI SOURce MOSI The SBUS n SPI SOURce MOSI query returns the current source fo...

Страница 503: ...ta stream If the string parameter starts with 0x it is a hexadecimal string made up of hexadecimal and X don t care characters otherwise it is a binary string made up of 0 1 and X don t care character...

Страница 504: ...the SPI data pattern anywhere from 4 bits to 64 bits Query Syntax SBUS n SPI TRIGger PATTern MISO WIDTh The SBUS n SPI TRIGger PATTern MISO WIDTh query returns the current SPI data pattern width sett...

Страница 505: ...ta stream If the string parameter starts with 0x it is a hexadecimal string made up of hexadecimal and X don t care characters otherwise it is a binary string made up of 0 1 and X don t care character...

Страница 506: ...the SPI data pattern anywhere from 4 bits to 64 bits Query Syntax SBUS n SPI TRIGger PATTern MOSI WIDTh The SBUS n SPI TRIGger PATTern MOSI WIDTh query returns the current SPI data pattern width sett...

Страница 507: ...When triggering on MISO data the data value is specified by the SBUS n SPI TRIGger PATTern MISO DATA and SBUS n SPI TRIGger PATTern MISO WIDTh commands Query Syntax SBUS n SPI TRIGger TYPE The SBUS n...

Страница 508: ...t The SBUS n SPI WIDTh command determines the number of bits in a word of data for SPI Query Syntax SBUS n SPI WIDTh The SBUS n SPI WIDTh query returns the current SPI decode word width Return Format...

Страница 509: ...BUS n UART BITorde r see page 514 bitorder LSBFirst MSBFirst n a SBUS n UART COUNt E RRor see page 515 frame_count integer in NR1 format SBUS n UART COUNt R ESet see page 516 n a n a n a SBUS n UART C...

Страница 510: ...e 524 base ASCii HEX SBUS n UART TRIGger BURSt value see page 525 SBUS n UART TRIGger BURSt see page 525 value OFF 1 to 4096 in NR1 format SBUS n UART TRIGger DATA value see page 526 SBUS n UART TRIGg...

Страница 511: ...TYPE value see page 529 SBUS n UART TRIGger TYPE see page 529 value RSTArt RSTOp RDATa RD1 RD0 RDX PARityerror TSTArt TSTOp TDATa TD1 TD0 TDX SBUS n UART WIDTh width see page 530 SBUS n UART WIDTh see...

Страница 512: ...X The SBUS n UART BASE command determines the base to use for the UART decode and Lister display Query Syntax SBUS n UART BASE The SBUS n UART BASE query returns the current UART decode and Lister bas...

Страница 513: ...he serial decoder and or trigger when in UART mode The baud rate can be set from 100 b s to 8 Mb s If the baud rate you select does not match the system baud rate false triggers may occur Query Syntax...

Страница 514: ...ial decoder and or trigger when in UART mode LSBFirst sets the least significant bit of each message byte as transmitted first MSBFirst sets the most significant bit as transmitted first Query Syntax...

Страница 515: ...790 Query Syntax SBUS n UART COUNt ERRor Returns the UART error frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n UART...

Страница 516: ...mmand Syntax SBUS n UART COUNt RESet Resets the UART frame counters Errors 241 Hardware missing on page 753 See Also SBUS n UART COUNt ERRor on page 515 SBUS n UART COUNt RXFRames on page 517 SBUS n U...

Страница 517: ...e 790 Query Syntax SBUS n UART COUNt RXFRames Returns the UART Rx frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n UAR...

Страница 518: ...e 790 Query Syntax SBUS n UART COUNt TXFRames Returns the UART Tx frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n UAR...

Страница 519: ...mal nondecimal Bnn n where n 0 1 for binary The SBUS n UART FRAMing command determines the byte value to use for framing end of packet or to turn off framing for UART decode Query Syntax SBUS n UART F...

Страница 520: ...n UART PARity command selects the parity to be used with each message byte for the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART PARity The SBUS n UART PARity query returns...

Страница 521: ...US n UART POLarity command selects the polarity as idle low or idle high for the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART POLarity The SBUS n UART POLarity query return...

Страница 522: ...ls in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n UART SOURce RX command controls which signal is used as the Rx source by the serial decoder and or trigger when in UART mode Query S...

Страница 523: ...ls in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n UART SOURce TX command controls which signal is used as the Tx source by the serial decoder and or trigger when in UART mode Query S...

Страница 524: ...ion is from hexadecimal values The SBUS n UART TRIGger BASE setting does not affect the SBUS n UART TRIGger DATA command which can always set data values using ASCII or hexadecimal values Query Syntax...

Страница 525: ...nd selects the burst value Nth frame after idle period in the range 1 to 4096 or OFF for the trigger when in UART mode Query Syntax SBUS n UART TRIGger BURSt The SBUS n UART TRIGger BURSt query return...

Страница 526: ...ta value is used when one of the RD or TD trigger types is selected When entering an ASCII character via the quoted string it must be one of the 128 valid characters case sensitive NUL SOH STX ETX EOT...

Страница 527: ...mand selects the value of the idle period for burst trigger in the range from 1 us to 10 s when in UART mode Query Syntax SBUS n UART TRIGger IDLE The SBUS n UART TRIGger IDLE query returns the curren...

Страница 528: ...UART TRIGger QUALifier command selects the data qualifier when TYPE is set to RDATa RD1 RD0 RDX TDATa TD1 TD0 or TDX for the trigger when in UART mode Query Syntax SBUS n UART TRIGger QUALifier The SB...

Страница 529: ...TRIGger QUALifier commands are used to specify the data value and comparison operator The RD1 RD0 RDX TD1 TD0 and TDX types for triggering on data and alert bit values are only valid when a 9 bit widt...

Страница 530: ...n UART WIDTh command determines the number of bits 5 9 for each message byte for the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART WIDTh The SBUS n UART WIDTh query returns...

Страница 531: ...rol the event search modes and parameters for each search type See General SEARch Commands on page 532 SEARch SERial CAN Commands on page 536 SEARch SERial IIC Commands on page 542 SEARch SERial LIN C...

Страница 532: ...SEARch Commands Table 81 General SEARch Commands Summary Command Query Options and Query Returns n a SEARch COUNt see page 533 count an integer count value SEARch MODE value see page 534 SEARch MODE s...

Страница 533: ...illoscopes Programmer s Guide 533 SEARch COUNt see page 790 Query Syntax SEARch COUNt The SEARch COUNt query returns the number of search events found Return Format count NL count an integer count val...

Страница 534: ...alue SERial1 The SEARch MODE command selects the search mode The command is only valid when the SEARch STATe is ON Query Syntax SEARch MODE The SEARch MODE query returns the currently selected mode or...

Страница 535: ...90 Command Syntax SEARch STATe value value 0 OFF 1 ON The SEARch STATe command enables or disables the search feature Query Syntax SEARch STATe The SEARch STATe query returns returns the current setti...

Страница 536: ...ial CAN PA TTern DATA string see page 538 SEARch SERial CAN PA TTern DATA see page 538 string 0xnn n where n 0 9 A F X for hexadecimal SEARch SERial CAN PA TTern DATA LENGth length see page 539 SEARch...

Страница 537: ...tching the specified ID of a Data frame IDEither searches for the specified ID regardless if it is a Remote frame or a Data frame IDRemote searches for CAN frames matching the specified ID of a Remote...

Страница 538: ...he data value when searching for Data Frame ID and Data The length of the data value is specified using the SEARch SERial CAN PATTern DATA LENGth command Query Syntax SEARch SERial CAN PATTern DATA Th...

Страница 539: ...pecifies the length of the data value when searching for Data Frame ID and Data The data value is specified using the SEARch SERial CAN PATTern DATA command Query Syntax SEARch SERial CAN PATTern DATA...

Страница 540: ...ID value when searching for a CAN event The value can be a standard ID or an extended ID depending on the SEARch SERial CAN PATTern ID MODE command s setting Query Syntax SEARch SERial CAN PATTern ID...

Страница 541: ...specifies whether a standard ID value or an extended ID value is used when searching for a CAN event The ID value is specified using the SEARch SERial CAN PATTern ID command Query Syntax SEARch SERia...

Страница 542: ...h SERial IIC PA TTern ADDRess value see page 545 SEARch SERial IIC PA TTern ADDRess see page 545 value integer or string string 0xnn n 0 9 A F SEARch SERial IIC PA TTern DATA value see page 546 SEARch...

Страница 543: ...frames containing Start Address7 Read Ack Data Ack Data2 W7Data2 searches for 7 bit address frames containing Start Address7 Write Ack Data Ack Data2 RESTart searches for another start condition occu...

Страница 544: ...Series Oscilloscopes Programmer s Guide 26 SEARch Commands SEARch SERial IIC PATTern ADDRess on page 545 SEARch SERial IIC PATTern DATA on page 546 SEARch SERial IIC PATTern DATA2 on page 547 SEARch...

Страница 545: ...ng 0xnn n 0 9 A F The SEARch SERial IIC PATTern ADDRess command specifies address values when searching for IIC events To set don t care values use the integer 1 Query Syntax SEARch SERial IIC PATTern...

Страница 546: ...IC events To set don t care values use the integer 1 When searching for IIC EEPROM data read events you specify the data value qualifier using the SEARch SERial IIC QUALifier command Query Syntax SEAR...

Страница 547: ...IC PATTern DATA2 command specifies the second data value when searching for IIC events with two data values To set don t care values use the integer 1 Query Syntax SEARch SERial IIC PATTern DATA2 The...

Страница 548: ...ARch SERial IIC QUALifier command specifies the data value qualifier used when searching for IIC EEPROM data read events Query Syntax SEARch SERial IIC QUALifier The SEARch SERial IIC QUALifier query...

Страница 549: ...hexadecimal SEARch SERial LIN MO DE value see page 551 SEARch SERial LIN MO DE see page 551 value ID DATA ERRor SEARch SERial LIN PA TTern DATA string see page 552 SEARch SERial LIN PA TTern DATA see...

Страница 550: ...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 The SEARch SERial LIN ID command specifies the frame ID value when searching for LI...

Страница 551: ...ches for a frame ID DATA searches for a frame ID and data ERRor searches for errors Frame IDs are specified using the SEARch SERial LIN ID command Data values are specified using the SEARch SERial LIN...

Страница 552: ...Rial LIN PATTern FORMat command To set don t care values with the DATA command the FORMat must be HEX The length of the data value entered is specified using the SEARch SERial LIN PATTern DATA LENGth...

Страница 553: ...TA LENGth command specifies the the length of the data value when searching for LIN events The data value is specified using the SEARch SERial LIN PATTern DATA command Query Syntax SEARch SERial LIN P...

Страница 554: ...X DECimal The SEARch SERial LIN PATTern FORMat command specifies the number base used with the SEARch SERial LIN PATTern DATA command Query Syntax SEARch SERial LIN PATTern FORMat The SEARch SERial LI...

Страница 555: ...Options and Query Returns SEARch SERial SPI MO DE value see page 556 SEARch SERial SPI MO DE see page 556 value MOSI MISO SEARch SERial SPI PA TTern DATA string see page 557 SEARch SERial SPI PA TTer...

Страница 556: ...DE command specifies whether the SPI search will be on the MOSI data or the MISO data Data values are specified using the SEARch SERial SPI PATTern DATA command Query Syntax SEARch SERial SPI MODE The...

Страница 557: ...TTern DATA command specifies the data value when searching for SPI events The width of the data value is specified using the SEARch SERial SPI PATTern WIDTh command Query Syntax SEARch SERial SPI PATT...

Страница 558: ...n WIDTh command specifies the width of the data value in bytes when searching for SPI events The data value is specified using the SEARch SERial SPI PATTern DATA command Query Syntax SEARch SERial SPI...

Страница 559: ...255 0x00 0xff in decimal hexadecimal binary or quoted_string format 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...

Страница 560: ...f the 128 valid 7 bit ASCII characters or standard abbreviations The SEARch SERial UART DATA command specifies a data value when searching for UART RS232 events The data value qualifier is specified u...

Страница 561: ...is a don t care X TDATa searches for a transmit data value when data words are from 5 to 8 bits long TD1 searches for a transmit data value when data words are 9 bits long and the 9th alert bit is 1 T...

Страница 562: ...GREaterthan LESSthan The SEARch SERial UART QUALifier command specifies the data value qualifier when searching for UART RS232 events Query Syntax SEARch SERial UART QUALifier The SEARch SERial UART...

Страница 563: ...ring see page 566 n a string up to 75 characters as a quoted ASCII string n a SYSTem ERRor see page 567 error an integer error code error string quoted ASCII string See Error Messages see page 751 SYS...

Страница 564: ...lloscopes Programmer s Guide 27 SYSTem Commands Introduction to SYSTem Commands SYSTem subsystem commands enable writing messages to the display setting and reading both the time and the date querying...

Страница 565: ...NR1 format month 1 12 JANuary FEBruary MARch APRil MAY JUNe JULy AUGust SEPtember OCTober NOVember DECember day 1 31 The SYSTem DATE command sets the date Validity checking is performed to ensure that...

Страница 566: ...characters The SYSTem DSP command writes the quoted string excluding quotation marks to a text box in the center of the display Use SYStem DSP to remotely remove the message from the display Two sets...

Страница 567: ...edly sending the SYSTem ERRor query returns the errors in the order that they occurred until the queue is empty Any further queries then return zero until another error occurs Return Format error numb...

Страница 568: ...K value value 1 ON 0 OFF The SYSTem LOCK command disables the front panel LOCK ON is the equivalent of sending a local lockout message over the programming interface Query Syntax SYSTem LOCK The SYSTe...

Страница 569: ...lent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 569 SYSTem MENU see page 790 Command Syntax SYSTem MENU menu menu MASK MEASure SEGMented LISTer The SYSTem MENU command changes the fr...

Страница 570: ...ault Setup on the front panel When you perform a default setup some user settings like preferences remain unchanged To reset all user settings to their factory defaults use the RST command Reset condi...

Страница 571: ...ld TTL 1 4 V Display Menu Persistence Off Grid 20 Quick Meas Menu Source Channel 1 Run Control Scope is running Time Base Menu Main time division 100 us Main time base delay 0 00 s Delay time division...

Страница 572: ...mer s Guide 27 SYSTem Commands See Also Introduction to Common Commands on page 123 RST Reset on page 136 HF Reject and noise reject Off Holdoff 40 ns External probe attenuation 10 1 External Units Vo...

Страница 573: ...Tem PROTection LOCK value value 1 ON 0 OFF The SYSTem PROTection LOCK command disables the fifty ohm impedance setting for all analog channels Query Syntax SYSTem PROTection LOCK The SYSTem PROTection...

Страница 574: ...2 format See Also Introduction to SYSTem Commands on page 564 LRN Learn Device Setup on page 131 Example Code SAVE_SYSTEM_SETUP The SYSTEM SETUP query returns a program message that contains the curr...

Страница 575: ...loscopes Programmer s Guide 575 Write setup string back to oscilloscope using SYSTEM SETUP command myScope WriteIEEEBlock SYSTEM SETUP varSetupString CheckForInstrumentErrors See complete example prog...

Страница 576: ...t The SYSTem TIME command sets the system time using a 24 hour format Commas are used as separators Validity checking is performed to ensure that the time is valid Query Syntax SYSTem TIME time The SY...

Страница 577: ...nds in NR3 format TIMebase REFerence LEFT CENTer RIGHt see page 582 TIMebase REFerence see page 582 return_value LEFT CENTer RIGHt TIMebase SCALe scale_value see page 583 TIMebase SCALe see page 583 s...

Страница 578: ...el 1 becomes the X input and channel 2 becomes the Y input The time per division delay vernier control and reference can be controlled for the main and window zoomed time bases Reporting the Setup Use...

Страница 579: ...Ference commands are not available No measurements are available in this mode ROLL In the ROLL mode data moves continuously across the display from left to right The oscilloscope runs continuously and...

Страница 580: ...enter and is set with the TIMebase REFerence command The maximum position value depends on the time division settings Query Syntax TIMebase POSition The TIMebase POSition query returns the current tim...

Страница 581: ...RANGe The TIMebase RANGe query returns the current full scale range value for the main window Return Format range_value NL range_value time for 10 div in seconds in NR3 format See Also Introduction to...

Страница 582: ...ry Syntax TIMebase REFerence The TIMebase REFerence query returns the current display reference for the main window Return Format reference NL reference LEFT CENT RIGH See Also Introduction to TIMebas...

Страница 583: ...d sets the horizontal scale or units per division for the main window Query Syntax TIMebase SCALe The TIMebase SCALe query returns the current horizontal scale setting in seconds per division for the...

Страница 584: ...value 1 ON 0 OFF The TIMebase VERNier command specifies whether the time base control s vernier fine horizontal adjustment setting is ON 1 or OFF 0 Query Syntax TIMebase VERNier The TIMebase VERNier q...

Страница 585: ...range and the main sweep horizontal position determine the range for this command The value for this command must keep the zoomed view window within the main sweep range Query Syntax TIMebase WINDow P...

Страница 586: ...delayed window The range is 10 times the current zoomed view window seconds per division setting The main sweep range determines the range for this command The maximum value is one half of the TIMeba...

Страница 587: ...conds division The main sweep scale determines the range for this command The maximum value is one half of the TIMebase SCALe value Query Syntax TIMebase WINDow SCALe The TIMebase WINDow SCALe query r...

Страница 588: ...588 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 28 TIMebase Commands...

Страница 589: ...ger SWEep on page 600 can be AUTO or NORMal NORMal mode displays a waveform only if a trigger signal is present and the trigger conditions are met Otherwise the oscilloscope does not trigger and the d...

Страница 590: ...horizontal interval of the waveform and produces triggers based on the TV trigger settings you selected TV triggering requires greater than division of sync amplitude with any analog channel as the tr...

Страница 591: ...ource see page 596 TRIGger LEVel HIGH source see page 596 level 75 x full scale voltage from center screen in NR3 format source CHANnel n n 1 to analog channels in NR1 format TRIGger LEVel LOW level s...

Страница 592: ...ds TRIGger FORCe see page 790 Command Syntax 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...

Страница 593: ...equency reject filter adds a 50 kHz low pass filter in the trigger path to remove high frequency components from the trigger waveform Use this filter to remove high frequency noise such as AM or FM br...

Страница 594: ...le when a waveform crosses the trigger level multiple times during one period of the waveform Without holdoff the oscilloscope could trigger on each of the crossings producing a confusing waveform Wit...

Страница 595: ...Tup The TRIGger LEVel ASETup command automatically sets the trigger levels of all displayed analog channels to their waveforms 50 values If AC coupling is used the trigger levels are set to 0 V When H...

Страница 596: ...nternal triggers source CHANnel n n 1 to analog channels in NR1 format The TRIGger LEVel HIGH command sets the high trigger voltage level voltage for the specified source Query Syntax TRIGger LEVel HI...

Страница 597: ...internal triggers source CHANnel n n 1 to analog channels in NR1 format The TRIGger LEVel LOW command sets the low trigger voltage level voltage for the specified source Query Syntax TRIGger LEVel LO...

Страница 598: ...TRIGger MODE The TRIGger MODE query returns the current trigger mode If the TIMebase MODE is ROLL or XY the query returns NONE Return Format mode NL mode EDGE GLIT PATT TV See Also Introduction to TRI...

Страница 599: ...ise reject filter off and on When the noise reject filter is on the trigger circuitry is less sensitive to noise but may require a greater amplitude waveform to trigger the oscilloscope This command i...

Страница 600: ...resent but the oscilloscope is not triggered the unsynchronized signal is displayed instead of a baseline When NORMal sweep mode is selected and no trigger is present the instrument does not sweep and...

Страница 601: ...R3 format For digital channels MSO models level 8 V source CHANnel n EXTernal for DSO models source CHANnel n DIGital d EXTernal for MSO models n 1 to analog channels in NR1 format d 0 to digital chan...

Страница 602: ...et voltage from the trigger waveform Use AC coupling to get a stable edge trigger when your waveform has a large dc offset LFReject coupling places a 50 KHz high pass filter in the trigger path DC cou...

Страница 603: ...or the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The TRIGger EDGE LEVel command sets the trigger level voltage for the active trigger source Query Syntax...

Страница 604: ...cy noise such as AM or FM broadcast stations from the trigger path The low frequency reject filter adds a 50 kHz high pass filter in series with the trigger waveform to remove any unwanted low frequen...

Страница 605: ...TRIGger TV POLarity to set the polarity in TV trigger mode Query Syntax TRIGger EDGE SLOPe The TRIGger EDGE SLOPe query returns the current trigger slope Return Format slope NL slope NEG POS EITH ALT...

Страница 606: ...ignal WGEN triggers at the 50 level of the rising edge of the waveform generator output signal This option is not available when the DC or NOISe waveforms are selected Query Syntax TRIGger EDGE SOURce...

Страница 607: ...in NR3 format suffix s ms us ns ps TRIGger GLITch LEVel level source see page 611 TRIGger GLITch LEVel see page 611 For internal triggers level 75 x full scale voltage from center screen in NR3 forma...

Страница 608: ...e 614 less_than_time 15 ns to 10 seconds in NR3 format greater_than_time 10 ns to 9 99 seconds in NR3 format suffix s ms us ns ps TRIGger GLITch SOURc e source see page 615 TRIGger GLITch SOURc e see...

Страница 609: ...ITch GREaterthan command sets the minimum pulse width duration for the selected TRIGger GLITch SOURce Query Syntax TRIGger GLITch GREaterthan The TRIGger GLITch GREaterthan query returns the minimum p...

Страница 610: ...er GLITch LESSthan command sets the maximum pulse width duration for the selected TRIGger GLITch SOURce Query Syntax TRIGger GLITch LESSthan The TRIGger GLITch LESSthan query returns the pulse width d...

Страница 611: ...source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The TRIGger GLITch LEVel command sets t...

Страница 612: ...ty POSitive NEGative The TRIGger GLITch POLarity command sets the polarity for the glitch pulse width trigger Query Syntax TRIGger GLITch POLarity The TRIGger GLITch POLarity query returns the glitch...

Страница 613: ...ation of the glitch pulse width trigger The oscilloscope can trigger on a pulse width that is greater than a time value less than a time value or within a range of time values Query Syntax TRIGger GLI...

Страница 614: ...ANGe command sets the pulse width duration for the selected TRIGger GLITch SOURce You can enter the parameters in any order the smaller value becomes the greater_than_time and the larger value becomes...

Страница 615: ...e command selects the channel that produces the pulse width trigger Query Syntax TRIGger GLITch SOURce The TRIGger GLITch SOURce query returns the current pulse width source If all channels are off th...

Страница 616: ...ring nn n where n 0 1 X R F when base ASCii string 0xnn n where n 0 9 A F X when base HEX edge_source CHANnel n NONE for DSO models edge_source CHANnel n DIGital d NONE for MSO models n 1 to analog ch...

Страница 617: ...s on the TRIGger PATTern FORMat command setting When the format is ASCii the string looks just like the string you see on the oscilloscope s front panel made up of 0 1 X don t care R rising edge and F...

Страница 618: ...uery returns the pattern string edge source and edge Return Format string edge_source edge NL See Also Introduction to TRIGger Commands on page 589 TRIGger PATTern FORMat on page 619 TRIGger PATTern Q...

Страница 619: ...The TRIGger PATTern FORMat command sets the entry and query number base used by the TRIGger PATTern command The default base is ASCii Query Syntax TRIGger PATTern FORMat The TRIGger PATTern FORMat qu...

Страница 620: ...alifier ENTered The TRIGger PATTern QUALifier command qualifies when the trigger occurs In the InfiniiVision 2000 X Series oscilloscopes the trigger always occurs when the pattern is entered Query Syn...

Страница 621: ...ger in NR1 format TRIGger TV MODE tv mode see page 623 TRIGger TV MODE see page 623 tv mode FIEld1 FIEld2 AFIelds ALINes LFIeld1 LFIeld2 LALTernate TRIGger TV POLarity polarity see page 624 TRIGger TV...

Страница 622: ...shown in the following table Query Syntax 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 S...

Страница 623: ...gger mode and field Old forms for mode are accepted Query Syntax TRIGger TV MODE The TRIGger TV MODE query returns the TV trigger mode Return Format value NL value FIE1 FIE2 AFI ALIN LFI1 LFI2 LALT Se...

Страница 624: ...rity polarity polarity POSitive NEGative The TRIGger TV POLarity command sets the polarity for the TV trigger Query Syntax TRIGger TV POLarity The TRIGger TV POLarity query returns the TV trigger pola...

Страница 625: ...nalog channels in NR1 format The TRIGger TV SOURce command selects the channel used to produce the trigger Query Syntax TRIGger TV SOURce The TRIGger TV SOURce query returns the current TV trigger sou...

Страница 626: ...790 Command Syntax TRIGger TV STANdard standard standard NTSC PALM PAL SECam The TRIGger TV STANdard command selects the video standard NTSC PAL PAL M SECAM Query Syntax TRIGger TV STANdard The TRIGg...

Страница 627: ...DATA see page 637 binary block length bytes binary data For example to transmit 1000 bytes of data the syntax would be 800001000 1000 bytes of data NL 8 is the number of digits that follow 00001000 i...

Страница 628: ...ion type count Average count or 1 if PEAK detect type or NORMal an integer in NR1 format n a WAVeform SEGMented C OUNt see page 647 count an integer from 2 to 1000 in NR1 format with Option SGM n a WA...

Страница 629: ...and the type of acquired data 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 WAV...

Страница 630: ...number of points acquired may be queried using ACQuire POINts see page 188 Helpful Hints The number of points transferred to the computer is controlled using the WAVeform POINts command see page 640...

Страница 631: ...ucket n 1 where n is the number returned by the WAVeform POINts query see page 640 The first value corresponds to a point at the left side of the screen and the last value corresponds to one point awa...

Страница 632: ...point sent with WAVeform XORigin 16 ns WAVeform XREFerence 0 and WAVeform XINCrement 2 ns can be calculated using the following formula time data point number xreference xincrement xorigin This would...

Страница 633: ...uery see page 640 If the data intrinsically has less than 16 bits of resolution the data is left shifted to provide 16 bits of resolution and the least significant bits are set to 0 Currently the grea...

Страница 634: ...WORD see page 639 is WORD every other data byte will be 0 The setting of WAVeform BYTeorder see page 635 controls which byte is 0 If a digital channel is not displayed its bit value in the pod data by...

Страница 635: ...t LSBFirst sets the least significant byte to be transmitted first This command affects the transmitting sequence only when WAVeform FORMat WORD is selected The default setting is MSBFirst Query Synta...

Страница 636: ...ount used to acquire the current waveform This may differ from current values if the unit has been stopped and its configuration modified For all acquisition types except average this value is 1 Retur...

Страница 637: ...d is intended for ASCII transfers Use telnet port 5025 instead 0x01 or 0x0001 Clipped low These are locations where the waveform is clipped at the bottom of the oscilloscope display 0xFF or 0xFFFF Cli...

Страница 638: ...Value As Long varQueryResult myScope ReadIEEEBlock BinaryType_UI1 Unsigned integer bytes For lngI 0 To UBound varQueryResult _ Step UBound varQueryResult 20 20 points If intBytesPerData 2 Then lngData...

Страница 639: ...e WAVeform BYTeorder command can be used to specify whether the upper or lower byte is transmitted first The default no command sent is that the upper byte transmitted first BYTE formatted data is tra...

Страница 640: ...NORMal waveform points mode See the WAVeform POINts MODE command see page 642 for more information Only data visible on the display will be returned When the WAVeform SOURce is the serial decode bus...

Страница 641: ...form VIEW on page 656 WAVeform PREamble on page 644 WAVeform POINts MODE on page 642 Example Code WAVE_POINTS Specifies the number of points to be transferred using the WAVEFORM DATA query myScope Wri...

Страница 642: ...ord is used Under some conditions such as when the oscilloscope is running this data record is unavailable If the points_mode is MAXimum whichever record contains the maximum amount of points is used...

Страница 643: ...affect what data is transferred See the discussion above Return Format points_mode NL points_mode NORMal MAXimum RAW See Also Introduction to WAVeform Commands on page 629 WAVeform DATA on page 637 A...

Страница 644: ...int NR3 xreference 32 bit NR1 yincrement 32 bit floating point NR3 yorigin 32 bit floating point NR3 yreference 32 bit NR1 format 0 for BYTE format 1 for WORD format 4 for ASCii format an integer in N...

Страница 645: ...UNT int32 1 and is always 1 XINCREMENT float64 time difference between data points XORIGIN float64 always the first data point in memory XREFERENCE int32 specifies the data point associated with x ori...

Страница 646: ...2000 X Series Oscilloscopes Programmer s Guide 30 WAVeform Commands sngYIncrement Preamble 7 sngYOrigin Preamble 8 lngYReference Preamble 9 See complete example programs at Chapter 38 Programming Exam...

Страница 647: ...s complete The segmented memory acquisition mode is enabled with the ACQuire MODE command The number of segments to acquire is set using the ACQuire SEGMented COUNt command and data is acquired using...

Страница 648: ...G query returns the time tag of the currently selected segmented memory index The index is selected using the ACQuire SEGMented INDex command Return Format time_tag in NR3 format See Also ACQuire SEGM...

Страница 649: ...d bus decode information With MSO oscilloscope models you can choose a POD or BUS as the waveform source There are some differences between POD and BUS when formatting and getting data from the oscill...

Страница 650: ...URCE Selects the channel to be used as the source for the waveform commands myScope WriteString WAVEFORM SOURCE CHAN1 WAVE_POINTS Specifies the number of points to be transferred using the WAVEFORM DA...

Страница 651: ...Reference 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 lngPo...

Страница 652: ...may be stripped off of the header and the remaining numbers are the size in bytes of the waveform data block The size can vary depending on the number of points acquired for the waveform You can then...

Страница 653: ...ets you get TX data TX is an alias for SUB1 The default SUB0 specifies RX data RX is an alias for SUB0 When using SPI serial decode this option lets you get MISO data MISO is an alias for SUB1 The def...

Страница 654: ...ion mode associated with the currently selected waveform The acquisition mode is set by the ACQuire TYPE command Return Format mode NL mode NORM PEAK AVER HRES See Also Introduction to WAVeform Comman...

Страница 655: ...sent as unsigned or signed integers This command can be used to match the instrument s internal data type to the data type used by the programming language This command has no effect if the data form...

Страница 656: ...EW command sets the view setting associated with the currently selected waveform Currently the only legal value for the view setting is MAIN Query Syntax WAVeform VIEW The WAVeform VIEW query returns...

Страница 657: ...rement query returns the x increment value for the currently specified source This value is the time difference between consecutive data points in seconds Return Format value NL value x increment in t...

Страница 658: ...urce XORigin is the X axis value of the data point specified by the WAVeform XREFerence value In this product that is always the X axis value of the first data point XREFerence 0 Return Format value N...

Страница 659: ...urrently specified source This value specifies the index of the data point associated with the x origin data value In this product the x reference point is the first point displayed and XREFerence is...

Страница 660: ...crement value in volts for the currently specified source This value is the voltage difference between consecutive data values The y increment for digital waveforms is always 1 Return Format value NL...

Страница 661: ...ecified source This value is the Y axis value of the data value specified by the WAVeform YREFerence value For this product this is the Y axis value of the center of the screen Return Format value NL...

Страница 662: ...pecified source This value specifies the data point value where the y origin occurs In this product this is the data point value of the center of the screen It is undefined if the format is ASCii Retu...

Страница 663: ...th in seconds in NR3 format WGEN FUNCtion RAMP S YMMetry percent see page 670 WGEN FUNCtion RAMP S YMMetry see page 670 percent symmetry percentage from 0 to 100 in NR1 format WGEN FUNCtion SQUare DCY...

Страница 664: ...MODulation NOIS e percent see page 680 WGEN MODulation NOIS e see page 680 percent 0 to 100 WGEN MODulation STAT e 0 OFF 1 ON see page 681 WGEN MODulation STAT e see page 681 0 1 WGEN MODulation TYPE...

Страница 665: ...t 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 LOA...

Страница 666: ...e and DC the WGEN FREQuency command specifies the frequency of the waveform You can also specify the frequency indirectly using the WGEN PERiod command Query Syntax WGEN FREQuency The WGEN FREQuency q...

Страница 667: ...ands to set the square wave signal parameters WGEN FREQuency on page 666 WGEN PERiod on page 686 WGEN VOLTage on page 688 WGEN VOLTage OFFSet on page 691 WGEN VOLTage HIGH on page 689 WGEN VOLTage LOW...

Страница 668: ...e commands to set the pulse signal parameters WGEN FREQuency on page 666 WGEN PERiod on page 686 WGEN VOLTage on page 688 WGEN VOLTage OFFSet on page 691 WGEN VOLTage HIGH on page 689 WGEN VOLTage LOW...

Страница 669: ...t For Pulse waveforms the WGEN FUNCtion PULSe WIDTh command specifies the width of the pulse The pulse width can be adjusted from 20 ns to the period minus 20 ns Query Syntax WGEN FUNCtion PULSe WIDTh...

Страница 670: ...waveforms the WGEN FUNCtion RAMP SYMMetry command specifies the symmetry of the waveform Symmetry represents the amount of time per cycle that the ramp waveform is rising Query Syntax WGEN FUNCtion RA...

Страница 671: ...are waveforms the WGEN FUNCtion SQUare DCYCle command specifies the square wave duty cycle Duty cycle is the percentage of the period that the waveform is high Query Syntax WGEN FUNCtion SQUare DCYCle...

Страница 672: ...m 10 to 90 90 10 80 of the original amplitude as the modulating signal goes from its minimum to maximum amplitude Query Syntax WGEN MODulation AM DEPTh The WGEN MODulation AM DEPTh query returns the A...

Страница 673: ...lation AM FREQuency The WGEN MODulation AM FREQuency query returns the frequency of the modulating signal Return Format frequency NL frequency modulating waveform frequency in Hz in NR3 format See Als...

Страница 674: ...quency deviation cannot be greater than the original carrier signal frequency Also the sum of the original carrier signal frequency and the frequency deviation must be less than or equal to the maximu...

Страница 675: ...lation FM FREQuency The WGEN MODulation FM FREQuency query returns the frequency of the modulating signal Return Format frequency NL frequency modulating waveform frequency in Hz in NR3 format See Als...

Страница 676: ...nd this hop frequency Query Syntax WGEN MODulation FSKey FREQuency The WGEN MODulation FSKey FREQuency query returns the hop frequency setting Return Format frequency NL frequency hop frequency in Hz...

Страница 677: ...e modulating signal Query Syntax WGEN MODulation FSKey RATE The WGEN MODulation FSKey RATE query returns the FSK rate setting Return Format rate NL rate FSK modulation rate in Hz in NR3 format See Als...

Страница 678: ...try command This command applies to AM and FM modulation The FSK modulation signal is a square wave shape Query Syntax WGEN MODulation FUNCtion The WGEN MODulation FUNCtion query returns the specified...

Страница 679: ...ified with the WGEN MODulation FUNCtion command Query Syntax WGEN MODulation FUNCtion RAMP SYMMetry The WGEN MODulation FUNCtion RAMP SYMMetry query returns ramp symmetry percentage setting Return For...

Страница 680: ...ed to the regular amplitude limit for example 5 Vpp in 1 MOhm so the range for percent varies according to current amplitude Note that adding noise affects edge triggering on the waveform generator so...

Страница 681: ...nd noise Query Syntax WGEN MODulation STATe The WGEN MODulation STATe query returns whether the modulated waveform generator output is enabled of disabled Return Format setting NL setting 0 1 See Also...

Страница 682: ...modulating signal frequency Use the WGEN MODulation FM DEViation command to specify the frequency deviation from the original carrier signal frequency FSK frequency shift keying modulation the output...

Страница 683: ...Commands 31 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 683 WGEN MODulation FUNCtion on page 678 WGEN MODulation FUNCtion RAMP SYMMetry on page 679 WGEN MODulation STATe on pa...

Страница 684: ...GEN OUTPut on_off on_off 1 ON 0 OFF The WGEN OUTPut command specifies whether the waveform generator signal output is ON 1 or OFF 0 Query Syntax WGEN OUTPut The WGEN OUTPut query returns the current s...

Страница 685: ...BNC is fixed at 50 ohms However the output load selection lets the waveform generator display the correct amplitude and offset levels for the expected output load If the actual load impedance is diffe...

Страница 686: ...oise and DC the WGEN PERiod command specifies the period of the waveform You can also specify the period indirectly using the WGEN FREQuency command Query Syntax WGEN PERiod The WGEN PERiod query retu...

Страница 687: ...r s Guide 687 WGEN RST see page 790 Command Syntax 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 W...

Страница 688: ...also specify the amplitude and offset indirectly using the WGEN VOLTage HIGH and WGEN VOLTage LOW commands For example an amplitude of 5 V and an offset of 1 V is the same as a high level voltage of 4...

Страница 689: ...pecify the high level and low level voltages indirectly using the WGEN VOLTage and WGEN VOLTage OFFSet commands For example a high level voltage of 4 V and a low level voltage of 1 V is the same as an...

Страница 690: ...pecify the high level and low level voltages indirectly using the WGEN VOLTage and WGEN VOLTage OFFSet commands For example a high level voltage of 4 V and a low level voltage of 1 V is the same as an...

Страница 691: ...y the amplitude and offset indirectly using the WGEN VOLTage HIGH and WGEN VOLTage LOW commands For example an amplitude of 5 V and an offset of 1 V is the same as a high level voltage of 4 V and a lo...

Страница 692: ...692 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 31 WGEN Commands...

Страница 693: ...ry r LABel see page 697 r 1 2 in NR1 format string any series of 10 or less ASCII characters enclosed in quotation marks WMEMory r SAVE source see page 698 n a r 1 2 in NR1 format source CHANnel n FUN...

Страница 694: ...YRANge see page 701 r 1 2 in NR1 format range vertical full scale range value in NR3 format suffix V mV WMEMory r YSCale scale suffix see page 702 WMEMory r YSCale see page 702 r 1 2 in NR1 format sca...

Страница 695: ...Guide 695 WMEMory r CLEar see page 790 Command Syntax WMEMory r CLEar r 1 2 in NR1 format The WMEMory r CLEar command clears the specified reference waveform location See Also Chapter 32 WMEMory r Co...

Страница 696: ...There are two reference waveform locations but only one reference waveform can be displayed at a time That means if WMEMory1 DISPlay is ON sending the WMEMory2 DISPlay ON command will automatically s...

Страница 697: ...e to the label list in non volatile memory replacing the oldest label in the list Query Syntax WMEMory r LABel The WMEMory r LABel query returns the label associated with a particular reference wavefo...

Страница 698: ...R1 format source CHANnel n FUNCtion MATH n 1 to analog channels in NR1 format The WMEMory r SAVE command copies the analog channel or math function waveform to the specified reference waveform locatio...

Страница 699: ...SKEW command sets the skew factor for the specified reference waveform Query Syntax WMEMory r SKEW The WMEMory r SKEW query returns the current skew setting for the selected reference waveform Return...

Страница 700: ...e set by the WMEMory r YRANge or WMEMory r YSCale commands If you set the offset to a value outside of the legal range the offset value is automatically set to the nearest legal value Legal values are...

Страница 701: ...l values for the range are copied from the original source waveform that is the analog channel or math function waveform that was originally saved as a reference waveform Query Syntax WMEMory r YRANge...

Страница 702: ...form Legal values for the scale are copied from the original source waveform that is the analog channel or math function waveform that was originally saved as a reference waveform Query Syntax WMEMory...

Страница 703: ...221 ANALog n INVert CHANnel n INVert see page 224 ANALog n LABel CHANnel n LABel see page 225 ANALog n OFFSet CHANnel n OFFSet see page 226 ANALog n PROBe CHANnel n PROBe see page 227 ANALog n PMODe...

Страница 704: ...719 FUNCtion DISPlay see page 280 HARDcopy DESTination see page 720 HARDcopy FILename see page 721 HARDcopy FILename see page 721 RECall FILename see page 419 SAVE FILename see page 419 HARDcopy GRAY...

Страница 705: ...EASure VSTOp see page 736 MARKer Y2Position see page 328 MTESt AMASk SAVE STORe see page 737 SAVE MASK STARt see page 435 MTESt AVERage see page 738 ACQuire TYPE AVERage see page 195 MTESt AVERage COU...

Страница 706: ...ndow TRIGger THReshold see page 749 POD n THReshold see page 414 or DIGital d THReshold see page 249 TRIGger TV TVMode see page 750 TRIGger TV MODE see page 623 Obsolete Command Current Command Equiva...

Страница 707: ...FUNCtion PEAKs none HARDcopy ADDRess none Only parallel printer port is supported GPIB printing not supported MASK none All commands discontinued feature not available SYSTem KEY none TEST ALL TST Se...

Страница 708: ...mat edges levels NL edges presence of edges 32 bit integer in NR1 format levels logical highs or lows 32 bit integer in NR1 format A bit equal to one indicates that edges have been detected at the spe...

Страница 709: ...Nnel LABel command sets the source text to the string that follows Setting a channel will also result in the name being added to the label list Query Syntax CHANnel LABel The CHANnel LABel query retur...

Страница 710: ...either set to a predefined value or to a user defined value For the predefined value the voltage parameter is ignored Query Syntax CHANnel THReshold channel group The CHANnel THReshold query returns...

Страница 711: ...s analog probe skew control to remove cable delay errors between channel 1 and channel 2 Query Syntax CHANnel2 SKEW The CHANnel2 SKEW query returns the current probe skew setting for the selected cha...

Страница 712: ...lects the input impedance setting for the specified channel The legal values for this command are ONEMeg 1 M and FIFTy 50 Query Syntax CHANnel n INPut The CHANnel n INPut query returns the current inp...

Страница 713: ...robe with sense is connected to the specified channel auto sensing is enabled otherwise the mode is manual If the PMODe sent matches the oscilloscope s setting the command will be accepted Otherwise a...

Страница 714: ...ed on the oscilloscope displays lines connecting sampled data points When vectors are turned off only the sampled data is displayed Query Syntax DISPlay CONNect The DISPlay CONNect query returns the c...

Страница 715: ...string See Also DIGital d POSition on page 247 Example Code DISP_ORDER Set the order the channels are displayed on the analyzer You can enter between 1 and 32 channels at one time If you leave out ch...

Страница 716: ...uide 33 Obsolete and Discontinued Commands ERASe see page 790 Command Syntax ERASe The ERASe command erases the screen NOTE The ERASe command is an obsolete command provided for compatibility to previ...

Страница 717: ...connected to the specified channel auto sensing is enabled otherwise the mode is manual If the pmode sent matches the oscilloscope s setting the command will be accepted Otherwise a setting conflict...

Страница 718: ...FUNCtion SOURce command selects the source for function operations Choose CHANnel n or ADD SUBT or MULT to specify the desired source for FFT operations specified by the FUNCtion OPERation command Que...

Страница 719: ...or off When ON is selected the function performs as specified using the other FUNCtion commands When OFF is selected function is neither calculated nor displayed Query Syntax FUNCtion VIEW The FUNCtio...

Страница 720: ...y DESTination command sets the hardcopy destination Query Syntax HARDcopy DESTination The HARDcopy DESTination query returns the selected hardcopy destination Return Format destination NL destination...

Страница 721: ...e for those print formats whose output is a file Query Syntax HARDcopy FILename The HARDcopy FILename query returns the current hardcopy output filename Return Format string NL string quoted ASCII str...

Страница 722: ...RDcopy 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...

Страница 723: ...s whether the graticule colors are inverted or not Query Syntax HARDcopy IGColors The HARDcopy IGColors query returns a flag indicating whether graticule colors are inverted or not Return Format value...

Страница 724: ...rdcopy printer driver used for the selected printer If the correct driver for the selected printer can be identified it will be selected and cannot be changed Query Syntax HARDcopy PDRiver The HARDcop...

Страница 725: ...hen the thresholds are PERCent as defined by the MEASure DEFine THResholds command Query Syntax MEASure LOWer The MEASure LOWer query returns the current lower threshold level Return Format voltage NL...

Страница 726: ...EASure SCRatch see page 790 Command Syntax MEASure SCRatch The MEASure SCRatch command clears all selected measurements and markers from the screen NOTE The MEASure SCRatch command is obsolete and is...

Страница 727: ...ELta query is received by the oscilloscope The delta time value that is output is the current value This is the same value as the front panel cursors delta X value Return Format value NL value time di...

Страница 728: ...ted when making time measurements Return Format T1090 T2080 VOLTage NL T1090 uses the 10 and 90 levels of the selected waveform T2080 uses the 20 and 80 levels of the selected waveform VOLTage uses th...

Страница 729: ...time at the start marker in NR3 format See Also Introduction to MARKer Commands on page 318 Introduction to MEASure Commands on page 340 MARKer X1Position on page 320 MARKer X2Position on page 322 MA...

Страница 730: ...me at the stop marker in NR3 format See Also Introduction to MARKer Commands on page 318 Introduction to MEASure Commands on page 340 MARKer X1Position on page 320 MARKer X2Position on page 322 MARKer...

Страница 731: ...onse to the query The specified voltage can be negative or positive To specify a negative voltage use a minus sign The sign of the slope selects a rising or falling edge If no sign is specified for th...

Страница 732: ...732 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 33 Obsolete and Discontinued Commands value time in seconds of the specified voltage crossing in NR3 format...

Страница 733: ...age when the thresholds are PERCent as defined by the MEASure DEFine THResholds command Query Syntax MEASure UPPer The MEASure UPPer query returns the current upper threshold level Return Format value...

Страница 734: ...t is returned is the current value This is the same value as the front panel cursors delta Y value VDELta value at marker 2 value at marker 1 Return Format value NL value delta V value in NR1 format S...

Страница 735: ...e at voltage marker 1 in NR3 format See Also Introduction to MARKer Commands on page 318 Introduction to MEASure Commands on page 340 MARKer Y1Position on page 327 MARKer Y2Position on page 328 MARKer...

Страница 736: ...the Y2 cursor in NR3 format See Also Introduction to MARKer Commands on page 318 Introduction to MEASure Commands on page 340 MARKer Y1Position on page 327 MARKer Y2Position on page 328 MARKer YDELta...

Страница 737: ...s not been generated an error occurs The filename parameter is an MS DOS compatible name of the file a maximum of 254 characters long including the path name if used The filename assumes the present w...

Страница 738: ...ucket and averages them When OFF averaging is disabled To set the number of averages use the MTESt AVERage COUNt command described next Query Syntax MTESt AVERage The MTESt AVERage query returns the c...

Страница 739: ...ommand specifies the number of data values to be averaged for each time bucket before the acquisition is considered complete for that time bucket Query Syntax MTESt AVERage COUNt The MTESt AVERage COU...

Страница 740: ...e specified mask file The filename parameter is an MS DOS compatible name of the file a maximum of 254 characters long including the path name if used See Also Introduction to MTESt Commands on page 3...

Страница 741: ...ds parameter is a real number from 1 to 86400 seconds WAVeforms sets the maximum number of waveforms that are required before the mask test terminates The wfm_count parameter indicates the number of w...

Страница 742: ...s run and a mask violation is detected the mask test is stopped and the acquisition system is stopped Query Syntax MTESt RUMode SOFailure The MTESt RUMode SOFailure query returns the current state of...

Страница 743: ...nd Syntax MTESt STARt STOP The MTESt STARt STOP command starts or stops the acquisition system See Also Introduction to MTESt Commands on page 379 NOTE The MTESt STARt and MTESt STOP commands are obso...

Страница 744: ...er SOURce command sets the channel to use as the trigger Query Syntax MTESt TRIGger SOURce The MTESt TRIGger SOURce query returns the currently selected trigger source Return Format source CHAN n n 1...

Страница 745: ...page 258 instead Print Option PRINt command PRINt query Query Default COLor Sets palette COLor GRAYscale Sets palette GRAYscale palette COLor PRINter0 1 Causes the USB printer 0 1 to be selected as de...

Страница 746: ...continued Commands See Also Introduction to Root Commands on page 150 Introduction to HARDcopy Commands on page 296 HARDcopy FACTors on page 299 HARDcopy GRAYscale on page 722 DISPlay DATA on page 258...

Страница 747: ...d image area When saving images this query returns SCR screen When saving setups or waveform data this query returns GRAT graticule even though graticule images are not saved Return Format area NL are...

Страница 748: ...nce point is set with the TIMebase REFerence command see page 582 Query Syntax TIMebase DELay The TIMebase DELay query returns the current delay value Return Format delay_value NL delay_value time fro...

Страница 749: ...value or to a user defined value For the predefined value the voltage parameter is not required Query Syntax TRIGger THReshold channel group The TRIGger THReshold query returns the voltage and thresh...

Страница 750: ...rnate parameter is not available when TRIGger TV STANdard is GENeric see page 626 Old forms for mode are accepted Query Syntax TRIGger TV TVMode The TRIGger TV TVMode query returns the TV trigger mode...

Страница 751: ...s Guide 34 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 faile...

Страница 752: ...ll memory lost 313 Calibration memory lost 311 Memory error 310 System error 300 Device specific error 278 Macro header not found 277 Macro redefinition not allowed 276 Macro recursion error 273 Illeg...

Страница 753: ...ia 251 Missing mass storage 250 Mass storage error 241 Hardware missing This message can occur when a feature is unavailable or unlicensed For example some serial bus decode commands are only availabl...

Страница 754: ...221 Settings conflict 220 Parameter error 200 Execution error 183 Invalid inside macro definition 181 Invalid outside macro definition 178 Expression data not allowed 171 Invalid expression 170 Expres...

Страница 755: ...error 148 Character data not allowed 138 Suffix not allowed 134 Suffix too long 131 Invalid suffix 128 Numeric data not allowed 124 Too many digits 123 Exponent too large 121 Invalid character in numb...

Страница 756: ...rror Messages 109 Missing parameter 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 O...

Страница 757: ...rint Initialization Failed 107 Invalid Trace File 108 Compression Error 109 No Data For Operation A remote operation wants some information but there is no information available For example you may re...

Страница 758: ...758 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 34 Error Messages...

Страница 759: ...ent Register MTERegister EVENt 776 Clearing Registers and Queues 777 Status Reporting Decision Chart 778 IEEE 488 2 defines data structures commands and common bit definitions for status reporting for...

Страница 760: ...gisters the summary bit is set if any enabled bit in the event register is set The events are enabled with the corresponding event enable register Events captured by an event register remain set until...

Страница 761: ...ter 1 0 2 3 4 5 6 7 9 8 10 11 12 13 14 15 MTERegister EVENt Mask Test Event Event Register RP SOHWH Fail MTE To bits in Operation Status Condition Register OVLR Auto Mask Started Wait Trig Run Arm Reg...

Страница 762: ...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 To generate a service request SR...

Страница 763: ...bit and clears the bit which clears the SRQ interrupt The STB command reads bit 6 as the Master Summary Status MSS and does not clear the bit or have any affect on the SRQ interrupt The value returne...

Страница 764: ...cleared when the Status Byte Register is read by the serial poll command Example The following example uses the resource session object s ReadSTB method to read the contents of the oscilloscope s Stat...

Страница 765: ...gister using the SRE command and the bits that are set are read with the SRE query Example The following example sets bit 4 MAV and bit 5 ESB in the Service Request Enable Register myScope WriteString...

Страница 766: ...igger event occurs The TER event register stays set until it is cleared by reading the register or using the CLS command If your application needs to detect multiple triggers the TER event register mu...

Страница 767: ...rated by certain instrument commands and queries The output queue generates the Message Available summary bit when the output queue contains one or more bytes This summary bit sets the MAV bit bit 4 i...

Страница 768: ...essage Queue The message queue contains the text of the last message written to the advisory line on the screen of the oscilloscope The length of the oscilloscope s message queue is 1 Note that messag...

Страница 769: ...bled in the Standard Event Status Enable Register the bits set in this register generate a summary bit to set bit 5 ESB in the Status Byte Register You can read the contents of the Standard Event Stat...

Страница 770: ...e 0x3C Therefore you can enable any of these bits to generate the summary bit by sending myScope WriteString ESE CStr CInt H3C Whenever an error occurs it sets one of these bits in the Standard Event...

Страница 771: ...is discarded The length of the oscilloscope s error queue is 30 29 positions for the error messages and 1 position for the Queue overflow message The error queue is read with the SYSTem ERRor query E...

Страница 772: ...us 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 Name Location Description RUN bit...

Страница 773: ...these bits The OPERegister CONDition query returns the value of the Operation Status Condition Register Name Location Description RUN bit bit 3 Is set whenever the instrument is not stopped WAIT TRIG...

Страница 774: ...n the instrument becomes armed The ARM event register stays set until it is cleared by reading the register with the AER query or using the CLS command If your application needs to detect multiple tri...

Страница 775: ...ter hosts these bits Name Location Description Channel 1 Fault bit 6 Fault has occurred on Channel 1 input Channel 2 Fault bit 7 Fault has occurred on Channel 2 input Channel 3 Fault bit 8 Fault has o...

Страница 776: ...gister register hosts these bits The MTERegister EVENt query returns the value of and clears the Mask Test Event Event Register Name Location Description Complete bit 0 Is set when the mask test is co...

Страница 777: ...es Oscilloscopes Programmer s Guide 777 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 progra...

Страница 778: ...6WDWXV WH 5HJLVWHU DQG VHQG DQ 654 WR WKH FRPSXWHU I HYHQWV DUH PRQLWRUHG E WKH 6WDQGDUG YHQW 6WDWXV 5HJLVWHU DOVR HQDEOH 6 ZLWK WKH 65 FRPPDQG FWLYDWH WKH LQVWUXPHQW IXQFWLRQ WKDW RX ZDQW WR PRQLWRU...

Страница 779: ...ith programming commands it is often necessary to know when the oscilloscope has finished the previous operation and is ready for the next command The most common example is when an acquisition is sta...

Страница 780: ...eve Results Once the acquisition is complete it is safe to retrieve measurements and statistics NOTE It is not necessary to use OPC hard coded waits or status checking when setting up the oscilloscope...

Страница 781: ...Main On Error GoTo VisaComError Create the VISA COM I O resource Set myMgr New VisaComLib ResourceManager Set myScope New VisaComLib FormattedIO488 Set myScope IO myMgr Open TCPIP0 130 29 69 12 inst0...

Страница 782: ...Lib ResourceManager Set myScope New VisaComLib FormattedIO488 Set myScope IO myMgr Open TCPIP0 130 29 69 12 inst0 INSTR myScope IO Clear Clear the interface Set up Set up the trigger and horizontal sc...

Страница 783: ...100 Small wait to prevent excessive queries lngElapsed lngElapsed 100 End If Loop Get results If lngElapsed lngTimeout Then myScope WriteString MEASure RISetime myScope WriteString MEASure RISetime va...

Страница 784: ...VisaComLib ResourceManager Public myScope As VisaComLib FormattedIO488 Public varQueryResult As Variant Public strQueryResult As String Private Declare Sub Sleep Lib kernel32 ByVal dwMilliseconds As L...

Страница 785: ...cs to wait for single shot Dim lngElapsed As Long lngTimeout 10000 10 seconds lngElapsed 0 Do While lngElapsed lngTimeout myScope WriteString OPERegister CONDition varQueryResult myScope ReadNumber Ma...

Страница 786: ...s Variant Public strQueryResult As String Private Declare Sub Sleep Lib kernel32 ByVal dwMilliseconds As Long Sub Main On Error GoTo VisaComError Create the VISA COM I O resource Set myMgr New VisaCom...

Страница 787: ...er STB from Standard Event Status register ESR is set STB can be read during DIGitize without generating a timeout Do Sleep 4000 Poll more often than the timeout setting varQueryResult myScope IO Read...

Страница 788: ...788 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 36 Synchronizing Acquisitions...

Страница 789: ...iiVision 2000 X Series Oscilloscopes Programmer s Guide 37 More About Oscilloscope Commands Command Classifications 790 Valid Command Query Strings 791 Query Return Values 797 All Oscilloscope Command...

Страница 790: ...ethods are employed Non Core Commands Non core commands are commands that provide specific features but are not universal across all Agilent InfiniiVision oscilloscope models Non core commands may be...

Страница 791: ...y time a parameter is not meant to be expressed as a string is when the instruction s syntax definition specifies block data such as learn string There are only a few instructions that use block data...

Страница 792: ...s the values they accept Program Data Syntax Rules on page 794 describes all of the general rules about acceptable values When there is more than one data parameter they are separated by commas Spaces...

Страница 793: ...ey must be preceded by a colon When program data must be included with the simple command header for example DIGitize CHANnel1 white space is added to separate the data from the header The syntax is p...

Страница 794: ...DE command can be set to normal zoomed delayed XY or ROLL The character program data in this case may be MAIN WINDow XY or ROLL The command TIMebase MODE WINDow sets the time base mode to zoomed The a...

Страница 795: ...header would be TIMebase RANGe This is referred to as a compound header A compound header is a header made of two or more mnemonics separated by colons The mnemonic created contains no spaces The fol...

Страница 796: ...m mnemonic data program mnemonic data terminator For example myScope WriteString TIMebase REFerence CENTer DISPlay VECTors ON Multiple commands may be any combination of compound and simple commands N...

Страница 797: ...s to the designated listener typically a controller For example the query TIMebase RANGe places the current time base setting in the output queue When using the Agilent VISA COM library in Visual Basi...

Страница 798: ...l IEEE 488 2 makes the distinction between sequential and overlapped commands Sequential commands finish their task before the execution of the next command starts Overlapped commands run concurrently...

Страница 799: ...lloscopes Programmer s Guide 38 Programming Examples VISA COM Examples 800 VISA Examples 833 SICL Examples 880 SCPI NET Examples 900 Example programs are ASCII text files that can be cut from the help...

Страница 800: ...ilent VISA COM library a Choose Tools References from the main menu b In the References dialog check the VISA COM 3 0 Type Library c Click OK 4 Choose Insert Module 5 Cut and paste the code that follo...

Страница 801: ...out Initialize start from a known state Initialize Capture data Capture Analyze the captured waveform Analyze Exit Sub VisaComError MsgBox VISA COM Error vbCrLf Err Description End End Sub Initialize...

Страница 802: ...String TRIGger EDGE SLOPe Save oscilloscope configuration varQueryResult DoQueryIEEEBlock_UI1 SYSTem SETup Output setup string to a file Dim strPath As String strPath c scope config setup dat Dim hFil...

Страница 803: ...command DoCommandIEEEBlock SYSTem SETup varSetupString Debug Print Setup bytes restored CStr LenB varSetupString Capture an acquisition using DIGitize DoCommand DIGitize CHANnel1 Exit Sub VisaComErro...

Страница 804: ...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 Debug Print Waveform...

Страница 805: ...isition 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 En...

Страница 806: ...ge value Print hFile _ FormatNumber dblXOrigin lngI dblXIncrement 9 _ _ FormatNumber lngDataValue lngYReference _ sngYIncrement sngYOrigin Next lngI Close output file Close hFile Close file MsgBox Wav...

Страница 807: ...yScope WriteString query DoQueryString myScope ReadString CheckInstrumentErrors Exit Function VisaComError MsgBox VISA COM Error vbCrLf CStr Err Number _ Err Source _ Err Description vbExclamation VIS...

Страница 808: ...naryType_UI1 CheckInstrumentErrors Exit Function VisaComError MsgBox VISA COM Error vbCrLf CStr Err Number _ Err Source _ Err Description vbExclamation VISA COM Error End End Function Private Sub Chec...

Страница 809: ...e project you wish to modify not the solution in the Solution Explorer window of the Microsoft Visual Studio environment b Choose Add Reference c In the Add Reference dialog select the COM tab d Selec...

Страница 810: ...tion err Console WriteLine System Error Message err Message catch System Exception err System Diagnostics Debug Fail Unexpected Error Console WriteLine Unexpected Error err Message finally myScope Clo...

Страница 811: ...ned from instrument string strPath Query and read setup string ResultsArray myScope DoQueryIEEEBlock SYSTem SETup nLength ResultsArray Length Write setup string to file strPath c scope config setup st...

Страница 812: ...CHANnel1 Analyze the captured waveform private static void Analyze byte ResultsArray Results array int nLength Number of bytes returned from instrument string strPath Make a couple of measurements myS...

Страница 813: ...ng WAVeform POINts Set the waveform source myScope DoCommand WAVeform SOURce CHANnel1 Console WriteLine Waveform source 0 myScope DoQueryString WAVeform SOURce Choose the format of the data returned W...

Страница 814: ...ement fResultsArray 7 Console WriteLine Waveform Y increment 0 e fYincrement double fYorigin fResultsArray 8 Console WriteLine Waveform Y origin 0 e fYorigin double fYreference fResultsArray 9 Console...

Страница 815: ...c void DoCommand string strCommand Send the command m_IoObject WriteString strCommand true Check for inst errors CheckInstrumentErrors strCommand public void DoCommandIEEEBlock string strCommand byte...

Страница 816: ...ResultsArray double m_IoObject ReadList IEEEASCIIType ASCIIType_R8 Check for inst errors CheckInstrumentErrors strQuery Return result numbers return fResultsArray public byte DoQueryIEEEBlock string s...

Страница 817: ...trInstrumentError ToString StartsWith 0 private void OpenIo m_ResourceManager new ResourceManagerClass m_IoObject new FormattedIO488Class Open the default VISA COM IO object try m_IoObject IO IMessage...

Страница 818: ...Add Reference dialog select the COM tab d Select VISA COM 3 0 Type Library then click OK e Right click the project you wish to modify not the solution in the Solution Explorer window of the Microsoft...

Страница 819: ...e WriteLine Unexpected Error err Message Finally myScope Close End Try End Sub Initialize the oscilloscope to a known state Private Shared Sub Initialize Dim strResults As String Get and display the d...

Страница 820: ...File Open strPath FileMode Create fStream Write ResultsArray 0 nLength fStream Close Console WriteLine Setup bytes saved 0 nLength Change settings with individual commands Set vertical scale and offs...

Страница 821: ...couple of measurements myScope DoCommand MEASure SOURce CHANnel1 Console WriteLine Measure source 0 _ myScope DoQueryString MEASure SOURce myScope DoCommand MEASure FREQuency fResult myScope DoQueryNu...

Страница 822: ...ings Dim fResultsArray As Double fResultsArray myScope DoQueryNumbers WAVeform PREamble Dim fFormat As Double fResultsArray 0 If fFormat 0 Then Console WriteLine Waveform format BYTE ElseIf fFormat 1...

Страница 823: ...output file strPath c scope data waveform_data csv If File Exists strPath Then File Delete strPath End If Open file for output Dim writer As StreamWriter File CreateText strPath Output waveform data i...

Страница 824: ...Check for inst errors CheckInstrumentErrors strCommand End Sub Public Function DoQueryString ByVal strQuery As String As String Send the query m_IoObject WriteString strQuery True Get the result strin...

Страница 825: ...y System Threading Thread Sleep 2000 Delay before reading data Dim ResultsArray As Byte ResultsArray _ m_IoObject ReadIEEEBlock IEEEBinaryType BinaryType_UI1 _ False True Check for inst errors CheckIn...

Страница 826: ...ry Marshal ReleaseComObject m_IoObject Catch End Try Try Marshal ReleaseComObject m_ResourceManager Catch End Try End Sub End Class End Namespace VISA COM Example in Python You can use the Python prog...

Страница 827: ...ate comtypes gen VisaComLib if not hasattr sys frozen GetModule C Program Files x86 IVI Foundation VISA VisaCom GlobMgr dll import comtypes gen VisaComLib as VisaComLib Global variables booleans 0 Fal...

Страница 828: ...ividual commands Set vertical scale and offset do_command CHANnel1 SCALe 0 05 qresult do_query_number CHANnel1 SCALe print Channel 1 vertical scale f qresult do_command CHANnel1 OFFSet 1 5 qresult do_...

Страница 829: ...ngth len image_bytes f open c scope data screen bmp wb f write bytearray image_bytes f close print Screen image written to c scope data screen bmp Download waveform data Set the waveform points mode d...

Страница 830: ...veform Y increment f y_increment print Waveform Y origin f y_origin print Waveform Y reference d y_reference Always 125 Get numeric values for later calculations x_increment do_query_number WAVeform X...

Страница 831: ...pe WriteString s query True result myScope ReadString check_instrument_errors query return result Send a query check for errors return string def do_query_ieee_block query myScope WriteString s query...

Страница 832: ...eak else SYSTem ERRor should always return string print ERROR SYSTem ERRor returned nothing command s command print Exited because of error sys exit 1 Main program rm CreateObject VISA GlobalRM interf...

Страница 833: ...xample c file and click Add 6 Edit the program to use the VISA address of your oscilloscope 7 Choose Project Properties In the Property Pages dialog update these project settings a Under Configuration...

Страница 834: ..._query_numbers char query Query for numbers int do_query_ieeeblock char query Query for IEEE block void check_instrument_errors Check for inst errors void error_handler VISA error handler Global varia...

Страница 835: ...mmand RST Capture the waveform void capture void int num_bytes FILE fp Use auto scale to automatically configure oscilloscope do_command AUToscale Set trigger mode EDGE PULSe PATTern etc and input sou...

Страница 836: ...t horizontal scale and offset do_command TIMebase SCALe 0 0002 do_query_string TIMebase SCALe printf Timebase scale s n str_result do_command TIMebase POSition 0 0 do_query_string TIMebase POSition pr...

Страница 837: ...4f kHz n num_result 1000 do_command MEASure VAMPlitude do_query_number MEASure VAMPlitude printf Vertical amplitude 2f V n num_result Download the screen image do_command HARDcopy INKSaver OFF Read s...

Страница 838: ...do_query_numbers WAVeform PREamble wav_format dbl_results 0 if wav_format 0 0 printf Waveform format BYTE n else if wav_format 1 0 printf Waveform format WORD n else if wav_format 2 0 printf Waveform...

Страница 839: ...n num_bytes Open file for output fp fopen c scope data waveform_data csv wb Output waveform data in CSV format for i 0 i num_bytes 1 i Write time value voltage value fprintf fp 9f 6f n x_origin float...

Страница 840: ...n data_length Query for a string result void do_query_string query char query char message 80 strcpy message query strcat message n err viPrintf vi message if err VI_SUCCESS error_handler err viScanf...

Страница 841: ...ar query char message 80 int data_length strcpy message query strcat message n err viPrintf vi message if err VI_SUCCESS error_handler data_length IEEEBLOCK_SPACE err viScanf vi b n data_length ieeebl...

Страница 842: ...CCESS exit 1 VISA Example in Visual Basic To run this example in Visual Basic for Applications 1 Start the application that provides Visual Basic for Applications for example Microsoft Excel 2 Press A...

Страница 843: ...ay DblArraySize As Double Declare fixed length string variable to hold string value returned by viVScanf viVQueryf Public strQueryResult As String 200 For Sleep subroutine Private Declare Sub Sleep Li...

Страница 844: ...uto scale to automatically configure oscilloscope DoCommand AUToscale Set trigger mode EDGE PULSe PATTern etc and input source DoCommand TRIGger MODE EDGE Debug Print Trigger mode _ DoQueryString TRIG...

Страница 845: ...Channel 1 vertical offset _ DoQueryString CHANnel1 OFFSet Set horizontal scale and position DoCommand TIMebase SCALe 0 0002 Debug Print Timebase scale _ DoQueryString TIMebase SCALe DoCommand TIMebase...

Страница 846: ...DoQueryNumber MEASure VAMPlitude MsgBox Vertial amplitude vbCrLf _ FormatNumber dblQueryResult 4 V Download the screen image DoCommand HARDcopy INKSaver OFF Get screen image Dim lngBlockSize As Long...

Страница 847: ...m FORMat Display the waveform settings Dim intFormat As Integer Dim intType As Integer Dim lngPoints As Long Dim lngCount As Long Dim dblXIncrement As Double Dim dblXOrigin As Double Dim lngXReference...

Страница 848: ...rence _ FormatNumber lngXReference 0 Debug Print Waveform Y increment _ Format sngYIncrement Scientific Debug Print Waveform Y origin _ FormatNumber lngYOrigin 0 Debug Print Waveform Y reference _ For...

Страница 849: ...nt lngBlockSize Dim strCommandAndLength As String strCommandAndLength command _ Format lngBlockSize b err viVPrintf vi strCommandAndLength vbLf paramsArray 1 If err VI_SUCCESS Then HandleVISAError vi...

Страница 850: ...umber of elements array can hold retCount DblArraySize Read numbers err viVScanf vi lf vbLf paramsArray 0 If err VI_SUCCESS Then HandleVISAError vi retCount is now actual number of values returned by...

Страница 851: ...anf vi t strErrVal Read Errnum Error String If err VI_SUCCESS Then HandleVISAError vi While Val strErrVal 0 End if find 0 No Error strOut strOut INST Error strErrVal err viVPrintf vi SYSTem ERRor vbLf...

Страница 852: ...y not the solution in the Solution Explorer window of the Microsoft Visual Studio environment b Click Add and then click Add Existing Item c Navigate to the header file visa32 cs installed with Agilen...

Страница 853: ...data Capture Analyze the captured waveform Analyze catch System ApplicationException err Console WriteLine VISA Error Message err Message catch System SystemException err Console WriteLine System Err...

Страница 854: ...gger edge level 0 myScope DoQueryString TRIGger EDGE LEVel myScope DoCommand TRIGger EDGE SLOPe POSitive Console WriteLine Trigger edge slope 0 myScope DoQueryString TRIGger EDGE SLOPe Save oscillosco...

Страница 855: ...Read setup string from file strPath c scope config setup stp DataArray File ReadAllBytes strPath Restore setup string nBytesWritten myScope DoCommandIEEEBlock SYSTem SETup DataArray Console WriteLine...

Страница 856: ...e Waveform points mode 0 myScope DoQueryString WAVeform POINts MODE Get the number of waveform points available myScope DoCommand WAVeform POINts 10240 Console WriteLine Waveform points available 0 my...

Страница 857: ...0 e fXincrement double fXorigin fResultsArray 5 Console WriteLine Waveform X origin 0 e fXorigin double fXreference fResultsArray 6 Console WriteLine Waveform X reference 0 e fXreference double fYincr...

Страница 858: ...Address Save VISA addres in member variable m_strVisaAddress strVisaAddress Open the default VISA resource manager OpenResourceManager Open a VISA resource session OpenSession Clear the interface int...

Страница 859: ...query VisaSendCommandOrQuery strQuery Get the result string StringBuilder strResults new StringBuilder 1000 strResults VisaGetResultString Check for inst errors CheckInstrumentErrors strQuery Return...

Страница 860: ...e void VisaSendCommandOrQuery string strCommandOrQuery Send command or query to the device string strWithNewline strWithNewline String Format 0 n strCommandOrQuery int nViStatus nViStatus visa32 viPri...

Страница 861: ...tsArray to 300 000 300kB length 300000 Read return value string from the device int nViStatus nViStatus visa32 viScanf m_nSession b ref length ResultsArray CheckVisaStatus nViStatus Write and read buf...

Страница 862: ...ourceManager this m_strVisaAddress visa32 VI_NO_LOCK visa32 VI_TMO_IMMEDIATE out this m_nSession CheckVisaStatus nViStatus public void SetTimeoutSeconds int nSeconds int nViStatus nViStatus visa32 viS...

Страница 863: ...gram Files IVI Foundation VISA WinNT include directory select it but do not click the Open button d Click the down arrow to the right of the Add button and choose Add as Link You should now see the fi...

Страница 864: ...err Message End Try End Sub Initialize the oscilloscope to a known state Private Shared Sub Initialize Dim strResults As StringBuilder Get and display the device s IDN string strResults myScope DoQuer...

Страница 865: ...ate fStream Write ResultsArray 0 nLength fStream Close Console WriteLine Setup bytes saved 0 nLength Change settings with individual commands Set vertical scale and offset myScope DoCommand CHANnel1 S...

Страница 866: ...measurements myScope DoCommand MEASure SOURce CHANnel1 Console WriteLine Measure source 0 _ myScope DoQueryString MEASure SOURce myScope DoCommand MEASure FREQuency fResult myScope DoQueryNumber MEASu...

Страница 867: ...form settings Dim fResultsArray As Double fResultsArray myScope DoQueryNumbers WAVeform PREamble Dim fFormat As Double fResultsArray 0 If fFormat 0 Then Console WriteLine Waveform format BYTE ElseIf f...

Страница 868: ...file strPath c scope data waveform_data csv If File Exists strPath Then File Delete strPath End If Open file for output Dim writer As StreamWriter File CreateText strPath Output waveform data in CSV f...

Страница 869: ...nLength As Integer Dim nBytesWritten As Integer nLength DataArray Length strCommandAndLength String Format 0 8 1 D8 _ strCommand nLength Write first part of command to formatted I O write buffer nViSt...

Страница 870: ...result string Dim fResultsArray As Double fResultsArray VisaGetResultNumbers Check for instrument errors another command and result CheckInstrumentErrors strQuery Return string results Return fResult...

Страница 871: ...device Dim nViStatus As Integer nViStatus visa32 viScanf m_nSession lf fResults CheckVisaStatus nViStatus Return fResults End Function Private Function VisaGetResultNumbers As Double Dim fResultsArra...

Страница 872: ...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 O...

Страница 873: ...ISA package to control Agilent oscilloscopes The Python language and PyVISA package can be downloaded from the web at http www python org and http pyvisa sourceforge net respectively To run this examp...

Страница 874: ...ommand TRIGger EDGE SOURCe CHANnel1 qresult do_query_string TRIGger EDGE SOURce print Trigger edge source s qresult do_command TRIGger EDGE LEVel 1 5 qresult do_query_string TRIGger EDGE LEVel print T...

Страница 875: ...up f open setup stp rb sSetup f read f close do_command SYSTem SETup 8 08d s len sSetup sSetup hide_param s True print Setup bytes restored d len sSetup Capture an acquisition using DIGitize do_comman...

Страница 876: ...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...

Страница 877: ...d len values Save waveform data values to CSV file f open waveform_data csv w for i in xrange 0 len values 1 time_val x_origin i x_increment voltage values i y_reference y_increment y_origin f write E...

Страница 878: ...find 0 0 3 1 Not No error print ERROR s command s error_string command print Exited because of error sys exit 1 else No error break else SYSTem ERRor should always return string print ERROR SYSTem ERR...

Страница 879: ...rammer s Guide 879 return sData Main program InfiniiVision visa instrument TCPIP0 130 29 70 139 inst0 INSTR InfiniiVision timeout 15 InfiniiVision term_chars InfiniiVision clear Initialize the oscillo...

Страница 880: ...Project Properties In the Property Pages dialog update these project settings a Under Configuration Properties Linker Input add sicl32 lib to the Additional Dependencies field b Under Configuration Pr...

Страница 881: ...mber void do_query_numbers char query Query for numbers int do_query_ieeeblock char query Query for IEEE block void check_instrument_errors Check for inst errors Global variables INST id Device sessio...

Страница 882: ...t value for this session to 5 seconds itimeout id TIMEOUT Clear the interface iclear id Get and display the device s IDN string do_query_string IDN printf Oscilloscope IDN string s n str_result Clear...

Страница 883: ...etup stp n Change settings with individual commands Set vertical scale and offset do_command CHANnel1 SCALe 0 05 do_query_string CHANnel1 SCALe printf Channel 1 vertical scale s n str_result do_comman...

Страница 884: ...y_increment double y_origin double y_reference FILE fp int num_bytes Number of bytes returned from instrument int i Make a couple of measurements do_command MEASure SOURce CHANnel1 do_query_string MEA...

Страница 885: ..._result Set the waveform source do_command WAVeform SOURce CHANnel1 do_query_string WAVeform SOURce printf Waveform source s n str_result Choose the format of the data returned WORD BYTE ASCII do_comm...

Страница 886: ...f Waveform Y increment e n y_increment y_origin dbl_results 8 printf Waveform Y origin e n y_origin y_reference dbl_results 9 printf Waveform Y reference e n y_reference Read waveform data num_bytes d...

Страница 887: ...data_length strcpy message command strcat message 8 08d iprintf id message num_bytes ifwrite id ieeeblock_data num_bytes 1 data_length check_instrument_errors return data_length Query for a string re...

Страница 888: ...lock result int do_query_ieeeblock query char query char message 80 int data_length strcpy message query strcat message n iprintf id message data_length IEEEBLOCK_SPACE iscanf id b data_length ieeeblo...

Страница 889: ...nt IO Libraries Suite and found in the Program Files Agilent IO Libraries Suite include directory select it and click Open 4 Choose Insert Module 5 Cut and paste the code that follows into the editor...

Страница 890: ...m a known state Initialize Capture data Capture Analyze the captured waveform Analyze Close the vi session and the resource manager session Call iclose id Exit Sub ErrorHandler MsgBox Error Error vbEx...

Страница 891: ...rce _ 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 edg...

Страница 892: ...Timebase position _ DoQueryString TIMebase POSition Set the acquisition type NORMal PEAK AVERage or HRESolution DoCommand ACQuire TYPE NORMal Debug Print Acquire type _ DoQueryString ACQuire TYPE Or...

Страница 893: ...the screen image DoCommand HARDcopy INKSaver OFF Get screen image Dim lngBlockSize As Long lngBlockSize DoQueryIEEEBlock_Bytes DISPlay DATA PNG COLor Debug Print Screen image bytes CStr lngBlockSize S...

Страница 894: ...s 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 Preamble Do...

Страница 895: ...mber sngYOrigin 0 Debug Print Waveform Y reference _ FormatNumber lngYReference 0 Get the waveform data Dim lngNumBytes As Long lngNumBytes DoQueryIEEEBlock_Bytes WAVeform DATA Debug Print Number of d...

Страница 896: ...ors Exit Sub ErrorHandler MsgBox Error Error vbExclamation End End Sub Private Function DoCommandIEEEBlock command As String _ lngBlockSize As Long On Error GoTo ErrorHandler Send command part Call iv...

Страница 897: ...e Function DoQueryNumber query As String As Double On Error GoTo ErrorHandler Dim dblResult As Double Call ivprintf id query vbLf Call ivscanf id lf vbLf dblResult DoQueryNumber dblResult CheckInstrum...

Страница 898: ...ckLength As String strBlockLength Dim i As Integer For i 2 To intLengthDigits 1 strBlockLength strBlockLength Chr byteArray i Next Return number of bytes in block plus header DoQueryIEEEBlock_Bytes CL...

Страница 899: ...Vision 2000 X Series Oscilloscopes Programmer s Guide 899 If Not strOut Then MsgBox strOut vbExclamation INST Error Messages Call iflush id I_BUF_READ Or I_BUF_WRITE End If Exit Sub ErrorHandler MsgBo...

Страница 900: ...abVIEW Microsoft Excel Agilent VEE and Agilent SystemVue For more information on Agilent Command Expert and to download the software see http www agilent com find commandexpert SCPI NET Example in C o...

Страница 901: ...gramming features of your Agilent oscilloscope using System using System IO using System Text using Agilent CommandExpert ScpiNet AgInfiniiVision2000X_01_20 namespace InfiniiVision class ScpiNetInstru...

Страница 902: ...c void Initialize string strResults Get and display the device s IDN string myScope SCPI IDN Query out strResults Console WriteLine IDN result is 0 strResults Clear status and load the default setup m...

Страница 903: ...sArray Console WriteLine Setup bytes saved 0 nLength Change settings with individual commands Set vertical scale and offset myScope SCPI CHANnel SCALe Command 1 0 05 myScope SCPI CHANnel SCALe Query 1...

Страница 904: ...Quency Query CHANnel1 out fResult Console WriteLine Frequency 0 F4 kHz fResult 1000 Use direct command query when commands not in command set myScope Transport Command Invoke MEASure VAMPlitude CHANne...

Страница 905: ...e WriteLine Waveform source 0 strResults Choose the format of the data returned WORD BYTE ASCII myScope SCPI WAVeform FORMat Command BYTE myScope SCPI WAVeform FORMat Query out strResults Console Writ...

Страница 906: ...Scope SCPI WAVeform DATA QueryBYTE out byteResultsArray nLength byteResultsArray Length Console WriteLine Number of data values 0 nLength Set up output file strPath c scope data waveform_data csv if F...

Страница 907: ...20 dll then click OK e Right click the project you wish to modify not the solution in the Solution Explorer window of the Microsoft Visual Studio environment and choose Properties then select InfiniiV...

Страница 908: ...System Diagnostics Debug Fail Unexpected Error Console WriteLine Unexpected Error err Message myScope Dispose Finally End Try End Sub Initialize the oscilloscope to a known state Private Shared Sub In...

Страница 909: ...PI SYSTem SETup Query strResultsArray nLength strResultsArray Length Write setup string to file strPath c scope config setup stp File WriteAllLines strPath strResultsArray Console WriteLine Setup byte...

Страница 910: ...I MEASure SOURce Query source1 source2 Console WriteLine Measure source 0 source1 myScope SCPI MEASure FREQuency Command CHANnel1 myScope SCPI MEASure FREQuency Query CHANnel1 fResult Console WriteLin...

Страница 911: ...m FORMat Command BYTE myScope SCPI WAVeform FORMat Query strResults Console WriteLine Waveform format 0 strResults Display the waveform settings Dim nFormat As Integer nType As Integer nPoints As Inte...

Страница 912: ...ut Dim writer As StreamWriter File CreateText strPath Output waveform data in CSV format For i As Integer 0 To nLength 2 writer WriteLine 0 f9 1 f6 _ dblXorigin CSng i dblXincrement _ CSng byteResults...

Страница 913: ...mand Expert ScpiNetDrivers import string Import NET modules from System import from System IO import from System Text import from System Runtime InteropServices import import clr clr AddReference AgIn...

Страница 914: ...ommands Set vertical scale and offset scope SCPI CHANnel SCALe Command 1 0 05 qresult scope SCPI CHANnel SCALe Query 1 print Channel 1 vertical scale f qresult scope SCPI CHANnel OFFSet Command 1 1 5...

Страница 915: ...I DISPlay DATA Query PNG COLor nLength len image_bytes fStream File Open screen_image png FileMode Create fStream Write image_bytes 0 nLength fStream Close print Screen image written to screen_image p...

Страница 916: ...rence Get numeric values for later calculations x_increment scope SCPI WAVeform XINCrement Query x_origin scope SCPI WAVeform XORigin Query y_increment scope SCPI WAVeform YINCrement Query y_origin sc...

Страница 917: ...cilloscopes Programmer s Guide 917 scope Transport DefaultTimeout Set 10000 Initialize the oscilloscope capture data and analyze initialize capture analyze print End of program Wait for a key press be...

Страница 918: ...918 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 38 Programming Examples...

Страница 919: ...nalyzing captured data 51 angle brackets 118 annotate channels 225 annotation background display 254 annotation color display 255 annotation text display 256 annotation display 253 apply network print...

Страница 920: ...ode AUToscale 154 code CHANnel n LABel 225 code CHANnel n PROBe 227 code CHANnel n RANGe 233 code DIGitize 160 code DISPlay DATA 258 code DISPlay LABel 259 code DISPlay ORDer 715 code MEASure PERiod 3...

Страница 921: ...glitch trigger 615 digital channels 6 digital channels activity and logic levels on 151 digital channels groups of 411 412 414 digital pod stop displaying 158 digital reset conditions 137 571 DIGital...

Страница 922: ...at 639 644 format for block data 131 format for hardcopy 720 format for image 431 format for waveform data 440 FormattedIO488 object 53 formfeed for hardcopy 296 300 formulas for data conversion 632 f...

Страница 923: ...150 invert graticule colors for hardcopy 301 723 invert graticule colors for image 432 inverted masks bind levels 404 inverting input for channels 224 IO library referencing 52 IP address 42 IronPyth...

Страница 924: ...rements show 360 measurements snapshot all 342 measurements source channel 361 measurements start marker time 729 measurements stop marker time 730 measurements thresholds 728 measurements time betwee...

Страница 925: ...mation recall 421 path information save 437 pattern 473 474 475 pattern data LIN 489 pattern duration 609 610 pattern for pattern trigger 617 pattern format LIN 492 pattern length 466 491 PATTern trig...

Страница 926: ...on 319 remove labels 259 remove message from display 566 reorder channels 153 repetitive acquisitions 176 report errors 567 report transition 363 365 reporting status 759 reporting the setup 590 reque...

Страница 927: ...7 SPI decode bit order 495 SPI decode word width 508 SPI MISO data 653 SPI SEARch commands 555 SPI serial search data 557 SPI serial search data width 558 SPI serial search mode 556 SPI trigger 498 50...

Страница 928: ...N pattern ID mode 468 trigger CAN sample point 459 trigger CAN signal baudrate 460 trigger CAN signal definition 461 trigger CAN source 462 trigger edge coupling 602 trigger edge level 603 trigger edg...

Страница 929: ...T VISA example 863 Visual Basic 6 0 53 Visual Basic for Applications 52 800 Visual Basic SICL library example 889 Visual Basic VISA COM example 800 Visual Basic VISA example 842 voltage crossing repor...

Страница 930: ...unctions 578 X increment 657 X origin 658 X reference 659 X Y mode 578 579 Y Y axis markers 318 Y cursor units 330 331 Y offset reference waveform 700 Y range reference waveform 701 Y scale reference...

Результаты поиска

Содержание InfiniiVision 2000 X-Series

Отзывы:

Agilent Technologies InfiniiVision 2000 X-Series, Руководство программиста, Страница: 846 / 930

Результаты поиска

Содержание InfiniiVision 2000 X-Series

Отзывы: