Keysight P9241 Scpi Programmer'S Manual Download Page 1340

Page: 1340 / 1344

1340

Keysight P9241/42/43A Oscilloscopes SCPI Programmer's Guide

Index

source, transition trigger,

814

978

source, trigger edge, Edge Then Edge

trigger,

923

source, waveform,

1021

span,

374

span of frequency on display,

364

Spec error counter (CAN),

603

specify measurement,

472

speed of ARINC 429 signal,

589

SPI MISO data,

1025

square math function,

375

square root math function,

375

square wave duty cycle, waveform

generator,

1056

square waveform generator output,

1050

SRE (Service Request Enable

177

1150

SRQ (Service Request interrupt),

195

199

203

SSM pattern, ARINC 429 trigger,

593

821

standard deviation measured on

waveform,

469

Standard Event Status Enable Register

(ESE),

162

1155

Standard Event Status Register (ESR),

164

1154

standard for CAN FD decode,

608

standard for video,

985

standard, LIN,

661

standard, NFC trigger,

start acquisition,

start and stop edges,

441

start cursor,

1114

start frequency, FFT math function,

start measurement,

start time,

start time marker,

starting bit for SENT Fast Channel

Signal,

739

starting byte of data, CXPI trigger,

state memory,

state of instrument,

statistics increment,

476

statistics reset,

478

statistics results,

465

statistics, max count,

477

statistics, relative standard deviation,

statistics, type of,

status,

Status Byte Register (STB),

status data structure clear,

161

status registers,

status reporting,

1143

STB (Status Byte Register),

step size for frequency span,

stop,

stop acquisition,

stop cursor,

stop displaying channel,

192

stop displaying math function,

192

stop frequency, FFT math function,

359

stop on mask test failure,

stop time,

storage,

store instrument setup,

167

175

store setup,

175

storing calibration information,

248

string variables,

string variables, reading multiple query

results into,

string variables, reading query results into

multiple,

string, quoted ASCII,

153

subsource, waveform source,

1025

subsystem commands,

1201

subtract math function,

374

1021

subtract math function as g(t) source,

1103

sweep mode, trigger,

901

916

sweep speed set to fast to measure fall

time,

447

sweep speed set to fast to measure rise

time,

switch disable,

sync break, LIN,

syntax elements,

syntax rules, program data,

1200

syntax, optional terms,

152

syntax, program message,

SYSTem commands,

system commands,

system commands introduction,

system date,

system time,

tdelta,

Tektronix probe model number,

270

telnet ports 5024 and 5025,

1007

temporary message,

866

TER (Trigger Event Register),

220

1151

termination conditions, mask test,

518

test sigma, mask test run,

522

test, self,

181

text, writing to display,

866

threshold for FFT peak search,

805

threshold voltage (lower) for

measurement,

1108

threshold voltage (upper) for

measurement,

1117

thresholds,

441

1111

thresholds used to measure period,

460

thresholds, how autoscale affects,

time base,

time base commands introduction,

888

time base reference,

893

time base reset conditions,

time base window,

time between arm and trigger, NFC arm and

trigger event,

time between points,

time buckets,

time delay,

time delay, Edge Then Edge trigger,

920

time delta,

1110

time difference between data points,

time duration,

time holdoff for trigger,

907

time interval,

483

1110

time interval between trigger and

occurrence,

1116

time marker sets start time,

1111

time measurements with X cursors,

407

time per division,

891

time record,

367

time reference, lister,

time specified,

time, calibration,

time, mask test run,

time, runt pulse search,

time, runt trigger,

time, start marker,

time, stop marker,

time, system,

time, transition search,

815

time, transition trigger,

979

time/div, how autoscale affects,

187

time-at-max measurement,

1112

time-at-min measurement,

1113

TIMebase commands,

887

timebase vernier,

896

TIMebase:MODE,

time-ordered label list,

311

timeout enable, NFC arm and trigger

event,

952

timeout occurred, NFC arm and trigger

event,

951

timeout period, NFC arm and trigger

event,

timing measurement,

title channels,

title, mask test,

tolerance for determining valid SENT sync

pulses,

742

tolerance, automask,

508

509

top of waveform value measured,

493

total frame count (CAN),

604

Total Harmonic Distortion, FFT analysis

measurement,

451

total waveforms in mask test,

touchscreen on/off,

trace memory,

track measurements,

transfer instrument state,

167

883

transforms, math,

374

TRANsition SEARch commands,

811

transition search qualifier,

812

transition search slope,

813

transition search time,

815

transition trigger qualifier,

976

transition trigger slope,

977

transition trigger source,

814

978

transition trigger time,

979

«
...
1338
1339
1340
1341
1342
...
»

Summary of Contents for P9241

Page 1: ...Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide...

Page 2: ...vides the Software to U S government customers under its standard commercial license which is embodied in its End User License Agreement EULA a copy of which can be found at www keysight com find sweu...

Page 3: ...rence information on common commands root level commands other subsystem commands and error messages Chapter 6 Common Commands starting on page 155 describes commands defined by the IEEE 488 2 standar...

Page 4: ...er Commands starting on page 391 describes commands that turn on off the Lister display for decoded serial data and get the Lister data Chapter 20 MARKer Commands starting on page 395 describes comman...

Page 5: ...tual information in more detail Chapter 35 Status Reporting starting on page 1143 describes the oscilloscope s status registers and how to check the status of the instrument Chapter 36 Synchronizing A...

Page 6: ...6 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide...

Page 7: ...tializing 46 Capturing Data 46 Analyzing Captured Data 47 Programming the Oscilloscope 48 Referencing the IO Library 48 Opening the Oscilloscope Connection via the IO Library 49 Initializing the Inter...

Page 8: ...Definite Length Block Response Data 153 6 Common Commands CLS Clear Status 161 ESE Standard Event Status Enable 162 ESR Standard Event Status Register 164 IDN Identification Number 166 LRN Learn Devic...

Page 9: ...Event Register 208 OVLenable Overload Event Enable Register 211 OVLRegister Overload Event Register 213 RUN 215 SERial 216 SINGle 217 STATus 218 STOP 219 TER Trigger Event Register 220 VIEW 221 8 ACQu...

Page 10: ...n PROBe HEAD TYPE 268 CHANnel n PROBe ID 269 CHANnel n PROBe MMODel 270 CHANnel n PROBe SKEW 271 CHANnel n PROBe STYPe 272 CHANnel n PROTection 273 CHANnel n RANGe 274 CHANnel n SCALe 275 CHANnel n U...

Page 11: ...GRATicule TYPE 308 DISPlay INTensity WAVeform 309 DISPlay LABel 310 DISPlay LABList 311 DISPlay MENU 312 DISPlay MESSage CLEar 313 DISPlay PERSistence 314 DISPlay SIDebar 315 DISPlay VECTors 316 14 D...

Page 12: ...tion TYPE 357 FUNCtion m FFT FREQuency STARt 358 FUNCtion m FFT FREQuency STOP 359 FUNCtion m FFT GATE 360 FUNCtion m FFT PHASe REFerence 361 FUNCtion m FFT RBWidth 362 FUNCtion m FFT READout n 363 FU...

Page 13: ...ce 402 MARKer X2 DISPlay 403 MARKer X2Position 404 MARKer X2Y2source 405 MARKer XDELta 406 MARKer XUNits 407 MARKer XUNits USE 408 MARKer Y1 DISPlay 409 MARKer Y1Position 410 MARKer Y2 DISPlay 411 MAR...

Page 14: ...e PWIDth 464 MEASure RESults 465 MEASure RISetime 468 MEASure SDEViation 469 MEASure SHOW 470 MEASure SLEWrate 471 MEASure SOURce 472 MEASure STATistics 474 MEASure STATistics DISPlay 475 MEASure STAT...

Page 15: ...Lete 515 MTESt ENABle 516 MTESt LOCK 517 MTESt RMODe 518 MTESt RMODe FACTion MEASure 519 MTESt RMODe FACTion SAVE 520 MTESt RMODe FACTion STOP 521 MTESt RMODe SIGMa 522 MTESt RMODe TIME 523 MTESt RMOD...

Page 16: ...t MEASurement 561 SAVE RESults FORMat SEARch 562 SAVE RESults FORMat SEGMented 563 SAVE SETup STARt 564 SAVE WAVeform STARt 565 SAVE WAVeform FORMat 566 SAVE WAVeform LENGth 567 SAVE WAVeform LENGth M...

Page 17: ...n CAN SAMPlepoint 609 SBUS n CAN SIGNal BAUDrate 610 SBUS n CAN SIGNal DEFinition 611 SBUS n CAN SIGNal FDBaudrate 612 SBUS n CAN SOURce 613 SBUS n CAN TRIGger 614 SBUS n CAN TRIGger IDFilter 617 SBUS...

Page 18: ...IIC TRIGger QUALifier 651 SBUS n IIC TRIGger TYPE 652 SBUS n LIN Commands 654 SBUS n LIN DISPlay 656 SBUS n LIN PARity 657 SBUS n LIN SAMPlepoint 658 SBUS n LIN SIGNal BAUDrate 659 SBUS n LIN SOURce...

Page 19: ...695 SBUS n MANChester TRIGger PATTern VALue WIDTh 696 SBUS n MANChester TSIZe 697 SBUS n MANChester WSIZe 698 SBUS n NRZ Commands 699 SBUS n NRZ BASE 701 SBUS n NRZ BAUDrate 702 SBUS n NRZ BITorder 7...

Page 20: ...n SENT TRIGger TOLerance 751 SBUS n UART Commands 752 SBUS n UART BASE 754 SBUS n UART BAUDrate 755 SBUS n UART BITorder 756 SBUS n UART COUNt ERRor 757 SBUS n UART COUNt RESet 758 SBUS n UART COUNt...

Page 21: ...ARch GLITch GREaterthan 795 SEARch GLITch LESSthan 796 SEARch GLITch POLarity 797 SEARch GLITch QUALifier 798 SEARch GLITch RANGe 799 SEARch GLITch SOURce 800 SEARch PEAK Commands 801 SEARch PEAK EXCu...

Page 22: ...SEARch SERial IIC PATTern DATA 836 SEARch SERial IIC PATTern DATA2 837 SEARch SERial IIC QUALifier 838 SEARch SERial LIN Commands 839 SEARch SERial LIN ID 840 SEARch SERial LIN MODE 841 SEARch SERial...

Page 23: ...ger DESTination 877 SYSTem RLOGger DISPlay 878 SYSTem RLOGger FNAMe 879 SYSTem RLOGger STATe 880 SYSTem RLOGger TRANsparent 881 SYSTem RLOGger WMODe 882 SYSTem SETup 883 SYSTem TIME 885 SYSTem TOUCh 8...

Page 24: ...ELay TRIGger SLOPe 922 TRIGger DELay TRIGger SOURce 923 TRIGger EBURst Commands 924 TRIGger EBURst COUNt 925 TRIGger EBURst IDLE 926 TRIGger EBURst SLOPe 927 TRIGger EBURst SOURce 928 TRIGger EDGE Com...

Page 25: ...NGe 963 TRIGger RUNT Commands 964 TRIGger RUNT POLarity 965 TRIGger RUNT QUALifier 966 TRIGger RUNT SOURce 967 TRIGger RUNT TIME 968 TRIGger SHOLd Commands 969 TRIGger SHOLd SLOPe 970 TRIGger SHOLd SO...

Page 26: ...INts MODE 1012 WAVeform PREamble 1014 WAVeform SEGMented ALL 1017 WAVeform SEGMented COUNt 1018 WAVeform SEGMented TTAG 1019 WAVeform SEGMented XLISt 1020 WAVeform SOURce 1021 WAVeform SOURce SUBSourc...

Page 27: ...ODulation FUNCtion 1063 WGEN w MODulation FUNCtion RAMP SYMMetry 1064 WGEN w MODulation NOISe 1065 WGEN w MODulation STATe 1066 WGEN w MODulation TYPE 1067 WGEN w OUTPut 1069 WGEN w OUTPut LOAD 1070 W...

Page 28: ...109 MEASure TDELta 1110 MEASure THResholds 1111 MEASure TMAX 1112 MEASure TMIN 1113 MEASure TSTArt 1114 MEASure TSTOp 1115 MEASure TVOLt 1116 MEASure UPPer 1117 MEASure VDELta 1118 MEASure VSTArt 1119...

Page 29: ...ister AER 1160 Overload Event Register OVLRegister 1161 Hardware Event Event Register HWERegister EVENt 1162 Hardware Event Condition Register HWERegister CONDition 1163 Mask Test Event Event Register...

Page 30: ...Examples VISA COM Examples 1206 VISA COM Example in Visual Basic 1206 VISA COM Example in C 1215 VISA COM Example in Visual Basic NET 1224 VISA COM Example in Python 1232 VISA Examples 1239 VISA Exam...

Page 31: ...31 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 1 What s New What s New in Version 7 30 32 Version 7 21 at Introduction 34 Command Differences From M9241 42 43A PXIe Oscilloscopes 35...

Page 32: ...ire POINts ANALog AUT O see page 233 Enables or disables Automatic determination of the analog channel memory depth ACQuire SRATe ANALog AUT O see page 241 Enables or disables Automatic determination...

Page 33: ...meter is available when Digitizer mode is enabled to specify a waveform data view view that includes all captured data which may extend beyound the edges of the oscilloscope s main waveform display ar...

Page 34: ...th version 7 21 of oscilloscope operating software The command set is most closely related to the InfiniiVision M9241 42 43A PXIe oscilloscopes and the 3000T X Series 4000 X Series 3000 X Series 7000A...

Page 35: ...alysis application is not supported There is no PXIe chassis or 100 MHz reference signal from a chassis Therefore there are no commands for setting up coordinated triggers between multiple PXIe oscill...

Page 36: ...36 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 1 What s New...

Page 37: ...ibraries Suite software 38 Step 2 Connect and set up the oscilloscope 39 Step 3 Verify the oscilloscope connection 42 This chapter explains how to install the Keysight IO Libraries Suite software conn...

Page 38: ...er s Guide 2 Setting Up Step 1 Install Keysight IO Libraries Suite software 1 Download the Keysight IO Libraries Suite software from the Keysight web site at http www keysight com find iolib 2 Run the...

Page 39: ...pe using its remote interface from a controller PC The controller PC can be the host PC or it can be another computer on the network In both cases a LAN interface on the host PC and a HiSLIP control p...

Page 40: ...ting Up When the Controller PC is Another Computer on the Network To get an oscilloscope s HiSLIP VISA address 1 In the oscilloscope s Front Panel graphical user interface choose Menu Utilities I O Me...

Page 41: ...Setting Up 2 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 41...

Page 42: ...ight IO Control icon in the taskbar and choose Utilities Interactive IO from the popup menu 2 In the Keysight Interactive IO application choose Connect Connect 3 In the Connect dialog box enter the os...

Page 43: ...Setting Up 2 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 43 5 Choose Connect Exit from the menu to exit the Keysight Interactive IO application...

Page 44: ...44 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 2 Setting Up...

Page 45: ...2 43A oscilloscopes It describes basic oscilloscope program structure and shows how to program the oscilloscope using a few simple examples The getting started examples show how to send oscilloscope s...

Page 46: ...dy for data transfer Oscilloscope initialization sets the channel configuration channel labels threshold voltages trigger specification trigger mode timebase and acquisition type Capturing Data Once y...

Page 47: ...tops the acquisition process so that all measurements are on displayed data not on a constantly changing data set Analyzing Captured Data After the oscilloscope has completed an acquisition you can fi...

Page 48: ...ables on page 54 Reading Definite Length Block Query Response Data on page 54 Sending Multiple Queries and Reading Results on page 55 Checking Instrument Status on page 56 Referencing the IO Library N...

Page 49: ...iteIEEEBlock methods are used for sending commands and queries After a query is sent the response is read using the ReadString ReadNumber ReadList or ReadIEEEBlock methods The following Visual Basic s...

Page 50: ...Setup The AUToscale command performs a very useful function for unknown waveforms by setting up the vertical channel time base and trigger level of the instrument The syntax for the autoscale command...

Page 51: ...ical range to 1 6 volts full scale with center screen at 0 4 volts with 10 1 probe attenuation and DC coupling myScope WriteString CHANnel1 PROBe 10 Probe attenuation to 10 1 myScope WriteString CHANn...

Page 52: ...ing WAVeform POINts 500 myScope WriteString WAVeform DATA This setup places the instrument into the averaged mode with eight averages This means that when the DIGitize command is received the command...

Page 53: ...ically has a format specification for handling the response message When using the VISA COM library in Visual Basic you use different read methods ReadString ReadNumber ReadList or ReadIEEEBlock for t...

Page 54: ...arQueryResult As Variant varQueryResult myScope ReadNumber MsgBox Range variant CStr varQueryResult After running this program the controller displays Range variant 40 Reading Definite Length Block Qu...

Page 55: ...ingle string variable multiple string variables or multiple numeric variables For example to read the TIMebase RANGe DELay query result into a single string variable you could use the commands myScope...

Page 56: ...Results As Variant varResults myScope ReadList MsgBox Timebase range FormatNumber varResults 0 1000 4 _ ms delay FormatNumber varResults 1 1000000 4 us Checking Instrument Status Status registers trac...

Page 57: ...scilloscope s save and recall commands are overlapped as well as some commands that perform analysis With sequential blocking commands and queries the oscilloscope is expected to stop processing input...

Page 58: ...omplete The OPC query is appended to DIGitize with a semi colon which essentially ties it to the same thread in the parser It is immediately dealt with once DIGitize finishes and gives a 1 back to the...

Page 59: ...59 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 5 Commands Quick Reference Command Summary 60 Syntax Elements 152...

Page 60: ...mands Summary see page 83 MARKer Commands Summary see page 83 MEASure Commands Summary see page 85 MTESt Commands Summary see page 100 RECall Commands Summary see page 103 SAVE Commands Summary see pa...

Page 61: ...s Summary see page 130 SYSTem Commands Summary see page 131 TIMebase Commands Summary see page 132 General TRIGger Commands Summary see page 133 TRIGger DELay Commands Summary see page 134 TRIGger EBU...

Page 62: ...Dev Dependent Error 2 4 QYE Query Error 1 2 RQL Request Control 0 1 OPC Operation Complete n a ESR see page 164 status 0 to 255 an integer in NR1 format n a IDN see page 164 KEYSIGHT TECHNOLOGIES mod...

Page 63: ...erved reserved reserved Educator s Kit Waveform Generator MIL 1553 ARINC 429 Serial Extended Video Advanced Math reserved reserved reserved reserved Digital Voltmeter Counter reserved reserved reserve...

Page 64: ...S 232 UART Serial 0 COMP Segmented Memory 0 SGM Mask Test 0 MASK Educator s Kit 0 EDK Waveform Generator 0 WAVEGEN MIL 1553 ARINC 429 Serial 0 AERO Extended Video 0 VID Advanced Math 0 ADVMATH Digital...

Page 65: ...CL value see page 171 n a value 0 1 4 5 6 7 8 9 RST see page 172 n a See RST Reset see page 172 SAV value see page 175 n a value 0 1 4 5 6 7 8 9 SRE mask see page 176 SRE see page 177 mask sum of all...

Page 66: ...80 n a n a n a TST see page 181 result 0 or non zero value an integer in NR1 format WAI see page 182 n a n a Table 2 Common Commands Summary continued Command Query Options and Query Returns Table 3 R...

Page 67: ...ons in NR1 format HWEenable n see page 195 HWEenable see page 195 n 16 bit integer in NR1 format n a HWERregister CONDiti on see page 197 n 16 bit integer in NR1 format n a HWERegister EVENt see page...

Page 68: ...ble for value RUN see page 215 n a n a n a SERial see page 216 return value unquoted string containing serial number SINGle see page 217 n a n a n a STATus display see page 218 0 1 display CHANnel n F...

Page 69: ...e ETIMe SEGMented ACQuire POINts ANAL og points see page 232 ACQuire POINts ANAL og see page 232 points AUTO points_value points_value desired analog memory depth in integer NR1 format ACQuire POINts...

Page 70: ...string see page 248 CALibrate LABel see page 248 string quoted ASCII string up to 32 characters CALibrate OUTPut signal see page 249 CALibrate OUTPut see page 250 signal TRIGgers MASK WAVEgen WGEN1 W...

Page 71: ...264 CHANnel n INVert see page 264 0 1 n 1 to analog channels in NR1 format CHANnel n LABel string see page 265 CHANnel n LABel see page 265 string any series of 32 or less ASCII characters enclosed i...

Page 72: ...els in NR1 format CHANnel n PROTectio n see page 273 CHANnel n PROTectio n see page 273 NORM TRIP n 1 to analog channels in NR1 format CHANnel n RANGe range suffix see page 274 CHANnel n RANGe see pag...

Page 73: ...rmat COUNter SOURce source see page 285 COUNter SOURce see page 285 source CHANnel n TQEVent n 1 to analog channels in NR1 format COUNter TOTalize CLE ar see page 286 n a n a COUNter TOTalize GAT E EN...

Page 74: ...mode see page 299 DISPlay ANNotation n BACKground see page 299 mode OPAQue INVerted n an integer from 1 to 4 in NR1 format DISPlay ANNotation n COLor color see page 300 DISPlay ANNotation n COLor see...

Page 75: ...ity WA Veform see page 309 value an integer from 0 to 100 in NR1 format DISPlay LABel 0 OFF 1 ON see page 310 DISPlay LABel see page 310 0 1 DISPlay LABList binary block see page 311 DISPlay LABList s...

Page 76: ...Trigger Commands Summary Command Query Options and Query Returns EXTernal BWLimit bwlimit see page 324 EXTernal BWLimit see page 324 bwlimit 0 OFF EXTernal PROBe attenuation see page 325 EXTernal PRO...

Page 77: ...ee page 336 value 100 1000 10000 100000 1000000 10000000 20000000 suffix Hz kHz MHz FRANalysis PPDecade value see page 337 FRANalysis PPDecade see page 337 value 10 20 30 40 50 60 70 80 90 100 FRANaly...

Page 78: ...rmat m 1 to math functions in NR1 format FUNCtion m CLEar see page 352 n a n a FUNCtion m DISPlay 0 OFF 1 ON see page 353 FUNCtion m DISPlay see page 353 0 1 m 1 to math functions in NR1 format n a FU...

Page 79: ..._point see page 361 FUNCtion m FFT PH ASe REFerence see page 361 ref_point TRIGger DISPlay m 1 4 in NR1 format n a FUNCtion m FFT RB Width see page 362 resolution_bw Hz in NR3 format m 1 to math funct...

Page 80: ...LOWPass see page 369 3dB_freq 3dB cutoff frequency value in NR3 format m 1 to math functions in NR1 format FUNCtion m INTegrat e IOFFset input_offset see page 370 FUNCtion m INTegrat e IOFFset see pa...

Page 81: ...is 8E 9 to 400E 3 The range for the DIFF function is 80E 3 to 8 0E12 depends on current sweep speed The range for the FFT function is 8 to 800 dBV m 1 to math functions in NR1 format FUNCtion m REFer...

Page 82: ...l n WMEMory r NONE n 1 to analog channels in NR1 format r 1 to ref waveforms in NR1 format m 1 to math functions in NR1 format FUNCtion m TRENd NM Easurement MEAS n see page 385 FUNCtion m TRENd NM Ea...

Page 83: ...8 return_value Y X value in NR3 format MARKer MODE mode see page 399 MARKer MODE see page 399 mode OFF MEASurement MANual WAVeform BINary HEX MARKer X1 DISPlay 0 OFF 1 ON see page 400 MARKer X1 DISPla...

Page 84: ...elta value in NR3 format MARKer XUNits mode see page 407 MARKer XUNits see page 407 units SEConds HERTz DEGRees PERCent MARKer XUNits USE see page 408 n a n a MARKer Y1 DISPlay 0 OFF 1 ON see page 409...

Page 85: ...ons and Query Returns MEASure ALL see page 434 n a n a MEASure AREa interval source see page 435 MEASure AREa interval source see page 435 interval CYCLe DISPlay source CHANnel n FUNCtion m MATH m WME...

Page 86: ...page 439 MEASure COUNter source see page 439 source CHANnel n EXTernal n 1 to analog channels in NR1 format return_value counter frequency in Hertz in NR3 format MEASure DEFine DELay delay spec see pa...

Page 87: ...ge_thresho ld source2_edge_slope source2_edge_number source2_edge_thresho ld see page 445 MEASure DELay DEFine see page 445 source1_edge_slope source2_edge_slope RISing FALLing source1_edge_number sou...

Page 88: ..._spacing chan source see page 448 chan_width width of main range and sideband channels Hz in NR3 format chan_spacing spacing between main range and sideband channels Hz in NR3 format chan CENTer HIGH...

Page 89: ...NR3 format MEASure FFT THD source see page 451 MEASure FFT THD source see page 451 source FUNCtion m MATH m FFT source must be an FFT waveform m 1 to math functions in NR1 format return_value total ha...

Page 90: ...age 454 MEASure NEDGes source see page 454 source CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format retu...

Page 91: ...ERshoot source see page 457 source CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value the pe...

Page 92: ...ure PHASe source1 source2 see page 461 source1 2 CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format retur...

Page 93: ...CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value width of positive pulse in seconds in NR...

Page 94: ...re SLEWrate source slope see page 471 source CHANnel n FUNCtion m MATH m WMEMory r n 1 to of analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format MEASur...

Page 95: ...ee page 478 n a n a MEASure STATistics R SDeviation 0 OFF 1 ON see page 479 MEASure STATistics R SDeviation see page 479 0 1 MEASure TEDGe slope occurrence source see page 480 MEASure TEDGe slope occu...

Page 96: ...els in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value time in seconds of specified voltage crossing in NR3 format MEASure VAMPlitude source see page 485...

Page 97: ...age 487 MEASure VBASe source see page 487 source CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format base_...

Page 98: ...urce CHANnel n FUNCtion m FFT MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value voltage peak to peak of the sele...

Page 99: ...trigger in seconds in NR3 format source CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value...

Page 100: ...T MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value horizontal value of the minimum in NR3 format Table 17 MEASu...

Page 101: ...A mask see page 514 MTESt DATA see page 514 mask data in IEEE 488 2 format MTESt DELete see page 515 n a n a MTESt ENABle 0 OFF 1 ON see page 516 MTESt ENABle see page 516 0 1 MTESt LOCK 0 OFF 1 ON se...

Page 102: ...see page 526 x1_value X1 value in NR3 format MTESt SCALe XDELta xdelta_value see page 527 MTESt SCALe XDELta see page 527 xdelta_value X delta value in NR3 format MTESt SCALe Y1 y1_value see page 528...

Page 103: ...536 n a file_name quoted ASCII string If extension included in file name it must be dbc serialbus SBUS n n 1 to of serial bus in NR1 format RECall FILename base_name see page 537 RECall FILename see...

Page 104: ...Options and Query Returns Table 20 SAVE Commands Summary Command Query Options and Query Returns SAVE ARBitrary STAR t file_spec wavegen_id see page 547 n a file_spec internal_loc file_name internal_l...

Page 105: ...page 557 SAVE PWD see page 557 path_name quoted ASCII string SAVE RESults STARt file_spec see page 558 n a file_name quoted ASCII string SAVE RESults FORMat CURSor 0 OFF 1 ON see page 559 SAVE RESult...

Page 106: ...n NR1 format SAVE WAVeform LENGth MAX 0 OFF 1 ON see page 568 SAVE WAVeform LENGth MAX see page 568 0 1 SAVE WAVeform SEGMen ted option see page 569 SAVE WAVeform SEGMen ted see page 569 option ALL CU...

Page 107: ...age 581 base BINary HEX SBUS n A429 BAUDrat e baudrate see page 582 SBUS n A429 BAUDrat e see page 582 baudrate integer from 10000 to 1000000 n a SBUS n A429 COUNt E RRor see page 583 error_count inte...

Page 108: ...SDI see page 592 string nn where n 0 1 X length always 2 bits SBUS n A429 TRIGger PATTern SSM string see page 593 SBUS n A429 TRIGger PATTern SSM see page 593 string nn where n 0 1 X length always 2 b...

Page 109: ...DSPoint value see page 607 SBUS n CAN FDSPoint see page 607 value even numbered percentages from 30 to 90 in NR3 format SBUS n CAN FDSTanda rd std see page 608 SBUS n CAN FDSTanda rd see page 608 std...

Page 110: ...ATTern DATA DLC see page 619 dlc integer between 1 don t care and 64 in NR1 format SBUS n CAN TRIGger PATTern DATA LENGth length see page 620 SBUS n CAN TRIGger PATTern DATA LENGth see page 620 length...

Page 111: ...0 OFF 1 ON see page 630 SBUS n CXPI PARity see page 630 0 1 SBUS n CXPI SOURce source see page 631 SBUS n CXPI SOURce see page 631 source CHANnel n n 1 to analog channels in NR1 format SBUS n CXPI TO...

Page 112: ...RIGger PATTern INFO DLC dlc see page 642 SBUS n CXPI TRIGger PATTern INFO DLC see page 642 dlc integer between 1 don t care and 15 in NR1 format when trigger is in DATA mode dlc integer between 1 don...

Page 113: ...2 type STARt STOP RESTart ADDRess ANACk DNACk NACKnowledge READEprom READ7 WRITe7 R7Data2 W7Data2 WRITe10 Table 25 SBUS n IIC Commands Summary continued Command Query Options and Query Returns Table 2...

Page 114: ...re n 32 bit integer in unsigned decimal when base DECimal string nn n where n 0 1 X when base BINary string 0xnn n where n 0 9 A F X when base HEX SBUS n LIN TRIGger PATTern DATA LENGth length see pag...

Page 115: ...ge 678 value 5 bit integer in decimal nondecimal or string from 0 31 nondecimal Hnn where n 0 9 A F string 0xnn where n 0 9 A F SBUS n M1553 TRIGge r TYPE type see page 679 SBUS n M1553 TRIGge r TYPE...

Page 116: ...n MANChester S SIZe bits see page 691 SBUS n MANChester S SIZe see page 691 bits from 0 255 in NR1 format SBUS n MANChester S TARt edge see page 692 SBUS n MANChester S TARt see page 692 edge from 1...

Page 117: ...rements SBUS n NRZ BITorder bitorder see page 703 SBUS n NRZ BITorder see page 703 bitorder MSBFirst LSBFirst SBUS n NRZ DISPlay format see page 704 SBUS n NRZ DISPlay see page 704 format BIT WORD SBU...

Page 118: ...ee page 717 bits from 2 32 in NR1 format Table 29 SBUS n NRZ Commands Summary continued Command Query Options and Query Returns Table 30 SBUS n SENT Commands Summary Command Query Options and Query Re...

Page 119: ...e page 737 SBUS n SENT SIGNal s ORDer see page 737 s 1 6 in NR1 format order MSNFirst LSNFirst SBUS n SENT SIGNal s STARt position see page 739 SBUS n SENT SIGNal s STARt see page 739 s 1 6 in NR1 for...

Page 120: ...LONG SBUS n SENT TRIGger TOLerance percent see page 751 SBUS n SENT TRIGger TOLerance see page 751 percent from 1 18 in NR1 format Table 30 SBUS n SENT Commands Summary continued Command Query Options...

Page 121: ...y EVEN ODD NONE SBUS n UART POLarit y polarity see page 763 SBUS n UART POLarit y see page 763 polarity HIGH LOW SBUS n UART SOURce RX source see page 764 SBUS n UART SOURce RX see page 764 source CHA...

Page 122: ...ue EQUal NOTequal GREaterthan LESSthan SBUS n UART TRIGger TYPE value see page 771 SBUS n UART TRIGger TYPE see page 771 value RSTArt RSTOp RDATa RD1 RD0 RDX PARityerror TSTArt TSTOp TDATa TD1 TD0 TDX...

Page 123: ...REQuest FRESponse PSTatus CINFo CCODes SBUS n USBPd TRIGge r HEADer VALue string see page 783 SBUS n USBPd TRIGge r HEADer VALue see page 783 string nn n where n 0 1 X string 0xnn n where n 0 9 A F X...

Page 124: ...number in NR3 format suffix s ms us ns ps SEARch GLITch LESSth an less_than_time suff ix see page 796 SEARch GLITch LESSth an see page 796 less_than_time floating point number in NR3 format suffix s m...

Page 125: ...must be an FFT waveform m 1 to 4 in NR1 format SEARch PEAK THReshol d level see page 805 SEARch PEAK THReshol d see page 805 level necessary level to be considered a peak in NR3 format Table 37 SEARc...

Page 126: ...ns ps Table 39 SEARch SERial A429 Commands Summary Command Query Options and Query Returns SEARch SERial A429 L ABel value see page 817 SEARch SERial A429 L ABel see page 817 value 8 bit integer in de...

Page 127: ...page 827 string 0xnn n where n 0 9 A F X for hexadecimal SEARch SERial CAN PA TTern ID MODE value see page 828 SEARch SERial CAN PA TTern ID MODE see page 828 value STANdard EXTended SEARch SERial CAN...

Page 128: ...tions and Query Returns SEARch SERial LIN ID value see page 840 SEARch SERial LIN ID see page 840 value 7 bit integer in decimal nondecimal or string from 0 63 or 0x00 0x3f nondecimal Hnn where n 0 9...

Page 129: ...Bolic VALue see page 847 data value in NR3 format Table 42 SEARch SERial LIN Commands Summary continued Command Query Options and Query Returns Table 43 SEARch SERial M1553 Commands Summary Command Qu...

Page 130: ...e 856 SEARch SERial SENT S LOW ID see page 856 id from 1 don t care to 255 in NR1 format Table 45 SEARch SERial UART Commands Summary Command Query Options and Query Returns SEARch SERial UART D ATA v...

Page 131: ...SYSTem GUI SHOW 0 OFF 1 ON see page 868 SYSTem GUI SHOW see page 868 setting 0 1 SYSTem LOCK value see page 869 SYSTem LOCK see page 869 value 1 ON 0 OFF SYSTem PERSona MANu facturer manufacturer_stri...

Page 132: ...e_mode see page 882 SYSTem RLOGger WMODe see page 882 write_mode CREate APPend SYSTem SETup setup_data see page 883 SYSTem SETup see page 883 setup_data data in IEEE 488 2 format n a SYSTem TIME see p...

Page 133: ...gger event to the zoomed view reference point in NR3 format TIMebase WINDow RANG e range_value see page 898 TIMebase WINDow RANG e see page 898 range value range value in seconds in NR3 format for the...

Page 134: ...ource see page 913 level 75 x full scale voltage from center screen in NR3 format source CHANnel n n 1 to analog channels in NR1 format TRIGger MODE mode see page 914 TRIGger MODE see page 914 mode ED...

Page 135: ...DELay TRIGge r SOURce see page 923 source CHANnel n n 1 to analog channels in NR1 format Table 49 TRIGger DELay Commands Summary continued Command Query Options and Query Returns Table 50 TRIGger EBUR...

Page 136: ...see page 932 TRIGger EDGE REJec t see page 932 OFF LFReject HFReject TRIGger EDGE SLOPe polarity see page 933 TRIGger EDGE SLOPe see page 933 polarity POSitive NEGative EITHer ALTernate TRIGger EDGE...

Page 137: ...ix see page 941 TRIGger GLITch RANGe see page 941 less_than_time 15 ns to 10 seconds in NR3 format greater_than_time 10 ns to 9 99 seconds in NR3 format suffix s ms us ns ps TRIGger GLITch SOURc e sou...

Page 138: ...age 951 0 1 TRIGger NFC TIMeout ENABle 0 OFF 1 ON see page 952 TRIGger NFC TIMeout ENABle see page 952 0 1 TRIGger NFC TIMeout TIME time see page 953 TRIGger NFC TIMeout TIME see page 953 time seconds...

Page 139: ...n GREa terthan greater_than_time s uffix see page 960 TRIGger PATTern GREa terthan see page 960 greater_than_time floating point number in NR3 format suffix s ms us ns ps TRIGger PATTern LESS than les...

Page 140: ...oating point number in NR3 format suffix s ms us ns ps Table 57 TRIGger SHOLd Commands Summary Command Query Options and Query Returns TRIGger SHOLd SLOPe slope see page 970 TRIGger SHOLd SLOPe see pa...

Page 141: ...oint number in NR3 format suffix s ms us ns ps Table 59 TRIGger TV Commands Summary Command Query Options and Query Returns TRIGger TV LINE line number see page 981 TRIGger TV LINE see page 981 line n...

Page 142: ...Commands Summary continued Command Query Options and Query Returns Table 60 TRIGger ZONE Commands Summary Command Query Options and Query Returns TRIGger ZONE SOURce source see page 991 TRIGger ZONE S...

Page 143: ...irst n a WAVeform COUNt see page 1006 count an integer from 1 to 65536 in NR1 format n a WAVeform DATA see page 1007 binary block length bytes binary data For example to transmit 1000 bytes of data th...

Page 144: ...t type an integer in NR1 format 0 for NORMal type 1 for PEAK detect type 3 for AVERage type 4 for HRESolution type count Average count or 1 if PEAK detect type or NORMal an integer in NR1 format WAVef...

Page 145: ...027 0 1 WAVeform VIEW view see page 1028 WAVeform VIEW see page 1028 view MAIN ALL n a WAVeform XINCrement see page 1029 return_value x increment in the current preamble in NR3 format n a WAVeform XOR...

Page 146: ...to 1 0 in comma separated format w 1 to WaveGen outputs in NR1 format n a WGEN w ARBitrary DA TA ATTRibute POINts see page 1044 points number of points in NR1 format w 1 to WaveGen outputs in NR1 for...

Page 147: ...w 1 to WaveGen outputs in NR1 format WGEN w FUNCtion PUL Se WIDTh width see page 1054 WGEN w FUNCtion PUL Se WIDTh see page 1054 width pulse width in seconds in NR3 format w 1 to WaveGen outputs in NR...

Page 148: ...n F SKey RATE rate see page 1062 WGEN w MODulation F SKey RATE see page 1062 rate FSK modulation rate in Hz in NR3 format w 1 in NR1 format WGEN w MODulation F UNCtion shape see page 1063 WGEN w MODul...

Page 149: ...ormat w 1 to WaveGen outputs in NR1 format WGEN w RST see page 1075 n a w 1 to WaveGen outputs in NR1 format WGEN w VOLTage amplitude see page 1076 WGEN w VOLTage see page 1076 amplitude amplitude in...

Page 150: ...at string any series of 10 or less ASCII characters enclosed in quotation marks WMEMory r SAVE source see page 1086 n a r 1 to ref waveforms in NR1 format source CHANnel n FUNCtion m MATH m n 1 to ana...

Page 151: ...89 r 1 to ref waveforms in NR1 format range vertical full scale range value in NR3 format suffix V mV WMEMory r YSCale scale suffix see page 1090 WMEMory r YSCale see page 1090 r 1 to ref waveforms in...

Page 152: ...t NR1 specifies integer data NR3 specifies exponential data in floating point format for example 1 0E 3 NL Line Terminator NL new line or linefeed ASCII decimal 10 The line terminator or a leading col...

Page 153: ...ABEL One has a quoted ASCII string of One In order to read quoted ASCII strings from query return values some programming languages require special handling or syntax Definite Length Block Response Da...

Page 154: ...154 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 5 Commands Quick Reference 1000 bytes of data is the actual data...

Page 155: ...it 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 Dependent Error 2 4 QYE Query Error 1 2 RQL Request Control 0 1 OPC Operatio...

Page 156: ...ed reserved reserved reserved reserved reserved reserved reserved reserved reserved Educator s Kit Waveform Generator MIL 1553 ARINC 429 Serial Extended Video Advanced Math reserved reserved reserved...

Page 157: ...0 COMP Segmented Memory 0 SGM Mask Test 0 MASK Educator s Kit 0 EDK Waveform Generator 0 WAVEGEN MIL 1553 ARINC 429 Serial 0 AERO Extended Video 0 VID Advanced Math 0 ADVMATH Digital Voltmeter Counte...

Page 158: ...a value 0 1 4 5 6 7 8 9 RST see page 172 n a See RST Reset see page 172 SAV value see page 175 n a value 0 1 4 5 6 7 8 9 SRE mask see page 176 SRE see page 177 mask sum of all bits that are set 0 to 2...

Page 159: ...the status information and sets the average count In contrast if a root level command or some other subsystem command is within the program message you must re enter the original subsystem after the c...

Page 160: ...2 43A Oscilloscopes SCPI Programmer s Guide 6 Common Commands NOTE Each of the status registers has an enable mask register By setting the bits in the enable register you can select the status informa...

Page 161: ...queue and the Request for OPC flag See Also Introduction to Common Commands on page 159 STB Read Status Byte on page 178 ESE Standard Event Status Enable on page 162 ESR Standard Event Status Registe...

Page 162: ...ndard Event Status Enable ESE Bit Name Description When Set 1 High True Enables 7 PON Power On Event when an OFF to ON transition occurs 6 URQ User Request Event when a front panel key is pressed 5 CM...

Page 163: ...he current contents of the Standard Event Status Enable Register Return Format mask_argument NL mask_argument 0 255 an integer in NR1 format See Also Introduction to Common Commands on page 159 ESR St...

Page 164: ...ormat Table 66 Standard Event Status Register ESR Bit Name Description When Set 1 High True Indicates 7 PON Power On An OFF to ON transition has occurred 6 URQ User Request A front panel key has been...

Page 165: ...See Also Introduction to Common Commands on page 159 ESE Standard Event Status Enable on page 162 OPC Operation Complete on page 168 CLS Clear Status on page 161 SYSTem ERRor on page 867 NOTE Reading...

Page 166: ...mat manufacturer_string model serial_number X XX XX NL manufacturer_string KEYSIGHT TECHNOLOGIES model the model number of the instrument serial_number the serial number of the instrument X XX XX the...

Page 167: ...rument settings at a later time Return Format learn_string NL learn_string SYST SET setup_data setup_data binary block data in IEEE 488 2 format learn string specifies the current instrument setup The...

Page 168: ...lete Return Format complete NL complete 1 See Also Introduction to Common Commands on page 159 ESE Standard Event Status Enable on page 162 ESR Standard Event Status Register on page 164 CLS Clear Sta...

Page 169: ...MIL 1553 ARINC 429 Serial Extended Video Advanced Math reserved reserved reserved reserved Digital Voltmeter Counter reserved reserved reserved reserved reserved Remote Command Logging reserved SENT S...

Page 170: ...eneral Purpose Software 0 P9240GENB Aerospace Software 0 P9240AERB Near Field Communications NFC Software 0 P9240NFCB Software Bundle 0 P9240BDLB The OPT query returns the following See Also Introduct...

Page 171: ...grammer s Guide 171 RCL Recall see page 1196 Command Syntax RCL value value 0 1 2 3 4 5 6 7 8 9 The RCL command restores the state of the instrument from the specified save recall register See Also In...

Page 172: ...ser settings that remain unchanged To perform the equivalent of the front panel s Default Setup key where some user settings like preferences remain unchanged use the SYSTem PRESet command Reset condi...

Page 173: ...se 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 Type Edge Mode Auto Coupling d...

Page 174: ...pe 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 un...

Page 175: ...see page 1196 Command Syntax SAV value value 0 1 2 3 4 5 6 7 8 9 The SAV command stores the current state of the instrument in a save register The data parameter specifies the register where the data...

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

Page 177: ...vice Request Enable Register SRE Bit Name Description When Set 1 High True Enables 7 OPER Operation Status Register Interrupts when enabled conditions in the Operation Status Register OPER occur 6 Not...

Page 178: ...reported on bit 6 instead of the RQS request service bit The MSS indicates whether or not the device has at least one reason for requesting service Return Format value NL value 0 255 an integer in NR...

Page 179: ...n 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 Stan...

Page 180: ...s Guide 6 Common Commands TRG Trigger see page 1196 Command Syntax TRG The TRG command has the same effect as the DIGitize command with no parameters See Also Introduction to Common Commands on page 1...

Page 181: ...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 se...

Page 182: ...grammer s Guide 6 Common Commands WAI Wait To Continue see page 1196 Command Syntax WAI The WAI command has no function in the oscilloscope but is parsed for compatibility with other instruments See A...

Page 183: ...rce source see page 187 n a source CHANnel n source can be repeated up to 5 times n 1 to analog channels in NR1 format AUToscale AMODE value see page 189 AUToscale AMODE see page 189 value NORMal CURR...

Page 184: ...NR1 format n a MTERegister EVENt see page 201 n 16 bit integer in NR1 format OPEE n see page 203 OPEE see page 204 n 15 bit integer in NR1 format n a OPERegister CONDitio n see page 205 n 15 bit inte...

Page 185: ...a SERial see page 216 return value unquoted string containing serial number SINGle see page 217 n a n a n a STATus display see page 218 0 1 display CHANnel n FUNCtion m MATH m FFT SBUS 1 2 WMEMory r...

Page 186: ...atus Event Register A Service Request can be generated when the Wait Trig bit transitions and the appropriate enable bits have been set in the Operation Status Enable Register OPEE and the Service Req...

Page 187: ...Nnels on page 190 is set to DISPlayed channels Then the autoscale is performed When the AUToscale command is sent the following conditions are affected and actions are taken Thresholds Channels with a...

Page 188: ...n page 189 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 Auto...

Page 189: ...quisition type and the RTIMe real time acquisition mode When CURRent is selected the current acquisition type and mode are kept on subsequent AUToscales Use the ACQuire TYPE and ACQuire MODE commands...

Page 190: ...ed 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 cha...

Page 191: ...ion changes the behavior of AUToscale to let you make quick visual comparisons to determine whether the signal being probed is a DC voltage ground or an active AC signal Channel coupling is maintained...

Page 192: ...nce waveform location The BLANk command with no parameter turns off all sources See Also Introduction to Root Commands on page 185 DISPlay CLEar on page 304 CHANnel n DISPlay on page 262 FUNCtion m DI...

Page 193: ...plete the instrument is stopped If no argument is given DIGitize acquires the channels currently displayed If no channels are displayed all channels are acquired See Also Introduction to Root Commands...

Page 194: ...cilloscopes SCPI Programmer s Guide 7 Root Commands Example Code Capture an acquisition using DIGitize myScope WriteString DIGitize CHANnel1 See complete example programs at Chapter 38 Programming Exa...

Page 195: ...ware Event Enable register as an integer number Return Format value NL value integer in NR1 format See Also Introduction to Root Commands on page 185 AER Arm Event Register on page 186 CHANnel n PROTe...

Page 196: ...Guide 7 Root Commands OPERegister EVENt Operation Status Event Register on page 208 OVLenable Overload Event Enable Register on page 211 OVLRegister Overload Event Register on page 213 STB Read Statu...

Page 197: ...tion Status Event Register on page 208 OVLenable Overload Event Enable Register on page 211 OVLRegister Overload Event Register on page 213 STB Read Status Byte on page 178 SRE Service Request Enable...

Page 198: ...tus Condition Register on page 205 OVLenable Overload Event Enable Register on page 211 OVLRegister Overload Event Register on page 213 STB Read Status Byte on page 178 SRE Service Request Enable on p...

Page 199: ...tained in the Mask Test Event Enable register as an integer number Return Format value NL To MTE bit in Operation Status Condition Register OR MTEenable MTEenable Mask Test Event Enable Mask Register...

Page 200: ...o Root Commands on page 185 AER Arm Event Register on page 186 CHANnel n PROTection on page 273 OPERegister EVENt Operation Status Event Register on page 208 OVLenable Overload Event Enable Register o...

Page 201: ...03 OPERegister CONDition Operation Status Condition Register on page 205 To MTE bit in Operation Status Condition Register OR MTEenable MTEenable Mask Test Event Enable Mask Register 1 0 2 3 4 5 6 7 9...

Page 202: ...Oscilloscopes SCPI Programmer s Guide 7 Root Commands OVLenable Overload Event Enable Register on page 211 OVLRegister Overload Event Register on page 213 STB Read Status Byte on page 178 SRE Service...

Page 203: ...e Event when any IO operation completes IO operations are any remote data request using any interface USB LAN or GPIB For example if you connect to an oscilloscope using the USB interface and then req...

Page 204: ...rload Event Enable Register on page 211 OVLRegister Overload Event Register on page 213 STB Read Status Byte on page 178 SRE Service Request Enable on page 176 Operation Status Event Register OPERegis...

Page 205: ...are any remote data request using any interface USB LAN or GPIB For example if you connect to an oscilloscope using the USB interface and then request waveform data the IOC bit will be set when the IO...

Page 206: ...Armed Event Register TER 4 RUI Enab Remote Enabled Shows whether the remote user interface is enabled The front panel graphical user interface can disable most of the remote interface including the OP...

Page 207: ...uide 207 MTEenable Mask Test Event Enable Register on page 199 OPC Operation Complete on page 168 Operation Status Condition Register OPERegister CONDition on page 1159 Example Checking for Armed Stat...

Page 208: ...remote data request using any interface USB LAN or GPIB For example if you connect to an oscilloscope using the USB interface and then request waveform data the IOC bit will be set when the IO operat...

Page 209: ...remote user interface has gone from a disabled state to an enabled state The front panel graphical user interface can disable most of the remote interface including the OPC syntax for example when a...

Page 210: ...Mask Test Event Event Register on page 201 MTEenable Mask Test Event Enable Register on page 199 OPC Operation Complete on page 168 Operation Status Event Register OPERegister EVENt on page 1157 Exam...

Page 211: ...on the 300 MHz 500 MHz and 1 GHz bandwidth oscilloscope models On these same bandwidth models if there are only two analog channels you can also set external trigger input impedance to 50 Table 78 Ov...

Page 212: ...Status Enable Register on page 203 OPERegister CONDition Operation Status Condition Register on page 205 OPERegister EVENt Operation Status Event Register on page 208 OVLRegister Overload Event Regist...

Page 213: ...impedance to 50 Table 79 Overload Event Register OVLR Bit Description When Set 1 High True Indicates 15 10 Not used 9 Channel 4 Fault Fault has occurred on Channel 4 input 8 Channel 3 Fault Fault has...

Page 214: ...alue NL value integer in NR1 format See Also Introduction to Root Commands on page 185 CHANnel n PROTection on page 273 OPEE Operation Status Enable Register on page 203 OVLenable Overload Event Enabl...

Page 215: ...Introduction to Root Commands on page 185 SINGle on page 217 STOP on page 219 Example Code RUN_STOP not executed in this example RUN starts the data acquisition for the active waveform display STOP st...

Page 216: ...scopes SCPI Programmer s Guide 7 Root Commands SERial see page 1196 Query Syntax SERial The SERial query returns the serial number of the instrument Return Format Unquoted string NL See Also Introduct...

Page 217: ...de 217 SINGle see page 1196 Command Syntax SINGle The SINGle command causes the instrument to acquire a single trigger of data This is the same as pressing the Single key on the front panel See Also I...

Page 218: ...ormat r 1 to ref waveforms in NR1 format The STATus query reports whether the channel function serial decode bus or reference waveform location specified by source is displayed Return Format value NL...

Page 219: ...uide 219 STOP see page 1196 Command Syntax STOP The STOP command stops the acquisition This is the same as pressing the Stop key on the front panel See Also Introduction to Root Commands on page 185 R...

Page 220: ...The Trigger Event Register is summarized in the TRG bit of the Status Byte Register STB A Service Request SRQ can be generated when the TRG bit of the Status Byte transitions and the TRG bit is set in...

Page 221: ...m location See Also Introduction to Root Commands on page 185 BLANk on page 192 CHANnel n DISPlay on page 262 FUNCtion m DISPlay on page 353 SBUS n DISPlay on page 576 WMEMory r DISPlay on page 1084 S...

Page 222: ...222 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 7 Root Commands...

Page 223: ...28 count an integer from 2 to 65536 in NR1 format ACQuire DAALias mode see page 229 ACQuire DAALias see page 229 mode DISable AUTO ACQuire DIGitizer 0 OFF 1 ON see page 230 ACQuire DIGitizer see page...

Page 224: ...uire TYPE HRESolution command sets the oscilloscope in the high resolution mode also known as smoothing This mode is used to reduce noise at slower sweep speeds where the digitizer samples faster than...

Page 225: ...ether for each display point Peak Detect The ACQuire TYPE PEAK command sets the oscilloscope in the peak detect mode In this mode ACQuire COUNt has no meaning Reporting the Setup Use ACQuire to query...

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

Page 227: ...the COMPlete command is 100 All time buckets must contain data for the acquisition to be considered complete Query Syntax ACQuire COMPlete The ACQuire COMPlete query returns the completion criteria 10...

Page 228: ...lue from 2 to 65536 Query Syntax ACQuire COUNT The ACQuire COUNT query returns the currently selected count value for averaging mode Return Format count_argument NL count_argument an integer from 2 to...

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

Page 230: ...dges of or take up just a small portion of the waveform display depending on the oscilloscope s time div setting Digitizer mode cannot be used along with these other oscilloscope features XY and Roll...

Page 231: ...ts the oscilloscope in real time mode The ACQuire MODE SEGMented command sets the oscilloscope in segmented memory mode Query Syntax ACQuire MODE The ACQuire MODE query returns the acquisition mode of...

Page 232: ...en the oscilloscope is running RUN command continuously making acquisitions or when the DIGitize command is used the requested amount of memory is halved The maximum amount of memory available is halv...

Page 233: ...oscope s default This is equivalent to turning Digitizer mode off using the ACQuire DIGitizer command OFF the anallog channel memory depth is set using the ACQuire POINts ANALog command This is equiva...

Page 234: ...imebase synchronization The OUT mode outputs the oscilloscope s internal 10 MHz reference signal to the REF I O MMCX connector The IN mode synchronizes the oscilloscope s timebase to an external 10 MH...

Page 235: ...r all segments that have been acquired It corresponds to the front panel Analyze Segments softkey which appears in both the Measurement Statistics and Segmented Memory Menus In order to use this comma...

Page 236: ...s in the current acquisition is returned by the WAVeform SEGMented COUNt query The maximum number of segments may be limited by the memory depth of your oscilloscope For example an oscilloscope with 1...

Page 237: ...mory segment is returned by the WAVeform SEGMented TTAG query The maximum number of segments may be limited by the memory depth of your oscilloscope For example an oscilloscope with 1M memory allows a...

Page 238: ...nted COUNt strQueryResult myScope ReadString Debug Print Acquisition memory segments strQueryResult If data will be acquired within the IO timeout myScope IO Timeout 10000 myScope WriteString DIGitize...

Page 239: ...ult myScope ReadString Debug Print Acquisition memory segment index strQueryResult Display the segment time tag myScope WriteString WAVeform SEGMented TTAG dblTimeTag myScope ReadNumber Debug Print Se...

Page 240: ...mode with the desired sample rate The Automatic or Digitizer mode setting also affects the memory depth see the ACQuire POINts ANALog command The actual sample rate used is returned by the ACQuire SR...

Page 241: ...scope s default This is equivalent to turning Digitizer mode off using the ACQuire DIGitizer command OFF the anallog channel sample rate is set using the ACQuire SRATe ANALog command This is equivalen...

Page 242: ...memory for the displayed time range For example if the digitizer samples at 200 MSa s but the effective sample rate is 1 MSa s because of a slower sweep speed only 1 out of every 200 samples needs to...

Page 243: ...page 228 ACQuire MODE on page 231 DIGitize on page 193 WAVeform FORMat on page 1009 WAVeform TYPE on page 1026 WAVeform PREamble on page 1014 Example Code AQUIRE_TYPE Sets the acquisition mode which c...

Page 244: ...244 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 8 ACQuire Commands...

Page 245: ...NR1 format CALibrate LABel string see page 248 CALibrate LABel see page 248 string quoted ASCII string up to 32 characters CALibrate OUTPut signal see page 249 CALibrate OUTPut see page 250 signal TR...

Page 246: ...g and querying the calibration label string Reporting the calibration time and date Reporting changes in the temperature since the last calibration Starting the user calibration procedure n a CALibrat...

Page 247: ...Programmer s Guide 247 CALibrate DATE see page 1196 Query Syntax CALibrate DATE The CALibrate DATE query returns the date of the last calibration Return Format date NL date year month day in NR1 form...

Page 248: ...brate 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 Que...

Page 249: ...e when the ATRigger Arm Trigger trigger event is selected see TRIGger NFC TEVent on page 949 The ATRigger trigger event lets you arm the oscilloscope on one event and then trigger on a second event or...

Page 250: ...ingle acquisition The trigger source can be a front panel analog input channel or an external trigger input The output level is 0 5 V into an open circuit and 0 2 5 V into 50 This option is not availa...

Page 251: ...x CALibrate PROTected The CALibrate PROTected query returns the rear panel calibration protect CAL PROTECT button state The value PROTected indicates calibration is disabled and UNPRotected indicates...

Page 252: ...mmand starts the user calibration procedure See Also Introduction to CALibrate Commands on page 246 CALibrate PROTected on page 251 NOTE Before starting the user calibration procedure you must set the...

Page 253: ...us query returns the summary results of the last user calibration procedure Return Format return value NL return value status_code status_string status_code an integer status code status_string an ASC...

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

Page 255: ...Programmer s Guide 255 CALibrate TIME see page 1196 Query Syntax CALibrate TIME The CALibrate TIME query returns the time of the last calibration Return Format date NL date hour minutes seconds in NR1...

Page 256: ...256 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 9 CALibrate Commands...

Page 257: ...alog channels in NR1 format CHANnel n DISPlay 0 OFF 1 ON see page 262 CHANnel n DISPlay see page 262 0 1 n 1 to analog channels in NR1 format CHANnel n IMPedance impedance see page 263 CHANnel n IMPed...

Page 258: ...ee page 270 value P5205 P5210 P6205 P6241 P6243 P6245 P6246 P6247 P6248 P6249 P6250 P6251 P670X P671X TCP202 n 1 to analog channels in NR1 format CHANnel n PROBe SKE W skew_value see page 271 CHANnel...

Page 259: ...ing the Setup Use CHANnel1 CHANnel2 CHANnel3 or CHANnel4 to query setup information for the CHANnel n subsystem Return Format The following are sample responses from the CHANnel n query In this case t...

Page 260: ...g channels in NR1 format The CHANnel n BWLimit command controls an internal low pass filter When the filter is on the bandwidth of the specified channel is limited to approximately 25 MHz Query Syntax...

Page 261: ...channels in NR1 format The CHANnel n COUPling command selects the input coupling for the specified channel The coupling for each analog channel can be set to AC or DC Query Syntax CHANnel n COUPling T...

Page 262: ...o analog channels in NR1 format The CHANnel n DISPlay command turns the display of the specified channel on or off Query Syntax CHANnel n DISPlay The CHANnel n DISPlay query returns the current displa...

Page 263: ...format The CHANnel n 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 Query Syntax CHANnel n IMPeda...

Page 264: ...g channels in NR1 format The CHANnel n INVert command selects whether or not to invert the input signal for the specified channel The inversion may be 1 ON inverted or 0 OFF not inverted Query Syntax...

Page 265: ...l Return Format string NL string quoted ASCII string See Also Introduction to CHANnel n Commands on page 259 DISPlay LABel on page 310 DISPlay LABList on page 311 Example Code LABEL This command allow...

Page 266: ...s varies with the value set by the CHANnel n RANGe and CHANnel n SCALe commands If you set the offset to a value outside of the legal range the offset value is automatically set to the nearest legal v...

Page 267: ...levels If an AutoProbe probe is connected to the oscilloscope the attenuation value cannot be changed from the sensed value Attempting to set the oscilloscope to an attenuation value other than the s...

Page 268: ...dB DIFF0 Differential 0 dB DIFF6 Differential 6 dB DIFF12 Differential 12 dB DIFF20 Differential 20 dB DSMA Differential SMA probe head 0 dB DSMA6 Differential SMA probe head 6 dB Query Syntax CHANne...

Page 269: ...OBe ID query returns the type of probe attached to the specified oscilloscope channel Return Format probe id NL probe id unquoted ASCII string up to 11 characters Some of the possible returned values...

Page 270: ...P6249 P6250 P6251 P670X P671X TCP202 n 1 to analog channels in NR1 format The CHANnel n PROBe MMODel command sets the model number of the supported Tektronix probe Query Syntax CHANnel n PROBe MMODel...

Page 271: ...ts the channel to channel skew factor for the specified channel Each analog channel can be adjusted or 100 ns for a total of 200 ns difference between channels You can use the oscilloscope s probe ske...

Page 272: ...d determines how offset is applied When single ended is selected the CHANnel n OFFSet command changes the offset value of the probe amplifier When differential is selected the CHANnel n OFFSet command...

Page 273: ...overload protection It allows the channel to be used again in 50 mode after the signal that caused the overload has been removed from the channel input Reset the analog channel input impedance to 50 s...

Page 274: ...e range value is multiplied by the probe attenuation factor Query Syntax CHANnel n RANGe The CHANnel n RANGe query returns the current full scale range setting for the specified channel Return Format...

Page 275: ...nd sets the vertical scale or units per division of the selected channel If the probe attenuation is changed the scale value is multiplied by the probe s attenuation factor Query Syntax CHANnel n SCAL...

Page 276: ...cted probe Select VOLT for a voltage probe and select AMPere for a current probe Measurement results channel sensitivity and trigger level will reflect the measurement units you select Query Syntax CH...

Page 277: ...0 OFF n 1 to analog channels in NR1 format The CHANnel n VERNier command specifies whether the channel s vernier fine vertical adjustment setting is ON 1 or OFF 0 Query Syntax CHANnel n VERNier The CH...

Page 278: ...278 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 10 CHANnel n Commands...

Page 279: ...1 COUNter MODE mode see page 283 COUNter MODE see page 283 mode FREQuency PERiod TOTalize COUNter NDIGits value see page 284 COUNter NDIGits see page 284 value 3 to 8 in NR1 format COUNter SOURce sou...

Page 280: ...ing is a sample response from the COUNter query In this case the query was issued following the RST command COUN ENAB 0 SOUR CHAN1 MODE FREQ NDIG 5 COUNter TOTalize GAT E SOURce source see page 289 CO...

Page 281: ...CURRent see page 1196 Query Syntax COUNter CURRent The COUNter CURRent query returns the current counter value Return Format value NL value current counter value in NR3 format See Also COUNter ENABle...

Page 282: ...ENABle 0 OFF 1 ON The COUNter ENABle command enables or disables the counter feature Query Syntax COUNter ENABle The COUNter ENABle query returns whether the counter is enabled or disabled Return For...

Page 283: ...e signal s cycles TOTalize the count of edge events on the signal Query Syntax COUNter MODE The COUNter MODE query returns the counter mode setting Return Format mode NL mode FREQ PER TOT See Also COU...

Page 284: ...s which cause the measurement times to be longer as well Query Syntax COUNter NDIGits The COUNter NDIGits query returns the currently set number of digits of resolution Return Format value NL value 3...

Page 285: ...rigger events are detected This can be more often than when triggers actually occur due to the oscilloscope s acquisition time or update rate capabilities The TRIG OUT signal shows when triggers actua...

Page 286: ...COUNter TOTalize CLEar command zeros the edge event counter See Also COUNter CURRent on page 281 COUNter ENABle on page 282 COUNter MODE on page 283 COUNter NDIGits on page 284 COUNter SOURce on page...

Page 287: ...polarity is true The second gating signal can be one of the remaining analog channel inputs Query Syntax COUNter TOTalize GATE ENABle The COUNter TOTalize GATE ENABle query returns whether totalizer g...

Page 288: ...ating signal is specified with the COUNter TOTalize GATE SOURce command Query Syntax COUNter TOTalize GATE POLarity The COUNter TOTalize GATE POLarity query returns the currently specified gating sign...

Page 289: ...nnel that has the totalizer gating signal Query Syntax COUNter TOTalize GATE SOURce The COUNter TOTalize GATE SOURce query returns the current totalizer gating signal source Return Format source NL Se...

Page 290: ...e edges are counted Query Syntax COUNter TOTalize SLOPe The COUNter TOTalize SLOPe query returns the currently set slope specification Return Format slope NL slope NEG POS See Also COUNter CURRent on...

Page 291: ...Setup Use DEMO to query setup information for the DEMO subsystem Return Format The following is a sample response from the DEMO query In this case the query was issued following the RST command DEMO...

Page 292: ...single shot signal to be output CLK 3 6 MHz clock 2 Vpp 1 V offset with infrequent glitch 1 glitch per 1 000 000 clocks GLITch Burst of 6 digital pulses plus infrequent glitch that occurs once every 8...

Page 293: ...anchester NRZ 125 kbps 2 5 Vpp 1 25 V offset a 125 kb s 10 bit PSI5 like signal MIL MIL STD 1553 RT to RT transfer received 1 3 Vpp transmitted 4 8 Vpp 0 V offset NMONotonic Digital pulse train with i...

Page 294: ...Put on_off on_off 1 ON 0 OFF The DEMO OUTPut command specifies whether the demo signal output is ON 1 or OFF 0 Query Syntax DEMO OUTPut The DEMO OUTPut query returns the current state of the demo sign...

Page 295: ...Notation n COLor color see page 300 DISPlay ANNotation n COLor see page 300 color CH1 CH2 CH3 CH4 DIG MATH REF MARKer WHITe RED n an integer from 1 to 4 in NR1 format DISPlay ANNotation n TEXT string...

Page 296: ...e 309 value an integer from 0 to 100 in NR1 format DISPlay LABel 0 OFF 1 ON see page 310 DISPlay LABel see page 310 0 1 DISPlay LABList binary block see page 311 DISPlay LABList see page 311 binary bl...

Page 297: ...xt This subsystem allows the following actions Clear the waveform area on the display Turn vectors on or off Set waveform persistence Specify labels Save and Recall display data Reporting the Setup Us...

Page 298: ...per left corner of the oscilloscope s display The annotation is useful for documentation purposes to add notes before capturing screens Query Syntax DISPlay ANNotation n The DISPlay ANNotation n query...

Page 299: ...e the annotation has a solid background INVerted the annotation s foreground and background colors are switched Query Syntax DISPlay ANNotation n BACKground The DISPlay ANNotation n BACKground query r...

Page 300: ...ite red or colors that match analog channels digital channels math waveforms reference waveforms or markers Query Syntax DISPlay ANNotation n COLor The DISPlay ANNotation n COLor query returns the spe...

Page 301: ...ckslash and n characters in the string Carriage returns lessen the number of characters available for the annotation string Use DISPlay ANNotation n TEXT to remotely clear the annotation text Two sets...

Page 302: ...otation n X1Position command sets the annotation s horizontal X1 position Query Syntax DISPlay ANNotation n X1Position The DISPlay ANNotation n X1Position query returns the annotation s horizontal X1...

Page 303: ...NNotation n Y1Position command sets the annotation s vertical Y1 position Query Syntax DISPlay ANNotation n Y1Position The DISPlay ANNotation n Y1Position query returns the annotation s vertical Y1 po...

Page 304: ...SPlay 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 a...

Page 305: ...lay data NL display data binary block data in IEEE 488 2 format See Also Introduction to DISPlay Commands on page 297 HCOPY SDUMp DATA on page 388 HCOPY SDUMp FORMat on page 389 RCL Recall on page 171...

Page 306: ...Ticule ALABels 0 OFF 1 ON The DISPlay GRATicule ALABels command turns graticule grid axis labels on or off Query Syntax DISPlay GRATicule ALABels The DISPlay GRATicule ALABels query returns the gratic...

Page 307: ...Tensity value value an integer from 0 to 100 in NR1 format The DISPlay GRATicule INTensity command sets the graticule grid intensity Query Syntax DISPlay GRATicule INTensity The DISPlay GRATicule INTe...

Page 308: ...of Radio Engineers shows vertical grids in IRE units labeled on the left from 40 to 100 IRE The 0 35 V and 0 7 V levels from the MVOLt grid are also shown and labeled at the right When the IRE grid is...

Page 309: ...rom 0 to 100 in NR1 format The DISPlay INTensity WAVeform command sets the waveform intensity This is the same as adjusting the front panel Intensity knob Query Syntax DISPlay INTensity WAVeform The D...

Page 310: ...uery Syntax DISPlay LABel The DISPlay LABel query returns the display mode of the analog channel labels Return Format value NL value 0 1 See Also Introduction to DISPlay Commands on page 297 CHANnel n...

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

Page 312: ...Guide 13 DISPlay Commands DISPlay MENU see page 1196 Command Syntax DISPlay MENU menu menu MASK MEASure SEGMented LISTer OFF The DISPlay MENU command changes the front panel softkey menu or turns it o...

Page 313: ...43A Oscilloscopes SCPI Programmer s Guide 313 DISPlay MESSage CLEar see page 1196 Command Syntax DISPlay MESSage CLEar The DISPlay MESSage CLEar command removes all user messages that are currently on...

Page 314: ...e indicates infinite persistence time for variable persistence that is you can specify how long acquisitions remain on the screen ADAPtive all previous acquisitions that have taken place in hardware s...

Page 315: ...s SCPI Programmer s Guide 315 DISPlay SIDebar see page 1196 Command Syntax DISPlay SIDebar sidebar sidebar SUMMary CURSors MEASurements DVM NAVigate CONTrols EVENts COUNter The DISPlay SIDebar command...

Page 316: ...vectors vectors 1 ON Vector display is always ON in the P9241 42 43A oscilloscopes When vectors are turned on the oscilloscope displays lines connecting sampled data points Query Syntax DISPlay VECTor...

Page 317: ...nd Query Returns DVM ARANge 0 OFF 1 ON see page 318 DVM ARANge see page 318 0 1 n a DVM CURRent see page 319 dvm_value floating point number in NR3 format DVM ENABle 0 OFF 1 ON see page 320 DVM ENABle...

Page 318: ...cale vertical ground level position and trigger threshold voltage level used for the counter frequency measurement are automatically adjusted The Auto Range capability overrides attempted adjustments...

Page 319: ...Return Format dvm_value NL dvm_value floating point number in NR3 format See Also DVM SOURce on page 322 DVM ENABle on page 320 DVM MODE on page 321 NOTE It can take up to a few seconds after DVM ana...

Page 320: ...ng OFF 0 ON 1 The DVM ENABle command turns the digital voltmeter DVM analysis feature on or off Query Syntax DVM ENABle The DVM ENABle query returns a flag indicating whether the digital voltmeter DVM...

Page 321: ...RMs displays the root mean square value of the acquired data with the DC component removed DC displays the DC value of the acquired data DCRMs displays the root mean square value of the acquired data...

Page 322: ...analog channel on which digital voltmeter DVM measurements are made The selected channel does not have to be on displaying a waveform in order for DVM measurements to be made Query Syntax DVM SOURce...

Page 323: ...the Setup Use EXTernal to query setup information for the EXTernal subsystem Return Format The following is a sample response from the EXTernal query In this case the query was issued following a RST...

Page 324: ...roduct 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...

Page 325: ...onstants for scaling the display factors and for setting trigger levels If an AutoProbe probe is connected to the oscilloscope the attenuation value cannot be changed from the sensed value Attempting...

Page 326: ...1 1 probe attenuation the range can only be set to 8 0 V If the probe attenuation is changed the range value is multiplied by the probe attenuation factor Query Syntax EXTernal RANGe The EXTernal RAN...

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

Page 328: ...328 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 15 EXTernal Trigger Commands...

Page 329: ...sis ENABle see page 332 0 1 FRANalysis FREQuency MODE setting see page 333 FRANalysis FREQuency MODE see page 333 setting SWEep SINGle FRANalysis FREQuency SINGle value suffix see page 334 FRANalysis...

Page 330: ...AN2 FRAN FREQ STAR 100E 00 STOP 20 000000E 06 FRAN WGEN VOLT 200 0E 03 LOAD FIFT FRANalysis SOURce IN Put source see page 339 FRANalysis SOURce IN Put see page 339 source CHANnel n n 1 to analog chann...

Page 331: ...ts The SWEep or SINGle option specifies whether to get the data from a sweep or single frequency analysis see FRANalysis FREQuency MODE If this option is not specified the data from the sweep analysis...

Page 332: ...Query Syntax FRANalysis ENABle The FRANalysis ENABle query returns a flag indicating whether the Frequency Response Analysis FRA feature is on or off Return Format setting NL setting 0 1 See Also FRAN...

Page 333: ...equency response analysis or analysis at a single frequency which can be useful when debugging Query Syntax FRANalysis FREQuency MODE The FRANalysis FREQuency MODE query returns the frequency mode set...

Page 334: ...n select from decade values in addition to the minimum frequency of 20 Hz Query Syntax FRANalysis FREQuency SINGle The FRANalysis FREQuency SINGle query returns the single frequency setting Return For...

Page 335: ...e values in addition to the minimum frequency of 20 Hz Query Syntax FRANalysis FREQuency STARt The FRANalysis FREQuency STARt query returns the frequency sweep start setting Return Format value NL val...

Page 336: ...es in addition to the maximum frequency of 20 MHz Query Syntax FRANalysis FREQuency STOP The FRANalysis FREQuency STOP query returns the frequency sweep stop setting Return Format value NL value 100 1...

Page 337: ...50 60 70 80 90 100 The FRANalysis PPDecade command specifies the number of points per decade in the frequency response analysis Query Syntax FRANalysis PPDecade The FRANalysis PPDecade query returns t...

Page 338: ...comma separated columns of data for each step in the sweep Frequency Hz Amplitude Vpp Gain dB and Phase You can use the FRANalysis TRACe command to specify whether to include gain phase both gain and...

Page 339: ...voltage to the device under test DUT in the frequency response analysis Query Syntax FRANalysis SOURce INPut The FRANalysis SOURce INPut query returns the currently selected channel probing the input...

Page 340: ...voltage from the device under test DUT in the frequency response analysis Query Syntax FRANalysis SOURce OUTPut The FRANalysis SOURce OUTPut query returns the currently selected channel probing the ou...

Page 341: ...nse analysis results Query Syntax FRANalysis TRACe The FRANalysis TRACe query returns a comma separated list of the types of data that are currently included in the frequency response analysis results...

Page 342: ...e and offset levels for the expected output load If the actual load impedance is different than the selected value the displayed amplitude and offset levels will be incorrect Query Syntax FRANalysis W...

Page 343: ...ile setting is on FRANalysis WGEN VOLTage PROFile ON the range option specifies the initial ramp amplitude at the frequency setting Amplitudes ramp between the settings specified for individual freque...

Page 344: ...e PROFile command enables or disables the ability to specify amplitude ramping within different decades Query Syntax FRANalysis WGEN VOLTage PROFile The FRANalysis WGEN VOLTage PROFile query returns t...

Page 345: ...53 0 1 m 1 to math functions in NR1 format n a FUNCtion m FFT BS IZe see page 354 bin_size Hz in NR3 format m 1 to math functions in NR1 format FUNCtion m FFT CE NTer frequency see page 355 FUNCtion m...

Page 346: ...point see page 361 FUNCtion m FFT PH ASe REFerence see page 361 ref_point TRIGger DISPlay m 1 4 in NR1 format n a FUNCtion m FFT RB Width see page 362 resolution_bw Hz in NR3 format m 1 to math functi...

Page 347: ...LOWPass see page 369 3dB_freq 3dB cutoff frequency value in NR3 format m 1 to math functions in NR1 format FUNCtion m INTegrat e IOFFset input_offset see page 370 FUNCtion m INTegrat e IOFFset see pag...

Page 348: ...s 8E 9 to 400E 3 The range for the DIFF function is 80E 3 to 8 0E12 depends on current sweep speed The range for the FFT function is 8 to 800 dBV m 1 to math functions in NR1 format FUNCtion m REFeren...

Page 349: ...Setup Use FUNCtion m to query setup information for the FUNCtion subsystem Return Format FUNCtion m SOURce1 source see page 382 FUNCtion m SOURce1 see page 382 source CHANnel n FUNCtion c MATH c WMEMo...

Page 350: ...SCPI Programmer s Guide 17 FUNCtion m Commands The following is a sample response from the FUNCtion1 query In this case the query was issued following a RST command FUNC1 OPER ADD DISP 0 SOUR1 CHAN1...

Page 351: ...AVERage COUNt command sets the number of waveforms to be averaged together The number of averages can be set from 2 to 65536 in increments of powers of 2 Increasing the number of averages will increas...

Page 352: ...17 FUNCtion m Commands FUNCtion m CLEar see page 1196 Command Syntax FUNCtion m CLEar When the FUNCtion m OPERation is AVERage MAXHold or MINHold the FUNCtion m CLEar command clears the number of eva...

Page 353: ...th functions are off they are still calculated so that they can be cascaded that is used as a source for a higher math function Query Syntax FUNCtion m DISPlay The FUNCtion m DISPlay query returns whe...

Page 354: ...on m Commands FUNCtion m FFT BSIZe see page 1196 Query Syntax FUNCtion m FFT BSIZe m 1 4 in NR1 format The FUNCtion m FFT BSIZe query returns the Bin Size setting for the FFT Return Format bin_size NL...

Page 355: ...CENTer The FUNCtion m FFT CENTer query returns the current center frequency in Hertz Return Format frequency NL frequency the current center frequency in NR3 format The range of legal values is from 2...

Page 356: ...that the FFT detector should decimate to This is also the number of buckets that sampled FFT points are grouped into before the selected detection type reduction decimation is applied The minimum numb...

Page 357: ...he selected detection type The detector types are OFF No detector is used SAMPle Takes the point nearest to the center of every bucket PPOSitive Peak Takes the most positive point in every bucket PNEG...

Page 358: ...ency in the FFT Fast Fourier Transform math function s displayed range The FFT Fast Fourier Transform math function s displayed range can also be set with the FUNCtion m FFT CENTer and FUNCtion m FFT...

Page 359: ...in the FFT Fast Fourier Transform math function s displayed range The FFT Fast Fourier Transform math function s displayed range can also be set with the FUNCtion m FFT CENTer and FUNCtion m FFT SPAN...

Page 360: ...command specifies whether the FFT is performed on the Main time base window NONE or the ZOOM window when the zoomed time base is displayed Query Syntax FUNCtion m FFT GATE The FUNCtion m FFT GATE quer...

Page 361: ...e FUNCtion m FFT PHASe REFerence command sets the reference point for calculating the FFT Phase function to either the trigger point or beginning of the displayed waveform Query Syntax FUNCtion m FFT...

Page 362: ...FUNCtion m FFT RBWidth see page 1196 Query Syntax FUNCtion m FFT RBWidth m 1 4 in NR1 format The FUNCtion m FFT RBWidth query returns the Resolution Bandwidth setting for the FFT Return Format resolut...

Page 363: ...om these types of readouts for the FFT SRATe Sample Rate BSIZe Bin Size RBWidth Resolution Bandwidth Note that READout1 is used for both the dedicated FFT and the general purpose math FFT function and...

Page 364: ...ight graticule when FFT Fast Fourier Transform is selected Query Syntax FUNCtion m FFT SPAN The FUNCtion m FFT SPAN query returns the current frequency span in Hertz Return Format span NL span the cur...

Page 365: ...Guide 365 FUNCtion m FFT SRATe see page 1196 Query Syntax FUNCtion m FFT SRATe m 1 4 in NR1 format The FUNCtion m FFT SRATe query returns the Sample Rate setting for the FFT Return Format sample_rate...

Page 366: ...and specifies FFT vertical units For the FFT Magnitude operation units DECibel equates to the user interface s Logarithmic selection and VRMS equates to the user interface s Linear selection Query Syn...

Page 367: ...als RECTangular useful for transient signals and signals where there are an integral number of cycles in the time record HANNing useful for frequency resolution and general purpose use It is good for...

Page 368: ...cutoff frequency value in NR3 format The FUNCtion m FREQuency HIGHpass command sets the high pass filter s 3 dB cutoff frequency The high pass filter is a single pole high pass filter Query Syntax FU...

Page 369: ...cutoff frequency value in NR3 format The FUNCtion m FREQuency LOWPass command sets the low pass filter s 3 dB cutoff frequency The low pass filter is a 4th order Bessel Thompson filter Query Syntax F...

Page 370: ...FUNCtion m INTegrate IOFFset command lets you enter a DC offset correction factor for the integrate math waveform input signal This DC offset correction lets you level a ramp ed waveform Query Syntax...

Page 371: ...r GAIN value m 1 to math functions in NR1 format value A in Ax B value in NR3 format The FUNCtion m LINear GAIN command specifies the A value in the Ax B operation Query Syntax FUNCtion m LINear GAIN...

Page 372: ...Set value m 1 to math functions in NR1 format value B in Ax B value in NR3 format The FUNCtion m LINear OFFSet command specifies the B value in the Ax B operation Query Syntax FUNCtion m LINear OFFSet...

Page 373: ...e current scale of the selected function but will vary by function If you set the offset to a value outside of the legal range the offset value is automatically set to the nearest legal value Query Sy...

Page 374: ...Using the Fast Fourier Transform FFT this operation displays the magnitudes of the frequency content that makes up the source waveform The FFT takes the digitized time record of the specified source...

Page 375: ...ain You can use both types of averaging to get a certain number of averages on all waveforms and an increased number of averages on a particular waveform Averages are calculated using a decaying avera...

Page 376: ...gle analog channel source or on a lower math function The Max Hold or Max Envelope operator records the maximum vertical values found at each horizontal bucket across multiple analysis cycles and uses...

Page 377: ...n m INTegrate IOFFset on page 370 FUNCtion m FFT SPAN on page 364 FUNCtion m FFT CENTer on page 355 FUNCtion m FFT PHASe REFerence on page 361 FUNCtion m FFT VTYPe on page 366 FUNCtion m FFT WINDow on...

Page 378: ...ertical axis value in NR3 format The FUNCtion m RANGe command defines the full scale vertical axis for the selected function Query Syntax FUNCtion m RANGe The FUNCtion m RANGe query returns the curren...

Page 379: ...current scale of the selected function but will vary by function If you set the reference level to a value outside of the legal range the level is automatically set to the nearest legal value Query Sy...

Page 380: ...uery returns the current scale value for the selected function Return Format scale value NL scale value vertical units div value in NR3 format See Also Introduction to FUNCtion m Commands on page 349...

Page 381: ...format When the FUNCtion m OPERation is SMOoth the FUNCtion m SMOoth POINts command sets the number of smoothing points to use You can choose an odd number of points from 3 up to half of the measurem...

Page 382: ...n m In other words higher math functions can operate on lower math functions when using operators other than the simple arithmetic operations For example if FUNCtion1 OPERation is a SUBTract of CHANne...

Page 383: ...e1 query returns the current source1 for function operations When FUNCtion m OPERation is TRENd the FUNCtion m SOURce1 query returns the source of the measurement Return Format value NL value CHAN n F...

Page 384: ...sform functions filter functions or visualization functions except when the measurement trend visualization s measurement requires two sources When FUNCtion m OPERation is TRENd the FUNCtion m SOURce2...

Page 385: ...e location of the measurement whose trend you want to analyze You can view the trend math function waveform for these installed measurements MEASure VAVerage interval CYCLe MEASure VRMS type AC AC RMS...

Page 386: ...386 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 17 FUNCtion m Commands...

Page 387: ...lection of hardcopy device and formatting options Table 90 HCOPY Commands Summary Command Query Options and Query Returns n a HCOPY SDUMp DATA see page 388 display_data binary block data in IEEE 488 2...

Page 388: ...ead of a setup or data format is selected If no format option is specified with this query the screen image data is returned in the currently selected format After a RST factory default command the PN...

Page 389: ...SDUMp FORMat setting will affect the front panel s Main Menu File Save Menu Format softkey setting if the Format softkey currently selects an image format instead of a setup or data format Query Synta...

Page 390: ...390 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 18 HCOPY Commands...

Page 391: ...data from the Lister display Table 91 LISTer Commands Summary Command Query Options and Query Returns n a LISTer DATA see page 392 binary_block comma separated data with newlines at the end of each r...

Page 392: ...1196 Query Syntax LISTer DATA The LISTer DATA query returns the lister data Return Format binary block NL binary_block comma separated data with newlines at the end of each row See Also Introduction t...

Page 393: ...the Lister or whether the Lister is off ON or 1 is the same as SBUS1 When set to ALL the decode information for different buses is interleaved in time Serial bus decode must be on before it can be dis...

Page 394: ...ence command selects whether the time value for a Lister row is relative to the trigger or the previous Lister row Query Syntax LISTer REFerence The LISTer REFerence query returns the Lister time refe...

Page 395: ...ANual WAVeform BINary HEX MARKer X1 DISPlay 0 OFF 1 ON see page 400 MARKer X1 DISPlay see page 400 setting 0 1 MARKer X1Position position suffix see page 401 MARKer X1Position see page 401 position X1...

Page 396: ...ta value in NR3 format MARKer XUNits mode see page 407 MARKer XUNits see page 407 units SEConds HERTz DEGRees PERCent MARKer XUNits USE see page 408 n a n a MARKer Y1 DISPlay 0 OFF 1 ON see page 409 M...

Page 397: ...cursor values Reporting the Setup Use MARKer to query setup information for the MARKer subsystem Return Format The following is a sample response from the MARKer query In this case the query was issue...

Page 398: ...at value NL value Y X value in NR3 format See Also Introduction to MARKer Commands on page 397 MARKer MODE on page 399 MARKer X1Position on page 401 MARKer X2Position on page 404 MARKer X1Y1source on...

Page 399: ...measurement source remotely always sets the marker sources WAVeform the Y1 cursor tracks the voltage value at the X1 cursor of the waveform specified by the X1Y1source and the Y2 cursor does the same...

Page 400: ...e page 1196 Command Syntax MARKer X1 DISPlay 0 OFF 1 ON The MARKer X1 DISPlay command specifies whether the X1 cursor is displayed Query Syntax MARKer X1 DISPlay The MARKer X1 DISPlay query returns th...

Page 401: ...y Syntax MARKer X1Position The MARKer X1Position query returns the current X1 cursor position This is functionally equivalent to the obsolete MEASure TSTArt command query Return Format position NL pos...

Page 402: ...l mode Setting the source for one pair of markers for example X1Y1 sets the source for the other for example X2Y2 If the marker mode is currently WAVeform the X1Y1 source can be set separate from the...

Page 403: ...e page 1196 Command Syntax MARKer X2 DISPlay 0 OFF 1 ON The MARKer X2 DISPlay command specifies whether the X2 cursor is displayed Query Syntax MARKer X2 DISPlay The MARKer X2 DISPlay query returns th...

Page 404: ...UNits command Query Syntax MARKer X2Position The MARKer X2Position query returns current X2 cursor position This is functionally equivalent to the obsolete MEASure TSTOp command query Return Format po...

Page 405: ...al mode Setting the source for one pair of markers for example X2Y2 sets the source for the other for example X1Y1 If the marker mode is currently WAVeform the X2Y2 source can be set separate from the...

Page 406: ...set by the MARKer XUNits command Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 397 MARKer MODE on page 399 MARKer X1Position on page 401...

Page 407: ...degrees PERCent for making ratio measurements Use the MARKer XUNits USE command to set the current X1 location as 0 percent and the current X2 location as 100 percent Changing X units affects the inpu...

Page 408: ...r XUNits USE command sets the current X1 location as 0 percent and the current X2 location as 100 percent Once the 0 and 360 degree or 0 and 100 percent locations are set inputs to and outputs from th...

Page 409: ...e page 1196 Command Syntax MARKer Y1 DISPlay 0 OFF 1 ON The MARKer Y1 DISPlay command specifies whether the Y1 cursor is displayed Query Syntax MARKer Y1 DISPlay The MARKer Y1 DISPlay query returns th...

Page 410: ...nnot be set Query Syntax MARKer Y1Position The MARKer Y1Position query returns current Y1 cursor position This is functionally equivalent to the obsolete MEASure VSTArt command query Return Format pos...

Page 411: ...e page 1196 Command Syntax MARKer Y2 DISPlay 0 OFF 1 ON The MARKer Y2 DISPlay command specifies whether the Y2 cursor is displayed Query Syntax MARKer Y2 DISPlay The MARKer Y2 DISPlay query returns th...

Page 412: ...annot be set Query Syntax MARKer Y2Position The MARKer Y2Position query returns current Y2 cursor position This is functionally equivalent to the obsolete MEASure VSTOp command query Return Format pos...

Page 413: ...er YUNits command Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 397 MARKer MODE on page 399 MARKer X1Y1source on page 402 MARKer X2Y2sour...

Page 414: ...t Y1 location as 0 percent and the current Y2 location as 100 percent Changing Y units affects the input and output values of the MARKer Y1Position MARKer Y2Position and MARKer YDELta commands queries...

Page 415: ...e current Y2 location as 100 percent Once the 0 and 100 percent locations are set inputs to and outputs from the MARKer Y1Position MARKer Y2Position and MARKer YDELta commands queries are relative to...

Page 416: ...416 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 20 MARKer Commands...

Page 417: ...e page 435 MEASure AREa interval source see page 435 interval CYCLe DISPlay source CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to...

Page 418: ...e 439 MEASure COUNter source see page 439 source CHANnel n EXTernal n 1 to analog channels in NR1 format return_value counter frequency in Hertz in NR3 format MEASure DEFine DELay delay spec see page...

Page 419: ...thresho ld source2_edge_slope source2_edge_number source2_edge_thresho ld see page 445 MEASure DELay DEFine see page 445 source1_edge_slope source2_edge_slope RISing FALLing source1_edge_number source...

Page 420: ...acing chan source see page 448 chan_width width of main range and sideband channels Hz in NR3 format chan_spacing spacing between main range and sideband channels Hz in NR3 format chan CENTer HIGH sb...

Page 421: ...format MEASure FFT THD source see page 451 MEASure FFT THD source see page 451 source FUNCtion m MATH m FFT source must be an FFT waveform m 1 to math functions in NR1 format return_value total harmo...

Page 422: ...454 MEASure NEDGes source see page 454 source CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_...

Page 423: ...hoot source see page 457 source CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value the perce...

Page 424: ...PHASe source1 source2 see page 461 source1 2 CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_v...

Page 425: ...HANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value width of positive pulse in seconds in NR3...

Page 426: ...SLEWrate source slope see page 471 source CHANnel n FUNCtion m MATH m WMEMory r n 1 to of analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format MEASure S...

Page 427: ...page 478 n a n a MEASure STATistics R SDeviation 0 OFF 1 ON see page 479 MEASure STATistics R SDeviation see page 479 0 1 MEASure TEDGe slope occurrence source see page 480 MEASure TEDGe slope occurre...

Page 428: ...in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value time in seconds of specified voltage crossing in NR3 format MEASure VAMPlitude source see page 485 ME...

Page 429: ...e 487 MEASure VBASe source see page 487 source CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format base_vo...

Page 430: ...e CHANnel n FUNCtion m FFT MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value voltage peak to peak of the selecte...

Page 431: ...igger in seconds in NR3 format source CHANnel n FUNCtion m MATH m WMEMory r n 1 to analog channels in NR1 format m 1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value vol...

Page 432: ...1 to math functions in NR1 format r 1 to ref waveforms in NR1 format return_value horizontal value of the maximum in NR3 format MEASure XMIN source see page 496 MEASure XMIN source see page 496 source...

Page 433: ...ere are not three edges the oscilloscope will revert to the mode of making the measurement at the start of the main sweep When the command form is used the measurement result is displayed on the instr...

Page 434: ...scilloscopes SCPI Programmer s Guide 21 MEASure Commands MEASure ALL see page 1196 Command Syntax MEASure ALL This command installs a Snapshot All measurement on the screen See Also Introduction to ME...

Page 435: ...on screen Area measurements show the area between the waveform and the ground level The interval option lets you specify the measurement interval either an integral number of cycles or the full scree...

Page 436: ...t If the optional source parameter is specified the currently specified source is modified Query Syntax MEASure BRATe source The MEASure BRATe query measures all positive and negative pulse widths on...

Page 437: ...th measurement on screen If the optional source parameter is not specified the current measurement source is used Query Syntax MEASure BWIDth source The MEASure BWIDth query measures and returns the w...

Page 438: ...copes SCPI Programmer s Guide 21 MEASure Commands MEASure CLEar see page 1196 Command Syntax MEASure CLEar This command clears all selected measurements and markers from the screen See Also Introducti...

Page 439: ...0 s Unlike other measurements the Zoom horizontal timebase window does not gate the Counter measurement The Counter measurement can measure frequencies up to the bandwidth of the oscilloscope The mini...

Page 440: ...by redefining the DELay specification or the THResholds values For example changing the THResholds definition from the default 10 50 and 90 values may change the returned measurement result MEASure D...

Page 441: ...re DEFine THResholds Command Syntax MEASure DEFine THResholds threshold spec source threshold spec STANdard threshold mode upper middle lower threshold mode PERCent ABSolute for threshold mode PERCent...

Page 442: ...lds setup Return Format for meas_spec DELay edge_spec1 edge_spec2 edge_spec1 edge_spec2 NL for meas_spec THResholds and threshold mode PERCent THR PERC upper middle lower NL upper middle lower A numbe...

Page 443: ...losest to the source1 edge is used MANual edge numbers are determined by the MEASure DELay DEFine settings Edge numbers greater than zero 0 are counted from the left side of the display for both sourc...

Page 444: ...ay measurement point nearer to Vtop or Vbase you must change the threshold values with the MEASure DEFine THResholds command Return Format value NL value floating point number delay time in seconds in...

Page 445: ...ifies that the edge closest to the timebase reference point automatically be selected In this case the source2_edge_number setting must also be zero 0 and the source2 edge closest to the selected sour...

Page 446: ...query measures and outputs the positive duty cycle of the signal specified by the MEASure SOURce command The value returned for the duty cycle is the ratio of the positive pulse width to the period Th...

Page 447: ...ource is modified Query Syntax MEASure FALLtime source The MEASure FALLtime query measures and outputs the fall time of the displayed falling negative going edge closest to the timebase reference The...

Page 448: ...center frequency The center frequency used in the measurement is the one defined for the FFT function Sidebands with the same width as the main range exist above and below the main range separated by...

Page 449: ...ectral power across a frequency range The center frequency used in the measurement is the one defined for the FFT function and the FFT span specifies the frequency range When this measurement is track...

Page 450: ...containing some percent usually 99 of the total spectral power While 99 is the industry norm you can specify the percent you want to use in the measurement The center frequency used in the measurement...

Page 451: ...rounding the fundamental frequency The width of the bands measured is the same for the fundamental frequency and each harmonic That width is 1 2 of the fundamental frequency You can either enter the f...

Page 452: ...odified IF the edge on the screen closest to the trigger reference is rising THEN frequency 1 time at trailing rising edge time at leading rising edge ELSE frequency 1 time at trailing falling edge ti...

Page 453: ...e NDUTy query measures and outputs the negative duty cycle of the signal specified by the MEASure SOURce command The value returned for the duty cycle is the ratio of the negative pulse width to the p...

Page 454: ...t The MEASure NEDGes command installs a falling edge count measurement on screen If the optional source parameter is not specified the current source is measured Query Syntax MEASure NEDGes source The...

Page 455: ...The MEASure NPULses command installs a falling pulse count measurement on screen If the optional source parameter is not specified the current source is measured Query Syntax MEASure NPULses source Th...

Page 456: ...ed the current source is modified Query Syntax MEASure NWIDth source The MEASure NWIDth query measures and outputs the width of the negative pulse on the screen closest to the trigger reference using...

Page 457: ...easurements Vtop Vbase and either Vmax or Vmin depending on whether the edge is rising or falling For a rising edge overshoot Vmax Vtop Vtop Vbase x 100 For a falling edge overshoot Vbase Vmin Vtop Vb...

Page 458: ...458 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 21 MEASure Commands MEASure VMAX on page 488 MEASure VTOP on page 493 MEASure VBASe on page 487 MEASure VMIN on page 489...

Page 459: ...mat The MEASure PEDGes command installs a rising edge count measurement on screen If the optional source parameter is not specified the current source is measured Query Syntax MEASure PEDGes source Th...

Page 460: ...query measures and outputs the period of the cycle closest to the trigger reference on the screen The period is measured at the midpoint of the upper and lower thresholds IF the edge closest to the tr...

Page 461: ...d returns the phase between the specified sources A phase measurement is a combination of the period and delay measurements First the period is measured on source1 Then the delay is measured between s...

Page 462: ...The MEASure PPULses command installs a rising pulse count measurement on screen If the optional source parameter is not specified the current source is measured Query Syntax MEASure PPULses source Th...

Page 463: ...ase and either Vmin or Vmax depending on whether the edge is rising or falling For a rising edge preshoot Vmin Vbase Vtop Vbase x 100 For a falling edge preshoot Vmax Vtop Vtop Vbase x 100 Vtop and Vb...

Page 464: ...ASure PWIDth source The MEASure PWIDth query measures and outputs the width of the displayed positive pulse closest to the trigger reference Pulse width is measured at the midpoint of the upper and lo...

Page 465: ...nt for any of the measurements is 0 the value of infinity 9 9E 37 is returned for the min max mean and standard deviation Return Format result_list NL result_list comma separated list of measurement r...

Page 466: ...y MeasurementArray 1 DUTYcycle MeasurementArray 2 VAMPlitude MeasurementArray 3 VPP Dim Measurement As Variant For Each Measurement In MeasurementArray myScope WriteString MEASure Measurement myScope...

Page 467: ...tatistics For Each ValueColumn In ValueColumnArray If VarType ResultsList intCounter vbString Then Debug Print Measure statistics result CH1 _ Measurement ValueColumn _ FormatNumber ResultsList intCou...

Page 468: ...rise time of the displayed rising positive going edge closest to the timebase reference For maximum measurement accuracy set the sweep speed as fast as possible while leaving the leading edge of the w...

Page 469: ...source parameter is specified the current source is modified Query Syntax MEASure SDEViation source The MEASure SDEViation query measures and outputs the std deviation of the selected waveform The os...

Page 470: ...N The MEASure SHOW command enables markers for tracking measurements on the display Query Syntax MEASure SHOW The MEASure SHOW query returns the current state of the markers This can return OFF when M...

Page 471: ...are specified by the measurement threshold settings for the source waveform see MEASure DEFine If the source parameter is not specified the current MEASure SOURce setting is used The on screen edge cl...

Page 472: ...nel n FUNCtion m or MATH m will also set MARKer X1Y1source to source1 and MARKer X2Y2source to source2 Query Syntax MEASure SOURce The MEASure SOURce query returns the current source selections If sou...

Page 473: ...r duty cycle varQueryResult myScope ReadNumber Read duty cycle MsgBox Duty cycle vbCrLf _ FormatNumber varQueryResult 3 myScope WriteString MEASure RISetime Query for risetime varQueryResult myScope R...

Page 474: ...tion returned by the MEASure RESults query ON means all the statistics are on Query Syntax MEASure STATistics The MEASure STATistics query returns the current statistics mode Return Format type NL typ...

Page 475: ...the measurement statistics Query Syntax MEASure STATistics DISPlay The MEASure STATistics DISPlay query returns the state of the measurement statistics display Return Format 0 1 NL See Also Introducti...

Page 476: ...ts you for example gather statistics over multiple pulses captured in a single acquisition To do this change the horizontal position and enter the command for each new pulse that is measured This comm...

Page 477: ...when calculating measurement statistics Query Syntax MEASure STATistics MCOunt The MEASure STATistics MCOunt query returns the current measurement statistics max count setting Return Format setting N...

Page 478: ...This command resets the measurement statistics zeroing the counts Note that the measurement statistics configuration is not deleted See Also Introduction to MEASure Commands on page 432 MEASure STATis...

Page 479: ...s standard deviation mean in the measurement statistics Query Syntax MEASure STATistics RSDeviation The MEASure STATistics RSDeviation query returns the current relative standard deviation setting Ret...

Page 480: ...command The optional slope parameter specifies whether to look for RISing edges or FALLing edges If not otherwise specified rising edges are assumed The occurrence parameter specifies the Nth edge to...

Page 481: ...falling edge of the channel time at the same edge of another channel Phase delay between channels period of channel x 360 For example Make a delay measurement between channel 1 and 2 Dim dblChan1Edge...

Page 482: ...Edge2 dblChan1Edge1 Calculate phase difference between ch1 and ch2 dblPhase dblDelay dblPeriod 360 MsgBox Phase vbCrLf CStr dblPhase See complete example programs at Chapter 38 Programming Examples st...

Page 483: ...er event and this defined occurrence is returned as the response to the query The specified value can be negative or positive To specify a negative value use a minus sign The sign of the slope selects...

Page 484: ...illoscopes SCPI Programmer s Guide 21 MEASure Commands value time in seconds of the specified value crossing in NR3 format See Also Introduction to MEASure Commands on page 432 MEASure TEDGe on page 4...

Page 485: ...litude measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VAMPlitude source The MEASure VAMPlitude query measures and returns the vertical am...

Page 486: ...reen measurement and starts an average value measurement The interval option lets you specify the measurement interval either an integral number of cycles or the full screen If interval is not specifi...

Page 487: ...If the optional source parameter is specified the current source is modified Query Syntax MEASure VBASe source The MEASure VBASe query returns the vertical value at the base of the waveform The base v...

Page 488: ...installs a screen measurement and starts a maximum vertical value measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VMAX source The MEASure...

Page 489: ...lls a screen measurement and starts a minimum vertical value measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VMIN source The MEASure VMIN...

Page 490: ...ecified the current source is modified Query Syntax MEASure VPP source The MEASure VPP query measures the maximum and minimum vertical value for the selected source then calculates the vertical peak t...

Page 491: ...of the ACRMS value of source1 to that of source2 expressed in dB The interval option lets you specify the measurement interval either an integral number of cycles or the full screen If interval is no...

Page 492: ...cify the measurement interval either an integral number of cycles or the full screen If interval is not specified DISPlay is implied The type option lets you choose between a DC RMS measurement and an...

Page 493: ...and starts a waveform top value measurement Query Syntax MEASure VTOP source The MEASure VTOP query returns the vertical value at the top of the waveform The top value of the pulse is normally not th...

Page 494: ...ZOOM the measurement window is the lower Zoom window AUTO when the zoomed time base is displayed the measurement is attempted in the lower Zoom window if it cannot be made there or if the zoomed time...

Page 495: ...starts an X at Max Y measurement on the selected window If the optional source parameter is specified the current source is modified Query Syntax MEASure XMAX source The MEASure XMAX query measures an...

Page 496: ...tarts an X at Min Y measurement on the selected window If the optional source parameter is specified the current source is modified Query Syntax MEASure XMIN source The MEASure XMIN query measures and...

Page 497: ...specified horizontal value must be on the screen when it is a time value it is referenced to the trigger event If the optional source parameter is specified the measurement source is modified Query S...

Page 498: ...498 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 21 MEASure Commands...

Page 499: ...1 2 for 2ch models MTESt AMASk UNITs units see page 507 MTESt AMASk UNITs see page 507 units CURRent DIVisions MTESt AMASk XDELta value see page 508 MTESt AMASk XDELta see page 508 value X delta value...

Page 500: ...e 521 0 1 MTESt RMODe SIGMa level see page 522 MTESt RMODe SIGMa see page 522 level from 0 1 to 9 3 in NR3 format MTESt RMODe TIME seconds see page 523 MTESt RMODe TIME see page 523 seconds from 1 to...

Page 501: ...E 06 XDEL 400 000E 06 Y1 3 00000E 00 Y2 3 00000E 00 BIND 0 MTES RMOD FOR RMOD TIME 1E 00 WAV 1000 SIGM 6 0E 00 MTES RMOD FACT STOP 0 PRIN 0 SAVE 0 Example Code Mask testing commands example Option Exp...

Page 502: ...ring MTESt AMASk SOURce strQueryResult myScope ReadString Debug Print Mask test auto mask source strQueryResult myScope WriteString MTESt AMASk UNITs DIVisions myScope WriteString MTESt AMASk UNITs st...

Page 503: ...r CONDition varQueryResult myScope ReadNumber Operation Status Condition Register RUN bit bit 3 H8 If varQueryResult And H8 0 Then Exit Do Else Sleep 100 Small wait to prevent excessive queries lngEla...

Page 504: ...ESt ALL command specifies the channel s that are included in the mask test ON All displayed analog channels are included in the mask test OFF Just the selected source channel is included in the test Q...

Page 505: ...MTESt AMASk UNITs commands The mask only encompasses the portion of the waveform visible on the display so you must ensure that the waveform is acquired and displayed consistently to obtain repeatabl...

Page 506: ...el units as set by the CHANnel n UNITs command of the selected source Suppose that UNITs are CURRent and that you set SOURce to CHANNEL1 which is using units of volts Then you can define AMASk XDELta...

Page 507: ...stem uses the graticule as the measurement system so tolerance settings are specified as parts of a screen division The mask test subsystem maintains separate XDELta and YDELta settings for CURRent an...

Page 508: ...for MTESt AMASk UNITs is CURRent and the current setting specifies time in the horizontal direction the tolerance will be 250 ms If the setting for MTESt AMASk UNITs is DIVisions the same X delta val...

Page 509: ...ESt AMASk UNITs is CURRent and the current setting specifies voltage in the vertical direction the tolerance will be 250 mV If the setting for MTESt AMASk UNITs is DIVisions the same Y delta value wil...

Page 510: ...mask test run This count is for all regions and all waveforms collected on the channel specified by the optional parameter or collected on the currently specified source channel MTESt SOURce if there...

Page 511: ...e 511 MTESt COUNt RESet see page 1196 Command Syntax MTESt COUNt RESet The MTESt COUNt RESet command resets the mask statistics See Also Introduction to MTESt Commands on page 501 MTESt COUNt WAVeform...

Page 512: ...Nt TIME The MTESt COUNt TIME query returns the elapsed time in the current mask test run Return Format time NL time elapsed seconds in NR3 format See Also Introduction to MTESt Commands on page 501 MT...

Page 513: ...The MTESt COUNt WAVeforms query returns the total number of waveforms acquired in the current mask test run Return Format count NL count number of waveforms in NR1 format See Also Introduction to MTES...

Page 514: ...ormat The MTESt DATA command loads a mask from binary block data Query Syntax MTESt DATA The MTESt DATA query returns a mask in binary block data format The format for the data transmission is the for...

Page 515: ...A Oscilloscopes SCPI Programmer s Guide 515 MTESt DELete see page 1196 Command Syntax MTESt DELete The MTESt DELete command clears the currently loaded mask See Also Introduction to MTESt Commands on...

Page 516: ...f on_off 1 ON 0 OFF The MTESt ENABle command enables or disables the mask test features ON Enables the mask test features OFF Disables the mask test features Query Syntax MTESt ENABle The MTESt ENABle...

Page 517: ...bles the mask lock feature ON Locks a mask to the SOURce As the vertical or horizontal scaling or position of the SOURce changes the mask is redrawn accordingly OFF The mask is static and does not mov...

Page 518: ...522 command TIME the mask test runs for a fixed amount of time The amount of time is set by the MTESt RMODe TIME on page 523 command WAVeforms the mask test runs until a fixed number of waveforms are...

Page 519: ...surement statistics run only on waveforms that contain a mask violation passing waveforms do not affect measurements and measurement statistics This mode is not available when the acquisition mode is...

Page 520: ...See Chapter 24 SAVE Commands starting on page 543 for more information on save options Query Syntax MTESt RMODe FACTion SAVE The MTESt RMODe FACTion SAVE query returns the current mask failure save s...

Page 521: ...ing on a mask failure on or off When this setting is ON and a mask violation is detected the mask test is stopped and the acquisition system is stopped Query Syntax MTESt RMODe FACTion STOP The MTESt...

Page 522: ...sigma is the best achievable process sigma assuming no failures Process sigma is calculated using the number of failures per test The test sigma level indirectly specifies the number of waveforms that...

Page 523: ...in NR3 format When the MTESt RMODe command is set to TIME the MTESt RMODe TIME command sets the number of seconds for a mask test to run Query Syntax MTESt RMODe TIME The MTESt RMODe TIME query retur...

Page 524: ...0 When the MTESt RMODe command is set to WAVeforms the MTESt RMODe WAVeforms command sets the number of waveform acquisitions that are mask tested Query Syntax MTESt RMODe WAVeforms The MTESt RMODe WA...

Page 525: ...he 0 Level controls track each other Adjusting either the 1 Level or the 0 Level control shifts the position of the mask up or down without changing its size OFF If the Bind 1 0 Levels control is disa...

Page 526: ...n X value of 0 100 is a vertex at 110 ms The oscilloscope uses this equation to normalize vertices This simplifies reprogramming to handle different data rates For example if you halve the period of t...

Page 527: ...is best if you define XDELta as a pulse width or bit period Then a change in data rate without corresponding changes in the waveform can easily be handled by changing X The X coordinate of polygon ve...

Page 528: ...oundaries set by SCALe Y1 and SCALe Y2 according to the equation Y Y Y2 Y1 Y1 Thus if you set Y1 to 100 mV and Y2 to 1 V a Y value of 0 100 in a vertex is at 190 mV The Y1 value is a voltage value spe...

Page 529: ...s defined by SCALe Y1 and SCALe Y2 according to the following equation Y Y Y2 Y1 Y1 Thus if you set Y1 to 100 mV and Y2 to 1 V a Y value of 0 100 in a vertex is at 190 mV The Y2 value is a voltage val...

Page 530: ...ce command selects the channel which is configured by the commands contained in a mask file when it is loaded Query Syntax MTESt SOURce The MTESt SOURce query returns the channel which is configured b...

Page 531: ...tax MTESt TITLe The MTESt TITLe query returns the mask title which is a string of up to 128 characters The title is displayed in the mask test dialog box and mask test tab when a mask file is loaded R...

Page 532: ...532 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 22 MTESt Commands...

Page 533: ...ber starts from 1 internal_loc 0 3 an integer in NR1 format file_name quoted ASCII string wavegen_id WGEN1 RECall DBC STARt file_name serialbus see page 536 n a file_name quoted ASCII string If extens...

Page 534: ...STARt file_spec see page 539 n a file_spec internal_loc file_name internal_loc 0 3 an integer in NR1 format file_name quoted ASCII string RECall PWD path_name see page 540 RECall PWD see page 540 path...

Page 535: ...is entered and it is a 2 column file the 2nd column assumed to be voltage is automatically be selected If the column parameter is entered and that column does not exist in the file the operation fail...

Page 536: ...fies which serial decode waveform the CAN symbolic data will be loaded for See Also Introduction to RECall Commands on page 534 RECall FILename on page 537 SBUS n CAN TRIGger on page 614 SBUS n CAN TR...

Page 537: ...command specifies the source for any RECall operations Query Syntax RECall FILename The RECall FILename query returns the current RECall filename Return Format base_name NL base_name quoted ASCII stri...

Page 538: ...ies which serial decode waveform the LIN symbolic data will be loaded for See Also Introduction to RECall Commands on page 534 RECall FILename on page 537 SBUS n LIN TRIGger on page 663 SBUS n LIN TRI...

Page 539: ...nal_loc file_name internal_loc 0 3 an integer in NR1 format file_name quoted ASCII string The RECall MASK STARt command recalls a mask See Also Introduction to RECall Commands on page 534 RECall FILen...

Page 540: ..._name quoted ASCII string The RECall PWD command sets the present working directory for recall operations Query Syntax RECall PWD The RECall PWD query returns the currently set working directory for r...

Page 541: ...nternal_loc file_name internal_loc 0 9 an integer in NR1 format file_name quoted ASCII string The RECall SETup STARt command recalls an oscilloscope setup See Also Introduction to RECall Commands on p...

Page 542: ...m The data option lets you recall a reference waveform from a local file on the controller PC instead of from a USB storage device connected to the oscilloscope In this case your remote program reads...

Page 543: ...t file_name quoted ASCII string wavegen_id WGEN1 SAVE FILename base_name see page 548 SAVE FILename see page 548 base_name quoted ASCII string SAVE IMAGe STARt file_name see page 549 n a file_name quo...

Page 544: ...I string SAVE RESults STARt file_spec see page 558 n a file_name quoted ASCII string SAVE RESults FORMat CURSor 0 OFF 1 ON see page 559 SAVE RESults FORMat CURSor see page 559 0 1 SAVE RESults FORMat...

Page 545: ...format SAVE WAVeform LENGth MAX 0 OFF 1 ON see page 568 SAVE WAVeform LENGth MAX see page 568 0 1 SAVE WAVeform SEGMen ted option see page 569 SAVE WAVeform SEGMen ted see page 569 option ALL CURRent...

Page 546: ...images and data SAV is an acceptable short form for SAVE Reporting the Setup Use SAVE to query setup information for the SAVE subsystem Return Format The following is a sample response from the SAVE q...

Page 547: ...II string wavegen_id WGEN1 The SAVE ARBitrary STARt command saves the current arbitrary waveform to an internal location or a file on a USB storage device The wavegen_id parameter specifies which wave...

Page 548: ...operations Query Syntax SAVE FILename The SAVE FILename query returns the current SAVE filename Return Format base_name NL base_name quoted ASCII string See Also Introduction to SAVE Commands on page...

Page 549: ...ver on page 552 SAVE IMAGe PALette on page 553 SAVE FILename on page 548 NOTE Be sure to set the SAVE IMAGe FORMat before saving an image If the format is NONE the save image command will not succeed...

Page 550: ...he image Query Syntax SAVE IMAGe FACTors The SAVE IMAGe FACTors query returns a flag indicating whether oscilloscope factors are output along with the image Return Format factors NL factors 0 1 See Al...

Page 551: ...Query Syntax SAVE IMAGe FORMat The SAVE IMAGe FORMat query returns the selected image format type Return Format format NL format BMP BMP8 PNG NONE When NONE is returned it indicates that a waveform da...

Page 552: ...and 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 Retu...

Page 553: ...e The SAVE IMAGe PALette command sets the image palette color Query Syntax SAVE IMAGe PALette The SAVE IMAGe PALette query returns the selected image palette color Return Format palette NL palette COL...

Page 554: ...LISTer STARt file_name file_name quoted ASCII string The SAVE LISTer STARt command saves the Lister display data to a file See Also Introduction to SAVE Commands on page 546 SAVE FILename on page 548...

Page 555: ...rnal_loc file_name internal_loc 0 3 an integer in NR1 format file_name quoted ASCII string The SAVE MASK STARt command saves a mask See Also Introduction to SAVE Commands on page 546 SAVE FILename on...

Page 556: ...quoted ASCII string The SAVE MULTi STARt command saves multi channel waveform data to a file This file can be opened by the N8900A Infiniium Offline oscilloscope analysis software See Also Introducti...

Page 557: ...ed ASCII string The SAVE PWD command sets the present working directory for save operations Query Syntax SAVE PWD The SAVE PWD query returns the currently set working directory for save operations Ret...

Page 558: ...es csv file on a USB storage device Use the SAVE RESults FORMat commands to specify the analysis types whose results are saved to the file When multiple types of analysis results are selected they are...

Page 559: ...ORMat commands specify whether other types of analysis results are also saved When multiple types of analysis results are saved they are all saved to the same file and separated by a blank line Query...

Page 560: ...Mat commands specify whether other types of analysis results are also saved When multiple types of analysis results are saved they are all saved to the same file and separated by a blank line Query Sy...

Page 561: ...lts FORMat commands specify whether other types of analysis results are also saved When multiple types of analysis results are saved they are all saved to the same file and separated by a blank line Q...

Page 562: ...ORMat commands specify whether other types of analysis results are also saved When multiple types of analysis results are saved they are all saved to the same file and separated by a blank line Query...

Page 563: ...s FORMat commands specify whether other types of analysis results are also saved When multiple types of analysis results are saved they are all saved to the same file and separated by a blank line Que...

Page 564: ...nternal_loc file_name internal_loc 0 9 an integer in NR1 format file_name quoted ASCII string The SAVE SETup STARt command saves an oscilloscope setup See Also Introduction to SAVE Commands on page 54...

Page 565: ...ge 546 SAVE WAVeform FORMat on page 566 SAVE WAVeform LENGth on page 567 SAVE FILename on page 548 RECall SETup STARt on page 541 NOTE Be sure to set the SAVE WAVeform FORMat before saving waveform da...

Page 566: ...ormation for all analog channels that are displayed turned on The proper file extension for this format is csv BINary creates an oscilloscope binary data format file See the User s Guide for a descrip...

Page 567: ...ata length that is the number of points saved When the SAVE WAVeform LENGth MAX setting is ON the SAVE WAVeform LENGth setting has no effect Query Syntax SAVE WAVeform LENGth The SAVE WAVeform LENGth...

Page 568: ...mmand specifies whether maximum number of waveform data points is saved When OFF the SAVE WAVeform LENGth command specifies the number of waveform data points saved Query Syntax SAVE WAVeform LENGth M...

Page 569: ...ecifies which segments are included when the waveform is saved ALL all acquired segments are saved CURRent only the currently selected segment is saved Query Syntax SAVE WAVeform SEGMented The SAVE WA...

Page 570: ...ommand selects the source to be saved as a reference waveform file Query Syntax SAVE WMEMory SOURce The SAVE WMEMory SOURce query returns the source to be saved as a reference waveform file Return For...

Page 571: ...STARt file_name file_name quoted ASCII string The SAVE WMEMory STARt command saves oscilloscope waveform data to a reference waveform file See Also Introduction to SAVE Commands on page 546 SAVE WMEM...

Page 572: ...572 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 24 SAVE Commands...

Page 573: ...ommands on page 752 SBUS n USBPd Commands on page 773 Introduction to SBUS n Commands The SBUS subsystem commands control the serial decode bus viewing mode and other options The following serial bus...

Page 574: ...he beginning of a message frame You can trigger on Sync Break Frame IDs or Frame IDs and Data UART RS 232 triggering lets you trigger on RS 232 serial data SENT triggering lets you trigger on SENT ser...

Page 575: ...al SBUS n Commands Table 97 General SBUS n Commands Summary Command Query Options and Query Returns SBUS n DISPlay 0 OFF 1 ON see page 576 SBUS n DISPlay see page 576 0 1 SBUS n MODE mode see page 577...

Page 576: ...The SBUS n DISPlay query returns the current display setting of the serial decode bus Return Format display NL display 0 1 Errors 241 Hardware missing on page 1137 See Also Introduction to SBUS n Com...

Page 577: ...rns the current serial bus decode mode setting Return Format mode NL mode A429 CAN IIC LIN M1553 MANC NRZ SENT UART USBP NONE Errors 241 Hardware missing on page 1137 See Also Introduction to SBUS n C...

Page 578: ...BUS n A429 BAUDrat e see page 582 baudrate integer from 10000 to 1000000 n a SBUS n A429 COUNt E RRor see page 583 error_count integer in NR1 format SBUS n A429 COUNt R ESet see page 584 n a n a n a S...

Page 579: ...see page 592 string nn where n 0 1 X length always 2 bits SBUS n A429 TRIGger PATTern SSM string see page 593 SBUS n A429 TRIGger PATTern SSM see page 593 string nn where n 0 1 X length always 2 bits...

Page 580: ...hreshold 3 0 V Noise Reject Off Probe Attenuation 10 0 Vertical Scale 4 V div Serial Decode On Base SBUS n A429 BASE HEX Word Format SBUS n A429 FORMat LDSDi Label SDI Data SSM Trigger the specified s...

Page 581: ...he decoded data The BASE command has no effect on the SDI and SSM fields which are always displayed in binary nor the Label field which is always displayed in octal Query Syntax SBUS n A429 BASE The S...

Page 582: ...rate is selected with the SBUS n A429 SPEed USER command the SBUS n A429 BAUDrate command specifies the user defined baud rate The baud rate can be set in 100 b s increments between 10000 and 100000...

Page 583: ...SBUS n A429 COUNt ERRor Returns the error count Return Format error_count NL error_count integer in NR1 format Errors 241 Hardware missing on page 1137 See Also SBUS n A429 COUNt RESet on page 584 SB...

Page 584: ...ee page 1196 Command Syntax SBUS n A429 COUNt RESet Resets the word and error counters Errors 241 Hardware missing on page 1137 See Also SBUS n A429 COUNt WORD on page 585 SBUS n A429 COUNt ERRor on p...

Page 585: ...x SBUS n A429 COUNt WORD Returns the word count Return Format word_count NL word_count integer in NR1 format Errors 241 Hardware missing on page 1137 See Also SBUS n A429 COUNt RESet on page 584 SBUS...

Page 586: ...Query Syntax SBUS n A429 FORMat The SBUS n A429 FORMat query returns the current ARINC 429 word decode format setting Return Format format NL format LDSD LDSS LDAT Errors 241 Hardware missing on page...

Page 587: ...ype A Line A non inverted B Line B inverted DIFFerential Differential A B Query Syntax SBUS n A429 SIGNal The SBUS n A429 SIGNal query returns the current ARINC 429 signal type setting Return Format s...

Page 588: ...The SBUS n A429 SOURce query returns the currently set source of the ARINC 429 signal Use the TRIGger LEVel HIGH and TRIGger LEVel LOW commands to set the threshold levels for the selected source Ret...

Page 589: ...ou specify a user defined baud rate using the SBUS n A429 BAUDrate command Query Syntax SBUS n A429 SPEed The SBUS n A429 SPEed query returns the current ARINC 429 signal speed setting Return Format s...

Page 590: ...0xnn where n 0 9 A F The SBUS n A429 TRIGger LABel command defines the ARINC 429 label value when labels are used in the selected trigger type To set the label value to don t cares 0xXX set the value...

Page 591: ...n each ARINC 429 word Query Syntax SBUS n A429 TRIGger PATTern DATA The SBUS n A429 TRIGger PATTern DATA query returns the current settings of the specified ARINC 429 data pattern resource in the bina...

Page 592: ...for in each ARINC 429 word The specified SDI is only used if the SBUS n A429 FORMat includes the SDI field Query Syntax SBUS n A429 TRIGger PATTern SDI The SBUS n A429 TRIGger PATTern SDI query return...

Page 593: ...for in each ARINC 429 word The specified SSM is only used if the SBUS n A429 FORMat includes the SSM field Query Syntax SBUS n A429 TRIGger PATTern SSM The SBUS n A429 TRIGger PATTern SSM query retur...

Page 594: ...e n 0 9 A F octal Qnnn where n 0 7 string 0xnn where n 0 9 A F The SBUS n A429 TRIGger RANGe command defines a range of ARINC 429 label values This range is used when the LRANge trigger type is select...

Page 595: ...coding error GERRor triggers on an inter word gap error WGERrors triggers on either a Word or Gap Error ALLerrors triggers on any of the above errors ABITs triggers on any bit which will therefore for...

Page 596: ...596 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 25 SBUS n Commands SBUS n A429 SOURce on page 588...

Page 597: ...ormat SBUS n CAN DISPlay type see page 606 SBUS n CAN DISPlay see page 606 type HEXadecimal SYMBolic SBUS n CAN FDSPoint value see page 607 SBUS n CAN FDSPoint see page 607 value even numbered percent...

Page 598: ...er PATTern DATA DLC dlc see page 619 SBUS n CAN TRIGger PATTern DATA DLC see page 619 dlc integer between 1 don t care and 64 in NR1 format SBUS n CAN TRIGger PATTern DATA LENGth length see page 620 S...

Page 599: ...c SIGNal name see page 625 SBUS n CAN TRIGger SYMBolic SIGNal see page 625 name quoted ASCII string SBUS n CAN TRIGger SYMBolic VALue data see page 626 SBUS n CAN TRIGger SYMBolic VALue see page 626 d...

Page 600: ...96 Query Syntax SBUS n CAN COUNt ERRor Returns the error frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 1137 See Also SBUS n CAN COUNt R...

Page 601: ...1196 Query Syntax SBUS n CAN COUNt OVERload Returns the overload frame count Return Format frame_count NL frame_count 0 in NR1 format Errors 241 Hardware missing on page 1137 See Also SBUS n CAN COUNt...

Page 602: ...CAN COUNt RESet Resets the frame counters Errors 241 Hardware missing on page 1137 See Also SBUS n CAN COUNt ERRor on page 600 SBUS n CAN COUNt OVERload on page 601 SBUS n CAN COUNt TOTal on page 604...

Page 603: ...BUS n CAN COUNt SPEC Returns the Spec error Ack Form Stuff CRC errors count Return Format spec_error_count NL spec_error_count integer in NR1 format Errors 241 Hardware missing on page 1137 See Also S...

Page 604: ...96 Query Syntax SBUS n CAN COUNt TOTal Returns the total frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 1137 See Also SBUS n CAN COUNt R...

Page 605: ...96 Query Syntax SBUS n CAN COUNt UTILization Returns the percent utilization Return Format percent NL percent floating point in NR3 format Errors 241 Hardware missing on page 1137 See Also SBUS n CAN...

Page 606: ...SBUS n CAN DISPlay command specifies when CAN symbolic data is loaded into the oscilloscope whether symbolic values from the DBC file or hexadecimal values are displayed in the decode waveform and the...

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

Page 608: ...N FDSTandard command lets you pick the standard that will be used when decoding or triggering on FD frames ISO or non ISO This setting has no effect on the processing of non FD classical frames Query...

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

Page 610: ...to the nearest baud rate divisible by 100 b s You can also set the baud rate of the CAN signal to 5 Mb s Fractional baud rates between 4 Mb s and 5 Mb s are not allowed If the baud rate you select do...

Page 611: ...low signals CANL the actual CAN_L differential bus signal RX the Receive signal from the CAN bus transceiver TX the Transmit signal to the CAN bus transceiver DIFL the CAN differential L H bus signal...

Page 612: ...er a baud rate that is not divisible by 100 b s the baud rate is set to the nearest baud rate divisible by 100 b s For CAN FD both the standard rate settings see SBUS n CAN SIGNal BAUDrate and the FD...

Page 613: ...to analog channels in NR1 format The SBUS n CAN SOURce command sets the source for the CAN signal Query Syntax SBUS n CAN SOURce The SBUS n CAN SOURce query returns the current source for the CAN sign...

Page 614: ...D Triggers on standard CAN data frames at the end of the 11 or 29 bit ID field DATA Data Frame ID and Data non FD Triggers on any standard CAN data frame at the end of the last data byte defined in th...

Page 615: ...addition for FD frames will also trigger if the Stuff Count is in error X SPECerror Spec Error Ack or Form or Stuff or CRC Triggers on Ack Form Stuff or CRC errors X ALLerrors All Errors Triggers on a...

Page 616: ...Gth on page 620 SBUS n CAN TRIGger PATTern ID on page 622 SBUS n CAN TRIGger PATTern ID MODE on page 623 SBUS n CAN TRIGger IDFilter on page 617 SBUS n CAN SIGNal DEFinition on page 611 SBUS n CAN SOU...

Page 617: ...IGger IDFilter 0 OFF 1 ON The SBUS n CAN TRIGger IDFilter command specifies in certain error and bit trigger modes whether triggers are filtered by CAN IDs Query Syntax SBUS n CAN TRIGger IDFilter The...

Page 618: ...t care characters otherwise it is a binary string made up of 0 1 and X don t care characters Query Syntax SBUS n CAN TRIGger PATTern DATA The SBUS n CAN TRIGger PATTern DATA query returns the current...

Page 619: ...CAN TRIGger PATTern DATA DLC command specifies the DLC value to be used in the CAN FD data trigger mode A specific valid FD value can be specified or 1 can be specified to indicate don t care Query S...

Page 620: ...e number of bytes in the string can be anywhere from 1 bytes to 8 bytes 64 bits The value for these bytes is set by the SBUS n CAN TRIGger PATTern DATA command Query Syntax SBUS n CAN TRIGger PATTern...

Page 621: ...osition for CAN FD data triggers CAN FD frames can have up to 64 bytes of data You can trigger on up to 8 bytes of data The starting byte position setting lets you trigger on data anywhere within the...

Page 622: ...up of hexadecimal and X don t care characters otherwise it is a binary string made up of 0 1 and X don t care characters Query Syntax SBUS n CAN TRIGger PATTern ID The SBUS n CAN TRIGger PATTern ID q...

Page 623: ...ects the extended 29 bit identifier The CAN identifier is set by the SBUS n CAN TRIGger PATTern ID command Query Syntax SBUS n CAN TRIGger PATTern ID MODE The SBUS n CAN TRIGger PATTern ID MODE query...

Page 624: ...ssage to trigger on when CAN symbolic data has been loaded recalled into the oscilloscope and the CAN trigger mode is set to MESSage or MSIGnal Query Syntax SBUS n CAN TRIGger SYMBolic MESSage The SBU...

Page 625: ...the signal to trigger on when CAN symbolic data has been loaded recalled into the oscilloscope and the CAN trigger mode is set to MSIGnal Query Syntax SBUS n CAN TRIGger SYMBolic SIGNal The SBUS n CAN...

Page 626: ...ed into the oscilloscope and the CAN trigger mode is set to MSIGnal Query Syntax SBUS n CAN TRIGger SYMBolic VALue The SBUS n CAN TRIGger SYMBolic VALue query returns the specified signal value Return...

Page 627: ...in NR1 format SBUS n CXPI TOLeran ce percent see page 632 SBUS n CXPI TOLeran ce see page 632 percent from 1 30 in NR1 format SBUS n CXPI TRIGger mode see page 633 SBUS n CXPI TRIGger see page 634 mod...

Page 628: ...RIGger PATTern INFO CT string see page 641 SBUS n CXPI TRIGger PATTern INFO CT see page 641 string nn where n 0 1 X SBUS n CXPI TRIGger PATTern INFO DLC dlc see page 642 SBUS n CXPI TRIGger PATTern IN...

Page 629: ...r device under test The CXPI baud rate can be set from 9600 b s to 40000 b s in 100 b s increments You must set the baud rate to match your device under test The default baud rate is 20 kb s Query Syn...

Page 630: ...ould be displayed in the identifier field When OFF the upper bit is masked The parity is still checked but it is not displayed unless a parity error occurs Query Syntax SBUS n CXPI PARity The SBUS n C...

Page 631: ...in NR1 format The SBUS n CXPI SOURce command selects the oscilloscope channel connected to the CXPI signal line Query Syntax SBUS n CXPI SOURce The SBUS n CXPI SOURce query returns the selected oscill...

Page 632: ...format The SBUS n CXPI TOLerance command specifies the tolerance as a percentage of the Tbit width Query Syntax SBUS n CXPI TOLerance The SBUS n CXPI TOLerance query returns the tolerance setting Retu...

Page 633: ...rs on CXPI frames at the end of the last data byte defined in the trigger In addition to the PID value you can specify the contents of the Frame Info byte with bitwise don t cares You can specify up t...

Page 634: ...hen a wakeup pulse is detected Query Syntax SBUS n CXPI TRIGger The SBUS n CXPI TRIGger query returns the CXPI trigger type setting Return Format mode NL mode SOF EOF PTYP ID DATA LDAT CRC PAR IBS IFS...

Page 635: ...s only for a specified ID Query Syntax SBUS n CXPI TRIGger IDFilter The SBUS n CXPI TRIGger IDFilter query returns the ID filter setting Return Format setting NL setting 0 1 See Also SBUS n CXPI TRIGg...

Page 636: ...Query Syntax SBUS n CXPI TRIGger PTYPe The SBUS n CXPI TRIGger PTYPe query returns the PTYPE trigger setting Return Format setting NL setting 0 1 See Also SBUS n CXPI TRIGger on page 633 SBUS n CXPI T...

Page 637: ...mum number of data bytes you can include in the trigger specification is still only 12 bytes In this case you can use the SBUS n CXPI TRIGger PATTern DATA STARt command to specify the starting byte lo...

Page 638: ...mand The SBUS n CXPI TRIGger PATTern DATA command lets you specify the data value to trigger on Query Syntax SBUS n CXPI TRIGger PATTern DATA LENGth The SBUS n CXPI TRIGger PATTern DATA LENGth query r...

Page 639: ...E is present or 124 bytes when PTYPE is not present The SBUS n CXPI TRIGger PATTern DATA LENGth command lets you specify the length of the data value to trigger on The SBUS n CXPI TRIGger PATTern DATA...

Page 640: ...x SBUS n CXPI TRIGger PATTern ID The SBUS n CXPI TRIGger PATTern ID query returns the specified frame ID value Returned frame ID values are always quoted binary format strings Return Format string NL...

Page 641: ...gger on This is a two bit binary value Query Syntax SBUS n CXPI TRIGger PATTern INFO CT The SBUS n CXPI TRIGger PATTern INFO CT query returns the specified CT bits included in the trigger Return Forma...

Page 642: ...a bytes you can specify in the trigger Query Syntax SBUS n CXPI TRIGger PATTern INFO DLC The SBUS n CXPI TRIGger PATTern INFO DLC query returns the DLC trigger value setting Return Format dlc NL dlc i...

Page 643: ...gger on This is a two bit binary value Query Syntax SBUS n CXPI TRIGger PATTern INFO NM The SBUS n CXPI TRIGger PATTern INFO NM query returns the specified NM bits included in the trigger Return Forma...

Page 644: ...n n 1 to analog channels in NR1 format SBUS n IIC TRIGger PATTern ADDRess value see page 648 SBUS n IIC TRIGger PATTern ADDRess see page 648 value integer or string string 0xnn n 0 9 A F SBUS n IIC T...

Page 645: ...mmand determines whether the Read Write bit is included as the LSB in the display of the IIC address field of the decode bus Query Syntax SBUS n IIC ASIZe The SBUS n IIC ASIZe query returns the curren...

Page 646: ...urce CHANnel n n 1 to analog channels in NR1 format The SBUS n IIC SOURce CLOCk command sets the source for the IIC serial clock SCL Query Syntax SBUS n IIC SOURce CLOCk The SBUS n IIC SOURce CLOCk qu...

Page 647: ...rce source CHANnel n n 1 to analog channels in NR1 format The SBUS n IIC SOURce DATA command sets the source for IIC serial data SDA Query Syntax SBUS n IIC SOURce DATA The SBUS n IIC SOURce DATA quer...

Page 648: ...r IIC data The address can range from 0x00 to 0x7F 7 bit or 0x3FF 10 bit hexadecimal Use the don t care address 1 or 0xFFFFFFFF to ignore the address value Query Syntax SBUS n IIC TRIGger PATTern ADDR...

Page 649: ...d sets IIC data The data value can range from 0x00 to 0x0FF hexadecimal Use the don t care data pattern 1 or 0xFFFFFFFF to ignore the data value Query Syntax SBUS n IIC TRIGger PATTern DATA The SBUS n...

Page 650: ...sets IIC data 2 The data value can range from 0x00 to 0x0FF hexadecimal Use the don t care data pattern 1 or 0xFFFFFFFF to ignore the data value Query Syntax SBUS n IIC TRIGger PATTern DATa2 The SBUS...

Page 651: ...SBUS n IIC TRIGger QUALifier command sets the IIC data qualifier when TRIGger IIC TRIGger TYPE is set to READEprom Query Syntax SBUS n IIC TRIGger QUALifier The SBUS n IIC TRIGger QUALifier query ret...

Page 652: ...ning Start Address7 Read Ack Data The value READ is also accepted for READ7 WRITe7 7 bit address frame containing Start Address7 Write Ack Data The value WRITe is also accepted for WRITe7 R7Data2 7 bi...

Page 653: ...r s Guide 653 TRIGger MODE on page 914 SBUS n IIC TRIGger PATTern ADDRess on page 648 SBUS n IIC TRIGger PATTern DATA on page 649 SBUS n IIC TRIGger PATTern DATa2 on page 650 SBUS n IIC TRIGger QUALif...

Page 654: ...page 659 SBUS n LIN SIGNal B AUDrate see page 659 baudrate integer from 2400 to 625000 in 100 b s increments SBUS n LIN SOURce source see page 660 SBUS n LIN SOURce see page 660 source CHANnel n n 1 t...

Page 655: ...see page 668 length integer from 1 to 8 in NR1 format SBUS n LIN TRIGger PATTern FORMat base see page 669 SBUS n LIN TRIGger PATTern FORMat see page 669 base BINary HEX DECimal SBUS n LIN TRIGger SYMB...

Page 656: ...SBUS n LIN DISPlay command specifies when LIN symbolic data is loaded into the oscilloscope whether symbolic values from the LDF file or hexadecimal values are displayed in the decode waveform and the...

Page 657: ...er the parity bits are included as the most significant bits MSB in the display of the Frame Id field in the LIN decode bus Query Syntax SBUS n LIN PARity The SBUS n LIN PARity query returns the curre...

Page 658: ...determine whether the bit is dominant or recessive The sample point represents the percentage of time between the beginning of the bit time to the end of the bit time Query Syntax SBUS n LIN SAMPlepo...

Page 659: ...5 kb s in 100 b s increments If you enter a baud rate that is not divisible by 100 b s the baud rate is set to the nearest baud rate divisible by 100 b s Query Syntax SBUS n LIN SIGNal BAUDrate The SB...

Page 660: ...o analog channels in NR1 format The SBUS n LIN SOURce command sets the source for the LIN signal Query Syntax SBUS n LIN SOURce The SBUS n LIN SOURce query returns the current source for the LIN signa...

Page 661: ...y not be used to indicate the number of bytes In LIN 2 X there is no length control LIN20 LIN 2 X For LIN 1 2 signals use the LIN 1 3 setting The LIN 1 3 setting assumes the signal follows the Table o...

Page 662: ...al to 11 12 or 13 clock lengths The sync break is the idle period in the bus activity at the beginning of each packet that distinguishes one information packet from the previous one Query Syntax SBUS...

Page 663: ...ata string length and value PARityerror parity errors CSUMerror checksum errors FRAMe Triggers on a symbolic frame FSIGnal Triggers on a symbolic frame and a signal value Query Syntax SBUS n LIN TRIGg...

Page 664: ...664 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 25 SBUS n Commands SBUS n LIN TRIGger SYMBolic VALue on page 672...

Page 665: ...TRIGger ID command defines the LIN identifier searched for in each CAN message when the LIN trigger mode is set to frame ID Setting the ID to a value of 1 results in 0xXX which is equivalent to all I...

Page 666: ...s used When base DECimal the X and characters cannot be entered When queried the character is returned when any bits in the pattern have the value of X and base DECimal When any bits in a given nibble...

Page 667: ...1 42 43A Oscilloscopes SCPI Programmer s Guide 667 See Also Introduction to TRIGger Commands on page 901 SBUS n LIN TRIGger PATTern FORMat on page 669 SBUS n LIN TRIGger on page 663 SBUS n LIN TRIGger...

Page 668: ...e number of bytes in the string can be anywhere from 1 bytes to 8 bytes 64 bits The value for these bytes is set by the SBUS n LIN TRIGger PATTern DATA command Query Syntax SBUS n LIN TRIGger PATTern...

Page 669: ...sets the entry and query number base used by the SBUS n LIN TRIGger PATTern DATA command The default base is BINary Query Syntax SBUS n LIN TRIGger PATTern FORMat The SBUS n LIN TRIGger PATTern FORMa...

Page 670: ...ssage to trigger on when LIN symbolic data has been loaded recalled into the oscilloscope and the LIN trigger mode is set to FRAMe or FSIGnal Query Syntax SBUS n LIN TRIGger SYMBolic FRAMe The SBUS n...

Page 671: ...the signal to trigger on when LIN symbolic data has been loaded recalled into the oscilloscope and the LIN trigger mode is set to FSIGnal Query Syntax SBUS n LIN TRIGger SYMBolic SIGNal The SBUS n LI...

Page 672: ...led into the oscilloscope and the LIN trigger mode is set to FSIGnal Query Syntax SBUS n LIN TRIGger SYMBolic VALue The SBUS n LIN TRIGger SYMBolic VALue query returns the specified signal value Retur...

Page 673: ...e BINary HEX SBUS n M1553 SOURce source see page 676 SBUS n M1553 SOURce see page 676 source CHANnel n n 1 to analog channels in NR1 format SBUS n M1553 TRIGge r PATTern DATA string see page 677 SBUS...

Page 674: ...ally sets these options for decoding and triggering on MIL STD 1553 signals High Low Trigger Thresholds to a voltage value equal to 1 3 division based on the source channel s current V div setting Noi...

Page 675: ...The SBUS n M1553 BASE command determines the base to use for the MIL STD 1553 decode display Query Syntax SBUS n M1553 BASE The SBUS n M1553 BASE query returns the current MIL STD 1553 display decode...

Page 676: ...STD 1553 signal Use the TRIGger LEVel HIGH and TRIGger LEVel LOW commands to set the threshold levels for the selected source Query Syntax SBUS n M1553 TRIGger SOURce The SBUS n M1553 SOURce query ret...

Page 677: ...DATA command sets the 11 bits to trigger on if the trigger type has been set to RTA11 RTA 11 Bits using the SBUS n M1553 TRIGger TYPE command Query Syntax SBUS n M1553 TRIGger PATTern DATA The SBUS n...

Page 678: ...0 9 A F The SBUS n M1553 TRIGger RTA command sets the Remote Terminal Address RTA to trigger on when the trigger type has been set to RTA or RTA11 using the SBUS n M1553 TRIGger TYPE command To set t...

Page 679: ...s triggers if the RTA of the Command Status word matches the specified value The value is specified in hex RTA11 RTA 11 Bits triggers if the RTA and the remaining 11 bits match the specified criteria...

Page 680: ...Play format see page 685 SBUS n MANChester D ISPlay see page 685 format BIT WORD SBUS n MANChester D SIZe AUTO words see page 686 SBUS n MANChester D SIZe see page 686 words from 1 255 in NR1 format S...

Page 681: ...NChester T RIGger PATTern VALue DATA see page 695 string nn n where n 0 1 X string 0xnn n where n 0 9 A F X SBUS n MANChester T RIGger PATTern VALue WIDTh width see page 696 SBUS n MANChester T RIGger...

Page 682: ...fies the base for the Manchester bus decode and Lister display HEX hexadecimal DECimal unsigned decimal ASCii When the display format is BIT the only legal decode base value is BINary Query Syntax SBU...

Page 683: ...ate baudrate integer from 500 to 5000000 in 100 b s increments The SBUS n MANChester BAUDrate command specifies the baud rate of the Manchester signal Query Syntax SBUS n MANChester BAUDrate The SBUS...

Page 684: ...nd specifies the order of transmission on the Manchester bus MSBFirst specifies the most significant bit is transmitted first LSBFirst specifies the least significant bit is transmitted first Query Sy...

Page 685: ...DISPlay command specifies the format of the Manchester bus display Query Syntax SBUS n MANChester DISPlay The SBUS n MANChester DISPlay query returns the bus display format setting Return Format forma...

Page 686: ...r protocol definition AUTO is available as a selection only when the trailer field size is 0 see SBUS n MANChester TSIZe Query Syntax SBUS n MANChester DSIZe The SBUS n MANChester DSIZe query returns...

Page 687: ...the SBUS n MANChester HSIZe command specifies the number of bits in the header field of your Manchester protocol definition Query Syntax SBUS n MANChester HSIZe The SBUS n MANChester HSIZe query retu...

Page 688: ...The SBUS n MANChester IDLE BITS command specifies the minimum idle time or inter frame gap time in terms of the number of bits Query Syntax SBUS n MANChester IDLE BITS The SBUS n MANChester IDLE BITS...

Page 689: ...es that a falling edge is used to encode a bit value of logic 1 and a rising edge encodes a bit value of logic 0 RISing specifies that a rising edge is used to encode a bit value of logic 1 Query Synt...

Page 690: ...to analog channels in NR1 format The SBUS n MANChester SOURce command selects the oscilloscope channel connected to the Manchester signal line Query Syntax SBUS n MANChester SOURce The SBUS n MANChest...

Page 691: ...ANChester SSIZe command specifies the number of sync bits for the Manchester signal Query Syntax SBUS n MANChester SSIZe The SBUS n MANChester SSIZe query returns the number of sync bits setting Retur...

Page 692: ...format The SBUS n MANChester STARt command specifies the starting edge of the Manchester signal Query Syntax SBUS n MANChester STARt The SBUS n MANChester STARt query returns the starting edge number...

Page 693: ...NR1 format The SBUS n MANChester TOLerance command specifies the tolerance for the Manchester signal in terms of the percentage of the bit period Query Syntax SBUS n MANChester TOLerance The SBUS n M...

Page 694: ...er mode SOF Start Of Frame triggers at the start of a Manchester frame after the starting edge VALue triggers on the specified bit values MERRor triggers on a Manchester error Query Syntax SBUS n MANC...

Page 695: ...the trigger value bit order is always for bits as they arrive that is MSB first regardless of the serial decode bit order setting in SBUS n MANChester BITorder The bit width length of the value is set...

Page 696: ...ester TRIGger PATTern VALue WIDTh command specifies the bit width length of the value to trigger on The actual value to trigger on is set with the SBUS n MANChester TRIGger PATTern VALue DATA command...

Page 697: ...hester TSIZe command specifies the number of bits in the trailer field of your Manchester protocol definition Query Syntax SBUS n MANChester TSIZe The SBUS n MANChester TSIZe query returns the number...

Page 698: ...lay the SBUS n MANChester WSIZe command the number of bits per word in the data field of your Manchester protocol definition Query Syntax SBUS n MANChester WSIZe The SBUS n MANChester WSIZe query retu...

Page 699: ...at BIT WORD SBUS n NRZ DSIZe words see page 705 SBUS n NRZ DSIZe see page 705 words from 1 255 in NR1 format SBUS n NRZ FSIZe bits see page 706 SBUS n NRZ FSIZe see page 706 bits from 2 255 in NR1 for...

Page 700: ...0 9 A F X SBUS n NRZ TRIGger PATTern VALue WIDTh width see page 715 SBUS n NRZ TRIGger PATTern VALue WIDTh see page 715 width integer from 4 to 128 in NR1 format SBUS n NRZ TSIZe bits see page 716 SB...

Page 701: ...and specifies the base for the NRZ bus decode and Lister display HEX hexadecimal DECimal unsigned decimal ASCii When the display format is BIT the only legal decode base value is BINary Query Syntax S...

Page 702: ...ntax SBUS n NRZ BAUDrate baudrate baudrate integer from 5000 to 5000000 in 100 b s increments The SBUS n NRZ BAUDrate command specifies the baud rate of the NRZ signal Query Syntax SBUS n NRZ BAUDrate...

Page 703: ...der command specifies the order of transmission on the NRZ bus MSBFirst specifies the most significant bit is transmitted first LSBFirst specifies the least significant bit is transmitted first Query...

Page 704: ...RZ DISPlay command specifies the format of the NRZ bus display Query Syntax SBUS n NRZ DISPlay The SBUS n NRZ DISPlay query returns the bus display format setting Return Format format NL format BIT WO...

Page 705: ...your NRZ protocol definition AUTO is available as a selection only when the trailer field size is 0 see SBUS n NRZ TSIZe Query Syntax SBUS n NRZ DSIZe The SBUS n NRZ DSIZe query returns the number of...

Page 706: ...pecify the total frame size of the NRZ signal from 2 to 255 bits This would be equivalent to the sum of the number of bits in the header data and trailer fields in WORD format Query Syntax SBUS n NRZ...

Page 707: ...ISPlay the SBUS n NRZ HSIZe command specifies the number of bits in the header field of your NRZ protocol definition Query Syntax SBUS n NRZ HSIZe The SBUS n NRZ HSIZe query returns the number of head...

Page 708: ...s in NR3 format The SBUS n NRZ IDLE BITS command specifies the minimum idle time or inter frame gap time in terms of the number of bits Query Syntax SBUS n NRZ IDLE BITS The SBUS n NRZ IDLE BITS query...

Page 709: ...e state LOW HIGH The SBUS n NRZ IDLE STATe command specifies the idle state of the NRZ signal Query Syntax SBUS n NRZ IDLE STATe The SBUS n NRZ IDLE STATe query returns the idle state setting Return F...

Page 710: ...t a positive voltage is used to encode a bit value of logic 1 and a negative voltage encodes a bit value of logic 0 LOW specifies that a negative voltage is used to encode a bit value of logic 1 Query...

Page 711: ...URce source source CHANnel n n 1 to analog channels in NR1 format The SBUS n NRZ SOURce command selects the oscilloscope channel connected to the NRZ signal Query Syntax SBUS n NRZ SOURce The SBUS n N...

Page 712: ...SBUS n NRZ STARt command specifies the number of start bits for the NRZ signal Query Syntax SBUS n NRZ STARt The SBUS n NRZ STARt query returns the number of start bits setting Return Format bits NL...

Page 713: ...DATA up to 128 bits after the specified number of starting bits Note that the trigger value is always for bits as they arrive that is MSB first When the decode bit order see SBUS n NRZ BITorder is MSB...

Page 714: ...Note that the trigger value bit order is always for bits as they arrive that is MSB first regardless of the serial decode bit order setting in SBUS n NRZ BITorder The bit width length of the value is...

Page 715: ...he SBUS n NRZ TRIGger PATTern VALue WIDTh command specifies the bit width length of the value to trigger on The actual value to trigger on is set with the SBUS n NRZ TRIGger PATTern VALue DATA command...

Page 716: ...n NRZ TSIZe command specifies the number of bits in the trailer field of your NRZ protocol definition Query Syntax SBUS n NRZ TSIZe The SBUS n NRZ TSIZe query returns the number of trailer field bits...

Page 717: ...SPlay the SBUS n NRZ WSIZe command specifies the number of bits per word in the data field of your NRZ protocol definition Query Syntax SBUS n NRZ WSIZe The SBUS n NRZ WSIZe query returns the number o...

Page 718: ...724 decode NIBBles FSIGnal FSSerial FESerial SSERial ESERial SBUS n SENT IDLE state see page 726 SBUS n SENT IDLE see page 726 state LOW HIGH SBUS n SENT LENGth _nibbles see page 727 SBUS n SENT LENGt...

Page 719: ...ror TOLerror PPERror SSPerror SBUS n SENT TRIGger FAST DATA string see page 745 SBUS n SENT TRIGger FAST DATA see page 745 string nnnn where n 0 1 X string 0xn where n 0 9 A F X SBUS n SENT TRIGger SL...

Page 720: ...ENT CRC on page 721 SBUS n SENT DISPlay on page 722 SBUS n SENT FORMat on page 724 SBUS n SENT IDLE on page 726 SBUS n SENT LENGth on page 727 SBUS n SENT PPULse on page 728 SBUS n SENT SIGNal s DISPl...

Page 721: ...t LEG REC See Also SBUS n SENT CLOCk on page 720 SBUS n SENT DISPlay on page 722 SBUS n SENT FORMat on page 724 SBUS n SENT IDLE on page 726 SBUS n SENT LENGth on page 727 SBUS n SENT PPULse on page 7...

Page 722: ...SignalValueAsUnsignedInteger Offset When SYMBolic is selected the CRC and Slow Channel information is displayed in hex Query Syntax SBUS n SENT DISPlay The SBUS n SENT DISPlay query returns the SENT...

Page 723: ...ht P9241 42 43A Oscilloscopes SCPI Programmer s Guide 723 SBUS n SENT TRIGger SLOW DATA on page 746 SBUS n SENT TRIGger SLOW ID on page 748 SBUS n SENT TRIGger SLOW ILENgth on page 750 SBUS n SENT TRI...

Page 724: ...ering The decode is affected both in how the system interprets the data and what will be displayed The trigger is affected in that the trigger hardware needs to be configured to trigger on serial mess...

Page 725: ...MULTiplier on page 733 SBUS n SENT SIGNal s OFFSet on page 735 SBUS n SENT SIGNal s ORDer on page 737 SBUS n SENT SIGNal s STARt on page 739 SBUS n SENT SOURce on page 741 SBUS n SENT TOLerance on pag...

Page 726: ...page 722 SBUS n SENT FORMat on page 724 SBUS n SENT LENGth on page 727 SBUS n SENT PPULse on page 728 SBUS n SENT SIGNal s DISPlay on page 730 SBUS n SENT SIGNal s LENGth on page 731 SBUS n SENT SIGNa...

Page 727: ...T CRC on page 721 SBUS n SENT DISPlay on page 722 SBUS n SENT FORMat on page 724 SBUS n SENT IDLE on page 726 SBUS n SENT PPULse on page 728 SBUS n SENT SIGNal s DISPlay on page 730 SBUS n SENT SIGNal...

Page 728: ...time is shown between messages SPC Short PWM Code In SENT SPC there are no pause pulses Instead the message event is triggered by the master when it wants to receive data SENT SPC ends the transmissi...

Page 729: ...729 SBUS n SENT TOLerance on page 742 SBUS n SENT TRIGger on page 743 SBUS n SENT TRIGger FAST DATA on page 745 SBUS n SENT TRIGger SLOW DATA on page 746 SBUS n SENT TRIGger SLOW ID on page 748 SBUS n...

Page 730: ...n SENT CRC on page 721 SBUS n SENT DISPlay on page 722 SBUS n SENT FORMat on page 724 SBUS n SENT IDLE on page 726 SBUS n SENT LENGth on page 727 SBUS n SENT PPULse on page 728 SBUS n SENT SIGNal s LE...

Page 731: ...inition examples Query Syntax SBUS n SENT SIGNal s LENGth The SBUS n SENT SIGNal s LENGth query returns the signal bit length setting Return Format length NL length from 1 24 in NR1 format See Also SB...

Page 732: ...SIGNal s STARt on page 739 SBUS n SENT SOURce on page 741 SBUS n SENT TOLerance on page 742 SBUS n SENT TRIGger on page 743 SBUS n SENT TRIGger FAST DATA on page 745 SBUS n SENT TRIGger SLOW DATA on p...

Page 733: ...returns the multiplier value for the Fast Channel Signal Return Format multiplier NL multiplier from 1 24 in NR3 format See Also SBUS n SENT CLOCk on page 720 SBUS n SENT CRC on page 721 SBUS n SENT D...

Page 734: ...734 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 25 SBUS n Commands SBUS n SENT TRIGger TOLerance on page 751...

Page 735: ...e for the Fast Channel Signal Return Format offset NL offset from 1 24 in NR3 format See Also SBUS n SENT CLOCk on page 720 SBUS n SENT CRC on page 721 SBUS n SENT DISPlay on page 722 SBUS n SENT FORM...

Page 736: ...736 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 25 SBUS n Commands SBUS n SENT TRIGger TOLerance on page 751...

Page 737: ...st Significant Nibble first Fast Signal definition examples Query Syntax SBUS n SENT SIGNal s ORDer The SBUS n SENT SIGNal s ORDer query returns the nibble order setting Return Format order NL order M...

Page 738: ...SIGNal s STARt on page 739 SBUS n SENT SOURce on page 741 SBUS n SENT TOLerance on page 742 SBUS n SENT TRIGger on page 743 SBUS n SENT TRIGger FAST DATA on page 745 SBUS n SENT TRIGger SLOW DATA on p...

Page 739: ...inition examples Query Syntax SBUS n SENT SIGNal s STARt The SBUS n SENT SIGNal s STARt query returns the Fast Signal starting bit setting Return Format position NL position from 0 23 in NR1 format Se...

Page 740: ...SIGNal s ORDer on page 737 SBUS n SENT SOURce on page 741 SBUS n SENT TOLerance on page 742 SBUS n SENT TRIGger on page 743 SBUS n SENT TRIGger FAST DATA on page 745 SBUS n SENT TRIGger SLOW DATA on p...

Page 741: ...CRC on page 721 SBUS n SENT DISPlay on page 722 SBUS n SENT FORMat on page 724 SBUS n SENT IDLE on page 726 SBUS n SENT LENGth on page 727 SBUS n SENT PPULse on page 728 SBUS n SENT SIGNal s DISPlay...

Page 742: ...k on page 720 SBUS n SENT CRC on page 721 SBUS n SENT DISPlay on page 722 SBUS n SENT FORMat on page 724 SBUS n SENT IDLE on page 726 SBUS n SENT LENGth on page 727 SBUS n SENT PPULse on page 728 SBUS...

Page 743: ...sage ID and Data field both match the values entered using additional softkeys TOLerror triggers when the sync pulse width varies from the nominal value by greater than the entered percentage FCCerror...

Page 744: ...page 731 SBUS n SENT SIGNal s MULTiplier on page 733 SBUS n SENT SIGNal s OFFSet on page 735 SBUS n SENT SIGNal s ORDer on page 737 SBUS n SENT SIGNal s STARt on page 739 SBUS n SENT SOURce on page 74...

Page 745: ...string 0xn where n 0 9 A F X See Also SBUS n SENT CLOCk on page 720 SBUS n SENT CRC on page 721 SBUS n SENT DISPlay on page 722 SBUS n SENT FORMat on page 724 SBUS n SENT IDLE on page 726 SBUS n SENT...

Page 746: ...turn Format data NL data when ILENgth SHORt from 1 don t care to 65535 in NR1 f ormat data when ILENgth LONG from 1 don t care to 4095 in NR1 for mat See Also SBUS n SENT CLOCk on page 720 SBUS n SENT...

Page 747: ...SBUS n Commands 25 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 747 SBUS n SENT TRIGger SLOW ILENgth on page 750 SBUS n SENT TRIGger TOLerance on page 751...

Page 748: ...query returns the slow channel ID setting Return Format id NL id when ILENgth SHORt from 1 don t care to 15 in NR1 format id when ILENgth LONG from 1 don t care to 255 in NR1 format See Also SBUS n SE...

Page 749: ...n Commands 25 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 749 SBUS n SENT TRIGger SLOW DATA on page 746 SBUS n SENT TRIGger SLOW ILENgth on page 750 SBUS n SENT TRIGger TOLerance on pa...

Page 750: ...length NL length SHOR LONG See Also SBUS n SENT CLOCk on page 720 SBUS n SENT CRC on page 721 SBUS n SENT DISPlay on page 722 SBUS n SENT FORMat on page 724 SBUS n SENT IDLE on page 726 SBUS n SENT L...

Page 751: ...ce variation percent setting Return Format percent NL percent from 1 28 in NR1 format See Also SBUS n SENT CLOCk on page 720 SBUS n SENT CRC on page 721 SBUS n SENT DISPlay on page 722 SBUS n SENT FOR...

Page 752: ...SBUS n UART BITorde r see page 756 bitorder LSBFirst MSBFirst n a SBUS n UART COUNt E RRor see page 757 frame_count integer in NR1 format SBUS n UART COUNt R ESet see page 758 n a n a n a SBUS n UART...

Page 753: ...integer from 0 255 0x00 0xff in decimal hexadecimal binary or quoted_string format hexadecimal Hnn where n 0 9 A F for hexadecimal binary Bnn n where n 0 1 for binary quoted_string any of the 128 vali...

Page 754: ...SBUS n UART BASE command determines the base to use for the UART decode and Lister display Query Syntax SBUS n UART BASE The SBUS n UART BASE query returns the current UART decode and Lister base set...

Page 755: ...in UART mode The baud rate can be set in the range from from 100 b s to 8 Mb s or to the specific values of 10 Mb s or 12 Mb s If the baud rate you select does not match the system baud rate false tr...

Page 756: ...decoder and or trigger when in UART mode LSBFirst sets the least significant bit of each message byte as transmitted first MSBFirst sets the most significant bit as transmitted first Query Syntax SBUS...

Page 757: ...Query Syntax SBUS n UART COUNt ERRor Returns the UART error frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 1137 See Also SBUS n UART COU...

Page 758: ...Syntax SBUS n UART COUNt RESet Resets the UART frame counters Errors 241 Hardware missing on page 1137 See Also SBUS n UART COUNt ERRor on page 757 SBUS n UART COUNt RXFRames on page 759 SBUS n UART...

Page 759: ...6 Query Syntax SBUS n UART COUNt RXFRames Returns the UART Rx frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 1137 See Also SBUS n UART C...

Page 760: ...Query Syntax SBUS n UART COUNt TXFRames Returns the UART Tx frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 1137 See Also SBUS n UART CO...

Page 761: ...nondecimal Bnn n where n 0 1 for binary The SBUS n UART FRAMing command determines the byte value to use for framing end of packet or to turn off framing for UART decode Query Syntax SBUS n UART FRAMi...

Page 762: ...ART PARity command selects the parity to be used with each message byte for the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART PARity The SBUS n UART PARity query returns the...

Page 763: ...UART POLarity command selects the polarity as idle low or idle high for the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART POLarity The SBUS n UART POLarity query returns th...

Page 764: ...SBUS n UART SOURce RX command controls which signal is used as the Rx source by the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART SOURce RX The SBUS n UART SOURce RX query r...

Page 765: ...SBUS n UART SOURce TX command controls which signal is used as the Tx source by the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART SOURce TX The SBUS n UART SOURce TX query r...

Page 766: ...is from hexadecimal values The SBUS n UART TRIGger BASE setting does not affect the SBUS n UART TRIGger DATA command which can always set data values using ASCII or hexadecimal values Query Syntax SBU...

Page 767: ...elects the burst value Nth frame after idle period in the range 1 to 4096 or OFF for the trigger when in UART mode Query Syntax SBUS n UART TRIGger BURSt The SBUS n UART TRIGger BURSt query returns th...

Page 768: ...alue is used when one of the RD or TD trigger types is selected When entering an ASCII character via the quoted string it must be one of the 128 valid characters case sensitive NUL SOH STX ETX EOT ENQ...

Page 769: ...selects the value of the idle period for burst trigger in the range from 1 us to 10 s when in UART mode Query Syntax SBUS n UART TRIGger IDLE The SBUS n UART TRIGger IDLE query returns the current UA...

Page 770: ...TRIGger QUALifier command selects the data qualifier when TYPE is set to RDATa RD1 RD0 RDX TDATa TD1 TD0 or TDX for the trigger when in UART mode Query Syntax SBUS n UART TRIGger QUALifier The SBUS n...

Page 771: ...ger QUALifier commands are used to specify the data value and comparison operator The RD1 RD0 RDX TD1 TD0 and TDX types for triggering on data and alert bit values are only valid when a 9 bit width ha...

Page 772: ...ART WIDTh command determines the number of bits 5 9 for each message byte for the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART WIDTh The SBUS n UART WIDTh query returns the...

Page 773: ...SBUS n USBPd TRIGge r HEADer CMESsage type see page 778 SBUS n USBPd TRIGge r HEADer CMESsage see page 778 type GOODcrc GOTOmin ACCept REJect PING PSRDy GSRCap GSNCap DRSWap PRSWap VCSWap WAIT SRST GS...

Page 774: ...use analog channels Query Syntax SBUS n USBPd SOURce The SBUS n USBPd SOURce query returns the selected analog input channel Return Format source NL source CHAN n See Also SBUS n USBPd TRIGger on page...

Page 775: ...T Hard Reset triggers on ordered set RST 1 RST 1 RST 1 RST 2 CRST Cable Reset triggers on ordered set RST 1 Sync 1 RST 1 Sync 3 CRCerror CRC Error triggers when an error is detected on a 32 bit CRC PE...

Page 776: ...he SBUS n USBPd TRIGger HEADer DMESsage command to select the data message type EMESsage Extended Message triggers on extended message types bit 15 is set When the EMESsage header type is selected use...

Page 777: ...SBUS n Commands 25 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 777 SBUS n USBPd TRIGger HEADer QUALifier on page 784...

Page 778: ...Pd TRIGger HEADer CMESsage command the SBUS n USBPd TRIGger HEADer CMESsage command selects the control message type GOODcrc GoodCRC GOTOmin GotoMin ACCept Accept REJect Reject PING Ping PSRDy PS_RDY...

Page 779: ...S n USBPd SOURce on page 774 SBUS n USBPd TRIGger on page 775 SBUS n USBPd TRIGger HEADer on page 776 SBUS n USBPd TRIGger HEADer DMESsage on page 780 SBUS n USBPd TRIGger HEADer EMESsage on page 781...

Page 780: ...elects the data message type SRCap Source_Capabilities REQuest Request BIST BIST SNCap Sink_Capabilities BSTatus Battery_Status ALERt Alert GCINfo Get_Country_Info VDEFined Vendor_Defined Query Syntax...

Page 781: ...sage type SCX Source_Capabilities_Extended STATus Status GBCap Get_Battery_Cap GBSTatus Get_Battery_Status BCAP Battery_Capabilities GMINfo Get_Manufacturer_Info MINFo Manufacturer_Info SREQuest Secur...

Page 782: ...9241 42 43A Oscilloscopes SCPI Programmer s Guide 25 SBUS n Commands SBUS n USBPd TRIGger HEADer DMESsage on page 780 SBUS n USBPd TRIGger HEADer VALue on page 783 SBUS n USBPd TRIGger HEADer QUALifie...

Page 783: ...US n USBPd TRIGger HEADer VALue command specifies the user defined header value Query Syntax SBUS n USBPd TRIGger HEADer VALue The SBUS n USBPd TRIGger HEADer VALue query returns the specified user de...

Page 784: ...Sync 1 Sync 1 Sync 1 Sync 2 ordered sets only SPRime SOP The trigger occurs on Sync 1 Sync 1 Sync 3 Sync 3 ordered sets only SDPRime SOP The trigger occurs on Sync 1 Sync 3 Sync 1 Sync 3 ordered sets...

Page 785: ...GLITch Commands on page 794 Pulse Width search SEARch PEAK Commands on page 801 SEARch RUNT Commands on page 806 SEARch TRANsition Commands on page 811 SEARch SERial A429 Commands on page 816 SEARch S...

Page 786: ...Query Returns n a SEARch COUNt see page 787 count an integer count value SEARch EVENt event_number see page 788 SEARch EVENt see page 788 event_number the integer number of a found search event SEARch...

Page 787: ...OUNt see page 1196 Query Syntax SEARch COUNt The SEARch COUNt query returns the number of search events found Return Format count NL count an integer count value See Also Chapter 26 SEARch Commands st...

Page 788: ...und search event If the SEARch STATe is ON the horizontal position is changed so that the specified event is located at the time reference Query Syntax SEARch EVENt The SEARch EVENt query returns the...

Page 789: ...ODE command selects the search mode The command is only valid when the SEARch STATe is ON Query Syntax SEARch MODE The SEARch MODE query returns the currently selected mode or OFF if the SEARch STATe...

Page 790: ...value value 0 OFF 1 ON The SEARch STATe command enables or disables the search feature Query Syntax SEARch STATe The SEARch STATe query returns returns the current setting Return Format value NL valu...

Page 791: ...Table 110 SEARch EDGE Commands Summary Command Query Options and Query Returns SEARch EDGE SLOPe slope see page 792 SEARch EDGE SLOPe see page 792 slope POSitive NEGative EITHer SEARch EDGE SOURce so...

Page 792: ...ax SEARch EDGE SLOPe slope slope NEGative POSitive EITHer The SEARch EDGE SLOPe command specifies the slope of the edge for the search Query Syntax SEARch EDGE SLOPe The SEARch EDGE SLOPe query return...

Page 793: ...h EDGE SOURce source source CHANnel n n 1 to analog channels in NR1 format The SEARch EDGE SOURce command selects the channel on which to search for edges Query Syntax SEARch EDGE SOURce The SEARch ED...

Page 794: ..._than_time floating point number in NR3 format suffix s ms us ns ps SEARch GLITch POLari ty polarity see page 797 SEARch GLITch POLari ty see page 797 polarity POSitive NEGative SEARch GLITch QUALif i...

Page 795: ...GREaterthan command sets the minimum pulse width duration for the selected SEARch GLITch SOURce Query Syntax SEARch GLITch GREaterthan The SEARch GLITch GREaterthan query returns the minimum pulse wi...

Page 796: ...LITch LESSthan command sets the maximum pulse width duration for the selected SEARch GLITch SOURce Query Syntax SEARch GLITch LESSthan The SEARch GLITch LESSthan query returns the pulse width duration...

Page 797: ...ative The SEARch GLITch POLarity command sets the polarity for the glitch pulse width search Query Syntax SEARch GLITch POLarity The SEARch GLITch POLarity query returns the current polarity setting f...

Page 798: ...of the glitch pulse width search The oscilloscope can search for a pulse width that is greater than a time value less than a time value or within a range of time values Query Syntax SEARch GLITch QUA...

Page 799: ...command sets the pulse width duration for the selected SEARch GLITch SOURce You can enter the parameters in any order the smaller value becomes the greater_than_time and the larger value becomes the...

Page 800: ...channel on which to search for glitches pulse widths Query Syntax SEARch GLITch SOURce The SEARch GLITch SOURce query returns the current pulse width source If all channels are off the query returns N...

Page 801: ...ired change in level to be recognized as a peak in NR3 format SEARch PEAK NPEaks number see page 803 SEARch PEAK NPEaks see page 803 number max number of peaks to find 1 11 in NR1 format SEARch PEAK S...

Page 802: ...the change in level that must occur in other words hysteresis to be recognized as a peak The threshold level units are specified by the FFT VTYPe or FUNCtion m FFT VTYPe command Query Syntax SEARch P...

Page 803: ...in NR1 format The SEARch PEAK NPEaks command specifies the maximum number of FFT peaks to find This number can be from 1 to 11 Query Syntax SEARch PEAK NPEaks The SEARch PEAK NPEaks query returns the...

Page 804: ...h functions in NR1 format The SEARch PEAK SOURce command selects the FFT math function waveform to search Query Syntax SEARch PEAK SOURce The SEARch PEAK SOURce query returns the FFT math function wav...

Page 805: ...pecifies the threshold level necessary to be considered a peak The threshold level units are specified by the FFT VTYPe or FUNCtion m FFT VTYPe command Query Syntax SEARch PEAK THReshold The SEARch PE...

Page 806: ...NT POLarity see page 807 polarity POSitive NEGative EITHer SEARch RUNT QUALifie r qualifier see page 808 SEARch RUNT QUALifie r see page 808 qualifier GREaterthan LESSthan NONE SEARch RUNT SOURce sour...

Page 807: ...arity POSitive NEGative EITHer The SEARch RUNT POLarity command sets the polarity for the runt search Query Syntax SEARch RUNT POLarity The SEARch RUNT POLarity query returns the currently set runt po...

Page 808: ...n NONE The SEARch RUNT QUALifier command specifies whether to search for a runt that is greater than a time value less than a time value or any time value Query Syntax SEARch RUNT QUALifier The SEARch...

Page 809: ...CHANnel n n 1 to analog channels in NR1 format The SEARch RUNT SOURce command selects the channel on which to search for the runt pulse Query Syntax SEARch RUNT SOURce The SEARch RUNT SOURce query re...

Page 810: ...When searching for runt pulses whose widths are greater than or less than a time see SEARch RUNT QUALifier the SEARch RUNT TIME command specifies the time value Query Syntax SEARch RUNT TIME The SEARc...

Page 811: ...ANsition QU ALifier see page 812 qualifier GREaterthan LESSthan SEARch TRANsition SL OPe slope see page 813 SEARch TRANsition SL OPe see page 813 slope NEGative POSitive SEARch TRANsition SO URce sour...

Page 812: ...he SEARch TRANsition QUALifier command specifies whether to search for edge transitions greater than or less than a time Query Syntax SEARch TRANsition QUALifier The SEARch TRANsition QUALifier query...

Page 813: ...selects whether to search for rising edge POSitive slope transitions or falling edge NEGative slope transitions Query Syntax SEARch TRANsition SLOPe The SEARch TRANsition SLOPe query returns the curr...

Page 814: ...log channels in NR1 format The SEARch TRANsition SOURce command selects the channel on which to search for edge transitions Query Syntax SEARch TRANsition SOURce The SEARch TRANsition SOURce query ret...

Page 815: ...ns ps The SEARch TRANsition TIME command sets the time of the transition to search for You can search for transitions greater than or less than this time Query Syntax SEARch TRANsition TIME The SEARc...

Page 816: ...0xnn where n 0 9 A F SEARch SERial A429 M ODE condition see page 818 SEARch SERial A429 M ODE see page 818 condition LABel LBITs PERRor WERRor GERRor WGERrors ALLerrors SEARch SERial A429 P ATTern DAT...

Page 817: ...Qnnn where n 0 7 string 0xnn where n 0 9 A F The SEARch SERial A429 LABel command defines the ARINC 429 label value when labels are used in the selected search mode Query Syntax SEARch SERial A429 LA...

Page 818: ...rror WERRor finds an intra word coding error GERRor finds an inter word gap error WGERrors finds either a Word or Gap Error ALLerrors finds any of the above errors Query Syntax SEARch SERial A429 MODE...

Page 819: ...rched for in each ARINC 429 word Query Syntax SEARch SERial A429 PATTern DATA The SEARch SERial A429 PATTern DATA query returns the current settings of the specified ARINC 429 data pattern resource in...

Page 820: ...n searched for in each ARINC 429 word The specified SDI is only used if the SBUS n A429 FORMat includes the SDI field Query Syntax SEARch SERial A429 PATTern SDI The SEARch SERial A429 PATTern SDI que...

Page 821: ...n searched for in each ARINC 429 word The specified SSM is only used if the SBUS n A429 FORMat includes the SSM field Query Syntax SEARch SERial A429 PATTern SSM The SEARch SERial A429 PATTern SSM que...

Page 822: ...A LENGth length see page 826 SEARch SERial CAN PA TTern DATA LENGth see page 826 length integer from 1 to 8 in NR1 format SEARch SERial CAN PA TTern ID string see page 827 SEARch SERial CAN PA TTern I...

Page 823: ...ion Front panel name Description IDEither Frame ID Finds remote or data frames matching the specified ID IDData Data Frame ID Finds data frames matching the specified ID DATA Data Frame ID and Data Fi...

Page 824: ...Oscilloscopes SCPI Programmer s Guide 26 SEARch Commands RECall DBC STARt on page 536 SEARch SERial CAN SYMBolic MESSage on page 829 SEARch SERial CAN SYMBolic SIGNal on page 830 SEARch SERial CAN SY...

Page 825: ...ata value when searching for Data Frame ID and Data The length of the data value is specified using the SEARch SERial CAN PATTern DATA LENGth command Query Syntax SEARch SERial CAN PATTern DATA The SE...

Page 826: ...fies the length of the data value when searching for Data Frame ID and Data The data value is specified using the SEARch SERial CAN PATTern DATA command Query Syntax SEARch SERial CAN PATTern DATA LEN...

Page 827: ...value when searching for a CAN event The value can be a standard ID or an extended ID depending on the SEARch SERial CAN PATTern ID MODE command s setting Query Syntax SEARch SERial CAN PATTern ID Th...

Page 828: ...ifies whether a standard ID value or an extended ID value is used when searching for a CAN event The ID value is specified using the SEARch SERial CAN PATTern ID command Query Syntax SEARch SERial CAN...

Page 829: ...e to search for when CAN symbolic data has been loaded recalled into the oscilloscope and the CAN serial search mode is set to MESSage or MSIGnal Query Syntax SEARch SERial CAN SYMBolic MESSage The SE...

Page 830: ...ignal to search for when CAN symbolic data has been loaded recalled into the oscilloscope and the CAN serial search mode is set to MSIGnal Query Syntax SEARch SERial CAN SYMBolic SIGNal The SEARch SER...

Page 831: ...nto the oscilloscope and the CAN serial search mode is set to MSIGnal Query Syntax SEARch SERial CAN SYMBolic VALue The SEARch SERial CAN SYMBolic VALue query returns the specified signal value Return...

Page 832: ...h SERial IIC PA TTern ADDRess value see page 835 SEARch SERial IIC PA TTern ADDRess see page 835 value integer or string string 0xnn n 0 9 A F SEARch SERial IIC PA TTern DATA value see page 836 SEARch...

Page 833: ...also accepted for READ7 WRITe7 searches for 7 bit address frames containing Start Address7 Write Ack Data The value WRITe is also accepted for WRITe7 R7Data2 searches for 7 bit address frames containi...

Page 834: ...s Guide 26 SEARch Commands See Also Chapter 26 SEARch Commands starting on page 785 SEARch SERial IIC PATTern ADDRess on page 835 SEARch SERial IIC PATTern DATA on page 836 SEARch SERial IIC PATTern D...

Page 835: ...xnn n 0 9 A F The SEARch SERial IIC PATTern ADDRess command specifies address values when searching for IIC events To set don t care values use the integer 1 Query Syntax SEARch SERial IIC PATTern ADD...

Page 836: ...vents To set don t care values use the integer 1 When searching for IIC EEPROM data read events you specify the data value qualifier using the SEARch SERial IIC QUALifier command Query Syntax SEARch S...

Page 837: ...ATTern DATA2 command specifies the second data value when searching for IIC events with two data values To set don t care values use the integer 1 Query Syntax SEARch SERial IIC PATTern DATA2 The SEAR...

Page 838: ...SERial IIC QUALifier command specifies the data value qualifier used when searching for IIC EEPROM data read events Query Syntax SEARch SERial IIC QUALifier The SEARch SERial IIC QUALifier query retu...

Page 839: ...e page 842 When SEARch SERial LIN PATTern FORMa t DECimal string n where n 32 bit integer in unsigned decimal returns if data has any don t cares When SEARch SERial LIN PATTern FORMa t HEX string 0xnn...

Page 840: ...re n 0 9 A F for hexadecimal nondecimal Bnn n where n 0 1 for binary string 0xnn where n 0 9 A F for hexadecimal The SEARch SERial LIN ID command specifies the frame ID value when searching for LIN ev...

Page 841: ...specified using the SEARch SERial LIN PATTern DATA command Frames signals and signal values are specified using the SEARch SERial LIN SYMBolic FRAMe SEARch SERial LIN SYMBolic SIGNal and SEARch SERial...

Page 842: ...LIN PATTern FORMat command To set don t care values with the DATA command the FORMat must be HEX The length of the data value entered is specified using the SEARch SERial LIN PATTern DATA LENGth comm...

Page 843: ...ENGth command specifies the the length of the data value when searching for LIN events The data value is specified using the SEARch SERial LIN PATTern DATA command Query Syntax SEARch SERial LIN PATTe...

Page 844: ...Cimal The SEARch SERial LIN PATTern FORMat command specifies the number base used with the SEARch SERial LIN PATTern DATA command Query Syntax SEARch SERial LIN PATTern FORMat The SEARch SERial LIN PA...

Page 845: ...e to search for when LIN symbolic data has been loaded recalled into the oscilloscope and the LIN serial search mode is set to FRAMe or FSIGnal Query Syntax SEARch SERial LIN SYMBolic FRAMe The SEARch...

Page 846: ...signal to search for when LIN symbolic data has been loaded recalled into the oscilloscope and the LIN serial search mode is set to FSIGnal Query Syntax SEARch SERial LIN SYMBolic SIGNal The SEARch SE...

Page 847: ...into the oscilloscope and the LIN serial search mode is set to FSIGnal Query Syntax SEARch SERial LIN SYMBolic VALue The SEARch SERial LIN SYMBolic VALue query returns the specified signal value Retur...

Page 848: ...SERial M1553 MODE see page 849 value DSTArt CSTArt RTA RTA11 PERRor SERRor MERRor SEARch SERial M1553 PATTern DATA string see page 850 SEARch SERial M1553 PATTern DATA see page 850 string nn n where n...

Page 849: ...RTA11 searches for the Remote Terminal Address RTA and the additional 11 bits of a Command Status word PERRor searches for odd parity errors for the data in the word SERRor searches for invalid Sync...

Page 850: ...ial M1553 PATTern DATA command specifies the additional 11 bits when searching for the MIL STD 1553 Remote Terminal Address 11 Bits Query Syntax SEARch SERial M1553 PATTern DATA The SEARch SERial M155...

Page 851: ...where n 0 9 A F binary Bnn n where n 0 1 for binary string 0xnn where n 0 9 A F The SEARch SERial M1553 RTA command specifies the Remote Terminal Address RTA value when searching for MIL STD 1553 even...

Page 852: ...SERial SENT F AST DATA see page 853 string 0xn where n 0 9 A F X SEARch SERial SENT M ODE mode see page 854 SEARch SERial SENT M ODE see page 854 mode FCData SCMid SCData CRCerror PPERror SEARch SERi...

Page 853: ...FAST DATA command specifies the status and data nibbles that will be searched for when the FCData search mode is chosen Query Syntax SEARch SERial SENT FAST DATA The SEARch SERial SENT FAST DATA query...

Page 854: ...Channel Message IDs that match the value entered using additional softkeys SCData finds Slow Channel Message IDs and Data that match the values entered using additional softkeys CRCerror finds any CRC...

Page 855: ...ial SENT SLOW DATA command specifies the data to search for in the Slow Channel Message ID and Data search mode Query Syntax SEARch SERial SENT SLOW DATA The SEARch SERial SENT SLOW DATA query returns...

Page 856: ...arch for in the Slow Channel Message ID and Slow Channel Message ID Data trigger modes The ID can be from 1 don t care to 255 depending on the message length Query Syntax SEARch SERial SENT SLOW ID Th...

Page 857: ...0x00 0xff in decimal hexadecimal binary or quoted_string format hexadecimal Hnn where n 0 9 A F for hexadecimal binary Bnn n where n 0 1 for binary quoted_string any of the 128 valid 7 bit ASCII char...

Page 858: ...e 128 valid 7 bit ASCII characters or standard abbreviations The SEARch SERial UART DATA command specifies a data value when searching for UART RS232 events The data value qualifier is specified using...

Page 859: ...don t care X TDATa searches for a transmit data value when data words are from 5 to 8 bits long TD1 searches for a transmit data value when data words are 9 bits long and the 9th alert bit is 1 TD0 s...

Page 860: ...aterthan LESSthan The SEARch SERial UART QUALifier command specifies the data value qualifier when searching for UART RS232 events Query Syntax SEARch SERial UART QUALifier The SEARch SERial UART QUAL...

Page 861: ...see page 866 n a string up to 75 characters as a quoted ASCII string n a SYSTem ERRor see page 867 error an integer error code error string quoted ASCII string See Error Messages see page 1135 SYSTem...

Page 862: ...ay see page 878 setting 0 1 SYSTem RLOGger FNAMe file_name see page 879 SYSTem RLOGger FNAMe see page 879 file_name quoted ASCII string SYSTem RLOGger STATe 0 OFF 1 ON see page 880 SYSTem RLOGger STAT...

Page 863: ...A Oscilloscopes SCPI Programmer s Guide 863 Introduction to SYSTem Commands SYSTem subsystem commands enable writing messages to the display setting and reading both the time and the date querying for...

Page 864: ...SYSTem Commands SYSTem DATE see page 1196 Query Syntax SYSTem DATE The SYSTem DATE query returns the date Return Format year month day NL year 4 digit year in NR1 format month 1 12 day 1 31 See Also I...

Page 865: ...loscope upgrades or other licensed features The exact format of returned string are product specific This example returns the model number serial number and host ID in a comma separated format X12345A...

Page 866: ...o 75 characters The SYSTem DSP command writes the quoted string excluding quotation marks to a text box on screen Use SYSTem DSP to remotely remove the message from the display Two sets of quote marks...

Page 867: ...oscope s front panel additional debug information can be included in the returned error string If the error is detected by the SCPI command parser such as a header error or other syntax error the extr...

Page 868: ...Soft Front Panel SFP user interface This remote command performs the same operation as the Show Front Panel and Hide Front Panel buttons in the Keysight InfiniiVision SFP Launcher application on the...

Page 869: ...off on_off 1 ON 0 OFF The SYSTem LOCK command disables the front panel LOCK ON is the equivalent of sending a local lockout message over the programming interface Query Syntax SYSTem LOCK The SYSTem L...

Page 870: ...tion string returned by the IDN query The default manufacturer string is KEYSIGHT TECHNOLOGIES If your remote programs depend on a legacy manufacturer string for example you could use this command to...

Page 871: ...er DEFault see page 1196 Command Syntax SYSTem PERSona MANufacturer DEFault The SYSTem PERSona MANufacturer DEFault command sets the manufacturer string to KEYSIGHT TECHNOLOGIES See Also IDN Identific...

Page 872: ...Setup on the front panel When you perform a default setup some user settings like preferences remain unchanged To reset all user settings to their factory defaults use the RST command Reset condition...

Page 873: ...ase 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 Type Edge Mode Auto Coupling...

Page 874: ...874 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 27 SYSTem Commands See Also Introduction to Common Commands on page 159 RST Reset on page 172...

Page 875: ...els Query Syntax SYSTem PROTection LOCK The SYSTem PROTection LOCK query returns the analog channel protection lock status Return Format on_off NL on_off 1 0 See Also Introduction to SYSTem Commands o...

Page 876: ...name quoted ASCII string write_mode CREate APPend The SYSTem RLOGger command enables or disables remote command logging optionally specifying the log file name and write mode See Also SYSTem RLOGger D...

Page 877: ...evice logged to the screen or both Query Syntax SYSTem RLOGger DESTination The SYSTem RLOGger DESTination query returns the remote command logging destination Return Format dest NL dest FILE SCR BOTH...

Page 878: ...mote commands and their return values if applicable Query Syntax SYSTem RLOGger DISPlay The SYSTem RLOGger DISPlay query returns whether the screen display for remote command logging is enabled or dis...

Page 879: ...file name Because log files are ASCII text files the txt extension is automatically added to the name specified Query Syntax SYSTem RLOGger FNAMe The SYSTem RLOGger FNAMe query returns the remote com...

Page 880: ...nables or disables remote command logging Query Syntax SYSTem RLOGger STATe The SYSTem RLOGger STATe query returns the remote command logging state Return Format setting NL setting 0 1 See Also SYSTem...

Page 881: ...y background for remote command logging is transparent or solid Query Syntax SYSTem RLOGger TRANsparent The SYSTem RLOGger TRANsparent query returns the setting for transparent screen display backgrou...

Page 882: ...specifies the remote command logging write mode Query Syntax SYSTem RLOGger WMODe The SYSTem RLOGger WMODe query returns the remote command logging write mode Return Format write_mode NL write_mode C...

Page 883: ...format See Also Introduction to SYSTem Commands on page 863 LRN Learn Device Setup on page 167 Example Code SAVE_SYSTEM_SETUP The SYSTEM SETUP query returns a program message that contains the current...

Page 884: ...s Guide 27 SYSTem Commands Write setup string back to oscilloscope using SYSTEM SETUP command myScope WriteIEEEBlock SYSTEM SETUP varSetupString CheckForInstrumentErrors See complete example programs...

Page 885: ...mmer s Guide 885 SYSTem TIME see page 1196 Query Syntax SYSTem TIME time The SYSTem TIME query returns the current system time Return Format time NL time hours minutes seconds in NR1 format See Also I...

Page 886: ...page 1196 Command Syntax SYSTem TOUCh on_off on_off 1 ON 0 OFF The SYSTem TOUCh command disables or enables the touchscreen Query Syntax SYSTem TOUCh The SYSTem TOUCh query returns the touchscreen s o...

Page 887: ...e page 891 range_value time for 10 div in seconds in NR3 format TIMebase REFClock 0 OFF 1 ON see page 892 TIMebase REFClock see page 892 0 1 TIMebase REFerence LEFT CENTer RIGHt CUSTom see page 893 TI...

Page 888: ...Mebase 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...

Page 889: ...ce commands are not available No measurements are available in this mode ROLL In the ROLL mode data moves continuously across the display from left to right The oscilloscope runs continuously and is u...

Page 890: ...and is set with the TIMebase REFerence command The maximum position value depends on the time division settings Query Syntax TIMebase POSition The TIMebase POSition query returns the current time fro...

Page 891: ...The TIMebase RANGe query returns the current full scale range value for the main window Return Format range_value NL range_value time for 10 div in seconds in NR3 format See Also Introduction to TIMe...

Page 892: ...MHz reference clock when synchronizing multiple instruments see ACQuire RSIGnal on page 234 The TIMebase REFClock ON command enables the REF I O MMCX and sets the reference signal mode to IN The TIMe...

Page 893: ...time reference location at a percent of the graticule width where 0 0 is the left edge and 1 0 is the right edge The time reference is the point on the display where the trigger point is referenced Qu...

Page 894: ...EFerence is set to CUSTom the TIMebase REFerence LOCation command lets you place the time reference location at a percent of the graticule width where 0 0 is the left edge and 1 0 is the right edge Qu...

Page 895: ...ts the horizontal scale or units per division for the main window Query Syntax TIMebase SCALe The TIMebase SCALe query returns the current horizontal scale setting in seconds per division for the main...

Page 896: ...e 1 ON 0 OFF The TIMebase VERNier command specifies whether the time base control s vernier fine horizontal adjustment setting is ON 1 or OFF 0 Query Syntax TIMebase VERNier The TIMebase VERNier query...

Page 897: ...e and the main sweep horizontal position determine the range for this command The value for this command must keep the zoomed view window within the main sweep range Query Syntax TIMebase WINDow POSit...

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

Page 899: ...s 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 retur...

Page 900: ...900 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 28 TIMebase Commands...

Page 901: ...Commands on page 980 TRIGger ZONE Commands on page 990 Introduction to TRIGger Commands The commands in the TRIGger subsystem define the conditions for an internal trigger Many of these commands are v...

Page 902: ...ng for a specified pattern This pattern is a logical AND combination of the channels You can also trigger on a specified time duration of a pattern TV triggering is used to capture the complicated wav...

Page 903: ...oldoff see page 909 TRIGger HOLDoff MINi mum see page 909 min_holdoff minimum holdoff time in seconds in NR3 format TRIGger HOLDoff RAND om 0 OFF 1 ON see page 910 TRIGger HOLDoff RAND om see page 910...

Page 904: ...29 TRIGger Commands TRIGger NREJect 0 OFF 1 ON see page 915 TRIGger NREJect see page 915 0 1 TRIGger SWEep sweep see page 916 TRIGger SWEep see page 916 sweep AUTO NORMal Table 124 General TRIGger Com...

Page 905: ...IGger FORCe see page 1196 Command Syntax TRIGger FORCe The TRIGger FORCe command causes an acquisition to be captured even though the trigger condition has not been met This command is equivalent to t...

Page 906: ...ncy reject filter adds a 50 kHz low pass filter in the trigger path to remove high frequency components from the trigger waveform Use this filter to remove high frequency noise such as AM or FM broadc...

Page 907: ...when a waveform crosses the trigger level multiple times during one period of the waveform Without holdoff the oscilloscope could trigger on each of the crossings producing a confusing waveform With h...

Page 908: ...econds in NR3 format When the random trigger holdoff mode is enabled see TRIGger HOLDoff RANDom the TRIGger HOLDoff MAXimum command specifies the maximum trigger holdoff time Query Syntax TRIGger HOLD...

Page 909: ...econds in NR3 format When the random trigger holdoff mode is enabled see TRIGger HOLDoff RANDom the TRIGger HOLDoff MINimum command specifies the minimum trigger holdoff time Query Syntax TRIGger HOLD...

Page 910: ...er holdoff mode ensures that the oscilloscope re arms after each acquisition in a manner that minimizes or eliminates the likelihood of triggering at the beginning of a DDR burst Randomizing the holdo...

Page 911: ...The TRIGger LEVel ASETup command automatically sets the trigger levels of all displayed analog channels to their waveforms 50 values If AC coupling is used the trigger levels are set to 0 V When High...

Page 912: ...HIGH command sets the high trigger voltage level voltage for the specified source High and low trigger levels are used with runt triggers and rise fall time transition triggers Query Syntax TRIGger L...

Page 913: ...l LOW command sets the low trigger voltage level voltage for the specified source High and low trigger levels are used with runt triggers and rise fall time transition triggers Query Syntax TRIGger LE...

Page 914: ...TRIGger MODE The TRIGger MODE query returns the current trigger mode If the TIMebase MODE is ROLL or XY the query returns NONE Return Format mode NL mode EDGE GLIT PATT TV DEL EBUR OR RUNT SHOL TRAN...

Page 915: ...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 no...

Page 916: ...nt but the oscilloscope is not triggered the unsynchronized signal is displayed instead of a baseline When NORMal sweep mode is selected and no trigger is present the instrument does not sweep and the...

Page 917: ...ge 918 TRIGger DELay ARM SL OPe see page 918 slope NEGative POSitive TRIGger DELay ARM SO URce source see page 919 TRIGger DELay ARM SO URce see page 919 source CHANnel n n 1 to analog channels in NR1...

Page 918: ...DELay ARM SLOPe command specifies rising POSitive or falling NEGative for the arming edge in the Edge Then Edge trigger Query Syntax TRIGger DELay ARM SLOPe The TRIGger DELay ARM SLOPe query returns t...

Page 919: ...ormat The TRIGger DELay ARM SOURce command selects the input used for the arming edge in the Edge Then Edge trigger Query Syntax TRIGger DELay ARM SOURce The TRIGger DELay ARM SOURce query returns the...

Page 920: ...s the delay time between the arming edge and the trigger edge in the Edge Then Edge trigger The time is in seconds and must be from 4 ns to 10 s Query Syntax TRIGger DELay TDELay TIME The TRIGger DELa...

Page 921: ...RIGger COUNt command sets the Nth edge of the trigger source to trigger on Query Syntax TRIGger DELay TRIGger COUNt The TRIGger DELay TRIGger COUNt query returns the current Nth trigger edge setting R...

Page 922: ...nd specifies rising POSitive or falling NEGative for the trigger edge in the Edge Then Edge trigger Query Syntax TRIGger DELay TRIGger SLOPe The TRIGger DELay TRIGger SLOPe query returns the current t...

Page 923: ...RIGger SOURce command selects the input used for the trigger edge in the Edge Then Edge trigger Query Syntax TRIGger DELay TRIGger SOURce The TRIGger DELay TRIGger SOURce query returns the current tri...

Page 924: ...l Table 126 TRIGger EBURst Commands Summary Command Query Options and Query Returns TRIGger EBURst COUNt count see page 925 TRIGger EBURst COUNt see page 925 count integer in NR1 format TRIGger EBURst...

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

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

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

Page 928: ...hannels in NR1 format The TRIGger EBURst SOURce command selects the input that produces the Nth edge burst trigger Query Syntax TRIGger EBURst SOURce The TRIGger EBURst SOURce query returns the curren...

Page 929: ...5 x full scale voltage from center screen in NR3 format For external triggers level external range setting in NR3 format source CHANnel n EXTernal n 1 to analog channels in NR1 format TRIGger EDGE REJ...

Page 930: ...oltage from the trigger waveform Use AC coupling to get a stable edge trigger when your waveform has a large dc offset LFReject coupling places a 50 KHz high pass filter in the trigger path DC couplin...

Page 931: ...ernal n 1 to analog channels in NR1 format The TRIGger EDGE LEVel command sets the trigger level voltage for the active trigger source Query Syntax TRIGger EDGE LEVel source The TRIGger EDGE LEVel que...

Page 932: ...oise such as AM or FM broadcast stations from the trigger path The low frequency reject filter adds a 50 kHz high pass filter in series with the trigger waveform to remove any unwanted low frequency c...

Page 933: ...Gger TV POLarity to set the polarity in TV trigger mode Query Syntax TRIGger EDGE SLOPe The TRIGger EDGE SLOPe query returns the current trigger slope Return Format slope NL slope NEG POS EITH ALT See...

Page 934: ...ilable when the DC NOISe or CARDiac waveforms are selected WMOD when waveform generator FSK or FM modulation is used triggers at the 50 level of the rising edge of the modulating signal Query Syntax T...

Page 935: ...For internal triggers level 75 x full scale voltage from center screen in NR3 format For external triggers level external range setting in NR3 format source CHANnel n EXTernal n 1 to analog channels...

Page 936: ...GREaterthan command sets the minimum pulse width duration for the selected TRIGger GLITch SOURce Query Syntax TRIGger GLITch GREaterthan The TRIGger GLITch GREaterthan query returns the minimum pulse...

Page 937: ...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 dura...

Page 938: ...riggers source CHANnel n EXTernal n 1 to analog channels in NR1 format The TRIGger GLITch LEVel command sets the trigger level voltage for the active pulse width trigger Query Syntax TRIGger GLITch LE...

Page 939: ...OSitive NEGative The TRIGger GLITch POLarity command sets the polarity for the glitch pulse width trigger Query Syntax TRIGger GLITch POLarity The TRIGger GLITch POLarity query returns the glitch puls...

Page 940: ...of the glitch pulse width trigger The oscilloscope can trigger on a pulse width that is greater than a time value less than a time value or within a range of time values Query Syntax TRIGger GLITch Q...

Page 941: ...command sets the pulse width duration for the selected TRIGger GLITch SOURce You can enter the parameters in any order the smaller value becomes the greater_than_time and the larger value becomes the...

Page 942: ...that produces the pulse width trigger Query Syntax TRIGger GLITch SOURce The TRIGger GLITch SOURce query returns the current pulse width source If all channels are off the query returns NONE Return F...

Page 943: ...arit y 0 OFF 1 ON see page 946 TRIGger NFC RPOLarit y see page 946 0 1 TRIGger NFC SOURce source see page 947 TRIGger NFC SOURce see page 947 source CHANnel n n 1 to analog channels in NR1 format TRIG...

Page 944: ...he arm event is NONE Query Syntax TRIGger NFC AEVent The TRIGger NFC AEVent query returns the specified arm event Return Format arm_event NL arm_event NONE ASR AALL AEIT BSR BALL BEIT FSR See Also TRI...

Page 945: ...he arm and the trigger when the ATRigger Arm Trigger trigger event is selected Return Format time NL time seconds in NR3 format See Also TRIGger NFC AEVent on page 944 TRIGger NFC SOURce on page 947 T...

Page 946: ...FF the oscilloscope will trigger on signals with obverse polarity Query Syntax TRIGger NFC RPOLarity The TRIGger NFC RPOLarity query returns the reverse polarity setting Return Format setting NL setti...

Page 947: ...for the NFC trigger You can choose an analog input channel Query Syntax TRIGger NFC SOURce The TRIGger NFC SOURce query returns the input waveform source setting Return Format source NL source CHAN n...

Page 948: ...6 NFC A standard 106 kbits s F212 NFC F standard 212 kbits s F424 NFC F standard 424 kbits s Query Syntax TRIGger NFC STANdard The TRIGger NFC STANdard query returns the signaling technology setting R...

Page 949: ...nt NL trigger_event ATR ASR AALL AEIT ASDD BSR BALL BEIT BATT FSR FAR FPR Signaling Technology Trigger Event Description NFC A ATRigger The arm event is specified by TRIGger NFC AEVent and the trigger...

Page 950: ...nds See Also TRIGger NFC AEVent on page 944 TRIGger NFC ATTime on page 945 TRIGger NFC RPOLarity on page 946 TRIGger NFC SOURce on page 947 TRIGger NFC STANdard on page 948 TRIGger NFC TIMeout on page...

Page 951: ...iggers when the timeout period expires A return value of 1 says the desired trigger event did not occur within the specified time after the arm event A return value of 0 says the desired trigger event...

Page 952: ...second event does not occur within the timeout period the oscilloscope triggers when the timeout period expires Query Syntax TRIGger NFC TIMeout ENABle The TRIGger NFC TIMeout ENABle query returns th...

Page 953: ...oes not occur within the timeout period the oscilloscope triggers when the timeout period expires Query Syntax TRIGger NFC TIMeout TIME The TRIGger NFC TIMeout TIME query returns the specified timeout...

Page 954: ...e 130 TRIGger OR Commands Summary Command Query Options and Query Returns TRIGger OR string see page 955 TRIGger OR see page 955 string nn n where n R F E X R rising edge F falling edge E either edge...

Page 955: ...cifies the edges to include in the OR ed edge trigger In the string parameter each bit corresponds to a channel as described in the following table Query Syntax TRIGger OR The TRIGger OR query returns...

Page 956: ...ger PATTern GREa terthan greater_than_time s uffix see page 960 TRIGger PATTern GREa terthan see page 960 greater_than_time floating point number in NR3 format suffix s ms us ns ps TRIGger PATTern LES...

Page 957: ...the string looks just like the string you see on the oscilloscope s front panel made up of 0 1 X don t care R rising edge and F falling edge characters When the format is HEX the string begins with 0x...

Page 958: ...Commands The TRIGger PATTern query returns the pattern string edge source and edge Return Format string edge_source edge NL See Also Introduction to TRIGger Commands on page 901 TRIGger PATTern FORMat...

Page 959: ...TRIGger PATTern FORMat command sets the entry and query number base used by the TRIGger PATTern command The default base is ASCii Query Syntax TRIGger PATTern FORMat The TRIGger PATTern FORMat query...

Page 960: ...mand sets the minimum duration for the defined pattern when TRIGger PATTern QUALifier is set to GREaterthan The command also sets the timeout value when the TRIGger PATTern QUALifier is set to TIMeout...

Page 961: ...fix s ms us ns ps The TRIGger PATTern LESSthan command sets the maximum duration for the defined pattern when TRIGger PATTern QUALifier is set to LESSthan Query Syntax TRIGger PATTern LESSthan The TRI...

Page 962: ...range of values OUTRange when the pattern is present for a time outside of range of values Pattern durations are evaluated using a timer The timer starts on the last edge that makes the pattern logica...

Page 963: ...ets the duration for the defined pattern when the TRIGger PATTern QUALifier command is set to INRange or OUTRange You can enter the parameters in any order the smaller value becomes the greater_than_t...

Page 964: ...T POLarit y see page 965 polarity POSitive NEGative EITHer TRIGger RUNT QUALifi er qualifier see page 966 TRIGger RUNT QUALifi er see page 966 qualifier GREaterthan LESSthan NONE TRIGger RUNT SOURce s...

Page 965: ...y for the runt trigger POSitive positive runt pulses NEGative negative runt pulses EITHer either positive or negative runt pulses Query Syntax TRIGger RUNT POLarity The TRIGger RUNT POLarity query ret...

Page 966: ...se widths GREaterthan triggers on runt pulses whose width is greater than the TRIGger RUNT TIME LESSthan triggers on runt pulses whose width is less than the TRIGger RUNT TIME NONE triggers on runt pu...

Page 967: ...ource CHANnel n n 1 to analog channels in NR1 format The TRIGger RUNT SOURce command selects the channel used to produce the trigger Query Syntax TRIGger RUNT SOURce The TRIGger RUNT SOURce query retu...

Page 968: ...on runt pulses whose width is greater than or less than a certain value see TRIGger RUNT QUALifier the TRIGger RUNT TIME command specifies the time used with the qualifier Query Syntax TRIGger RUNT T...

Page 969: ...RIGger SHOLd SOURce CLOCk see page 971 source CHANnel n n 1 to analog channels in NR1 format TRIGger SHOLd SOURce DATA source see page 972 TRIGger SHOLd SOURce DATA see page 972 source CHANnel n n 1 t...

Page 970: ...LOPe command specifies whether the rising edge or the falling edge of the clock signal is used Query Syntax TRIGger SHOLd SLOPe The TRIGger SHOLd SLOPe query returns the current rising or falling edge...

Page 971: ...to analog channels in NR1 format The TRIGger SHOLd SOURce CLOCk command selects the input channel probing the clock signal Query Syntax TRIGger SHOLd SOURce CLOCk The TRIGger SHOLd SOURce CLOCk query...

Page 972: ...1 to analog channels in NR1 format The TRIGger SHOLd SOURce DATA command selects the input channel probing the data signal Query Syntax TRIGger SHOLd SOURce DATA The TRIGger SHOLd SOURce DATA query re...

Page 973: ...D time suffix time floating point number in NR3 format suffix s ms us ns ps The TRIGger SHOLd TIME HOLD command sets the hold time Query Syntax TRIGger SHOLd TIME HOLD The TRIGger SHOLd TIME HOLD quer...

Page 974: ...time suffix time floating point number in NR3 format suffix s ms us ns ps The TRIGger SHOLd TIME SETup command sets the setup time Query Syntax TRIGger SHOLd TIME SETup The TRIGger SHOLd TIME SETup qu...

Page 975: ...r qualifier see page 976 TRIGger TRANsition Q UALifier see page 976 qualifier GREaterthan LESSthan TRIGger TRANsition S LOPe slope see page 977 TRIGger TRANsition S LOPe see page 977 slope NEGative PO...

Page 976: ...es whether you are looking for rise fall times greater than or less than a certain time value The time value is set using the TRIGger TRANsition TIME command Query Syntax TRIGger TRANsition QUALifier...

Page 977: ...Sitive The TRIGger TRANsition SLOPe command specifies a POSitive rising edge or a NEGative falling edge Query Syntax TRIGger TRANsition SLOPe The TRIGger TRANsition SLOPe query returns the current ris...

Page 978: ...to analog channels in NR1 format The TRIGger TRANsition SOURce command selects the channel used to produce the trigger Query Syntax TRIGger TRANsition SOURce The TRIGger TRANsition SOURce query return...

Page 979: ...ets the time value for rise fall time triggers You also use the TRIGger TRANsition QUALifier command to specify whether you are triggering on times greater than or less than this time value Query Synt...

Page 980: ...er TV SOURce see page 984 source CHANnel n n 1 to analog channels in NR1 format TRIGger TV STANdard standard see page 985 TRIGger TV STANdard see page 985 standard NTSC PAL PALM SECam standard GENeric...

Page 981: ...ger line number setting Return Format line_number NL line_number integer in NR1 format See Also Introduction to TRIGger Commands on page 901 TRIGger TV STANdard on page 985 TRIGger TV MODE on page 982...

Page 982: ...r is not available when TRIGger TV STANdard is GENeric Old forms for mode are accepted Query Syntax TRIGger TV MODE The TRIGger TV MODE query returns the TV trigger mode Return Format value NL value F...

Page 983: ...polarity polarity POSitive NEGative The TRIGger TV POLarity command sets the polarity for the TV trigger Query Syntax TRIGger TV POLarity The TRIGger TV POLarity query returns the TV trigger polarity...

Page 984: ...channels in NR1 format The TRIGger TV SOURce command selects the channel used to produce the trigger Query Syntax TRIGger TV SOURce The TRIGger TV SOURce query returns the current TV trigger source R...

Page 985: ...d command selects the video standard NTSC PAL PAL M SECAM With an extended Video triggering license the oscilloscope additionally supports these standards Generic GENeric mode is non interlaced EDTV 4...

Page 986: ...TRIGger TV UDTV ENUMber command specifies the Generic video trigger s Nth edge to trigger on after synchronizing with the vertical sync Query Syntax TRIGger TV UDTV ENUMber The TRIGger TV UDTV ENUMber...

Page 987: ...not double count during equalization Additionally the Field Holdoff can be adjusted so that the oscilloscope triggers once per frame Similarly for progressive video with a tri level sync enabling the...

Page 988: ...video trigger s horizontal sync control is enabled the TRIGger TV UDTV HTIMe command sets the minimum time the horizontal sync pulse must be present to be considered valid Query Syntax TRIGger TV UDT...

Page 989: ...ies the greater than the sync pulse width time in the Generic video trigger This setting allows oscilloscope synchronization to the vertical sync Query Syntax TRIGger TV UDTV PGTHan The TRIGger TV UDT...

Page 990: ...e 992 0 1 TRIGger ZONE n MODE mode see page 993 TRIGger ZONE n MODE see page 993 mode INTersect NOTintersect n 1 2 in NR1 format TRIGger ZONE n PLAC ement width height x_center y_center see page 994 T...

Page 991: ...ource source CHANnel n n 1 to analog channels in NR1 format The TRIGger ZONE SOURce command sets the analog source channel shared by all zones Query Syntax TRIGger ZONE SOURce The TRIGger ZONE SOURce...

Page 992: ...e mimics the behavior of the Zone 1 On and Zone 2 On softkeys At least one zone s state must be on for the Zone Trigger feature TRIGger ZONE STATe to be on When the states of both individual zones are...

Page 993: ...The TRIGger ZONE n MODE command sets the zone qualifying condition for Zone 1 or Zone 2 as either Must Intersect or Must Not Intersect Query Syntax TRIGger ZONE n MODE The TRIGger ZONE n MODE query re...

Page 994: ...RIGger ZONE n PLACement command sets the size and location of Zone 1 or Zone 2 No error is returned if the zone is placed off screen or if the zones overlap such that Zone 2 becomes invalid The TRIGge...

Page 995: ...alifying conditions modes Zone 1 can never be invalid OSCReen off screen is returned when the associated zone is off screen and thus not being used to qualify the trigger A zone is valid when it is ne...

Page 996: ...ote that TRIGger ZONE STATe mimics the behavior of the Zone key on the front panel and TRIGger ZONE n STATe mimics the behavior of the Zone 1 On and Zone 2 On softkeys At least one zone s state must b...

Page 997: ...er see page 1005 value LSBFirst MSBFirst n a WAVeform COUNt see page 1006 count an integer from 1 to 65536 in NR1 format n a WAVeform DATA see page 1007 binary block length bytes binary data For examp...

Page 998: ...type NR1 points NR1 count NR1 xincrement NR3 xorigin NR3 xreference NR1 yincrement NR3 yorigin NR3 yreference NR1 format an integer in NR1 format 0 for BYTE format 1 for WORD format 2 for ASCii forma...

Page 999: ...e SUB0 RX MOSI SUB1 TX MISO n a WAVeform TYPE see page 1026 return_mode NORM PEAK AVER HRES WAVeform UNSigned 0 OFF 1 ON see page 1027 WAVeform UNSigned see page 1027 0 1 WAVeform VIEW view see page 1...

Page 1000: ...ypes There are four types of waveform acquisitions that can be selected for analog channels with the ACQuire TYPE command see page 242 NORMal AVERage PEAK and HRESolution When the data is acquired usi...

Page 1001: ...ucket This data is transmitted over the programming interface in a linear fashion starting with time bucket 0 and going through time bucket n 1 where n is the number returned by the WAVeform POINts qu...

Page 1002: ...hing mode is used to reduce noise at slower sweep speeds where the digitizer samples faster than needed to fill memory for the displayed time range Data Conversion Word or byte data sent from the osci...

Page 1003: ...vert the binary data Values are transferred as ASCii digits in floating point format separated by commas In ASCii format holes are represented by the value 9 9e 37 The setting of WAVeform BYTeorder se...

Page 1004: ...se in ASCii format as many as 13 bytes per point are transferred in BYTE format one byte per point is transferred and in WORD format two bytes per point are transferred The WAVeform BYTeorder command...

Page 1005: ...rst sets the least significant byte to be transmitted first This command affects the transmitting sequence only when WAVeform FORMat WORD is selected The default setting is MSBFirst Query Syntax WAVef...

Page 1006: ...used to acquire the current waveform This may differ from current values if the unit has been stopped and its configuration modified For all acquisition types except average this value is 1 Return Fo...

Page 1007: ...transfers Use telnet port 5025 instead 0x01 or 0x0001 Clipped low These are locations where the waveform is clipped at the bottom of the oscilloscope display 0xFF or 0xFFFF Clipped high These are loc...

Page 1008: ...ryResult myScope ReadIEEEBlock BinaryType_UI1 Unsigned integer bytes For lngI 0 To UBound varQueryResult _ Step UBound varQueryResult 20 20 points If intBytesPerData 2 Then lngDataValue varQueryResult...

Page 1009: ...formatted data transfers 16 bit data as two bytes The WAVeform BYTeorder command can be used to specify whether the upper or lower byte is transmitted first The default no command sent is that the up...

Page 1010: ...ints mode See the WAVeform POINts MODE command see page 1012 for more information Only data visible on the display will be returned When the WAVeform SOURce is the serial decode bus SBUS1 or SBUS2 thi...

Page 1011: ...orm VIEW on page 1028 WAVeform PREamble on page 1014 WAVeform POINts MODE on page 1012 Example Code WAVE_POINTS Specifies the number of points to be transferred using the WAVEFORM DATA query myScope W...

Page 1012: ...imum amount of points is used Usually this is the raw acquisition record But the measurement record may have more data If data is being retrieved as the oscilloscope is stopped and as the data display...

Page 1013: ...L points_mode NORMal MAXimum RAW See Also Introduction to WAVeform Commands on page 1000 WAVeform DATA on page 1007 ACQuire POINts ANALog on page 232 WAVeform VIEW on page 1028 WAVeform PREamble on pa...

Page 1014: ...erence 32 bit NR1 yincrement 32 bit floating point NR3 yorigin 32 bit floating point NR3 yreference 32 bit NR1 format 0 for BYTE format 1 for WORD format 4 for ASCii format an integer in NR1 format fo...

Page 1015: ...umber of data points transferred COUNT int32 1 and is always 1 XINCREMENT float64 time difference between data points XORIGIN float64 always the first data point in memory XREFERENCE int32 specifies t...

Page 1016: ...Programmer s Guide 30 WAVeform Commands dblXOrigin Preamble 5 lngXReference Preamble 6 sngYIncrement Preamble 7 sngYOrigin Preamble 8 lngYReference Preamble 9 See complete example programs at Chapter...

Page 1017: ...e performance improvement comes primarily when raw acquisition record data is being retrieved WAVeform POINts MODE RAW instead of the measurement record data WAVeform POINts MODE NORMal One corner cas...

Page 1018: ...until the full segmented acquisition is complete The segmented memory acquisition mode is enabled with the ACQuire MODE command The number of segments to acquire is set using the ACQuire SEGMented COU...

Page 1019: ...EGMented TTAG The WAVeform SEGMented TTAG query returns the time tag of the currently selected segmented memory index The index is selected using the ACQuire SEGMented INDex command Return Format time...

Page 1020: ...the value returned by the WAVeform XORigin query is returned TTAG The time tag for each segment the value returned by the WAVeform SEGMented TTAG query will be returned ABSXorigin The sum of the valu...

Page 1021: ...e WAVeform SOURce is the serial decode bus SBUS1 or SBUS2 ASCii is the only waveform format allowed and the WAVeform DATA query returns a string with timestamps and associated bus decode information Q...

Page 1022: ...T WORD lngVSteps 65536 intBytesPerData 2 Data in range 0 to 255 myScope WriteString WAVEFORM FORMAT BYTE lngVSteps 256 intBytesPerData 1 GET_PREAMBLE The preamble block contains all of the current WAV...

Page 1023: ...crement _ FormatNumber sngYIncrement 1000 mV vbCrLf strOutput strOutput Y origin _ FormatNumber sngYOrigin V vbCrLf strOutput strOutput Y reference _ CStr lngYReference vbCrLf strOutput strOutput Volt...

Page 1024: ...o 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 l...

Page 1025: ...RX is an alias for SUB0 When using SPI serial decode this option lets you get MISO data MISO is an alias for SUB1 The default SUB0 specifies MOSI data MOSI is an alias for SUB0 When using SENT serial...

Page 1026: ...sociated with the currently selected waveform The acquisition mode is set by the ACQuire TYPE command Return Format mode NL mode NORM PEAK AVER HRES See Also Introduction to WAVeform Commands on page...

Page 1027: ...as unsigned or signed integers This command can be used to match the instrument s internal data type to the data type used by the programming language This command has no effect if the data format is...

Page 1028: ...ALL Available only when Digitizer mode is on see ACQuire DIGitizer this view specifies all the captured data which may extend beyound the edges of the oscilloscope s main waveform display area depend...

Page 1029: ...t query returns the x increment value for the currently specified source This value is the time difference between consecutive data points in seconds Return Format value NL value x increment in the cu...

Page 1030: ...XORigin is the X axis value of the data point specified by the WAVeform XREFerence value In this product that is always the X axis value of the first data point XREFerence 0 Return Format value NL val...

Page 1031: ...ly 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...

Page 1032: ...ery returns the y increment value in volts for the currently specified source This value is the voltage difference between consecutive data values Return Format value NL value y increment value in the...

Page 1033: ...d source This value is the Y axis value of the data value specified by the WAVeform YREFerence value For this product this is the Y axis value of the center of the screen Return Format value NL value...

Page 1034: ...ed source This value specifies the data point value where the y origin occurs In this product this is the data point value of the center of the screen It is undefined if the format is ASCii Return For...

Page 1035: ...nd Query Options and Query Returns WGEN w ARBitrary BY Teorder order see page 1040 WGEN w ARBitrary BY Teorder see page 1040 order MSBFirst LSBFirst w 1 to WaveGen outputs in NR1 format WGEN w ARBitra...

Page 1036: ...FUNCtion m FFT MATH m n 1 to analog channels in NR1 format r 1 to ref waveforms in NR1 format m 1 to math functions in NR1 format w 1 to WaveGen outputs in NR1 format WGEN w FREQuency frequency see p...

Page 1037: ...uency see page 1059 WGEN w MODulation F M DEViation see page 1059 frequency frequency deviation in Hz in NR3 format w 1 in NR1 format WGEN w MODulation F M FREQuency frequency see page 1060 WGEN w MOD...

Page 1038: ...WGEN w OUTPut MODE mode see page 1071 WGEN w OUTPut MODE see page 1071 mode NORMal SINGle WGEN w OUTPut POLar ity polarity see page 1072 WGEN w OUTPut POLar ity see page 1072 polarity NORMal INVerted...

Page 1039: ...llowing is a sample response from the WGEN query In this case the query was issued following the RST command WGEN1 FUNC SIN OUTP 0 FREQ 1 0000E 03 VOLT 500 0E 03 VOLT OFFS 0 0E 00 WGEN1 OUTP LOAD ONEM...

Page 1040: ...veGen outputs in NR1 format order MSBFirst LSBFirst The WGEN w ARBitrary BYTeorder command selects the byte order for binary transfers Query Syntax WGEN w ARBitrary BYTeorder The WGEN w ARBitrary BYTe...

Page 1041: ...plicit Public myMgr As VisaComLib ResourceManager Public myScope As VisaComLib FormattedIO488 Public varQueryResult As Variant Public strQueryResult As String Private Declare Sub Sleep Lib kernel32 By...

Page 1042: ...strQueryResult myScope ReadString Debug Print WaveGen1 byte order for binary data strQueryResult DefaultArbitraryWaveform Download binary floating point values Dim mySingleArray 8 As Single mySingleA...

Page 1043: ...6 bit integer DAC values downloaded Sleep 5000 Exit Sub VisaComError MsgBox VISA COM Error vbCrLf Err Description End Sub Initialize WaveGen1 to a known state Private Sub DefaultArbitraryWaveform On E...

Page 1044: ...TTRibute POINts w 1 to WaveGen outputs in NR1 format The WGEN w ARBitrary DATA ATTRibute POINts query returns the number of points used by the current arbitrary waveform Return Format points number of...

Page 1045: ...ry DATA CLEar w 1 to WaveGen outputs in NR1 format The WGEN w ARBitrary DATA CLEar command clears the arbitrary waveform memory and loads it with the default waveform See Also WGEN w ARBitrary DATA on...

Page 1046: ...binary decimal 16 bit integer values between 512 to 511 in IEEE 488 2 binary block format value decimal integer values between 512 to 511 in comma separated NR1 format The WGEN w ARBitrary DATA DAC co...

Page 1047: ...ry waveform points When ON lines are drawn between points in the arbitrary waveform Voltage levels change linearly between one point and the next When OFF all line segments in the arbitrary waveform a...

Page 1048: ...source CHANnel n WMEMory r FUNCtion m MATH m n 1 to analog channels in NR1 format r 1 to ref waveforms in NR1 format m 1 to math functions in NR1 format The WGEN w ARBitrary STORe command stores the s...

Page 1049: ...xcept Noise and DC the WGEN w FREQuency command specifies the frequency of the waveform You can also specify the frequency indirectly using the WGEN w PERiod command Query Syntax WGEN w FREQuency The...

Page 1050: ...nds to set the sine signal parameters WGEN w FREQuency on page 1049 WGEN w PERiod on page 1074 WGEN w VOLTage on page 1076 WGEN w VOLTage OFFSet on page 1079 WGEN w VOLTage HIGH on page 1077 WGEN w VO...

Page 1051: ...the pulse signal parameters WGEN w FREQuency on page 1049 WGEN w PERiod on page 1074 WGEN w VOLTage on page 1076 WGEN w VOLTage OFFSet on page 1079 WGEN w VOLTage HIGH on page 1077 WGEN w VOLTage LOW...

Page 1052: ...OLTage HIGH on page 1077 WGEN w VOLTage LOW on page 1078 100 mHz to 5 MHz 20 mVpp to 10 Vpp 5 00 V EXPFall Use these commands to set the exponential fall signal parameters WGEN w FREQuency on page 104...

Page 1053: ...page 1076 WGEN w VOLTage OFFSet on page 1079 100 mHz to 5 MHz 20 mVpp to 7 5 Vpp 2 50 V ARBitrary Use these commands to set the arbitrary signal parameters WGEN w FREQuency on page 1049 WGEN w PERiod...

Page 1054: ...in NR3 format For Pulse waveforms the WGEN w FUNCtion PULSe WIDTh command specifies the width of the pulse The pulse width can be adjusted from 20 ns to the period minus 20 ns Query Syntax WGEN w FUNC...

Page 1055: ...at For Ramp waveforms the WGEN w FUNCtion RAMP SYMMetry command specifies the symmetry of the waveform Symmetry represents the amount of time per cycle that the ramp waveform is rising Query Syntax WG...

Page 1056: ...rmat For Square waveforms the WGEN w FUNCtion SQUare DCYCle command specifies the square wave duty cycle Duty cycle is the percentage of the period that the waveform is high Query Syntax WGEN w FUNCti...

Page 1057: ...o 90 90 10 80 of the original amplitude as the modulating signal goes from its minimum to maximum amplitude Query Syntax WGEN w MODulation AM DEPTh The WGEN w MODulation AM DEPTh query returns the AM...

Page 1058: ...on AM FREQuency The WGEN w MODulation AM FREQuency query returns the frequency of the modulating signal Return Format frequency NL frequency modulating waveform frequency in Hz in NR3 format See Also...

Page 1059: ...y deviation cannot be greater than the original carrier signal frequency Also the sum of the original carrier signal frequency and the frequency deviation must be less than or equal to the maximum fre...

Page 1060: ...on FM FREQuency The WGEN w MODulation FM FREQuency query returns the frequency of the modulating signal Return Format frequency NL frequency modulating waveform frequency in Hz in NR3 format See Also...

Page 1061: ...s hop frequency Query Syntax WGEN w MODulation FSKey FREQuency The WGEN w MODulation FSKey FREQuency query returns the hop frequency setting Return Format frequency NL frequency hop frequency in Hz in...

Page 1062: ...lating signal Query Syntax WGEN w MODulation FSKey RATE The WGEN w MODulation FSKey RATE query returns the FSK rate setting Return Format rate NL rate FSK modulation rate in Hz in NR3 format See Also...

Page 1063: ...command This command applies to AM and FM modulation The FSK modulation signal is a square wave shape Query Syntax WGEN w MODulation FUNCtion The WGEN w MODulation FUNCtion query returns the specified...

Page 1064: ...th the WGEN w MODulation FUNCtion command Query Syntax WGEN w MODulation FUNCtion RAMP SYMMetry The WGEN w MODulation FUNCtion RAMP SYMMetry query returns ramp symmetry percentage setting Return Forma...

Page 1065: ...limited to the regular amplitude limit for example 5 Vpp in 1 MOhm so the range for percent varies according to current amplitude Note that adding noise affects edge triggering on the waveform genera...

Page 1066: ...se Query Syntax WGEN w MODulation STATe The WGEN w MODulation STATe query returns whether the modulated waveform generator output is enabled of disabled Return Format setting NL setting 0 1 See Also W...

Page 1067: ...MODulation FM FREQuency command to set the modulating signal frequency Use the WGEN w MODulation FM DEViation command to specify the frequency deviation from the original carrier signal frequency FSK...

Page 1068: ...mmer s Guide 31 WGEN w Commands WGEN w MODulation FSKey FREQuency on page 1061 WGEN w MODulation FSKey RATE on page 1062 WGEN w MODulation FUNCtion on page 1063 WGEN w MODulation FUNCtion RAMP SYMMetr...

Page 1069: ...o WaveGen outputs in NR1 format on_off 1 ON 0 OFF The WGEN w OUTPut command specifies whether the waveform generator signal output is ON 1 or OFF 0 Query Syntax WGEN w OUTPut The WGEN w OUTPut query r...

Page 1070: ...of the Gen Out BNC is fixed at 50 ohms However the output load selection lets the waveform generator display the correct amplitude and offset levels for the expected output load If the actual load imp...

Page 1071: ...aveform is output continuously or as a single cycle single shot NORMal the defined waveform is output continuously SINGle one cycle of the defined waveform is output when you send the WGEN w OUTPut SI...

Page 1072: ...ty w 1 to WaveGen outputs in NR1 format polarity NORMal INVerted The WGEN w OUTPut POLarity command specifies whether the waveform generator output is inverted Query Syntax WGEN w OUTPut POLarity The...

Page 1073: ...WGEN w OUTPut SINGle When the single shot output mode is selected by the WGEN w OUTPut MODE command the WGEN w OUTPut SINGle command causes a single cycle of the defined waveform to be output Sending...

Page 1074: ...except Noise and DC the WGEN w PERiod command specifies the period of the waveform You can also specify the period indirectly using the WGEN w FREQuency command Query Syntax WGEN w PERiod The WGEN w...

Page 1075: ...age 1196 Command Syntax WGEN w RST w 1 to WaveGen outputs in NR1 format The WGEN w RST command restores the waveform generator factory default settings 1 kHz sine wave 500 mVpp 0 V offset See Also Int...

Page 1076: ...and offset indirectly using the WGEN w VOLTage HIGH and WGEN w VOLTage LOW commands For example an amplitude of 5 V and an offset of 1 V is the same as a high level voltage of 4 V and a low level volt...

Page 1077: ...ow level voltages indirectly using the WGEN w VOLTage and WGEN w VOLTage OFFSet commands For example a high level voltage of 4 V and a low level voltage of 1 V is the same as an amplitude of 5 V and a...

Page 1078: ...ow level voltages indirectly using the WGEN w VOLTage and WGEN w VOLTage OFFSet commands For example a high level voltage of 4 V and a low level voltage of 1 V is the same as an amplitude of 5 V and a...

Page 1079: ...indirectly using the WGEN w VOLTage HIGH and WGEN w VOLTage LOW commands For example an amplitude of 5 V and an offset of 1 V is the same as a high level voltage of 4 V and a low level voltage of 1 V...

Page 1080: ...1080 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 31 WGEN w Commands...

Page 1081: ...Mory r LABel string see page 1085 WMEMory r LABel see page 1085 r 1 to ref waveforms in NR1 format string any series of 10 or less ASCII characters enclosed in quotation marks WMEMory r SAVE source se...

Page 1082: ...fix V mV WMEMory r YRANge range suffix see page 1089 WMEMory r YRANge see page 1089 r 1 to ref waveforms in NR1 format range vertical full scale range value in NR3 format suffix V mV WMEMory r YSCale...

Page 1083: ...EMory r CLEar see page 1196 Command Syntax WMEMory r CLEar r 1 to ref waveforms in NR1 format The WMEMory r CLEar command clears the specified reference waveform location See Also Chapter 32 WMEMory r...

Page 1084: ...off There are two reference waveform locations but only one reference waveform can be displayed at a time That means if WMEMory1 DISPlay is ON sending the WMEMory2 DISPlay ON command will automaticall...

Page 1085: ...name to the label list in non volatile memory replacing the oldest label in the list Query Syntax WMEMory r LABel The WMEMory r LABel query returns the label associated with a particular reference wav...

Page 1086: ...nd copies the analog channel or math function waveform to the specified reference waveform location Reference waveforms are limited to 64K points If necessary decimation of the source waveform will oc...

Page 1087: ...r SKEW command sets the skew factor for the specified reference waveform Query Syntax WMEMory r SKEW The WMEMory r SKEW query returns the current skew setting for the selected reference waveform Retur...

Page 1088: ...ue set by the WMEMory r YRANge or WMEMory r YSCale commands If you set the offset to a value outside of the legal range the offset value is automatically set to the nearest legal value Legal values ar...

Page 1089: ...al values for the range are copied from the original source waveform that is the analog channel or math function waveform that was originally saved as a reference waveform Query Syntax WMEMory r YRANg...

Page 1090: ...veform Legal values for the scale are copied from the original source waveform that is the analog channel or math function waveform that was originally saved as a reference waveform Query Syntax WMEMo...

Page 1091: ...ee page 260 ANALog n COUPling CHANnel n COUPling see page 261 ANALog n INVert CHANnel n INVert see page 264 ANALog n LABel CHANnel n LABel see page 265 ANALog n OFFSet CHANnel n OFFSet see page 266 AN...

Page 1092: ...FUNCtion1 SOURce2 see page 384 GOFT maps to FUNCtion1 FUNCtion SOURce see page 1106 FUNCtion SOURce1 see page 382 Obsolete command has ADD SUBTract and MULTiply parameters current command has GOFT pa...

Page 1093: ...7 With MEASure YATX there is a command for installing the measurement on the oscilloscope s display MEASure VTIMe had no command only a query MTESt AMASk SAVE STORe see page 1122 SAVE MASK STARt see p...

Page 1094: ...Finitio n see page 1131 none SYSTem MENU see page 1132 DISPlay MENU see page 312 No change in behavior TRIGger TV TVMode see page 1134 TRIGger TV MODE see page 982 Obsolete Command Current Command Equ...

Page 1095: ...ed MASK none All commands discontinued feature not available SYSTem KEY none TEST ALL TST Self Test see page 181 TRACE subsystem none All commands discontinued feature not available TRIGger ADVanced s...

Page 1096: ...el command sets the source text to the string that follows Setting a channel will also result in the name being added to the label list Query Syntax CHANnel LABel The CHANnel LABel query returns the l...

Page 1097: ...nalog probe skew control to remove cable delay errors between channel 1 and channel 2 Query Syntax CHANnel2 SKEW The CHANnel2 SKEW query returns the current probe skew setting for the selected channel...

Page 1098: ...s the input impedance setting for the specified channel The legal values for this command are ONEMeg 1 M and FIFTy 50 Query Syntax CHANnel n INPut The CHANnel n INPut query returns the current input i...

Page 1099: ...e 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 se...

Page 1100: ...on the oscilloscope displays lines connecting sampled data points When vectors are turned off only the sampled data is displayed Query Syntax DISPlay CONNect The DISPlay CONNect query returns the curr...

Page 1101: ...loscopes SCPI Programmer s Guide 1101 ERASe see page 1196 Command Syntax ERASe The ERASe command erases the screen NOTE The ERASe command is an obsolete command provided for compatibility to previous...

Page 1102: ...nnected 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 err...

Page 1103: ...Ration operation operation ADD SUBTract MULTiply The FUNCtion GOFT OPERation command sets the math operation for the g t source that can be used as the input to transform or filter functions if availa...

Page 1104: ...s the first input channel for the g t source that can be used as the input to transform or filter functions if available Query Syntax FUNCtion GOFT SOURce1 The FUNCtion GOFT SOURce1 query returns the...

Page 1105: ...ects the second input channel for the g t source that can be used as the input to transform or filter functions if available Query Syntax FUNCtion GOFT SOURce2 The FUNCtion GOFT SOURce2 query returns...

Page 1106: ...and selects the source for function operations Choose CHANnel n or ADD SUBT or MULT to specify the desired source for function DIFF differentiate INTegrate and FFT operations specified by the FUNCtion...

Page 1107: ...off When ON is selected the function performs as specified using the other FUNCtion commands When OFF is selected function is neither calculated nor displayed Query Syntax FUNCtion VIEW The FUNCtion V...

Page 1108: ...he thresholds are PERCent as defined by the MEASure DEFine THResholds command Query Syntax MEASure LOWer The MEASure LOWer query returns the current lower threshold level Return Format voltage NL volt...

Page 1109: ...e SCRatch see page 1196 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 prov...

Page 1110: ...query is received by the oscilloscope The delta time value that is output is the current value This is the same value as the front panel cursors delta X value Return Format value NL value time differe...

Page 1111: ...hen making time measurements Return Format T1090 T2080 VOLTage NL T1090 uses the 10 and 90 levels of the selected waveform T2080 uses the 20 and 80 levels of the selected waveform VOLTage uses the upp...

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

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

Page 1114: ...at the start marker in NR3 format See Also Introduction to MARKer Commands on page 397 Introduction to MEASure Commands on page 432 MARKer X1Position on page 401 MARKer X2Position on page 404 MARKer...

Page 1115: ...the stop marker in NR3 format See Also Introduction to MARKer Commands on page 397 Introduction to MEASure Commands on page 432 MARKer X1Position on page 401 MARKer X2Position on page 404 MARKer XDEL...

Page 1116: ...voltage use a minus sign The sign of the slope selects a rising or falling edge If no sign is specified for the slope it is assumed to be the rising edge The magnitude of the occurrence defines the oc...

Page 1117: ...when the thresholds are PERCent as defined by the MEASure DEFine THResholds command Query Syntax MEASure UPPer The MEASure UPPer query returns the current upper threshold level Return Format value NL...

Page 1118: ...returned is the current value This is the same value as the front panel cursors delta Y value VDELta value at marker 2 value at marker 1 Return Format value NL value delta V value in NR1 format See Al...

Page 1119: ...voltage marker 1 in NR3 format See Also Introduction to MARKer Commands on page 397 Introduction to MEASure Commands on page 432 MARKer Y1Position on page 410 MARKer Y2Position on page 412 MARKer YDEL...

Page 1120: ...2 cursor in NR3 format See Also Introduction to MARKer Commands on page 397 Introduction to MEASure Commands on page 432 MARKer Y1Position on page 410 MARKer Y2Position on page 412 MARKer YDELta on pa...

Page 1121: ...e at a specified horizontal value on the source specified see also MEASure SOURce The specified horizontal value must be on the screen when it is a time value it is referenced to the trigger event If...

Page 1122: ...ot been generated an error occurs The filename parameter is an MS DOS compatible name of the file a maximum of 254 characters long including the path name if used The filename assumes the present work...

Page 1123: ...t and averages them When OFF averaging is disabled To set the number of averages use the MTESt AVERage COUNt command described next Query Syntax MTESt AVERage The MTESt AVERage query returns the curre...

Page 1124: ...nd specifies the number of data values to be averaged for each time bucket before the acquisition is considered complete for that time bucket Query Syntax MTESt AVERage COUNt The MTESt AVERage COUNt q...

Page 1125: ...ecified mask file The filename parameter is an MS DOS compatible name of the file a maximum of 254 characters long including the path name if used See Also Introduction to MTESt Commands on page 501 M...

Page 1126: ...arameter is a real number from 1 to 86400 seconds WAVeforms sets the maximum number of waveforms that are required before the mask test terminates The wfm_count parameter indicates the number of wavef...

Page 1127: ...n and a mask violation is detected the mask test is stopped and the acquisition system is stopped Query Syntax MTESt RUMode SOFailure The MTESt RUMode SOFailure query returns the current state of the...

Page 1128: ...Syntax MTESt STARt STOP The MTESt STARt STOP command starts or stops the acquisition system See Also Introduction to MTESt Commands on page 501 NOTE The MTESt STARt and MTESt STOP commands are obsolet...

Page 1129: ...SOURce command sets the channel to use as the trigger Query Syntax MTESt TRIGger SOURce The MTESt TRIGger SOURce query returns the currently selected trigger source Return Format source CHAN n n 1 to...

Page 1130: ...age area When saving images this query returns SCR screen When saving setups or waveform data this query returns GRAT graticule even though graticule images are not saved Return Format area NL area GR...

Page 1131: ...w 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 Query Syntax SBUS n LIN SIGNal DEFinition T...

Page 1132: ...lloscopes SCPI Programmer s Guide 33 Obsolete and Discontinued Commands SYSTem MENU see page 1196 Command Syntax SYSTem MENU menu menu MASK MEASure SEGMented LISTer POWer The SYSTem MENU command chang...

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

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

Page 1135: ...rogrammer s Guide 34 Error Messages 440 Query UNTERMINATED after indefinite response 430 Query DEADLOCKED 420 Query UNTERMINATED 410 Query INTERRUPTED 400 Query error 340 Calibration failed 330 Self t...

Page 1136: ...mory lost 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 re...

Page 1137: ...rectory 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...

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

Page 1139: ...r 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 1...

Page 1140: ...Messages 109 Missing parameter 108 Parameter not allowed 105 GET not allowed 104 Data type error 103 Invalid separator 102 Syntax error 101 Invalid character 100 Command error 10 Software Fault Occur...

Page 1141: ...Initialization Failed 107 Invalid Trace File 108 Compression Error 109 No Data For Operation A remote operation wants some information but there is no information available For example you may reques...

Page 1142: ...1142 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 34 Error Messages...

Page 1143: ...ter CONDition 1163 Mask Test Event Event Register MTERegister EVENt 1164 Clearing Registers and Queues 1165 Status Reporting Decision Chart 1166 Example Checking for Armed Status 1167 IEEE 488 2 defin...

Page 1144: ...nabled bit in the event register is set The events are enabled with the corresponding event enable register Events captured by an event register remain set until the register is read or cleared Regist...

Page 1145: ...tion Register HWEenable HWEenable Hardware Event Enable MASK Register HWERegister EVENt Hardware Event Event Register MTEenable MTEenable Mask Test Event Enable MASK Register MTERegister EVENt Mask Te...

Page 1146: ...ER TRG MAV ESB RQS MSS TRG Reg TER Trigger Event Register SRE SRE Service Request Enable Mask Register STB Status Byte Register Outp ut Queue SRQ ESR Standard Event Status Register ESE ESE Standard Ev...

Page 1147: ...the bits must be enabled These bits are enabled by using the ESE common command to set the corresponding bit in the Standard Event Status Enable Register To generate a service request SRQ interrupt t...

Page 1148: ...interrupt The value returned is the total bit weights of all of the bits that are set at the present time The use of bit 6 can be confusing This bit was defined to cover all possible computer interfa...

Page 1149: ...s Status Byte Register varQueryResult myScope IO ReadSTB MsgBox Status Byte Register Serial Poll 0x Hex varQueryResult See Also STB Read Status Byte on page 178 NOTE Use Serial Polling to Read Status...

Page 1150: ...and the bits that are set are read with the SRE query Example The following example sets bit 4 MAV and bit 5 ESB in the Service Request Enable Register myScope WriteString SRE CStr CInt H30 This exam...

Page 1151: ...vent 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...

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

Page 1153: ...ge 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 s...

Page 1154: ...s Enable Register the bits set in this register generate a summary bit to set bit 5 ESB in the Status Byte Register You can read the contents of the Standard Event Status Register and clear the regist...

Page 1155: ...any of these bits to generate the summary bit by sending myScope WriteString ESE CStr CInt H3C Whenever an error occurs it sets one of these bits in the Standard Event Status Register Because all the...

Page 1156: ...discarded The length of the oscilloscope s error queue is 30 29 positions for the error messages and 1 position for the Queue overflow message The error queue is read with the SYSTem ERRor query Execu...

Page 1157: ...urned The status model is the only part of the remote user interface that is enabled To determine when the remote interface is re enabled you can read this bit or wait for the event that gets generate...

Page 1158: ...et the OPER bit bit 7 of the Status Byte Register is set The Operation Status Event Register is read and cleared with the OPERegister EVENt query The register output is enabled or disabled using the m...

Page 1159: ...or queries are accepted but settings conflict errors are returned The status model is the only part of the remote user interface that is enabled To determine when the remote interface is re enabled y...

Page 1160: ...rmed 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 regist...

Page 1161: ...d has occurred on Channel 2 input Channel 3 OVL bit 2 Overload has occurred on Channel 3 input Channel 4 OVL bit 3 Overload has occurred on Channel 4 input External Trigger OVL bit 4 Overload has occu...

Page 1162: ...35 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 See...

Page 1163: ...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 interna...

Page 1164: ...returns the value of and clears the Mask Test Event Event Register See Also MTERegister EVENt Mask Test Event Event Register on page 201 Name Location Description Complete bit 0 Is set when the mask t...

Page 1165: ...mer s Guide 1165 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 th...

Page 1166: ...r and send an SRQ to the computer If events are monitored by the Standard Event Status Register also enable ESB with the SRE command Activate the instrument function that you want to monitor When an i...

Page 1167: ...OBAL_TOUT 20000 IO timeout in milliseconds Method 1 Query the Armed Event Register with AER This method reads the 1 bit Armed Event Register using the AER query The Armed Event Register bit goes low 0...

Page 1168: ...s Byte bits CAUTION The oscilloscope s status registers are not updated until the DIGitize completes So while the ARM may go true midway through the DIGitize it does not get reported to the status mod...

Page 1169: ...ister with OPER This method reads the Operation Status Event Register s Wait Trig bit bit 5 using the OPER query The Operation Status Event Register bits are cleared 0 when the register is read Also t...

Page 1170: ...TATUS STATUS_REGISTER ARM_MASK print Oscilloscope is armed method 3 using OPER query print It took str time clock now seconds to arm n Main Connect and initialize oscilloscope Define VISA Resource Man...

Page 1171: ...s to arm KsInfiniiVisionX write TIMebase RANGe 10 Prevent Auto trigger KsInfiniiVisionX write TRIGger SWEep NORMal Use the three methods to check whether the oscilloscope is armed method_1 method_2 me...

Page 1172: ...plete using OPER query This method reads the Operation Status Register s IOC bit bit 13 using the OPER query The Operation Status Event Register bits are cleared 0 when the register is read All status...

Page 1173: ...anager Install directory rm visa ResourceManager C Windows System32 agvisa32 dll Define and open the oscilloscope using the VISA address KsInfiniiVisionX rm open_resource VISA_ADDRESS Set the Global T...

Page 1174: ...ht P9241 42 43A Oscilloscopes SCPI Programmer s Guide 35 Status Reporting End of Script KsInfiniiVisionX clear Clear communications interface KsInfiniiVisionX close Close communications interface prin...

Page 1175: ...ling an oscilloscope with programming commands it is often necessary to know when the oscilloscope has finished the previous operation and is ready for the next command The most common example is when...

Page 1176: ...Results Once the acquisition is complete it is safe to retrieve measurements and statistics NOTE It is not necessary to use OPC hard coded waits or status checking when setting up the oscilloscope Aft...

Page 1177: ...n On Error GoTo VisaComError Create the VISA COM I O resource Set myMgr New VisaComLib ResourceManager Set myScope New VisaComLib FormattedIO488 Set myScope IO myMgr Open TCPIP0 130 29 69 12 inst0 INS...

Page 1178: ...ResourceManager Set myScope New VisaComLib FormattedIO488 Set myScope IO myMgr Open TCPIP0 130 29 69 12 inst0 INSTR myScope IO Clear Clear the interface Set up Set up the trigger and horizontal scale...

Page 1179: ...Small wait to prevent excessive queries lngElapsed lngElapsed 100 End If Loop Get results If lngElapsed lngTimeout Then myScope WriteString MEASure RISetime myScope WriteString MEASure RISetime varQue...

Page 1180: ...aComLib ResourceManager Public myScope As VisaComLib FormattedIO488 Public varQueryResult As Variant Public strQueryResult As String Private Declare Sub Sleep Lib kernel32 ByVal dwMilliseconds As Long...

Page 1181: ...o wait for single shot Dim lngElapsed As Long lngTimeout 10000 10 seconds lngElapsed 0 Do While lngElapsed lngTimeout myScope WriteString OPERegister CONDition varQueryResult myScope ReadNumber Mask R...

Page 1182: ...riant Public strQueryResult As String Private Declare Sub Sleep Lib kernel32 ByVal dwMilliseconds As Long Sub Main On Error GoTo VisaComError Create the VISA COM I O resource Set myMgr New VisaComLib...

Page 1183: ...TB from Standard Event Status register ESR is set STB can be read during DIGitize without generating a timeout Do Sleep 4000 Poll more often than the timeout setting varQueryResult myScope IO ReadSTB...

Page 1184: ...n setup it cannot know when a trigger event will occur Thus you must still set this value This time is in addition to the calculated minimum timeout so if an oscilloscope might take say 1 us to arm an...

Page 1185: ...ition times than with a polling method Works best for segmented memory if any post processing is done on the oscilloscope for example measurements lister math as this does not come back until the proc...

Page 1186: ...C print Signal acquired n The Signal acquired message will be written after the acquisition and processing is complete The OPC query is appended to DIGitize with a semi colon which essentially ties it...

Page 1187: ...one print Signal acquired Reset timeout back to what it was GLOBAL_TOUT KsInfiniiVisionX timeout GLOBAL_TOUT Catch a possible timeout and exit except Exception print The acquisition timed out most li...

Page 1188: ...done At least 200 ms is suggested more may be required However as long as the timeout is not excessively short the math happens fast enough that once OPERegister CONDition comes back as done that one...

Page 1189: ...The Condition register reflects the CURRENT state while the EVENT register reflects the first event that occurred since it was cleared or read as in has it EVER happened thus the CONDITION register is...

Page 1190: ...te CLS SINGle Initialize the loop entry condition assume Acq is not done Acq_State ACQ_NOT_DONE Poll the oscilloscope until Acq_State is a one This is NOT a Serial Poll while Acq_State ACQ_NOT_DONE an...

Page 1191: ...Q_DONE Acquisition fully completed print Signal acquired else Acquisition failed for some reason print Max wait time exceeded print This happens if there was no trigger event print Adjust settings acc...

Page 1192: ...OP OPC For this example the oscilloscope will be forced to trigger on the AC input power LINE voltage so something happens Always use normal trigger sweep never auto KsInfiniiVisionX write TRIGger SWE...

Page 1193: ...IME_OUT 10000 0 What about Equivalent Time Mode and other odd modes such as Jitter or Eye the last two only being found on the 6000 X Series and math functions In most cases the padding and 10 second...

Page 1194: ...iniiVisionX clear KsInfiniiVisionX query STOP OPC KsInfiniiVisionX write SYSTem LOCK OFF KsInfiniiVisionX clear KsInfiniiVisionX close sys exit User Interupt Properly closing oscilloscope and aborting...

Page 1195: ...1195 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 37 More About Oscilloscope Commands Command Classifications 1196 Valid Command Query Strings 1197 Query Return Values 1203...

Page 1196: ...ods are employed Non Core Commands Non core commands are commands that provide specific features but are not universal across all Keysight InfiniiVision oscilloscope models Non core commands may be mo...

Page 1197: ...arameter is not meant to be expressed as a string is when the instruction s syntax definition specifies block data such as learn string There are only a few instructions that use block data Program me...

Page 1198: ...Data Syntax Rules on page 1200 describes all of the general rules about acceptable values When there is more than one data parameter they are separated by commas Spaces can be added around the commas...

Page 1199: ...be included with the simple command header for example DIGitize CHANnel1 white space is added to separate the data from the header The syntax is program mnemonic separator program data terminator Com...

Page 1200: ...acter program data are always included with the command s syntax definition When sending commands you may either the long form or short form if one exists Uppercase and lowercase letters may be mixed...

Page 1201: ...the tree A leading colon NL or EOI true on the last byte places the parser at the root of the command tree A leading colon is a colon that is the first character of a program header Executing a subsy...

Page 1202: ...riteString TIMebase REFerence CENTer DISPlay VECTors ON Multiple commands may be any combination of compound and simple commands NOTE The colon between TIMebase and RANGe is necessary because TIMebase...

Page 1203: ...the designated listener typically a controller For example the query TIMebase RANGe places the current time base setting in the output queue When using the Keysight VISA COM library in Visual Basic t...

Page 1204: ...1204 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 37 More About Oscilloscope Commands...

Page 1205: ...Examples 1292 SCPI NET Examples 1312 The example programs in this manual are ASCII text files that can be cut from the help file and pasted into your favorite text editor See Also You can find additio...

Page 1206: ...ht VISA COM library a Choose Tools References from the main menu b In the References dialog check the VISA COM 5 5 Type Library c Click OK 4 Choose Insert Module 5 Cut and paste the code that follows...

Page 1207: ...Initialize start from a known state Initialize Capture data Capture Analyze the captured waveform Analyze Exit Sub VisaComError MsgBox VISA COM Error vbCrLf Err Description End End Sub Initialize the...

Page 1208: ...ng TRIGger EDGE SLOPe Save oscilloscope configuration varQueryResult DoQueryIEEEBlock_UI1 SYSTem SETup Output setup string to a file Dim strPath As String strPath c scope config setup dat Dim hFile As...

Page 1209: ...and DoCommandIEEEBlock SYSTem SETup varSetupString Debug Print Setup bytes restored CStr LenB varSetupString Capture an acquisition using DIGitize DoCommand DIGitize CHANnel1 Exit Sub VisaComError Msg...

Page 1210: ...the waveform points mode DoCommand WAVeform POINts MODE RAW Debug Print Waveform points mode _ DoQueryString WAVeform POINts MODE Get the number of waveform points available Debug Print Waveform poin...

Page 1211: ...ion type NORMal ElseIf intType 1 Then Debug Print Acquisition type PEAK ElseIf intType 2 Then Debug Print Acquisition type AVERage ElseIf intType 3 Then Debug Print Acquisition type HRESolution End If...

Page 1212: ...alue Print hFile _ FormatNumber dblXOrigin lngI dblXIncrement 9 _ _ FormatNumber lngDataValue lngYReference _ sngYIncrement sngYOrigin Next lngI Close output file Close hFile Close file MsgBox Wavefor...

Page 1213: ...pe WriteString query DoQueryString myScope ReadString CheckInstrumentErrors Exit Function VisaComError MsgBox VISA COM Error vbCrLf CStr Err Number _ Err Source _ Err Description vbExclamation VISA CO...

Page 1214: ...Type_UI1 CheckInstrumentErrors Exit Function VisaComError MsgBox VISA COM Error vbCrLf CStr Err Number _ Err Source _ Err Description vbExclamation VISA COM Error End End Function Private Sub CheckIns...

Page 1215: ...u wish to modify not the solution in the Solution Explorer window of the Microsoft Visual Studio environment b Choose Add Reference c In the Add Reference dialog select the COM tab d Select VISA COM 5...

Page 1216: ...ine System Error Message err Message catch System Exception err System Diagnostics Debug Fail Unexpected Error Console WriteLine Unexpected Error err Message finally myScope Close Initialize the oscil...

Page 1217: ...t string strPath Query and read setup string ResultsArray myScope DoQueryIEEEBlock SYSTem SETup nLength ResultsArray Length Write setup string to file strPath c scope config setup stp FileStream fStre...

Page 1218: ...captured waveform private static void Analyze byte ResultsArray Results array int nLength Number of bytes returned from instrument string strPath Make a couple of measurements myScope DoCommand MEASu...

Page 1219: ...et the waveform source myScope DoCommand WAVeform SOURce CHANnel1 Console WriteLine Waveform source 0 myScope DoQueryString WAVeform SOURce Choose the format of the data returned WORD BYTE ASCII mySco...

Page 1220: ...t fResultsArray 7 Console WriteLine Waveform Y increment 0 e fYincrement double fYorigin fResultsArray 8 Console WriteLine Waveform Y origin 0 e fYorigin double fYreference fResultsArray 9 Console Wri...

Page 1221: ...mmand string strCommand Send the command m_IoObject WriteString strCommand true Check for inst errors CheckInstrumentErrors strCommand public void DoCommandIEEEBlock string strCommand byte DataArray S...

Page 1222: ...double m_IoObject ReadList IEEEASCIIType ASCIIType_R8 Check for inst errors CheckInstrumentErrors strQuery Return result numbers return fResultsArray public byte DoQueryIEEEBlock string strQuery Send...

Page 1223: ...strumentError ToString StartsWith 0 private void OpenIo m_ResourceManager new ResourceManagerClass m_IoObject new FormattedIO488Class Open the default VISA COM IO object try m_IoObject IO IMessage m_R...

Page 1224: ...Select VISA COM 5 5 Type Library then click OK e Right click the project you wish to modify not the solution in the Solution Explorer window of the Microsoft Visual Studio environment and choose Prop...

Page 1225: ...itialize the oscilloscope to a known state Private Shared Sub Initialize Dim strResults As String Get and display the device s IDN string strResults myScope DoQueryString IDN Console WriteLine IDN res...

Page 1226: ...eam Close Console WriteLine Setup bytes saved 0 nLength Change settings with individual commands Set vertical scale and offset myScope DoCommand CHANnel1 SCALe 0 05 Console WriteLine Channel 1 vertica...

Page 1227: ...re SOURce CHANnel1 Console WriteLine Measure source 0 _ myScope DoQueryString MEASure SOURce myScope DoCommand MEASure FREQuency fResult myScope DoQueryNumber MEASure FREQuency Console WriteLine Frequ...

Page 1228: ...mbers WAVeform PREamble Dim fFormat As Double fResultsArray 0 If fFormat 0 Then Console WriteLine Waveform format BYTE ElseIf fFormat 1 Then Console WriteLine Waveform format WORD ElseIf fFormat 2 The...

Page 1229: ...trPath Then File Delete strPath End If Open file for output Dim writer As StreamWriter File CreateText strPath Output waveform data in CSV format For index As Integer 0 To nLength 1 Write time value v...

Page 1230: ...End Sub Public Function DoQueryString ByVal strQuery As String As String Send the query m_IoObject WriteString strQuery True Get the result string Dim strResults As String strResults m_IoObject ReadS...

Page 1231: ...esultsArray _ m_IoObject ReadIEEEBlock IEEEBinaryType BinaryType_UI1 _ False True Check for inst errors CheckInstrumentErrors strQuery Return results array Return ResultsArray End Function Private Sub...

Page 1232: ...urceManager Catch End Try End Sub End Class End Namespace VISA COM Example in Python You can use the Python programming language with the comtypes package to control Keysight oscilloscopes The Python...

Page 1233: ...tion VISA VisaCom GlobMgr dll import comtypes gen VisaComLib as VisaComLib Global variables booleans 0 False 1 True Initialize def initialize Get and display the device s IDN string idn_string do_quer...

Page 1234: ...l1 SCALe 0 05 qresult do_query_number CHANnel1 SCALe print Channel 1 vertical scale f qresult do_command CHANnel1 OFFSet 1 5 qresult do_query_number CHANnel1 OFFSet print Channel 1 offset f qresult Se...

Page 1235: ...pen c scope data screen png wb f write bytearray image_bytes f close print Screen image written to c scope data screen png Download waveform data Set the waveform points mode do_command WAVeform POINt...

Page 1236: ...m Y origin f y_origin print Waveform Y reference d y_reference Always 125 Get numeric values for later calculations x_increment do_query_number WAVeform XINCrement x_origin do_query_number WAVeform XO...

Page 1237: ...Scope ReadString check_instrument_errors query return result Send a query check for errors return string def do_query_ieee_block query myScope WriteString s query True result myScope ReadIEEEBlock Vis...

Page 1238: ...lse SYSTem ERRor should always return string print ERROR SYSTem ERRor returned nothing command s command print Exited because of error sys exit 1 Main program rm CreateObject VISA GlobalRM interface V...

Page 1239: ...older choose Add Add Existing Item select the example c file and click Add 6 Edit the program to use the VISA address of your oscilloscope 7 Choose Project Properties In the Property Pages dialog upda...

Page 1240: ...ry for number void do_query_numbers char query Query for numbers int do_query_ieeeblock char query Query for IEEE block void check_instrument_errors Check for inst errors void error_handler VISA error...

Page 1241: ...mmand CLS do_command RST Capture the waveform void capture void int num_bytes FILE fp Use auto scale to automatically configure oscilloscope do_command AUToscale Set trigger mode EDGE PULSe PATTern et...

Page 1242: ...et s n str_result Set horizontal scale and offset do_command TIMebase SCALe 0 0002 do_query_string TIMebase SCALe printf Timebase scale s n str_result do_command TIMebase POSition 0 0 do_query_string...

Page 1243: ...o_query_number MEASure FREQuency printf Frequency 4f kHz n num_result 1000 do_command MEASure VAMPlitude do_query_number MEASure VAMPlitude printf Vertical amplitude 2f V n num_result Download the scr...

Page 1244: ...s n str_result Display the waveform settings do_query_numbers WAVeform PREamble wav_format dbl_results 0 if wav_format 0 0 printf Waveform format BYTE n else if wav_format 1 0 printf Waveform format...

Page 1245: ...mber of data values d n num_bytes Open file for output fp fopen c scope data waveform_data csv wb Output waveform data in CSV format for i 0 i num_bytes 1 i Write time value voltage value fprintf fp 9...

Page 1246: ...nstrument_errors return data_length Query for a string result void do_query_string query char query char message 80 strcpy message query strcat message n err viPrintf vi message if err VI_SUCCESS erro...

Page 1247: ...eeblock query char query char message 80 int data_length strcpy message query strcat message n err viPrintf vi message if err VI_SUCCESS error_handler data_length IEEEBLOCK_SPACE err viScanf vi b n da...

Page 1248: ...rr_msg if err VI_SUCCESS exit 1 VISA Example in Visual Basic To run this example in Visual Basic for Applications 1 Start the application that provides Visual Basic for Applications for example Micros...

Page 1249: ...As Long Public Const DblArraySize 20 Public dblArray DblArraySize As Double Declare fixed length string variable to hold string value returned by viVScanf viVQueryf Public strQueryResult As String 200...

Page 1250: ...the default setup DoCommand CLS DoCommand RST End Sub Capture the waveform Private Sub Capture Use auto scale to automatically configure oscilloscope DoCommand AUToscale Set trigger mode EDGE PULSe PA...

Page 1251: ...nd CHANnel1 SCALe 0 05 Debug Print Channel 1 vertical scale _ DoQueryString CHANnel1 SCALe DoCommand CHANnel1 OFFSet 1 5 Debug Print Channel 1 vertical offset _ DoQueryString CHANnel1 OFFSet Set horiz...

Page 1252: ...umber dblQueryResult 1000 4 kHz DoCommand MEASure VAMPlitude dblQueryResult DoQueryNumber MEASure VAMPlitude MsgBox Vertical amplitude vbCrLf _ FormatNumber dblQueryResult 4 V Download the screen imag...

Page 1253: ...oQueryString WAVeform FORMat Display the waveform settings Dim intFormat As Integer Dim intType As Integer Dim lngPoints As Long Dim lngCount As Long Dim dblXIncrement As Double Dim dblXOrigin As Doub...

Page 1254: ...gin Scientific Debug Print Waveform X reference _ FormatNumber lngXReference 0 Debug Print Waveform Y increment _ Format sngYIncrement Scientific Debug Print Waveform Y origin _ FormatNumber lngYOrigi...

Page 1255: ...EEEBlock command As String _ lngBlockSize As Long retCount lngBlockSize Dim strCommandAndLength As String strCommandAndLength command _ Format lngBlockSize b err viVPrintf vi strCommandAndLength vbLf...

Page 1256: ...ount paramsArray 1 VarPtr dblArray 0 Set retCount to max number of elements array can hold retCount DblArraySize Read numbers err viVScanf vi lf vbLf paramsArray 0 If err VI_SUCCESS Then HandleVISAErr...

Page 1257: ...uery any errors If err VI_SUCCESS Then HandleVISAError vi err viVScanf vi t strErrVal Read Errnum Error String If err VI_SUCCESS Then HandleVISAError vi While Val strErrVal 0 End if find 0 No Error st...

Page 1258: ...ct you wish to modify not the solution in the Solution Explorer window of the Microsoft Visual Studio environment b Click Add and then click Add Existing Item c Navigate to the header file visa32 cs i...

Page 1259: ...ed waveform Analyze catch System ApplicationException err Console WriteLine VISA Error Message err Message catch System SystemException err Console WriteLine System Error Message err Message catch Sys...

Page 1260: ...Gger EDGE LEVel myScope DoCommand TRIGger EDGE SLOPe POSitive Console WriteLine Trigger edge slope 0 myScope DoQueryString TRIGger EDGE SLOPe Save oscilloscope configuration byte ResultsArray Results...

Page 1261: ...g setup stp DataArray File ReadAllBytes strPath Restore setup string nBytesWritten myScope DoCommandIEEEBlock SYSTem SETup DataArray Console WriteLine Setup bytes restored 0 nBytesWritten Capture an a...

Page 1262: ...pe DoQueryString WAVeform POINts MODE Get the number of waveform points available myScope DoCommand WAVeform POINts 10240 Console WriteLine Waveform points available 0 myScope DoQueryString WAVeform P...

Page 1263: ...ouble fXorigin fResultsArray 5 Console WriteLine Waveform X origin 0 e fXorigin double fXreference fResultsArray 6 Console WriteLine Waveform X reference 0 e fXreference double fYincrement fResultsArr...

Page 1264: ..._strVisaAddress strVisaAddress Open the default VISA resource manager OpenResourceManager Open a VISA resource session OpenSession Clear the interface int nViStatus nViStatus visa32 viClear m_nSession...

Page 1265: ...esult string StringBuilder strResults new StringBuilder 1000 strResults VisaGetResultString Check for inst errors CheckInstrumentErrors strQuery Return string results return strResults public double D...

Page 1266: ...strCommandOrQuery Send command or query to the device string strWithNewline strWithNewline String Format 0 n strCommandOrQuery int nViStatus nViStatus visa32 viPrintf m_nSession strWithNewline CheckVi...

Page 1267: ...300000 Read return value string from the device int nViStatus nViStatus visa32 viScanf m_nSession b ref length ResultsArray CheckVisaStatus nViStatus Write and read buffers need to be flushed after I...

Page 1268: ...this m_strVisaAddress visa32 VI_NO_LOCK visa32 VI_TMO_IMMEDIATE out this m_nSession CheckVisaStatus nViStatus public void SetTimeoutSeconds int nSeconds int nViStatus nViStatus visa32 viSetAttribute t...

Page 1269: ...irectory select it but do not click the Open button d Click the down arrow to the right of the Add button and choose Add as Link You should now see the file underneath your project in the Solution Exp...

Page 1270: ...rResults As StringBuilder Get and display the device s IDN string strResults myScope DoQueryString IDN Console WriteLine IDN result is 0 strResults Clear status and load the default setup myScope DoCo...

Page 1271: ...gs with individual commands Set vertical scale and offset myScope DoCommand CHANnel1 SCALe 0 05 Console WriteLine Channel 1 vertical scale 0 _ myScope DoQueryString CHANnel1 SCALe myScope DoCommand CH...

Page 1272: ..._ myScope DoQueryString MEASure SOURce myScope DoCommand MEASure FREQuency fResult myScope DoQueryNumber MEASure FREQuency Console WriteLine Frequency 0 F4 kHz fResult 1000 myScope DoCommand MEASure...

Page 1273: ...REamble Dim fFormat As Double fResultsArray 0 If fFormat 0 Then Console WriteLine Waveform format BYTE ElseIf fFormat 1 Then Console WriteLine Waveform format WORD ElseIf fFormat 2 Then Console WriteL...

Page 1274: ...le Delete strPath End If Open file for output Dim writer As StreamWriter File CreateText strPath Output waveform data in CSV format For index As Integer 0 To nLength 1 Write time value voltage value w...

Page 1275: ...ngth DataArray Length strCommandAndLength String Format 0 8 1 D8 _ strCommand nLength Write first part of command to formatted I O write buffer nViStatus visa32 viPrintf m_nSession strCommandAndLength...

Page 1276: ...instrument errors another command and result CheckInstrumentErrors strQuery Return string results Return fResultsArray End Function Public Function DoQueryIEEEBlock ByVal strQuery As String _ ByRef R...

Page 1277: ...tion Private Function VisaGetResultNumbers As Double Dim fResultsArray As Double fResultsArray New Double 9 Read return value string from the device Dim nViStatus As Integer nViStatus visa32 viScanf m...

Page 1278: ...StartsWith 0 End Sub Private Sub OpenResourceManager Dim nViStatus As Integer nViStatus visa32 viOpenDefaultRM Me m_nResourceManager If nViStatus visa32 VI_SUCCESS Then Throw New _ ApplicationExceptio...

Page 1279: ...web at http www python org and http pyvisa sourceforge net respectively To run this example with Python and PyVISA 1 Cut and paste the code that follows into a file named example py 2 Edit the progra...

Page 1280: ...qresult do_command TRIGger EDGE LEVel 1 5 qresult do_query_string TRIGger EDGE LEVel print Trigger edge level s qresult do_command TRIGger EDGE SLOPe POSitive qresult do_query_string TRIGger EDGE SLO...

Page 1281: ...p bytes restored d len sSetup Capture an acquisition using DIGitize do_command DIGitize CHANnel1 Analyze def analyze Make measurements do_command MEASure SOURce CHANnel1 qresult do_query_string MEASur...

Page 1282: ...le wav_form_dict 0 BYTE 1 WORD 4 ASCii acq_type_dict 0 NORMal 1 PEAK 2 AVERage 3 HRESolution preamble_string do_query_string WAVeform PREamble wav_form acq_type wfmpts avgcnt x_increment x_origin x_re...

Page 1283: ...voltage values i y_reference y_increment y_origin f write E f n time_val voltage f close print Waveform format BYTE data written to waveform_data csv Send a command and check for errors def do_command...

Page 1284: ...command s error_string command print Exited because of error sys exit 1 else No error break else SYSTem ERRor should always return string print ERROR SYSTem ERRor returned nothing command s comma nd...

Page 1285: ...e and PyVISA package can be downloaded from the web at http www python org and http pyvisa readthedocs org respectively To run this example with Python and PyVISA 1 Cut and paste the code that follows...

Page 1286: ...ger EDGE SOURce print Trigger edge source s qresult do_command TRIGger EDGE LEVel 1 5 qresult do_query_string TRIGger EDGE LEVel print Trigger edge level s qresult do_command TRIGger EDGE SLOPe POSiti...

Page 1287: ...bytes restored d len sSetup Capture an acquisition using DIGitize do_command DIGitize CHANnel1 Analyze def analyze Make measurements do_command MEASure SOURce CHANnel1 qresult do_query_string MEASure...

Page 1288: ...ASCii acq_type_dict 0 NORMal 1 PEAK 2 AVERage 3 HRESolution preamble_string do_query_string WAVeform PREamble wav_form acq_type wfmpts avgcnt x_increment x_origin x_reference y_increment y_origin y_r...

Page 1289: ...int Waveform format BYTE data written to waveform_data csv Send a command and check for errors def do_command command hide_params False if hide_params header data string split command 1 if debug print...

Page 1290: ...int Qys s query result InfiniiVision query_binary_values s query datatype s check_instrument_errors query return result 0 Check for instrument errors def check_instrument_errors command while True err...

Page 1291: ...copes SCPI Programmer s Guide 1291 InfiniiVision rm open_resource TCPIP0 10 112 94 136 hislip9 0 0 INS TR InfiniiVision timeout 15000 InfiniiVision clear Initialize the oscilloscope capture data and a...

Page 1292: ...In the Property Pages dialog update these project settings a Under Configuration Properties Linker Input add sicl32 lib to the Additional Dependencies field b Under Configuration Properties C C Code...

Page 1293: ...har query Query for numbers int do_query_ieeeblock char query Query for IEEE block void check_instrument_errors Check for inst errors Global variables INST id Device session ID char str_result 256 0 R...

Page 1294: ...TIMEOUT Clear the interface iclear id Get and display the device s IDN string do_query_string IDN printf Oscilloscope IDN string s n str_result Clear status and load the default setup do_command CLS...

Page 1295: ...and offset do_command CHANnel1 SCALe 0 05 do_query_string CHANnel1 SCALe printf Channel 1 vertical scale s n str_result do_command CHANnel1 OFFSet 1 5 do_query_string CHANnel1 OFFSet printf Channel 1...

Page 1296: ...ence FILE fp int num_bytes Number of bytes returned from instrument int i Make a couple of measurements do_command MEASure SOURce CHANnel1 do_query_string MEASure SOURce printf Measure source s n str_...

Page 1297: ...orm source do_command WAVeform SOURce CHANnel1 do_query_string WAVeform SOURce printf Waveform source s n str_result Choose the format of the data returned WORD BYTE ASCII do_command WAVeform FORMat B...

Page 1298: ...e n y_increment y_origin dbl_results 8 printf Waveform Y origin e n y_origin y_reference dbl_results 9 printf Waveform Y reference e n y_reference Read waveform data num_bytes do_query_ieeeblock WAVe...

Page 1299: ...age command strcat message 8 08d iprintf id message num_bytes ifwrite id ieeeblock_data num_bytes 1 data_length check_instrument_errors return data_length Query for a string result void do_query_strin...

Page 1300: ...y char message 80 int data_length strcpy message query strcat message n iprintf id message data_length IEEEBLOCK_SPACE iscanf id b data_length ieeeblock_data if data_length IEEEBLOCK_SPACE printf IEEE...

Page 1301: ...les Agilent IO Libraries Suite include directory select it and click Open 4 Choose Insert Module 5 Cut and paste the code that follows into the editor 6 Edit the program to use the SICL address of you...

Page 1302: ...alize Capture data Capture Analyze the captured waveform Analyze Close the vi session and the resource manager session Call iclose id Exit Sub ErrorHandler MsgBox Error Error vbExclamation End End Sub...

Page 1303: ...SOURce DoCommand TRIGger EDGE LEVel 1 5 Debug Print Trigger edge level _ DoQueryString TRIGger EDGE LEVel DoCommand TRIGger EDGE SLOPe POSitive Debug Print Trigger edge slope _ DoQueryString TRIGger E...

Page 1304: ...e POSition Set the acquisition type NORMal PEAK AVERage or HRESolution DoCommand ACQuire TYPE NORMal Debug Print Acquire type _ DoQueryString ACQuire TYPE Or configure by loading a previously saved se...

Page 1305: ...ver OFF Get screen image Dim lngBlockSize As Long lngBlockSize DoQueryIEEEBlock_Bytes DISPlay DATA PNG COLor Debug Print Screen image bytes CStr lngBlockSize Save screen image to a file Dim strPath As...

Page 1306: ...s Double Dim dblXOrigin As Double Dim lngXReference As Long Dim sngYIncrement As Single Dim sngYOrigin As Single Dim lngYReference As Long Preamble DoQueryNumbers WAVeform PREamble intFormat Preamble...

Page 1307: ...lngYReference 0 Get the waveform data Dim lngNumBytes As Long lngNumBytes DoQueryIEEEBlock_Bytes WAVeform DATA Debug Print Number of data values _ CStr lngNumBytes CInt Chr byteArray 1 2 Set up output...

Page 1308: ...on End End Sub Private Function DoCommandIEEEBlock command As String _ lngBlockSize As Long On Error GoTo ErrorHandler Send command part Call ivprintf id command Write definite length block bytes Call...

Page 1309: ...ring As Double On Error GoTo ErrorHandler Dim dblResult As Double Call ivprintf id query vbLf Call ivscanf id lf vbLf dblResult DoQueryNumber dblResult CheckInstrumentErrors Exit Function ErrorHandler...

Page 1310: ...h Dim i As Integer For i 2 To intLengthDigits 1 strBlockLength strBlockLength Chr byteArray i Next Return number of bytes in block plus header DoQueryIEEEBlock_Bytes CLng strBlockLength intLengthDigit...

Page 1311: ...ysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide 1311 MsgBox strOut vbExclamation INST Error Messages Call iflush id I_BUF_READ Or I_BUF_WRITE End If Exit Sub ErrorHandler MsgBox Error Error...

Page 1312: ...Microsoft Excel Keysight VEE and Keysight SystemVue For more information on Keysight Command Expert and to download the software see http www keysight com find commandexpert SCPI NET Example in C on p...

Page 1313: ...used programming features of your Keysight oscilloscope using System using System IO using System Text using Keysight CommandExpert ScpiNet AgInfiniiVision3000X_02_00 namespace InfiniiVision class Scp...

Page 1314: ...myScope SCPI IDN Query out strResults Console WriteLine IDN result is 0 strResults Clear status and load the default setup myScope SCPI CLS Command myScope SCPI RST Command Capture the waveform priva...

Page 1315: ...s with individual commands Set vertical scale and offset myScope SCPI CHANnel SCALe Command 1 0 05 myScope SCPI CHANnel SCALe Query 1 out fResult Console WriteLine Channel 1 vertical scale 0 F4 fResul...

Page 1316: ...requency 0 F4 kHz fResult 1000 Use direct command query when commands not in command set myScope Transport Command Invoke MEASure VAMPlitude CHANnel1 myScope Transport Query Invoke MEASure VAMPlitude...

Page 1317: ...he format of the data returned WORD BYTE ASCII myScope SCPI WAVeform FORMat Command BYTE myScope SCPI WAVeform FORMat Query out strResults Console WriteLine Waveform format 0 strResults Display the wa...

Page 1318: ...ength Console WriteLine Number of data values 0 nLength Set up output file strPath c scope data waveform_data csv if File Exists strPath File Delete strPath Open file for output StreamWriter writer Fi...

Page 1319: ...t Visual Studio environment and choose Properties then select InfiniiVision ScpiNetInstrumentApp as the Startup object 7 Build and run the program For more information see the SCPI NET driver help tha...

Page 1320: ...String Get and display the device s IDN string myScope SCPI IDN Query strResults Console WriteLine IDN result is 0 strResults Clear status and load the default setup myScope SCPI CLS Command myScope S...

Page 1321: ...al commands Set vertical scale and offset myScope SCPI CHANnel SCALe Command 1 0 05 myScope SCPI CHANnel SCALe Query 1 fResult Console WriteLine Channel 1 vertical scale 0 F4 fResult myScope SCPI CHAN...

Page 1322: ...iteLine Frequency 0 F4 kHz fResult 1000 Use direct command query when commands not in command set myScope Transport Command Invoke MEASure VAMPlitude CHANnel1 myScope Transport Query Invoke MEASure VA...

Page 1323: ...As Integer Dim dblXincrement As Double dblXorigin As Double _ dblYincrement As Double dblYorigin As Double myScope SCPI WAVeform PREamble Query nFormat nType nPoints _ nCount dblXincrement dblXorigin...

Page 1324: ...strPath End Sub End Class End Namespace SCPI NET Example in IronPython You can also control Keysight oscilloscopes using the SCPI NET library and Python programming language on the NET platform using...

Page 1325: ...splay the device s IDN string idn_string scope SCPI IDN Query print Identification string s idn_string Clear status and load the default setup scope SCPI CLS Command scope SCPI RST Command Capture def...

Page 1326: ...e and offset scope SCPI TIMebase SCALe Command 0 0002 qresult scope SCPI TIMebase SCALe Query print Timebase scale f qresult scope SCPI TIMebase POSition Command 0 0 qresult scope SCPI TIMebase POSiti...

Page 1327: ...oad waveform data Set the waveform points mode scope SCPI WAVeform POINts MODE Command RAW qresult scope SCPI WAVeform POINts MODE Query print Waveform points mode s qresult Get the number of waveform...

Page 1328: ...rm YINCrement Query y_origin scope SCPI WAVeform YORigin Query y_reference scope SCPI WAVeform YREFerence Query Get the waveform data data_bytes scope SCPI WAVeform DATA QueryBYTE nLength len data_byt...

Page 1329: ...head type 268 analog probe sensing 1099 analog probe skew 271 1097 analysis results save 558 analyzing captured data 47 angle brackets 153 annotate channels 265 annotation background display 299 annot...

Page 1330: ...de 828 CAN serial search mode 823 CAN signal definition 611 CAN source 613 CAN symbolic data display 606 CAN symbolic data recall 536 CAN trigger 614 620 CAN trigger data pattern 618 CAN trigger ID pa...

Page 1331: ...o signal 293 coupling for channels 261 CRC format SENT 721 create automask 505 CSV Comma Separated Values waveform data format 566 CT bits CXPI triggering on 641 current oscilloscope configuration 167...

Page 1332: ...ring 902 edges in measurement 441 elapsed time in mask test 512 ellipsis 153 enable channel labels 310 enabling calibration 251 enabling channel display 262 enabling status register bits 162 176 end o...

Page 1333: ...modulation 1062 full scale horizontal time 891 898 full scale vertical axis defined 378 function 353 355 364 367 373 374 378 379 380 1106 1107 FUNCtion commands 345 function memory 218 function turne...

Page 1334: ...97 introduction to MEASure commands 432 introduction to RECall commands 534 introduction to SAVE commands 546 introduction to SBUS commands 573 introduction to SYSTem commands 863 introduction to TIMe...

Page 1335: ...k Test Event Enable Register MTEenable 199 mask test event event register 201 Mask Test Event Event Register MTERegister EVENt 201 1164 mask test run mode 518 mask test termination conditions 518 mask...

Page 1336: ...as g t source 1103 N N8900A Infiniium Offline oscilloscope analysis software 556 name channels 265 name list 311 natural logarithm math function 375 negative glitch trigger polarity 939 negative pulse...

Page 1337: ...measured to calculate phase 461 period measurement 47 432 460 period waveform generator 1074 persistence waveform 297 314 phase data including in FRA results 341 phase measured between channels 461 ph...

Page 1338: ...ers clearing 1165 reject filter 932 reject high frequency 906 reject noise 915 relative standard deviation 479 remote command logging enable disable 876 880 remote control examples 1205 Remote Termina...

Page 1339: ...et up USB interface 39 setting display 353 setting external trigger level 323 setting impedance for channels 263 setting inversion for channels 264 settings 171 175 settings conflict errors 206 209 11...

Page 1340: ...ata 1200 syntax optional terms 152 syntax program message 1197 SYSTem commands 861 system commands 866 867 869 883 system commands introduction 863 system date 864 system time 885 T tdelta 1110 Tektro...

Page 1341: ...C pattern data 649 trigger IIC pattern data 2 650 trigger IIC qualifier 651 trigger IIC signal baudrate 659 trigger IIC type 652 trigger LIN 663 trigger LIN pattern data 666 trigger LIN pattern data l...

Page 1342: ...marker used to measure waveform 1119 1120 voltage offset value for channels 266 voltage probe 276 327 voltage profile frequency response analysis 344 voltage ranges for channels 274 voltage ranges for...

Page 1343: ...rence 1031 X Y mode 888 889 Y Y axis markers 397 Y cursor units 414 415 Y offset reference waveform 1088 Y range reference waveform 1089 Y scale reference waveform 1090 Y1 and Y2 cursor value differen...

Page 1344: ...1344 Keysight P9241 42 43A Oscilloscopes SCPI Programmer s Guide Index...

Search results

Summary of Contents for P9241

Reviews:

Brands by name

Popular brands

Keysight P9241, Scpi Programmer'S Manual

Search results

Summary of Contents for P9241

Reviews:

Brands by name

Popular brands