manualshive.com logo in svg

Agilent Technologies DSO6014A/L, Programmer'S Reference Manual

Share
Download
Agilent Technologies DSO6014A/L Programmer'S Reference Manual Download Page 167

Commands by Subsystem

3

Agilent 6000 Series Oscilloscopes Programmer's Reference

167

 

:CHANnel<n> Commands

Control all oscilloscope functions associated with individual analog 
channels or groups of channels. See 

"Introduction to :CHANnel<n> 

Commands" 

on page 168.

Table 50 :CHANnel<n> Commands Summary

Command

Query

Options and Query Returns

:CHANnel<n>:BWLimit {{0 

| OFF} | {1 | ON}} (see 

page 170

)

:CHANnel<n>:BWLimit? 

(see 

page 170

)

{0 | 1}

<n> ::= 1-2 or 1-4 in NR1 format

:CHANnel<n>:COUPling 

<coupling> (see 

page 171

)

:CHANnel<n>:COUPling? 

(see 

page 171

)

<coupling> ::= {AC | DC}

<n> ::= 1-2 or 1-4 in NR1 format

:CHANnel<n>:DISPlay {{0 

| OFF} | {1 | ON}} (see 

page 172

)

:CHANnel<n>:DISPlay? 

(see 

page 172

)

{0 | 1}

<n> ::= 1-2 or 1-4 in NR1 format

:CHANnel<n>:IMPedance 

<impedance> (see 

page 173

)

:CHANnel<n>:IMPedance? 

(see 

page 173

)

<impedance> ::= {ONEMeg | FIFTy}

<n> ::= 1-2 or 1-4 in NR1 format

:CHANnel<n>:INVert {{0 

| OFF} | {1 | ON}} (see 

page 174

)

:CHANnel<n>:INVert? 

(see 

page 174

)

{0 | 1}

<n> ::= 1-2 or 1-4 in NR1 format

:CHANnel<n>:LABel 

<string> (see 

page 175

)

:CHANnel<n>:LABel? (see 

page 175

)

<string> ::= any series of 6 or less 

ASCII characters enclosed in 

quotation marks

<n> ::= 1-2 or 1-4 in NR1 format

:CHANnel<n>:OFFSet 

<offset>[suffix] (see 

page 176

)

:CHANnel<n>:OFFSet? 

(see 

page 176

)

<offset> ::= Vertical offset value 

in NR3 format

[suffix] ::= {V | mV}

<n> ::= 1-2 or 1-4; in NR1 format

:CHANnel<n>:PROBe 

<attenuation> (see 

page 177

)

:CHANnel<n>:PROBe? (see 

page 177

)

<attenuation> ::= Probe attenuation 

ratio in NR3 format

<n> ::= 1-2 or 1-4r in NR1 format

n/a

:CHANnel<n>:PROBe:ID? 

(see 

page 178

)

<probe id> ::= unquoted ASCII string 

up to 11 characters

<n> ::= 1-2 or 1-4 in NR1 format

:CHANnel<n>:PROBe:SKEW 

<skew_value> (see 

page 179

)

:CHANnel<n>:PROBe:SKEW? 

(see 

page 179

)

<skew_value> ::= -100 ns to +100 ns 

in NR3 format

<n> ::= 1-2 or 1-4 in NR1 format

Summary of Contents for DSO6014A/L

Page 1: ...A Agilent 6000 Series Oscilloscopes Programmer s Reference...

Page 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...

Page 3: ...469 Obsolete and Discontinued Commands on page 491 Error Messages on page 533 Status Reporting on page 541 More About Oscilloscope Commands on page 563 Programming Examples on page 585 See the Agilen...

Page 4: ...that describe analog channels refer to all oscilloscope models Whenever a topic describes digital channels that information applies only to the mixed signal oscilloscope models Example Programs The ex...

Page 5: ...mand Summary 32 Syntax Elements 70 Number Format 70 NL Line Terminator 70 Optional Syntax Terms 70 Braces 70 Defined As 70 Angle Brackets 71 Ellipsis 71 n p Value Ranges 71 d Digits 71 Quoted ASCII St...

Page 6: ...Dition Hardware Event Condition Register 115 HWERegister EVENt Hardware Event Event Register 117 MERGe 119 OPEE Operation Status Enable Register 120 OPERegister CONDition Operation Status Condition Re...

Page 7: ...TEMPerature 165 CALibrate TIME 166 CHANnel n Commands 167 CHANnel n BWLimit 170 CHANnel n COUPling 171 CHANnel n DISPlay 172 CHANnel n IMPedance 173 CHANnel n INVert 174 CHANnel n LABel 175 CHANnel n...

Page 8: ...STYPe 208 EXTernal PROTection 209 EXTernal RANGe 210 EXTernal UNITs 211 FUNCtion Commands 212 FUNCtion CENTer 214 FUNCtion DISPlay 215 FUNCtion OFFSet 216 FUNCtion OPERation 217 FUNCtion RANGe 218 FU...

Page 9: ...EASure FREQuency 259 MEASure NWIDth 260 MEASure OVERshoot 261 MEASure PERiod 263 MEASure PHASe 264 MEASure PREShoot 265 MEASure PWIDth 266 MEASure RISetime 267 MEASure SDEViation 268 MEASure SHOW 269...

Page 10: ...UNt RESet 305 SBUS FLEXray COUNt SYNC 306 SBUS FLEXray COUNt TOTal 307 SBUS IIC ASIZe 308 SBUS LIN PARity 309 SBUS MODE 310 SBUS SPI WIDTh 311 SYSTem Commands 312 SYSTem DATE 313 SYSTem DSP 314 SYSTem...

Page 11: ...er DURation PATTern 357 TRIGger DURation QUALifier 358 TRIGger DURation RANGe 359 TRIGger EBURst Commands 360 TRIGger EBURst COUNt 361 TRIGger EBURst IDLE 362 TRIGger EBURst SLOPe 363 TRIGger EDGE Com...

Page 12: ...mands 400 TRIGger LIN ID 401 TRIGger LIN SAMPlepoint 402 TRIGger LIN SIGNal BAUDrate 403 TRIGger LIN SOURce 404 TRIGger LIN STANdard 405 TRIGger LIN SYNCbreak 406 TRIGger LIN TRIGger 407 TRIGger SEQue...

Page 13: ...m DATA 446 WAVeform FORMat 448 WAVeform POINts 449 WAVeform POINts MODE 451 WAVeform PREamble 453 WAVeform SOURce 456 WAVeform TYPE 460 WAVeform UNSigned 461 WAVeform VIEW 462 WAVeform XINCrement 463...

Page 14: ...PPer 521 MEASure VDELta 522 MEASure VSTArt 523 MEASure VSTOp 524 PRINt 525 TIMebase DELay 527 TRIGger CAN ACKNowledge 528 TRIGger CAN SIGNal DEFinition 529 TRIGger LIN SIGNal DEFinition 530 TRIGger TH...

Page 15: ...and Queues 560 Status Reporting Decision Chart 561 8 More About Oscilloscope Commands Command Classifications 564 Core Commands 564 Non Core Commands 564 Obsolete Commands 564 Valid Command Query Stri...

Page 16: ...16 Agilent 6000 Series Oscilloscopes Programmer s Reference...

Page 17: ...illoscopes Programmer s Reference 1 What s New What s New in Version 4 10 18 What s New in Version 4 00 20 What s New in Version 3 50 22 What s New in Version 3 00 24 Command Differences From 54620 54...

Page 18: ...Sets queries the operating mode of the BusDoctor SBUS FLEXray COUNt NULL see page 304 Returns the FlexRay null frame count SBUS FLEXray COUNt RESet see page 305 Resets the FlexRay frame counters SBUS...

Page 19: ...LEXray TRIGger see page 381 Sets queries the FlexRay trigger mode Command Description Command Differences FUNCtion OPERation see page 217 You can now select the SQRT square root waveform math function...

Page 20: ...o keep the current acquisition type and mode after subsequent autoscales AUToscale CHANnels see page 108 Specifies whether to autoscale the currently displayed channels or all channels BUS n BIT m see...

Page 21: ...09 Now you can also use this command with digital channel buses DIGitize see page 111 Now you can also use this command with digital channel buses STATus see page 134 Now you can also use this command...

Page 22: ...nt condition event and enable registers have been added More detailed descriptions of the new and changed commands appear below New Commands Command Description SBUS CAN COUNt ERRor see page 298 Retur...

Page 23: ...he sync break is the idle period in the bus activity at the beginning of each packet that distinguishes one information packet from the previous one HWEenable see page 113 Sets or reads the hardware e...

Page 24: ...Dcopy FORMat command to support the PNG ASCiixy and BINary format types Changes to the DISPlay DATA query and the PRINt command to support the PNG format Changes to the WAVeform POINts command to set...

Page 25: ...s command with the serial decode bus DISPlay DATA see page 196 Now the PNG format is supported in the query HARDcopy FORMat see page 228 Now the PNG ASCiixy and BINary formats are also supported PRINt...

Page 26: ...the type of probe attached to the specified oscilloscope channel CHANnel n PROBe STYPe see page 180 Sets the channel probe signal type STYPe to differential or single ended when using the 113xA Serie...

Page 27: ...x Oscilloscopes ACQuire COUNt see page 142 The count can be set to any value from 1 to 65536 instead of 16383 DISPlay DATA see page 196 The BMP8bit format option has been added to the query There is a...

Page 28: ...for the 54620 Series oscilloscopes or 4 for the 54640 Series oscilloscopes TRG Trigger see page 97 The TRG has the same effect as the DIGitize command with no parameters instead of the RUN command TR...

Page 29: ...1 format Command Differences From 5462x 4x Oscilloscopes Obsolete Command Current Command Equivalent Behavior Differences HARDcopy DESTination see page 508 HARDcopy FILename see page 227 HARDcopy GRAY...

Page 30: ...30 Agilent 6000 Series Oscilloscopes Programmer s Reference 1 What s New...

Page 31: ...A 31 Agilent 6000 Series Oscilloscopes Programmer s Reference 2 Commands Quick Reference Command Summary 32 Syntax Elements 70...

Page 32: ...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 82 status 0 to 255 an integer in NR1 format n a IDN see page 82 AGILENT TECHNOLOGIE...

Page 33: ...LSS reserved 0 reserved 0 RCL value see page 88 n a value 0 1 2 3 4 5 6 7 8 9 RST see page 89 n a See RST Reset see page 89 SAV value see page 92 n a value 0 1 2 3 4 5 6 7 8 9 SRE mask see page 93 SRE...

Page 34: ...non zero value an integer in NR1 format WAI see page 99 n a n a Table 2 Common Commands Summary continued Command Query Options and Query Returns Table 3 Root Commands Summary Command Query Options an...

Page 35: ...IGital0 DIGital15 POD 1 2 BUS 1 2 FUNCtion MATH SBUS for MSO models source can be repeated up to 5 times n 1 2 or 1 4 in NR1 format HWEenable n see page 113 HWEenable see page 113 n 16 bit integer in...

Page 36: ...r see page 128 value integer in NR1 format See OVLenable for value PRINt options see page 130 n a options print option print option print option COLor GRAYscale PRINter0 BMP8bit BMP PNG NOFactors FACT...

Page 37: ...Lias see page 140 1 0 ACQuire COMPlete complete see page 141 ACQuire COMPlete see page 141 complete 100 an integer in NR1 format ACQuire COUNt count see page 142 ACQuire COUNt see page 142 count an in...

Page 38: ...2 an integer in NR1 format m 0 15 an integer in NR1 format BUS n CLEar see page 155 n a n 1 or 2 an integer in NR1 format BUS n DISPlay 0 OFF 1 ON see page 156 BUS n DISPlay see page 156 0 1 n 1 or 2...

Page 39: ...ibrate TEMPerature see page 165 return value degrees C delta since last cal in NR3 format n a CALibrate TIME see page 166 return value hours minutes seconds all in NR1 format Table 7 CHANnel n Command...

Page 40: ...e 179 skew_value 100 ns to 100 ns in NR3 format n 1 2 or 1 4 in NR1 format CHANnel n PROBe STYPe signal type see page 180 CHANnel n PROBe STYPe see page 180 signal type DIFFerential SINGle n 1 2 or 1...

Page 41: ...s ASCII characters enclosed in quotation marks n 0 15 an integer in NR1 format DIGital n POSition position see page 190 DIGital n POSition see page 190 n 0 15 an integer in NR1 format position 0 7 if...

Page 42: ...nary block see page 199 DISPlay LABList see page 199 binary block an ordered list of up to 75 labels each 6 characters maximum separated by newline characters DISPlay PERSistence value see page 200 DI...

Page 43: ...Returns FUNCtion CENTer frequency see page 214 FUNCtion CENTer see page 214 frequency the current center frequency in NR3 format The range of legal values is from 0 Hz to 25 GHz FUNCtion DISPlay 0 OFF...

Page 44: ...222 span the current frequency span in NR3 format Legal values are 1 Hz to 100 GHz FUNCtion WINDow window see page 223 FUNCtion WINDow see page 223 window RECTangular HANNing FLATtop Table 11 FUNCtio...

Page 45: ...E see page 234 mode OFF MEASurement MANual MARKer X1Position position suffix see page 235 MARKer X1Position see page 235 position X1 cursor position value in NR3 format suffix s ms us ns ps Hz kHz MHz...

Page 46: ...Summary continued Command Query Options and Query Returns Table 14 MEASure Commands Summary Command Query Options and Query Returns MEASure CLEar see page 250 n a n a MEASure COUNter source see page 2...

Page 47: ...ce see page 258 source CHANnel n FUNCtion MATH for DSO models source CHANnel n DIGital0 DIGital15 FUNCtion MATH for MSO models n 1 2 or 1 4 in NR1 format return_value time in seconds between the lower...

Page 48: ...1 2 CHANnel n FUNCtion MATH n 1 2 or 1 4 in NR1 format return_value the phase angle value in degrees in NR3 format MEASure PREShoot source see page 265 MEASure PREShoot source see page 265 source CHAN...

Page 49: ...e see page 270 source1 2 CHANnel n FUNCtion MATH for DSO models source1 2 CHANnel n DIGital0 DIGital15 FUNCtion MATH for MSO models n 1 2 or 1 4 in NR1 format return_value source NONE n a MEASure TEDG...

Page 50: ...Nnel n FUNCtion MATH n 1 2 or 1 4 in NR1 format return_value the amplitude of the selected waveform in volts in NR3 format MEASure VAVerage source see page 277 MEASure VAVerage source see page 277 sou...

Page 51: ...ASure VRMS source see page 282 source CHANnel n FUNCtion MATH n 1 2 or 1 4 in NR1 format return_value calculated dc RMS voltage in NR3 format n a MEASure VTIMe vtime source see page 283 vtime displaye...

Page 52: ...POD n DISPlay 0 OFF 1 ON see page 288 POD n DISPlay see page 288 0 1 n 1 2 in NR1 format POD n SIZE value see page 289 POD n SIZE see page 289 value SMALl MEDium LARGe POD n THReshold type suffix see...

Page 53: ...y 0 OFF 1 ON see page 303 SBUS DISPlay see page 303 0 1 n a SBUS FLEXray COUNt NUL L see page 304 frame_count integer in NR1 format SBUS FLEXray COUNt RES et see page 305 n a n a n a SBUS FLEXray COUN...

Page 54: ...page 316 value ON OFF SYSTem SETup setup_data see page 317 SYSTem SETup see page 317 setup_data data in IEEE 488 2 format SYSTem TIME time see page 319 SYSTem TIME see page 319 time hours minutes seco...

Page 55: ...Mebase WINDow SCALe scale_value see page 331 TIMebase WINDow SCALe see page 331 scale_value scale value in seconds in NR3 format for the delayed window Table 18 TIMebase Commands Summary continued Com...

Page 56: ...ep AUTO NORMal Table 19 General TRIGger Commands Summary continued Command Query Options and Query Returns Table 20 TRIGger CAN Commands Summary Command Query Options and Query Returns TRIGger CAN PAT...

Page 57: ...epoin t value see page 349 TRIGger CAN SAMPlepoin t see page 349 value 60 62 5 68 70 75 80 87 5 in NR3 format TRIGger CAN SIGNal BAU Drate baudrate see page 350 TRIGger CAN SIGNal BAU Drate see page 3...

Page 58: ...string mask integer or string string 0xnnnnnn n 0 9 A F TRIGger DURation QUALi fier qualifier see page 358 TRIGger DURation QUALi fier see page 358 qualifier GREaterthan LESSthan INRange OUTRange TIM...

Page 59: ...models n 1 2 or 1 4 in NR1 format TRIGger EDGE REJect OFF LF HF see page 367 TRIGger EDGE REJect see page 367 OFF LF HF TRIGger EDGE SLOPe polarity see page 368 TRIGger EDGE SLOPe see page 368 polari...

Page 60: ...integer from 2 64 TRIGger FLEXray TIME S EGMent segment_type see page 379 TRIGger FLEXray TIME S EGMent see page 379 segment_type STATic DYNamic SYMbol IDLE TRIGger FLEXray TIME S LOT slot_type slot_i...

Page 61: ...Gger GLITch POLarit y see page 387 polarity POSitive NEGative TRIGger GLITch QUALifi er qualifier see page 388 TRIGger GLITch QUALifi er see page 388 qualifier GREaterthan LESSthan RANGe TRIGger GLITc...

Page 62: ...ring 0xnn n 0 9 A F TRIGger IIC SOURce C LOCk source see page 395 TRIGger IIC SOURce C LOCk see page 395 source CHANnel n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 for MSO models n 1...

Page 63: ...oin t see page 402 value 60 62 5 68 70 75 80 87 5 in NR3 format TRIGger LIN SIGNal BAU Drate baudrate see page 403 TRIGger LIN SIGNal BAU Drate see page 403 baudrate 2400 9600 19200 TRIGger LIN SOURce...

Page 64: ...alue PATTern1 ENTered PATTern1 EXITed EDGE1 PATTern1 AND EDGE1 TRIGger SEQuence PATTe rn 1 2 value mask see page 412 TRIGger SEQuence PATTe rn 1 2 see page 412 value integer or string mask integer or...

Page 65: ...r string mask integer or string string 0xnnnnnn where n 0 9 A F TRIGger SPI PATTern WI DTh width see page 421 TRIGger SPI PATTern WI DTh see page 421 width integer from 4 to 32 in NR1 format TRIGger S...

Page 66: ...see page 430 TRIGger TV STANdard see page 430 standard GENeric NTSC PALM PAL SECam P480L60HZ P480 P720L60HZ P720 P1080L24HZ P1080 P1080L25HZ I1080L50HZ I1080 I1080L60HZ Table 31 TRIGger USB Commands...

Page 67: ...he syntax would be 800001000 1000 bytes of data NL 8 is the number of digits that follow 00001000 is the number of bytes to be transmitted 1000 bytes of data is the actual data WAVeform FORMat value s...

Page 68: ...on MATH SBUS for DSO models source CHANnel n POD 1 2 BUS 1 2 FUNCtion MATH SBUS for MSO models n 1 2 or 1 4 in NR1 format n a WAVeform TYPE see page 460 return_mode NORM PEAK AVER HRES WAVeform UNSign...

Page 69: ...n a WAVeform YORigin see page 467 return_value y origin in the current preamble in NR3 format n a WAVeform YREFerence see page 468 return_value y reference value in the current preamble in NR1 format...

Page 70: ...sponse Data on page 71 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 decimal 10 T...

Page 71: ...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 return val...

Page 72: ...Oscilloscopes Programmer s Reference 2 Commands Quick Reference 800001000 1000 bytes of data NL 8 is the number of digits that follow 00001000 is the number of bytes to be transmitted 1000 bytes of d...

Page 73: ...l n Commands on page 167 Control all oscilloscope functions associated with individual analog channels or groups of channels DIGital n Commands on page 186 Control all oscilloscope functions associate...

Page 74: ...at any given time When the instrument is initially turned on the command parser is set to the root of the command tree therefore no subsystem is selected POD Commands on page 287 Control all oscillos...

Page 75: ...User 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 82 status 0 to 255 an i...

Page 76: ...S reserved 0 reserved 0 RCL value see page 88 n a value 0 1 2 3 4 5 6 7 8 9 RST see page 89 n a See RST Reset see page 89 SAV value see page 92 n a value 0 1 2 3 4 5 6 7 8 9 SRE mask see page 93 SRE s...

Page 77: ...rs 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 th...

Page 78: ...s Oscilloscopes Programmer s Reference 3 Commands by Subsystem NOTE Each of the status registers has an enable mask register By setting the bits in the enable register you can select the status inform...

Page 79: ...ror queue and the Request for OPC flag See Also Introduction to Common Commands on page 77 STB Read Status Byte on page 95 ESE Standard Event Status Enable on page 80 ESR Standard Event Status Registe...

Page 80: ...orresponding bit in the Standard Event Status Register A zero disables the bit Table 34 Standard Event Status Enable ESE Bit Name Description When Set 1 High True Enables 7 PON Power On Event when an...

Page 81: ...nt 0 255 an integer in NR1 format See Also Introduction to Common Commands on page 77 ESR Standard Event Status Register on page 82 OPC Operation Complete on page 86 CLS Clear Status on page 79 1 RQL...

Page 82: ...llowing table shows bit weight name and condition for each bit Table 35 Standard Event Status Register ESR Bit Name Description When Set 1 High True Indicates 7 PON Power On An OFF to ON transition ha...

Page 83: ...tus Enable on page 80 OPC Operation Complete on page 86 CLS Clear Status on page 79 SYSTem ERRor on page 315 1 RQL Request Control The device is requesting control Not used 0 OPC Operation Complete Op...

Page 84: ...ery 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 th...

Page 85: ...nstrument 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 setup...

Page 86: ...er 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 thi...

Page 87: ...obe field Memory Low Speed Serial reserved reserved All field 0 All reserved 0 Factory MSO 0 MSO Upgraded MSO 0 MSO Probe field 0 Memory 0 mem2M mem8M Low Speed Serial 0 LSS reserved 0 reserved 0 The...

Page 88: ...Commands by Subsystem RCL Recall see page 564 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 Also I...

Page 89: ...itions are Acquire Menu Mode Normal Realtime On Averaging Off Averages 8 Analog Channel Menu Channel 1 On Channel 2 Off Volts division 5 00 V Offset 0 00 Coupling DC Probe attenuation AutoProbe if Aut...

Page 90: ...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 500 ns Delay time base delay 0 00 s Reference center Mo...

Page 91: ...ted 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 WriteString RS...

Page 92: ...ve see page 564 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 dat...

Page 93: ...gister A one in the Service Request Enable Register enables the corresponding bit in the Status Byte Register A zero disables the bit Table 36 Service Request Enable Register SRE Bit Name Description...

Page 94: ...Byte on page 95 CLS Clear Status on page 79 5 ESB Event Status Bit Interrupts when enabled conditions in the Standard Event Status Register ESR occur 4 MAV Message Available Interrupts when messages a...

Page 95: ...he device has at least one reason for requesting service Return Format value NL value 0 255 an integer in NR1 format Table 37 Status Byte Register STB Bit Name Description When Set 1 High True Indicat...

Page 96: ...e 5 ESB Event Status Bit An enabled condition in the Standard Event Status Register ESR has occurred 4 MAV Message Available There are messages in the Output Queue 3 Not used always 0 2 MSG Message An...

Page 97: ...s Programmer s Reference 97 TRG Trigger see page 564 Command Syntax TRG The TRG command has the same effect as the DIGitize command with no parameters See Also Introduction to Common Commands on page...

Page 98: ...f 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 troubleshooting s...

Page 99: ...lloscopes Programmer s Reference 99 WAI Wait To Continue see page 564 Command Syntax WAI The WAI command has no function in the oscilloscope but is parsed for compatibility with other instruments See...

Page 100: ...2 bit integer in NR1 format n a AER see page 104 0 1 an integer in NR1 format AUToscale source source see page 105 n a source CHANnel n for DSO models source CHANnel n DIGital0 DIGital15 POD1 POD2 for...

Page 101: ...l memory see page 119 n a pixel memory PMEMory 0 1 2 3 4 5 6 7 8 9 OPEE n see page 120 OPEE see page 121 n 16 bit integer in NR1 format n a OPERregister CONDition see page 122 n 16 bit integer in NR1...

Page 102: ...bit BMP PNG NOFactors FACTors print option can be repeated up to 5 times RUN see page 131 n a n a n a SERial see page 132 return value unquoted string containing serial number SINGle see page 133 n a...

Page 103: ...in NR1 format bit 0 DIGital 0 bit 15 DIGital 15 See Also Introduction to Root Commands on page 102 POD n THReshold on page 290 DIGital n THReshold on page 192 NOTE Because the ACTivity query returns...

Page 104: ...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...

Page 105: ...ied those specified sources will be enabled and all others blanked The autoscale channels mode see AUToscale CHANnels on page 108 is set to DISPlayed channels Then the autoscale is performed When the...

Page 106: ...2 AUToscale CHANnels on page 108 AUToscale AMODE on page 107 Example Code AUTOSCALE This command evaluates all the input signals and sets the correct conditions to display all of the active signals my...

Page 107: ...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 command...

Page 108: ...cted 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 c...

Page 109: ...ified channel digital 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 102 CDISplay on page 110 CHANnel n...

Page 110: ...nd 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 the data in active channels and fu...

Page 111: ...ction to Root Commands on page 102 RUN on page 131 SINGle on page 133 STOP on page 135 ACQuire Commands on page 138 WAVeform Commands on page 436 Example Code DIGITIZE Used to acquire the waveform dat...

Page 112: ...a single trigger Keep in mind when the oscilloscope is running communication with the computer interrupts data acquisition Setting up the oscilloscope over the bus causes the data buffers to be clear...

Page 113: ...e The HWEenable query returns the current value contained in the Hardware Event Enable register as an integer number Return Format value NL value integer in NR1 format 7R ELW LQ 2SHUDWLRQ 6WDWXV RQGLW...

Page 114: ...2 AER Arm Event Register on page 104 CHANnel n PROTection on page 181 EXTernal PROTection on page 209 OPERegister EVENt Operation Status Event Register on page 124 OVLenable Overload Event Enable Regi...

Page 115: ...on page 181 EXTernal PROTection on page 209 OPEE Operation Status Enable Register on page 120 OPERegister EVENt Operation Status Event Register on page 124 7R ELW LQ 2SHUDWLRQ 6WDWXV RQGLWLRQ 5HJLVWHU...

Page 116: ...lloscopes Programmer s Reference 3 Commands by Subsystem OVLenable Overload Event Enable Register on page 126 OVLRegister Overload Event Register on page 128 STB Read Status Byte on page 95 SRE Servic...

Page 117: ...EXTernal PROTection on page 209 OPEE Operation Status Enable Register on page 120 OPERegister CONDition Operation Status Condition Register on page 122 7R ELW LQ 2SHUDWLRQ 6WDWXV RQGLWLRQ 5HJLVWHU 25...

Page 118: ...lloscopes Programmer s Reference 3 Commands by Subsystem OVLenable Overload Event Enable Register on page 126 OVLRegister Overload Event Register on page 128 STB Read Status Byte on page 95 SRE Servic...

Page 119: ...y8 PMEMory9 The MERGe command stores the contents of the active display in the specified pixel memory The previous contents of the pixel memory are overwritten The pixel memories are PMEMory0 through...

Page 120: ...XQ UP 5HJ 5 5XQ ELW VHW LI RVFLOORVFRSH QRW VWRSSHG 23 5HUDWLRQ 21 LWLRQ 2SHUDWLRQ 6WDWXV RQGLWLRQ 5HJLVWHU 23 23 2SHUDWLRQ 6WDWXV QDEOH 0DVN 5HJLVWHU URP 2YHUORDG YHQW 5HJLVWHUV 7R 23 5 ELW LQ 6WDWXV...

Page 121: ...AER Arm Event Register on page 104 CHANnel n PROTection on page 181 EXTernal PROTection on page 209 OPERegister EVENt Operation Status Event Register on page 124 OVLenable Overload Event Enable Regist...

Page 122: ...RQ 5HJLVWHU 23 23 2SHUDWLRQ 6WDWXV QDEOH 0DVN 5HJLVWHU URP 2YHUORDG YHQW 5HJLVWHUV 7R 23 5 ELW LQ 6WDWXV WH 5HJLVWHU 29 5 25 DLW 7ULJ 5XQ 23 5DWLRQ 9 1W 2SHUDWLRQ 6WDWXV YHQW 5HJLVWHU 29 5 URP DUGZDUH...

Page 123: ...rnal PROTection on page 209 OPEE Operation Status Enable Register on page 120 OPERegister EVENt Operation Status Event Register on page 124 OVLenable Overload Event Enable Register on page 126 OVLRegi...

Page 124: ...RQ 6WDWXV QDEOH 0DVN 5HJLVWHU URP 2YHUORDG YHQW 5HJLVWHUV 7R 23 5 ELW LQ 6WDWXV WH 5HJLVWHU 29 5 25 DLW 7ULJ 5XQ 23 5DWLRQ 9 1W 2SHUDWLRQ 6WDWXV YHQW 5HJLVWHU 29 5 URP DUGZDUH YHQW 5HJLVWHUV Table 44...

Page 125: ...PROTection on page 209 OPEE Operation Status Enable Register on page 120 OPERegister CONDition Operation Status Condition Register on page 122 OVLenable Overload Event Enable Register on page 126 OVL...

Page 126: ...n the Operation Status Register NOTE You can set analog channel input impedance to 50 on the 300 MHz 500 MHz and 1 GHz bandwidth oscilloscope models On these same bandwidth models if there are only tw...

Page 127: ...EVENt Operation Status Event Register on page 124 OVLRegister Overload Event Register on page 128 STB Read Status Byte on page 95 SRE Service Request Enable on page 93 7 Channel 2 Fault Event when fa...

Page 128: ...ese same bandwidth models if there are only two analog channels you can also set external trigger input impedance to 50 7R 29 5 ELW LQ 2SHUDWLRQ 6WDWXV 5HJLVWHU 25 29 5 2YHUORDG YHQW 5HJLVWHU 29 29 2Y...

Page 129: ...le Overload Event Enable Register on page 126 STB Read Status Byte on page 95 SRE Service Request Enable on page 93 4 External Trigger OVL Overload has occurred on External Trigger input 3 Channel 4 O...

Page 130: ...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 value selected in the Print Config menu is used R...

Page 131: ...e Also Introduction to Root Commands on page 102 SINGle on page 133 STOP on page 135 Example Code RUN_STOP not executed in this example RUN starts the data acquisition for the active waveform display...

Page 132: ...es Programmer s Reference 3 Commands by Subsystem SERial see page 564 Query Syntax SERial The SERial query returns the serial number of the instrument Return Format Unquoted string NL See Also Introdu...

Page 133: ...rence 133 SINGle see page 564 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 Also...

Page 134: ...3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The STATus query reports whether the channel function trace memory or serial decode bus specified by source...

Page 135: ...ference 135 STOP see page 564 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 102...

Page 136: ...ed 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 set...

Page 137: ...channel function trace memory or serial decode bus See Also Introduction to Root Commands on page 102 BLANk on page 109 CHANnel n DISPlay on page 172 DIGital n DISPlay on page 188 FUNCtion DISPlay on...

Page 138: ...ture of the waveform Averaging Table 47 ACQuire Commands Summary Command Query Options and Query Returns n a ACQuire AALias see page 140 1 0 ACQuire COMPlete complete see page 141 ACQuire COMPlete see...

Page 139: ...re TYPE PEAK command sets the oscilloscope in the peak detect mode In this mode ACQuire COUNt has no meaning Real time Mode The ACQuire MODE RTIMe command sets the oscilloscope in real time mode This...

Page 140: ...4 Query Syntax ACQuire AALias The ACQuire AALias query returns the current state of the oscilloscope acquisition anti alias control This control can be directly disabled or disabled automatically Retu...

Page 141: ...e 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 crite...

Page 142: ...e the acquisition is considered to be complete for that time bucket When ACQuire TYPE is set to AVERage the count can be set to any value from 1 smoothing to 65536 Query Syntax ACQuire COUNT The ACQui...

Page 143: ...is good for cases where dithered data is not desired When set to AUTO the oscilloscope turns off anti alias control as needed Such cases are when the FFT or differentiate math functions are silent The...

Page 144: ...This mode is useful to inhibit equivalent time sampling at fast sweep speeds The ACQuire MODE ETIME command sets the oscilloscope in equivalent time mode Query Syntax ACQuire MODE The ACQuire MODE que...

Page 145: ...nal 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 return...

Page 146: ...sample clock to the oscilloscope A 10 MHz square or sine wave signal is input to the BNC connector labeled 10 MHz REF The amplitude must be between 180 mV and 1 V with an offset of between 0 V and 2...

Page 147: ...e 564 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_rate...

Page 148: ...e noise at slower sweep speeds where the digitizer samples faster than needed to fill memory for the displayed time range For example if the digitizer samples at 200 MSa s but the effective sample rat...

Page 149: ...42 ACQuire MODE on page 144 DIGitize on page 111 WAVeform TYPE on page 460 WAVeform PREamble on page 453 Example Code AQUIRE_TYPE Sets the acquisition mode which can be NORMAL PEAK or AVERAGE myScope...

Page 150: ...annel_list 0 1 channel_list m m m where is separator and is range n 1 or 2 an integer in NR1 format m 0 15 an integer in NR1 format BUS n CLEar see page 155 n a n 1 or 2 an integer in NR1 format BUS n...

Page 151: ...he viewing labeling and digital channel makeup of two possible buses Reporting the Setup Use BUS n to query setup information for the BUS subsystem Return Format The following is a sample response fro...

Page 152: ...ted 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 15 correspond to DIGital0 15 Query Syntax BUS n B...

Page 153: ...efinition 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 for the...

Page 154: ...154 Agilent 6000 Series Oscilloscopes Programmer s Reference 3 Commands by Subsystem Include digital channels 1 through 5 8 and 14 in bus 1 myScope WriteString BUS1 BITS 1 5 8 14 ON...

Page 155: ...ix 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 p...

Page 156: ...ected 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 Return...

Page 157: ...US n LABel query returns the name of the specified bus Return Format quoted_string NL quoted_string any series of 16 or less characters as a quoted ASCII string See Also Introduction to BUS n Commands...

Page 158: ...us 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 bus...

Page 159: ...the last calibration Starting the user calibration procedure Table 49 CALibrate Commands Summary Command Query Options and Query Returns n a CALibrate DATE see page 160 return value day month year all...

Page 160: ...3 Commands by Subsystem CALibrate DATE see page 564 Query Syntax CALibrate DATE The CALibrate DATE query returns the date of the last calibration Return Format date NL date day month year in NR1 forma...

Page 161: ...rate 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 Quer...

Page 162: ...ommand starts the user calibration procedure See Also Introduction to CALibrate Commands on page 159 CALibrate SWITch on page 164 NOTE Before starting the user calibration procedure you must set the r...

Page 163: ...Syntax CALibrate STATus The CALibrate STATus query returns the summary results of the last user calibration procedure Return Format return value NL return value ALL status_code status_string status_c...

Page 164: ...Syntax CALibrate SWITch The CALibrate SWITch query returns the rear panel calibration protect CAL PROTECT switch state The value PROTected indicates calibration is disabled and UNPRotected indicates...

Page 165: ...ure see page 564 Query Syntax CALibrate TEMPerature The CALibrate TEMPerature query returns the change in temperature since the last user calibration procedure Return Format return value NL return val...

Page 166: ...Commands by Subsystem CALibrate TIME see page 564 Query Syntax CALibrate TIME The CALibrate TIME query returns the time of the last calibration Return Format date NL date hour minutes seconds in NR1...

Page 167: ...MPedance see page 173 impedance ONEMeg FIFTy n 1 2 or 1 4 in NR1 format CHANnel n INVert 0 OFF 1 ON see page 174 CHANnel n INVert see page 174 0 1 n 1 2 or 1 4 in NR1 format CHANnel n LABel string see...

Page 168: ...EW and BLANk Reporting the Setup CHANnel n PROBe STYPe signal type see page 180 CHANnel n PROBe STYPe see page 180 signal type DIFFerential SINGle n 1 2 or 1 4 in NR1 format CHANnel n PROTection see p...

Page 169: ...Nnel4 to query setup information for the CHANnel n subsystem Return Format The following are sample responses from the CHANnel n query In this case the query was issued following a RST command CHAN1 R...

Page 170: ...models n 1 2 for the two channel oscilloscope models 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 appr...

Page 171: ...odels n 1 2 for the two channel oscilloscope models 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 Quer...

Page 172: ...two channel oscilloscope models 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 displ...

Page 173: ...dance command selects the input impedance setting for the specified analog channel The legal values for this command are ONEMeg 1 M and FIFTy 50 Query Syntax CHANnel n IMPedance The CHANnel n IMPedanc...

Page 174: ...models n 1 2 for the two channel oscilloscope models 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 O...

Page 175: ...el Return Format string NL string quoted ASCII string See Also Introduction to CHANnel n Commands on page 168 DISPlay LABel on page 198 DIGital n LABel on page 189 DISPlay LABList on page 199 BUS n LA...

Page 176: ...nnel The range of legal values 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 automatical...

Page 177: ...surements and for setting trigger levels If an AutoProbe probe is connected to the oscilloscope the attenuation value cannot be changed from the sensed value Attempting to set the oscilloscope to an a...

Page 178: ...scope models The CHANnel 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...

Page 179: ...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 skew control to re...

Page 180: ...ng the 113xA Series probes 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...

Page 181: ...clear reset the overload protection It allows the channel to be used again in 50 mode after the signal that caused the overload has been removed from the channel input Reset the analog channel input i...

Page 182: ...1 GHz models with the input impedance set to 50 If the probe attenuation is changed the range value is multiplied by the probe attenuation factor Query Syntax CHANnel n RANGe The CHANnel n RANGe query...

Page 183: ...ed channel When using 1 1 probe attenuation legal values for the scale range from 1 mV to 5 V for the 100 MHz models 2 mV to 1 V for the 300 MHz 1 GHz models with the input impedance set to 50 If the...

Page 184: ...asurement units for the connected probe Select VOLTs for a voltage probe and select AMPeres for a current probe Measurement results channel sensitivity and trigger level will reflect the measurement u...

Page 185: ...nnel oscilloscope models n 1 2 for the two channel oscilloscope models The CHANnel n VERNier command specifies whether the channel s vernier fine vertical adjustment setting is ON 1 or OFF 0 Query Syn...

Page 186: ...ital n DISPlay 0 OFF 1 ON see page 188 DIGital n DISPlay see page 188 0 1 n 0 15 an integer in NR1 format DIGital n LABel string see page 189 DIGital n LABel see page 189 string any series of 6 or les...

Page 187: ...lent 6000 Series Oscilloscopes Programmer s Reference 187 Return Format The following is a sample response from the DIGital0 query In this case the query was issued following a RST command DIG0 DISP 0...

Page 188: ...the command The DIGital n DISPlay command turns digital display on or off for the specified channel Query Syntax DIGital n DISPlay The DIGital n DISPlay query returns the current digital display sett...

Page 189: ...o adds the name to the label list in non volatile memory replacing the oldest label in the list Query Syntax DIGital n LABel The DIGital n LABel query returns the name of the specified channel Return...

Page 190: ...gic channel that is affected by the command The DIGital n POSition command sets the position of the specified channel Query Syntax DIGital n POSition The DIGital n POSition query returns the position...

Page 191: ...es the size of digital channels 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 channels 1 through 15 as we...

Page 192: ...3V The DIGital n THReshold command sets the logic threshold value for all channels grouped with the specified channel D0 D7 D8 D15 The threshold is used for triggering purposes and for displaying the...

Page 193: ...DATA format area palette display data see page 196 DISPlay DATA format area palette see page 196 format TIFF command area GRATicule command palette MONochrome command format TIFF BMP BMP8bit PNG quer...

Page 194: ...labels 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...

Page 195: ...r 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 for active chan...

Page 196: ...le area in TIFF format This is the same data saved using the front panel Save Recall menu or the SAV Save command Query Syntax DISPlay DATA format area palette format TIFF BMP BMP8bit PNG area GRATicu...

Page 197: ...teString DISPLAY DATA BMP SCREEN COLOR byteData myScope ReadIEEEBlock BinaryType_UI1 Output display data to a file strPath c scope data screen bmp Remove file if it exists If Len Dir strPath Then Kill...

Page 198: ...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 193 CHANnel n...

Page 199: ...e DISPlay LABList query returns the label list Return Format binary block NL binary block an ordered list of up to 75 labels a maximum of six characters each separated by newline characters See Also I...

Page 200: ...sistence setting MINimum indicates zero persistence and INFinite indicates infinite persistence Use the DISPlay CLEar or CDISplay root command to erase points stored by infinite persistence Query Synt...

Page 201: ...ory 0 through 9 The DISPlay SOURce command specifies the default source and destination for the DISPlay DATA command and query PMEMory0 9 correspond to the INTERN_0 9 files found in the front panel Sa...

Page 202: ...Tors command turns vector display on or off When vectors are turned on the oscilloscope displays lines connecting sampled data points When vectors are turned off only the sampled data is displayed Que...

Page 203: ...ing a RST command EXT BWL 0 IMP ONEM RANG 8 0E 00 UNIT VOLT PROB 1 0E 00 PROB STYP SING Table 53 EXTernal Trigger Commands Summary Command Query Options and Query Returns EXTernal BWLimit bwlimit see...

Page 204: ...t 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 returns the...

Page 205: ...mand are ONEMeg 1 M and FIFTy 50 Query Syntax EXTernal IMPedance The EXTernal IMPedance query returns the current input impedance setting for the external trigger Return Format impedance value NL impe...

Page 206: ...nts 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 Attempting to se...

Page 207: ...the type of probe attached to the external trigger input Return Format probe id NL probe id unquoted ASCII string up to 11 characters Some of the possible returned values are 1131A 1132A 1134A 1147A 1...

Page 208: ...l trigger probe signal type STYPe to differential or single ended when using the 113xA Series probes and determines how offset is applied Query Syntax EXTernal PROBe STYPe The EXTernal PROBe STYPe que...

Page 209: ...to clear reset the overload protection It allows the external trigger to be used again in 50 mode after the signal that caused the overload has been removed from the external trigger input Reset the e...

Page 210: ...0 V when using 1 1 probe attenuation If the probe attenuation is changed the range value is multiplied by the probe attenuation factor Query Syntax EXTernal RANGe The EXTernal RANGe query returns the...

Page 211: ...oltage probe and select AMPeres for a current probe Measurement results channel sensitivity and trigger level will reflect the measurement units you select Query Syntax EXTernal UNITs The CHANnel n UN...

Page 212: ...mes the current sensitivity of the selected function FUNCtion OPERation operation see page 217 FUNCtion OPERation see page 217 operation SUBTract MULTiply INTegrate DIFFerentiate FFT SQRT FUNCtion RAN...

Page 213: ...ting the Setup Use FUNCtion to query setup information for the FUNCtion subsystem Return Format The following is a sample response from the FUNCtion queries In this case the query was issued following...

Page 214: ...on 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 See Also...

Page 215: ...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 DIS...

Page 216: ...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 FUNCtion O...

Page 217: ...INTegrate DIFFerentiate FFT SQRT The FUNCtion OPERation command sets the desired operation for a function FFT Fast Fourier Transform SQRT square root Query Syntax FUNCtion OPERation The FUNCtion OPER...

Page 218: ...FUNCtion RANGe query returns the current full scale range value for the selected function Return Format range NL range the full scale vertical axis value in NR3 format The range for ADD SUBT MULT is 8...

Page 219: ...the nearest legal value The FUNCtion REFerence command is only used when an FFT Fast Fourier Transform operation is selected The FUNCtion REFerence command sets the reference level represented by cen...

Page 220: ...e 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 SCAL...

Page 221: ...d for more information about selecting an operation The FUNCtion SOURce command selects the source for function operations Choose CHANnel n or ADD SUBT or MULT to specify the desired source for functi...

Page 222: ...cule when FFT Fast Fourier Transform is selected Query Syntax FUNCtion SPAN The FUNCtion SPAN query returns the current frequency span in Hertz Return Format span NL span the current frequency span in...

Page 223: ...selection of three different windowing transforms or operations for the FFT Fast Fourier Transform function The FFT operation assumes that the time record repeats Unless an integral number of sampled...

Page 224: ...ST FACT 0 FFE 0 IGC 0 PAL COL Table 55 HARDcopy Commands Summary Command Query Options and Query Returns HARDcopy FACTors 0 OFF 1 ON see page 225 HARDcopy FACTors see page 225 0 1 HARDcopy FFEed 0 OFF...

Page 225: ...factors factors OFF 0 ON 1 The HARDcopy FACTors command controls whether the scale factors are output on the hardcopy dump Query Syntax HARDcopy FACTors The HARDcopy FACTors query returns a flag indic...

Page 226: ...s whether a formfeed is output at the end of a hardcopy dump ON or 1 is only valid when PRINter0 or PRINter1 is set as the HARDcopy FORMat type Query Syntax HARDcopy FFEed The HARDcopy FFEed query ret...

Page 227: ...g quoted ASCII string The HARDcopy FILename command sets the output filename for those print formats whose output is a file Query Syntax HARDcopy FILename The HARDcopy FILename query returns the curre...

Page 228: ...at command sets the hardcopy format type PRINter0 and PRINter1 are only valid when printers are connected to the oscilloscope s USB ports The first printer connected identified is PRINter0 and the sec...

Page 229: ...IGColors value value OFF 0 ON 1 The HARDcopy IGColors command controls whether the graticule colors are inverted or not Query Syntax HARDcopy IGColors The HARDcopy IGColors query returns a flag indic...

Page 230: ...and Syntax HARDcopy PALette palette palette COLor GRAYscale The HARDcopy PALette command sets the hardcopy palette color Query Syntax HARDcopy PALette The HARDcopy PALette query returns the selected h...

Page 231: ...ster POSTscript The HARDcopy PDRiver command sets the hardcopy printer driver used for the selected printer If the correct driver for the selected printer can be identified it will be selected and can...

Page 232: ...value in NR3 format MARKer X1Y1source source see page 236 MARKer X1Y1source see page 236 source CHANnel n FUNCtion MATH n 1 2 or 1 4 in NR1 format return_value source MARKer X2Position position suffi...

Page 233: ...e MARKer to query setup information for the MARKer subsystem Return Format The following is a sample response from the MARKer query In this case the query was issued following a RST and MARKer MODE MA...

Page 234: ...cursors are off or are set to the front panel Hex or Binary mode setting MARKer MODE MANual will put the cursors in the front panel Normal mode Setting the mode to MEASurement sets the marker sources...

Page 235: ...s the X1 cursor to the specified value Query Syntax MARKer X1Position The MARKer X1Position query returns the current X1 cursor position If the front panel cursors are off an error is returned This is...

Page 236: ...34 This product does not allow independent settings of the X1Y1 and X2Y2 marker sources Setting the source for one pair of markers sets the source for the other If MARKer MODE is set to OFF or MANual...

Page 237: ...position and moves the X2 cursor to the specified value Query Syntax MARKer X2Position The MARKer X2Position query returns current X2 cursor position If the front panel cursors are off an error is re...

Page 238: ...This product does not allow independent settings of the X1Y1 and X2Y2 marker sources Setting the source for one pair of markers sets the source for the other If MARKer MODE is set to OFF or MANual se...

Page 239: ...X1 cursor Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 233 MARKer MODE on page 234 MARKer X1Position on page 235 MARKer X2Position on p...

Page 240: ...Y1 cursor to the specified value Query Syntax MARKer Y1Position The MARKer Y1Position query returns current Y1 cursor position If the front panel cursors are off an error is returned This is functiona...

Page 241: ...Y2 cursor to the specified value Query Syntax MARKer Y2Position The MARKer Y2Position query returns current Y2 cursor position If the front panel cursors are off an error is returned This is function...

Page 242: ...Y1 cursor Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 233 MARKer MODE on page 234 MARKer X1Y1source on page 236 MARKer X2Y2source on p...

Page 243: ...ls n 1 2 or 1 4 in NR1 format return_value counter frequency in Hertz in NR3 format MEASure DEFine DELay delay spec see page 252 MEASure DEFine DELay see page 253 delay spec edge_spec1 edge_spec2 edge...

Page 244: ...olds in NR3 format MEASure FREQuency source see page 259 MEASure FREQuency source see page 259 source CHANnel n FUNCtion MATH for DSO models source CHANnel n DIGital0 DIGital15 FUNCtion MATH for MSO m...

Page 245: ...n FUNCtion MATH n 1 2 or 1 4 in NR1 format return_value the percent of preshoot of the selected waveform in NR3 format MEASure PWIDth source see page 266 MEASure PWIDth source see page 266 source CHA...

Page 246: ...o be reported source CHANnel n FUNCtion MATH for DSO models source CHANnel n DIGital0 DIGital15 FUNCtion MATH for MSO models n 1 2 or 1 4 in NR1 format return_value time in seconds of the specified tr...

Page 247: ...tion MATH n 1 2 or 1 4 in NR1 format base_voltage voltage at the base of the selected waveform in NR3 format MEASure VMAX source see page 279 MEASure VMAX source see page 279 source CHANnel n FUNCtion...

Page 248: ...ormat return_value voltage at the specified time in NR3 format source CHANnel n FUNCtion MATH for DSO models source CHANnel n DIGital0 DIGital15 FUNCtion MATH for MSO models n 1 2 or 1 4 in NR1 format...

Page 249: ...When the command form is used the measurement result is displayed on the instrument When the query form of these measurements is used the measurement is made one time and the measurement result is ret...

Page 250: ...pes Programmer s Reference 3 Commands by Subsystem MEASure CLEar see page 564 Command Syntax MEASure CLEar This command clears all selected measurements and markers from the screen See Also Introducti...

Page 251: ...tically adjusted to be 100 ms or twice the current time window whichever is longer up to 1 second The counter measurement can measure frequencies up to 125 MHz The minimum frequency supported is 1 2 X...

Page 252: ...fies 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 values m...

Page 253: ...le 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 betw...

Page 254: ...hreshold 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 midd...

Page 255: ...ne command 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 middl...

Page 256: ...y 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 in...

Page 257: ...cycle 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 positive pu...

Page 258: ...source is 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...

Page 259: ...he 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 at tr...

Page 260: ...parameter is 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 the trig...

Page 261: ...d either Vmax 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...

Page 262: ...262 Agilent 6000 Series Oscilloscopes Programmer s Reference 3 Commands by Subsystem MEASure VTOP on page 284 MEASure VBASe on page 278 MEASure VMIN on page 280...

Page 263: ...ce 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 IF the...

Page 264: ...phase between 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 so...

Page 265: ...op Vbase and 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 a...

Page 266: ...dified 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 midpoi...

Page 267: ...e rise time 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...

Page 268: ...starts std deviation measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure SDEViation source The MEASure SDEViation query measures and outputs...

Page 269: ...d 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 return...

Page 270: ...source1 and MARKer X2Y2source to source2 Query Syntax MEASure SOURce The MEASure SOURce query returns the current source selections If source2 is not specified the query returns NONE for source2 If a...

Page 271: ...y for risetime varQueryResult myScope ReadNumber Read risetime MsgBox Risetime vbCrLf _ FormatNumber varQueryResult 1000000 4 us myScope WriteString MEASURE VPP Query for Pk to Pk voltage varQueryResu...

Page 272: ...lects 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 the tim...

Page 273: ...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...

Page 274: ...this defined 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...

Page 275: ...nt 6000 Series Oscilloscopes Programmer s Reference 275 value time in seconds of the specified value crossing in NR3 format See Also Introduction to MEASure Commands on page 248 MEASure TEDGe on page...

Page 276: ...ement If the 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 th...

Page 277: ...stalls a screen measurement and starts an average value measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VAVerage source The MEASure VAVera...

Page 278: ...al source 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 pul...

Page 279: ...easurement 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...

Page 280: ...asurement 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...

Page 281: ...rrent source 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 a...

Page 282: ...rameter is specified the current source is modified Query Syntax MEASure VRMS source The MEASure VRMS query measures and outputs the dc RMS value of the selected waveform The dc RMS value is measured...

Page 283: ...o channel oscilloscope models 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 to th...

Page 284: ...a waveform 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 th...

Page 285: ...cted window If the optional source parameter is specified the current source is modified Query Syntax MEASure XMAX source The MEASure XMAX query measures and returns the horizontal axis value at which...

Page 286: ...cted window If the optional source parameter is specified the current source is modified Query Syntax MEASure XMIN source The MEASure XMIN query measures and returns the horizontal axis value at which...

Page 287: ...he POD subsystem 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 58 POD n Commands Summary...

Page 288: ...and POD1 D0 D7 POD2 D8 D15 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 settin...

Page 289: ...he command POD1 D0 D7 POD2 D8 D15 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 size se...

Page 290: ...below the threshold 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...

Page 291: ...s 0 7 to CMOS threshold myScope WriteString POD1 THRESHOLD CMOS Set channels 8 15 to 2 0 volts myScope WriteString POD2 THRESHOLD 2 0 Set external channel to TTL threshold short form myScope WriteStri...

Page 292: ...B SBUS BUSDoctor MODE mode see page 297 SBUS BUSDoctor MODE see page 297 mode ASYNchronous SYNChronous PC n a SBUS CAN COUNt ERRor see page 298 frame_count integer in NR1 format n a SBUS CAN COUNt OV...

Page 293: ...y In this case the query was issued following a RST command SBUS DISP 0 MODE IIC SBUS LIN PARity 0 OFF 1 ON see page 309 SBUS LIN PARity see page 309 0 1 SBUS MODE mode see page 310 SBUS MODE see page...

Page 294: ...r s IP address Query Syntax SBUS BUSDoctor ADDRess The SBUS BUSDoctor ADDRess query returns the current BusDoctor IP address byte values Return Format value NL value field value field value field valu...

Page 295: ...5 Mb s or 10 Mb s Query Syntax SBUS BUSDoctor BAUDrate The SBUS BUSDoctor BAUDrate query returns the current BusDoctor baud rate setting Return Format baudrate NL baudrate 2500000 5000000 10000000 Er...

Page 296: ...s preprocesses Query Syntax SBUS BUSDoctor CHANnel The SBUS BUSDoctor CHANnel query returns the current BusDoctor channel setting Return Format channel NL channel A B Errors 241 Hardware missing on pa...

Page 297: ...scope controls BusDoctor synchronous mode monitoring LAN connection required PC PC running Decomsys VISION software controls BusDoctor Query Syntax SBUS BUSDoctor MODE The SBUS BUSDoctor MODE query re...

Page 298: ...ge 564 Query Syntax SBUS 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 535 See Also SBUS CAN COUNt RE...

Page 299: ...564 Query Syntax SBUS 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 535 See Also SBUS CAN COUN...

Page 300: ...SBUS CAN COUNt RESet Resets the frame counters Errors 241 Hardware missing on page 535 See Also SBUS CAN COUNt ERRor on page 298 SBUS CAN COUNt OVERload on page 299 SBUS CAN COUNt TOTal on page 301 SB...

Page 301: ...ge 564 Query Syntax SBUS 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 535 See Also SBUS CAN COUNt RE...

Page 302: ...e 564 Query Syntax SBUS CAN COUNt UTILization Returns the percent utilization Return Format percent NL percent floating point in NR3 format Errors 241 Hardware missing on page 535 See Also SBUS CAN CO...

Page 303: ...BUS DISPlay query returns the current display setting of the serial decode bus Return Format display NL display 0 1 Errors 241 Hardware missing on page 535 See Also Introduction to SBUS Commands on pa...

Page 304: ...uery Syntax SBUS FLEXray COUNt NULL Returns the FlexRay null frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 535 See Also SBUS FLEXray CO...

Page 305: ...nd Syntax SBUS FLEXray COUNt RESet Resets the FlexRay frame counters Errors 241 Hardware missing on page 535 See Also SBUS FLEXray COUNt NULL on page 304 SBUS FLEXray COUNt SYNC on page 306 SBUS FLEXr...

Page 306: ...uery Syntax SBUS FLEXray COUNt SYNC Returns the FlexRay sync frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 535 See Also SBUS FLEXray CO...

Page 307: ...uery Syntax SBUS FLEXray COUNt TOTal Returns the FlexRay total frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 535 See Also SBUS FLEXray...

Page 308: ...of the IIC address field of the decode bus Query Syntax SBUS IIC ASIZe The SBUS IIC ASIZe query returns the current IIC address width setting Return Format mode NL mode BIT7 BIT8 Errors 241 Hardware...

Page 309: ...the Frame Id field in the LIN decode bus Query Syntax SBUS LIN PARity The SBUS LIN PARity query returns the current LIN parity bits display setting of the serial decode bus Return Format display NL d...

Page 310: ...returns the current serial bus decode mode setting Return Format mode NL mode IIC SPI CAN LIN FLEX NONE Errors 241 Hardware missing on page 535 See Also Introduction to SBUS Commands on page 293 TRIGg...

Page 311: ...PI Query Syntax SBUS SPI WIDTh The SBUS SPI WIDTh query returns the current SPI decode word width Return Format word_width NL word_width integer 4 16 in NR1 format Errors 241 Hardware missing on page...

Page 312: ...DATE date see page 313 SYSTem DATE see page 313 date year month day year 4 digit year in NR1 format month 1 12 JANuary FEBruary MARch APRil MAY JUNe JULy AUGust SEPtember OCTober NOVember DECember day...

Page 313: ...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 the...

Page 314: ...racters 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 of...

Page 315: ...Repeatedly 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 err...

Page 316: ...Tem LOCK 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 GPIB Query Syntax SYSTem LOCK The SYSTem LOCK query r...

Page 317: ...2 format See Also Introduction to SYSTem Commands on page 312 LRN Learn Device Setup on page 85 Example Code SAVE_SYSTEM_SETUP The SYSTEM SETUP query returns a program message that contains the curre...

Page 318: ...eference 3 Commands by Subsystem Write setup string back to oscilloscope using SYSTEM SETUP command myScope WriteIEEEBlock SYSTEM SETUP varSetupString CheckForInstrumentErrors Example program from the...

Page 319: ...he 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 SYSTe...

Page 320: ...he display reference point in NR3 format TIMebase RANGe range_value see page 324 TIMebase RANGe see page 324 range_value 5 ns through 500 s in NR3 format TIMebase REFClock 0 OFF 1 ON see page 325 TIMe...

Page 321: ...s Reference 321 Use TIMebase to query setup information for the TIMebase subsystem Return Format The following is a sample response from the TIMebase query In this case the query was issued following...

Page 322: ...ilable in this mode ROLL In the ROLL mode data moves continuously across the display from left to right The oscilloscope runs continuously and is untriggered The TIMebase REFerence selection changes t...

Page 323: ...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 time fro...

Page 324: ...RANGe The TIMebase RANGe query returns the current full scale range value for the main window Return Format range_value NL range_value 5 ns through 500 s in NR3 format See Also Introduction to TIMebas...

Page 325: ...clock when synchronizing multiple instruments see ACQuire RSIGnal on page 146 The TIMebase REFClock ON command enables the 10 MHz REF BNC and sets the reference signal mode to IN The TIMebase REFCloc...

Page 326: ...e the trigger point is referenced Query Syntax TIMebase REFerence The TIMebase REFerence query returns the current display reference for the main window Return Format reference NL reference LEFT CENT...

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

Page 328: ...e 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 query...

Page 329: ...main sweep horizontal position determine the range for this command The value for this command must keep the delayed view window within the main sweep range Query Syntax TIMebase WINDow POSition The...

Page 330: ...window The range is 10 times the current delayed view window seconds per division setting The main sweep range determines the range for this command The maximum value is one half of the TIMebase RANGe...

Page 331: ...ision 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 returns th...

Page 332: ...RIGger subsystem define the conditions for an internal trigger Many of these commands are valid in multiple trigger modes The default trigger mode is EDGE The trigger subsystem controls the trigger sw...

Page 333: ...e duration IIC Inter IC bus triggering consists of connecting the oscilloscope to the serial data SDA line and the serial clock SCL line then triggering on a stop start condition a restart a missing a...

Page 334: ...nnel as the trigger source USB Universal Serial Bus triggering will trigger on a Start of Packet SOP End of Packet EOP Reset Complete Enter Suspend or Exit Suspend signal on the differential USB data...

Page 335: ...DGE GLITch PATTern CAN DURation IIC EBURst LIN SEQuence SPI TV USB FLEXray return_value mode none none query returns NONE if the TIMebase MODE is ROLL or XY TRIGger NREJect 0 OFF 1 ON see page 339 TRI...

Page 336: ...ncy 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 broadc...

Page 337: ...hen 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 With ho...

Page 338: ...s the current trigger mode If the TIMebase MODE is ROLL or XY the query returns NONE Return Format mode NL mode NONE EDGE GLIT PATT CAN DUR IIC EBUR LIN SEQ SPI TV USB FLEX See Also Introduction to TR...

Page 339: ...eject 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 is not...

Page 340: ...o set the pattern for the corresponding channel to low Set a value bit to 1 to set the pattern to high Set a mask bit to 0 to ignore the data for the corresponding channel Only channels with a 1 set o...

Page 341: ...ammer s Reference 341 Query Syntax TRIGger PATTern The TRIGger PATTern query returns the pattern value the mask and the edge of interest in the simple pattern Return Format pattern NL See Also Introdu...

Page 342: ...nt 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 the...

Page 343: ...ngth integer from 1 to 8 in NR1 format with Option AMS TRIGger CAN PATTern ID value mask see page 347 TRIGger CAN PATTern ID see page 347 value 32 bit integer in decimal nondecimal or string with Opti...

Page 344: ...or DSO models source CHANnel n DIGital0 DIGital15 for MSO models n 1 2 or 1 4 in NR1 format TRIGger CAN TRIGger condition see page 352 TRIGger CAN TRIGger see page 353 condition SOF without Option AMS...

Page 345: ...to low Set a value bit to 1 to set the bit to high Set a mask bit to 0 to ignore that bit in the data stream Only bits with a 1 set on the mask are used Query Syntax TRIGger CAN PATTern DATA The TRIGg...

Page 346: ...0 bytes to 8 bytes 64 bits The value for these bytes is set by the TRIGger CAN PATTern DATA command Query Syntax TRIGger CAN PATTern DATA LENGth The TRIGger CAN PATTern DATA LENGth query returns the c...

Page 347: ...Set a value bit to 1 to set the bit to high Set a mask bit to 0 to ignore that bit in the identifier stream Only bits with a 1 set on the mask are used Query Syntax TRIGger CAN PATTern ID The TRIGger...

Page 348: ...entifier is set by the TRIGger CAN PATTern ID command Query Syntax TRIGger CAN PATTern ID MODE The TRIGger CAN PATTern ID MODE query returns the current setting of the CAN identifier mode Return Forma...

Page 349: ...ere 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 time Q...

Page 350: ...a non standard baud rate is sent the baud rate will be set to the next highest standard rate If the baud rate you select does not match the system baud rate false triggers may occur Query Syntax TRIGg...

Page 351: ...scope models n 1 2 for the two channel oscilloscope models The TRIGger CAN SOURce command sets the source for the CAN signal The source setting is only valid when TRIGger CAN TRIGger is set to SOF sta...

Page 352: ...rigger 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 error...

Page 353: ...gger on condition Return Format condition NL condition SOF DATA ERR IDD IDE IDR ALL OVER ACK Errors 241 Hardware missing on page 535 See Also Introduction to TRIGger Commands on page 332 TRIGger MODE...

Page 354: ...e page 356 less than time floating point number from 5 ns to 10 seconds in NR3 format suffix s ms us ns ps TRIGger DURation PATTe rn value mask see page 357 TRIGger DURation PATTe rn see page 357 valu...

Page 355: ...command sets the minimum duration for the defined pattern when TRIGger DURation QUALifier is set to GREaterthan The command also sets the timeout value when the TRIGger DURation QUALifier is set to TI...

Page 356: ...ffix s ms us ns ps The TRIGger DURation LESSthan command sets the maximum duration for the defined pattern when TRIGger DURation QUALifier is set to LESSthan Query Syntax TRIGger DURation LESSthan The...

Page 357: ...rresponding channel Only channels with a 1 set on the appropriate mask bit are used Query Syntax TRIGger DURation PATTern The TRIGger DURation PATTern query returns the pattern value Return Format val...

Page 358: ...aterthan command Set the LESSthan qualifier value with the TRIGger DURation LESSthan command Set the INRange and OUTRange qualifier values with the TRIGger DURation RANGe command Set the TIMeout quali...

Page 359: ...er DURation RANGe command sets the duration for the defined pattern when the TRIGger DURation QUALifier command is set to INRange or OUTRange Query Syntax TRIGger DURation RANGe The TRIGger DURation R...

Page 360: ...digital channel is selected as the source the DIGital n THReshold or POD n THReshold command is used to set the Nth Edge Burst trigger level Table 65 TRIGger EBURst Commands Summary Command Query Opt...

Page 361: ...th edge at burst counter resource The edge counter is used in the trigger stage to determine which edge in a burst will generate a trigger Query Syntax TRIGger EBURst COUNt The TRIGger EBURst COUNt qu...

Page 362: ...sets the Nth edge in a burst idle resource in seconds from 10 ns to 10 s The timer is used to set the minimum time before the next burst Query Syntax TRIGger EBURst IDLE The TRIGger EBURst IDLE query...

Page 363: ...t SLOPe command specifies whether the rising edge POSitive or falling edge NEGative of the Nth edge in a burst will generate a trigger Query Syntax TRIGger EBURst SLOPe The TRIGger EBURst SLOPe query...

Page 364: ...external triggers level 2 volts with probe attenuation at 1 1 in NR3 format For digital channels MSO models level 8 V source CHANnel n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 EXTer...

Page 365: ...oltage 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 couplin...

Page 366: ...XTernal for the MSO models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger EDGE LEVel command sets the trigger level voltage for the active...

Page 367: ...oise 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 frequency c...

Page 368: ...e 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 AL...

Page 369: ...el that produces the trigger Query Syntax TRIGger EDGE SOURce The TRIGger EDGE SOURce query returns the current source If all channels are off the query returns NONE Return Format source NL source CHA...

Page 370: ...5 TRIGger FLEXray FRAMe ID see page 375 frame_id ALL frame frame integer from 1 2047 TRIGger FLEXray FRAMe TYPE frame_type see page 376 TRIGger FLEXray FRAMe TYPE see page 376 frame_type NORMal STARtu...

Page 371: ...ing error types are NOT valid when the BUSDoctor is in ASYNcronous mode BOUNdary triggers on only BOUNdary violations IDLE triggers only on Network IDLE time violations SYMBol triggers only on SYMBol...

Page 372: ...lent 6000 Series Oscilloscopes Programmer s Reference 3 Commands by Subsystem Errors 241 Hardware missing on page 535 See Also Introduction to TRIGger Commands on page 332 TRIGger FLEXray TRIGger on p...

Page 373: ...unt base setting is only valid when the FlexRay trigger mode is set to FRAME Query Syntax TRIGger FLEXray FRAMe CCBase The TRIGger FLEXray FRAMe CCBase query returns the current cycle count base setti...

Page 374: ...count repetition setting is only valid when the FlexRay trigger mode is set to FRAME Query Syntax TRIGger FLEXray FRAMe CCRepetition The TRIGger FLEXray FRAMe CCRepetition query returns the current c...

Page 375: ...hen the FlexRay trigger mode is set to FRAME Query Syntax TRIGger FLEXray FRAMe ID The TRIGger FLEXray FRAMe ID query returns the current frame ID setting for the FlexRay frame trigger setup Return Fo...

Page 376: ...er on only null frames SYNC will trigger on only sync frames NSTArtup will trigger on frames other than startup frames NNULl will trigger on frames other than null frames NSYNc will trigger on frames...

Page 377: ...se setting is only valid when the FlexRay trigger mode is set to TIME Query Syntax TRIGger FLEXray TIME CBASe The TRIGger FLEXray TIME CBASe query returns the current cycle base setting for the FlexRa...

Page 378: ...e repetition setting is only valid when the FlexRay trigger mode is set to TIME Query Syntax TRIGger FLEXray TIME CREPetition The TRIGger FLEXray TIME CREPetition query returns the current cycle repet...

Page 379: ...etting is only valid when the FlexRay trigger mode is set to TIME Query Syntax TRIGger FLEXray TIME SEGMent The TRIGger FLEXray TIME SEGMent query returns the current segment setting for the FlexRay t...

Page 380: ...lot setting is only valid when the FlexRay trigger mode is set to TIME Query Syntax TRIGger FLEXray TIME SLOT The TRIGger FLEXray TIME SLOT query returns the current source for the FLEXray signal Retu...

Page 381: ...RIGger query returns the current FLEXray trigger on condition Return Format condition NL condition FRAM TIME ERR Errors 241 Hardware missing on page 535 See Also Introduction to TRIGger Commands on pa...

Page 382: ...point number from 5 ns to 10 seconds in NR3 format suffix s ms us ns ps TRIGger GLITch LEVel level source see page 386 TRIGger GLITch LEVel see page 386 For internal triggers level 75 x full scale vo...

Page 383: ...rt time from 10 ns to 9 99 seconds in NR3 format less than time stop time from 15 ns to 10 seconds in NR3 format suffix s ms us ns ps TRIGger GLITch SOURce source see page 390 TRIGger GLITch SOURce se...

Page 384: ...uffix s ms us ns ps The TRIGger GLITch GREaterthan command sets the minimum pulse width duration for the selected TRIGger GLITch SOURce Query Syntax TRIGger GLITch GREaterthan The TRIGger GLITch GREat...

Page 385: ...ch 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 duration...

Page 386: ...e CHANnel n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 for MSO models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger GLIT...

Page 387: ...OSitive 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 puls...

Page 388: ...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 GLITch Q...

Page 389: ...s us ns ps The TRIGger GLITch RANGe command sets the pulse width duration for the selected TRIGger GLITch SOURce If you set the stop time before the start time the order of the parameters is automatic...

Page 390: ...cilloscope models The TRIGger GLITch SOURce command selects the channel that produces the pulse width trigger Query Syntax TRIGger GLITch SOURce The TRIGger GLITch SOURce query returns the current pul...

Page 391: ...string string 0xnn n 0 9 A F TRIGger IIC SOURce C LOCk source see page 395 TRIGger IIC SOURce C LOCk see page 395 source CHANnel n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 for MSO m...

Page 392: ...s 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 TRIGger IIC PATTern ADDRess...

Page 393: ...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 TRIGger IIC PATTern DATA The TRIGger II...

Page 394: ...and 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 TRIGger IIC PATTern DATa2 The TRIGger...

Page 395: ...ital15 for the MSO models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger IIC SOURce CLOCk command sets the source for the IIC serial clock...

Page 396: ...0 DIGital15 for the MSO models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger IIC SOURce DATA command sets the source for IIC serial data...

Page 397: ...TRIGger IIC TRIGger QUALifier command sets the IIC data qualifier when TRIGger IIC TRIGger TYPE is set to READEeprom Query Syntax TRIGger IIC TRIGger QUALifier The TRIGger IIC TRIGger QUALifier query...

Page 398: ...tart 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 Ad...

Page 399: ...illoscopes Programmer s Reference 399 TRIGger IIC PATTern ADDRess on page 392 TRIGger IIC PATTern DATA on page 393 TRIGger IIC PATTern DATa2 on page 394 TRIGger IIC TRIGger QUALifier on page 397 Long...

Page 400: ...N SAMPlepoin t see page 402 value 60 62 5 68 70 75 80 87 5 in NR3 format TRIGger LIN SIGNal BAU Drate baudrate see page 403 TRIGger LIN SIGNal BAU Drate see page 403 baudrate 2400 9600 19200 TRIGger L...

Page 401: ...fines the LIN identifier searched for in each CAN message when the LIN trigger mode is set to frame ID Query Syntax TRIGger LIN ID The TRIGger LIN ID query returns the current LIN identifier setting R...

Page 402: ...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 TRIGger LIN SAMPlep...

Page 403: ...e LIN signal at 2400 b s 9600 b s or 19200 b s If a non standard baud rate is sent the baud rate will be set to the next highest standard rate Query Syntax TRIGger LIN SIGNal BAUDrate The TRIGger LIN...

Page 404: ...odels n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger LIN SOURce command sets the source for the LIN signal Query Syntax TRIGger LIN SOURce...

Page 405: ...ANdard command sets the LIN standard in effect for triggering and decoding to be LIN1 3 or LIN2 0 Query Syntax TRIGger LIN STANdard The TRIGger LIN STANdard query returns the current LIN standard sett...

Page 406: ...ual 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 previous one Query Syntax TRIG...

Page 407: ...break or Frame Id ID Query Syntax TRIGger LIN TRIGger The TRIGger LIN TRIGger query returns the current LIN trigger value Return Format condition NL condition SYNC ID Errors 241 Hardware missing on pa...

Page 408: ...e page 411 value PATTern1 ENTered PATTern1 EXITed EDGE1 PATTern1 AND EDGE1 TRIGger SEQuence PATTe rn 1 2 value mask see page 412 TRIGger SEQuence PATTe rn 1 2 see page 412 value integer or string mask...

Page 409: ...counter resource The edge counter is used in the trigger stage to determine the number of edges that must be found before the sequencer generates a trigger Query Syntax TRIGger SEQuence COUNt The TRIG...

Page 410: ...defines the specified sequencer edge resource according to the specified source and slope To disable an edge resource set its source to NONE In this case slope has no meaning Query Syntax TRIGger SEQ...

Page 411: ...example EDGE1 NONE NONE PATTern1 is specified with the TRIGger SEQuence PATTern command EDGE1 is specified with the TRIGger SEQuence EDGE command Query Syntax TRIGger SEQuence FIND The TRIGger SEQuenc...

Page 412: ...l Only channels with a 1 set on the appropriate mask bit are used Query Syntax TRIGger SEQuence PATTern 1 2 The TRIGger SEQuence PATTern n query returns the current settings of the specified pattern r...

Page 413: ...gram data parameters you can use NONE to fill out the parameter list for example EDGE1 NONE NONE PATTern1 and PATTern2 are specified with the TRIGger SEQuence PATTern command EDGE1 and EDGE2 are speci...

Page 414: ...d sets the sequencer timer resource in seconds from 100 ns to 10 s The timer is used in the reset stage to determine how long to wait for the trigger to occur before restarting Query Syntax TRIGger SE...

Page 415: ...r example EDGE2 NONE NONE PATTern2 is specified with the TRIGger SEQuence PATTern command EDGE2 is specified with the TRIGger SEQuence EDGE command COUNt is specified with the TRIGger SEQuence COUNt c...

Page 416: ...integer or string mask integer or string string 0xnnnnnn where n 0 9 A F TRIGger SPI PATTern WI DTh width see page 421 TRIGger SPI PATTern WI DTh see page 421 width integer from 4 to 32 in NR1 format...

Page 417: ...OCk SLOPe command specifies the rising edge POSitive or falling edge NEGative of the SPI clock source that will clock in the data Query Syntax TRIGger SPI CLOCk SLOPe The TRIGger SPI CLOCk SLOPe query...

Page 418: ...ource in seconds from 500 ns to 10 s when the TRIGger SPI FRAMing command is set to TIMeout The timer is used to frame a signal by a clock timeout Query Syntax TRIGger SPI CLOCk TIMeout The TRIGger SP...

Page 419: ...the SPI trigger framing value If TIMeout is selected the timeout value is set by the TRIGger SPI CLOCk TIMeout command Query Syntax TRIGger SPI FRAMing The TRIGger SPI FRAMing query returns the curren...

Page 420: ...data width control the data pattern searched for in the data stream Set a value bit to 0 to set the corresponding bit in the data pattern to low Set a value bit to 1 to set the bit to high Set a mask...

Page 421: ...Gger SPI PATTern WIDTh command sets the width of the SPI data pattern anywhere from 4 bits to 32 bits Query Syntax TRIGger SPI PATTern WIDTh The TRIGger SPI PATTern WIDTh query returns the current SPI...

Page 422: ...nel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger SPI SOURce CLOCk command sets the source for the SPI serial clock Query Syntax TRIGger SPI SOURce CLOCk The TRIGger SP...

Page 423: ...nel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger SPI SOURce DATA command sets the source for the SPI serial data Query Syntax TRIGger SPI SOURce DATA The TRIGger SPI S...

Page 424: ...oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger SPI SOURce FRAMe command sets the frame source when TRIGger SPI FRAMing is set to CHIPselect or NOTChipselect Query Syntax...

Page 425: ...TV MODE see page 427 tv mode FIEld1 FIEld2 AFIelds ALINes LINE VERTical LFIeld1 LFIeld2 LALTernate LVERtical TRIGger TV POLarity polarity see page 428 TRIGger TV POLarity see page 428 polarity POSiti...

Page 426: ...s the current TV trigger line number setting Return Format line_number NL line_number integer in NR1 format See Also Introduction to TRIGger Commands on page 332 TRIGger TV STANdard on page 430 TRIGge...

Page 427: ...is GENeric The LALTernate parameter is not available when TRIGger TV STANdard is GENeric Old forms for mode are accepted Query Syntax TRIGger TV MODE The TRIGger TV MODE query returns the TV trigger m...

Page 428: ...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 polarity...

Page 429: ...models n 1 2 for the two channel oscilloscope models The TRIGger TV SOURce command selects the channel used to produce the trigger Query Syntax TRIGger TV SOURce The TRIGger TV SOURce query returns t...

Page 430: ...L60HZ P480 P720L60HZ P720 P1080L24HZ P1080 P1080L25HZ I1080L50HZ I1080 I1080L60HZ The TRIGger TV STANdard command selects the video standard GENeric mode is non interlaced Query Syntax TRIGger TV STAN...

Page 431: ...DSO models source CHANnel n DIGital0 DIGital15 for the MSO models n 1 2 or 1 4 in NR1 format TRIGger USB SOURce DPL us source see page 433 TRIGger USB SOURce DPL us see page 433 source CHANnel n EXTer...

Page 432: ...ls n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger USB SOURce DMINus command sets the source for the USB D signal Query Syntax TRIGger USB...

Page 433: ...ls n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger USB SOURce DPLus command sets the source for the USB D signal Query Syntax TRIGger USB S...

Page 434: ...sets the expected USB signal speed to be Low Speed 1 5 Mb s or Full Speed 12 Mb s Query Syntax TRIGger USB SPEed The TRIGger USB SPEed query returns the current speed value for the USB signal Return F...

Page 435: ...ets where the USB trigger will occur SOP Start of packet EOP End of packet ENTersuspend Enter suspend state EXITsuspend Exit suspend state RESet Reset complete Query Syntax TRIGger USB TRIGger The TRI...

Page 436: ...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 is the number of bytes to be transmitted 1000 bytes o...

Page 437: ...n MATH SBUS for DSO models source CHANnel n POD 1 2 BUS 1 2 FUNCtion MATH SBUS for MSO models n 1 2 or 1 4 in NR1 format n a WAVeform TYPE see page 460 return_mode NORM PEAK AVER HRES WAVeform UNSigne...

Page 438: ...are three types of waveform acquisitions that can be selected for analog channels with the ACQuire TYPE command see page 148 NORMal AVERage PEAK and HRESolution Digital channels are always acquired us...

Page 439: ...OINts 100 returns time buckets 0 10 20 30 40 990 Analog Channel Data NORMal Data Normal data consists of the last data point hit in each time bucket This data is transmitted over GPIB in a linear fash...

Page 440: ...ues corresponds to the time bucket at the leftmost side of the screen The last pair of values corresponds to the time bucket at the far right side of the screen In ACQuire TYPE PEAK mode see page 148...

Page 441: ...ASCII character string 8 DD D is sent prior to sending the actual data The 8 indicates how many Ds follow The Ds are ASCII numbers that indicate how many data bytes follow For example if 1000 points...

Page 442: ...rmat see WAVeform FORMat on page 448 allows 8 bit access to the waveform data If the data intrinsically has more than 8 bits of resolution averaged data the data is right shifted truncated to fit into...

Page 443: ...bit value in the pod data byte is not defined Digital Channel BUS Data Format Digital channel BUS definitions can include any or all of the digital channels Therefore data is always returned as 16 bi...

Page 444: ...parameter 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 LSBFirst Qu...

Page 445: ...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 Return For...

Page 446: ...can be zeros in the data incorrectly is when programming over telnet port 5024 Port 5024 provides a command prompt and is intended for ASCII transfers Use telnet port 5025 instead 0x01 or 0x0001 Clipp...

Page 447: ...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...

Page 448: ...Veform 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 transfe...

Page 449: ...can only be transferred when the oscilloscope is not running and can only be retrieved from the analog or digital sources The second is referred to as the measurement record and is a 1000 point maxim...

Page 450: ...ode is MAXimum or RAW See Also Introduction to WAVeform Commands on page 438 ACQuire POINts on page 145 WAVeform DATA on page 446 WAVeform SOURce on page 456 WAVeform VIEW on page 462 WAVeform PREambl...

Page 451: ...loscope is running this data record is unavailable If the points_mode is MAXimum whichever record contains the maximum amount of points is used Usually this is the raw acquisition record But if the ra...

Page 452: ...ts mode will 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 438 ACQuire POINts...

Page 453: ...L preamble_block format 16 bit NR1 type 16 bit NR1 points 32 bit NR1 count 32 bit NR1 xincrement 64 bit floating point NR3 xorigin 64 bit floating point NR3 xreference 32 bit NR1 yincrement 32 bit flo...

Page 454: ...e 460 WAVeform XINCrement on page 463 WAVeform XORigin on page 464 WAVeform XREFerence on page 465 WAVeform YINCrement on page 466 WAVeform YORigin on page 467 WAVeform YREFerence on page 468 Example...

Page 455: ...int where y origin occurs Dim Preamble 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...

Page 456: ...me differences between POD and BUS when formatting and getting data from the oscilloscope When POD1 or POD2 is selected as the waveform source you can choose the BYTE WORD or ASCii formats see WAVefor...

Page 457: ...for the waveform commands myScope WriteString WAVEFORM SOURCE CHAN1 WAVE_POINTS Specifies the number of points to be transferred using the WAVEFORM DATA query myScope WriteString WAVEFORM POINTS 1000...

Page 458: ...lngCount Preamble 3 dblXIncrement Preamble 4 dblXOrigin Preamble 5 lngXReference Preamble 6 sngYIncrement Preamble 7 sngYOrigin Preamble 8 lngYReference Preamble 9 strOutput strOutput strOutput Forma...

Page 459: ...veform data block The size can vary depending on the number of points acquired for the waveform You can then read that number of bytes from the oscilloscope and the terminating NL character Dim lngI A...

Page 460: ...e 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 Commands on p...

Page 461: ...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...

Page 462: ...ommand 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 the...

Page 463: ...t 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 the cu...

Page 464: ...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 NL va...

Page 465: ...tly 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 alway...

Page 466: ...nt 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 value...

Page 467: ...ed 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 value...

Page 468: ...ied 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 Return Fo...

Page 469: ...74 F 475 G 476 H 476 I 476 L 477 M 477 N 479 O 479 P 480 Q 481 R 481 S 482 T 484 U 488 V 489 W 489 X 490 Y 490 A AALias ACQuire AALias on page 140 ACKNowledge TRIGger CAN ACKNowledge on page 528 ACQui...

Page 470: ...page 107 AUToscale CHANnels on page 108 B BAUDrate Commands SBUS BUSDoctor BAUDrate on page 295 TRIGger CAN SIGNal BAUDrate on page 350 TRIGger LIN SIGNal BAUDrate on page 403 BIT m BUS n BIT m on pag...

Page 471: ...er CAN Commands on page 343 CBASe TRIGger FLEXray TIME CBASe on page 377 CCBASe TRIGger FLEXray FRAMe CCBase on page 373 CCRepetition TRIGger FLEXray FRAMe CCRepetition on page 374 CRepetition TRIGger...

Page 472: ...n page 395 TRIGger SPI CLOCk SLOPe on page 417 TRIGger SPI CLOCk TIMeout on page 418 TRIGger SPI SOURce CLOCk on page 422 CLS Clear Status on page 79 COMPlete ACQuire COMPlete on page 141 CONNect DISP...

Page 473: ...420 TRIGger SPI SOURce DATA on page 423 WAVeform DATA on page 446 DATE Commands CALibrate DATE on page 160 SYSTem DATE on page 313 DEFine MEASure DEFine on page 252 DEFinition Commands TRIGger CAN SI...

Page 474: ...ger USB SOURce DPLus on page 433 DSP SYSTem DSP on page 314 DURation TRIGger DURation Commands on page 354 DUTYcycle MEASure DUTYcycle on page 257 E EBURst TRIGger EBURst Commands on page 360 EDGE TRI...

Page 475: ...ge 373 TRIGger FLEXray FRAMe CCRepetition on page 374 TRIGger FLEXray FRAMe ID on page 375 TRIGger FLEXray FRAMe TYPE on page 376 TRIGger FLEXray TIME CBASe on page 377 TRIGger FLEXray TIME CREPetitio...

Page 476: ...terthan on page 355 TRIGger GLITch GREaterthan on page 384 H HARDcopy DESTination on page 508 HARDcopy DEVice on page 509 HARDcopy FACTors on page 225 HARDcopy FFEed on page 226 HARDcopy FILename on p...

Page 477: ...e 198 LABList DISPlay LABList on page 199 LENGth TRIGger CAN PATTern DATA LENGth on page 346 LESSthan Commands TRIGger DURation LESSthan on page 356 TRIGger GLITch LESSthan on page 385 LEVel Commands...

Page 478: ...IDth on page 260 MEASure OVERshoot on page 261 MEASure PERiod on page 263 MEASure PHASe on page 264 MEASure PREShoot on page 265 MEASure PWIDth on page 266 MEASure RISetime on page 267 MEASure SCRatch...

Page 479: ...e 234 SBUS BUSDoctor MODE on page 297 SBUS MODE on page 310 TIMebase MODE on page 322 TRIGger CAN PATTern ID MODE on page 348 TRIGger MODE on page 338 TRIGger TV MODE on page 427 WAVeform POINts MODE...

Page 480: ...on page 347 TRIGger CAN PATTern ID MODE on page 348 TRIGger DURation PATTern on page 357 TRIGger PATTern on page 340 TRIGger SEQuence PATTern on page 412 TRIGger SPI PATTern DATA on page 420 TRIGger S...

Page 481: ...mands on page 382 PWIDth MEASure PWIDth on page 266 Q QUALifier Commands TRIGger DURation QUALifier on page 358 TRIGger GLITch QUALifier on page 388 TRIGger IIC TRIGger QUALifier on page 397 R RANGe C...

Page 482: ...age 297 SBUS CAN COUNt ERRor on page 298 SBUS CAN COUNt OVERload on page 299 SBUS CAN COUNt RESet on page 300 SBUS CAN COUNt TOTal on page 301 SBUS CAN COUNt UTILization on page 302 SBUS DISPlay on pa...

Page 483: ...ZE on page 191 POD n SIZE on page 289 SKEW CHANnel n PROBe SKEW on page 179 SLOPe Commands TRIGger EBURst SLOPe on page 363 TRIGger EDGE SLOPe on page 368 TRIGger SPI CLOCk SLOPe on page 417 SOURce Co...

Page 484: ...95 STOP on page 135 SWEep TRIGger SWEep on page 342 SWITch CALibrate SWITch on page 164 SYNC SBUS FLEXray COUNt SYNC on page 306 SYSTem DATE on page 313 SYSTem DSP on page 314 SYSTem ERRor on page 31...

Page 485: ...RNier on page 328 TIMebase WINDow POSition on page 329 TIMebase WINDow RANGe on page 330 TIMebase WINDow SCALe on page 331 TIMeout TRIGger SPI CLOCk TIMeout on page 418 TIMer TRIGger SEQuence TIMer on...

Page 486: ...Gger on page 352 TRIGger DURation GREaterthan on page 355 TRIGger DURation LESSthan on page 356 TRIGger DURation PATTern on page 357 TRIGger DURation QUALifier on page 358 TRIGger DURation RANGe on pa...

Page 487: ...DATA on page 396 TRIGger IIC TRIGger QUALifier on page 397 TRIGger IIC TRIGger TYPE on page 398 TRIGger LIN SIGNal BAUDrate on page 403 TRIGger LIN SIGNal DEFinition on page 530 TRIGger LIN SOURce on...

Page 488: ...Lus on page 433 TRIGger USB SPEed on page 434 TRIGger USB TRIGger on page 435 TST Self Test on page 98 TSTArt MEASure TSTArt on page 517 TSTOp MEASure TSTOp on page 518 TV TRIGger TV Commands on page...

Page 489: ...STOp MEASure VSTOp on page 524 VTIMe MEASure VTIMe on page 283 VTOP MEASure VTOP on page 284 W WAI Wait To Continue on page 99 WAVeform BYTeorder on page 444 WAVeform COUNt on page 445 WAVeform DATA o...

Page 490: ...MARKer X2Y2source on page 238 XDELta MARKer XDELta on page 239 XINCrement WAVeform XINCrement on page 463 XMAX MEASure XMAX on page 285 XMIN MEASure XMIN on page 286 XORigin WAVeform XORigin on page 4...

Page 491: ...ALog n INVert CHANnel n INVert see page 174 ANALog n LABel CHANnel n LABel see page 175 ANALog n OFFSet CHANnel n OFFSet see page 176 ANALog n PROBe CHANnel n PROBe see page 177 ANALog n PMODe none AN...

Page 492: ...ee page 227 HARDcopy DEVice see page 509 HARDcopy FORMat see page 228 PLOTter THINkjet not supported TIF BMP CSV SEIko added HARDcopy GRAYscale see page 510 HARDcopy PALette see page 230 MEASure LOWer...

Page 493: ...values or percentage MEASure VDELta see page 522 MARKer YDELta see page 242 MEASure VSTArt see page 523 MARKer Y1Position see page 240 MEASure VSTOp see page 524 MARKer Y2Position see page 241 PRINt s...

Page 494: ...tatus of TRIPed or NORMal DISPlay INVerse none DISPlay COLumn none DISPlay GRID none DISPLay LINE none DISPlay PIXel none DISPlay POSition none DISPlay ROW none DISPlay TEXT none FUNCtion MOVE none FU...

Page 495: ...6000 Series Oscilloscopes Programmer s Reference 495 Discontinued Parameters Some previous oscilloscope queries returned control setting values of OFF and ON The 6000 Series oscilloscopes only return...

Page 496: ...ges 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 specified...

Page 497: ...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 returns the label associated with a particul...

Page 498: ...ined 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 the voltage and thresho...

Page 499: ...og 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 channel Re...

Page 500: ...Nnel n INPut command selects 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...

Page 501: ...and cannot be set If a probe 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...

Page 502: ...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 current...

Page 503: ...string See Also DIGital n POSition on page 190 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 cha...

Page 504: ...e 5 Obsolete and Discontinued Commands ERASe see page 564 Command Syntax ERASe The ERASe command erases the screen NOTE The ERASe command is an obsolete command provided for compatibility to previous...

Page 505: ...are ONEMeg 1 M and FIFTy 50 Query Syntax EXTernal INPut The EXTernal INPut query returns the current input impedance setting for the external trigger Return Format impedance value NL impedance value...

Page 506: ...cted 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 error...

Page 507: ...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 FUNCtion VIEW...

Page 508: ...d sets the hardcopy destination Query Syntax HARDcopy DESTination The HARDcopy DESTination query returns the selected hardcopy destination Return Format destination NL destination CENT FLOP See Also I...

Page 509: ...y DEVice command sets the hardcopy device type Query Syntax HARDcopy DEVice The HARDcopy DEVice query returns the selected hardcopy device type Return Format device NL device TIFF GIF BMP LAS EPS DESK...

Page 510: ...GRAYscale The HARDcopy GRAYscale query returns a flag indicating whether grayscaling is performed in the hardcopy dump Return Format gray NL gray 0 1 See Also Introduction to HARDcopy Commands on pag...

Page 511: ...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 voltag...

Page 512: ...SCRatch see page 564 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 provide...

Page 513: ...ery 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 differenc...

Page 514: ...n 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 the upper...

Page 515: ...rrent source is modified Query Syntax MEASure TMAX source The MEASure TMAX query returns the horizontal axis value at which the maximum vertical value occurs on the current source If the optional sour...

Page 516: ...rrent source is modified Query Syntax MEASure TMIN source The MEASure TMIN query returns the horizontal axis value at which the minimum vertical value occurs on the current source If the optional sour...

Page 517: ...t the start marker in NR3 format See Also Introduction to MARKer Commands on page 233 Introduction to MEASure Commands on page 248 MARKer X1Position on page 235 MARKer X2Position on page 237 MARKer XD...

Page 518: ...he stop marker in NR3 format See Also Introduction to MARKer Commands on page 233 Introduction to MEASure Commands on page 248 MARKer X1Position on page 235 MARKer X2Position on page 237 MARKer XDELta...

Page 519: ...he 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 the slope i...

Page 520: ...520 Agilent 6000 Series Oscilloscopes Programmer s Reference 5 Obsolete and Discontinued Commands value time in seconds of the specified voltage crossing in NR3 format...

Page 521: ...en 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 NL va...

Page 522: ...turned 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 See Also...

Page 523: ...oltage marker 1 in NR3 format See Also Introduction to MARKer Commands on page 233 Introduction to MEASure Commands on page 248 MARKer Y1Position on page 240 MARKer Y2Position on page 241 MARKer YDELt...

Page 524: ...cursor in NR3 format See Also Introduction to MARKer Commands on page 233 Introduction to MEASure Commands on page 248 MARKer Y1Position on page 240 MARKer Y2Position on page 241 MARKer YDELta on pag...

Page 525: ...6 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 destinati...

Page 526: ...e Also Introduction to Root Commands on page 102 Introduction to HARDcopy Commands on page 224 HARDcopy FORMat on page 228 HARDcopy FACTors on page 225 HARDcopy GRAYscale on page 510 DISPlay DATA on p...

Page 527: ...ce point is set with the TIMebase REFerence command see page 326 Query Syntax TIMebase DELay The TIMebase DELay query returns the current delay value Return Format delay_value NL delay_value time from...

Page 528: ...ith the N2758A CAN trigger module for 54620 54640 Series mixed signal oscilloscopes The 6000 Series oscilloscopes do not support the N2758A CAN trigger module Query Syntax TRIGger CAN ACKNowledge The...

Page 529: ...rential bus signal RX the Receive signal from the CAN bus transceiver TX the Transmit signal to the CAN bus transceiver DIFFerential the CAN differential bus signal connected to an analog source chann...

Page 530: ...end bus signal line RX the Receive signal from the LIN bus transceiver TX the Transmit signal to the LIN bus transceiver Query Syntax TRIGger LIN SIGNal DEFinition The TRIGger LIN SIGNal DEFinition q...

Page 531: ...ined 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 threshold text for analog cha...

Page 532: ...parameter is not available when TRIGger TV STANdard is GENeric see page 430 Old forms for mode are accepted Query Syntax TRIGger TV TVMode The TRIGger TV TVMode query returns the TV trigger mode Retur...

Page 533: ...ce 6 Error Messages 440 Query UNTERMINATED after indefinite response 430 Query DEADLOCKED 420 Query UNTERMINATED 410 Query INTERRUPTED 400 Query error 340 Calibration failed 330 Self test failed 321 O...

Page 534: ...ry 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 Illegal macr...

Page 535: ...when a feature is unavailable or unlicensed For example serial bus decode commands which require a four channel oscilloscope are unavailable on two channel oscilloscopes and some serial bus decode com...

Page 536: ...a out of range 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 expres...

Page 537: ...ata 150 String data 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 Inval...

Page 538: ...112 Program mnemonic too long 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...

Page 539: ...scopes Programmer s Reference 539 103 Write Error 104 Illegal Operation 105 Print Canceled 106 Print Initialization Failed 107 Invalid Trace File 108 Compression Error 109 No Data For Operation 112 Un...

Page 540: ...540 Agilent 6000 Series Oscilloscopes Programmer s Reference 6 Error Messages...

Page 541: ...on Register HWERegister CONDition 559 Clearing Registers and Queues 560 Status Reporting Decision Chart 561 IEEE 488 2 defines data structures commands and common bit definitions for status reporting...

Page 542: ...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...

Page 543: ...6000 Series Oscilloscopes Programmer s Reference 543 Status Reporting Data Structures The following figure shows how the status register bits are masked and logically OR ed to generate service request...

Page 544: ...V WH 5HJLVWHU 2XWSXW 4XHXH 654 65 6WDQGDUG YHQW 6WDWXV 5HJLVWHU 6 6 6WDQGDUG YHQW 6WDWXV QDEOH 0DVN 5HJLVWHU 321 854 4 54 23 0 29 5 865 06 25 25 25 6HUYLFH 5HTXHVW 25 29 5 2YHUORDG YHQW 5HJLVWHU 29 29...

Page 545: ...isters picture above shows how the different status reporting data structures work together To make it possible for any of the Standard Event Status Register bits to generate a summary bit the bits mu...

Page 546: ...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 returned is the total...

Page 547: ...d 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 Status Byt...

Page 548: ...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 SRE CS...

Page 549: ...vent 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 must be c...

Page 550: ...y 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 in the S...

Page 551: ...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 messages sen...

Page 552: ...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 Status Regi...

Page 553: ...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 Status...

Page 554: ...carded 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 Executin...

Page 555: ...m a stop state to a single or running state The WAIT TRIG bit is set by the Trigger Armed Event Register and indicates that the trigger is armed The OVLR bit is set whenever a 50 input overload occurs...

Page 556: ...VLR bit bit 11 and the HWE bit bit 12 The OPERegister CONDition query returns the value of the Operation Status Condition Register The HWE bit bit 12 comes from the Hardware Event Registers The RUN bi...

Page 557: ...nstrument 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 triggers t...

Page 558: ...s Oscilloscopes Programmer s Reference 7 Status Reporting Hardware Event Event Register HWERegister EVENt This register hosts the Bat On bit bit 0 The Bat On bit is set whenever the instrument is oper...

Page 559: ...NDition This register hosts the Bat On bit bit 0 and the PLL LOCKED bit bit 12 The HWERegister CONDition query returns the value of the Hardware Event Condition Register The PLL LOCKED bit bit 12 is f...

Page 560: ...r s Reference 7 Status Reporting Clearing Registers and Queues The CLS common command clears all event registers and all queues except the output queue If CLS is sent immediately after a program messa...

Page 561: ...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 KHQ DQ...

Page 562: ...562 Agilent 6000 Series Oscilloscopes Programmer s Reference 7 Status Reporting...

Page 563: ...6000 Series Oscilloscopes Programmer s Reference 8 More About Oscilloscope Commands Command Classifications 564 Valid Command Query Strings 565 Query Return Values 582 All Oscilloscope Commands Are S...

Page 564: ...n Core Commands Non core commands are commands that provide specific features but are not universal across all oscilloscope models Non core commands may be modified or deleted in the future With a com...

Page 565: ...parts of a typical program statement Instructions both commands and queries normally appear as a string embedded in a statement of your host language such as Visual Basic or C C The only time a param...

Page 566: ...ite space White space is defined as one or more space characters ASCII defines a space to be character 32 in decimal Program Data Program data are used to clarify the meaning of the command or query T...

Page 567: ...s contain a single mnemonic AUToscale and DIGitize are examples of simple command headers typically used in the oscilloscope The syntax is program mnemonic terminator Simple command headers must occur...

Page 568: ...ypes of program data are used in commands character and numeric Character Program Data Character program data is used to convey parameter information as alpha or alphanumeric strings For example the T...

Page 569: ...ng Command Tree The command tree shows all of the commands and the relationships of the commands to each other The IEEE 488 2 common commands are not listed as part of the command tree because they do...

Page 570: ...see page 110 CHANnel n see page 167 BWLimit see page 170 COUPling see page 171 DISPlay see page 172 IMPedance see page 173 INVert see page 174 LABel see page 175 OFFSet see page 176 PROBe see page 177...

Page 571: ...dance see page 205 PROBe see page 206 ID see page 207 STYPe see page 208 PROTection see page 209 RANGe see page 210 UNITs see page 211 FUNCtion see page 212 CENTer see page 214 DISPlay see page 215 OF...

Page 572: ...ee page 236 X2Position see page 237 X2Y2source see page 238 XDELta see page 239 Y1Position see page 240 Y2Position see page 241 YDELta see page 242 MEASure see page 243 CLEar see page 250 COUNter see...

Page 573: ...able Register see page 120 OPERegister CONDition Operation Status Condition Register see page 122 EVENt Operation Status Event Register see page 124 OVLenable Overload Event Enable Register see page 1...

Page 574: ...ee page 309 MODE see page 310 SPI ASIZe see page 308 SERial see page 132 SINGle see page 133 STATus see page 134 STOP see page 135 SYSTem see page 312 DATE see page 313 DSP see page 314 ERRor see page...

Page 575: ...SWEep see page 342 CAN see page 343 ACKNowledge see page 528 PATTern DATA see page 345 LENGth see page 346 ID see page 347 MODE see page 348 SAMPlepoint see page 349 SIGNal BAUDrate see page 350 DEFi...

Page 576: ...Repetition see page 374 ID see page 375 TYPE see page 376 TIME CBASe see page 377 CREPetition see page 378 SEGMent see page 379 SLOT see page 380 TRIGger see page 381 GLITch see page 382 GREaterthan s...

Page 577: ...03 DEFinition see page 530 SOURce see page 404 STANdard see page 405 SYNCbreak see page 406 TRIGger see page 407 MODE see page 338 NREJect see page 339 PATTern see page 340 SEQuence see page 408 COUNt...

Page 578: ...de see page 532 USB see page 431 SOURce DMINus see page 432 DPLus see page 433 SPEed see page 434 TRIGger see page 435 VIEW see page 137 WAVeform see page 436 BYTeorder see page 444 COUNt see page 445...

Page 579: ...emonic RANGe may be used to change the vertical range or to change the horizontal range CHANnel1 RANGe 4 Sets the vertical range of channel 1 to 0 4 volts full scale TIMebase RANGe 1 Sets the horizont...

Page 580: ...em separate the functions with a semicolon subsystem function separator data function separator data ter minator For example myScope WriteString TIMebase RANGe 0 5 POSition 0 Example 2 Program Message...

Page 581: ...lon enables you to enter a new subsystem For example program mnemonic data program mnemonic data terminator For example myScope WriteString TIMebase REFerence CENTer DISPlay VECTors ON Multiple comman...

Page 582: ...he 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 Basic the...

Page 583: ...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 Comma...

Page 584: ...584 Agilent 6000 Series Oscilloscopes Programmer s Reference 8 More About Oscilloscope Commands...

Page 585: ...rence 9 Programming Examples SICL Example in C 586 VISA Example in C 595 VISA Example in Visual Basic 604 VISA COM Example in Visual Basic 614 Example programs are ASCII text files that can be cut fro...

Page 586: ...oid initialize void Initialize the oscilloscope void extra void Miscellaneous commands not executed shown for reference purposes void capture void Digitize data from oscilloscope void analyze void Mak...

Page 587: ...tra function capture analyze Close the device session to the instrument iclose id printf Program execution is complete n For WIN16 programs call _siclcleanup before exiting to release resources alloca...

Page 588: ...ts the full scale horizontal time in seconds The range value is ten times the time per division iprintf id TIM RANG 2e 3 n TIME_REFERENCE Possible values are LEFT and CENTER LEFT sets the display refe...

Page 589: ...AIN n capture This function prepares the scope for data acquisition and then uses the DIGITIZE MACRO to capture some data void capture void AQUIRE_TYPE Sets the acquisition mode There are three acquis...

Page 590: ...d from preamble data int i Loop counter Array for setup string unsigned char setup_string SETUP_STR_SIZE int setup_size FILE fp unsigned char image_data IMG_SIZE Array for image data int img_size SAVE...

Page 591: ...ite image_data sizeof unsigned char img_size fp fclose fp printf Wrote image data d bytes to file n img_size itimeout id 5000 MEASURE The commands in the MEASURE subsystem are used to make measurement...

Page 592: ...reamble information you can then use the WAVEFORM DATA query and read the data block in the correct format WAVE_FORMAT Sets the data transmission mode for waveform data output This command controls ho...

Page 593: ...the controller over the interface that is stored in a buffer previously specified with the WAVEFORM SOURCE command iprintf id WAVEFORM DATA n Query waveform data READ_WAVE_DATA The wave data consists...

Page 594: ...at wb Write preamble fwrite preamble sizeof preamble 0 10 fp Write actually waveform data fwrite waveform_data sizeof waveform_data 0 int preamble 2 fp fclose fp retrieve_waveform This function retrie...

Page 595: ...00 define SETUP_STR_SIZE 3000 define IMG_SIZE 300000 Function prototypes void initialize void Initialize the oscilloscope void extra void Miscellaneous commands not executed shown for reference purpos...

Page 596: ...void RESET This command puts the oscilloscope in a known state Without this command the oscilloscope settings are unknown This command is very important for program control Many of the following init...

Page 597: ...l can be selected viPrintf vi TRIGGER TV SOURCE CHANNEL1 n TRIGGER_MODE Set the trigger mode to EDGE GLITch PATTern CAN DURation IIC LIN SEQuence SPI TV or USB viPrintf vi TRIGGER MODE EDGE n TRIGGER_...

Page 598: ...re the waveform data for transfer over the interface Sending this command causes an acquisition to take place with the resulting data being placed in the buffer NOTE The use of the DIGITIZE command is...

Page 599: ...pe config setup dat wb setup_size fwrite setup_string sizeof unsigned char setup_size fp fclose fp printf Wrote setup string d bytes to file n setup_size RESTORE_SYSTEM_SETUP Uploads a previously save...

Page 600: ...ak to peak voltage is 2f V n vpp WAVEFORM_DATA Get waveform data from oscilloscope get_waveform Make some calculations from the preamble data vdiv 32 preamble 7 off preamble 8 sdiv preamble 2 preamble...

Page 601: ...POINTS query This can be set to any binary fraction of the total time points available viPrintf vi WAVEFORM POINTS 1000 n GET_PREAMBLE The preamble contains all of the current WAVEFORM settings retur...

Page 602: ...ay 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 which can be s...

Page 603: ...ata 0 int preamble 2 fp fclose fp retrieve_waveform This function retrieves previously saved waveform data from a file called wave dat void retrieve_waveform void FILE fp fp fopen c scope data wave da...

Page 604: ...As Byte Public paramsArray 2 As Long Declare fixed length string variable to hold string value returned by viVScanf viVQueryf Public strQueryResult As String 200 MAIN PROGRAM This example shows the fu...

Page 605: ...t can be analyzed There are many parts of a waveform to analyze This example shows some of the possible ways to analyze various parts of a waveform Analyze Close the vi session and the resource manage...

Page 606: ...full scale vertical range in volts The range value is 8 times the volts per division Set the vertical range to 8 volts err viVPrintf vi CHANNEL1 RANGE 8 vbLf 0 TIME_RANGE Sets the full scale horizonta...

Page 607: ...1 vbLf 0 TIMEBASE_MODE not executed in this example Set the time base mode to MAIN DELAYED XY or ROLL Set time base mode to main err viVPrintf vi TIMEBASE MODE MAIN vbLf 0 End Sub Capture We will capt...

Page 608: ...internal hardware to be reconfigured If a measurement is immediately requested there may have not been enough time for the data acquisition process to collect data and the results may not be accurate...

Page 609: ...ists If Len Dir strPath Then Kill strPath End If Close 1 If 1 is open close it Open file for output Open strPath For Binary Access Write Lock Write As 1 For lngI 0 To retCount 1 Put 1 byteArray lngI W...

Page 610: ...sgBox Maximum voltage vbCrLf _ FormatNumber dblQueryResult 4 V WAVEFORM_DATA To obtain waveform data you must specify the WAVEFORM parameters for the waveform data prior to sending the WAVEFORM DATA q...

Page 611: ...ong 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 Dim strOutput As...

Page 612: ...0 READ_WAVE_DATA The wave data consists of two parts the header and the actual waveform data followed by a new line NL character The query data has the following format header waveform_data NL Where h...

Page 613: ...E TEDGE 1 CHAN1 vbLf 0 Read time at edge 1 on ch 1 err viVScanf vi lf VarPtr dblChan1Edge1 Query time at 1st rising edge on ch2 err viVPrintf vi MEASURE TEDGE 1 CHAN2 vbLf 0 Read time at edge 1 on ch...

Page 614: ...m Both forms are acceptable The input signal is the probe compensation signal from the front panel of the oscilloscope connected to channel 1 If you are using a different signal or different channels...

Page 615: ...pe There are also some additional initialization commands which are not used but shown for reference Private Sub Initialize On Error GoTo VisaComError Clear the interface myScope IO Clear RESET This c...

Page 616: ...GE GLITch PATTern CAN DURation IIC LIN SEQuence SPI TV or USB Set the trigger mode to EDGE myScope WriteString TRIGGER MODE EDGE TRIGGER_EDGE_SLOPE Sets the slope of the edge for the trigger Set the s...

Page 617: ...mpletion criteria may never be met The number of points gathered in Single mode is related to the sweep speed memory depth and maximum sample rate For example take an oscilloscope with a 1000 point me...

Page 618: ...EEBlock BinaryType_UI1 CheckForInstrumentErrors After reading query results Output setup string to a file Dim strPath As String strPath c scope config setup dat Close 1 If 1 is open close it Open file...

Page 619: ...varQueryResult myScope ReadNumber Read duty cycle MsgBox Duty cycle vbCrLf _ FormatNumber varQueryResult 3 Query for risetime myScope WriteString MEASURE RISETIME varQueryResult myScope ReadNumber Re...

Page 620: ...POINTS int32 number of data points transferred COUNT int32 1 and is always 1 XINCREMENT float64 time difference between data points XORIGIN float64 always the first data point in memory XREFERENCE in...

Page 621: ...gYIncrement 8 _ V vbCrLf strOutput strOutput Offset _ FormatNumber sngYOrigin V vbCrLf strOutput strOutput Sec Div _ FormatNumber lngPoints dblXIncrement 10 _ 1000000 us vbCrLf strOutput strOutput Del...

Page 622: ...1 As Double Dim dblChan2Edge1 As Double Dim dblChan1Edge2 As Double Dim dblDelay As Double Dim dblPeriod As Double Dim dblPhase As Double Query time at 1st rising edge on ch1 myScope WriteString MEASU...

Page 623: ...String myScope WriteString SYSTEM ERROR Query any errors data strErrVal myScope ReadString Read Errnum Error String While Val strErrVal 0 End if find 0 No Error strOut strOut INST Error strErrVal mySc...

Page 624: ...624 Agilent 6000 Series Oscilloscopes Programmer s Reference 9 Programming Examples...

Page 625: ...177 automatic probe type detection 501 506 autoscale 105 autoscale acquire mode 107 autoscale channels 108 average value measurement 277 averaging acquisition type 138 438 B bandwidth filter limits 20...

Page 626: ...terface 77 commands more about 563 commands obsolete and discontinued 491 common commands 74 75 77 common command headers 568 completion criteria for an acquisition 141 142 compound command headers 56...

Page 627: ...r commands 364 edge triggering 332 edges activity on digital channels 103 edges in measurement 253 ellipsis 71 enable channel labels 198 enabling calibration 164 enabling channel display 172 enabling...

Page 628: ...228 508 hardcopy formfeed 226 hardcopy grayscale 510 hardcopy invert graticule colors 229 hardcopy palette 230 hardcopy printer driver 231 hardware event condition register 115 Hardware Event Conditi...

Page 629: ...rkers time at start 518 markers time at stop 517 markers X delta 239 markers X1 position 235 markers X1Y1 source 236 markers X2 position 237 markers X2Y2 source 238 markers Y delta 242 markers Y1 posi...

Page 630: ...3 order of output 444 oscilloscope external trigger 203 oscilloscope models 3 oscilloscope rate 147 output messages ready 96 output queue 86 550 output queue clear 79 output sequence 444 overlapped co...

Page 631: ...g clear 79 reset 89 413 RESet commands 481 reset conditions 89 reset measurements 110 195 resolution of printed copy 510 restore configurations 85 88 92 317 restore labels 198 restore setup 88 return...

Page 632: ...ntax optional terms 70 syntax program message 565 SYSTem commands 312 system commands 313 314 315 316 317 319 system commands introduction 312 T tdelta 513 tedge 272 telnet ports 5024 and 5025 446 tem...

Page 633: ...threshold voltage 531 turn function on or off 507 turn off channel 109 turn off channel labels 198 turn off cursors 105 turn off delayed time base mode 105 turn off digital pod 109 turn off math funct...

Page 634: ...446 waveform format 448 waveform points 449 451 waveform preamble 453 waveform source 456 waveform type 460 waveform unsigned 461 waveform view 462 waveform X increment 463 waveform X origin 464 wavef...

Reviews:

No comments

Brands by name

Popular brands

Load more brands