Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference A
Notices © Agilent Technologies, Inc. 2007-2008 Manual Part Number No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Agilent Technologies, Inc. as governed by United States and international copyright laws. Version 05.00.0001 Trademarks Microsoft®, MS-DOS®, Windows®, Windows 2000®, and Windows XP® are U.S. registered trademarks of Microsoft Corporation.
In This Book This programmer's reference gives detailed information on all the commands available for controlling these oscilloscope models: Table 1 Channels InfiniiVision 5000 Series Oscilloscope Models Input Bandwidth (Maximum Sample Rate) 500 MHz (4 GSa/s) 300 MHz (2 GSa/s) 100 MHz (2 GSa/s) 4 analog DSO5054A DSO5034A DSO5014A 2 analog DSO5052A DSO5032A DSO5012A The command descriptions in this reference show upper and lowercase characters.
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Contents In This Book 3 1 What's New What's New in Version 5.00 18 What's New in Version 4.10 20 Version 4.00 at Introduction 21 2 Commands Quick Reference Command Summary 24 Syntax Elements 56 Number Format 56 (Line Terminator) 56 [ ] (Optional Syntax Terms) 56 { } (Braces) 56 ::= (Defined As) 56 < > (Angle Brackets) 57 ... (Ellipsis) 57 n,..
*SRE (Service Request Enable) *STB (Read Status Byte) 81 *TRG (Trigger) 83 *TST (Self Test) 84 *WAI (Wait To Continue) 85 79 Root (:) Commands 86 :AER (Arm Event Register) 89 :AUToscale 90 :AUToscale:AMODE 92 :AUToscale:CHANnels 93 :BLANk 94 :CDISplay 95 :DIGitize 96 :HWEenable (Hardware Event Enable Register) 98 :HWERegister:CONDition (Hardware Event Condition Register) :HWERegister[:EVENt] (Hardware Event Event Register) 102 :MERGe 104 :OPEE (Operation Status Enable Register) 105 :OPERegister:CONDition
:CALibrate:DATE 135 :CALibrate:LABel 136 :CALibrate:STARt 137 :CALibrate:STATus 138 :CALibrate:SWITch 139 :CALibrate:TEMPerature 140 :CALibrate:TIME 141 :CHANnel Commands 142 :CHANnel:BWLimit 145 :CHANnel:COUPling 146 :CHANnel:DISPlay 147 :CHANnel:IMPedance 148 :CHANnel:INVert 149 :CHANnel:LABel 150 :CHANnel:OFFSet 151 :CHANnel:PROBe 152 :CHANnel:PROBe:ID 153 :CHANnel:PROBe:SKEW 154 :CHANnel:PROBe:STYPe 155 :CHANnel:PROTection 156 :CHANnel:RANGe 157 :CHANnel:SCAL
:EXTernal:UNITs 180 :FUNCtion Commands 181 :FUNCtion:CENTer 183 :FUNCtion:DISPlay 184 :FUNCtion:OFFSet 185 :FUNCtion:OPERation 186 :FUNCtion:RANGe 187 :FUNCtion:REFerence 188 :FUNCtion:SCALe 189 :FUNCtion:SOURce 190 :FUNCtion:SPAN 191 :FUNCtion:WINDow 192 :HARDcopy Commands 193 :HARDcopy:AREA 195 :HARDcopy:APRinter 196 :HARDcopy:FACTors 197 :HARDcopy:FFEed 198 :HARDcopy:INKSaver 199 :HARDcopy:PALette 200 :HARDcopy:PRinter:LIST 201 :HARDcopy:STARt 202 :MARKer Commands 203 :MARKer:MODE 205 :MARKer:X1Positio
:MEASure:OVERshoot 231 :MEASure:PERiod 233 :MEASure:PHASe 234 :MEASure:PREShoot 235 :MEASure:PWIDth 236 :MEASure:RISetime 237 :MEASure:SDEViation 238 :MEASure:SHOW 239 :MEASure:SOURce 240 :MEASure:TEDGe 242 :MEASure:TVALue 244 :MEASure:VAMPlitude 246 :MEASure:VAVerage 247 :MEASure:VBASe 248 :MEASure:VMAX 249 :MEASure:VMIN 250 :MEASure:VPP 251 :MEASure:VRMS 252 :MEASure:VTIMe 253 :MEASure:VTOP 254 :MEASure:XMAX 255 :MEASure:XMIN 256 :RECall Commands 257 :RECall:FILename 258 :RECall:IMAGe[:STARt] 259 :RECall:
:SBUS Commands 276 :SBUS:CAN:COUNt:ERRor 278 :SBUS:CAN:COUNt:OVERload 279 :SBUS:CAN:COUNt:RESet 280 :SBUS:CAN:COUNt:TOTal 281 :SBUS:CAN:COUNt:UTILization 282 :SBUS:DISPlay 283 :SBUS:IIC:ASIZe 284 :SBUS:LIN:PARity 285 :SBUS:MODE 286 :SBUS:SPI:WIDTh 287 :SBUS:UART:BASE 288 :SBUS:UART:COUNt:ERRor 289 :SBUS:UART:COUNt:RESet 290 :SBUS:UART:COUNt:RXFRames 291 :SBUS:UART:COUNt:TXFRames 292 :SBUS:UART:FRAMing 293 :SYSTem Commands 294 :SYSTem:DATE 295 :SYSTem:DSP 296 :SYSTem:ERRor 297 :SYSTem:LOCK 298 :SYSTem:SETup
:TRIGger:PATTern 321 :TRIGger:SWEep 323 :TRIGger:CAN Commands 324 :TRIGger:CAN:PATTern:DATA 326 :TRIGger:CAN:PATTern:DATA:LENGth 327 :TRIGger:CAN:PATTern:ID 328 :TRIGger:CAN:PATTern:ID:MODE 329 :TRIGger:CAN:SAMPlepoint 330 :TRIGger:CAN:SIGNal:BAUDrate 331 :TRIGger:CAN:SOURce 332 :TRIGger:CAN:TRIGger 333 :TRIGger:DURation Commands 335 :TRIGger:DURation:GREaterthan 336 :TRIGger:DURation:LESSthan 337 :TRIGger:DURation:PATTern 338 :TRIGger:DURation:QUALifier 339 :TRIGger:DURation:RANGe 340 :TRIGger[:EDGE] Comma
:TRIGger:LIN:SIGNal:BAUDrate 367 :TRIGger:LIN:SOURce 368 :TRIGger:LIN:STANdard 369 :TRIGger:LIN:SYNCbreak 370 :TRIGger:LIN:TRIGger 371 :TRIGger:SPI Commands 372 :TRIGger:SPI:CLOCk:SLOPe 373 :TRIGger:SPI:CLOCk:TIMeout 374 :TRIGger:SPI:FRAMing 375 :TRIGger:SPI:PATTern:DATA 376 :TRIGger:SPI:PATTern:WIDTh 377 :TRIGger:SPI:SOURce:CLOCk 378 :TRIGger:SPI:SOURce:DATA 379 :TRIGger:SPI:SOURce:FRAMe 380 :TRIGger:TV Commands 381 :TRIGger:TV:LINE 382 :TRIGger:TV:MODE 383 :TRIGger:TV:POLarity 384 :TRIGger:TV:SOURce 385 :
:WAVeform:SOURce 420 :WAVeform:SOURce:SUBSource :WAVeform:TYPE 425 :WAVeform:UNSigned 426 :WAVeform:VIEW 427 :WAVeform:XINCrement 428 :WAVeform:XORigin 429 :WAVeform:XREFerence 430 :WAVeform:YINCrement 431 :WAVeform:YORigin 432 :WAVeform:YREFerence 433 424 4 Commands A-Z 5 Obsolete and Discontinued Commands :CHANnel:LABel 462 :CHANnel2:SKEW 463 :CHANnel:INPut 464 :CHANnel:PMODe 465 :DISPlay:CONNect 466 :ERASe 467 :EXTernal:INPut 468 :EXTernal:PMODe 469 :FUNCtion:VIEW 470 :HARDcopy:DESTination 471 :H
:MEASure:VSTArt 490 :MEASure:VSTOp 491 :PRINt? 492 :TIMebase:DELay 494 :TRIGger:CAN:ACKNowledge 495 :TRIGger:CAN:SIGNal:DEFinition 496 :TRIGger:LIN:SIGNal:DEFinition 497 :TRIGger:TV:TVMode 498 6 Error Messages 7 Status Reporting Status Reporting Data Structures Status Byte Register (STB) 509 512 Service Request Enable Register (SRE) Trigger Event Register (TER) Output Queue 514 515 516 Message Queue 517 (Standard) Event Status Register (ESR) 518 (Standard) Event Status Enable Register (ESE) Erro
Valid Command/Query Strings 531 Program Message Syntax 531 Command Tree 535 Duplicate Mnemonics 545 Tree Traversal Rules and Multiple Commands Query Return Values 545 547 All Oscilloscope Commands Are Sequential 548 9 Programming Examples SICL Example in C 550 VISA Example in C 559 VISA Example in Visual Basic 568 VISA COM Example in Visual Basic 578 Index Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 15
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 1 What's New What's New in Version 5.00 18 What's New in Version 4.10 20 Version 4.
1 What's New What's New in Version 5.00 New features in version 5.00 of the InfiniiVision 5000 Series oscilloscope software are: • Serial triggering and decode options are now available. • The :SAVE and :RECall command subsystems. • Changes to the :HARDcopy sommand subsystem to make a clearer distinction between printing and save/recall functionality. More detailed descriptions of the new and changed commands appear below.
1 What's New Changed Commands Obsolete Commands Command Differences :TRIGger:MODE (see page 319) You can now select the serial triggering modes.
1 What's New What's New in Version 4.10 New features in version 4.10 of the InfiniiVision 5000 Series oscilloscope software are: • The square root waveform math function. • Several new hardcopy printer drivers. More detailed descriptions of the new and changed commands appear below. Changed Commands 20 Command Differences :FUNCtion:OPERation (see page 186) You can now select the SQRT (square root) waveform math function.
What's New 1 Version 4.00 at Introduction The Agilent InfiniiVision 5000 Series oscilloscopes were introduced with version 4.00 of oscilloscope operating software. The command set is similar to the 6000 Series oscilloscopes (and the 54620/54640 Series oscilloscopes before them) except that digital channels, rear- panel 10 Mhz reference BNC input/output, and serial bus triggering/decode features are not present.
1 22 What's New Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 2 Commands Quick Reference Command Summary 24 Syntax Elements 56 A 23
2 Commands Quick Reference Command Summary Table 2 Common (*) Commands Summary Command Query Options and Query Returns *CLS (see page 65) n/a n/a *ESE (see page 66) *ESE? (see page 67) ::= 0 to 255; an integer in NR1 format: Bit Weight Name Enables --- ------ ---- ---------7 128 PON Power On 6 64 URQ User Request 5 32 CME Command Error 4 16 EXE Execution Error 3 8 DDE Dev.
2 Commands Quick Reference Table 2 Common (*) Commands Summary (continued) Command Query Options and Query Returns n/a *OPT? (see page 73) ::= 0,0, ::= , , , , , , , , , , , , , , , ::= {0 | All} ::= 0 ::= {0 | LSS}
2 Commands Quick Reference Table 2 Common (*) Commands Summary (continued) Command Query Options and Query Returns n/a *STB? (see page 81) ::= 0 to 255; an integer in NR1 format, as shown in the following: Bit Weight Name "1" Indicates --- ------ ---- --------------7 128 OPER Operation status condition occurred. 6 64 RQS/ Instrument is MSS requesting service. 5 32 ESB Enabled event status condition occurred. 4 16 MAV Message available. 3 8 ---- (Not used.) 2 4 MSG Message displayed.
2 Commands Quick Reference Table 3 Root (:) Commands Summary (continued) Command Query Options and Query Returns :DIGitize [[,..
2 Commands Quick Reference Table 3 Root (:) Commands Summary (continued) Command Query Options and Query Returns :RUN (see page 116) n/a n/a n/a :SERial (see page 117) ::= unquoted string containing serial number :SINGle (see page 118) n/a n/a n/a :STATus? (see page 119) {0 | 1} ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format :STOP (see page 120) n/a n/a n/a :TER? (see page 121) {0 | 1} :VIEW (see page 122) n/a
Commands Quick Reference Table 5 :CALibrate Commands Summary Command Query Options and Query Returns n/a :CALibrate:DATE? (see page 135) ::= ,,; all in NR1 format :CALibrate:LABel (see page 136) :CALibrate:LABel? (see page 136) ::= quoted ASCII string up to 32 characters :CALibrate:STARt (see page 137) n/a n/a n/a :CALibrate:STATus? (see page 138) ::= ALL,, ::= an integer status code
2 Commands Quick Reference Table 6 :CHANnel Commands Summary (continued) Command Query Options and Query Returns :CHANnel:INVert {{0 | OFF} | {1 | ON}} (see page 149) :CHANnel:INVert? (see page 149) {0 | 1} ::= 1-2 or 1-4 in NR1 format :CHANnel:LABel (see page 150) :CHANnel:LABel? (see page 150) ::= any series of 6 or less ASCII characters enclosed in quotation marks ::= 1-2 or 1-4 in NR1 format :CHANnel:OFFSet [suffix] (see page 151) :CHANne
2 Commands Quick Reference Table 7 :DISPlay Commands Summary Command Query Options and Query Returns :DISPlay:CLEar (see page 163) n/a n/a :DISPlay:DATA [][,][] [,][] (see page 164) :DISPlay:DATA? [][,][] [,][] (see page 164) ::= {TIFF} (command) ::= {GRATicule} (command) ::= {MONochrome} (command) ::= {TIFF | BMP | BMP8bit | PNG} (query) ::= {GRATicule | SCReen} (query) ::= {MONochro
2 Commands Quick Reference Table 8 :EXTernal Trigger Commands Summary (continued) Command Query Options and Query Returns :EXTernal:PROBe (see page 175) :EXTernal:PROBe? (see page 175) ::= probe attenuation ratio in NR3 format n/a :EXTernal:PROBe:ID? (see page 176) ::= unquoted ASCII string up to 11 characters :EXTernal:PROBe:STYPe (see page 177) :EXTernal:PROBe:STYPe ? (see page 177) ::= {DIFFerential | SINGle} :EXTernal:PRO
2 Commands Quick Reference Table 9 :FUNCtion Commands Summary (continued) Command Query Options and Query Returns :FUNCtion:RANGe (see page 187) :FUNCtion:RANGe? (see page 187) ::= the full-scale vertical axis value in NR3 format. The range for ADD, SUBT, MULT is 8E-6 to 800E+3. The range for the INTegrate function is 8E-9 to 400E+3. The range for the DIFFerentiate function is 80E-3 to 8.0E12 (depends on current sweep speed). The range for the FFT function is 8 to 800 dBV.
2 Commands Quick Reference Table 10 :HARDcopy Commands Summary Command Query Options and Query Returns :HARDcopy:AREA (see page 195) :HARDcopy:AREA? (see page 195) ::= SCReen :HARDcopy:APRinter (see page 196) :HARDcopy:APRinter? (see page 196) ::= { | } ::= integer index of printer in list ::= name of printer in list :HARDcopy:FACTors {{0 | OFF} | {1 | ON}} (see page 197) :HARDcopy:FACTors? (see page 197) {0 | 1} :HARD
Commands Quick Reference 2 Table 11 :MARKer Commands Summary Command Query Options and Query Returns :MARKer:MODE (see page 205) :MARKer:MODE? (see page 205) ::= {OFF | MEASurement | MANual} :MARKer:X1Position [suffix] (see page 206) :MARKer:X1Position? (see page 206) ::= X1 cursor position value in NR3 format [suffix] ::= {s | ms | us | ns | ps | Hz | kHz | MHz} ::= X1 cursor position value in NR3 format :MARKer:X1Y1source (see page 207)
2 Commands Quick Reference Table 12 :MEASure Commands Summary Command Query Options and Query Returns :MEASure:CLEar (see page 220) n/a n/a :MEASure:COUNter [] (see page 221) :MEASure:COUNter? [] (see page 221) ::= {CHANnel} ::= 1-2 or 1-4 in NR1 format ::= counter frequency in Hertz in NR3 format :MEASure:DEFine DELay, (see page 222) :MEASure:DEFine? DELay (see page 223) ::= , edge_spec1 ::= [
2 Commands Quick Reference Table 12 :MEASure Commands Summary (continued) Command Query Options and Query Returns :MEASure:NWIDth [] (see page 230) :MEASure:NWIDth? [] (see page 230) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format ::= negative pulse width in seconds-NR3 format :MEASure:OVERshoot [] (see page 231) :MEASure:OVERshoot? [] (see page 231) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 for
2 Commands Quick Reference Table 12 :MEASure Commands Summary (continued) Command Query Options and Query Returns :MEASure:SDEViation [] (see page 238) :MEASure:SDEViation? [] (see page 238) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format ::= calculated std deviation in NR3 format :MEASure:SHOW {1 | ON} (see page 239) :MEASure:SHOW? (see page 239) {1} :MEASure:SOURce [] [,] (see page 240) :MEASure:SOURce? (see page 240
Commands Quick Reference 2 Table 12 :MEASure Commands Summary (continued) Command Query Options and Query Returns :MEASure:VAVerage [] (see page 247) :MEASure:VAVerage? [] (see page 247) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format ::= calculated average voltage in NR3 format :MEASure:VBASe [] (see page 248) :MEASure:VBASe? [] (see page 248) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format
2 Commands Quick Reference Table 12 :MEASure Commands Summary (continued) Command Query Options and Query Returns :MEASure:VTOP [] (see page 254) :MEASure:VTOP? [] (see page 254) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format ::= voltage at the top of the waveform in NR3 format :MEASure:XMAX [] (see page 255) :MEASure:XMAX? [] (see page 255) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format
2 Commands Quick Reference Table 14 :SAVE Commands Summary Command Query Options and Query Returns :SAVE:FILename (see page 264) :SAVE:FILename? (see page 264) ::= quoted ASCII string :SAVE:IMAGe[:STARt] [] (see page 265) n/a ::= { | } ::= 0-9; an integer in NR1 format ::= quoted ASCII string :SAVE:IMAGe:AREA (see page 266) :SAVE:IMAGe:AREA? (see page 266) ::= {GRATicule | SCReen} :
2 Commands Quick Reference Table 15 :SBUS Commands Summary Command Query Options and Query Returns n/a :SBUS:CAN:COUNt:ERRor ? (see page 278) ::= integer in NR1 format n/a :SBUS:CAN:COUNt:OVERl oad? (see page 279) ::= integer in NR1 format :SBUS:CAN:COUNt:RESet (see page 280) n/a n/a n/a :SBUS:CAN:COUNt:TOTal ? (see page 281) ::= integer in NR1 format n/a :SBUS:CAN:COUNt:UTILi zation? (see page 282) ::= floating-point in NR3 format :SBU
2 Commands Quick Reference Table 15 :SBUS Commands Summary (continued) Command Query Options and Query Returns n/a :SBUS:UART:COUNt:TXFR ames? (see page 292) ::= integer in NR1 format :SBUS:UART:FRAMing (see page 293) :SBUS:UART:FRAMing? (see page 293) ::= {OFF | | } ::= 8-bit integer from 0-255 (0x00-0xff) ::= #Hnn where n ::= {0,..,9 | A,..,F} for hexadecimal ::= #Bnn...
2 Commands Quick Reference Table 17 :TIMebase Commands Summary Command Query Options and Query Returns :TIMebase:MODE (see page 304) :TIMebase:MODE? (see page 304) ::= {MAIN | WINDow | XY | ROLL} :TIMebase:POSition (see page 305) :TIMebase:POSition? (see page 305) ::= time from the trigger event to the display reference point in NR3 format :TIMebase:RANGe (see page 306) :TIMebase:RANGe? (see page 306) ::= 10 ns through 500 s in NR3 format
Commands Quick Reference 2 Table 18 General :TRIGger Commands Summary (continued) Command Query Options and Query Returns :TRIGger:MODE (see page 319) :TRIGger:MODE? (see page 319) ::= {EDGE | GLITch | PATTern | DURation | TV} ::= { | } ::= query returns "NONE" if the :TIMebase:MODE is ROLL or XY :TRIGger:NREJect {{0 | OFF} | {1 | ON}} (see page 320) :TRIGger:NREJect? (see page 320) {0 | 1} :TRIGger:PATTern , [,,] (s
2 Commands Quick Reference Table 19 :TRIGger:CAN Commands Summary Command Query Options and Query Returns :TRIGger:CAN:PATTern: DATA , (see page 326) :TRIGger:CAN:PATTern: DATA? (see page 326) ::= 64-bit integer in decimal, , or (with Option AMS) ::= 64-bit integer in decimal, , or ::= #Hnn...n where n ::= {0,..,9 | A,..,F} for hexadecimal ::= #Bnn...n where n ::= {0 | 1} for binary ::= "0xnn...
Commands Quick Reference 2 Table 19 :TRIGger:CAN Commands Summary (continued) Command Query Options and Query Returns :TRIGger:CAN:SOURce (see page 332) :TRIGger:CAN:SOURce? (see page 332) ::= {CHANnel | EXTernal} for DSO models ::= {CHANnel | DIGital0,..
2 Commands Quick Reference Table 21 :TRIGger[:EDGE] Commands Summary Command Query Options and Query Returns :TRIGger[:EDGE]:COUPl ing {AC | DC | LF} (see page 342) :TRIGger[:EDGE]:COUPl ing? (see page 342) {AC | DC | LF} :TRIGger[:EDGE]:LEVel [,] (see page 343) :TRIGger[:EDGE]:LEVel ? [] (see page 343) For internal triggers, ::= .75 x full-scale voltage from center screen in NR3 format.
2 Commands Quick Reference Table 22 :TRIGger:GLITch Commands Summary (continued) Command Query Options and Query Returns :TRIGger:GLITch:LEVel [] (see page 350) :TRIGger:GLITch:LEVel ? (see page 350) For internal triggers, ::= .75 x full-scale voltage from center screen in NR3 format. For external triggers, ::= 2 volts with probe attenuation at 1:1 in NR3 format.
2 Commands Quick Reference Table 23 :TRIGger:IIC Commands Summary (continued) Command Query Options and Query Returns :TRIGger:IIC[:SOURce] :CLOCk (see page 359) :TRIGger:IIC[:SOURce] :CLOCk? (see page 359) ::= {CHANnel | EXTernal} for DSO models ::= {CHANnel | DIGital0,..
Commands Quick Reference 2 Table 24 :TRIGger:LIN Commands Summary (continued) Command Query Options and Query Returns :TRIGger:LIN:SOURce (see page 368) :TRIGger:LIN:SOURce? (see page 368) ::= {CHANnel | EXTernal} for DSO models ::= {CHANnel | DIGital0,..
2 Commands Quick Reference Table 26 :TRIGger:UART Commands Summary Command Query Options and Query Returns :TRIGger:UART:BAUDrat e (see page 389) :TRIGger:UART:BAUDrat e? (see page 389) ::= {1200 | 1800 | 2000 | 2400 | 3600 | 4800 | 7200 | 9600 | 14400 | 15200 | 19200 | 28800 | 38400 | 56000 | 57600 | 76800 | 115200 | 128000 | 230400 | 460800 | 921600 | 1382400 | 1843200 | 2764800} :TRIGger:UART:BITorde r (see page 390) :TRIGger:UART:BITorde r? (see page 390)
2 Commands Quick Reference Table 26 :TRIGger:UART Commands Summary (continued) Command Query Options and Query Returns :TRIGger:UART:SOURce: TX (see page 398) :TRIGger:UART:SOURce: TX? (see page 398) ::= {CHANnel | EXTernal} for DSO models ::= {CHANnel | DIGital0,..
2 Commands Quick Reference Table 27 :WAVeform Commands Summary (continued) Command Query Options and Query Returns :WAVeform:POINts <# points> (see page 413) :WAVeform:POINts? (see page 413) <# points> ::= {100 | 250 | 500 | 1000 | } if waveform points mode is NORMal <# points> ::= {100 | 250 | 500 | 1000 | 2000 ...
Commands Quick Reference 2 Table 27 :WAVeform Commands Summary (continued) Command Query Options and Query Returns :WAVeform:UNSigned {{0 | OFF} | {1 | ON}} (see page 426) :WAVeform:UNSigned? (see page 426) {0 | 1} :WAVeform:VIEW (see page 427) :WAVeform:VIEW? (see page 427) ::= {MAIN} n/a :WAVeform:XINCrement? (see page 428) ::= x-increment in the current preamble in NR3 format n/a :WAVeform:XORigin? (see page 429) ::= x-origin value in the curren
2 Commands Quick Reference Syntax Elements • "Number Format" on page 56 • " (Line Terminator)" on page 56 • "[ ] (Optional Syntax Terms)" on page 56 • "{ } (Braces)" on page 56 • "::= (Defined As)" on page 56 • "< > (Angle Brackets)" on page 57 • "... (Ellipsis)" on page 57 • "n,..,p (Value Ranges)" on page 57 • "d (Digits)" on page 57 • "Quoted ASCII String" on page 57 • "Definite- Length Block Response Data" on page 57 Number Format NR1 specifies integer data.
2 Commands Quick Reference For example, ::= indicates that can be replaced by in any statement containing . < > (Angle Brackets) < > Angle brackets enclose words or characters that symbolize a program code parameter or an interface command. ... (Ellipsis) ... An ellipsis (trailing dots) indicates that the preceding element may be repeated one or more times. n,..,p (Value Ranges) n,..,p ::= all integers between n and p inclusive.
2 Commands Quick Reference #800001000<1000 bytes of data> 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 58 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 3 Commands by Subsystem Subsystem Description "Common (*) Commands" on page 61 Commands defined by IEEE 488.2 standard that are common to all instruments. "Root (:) Commands" on page 86 Control many of the basic functions of the oscilloscope and reside at the root level of the command tree. ":ACQuire Commands" on page 123 Set the parameters for acquiring and storing data.
3 Commands by Subsystem Command Types Subsystem Description ":SBUS Commands" on page 276 Control oscilloscope functions associated with the serial decode bus. ":SYSTem Commands" on page 294 Control basic system functions of the oscilloscope. ":TIMebase Commands" on page 302 Control all horizontal sweep functions. ":TRIGger Commands" on page 313 Control the trigger modes and parameters for each trigger type. ":WAVeform Commands" on page 401 Provide access to waveform data.
Commands by Subsystem 3 Common (*) Commands Commands defined by IEEE 488.2 standard that are common to all instruments. See "Introduction to Common (*) Commands" on page 63.
3 Commands by Subsystem Table 28 Common (*) Commands Summary (continued) Command Query Options and Query Returns n/a *OPT? (see page 73) ::= 0,0, ::= , , , , , , , , , , , , , , , ::= {0 | All} ::= 0 ::= {0 | LSS}
Commands by Subsystem 3 Table 28 Common (*) Commands Summary (continued) Command Query Options and Query Returns n/a *STB? (see page 81) ::= 0 to 255; an integer in NR1 format, as shown in the following: Bit Weight Name "1" Indicates --- ------ ---- --------------7 128 OPER Operation status condition occurred. 6 64 RQS/ Instrument is MSS requesting service. 5 32 ESB Enabled event status condition occurred. 4 16 MAV Message available. 3 8 ---- (Not used.) 2 4 MSG Message displayed.
3 Commands by Subsystem NOTE 64 Each of the status registers has an enable (mask) register. By setting the bits in the enable register, you can select the status information you want to use.
Commands by Subsystem 3 *CLS (Clear Status) (see page 530) Command Syntax *CLS The *CLS common command clears the status data structures, the device- defined error queue, and the Request- for- OPC flag. NOTE See Also If the *CLS command immediately follows a program message terminator, the output queue and the MAV (message available) bit are cleared.
3 Commands by Subsystem *ESE (Standard Event Status Enable) (see page 530) Command Syntax *ESE ::= integer from 0 to 255 The *ESE common command sets the bits in the Standard Event Status Enable Register. The Standard Event Status Enable Register contains a mask value for the bits to be enabled in the Standard Event Status Register. A "1" in the Standard Event Status Enable Register enables the corresponding bit in the Standard Event Status Register.
Commands by Subsystem 3 Table 29 Standard Event Status Enable (ESE) (continued) Query Syntax Bit Name Description When Set (1 = High = True), Enables: 1 RQL Request Control Event when the device is requesting control. (Not used.) 0 OPC Operation Complete Event when an operation is complete. *ESE? The *ESE? query returns the current contents of the Standard Event Status Enable Register. Return Format ::= 0,..,255; an integer in NR1 format.
3 Commands by Subsystem *ESR (Standard Event Status Register) (see page 530) Query Syntax *ESR? The *ESR? query returns the contents of the Standard Event Status Register. When you read the Event Status Register, the value returned is the total bit weights of all of the bits that are high at the time you read the byte. Reading the register clears the Event Status Register. The following table shows bit weight, name, and condition for each bit.
Commands by Subsystem 3 Table 30 Standard Event Status Register (ESR) (continued) Return Format Bit Name Description When Set (1 = High = True), Indicates: 1 RQL Request Control The device is requesting control. (Not used.) 0 OPC Operation Complete Operation is complete. ::= 0,..,255; an integer in NR1 format. NOTE See Also Reading the Standard Event Status Register clears it. High or 1 indicates the bit is true.
3 Commands by Subsystem *IDN (Identification Number) (see page 530) Query Syntax *IDN? The *IDN? query identifies the instrument type and software version. Return Format AGILENT TECHNOLOGIES,,,X.XX.XX ::= the model number of the instrument ::= the serial number of the instrument X.XX.
3 Commands by Subsystem *LRN (Learn Device Setup) (see page 530) Query Syntax *LRN? The *LRN? query result contains the current state of the instrument. This query is similar to the :SYSTem:SETup? (see page 299) query, except that it contains ":SYST:SET " before the binary block data. The query result is a valid command that can be used to restore instrument settings at a later time.
3 Commands by Subsystem *OPC (Operation Complete) (see page 530) Command Syntax *OPC The *OPC command sets the operation complete bit in the Standard Event Status Register 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 this query returns.
Commands by Subsystem 3 *OPT (Option Identification) (see page 530) Query Syntax *OPT? The *OPT? query reports the options installed in the instrument. This query returns a string that identifies the module and its software revision level.
3 Commands by Subsystem *RCL (Recall) (see page 530) Command Syntax *RCL ::= {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.
Commands by Subsystem 3 *RST (Reset) (see page 530) Command Syntax *RST The *RST command places the instrument in a known state. Reset conditions 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 AutoProbe is connected), otherwise 1.
3 Commands by Subsystem Display Menu Definite persistence Off Grid 33% Vectors On Quick Meas Menu Source Channel 1 Run Control Scope is running Time Base Menu Main time/division 100 us Main time base delay 0.00 s Delay time/division 500 ns Delay time base delay 0.00 s Reference center Mode main Vernier Off Trigger Menu 76 Type Edge Mode Auto Coupling dc Source Channel 1 Level 0.
Commands by Subsystem 3 Trigger Menu See Also Example Code External Units Volts External Impedance 1 M Ohm • "Introduction to Common (*) Commands" on page 63 ' RESET - This command puts the oscilloscope into a known state. ' This statement is very important for programs to work as expected. ' Most of the following initialization commands are initialized by ' *RST. It is not necessary to reinitialize them unless the default ' setting is not suitable for your application. myScope.
3 Commands by Subsystem *SAV (Save) (see page 530) Command Syntax *SAV ::= {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 data will be saved.
3 Commands by Subsystem *SRE (Service Request Enable) (see page 530) Command Syntax *SRE ::= integer with values defined in the following table. The *SRE command sets the bits in the Service Request Enable Register. The Service Request Enable Register contains a mask value for the bits to be enabled in the Status Byte Register. A one in the Service Request Enable Register enables the corresponding bit in the Status Byte Register. A zero disables the bit.
3 Commands by Subsystem Table 31 Service Request Enable Register (SRE) (continued) Query Syntax Bit Name Description When Set (1 = High = True), Enables: 5 ESB Event Status Bit Interrupts when enabled conditions in the Standard Event Status Register (ESR) occur. 4 MAV Message Available Interrupts when messages are in the Output Queue. 3 --- --- (Not used.) 2 MSG Message Interrupts when an advisory has been displayed on the oscilloscope.
3 Commands by Subsystem *STB (Read Status Byte) (see page 530) Query Syntax *STB? The *STB? query returns the current value of the instrument's status byte. The MSS (Master Summary Status) bit is reported on bit 6 instead of the RQS (request service) bit. The MSS indicates whether or not the device has at least one reason for requesting service. Return Format ::= 0,..
3 Commands by Subsystem Table 32 Status Byte Register (STB) (continued) NOTE See Also Bit Name Description When Set (1 = High = True), Indicates: 6 RQS Request Service When polled, that the device is requesting service. MSS Master Summary Status When read (by *STB?), whether the device has a reason for requesting service. 5 ESB Event Status Bit An enabled condition in the Standard Event Status Register (ESR) has occurred. 4 MAV Message Available There are messages in the Output Queue.
Commands by Subsystem 3 *TRG (Trigger) (see page 530) Command Syntax *TRG The *TRG command has the same effect as the :DIGitize command with no parameters.
3 Commands by Subsystem *TST (Self Test) (see page 530) Query Syntax *TST? The *TST? query performs a self- test on the instrument. The result of the test is placed in the output queue. A zero indicates the test passed and a non- zero indicates the test failed. If the test fails, refer to the troubleshooting section of the Service Guide.
Commands by Subsystem 3 *WAI (Wait To Continue) (see page 530) Command Syntax *WAI The *WAI command has no function in the oscilloscope, but is parsed for compatibility with other instruments.
3 Commands by Subsystem Root (:) Commands Control many of the basic functions of the oscilloscope and reside at the root level of the command tree. See "Introduction to Root (:) Commands" on page 88. Table 33 Root (:) Commands Summary Command Query Options and Query Returns n/a :AER? (see page 89) {0 | 1}; an integer in NR1 format :AUToscale [[,..
3 Commands by Subsystem Table 33 Root (:) Commands Summary (continued) Command Query Options and Query Returns :OVLenable (see page 111) :OVLenable? (see page 112) ::= 16-bit integer in NR1 format as shown: Bit Weight Input --- ------ ---------10 1024 Ext Trigger Fault 9 512 Channel 4 Fault 8 256 Channel 3 Fault 7 128 Channel 2 Fault 6 64 Channel 1 Fault 4 16 Ext Trigger OVL 3 8 Channel 4 OVL 2 4 Channel 3 OVL 1 2 Channel 2 OVL 0 1 Channel 1 OVL n/a :OVLRegister? (see page 113)
3 Commands by Subsystem Introduction to Root (:) Commands 88 Root level commands control many of the basic operations of the instrument. These commands are always recognized by the parser if they are prefixed with a colon, regardless of current command tree position. After executing a root- level command, the parser is positioned at the root of the command tree.
3 Commands by Subsystem :AER (Arm Event Register) (see page 530) Query Syntax :AER? The AER query reads the Arm Event Register. After the Arm Event Register is read, it is cleared. A "1" indicates the trigger system is in the armed state, ready to accept a trigger. The Armed Event Register is summarized in the Wait Trig bit of the Operation Status Event Register.
3 Commands by Subsystem :AUToscale (see page 530) Command Syntax :AUToscale :AUToscale [[,..,]] ::= CHANnel ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The parameter may be repeated up to 5 times. The :AUToscale command evaluates all input signals and sets the correct conditions to display the signals. This is the same as pressing the Autoscale key on the front panel.
3 Commands by Subsystem • ":AUToscale:AMODE" on page 92 Example Code ' AUTOSCALE - This command evaluates all the input signals and sets ' the correct conditions to display all of the active signals. myScope.WriteString ":AUTOSCALE" ' Same as pressing Autoscale key.
3 Commands by Subsystem :AUToscale:AMODE (see page 530) Command Syntax :AUToscale:AMODE ::= {NORMal | CURRent} The :AUTOscale:AMODE command specifies the acquisition mode that is set by subsequent :AUToscales. • When NORMal is selected, an :AUToscale command sets the NORMal acquisition type and the RTIMe (real- time) acquisition mode. • When CURRent is selected, the current acquisition type and mode are kept on subsequent :AUToscales.
Commands by Subsystem 3 :AUToscale:CHANnels (see page 530) Command Syntax :AUToscale:CHANnels ::= {ALL | DISPlayed} The :AUTOscale:CHANnels command specifies which channels will be displayed on subsequent :AUToscales. • When ALL is selected, 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 channels on or off.
3 Commands by Subsystem :BLANk (see page 530) Command Syntax :BLANk [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :BLANk command turns off (stops displaying) the specified channel or math function. The :BLANk command with no parameter turns off all sources. NOTE To turn on (start displaying) a channel, etc., use the :VIEW command.
Commands by Subsystem 3 :CDISplay (see page 530) Command Syntax :CDISplay The :CDISplay 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 the data in active channels and functions is erased; however, new data is displayed on the next acquisition.
3 Commands by Subsystem :DIGitize (see page 530) Command Syntax :DIGitize [[,..,]] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The parameter may be repeated up to 5 times. The :DIGitize command is a specialized RUN command. It causes the instrument to acquire waveforms according to the settings of the :ACQuire commands subsystem.
3 Commands by Subsystem ' because this is greater than the maximum sample rate by 5 times, ' only 400 points (or 1/5 the points) can be gathered on 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 cleared and internal hardware to be reconfigured.
3 Commands by Subsystem :HWEenable (Hardware Event Enable Register) (see page 530) Command Syntax :HWEenable ::= 16-bit integer The :HWEenable command sets a mask in the Hardware Event Enable register. Set any of the following bits to "1" to enable bit 12 in the Operation Status Condition Register and potentially cause an SRQ (Service Request interrupt to be generated.
Commands by Subsystem 3 • ":AER (Arm Event Register)" on page 89 • ":CHANnel:PROTection" on page 156 • ":EXTernal:PROTection" on page 178 • ":OPERegister[:EVENt] (Operation Status Event Register)" on page 109 • ":OVLenable (Overload Event Enable Register)" on page 111 • ":OVLRegister (Overload Event Register)" on page 113 • "*STB (Read Status Byte)" on page 81 • "*SRE (Service Request Enable)" on page 79 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 99
3 Commands by Subsystem :HWERegister:CONDition (Hardware Event Condition Register) (see page 530) Query Syntax :HWERegister:CONDition? The :HWERegister:CONDition? query returns the integer value contained in the Hardware Event Condition Register.
Commands by Subsystem 3 • ":OVLRegister (Overload Event Register)" on page 113 • "*STB (Read Status Byte)" on page 81 • "*SRE (Service Request Enable)" on page 79 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 101
3 Commands by Subsystem :HWERegister[:EVENt] (Hardware Event Event Register) (see page 530) Query Syntax :HWERegister[:EVENt]? The :HWERegister[:EVENt]? query returns the integer value contained in the Hardware Event Event Register.
Commands by Subsystem 3 • ":OVLRegister (Overload Event Register)" on page 113 • "*STB (Read Status Byte)" on page 81 • "*SRE (Service Request Enable)" on page 79 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 103
3 Commands by Subsystem :MERGe (see page 530) Command Syntax :MERGe ::= {PMEMory0 | PMEMory1 | PMEMory2 | PMEMory3 | PMEMory4 | PMEMory5 | PMEMory6 | PMEMory7 | PMEMory8 | 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 PMEMory9.
Commands by Subsystem 3 :OPEE (Operation Status Enable Register) (see page 530) Command Syntax :OPEE ::= 16-bit integer The :OPEE command sets a mask in the Operation Status Enable register. Set any of the following bits to "1" to enable bit 7 in the Status Byte Register and potentially cause an SRQ (Service Request interrupt to be generated.
3 Commands by Subsystem Table 37 Operation Status Enable Register (OPEE) (continued) Query Syntax Bit Name Description When Set (1 = High = True), Enables: 3 Run Running Event when the oscilloscope is running (not stopped). 2-0 --- --- (Not used.) :OPEE? The :OPEE? query returns the current value contained in the Operation Status Enable register as an integer number. Return Format ::= integer in NR1 format.
3 Commands by Subsystem :OPERegister:CONDition (Operation Status Condition Register) (see page 530) Query Syntax :OPERegister:CONDition? The :OPERegister:CONDition? query returns the integer value contained in the Operation Status Condition Register.
3 Commands by Subsystem Return Format ::= integer in NR1 format.
3 Commands by Subsystem :OPERegister[:EVENt] (Operation Status Event Register) (see page 530) Query Syntax :OPERegister[:EVENt]? The :OPERegister[:EVENt]? query returns the integer value contained in the Operation Status Event Register.
3 Commands by Subsystem Return Format ::= integer in NR1 format.
3 Commands by Subsystem :OVLenable (Overload Event Enable Register) (see page 530) Command Syntax :OVLenable ::= 16-bit integer The overload enable mask is an integer representing an input as described in the following table. The :OVLenable command sets the mask in the Overload Event Enable Register and enables the reporting of the Overload Event Register. If an overvoltage is sensed on a 50Ω input, the input will automatically switch to 1 MΩ input impedance.
3 Commands by Subsystem Table 40 Overload Event Enable Register (OVL) (continued) Query Syntax Bit Description When Set (1 = High = True), Enables: 7 Channel 2 Fault Event when fault occurs on Channel 2 input. 6 Channel 1 Fault Event when fault occurs on Channel 1 input. 5 --- (Not used.) 4 External Trigger OVL Event when overload occurs on External Trigger input. 3 Channel 4 OVL Event when overload occurs on Channel 4 input.
3 Commands by Subsystem :OVLRegister (Overload Event Register) (see page 530) Query Syntax :OVLRegister? The :OVLRegister query returns the overload protection value stored in the Overload Event Register (OVLR). If an overvoltage is sensed on a 50Ω input, the input will automatically switch to 1 MΩ input impedance. A "1" indicates an overload has occurred. You can set analog channel input impedance to 50Ω. If there are only two analog channels, you can also set external trigger input impedance to 50Ω.
3 Commands by Subsystem Table 41 Overload Event Register (OVLR) (continued) Return Format Bit Description When Set (1 = High = True), Indicates: 4 External Trigger OVL Overload has occurred on External Trigger input. 3 Channel 4 OVL Overload has occurred on Channel 4 input. 2 Channel 3 OVL Overload has occurred on Channel 3 input. 1 Channel 2 OVL Overload has occurred on Channel 2 input. 0 Channel 1 OVL Overload has occurred on Channel 1 input.
3 Commands by Subsystem :PRINt (see page 530) Command Syntax :PRINt [] ::= [][,..,] ::= {COLor | GRAYscale | PRINter0 | BMP8bit | BMP | PNG | NOFactors | FACTors} The parameter may be repeated up to 5 times. The PRINt command formats the output according to the currently selected format (device). If an option is not specified, the value selected in the Print Config menu is used.
3 Commands by Subsystem :RUN (see page 530) Command Syntax :RUN The :RUN command starts repetitive acquisitions. This is the same as pressing the Run key on the front panel. See Also • "Introduction to Root (:) Commands" on page 88 • ":SINGle" on page 118 • ":STOP" on page 120 Example Code ' RUN_STOP - (not executed in this example) ' - RUN starts the data acquisition for the active waveform display. ' - STOP stops the data acquisition and turns off AUTOSTORE. ' myScope.
Commands by Subsystem 3 :SERial (see page 530) Query Syntax :SERial? The :SERial? query returns the serial number of the instrument.
3 Commands by Subsystem :SINGle (see page 530) 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.
Commands by Subsystem 3 :STATus (see page 530) Query Syntax :STATus? ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :STATus? query reports whether the channel or function specified by is displayed. NOTE Return Format MATH is an alias for FUNCtion.
3 Commands by Subsystem :STOP (see page 530) Command Syntax :STOP The :STOP command stops the acquisition. This is the same as pressing the Stop key on the front panel.
Commands by Subsystem 3 :TER (Trigger Event Register) (see page 530) Query Syntax :TER? The :TER? query reads the Trigger Event Register. After the Trigger Event Register is read, it is cleared. A one indicates a trigger has occurred. A zero indicates a trigger has not occurred. The Trigger Event Register is summarized in the TRG bit of the Status Byte Register (STB).
3 Commands by Subsystem :VIEW (see page 530) Command Syntax :VIEW ::= {CHANnel | PMEMory0,..,PMEMory9 | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :VIEW command turns on the specified channel, function, or trace memory. NOTE See Also MATH is an alias for FUNCtion.
3 Commands by Subsystem :ACQuire Commands Set the parameters for acquiring and storing data. See "Introduction to :ACQuire Commands" on page 123.
3 Commands by Subsystem The :ACQuire:TYPE AVERage command sets the oscilloscope in the averaging mode. You can set the count by sending the :ACQuire:COUNt command followed by the number of averages. In this mode, the value for averages is an integer from 1 (smoothing) to 65536. The COUNt value determines the number of averages that must be acquired. Peak Detect The :ACQuire:TYPE PEAK command sets the oscilloscope in the peak detect mode. In this mode, :ACQuire:COUNt has no meaning.
3 Commands by Subsystem :ACQuire:AALias (see page 530) 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.
3 Commands by Subsystem :ACQuire:COMPlete (see page 530) Command Syntax :ACQuire:COMPlete ::= 100; an integer in NR1 format The :ACQuire:COMPlete command affects the operation of the :DIGitize command. It specifies the minimum completion criteria for an acquisition. The parameter determines the percentage of the time buckets that must be "full" before an acquisition is considered complete.
Commands by Subsystem 3 :ACQuire:COUNt (see page 530) Command Syntax :ACQuire:COUNt ::= integer in NR1 format In averaging mode, the :ACQuire:COUNt command specifies the number of values to be averaged for each time bucket before 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.
3 Commands by Subsystem :ACQuire:DAALias (see page 530) Command Syntax :ACQuire:DAALias ::= {DISable | AUTO} The :ACQuire:DAALias command sets the disable anti- alias mode of the oscilloscope. When set to DISable, anti- alias is always disabled. This 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.
Commands by Subsystem 3 :ACQuire:MODE (see page 530) Command Syntax :ACQuire:MODE ::= {RTIMe | ETIMe} The :ACQuire:MODE command sets the acquisition mode of the oscilloscope. The :ACQuire:MODE RTIMe command sets the oscilloscope in real time mode. 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.
3 Commands by Subsystem :ACQuire:POINts (see page 530) Query Syntax :ACQuire:POINts? The :ACQuire:POINts? query returns the number of data points that the hardware will acquire from the input signal. The number of points acquired is not directly controllable. To set the number of points to be transferred from the oscilloscope, use the command :WAVeform:POINts. The :WAVeform:POINts? query will return the number of points available to be transferred from the oscilloscope.
Commands by Subsystem 3 :ACQuire:SRATe (see page 530) Query Syntax :ACQuire:SRATe? The :ACQuire:SRATe? query returns the current oscilloscope acquisition sample rate. The sample rate is not directly controllable.
3 Commands by Subsystem :ACQuire:TYPE (see page 530) Command Syntax :ACQuire:TYPE ::= {NORMal | AVERage | HRESolution | PEAK} The :ACQuire:TYPE command selects the type of data acquisition that is to take place. The acquisition types are: NORMal, AVERage, HRESolution, and PEAK. • The :ACQuire:TYPE NORMal command sets the oscilloscope in the normal mode. • The :ACQuire:TYPE AVERage command sets the oscilloscope in the averaging mode.
Commands by Subsystem 3 • ":ACQuire:COUNt" on page 127 • ":ACQuire:MODE" on page 129 • ":DIGitize" on page 96 • ":WAVeform:TYPE" on page 425 • ":WAVeform:PREamble" on page 417 Example Code ' AQUIRE_TYPE - Sets the acquisition mode, which can be NORMAL, ' PEAK, or AVERAGE. myScope.
3 Commands by Subsystem :CALibrate Commands Utility commands for viewing calibration status and for starting the user calibration procedure. See "Introduction to :CALibrate Commands" on page 134.
Commands by Subsystem 3 :CALibrate:DATE (see page 530) Query Syntax :CALibrate:DATE? The :CALibrate:DATE? query returns the date of the last calibration.
3 Commands by Subsystem :CALibrate:LABel (see page 530) Command Syntax :CALibrate:LABel ::= quoted ASCII string of up to 32 characters in length, not including the quotes The CALibrate:LABel command saves a string that is up to 32 characters in length into the instrument's non- volatile memory. The string may be used to record calibration dates or other information as needed.
Commands by Subsystem 3 :CALibrate:STARt (see page 530) Command Syntax :CALibrate:STARt The CALibrate:STARt command starts the user calibration procedure. NOTE See Also Before starting the user calibration procedure, you must set the rear panel CALIBRATION switch to UNPROTECTED, and you must connect BNC cables from the TRIG OUT connector to the analog channel inputs. See the User's Guide for details.
3 Commands by Subsystem :CALibrate:STATus (see page 530) Query Syntax :CALibrate:STATus? The :CALibrate:STATus? query returns the summary results of the last user calibration procedure.
Commands by Subsystem 3 :CALibrate:SWITch (see page 530) Query 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 calibration is enabled.
3 Commands by Subsystem :CALibrate:TEMPerature (see page 530) Query Syntax :CALibrate:TEMPerature? The :CALibrate:TEMPerature? query returns the change in temperature since the last user calibration procedure.
Commands by Subsystem 3 :CALibrate:TIME (see page 530) Query Syntax :CALibrate:TIME? The :CALibrate:TIME? query returns the time of the last calibration.
3 Commands by Subsystem :CHANnel Commands Control all oscilloscope functions associated with individual analog channels or groups of channels. See "Introduction to :CHANnel Commands" on page 143.
3 Commands by Subsystem Table 44 :CHANnel Commands Summary (continued) Command Query Options and Query Returns :CHANnel:PROBe:STY Pe (see page 155) :CHANnel:PROBe:STY Pe? (see page 155) ::= {DIFFerential | SINGle} ::= 1-2 or 1-4 in NR1 format :CHANnel:PROTectio n (see page 156) :CHANnel:PROTectio n? (see page 156) {NORM | TRIP} ::= 1-2 or 1-4 in NR1 format :CHANnel:RANGe [suffix] (see page 157) :CHANnel:RANGe? (see page 157)
3 Commands by Subsystem Return Format The following are sample responses from the :CHANnel? query. In this case, the query was issued following a *RST command. :CHAN1:RANG +40.0E+00;OFFS +0.00000E+00;COUP DC;IMP ONEM;DISP 1;BWL 0; INV 0;LAB "1";UNIT VOLT;PROB +10E+00;PROB:SKEW +0.
Commands by Subsystem 3 :CHANnel:BWLimit (see page 530) Command Syntax :CHANnel:BWLimit ::= {{1 | ON} | {0 | OFF} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:BWLimit command controls an internal low- pass filter. When the filter is on, the bandwidth of the specified channel is limited to approximately 25 MHz.
3 Commands by Subsystem :CHANnel:COUPling (see page 530) Command Syntax :CHANnel:COUPling ::= {AC | DC} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:COUPling command selects the input coupling for the specified channel. The coupling for each analog channel can be set to AC or DC.
Commands by Subsystem 3 :CHANnel:DISPlay (see page 530) Command Syntax :CHANnel:DISPlay ::= {{1 | ON} | {0 | OFF}} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:DISPlay command turns the display of the specified channel on or off. Query Syntax :CHANnel:DISPlay? The :CHANnel:DISPlay? query returns the current display setting for the specified channel.
3 Commands by Subsystem :CHANnel:IMPedance (see page 530) Command Syntax :CHANnel:IMPedance ::= {ONEMeg | FIFTy} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:IMPedance command selects the input impedance setting for the specified analog channel. The legal values for this command are ONEMeg (1 MΩ) and FIFTy (50Ω).
3 Commands by Subsystem :CHANnel:INVert (see page 530) Command Syntax :CHANnel:INVert ::= {{1 | ON} | {0 | OFF} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:INVert command selects whether or not to invert the input signal for the specified channel. The inversion may be 1 (ON/inverted) or 0 (OFF/not inverted).
3 Commands by Subsystem :CHANnel:LABel (see page 530) Command Syntax :CHANnel:LABel ::= quoted ASCII string ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models NOTE Label strings are six characters or less, and may contain any commonly used ASCII characters. Labels with more than 6 characters are truncated to six characters. Lower case characters are converted to upper case.
3 Commands by Subsystem :CHANnel:OFFSet (see page 530) Command Syntax :CHANnel:OFFSet [] ::= Vertical offset value in NR3 format ::= {V | mV} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:OFFSet command sets the value that is represented at center screen for the selected channel.
3 Commands by Subsystem :CHANnel:PROBe (see page 530) Command Syntax :CHANnel:PROBe ::= probe attenuation ratio in NR3 format ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The obsolete attenuation values X1, X10, X20, X100 are also supported. The :CHANnel:PROBe command specifies the probe attenuation factor for the selected channel. The probe attenuation factor may be 0.1 to 1000.
3 Commands by Subsystem :CHANnel:PROBe:ID (see page 530) Query Syntax :CHANnel:PROBe:ID? ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:PROBe:ID? query returns the type of probe attached to the specified oscilloscope channel.
3 Commands by Subsystem :CHANnel:PROBe:SKEW (see page 530) Command Syntax :CHANnel:PROBe:SKEW ::= skew time in NR3 format ::= -100 ns to +100 ns ::= {1 | 2 | 3 | 4} The :CHANnel:PROBe:SKEW command sets the channel- to- channel skew factor for the specified channel. Each analog channel can be adjusted + or - 100 ns for a total of 200 ns difference between channels.
Commands by Subsystem 3 :CHANnel:PROBe:STYPe (see page 530) Command Syntax NOTE This command is valid only for the 113xA Series probes.
3 Commands by Subsystem :CHANnel:PROTection (see page 530) Command Syntax :CHANnel:PROTection[:CLEar] ::= {1 | 2 | 3 | 4} When the analog channel input impedance is set to 50Ω, the input channels are protected against overvoltage. When an overvoltage condition is sensed, the input impedance for the channel is automatically changed to 1 MΩ. The :CHANnel:PROTection[:CLEar] command is used to clear (reset) the overload protection.
3 Commands by Subsystem :CHANnel:RANGe (see page 530) Command Syntax :CHANnel:RANGe [] ::= vertical full-scale range value in NR3 format ::= {V | mV} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:RANGe command defines the full- scale vertical axis of the selected channel. When using 1:1 probe attenuation, the range can be set to any value from: • 16 mV to 40 V.
3 Commands by Subsystem :CHANnel:SCALe (see page 530) Command Syntax :CHANnel:SCALe [] ::= vertical units per division in NR3 format ::= {V | mV} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:SCALe command sets the vertical scale, or units per division, of the selected channel. When using 1:1 probe attenuation, legal values for the scale range from: • 2 mV to 5 V.
3 Commands by Subsystem :CHANnel:UNITs (see page 530) Command Syntax :CHANnel:UNITs ::= {VOLT | AMPere} ::= {1 | 2} for the two channel oscilloscope models ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models The :CHANnel:UNITs command sets the measurement units for the connected probe. Select VOLT for a voltage probe and select AMPere for a current probe. Measurement results, channel sensitivity, and trigger level will reflect the measurement units you select.
3 Commands by Subsystem :CHANnel:VERNier (see page 530) Command Syntax :CHANnel:VERNier ::= {{1 | ON} | {0 | OFF} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:VERNier command specifies whether the channel's vernier (fine vertical adjustment) setting is ON (1) or OFF (0).
3 Commands by Subsystem :DISPlay Commands Control how waveforms, graticule, and text are displayed and written on the screen. See "Introduction to :DISPlay Commands" on page 161.
3 Commands by Subsystem • Set waveform persistence. • Specify 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 this case, the query was issued following a *RST command.
Commands by Subsystem 3 :DISPlay:CLEar (see page 530) Command Syntax :DISPlay:CLEar The :DISPlay:CLEar command clears the display and resets all associated measurements. If the oscilloscope is stopped, all currently displayed data is erased. If the oscilloscope is running, all of the data for active channels and functions is erased; however, new data is displayed on the next acquisition.
3 Commands by Subsystem :DISPlay:DATA (see page 530) Command Syntax :DISPlay:DATA [][,][][,][] ::= {TIFF} ::= {GRATicule} ::= {MONochrome} ::= binary block data in IEEE-488.2 # format. The :DISPlay:DATA command writes trace memory data (a display bitmap) to the display or to one of the trace memories in the instrument. If a data format or area is specified, the :DISPlay:DATA command transfers the data directly to the display.
Commands by Subsystem NOTE 3 If the format is TIFF, the only valid value area parameter is GRATicule, and the only valid palette parameter is MONOchrome. If the format is something other than TIFF, the only valid area parameter is SCReen, and the only valid values for palette are GRAYscale or COLor. Return Format ::= binary block data in IEEE-488.2 # format.
3 Commands by Subsystem :DISPlay:LABel (see page 530) Command Syntax :DISPlay:LABel ::= {{1 | ON} | {0 | OFF}} The :DISPlay:LABel command turns the analog and digital channel labels on and off. Query Syntax :DISPlay:LABel? The :DISPlay:LABel? query returns the display mode of the analog channel labels.
3 Commands by Subsystem :DISPlay:LABList (see page 530) Command Syntax :DISPlay:LABList ::= an ordered list of up to 75 labels, a maximum of six characters each, separated by newline characters. The :DISPlay:LABList command adds labels to the label list. Labels are added in alphabetical order. NOTE Query Syntax Labels that begin with the same alphabetic base string followed by decimal digits are considered duplicate labels.
3 Commands by Subsystem :DISPlay:PERSistence (see page 530) Command Syntax :DISPlay:PERSistence ::= {MINimum | INFinite} The :DISPlay:PERSistence command specifies the persistence 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 Syntax :DISPlay:PERSistence? The :DISPlay:PERSistence? query returns the specified persistence value.
3 Commands by Subsystem :DISPlay:SOURce (see page 530) Command Syntax :DISPlay:SOURce ::= {PMEMory0 | PMEMory1 | PMEMory2 | PMEMory3 | PMEMory4 | PMEMory5 | PMEMory6 | PMEMory7 | PMEMory8 | PMEMory9} PMEMory0-9 ::= pixel memory 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 Save/Recall menu.
3 Commands by Subsystem :DISPlay:VECTors (see page 530) Command Syntax :DISPlay:VECTors ::= {{1 | ON} | {0 | OFF}} The :DISPlay:VECTors 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. Query Syntax :DISPlay:VECTors? The :DISPlay:VECTors? query returns whether vector display is on or off.
3 Commands by Subsystem :EXTernal Trigger Commands Control the input characteristics of the external trigger input. See "Introduction to :EXTernal Trigger Commands" on page 171.
3 Commands by Subsystem The following is a sample response from the :EXTernal query. In this case, the query was issued following a *RST command. :EXT:BWL 0;IMP ONEM;RANG +8.0E+00;UNIT VOLT;PROB +1.
3 Commands by Subsystem :EXTernal:BWLimit (see page 530) Command Syntax :EXTernal:BWLimit ::= {0 | OFF} The :EXTernal:BWLimit command is provided for product compatibility. The only legal value is 0 or OFF. Use the :TRIGger:HFReject command to limit bandwidth on the external trigger input. Query Syntax :EXTernal:BWLimit? The :EXTernal:BWLimit? query returns the current setting of the low- pass filter (always 0).
3 Commands by Subsystem :EXTernal:IMPedance (see page 530) Command Syntax :EXTernal:IMPedance ::= {ONEMeg | FIFTy} The :EXTernal:IMPedance command selects the input impedance setting for the external trigger. The legal values for this command 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.
Commands by Subsystem 3 :EXTernal:PROBe (see page 530) Command Syntax :EXTernal:PROBe ::= probe attenuation ratio in NR3 format The :EXTernal:PROBe command specifies the probe attenuation factor for the external trigger. The probe attenuation factor may be 0.1 to 1000. This command does not change the actual input sensitivity of the oscilloscope. It changes the reference constants for scaling the display factors and for setting trigger levels.
3 Commands by Subsystem :EXTernal:PROBe:ID (see page 530) Query Syntax :EXTernal:PROBe:ID? The :EXTernal:PROBe:ID? query returns the type of probe attached to the external trigger input.
3 Commands by Subsystem :EXTernal:PROBe:STYPe (see page 530) Command Syntax NOTE This command is valid only for the 113xA Series probes. :EXTernal:PROBe:STYPe ::= {DIFFerential | SINGle} The :EXTernal:PROBe:STYPe command sets the external trigger probe signal type (STYPe) to differential or single- ended when using the 113xA Series probes and determines how offset is applied.
3 Commands by Subsystem :EXTernal:PROTection (see page 530) Command Syntax :EXTernal:PROTection[:CLEar] When the external trigger input impedance is set to 50Ω, the external trigger input is protected against overvoltage. When an overvoltage condition is sensed, the input impedance for the external trigger is automatically changed to 1 MΩ. The :EXTernal:PROTection[:CLEar] command is used to clear (reset) the overload protection.
3 Commands by Subsystem :EXTernal:RANGe (see page 530) Command Syntax :EXTernal:RANGe [] ::= vertical full-scale range value in NR3 format ::= {V | mV} The :EXTernal:RANGe command is provided for product compatibility. The range can only be set to 5.0 V when using 1:1 probe attenuation. If the probe attenuation is changed, the range value is multiplied by the probe attenuation factor.
3 Commands by Subsystem :EXTernal:UNITs (see page 530) Command Syntax :EXTernal:UNITs ::= {VOLT | AMPere} The :EXTernal:UNITs command sets the measurement units for the probe connected to the external trigger input. Select VOLT for a voltage probe and select AMPere for a current probe. Measurement results, channel sensitivity, and trigger level will reflect the measurement units you select.
3 Commands by Subsystem :FUNCtion Commands Control functions in the measurement/storage module. See "Introduction to :FUNCtion Commands" on page 182. Table 47 :FUNCtion Commands Summary Command Query Options and Query Returns :FUNCtion:CENTer (see page 183) :FUNCtion:CENTer? (see page 183) ::= the current center frequency in NR3 format. The range of legal values is from 0 Hz to 25 GHz.
3 Commands by Subsystem Table 47 :FUNCtion Commands Summary (continued) Command Query Options and Query Returns :FUNCtion:SOURce (see page 190) :FUNCtion:SOURce? (see page 190) ::= {CHANnel | ADD | SUBT | MULT} ::= 1-2 or 1-4 in NR1 format :FUNCtion:SPAN (see page 191) :FUNCtion:SPAN? (see page 191) ::= the current frequency span in NR3 format. Legal values are 1 Hz to 100 GHz.
3 Commands by Subsystem :FUNCtion:CENTer (see page 530) Command Syntax :FUNCtion:CENTer ::= the current center frequency in NR3 format. of legal values is from 0 Hz to 25 GHz. The range The :FUNCtion:CENTer command sets the center frequency when FFT (Fast Fourier Transform) is selected. Query Syntax :FUNCtion:CENTer? The :FUNCtion:CENTer? query returns the current center frequency in Hertz.
3 Commands by Subsystem :FUNCtion:DISPlay (see page 530) Command Syntax :FUNCtion:DISPlay ::= {{1 | ON} | {0 | OFF}} The :FUNCtion:DISPlay command turns the display of the function on or off. When ON is selected, the function performs as specified using the other FUNCtion commands. When OFF is selected, function is neither calculated nor displayed. Query Syntax :FUNCtion:DISPlay? The :FUNCtion:DISPlay? query returns whether the function display is on or off.
Commands by Subsystem 3 :FUNCtion:OFFSet (see page 530) Command Syntax :FUNCtion:OFFSet ::= the value at center screen in NR3 format. The :FUNCtion:OFFSet command sets the voltage or vertical value represented at center screen for the selected function. The range of legal values is generally +/- 10 times the current scale of the selected function, but will vary by function.
3 Commands by Subsystem :FUNCtion:OPERation (see page 530) Command Syntax :FUNCtion:OPERation ::= {SUBTract | MULTiply | 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:OPERation? query returns the current operation for the selected function.
3 Commands by Subsystem :FUNCtion:RANGe (see page 530) Command Syntax :FUNCtion:RANGe ::= the full-scale vertical axis value in NR3 format. The :FUNCtion:RANGe command defines the full- scale vertical axis for the selected function. Query Syntax :FUNCtion:RANGe? The :FUNCtion:RANGe? query returns the current full- scale range value for the selected function. Return Format ::= the full-scale vertical axis value in NR3 format.
3 Commands by Subsystem :FUNCtion:REFerence (see page 530) Command Syntax :FUNCtion:REFerence ::= the current reference level in NR3 format. The range of legal values is from - 400.0 dBV to +400.0 dBV depending on the current :FUNCtion:RANGe value. If you set the reference level to a value outside of the legal range, it is automatically set to the nearest legal value. The :FUNCtion:REFerence command is only used when an FFT (Fast Fourier Transform) operation is selected.
Commands by Subsystem 3 :FUNCtion:SCALe (see page 530) Command Syntax :FUNCtion:SCALe [] ::= integer in NR1 format ::= {V | dB} The :FUNCtion:SCALe command sets the vertical scale, or units per division, of the selected function. Legal values for the scale depend on the selected function. Query Syntax :FUNCtion:SCALe? The :FUNCtion:SCALe? query returns the current scale value for the selected function.
3 Commands by Subsystem :FUNCtion:SOURce (see page 530) Command Syntax :FUNCtion:SOURce ::= {CHANnel | ADD | SUBTract | MULTiply} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :FUNCtion:SOURce command is only used when an FFT (Fast Fourier Transform), DIFF, or INT operation is selected (see the:FUNCtion:OPERation command for more information about selecting an operation).
3 Commands by Subsystem :FUNCtion:SPAN (see page 530) Command Syntax :FUNCtion:SPAN ::= the current frequency span in NR3 format. Legal values are 1 Hz to 100 GHz. If you set the frequency span to a value outside of the legal range, the step size is automatically set to the nearest legal value. The :FUNCtion:SPAN command sets the frequency span of the display (left graticule to right graticule) when FFT (Fast Fourier Transform) is selected.
3 Commands by Subsystem :FUNCtion:WINDow (see page 530) Command Syntax :FUNCtion:WINDow ::= {RECTangular | HANNing | FLATtop} • The RECTangular window is useful for transient signals, and signals where there are an integral number of cycles in the time record. • The HANNing window is useful for frequency resolution and general purpose use. It is good for resolving two frequencies that are close together, or for making frequency measurements. This is the default window.
3 Commands by Subsystem :HARDcopy Commands Set and query the selection of hardcopy device and formatting options. See "Introduction to :HARDcopy Commands" on page 193.
3 Commands by Subsystem Reporting the Setup Use :HARDcopy? to query setup information for the HARDcopy subsystem. Return Format The following is a sample response from the :HARDcopy? query. In this case, the query was issued following the *RST command.
Commands by Subsystem 3 :HARDcopy:AREA (see page 530) Command Syntax :HARDcopy:AREA ::= SCReen The :HARDcopy:AREA command controls what part of the display area is printed. Currently, the only legal choice is SCReen. Query Syntax :HARDcopy:AREA? The :HARDcopy:AREA? query returns the selected display area.
3 Commands by Subsystem :HARDcopy:APRinter (see page 530) Command Syntax :HARDcopy:APRinter ::= { | } ::= integer index of printer in list ::= name of printer in list The :HARDcopy:APRinter command sets the active printer. Query Syntax :HARDcopy:APRinter? The :HARDcopy:APRinter? query returns the name of the active printer.
3 Commands by Subsystem :HARDcopy:FACTors (see page 530) Command Syntax :HARDcopy: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 indicating whether oscilloscope instrument settings are output on the hardcopy.
3 Commands by Subsystem :HARDcopy:FFEed (see page 530) Command Syntax :HARDcopy:FFEed ::= {{OFF | 0} | {ON | 1}} The HARDcopy:FFEed command controls whether a formfeed is output between the screen image and factors 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 returns a flag indicating whether a formfeed is output at the end of the hardcopy dump.
3 Commands by Subsystem :HARDcopy:INKSaver (see page 530) Command Syntax :HARDcopy:INKSaver ::= {{OFF | 0} | {ON | 1}} The HARDcopy:INKSaver command controls whether the graticule colors are inverted or not. Query Syntax :HARDcopy:INKSaver? The :HARDcopy:INKSaver? query returns a flag indicating whether graticule colors are inverted or not.
3 Commands by Subsystem :HARDcopy:PALette (see page 530) Command Syntax :HARDcopy:PALette ::= {COLor | GRAYscale | NONE} The HARDcopy:PALette command sets the hardcopy palette color. NOTE Query Syntax If no printer is connected, NONE is the only valid parameter. :HARDcopy:PALette? The :HARDcopy:PALette? query returns the selected hardcopy palette color.
Commands by Subsystem 3 :HARDcopy:PRinter:LIST (see page 530) Query Syntax :HARDcopy:PRinter:LIST? The :HARDcopy:PRinter:LIST? query returns a list of available printers. The list can be empty. Return Format ::= [] ...
3 Commands by Subsystem :HARDcopy:STARt (see page 530) Command Syntax :HARDcopy:STARt The :HARDcopy:STARt command starts a print job.
3 Commands by Subsystem :MARKer Commands Set and query the settings of X- axis markers (X1 and X2 cursors) and the Y- axis markers (Y1 and Y2 cursors). See "Introduction to :MARKer Commands" on page 204.
3 Commands by Subsystem Table 49 :MARKer Commands Summary (continued) Command Query Options and Query Returns :MARKer:Y2Position [suffix] (see page 212) :MARKer:Y2Position? (see page 212) ::= Y2 cursor position value in NR3 format [suffix] ::= {V | mV | dB} ::= Y2 cursor position value in NR3 format n/a :MARKer:YDELta? (see page 213) ::= Y cursors delta value in NR3 format Introduction to :MARKer Commands The MARKer subsystem commands set and qu
3 Commands by Subsystem :MARKer:MODE (see page 530) Command Syntax :MARKer:MODE ::= {OFF | MEASurement | MANual} The :MARKer:MODE command sets the cursors mode. OFF removes the cursor information from the display. MANual mode enables manual placement of the X and Y cursors. In MEASurement mode the cursors track the most recent measurement.
3 Commands by Subsystem :MARKer:X1Position (see page 530) Command Syntax :MARKer:X1Position [suffix] ::= X1 cursor position in NR3 format ::= {s | ms | us | ns | ps | Hz | kHz | MHz} The :MARKer:X1Position command sets :MARKer:MODE to MANual, sets the X1 cursor position and moves the X1 cursor to the specified value. Query Syntax :MARKer:X1Position? The :MARKer:X1Position? query returns the current X1 cursor position.
3 Commands by Subsystem :MARKer:X1Y1source (see page 530) Command Syntax :MARKer:X1Y1source ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MARKer:X1Y1source command sets the source for the cursors. The channel you specify must be enabled for cursors to be displayed. If the channel or function is not on, an error message is issued.
3 Commands by Subsystem :MARKer:X2Position (see page 530) Command Syntax :MARKer:X2Position [suffix] ::= X2 cursor position in NR3 format ::= {s | ms | us | ns | ps | Hz | kHz | MHz} The :MARKer:X2Position command sets :MARKer:MODE to MANual, sets the X2 cursor 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 returned.
Commands by Subsystem 3 :MARKer:X2Y2source (see page 530) Command Syntax :MARKer:X2Y2source ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MARKer:X2Y2source command sets the source for the cursors. The channel you specify must be enabled for cursors to be displayed. If the channel or function is not on, an error message is issued.
3 Commands by Subsystem :MARKer:XDELta (see page 530) Query Syntax :MARKer:XDELta? The MARKer:XDELta? query returns the value difference between the current X1 and X2 cursor positions. Xdelta = (Value at X2 cursor) - (Value at X1 cursor) NOTE Return Format If the front-panel cursors are off or are set to Binary or Hex Mode, the marker position values are not defined. Make sure to set :MARKer:MODE to MANual to put the cursors in the front-panel Normal mode.
3 Commands by Subsystem :MARKer:Y1Position (see page 530) Command Syntax :MARKer:Y1Position [suffix] ::= Y1 cursor position in NR3 format ::= {mV | V | dB} The :MARKer:Y1Position command sets :MARKer:MODE to MANual, sets the Y1 cursor position and moves the 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.
3 Commands by Subsystem :MARKer:Y2Position (see page 530) Command Syntax :MARKer:Y2Position [suffix] ::= Y2 cursor position in NR3 format ::= {mV | V | dB} The :MARKer:Y2Position command sets :MARKer:MODE to MANual, sets the Y2 cursor position and moves the 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.
3 Commands by Subsystem :MARKer:YDELta (see page 530) Query Syntax :MARKer:YDELta? The :MARKer:YDELta? query returns the value difference between the current Y1 and Y2 cursor positions. Ydelta = (Value at Y2 cursor) - (Value at Y1 cursor) NOTE Return Format If the front-panel cursors are off or are set to Binary or Hex Mode, the marker position values are not defined. Make sure to set :MARKer:MODE to MANual to put the cursors in the front-panel Normal mode.
3 Commands by Subsystem :MEASure Commands Select automatic measurements to be made and control time markers. See "Introduction to :MEASure Commands" on page 218.
3 Commands by Subsystem Table 50 :MEASure Commands Summary (continued) Command Query Options and Query Returns :MEASure:FREQuency [] (see page 229) :MEASure:FREQuency? [] (see page 229) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format ::= frequency in Hertz in NR3 format :MEASure:NWIDth [] (see page 230) :MEASure:NWIDth? [] (see page 230) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format
3 Commands by Subsystem Table 50 :MEASure Commands Summary (continued) Command Query Options and Query Returns :MEASure:RISEtime [] (see page 237) :MEASure:RISEtime? [] (see page 237) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format ::= rise time in seconds in NR3 format :MEASure:SDEViation [] (see page 238) :MEASure:SDEViation? [] (see page 238) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format <
3 Commands by Subsystem Table 50 :MEASure Commands Summary (continued) Command Query Options and Query Returns :MEASure:VAMPlitude [] (see page 246) :MEASure:VAMPlitude? [] (see page 246) ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format ::= the amplitude of the selected waveform in volts in NR3 format :MEASure:VAVerage [] (see page 247) :MEASure:VAVerage? [] (see page 247) ::= {CHANnel | FUNCtion | MATH} ::=
3 Commands by Subsystem Table 50 :MEASure Commands Summary (continued) Command Query Options and Query Returns n/a :MEASure:VTIMe? [,] (see page 253) ::= displayed time from trigger in seconds in NR3 format ::= voltage at the specified time in NR3 format ::= {CHANnel | FUNCtion | MATH} ::= 1-2 or 1-4 in NR1 format :MEASure:VTOP [] (see page 254) :MEASure:VTOP? [] (see page 254) ::= {CHANnel | FUNCtion | MATH} ::=
3 Commands by Subsystem If a measurement cannot be made (typically because the proper portion of the waveform is not displayed), the value +9.9E+37 is returned for that measurement. Making Measurements If more than one waveform, edge, or pulse is displayed, time measurements are made on the portion of the displayed waveform closest to the trigger reference (left, center, or right).
3 Commands by Subsystem :MEASure:CLEar (see page 530) Command Syntax :MEASure:CLEar This command clears all selected measurements and markers from the screen.
Commands by Subsystem 3 :MEASure:COUNter (see page 530) Command Syntax :MEASure:COUNter [] ::= CHANnel ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:COUNter command installs a screen measurement and starts a counter measurement. If the optional source parameter is specified, the current source is modified. Any channel except Math may be selected for the source.
3 Commands by Subsystem :MEASure:DEFine (see page 530) Command Syntax :MEASure:DEFine ::= {DELay | THResholds} The :MEASure:DEFine command sets up the definition for measurements by specifying the delta time or threshold values. Changing these values may affect the results of other measure commands. The table below identifies which measurement results that can be affected by redefining the DELay specification or the THResholds values.
3 Commands by Subsystem This command defines the behavior of the :MEASure:DELay? query by specifying the start and stop edge to be used. specifies the slope and edge number on source1. specifies the slope and edge number on source2.
3 Commands by Subsystem Return Format for = DELay: { | | ,} for = THResholds and = PERCent: THR,PERC,,, , , ::= A number specifying the upper, middle, and lower threshold percentage values between Vbase and Vtop in NR3 format.
3 Commands by Subsystem :MEASure:DELay (see page 530) Command Syntax :MEASure:DELay [][,] , ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:DELay command places the instrument in the continuous measurement mode and starts a delay measurement.
3 Commands by Subsystem Vtop. If you want to move the delay measurement point nearer to Vtop or Vbase, you must change the threshold values with the :MEASure:DEFine THResholds command.
3 Commands by Subsystem :MEASure:DUTYcycle (see page 530) Command Syntax :MEASure:DUTYcycle [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:DUTYcycle command installs a screen measurement and starts a duty cycle measurement on the current :MEASure:SOURce. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:FALLtime (see page 530) Command Syntax :MEASure:FALLtime [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:FALLtime command installs a screen measurement and starts a fall- time measurement. For highest measurement accuracy, set the sweep speed as fast as possible, while leaving the falling edge of the waveform on the display.
3 Commands by Subsystem :MEASure:FREQuency (see page 530) Command Syntax :MEASure:FREQuency [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:FREQuency command installs a screen measurement and starts a frequency measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:NWIDth (see page 530) Command Syntax :MEASure:NWIDth [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:NWIDth command installs a screen measurement and starts a negative pulse width measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:OVERshoot (see page 530) Command Syntax :MEASure:OVERshoot [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:OVERshoot command installs a screen measurement and starts an overshoot measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem • ":MEASure:VTOP" on page 254 • ":MEASure:VBASe" on page 248 • ":MEASure:VMIN" on page 250 232 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
3 Commands by Subsystem :MEASure:PERiod (see page 530) Command Syntax :MEASure:PERiod [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:PERiod command installs a screen measurement and starts the period measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:PHASe (see page 530) Command Syntax :MEASure:PHASe [][,] , ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:PHASe command places the instrument in the continuous measurement mode and starts a phase measurement.
Commands by Subsystem 3 :MEASure:PREShoot (see page 530) Command Syntax :MEASure:PREShoot [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:PREShoot command installs a screen measurement and starts a preshoot measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:PWIDth (see page 530) Command Syntax :MEASure:PWIDth [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:PWIDth command installs a screen measurement and starts the positive pulse width measurement. If the optional source parameter is specified, the current source is modified.
Commands by Subsystem 3 :MEASure:RISetime (see page 530) Command Syntax :MEASure: RISetime [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:RISetime command installs a screen measurement and starts a rise- time measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:SDEViation (see page 530) Command Syntax :MEASure:SDEViation [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:SDEViation command installs a screen measurement and starts std deviation measurement. If the optional source parameter is specified, the current source is modified.
Commands by Subsystem 3 :MEASure:SHOW (see page 530) Command Syntax :MEASure: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 returns the current state of the markers.
3 Commands by Subsystem :MEASure:SOURce (see page 530) Command Syntax :MEASure:SOURce [,] , ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:SOURce command sets the default sources for measurements. The specified sources are used as the sources for the MEASure subsystem commands if the sources are not explicitly set with the command.
3 Commands by Subsystem varQueryResult = myScope.ReadNumber ' Read duty cycle. MsgBox "Duty cycle:" + vbCrLf _ + FormatNumber(varQueryResult, 3) + "%" myScope.WriteString ":MEASURE:RISETIME?" ' Query 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. varQueryResult = myScope.ReadNumber ' Read VPP.
3 Commands by Subsystem :MEASure:TEDGe (see page 530) Query Syntax :MEASure:TEDGe? [,] ::= direction of the waveform. A rising slope is indicated by a space or plus sign (+). A falling edge is indicated by a minus sign (-). ::= the transition to be reported. If the occurrence number is one, the first crossing from the left screen edge is reported. If the number is two, the second crossing is reported, etc.
Commands by Subsystem Return Format 3 ::= time in seconds of the specified transition in NR3 format :MEASure:TEDGe Code ' Make a delay measurement between channel 1 and 2. Dim dblChan1Edge1 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 ":MEASURE:TEDGE? +1, CHAN1" ' Read time at edge 1 on ch 1. dblChan1Edge1 = myScope.
3 Commands by Subsystem :MEASure:TVALue (see page 530) Query Syntax :MEASure:TVALue? , [][,] ::= the vertical value that the waveform must cross. The value can be volts or a math function value such as dB, Vs, or V/s. ::= direction of the waveform. A rising slope is indicated by a plus sign (+). A falling edge is indicated by a minus sign (-). ::= the transition to be reported. If the occurrence number is one, the first crossing is reported.
Commands by Subsystem 3 ::= time in seconds of the specified value crossing in NR3 format See Also • "Introduction to :MEASure Commands" on page 218 • ":MEASure:TEDGe" on page 242 • ":MEASure:VTIMe" on page 253 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 245
3 Commands by Subsystem :MEASure:VAMPlitude (see page 530) Command Syntax :MEASure:VAMPlitude [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:VAMPlitude command installs a screen measurement and starts a vertical amplitude measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:VAVerage (see page 530) Command Syntax :MEASure:VAVerage [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:VAVerage command installs a screen measurement and starts an average value measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:VBASe (see page 530) Command Syntax :MEASure:VBASe [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:VBASe command installs a screen measurement and starts a waveform base value measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:VMAX (see page 530) Command Syntax :MEASure:VMAX [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:VMAX command installs a screen measurement and starts a maximum vertical value measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:VMIN (see page 530) Command Syntax :MEASure:VMIN [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:VMIN command installs a screen measurement and starts a minimum vertical value measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:VPP (see page 530) Command Syntax :MEASure:VPP [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:VPP command installs a screen measurement and starts a vertical peak- to- peak measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:VRMS (see page 530) Command Syntax :MEASure:VRMS [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:VRMS command installs a screen measurement and starts a dc RMS value measurement. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:VTIMe (see page 530) Query Syntax :MEASure:VTIMe? [,] ::= time from trigger in seconds ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:VTIMe? query returns the value at a specified time on the source specified with :MEASure:SOURce.
3 Commands by Subsystem :MEASure:VTOP (see page 530) Command Syntax :MEASure:VTOP [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:VTOP command installs a screen measurement and starts a waveform top value measurement. NOTE Query Syntax This query is not available if the source is FFT (Fast Fourier Transform).
3 Commands by Subsystem :MEASure:XMAX (see page 530) Command Syntax :MEASure:XMAX [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:XMAX command installs a screen measurement and starts an X- at- Max- Y measurement on the selected window. If the optional source parameter is specified, the current source is modified.
3 Commands by Subsystem :MEASure:XMIN (see page 530) Command Syntax :MEASure:XMIN [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:XMIN command installs a screen measurement and starts an X- at- Min- Y measurement on the selected window. If the optional source parameter is specified, the current source is modified.
Commands by Subsystem 3 :RECall Commands Recall previously saved oscilloscope setups and traces. See "Introduction to :RECall Commands" on page 257.
3 Commands by Subsystem :RECall:FILename (see page 530) Command Syntax :RECall:FILename ::= quoted ASCII string The :RECall:FILename command specifies the source for any RECall operations. NOTE Query Syntax This command specifies a file's base name only, without path information or an extension. :RECall:FILename? The :RECall:FILename? query returns the current RECall filename.
Commands by Subsystem 3 :RECall:IMAGe[:STARt] (see page 530) Command Syntax :RECall:IMAGe[:STARt] [] ::= { | } ::= 0-9; an integer in NR1 format ::= quoted ASCII string The :RECall:IMAGe[:STARt] command recalls a trace (TIFF) image. NOTE See Also If a file extension is provided as part of a specified , it must be ".tif".
3 Commands by Subsystem :RECall:PWD (see page 530) Query Syntax :RECall:PWD? The :RECall:PWD? query returns the current recall path information.
Commands by Subsystem 3 :RECall:SETup[:STARt] (see page 530) Command Syntax :RECall:SETup[:STARt] [] ::= { | } ::= 0-9; an integer in NR1 format ::= quoted ASCII string The :RECall:SETup[:STARt] command recalls an oscilloscope setup. NOTE See Also If a file extension is provided as part of a specified , it must be ".scp".
3 Commands by Subsystem :SAVE Commands Save oscilloscope setups and traces, screen images, and data. See "Introduction to :SAVE Commands" on page 263.
3 Commands by Subsystem Table 52 :SAVE Commands Summary (continued) Command Query Options and Query Returns :SAVE:WAVeform:FORMat (see page 274) :SAVE:WAVeform:FORMat ? (see page 274) ::= {ALB | ASCiixy | CSV | BINary | NONE} :SAVE:WAVeform:LENGth (see page 275) :SAVE:WAVeform:LENGth ? (see page 275) ::= 100 to max.
3 Commands by Subsystem :SAVE:FILename (see page 530) Command Syntax :SAVE:FILename ::= quoted ASCII string The :SAVE:FILename command specifies the source for any SAVE operations. NOTE Query Syntax This command specifies a file's base name only, without path information or an extension. :SAVE:FILename? The :SAVE:FILename? query returns the current SAVE filename.
Commands by Subsystem 3 :SAVE:IMAGe[:STARt] (see page 530) Command Syntax :SAVE:IMAGe[:STARt] [] ::= { | } ::= 0-9; an integer in NR1 format ::= quoted ASCII string The :SAVE:IMAGe[:STARt] command saves an image. NOTE If a file extension is provided as part of a specified , it must match the extension expected by the format specified in :SAVE:IMAGe:FORMat.
3 Commands by Subsystem :SAVE:IMAGe:AREA (see page 530) Command Syntax :SAVE:IMAGe:AREA ::= {GRATicule | SCReen} The :SAVE:IMAGe:AREA command sets the area that will be saved as part of the image. If the :SAVE:IMAGe:FORMat is TIFF, the area is GRATicule. Otherwise, it is SCReen. Query Syntax :SAVE:IMAGe:AREA? The :SAVE:IMAGe:AREA? query returns the selected image area.
Commands by Subsystem 3 :SAVE:IMAGe:FACTors (see page 530) Command Syntax :SAVE:IMAGe:FACTors ::= {{OFF | 0} | {ON | 1}} The :SAVE:IMAGe:FACTors command controls whether the oscilloscope factors are output along with the image. NOTE Query Syntax Factors are written to a separate file with the same path and base name but with the ".txt" extension.
3 Commands by Subsystem :SAVE:IMAGe:FORMat (see page 530) Command Syntax :SAVE:IMAGe:FORMat ::= {TIFF | {BMP | BMP24bit} | BMP8bit | PNG} The :SAVE:IMAGe:FORMat command sets the image format type. Query Syntax :SAVE:IMAGe:FORMat? The :SAVE:IMAGe:FORMat? query returns the selected image format type. Return Format ::= {TIFF | BMP | BMP8 | PNG | NONE} When NONE is returned, it indicates that a waveform data file format is currently selected.
Commands by Subsystem 3 :SAVE:IMAGe:INKSaver (see page 530) Command Syntax :SAVE:IMAGe:INKSaver ::= {{OFF | 0} | {ON | 1}} The :SAVE:IMAGe:INKSaver command controls whether the graticule colors are inverted or not. Query Syntax :SAVE:IMAGe:INKSaver? The :SAVE:IMAGe:INKSaver? query returns a flag indicating whether graticule colors are inverted or not.
3 Commands by Subsystem :SAVE:IMAGe:PALette (see page 530) Command Syntax :SAVE:IMAGe:PALette ::= {COLor | GRAYscale | MONochrome} The :SAVE:IMAGe:PALette command sets the image palette color. NOTE Query Syntax MONochrome is the only valid choice when the :SAVE:IMAGe:FORMat is TIFF. COLor and GRAYscale are the only valid choices when the format is not TIFF. :SAVE:IMAGe:PALette? The :SAVE:IMAGe:PALette? query returns the selected image palette color.
Commands by Subsystem 3 :SAVE:PWD (see page 530) Query Syntax :SAVE:PWD? The :SAVE:PWD? query returns the current save path information.
3 Commands by Subsystem :SAVE:SETup[:STARt] (see page 530) Command Syntax :SAVE:SETup[:STARt] [] ::= { | } ::= 0-9; an integer in NR1 format ::= quoted ASCII string The :SAVE:SETup[:STARt] command saves an oscilloscope setup. NOTE See Also If a file extension is provided as part of a specified , it must be ".scp".
3 Commands by Subsystem :SAVE:WAVeform[:STARt] (see page 530) Command Syntax :SAVE:WAVeform[:STARt] [] ::= quoted ASCII string The :SAVE:WAVeform[:STARt] command saves oscilloscope waveform data to a file. NOTE See Also If a file extension is provided as part of a specified , it must match the extension expected by the format specified in :SAVE:WAVeform:FORMat.
3 Commands by Subsystem :SAVE:WAVeform:FORMat (see page 530) Command Syntax :SAVE:WAVeform:FORMat ::= {ALB | ASCiixy | CSV | BINary} The :SAVE:WAVeform:FORMat command sets the waveform data format type: • ALB — creates an Agilent module binary format file. These files can be viewed offline by the Agilent Logic Analyzer application software. The proper file extension for this format is ".alb".
3 Commands by Subsystem :SAVE:WAVeform:LENGth (see page 530) Command Syntax :SAVE:WAVeform:LENGth ::= 100 to max. length; an integer in NR1 format The :SAVE:WAVeform:LENGth command sets the waveform data length (that is, the number of points saved). Query Syntax :SAVE:WAVeform:LENGth? The :SAVE:WAVeform:LENGth? query returns the specified waveform data length. Return Format ::= 100 to max.
3 Commands by Subsystem :SBUS Commands Control oscilloscope functions associated with the serial decode bus. See "Introduction to :SBUS Commands" on page 277.
3 Commands by Subsystem Table 53 :SBUS Commands Summary (continued) Command Query Options and Query Returns n/a :SBUS:UART:COUNt:TXFR ames? (see page 292) ::= integer in NR1 format :SBUS:UART:FRAMing (see page 293) :SBUS:UART:FRAMing? (see page 293) ::= {OFF | | } ::= 8-bit integer from 0-255 (0x00-0xff) ::= #Hnn where n ::= {0,..,9 | A,..,F} for hexadecimal ::= #Bnn...
3 Commands by Subsystem :SBUS:CAN:COUNt:ERRor (see page 530) Query Syntax :SBUS:CAN:COUNt:ERRor? Returns the error frame count.
Commands by Subsystem 3 :SBUS:CAN:COUNt:OVERload (see page 530) Query Syntax :SBUS:CAN:COUNt:OVERload? Returns the overload frame count.
3 Commands by Subsystem :SBUS:CAN:COUNt:RESet (see page 530) Command Syntax :SBUS:CAN:COUNt:RESet Resets the frame counters.
Commands by Subsystem 3 :SBUS:CAN:COUNt:TOTal (see page 530) Query Syntax :SBUS:CAN:COUNt:TOTal? Returns the total frame count.
3 Commands by Subsystem :SBUS:CAN:COUNt:UTILization (see page 530) Query Syntax :SBUS:CAN:COUNt:UTILization? Returns the percent utilization.
Commands by Subsystem 3 :SBUS:DISPlay (see page 530) Command Syntax :SBUS:DISPlay ::= {{1 | ON} | {0 | OFF}} The :SBUS:DISPlay command turns displaying of the serial decode bus on or off. NOTE Query Syntax This command is only valid on 4 (analog) channel oscilloscope models when a serial decode option has been licensed. :SBUS:DISPlay? The :SBUS:DISPlay? query returns the current display setting of the serial decode bus.
3 Commands by Subsystem :SBUS:IIC:ASIZe (see page 530) Command Syntax :SBUS:IIC:ASIZe ::= {BIT7 | BIT8} The :SBUS:IIC:ASIZe command determines whether the Read/Write bit is included as the LSB in the display of the IIC address field of the decode bus. NOTE Query Syntax This command is only valid on 4 (analog) channel oscilloscope models when the low-speed IIC and SPI serial decode option (Option LSS) has been licensed.
3 Commands by Subsystem :SBUS:LIN:PARity (see page 530) Command Syntax :SBUS:LIN:PARity ::= {{1 | ON} | {0 | OFF}} The :SBUS:LIN:PARity command determines whether the parity bits are included as the most significant bits (MSB) in the display of the Frame Id field in the LIN decode bus. NOTE Query Syntax This command is only valid on 4 (analog) channel oscilloscope models when the automotive CAN and LIN serial decode option (Option AMS) has been licensed.
3 Commands by Subsystem :SBUS:MODE (see page 530) Command Syntax :SBUS:MODE ::= {IIC | SPI | CAN | LIN | UART} The :SBUS:MODE command determines the decode mode for the serial bus. NOTE Query Syntax This command is only valid on 4 (analog) channel oscilloscope models when a serial decode option has been licensed. :SBUS:MODE? The :SBUS:MODE? query returns the current serial bus decode mode setting.
Commands by Subsystem 3 :SBUS:SPI:WIDTh (see page 530) Command Syntax :SBUS:SPI:WIDTh ::= integer 4-16 in NR1 format The :SBUS:SPI:WIDTh command determines the number of bits in a word of data for SPI. NOTE Query Syntax This command is only valid on 4 (analog) channel oscilloscope models when the low-speed IIC and SPI serial decode option (Option LSS) has been licensed. :SBUS:SPI:WIDTh? The :SBUS:SPI:WIDTh? query returns the current SPI decode word width.
3 Commands by Subsystem :SBUS:UART:BASE (see page 530) Command Syntax :SBUS:UART:BASE ::= {ASCii | BINary | HEX} The :SBUS:UART:BASE command determines the base to use for the UART decode display. NOTE Query Syntax This command is only valid on 4 (analog) channel oscilloscope models when the UART/RS-232 triggering and serial decode option (Option 232) has been licensed. :SBUS:UART:BASE? The :SBUS:UART:BASE? query returns the current UART decode base setting.
Commands by Subsystem 3 :SBUS:UART:COUNt:ERRor (see page 530) Query Syntax :SBUS:UART:COUNt:ERRor? Returns the UART error frame count. NOTE Return Format This command is only valid on 4 (analog) channel oscilloscope models when the UART/RS-232 triggering and serial decode option (Option 232) has been licensed.
3 Commands by Subsystem :SBUS:UART:COUNt:RESet (see page 530) Command Syntax :SBUS:UART:COUNt:RESet Resets the UART frame counters. NOTE Errors See Also This command is only valid on 4 (analog) channel oscilloscope models when the UART/RS-232 triggering and serial decode option (Option 232) has been licensed.
Commands by Subsystem 3 :SBUS:UART:COUNt:RXFRames (see page 530) Query Syntax :SBUS:UART:COUNt:RXFRames? Returns the UART Rx frame count. NOTE Return Format This command is only valid on 4 (analog) channel oscilloscope models when the UART/RS-232 triggering and serial decode option (Option 232) has been licensed.
3 Commands by Subsystem :SBUS:UART:COUNt:TXFRames (see page 530) Query Syntax :SBUS:UART:COUNt:TXFRames? Returns the UART Tx frame count. NOTE Return Format This command is only valid on 4 (analog) channel oscilloscope models when the UART/RS-232 triggering and serial decode option (Option 232) has been licensed.
3 Commands by Subsystem :SBUS:UART:FRAMing (see page 530) Command Syntax :SBUS:UART:FRAMing ::= {OFF | | } ::= 8-bit integer in decimal from 0-255 (0x00-0xff) ::= #Hnn where n ::= {0,..,9 | A,..,F} for hexadecimal ::= #Bnn...n where n ::= {0 | 1} for binary The :SBUS:UART:FRAMing command determines the byte value to use for framing (end of packet) or to turn off framing for UART decode.
3 Commands by Subsystem :SYSTem Commands Control basic system functions of the oscilloscope. See "Introduction to :SYSTem Commands" on page 294. Table 54 :SYSTem Commands Summary Command Query Options and Query Returns :SYSTem:DATE (see page 295) :SYSTem:DATE? (see page 295) ::= ,, ::= 4-digit year in NR1 format ::= {1,..,12 | JANuary | FEBruary | MARch | APRil | MAY | JUNe | JULy | AUGust | SEPtember | OCTober | NOVember | DECember} ::= {1,..
Commands by Subsystem 3 :SYSTem:DATE (see page 530) Command Syntax :SYSTem:DATE ::= ,, ::= 4-digit year in NR1 format ::= {1,..,12 | JANuary | FEBruary | MARch | APRil | MAY | JUNe | JULy | AUGust | SEPtember | OCTober | NOVember | DECember} ::= {1,..,31} The :SYSTem:DATE command sets the date. Validity checking is performed to ensure that the date is valid. Query Syntax :SYSTem:DATE? The SYSTem:DATE? query returns the date.
3 Commands by Subsystem :SYSTem:DSP (see page 530) Command Syntax :SYSTem:DSP ::= quoted ASCII string (up to 254 characters) The :SYSTem:DSP command writes the quoted string (excluding quotation marks) to a text box in the center of the display. Use :SYStem:DSP "" to remotely remove the message from the display. (Two sets of quote marks without a space between them creates a NULL string.) Press any menu key to manually remove the message from the display.
Commands by Subsystem 3 :SYSTem:ERRor (see page 530) Query Syntax :SYSTem:ERRor? The :SYSTem:ERRor? query outputs the next error number and text from the error queue. The instrument has an error queue that is 30 errors deep and operates on a first- in, first- out basis. 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.
3 Commands by Subsystem :SYSTem:LOCK (see page 530) Command Syntax :SYSTem:LOCK ::= {{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 returns the lock status of the front panel.
Commands by Subsystem 3 :SYSTem:SETup (see page 530) Command Syntax :SYSTem:SETup ::= binary block data in IEEE 488.2 # format. The :SYSTem:SETup command sets the oscilloscope as defined by the data in the setup (learn) string sent from the controller. The setup string does not change the interface mode or interface address. Query Syntax :SYSTem:SETup? The :SYSTem:SETup? query operates the same as the *LRN? query.
3 Commands by Subsystem ' Write setup string back to oscilloscope using ":SYSTEM:SETUP" ' command: myScope.
Commands by Subsystem 3 :SYSTem:TIME (see page 530) Command Syntax :SYSTem:TIME
3 Commands by Subsystem :TIMebase Commands Control all horizontal sweep functions. See "Introduction to :TIMebase Commands" on page 302.
Commands by Subsystem 3 Use :TIMebase? to query setup information for the TIMebase subsystem. Return Format The following is a sample response from the :TIMebase? query. In this case, the query was issued following a *RST command. :TIM:MODE MAIN;REF CENT;MAIN:RANG +1.00E-03;POS +0.
3 Commands by Subsystem :TIMebase:MODE (see page 530) Command Syntax :TIMebase:MODE ::= {MAIN | WINDow | XY | ROLL} The :TIMebase:MODE command sets the current time base. There are four time base modes: • MAIN — The normal time base mode is the main time base. It is the default time base mode after the *RST (Reset) command.
3 Commands by Subsystem :TIMebase:POSition (see page 530) Command Syntax :TIMebase:POSition ::= time in seconds from the trigger to the display reference in NR3 format The :TIMebase:POSition command sets the time interval between the trigger event and the display reference point on the screen. The display reference point is either left, right, or center and is set with the :TIMebase:REFerence command. The maximum position value depends on the time/division settings.
3 Commands by Subsystem :TIMebase:RANGe (see page 530) Command Syntax :TIMebase:RANGe ::= 10 ns through 500 s in NR3 format The :TIMebase:RANGe command sets the full- scale horizontal time in seconds for the main window. The range is 10 times the current time- per- division setting. Query Syntax :TIMebase:RANGe? The :TIMebase:RANGe query returns the current full- scale range value for the main window.
Commands by Subsystem 3 :TIMebase:REFerence (see page 530) Command Syntax :TIMebase:REFerence ::= {LEFT | CENTer | RIGHt} The :TIMebase:REFerence command sets the time reference to one division from the left side of the screen, to the center of the screen, or to one division from the right side of the screen. Time reference is the point on the display where the trigger point is referenced.
3 Commands by Subsystem :TIMebase:SCALe (see page 530) Command Syntax :TIMebase:SCALe ::= 1 ns through 50 s in NR3 format The :TIMebase:SCALe command sets the horizontal scale or units per division for the main window. Query Syntax :TIMebase:SCALe? The :TIMebase:SCALe? query returns the current horizontal scale setting in seconds per division for the main window.
3 Commands by Subsystem :TIMebase:VERNier (see page 530) Command Syntax :TIMebase:VERNier ::= {{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 returns the current state of the time base control's vernier setting.
3 Commands by Subsystem :TIMebase:WINDow:POSition (see page 530) Command Syntax :TIMebase:WINDow:POSition ::= time from the trigger event to the delayed view reference point in NR3 format The :TIMebase:WINDow:POSition command sets the horizontal position in the delayed view of the main sweep. The main sweep range and the 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.
Commands by Subsystem 3 :TIMebase:WINDow:RANGe (see page 530) Command Syntax :TIMebase:WINDow:RANGe ::= range value in seconds in NR3 format The :TIMebase:WINDow:RANGe command sets the full- scale horizontal time in seconds for the delayed 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 value.
3 Commands by Subsystem :TIMebase:WINDow:SCALe (see page 530) Command Syntax :TIMebase:WINDow:SCALe ::= scale value in seconds in NR3 format The :TIMebase:WINDow:SCALe command sets the delayed window horizontal scale (seconds/division). The main sweep scale determines the range for this command. The maximum value is one half of the :TIMebase:SCALe value. Query Syntax :TIMebase:WINDow:SCALe? The :TIMebase:WINDow:SCALe? query returns the current delayed window scale setting.
3 Commands by Subsystem :TRIGger Commands Control the trigger modes and parameters for each trigger type.
3 Commands by Subsystem • CAN (Controller Area Network) triggering will trigger on CAN version 2.0A and 2.0B signals. Setup consists of connecting the oscilloscope to a CAN signal. Baud rate, signal source, and signal polarity, and type of data to trigger on can be specified.
Commands by Subsystem 3 Use :TRIGger? to query setup information for the TRIGger subsystem. Return Format The return format for the TRIGger? query varies depending on the current mode. The following is a sample response from the :TRIGger? query. In this case, the query was issued following a *RST command. :TRIG:MODE EDGE;SWE AUTO;NREJ 0;HFR 0;HOLD +60.0000000000000E-09; :TRIG:EDGE:SOUR CHAN1;LEV +0.
3 Commands by Subsystem General :TRIGger Commands Table 56 General :TRIGger Commands Summary Command Query Options and Query Returns :TRIGger:HFReject {{0 | OFF} | {1 | ON}} (see page 317) :TRIGger:HFReject? (see page 317) {0 | 1} :TRIGger:HOLDoff (see page 318) :TRIGger:HOLDoff? (see page 318) ::= 60 ns to 10 s in NR3 format :TRIGger:MODE (see page 319) :TRIGger:MODE? (see page 319) ::= {EDGE | GLITch | PATTern | DURation | TV} ::= {
3 Commands by Subsystem :TRIGger:HFReject (see page 530) Command Syntax :TRIGger:HFReject ::= {{0 | OFF} | {1 | ON}} The :TRIGger:HFReject command turns the high frequency reject filter off and on. The high frequency 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 broadcast stations, from the trigger path.
3 Commands by Subsystem :TRIGger:HOLDoff (see page 530) Command Syntax :TRIGger:HOLDoff ::= 60 ns to 10 s in NR3 format The :TRIGger:HOLDoff command defines the holdoff time value in seconds. Holdoff keeps a trigger from occurring until after a certain amount of time has passed since the last trigger. This feature is valuable when a waveform crosses the trigger level multiple times during one period of the waveform.
3 Commands by Subsystem :TRIGger:MODE (see page 530) Command Syntax :TRIGger:MODE 1234567890123456789012345678901234567890123456789012345678901234567890 ::= {EDGE | GLITch | PATTern | CAN | DURation | IIC | LIN | SPI | TV | USB | FLEXray | UART} The :TRIGger:MODE command selects the trigger mode (trigger type). Query Syntax :TRIGger:MODE? The :TRIGger:MODE? query returns the current trigger mode. If the :TIMebase:MODE is ROLL or XY, the query returns "NONE.
3 Commands by Subsystem :TRIGger:NREJect (see page 530) Command Syntax :TRIGger:NREJect ::= {{0 | OFF} | {1 | ON}} The :TRIGger:NREJect command turns the noise reject filter off and on. When the noise reject filter is on, the trigger circuitry is less sensitive to noise but may require a greater amplitude waveform to trigger the oscilloscope. This command is not valid in TV trigger mode.
3 Commands by Subsystem :TRIGger:PATTern (see page 530) Command Syntax :TRIGger:PATTern ::= , [, , ] ::= integer in NR1 format or ::= integer in NR1 format or ::= "0xnn"; n ::= {0,..,9 | A,..
3 Commands by Subsystem • ":TRIGger:MODE" on page 319 322 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands by Subsystem 3 :TRIGger:SWEep (see page 530) Command Syntax :TRIGger:SWEep ::= {AUTO | NORMal} The :TRIGger:SWEep command selects the trigger sweep mode. When AUTO sweep mode is selected, a baseline is displayed in the absence of a signal. If a signal is present but the oscilloscope is not triggered, the unsynchronized signal is displayed instead of a baseline.
3 Commands by Subsystem :TRIGger:CAN Commands Table 57 :TRIGger:CAN Commands Summary Command Query Options and Query Returns :TRIGger:CAN:PATTern: DATA , (see page 326) :TRIGger:CAN:PATTern: DATA? (see page 326) ::= 64-bit integer in decimal, , or (with Option AMS) ::= 64-bit integer in decimal, , or ::= #Hnn...n where n ::= {0,..,9 | A,..,F} for hexadecimal ::= #Bnn...
3 Commands by Subsystem Table 57 :TRIGger:CAN Commands Summary (continued) Command Query Options and Query Returns :TRIGger:CAN:SOURce (see page 332) :TRIGger:CAN:SOURce? (see page 332) ::= {CHANnel | EXTernal} for DSO models ::= {CHANnel | DIGital0,..
3 Commands by Subsystem :TRIGger:CAN:PATTern:DATA (see page 530) Command Syntax :TRIGger:CAN:PATTern:DATA , ::= 64-bit integer in decimal, , or ::= 64-bit integer in decimal, , or ::= #Hnn...n where n ::= {0,..,9 | A,..,F} for hexadecimal ::= #Bnn...n where n ::= {0 | 1} for binary ::= "0xnn...n" where n ::= {0,..,9 | A,..
Commands by Subsystem 3 :TRIGger:CAN:PATTern:DATA:LENGth (see page 530) Command Syntax :TRIGger:CAN:PATTern:DATA:LENGth ::= integer from 1 to 8 in NR1 format The :TRIGger:CAN:PATTern:DATA:LENGth command sets the number of 8- bit bytes in the CAN data string. The number of bytes in the string can be anywhere from 0 bytes to 8 bytes (64 bits). The value for these bytes is set by the :TRIGger:CAN:PATTern:DATA command.
3 Commands by Subsystem :TRIGger:CAN:PATTern:ID (see page 530) Command Syntax :TRIGger:CAN:PATTern:ID , ::= 32-bit integer in decimal, , or ::= 32-bit integer in decimal, , or ::= #Hnn...n where n ::= {0,..,9 | A,..,F} for hexadecimal ::= #Bnn...n where n ::= {0 | 1} for binary ::= "0xnn...n" where n ::= {0,..,9 | A,..
3 Commands by Subsystem :TRIGger:CAN:PATTern:ID:MODE (see page 530) Command Syntax :TRIGger:CAN:PATTern:ID:MODE ::= {STANdard | EXTended} The :TRIGger:CAN:PATTern:ID:MODE command sets the CAN identifier mode. STANdard selects the standard 11- bit identifier. EXTended selects the extended 29- bit identifier. The CAN identifier is set by the :TRIGger:CAN:PATTern:ID command.
3 Commands by Subsystem :TRIGger:CAN:SAMPlepoint (see page 530) Command Syntax :TRIGger:CAN:SAMPlepoint ::= {60 | 62.5 | 68 | 70 | 75 | 80 | 87.5} in NR3 format The :TRIGger:CAN:SAMPlepoint command sets the point during the bit time where the bit level is sampled to determine whether the bit is dominant or recessive. The sample point represents the percentage of time between the beginning of the bit time to the end of the bit time.
3 Commands by Subsystem :TRIGger:CAN:SIGNal:BAUDrate (see page 530) Command Syntax :TRIGger:CAN:SIGNal:BAUDrate ::= integer in NR1 format ::= {10000 | 20000 | 33300 | 50000 | 62500 | 83300 | 100000 | 125000 | 250000 | 500000 | 800000 |1000000} The :TRIGger:CAN:SIGNal:BAUDrate command sets the standard baud rate of the CAN signal from 10 kb/s to 1 Mb/s. If a non- standard baud rate is sent, the baud rate will be set to the next highest standard rate.
3 Commands by Subsystem :TRIGger:CAN:SOURce (see page 530) Command Syntax :TRIGger:CAN:SOURce ::= {CHANnel | EXTernal} for the DSO models ::= {CHANnel | DIGital0,..,DIGital15} for the MSO models ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {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 (start of frame).
3 Commands by Subsystem :TRIGger:CAN:TRIGger (see page 530) Command Syntax :TRIGger:CAN:TRIGger ::= {SOF | DATA | ERRor | IDData | IDEither | IDRemote | ALLerrors | OVERload | ACKerror} The :TRIGger:CAN:TRIGger command sets the CAN trigger on condition: • SOF - will trigger on the Start of Frame (SOF) bit of a Data frame, Remote Transfer Request (RTR) frame, or an Overload frame.
3 Commands by Subsystem CAN Id specification is set by the :TRIGger:CAN:PATTern:ID and:TRIGger:CAN:PATTern:ID:MODE commands. CAN Data specification is set by the :TRIGger:CAN:PATTern:DATA command. CAN Data Length Code is set by the :TRIGger:CAN:PATTern:DATA:LENGth command. NOTE Query Syntax SOF is the only valid selection for analog oscilloscopes. If the automotive CAN and LIN serial decode option (Option AMS) has not been licensed, SOF is the only valid selection.
3 Commands by Subsystem :TRIGger:DURation Commands Table 58 :TRIGger:DURation Commands Summary Command Query Options and Query Returns :TRIGger:DURation:GRE aterthan [suffix] (see page 336) :TRIGger:DURation:GRE aterthan? (see page 336) ::= floating-point number from 5 ns to 10 seconds in NR3 format [suffix] ::= {s | ms | us | ns | ps} :TRIGger:DURation:LES Sthan [suffix] (see page 337) :TRIGger:DURation:LES Sthan? (see page 337)
3 Commands by Subsystem :TRIGger:DURation:GREaterthan (see page 530) Command Syntax :TRIGger:DURation:GREaterthan [] ::= minimum trigger duration in seconds (5 ns - 10 seconds) in NR3 format ::= {s | ms | us | ns | ps } The :TRIGger:DURation:GREaterthan command sets the minimum duration for the defined pattern when :TRIGger:DURation:QUALifier is set to GREaterthan.
Commands by Subsystem 3 :TRIGger:DURation:LESSthan (see page 530) Command Syntax :TRIGger:DURation:LESSthan [] ::= maximum trigger duration in seconds (5 ns - 10 seconds) in NR3 format ::= {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.
3 Commands by Subsystem :TRIGger:DURation:PATTern (see page 530) Command Syntax :TRIGger:DURation:PATTern , ::= integer or ::= integer or ::= "0xnnnnnn"; n ::= {0,..,9 | A,..,F} The :TRIGger:DURation:PATTern command defines the specified duration pattern resource according to the value and the mask. For both and , each bit corresponds to a possible trigger channel.
3 Commands by Subsystem :TRIGger:DURation:QUALifier (see page 530) Command Syntax :TRIGger:DURation:QUALifier ::= {GREaterthan | LESSthan | INRange | OUTRange | TIMeout} The :TRIGger:DURation:QUALifier command qualifies the trigger duration. Set the GREaterthan qualifier value with the :TRIGger:DURation:GREaterthan command. Set the LESSthan qualifier value with the :TRIGger:DURation:LESSthan command.
3 Commands by Subsystem :TRIGger:DURation:RANGe (see page 530) Command Syntax :TRIGger:DURation:RANGe [], [] ::= minimum duration in seconds (10 ns - 9.
3 Commands by Subsystem :TRIGger[:EDGE] Commands Table 59 :TRIGger[:EDGE] Commands Summary Command Query Options and Query Returns :TRIGger[:EDGE]:COUPl ing {AC | DC | LF} (see page 342) :TRIGger[:EDGE]:COUPl ing? (see page 342) {AC | DC | LF} :TRIGger[:EDGE]:LEVel [,] (see page 343) :TRIGger[:EDGE]:LEVel ? [] (see page 343) For internal triggers, ::= .75 x full-scale voltage from center screen in NR3 format.
3 Commands by Subsystem :TRIGger[:EDGE]:COUPling (see page 530) Command Syntax :TRIGger[:EDGE]:COUPling ::= {AC | DC | LFReject} The :TRIGger[:EDGE]:COUPling command sets the input coupling for the selected trigger sources. The coupling can be set to AC, DC, or LFReject. • AC coupling places a high- pass filter (10 Hz for analog channels, and 3.5 Hz for all External trigger inputs) in the trigger path, removing dc offset voltage from the trigger waveform.
3 Commands by Subsystem :TRIGger[:EDGE]:LEVel (see page 530) Command Syntax :TRIGger[:EDGE]:LEVel ::= [,] ::= 0.
3 Commands by Subsystem :TRIGger[:EDGE]:REJect (see page 530) Command Syntax :TRIGger[:EDGE]:REJect ::= {OFF | LFReject | HFReject} The :TRIGger[:EDGE]:REJect command turns the low- frequency or high- frequency reject filter on or off. You can turn on one of these filters at a time. • The high frequency reject filter adds a 50 kHz low- pass filter in the trigger path to remove high frequency components from the trigger waveform.
Commands by Subsystem 3 :TRIGger[:EDGE]:SLOPe (see page 530) Command Syntax :TRIGger[:EDGE]:SLOPe ::= {NEGative | POSitive | ALTernate} The :TRIGger[:EDGE]:SLOPe command specifies the slope of the edge for the trigger. The SLOPe command is not valid in TV trigger mode. Instead, use :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.
3 Commands by Subsystem :TRIGger[:EDGE]:SOURce (see page 530) Command Syntax :TRIGger[:EDGE]:SOURce ::= {CHANnel | EXTernal | LINE} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :TRIGger[:EDGE]:SOURce command selects the channel 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.
3 Commands by Subsystem :TRIGger:GLITch Commands Table 60 :TRIGger:GLITch Commands Summary Command Query Options and Query Returns :TRIGger:GLITch:GREat erthan [suffix] (see page 348) :TRIGger:GLITch:GREat erthan? (see page 348) ::= floating-point number from 5 ns to 10 seconds in NR3 format [suffix] ::= {s | ms | us | ns | ps} :TRIGger:GLITch:LESSt han [suffix] (see page 349) :TRIGger:GLITch:LESSt han? (see page 349) ::= floa
3 Commands by Subsystem :TRIGger:GLITch:GREaterthan (see page 530) Command Syntax :TRIGger:GLITch:GREaterthan [] ::= 32-bit floating-point number (5 ns - 10 seconds) in NR3 format ::= {s | ms | us | ns | ps} The :TRIGger:GLITch:GREaterthan command sets the minimum pulse width duration for the selected :TRIGger:GLITch:SOURce.
3 Commands by Subsystem :TRIGger:GLITch:LESSthan (see page 530) Command Syntax :TRIGger:GLITch:LESSthan [] ::= floating-point number (5 ns - 10 seconds) ::= {s | ms | us | ns | ps} The :TRIGger:GLITch:LESSthan command sets the maximum pulse width duration for the selected :TRIGger:GLITch:SOURce. Query Syntax :TRIGger:GLITch:LESSthan? The :TRIGger:GLITch:LESSthan? query returns the pulse width duration time for :TRIGger:GLITch:SOURce.
3 Commands by Subsystem :TRIGger:GLITch:LEVel (see page 530) Command Syntax :TRIGger:GLITch:LEVel ::= [, ] ::= .
Commands by Subsystem 3 :TRIGger:GLITch:POLarity (see page 530) Command Syntax :TRIGger:GLITch:POLarity ::= {POSitive | NEGative} The :TRIGger:GLITch:POLarity command sets the polarity for the glitch pulse width trigger. Query Syntax :TRIGger:GLITch:POLarity? The :TRIGger:GLITch:POLarity? query returns the glitch pulse width trigger polarity.
3 Commands by Subsystem :TRIGger:GLITch:QUALifier (see page 530) Command Syntax :TRIGger:GLITch:QUALifier ::= {GREaterthan | LESSthan | RANGe} This command sets the mode of operation 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:QUALifier? The :TRIGger:GLITch:QUALifier? query returns the glitch pulse width qualifier.
3 Commands by Subsystem :TRIGger:GLITch:RANGe (see page 530) Command Syntax :TRIGger:GLITch:RANGe [suffix], [suffix] ::= start time (10 ns - 9.99 seconds) in NR3 format ::= stop time (15 ns - 10 seconds) in NR3 format [suffix] ::= {s | ms | us | ns | ps} The :TRIGger:GLITch:RANGe command sets the pulse width duration for the selected :TRIGger:GLITch:SOURce.
3 Commands by Subsystem :TRIGger:GLITch:SOURce (see page 530) Command Syntax :TRIGger:GLITch:SOURce ::= {CHANnel | EXTernal} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope 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 pulse width source.
3 Commands by Subsystem :TRIGger:IIC Commands Table 61 :TRIGger:IIC Commands Summary Command Query Options and Query Returns :TRIGger:IIC:PATTern: ADDRess (see page 356) :TRIGger:IIC:PATTern: ADDRess? (see page 356) ::= integer or ::= "0xnn" n ::= {0,..,9 | A,..,F} :TRIGger:IIC:PATTern: DATA (see page 357) :TRIGger:IIC:PATTern: DATA? (see page 357) ::= integer or ::= "0xnn" n ::= {0,..,9 | A,..
3 Commands by Subsystem :TRIGger:IIC:PATTern:ADDRess (see page 530) Command Syntax :TRIGger:IIC:PATTern:ADDRess ::= integer or ::= "0xnn" where n ::= {0,..,9 | A,..,F} The :TRIGger:IIC:PATTern:ADDRess command sets the address 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.
Commands by Subsystem 3 :TRIGger:IIC:PATTern:DATA (see page 530) Command Syntax :TRIGger:IIC:PATTern:DATA ::= integer or ::= "0xnn" where n ::= {0,..,9 | A,..,F} The :TRIGger:IIC:PATTern:DATA command 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:IIC:PATTern:DATA? query returns the current pattern for IIC data.
3 Commands by Subsystem :TRIGger:IIC:PATTern:DATa2 (see page 530) Command Syntax :TRIGger:IIC:PATTern:DATa2 ::= integer or ::= "0xnn" where n ::= {0,..,9 | A,..,F} The :TRIGger:IIC:PATTern:DATa2 command 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.
Commands by Subsystem 3 :TRIGger:IIC:SOURce:CLOCk (see page 530) Command Syntax :TRIGger:IIC:[SOURce:]CLOCk ::= {CHANnel | EXTernal} for the DSO models ::= {CHANnel | DIGital0,..,DIGital15} for the MSO models ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :TRIGger:IIC:[SOURce:]CLOCk command sets the source for the IIC serial clock (SCL).
3 Commands by Subsystem :TRIGger:IIC:SOURce:DATA (see page 530) Command Syntax :TRIGger:IIC:[SOURce:]DATA ::= {CHANnel | EXTernal} for the DSO models ::= {CHANnel | DIGital0,..,DIGital15} for the MSO models ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :TRIGger:IIC:[SOURce:]DATA command sets the source for IIC serial data (SDA).
3 Commands by Subsystem :TRIGger:IIC:TRIGger:QUALifier (see page 530) Command Syntax :TRIGger:IIC:TRIGger:QUALifier ::= {EQUal | NOTequal | LESSthan | GREaterthan} The :TRIGger:IIC:TRIGger:QUALifier command sets the IIC data qualifier when TRIGger:IIC:TRIGger[:TYPE] is set to READEprom. Query Syntax :TRIGger:IIC:TRIGger:QUALifier? The :TRIGger:IIC:TRIGger:QUALifier? query returns the current IIC data qualifier value.
3 Commands by Subsystem :TRIGger:IIC:TRIGger[:TYPE] (see page 530) Command Syntax :TRIGger:IIC:TRIGger[:TYPE] ::= {STARt | STOP | READ7 | READEprom | WRITe7 | WRITe10 | NACKnowledge | ANACknowledge | R7Data2 | W7Data2 | RESTart} The :TRIGger:IIC:TRIGger[:TYPE] command sets the IIC trigger type: • STARt — Start condition. • STOP — Stop condition. • READ7 — 7- bit address frame containing (Start:Address7:Read:Ack:Data). The value READ is also accepted for READ7.
Commands by Subsystem 3 • ":TRIGger:IIC:PATTern:ADDRess" on page 356 • ":TRIGger:IIC:PATTern:DATA" on page 357 • ":TRIGger:IIC:PATTern:DATa2" on page 358 • ":TRIGger:IIC:TRIGger:QUALifier" on page 361 • "Long Form to Short Form Truncation Rules" on page 532 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 363
3 Commands by Subsystem :TRIGger:LIN Commands Table 62 :TRIGger:LIN Commands Summary Command Query Options and Query Returns :TRIGger:LIN:ID (see page 365) :TRIGger:LIN:ID? (see page 365) ::= 7-bit integer in decimal, , or from 0-63 or 0x00-0x3f (with Option AMS) ::= #Hnn where n ::= {0,..,9 | A,..,F} for hexadecimal ::= #Bnn...n where n ::= {0 | 1} for binary ::= "0xnn" where n ::= {0,..,9 | A,..
3 Commands by Subsystem :TRIGger:LIN:ID (see page 530) Command Syntax :TRIGger:LIN:ID ::= 7-bit integer in decimal, , or from 0-63 or 0x00-0x3f ::= #Hnn where n ::= {0,..,9 | A,..,F} for hexadecimal ::= #Bnn...n where n ::= {0 | 1} for binary ::= "0xnn" where n ::= {0,..,9 | A,..,F} for hexadecimal The :TRIGger:LIN:ID command defines the LIN identifier searched for in each CAN message when the LIN trigger mode is set to frame ID.
3 Commands by Subsystem :TRIGger:LIN:SAMPlepoint (see page 530) Command Syntax :TRIGger:LIN:SAMPlepoint ::= {60 | 62.5 | 68 | 70 | 75 | 80 | 87.5} in NR3 format The :TRIGger:LIN:SAMPlepoint command sets the point during the bit time where the bit level is sampled to determine whether the bit is dominant or recessive. The sample point represents the percentage of time between the beginning of the bit time to the end of the bit time.
3 Commands by Subsystem :TRIGger:LIN:SIGNal:BAUDrate (see page 530) Command Syntax :TRIGger:LIN:SIGNal:BAUDrate ::= integer in NR1 format ::= {2400 | 9600 | 19200} The :TRIGger:LIN:SIGNal:BAUDrate command sets the standard baud rate of the 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.
3 Commands by Subsystem :TRIGger:LIN:SOURce (see page 530) Command Syntax :TRIGger:LIN:SOURce ::= {CHANnel | EXTernal} for the DSO models ::= {CHANnel | DIGital0,..,DIGital15} for the MSO models ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :TRIGger:LIN:SOURce command sets the source for the LIN signal.
3 Commands by Subsystem :TRIGger:LIN:STANdard (see page 530) Command Syntax :TRIGger:LIN:STANdard ::= {LIN13 | LIN20} The :TRIGger:LIN:STANdard 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 setting.
3 Commands by Subsystem :TRIGger:LIN:SYNCbreak (see page 530) Command Syntax :TRIGger:LIN:SYNCbreak ::= integer = {11 | 12 | 13} The :TRIGger:LIN:SYNCbreak command sets the length of the LIN sync break to be greater than or equal to 11,12, or 13 clock lengths. The sync break is the idle period in the bus activity at the beginning of each packet that distinguishes one information packet from the previous one.
3 Commands by Subsystem :TRIGger:LIN:TRIGger (see page 530) Command Syntax :TRIGger:LIN:TRIGger ::= {SYNCbreak | ID} The :TRIGger:LIN:TRIGger command sets the LIN trigger on condition to be Sync Break (SYNCbreak) or Frame Id (ID). NOTE Query Syntax The ID option is available when the automotive CAN and LIN serial decode option (Option AMS) has been licensed. :TRIGger:LIN:TRIGger? The :TRIGger:LIN:TRIGger? query returns the current LIN trigger value.
3 Commands by Subsystem :TRIGger:SPI Commands Table 63 :TRIGger:SPI Commands Summary Command Query Options and Query Returns :TRIGger:SPI:CLOCk:SL OPe (see page 373) :TRIGger:SPI:CLOCk:SL OPe? (see page 373) ::= {NEGative | POSitive} :TRIGger:SPI:CLOCk:TI Meout (see page 374) :TRIGger:SPI:CLOCk:TI Meout? (see page 374) ::= time in seconds in NR1 format :TRIGger:SPI:FRAMing (see page 375) :TRIGger:SPI:FRAMing? (see page 375) ::= {CHIPsele
Commands by Subsystem 3 :TRIGger:SPI:CLOCk:SLOPe (see page 530) Command Syntax :TRIGger:SPI:CLOCk:SLOPe ::= {NEGative | POSitive} The :TRIGger:SPI:CLOCk:SLOPe command specifies the rising edge (POSitive) or falling edge (NEGative) of the SPI clock source that will clock in the data. Query Syntax :TRIGger:SPI:CLOCk:SLOPe? The :TRIGger:SPI:CLOCk:SLOPe? query returns the current SPI clock source slope.
3 Commands by Subsystem :TRIGger:SPI:CLOCk:TIMeout (see page 530) Command Syntax :TRIGger:SPI:CLOCk:TIMeout ::= time in seconds in NR1 format The :TRIGger:SPI:CLOCk:TIMeout command sets the SPI signal clock timeout resource 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.
3 Commands by Subsystem :TRIGger:SPI:FRAMing (see page 530) Command Syntax :TRIGger:SPI:FRAMing ::= {CHIPselect | NOTChipselect | TIMeout} The :TRIGger:SPI:FRAMing command sets 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 current SPI framing value.
3 Commands by Subsystem :TRIGger:SPI:PATTern:DATA (see page 530) Command Syntax :TRIGger:SPI:PATTern:DATA , ::= integer or ::= integer or ::= "0xnnnnnn" where n ::= {0,..,9 | A,..,F} The :TRIGger:SPI:PATTern:DATA command defines the SPI data pattern resource according to the value and the mask. This pattern, along with the data width, control the data pattern searched for in the data stream.
Commands by Subsystem 3 :TRIGger:SPI:PATTern:WIDTh (see page 530) Command Syntax :TRIGger:SPI:PATTern:WIDTh ::= integer from 4 to 32 in NR1 format The :TRIGger: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 data pattern width setting.
3 Commands by Subsystem :TRIGger:SPI:SOURce:CLOCk (see page 530) Command Syntax :TRIGger:SPI:SOURce:CLOCk ::= {CHANnel | EXTernal} for the DSO models ::= {CHANnel | DIGital0,..,DIGital15} for the MSO models ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :TRIGger:SPI:SOURce:CLOCk command sets the source for the SPI serial clock.
3 Commands by Subsystem :TRIGger:SPI:SOURce:DATA (see page 530) Command Syntax :TRIGger:SPI:SOURce:DATA ::= {CHANnel | EXTernal} for the DSO models ::= {CHANnel | DIGital0,..,DIGital15} for the MSO models ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :TRIGger:SPI:SOURce:DATA command sets the source for the SPI serial data.
3 Commands by Subsystem :TRIGger:SPI:SOURce:FRAMe (see page 530) Command Syntax :TRIGger:SPI:SOURce:FRAMe ::= {CHANnel | EXTernal} for the DSO models ::= {CHANnel | DIGital0,..,DIGital15} for the MSO models ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {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.
3 Commands by Subsystem :TRIGger:TV Commands Table 64 :TRIGger:TV Commands Summary Command Query Options and Query Returns :TRIGger:TV:LINE (see page 382) :TRIGger:TV:LINE? (see page 382) ::= integer in NR1 format :TRIGger:TV:MODE (see page 383) :TRIGger:TV:MODE? (see page 383) ::= {FIEld1 | FIEld2 | AFIelds | ALINes | LINE | VERTical | LFIeld1 | LFIeld2 | LALTernate | LVERtical} :TRIGger:TV:POLarity (see page 384) :TRIGger:TV:POLarity?
3 Commands by Subsystem :TRIGger:TV:LINE (see page 530) Command Syntax :TRIGger:TV:LINE ::= integer in NR1 format The :TRIGger:TV:LINE command allows triggering on a specific line of video. The line number limits vary with the standard and mode, as shown in the following table.
3 Commands by Subsystem :TRIGger:TV:MODE (see page 530) Command Syntax :TRIGger:TV:MODE ::= {FIEld1 | FIEld2 | AFIelds | ALINes | LINE | VERTical | LFIeld1 | LFIeld2 | LALTernate | LVERtical} The :TRIGger:TV:MODE command selects the TV trigger mode and field. The LVERtical parameter is only available when :TRIGger:TV:STANdard is GENeric. The LALTernate parameter is not available when :TRIGger:TV:STANdard is GENeric.
3 Commands by Subsystem :TRIGger:TV:POLarity (see page 530) Command Syntax :TRIGger:TV: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.
Commands by Subsystem 3 :TRIGger:TV:SOURce (see page 530) Command Syntax :TRIGger:TV:SOURce ::= {CHANnel} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {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 the current TV trigger source.
3 Commands by Subsystem :TRIGger:TV:STANdard (see page 530) Command Syntax :TRIGger:TV:STANdard ::= {GENeric | NTSC | PALM | {P480L60HZ | P480} | | {P1080L24HZ | P1080} | {I1080L50HZ | I1080} | PAL | SECam {P720L60HZ | P720} | P1080L25HZ | I1080L60HZ} The :TRIGger:TV:STANdard command selects the video standard. GENeric mode is non- interlaced. Query Syntax :TRIGger:TV:STANdard? The :TRIGger:TV:STANdard? query returns the current TV trigger standard setting.
3 Commands by Subsystem :TRIGger:UART Commands Table 66 :TRIGger:UART Commands Summary Command Query Options and Query Returns :TRIGger:UART:BAUDrat e (see page 389) :TRIGger:UART:BAUDrat e? (see page 389) ::= {1200 | 1800 | 2000 | 2400 | 3600 | 4800 | 7200 | 9600 | 14400 | 15200 | 19200 | 28800 | 38400 | 56000 | 57600 | 76800 | 115200 | 128000 | 230400 | 460800 | 921600 | 1382400 | 1843200 | 2764800} :TRIGger:UART:BITorde r (see page 390) :TRIGger:UART:BITorde r? (
3 Commands by Subsystem Table 66 :TRIGger:UART Commands Summary (continued) Command Query Options and Query Returns :TRIGger:UART:SOURce: TX (see page 398) :TRIGger:UART:SOURce: TX? (see page 398) ::= {CHANnel | EXTernal} for DSO models ::= {CHANnel | DIGital0,..
3 Commands by Subsystem :TRIGger:UART:BAUDrate (see page 530) Command Syntax :TRIGger:UART:BAUDrate ::= integer in NR1 format ::= {1200 | 1800 | 2000 | 2400 | 3600 | 4800 | 7200 | 9600 | 14400 | 15200 | 19200 | 28800 | 38400 | 56000 | 57600 | 76800 | 115200 | 128000 | 230400 | 460800 | 921600 | 1382400 | 1843200 | 2764800} The :TRIGger:UART:BAUDrate command selects the bit rate (in bps) for the serial decoder and/or trigger when in UART mode.
3 Commands by Subsystem :TRIGger:UART:BITorder (see page 530) Command Syntax :TRIGger:UART:BITorder ::= {LSBFirst | MSBFirst} The :TRIGger:UART:BITorder command specifies the order of transmission used by the physical Tx and Rx input signals for the serial decoder and/or trigger when in UART mode. LSBFirst sets the least significant bit of each message "byte" as transmitted first. MSBFirst sets the most significant bit as transmitted first.
3 Commands by Subsystem :TRIGger:UART:BURSt (see page 530) Command Syntax :TRIGger:UART:BURSt ::= {OFF | 1 to 4096 in NR1 format} The :TRIGger:UART:BURSt command selects the burst value (Nth occurrence of trigger event after idle period) in the range 1 to 4096 or OFF, for the trigger when in UART mode. Query Syntax :TRIGger:UART:BURSt? The :TRIGger:UART:BURSt? query returns the current UART trigger burst value.
3 Commands by Subsystem :TRIGger:UART:DATA (see page 530) Command Syntax :TRIGger:UART:DATA ::= 8-bit integer in decimal or from 0-255 (0x00-0xff) ::= #Hnn where n ::= {0,..,9 | A,..,F} for hexadecimal ::= #Bnn...n where n ::= {0 | 1} for binary The :TRIGger:UART:DATA command selects the data byte value (0x00 to 0xFF) for the trigger QUALifier when in UART mode. The data value is used when one of the RD or TD trigger types is selected.
Commands by Subsystem 3 :TRIGger:UART:IDLE (see page 530) Command Syntax :TRIGger:UART:IDLE ::= time from 10 us to 10 s in NR3 format The :TRIGger:UART:IDLE command selects the value of the idle period for burst trigger in the range from 1 us to 10 s when in UART mode. Query Syntax :TRIGger:UART:IDLE? The :TRIGger:UART:IDLE? query returns the current UART trigger idle period time.
3 Commands by Subsystem :TRIGger:UART:PARity (see page 530) Command Syntax :TRIGger:UART:PARity ::= {EVEN | ODD | NONE} The :TRIGger:UART:PARity command selects the parity to be used with each message "byte" for the serial decoder and/or trigger when in UART mode. Query Syntax :TRIGger:UART:PARity? The :TRIGger:UART:PARity? query returns the current UART parity setting.
3 Commands by Subsystem :TRIGger:UART:POLarity (see page 530) Command Syntax :TRIGger:UART:POLarity ::= {HIGH | LOW} The :TRIGger:UART:POLarity command selects the polarity as idle low or idle high for the serial decoder and/or trigger when in UART mode. Query Syntax :TRIGger:UART:POLarity? The :TRIGger:UART:POLarity? query returns the current UART polarity setting.
3 Commands by Subsystem :TRIGger:UART:QUALifier (see page 530) Command Syntax :TRIGger:UART:QUALifier ::= {EQUal | NOTequal | GREaterthan | LESSthan} The :TRIGger:UART:QUALifier command selects the data qualifier when :TYPE is set to RDATa, RD1, RD0, RDX, TDATa, TD1, TD0, or TDX for the trigger when in UART mode. Query Syntax :TRIGger:UART:QUALifier? The :TRIGger:UART:QUALifier? query returns the current UART trigger qualifier.
3 Commands by Subsystem :TRIGger:UART:SOURce:RX (see page 530) Command Syntax :TRIGger:UART:SOURce:RX ::= {CHANnel | EXTernal} for the DSO models ::= {CHANnel | DIGital0,..,DIGital15} for the MSO models ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :TRIGger:UART:SOURce:RX command controls which signal is used as the Rx source by the serial decoder and/or trigger when in UART mode.
3 Commands by Subsystem :TRIGger:UART:SOURce:TX (see page 530) Command Syntax :TRIGger:UART:SOURce:TX ::= {CHANnel | EXTernal} for the DSO models ::= {CHANnel | DIGital0,..,DIGital15} for the MSO models ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :TRIGger:UART:SOURce:TX command controls which signal is used as the Tx source by the serial decoder and/or trigger when in UART mode.
Commands by Subsystem 3 :TRIGger:UART:TYPE (see page 530) Command Syntax :TRIGger:UART:TYPE ::= {RSTArt | RSTop | RDATa | RD1 | RD0 | RDX | PARityerror | TSTArt | TSTOp | TDATa | TD1 | TD0 | TDX} The :TRIGger:UART:TYPE command selects the UART trigger type. When one of the RD or TD types is selected, the :TRIGger:UART:DATA and :TRIGger:UART:QUALifier commands are used to specify the data value and comparison operator.
3 Commands by Subsystem :TRIGger:UART:WIDTh (see page 530) Command Syntax :TRIGger:UART:WIDTh ::= {5 | 6 | 7 | 8 | 9} The :TRIGger:UART:WIDTh command determines the number of bits (5- 9) for each message "byte" for the serial decoder and/or trigger when in UART mode. Query Syntax :TRIGger:UART:WIDTh? The :TRIGger:UART:WIDTh? query returns the current UART width setting.
3 Commands by Subsystem :WAVeform Commands Provide access to waveform data. See "Introduction to :WAVeform Commands" on page 403.
3 Commands by Subsystem Table 67 :WAVeform Commands Summary (continued) Command Query Options and Query Returns n/a :WAVeform:PREamble? (see page 417) ::= , ,,, , , ,, , ::= an integer in NR1 format: • 0 for BYTE format • 1 for WORD format • 2 for ASCii format ::= an integer in NR1 format: • • • • 0 1 2 3 for for for for NORMal ty
3 Commands by Subsystem Table 67 :WAVeform Commands Summary (continued) Command Query Options and Query Returns n/a :WAVeform:YINCrement? (see page 431) ::= y-increment value in the current preamble in NR3 format n/a :WAVeform:YORigin? (see page 432) ::= y-origin in the current preamble in NR3 format n/a :WAVeform:YREFerence? (see page 433) ::= y-reference value in the current preamble in NR1 format Introduction to :WAVeform Commands The WAVeform s
3 Commands by Subsystem A waveform record consists of either all of the acquired points or a subset of the acquired points. The number of points acquired may be queried using :ACQuire:POINts? (see page 130). Helpful Hints: The number of points transferred to the computer is controlled using the :WAVeform:POINts command (see page 413). If :WAVeform:POINts MAXimum is specified and the instrument is not running (stopped), all of the points that are displayed are transferred.
3 Commands by Subsystem This data is transmitted over the interface linearly, starting with time bucket 0 and proceeding through time bucket n- 1, where n is the number returned by the :WAVeform:POINts? query (see page 413). The first value corresponds to a point at the left side of the screen and the last value corresponds to one point away from the right side of the screen. The maximum number of points that can be returned in average mode is 1000 unless ACQuire:COUNt has been set to 1.
3 Commands by Subsystem In converting a data value to time, the time value of a data point can be determined by the position of the data point.
3 Commands by Subsystem WORD format (see ":WAVeform:FORMat" on page 412) provides 16- bit access to the waveform data. In the WORD format, the number of data bytes is twice the number of data points. The number of data points is the value returned by the :WAVeform:POINts? query (see page 413). If the data intrinsically has less than 16 bits of resolution, the data is left- shifted to provide 16 bits of resolution and the least significant bits are set to 0.
3 Commands by Subsystem :WAVeform:BYTeorder (see page 530) Command Syntax :WAVeform:BYTeorder ::= {LSBFirst | MSBFirst} The :WAVeform:BYTeorder command sets the output sequence of the WORD data. The parameter MSBFirst sets the most significant byte to be transmitted first. The 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.
Commands by Subsystem 3 :WAVeform:COUNt (see page 530) Query Syntax :WAVeform:COUNt? The :WAVeform:COUNT? query returns the count 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.
3 Commands by Subsystem :WAVeform:DATA (see page 530) Query Syntax :WAVeform:DATA? The :WAVeform:DATA query returns the binary block of sampled data points transmitted using the IEEE 488.2 arbitrary block data format. The binary data is formatted according to the settings of the :WAVeform:UNSigned, :WAVeform:BYTeorder, :WAVeform:FORMat, and :WAVeform:SOURce commands. The number of points returned is controlled by the :WAVeform:POINts command.
Commands by Subsystem 3 ' ' ' ' Where: ' = #800001000 (This is an example header) ' The "#8" may be stripped off of the header and the remaining ' numbers are the size, in bytes, of the waveform data block. The ' size can vary depending on the number of points acquired for the ' waveform. You can then read that number of bytes from the ' oscilloscope and the terminating NL character. ' Dim lngI As Long Dim lngDataValue As Long varQueryResult = myScope.
3 Commands by Subsystem :WAVeform:FORMat (see page 530) Command Syntax :WAVeform:FORMat ::= {WORD | BYTE | ASCii} The :WAVeform:FORMat command sets the data transmission mode for waveform data points. This command controls how the data is formatted when sent from the oscilloscope. • ASCii formatted data converts the internal integer data values to real Y- axis values. Values are transferred as ASCii digits in floating point notation, separated by commas.
Commands by Subsystem 3 :WAVeform:POINts (see page 530) Command Syntax :WAVeform:POINts <# points> <# points> ::= {100 | 250 | 500 | 1000 | } if waveform points mode is NORMal <# points> ::= {100 | 250 | 500 | 1000 | 2000 ... 8000000 in 1-2-5 sequence | } if waveform points mode is MAXimum or RAW ::= {NORMal | MAXimum | RAW} NOTE The option is deprecated. Use the :WAVeform:POINts:MODE command instead.
3 Commands by Subsystem <# points> ::= {100 | 250 | 500 | 1000 | } if waveform points mode is NORMal <# points> ::= {100 | 250 | 500 | 1000 | 2000 ... 8000000 in 1-2-5 sequence | } if waveform points mode is MAXimum or RAW NOTE See Also If a full screen of data is not displayed, the number of points returned will not be 1000 or an even divisor of it.
Commands by Subsystem 3 :WAVeform:POINts:MODE (see page 530) Command Syntax :WAVeform:POINts:MODE ::= {NORMal | MAXimum | RAW} The :WAVeform:POINts:MODE command sets the data record to be transferred with the :WAVeform:DATA? query. For the analog sources, there are two different records that can be transferred: • The first is the raw acquisition record. The maximum number of points available in this record is returned by the :ACQuire:POINts? query.
3 Commands by Subsystem The :WAVeform:POINts:MODE? query returns the current points mode. Setting the points mode will affect what data is transferred. See the discussion above.
3 Commands by Subsystem :WAVeform:PREamble (see page 530) Query Syntax :WAVeform:PREamble? The :WAVeform:PREamble query requests the preamble information for the selected waveform source. The preamble data contains information concerning the vertical and horizontal scaling of the data of the corresponding channel.
3 Commands by Subsystem 'HOD\ SRLQWV ;LQFUHPHQW ;RULJLQ < LQFUHPHQW YROWDJH RI 9VWHS < RULJLQ 9 2IIVHW < UHIHUHQFH 9VWHSV 9VWHSV LI IRUPDW :25' LI IRUPDW %<7( ; RULJLQ W ; UHIHUHQFH ; LQFUHPHQW W WLPH EHWZHHQ VXFFHVVLYH SRLQWV See Also • "Introduction to :WAVeform Commands" on page 403 • ":ACQuire:COUNt" on page 127 • ":ACQuire:POINts" on page 130 • ":ACQuire:TYPE" on page 132 • ":DIGitize" on page 96 • ":WAVeform:COUNt" on page 409 • ":WAVeform:DAT
Commands by Subsystem ' ' ' ' ' ' ' ' ' ' ' Dim Dim Dim Dim Dim Dim Dim Dim Dim Dim Dim Dim TYPE POINTS COUNT XINCREMENT XORIGIN XREFERENCE YINCREMENT YORIGIN YREFERENCE : : : : : : 3 int16 int32 int32 float64 float64 int32 - 0 = NORMAL, 1 = PEAK DETECT, 2 = AVERAGE number of data points transferred. 1 and is always 1. - time difference between data points. - always the first data point in memory. specifies the data point associated with x-origin. : float32 - voltage diff between data points.
3 Commands by Subsystem :WAVeform:SOURce (see page 530) Command Syntax :WAVeform:SOURce ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :WAVeform:SOURce command selects the analog channel or function to be used as the source for the :WAVeform commands. Function capabilities include add, subtract, multiply; integrate, differentiate, and FFT (Fast Fourier Transform) operations.
Commands by Subsystem 3 myScope.WriteString ":WAVEFORM:POINTS 1000" ' WAVE_FORMAT - Sets the data transmission mode for the waveform ' data output. This command controls whether data is formatted in ' a word or byte format when sent from the oscilloscope. Dim lngVSteps As Long Dim intBytesPerData As Integer ' Data in range 0 to 65535. myScope.WriteString ":WAVEFORM:FORMAT WORD" lngVSteps = 65536 intBytesPerData = 2 ' Data in range 0 to 255. 'myScope.
3 Commands by Subsystem lngYReference = Preamble(9) strOutput = "" 'strOutput = strOutput + "Format = " + CStr(intFormat) + vbCrLf 'strOutput = strOutput + "Type = " + CStr(intType) + vbCrLf 'strOutput = strOutput + "Points = " + CStr(lngPoints) + vbCrLf 'strOutput = strOutput + "Count = " + CStr(lngCount) + vbCrLf 'strOutput = strOutput + "X increment = " + _ ' FormatNumber(dblXIncrement * 1000000) + " us" + vbCrLf 'strOutput = strOutput + "X origin = " + _ ' FormatNumber(dblXOrigin * 1000000) + " us" +
Commands by Subsystem 3 Step (UBound(varQueryResult) / 20) ' 20 points. If intBytesPerData = 2 Then lngDataValue = varQueryResult(lngI) * 256 _ + varQueryResult(lngI + 1) ' 16-bit value. Else lngDataValue = varQueryResult(lngI) ' 8-bit value.
3 Commands by Subsystem :WAVeform:SOURce:SUBSource (see page 530) Command Syntax :WAVeform:SOURce:SUBSource ::= {{NONE | RX} | TX} If the :WAVeform:SOURce is SBUS (serial decode), more than one data set may be available, and this command lets you choose from the available data sets. Currently, only UART serial decode lets you get "TX" data. The default, NONE, specifies "RX" data. (RX is an alias for NONE.
Commands by Subsystem 3 :WAVeform:TYPE (see page 530) Query Syntax :WAVeform:TYPE? The :WAVeform:TYPE? query returns the acquisition mode associated with the currently selected waveform. The acquisition mode is set by the :ACQuire:TYPE command.
3 Commands by Subsystem :WAVeform:UNSigned (see page 530) Command Syntax :WAVeform:UNSigned ::= {{0 | OFF} | {1 | ON}} The :WAVeform:UNSigned command turns unsigned mode on or off for the currently selected waveform. Use the WAVeform:UNSigned command to control whether data values are 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.
3 Commands by Subsystem :WAVeform:VIEW (see page 530) Command Syntax :WAVeform:VIEW ::= {MAIN} The :WAVeform:VIEW command sets the view setting associated with the currently selected waveform. Currently, the only legal value for the view setting is MAIN. Query Syntax :WAVeform:VIEW? The :WAVeform:VIEW? query returns the view setting associated with the currently selected waveform.
3 Commands by Subsystem :WAVeform:XINCrement (see page 530) Query Syntax :WAVeform:XINCrement? The :WAVeform:XINCrement? query returns the x- increment value for the currently specified source. This value is the time difference between consecutive data points in seconds.
Commands by Subsystem 3 :WAVeform:XORigin (see page 530) Query Syntax :WAVeform:XORigin? The :WAVeform:XORigin? query returns the x- origin value for the currently specified source. 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).
3 Commands by Subsystem :WAVeform:XREFerence (see page 530) Query Syntax :WAVeform:XREFerence? The :WAVeform:XREFerence? query returns the x- reference value for the currently 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 always 0.
Commands by Subsystem 3 :WAVeform:YINCrement (see page 530) Query Syntax :WAVeform:YINCrement? The :WAVeform:YINCrement? query returns the y- increment value in volts for the currently specified source. This value is the voltage difference between consecutive data values.
3 Commands by Subsystem :WAVeform:YORigin (see page 530) Query Syntax :WAVeform:YORigin? The :WAVeform:YORigin? query returns the y- origin value for the currently specified 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.
Commands by Subsystem 3 :WAVeform:YREFerence (see page 530) Query Syntax :WAVeform:YREFerence? The :WAVeform:YREFerence? query returns the y- reference value for the currently specified 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.
3 434 Commands by Subsystem Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 4 Commands A-Z A 435 B 436 C 436 D 438 E 439 F 440 G 441 H 441 I 441 L 442 M 443 N 444 O 444 P 445 Q 446 R 446 S 447 T 450 U 453 V 454 W 455 X 455 Y 456 A • AALias, ":ACQuire:AALias" on page 125 • ":ACQuire:AALias" on page 125 • ":ACQuire:COMPlete" on page 126 • ":ACQuire:COUNt" on page 127 • ":ACQuire:DAALias" on page 128 • ":ACQuire:MODE" on page 129 A 435
4 Commands A-Z • ":ACQuire:POINts" on page 130 • ":ACQuire:SRATe" on page 131 • ":ACQuire:TYPE" on page 132 • ADDRess, ":TRIGger:IIC:PATTern:ADDRess" on page 356 • ":AER (Arm Event Register)" on page 89 • APRinter, ":HARDcopy:APRinter" on page 196 • AREA Commands: • ":HARDcopy:AREA" on page 195 • ":SAVE:IMAGe:AREA" on page 266 • ASIZe, ":SBUS:IIC:ASIZe" on page 284 • ":AUToscale" on page 90 • ":AUToscale:AMODE" on page 92 • ":AUToscale:CHANnels" on page 93 B • BASE, ":SBUS:UART:BASE" on page 288 • BAUDra
Commands A-Z 4 • ":SBUS:CAN:COUNt:OVERload" on page 279 • ":SBUS:CAN:COUNt:RESet" on page 280 • ":SBUS:CAN:COUNt:TOTal" on page 281 • ":SBUS:CAN:COUNt:UTILization" on page 282 • ":TRIGger:CAN Commands" on page 324 • ":CDISplay" on page 95 • CENTer, ":FUNCtion:CENTer" on page 183 • ":CHANnel:LABel" on page 462 • ":CHANnel2:SKEW" on page 463 • ":CHANnel:BWLimit" on page 145 • ":CHANnel:COUPling" on page 146 • ":CHANnel:DISPlay" on page 147 • ":CHANnel:IMPedance" on page 148 • ":CHANnel:INPut"
4 Commands A-Z • "*CLS (Clear Status)" on page 65 • COMPlete, ":ACQuire:COMPlete" on page 126 • CONNect, ":DISPlay:CONNect" on page 466 • COUNt Commands: • ":ACQuire:COUNt" on page 127 • ":SBUS:CAN:COUNt:ERRor" on page 278 • ":SBUS:CAN:COUNt:OVERload" on page 279 • ":SBUS:CAN:COUNt:RESet" on page 280 • ":SBUS:CAN:COUNt:TOTal" on page 281 • ":SBUS:CAN:COUNt:UTILization" on page 282 • ":SBUS:UART:COUNt:ERRor" on page 289 • ":SBUS:UART:COUNt:RESet" on page 290 • ":SBUS:UART:COUNt:RXFRames" on page 291 • ":SB
Commands A-Z 4 • DELay Commands: • ":MEASure:DELay" on page 225 • ":TIMebase:DELay" on page 494 • DESTination, ":HARDcopy:DESTination" on page 471 • DEVice, ":HARDcopy:DEVice" on page 472 • ":DIGitize" on page 96 • DISPlay Commands: • ":CHANnel:DISPlay" on page 147 • ":FUNCtion:DISPlay" on page 184 • ":SBUS:DISPlay" on page 283 • ":DISPlay:CLEar" on page 163 • ":DISPlay:CONNect" on page 466 • ":DISPlay:DATA" on page 164 • ":DISPlay:LABel" on page 166 • ":DISPlay:LABList" on page 167 • ":DISPlay:PERSist
4 Commands A-Z • ":EXTernal:PROBe:STYPe" on page 177 • ":EXTernal:PROTection" on page 178 • ":EXTernal:RANGe" on page 179 • ":EXTernal:UNITs" on page 180 F • FACTors Commands: • ":HARDcopy:FACTors" on page 197 • ":SAVE:IMAGe:FACTors" on page 267 • FALLtime, ":MEASure:FALLtime" on page 228 • FFEed, ":HARDcopy:FFEed" on page 198 • FILename Commands: • ":HARDcopy:FILename" on page 473 • ":RECall:FILename" on page 258 • ":SAVE:FILename" on page 264 • FORMat Commands: • ":HARDcopy:FORMat" on page 474 • ":SAVE
Commands A-Z G 4 • GLITch (Pulse Width), ":TRIGger:GLITch Commands" on page 347 • GRAYscale, ":HARDcopy:GRAYscale" on page 475 • GREaterthan Commands: • ":TRIGger:DURation:GREaterthan" on page 336 • ":TRIGger:GLITch:GREaterthan" on page 348 H • ":HARDcopy:AREA" on page 195 • ":HARDcopy:APRinter" on page 196 • ":HARDcopy:DESTination" on page 471 • ":HARDcopy:DEVice" on page 472 • ":HARDcopy:FACTors" on page 197 • ":HARDcopy:FFEed" on page 198 • ":HARDcopy:FILename" on page 473 • ":HARDcopy:FORMat" on pa
4 Commands A-Z • ":RECall:IMAGe[:STARt]" on page 259 • ":SAVE:IMAGe:AREA" on page 266 • ":SAVE:IMAGe:FACTors" on page 267 • ":SAVE:IMAGe:FORMat" on page 268 • ":SAVE:IMAGe:INKSaver" on page 269 • ":SAVE:IMAGe:PALette" on page 270 • ":SAVE:IMAGe[:STARt]" on page 265 • IMPedance Commands: • ":CHANnel:IMPedance" on page 148 • ":EXTernal:IMPedance" on page 174 • INKSaver, ":HARDcopy:INKSaver" on page 199 • INVert, ":CHANnel:INVert" on page 149 L • LABel Commands: • ":CALibrate:LABel" on page 136 • ":CH
Commands A-Z M 4 • ":MARKer:MODE" on page 205 • ":MARKer:X1Position" on page 206 • ":MARKer:X1Y1source" on page 207 • ":MARKer:X2Position" on page 208 • ":MARKer:X2Y2source" on page 209 • ":MARKer:XDELta" on page 210 • ":MARKer:Y1Position" on page 211 • ":MARKer:Y2Position" on page 212 • ":MARKer:YDELta" on page 213 • ":MEASure:CLEar" on page 220 • ":MEASure:COUNter" on page 221 • ":MEASure:DEFine" on page 222 • ":MEASure:DELay" on page 225 • ":MEASure:DUTYcycle" on page 227 • ":MEASure:FALLtime" on page
4 Commands A-Z • ":MEASure:TVALue" on page 244 • ":MEASure:TVOLt" on page 486 • ":MEASure:UPPer" on page 488 • ":MEASure:VAMPlitude" on page 246 • ":MEASure:VAVerage" on page 247 • ":MEASure:VBASe" on page 248 • ":MEASure:VDELta" on page 489 • ":MEASure:VMAX" on page 249 • ":MEASure:VMIN" on page 250 • ":MEASure:VPP" on page 251 • ":MEASure:VRMS" on page 252 • ":MEASure:VSTArt" on page 490 • ":MEASure:VSTOp" on page 491 • ":MEASure:VTIMe" on page 253 • ":MEASure:VTOP" on page 254 • ":MEASure:XMAX" on page
4 Commands A-Z • OPERation, ":FUNCtion:OPERation" on page 186 • ":OPERegister:CONDition (Operation Status Condition Register)" on page 107 • ":OPERegister[:EVENt] (Operation Status Event Register)" on page 109 • "*OPT (Option Identification)" on page 73 • OVERload, ":SBUS:CAN:COUNt:OVERload" on page 279 • OVERshoot, ":MEASure:OVERshoot" on page 231 • ":OVLenable (Overload Event Enable Register)" on page 111 • ":OVLRegister (Overload Event Register)" on page 113 P • PALette Commands: • ":HARDcopy:PALette"
4 Commands A-Z • ":WAVeform:POINts:MODE" on page 415 • POLarity Commands: • ":TRIGger:GLITch:POLarity" on page 351 • ":TRIGger:TV:POLarity" on page 384 • ":TRIGger:UART:POLarity" on page 395 • POSition Commands: • ":TIMebase:POSition" on page 305 • ":TIMebase:WINDow:POSition" on page 310 • PREamble, ":WAVeform:PREamble" on page 417 • PREShoot, ":MEASure:PREShoot" on page 235 • ":PRINt" on page 115 • ":PRINt?" on page 492 • PRINter, ":HARDcopy:PRinter:LIST" on page 201 • PROBe Commands: • ":CHANnel:PROB
Commands A-Z 4 • ":TIMebase:WINDow:RANGe" on page 311 • ":TRIGger:DURation:RANGe" on page 340 • ":TRIGger:GLITch:RANGe" on page 353 • "*RCL (Recall)" on page 74 • ":RECall:FILename" on page 258 • ":RECall:IMAGe[:STARt]" on page 259 • ":RECall:PWD" on page 260 • ":RECall:SETup[:STARt]" on page 261 • REFerence Commands: • ":FUNCtion:REFerence" on page 188 • ":TIMebase:REFerence" on page 307 • REJect, ":TRIGger[:EDGE]:REJect" on page 344 • RESet Commands: • ":SBUS:CAN:COUNt:RESet" on page 280 • ":SBUS:UART:C
4 Commands A-Z • ":SAVE:WAVeform:LENGth" on page 275 • ":SAVE:WAVeform[:STARt]" on page 273 • ":SBUS:CAN:COUNt:ERRor" on page 278 • ":SBUS:CAN:COUNt:OVERload" on page 279 • ":SBUS:CAN:COUNt:RESet" on page 280 • ":SBUS:CAN:COUNt:TOTal" on page 281 • ":SBUS:CAN:COUNt:UTILization" on page 282 • ":SBUS:DISPlay" on page 283 • ":SBUS:IIC:ASIZe" on page 284 • ":SBUS:LIN:PARity" on page 285 • ":SBUS:MODE" on page 286 • ":SBUS:SPI:WIDTh" on page 287 • ":SBUS:UART:BASE" on page 288 • ":SBUS:UART:COUNt:ERRor" on pag
Commands A-Z 4 • ":TRIGger:LIN:SIGNal:DEFinition" on page 497 • ":SINGle" on page 118 • SKEW, ":CHANnel:PROBe:SKEW" on page 154 • SLOPe Commands: • ":TRIGger[:EDGE]:SLOPe" on page 345 • ":TRIGger:SPI:CLOCk:SLOPe" on page 373 • SOURce Commands: • ":DISPlay:SOURce" on page 169 • ":FUNCtion:SOURce" on page 190 • ":MEASure:SOURce" on page 240 • ":TRIGger:CAN:SOURce" on page 332 • ":TRIGger:GLITch:SOURce" on page 354 • ":TRIGger:IIC:SOURce:CLOCk" on page 359 • ":TRIGger:IIC:SOURce:DATA" on page 360 • ":TRIG
4 Commands A-Z • ":RECall:IMAGe[:STARt]" on page 259 • ":RECall:SETup[:STARt]" on page 261 • ":SAVE:IMAGe[:STARt]" on page 265 • ":SAVE:SETup[:STARt]" on page 272 • ":SAVE:WAVeform[:STARt]" on page 273 • STATus Commands: • ":CALibrate:STATus" on page 138 • ":STATus" on page 119 • "*STB (Read Status Byte)" on page 81 • ":STOP" on page 120 • SUBSource, ":WAVeform:SOURce:SUBSource" on page 424 • SWEep, ":TRIGger:SWEep" on page 323 • SWITch, ":CALibrate:SWITch" on page 139 • SYNCbreak, ":TRIGger:LIN:SYNCbreak
Commands A-Z 4 • ":TIMebase:WINDow:POSition" on page 310 • ":TIMebase:WINDow:RANGe" on page 311 • ":TIMebase:WINDow:SCALe" on page 312 • TIMeout, ":TRIGger:SPI:CLOCk:TIMeout" on page 374 • TMAX, ":MEASure:TMAX" on page 482 • TMIN, ":MEASure:TMIN" on page 483 • TOTal, ":SBUS:CAN:COUNt:TOTal" on page 281 • "*TRG (Trigger)" on page 83 • TRIGger Commands: • ":TRIGger:CAN:TRIGger" on page 333 • ":TRIGger:IIC:TRIGger:QUALifier" on page 361 • ":TRIGger:IIC:TRIGger[:TYPE]" on page 362 • ":TRIGger:LIN:TRIGger" on
4 Commands A-Z • ":TRIGger[:EDGE]:LEVel" on page 343 • ":TRIGger[:EDGE]:REJect" on page 344 • ":TRIGger[:EDGE]:SLOPe" on page 345 • ":TRIGger[:EDGE]:SOURce" on page 346 • ":TRIGger:GLITch:GREaterthan" on page 348 • ":TRIGger:GLITch:LESSthan" on page 349 • ":TRIGger:GLITch:LEVel" on page 350 • ":TRIGger:GLITch:POLarity" on page 351 • ":TRIGger:GLITch:QUALifier" on page 352 • ":TRIGger:GLITch:RANGe" on page 353 • ":TRIGger:GLITch:SOURce" on page 354 • ":TRIGger:HFReject" on page 317 • ":TRIGger:HOLDoff" on
Commands A-Z 4 • ":TRIGger:SWEep" on page 323 • ":TRIGger:TV:LINE" on page 382 • ":TRIGger:TV:MODE" on page 383 • ":TRIGger:TV:POLarity" on page 384 • ":TRIGger:TV:SOURce" on page 385 • ":TRIGger:TV:STANdard" on page 386 • ":TRIGger:TV:TVMode" on page 498 • ":TRIGger:UART:BAUDrate" on page 389 • ":TRIGger:UART:BITorder" on page 390 • ":TRIGger:UART:BURSt" on page 391 • ":TRIGger:UART:DATA" on page 392 • ":TRIGger:UART:IDLE" on page 393 • ":TRIGger:UART:PARity" on page 394 • ":TRIGger:UART:POLarity" on pag
4 Commands A-Z • ":SBUS:UART:COUNt:RESet" on page 290 • ":SBUS:UART:COUNt:RXFRames" on page 291 • ":SBUS:UART:COUNt:TXFRames" on page 292 • ":SBUS:UART:FRAMing" on page 293 • ":TRIGger:UART:BAUDrate" on page 389 • ":TRIGger:UART:BITorder" on page 390 • ":TRIGger:UART:BURSt" on page 391 • ":TRIGger:UART:DATA" on page 392 • ":TRIGger:UART:IDLE" on page 393 • ":TRIGger:UART:PARity" on page 394 • ":TRIGger:UART:POLarity" on page 395 • ":TRIGger:UART:QUALifier" on page 396 • ":TRIGger:UART:SOURce:RX" on page 3
Commands A-Z 4 • VTIMe, ":MEASure:VTIMe" on page 253 • VTOP, ":MEASure:VTOP" on page 254 W • "*WAI (Wait To Continue)" on page 85 • WAVeform Commands: • ":SAVE:WAVeform:FORMat" on page 274 • ":SAVE:WAVeform:LENGth" on page 275 • ":SAVE:WAVeform[:STARt]" on page 273 • ":WAVeform:BYTeorder" on page 408 • ":WAVeform:COUNt" on page 409 • ":WAVeform:DATA" on page 410 • ":WAVeform:FORMat" on page 412 • ":WAVeform:POINts" on page 413 • ":WAVeform:POINts:MODE" on page 415 • ":WAVeform:PREamble" on page 417 • ":W
4 Commands A-Z • XDELta, ":MARKer:XDELta" on page 210 • XINCrement, ":WAVeform:XINCrement" on page 428 • XMAX, ":MEASure:XMAX" on page 255 • XMIN, ":MEASure:XMIN" on page 256 • XORigin, ":WAVeform:XORigin" on page 429 • XREFerence, ":WAVeform:XREFerence" on page 430 Y • Y1Position, ":MARKer:Y1Position" on page 211 • Y2Position, ":MARKer:Y2Position" on page 212 • YDELta, ":MARKer:YDELta" on page 213 • YINCrement, ":WAVeform:YINCrement" on page 431 • YORigin, ":WAVeform:YORigin" on page 432 • YREFerence, "
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 5 Obsolete and Discontinued Commands Obsolete commands are older forms of commands that are provided to reduce customer rework for existing systems and programs (see"Obsolete Commands" on page 530).
5 458 Obsolete and Discontinued Commands Obsolete Command Current Command Equivalent :EXTernal:INPut (see page 468) :EXTernal:IMPedance (see page 174) :EXTernal:PMODe (see page 469) none FUNCtion1, FUNCtion2 :FUNCtion Commands (see page 181) :FUNCtion:VIEW (see page 470) :FUNCtion:DISPlay (see page 184) :HARDcopy:DESTination (see page 471) :HARDcopy:FILename (see page 473) :HARDcopy:DEVice (see page 472) :HARDcopy:FORMat (see page 474) :HARDcopy:FILename (see page 473) :RECall:FILename (se
5 Obsolete and Discontinued Commands Discontinued Commands Obsolete Command Current Command Equivalent Behavior Differences :MEASure:TMIN (see page 483) :MEASure:XMIN (see page 256) :MEASure:TSTArt (see page 484) :MARKer:X1Position (see page 206) :MEASure:TSTOp (see page 485) :MARKer:X2Position (see page 208) :MEASure:TVOLt (see page 486) :MEASure:TVALue (see page 244) TVALue measures additional values such as db, Vs, etc.
5 Obsolete and Discontinued Commands Discontinued Command Current Command Equivalent ASTore :DISPlay:PERSistence INFinite (see page 168) CHANnel:MATH :FUNCtion:OPERation (see page 186) ADD not included CHANnel:PROTect :CHANnel:PROTection (see page 156) Previous form of this command was used to enable/disable 50Ω protection. The new command resets a tripped protect and the query returns the status of TRIPed or NORMal.
Obsolete and Discontinued Commands Discontinued Parameters 5 Some previous oscilloscope queries returned control setting values of OFF and ON. The InfiniiVision 5000 Series oscilloscopes only return the enumerated values 0 (for off) and 1 (for on).
5 Obsolete and Discontinued Commands :CHANnel:LABel (see page 530) Command Syntax :CHANnel:LABel ::= {CHANnel1 | CHANnel2 | DIGital0,..,DIGital15} ::= quoted ASCII string The :CHANnel:LABel command sets the source text to the string that follows. Setting a channel will also result in the name being added to the label list. NOTE Query Syntax The :CHANnel:LABel command is an obsolete command provided for compatibility to previous oscilloscopes.
5 Obsolete and Discontinued Commands :CHANnel2:SKEW (see page 530) Command Syntax :CHANnel2:SKEW ::= skew time in NR3 format ::= -100 ns to +100 ns The :CHANnel2:SKEW command sets the skew between channels 1 and 2. The maximum skew is +/- 100 ns. You can use the oscilloscope's analog probe skew control to remove cable delay errors between channel 1 and channel 2.
5 Obsolete and Discontinued Commands :CHANnel:INPut (see page 530) Command Syntax :CHANnel:INPut ::= {ONEMeg | FIFTy} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :CHANnel:INPut command selects the input impedance setting for the specified channel. The legal values for this command are ONEMeg (1 MΩ) and FIFTy (50Ω).
Obsolete and Discontinued Commands 5 :CHANnel:PMODe (see page 530) Command Syntax :CHANnel:PMODe ::= {AUTo | MANual} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The probe sense mode is controlled internally and cannot be set. If a probe with sense is connected to the specified channel, auto sensing is enabled; otherwise, the mode is manual.
5 Obsolete and Discontinued Commands :DISPlay:CONNect (see page 530) Command Syntax :DISPlay:CONNect ::= {{ 1 | ON} | {0 | OFF}} The :DISPlay:CONNect command turns vectors on and 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. NOTE Query Syntax The :DISPlay:CONNEct command is an obsolete command provided for compatibility to previous oscilloscopes.
Obsolete and Discontinued Commands 5 :ERASe (see page 530) Command Syntax :ERASe The :ERASe command erases the screen. NOTE The :ERASe command is an obsolete command provided for compatibility to previous oscilloscopes. Use the :CDISplay command (see page 95) instead.
5 Obsolete and Discontinued Commands :EXTernal:INPut (see page 530) Command Syntax :EXTernal:INPut ::= {ONEMeg | FIFTy} The :EXTernal:IMPedance command selects the input impedance setting for the external trigger. The legal values for this command are ONEMeg (1 MΩ) and FIFTy (50Ω). NOTE Query Syntax The :EXTernal:INPut command is an obsolete command provided for compatibility to previous oscilloscopes. Use the :EXTernal:IMPedance command (see page 174) instead.
Obsolete and Discontinued Commands 5 :EXTernal:PMODe (see page 530) Command Syntax :EXTernal:PMODe ::= {AUTo | MANual} The probe sense mode is controlled internally 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 be accepted. Otherwise, a setting conflict error is generated.
5 Obsolete and Discontinued Commands :FUNCtion:VIEW (see page 530) Command Syntax :FUNCtion:VIEW ::= {{1 | ON} | (0 | OFF}} The :FUNCtion:VIEW command turns the selected 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. NOTE Query Syntax The :FUNCtion:VIEW command is provided for backward compatibility to previous oscilloscopes.
Obsolete and Discontinued Commands 5 :HARDcopy:DESTination (see page 530) Command Syntax :HARDcopy:DESTination ::= {CENTronics | FLOPpy} The :HARDcopy:DESTination command sets the hardcopy destination. NOTE Query Syntax The :HARDcopy:DESTination command is an obsolete command provided for compatibility to previous oscilloscopes. Use the :HARDcopy:FILename command (see page 473) instead.
5 Obsolete and Discontinued Commands :HARDcopy:DEVice (see page 530) Command Syntax :HARDcopy:DEVice ::= {TIFF | GIF | BMP | LASerjet | EPSon | DESKjet | BWDeskjet | SEIKo} The HARDcopy:DEVice command sets the hardcopy device type. NOTE BWDeskjet option refers to the monochrome Deskjet printer. NOTE The :HARDcopy:DEVice command is an obsolete command provided for compatibility to previous oscilloscopes. Use the :HARDcopy:FORMat command (see page 474) instead.
Obsolete and Discontinued Commands 5 :HARDcopy:FILename (see page 530) Command Syntax :HARDcopy:FILename ::= quoted ASCII string The HARDcopy:FILename command sets the output filename for those print formats whose output is a file. NOTE Query Syntax The :HARDcopy:FILename command is an obsolete command provided for compatibility to previous oscilloscopes. Use the :SAVE:FILename command (see page 264) and :RECall:FILename command (see page 258) instead.
5 Obsolete and Discontinued Commands :HARDcopy:FORMat (see page 530) Command Syntax :HARDcopy:FORMat ::= {BMP[24bit] | BMP8bit | PNG | CSV | ASCiixy | BINary | PRINter0 | PRINter1} The HARDcopy:FORMat 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 second is PRINter1.
Obsolete and Discontinued Commands 5 :HARDcopy:GRAYscale (see page 530) Command Syntax :HARDcopy:GRAYscale ::= {{OFF | 0} | {ON | 1}} The :HARDcopy:GRAYscale command controls whether grayscaling is performed in the hardcopy dump. NOTE Query Syntax The :HARDcopy:GRAYscale command is an obsolete command provided for compatibility to previous oscilloscopes. Use the :HARDcopy:PALette command (see page 200) instead.
5 Obsolete and Discontinued Commands :HARDcopy:IGColors (see page 530) Command Syntax :HARDcopy:IGColors ::= {{OFF | 0} | {ON | 1}} The HARDcopy:IGColors command controls whether the graticule colors are inverted or not. NOTE Query Syntax The :HARDcopy:IGColors command is an obsolete command provided for compatibility to previous oscilloscopes. Use the :HARDcopy:INKSaver (see page 199) command instead.
5 Obsolete and Discontinued Commands :HARDcopy:PDRiver (see page 530) Command Syntax :HARDcopy:PDRiver ::= {AP2Xxx | AP21xx | {AP2560 | AP25} | {DJ350 | DJ35} | DJ6xx | {DJ630 | DJ63} | DJ6Special | DJ6Photo | DJ8Special | DJ8xx | DJ9Vip | OJPRokx50 | DJ9xx | GVIP | DJ55xx | {PS470 | PS47} {PS100 | PS10} | CLASer | MLASer | LJFastraster | POSTscript} The HARDcopy:PDRiver command sets the hardcopy printer driver used for the selected printer.
5 Obsolete and Discontinued Commands :MEASure:LOWer (see page 530) Command Syntax :MEASure:LOWer The :MEASure:LOWer command sets the lower measurement threshold value. This value and the UPPer value represent absolute values when the thresholds are ABSolute and percentage when the thresholds are PERCent as defined by the :MEASure:DEFine THResholds command. NOTE Query Syntax The :MEASure:LOWer command is obsolete and is provided for backward compatibility to previous oscilloscopes.
Obsolete and Discontinued Commands 5 :MEASure:SCRatch (see page 530) 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 provided for backward compatibility to previous oscilloscopes. Use the :MEASure:CLEar command (see page 220) instead.
5 Obsolete and Discontinued Commands :MEASure:TDELta (see page 530) Query Syntax :MEASure:TDELta? The :MEASure:TDELta? query returns the time difference between the Tstop marker (X2 cursor) and the Tstart marker (X1 cursor). Tdelta = Tstop - Tstart Tstart is the time at the start marker (X1 cursor) and Tstop is the time at the stop marker (X2 cursor). No measurement is made when the :MEASure:TDELta? query is received by the oscilloscope. The delta time value that is output is the current value.
5 Obsolete and Discontinued Commands :MEASure:THResholds (see page 530) Command Syntax :MEASure:THResholds {T1090 | T2080 | VOLTage} The :MEASure:THResholds command selects the thresholds used when making time measurements. NOTE Query Syntax The :MEASure:THResholds command is obsolete and is provided for backward compatibility to previous oscilloscopes. Use the :MEASure:DEFine THResholds command (see page 222) instead.
5 Obsolete and Discontinued Commands :MEASure:TMAX (see page 530) Command Syntax :MEASure:TMAX [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:TMAX command installs a screen measurement and starts an X- at- Max- Y measurement on the selected waveform. If the optional source is specified, the current source is modified.
5 Obsolete and Discontinued Commands :MEASure:TMIN (see page 530) Command Syntax :MEASure:TMIN [] ::= {CHANnel | FUNCtion | MATH} ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models ::= {1 | 2} for the two channel oscilloscope models The :MEASure:TMIN command installs a screen measurement and starts an X- at- Min- Y measurement on the selected waveform. If the optional source is specified, the current source is modified.
5 Obsolete and Discontinued Commands :MEASure:TSTArt (see page 530) Command Syntax :MEASure:TSTArt [suffix] ::= time at the start marker in seconds [suffix] ::= {s | ms | us | ns | ps} The :MEASure:TSTArt command moves the start marker (X1 cursor) to the specified time with respect to the trigger time. NOTE The short form of this command, TSTA, does not follow the defined Long Form to Short Form Truncation Rules (see page 532).
Obsolete and Discontinued Commands 5 :MEASure:TSTOp (see page 530) Command Syntax :MEASure:TSTOp [suffix] ::= time at the stop marker in seconds [suffix] ::= {s | ms | us | ns | ps} The :MEASure:TSTOp command moves the stop marker (X2 cursor) to the specified time with respect to the trigger time. NOTE The short form of this command, TSTO, does not follow the defined Long Form to Short Form Truncation Rules (see page 532).
5 Obsolete and Discontinued Commands :MEASure:TVOLt (see page 530) Query Syntax :MEASure:TVOLt? , [][,] ::= the voltage level that the waveform must cross. ::= direction of the waveform. A rising slope is indicated by a plus sign (+). A falling edge is indicated by a minus sign (-). ::= the transition to be reported. If the occurrence number is one, the first crossing is reported. If the number is two, the second crossing is reported, etc.
Obsolete and Discontinued Commands 5 ::= time in seconds of the specified voltage crossing in NR3 format Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 487
5 Obsolete and Discontinued Commands :MEASure:UPPer (see page 530) Command Syntax :MEASure:UPPer The :MEASure:UPPer command sets the upper measurement threshold value. This value and the LOWer value represent absolute values when the thresholds are ABSolute and percentage when the thresholds are PERCent as defined by the :MEASure:DEFine THResholds command. NOTE Query Syntax The :MEASure:UPPer command is obsolete and is provided for backward compatibility to previous oscilloscopes.
Obsolete and Discontinued Commands 5 :MEASure:VDELta (see page 530) Query Syntax :MEASure:VDELta? The :MEASure:VDELta? query returns the voltage difference between vertical marker 1 (Y1 cursor) and vertical marker 2 (Y2 cursor). No measurement is made when the :MEASure:VDELta? query is received by the oscilloscope. The delta value that is returned is the current value. This is the same value as the front- panel cursors delta Y value.
5 Obsolete and Discontinued Commands :MEASure:VSTArt (see page 530) Command Syntax :MEASure:VSTArt ::= value for vertical marker 1 The :MEASure:VSTArt command moves the vertical marker (Y1 cursor) to the specified value corresponding to the selected source. The source can be selected by the MARKer:X1Y1source command. NOTE The short form of this command, VSTA, does not follow the defined Long Form to Short Form Truncation Rules (see page 532).
5 Obsolete and Discontinued Commands :MEASure:VSTOp (see page 530) Command Syntax :MEASure:VSTOp ::= value for Y2 cursor The :MEASure:VSTOp command moves the vertical marker 2 (Y2 cursor) to the specified value corresponding to the selected source. The source can be selected by the MARKer:X2Y2source command. NOTE The short form of this command, VSTO, does not follow the defined Long Form to Short Form Truncation Rules (see page 532).
5 Obsolete and Discontinued Commands :PRINt? (see page 530) Query Syntax :PRINt? [] ::= [][,..,] ::= {COLor | GRAYscale | BMP8bit | BMP} The :PRINt? query pulls image data back over the bus for storage. NOTE 492 The :PRINT command is an obsolete command provided for compatibility to previous oscilloscopes. Use the :DISPlay:DATA command (see page 164) instead.
Obsolete and Discontinued Commands NOTE See Also Old Print Option: Is Now: DISK invalid PCL invalid 5 The PRINt? query is not a core command.
5 Obsolete and Discontinued Commands :TIMebase:DELay (see page 530) Command Syntax :TIMebase:DELay ::= time in seconds from trigger to the delay reference point on the screen. The valid range for delay settings depends on the time/division setting for the main time base. The :TIMebase:DELay command sets the main time base delay. This delay is the time between the trigger event and the delay reference point on the screen.
Obsolete and Discontinued Commands 5 :TRIGger:CAN:ACKNowledge (see page 530) Command Syntax :TRIGger:CAN:ACKNowledge ::= {0 | OFF} This command was used with the N2758A CAN trigger module for 54620/54640 Series mixed- signal oscilloscopes. The InfiniiVision 5000 Series oscilloscopes do not support the N2758A CAN trigger module. Query Syntax :TRIGger:CAN:ACKNowledge? The :TRIGger:CAN:ACKNowledge? query returns the current CAN acknowledge setting.
5 Obsolete and Discontinued Commands :TRIGger:CAN:SIGNal:DEFinition (see page 530) Command Syntax :TRIGger:CAN:SIGNal:DEFinition ::= {CANH | CANL | RX | TX | DIFFerential} The :TRIGger:CAN:SIGNal:DEFinition command sets the CAN signal type when :TRIGger:CAN:TRIGger is set to SOF (start of frame). These signals can be set to: Dominant high signal: • CANH — the actual CAN_H differential bus signal. Dominant low signals: • CANL — the actual CAN_L differential bus signal.
Obsolete and Discontinued Commands 5 :TRIGger:LIN:SIGNal:DEFinition (see page 530) Command Syntax :TRIGger:LIN:SIGNal:DEFinition ::= {LIN | RX | TX} The :TRIGger:LIN:SIGNal:DEFinition command sets the LIN signal type. These signals can be set to: Dominant low signals: • LIN — the actual LIN single- end bus signal line. • RX — the Receive signal from the LIN bus transceiver. • TX — the Transmit signal to the LIN bus transceiver.
5 Obsolete and Discontinued Commands :TRIGger:TV:TVMode (see page 530) Command Syntax :TRIGger:TV:TVMode ::= {FIEld1 | FIEld2 | AFIelds | ALINes | LINE | VERTical | LFIeld1 | LFIeld2 | LALTernate | LVERtical} The :TRIGger:TV:MODE command selects the TV trigger mode and field. The LVERtical parameter is only available when :TRIGger:TV:STANdard is GENeric. The LALTernate parameter is not available when :TRIGger:TV:STANdard is GENeric (see page 386).
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 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, Out of memory -320, Storage fault -315, Configuration memory lost A 499
6 Error Messages -314, Save/recall memory lost -313, Calibration memory lost -311, Memory error -310, System error -300, Device specific error -278, Macro header not found -277, Macro redefinition not allowed -276, Macro recursion error -273, Illegal macro label -272, Macro execution error -258, Media protected -257, File name error -256, File name not found 500 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Error Messages 6 -255, Directory full -254, Media full -253, Corrupt media -252, Missing media -251, Missing mass storage -250, Mass storage error -241, Hardware missing This message can occur when a feature is unavailable or unlicensed.
6 Error Messages -223, Too much data -222, Data 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 expression -170, Expression error -168, Block data not allowed -161, Invalid block data -158, String data not allowed 502 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Error Messages 6 -151, Invalid string data -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, Invalid character in number -120, Numeric data error -114, Header suffix out of range -113, Undefined header Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 503
6 Error Messages -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, Software Fault Occurred +100, File Exists +101, End-Of-File Found +102, Read Error 504 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Error Messages 6 +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, Unknown File Type +113, Directory Not Supported Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 505
6 506 Error Messages Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 7 Status Reporting Status Reporting Data Structures 509 Status Byte Register (STB) 512 Service Request Enable Register (SRE) 514 Trigger Event Register (TER) 515 Output Queue 516 Message Queue 517 (Standard) Event Status Register (ESR) 518 (Standard) Event Status Enable Register (ESE) 519 Error Queue 520 Operation Status Event Register (:OPERegister[:EVENt]) 521 Operation Status Condition Register (:OPERegister:CONDition) 522 Arm Event
7 Status Reporting 7ULJJHU (YHQW 5HJLVWHU (UURU 4XHXH 0HVVDJH 4XHXH 581 %LW 2XWSXW 4XHXH 0DVN $UP (YHQW 5HJLVWHU 2YHUORDG (YHQW 5HJLVWHU 2YHUORDG (YHQW (QDEOH 5HJLVWHU 0DVN 6WDQGDUG (YHQW 6WDWXV 5HJLVWHU 6WDQGDUG (YHQW 6WDWXV (QDEOH 5HJLVWHU 0DVN +DUGZDUH (YHQW &RQGLWLRQ (YHQW 5HJLVWHUV +DUGZDUH (YHQW (QDEOH 5HJLVWHU 2SHUDWLRQ 6WDWXV &RQGLWLRQ (YHQW 5HJLVWHUV 2SHUDWLRQ 6WDWXV (QDEOH 5HJLVWHU 6WDWXV %\WH 5HJLVWHU 6HUYLFH 5HTXHVW (QDEOH 5HJLVWHU 6HUYLFH 5HTXHVW *HQHUDWLRQ 6HUYLFH 5HTXHVW
Status Reporting 7 Status Reporting Data Structures The following figure shows how the status register bits are masked and logically OR'ed to generate service requests (SRQ) on particular events.
7 Status Reporting %DW 21 3// /RFNHG +:(5HJLVWHU &21'LWLRQ" +DUGZDUH (YHQW &RQGLWLRQ 5HJLVWHU %DW 21 +:(5HJLVWHU> (9(1W@" +DUGZDUH (YHQW (YHQW 5HJLVWHU +:(HQDEOH +:(HQDEOH" +DUGZDUH (YHQW (QDEOH 0$6.
Status Reporting 7 The status register bits are described in more detail in the following tables: • "Status Byte Register (STB)" on page 81 • "Standard Event Status Register (ESR)" on page 68 • "Operation Status Condition Register" on page 107 • "Operation Status Event Register" on page 109 • "Overload Event Register (OVLR)" on page 113 • "Hardware Event Condition Register" on page 100 • "Hardware Event Event Register" on page 102 The status registers picture above shows how the different status reporting
7 Status Reporting Status Byte Register (STB) The Status Byte Register is the summary- level register in the status reporting structure. It contains summary bits that monitor activity in the other status registers and queues. The Status Byte Register is a live register. That is, its summary bits are set and cleared by the presence and absence of a summary bit from other event registers or queues.
7 Status Reporting The next program prints 0xD1 and clears bit 6 (RQS) and bit 4 (MAV) of the Status Byte Register. The difference in the output value between this example and the previous one is the value of bit 6 (weight = 64). Bit 6 is set when the first enabled summary bit is set and is cleared when the Status Byte Register is read by the serial poll command.
7 Status Reporting Service Request Enable Register (SRE) Setting the Service Request Enable Register bits enable corresponding bits in the Status Byte Register. These enabled bits can then set RQS and MSS (bit 6) in the Status Byte Register. Bits are set in the Service Request Enable Register 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.
Status Reporting 7 Trigger Event Register (TER) This register sets the TRG bit in the status byte when a trigger event occurs. The TER event register stays set until it is cleared by reading the register or using the *CLS command. If your application needs to detect multiple triggers, the TER event register must be cleared after each one. If you are using the Service Request to interrupt a program or controller operation, you must clear the event register each time the trigger bit is set.
7 Status Reporting Output Queue The output queue stores the oscilloscope- to- controller responses that are generated by certain instrument commands and queries. The output queue generates the Message Available summary bit when the output queue contains one or more bytes. This summary bit sets the MAV bit (bit 4) in the Status Byte Register. When using the Agilent VISA COM library, the output queue may be read with the FormattedIO488 object's ReadString, ReadNumber, ReadList, or ReadIEEEBlock methods.
7 Status Reporting Message 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 sent with the :SYSTem:DSP command do not set the MSG status bit in the Status Byte Register.
7 Status Reporting (Standard) Event Status Register (ESR) The (Standard) Event Status Register (ESR) monitors the following oscilloscope status events: • PON - Power On • URQ - User Request • CME - Command Error • EXE - Execution Error • DDE - Device Dependent Error • QYE - Query Error • RQC - Request Control • OPC - Operation Complete When one of these events occur, the event sets the corresponding bit in the register.
7 Status Reporting (Standard) Event Status Enable Register (ESE) To allow any of the (Standard) Event Status Register (ESR) bits to generate a summary bit, you must first enable that bit. Enable the bit by using the *ESE (Event Status Enable) common command to set the corresponding bit in the (Standard) Event Status Enable Register (ESE). Set bits are read with the *ESE? query. Example Suppose your application requires an interrupt whenever any type of error occurs.
7 Status Reporting Error Queue As errors are detected, they are placed in an error queue. This queue is first in, first out. If the error queue overflows, the last error in the queue is replaced with error 350, Queue overflow. Any time the queue overflows, the least recent errors remain in the queue, and the most recent error is discarded. The length of the oscilloscope's error queue is 30 (29 positions for the error messages, and 1 position for the Queue overflow message).
Status Reporting 7 Operation Status Event Register (:OPERegister[:EVENt]) This register hosts the RUN bit (bit 3), the WAIT TRIG bit (bit 5), and the OVLR bit (bit 11). • The RUN bit is set whenever the instrument goes from 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.
7 Status Reporting Operation Status Condition Register (:OPERegister:CONDition) This register hosts the RUN bit (bit 3), the WAIT TRIG bit (bit 5), the OVLR 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 bit is set whenever the instrument is not stopped.
Status Reporting 7 Arm Event Register (AER) This register sets bit 5 (Wait Trig bit) in the Operation Status Register and the OPER bit (bit 7) in the Status Byte Register when the instrument becomes armed. The ARM event register stays set until it is cleared by reading the register with the AER? query or using the *CLS command. If your application needs to detect multiple triggers, the ARM event register must be cleared after each one.
7 Status Reporting Hardware Event Event Register (:HWERegister[:EVENt]) This register hosts the PLL LOCKED bit (bit 12). • The PLL LOCKED bit (bit 12) is for internal use and is not intended for general use.
Status Reporting 7 Hardware Event Condition Register (:HWERegister:CONDition) This register hosts 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 for internal use and is not intended for general use.
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 message terminator, the output queue is also cleared.
Status Reporting 7 Status Reporting Decision Chart QR 'R \RX ZDQW WR GR VWDWXV UHSRUWLQJ" \HV 5HVHW WKH LQVWUXPHQW DQG FOHDU WKH VWDWXV UHJLVWHUV P\6FRSH :ULWH6WULQJ 567 P\6FRSH :ULWH6WULQJ &/6 'R \RX ZDQW WR VHQG D 6HUYLFH 5HTXHVW 654 LQWHUUXSW WR WKH FRQWUROOHU" QR
7 528 Status Reporting Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 8 More About Oscilloscope Commands Command Classifications 530 Valid Command/Query Strings 531 Query Return Values 547 All Oscilloscope Commands Are Sequential 548 A 529
8 More About Oscilloscope Commands Command Classifications To help you use existing programs with your oscilloscope, or use current programs with the next generation of oscilloscopes, commands are classified by the following categories: • "Core Commands" on page 530 • "Non- Core Commands" on page 530 • "Obsolete Commands" on page 530 Core Commands Core commands are a common set of commands that provide basic oscilloscope functionality on this oscilloscope and future Agilent oscilloscopes.
More About Oscilloscope Commands 8 Valid Command/Query Strings • "Program Message Syntax" on page 531 • "Command Tree" on page 535 • "Duplicate Mnemonics" on page 545 • "Tree Traversal Rules and Multiple Commands" on page 545 Program Message Syntax To program the instrument remotely, you must understand the command format and structure expected by the instrument. The IEEE 488.
8 More About Oscilloscope Commands Instruction Header The instruction header is one or more mnemonics separated by colons (:) that represent the operation to be performed by the instrument. The "Command Tree" on page 535 illustrates how all the mnemonics can be joined together to form a complete header. ":DISPlay:LABel ON" is a command. Queries are indicated by adding a question mark (?) to the end of the header, for example, ":DISPlay:LABel?".
8 More About Oscilloscope Commands • When the command/keyword is longer than four characters, use the first four characters of the command/keyword unless the fourth character is a vowel; when the fourth character is a vowel, use the first three characters of the command/keyword. • When the command/keyword is four or fewer characters, use all of the characters.
8 More About Oscilloscope Commands For example, :CHANnel1:BWLimit ON Common Command Headers Common command headers control IEEE 488.2 functions within the instrument (such as clear status). Their syntax is: * No space or separator is allowed between the asterisk (*) and the command header. *CLS is an example of a common command header. Program Data Syntax Rules Program data is used to convey a parameter information related to the command header.
More About Oscilloscope Commands 8 When a syntax definition specifies that a number is an integer, that means that the number should be whole. Any fractional part will be ignored, truncating the number. Numeric data parameters accept fractional values are called real numbers. All numbers must be strings of ASCII characters. Thus, when sending the number 9, you would send a byte representing the ASCII code for the character 9 (which is 57).
8 More About Oscilloscope Commands • :TIME (see page 141) • :CDISplay (see page 95) • :CHANnel (see page 142) • :BWLimit (see page 145) • :COUPling (see page 146) • :DISPlay (see page 147) • :IMPedance (see page 148) • :INVert (see page 149) • :LABel (see page 150) • :OFFSet (see page 151) • :PROBe (see page 152) • :ID (see page 153) • :SKEW (see page 154) • :STYPe (see page 155) • :PROTection (see page 156) • :RANGe (see page 157) • :SCALe (see page 158) • :UNITs (see page 159) • :VERNier (see page 16
More About Oscilloscope Commands 8 • :RANGe (see page 179) • :UNITs (see page 180) • :FUNCtion (see page 181) • :CENTer (see page 183) • :DISPlay (see page 184) • :OFFSet (see page 185) • :OPERation (see page 186) • :RANGe (see page 187) • :REFerence (see page 188) • :SCALe (see page 189) • :SOURce (see page 190) • :SPAN (see page 191) • :WINDow (see page 192) • :HARDcopy (see page 193) • :AREA (see page 195) • :APRinter (see page 196) • :FACTors (see page 197) • :FFEed (see page 198) • :INKSaver (see pag
8 More About Oscilloscope Commands • :Y2Position (see page 212) • :YDELta (see page 213) • :MEASure (see page 214) • :CLEar (see page 220) • :COUNter (see page 221) • :DEFine (see page 222) • :DELay (see page 225) • :DUTYcycle (see page 227) • :FALLtime (see page 228) • :FREQuency (see page 229) • :NWIDth (see page 230) • :OVERshoot (see page 231) • :PERiod (see page 233) • :PHASe (see page 234) • :PREShoot (see page 235) • :PWIDth (see page 236) • :RISetime (see page 237) • :SDEViation (see page 238) • :
More About Oscilloscope Commands 8 • :OPERegister • :CONDition (Operation Status Condition Register) (see page 107) • [:EVENt] (Operation Status Event Register) (see page 109) • :OVLenable (Overload Event Enable Register) (see page 111) • :OVLRegister (Overload Event Register) (see page 113) • :RECall • :FILename (see page 258) • :IMAGe (see page 259) • [:STARt] (see page 259) • :PWD (see page 260) • :SETup (see page 261) • [:STARt] (see page 261) • :RUN (see page 116) • :SAVE • :FILename (see page 264) •
8 More About Oscilloscope Commands • :TOTal (see page 281) • :UTILization (see page 282) • :DISPlay (see page 283) • :IIC • :WIDTh (see page 287) • :LIN • :PARity (see page 285) • :MODE (see page 286) • :SPI • :ASIZe (see page 284) • :UART • :BASE (see page 288) • :COUNt • :ERRor (see page 289) • :RESet (see page 290) • :RXFRames (see page 291) • :TXFRames (see page 292) • :FRAMing (see page 293) • :SERial (see page 117) • :SINGle (see page 118) • :STATus (see page 119) • :STOP (see page 120) • :SYSTem (s
More About Oscilloscope Commands 8 • :SCALe (see page 308) • :VERNier (see page 309) • :WINDow • :POSition (see page 310) • :RANGe (see page 311) • :SCALe (see page 312) • :TRIGger (see page 313) • :HFReject (see page 317) • :HOLDoff (see page 318) • :MODE (see page 319) • :NREJect (see page 320) • :PATTern (see page 321) • :SWEep (see page 323) • :CAN (see page 324) • :ACKNowledge (see page 495) • :PATTern • :DATA (see page 326) • :LENGth (see page 327) • :ID (see page 328) • :MODE (see page 329) • :SAMP
8 More About Oscilloscope Commands • :REJect (see page 344) • :SLOPe (see page 345) • :SOURce (see page 346) • :GLITch (see page 347) • :GREaterthan (see page 348) • :LESSthan (see page 349) • :LEVel (see page 350) • :POLarity (see page 351) • :QUALifier (see page 352) • :RANGe (see page 353) • :SOURce (see page 354) • :HFReject (see page 317) • :HOLDoff (see page 318) • :IIC (see page 355) • :PATTern • :ADDRess (see page 356) • :DATA (see page 357) • :DATa2 (see page 358) • :SOURce • :CLOCk (see page 359
More About Oscilloscope Commands 8 • :NREJect (see page 320) • :PATTern (see page 321) • :SPI (see page 372) • :CLOCk • :SLOPe (see page 373) • :TIMeout (see page 374) • :FRAMing (see page 375) • :PATTern • :DATA (see page 376) • :WIDTh (see page 377) • :SOURce • :CLOCk (see page 378) • :DATA (see page 379) • :FRAMe (see page 380) • :SWEep (see page 323) • :TV (see page 381) • :LINE (see page 382) • :MODE (see page 383) • :POLarity (see page 384) • :SOURce (see page 385) • :STANdard (see page 386) • :TVMo
8 More About Oscilloscope Commands • :WIDTh (see page 400) • :VIEW (see page 122) • :WAVeform (see page 401) • :BYTeorder (see page 408) • :COUNt (see page 409) • :DATA (see page 410) • :FORMat (see page 412) • :POINts (see page 413) • :MODE (see page 415) • :PREamble (see page 417) • :SOURce (see page 420) • :SUBSource (see page 424) • :TYPE (see page 425) • :UNSigned (see page 426) • :VIEW (see page 427) • :XINCrement (see page 428) • :XORigin (see page 429) • :XREFerence (see page 430) • :YINCrement (s
8 More About Oscilloscope Commands • *WAI (see page 85) Duplicate Mnemonics Identical function mnemonics can be used in more than one subsystem. For example, the function mnemonic 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 horizontal time base to 1 second full scale. :CHANnel1 and :TIMebase are subsystem selectors and determine which range is being modified.
8 More About Oscilloscope Commands myScope.WriteString ":TIMebase:RANGe 0.5;POSition 0" NOTE Example 2: Program Message Terminator Sets Parser Back to Root NOTE The colon between TIMebase and RANGe is necessary because TIMebase:RANGe is a compound command. The semicolon between the RANGe command and the POSition command is the required program message unit separator.
8 More About Oscilloscope Commands Query Return Values Command headers immediately followed by a question mark (?) are queries. Queries are used to get results of measurements made by the instrument or to find out how the instrument is currently configured. After receiving a query, the instrument interrogates the requested function and places the answer in its output queue. The answer remains in the output queue until it is read or another command is issued.
8 More About Oscilloscope Commands All Oscilloscope Commands Are Sequential IEEE 488.2 makes the distinction between sequential and overlapped commands: • Sequential commands finish their task before the execution of the next command starts. • Overlapped commands run concurrently. Commands following an overlapped command may be started before the overlapped command is completed. All of the oscilloscope commands are sequential.
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 9 Programming Examples SICL Example in C 550 VISA Example in C 559 VISA Example in Visual Basic 568 VISA COM Example in Visual Basic 578 Example programs are ASCII text files that can be cut from the help file and pasted into your favorite text editor.
9 Programming Examples SICL Example in C /* * Agilent SICL Example in C * -----------------------------------------------------------------* This program illustrates most of the commonly-used programming * features of your Agilent oscilloscope. * This program is to be built as a WIN32 console application. * Edit the DEVICE_ADDRESS line to specify the address of the * applicable device. */ #include #include "sicl.h" /* For printf(). */ /* SICL routines.
Programming Examples 9 if (id == 0) { printf ("Oscilloscope iopen failed!\n"); } else { printf ("Oscilloscope session initialized!\n"); /* Set the I/O timeout value for this session to 5 seconds. */ itimeout(id, TIMEOUT); /* Clear the interface. */ iclear(id); iremote(id); } initialize(); /* The extras function contains miscellaneous commands that do not * need to be executed for the proper operation of this example. * The commands in the extras function are shown for reference * purposes only.
9 Programming Examples iprintf(id, "*RST\n"); /* Write the *IDN? string and send an EOI indicator, then read * the response into buf. ipromptf(id, "*IDN?\n", "%t", buf); printf("%s\n", buf); */ /* AUTOSCALE - This command evaluates all the input signals and * sets the correct conditions to display all of the active signals. */ iprintf(id, ":AUTOSCALE\n"); /* CHANNEL_PROBE - Sets the probe attenuation factor for the * selected channel. The probe attenuation factor may be from * 0.1 to 1000.
Programming Examples 9 * function from main. */ void extra (void) { /* RUN_STOP (not executed in this example): * - RUN starts the acquisition of data for the active waveform * display. * - STOP stops the data acquisition and turns off AUTOSTORE. */ iprintf(id, ":RUN\n"); iprintf(id, ":STOP\n"); /* VIEW_BLANK (not executed in this example): * - VIEW turns on (starts displaying) an active channel or pixel * memory. * - BLANK turns off (stops displaying) a specified channel or * pixel memory.
9 Programming Examples * communication with the computer interrupts data acquisition. * Setting up the oscilloscope over the bus causes the data * buffers to be cleared and internal hardware to be reconfigured. * If a measurement is immediately requested there may not have * been enough time for the data acquisition process to collect * data and the results may not be accurate. An error value of * 9.9E+37 may be returned over the bus in this situation.
9 Programming Examples printf("Read setup string (%d bytes) from file.\n", setup_size); /* Restore setup string. */ iprintf(id, ":SYSTEM:SETUP #8%08d", setup_size); ifwrite(id, setup_string, setup_size, 1, &setup_size); printf("Restored setup string (%d bytes).\n", setup_size); /* IMAGE_TRANSFER - In this example we will query for the image * data with ":DISPLAY:DATA?" to read the data and save the data * to the file "image.dat" which you can then send to a printer.
9 Programming Examples printf ("Data Point %4d = %6.2f Volts at %10f Seconds\n", i, ((float)waveform_data[i] - preamble[9]) * preamble[7] + preamble[8], ((float)i - preamble[6]) * preamble[4] + preamble[5]); save_waveform(); retrieve_waveform(); /* Save waveform data to disk. */ /* Load waveform data from disk.
9 Programming Examples * XREFERENCE : int32 - specifies the data point associated * with the x-origin. * YINCREMENT : float32 - voltage difference between data points. * YORIGIN : float32 - value of the voltage at center screen. * YREFERENCE : int32 - data point where y-origin occurs.
9 Programming Examples } /* * save_waveform * -----------------------------------------------------------------* This function saves the waveform data from the get_waveform * function to disk. The data is saved to a file called "wave.dat". */ void save_waveform(void) { FILE *fp; fp = fopen("c:\\scope\\data\\wave.dat", "wb"); /* Write preamble. */ fwrite(preamble, sizeof(preamble[0]), 10, fp); /* Write actually waveform data.
9 Programming Examples VISA Example in C /* * Agilent VISA Example in C * -----------------------------------------------------------------* This program illustrates most of the commonly-used programming * features of your Agilent oscilloscope. * This program is to be built as a WIN32 console application. * Edit the RESOURCE line to specify the address of the * applicable device. */ #include #include /* For printf(). */ /* Agilent VISA routines.
9 Programming Examples /* Clear the interface. */ viClear(vi); initialize(); /* The extras function contains miscellaneous commands that do not * need to be executed for the proper operation of this example. * The commands in the extras function are shown for reference * purposes only. */ /* extra(); */ /* <-- Uncomment to execute the extra function */ capture(); analyze(); /* Close session */ viClose(vi); viClose(defaultRM); printf ("Program execution is complete...
9 Programming Examples /* CHANNEL_RANGE - Sets the full scale vertical range in volts. * The range value is eight times the volts per division. */ viPrintf(vi, ":CHANNEL1:RANGE 8\n"); /* TIME_RANGE - Sets the full scale horizontal time in seconds. * The range value is ten times the time per division. */ viPrintf(vi, ":TIM:RANG 2e-3\n"); /* TIME_REFERENCE - Possible values are LEFT and CENTER: * - LEFT sets the display reference one time division from the * left.
9 Programming Examples */ viPrintf(vi, ":BLANK CHANNEL1\n"); viPrintf(vi, ":VIEW CHANNEL1\n"); /* TIME_MODE (not executed in this example) - Set the time base * mode to MAIN, DELAYED, XY or ROLL. */ viPrintf(vi, ":TIMEBASE:MODE MAIN\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.
9 Programming Examples */ void analyze (void) { double frequency, vpp; double vdiv, off, sdiv, delay; /* Measurements. */ /* Values calculated from preamble data. */ int i; /* Loop counter. */ unsigned char setup_string[SETUP_STR_SIZE]; /* Array for setup string. */ int setup_size; FILE *fp; unsigned char image_data[IMG_SIZE]; * Array for image data. */ int img_size; /* SAVE_SYSTEM_SETUP - The :SYSTEM:SETUP? query returns a program * message that contains the current state of the instrument.
9 Programming Examples /* Write image data to file. */ fp = fopen ("c:\\scope\\data\\screen.bmp", "wb"); img_size = fwrite(image_data, sizeof(unsigned char), img_size, fp); fclose (fp); printf("Wrote image data (%d bytes) to file.\n", img_size); viSetAttribute(vi, VI_ATTR_TMO_VALUE, 5000); /* MEASURE - The commands in the MEASURE subsystem are used to * make measurements on displayed waveforms. */ /* Set source to measure. */ viPrintf(vi, ":MEASURE:SOURCE CHANNEL1\n"); /* Query for frequency.
9 Programming Examples void get_waveform (void) { int waveform_size; /* WAVEFORM_DATA - To obtain waveform data, you must specify the * WAVEFORM parameters for the waveform data prior to sending the * ":WAVEFORM:DATA?" query. * * Once these parameters have been sent, the ":WAVEFORM:PREAMBLE?" * query provides information concerning the vertical and horizontal * scaling of the waveform data.
9 Programming Examples printf("Preamble YINCREMENT: %e\n", preamble[7]); printf("Preamble YORIGIN: %e\n", preamble[8]); printf("Preamble YREFERENCE: %e\n", preamble[9]); */ /* QUERY_WAVE_DATA - Outputs waveform records to the controller * over the interface that is stored in a buffer previously * specified with the ":WAVEFORM:SOURCE" command. */ viPrintf(vi, ":WAVEFORM:DATA?\n"); /* Query waveform data.
Programming Examples 9 /* Write actually waveform data. */ fwrite(waveform_data, sizeof(waveform_data[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.dat", "rb"); /* Read preamble. */ fread(preamble, sizeof(preamble[0]), 10, fp); /* Read the waveform data.
9 Programming Examples VISA Example in Visual Basic ' ' ' ' ' ' Agilent VISA Example in Visual Basic ------------------------------------------------------------------This program illustrates most of the commonly-used programming features of your Agilent oscilloscope. ------------------------------------------------------------------- Option Explicit Public err As Long Public drm As Long Public vi As Long ' Error returned by VISA function calls. ' Session to Default Resource Manager.
9 Programming Examples ' ' ' ' ' VISA Interface. "GPIB0::7::INSTR" is the address string for the device this address will be the same as seen in: Start->Programs->Agilent IO Libraries->VISA Assistant (after the VISA Interface Name is defined in IO Config).
9 Programming Examples ' *RST. It is not necessary to reinitialize them unless the default ' setting is not suitable for your application. ' Reset the oscilloscope to the defaults. err = viVPrintf(vi, "*RST" + vbLf, 0) ' IDN - Ask for the device's *IDN string. err = viVPrintf(vi, "*IDN?" + vbLf, 0) err = viVScanf(vi, "%t", strQueryResult) ' Read the results as a ' string. ' Display results.
9 Programming Examples ' The following commands are not executed and are shown for reference ' purposes only. To execute these commands, uncomment them. ' RUN_STOP - (not executed in this example) ' - RUN starts the acquisition of data for the active waveform ' display. ' - STOP stops the data acquisition and turns off AUTOSTORE. ' Start data acquisition. ' err = viVPrintf(vi, ":RUN" + vbLf, 0) ' Stop the data acquisition.
9 Programming Examples ' available for measurement. If DIGITIZE is used with single mode, ' the completion 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 memory, a sweep speed of 10 us/div (100 us ' total time across the screen), and a 20 MSa/s maximum sample rate. ' 1000 divided by 100 us equals 10 MSa/s.
9 Programming Examples ' Output setup string to a file: Dim strPath As String Dim lngI As Long strPath = "c:\scope\config\setup.dat" 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 lngSetupStringSize - 1 Put #1, , byteArray(lngI) ' Write data. Next lngI Close #1 ' Close file. ' IMAGE_TRANSFER - In this example, we will query for the image data ' with ":DISPLAY:DATA?", read the data, and then save it to a file.
9 Programming Examples FormatNumber(dblQueryResult / 1000, 4) + " kHz" ' Query for duty cycle. err = viVPrintf(vi, ":MEASURE:DUTYCYCLE?" + vbLf, 0) ' Read duty cycle. err = viVScanf(vi, "%lf" + vbLf, VarPtr(dblQueryResult)) MsgBox "Duty cycle:" + vbCrLf + FormatNumber(dblQueryResult, 3) + "%" ' Query for risetime. err = viVPrintf(vi, ":MEASURE:RISETIME?" + vbLf, 0) ' Read risetime.
Programming Examples 9 ' GET_PREAMBLE - The preamble block contains all of the current ' WAVEFORM settings. It is returned in the form ' where is: ' FORMAT : int16 - 0 = BYTE, 1 = WORD, 2 = ASCII. ' TYPE : int16 - 0 = NORMAL, 1 = PEAK DETECT, 2 = AVERAGE. ' 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.
9 Programming Examples ' CStr(lngXReference) + vbCrLf 'strOutput = strOutput + "Y increment = " + _ ' FormatNumber(sngYIncrement * 1000) + _ ' " mV" + vbCrLf 'strOutput = strOutput + "Y origin = " + _ ' FormatNumber(sngYOrigin) + " V" + vbCrLf 'strOutput = strOutput + "Y reference = " + _ ' CStr(lngYReference) + vbCrLf strOutput = strOutput + "Volts/Div = " + _ FormatNumber(lngVSteps * sngYIncrement / 8) + _ " V" + vbCrLf strOutput = strOutput + "Offset = " + _ FormatNumber(sngYOrigin) + " V" + vbCrLf str
Programming Examples 9 CStr(lngI / intBytesPerData) + ", " + _ FormatNumber((lngDataValue - lngYReference) * sngYIncrement + _ sngYOrigin) + " V, " + _ FormatNumber(((lngI / intBytesPerData - lngXReference) * _ dblXIncrement + dblXOrigin) * 1000000) + " us" + vbCrLf Next lngI MsgBox "Waveform data:" + vbCrLf + strOutput ' Make a delay measurement between channel 1 and 2.
9 Programming Examples VISA COM Example in Visual Basic ' ' ' ' ' ' Agilent VISA COM Example in Visual Basic ------------------------------------------------------------------This program illustrates most of the commonly used programming features of your Agilent oscilloscopes. ------------------------------------------------------------------- Option Explicit Public Public Public Public ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' myMgr As VisaComLib.ResourceManager myScope As VisaComLib.
9 Programming Examples ' DIGITIZE command. Capture ' Analyze - Once the waveform has been captured, it 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 Exit Sub VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.
9 Programming Examples ' CHANNEL_RANGE - Sets the full scale vertical range in volts. ' range value is 8 times the volts per division. The ' Set the vertical range to 8 volts. myScope.WriteString ":CHANNEL1:RANGE 8" ' TIME_RANGE - Sets the full scale horizontal time in seconds. ' range value is 10 times the time per division. The ' Set the time range to 0.002 seconds. myScope.WriteString ":TIM:RANG 2e-3" ' TIME_REFERENCE - Possible values are LEFT and CENTER.
9 Programming Examples VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.Description End Sub ' ' ' ' ' Capture ------------------------------------------------------------------We will capture the waveform using the digitize command. ------------------------------------------------------------------- Private Sub Capture() On Error GoTo VisaComError ' AQUIRE_TYPE - Sets the acquisition mode, which can be NORMAL, ' PEAK, or AVERAGE. myScope.
9 Programming Examples VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.Description End Sub ' ' ' ' ' ' ' ' ' ' Analyze ------------------------------------------------------------------In analyze, we will do the following: - Save the system setup to a file and restore it. - Save the waveform data to a file on the computer. - Make single channel measurements. - Save the oscilloscope display to a file that can be sent to a printer.
Programming Examples 9 ' it back to the oscilloscope. Dim varSetupString As Variant strPath = "c:\scope\config\setup.dat" Open strPath For Binary Access Read As #1 ' Open file for input. Get #1, , varSetupString ' Read data. Close #1 ' Close file. ' Write setup string back to oscilloscope using ":SYSTEM:SETUP" ' command: myScope.WriteIEEEBlock ":SYSTEM:SETUP ", varSetupString CheckForInstrumentErrors ' MEASURE - The commands in the MEASURE subsystem are used to make ' measurements on displayed waveforms.
9 Programming Examples ' using the ":WAVEFORM:DATA?" query. myScope.WriteString ":WAVEFORM:POINTS 1000" ' WAVE_FORMAT - Sets the data transmission mode for the waveform ' data output. This command controls whether data is formatted in ' a word or byte format when sent from the oscilloscope. Dim lngVSteps As Long Dim intBytesPerData As Integer ' Data in range 0 to 65535. myScope.WriteString ":WAVEFORM:FORMAT WORD" lngVSteps = 65536 intBytesPerData = 2 ' Data in range 0 to 255. 'myScope.
9 Programming Examples sngYOrigin = Preamble(8) lngYReference = Preamble(9) strOutput = "" 'strOutput = strOutput + "Format = " + CStr(intFormat) + vbCrLf 'strOutput = strOutput + "Type = " + CStr(intType) + vbCrLf 'strOutput = strOutput + "Points = " + CStr(lngPoints) + vbCrLf 'strOutput = strOutput + "Count = " + CStr(lngCount) + vbCrLf 'strOutput = strOutput + "X increment = " + _ ' FormatNumber(dblXIncrement * 1000000) + _ ' " us" + vbCrLf 'strOutput = strOutput + "X origin = " + _ ' FormatNumber(dblX
9 Programming Examples varQueryResult = myScope.ReadIEEEBlock(BinaryType_UI1) For lngI = 0 To UBound(varQueryResult) _ Step (UBound(varQueryResult) / 20) ' 20 points. If intBytesPerData = 2 Then lngDataValue = varQueryResult(lngI) * 256 + _ varQueryResult(lngI + 1) ' 16-bit value. Else lngDataValue = varQueryResult(lngI) ' 8-bit value.
9 Programming Examples MsgBox "Phase = " + vbCrLf + CStr(dblPhase) Exit Sub VisaComError: MsgBox "VISA COM Error:" + vbCrLf + Err.Description End Sub Private Sub CheckForInstrumentErrors() On Error GoTo VisaComError Dim strErrVal As String Dim strOut As 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 myScope.
9 588 Programming Examples Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Index Symbols +9.9E+37, infinity representation, 547 +9.
Index clear message queue, 65 clear screen, 467 clear status, 65 clear waveform area, 161 clipped high waveform data value, 410 clipped low waveform data value, 410 clock, 359, 373, 374, 378 CLOCk commands, 437 CLS (Clear Status), 65 CME (Command Error) status bit, 67, 69 code, *RST, 77 code, :ACQuire:COMPlete, 126 code, :ACQuire:TYPE, 133 code, :AUToscale, 91 code, :CHANnel:LABel, 150 code, :CHANnel:PROBe, 152 code, :CHANnel:RANGe, 157 code, :DIGitize, 96 code, :DISPlay:DATA, 165 code, :DISPlay:LABel, 166
Index display reference, 305, 307 display reset conditions, 75 display serial number, 117 display source, 169 display vectors, 170 display, clearing, 95 display, oscilloscope, 168, 169, 170, 184, 296 display, serial decode bus, 283 displaying a baseline, 323 displaying unsynchronized signal, 323 driver, printer, 477 duplicate mnemonics, 545 duration, 336, 337, 340 duration for glitch trigger, 348, 349, 353 duration pattern, 338 duration qualifier, trigger, 336, 337, 339 DURation trigger commands, 335 durat
Index glitch trigger duration, 348 glitch trigger polarity, 351 glitch trigger source, 348 graphics, 164 graticule area for hardcopy print, 195 graticule area for saved image, 266 graticule colors, invert for hardcopy, 199, 476 graticule colors, invert for image, 269 graticule data, 164 grayscale palette for hardcopy, 200 grayscale palette for image, 270 grayscaling on hardcopy, 475 greater than qualifier, 352 greater than time, 336, 340, 348, 353 GREaterthan commands, 441 H HANNing window for frequency r
Index LIN trigger commands, 364 LIN trigger definition, 497 line glitch trigger source, 354 line number for TV trigger, 382 line terminator, 56 LINE trigger level, 343 LINE trigger source, 346 list of channel labels, 167 load utilization (CAN), 282 local lockout, 298 lock, 298 lockout message, 298 long form, 532 lower threshold, 233 lower threshold voltage for measurement, 478 lowercase characters in commands, 531 low-frequency reject filter, 344 low-pass filter used to limit bandwidth, 145, 173 LRN (Learn
Index OPC (Operation Complete) status bit, 67, 69 OPEE (Operation Status Enable Register), 105 operating configuration, 71, 299 operating state, 78 operation complete, 72 operation status condition register, 107 Operation Status Condition Register (:OPERegister:CONDition), 107, 522 operation status conditions occurred, 82 Operation Status Enable Register (OPEE), 105 operation status event register, 109 Operation Status Event Register (:OPERegister[:EVENt]), 109, 521 operation, math, 182 operations for func
Index recall filename, 258 recall image, 259 recall setup, 261 recalling and saving data, 161 RECTangular window for transient signals, 192 reference, 182, 307 REFerence commands, 447 reference for time base, 494 reference level, Fast Fourier Transform (FFT) function, 188 registers, 68, 74, 78, 89, 98, 100, 102, 105, 107, 109, 111, 113 registers, clearing, 526 reject filter, 344 reject high frequency, 317 reject noise, 320 remote control example, 550, 559, 568, 578 remove cursor information, 205 remove lab
Index STB (Status Byte Register), 79, 81, 82, 512 step size for frequency span, 191 stop, 96, 120 stop acquisition, 120 stop cursor, 485 stop displaying channel, 94 stop displaying math function, 94 stop displaying pod, 94 stop time, 353, 485 storage, 78 store instrument setup, 71, 78 store setup, 78 store waveforms to pixel memory, 104 storing calibration information, 136 string, quoted ASCII, 57 subsource, waveform source, 424 subsystem commands, 60, 545 subtract math function, 182, 186, 420 sweep mode,
Index trigger, TV source, 385 trigger, TV standard, 386 trigger, UART baudrate, 389 trigger, UART bit order, 390 trigger, UART parity, 394 trigger, UART polarity, 395 trigger, UART Rx source, 397 trigger, UART Tx source, 398 trigger, UART width, 400 truncation rules, 532 TST (Self Test), 84 tstart, 484 tstop, 485 turn function on or off, 470 turn off channel, 94 turn off channel labels, 166 turn off cursors, 90 turn off delayed time base mode, 90 turn off digital pod, 94 turn off math function, 94 turn off
Index word width, SPI decode, 287 write text to display, 296 write trace memory, 164 X X axis markers, 204 X delta, 210 X1 and X2 cursor value difference, 210 X1 cursor, 204, 206, 207 X2 cursor, 204, 208, 209 X-axis functions, 302 X-increment, 428 X-of-max measurement, 255 X-of-min measurement, 256 X-origin, 429 X-reference, 430 X-Y mode, 302, 304 Y Y axis markers, 204 Y1 and Y2 cursor value difference, 213 Y1 cursor, 204, 207, 211, 213 Y2 cursor, 204, 209, 212, 213 Y-axis value, 432 Y-increment, 431 Y-o